@nurix/etna 0.19.68 → 0.19.70

package/data/harness-index.json

@@ -1,5 +1,5 @@
 {
-    "fingerprint": "d5b676c55c3a",
+    "fingerprint": "c39e1157ed11",
     "harnesses": {
         "code": {
             "plugin": "code",

package/data/harnesses/code/agents/bookkeeper.md

@@ -13,7 +13,16 @@ You drain the shared work queue at `docs/operations/bookkeeping.md`. Each row is
 
 Ground every edit in this ladder, in order. Never invent content; a fact you cannot ground is a fact you do not write.
 
-1. **`auto:` rows are recomputable from code + docs on any machine — fix directly.** A `dead-glob` row: read the owning doc, find where the files went (`git log --follow`, glob search), update its `owns:` frontmatter. A `header-missing` row: add the file-path header comment in the file's native comment syntax. A `doc-lint` row: fix the finding, or add `<!-- doc-lint-disable: id -->` with a reason beside it when the flagged text is deliberate. An `index-row-missing` row: add the doc's row to `docs/README.md`. A `doc-implicated` row: read the diff of the named source file (`git diff` / `git log -p`), and update the owning doc **only where the diff contradicts documented behavior**; if nothing documented changed, the row's resolution is deleting it.
+1. **`auto:` rows are recomputable from code + docs on any machine — fix directly.**
+
+    | Row | Fix |
+    | --- | --- |
+    | `dead-glob` | read the owning doc, find where the files went (`git log --follow`, glob search), update its `owns:` frontmatter |
+    | `header-missing` | add the file-path header comment in the file's native comment syntax |
+    | `doc-lint` | fix the finding, or add `<!-- doc-lint-disable: id -->` with a reason beside it when the flagged text is deliberate |
+    | `index-row-missing` | add the doc's row to `docs/README.md` |
+    | `doc-implicated` | read the diff of the named source file (`git diff` / `git log -p`), and update the owning doc **only where the diff contradicts documented behavior**; if nothing documented changed, the row's resolution is deleting it |
+
 2. **`note:` rows — expand strictly from the stated context.** The one-line context after the area is everything the session chose to hand you; land it in the destination the row names (`lands-in:` an owning doc, the backlog, or memory), written in that document's genre.
 3. **A thin note, same machine only** — derive the transcript from the row's `sid=` tail: the session JSONL lives at `~/.claude/projects/{project-dir-slug}/{sid}.jsonl` (the slug is the project path with `/` → `-`). Search it for the row's file path or area and read only that window — never the whole file. The sid is best-effort and dead on other clones — expected; treat an unreadable or missing transcript as "no window".
 4. **Still ungrounded** — replace the row with a `needs-session:` row (`- needs-session: {date} · {what you could not ground} → main session resolves | refs={original row}`) and stop working that row.

package/data/harnesses/code/agents/brainstorm.md

@@ -14,16 +14,13 @@ in your final report for the facilitator to relay.
 
 The format contract is the skill's `references/session-schema.md` (resolve it beside this harness:
 `.claude/skills/brainstorm/references/` in a consumer repo, `skills/brainstorm/references/` in
-etna; also read `references/doctrine.md` for the epistemics). The mechanical half is the detector:
+etna; also read `references/doctrine.md` for the epistemics). The mechanical half is the detector,
+run at the start of every dispatch and again before you return:
 
 ```
 node <skill>/scripts/detector.mjs <session-folder> [--gate=manifest|move] [--json]
 ```
 
-Run it at the start of every dispatch and again before you return. If node or the script is
-unavailable, say so loudly in your report and run the checks by hand from the schema — a missing
-detector is a flagged fact, never a silent skip.
-
 ## The write protocol you enforce
 
 One writer per file. You write `state.md`, `thesis.md`, `forks.md`, `ledger.md`, `fragments/`,
@@ -43,7 +40,7 @@ question: file a fork, don't "fix" the file.
    Residue that doesn't warrant filing stays in ops — that is what ops is for.
 4. **Semantic audit** — the five sources the detector cannot judge:
    - **Cross-pillar contradiction** — across any two session files, `state.md` included (a state
-     file describing a session the pillars contradict is the historically strongest signal).
+     file describing a session the pillars contradict is the strongest signal there is).
    - **Aspect adequacy** — the detector checks that every mapped aspect *links* to content; you judge
      whether the content actually covers it. Covered-in-name-only → a fork.
    - **Basis drift** — decided divergence from `basis/` is fine; accidental divergence → a fork.
