@remnic/core 1.1.12 → 1.1.13

package/dist/surfaces/heartbeat.js

@@ -0,0 +1,265 @@
+import "../chunk-PZ5AY32C.js";
+
+// src/surfaces/heartbeat.ts
+import { createHash } from "crypto";
+import { statSync, watch } from "fs";
+import { readFile } from "fs/promises";
+import path from "path";
+function stableHeartbeatId(params) {
+  const digest = createHash("sha1").update(
+    JSON.stringify({
+      sourceOffset: params.sourceOffset
+    })
+  ).digest("hex").slice(0, 12);
+  return `heartbeat-${digest}`;
+}
+function slugify(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (normalized.length > 0) return normalized;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return "heartbeat-untitled";
+  return `heartbeat-${createHash("sha1").update(trimmed).digest("hex").slice(0, 8)}`;
+}
+function parseTags(line) {
+  const match = /^Tags:\s*(.*)$/i.exec(line.trim());
+  if (!match) return [];
+  return match[1].split(/\s+/).map((token) => token.trim()).filter(Boolean).map((token) => token.replace(/^#/, ""));
+}
+function buildEntry(params) {
+  return {
+    slug: params.slug,
+    title: params.title.trim(),
+    body: params.body.trim(),
+    schedule: params.schedule?.trim() || null,
+    tags: params.tags,
+    sourceOffset: params.sourceOffset
+  };
+}
+function finalizeHeartbeatEntries(entries) {
+  return entries.map((entry) => {
+    return {
+      ...entry,
+      id: stableHeartbeatId({
+        sourceOffset: entry.sourceOffset
+      })
+    };
+  });
+}
+function parseSectionEntries(content) {
+  const entries = [];
+  const regex = /^##\s+(.+)$/gm;
+  const matches = [...content.matchAll(regex)];
+  for (let index = 0; index < matches.length; index += 1) {
+    const match = matches[index];
+    const start = match.index ?? 0;
+    const end = index + 1 < matches.length ? matches[index + 1]?.index ?? content.length : content.length;
+    const rawTitle = match[1]?.trim() ?? "";
+    const chunk = content.slice(start + match[0].length, end).replace(/^\s+/, "");
+    const trimmed = chunk.replace(/\n---\s*$/, "").trim();
+    const lines = trimmed.split("\n");
+    const tags = lines.length > 0 ? parseTags(lines[lines.length - 1] ?? "") : [];
+    const withoutTags = tags.length > 0 ? lines.slice(0, Math.max(0, lines.length - 1)) : lines;
+    let schedule = null;
+    const bodyLines = [];
+    for (const line of withoutTags) {
+      const scheduleMatch = /^Schedule:\s*(.+)$/i.exec(line.trim());
+      if (scheduleMatch) {
+        schedule = scheduleMatch[1]?.trim() || null;
+        continue;
+      }
+      bodyLines.push(line);
+    }
+    entries.push(
+      buildEntry({
+        slug: slugify(rawTitle),
+        title: rawTitle,
+        body: bodyLines.join("\n"),
+        schedule,
+        tags,
+        sourceOffset: start
+      })
+    );
+  }
+  return entries;
+}
+function parseTaskBlock(content) {
+  const lines = content.split("\n");
+  const entries = [];
+  let inTasks = false;
+  let offset = 0;
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index] ?? "";
+    const lineOffset = offset;
+    offset += line.length + 1;
+    const trimmed = line.trim();
+    if (trimmed === "tasks:") {
+      inTasks = true;
+      continue;
+    }
+    if (!inTasks) continue;
+    if (trimmed.startsWith("- name:")) {
+      const title = trimmed.replace(/^- name:\s*/, "").replace(/^["']|["']$/g, "").trim();
+      let schedule = null;
+      let body = "";
+      let cursor = index + 1;
+      for (; cursor < lines.length; cursor += 1) {
+        const next = lines[cursor] ?? "";
+        const nextTrimmed = next.trim();
+        if (nextTrimmed.startsWith("- name:")) break;
+        if (!next.startsWith(" ") && nextTrimmed) break;
+        if (nextTrimmed.startsWith("interval:")) {
+          schedule = nextTrimmed.replace(/^interval:\s*/, "").replace(/^["']|["']$/g, "").trim();
+          continue;
+        }
+        if (nextTrimmed.startsWith("prompt:")) {
+          const promptValue = nextTrimmed.replace(/^prompt:\s*/, "").trim();
+          if (promptValue === "|" || promptValue === ">") {
+            const scalarIndent = next.match(/^\s*/)?.[0].length ?? 0;
+            const collectedLines = [];
+            let scalarCursor = cursor + 1;
+            for (; scalarCursor < lines.length; scalarCursor += 1) {
+              const scalarLine = lines[scalarCursor] ?? "";
+              const scalarTrimmed = scalarLine.trim();
+              const scalarIndentation = scalarLine.match(/^\s*/)?.[0].length ?? 0;
+              if (scalarTrimmed.length > 0 && scalarIndentation <= scalarIndent) break;
+              if (scalarTrimmed.length === 0) {
+                collectedLines.push("");
+                continue;
+              }
+              collectedLines.push(scalarLine);
+            }
+            const meaningful = collectedLines.filter((line2) => line2.trim().length > 0);
+            const commonIndent = meaningful.length > 0 ? Math.min(
+              ...meaningful.map((line2) => line2.match(/^\s*/)?.[0].length ?? 0)
+            ) : scalarIndent + 2;
+            const normalizedPromptLines = collectedLines.map(
+              (line2) => line2.trim().length > 0 ? line2.slice(commonIndent) : ""
+            );
+            body = promptValue === ">" ? normalizedPromptLines.map((line2) => line2.trim()).filter((line2) => line2.length > 0).join(" ") : normalizedPromptLines.join("\n").trim();
+            cursor = Math.max(cursor, scalarCursor - 1);
+            continue;
+          }
+          body = promptValue.replace(/^["']|["']$/g, "").trim();
+        }
+      }
+      entries.push(
+        buildEntry({
+          slug: slugify(title),
+          title,
+          body,
+          schedule,
+          tags: [],
+          sourceOffset: lineOffset
+        })
+      );
+      index = Math.max(index, cursor - 1);
+    }
+  }
+  return entries;
+}
+function parseHeartbeatEntries(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  const sectionEntries = parseSectionEntries(normalized);
+  if (sectionEntries.length > 0) return finalizeHeartbeatEntries(sectionEntries);
+  return finalizeHeartbeatEntries(parseTaskBlock(normalized));
+}
+function createHeartbeatSurface() {
+  return {
+    async read(filePath) {
+      try {
+        const content = await readFile(filePath, "utf8");
+        return parseHeartbeatEntries(content);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return [];
+        }
+        throw error;
+      }
+    },
+    watch(filePath, onChange) {
+      let fileWatcher = null;
+      let parentWatcher = null;
+      let timer = null;
+      const watchedName = path.basename(filePath);
+      const watchedDir = path.dirname(filePath);
+      const resolveParentWatchTarget = () => {
+        let candidateDir = watchedDir;
+        while (true) {
+          try {
+            if (statSync(candidateDir).isDirectory()) {
+              const relative = path.relative(candidateDir, watchedDir);
+              return {
+                dir: candidateDir,
+                expectedName: relative.length === 0 ? watchedName : relative.split(path.sep)[0] ?? watchedName
+              };
+            }
+          } catch {
+          }
+          const parentDir = path.dirname(candidateDir);
+          if (parentDir === candidateDir) {
+            return null;
+          }
+          candidateDir = parentDir;
+        }
+      };
+      const rearmFileWatcher = () => {
+        fileWatcher?.close();
+        fileWatcher = null;
+        try {
+          fileWatcher = watch(filePath, { persistent: false }, emit);
+        } catch {
+          fileWatcher = null;
+        }
+      };
+      const ensureParentWatcher = () => {
+        if (parentWatcher) return;
+        const target = resolveParentWatchTarget();
+        if (!target) return;
+        try {
+          parentWatcher = watch(
+            target.dir,
+            { persistent: false },
+            (_eventType, changed) => {
+              if (changed && String(changed) !== target.expectedName) return;
+              parentWatcher?.close();
+              parentWatcher = null;
+              ensureParentWatcher();
+              rearmFileWatcher();
+              if (target.expectedName === watchedName || fileWatcher) {
+                emit();
+              }
+            }
+          );
+        } catch {
+          parentWatcher = null;
+        }
+      };
+      const emit = () => {
+        if (timer) clearTimeout(timer);
+        timer = setTimeout(async () => {
+          timer = null;
+          try {
+            rearmFileWatcher();
+            onChange(await this.read(filePath));
+          } catch (error) {
+            console.warn("[remnic] heartbeat surface watch update failed", error);
+          }
+        }, 25);
+      };
+      rearmFileWatcher();
+      ensureParentWatcher();
+      return () => {
+        if (timer) clearTimeout(timer);
+        fileWatcher?.close();
+        parentWatcher?.close();
+      };
+    },
+    findBySlug(entries, slug) {
+      return entries.find((entry) => entry.slug === slug) ?? null;
+    }
+  };
+}
+export {
+  createHeartbeatSurface
+};
+//# sourceMappingURL=heartbeat.js.map

package/dist/surfaces/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/surfaces/heartbeat.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { statSync, watch, type FSWatcher } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport interface HeartbeatEntry {\n  id: string;\n  slug: string;\n  title: string;\n  body: string;\n  schedule: string | null;\n  tags: string[];\n  sourceOffset: number;\n}\n\nexport interface HeartbeatSurface {\n  read(path: string): Promise<HeartbeatEntry[]>;\n  watch(path: string, onChange: (entries: HeartbeatEntry[]) => void): () => void;\n  findBySlug(entries: HeartbeatEntry[], slug: string): HeartbeatEntry | null;\n}\n\nfunction stableHeartbeatId(params: {\n  sourceOffset: number;\n}): string {\n  const digest = createHash(\"sha1\")\n    .update(\n      JSON.stringify({\n        sourceOffset: params.sourceOffset,\n      }),\n    )\n    .digest(\"hex\")\n    .slice(0, 12);\n  return `heartbeat-${digest}`;\n}\n\ntype ParsedHeartbeatEntry = Omit<HeartbeatEntry, \"id\">;\n\nfunction slugify(value: string): string {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  if (normalized.length > 0) return normalized;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return \"heartbeat-untitled\";\n  return `heartbeat-${createHash(\"sha1\").update(trimmed).digest(\"hex\").slice(0, 8)}`;\n}\n\nfunction parseTags(line: string): string[] {\n  const match = /^Tags:\\s*(.*)$/i.exec(line.trim());\n  if (!match) return [];\n  return match[1]\n    .split(/\\s+/)\n    .map((token) => token.trim())\n    .filter(Boolean)\n    .map((token) => token.replace(/^#/, \"\"));\n}\n\nfunction buildEntry(params: {\n  slug: string;\n  title: string;\n  body: string;\n  schedule: string | null;\n  tags: string[];\n  sourceOffset: number;\n}): ParsedHeartbeatEntry {\n  return {\n    slug: params.slug,\n    title: params.title.trim(),\n    body: params.body.trim(),\n    schedule: params.schedule?.trim() || null,\n    tags: params.tags,\n    sourceOffset: params.sourceOffset,\n  };\n}\n\nfunction finalizeHeartbeatEntries(entries: ParsedHeartbeatEntry[]): HeartbeatEntry[] {\n  return entries.map((entry) => {\n    return {\n      ...entry,\n      id: stableHeartbeatId({\n        sourceOffset: entry.sourceOffset,\n      }),\n    };\n  });\n}\n\nfunction parseSectionEntries(content: string): ParsedHeartbeatEntry[] {\n  const entries: ParsedHeartbeatEntry[] = [];\n  const regex = /^##\\s+(.+)$/gm;\n  const matches = [...content.matchAll(regex)];\n  for (let index = 0; index < matches.length; index += 1) {\n    const match = matches[index];\n    const start = match.index ?? 0;\n    const end = index + 1 < matches.length ? (matches[index + 1]?.index ?? content.length) : content.length;\n    const rawTitle = match[1]?.trim() ?? \"\";\n    const chunk = content.slice(start + match[0].length, end).replace(/^\\s+/, \"\");\n    const trimmed = chunk.replace(/\\n---\\s*$/, \"\").trim();\n    const lines = trimmed.split(\"\\n\");\n    const tags = lines.length > 0 ? parseTags(lines[lines.length - 1] ?? \"\") : [];\n    const withoutTags =\n      tags.length > 0\n        ? lines.slice(0, Math.max(0, lines.length - 1))\n        : lines;\n    let schedule: string | null = null;\n    const bodyLines: string[] = [];\n    for (const line of withoutTags) {\n      const scheduleMatch = /^Schedule:\\s*(.+)$/i.exec(line.trim());\n      if (scheduleMatch) {\n        schedule = scheduleMatch[1]?.trim() || null;\n        continue;\n      }\n      bodyLines.push(line);\n    }\n    entries.push(\n      buildEntry({\n        slug: slugify(rawTitle),\n        title: rawTitle,\n        body: bodyLines.join(\"\\n\"),\n        schedule,\n        tags,\n        sourceOffset: start,\n      }),\n    );\n  }\n  return entries;\n}\n\nfunction parseTaskBlock(content: string): ParsedHeartbeatEntry[] {\n  const lines = content.split(\"\\n\");\n  const entries: ParsedHeartbeatEntry[] = [];\n  let inTasks = false;\n  let offset = 0;\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index] ?? \"\";\n    const lineOffset = offset;\n    offset += line.length + 1;\n    const trimmed = line.trim();\n    if (trimmed === \"tasks:\") {\n      inTasks = true;\n      continue;\n    }\n    if (!inTasks) continue;\n    if (trimmed.startsWith(\"- name:\")) {\n      const title = trimmed.replace(/^- name:\\s*/, \"\").replace(/^[\"']|[\"']$/g, \"\").trim();\n      let schedule: string | null = null;\n      let body = \"\";\n      let cursor = index + 1;\n      for (; cursor < lines.length; cursor += 1) {\n        const next = lines[cursor] ?? \"\";\n        const nextTrimmed = next.trim();\n        if (nextTrimmed.startsWith(\"- name:\")) break;\n        if (!next.startsWith(\" \") && nextTrimmed) break;\n        if (nextTrimmed.startsWith(\"interval:\")) {\n          schedule = nextTrimmed.replace(/^interval:\\s*/, \"\").replace(/^[\"']|[\"']$/g, \"\").trim();\n          continue;\n        }\n        if (nextTrimmed.startsWith(\"prompt:\")) {\n          const promptValue = nextTrimmed.replace(/^prompt:\\s*/, \"\").trim();\n          if (promptValue === \"|\" || promptValue === \">\") {\n            const scalarIndent = next.match(/^\\s*/)?.[0].length ?? 0;\n            const collectedLines: string[] = [];\n            let scalarCursor = cursor + 1;\n            for (; scalarCursor < lines.length; scalarCursor += 1) {\n              const scalarLine = lines[scalarCursor] ?? \"\";\n              const scalarTrimmed = scalarLine.trim();\n              const scalarIndentation = scalarLine.match(/^\\s*/)?.[0].length ?? 0;\n              if (scalarTrimmed.length > 0 && scalarIndentation <= scalarIndent) break;\n              if (scalarTrimmed.length === 0) {\n                collectedLines.push(\"\");\n                continue;\n              }\n              collectedLines.push(scalarLine);\n            }\n            const meaningful = collectedLines.filter((line) => line.trim().length > 0);\n            const commonIndent =\n              meaningful.length > 0\n                ? Math.min(\n                    ...meaningful.map((line) => line.match(/^\\s*/)?.[0].length ?? 0),\n                  )\n                : scalarIndent + 2;\n            const normalizedPromptLines = collectedLines.map((line) =>\n              line.trim().length > 0 ? line.slice(commonIndent) : \"\",\n            );\n            body =\n              promptValue === \">\"\n                ? normalizedPromptLines\n                    .map((line) => line.trim())\n                    .filter((line) => line.length > 0)\n                    .join(\" \")\n                : normalizedPromptLines.join(\"\\n\").trim();\n            cursor = Math.max(cursor, scalarCursor - 1);\n            continue;\n          }\n          body = promptValue.replace(/^[\"']|[\"']$/g, \"\").trim();\n        }\n      }\n      entries.push(\n        buildEntry({\n          slug: slugify(title),\n          title,\n          body,\n          schedule,\n          tags: [],\n          sourceOffset: lineOffset,\n        }),\n      );\n      index = Math.max(index, cursor - 1);\n    }\n  }\n  return entries;\n}\n\nfunction parseHeartbeatEntries(content: string): HeartbeatEntry[] {\n  const normalized = content.replace(/\\r\\n/g, \"\\n\");\n  const sectionEntries = parseSectionEntries(normalized);\n  if (sectionEntries.length > 0) return finalizeHeartbeatEntries(sectionEntries);\n  return finalizeHeartbeatEntries(parseTaskBlock(normalized));\n}\n\nexport function createHeartbeatSurface(): HeartbeatSurface {\n  return {\n    async read(filePath: string): Promise<HeartbeatEntry[]> {\n      try {\n        const content = await readFile(filePath, \"utf8\");\n        return parseHeartbeatEntries(content);\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n          return [];\n        }\n        throw error;\n      }\n    },\n\n    watch(filePath: string, onChange: (entries: HeartbeatEntry[]) => void): () => void {\n      let fileWatcher: FSWatcher | null = null;\n      let parentWatcher: FSWatcher | null = null;\n      let timer: NodeJS.Timeout | null = null;\n      const watchedName = path.basename(filePath);\n      const watchedDir = path.dirname(filePath);\n\n      const resolveParentWatchTarget = (): { dir: string; expectedName: string } | null => {\n        let candidateDir = watchedDir;\n        while (true) {\n          try {\n            if (statSync(candidateDir).isDirectory()) {\n              const relative = path.relative(candidateDir, watchedDir);\n              return {\n                dir: candidateDir,\n                expectedName:\n                  relative.length === 0\n                    ? watchedName\n                    : (relative.split(path.sep)[0] ?? watchedName),\n              };\n            }\n          } catch {}\n          const parentDir = path.dirname(candidateDir);\n          if (parentDir === candidateDir) {\n            return null;\n          }\n          candidateDir = parentDir;\n        }\n      };\n\n      const rearmFileWatcher = () => {\n        fileWatcher?.close();\n        fileWatcher = null;\n        try {\n          fileWatcher = watch(filePath, { persistent: false }, emit);\n        } catch {\n          fileWatcher = null;\n        }\n      };\n\n      const ensureParentWatcher = () => {\n        if (parentWatcher) return;\n        const target = resolveParentWatchTarget();\n        if (!target) return;\n        try {\n          parentWatcher = watch(\n            target.dir,\n            { persistent: false },\n            (_eventType, changed) => {\n              if (changed && String(changed) !== target.expectedName) return;\n              parentWatcher?.close();\n              parentWatcher = null;\n              ensureParentWatcher();\n              rearmFileWatcher();\n              if (target.expectedName === watchedName || fileWatcher) {\n                emit();\n              }\n            },\n          );\n        } catch {\n          parentWatcher = null;\n        }\n      };\n\n      const emit = () => {\n        if (timer) clearTimeout(timer);\n        timer = setTimeout(async () => {\n          timer = null;\n          try {\n            rearmFileWatcher();\n            onChange(await this.read(filePath));\n          } catch (error) {\n            console.warn(\"[remnic] heartbeat surface watch update failed\", error);\n          }\n        }, 25);\n      };\n      rearmFileWatcher();\n      ensureParentWatcher();\n      return () => {\n        if (timer) clearTimeout(timer);\n        fileWatcher?.close();\n        parentWatcher?.close();\n      };\n    },\n\n    findBySlug(entries: HeartbeatEntry[], slug: string): HeartbeatEntry | null {\n      return entries.find((entry) => entry.slug === slug) ?? null;\n    },\n  };\n}\n"],"mappings":"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","names":["line"]}

package/dist/temporal-supersession.d.ts

@@ -3,7 +3,9 @@ import { StorageManager } from './storage.js';
 import './index-DJ9QWMw-.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-CY8TU40w.js';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
 import 'better-sqlite3';
 
 /**

package/dist/threading.d.ts

@@ -16,6 +16,11 @@ declare class ThreadingManager {
     private lastSessionKey;
     constructor(threadsDir: string, gapMinutes?: number);
     ensureDirectory(): Promise<void>;
+    private encodedThreadFileName;
+    private collisionSafeThreadFileName;
+    private legacyThreadFileName;
+    private threadCandidateStatus;
+    private threadFilePathForWrite;
     /**
      * Check if we should start a new thread based on session key and time gap.
      */

package/dist/threading.js

@@ -1,6 +1,7 @@
 import {
   ThreadingManager
-} from "./chunk-JRNQ3RNA.js";
+} from "./chunk-W4RVMTHR.js";
+import "./chunk-FF4KLI5W.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/tier-migration.d.ts

@@ -1,11 +1,13 @@
 import { MemoryFile } from './types.js';
 import { StorageManager } from './storage.js';
 import { MemoryTier } from './tier-routing.js';
-import { S as SearchBackend } from './port-B6VEDIkC.js';
+import { SearchBackend } from './search/port.js';
 import './index-DJ9QWMw-.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-CY8TU40w.js';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
 import 'better-sqlite3';
 import './lifecycle.js';
 

package/dist/tokens.js

@@ -9,8 +9,8 @@ import {
   resolveConnectorFromToken,
   revokeToken,
   saveTokenStore
-} from "./chunk-HQZVVSVB.js";
-import "./chunk-MARWOCVP.js";
+} from "./chunk-MSWG7JI6.js";
+import "./chunk-XIG5PDM7.js";
 import "./chunk-PZ5AY32C.js";
 export {
   buildTokenEntry,

package/dist/transcript.d.ts

@@ -18,6 +18,7 @@ declare class TranscriptManager {
     private toolUsageDir;
     private config;
     private sessionFootprintCache;
+    private directoryOwnershipCache;
     /** Default checkpoint TTL in hours */
     private static readonly DEFAULT_CHECKPOINT_TTL_HOURS;
     /** Approximate characters per token for rough estimation */
@@ -32,11 +33,15 @@ declare class TranscriptManager {
      *   - agent:<agent-id>:cron:<job-id> → type="cron", id="<job-id>"
      *   - agent:<agent-id>:slack:channel:<channel-id> → type="slack", id="<channel-id>"
      *
-     * @returns Object with dir (channel type/channel id) and file (YYYY-MM-DD.jsonl)
+     * @returns Object with raw channel identifiers and encoded storage path pieces.
      */
     getTranscriptPath(sessionKey: string): {
         dir: string;
         file: string;
+        channelType: string;
+        channelId: string;
+        alternateDir: string;
+        legacyDir?: string;
     };
     /**
      * Initialize the transcript manager by ensuring directories exist.
@@ -51,7 +56,16 @@ declare class TranscriptManager {
     getToolUsagePath(sessionKey: string): {
         dir: string;
         file: string;
+        alternateDir: string;
+        legacyDir?: string;
     };
+    private selectStorageDirForWrite;
+    private directorySessionStatus;
+    private directoryOwnershipCacheKey;
+    private sameFileSizes;
+    private directoryJsonlFileSizes;
+    private rememberDirectoryOwnership;
+    private getSessionStorageFiles;
     appendToolUse(entry: {
         timestamp: string;
         sessionKey: string;

package/dist/transcript.js

@@ -1,6 +1,7 @@
 import {
   TranscriptManager
-} from "./chunk-E6K4NIEU.js";
+} from "./chunk-5375UYTQ.js";
+import "./chunk-FF4KLI5W.js";
 import "./chunk-YRMVARQP.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";

package/dist/transfer/autodetect.d.ts

@@ -0,0 +1,4 @@
+type ImportFormat = "json" | "sqlite" | "md";
+declare function detectImportFormat(fromPath: string): Promise<ImportFormat | null>;
+
+export { type ImportFormat, detectImportFormat };

package/dist/transfer/autodetect.js

@@ -0,0 +1,15 @@
+import {
+  detectImportFormat
+} from "../chunk-DOM4GKSW.js";
+import "../chunk-W4L6CZKA.js";
+import "../chunk-3JXBXXM2.js";
+import "../chunk-6H2TESSP.js";
+import "../chunk-WEHSQBFR.js";
+import "../chunk-J4EB7DNW.js";
+import "../chunk-I6K5FBRQ.js";
+import "../chunk-AGZQD76C.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  detectImportFormat
+};
+//# sourceMappingURL=autodetect.js.map

package/dist/transfer/autodetect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/transfer/backup.d.ts

@@ -0,0 +1,21 @@
+interface BackupOptions {
+    memoryDir: string;
+    outDir: string;
+    includeTranscripts?: boolean;
+    retentionDays?: number;
+    pluginVersion: string;
+    /**
+     * When `true`, produce an encrypted backup archive instead of a plaintext
+     * directory. The secure-store keyring for `memoryDir` must be unlocked.
+     *
+     * An encrypted backup is a single `.backup.tar.gz.enc` file instead of a
+     * timestamped directory. It contains a gzip-compressed JSON bundle (same
+     * shape as the json export) sealed with AES-256-GCM.
+     *
+     * Default: `false`.
+     */
+    encrypt?: boolean;
+}
+declare function backupMemoryDir(opts: BackupOptions): Promise<string>;
+
+export { type BackupOptions, backupMemoryDir };

package/dist/transfer/backup.js

@@ -0,0 +1,17 @@
+import {
+  backupMemoryDir
+} from "../chunk-7OZ53EXP.js";
+import "../chunk-6H2TESSP.js";
+import "../chunk-KNKUID7G.js";
+import "../chunk-J4EB7DNW.js";
+import "../chunk-I6K5FBRQ.js";
+import "../chunk-AGZQD76C.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-A6XUJE5D.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  backupMemoryDir
+};
+//# sourceMappingURL=backup.js.map

package/dist/transfer/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/transfer/capsule-export.d.ts

@@ -0,0 +1,113 @@
+import { CapsuleBlock, ExportManifestV2 } from './types.js';
+import 'zod';
+
+/**
+ * Options accepted by {@link exportCapsule}.
+ *
+ * `name` — capsule id, validated against {@link CAPSULE_ID_PATTERN}. The id
+ * also forms the manifest's `capsule.id` and the archive filename.
+ *
+ * `root` — absolute or cwd-relative path to the memory directory to export.
+ *
+ * `since` — optional ISO-8601 timestamp; only files with `mtime >= since`
+ * are included.
+ *
+ * `includeKinds` — optional allow-list of top-level subdirectory names
+ * (e.g. `facts`, `entities`, `corrections`, `transcripts`). When set, files
+ * directly under {@link root} are excluded and only files whose first path
+ * segment is in the allow-list are kept. Pass `transcripts` here explicitly
+ * to opt-in transcripts (they are excluded by default).
+ *
+ * `peerIds` — optional allow-list restricting the `peers/` tree to files
+ * under `peers/<peerId>/...`. When omitted the entire `peers/` tree is
+ * included (subject to {@link includeKinds}). When set to an empty array
+ * the `peers/` tree is excluded entirely.
+ *
+ * `outDir` — optional output directory. Defaults to `<root>/.capsules`.
+ *
+ * `pluginVersion` — recorded in the manifest. Defaults to `"0.0.0"` so
+ * tests do not need to thread a version through; production callers SHOULD
+ * pass the running plugin version.
+ *
+ * `capsule` — optional overrides for the manifest's `capsule` block. The
+ * caller may pass any subset; remaining fields are filled with conservative
+ * defaults documented inline below.
+ *
+ * `now` — optional clock override (ms epoch) used for `manifest.createdAt`.
+ * Tests pass a fixed value for deterministic output.
+ *
+ * `encrypt` — when `true`, encrypt the output archive using the secure-store
+ * master key for `memoryDir`. The keyring must be unlocked before calling
+ * (`remnic secure-store unlock`). The plaintext `.capsule.json.gz` is written
+ * first, then encrypted to `<name>.capsule.json.gz.enc`; the plaintext is
+ * removed after successful encryption. Requires `memoryDir` to be provided.
+ *
+ * `memoryDir` — required when `encrypt` is `true`. The memory directory whose
+ * secure-store keyring holds the master key.
+ */
+interface ExportCapsuleOptions {
+    name: string;
+    root: string;
+    since?: string;
+    includeKinds?: readonly string[];
+    peerIds?: readonly string[];
+    outDir?: string;
+    pluginVersion?: string;
+    capsule?: Partial<Omit<CapsuleBlock, "id">>;
+    now?: number;
+    /**
+     * When `true`, encrypt the output archive. Requires the secure-store to be
+     * unlocked and `memoryDir` to be set. The plaintext `.capsule.json.gz` is
+     * replaced by `<name>.capsule.json.gz.enc` on success.
+     */
+    encrypt?: boolean;
+    /**
+     * Memory directory whose secure-store keyring holds the master key. Required
+     * when `encrypt` is `true`; ignored otherwise.
+     */
+    memoryDir?: string;
+    /**
+     * When `true`, include the `transcripts/` directory in the export even
+     * though it is excluded by default. Using this flag avoids hard-coding an
+     * explicit `includeKinds` allow-list that would inadvertently drop other
+     * valid memory directories (`peers/`, `forks/`, etc.). (Cursor / #747)
+     *
+     * Ignored when `includeKinds` is provided and already contains
+     * `"transcripts"`.
+     */
+    includeTranscripts?: boolean;
+}
+interface ExportCapsuleResult {
+    archivePath: string;
+    manifestPath: string;
+    manifest: ExportManifestV2;
+    /** When the export was encrypted, the `.enc` path. `null` when unencrypted. */
+    encryptedArchivePath: string | null;
+}
+/**
+ * Pure function that exports a memory directory as a portable, capsule-aware
+ * V2 bundle.
+ *
+ * The output is a single `.capsule.json.gz` archive containing the entire
+ * `ExportBundleV2` (manifest + records) plus a sidecar `manifest.json` for
+ * cheap inspection. The bundle format is intentionally identical to the
+ * existing `export-json` shape so PR 3/6's importer can reuse the V1 code
+ * path with only a manifest version-dispatch.
+ *
+ * Determinism guarantees:
+ *  - `manifest.files` and `bundle.records` are sorted by posix path.
+ *  - `manifest.createdAt` is taken from {@link ExportCapsuleOptions.now}
+ *    when provided.
+ *  - The archive is gzip-compressed with default settings; no timestamp is
+ *    embedded (Node's `gzipSync` does not write a header timestamp when
+ *    using the synchronous helper, so byte-identical outputs are possible
+ *    given identical inputs).
+ *
+ * Empty result handling: a capsule with zero matching files is still a
+ * valid capsule and produces a well-formed manifest with an empty `files`
+ * array and an archive containing the empty bundle.
+ */
+declare function exportCapsule(opts: ExportCapsuleOptions): Promise<ExportCapsuleResult>;
+declare function isValidCapsuleSince(since: string): boolean;
+
+export { type ExportCapsuleOptions, type ExportCapsuleResult, exportCapsule, isValidCapsuleSince };

package/dist/transfer/capsule-export.js

@@ -0,0 +1,19 @@
+import {
+  exportCapsule,
+  isValidCapsuleSince
+} from "../chunk-2F2W355T.js";
+import "../chunk-KNKUID7G.js";
+import "../chunk-WEHSQBFR.js";
+import "../chunk-J4EB7DNW.js";
+import "../chunk-I6K5FBRQ.js";
+import "../chunk-AGZQD76C.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-A6XUJE5D.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  exportCapsule,
+  isValidCapsuleSince
+};
+//# sourceMappingURL=capsule-export.js.map

package/dist/transfer/capsule-export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}