geneseed 3.6.0 → 3.8.0

package/js/cli-table.json

@@ -54,7 +54,7 @@
     },
     {
       "name": "build",
-      "help": "render src/ -> Harness/",
+      "help": "render the harness (same flags as geneseed-build; an omitted flag takes the generator default, not the install's — see geneseed status --json for an install's own; dry run: geneseed validate)",
       "description": "",
       "positionals": [],
       "options": [
@@ -72,6 +72,141 @@
           "is_flag": false,
           "type": null,
           "hidden": false
+        },
+        {
+          "names": [
+            "--emit"
+          ],
+          "dest": "emit",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--footprint"
+          ],
+          "dest": "footprint",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--posture"
+          ],
+          "dest": "posture",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--mode"
+          ],
+          "dest": "mode",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--doctrines"
+          ],
+          "dest": "doctrines",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--exclude-rules"
+          ],
+          "dest": "exclude_rules",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--out"
+          ],
+          "dest": "out",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--root"
+          ],
+          "dest": "root",
+          "metavar": null,
+          "help": "",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
+        },
+        {
+          "names": [
+            "--config-dir"
+          ],
+          "dest": "config_dir",
+          "metavar": null,
+          "help": "the config dir a -global emit writes to (default: the host's resolved one)",
+          "choices": null,
+          "default": null,
+          "required": false,
+          "nargs": null,
+          "is_flag": false,
+          "type": null,
+          "hidden": false
         }
       ],
       "mutex": []
@@ -681,7 +816,21 @@
       "help": "print the install dashboard as text (theme, mode, counts, memory, version)",
       "description": "",
       "positionals": [],
