npm - agendex-cli - Versions diffs - 0.17.0 → 1.0.0 - Mend

agendex-cli 0.17.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/dist/cli.js +490 -49
package/package.json +1 -1

package/dist/cli.js CHANGED Viewed

@@ -1059,8 +1059,8 @@ var init_cleanup = __esm(() => {
 // src/cli.ts
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync11, statSync as statSync2, writeSync } from "node:fs";
-import { resolve as resolve8 } from "node:path";
+import { existsSync as existsSync12, statSync as statSync2, writeSync } from "node:fs";
+import { resolve as resolve9 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 // ../shared/src/adapters/catalog.ts
@@ -2085,7 +2085,8 @@ async function parseLiveSession(filePath) {
       sessionPath: filePath,
       sourcePlanPath,
       startedAt: session.startedAt,
-      writebackCapable: true
+      writebackCapable: true,
+      liveness: "live"
     };
     return [
       {
@@ -2910,6 +2911,8 @@ async function loadOrInitConfig(options = {}) {
 // ../shared/src/daemon-status.ts
 var CLI_DAEMON_HEARTBEAT_INTERVAL_MS = 30000;
 var CLI_DAEMON_STALE_AFTER_MS = CLI_DAEMON_HEARTBEAT_INTERVAL_MS * 5;
+// ../shared/src/services/annotation-store.ts
+var mutationQueue = Promise.resolve();
 // ../shared/src/services/plan-service.ts
 import { existsSync as existsSync5, readdirSync as readdirSync3, realpathSync, statSync } from "node:fs";
 import { lstat, mkdir, readdir as readdir2, readFile as readFile7, stat as stat7, writeFile as writeFile3 } from "node:fs/promises";
@@ -4176,12 +4179,12 @@ async function login(siteUrlOverride) {
   const existing = loadConfig();
   const config = {
     configVersion: 3,
-    token: existing?.token,
     cloudToken: callback.token,
     convexUrl: callback.convexUrl,
-    deviceId: existing?.deviceId,
     enabledAdapters: existing?.enabledAdapters ?? [],
-    customPlanDirs: existing?.customPlanDirs ?? []
+    customPlanDirs: existing?.customPlanDirs ?? [],
+    ...existing?.token ? { token: existing.token } : {},
+    ...existing?.deviceId ? { deviceId: existing.deviceId } : {}
   };
   saveConfig(config);
   console.log(`[agendex] Logged in successfully!`);
@@ -4195,12 +4198,10 @@ function logout() {
   }
   const config = {
     configVersion: 3,
-    token: existing.token,
-    cloudToken: undefined,
-    convexUrl: undefined,
-    deviceId: existing.deviceId,
     enabledAdapters: existing.enabledAdapters,
-    customPlanDirs: existing.customPlanDirs
+    customPlanDirs: existing.customPlanDirs,
+    ...existing.token ? { token: existing.token } : {},
+    ...existing.deviceId ? { deviceId: existing.deviceId } : {}
   };
   saveConfig(config);
   console.log("[agendex] Logged out. Cloud token removed.");
@@ -4290,38 +4291,31 @@ async function startCallbackServer() {
   };
 }
 function callbackPage(success) {
-  const title = success ? "Login successful" : "Login failed";
-  const message = success ? "You can close this tab and return to your terminal." : "Missing token. Please try again.";
-  const icon = success ? '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" style="width:32px;height:32px;color:#22c55e"><path stroke-linecap="round" stroke-linejoin="round" d="M9 12.75 11.25 15 15 9.75M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Z"/></svg>' : '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" style="width:32px;height:32px;color:#ef4444"><path stroke-linecap="round" stroke-linejoin="round" d="m9.75 9.75 4.5 4.5m0-4.5-4.5 4.5M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Z"/></svg>';
+  const title = success ? "Signed in" : "Sign in failed";
+  const message = success ? "Return to your terminal." : "Run agendex login again.";
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="utf-8"/>
   <meta name="viewport" content="width=device-width,initial-scale=1"/>
-  <title>${title} — Agendex</title>
+  <title>${title} | Agendex</title>
   <style>
-    *{margin:0;padding:0;box-sizing:border-box}
-    @media(prefers-color-scheme:dark){
-      :root{--bg:#111;--surface:#161616;--text:#e8e8e8;--secondary:#888;--tertiary:#555;--border:rgba(255,255,255,0.06)}
-    }
-    @media(prefers-color-scheme:light){
-      :root{--bg:#fafafa;--surface:#fff;--text:#111;--secondary:#666;--tertiary:#999;--border:rgba(0,0,0,0.06)}
-    }
-    body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:var(--bg);color:var(--text);display:flex;align-items:center;justify-content:center;min-height:100vh;-webkit-font-smoothing:antialiased}
-    .card{background:var(--surface);border:1px solid var(--border);border-radius:12px;padding:40px 48px;text-align:center;max-width:400px;width:100%;box-shadow:0 2px 16px rgba(0,0,0,0.04)}
-    .icon{margin-bottom:16px;display:flex;justify-content:center}
-    h1{font-size:18px;font-weight:600;letter-spacing:-0.02em;margin-bottom:8px}
-    p{font-size:13px;color:var(--secondary);line-height:1.5}
-    .brand{margin-top:24px;font-size:11px;color:var(--tertiary);letter-spacing:0.04em;font-weight:500}
+    *{box-sizing:border-box}
+    :root{color-scheme:dark light;--bg:oklch(13% 0.018 180);--text:oklch(91% 0.012 125);--muted:oklch(58% 0.018 160);--accent:oklch(90% 0.23 125);--err:oklch(64% 0.2 25)}
+    @media(prefers-color-scheme:light){:root{--bg:oklch(97% 0.014 125);--text:oklch(18% 0.016 135);--muted:oklch(48% 0.018 155)}}
+    body{margin:0;min-height:100vh;background:var(--bg);color:var(--text);font-family:Inter,-apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;display:grid;place-items:center;padding:32px;-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}
+    main{width:min(100%,340px)}
+    h1{font-size:21px;font-weight:560;line-height:1.25;letter-spacing:-.02em;margin:0}
+    p{font-size:15px;line-height:1.5;color:var(--muted);margin:9px 0 0}
+    .brand{font-family:'SF Mono','JetBrains Mono','Fira Code',ui-monospace,monospace;font-size:12px;line-height:1;color:var(--accent);margin-top:42px;letter-spacing:.02em}
   </style>
 </head>
 <body>
-  <div class="card">
-    <div class="icon">${icon}</div>
-    <h1>${title}</h1>
+  <main aria-labelledby="callback-title">
+    <h1 id="callback-title">${title}</h1>
     <p>${message}</p>
-    <div class="brand">AGENDEX</div>
-  </div>
+    <div class="brand">agendex</div>
+  </main>
 </body>
 </html>`;
 }
@@ -4642,6 +4636,32 @@ var RESTART_DELAY_MS = 5000;
 var PLANNOTATOR_WRITEBACK_POLL_INTERVAL_MS = 15000;
 var PLANNOTATOR_WRITEBACK_EXPIRED_ERROR = "Write-back expired before delivery.";
 var PLANNOTATOR_WRITEBACK_FAILED_ERROR = "No live Plannotator session accepted the request-changes payload.";
+var PLANNOTATOR_LIVENESS_SWEEP_INTERVAL_MS = 20000;
+function isRecord5(value) {
+  return typeof value === "object" && value !== null;
+}
+function isLivePlannotatorPayload(payload) {
+  const plannotator = isRecord5(payload.metadata) ? payload.metadata.plannotator : undefined;
+  if (!isRecord5(plannotator))
+    return false;
+  return plannotator.kind === "live-session" && plannotator.writebackCapable === true;
+}
+function buildEndedPlannotatorPayload(payload) {
+  const metadata = isRecord5(payload.metadata) ? payload.metadata : {};
+  const plannotator = isRecord5(metadata.plannotator) ? metadata.plannotator : {};
+  return {
+    ...payload,
+    metadata: {
+      ...metadata,
+      plannotator: {
+        ...plannotator,
+        writebackCapable: false,
+        liveness: "ended",
+        endedAt: Date.now()
+      }
+    }
+  };
+}
 async function runWorker() {
   const config = await loadOrInitConfig();
   const hostname2 = osHostname2();
@@ -4651,6 +4671,7 @@ async function runWorker() {
   const syncCache = loadSyncCache();
   const syncQueue = [];
   const pendingWritebackReports = loadPendingWritebackReports();
+  const liveSessions = new Map;
   let syncing = false;
   let cachedIpAddress;
   async function getSyncIpAddress() {
@@ -4726,6 +4747,31 @@ async function runWorker() {
     if (syncQueue.length > 0)
       processSyncQueue();
   }
+  async function reconcileLivePlannotatorSessions(plans2) {
+    const ipAddress = await getSyncIpAddress();
+    const livePayloads = new Map;
+    for (const plan of plans2) {
+      const payload = planToSyncPayload(plan, config.deviceId, hostname2, ipAddress);
+      if (isLivePlannotatorPayload(payload))
+        livePayloads.set(payload.localPlanId, payload);
+    }
+    let queued = false;
+    for (const [planId, lastPayload] of liveSessions) {
+      if (livePayloads.has(planId))
+        continue;
+      const endedPayload = buildEndedPlannotatorPayload(lastPayload);
+      syncQueue.push(endedPayload);
+      liveSessions.delete(planId);
+      queued = true;
+      console.log(`[agendex] Plannotator session ended: ${endedPayload.title}`);
+    }
+    for (const [planId, payload] of livePayloads) {
+      liveSessions.set(planId, payload);
+    }
+    if (queued)
+      processSyncQueue();
+    return queued;
+  }
   function persistPendingWritebackReports() {
     if (!savePendingWritebackReports(pendingWritebackReports)) {
       console.error("[agendex] failed to persist Plannotator write-back delivery cache");
@@ -4843,6 +4889,7 @@ async function runWorker() {
   const lowValueSuffix = lowValuePlanCount > 0 ? `, ${lowValuePlanCount} low-value hidden/pruned` : "";
   console.log(`[agendex] syncing ${initialQueuedSyncable} plans${lowValueSuffix} (${initialQueuedLowValue} low-value queued, ${initialSkipped} unchanged)...`);
   await processSyncQueue();
+  await reconcileLivePlannotatorSessions(getAll());
   setInterval(() => {
     (async () => {
       await sendHeartbeat(await getSyncIpAddress());
@@ -4851,6 +4898,14 @@ async function runWorker() {
   if (shouldEnablePlannotatorSync(config)) {
     setInterval(() => void pollPlannotatorWritebacks(), PLANNOTATOR_WRITEBACK_POLL_INTERVAL_MS);
     pollPlannotatorWritebacks();
+    setInterval(() => {
+      (async () => {
+        await scan();
+        await reconcileLivePlannotatorSessions(getAll());
+      })().catch((err) => {
+        console.error("[agendex] Plannotator liveness sweep failed:", err);
+      });
+    }, PLANNOTATOR_LIVENESS_SWEEP_INTERVAL_MS);
   }
   startWatching((changedPlans) => {
     (async () => {
@@ -4859,6 +4914,7 @@ async function runWorker() {
         syncQueue.push(planToSyncPayload(plan, config.deviceId, hostname2, ipAddress));
       }
       processSyncQueue();
+      await reconcileLivePlannotatorSessions(getAll());
     })().catch((err) => {
       console.error("[agendex] failed to queue changed plans:", err);
     });
@@ -4921,6 +4977,379 @@ async function startSupervisor() {
   removePid();
 }
+// src/hooks.ts
+import { existsSync as existsSync10, readFileSync as readFileSync7 } from "node:fs";
+import { mkdir as mkdir2, rm, writeFile as writeFile4 } from "node:fs/promises";
+import { homedir as homedir10 } from "node:os";
+import { dirname as dirname4, join as join14, resolve as resolve7 } from "node:path";
+var SUPPORTED_AGENTS = ["claude-code", "codex", "pi"];
+var MANAGED_MARKER = "agendex-plan-review";
+var HOOK_TIMEOUT_SECONDS = 345600;
+var CLAUDE_PREVIEW_FLAG = "--preview";
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function commandFor(cliEntry, agent) {
+  return `${shellQuote(process.execPath)} ${shellQuote(cliEntry)} review-plan --hook --agent ${agent}`;
+}
+function scopeRoot(scope) {
+  return scope === "repo" ? resolve7(process.env.PWD || process.cwd()) : homedir10();
+}
+function hooksJsonPath(agent, scope) {
+  const root = scopeRoot(scope);
+  if (agent === "claude-code")
+    return join14(root, ".claude", "hooks.json");
+  if (agent === "codex")
+    return join14(root, ".codex", "hooks.json");
+  return join14(root, scope === "repo" ? ".pi/extensions/agendex/index.ts" : ".pi/agent/extensions/agendex/index.ts");
+}
+function codexConfigPath(scope) {
+  return join14(scopeRoot(scope), ".codex", "config.toml");
+}
+function readJsonFile(path) {
+  if (!existsSync10(path))
+    return {};
+  try {
+    return JSON.parse(readFileSync7(path, "utf-8"));
+  } catch (err) {
+    throw new Error(`Could not parse ${path}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+function isRecord6(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function backupPathFor(path) {
+  return `${path}.bak-${new Date().toISOString().replace(/[:.]/g, "-")}`;
+}
+async function writeWithBackup(path, content, dryRun) {
+  if (dryRun)
+    return;
+  await mkdir2(dirname4(path), { recursive: true });
+  if (existsSync10(path)) {
+    await writeFile4(backupPathFor(path), readFileSync7(path, "utf-8"), "utf-8");
+  }
+  await writeFile4(path, content, "utf-8");
+}
+async function removeWithBackup(path, dryRun) {
+  if (dryRun || !existsSync10(path))
+    return;
+  await writeFile4(backupPathFor(path), readFileSync7(path, "utf-8"), "utf-8");
+  await rm(path);
+}
+function mergeCommandHook({
+  config,
+  event,
+  matcher,
+  command
+}) {
+  const hooks = isRecord6(config.hooks) ? { ...config.hooks } : {};
+  const existingEvent = Array.isArray(hooks[event]) ? [...hooks[event]] : [];
+  const entry = {
+    ...matcher ? { matcher } : {},
+    id: MANAGED_MARKER,
+    hooks: [
+      {
+        type: "command",
+        command,
+        timeout: HOOK_TIMEOUT_SECONDS
+      }
+    ]
+  };
+  const index = existingEvent.findIndex((item) => {
+    if (!isRecord6(item))
+      return false;
+    if (item.id === MANAGED_MARKER)
+      return true;
+    return JSON.stringify(item).includes("agendex") && JSON.stringify(item).includes("review-plan");
+  });
+  if (index >= 0)
+    existingEvent[index] = entry;
+  else
+    existingEvent.push(entry);
+  hooks[event] = existingEvent;
+  return { ...config, hooks };
+}
+function hasManagedHook(path) {
+  if (!existsSync10(path))
+    return false;
+  const raw = readFileSync7(path, "utf-8");
+  return raw.includes(MANAGED_MARKER) || raw.includes("agendex") && raw.includes("review-plan");
+}
+function isManagedHookEntry(item) {
+  if (!isRecord6(item))
+    return false;
+  if (item.id === MANAGED_MARKER)
+    return true;
+  const serialized = JSON.stringify(item);
+  return serialized.includes("agendex") && serialized.includes("review-plan");
+}
+function removeManagedHooks(config) {
+  if (!isRecord6(config.hooks))
+    return config;
+  const hooks = {};
+  for (const [event, value] of Object.entries(config.hooks)) {
+    if (!Array.isArray(value)) {
+      hooks[event] = value;
+      continue;
+    }
+    const kept = value.filter((item) => !isManagedHookEntry(item));
+    if (kept.length > 0)
+      hooks[event] = kept;
+  }
+  return Object.keys(hooks).length > 0 ? { ...config, hooks } : { ...config, hooks: {} };
+}
+function ensureCodexHooksEnabled(raw) {
+  const lines = raw ? raw.split(`
+`) : [];
+  const featuresIndex = lines.findIndex((line) => /^\s*\[features\]\s*$/.test(line));
+  if (featuresIndex === -1) {
+    return `${raw.trimEnd()}
+[features]
+hooks = true
+`;
+  }
+  let insertAt = lines.length;
+  for (let i = featuresIndex + 1;i < lines.length; i++) {
+    if (/^\s*\[.+\]\s*$/.test(lines[i] ?? "")) {
+      insertAt = i;
+      break;
+    }
+    if (/^\s*hooks\s*=/.test(lines[i] ?? "")) {
+      lines[i] = "hooks = true";
+      return `${lines.join(`
+`).trimEnd()}
+`;
+    }
+  }
+  lines.splice(insertAt, 0, "hooks = true");
+  return `${lines.join(`
+`).trimEnd()}
+`;
+}
+function printClaudePreviewBlock() {
+  console.error("[agendex] refusing to install claude-code hook: hook-native plan review is not implemented yet.");
+  console.error("[agendex] Installing it now would cause Claude Code to deny ExitPlanMode permission requests.");
+  console.error(`[agendex] Re-run with ${CLAUDE_PREVIEW_FLAG} to opt in deliberately, or install codex/pi separately.`);
+}
+function printClaudePreviewWarning(dryRun) {
+  console.error("[agendex] WARNING: claude-code hook support is preview-only.");
+  console.error(dryRun ? "[agendex] This dry run describes a PermissionRequest hook that would deny ExitPlanMode until hook-native plan review ships." : "[agendex] The installed PermissionRequest hook will deny ExitPlanMode until hook-native plan review ships.");
+  console.error("[agendex] Remove it with: agendex hooks uninstall claude-code");
+}
+async function installClaude(scope, cliEntry, dryRun) {
+  const path = hooksJsonPath("claude-code", scope);
+  const config = mergeCommandHook({
+    config: readJsonFile(path),
+    event: "PermissionRequest",
+    matcher: "ExitPlanMode",
+    command: commandFor(cliEntry, "claude-code")
+  });
+  await writeWithBackup(path, `${JSON.stringify(config, null, 2)}
+`, dryRun);
+  return path;
+}
+async function installCodex(scope, cliEntry, dryRun) {
+  const configPath = codexConfigPath(scope);
+  const config = existsSync10(configPath) ? readFileSync7(configPath, "utf-8") : "";
+  await writeWithBackup(configPath, ensureCodexHooksEnabled(config), dryRun);
+  const hooksPath = hooksJsonPath("codex", scope);
+  const hookConfig = mergeCommandHook({
+    config: readJsonFile(hooksPath),
+    event: "Stop",
+    command: commandFor(cliEntry, "codex")
+  });
+  await writeWithBackup(hooksPath, `${JSON.stringify(hookConfig, null, 2)}
+`, dryRun);
+  return hooksPath;
+}
+function piExtensionSource(cliEntry) {
+  const command = commandFor(cliEntry, "pi");
+  return `import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+const REVIEW_COMMAND = ${JSON.stringify(command)};
+export default function agendexPiExtension(pi: ExtensionAPI): void {
+  pi.registerCommand('agendex-review-plan', {
+    description: 'Open an Agendex plan review gate for the current Pi session',
+    handler: async (_args, ctx) => {
+      ctx.ui.notify('Agendex review command registered. Native interactive review is handled by the Agendex CLI hook path.', 'info');
+      pi.sendMessage(
+        {
+          customType: 'agendex-review-command',
+          content: '[Agendex] Run this hook command from a shell-integrated Pi workflow when you need hook-native review JSON:
+' + REVIEW_COMMAND,
+          display: true,
+        },
+        { triggerTurn: false },
+      );
+    },
+  });
+  pi.registerCommand('agendex-annotate', {
+    description: 'Record Agendex annotation feedback in the active Pi session',
+    handler: async (args, ctx) => {
+      const feedback = args?.trim();
+      if (!feedback) {
+        ctx.ui.notify('Usage: /agendex-annotate <feedback>', 'warning');
+        return;
+      }
+      pi.sendMessage(
+        {
+          customType: 'agendex-annotation-feedback',
+          content: '[Agendex annotation feedback]
+' + feedback,
+          display: true,
+        },
+        { triggerTurn: true },
+      );
+    },
+  });
+  pi.on('session_start', async (_event, ctx) => {
+    ctx.ui.setStatus('agendex', 'agendex hooks');
+  });
+}
+`;
+}
+async function installPi(scope, cliEntry, dryRun) {
+  const path = hooksJsonPath("pi", scope);
+  await writeWithBackup(path, piExtensionSource(cliEntry), dryRun);
+  return path;
+}
+async function installAgent(agent, scope, cliEntry, dryRun) {
+  if (agent === "claude-code")
+    return await installClaude(scope, cliEntry, dryRun);
+  if (agent === "codex")
+    return await installCodex(scope, cliEntry, dryRun);
+  return await installPi(scope, cliEntry, dryRun);
+}
+async function uninstallJsonAgent(agent, scope, dryRun) {
+  const path = hooksJsonPath(agent, scope);
+  if (!existsSync10(path))
+    return path;
+  const updated = removeManagedHooks(readJsonFile(path));
+  await writeWithBackup(path, `${JSON.stringify(updated, null, 2)}
+`, dryRun);
+  return path;
+}
+async function uninstallPi(scope, dryRun) {
+  const path = hooksJsonPath("pi", scope);
+  if (hasManagedHook(path))
+    await removeWithBackup(path, dryRun);
+  return path;
+}
+async function uninstallAgent(agent, scope, dryRun) {
+  if (agent === "claude-code" || agent === "codex")
+    return await uninstallJsonAgent(agent, scope, dryRun);
+  return await uninstallPi(scope, dryRun);
+}
+function statusFor(agent, scope) {
+  const path = hooksJsonPath(agent, scope);
+  if (agent === "codex") {
+    const configPath = codexConfigPath(scope);
+    const configEnabled = existsSync10(configPath) && /hooks\s*=\s*true/.test(readFileSync7(configPath, "utf-8"));
+    const installed2 = configEnabled && hasManagedHook(path);
+    return {
+      agent,
+      installed: installed2,
+      path,
+      detail: installed2 ? "Stop hook installed and hooks feature enabled" : "Missing Stop hook or [features].hooks = true"
+    };
+  }
+  const installed = hasManagedHook(path);
+  return {
+    agent,
+    installed,
+    path,
+    detail: installed ? "Agendex hook installed" : "Agendex hook not installed"
+  };
+}
+function parseScope(args) {
+  const scopeIndex = args.indexOf("--scope");
+  const value = scopeIndex >= 0 ? args[scopeIndex + 1] : undefined;
+  if (value === "user" || value === "repo")
+    return value;
+  return args.includes("--user") ? "user" : "repo";
+}
+function parseAgent(value) {
+  if (!value)
+    return;
+  if (value === "all")
+    return "all";
+  if (value === "claude" || value === "claude-code")
+    return "claude-code";
+  if (value === "codex")
+    return "codex";
+  if (value === "pi")
+    return "pi";
+  return;
+}
+async function runHooksCommand(args, cliEntry) {
+  const subcommand = args.find((arg) => arg !== "hooks" && arg !== "--dev" && !arg.startsWith("--"));
+  const scope = parseScope(args);
+  if (!subcommand || subcommand === "status") {
+    const rows = SUPPORTED_AGENTS.map((agent) => statusFor(agent, scope));
+    for (const row of rows) {
+      console.log(`[agendex] ${row.agent}: ${row.installed ? "installed" : "not installed"} (${row.detail})`);
+      console.log(`  ${row.path}`);
+    }
+    return 0;
+  }
+  if (subcommand === "doctor") {
+    await runHooksCommand(["hooks", "status", "--scope", scope], cliEntry);
+    console.log("[agendex] restart the target agent after installing or changing hooks.");
+    return 0;
+  }
+  if (subcommand === "install") {
+    const agentArg = args.find((arg, index) => index > args.indexOf("install") && !arg.startsWith("--") && arg !== scope);
+    const parsed = parseAgent(agentArg);
+    if (!parsed) {
+      console.error(`[agendex] usage: agendex hooks install <claude-code|codex|pi|all> [--scope repo|user] [--dry-run] [${CLAUDE_PREVIEW_FLAG}]`);
+      return 1;
+    }
+    const dryRun = args.includes("--dry-run");
+    const preview = args.includes(CLAUDE_PREVIEW_FLAG);
+    const agents = parsed === "all" ? SUPPORTED_AGENTS : [parsed];
+    if (!preview && agents.includes("claude-code")) {
+      printClaudePreviewBlock();
+      return 1;
+    }
+    for (const agent of agents) {
+      if (agent === "claude-code")
+        printClaudePreviewWarning(dryRun);
+      const path = await installAgent(agent, scope, resolve7(cliEntry), dryRun);
+      console.log(`[agendex] ${dryRun ? "would install" : "installed"} ${agent} hook: ${path}`);
+    }
+    return 0;
+  }
+  if (subcommand === "uninstall") {
+    const agentArg = args.find((arg, index) => index > args.indexOf("uninstall") && !arg.startsWith("--") && arg !== scope);
+    const parsed = parseAgent(agentArg);
+    if (!parsed) {
+      console.error("[agendex] usage: agendex hooks uninstall <claude-code|codex|pi|all> [--scope repo|user] [--dry-run]");
+      return 1;
+    }
+    const dryRun = args.includes("--dry-run");
+    const agents = parsed === "all" ? SUPPORTED_AGENTS : [parsed];
+    for (const agent of agents) {
+      const path = await uninstallAgent(agent, scope, dryRun);
+      console.log(`[agendex] ${dryRun ? "would uninstall" : "uninstalled"} ${agent} hook: ${path}`);
+    }
+    return 0;
+  }
+  console.error(`[agendex] unknown hooks command: ${subcommand}`);
+  return 1;
+}
+async function runHookReviewCommand(args) {
+  if (!args.includes("--hook")) {
+    console.error("[agendex] review-plan currently supports hook mode only: agendex review-plan --hook --agent <agent>");
+    return 1;
+  }
+  console.error("[agendex] hook-native plan review is not implemented yet. Uninstall this hook or wait for the interactive review-session server before enabling it.");
+  return 1;
+}
 // src/sync.ts
 import { hostname as osHostname3 } from "node:os";
 async function syncAll(force = false) {
@@ -4979,17 +5408,17 @@ async function syncAll(force = false) {
 // src/upgrade.ts
 import { spawn as spawn3, spawnSync } from "node:child_process";
 import { realpathSync as realpathSync2 } from "node:fs";
-import { dirname as dirname4, resolve as resolve7, sep as sep4 } from "node:path";
+import { dirname as dirname5, resolve as resolve8, sep as sep4 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 // src/version.ts
-import { existsSync as existsSync10, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.17.0",
+  version: "1.0.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   bugs: {
@@ -5033,14 +5462,14 @@ var package_default = {
 // src/version.ts
 var CLI_VERSION = package_default.version;
-var CACHE_FILE = process.env.AGENDEX_UPDATE_CACHE_FILE ?? join14(tmpdir(), ".agendex-update-cache.json");
+var CACHE_FILE = process.env.AGENDEX_UPDATE_CACHE_FILE ?? join15(tmpdir(), ".agendex-update-cache.json");
 var CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 var UPDATE_URL = process.env.AGENDEX_UPDATE_URL ?? "https://registry.npmjs.org/agendex-cli/latest";
 function readCache(current) {
   try {
-    if (!existsSync10(CACHE_FILE))
+    if (!existsSync11(CACHE_FILE))
       return null;
-    const { result, ts } = JSON.parse(readFileSync7(CACHE_FILE, "utf8"));
+    const { result, ts } = JSON.parse(readFileSync8(CACHE_FILE, "utf8"));
     if (Date.now() - ts > CACHE_TTL_MS)
       return null;
     return normalizeResult(result, current);
@@ -5109,12 +5538,12 @@ function isNewer(latest, current) {
 // src/upgrade.ts
 var PACKAGE_NAME = "agendex-cli";
-var moduleDir = dirname4(fileURLToPath2(import.meta.url));
+var moduleDir = dirname5(fileURLToPath2(import.meta.url));
 function getPackageRoot() {
   try {
-    return realpathSync2(resolve7(moduleDir, ".."));
+    return realpathSync2(resolve8(moduleDir, ".."));
   } catch {
-    return resolve7(moduleDir, "..");
+    return resolve8(moduleDir, "..");
   }
 }
 function detectPackageManager(packageRoot) {
@@ -5333,7 +5762,7 @@ function firstCommandToken(argv) {
   return;
 }
 var command = firstCommandToken(args) ?? "start";
-var cliEntry = resolve8(process.argv[1] ?? fileURLToPath3(import.meta.url));
+var cliEntry = resolve9(process.argv[1] ?? fileURLToPath3(import.meta.url));
 async function main() {
   const isInternal = args.includes("--daemon") || args.includes("--worker");
   if (command === "--version" || command === "-v") {
@@ -5348,6 +5777,8 @@ async function main() {
     "open",
     "view",
     "cleanup",
+    "hooks",
+    "review-plan",
     "add-dir",
     "remove-dir",
     "list-dirs",
@@ -5451,6 +5882,12 @@ async function main() {
       await syncAll(force);
       return 0;
     }
+    case "hooks": {
+      return await runHooksCommand(args, cliEntry);
+    }
+    case "review-plan": {
+      return await runHookReviewCommand(args);
+    }
     case "cleanup": {
       const config = loadConfig();
       if (!config?.cloudToken || !config?.convexUrl) {
@@ -5533,7 +5970,7 @@ async function main() {
         return 1;
       }
       const resolved = resolveCustomPlanDirPath(dirPath);
-      if (!existsSync11(resolved)) {
+      if (!existsSync12(resolved)) {
         writeStderr(`[agendex] path does not exist: ${resolved}`);
         return 1;
       }
@@ -5552,7 +5989,7 @@ async function main() {
         const { request } = await import("node:http");
         const body = JSON.stringify({ path: resolved });
         try {
-          const res = await new Promise((resolve9, reject) => {
+          const res = await new Promise((resolve10, reject) => {
             const req = request(`http://localhost:${port}/api/v1/plan-sources`, {
               method: "POST",
               headers: {
@@ -5566,7 +6003,7 @@ async function main() {
               res2.on("data", (chunk) => {
                 data += chunk;
               });
-              res2.on("end", () => resolve9({ status: res2.statusCode ?? 0, body: data }));
+              res2.on("end", () => resolve10({ status: res2.statusCode ?? 0, body: data }));
               res2.on("error", reject);
             });
             req.on("error", reject);
@@ -5716,6 +6153,10 @@ Usage:
   agendex view <url>   Open a shared plan URL in your browser
   agendex logout       Clear stored cloud token
   agendex configure    Select which agents/adapters to index
+  agendex hooks status Show Claude Code, Codex, and Pi hook status
+  agendex hooks install <agent|all>  Install hook integration (--preview required for claude-code)
+  agendex hooks uninstall <agent|all>  Remove managed Agendex hook entries
+  agendex review-plan --hook --agent <agent>  Hook-native plan review command
   agendex add-dir <path>  Add a custom directory to scan for plans
   agendex add-dir <path> --live  Add dir and notify running server immediately
   agendex remove-dir <path>  Remove a custom directory
@@ -5755,13 +6196,13 @@ function flushStream(stream) {
   if (stream.destroyed || !stream.writable) {
     return Promise.resolve();
   }
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, reject) => {
     stream.write("", (error) => {
       if (error) {
         reject(error);
         return;
       }
-      resolve9();
+      resolve10();
     });
   });
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agendex-cli",
-  "version": "0.17.0",
+  "version": "1.0.0",
   "description": "Agendex CLI for login, sync, and daemon workflows",
   "homepage": "https://github.com/Tyru5/Agendex#readme",
   "repository": {