@basou/core 0.40.0 → 0.41.0

package/dist/index.d.ts

@@ -2111,6 +2111,8 @@ type ViewStrings = {
         recentDecisionsLabel: string;
         recentNextStepLabel: string;
         recentChangedLabel: string;
+        /** Trails the recent-files line when scratch paths were left out of it. */
+        scratchOmitted: (count: number) => string;
         trackCloseInstruction: string;
         nextStepRecordedLabel: (age: string) => string;
         noteStaleNote: (activityAge: string) => string;
@@ -4328,6 +4330,8 @@ type OrientationSummary = {
         displayed: string[];
         overflow: number;
         outOfRoot: string[];
+        /** Scratch paths left out of `displayed` (see `isTransientToolPath`). */
+        omitted: number;
     };
     /** Tasks whose status is `planned` or `in_progress`. */
     inFlightTasks: InFlightTask[];

package/dist/index.js

@@ -2098,6 +2098,7 @@ var EN = {
     recentDecisionsLabel: "Decisions",
     recentNextStepLabel: "Next step",
     recentChangedLabel: "Changed",
+    scratchOmitted: (count) => `(+${count} scratch omitted)`,
     trackCloseInstruction: "When finished, close it with `basou decision void <decision_id>`. It stays listed here every time until closed.",
     nextStepRecordedLabel: (age) => `Next step (recorded, ${age})`,
     noteStaleNote: (age) => `Note: work continued after this was recorded (latest activity ${age}), so this starting point may be stale.`,
@@ -2193,6 +2194,7 @@ var JA = {
     recentDecisionsLabel: "\u5224\u65AD",
     recentNextStepLabel: "\u6B21\u306E\u8D77\u70B9",
     recentChangedLabel: "\u5909\u66F4",
+    scratchOmitted: (count) => `(\u4F5C\u696D\u7528\u4E00\u6642\u30D5\u30A1\u30A4\u30EB ${count} \u4EF6\u306F\u9664\u5916)`,
     trackCloseInstruction: "\u5B8C\u4E86\u3057\u305F\u3089 `basou decision void <decision_id>` \u3067\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002\u9589\u3058\u308B\u307E\u3067\u6BCE\u56DE\u3053\u3053\u306B\u8868\u793A\u3055\u308C\u307E\u3059\u3002",
     nextStepRecordedLabel: (age) => `\u6B21\u306E\u8D77\u70B9 (\u8A18\u9332\u6E08\u307F, ${age})`,
     noteStaleNote: (age) => `\u6CE8: \u3053\u306E\u8D77\u70B9\u306E\u8A18\u9332\u5F8C (\u6700\u7D42\u6D3B\u52D5 ${age}) \u3082\u4F5C\u696D\u304C\u7D9A\u3044\u3066\u3044\u307E\u3059\u3002\u518D\u958B\u70B9\u304C\u53E4\u3044\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002`,
@@ -2533,8 +2535,8 @@ async function isStaleLock(lockPath) {
   }
 }
 function lockfilePath(paths, scope, resourceId) {
-  const sep = resourceId.indexOf("_");
-  const ulid2 = sep >= 0 ? resourceId.slice(sep + 1) : resourceId;
+  const sep2 = resourceId.indexOf("_");
+  const ulid2 = sep2 >= 0 ? resourceId.slice(sep2 + 1) : resourceId;
   return join3(paths.locks, `${scope}_${ulid2}.lock`);
 }
 
@@ -3597,6 +3599,29 @@ function pickLatestSubstantiveEntry(entries) {
   })[0];
 }
 
