Skip to content

feat(analysis): add Cornerstone GHG FBS pin builder toolkit - #1141

Merged
bl-young merged 2 commits into
mainfrom
by-fbs-toolkit
Oct 22, 2026
Merged

bl-young merged 2 commits into
mainfrom
by-fbs-toolkit

Conversation

@bl-young

Copy link
Copy Markdown
Member

cc:
Related: #1136, #1123

Stack: 1 of 2 (toolkit). Follow-on: promote 2024 regen pin JSON after GCS upload.

What changed? Why?

Adds bedrock/analysis/ghg_fbs_pin, optional local builder scripts and docs for Cornerstone GHG FBS pin bumps (not a runtime or CI contract). check_upstream_inputs documents expected Energy FBS filenames and NowcastMUT vintage and can quarantine rivals; compare_gas_e and prepare_pin help rebuild and draft pin JSON/SHA256. Nothing here is wired into model load, pytest, or fbs_regeneration. Does not upload objects or change committed pin/config filenames.

Impact

No change to published USA model outputs or cornerstone_ghg_fbs_filename; analysis-only helper code under bedrock/analysis/ with no enforced constraints.

Testing

Operator dry-run only (no new automated tests): preflight for 2017-2024 and local year-stem rebuilds; 2024 gas x sector totals matched the transportation NFT golden.

uv run python -m bedrock.analysis.ghg_fbs_pin.check_upstream_inputs
uv run python -m bedrock.analysis.ghg_fbs_pin.prepare_pin --method GHG_national_Cornerstone_2024

Review focus

  • Treat upstream_inputs_pin.json as operator documentation of what a rebuild used/expects, not a hard pin enforced by the pipeline.
  • Scripts are opt-in CLI modules; absence or drift does not fail CI.

Heads-up

GCS upload of Energy/GHG year stems and the repo pin-promote PR are separate follow-ons; merge of this PR alone does not unblock fbs_regeneration.

Preflight Energy FBS + NowcastMUT vintages, gas x sector compare, and
prepare_pin draft for year-stem pin bumps without changing committed pins.
@bl-young
bl-young added this pull request to stack #1143 October 22, 2026 18:20
Co-authored-by: Cursor <cursoragent@cursor.com>
@bl-young
bl-young merged commit 719ccac into main Oct 22, 2026
5 checks passed
@bl-young
bl-young deleted the by-fbs-toolkit branch October 22, 2026 22:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants