geneseed 3.5.0 → 3.7.0

package/docs/web/exclusions.md

@@ -14,6 +14,7 @@ Exclusion is all-or-nothing per folder — it doesn't trim which Rules apply or
 ### How it's wired, per host
 
 - **Claude Code** — native suppression via `claudeMdExcludes` in the repo's `.claude/settings.local.json`.
+- **OpenClaude** — the same `claudeMdExcludes`, in the repo's `.openclaude/settings.local.json`.
 - **Bob** — a shadow `rules/geneseed.md` stub that shadows the global one (never overwrites a hand-written stub already there).
 - **OpenCode** — the hook entry's sovereign-bypass guard and its twin in the plugins short-circuit at session start.
 - **Copilot — documented limitation.** GitHub Copilot has no native per-repo suppression hook: the global `copilot-instructions.md` still loads even inside an excluded folder.

package/docs/web/footprint.md

@@ -26,7 +26,7 @@ Neither setting hides text from the agent; they hide it from *every turn*.
 
 ### How to set it
 
-It's set-and-forget — stored in the `.geneseed-footprint` marker, preserved across every rebuild, identical on every host (OpenCode, Claude Code, Bob, Copilot). Changing it re-emits the install.
+It's set-and-forget — stored in the `.geneseed-footprint` marker, preserved across every rebuild, identical on every host (OpenCode, Claude Code, Bob, Copilot, OpenClaude). Changing it re-emits the install.
 
 - **Settings** — the **Footprint** toggle flips the current install (full ⇄ lean) and rebuilds it in place.
 - **Harness tab** — on an active install, a per-harness dropdown sets it for that install independently, then **Apply**. On a host that is not installed yet, it is step 2 of **Install…**.

package/docs/web/harnesses.md

@@ -4,26 +4,26 @@ order: 4
 title: "Supported harnesses"
 kind: "concept"
 ---
-One source, **five emit targets** — each with a per-repo and a global (`-global`) variant, plus a portable `files` bundle any `AGENT.md`-aware tool can read. **OpenCode** runs its own engine (JS plugins, colour themes, LSP); **Claude Code**, **Bob**, and **Copilot** share one Claude-shaped engine that diverges only by host dialect.
+One source, **six emit targets** — each with a per-repo and a global (`-global`) variant, plus a portable `files` bundle any `AGENT.md`-aware tool can read. **OpenCode** runs its own engine (JS plugins, colour themes, LSP); **Claude Code**, **Bob**, **Copilot**, and **OpenClaude** share one Claude-shaped engine that diverges only by host dialect.
 
-The harness *content* — the constitution (Ethos, Rules, Doctrines), Agents, Skills, Memory, and the preamble voice — is **identical on every host**: one build renders the same text for all five targets. What differs is how much of it the host can *automate* (via plugins or hooks) versus carry as preamble discipline.
+The harness *content* — the constitution (Ethos, Rules, Doctrines), Agents, Skills, Memory, and the preamble voice — is **identical on every host**: one build renders the same text for all six targets. What differs is how much of it the host can *automate* (via plugins or hooks) versus carry as preamble discipline.
 
-| Capability | OpenCode | Claude | Bob | Copilot |
-| --- | :---: | :---: | :---: | :---: |
-| Agents · Skills · Memory | ✅ | ✅ | ✅ | ✅ |
-| Context injection | ⚙️ plugin | 🪝 hook | 🪝 hook¹ | 📄 preamble |
-| Memory write-back (learn) | ⚙️ plugin | 🪝 hook | 🪝 hook¹ | 📄 preamble |
-| Git-gate consent (Doctrine process 5) | ⚙️ plugin | 🪝 hook | 🪝 hook¹ | 📄 preamble |
-| Sovereign-repo excludes | ⚙️ plugin | ✅ | ✅ | ➖ |
-| MCP server wiring | ✅ | ✅ | ✅ | ✅ |
-| Colour themes | ✅ | ➖ | ➖ | ➖ |
-| LSP · workflows · primary-agent · `/`-commands | ✅ | ➖ | ➖ | ➖ |
+| Capability | OpenCode | Claude | Bob | Copilot | OpenClaude |
+| --- | :---: | :---: | :---: | :---: | :---: |
+| Agents · Skills · Memory | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Context injection | ⚙️ plugin | 🪝 hook | 🪝 hook¹ | 📄 preamble | 🪝 hook² |
+| Memory write-back (learn) | ⚙️ plugin | 🪝 hook | 🪝 hook¹ | 📄 preamble | 🪝 hook² |
+| Git-gate consent (Doctrine process 5) | ⚙️ plugin | 🪝 hook | 🪝 hook¹ | 📄 preamble | 🪝 hook² |
+| Sovereign-repo excludes | ⚙️ plugin | ✅ | ✅ | ➖ | ✅ |
+| MCP server wiring | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Colour themes | ✅ | ➖ | ➖ | ➖ | ➖ |
+| LSP · workflows · primary-agent · `/`-commands | ✅ | ➖ | ➖ | ➖ | ➖ |
 
