codealmanac 0.2.0 → 0.2.1

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

@@ -33,10 +33,10 @@ import {
   titleCase,
   toKebabCase,
   writeTopicsFile
-} from "./chunk-3C5SY5SE.js";
+} from "./chunk-KQUVMF27.js";
 import {
   runDoctor
-} from "./chunk-D3B2EEHL.js";
+} from "./chunk-B2AGSRXL.js";
 import "./chunk-V3QOQSXI.js";
 import "./chunk-4CODZRHH.js";
 import {
@@ -1905,6 +1905,7 @@ async function loadPrompt(name) {
 // src/agent/sdk.ts
 import { spawn } from "child_process";
 import { query } from "@anthropic-ai/claude-agent-sdk";
+var DEFAULT_AGENT_MODEL = "claude-sonnet-4-6";
 async function runAgent(opts) {
   const provider = opts.provider ?? "claude";
   if (provider === "codex") {
@@ -1924,7 +1925,7 @@ async function runClaudeAgent(opts) {
       allowedTools: opts.allowedTools,
       agents: opts.agents ?? {},
       cwd: opts.cwd,
-      model: opts.model ?? "claude-sonnet-4-6",
+      model: opts.model ?? DEFAULT_AGENT_MODEL,
       maxTurns: opts.maxTurns ?? 100,
       ...claudeExecutable !== void 0 ? { pathToClaudeCodeExecutable: claudeExecutable } : {},
       env: {
@@ -2558,12 +2559,219 @@ function isRecord(value) {
 import { createHash } from "crypto";
 import {
   createWriteStream as createWriteStream2,
-  existsSync as existsSync6,
+  existsSync as existsSync7,
   statSync
 } from "fs";
-import { mkdir as mkdir3, readFile as readFile6, readdir as readdir2, stat } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile7, readdir as readdir3, stat } from "fs/promises";
 import { homedir } from "os";
-import { basename as basename3, join as join7, relative as relative2 } from "path";
+import { basename as basename3, join as join8, relative as relative3 } from "path";
+
+// src/commands/captureStatus.ts
+import { existsSync as existsSync6 } from "fs";
+import { mkdir as mkdir3, readFile as readFile6, readdir as readdir2, rename as rename2, writeFile as writeFile3 } from "fs/promises";
+import { dirname, join as join7, relative as relative2 } from "path";
+function captureStatePath(dir, stem) {
+  return join7(dir, `.capture-${stem}.state.json`);
+}
+async function writeCaptureRunRecord(path2, record) {
+  await mkdir3(dirname(path2), { recursive: true });
+  const tmp = `${path2}.tmp-${process.pid}`;
+  await writeFile3(tmp, `${JSON.stringify(record, null, 2)}
+`, "utf8");
+  await rename2(tmp, path2);
+}
+function buildStartedCaptureRecord(args) {
+  return {
+    version: 1,
+    kind: "capture",
+    status: "running",
+    sessionId: args.sessionId ?? args.stem,
+    repoRoot: args.repoRoot,
+    pid: process.pid,
+    model: args.model ?? DEFAULT_AGENT_MODEL,
+    transcriptPath: args.transcriptPath,
+    startedAt: args.startedAt.toISOString(),
+    logPath: join7(args.almanacDir, `.capture-${args.stem}.log`),
+    jsonlPath: join7(args.almanacDir, `.capture-${args.stem}.jsonl`)
+  };
+}
+function finishCaptureRecord(args) {
+  const started = Date.parse(args.record.startedAt);
+  const finished = args.finishedAt.getTime();
+  return {
+    ...args.record,
+    status: args.status,
+    finishedAt: args.finishedAt.toISOString(),
+    durationMs: Number.isFinite(started) ? Math.max(0, finished - started) : void 0,
+    summary: args.summary,
+    error: args.error
+  };
+}
+async function runCaptureStatus(options) {
+  const repoRoot = findNearestAlmanacDir(options.cwd);
+  if (repoRoot === null) {
+    return {
+      stdout: "",
+      stderr: "almanac: no .almanac/ found in this directory or any parent. Run 'almanac bootstrap' first.\n",
+      exitCode: 1
+    };
+  }
+  const almanacDir = getRepoAlmanacDir(repoRoot);
+  const records = await readCaptureRecords(almanacDir);
+  const now = options.now?.() ?? /* @__PURE__ */ new Date();
+  const isPidAlive = options.isPidAlive ?? defaultIsPidAlive;
+  const views = records.map((record) => toView(record, repoRoot, now, isPidAlive)).sort((a, b) => b.sortTime - a.sortTime);
+  if (options.json === true) {
+    return {
+      stdout: `${JSON.stringify(
+        {
+          repo: repoRoot,
+          captures: views.map(({ sortTime: _sortTime, ...v }) => v)
+        },
+        null,
+        2
+      )}
+`,
+      stderr: "",
+      exitCode: 0
+    };
+  }
+  return {
+    stdout: formatCaptureStatus(views),
+    stderr: "",
+    exitCode: 0
+  };
+}
+async function readCaptureRecords(almanacDir) {
+  if (!existsSync6(almanacDir)) return [];
+  const out = [];
+  const dirs = [join7(almanacDir, "logs"), almanacDir];
+  for (const dir of dirs) {
+    let entries;
+    try {
+      entries = await readdir2(dir);
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (!entry.startsWith(".capture-") || !entry.endsWith(".state.json")) {
+        continue;
+      }
+      try {
+        const parsed = JSON.parse(await readFile6(join7(dir, entry), "utf8"));
+        if (isCaptureRunRecord(parsed)) out.push(parsed);
+      } catch {
+        continue;
+      }
+    }
+  }
+  return out;
+}
+function isCaptureRunRecord(value) {
+  if (value === null || typeof value !== "object") return false;
+  const v = value;
+  return v.version === 1 && v.kind === "capture" && (v.status === "running" || v.status === "done" || v.status === "failed") && typeof v.sessionId === "string" && typeof v.repoRoot === "string" && typeof v.pid === "number" && typeof v.model === "string" && typeof v.transcriptPath === "string" && typeof v.startedAt === "string" && typeof v.logPath === "string" && typeof v.jsonlPath === "string";
+}
+function toView(record, repoRoot, now, isPidAlive) {
+  const started = Date.parse(record.startedAt);
+  const finished = record.finishedAt !== void 0 ? Date.parse(record.finishedAt) : void 0;
+  const elapsedMs = record.durationMs ?? (Number.isFinite(started) ? Math.max(0, (finished ?? now.getTime()) - started) : 0);
+  const status = record.status === "running" && !isPidAlive(record.pid) ? "stale" : record.status;
+  return {
+    status,
+    sessionId: record.sessionId,
+    model: record.model,
+    elapsedMs,
+    startedAt: record.startedAt,
+    finishedAt: record.finishedAt,
+    pid: record.pid,
+    logPath: relative2(repoRoot, record.logPath),
+    jsonlPath: relative2(repoRoot, record.jsonlPath),
+    summary: record.summary,
+    error: status === "stale" ? "process ended without a final status" : record.error,
+    sortTime: finished ?? (Number.isFinite(started) ? started : 0)
+  };
+}
+function formatCaptureStatus(views) {
+  const lines = ["Capture jobs", ""];
+  if (views.length === 0) {
+    lines.push("No capture jobs found.");
+    return `${lines.join("\n")}
+`;
+  }
+  const active = views.filter((v) => v.status === "running" || v.status === "stale");
+  const finished = views.filter((v) => v.status === "done" || v.status === "failed");
+  if (active.length === 0) {
+    lines.push("No active captures.", "");
+  } else {
+    for (const view of active) {
+      lines.push(formatRow(view));
+      lines.push(`         log: ${view.logPath}`);
+      if (view.error !== void 0) lines.push(`         error: ${view.error}`);
+      lines.push("");
+    }
+  }
+  if (finished.length > 0) {
+    lines.push(active.length === 0 ? "Last capture:" : "Last finished:");
+    for (const view of finished.slice(0, 3)) {
+      lines.push(formatRow(view));
+      if (view.status === "failed") {
+        lines.push(`         log: ${view.logPath}`);
+        if (view.error !== void 0) lines.push(`         error: ${view.error}`);
+      }
+    }
+  }
+  return `${trimTrailingBlank(lines).join("\n")}
+`;
+}
+function formatRow(view) {
+  const status = view.status.padEnd(7, " ");
+  const session = view.sessionId.padEnd(12, " ");
+  const model = view.model.padEnd(17, " ");
+  const elapsed = formatDuration(view.elapsedMs);
+  const summary = formatSummary(view);
+  return `${status}  ${session}  ${model}  ${elapsed}${summary.length > 0 ? `  ${summary}` : ""}`;
+}
+function formatSummary(view) {
+  if (view.status === "failed") return "failed; see log";
+  if (view.summary === void 0) return "";
+  const parts = [];
+  if (view.summary.updated > 0) {
+    parts.push(`${view.summary.updated} updated`);
+  }
+  if (view.summary.created > 0) {
+    parts.push(`${view.summary.created} created`);
+  }
+  if (view.summary.archived > 0) {
+    parts.push(`${view.summary.archived} archived`);
+  }
+  return parts.length > 0 ? parts.join(", ") : "0 pages written";
+}
+function formatDuration(ms) {
+  const totalSeconds = Math.max(0, Math.floor(ms / 1e3));
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  if (minutes < 60) return `${minutes}m${seconds.toString().padStart(2, "0")}s`;
+  const hours = Math.floor(minutes / 60);
+  const restMinutes = minutes % 60;
+  return `${hours}h${restMinutes.toString().padStart(2, "0")}m`;
+}
+function trimTrailingBlank(lines) {
+  while (lines.length > 0 && lines[lines.length - 1] === "") {
+    lines.pop();
+  }
+  return lines;
+}
+function defaultIsPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/commands/capture.ts
 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.";
@@ -2601,7 +2809,7 @@ async function runCapture(options) {
     };
   }
   const almanacDir = getRepoAlmanacDir(repoRoot);
-  const pagesDir = join7(almanacDir, "pages");
+  const pagesDir = join8(almanacDir, "pages");
   const transcriptResolution = await resolveTranscript({
     repoRoot,
     explicit: options.transcriptPath,
@@ -2627,12 +2835,24 @@ async function runCapture(options) {
       tools: REVIEWER_TOOLS
     }
   };
-  const now = options.now?.() ?? /* @__PURE__ */ new Date();
-  const logStem = options.sessionId !== void 0 && options.sessionId.length > 0 ? options.sessionId : formatTimestamp2(now);
-  const logsDir = join7(almanacDir, "logs");
-  await mkdir3(logsDir, { recursive: true });
+  const startedAt = options.now?.() ?? /* @__PURE__ */ new Date();
+  const logStem = options.sessionId !== void 0 && options.sessionId.length > 0 ? options.sessionId : formatTimestamp2(startedAt);
+  const logsDir = join8(almanacDir, "logs");
+  await mkdir4(logsDir, { recursive: true });
   const logName = `.capture-${logStem}.jsonl`;
-  const logPath = join7(logsDir, logName);
+  const logPath = join8(logsDir, logName);
+  const statePath = captureStatePath(logsDir, logStem);
+  const stateRecord = buildStartedCaptureRecord({
+    repoRoot,
+    almanacDir: logsDir,
+    stem: logStem,
+    sessionId: options.sessionId,
+    transcriptPath,
+    model: options.model,
+    startedAt
+  });
+  await writeCaptureRunRecord(statePath, stateRecord).catch(() => {
+  });
   const logStream = createWriteStream2(logPath, { flags: "w" });
   const out = process.stdout;
   const formatter = new StreamingFormatter({
@@ -2674,16 +2894,43 @@ Working directory: ${repoRoot}.`;
   }
   const snapshotAfter = await snapshotPages(pagesDir);
   const delta = diffSnapshots(snapshotBefore, snapshotAfter);
+  const finishedAt = options.now?.() ?? /* @__PURE__ */ new Date();
+  const captureSummary = {
+    ...delta,
+    cost: result.cost,
+    turns: result.turns
+  };
   if (!result.success) {
+    await writeCaptureRunRecord(
+      statePath,
+      finishCaptureRecord({
+        record: stateRecord,
+        status: "failed",
+        finishedAt,
+        summary: captureSummary,
+        error: result.error ?? "unknown error"
+      })
+    ).catch(() => {
+    });
     return {
       stdout: "",
       stderr: `almanac: capture failed: ${result.error ?? "unknown error"}
-(transcript: ${relative2(repoRoot, logPath)})
+(transcript: ${relative3(repoRoot, logPath)})
 `,
       exitCode: 1
     };
   }
-  const summary = formatSummary(result, delta, logPath, repoRoot);
+  await writeCaptureRunRecord(
+    statePath,
+    finishCaptureRecord({
+      record: stateRecord,
+      status: "done",
+      finishedAt,
+      summary: captureSummary
+    })
+  ).catch(() => {
+  });
+  const summary = formatSummary2(result, delta, logPath, repoRoot);
   return {
     stdout: `${summary}
 `,
@@ -2706,7 +2953,7 @@ async function resolveAgentSelection2(args) {
 }
 async function resolveTranscript(args) {
   if (args.explicit !== void 0 && args.explicit.length > 0) {
-    if (!existsSync6(args.explicit)) {
+    if (!existsSync7(args.explicit)) {
       return {
         ok: false,
         error: `transcript not found: ${args.explicit}`
@@ -2714,8 +2961,8 @@ async function resolveTranscript(args) {
     }
     return { ok: true, path: args.explicit };
   }
-  const projectsDir = args.claudeProjectsDir ?? join7(homedir(), ".claude", "projects");
-  if (!existsSync6(projectsDir)) {
+  const projectsDir = args.claudeProjectsDir ?? join8(homedir(), ".claude", "projects");
+  if (!existsSync7(projectsDir)) {
     return {
       ok: false,
       error: `could not auto-resolve transcript; ${projectsDir} does not exist. Pass --session <id> or <transcript-path>.`
@@ -2747,21 +2994,21 @@ async function collectTranscripts(projectsDir) {
   const out = [];
   let topLevel;
   try {
-    topLevel = await readdir2(projectsDir);
+    topLevel = await readdir3(projectsDir);
   } catch {
     return out;
   }
   for (const name of topLevel) {
-    const projectDir = join7(projectsDir, name);
+    const projectDir = join8(projectsDir, name);
     let entries;
     try {
-      entries = await readdir2(projectDir);
+      entries = await readdir3(projectDir);
     } catch {
       continue;
     }
     for (const entry of entries) {
       if (!entry.endsWith(".jsonl")) continue;
-      const full = join7(projectDir, entry);
+      const full = join8(projectDir, entry);
       try {
         const st = await stat(full);
         if (st.isFile()) {
@@ -2776,7 +3023,7 @@ async function collectTranscripts(projectsDir) {
 async function filterTranscriptsByCwd(transcripts, repoRoot) {
   const dirHash = `-${repoRoot.replace(/^\/+/, "").replace(/\//g, "-")}`;
   const byDirName = transcripts.filter((t) => {
-    const parent = basename3(join7(t.path, ".."));
+    const parent = basename3(join8(t.path, ".."));
     return parent === dirHash || parent.endsWith(dirHash);
   });
   if (byDirName.length > 0) return byDirName;
@@ -2793,26 +3040,26 @@ async function filterTranscriptsByCwd(transcripts, repoRoot) {
   return hits;
 }
 async function readHead(path2, bytes) {
-  const content = await readFile6(path2, "utf8");
+  const content = await readFile7(path2, "utf8");
   return content.length > bytes ? content.slice(0, bytes) : content;
 }
 async function snapshotPages(pagesDir) {
   const out = /* @__PURE__ */ new Map();
-  if (!existsSync6(pagesDir)) return out;
+  if (!existsSync7(pagesDir)) return out;
   let entries;
   try {
-    entries = await readdir2(pagesDir);
+    entries = await readdir3(pagesDir);
   } catch {
     return out;
   }
   for (const entry of entries) {
     if (!entry.endsWith(".md")) continue;
     const slug = entry.slice(0, -3);
-    const full = join7(pagesDir, entry);
+    const full = join8(pagesDir, entry);
     try {
       const st = statSync(full);
       if (!st.isFile()) continue;
-      const content = await readFile6(full, "utf8");
+      const content = await readFile7(full, "utf8");
       const hash = createHash("sha256").update(content).digest("hex");
       const fm = parseFrontmatter(content);
       out.set(slug, {
@@ -2846,8 +3093,8 @@ function diffSnapshots(before, after) {
   }
   return { created, updated, archived };
 }
-function formatSummary(result, delta, logPath, repoRoot) {
-  const rel = relative2(repoRoot, logPath);
+function formatSummary2(result, delta, logPath, repoRoot) {
+  const rel = relative3(repoRoot, logPath);
   const cost = `$${result.cost.toFixed(3)}`;
   const { created, updated, archived } = delta;
   if (created === 0 && updated === 0 && archived === 0) {
@@ -2894,7 +3141,7 @@ function registerWikiLifecycleCommands(program) {
       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("--agent <agent>", "agent provider: claude, codex, or cursor").option("--model <model>", "override the agent model").action(
+  const capture = program.command("capture [transcript]").alias("c").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({
@@ -2908,6 +3155,22 @@ function registerWikiLifecycleCommands(program) {
       emit(result);
     }
   );
+  capture.command("status").description("show running and recent capture jobs").option("--json", "emit structured JSON").action(async (opts) => {
+    await autoRegisterIfNeeded(process.cwd());
+    const result = await runCaptureStatus({
+      cwd: process.cwd(),
+      json: opts.json
+    });
+    emit(result);
+  });
+  program.command("ps").description("show running and recent capture jobs").option("--json", "emit structured JSON").action(async (opts) => {
+    await autoRegisterIfNeeded(process.cwd());
+    const result = await runCaptureStatus({
+      cwd: process.cwd(),
+      json: opts.json
+    });
+    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").option("--source <source>", "claude, codex, cursor, or all").action(async (opts) => {
     const result = await runHookInstall({
@@ -2950,4 +3213,4 @@ function registerCommands(program) {
 export {
   registerCommands
 };
-//# sourceMappingURL=register-commands-7SKQLQW4.js.map
+//# sourceMappingURL=register-commands-DPH4ZWEE.js.map