-      "options": [],
+      "options": [
+        {
+          "names": ["--json"],
+          "dest": "json",
+          "metavar": null,
+          "help": "print the status payload as JSON — every install with its settings and the geneseed build command that rebuilds it",
+          "choices": null,
+          "default": false,
+          "required": false,
+          "nargs": "0",
+          "is_flag": true,
+          "type": null,
+          "hidden": false
+        }
+      ],
       "mutex": []
     },
     {

package/js/hosts/hooks.mjs

@@ -13,7 +13,8 @@
  * exactly where Claude asks, in Copilot's envelope. `--host bob` is Bob's own
  * protocol: PreToolUse ignores stdout and refuses only on EXIT CODE 2, so the two Laws
  * exit 2 with the reason on stderr and the rest is a stderr line with exit 0; SessionStart
- * context is plain stdout, as on Claude. Since P5b they are also what the emitted hooks name: `bin/build-driver.mjs` bakes
+ * context is plain stdout, as on Claude. `--host openclaude` speaks Claude's dialect verbatim
+ * (OpenClaude is a Claude Code fork); the flag only picks which root file counts as native. Since P5b they are also what the emitted hooks name: `bin/build-driver.mjs` bakes
  * `<node> <checkout>/bin/geneseed-hook.mjs` into the machine-wide shim, so an install this
  * driver emits has no Python in its hook path at all — which is what let the interpreter
  * discovery and its exit-4 refusal be deleted rather than merely bypassed.
@@ -223,7 +224,12 @@ const EXCLUDE_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'vendor',
 // host had its own root in EAGER_ROOT. Other tools' roots stay eager (a repo carrying a
 // hand-written AGENTS.md is worth showing Claude Code); only the host's OWN is dropped.
 // The OpenCode context plugin carries the same rule for AGENT.md/AGENTS.md/CLAUDE.md.
-const NATIVE_ROOT = { claude: ['CLAUDE.md'], bob: ['AGENTS.md'], copilot: ['AGENTS.md'] };
+// OpenClaude's root file is AGENTS.md, or CLAUDE.md when AGENTS.md is absent — resolved
+// per repo in `discoverContext`, since which one it loads depends on what is on disk.
+const NATIVE_ROOT = {
+  claude: ['CLAUDE.md'], bob: ['AGENTS.md'], copilot: ['AGENTS.md'],
+  openclaude: ['AGENTS.md', 'CLAUDE.md'],
+};
 
 // Eager injection budget: a root README of 40k chars was going out whole, every session and
 // every compaction, and cost more than the harness itself. Per-file cut at the last line
@@ -231,7 +237,7 @@ const NATIVE_ROOT = { claude: ['CLAUDE.md'], bob: ['AGENTS.md'], copilot: ['AGEN
 const EAGER_FILE_BYTES = 16 * 1024;
 const EAGER_TOTAL_BYTES = 48 * 1024;
 
-const CLAUDE_MARKERS = ['.claude', '.bob'];
+const CLAUDE_MARKERS = ['.claude', '.bob', '.openclaude'];
 const GENESEED_MANIFEST = '.geneseed-manifest.json';
 
 /**
@@ -302,7 +308,8 @@ function rglobMd(dir, acc = []) {
 export function discoverContext(root, host = HOST) {
   const eager = new Map();
   const lazy = new Map();
-  const native = NATIVE_ROOT[host] || [];
+  const native = host === 'openclaude' && isFile(path.join(root, 'AGENTS.md'))
+    ? ['AGENTS.md'] : NATIVE_ROOT[host] || [];
   for (const full of sortPaths(listDir(root).map((n) => path.join(root, n)))) {
     if (!isFile(full)) continue;
     const name = path.basename(full);

package/js/hosts/hosts.mjs

@@ -1,5 +1,5 @@
 /**
- * The four host config dirs, and the two path primitives they are built on.
+ * The five host config dirs, and the two path primitives they are built on.
  *
  * EXTRACTED IN P5c, and the reason is arithmetic rather than taste. `bin/build-driver.mjs`
  * owned these; `bin/geneseed-cli.mjs` needs the same four to find a global install, and a
@@ -208,9 +208,22 @@ export function bobConfigDir() {
   return resolvePath(path.join(os.homedir(), '.bob'));
 }
 
+/**
+ * OpenClaude (`@gitlawb/openclaude`) — `~/.openclaude`, relocatable via `$OPENCLAUDE_CONFIG_DIR`.
+ *
+ * Unlike Claude's, this env branch is the HOST'S OWN documented variable, not a Geneseed knob:
+ * OpenClaude reads it in `src/utils/envUtils.ts` and never falls back to `~/.claude` or
+ * `$CLAUDE_CONFIG_DIR`, so honouring it is what keeps the two CLIs agreeing on the target.
+ */
+export function openclaudeConfigDir() {
+  const env = process.env.OPENCLAUDE_CONFIG_DIR;
+  if (env) return resolvePath(env);
+  return resolvePath(path.join(os.homedir(), '.openclaude'));
+}
+
 /**
  * `_build_global.HOSTS`, reduced to the two columns a non-emitting caller needs, and IN ITS
- * ORDER — opencode, claude, bob, copilot.
+ * ORDER — opencode, claude, bob, copilot, openclaude.
  *
  * An array rather than an object because the order is observable output, not an
  * implementation detail: `harness exclude add` walks it and prints one message per host, so
@@ -235,6 +248,7 @@ export const HOSTS = [
   { host: 'claude', configDir: claudeConfigDir, projectMarker: '.claude', agentFile: 'CLAUDE.md' },
   { host: 'bob', configDir: bobConfigDir, projectMarker: '.bob', agentFile: 'AGENTS.md' },
   { host: 'copilot', configDir: copilotConfigDir, projectMarker: '.github', agentFile: 'AGENTS.md' },
+  { host: 'openclaude', configDir: openclaudeConfigDir, projectMarker: '.openclaude', agentFile: 'CLAUDE.md' },
 ];
 
 /**
@@ -265,6 +279,7 @@ const NATIVE_CATALOG = {
   claude: { skills: true, agents: true },
   bob: { skills: true, agents: false },
   copilot: { skills: false, agents: false },
+  openclaude: { skills: true, agents: true },
 };
 
 /** `{ skills, agents }` for a known host, `false` for an unknown one. */

package/js/hosts/installs.mjs

@@ -234,6 +234,24 @@ export const modeOfDir = (d) => leadOfDir(d, discoverNames('modes', 'direct'));
 /** The `Active packs:` marker line the template emits, in one of the five carriers. */
 const ACTIVE_PACKS_RE = /^Active packs:[ \t]*(.+?)[ \t]*$/m;
 
+/**
+ * A carrier rendered BEFORE the comms pack existed — the address migration's one detector.
+ *
+ * The comms pack took `process 7` (reference codes) out of process, and `process 8` (one
+ * writer per file) was renumbered to `process 7`. An install built before that names
+ * `process` in its marker and not `comms`, and so does a later install whose owner turned
+ * comms OFF — the marker alone cannot tell them apart. The carrier text can: a pre-comms
+ * process pack had eight rules, so wherever it was active the carrier renders a
+ * `process 8` heading, and wherever that rule was excluded the `Excluded rules:` line names
+ * it. No current carrier can say `process 8` — the pack has seven rules and nothing cites
+ * an eighth.
+ *
+ * ponytail: text sniff, not a stamp. It holds only while process has seven rules; the day
+ * process gets an eighth, this must move to a build stamp (or be retired, once no install
+ * built before the migration can remain).
+ */
+const legacyProcessCarrier = (text) => /\bprocess 8\b/.test(text);
+
 /**
  * The doctrine packs a DEPLOYED install carries — the third register read back off disk,
  * beside `postureOfDir` and `modeOfDir`, and the first that is a SET.
@@ -274,6 +292,12 @@ export function doctrinesOfDir(d) {
     if (m[1] === 'none') return [];
     const named = m[1].split(',').map((s) => s.trim());
     if (!named.every((n) => PACK_ORDER.includes(n))) return null;
+    // MIGRATION: a pre-comms install that carried process carried the codes rule inside it,
+    // so it keeps that rule by gaining comms. Its old `process 7` exclusion, if any, is
+    // re-addressed to `comms 1` by `excludedRulesOfDir` in the same pass.
+    if (named.includes('process') && !named.includes('comms') && legacyProcessCarrier(text)) {
+      named.push('comms');
+    }
     return PACK_ORDER.filter((pk) => named.includes(pk));
   });
 }
@@ -336,7 +360,12 @@ export function excludedRulesOfDir(d) {
       return parts.length === 2 && PACK_ORDER.includes(parts[0]) && /^\d+$/.test(parts[1])
         ? `${parts[0]}.${Number(parts[1])}` : null;
     });
-    return ids.every(Boolean) ? [...new Set(ids)].sort() : [];
+    if (!ids.every(Boolean)) return [];
+    // MIGRATION: the same pre-comms carrier spells the old addresses — see
+    // `legacyProcessCarrier`. One map, applied once, so `process 8` cannot chain onward.
+    const MOVED = { 'process.7': 'comms.1', 'process.8': 'process.7' };
+    const out = legacyProcessCarrier(text) ? ids.map((id) => MOVED[id] ?? id) : ids;
+    return [...new Set(out)].sort();
   }, []);
 }
 
@@ -364,6 +393,7 @@ export const EMIT_HOST_SCOPE = new Map([
   ['claude', ['claude', 'project']], ['claude-global', ['claude', 'global']],
   ['bob', ['bob', 'project']], ['bob-global', ['bob', 'global']],
   ['copilot', ['copilot', 'project']], ['copilot-global', ['copilot', 'global']],
+  ['openclaude', ['openclaude', 'project']], ['openclaude-global', ['openclaude', 'global']],
 ]);
 
 /** `_harness_mcp._emit_host_scope_of` — `root`'s own marker, resolved, or null. */
@@ -405,7 +435,7 @@ export function installKind(root) {
 
 /** `_harness_mcp._install_state` — 'active' | 'disabled' | 'absent'. */
 export function installState(root, host = 'opencode', scope = 'global') {
-  if (['claude', 'bob', 'copilot'].includes(host)) return claudeState(root, scope, host);
+  if (['claude', 'bob', 'copilot', 'openclaude'].includes(host)) return claudeState(root, scope, host);
   if (isDir(path.join(root, DISABLED_STASH))) return 'disabled';
   return installKind(root) !== null ? 'active' : 'absent';
 }

package/js/hosts/mcp.mjs

@@ -44,7 +44,7 @@ import { opencodeTarget, readJsonc } from './settings.mjs';
 const dget = (obj, key, dflt) => (isDict(obj) && Object.hasOwn(obj, key) ? obj[key] : dflt);
 
 /** The hosts whose MCP config is strict JSON under `mcpServers`, with no `enabled` flag. */
-const FLAGLESS = ['claude', 'bob', 'copilot'];
+const FLAGLESS = ['claude', 'bob', 'copilot', 'openclaude'];
 
 /**
  * `_harness_mcp._MCP_PRESETS` — the ready-to-wire servers the MCP screen can toggle.
@@ -248,6 +248,13 @@ export function mcpConfigFor(host, scope, root) {
     // file is documented, so a project install carries no MCP wiring.
     return scope === 'global' ? path.join(copilotConfigDir(), 'mcp-config.json') : null;
   }
+  if (host === 'openclaude') {
+    // Claude's `.mcp.json` per repo; globally `.openclaude.json` beside the home dir, or
+    // INSIDE `$OPENCLAUDE_CONFIG_DIR` when set — OpenClaude's own `getGlobalClaudeFile` rule.
+    if (scope === 'project') return path.join(root, '.mcp.json');
+    const env = process.env.OPENCLAUDE_CONFIG_DIR;
+    return resolvePath(path.join(env || os.homedir(), '.openclaude.json'));
+  }
   return null;
 }
 

package/js/hosts/settings.mjs

@@ -716,7 +716,10 @@ export function claudeHookGroups(cfg, hookOpts, doctrines = null, excluded = [],
       preCompact: entry(`${run} learn ${mem} || exit 0`),
     };
   }
-  const context = `${run} context --root "${cfg}" || exit 0`;
+  // OpenClaude takes Claude's whole group set and verdicts unchanged; only `context` needs
+  // the host, to know which root file OpenClaude already loads by itself.
+  const h = host === 'openclaude' ? ' --host openclaude' : '';
+  const context = `${run} context --root "${cfg}"${h} || exit 0`;
   const gate = `${run} git-gate --root "${cfg}"${consentRuleOn(doctrines, excluded) ? '' : ' --no-consent'}`;
   const ruleGate = `${run} rule-gate --root "${cfg}"`;
   const learn = `${run} learn ${mem} || exit 0`;

package/js/inspect/diff.mjs

@@ -349,7 +349,7 @@ export function cmdDiff(args) {
         + 'installs against a fresh render (a project layer is diffed against '
         + 'its own repo, which this command does not do). Pass --target at a '
         + 'global config dir (opencode-global/claude-global/bob-global/'
-        + 'copilot-global), or omit '
+        + 'copilot-global/openclaude-global), or omit '
         + '--target to use the default.\n');
     } else {
       printErr(`[diff] no global Geneseed install at ${target} (no ${GLOBAL_MANIFEST}). `

package/js/inspect/doctor.mjs

@@ -134,7 +134,7 @@ export function globalEmitProblems(themeName) {
 }
 
 /**
- * `_harness_build._claude_bob_emit_problems` — validate the claude/bob/copilot PER-REPO
+ * `_harness_build._claude_bob_emit_problems` — validate the claude/bob/copilot/openclaude PER-REPO
  * emits, which were never checked before.
  *
  * That is exactly why the CLAUDE.md/AGENTS.md skill-table dead links shipped unnoticed: the
@@ -143,7 +143,7 @@ export function globalEmitProblems(themeName) {
  * skills one level deeper than a bundle does.
  */
 export function claudeBobEmitProblems(themeName) {
-  return emitProblemsOver(['claude', 'bob', 'copilot'], (tmp, label) => {
+  return emitProblemsOver(['claude', 'bob', 'copilot', 'openclaude'], (tmp, label) => {
     const root = path.join(tmp, 'root');
     return {
       label: `${themeName} ${label}`,
@@ -211,7 +211,7 @@ export function doctorCollect({
       problems = problems.concat(ran('global', `Global install (${themeName})`,
         globalEmitProblems(themeName)));
       problems = problems.concat(ran('claude_bob',
-        `Claude/Bob/Copilot per-repo emit (${themeName})`, claudeBobEmitProblems(themeName)));
+        `Claude/Bob/Copilot/OpenClaude per-repo emit (${themeName})`, claudeBobEmitProblems(themeName)));
     }
   });
   problems = problems.concat(ran('parity', 'Theme parity', themeParityProblems()));

package/js/inspect/excludes.mjs

@@ -28,6 +28,10 @@ import { readText, writeText, printOut, printErr, isDir, isFile, isOsError } fro
 import { parseJson, jsonDumpsIndent, get, isDict } from '../lib/json.mjs';
 import { normcase, toPlatformPath } from '../lib/paths.mjs';
 
+/** The per-repo settings file a claudeMdExcludes entry goes in (Claude and OpenClaude). */
+const localSettings = (repo, host) =>
+  path.join(repo, HOSTS.find((h) => h.host === host).projectMarker, 'settings.local.json');
+
 /** `_global_installs` — every host whose GLOBAL config dir carries a Geneseed manifest. */
 function globalInstalls() {
   const out = [];
@@ -102,10 +106,9 @@ export function excludeAdd(target) {
     const prior = data.excludes.find((e) => isDict(e) && same(get(e, 'path'), repo));
     const priorWired = (isDict(prior) ? get(prior, 'wired') : null) || {};
     const wired = {};
-    if (host === 'claude' && isDir(repo)) {
+    if ((host === 'claude' || host === 'openclaude') && isDir(repo)) {
       const entry = resolvePath(path.join(cfg, 'CLAUDE.md')).split(path.sep).join('/');
-      const added = wireClaudeExcludes(
-        path.join(repo, '.claude', 'settings.local.json'), [entry]);
+      const added = wireClaudeExcludes(localSettings(repo, host), [entry]);
       if (added.length) {
         wired.claude_md_excludes = added;
       } else if (get(priorWired, 'claude_md_excludes')) {
@@ -172,8 +175,7 @@ export function excludeRemove(target) {
     found = true;
     const wired = get(mine, 'wired') || {};
     if (get(wired, 'claude_md_excludes')) {
-      unwireClaudeExcludes(path.join(repo, '.claude', 'settings.local.json'),
-        get(wired, 'claude_md_excludes'));
+      unwireClaudeExcludes(localSettings(repo, host), get(wired, 'claude_md_excludes'));
     }
     if (get(wired, 'bob_rules_stub')) {
       const stub = path.join(repo, '.bob', 'rules', 'geneseed.md');

package/js/inspect/status.mjs

@@ -61,8 +61,8 @@ import { THEMES, ROOT, makeCfg } from '../build/source.mjs';
 import { tuiInventory } from './inventory.mjs';
 import { readVersion, sourceFingerprint } from '../build/version.mjs';
 import {
-  claudeConfigDir, bobConfigDir, copilotConfigDir, opencodeConfigDir, resolvePath,
-  resolveMemoryDir, sovereignBypass, GATE_LEDGER,
+  claudeConfigDir, bobConfigDir, copilotConfigDir, openclaudeConfigDir, opencodeConfigDir,
+  resolvePath, resolveMemoryDir, sovereignBypass, GATE_LEDGER,
 } from '../hosts/hosts.mjs';
 // P5f moved the install DETECTORS out of this file — `diff` renders its expected copy in the
 // deployed theme and footprint, and `rebuild-all` re-emits in the deployed everything, so
@@ -70,8 +70,9 @@ import {
 // re-exported below because `tests/fixtures/pure_probe.mjs` names this module for two of them
 // and a corpus that followed the code to its new file would stop testing the caller's view.
 import {
-  defaultTheme, installedDefaults, manifestIsClaude, readJsonMaybe, readMaybe,
+  defaultTheme, installedDefaults, installTargets, manifestIsClaude, readJsonMaybe, readMaybe,
 } from '../hosts/installs.mjs';
+import { installProfile, rebuildCommand } from '../build/generate.mjs';
 import { printOut } from '../lib/fs.mjs';
 import { codePointLength, padEndToWidth } from '../lib/text.mjs';
 
@@ -100,7 +101,7 @@ export function cmdVersion(args) {
   if (installed === null) {
     // A claude/bob/copilot-only machine must not report "no install detected". The bundle
     // candidates are cwd-relative only — see the Python for why `ROOT / "Harness"` left.
-    for (const base of [claudeConfigDir(), bobConfigDir(), copilotConfigDir(),
+    for (const base of [claudeConfigDir(), bobConfigDir(), copilotConfigDir(), openclaudeConfigDir(),
       path.join(process.cwd(), 'Harness'), process.cwd()]) {
       const v = readVersion(base);
       if (v) { installed = v; target = base; break; }
@@ -225,7 +226,7 @@ export function statusData() {
   let installedFp = null;
   let verTarget = null;
   const otherCfg = [];
-  for (const fn of [claudeConfigDir, bobConfigDir, copilotConfigDir]) {
+  for (const fn of [claudeConfigDir, bobConfigDir, copilotConfigDir, openclaudeConfigDir]) {
     try { otherCfg.push(fn()); } catch { /* a missing host dir must not sink status */ }
   }
   // Same walk as `cmdVersion`'s fallback, and cwd-relative for the same reason.
@@ -262,6 +263,20 @@ export function statusData() {
     agent_md: agentMd ? String(agentMd) : null,
     agent_md_present: Boolean(agentMd && existsSync(agentMd)),
     gates: gateSummary([...(cfgDir ? [cfgDir] : []), ...otherCfg]),
+    // EVERY install, not just the one `installedDefaults` settles on — and read through the
+    // same `installProfile` `rebuild-all` uses, so the settings shown are the ones a rebuild
+    // keeps. `rebuild` is the pasteable command an agent edits one flag of. A broken install
+    // must not sink the panel, so it is reported rather than thrown. `absent` slots are
+    // filtered out here: an absent slot has no settings, so a row of defaults for it reads as
+    // an install that does not exist — noise in the panel and misinformation in `--json`.
+    installs: installTargets().map(([host, scope, root]) => {
+      try {
+        const p = installProfile(host, scope, root);
+        return { ...p, rebuild: rebuildCommand(p.argv) };
+      } catch (e) {
+        return { host, scope, root, state: 'unreadable', error: String(e?.message ?? e) };
+      }
+    }).filter((p) => p.state !== 'absent'),
   };
 }
 
@@ -343,6 +358,18 @@ export function statusLines(d, color = false) {
     rows.push(['gates', `${armed}  ${DOT}  ${g.total} ask${g.total === 1 ? '' : 's'}`
       + (byRule ? ` (${byRule})` : '')]);
   }
+  // Conditional for the recording reason again: no recorded panel carries `installs`.
+  for (const p of d.installs ?? []) {
+    const where = p.scope === 'project' ? `  (${p.root})` : '';
+    if (p.state === 'unreadable') {
+      rows.push([`${p.host}:${p.scope}`, `unreadable: ${p.error}${where}`]);
+      continue;
+    }
+    const packs = p.doctrines.length ? p.doctrines.join(',') : 'no packs';
+    const excl = p.excludeRules?.length ? `excluding ${p.excludeRules.join(',')}` : 'no rules excluded';
+    rows.push([`${p.host}:${p.scope}`, [p.state, p.theme, p.footprint, `${p.posture}/${p.mode}`,
+      packs, excl].join(` ${DOT} `) + where]);
+  }
 
   const labelW = Math.max(...rows.map(([k]) => codePointLength(k)));
   const body = rows.map(([k, v]) => `  ${padEndToWidth(k, labelW)}   ${v}`);
@@ -365,8 +392,17 @@ export function statusLines(d, color = false) {
   return lines;
 }
 
-/** `_harness_status.cmd_status`. */
-export function cmdStatus() {
-  for (const line of statusLines(statusData(), colorEnabled())) printOut(`${line}\n`);
+/**
+ * `_harness_status.cmd_status` — and `--json`, the machine face of the same payload. An agent
+ * reading the panel had to scrape box-drawing; the object below is what the panel is drawn
+ * FROM, so the two cannot disagree.
+ */
+export function cmdStatus(args) {
+  const d = statusData();
+  if (args?.json) {
+    printOut(`${JSON.stringify(d, null, 2)}\n`);
+    return 0;
+  }
+  for (const line of statusLines(d, colorEnabled())) printOut(`${line}\n`);
   return 0;
 }

package/js/maintain/migrate.mjs

@@ -59,7 +59,7 @@ const KNOWN_EMITS = new Set(EMIT_HOST_SCOPE.keys());
  * hosts, which is what the project's host-parity rule asks for.
  */
 function hookSettingsFile(root, host, scope) {
-  if (host !== 'claude' && host !== 'bob') return null;
+  if (!['claude', 'bob', 'openclaude'].includes(host)) return null;
   const name = scope === 'project' && host !== 'bob' ? 'settings.local.json' : 'settings.json';
   return path.join(root, name);
 }

package/js/maintain/setup.mjs

@@ -228,6 +228,7 @@ const DOCTRINE_BLURBS = {
   ops: 'how the machine is driven — tool discovery, non-blocking commands, teardown',
   process: 'how a session runs — planning, context economy, docs first, and the consent gate '
     + 'on every commit and push (drop this pack and that gate goes with it)',
+  comms: 'how answers are presented — stable reference codes, a diagram or a table only where it earns its place',
 };
 
 /**
@@ -279,7 +280,7 @@ export function doctrineOptions() {
 /**
  * `_harness_setup.EMIT_OPTIONS`.
  *
- * Exported since P6b: `/api/themes` returns the same nine as its `emits` list, and a copy
+ * Exported since P6b: `/api/themes` returns the same eleven as its `emits` list, and a copy
  * of a table under test silently stops being the table under test.
  */
 export const EMIT_OPTIONS = [
@@ -292,6 +293,10 @@ export const EMIT_OPTIONS = [
   ['copilot-global', 'GitHub Copilot personal config dir (~/.copilot) — copilot-instructions.md, agents, skills.'],
   ['copilot', 'Per-repo AGENTS.md + .github/ for GitHub Copilot, committed into one repository.'],
   ['files', 'Plain bundle for any AGENT.md tool.'],
+  // Appended AFTER `files`, not beside the other hosts: the menu is answered by number, and a
+  // scripted `setup` that pipes its answers must keep meaning what it meant.
+  ['openclaude-global', 'OpenClaude global config dir (~/.openclaude) — CLAUDE.md, agents, skills, hooks.'],
+  ['openclaude', 'Per-repo .openclaude/ (CLAUDE.md, agents, skills, hooks) for OpenClaude, committed into one repository.'],
 ];
 
 /** `_harness_setup.FOOTPRINT_OPTIONS`. */
@@ -375,7 +380,7 @@ export function collectSetupLines() {
   // Every PROJECT emit needs the repo root — claude/bob/copilot included: without `--out`
   // their CLAUDE.md/.claude land in the generator's default ./Harness, where the host never
   // looks.
-  if (['opencode', 'claude', 'bob', 'copilot'].includes(emit)) {
+  if (['opencode', 'claude', 'bob', 'copilot', 'openclaude'].includes(emit)) {
     root = ask('Repo root to install into', '.');
     out = root;
   } else if (emit === 'files') {

package/js/maintain/uninstall.mjs

@@ -71,7 +71,7 @@ import { comparePaths, isAbsolutePath, within } from '../lib/paths.mjs';
 const hostSpec = (host) => HOSTS.find((h) => h.host === host);
 
 /** The Claude-STYLE hosts — one manifest shape, one reversal. Spelled once. */
-const CLAUDE_STYLE = ['claude', 'bob', 'copilot'];
+const CLAUDE_STYLE = ['claude', 'bob', 'copilot', 'openclaude'];
 
 /**
  * `shutil.rmtree(p, ignore_errors=True)`.
@@ -681,7 +681,7 @@ export function cmdUninstall(args) {
     const targetDesc = resolvePath(expanduser(args.target));
     printErr(`[uninstall] no Geneseed install detected at ${targetDesc}.\n`
       + '[uninstall] pass --target <repo> for a project install (.opencode/.claude/'
-      + '.bob/.github) or --target <config dir> for a global one.\n');
+      + '.bob/.github/.openclaude) or --target <config dir> for a global one.\n');
     return 1;
   }
   const [host, scope, root] = hit;
@@ -700,7 +700,7 @@ export function cmdUninstall(args) {
       + `${hostSpec(host).agentFile} managed block, and Geneseed's `
       + '~/.copilot/settings.json hooks on a global install (your own keys/hooks and '
       + '.github files are kept).\n');
-  } else if (host === 'claude' || host === 'bob') {
+  } else if (['claude', 'bob', 'openclaude'].includes(host)) {
     printOut('[uninstall] removes: agents/, skills/, markers, the '
       + `${hostSpec(host).agentFile} managed block, and Geneseed's `
       + 'settings.json hooks/excludes (your own keys/hooks are kept).\n');