docs(cli,ledger): #168 cycle-close audit — reconcile the --trace surfaces (closes #168)

The #168 refusal left sibling --trace surfaces still lying and the design ledger
still describing CLI --trace as a live persist path (surfaced by the cycle-close
architect drift review). Reconcile them to record reality:

- the chart NotFound hint no longer points at `aura run --trace` (itself refused);
  it names the live trace-writer (a campaign document's persist_taps presentation).
- RunCmd/McCmd --trace help stop promising persistence (both flags already refuse).
- README drops --trace from the live naming flags.
- the ledger records the CLI --trace retirement: per-member --trace was never
  wired to the blueprint sweep (`let _ = persist`) and was silently dropped at
  #159/#220 — it never migrated as the old HISTORY note claimed; the single live
  TraceStore::write is the campaign persist_taps; restoration is deferred to #224.

Workspace suite green (62 groups / 0 failed), clippy -D warnings clean.

closes #168
This commit is contained in:
2026-07-10 00:04:27 +02:00
parent abbfbdc208
commit f2526b1720
3 changed files with 13 additions and 7 deletions
+3 -3
View File
@@ -447,7 +447,7 @@ fn emit_chart(name: &str, tap: Option<&str>, mode: ChartMode, env: &project::Env
NameKind::NotFound => {
eprintln!(
"aura: no recorded run or family '{name}' under runs/traces \
(run `aura run --trace {name}` first)"
(traces are written by a campaign document's `persist_taps` presentation)"
);
std::process::exit(1);
}
@@ -2149,7 +2149,7 @@ struct RunCmd {
/// Window end (Unix ms, inclusive); requires --real.
#[arg(long)]
to: Option<i64>,
/// Persist the run's taps under `runs/traces/<name>` and still print the report.
/// Not accepted — CLI-side trace persistence is retired (see #224).
#[arg(long)]
trace: Option<String>,
}
@@ -2235,7 +2235,7 @@ struct McCmd {
/// Family name for the synthetic seed-resweep (records without persisting traces).
#[arg(long)]
name: Option<String>,
/// Family name that also persists each seed's taps (mutually exclusive with --name).
/// Not accepted with --real — the R-bootstrap records without a family name.
#[arg(long)]
trace: Option<String>,
/// Blueprint IS-refit axis `<name>=<csv>` (repeatable, >=1 required; --real mode).