From 691562494bcdbc7935c45d35bdeeeafeb28a9faf Mon Sep 17 00:00:00 2001 From: Brummel Date: Thu, 2 Jul 2026 22:24:02 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20fieldtest=20F3/F6=20doc-gap=20fixes=20?= =?UTF-8?q?=E2=80=94=20manifest=20provenance=20in=20glossary,=20Aura.toml?= =?UTF-8?q?=20scaffold=20reality?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two doc-tightenings from the green milestone fieldtest (F3, F6 in fieldtests/milestone-project-environment/FINDINGS.md): the glossary manifest entry now names the topology hash and the project provenance block {namespace, dylib_sha256, commit} a project-hosted run carries; project-layout.md's Aura.toml annotation now matches what the scaffold actually emits today ([paths] runs only — the data archive root joins once real data enters). refs #180 --- docs/glossary.md | 2 +- docs/project-layout.md | 8 +++++--- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/glossary.md b/docs/glossary.md index ce28784..9504fb8 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -137,7 +137,7 @@ A concrete, frozen graph produced by binding a blueprint to params + data + seed ### manifest **Avoid:** — -The reproducible metadata record of a run (node-commit + params + data-window + seed + broker profile), paired with metrics in the run registry — the run-output record, *not* the Cargo.toml/`Aura.toml`-style static *config* manifest. Determinism lets the full result be re-derived from this tiny record on demand. +The reproducible metadata record of a run (node-commit + params + data-window + seed + broker profile + `topology hash`, plus — for a project-hosted run — the `project` provenance block `{namespace, dylib_sha256, commit}`), paired with metrics in the run registry — the run-output record, *not* the Cargo.toml/`Aura.toml`-style static *config* manifest. Determinism lets the full result be re-derived from this tiny record on demand. ### Monte-Carlo **Avoid:** MC diff --git a/docs/project-layout.md b/docs/project-layout.md index 38652d8..3ef3d71 100644 --- a/docs/project-layout.md +++ b/docs/project-layout.md @@ -30,9 +30,11 @@ A project is always a Rust program built on the engine. ``` ger40-lab/ # your research project — a separate Rust crate (cdylib) -├── Aura.toml # STATIC context only, paths only: data archive root, -│ # runs dir (no logic; instrument geometry is the -│ # recorded sidecar, C15 — never authored here) +├── Aura.toml # STATIC context only, paths only: the runs dir (all +│ # the scaffold emits today), plus a data archive root +│ # once real data enters; no logic — instrument +│ # geometry is the recorded sidecar (C15), never +│ # authored here ├── Cargo.toml # cdylib; depends on aura-core/aura-std (+ shared node crates); │ # carries an empty [workspace] table (see note below) ├── CLAUDE.md # the project's own skills wiring (authoring discipline)