3 Commits

Author	SHA1	Message	Date
Brummel	07a73fb66e	docs(cli,ledger): sweep #159 demo-retirement drift — stale comments + ledger notes ... Cycle-close audit tidy for the #159 demo-retirement arc: behaviour-free reword of prose/comments/docs left pointing at symbols the arc deleted. Adversarially verified by the audit workflow; cargo build --workspace --all-targets green. - README: drop the removed `--harness` token; restrict the legacy built-in form claim to walkforward/mc/generalize (run/sweep no longer resolve one). - glossary: the built-in `--strategy` sweep surface is retired (#159), not a live inline path. - INDEX.md ledger: append [HISTORY] supersession markers (house style) to the dated realization notes advertising the retired `--harness` / built-in `--strategy` CLI forms (cost-flag #153, cycles 0065/0066/0067, name-res, #210 status); historical text preserved. - aura-engine test-fixture docs: drop dead cross-crate refs to the deleted aura-cli fns sample_harness / build_sample and the deleted `macd` composite. - cli_run.rs: reword the #159-cut-2 pin doc to the current clap generic-usage reality (no strategy_from / Strategy::RBreakout); r_sma_sweep_family -> blueprint_sweep_family. - verb_sugar.rs: fix the pre-existing `E[R]` unresolved-doc-link warning. Remaining tidy — the main.rs comment cluster plus its rustdoc link at :1546 (the second cargo-doc warning) — held for a follow-up issue. The dead cost-graph branch is tracked in #221. refs #159	2026-07-08 11:12:22 +02:00
Brummel	7b429f931a	audit: cycle 0104 tidy (drift-clean after three doc-mirror alignments) ... Architect drift review (range d5c4361..45fb06d): drift_found, three items, all doc-mirror — resolved inline as close-fixes: - docs/design/INDEX.md — the two #171 deferral passages (C18 #158 realization + C24 status) now record the shipped identity id (additive sibling; content id keeps the store/reproduce roles; introspection-only until a dedup consumer exists). Whole-harness / structural-axis content-addressing stays deferred. - README.md — introspect table gains the --identity-id row incl. the combinable id-flag behaviour. - docs/glossary.md — three record-reality entries: content id, identity id (Avoid: identity hash, topology-identity hash), topology hash; the README row aligned to the canonical term. What holds (architect): additive-sibling discipline intact (no store code touched, every content-id/topology_hash pin green); C23 honoured precisely (each strip arm has a protecting property test; factoring byte-preserving via the canonical golden); the two extra engine tests are genuinely distinct coverage (recursion arm, role/output arms), no redundancy. Regression gates (all green): cargo build clean; cargo test --workspace 884 passed / 0 failed (873 baseline + 11 new); clippy --all-targets -D warnings clean; cargo doc --no-deps 0 warnings. Ephemeral cycle artifacts removed per project convention (git rm): docs/specs/0104-topology-identity-hash.md, docs/plans/0104-topology-identity-hash.md. refs #180	2026-07-02 21:29:38 +02:00
Brummel	a45d16b054	docs: add a top-level README mapping the shipped CLI surface ... The repo had no README, and a milestone fieldtest found the whole blueprint-data verb family (run / sweep / mc / walkforward over a blueprint.json), the graph build / graph introspect construction surface, and the op-list document shape discoverable only from the design ledger — a downstream consumer with just the binary could not find the milestone's own surface. Document them as a discoverability map: each verb's purpose and shape, the open-vs-closed and family concepts, and a worked op-list example (copied from a compiling test). Per-flag detail is kept light and delegated to `aura <cmd> --help` and the ledger, so the README neither duplicates nor collides with the in-flight help rework and does not drift as flags evolve. This is the discoverability half of the harness-retirement work; retiring the hard-wired harnesses themselves stays gated on the project-as-crate authoring layer. refs #159	2026-07-02 09:41:54 +02:00