Skip to content

Chronicle naming: align prose surfaces (fixes #83) #94

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MaxGhenis merged 2 commits into from
Aug 25, 2026
Merged

Chronicle naming: align prose surfaces (fixes #83) #94

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
95b8108
Chronicle naming: align prose surfaces, freeze legacy ledger paths/id…
MaxGhenis Aug 25, 2026
e2daa3b
Address sol review r1: five residual prose sites + fact-drift pin
MaxGhenis Aug 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions app/public/data/lanes.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
{
"id": "ledger-catalog-urban",
"country": "US",
"source": "Ledger",
"source": "Chronicle",
"area": "validation_comparator fact packages (#6)",
"mode": 0,
"stage": "registered",
Expand Down Expand Up @@ -158,7 +158,7 @@
"stage": "ingested",
"running": false,
"updated": "2026-08-19",
"note": "1092 claims, 546 ledger facts"
"note": "1092 claims, 546 Chronicle facts"
},
{
"id": "hbai-poverty",
Expand All @@ -180,7 +180,7 @@
"stage": "ingested",
"running": false,
"updated": "2026-08-19",
"note": "723 claims, 490 ledger facts"
"note": "723 claims, 490 Chronicle facts"
},
{
"id": "obr-welfare",
Expand All @@ -191,7 +191,7 @@
"stage": "ingested",
"running": false,
"updated": "2026-08-19",
"note": "222 claims, 37 ledger facts"
"note": "222 claims, 37 Chronicle facts"
},
{
"id": "ukmod-stats",
Expand Down Expand Up @@ -356,7 +356,7 @@
"stage": "computed",
"running": false,
"updated": "2026-08-21",
"note": "5 model claims, 7 Ledger facts (6 statistical + 1 non-simulated uprated EU-SILC survey input), 6 derived ratios dispositioned; 2 concept-mismatch attachments"
"note": "5 model claims, 7 Chronicle facts (6 statistical + 1 non-simulated uprated EU-SILC survey input), 6 derived ratios dispositioned; 2 concept-mismatch attachments"
}
]
}
2 changes: 1 addition & 1 deletion app/src/App.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -301,7 +301,7 @@ function CountryEmptyState({
);
const emptyCopy =
country === "BE"
? "The JRC EUROMOD-BE lane has five model claims. Its six statistical rows and one non-simulated uprated EU-SILC survey input route to Ledger, and its six ratios remain derived, not claims. Two demo-grade Axiom worker values appear on Reform validation as concept mismatches; no value is presented as comparable."
? "The JRC EUROMOD-BE lane has five model claims. Its six statistical rows and one non-simulated uprated EU-SILC survey input route to Chronicle, and its six ratios remain derived, not claims. Two demo-grade Axiom worker values appear on Reform validation as concept mismatches; no value is presented as comparable."
: `No ${COUNTRY_LABELS[country]} rows in this view yet — the ${country} external lanes are mid-pipeline. Each lane below reports its stage from data/lanes.json; as counterparts compute, rows appear here under the same descriptive status taxonomy as the US instance, model gaps and concept mismatches included.`;
return (
<div className="max-w-3xl">
Expand Down
4 changes: 2 additions & 2 deletions be/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ Provenance is pinned to the Chronicle repository's local `origin/main` commit `1
The source contains 18 data records (19 physical lines including the header), despite the lane brief saying 19 rows and eight EUROMOD claims:

- 5 `euromod` model-output rows become Scorecard claims (EUROMOD version **J1.0+** per the report front matter, p. 3; 2025 is only the report vintage);
- 1 `euromod`-labelled row — unemployment benefits — is a **non-simulated uprated EU-SILC survey input** (Table A3.6 marks `bun` Simulated=N, p. 127; `bun_be` is switched off in the baseline, p. 24; the 11,706 for 2023 is the SILC income-year-2021 base of 10,416 uprated) and routes to Ledger staging with that provenance pinned, never to a claim;
- 6 `external` statistical rows become deterministic Ledger staging facts in `data/ledger/be_admin_outturns.jsonl`, each carrying its underlying issuer (NBB for income tax, employee SICs, and child benefits; RVA for unemployment; EU-SILC for the Gini and AROP comparators) with JRC as the secondary publisher;
- 1 `euromod`-labelled row — unemployment benefits — is a **non-simulated uprated EU-SILC survey input** (Table A3.6 marks `bun` Simulated=N, p. 127; `bun_be` is switched off in the baseline, p. 24; the 11,706 for 2023 is the SILC income-year-2021 base of 10,416 uprated) and routes to Chronicle staging with that provenance pinned, never to a claim;
- 6 `external` statistical rows become deterministic Chronicle staging facts in `data/ledger/be_admin_outturns.jsonl`, each carrying its underlying issuer (NBB for income tax, employee SICs, and child benefits; RVA for unemployment; EU-SILC for the Gini and AROP comparators) with JRC as the secondary publisher;
- 6 `ratio` rows are rounded `euromod / external` derivations and are not persisted as claims or facts.

Periods on model claims are EUROMOD policy-system/output years (2023 for A3.4/A3.6, 2022 for A3.7/A3.8) simulated from database `BE_2022_c1` — EU-SILC 2022 collection, income reference year **2021**, coverage **private households** (Table 3.1, p. 97) — with monetary values uprated into each simulation year. They are not matched income-reference years and not SILC collection years. Model claims carry `population_frame=private_households` and `input_database=be_2022_c1_silc2022_income2021` pins so the modeled universe is never presented as an unqualified national frame.
Expand Down
12 changes: 6 additions & 6 deletions be/ingest_jrc_country_report.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,9 @@
``euromod``-labelled value (unemployment benefits) is a NON-SIMULATED
uprated EU-SILC survey input (Table A3.6 marks ``bun`` Simulated=N, p. 127;
``bun_be`` is switched off in the baseline, p. 24; the 11,706 for 2023 is
the SILC income-year-2021 base of 10,416 uprated) and routes to Ledger
the SILC income-year-2021 base of 10,416 uprated) and routes to Chronicle
staging with that provenance pinned, never to a model claim; six
``external`` statistical/outturn values route to deterministic Ledger
``external`` statistical/outturn values route to deterministic Chronicle
staging facts; and six rounded ``ratio`` values are recomputable and never
persisted. Periods are calendar policy-system/output years simulated from EUROMOD
database BE_2022_c1 (EU-SILC 2022 collection, income reference year 2021,
Expand Down Expand Up @@ -223,7 +223,7 @@
# p. 24 states bun_be is switched off in the baseline; its "EUROMOD"
# column is the SILC income-year-2021 base (10,416) uprated per year
# (11,706 for 2023). A survey input is not a model output: it routes to
# Ledger staging, never to a claim.
# Chronicle staging, never to a claim.
_NON_SIMULATED_EUROMOD_METRICS = {"unemployment_benefits"}

_METRICS = {
Expand Down Expand Up @@ -556,12 +556,12 @@ def _ledger_row(row: dict) -> dict:
"status": "ok",
"consumed_by": None,
"routing": (
"ledger: non-simulated uprated EU-SILC survey input published "
"chronicle: non-simulated uprated EU-SILC survey input published "
"in the report's EUROMOD column (Table A3.6 Simulated=N, "
"p. 127; bun_be switched off in the baseline, p. 24; SILC "
"income-year-2021 base 10,416 uprated to the simulation year)"
if non_simulated
else "ledger: statistical/admin outturn (boundary rule 2026-08-02)"
else "chronicle: statistical/admin outturn (boundary rule 2026-08-02)"
),
}

Expand Down Expand Up @@ -779,7 +779,7 @@ def ingest(db_path: Path) -> dict:
(
LANE_ID,
"computed",
"5 model claims, 7 Ledger facts (6 statistical + 1 "
"5 model claims, 7 Chronicle facts (6 statistical + 1 "
"non-simulated uprated EU-SILC survey input), 6 derived "
"ratios dispositioned; 2 concept-mismatch attachments",
UPDATED,
Expand Down
10 changes: 5 additions & 5 deletions data/lanes.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
{
"id": "ledger-catalog-urban",
"country": "US",
"source": "Ledger",
"source": "Chronicle",
"area": "validation_comparator fact packages (#6)",
"mode": 0,
"stage": "registered",
Expand Down Expand Up @@ -158,7 +158,7 @@
"stage": "ingested",
"running": false,
"updated": "2026-08-19",
"note": "1092 claims, 546 ledger facts"
"note": "1092 claims, 546 Chronicle facts"
},
{
"id": "hbai-poverty",
Expand All @@ -180,7 +180,7 @@
"stage": "ingested",
"running": false,
"updated": "2026-08-19",
"note": "723 claims, 490 ledger facts"
"note": "723 claims, 490 Chronicle facts"
},
{
"id": "obr-welfare",
Expand All @@ -191,7 +191,7 @@
"stage": "ingested",
"running": false,
"updated": "2026-08-19",
"note": "222 claims, 37 ledger facts"
"note": "222 claims, 37 Chronicle facts"
},
{
"id": "ukmod-stats",
Expand Down Expand Up @@ -356,7 +356,7 @@
"stage": "computed",
"running": false,
"updated": "2026-08-21",
"note": "5 model claims, 7 Ledger facts (6 statistical + 1 non-simulated uprated EU-SILC survey input), 6 derived ratios dispositioned; 2 concept-mismatch attachments"
"note": "5 model claims, 7 Chronicle facts (6 statistical + 1 non-simulated uprated EU-SILC survey input), 6 derived ratios dispositioned; 2 concept-mismatch attachments"
}
]
}
Loading
Loading