agents-deck 1.18.0

package/src/server/installer.mjs

@@ -0,0 +1,185 @@
+// Idempotent hook installer. Supports two providers:
+//  - "claude"  → ~/.claude/settings.json (Claude Code)
+//  - "codex"   → ~/.codex/hooks.json     (OpenAI Codex CLI)
+// Both providers share the discovery dir at ~/.claude/agent-dag/ so a single
+// running server can receive events from either CLI. Re-runs are safe; entries
+// are tagged with __agent-dag and de-duped.
+import { readFile, writeFile, mkdir, copyFile, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = resolve(__dirname, "..", "..");
+
+const HOME = homedir();
+const CLAUDE_DIR = join(HOME, ".claude");
+const CODEX_DIR = process.env.CODEX_HOME
+  ? resolve(process.env.CODEX_HOME)
+  : join(HOME, ".codex");
+
+// Single shared discovery dir — both providers' hook scripts post here so one
+// running agent-dag server can match either ecosystem's events.
+const AGENT_DAG_DIR = join(CLAUDE_DIR, "agent-dag");
+
+const CLAUDE_EVENTS = [
+  "SessionStart",
+  "UserPromptSubmit",
+  "PreToolUse",
+  "PostToolUse",
+  "PostToolUseFailure",
+  "SubagentStart",
+  "SubagentStop",
+  "Stop",
+  "SessionEnd",
+  "Notification",
+];
+
+// Codex CLI hook events. SubagentStart/Stop exist (multi-agent feature).
+// PostToolUseFailure / SessionEnd / Notification have no Codex equivalent.
+const CODEX_EVENTS = [
+  "SessionStart",
+  "UserPromptSubmit",
+  "PreToolUse",
+  "PostToolUse",
+  "SubagentStart",
+  "SubagentStop",
+  "Stop",
+  "PreCompact",
+  "PostCompact",
+];
+
+const PROVIDERS = {
+  claude: {
+    settingsPath: join(CLAUDE_DIR, "settings.json"),
+    hookInstallDir: join(CLAUDE_DIR, "agent-dag"),
+    events: CLAUDE_EVENTS,
+    ensureDir: CLAUDE_DIR,
+  },
+  codex: {
+    settingsPath: join(CODEX_DIR, "hooks.json"),
+    hookInstallDir: join(CODEX_DIR, "agent-dag"),
+    events: CODEX_EVENTS,
+    ensureDir: CODEX_DIR,
+  },
+};
+
+const MARK_KEY = "__agent-dag";
+// Legacy marks from earlier names — purged on every install/uninstall so
+// duplicate forwarders don't pile up when the project gets renamed.
+const LEGACY_MARKS = ["__ccgraph", "__agent-flow"];
+const LEGACY_DIRS = ["ccgraph", "agent-flow", "agent-dag"];
+
+function hookCommand(installedHookPath, provider) {
+  const node = process.execPath;
+  return `"${node}" "${installedHookPath}" --provider ${provider}`;
+}
+
+function isOurEntry(g) {
+  if (!g || typeof g !== "object") return false;
+  if (g[MARK_KEY] === true) return true;
+  for (const k of LEGACY_MARKS) if (g[k] === true) return true;
+  const cmds = Array.isArray(g.hooks) ? g.hooks : [];
+  for (const h of cmds) {
+    const c = typeof h?.command === "string" ? h.command : "";
+    for (const dir of LEGACY_DIRS) {
+      if (c.includes(`.claude/${dir}/hook.js`) || c.includes(`.claude\\${dir}\\hook.js`)) return true;
+      if (c.includes(`.codex/${dir}/hook.js`) || c.includes(`.codex\\${dir}\\hook.js`)) return true;
+    }
+  }
+  return false;
+}
+
+async function ensureDir(p) {
+  if (!existsSync(p)) await mkdir(p, { recursive: true });
+}
+
+async function readJsonSafe(p) {
+  try { return JSON.parse(await readFile(p, "utf8")); } catch { return null; }
+}
+
+async function installHookScript(installDir) {
+  await ensureDir(installDir);
+  const src = join(PKG_ROOT, "hook", "hook.js");
+  const dst = join(installDir, "hook.js");
+  await copyFile(src, dst);
+  return dst;
+}
+
+function buildHookEntry(command) {
+  return {
+    [MARK_KEY]: true,
+    hooks: [{ type: "command", command, timeout: 2 }],
+  };
+}
+
+function dedupeOurEntries(group) {
+  if (!Array.isArray(group)) return [];
+  return group.filter(g => !isOurEntry(g));
+}
+
+/** Install hooks for a single provider. Returns {settingsPath, hookPath, events}. */
+export async function installHooks({ provider = "claude" } = {}) {
+  const cfg = PROVIDERS[provider];
+  if (!cfg) throw new Error(`unknown provider: ${provider}`);
+
+  const hookPath = await installHookScript(cfg.hookInstallDir);
+  const command = hookCommand(hookPath, provider);
+  await ensureDir(cfg.ensureDir);
+  // Discovery dir is shared across providers — always make sure it exists.
+  await ensureDir(AGENT_DAG_DIR);
+
+  const current = (await readJsonSafe(cfg.settingsPath)) ?? {};
+  current.hooks = current.hooks ?? {};
+
+  for (const evt of cfg.events) {
+    const cleaned = dedupeOurEntries(current.hooks[evt]);
+    cleaned.push(buildHookEntry(command));
+    current.hooks[evt] = cleaned;
+  }
+
+  await writeFile(cfg.settingsPath, JSON.stringify(current, null, 2) + "\n", "utf8");
+  return { settingsPath: cfg.settingsPath, hookPath, events: cfg.events, provider };
+}
+
+export async function uninstallHooks({ provider = "claude" } = {}) {
+  const cfg = PROVIDERS[provider];
+  if (!cfg) throw new Error(`unknown provider: ${provider}`);
+  const current = await readJsonSafe(cfg.settingsPath);
+  if (!current?.hooks) return { changed: false, provider };
+  let changed = false;
+  for (const evt of Object.keys(current.hooks)) {
+    const cleaned = dedupeOurEntries(current.hooks[evt]);
+    if (cleaned.length !== (current.hooks[evt]?.length ?? 0)) changed = true;
+    if (cleaned.length === 0) delete current.hooks[evt];
+    else current.hooks[evt] = cleaned;
+  }
+  if (changed) await writeFile(cfg.settingsPath, JSON.stringify(current, null, 2) + "\n", "utf8");
+  return { changed, provider, settingsPath: cfg.settingsPath };
+}
+
+/** True when ~/.codex/ exists — used by CLI to default-enable Codex hooks. */
+export function hasCodexInstalled() {
+  return existsSync(CODEX_DIR);
+}
+
+export async function writeDiscovery({ port, workspace }) {
+  await ensureDir(AGENT_DAG_DIR);
+  const file = join(AGENT_DAG_DIR, `${process.pid}.json`);
+  const data = {
+    pid: process.pid,
+    port,
+    workspace: workspace ?? "",
+    startedAt: new Date().toISOString(),
+  };
+  await writeFile(file, JSON.stringify(data, null, 2) + "\n", "utf8");
+  return file;
+}
+
+export async function removeDiscovery(file) {
+  try { await unlink(file); } catch {}
+}
+
+export const HOOK_EVENTS = CLAUDE_EVENTS;
+export { AGENT_DAG_DIR, CLAUDE_DIR, CODEX_DIR, CLAUDE_EVENTS, CODEX_EVENTS };