@basou/core 0.11.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,9 +1874,54 @@ 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);
   try {
@@ -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)");
@@ -4091,11 +4146,455 @@ async function resolveIdInternal(paths, input, kind, options = {}) {
   return matches[0];
 }
 
-// src/report/report-renderer.ts
+// src/orientation/orientation-renderer.ts
 import { join as join14 } from "path";
 
+// src/storage/manifest.ts
+import { lstat as lstat3 } from "fs/promises";
+
+// 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/storage/manifest.ts
+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 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
+    }
+  };
+}
+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;
@@ -4126,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);
@@ -4413,7 +4912,7 @@ async function renderReport(input) {
   const statsBySession = new Map(stats.sessions.map((s) => [s.sessionId, s]));
   const decisions = [];
   for (const entry of entries) {
-    const sessionDir = join14(input.paths.sessions, entry.sessionId);
+    const sessionDir = join16(input.paths.sessions, entry.sessionId);
     try {
       for await (const ev of replayEvents(sessionDir, {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
@@ -4818,55 +5317,6 @@ function classifySpawnError(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({
@@ -4986,28 +5436,29 @@ function serializeJsonSchema(schema) {
 }
 
 // src/storage/basou-dir.ts
-import { lstat as lstat3, mkdir as mkdir4 } from "fs/promises";
-import { join as join15 } from "path";
+import { lstat as lstat4, mkdir as mkdir4 } from "fs/promises";
+import { join as join17 } from "path";
 function basouPaths(repositoryRoot) {
-  const root = join15(repositoryRoot, ".basou");
-  const approvalsBase = join15(root, "approvals");
+  const root = join17(repositoryRoot, ".basou");
+  const approvalsBase = join17(root, "approvals");
   return {
     root,
-    sessions: join15(root, "sessions"),
-    tasks: join15(root, "tasks"),
+    sessions: join17(root, "sessions"),
+    tasks: join17(root, "tasks"),
     approvals: {
-      pending: join15(approvalsBase, "pending"),
-      resolved: join15(approvalsBase, "resolved")
+      pending: join17(approvalsBase, "pending"),
+      resolved: join17(approvalsBase, "resolved")
     },
-    locks: join15(root, "locks"),
-    logs: join15(root, "logs"),
-    raw: join15(root, "raw"),
-    tmp: join15(root, "tmp"),
+    locks: join17(root, "locks"),
+    logs: join17(root, "logs"),
+    raw: join17(root, "raw"),
+    tmp: join17(root, "tmp"),
     files: {
-      manifest: join15(root, "manifest.yaml"),
-      status: join15(root, "status.json"),
-      handoff: join15(root, "handoff.md"),
-      decisions: join15(root, "decisions.md")
+      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")
     }
   };
 }
@@ -5025,9 +5476,9 @@ async function ensureBasouDirectory(repositoryRoot) {
   const paths = basouPaths(repositoryRoot);
   let existing;
   try {
-    existing = await lstat3(paths.root);
+    existing = await lstat4(paths.root);
   } catch (error) {
-    if (!hasErrorCode3(error) || error.code !== "ENOENT") {
+    if (!hasErrorCode4(error) || error.code !== "ENOENT") {
       throw new Error("Failed to inspect .basou directory", { cause: error });
     }
   }
@@ -5050,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";
@@ -5064,28 +5515,30 @@ function hasErrorCode3(error) {
 
 // src/storage/gitignore.ts
 import { readFile as readFile8, writeFile as writeFile2 } from "fs/promises";
-import { join as join16 } 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 = join16(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) {
@@ -5093,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;
@@ -5283,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 join17 } 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}`);
@@ -5308,7 +5697,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
       pathSanitizeReport
     };
   }
-  const sessionDir = join17(paths.sessions, newSessionId);
+  const sessionDir = join19(paths.sessions, newSessionId);
   try {
     await mkdir5(sessionDir, { recursive: true });
   } catch (error) {
@@ -5322,7 +5711,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
     throw error;
   }
   try {
-    const sessionYamlPath = join17(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);
@@ -5490,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 = join17(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);
@@ -5532,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 = join17(sessionDir, "events.jsonl");
+      const eventsPath = join19(sessionDir, "events.jsonl");
       let priorEventsRaw = null;
       try {
         priorEventsRaw = await readFile10(eventsPath);
@@ -5544,7 +5933,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
       const chainResult = await writeEventsBulk(sessionDir, mergedEvents, { chain: true });
       try {
         await overwriteYamlFile(
-          join17(sessionDir, "session.yaml"),
+          join19(sessionDir, "session.yaml"),
           withIntegrity(updatedRecord, chainResult)
         );
       } catch (error) {
@@ -5568,7 +5957,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
   }
 }
 async function rechainSessionInPlace(paths, sessionId, options = {}) {
-  const sessionDir = join17(paths.sessions, sessionId);
+  const sessionDir = join19(paths.sessions, sessionId);
   let lock;
   try {
     lock = await acquireLock(paths, "session", sessionId);
@@ -5601,7 +5990,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     if (verdict.status !== "unchained") {
       return { status: "skipped", reason: "tampered" };
     }
-    const eventsPath = join17(sessionDir, "events.jsonl");
+    const eventsPath = join19(sessionDir, "events.jsonl");
     let priorRaw;
     try {
       priorRaw = await readFile10(eventsPath);
@@ -5649,7 +6038,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     }
     try {
       await overwriteYamlFile(
-        join17(sessionDir, "session.yaml"),
+        join19(sessionDir, "session.yaml"),
         withIntegrity(record, { headHash: chainResult.headHash, count: chainResult.count })
       );
     } catch (error) {
@@ -5764,9 +6153,11 @@ export {
   reimportPreservingId,
   renderDecisions,
   renderHandoff,
+  renderOrientation,
   renderReport,
   renderWithMarkers,
   replayEvents,
+  resolveBasouRepositoryRoot,
   resolveClaudeCodeCommand,
   resolveRepositoryRoot,
   resolveSessionId,
@@ -5778,6 +6169,7 @@ export {
   serializeJsonSchema,
   sessionWorkStatsFromEvents,
   summarizeAdapterOutput,
+  summarizeOrientation,
   tryRemoteUrl,
   ulid,
   updateTaskStatusWithEvent,