chore(cli,docs): #220 cycle-close audit — doc reconcile + dispatch dedup

Cycle-close audit for the verb-axis-generalization cycle (a2294c7,
e7efe1f, b849bb7). Architect drift review: what holds — all four verbs
route through the one validate_and_register_axes seam into the campaign
executor; RGrid gone workspace-wide; zero too_many_arguments allows in
verb_sugar.rs; no r_sma_open embed at the verb dispatch sites (the
aura-graph default embed survives by design). Five drift items found,
all resolved fix-path in this commit:

- README (blueprint-verbs section + mc row), glossary (walk-forward
  entry), and ledger (verb-dissolution passage) reconciled to the
  shipped generic grammar; the ledger HISTORY note now separates the
  two supersessions correctly (#159 retired the built-in --strategy
  demo surface; #220 de-welded the verbs) instead of mis-attributing
  the weld removal to #159.
- Four stale characterization doc-comments in cli_run.rs reworded:
  the retired welded grammar is now named as the pinned grades'
  provenance, not the current spelling; one dangling reference to a
  deleted test repointed to the live anchor.
- The quadruplicated dispatch blocks extracted into two shared helpers
  beside validate_and_register_axes: exit_axis_register_error (the
  AxisRegisterError exit-map, byte-identical stderr + exit codes) and
  campaign_window_ms (from_choice -> full_window -> unix-ms clip);
  generalize's explicit unclipped (Some, Some) passthrough arm is
  untouched — only its fallback arm, which already ran the identical
  mechanics, calls the helper.

Regression gate green, no baseline moved (nothing to ratify):
cargo test --workspace exit 0, 62 test-result groups, 0 failures;
clippy --workspace --all-targets -D warnings clean; cargo doc
--workspace --no-deps 0 warnings. Spent cycle spec + plan working
files discarded per lifecycle.

refs #220
This commit is contained in:
2026-07-09 15:35:47 +02:00
parent b849bb76b9
commit 4acea45519
5 changed files with 97 additions and 108 deletions
+13 -6
View File
@@ -2374,12 +2374,19 @@ the project layout and docs-by-role are open (#192 context).
(`<bp.json> --real`), while `aura sweep --strategy r-sma --real` stays the inline built-in
path (its member lines carry no instrument/topology_hash/selection stamp and register no
campaign document) — the built-in `--strategy` demo surface is #159's hard-wired-harness
retirement target, not the dissolution's; for generalize/walkforward/mc the dissolved form
is `--strategy r-sma --real`. [HISTORY — #159 (cuts 1b-4) has since landed
(post-2026-07-07): the retirement target has been hit — the built-in
`--strategy` sweep/demo surface is retired and the inline `--strategy r-sma
--real` path no longer exists; the surviving form is `aura <verb>
<blueprint.json> --axis …` over examples/r_*.json.] Milestone closed 2026-07-07 on a green end-to-end fieldtest
retirement target, not the dissolution's; for generalize/walkforward/mc the dissolved
form is now the same generic grammar as sweep — an arbitrary blueprint positional plus
`--real` and repeatable `--axis <wrapped-name>=<csv>` (#220). [HISTORY — superseded in
two steps. #159 (cuts 1b-4, post-2026-07-07) retired the built-in `--strategy`
sweep/demo surface: the inline `aura sweep --strategy r-sma --real` path no longer
exists. #220 then removed the verbs' weld — at milestone close the dissolved form of
generalize/walkforward/mc was still the welded `--strategy r-sma --real`; #220 made
the three verbs blueprint-generic (arbitrary blueprint + arbitrary `--axis`; mc keeps
the synthetic `--seeds` family unchanged beside the new `--real --axis` campaign mode;
generalize takes `--real <SYM1,SYM2,…>`, >=2, with one value per axis), deleted the
welded `--strategy` grammar (clap rejects it, exit 2), dissolved `RGrid`, and unified
the verbs on the #214 invocation struct. The surviving form everywhere is `aura <verb>
<blueprint.json> --real … --axis …` over examples/r_*.json.] Milestone closed 2026-07-07 on a green end-to-end fieldtest
(0 bugs; behaviour preservation, campaign-substrate reach-through, and the risk-regime axis
all confirmed); residual findings are discoverability/ergonomics follow-ups (#216 risk-axis
discoverability, #217 verb knob asymmetry, #218 no-project store litter).