@basou/core 0.15.0 → 0.17.0

package/dist/index.js

@@ -11,10 +11,10 @@ async function resolveClaudeCodeCommand(lookup = isOnPath) {
   throw new Error("Claude Code CLI not found in PATH. Install claude-code (or claude) first.");
 }
 async function isOnPath(command) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     const child = spawn("which", [command], { stdio: "ignore" });
-    child.on("error", () => resolve2(false));
-    child.on("exit", (code) => resolve2(code === 0));
+    child.on("error", () => resolve3(false));
+    child.on("exit", (code) => resolve3(code === 0));
   });
 }
 function summarizeAdapterOutput(_stream, _raw) {
@@ -1372,7 +1372,8 @@ async function classifySuspect(paths, sessionId, session, now, onWarning) {
   }
   return { suspect: false, suspectReason: null };
 }
-async function loadSessionEntries(paths, options) {
+async function loadEntriesFromRoot(root, options) {
+  const { paths } = root;
   const sessionIds = await enumerateSessionDirs(paths);
   const entries = [];
   for (const sid of sessionIds) {
@@ -1402,10 +1403,50 @@ async function loadSessionEntries(paths, options) {
     } catch {
       options.onSkip?.(sid, "events_jsonl_unreadable");
     }
-    entries.push({ sessionId: sid, session, suspect, suspectReason });
+    entries.push({
+      sessionId: sid,
+      session,
+      suspect,
+      suspectReason,
+      sourceRoot: paths,
+      host: root.host
+    });
   }
   return entries;
 }
+async function loadSessionEntries(paths, options) {
+  return loadEntriesFromRoot({ paths, host: null }, options);
+}
+async function loadFederatedSessionEntries(roots, options) {
+  const out = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  const seenExternal = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    let entries;
+    if (root.host === null) {
+      entries = await loadEntriesFromRoot(root, options);
+    } else {
+      try {
+        entries = await loadEntriesFromRoot(root, options);
+      } catch (error) {
+        options.onRootUnavailable?.(root.host, error);
+        continue;
+      }
+    }
+    for (const entry of entries) {
+      if (seenIds.has(entry.sessionId)) continue;
+      const ext = entry.session.session.source.external_id;
+      if (typeof ext === "string" && ext.length > 0) {
+        const extKey = `${entry.session.session.source.kind}:${ext}`;
+        if (seenExternal.has(extKey)) continue;
+        seenExternal.add(extKey);
+      }
+      seenIds.add(entry.sessionId);
+      out.push(entry);
+    }
+  }
+  return out;
+}
 
 // src/decisions/decisions-renderer.ts
 async function renderDecisions(input) {
@@ -4190,8 +4231,82 @@ async function resolveIdInternal(paths, input, kind, options = {}) {
   return matches[0];
 }
 
+// src/lib/source-root-scope.ts
+import { promises as fs } from "fs";
+import { homedir as osHomedir } from "os";
+import { basename as basename2, dirname as dirname3, isAbsolute, join as join14, normalize, relative, resolve as resolve2 } from "path";
+var AGENT_INFRA_DIRS = ["~/.claude", "~/.codex", "~/.basou"];
+async function realpathBestEffort(absPath) {
+  let current = normalize(absPath);
+  const tail = [];
+  for (let guard = 0; guard < 4096; guard += 1) {
+    try {
+      const real = await fs.realpath(current);
+      return tail.length > 0 ? join14(real, ...tail.reverse()) : real;
+    } catch (error) {
+      const code = error?.code;
+      if (code !== "ENOENT" && code !== "ENOTDIR") {
+        return normalize(absPath);
+      }
+      const parent = dirname3(current);
+      if (parent === current) return normalize(absPath);
+      tail.push(basename2(current));
+      current = parent;
+    }
+  }
+  return normalize(absPath);
+}
+function expandTilde(p, homedir4) {
+  if (p === "~") return homedir4;
+  if (p.startsWith("~/")) return join14(homedir4, p.slice(2));
+  return p;
+}
+function toAbsolute(p, workingDirAbs, homedir4) {
+  const expanded = expandTilde(p, homedir4);
+  if (isAbsolute(expanded)) return normalize(expanded);
+  return normalize(resolve2(workingDirAbs, expanded));
+}
+function isUnder(child, parent) {
+  if (child === parent) return true;
+  const rel = relative(parent, child);
+  return rel !== "" && !rel.startsWith("..") && !isAbsolute(rel);
+}
+async function classifyFilesBySourceRoot(input) {
+  const inRoot = [];
+  const outOfRoot = [];
+  if (input.files.length === 0) return { inRoot, outOfRoot };
+  const homedir4 = input.homedir ?? osHomedir();
+  const workingDirAbs = toAbsolute(input.workingDirectory, homedir4, homedir4);
+  const declared = input.sourceRoots && input.sourceRoots.length > 0 ? [...input.sourceRoots] : ["."];
+  const rootsAbs = [];
+  for (const r of declared) {
+    const expanded = expandTilde(r, homedir4);
+    const abs = isAbsolute(expanded) ? normalize(expanded) : normalize(resolve2(input.masterRoot, expanded));
+    rootsAbs.push(await realpathBestEffort(abs));
+  }
+  for (const e of input.extraInRoot ?? []) {
+    const expanded = expandTilde(e, homedir4);
+    const abs = isAbsolute(expanded) ? normalize(expanded) : normalize(resolve2(homedir4, expanded));
+    rootsAbs.push(await realpathBestEffort(abs));
+  }
+  if (rootsAbs.length === 0) {
+    return { inRoot: [...input.files], outOfRoot };
+  }
+  for (const file of input.files) {
+    try {
+      const abs = toAbsolute(file, workingDirAbs, homedir4);
+      const real = await realpathBestEffort(abs);
+      const within = rootsAbs.some((root) => isUnder(real, root));
+      (within ? inRoot : outOfRoot).push(file);
+    } catch {
+      inRoot.push(file);
+    }
+  }
+  return { inRoot, outOfRoot };
+}
+
 // src/orientation/orientation-renderer.ts
-import { join as join14 } from "path";
+import { dirname as dirname4, join as join15 } from "path";
 
 // src/storage/manifest.ts
 import { lstat as lstat3 } from "fs/promises";
@@ -4344,7 +4459,13 @@ async function summarizeOrientation(input) {
   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 entries = input.federatedRoots !== void 0 && input.federatedRoots.length > 0 ? await loadFederatedSessionEntries(
+    [{ paths: input.paths, host: null }, ...input.federatedRoots],
+    {
+      ...loadOpts,
+      ...input.onHostUnavailable !== void 0 ? { onRootUnavailable: input.onHostUnavailable } : {}
+    }
+  ) : await loadSessionEntries(input.paths, loadOpts);
   const decisions = [];
   let latestActivityAt = null;
   let latestNote = null;
@@ -4354,7 +4475,7 @@ async function summarizeOrientation(input) {
     }
   };
   for (const entry of entries) {
-    const sessionDir = join14(input.paths.sessions, entry.sessionId);
+    const sessionDir = join15(entry.sourceRoot.sessions, entry.sessionId);
     const counted = entry.session.session.status !== "archived";
     if (counted) noteActivity(entry.session.session.ended_at ?? entry.session.session.started_at);
     try {
@@ -4366,12 +4487,18 @@ async function summarizeOrientation(input) {
             decisionId: ev.decision_id,
             title: ev.title,
             occurredAt: ev.occurred_at,
-            sessionId: entry.sessionId
+            sessionId: entry.sessionId,
+            host: entry.host
           });
         }
         if (counted && ev.type === "note_added" && ev.kind === "next_step") {
           if (latestNote === null || Date.parse(ev.occurred_at) > Date.parse(latestNote.occurredAt)) {
-            latestNote = { body: ev.body, sessionId: entry.sessionId, occurredAt: ev.occurred_at };
+            latestNote = {
+              body: ev.body,
+              sessionId: entry.sessionId,
+              occurredAt: ev.occurred_at,
+              host: entry.host
+            };
           }
         }
         if (counted) noteActivity(ev.occurred_at);
@@ -4414,7 +4541,8 @@ async function summarizeOrientation(input) {
   const suspects = entries.filter((e) => e.suspect).map((e) => ({
     sessionId: e.sessionId,
     status: e.session.session.status,
-    reason: e.suspectReason
+    reason: e.suspectReason,
+    host: e.host
   }));
   const liveEntries = entries.filter(
     (e) => e.session.session.status !== "archived" && e.session.session.source.kind !== "import"
@@ -4423,7 +4551,8 @@ async function summarizeOrientation(input) {
   const latestSession = latestEntry !== void 0 ? {
     sessionId: latestEntry.sessionId,
     label: latestEntry.session.session.label ?? null,
-    status: latestEntry.session.session.status
+    status: latestEntry.session.session.status,
+    host: latestEntry.host
   } : null;
   const activityEntries = entries.filter((e) => e.session.session.status !== "archived");
   const newest = [...activityEntries].sort(
@@ -4444,8 +4573,27 @@ async function summarizeOrientation(input) {
   }
   const latestFiles = latestEntry?.session.session.related_files ?? [];
   const uniqueFiles = new Set(latestFiles);
-  const displayed = [...uniqueFiles].sort().slice(0, limit);
+  const sortedFiles = [...uniqueFiles].sort();
+  const displayed = sortedFiles.slice(0, limit);
   const overflow = Math.max(0, uniqueFiles.size - limit);
+  let outOfRoot = [];
+  if (latestEntry !== void 0 && latestEntry.host === null && sortedFiles.length > 0 && sourceRoots !== null && sourceRoots.length > 0) {
+    try {
+      const scope = await classifyFilesBySourceRoot({
+        files: sortedFiles,
+        workingDirectory: latestEntry.session.session.working_directory,
+        sourceRoots,
+        masterRoot: dirname4(input.paths.root),
+        extraInRoot: AGENT_INFRA_DIRS
+      });
+      outOfRoot = scope.outOfRoot;
+    } catch {
+      outOfRoot = [];
+    }
+  }
+  const hosts = [
+    ...new Set(entries.map((e) => e.host).filter((h) => h !== null))
+  ].sort();
   return {
     generatedAt: input.nowIso,
     sessionCount: entries.length,
@@ -4453,11 +4601,12 @@ async function summarizeOrientation(input) {
     latestDecision: latestDecision ?? null,
     decisionCount: decisions.length,
     latestNote,
-    relatedFiles: { displayed, overflow },
+    relatedFiles: { displayed, overflow, outOfRoot },
     inFlightTasks,
     plannedTasks,
     pendingApprovals,
     suspects,
+    hosts,
     freshness: {
       newestStartedAt: newest?.session.session.started_at ?? null,
       newestSource: newest?.session.session.source.kind ?? null,
@@ -4485,11 +4634,15 @@ function formatOrientationBody(summary, opts) {
   const lines = [];
   const now = new Date(summary.generatedAt);
   const newestRel = relativeAge(summary.freshness.newestStartedAt ?? void 0, now);
+  const hostSuffix = (h) => h !== null ? ` @${h}` : "";
   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}`
   );
+  if (summary.hosts.length > 0) {
+    lines.push(`> hosts: local, ${summary.hosts.join(", ")}`);
+  }
   lines.push("");
   lines.push("## \u4ECA\u3069\u3053\u306B\u3044\u308B");
   lines.push("");
@@ -4497,9 +4650,9 @@ function formatOrientationBody(summary, opts) {
     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}]`);
+      lines.push(`- \u6700\u7D42 session: ${s.label} (${s.status}) [${sid}]${hostSuffix(s.host)}`);
     } else {
-      lines.push(`- \u6700\u7D42 session: ${sid} (${s.status})`);
+      lines.push(`- \u6700\u7D42 session: ${sid} (${s.status})${hostSuffix(s.host)}`);
     }
   } else {
     lines.push("- \u6700\u7D42 session: (no live sessions)");
@@ -4507,7 +4660,9 @@ function formatOrientationBody(summary, opts) {
   if (summary.latestDecision !== null) {
     const dec = summary.latestDecision;
     const decAge = relativeAgeJa(dec.occurredAt, now);
-    lines.push(`- \u76F4\u8FD1\u306E\u5224\u65AD: ${dec.title} [${shortId(dec.decisionId)}] (${decAge})`);
+    lines.push(
+      `- \u76F4\u8FD1\u306E\u5224\u65AD: ${dec.title} [${shortId(dec.decisionId)}] (${decAge})${hostSuffix(dec.host)}`
+    );
     const activityAt = summary.freshness.latestActivityAt;
     if (activityAt !== null && isTrailingStale(activityAt, dec.occurredAt)) {
       lines.push(
@@ -4529,6 +4684,15 @@ function formatOrientationBody(summary, opts) {
     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}`);
+    if (summary.relatedFiles.outOfRoot.length > 0) {
+      const OUT_OF_ROOT_DISPLAY = 10;
+      const out = summary.relatedFiles.outOfRoot;
+      const shownOut = out.slice(0, OUT_OF_ROOT_DISPLAY).join(", ");
+      const outMore = out.length > OUT_OF_ROOT_DISPLAY ? ` (... +${out.length - OUT_OF_ROOT_DISPLAY} more)` : "";
+      lines.push(
+        `  - \u26A0 source_roots \u5916 ${out.length} \u4EF6 (\u5225\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u53EF\u80FD\u6027): ${shownOut}${outMore}`
+      );
+    }
   } else {
     lines.push("- \u76F4\u8FD1\u306E\u5909\u66F4\u30D5\u30A1\u30A4\u30EB: (none recorded)");
   }
@@ -4562,7 +4726,9 @@ function formatOrientationBody(summary, opts) {
     lines.push("- (none)");
   } else {
     for (const e of summary.suspects) {
-      lines.push(`- ${shortId(e.sessionId)} (${e.status}) \u2014 ${suspectText(e.reason)}`);
+      lines.push(
+        `- ${shortId(e.sessionId)} (${e.status}) \u2014 ${suspectText(e.reason)}${hostSuffix(e.host)}`
+      );
     }
   }
   lines.push("");
@@ -4571,7 +4737,7 @@ function formatOrientationBody(summary, opts) {
   if (summary.latestNote !== null) {
     const noteAge = relativeAgeJa(summary.latestNote.occurredAt, now);
     lines.push(
-      `- \u6B21\u306E\u8D77\u70B9 (\u8A18\u9332\u6E08\u307F, ${noteAge}): ${noteSummary(summary.latestNote.body)} [session ${shortId(summary.latestNote.sessionId)}]`
+      `- \u6B21\u306E\u8D77\u70B9 (\u8A18\u9332\u6E08\u307F, ${noteAge}): ${noteSummary(summary.latestNote.body)} [session ${shortId(summary.latestNote.sessionId)}]${hostSuffix(summary.latestNote.host)}`
     );
     const activityAt = summary.freshness.latestActivityAt;
     if (activityAt !== null && isTrailingStale(activityAt, summary.latestNote.occurredAt)) {
@@ -4601,6 +4767,12 @@ function formatOrientationBody(summary, opts) {
   lines.push("## \u3053\u308C\u306F\u6700\u65B0\u304B");
   lines.push("");
   for (const line of freshnessVerdict(summary, opts.staleness, now)) lines.push(line);
+  if (summary.hosts.length > 0) {
+    lines.push("");
+    lines.push(
+      "\u6CE8: \u9BAE\u5EA6\u5224\u5B9A\u306F\u3053\u306E\u30DE\u30B7\u30F3\u306E\u30ED\u30FC\u30AB\u30EB\u30B9\u30C8\u30A2\u306E\u307F\u304C\u5BFE\u8C61\u3067\u3059\u3002\u4ED6\u30DB\u30B9\u30C8\u306E\u53D6\u308A\u3053\u307C\u3057\u306F\u5224\u5B9A\u3067\u304D\u307E\u305B\u3093(\u5404\u30DB\u30B9\u30C8\u3067 basou refresh \u3092\u5B9F\u884C\u3057\u540C\u671F\u3057\u3066\u304F\u3060\u3055\u3044)\u3002"
+    );
+  }
   if (opts.verbose) {
     lines.push("");
     lines.push("<!-- verbose: raw freshness telemetry -->");
@@ -4677,8 +4849,9 @@ function freshnessVerdict(summary, staleness, now) {
       "\u6700\u65B0\u304B\u78BA\u8A8D\u3059\u308B\u306B\u306F `basou refresh` \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
     ];
   }
+  const localScope = summary.hosts.length > 0 ? "\u3053\u306E\u30DB\u30B9\u30C8(\u30ED\u30FC\u30AB\u30EB)\u306E" : "";
   const lines = [
-    `\u2705 \u53D6\u308A\u8FBC\u307F\u306F\u6700\u65B0\u3067\u3059\u3002\u6700\u5F8C\u306E\u4F5C\u696D\u306F ${rel}(${tool})\u3002\u672A\u53D6\u308A\u8FBC\u307F\u306E native \u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u3042\u308A\u307E\u305B\u3093\u3002`
+    `\u2705 ${localScope}\u53D6\u308A\u8FBC\u307F\u306F\u6700\u65B0\u3067\u3059\u3002\u6700\u5F8C\u306E\u4F5C\u696D\u306F ${rel}(${tool})\u3002\u672A\u53D6\u308A\u8FBC\u307F\u306E native \u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u3042\u308A\u307E\u305B\u3093\u3002`
   ];
   if (suspectCount > 0) {
     lines.push(`\u305F\u3060\u3057\u8981\u6CE8\u610F\u30BB\u30C3\u30B7\u30E7\u30F3\u304C ${suspectCount} \u4EF6\u3042\u308A\u307E\u3059(\u4E0A\u8A18\u300C\u8981\u6CE8\u610F session\u300D\u53C2\u7167)\u3002`);
@@ -5301,10 +5474,10 @@ function planWorkspaceView(facts, existing = [], rosterNames = []) {
 }
 
 // src/report/report-renderer.ts
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 
 // src/stats/work-stats.ts
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 function resolveTimeZone(timeZone) {
   if (timeZone !== void 0 && timeZone.length > 0) return timeZone;
   return Intl.DateTimeFormat().resolvedOptions().timeZone;
@@ -5335,7 +5508,7 @@ async function computeWorkStats(input) {
     const events = [];
     let eventsUnreadable = false;
     try {
-      for await (const ev of replayEvents(join15(input.paths.sessions, entry.sessionId), {
+      for await (const ev of replayEvents(join16(input.paths.sessions, entry.sessionId), {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
       })) {
         events.push(ev);
@@ -5622,7 +5795,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 = join16(input.paths.sessions, entry.sessionId);
+    const sessionDir = join17(input.paths.sessions, entry.sessionId);
     try {
       for await (const ev of replayEvents(sessionDir, {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
@@ -5903,7 +6076,7 @@ function formatInt(n) {
 // src/review/review-gaps.ts
 import { existsSync, realpathSync } from "fs";
 import { homedir as homedir2 } from "os";
-import { basename as basename2, isAbsolute, join as join17 } from "path";
+import { basename as basename3, isAbsolute as isAbsolute2, join as join18 } from "path";
 function stripQuotes(s) {
   if (s.length >= 2 && (s[0] === '"' && s.at(-1) === '"' || s[0] === "'" && s.at(-1) === "'")) {
     return s.slice(1, -1);
@@ -5927,7 +6100,7 @@ var repoRootCache = /* @__PURE__ */ new Map();
 function isRepoRoot(realPath) {
   const cached = repoRootCache.get(realPath);
   if (cached !== void 0) return cached;
-  const result = existsSync(join17(realPath, ".git"));
+  const result = existsSync(join18(realPath, ".git"));
   repoRootCache.set(realPath, result);
   return result;
 }
@@ -5936,7 +6109,7 @@ function normalizeRepoPath(p) {
   let s = stripQuotes(p.trim()).replace(/\/+$/, "");
   if (s.length === 0 || s === "~") return null;
   if (s.startsWith("~/")) s = homedir2() + s.slice(1);
-  if (isAbsolute(s)) {
+  if (isAbsolute2(s)) {
     const real = resolveRealpath(s);
     if (real !== null) {
       return isRepoRoot(real) ? real : null;
@@ -5950,7 +6123,7 @@ function normalizeRepoPath(p) {
 }
 function normalizeRepoKey(p) {
   const full = normalizeRepoPath(p);
-  return full === null ? null : basename2(full);
+  return full === null ? null : basename3(full);
 }
 function inspectCommand(args) {
   const a = args.join(" ");
@@ -5964,7 +6137,7 @@ function inspectCommand(args) {
     let m;
     while ((m = re.exec(a)) !== null) {
       const f = m[1];
-      if (f !== void 0) files.add(basename2(f));
+      if (f !== void 0) files.add(basename3(f));
     }
   }
   return { files: [...files], examinedDiff };
@@ -5981,7 +6154,7 @@ function commitFiles(args) {
   const a = args.join(" ");
   const add = a.match(/git add\s+([^&|;]+)/);
   if (!add?.[1]) return [];
-  return add[1].split(/\s+/).filter((t) => /\.[A-Za-z]/.test(t) && !t.startsWith("-")).map((t) => basename2(t));
+  return add[1].split(/\s+/).filter((t) => /\.[A-Za-z]/.test(t) && !t.startsWith("-")).map((t) => basename3(t));
 }
 var REVIEW_SOURCE = "codex-import";
 var DEFAULT_WINDOW_HOURS = 24;
@@ -5997,7 +6170,7 @@ async function findReviewGaps(input) {
   const workUnits = /* @__PURE__ */ new Map();
   const unknownCommits = /* @__PURE__ */ new Map();
   for (const entry of entries) {
-    const sessionDir = join17(input.paths.sessions, entry.sessionId);
+    const sessionDir = join18(input.paths.sessions, entry.sessionId);
     const isReview = entry.session.session.source.kind === REVIEW_SOURCE;
     const reviewRepos = /* @__PURE__ */ new Map();
     let reviewEnd = null;
@@ -6046,7 +6219,7 @@ async function findReviewGaps(input) {
   let newestCommit = null;
   for (const [sessionId, byRepo] of workUnits) {
     for (const [repoPath, commits] of byRepo) {
-      const label = basename2(repoPath);
+      const label = basename3(repoPath);
       if (scope !== null && !scope.includes(label)) continue;
       const times = commits.map((c) => c.at).sort((a, b) => a - b);
       const first = times[0] ?? null;
@@ -6205,7 +6378,7 @@ var ChildProcessRunner = class {
       if (killTimer !== null) clearTimeout(killTimer);
       options.signal?.removeEventListener("abort", onAbort);
     };
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       child.once("error", (error) => {
         if (settled) return;
         settled = true;
@@ -6217,7 +6390,7 @@ var ChildProcessRunner = class {
         settled = true;
         cleanup();
         const ended_at = /* @__PURE__ */ new Date();
-        resolve2({
+        resolve3({
           command: snapshotCommand,
           args: snapshotArgs,
           cwd: snapshotCwd,
@@ -6372,28 +6545,28 @@ function serializeJsonSchema(schema) {
 
 // src/storage/basou-dir.ts
 import { lstat as lstat4, mkdir as mkdir4 } from "fs/promises";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 function basouPaths(repositoryRoot) {
-  const root = join18(repositoryRoot, ".basou");
-  const approvalsBase = join18(root, "approvals");
+  const root = join19(repositoryRoot, ".basou");
+  const approvalsBase = join19(root, "approvals");
   return {
     root,
-    sessions: join18(root, "sessions"),
-    tasks: join18(root, "tasks"),
+    sessions: join19(root, "sessions"),
+    tasks: join19(root, "tasks"),
     approvals: {
-      pending: join18(approvalsBase, "pending"),
-      resolved: join18(approvalsBase, "resolved")
+      pending: join19(approvalsBase, "pending"),
+      resolved: join19(approvalsBase, "resolved")
     },
-    locks: join18(root, "locks"),
-    logs: join18(root, "logs"),
-    raw: join18(root, "raw"),
-    tmp: join18(root, "tmp"),
+    locks: join19(root, "locks"),
+    logs: join19(root, "logs"),
+    raw: join19(root, "raw"),
+    tmp: join19(root, "tmp"),
     files: {
-      manifest: join18(root, "manifest.yaml"),
-      status: join18(root, "status.json"),
-      handoff: join18(root, "handoff.md"),
-      decisions: join18(root, "decisions.md"),
-      orientation: join18(root, "orientation.md")
+      manifest: join19(root, "manifest.yaml"),
+      status: join19(root, "status.json"),
+      handoff: join19(root, "handoff.md"),
+      decisions: join19(root, "decisions.md"),
+      orientation: join19(root, "orientation.md")
     }
   };
 }
@@ -6450,12 +6623,12 @@ function hasErrorCode4(error) {
 
 // src/storage/gitignore.ts
 import { readFile as readFile8, writeFile as writeFile2 } from "fs/promises";
-import { join as join19 } from "path";
+import { join as join20 } 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/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 = join19(repositoryRoot, ".gitignore");
+  const gitignorePath = join20(repositoryRoot, ".gitignore");
   let body;
   let existed;
   try {
@@ -6628,7 +6801,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 homedir3 } from "os";
-import { join as join20 } from "path";
+import { join as join21 } 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}`);
@@ -6653,7 +6826,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
       pathSanitizeReport
     };
   }
-  const sessionDir = join20(paths.sessions, newSessionId);
+  const sessionDir = join21(paths.sessions, newSessionId);
   try {
     await mkdir5(sessionDir, { recursive: true });
   } catch (error) {
@@ -6667,7 +6840,7 @@ async function importSessionFromJson(paths, manifest, payload, options) {
     throw error;
   }
   try {
-    const sessionYamlPath = join20(sessionDir, "session.yaml");
+    const sessionYamlPath = join21(sessionDir, "session.yaml");
     await linkYamlFile(sessionYamlPath, withIntegrity(sessionRecord, chainResult));
   } catch (error) {
     await rm2(sessionDir, { recursive: true, force: true }).catch(() => void 0);
@@ -6835,7 +7008,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 = join20(paths.sessions, priorSessionId);
+  const sessionDir = join21(paths.sessions, priorSessionId);
   const lock = options.dryRun === true ? null : await acquireLock(paths, "session", priorSessionId);
   try {
     const priorVerdict = await verifyEventsChain(paths, priorSessionId);
@@ -6877,7 +7050,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
     };
     const updatedRecord = { schema_version: "0.1.0", session: preservedInner };
     if (options.dryRun !== true) {
-      const eventsPath = join20(sessionDir, "events.jsonl");
+      const eventsPath = join21(sessionDir, "events.jsonl");
       let priorEventsRaw = null;
       try {
         priorEventsRaw = await readFile10(eventsPath);
@@ -6889,7 +7062,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
       const chainResult = await writeEventsBulk(sessionDir, mergedEvents, { chain: true });
       try {
         await overwriteYamlFile(
-          join20(sessionDir, "session.yaml"),
+          join21(sessionDir, "session.yaml"),
           withIntegrity(updatedRecord, chainResult)
         );
       } catch (error) {
@@ -6913,7 +7086,7 @@ async function reimportPreservingId(paths, manifest, priorSessionId, freshPayloa
   }
 }
 async function rechainSessionInPlace(paths, sessionId, options = {}) {
-  const sessionDir = join20(paths.sessions, sessionId);
+  const sessionDir = join21(paths.sessions, sessionId);
   let lock;
   try {
     lock = await acquireLock(paths, "session", sessionId);
@@ -6946,7 +7119,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     if (verdict.status !== "unchained") {
       return { status: "skipped", reason: "tampered" };
     }
-    const eventsPath = join20(sessionDir, "events.jsonl");
+    const eventsPath = join21(sessionDir, "events.jsonl");
     let priorRaw;
     try {
       priorRaw = await readFile10(eventsPath);
@@ -6994,7 +7167,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
     }
     try {
       await overwriteYamlFile(
-        join20(sessionDir, "session.yaml"),
+        join21(sessionDir, "session.yaml"),
         withIntegrity(record, { headHash: chainResult.headHash, count: chainResult.count })
       );
     } catch (error) {
@@ -7011,6 +7184,7 @@ async function rechainSessionInPlace(paths, sessionId, options = {}) {
 var BASOU_CORE_VERSION = "0.1.0";
 export {
   ACTIVE_GAP_CAP_MS,
+  AGENT_INFRA_DIRS,
   ApprovalIdSchema,
   ApprovalSchema,
   ApprovalStatusSchema,
@@ -7061,6 +7235,7 @@ export {
   buildStatusSnapshot,
   chainEvents,
   chainRawJsonLines,
+  classifyFilesBySourceRoot,
   classifySuspect,
   claudeCodeAdapterMetadata,
   claudeTranscriptToImportPayload,
@@ -7093,6 +7268,7 @@ export {
   lineHash,
   linkYamlFile,
   loadApproval,
+  loadFederatedSessionEntries,
   loadSessionEntries,
   loadTaskEntries,
   normalizeRepoKey,