Files
Aura/docs/design/contracts/c20-strategy-harness.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

2.5 KiB

C20 — Strategy ↔ harness; the harness is the root sim graph: 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: c20-strategy-harness.md.

Realization (GER40 session-breakout blueprint milestone, 2026-06-17 — refs #94/#96/#97, spec 0051). Made concrete on the first real-data strategy: a hand-wired FlatGraph is not a shippable strategy — it carries no param_space(), so the World families (sweep / walk_forward / compare, C21) cannot consume it without a hand re-author (the friction the GER40 deep-dive fieldtest surfaced). The canonical shippable form is the Composite blueprint (the authoring/source level, C9/C19); the FlatGraph is only its compiled substrate (C23). The breakout now ships as ger40_breakout_blueprint(bar_period, …) whose param_space() is exactly its tuning knobs ({entry_bar.target, exit_bar.target}); the bar period is a construction argument binding Resample + Session together — a structural matrix axis (C12: a different period is a different strategy, not a sweep point), never a param_space entry, so a sweep cannot desync the two clocks. This is the concrete instance of the structural-axis-vs-tuning-param split above (and delay.lag, a C8 structural constant, is bound out of the space).

Refinement (2026-06-29 — experiment-matrix members are topology-data, C24). "The experiment matrix is ordinary Rust control flow, not a config schema" holds for the generator — the loop / conditional that enumerates structural variants may stay Rust (C17). But each member it yields is a topology-data value (C24), not a hand-coded blueprint nor engine-baked source: a structural axis selects among data blueprints the World constructs, mutates, and serializes. This is what makes structural variation first-class and searchable rather than a hand-enumerated menu — HarnessKind and the per-strategy *_sweep_family functions in aura-cli are the pre-C24 scaffolding (topology-as-engine-source, a C16 tension), retired as C24 + the project-as-crate layer land. [C26 realization, 2026-07-10 (#231): the scaffolding's last data weld — wrap_r's hard-wired price←close role and the M1Field::Close-only open sites — is retired; a strategy's input roles now bind archive columns by name (C26). wrap_r's remaining R-scaffolding retirement stays #159.]