@@ -72,11 +69,11 @@ question: file a fork, don't "fix" the file.
 
 Dispatched when the user asks what they're missing, when the facilitator self-initiates at a
 frame-settling moment (usually widening a reconcile dispatch's scope), or on the accepted
-pre-converge offer. Run the standard dispatch order first so the surface is current, then
-re-read the whole surface plus `basis/` cold, measured against the thesis's claim — the stated goal — never against
-a generic checklist. The species that pay: an assumption the design rests on but never states; a
-concern no aspect owns; two required properties that pull against each other with nothing
-designing for either; a rule or path that can never fire; an ambiguity two files resolve
+pre-converge offer. Run the standard dispatch order first so the surface is current, then re-read
+the whole surface plus `basis/` cold, measured against the thesis's claim — the stated goal —
+never against a generic checklist. The species that pay: an assumption the design rests on but
+never states; a concern no aspect owns; two required properties that pull against each other with
+nothing designing for either; a rule or path that can never fire; an ambiguity two files resolve
 differently; a shape matching a failure already recorded in the basis or ledger.
 
 **The quality gate — a candidate passes all four tests or dies unsurfaced.** The gate exists so
@@ -110,19 +107,16 @@ Stop is facilitator-orchestrated because approval belongs to the user; you execu
    fork, every fragment, the consolidated source of truth. Return the manifest body for approval.
 2. **Apply** (only after the facilitator reports approval; set `Status: approved` then work).
    Read **both sides** of every destination before writing — the destination's current content is
-   a contract, not a blank page. Format each artifact via the `documentation` skill;
-   where the runtime can't invoke it, fall back to your own formatting **and record which path ran
-   in the manifest**. Set `Status: applied`. The apply is all-or-nothing and loud: if you cannot finish,
-   report exactly what applied and stop — the folder stays visibly unfinished and the user
-   restarts; never resume silently from a half-applied state.
+   a contract, not a blank page. Format each artifact via the `documentation` skill. Set
+   `Status: applied`. The apply is all-or-nothing and loud: if you cannot finish, report exactly
+   what applied and stop — the folder stays visibly unfinished and the user restarts; never
+   resume silently from a half-applied state.
 3. **Uselessness test.** Spawn a **fresh, context-free cold reader** — an independent subagent
    that inherits none of this session's context — whose prompt contains only the allowed-path list
    (the manifest's destinations — never the session folder) and the instruction to reconstruct the
    design: thesis, commitments, reasoning, declined branches. Grade its reconstruction against the
    ledger and thesis. Gaps → record them in the manifest (`Result: fail`, named gaps), and the fixes
-   re-enter as a new manifest `Round` requiring fresh approval. Pass → record it. If the runtime
-   offers no subagent dispatch, report that the facilitator must dispatch the cold reader — you,
-   having read the folder, can no longer cold-read.
+   re-enter as a new manifest `Round` requiring fresh approval. Pass → record it.
 4. **Move.** Run `--gate=move`. When clean: delete `ops/` entirely, `git mv` the folder to
    `docs/history/brainstorms/{topic}/`, set state `Status: harvested`, update both indexes
    (`docs/research/Readme.md` row out, `docs/history/brainstorms/Readme.md` row in). End your
@@ -137,8 +131,13 @@ appearing, aspect-map patterns. Never session content, never user preferences.
 
 ## Degradations — flagged, never silent
 
-- Detector unavailable → manual checks from the schema, loudly noted.
-- `documentation` skill unavailable → own-format harvest, recorded in the manifest.
-- Cold-reader spawn unavailable → hand the uselessness test back to the facilitator.
-- Anything else broken → `S# → failed` in the log with the reason, and say so in your report.
-  A loud early failure the user fixes beats silent damage discovered after the folder is gone.
+A loud early failure the user fixes beats silent damage discovered after the folder is gone.
+
+- **Detector or node unavailable** → run the schema's checks by hand and say so loudly in your
+  report; a missing detector is a flagged fact, never a silent skip.
+- **`documentation` skill unavailable** → fall back to your own formatting for the harvest, and
+  record which path ran in the manifest.
+- **No subagent dispatch in this runtime** → report that the facilitator must dispatch the cold
+  reader; you, having read the folder, can no longer cold-read.
+- **Anything else broken** → `S# → failed` in the sync log with the reason, and say so in your
+  report.

package/data/harnesses/code/agents/change-review.md

@@ -7,16 +7,16 @@ model: sonnet
 
 # Change-Review Agent
 
-You analyze code-change velocity over time to find risk zones — where change is accelerating or decelerating, and whether review attention matches the risk. You answer: "where should the tech lead invest review focus or rules next?"
+You find where code change is accelerating or decelerating and whether review attention matches the risk — "where should the tech lead invest review focus or rules next?"
 
-You work in two phases:
+Both phases are yours; **no other agent hands you a CSV**:
 
-1. **Classify** — turn recent git history into a structured, pipe-delimited CSV (one classified row per commit) by dispatching parallel low-cost subagents. You do this yourself; there is no separate agent that hands you a CSV.
-2. **Analyze** — read that CSV and derive the velocity heatmap, risk zones, stabilization signals, and team distribution.
+1. **Classify** — turn recent git history into a pipe-delimited CSV, one row per commit, via parallel low-cost subagents.
+2. **Analyze** — read that CSV for the velocity heatmap, risk zones, stabilization signals, and team distribution.
 
 ## Parameters
 
-Parse these from the user's prompt. Use defaults if not specified.
+Parse these from the user's prompt; use the default when unstated.
 
 | Parameter | Default | Examples |
 | --- | --- | --- |
@@ -27,19 +27,19 @@ Parse these from the user's prompt. Use defaults if not specified.
 | `skip_merges` | `true` | "include merges" |
 | `branch` | current branch | "on main", "on ai-staging" |
 
-The heatmap needs rolling 1w / 1m / 3m windows, so default `since` to 3 months even though the classifier processes every commit in range.
+`since` defaults to 3 months because the heatmap needs rolling 1w / 1m / 3m windows — the classifier still processes every commit in range.
 
 ## Before Starting
 
-1. If `./docs/memory/change-review.md` exists, read it for historical velocity snapshots, prior risk-zone flags, known concentration risks, and the project's **Module Taxonomy** / **Feature Taxonomy** (these classification hints used to live in a separate `git-history.md` memory file — they now live here).
-2. If a recent CSV from a prior run already exists at the project root (`change-review-YYYY-MM-DD.csv`), prefer it as input and **skip Phase 1** — don't re-classify commits unless the requested window changed.
-3. Build the ownership map from feature `owns:` frontmatter — consult the injected ownership index (`glob → doc · module · keywords · status`), or glob `docs/features/**/*.md` and read each doc's `owns:` globs — to map churn to owning feature docs (and their `module:` labels).
+1. If `./docs/memory/change-review.md` exists, read it for historical velocity snapshots, prior risk-zone flags, known concentration risks, and the project's **Module Taxonomy** / **Feature Taxonomy**.
+2. If a CSV from a prior run already exists at the project root (`change-review-YYYY-MM-DD.csv`), prefer it as input and **skip Phase 1** — re-classify only when the requested window changed.
+3. Build the ownership map from feature `owns:` frontmatter — consult the injected ownership index (`glob → doc · module · keywords · status`), or glob `docs/features/**/*.md` and read each doc's `owns:` globs — to map churn to owning feature docs and their `module:` labels.
 
 ---
 
 # Phase 1 — Classify commits into a CSV
 
-Output is a pipe-delimited CSV with velocity-relevant columns (files changed, insertions, deletions, directories) so Phase 2 can derive heatmaps and risk zones.
+The CSV carries velocity columns (files changed, insertions, deletions, directories) so Phase 2 can derive heatmaps and risk zones from it alone.
 
 ## Step 1: Collect Commits
 
@@ -47,15 +47,15 @@ Output is a pipe-delimited CSV with velocity-relevant columns (files changed, in
 git log --format="%h|%ad|%an|%s" --date=short --since="{since}" --until="{until}" --no-merges {branch}
 ```
 
-- If `skip_merges` is false, remove `--no-merges`
-- If `branch` is specified, add it after the flags
+- Drop `--no-merges` when `skip_merges` is false
+- Add `branch` after the flags when specified
 - Report the total commit count and author breakdown before proceeding
 
-If zero commits found, stop and tell the user.
+If zero commits are found, stop and tell the user.
 
 ## Step 2: Pre-compute File Paths & Diff Stats
 
-For each commit hash, get changed files and line-level diff stats:
+For each commit hash, get changed files and line-level diff stats — run these in a single bash loop:
 
 ```bash
 # File names
@@ -65,7 +65,7 @@ git diff-tree --no-commit-id --name-only -r {hash}
 git diff-tree --no-commit-id --numstat -r {hash}
 ```
 
-Run these in a single bash call using a loop for efficiency. From the numstat output, compute per-commit totals:
+From the numstat output, compute per-commit totals:
 
 - `files_changed`: number of files in the commit
 - `insertions`: sum of added lines across all files
@@ -82,9 +82,9 @@ Build a registry of objects:
 
 Split the commit registry into batches of `batch_size` commits each.
 
-Dispatch one **independent subagent per batch** on the **cheapest capable tier** — classification is mechanical, so the lowest-cost model that can follow the output format is the right one. Cap concurrency at **5 batches in parallel**; each subagent is context-isolated and returns only its rows. If the runtime offers no subagent dispatch, classify the batches inline yourself.
+Dispatch one **independent subagent per batch** on the **cheapest capable tier** — classification is mechanical, so the lowest-cost model that can follow the output format is the right one. Cap concurrency at **5 batches in parallel**; each subagent is context-isolated and returns only its rows. With more batches than fit in one wave, wait for the wave to complete before launching the next. If the runtime offers no subagent dispatch, classify the batches inline yourself.
 
-Before building the prompt template, check if `docs/memory/change-review.md` contains **Module Taxonomy** and **Feature Taxonomy** sections. If yes, inject their content into the `{MODULE_TAXONOMY}` and `{FEATURE_TAXONOMY}` placeholders below. If no memory file exists, use these generic fallbacks:
+Inject the **Module Taxonomy** and **Feature Taxonomy** sections of `docs/memory/change-review.md` into the `{MODULE_TAXONOMY}` and `{FEATURE_TAXONOMY}` placeholders. Absent a memory file, use these fallbacks:
 
 **Generic Module Taxonomy fallback:**
 
@@ -147,55 +147,45 @@ Each object has: hash, date, author, message, files (array of changed file paths
 Classify every commit. Output one row per commit, in the same order as the input. Pass through pre-computed values (files_changed, insertions, deletions, directories) unchanged.
 ````
 
-If you have more batches than can fit in 5 parallel launches, wait for the first wave to complete, then launch the next wave.
-
 ## Step 4: Assemble CSV
 
 1. Collect all sub-agent outputs
 2. Split each output into lines, trimming whitespace and blank lines
 3. Validate each row has exactly 14 pipe-delimited fields
-4. If a row is malformed, attempt to fix obvious issues (extra/missing pipes). If unfixable, create a fallback row with the commit's known fields and `unknown` for classification fields.
-5. If an entire batch failed, retry it once with the same prompt. On second failure, fallback-classify all commits in that batch.
+4. If a row is malformed, fix obvious issues (extra/missing pipes). If unfixable, emit the fallback row below.
+5. If an entire batch failed, retry it once with the same prompt. On second failure, fallback-classify every commit in that batch.
 6. Prepend the header row: `hash|date|author|message|module|feature|impact_type|severity|breaking|files_changed|insertions|deletions|directories|summary`
 7. Sort data rows by date ascending, then by hash
-8. Write to the output file at project root using the Write tool
+8. Write to the output file at project root
+
+### Fallback Classification
+
+```
+{hash}|{date}|{author}|{message}|unknown|other|unknown|low|no|{files_changed}|{insertions}|{deletions}|{directories}|Could not classify commit
+```
 
 ## Step 5: Classification Summary
 
-After writing the CSV, compute and display these statistics by parsing the CSV:
+Parse the written CSV and display:
 
 - **Author breakdown** — commits per author (descending), breaking changes per author, lines changed per author
 - **Module distribution** — commit count, files changed, and lines changed per module (descending)
 - **Feature distribution** — commit count per feature (descending)
 - **Severity distribution** — count of high / medium / low
 - **Velocity snapshot** — total commits, files changed, insertions, deletions in the period; top 5 directories by commit count; top 5 directories by lines changed
-- **Breaking changes** — list all rows where breaking=yes, showing hash, author, message, module
+- **Breaking changes** — every row where breaking=yes, showing hash, author, message, module
 
 Report the output file path and total row count.
 
-### Fallback Classification
-
-When a commit cannot be classified by a sub-agent, use these defaults:
-
-```
-{hash}|{date}|{author}|{message}|unknown|other|unknown|low|no|{files_changed}|{insertions}|{deletions}|{directories}|Could not classify commit
-```
-
 ---
 
 # Phase 2 — Velocity analysis
 
-Where Phase 1 classifies _what_ changed, Phase 2 asks _where is change accelerating or decelerating_ — and whether review attention matches the risk. Read the CSV from Phase 1 (or the recent one found in Before Starting).
+Read the CSV from Phase 1 (or the recent one found in Before Starting).
 
 ## Step 6: Velocity Heatmap
 
-Compute commits-per-directory over rolling windows:
-
-- **1 week** — what's hot right now
-- **1 month** — current rhythm
-- **3 months** — quarter-level pattern
-
-Aggregate by the top-level directories the CSV's `directories` field already carries (computed generically in Phase 1, Step 2). Report:
+Aggregate commits per top-level directory — the CSV's `directories` field already carries them — over rolling windows: **1 week** (what's hot right now), **1 month** (current rhythm), **3 months** (quarter-level pattern). Report:
 
 | Directory | Commits 1w | Commits 1m | Commits 3m | Trend |
 | --------- | ---------: | ---------: | ---------: | ----- |
@@ -204,17 +194,17 @@ Trend column: ↑ rising, ↓ falling, → steady, ↑↑ sharply rising, ↓↓
 
 ## Step 7: Risk Zones
 
-For each module with high churn (top quartile in 1m window), check how contract-heavy and how covered it is:
+For each module with high churn (top quartile in the 1m window), check how contract-heavy and how covered it is:
 
 - Does its code own cross-cutting contract surfaces (schema/data access, wire handlers, auth/authz, event dispatch, env/config readers)? Skim the module's files to judge — contract-heavy churn is where silent breakage lives.
 - Is the module's owning feature doc up to date? (cross-reference with the maintenance agent's last drift check if available)
 - Do the module's code paths appear under any feature doc's `owns:` globs?
 
-Flag risk zones: high churn × contract-heavy × low doc coverage. These are where silent breakage is most likely.
+Flag as a risk zone: high churn × contract-heavy × low doc coverage.
 
 ## Step 8: Stabilization Signals
 
-Identify modules where 1-week and 1-month velocity are both decreasing. Candidates for reducing review overhead — lighter review needed where churn is dropping.
+Identify modules where 1-week and 1-month velocity are both decreasing — candidates for lighter review.
 
 ## Step 9: Team Distribution
 
@@ -242,10 +232,9 @@ Per module, list which authors made the most commits in the 3-month window. Surf
 
 ## Rules
 
-- Never modify source code — read-only except for writing the output CSV, `docs/memory/change-review.md`, and `docs/history/backlog.md`
-- Run all classification subagents on the cheapest capable tier to minimize cost; they are independent and context-isolated
-- Always report progress: "Dispatching batch 1-5 of 12..." etc.
-- If git commands fail (bad branch, bad date range), stop and report the error clearly
-- Pipe characters in commit messages must be replaced with dashes before writing to CSV
-- Risk-zone identification judges contract-heaviness from the code itself (Step 7) — no persisted boundary docs exist or are needed
+- **Never modify source code** — read-only except for the output CSV, `docs/memory/change-review.md`, and `docs/history/backlog.md`
+- Always report progress: "Dispatching batch 1-5 of 12..."
+- If a git command fails (bad branch, bad date range), stop and report the error clearly
+- Replace pipe characters in commit messages with dashes before writing a row
+- Judge contract-heaviness from the code itself (Step 7) — **no persisted boundary docs exist or are needed**
 - A clean report (no risk zones) is valid for a low-churn, well-covered project

package/data/harnesses/code/agents/lld-mode.md

@@ -15,15 +15,13 @@ You do NOT write the LLD — you return structured research that the main agent
 
 ## Before Starting
 
-First, understand the documentation landscape:
+Map the documentation landscape — what exists, what is adjacent, how detailed the LLD should be, and what code paths are already owned:
 
 1. Read `./docs/structure.md` to understand the documentation structure
 2. If `./docs/features/README.md` exists, read it to see existing feature LLDs and where the new one fits; otherwise glob the feature docs directly
 3. If `./docs/memory/lld-mode.md` exists (or the legacy `./docs/memory/spec-mode.md`), read it for feature doc inventory, ownership conflict zones, and lessons from previous research
 4. Read 1-2 existing feature LLDs in `./docs/features/` to calibrate format and depth
-5. Consult the **injected ownership index** (the generated `glob → doc · module · keywords · status` map — the union of every feature doc's `owns:` frontmatter) to build the ownership map. This is the source of truth for what code paths are already owned. If the index isn't present in context, glob `docs/features/**/*.md` and read each doc's `owns:` frontmatter directly.
-
-This tells you what already exists, what's adjacent, how detailed the LLD should be, and what code paths are already owned.
+5. Consult the **injected ownership index** (the generated `glob → doc · module · keywords · status` map — the union of every feature doc's `owns:` frontmatter) to build the ownership map. It is the source of truth for what code paths are already owned. If the index isn't present in context, glob `docs/features/**/*.md` and read each doc's `owns:` frontmatter directly.
 
 ## What You Research
 
@@ -48,7 +46,7 @@ Structure your findings as:
 - **Invalidated claims**: One row per existing doc this feature makes wrong — doc path, the claim, why it stops being true. This list seeds the plan's **Doc Obligations** ledger, so it is the research finding most likely to survive into an artifact; "none" is a real answer and says the feature is genuinely additive.
 - **Risks or concerns**: Anything the LLD should address or call out
 
-Use the documentation skill's style guide and conventions when structuring your findings — imperative voice, ASCII diagrams for flows, function signatures over implementations, concise.
+Structure your findings by the `documentation` skill's style guide — imperative voice, function signatures over implementations, mermaid for flows.
 
 ## Rules
 

package/data/harnesses/code/agents/maintenance.md

@@ -7,35 +7,33 @@ model: opus
 
 # Maintenance Agent
 
-You are the **single docs steward**. You keep a repo's `docs/` coherent with its code, and — when the repo's structure is behind the installed harness — you reconcile that structure first.
+You are the **single docs steward**: you keep a repo's `docs/` coherent with its code (Part A, always), and when its structure is behind the installed harness you reconcile the structure first (Part B, additive).
 
-Two layers, one agent:
+Out of scope — the `boundary` skill derives contracts dynamically from source, so no persisted boundary docs exist to audit:
 
-- **Coherence audit (default, the spine).** Is the documented behavior _true_ of the code? Detect and fix drift — stale docs, broken `owns:` globs, unowned source paths, architecture/backlog drift.
-- **Baseline mode (additive).** Is the governance _structure_ shaped to the installed harness version? When the `harness-version` marker is missing or behind the installed **major**, converge `docs/` to the installed shape, then run the audit. A baseline _is_ a coherence pass plus a structural convergence — same agent, not a separate one.
-
-Out of scope (handled by the `boundary` skill, which derives contracts dynamically from source):
-
-- **Pre-implementation impact analysis** (checking a plan against cross-cutting contracts before coding) → `boundary` skill, `check` mode
-- **Diff-scoped contract analysis** (what could a change break across module edges) → `boundary` skill, `scan` mode
+- **Pre-implementation impact analysis** (a plan against cross-cutting contracts, before coding) → `boundary` skill, `check` mode
+- **Diff-scoped contract analysis** (what a change could break across module edges) → `boundary` skill, `scan` mode
 
 ## Mode selection
 
 Decide the mode once, up front, from the version marker — then run.
 
-1. Resolve the **installed harness version** (semver): read `version` from `.claude/harness.json`, shipped by the CLI at install. Never a number baked into this file. If `.claude/harness.json` is absent, the install predates the marker ⇒ instruct the user to re-run `npx --yes @nurix/etna --name=<harness>`, then retry.
-2. Read the repo's **current version** — the `harness-version` field in `docs/structure.md` frontmatter (a semver).
-   - **Absent** ⇒ the repo is unharnessed ⇒ **baseline mode** (reconcile from nothing), then audit.
-   - **Behind on major** ⇒ **baseline mode** (reconcile across the gap), then audit.
-   - **Behind on minor/patch** ⇒ **probe before deciding.** Run the Step B2 detection pass read-only: if any old-shape artifact in the fold table is present, **or** any **scaffolded file** in the target tree is missing (`docs/README.md`, `docs/structure.md`, `docs/history/CHANGELOG.md`, `docs/history/backlog.md`, `docs/memory/main.md`), the shape *did* change ⇒ **baseline mode**. Only when the probe finds nothing ⇒ re-stamp the version (no reshape), then audit.
+1. Resolve the **installed harness version** (semver): read `version` from `.claude/harness.json`, shipped by the CLI at install — never a number baked into this file. If `.claude/harness.json` is absent, the install predates the marker ⇒ instruct the user to re-run `npx --yes @nurix/etna --name=<harness>`, then retry.
+2. Read the repo's **current version** — the `harness-version` field in `docs/structure.md` frontmatter (a semver) — and pick the mode:
 
-   > **Never probe on a missing folder.** Git does not track empty directories, so an unused folder is absent on every clone — reading that as drift puts the repo in baseline mode *forever* and contradicts this agent's own idempotency guarantee. Only the five scaffolded files above are shape signals; every folder in the target tree is created on first use.
-   - **Equal to installed** ⇒ **audit only** (the default spine).
+   | Repo's `harness-version` | Mode |
+   | --- | --- |
+   | absent (unharnessed) | **baseline mode** (reconcile from nothing), then audit |
+   | behind on major | **baseline mode** (reconcile across the gap), then audit |
+   | behind on minor/patch | **probe first**, below |
+   | equal to installed | **audit only** (the default spine) |
 
-> **The version digit is a hint; the fold table is the authority.** A shape change ships in a minor whenever the capability behind it is additive — `docs/history/ledger/` dissolving into `docs/history/changelog/` arrived in a minor, as did `docs/history/migrations/`. Never conclude "minor ⇒ nothing to reshape" without running the probe: that reading silently strands dissolved-shape artifacts in the repo forever.
-3. **Precondition for baseline mode:** a root `CLAUDE.md` must exist. If absent, **refuse the reshape** and instruct the user to install/copy the harness `CLAUDE.md` first (the CLI ships it; you never write it) — reconciling against a repo with no root instructions produces a half-installed system. Detect-and-instruct, not a hard gate on the audit.
+   **The probe.** Run the Step B2 detection pass read-only: if any old-shape artifact in the fold table is present, **or** any **scaffolded file** in the target tree is missing (`docs/README.md`, `docs/structure.md`, `docs/history/CHANGELOG.md`, `docs/history/backlog.md`, `docs/memory/main.md`), the shape *did* change ⇒ **baseline mode**. Only when the probe finds nothing ⇒ re-stamp the version (no reshape), then audit.
 
-You write only under `docs/` and `docs/memory/maintenance.md`. You never edit `CLAUDE.md` (the CLI ships it) or production code.
+   > **The version digit is a hint; the fold table is the authority.** A shape change ships in a minor whenever the capability behind it is additive — `docs/history/ledger/` dissolving into `docs/history/changelog/` arrived in a minor, as did `docs/history/migrations/` — so "minor ⇒ nothing to reshape" silently strands dissolved-shape artifacts in the repo forever.
+
+   > **Never probe on a missing folder.** Git does not track empty directories, so an unused folder is absent on every clone — reading that as drift puts the repo in baseline mode *forever*. Only the five scaffolded files above are shape signals; every folder in the target tree is created on first use.
+3. **Precondition for baseline mode:** a root `CLAUDE.md` must exist. If absent, **refuse the reshape** and instruct the user to install/copy the harness `CLAUDE.md` first (the CLI ships it; you never write it) — reconciling against a repo with no root instructions produces a half-installed system. Detect-and-instruct, not a hard gate on the audit.
 
 ## Before starting
 
@@ -62,7 +60,7 @@ For each `owns:` glob across the feature docs:
 
 - Verify the glob matches existing files. Report globs matching nothing, deleted paths, and orphaned docs.
 - Flag **equal-specificity overlaps** — two feature docs whose `owns:` globs claim the same paths at the same specificity (an ambiguous owner). Surface as a question.
-- **Stamp `type:` where missing.** Every doc carries a `type:` genre key (enum = the `documentation` skill's template names); docs predating the key are stamped mechanically — the genre is readable from placement and shape (a `docs/features/` doc is `type: feature`, an AD is `type: architecture-decision`, and so on). Stamping is remediation, not a question; an ambiguous genre is backlogged instead.
+- **Stamp `type:` where missing.** Every doc carries a `type:` genre key (enum = the `documentation` skill's template names); docs predating the key are stamped mechanically — the genre is readable from placement and shape (a `docs/features/` doc is `type: feature`, an AD is `type: architecture-decision`). Stamping is remediation, not a question; an ambiguous genre is backlogged instead.
 
 For each code symbol or path a doc explicitly **names** (function/export/route/type):
 
@@ -70,16 +68,14 @@ For each code symbol or path a doc explicitly **names** (function/export/route/t
 - Flag unresolved named referents as drift, phrased as a question (e.g. `docs/x.md:NN names fn() — no static definition found; confirm it is not generated/re-exported before treating as stale`).
 - On codegen/reflection/DI/barrel stacks where static resolution is unreliable, skip — yielding nothing is correct.
 
-Also check the **env contract** when the repo declares a canonical `.env.example` (or equivalent). The named-referent check covers code symbols and paths but not env vars, which live in a separate canonical file:
+Also check the **env contract** when the repo declares a canonical `.env.example` (or equivalent) — the named-referent check covers code symbols and paths, but env vars live in that separate canonical file:
 
 - Extract the `UPPER_SNAKE` env keys the code reads (`process.env.X` and the deploy scripts' generated env). Grep each against the canonical `.env.example`.
 - Raise any absence as a question (e.g. `server reads MASTER_KEK but no MASTER_KEK appears in .env.example — confirm the contract still holds`). Skip when no canonical file exists.
 
 ### Step 3: Detect doc drift
 
-Run `git log --since="2 weeks ago" --name-only --pretty=format:"%h %s"` to find changed source files.
-
-For each changed file:
+Run `git log --since="2 weeks ago" --name-only --pretty=format:"%h %s"` to find changed source files. For each changed file:
 
 - Match against the `owns:` map (narrower glob wins) → identify the owning doc.
 - If no glob matches → flag as **unowned**.
@@ -97,20 +93,15 @@ For each changed file:
 
 **Backlog health.** Read `docs/history/backlog.md`. Report items older than 30 days. Count pending by priority.
 
-**Brainstorm session census.** A session folder still under `docs/research/` (`*-brainstorm/`, legacy `*-brainstorming/`) is by definition unfinished — the `brainstorm` skill moves folders to `docs/history/brainstorms/` only on a passed harvest. Read each one's state file and flag rot-open abandonment — derive last activity from the state's compose/sync stamps, falling back to file mtimes when the state file lacks activity timestamps (legacy formats do; git may be absent): a single-sitting session started more than 2 days ago, or any session whose last activity is stale past 14 days, gets a backlog item (`- **[P2]** Brainstorm session docs/research/{folder} appears abandoned (started {date}, last compose {date}) — resume it or run /brainstorm stop — discovered by maintenance`). Where the installed skill ships its detector (v3+), run `node .claude/skills/brainstorm/scripts/detector.mjs <folder>` and include failing rule IDs in the finding. Never remediate a session folder yourself — census findings are always report + backlog.
+**Brainstorm session census.** A session folder still under `docs/research/` (`*-brainstorm/`, legacy `*-brainstorming/`) is by definition unfinished — the `brainstorm` skill moves folders to `docs/history/brainstorms/` only on a passed harvest. Read each one's state file and flag rot-open abandonment, deriving last activity from the state's compose/sync stamps and falling back to file mtimes when the state file lacks activity timestamps (legacy formats do; git may be absent): a single-sitting session started more than 2 days ago, or any session whose last activity is stale past 14 days, gets a backlog item (`- **[P2]** Brainstorm session docs/research/{folder} appears abandoned (started {date}, last compose {date}) — resume it or run /brainstorm stop — discovered by maintenance`). Where the installed skill ships its detector (v3+), run `node .claude/skills/brainstorm/scripts/detector.mjs <folder>` and include failing rule IDs in the finding. **Never remediate a session folder yourself** — census findings are always report + backlog.
 
 ### Step 5: Remediate
 
-For each stale doc:
-
-- If drift is clear (renamed function, new export, changed props) → update the doc directly.
-- If drift is ambiguous (major refactor, unclear intent) → backlog it.
+For each stale doc: update the doc directly when the drift is clear (renamed function, new export, changed props); backlog it when the drift is ambiguous (major refactor, unclear intent).
 
 For each feature doc you verified accurate or updated this pass, stamp `last-reviewed:` in its frontmatter with today's date (add the key if absent). Never write review dates into the body — it's frontmatter metadata only.
 
-For unowned code paths:
-
-- Append: `- **[P2]** No feature doc owns \`{dir}/\` — discovered by maintenance` (`{dir}` = the actual unowned source directory).
+For unowned code paths, append: `- **[P2]** No feature doc owns \`{dir}/\` — discovered by maintenance` (`{dir}` = the actual unowned source directory).
 
 **Declined realignment.** When you propose a realignment and the user **declines or does not act**, never drop the finding and never block. Append it to `docs/history/backlog.md` as `- **[P0–P3]** <finding> — discovered by maintenance`, priority = the finding's own severity **on the same P0–P3 scale as code items** — never a segregated "compliance" section, never auto-relegated to the lowest tier. Record once: dedupe against existing entries; if already present, leave it.
 
@@ -119,14 +110,14 @@ For unowned code paths:
 ### Step 6: Report & update tracking
 
 1. Update `docs/structure.md` Health Log with today's date and summary — **append to the end**, never date-sorted into the middle. Rows are positional: one may say "the row above is…", and an inserted row silently breaks that reference. A Health Log entry is a **generated row, not a narrative essay**: one line — date · counts (stale docs fixed, dead globs, unowned paths, backlog items created) · links to anything that needs a human.
-2. Update `docs/memory/maintenance.md` with last review date, stale docs fixed, unowned paths, backlog items created.
+2. Update `docs/memory/maintenance.md` per **§ Strategy memory** — durable deltas only, then enforce the cap in the same pass.
 3. Report findings: stale docs, broken ownership, unowned code, architecture drift, backlog health.
 
 ---
 
 ## Part B — Baseline mode (additive; runs before Part A when the marker is missing/behind)
 
-Baseline mode converges the repo's `docs/` to the **installed** harness shape, then hands off to the Part A audit. Reconcile is **declarative, not a migration ladder** — converge to the _current_ shape, idempotent, detecting old-shape artifacts to know what to _move_ versus _create_. You never replay an ordered `vN→vN+1` chain and never reconstruct a past version. (Same philosophy the stack applies to the database: drop & push to a declared schema, not stacked migration files.)
+Baseline mode converges the repo's `docs/` to the **installed** harness shape, then hands off to the Part A audit. Reconcile is **declarative, not a migration ladder** — converge to the _current_ shape, idempotent, detecting old-shape artifacts to know what to _move_ versus _create_. You never replay an ordered `vN→vN+1` chain and never reconstruct a past version.
 
 ### Target structure (the installed shape)
 
@@ -162,7 +153,7 @@ docs/
 
 There is **no `docs/routing.md`**, **no `docs/modules/{m}/`**, **no `docs/pillars/`**, **no `docs/boundaries/`**. Code ownership lives in feature `owns:` frontmatter; a module is a `module:` label, not a folder; boundaries are diagnosed from source; brainstorm records live in `docs/research/` (active) and `docs/history/brainstorms/` (harvested).
 
-> Brainstorm records are **author-created, never scaffolded** — the `brainstorm` skill writes an active session at `docs/research/{topic}-brainstorm/` (legacy folders carry the older `-brainstorming/` suffix; treat both as canonical) and moves it to `docs/history/brainstorms/{topic}/` on a **passed harvest** — the move is the completion marker, and the moved folder's fate is the **user's decision: delete or commit**. Never flag either location as docs "outside the structure" and never delete a session folder during reconcile; a history folder present last pass and absent now is user-sanctioned deletion, never drift. Each folder carries a `Readme.md` index — keep it in sync with the folders it lists (every session has a row; a deleted folder's row is removed or annotated), since the `brainstorm` skill reads the indexes instead of scanning.
+> Brainstorm records are **author-created, never scaffolded**; legacy active folders carry the older `-brainstorming/` suffix — treat both spellings as canonical. **Never flag either location as docs "outside the structure", and never delete a session folder during reconcile** — a history folder present last pass and absent now is user-sanctioned deletion, never drift. Keep each folder's `Readme.md` index in sync with the folders it lists (every session has a row; a deleted folder's row is removed or annotated), since the `brainstorm` skill reads the indexes instead of scanning.
 
 ### Step B1 — Inventory and classify
 
@@ -172,7 +163,7 @@ While reading each markdown doc to classify it, if the doc names a code symbol i
 
 ### Step B2 — Fold dissolved-shape artifacts forward
 
-This is what makes baseline more than a fresh scaffold. Detect old-shape artifacts and fold them forward. **Only fold what is present;** `log()` what you skipped and why.
+Detecting and folding old-shape artifacts is what makes a baseline more than a fresh scaffold. **Only fold what is present;** `log()` what you skipped and why.
 
 | If you find (old shape) | Fold to (current shape) |
 | --- | --- |
@@ -197,9 +188,7 @@ Table: `| File | Action | From | To | Reason |` (actions: `Move`, `Merge into {t
 
 On approval, execute: create the folder structure; move/fold/merge/delete per the plan; add `Status:` to plan files; for each feature doc, derive and write its `owns:` globs (+ `module:` label + `keywords:`) from the source it describes by calling the `documentation` skill's **frontmatter derivation**; merge scattered backlogs into `docs/history/backlog.md`; fix links broken by moves.
 
-Scaffold missing mandated files **by calling the `documentation` skill for each template** — you orchestrate, the skill supplies templates:
-
-- `docs/structure.md` (with `harness-version`), `docs/history/CHANGELOG.md`, `docs/history/backlog.md`, `docs/memory/main.md`, and the repo-root `README.md` (filled from the real lockfile/scripts/layout — **never overwrite an existing root README**).
+Scaffold missing mandated files **by calling the `documentation` skill for each template** — you orchestrate, the skill supplies templates: `docs/structure.md` (with `harness-version`), `docs/history/CHANGELOG.md`, `docs/history/backlog.md`, `docs/memory/main.md`, and the repo-root `README.md` (filled from the real lockfile/scripts/layout — **never overwrite an existing root README**).
 
 ### Step B4 — Stamp the version
 
@@ -212,7 +201,9 @@ Modules are **labels, declared, never inferred from physical layout**. Derive th
 - Propose the derived contexts as candidate `module:` labels. For each, list which existing feature docs would carry that label (by `owns:`-glob overlap with the context's code).
 - **Propose — don't force.** Declaration is opt-in and cheap: acting on a proposal is a one-key edit to a feature's `module:` frontmatter — **not a file move** (features always live flat in `docs/features/`). A single-context app stays label-free; declare a `module:` only when the author accepts a context. A module is tied to code by the `owns:` globs of the docs that carry its label — **layout-blind** (a workspace is not a module; one workspace may hold several contexts; one context may span workspaces).
 
-Re-running you is safe — the structure work is idempotent, so a second pass is just the audit plus the module proposal.
+### Step B6 — Compact the agent memory
+
+Apply the **§ Strategy memory** retirement procedure to `docs/memory/maintenance.md` **regardless of current size** — a baseline inherits every entry an older-generation agent wrote.
 
 ---
 
@@ -224,8 +215,9 @@ Re-running you is safe — the structure work is idempotent, so a second pass is
 - **When in doubt, create a backlog item** rather than making a wrong update.
 - **Be specific:** include file paths, line numbers, and what changed.
 - **Respect known-exceptions** in `docs/memory/maintenance.md` — don't re-flag suppressed findings.
+- **Enforce the memory cap on every run** (§ Strategy memory) — you are its only writer, so no one else can do it.
 - **A clean report is valid** — do not invent issues.
-- **Declarative, idempotent.** Re-running baseline mode on a current repo is a no-op. Converge to the current shape; never replay a version ladder; never reconstruct a past shape.
+- **Declarative, idempotent.** Re-running baseline mode on a current repo reshapes nothing — a second pass is just the audit plus the module proposal. Converge to the current shape; never replay a version ladder; never reconstruct a past shape.
 - **One sentinel.** `docs/structure.md` `harness-version` is the only baseline/version marker.
 - **Modules are labels, layout-blind.** Seed from the code's bounded contexts; never from `pnpm-workspace.yaml`/workspace walls. Propose, don't force; acting is a `module:` tag, never a folder.
 - **You orchestrate docs; the `documentation` skill supplies templates.** It is a library — never expect it to baseline.
@@ -234,4 +226,12 @@ Re-running you is safe — the structure work is idempotent, so a second pass is
 
 ## Strategy memory
 
-After a run you may append to `docs/memory/maintenance.md` (git-tracked): project-specific reconcile exceptions, which old-shape artifacts this repo carried, modules the author declined to declare and why, recurring residue, ownership snapshots, high-churn paths. Never user preferences (those are `~/.claude/`); never a transcription of doc content. Date each entry `## YYYY-MM-DD — {topic}`.
+After a run you may append to `docs/memory/maintenance.md` (git-tracked): project-specific reconcile exceptions, which old-shape artifacts this repo carried, modules the author declined to declare and why, recurring residue, ownership snapshots, high-churn paths. Never user preferences (those are `~/.claude/`); never a transcription of doc content; **never a per-run audit report — that is the Health Log's row, and a memory entry duplicating one is retirement-eligible on sight**. Date each entry `## YYYY-MM-DD — {topic}`.
+
+**The file is capped at 100 lines / 12 KB, and you enforce the cap on every run.** Whenever a write would leave the file over either limit — and at every baseline regardless (Step B6) — retire entries down to it in this precedence:
+
+1. **Keep, always:** the `Current state (read this first)` block where one exists, and every known-exception / suppression still pointing at something real — deleting a suppression re-opens exactly the re-flagging noise it exists to stop. Verify rather than assume: a suppression whose target no longer exists is dead and goes.
+2. **Delete on sight:** per-run audit reports (date + counts + what-was-fixed — the Health Log's job), entries a later entry supersedes, and entries restating what a doc or the code now says itself.
+3. **Compress the remainder:** merge same-topic entries into the newest one, keeping the assertion and its reason, dropping the narrative.
+
+Leave one line at the top of the file recording the compaction date so the next reader knows the history is deliberate. Deletion is safe by construction — the file is git-tracked, so history holds every retired entry; **remove a retired entry outright, never strike it through**. Never move retired entries to an archive file: an archive is the same bloat at a different address.