-✅ native · ⚙️ OpenCode plugin · 🪝 `settings.json` hook · 📄 preamble prose only · ➖ no host mechanism (harness discipline still applies). ¹ Bob honours Claude-dialect hooks best-effort — inert if unsupported, harness still holds via the preamble.
+✅ native · ⚙️ OpenCode plugin · 🪝 `settings.json` hook · 📄 preamble prose only · ➖ no host mechanism (harness discipline still applies). ¹ Bob honours Claude-dialect hooks best-effort — inert if unsupported, harness still holds via the preamble. ² OpenClaude is a Claude Code fork: Claude's hooks verbatim, under `~/.openclaude` or a repo's `.openclaude/`.
 
 **The git-gate row is the one capability that is not always present**, on any host. It implements **Doctrine process 5**, so it is wired only on an install that built the **process** [doctrine pack](#/docs/setup-choices) in — drop that pack and the boundary drops with it, because a gate that keeps asking for a rule the install never adopted is a gate arguing with its own harness. One asymmetry: on OpenCode that holds for a *fresh* install, but a pack-off rebuild of an install whose `opencode.json` already carries a `git commit*` entry leaves it in place and reports it — Geneseed cannot tell its own entry from one you typed, so it removes neither ([doctrine packs](#/docs/setup-choices)). The invariant-territory refusals in the same neighbourhood (`rm -rf`, a force-push) are the Rules' territory, not the pack's, and stay in every build.
 
-**No host drops an Agent, Skill, or the memory convention.** The asymmetry is otherwise entirely in *automation mechanism*: OpenCode's plugins and Claude/Bob's hooks enforce a few of these rules for you at the tool boundary, where **Copilot** (no hook mechanism) enforces them through preamble discipline. The OpenCode-only extras (themes, LSP, workflow runner, primary-agent) have no analogue on a Claude-shaped host.
+**No host drops an Agent, Skill, or the memory convention.** The asymmetry is otherwise entirely in *automation mechanism*: OpenCode's plugins and Claude/Bob/OpenClaude's hooks enforce a few of these rules for you at the tool boundary, where **Copilot** (no hook mechanism) enforces them through preamble discipline. The OpenCode-only extras (themes, LSP, workflow runner, primary-agent) have no analogue on a Claude-shaped host.
 
 ---
 

package/docs/web/install-quick.md

@@ -18,7 +18,7 @@ To keep the command around: `npm install -g geneseed`, then plain `geneseed …`
 
 ### 2. Open your agent
 
-Open OpenCode (or Claude Code, Bob, Copilot, or any `AGENT.md`-aware tool) in any repo. The first reply opens with the readiness sigil (`✅` neutral / `🧬` imperial / your theme's equivalent) and your project's docs are already in context.
+Open OpenCode (or Claude Code, Bob, Copilot, OpenClaude, or any `AGENT.md`-aware tool) in any repo. The first reply opens with the readiness sigil (`✅` neutral / `🧬` imperial / your theme's equivalent) and your project's docs are already in context.
 
 ### Prefer a clone?
 

package/docs/web/rules.md

@@ -17,7 +17,7 @@ The agent's standing rules come in **three tiers**, and the tier decides how a r
 
 ### Doctrines — chosen at build time
 
-Practices rather than principles: **craft** (how code is written), **rigor** (how work is proven), **ops** (how the machine is operated), **process** (how a task is run), one file each under `src/doctrines/`. A repository picks its set with `geneseed-build --doctrines <list>` or through the setup wizard — all {N_PACKS} are on by default. This install built in {N_PACKS_ACTIVE}, carrying {N_DOCTRINE_RULES} rules between them. Cited by pack and number — `Doctrine process 5`.
+Practices rather than principles: **craft** (how code is written), **rigor** (how work is proven), **ops** (how the machine is operated), **process** (how a task is run), **comms** (how answers are presented), one file each under `src/doctrines/`. A repository picks its set with `geneseed-build --doctrines <list>` or through the setup wizard — all {N_PACKS} are on by default. This install built in {N_PACKS_ACTIVE}, carrying {N_DOCTRINE_RULES} rules between them. Cited by pack and number — `Doctrine process 5`.
 
 A pack you leave out **still ships in the bundle**: every pack file lands under `doctrines/` beside `AGENT.md` whether or not it was built in. So a rule that cites one in an inactive pack still resolves on disk, and you can read the alternatives before turning one on. What an inactive pack loses is bindingness, not availability.
 

package/docs/web/themes-author.md

@@ -13,7 +13,7 @@ Every rule in the constitution gets its title from a theme key, and a theme that
 
 - `LEX_I`…`LEX_IX` — one title per invariant. `doctor` holds this to an **equality**, not mere presence: a `LEX_*` outside `I`–`IX` is a title for a rule that does not exist and fails the check too.
 - `DOC_*` — one title per doctrine rule, named after its address (`DOC_CRAFT_1`, `DOC_PROCESS_5`, …). `doctor` reads the pack files under `src/doctrines/` and requires exactly the set they name — a missing one is a blank heading, an extra one is a dead key.
-- `PACK_*` — one name per pack (`PACK_CRAFT`, `PACK_RIGOR`, `PACK_OPS`, `PACK_PROCESS`), used for the pack's own sub-heading.
+- `PACK_*` — one name per pack (`PACK_CRAFT`, `PACK_RIGOR`, `PACK_OPS`, `PACK_PROCESS`, `PACK_COMMS`), used for the pack's own sub-heading.
 
 The Ethos section names are **not** theme keys: a citation reads `({{ONTOLOGY}}: {{ONT_TELOS}})`, token on both sides, so heading and reference always move together. They live in the build's fixed structure table and you neither declare nor rename them.
 

package/docs/web-ui.md

@@ -120,7 +120,7 @@ streams the output of background jobs and keeps their history across reloads.
 - **Docs** (`#/docs`) — rendered documentation: markdown pages, concept pages, a CLI
   reference (generated from the harness argument parser), and a glossary, grouped into
   Get started / Core concepts / How-to / MCP servers / Plugins / Reference / Deeper. Filtered
-  for one host family (OpenCode, or Claude Code — which Bob and Copilot share); with no
+  for one host family (OpenCode, or Claude Code — which Bob, Copilot and OpenClaude share); with no
   choice stored it follows the deployed install.
 
 ### 🩺 Care

package/harness.config.json

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

package/js/README.md

@@ -40,12 +40,12 @@ as a per-host install at project or global scope.
 | `source.mjs` | Where the SOURCE is: `ROOT`/`SRC`/`THEMES`/`CONFIG`, `PACK_ORDER`, rule ids, the cfg object |
 | `render.mjs` | The pure text pipeline: theme load, `INCLUDE` inlining, CATALOG blocks, `{{TOKENS}}`, dest paths |
 | `bundle.mjs` | `build` — render a theme into a bundle dir, plus the source-completeness refusal. Sits UNDER both emits |
-| `emit-claude.mjs` | The Claude/Bob/Copilot emit — the render half plus the settings + CLAUDE.md managed-block wire |
+| `emit-claude.mjs` | The Claude/Bob/Copilot/OpenClaude emit — the render half plus the settings + CLAUDE.md managed-block wire |
 | `emit-opencode.mjs` | The OpenCode emits — a project's `.opencode/` and the global config dir. Deliberate twin of the above |
 | `emit-common.mjs` | Constants, tree walkers, and the three writers BOTH global emits share. Decides no host |
 | `stubs.mjs` | Write-once seed files: context, wiki, rules, excludes, profile, `.gitignore`, memory/notebook indexes |
 | `version.mjs` | The release marker: fingerprint the sources, read/compare/write an install's version, warn on downgrade |
-| `driver.mjs` | The generator driver: `--emit`/`--theme`/`--footprint` flag parsing, the nine emit targets, per-host emit orchestration, the prune and the manifest. `bin/build-driver.mjs` is only its entry |
+| `driver.mjs` | The generator driver: `--emit`/`--theme`/`--footprint` flag parsing, the eleven emit targets, per-host emit orchestration, the prune and the manifest. `bin/build-driver.mjs` is only its entry |
 | `generate.mjs` | CLI verbs `build`, `prompt`, `theme`, `rebuild-all` — the thin face over `driver.mjs` |
 | `catalog.mjs` | `geneseed catalog` — prints the shipped roster. Classifies nothing itself |
 | `themes.mjs` | Maintainer-only `--sync-themes`: inserts `_TEMPLATE.json`'s missing keys into the committed themes |
@@ -66,7 +66,7 @@ user co-owns, and the hook verbs those emitted configs then run.
 
 | module | owns |
 |---|---|
-| `hosts.mjs` | The four host config dirs (opencode/claude/bob/copilot), plus `resolvePath`/`expanduser` |
+| `hosts.mjs` | The five host config dirs (opencode/claude/bob/copilot/openclaude), plus `resolvePath`/`expanduser` |
 | `hooks.mjs` | The verbs the emitted hooks run every session: `context`, `git-gate`, `rule-gate`, `tool-gate` (the two gates fused, for Copilot), `learn`. `--host` picks the verdict dialect |
 | `settings.mjs` | Merges into user-owned `settings.json`/`opencode.json`; owns the hook shim and the managed blocks |
 | `native.mjs` | Capability specs → host-native subagents and skills. The impure half of the emit |

package/js/build/driver.mjs

@@ -1,5 +1,5 @@
 /**
- * The generator driver — flag parsing, the nine emit targets, and the per-host emit orchestration.
+ * The generator driver — flag parsing, the eleven emit targets, and the per-host emit orchestration.
  * `bin/build-driver.mjs` (`geneseed-build`) is only its entry; this module is what the CLI verbs
  * (`build`, `setup`, `migrate`, `doctor`, `diff`, `validate`, the web console) import. It lived in
  * `bin/` until 2026-09, which made nine `js/` modules import upward from a binary.
@@ -51,7 +51,7 @@ import { parseJson, jsonDumpsIndent } from '../lib/json.mjs';
 // that should exist twice. golden.py's 259 cells are what made the move safe to attempt.
 import {
   GLOBAL_MANIFEST, resolvePath, opencodeConfigDir, claudeConfigDir, bobConfigDir,
-  copilotConfigDir, hostCatalogsNatively,
+  copilotConfigDir, openclaudeConfigDir, hostCatalogsNatively,
 } from '../hosts/hosts.mjs';
 
 // P5d moved these out of this file for the reason P5c moved the host resolvers: `harness
@@ -71,9 +71,9 @@ import { registryRecord, registryRoots } from '../inspect/registry.mjs';
 // maintainer pair that needs nothing this driver is banned from having.
 import { syncThemes } from './themes.mjs';
 
-/** The nine `--emit` choices, in build.py:337-338's order. */
+/** The eleven `--emit` choices: build.py:337-338's nine, then OpenClaude's pair. */
 const EMITS = ['files', 'opencode', 'opencode-global', 'claude', 'claude-global',
-  'bob', 'bob-global', 'copilot', 'copilot-global'];
+  'bob', 'bob-global', 'copilot', 'copilot-global', 'openclaude', 'openclaude-global'];
 
 /** `_build_emit.PRIMARY_AGENT_SRC`. */
 const PRIMARY_AGENT_SRC = path.join(ROOT, 'adapters', 'opencode', 'agents', 'orchestrator.md');
@@ -509,9 +509,11 @@ export function hookRunnerEntry() {
  * POSIX spelling, per the original: `claudeMdExcludes` entries are glob patterns, where a
  * backslash is an escape, so the Windows-native form risks never matching.
  */
-function preambleExclude(claudeMd) {
+function preambleExclude(claudeMd, host) {
   if (path.basename(claudeMd) !== 'CLAUDE.md') return null;
-  return resolvePath(path.join(claudeConfigDir(), 'CLAUDE.md')).split(path.sep).join('/');
+  // OpenClaude inherited `claudeMdExcludes` from Claude Code; its global preamble is its own.
+  const globalDir = host === 'openclaude' ? openclaudeConfigDir() : claudeConfigDir();
+  return resolvePath(path.join(globalDir, 'CLAUDE.md')).split(path.sep).join('/');
 }
 
 /**
@@ -808,7 +810,7 @@ function emitClaudeCore(cfg, args, { cfgDir, claudeMd, scope, host, out, hookOpt
     theme: args.theme, cfgDir, claudeMd, scope, host,
     out: out === null ? null : out,
     footprint: args.footprint, nativeCatalog: hostCatalogsNatively(host),
-    oldOwned, oldManaged, preambleExclude: preambleExclude(claudeMd),
+    oldOwned, oldManaged, preambleExclude: preambleExclude(claudeMd, host),
     ...(hookOpts ? { hookOpts } : {}),
   });
   const { owned, stats, memStatus, nbStatus, managed } = rendered;
@@ -930,6 +932,42 @@ function emitClaude(cfg, args, out) {
     + `settings.json), ${r.memStatus}, ${r.nbStatus}.\n`);
 }
 
+/**
+ * OpenClaude global — `~/.openclaude` (or `$OPENCLAUDE_CONFIG_DIR`). The Claude emit with
+ * another config dir: OpenClaude is a Claude Code fork that reads neither `~/.claude` nor
+ * `CLAUDE_CONFIG_DIR`, so a Claude install is invisible to it and it needs its own.
+ */
+function emitOpenclaudeGlobal(cfg, args, out) {
+  const cfgDir = args.cfgDir ?? openclaudeConfigDir();
+  const hookOpts = hookRunnerEntry();
+  const r = emitClaudeCore(cfg, args, {
+    cfgDir, claudeMd: path.join(cfgDir, 'CLAUDE.md'), scope: 'global', host: 'openclaude', out,
+    hookOpts,
+  });
+  process.stdout.write(`[geneseed] openclaude-global -> ${cfgDir}: ${r.nAgents} subagents, `
+    + `${r.nSkills} skills, CLAUDE.md, ${r.nHooks} hook group(s), settings.json, `
+    + `${r.memStatus}, ${r.nbStatus}. MCP servers go in .openclaude.json.\n`);
+  return cfgDir;
+}
+
+/**
+ * OpenClaude per-repo — everything under `.openclaude/`, the preamble included. OpenClaude
+ * reads the root CLAUDE.md only when the repo has no AGENTS.md, but `.openclaude/CLAUDE.md`
+ * always; keeping the root untouched also lets a Claude Code install share the repo.
+ */
+function emitOpenclaude(cfg, args, out) {
+  const root = args.root ? resolveOut(args.root) : out;
+  const cfgDir = path.join(root, '.openclaude');
+  const hookOpts = hookRunnerEntry();
+  const r = emitClaudeCore(cfg, args, {
+    cfgDir, claudeMd: path.join(cfgDir, 'CLAUDE.md'), scope: 'project', host: 'openclaude', out,
+    hookOpts,
+  });
+  process.stdout.write(`[geneseed] openclaude (folder) -> ${root}: .openclaude/ `
+    + `(CLAUDE.md, ${r.nAgents} subagents, ${r.nSkills} skills, ${r.nHooks} hook group(s), `
+    + `settings.local.json), ${r.memStatus}, ${r.nbStatus}.\n`);
+}
+
 /**
  * `_build_global.emit_bob_global` — into Bob's global config dir (~/.bob).
  *
@@ -1012,6 +1050,7 @@ const GLOBAL_EMITS = {
   claude: emitClaudeGlobal,
   bob: emitBobGlobal,
   copilot: emitCopilotGlobal,
+  openclaude: emitOpenclaudeGlobal,
 };
 
 /**
@@ -1033,7 +1072,7 @@ const GLOBAL_EMITS = {
  * three-positional call leaves in place, inherited here rather than re-decided.
  */
 const PROJECT_EMITS = {
-  claude: emitClaude, bob: emitBob, copilot: emitCopilot,
+  claude: emitClaude, bob: emitBob, copilot: emitCopilot, openclaude: emitOpenclaude,
   // P2. `opencode` joins the three for `cmdValidate`, which has to be able to render EVERY
   // `--emit` choice into its sandbox and not only the three doctor already scans. Its call
   // shape is `emitClaude`'s exactly — `(cfg, args, out)` — so the row is the whole change.
@@ -1186,6 +1225,8 @@ function run(argv) {
   // An ALLOW-LIST, not "everything that is not global": a plain `--emit files` dev build —
   // the default — must never pollute the registry, and only the four per-repo host emits
   // are ones `_EMIT_HOST_SCOPE` can map back to a row. Records `out`, where the marker is.
-  if (['opencode', 'claude', 'bob', 'copilot'].includes(args.emit)) registryRecord(markerDir);
+  if (['opencode', 'claude', 'bob', 'copilot', 'openclaude'].includes(args.emit)) {
+    registryRecord(markerDir);
+  }
   return 0;
 }

package/js/build/emit-claude.mjs

@@ -126,7 +126,7 @@ export function emitClaudeRender(cfg, job) {
   // settings.local.json; Bob documents no local variant, so its settings.json is ignored.
   if (scope === 'project') {
     const gi = path.join(cfgDir, '.gitignore');
-    const giLines = (host === 'claude' ? ['settings.local.json']
+    const giLines = (host === 'claude' || host === 'openclaude' ? ['settings.local.json']
       : host === 'bob' ? ['settings.json'] : [])
       .concat(['wiki.jsonc', 'agent-overrides.json']);
     if (!existsSync(gi)) {

package/js/build/generate.mjs

@@ -123,7 +123,7 @@ export function setupBuildArgs(theme, emit, out = null, root = null, footprint =
   posture = 'peer', mode = 'direct', doctrines = null, allPacks = PACK_ORDER,
   excludeRules = null) {
   const argv = ['--theme', theme, '--emit', emit];
-  if (!['opencode-global', 'claude-global', 'bob-global', 'copilot-global'].includes(emit)) {
+  if (!emit.endsWith('-global')) {
     if (out) argv.push('--out', out);
     if (root) argv.push('--root', root);
   }
@@ -158,6 +158,7 @@ export const DEFAULT_EMIT = new Map([
   ['claude global', 'claude-global'], ['claude project', 'claude'],
   ['bob global', 'bob-global'], ['bob project', 'bob'],
   ['copilot global', 'copilot-global'], ['copilot project', 'copilot'],
+  ['openclaude global', 'openclaude-global'], ['openclaude project', 'openclaude'],
 ]);
 
 /**

package/js/build/source.mjs

@@ -92,17 +92,18 @@ export function discoverNames(dir, first) {
  *
  * DELIBERATELY NOT `discoverNames('doctrines', 'craft')`. That helper `.sort()`s, so it
  * answers `craft, ops, process, rigor`; the constitution's order is a reading order —
- * write it (craft), prove it (rigor), run it (ops), ship it (process) — and no sort
- * produces it. Discovery still runs, but as a GATE rather than as the order: `js/build/render.mjs`
+ * write it (craft), prove it (rigor), run it (ops), ship it (process), then say it
+ * (comms) — and no sort produces it. comms is LAST because presenting the answer is the last
+ * act of any task, and because appending left every earlier pack's position untouched. Discovery still runs, but as a GATE rather than as the order: `js/build/render.mjs`
  * refuses to build when a pack file exists under `src/doctrines/` that is missing from this
- * array, so a fifth pack cannot be silently dropped from every install.
+ * array, so a sixth pack cannot be silently dropped from every install.
  *
  * It lives here, beside `makeCfg` and `discoverNames`, because every consumer (the cfg
  * default, the render loop, the `Active packs:` marker, the CLI flag, the wizard, the
  * doctor) already imports this module and this module imports nothing of theirs — the one
  * placement that cannot introduce a cycle.
  */
-export const PACK_ORDER = ['craft', 'rigor', 'ops', 'process'];
+export const PACK_ORDER = ['craft', 'rigor', 'ops', 'process', 'comms'];
 
 /**
  * Every doctrine rule address this checkout ships — `pack.n`, in render order.

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
@@ -100,7 +100,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 +225,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.

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);
 }