Skip to content

Column closure: every artifact column claimed by exactly one lineage class (spec totality) #697

Description

@MaxGhenis

Max, 2026-08-15: the process diagrams should have revealed the geography flaw sooner — the observability has to be total, not just cover the parts we extracted.

The measurement

Column-closure audit of the f025 artifact against the lineage spec (#695), 2026-08-15:

Inventory: one JSON fixture of entity/column names extracted from the artifact (names only, no data).

The increment

  1. Total lineage classes in specs/us_imputation_lineage.yaml: measured_native (per source channel), imputed (existing), computed (existing), assigned_by_ladder (Geography ladder: use ASEC identified county, adopt in the stacked path, declare the block-draw conditioning #696 lane adds), take_up_draw (new — each flag's distribution, conditioning, parameter source, and calibration status), receipt, structural.
  2. Column-closure conformance test: the artifact column inventory is a committed fixture; every column must be claimed by exactly one class entry; unclaimed or doubly-claimed ⇒ test failure. Inventory regenerated by a tool from any built artifact; drift between fixture and a fresh build fails loudly.
  3. Coverage meter on /lineage: claimed/total rendered in the hero, per class — the number that keeps us honest.
  4. Immediate deep-dive owed: the take_up_* mechanism (where drawn, from what) documented into the spec as part of this increment — it is currently exactly as invisible as geography was.

Sequencing: lands after the two wave-1 lanes (#696 block-first, per-family predictor sets) merge, since all three edit the same spec file. Owner runs it as its own PR.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions