geneseed 3.19.0 → 3.20.0

package/CHANGELOG.md

@@ -8,6 +8,12 @@ label. For the capability ↔ spec map, see [SHIPPED.md](SHIPPED.md).
 
 ## [Unreleased]
 
+## [3.20.0] — 2026-10-09
+
+### Changed
+- Loops repair twice before giving up: the test repair rings (`apply-test`, `fix-test`, `write-run`, `stabilise`) now allow two repairs instead of one, then the attempt is discarded for one fresh try, then the loop stops for you. The first revision carries most of the gain, but a second still lands fixes the first missed. Bound the Loop, the `apply` and `test` bricks and the loops concept page say two. Review rings are unchanged.
+- The fallback to the old wiki manifest name (`wiki.jsonc`) stays for now, against the 3.18.0 note that it would go in the next release: nothing yet reports an install that missed the rename, so removing it could drop a wiki in silence.
+
 ## [3.19.0] — 2026-10-09
 
 ### Added

package/SHIPPED.md

@@ -20,7 +20,7 @@ historical references, not files distributed with the repo.
 > **On version numbers.** [`harness.config.json`](harness.config.json)'s `version` is a
 > human-readable label only. The canonical identity of an installed harness is the
 > **source fingerprint** stamped in `.geneseed-version` (see `geneseed version`), not the
-> string. Current label: **3.19.0**.
+> string. Current label: **3.20.0**.
 
 ## Capabilities
 

package/docs/concepts/loops.md

@@ -50,9 +50,10 @@ check) refuses a graph with an undeclared cycle inside an iteration, before a si
 **A ring's `max` is also its own repair budget.** The edge that returns to a ring's first node
 from inside it — `test` → `apply` — is charged to the smallest ring holding both ends, and that
 ring stops at its `max` even when a wider ring raises the node's shared budget. The shipped test
-rings (`apply-test`, `fix-test`, `write-run`, `stabilise`) are `max: 1`: one repair, then the
-attempt is discarded for one fresh try, then the loop stops for you. A second revision makes the
-result worse, not better — 0.82 correct after one, 0.673 after two (arXiv 2607.24604).
+rings (`apply-test`, `fix-test`, `write-run`, `stabilise`) are `max: 2`: two repairs, then the
+attempt is discarded for one fresh try, then the loop stops for you. Most of the gain is in the
+first revision — 0.82 correct after one, 0.673 after two (arXiv 2607.24604) — but a second still
+lands fixes the first missed, so it is kept as the last chance, and nothing past it.
 
 **`error` always stops.** A brick may declare the outcome `error` without an edge for it; the
 engine sends it to `$stop`. The shipped `test` brick reports it when a check crashed or its

package/harness.config.json

@@ -2,5 +2,5 @@
   "_comment": "version is a human-readable release label only; the canonical identity of an installed harness is the source fingerprint stamped in .geneseed-version (see `harness version`), not this string.",
   "theme": "neutral",
   "product": "Geneseed",
-  "version": "3.19.0"
+  "version": "3.20.0"
 }

package/js/build/stubs.mjs

