Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
19 changes: 19 additions & 0 deletions src/v1/stage0/src/cli_run.rs
Original file line number Diff line number Diff line change
Expand Up @@ -35136,6 +35136,25 @@ fn compute_inert_carrier_data(files: &[(String, String)]) -> InertCarrierData {
if decl_count.get(name).copied().unwrap_or(0) != 1 {
continue;
}
// INTENDED SCOPE GATE, not an oversight. This lens answers ONE question --
// DESIGN §5 coverage-by-illusion: a carrier that a test makes look exercised
// while no production code reads it. A carrier that is referenced by NOTHING,
// test included, is a different class with a different remedy (delete it, or
// write the missing test and let it land here), so it cannot share this
// roster: a roster row means "modeled ahead of its consumer, tested, awaiting
// one", and every one of these would be a row asserting a test that does not
// exist. That class is owned by the still-unbuilt run-root reachability cut
// (gunbc.plans.inert_layer_lens, `v2.lens.inert_layer`), whose retirement
// condition names it. Measured over `dag` + `src/v2` at 32597358f16 on
// 2026-08-24: 8821 declared carriers, 14 flagged here, 270 skipped by this
// line -- the same order the plan predicted for a raw sweep ("hundreds"),
// which is why the two are separate cuts and not one roster. A dated
// observation, not a bound: nothing gates on either number.
// `green_control_untested_unused_carrier_is_not_flagged` below is the
// executing control that keeps this exclusion deliberate rather than latent:
// it plants exactly this carrier and asserts it stays off the roster, so
// deleting this line goes red -- executed both ways 2026-08-24: gate present,
// 12 passed; gate deleted, that one control fails with got ["Staged"].
if !self_tested.contains(name) {
continue;
}
Expand Down
22 changes: 22 additions & 0 deletions src/v2/lens/inert_carrier.dag
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,28 @@ fn inert_row(unit: String, reason: String) -> FrontierRow {
frontier_row_path(path: unit, reason: reason, dissolution: inert_carrier_row_dissolve)
}

// SCOPE, stated on the carrier rather than only in the plan that specified it: this
// roster holds carriers that are DECLARED + REFERENCED BY A TEST + read by no
// production code. A carrier referenced by nothing at all -- no consumer and no test
// -- is invisible here BY CONSTRUCTION (the self_tested gate in the host producer,
// cli_run.rs compute_inert_carrier_data), and that is intended, not a hole in the
// lens. The reason is the remedy, not the size of the set: an inert row says "modeled
// ahead of its consumer, tested, awaiting one" and dissolves when a consumer lands;
// the unreferenced class dissolves the other way -- delete the carrier, or write the
// missing test and let it land here -- so folding it in would file hundreds of rows
// each asserting a test that does not exist. It is owned by the still-unbuilt
// run-root reachability cut named in gunbc.plans.inert_layer_lens (v2.lens.inert_layer),
// whose retirement condition already carries it; this lens is not its next rung and
// must not be read as covering it.
//
// Measured over the witness layer roots (dag, src/v2) at 32597358f16 on 2026-08-24:
// 8821 declared carriers, 14 flagged here (this roster's exact 14), 270 skipped by
// that gate -- the same order the plan predicted for a raw sweep. A dated observation, not a
// bound -- nothing gates on either number, and the exclusion itself is pinned by an
// executing control in the host producer's unit tests
// (green_control_untested_unused_carrier_is_not_flagged, which plants exactly such a
// carrier and asserts it stays off this roster; executed both ways 2026-08-24 --
// gate present, 12 passed; gate deleted, that control alone fails), not by the count.
data inert_carrier_roster: List<FrontierRow> = [
inert_row(unit: "DownstreamSupportRoster", reason: "modeled downstream coverage-roster carrier from the extdeps modeling preflight (#7571): it is the declared home for support/coverage rows that an upstream module may not carry, and the plan text names it, but no module constructs or reads one yet"),
inert_row(unit: "Attempt", reason: "modeled compute-fabric execution carrier from the terminal-contract slice (#8413): one execution attempt with its lineage, declared ahead of the executor that issues attempts against a grant, and referenced only by fabric_terminal_contract_witness_test so far"),
Expand Down
Loading