+// src/lib/transient-paths.ts
+import { tmpdir } from "os";
+import { normalize, sep } from "path";
+var TEMP_ROOTS = ["/tmp", "/var/tmp"];
+var MIN_ENCODED_DASHES = 3;
+function isEncodedWorkingDirectory(segment) {
+  return segment.startsWith("-") && segment.split("-").length - 1 >= MIN_ENCODED_DASHES;
+}
+function withPrivateAlias(root) {
+  const normalized = normalize(root);
+  if (normalized.startsWith(`${sep}private${sep}`)) {
+    return [normalized, normalized.slice(`${sep}private`.length)];
+  }
+  return [normalized, `${sep}private${normalized}`];
+}
+function isTransientToolPath(filePath, temp = tmpdir()) {
+  const candidate = normalize(filePath);
+  if (!candidate.startsWith(sep)) return false;
+  const root = [...TEMP_ROOTS, temp].flatMap(withPrivateAlias).find((r) => candidate === r || candidate.startsWith(r + sep));
+  if (root === void 0) return false;
+  return candidate.slice(root.length).split(sep).some(isEncodedWorkingDirectory);
+}
+
 // src/storage/tasks.ts
 import { createHash as createHash2 } from "crypto";
 import { mkdir as mkdir3, readdir as readdir4, readFile as readFile7, rename as rename2, stat as stat3, unlink as unlink3 } from "fs/promises";
@@ -5416,7 +5441,9 @@ async function renderHandoff(input) {
     (e) => e.session.session.status !== "archived" && e.session.session.source.kind !== "import"
   );
   const latestSession = pickLatestSubstantiveEntry(liveEntries);
-  const latestFiles = latestSession?.session.session.related_files ?? [];
+  const latestFiles = (latestSession?.session.session.related_files ?? []).filter(
+    (file) => !isTransientToolPath(file)
+  );
   const sortedFiles = [...new Set(latestFiles)].sort();
   const displayedFiles = sortedFiles.slice(0, limit);
   const overflow = Math.max(0, sortedFiles.length - limit);
@@ -5634,9 +5661,9 @@ function shortHandoffId(sessionId) {
   return sessionId.slice(0, 10);
 }
 function shortIdWithPrefix(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);
+  const sep2 = id.indexOf("_");
+  if (sep2 === -1) return id.slice(0, 10);
+  return id.slice(0, sep2 + 1) + id.slice(sep2 + 1, sep2 + 1 + 10);
 }
 
 // src/lib/duration.ts