@@ -223,7 +223,8 @@ export function ensureContextStub(out) {
 
 /** The wiki manifest's name. `geneseed-` says who owns it in a shared `.claude/`/`.opencode/`. */
 export const WIKI_FILE = 'geneseed-wiki.jsonc';
-/** Its earlier names, newest first. Readers still fall back to them for one release. */
+/** Its earlier names, newest first. Readers still fall back to them, with no end date:
+ * nothing yet tells a user an install missed the rename, so dropping the fallback would lose a wiki in silence. */
 const LEGACY_WIKI_FILES = ['wiki.jsonc', 'wiki.json'];
 
 /**

package/js/hosts/hooks-context.mjs

@@ -128,7 +128,8 @@ const cost = (s) => s.length + (s.match(/\n/g) || []).length + 2;
 const SESSION_FILES = ['user-rules.md', 'PROFILE.md', 'memory/MEMORY.md', 'anamnesis/MEMORY.md',
   'notebook/NOTEBOOK.md', 'geneseed-wiki.jsonc'];
 // The wiki manifest's earlier name, read when the new one is absent (an install not yet re-emitted,
-// or a rename that failed). One release; `wiki.json`, older still, is the build's to rename.
+// or a rename that failed). Kept until a missed rename is reported somewhere (status), since
+// without it such an install loses its wiki in silence; `wiki.json`, older still, is the build's to rename.
 const LEGACY_WIKI = 'wiki.jsonc';
 // SHA-256 of each seed body in `js/build/stubs.mjs` (`SESSION_SEEDS`), CRLF folded. A file still
 // byte-identical to its seed says nothing, so it is skipped rather than injected as noise.

package/js/loop/state.mjs

@@ -291,8 +291,8 @@ function allowedEntries(graph, v) {
 // The repair ring an edge closes: the smallest non-iteration loop whose FIRST node is the edge's
 // target and which also holds its source (test -> apply is apply-test's repair, review -> apply
 // review-fix's). Its own counter makes `max` the number of repairs that ring may spend, even when
-// a wider ring sharing the node raises the node budget above it — `max: 1` is one repair, then
-// `exhaust`'s fresh attempt, then a stop (arXiv 2607.24604: a second revision lowers accuracy).
+// a wider ring sharing the node raises the node budget above it — `max: 2` is two repairs, then
+// `exhaust`'s fresh attempt, then a stop (arXiv 2607.24604: revisions past the first lower accuracy).
 // Its key lives in `counters`, so every reset of a unit resets it too.
 function repairRing(graph, from, to) {
   const iteration = iterationLoop(graph);

package/js/web/catalog.mjs

@@ -185,7 +185,7 @@ export function notebookItems(state) {
 
 /**
  * The wiki manifest's names, current first. `wiki.jsonc` is the name before the `geneseed-`
- * prefix: the build renames it on the next emit, and until then it is still read — one release.
+ * prefix: the build renames it on the next emit, and until then it is still read (no end date; see `LEGACY_WIKI_FILES`).
  */
 const WIKI_NAMES = ['geneseed-wiki.jsonc', 'wiki.jsonc'];
 const WIKI_META = ['Wiki manifest', 'your machine-wide knowledge base(s)'];

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "Every field here is argued and gated in tests/unit/package_manifest.test.mjs. `files`, `bin` and `engines` each have a test that fails when reality drifts from this file; `version` mirrors harness.config.json and is gated too. Read that docblock before editing this one.",
   "name": "geneseed",
-  "version": "3.19.0",
+  "version": "3.20.0",
   "description": "A portable, theme-able harness you implant once and use everywhere to grow a disciplined AI coding agent.",
   "keywords": [
     "ai",

package/src/bricks/apply.md

@@ -10,7 +10,7 @@ carries an `amend`, that supersedes the original intent — follow the amendment
 replaced.
 
 When this is a repair after `test`, act on the latest `test` note only — it is the verdict on
-the code as it stands. Fix every finding it lists in this one pass: there is no second repair.
+the code as it stands. Fix every finding it lists in this one pass: repairs are capped at two.
 
 Make no unrelated edits: no drive-by rename, no incidental cleanup, no touching a file the card
 did not declare. If the change genuinely needs a file outside the write set, stop and report that

package/src/bricks/test.md

@@ -11,7 +11,7 @@ brick only observes; a fix belongs in `apply`, not here.
 1. **Gate** — the build or compile step. If it fails, mark every check below `SKIPPED (gate
    failed)` and report.
 2. **Focused checks** — the linter and the tests the change can reach. Run every one even after a
-   failure: they check independent properties, and the one repair must see every finding at once.
+   failure: they check independent properties, and each repair must see every finding at once.
 3. **Full suite** — only when everything above passed; otherwise `SKIPPED (an earlier check failed)`.
 
 List every check with `PASS`, `FAIL`, `ERROR` or `SKIPPED (reason)` — one that did not run is

package/src/doctrines/process.md

@@ -114,8 +114,8 @@ legitimate rewrite). The host gates both at the tool boundary.
 Every autonomous loop needs an exit you set before you enter it. Before iterating —
 retrying, searching, generating-and-checking — fix the bounds: a cap on attempts, a
 budget of time or tokens, and an explicit definition of success *and* of failure.
-A check-and-repair loop gets one repair, then a fresh attempt or a hand-back — a second
-revision lowers accuracy. Only a verdict on the final artifact counts: a pass from before
+A check-and-repair loop gets two repairs, then a fresh attempt or a hand-back — more
+revisions cost accuracy. Only a verdict on the final artifact counts: a pass from before
 an edit is void, and old check output is never fed back. Then watch for the loop that has stopped progressing:
 if you are issuing the same call, hitting the same error, or trying variations of one
 approach with no new information, that is not persistence, it is thrashing — break out, change strategy,
@@ -127,7 +127,7 @@ stop itself is a cost without a limit.
 <!-- LEAN:else -->
 Fix an autonomous loop's bounds before you enter it: an attempt cap, a time or token
 budget, an explicit definition of success *and* failure. A check-and-repair loop spends
-one repair, then a fresh attempt or a hand-back; accept only a verdict on the final
+two repairs at most, then a fresh attempt or a hand-back; accept only a verdict on the final
 artifact — a pass from before an edit is void, old check output is never fed back.
 Watch for the loop that has stopped progressing: the same call, the same error, variations with no new information are
 thrashing; break out, change strategy, or stop. When a bound is reached or progress

package/src/loops/api-endpoint.json

@@ -24,7 +24,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "bruno-test", "security-scan", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "bruno-test", "security-scan", "review"], "max": 3 }
   ],
   "contracts": ["**/openapi*.yaml", "**/openapi*.yml", "**/openapi*.json", "**/swagger*.yaml", "**/swagger*.yml", "**/swagger*.json"]

