Files
Aura/docs/design/contracts/c13-hot-reload-frozen-deploy.history.md
T
claude 8688a60ded docs(ledger): split the design ledger into an INDEX map, per-contract live files, and history sidecars
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.
2026-07-21 16:40:36 +02:00

1.6 KiB

C13 — Hot-reload is authoring-only; deploy is frozen: 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: c13-hot-reload-frozen-deploy.md.

Realization (cycle 0102 — the load boundary; per-invocation reload). The authoring-loop half is realized: a project is an external cdylib crate loaded per invocation through a two-tier #[repr(C)] descriptor (AURA_PROJECT, aura-core::project) — a C-ABI stamp prefix (rustc version + aura-core version, baked per consuming build) validated before any Rust-ABI field is touched, then the vocabulary resolver + enumerable type-id list behind the stamp gate. "Hot-reload" reads, in v1, as per-invocation load of the freshest build: the author (Claude) runs cargo build, the next aura invocation locates the artifact via cargo metadata (debug default, --release opt-in) and loads it load-and-hold (leaked, never unloaded). Scope boundary: load-and-hold is trivially sound only because the CLI is a one-shot process — a future long-running host (the open local-server thread, C22) must re-solve reload (host restart or subprocess isolation), never in-process unload. Mismatch of either stamp refuses (exit 1) naming both sides; the project vocabulary is charter-checked at load (::-namespaced ids, no duplicates against std, list↔resolver cross-check) — the invariant-9 data-plane discipline of the C24 enforcement-shift note, now enforced at the one seam.