claude
8688a60ded
The single-file ledger had grown to 2968 lines / ~42k tokens, mixing current design law with accreted history: 59 cycle-stamped realization blocks, 18 [HISTORY] passages, 22 supersession markers, and the C10 / C22 / C24 reframe sagas layered several supersessions deep. A code-grounding audit (31 agents, adversarially verified) confirmed 11 defects stated as current truth: stale crate homes from the C28 #288 roster split (cost nodes, PositionManagement, PositionEvent, Session), the renamed InputSpec->PortSpec, the pre-#241 project model in C16 and the open-threads section, a stale HarnessKind retirement deferral in C24, and three C28-internal inconsistencies. New shape, per the ailang precedent: - INDEX.md stays the sole addressable entry point: foundation, external components, a C-id-keyed contract map (one line per contract), and only the genuinely open architectural threads. - contracts/cNN-<slug>.md carries each contract's current truth only: Guarantee / Forbids / Why with ratified refinements integrated, plus a code-anchored Current state. All confirmed defects are fixed here; crate anchors were re-verified against the tree. - contracts/cNN-<slug>.history.md (18 sidecars) and INDEX.history.md preserve every superseded block verbatim, stamps and issue refs intact, under a frozen-record banner. Nothing was deleted: superseded design intent remains an addressable working-tree artifact, off the per-cycle audit walk. - Ledger discipline is now stated in INDEX.md: live files are edited in place at cycle close, superseded text moves verbatim to the sidecar, and a supersession marker in a live file is itself an audit finding. Every contract file was verified against its old text by an independent zero-loss pass (statement-by-statement) plus a code-accuracy spot check; C-ids and contract titles are unchanged, so existing C-id citations in code, tests, and issues resolve as before.
16 lines
940 B
Markdown
16 lines
940 B
Markdown
# C4 — Cycle granularity: history
|
|
|
|
> FROZEN HISTORICAL RECORD. Each block below was true as of its cycle/date stamp
|
|
> and may be superseded; this file is NOT current truth and NOT a grounding
|
|
> surface. Current contract: [c04-cycle-granularity.md](c04-cycle-granularity.md).
|
|
|
|
**Realization (#275, 2026-07-15).** Ingestion sources are supplied to `run` **by
|
|
role name**, not by list position. `SourceSpec` carries a `role: Option<String>`
|
|
(the bound `Role`'s name, load-bearing for source binding), and `Harness::run_bound`
|
|
resolves a keyed supply against those roles, emitting sources in `SourceSpec`
|
|
declaration order. The C4 tie-break stays "source declaration order" — now
|
|
independent of how the caller orders the supply — and a mis-bound feed is a named
|
|
`SourceBindError` at start time rather than a silently wrong run. The raw-index
|
|
`run(Vec)` primitive (positional, C23) is unchanged; every hand-built graph keeps
|
|
`role: None`.
|