fix(#1821): stop copying dead hook scripts for Kilo and ZCode (hooksSurface:none)

Kilo and ZCode both declare `hooksSurface: 'none'` and have no plugin surface,
so the GSD installer staged lifecycle hook scripts (hooks/*.js, hooks/*.sh,
hooks/lib/) plus a `{"type":"commonjs"}` package.json marker into their config
dirs where nothing ever invokes them — dead weight (#1821).

The installer's two hook-copy guards at bin/install.js were still on the legacy
hardcoded runtime-name list and never excluded Kilo or ZCode. Add
`&& !isKilo && !isZcode` to both (isZcode added to the install() runtimeFlags
destructure).

OpenCode — which #1821 also named — is deliberately NOT excluded: since the
issue was filed, #1914 shipped a native OpenCode plugin (plugins/gsd-core.js)
that spawns those exact staged hooks via OpenCode's event bus and requires both
the hook scripts and the CommonJS package.json marker. Excluding OpenCode would
regress #1914, so its hooks stay live. The genuinely-dead cases are Kilo & ZCode.

- bin/install.js: add `&& !isKilo && !isZcode` to the hooks/dist copy guard and
  the hooks/lib copy guard; document the OpenCode-vs-Kilo/ZCode split.
- tests/install-minimal-hooks.test.cjs: regression test asserting Kilo and ZCode
  receive no gsd-*.js/.sh hooks or hooks/lib, while OpenCode keeps its hooks +
  #1914 plugin and Claude keeps its hooks (over-exclusion guard).
- tests/fixtures/golden-install-parity/{kilo,zcode}.json: drop the 21 hooks/*
  entries and the package.json marker they no longer receive (opencode unchanged).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

tests/install-minimal-hooks.test.cjs

@@ -54,6 +54,7 @@ const {
   EXPECTED_SH_HOOKS,
   EXPECTED_ALL_HOOKS,
   SKILL_RUNTIMES,
+  walk,
   simulateHookCopy,
   installerEnv,
   runMinimalInstall,
@@ -640,6 +641,82 @@ describe('#1755: .sh hooks are copied and executable after install', () => {
   });
 });
 
+// ─── #1821: Kilo/ZCode (hooksSurface:none, no plugin) receive no dead hooks ────
+//
+// #1821 reported dead hook scripts staged for runtimes with hooksSurface:'none'.
+// OpenCode ALSO declares hooksSurface:'none', but its #1914 native plugin adapter
+// (plugins/gsd-core.js) spawns the staged hooks/*.js via OpenCode's event bus —
+// so for OpenCode the hooks are LIVE and must keep being copied. Kilo and ZCode
+// have no plugin surface, so their staged hooks are genuinely dead: this is the
+// case the fix removes. These tests assert the split: Kilo/ZCode get no hooks;
+// OpenCode (and Claude) still do.
+
+describe('#1821: Kilo/ZCode receive no dead hook files; OpenCode/Claude keep their hooks', () => {
+  function gsdHookFilesUnder(configDir) {
+    const hooksDir = path.join(configDir, 'hooks');
+    if (!fs.existsSync(hooksDir)) return [];
+    return walk(hooksDir).filter((f) => {
+      const base = path.basename(f);
+      return /^gsd-.*\.(js|sh)$/.test(base);
+    });
+  }
+
+  function installAndCollect(runtime) {
+    const targetDir = fs.mkdtempSync(path.join(os.tmpdir(), `gsd-1821-${runtime}-`));
+    try {
+      const result = spawnSync(
+        process.execPath,
+        [INSTALL_SCRIPT, `--${runtime}`, '--global', '--config-dir', targetDir],
+        { encoding: 'utf8', env: installerEnv() },
+      );
+      assert.strictEqual(result.status, 0,
+        `installer exited with status ${result.status} for --${runtime} --global\nstdout: ${result.stdout}\nstderr: ${result.stderr}`);
+      // Collect results while targetDir still exists — cleanup() below removes it.
+      return {
+        hookFiles: gsdHookFilesUnder(targetDir),
+        hooksLibExists: fs.existsSync(path.join(targetDir, 'hooks', 'lib')),
+        pluginExists: fs.existsSync(path.join(targetDir, 'plugins', 'gsd-core.js')),
+      };
+    } finally {
+      cleanup(targetDir);
+    }
+  }
+
+  // Kilo and ZCode both declare hooksSurface:'none' with no plugin surface, so
+  // their staged hooks are dead weight (#1821).
+  for (const runtime of ['kilo', 'zcode']) {
+    test(`${runtime} --global install creates no gsd-*.js/.sh hook files or hooks/lib`, () => {
+      const { hookFiles, hooksLibExists } = installAndCollect(runtime);
+      assert.deepStrictEqual(hookFiles, [], `${runtime} install must not copy any gsd-*.js/.sh hook files, found: ${hookFiles.join(', ')}`);
+      assert.ok(!hooksLibExists, `${runtime} install must not create hooks/lib/`);
+    });
+  }
+
+  // Regression guard for #1914: OpenCode's plugin adapter spawns the staged
+  // hooks, so excluding OpenCode from the hook copy would break it. OpenCode
+  // must KEEP its hooks and receive the plugin.
+  test('opencode --global install still copies hooks and installs the #1914 plugin', () => {
+    const { hookFiles, pluginExists } = installAndCollect('opencode');
+    const basenames = hookFiles.map((f) => path.basename(f));
+    assert.ok(
+      basenames.includes('gsd-context-monitor.js'),
+      `opencode install must still copy gsd-*.js hooks (spawned by the #1914 plugin), found: ${basenames.join(', ')}`,
+    );
+    assert.ok(pluginExists, 'opencode install must install plugins/gsd-core.js (#1914 hook bridge)');
+  });
+
+  // Positive control: guards against over-exclusion breaking runtimes that
+  // legitimately need hooks (hooksSurface !== 'none').
+  test('claude --global install still copies gsd-*.js hooks', () => {
+    const { hookFiles } = installAndCollect('claude');
+    const basenames = hookFiles.map((f) => path.basename(f));
+    assert.ok(
+      basenames.includes('gsd-context-monitor.js'),
+      `claude install must still copy gsd-context-monitor.js, found: ${basenames.join(', ')}`,
+    );
+  });
+});
+
 // Migrated (#455): uses typed export GSD_UNINSTALL_HOOKS instead of
 // source-grep assertions on bin/install.js for the uninstall hook list tests.
 describe('install.js uninstall hooks registry (typed assertions)', () => {