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.
2.3 KiB
C7 — Four scalar base types, streamed as SoA: 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: c07-scalar-soa.md.
Realization (Cell carrier split, 2026-06). The streamed value is now split
into a tag-free 64-bit word and its kind. Cell (crates/aura-core/src/cell.rs)
is a type-erased u64: constructed per base type (from_i64/f64/bool/ts) and
read only by naming the type at the call site (i64()/f64()/bool()/ts() —
branch-free bit-casts). The kind is therefore resolved once at the boundary and
the value itself carries no tag — C7's "the type lives at the column/edge, not in
the value" made explicit on the single-value carrier (and a single 8-byte word
vs. the 16-byte tagged enum). Scalar becomes { kind: ScalarKind, cell: Cell }
— the self-describing form for the dynamic boundaries (builder binding, serde,
rendering) — with debug_assert-guarded native accessors (caller asserts the
kind; free in release) and a hand-written value PartialEq that preserves
the former enum's IEEE-754 semantics (NaN != NaN, +0.0 == -0.0), pinned by
the scalar_eq_is_value_not_bitwise fixture. Behaviour-preserving.
Realization (Cell becomes the hot-path carrier, 2026-06, #74). The carrier
swap deferred above has landed: Node::eval now returns Option<&[Cell]> and
every node out-buffer is [Cell; N], so the inter-node forward carries tag-free
8-byte words. The kind lives only at the schema/column: the harness forwards each
field via the new branch-free AnyColumn::push_cell (infallible — the edge
kind match is verified once at bootstrap, the surviving guard
bootstrap_rejects_*_kind_mismatch). Scalar remains on the self-describing
dynamic boundaries: the param plane (build/bind/compile_with_params/sweep
points/RunManifest), AnyColumn::get (the type-erased read for sinks/serde),
and source ingestion (Source::next, the heterogeneous C3 merge). The removed
per-value runtime kind check on node output is the same authoring-bug class C8
already leaves to a debug_assert (output width); node-output-kind correctness
is the node's declared FieldSpec contract, caught by each node's own test.
Behaviour-preserving (C1).