Final cleanup: QT artifact consistency, README accuracy, strict JSON loader

- Publish qt_proxy as 0 (not null) with qt_proxy_is_zero_filled flag
- Update duration notes to document zero-fill behavior
- Fix README quickstart (remove untracked source .env)
- Narrow README artifact-driven claim to match reality
- Replace silent NaN repair in fetchJSON with console.error + fallback

Author: smkwray

README.md

@@ -45,18 +45,19 @@ The public site at `site/index.html` is a static frontend (HTML + CSS + vanilla
 - **`site/figures/`** — SVG figures mirrored from `output/figures/`
 - **`site/data/index.json`** — the artifact manifest used for conditional rendering
 
-The frontend never accesses raw or interim backend data. All numeric values, status text, coverage windows, and claim boundaries displayed on the site are loaded from backend-generated artifacts at runtime. `make site` mirrors the current `output/publish/` artifacts into the site bundle.
+The frontend never accesses raw or interim backend data. Numeric values, status counts, coverage windows, claim boundaries, and evidence-hierarchy roles are loaded from backend-generated artifacts at runtime. Some display labels, section prose, and model display ordering remain in frontend code. `make site` mirrors the current `output/publish/` artifacts into the site bundle.
 
 ## Quickstart
 
 ```bash
 python3 -m venv ~/venvs/qrawatch
-source .env
 "$HOME/venvs/qrawatch/bin/python" -m ensurepip --upgrade
 "$HOME/venvs/qrawatch/bin/python" -m pip install -r requirements.txt
 "$HOME/venvs/qrawatch/bin/python" -m pip install -e .
 ```
 
+If you have a local `.env` file with environment overrides (e.g. `VIRTUAL_ENV`), source it before running `make` commands.
+
 With network access:
 
 ```bash

scripts/12_build_public_duration_supply.py

@@ -30,7 +30,10 @@
 
 def add_duration_supply_variants(panel: pd.DataFrame) -> pd.DataFrame:
     out = panel.copy()
+    qt_missing = out["qt_proxy"].isna()
     qt = out["qt_proxy"].fillna(0)
+    out["qt_proxy"] = qt  # publish the zero-filled value, not the raw NaN
+    out["qt_proxy_is_zero_filled"] = qt_missing
     buybacks = out["buybacks_accepted"].fillna(0)
     if "nonbill_net_exact" not in out.columns:
         out["nonbill_net_exact"] = out["coupon_like_total"]
@@ -49,6 +52,7 @@ def add_duration_supply_variants(panel: pd.DataFrame) -> pd.DataFrame:
     out["sign_convention"] = SIGN_CONVENTION
     out["notes"] = (
         "Headline measure = exact combined non-bill net issuance + QT proxy - buybacks accepted. "
+        "QT proxy is zero-filled when the FRED TREAST series is unavailable (see qt_proxy_is_zero_filled). "
         "Gross coupon-flow constructions remain explicit fallback columns."
     )
     return out

site/app.js

@@ -10,13 +10,16 @@
       var resp = await fetch(DATA_PATH + '/' + filename);
       if (!resp.ok) return null;
       var text = await resp.text();
-      var clean = text
-        .replace(/\bNaN\b/g, 'null')
-        .replace(/\b-Infinity\b/g, 'null')
-        .replace(/\bInfinity\b/g, 'null');
-      return JSON.parse(clean);
+      if (/\bNaN\b|\bInfinity\b/.test(text)) {
+        console.error('Artifact ' + filename + ' contains NaN or Infinity — backend should emit valid JSON. Attempting parse with repair.');
+        text = text
+          .replace(/\bNaN\b/g, 'null')
+          .replace(/\b-Infinity\b/g, 'null')
+          .replace(/\bInfinity\b/g, 'null');
+      }
+      return JSON.parse(text);
     } catch (e) {
-      console.warn('Failed to load ' + filename + ':', e);
+      console.error('Failed to parse ' + filename + ':', e);
       return null;
     }
   }
@@ -1418,7 +1421,7 @@
       var durHeaderText = el('div', { class: 'chart-header-text' });
       var durWeekCount = recent.length;
       durHeaderText.appendChild(el('div', { class: 'chart-title', text: 'Public Duration Supply (Recent ' + durWeekCount + ' Weeks)' }));
-      var qtMissing = recent.some(function (r) { return r.qt_proxy == null || (typeof r.qt_proxy === 'number' && isNaN(r.qt_proxy)); });
+      var qtMissing = recent.some(function (r) { return r.qt_proxy_is_zero_filled === true; });
       var durCaptionText = 'Weekly USD. Higher = more duration supply to private hands. Headline = exact non-bill net + QT proxy \u2212 buybacks.';
       if (qtMissing) durCaptionText += ' Note: QT proxy is unavailable for some weeks and zero-filled in the headline construction.';
       var durCaptionEl = el('div', { class: 'chart-caption', text: durCaptionText });

site/data/causal_claims_status.csv

@@ -1,2 +1,2 @@
 claim_id,claim_name,claim_scope,readiness_tier,public_role,headline_ready,causal_pilot_ready,source_quality,current_sample_financing_component_count,benchmark_ready_count,tier_a_count,context_only_count,post_release_invalid_count,source_family_exhausted_count,open_candidate_count,can_claim,cannot_claim,boundary_reason,last_regenerated_utc
-current_sample_financing_pilot,Current-sample financing pilot,causal_pilot_only,supporting_ready,supporting,False,True,derived_causal_claims_status,14,6,5,1,8,8,0,"A narrow post-2022Q3 financing-estimates pilot with 14 reviewed current-sample financing components, 6 benchmark-ready rows, and 5 Tier A components.","A settled or full-sample causal estimate of Treasury issuance effects on long rates; 8 financing rows remain post-release-invalid, 8 are source-family-exhausted, 0 remain open benchmark candidates, and the long-rate translation layer is still supporting/provisional.",14 current-sample financing rows; 6 benchmark-ready; 5 Tier A; 1 context-only; 8 post-release-invalid; 8 source-family-exhausted; 0 open candidates.,2026-03-25T17:43:58.519222+00:00
+current_sample_financing_pilot,Current-sample financing pilot,causal_pilot_only,supporting_ready,supporting,False,True,derived_causal_claims_status,14,6,5,1,8,8,0,"A narrow post-2022Q3 financing-estimates pilot with 14 reviewed current-sample financing components, 6 benchmark-ready rows, and 5 Tier A components.","A settled or full-sample causal estimate of Treasury issuance effects on long rates; 8 financing rows remain post-release-invalid, 8 are source-family-exhausted, 0 remain open benchmark candidates, and the long-rate translation layer is still supporting/provisional.",14 current-sample financing rows; 6 benchmark-ready; 5 Tier A; 1 context-only; 8 post-release-invalid; 8 source-family-exhausted; 0 open candidates.,2026-03-25T18:33:58.854568+00:00

site/data/causal_claims_status.json

@@ -20,7 +20,7 @@
       "can_claim": "A narrow post-2022Q3 financing-estimates pilot with 14 reviewed current-sample financing components, 6 benchmark-ready rows, and 5 Tier A components.",
       "cannot_claim": "A settled or full-sample causal estimate of Treasury issuance effects on long rates; 8 financing rows remain post-release-invalid, 8 are source-family-exhausted, 0 remain open benchmark candidates, and the long-rate translation layer is still supporting/provisional.",
       "boundary_reason": "14 current-sample financing rows; 6 benchmark-ready; 5 Tier A; 1 context-only; 8 post-release-invalid; 8 source-family-exhausted; 0 open candidates.",
-      "last_regenerated_utc": "2026-03-25T17:43:58.519222+00:00"
+      "last_regenerated_utc": "2026-03-25T18:33:58.854568+00:00"
     }
   ]
 }

site/data/dataset_status.csv

@@ -1,35 +1,35 @@
 dataset,readiness_tier,source_quality,headline_ready,fallback_only,missing_critical_fields,last_regenerated_utc,review_maturity,public_role
-official_capture,headline_ready,exact_official,True,False,,2026-03-25T17:41:55.687787+00:00,headline_ready,supporting
-official_ati,headline_ready,exact_official_numeric,True,False,,2026-03-25T17:42:02.911116+00:00,headline_ready,headline
-qra_event_elasticity,supporting_provisional,manual_qra_shock_template_plus_event_panel,False,True,,2026-03-25T17:43:40.175696+00:00,provisional_supporting,supporting
-qra_event_registry_v2,supporting_ready,derived_event_ledger,False,False,,2026-03-25T17:43:57.974765+00:00,provisional_supporting,supporting
-qra_release_component_registry,supporting_ready,derived_component_registry,False,False,,2026-03-25T17:43:58.218498+00:00,provisional_supporting,supporting
-qra_benchmark_coverage,supporting_ready,derived_benchmark_coverage,False,False,,2026-03-25T17:43:58.218498+00:00,supporting_ready,supporting
-qra_benchmark_blockers_by_event,supporting_ready,derived_benchmark_blockers,False,False,,2026-03-25T17:43:58.562616+00:00,supporting_ready,supporting
-qra_benchmark_evidence_registry,supporting_ready,derived_benchmark_evidence_registry,False,False,,2026-03-25T17:43:58.218498+00:00,supporting_ready,supporting
-qra_causal_qa_ledger,supporting_ready,derived_causal_qa,False,False,,2026-03-25T17:43:58.508722+00:00,provisional_supporting,supporting
-causal_claims_status,supporting_ready,derived_causal_claims_status,False,False,,2026-03-25T17:43:58.519222+00:00,supporting_ready,supporting
-official_capture_history_status,supporting_ready,exact_official_window_plus_archive_scaffold_history,False,False,,2026-03-25T17:41:55.687787+00:00,supporting_ready,supporting
-official_capture_backfill_queue,supporting_ready,derived_backfill_queue,False,False,,2026-03-25T17:41:55.687787+00:00,supporting_ready,supporting
-event_design_status,supporting_ready,derived_event_design_status,False,False,,2026-03-25T17:43:58.519222+00:00,provisional_supporting,supporting
-qra_shock_crosswalk_v1,supporting_ready,derived_shock_crosswalk,False,False,,2026-03-25T17:43:59.112738+00:00,provisional_supporting,supporting
-treatment_comparison_table,supporting_ready,derived_treatment_comparison,False,False,,2026-03-25T17:43:32.165169+00:00,supporting_ready,supporting
-qra_long_rate_translation_panel,supporting_provisional,derived_long_rate_translation,False,True,,2026-03-25T17:43:59.112738+00:00,provisional_supporting,supporting
-event_usability_table,supporting_ready,derived_qra_usability,False,False,,2026-03-25T17:43:59.433317+00:00,supporting_ready,supporting
-leave_one_event_out_table,supporting_ready,derived_qra_robustness,False,False,,2026-03-25T17:44:03.587987+00:00,provisional_supporting,supporting
-auction_absorption_table,supporting_ready,derived_absorption_bridge,False,False,,2026-03-25T17:44:11.320997+00:00,supporting_ready,supporting
-plumbing,headline_ready,headline_exact_net_with_labeled_fallbacks,True,False,,2026-03-25T17:44:19.340738+00:00,headline_ready,headline
-duration,headline_ready,headline_hybrid_exact_with_labeled_fallbacks,True,False,,2026-03-25T17:44:24.470446+00:00,headline_ready,headline
-pricing,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.101963+00:00,provisional_supporting,supporting
-pricing_spec_registry,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.098742+00:00,provisional_supporting,supporting
-pricing_regression_summary,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.101963+00:00,provisional_supporting,supporting
-pricing_regression_robustness,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.125497+00:00,provisional_supporting,supporting
-pricing_subsample_grid,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.108528+00:00,provisional_supporting,supporting
-pricing_release_flow_panel,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:33.868710+00:00,provisional_supporting,supporting
-pricing_release_flow_leave_one_out,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.161971+00:00,provisional_supporting,supporting
-pricing_tau_sensitivity_grid,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.178542+00:00,provisional_supporting,supporting
-pricing_scenario_translation,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T17:44:43.132544+00:00,provisional_supporting,supporting
-extension_investor_allotments,summary_ready,summary_ready,False,False,,2026-03-25T17:42:45.859726+00:00,summary_ready,supporting
-extension_primary_dealer,summary_ready,summary_ready,False,False,,2026-03-25T17:42:57.344742+00:00,summary_ready,supporting
-extension_sec_nmfp,summary_ready,summary_ready,False,False,,2026-03-25T17:43:05.830433+00:00,summary_ready,supporting
+official_capture,headline_ready,exact_official,True,False,,2026-03-25T18:33:22.293280+00:00,headline_ready,supporting
+official_ati,headline_ready,exact_official_numeric,True,False,,2026-03-25T18:33:23.767777+00:00,headline_ready,headline
+qra_event_elasticity,supporting_provisional,manual_qra_shock_template_plus_event_panel,False,True,,2026-03-25T18:33:49.580500+00:00,provisional_supporting,supporting
+qra_event_registry_v2,supporting_ready,derived_event_ledger,False,False,,2026-03-25T18:33:58.601318+00:00,provisional_supporting,supporting
+qra_release_component_registry,supporting_ready,derived_component_registry,False,False,,2026-03-25T18:33:58.719576+00:00,provisional_supporting,supporting
+qra_benchmark_coverage,supporting_ready,derived_benchmark_coverage,False,False,,2026-03-25T18:33:58.719576+00:00,supporting_ready,supporting
+qra_benchmark_blockers_by_event,supporting_ready,derived_benchmark_blockers,False,False,,2026-03-25T18:33:58.871686+00:00,supporting_ready,supporting
+qra_benchmark_evidence_registry,supporting_ready,derived_benchmark_evidence_registry,False,False,,2026-03-25T18:33:58.719576+00:00,supporting_ready,supporting
+qra_causal_qa_ledger,supporting_ready,derived_causal_qa,False,False,,2026-03-25T18:33:58.849803+00:00,provisional_supporting,supporting
+causal_claims_status,supporting_ready,derived_causal_claims_status,False,False,,2026-03-25T18:33:58.854568+00:00,supporting_ready,supporting
+official_capture_history_status,supporting_ready,exact_official_window_plus_archive_scaffold_history,False,False,,2026-03-25T18:33:22.293280+00:00,supporting_ready,supporting
+official_capture_backfill_queue,supporting_ready,derived_backfill_queue,False,False,,2026-03-25T18:33:22.293280+00:00,supporting_ready,supporting
+event_design_status,supporting_ready,derived_event_design_status,False,False,,2026-03-25T18:33:58.854568+00:00,provisional_supporting,supporting
+qra_shock_crosswalk_v1,supporting_ready,derived_shock_crosswalk,False,False,,2026-03-25T18:33:58.981885+00:00,provisional_supporting,supporting
+treatment_comparison_table,supporting_ready,derived_treatment_comparison,False,False,,2026-03-25T18:33:45.275760+00:00,supporting_ready,supporting
+qra_long_rate_translation_panel,supporting_provisional,derived_long_rate_translation,False,True,,2026-03-25T18:33:58.981885+00:00,provisional_supporting,supporting
+event_usability_table,supporting_ready,derived_qra_usability,False,False,,2026-03-25T18:33:59.097179+00:00,supporting_ready,supporting
+leave_one_event_out_table,supporting_ready,derived_qra_robustness,False,False,,2026-03-25T18:34:00.796515+00:00,provisional_supporting,supporting
+auction_absorption_table,supporting_ready,derived_absorption_bridge,False,False,,2026-03-25T18:34:05.670726+00:00,supporting_ready,supporting
+plumbing,headline_ready,headline_exact_net_with_labeled_fallbacks,True,False,,2026-03-25T18:34:11.071110+00:00,headline_ready,headline
+duration,headline_ready,headline_hybrid_exact_with_labeled_fallbacks,True,False,,2026-03-25T18:34:14.002634+00:00,headline_ready,headline
+pricing,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.374923+00:00,provisional_supporting,supporting
+pricing_spec_registry,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.372983+00:00,provisional_supporting,supporting
+pricing_regression_summary,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.374923+00:00,provisional_supporting,supporting
+pricing_regression_robustness,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.378239+00:00,provisional_supporting,supporting
+pricing_subsample_grid,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.376871+00:00,provisional_supporting,supporting
+pricing_release_flow_panel,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:18.966542+00:00,provisional_supporting,supporting
+pricing_release_flow_leave_one_out,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.380368+00:00,provisional_supporting,supporting
+pricing_tau_sensitivity_grid,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.381092+00:00,provisional_supporting,supporting
+pricing_scenario_translation,supporting_provisional,derived_pricing_reduced_form,False,True,,2026-03-25T18:34:25.379121+00:00,provisional_supporting,supporting
+extension_investor_allotments,summary_ready,summary_ready,False,False,,2026-03-25T18:33:27.285138+00:00,summary_ready,supporting
+extension_primary_dealer,summary_ready,summary_ready,False,False,,2026-03-25T18:33:31.978975+00:00,summary_ready,supporting
+extension_sec_nmfp,summary_ready,summary_ready,False,False,,2026-03-25T18:33:37.646055+00:00,summary_ready,supporting
 extension_tic,not_started,not_started,False,True,,,provisional_supporting,supporting