package/src/loops/bugfix.json

@@ -17,7 +17,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ]
 }

package/src/loops/ci-repair.json

@@ -14,6 +14,6 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["ci-triage", "ci-fix", "test"], "max": 10, "iteration": true },
-    { "name": "fix-test", "nodes": ["ci-fix", "test"], "max": 1 }
+    { "name": "fix-test", "nodes": ["ci-fix", "test"], "max": 2 }
   ]
 }

package/src/loops/deps-upgrade.json

@@ -22,7 +22,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["upgrade-scout", "apply", "test", "deps-audit", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "deps-audit", "review"], "max": 3 }
   ],
   "ignoreDeletions": ["**/package-lock.json", "**/yarn.lock", "**/pnpm-lock.yaml", "**/*.lock", "**/gradle.lockfile"]

package/src/loops/enforce-architecture-rule.json

@@ -22,7 +22,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ]
 }

package/src/loops/feature.json

@@ -18,7 +18,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "review", "done-check"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ]
 }

package/src/loops/fix-flaky-tests.json

@@ -24,7 +24,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "flake-check", "test", "review"], "max": 10, "iteration": true },
-    { "name": "stabilise", "nodes": ["apply", "flake-check"], "max": 1 },
+    { "name": "stabilise", "nodes": ["apply", "flake-check"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "flake-check", "test", "review"], "max": 3 }
   ]
 }

package/src/loops/legacy-refactor.json

@@ -19,7 +19,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ],
   "weights": { "logic": 0.6 }

package/src/loops/legacy-tests.json

@@ -22,7 +22,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "characterize", "test", "mutation-check"], "max": 20, "iteration": true },
-    { "name": "write-run", "nodes": ["characterize", "test"], "max": 1 },
+    { "name": "write-run", "nodes": ["characterize", "test"], "max": 2 },
     { "name": "kill-mutants", "nodes": ["characterize", "test", "mutation-check"], "max": 3 }
   ],
   "weights": { "new-file": 0.2 }

package/src/loops/refactor.json

@@ -18,7 +18,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 }
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 }
   ],
   "weights": { "logic": 0.6 }
 }

package/src/loops/remove-dead-code.json

@@ -22,7 +22,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ],
   "weights": { "delete": 0.5 },

package/src/loops/spec-first-feature.json

@@ -23,7 +23,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "review", "done-check"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ]
 }

package/src/loops/tdd.json

@@ -19,7 +19,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "red-test", "apply", "test", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "review"], "max": 3 }
   ]
 }

package/src/loops/update-contract.json

@@ -23,7 +23,7 @@
   ],
   "loops": [
     { "name": "iterations", "nodes": ["identify", "apply", "test", "compat-check", "review"], "max": 20, "iteration": true },
-    { "name": "apply-test", "nodes": ["apply", "test"], "max": 1 },
+    { "name": "apply-test", "nodes": ["apply", "test"], "max": 2 },
     { "name": "review-fix", "nodes": ["apply", "test", "compat-check", "review"], "max": 3 }
   ],
   "contracts": [