geneseed 3.9.0 → 3.11.0

package/js/inspect/doctor.mjs

@@ -134,7 +134,7 @@ export function globalEmitProblems(themeName) {
 }
 
 /**
- * `_harness_build._claude_bob_emit_problems` — validate the claude/bob/copilot/openclaude PER-REPO
+ * `_harness_build._claude_bob_emit_problems` — validate the claude/bob/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', 'openclaude'], (tmp, label) => {
+  return emitProblemsOver(['claude', 'bob', '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/OpenClaude per-repo emit (${themeName})`, claudeBobEmitProblems(themeName)));
+        `Claude/Bob/OpenClaude per-repo emit (${themeName})`, claudeBobEmitProblems(themeName)));
     }
   });
   problems = problems.concat(ran('parity', 'Theme parity', themeParityProblems()));
@@ -283,7 +283,7 @@ export function cmdDoctor(args) {
       // (`js/build/generate.mjs`), which forwards `--theme` and nothing else. So the front door
       // answered `unrecognized arguments: --sync-themes` to anyone who followed doctor's own
       // advice, for as long as the premise went unchecked. The flag belongs to the GENERATOR,
-      // whose binary is `geneseed-build` — which is what `README.md` and `SETUP.md` have said
+      // whose binary is `geneseed-build` — which is what `README.md` and the install guide have said
       // all along. A hint is a command; if it is not runnable it is decoration.
       printOut('  tip: a theme is missing a key another theme defines — run '
         + '`geneseed-build --sync-themes` to fill it from _TEMPLATE.json, '

package/js/inspect/excludes.mjs

@@ -143,10 +143,6 @@ export function excludeAdd(target) {
         wired.bob_rules_stub = true;
       }
     }
-    if (host === 'copilot') {
-      messages.push('copilot: no native suppression exists — the global '
-        + 'copilot-instructions.md still loads there (documented limitation)');
-    }
     const entries = data.excludes.filter((e) => !(isDict(e) && same(get(e, 'path'), repo)));
     entries.push({ path: repo.split(path.sep).join('/'), wired });
     data.excludes = entries;

package/js/inspect/inventory.mjs

@@ -108,7 +108,7 @@ export const SKILL_CLASS = {
   // `understand` before, which made that class a grab-bag.
   wiki: 'harness', geneseed: 'harness', rule: 'harness', profile: 'harness',
   herdr: 'harness', 'skill-forge': 'harness', 'consolidate-memory': 'harness',
-  teach: 'learn', quiz: 'learn',
+  teach: 'learn', quiz: 'learn', 'learn-mode': 'learn',
 };
 
 /** `k in dict` — own keys only, where `k in obj` also finds `Object.prototype` members. */

package/js/inspect/registry.mjs

@@ -17,10 +17,10 @@ import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync } from 'n
 import path from 'node:path';
 import os from 'node:os';
 
-import { expanduser } from '../hosts/hosts.mjs';
+import { expanduser, resolvePath } from '../hosts/hosts.mjs';
 import { writeText, isFile, isDir } from '../lib/fs.mjs';
 import { parseJson, jsonDumpsIndent } from '../lib/json.mjs';
