@basou/cli 0.9.0 → 0.11.0

package/dist/program.js

@@ -8,7 +8,8 @@ import { join } from "path";
 import {
   ApprovalSchema,
   ApprovalStatusSchema,
-  appendEvent,
+  acquireLock,
+  appendChainedEventLocked,
   assertBasouRootSafe,
   basouPaths,
   enumerateApprovals,
@@ -320,55 +321,63 @@ async function doRunApprovalResolve(idInput, options, ctx, decision) {
   if (approval.status !== "pending") {
     throw new Error(`Approval status mismatch: pending YAML has status=${approval.status}`);
   }
-  const sessionDir = join(paths.sessions, approval.session_id);
-  for await (const ev of replayEvents(sessionDir, {
-    onWarning: (w) => printReplayWarning(w, approval.session_id)
-  })) {
-    if (isApprovalEvent(ev) && ev.approval_id === approval.id && (ev.type === "approval_approved" || ev.type === "approval_rejected" || ev.type === "approval_expired")) {
-      throw new Error(`Approval already resolved (per events.jsonl): ${idInput}`);
-    }
-  }
   const now = /* @__PURE__ */ new Date();
-  if (isLazyExpired(approval, now)) {
-    throw new Error(`Approval already expired: ${idInput}`);
-  }
-  let sessionStatus = null;
-  try {
-    sessionStatus = (await readSessionYaml(paths, approval.session_id)).session.status;
-  } catch {
-    sessionStatus = null;
-  }
-  if (sessionStatus === "imported") {
-    throw new Error(`Cannot resolve an approval for an imported session: ${idInput}`);
-  }
   const occurredAt = now.toISOString();
   const eventId = prefixedUlid("evt");
-  if (decision === "approve") {
-    const note = options.note ?? null;
-    await appendEvent(sessionDir, {
-      schema_version: "0.1.0",
-      id: eventId,
-      session_id: approval.session_id,
-      occurred_at: occurredAt,
-      source: "local-cli",
-      type: "approval_approved",
-      approval_id: approval.id,
-      resolver: "local-cli",
-      note
-    });
-  } else {
-    const reason = options.reason;
-    await appendEvent(sessionDir, {
-      schema_version: "0.1.0",
-      id: eventId,
-      session_id: approval.session_id,
-      occurred_at: occurredAt,
-      source: "local-cli",
-      type: "approval_rejected",
-      approval_id: approval.id,
-      resolver: "local-cli",
-      reason
-    });
+  const sessionLock = await acquireLock(paths, "session", approval.session_id);
+  try {
+    const sessionDir = join(paths.sessions, approval.session_id);
+    for await (const ev of replayEvents(sessionDir, {
+      onWarning: (w) => printReplayWarning(w, approval.session_id)
+    })) {
+      if (isApprovalEvent(ev) && ev.approval_id === approval.id && (ev.type === "approval_approved" || ev.type === "approval_rejected" || ev.type === "approval_expired")) {
+        throw new Error(`Approval already resolved (per events.jsonl): ${idInput}`);
+      }
+    }
+    if (isLazyExpired(approval, now)) {
+      throw new Error(`Approval already expired: ${idInput}`);
+    }
+    let sessionStatus = null;
+    try {
+      sessionStatus = (await readSessionYaml(paths, approval.session_id)).session.status;
+    } catch {
+      sessionStatus = null;
+    }
+    const attachable = sessionStatus === "initialized" || sessionStatus === "running" || sessionStatus === "waiting_approval";
+    if (sessionStatus !== null && !attachable) {
+      throw new Error(
+        `Cannot resolve an approval for a session that is not active (status=${sessionStatus}): ${idInput}`
+      );
+    }
+    if (decision === "approve") {
+      const note = options.note ?? null;
+      await appendChainedEventLocked(paths, approval.session_id, {
+        schema_version: "0.1.0",
+        id: eventId,
+        session_id: approval.session_id,
+        occurred_at: occurredAt,
+        source: "local-cli",
+        type: "approval_approved",
+        approval_id: approval.id,
+        resolver: "local-cli",
+        note
+      });
+    } else {
+      const reason = options.reason;
+      await appendChainedEventLocked(paths, approval.session_id, {
+        schema_version: "0.1.0",
+        id: eventId,
+        session_id: approval.session_id,
+        occurred_at: occurredAt,
+        source: "local-cli",
+        type: "approval_rejected",
+        approval_id: approval.id,
+        resolver: "local-cli",
+        reason
+      });
+    }
+  } finally {
+    await sessionLock.release();
   }
   const resolvedApproval = decision === "approve" ? {
     ...approval,
@@ -625,7 +634,7 @@ function printNoApprovals(options) {
 
 // src/commands/decision.ts
 import {
-  acquireLock,
+  acquireLock as acquireLock2,
   appendEventToExistingSession,
   assertBasouRootSafe as assertBasouRootSafe2,
   basouPaths as basouPaths2,
@@ -690,7 +699,7 @@ async function doRunDecisionRecord(options, ctx) {
   if (options.session !== void 0) {
     const sessionId = await resolveSessionId(paths, options.session);
     const sesId = sessionId;
-    const sessionLock = await acquireLock(paths, "session", sesId);
+    const sessionLock = await acquireLock2(paths, "session", sesId);
     let result;
     try {
       result = await appendEventToExistingSession({
@@ -954,10 +963,12 @@ import { mkdir } from "fs/promises";
 import { homedir } from "os";
 import { join as join2 } from "path";
 import {
+  acquireLock as acquireLock3,
   assertBasouRootSafe as assertBasouRootSafe4,
   basouPaths as basouPaths4,
   ChildProcessRunner,
-  appendEvent as coreAppendEvent,
+  appendChainedEvent as coreAppendChainedEvent,
+  finalizeSessionYaml,
   getSnapshot,
   overwriteYamlFile,
   parseDuration,
@@ -983,7 +994,6 @@ function registerExecCommand(program) {
 async function runExec(command, args, options, ctx = {}) {
   const runner = ctx.runner ?? new ChildProcessRunner();
   const now = ctx.now ?? (() => /* @__PURE__ */ new Date());
-  const appendEvent2 = ctx.appendEvent ?? coreAppendEvent;
   const cwd = options.cwd ?? process.cwd();
   const timeout_ms = options.timeout !== void 0 ? parseDuration(options.timeout) : void 0;
   const repoRoot = await resolveRepositoryRootForExec(cwd);
@@ -993,6 +1003,9 @@ async function runExec(command, args, options, ctx = {}) {
   const sessionId = prefixedUlid3("ses");
   const sessionDir = join2(paths.sessions, sessionId);
   await mkdir(sessionDir, { recursive: true });
+  const appendEvent = ctx.appendEvent ?? (async (_sessionDir, event) => {
+    await coreAppendChainedEvent(paths, sessionId, event);
+  });
   const startedAt = now().toISOString();
   const sessionYamlPath = join2(sessionDir, "session.yaml");
   const session = buildInitialSession({
@@ -1004,7 +1017,7 @@ async function runExec(command, args, options, ctx = {}) {
     startedAt
   });
   await writeYamlFile(sessionYamlPath, session);
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_started",
     id: prefixedUlid3("evt"),
@@ -1013,10 +1026,10 @@ async function runExec(command, args, options, ctx = {}) {
     source: "terminal-recording"
   });
   if (options.snapshot !== false) {
-    await tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, appendEvent2);
+    await tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, appendEvent);
   }
   const runningAt = now().toISOString();
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_status_changed",
     id: prefixedUlid3("evt"),
@@ -1026,9 +1039,14 @@ async function runExec(command, args, options, ctx = {}) {
     from: "initialized",
     to: "running"
   });
-  await mutateSessionYaml(sessionYamlPath, (s) => {
-    s.session.status = "running";
-  });
+  const runningLock = await acquireLock3(paths, "session", sessionId);
+  try {
+    await mutateSessionYaml(sessionYamlPath, (s) => {
+      s.session.status = "running";
+    });
+  } finally {
+    await runningLock.release();
+  }
   const controller = new AbortController();
   let signalReceived = null;
   let activeChild = null;
@@ -1064,7 +1082,7 @@ async function runExec(command, args, options, ctx = {}) {
         }
       });
     } catch (spawnError) {
-      await finalizeSessionAsFailed(sessionDir, sessionYamlPath, sessionId, appendEvent2, {
+      await finalizeSessionAsFailed(paths, sessionDir, sessionId, appendEvent, {
         command,
         args,
         cwd,
@@ -1080,7 +1098,7 @@ async function runExec(command, args, options, ctx = {}) {
     activeChild = null;
   }
   const endedAt = now().toISOString();
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "command_executed",
     id: prefixedUlid3("evt"),
@@ -1096,10 +1114,10 @@ async function runExec(command, args, options, ctx = {}) {
     duration_ms: result.duration_ms
   });
   if (options.snapshot !== false) {
-    await tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, appendEvent2);
+    await tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, appendEvent);
   }
   const finalStatus = decideFinalStatus(result, signalReceived);
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_status_changed",
     id: prefixedUlid3("evt"),
@@ -1109,7 +1127,7 @@ async function runExec(command, args, options, ctx = {}) {
     from: "running",
     to: finalStatus
   });
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_ended",
     id: prefixedUlid3("evt"),
@@ -1118,7 +1136,7 @@ async function runExec(command, args, options, ctx = {}) {
     source: "terminal-recording",
     ...result.exit_code !== null ? { exit_code: result.exit_code } : {}
   });
-  await mutateSessionYaml(sessionYamlPath, (s) => {
+  await finalizeSessionYaml(paths, sessionId, (s) => {
     s.session.status = finalStatus;
     s.session.ended_at = endedAt;
     s.session.invocation.exit_code = result.exit_code;
@@ -1148,7 +1166,7 @@ function signalToExitCode(sig) {
   const num = SIGNUM_MAP[sig] ?? 1;
   return 128 + num;
 }
-async function tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, appendEvent2) {
+async function tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, appendEvent) {
   let snapshot;
   try {
     snapshot = await getSnapshot(repoRoot);
@@ -1156,7 +1174,7 @@ async function tryAppendGitSnapshot(sessionDir, sessionId, repoRoot, now, append
     console.warn(normalizeGitSnapshotSkipMessage(error));
     return;
   }
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "git_snapshot",
     id: prefixedUlid3("evt"),
@@ -1212,8 +1230,8 @@ async function mutateSessionYaml(filePath, mutator) {
   const validated = SessionSchema.parse(parsed);
   await overwriteYamlFile(filePath, validated);
 }
-async function finalizeSessionAsFailed(sessionDir, sessionYamlPath, sessionId, appendEvent2, ctx) {
-  await appendEvent2(sessionDir, {
+async function finalizeSessionAsFailed(paths, sessionDir, sessionId, appendEvent, ctx) {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "command_executed",
     id: prefixedUlid3("evt"),
@@ -1228,7 +1246,7 @@ async function finalizeSessionAsFailed(sessionDir, sessionYamlPath, sessionId, a
     ...ctx.signalReceived !== null ? { received_signal: ctx.signalReceived } : {},
     duration_ms: 0
   });
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_status_changed",
     id: prefixedUlid3("evt"),
@@ -1238,7 +1256,7 @@ async function finalizeSessionAsFailed(sessionDir, sessionYamlPath, sessionId, a
     from: "running",
     to: "failed"
   });
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_ended",
     id: prefixedUlid3("evt"),
@@ -1246,7 +1264,7 @@ async function finalizeSessionAsFailed(sessionDir, sessionYamlPath, sessionId, a
     occurred_at: ctx.occurredAt,
     source: "terminal-recording"
   });
-  await mutateSessionYaml(sessionYamlPath, (s) => {
+  await finalizeSessionYaml(paths, sessionId, (s) => {
     s.session.status = "failed";
     s.session.ended_at = ctx.occurredAt;
     s.session.invocation.exit_code = null;
@@ -2241,19 +2259,19 @@ function parseInterval(value) {
   return seconds;
 }
 function abortableSleep(ms, signal) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     if (signal.aborted) {
-      resolve3();
+      resolve4();
       return;
     }
     let timer;
     const onAbort = () => {
       clearTimeout(timer);
-      resolve3();
+      resolve4();
     };
     timer = setTimeout(() => {
       signal.removeEventListener("abort", onAbort);
-      resolve3();
+      resolve4();
     }, ms);
     signal.addEventListener("abort", onAbort, { once: true });
   });
@@ -2393,16 +2411,96 @@ async function assertWorkspaceInitialized6(basouRoot) {
   }
 }
 
+// src/commands/report.ts
+import { isAbsolute, resolve as resolve3 } from "path";
+import {
+  assertBasouRootSafe as assertBasouRootSafe8,
+  basouPaths as basouPaths8,
+  findErrorCode as findErrorCode8,
+  renderReport,
+  resolveRepositoryRoot as resolveRepositoryRoot9,
+  writeMarkdownFile as writeMarkdownFile4
+} from "@basou/core";
+function registerReportCommand(program) {
+  const report = program.command("report").description(
+    "Generate a work report \u2014 a shareable export explaining the work in this workspace"
+  );
+  report.command("generate").description("Generate a work report from the current workspace state").option("--out <path>", "Write the markdown report to a file instead of stdout").option("--json", "Emit the structured report data as JSON to stdout").option("--title <text>", "Subject line shown in the report header").option("-v, --verbose", "Show error causes").action(async (opts) => {
+    await runReportGenerate(opts);
+  });
+}
+async function runReportGenerate(options, ctx = {}) {
+  try {
+    await doRunReportGenerate(options, ctx);
+  } catch (error) {
+    renderCliError(error, { verbose: isVerbose(options) });
+    process.exitCode = 1;
+  }
+}
+async function doRunReportGenerate(options, ctx) {
+  const cwd = ctx.cwd ?? process.cwd();
+  const repositoryRoot = await resolveRepositoryRootForReport(cwd);
+  const paths = basouPaths8(repositoryRoot);
+  await assertWorkspaceInitialized7(paths.root);
+  const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
+  const result = await renderReport({
+    paths,
+    nowIso,
+    ...options.title !== void 0 ? { title: options.title } : {},
+    onWarning: (w, sid) => printReplayWarning(w, sid),
+    onSessionSkip: (sid, reason) => printSessionSkip(sid, reason),
+    onTaskSkip: (taskId, reason) => printTaskSkip(taskId, reason)
+  });
+  if (options.out !== void 0) {
+    const outPath = isAbsolute(options.out) ? options.out : resolve3(cwd, options.out);
+    await writeMarkdownFile4(outPath, result.body);
+    const { sessions, decisions, tasks } = result.data;
+    console.error(
+      `Wrote report to ${options.out} (sessions: ${sessions.total}, decisions: ${decisions.count}, tasks: ${tasks.total})`
+    );
+  }
+  if (options.json === true) {
+    console.log(JSON.stringify(result.data, null, 2));
+  } else if (options.out === void 0) {
+    console.log(result.body);
+  }
+}
+async function resolveRepositoryRootForReport(cwd) {
+  try {
+    return await resolveRepositoryRoot9(cwd);
+  } catch (error) {
+    if (error instanceof Error && error.message === "Not a git repository") {
+      throw new Error(
+        "Not a git repository. Run 'git init' first, then re-run 'basou report generate'.",
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+async function assertWorkspaceInitialized7(basouRoot) {
+  try {
+    await assertBasouRootSafe8(basouRoot);
+  } catch (error) {
+    if (findErrorCode8(error, "ENOENT")) {
+      throw new Error("Workspace not initialized. Run 'basou init' first.");
+    }
+    throw error;
+  }
+}
+
 // src/commands/run.ts
 import { mkdir as mkdir2 } from "fs/promises";
 import { homedir as homedir4 } from "os";
 import { join as join5 } from "path";
 import {
-  assertBasouRootSafe as assertBasouRootSafe8,
-  basouPaths as basouPaths8,
+  acquireLock as acquireLock4,
+  assertBasouRootSafe as assertBasouRootSafe9,
+  basouPaths as basouPaths9,
   ChildProcessRunner as ChildProcessRunner2,
   claudeCodeAdapterMetadata,
-  appendEvent as coreAppendEvent2,
+  appendChainedEvent as coreAppendChainedEvent2,
+  finalizeSessionYaml as finalizeSessionYaml2,
   getDiff,
   getSnapshot as getSnapshot2,
   overwriteYamlFile as overwriteYamlFile2,
@@ -2410,7 +2508,7 @@ import {
   readManifest as readManifest4,
   readYamlFile as readYamlFile3,
   resolveClaudeCodeCommand,
-  resolveRepositoryRoot as resolveRepositoryRoot9,
+  resolveRepositoryRoot as resolveRepositoryRoot10,
   SessionSchema as SessionSchema2,
   sanitizeRelatedFiles,
   sanitizeWorkingDirectory as sanitizeWorkingDirectory2,
@@ -2438,18 +2536,20 @@ function registerRunCommand(program, ctx = {}) {
 async function runClaudeCode(args, options, ctx = {}) {
   const runner = ctx.runner ?? new ChildProcessRunner2();
   const now = ctx.now ?? (() => /* @__PURE__ */ new Date());
-  const appendEvent2 = ctx.appendEvent ?? coreAppendEvent2;
   const resolveCommand = ctx.resolveCommand ?? resolveClaudeCodeCommand;
   const getDiffFn = ctx.getDiff ?? getDiff;
   const { command } = await resolveCommand();
   const cwd = options.cwd ?? process.cwd();
   const repoRoot = await resolveRepositoryRootForRun(cwd);
-  const paths = basouPaths8(repoRoot);
-  await assertBasouRootSafe8(paths.root);
+  const paths = basouPaths9(repoRoot);
+  await assertBasouRootSafe9(paths.root);
   const manifest = await readManifest4(paths);
   const sessionId = prefixedUlid4("ses");
   const sessionDir = join5(paths.sessions, sessionId);
   await mkdir2(sessionDir, { recursive: true });
+  const appendEvent = ctx.appendEvent ?? (async (_sessionDir, event) => {
+    await coreAppendChainedEvent2(paths, sessionId, event);
+  });
   const startedAt = now().toISOString();
   const sessionYamlPath = join5(sessionDir, "session.yaml");
   const session = buildInitialSession2({
@@ -2461,7 +2561,7 @@ async function runClaudeCode(args, options, ctx = {}) {
     startedAt
   });
   await writeYamlFile2(sessionYamlPath, session);
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_started",
     id: prefixedUlid4("evt"),
@@ -2471,10 +2571,10 @@ async function runClaudeCode(args, options, ctx = {}) {
   });
   let preSnapshot = null;
   if (options.snapshot !== false) {
-    preSnapshot = await tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appendEvent2);
+    preSnapshot = await tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appendEvent);
   }
   const runningAt = now().toISOString();
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_status_changed",
     id: prefixedUlid4("evt"),
@@ -2484,9 +2584,14 @@ async function runClaudeCode(args, options, ctx = {}) {
     from: "initialized",
     to: "running"
   });
-  await mutateSessionYaml2(sessionYamlPath, (s) => {
-    s.session.status = "running";
-  });
+  const runningLock = await acquireLock4(paths, "session", sessionId);
+  try {
+    await mutateSessionYaml2(sessionYamlPath, (s) => {
+      s.session.status = "running";
+    });
+  } finally {
+    await runningLock.release();
+  }
   const controller = new AbortController();
   let signalReceived = null;
   let activeChild = null;
@@ -2521,7 +2626,7 @@ async function runClaudeCode(args, options, ctx = {}) {
         }
       });
     } catch (spawnError) {
-      await finalizeSessionAsFailed2(sessionDir, sessionYamlPath, sessionId, appendEvent2, {
+      await finalizeSessionAsFailed2(paths, sessionDir, sessionId, appendEvent, {
         command,
         args,
         cwd: repoRoot,
@@ -2537,7 +2642,7 @@ async function runClaudeCode(args, options, ctx = {}) {
     activeChild = null;
   }
   const endedAt = now().toISOString();
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "command_executed",
     id: prefixedUlid4("evt"),
@@ -2554,7 +2659,7 @@ async function runClaudeCode(args, options, ctx = {}) {
   });
   let postSnapshot = null;
   if (options.snapshot !== false) {
-    postSnapshot = await tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appendEvent2);
+    postSnapshot = await tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appendEvent);
   }
   let diff = null;
   if (preSnapshot !== null && postSnapshot !== null) {
@@ -2565,7 +2670,7 @@ async function runClaudeCode(args, options, ctx = {}) {
       preSnapshot.head,
       postSnapshot.head,
       now().toISOString(),
-      appendEvent2,
+      appendEvent,
       getDiffFn
     );
   }
@@ -2575,7 +2680,7 @@ async function runClaudeCode(args, options, ctx = {}) {
     homedir: homedir4()
   }).sanitized;
   const finalStatus = decideFinalStatus2(result, signalReceived);
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_status_changed",
     id: prefixedUlid4("evt"),
@@ -2585,7 +2690,7 @@ async function runClaudeCode(args, options, ctx = {}) {
     from: "running",
     to: finalStatus
   });
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_ended",
     id: prefixedUlid4("evt"),
@@ -2594,7 +2699,7 @@ async function runClaudeCode(args, options, ctx = {}) {
     source: claudeCodeAdapterMetadata.kind,
     ...result.exit_code !== null ? { exit_code: result.exit_code } : {}
   });
-  await mutateSessionYaml2(sessionYamlPath, (s) => {
+  await finalizeSessionYaml2(paths, sessionId, (s) => {
     s.session.status = finalStatus;
     s.session.ended_at = endedAt;
     s.session.invocation.exit_code = result.exit_code;
@@ -2623,7 +2728,7 @@ function signalToExitCode2(sig) {
   const num = SIGNUM_MAP2[sig] ?? 1;
   return 128 + num;
 }
-async function tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appendEvent2) {
+async function tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appendEvent) {
   let snapshot;
   try {
     snapshot = await getSnapshot2(repoRoot);
@@ -2631,7 +2736,7 @@ async function tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appen
     console.warn(normalizeGitSnapshotSkipMessage2(error));
     return null;
   }
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "git_snapshot",
     id: prefixedUlid4("evt"),
@@ -2642,7 +2747,7 @@ async function tryAppendGitSnapshot2(sessionDir, sessionId, repoRoot, now, appen
   });
   return snapshot;
 }
-async function tryAppendFileChangedEvents(sessionDir, sessionId, repoRoot, baseRef, headRef, occurredAt, appendEvent2, getDiffFn) {
+async function tryAppendFileChangedEvents(sessionDir, sessionId, repoRoot, baseRef, headRef, occurredAt, appendEvent, getDiffFn) {
   let diff;
   try {
     diff = await getDiffFn(repoRoot, baseRef, headRef);
@@ -2651,7 +2756,7 @@ async function tryAppendFileChangedEvents(sessionDir, sessionId, repoRoot, baseR
     return null;
   }
   for (const change of diff.changed_files) {
-    await appendEvent2(sessionDir, {
+    await appendEvent(sessionDir, {
       schema_version: "0.1.0",
       type: "file_changed",
       id: prefixedUlid4("evt"),
@@ -2734,8 +2839,8 @@ async function mutateSessionYaml2(filePath, mutator) {
   const validated = SessionSchema2.parse(parsed);
   await overwriteYamlFile2(filePath, validated);
 }
-async function finalizeSessionAsFailed2(sessionDir, sessionYamlPath, sessionId, appendEvent2, ctx) {
-  await appendEvent2(sessionDir, {
+async function finalizeSessionAsFailed2(paths, sessionDir, sessionId, appendEvent, ctx) {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "command_executed",
     id: prefixedUlid4("evt"),
@@ -2750,7 +2855,7 @@ async function finalizeSessionAsFailed2(sessionDir, sessionYamlPath, sessionId,
     ...ctx.signalReceived !== null ? { received_signal: ctx.signalReceived } : {},
     duration_ms: 0
   });
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_status_changed",
     id: prefixedUlid4("evt"),
@@ -2760,7 +2865,7 @@ async function finalizeSessionAsFailed2(sessionDir, sessionYamlPath, sessionId,
     from: "running",
     to: "failed"
   });
-  await appendEvent2(sessionDir, {
+  await appendEvent(sessionDir, {
     schema_version: "0.1.0",
     type: "session_ended",
     id: prefixedUlid4("evt"),
@@ -2768,7 +2873,7 @@ async function finalizeSessionAsFailed2(sessionDir, sessionYamlPath, sessionId,
     occurred_at: ctx.occurredAt,
     source: claudeCodeAdapterMetadata.kind
   });
-  await mutateSessionYaml2(sessionYamlPath, (s) => {
+  await finalizeSessionYaml2(paths, sessionId, (s) => {
     s.session.status = "failed";
     s.session.ended_at = ctx.occurredAt;
     s.session.invocation.exit_code = null;
@@ -2776,7 +2881,7 @@ async function finalizeSessionAsFailed2(sessionDir, sessionYamlPath, sessionId,
 }
 async function resolveRepositoryRootForRun(cwd) {
   try {
-    return await resolveRepositoryRoot9(cwd);
+    return await resolveRepositoryRoot10(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou run'.", {
@@ -2789,21 +2894,21 @@ async function resolveRepositoryRootForRun(cwd) {
 
 // src/commands/session.ts
 import { readFile as readFile2 } from "fs/promises";
-import { basename as basename3, isAbsolute, join as join6, relative as relative2 } from "path";
+import { basename as basename3, isAbsolute as isAbsolute2, join as join6, relative as relative2 } from "path";
 import {
-  acquireLock as acquireLock2,
+  acquireLock as acquireLock5,
   appendEventToExistingSession as appendEventToExistingSession2,
-  assertBasouRootSafe as assertBasouRootSafe9,
-  basouPaths as basouPaths9,
+  assertBasouRootSafe as assertBasouRootSafe10,
+  basouPaths as basouPaths10,
   enumerateSessionDirs as enumerateSessionDirs2,
-  findErrorCode as findErrorCode8,
+  findErrorCode as findErrorCode9,
   importSessionFromJson as importSessionFromJson2,
   loadSessionEntries,
   readAllEvents,
   readManifest as readManifest5,
   readYamlFile as readYamlFile4,
   rechainSessionInPlace,
-  resolveRepositoryRoot as resolveRepositoryRoot10,
+  resolveRepositoryRoot as resolveRepositoryRoot11,
   resolveSessionId as resolveSessionId2,
   resolveTaskId,
   SessionImportPayloadSchema as SessionImportPayloadSchema2,
@@ -2814,15 +2919,7 @@ import {
 import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
 
 // src/lib/format-duration.ts
-function formatDurationMs(ms) {
-  const totalSeconds = Math.round(ms / 1e3);
-  const hours = Math.floor(totalSeconds / 3600);
-  const minutes = Math.floor(totalSeconds % 3600 / 60);
-  const seconds = totalSeconds % 60;
-  if (hours > 0) return `${hours}h ${String(minutes).padStart(2, "0")}m`;
-  if (minutes > 0) return `${minutes}m ${String(seconds).padStart(2, "0")}s`;
-  return `${seconds}s`;
-}
+import { formatDurationMs } from "@basou/core";
 
 // src/commands/session.ts
 var SES_PREFIX3 = "ses_";
@@ -2868,8 +2965,8 @@ async function runSessionList(options, ctx = {}) {
 async function doRunSessionList(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "list");
-  const paths = basouPaths9(repositoryRoot);
-  await assertWorkspaceInitialized7(paths.root);
+  const paths = basouPaths10(repositoryRoot);
+  await assertWorkspaceInitialized8(paths.root);
   const now = /* @__PURE__ */ new Date();
   const records = (await loadSessionEntries(paths, {
     now,
@@ -2920,8 +3017,8 @@ async function runSessionShow(idInput, options, ctx = {}) {
 async function doRunSessionShow(idInput, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "show");
-  const paths = basouPaths9(repositoryRoot);
-  await assertWorkspaceInitialized7(paths.root);
+  const paths = basouPaths10(repositoryRoot);
+  await assertWorkspaceInitialized8(paths.root);
   const sessionId = await resolveSessionId2(paths, idInput);
   const sessionDir = join6(paths.sessions, sessionId);
   const sessionYamlPath = join6(sessionDir, "session.yaml");
@@ -2930,7 +3027,7 @@ async function doRunSessionShow(idInput, options, ctx) {
     const raw = await readYamlFile4(sessionYamlPath);
     session = SessionSchema3.parse(raw);
   } catch (error) {
-    if (findErrorCode8(error, "ENOENT")) {
+    if (findErrorCode9(error, "ENOENT")) {
       throw new Error(`Session not found: ${idInput}`);
     }
     throw new Error("Failed to read session", { cause: error });
@@ -3045,7 +3142,7 @@ function formatSessionWork(session, events, now) {
 }
 function formatWorkingDir(workingDir, repositoryRoot, options) {
   if (options.fullPath === true) return workingDir;
-  if (!isAbsolute(workingDir)) {
+  if (!isAbsolute2(workingDir)) {
     if (workingDir === ".") return "<repository_root>";
     return workingDir;
   }
@@ -3165,7 +3262,7 @@ function maxLen2(values, floor) {
 }
 async function resolveRepositoryRootForSession(cwd, subcmd) {
   try {
-    return await resolveRepositoryRoot10(cwd);
+    return await resolveRepositoryRoot11(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error(
@@ -3176,11 +3273,11 @@ async function resolveRepositoryRootForSession(cwd, subcmd) {
     throw error;
   }
 }
-async function assertWorkspaceInitialized7(basouRoot) {
+async function assertWorkspaceInitialized8(basouRoot) {
   try {
-    await assertBasouRootSafe9(basouRoot);
+    await assertBasouRootSafe10(basouRoot);
   } catch (error) {
-    if (findErrorCode8(error, "ENOENT")) {
+    if (findErrorCode9(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw error;
@@ -3218,8 +3315,8 @@ async function runSessionImport(options, ctx = {}) {
 async function doRunSessionImport(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "import");
-  const paths = basouPaths9(repositoryRoot);
-  await assertWorkspaceInitialized7(paths.root);
+  const paths = basouPaths10(repositoryRoot);
+  await assertWorkspaceInitialized8(paths.root);
   const manifest = await readManifest5(paths);
   const rawBody = await readInputFile(options.from);
   const json = parseJsonStrict(rawBody);
@@ -3249,10 +3346,10 @@ async function readInputFile(path) {
   try {
     return await readFile2(path, "utf8");
   } catch (error) {
-    if (findErrorCode8(error, "ENOENT")) {
+    if (findErrorCode9(error, "ENOENT")) {
       throw new Error("Import source not found", { cause: error });
     }
-    if (findErrorCode8(error, "EISDIR")) {
+    if (findErrorCode9(error, "EISDIR")) {
       throw new Error("Import source is not a file", { cause: error });
     }
     throw new Error("Failed to read import source", { cause: error });
@@ -3332,8 +3429,8 @@ async function doRunSessionNote(sessionIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "note");
-  const paths = basouPaths9(repositoryRoot);
-  await assertWorkspaceInitialized7(paths.root);
+  const paths = basouPaths10(repositoryRoot);
+  await assertWorkspaceInitialized8(paths.root);
   const sessionId = await resolveSessionId2(paths, sessionIdInput);
   const body = hasBody ? options.body : await readNoteFile(options.fromFile);
   if (body.length === 0) {
@@ -3341,7 +3438,7 @@ async function doRunSessionNote(sessionIdInput, options, ctx) {
   }
   const occurredAt = (/* @__PURE__ */ new Date()).toISOString();
   const sesId = sessionId;
-  const sessionLock = await acquireLock2(paths, "session", sesId);
+  const sessionLock = await acquireLock5(paths, "session", sesId);
   let result;
   try {
     result = await appendEventToExistingSession2({
@@ -3366,10 +3463,10 @@ async function readNoteFile(path) {
   try {
     return await readFile2(path, "utf8");
   } catch (error) {
-    if (findErrorCode8(error, "ENOENT")) {
+    if (findErrorCode9(error, "ENOENT")) {
       throw new Error("Note source not found", { cause: error });
     }
-    if (findErrorCode8(error, "EISDIR")) {
+    if (findErrorCode9(error, "EISDIR")) {
       throw new Error("Note source is not a file", { cause: error });
     }
     throw new Error("Failed to read note source", { cause: error });
@@ -3414,8 +3511,8 @@ async function doRunSessionRechain(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "rechain");
-  const paths = basouPaths9(repositoryRoot);
-  await assertWorkspaceInitialized7(paths.root);
+  const paths = basouPaths10(repositoryRoot);
+  await assertWorkspaceInitialized8(paths.root);
   const sessionIds = options.session !== void 0 ? [await resolveSessionId2(paths, options.session)] : await enumerateSessionDirs2(paths);
   const dryRun = options.dryRun === true;
   const rows = [];
@@ -3468,11 +3565,11 @@ function renderRechainRow(row, dryRun) {
 
 // src/commands/stats.ts
 import {
-  assertBasouRootSafe as assertBasouRootSafe10,
-  basouPaths as basouPaths10,
+  assertBasouRootSafe as assertBasouRootSafe11,
+  basouPaths as basouPaths11,
   computeWorkStats,
-  findErrorCode as findErrorCode9,
-  resolveRepositoryRoot as resolveRepositoryRoot11
+  findErrorCode as findErrorCode10,
+  resolveRepositoryRoot as resolveRepositoryRoot12
 } from "@basou/core";
 function registerStatsCommand(program) {
   program.command("stats").description("Report how much the AI worked (output volume + time proxies) across sessions").option("--by-source", "Break the totals down by session source kind").option("--by-day", "Break billable time and volume down by calendar day").option("--json", "Output the full stats as JSON").option("-v, --verbose", "Show error causes").action(async (options) => {
@@ -3490,8 +3587,8 @@ async function runStats(options, ctx = {}) {
 async function doRunStats(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForStats(cwd);
-  const paths = basouPaths10(repositoryRoot);
-  await assertWorkspaceInitialized8(paths.root);
+  const paths = basouPaths11(repositoryRoot);
+  await assertWorkspaceInitialized9(paths.root);
   const now = ctx.nowProvider?.() ?? /* @__PURE__ */ new Date();
   const result = await computeWorkStats({
     paths,
@@ -3575,7 +3672,7 @@ function formatInt(n) {
 }
 async function resolveRepositoryRootForStats(cwd) {
   try {
-    return await resolveRepositoryRoot11(cwd);
+    return await resolveRepositoryRoot12(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou stats'.", {
@@ -3585,11 +3682,11 @@ async function resolveRepositoryRootForStats(cwd) {
     throw error;
   }
 }
-async function assertWorkspaceInitialized8(basouRoot) {
+async function assertWorkspaceInitialized9(basouRoot) {
   try {
-    await assertBasouRootSafe10(basouRoot);
+    await assertBasouRootSafe11(basouRoot);
   } catch (error) {
-    if (findErrorCode9(error, "ENOENT")) {
+    if (findErrorCode10(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw error;
@@ -3598,12 +3695,12 @@ async function assertWorkspaceInitialized8(basouRoot) {
 
 // src/commands/status.ts
 import {
-  assertBasouRootSafe as assertBasouRootSafe11,
-  basouPaths as basouPaths11,
+  assertBasouRootSafe as assertBasouRootSafe12,
+  basouPaths as basouPaths12,
   buildStatusSnapshot,
-  findErrorCode as findErrorCode10,
+  findErrorCode as findErrorCode11,
   readManifest as readManifest6,
-  resolveRepositoryRoot as resolveRepositoryRoot12,
+  resolveRepositoryRoot as resolveRepositoryRoot13,
   writeStatus
 } from "@basou/core";
 function registerStatusCommand(program) {
@@ -3622,11 +3719,11 @@ async function runStatus(options, ctx = {}) {
 async function doRunStatus(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForStatus(cwd);
-  const paths = basouPaths11(repositoryRoot);
+  const paths = basouPaths12(repositoryRoot);
   try {
-    await assertBasouRootSafe11(paths.root);
+    await assertBasouRootSafe12(paths.root);
   } catch (error) {
-    if (findErrorCode10(error, "ENOENT")) {
+    if (findErrorCode11(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw error;
@@ -3635,7 +3732,7 @@ async function doRunStatus(options, ctx) {
   try {
     manifest = await readManifest6(paths);
   } catch (error) {
-    if (findErrorCode10(error, "ENOENT")) {
+    if (findErrorCode11(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw new Error("Failed to read workspace manifest", { cause: error });
@@ -3659,7 +3756,7 @@ function renderTextStatus(s) {
 }
 async function resolveRepositoryRootForStatus(cwd) {
   try {
-    return await resolveRepositoryRoot12(cwd);
+    return await resolveRepositoryRoot13(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou status'.", {
@@ -3675,13 +3772,13 @@ import { readFile as readFile3 } from "fs/promises";
 import { join as join7 } from "path";
 import {
   archiveTask,
-  assertBasouRootSafe as assertBasouRootSafe12,
-  basouPaths as basouPaths12,
+  assertBasouRootSafe as assertBasouRootSafe13,
+  basouPaths as basouPaths13,
   createTaskWithEvent,
   deleteTask,
   editTask,
   enumerateArchivedTaskIds,
-  findErrorCode as findErrorCode11,
+  findErrorCode as findErrorCode12,
   loadSessionEntries as loadSessionEntries2,
   loadTaskEntries,
   prefixedUlid as prefixedUlid5,
@@ -3692,7 +3789,7 @@ import {
   reconcileTask,
   refreshTaskLinkedSessions,
   replayEvents as replayEvents2,
-  resolveRepositoryRoot as resolveRepositoryRoot13,
+  resolveRepositoryRoot as resolveRepositoryRoot14,
   resolveSessionId as resolveSessionId3,
   resolveTaskId as resolveTaskId2,
   TaskStatusSchema,
@@ -3778,8 +3875,8 @@ async function doRunTaskNew(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "new");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const description = options.description !== void 0 ? options.description : options.fromFile !== void 0 ? await readDescriptionFile(options.fromFile) : "";
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
@@ -3887,8 +3984,8 @@ async function runTaskList(options, ctx = {}) {
 async function doRunTaskList(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "list");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const entries = await loadTaskEntries(paths, {
     onSkip: (id, reason) => printTaskSkip(id, reason)
   });
@@ -3991,8 +4088,8 @@ async function runTaskShow(idInput, options, ctx = {}) {
 async function doRunTaskShow(idInput, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "show");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const taskId = await resolveTaskId2(paths, idInput, { includeArchived: true });
   const { doc, archived } = await readTaskFileWithArchiveFallback(paths, taskId);
   const sessions = await loadSessionEntries2(paths, { now: /* @__PURE__ */ new Date() });
@@ -4135,8 +4232,8 @@ async function doRunTaskStatus(taskIdInput, newStatusInput, options, ctx) {
   const newStatus = parseTaskStatusPositional(newStatusInput);
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "status");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
@@ -4212,8 +4309,8 @@ async function runTaskReconcile(options, ctx = {}) {
 async function doRunTaskReconcile(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "reconcile");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const manifest = await readManifest7(paths);
   const nowProvider = ctx.nowProvider ?? (() => /* @__PURE__ */ new Date());
   const write = options.write === true;
@@ -4392,8 +4489,8 @@ async function doRunTaskRefreshLinkage(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "refresh-linkage");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const manifest = await readManifest7(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const nowProvider = ctx.nowProvider ?? (() => /* @__PURE__ */ new Date());
@@ -4472,8 +4569,8 @@ async function doRunTaskEdit(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "edit");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const manifest = await readManifest7(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
@@ -4528,8 +4625,8 @@ async function doRunTaskDelete(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "delete");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const manifest = await readManifest7(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   if (options.yes !== true) {
@@ -4573,8 +4670,8 @@ async function doRunTaskArchive(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "archive");
-  const paths = basouPaths12(repositoryRoot);
-  await assertWorkspaceInitialized9(paths.root);
+  const paths = basouPaths13(repositoryRoot);
+  await assertWorkspaceInitialized10(paths.root);
   const manifest = await readManifest7(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   if (options.yes !== true) {
@@ -4689,10 +4786,10 @@ async function readDescriptionFile(path) {
   try {
     return await readFile3(path, "utf8");
   } catch (error) {
-    if (findErrorCode11(error, "ENOENT")) {
+    if (findErrorCode12(error, "ENOENT")) {
       throw new Error("Description source not found", { cause: error });
     }
-    if (findErrorCode11(error, "EISDIR")) {
+    if (findErrorCode12(error, "EISDIR")) {
       throw new Error("Description source is not a file", { cause: error });
     }
     throw new Error("Failed to read description source", { cause: error });
@@ -4700,7 +4797,7 @@ async function readDescriptionFile(path) {
 }
 async function resolveRepositoryRootForTask(cwd, subcmd) {
   try {
-    return await resolveRepositoryRoot13(cwd);
+    return await resolveRepositoryRoot14(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error(
@@ -4711,11 +4808,11 @@ async function resolveRepositoryRootForTask(cwd, subcmd) {
     throw error;
   }
 }
-async function assertWorkspaceInitialized9(basouRoot) {
+async function assertWorkspaceInitialized10(basouRoot) {
   try {
-    await assertBasouRootSafe12(basouRoot);
+    await assertBasouRootSafe13(basouRoot);
   } catch (error) {
-    if (findErrorCode11(error, "ENOENT")) {
+    if (findErrorCode12(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw error;
@@ -4803,18 +4900,16 @@ function maxLen3(values, floor) {
 
 // src/commands/verify.ts
 import {
-  assertBasouRootSafe as assertBasouRootSafe13,
-  basouPaths as basouPaths13,
+  assertBasouRootSafe as assertBasouRootSafe14,
+  basouPaths as basouPaths14,
   enumerateSessionDirs as enumerateSessionDirs3,
-  findErrorCode as findErrorCode12,
-  resolveRepositoryRoot as resolveRepositoryRoot14,
+  findErrorCode as findErrorCode13,
+  resolveRepositoryRoot as resolveRepositoryRoot15,
   resolveSessionId as resolveSessionId4,
   verifyEventsChain
 } from "@basou/core";
 function registerVerifyCommand(program) {
-  program.command("verify").description(
-    "Verify the tamper-evidence hash chain of imported sessions' event logs (read-only)"
-  ).option("--session <id>", "Verify a single session (unique id prefix accepted)").option("--all", "Verify every session (the default when --session is omitted)").option("--json", "Output the verdicts as JSON").option("-v, --verbose", "Show error causes").action(async (opts) => {
+  program.command("verify").description("Verify the tamper-evidence hash chain of sessions' event logs (read-only)").option("--session <id>", "Verify a single session (unique id prefix accepted)").option("--all", "Verify every session (the default when --session is omitted)").option("--json", "Output the verdicts as JSON").option("-v, --verbose", "Show error causes").action(async (opts) => {
     await runVerify(opts);
   });
 }
@@ -4832,8 +4927,8 @@ async function doRunVerify(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForVerify(cwd);
-  const paths = basouPaths13(repositoryRoot);
-  await assertWorkspaceInitialized10(paths.root);
+  const paths = basouPaths14(repositoryRoot);
+  await assertWorkspaceInitialized11(paths.root);
   const sessionIds = options.session !== void 0 ? [await resolveSessionId4(paths, options.session)] : await enumerateSessionDirs3(paths);
   const rows = [];
   for (const sessionId of sessionIds) {
@@ -4855,7 +4950,7 @@ async function doRunVerify(options, ctx) {
     }
     const tally = (status) => rows.filter((r) => r.status === status).length;
     console.log(
-      `Sessions: ${rows.length} total \u2014 ${tally("verified")} verified, ${tally("unchained")} unchained, ${tally("empty")} empty, ${tally("incomplete")} incomplete, ${tamperedCount} tampered`
+      `Sessions: ${rows.length} total \u2014 ${tally("verified")} verified, ${tally("unchained")} unchained, ${tally("empty")} empty, ${tally("incomplete")} incomplete, ${tally("in_progress")} in_progress, ${tamperedCount} tampered`
     );
   }
   if (tamperedCount > 0) {
@@ -4870,15 +4965,17 @@ function renderVerdict(row) {
       return row.line !== void 0 ? `TAMPERED (${row.reason} at line ${row.line})` : `TAMPERED (${row.reason})`;
     case "incomplete":
       return "incomplete (session.yaml missing; re-import to repair)";
+    case "in_progress":
+      return `in_progress (${row.event_count} events; live session, anchor written at finalize)`;
     case "unchained":
-      return "unchained (not an imported session, or imported before chaining)";
+      return "unchained (session created before event-log chaining)";
     case "empty":
       return "empty";
   }
 }
 async function resolveRepositoryRootForVerify(cwd) {
   try {
-    return await resolveRepositoryRoot14(cwd);
+    return await resolveRepositoryRoot15(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou verify'.", {
@@ -4888,11 +4985,11 @@ async function resolveRepositoryRootForVerify(cwd) {
     throw error;
   }
 }
-async function assertWorkspaceInitialized10(basouRoot) {
+async function assertWorkspaceInitialized11(basouRoot) {
   try {
-    await assertBasouRootSafe13(basouRoot);
+    await assertBasouRootSafe14(basouRoot);
   } catch (error) {
-    if (findErrorCode12(error, "ENOENT")) {
+    if (findErrorCode13(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw error;
@@ -4901,7 +4998,7 @@ async function assertWorkspaceInitialized10(basouRoot) {
 
 // src/commands/view.ts
 import { spawn } from "child_process";
-import { assertBasouRootSafe as assertBasouRootSafe14, basouPaths as basouPaths14, findErrorCode as findErrorCode14, resolveRepositoryRoot as resolveRepositoryRoot15 } from "@basou/core";
+import { assertBasouRootSafe as assertBasouRootSafe15, basouPaths as basouPaths15, findErrorCode as findErrorCode15, resolveRepositoryRoot as resolveRepositoryRoot16 } from "@basou/core";
 import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
 
 // src/lib/view-server.ts
@@ -4910,7 +5007,7 @@ import { join as join8 } from "path";
 import {
   computeWorkStats as computeWorkStats2,
   enumerateApprovals as enumerateApprovals2,
-  findErrorCode as findErrorCode13,
+  findErrorCode as findErrorCode14,
   isLazyExpired as isLazyExpired2,
   loadApproval as loadApproval2,
   loadSessionEntries as loadSessionEntries3,
@@ -5383,7 +5480,7 @@ function startViewServer(opts) {
   };
   let boundPort = port;
   const getPort = () => boundPort;
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const server = createServer((req, res) => {
       handleRequest(req, res, deps, getPort, runExclusive).catch((error) => {
         sendError(res, error instanceof HttpError ? error.status : 500, pathlessMessage(error));
@@ -5394,7 +5491,7 @@ function startViewServer(opts) {
       const address = server.address();
       boundPort = isAddressInfo(address) ? address.port : port;
       server.off("error", reject);
-      resolve3({
+      resolve4({
         url: `http://${host}:${boundPort}`,
         port: boundPort,
         close: () => closeServer(server)
@@ -5406,8 +5503,8 @@ function isAddressInfo(value) {
   return value !== null && typeof value === "object";
 }
 function closeServer(server) {
-  return new Promise((resolve3) => {
-    server.close(() => resolve3());
+  return new Promise((resolve4) => {
+    server.close(() => resolve4());
     server.closeAllConnections();
   });
 }
@@ -5512,7 +5609,7 @@ async function overview(deps) {
   try {
     manifest = await readManifest8(deps.paths);
   } catch (error) {
-    if (findErrorCode13(error, "ENOENT")) {
+    if (findErrorCode14(error, "ENOENT")) {
       return { initialized: false, repoRoot: deps.repoRoot };
     }
     throw error;
@@ -5727,8 +5824,8 @@ async function runView(options, ctx = {}) {
 async function doRunView(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForView(cwd);
-  const paths = basouPaths14(repositoryRoot);
-  await assertWorkspaceInitialized11(paths.root);
+  const paths = basouPaths15(repositoryRoot);
+  await assertWorkspaceInitialized12(paths.root);
   const deps = {
     paths,
     repoRoot: repositoryRoot,
@@ -5759,7 +5856,7 @@ async function startListening(port, deps) {
   try {
     return await startViewServer({ port, deps });
   } catch (error) {
-    if (findErrorCode14(error, "EADDRINUSE")) {
+    if (findErrorCode15(error, "EADDRINUSE")) {
       throw new Error(`Port ${port} is already in use. Pass --port <n> to choose another.`, {
         cause: error
       });
@@ -5782,7 +5879,7 @@ function openInBrowser(url, override) {
   }
 }
 function waitForShutdown(signal) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const cleanup = () => {
       process.off("SIGINT", onSignal);
       process.off("SIGTERM", onSignal);
@@ -5790,18 +5887,18 @@ function waitForShutdown(signal) {
     };
     const onSignal = () => {
       cleanup();
-      resolve3();
+      resolve4();
     };
     const onAbort = () => {
       cleanup();
-      resolve3();
+      resolve4();
     };
     process.on("SIGINT", onSignal);
     process.on("SIGTERM", onSignal);
     if (signal !== void 0) {
       if (signal.aborted) {
         cleanup();
-        resolve3();
+        resolve4();
         return;
       }
       signal.addEventListener("abort", onAbort);
@@ -5810,7 +5907,7 @@ function waitForShutdown(signal) {
 }
 async function resolveRepositoryRootForView(cwd) {
   try {
-    return await resolveRepositoryRoot15(cwd);
+    return await resolveRepositoryRoot16(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou view'.", {
@@ -5820,11 +5917,11 @@ async function resolveRepositoryRootForView(cwd) {
     throw error;
   }
 }
-async function assertWorkspaceInitialized11(basouRoot) {
+async function assertWorkspaceInitialized12(basouRoot) {
   try {
-    await assertBasouRootSafe14(basouRoot);
+    await assertBasouRootSafe15(basouRoot);
   } catch (error) {
-    if (findErrorCode14(error, "ENOENT")) {
+    if (findErrorCode15(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
     }
     throw error;
@@ -5853,6 +5950,7 @@ function buildProgram() {
   registerTaskCommand(program);
   registerHandoffCommand(program);
   registerDecisionsCommand(program);
+  registerReportCommand(program);
   return program;
 }
 export {