@@ -5743,10 +5770,10 @@ async function resolveIdInternal(paths, input, kind, options = {}) {
 // 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";
+import { basename as basename2, dirname as dirname3, isAbsolute, join as join14, normalize as normalize2, relative, resolve as resolve2 } from "path";
 var AGENT_INFRA_DIRS = ["~/.claude", "~/.codex", "~/.basou"];
 async function realpathBestEffort(absPath) {
-  let current = normalize(absPath);
+  let current = normalize2(absPath);
   const tail = [];
   for (let guard = 0; guard < 4096; guard += 1) {
     try {
@@ -5755,15 +5782,15 @@ async function realpathBestEffort(absPath) {
     } catch (error) {
       const code = error?.code;
       if (code !== "ENOENT" && code !== "ENOTDIR") {
-        return normalize(absPath);
+        return normalize2(absPath);
       }
       const parent = dirname3(current);
-      if (parent === current) return normalize(absPath);
+      if (parent === current) return normalize2(absPath);
       tail.push(basename2(current));
       current = parent;
     }
   }
-  return normalize(absPath);
+  return normalize2(absPath);
 }
 function expandTilde(p, homedir5) {
   if (p === "~") return homedir5;
@@ -5772,8 +5799,8 @@ function expandTilde(p, homedir5) {
 }
 function toAbsolute(p, workingDirAbs, homedir5) {
   const expanded = expandTilde(p, homedir5);
-  if (isAbsolute(expanded)) return normalize(expanded);
-  return normalize(resolve2(workingDirAbs, expanded));
+  if (isAbsolute(expanded)) return normalize2(expanded);
+  return normalize2(resolve2(workingDirAbs, expanded));
 }
 function isUnder(child, parent) {
   if (child === parent) return true;
@@ -5790,12 +5817,12 @@ async function classifyFilesBySourceRoot(input) {
   const rootsAbs = [];
   for (const r of declared) {
     const expanded = expandTilde(r, homedir5);
-    const abs = isAbsolute(expanded) ? normalize(expanded) : normalize(resolve2(input.masterRoot, expanded));
+    const abs = isAbsolute(expanded) ? normalize2(expanded) : normalize2(resolve2(input.masterRoot, expanded));
     rootsAbs.push(await realpathBestEffort(abs));
   }
   for (const e of input.extraInRoot ?? []) {
     const expanded = expandTilde(e, homedir5);
-    const abs = isAbsolute(expanded) ? normalize(expanded) : normalize(resolve2(homedir5, expanded));
+    const abs = isAbsolute(expanded) ? normalize2(expanded) : normalize2(resolve2(homedir5, expanded));
     rootsAbs.push(await realpathBestEffort(abs));
   }
   if (rootsAbs.length === 0) {
@@ -5928,7 +5955,13 @@ async function summarizeOrientation(input) {
     const decisionTitles = (bucket?.decisions ?? []).filter((d) => !voidedDecisionIds.has(d.decisionId)).map((d) => d.title);
     const notes = bucket?.notes ?? [];
     const hasIntent = decisionTitles.length > 0 || notes.length > 0;
-    const files = hasIntent ? [] : [...new Set(entry.session.session.related_files ?? [])].sort().slice(0, FILES_PER_DIGEST);
+    const files = hasIntent ? [] : [
+      ...new Set(
+        (entry.session.session.related_files ?? []).filter(
+          (file) => !isTransientToolPath(file)
+        )
+      )
+    ].sort().slice(0, FILES_PER_DIGEST);
     return {
       sessionId: entry.sessionId,
       label: entry.session.session.label ?? null,
@@ -5999,8 +6032,10 @@ async function summarizeOrientation(input) {
   } catch {
     sourceRoots = null;
   }
-  const latestFiles = latestEntry?.session.session.related_files ?? [];
+  const recordedFiles = latestEntry?.session.session.related_files ?? [];
+  const latestFiles = recordedFiles.filter((file) => !isTransientToolPath(file));
   const uniqueFiles = new Set(latestFiles);
+  const omittedFiles = new Set(recordedFiles).size - uniqueFiles.size;
   const sortedFiles = [...uniqueFiles].sort();
   const displayed = sortedFiles.slice(0, limit);
   const overflow = Math.max(0, uniqueFiles.size - limit);
@@ -6031,7 +6066,7 @@ async function summarizeOrientation(input) {
     openTracks,
     latestNote,
     recentDirection,
-    relatedFiles: { displayed, overflow, outOfRoot },
+    relatedFiles: { displayed, overflow, outOfRoot, omitted: omittedFiles },
     inFlightTasks,
     plannedTasks,
     pendingApprovals,
@@ -6119,10 +6154,16 @@ function formatOrientationBody(summary, opts) {
       `- ${t.common.latestDecisionLabel}: (no decisions recorded yet; capture with \`basou decision capture\`)`
     );
   }
-  if (summary.relatedFiles.displayed.length > 0) {
-    const shown = summary.relatedFiles.displayed.join(", ");
-    const more = summary.relatedFiles.overflow > 0 ? ` (... +${summary.relatedFiles.overflow} more)` : "";
-    lines.push(`- ${t.common.recentFilesLabel}: ${shown}${more}`);
+  if (summary.relatedFiles.displayed.length > 0 || summary.relatedFiles.omitted > 0) {
+    const parts = [];
+    if (summary.relatedFiles.displayed.length > 0) {
+      const more = summary.relatedFiles.overflow > 0 ? ` (... +${summary.relatedFiles.overflow} more)` : "";
+      parts.push(`${summary.relatedFiles.displayed.join(", ")}${more}`);
+    }
+    if (summary.relatedFiles.omitted > 0) {
+      parts.push(t.orientation.scratchOmitted(summary.relatedFiles.omitted));
+    }
+    lines.push(`- ${t.common.recentFilesLabel}: ${parts.join(" ")}`);
     if (summary.relatedFiles.outOfRoot.length > 0) {
       const OUT_OF_ROOT_DISPLAY = 10;
       const out = summary.relatedFiles.outOfRoot;
@@ -6371,9 +6412,9 @@ function suspectText(reason) {
   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);
+  const sep2 = id.indexOf("_");
+  if (sep2 === -1) return id.slice(0, 10);
+  return id.slice(0, sep2 + 1) + id.slice(sep2 + 1, sep2 + 1 + 10);
 }
 
 // src/project/anchor-starter.ts