-import { toPlatformPath } from '../lib/paths.mjs';
+import { toPlatformPath, within } from '../lib/paths.mjs';
 
 /** `_install_registry._path()` — `$XDG_CONFIG_HOME/geneseed/installs.json`. */
 function registryPath() {
@@ -28,6 +28,21 @@ function registryPath() {
   return path.join(base, 'geneseed', 'installs.json');
 }
 
+/**
+ * Is `root` a scratch install — inside the OS temp dir while the registry is not?
+ *
+ * Agent sessions emit into scratchpads under `%TEMP%`; recorded, each one is rebuilt by every
+ * `rebuild-all` and listed by every `status` for as long as the folder survives. The second
+ * clause is what keeps every test and golden cell meaningful: their registry lives in a
+ * sandbox under the temp dir too, so their temp roots are not scratch RELATIVE TO IT.
+ * `within` is case-insensitive on win32, so `C:\Users\X\AppData\Local\Temp` and its
+ * lower-cased spelling are one directory.
+ */
+export function isScratchRoot(root, registryFile) {
+  const tmp = resolvePath(os.tmpdir());
+  return within(resolvePath(root), tmp) && !within(resolvePath(registryFile), tmp);
+}
+
 function registryLoad() {
   try {
     const data = parseJson(readFileSync(registryPath(), 'utf8'));
@@ -59,6 +74,7 @@ export function registryRecord(dir) {
   try {
     let root;
     try { root = realpathSync.native(dir); } catch { root = path.resolve(dir); }
+    if (isScratchRoot(root, registryPath())) return;
     const cur = registryLoad();
     if (!cur.includes(root)) registrySave([...cur, root]);
   } catch { /* a registry hiccup must never fail a build */ }
@@ -75,6 +91,7 @@ export function registryRecord(dir) {
  */
 export function registryRoots() {
   const original = registryLoad();
+  const file = registryPath();
   const out = [];
   const kept = [];
   const seen = new Set();
@@ -96,7 +113,7 @@ export function registryRoots() {
     let key;
     try { key = existsSync(root) ? realpathSync.native(root) : root; } catch { key = root; }
     if (seen.has(key)) continue;
-    if (isDir(root) && isFile(path.join(root, '.geneseed-emit'))) {
+    if (isDir(root) && isFile(path.join(root, '.geneseed-emit')) && !isScratchRoot(root, file)) {
       seen.add(key);
       kept.push(root);
       out.push(root);

package/js/inspect/status.mjs

@@ -61,7 +61,7 @@ import { THEMES, ROOT, makeCfg } from '../build/source.mjs';
 import { tuiInventory } from './inventory.mjs';
 import { readVersion, sourceFingerprint } from '../build/version.mjs';
 import {
-  claudeConfigDir, bobConfigDir, copilotConfigDir, openclaudeConfigDir, opencodeConfigDir,
+  claudeConfigDir, bobConfigDir, 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
@@ -73,6 +73,7 @@ import {
   defaultTheme, installedDefaults, installTargets, manifestIsClaude, readJsonMaybe, readMaybe,
 } from '../hosts/installs.mjs';
 import { installProfile, rebuildCommand } from '../build/generate.mjs';
+import { shimDead } from '../hosts/settings.mjs';
 import { printOut } from '../lib/fs.mjs';
 import { codePointLength, padEndToWidth } from '../lib/text.mjs';
 
@@ -99,9 +100,9 @@ export function cmdVersion(args) {
   let target = args.target ? resolvePath(args.target) : opencodeConfigDir();
   let installed = readVersion(target);
   if (installed === null) {
-    // A claude/bob/copilot-only machine must not report "no install detected". The bundle
+    // A claude/bob/openclaude-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(), openclaudeConfigDir(),
+    for (const base of [claudeConfigDir(), bobConfigDir(), openclaudeConfigDir(),
       path.join(process.cwd(), 'Harness'), process.cwd()]) {
       const v = readVersion(base);
       if (v) { installed = v; target = base; break; }
@@ -208,7 +209,9 @@ export function gateSummary(cfgDirs) {
       total += 1;
     }
   }
-  return { standing_down: standingDown, asks, total };
+  // `dead` is the machine shim's missing targets: every gate below is armed on paper and never
+  // runs, so it outranks `armed` in the row.
+  return { standing_down: standingDown, asks, total, dead: shimDead() };
 }
 
 /** `_harness_status._status_data`. */
@@ -226,7 +229,7 @@ export function statusData() {
   let installedFp = null;
   let verTarget = null;
   const otherCfg = [];
-  for (const fn of [claudeConfigDir, bobConfigDir, copilotConfigDir, openclaudeConfigDir]) {
+  for (const fn of [claudeConfigDir, bobConfigDir, 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.
@@ -350,7 +353,9 @@ export function statusLines(d, color = false) {
   // panels carry no `gates` key and must render unchanged.
   if (d.gates) {
     const g = d.gates;
-    const armed = g.standing_down.length
+    const armed = g.dead?.length
+      ? `DEAD — hook shim points at ${g.dead.join(', ')}; run: geneseed rebuild-all`
+      : g.standing_down.length
       ? `STANDING DOWN for this cwd (excludes.json in ${g.standing_down.join(', ')})`
       : 'armed';
     const byRule = Object.entries(g.asks).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))

package/js/lib/node-floor.mjs

@@ -0,0 +1,30 @@
+/**
+ * The Node floor — the FIRST import of all three binaries, so an old Node gets one sentence
+ * instead of a stack trace from whichever API it lacks.
+ *
+ * `engines` in package.json only makes npm warn, and `npx geneseed`, a global install and the
+ * hook shim all run the binaries directly. ESM links the whole graph before any body runs, so
+ * this only helps while every file still PARSES on the old Node; it runs before any of them
+ * executes. The hook exits 0: a hook must never block a tool call, and the message on stderr
+ * is what the host surfaces. Nothing here may print to stdout — the hook's decision channel.
+ */
+import path from 'node:path';
+
+export const NODE_FLOOR = '22.3.0';
+
+/** Numeric, not string, comparison: '22.10.0' is above '22.3.0'. */
+export function belowFloor(version, floor = NODE_FLOOR) {
+  const v = version.replace(/^v/, '').split('.').map(Number);
+  const f = floor.split('.').map(Number);
+  for (let i = 0; i < 3; i += 1) {
+    if ((v[i] || 0) !== f[i]) return (v[i] || 0) < f[i];
+  }
+  return false;
+}
+
+if (belowFloor(process.versions.node)) {
+  process.stderr.write(`geneseed needs Node 22.3 or newer; this is Node ${process.versions.node}. `
+    + 'Install a current Node from https://nodejs.org (or your package manager), then run the '
+    + 'command again.\n');
+  process.exit(path.basename(process.argv[1] || '').startsWith('geneseed-hook') ? 0 : 1);
+}

package/js/maintain/migrate.mjs

@@ -52,11 +52,11 @@ const KNOWN_EMITS = new Set(EMIT_HOST_SCOPE.keys());
 /**
  * The settings file a host wires hooks into, or null for a host that has none.
  *
- * Only Claude and Bob carry hook commands. OpenCode's hooks are a PLUGIN (`js/hosts/opencode.mjs`
- * emits JS that runs in the host's own process and names neither the shim nor `harness.py`),
- * and Copilot has no hook mechanism at all. So those two classify as `none` and their whole
- * migration is the re-emit — which is the same re-emit, in the same change, on all three
- * hosts, which is what the project's host-parity rule asks for.
+ * Only the Claude-style hosts carry hook commands. OpenCode's hooks are a PLUGIN
+ * (`js/hosts/opencode.mjs` emits JS that runs in the host's own process and names neither the
+ * shim nor `harness.py`), so it classifies as `none` and its whole migration is the re-emit —
+ * the same re-emit, in the same change, on every host, which is what the project's
+ * host-parity rule asks for.
  */
 function hookSettingsFile(root, host, scope) {
   if (!['claude', 'bob', 'openclaude'].includes(host)) return null;

package/js/maintain/setup.mjs

@@ -50,9 +50,10 @@ import { discoverNames, PACK_ORDER } from '../build/source.mjs';
 import { exportImprovements } from '../inspect/diff.mjs';
 import { cmdDoctor } from '../inspect/doctor.mjs';
 import { setupBuildArgs } from '../build/generate.mjs';
-import { GLOBAL_MANIFEST, opencodeConfigDir } from '../hosts/hosts.mjs';
+import { GLOBAL_MANIFEST, HOSTS, opencodeConfigDir } from '../hosts/hosts.mjs';
 import {
-  defaultMode, defaultPosture, defaultTheme, installedDefaults, themeFiles,
+  claudeCfg, defaultMode, defaultPosture, defaultTheme, EMIT_HOST_SCOPE, installedDefaults,
+  readJsonMaybe, themeFiles,
 } from '../hosts/installs.mjs';
 import { printOut, printErr } from '../lib/fs.mjs';
 import { which } from '../lib/paths.mjs';
@@ -280,7 +281,7 @@ export function doctrineOptions() {
 /**
  * `_harness_setup.EMIT_OPTIONS`.
  *
- * Exported since P6b: `/api/themes` returns the same eleven as its `emits` list, and a copy
+ * Exported since P6b: `/api/themes` returns the same nine as its `emits` list, and a copy
  * of a table under test silently stops being the table under test.
  */
 export const EMIT_OPTIONS = [
@@ -290,8 +291,6 @@ export const EMIT_OPTIONS = [
   ['claude', 'Per-repo CLAUDE.md + .claude/ committed into one repository.'],
   ['bob-global', 'IBM Bob global config dir (~/.bob) — rules/geneseed.md, agents, skills, settings.json.'],
   ['bob', 'Per-repo AGENTS.md + .bob/ for IBM Bob, committed into one repository.'],
-  ['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.
@@ -377,10 +376,10 @@ export function collectSetupLines() {
     inst.footprint || 'lean');
   let out = null;
   let root = null;
-  // Every PROJECT emit needs the repo root — claude/bob/copilot included: without `--out`
+  // Every PROJECT emit needs the repo root — claude/bob/openclaude included: without `--out`
   // their CLAUDE.md/.claude land in the generator's default ./Harness, where the host never
   // looks.
-  if (['opencode', 'claude', 'bob', 'copilot', 'openclaude'].includes(emit)) {
+  if (['opencode', 'claude', 'bob', 'openclaude'].includes(emit)) {
     root = ask('Repo root to install into', '.');
     out = root;
   } else if (emit === 'files') {
@@ -459,39 +458,77 @@ export function lspPrereqs() {
     + "SDKMAN `sdk install java 21-tem`, or your distro's package"]];
 }
 
+/** The name each host goes by on screen — the same four labels `hostTools` prints. */
+const TOOL_NAME = {
+  opencode: 'OpenCode', claude: 'Claude Code', bob: 'IBM Bob', openclaude: 'OpenClaude',
+};
+
+/**
+ * Where an emit put its root file, and — for the Claude-shaped hosts — its hooks.
+ *
+ * READ BACK, NOT RE-SPELLED: the placements differ by host and scope (Bob global's preamble is
+ * `rules/geneseed.md`, a Claude project's CLAUDE.md sits beside `.claude/`, a project's hooks go
+ * to `settings.local.json`, Bob global's to `settings/settings.json`), and the emit already
+ * records each one in the install's manifest (`managed.claude_md`, `settings_file`,
+ * `settings_hooks`). A summary that recomputed them would be a second owner of every rule.
+ */
+function emitFacts(emit, out) {
+  const [host, scope] = EMIT_HOST_SCOPE.get(emit) ?? ['files', 'project'];
+  if (host === 'files' || host === 'opencode') {
+    const dir = emit === 'opencode-global' ? opencodeConfigDir() : resolveOut(out || 'Harness');
+    return { host, rootFile: path.join(dir, 'AGENT.md') };
+  }
+  const spec = HOSTS.find((h) => h.host === host);
+  const cfg = claudeCfg(scope === 'global' ? spec.configDir() : resolveOut(out || '.'), scope, host);
+  const managed = readJsonMaybe(path.join(cfg, GLOBAL_MANIFEST))?.managed ?? {};
+  const rootFile = managed.claude_md?.rel
+    ? path.resolve(cfg, managed.claude_md.rel)
+    : path.join(cfg, host === 'bob' ? path.join('rules', 'geneseed.md') : spec.agentFile);
+  return {
+    host,
+    rootFile,
+    settings: managed.settings_file ? path.join(cfg, managed.settings_file) : null,
+    hookGroups: Array.isArray(managed.settings_hooks) ? managed.settings_hooks.length : 0,
+  };
+}
+
 /**
  * `_harness_setup._setup_summary_lines` — the post-build report as `[kind, text]` rows,
  * `kind` being ok | warn | info.
  *
  * `ok` is the build's own success, so the first row is the only one that can say "build
- * failed"; every later row assumes a tree on disk. The global-install warning is the row
- * with real behaviour in it: a bundle or project emit made while an OpenCode GLOBAL install
- * exists is loaded by nothing, and saying so is the difference between a wizard and a form.
+ * failed"; every later row assumes a tree on disk. HOST-AWARE since the install-hardening
+ * pass: it used to know only OpenCode's AGENT.md, so a successful claude-global install ended
+ * on "expected AGENT.md … but it is not there" and "start a NEW OpenCode session". The
+ * global-install warning is the row with real behaviour in it: a bundle or project emit made
+ * while an OpenCode GLOBAL install exists is loaded by nothing, and saying so is the
+ * difference between a wizard and a form.
  */
 export function setupSummaryLines(theme, emit, out, root, ok) {
-  const agentMd = emit === 'opencode-global'
-    ? path.join(opencodeConfigDir(), 'AGENT.md')
-    : path.join(resolveOut(out || 'Harness'), 'AGENT.md');
+  const f = emitFacts(emit, out ?? root);
+  const name = path.basename(f.rootFile);
   const lines = [];
-  if (ok && existsSync(agentMd)) {
-    lines.push(['ok', `AGENT.md written to ${agentMd}`]);
+  if (ok && existsSync(f.rootFile)) {
+    lines.push(['ok', `${name} written to ${f.rootFile}`]);
   } else if (ok) {
-    lines.push(['warn', `expected AGENT.md at ${agentMd} but it is not there`]);
+    lines.push(['warn', `expected ${name} at ${f.rootFile} but it is not there`]);
   } else {
     lines.push(['warn', 'build failed — see the output above']);
   }
-  if (emit === 'opencode-global') {
-    const cfgDir = opencodeConfigDir();
-    const hint = process.platform === 'win32'
-      ? `learn plugin: $env:GENESEED_HARNESS = "${cfgDir}"  (persist: setx GENESEED_HARNESS "${cfgDir}")`
-      : 'learn plugin: export GENESEED_HARNESS="$HOME/.config/opencode"';
-    lines.push(['info', hint]);
-  } else if (emit === 'files') {
-    lines.push(['info', `point your tool's instructions at ${agentMd}`]);
+  if (ok && f.settings) {
+    lines.push(['ok', `${f.hookGroups} hook groups wired in ${f.settings}`]);
+    if (!process.env.GENESEED_LLM) {
+      lines.push(['info', 'memory learning is off until you set GENESEED_LLM '
+        + '(see docs/reference/environment.md)']);
+    }
+  }
+  if (emit === 'files') {
+    lines.push(['info', `point your tool's instructions at ${f.rootFile}`]);
   }
   try {
     const cfg = opencodeConfigDir();
-    if (emit !== 'opencode-global' && existsSync(path.join(cfg, GLOBAL_MANIFEST))) {
+    // Only for an emit OpenCode itself would load — a Claude or Bob install is not shadowed.
+    if (['opencode', 'files'].includes(emit) && existsSync(path.join(cfg, GLOBAL_MANIFEST))) {
       lines.push(['warn', `a global install exists at ${cfg} — OpenCode loads THAT, `
         + `not this build; re-run with 'opencode-global' to change it`]);
     }
@@ -502,7 +539,12 @@ export function setupSummaryLines(theme, emit, out, root, ok) {
       lines.push(present ? ['ok', `${label} present`] : ['warn', `${label} missing — ${hint}`]);
     }
   }
-  lines.push(['info', `theme is now '${theme}' — start a NEW OpenCode session for the new voice`]);
+  const tool = TOOL_NAME[f.host];
+  lines.push(['info', tool
+    ? `theme is now '${theme}' — start a NEW ${tool} session to load it`
+    : `theme is now '${theme}' — start a NEW session in your tool to load it`]);
+  lines.push(['info', 'what was installed and what each piece does: '
+    + 'https://github.com/Arylmera/Geneseed/blob/main/docs/understand/on-your-machine.md']);
   return lines;
 }
 
@@ -595,5 +637,49 @@ export function cmdSetup() {
       + '  geneseed build --emit opencode-global --theme neutral\n');
     return 1;
   }
+  if (!toolsReport()) return 1;
   return setupLines();
 }
+
+/**
+ * The AI coding tools Geneseed installs into, as `[label, present, url]` rows in HOSTS order.
+ *
+ * PRESENT MEANS THE COMMAND IS ON PATH, and nothing else. The config dir looked like a second
+ * signal — a desktop-only install has one and no command — but GENESEED ITSELF CREATES IT: a
+ * `bob-global` emit writes `~/.bob` on a machine that never had Bob, and the first run of this
+ * check reported Bob present on exactly such a machine. A wrong "ok" sends the user to an
+ * install mode for a tool they cannot open; a wrong "not found" costs one line they can ignore.
+ *
+ * NO SPAWN, deliberately. `which` walks PATH by hand, so asking costs nothing on the CLI's
+ * child_process allow-list — a `claude --version` probe would have been a third entry there to
+ * learn nothing `which` does not already say. `lookup` is the seam for the test, which cannot
+ * rely on what this machine happens to have installed.
+ */
+export function hostTools({ lookup = which } = {}) {
+  return [
+    ['OpenCode', 'opencode', 'https://opencode.ai/docs/'],
+    ['Claude Code', 'claude', 'https://code.claude.com/docs/en/setup'],
+    ['IBM Bob', 'bob', 'https://bob.ibm.com/'],
+    ['OpenClaude', 'openclaude', 'https://openclaude.gitlawb.com/'],
+  ].map(([label, cmd, url]) => [label, Boolean(lookup(cmd)), url]);
+}
+
+/**
+ * Show which tools are here before asking anything — the install-mode question is easier to
+ * answer knowing it — and when NONE is, ask whether to stop and install one first. It never
+ * installs one: on a managed machine that is IT's call, and each tool has its own installer.
+ * A missing tool among several present is a line, not a question; nobody needs all four.
+ * `false` is the user choosing to stop.
+ */
+export function toolsReport(tools = hostTools()) {
+  printOut('AI coding tools on this machine:\n');
+  for (const [label, present, url] of tools) {
+    printOut(present ? `  ok  ${label}\n` : `  --  ${label} not on PATH — install: ${url}\n`);
+  }
+  if (tools.some(([, present]) => present)) { printOut('\n'); return true; }
+  printOut('\nNone of them is installed. Install the one you use (links above), then run setup '
+    + 'again — or go on and pick the plain bundle, which any AGENT.md tool can read.\n');
+  if (confirm('Continue without one?', false)) { printOut('\n'); return true; }
+  printOut('Stopped. Run setup again once a tool is installed.\n');
+  return false;
+}

package/js/maintain/uninstall.mjs

@@ -59,10 +59,9 @@ import {
 } from '../hosts/hosts.mjs';
 import { mcpCommented } from '../hosts/mcp.mjs';
 import {
-  copilotIntegrityCheck, managedBlockRead, managedBlockRemove, managedBlockWrite,
+  managedBlockRead, managedBlockRemove, managedBlockWrite,
   mergeClaudeSettings, opencodeTarget, readJsonc,
   settingsIntegrityCheck, wireClaudeExcludes, unwireClaudeExcludes, unwireClaudeSettings,
-  unwireCopilotSettings,
 } from '../hosts/settings.mjs';
 import { printOut, printErr, readText, writeText, isFile, isDir, isOsError } from '../lib/fs.mjs';
 import { indexOfDeepEqual, jsonDumps, jsonDumpsIndent, deepEquals } from '../lib/json.mjs';
@@ -71,7 +70,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', 'openclaude'];
+const CLAUDE_STYLE = ['claude', 'bob', 'openclaude'];
 
 /**
  * `shutil.rmtree(p, ignore_errors=True)`.
@@ -295,12 +294,8 @@ export function claudeUninstall(cfg, archiveMemory) {
   if (failed.length) warnSurvivors(failed);
   const hooks = managed.settings_hooks || [];
   const sf = settingsFile(cfg, managed);
-  // Two shapes, two unwires: a Copilot install records `copilot_hooks` (event → one hook)
-  // and never `settings_hooks`, so exactly one of these does anything.
-  const unwired = unwireClaudeSettings(sf, hooks)
-    | unwireCopilotSettings(sf, managed.copilot_hooks || []);
+  const unwired = unwireClaudeSettings(sf, hooks);
   unwireClaudeExcludes(sf, managed.settings_excludes || []);
-  copilotIntegrityCheck(sf, managed.copilot_hooks || [], 'absent');
   // The unwire is VERIFIED, not assumed: a commented settings file is never rewritten, so a
   // supposedly-uninstalled repo could keep firing Geneseed's hooks. Loud, never fatal.
   settingsIntegrityCheck(sf, managed, 'absent');
@@ -320,7 +315,7 @@ export function claudeUninstall(cfg, archiveMemory) {
 /**
  * `_harness_mcp._uninstall_global` — reverse a global install at `target` via its manifest.
  *
- * Host-aware at the top, and that dispatch is the whole reason a Claude/Bob/Copilot global
+ * Host-aware at the top, and that dispatch is the whole reason a Claude/Bob/OpenClaude global
  * install and an OpenCode one can share one entry point: the Claude family has no
  * opencode.json to unmerge and a settings.json plus a managed block instead.
  */
@@ -681,7 +676,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/.openclaude) or --target <config dir> for a global one.\n');
+      + '.bob/.openclaude) or --target <config dir> for a global one.\n');
     return 1;
   }
   const [host, scope, root] = hit;
@@ -695,12 +690,7 @@ export function cmdUninstall(args) {
   const data = installDataDir(root, host, scope);
   const stores = ['memory', 'notebook'].filter((n) => isDir(path.join(data, n)));
   printOut(`[uninstall] target: ${root} (${host}:${scope})\n`);
-  if (host === 'copilot') {
-    printOut('[uninstall] removes: agents/, skills/, markers, the '
-      + `${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 (['claude', 'bob', 'openclaude'].includes(host)) {
+  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');
@@ -1024,7 +1014,7 @@ export function installReactivate(root, host = 'opencode', scope = 'global') {
   return { ok: true, kind, moved };
 }
 
-// ---- the Claude-style fork (Claude · IBM Bob · GitHub Copilot) ---------------------------
+// ---- the Claude-style fork (Claude · IBM Bob · OpenClaude) ---------------------------
 //
 // A Claude-style install has NO `instructions` array — the harness reaches the host through
 // the CLAUDE.md managed block and the settings.json hooks. So the reversal is three moving
@@ -1057,27 +1047,6 @@ function cleanHostStash(cfg, host = 'claude') {
 function remergeClaudeHooks(cfg, root = cfg, host = 'claude') {
   const data = claudeReadManifest(cfg);
   const managed = managedOf(data);
-  // A LEGACY Copilot install (single-slot `copilot_hooks`, the dead `toolCall` event):
-  // reactivating it re-wires the CURRENT Copilot shape — event → array, recorded under
-  // `settings_hooks` — rather than restoring hooks Copilot no longer reads. None of the
-  // pack/exclude axes below apply: the Copilot gate is not pack-conditional.
-  if (Array.isArray(managed.copilot_hooks)) {
-    const sf = settingsFile(cfg, managed);
-    unwireCopilotSettings(sf, managed.copilot_hooks);
-    const [, claims] = mergeClaudeSettings(sf, 'global', null, hookRunnerEntry(), null, [],
-      'copilot', cfg);
-    if (Object.keys(data).length > 0) {
-      delete managed.copilot_hooks;
-      managed.settings_hooks = claims;
-      data.managed = managed;
-      const tmp = path.join(cfg, `${GLOBAL_MANIFEST}.tmp`);
-      try {
-        writeText(tmp, `${jsonDumpsIndent(data)}\n`);
-        renameSync(tmp, path.join(cfg, GLOBAL_MANIFEST));
-      } catch { /* except OSError: pass */ }
-    }
-    return;
-  }
   // `hookOpts` is the one argument `mergeClaudeSettings` will not default, and it is right
   // not to: there is no computable fallback for the runner/entry the shim bakes. The
   // emitter's own originator is imported rather than restated — a reactivate that wired a
@@ -1090,8 +1059,7 @@ function remergeClaudeHooks(cfg, root = cfg, host = 'claude') {
   // PROJECT install `cfg` is `<repo>/.claude` and the carrier is `<repo>/CLAUDE.md`, so
   // reading `cfg` alone answered `null` for every project reactivate and re-wired the gate
   // unconditionally (fail-closed, so not a hole — but wrong, and it made the toggle one-way
-  // for project installs). `root` first, `cfg` second: copilot keeps its carrier INSIDE the
-  // config dir (`.github/copilot-instructions.md`), and on a global install the two are the
+  // for project installs). `root` first, `cfg` second: on a global install the two are the
   // same directory anyway. Both silent ⇒ `null` ⇒ the gate stays.
   const doctrines = doctrinesOfDir(root) ?? doctrinesOfDir(cfg);
   // Same two-carrier read for the second axis, and its own default: an absent line means
@@ -1134,12 +1102,10 @@ function claudeDeactivate(root, scope = 'global', host = 'claude') {
     return { ok: false, failed, rolled_back: done.length };
   }
   unwireClaudeSettings(settingsFile(cfg, managed), managed.settings_hooks || []);
-  unwireCopilotSettings(settingsFile(cfg, managed), managed.copilot_hooks || []);
   unwireClaudeExcludes(settingsFile(cfg, managed), managed.settings_excludes || []);
   // The same integrity check the uninstall path runs: a deactivate that silently failed to
   // unwire would leave hooks firing in a repo the user believes is off.
   settingsIntegrityCheck(settingsFile(cfg, managed), managed, 'absent');
-  copilotIntegrityCheck(settingsFile(cfg, managed), managed.copilot_hooks || [], 'absent');
   const cm = claudeMdPath(cfg, managed);
   const block = managedBlockRead(cm);
   mkdirSync(stash, { recursive: true });   // presence == disabled, even if nothing moved

package/js/maintain/update.mjs

@@ -50,7 +50,7 @@ import { appendText, copyFile, printOut, printErr, readText, writeText } from '.
 import { toPlatformPath, which } from '../lib/paths.mjs';
 import { WHITESPACE, parseIntStrict, stripWhitespace } from '../lib/text.mjs';
 import { NO_WINDOW } from '../lib/proc.mjs';
-import { restartDaemon } from '../web/daemon.mjs';
+import { bounceDaemonIfRunning } from '../web/daemon.mjs';
 
 /**
  * `_CREDS_RE` / `_redact_url_creds` — strip a `user[:token]@` userinfo out of any URL in
@@ -578,20 +578,9 @@ export async function rebuildBundle(here, out, theme, emit, rootDir, log) {
     { cwd: String(here), stdio: 'inherit' });
   if (proc.status !== 0) return proc.status === null ? 1 : proc.status;
   // If a web daemon is running, bounce it so the new source and the freshly rebuilt web/dist
-  // take effect — otherwise the open PWA keeps hitting the old code. EXCEPT when this
-  // upgrade IS a web-daemon job: restarting the daemon here kills the process tracking this
-  // very job (console stuck on 'running' forever); in that case the server restarts itself
-  // once the job is recorded as finished. `js/web/jobs.mjs` sets the variable; this is the
-  // side that reads it, and `upgrade/the-web-job-marker-...` is what gates the pair.
-  if (process.env.GENESEED_WEB_JOB) {
-    log('[geneseed] web daemon will restart itself after this job to load the new code.');
-    return 0;
-  }
-  try {
-    await restartDaemon(theme, 4747, false, true);
-  } catch (e) {                       // never fail an upgrade on this
-    log(`[geneseed] ⚠️  could not refresh the web daemon (${e && e.message ? e.message : e}) — \`geneseed web restart\` manually if it was running.`);
-  }
+  // take effect — otherwise the open PWA keeps hitting the old code. The web-job exception
+  // (`upgrade/the-web-job-marker-...` gates it) lives with the helper.
+  await bounceDaemonIfRunning(theme, log);
   return 0;
 }
 

package/js/ui/cli.mjs

@@ -69,7 +69,7 @@ function load() {
   try {
     return JSON.parse(readFileSync(CLI_JSON, 'utf-8'));
   } catch {
-    return { prog: 'harness', commands: [] };
+    return { prog: 'geneseed', commands: [] };
   }
 }
 
@@ -88,7 +88,7 @@ const pageArgs = (args) => (args ?? [])
 export function cliReference() {
   const data = load();
   return {
-    prog: data.prog ?? 'harness',
+    prog: data.prog ?? 'geneseed',
     commands: (data.commands ?? []).map((c) => ({
       name: c.name ?? '',
       help: c.help ?? '',