Skip to content

Carry the geography ladder by default; gate releases on it#289

Merged
MaxGhenis merged 1 commit into
mainfrom
geo-ladder-default
Jul 2, 2026
Merged

Carry the geography ladder by default; gate releases on it#289
MaxGhenis merged 1 commit into
mainfrom
geo-ladder-default

Conversation

@MaxGhenis

Copy link
Copy Markdown
Contributor

Follow-up to #277 (populace #275). The ladder shipped opt-in: nothing stopped a base or a release from being built without the geography spine — the silent-degradation family (#225's everyone-is-a-citizen, #34's NYC-zero) with a new face. Carrying the ladder is now the default at both enforcement points:

  • Base builder (tools/build_us_puf_support_base.py): omitting --block-ladder-artifact is an error; diagnostic builds opt out explicitly with --without-block-ladder, and the opt-out is recorded in the build summary.
  • Release export (l0_refit_export): the geography spine (state_fips, congressional_district_geoid, and the seven ladder columns) joins US_RELEASE_REQUIRED_HOUSEHOLD_SOURCE_COLUMNS (presence-checked; value quality is the gate's job), and the us_geography_ladder gate runs on the selected support with its calibrated weights — a release whose spine is inconsistent or whose NYC mass collapsed fails by default. --allow-geography-ladder-gate-failures is the diagnostic escape hatch, mirroring --allow-input-mass-drift, and the gate result lands in the export summary either way.

Operational note: reconstructions of ladder-less bases (anything built before #277) now require the explicit escape hatches — that is the point. The national ladder artifact builds in minutes from cached sources via tools/build_us_block_ladder_artifact.py (18MB NPZ; validated at 5,769,942 blocks / population exactly 331,449,281 / 436 CDs / 3,143 counties).

🤖 Generated with Claude Code

The ladder shipped opt-in (#277): nothing stopped a base or release from
being built without the geography spine, which is the silent-degradation
family (#225 everyone-is-a-citizen, #34 NYC-zero) this repo legislates
against.

- tools/build_us_puf_support_base.py: omitting --block-ladder-artifact is
  now an error; diagnostic builds opt out explicitly with
  --without-block-ladder (recorded in the summary).
- L0/refit release export: the geography spine (state_fips,
  congressional_district_geoid, and the seven ladder columns) joins the
  required release source columns (presence; value quality is the gate's
  job), and the us_geography_ladder gate runs on the selected support
  with its calibrated weights — a release whose spine is inconsistent or
  whose NYC mass collapsed fails by default.
  --allow-geography-ladder-gate-failures is the diagnostic escape hatch;
  the gate result is recorded in the export summary either way.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@MaxGhenis MaxGhenis merged commit f281826 into main Jul 2, 2026
4 checks passed
@MaxGhenis MaxGhenis deleted the geo-ladder-default branch July 2, 2026 15:34
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.

1 participant