From a12617bb80b785244a77b53fe7a72ea7b44e78c9 Mon Sep 17 00:00:00 2001 From: claude Date: Tue, 21 Jul 2026 12:58:02 +0200 Subject: [PATCH] =?UTF-8?q?audit:=20document-first=20cycle=20close=20?= =?UTF-8?q?=E2=80=94=20doc=20verb=20rosters=20caught=20up?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Architect review (cycle 757e3ac): core clean — show is pure shell dispatch over Env::registry() (C28); both ledger amendments match the F1-F8 decision log exactly; document schema untouched; the #164 no-framing pin is stricter than the spec snippet asked. Four peripheral drift items, resolved: - fix: docs/authoring-guide.md verb rosters now name show (process) and show|runs (campaign) — the guide teaches exactly the generate->retrieve->extend loop this cycle closed. - fix: docs/glossary.md campaign/process document entries carry the settled verb sets (record-reality glossary write). - fix: show_process's not-found refusal now sources its prose from ref_fault_prose(ProcessNotFound) instead of a hand-copied format! (byte-identical, test-pinned; the campaign-side prose has no RefFault sibling and stays the single campaign instance). - ratify (log-only): the shipped show helpers use print! (no framing, #164) where the spec snippet sketched println! — the code is the stricter, correct form; recorded on the reference issue's decision log. The spec is a git-ignored working file swept at this close. Regression: aura-bench report-only run, all fingerprints OK, deltas in noise (host load 9.6 noted; engine/ingest/campaign/cli lanes all within ±5%). Full aura-cli gates re-run green after the tidy edits. refs #300 --- crates/aura-cli/src/research_docs.rs | 2 +- docs/authoring-guide.md | 4 ++-- docs/glossary.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/crates/aura-cli/src/research_docs.rs b/crates/aura-cli/src/research_docs.rs index ea527e1..46c64a8 100644 --- a/crates/aura-cli/src/research_docs.rs +++ b/crates/aura-cli/src/research_docs.rs @@ -273,7 +273,7 @@ fn show_process(id: &str, env: &Env) -> Result<(), String> { print!("{bytes}"); Ok(()) } - None => Err(format!("process {id} not found in the project store{}", prefix_hint(id))), + None => Err(ref_fault_prose(&RefFault::ProcessNotFound(id.to_string()))), } } diff --git a/docs/authoring-guide.md b/docs/authoring-guide.md index cf3d481..28705d9 100644 --- a/docs/authoring-guide.md +++ b/docs/authoring-guide.md @@ -7,10 +7,10 @@ JSON artifact kinds you author headlessly along that arc: 1. an **op-script** (role 6a) — builds a node graph (a strategy blueprint) through `aura graph build`; 2. a **process document** (role 5) — a named validation/eval methodology - through `aura process validate|introspect|register`; + through `aura process validate|introspect|register|show`; 3. a **campaign document** (role 6b) — experiment intent (instruments × windows × strategy × axes × process) through `aura campaign - validate|introspect|register|run`. + validate|introspect|register|show|run|runs`. Each section below is a worked, verified example — every command shown was run against this repo and the output is transcribed, not invented. The *why* diff --git a/docs/glossary.md b/docs/glossary.md index 1b347f9..48ff14f 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -45,7 +45,7 @@ A downstream consumer node, never part of the strategy: the signal-quality side ### campaign document **Avoid:** experiment doc, campaign file -The role-6b research artifact (#188/#189): persisted experiment intent as closed-vocabulary canonical JSON — instruments × windows × strategy refs (by `content id` or `identity id`) × per-strategy param axes (each axis declares its `ScalarKind` once over bare values) × a process reference (content-id-only) × data-level presentation (taps to persist — the closed `tap` vocabulary — and tables to emit). Authored, validated, and executed headless (`aura campaign validate|introspect|register|run`), content-addressed beside blueprints in the registry store; carries P1 control constructs (bounded axes, gates, ladders) as intent, executed by `aura campaign run` (v2 pipeline shape `std::sweep [std::gate]* [std::walk_forward]? [std::monte_carlo]? [std::generalize]?` — the two annotators terminal, cycles 0107/0108, #198/#200) into a `campaign run` realization. `std::sweep`'s own selection group (`metric`+`select`) is optional, all-or-nothing, and permitted only as the pipeline's terminal stage when omitted (a selection-free sweep, #210). +The role-6b research artifact (#188/#189): persisted experiment intent as closed-vocabulary canonical JSON — instruments × windows × strategy refs (by `content id` or `identity id`) × per-strategy param axes (each axis declares its `ScalarKind` once over bare values) × a process reference (content-id-only) × data-level presentation (taps to persist — the closed `tap` vocabulary — and tables to emit). Authored, validated, and executed headless (`aura campaign validate|introspect|register|show|run|runs` — `show` prints a registered document's canonical bytes back, #300), content-addressed beside blueprints in the registry store; carries P1 control constructs (bounded axes, gates, ladders) as intent, executed by `aura campaign run` (v2 pipeline shape `std::sweep [std::gate]* [std::walk_forward]? [std::monte_carlo]? [std::generalize]?` — the two annotators terminal, cycles 0107/0108, #198/#200) into a `campaign run` realization. `std::sweep`'s own selection group (`metric`+`select`) is optional, all-or-nothing, and permitted only as the pipeline's terminal stage when omitted (a selection-free sweep, #210). ### campaign run **Avoid:** campaign execution record, realized campaign @@ -203,7 +203,7 @@ A broker-independent, time-ordered table of position events (scalar columns: `ev ### process document **Avoid:** process doc, methodology file -The role-5 research artifact (#188/#189): a named, versionable validation/eval methodology as closed-vocabulary canonical JSON — an ordered pipeline of std stage blocks (`std::sweep`, `std::gate`, `std::walk_forward`, `std::monte_carlo`, `std::generalize`) wrapping shipped analysis/selection primitives, with typed gate predicates over the declared metric vocabulary. Authored and validated headless (`aura process validate|introspect|register`), content-addressed in the registry store; campaigns reference it by `content id` only — a one-off methodology is a process document with a disposable name, never an inline body. +The role-5 research artifact (#188/#189): a named, versionable validation/eval methodology as closed-vocabulary canonical JSON — an ordered pipeline of std stage blocks (`std::sweep`, `std::gate`, `std::walk_forward`, `std::monte_carlo`, `std::generalize`) wrapping shipped analysis/selection primitives, with typed gate predicates over the declared metric vocabulary. Authored and validated headless (`aura process validate|introspect|register|show`), content-addressed in the registry store; campaigns reference it by `content id` only — a one-off methodology is a process document with a disposable name, never an inline body. ### R **Avoid:** —