@evomap/evolver 1.89.20 → 2.0.0-beta.0

package/src/adapters/hookAdapter.js

@@ -1,469 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const PLATFORMS = {
-  cursor: { name: 'Cursor', configDir: '.cursor', detector: '.cursor' },
-  'claude-code': { name: 'Claude Code', configDir: '.claude', detector: '.claude' },
-  codex: { name: 'Codex', configDir: '.codex', detector: '.codex' },
-  kiro: { name: 'Kiro', configDir: '.kiro', detector: '.kiro' },
-  opencode: { name: 'opencode', configDir: '.opencode', detector: '.opencode' },
-};
-
-// Detect the host agent from runtime environment signals, which are far more
-// reliable than scanning for `.claude` / `.cursor` directories when both exist
-// on disk (e.g. under $HOME). Precedence when signals conflict (#590):
-//   1. strong Claude Code signals (set only by the Claude Code runtime)
-//   2. Cursor signals
-//   3. Codex signals
-//   4. CLAUDE_PROJECT_DIR — a weak Claude alias some hosts (incl. Cursor's
-//      Claude integration) export, so it loses to explicit Cursor signals.
-function detectPlatformFromEnv(env = process.env) {
-  const hasStrongClaudeSignal = env.CLAUDECODE || env.CLAUDE_CODE_ENTRYPOINT;
-  if (hasStrongClaudeSignal) {
-    return 'claude-code';
-  }
-
-  const hasCursorSignal =
-    env.CURSOR_TRACE_ID ||
-    env.CURSOR_SESSION_ID ||
-    env.CURSOR_PROJECT_DIR ||
-    env.CURSOR_AGENT ||
-    String(env.TERM_PROGRAM || '').toLowerCase() === 'cursor';
-  if (hasCursorSignal) {
-    return 'cursor';
-  }
-  const hasCodexSignal =
-    env.CODEX_THREAD_ID ||
-    env.CODEX_SHELL ||
-    env.CODEX_CI ||
-    env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE;
-  if (hasCodexSignal) {
-    return 'codex';
-  }
-  if (env.CLAUDE_PROJECT_DIR) {
-    return 'claude-code';
-  }
-  return null;
-}
-
-function detectPlatform(cwd) {
-  const envPlatform = detectPlatformFromEnv();
-  if (envPlatform) return envPlatform;
-
-  const root = cwd || process.cwd();
-  const home = os.homedir();
-  for (const [id, meta] of Object.entries(PLATFORMS)) {
-    if (fs.existsSync(path.join(root, meta.detector))) return id;
-  }
-  for (const [id, meta] of Object.entries(PLATFORMS)) {
-    if (fs.existsSync(path.join(home, meta.detector))) return id;
-  }
-  return null;
-}
-
-// Quote `value` as a single shell argument for the host that runs hook
-// `command` strings (POSIX sh, or cmd.exe on Windows).
-function shellQuoteForHost(value) {
-  const raw = String(value);
-  if (process.platform === 'win32') {
-    return `"${raw.replace(/"/g, '\\"')}"`;
-  }
-  return `'${raw.replace(/'/g, "'\\''")}'`;
-}
-
-// Build a hook `command` that runs `scriptPath` with node WITHOUT exposing the
-// path bytes to the shell. The absolute path is base64-encoded into a `node -e`
-// wrapper that decodes it and spawns the real script with `shell:false`, so
-// spaces / `$()` / backticks / `%VAR%` in the path can never be expanded by sh
-// or cmd.exe (#590). The plaintext basename is appended as a final, inert arg
-// so uninstall/reinstall can still match evolver-owned hooks by command
-// substring (see isEvolverHookCommand) even though the path itself is encoded.
-//
-// Shared across adapters so there is exactly one implementation to audit.
-function buildSafeNodeHookCommand(scriptPath) {
-  const encodedPath = Buffer.from(String(scriptPath), 'utf8').toString('base64');
-  const js = [
-    "const{spawnSync}=require('child_process')",
-    `const p=Buffer.from('${encodedPath}','base64').toString('utf8')`,
-    "const r=spawnSync(process.execPath,[p],{stdio:'inherit',shell:false})",
-    "if(r.error){console.error(r.error.message||String(r.error));process.exit(1)}",
-    "process.exit(r.status==null?1:r.status)",
-  ].join(';');
-  return `node -e ${shellQuoteForHost(js)} ${path.basename(scriptPath)}`;
-}
-
-function resolveConfigRoot(platformId, cwd) {
-  const root = cwd || process.cwd();
-  const home = os.homedir();
-  const meta = PLATFORMS[platformId];
-  if (!meta) return null;
-  if (fs.existsSync(path.join(root, meta.detector))) return root;
-  if (fs.existsSync(path.join(home, meta.detector))) return home;
-  return root;
-}
-
-function loadAdapter(platformId) {
-  switch (platformId) {
-    case 'cursor': return require('./cursor');
-    case 'claude-code': return require('./claudeCode');
-    case 'codex': return require('./codex');
-    case 'kiro': return require('./kiro');
-    case 'opencode': return require('./opencode');
-    default: return null;
-  }
-}
-
-function mergeJsonFile(filePath, patch, { markerKey = '_evolver_managed' } = {}) {
-  let existing = {};
-  try {
-    if (fs.existsSync(filePath)) {
-      const raw = fs.readFileSync(filePath, 'utf8').trim();
-      if (raw) existing = JSON.parse(raw);
-    }
-  } catch { /* start fresh */ }
-  const merged = mergeWithHooksUnion(existing, patch);
-  merged[markerKey] = true;
-  const tmp = filePath + '.tmp';
-  fs.writeFileSync(tmp, JSON.stringify(merged, null, 2) + '\n', 'utf8');
-  fs.renameSync(tmp, filePath);
-  return merged;
-}
-
-// Like deepMerge, but for `hooks.<event>` arrays specifically: instead of
-// replacing the user's existing entries, keep them and append/refresh evolver-
-// owned entries (matched by command containing `evolver-session/-signal`).
-// This preserves user-installed Stop/SessionStart hooks (#539) while still
-// updating evolver hooks across reinstalls.
-function mergeWithHooksUnion(target, source) {
-  const result = deepMerge(target, source);
-  if (
-    target && target.hooks && typeof target.hooks === 'object' &&
-    source && source.hooks && typeof source.hooks === 'object'
-  ) {
-    for (const event of Object.keys(source.hooks)) {
-      const tArr = Array.isArray(target.hooks[event]) ? target.hooks[event] : null;
-      const sArr = Array.isArray(source.hooks[event]) ? source.hooks[event] : null;
-      if (tArr && sArr) {
-        const userEntries = tArr
-          .map(stripEvolverCommands)
-          .filter(Boolean);
-        result.hooks[event] = [...userEntries, ...sArr];
-      }
-    }
-  }
-  return result;
-}
-
-function stripEvolverCommands(entry) {
-  if (!entry || typeof entry !== 'object') return entry;
-  if (typeof entry.command === 'string' && isEvolverHookCommand(entry.command)) {
-    return null;
-  }
-  if (!Array.isArray(entry.hooks)) return entry;
-
-  const hooks = entry.hooks.filter(h => {
-    const cmd = h && h.command;
-    return !(typeof cmd === 'string' && isEvolverHookCommand(cmd));
-  });
-  if (hooks.length === 0) return null;
-  if (hooks.length === entry.hooks.length) return entry;
-  return { ...entry, hooks };
-}
-
-// Pull all `command` strings out of an event entry, supporting both flat
-// shape (Codex: `{type, command}`) and Claude Code matcher shape
-// (`{matcher, hooks: [{type, command}]}`). Returns [] when neither applies.
-function collectCommands(entry) {
-  if (!entry || typeof entry !== 'object') return [];
-  const out = [];
-  if (typeof entry.command === 'string') out.push(entry.command);
-  if (Array.isArray(entry.hooks)) {
-    for (const h of entry.hooks) {
-      if (h && typeof h.command === 'string') out.push(h.command);
-    }
-  }
-  return out;
-}
-
-function isEvolverHookCommand(command) {
-  if (typeof command !== 'string') return false;
-  return command.includes('evolver-session') ||
-    command.includes('evolver-signal') ||
-    command.includes('evolver-task-recall') ||
-    // Legacy installs briefly shipped this companion daemon hook. Treat it
-    // as evolver-owned so reinstall/merge can remove it instead of preserving
-    // a stale supervisor that may point clients at a dead proxy.
-    command.includes('evolver-daemon-start');
-}
-
-function deepMerge(target, source) {
-  const result = { ...target };
-  for (const key of Object.keys(source)) {
-    if (
-      source[key] && typeof source[key] === 'object' && !Array.isArray(source[key]) &&
-      result[key] && typeof result[key] === 'object' && !Array.isArray(result[key])
-    ) {
-      result[key] = deepMerge(result[key], source[key]);
-    } else {
-      result[key] = source[key];
-    }
-  }
-  return result;
-}
-
-// Refuse to write/read through a symbolic link at the adapter's
-// platform config dir (`<root>/.codex`, `<root>/.claude`, …) or any
-// nested adapter-owned subdir (`hooks/`, `plugins/`, …). A
-// repository-controlled symlink at any of these paths would let
-// install/uninstall writes land on attacker-chosen files outside the
-// workspace (PR #94 round-4 surfaced the top-level case; round-5
-// surfaced that a hostile repo can keep `.codex` real and only
-// symlink `.codex/hooks`). Missing dirs are fine — install will
-// create them.
-function assertSafeConfigDir(dir, label, { subdirs = [] } = {}) {
-  assertNotSymlink(dir, label || 'config dir');
-  for (const sub of subdirs) {
-    assertNotSymlink(path.join(dir, sub), `${label || 'config dir'}/${sub}`);
-  }
-}
-
-function assertNotSymlink(p, label) {
-  let st;
-  try {
-    st = fs.lstatSync(p);
-  } catch (e) {
-    if (e && e.code === 'ENOENT') return;
-    throw e;
-  }
-  if (st.isSymbolicLink()) {
-    throw new Error(
-      `[setup-hooks] Refusing to operate: ${label} ${p} is a ` +
-      `symbolic link. evolver will not follow symlinks for ` +
-      `adapter-owned dirs — a hostile workspace could redirect ` +
-      `writes/unlinks outside the project root. Replace it with a ` +
-      `real directory and rerun.`
-    );
-  }
-}
-
-function copyHookScripts(destDir, evolverRoot) {
-  const scriptsDir = path.join(evolverRoot || __dirname, 'scripts');
-  // Every helper required by the entry-point hooks via `require('./_xxx')`
-  // resolves relative to the *destination* (`__dirname` after copy), so
-  // every such helper MUST appear here or the hook crashes with
-  // MODULE_NOT_FOUND at runtime. Two regressions of this shape have shipped
-  // already:
-  //   - PR #94 review caught `_runtimePaths.js` missing from this list.
-  //   - Issue #547 (rendigua, v1.87.0): `_memoryFiltering.js` was added to
-  //     evolver-session-start.js but not here, so fresh installs failed
-  //     immediately on `node .codex/hooks/evolver-session-start.js`.
-  // To keep future helpers from re-living this, the regression test in
-  // test/adapters.test.js scans every `require('./_*')` in the source
-  // adapter scripts and asserts the target file is in this list.
-  const scripts = [
-    '_runtimePaths.js',
-    '_memoryFiltering.js',
-    '_lockPaths.js',
-    'evolver-session-start.js',
-    'evolver-signal-detect.js',
-    'evolver-session-end.js',
-    'evolver-task-recall.js',
-  ];
-  fs.mkdirSync(destDir, { recursive: true });
-  const copied = [];
-  for (const name of scripts) {
-    const src = path.join(scriptsDir, name);
-    const dest = path.join(destDir, name);
-    if (!fs.existsSync(src)) {
-      console.warn(`[setup-hooks] Warning: script not found: ${src}`);
-      continue;
-    }
-    // PR #94 round-6 HIGH: reject if the destination is a pre-planted
-    // symlink. fs.copyFileSync follows symlinks at the destination, so
-    // a hostile repo that pre-creates `.codex/hooks/evolver-session-end.js`
-    // pointing at e.g. `~/.bashrc` would have its target overwritten with
-    // evolver script content. Round-5 closed the directory hole; this
-    // closes the per-file hole.
-    assertNotSymlink(dest, `hook destination ${name}`);
-    fs.copyFileSync(src, dest);
-    // NOTE(windows): fs.chmodSync is a no-op on Windows; hook scripts remain
-    // executable via file extension association (.js), not Unix mode bits.
-    try { fs.chmodSync(dest, 0o755); } catch { /* best-effort; no-op on Windows */ }
-    copied.push(dest);
-  }
-  return copied;
-}
-
-function appendSectionToFile(filePath, marker, content) {
-  let existing = '';
-  try { existing = fs.readFileSync(filePath, 'utf8'); } catch { /* new file */ }
-  if (existing.includes(marker)) {
-    console.log(`[setup-hooks] Section already present in ${filePath}, skipping.`);
-    return false;
-  }
-  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n';
-  fs.writeFileSync(filePath, existing + separator + content + '\n', 'utf8');
-  return true;
-}
-
-function removeEvolverHooks(filePath, { markerKey = '_evolver_managed' } = {}) {
-  try {
-    if (!fs.existsSync(filePath)) return false;
-    const raw = fs.readFileSync(filePath, 'utf8').trim();
-    if (!raw) return false;
-    const data = JSON.parse(raw);
-    if (!data[markerKey]) return false;
-
-    let changed = false;
-    if (data.hooks) {
-      for (const event of Object.keys(data.hooks)) {
-        if (Array.isArray(data.hooks[event])) {
-          const before = data.hooks[event].length;
-          data.hooks[event] = data.hooks[event].filter(h => {
-            const cmd = h.command || '';
-            return !isEvolverHookCommand(cmd);
-          });
-          if (data.hooks[event].length !== before) changed = true;
-          if (data.hooks[event].length === 0) delete data.hooks[event];
-        }
-      }
-      if (Object.keys(data.hooks).length === 0) delete data.hooks;
-    }
-    if (data.mcpServers) {
-      // Claude Code / Codex: hooks in mcpServers sub-key -- not relevant, skip
-    }
-    delete data[markerKey];
-    const tmp = filePath + '.tmp';
-    fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', 'utf8');
-    fs.renameSync(tmp, filePath);
-    return changed;
-  } catch {
-    return false;
-  }
-}
-
-function removeHookScripts(hooksDir) {
-  // Must mirror the install list above. If install copies a helper but
-  // uninstall doesn't remove it, `setup-hooks --uninstall` leaves orphan
-  // files behind that the user then has to clean up by hand (#547 fix
-  // would have introduced exactly this gap if only the install side
-  // had been updated).
-  const scripts = [
-    '_runtimePaths.js',
-    '_memoryFiltering.js',
-    '_lockPaths.js',
-    'evolver-session-start.js',
-    'evolver-signal-detect.js',
-    'evolver-session-end.js',
-    'evolver-task-recall.js',
-  ];
-  let removed = 0;
-  for (const name of scripts) {
-    const p = path.join(hooksDir, name);
-    try {
-      if (fs.existsSync(p)) { fs.unlinkSync(p); removed++; }
-    } catch (e) {
-      // Surface unlink failures so users can see why a "successful"
-      // uninstall left files behind (Windows file-locking, perms, …).
-      console.warn(`[setup-hooks] Failed to remove ${p}: ${e.message || e}`);
-    }
-  }
-  return removed;
-}
-
-// Remove a marker-bracketed section from a markdown file. Used by adapter
-// uninstall to clean up CLAUDE.md / AGENTS.md without nuking surrounding
-// user content.
-//
-// The previous inline implementations (codex/claude/kiro/opencode) searched
-// for the *next* `\n## ` after the marker, which matched evolver's own
-// `## Evolution Memory` heading and left the entire injected section in
-// place (#538). This helper skips any `## ` heading on the same line as the
-// marker, then looks for the next H2 to know where the user's content
-// resumes.
-function removeMarkedSection(filePath, marker) {
-  try {
-    if (!fs.existsSync(filePath)) return false;
-    const raw = fs.readFileSync(filePath, 'utf8');
-    const idx = raw.indexOf(marker);
-    if (idx === -1) return false;
-
-    // Skip past the marker line (and any heading on the same line).
-    let scanFrom = idx + marker.length;
-    const eol = raw.indexOf('\n', scanFrom);
-    if (eol !== -1) scanFrom = eol + 1;
-
-    // Skip past evolver's own `## ...` heading line if present.
-    if (raw.startsWith('## ', scanFrom)) {
-      const eol2 = raw.indexOf('\n', scanFrom);
-      scanFrom = eol2 !== -1 ? eol2 + 1 : raw.length;
-    }
-
-    const nextSection = raw.indexOf('\n## ', scanFrom);
-    const endIdx = nextSection !== -1 ? nextSection : raw.length;
-    const before = raw.slice(0, idx).trimEnd();
-    const after = nextSection !== -1 ? raw.slice(endIdx) : '';
-    const next = (before ? before + (after.startsWith('\n') ? '' : '\n') : '') + after;
-    fs.writeFileSync(filePath, next.trimEnd() + '\n', 'utf8');
-    return true;
-  } catch (e) {
-    console.warn(`[setup-hooks] Failed to clean section in ${filePath}: ${e.message || e}`);
-    return false;
-  }
-}
-
-async function setupHooks({ platform, cwd, force, uninstall, evolverRoot } = {}) {
-  const effectiveCwd = cwd || process.cwd();
-  const effectiveEvolverRoot = evolverRoot || path.resolve(__dirname, '..');
-  const platformId = platform || detectPlatform(effectiveCwd);
-
-  if (!platformId) {
-    console.error('[setup-hooks] Could not detect platform. Use --platform=cursor|claude-code|codex|kiro|opencode');
-    return { ok: false, error: 'platform_not_detected' };
-  }
-
-  const meta = PLATFORMS[platformId];
-  if (!meta) {
-    console.error(`[setup-hooks] Unknown platform: ${platformId}`);
-    return { ok: false, error: 'unknown_platform' };
-  }
-
-  const configRoot = resolveConfigRoot(platformId, effectiveCwd);
-  const adapter = loadAdapter(platformId);
-  if (!adapter) {
-    console.error(`[setup-hooks] No adapter found for ${platformId}`);
-    return { ok: false, error: 'no_adapter' };
-  }
-
-  console.log(`[setup-hooks] Platform: ${meta.name}`);
-  console.log(`[setup-hooks] Config root: ${configRoot}`);
-
-  if (uninstall) {
-    return adapter.uninstall({ configRoot, evolverRoot: effectiveEvolverRoot });
-  }
-
-  return adapter.install({ configRoot, evolverRoot: effectiveEvolverRoot, force });
-}
-
-module.exports = {
-  detectPlatformFromEnv,
-  detectPlatform,
-  buildSafeNodeHookCommand,
-  resolveConfigRoot,
-  loadAdapter,
-  mergeJsonFile,
-  deepMerge,
-  mergeWithHooksUnion,
-  collectCommands,
-  isEvolverHookCommand,
-  copyHookScripts,
-  appendSectionToFile,
-  assertSafeConfigDir,
-  assertNotSymlink,
-  removeEvolverHooks,
-  removeHookScripts,
-  removeMarkedSection,
-  setupHooks,
-  PLATFORMS,
-};

