@threadbase-sh/streamer 1.36.1 → 1.36.2

package/dist/index.d.cts

@@ -1285,6 +1285,15 @@ declare class StreamerServer {
     private checkExchangeRateLimit;
     private checkSessionStartRateLimit;
     private checkSessionInputRateLimit;
+    /** Project roots watched for conversation JSONLs (profiles or ~/.claude/projects). */
+    private projectsDirsForFreshnessCheck;
+    /**
+     * Full-glob scan + cache upsert/delete reconcile. Used by ?refresh=1 and by
+     * the automatic freshness path when the directory watcher marked the scanner
+     * stale or shouldRefreshProjectsFromHdd detected disk drift.
+     */
+    private reconcileConversationsCacheFromDisk;
+    private shouldAutoReconcileConversationList;
     private handleListConversations;
     private handleConversationsCount;
     private refreshCountInBackground;

package/dist/index.d.ts

@@ -1285,6 +1285,15 @@ declare class StreamerServer {
     private checkExchangeRateLimit;
     private checkSessionStartRateLimit;
     private checkSessionInputRateLimit;
+    /** Project roots watched for conversation JSONLs (profiles or ~/.claude/projects). */
+    private projectsDirsForFreshnessCheck;
+    /**
+     * Full-glob scan + cache upsert/delete reconcile. Used by ?refresh=1 and by
+     * the automatic freshness path when the directory watcher marked the scanner
+     * stale or shouldRefreshProjectsFromHdd detected disk drift.
+     */
+    private reconcileConversationsCacheFromDisk;
+    private shouldAutoReconcileConversationList;
     private handleListConversations;
     private handleConversationsCount;
     private refreshCountInBackground;

package/dist/index.js

@@ -2684,14 +2684,14 @@ import {
   createReadStream,
   existsSync as existsSync10,
   watch as fsWatch,
-  readdirSync as readdirSync5,
+  readdirSync as readdirSync6,
   readFileSync as readFileSync8,
-  statSync as statSync8
+  statSync as statSync9
 } from "fs";
 import { realpath as realpath2 } from "fs/promises";
 import { createServer } from "http";
-import { homedir as homedir8 } from "os";
-import { basename as basename5, dirname as dirname9, join as join17 } from "path";
+import { homedir as homedir9 } from "os";
+import { basename as basename5, dirname as dirname9, join as join18 } from "path";
 import { createInterface } from "readline";
 
 // node_modules/nanoid/index.js
@@ -5420,6 +5420,14 @@ function seal(plaintext, recipientPublicKeyBase64) {
   };
 }
 
+// src/services/cache/cacheMetadata.ts
+function getCacheMetadata(repo, key) {
+  return repo.getCacheMetadata(key);
+}
+function setCacheMetadata(repo, key, value) {
+  repo.setCacheMetadata(key, value);
+}
+
 // src/services/cache-integrity/cacheIntegrityMonitor.ts
 import { createHash as createHash2 } from "crypto";
 import { existsSync as existsSync8 } from "fs";
@@ -5960,6 +5968,140 @@ function pruneAgentConversations(cache) {
   return { scanned: rows.length, pruned, missing };
 }
 
+// src/utils/dates.ts
+import { compareDesc, isValid, parseISO } from "date-fns";
+function parseIsoDateOrNull(value) {
+  if (!value) return null;
+  const parsed = parseISO(value);
+  return isValid(parsed) ? parsed : null;
+}
+function compareIsoDesc(a, b) {
+  const dateA = parseIsoDateOrNull(a);
+  const dateB = parseIsoDateOrNull(b);
+  if (!dateA && !dateB) return 0;
+  if (!dateA) return 1;
+  if (!dateB) return -1;
+  return compareDesc(dateA, dateB);
+}
+
+// src/services/projects/ensureProjectsForConversations.ts
+function ensureProjectsForConversations(repo, conversations) {
+  const conversationsByPath = /* @__PURE__ */ new Map();
+  for (const conversation of conversations) {
+    if (!conversation.projectPath) continue;
+    const canonical = canonicalizeProjectPath(conversation.projectPath);
+    if (!canonical) continue;
+    const existing = conversationsByPath.get(canonical) ?? [];
+    existing.push(conversation);
+    conversationsByPath.set(canonical, existing);
+  }
+  const pathToProjectId = /* @__PURE__ */ new Map();
+  for (const [path, projectConversations] of conversationsByPath) {
+    const latest = pickLatestConversation(projectConversations);
+    const project = repo.upsertProjectByPath(path, {
+      lastConversationId: latest?.id ?? null,
+      lastConversationCreatedAt: latest?.createdAt ?? null,
+      latestMessageAt: latest?.latestMessageAt ?? null
+    });
+    pathToProjectId.set(path, project.id);
+  }
+  return pathToProjectId;
+}
+function pickLatestConversation(conversations) {
+  if (conversations.length === 0) return void 0;
+  return [...conversations].sort((a, b) => {
+    const cmp = compareIsoDesc(a.latestMessageAt ?? null, b.latestMessageAt ?? null);
+    if (cmp !== 0) return cmp;
+    return compareIsoDesc(a.createdAt ?? null, b.createdAt ?? null);
+  })[0];
+}
+
+// src/services/conversations/refreshConversationCache.ts
+function refreshConversationCache(deps) {
+  const { projectsRepo, conversationsRepo, cacheMetadataRepo } = deps;
+  const conversations = conversationsRepo.listConversationsForProjectBackfill();
+  const pathToProjectId = ensureProjectsForConversations(
+    projectsRepo,
+    conversations.map((c) => ({
+      id: c.id,
+      projectPath: c.projectPath,
+      latestMessageAt: c.lastActivity ?? null,
+      createdAt: c.lastActivity ?? null
+    }))
+  );
+  let conversationsBackfilled = 0;
+  for (const conversation of conversations) {
+    if (!conversation.projectPath) continue;
+    if (conversation.projectId) continue;
+    const projectId = pathToProjectId.get(canonicalizeProjectPath(conversation.projectPath));
+    if (!projectId) continue;
+    conversationsRepo.updateConversationProjectId({
+      conversationId: conversation.id,
+      projectId
+    });
+    conversationsBackfilled += 1;
+  }
+  const latest = conversationsRepo.getLatestConversation();
+  if (latest) {
+    setCacheMetadata(cacheMetadataRepo, "last_conversation_id", latest.id);
+    if (latest.lastActivity) {
+      setCacheMetadata(cacheMetadataRepo, "last_conversation_created_at", latest.lastActivity);
+    }
+  }
+  setCacheMetadata(cacheMetadataRepo, "conversations_last_indexed_at", (/* @__PURE__ */ new Date()).toISOString());
+  return {
+    projectsTouched: pathToProjectId.size,
+    conversationsBackfilled,
+    latestConversationId: latest?.id ?? null
+  };
+}
+
+// src/services/conversations/shouldRefreshProjectsFromHdd.ts
+import { readdirSync as readdirSync5, statSync as statSync7 } from "fs";
+import { homedir as homedir8 } from "os";
+import { join as join16 } from "path";
+var DEFAULT_PROJECTS_DIR = join16(homedir8(), ".claude", "projects");
+function maxProjectsTreeMtimeMs(projectsDir) {
+  let maxMs;
+  try {
+    maxMs = statSync7(projectsDir).mtimeMs;
+  } catch {
+    return null;
+  }
+  try {
+    for (const ent of readdirSync5(projectsDir, { withFileTypes: true })) {
+      if (!ent.isDirectory()) continue;
+      try {
+        const childMs = statSync7(join16(projectsDir, ent.name)).mtimeMs;
+        if (childMs > maxMs) maxMs = childMs;
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return maxMs;
+}
+function shouldRefreshProjectsFromHdd(conversationsRepo, cacheMetadataRepo, opts = {}) {
+  if (conversationsRepo.hasOrphanRows()) return true;
+  const dirs = /* @__PURE__ */ new Set();
+  if (opts.projectsDirs) {
+    for (const d of opts.projectsDirs) dirs.add(d);
+  }
+  dirs.add(opts.projectsDir ?? DEFAULT_PROJECTS_DIR);
+  let newestMs = null;
+  for (const dir of dirs) {
+    const ms = maxProjectsTreeMtimeMs(dir);
+    if (ms === null) continue;
+    if (newestMs === null || ms > newestMs) newestMs = ms;
+  }
+  if (newestMs === null) return false;
+  const lastIndexedIso = getCacheMetadata(cacheMetadataRepo, "conversations_last_indexed_at");
+  if (!lastIndexedIso) return true;
+  const lastIndexedMs = Date.parse(lastIndexedIso);
+  if (Number.isNaN(lastIndexedMs)) return true;
+  return newestMs > lastIndexedMs;
+}
+
 // src/services/projectChats/deriveProjectChatTitle.ts
 function deriveProjectChatTitle(input) {
   const trimmed = input.title?.trim();
@@ -6121,7 +6263,7 @@ function resolveAnswer(pending, body) {
 }
 
 // src/services/sessions/conversationBusy.ts
-import { statSync as statSync7 } from "fs";
+import { statSync as statSync8 } from "fs";
 var RESUME_BUSY_WINDOW_MS = 12e4;
 function resolveResumeBusyWindowMs(env = process.env) {
   const raw = env.THREADBASE_RESUME_BUSY_WINDOW_MS;
@@ -6138,7 +6280,7 @@ function conversationBusy(input) {
   let lastActivityMs = null;
   if (input.jsonlPath) {
     try {
-      const mtimeMs = statSync7(input.jsonlPath).mtimeMs;
+      const mtimeMs = statSync8(input.jsonlPath).mtimeMs;
       const age = now - mtimeMs;
       lastActivityMs = Math.max(0, age);
       const isSelfEcho = input.selfPtyEndedAt != null && mtimeMs <= input.selfPtyEndedAt + SELF_ACTIVITY_SKEW_MS;
@@ -6366,7 +6508,7 @@ function discoveredToResponse(d, conversationId) {
 import { randomBytes as randomBytes3 } from "crypto";
 import { mkdir as mkdir3, writeFile } from "fs/promises";
 import heicConvert from "heic-convert";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 var UPLOAD_DIR_NAME = ".threadbase-uploads";
 var MAX_BYTES = 25 * 1024 * 1024;
 var HEIC_MIMES = /* @__PURE__ */ new Set(["image/heic", "image/heif"]);
@@ -6399,9 +6541,9 @@ async function saveUploadFile(input) {
   }
   const id = `up_${randomBytes3(8).toString("hex")}`;
   const safeName = sanitizeFilename(originalName) || `file${MIME_TO_EXT[mimeType] ?? ""}`;
-  const dir = join16(input.projectPath, UPLOAD_DIR_NAME, input.sessionId);
+  const dir = join17(input.projectPath, UPLOAD_DIR_NAME, input.sessionId);
   await mkdir3(dir, { recursive: true });
-  const filePath = join16(dir, `${Date.now()}-${id}-${safeName}`);
+  const filePath = join17(dir, `${Date.now()}-${id}-${safeName}`);
   await writeFile(filePath, buffer);
   return {
     id,
@@ -6511,14 +6653,6 @@ function computeConversationEtag({
   return `"${digest}"`;
 }
 
-// src/utils/dates.ts
-import { compareDesc, isValid, parseISO } from "date-fns";
-function parseIsoDateOrNull(value) {
-  if (!value) return null;
-  const parsed = parseISO(value);
-  return isValid(parsed) ? parsed : null;
-}
-
 // src/utils/isScannedSnapshotStale.ts
 var STALENESS_TOLERANCE_MS = 1e3;
 function isScannedSnapshotStale(snapshotTimestamp, fileMtimeMs) {
@@ -6819,13 +6953,13 @@ var StreamerServer = class {
     this.disableDb = config.disableDb ?? false;
     this.scannerPersistenceDisabled = config.scannerPersistent === false;
     this.scanProfiles = config.scanProfiles;
-    this.codexRoots = config.codexRoots ?? [join17(homedir8(), ".codex", "sessions")];
+    this.codexRoots = config.codexRoots ?? [join18(homedir9(), ".codex", "sessions")];
     this.ptyGracePeriodMs = config.ptyGracePeriodMs ?? DEFAULT_PTY_GRACE_PERIOD_MS;
     this.defaultSystemPrompt = config.defaultSystemPrompt ?? DEFAULT_SYSTEM_PROMPT;
     this.defaultPermissionMode = config.defaultPermissionMode ?? loadDefaultPermissionMode() ?? "acceptEdits";
     this.defaultModel = config.defaultModel ?? "sonnet";
     this.defaultEffort = config.defaultEffort ?? "low";
-    this.cacheDir = config.cacheDir ?? loadCacheDir() ?? join17(homedir8(), ".threadbase", "cache");
+    this.cacheDir = config.cacheDir ?? loadCacheDir() ?? join18(homedir9(), ".threadbase", "cache");
     this.tailSize = config.tailSize ?? loadTailSize() ?? 10;
     this.directoryDebounceMs = parseDirScanDebounceEnv(process.env.THREADBASE_DIR_SCAN_DEBOUNCE_MS) ?? config.directoryScanDebounceMs ?? 1e3;
     this.markScannerStaleDebounced = debounce(() => {
@@ -6866,7 +7000,7 @@ var StreamerServer = class {
           const seqs = cache.extendMessageIndex(
             filePath,
             spans,
-            statSync8(filePath),
+            statSync9(filePath),
             readFrom,
             endOffset
           );
@@ -7032,7 +7166,7 @@ var StreamerServer = class {
         temporalClient,
         taskQueue: agentConfig.temporal.taskQueue
       });
-      const conversationsBaseDir = agentConfig.conversationsDir || join17(dirname9(this.cacheDir), "conversations");
+      const conversationsBaseDir = agentConfig.conversationsDir || join18(dirname9(this.cacheDir), "conversations");
       conversationWriter = createConversationWriter({
         baseDir: conversationsBaseDir
       });
@@ -7355,7 +7489,7 @@ var StreamerServer = class {
         });
         try {
           this.cache = ConversationCache.open(
-            join17(this.cacheDir, "cache.db"),
+            join18(this.cacheDir, "cache.db"),
             this.tailSize,
             void 0,
             {
@@ -7481,6 +7615,20 @@ var StreamerServer = class {
               count: pruned.length,
               event: "cache.prune_ghosts"
             });
+            if (this.projectsRepo && this.conversationsRepo && this.cacheMetadataRepo) {
+              refreshConversationCache({
+                cache: this.cache,
+                projectsRepo: this.projectsRepo,
+                conversationsRepo: this.conversationsRepo,
+                cacheMetadataRepo: this.cacheMetadataRepo
+              });
+            } else if (this.cacheMetadataRepo) {
+              setCacheMetadata(
+                this.cacheMetadataRepo,
+                "conversations_last_indexed_at",
+                (/* @__PURE__ */ new Date()).toISOString()
+              );
+            }
           }
         }).catch((err) => {
           const message = err instanceof Error ? err.message : String(err);
@@ -7720,6 +7868,56 @@ var StreamerServer = class {
   checkSessionInputRateLimit(sessionId) {
     return this.checkRateLimit(this.sessionInputAttempts, sessionId, 500, 6e4);
   }
+  /** Project roots watched for conversation JSONLs (profiles or ~/.claude/projects). */
+  projectsDirsForFreshnessCheck() {
+    if (this.scanProfiles && this.scanProfiles.length > 0) {
+      return this.scanProfiles.filter((p) => p.enabled).map((p) => join18(p.configDir, "projects"));
+    }
+    return [join18(homedir9(), ".claude", "projects")];
+  }
+  /**
+   * Full-glob scan + cache upsert/delete reconcile. Used by ?refresh=1 and by
+   * the automatic freshness path when the directory watcher marked the scanner
+   * stale or shouldRefreshProjectsFromHdd detected disk drift.
+   */
+  async reconcileConversationsCacheFromDisk() {
+    if (!this.cache) return;
+    const scanner = await this.rescanForRefresh();
+    const metas = [...scanner.getMetadataCache().values()];
+    try {
+      this.cache.upsertFromScannerMeta(metas);
+      if (!this.cacheMonitor?.pending) {
+        this.cache.reconcileDeletions(canonicalLivePathSet(metas));
+      }
+      if (this.projectsRepo && this.conversationsRepo && this.cacheMetadataRepo) {
+        refreshConversationCache({
+          cache: this.cache,
+          projectsRepo: this.projectsRepo,
+          conversationsRepo: this.conversationsRepo,
+          cacheMetadataRepo: this.cacheMetadataRepo
+        });
+      } else if (this.cacheMetadataRepo) {
+        setCacheMetadata(
+          this.cacheMetadataRepo,
+          "conversations_last_indexed_at",
+          (/* @__PURE__ */ new Date()).toISOString()
+        );
+      }
+    } catch (err) {
+      this.log.warn(
+        `refresh reconcile failed: ${err instanceof Error ? err.message : String(err)}`,
+        { event: "conversations.reconcile_failed" }
+      );
+    }
+  }
+  shouldAutoReconcileConversationList() {
+    if (!this.cache) return false;
+    if (this.scannerStale) return true;
+    if (!this.conversationsRepo || !this.cacheMetadataRepo) return false;
+    return shouldRefreshProjectsFromHdd(this.conversationsRepo, this.cacheMetadataRepo, {
+      projectsDirs: this.projectsDirsForFreshnessCheck()
+    });
+  }
   async handleListConversations(url, res) {
     if (this.rejectIfWarmingUp(res)) return;
     const limit = intParam(url, "limit", 50);
@@ -7728,19 +7926,14 @@ var StreamerServer = class {
     const project = url.searchParams.get("project") ?? void 0;
     const providerFilter = url.searchParams.get("provider") ?? void 0;
     const bustCache = url.searchParams.get("refresh") === "1";
-    if (bustCache && this.cache) {
-      const scanner2 = await this.withWarmup("conversation_refresh", () => this.rescanForRefresh());
-      const metas2 = [...scanner2.getMetadataCache().values()];
-      try {
-        this.cache.upsertFromScannerMeta(metas2);
-        if (!this.cacheMonitor?.pending) {
-          this.cache.reconcileDeletions(canonicalLivePathSet(metas2));
-        }
-      } catch (err) {
-        this.log.warn(
-          `refresh reconcile failed: ${err instanceof Error ? err.message : String(err)}`,
-          { event: "conversations.reconcile_failed" }
+    if (this.cache && (bustCache || this.shouldAutoReconcileConversationList())) {
+      if (bustCache) {
+        await this.withWarmup(
+          "conversation_refresh",
+          () => this.reconcileConversationsCacheFromDisk()
         );
+      } else {
+        await this.reconcileConversationsCacheFromDisk();
       }
     }
     if (this.cache) {
@@ -8002,21 +8195,21 @@ var StreamerServer = class {
    */
   projectsDirs() {
     if (this.scanProfiles && this.scanProfiles.length > 0) {
-      return this.scanProfiles.filter((p) => p.enabled).map((p) => join17(p.configDir, "projects"));
+      return this.scanProfiles.filter((p) => p.enabled).map((p) => join18(p.configDir, "projects"));
     }
-    return [join17(homedir8(), ".claude", "projects")];
+    return [join18(homedir9(), ".claude", "projects")];
   }
   findJsonlPath(uuid) {
     const filename = `${uuid}.jsonl`;
     for (const projectsDir of this.projectsDirs()) {
       if (!existsSync10(projectsDir)) continue;
-      for (const dir of readdirSync5(projectsDir)) {
-        const fp = join17(projectsDir, dir, filename);
+      for (const dir of readdirSync6(projectsDir)) {
+        const fp = join18(projectsDir, dir, filename);
         if (existsSync10(fp)) return fp;
-        const projectDir = join17(projectsDir, dir);
+        const projectDir = join18(projectsDir, dir);
         try {
-          for (const sub of readdirSync5(projectDir)) {
-            const subagentPath = join17(projectDir, sub, "subagents", filename);
+          for (const sub of readdirSync6(projectDir)) {
+            const subagentPath = join18(projectDir, sub, "subagents", filename);
             if (existsSync10(subagentPath)) return subagentPath;
           }
         } catch {
@@ -8117,7 +8310,7 @@ var StreamerServer = class {
     if (this.isManagedTailPath(key)) return;
     let mtimeMs;
     try {
-      mtimeMs = statSync8(filePath).mtimeMs;
+      mtimeMs = statSync9(filePath).mtimeMs;
     } catch {
       return;
     }
@@ -8299,7 +8492,7 @@ var StreamerServer = class {
     if (!conv.filePath) return false;
     let mtimeMs = null;
     try {
-      mtimeMs = statSync8(conv.filePath).mtimeMs;
+      mtimeMs = statSync9(conv.filePath).mtimeMs;
     } catch {
       return false;
     }
@@ -9219,7 +9412,7 @@ var StreamerServer = class {
         sessionStore: this.sessionStore,
         // biome-ignore lint/style/noNonNullAssertion: agentClient is set when agentConfig.enabled is true
         agentClient: this.agentClient,
-        conversationsDir: this.cacheDir ? join17(dirname9(this.cacheDir), "conversations") : "",
+        conversationsDir: this.cacheDir ? join18(dirname9(this.cacheDir), "conversations") : "",
         agentConfig: this.agentConfig
       });
       json(res, result.status, result.body);
@@ -9378,9 +9571,9 @@ var StreamerServer = class {
   // was passed to Claude via --session-id so the filename matches from the start.
   watchForJsonl(sessionId, projectPath) {
     const encoded = projectPath.replace(/[/\\:.]/g, "-");
-    const projectsDir = join17(homedir8(), ".claude", "projects", encoded);
+    const projectsDir = join18(homedir9(), ".claude", "projects", encoded);
     const expectedFile = `${sessionId}.jsonl`;
-    const filePath = join17(projectsDir, expectedFile);
+    const filePath = join18(projectsDir, expectedFile);
     const deadline = Date.now() + 12e4;
     let watcher = null;
     const cleanup = () => {
@@ -9402,10 +9595,10 @@ var StreamerServer = class {
       if (!resolvedFilePath && existsSync10(projectsDir)) {
         try {
           const now = Date.now();
-          const match = readdirSync5(projectsDir).filter((f) => f.endsWith(".jsonl")).map((f) => ({ f, mtime: statSync8(join17(projectsDir, f)).mtimeMs })).filter(({ mtime }) => now - mtime < 5e3).filter(
-            ({ f }) => basename5(f, ".jsonl") === sessionId || this.readFirstLineSessionId(join17(projectsDir, f)) === sessionId
+          const match = readdirSync6(projectsDir).filter((f) => f.endsWith(".jsonl")).map((f) => ({ f, mtime: statSync9(join18(projectsDir, f)).mtimeMs })).filter(({ mtime }) => now - mtime < 5e3).filter(
+            ({ f }) => basename5(f, ".jsonl") === sessionId || this.readFirstLineSessionId(join18(projectsDir, f)) === sessionId
           ).sort((a, b) => b.mtime - a.mtime)[0];
-          if (match) resolvedFilePath = join17(projectsDir, match.f);
+          if (match) resolvedFilePath = join18(projectsDir, match.f);
         } catch {
         }
       }
@@ -9453,7 +9646,7 @@ var StreamerServer = class {
   watchForCodexRollout(sessionId, projectPath) {
     const deadline = Date.now() + 12e4;
     const now = /* @__PURE__ */ new Date();
-    const dateDir = join17(
+    const dateDir = join18(
       String(now.getFullYear()),
       String(now.getMonth() + 1).padStart(2, "0"),
       String(now.getDate()).padStart(2, "0")
@@ -9494,18 +9687,18 @@ var StreamerServer = class {
         this.sessionStore.listManaged().filter((s) => s.id !== sessionId && s.boundConversationId != null).map((s) => s.boundConversationId)
       );
       for (const root of this.codexRoots) {
-        const sessionsDir = join17(root, dateDir);
+        const sessionsDir = join18(root, dateDir);
         if (!existsSync10(sessionsDir)) continue;
         let candidateFiles;
         try {
-          candidateFiles = readdirSync5(sessionsDir).filter((f) => f.endsWith(".jsonl"));
+          candidateFiles = readdirSync6(sessionsDir).filter((f) => f.endsWith(".jsonl"));
         } catch {
           continue;
         }
         const nowMs = Date.now();
-        const recentCandidates = candidateFiles.map((f) => ({ f, mtime: statSync8(join17(sessionsDir, f)).mtimeMs })).filter(({ mtime }) => nowMs - mtime < 1e4).sort((a, b) => b.mtime - a.mtime);
+        const recentCandidates = candidateFiles.map((f) => ({ f, mtime: statSync9(join18(sessionsDir, f)).mtimeMs })).filter(({ mtime }) => nowMs - mtime < 1e4).sort((a, b) => b.mtime - a.mtime);
         for (const { f } of recentCandidates) {
-          const candidatePath = join17(sessionsDir, f);
+          const candidatePath = join18(sessionsDir, f);
           const match = matchesProjectPath(candidatePath);
           if (!match) continue;
           if (boundElsewhere.has(match.id)) continue;