geneseed 3.1.1 → 3.1.3

package/web/dist/assets/{index-Dg58ScBe.js → index-dHi-7M-F.js}

@@ -1,2 +1,2 @@
-import{h as _,j as e,g,I as N,u as w,E as S,L as E,a as T}from"./index-CH_Z725C.js";import{r as p}from"./react-DOpiTn5v.js";import{m as I}from"./marked.esm-JKvyS0Pp.js";const R="geneseed-harness",P=[{id:"opencode",label:"OpenCode"},{id:"claude",label:"Claude Code"}];function A(){return _(R,s=>s==="claude"||s==="opencode"?s:"opencode")}function $(s,n=0){const a=String(s).toLowerCase().trim().replace(/[^a-z0-9\s-]/g,"").replace(/\s+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"");return a&&/^[a-z]/.test(a)?a:`h-${n}-${a||"section"}`}function y(s,n){if(!s||!n)return null;try{return s.querySelector(n)}catch{return null}}function H(s){const n=[];let a=!1,l=0;for(const r of(s||"").split(`
+import{i as _,j as e,g,I as N,u as w,E as S,L as E,a as T}from"./index-DP035wPa.js";import{r as p}from"./react-DOpiTn5v.js";import{m as I}from"./marked.esm-JKvyS0Pp.js";const R="geneseed-harness",P=[{id:"opencode",label:"OpenCode"},{id:"claude",label:"Claude Code"}];function A(){return _(R,s=>s==="claude"||s==="opencode"?s:"opencode")}function $(s,n=0){const a=String(s).toLowerCase().trim().replace(/[^a-z0-9\s-]/g,"").replace(/\s+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"");return a&&/^[a-z]/.test(a)?a:`h-${n}-${a||"section"}`}function y(s,n){if(!s||!n)return null;try{return s.querySelector(n)}catch{return null}}function H(s){const n=[];let a=!1,l=0;for(const r of(s||"").split(`
 `)){if(r.startsWith("```")){a=!a;continue}if(a)continue;const d=r.match(/^(##|###)\s+(.+?)\s*$/);d&&(l+=1,n.push({level:d[1].length,title:d[2],id:$(d[2],l)}))}return n}function M(s,n){const a=new Map((n||[]).map(r=>[r.label,r])),l=(s||"").replace(/\[\[([^\]]+)\]\]/g,(r,d)=>{const i=a.get(d.trim());return i?`[${i.label}](#/item/${i.type}/${encodeURIComponent(i.name)})`:r});return I.parse(l,{breaks:!1})}const q={"opencode-global":"path-a-opencode-global-recommended","opencode-per-repo":"path-b-opencode-per-repo","claude-code":"path-c-claude-code","agent-md":"path-d-any-agentmd-tool",bundle:"path-d-any-agentmd-tool"};function O({page:s,overview:n,onAction:a}){const l=p.useRef(null),r=p.useMemo(()=>H(s.body),[s.body]),d=p.useMemo(()=>M(s.body,s.links),[s.body,s.links]);p.useEffect(()=>{const t=l.current;if(!t)return;let o=0;t.querySelectorAll("h1, h2, h3").forEach(u=>{if(o+=1,!u.id){const x=$(u.textContent||"",o);x&&(u.id=x)}})},[d]),p.useEffect(()=>{const t=l.current;if(!t)return;const o=u=>{const x=u.target.closest("a[href]");if(!x)return;const f=x.getAttribute("href");f&&f.startsWith("#/")&&(u.preventDefault(),g(f))};return t.addEventListener("click",o),()=>t.removeEventListener("click",o)},[d]),p.useEffect(()=>{const t=s.anchor;if(!t)return;const o=y(l.current,`#${CSS.escape(t)}`);o&&o.scrollIntoView({behavior:"smooth",block:"start"})},[d,s.anchor]),p.useEffect(()=>{const t=l.current;if(!t||s.id!=="install-paths")return;t.querySelectorAll(".docs-here").forEach(x=>x.classList.remove("docs-here"));const o=q[n==null?void 0:n.emit];if(!o)return;const u=y(t,`#${CSS.escape(o)}`);u&&u.classList.add("docs-here")},[d,s.id,n==null?void 0:n.emit]);const i=t=>{if(!t)return;const o=y(l.current,`#${CSS.escape(t)}`);o&&o.scrollIntoView({behavior:"smooth",block:"start"})},j=r.length>=3,m=[];return(s.id==="install-paths"||s.id==="install-quick")&&(m.push({label:"Run doctor",action:"doctor"}),m.push({label:"Rebuild",action:"build"})),s.id==="verify"&&m.push({label:"Run doctor",action:"doctor"}),s.id==="self-improve"&&m.push({label:"Open diff",hash:"#/diff"}),s.id==="upgrade"&&m.push({label:"Update",action:"update"}),e.jsxs("div",{className:"detail-doc",children:[e.jsx("h1",{style:{marginTop:0},children:s.title}),s.source&&e.jsx("div",{className:"doc-meta",children:e.jsxs("span",{className:"badge",children:[e.jsx("span",{className:"dot"}),s.source]})}),m.length>0&&e.jsx("div",{className:"row wrap gap-10",style:{margin:"10px 0 14px"},children:m.map(t=>t.hash?e.jsx("a",{className:"btn ghost sm",href:t.hash,children:t.label},t.label):e.jsx("button",{className:"btn ghost sm",onClick:()=>a&&a(t.action),children:t.label},t.label))}),j&&e.jsxs("div",{className:"docs-toc",children:[e.jsx("div",{className:"docs-toc-head",children:"On this page"}),e.jsx("ul",{children:r.map(t=>e.jsx("li",{className:`lvl-${t.level}`,children:e.jsx("a",{href:`#${t.id}`,onClick:o=>{o.preventDefault(),i(t.id)},children:t.title})},t.id))})]}),e.jsx("div",{className:"markdown",ref:l,dangerouslySetInnerHTML:{__html:d}}),s.link&&e.jsx("div",{style:{marginTop:24},children:e.jsx("a",{className:"btn soft sm",href:s.link.hash,children:s.link.label})})]})}const U=1200;function k({a:s,kind:n}){const a=n==="positional"?s.dest:s.names.join(", "),l=[];return s.metavar&&l.push(s.metavar),s.choices&&l.push(`{${s.choices.join("|")}}`),s.default!==null&&s.default!==void 0&&s.default!==""&&!s.is_flag&&l.push(`default: ${s.default}`),s.required&&l.push("required"),e.jsxs("div",{className:"cli-arg",children:[e.jsx("code",{className:"cli-arg-name",children:a}),l.length>0&&e.jsxs("code",{className:"cli-arg-meta",children:[" ",l.join(" · ")]}),s.help&&e.jsx("div",{className:"cli-arg-help",children:s.help})]})}function D({text:s}){const[n,a]=p.useState(!1),l=async()=>{try{await navigator.clipboard.writeText(s),a(!0),setTimeout(()=>a(!1),U)}catch{}};return e.jsxs("button",{className:"btn ghost sm",onClick:l,title:"Copy command",children:[e.jsx(N,{name:n?"spark":"copy"}),n?"Copied":"Copy"]})}function F({cmd:s,prog:n}){const a=[n,s.name];for(const r of s.positionals||[]){const d=(r.metavar||r.dest||"").toUpperCase();a.push(r.required?d:`[${d}]`)}(s.options||[]).length&&a.push("[OPTIONS]");const l=a.join(" ");return e.jsxs("div",{className:"card pad-md mb-12 cli-card",children:[e.jsxs("div",{className:"row wrap between",style:{alignItems:"flex-start"},children:[e.jsxs("div",{className:"stack",style:{gap:4},children:[e.jsx("h3",{style:{margin:0},children:e.jsx("code",{children:s.name})}),s.help&&e.jsx("p",{className:"sub",style:{margin:0},children:s.help})]}),e.jsx(D,{text:`${n} ${s.name}`})]}),e.jsx("pre",{className:"cli-syn",children:l}),(s.positionals||[]).length>0&&e.jsxs("div",{className:"cli-block",children:[e.jsx("div",{className:"cli-block-head",children:"Arguments"}),s.positionals.map(r=>e.jsx(k,{a:r,kind:"positional"},r.dest))]}),(s.options||[]).length>0&&e.jsxs("div",{className:"cli-block",children:[e.jsx("div",{className:"cli-block-head",children:"Options"}),s.options.map(r=>e.jsx(k,{a:r,kind:"option"},r.names.join(",")))]})]})}function G({page:s}){const n=s.prog||"geneseed",a=s.commands||[];return e.jsxs("div",{className:"detail-doc",children:[e.jsx("h1",{style:{marginTop:0},children:s.title}),e.jsxs("p",{className:"sub",style:{marginTop:4},children:["Every subcommand of ",e.jsx("code",{children:n}),". Generated from the parser at request time (the same one ",e.jsx("code",{children:"geneseed"})," actually parses), so this page cannot drift."]}),e.jsx("div",{style:{marginTop:18},children:a.map(l=>e.jsx(F,{cmd:l,prog:n},l.name))})]})}function z({page:s}){const n=s.rows||[],a=s.theme||"neutral";return e.jsxs("div",{className:"detail-doc",children:[e.jsx("h1",{style:{marginTop:0},children:s.title}),e.jsxs("p",{className:"sub",style:{marginTop:4},children:["Geneseed's invented vocabulary, decoded. Left: the neutral, plain-English term. Right: the word your ",e.jsx("code",{style:{textTransform:"capitalize"},children:a})," theme actually uses in the agent's voice."]}),e.jsx("div",{className:"card pad-md",style:{marginTop:18},children:e.jsxs("table",{className:"glossary-table",children:[e.jsx("thead",{children:e.jsxs("tr",{children:[e.jsx("th",{children:"Concept"}),e.jsx("th",{children:"Neutral term"}),e.jsxs("th",{children:["In ",a]}),e.jsx("th",{children:"Meaning"})]})}),e.jsx("tbody",{children:n.map(l=>e.jsxs("tr",{children:[e.jsx("td",{children:e.jsx("strong",{children:l.label})}),e.jsx("td",{children:e.jsx("code",{children:l.neutral||"—"})}),e.jsx("td",{children:e.jsx("code",{children:l.themed||l.neutral||"—"})}),e.jsx("td",{className:"dim",children:l.desc})]},l.label))})]})})]})}function B({page:s}){const n=s.version||{},a=[["Theme",s.theme],["Install mode",s.emit],["Deployed",s.deployed?"yes":"no"],["Target",e.jsx("code",{children:s.target},"t")],["Source root",e.jsx("code",{children:s.root},"r")],["Installed build",e.jsx("code",{children:n.installed_fp||"(none)"},"i")],["Source build",e.jsx("code",{children:n.source_fp||"—"},"s")],["Match?",n.verdict||"—"],["License",s.license]];return e.jsxs("div",{className:"detail-doc",children:[e.jsx("h1",{style:{marginTop:0},children:s.title}),e.jsx("p",{className:"sub",style:{marginTop:4},children:"Live snapshot of the install behind this UI, plus where to go next."}),e.jsx("div",{className:"card pad-md",style:{marginTop:18},children:a.map(([l,r])=>e.jsxs("div",{className:"kv",children:[e.jsx("span",{className:"k",children:l}),e.jsx("span",{className:"v",children:r??"—"})]},l))}),e.jsxs("div",{className:"row wrap gap-10",style:{marginTop:18},children:[e.jsxs("a",{className:"btn ghost",href:s.repo,target:"_blank",rel:"noreferrer",children:[e.jsx(N,{name:"external"}),s.repo_is_github?"GitHub repo":"Source repo"]}),s.repo_is_github&&e.jsxs(e.Fragment,{children:[e.jsxs("a",{className:"btn ghost",href:`${s.repo}/issues`,target:"_blank",rel:"noreferrer",children:[e.jsx(N,{name:"external"}),"File an issue"]}),e.jsxs("a",{className:"btn ghost",href:`${s.repo}/blob/main/LICENSE`,target:"_blank",rel:"noreferrer",children:[e.jsx(N,{name:"external"}),"License"]})]})]})]})}function C(s){var a,l,r;const n=(r=(l=(a=s==null?void 0:s.groups)==null?void 0:a[0])==null?void 0:l.pages)==null?void 0:r[0];return(n==null?void 0:n.id)||""}function V({pageId:s,harness:n,overview:a,onAction:l}){const{data:r,error:d,loading:i}=w(()=>s?T.docsPage(s,n):Promise.resolve(null),[s,n]);if(d)return e.jsx(S,{error:d,style:{margin:18}});if(i||!r)return e.jsx(E,{label:"Loading page…"});switch(r.kind){case"markdown":case"concept":return e.jsx(O,{page:r,overview:a,onAction:l});case"cli":return e.jsx(G,{page:r});case"glossary":return e.jsx(z,{page:r});case"about":return e.jsx(B,{page:r});default:return e.jsxs("div",{className:"empty",children:[e.jsx("div",{className:"big",children:"Unknown page kind"}),r.kind]})}}function Y(s,n){if(!s||!n)return null;for(const a of s.groups)if(a.pages.some(l=>l.id===n))return a;return null}function Q({page:s,query:n,overview:a,onAction:l}){var v;const[r,d]=A(),{data:i,error:j}=w(()=>T.docs(r),[r]),m=s||C(i);p.useEffect(()=>{if(!i||!m)return;if(!i.groups.some(h=>h.pages.some(b=>b.id===m))){const h=C(i);h&&h!==m&&g(`#/docs/${encodeURIComponent(h)}`)}},[i,m]);const t=Y(i,m)||((v=i==null?void 0:i.groups)==null?void 0:v[0]),o=(n||"").toLowerCase().trim(),u=p.useMemo(()=>i?o?i.groups.map(c=>({...c,pages:c.pages.filter(h=>h.title.toLowerCase().includes(o)||c.label.toLowerCase().includes(o)||h.id.toLowerCase().includes(o))})).filter(c=>c.pages.length>0):t?[t]:[]:[],[i,o,t]);if(j)return e.jsx(S,{error:j});const x=(i==null?void 0:i.groups)||[],f=!!o,L=c=>{var b;const h=(b=c.pages[0])==null?void 0:b.id;h&&g(`#/docs/${encodeURIComponent(h)}`)};return e.jsxs(e.Fragment,{children:[e.jsxs("div",{className:"head-row mb-16",children:[e.jsxs("div",{children:[e.jsx("div",{className:"eyebrow",children:"documentation"}),e.jsx("h1",{className:"h",children:"Docs"}),e.jsx("p",{className:"sub",children:"Concept pages, a generated CLI reference, and a glossary. Pages and config that differ by host are filtered to your selected harness."})]}),e.jsx("div",{className:"seg",role:"group","aria-label":"Harness",children:P.map(c=>e.jsx("button",{className:r===c.id?"on":"",onClick:()=>d(c.id),"aria-pressed":r===c.id,children:c.label},c.id))})]}),e.jsx("div",{className:"lib-secbar",children:x.map(c=>e.jsxs("button",{className:`lib-secchip ${(t==null?void 0:t.id)===c.id?"on":""}`,onClick:()=>L(c),children:[e.jsx("span",{children:c.label}),e.jsx("span",{className:"lib-secchip-n",children:c.pages.length})]},c.id))}),e.jsxs("div",{className:"lib lib-2",children:[e.jsxs("div",{className:"card lib-main",children:[e.jsxs("div",{className:"lib-head",children:[e.jsx("span",{className:"lib-head-label",children:o?"all groups":(t==null?void 0:t.label)||""}),e.jsxs("span",{className:"lib-head-count",children:[u.reduce((c,h)=>c+h.pages.length,0)," pages"]})]}),e.jsxs("div",{className:"lib-rows",children:[u.map(c=>e.jsxs("div",{className:"docs-group",children:[f&&e.jsx("div",{className:"docs-group-head",children:c.label}),c.pages.map(h=>e.jsxs("button",{className:`lib-row ${m===h.id?"on":""}`,onClick:()=>g(`#/docs/${encodeURIComponent(h.id)}`),children:[e.jsx("div",{className:"lr-name",children:h.title}),h.date?e.jsx("div",{className:"lr-desc",children:h.date}):null]},h.id))]},c.id)),u.length===0&&i&&e.jsxs("div",{className:"empty",style:{padding:32},children:[e.jsx("div",{className:"big",children:"No matches"}),"Try another search."]}),!i&&e.jsx(E,{label:"Loading docs…"})]})]}),e.jsx("div",{className:"card lib-detail",children:e.jsx(V,{pageId:m,harness:r,overview:a,onAction:l})})]})]})}export{Q as default};

package/web/dist/index.html

@@ -11,9 +11,9 @@
     <!-- The brand sprout as an inline SVG favicon (no extra asset to serve). -->
     <link rel="icon" type="image/svg+xml"
       href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M12 21.5v-9' stroke='%233AD4C4' stroke-width='2' stroke-linecap='round' fill='none'/%3E%3Cpath d='M12 13c0-4.5 3.2-7.5 7.5-7.5 0 4.5-3.2 7.5-7.5 7.5z' fill='%233AD4C4'/%3E%3Cpath d='M12 14.5c0-3.6-2.6-6-6-6 0 3.6 2.6 6 6 6z' fill='%233AD4C4' opacity='.42'/%3E%3C/svg%3E" />
-    <script type="module" crossorigin src="/assets/index-CH_Z725C.js"></script>
+    <script type="module" crossorigin src="/assets/index-DP035wPa.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/react-DOpiTn5v.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-B-mXquBZ.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-Bx3oxZ1o.css">
   </head>
   <body>
     <div id="root"></div>

package/web/src/pages/Laws.jsx

@@ -5,6 +5,7 @@ import { useAsync } from '../hooks/useAsync.js'
 import { romanToInt } from '../lib/roman.js'
 import Loading from '../components/Loading.jsx'
 import ErrorState from '../components/ErrorState.jsx'
+import { LAW_CATS, LAW_CAT_ORDER, PACK_CATS } from '../lib/lawCats.js'
 
 // THE FILENAME AND THE ROUTE STAY `laws`. tests/helpers/cli_golden.mjs hard-requires this path,
 // doctor's lawMetaProblems reads this ONE file out of web/src, and the npm partition ships it
@@ -15,27 +16,12 @@ import ErrorState from '../components/ErrorState.jsx'
 //
 // ⚠ SIX, THOUGH ONLY FOUR HAVE A MEMBER. `context` and `comms` lost theirs when the corpus became
 // nine invariants — that material moved to the ontology and the doctrine packs, neither of which
-// is classed here. The list stays six because it is the VOCABULARY that js/inventory.mjs's
+// is classed here. The list stays six because it is the VOCABULARY that js/inspect/inventory.mjs's
 // LAW_CLASSES publishes and doctor quotes verbatim; the PAGE renders only non-empty facets, which
 // is a display decision and not a change to the taxonomy.
-const LAW_CATS = {
-  security: { label: 'Security', c: 'oklch(0.74 0.085 45)' },
-  verify: { label: 'Verification', c: 'oklch(0.78 0.075 200)' },
-  process: { label: 'Process', c: 'oklch(0.76 0.075 150)' },
-  craft: { label: 'Craft', c: 'oklch(0.78 0.085 95)' },
-  context: { label: 'Context', c: 'oklch(0.74 0.08 280)' },
-  comms: { label: 'Communication', c: 'oklch(0.76 0.085 345)' },
-}
-const LAW_CAT_ORDER = ['security', 'verify', 'process', 'craft', 'context', 'comms']
-
-// A doctrine rule's class IS its pack — there is no second taxonomy over one. Colours only; the
-// pack's NAME and blurb are themed and come from the API, so they are never transcribed here.
-const PACK_CATS = {
-  craft: 'oklch(0.78 0.085 95)',
-  rigor: 'oklch(0.78 0.075 200)',
-  ops: 'oklch(0.76 0.075 150)',
-  process: 'oklch(0.74 0.085 45)',
-}
+// The colour vocabulary moved to lib/lawCats.js when the Journal dashboard's constitution
+// map started painting the same rules — this page cannot be imported from the app shell
+// (it is lazy for a reason) and it cannot move (doctor reads LAW_META out of this path).
 
 // One row per invariant in src/laws/universal.md: its class (fallback for an older server that
 // returns no `klass`) and the one-line principle shown in the table's "Principle" column — display

package/docs/declined.md

@@ -1,200 +0,0 @@
-# Declined divergences
-
-Places where this CLI deliberately does **not** reproduce the Python reference it was ported
-from, with the reason written down. A divergence that is not on this page is a bug; one that is,
-is a decision.
-
-The reference has been deleted, so "the reference does X" is no longer an argument anyone can
-re-run. What is recorded in `tests/__snapshots__/` is the reference's answer, frozen; what is
-listed here is where this implementation answers differently on purpose.
-
-**The recording is smaller than it was.** On **2026-08-17** the emit, cli and web corpora were
-retired — 1381 cells, produced by an implementation that no longer exists and re-recordable by
-nothing, so they reddened on every deliberate content change while saying nothing about a defect
-that happened to be stable. What licensed it was a measurement: all five mutations whose only
-declared gate was a corpus replay are killed by `tests/unit/` alone. `docs/limits.md` carries the
-full argument and what it cost. **The consequence for this page is narrow and worth stating: an
-entry whose "how it stays honest" half named one of those three corpora now names a weaker gate, or
-none.** The help fixtures under `tests/__snapshots__/help/`, which most of this page rests on, are
-untouched.
-
----
-
-## `--help`: the prog is `geneseed`, not `harness`
-
-**Status:** declined (the port's wording is kept), narrow and gated.
-
-**What differs.** The reference opened `usage: harness status` for `status --help`; this CLI
-opens `usage: geneseed status`. The same substitution applies to `bin/geneseed-hook.mjs`, which
-spells itself `geneseed-hook`.
-
-**Why.** `harness` named the Python file this migration deleted. It was not a command anyone
-could type, and now it names nothing at all. This CLI already spells itself `geneseed` in every
-error it prints (`geneseed: error: …`, `bin/geneseed-cli.mjs`'s `die`), so reproducing `harness`
-here would make the help text the only surface still pointing at the old name.
-
-**How it stays honest.** `prog` is an ARGUMENT of `js/cli.mjs`'s `formatHelp`, not a constant.
-`tests/snapshot/cli_help.test.mjs` replays all 26 recorded fixtures through it with the reference's own
-prog and requires them byte for byte. The rename is the only thing that moves, and a separate
-assertion pins the shipped spelling so a renderer that ignored `prog` could not pass both.
-
-That the formatter agrees at every WIDTH — argparse's whole layout: usage assembly, the wrapped
-continuation indent, the two-column help position, the wrap column — was established by a live
-sweep over all 26 verbs at every `COLUMNS` from 20 to 200 while the reference still ran. It
-retired with the reference, and it is the reason the fixtures can be trusted: the 26 are recorded
-at ONE width (`COLUMNS=80`), and at that width two real divergences were invisible — a mutually
-exclusive group emitted as one unsplittable usage part, and `_max_help_position` baked as a
-constant where argparse derives it from the width. Both were found by the sweep and fixed. A
-claim about "the entire layout" that rests on a corpus at one width is a claim about one width,
-so a change to the wrapping arithmetic now needs its own argument rather than a green corpus.
-
-Note that the divergence could not have been applied to a recorded text after the fact: the
-continuation indent of a wrapped usage line is `len('usage: ') + len(prog) + 1`, so four of the
-26 usage blocks re-flow when the prog changes length.
-
----
-
-## `update --help` names `update`, where the reference names `upgrade`
-
-**Status:** reference behaviour, deliberately not reproduced.
-
-**What differs.** The reference printed `usage: harness upgrade [-h] [theme]` for `update --help`
-— the canonical verb, for a command the user spelled `update`. This CLI prints `usage: geneseed
-update`.
-
-**Why.** argparse implements an alias by registering a second key in `_SubParsersAction.choices`
-pointing at the SAME parser object, and `parser.prog` was fixed when that object was built. The
-leaked name is an implementation detail of the reference's alias mechanism, not a statement about
-the CLI. Recorded verbatim in `tests/__snapshots__/help/update.txt` and replayed with the
-reference's prog, so the reference's answer is preserved; the shipped call passes the verb the
-user typed.
-
----
-
-## `link` bakes the interpreter into a written shim, where the Unix arm used to symlink
-
-**Status:** ACCEPTED, both consequences below. This is a change to the PRODUCT, not a port
-divergence — since Task 2b both implementations write the same shim — and it is recorded here
-because this is the page that exists for "what did we decide to live with".
-
-**What changed.** `./geneseed link` used to symlink `ROOT/geneseed` into `~/.local/bin`; the
-launcher then resolved the symlink at RUN TIME and found its own interpreter. It now writes a
-`#!/bin/sh` shim carrying a `# GENESEED_LINK_SHIM` marker that `exec`s the runtime named by
-absolute path (`process.execPath`), mirroring what the Windows arm has always done. The reason it
-moved is in `.superpowers/sdd/progress.md` Task 2b: the two implementations disagreed on four
-cells, and this repo has no deliberate-divergence mechanism, so the reference moved to the port's
-shape rather than the corpus recording a split.
-
-**Consequence 1 — durability.** The baked path can go away. A shim written under `nvm` names
-`~/.nvm/versions/node/v22.x/bin/node`; switch or clean up, and `geneseed` on `PATH` points at a
-runtime that no longer exists. The old symlink survived that, because it deferred the choice to the
-launcher. Accepted: the fix is one `./geneseed link` re-run, the failure is loud and immediate
-(`no such file or directory`), and the Windows arm has carried the same property since it
-shipped. Prefer the old behaviour? A shell function in your rc does exactly that, and SETUP.md
-offers it beside `link`.
-
-**Consequence 2 — which CLI is on `PATH`.** The shim names the implementation that WROTE it, and
-while two implementations existed that decided whether `geneseed tui` and `geneseed menu` opened
-the full-screen panel or refused it. This is now settled rather than a consequence: there is one
-implementation, and the panel it does not carry no longer exists anywhere to be reached. Both
-verbs cross and both refuse the panel by name, stating what this entry does carry (the TUI's
-layout half, not its screens) and offering `setup`, `doctor` and `build` instead. The refusal
-names no file, deliberately — an earlier one pointed at the panel's source, and a pointer to
-something a migration is deleting is worse than a plain statement that the screen is not there.
-
----
-
-## argparse's ERROR wording is not reproduced
-
-**Status:** declined, pre-existing (P5a, P10c), restated here because it is the neighbour of the
-entry above and readers keep finding it separately.
-
-argparse printed a usage block around every parse failure and prefixed it `harness: error:`; both
-entries state the fault on one line prefixed `geneseed: error:` / `geneseed-hook: error:`. See
-`bin/geneseed-cli.mjs`'s `parse` docblock.
-
-**What used to be gated beside it no longer is.** Every error a command's own body raises was in
-the recorded CLI corpus, replayed cell by cell; that corpus was retired on 2026-08-17 and the
-per-verb error texts are now covered only where `tests/unit/` happens to drive the verb. The
-divergence declared here is unchanged — the port has never reproduced argparse's wording and does
-not start now — but the *neighbouring* claim, that the rest of the error surface is pinned byte for
-byte, has expired.
-
----
-
-## Top-level `--help` is still a refusal on the Node entries
-
-**Status:** open, out of scope for Task 10, stated so it is not mistaken for done.
-
-`geneseed --help` with no verb prints
-`geneseed: error: the following arguments are required: cmd (one of …)` on stderr and exits 2,
-where the reference printed the whole parser's help with a subcommand table. Task 10's surface
-was the 26 per-verb help texts and only those are recorded.
-
-Rendering the top-level help needs argparse's `_iter_indented_subactions` path — the subcommand
-choices as a metavar in the usage line, and a nested, differently-indented action list whose
-invocations feed the same `_action_max_length` — which is a distinct piece of the formatter with
-no fixture behind it. Whoever writes it should record it the same way first.
-
----
-
-## `--help` anywhere on the line wins, where argparse would fail on an earlier option
-
-**Status:** declined (the port's behaviour is kept), and the gate that pins it has been corrected
-to stop calling it argparse's rule.
-
-**What differs.** Both Node entries scan the whole argument list for `-h`/`--help` BEFORE parsing
-(`bin/geneseed-cli.mjs`, `bin/geneseed-hook.mjs`), so `geneseed version --target --help` prints
-the help and exits 0. argparse consumes optionals left to right, so `--target` swallows `--help`
-as its value and the reference exits 2 with `argument --target: expected one argument`. Three
-error classes reach it — a missing value, an invalid `type=int` value (`web --port abc -h`), and a
-mutex conflict (`theme --solid-only --transparent-only --help`) — across 19 mandatory-value
-options on 13 verbs, plus `--memory` and `--root` on the hook entry.
-
-**Why declined.** On a malformed command line the two answers are "help, exit 0" and "the error,
-exit 2". Neither takes an action; nothing is written, nothing is destroyed. A scan that stopped at
-the first option expecting a value would have to reproduce argparse's consumption order to be
-right, and that order is the piece of the parser this port deliberately does not carry (see
-argparse's ERROR wording above). Printing help for a line that contains `--help` is the answer a
-user is more likely to have wanted, and it is the same answer for every shape of malformed line.
-
-**How it stays honest.** `tests/snapshot/cli_help.test.mjs`'s `a --help anywhere in the line wins` used to
-docblock this as "argparse's own rule". It is not — that generalised from `diff --nope --help`,
-which works only because an UNKNOWN option is deferred to the end of `parse_known_args`. Two of
-that test's four cases are cases where the reference errors instead, so the test pins a
-divergence; its docblock now says which cases those are and points here.
-
-## A verb that postdates the recorder is exempted from the cell matrix by name
-
-**Status:** ACCEPTED, 2026-08-19. This widens an existing exemption rather than minting a second
-one, and it changes a TEST, not the product.
-
-**What differs.** `tests/unit/hook_cli.test.mjs`'s `the matrix covers every verb each entry
-claims` asserted a strict equality between the hook verbs `tests/helpers/matrix/cli.*.json`
-covers and the verbs `bin/geneseed-hook.mjs` carries. The CLI half of the same test already
-exempted a named `NATIVE` list; the hook half exempted nothing. Both halves now filter through
-the same list.
-
-**Why the recording could not be kept as the whole answer.** The matrix was exported by the
-reference implementation, which was deleted on 2026-08-17 along with every recorder that could
-write a cell. So the covered set is frozen at four hook verbs for good. A fifth hook verb —
-wired in `js/settings.mjs`, carried in `bin/geneseed-hook.mjs`, declared in `js/cli-table.json` —
-would fail this equality with **no green path**: the corpus cannot grow, and the failure message
-correctly forbids deleting cells to pass. The gate had become a wall, and a wall that stops a
-legitimate change is not protection, it is an accident of when the recorder died.
-
-The reason the three CLI verbs were exempted in the first place — *the reference had nothing to
-compare against, and authoring one would be recording a copy of the value under test* — is
-exactly the reason a verb that postdates the reference has no cell. Same reason, same exemption.
-
-**What was lost, measured.** Nothing that another gate does not already hold. The only property
-the frozen hook half carried beyond `NATIVE` was *"a hook verb cannot be removed by a coordinated
-edit of three files"* — and `tests/unit/hook_cli.test.mjs`'s own literal (`sorted(wired)` against
-the four names) plus its `verbsOf(HOOK) === wired` equality are two editable copies of that same
-set, twelve lines above. `tests/mutate.mjs`'s M8 plants the one-file removal and is killed there,
-not here.
-
-**How it stays honest.** The exemption is a NAMED list, not a containment: a new verb has to be
-written into `NATIVE` deliberately, in two files that read each other's source, and the reverse
-check refuses an exemption for a verb neither entry point carries. So the next new verb still
-fails loudly until someone decides about it — which is the whole point of the original design.