codealmanac 0.1.10 → 0.2.0

package/dist/{register-commands-JHC2OFKM.js → register-commands-7SKQLQW4.js}

@@ -1,4 +1,16 @@
 #!/usr/bin/env node
+import {
+  collectOption,
+  emit,
+  parsePositiveInt,
+  readStdin
+} from "./chunk-P3LDTCLB.js";
+import {
+  assertAgentAuth,
+  runAgentsList,
+  runSetAgentModel,
+  runSetDefaultAgent
+} from "./chunk-R3URPHGH.js";
 import {
   addEntry,
   ancestorsInFile,
@@ -24,21 +36,9 @@ import {
 } from "./chunk-3C5SY5SE.js";
 import {
   runDoctor
-} from "./chunk-QLHJP2XK.js";
+} from "./chunk-D3B2EEHL.js";
+import "./chunk-V3QOQSXI.js";
 import "./chunk-4CODZRHH.js";
-import {
-  runUninstall
-} from "./chunk-BJVZLP6O.js";
-import {
-  runUpdate
-} from "./chunk-Z6MBJ3D2.js";
-import {
-  collectOption,
-  emit,
-  parsePositiveInt,
-  readStdin
-} from "./chunk-P3LDTCLB.js";
-import "./chunk-QHQ6YH7U.js";
 import {
   BLUE,
   BOLD,
@@ -46,16 +46,27 @@ import {
   RST
 } from "./chunk-FM3VRDK7.js";
 import {
-  assertClaudeAuth,
-  resolveClaudeExecutable,
+  runUninstall
+} from "./chunk-MX2EW5MR.js";
+import {
   runSetup
-} from "./chunk-3LC55TG6.js";
+} from "./chunk-ZDJSJIB6.js";
 import {
   runHookInstall,
   runHookStatus,
   runHookUninstall
-} from "./chunk-Z4MWLVS2.js";
-import "./chunk-AXFPUHBN.js";
+} from "./chunk-447U3GQJ.js";
+import {
+  resolveClaudeExecutable
+} from "./chunk-SSYMRT4I.js";
+import {
+  runUpdate
+} from "./chunk-QQHIVTXT.js";
+import "./chunk-F53U6JQG.js";
+import {
+  isAgentProviderId,
+  readConfig
+} from "./chunk-WRUSDYYE.js";
 import {
   findNearestAlmanacDir,
   getRepoAlmanacDir
@@ -1761,10 +1772,33 @@ function registerQueryCommands(program) {
 
 // src/cli/register-setup-commands.ts
 function registerSetupCommands(program) {
-  program.command("setup").description("install the hook + CLAUDE.md guides (bare codealmanac alias)").option("-y, --yes", "skip prompts; install everything").option("--skip-hook", "opt out of the SessionEnd hook").option("--skip-guides", "opt out of the CLAUDE.md guides").action(
+  const agents = program.command("agents").description("list supported AI agent providers and readiness");
+  agents.command("list").description("show Claude, Codex, and Cursor provider status").action(async () => {
+    emit(await runAgentsList());
+  });
+  program.command("set").description("configure codealmanac defaults").argument("<key>", "setting key, e.g. default-agent or model").argument("[value...]", "setting value").action(async (key, value) => {
+    if (key === "default-agent") {
+      emit(await runSetDefaultAgent({ provider: value[0] ?? "" }));
+      return;
+    }
+    if (key === "model") {
+      emit(await runSetAgentModel({
+        provider: value[0] ?? "",
+        model: value[1]
+      }));
+      return;
+    }
+    emit({
+      stdout: "",
+      stderr: "almanac: unknown setting. Use `default-agent` or `model`.\n",
+      exitCode: 1
+    });
+  });
+  program.command("setup").description("install the hook + CLAUDE.md guides (bare codealmanac alias)").option("-y, --yes", "skip prompts; install everything").option("--agent <agent>", "default agent: claude, codex, or cursor").option("--skip-hook", "opt out of the SessionEnd hook").option("--skip-guides", "opt out of the CLAUDE.md guides").action(
     async (opts) => {
       const result = await runSetup({
         yes: opts.yes,
+        agent: opts.agent,
         skipHook: opts.skipHook,
         skipGuides: opts.skipGuides
       });
@@ -1869,8 +1903,19 @@ async function loadPrompt(name) {
 }
 
 // src/agent/sdk.ts
+import { spawn } from "child_process";
 import { query } from "@anthropic-ai/claude-agent-sdk";
 async function runAgent(opts) {
+  const provider = opts.provider ?? "claude";
+  if (provider === "codex") {
+    return await runCodexAgent(opts);
+  }
+  if (provider === "cursor") {
+    return await runCursorAgent(opts);
+  }
+  return await runClaudeAgent(opts);
+}
+async function runClaudeAgent(opts) {
   const claudeExecutable = resolveClaudeExecutable();
   const q = query({
     prompt: opts.prompt,
@@ -1925,6 +1970,186 @@ async function runAgent(opts) {
   }
   return { success, cost, turns, result, sessionId, error: errorMsg };
 }
+function combinedPrompt(opts) {
+  const reviewerFallback = buildReviewerFallback(opts);
+  return `${opts.systemPrompt}${reviewerFallback}
+
+---
+
+${opts.prompt}`;
+}
+function buildReviewerFallback(opts) {
+  if ((opts.provider ?? "claude") === "claude") return "";
+  const reviewer = opts.agents?.reviewer;
+  if (reviewer === void 0) return "";
+  return "\n\nNon-Claude provider note: this runtime does not receive Claude's nested Agent tool contract. When the writer prompt asks you to invoke the reviewer subagent, perform that review pass yourself before final wiki edits. Treat this reviewer prompt as read-only review guidance:\n\n" + reviewer.prompt;
+}
+async function runCodexAgent(opts) {
+  const args = [
+    "exec",
+    "--json",
+    "--sandbox",
+    "workspace-write",
+    "--skip-git-repo-check",
+    "-C",
+    opts.cwd
+  ];
+  if (opts.model !== void 0 && opts.model.length > 0) {
+    args.push("--model", opts.model);
+  }
+  args.push(combinedPrompt(opts));
+  return await runJsonlCli({
+    command: "codex",
+    args,
+    cwd: opts.cwd,
+    env: { ...process.env, CODEALMANAC_INTERNAL_SESSION: "1" },
+    onMessage: opts.onMessage,
+    parseFinal: parseCodexFinal
+  });
+}
+async function runCursorAgent(opts) {
+  const args = [
+    "--print",
+    "--output-format",
+    "stream-json",
+    "--stream-partial-output",
+    "--trust",
+    "--workspace",
+    opts.cwd
+  ];
+  if (opts.model !== void 0 && opts.model.length > 0) {
+    args.push("--model", opts.model);
+  }
+  args.push(combinedPrompt(opts));
+  return await runJsonlCli({
+    command: "cursor-agent",
+    args,
+    cwd: opts.cwd,
+    env: { ...process.env, CODEALMANAC_INTERNAL_SESSION: "1" },
+    onMessage: opts.onMessage,
+    parseFinal: parseCursorFinal
+  });
+}
+function runJsonlCli(opts) {
+  return new Promise((resolve) => {
+    const child = spawn(opts.command, opts.args, {
+      cwd: opts.cwd,
+      env: opts.env,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdoutBuf = "";
+    let stderr = "";
+    let cost = 0;
+    let turns = 0;
+    let result = "";
+    let sessionId;
+    let success = false;
+    let finalSeen = false;
+    let error;
+    const observe = (msg) => {
+      opts.onMessage?.(msg);
+      if (sessionId === void 0 && typeof msg.session_id === "string" && msg.session_id.length > 0) {
+        sessionId = msg.session_id;
+      }
+      const final = opts.parseFinal(msg);
+      if (final === null) return;
+      finalSeen = true;
+      if (final.cost !== void 0) cost = final.cost;
+      if (final.turns !== void 0) turns = final.turns;
+      if (final.result !== void 0) result = final.result;
+      if (final.sessionId !== void 0) sessionId = final.sessionId;
+      if (final.success !== void 0) success = final.success;
+      if (final.error !== void 0) error = final.error;
+    };
+    const flushLines = () => {
+      let idx = stdoutBuf.indexOf("\n");
+      while (idx !== -1) {
+        const rawLine = stdoutBuf.slice(0, idx);
+        stdoutBuf = stdoutBuf.slice(idx + 1);
+        const line = rawLine.trim();
+        if (line.length > 0) {
+          try {
+            const parsed = JSON.parse(line);
+            observe(parsed);
+          } catch {
+          }
+        }
+        idx = stdoutBuf.indexOf("\n");
+      }
+    };
+    child.stdout.on("data", (chunk) => {
+      stdoutBuf += chunk.toString("utf8");
+      flushLines();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString("utf8");
+    });
+    child.on("error", (err) => {
+      resolve({
+        success: false,
+        cost,
+        turns,
+        result,
+        sessionId,
+        error: err.code === "ENOENT" ? `${opts.command} not found on PATH` : err.message
+      });
+    });
+    child.on("close", (code) => {
+      flushLines();
+      if (stdoutBuf.trim().length > 0) {
+        try {
+          observe(JSON.parse(stdoutBuf.trim()));
+        } catch {
+        }
+      }
+      if (code === 0 && finalSeen && success) {
+        resolve({ success, cost, turns, result, sessionId });
+        return;
+      }
+      const firstStderr = stderr.trim().split("\n")[0];
+      resolve({
+        success: false,
+        cost,
+        turns,
+        result,
+        sessionId,
+        error: error ?? (firstStderr !== void 0 && firstStderr.length > 0 ? firstStderr : `${opts.command} exited ${code ?? 1}`)
+      });
+    });
+  });
+}
+function parseCodexFinal(msg) {
+  if (msg.type === "item.completed") {
+    const item = msg.item;
+    if (item !== null && typeof item === "object") {
+      const obj = item;
+      if (obj.type === "agent_message" && typeof obj.text === "string") {
+        return { result: obj.text };
+      }
+    }
+    return null;
+  }
+  if (msg.type === "turn.completed") {
+    return { success: true };
+  }
+  if (msg.type === "turn.failed" || msg.type === "error") {
+    return {
+      success: false,
+      error: typeof msg.message === "string" ? msg.message : typeof msg.error === "string" ? msg.error : "codex turn failed"
+    };
+  }
+  return null;
+}
+function parseCursorFinal(msg) {
+  if (msg.type !== "result") return null;
+  const isError = msg.is_error === true || msg.subtype !== "success";
+  return {
+    success: !isError,
+    result: typeof msg.result === "string" ? msg.result : "",
+    sessionId: typeof msg.session_id === "string" ? msg.session_id : void 0,
+    error: isError ? typeof msg.result === "string" ? msg.result : `cursor result: ${String(msg.subtype ?? "error")}` : void 0
+  };
+}
 
 // src/commands/init.ts
 import { existsSync as existsSync4 } from "fs";
@@ -2069,8 +2294,21 @@ and optional \`files:\`. The rest is prose.
 // src/commands/bootstrap.ts
 var BOOTSTRAP_TOOLS = ["Read", "Write", "Edit", "Glob", "Grep", "Bash"];
 async function runBootstrap(options) {
+  const providerResolution = await resolveAgentSelection({
+    agent: options.agent,
+    model: options.model
+  });
+  if (!providerResolution.ok) {
+    return {
+      stdout: "",
+      stderr: `almanac: ${providerResolution.error}
+`,
+      exitCode: 1
+    };
+  }
+  const { provider, model } = providerResolution;
   try {
-    await assertClaudeAuth(options.spawnCli);
+    await assertAgentAuth({ provider, spawnCli: options.spawnCli });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
@@ -2137,7 +2375,8 @@ async function runBootstrap(options) {
       prompt: userPrompt,
       allowedTools: BOOTSTRAP_TOOLS,
       cwd: repoRoot,
-      model: options.model,
+      provider,
+      model,
       onMessage
     });
   } finally {
@@ -2160,6 +2399,19 @@ async function runBootstrap(options) {
     exitCode: 1
   };
 }
+async function resolveAgentSelection(args) {
+  const config = await readConfig();
+  const rawProvider = args.agent ?? config.agent.default;
+  if (!isAgentProviderId(rawProvider)) {
+    return {
+      ok: false,
+      error: `unknown agent '${rawProvider}'. Expected one of: claude, codex, cursor.`
+    };
+  }
+  const configuredModel = config.agent.models[rawProvider] ?? void 0;
+  const model = args.model !== void 0 ? args.model : configuredModel === null ? void 0 : configuredModel;
+  return { ok: true, provider: rawProvider, model };
+}
 function formatFinalLine(result, logPath, repoRoot) {
   const status = result.success ? "done" : "failed";
   const rel = relative(repoRoot, logPath);
@@ -2210,17 +2462,23 @@ var StreamingFormatter = class {
     this.currentAgent = name;
   }
   handle(msg) {
-    if (msg.type === "assistant") {
+    if (!isRecord(msg)) return;
+    if (msg.type === "assistant" && isRecord(msg.message)) {
+      const content = msg.message.content;
+      if (!Array.isArray(content)) return;
       for (const block of msg.message.content) {
-        if (block.type !== "tool_use") continue;
+        if (!isRecord(block) || block.type !== "tool_use") continue;
+        if (typeof block.name !== "string") continue;
         this.handleToolUse(block.name, block.input);
       }
       return;
     }
     if (msg.type === "result") {
       const status = msg.subtype === "success" ? "done" : `failed (${msg.subtype})`;
+      const cost = typeof msg.total_cost_usd === "number" ? msg.total_cost_usd : 0;
+      const turns = typeof msg.num_turns === "number" ? msg.num_turns : 0;
       this.sink.write(
-        `[${status}] cost: $${msg.total_cost_usd.toFixed(3)}, turns: ${msg.num_turns}
+        `[${status}] cost: $${cost.toFixed(3)}, turns: ${turns}
 `
       );
       return;
@@ -2292,6 +2550,9 @@ function stringField(input, key) {
   const value = input[key];
   return typeof value === "string" ? value : void 0;
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object";
+}
 
 // src/commands/capture.ts
 import { createHash } from "crypto";
@@ -2307,8 +2568,21 @@ var WRITER_TOOLS = ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Agent"];
 var REVIEWER_TOOLS = ["Read", "Grep", "Glob", "Bash"];
 var REVIEWER_DESCRIPTION = "Reviews proposed wiki changes against the full knowledge base for cohesion, duplication, missing links, notability, and writing conventions.";
 async function runCapture(options) {
+  const providerResolution = await resolveAgentSelection2({
+    agent: options.agent,
+    model: options.model
+  });
+  if (!providerResolution.ok) {
+    return {
+      stdout: "",
+      stderr: `almanac: ${providerResolution.error}
+`,
+      exitCode: 1
+    };
+  }
+  const { provider, model } = providerResolution;
   try {
-    await assertClaudeAuth(options.spawnCli);
+    await assertAgentAuth({ provider, spawnCli: options.spawnCli });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
@@ -2387,7 +2661,8 @@ Working directory: ${repoRoot}.`;
       allowedTools: WRITER_TOOLS,
       agents,
       cwd: repoRoot,
-      model: options.model,
+      provider,
+      model,
       // Capture sessions can touch many pages; give it more headroom than
       // bootstrap. The SDK treats `maxTurns` as a hard stop — better to
       // overshoot than to cut off mid-review.
@@ -2416,6 +2691,19 @@ Working directory: ${repoRoot}.`;
     exitCode: 0
   };
 }
+async function resolveAgentSelection2(args) {
+  const config = await readConfig();
+  const rawProvider = args.agent ?? config.agent.default;
+  if (!isAgentProviderId(rawProvider)) {
+    return {
+      ok: false,
+      error: `unknown agent '${rawProvider}'. Expected one of: claude, codex, cursor.`
+    };
+  }
+  const configuredModel = config.agent.models[rawProvider] ?? void 0;
+  const model = args.model !== void 0 ? args.model : configuredModel === null ? void 0 : configuredModel;
+  return { ok: true, provider: rawProvider, model };
+}
 async function resolveTranscript(args) {
   if (args.explicit !== void 0 && args.explicit.length > 0) {
     if (!existsSync6(args.explicit)) {
@@ -2594,18 +2882,19 @@ async function runReindex(options) {
 function registerWikiLifecycleCommands(program) {
   program.command("bootstrap").description(
     "scaffold a wiki in this repo via an AI agent (requires ANTHROPIC_API_KEY or Claude subscription)"
-  ).option("--quiet", "suppress per-tool streaming; print only the final line").option("--model <model>", "override the agent model").option("--force", "overwrite an existing populated wiki (default: refuse)").action(
+  ).option("--quiet", "suppress per-tool streaming; print only the final line").option("--agent <agent>", "agent provider: claude, codex, or cursor").option("--model <model>", "override the agent model").option("--force", "overwrite an existing populated wiki (default: refuse)").action(
     async (opts) => {
       const result = await runBootstrap({
         cwd: process.cwd(),
         quiet: opts.quiet,
+        agent: opts.agent,
         model: opts.model,
         force: opts.force
       });
       emit(result);
     }
   );
-  program.command("capture [transcript]").description("run the writer/reviewer pipeline on a session (usually automatic)").option("--session <id>", "target a specific session by ID").option("--quiet", "suppress per-tool streaming; print only the final summary").option("--model <model>", "override the agent model").action(
+  program.command("capture [transcript]").description("run the writer/reviewer pipeline on a session (usually automatic)").option("--session <id>", "target a specific session by ID").option("--quiet", "suppress per-tool streaming; print only the final summary").option("--agent <agent>", "agent provider: claude, codex, or cursor").option("--model <model>", "override the agent model").action(
     async (transcript, opts) => {
       await autoRegisterIfNeeded(process.cwd());
       const result = await runCapture({
@@ -2613,14 +2902,17 @@ function registerWikiLifecycleCommands(program) {
         transcriptPath: transcript,
         sessionId: opts.session,
         quiet: opts.quiet,
+        agent: opts.agent,
         model: opts.model
       });
       emit(result);
     }
   );
   const hook = program.command("hook").description("manage the SessionEnd auto-capture hook");
-  hook.command("install").description("add a SessionEnd entry that runs 'almanac capture' on session end").action(async () => {
-    const result = await runHookInstall();
+  hook.command("install").description("add a SessionEnd entry that runs 'almanac capture' on session end").option("--source <source>", "claude, codex, cursor, or all").action(async (opts) => {
+    const result = await runHookInstall({
+      source: normalizeHookSource(opts.source)
+    });
     emit(result);
   });
   hook.command("uninstall").description("remove codealmanac's SessionEnd entry; leaves foreign entries alone").action(async () => {
@@ -2641,6 +2933,12 @@ function registerWikiLifecycleCommands(program) {
     if (result.exitCode !== 0) process.exitCode = result.exitCode;
   });
 }
+function normalizeHookSource(source) {
+  if (source === "claude" || source === "codex" || source === "cursor" || source === "all") {
+    return source;
+  }
+  return void 0;
+}
 
 // src/cli/register-commands.ts
 function registerCommands(program) {
@@ -2652,4 +2950,4 @@ function registerCommands(program) {
 export {
   registerCommands
 };
-//# sourceMappingURL=register-commands-JHC2OFKM.js.map
+//# sourceMappingURL=register-commands-7SKQLQW4.js.map