geneseed 3.8.0 → 3.10.0

package/src/skills/token-report/scripts/token_report.mjs

@@ -13,9 +13,6 @@
  *                              storage/ JSON files when no DB exists)
  *   openclaude OpenClaude     ~/.openclaude/projects/<slug>/<session>.jsonl exact usage
  *                              (Claude Code fork; $OPENCLAUDE_CONFIG_DIR honoured)
- *   copilot   GitHub Copilot   ~/.copilot/history-session-state/           best effort
- *                              (schema undocumented; token fields harvested
- *                              generically, estimates otherwise)
  *
  * The report distinguishes two kinds of numbers:
  *
@@ -333,18 +330,6 @@ function listDir(p) {
   try { return readdirSync(p).map((n) => path.join(p, n)); } catch { return []; }
 }
 
-/** Every file at any depth under `root` whose basename matches `pred`. */
-function walkFiles(root, pred, out = []) {
-  let entries;
-  try { entries = readdirSync(root, { withFileTypes: true }); } catch { return out; }
-  for (const e of entries) {
-    const full = path.join(root, e.name);
-    if (e.isDirectory()) walkFiles(full, pred, out);
-    else if (pred(e.name)) out.push(full);
-  }
-  return out;
-}
-
 /** Every DIRECTORY at any depth under `root` named `name` — `Path.rglob("<name>")`. */
 function walkDirsNamed(root, name, out = []) {
   let entries;
@@ -905,100 +890,6 @@ function opencodeParse(sid, files) {
   return data;
 }
 
-// ---------------------------------------------------------------------------
-// Host: GitHub Copilot CLI (best effort — schema undocumented)
-// ---------------------------------------------------------------------------
-
-function copilotRoot() {
-  const root = process.env.COPILOT_CONFIG_DIR || path.join(homedir(), '.copilot');
-  for (const sub of ['history-session-state', 'session-state', 'sessions']) {
-    if (isDir(path.join(root, sub))) return path.join(root, sub);
-  }
-  return null;
-}
-
-/** Recursively collect numeric fields whose key mentions tokens. */
-function harvestTokens(obj, sink) {
-  if (isDict(obj)) {
-    for (const [k, v] of Object.entries(obj)) {
-      const lk = k.toLowerCase();
-      // `isinstance(v, (int, float))` — and in Python a BOOL *is* an int, so a
-      // `"hasTokens": true` adds 1. Reproduced rather than tidied away.
-      if ((typeof v === 'number' || typeof v === 'boolean') && lk.includes('token')) {
-        sink.add(lk, typeof v === 'boolean' ? (v ? 1 : 0) : v);
-      } else {
-        harvestTokens(v, sink);
-      }
-    }
-  } else if (Array.isArray(obj)) {
-    for (const v of obj) harvestTokens(v, sink);
-  }
-}
-
-/** Recursively estimate message-ish content by role. */
-function harvestText(obj, sink, depth = 0) {
-  if (depth > 12) return;
-  if (isDict(obj)) {
-    const roleRaw = getOr(obj, 'role', undefined);
-    const role = typeof roleRaw === 'string' ? roleRaw : null;
-    const body = role ? getOr(obj, 'content', undefined) : null;
-    if (role && body !== null && body !== undefined) {
-      const cat = { user: 'User messages', assistant: 'Assistant replies',
-        tool: 'Tool result · (unattributed)' }[role] ?? `${role} messages`;
-      sink.add(cat, textLen(body));
-      return;
-    }
-    for (const v of Object.values(obj)) harvestText(v, sink, depth + 1);
-  } else if (Array.isArray(obj)) {
-    for (const v of obj) harvestText(v, sink, depth + 1);
-  }
-}
-
-function copilotFind(explicit = null) {
-  const root = copilotRoot();
-  if (!root) return null;
-  if (explicit) return existsSync(explicit) ? explicit : null;
-  return newest(listDir(root));
-}
-
-function copilotParse(target) {
-  const data = new SessionData('copilot', path.basename(target));
-  // `rglob("*.json*")` — the basename must CONTAIN ".json", so .json and .jsonl both
-  // match and so does anything after them.
-  const files = isDir(target)
-    ? walkFiles(target, (n) => n.includes('.json')).sort(comparePaths)
-    : [target];
-  const tokens = new Counter();
-  for (const f of files.slice(0, 500)) {
-    const text = readTextMaybe(f);
-    if (text === null) continue;
-    const docs = [];
-    if (path.extname(f) === '.jsonl') {
-      for (const line of pySplitLines(text)) {
-        const d = loadJsonMaybe(line);
-        if (d !== undefined) docs.push(d);
-      }
-    } else {
-      const d = loadJsonMaybe(text);
-      if (d !== undefined) docs.push(d);
-    }
-    for (const doc of docs) {
-      harvestTokens(doc, tokens);
-      harvestText(doc, data.cats);
-    }
-  }
-  if (tokens.size) {
-    data.notes.push('Copilot session state is undocumented; token-like fields '
-      + 'found (summed, field names as stored): '
-      + tokens.entries().sort((a, b) => pyStrCmp(a[0], b[0]))
-        .map(([k, v]) => `${k}=${fmt(v)}`).join(', '));
-  } else {
-    data.notes.push('Copilot records no recognisable token counts in its session '
-      + 'state — the report below is character-count estimates only.');
-  }
-  return data;
-}
-
 /**
  * `str.splitlines()` — copy of the rule the generator settles once: Python splits
  * on a dozen characters JS's `\n` split does not, and drops a trailing empty field.
@@ -1022,7 +913,6 @@ async function detect(hostArg, transcript, session) {
     bob: () => claudeShapedFind('bob', transcript),
     openclaude: () => claudeShapedFind('openclaude', transcript),
     opencode: () => opencodeFind(session),
-    copilot: () => copilotFind(transcript),
   };
   if (hostArg) {
     const found = await finders[hostArg]();
@@ -1046,25 +936,21 @@ async function detect(hostArg, transcript, session) {
   }
   if (!best) {
     sysExit('error: no session data found for any supported host '
-      + '(claude, bob, openclaude, opencode, copilot)');
+      + '(claude, bob, openclaude, opencode)');
   }
   return [best[0], best[1]];
 }
 
 async function load(host, found) {
   if (['claude', 'bob', 'openclaude'].includes(host)) return claudeShapedParse(host, found);
-  if (host === 'opencode') {
-    const [kind, payload] = found;
-    if (kind === 'db') return opencodeDbParse(...payload);
-    if (kind === 'nosqlite') return nosqliteData(...payload);
-    return opencodeParse(...payload);
-  }
-  return copilotParse(found);
+  const [kind, payload] = found;
+  if (kind === 'db') return opencodeDbParse(...payload);
+  if (kind === 'nosqlite') return nosqliteData(...payload);
+  return opencodeParse(...payload);
 }
 
 const HOST_NAMES = {
   claude: 'Claude Code', bob: 'IBM Bob', openclaude: 'OpenClaude', opencode: 'OpenCode',
-  copilot: 'GitHub Copilot',
 };
 
 function render(d, limit, topN) {
@@ -1195,11 +1081,11 @@ function render(d, limit, topN) {
 // ---------------------------------------------------------------------------
 
 const PROG = path.basename(process.argv[1] ?? 'token_report.mjs');
-const HOST_CHOICES = ['claude', 'bob', 'openclaude', 'opencode', 'copilot'];
+const HOST_CHOICES = ['claude', 'bob', 'openclaude', 'opencode'];
 const OPTIONS = [
   ['-h, --help', 'show this help message and exit'],
   [`--host {${HOST_CHOICES.join(',')}}`, 'force a host instead of auto-detecting by recency'],
-  ['--transcript TRANSCRIPT', 'explicit transcript path (claude/bob/openclaude/copilot)'],
+  ['--transcript TRANSCRIPT', 'explicit transcript path (claude/bob/openclaude)'],
   ['--session SESSION', 'explicit session id (opencode)'],
   ['--limit LIMIT', 'context window limit for % columns (default 200000)'],
   ['--top TOP', 'how many heaviest single items to list (default 5)'],

package/src/skills/wiki.md

@@ -15,23 +15,23 @@ machine. Each declared wiki gives you its root `path`, its `entries`, a
 
 **Consult** (reading):
 1. Start from the wiki's `entries` — the eager ones are already in context;
-   open lazy ones only when the task needs them ({{DOCTRINE}} process 3).
+   open lazy ones only when the task needs them ({{DOCTRINE:context-economy}}).
 2. Navigate by the wiki's own structure: follow wikilinks (`[[Note Name]]`)
    and index notes outward from the entry points rather than globbing the
    whole vault. A targeted filename/heading search is fine; reading the tree
    end-to-end is not.
 3. Treat what you read as the user's knowledge, current as of when it was
    written — verify a fact against the live system before building on it
-   (universal {{LAW}} III).
+   ({{LAW:verify-before-asserting}}).
 
 **Capture** (writing):
 1. **Read the wiki's `conventions` note before your first write** in that
    wiki, and follow it over your own habits — naming, frontmatter, folder
    rules, tag style. Re-skim it if it changed since you last wrote.
 2. Quality bar: durable, reusable, cross-project knowledge — not session
-   detail, not task state, and **never secrets** (universal {{LAW}} I).
+   detail, not task state, and **never secrets** ({{LAW:sealed-secrets}}).
    Knowledge that matters only to you belongs in {{MEMORY}}, not the wiki.
-3. Search before creating ({{DOCTRINE}} craft 4): if a note on the topic
+3. Search before creating ({{DOCTRINE:search-before-creating}}): if a note on the topic
    exists, extend or correct it instead of writing a duplicate.
 4. Write the note as a citizen of the graph: wikilinks to the notes it
    relates to (an orphan note is a lost note), frontmatter where the house
@@ -41,7 +41,7 @@ machine. Each declared wiki gives you its root `path`, its `entries`, a
    costs more than an unfiled one.
 6. **Never write under a `protected` folder**, and never restructure the
    wiki itself — moving, renaming, or deleting notes you did not create is
-   the user's call (universal {{LAW}} IV).
+   the user's call ({{LAW:deletion-is-deliberate}}).
 
 **Promote.** When a {{MEMORY}} fact or {{NOTEBOOK}} note hardens into
 knowledge the user would want across projects, capture it into the wiki via

package/src/skills/workflow.md

@@ -23,7 +23,7 @@ work is worth a crew: a one-file tweak or a question never is.
 |---|---|---|---|
 | OpenCode | `workflow` (the `geneseed-workflow` plugin) | **saved only** — `<name>.js` in `.opencode/workflows/` per repo or `<config>/workflows/` global (`GENESEED_WORKFLOWS_DIR` overrides); nothing inline is eval'd | none — call it when the shape fits |
 | Claude Code | `Workflow` (native) | a saved `.claude/workflows/<name>` by `name`, **or** an inline `script` you author | **required** — the tool refuses unless the user opted in for this task ("use a workflow", "ultracode", a skill that says so) |
-| Bob, Copilot, OpenClaude | none | — | fall back to [parallel-agents](parallel-agents.md) / [council](council.md) |
+| Bob, OpenClaude | none | — | fall back to [parallel-agents](parallel-agents.md) / [council](council.md) |
 | any, under Orca | Orca orchestration (`orca skills get orchestration`) | tasks, not scripts — each task spec names its target, change, ownership and acceptance | the user asked to supervise or coordinate workers |
 
 Both runtimes speak the same primitives — `agent()`, `parallel()`, `pipeline()`,
@@ -59,8 +59,7 @@ carries the script API — load it before writing one).
    before; an inline one has not. Author inline only when no saved shape fits, keep it
    to the primitives, and hold to the host's size guideline unless the user asked for
    more.
-4. **Give every editing agent a write set, and isolate parallel editors** ({{DOCTRINE}}
-   process 7). Name in each editing `agent()` prompt the files it may change and have it
+4. **Give every editing agent a write set, and isolate parallel editors** ({{DOCTRINE:one-writer-per-file}}). Name in each editing `agent()` prompt the files it may change and have it
    return the files it did change; overlapping sets run in sequence, not in one
    `parallel()`. Pass `isolation: 'worktree'` to each agent that edits in parallel — both
    runtimes take it; read-only agents need none. After the fan-out, compare the changed
@@ -81,7 +80,7 @@ carries the script API — load it before writing one).
    is a finding about the task, not a reason to loop.
 8. **Exit — carry the conclusion yourself.** The workflow gathers and verifies;
    committing, pushing, merging, or opening anything outward stays with you
-   ({{DOCTRINE}} process 5, {{LAW}} IV). State what the run concluded, what you are
+   ({{DOCTRINE:consent-before-push}}, {{LAW:deletion-is-deliberate}}). State what the run concluded, what you are
    doing with it, and where the trace lives.
 
 ## Done when

package/src/skills/worktree.md

@@ -10,7 +10,7 @@ or rewrite needs a disposable copy, or the user says "worktree", "isolate this",
 changes you did not make.
 
 ## Procedure
-1. **Look before you branch** ({{LAW}} III). `git status` and `git worktree list`
+1. **Look before you branch** ({{LAW:verify-before-asserting}}). `git status` and `git worktree list`
    first. Uncommitted changes you did not author mean someone else owns this tree —
    never `checkout -b` from it (that moves *their* HEAD onto your branch) and never
    stash or revert it. Note the branch they are on; you will not touch it.
@@ -23,7 +23,7 @@ changes you did not make.
    branch so `git worktree list` reads as a task list.
 3. **Make it runnable.** A worktree shares the repository, not the untracked files:
    install dependencies (`npm ci`, the project's equivalent) or link the ones that are
-   large and pure; copy no `.env` — secrets are the user's to place ({{LAW}} I). Run
+   large and pure; copy no `.env` — secrets are the user's to place ({{LAW:sealed-secrets}}). Run
    the project's checks once in the new tree and read the output before changing
    anything, so a later red is yours.
 4. **Work only in the worktree.** Every edit, test, commit and `doctor`/lint run
@@ -33,10 +33,10 @@ changes you did not make.
    the repo through it; verify with the tool's own status command rather than assume.
 5. **Integrate through the normal gate** — commit via the [commit {{SKILL}}](commit.md),
    ship via [ship](ship.md). A worktree earns no exemption from per-commit and
-   per-push consent ({{DOCTRINE}} process 5). Expect conflicts with a sibling tree that
+   per-push consent ({{DOCTRINE:consent-before-push}}). Expect conflicts with a sibling tree that
    touched the same files; resolve them on the branch, not in the other tree.
 6. **Clean up when the branch is merged or abandoned** — with consent, since removal
-   is deletion ({{LAW}} IV):
+   is deletion ({{LAW:deletion-is-deliberate}}):
    ```
    git worktree remove ../<repo>-<slug>
    git branch -d <type>/<slug>

package/themes/_TEMPLATE.json

@@ -75,50 +75,48 @@
   "DESC_PROFILE": "<one-line description: interview the user and draft or refresh PROFILE.md — who they are, how they work, how they like answers pitched; identity only, rules go to user-rules.md>",
   "DESC_GENESEED": "<one-line description: operate the deployed Geneseed harness — find installs and their settings, read files, status, doctor, diff, rebuild one setting on request>",
   "DESC_REVIEW_RESPONSE": "<one-line description: respond to review feedback — verify each point, apply or decline with reasons>",
-  "LEX_I": "<themed title for Law I (Sealed Secrets)>",
-  "LEX_II": "<themed title for Law II (One Intent, One Act)>",
-  "LEX_III": "<themed title for Law III (Verify Before Asserting)>",
-  "LEX_IV": "<themed title for Law IV (Deletion Is Deliberate)>",
-  "LEX_V": "<themed title for Law V (Surface Failures)>",
-  "LEX_VI": "<themed title for Law VI (Data, Not Orders)>",
-  "LEX_VII": "<themed title for Law VII (Least Privilege)>",
-  "LEX_VIII": "<themed title for Law VIII (Cure the Cause)>",
-  "LEX_IX": "<themed title for the retired Law IX (External Gate), ending in (retired)>",
-  "LEX_X": "<themed title for Law X (Echo the Intent)>",
-  "LEX_XI": "<themed title for the retired Law XI (Absence Is a Claim), ending in (retired)>",
+  "LEX_SEALED_SECRETS": "<themed title for the law Sealed Secrets>",
+  "LEX_ONE_INTENT_ONE_ACT": "<themed title for the law One Intent, One Act>",
+  "LEX_VERIFY_BEFORE_ASSERTING": "<themed title for the law Verify Before Asserting>",
+  "LEX_DELETION_IS_DELIBERATE": "<themed title for the law Deletion Is Deliberate>",
+  "LEX_SURFACE_FAILURES": "<themed title for the law Surface Failures>",
+  "LEX_DATA_NOT_ORDERS": "<themed title for the law Data, Not Orders>",
+  "LEX_LEAST_PRIVILEGE": "<themed title for the law Least Privilege>",
+  "LEX_CURE_THE_CAUSE": "<themed title for the law Cure the Cause>",
+  "LEX_ECHO_THE_INTENT": "<themed title for the law Echo the Intent>",
   "PACK_CRAFT": "<display name of the craft doctrine pack — how code is written>",
   "PACK_RIGOR": "<display name of the rigor doctrine pack — how work is proven>",
   "PACK_OPS": "<display name of the ops doctrine pack — how the machine is driven>",
   "PACK_PROCESS": "<display name of the process doctrine pack — how a session runs>",
   "PACK_COMMS": "<display name of the comms doctrine pack — how answers are presented>",
-  "DOC_CRAFT_1": "<themed title for craft doctrine 1 (Automate Repetition)>",
-  "DOC_CRAFT_2": "<themed title for craft doctrine 2 (English Configuration)>",
-  "DOC_CRAFT_3": "<themed title for craft doctrine 3 (Documentation in Step)>",
-  "DOC_CRAFT_4": "<themed title for craft doctrine 4 (Search Before Creating)>",
-  "DOC_CRAFT_5": "<themed title for craft doctrine 5 (Respect Conventions)>",
-  "DOC_CRAFT_6": "<themed title for craft doctrine 6 (Smallest Viable Diff)>",
-  "DOC_CRAFT_7": "<themed title for craft doctrine 7 (One Writer Per Value)>",
-  "DOC_RIGOR_1": "<themed title for rigor doctrine 1 (Idempotent by Default)>",
-  "DOC_RIGOR_2": "<themed title for rigor doctrine 2 (Honest Tests)>",
-  "DOC_RIGOR_3": "<themed title for rigor doctrine 3 (Cover and Verify)>",
-  "DOC_RIGOR_4": "<themed title for rigor doctrine 4 (Prove the Gate)>",
-  "DOC_RIGOR_5": "<themed title for rigor doctrine 5 (External Gate — the gate you build stands outside the mind it governs)>",
-  "DOC_OPS_1": "<themed title for ops doctrine 1 (Tool Discovery)>",
-  "DOC_OPS_2": "<themed title for ops doctrine 2 (Commands Must Return)>",
-  "DOC_OPS_3": "<themed title for ops doctrine 3 (Edit the Source, Not the Surface)>",
-  "DOC_OPS_4": "<themed title for ops doctrine 4 (Complete the Teardown)>",
-  "DOC_OPS_5": "<themed title for ops doctrine 5 (Record the Probe, Not the Snapshot)>",
-  "DOC_OPS_6": "<themed title for ops doctrine 6 (Restart Is Not Reload)>",
-  "DOC_OPS_7": "<themed title for ops doctrine 7 (Serialize Against a Rationed Resource)>",
-  "DOC_PROCESS_1": "<themed title for process doctrine 1 (Persist Insight)>",
-  "DOC_PROCESS_2": "<themed title for process doctrine 2 (Plan Before Acting)>",
-  "DOC_PROCESS_3": "<themed title for process doctrine 3 (Context Economy)>",
-  "DOC_PROCESS_4": "<themed title for process doctrine 4 (Read the Docs First)>",
-  "DOC_PROCESS_5": "<themed title for process doctrine 5 (Consent Before Push)>",
-  "DOC_PROCESS_6": "<themed title for process doctrine 6 (Bound the Loop)>",
-  "DOC_PROCESS_7": "<themed title for process doctrine 7 (One Writer Per File)>",
-  "DOC_COMMS_1": "<themed title for comms doctrine 1 (Codes That Persist)>",
-  "DOC_COMMS_2": "<themed title for comms doctrine 2 (Structure Beside Prose)>",
+  "DOC_AUTOMATE_REPETITION": "<themed title for the craft rule Automate Repetition>",
+  "DOC_ENGLISH_CONFIGURATION": "<themed title for the craft rule English Configuration>",
+  "DOC_DOCUMENTATION_IN_STEP": "<themed title for the craft rule Documentation in Step>",
+  "DOC_SEARCH_BEFORE_CREATING": "<themed title for the craft rule Search Before Creating>",
+  "DOC_RESPECT_CONVENTIONS": "<themed title for the craft rule Respect Conventions>",
+  "DOC_SMALLEST_VIABLE_DIFF": "<themed title for the craft rule Smallest Viable Diff>",
+  "DOC_ONE_WRITER_PER_VALUE": "<themed title for the craft rule One Writer Per Value>",
+  "DOC_IDEMPOTENT_BY_DEFAULT": "<themed title for the rigor rule Idempotent by Default>",
+  "DOC_HONEST_TESTS": "<themed title for the rigor rule Honest Tests>",
+  "DOC_COVER_AND_VERIFY": "<themed title for the rigor rule Cover and Verify>",
+  "DOC_PROVE_THE_GATE": "<themed title for the rigor rule Prove the Gate>",
+  "DOC_EXTERNAL_GATE": "<themed title for the rigor rule External Gate — the gate you build stands outside the mind it governs>",
+  "DOC_TOOL_DISCOVERY": "<themed title for the ops rule Tool Discovery>",
+  "DOC_COMMANDS_MUST_RETURN": "<themed title for the ops rule Commands Must Return>",
+  "DOC_EDIT_THE_SOURCE_NOT_THE_SURFACE": "<themed title for the ops rule Edit the Source, Not the Surface>",
+  "DOC_COMPLETE_THE_TEARDOWN": "<themed title for the ops rule Complete the Teardown>",
+  "DOC_RECORD_THE_PROBE_NOT_THE_SNAPSHOT": "<themed title for the ops rule Record the Probe, Not the Snapshot>",
+  "DOC_RESTART_IS_NOT_RELOAD": "<themed title for the ops rule Restart Is Not Reload>",
+  "DOC_SERIALIZE_AGAINST_A_RATIONED_RESOURCE": "<themed title for the ops rule Serialize Against a Rationed Resource>",
+  "DOC_PERSIST_INSIGHT": "<themed title for the process rule Persist Insight>",
+  "DOC_PLAN_BEFORE_ACTING": "<themed title for the process rule Plan Before Acting>",
+  "DOC_CONTEXT_ECONOMY": "<themed title for the process rule Context Economy>",
+  "DOC_READ_THE_DOCS_FIRST": "<themed title for the process rule Read the Docs First>",
+  "DOC_CONSENT_BEFORE_PUSH": "<themed title for the process rule Consent Before Push>",
+  "DOC_BOUND_THE_LOOP": "<themed title for the process rule Bound the Loop>",
+  "DOC_ONE_WRITER_PER_FILE": "<themed title for the process rule One Writer Per File>",
+  "DOC_CODES_THAT_PERSIST": "<themed title for the comms rule Codes That Persist>",
+  "DOC_STRUCTURE_BESIDE_PROSE": "<themed title for the comms rule Structure Beside Prose>",
   "INTRO_DOC": "<themed intro: this file is the entry point an AI agent reads in this repo>",
   "INTRO_AGENTS": "<themed intro to the Agents section — delegate focused work to a specialist>",
   "INTRO_SKILLS": "<themed intro to the Skills section — run the written procedure before improvising>",

package/themes/biker.json

@@ -75,50 +75,48 @@
   "DESC_PROFILE": "Stamp the rider's plate into PROFILE.md — who they are, what they ride, how they like the road called; identity only, club rules bolt into user-rules.md.",
   "DESC_GENESEED": "Operate the deployed Geneseed harness — find each install and its settings, read its files, run status, doctor and diff, and rebuild it with one setting changed when the user asks.",
   "DESC_REVIEW_RESPONSE": "Take the notes straight — weigh each call, then act on it or push back with reasons.",
-  "LEX_I": "Keep It in the Saddlebag · Sealed Secrets",
-  "LEX_II": "One Move per Corner · One Intent, One Act",
-  "LEX_III": "Check the Mirrors · Verify Before Asserting",
-  "LEX_IV": "Brake Before You Cut · Deletion Is Deliberate",
-  "LEX_V": "Call the Hazard · Surface Failures",
-  "LEX_VI": "Roadside Talk Ain't Orders · Data, Not Orders",
-  "LEX_VII": "Only the Gear You'll Use · Least Privilege",
-  "LEX_VIII": "Fix the Engine, Not the Gauge · Cure the Cause",
-  "LEX_IX": "Someone Else Holds the Key · External Gate (retired)",
-  "LEX_X": "Say the Route Back · Echo the Intent",
-  "LEX_XI": "An Empty Road Ain't Proof · Absence Is a Claim (retired)",
+  "LEX_SEALED_SECRETS": "Keep It in the Saddlebag · Sealed Secrets",
+  "LEX_ONE_INTENT_ONE_ACT": "One Move per Corner · One Intent, One Act",
+  "LEX_VERIFY_BEFORE_ASSERTING": "Check the Mirrors · Verify Before Asserting",
+  "LEX_DELETION_IS_DELIBERATE": "Brake Before You Cut · Deletion Is Deliberate",
+  "LEX_SURFACE_FAILURES": "Call the Hazard · Surface Failures",
+  "LEX_DATA_NOT_ORDERS": "Roadside Talk Ain't Orders · Data, Not Orders",
+  "LEX_LEAST_PRIVILEGE": "Only the Gear You'll Use · Least Privilege",
+  "LEX_CURE_THE_CAUSE": "Fix the Engine, Not the Gauge · Cure the Cause",
+  "LEX_ECHO_THE_INTENT": "Say the Route Back · Echo the Intent",
   "PACK_CRAFT": "Wrenching",
   "PACK_RIGOR": "Shakedown",
   "PACK_OPS": "Throttle",
   "PACK_PROCESS": "The Ride",
   "PACK_COMMS": "Hand Signals",
-  "DOC_CRAFT_1": "Let the Cruise Control Do It · Automate Repetition",
-  "DOC_CRAFT_2": "Notes in English · English Configuration",
-  "DOC_CRAFT_3": "Roadbook in Sync · Documentation in Step",
-  "DOC_CRAFT_4": "Scout the Road First · Search Before Creating",
-  "DOC_CRAFT_5": "Hold Your Line · Respect Conventions",
-  "DOC_CRAFT_6": "Tighten the One Bolt · Smallest Viable Diff",
-  "DOC_CRAFT_7": "One Logbook for the Mileage · One Writer Per Value",
-  "DOC_RIGOR_1": "Safe to Kickstart Twice · Idempotent by Default",
-  "DOC_RIGOR_2": "Test the Ride, Not the Wiring · Honest Tests",
-  "DOC_RIGOR_3": "Ride It Before You Park It · Cover and Verify",
-  "DOC_RIGOR_4": "A Bolt You Never Torqued Ain't Tight · Prove the Gate",
-  "DOC_RIGOR_5": "Someone Else Holds the Key · External Gate",
-  "DOC_OPS_1": "Check Your Gear · Tool Discovery",
-  "DOC_OPS_2": "No Engine Left Idling · Commands Must Return",
-  "DOC_OPS_3": "Wrench the Engine, Not the Paint · Edit the Source, Not the Surface",
-  "DOC_OPS_4": "Strip It Down to the Frame · Complete the Teardown",
-  "DOC_OPS_5": "Trust the Live Gauge, Not the Old Sticker · Record the Probe, Not the Snapshot",
-  "DOC_OPS_6": "Kicking It Over Won't Reset the Jets · Restart Is Not Reload",
-  "DOC_OPS_7": "Single File Through the Toll · Serialize Against a Rationed Resource",
-  "DOC_PROCESS_1": "Write the Roadbook · Persist Insight",
-  "DOC_PROCESS_2": "Map the Route · Plan Before Acting",
-  "DOC_PROCESS_3": "Pack Light · Context Economy",
-  "DOC_PROCESS_4": "Read the Route Notes First · Read the Docs First",
-  "DOC_PROCESS_5": "Crew's Nod Before You Push · Consent Before Push",
-  "DOC_PROCESS_6": "Set the Turnaround Before You Roll · Bound the Loop",
-  "DOC_PROCESS_7": "One Wrench on Each Bolt · One Writer Per File",
-  "DOC_COMMS_1": "Tag Every Part on the Bench · Codes That Persist",
-  "DOC_COMMS_2": "Draw the Route Only If It Turns · Structure Beside Prose",
+  "DOC_AUTOMATE_REPETITION": "Let the Cruise Control Do It · Automate Repetition",
+  "DOC_ENGLISH_CONFIGURATION": "Notes in English · English Configuration",
+  "DOC_DOCUMENTATION_IN_STEP": "Roadbook in Sync · Documentation in Step",
+  "DOC_SEARCH_BEFORE_CREATING": "Scout the Road First · Search Before Creating",
+  "DOC_RESPECT_CONVENTIONS": "Hold Your Line · Respect Conventions",
+  "DOC_SMALLEST_VIABLE_DIFF": "Tighten the One Bolt · Smallest Viable Diff",
+  "DOC_ONE_WRITER_PER_VALUE": "One Logbook for the Mileage · One Writer Per Value",
+  "DOC_IDEMPOTENT_BY_DEFAULT": "Safe to Kickstart Twice · Idempotent by Default",
+  "DOC_HONEST_TESTS": "Test the Ride, Not the Wiring · Honest Tests",
+  "DOC_COVER_AND_VERIFY": "Ride It Before You Park It · Cover and Verify",
+  "DOC_PROVE_THE_GATE": "A Bolt You Never Torqued Ain't Tight · Prove the Gate",
+  "DOC_EXTERNAL_GATE": "Someone Else Holds the Key · External Gate",
+  "DOC_TOOL_DISCOVERY": "Check Your Gear · Tool Discovery",
+  "DOC_COMMANDS_MUST_RETURN": "No Engine Left Idling · Commands Must Return",
+  "DOC_EDIT_THE_SOURCE_NOT_THE_SURFACE": "Wrench the Engine, Not the Paint · Edit the Source, Not the Surface",
+  "DOC_COMPLETE_THE_TEARDOWN": "Strip It Down to the Frame · Complete the Teardown",
+  "DOC_RECORD_THE_PROBE_NOT_THE_SNAPSHOT": "Trust the Live Gauge, Not the Old Sticker · Record the Probe, Not the Snapshot",
+  "DOC_RESTART_IS_NOT_RELOAD": "Kicking It Over Won't Reset the Jets · Restart Is Not Reload",
+  "DOC_SERIALIZE_AGAINST_A_RATIONED_RESOURCE": "Single File Through the Toll · Serialize Against a Rationed Resource",
+  "DOC_PERSIST_INSIGHT": "Write the Roadbook · Persist Insight",
+  "DOC_PLAN_BEFORE_ACTING": "Map the Route · Plan Before Acting",
+  "DOC_CONTEXT_ECONOMY": "Pack Light · Context Economy",
+  "DOC_READ_THE_DOCS_FIRST": "Read the Route Notes First · Read the Docs First",
+  "DOC_CONSENT_BEFORE_PUSH": "Crew's Nod Before You Push · Consent Before Push",
+  "DOC_BOUND_THE_LOOP": "Set the Turnaround Before You Roll · Bound the Loop",
+  "DOC_ONE_WRITER_PER_FILE": "One Wrench on Each Bolt · One Writer Per File",
+  "DOC_CODES_THAT_PERSIST": "Tag Every Part on the Bench · Codes That Persist",
+  "DOC_STRUCTURE_BESIDE_PROSE": "Draw the Route Only If It Turns · Structure Beside Prose",
   "INTRO_DOC": "This file is the route briefing a coding rider reads when it joins this repository.",
   "INTRO_AGENTS": "Send the right rider for focused work instead of riding the whole run yourself; each has one job and reports exactly what it did.",
   "INTRO_SKILLS": "A Skill is a move you've drilled for a recurring task. Run the matching move before you wing it.",

package/themes/commentator.json

@@ -75,50 +75,48 @@
   "DESC_PROFILE": "Build the player profile in PROFILE.md — position, form, how they like the commentary pitched; identity only, the rulebook stays in user-rules.md.",
   "DESC_GENESEED": "Operate the deployed Geneseed harness — find each install and its settings, read its files, run status, doctor and diff, and rebuild it with one setting changed when the user asks.",
   "DESC_REVIEW_RESPONSE": "Take the scrutineer's notes straight — weigh each call, then act on it or push back with reasons.",
-  "LEX_I": "Sealed Garage · Sealed Secrets",
-  "LEX_II": "One Move per Corner · One Intent, One Act",
-  "LEX_III": "Check the Telemetry · Verify Before Asserting",
-  "LEX_IV": "Delete Behind the Safety Car · Deletion Is Deliberate",
-  "LEX_V": "Call the Crash · Surface Failures",
-  "LEX_VI": "Pit Chatter Isn't a Call · Data, Not Orders",
-  "LEX_VII": "Carry Only the Fuel You Need · Least Privilege",
-  "LEX_VIII": "Fix the Engine, Not the Dash Light · Cure the Cause",
-  "LEX_IX": "The Steward Waves It Through, Not the Driver · External Gate (retired)",
-  "LEX_X": "Confirm the Pit Call · Echo the Intent",
-  "LEX_XI": "Read the Empty Board · Absence Is a Claim (retired)",
+  "LEX_SEALED_SECRETS": "Sealed Garage · Sealed Secrets",
+  "LEX_ONE_INTENT_ONE_ACT": "One Move per Corner · One Intent, One Act",
+  "LEX_VERIFY_BEFORE_ASSERTING": "Check the Telemetry · Verify Before Asserting",
+  "LEX_DELETION_IS_DELIBERATE": "Delete Behind the Safety Car · Deletion Is Deliberate",
+  "LEX_SURFACE_FAILURES": "Call the Crash · Surface Failures",
+  "LEX_DATA_NOT_ORDERS": "Pit Chatter Isn't a Call · Data, Not Orders",
+  "LEX_LEAST_PRIVILEGE": "Carry Only the Fuel You Need · Least Privilege",
+  "LEX_CURE_THE_CAUSE": "Fix the Engine, Not the Dash Light · Cure the Cause",
+  "LEX_ECHO_THE_INTENT": "Confirm the Pit Call · Echo the Intent",
   "PACK_CRAFT": "Engineering",
   "PACK_RIGOR": "Scrutineering",
   "PACK_OPS": "The Pit Lane",
   "PACK_PROCESS": "Race Control",
   "PACK_COMMS": "Team Radio",
-  "DOC_CRAFT_1": "Automate the Pit Stop · Automate Repetition",
-  "DOC_CRAFT_2": "Regs in English · English Configuration",
-  "DOC_CRAFT_3": "Notes in Sync · Documentation in Step",
-  "DOC_CRAFT_4": "Scout the Track First · Search Before Creating",
-  "DOC_CRAFT_5": "Hold the Racing Line · Respect Conventions",
-  "DOC_CRAFT_6": "One Setup Tweak, No More · Smallest Viable Diff",
-  "DOC_CRAFT_7": "One Official Timing Sheet · One Writer Per Value",
-  "DOC_RIGOR_1": "Safe to Send Round Twice · Idempotent by Default",
-  "DOC_RIGOR_2": "Time the Lap, Not the Telemetry Wiring · Honest Tests",
-  "DOC_RIGOR_3": "Cover the Line, Then Take the Flag · Cover and Verify",
-  "DOC_RIGOR_4": "A Call No Replay Can Overturn Isn't a Call · Prove the Gate",
-  "DOC_RIGOR_5": "The Steward Waves It Through, Not the Driver · External Gate",
-  "DOC_OPS_1": "Check the Car · Tool Discovery",
-  "DOC_OPS_2": "No Dead Air on the Line · Commands Must Return",
-  "DOC_OPS_3": "Adjust the Setup, Not the Dash · Edit the Source, Not the Surface",
-  "DOC_OPS_4": "See the Whole Pit Stop Through · Complete the Teardown",
-  "DOC_OPS_5": "Read the Live Timing, Not the Old Sheet · Record the Probe, Not the Snapshot",
-  "DOC_OPS_6": "A Pit Stop Isn't a Rebuild · Restart Is Not Reload",
-  "DOC_OPS_7": "Single File Through the Pit Lane · Serialize Against a Rationed Resource",
-  "DOC_PROCESS_1": "Log the Telemetry · Persist Insight",
-  "DOC_PROCESS_2": "Plot the Strategy · Plan Before Acting",
-  "DOC_PROCESS_3": "Run Light on Fuel · Context Economy",
-  "DOC_PROCESS_4": "Read the Briefing First · Read the Docs First",
-  "DOC_PROCESS_5": "Team Orders Before You Push · Consent Before Push",
-  "DOC_PROCESS_6": "Call the Stint Length Before Lights Out · Bound the Loop",
-  "DOC_PROCESS_7": "One Driver Per Car · One Writer Per File",
-  "DOC_COMMS_1": "Every Car Keeps Its Number · Codes That Persist",
-  "DOC_COMMS_2": "Track Map Only When the Lines Matter · Structure Beside Prose",
+  "DOC_AUTOMATE_REPETITION": "Automate the Pit Stop · Automate Repetition",
+  "DOC_ENGLISH_CONFIGURATION": "Regs in English · English Configuration",
+  "DOC_DOCUMENTATION_IN_STEP": "Notes in Sync · Documentation in Step",
+  "DOC_SEARCH_BEFORE_CREATING": "Scout the Track First · Search Before Creating",
+  "DOC_RESPECT_CONVENTIONS": "Hold the Racing Line · Respect Conventions",
+  "DOC_SMALLEST_VIABLE_DIFF": "One Setup Tweak, No More · Smallest Viable Diff",
+  "DOC_ONE_WRITER_PER_VALUE": "One Official Timing Sheet · One Writer Per Value",
+  "DOC_IDEMPOTENT_BY_DEFAULT": "Safe to Send Round Twice · Idempotent by Default",
+  "DOC_HONEST_TESTS": "Time the Lap, Not the Telemetry Wiring · Honest Tests",
+  "DOC_COVER_AND_VERIFY": "Cover the Line, Then Take the Flag · Cover and Verify",
+  "DOC_PROVE_THE_GATE": "A Call No Replay Can Overturn Isn't a Call · Prove the Gate",
+  "DOC_EXTERNAL_GATE": "The Steward Waves It Through, Not the Driver · External Gate",
+  "DOC_TOOL_DISCOVERY": "Check the Car · Tool Discovery",
+  "DOC_COMMANDS_MUST_RETURN": "No Dead Air on the Line · Commands Must Return",
+  "DOC_EDIT_THE_SOURCE_NOT_THE_SURFACE": "Adjust the Setup, Not the Dash · Edit the Source, Not the Surface",
+  "DOC_COMPLETE_THE_TEARDOWN": "See the Whole Pit Stop Through · Complete the Teardown",
+  "DOC_RECORD_THE_PROBE_NOT_THE_SNAPSHOT": "Read the Live Timing, Not the Old Sheet · Record the Probe, Not the Snapshot",
+  "DOC_RESTART_IS_NOT_RELOAD": "A Pit Stop Isn't a Rebuild · Restart Is Not Reload",
+  "DOC_SERIALIZE_AGAINST_A_RATIONED_RESOURCE": "Single File Through the Pit Lane · Serialize Against a Rationed Resource",
+  "DOC_PERSIST_INSIGHT": "Log the Telemetry · Persist Insight",
+  "DOC_PLAN_BEFORE_ACTING": "Plot the Strategy · Plan Before Acting",
+  "DOC_CONTEXT_ECONOMY": "Run Light on Fuel · Context Economy",
+  "DOC_READ_THE_DOCS_FIRST": "Read the Briefing First · Read the Docs First",
+  "DOC_CONSENT_BEFORE_PUSH": "Team Orders Before You Push · Consent Before Push",
+  "DOC_BOUND_THE_LOOP": "Call the Stint Length Before Lights Out · Bound the Loop",
+  "DOC_ONE_WRITER_PER_FILE": "One Driver Per Car · One Writer Per File",
+  "DOC_CODES_THAT_PERSIST": "Every Car Keeps Its Number · Codes That Persist",
+  "DOC_STRUCTURE_BESIDE_PROSE": "Track Map Only When the Lines Matter · Structure Beside Prose",
   "INTRO_DOC": "This file is the race briefing a coding driver reads when it joins this repository.",
   "INTRO_AGENTS": "Put the right driver in the car for focused work instead of running the whole race yourself; each has one job and reports exactly what it did.",
   "INTRO_SKILLS": "A Skill is a rehearsed manoeuvre for a recurring task. Run the matching manoeuvre before you improvise.",