@remnic/core 9.3.641 → 9.3.643

package/dist/index.js

@@ -94,7 +94,7 @@ import {
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runWearablesCliCommand
-} from "./chunk-ACNU2UBF.js";
+} from "./chunk-2GCNTHRA.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -492,7 +492,7 @@ import "./chunk-HQ6NIBL6.js";
 import "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-6DDBW2V4.js";
+} from "./chunk-S2SEPLLA.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-2QSZNTDO.js";
 import "./chunk-RSUYKGGZ.js";
@@ -506,7 +506,7 @@ import {
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-5IDVOWBE.js";
+} from "./chunk-GJSNDJHR.js";
 import {
   REMNIC_CHATGPT_MEMORY_INSPECTOR_CANONICAL_TOOL,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE,
@@ -515,7 +515,7 @@ import {
   REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI,
   buildChatGptMemoryInspectorActionRequest,
   buildChatGptMemoryInspectorResult
-} from "./chunk-6L46YAEZ.js";
+} from "./chunk-T4WDJPEZ.js";
 import {
   buildCitationGuidance,
   formatOaiMemCitation,
@@ -1073,11 +1073,11 @@ var FilesystemBackend = class {
   }
   async realBasePathIfExists() {
     try {
-      const stat = await fsp.lstat(this.basePath);
-      if (stat.isSymbolicLink()) {
+      const stat2 = await fsp.lstat(this.basePath);
+      if (stat2.isSymbolicLink()) {
         throw new Error(`FilesystemBackend basePath must not be a symlink: ${this.basePath}`);
       }
-      if (!stat.isDirectory()) {
+      if (!stat2.isDirectory()) {
         throw new Error(`FilesystemBackend basePath must be a directory: ${this.basePath}`);
       }
       return await fsp.realpath(this.basePath);
@@ -1106,11 +1106,11 @@ var FilesystemBackend = class {
       if (segment === "." || segment === "") continue;
       current = path.join(current, segment);
       try {
-        const stat = await fsp.lstat(current);
-        if (stat.isSymbolicLink()) {
+        const stat2 = await fsp.lstat(current);
+        if (stat2.isSymbolicLink()) {
           throw new Error(`FilesystemBackend remotePath traverses symlink: ${current}`);
         }
-        if (!stat.isDirectory()) {
+        if (!stat2.isDirectory()) {
           throw new Error(`FilesystemBackend remotePath parent is not a directory: ${current}`);
         }
       } catch (err) {
@@ -1139,19 +1139,19 @@ var FilesystemBackend = class {
     for (const segment of segments) {
       if (segment === "." || segment === "") continue;
       current = path.join(current, segment);
-      let stat;
+      let stat2;
       try {
-        stat = await fsp.lstat(current);
+        stat2 = await fsp.lstat(current);
       } catch (err) {
         if (err.code === "ENOENT") {
           return null;
         }
         throw err;
       }
-      if (stat.isSymbolicLink()) {
+      if (stat2.isSymbolicLink()) {
         throw new Error(`FilesystemBackend remotePath traverses symlink: ${current}`);
       }
-      if (!stat.isDirectory()) {
+      if (!stat2.isDirectory()) {
         return null;
       }
     }
@@ -1166,11 +1166,11 @@ var FilesystemBackend = class {
       throw new Error(`FilesystemBackend remotePath parent escapes basePath: ${JSON.stringify(remotePath)}`);
     }
     try {
-      const stat = await fsp.lstat(dest);
-      if (stat.isSymbolicLink()) {
+      const stat2 = await fsp.lstat(dest);
+      if (stat2.isSymbolicLink()) {
         throw new Error(`FilesystemBackend remotePath points to symlink: ${dest}`);
       }
-      if (!stat.isFile()) {
+      if (!stat2.isFile()) {
         return null;
       }
     } catch (err) {
@@ -1192,8 +1192,8 @@ var FilesystemBackend = class {
     const dest = this.resolveRemotePath(remotePath);
     const realBase = await this.ensureSafeParentDirectory(dest);
     try {
-      const stat = await fsp.lstat(dest);
-      if (stat.isSymbolicLink()) {
+      const stat2 = await fsp.lstat(dest);
+      if (stat2.isSymbolicLink()) {
         throw new Error(`FilesystemBackend remotePath points to symlink: ${dest}`);
       }
     } catch (err) {
@@ -1294,12 +1294,12 @@ async function scanForBinaries(memoryDir, config, manifest) {
       if (!entry.isFile()) continue;
       if (!matchesPatterns(entry.name, config.scanPatterns)) continue;
       try {
-        const stat = await fsp2.stat(fullPath);
-        if (stat.size > config.maxBinarySizeBytes) continue;
-        if (stat.size === 0) continue;
+        const stat2 = await fsp2.stat(fullPath);
+        if (stat2.size > config.maxBinarySizeBytes) continue;
+        if (stat2.size === 0) continue;
         const existing = tracked.get(relativePath);
         if (existing) {
-          if (existing.sizeBytes !== stat.size) {
+          if (existing.sizeBytes !== stat2.size) {
             results.push(relativePath);
             continue;
           }
@@ -1440,7 +1440,7 @@ async function stageMirror(memoryDir, newPaths, backend, assets, log2, dryRun) {
   for (const relPath of newPaths) {
     const fullPath = path4.join(memoryDir, relPath);
     try {
-      const stat = await fsp4.stat(fullPath);
+      const stat2 = await fsp4.stat(fullPath);
       const contentHash = await hashFile2(fullPath);
       const ext = path4.extname(relPath);
       const mimeType = guessMimeType(ext);
@@ -1455,7 +1455,7 @@ async function stageMirror(memoryDir, newPaths, backend, assets, log2, dryRun) {
         mirroredPath: backendLocation,
         ...redirectPath ? { redirectPath } : {},
         contentHash,
-        sizeBytes: stat.size,
+        sizeBytes: stat2.size,
         mimeType,
         mirroredAt: (/* @__PURE__ */ new Date()).toISOString(),
         status: "mirrored"
@@ -1468,7 +1468,7 @@ async function stageMirror(memoryDir, newPaths, backend, assets, log2, dryRun) {
         assets.push(record);
       }
       mirrored++;
-      log2.info(`[binary-lifecycle] mirrored: ${relPath} (${stat.size} bytes)${dryRun ? " [dry-run]" : ""}`);
+      log2.info(`[binary-lifecycle] mirrored: ${relPath} (${stat2.size} bytes)${dryRun ? " [dry-run]" : ""}`);
     } catch (err) {
       const msg = `mirror failed for ${relPath}: ${err instanceof Error ? err.message : String(err)}`;
       log2.error(`[binary-lifecycle] ${msg}`);
@@ -1960,21 +1960,21 @@ function assertNotSymlink(targetPath, label) {
   }
 }
 function assertSafeMemoryRoot(targetPath) {
-  const stat = fs.lstatSync(targetPath);
-  if (stat.isSymbolicLink()) {
+  const stat2 = fs.lstatSync(targetPath);
+  if (stat2.isSymbolicLink()) {
     throw new Error(`memoryDir must not be a symlink: ${targetPath}`);
   }
-  if (!stat.isDirectory()) {
+  if (!stat2.isDirectory()) {
     throw new Error(`memoryDir must be a directory: ${targetPath}`);
   }
   return fs.realpathSync(targetPath);
 }
 function assertSafeInputRoot(realMemoryDir, targetPath, label) {
-  const stat = fs.lstatSync(targetPath);
-  if (stat.isSymbolicLink()) {
+  const stat2 = fs.lstatSync(targetPath);
+  if (stat2.isSymbolicLink()) {
     throw new Error(`${label} must not be a symlink: ${targetPath}`);
   }
-  if (!stat.isDirectory()) {
+  if (!stat2.isDirectory()) {
     throw new Error(`${label} must be a directory: ${targetPath}`);
   }
   const realTarget = fs.realpathSync(targetPath);
@@ -1991,8 +1991,8 @@ function assertSafeOutputTarget(realOutputDir, outputPath) {
   for (const segment of relative.split(path5.sep).filter(Boolean)) {
     current = path5.join(current, segment);
     try {
-      const stat = fs.lstatSync(current);
-      if (stat.isSymbolicLink()) {
+      const stat2 = fs.lstatSync(current);
+      if (stat2.isSymbolicLink()) {
         throw new Error(`context tree output path contains symlink: ${current}`);
       }
     } catch (err) {
@@ -2661,8 +2661,8 @@ async function curate(options) {
   };
 }
 function resolveTargets(targetPath) {
-  const stat = fs3.statSync(targetPath);
-  if (stat.isFile()) return [targetPath];
+  const stat2 = fs3.statSync(targetPath);
+  if (stat2.isFile()) return [targetPath];
   const results = [];
   const extensions = /* @__PURE__ */ new Set([".md", ".txt", ".mdx", ".rst"]);
   function walk(dir) {
@@ -2682,8 +2682,8 @@ function resolveTargets(targetPath) {
 }
 function resolveProvenanceRoot(targetPath) {
   const resolvedTarget = path7.resolve(targetPath);
-  const stat = fs3.statSync(resolvedTarget);
-  return stat.isFile() ? path7.dirname(resolvedTarget) : resolvedTarget;
+  const stat2 = fs3.statSync(resolvedTarget);
+  return stat2.isFile() ? path7.dirname(resolvedTarget) : resolvedTarget;
 }
 function extractStatements(content, filePath, projectRoot, source, sourceFileHash, categoryOverride, confidence, entityRef, tags) {
   const relativePath = path7.relative(projectRoot, path7.resolve(filePath)) || path7.basename(filePath);
@@ -3116,8 +3116,8 @@ import path9 from "path";
 var DEFAULT_CONFIDENCE_THRESHOLD = 0.7;
 function realMemoryRoot(memoryDir) {
   try {
-    const stat = fs5.lstatSync(memoryDir);
-    if (!stat.isDirectory() || stat.isSymbolicLink()) return null;
+    const stat2 = fs5.lstatSync(memoryDir);
+    if (!stat2.isDirectory() || stat2.isSymbolicLink()) return null;
     return fs5.realpathSync(memoryDir);
   } catch {
     return null;
@@ -3129,8 +3129,8 @@ function isPathInside2(rootReal, candidateReal) {
 }
 function isSafeDirectory(rootReal, dir) {
   try {
-    const stat = fs5.lstatSync(dir);
-    if (!stat.isDirectory() || stat.isSymbolicLink()) return false;
+    const stat2 = fs5.lstatSync(dir);
+    if (!stat2.isDirectory() || stat2.isSymbolicLink()) return false;
     return isPathInside2(rootReal, fs5.realpathSync(dir));
   } catch {
     return false;
@@ -3909,9 +3909,9 @@ function removeStaleManifestReclaimLock(reclaimDir) {
   fs7.rmSync(tombstoneDir, { recursive: true, force: true });
 }
 function readManifestLockSnapshot(lockDir) {
-  let stat;
+  let stat2;
   try {
-    stat = fs7.statSync(lockDir);
+    stat2 = fs7.statSync(lockDir);
   } catch (error) {
     if (error.code === "ENOENT") {
       return void 0;
@@ -3920,10 +3920,10 @@ function readManifestLockSnapshot(lockDir) {
   }
   try {
     const owner = fs7.readFileSync(path11.join(lockDir, "owner"), "utf8").trim();
-    return { mtimeMs: stat.mtimeMs, owner };
+    return { mtimeMs: stat2.mtimeMs, owner };
   } catch (error) {
     if (error.code === "ENOENT") {
-      return { mtimeMs: stat.mtimeMs };
+      return { mtimeMs: stat2.mtimeMs };
     }
     throw error;
   }
@@ -4691,21 +4691,861 @@ function publisherForConnector(connectorId) {
   return publisherFor(hostIdForConnector(connectorId));
 }
 
-// src/transfer/capsule-fork.ts
-import { lstat, mkdir, readFile, realpath, writeFile } from "fs/promises";
+// src/session-summaries/index.ts
+import { createHash } from "crypto";
+import { lstat, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "fs/promises";
 import path13 from "path";
+
+// src/session-summaries/adapters.ts
+var VALID_ROLES = /* @__PURE__ */ new Set(["user", "assistant", "tool", "system", "other"]);
+function normalizeRole(value) {
+  if (typeof value !== "string") return "other";
+  const role = value.trim().toLowerCase();
+  if (VALID_ROLES.has(role)) {
+    return role;
+  }
+  if (role === "human") return "user";
+  if (role === "ai" || role === "model" || role === "bot") return "assistant";
+  if (role === "function") return "tool";
+  return "other";
+}
+function normalizeTimestamp(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    const millis = value > 1e12 ? value : value * 1e3;
+    const date2 = new Date(millis);
+    return Number.isFinite(date2.getTime()) ? date2.toISOString() : void 0;
+  }
+  if (typeof value !== "string" || value.trim().length === 0) return void 0;
+  const date = new Date(value);
+  return Number.isFinite(date.getTime()) ? date.toISOString() : void 0;
+}
+function normalizeContent(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+  }
+  if (Array.isArray(value)) {
+    const parts = value.map((part) => normalizeContent(part)).filter((part) => typeof part === "string").join("\n").trim();
+    return parts.length > 0 ? parts : void 0;
+  }
+  if (!value || typeof value !== "object") return void 0;
+  const obj = value;
+  if (firstString(obj.type) === "tool_result") return void 0;
+  return normalizeContent(obj.text ?? obj.content ?? obj.message ?? obj.parts ?? obj.value ?? obj.input);
+}
+function firstString(...values) {
+  for (const value of values) {
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return String(value);
+    }
+  }
+  return void 0;
+}
+function firstContent(...values) {
+  for (const value of values) {
+    const content = normalizeContent(value);
+    if (content) return content;
+  }
+  return void 0;
+}
+function objectField(value) {
+  return value && typeof value === "object" ? value : void 0;
+}
+var SESSION_KEY_FIELDS = [
+  "sessionKey",
+  "session_key",
+  "sessionId",
+  "session_id",
+  "conversationId",
+  "conversation_id",
+  "threadId",
+  "thread_id",
+  "transcriptId",
+  "transcript_id"
+];
+function hasUsableSessionKeyField(value) {
+  return typeof value === "string" && value.trim().length > 0 || typeof value === "number" && Number.isFinite(value);
+}
+function inheritEnvelopeSessionFields(row, envelope) {
+  if (!row || typeof row !== "object" || Array.isArray(row)) return row;
+  const child = row;
+  const inherited = {};
+  for (const key of SESSION_KEY_FIELDS) {
+    if (!hasUsableSessionKeyField(child[key]) && hasUsableSessionKeyField(envelope[key])) {
+      inherited[key] = envelope[key];
+    }
+  }
+  return Object.keys(inherited).length > 0 ? { ...child, ...inherited } : row;
+}
+function codexRoleFromTypes(rowType, payloadType) {
+  if (payloadType === "agent_message") return "assistant";
+  if (payloadType === "user_message") return "user";
+  if (rowType === "event_msg") return "user";
+  if (rowType === "response_item") return "assistant";
+  return void 0;
+}
+function sessionKeyFromRow(row) {
+  if (!row || typeof row !== "object") return void 0;
+  const obj = row;
+  const nestedMessage = objectField(obj.message);
+  const payload = objectField(obj.payload);
+  const payloadMessage = objectField(payload?.message);
+  const rowType = firstString(obj.type, obj.kind, obj.event)?.toLowerCase();
+  return firstString(
+    obj.sessionKey,
+    obj.session_key,
+    obj.sessionId,
+    obj.session_id,
+    obj.conversationId,
+    obj.conversation_id,
+    obj.threadId,
+    obj.thread_id,
+    obj.transcriptId,
+    obj.transcript_id,
+    nestedMessage?.sessionKey,
+    nestedMessage?.session_key,
+    nestedMessage?.sessionId,
+    nestedMessage?.session_id,
+    nestedMessage?.conversationId,
+    nestedMessage?.conversation_id,
+    nestedMessage?.threadId,
+    nestedMessage?.thread_id,
+    nestedMessage?.transcriptId,
+    nestedMessage?.transcript_id,
+    rowType === "session_meta" ? payload?.id : void 0,
+    payload?.sessionKey,
+    payload?.session_key,
+    payload?.sessionId,
+    payload?.session_id,
+    payload?.conversationId,
+    payload?.conversation_id,
+    payload?.threadId,
+    payload?.thread_id,
+    payload?.transcriptId,
+    payload?.transcript_id,
+    payloadMessage?.sessionKey,
+    payloadMessage?.session_key,
+    payloadMessage?.sessionId,
+    payloadMessage?.session_id,
+    payloadMessage?.conversationId,
+    payloadMessage?.conversation_id,
+    payloadMessage?.threadId,
+    payloadMessage?.thread_id,
+    payloadMessage?.transcriptId,
+    payloadMessage?.transcript_id
+  );
+}
+function extractRowsFromJson(value) {
+  if (Array.isArray(value)) return value;
+  if (!value || typeof value !== "object") return [];
+  const obj = value;
+  for (const key of ["turns", "messages", "events", "entries", "items"]) {
+    const rows = obj[key];
+    if (Array.isArray(rows) && rows.length > 0) {
+      return rows.map((row) => inheritEnvelopeSessionFields(row, obj));
+    }
+  }
+  return [obj];
+}
+function parseJsonlRows(content, adapterId, strict, fileRef) {
+  const rows = [];
+  const warnings = [];
+  for (const [index, line] of content.split("\n").entries()) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) continue;
+    try {
+      rows.push(JSON.parse(trimmed));
+    } catch {
+      const warning = {
+        code: `${adapterId}.jsonl.invalid_line`,
+        message: `Skipping invalid JSONL line ${index + 1} in fileRef ${fileRef}.`,
+        fileRef,
+        line: index + 1
+      };
+      if (strict) throw new Error(warning.message);
+      warnings.push(warning);
+    }
+  }
+  return { rows, warnings };
+}
+function parseRows(content, extension, adapterId, strict, fileRef) {
+  if (extension === ".jsonl") {
+    return parseJsonlRows(content, adapterId, strict, fileRef);
+  }
+  try {
+    return { rows: extractRowsFromJson(JSON.parse(content)), warnings: [] };
+  } catch {
+    const message = `Invalid ${adapterId} JSON in fileRef ${fileRef}; skipping file.`;
+    if (strict) throw new Error(message);
+    return {
+      rows: [],
+      warnings: [{ code: `${adapterId}.json.invalid`, message, fileRef }]
+    };
+  }
+}
+function turnFromRow(row, fallbackSessionKey) {
+  if (!row || typeof row !== "object") return null;
+  const obj = row;
+  const nestedMessage = objectField(obj.message);
+  const payload = objectField(obj.payload);
+  const payloadItem = objectField(payload?.item);
+  const payloadMessage = objectField(payload?.message);
+  const author = objectField(obj.author);
+  const rowType = firstString(obj.type, obj.kind, obj.event);
+  const payloadType = firstString(payload?.type, payloadItem?.type);
+  const codexRole = codexRoleFromTypes(rowType, payloadType);
+  const content = firstContent(
+    obj.content,
+    obj.text,
+    obj.message,
+    obj.body,
+    obj.parts,
+    obj.input,
+    payload?.message,
+    payload?.content,
+    payload?.text,
+    payload?.body,
+    payload?.parts,
+    payload?.input,
+    payloadMessage?.content,
+    payloadMessage?.text,
+    payloadMessage?.parts,
+    payloadMessage?.input,
+    payloadItem?.content,
+    payloadItem?.text,
+    payloadItem?.message,
+    payloadItem?.parts,
+    payloadItem?.input,
+    nestedMessage?.content,
+    nestedMessage?.text,
+    nestedMessage?.parts,
+    nestedMessage?.input
+  );
+  if (!content) return null;
+  const role = normalizeRole(
+    obj.role ?? obj.sender ?? obj.actor ?? payload?.role ?? payload?.sender ?? payloadMessage?.role ?? payloadMessage?.sender ?? payloadItem?.role ?? nestedMessage?.role ?? nestedMessage?.sender ?? author?.role ?? codexRole ?? obj.type
+  );
+  return {
+    role,
+    content,
+    timestamp: normalizeTimestamp(
+      obj.timestamp ?? obj.createdAt ?? obj.created_at ?? obj.time ?? obj.date ?? payload?.timestamp ?? payload?.createdAt ?? payload?.created_at ?? payloadMessage?.timestamp ?? payloadMessage?.createdAt ?? payloadMessage?.created_at ?? payloadItem?.timestamp ?? payloadItem?.created_at ?? nestedMessage?.timestamp ?? nestedMessage?.created_at
+    ),
+    sessionKey: sessionKeyFromRow(row) ?? fallbackSessionKey,
+    sourceId: firstString(obj.id, obj.uuid, obj.turnId, obj.turn_id, payload?.id, payloadItem?.id)
+  };
+}
+function shouldSkipRowForAdapter(adapterId, row) {
+  if (adapterId !== "codex-jsonl" || !row || typeof row !== "object") return false;
+  const obj = row;
+  const payload = objectField(obj.payload);
+  const rowType = firstString(obj.type, obj.kind, obj.event)?.toLowerCase();
+  const payloadType = firstString(payload?.type)?.toLowerCase();
+  return rowType === "compacted" || payloadType === "compacted";
+}
+var CODEX_MIRROR_SURFACE_PRIORITY = {
+  "event-agent-message": 1,
+  "response-item": 2
+};
+function codexMirrorSurface(row) {
+  if (!row || typeof row !== "object") return void 0;
+  const obj = row;
+  const payload = objectField(obj.payload);
+  const payloadItem = objectField(payload?.item);
+  const rowType = firstString(obj.type, obj.kind, obj.event)?.toLowerCase();
+  const payloadType = firstString(payload?.type, payloadItem?.type)?.toLowerCase();
+  if (rowType === "event_msg" && payloadType === "agent_message") return "event-agent-message";
+  if (rowType === "response_item") return "response-item";
+  return void 0;
+}
+function codexMirrorKey(adapterId, row, turn) {
+  if (adapterId !== "codex-jsonl" || turn.role !== "assistant") return void 0;
+  const surface = codexMirrorSurface(row);
+  if (!surface) return void 0;
+  const sessionKey = turn.sessionKey?.trim();
+  const content = turn.content.replace(/\s+/g, " ").trim();
+  if (!sessionKey || content.length === 0) return void 0;
+  return `${sessionKey}\0${turn.role}\0${content}`;
+}
+function pushTurnWithCodexMirrorDedupe(adapterId, row, turn, turns, codexMirrorTurns) {
+  const key = codexMirrorKey(adapterId, row, turn);
+  const surface = key ? codexMirrorSurface(row) : void 0;
+  if (!key || !surface) {
+    turns.push(turn);
+    return;
+  }
+  const candidates = codexMirrorTurns.get(key) ?? [];
+  const rowSignal = turn.sourceId ?? turn.timestamp;
+  const matchingIndex = candidates.findIndex((candidate) => {
+    if (candidate.surface === surface) {
+      return Boolean(candidate.rowSignal && rowSignal && candidate.rowSignal === rowSignal);
+    }
+    return Boolean(candidate.rowSignal && rowSignal && candidate.rowSignal === rowSignal);
+  });
+  const existing = matchingIndex >= 0 ? candidates[matchingIndex] : void 0;
+  if (existing) {
+    if (CODEX_MIRROR_SURFACE_PRIORITY[surface] > CODEX_MIRROR_SURFACE_PRIORITY[existing.surface]) {
+      turns[existing.index] = turn;
+      candidates[matchingIndex] = { index: existing.index, surface, ...rowSignal ? { rowSignal } : {} };
+      codexMirrorTurns.set(key, candidates);
+    }
+    return;
+  }
+  candidates.push({ index: turns.length, surface, ...rowSignal ? { rowSignal } : {} });
+  codexMirrorTurns.set(key, candidates);
+  turns.push(turn);
+}
+function makeJsonTranscriptAdapter(id) {
+  return {
+    id,
+    parseFile(input, options = {}) {
+      const parsed = parseRows(input.content, input.fileExtension, id, options.strict, input.fileRef);
+      const fallbackSessionKey = `${id}:${input.fileRef}`;
+      let currentSessionKey = fallbackSessionKey;
+      const turns = [];
+      const codexMirrorTurns = /* @__PURE__ */ new Map();
+      for (const row of parsed.rows) {
+        if (shouldSkipRowForAdapter(id, row)) continue;
+        currentSessionKey = sessionKeyFromRow(row) ?? currentSessionKey;
+        const turn = turnFromRow(row, currentSessionKey);
+        if (turn) {
+          currentSessionKey = turn.sessionKey ?? currentSessionKey;
+          pushTurnWithCodexMirrorDedupe(id, row, turn, turns, codexMirrorTurns);
+        }
+      }
+      return { turns, warnings: parsed.warnings };
+    }
+  };
+}
+var BUILT_IN_ADAPTERS = /* @__PURE__ */ new Map();
+function registerLocalSessionSourceAdapter(adapter) {
+  if (!adapter || typeof adapter !== "object") {
+    throw new Error("local session source adapter must be an object");
+  }
+  if (typeof adapter.id !== "string" || adapter.id.trim().length === 0) {
+    throw new Error("local session source adapter id must be a non-empty string");
+  }
+  if (typeof adapter.parseFile !== "function") {
+    throw new Error(`local session adapter '${adapter.id}' must define parseFile`);
+  }
+  const id = adapter.id.trim();
+  if (BUILT_IN_ADAPTERS.has(id)) {
+    throw new Error(`local session adapter '${id}' is already registered`);
+  }
+  BUILT_IN_ADAPTERS.set(id, adapter.id === id ? adapter : { ...adapter, id });
+}
+function getLocalSessionSourceAdapter(id) {
+  const key = typeof id === "string" && id.trim().length > 0 ? id.trim() : "generic-jsonl";
+  return BUILT_IN_ADAPTERS.get(key);
+}
+function listLocalSessionSourceAdapters() {
+  return [...BUILT_IN_ADAPTERS.keys()].sort();
+}
+for (const adapterId of ["generic-jsonl", "codex-jsonl", "claude-jsonl"]) {
+  registerLocalSessionSourceAdapter(makeJsonTranscriptAdapter(adapterId));
+}
+
+// src/session-summaries/redaction.ts
+var DEFAULT_REDACTION_RULES = [
+  {
+    name: "secret-token",
+    pattern: /(?<![A-Za-z0-9_])(?:sk-[A-Za-z0-9_-]{12,}|sk-proj-[A-Za-z0-9_-]{12,}|(?:"authorization"|'authorization'|authorization)\s*[:=]\s*(?:"[A-Za-z][A-Za-z0-9._-]*\s+[^"\r\n]*"|'[A-Za-z][A-Za-z0-9._-]*\s+[^'\r\n]*'|[A-Za-z][A-Za-z0-9._-]*\s+(?:"[^"\r\n]*"|'[^'\r\n]*'|[^\s"',;]+))|(?:"(?:[A-Za-z0-9]+[_-]+)*(?:api[_-]?key|access[_-]?key|private[_-]?key|token|secret|password)"|'(?:[A-Za-z0-9]+[_-]+)*(?:api[_-]?key|access[_-]?key|private[_-]?key|token|secret|password)'|(?:[A-Za-z0-9]+[_-]+)*(?:api[_-]?key|access[_-]?key|private[_-]?key|token|secret|password))\s*[:=]\s*(?:"[^"\r\n]*"|'[^'\r\n]*'|[^\s"',;]+))/gi,
+    replacement: "[REDACTED_SECRET]"
+  },
+  {
+    name: "email",
+    pattern: /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi,
+    replacement: "[REDACTED_EMAIL]"
+  },
+  {
+    name: "private-ip",
+    pattern: /\b(?:(?:10|127)\.(?:\d{1,3}\.){2}\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|172\.(?:1[6-9]|2\d|3[0-1])\.\d{1,3}\.\d{1,3})\b/g,
+    replacement: "[REDACTED_PRIVATE_IP]"
+  },
+  {
+    name: "url",
+    pattern: /\bhttps?:\/\/[^\s"'<>)]*/gi,
+    replacement: "[REDACTED_URL]"
+  },
+  {
+    name: "home-relative-posix-spaced-path",
+    pattern: /~\/(?:[^/\s"',;<>]+(?: [^/\s"',;<>]+)*\/)*[^/\s"',;<>]+(?: (?!(?:before|after|then|and|or)\b)[^/\s"',;<>]+)+\.[^/\s"',;<>]+?(?=$|[\s"',;<>)]|[.,](?:\s|$))/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "home-relative-posix-spaced-extensionless-path",
+    pattern: /~\/(?:[^/\s"',;<>]+(?: [^/\s"',;<>]+)*\/)*[^/\s"',;<>]+(?: (?!(?:before|after|then|and(?=\s+[a-z])|or(?=\s+[a-z]))\b)[^/\s"',;<>]+)+?(?=$|["'<>)](?!\/)|[,;.]|\s+(?:before|after|then|and(?=\s+(?:[a-z]|[~/"']|$))|or(?=\s+(?:[a-z]|[~/"']|$)))\b)/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "home-relative-posix-path",
+    pattern: /~\/(?:[^/\s"',;<>]+(?: [^/\s"',;<>]+)*\/)*[^/\s"',;<>]+?(?=$|[\s"',;<>)]|[.,](?:\s|$))/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "absolute-posix-spaced-path",
+    pattern: /\/(?:[^/\s"',;<>]+(?: [^/\s"',;<>]+)*\/)*[^/\s"',;<>]+(?: (?!(?:before|after|then|and|or)\b)[^/\s"',;<>]+)+\.[^/\s"',;<>]+?(?=$|[\s"',;<>)]|[.,](?:\s|$))/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "absolute-posix-spaced-extensionless-path",
+    pattern: /\/(?:[^/\s"',;<>]+(?: [^/\s"',;<>]+)*\/)*[^/\s"',;<>]+(?: (?!(?:before|after|then|and(?=\s+[a-z])|or(?=\s+[a-z]))\b)[^/\s"',;<>]+)+?(?=$|["'<>)](?!\/)|[,;.]|\s+(?:before|after|then|and(?=\s+(?:[a-z]|[~/"']|$))|or(?=\s+(?:[a-z]|[~/"']|$)))\b)/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "absolute-posix-path",
+    pattern: /\/(?:[^/\s"',;<>]+(?: [^/\s"',;<>]+)*\/)*[^/\s"',;<>]+?(?=$|[\s"',;<>)]|[.,](?:\s|$))/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "absolute-windows-spaced-path",
+    pattern: /\b[A-Za-z]:\\(?:[^\\/:*?"<>|,;\r\n]+\\)*[^\\/:*?"<>|,;\s\r\n]+(?: [^\\/:*?"<>|,;\s\r\n]+)+\.[A-Za-z0-9_-]+/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "absolute-windows-spaced-extensionless-path",
+    pattern: /\b[A-Za-z]:\\(?:[^\\/:*?"<>|,;\r\n]+\\)*[^\\/:*?"<>|,;\s\r\n]+(?: [^\\/:*?"<>|,;\s\r\n]+)+(?=$|["'<>)](?!\\)|[,;.]|\s+(?:before|after|then|and|or)\b)/gi,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "absolute-windows-path",
+    pattern: /\b[A-Za-z]:\\(?:[^\\/:*?"<>|,;\r\n]+\\)*[^\\/:*?"<>|,;\s\r\n]+/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "unc-windows-spaced-path",
+    pattern: /\\\\[^\\/:*?"<>|,;\s\r\n]+\\[^\\/:*?"<>|,;\r\n]+\\(?:[^\\/:*?"<>|,;\r\n]+\\)*[^\\/:*?"<>|,;\s\r\n]+(?: [^\\/:*?"<>|,;\s\r\n]+)+\.[A-Za-z0-9_-]+/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "unc-windows-spaced-extensionless-path",
+    pattern: /\\\\[^\\/:*?"<>|,;\s\r\n]+\\[^\\/:*?"<>|,;\r\n]+\\(?:[^\\/:*?"<>|,;\r\n]+\\)*[^\\/:*?"<>|,;\s\r\n]+(?: [^\\/:*?"<>|,;\s\r\n]+)+(?=$|["'<>)](?!\\)|[,;.]|\s+(?:before|after|then|and|or)\b)/gi,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "unc-windows-share-root",
+    pattern: /\\\\[^\\/:*?"<>|,;\s\r\n]+\\[^\\/:*?"<>|,;\s\r\n]+(?=$|[\s"',;<>)]|[.,](?:\s|$))/g,
+    replacement: "[REDACTED_PATH]"
+  },
+  {
+    name: "unc-windows-path",
+    pattern: /\\\\[^\\/:*?"<>|,;\s\r\n]+\\[^\\/:*?"<>|,;\r\n]+\\(?:[^\\/:*?"<>|,;\r\n]+\\)*[^\\/:*?"<>|,;\s\r\n]+/g,
+    replacement: "[REDACTED_PATH]"
+  }
+];
+function cloneRedactionRule(rule) {
+  return {
+    name: rule.name,
+    pattern: new RegExp(rule.pattern.source, rule.pattern.flags),
+    replacement: rule.replacement
+  };
+}
+function compileRedactionRules(config = {}) {
+  const rules = config.disableDefaults === true ? [] : DEFAULT_REDACTION_RULES.map(cloneRedactionRule);
+  const customRules = config.rules ?? [];
+  if (!Array.isArray(customRules)) {
+    throw new Error("redaction rules must be an array");
+  }
+  for (const rule of customRules) {
+    if (!rule || typeof rule !== "object") {
+      throw new Error("redaction rule must be an object");
+    }
+    if (typeof rule.name !== "string" || rule.name.trim().length === 0) {
+      throw new Error("redaction rule name must be a non-empty string");
+    }
+    if (typeof rule.pattern !== "string" || rule.pattern.length === 0) {
+      throw new Error(`redaction rule '${rule.name}' pattern must be non-empty`);
+    }
+    const flags = rule.flags ?? "g";
+    rules.push({
+      name: rule.name.trim(),
+      pattern: new RegExp(rule.pattern, flags.includes("g") ? flags : `${flags}g`),
+      replacement: rule.replacement ?? `[REDACTED_${rule.name.trim().toUpperCase()}]`
+    });
+  }
+  return rules;
+}
+function redactSessionSummaryText(text, rules) {
+  let redacted = text;
+  let applied = 0;
+  const ruleNames = /* @__PURE__ */ new Set();
+  for (const rule of rules) {
+    rule.pattern.lastIndex = 0;
+    const matches = redacted.match(rule.pattern);
+    if (!matches || matches.length === 0) continue;
+    applied += matches.length;
+    ruleNames.add(rule.name);
+    redacted = redacted.replace(rule.pattern, rule.replacement);
+  }
+  return {
+    text: redacted,
+    report: {
+      applied,
+      ruleNames: [...ruleNames].sort()
+    }
+  };
+}
+
+// src/session-summaries/index.ts
+var DEFAULT_MAX_FILES = 5e3;
+var DEFAULT_MAX_SESSIONS = 500;
+var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".json", ".jsonl"]);
+function shortHash(value, length = 16) {
+  return createHash("sha256").update(value).digest("hex").slice(0, length);
+}
+async function listTranscriptFiles(root, maxFiles) {
+  const out = [];
+  let truncated = false;
+  const entrySortKey = (entryName, isDirectory) => isDirectory ? `${entryName}${path13.sep}` : entryName;
+  async function visit(dir) {
+    if (truncated) return;
+    const entries = (await readdir(dir, { withFileTypes: true })).sort(
+      (a, b) => entrySortKey(a.name, a.isDirectory()).localeCompare(entrySortKey(b.name, b.isDirectory()))
+    );
+    for (const entry of entries) {
+      if (truncated) return;
+      if (entry.name.startsWith(".")) continue;
+      if (entry.isSymbolicLink()) continue;
+      const fullPath = path13.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await visit(fullPath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      const ext = path13.extname(entry.name).toLowerCase();
+      if (!SUPPORTED_EXTENSIONS.has(ext)) continue;
+      out.push(fullPath);
+      if (out.length > maxFiles) {
+        truncated = true;
+        return;
+      }
+    }
+  }
+  await visit(root);
+  const sorted = out.sort();
+  return {
+    files: sorted.slice(0, maxFiles),
+    truncated
+  };
+}
+function validatePositiveInt(value, name, defaultValue) {
+  if (value === void 0) return defaultValue;
+  if (!Number.isInteger(value) || value < 1) {
+    throw new Error(`${name} must be a positive integer`);
+  }
+  return value;
+}
+function normalizeInputDir(inputDir) {
+  if (typeof inputDir !== "string" || inputDir.trim().length === 0) {
+    throw new Error("inputDir must be a non-empty string");
+  }
+  return path13.resolve(expandTildePath(inputDir.trim()));
+}
+function initRoleCounts() {
+  return {
+    user: 0,
+    assistant: 0,
+    tool: 0,
+    system: 0,
+    other: 0
+  };
+}
+function safeTimestampSortValue(turn) {
+  if (!turn.timestamp) return Number.MAX_SAFE_INTEGER;
+  const millis = Date.parse(turn.timestamp);
+  return Number.isFinite(millis) ? millis : Number.MAX_SAFE_INTEGER;
+}
+function earliestTurnSortValue(turns) {
+  let earliest = Number.MAX_SAFE_INTEGER;
+  for (const turn of turns) {
+    const value = safeTimestampSortValue(turn);
+    if (value < earliest) earliest = value;
+  }
+  return earliest;
+}
+function truncateExcerpt(text) {
+  const compact = text.replace(/\s+/g, " ").trim();
+  return compact.length > 240 ? `${compact.slice(0, 237)}...` : compact;
+}
+function mergeRuleNames(target, names) {
+  for (const name of names) target.add(name);
+}
+function buildDraft(options) {
+  const sortedTurns = [...options.turns].sort((a, b) => safeTimestampSortValue(a) - safeTimestampSortValue(b));
+  const roles = initRoleCounts();
+  const fileRefs = /* @__PURE__ */ new Map();
+  let redactionApplied = 0;
+  const redactionRuleNames = /* @__PURE__ */ new Set();
+  const excerpts = [];
+  for (const turn of sortedTurns) {
+    roles[turn.role] += 1;
+    fileRefs.set(turn.fileHash, turn.fileExtension);
+    const redacted = redactSessionSummaryText(turn.content, options.redactionRules);
+    redactionApplied += redacted.report.applied;
+    mergeRuleNames(redactionRuleNames, redacted.report.ruleNames);
+    if (options.includeRedactedExcerpts && excerpts.length < 5) {
+      excerpts.push({
+        role: turn.role,
+        text: truncateExcerpt(redacted.text),
+        ...turn.timestamp ? { timestamp: turn.timestamp } : {}
+      });
+    }
+  }
+  const firstTimestamp = sortedTurns.find((turn) => turn.timestamp)?.timestamp;
+  const lastTimestamp = [...sortedTurns].reverse().find((turn) => turn.timestamp)?.timestamp;
+  const sourceSessionRef = shortHash(options.sessionKey);
+  const sourceFileRefs = [...fileRefs.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([hash, extension]) => ({ hash, extension }));
+  const dateText = firstTimestamp && lastTimestamp ? ` from ${firstTimestamp} to ${lastTimestamp}` : "";
+  const summary = `Local AI session summary: ${sortedTurns.length} turn(s) (${roles.user} user, ${roles.assistant} assistant, ${roles.tool} tool, ${roles.system} system, ${roles.other} other)${dateText}. Raw transcript text, source session keys, and local file paths are not stored.`;
+  return {
+    schemaVersion: 1,
+    draftId: shortHash(
+      JSON.stringify({
+        source: options.source,
+        sourceSessionRef,
+        firstTimestamp,
+        lastTimestamp,
+        turnCount: sortedTurns.length
+      }),
+      24
+    ),
+    generatedAt: options.generatedAt,
+    sourceAdapter: options.source,
+    sourceSessionRef,
+    sourceFileCount: sourceFileRefs.length,
+    sourceFileRefs,
+    ...firstTimestamp ? { firstTimestamp } : {},
+    ...lastTimestamp ? { lastTimestamp } : {},
+    turnCount: sortedTurns.length,
+    roles,
+    summary,
+    redaction: {
+      enabled: options.redactionRules.length > 0,
+      applied: redactionApplied,
+      ruleNames: [...redactionRuleNames].sort()
+    },
+    ...options.includeRedactedExcerpts && excerpts.length > 0 ? { excerpts } : {},
+    metadata: {
+      storesRawTranscript: false,
+      storesLocalPaths: false,
+      storesSourceSessionKey: false
+    }
+  };
+}
+async function collectLocalSessionSummaries(options) {
+  const inputDir = normalizeInputDir(options.inputDir);
+  const inputLstat = await lstat(inputDir);
+  if (inputLstat.isSymbolicLink()) {
+    throw new Error(`inputDir must not be a symbolic link: ${options.inputDir}`);
+  }
+  const inputStat = await stat(inputDir);
+  if (!inputStat.isDirectory()) {
+    throw new Error(`inputDir must be a directory: ${options.inputDir}`);
+  }
+  const source = options.source?.trim() || "generic-jsonl";
+  const adapter = getLocalSessionSourceAdapter(source);
+  if (!adapter) {
+    throw new Error(
+      `Unknown local session source '${source}'. Valid sources: ${listLocalSessionSourceAdapters().join(", ")}`
+    );
+  }
+  const maxFiles = validatePositiveInt(options.maxFiles, "maxFiles", DEFAULT_MAX_FILES);
+  const maxSessions = validatePositiveInt(options.maxSessions, "maxSessions", DEFAULT_MAX_SESSIONS);
+  const redactionConfig = options.redactionConfig ?? {};
+  const excerptsRequested = options.includeRedactedExcerpts === true;
+  const redactionRules = compileRedactionRules({
+    ...redactionConfig,
+    ...excerptsRequested ? { disableDefaults: false } : {}
+  });
+  const includeRedactedExcerpts = options.includeRedactedExcerpts === true && redactionRules.length > 0;
+  const listed = await listTranscriptFiles(inputDir, maxFiles);
+  const files = listed.files;
+  const generatedAt = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const warnings = [];
+  const sessions = /* @__PURE__ */ new Map();
+  const seenFileHashes = /* @__PURE__ */ new Set();
+  let turnsParsed = 0;
+  let filesParsed = 0;
+  if (listed.truncated) {
+    warnings.push({
+      code: "session-summaries.max_files_truncated",
+      message: `Scanned the first ${maxFiles} transcript file(s); increase maxFiles to include all matching files.`
+    });
+  }
+  if (excerptsRequested && redactionConfig.disableDefaults === true) {
+    warnings.push({
+      code: "session-summaries.default_redaction_forced_for_excerpts",
+      message: "Default redaction rules were enabled because redacted excerpts were requested."
+    });
+  }
+  if (excerptsRequested && redactionRules.length === 0) {
+    warnings.push({
+      code: "session-summaries.excerpts_suppressed_no_redaction",
+      message: "Redacted excerpts were requested, but no redaction rules are enabled; excerpts were omitted."
+    });
+  }
+  for (const filePath of files) {
+    const content = await readFile(filePath, "utf-8");
+    const fileHash = shortHash(content, 24);
+    if (seenFileHashes.has(fileHash)) {
+      warnings.push({
+        code: "session-summaries.duplicate_file_skipped",
+        message: "Skipped a duplicate transcript file with identical content.",
+        fileRef: fileHash
+      });
+      continue;
+    }
+    seenFileHashes.add(fileHash);
+    const fileExtension = path13.extname(filePath).toLowerCase();
+    const parsed = await adapter.parseFile(
+      {
+        content,
+        fileName: path13.basename(filePath),
+        fileExtension,
+        fileRef: fileHash
+      },
+      { strict: options.strict }
+    );
+    warnings.push(...parsed.warnings);
+    if (parsed.turns.length === 0) continue;
+    filesParsed += 1;
+    for (const turn of parsed.turns) {
+      turnsParsed += 1;
+      const sessionKey = turn.sessionKey?.trim() || `${adapter.id}:${fileHash}`;
+      const bucket = sessions.get(sessionKey) ?? [];
+      bucket.push({ ...turn, fileHash, fileExtension });
+      sessions.set(sessionKey, bucket);
+    }
+  }
+  const drafts = [];
+  const sessionEntries = [...sessions.entries()].sort(([aKey, a], [bKey, b]) => {
+    const aFirst = earliestTurnSortValue(a);
+    const bFirst = earliestTurnSortValue(b);
+    return aFirst - bFirst || a[0]?.fileHash.localeCompare(b[0]?.fileHash ?? "") || aKey.localeCompare(bKey);
+  });
+  if (sessionEntries.length > maxSessions) {
+    warnings.push({
+      code: "session-summaries.max_sessions_truncated",
+      message: `Summarized ${maxSessions} of ${sessionEntries.length} session(s); increase maxSessions to include all parsed sessions.`
+    });
+  }
+  for (const [sessionKey, turns] of sessionEntries.slice(0, maxSessions)) {
+    drafts.push(
+      buildDraft({
+        source: adapter.id,
+        sessionKey,
+        turns,
+        generatedAt,
+        redactionRules,
+        includeRedactedExcerpts
+      })
+    );
+  }
+  drafts.sort((a, b) => (a.firstTimestamp ?? "").localeCompare(b.firstTimestamp ?? ""));
+  return {
+    generatedAt,
+    source: adapter.id,
+    filesScanned: files.length,
+    filesParsed,
+    turnsParsed,
+    sessionsSummarized: drafts.length,
+    warnings,
+    drafts,
+    wroteFiles: []
+  };
+}
+async function readRedactionConfig(pathLike) {
+  if (!pathLike) return void 0;
+  const raw = await readFile(path13.resolve(expandTildePath(pathLike)), "utf-8");
+  const parsed = JSON.parse(raw);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("redaction config must be a JSON object");
+  }
+  return parsed;
+}
+function toJsonl(drafts) {
+  return `${drafts.map((draft) => JSON.stringify(draft)).join("\n")}
+`;
+}
+function defaultDraftOutputPath(memoryDir, generatedAt) {
+  const stamp = generatedAt.replace(/[:.]/g, "-");
+  return path13.join(
+    path13.resolve(expandTildePath(memoryDir)),
+    "state",
+    "session-summary-drafts",
+    `session-summaries-${stamp}.jsonl`
+  );
+}
+async function writeDrafts(filePath, drafts) {
+  await mkdir(path13.dirname(filePath), { recursive: true });
+  const tempPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+  try {
+    await writeFile(tempPath, toJsonl(drafts), "utf-8");
+    await rename(tempPath, filePath);
+  } catch (error) {
+    await rm(tempPath, { force: true });
+    throw error;
+  }
+}
+async function runLocalSessionSummaryCliCommand(options) {
+  const redactionConfig = options.redactionConfig ?? await readRedactionConfig(options.redactionConfigPath);
+  const report = await collectLocalSessionSummaries({
+    ...options,
+    ...redactionConfig ? { redactionConfig } : {}
+  });
+  const wroteFiles = [];
+  if (options.output) {
+    const outputPath = path13.resolve(expandTildePath(options.output));
+    await writeDrafts(outputPath, report.drafts);
+    wroteFiles.push(outputPath);
+  }
+  if (options.write === true) {
+    if (!options.memoryDir || options.memoryDir.trim().length === 0) {
+      throw new Error("memoryDir is required when write is true");
+    }
+    const outputPath = defaultDraftOutputPath(options.memoryDir, report.generatedAt);
+    await writeDrafts(outputPath, report.drafts);
+    wroteFiles.push(outputPath);
+  }
+  const stdout = options.stdout;
+  if (stdout) {
+    stdout.write(`Local session summaries complete (source: ${report.source})
+`);
+    stdout.write(`  Files scanned:        ${report.filesScanned}
+`);
+    stdout.write(`  Files parsed:         ${report.filesParsed}
+`);
+    stdout.write(`  Turns parsed:         ${report.turnsParsed}
+`);
+    stdout.write(`  Sessions summarized:  ${report.sessionsSummarized}
+`);
+    stdout.write(`  Draft files written:  ${wroteFiles.length}
+`);
+    if (wroteFiles.length === 0) {
+      stdout.write("  (dry run - no Remnic draft files were written)\n");
+    }
+  }
+  return { ...report, wroteFiles };
+}
+
+// src/transfer/capsule-fork.ts
+import { lstat as lstat2, mkdir as mkdir2, readFile as readFile2, realpath, writeFile as writeFile2 } from "fs/promises";
+import path14 from "path";
 async function forkCapsule(opts) {
   validateForkId(opts.forkId);
-  const rootAbs = path13.resolve(opts.targetRoot);
+  const rootAbs = path14.resolve(opts.targetRoot);
   await assertIsDirectoryNotSymlink(rootAbs, "forkCapsule", "targetRoot");
-  const forkDirAbs = path13.join(rootAbs, "forks", opts.forkId);
+  const forkDirAbs = path14.join(rootAbs, "forks", opts.forkId);
   const forkEntryExists = await pathEntryExists(forkDirAbs);
   if (forkEntryExists) {
     throw new Error(
       `forkCapsule: fork path already exists \u2014 forkId "${opts.forkId}" is already in use at: ${forkDirAbs}`
     );
   }
-  const archiveAbs = path13.resolve(opts.sourceArchive);
+  const archiveAbs = path14.resolve(opts.sourceArchive);
   const importResult = await importCapsule({
     archivePath: archiveAbs,
     root: rootAbs,
@@ -4727,11 +5567,11 @@ async function forkCapsule(opts) {
     importedRecords: importResult.imported.length,
     skippedRecords: importResult.skipped.length
   };
-  const lineagePath = path13.join(forkDirAbs, "lineage.json");
+  const lineagePath = path14.join(forkDirAbs, "lineage.json");
   const rootReal = await realpath(rootAbs);
   await assertRealpathInsideRoot(rootReal, lineagePath, `forks/${opts.forkId}/lineage.json`, "forkCapsule");
-  await mkdir(path13.dirname(lineagePath), { recursive: true });
-  await writeFile(lineagePath, JSON.stringify(lineage, null, 2) + "\n", "utf-8");
+  await mkdir2(path14.dirname(lineagePath), { recursive: true });
+  await writeFile2(lineagePath, JSON.stringify(lineage, null, 2) + "\n", "utf-8");
   return {
     archivePath: archiveAbs,
     manifest,
@@ -4744,17 +5584,17 @@ async function readForkLineage(targetRoot, forkId) {
   if (typeof forkId !== "string" || forkId.length === 0 || forkId.length > 64 || !CAPSULE_ID_PATTERN.test(forkId)) {
     return null;
   }
-  const rootAbs = path13.resolve(targetRoot);
+  const rootAbs = path14.resolve(targetRoot);
   const rootReal = await realpath(rootAbs).catch(() => rootAbs);
-  const lineagePath = path13.join(rootReal, "forks", forkId, "lineage.json");
-  const rel = path13.relative(rootReal, lineagePath);
-  if (rel.startsWith("..") || path13.isAbsolute(rel)) {
+  const lineagePath = path14.join(rootReal, "forks", forkId, "lineage.json");
+  const rel = path14.relative(rootReal, lineagePath);
+  if (rel.startsWith("..") || path14.isAbsolute(rel)) {
     return null;
   }
   if (!await isLineagePathContained(rootReal, lineagePath)) {
     return null;
   }
-  const raw = await readFile(lineagePath, "utf-8").catch(() => null);
+  const raw = await readFile2(lineagePath, "utf-8").catch(() => null);
   if (raw === null) return null;
   try {
     const parsed = JSON.parse(raw);
@@ -4783,25 +5623,25 @@ function validateForkId(forkId) {
   }
 }
 async function pathEntryExists(absPath) {
-  const st = await lstat(absPath).catch(() => null);
+  const st = await lstat2(absPath).catch(() => null);
   return st !== null;
 }
 async function isLineagePathContained(rootReal, lineagePath) {
   let existing = lineagePath;
   const suffix = [];
-  while (existing !== path13.dirname(existing)) {
-    const st = await lstat(existing).catch(() => null);
+  while (existing !== path14.dirname(existing)) {
+    const st = await lstat2(existing).catch(() => null);
     if (st !== null) break;
-    suffix.unshift(path13.basename(existing));
-    existing = path13.dirname(existing);
+    suffix.unshift(path14.basename(existing));
+    existing = path14.dirname(existing);
   }
   const existingReal = await realpath(existing).catch(() => existing);
-  const targetReal = suffix.length > 0 ? path13.join(existingReal, ...suffix) : existingReal;
-  const rel = path13.relative(rootReal, targetReal);
+  const targetReal = suffix.length > 0 ? path14.join(existingReal, ...suffix) : existingReal;
+  const rel = path14.relative(rootReal, targetReal);
   if (rel === "") return true;
   if (rel === "..") return false;
-  if (rel.startsWith(`..${path13.sep}`)) return false;
-  if (path13.isAbsolute(rel)) return false;
+  if (rel.startsWith(`..${path14.sep}`)) return false;
+  if (path14.isAbsolute(rel)) return false;
   return true;
 }
 export {
@@ -4831,6 +5671,7 @@ export {
   DEFAULT_PPR_TOLERANCE,
   DEFAULT_REASONING_TRACE_BOOST,
   DEFAULT_RECALL_DISCLOSURE,
+  DEFAULT_REDACTION_RULES,
   DEFAULT_SCAN_PATTERNS,
   DEFAULT_SELF_NAME,
   DEFAULT_SURPRISE_K,
@@ -4956,12 +5797,14 @@ export {
   collectContentLexicalCues,
   collectExplicitTurnReferences,
   collectLexicalCues,
+  collectLocalSessionSummaries,
   collectQuestionSlotCues,
   collectStructuredPlanCues,
   collectTemporalLexicalCues,
   compileCorrectionRule,
   compileCorrectionRules,
   compileRedactionPatterns,
+  compileRedactionRules,
   composeDayTranscriptBody,
   composeDayTranscriptMeta,
   computeMemoryWorth,
@@ -5034,6 +5877,7 @@ export {
   getBulkImportSource,
   getConnectorToken,
   getHostEmbeddingProvider,
+  getLocalSessionSourceAdapter,
   getManifestPath,
   getMemoryForActiveMemory,
   getSpacesDir,
@@ -5083,6 +5927,7 @@ export {
   listBulkImportSources,
   listConnectorStates,
   listConnectors,
+  listLocalSessionSourceAdapters,
   listPairs,
   listPeers,
   listReviewItems,
@@ -5183,9 +6028,11 @@ export {
   recallRequestSchema,
   recordMemoryOutcome,
   redactConnectorConfigSecrets,
+  redactSessionSummaryText,
   redactText,
   registerBulkImportSource,
   registerHostEmbeddingProvider,
+  registerLocalSessionSourceAdapter,
   registerPublisher,
   registerTrainingExportAdapter,
   registerWearableConnector,
@@ -5228,6 +6075,7 @@ export {
   runGraphRecall,
   runImporter,
   runLiveConnectorsOnce,
+  runLocalSessionSummaryCliCommand,
   runPostConsolidationMaterialize,
   runWearablesCliCommand,
   sanitizeNoteForCitation,