@basou/core 0.10.0 → 0.11.0

package/dist/index.js

@@ -4025,6 +4025,17 @@ function parseDuration(input) {
   return ms;
 }
 
+// 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`;
+}
+
 // src/lib/id-resolver.ts
 async function resolveSessionId(paths, input) {
   return resolveIdInternal(paths, input, "session");
@@ -4080,319 +4091,314 @@ async function resolveIdInternal(paths, input, kind, options = {}) {
   return matches[0];
 }
 
-// src/runtime/child-process-runner.ts
-import { spawn as spawn2 } from "child_process";
-var DEFAULT_KILL_GRACE_MS = 5e3;
-var ChildProcessRunner = class {
-  async run(command, args, options) {
-    validateOptions(options);
-    if (options.signal?.aborted) {
-      throw new Error("Process aborted before spawn", {
-        cause: options.signal.reason
-      });
-    }
-    const snapshotCommand = command;
-    const snapshotArgs = [...args];
-    const snapshotCwd = options.cwd;
-    const captureMode = options.capture ?? "buffer";
-    const started_at = /* @__PURE__ */ new Date();
-    let child;
+// src/report/report-renderer.ts
+import { join as join14 } from "path";
+
+// src/stats/work-stats.ts
+import { join as join13 } from "path";
+function resolveTimeZone(timeZone) {
+  if (timeZone !== void 0 && timeZone.length > 0) return timeZone;
+  return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+var STATUS_ORDER = [
+  "completed",
+  "failed",
+  "running",
+  "interrupted",
+  "waiting_approval",
+  "initialized",
+  "imported",
+  "archived"
+];
+async function computeWorkStats(input) {
+  const { now } = input;
+  const timeZone = resolveTimeZone(input.timeZone);
+  const unreadableEmitted = /* @__PURE__ */ new Set();
+  const wrappedSkip = (sid, reason) => {
+    if (reason === "events_jsonl_unreadable") unreadableEmitted.add(sid);
+    input.onSessionSkip?.(sid, reason);
+  };
+  const loadOpts = { now, onSkip: wrappedSkip };
+  if (input.onWarning !== void 0) loadOpts.onWarning = input.onWarning;
+  const entries = await loadSessionEntries(input.paths, loadOpts);
+  const sessions = [];
+  for (const entry of entries) {
+    const events = [];
+    let eventsUnreadable = false;
     try {
-      child = spawn2(snapshotCommand, [...snapshotArgs], {
-        cwd: snapshotCwd,
-        env: options.env ?? process.env,
-        stdio: captureMode === "none" ? ["inherit", "inherit", "inherit"] : ["pipe", "pipe", "pipe"],
-        shell: false,
-        detached: false
-      });
-    } catch (error) {
-      throw classifySpawnError(error);
-    }
-    if (options.onSpawn) {
-      try {
-        options.onSpawn(child);
-      } catch {
+      for await (const ev of replayEvents(join13(input.paths.sessions, entry.sessionId), {
+        onWarning: (w) => input.onWarning?.(w, entry.sessionId)
+      })) {
+        events.push(ev);
       }
-    }
-    let timeoutTimer = null;
-    let killTimer = null;
-    let killed = false;
-    let settled = false;
-    const triggerKill = () => {
-      if (killed || child.exitCode !== null) return;
-      killed = true;
-      child.kill("SIGTERM");
-      killTimer = setTimeout(() => {
-        if (child.exitCode === null) {
-          child.kill("SIGKILL");
-        }
-      }, DEFAULT_KILL_GRACE_MS);
-    };
-    const onAbort = () => {
-      triggerKill();
-    };
-    options.signal?.addEventListener("abort", onAbort);
-    if (options.signal?.aborted) {
-      triggerKill();
-    }
-    let stdout = "";
-    let stderr = "";
-    if (captureMode === "buffer") {
-      child.stdout?.setEncoding("utf8");
-      child.stderr?.setEncoding("utf8");
-      child.stdout?.on("data", (chunk) => {
-        stdout += chunk;
-      });
-      child.stderr?.on("data", (chunk) => {
-        stderr += chunk;
-      });
-      if (options.stdin !== void 0) {
-        child.stdin?.end(options.stdin);
-      } else {
-        child.stdin?.end();
+    } catch {
+      eventsUnreadable = true;
+      if (!unreadableEmitted.has(entry.sessionId)) {
+        wrappedSkip(entry.sessionId, "events_jsonl_unreadable");
       }
     }
-    if (options.timeout_ms !== void 0) {
-      timeoutTimer = setTimeout(triggerKill, options.timeout_ms);
-    }
-    const cleanup = () => {
-      if (timeoutTimer !== null) clearTimeout(timeoutTimer);
-      if (killTimer !== null) clearTimeout(killTimer);
-      options.signal?.removeEventListener("abort", onAbort);
-    };
-    return new Promise((resolve2, reject) => {
-      child.once("error", (error) => {
-        if (settled) return;
-        settled = true;
-        cleanup();
-        reject(classifySpawnError(error));
-      });
-      child.once("close", (code, signal) => {
-        if (settled) return;
-        settled = true;
-        cleanup();
-        const ended_at = /* @__PURE__ */ new Date();
-        resolve2({
-          command: snapshotCommand,
-          args: snapshotArgs,
-          cwd: snapshotCwd,
-          exit_code: code,
-          signal,
-          stdout,
-          stderr,
-          started_at: started_at.toISOString(),
-          ended_at: ended_at.toISOString(),
-          duration_ms: ended_at.getTime() - started_at.getTime(),
-          pid: child.pid ?? null
-        });
-      });
-    });
-  }
-};
-function validateOptions(options) {
-  if (options.timeout_ms !== void 0 && (!Number.isFinite(options.timeout_ms) || options.timeout_ms <= 0)) {
-    throw new Error("Invalid timeout_ms");
+    sessions.push(
+      sessionWorkStatsFromEvents(
+        entry.sessionId,
+        entry.session.session,
+        events,
+        now,
+        eventsUnreadable
+      )
+    );
   }
-  if (options.capture === "none" && options.stdin !== void 0) {
-    throw new Error('Combination of capture: "none" and stdin is not supported');
+  const allIntervals = [];
+  for (const s of sessions) allIntervals.push(...intervalsIsoToMs(s.activeIntervals));
+  const union = unionDurationMs(allIntervals);
+  return {
+    generatedAt: now.toISOString(),
+    activeGapCapMs: ACTIVE_GAP_CAP_MS,
+    timeZone,
+    totals: computeTotals(sessions, union.ms),
+    sessions,
+    bySource: computeBySource(sessions),
+    byStatus: computeByStatus(sessions),
+    byDay: computeByDay(sessions, union.merged, timeZone)
+  };
+}
+function sessionWorkStatsFromEvents(sessionId, inner, events, now, eventsUnreadable = false) {
+  let commandCount = 0;
+  let fileChangedCount = 0;
+  let decisionCount = 0;
+  let commandTimeMs = 0;
+  const timestamps = [];
+  for (const ev of events) {
+    const t = Date.parse(ev.occurred_at);
+    if (Number.isFinite(t)) timestamps.push(t);
+    if (ev.type === "command_executed") {
+      commandCount++;
+      commandTimeMs += ev.duration_ms;
+    } else if (ev.type === "file_changed") {
+      fileChangedCount++;
+    } else if (ev.type === "decision_recorded") {
+      decisionCount++;
+    }
   }
+  const span = computeSpan(inner.started_at, inner.ended_at, now);
+  const tokens = readTokens(inner.metrics);
+  const active = resolveActiveTime(inner.metrics, timestamps);
+  const machineActiveTimeMs = inner.metrics?.machine_active_time_ms ?? 0;
+  return {
+    sessionId,
+    label: inner.label,
+    status: inner.status,
+    sourceKind: inner.source.kind,
+    startedAt: inner.started_at,
+    endedAt: inner.ended_at,
+    open: inner.ended_at === void 0,
+    sessionSpanMs: span.ms,
+    commandTimeMs,
+    activeTimeMs: active.ms,
+    activeTimeBasis: active.basis,
+    activeIntervals: intervalsMsToIso(active.intervals),
+    machineActiveTimeMs,
+    activeTimeMethod: inner.metrics?.active_time_method,
+    commandCount,
+    fileChangedCount,
+    decisionCount,
+    eventCount: events.length,
+    tokens,
+    availability: {
+      span: true,
+      commandTime: inner.source.kind !== "claude-code-import",
+      activeTime: active.intervals.length > 0,
+      tokens: hasTokens(tokens),
+      machineActive: machineActiveTimeMs > 0
+    },
+    spanClamped: span.clamped,
+    eventsUnreadable
+  };
 }
-function classifySpawnError(error) {
-  if (findErrorCode(error, "ENOENT")) {
-    return new Error("Command not found", { cause: error });
+function resolveActiveTime(metrics, eventTimestamps) {
+  const stored = metrics?.active_intervals;
+  if (stored !== void 0 && stored.length > 0) {
+    const intervals = intervalsIsoToMs(stored);
+    const ms = intervals.reduce((n, [start, end]) => n + (end - start), 0);
+    return { ms, intervals, basis: "engaged-turns" };
   }
-  return new Error("Failed to spawn child process", { cause: error });
+  const derived = activeTimeFromTimestamps(eventTimestamps, ACTIVE_GAP_CAP_MS);
+  return { ms: derived.ms, intervals: derived.intervals, basis: "events" };
 }
-
-// src/schemas/json-schema.ts
-import { z as z11 } from "zod";
-
-// src/schemas/manifest.schema.ts
-import { z as z9 } from "zod";
-var ProjectSchema = z9.object({
-  name: z9.string().optional(),
-  description: z9.string().optional(),
-  repository_url: z9.string().nullable().optional()
-});
-var CapabilitiesSchema = z9.object({
-  enabled: z9.array(z9.string())
-});
-var ApprovalConfigSchema = z9.object({
-  required_for: z9.array(z9.string()).optional(),
-  default_risk_level: z9.enum(["low", "medium", "high", "critical"])
-});
-var ClaudeCodeAdapterConfigSchema = z9.object({
-  enabled: z9.boolean(),
-  config_path: z9.string().optional()
-});
-var AdaptersSchema = z9.object({
-  "claude-code": ClaudeCodeAdapterConfigSchema
-});
-var GitConfigSchema = z9.object({
-  events_log: z9.enum(["ignore", "commit"]).default("ignore")
-});
-var SOURCE_ROOT_PATTERN = /^(?![~/\\])(?![A-Za-z]:)[^\0\\]+$/;
-var SourceRootSchema = z9.string().min(1).regex(SOURCE_ROOT_PATTERN, {
-  message: "source_roots entries must be relative paths (no absolute path, '~', '\\', or null byte)"
-});
-var ImportConfigSchema = z9.object({
-  source_roots: z9.array(SourceRootSchema).min(1).optional()
-});
-var WorkspaceMetaSchema = z9.object({
-  id: WorkspaceIdSchema,
-  name: z9.string().min(1),
-  created_at: IsoTimestampSchema,
-  updated_at: IsoTimestampSchema
-});
-var ManifestSchema = z9.object({
-  schema_version: SchemaVersionSchema,
-  basou_version: z9.literal("0.1.0"),
-  workspace: WorkspaceMetaSchema,
-  project: ProjectSchema,
-  capabilities: CapabilitiesSchema,
-  approval: ApprovalConfigSchema,
-  adapters: AdaptersSchema,
-  git: GitConfigSchema,
-  import: ImportConfigSchema.optional()
-});
-
-// src/schemas/session-import.schema.ts
-import { z as z10 } from "zod";
-var SessionInnerImportSchema = z10.object({
-  id: SessionIdSchema.optional(),
-  label: z10.string().optional(),
-  task_id: TaskIdSchema.nullable().optional(),
-  workspace_id: WorkspaceIdSchema,
-  source: z10.object({
-    kind: SessionSourceKindSchema,
-    version: z10.literal("0.1.0"),
-    // Source-tool-native id (e.g. Claude Code session UUID), retained so
-    // re-imports of the same source can be deduplicated.
-    external_id: z10.string().optional(),
-    // Byte size of the source native log at import time. Declared here too
-    // (not only in session.schema.ts) because this inner `source` object is
-    // a plain z.object: zod strips keys it does not declare, so a field
-    // absent here would be dropped from the parsed payload before persist
-    // and the size could never be stored.
-    source_size_bytes: z10.number().int().nonnegative().optional()
-  }),
-  started_at: IsoTimestampSchema,
-  ended_at: IsoTimestampSchema.optional(),
-  status: SessionStatusSchema,
-  working_directory: z10.string().min(1),
-  invocation: z10.object({
-    command: z10.string().min(1),
-    args: z10.array(z10.string()),
-    exit_code: z10.number().int().nullable()
-  }),
-  related_files: z10.array(z10.string()).default([]),
-  events_log: z10.string().optional(),
-  summary: z10.string().nullable().optional(),
-  metrics: SessionMetricsSchema.optional(),
-  // Accepted so a payload assembled from an on-disk chained session.yaml
-  // round-trips, and DISCARDED by the importer (buildSessionRecord never
-  // copies it): the integrity anchor is computed at write time, never
-  // imported. Mirrors the accept-and-discard of `prev_hash` on events.
-  integrity: SessionIntegritySchema.optional()
-}).strict();
-var SessionImportPayloadSchema = z10.object({
-  schema_version: z10.string(),
-  session: SessionInnerImportSchema,
-  events: z10.array(EventSchema)
-}).strict();
-
-// src/schemas/json-schema.ts
-var JSON_SCHEMA_VERSION = "0.1.0";
-var ID_BASE = `https://basou.dev/schemas/${JSON_SCHEMA_VERSION}`;
-var JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
-var DOCUMENTS = [
-  {
-    name: "manifest",
-    schema: ManifestSchema,
-    title: "Basou Manifest",
-    description: "The `.basou/manifest.yaml` workspace manifest."
-  },
-  {
-    name: "session",
-    schema: SessionSchema,
-    title: "Basou Session",
-    description: "A `.basou/sessions/<id>/session.yaml` session record."
-  },
-  {
-    name: "event",
-    schema: EventSchema,
-    title: "Basou Event",
-    description: "One line of a `.basou/sessions/<id>/events.jsonl` stream (a discriminated union over the event `type`)."
-  },
-  {
-    name: "task",
-    schema: TaskSchema,
-    title: "Basou Task",
-    description: "The YAML front matter of a `.basou/tasks/<id>.md` task document."
-  },
-  {
-    name: "approval",
-    schema: ApprovalSchema,
-    title: "Basou Approval",
-    description: "A `.basou/approvals/{pending,resolved}/<id>.yaml` approval record."
-  },
-  {
-    name: "status",
-    schema: StatusSchema,
-    title: "Basou Status",
-    description: "The `.basou/status.json` workspace status snapshot."
-  },
-  {
-    name: "task-index",
-    schema: TaskIndexSchema,
-    title: "Basou Task Index",
-    description: "The `.basou/tasks/index.json` task lookup index."
-  },
-  {
-    name: "session-import",
-    schema: SessionImportPayloadSchema,
-    title: "Basou Session Import Payload",
-    description: "The portable session payload consumed by `basou session import`."
+function computeSpan(startedAt, endedAt, now) {
+  const start = Date.parse(startedAt);
+  const end = endedAt !== void 0 ? Date.parse(endedAt) : now.getTime();
+  if (!Number.isFinite(start) || !Number.isFinite(end)) return { ms: 0, clamped: true };
+  const raw = end - start;
+  return raw < 0 ? { ms: 0, clamped: true } : { ms: raw, clamped: false };
+}
+function readTokens(metrics) {
+  return {
+    output: metrics?.output_tokens ?? 0,
+    input: metrics?.input_tokens ?? 0,
+    cached: metrics?.cached_input_tokens ?? 0,
+    reasoning: metrics?.reasoning_output_tokens ?? 0
+  };
+}
+function hasTokens(t) {
+  return t.output > 0 || t.input > 0 || t.cached > 0 || t.reasoning > 0;
+}
+function emptyTokens() {
+  return { output: 0, input: 0, cached: 0, reasoning: 0 };
+}
+function addTokens(a, b) {
+  a.output += b.output;
+  a.input += b.input;
+  a.cached += b.cached;
+  a.reasoning += b.reasoning;
+}
+function computeTotals(sessions, billableActiveTimeMs) {
+  const tokens = emptyTokens();
+  const totals = {
+    sessionCount: sessions.length,
+    openSessionCount: 0,
+    sessionSpanMs: 0,
+    commandTimeMs: 0,
+    activeTimeMs: 0,
+    billableActiveTimeMs,
+    machineActiveTimeMs: 0,
+    commandCount: 0,
+    fileChangedCount: 0,
+    decisionCount: 0,
+    eventCount: 0,
+    tokens,
+    commandTimeReliable: true,
+    tokensAvailable: false,
+    machineActiveAvailable: false
+  };
+  for (const s of sessions) {
+    if (s.open) totals.openSessionCount++;
+    totals.sessionSpanMs += s.sessionSpanMs;
+    totals.commandTimeMs += s.commandTimeMs;
+    totals.activeTimeMs += s.activeTimeMs;
+    totals.machineActiveTimeMs += s.machineActiveTimeMs;
+    totals.commandCount += s.commandCount;
+    totals.fileChangedCount += s.fileChangedCount;
+    totals.decisionCount += s.decisionCount;
+    totals.eventCount += s.eventCount;
+    addTokens(tokens, s.tokens);
+    if (!s.availability.commandTime) totals.commandTimeReliable = false;
+    if (s.availability.tokens) totals.tokensAvailable = true;
+    if (s.availability.machineActive) totals.machineActiveAvailable = true;
   }
-];
-function buildJsonSchemas() {
-  return DOCUMENTS.map((doc) => {
-    const generated = z11.toJSONSchema(doc.schema, { io: "input" });
-    const { $schema, ...rest } = generated;
-    const schema = {
-      $schema: typeof $schema === "string" ? $schema : JSON_SCHEMA_DIALECT,
-      $id: `${ID_BASE}/${doc.name}.schema.json`,
-      title: doc.title,
-      description: doc.description,
-      ...rest
-    };
-    return { name: doc.name, schema };
-  });
+  return totals;
 }
-function serializeJsonSchema(schema) {
-  return `${JSON.stringify(schema, null, 2)}
-`;
+function computeBySource(sessions) {
+  const map = /* @__PURE__ */ new Map();
+  for (const s of sessions) {
+    let row = map.get(s.sourceKind);
+    if (row === void 0) {
+      row = {
+        sourceKind: s.sourceKind,
+        sessionCount: 0,
+        sessionSpanMs: 0,
+        commandTimeMs: 0,
+        activeTimeMs: 0,
+        machineActiveTimeMs: 0,
+        commandCount: 0,
+        fileChangedCount: 0,
+        decisionCount: 0,
+        eventCount: 0,
+        tokens: emptyTokens(),
+        commandTimeReliable: true,
+        tokensAvailable: false,
+        machineActiveAvailable: false
+      };
+      map.set(s.sourceKind, row);
+    }
+    row.sessionCount++;
+    row.sessionSpanMs += s.sessionSpanMs;
+    row.commandTimeMs += s.commandTimeMs;
+    row.activeTimeMs += s.activeTimeMs;
+    row.machineActiveTimeMs += s.machineActiveTimeMs;
+    row.commandCount += s.commandCount;
+    row.fileChangedCount += s.fileChangedCount;
+    row.decisionCount += s.decisionCount;
+    row.eventCount += s.eventCount;
+    addTokens(row.tokens, s.tokens);
+    if (!s.availability.commandTime) row.commandTimeReliable = false;
+    if (s.availability.tokens) row.tokensAvailable = true;
+    if (s.availability.machineActive) row.machineActiveAvailable = true;
+  }
+  return [...map.values()].sort((a, b) => a.sourceKind.localeCompare(b.sourceKind));
 }
-
-// src/stats/work-stats.ts
-import { join as join13 } from "path";
-function resolveTimeZone(timeZone) {
-  if (timeZone !== void 0 && timeZone.length > 0) return timeZone;
-  return Intl.DateTimeFormat().resolvedOptions().timeZone;
+function computeByStatus(sessions) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const s of sessions) counts.set(s.status, (counts.get(s.status) ?? 0) + 1);
+  const ordered = [];
+  for (const status of STATUS_ORDER) {
+    const count = counts.get(status);
+    if (count !== void 0 && count > 0) ordered.push({ status, count });
+  }
+  return ordered;
 }
-var STATUS_ORDER = [
+function computeByDay(sessions, unionMerged, timeZone) {
+  const days = /* @__PURE__ */ new Map();
+  const ensure = (date) => {
+    let day = days.get(date);
+    if (day === void 0) {
+      day = {
+        date,
+        billableActiveTimeMs: 0,
+        machineActiveTimeMs: 0,
+        sessionCount: 0,
+        commandCount: 0,
+        fileChangedCount: 0,
+        decisionCount: 0,
+        tokens: emptyTokens()
+      };
+      days.set(date, day);
+    }
+    return day;
+  };
+  for (const [start, end] of unionMerged) {
+    ensure(tzDate(start, timeZone)).billableActiveTimeMs += end - start;
+  }
+  for (const s of sessions) {
+    const startedMs = Date.parse(s.startedAt);
+    if (!Number.isFinite(startedMs)) continue;
+    const day = ensure(tzDate(startedMs, timeZone));
+    day.sessionCount++;
+    day.machineActiveTimeMs += s.machineActiveTimeMs;
+    day.commandCount += s.commandCount;
+    day.fileChangedCount += s.fileChangedCount;
+    day.decisionCount += s.decisionCount;
+    addTokens(day.tokens, s.tokens);
+  }
+  return [...days.values()].sort((a, b) => a.date.localeCompare(b.date));
+}
+function tzDate(ms, timeZone) {
+  return new Intl.DateTimeFormat("en-CA", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).format(new Date(ms));
+}
+
+// src/report/report-renderer.ts
+var CHANGED_FILES_MARKDOWN_LIMIT = 50;
+var DECISIONS_MARKDOWN_LIMIT = 20;
+var SESSIONS_MARKDOWN_LIMIT = 30;
+var TASKS_MARKDOWN_LIMIT = 30;
+var APPROVALS_MARKDOWN_LIMIT = 30;
+var SESSION_STATUS_ORDER = [
   "completed",
   "failed",
   "running",
-  "interrupted",
   "waiting_approval",
+  "interrupted",
   "initialized",
   "imported",
   "archived"
 ];
-async function computeWorkStats(input) {
-  const { now } = input;
-  const timeZone = resolveTimeZone(input.timeZone);
+var TASK_STATUS_ORDER = ["planned", "in_progress", "done", "cancelled"];
+async function renderReport(input) {
+  const now = new Date(input.nowIso);
   const unreadableEmitted = /* @__PURE__ */ new Set();
   const wrappedSkip = (sid, reason) => {
     if (reason === "events_jsonl_unreadable") unreadableEmitted.add(sid);
@@ -4401,288 +4407,607 @@ async function computeWorkStats(input) {
   const loadOpts = { now, onSkip: wrappedSkip };
   if (input.onWarning !== void 0) loadOpts.onWarning = input.onWarning;
   const entries = await loadSessionEntries(input.paths, loadOpts);
-  const sessions = [];
+  const statsInput = { paths: input.paths, now };
+  if (input.timeZone !== void 0) statsInput.timeZone = input.timeZone;
+  const stats = await computeWorkStats(statsInput);
+  const statsBySession = new Map(stats.sessions.map((s) => [s.sessionId, s]));
+  const decisions = [];
   for (const entry of entries) {
-    const events = [];
-    let eventsUnreadable = false;
+    const sessionDir = join14(input.paths.sessions, entry.sessionId);
     try {
-      for await (const ev of replayEvents(join13(input.paths.sessions, entry.sessionId), {
+      for await (const ev of replayEvents(sessionDir, {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
       })) {
-        events.push(ev);
+        if (ev.type === "decision_recorded") {
+          decisions.push({ id: ev.decision_id, title: ev.title, occurredAt: ev.occurred_at });
+        }
       }
     } catch {
-      eventsUnreadable = true;
       if (!unreadableEmitted.has(entry.sessionId)) {
         wrappedSkip(entry.sessionId, "events_jsonl_unreadable");
       }
     }
-    sessions.push(
-      sessionWorkStatsFromEvents(
-        entry.sessionId,
-        entry.session.session,
-        events,
-        now,
-        eventsUnreadable
-      )
-    );
   }
-  const allIntervals = [];
-  for (const s of sessions) allIntervals.push(...intervalsIsoToMs(s.activeIntervals));
-  const union = unionDurationMs(allIntervals);
-  return {
-    generatedAt: now.toISOString(),
-    activeGapCapMs: ACTIVE_GAP_CAP_MS,
-    timeZone,
-    totals: computeTotals(sessions, union.ms),
-    sessions,
-    bySource: computeBySource(sessions),
-    byStatus: computeByStatus(sessions),
-    byDay: computeByDay(sessions, union.merged, timeZone)
+  decisions.sort((a, b) => {
+    const c = Date.parse(a.occurredAt) - Date.parse(b.occurredAt);
+    return c !== 0 ? c : a.id.localeCompare(b.id);
+  });
+  const taskLoadOpts = {};
+  if (input.onTaskSkip !== void 0) taskLoadOpts.onSkip = input.onTaskSkip;
+  const taskEntries = await loadTaskEntries(input.paths, taskLoadOpts);
+  const taskItems = taskEntries.map((t2) => ({
+    id: t2.task.task.id,
+    title: t2.task.task.title,
+    status: t2.task.task.status
+  }));
+  const tasksByStatus = tallyTaskStatus(taskItems);
+  const approvalIds = await enumerateApprovals(input.paths);
+  const resolvedSet = new Set(approvalIds.resolved);
+  const pendingIds = approvalIds.pending.filter((id) => !resolvedSet.has(id));
+  const loadedApprovals = (await Promise.all(
+    [...pendingIds, ...approvalIds.resolved].map((id) => loadApproval(input.paths, id))
+  )).filter((a) => a !== null);
+  const approvalItems = loadedApprovals.map((a) => ({
+    id: a.approval.id,
+    reason: a.approval.reason,
+    status: a.approval.status,
+    riskLevel: a.approval.risk_level
+  }));
+  const approvalCounts = { pending: 0, approved: 0, rejected: 0, expired: 0 };
+  for (const a of approvalItems) approvalCounts[a.status] += 1;
+  const changedSet = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (entry.session.session.source.kind === "import") continue;
+    for (const f of entry.session.session.related_files) changedSet.add(f);
+  }
+  const changedFiles = [...changedSet].sort();
+  const integrity = {
+    total: 0,
+    verified: 0,
+    unchained: 0,
+    empty: 0,
+    incomplete: 0,
+    in_progress: 0,
+    tampered: 0,
+    tamperedSessions: []
   };
-}
-function sessionWorkStatsFromEvents(sessionId, inner, events, now, eventsUnreadable = false) {
-  let commandCount = 0;
-  let fileChangedCount = 0;
-  let decisionCount = 0;
-  let commandTimeMs = 0;
-  const timestamps = [];
-  for (const ev of events) {
-    const t = Date.parse(ev.occurred_at);
-    if (Number.isFinite(t)) timestamps.push(t);
-    if (ev.type === "command_executed") {
-      commandCount++;
-      commandTimeMs += ev.duration_ms;
-    } else if (ev.type === "file_changed") {
-      fileChangedCount++;
-    } else if (ev.type === "decision_recorded") {
-      decisionCount++;
+  for (const entry of entries) {
+    const verdict = await verifyEventsChain(input.paths, entry.sessionId).catch(() => null);
+    if (verdict === null) {
+      if (!unreadableEmitted.has(entry.sessionId)) {
+        wrappedSkip(entry.sessionId, "events_jsonl_unreadable");
+      }
+      continue;
     }
-  }
-  const span = computeSpan(inner.started_at, inner.ended_at, now);
-  const tokens = readTokens(inner.metrics);
-  const active = resolveActiveTime(inner.metrics, timestamps);
-  const machineActiveTimeMs = inner.metrics?.machine_active_time_ms ?? 0;
-  return {
-    sessionId,
-    label: inner.label,
-    status: inner.status,
-    sourceKind: inner.source.kind,
-    startedAt: inner.started_at,
-    endedAt: inner.ended_at,
-    open: inner.ended_at === void 0,
-    sessionSpanMs: span.ms,
-    commandTimeMs,
-    activeTimeMs: active.ms,
-    activeTimeBasis: active.basis,
-    activeIntervals: intervalsMsToIso(active.intervals),
-    machineActiveTimeMs,
-    activeTimeMethod: inner.metrics?.active_time_method,
-    commandCount,
-    fileChangedCount,
-    decisionCount,
-    eventCount: events.length,
-    tokens,
-    availability: {
-      span: true,
-      commandTime: inner.source.kind !== "claude-code-import",
-      activeTime: active.intervals.length > 0,
-      tokens: hasTokens(tokens),
-      machineActive: machineActiveTimeMs > 0
+    integrity.total += 1;
+    integrity[verdict.status] += 1;
+    if (verdict.status === "tampered") integrity.tamperedSessions.push(entry.sessionId);
+  }
+  const sessionItems = [...entries].sort(
+    (a, b) => Date.parse(b.session.session.started_at) - Date.parse(a.session.session.started_at)
+  ).map((e) => {
+    const w = statsBySession.get(e.sessionId);
+    return {
+      id: e.sessionId,
+      label: e.session.session.label ?? null,
+      status: e.session.session.status,
+      source: e.session.session.source.kind,
+      startedAt: e.session.session.started_at,
+      activeMs: w?.activeTimeMs ?? 0,
+      outputTokens: w?.tokens.output ?? 0
+    };
+  });
+  const period = computePeriod(entries, input.nowIso);
+  const t = stats.totals;
+  const data = {
+    generatedAt: input.nowIso,
+    ...input.title !== void 0 ? { title: input.title } : {},
+    period,
+    sessions: { total: entries.length, byStatus: stats.byStatus, items: sessionItems },
+    volume: {
+      outputTokens: t.tokens.output,
+      reasoningTokens: t.tokens.reasoning,
+      commandCount: t.commandCount,
+      fileChangedCount: t.fileChangedCount,
+      decisionCount: t.decisionCount,
+      tokensAvailable: t.tokensAvailable
     },
-    spanClamped: span.clamped,
-    eventsUnreadable
+    time: {
+      activeMs: t.billableActiveTimeMs,
+      machineActiveMs: t.machineActiveTimeMs,
+      machineAvailable: t.machineActiveAvailable,
+      spanMs: t.sessionSpanMs,
+      commandTimeMs: t.commandTimeMs,
+      timeZone: stats.timeZone
+    },
+    decisions: { count: decisions.length, items: decisions },
+    approvals: { ...approvalCounts, items: approvalItems },
+    tasks: { total: taskEntries.length, byStatus: tasksByStatus, items: taskItems },
+    changedFiles,
+    integrity
   };
+  return { body: formatReportBody(data), data };
+}
+function computePeriod(entries, nowIso) {
+  if (entries.length === 0) return { from: null, to: null };
+  let from = entries[0]?.session.session.started_at ?? nowIso;
+  let to = nowIso;
+  let sawEnd = false;
+  for (const e of entries) {
+    const s = e.session.session.started_at;
+    if (Date.parse(s) < Date.parse(from)) from = s;
+    const end = e.session.session.ended_at ?? nowIso;
+    if (!sawEnd || Date.parse(end) > Date.parse(to)) {
+      to = end;
+      sawEnd = true;
+    }
+  }
+  if (Date.parse(to) < Date.parse(from)) to = from;
+  return { from, to };
+}
+function tallyTaskStatus(items) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const i of items) counts.set(i.status, (counts.get(i.status) ?? 0) + 1);
+  return TASK_STATUS_ORDER.filter((s) => (counts.get(s) ?? 0) > 0).map((status) => ({
+    status,
+    count: counts.get(status)
+  }));
 }
-function resolveActiveTime(metrics, eventTimestamps) {
-  const stored = metrics?.active_intervals;
-  if (stored !== void 0 && stored.length > 0) {
-    const intervals = intervalsIsoToMs(stored);
-    const ms = intervals.reduce((n, [start, end]) => n + (end - start), 0);
-    return { ms, intervals, basis: "engaged-turns" };
+function formatReportBody(data) {
+  const lines = [];
+  const titleSuffix = data.title !== void 0 ? ` \u2014 ${data.title}` : "";
+  lines.push(`# Report${titleSuffix}`);
+  lines.push("");
+  const periodSuffix = data.period.from !== null && data.period.to !== null ? ` (${data.period.from.slice(0, 10)}..${data.period.to.slice(0, 10)})` : "";
+  lines.push(`> Generated at ${data.generatedAt}${periodSuffix}`);
+  lines.push("");
+  lines.push("## \u6982\u8981");
+  lines.push("");
+  lines.push(`- ${formatSessionsLine(data)}`);
+  lines.push(
+    `- Active time ${formatDurationMs(data.time.activeMs)}, ${formatInt(data.volume.outputTokens)} output tokens`
+  );
+  lines.push("");
+  lines.push("## \u4F5C\u696D\u91CF");
+  lines.push("");
+  const tokenCaveat = data.volume.tokensAvailable ? "" : "  (no token data captured)";
+  lines.push(`- Output tokens: ${formatInt(data.volume.outputTokens)}${tokenCaveat}`);
+  if (data.volume.reasoningTokens > 0) {
+    lines.push(`- Reasoning tokens: ${formatInt(data.volume.reasoningTokens)}  (Codex)`);
   }
-  const derived = activeTimeFromTimestamps(eventTimestamps, ACTIVE_GAP_CAP_MS);
-  return { ms: derived.ms, intervals: derived.intervals, basis: "events" };
-}
-function computeSpan(startedAt, endedAt, now) {
-  const start = Date.parse(startedAt);
-  const end = endedAt !== void 0 ? Date.parse(endedAt) : now.getTime();
-  if (!Number.isFinite(start) || !Number.isFinite(end)) return { ms: 0, clamped: true };
-  const raw = end - start;
-  return raw < 0 ? { ms: 0, clamped: true } : { ms: raw, clamped: false };
-}
-function readTokens(metrics) {
-  return {
-    output: metrics?.output_tokens ?? 0,
-    input: metrics?.input_tokens ?? 0,
-    cached: metrics?.cached_input_tokens ?? 0,
-    reasoning: metrics?.reasoning_output_tokens ?? 0
-  };
-}
-function hasTokens(t) {
-  return t.output > 0 || t.input > 0 || t.cached > 0 || t.reasoning > 0;
-}
-function emptyTokens() {
-  return { output: 0, input: 0, cached: 0, reasoning: 0 };
+  lines.push(
+    `- Actions: ${data.volume.commandCount} commands, ${data.volume.fileChangedCount} files, ${data.volume.decisionCount} decisions`
+  );
+  lines.push(
+    `- Active time: ${formatDurationMs(data.time.activeMs)}  (union; idle gaps > 5m excluded; tz ${data.time.timeZone})`
+  );
+  if (data.time.machineAvailable) {
+    lines.push(
+      `- Model working: ${formatDurationMs(data.time.machineActiveMs)}  (model compute, subset of active)`
+    );
+  }
+  lines.push(`- Span: ${formatDurationMs(data.time.spanMs)}  (total elapsed)`);
+  lines.push("");
+  lines.push("## \u5224\u65AD");
+  lines.push("");
+  if (data.decisions.items.length === 0) {
+    lines.push("(no decisions recorded yet)");
+  } else {
+    const total = data.decisions.items.length;
+    const shown = total > DECISIONS_MARKDOWN_LIMIT ? data.decisions.items.slice(-DECISIONS_MARKDOWN_LIMIT) : data.decisions.items;
+    if (total > DECISIONS_MARKDOWN_LIMIT) {
+      lines.push(`(showing the ${DECISIONS_MARKDOWN_LIMIT} most recent of ${total})`);
+      lines.push("");
+    }
+    for (const d of shown) {
+      lines.push(`- ${d.occurredAt.slice(0, 10)} \xB7 ${d.title}`);
+    }
+  }
+  lines.push("");
+  lines.push("## \u627F\u8A8D");
+  lines.push("");
+  if (data.approvals.items.length === 0) {
+    lines.push("(none)");
+  } else {
+    const a = data.approvals;
+    lines.push(
+      `Pending ${a.pending} \xB7 Approved ${a.approved} \xB7 Rejected ${a.rejected} \xB7 Expired ${a.expired}`
+    );
+    lines.push("");
+    for (const item of data.approvals.items.slice(0, APPROVALS_MARKDOWN_LIMIT)) {
+      lines.push(`- ${item.reason} (${item.status}, ${item.riskLevel})`);
+    }
+    const overflow = data.approvals.items.length - APPROVALS_MARKDOWN_LIMIT;
+    if (overflow > 0) lines.push(`- ... +${overflow} more`);
+  }
+  lines.push("");
+  lines.push("## \u30BF\u30B9\u30AF");
+  lines.push("");
+  if (data.tasks.items.length === 0) {
+    lines.push("(no tasks recorded yet)");
+  } else {
+    const breakdown = data.tasks.byStatus.map((s) => `${s.status} ${s.count}`).join(", ");
+    lines.push(`Tasks: ${data.tasks.total} (${breakdown})`);
+    lines.push("");
+    for (const item of data.tasks.items.slice(0, TASKS_MARKDOWN_LIMIT)) {
+      lines.push(`- ${item.title} (${item.status})`);
+    }
+    const overflow = data.tasks.items.length - TASKS_MARKDOWN_LIMIT;
+    if (overflow > 0) lines.push(`- ... +${overflow} more`);
+  }
+  lines.push("");
+  lines.push("## \u5909\u66F4\u30D5\u30A1\u30A4\u30EB");
+  lines.push("");
+  if (data.changedFiles.length === 0) {
+    lines.push("(no related files recorded)");
+  } else {
+    for (const f of data.changedFiles.slice(0, CHANGED_FILES_MARKDOWN_LIMIT)) lines.push(`- ${f}`);
+    const overflow = data.changedFiles.length - CHANGED_FILES_MARKDOWN_LIMIT;
+    if (overflow > 0) lines.push(`- ... +${overflow} more`);
+  }
+  lines.push("");
+  lines.push("## \u30BB\u30C3\u30B7\u30E7\u30F3\u4E00\u89A7");
+  lines.push("");
+  if (data.sessions.items.length === 0) {
+    lines.push("(no sessions yet)");
+  } else {
+    lines.push("| started_at | source | status | active | out tok |");
+    lines.push("|---|---|---|---|---|");
+    for (const s of data.sessions.items.slice(0, SESSIONS_MARKDOWN_LIMIT)) {
+      lines.push(
+        `| ${s.startedAt} | ${s.source} | ${s.status} | ${formatDurationMs(s.activeMs)} | ${formatInt(s.outputTokens)} |`
+      );
+    }
+    const overflow = data.sessions.items.length - SESSIONS_MARKDOWN_LIMIT;
+    if (overflow > 0) {
+      lines.push("");
+      lines.push(`... +${overflow} more sessions`);
+    }
+  }
+  lines.push("");
+  lines.push("## \u6574\u5408\u6027");
+  lines.push("");
+  const i = data.integrity;
+  lines.push(
+    `Provenance internally tamper-checked: ${i.verified} verified, ${i.unchained} unchained, ${i.empty} empty, ${i.incomplete} incomplete, ${i.in_progress} in_progress, ${i.tampered} tampered (of ${i.total} sessions).`
+  );
+  lines.push("");
+  lines.push(
+    "This reflects internal consistency of the local event-log hash chain \u2014 not a third-party cryptographic proof."
+  );
+  if (i.tampered > 0) {
+    lines.push("");
+    for (const id of i.tamperedSessions) lines.push(`- Tampered: ${id}`);
+  }
+  return lines.join("\n");
 }
-function addTokens(a, b) {
-  a.output += b.output;
-  a.input += b.input;
-  a.cached += b.cached;
-  a.reasoning += b.reasoning;
+function formatSessionsLine(data) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const s of data.sessions.byStatus) counts.set(s.status, s.count);
+  const breakdown = SESSION_STATUS_ORDER.filter((s) => (counts.get(s) ?? 0) > 0).map((s) => `${s} ${counts.get(s)}`).join(", ");
+  return breakdown !== "" ? `Sessions: ${data.sessions.total} (${breakdown})` : `Sessions: ${data.sessions.total}`;
 }
-function computeTotals(sessions, billableActiveTimeMs) {
-  const tokens = emptyTokens();
-  const totals = {
-    sessionCount: sessions.length,
-    openSessionCount: 0,
-    sessionSpanMs: 0,
-    commandTimeMs: 0,
-    activeTimeMs: 0,
-    billableActiveTimeMs,
-    machineActiveTimeMs: 0,
-    commandCount: 0,
-    fileChangedCount: 0,
-    decisionCount: 0,
-    eventCount: 0,
-    tokens,
-    commandTimeReliable: true,
-    tokensAvailable: false,
-    machineActiveAvailable: false
-  };
-  for (const s of sessions) {
-    if (s.open) totals.openSessionCount++;
-    totals.sessionSpanMs += s.sessionSpanMs;
-    totals.commandTimeMs += s.commandTimeMs;
-    totals.activeTimeMs += s.activeTimeMs;
-    totals.machineActiveTimeMs += s.machineActiveTimeMs;
-    totals.commandCount += s.commandCount;
-    totals.fileChangedCount += s.fileChangedCount;
-    totals.decisionCount += s.decisionCount;
-    totals.eventCount += s.eventCount;
-    addTokens(tokens, s.tokens);
-    if (!s.availability.commandTime) totals.commandTimeReliable = false;
-    if (s.availability.tokens) totals.tokensAvailable = true;
-    if (s.availability.machineActive) totals.machineActiveAvailable = true;
-  }
-  return totals;
+function formatInt(n) {
+  return n.toLocaleString("en-US");
 }
-function computeBySource(sessions) {
-  const map = /* @__PURE__ */ new Map();
-  for (const s of sessions) {
-    let row = map.get(s.sourceKind);
-    if (row === void 0) {
-      row = {
-        sourceKind: s.sourceKind,
-        sessionCount: 0,
-        sessionSpanMs: 0,
-        commandTimeMs: 0,
-        activeTimeMs: 0,
-        machineActiveTimeMs: 0,
-        commandCount: 0,
-        fileChangedCount: 0,
-        decisionCount: 0,
-        eventCount: 0,
-        tokens: emptyTokens(),
-        commandTimeReliable: true,
-        tokensAvailable: false,
-        machineActiveAvailable: false
-      };
-      map.set(s.sourceKind, row);
+
+// src/runtime/child-process-runner.ts
+import { spawn as spawn2 } from "child_process";
+var DEFAULT_KILL_GRACE_MS = 5e3;
+var ChildProcessRunner = class {
+  async run(command, args, options) {
+    validateOptions(options);
+    if (options.signal?.aborted) {
+      throw new Error("Process aborted before spawn", {
+        cause: options.signal.reason
+      });
     }
-    row.sessionCount++;
-    row.sessionSpanMs += s.sessionSpanMs;
-    row.commandTimeMs += s.commandTimeMs;
-    row.activeTimeMs += s.activeTimeMs;
-    row.machineActiveTimeMs += s.machineActiveTimeMs;
-    row.commandCount += s.commandCount;
-    row.fileChangedCount += s.fileChangedCount;
-    row.decisionCount += s.decisionCount;
-    row.eventCount += s.eventCount;
-    addTokens(row.tokens, s.tokens);
-    if (!s.availability.commandTime) row.commandTimeReliable = false;
-    if (s.availability.tokens) row.tokensAvailable = true;
-    if (s.availability.machineActive) row.machineActiveAvailable = true;
+    const snapshotCommand = command;
+    const snapshotArgs = [...args];
+    const snapshotCwd = options.cwd;
+    const captureMode = options.capture ?? "buffer";
+    const started_at = /* @__PURE__ */ new Date();
+    let child;
+    try {
+      child = spawn2(snapshotCommand, [...snapshotArgs], {
+        cwd: snapshotCwd,
+        env: options.env ?? process.env,
+        stdio: captureMode === "none" ? ["inherit", "inherit", "inherit"] : ["pipe", "pipe", "pipe"],
+        shell: false,
+        detached: false
+      });
+    } catch (error) {
+      throw classifySpawnError(error);
+    }
+    if (options.onSpawn) {
+      try {
+        options.onSpawn(child);
+      } catch {
+      }
+    }
+    let timeoutTimer = null;
+    let killTimer = null;
+    let killed = false;
+    let settled = false;
+    const triggerKill = () => {
+      if (killed || child.exitCode !== null) return;
+      killed = true;
+      child.kill("SIGTERM");
+      killTimer = setTimeout(() => {
+        if (child.exitCode === null) {
+          child.kill("SIGKILL");
+        }
+      }, DEFAULT_KILL_GRACE_MS);
+    };
+    const onAbort = () => {
+      triggerKill();
+    };
+    options.signal?.addEventListener("abort", onAbort);
+    if (options.signal?.aborted) {
+      triggerKill();
+    }
+    let stdout = "";
+    let stderr = "";
+    if (captureMode === "buffer") {
+      child.stdout?.setEncoding("utf8");
+      child.stderr?.setEncoding("utf8");
+      child.stdout?.on("data", (chunk) => {
+        stdout += chunk;
+      });
+      child.stderr?.on("data", (chunk) => {
+        stderr += chunk;
+      });
+      if (options.stdin !== void 0) {
+        child.stdin?.end(options.stdin);
+      } else {
+        child.stdin?.end();
+      }
+    }
+    if (options.timeout_ms !== void 0) {
+      timeoutTimer = setTimeout(triggerKill, options.timeout_ms);
+    }
+    const cleanup = () => {
+      if (timeoutTimer !== null) clearTimeout(timeoutTimer);
+      if (killTimer !== null) clearTimeout(killTimer);
+      options.signal?.removeEventListener("abort", onAbort);
+    };
+    return new Promise((resolve2, reject) => {
+      child.once("error", (error) => {
+        if (settled) return;
+        settled = true;
+        cleanup();
+        reject(classifySpawnError(error));
+      });
+      child.once("close", (code, signal) => {
+        if (settled) return;
+        settled = true;
+        cleanup();
+        const ended_at = /* @__PURE__ */ new Date();
+        resolve2({
+          command: snapshotCommand,
+          args: snapshotArgs,
+          cwd: snapshotCwd,
+          exit_code: code,
+          signal,
+          stdout,
+          stderr,
+          started_at: started_at.toISOString(),
+          ended_at: ended_at.toISOString(),
+          duration_ms: ended_at.getTime() - started_at.getTime(),
+          pid: child.pid ?? null
+        });
+      });
+    });
   }
-  return [...map.values()].sort((a, b) => a.sourceKind.localeCompare(b.sourceKind));
-}
-function computeByStatus(sessions) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const s of sessions) counts.set(s.status, (counts.get(s.status) ?? 0) + 1);
-  const ordered = [];
-  for (const status of STATUS_ORDER) {
-    const count = counts.get(status);
-    if (count !== void 0 && count > 0) ordered.push({ status, count });
+};
+function validateOptions(options) {
+  if (options.timeout_ms !== void 0 && (!Number.isFinite(options.timeout_ms) || options.timeout_ms <= 0)) {
+    throw new Error("Invalid timeout_ms");
+  }
+  if (options.capture === "none" && options.stdin !== void 0) {
+    throw new Error('Combination of capture: "none" and stdin is not supported');
   }
-  return ordered;
 }
-function computeByDay(sessions, unionMerged, timeZone) {
-  const days = /* @__PURE__ */ new Map();
-  const ensure = (date) => {
-    let day = days.get(date);
-    if (day === void 0) {
-      day = {
-        date,
-        billableActiveTimeMs: 0,
-        machineActiveTimeMs: 0,
-        sessionCount: 0,
-        commandCount: 0,
-        fileChangedCount: 0,
-        decisionCount: 0,
-        tokens: emptyTokens()
-      };
-      days.set(date, day);
-    }
-    return day;
-  };
-  for (const [start, end] of unionMerged) {
-    ensure(tzDate(start, timeZone)).billableActiveTimeMs += end - start;
+function classifySpawnError(error) {
+  if (findErrorCode(error, "ENOENT")) {
+    return new Error("Command not found", { cause: error });
   }
-  for (const s of sessions) {
-    const startedMs = Date.parse(s.startedAt);
-    if (!Number.isFinite(startedMs)) continue;
-    const day = ensure(tzDate(startedMs, timeZone));
-    day.sessionCount++;
-    day.machineActiveTimeMs += s.machineActiveTimeMs;
-    day.commandCount += s.commandCount;
-    day.fileChangedCount += s.fileChangedCount;
-    day.decisionCount += s.decisionCount;
-    addTokens(day.tokens, s.tokens);
+  return new Error("Failed to spawn child process", { cause: error });
+}
+
+// src/schemas/json-schema.ts
+import { z as z11 } from "zod";
+
+// src/schemas/manifest.schema.ts
+import { z as z9 } from "zod";
+var ProjectSchema = z9.object({
+  name: z9.string().optional(),
+  description: z9.string().optional(),
+  repository_url: z9.string().nullable().optional()
+});
+var CapabilitiesSchema = z9.object({
+  enabled: z9.array(z9.string())
+});
+var ApprovalConfigSchema = z9.object({
+  required_for: z9.array(z9.string()).optional(),
+  default_risk_level: z9.enum(["low", "medium", "high", "critical"])
+});
+var ClaudeCodeAdapterConfigSchema = z9.object({
+  enabled: z9.boolean(),
+  config_path: z9.string().optional()
+});
+var AdaptersSchema = z9.object({
+  "claude-code": ClaudeCodeAdapterConfigSchema
+});
+var GitConfigSchema = z9.object({
+  events_log: z9.enum(["ignore", "commit"]).default("ignore")
+});
+var SOURCE_ROOT_PATTERN = /^(?![~/\\])(?![A-Za-z]:)[^\0\\]+$/;
+var SourceRootSchema = z9.string().min(1).regex(SOURCE_ROOT_PATTERN, {
+  message: "source_roots entries must be relative paths (no absolute path, '~', '\\', or null byte)"
+});
+var ImportConfigSchema = z9.object({
+  source_roots: z9.array(SourceRootSchema).min(1).optional()
+});
+var WorkspaceMetaSchema = z9.object({
+  id: WorkspaceIdSchema,
+  name: z9.string().min(1),
+  created_at: IsoTimestampSchema,
+  updated_at: IsoTimestampSchema
+});
+var ManifestSchema = z9.object({
+  schema_version: SchemaVersionSchema,
+  basou_version: z9.literal("0.1.0"),
+  workspace: WorkspaceMetaSchema,
+  project: ProjectSchema,
+  capabilities: CapabilitiesSchema,
+  approval: ApprovalConfigSchema,
+  adapters: AdaptersSchema,
+  git: GitConfigSchema,
+  import: ImportConfigSchema.optional()
+});
+
+// src/schemas/session-import.schema.ts
+import { z as z10 } from "zod";
+var SessionInnerImportSchema = z10.object({
+  id: SessionIdSchema.optional(),
+  label: z10.string().optional(),
+  task_id: TaskIdSchema.nullable().optional(),
+  workspace_id: WorkspaceIdSchema,
+  source: z10.object({
+    kind: SessionSourceKindSchema,
+    version: z10.literal("0.1.0"),
+    // Source-tool-native id (e.g. Claude Code session UUID), retained so
+    // re-imports of the same source can be deduplicated.
+    external_id: z10.string().optional(),
+    // Byte size of the source native log at import time. Declared here too
+    // (not only in session.schema.ts) because this inner `source` object is
+    // a plain z.object: zod strips keys it does not declare, so a field
+    // absent here would be dropped from the parsed payload before persist
+    // and the size could never be stored.
+    source_size_bytes: z10.number().int().nonnegative().optional()
+  }),
+  started_at: IsoTimestampSchema,
+  ended_at: IsoTimestampSchema.optional(),
+  status: SessionStatusSchema,
+  working_directory: z10.string().min(1),
+  invocation: z10.object({
+    command: z10.string().min(1),
+    args: z10.array(z10.string()),
+    exit_code: z10.number().int().nullable()
+  }),
+  related_files: z10.array(z10.string()).default([]),
+  events_log: z10.string().optional(),
+  summary: z10.string().nullable().optional(),
+  metrics: SessionMetricsSchema.optional(),
+  // Accepted so a payload assembled from an on-disk chained session.yaml
+  // round-trips, and DISCARDED by the importer (buildSessionRecord never
+  // copies it): the integrity anchor is computed at write time, never
+  // imported. Mirrors the accept-and-discard of `prev_hash` on events.
+  integrity: SessionIntegritySchema.optional()
+}).strict();
+var SessionImportPayloadSchema = z10.object({
+  schema_version: z10.string(),
+  session: SessionInnerImportSchema,
+  events: z10.array(EventSchema)
+}).strict();
+
+// src/schemas/json-schema.ts
+var JSON_SCHEMA_VERSION = "0.1.0";
+var ID_BASE = `https://basou.dev/schemas/${JSON_SCHEMA_VERSION}`;
+var JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+var DOCUMENTS = [
+  {
+    name: "manifest",
+    schema: ManifestSchema,
+    title: "Basou Manifest",
+    description: "The `.basou/manifest.yaml` workspace manifest."
+  },
+  {
+    name: "session",
+    schema: SessionSchema,
+    title: "Basou Session",
+    description: "A `.basou/sessions/<id>/session.yaml` session record."
+  },
+  {
+    name: "event",
+    schema: EventSchema,
+    title: "Basou Event",
+    description: "One line of a `.basou/sessions/<id>/events.jsonl` stream (a discriminated union over the event `type`)."
+  },
+  {
+    name: "task",
+    schema: TaskSchema,
+    title: "Basou Task",
+    description: "The YAML front matter of a `.basou/tasks/<id>.md` task document."
+  },
+  {
+    name: "approval",
+    schema: ApprovalSchema,
+    title: "Basou Approval",
+    description: "A `.basou/approvals/{pending,resolved}/<id>.yaml` approval record."
+  },
+  {
+    name: "status",
+    schema: StatusSchema,
+    title: "Basou Status",
+    description: "The `.basou/status.json` workspace status snapshot."
+  },
+  {
+    name: "task-index",
+    schema: TaskIndexSchema,
+    title: "Basou Task Index",
+    description: "The `.basou/tasks/index.json` task lookup index."
+  },
+  {
+    name: "session-import",
+    schema: SessionImportPayloadSchema,
+    title: "Basou Session Import Payload",
+    description: "The portable session payload consumed by `basou session import`."
   }
-  return [...days.values()].sort((a, b) => a.date.localeCompare(b.date));
+];
+function buildJsonSchemas() {
+  return DOCUMENTS.map((doc) => {
+    const generated = z11.toJSONSchema(doc.schema, { io: "input" });
+    const { $schema, ...rest } = generated;
+    const schema = {
+      $schema: typeof $schema === "string" ? $schema : JSON_SCHEMA_DIALECT,
+      $id: `${ID_BASE}/${doc.name}.schema.json`,
+      title: doc.title,
+      description: doc.description,
+      ...rest
+    };
+    return { name: doc.name, schema };
+  });
 }
-function tzDate(ms, timeZone) {
-  return new Intl.DateTimeFormat("en-CA", {
-    timeZone,
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit"
-  }).format(new Date(ms));
+function serializeJsonSchema(schema) {
+  return `${JSON.stringify(schema, null, 2)}
+`;
 }
 
 // src/storage/basou-dir.ts
 import { lstat as lstat3, mkdir as mkdir4 } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 function basouPaths(repositoryRoot) {
-  const root = join14(repositoryRoot, ".basou");
-  const approvalsBase = join14(root, "approvals");
+  const root = join15(repositoryRoot, ".basou");
+  const approvalsBase = join15(root, "approvals");
   return {
     root,
-    sessions: join14(root, "sessions"),
-    tasks: join14(root, "tasks"),
+    sessions: join15(root, "sessions"),
+    tasks: join15(root, "tasks"),
     approvals: {
-      pending: join14(approvalsBase, "pending"),
-      resolved: join14(approvalsBase, "resolved")
+      pending: join15(approvalsBase, "pending"),
+      resolved: join15(approvalsBase, "resolved")
     },
-    locks: join14(root, "locks"),
-    logs: join14(root, "logs"),
-    raw: join14(root, "raw"),
-    tmp: join14(root, "tmp"),
+    locks: join15(root, "locks"),
+    logs: join15(root, "logs"),
+    raw: join15(root, "raw"),
+    tmp: join15(root, "tmp"),
     files: {
-      manifest: join14(root, "manifest.yaml"),
-      status: join14(root, "status.json"),
-      handoff: join14(root, "handoff.md"),
-      decisions: join14(root, "decisions.md")
+      manifest: join15(root, "manifest.yaml"),
+      status: join15(root, "status.json"),
+      handoff: join15(root, "handoff.md"),
+      decisions: join15(root, "decisions.md")
     }
   };
 }
@@ -4739,11 +5064,11 @@ function hasErrorCode3(error) {
 
 // src/storage/gitignore.ts
 import { readFile as readFile8, writeFile as writeFile2 } from "fs/promises";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 var MARKER = "# Basou - default ignore";
 var BASOU_GITIGNORE_BLOCK = "# Basou - default ignore\n.basou/logs/\n.basou/raw/\n.basou/tmp/\n.basou/locks/\n.basou/status.json\n.basou/sessions/*/events.jsonl\n.basou/sessions/*/artifacts/\n.basou/approvals/pending/\n.basou/approvals/resolved/\n\n# Basou - default commit\n# .basou/manifest.yaml\n# .basou/handoff.md\n# .basou/decisions.md\n# .basou/tasks/\n# .basou/sessions/*/session.yaml\n# .basou/sessions/*/transcript.md\n# .basou/sessions/*/changed-files.json\n";
 async function appendBasouGitignore(repositoryRoot) {
-  const gitignorePath = join15(repositoryRoot, ".gitignore");
+  const gitignorePath = join16(repositoryRoot, ".gitignore");
   let body;
   let existed;
   try {
@@ -4958,7 +5283,7 @@ function hasErrorCode6(error) {
 // src/storage/session-import.ts
 import { mkdir as mkdir5, readFile as readFile10, rm as rm2 } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 async function importSessionFromJson(paths, manifest, payload, options) {
   if (options.taskIdOverride !== void 0 && !TaskIdSchema.safeParse(options.taskIdOverride).success) {
     throw new Error(`Invalid task_id: ${options.taskIdOverride}`);
@@ -4983,7 +5308,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
       pathSanitizeReport
     };
   }
-  const sessionDir = join16(paths.sessions, newSessionId);
+  const sessionDir = join17(paths.sessions, newSessionId);
   try {
     await mkdir5(sessionDir, { recursive: true });
   } catch (error) {
@@ -4997,7 +5322,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
     throw error;
   }
   try {
-    const sessionYamlPath = join16(sessionDir, "session.yaml");
+    const sessionYamlPath = join17(sessionDir, "session.yaml");
     await linkYamlFile(sessionYamlPath, withIntegrity(sessionRecord, chainResult));
   } catch (error) {
     await rm2(sessionDir, { recursive: true, force: true }).catch(() => void 0);
@@ -5165,7 +5490,7 @@ function reuseDerivedIds(priorDerived, freshDerived, sessionId) {
 async function reimportPreservingId(paths, manifest, priorSessionId, freshPayload, options = {}) {
   const sessionId = priorSessionId;
   const importSource = freshPayload.session.source.kind;
-  const sessionDir = join16(paths.sessions, priorSessionId);
+  const sessionDir = join17(paths.sessions, priorSessionId);
   const lock = options.dryRun === true ? null : await acquireLock(paths, "session", priorSessionId);
   try {
     const priorVerdict = await verifyEventsChain(paths, priorSessionId);
@@ -5207,7 +5532,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
     };
     const updatedRecord = { schema_version: "0.1.0", session: preservedInner };
     if (options.dryRun !== true) {
-      const eventsPath = join16(sessionDir, "events.jsonl");
+      const eventsPath = join17(sessionDir, "events.jsonl");
       let priorEventsRaw = null;
       try {
         priorEventsRaw = await readFile10(eventsPath);
@@ -5219,7 +5544,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
       const chainResult = await writeEventsBulk(sessionDir, mergedEvents, { chain: true });
       try {
         await overwriteYamlFile(
-          join16(sessionDir, "session.yaml"),
+          join17(sessionDir, "session.yaml"),
           withIntegrity(updatedRecord, chainResult)
         );
       } catch (error) {
@@ -5243,7 +5568,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
   }
 }
 async function rechainSessionInPlace(paths, sessionId, options = {}) {
-  const sessionDir = join16(paths.sessions, sessionId);
+  const sessionDir = join17(paths.sessions, sessionId);
   let lock;
   try {
     lock = await acquireLock(paths, "session", sessionId);
@@ -5276,7 +5601,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     if (verdict.status !== "unchained") {
       return { status: "skipped", reason: "tampered" };
     }
-    const eventsPath = join16(sessionDir, "events.jsonl");
+    const eventsPath = join17(sessionDir, "events.jsonl");
     let priorRaw;
     try {
       priorRaw = await readFile10(eventsPath);
@@ -5324,7 +5649,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     }
     try {
       await overwriteYamlFile(
-        join16(sessionDir, "session.yaml"),
+        join17(sessionDir, "session.yaml"),
         withIntegrity(record, { headHash: chainResult.headHash, count: chainResult.count })
       );
     } catch (error) {
@@ -5406,6 +5731,7 @@ export {
   enumerateTaskIds,
   finalizeSessionYaml,
   findErrorCode,
+  formatDurationMs,
   genesisHash,
   getDiff,
   getSnapshot,
@@ -5438,6 +5764,7 @@ export {
   reimportPreservingId,
   renderDecisions,
   renderHandoff,
+  renderReport,
   renderWithMarkers,
   replayEvents,
   resolveClaudeCodeCommand,