package/src/adapters/kiro.js

@@ -1,195 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const { copyHookScripts, removeHookScripts, removeMarkedSection, assertSafeConfigDir } = require('./hookAdapter');
-
-const HOOK_SCRIPTS_DIR_NAME = 'hooks';
-const EVOLVER_MARKER = '<!-- evolver-evolution-memory -->';
-const HOOK_FILE_SUFFIX = '.kiro.hook';
-const HOOK_FILES = {
-  sessionStart: 'evolver-session-start.kiro.hook',
-  signalDetect: 'evolver-signal-detect.kiro.hook',
-  sessionEnd: 'evolver-session-end.kiro.hook',
-};
-
-function buildHookConfig(kind, scriptsBase) {
-  // Kiro has no dedicated sessionStart event; `promptSubmit` is the closest
-  // analogue. The session-start JS script itself guards against per-prompt
-  // re-injection via a session-scoped state file when
-  // EVOLVER_SESSION_START_DEDUP=1 is set (injected inline into the command
-  // because Kiro runCommand has no env field).
-  const sessionStartCmd = `EVOLVER_SESSION_START_DEDUP=1 node ${scriptsBase}/evolver-session-start.js`;
-  const hookTemplates = {
-    sessionStart: {
-      name: 'Evolver Session Start',
-      version: '1',
-      description:
-        'Reads recent evolution memory from the local memory graph and injects it as context when a prompt is submitted.',
-      when: { type: 'promptSubmit' },
-      then: {
-        type: 'runCommand',
-        command: sessionStartCmd,
-        timeout: 3,
-      },
-      _evolver_managed: true,
-    },
-    signalDetect: {
-      name: 'Evolver Signal Detect',
-      version: '1',
-      description:
-        'Detects evolution signals (errors, perf bottlenecks, capability gaps, test failures) in file content after write operations.',
-      when: { type: 'postToolUse', toolTypes: ['write'] },
-      then: {
-        type: 'runCommand',
-        command: `node ${scriptsBase}/evolver-signal-detect.js`,
-        timeout: 2,
-      },
-      _evolver_managed: true,
-    },
-    sessionEnd: {
-      name: 'Evolver Session End',
-      version: '1',
-      description:
-        'Records evolution outcome at session end by analyzing git diff stats and writing to the local memory graph.',
-      when: { type: 'agentStop' },
-      then: {
-        type: 'runCommand',
-        command: `node ${scriptsBase}/evolver-session-end.js`,
-        timeout: 8,
-      },
-      _evolver_managed: true,
-    },
-  };
-  return hookTemplates[kind];
-}
-
-function buildAgentsMdSection() {
-  return `${EVOLVER_MARKER}
-## Evolution Memory (Evolver)
-
-This project uses evolver for self-evolution. Hooks automatically:
-1. Inject recent evolution memory on prompt submit
-2. Detect evolution signals during file edits
-3. Record outcomes at session end
-
-For substantive tasks, call \`gep_recall\` before work and \`gep_record_outcome\` after.
-Signals: log_error, perf_bottleneck, user_feature_request, capability_gap, deployment_issue, test_failure.`;
-}
-
-function appendSectionToFile(filePath, marker, content) {
-  let existing = '';
-  try { existing = fs.readFileSync(filePath, 'utf8'); } catch { /* new file */ }
-  if (existing.includes(marker)) return false;
-  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n';
-  fs.writeFileSync(filePath, existing + separator + content + '\n', 'utf8');
-  return true;
-}
-
-function writeHookFile(hooksDir, fileName, config) {
-  const tmp = path.join(hooksDir, fileName + '.tmp');
-  const dest = path.join(hooksDir, fileName);
-  fs.writeFileSync(tmp, JSON.stringify(config, null, 2) + '\n', 'utf8');
-  fs.renameSync(tmp, dest);
-  return dest;
-}
-
-function isEvolverManagedHookFile(filePath) {
-  try {
-    const raw = fs.readFileSync(filePath, 'utf8').trim();
-    if (!raw) return false;
-    const data = JSON.parse(raw);
-    if (data && data._evolver_managed === true) return true;
-    if (typeof data.name === 'string' && /^evolver\b/i.test(data.name)) return true;
-    if (data.then && typeof data.then.command === 'string' &&
-        /evolver-(session|signal)/.test(data.then.command)) return true;
-  } catch { /* treat as non-evolver */ }
-  return false;
-}
-
-function install({ configRoot, evolverRoot, force }) {
-  const kiroDir = path.join(configRoot, '.kiro');
-  const hooksDir = path.join(kiroDir, HOOK_SCRIPTS_DIR_NAME);
-  const agentsMdPath = path.join(configRoot, 'AGENTS.md');
-  const scriptsBase = '.kiro/hooks';
-  assertSafeConfigDir(kiroDir, '.kiro', { subdirs: [HOOK_SCRIPTS_DIR_NAME] });
-
-  const hookPaths = Object.values(HOOK_FILES).map(name => path.join(hooksDir, name));
-
-  if (!force) {
-    const existingEvolverHook = hookPaths.find(p => fs.existsSync(p) && isEvolverManagedHookFile(p));
-    if (existingEvolverHook) {
-      console.log('[kiro] Evolver hooks already installed. Use --force to overwrite.');
-      return { ok: true, skipped: true };
-    }
-  }
-
-  fs.mkdirSync(hooksDir, { recursive: true });
-
-  const written = [];
-  for (const [kind, fileName] of Object.entries(HOOK_FILES)) {
-    const cfg = buildHookConfig(kind, scriptsBase);
-    const dest = writeHookFile(hooksDir, fileName, cfg);
-    written.push(dest);
-    console.log('[kiro] Wrote ' + dest);
-  }
-
-  const copied = copyHookScripts(hooksDir, path.join(evolverRoot, 'src', 'adapters'));
-  console.log('[kiro] Copied ' + copied.length + ' hook scripts to ' + hooksDir);
-
-  const injected = appendSectionToFile(agentsMdPath, EVOLVER_MARKER, buildAgentsMdSection());
-  if (injected) {
-    console.log('[kiro] Injected evolution section into ' + agentsMdPath);
-  }
-
-  console.log('[kiro] Installation complete.');
-  console.log('[kiro] Kiro auto-discovers *.kiro.hook files in .kiro/hooks/ -- no restart needed.');
-
-  return {
-    ok: true,
-    platform: 'kiro',
-    files: [...written, agentsMdPath, ...copied],
-  };
-}
-
-function uninstall({ configRoot }) {
-  const kiroDir = path.join(configRoot, '.kiro');
-  const hooksDir = path.join(kiroDir, HOOK_SCRIPTS_DIR_NAME);
-  const agentsMdPath = path.join(configRoot, 'AGENTS.md');
-  assertSafeConfigDir(kiroDir, '.kiro', { subdirs: [HOOK_SCRIPTS_DIR_NAME] });
-
-  let changed = false;
-  let removedCount = 0;
-
-  if (fs.existsSync(hooksDir)) {
-    try {
-      const entries = fs.readdirSync(hooksDir);
-      for (const entry of entries) {
-        if (!entry.endsWith(HOOK_FILE_SUFFIX)) continue;
-        const full = path.join(hooksDir, entry);
-        if (isEvolverManagedHookFile(full)) {
-          try { fs.unlinkSync(full); removedCount++; changed = true; } catch { /* ignore */ }
-        }
-      }
-    } catch { /* ignore */ }
-  }
-
-  const scripts = removeHookScripts(hooksDir);
-  if (scripts > 0) changed = true;
-
-  if (removeMarkedSection(agentsMdPath, EVOLVER_MARKER)) {
-    changed = true;
-  }
-
-  console.log(changed
-    ? `[kiro] Uninstalled evolver hooks (${removedCount} hook files + ${scripts} scripts removed).`
-    : '[kiro] No evolver hooks found to uninstall.');
-
-  return { ok: true, removed: changed };
-}
-
-module.exports = {
-  install,
-  uninstall,
-  buildHookConfig,
-  isEvolverManagedHookFile,
-  HOOK_FILES,
-};