@basou/core 0.10.0 → 0.12.0

package/dist/index.js

@@ -1720,6 +1720,8 @@ function splitLinesBytes2(buf) {
 }
 
 // src/git/snapshot.ts
+import { readdir as readdir3, stat as stat2 } from "fs/promises";
+import { join as join9 } from "path";
 import { simpleGit } from "simple-git";
 
 // src/storage/status.ts
@@ -1757,19 +1759,19 @@ var DIRECTORY_CHECKS = {
   tmp: (p) => p.tmp
 };
 async function assertBasouRootSafe(rootPath) {
-  let stat3;
+  let stat4;
   try {
-    stat3 = await fsp.lstat(rootPath);
+    stat4 = await fsp.lstat(rootPath);
   } catch (error) {
     if (hasErrorCode2(error) && error.code === "ENOENT") {
       throw new Error("Basou workspace not found", { cause: error });
     }
     throw new Error("Failed to inspect .basou root", { cause: error });
   }
-  if (stat3.isSymbolicLink()) {
+  if (stat4.isSymbolicLink()) {
     throw new Error(".basou root is a symlink; refusing to operate");
   }
-  if (!stat3.isDirectory()) {
+  if (!stat4.isDirectory()) {
     throw new Error(".basou root exists but is not a directory");
   }
 }
@@ -1849,6 +1851,14 @@ function isGitNotFound(error) {
   }
   return false;
 }
+function isNotAGitRepository(error) {
+  let cur = error;
+  for (let i = 0; i < 4 && cur instanceof Error; i++) {
+    if (/not a git repository/i.test(cur.message)) return true;
+    cur = cur.cause;
+  }
+  return false;
+}
 async function resolveRepositoryRoot(cwd) {
   const git = safeSimpleGit(cwd);
   try {
@@ -1864,8 +1874,53 @@ async function resolveRepositoryRoot(cwd) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw error;
     }
-    throw new Error("Not a git repository", { cause: error });
+    if (isNotAGitRepository(error)) {
+      throw new Error("Not a git repository", { cause: error });
+    }
+    throw new Error("Git command failed", { cause: error });
+  }
+}
+async function resolveBasouRepositoryRoot(cwd, opts) {
+  try {
+    return await resolveRepositoryRoot(cwd);
+  } catch (error) {
+    if (!(error instanceof Error) || error.message !== "Not a git repository") throw error;
+    const linked = await findLinkedBasouRepos(cwd);
+    const only = linked[0];
+    if (only !== void 0 && linked.length === 1) {
+      opts?.onRedirect?.({ via: only.name, root: only.root });
+      return only.root;
+    }
+    if (linked.length > 1) {
+      const names = linked.map((l) => l.name).join(", ");
+      throw new Error(
+        `Ambiguous workspace view: ${linked.length} linked repos have a .basou store (${names}). cd into the one you want and re-run.`
+      );
+    }
+    throw error;
+  }
+}
+async function findLinkedBasouRepos(dir) {
+  const entries = await readdir3(dir, { withFileTypes: true }).catch(() => null);
+  if (entries === null) return [];
+  const byRoot = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (!entry.isSymbolicLink()) continue;
+    let root;
+    try {
+      root = await resolveRepositoryRoot(join9(dir, entry.name));
+    } catch {
+      continue;
+    }
+    try {
+      if (!(await stat2(join9(root, ".basou"))).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+    const existing = byRoot.get(root);
+    if (existing === void 0 || entry.name < existing) byRoot.set(root, entry.name);
   }
+  return [...byRoot.entries()].map(([root, name]) => ({ name, root })).sort((a, b) => a.name.localeCompare(b.name));
 }
 async function tryRemoteUrl(repositoryRoot) {
   const git = safeSimpleGit(repositoryRoot);
@@ -2013,12 +2068,12 @@ function parseDiffNameStatus(raw) {
 }
 
 // src/handoff/handoff-renderer.ts
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 
 // src/storage/tasks.ts
 import { createHash as createHash2 } from "crypto";
-import { mkdir as mkdir3, readdir as readdir3, readFile as readFile7, rename as rename2, stat as stat2, unlink as unlink3 } from "fs/promises";
-import { join as join11 } from "path";
+import { mkdir as mkdir3, readdir as readdir4, readFile as readFile7, rename as rename2, stat as stat3, unlink as unlink3 } from "fs/promises";
+import { join as join12 } from "path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 import { z as z8 } from "zod";
 
@@ -2062,7 +2117,7 @@ var TaskSchema = z6.object({
 // src/storage/ad-hoc-session.ts
 import { mkdir as mkdir2, rm } from "fs/promises";
 import { homedir } from "os";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/lib/path-sanitizer.ts
 import { posix as path } from "path";
@@ -2142,8 +2197,8 @@ async function createAdHocSessionWithEvent(input) {
       taskId: input.taskId ?? null
     })
   );
-  const sessionDir = join9(input.paths.sessions, sessionId);
-  const sessionYamlPath = join9(sessionDir, "session.yaml");
+  const sessionDir = join10(input.paths.sessions, sessionId);
+  const sessionYamlPath = join10(sessionDir, "session.yaml");
   const lock = await acquireLock(input.paths, "session", sessionId);
   let bulkResult = null;
   try {
@@ -2293,7 +2348,7 @@ function assertTargetEventIdentity(event, expectedSessionId, expectedEventId) {
 
 // src/storage/task-index.ts
 import { readFile as readFile6 } from "fs/promises";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 
 // src/schemas/task-index.schema.ts
 import { z as z7 } from "zod";
@@ -2312,7 +2367,7 @@ var TASK_INDEX_SCHEMA_VERSION = "0.1.0";
 
 // src/storage/task-index.ts
 function taskIndexPath(paths) {
-  return join10(paths.tasks, "index.json");
+  return join11(paths.tasks, "index.json");
 }
 async function readTaskIndex(paths) {
   const filePath = taskIndexPath(paths);
@@ -2426,7 +2481,7 @@ function splitFrontMatter(raw) {
   return { yamlText, body };
 }
 async function readTaskFile(paths, taskId) {
-  const filePath = join11(paths.tasks, `${taskId}.md`);
+  const filePath = join12(paths.tasks, `${taskId}.md`);
   let raw;
   try {
     raw = await readFile7(filePath, "utf8");
@@ -2459,7 +2514,7 @@ async function readTaskFile(paths, taskId) {
 }
 async function writeTaskFile(paths, taskId, doc, options) {
   const validated = TaskSchema.parse(doc.task);
-  const filePath = join11(paths.tasks, `${taskId}.md`);
+  const filePath = join12(paths.tasks, `${taskId}.md`);
   const yamlText = stringifyYaml(validated);
   const trimmedBody = doc.body.length === 0 ? "" : `
 ${doc.body.endsWith("\n") ? doc.body : `${doc.body}
@@ -2511,7 +2566,7 @@ async function enumerateTaskIds(paths) {
 async function enumerateTaskIdsFromDisk(paths) {
   let entries;
   try {
-    entries = (await readdir3(paths.tasks, { withFileTypes: true })).filter((d) => d.isFile()).map((d) => d.name);
+    entries = (await readdir4(paths.tasks, { withFileTypes: true })).filter((d) => d.isFile()).map((d) => d.name);
   } catch (error) {
     if (findErrorCode(error, "ENOENT")) return [];
     throw new Error("Failed to enumerate tasks", { cause: error });
@@ -2544,12 +2599,12 @@ async function safeUpdateTaskIndex(paths, op) {
 }
 var ARCHIVE_DIR_NAME = "archive";
 function archiveTasksDir(paths) {
-  return join11(paths.tasks, ARCHIVE_DIR_NAME);
+  return join12(paths.tasks, ARCHIVE_DIR_NAME);
 }
 async function enumerateArchivedTaskIds(paths) {
   let entries;
   try {
-    entries = (await readdir3(archiveTasksDir(paths), { withFileTypes: true })).filter((d) => d.isFile()).map((d) => d.name);
+    entries = (await readdir4(archiveTasksDir(paths), { withFileTypes: true })).filter((d) => d.isFile()).map((d) => d.name);
   } catch (error) {
     if (findErrorCode(error, "ENOENT")) return [];
     throw new Error("Failed to enumerate archived tasks", { cause: error });
@@ -2574,7 +2629,7 @@ async function readTaskFileWithArchiveFallback(paths, taskId) {
       throw error;
     }
   }
-  const archiveFilePath = join11(archiveTasksDir(paths), `${taskId}.md`);
+  const archiveFilePath = join12(archiveTasksDir(paths), `${taskId}.md`);
   let raw;
   try {
     raw = await readFile7(archiveFilePath, "utf8");
@@ -2868,7 +2923,7 @@ async function createTaskAttachLocked(input) {
       ...sessionDoc,
       session: { ...sessionDoc.session, task_id: input.taskId }
     };
-    await overwriteYamlFile(join11(input.paths.sessions, input.sessionId, "session.yaml"), updated);
+    await overwriteYamlFile(join12(input.paths.sessions, input.sessionId, "session.yaml"), updated);
   } catch (error) {
     throw new TaskWriteAfterEventError({
       taskId: input.taskId,
@@ -3127,17 +3182,17 @@ function buildUpdatedDoc(input) {
   return { task: next, body: input.currentDoc.body };
 }
 async function computeTaskMdSnapshot(paths, taskId) {
-  const filePath = join11(paths.tasks, `${taskId}.md`);
-  const [stats, raw] = await Promise.all([stat2(filePath), readFile7(filePath)]);
+  const filePath = join12(paths.tasks, `${taskId}.md`);
+  const [stats, raw] = await Promise.all([stat3(filePath), readFile7(filePath)]);
   const hash = createHash2("sha256").update(raw).digest("hex");
   return { mtimeMs: stats.mtimeMs, hash };
 }
 async function readTaskFileWithSnapshot(paths, taskId) {
-  const filePath = join11(paths.tasks, `${taskId}.md`);
+  const filePath = join12(paths.tasks, `${taskId}.md`);
   let rawBuffer;
   let stats;
   try {
-    [rawBuffer, stats] = await Promise.all([readFile7(filePath), stat2(filePath)]);
+    [rawBuffer, stats] = await Promise.all([readFile7(filePath), stat3(filePath)]);
   } catch (error) {
     if (findErrorCode(error, "ENOENT")) {
       throw new Error("Task file not found", { cause: error });
@@ -3625,7 +3680,7 @@ async function deleteTaskLocked(input) {
   });
   const eventId = adHoc.targetEventIds[0];
   try {
-    await unlink3(join11(input.paths.tasks, `${input.taskId}.md`));
+    await unlink3(join12(input.paths.tasks, `${input.taskId}.md`));
   } catch (error) {
     throw new TaskWriteAfterEventError({
       taskId: input.taskId,
@@ -3697,8 +3752,8 @@ async function archiveTaskLocked(input) {
     );
     await mkdir3(archiveTasksDir(input.paths), { recursive: true });
     await rename2(
-      join11(input.paths.tasks, `${input.taskId}.md`),
-      join11(archiveTasksDir(input.paths), `${input.taskId}.md`)
+      join12(input.paths.tasks, `${input.taskId}.md`),
+      join12(archiveTasksDir(input.paths), `${input.taskId}.md`)
     );
   } catch (error) {
     throw new TaskWriteAfterEventError({
@@ -3734,7 +3789,7 @@ async function renderHandoff(input) {
   const tasksCreated = [];
   const tasksStatusChanged = [];
   for (const entry of entries) {
-    const sessionDir = join12(input.paths.sessions, entry.sessionId);
+    const sessionDir = join13(input.paths.sessions, entry.sessionId);
     try {
       for await (const ev of replayEvents(sessionDir, {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
@@ -3850,11 +3905,11 @@ function formatHandoffBody(args) {
   if (args.latestSession !== void 0) {
     const status = args.latestSession.session.session.status;
     const label = args.latestSession.session.session.label;
-    const shortId = shortIdWithPrefix(args.latestSession.sessionId);
+    const shortId2 = shortIdWithPrefix(args.latestSession.sessionId);
     if (label !== void 0 && label !== "") {
-      lines.push(`- \u6700\u7D42 session: ${label} (${status}) [${shortId}]`);
+      lines.push(`- \u6700\u7D42 session: ${label} (${status}) [${shortId2}]`);
     } else {
-      lines.push(`- \u6700\u7D42 session: ${shortId} (${status})`);
+      lines.push(`- \u6700\u7D42 session: ${shortId2} (${status})`);
     }
   } else {
     lines.push("- \u6700\u7D42 session: (no live sessions)");
@@ -4025,6 +4080,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,132 +4146,11 @@ 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;
-    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
-        });
-      });
-    });
-  }
-};
-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');
-  }
-}
-function classifySpawnError(error) {
-  if (findErrorCode(error, "ENOENT")) {
-    return new Error("Command not found", { cause: error });
-  }
-  return new Error("Failed to spawn child process", { cause: error });
-}
+// src/orientation/orientation-renderer.ts
+import { join as join14 } from "path";
 
-// src/schemas/json-schema.ts
-import { z as z11 } from "zod";
+// src/storage/manifest.ts
+import { lstat as lstat3 } from "fs/promises";
 
 // src/schemas/manifest.schema.ts
 import { z as z9 } from "zod";
@@ -4256,126 +4201,400 @@ var ManifestSchema = z9.object({
   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`."
+// src/storage/manifest.ts
+function createManifest(input) {
+  if (input.workspaceName.length === 0) {
+    throw new Error("Workspace name is empty. Pass --name explicitly.");
   }
-];
-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 };
+  const now = (input.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const workspaceId = input.workspaceId ?? prefixedUlid("ws");
+  const project = {
+    ...input.projectName !== void 0 ? { name: input.projectName } : {},
+    ...input.projectDescription !== void 0 ? { description: input.projectDescription } : {},
+    ...input.repositoryUrl !== void 0 ? { repository_url: input.repositoryUrl } : {}
+  };
+  const manifest = {
+    schema_version: "0.1.0",
+    basou_version: "0.1.0",
+    workspace: {
+      id: workspaceId,
+      name: input.workspaceName,
+      created_at: now,
+      updated_at: now
+    },
+    project,
+    capabilities: {
+      enabled: ["core", "claude-code-adapter", "terminal-recording", "git-capability", "approval"]
+    },
+    approval: {
+      required_for: ["destructive_command", "external_send"],
+      default_risk_level: "medium"
+    },
+    adapters: {
+      "claude-code": { enabled: true }
+    },
+    git: { events_log: "ignore" },
+    ...input.sourceRoots !== void 0 && input.sourceRoots.length > 0 ? { import: { source_roots: input.sourceRoots } } : {}
+  };
+  return ManifestSchema.parse(manifest);
+}
+async function writeManifest(paths, manifest, options) {
+  const force = options?.force === true;
+  const validated = ManifestSchema.parse(manifest);
+  if (!force) {
+    let existed = false;
+    try {
+      await lstat3(paths.files.manifest);
+      existed = true;
+    } catch (error) {
+      if (!hasErrorCode3(error) || error.code !== "ENOENT") {
+        throw new Error("Failed to inspect existing manifest", { cause: error });
+      }
+    }
+    if (existed) {
+      throw new Error("Already initialized. Use --force to overwrite.");
+    }
+  }
+  await writeYamlFile(paths.files.manifest, validated);
+}
+async function readManifest(paths) {
+  const raw = await readYamlFile(paths.files.manifest);
+  return ManifestSchema.parse(raw);
+}
+function hasErrorCode3(error) {
+  if (!(error instanceof Error)) return false;
+  return typeof error.code === "string";
+}
+
+// src/orientation/orientation-renderer.ts
+async function summarizeOrientation(input) {
+  const limit = input.relatedFilesLimit ?? 10;
+  const now = new Date(input.nowIso);
+  const loadOpts = { now };
+  if (input.onSessionSkip !== void 0) loadOpts.onSkip = input.onSessionSkip;
+  if (input.onWarning !== void 0) loadOpts.onWarning = input.onWarning;
+  const entries = await loadSessionEntries(input.paths, loadOpts);
+  const decisions = [];
+  for (const entry of entries) {
+    const sessionDir = join14(input.paths.sessions, entry.sessionId);
+    try {
+      for await (const ev of replayEvents(sessionDir, {
+        onWarning: (w) => input.onWarning?.(w, entry.sessionId)
+      })) {
+        if (ev.type === "decision_recorded") {
+          decisions.push({
+            decisionId: ev.decision_id,
+            title: ev.title,
+            occurredAt: ev.occurred_at
+          });
+        }
+      }
+    } catch {
+      input.onSessionSkip?.(entry.sessionId, "events_jsonl_unreadable");
+    }
+  }
+  decisions.sort((a, b) => {
+    const c = Date.parse(a.occurredAt) - Date.parse(b.occurredAt);
+    return c !== 0 ? c : a.decisionId.localeCompare(b.decisionId);
   });
+  const latestDecision = decisions[decisions.length - 1];
+  const taskLoadOpts = {};
+  if (input.onTaskSkip !== void 0) taskLoadOpts.onSkip = input.onTaskSkip;
+  const taskEntries = await loadTaskEntries(input.paths, taskLoadOpts);
+  const inFlightTasks = taskEntries.filter((t) => t.task.task.status === "in_progress" || t.task.task.status === "planned").map((t) => ({
+    id: t.task.task.id,
+    title: t.task.task.title,
+    status: t.task.task.status,
+    linkedSessions: t.task.task.linked_sessions?.length ?? 0
+  }));
+  const plannedTasks = taskEntries.filter((t) => t.task.task.status === "planned").map((t) => ({ id: t.task.task.id, title: t.task.task.title }));
+  const { pending: pendingIds } = await enumerateApprovals(input.paths);
+  const pendingApprovals = [];
+  for (const id of [...pendingIds].sort()) {
+    const loaded = await loadApproval(input.paths, id);
+    if (loaded === null) continue;
+    const a = loaded.approval;
+    pendingApprovals.push({
+      id,
+      risk: a.risk_level,
+      kind: a.action.kind,
+      reason: a.reason,
+      sessionId: a.session_id,
+      createdAt: a.created_at,
+      expired: isLazyExpired(a, now)
+    });
+  }
+  const suspects = entries.filter((e) => e.suspect).map((e) => ({
+    sessionId: e.sessionId,
+    status: e.session.session.status,
+    reason: e.suspectReason
+  }));
+  const liveEntries = entries.filter(
+    (e) => e.session.session.status !== "archived" && e.session.session.source.kind !== "import"
+  );
+  const latestEntry = [...liveEntries].sort(
+    (a, b) => Date.parse(b.session.session.started_at) - Date.parse(a.session.session.started_at)
+  )[0];
+  const latestSession = latestEntry !== void 0 ? {
+    sessionId: latestEntry.sessionId,
+    label: latestEntry.session.session.label ?? null,
+    status: latestEntry.session.session.status
+  } : null;
+  const activityEntries = entries.filter((e) => e.session.session.status !== "archived");
+  const newest = [...activityEntries].sort(
+    (a, b) => Date.parse(b.session.session.started_at) - Date.parse(a.session.session.started_at)
+  )[0];
+  const bySourceMap = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const k = e.session.session.source.kind;
+    bySourceMap.set(k, (bySourceMap.get(k) ?? 0) + 1);
+  }
+  const bySource = [...bySourceMap.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([kind, count]) => ({ kind, count }));
+  let sourceRoots = null;
+  try {
+    const manifest = await readManifest(input.paths);
+    sourceRoots = manifest.import?.source_roots ?? null;
+  } catch {
+    sourceRoots = null;
+  }
+  const latestFiles = latestEntry?.session.session.related_files ?? [];
+  const uniqueFiles = new Set(latestFiles);
+  const displayed = [...uniqueFiles].sort().slice(0, limit);
+  const overflow = Math.max(0, uniqueFiles.size - limit);
+  return {
+    generatedAt: input.nowIso,
+    sessionCount: entries.length,
+    latestSession,
+    latestDecision: latestDecision ?? null,
+    decisionCount: decisions.length,
+    relatedFiles: { displayed, overflow },
+    inFlightTasks,
+    plannedTasks,
+    pendingApprovals,
+    suspects,
+    freshness: {
+      newestStartedAt: newest?.session.session.started_at ?? null,
+      newestSource: newest?.session.session.source.kind ?? null,
+      bySource,
+      sourceRoots
+    }
+  };
 }
-function serializeJsonSchema(schema) {
-  return `${JSON.stringify(schema, null, 2)}
-`;
+async function renderOrientation(input) {
+  const summary = await summarizeOrientation(input);
+  return {
+    body: formatOrientationBody(summary, {
+      staleness: input.staleness ?? null,
+      verbose: input.verbose === true
+    }),
+    sessionCount: summary.sessionCount,
+    pendingApprovalsCount: summary.pendingApprovals.length,
+    suspectCount: summary.suspects.length,
+    inFlightTaskCount: summary.inFlightTasks.length,
+    decisionCount: summary.decisionCount
+  };
+}
+function formatOrientationBody(summary, opts) {
+  const lines = [];
+  const now = new Date(summary.generatedAt);
+  const newestRel = relativeAge(summary.freshness.newestStartedAt ?? void 0, now);
+  lines.push("# Orientation");
+  lines.push("");
+  lines.push(
+    `> Generated at ${summary.generatedAt} \xB7 sessions ${summary.sessionCount} \xB7 newest ${newestRel} \xB7 pending ${summary.pendingApprovals.length} \xB7 suspect ${summary.suspects.length}`
+  );
+  lines.push("");
+  lines.push("## \u4ECA\u3069\u3053\u306B\u3044\u308B");
+  lines.push("");
+  if (summary.latestSession !== null) {
+    const s = summary.latestSession;
+    const sid = shortId(s.sessionId);
+    if (s.label !== null && s.label !== "") {
+      lines.push(`- \u6700\u7D42 session: ${s.label} (${s.status}) [${sid}]`);
+    } else {
+      lines.push(`- \u6700\u7D42 session: ${sid} (${s.status})`);
+    }
+  } else {
+    lines.push("- \u6700\u7D42 session: (no live sessions)");
+  }
+  if (summary.latestDecision !== null) {
+    lines.push(
+      `- \u76F4\u8FD1\u306E\u5224\u65AD: ${summary.latestDecision.title} [${shortId(summary.latestDecision.decisionId)}]`
+    );
+    if (summary.decisionCount > 1) {
+      lines.push(`  - ${summary.decisionCount} decisions total \u2014 see decisions.md`);
+    }
+  } else {
+    lines.push("- \u76F4\u8FD1\u306E\u5224\u65AD: (no decisions recorded yet)");
+  }
+  if (summary.relatedFiles.displayed.length > 0) {
+    const shown = summary.relatedFiles.displayed.join(", ");
+    const more = summary.relatedFiles.overflow > 0 ? ` (... +${summary.relatedFiles.overflow} more)` : "";
+    lines.push(`- \u76F4\u8FD1\u306E\u5909\u66F4\u30D5\u30A1\u30A4\u30EB: ${shown}${more}`);
+  } else {
+    lines.push("- \u76F4\u8FD1\u306E\u5909\u66F4\u30D5\u30A1\u30A4\u30EB: (none recorded)");
+  }
+  lines.push("");
+  lines.push("## \u4F55\u304C\u52D5\u304F");
+  lines.push("");
+  lines.push(`### \u9032\u884C\u4E2D task (${summary.inFlightTasks.length})`);
+  if (summary.inFlightTasks.length === 0) {
+    lines.push("- (none)");
+  } else {
+    for (const t of summary.inFlightTasks) {
+      const linkedSuffix = t.linkedSessions > 1 ? ` \u2014 linked_sessions: ${t.linkedSessions}` : "";
+      lines.push(`- ${t.title} (${t.status}) [${shortId(t.id)}]${linkedSuffix}`);
+    }
+  }
+  lines.push("");
+  lines.push(`### \u627F\u8A8D\u5F85\u3061 (${summary.pendingApprovals.length})`);
+  if (summary.pendingApprovals.length === 0) {
+    lines.push("- (none)");
+  } else {
+    for (const a of summary.pendingApprovals) {
+      const expired = a.expired ? " (expired)" : "";
+      lines.push(
+        `- [${a.risk}] ${a.kind}: ${a.reason} \u2014 session ${shortId(a.sessionId)}, since ${a.createdAt}${expired}`
+      );
+    }
+  }
+  lines.push("");
+  lines.push(`### \u8981\u6CE8\u610F session (${summary.suspects.length})`);
+  if (summary.suspects.length === 0) {
+    lines.push("- (none)");
+  } else {
+    for (const e of summary.suspects) {
+      lines.push(`- ${shortId(e.sessionId)} (${e.status}) \u2014 ${suspectText(e.reason)}`);
+    }
+  }
+  lines.push("");
+  lines.push("## \u3069\u3053\u3078\u5411\u304B\u3046");
+  lines.push("");
+  if (summary.plannedTasks.length === 0) {
+    lines.push("- (no planned tasks \u2014 direction is inferred from recent decisions)");
+    if (summary.latestDecision !== null) {
+      lines.push(`  - \u76F4\u8FD1\u306E\u5224\u65AD: ${summary.latestDecision.title}`);
+    }
+  } else {
+    for (const t of summary.plannedTasks) {
+      lines.push(`- ${t.title} [${shortId(t.id)}]`);
+    }
+  }
+  lines.push("");
+  lines.push("## \u3053\u308C\u306F\u6700\u65B0\u304B");
+  lines.push("");
+  for (const line of freshnessVerdict(summary, opts.staleness, now)) lines.push(line);
+  if (opts.verbose) {
+    lines.push("");
+    lines.push("<!-- verbose: raw freshness telemetry -->");
+    if (summary.freshness.newestStartedAt !== null) {
+      lines.push(`- newest captured session: ${summary.freshness.newestStartedAt} (${newestRel})`);
+    } else {
+      lines.push("- newest captured session: (no sessions captured yet)");
+    }
+    const sourceBreakdown = summary.freshness.bySource.map(({ kind, count }) => `${kind} ${count}`).join(", ");
+    lines.push(
+      `- sessions: ${summary.sessionCount}${sourceBreakdown !== "" ? ` (${sourceBreakdown})` : ""}`
+    );
+    if (summary.freshness.sourceRoots !== null && summary.freshness.sourceRoots.length > 0) {
+      lines.push(`- source roots: ${summary.freshness.sourceRoots.join(", ")}`);
+    } else {
+      lines.push("- source roots: (single root)");
+    }
+    lines.push(`- suspect sessions: ${summary.suspects.length}`);
+    const probe = opts.staleness === null ? "not run" : `new ${opts.staleness.newSessions}, updated ${opts.staleness.updatedSessions}, unverifiable ${opts.staleness.unverifiableSessions ?? 0}`;
+    lines.push(`- staleness probe: ${probe}`);
+  }
+  return lines.join("\n");
+}
+function toolDisplayName(kind) {
+  switch (kind) {
+    case "claude-code-import":
+    case "claude-code-adapter":
+      return "Claude Code";
+    case "codex-import":
+      return "Codex";
+    case "terminal":
+      return "\u30BF\u30FC\u30DF\u30CA\u30EB";
+    case "human":
+      return "\u624B\u52D5\u30E1\u30E2";
+    case "import":
+      return "\u4ED6\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9";
+    default:
+      return kind ?? "\u4E0D\u660E";
+  }
+}
+function freshnessVerdict(summary, staleness, now) {
+  if (staleness !== null && (staleness.unverifiableSessions ?? 0) > 0) {
+    return [
+      `\u26A0\uFE0F \u6700\u65B0\u304B\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\u3002\u5909\u5316\u3057\u305F\u304C\u5B89\u5168\u306B\u53D6\u308A\u8FBC\u3081\u306A\u3044\u30BB\u30C3\u30B7\u30E7\u30F3\u304C ${staleness.unverifiableSessions} \u4EF6\u3042\u308A\u307E\u3059(\u30CF\u30C3\u30B7\u30E5\u30C1\u30A7\u30FC\u30F3\u7834\u640D\u30FB\u975E\u8FFD\u8A18\u5909\u66F4\u306A\u3069)\u3002`,
+      "`basou verify` \u3067\u78BA\u8A8D\u3057\u3001`basou refresh --force` \u3067\u518D\u53D6\u308A\u8FBC\u307F\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+    ];
+  }
+  if (staleness !== null && (staleness.newSessions > 0 || staleness.updatedSessions > 0)) {
+    const parts = [];
+    if (staleness.newSessions > 0) parts.push(`\u65B0\u898F ${staleness.newSessions} \u4EF6`);
+    if (staleness.updatedSessions > 0) parts.push(`\u66F4\u65B0 ${staleness.updatedSessions} \u4EF6`);
+    return [
+      `\u26A0\uFE0F \u53E4\u3044\u304B\u3082\u3057\u308C\u307E\u305B\u3093\u3002\u6700\u5F8C\u306E\u53D6\u308A\u8FBC\u307F\u4EE5\u964D\u306B\u672A\u53D6\u308A\u8FBC\u307F\u306E\u4F5C\u696D\u304C\u3042\u308A\u307E\u3059(${parts.join("\u30FB")})\u3002`,
+      "`basou refresh` \u3067\u66F4\u65B0\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+    ];
+  }
+  if (summary.freshness.newestStartedAt === null) {
+    return [
+      "\u2139\uFE0F \u307E\u3060\u8A18\u9332\u304C\u3042\u308A\u307E\u305B\u3093\u3002",
+      "\u3053\u306E\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u3067\u4F5C\u696D\u3059\u308B\u3068\u3001\u3053\u3053\u306B\u73FE\u5728\u5730\u304C\u8868\u793A\u3055\u308C\u307E\u3059\u3002"
+    ];
+  }
+  const rel = relativeAgeJa(summary.freshness.newestStartedAt, now);
+  const tool = toolDisplayName(summary.freshness.newestSource);
+  const suspectCount = summary.suspects.length;
+  const suspectClause = suspectCount > 0 ? `\u8981\u6CE8\u610F\u30BB\u30C3\u30B7\u30E7\u30F3\u304C ${suspectCount} \u4EF6\u3042\u308A\u307E\u3059\u3002` : "\u53D6\u308A\u3053\u307C\u3057\u30FB\u8981\u6CE8\u610F\u306A\u3057\u3002";
+  if (staleness === null) {
+    return [
+      `\u2139\uFE0F \u53D6\u308A\u8FBC\u307F\u6E08\u307F\u306E\u72B6\u614B\u3092\u8868\u793A\u3057\u3066\u3044\u307E\u3059\u3002\u6700\u5F8C\u306E\u4F5C\u696D\u306F ${rel}(${tool})\u3002`,
+      "\u6700\u65B0\u304B\u78BA\u8A8D\u3059\u308B\u306B\u306F `basou refresh` \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+    ];
+  }
+  return [`\u2705 \u6700\u65B0\u3067\u3059\u3002\u6700\u5F8C\u306E\u4F5C\u696D\u306F ${rel}(${tool})\u3002${suspectClause}`];
+}
+function relativeAgeJa(startedAt, now) {
+  if (startedAt === null) return "(\u4E0D\u660E)";
+  const ms = now.getTime() - Date.parse(startedAt);
+  if (!Number.isFinite(ms) || ms < 0) return "\u305F\u3063\u305F\u4ECA";
+  if (ms < 6e4) return "\u305F\u3063\u305F\u4ECA";
+  const totalMin = Math.floor(ms / 6e4);
+  const days = Math.floor(totalMin / 1440);
+  const hours = Math.floor(totalMin % 1440 / 60);
+  const mins = totalMin % 60;
+  if (days > 0) return hours > 0 ? `${days}\u65E5${hours}\u6642\u9593\u524D` : `${days}\u65E5\u524D`;
+  if (hours > 0) return mins > 0 ? `${hours}\u6642\u9593${mins}\u5206\u524D` : `${hours}\u6642\u9593\u524D`;
+  return `${mins}\u5206\u524D`;
+}
+function relativeAge(startedAt, now) {
+  if (startedAt === void 0) return "(unknown)";
+  const ms = now.getTime() - Date.parse(startedAt);
+  if (!Number.isFinite(ms)) return "(unknown)";
+  if (ms < 0) return "just now";
+  if (ms < 1e3) return "just now";
+  return `${formatDurationMs(ms)} ago`;
+}
+function suspectText(reason) {
+  if (reason === "events_say_ended_but_yaml_running") return "ended (yaml stale)";
+  if (reason === "running_no_end_event") return "no end event";
+  return "suspect";
+}
+function shortId(id) {
+  const sep = id.indexOf("_");
+  if (sep === -1) return id.slice(0, 10);
+  return id.slice(0, sep + 1) + id.slice(sep + 1, sep + 1 + 10);
 }
 
+// src/report/report-renderer.ts
+import { join as join16 } from "path";
+
 // src/stats/work-stats.ts
-import { join as join13 } from "path";
+import { join as join15 } from "path";
 function resolveTimeZone(timeZone) {
   if (timeZone !== void 0 && timeZone.length > 0) return timeZone;
   return Intl.DateTimeFormat().resolvedOptions().timeZone;
@@ -4406,7 +4625,7 @@ async function computeWorkStats(input) {
     const events = [];
     let eventsUnreadable = false;
     try {
-      for await (const ev of replayEvents(join13(input.paths.sessions, entry.sessionId), {
+      for await (const ev of replayEvents(join15(input.paths.sessions, entry.sessionId), {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
       })) {
         events.push(ev);
@@ -4660,61 +4879,618 @@ function tzDate(ms, timeZone) {
   }).format(new Date(ms));
 }
 
-// src/storage/basou-dir.ts
-import { lstat as lstat3, mkdir as mkdir4 } from "fs/promises";
-import { join as join14 } from "path";
-function basouPaths(repositoryRoot) {
-  const root = join14(repositoryRoot, ".basou");
-  const approvalsBase = join14(root, "approvals");
-  return {
-    root,
-    sessions: join14(root, "sessions"),
-    tasks: join14(root, "tasks"),
-    approvals: {
-      pending: join14(approvalsBase, "pending"),
-      resolved: join14(approvalsBase, "resolved")
-    },
-    locks: join14(root, "locks"),
-    logs: join14(root, "logs"),
-    raw: join14(root, "raw"),
-    tmp: join14(root, "tmp"),
-    files: {
-      manifest: join14(root, "manifest.yaml"),
-      status: join14(root, "status.json"),
-      handoff: join14(root, "handoff.md"),
-      decisions: join14(root, "decisions.md")
-    }
+// 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",
+  "waiting_approval",
+  "interrupted",
+  "initialized",
+  "imported",
+  "archived"
+];
+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);
+    input.onSessionSkip?.(sid, reason);
   };
-}
-var PATH_LABELS = {
-  sessions: ".basou/sessions",
-  tasks: ".basou/tasks",
-  approvalsPending: ".basou/approvals/pending",
-  approvalsResolved: ".basou/approvals/resolved",
-  locks: ".basou/locks",
-  logs: ".basou/logs",
-  raw: ".basou/raw",
-  tmp: ".basou/tmp"
-};
-async function ensureBasouDirectory(repositoryRoot) {
-  const paths = basouPaths(repositoryRoot);
-  let existing;
-  try {
-    existing = await lstat3(paths.root);
-  } catch (error) {
-    if (!hasErrorCode3(error) || error.code !== "ENOENT") {
-      throw new Error("Failed to inspect .basou directory", { cause: error });
+  const loadOpts = { now, onSkip: wrappedSkip };
+  if (input.onWarning !== void 0) loadOpts.onWarning = input.onWarning;
+  const entries = await loadSessionEntries(input.paths, loadOpts);
+  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 sessionDir = join16(input.paths.sessions, entry.sessionId);
+    try {
+      for await (const ev of replayEvents(sessionDir, {
+        onWarning: (w) => input.onWarning?.(w, entry.sessionId)
+      })) {
+        if (ev.type === "decision_recorded") {
+          decisions.push({ id: ev.decision_id, title: ev.title, occurredAt: ev.occurred_at });
+        }
+      }
+    } catch {
+      if (!unreadableEmitted.has(entry.sessionId)) {
+        wrappedSkip(entry.sessionId, "events_jsonl_unreadable");
+      }
     }
   }
-  if (existing !== void 0 && !existing.isDirectory()) {
-    throw new Error("Basou root .basou exists but is not a directory");
-  }
-  await Promise.all([
-    mkdirLabeled(paths.sessions, PATH_LABELS.sessions),
-    mkdirLabeled(paths.tasks, PATH_LABELS.tasks),
-    mkdirLabeled(paths.approvals.pending, PATH_LABELS.approvalsPending),
-    mkdirLabeled(paths.approvals.resolved, PATH_LABELS.approvalsResolved),
-    mkdirLabeled(paths.locks, PATH_LABELS.locks),
+  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: []
+  };
+  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;
+    }
+    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
+    },
+    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 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)`);
+  }
+  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 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 formatInt(n) {
+  return n.toLocaleString("en-US");
+}
+
+// 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;
+    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
+        });
+      });
+    });
+  }
+};
+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');
+  }
+}
+function classifySpawnError(error) {
+  if (findErrorCode(error, "ENOENT")) {
+    return new Error("Command not found", { cause: error });
+  }
+  return new Error("Failed to spawn child process", { cause: error });
+}
+
+// src/schemas/json-schema.ts
+import { z as z11 } from "zod";
+
+// 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 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 serializeJsonSchema(schema) {
+  return `${JSON.stringify(schema, null, 2)}
+`;
+}
+
+// src/storage/basou-dir.ts
+import { lstat as lstat4, mkdir as mkdir4 } from "fs/promises";
+import { join as join17 } from "path";
+function basouPaths(repositoryRoot) {
+  const root = join17(repositoryRoot, ".basou");
+  const approvalsBase = join17(root, "approvals");
+  return {
+    root,
+    sessions: join17(root, "sessions"),
+    tasks: join17(root, "tasks"),
+    approvals: {
+      pending: join17(approvalsBase, "pending"),
+      resolved: join17(approvalsBase, "resolved")
+    },
+    locks: join17(root, "locks"),
+    logs: join17(root, "logs"),
+    raw: join17(root, "raw"),
+    tmp: join17(root, "tmp"),
+    files: {
+      manifest: join17(root, "manifest.yaml"),
+      status: join17(root, "status.json"),
+      handoff: join17(root, "handoff.md"),
+      decisions: join17(root, "decisions.md"),
+      orientation: join17(root, "orientation.md")
+    }
+  };
+}
+var PATH_LABELS = {
+  sessions: ".basou/sessions",
+  tasks: ".basou/tasks",
+  approvalsPending: ".basou/approvals/pending",
+  approvalsResolved: ".basou/approvals/resolved",
+  locks: ".basou/locks",
+  logs: ".basou/logs",
+  raw: ".basou/raw",
+  tmp: ".basou/tmp"
+};
+async function ensureBasouDirectory(repositoryRoot) {
+  const paths = basouPaths(repositoryRoot);
+  let existing;
+  try {
+    existing = await lstat4(paths.root);
+  } catch (error) {
+    if (!hasErrorCode4(error) || error.code !== "ENOENT") {
+      throw new Error("Failed to inspect .basou directory", { cause: error });
+    }
+  }
+  if (existing !== void 0 && !existing.isDirectory()) {
+    throw new Error("Basou root .basou exists but is not a directory");
+  }
+  await Promise.all([
+    mkdirLabeled(paths.sessions, PATH_LABELS.sessions),
+    mkdirLabeled(paths.tasks, PATH_LABELS.tasks),
+    mkdirLabeled(paths.approvals.pending, PATH_LABELS.approvalsPending),
+    mkdirLabeled(paths.approvals.resolved, PATH_LABELS.approvalsResolved),
+    mkdirLabeled(paths.locks, PATH_LABELS.locks),
     mkdirLabeled(paths.logs, PATH_LABELS.logs),
     mkdirLabeled(paths.raw, PATH_LABELS.raw),
     mkdirLabeled(paths.tmp, PATH_LABELS.tmp)
@@ -4725,13 +5501,13 @@ async function mkdirLabeled(target, label) {
   try {
     await mkdir4(target, { recursive: true });
   } catch (error) {
-    if (hasErrorCode3(error) && (error.code === "ENOTDIR" || error.code === "EEXIST")) {
+    if (hasErrorCode4(error) && (error.code === "ENOTDIR" || error.code === "EEXIST")) {
       throw new Error(`${label} exists but is not a directory`, { cause: error });
     }
     throw new Error(`Failed to create ${label}`, { cause: error });
   }
 }
-function hasErrorCode3(error) {
+function hasErrorCode4(error) {
   if (!(error instanceof Error)) return false;
   const codeProp = error.code;
   return typeof codeProp === "string";
@@ -4739,28 +5515,30 @@ 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 join18 } 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");
+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/orientation.md\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";
+var BASOU_GITIGNORE_BLOCK_LOCAL_ONLY = "# Basou - default ignore\n# Local-only: basou's trail is never committed (personal/local state,\n# regenerable by re-importing from the agents' own logs). Recommended for\n# monitored repos and any workspace kept out of version control.\n.basou/\n";
+async function appendBasouGitignore(repositoryRoot, options = {}) {
+  const gitignorePath = join18(repositoryRoot, ".gitignore");
   let body;
   let existed;
   try {
     body = await readFile8(gitignorePath, "utf8");
     existed = true;
   } catch (error) {
-    if (hasErrorCode4(error) && error.code === "ENOENT") {
+    if (hasErrorCode5(error) && error.code === "ENOENT") {
       body = "";
       existed = false;
     } else {
       throw new Error("Failed to read .gitignore", { cause: error });
     }
   }
-  if (existed && hasBasouMarker(body)) {
+  if (existed && hasBasouGitignore(body)) {
     return { appended: false };
   }
-  const next = composeNextBody(body);
+  const block = options.localOnly === true ? BASOU_GITIGNORE_BLOCK_LOCAL_ONLY : BASOU_GITIGNORE_BLOCK;
+  const next = composeNextBody(body, block);
   try {
     await writeFile2(gitignorePath, next, { encoding: "utf8" });
   } catch (error) {
@@ -4768,84 +5546,20 @@ async function appendBasouGitignore(repositoryRoot) {
   }
   return { appended: true };
 }
-function hasBasouMarker(body) {
+function hasBasouGitignore(body) {
   for (const rawLine of body.split("\n")) {
-    if (rawLine.trimEnd().startsWith(MARKER)) return true;
+    const line = rawLine.trimEnd();
+    if (line.startsWith(MARKER)) return true;
+    if (line === ".basou/" || line === "/.basou/") return true;
   }
   return false;
 }
-function composeNextBody(existing) {
-  if (existing.length === 0) return BASOU_GITIGNORE_BLOCK;
+function composeNextBody(existing, block) {
+  if (existing.length === 0) return block;
   const normalized = existing.endsWith("\n") ? existing : `${existing}
 `;
   return `${normalized}
-${BASOU_GITIGNORE_BLOCK}`;
-}
-function hasErrorCode4(error) {
-  if (!(error instanceof Error)) return false;
-  return typeof error.code === "string";
-}
-
-// src/storage/manifest.ts
-import { lstat as lstat4 } from "fs/promises";
-function createManifest(input) {
-  if (input.workspaceName.length === 0) {
-    throw new Error("Workspace name is empty. Pass --name explicitly.");
-  }
-  const now = (input.now ?? /* @__PURE__ */ new Date()).toISOString();
-  const workspaceId = input.workspaceId ?? prefixedUlid("ws");
-  const project = {
-    ...input.projectName !== void 0 ? { name: input.projectName } : {},
-    ...input.projectDescription !== void 0 ? { description: input.projectDescription } : {},
-    ...input.repositoryUrl !== void 0 ? { repository_url: input.repositoryUrl } : {}
-  };
-  const manifest = {
-    schema_version: "0.1.0",
-    basou_version: "0.1.0",
-    workspace: {
-      id: workspaceId,
-      name: input.workspaceName,
-      created_at: now,
-      updated_at: now
-    },
-    project,
-    capabilities: {
-      enabled: ["core", "claude-code-adapter", "terminal-recording", "git-capability", "approval"]
-    },
-    approval: {
-      required_for: ["destructive_command", "external_send"],
-      default_risk_level: "medium"
-    },
-    adapters: {
-      "claude-code": { enabled: true }
-    },
-    git: { events_log: "ignore" },
-    ...input.sourceRoots !== void 0 && input.sourceRoots.length > 0 ? { import: { source_roots: input.sourceRoots } } : {}
-  };
-  return ManifestSchema.parse(manifest);
-}
-async function writeManifest(paths, manifest, options) {
-  const force = options?.force === true;
-  const validated = ManifestSchema.parse(manifest);
-  if (!force) {
-    let existed = false;
-    try {
-      await lstat4(paths.files.manifest);
-      existed = true;
-    } catch (error) {
-      if (!hasErrorCode5(error) || error.code !== "ENOENT") {
-        throw new Error("Failed to inspect existing manifest", { cause: error });
-      }
-    }
-    if (existed) {
-      throw new Error("Already initialized. Use --force to overwrite.");
-    }
-  }
-  await writeYamlFile(paths.files.manifest, validated);
-}
-async function readManifest(paths) {
-  const raw = await readYamlFile(paths.files.manifest);
-  return ManifestSchema.parse(raw);
+${block}`;
 }
 function hasErrorCode5(error) {
   if (!(error instanceof Error)) return false;
@@ -4958,7 +5672,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 join19 } 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 +5697,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
       pathSanitizeReport
     };
   }
-  const sessionDir = join16(paths.sessions, newSessionId);
+  const sessionDir = join19(paths.sessions, newSessionId);
   try {
     await mkdir5(sessionDir, { recursive: true });
   } catch (error) {
@@ -4997,7 +5711,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
     throw error;
   }
   try {
-    const sessionYamlPath = join16(sessionDir, "session.yaml");
+    const sessionYamlPath = join19(sessionDir, "session.yaml");
     await linkYamlFile(sessionYamlPath, withIntegrity(sessionRecord, chainResult));
   } catch (error) {
     await rm2(sessionDir, { recursive: true, force: true }).catch(() => void 0);
@@ -5165,7 +5879,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 = join19(paths.sessions, priorSessionId);
   const lock = options.dryRun === true ? null : await acquireLock(paths, "session", priorSessionId);
   try {
     const priorVerdict = await verifyEventsChain(paths, priorSessionId);
@@ -5207,7 +5921,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 = join19(sessionDir, "events.jsonl");
       let priorEventsRaw = null;
       try {
         priorEventsRaw = await readFile10(eventsPath);
@@ -5219,7 +5933,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
       const chainResult = await writeEventsBulk(sessionDir, mergedEvents, { chain: true });
       try {
         await overwriteYamlFile(
-          join16(sessionDir, "session.yaml"),
+          join19(sessionDir, "session.yaml"),
           withIntegrity(updatedRecord, chainResult)
         );
       } catch (error) {
@@ -5243,7 +5957,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
   }
 }
 async function rechainSessionInPlace(paths, sessionId, options = {}) {
-  const sessionDir = join16(paths.sessions, sessionId);
+  const sessionDir = join19(paths.sessions, sessionId);
   let lock;
   try {
     lock = await acquireLock(paths, "session", sessionId);
@@ -5276,7 +5990,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     if (verdict.status !== "unchained") {
       return { status: "skipped", reason: "tampered" };
     }
-    const eventsPath = join16(sessionDir, "events.jsonl");
+    const eventsPath = join19(sessionDir, "events.jsonl");
     let priorRaw;
     try {
       priorRaw = await readFile10(eventsPath);
@@ -5324,7 +6038,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     }
     try {
       await overwriteYamlFile(
-        join16(sessionDir, "session.yaml"),
+        join19(sessionDir, "session.yaml"),
         withIntegrity(record, { headHash: chainResult.headHash, count: chainResult.count })
       );
     } catch (error) {
@@ -5406,6 +6120,7 @@ export {
   enumerateTaskIds,
   finalizeSessionYaml,
   findErrorCode,
+  formatDurationMs,
   genesisHash,
   getDiff,
   getSnapshot,
@@ -5438,8 +6153,11 @@ export {
   reimportPreservingId,
   renderDecisions,
   renderHandoff,
+  renderOrientation,
+  renderReport,
   renderWithMarkers,
   replayEvents,
+  resolveBasouRepositoryRoot,
   resolveClaudeCodeCommand,
   resolveRepositoryRoot,
   resolveSessionId,
@@ -5451,6 +6169,7 @@ export {
   serializeJsonSchema,
   sessionWorkStatsFromEvents,
   summarizeAdapterOutput,
+  summarizeOrientation,
   tryRemoteUrl,
   ulid,
   updateTaskStatusWithEvent,