@remnic/core 9.3.645 → 9.3.647

package/dist/{chunk-IHG27THY.js → chunk-XUGQQPGO.js}

@@ -1,12 +1,11 @@
+import {
+  sessionStoragePaths
+} from "./chunk-S4DDLTPX.js";
 import {
   analyzeSessionIntegrity
 } from "./chunk-KFY3SGN7.js";
 import {
-  encodeStoragePathSegment,
-  encodeStoragePathSegmentWithHash,
-  isSafeLegacyPathSegment,
-  resolveSafeStoragePath,
-  storagePathHash
+  resolveSafeStoragePath
 } from "./chunk-FF4KLI5W.js";
 import {
   log
@@ -15,12 +14,13 @@ import {
 // src/transcript.ts
 import { appendFile, mkdir, readdir, readFile, stat, unlink, writeFile } from "fs/promises";
 import path from "path";
-function legacyTranscriptDirFor(channelType, channelId, encodedDir) {
-  if (!isSafeLegacyPathSegment(channelType) || !isSafeLegacyPathSegment(channelId)) {
-    return void 0;
-  }
-  const legacyDir = path.join(channelType, channelId);
-  return legacyDir === encodedDir ? void 0 : legacyDir;
+function makeRawLineDeduper() {
+  const seen = /* @__PURE__ */ new Set();
+  return (rawLine) => {
+    if (seen.has(rawLine)) return false;
+    seen.add(rawLine);
+    return true;
+  };
 }
 var TranscriptManager = class _TranscriptManager {
   transcriptsDir;
@@ -42,50 +42,31 @@ var TranscriptManager = class _TranscriptManager {
     this.toolUsageDir = path.join(this.stateDir, "tool-usage");
   }
   /**
-   * Parse a sessionKey to extract channel type and ID.
+   * Resolve the storage path pieces for a sessionKey via the shared
+   * {@link sessionStoragePaths} helper (issue #1496, rule #22).
    *
-   * SessionKey patterns:
-   *   - agent:<agent-id>:main → type="main", id="default"
-   *   - agent:<agent-id>:discord:channel:<channel-id> → type="discord", id="<channel-id>"
-   *   - agent:<agent-id>:cron:<job-id> → type="cron", id="<job-id>"
-   *   - agent:<agent-id>:slack:channel:<channel-id> → type="slack", id="<channel-id>"
+   * Legacy `agent:<id>:...` shapes keep their existing readable channel paths.
+   * Arbitrary / non-legacy keys (e.g. `pi-geek:abc123`) route to
+   * `transcripts/session/<hash>/YYYY-MM-DD.jsonl` from the FIRST write — they
+   * never start life in `other/default`. For those keys a list of
+   * read-back-only `readbackDirs` is returned so data written by older builds
+   * (under `other/default`, or under an old `parts.length >= 3` directory such
+   * as `baz/default`) stays discoverable until migrated. New writes never
+   * target read-back dirs. See `session-identity.ts`.
    *
    * @returns Object with raw channel identifiers and encoded storage path pieces.
    */
   getTranscriptPath(sessionKey) {
-    const parts = sessionKey.split(":");
-    let channelType = "other";
-    let channelId = "default";
-    if (parts.length >= 3) {
-      channelType = parts[2];
-      if (channelType === "main") {
-        channelId = "default";
-      } else if (channelType === "discord" && parts.length >= 5 && parts[3] === "channel") {
-        channelId = parts[4];
-      } else if (channelType === "slack" && parts.length >= 5 && parts[3] === "channel") {
-        channelId = parts[4];
-      } else if (channelType === "cron" && parts.length >= 4) {
-        channelId = parts[3];
-      } else if (parts.length >= 4) {
-        channelId = parts[3];
-      }
-    }
+    const paths = sessionStoragePaths(sessionKey);
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const dir = path.join(
-      encodeStoragePathSegment(channelType),
-      encodeStoragePathSegment(channelId)
-    );
-    const alternateDir = path.join(
-      encodeStoragePathSegmentWithHash(channelType),
-      `${encodeStoragePathSegmentWithHash(channelId)}--session-${storagePathHash(sessionKey)}`
-    );
     return {
-      dir,
+      dir: paths.dir,
       file: `${today}.jsonl`,
-      channelType,
-      channelId,
-      alternateDir,
-      legacyDir: legacyTranscriptDirFor(channelType, channelId, dir)
+      channelType: paths.channelType,
+      channelId: paths.channelId,
+      alternateDir: paths.alternateDir,
+      legacyDir: paths.legacyDir,
+      readbackDirs: paths.readbackDirs
     };
   }
   /**
@@ -136,7 +117,13 @@ var TranscriptManager = class _TranscriptManager {
   }
   getToolUsagePath(sessionKey) {
     const p = this.getTranscriptPath(sessionKey);
-    return { dir: p.dir, file: p.file, alternateDir: p.alternateDir, legacyDir: p.legacyDir };
+    return {
+      dir: p.dir,
+      file: p.file,
+      alternateDir: p.alternateDir,
+      legacyDir: p.legacyDir,
+      readbackDirs: p.readbackDirs
+    };
   }
   async selectStorageDirForWrite(root, dir, legacyDir, sessionKey, alternateDir) {
     const channelDir = await resolveSafeStoragePath(root, dir);
@@ -247,10 +234,10 @@ var TranscriptManager = class _TranscriptManager {
     } catch {
     }
   }
-  async getSessionStorageFiles(root, dir, legacyDir, alternateDir) {
+  async getSessionStorageFiles(root, dir, legacyDir, alternateDir, readbackDirs = []) {
     const files = [];
     const seenDirs = /* @__PURE__ */ new Set();
-    for (const candidateDir of [dir, alternateDir, legacyDir]) {
+    for (const candidateDir of [dir, alternateDir, legacyDir, ...readbackDirs]) {
       if (!candidateDir || seenDirs.has(candidateDir)) continue;
       seenDirs.add(candidateDir);
       let channelDir;
@@ -292,10 +279,17 @@ var TranscriptManager = class _TranscriptManager {
     await this.rememberDirectoryOwnership(this.toolUsageDir, writeDir, entry.sessionKey);
   }
   async readToolUse(sessionKey, startTime, endTime) {
-    const { dir, alternateDir, legacyDir } = this.getToolUsagePath(sessionKey);
+    const { dir, alternateDir, legacyDir, readbackDirs } = this.getToolUsagePath(sessionKey);
     try {
-      const files = await this.getSessionStorageFiles(this.toolUsageDir, dir, legacyDir, alternateDir);
+      const files = await this.getSessionStorageFiles(
+        this.toolUsageDir,
+        dir,
+        legacyDir,
+        alternateDir,
+        readbackDirs
+      );
       const out = [];
+      const keepRawLine = makeRawLineDeduper();
       for (const file of files) {
         const raw = await readFile(file.path, "utf-8");
         for (const line of raw.split("\n")) {
@@ -306,7 +300,7 @@ var TranscriptManager = class _TranscriptManager {
             if (!Number.isFinite(ts)) continue;
             if (ts >= startTime.getTime() && ts < endTime.getTime()) {
               if (typeof obj.tool === "string" && typeof obj.sessionKey === "string") {
-                if (obj.sessionKey === sessionKey) {
+                if (obj.sessionKey === sessionKey && keepRawLine(line)) {
                   out.push({ timestamp: obj.timestamp, sessionKey: obj.sessionKey, tool: obj.tool });
                 }
               }
@@ -321,10 +315,16 @@ var TranscriptManager = class _TranscriptManager {
     }
   }
   async estimateSessionFootprint(sessionKey) {
-    const { dir, alternateDir, legacyDir } = this.getTranscriptPath(sessionKey);
+    const { dir, alternateDir, legacyDir, readbackDirs } = this.getTranscriptPath(sessionKey);
     let bytes = 0;
     try {
-      const files = await this.getSessionStorageFiles(this.transcriptsDir, dir, legacyDir, alternateDir);
+      const files = await this.getSessionStorageFiles(
+        this.transcriptsDir,
+        dir,
+        legacyDir,
+        alternateDir,
+        readbackDirs
+      );
       const cached = this.sessionFootprintCache.get(sessionKey);
       if (!cached) {
         const fileBytes = /* @__PURE__ */ new Map();
@@ -489,11 +489,18 @@ var TranscriptManager = class _TranscriptManager {
    * Read transcript entries for a date range.
    * Returns entries within the time range, optionally filtered by sessionKey.
    * Reads from all channel subdirectories in the hierarchical structure.
+   *
+   * The window is half-open `[start, end)`: the upper bound is exclusive so
+   * caller-specified ranges (explicit dates, analytics buckets) don't
+   * double-count at shared boundaries (CLAUDE.md rule #35 / AGENTS.md rule 23).
+   * readRecent's inclusive-of-now behavior is handled by readRecent itself
+   * extending its end, not by relaxing this bound.
    */
   async readRange(startTime, endTime, sessionKey) {
     const start = new Date(startTime);
     const end = new Date(endTime);
     const entries = [];
+    const keepRawLine = sessionKey ? makeRawLineDeduper() : void 0;
     try {
       const transcriptFiles = await this.getAllTranscriptFiles();
       for (const relativePath of transcriptFiles) {
@@ -507,6 +514,7 @@ var TranscriptManager = class _TranscriptManager {
               const entryTime = new Date(entry.timestamp);
               if (entryTime >= start && entryTime < end) {
                 if (!sessionKey || entry.sessionKey === sessionKey) {
+                  if (keepRawLine && !keepRawLine(line)) continue;
                   entries.push(entry);
                 }
               }
@@ -532,8 +540,9 @@ var TranscriptManager = class _TranscriptManager {
    * specific channel instead of scanning all 95+ transcript files across all channels.
    */
   async readRecent(hours, sessionKey) {
-    const end = /* @__PURE__ */ new Date();
-    const start = new Date(end.getTime() - hours * 60 * 60 * 1e3);
+    const now = /* @__PURE__ */ new Date();
+    const end = new Date(now.getTime() + 1);
+    const start = new Date(now.getTime() - hours * 60 * 60 * 1e3);
     if (sessionKey) {
       return this.readRecentForSession(start, end, sessionKey);
     }
@@ -544,7 +553,7 @@ var TranscriptManager = class _TranscriptManager {
    * directory and only reads files whose date falls within the lookback window.
    */
   async readRecentForSession(start, end, sessionKey) {
-    const { dir, alternateDir, legacyDir } = this.getTranscriptPath(sessionKey);
+    const { dir, alternateDir, legacyDir, readbackDirs } = this.getTranscriptPath(sessionKey);
     const dateStrings = /* @__PURE__ */ new Set();
     const cursor = new Date(start);
     while (cursor <= end) {
@@ -553,7 +562,14 @@ var TranscriptManager = class _TranscriptManager {
     }
     dateStrings.add(end.toISOString().slice(0, 10));
     const entries = [];
-    const files = await this.getSessionStorageFiles(this.transcriptsDir, dir, legacyDir, alternateDir);
+    const files = await this.getSessionStorageFiles(
+      this.transcriptsDir,
+      dir,
+      legacyDir,
+      alternateDir,
+      readbackDirs
+    );
+    const keepRawLine = makeRawLineDeduper();
     for (const file of files) {
       const dateStr = file.name.slice(0, 10);
       if (!dateStrings.has(dateStr)) continue;
@@ -564,7 +580,7 @@ var TranscriptManager = class _TranscriptManager {
           try {
             const entry = JSON.parse(line);
             const ts = new Date(entry.timestamp);
-            if (ts >= start && ts < end && entry.sessionKey === sessionKey) {
+            if (ts >= start && ts < end && entry.sessionKey === sessionKey && keepRawLine(line)) {
               entries.push(entry);
             }
           } catch {
@@ -911,4 +927,4 @@ var TranscriptManager = class _TranscriptManager {
 export {
   TranscriptManager
 };
-//# sourceMappingURL=chunk-IHG27THY.js.map
+//# sourceMappingURL=chunk-XUGQQPGO.js.map

package/dist/chunk-XUGQQPGO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transcript.ts"],"sourcesContent":["import { appendFile, mkdir, readdir, readFile, stat, unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\nimport type { TranscriptEntry, Checkpoint, PluginConfig } from \"./types.js\";\nimport { analyzeSessionIntegrity, type SessionIntegrityReport } from \"./session-integrity.js\";\nimport { resolveSafeStoragePath } from \"./storage-paths.js\";\nimport { sessionStoragePaths } from \"./session-identity.js\";\n\ntype DirectorySessionStatus = \"missing\" | \"empty\" | \"matches\" | \"occupied\";\ntype DirectoryOwnershipCacheEntry = {\n  status: \"empty\" | \"matches\";\n  fileSizes: Map<string, number>;\n};\n\n/**\n * De-duplicate JSONL lines collected across multiple read-back candidate\n * directories. A partially-applied migration (issue #1496) can leave the SAME\n * raw row in both the primary `session/<hash>` tree and a legacy read-back dir\n * (`other/default` or an old `parts.length >= 3` directory) when the source was\n * copied but not yet trimmed. Without this guard, `readRecent`, `readToolUse`,\n * footprint estimation, and the summarizer fetch would return that row twice\n * (cursor review on PR #1504). The exact raw JSONL line is the stable identity:\n * the migration preserves byte content per session, so a copied-but-not-trimmed\n * row is byte-identical in both locations. Returns `true` the first time a line\n * is seen, `false` for every subsequent duplicate.\n */\nfunction makeRawLineDeduper(): (rawLine: string) => boolean {\n  const seen = new Set<string>();\n  return (rawLine: string): boolean => {\n    if (seen.has(rawLine)) return false;\n    seen.add(rawLine);\n    return true;\n  };\n}\n\n/**\n * Manages conversation transcript storage, checkpointing, and recall formatting.\n *\n * Transcripts are stored as JSONL files in a hierarchical structure:\n *   transcripts/{channelType}/{channelId}.jsonl\n *\n * Channel types are extracted from sessionKey (discord, slack, cron, main, etc.)\n * Checkpoints are used to preserve conversation context across compaction events.\n */\nexport class TranscriptManager {\n  private transcriptsDir: string;\n  private checkpointPath: string;\n  private stateDir: string;\n  private toolUsageDir: string;\n  private config: PluginConfig;\n  private sessionFootprintCache = new Map<\n    string,\n    { totalBytes: number; fileBytes: Map<string, number>; fileSizes: Map<string, number> }\n  >();\n  private directoryOwnershipCache = new Map<string, DirectoryOwnershipCacheEntry>();\n\n  /** Default checkpoint TTL in hours */\n  private static readonly DEFAULT_CHECKPOINT_TTL_HOURS = 24;\n  /** Approximate characters per token for rough estimation */\n  private static readonly CHARS_PER_TOKEN = 4;\n\n  constructor(config: PluginConfig) {\n    this.config = config;\n    this.transcriptsDir = path.join(config.memoryDir, \"transcripts\");\n    this.stateDir = path.join(config.memoryDir, \"state\");\n    this.checkpointPath = path.join(this.stateDir, \"checkpoint.json\");\n    this.toolUsageDir = path.join(this.stateDir, \"tool-usage\");\n  }\n\n  /**\n   * Resolve the storage path pieces for a sessionKey via the shared\n   * {@link sessionStoragePaths} helper (issue #1496, rule #22).\n   *\n   * Legacy `agent:<id>:...` shapes keep their existing readable channel paths.\n   * Arbitrary / non-legacy keys (e.g. `pi-geek:abc123`) route to\n   * `transcripts/session/<hash>/YYYY-MM-DD.jsonl` from the FIRST write — they\n   * never start life in `other/default`. For those keys a list of\n   * read-back-only `readbackDirs` is returned so data written by older builds\n   * (under `other/default`, or under an old `parts.length >= 3` directory such\n   * as `baz/default`) stays discoverable until migrated. New writes never\n   * target read-back dirs. See `session-identity.ts`.\n   *\n   * @returns Object with raw channel identifiers and encoded storage path pieces.\n   */\n  getTranscriptPath(sessionKey: string): {\n    dir: string;\n    file: string;\n    channelType: string;\n    channelId: string;\n    alternateDir: string;\n    legacyDir?: string;\n    readbackDirs: string[];\n  } {\n    const paths = sessionStoragePaths(sessionKey);\n\n    // Daily rotation: transcripts/{channelType}/{channelId}/YYYY-MM-DD.jsonl\n    const today = new Date().toISOString().slice(0, 10);\n\n    return {\n      dir: paths.dir,\n      file: `${today}.jsonl`,\n      channelType: paths.channelType,\n      channelId: paths.channelId,\n      alternateDir: paths.alternateDir,\n      legacyDir: paths.legacyDir,\n      readbackDirs: paths.readbackDirs,\n    };\n  }\n\n  /**\n   * Initialize the transcript manager by ensuring directories exist.\n   */\n  async initialize(): Promise<void> {\n    await mkdir(this.transcriptsDir, { recursive: true });\n    await mkdir(this.stateDir, { recursive: true });\n    await mkdir(this.toolUsageDir, { recursive: true });\n    log.info(\"transcript manager initialized\");\n  }\n\n  /**\n   * Best-effort list of sessionKeys that have transcript files on disk.\n   * This is used by cron-style tooling (hourly summaries, conversation indexing)\n   * to iterate across \"active\" sessions.\n   */\n  async listSessionKeys(): Promise<string[]> {\n    const transcriptDir = this.transcriptsDir;\n    const sessionKeys = new Set<string>();\n\n    try {\n      const typeEntries = await readdir(transcriptDir, { withFileTypes: true });\n      for (const typeEnt of typeEntries) {\n        if (!typeEnt.isDirectory()) continue;\n        const typeDir = path.join(transcriptDir, typeEnt.name);\n        const idEntries = await readdir(typeDir, { withFileTypes: true });\n        for (const idEnt of idEntries) {\n          if (!idEnt.isDirectory()) continue;\n          const chanDir = path.join(typeDir, idEnt.name);\n          const files = (await readdir(chanDir)).filter((f) => f.endsWith(\".jsonl\")).sort();\n          const last = files[files.length - 1];\n          if (!last) continue;\n          try {\n            const raw = await readFile(path.join(chanDir, last), \"utf-8\");\n            const firstLine = raw.split(\"\\n\").find((l) => l.trim().length > 0);\n            if (!firstLine) continue;\n            const entry = JSON.parse(firstLine) as TranscriptEntry;\n            if (typeof entry.sessionKey === \"string\" && entry.sessionKey.length > 0) {\n              sessionKeys.add(entry.sessionKey);\n            }\n          } catch {\n            // ignore\n          }\n        }\n      }\n    } catch {\n      return [];\n    }\n\n    return Array.from(sessionKeys);\n  }\n\n  getToolUsagePath(sessionKey: string): {\n    dir: string;\n    file: string;\n    alternateDir: string;\n    legacyDir?: string;\n    readbackDirs: string[];\n  } {\n    const p = this.getTranscriptPath(sessionKey);\n    return {\n      dir: p.dir,\n      file: p.file,\n      alternateDir: p.alternateDir,\n      legacyDir: p.legacyDir,\n      readbackDirs: p.readbackDirs,\n    };\n  }\n\n  private async selectStorageDirForWrite(\n    root: string,\n    dir: string,\n    legacyDir?: string,\n    sessionKey?: string,\n    alternateDir?: string,\n  ): Promise<{ dir: string; channelDir: string }> {\n    const channelDir = await resolveSafeStoragePath(root, dir);\n    const encodedStatus = await this.directorySessionStatus(root, dir, sessionKey);\n    if (encodedStatus === \"matches\" || encodedStatus === \"empty\") return { dir, channelDir };\n\n    if (legacyDir) {\n      const legacyChannelDir = await resolveSafeStoragePath(root, legacyDir);\n      if ((await this.directorySessionStatus(root, legacyDir, sessionKey)) === \"matches\") {\n        return { dir: legacyDir, channelDir: legacyChannelDir };\n      }\n    }\n\n    if (encodedStatus === \"missing\") return { dir, channelDir };\n\n    if (alternateDir) {\n      const alternateChannelDir = await resolveSafeStoragePath(root, alternateDir);\n      const alternateStatus = await this.directorySessionStatus(root, alternateDir, sessionKey);\n      if (\n        alternateStatus === \"missing\" ||\n        alternateStatus === \"empty\" ||\n        alternateStatus === \"matches\"\n      ) {\n        return { dir: alternateDir, channelDir: alternateChannelDir };\n      }\n    }\n\n    throw new Error(`transcript storage path collision for session: ${sessionKey ?? \"(unknown)\"}`);\n  }\n\n  private async directorySessionStatus(\n    root: string,\n    dir: string,\n    sessionKey?: string,\n  ): Promise<DirectorySessionStatus> {\n    let channelDir: string;\n    try {\n      channelDir = await resolveSafeStoragePath(root, dir);\n      if (!(await stat(channelDir)).isDirectory()) return \"occupied\";\n    } catch (err) {\n      const code =\n        err && typeof err === \"object\" && \"code\" in err\n          ? (err as { code?: string }).code\n          : undefined;\n      if (code === \"ENOENT\") return \"missing\";\n      throw err;\n    }\n\n    let names: string[];\n    try {\n      names = (await readdir(channelDir)).filter((file) => file.endsWith(\".jsonl\"));\n    } catch {\n      return \"occupied\";\n    }\n\n    const fileSizes = await this.directoryJsonlFileSizes(root, dir, names);\n    if (!fileSizes) return \"occupied\";\n\n    if (!sessionKey) return \"matches\";\n    const cacheKey = this.directoryOwnershipCacheKey(root, dir, sessionKey);\n    const cached = this.directoryOwnershipCache.get(cacheKey);\n    if (cached && this.sameFileSizes(cached.fileSizes, fileSizes)) {\n      return cached.status;\n    }\n\n    let hasEntries = false;\n    let hasMatchingEntry = false;\n\n    for (const name of names) {\n      const filePath = await resolveSafeStoragePath(root, dir, name).catch(() => null);\n      if (filePath === null) return \"occupied\";\n      try {\n        const raw = await readFile(filePath, \"utf-8\");\n        for (const line of raw.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          hasEntries = true;\n          try {\n            const obj = JSON.parse(line) as { sessionKey?: string };\n            if (obj.sessionKey === sessionKey) {\n              hasMatchingEntry = true;\n            } else {\n              return \"occupied\";\n            }\n          } catch {\n            return \"occupied\";\n          }\n        }\n      } catch {\n        return \"occupied\";\n      }\n    }\n\n    const status = hasMatchingEntry ? \"matches\" : hasEntries ? \"occupied\" : \"empty\";\n    if (status === \"matches\" || status === \"empty\") {\n      this.directoryOwnershipCache.set(cacheKey, { status, fileSizes });\n    }\n    return status;\n  }\n\n  private directoryOwnershipCacheKey(root: string, dir: string, sessionKey: string): string {\n    return `${path.resolve(root)}\\0${dir}\\0${sessionKey}`;\n  }\n\n  private sameFileSizes(left: Map<string, number>, right: Map<string, number>): boolean {\n    if (left.size !== right.size) return false;\n    for (const [name, size] of left) {\n      if (right.get(name) !== size) return false;\n    }\n    return true;\n  }\n\n  private async directoryJsonlFileSizes(\n    root: string,\n    dir: string,\n    names: string[],\n  ): Promise<Map<string, number> | null> {\n    const fileSizes = new Map<string, number>();\n    for (const name of names) {\n      const filePath = await resolveSafeStoragePath(root, dir, name).catch(() => null);\n      if (filePath === null) return null;\n      const fileInfo = await stat(filePath).catch(() => null);\n      if (!fileInfo?.isFile()) return null;\n      fileSizes.set(name, Math.max(0, fileInfo.size));\n    }\n    return fileSizes;\n  }\n\n  private async rememberDirectoryOwnership(\n    root: string,\n    dir: string,\n    sessionKey: string,\n  ): Promise<void> {\n    try {\n      const channelDir = await resolveSafeStoragePath(root, dir);\n      const names = (await readdir(channelDir)).filter((file) => file.endsWith(\".jsonl\"));\n      const fileSizes = await this.directoryJsonlFileSizes(root, dir, names);\n      if (!fileSizes) return;\n      this.directoryOwnershipCache.set(\n        this.directoryOwnershipCacheKey(root, dir, sessionKey),\n        { status: \"matches\", fileSizes },\n      );\n    } catch {\n      // Cache refresh is best-effort; write path correctness does not depend on it.\n    }\n  }\n\n  private async getSessionStorageFiles(\n    root: string,\n    dir: string,\n    legacyDir?: string,\n    alternateDir?: string,\n    readbackDirs: string[] = [],\n  ): Promise<Array<{ cacheKey: string; name: string; path: string }>> {\n    const files: Array<{ cacheKey: string; name: string; path: string }> = [];\n    const seenDirs = new Set<string>();\n\n    for (const candidateDir of [dir, alternateDir, legacyDir, ...readbackDirs]) {\n      if (!candidateDir || seenDirs.has(candidateDir)) continue;\n      seenDirs.add(candidateDir);\n\n      let channelDir: string;\n      try {\n        channelDir = await resolveSafeStoragePath(root, candidateDir);\n      } catch {\n        continue;\n      }\n\n      let names: string[];\n      try {\n        names = (await readdir(channelDir)).filter((file) => file.endsWith(\".jsonl\")).sort();\n      } catch {\n        continue;\n      }\n\n      for (const name of names) {\n        const filePath = await resolveSafeStoragePath(root, candidateDir, name).catch(() => null);\n        if (filePath === null) continue;\n        files.push({\n          cacheKey: path.join(candidateDir, name),\n          name,\n          path: filePath,\n        });\n      }\n    }\n\n    return files.sort((a, b) => a.cacheKey.localeCompare(b.cacheKey));\n  }\n\n  async appendToolUse(entry: { timestamp: string; sessionKey: string; tool: string }): Promise<void> {\n    const { dir, file, alternateDir, legacyDir } = this.getToolUsagePath(entry.sessionKey);\n    const { dir: writeDir, channelDir } = await this.selectStorageDirForWrite(\n      this.toolUsageDir,\n      dir,\n      legacyDir,\n      entry.sessionKey,\n      alternateDir,\n    );\n    await mkdir(channelDir, { recursive: true });\n    const filePath = await resolveSafeStoragePath(this.toolUsageDir, writeDir, file);\n    await appendFile(filePath, JSON.stringify(entry) + \"\\n\", \"utf-8\");\n    await this.rememberDirectoryOwnership(this.toolUsageDir, writeDir, entry.sessionKey);\n  }\n\n  async readToolUse(\n    sessionKey: string,\n    startTime: Date,\n    endTime: Date,\n  ): Promise<Array<{ timestamp: string; sessionKey: string; tool: string }>> {\n    const { dir, alternateDir, legacyDir, readbackDirs } = this.getToolUsagePath(sessionKey);\n    try {\n      const files = await this.getSessionStorageFiles(\n        this.toolUsageDir,\n        dir,\n        legacyDir,\n        alternateDir,\n        readbackDirs,\n      );\n      const out: Array<{ timestamp: string; sessionKey: string; tool: string }> = [];\n      // Dedup identical raw rows that a partially-applied migration may have left\n      // in both the primary dir and a read-back dir (issue #1496, cursor review).\n      const keepRawLine = makeRawLineDeduper();\n      for (const file of files) {\n        const raw = await readFile(file.path, \"utf-8\");\n        for (const line of raw.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          try {\n            const obj = JSON.parse(line) as any;\n            const ts = new Date(String(obj.timestamp ?? \"\")).getTime();\n            if (!Number.isFinite(ts)) continue;\n            if (ts >= startTime.getTime() && ts < endTime.getTime()) {\n              if (typeof obj.tool === \"string\" && typeof obj.sessionKey === \"string\") {\n                if (obj.sessionKey === sessionKey && keepRawLine(line)) {\n                  out.push({ timestamp: obj.timestamp, sessionKey: obj.sessionKey, tool: obj.tool });\n                }\n              }\n            }\n          } catch {\n            // ignore\n          }\n        }\n      }\n      return out;\n    } catch {\n      return [];\n    }\n  }\n\n  async estimateSessionFootprint(sessionKey: string): Promise<{ bytes: number; tokens: number }> {\n    const { dir, alternateDir, legacyDir, readbackDirs } = this.getTranscriptPath(sessionKey);\n    let bytes = 0;\n\n    // NOTE: this is a best-effort byte ESTIMATE for compaction sizing, not an\n    // exact row count, and is maintained via an incremental per-file cache. A\n    // copied-but-not-trimmed migration window (issue #1496) can transiently\n    // over-estimate by counting a duplicated row in both the primary and a\n    // read-back dir; that self-heals once the migration trims the source. The\n    // exact-once guarantee that matters for callers lives in readRecent /\n    // readToolUse / the summarizer fetch, which dedup by raw line.\n    try {\n      const files = await this.getSessionStorageFiles(\n        this.transcriptsDir,\n        dir,\n        legacyDir,\n        alternateDir,\n        readbackDirs,\n      );\n      const cached = this.sessionFootprintCache.get(sessionKey);\n      if (!cached) {\n        const fileBytes = new Map<string, number>();\n        const fileSizes = new Map<string, number>();\n        for (const file of files) {\n          try {\n            const fileInfo = await stat(file.path);\n            const sessionBytes = await this.estimateSessionBytesInFile(\n              file.path,\n              sessionKey,\n            );\n            fileBytes.set(file.cacheKey, sessionBytes);\n            fileSizes.set(file.cacheKey, Math.max(0, fileInfo.size));\n            bytes += sessionBytes;\n          } catch {\n            // fail-open\n          }\n        }\n        this.sessionFootprintCache.set(sessionKey, { totalBytes: bytes, fileBytes, fileSizes });\n      } else {\n        bytes = cached.totalBytes;\n        const seen = new Set(files.map((file) => file.cacheKey));\n\n        // Drop removed files from the cached total.\n        for (const [cachedFile, cachedSessionBytes] of cached.fileBytes.entries()) {\n          if (!seen.has(cachedFile)) {\n            bytes -= cachedSessionBytes;\n            cached.fileBytes.delete(cachedFile);\n            cached.fileSizes.delete(cachedFile);\n          }\n        }\n\n        // Read only newly discovered files.\n        for (const file of files) {\n          if (cached.fileBytes.has(file.cacheKey)) continue;\n          try {\n            const fileInfo = await stat(file.path);\n            const sessionBytes = await this.estimateSessionBytesInFile(file.path, sessionKey);\n            cached.fileBytes.set(file.cacheKey, sessionBytes);\n            cached.fileSizes.set(file.cacheKey, Math.max(0, fileInfo.size));\n            bytes += sessionBytes;\n          } catch {\n            // fail-open\n          }\n        }\n\n        // Recompute any shard whose file size changed. A session can have both\n        // encoded and legacy directories during migration, so path ordering does\n        // not reliably identify the file that can grow.\n        for (const file of files) {\n          try {\n            const fileInfo = await stat(file.path);\n            const size = Math.max(0, fileInfo.size);\n            const previousSessionBytes = cached.fileBytes.get(file.cacheKey) ?? 0;\n            const previousSize = cached.fileSizes.get(file.cacheKey) ?? -1;\n            if (size !== previousSize) {\n              const sessionBytes = await this.estimateSessionBytesInFile(file.path, sessionKey);\n              cached.fileBytes.set(file.cacheKey, sessionBytes);\n              cached.fileSizes.set(file.cacheKey, size);\n              bytes += sessionBytes - previousSessionBytes;\n            }\n          } catch {\n            // fail-open\n          }\n        }\n\n        if (bytes < 0) bytes = 0;\n        cached.totalBytes = bytes;\n      }\n    } catch {\n      // fail-open\n      this.sessionFootprintCache.delete(sessionKey);\n    }\n\n    return {\n      bytes,\n      tokens: Math.floor(bytes / TranscriptManager.CHARS_PER_TOKEN),\n    };\n  }\n\n  private async estimateSessionBytesInFile(filePath: string, sessionKey: string): Promise<number> {\n    try {\n      const raw = await readFile(filePath, \"utf-8\");\n      let total = 0;\n      for (const line of raw.split(\"\\n\")) {\n        if (!line.trim()) continue;\n        try {\n          const parsed = JSON.parse(line) as { sessionKey?: string };\n          if (parsed.sessionKey === sessionKey) {\n            total += Buffer.byteLength(`${line}\\n`, \"utf-8\");\n          }\n        } catch {\n          // fail-open for malformed lines\n        }\n      }\n      return total;\n    } catch {\n      return 0;\n    }\n  }\n\n  /**\n   * Check if a file is a legacy flat transcript file (YYYY-MM-DD.jsonl format).\n   */\n  private isLegacyTranscriptFile(filename: string): boolean {\n    return /^\\d{4}-\\d{2}-\\d{2}\\.jsonl$/.test(filename);\n  }\n\n  /**\n   * Append a turn to the appropriate transcript file.\n   * Files are stored hierarchically: transcripts/{channelType}/{channelId}.jsonl\n   *\n   * Skips channel types in config.transcriptSkipChannelTypes (e.g., \"cron\").\n   */\n  async append(entry: TranscriptEntry): Promise<void> {\n    try {\n      const { dir, file, channelType, alternateDir, legacyDir } = this.getTranscriptPath(entry.sessionKey);\n\n      // Skip if this channel type is in the skip list\n      if (this.config.transcriptSkipChannelTypes.includes(channelType)) {\n        return;\n      }\n\n      const { dir: writeDir, channelDir } = await this.selectStorageDirForWrite(\n        this.transcriptsDir,\n        dir,\n        legacyDir,\n        entry.sessionKey,\n        alternateDir,\n      );\n      const filePath = await resolveSafeStoragePath(this.transcriptsDir, writeDir, file);\n\n      // Ensure channel directory exists\n      await mkdir(channelDir, { recursive: true });\n\n      const line = JSON.stringify(entry) + \"\\n\";\n      await appendFile(filePath, line, \"utf-8\");\n      await this.rememberDirectoryOwnership(this.transcriptsDir, writeDir, entry.sessionKey);\n      log.debug(`appended transcript entry for ${entry.sessionKey}: ${entry.turnId}`);\n    } catch (err) {\n      log.error(\"failed to append transcript entry:\", err);\n      throw err;\n    }\n  }\n\n  /**\n   * Get all transcript files from the hierarchical directory structure.\n   * Recursively finds all .jsonl files in transcripts/{channelType}/{channelId}/ subdirectories.\n   */\n  private async getAllTranscriptFiles(): Promise<string[]> {\n    const files: string[] = [];\n\n    try {\n      const entries = await readdir(this.transcriptsDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.isDirectory()) {\n          // This is a channel type directory (discord, slack, cron, main, etc.)\n          const channelTypeDir = path.join(this.transcriptsDir, entry.name);\n          try {\n            const channelTypeEntries = await readdir(channelTypeDir, { withFileTypes: true });\n\n            for (const channelTypeEntry of channelTypeEntries) {\n              if (channelTypeEntry.isDirectory()) {\n                // This is a channel ID directory - contains daily transcript files\n                const channelDir = path.join(channelTypeDir, channelTypeEntry.name);\n                try {\n                  const channelFiles = await readdir(channelDir);\n                  for (const file of channelFiles) {\n                    if (file.endsWith(\".jsonl\")) {\n                      files.push(path.join(entry.name, channelTypeEntry.name, file));\n                    }\n                  }\n                } catch {\n                  // Skip unreadable directories\n                }\n              } else if (channelTypeEntry.isFile() && channelTypeEntry.name.endsWith(\".jsonl\")) {\n                // Legacy: channel type dir contains .jsonl files directly\n                files.push(path.join(entry.name, channelTypeEntry.name));\n              }\n            }\n          } catch {\n            // Skip unreadable directories\n          }\n        } else if (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n          // Legacy flat file - still include for backward compatibility\n          files.push(entry.name);\n        }\n      }\n    } catch {\n      // Directory doesn't exist or is unreadable\n    }\n\n    return files;\n  }\n\n  /**\n   * Read transcript entries for a date range.\n   * Returns entries within the time range, optionally filtered by sessionKey.\n   * Reads from all channel subdirectories in the hierarchical structure.\n   *\n   * The window is half-open `[start, end)`: the upper bound is exclusive so\n   * caller-specified ranges (explicit dates, analytics buckets) don't\n   * double-count at shared boundaries (CLAUDE.md rule #35 / AGENTS.md rule 23).\n   * readRecent's inclusive-of-now behavior is handled by readRecent itself\n   * extending its end, not by relaxing this bound.\n   */\n  async readRange(startTime: string, endTime: string, sessionKey?: string): Promise<TranscriptEntry[]> {\n    const start = new Date(startTime);\n    const end = new Date(endTime);\n    const entries: TranscriptEntry[] = [];\n\n    // When a sessionKey is given, a partially-applied #1496 migration can leave\n    // the SAME raw row in both the primary `session/<hash>` dir and a read-back\n    // dir (`other/default` or an old `parts.length >= 3` dir). `readRange` scans\n    // EVERY transcript file, so it would append that row once per directory.\n    // Dedup by exact raw line to give the same exact-once guarantee `readRecent`\n    // / `readToolUse` / the summarizer fetch already provide (cursor review on\n    // PR #1504). Only applied for the session-scoped path so unfiltered range\n    // scans (each file already enumerated once) keep their existing behavior.\n    const keepRawLine = sessionKey ? makeRawLineDeduper() : undefined;\n\n    try {\n      // Get all transcript files from the hierarchical structure\n      const transcriptFiles = await this.getAllTranscriptFiles();\n\n      // Read each relevant file\n      for (const relativePath of transcriptFiles) {\n        const filePath = path.join(this.transcriptsDir, relativePath);\n        try {\n          const content = await readFile(filePath, \"utf-8\");\n          const lines = content.trim().split(\"\\n\").filter(Boolean);\n\n          for (const line of lines) {\n            try {\n              const entry = JSON.parse(line) as TranscriptEntry;\n              const entryTime = new Date(entry.timestamp);\n\n              // Check if entry is within time range (half-open: exclusive end)\n              if (entryTime >= start && entryTime < end) {\n                // Filter by sessionKey if provided\n                if (!sessionKey || entry.sessionKey === sessionKey) {\n                  if (keepRawLine && !keepRawLine(line)) continue;\n                  entries.push(entry);\n                }\n              }\n            } catch {\n              // Skip malformed lines\n              log.debug(`skipped malformed transcript line in ${relativePath}`);\n            }\n          }\n        } catch {\n          // File doesn't exist or is unreadable - skip\n        }\n      }\n\n      // Sort by timestamp\n      entries.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n\n      log.debug(`read ${entries.length} transcript entries from ${transcriptFiles.length} file(s)`);\n      return entries;\n    } catch (err) {\n      log.error(\"failed to read transcript range:\", err);\n      return [];\n    }\n  }\n\n  /**\n   * Read the last N hours of transcript.\n   *\n   * Fast path: when sessionKey is given, reads only the 1-2 daily files for that\n   * specific channel instead of scanning all 95+ transcript files across all channels.\n   */\n  async readRecent(hours: number, sessionKey?: string): Promise<TranscriptEntry[]> {\n    const now = new Date();\n    // The recent-read window is inclusive of \"now\": a turn that is buffered and\n    // then immediately read back can carry the same millisecond timestamp as\n    // this read, so a half-open [start, now) filter would drop it. Extend the\n    // upper bound by 1ms so the exclusive [start, end) filters in\n    // readRecentForSession / readRange (which stay half-open for\n    // caller-specified ranges, CLAUDE.md rule #35) still capture an entry\n    // stamped at exactly \"now\". This is the only place the \"up to now\" boundary\n    // is widened; explicit ranges are unaffected.\n    const end = new Date(now.getTime() + 1);\n    const start = new Date(now.getTime() - hours * 60 * 60 * 1000);\n\n    if (sessionKey) {\n      return this.readRecentForSession(start, end, sessionKey);\n    }\n    return this.readRange(start.toISOString(), end.toISOString(), undefined);\n  }\n\n  /**\n   * Optimized read for a specific session: only looks in that session's channel\n   * directory and only reads files whose date falls within the lookback window.\n   */\n  private async readRecentForSession(\n    start: Date,\n    end: Date,\n    sessionKey: string,\n  ): Promise<TranscriptEntry[]> {\n    const { dir, alternateDir, legacyDir, readbackDirs } = this.getTranscriptPath(sessionKey);\n\n    // Build set of date strings that overlap with [start, end].\n    // Always include end's date to handle midnight-crossing lookbacks\n    // (e.g. start=23:30 yesterday, end=00:30 today).\n    const dateStrings = new Set<string>();\n    const cursor = new Date(start);\n    while (cursor <= end) {\n      dateStrings.add(cursor.toISOString().slice(0, 10));\n      cursor.setDate(cursor.getDate() + 1);\n    }\n    dateStrings.add(end.toISOString().slice(0, 10));\n\n    const entries: TranscriptEntry[] = [];\n    const files = await this.getSessionStorageFiles(\n      this.transcriptsDir,\n      dir,\n      legacyDir,\n      alternateDir,\n      readbackDirs,\n    );\n\n    // Dedup identical raw rows that a partially-applied migration may have left\n    // in both the primary dir and a read-back dir (issue #1496, cursor review).\n    const keepRawLine = makeRawLineDeduper();\n    for (const file of files) {\n      // Only read files whose date is within the window\n      const dateStr = file.name.slice(0, 10);\n      if (!dateStrings.has(dateStr)) continue;\n\n      try {\n        const content = await readFile(file.path, \"utf-8\");\n        for (const line of content.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          try {\n            const entry = JSON.parse(line) as TranscriptEntry;\n            const ts = new Date(entry.timestamp);\n            // Half-open window: exclusive end. readRecent widens its own end by\n            // 1ms so a just-written \"now\" entry is still captured here without\n            // relaxing this bound for direct callers (tests/transcript-boundary).\n            if (ts >= start && ts < end && entry.sessionKey === sessionKey && keepRawLine(line)) {\n              entries.push(entry);\n            }\n          } catch {\n            // skip malformed line\n          }\n        }\n      } catch {\n        // skip unreadable file\n      }\n    }\n\n    entries.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n    log.debug(`readRecentForSession: ${entries.length} entries from ${files.length} file(s) in ${dir}`);\n    return entries;\n  }\n\n  /**\n   * Cleanup old transcript entries that are older than retentionDays.\n   * For hierarchical structure, reads each file and rewrites without old entries.\n   * Legacy flat files are deleted if their date is older than retentionDays.\n   * Returns the number of files processed (cleaned or deleted).\n   */\n  async cleanup(retentionDays: number): Promise<number> {\n    if (retentionDays <= 0) {\n      log.warn(\"cleanup called with invalid retentionDays:\", retentionDays);\n      return 0;\n    }\n\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - retentionDays);\n    cutoff.setHours(0, 0, 0, 0);\n\n    let processed = 0;\n\n    try {\n      const entries = await readdir(this.transcriptsDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.isDirectory()) {\n          // This is a channel type directory (discord, slack, cron, main, etc.)\n          const channelTypeDir = path.join(this.transcriptsDir, entry.name);\n          try {\n            const channelTypeEntries = await readdir(channelTypeDir, { withFileTypes: true });\n\n            for (const channelTypeEntry of channelTypeEntries) {\n              if (channelTypeEntry.isDirectory()) {\n                // This is a channel ID directory - contains daily transcript files\n                const channelDir = path.join(channelTypeDir, channelTypeEntry.name);\n                try {\n                  const channelFiles = await readdir(channelDir);\n                  for (const file of channelFiles) {\n                    if (!file.endsWith(\".jsonl\")) continue;\n\n                    const filePath = path.join(channelDir, file);\n\n                    // Check if file is a daily transcript file (YYYY-MM-DD.jsonl)\n                    if (this.isLegacyTranscriptFile(file)) {\n                      const dateStr = file.slice(0, 10);\n                      const fileDate = new Date(dateStr);\n\n                      if (!isNaN(fileDate.getTime()) && fileDate < cutoff) {\n                        try {\n                          await unlink(filePath);\n                          processed++;\n                          log.debug(`deleted old daily transcript file: ${entry.name}/${channelTypeEntry.name}/${file}`);\n                        } catch (err) {\n                          log.error(`failed to delete transcript file ${filePath}:`, err);\n                        }\n                      }\n                    } else {\n                      // Legacy file in new structure - clean up old entries\n                      const cleaned = await this.cleanupTranscriptFile(filePath, cutoff);\n                      if (cleaned) {\n                        processed++;\n                      }\n                    }\n                  }\n                } catch (err) {\n                  log.debug(`failed to process channel directory ${entry.name}/${channelTypeEntry.name}:`, err);\n                }\n              } else if (channelTypeEntry.isFile() && channelTypeEntry.name.endsWith(\".jsonl\")) {\n                // Legacy: channel type dir contains .jsonl files directly\n                const filePath = path.join(channelTypeDir, channelTypeEntry.name);\n                const cleaned = await this.cleanupTranscriptFile(filePath, cutoff);\n                if (cleaned) {\n                  processed++;\n                }\n              }\n            }\n          } catch (err) {\n            log.debug(`failed to process channel type directory ${entry.name}:`, err);\n          }\n        } else if (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n          // Handle legacy flat files - delete if older than retentionDays\n          if (this.isLegacyTranscriptFile(entry.name)) {\n            const dateStr = entry.name.slice(0, 10);\n            const fileDate = new Date(dateStr);\n\n            if (!isNaN(fileDate.getTime()) && fileDate < cutoff) {\n              const filePath = path.join(this.transcriptsDir, entry.name);\n              try {\n                await unlink(filePath);\n                processed++;\n                log.debug(`deleted old legacy transcript file: ${entry.name}`);\n              } catch (err) {\n                log.error(`failed to delete legacy transcript file ${entry.name}:`, err);\n              }\n            }\n          }\n        }\n      }\n\n      if (processed > 0) {\n        log.info(`cleaned up ${processed} transcript file(s) older than ${retentionDays} days`);\n      }\n\n      return processed;\n    } catch (err) {\n      log.error(\"failed to cleanup old transcripts:\", err);\n      return 0;\n    }\n  }\n\n  /**\n   * Clean up old entries from a single transcript file.\n   * Reads the file, filters out entries older than cutoff, and rewrites if needed.\n   * Returns true if the file was processed (cleaned or deleted).\n   */\n  private async cleanupTranscriptFile(filePath: string, cutoff: Date): Promise<boolean> {\n    try {\n      const content = await readFile(filePath, \"utf-8\");\n      const lines = content.trim().split(\"\\n\").filter(Boolean);\n\n      const validLines: string[] = [];\n      let hasOldEntries = false;\n\n      for (const line of lines) {\n        try {\n          const entry = JSON.parse(line) as TranscriptEntry;\n          const entryTime = new Date(entry.timestamp);\n\n          if (entryTime >= cutoff) {\n            validLines.push(line);\n          } else {\n            hasOldEntries = true;\n          }\n        } catch {\n          // Keep malformed lines to avoid data loss\n          validLines.push(line);\n        }\n      }\n\n      if (validLines.length === 0) {\n        // No valid entries left, delete the file\n        try {\n          await unlink(filePath);\n          log.debug(`deleted empty transcript file: ${filePath}`);\n          return true;\n        } catch (err) {\n          log.error(`failed to delete empty transcript file ${filePath}:`, err);\n          return false;\n        }\n      }\n\n      if (hasOldEntries) {\n        // Rewrite file without old entries\n        await writeFile(filePath, validLines.join(\"\\n\") + \"\\n\", \"utf-8\");\n        log.debug(`cleaned old entries from transcript file: ${filePath}`);\n        return true;\n      }\n\n      // No old entries found, no action needed\n      return false;\n    } catch (err) {\n      // File doesn't exist or is unreadable\n      return false;\n    }\n  }\n\n  /**\n   * Save a checkpoint to preserve conversation context.\n   * Called when compaction is detected.\n   */\n  async saveCheckpoint(checkpoint: Checkpoint): Promise<void> {\n    try {\n      await writeFile(this.checkpointPath, JSON.stringify(checkpoint, null, 2), \"utf-8\");\n      log.info(`saved checkpoint for session ${checkpoint.sessionKey} with ${checkpoint.turns.length} turn(s)`);\n    } catch (err) {\n      log.error(\"failed to save checkpoint:\", err);\n      throw err;\n    }\n  }\n\n  /**\n   * Load a checkpoint if one exists and is not expired.\n   * Returns null if no checkpoint exists or if it has expired.\n   */\n  async loadCheckpoint(sessionKey?: string): Promise<Checkpoint | null> {\n    try {\n      const raw = await readFile(this.checkpointPath, \"utf-8\");\n      const checkpoint = JSON.parse(raw) as Checkpoint;\n\n      // Validate checkpoint structure\n      if (!checkpoint.sessionKey || !checkpoint.capturedAt || !checkpoint.ttl || !Array.isArray(checkpoint.turns)) {\n        log.warn(\"checkpoint file has invalid structure\");\n        return null;\n      }\n\n      // Check if checkpoint is for the requested session (if specified)\n      if (sessionKey && checkpoint.sessionKey !== sessionKey) {\n        log.debug(`checkpoint session mismatch: ${checkpoint.sessionKey} vs ${sessionKey}`);\n        return null;\n      }\n\n      // Check if checkpoint has expired\n      const ttl = new Date(checkpoint.ttl);\n      if (isNaN(ttl.getTime())) {\n        log.warn(\"checkpoint has invalid TTL format\");\n        return null;\n      }\n\n      if (ttl < new Date()) {\n        log.info(`checkpoint expired at ${checkpoint.ttl}`);\n        return null;\n      }\n\n      log.info(`loaded checkpoint with ${checkpoint.turns.length} turn(s), expires at ${checkpoint.ttl}`);\n      return checkpoint;\n    } catch (err) {\n      // File doesn't exist or is unreadable - that's fine\n      log.debug(\"no valid checkpoint found\");\n      return null;\n    }\n  }\n\n  /**\n   * Clear (delete) the checkpoint file.\n   * Called after successful injection of checkpoint context.\n   */\n  async clearCheckpoint(): Promise<void> {\n    try {\n      await unlink(this.checkpointPath);\n      log.info(\"cleared checkpoint\");\n    } catch (err) {\n      // File doesn't exist - that's fine\n      log.debug(\"no checkpoint to clear\");\n    }\n  }\n\n  /**\n   * Format entries for recall injection.\n   * Returns a formatted string suitable for injecting into agent context.\n   *\n   * Format:\n   * ## Recent Conversation (last X hours)\n   * [10:32] User: message content\n   * [10:33] Assistant: response content\n   *\n   * Content is trimmed to approximately maxTokens.\n   */\n  formatForRecall(entries: TranscriptEntry[], maxTokens: number): string {\n    if (entries.length === 0) {\n      return \"\";\n    }\n\n    const maxChars = maxTokens * TranscriptManager.CHARS_PER_TOKEN;\n    const lines: string[] = [];\n\n    // Calculate time range for header\n    const firstEntry = new Date(entries[0].timestamp);\n    const lastEntry = new Date(entries[entries.length - 1].timestamp);\n    const hoursDiff = Math.round((lastEntry.getTime() - firstEntry.getTime()) / (60 * 60 * 1000));\n\n    // Add header\n    if (hoursDiff < 1) {\n      lines.push(\"## Recent Conversation (last few minutes)\");\n    } else {\n      lines.push(`## Recent Conversation (last ${hoursDiff} hour${hoursDiff === 1 ? \"\" : \"s\"})`);\n    }\n    lines.push(\"\");\n\n    // Format each entry\n    const formattedEntries: string[] = [];\n    for (const entry of entries) {\n      const time = new Date(entry.timestamp);\n      const timeStr = time.toLocaleTimeString(\"en-US\", {\n        hour: \"2-digit\",\n        minute: \"2-digit\",\n        hour12: false,\n      });\n      const roleLabel = entry.role === \"user\" ? \"User\" : \"Assistant\";\n      formattedEntries.push(`[${timeStr}] ${roleLabel}: ${entry.content}`);\n    }\n\n    // Build output, trimming from the beginning if too long\n    // (we want to keep the most recent context)\n    let totalChars = lines.join(\"\\n\").length;\n    const selectedEntries: string[] = [];\n\n    for (let i = formattedEntries.length - 1; i >= 0; i--) {\n      const entry = formattedEntries[i];\n      const entryChars = entry.length + 1; // +1 for newline\n\n      if (totalChars + entryChars > maxChars && selectedEntries.length > 0) {\n        // Adding this entry would exceed limit, and we have some entries already\n        break;\n      }\n\n      selectedEntries.unshift(entry);\n      totalChars += entryChars;\n    }\n\n    lines.push(...selectedEntries);\n    lines.push(\"\"); // Trailing newline\n\n    const result = lines.join(\"\\n\");\n    log.debug(`formatted ${selectedEntries.length}/${entries.length} transcript entries for recall (~${result.length} chars)`);\n\n    return result;\n  }\n\n  /**\n   * Create a checkpoint from the current buffer state.\n   * Helper method for creating checkpoints before compaction.\n   */\n  createCheckpoint(sessionKey: string, turns: TranscriptEntry[], ttlHours?: number): Checkpoint {\n    const ttl = ttlHours ?? TranscriptManager.DEFAULT_CHECKPOINT_TTL_HOURS;\n    const expiresAt = new Date();\n    expiresAt.setHours(expiresAt.getHours() + ttl);\n\n    return {\n      sessionKey,\n      capturedAt: new Date().toISOString(),\n      turns: [...turns], // Copy turns to avoid mutation\n      ttl: expiresAt.toISOString(),\n    };\n  }\n\n  /**\n   * Get statistics about stored transcripts.\n   * Returns counts from the hierarchical directory structure.\n   */\n  async getStats(): Promise<{\n    totalFiles: number;\n    totalEntries: number;\n    oldestFile: string | null;\n    newestFile: string | null;\n    channelTypes: Record<string, number>;\n  }> {\n    try {\n      const allFiles = await this.getAllTranscriptFiles();\n\n      if (allFiles.length === 0) {\n        return {\n          totalFiles: 0,\n          totalEntries: 0,\n          oldestFile: null,\n          newestFile: null,\n          channelTypes: {},\n        };\n      }\n\n      // Sort files by path\n      const sortedFiles = allFiles.sort();\n\n      let totalEntries = 0;\n      const channelTypes: Record<string, number> = {};\n\n      for (const relativePath of allFiles) {\n        const filePath = path.join(this.transcriptsDir, relativePath);\n        try {\n          const content = await readFile(filePath, \"utf-8\");\n          const lines = content.trim().split(\"\\n\").filter(Boolean);\n          totalEntries += lines.length;\n\n          // Count by channel type (first directory in path)\n          const channelType = relativePath.includes(path.sep)\n            ? relativePath.split(path.sep)[0]\n            : \"legacy\";\n          channelTypes[channelType] = (channelTypes[channelType] || 0) + 1;\n        } catch {\n          // Skip unreadable files\n        }\n      }\n\n      return {\n        totalFiles: allFiles.length,\n        totalEntries,\n        oldestFile: sortedFiles[0],\n        newestFile: sortedFiles[sortedFiles.length - 1],\n        channelTypes,\n      };\n    } catch (err) {\n      log.error(\"failed to get transcript stats:\", err);\n      return {\n        totalFiles: 0,\n        totalEntries: 0,\n        oldestFile: null,\n        newestFile: null,\n        channelTypes: {},\n      };\n    }\n  }\n\n  async analyzeIntegrity(): Promise<SessionIntegrityReport> {\n    return analyzeSessionIntegrity({ memoryDir: this.config.memoryDir });\n  }\n\n  async getRecoverySummary(sessionKey?: string): Promise<{\n    generatedAt: string;\n    sessionKey?: string;\n    healthy: boolean;\n    issueCount: number;\n    incompleteTurns: number;\n    brokenChains: number;\n    checkpointHealthy: boolean;\n  }> {\n    const report = await this.analyzeIntegrity();\n    const selectedSessions = sessionKey\n      ? report.sessions.filter((session) => session.sessionKey === sessionKey)\n      : report.sessions;\n    const incompleteTurns = selectedSessions.reduce((sum, session) => sum + session.incompleteTurns, 0);\n    const brokenChains = selectedSessions.reduce((sum, session) => sum + session.brokenChains, 0);\n    const filteredIssues = report.issues.filter((issue) => !sessionKey || issue.sessionKey === sessionKey);\n    const issueCount = filteredIssues.length;\n    const severeIssueCount = filteredIssues.filter((issue) => issue.severity !== \"info\").length;\n    return {\n      generatedAt: report.generatedAt,\n      sessionKey,\n      healthy: sessionKey ? severeIssueCount === 0 && report.checkpoint.healthy : report.healthy,\n      issueCount,\n      incompleteTurns,\n      brokenChains,\n      checkpointHealthy: report.checkpoint.healthy,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YOXCJP3A.js → chunk-ZPPFKVSD.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-D24OXEPB.js";
 import {
   EngramAccessInputError
-} from "./chunk-W5ISYSIL.js";
+} from "./chunk-L7W5YW6Y.js";
 import {
   projectTagProjectId
 } from "./chunk-6GIKAUTN.js";
@@ -26,7 +26,7 @@ import {
 } from "./chunk-JUC24CTX.js";
 import {
   validateRequest
-} from "./chunk-CDHRUNBX.js";
+} from "./chunk-QKE4LHNR.js";
 
 // src/access-mcp.ts
 import { readFile } from "fs/promises";
@@ -3102,4 +3102,4 @@ ${body}`;
 export {
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-YOXCJP3A.js.map
+//# sourceMappingURL=chunk-ZPPFKVSD.js.map

package/dist/cli.js

@@ -89,40 +89,41 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-6YLJZ2EU.js";
+} from "./chunk-3D6L7CEP.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
 import "./chunk-JJEJJ7RK.js";
 import "./chunk-HDDRVXX4.js";
-import "./chunk-AGNBY3VG.js";
-import "./chunk-UP6MOYCB.js";
-import "./chunk-7VFZTJ7K.js";
-import "./chunk-Z734BLO3.js";
+import "./chunk-APJQ6UEA.js";
 import "./chunk-OZKVVUJB.js";
 import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
-import "./chunk-BXLOS5AJ.js";
+import "./chunk-OWHERGF2.js";
+import "./chunk-UP6MOYCB.js";
 import "./chunk-765K3SAT.js";
-import "./chunk-HOJZMQ4J.js";
-import "./chunk-LZZNTPLR.js";
+import "./chunk-7VFZTJ7K.js";
+import "./chunk-Z734BLO3.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
-import "./chunk-WMWVO45V.js";
-import "./chunk-D6RIFG4O.js";
-import "./chunk-JCK7V6SN.js";
+import "./chunk-HOJZMQ4J.js";
 import "./chunk-PQFUUXWK.js";
 import "./chunk-MCYT2RNT.js";
+import "./chunk-LZZNTPLR.js";
+import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
+import "./chunk-D6RIFG4O.js";
+import "./chunk-JCK7V6SN.js";
 import "./chunk-CKITWVWJ.js";
 import "./chunk-OUELRE5E.js";
 import "./chunk-GQL52GQ5.js";
+import "./chunk-EVWIEEKZ.js";
 import "./chunk-OTC2KOZ2.js";
-import "./chunk-3SF7QNKF.js";
+import "./chunk-6BNFVP7Y.js";
 import "./chunk-WLGE6KEO.js";
 import "./chunk-TGQ2NTWH.js";
-import "./chunk-T22TZJWJ.js";
-import "./chunk-IZXOO6NP.js";
+import "./chunk-DC66QVL2.js";
+import "./chunk-FAYDM5WD.js";
 import "./chunk-3T74IZB3.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-YNDLCWXS.js";
@@ -139,7 +140,8 @@ import "./chunk-UMKPSD35.js";
 import "./chunk-W4RVMTHR.js";
 import "./chunk-4BISW7RX.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-IHG27THY.js";
+import "./chunk-XUGQQPGO.js";
+import "./chunk-S4DDLTPX.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-D6WVJIS3.js";
 import "./chunk-KFY3SGN7.js";
@@ -164,22 +166,22 @@ import "./chunk-Z5LAYHGJ.js";
 import "./chunk-LBJBNWS2.js";
 import "./chunk-HQ6NIBL6.js";
 import "./chunk-OADWQ5CR.js";
-import "./chunk-BTRL6GG7.js";
+import "./chunk-RAELB5NX.js";
 import "./chunk-SEDEKFYQ.js";
-import "./chunk-2QSZNTDO.js";
+import "./chunk-RKNJBZ55.js";
+import "./chunk-J64TK33U.js";
 import "./chunk-RSUYKGGZ.js";
 import "./chunk-42NQ7AVG.js";
 import "./chunk-TMSXWOBZ.js";
-import "./chunk-J64TK33U.js";
 import "./chunk-7RXCMVFQ.js";
 import "./chunk-7WV3F5DQ.js";
-import "./chunk-YOXCJP3A.js";
+import "./chunk-ZPPFKVSD.js";
 import "./chunk-T4WDJPEZ.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-W5ISYSIL.js";
+import "./chunk-L7W5YW6Y.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-DGNQRNLL.js";
+import "./chunk-NT5TINK5.js";
 import "./chunk-IENGGY2C.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-BT7NVCML.js";
@@ -190,14 +192,14 @@ import "./chunk-5RIRL3XL.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-BEMWL2FZ.js";
-import "./chunk-HRXCPKN4.js";
-import "./chunk-KVUG7FF7.js";
+import "./chunk-APWJRJFW.js";
+import "./chunk-U55D5UD5.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-DCGT4FPP.js";
 import "./chunk-JOASJWQR.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-3MAONBX3.js";
 import "./chunk-RG3LBSGH.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-DCGT4FPP.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
@@ -256,10 +258,10 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-CDHRUNBX.js";
-import "./chunk-VDX2J7OX.js";
+import "./chunk-QKE4LHNR.js";
+import "./chunk-BUKK5SWA.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
+import "./chunk-UVYI6VIX.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/{first-start-migration-FF7YFGRP.js → first-start-migration-PG5HBC3K.js}

@@ -2,12 +2,12 @@ import {
   applyUtilityPromotionRuntimePolicy,
   loadUtilityRuntimeValues
 } from "./chunk-LXOM6IQU.js";
-import {
-  decideTierTransition
-} from "./chunk-S75M5ZRK.js";
 import {
   TierMigrationExecutor
 } from "./chunk-VOUOLGIP.js";
+import {
+  decideTierTransition
+} from "./chunk-S75M5ZRK.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-TBBDFYXW.js";
@@ -260,4 +260,4 @@ export {
   LIFECYCLE_INIT_DONE_MARKER,
   runFirstStartMigration
 };
-//# sourceMappingURL=first-start-migration-FF7YFGRP.js.map
+//# sourceMappingURL=first-start-migration-PG5HBC3K.js.map

package/dist/index.d.ts

@@ -38,6 +38,8 @@ export { OramaBackend } from './search/orama-backend.js';
 export { MeilisearchBackend } from './search/meilisearch-backend.js';
 export { buildEntityRecallSection } from './entity-retrieval.js';
 export { resolvePrincipal } from './namespaces/principal.js';
+export { SESSION_CHANNEL_TYPE, SessionIdentity, SessionStoragePaths, legacyParserReadbackDir, parseSessionIdentity, sessionStoragePaths } from './session-identity.js';
+export { storagePathHash } from './storage-paths.js';
 export { TrustZoneName, TrustZoneRecord, TrustZoneRecordKind, TrustZoneSourceClass, isTrustZoneName } from './trust-zones.js';
 export { EngramAccessHttpServer, RemnicAdminConfigPatch, RemnicAdminControls, RemnicAdminDashboardStatus, RemnicAdminFeatureStatus, RemnicAdminHarnessStatus, RemnicAdminModelOption } from './access-http.js';
 export { EngramMcpServer } from './access-mcp.js';