@bubstack/moe-memory 0.1.0

package/dist/summary-sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-sentinel.js","sourceRoot":"","sources":["../src/summary-sentinel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAC1C,MAAM,mBAAmB,GAAG,GAAG,YAAY,IAAI,CAAC;AAChD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,CAAC,SAAS;AAE5C,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,GAAG,YAAY,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC;IAC7D,IAAI,CAAC,GAAG;QAAE,OAAO,gBAAgB,CAAC;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/sync-cli.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `moe-memory sync` — copy new transcripts into the archive, index them, then
+ * run one batch of the embedding migration.
+ *
+ * Was a standalone script executed by `cli/episodic-memory.js` through
+ * `spawn(node, join(__dirname, '../dist/sync-cli.js'))`. It is a function now
+ * and `src/cli.ts` calls it in-process: there is one bin, it compiles to
+ * `dist/cli.js`, and every `../dist/` prefix in the old shim layer was a
+ * resolution that only worked from the right directory.
+ */
+/**
+ * Exit code, so the dispatcher can propagate it. `null` means "keep going".
+ */
+export declare function runSync(args: string[]): Promise<number>;
+//# sourceMappingURL=sync-cli.d.ts.map

package/dist/sync-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cli.d.ts","sourceRoot":"","sources":["../src/sync-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4EH;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4I7D"}

package/dist/sync-cli.js

@@ -0,0 +1,202 @@
+/**
+ * `moe-memory sync` — copy new transcripts into the archive, index them, then
+ * run one batch of the embedding migration.
+ *
+ * Was a standalone script executed by `cli/episodic-memory.js` through
+ * `spawn(node, join(__dirname, '../dist/sync-cli.js'))`. It is a function now
+ * and `src/cli.ts` calls it in-process: there is one bin, it compiles to
+ * `dist/cli.js`, and every `../dist/` prefix in the old shim layer was a
+ * resolution that only worked from the right directory.
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { initDatabase } from "./db.js";
+import { countStale, runMigrationBatch } from "./embedding-migration.js";
+import { generateExchangeEmbedding, initEmbeddings } from "./embeddings.js";
+import { acquireFileLock, readLockHolder, releaseFileLock } from "./file-lock.js";
+import { formatLogLine, getSyncLogPath } from "./logging.js";
+import { getArchiveDir, getConversationSourceDirs, getIndexDir } from "./paths.js";
+import { shouldSkipReentrantSync } from "./summarizer.js";
+import { syncConversations } from "./sync.js";
+const HELP = `
+Usage: moe-memory sync [--background]
+
+Sync conversations from Claude Code and Codex transcript directories to archive and index them.
+
+This command:
+1. Copies new or updated .jsonl files to conversation archive
+2. Generates embeddings for semantic search
+3. Updates the search index
+
+Only processes files that are new or have been modified since last sync.
+Safe to run multiple times - subsequent runs are fast no-ops.
+
+OPTIONS:
+  --background    Run sync in background (for hooks, returns immediately)
+
+EXAMPLES:
+  # Sync all new conversations
+  moe-memory sync
+
+  # Sync in background (for hooks)
+  moe-memory sync --background
+
+  # Use in a Claude Code SessionStart hook
+  moe-memory sync --background
+`;
+const MIGRATION_BATCH_SIZE = Number.parseInt(process.env.MOE_MEMORY_MIGRATION_BATCH || "500", 10);
+async function runEmbeddingMigrationPhase() {
+    const db = initDatabase();
+    try {
+        const stale = countStale(db);
+        if (stale === 0)
+            return;
+        console.error(`\nmoe-memory: ${stale} exchange(s) on the old embedding model — migrating up to ${MIGRATION_BATCH_SIZE} this run`);
+        await initEmbeddings();
+        const indexDir = getIndexDir();
+        const done = await runMigrationBatch(db, indexDir, MIGRATION_BATCH_SIZE, generateExchangeEmbedding);
+        if (done > 0) {
+            const after = countStale(db);
+            console.error(`moe-memory: re-embedded ${done} (${after} still stale; will resume on next sync)`);
+        }
+    }
+    catch (err) {
+        console.error("moe-memory: migration phase error:", err instanceof Error ? err.message : String(err));
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Exit code, so the dispatcher can propagate it. `null` means "keep going".
+ */
+export async function runSync(args) {
+    // Reentrancy guard (#87): if this sync was triggered by a SessionStart hook
+    // inside a Claude subprocess that the summarizer just spawned, exit silently.
+    // Without this, summarization spawns a Claude subprocess which fires
+    // SessionStart which runs sync which spawns more summarization — cascading
+    // fanout that pegs CPU and burns API quota.
+    if (shouldSkipReentrantSync()) {
+        // stderr keeps the message out of any stdout consumers (e.g., MCP)
+        // while still being visible in hook logs.
+        console.error("moe-memory: skipping sync inside summarizer-spawned subprocess (#87)");
+        return 0;
+    }
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(HELP);
+        return 0;
+    }
+    // If background mode, fork the process and return immediately.
+    if (args.includes("--background")) {
+        const filteredArgs = args.filter((arg) => arg !== "--background");
+        const logPath = getSyncLogPath();
+        const logFd = fs.openSync(logPath, "a");
+        fs.writeSync(logFd, formatLogLine("info", `Starting background sync from pid ${process.pid}`));
+        // Re-spawn this same entry point with the `sync` subcommand. argv[1] is the
+        // dispatcher (dist/cli.js, or the bin symlink pointing at it); passing the
+        // subcommand back explicitly is what makes that safe under one bin.
+        const entry = process.argv[1];
+        if (!entry) {
+            console.error("moe-memory: cannot determine own entry point; running sync in foreground");
+        }
+        else {
+            const child = spawn(process.execPath, [entry, "sync", ...filteredArgs], {
+                detached: true,
+                stdio: ["ignore", logFd, logFd],
+            });
+            child.unref(); // Allow parent to exit
+            console.log(`Sync started in background. Log: ${logPath}`);
+            return 0;
+        }
+    }
+    const sourceDirs = getConversationSourceDirs();
+    const destDir = getArchiveDir();
+    if (sourceDirs.length === 0) {
+        console.log("⚠️  No conversation source directories found.");
+        console.log("  Checked: ~/.claude/projects, ~/.claude/transcripts, and ~/.codex/sessions");
+        if (process.env.CLAUDE_CONFIG_DIR) {
+            console.log(`  CLAUDE_CONFIG_DIR is set to: ${process.env.CLAUDE_CONFIG_DIR}`);
+        }
+        return 0;
+    }
+    // Single-instance lock (#97). Independent SessionStart events from multiple
+    // Claude Code sessions each fire `sync --background`; without a lock they race
+    // the SQLite write path and pile up Claude subprocesses for summarization. On
+    // Windows the latter exhausts the desktop heap and crashes the workers with
+    // STATUS_DLL_INIT_FAILED. Acquire after the source-dir check so help/version
+    // paths don't touch the filesystem unnecessarily, and release on every exit.
+    const syncLockPath = path.join(path.dirname(getSyncLogPath()), "moe-memory-sync.lock");
+    const syncLock = acquireFileLock(syncLockPath);
+    if (!syncLock) {
+        const holder = readLockHolder(syncLockPath);
+        const holderLabel = holder !== null ? `pid ${holder}` : "another process";
+        console.error(`moe-memory: sync already running (${holderLabel}); skipping`);
+        return 0;
+    }
+    let released = false;
+    const releaseSyncLockOnce = () => {
+        if (released)
+            return;
+        released = true;
+        releaseFileLock(syncLock);
+    };
+    process.on("exit", releaseSyncLockOnce);
+    process.on("SIGINT", () => {
+        releaseSyncLockOnce();
+        process.exit(130);
+    });
+    process.on("SIGTERM", () => {
+        releaseSyncLockOnce();
+        process.exit(143);
+    });
+    process.on("SIGHUP", () => {
+        releaseSyncLockOnce();
+        process.exit(129);
+    });
+    console.log("Syncing conversations...");
+    console.log(`Sources: ${sourceDirs.join(", ")}`);
+    console.log(`Destination: ${destDir}\n`);
+    const totals = {
+        copied: 0,
+        skipped: 0,
+        indexed: 0,
+        summarized: 0,
+        errors: [],
+    };
+    try {
+        for (const sourceDir of sourceDirs) {
+            const result = await syncConversations(sourceDir, destDir);
+            totals.copied += result.copied;
+            totals.skipped += result.skipped;
+            totals.indexed += result.indexed;
+            totals.summarized += result.summarized;
+            totals.errors.push(...result.errors);
+        }
+        console.log("\n✅ Sync complete!");
+        console.log(`  Copied: ${totals.copied}`);
+        console.log(`  Skipped: ${totals.skipped}`);
+        console.log(`  Indexed: ${totals.indexed}`);
+        console.log(`  Summarized: ${totals.summarized}`);
+        if (totals.errors.length > 0) {
+            console.log(`\n⚠️  Errors: ${totals.errors.length}`);
+            for (const err of totals.errors)
+                console.log(`  ${err.file}: ${err.error}`);
+            // Help diagnose silent summarization failures (#70)
+            const summaryErrors = totals.errors.filter((e) => e.error.startsWith("Summary generation failed"));
+            if (summaryErrors.length > 0 && totals.summarized === 0) {
+                console.log(`\n💡 All ${summaryErrors.length} summarization attempts failed.`);
+                console.log("  Check your API configuration (MOE_MEMORY_API_BASE_URL / ANTHROPIC_API_KEY).");
+            }
+        }
+        // After regular sync, do a batch of embedding migration if any rows are
+        // still on the old encoder. Lock-protected; if another process is already
+        // migrating, this is a no-op.
+        await runEmbeddingMigrationPhase();
+        return 0;
+    }
+    finally {
+        releaseSyncLockOnce();
+    }
+}
+//# sourceMappingURL=sync-cli.js.map

package/dist/sync-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cli.js","sourceRoot":"","sources":["../src/sync-cli.ts"],"names":[],"mappings":"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"}

package/dist/sync.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The in-transcript opt-out a user types to keep a conversation out of the index.
+ *
+ * ⚠️ HIGHEST-RISK RENAME IN THE PACKAGE, and the reason BOTH forms are here
+ * permanently. This is a marker people have already typed into transcripts
+ * sitting on disk. Renaming it and dropping the old form does not fail loudly —
+ * it silently starts indexing every conversation a user had explicitly marked
+ * DO-NOT-INDEX. So the upstream marker is honoured forever; it is data, not a
+ * brand token, and Zone B reasoning applies to it even though it lives in Zone A
+ * code.
+ */
+export declare const EXCLUSION_MARKER = "<INSTRUCTIONS-TO-MOE-MEMORY>DO NOT INDEX THIS CHAT</INSTRUCTIONS-TO-MOE-MEMORY>";
+/** The upstream form. Accepted permanently — see EXCLUSION_MARKER. */
+export declare const LEGACY_EXCLUSION_MARKER = "<INSTRUCTIONS-TO-EPISODIC-MEMORY>DO NOT INDEX THIS CHAT</INSTRUCTIONS-TO-EPISODIC-MEMORY>";
+export declare const EXCLUSION_MARKERS: string[];
+/** True when a transcript carries any marker that keeps it out of the index. */
+export declare function shouldSkipConversation(filePath: string): boolean;
+export interface SyncResult {
+    copied: number;
+    skipped: number;
+    indexed: number;
+    summarized: number;
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+export interface SyncOptions {
+    skipIndex?: boolean;
+    skipSummaries?: boolean;
+    summaryLimit?: number;
+}
+export declare function extractSessionIdFromPath(filePath: string): string | null;
+export declare function syncConversations(sourceDir: string, destDir: string, options?: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,oFACsD,CAAC;AAEpF,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,8FACyD,CAAC;AAE9F,eAAO,MAAM,iBAAiB,UAK7B,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQhE;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyBD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxE;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAkKrB"}

package/dist/sync.js

@@ -0,0 +1,204 @@
+import fs from "node:fs";
+import path from "node:path";
+import { SUMMARIZER_CONTEXT_MARKER } from "./constants.js";
+import { findJsonlFiles, getExcludedProjects } from "./paths.js";
+import { formatErrorSentinel, shouldQueueForSummary } from "./summary-sentinel.js";
+/**
+ * The in-transcript opt-out a user types to keep a conversation out of the index.
+ *
+ * ⚠️ HIGHEST-RISK RENAME IN THE PACKAGE, and the reason BOTH forms are here
+ * permanently. This is a marker people have already typed into transcripts
+ * sitting on disk. Renaming it and dropping the old form does not fail loudly —
+ * it silently starts indexing every conversation a user had explicitly marked
+ * DO-NOT-INDEX. So the upstream marker is honoured forever; it is data, not a
+ * brand token, and Zone B reasoning applies to it even though it lives in Zone A
+ * code.
+ */
+export const EXCLUSION_MARKER = "<INSTRUCTIONS-TO-MOE-MEMORY>DO NOT INDEX THIS CHAT</INSTRUCTIONS-TO-MOE-MEMORY>";
+/** The upstream form. Accepted permanently — see EXCLUSION_MARKER. */
+export const LEGACY_EXCLUSION_MARKER = "<INSTRUCTIONS-TO-EPISODIC-MEMORY>DO NOT INDEX THIS CHAT</INSTRUCTIONS-TO-EPISODIC-MEMORY>";
+export const EXCLUSION_MARKERS = [
+    EXCLUSION_MARKER,
+    LEGACY_EXCLUSION_MARKER,
+    "Only use NO_INSIGHTS_FOUND",
+    SUMMARIZER_CONTEXT_MARKER,
+];
+/** True when a transcript carries any marker that keeps it out of the index. */
+export function shouldSkipConversation(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return EXCLUSION_MARKERS.some((marker) => content.includes(marker));
+    }
+    catch {
+        // If we can't read the file, don't skip it
+        return false;
+    }
+}
+function copyIfNewer(src, dest) {
+    // Ensure destination directory exists
+    const destDir = path.dirname(dest);
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    // Check if destination exists and is up-to-date
+    if (fs.existsSync(dest)) {
+        const srcStat = fs.statSync(src);
+        const destStat = fs.statSync(dest);
+        if (destStat.mtimeMs >= srcStat.mtimeMs) {
+            return false; // Dest is current, skip
+        }
+    }
+    // Atomic copy: temp file + rename
+    const tempDest = `${dest}.tmp.${process.pid}`;
+    fs.copyFileSync(src, tempDest);
+    fs.renameSync(tempDest, dest); // Atomic on same filesystem
+    return true;
+}
+export function extractSessionIdFromPath(filePath) {
+    // Extract session ID from Claude filename or Codex rollout filename.
+    const basename = path.basename(filePath, ".jsonl");
+    const uuidPattern = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+    const matches = basename.match(uuidPattern);
+    return matches?.[matches.length - 1] ?? null;
+}
+export async function syncConversations(sourceDir, destDir, options = {}) {
+    const result = {
+        copied: 0,
+        skipped: 0,
+        indexed: 0,
+        summarized: 0,
+        errors: [],
+    };
+    // Ensure source directory exists
+    if (!fs.existsSync(sourceDir)) {
+        return result;
+    }
+    // Collect files to index and summarize
+    const filesToIndex = [];
+    const filesToSummarize = [];
+    // Walk source directory
+    const projects = fs.readdirSync(sourceDir);
+    const excludedProjects = getExcludedProjects();
+    const excludedDirSet = new Set(excludedProjects);
+    for (const project of projects) {
+        if (excludedProjects.includes(project)) {
+            console.log(`\nSkipping excluded project: ${project}`);
+            continue;
+        }
+        const projectPath = path.join(sourceDir, project);
+        const stat = fs.statSync(projectPath);
+        if (!stat.isDirectory())
+            continue;
+        const files = findJsonlFiles(projectPath, excludedDirSet);
+        for (const file of files) {
+            const srcFile = path.join(projectPath, file);
+            const destFile = path.join(destDir, project, file);
+            try {
+                const wasCopied = copyIfNewer(srcFile, destFile);
+                if (wasCopied) {
+                    result.copied++;
+                    filesToIndex.push(destFile);
+                }
+                else {
+                    result.skipped++;
+                }
+                // Check if this file needs a summary (whether newly copied or existing).
+                // shouldQueueForSummary skips files that already have a real summary or
+                // an empty zero-exchange sentinel, and retries stale error sentinels (#96).
+                if (!options.skipSummaries) {
+                    const summaryPath = destFile.replace(".jsonl", "-summary.txt");
+                    if (shouldQueueForSummary(summaryPath) && !shouldSkipConversation(destFile)) {
+                        const sessionId = extractSessionIdFromPath(destFile);
+                        if (sessionId) {
+                            filesToSummarize.push({ path: destFile, sessionId });
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                result.errors.push({
+                    file: srcFile,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    // Index copied files (unless skipIndex is set)
+    if (!options.skipIndex && filesToIndex.length > 0) {
+        const { initDatabase, insertExchange } = await import("./db.js");
+        const { initEmbeddings, generateExchangeEmbedding } = await import("./embeddings.js");
+        const { parseConversation } = await import("./parser.js");
+        const db = initDatabase();
+        await initEmbeddings();
+        for (const file of filesToIndex) {
+            try {
+                // Check for DO NOT INDEX marker
+                if (shouldSkipConversation(file)) {
+                    continue; // Skip indexing but file is already copied
+                }
+                const project = path.basename(path.dirname(file));
+                const exchanges = await parseConversation(file, project, file);
+                for (const exchange of exchanges) {
+                    const toolNames = exchange.toolCalls?.map((tc) => tc.toolName);
+                    const embedding = await generateExchangeEmbedding(exchange.userMessage, exchange.assistantMessage, toolNames);
+                    insertExchange(db, exchange, embedding, toolNames);
+                }
+                result.indexed++;
+            }
+            catch (error) {
+                result.errors.push({
+                    file,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        db.close();
+    }
+    // Generate summaries for files that need them
+    if (!options.skipSummaries && filesToSummarize.length > 0) {
+        const { parseConversation } = await import("./parser.js");
+        const { summarizeConversation } = await import("./summarizer.js");
+        const summaryLimit = options.summaryLimit ?? 10;
+        const toSummarize = filesToSummarize.slice(0, summaryLimit);
+        const remaining = filesToSummarize.length - toSummarize.length;
+        console.log(`Generating summaries for ${toSummarize.length} conversation(s)...`);
+        if (remaining > 0) {
+            console.log(`  (${remaining} more need summaries - will process on next sync)`);
+        }
+        for (const { path: filePath, sessionId } of toSummarize) {
+            try {
+                const project = path.basename(path.dirname(filePath));
+                const exchanges = await parseConversation(filePath, project, filePath);
+                if (exchanges.length === 0) {
+                    // Skip empty conversations — write an empty -summary.txt sentinel so they aren't re-queued forever
+                    const summaryPath = filePath.replace(".jsonl", "-summary.txt");
+                    fs.writeFileSync(summaryPath, "", "utf-8");
+                    continue;
+                }
+                console.log(`  Summarizing ${path.basename(filePath)} (${exchanges.length} exchanges)...`);
+                const summary = await summarizeConversation(exchanges, sessionId);
+                const summaryPath = filePath.replace(".jsonl", "-summary.txt");
+                fs.writeFileSync(summaryPath, summary, "utf-8");
+                result.summarized++;
+            }
+            catch (error) {
+                // Write a structured error sentinel (#96): distinct from the empty
+                // zero-exchange sentinel so a stale failure can self-heal on the next
+                // sync run past the retry threshold. The marker also keeps the error
+                // text on disk for post-hoc diagnosis. Best-effort — if the sentinel
+                // write itself fails, fall through and surface the original error.
+                try {
+                    const summaryPath = filePath.replace(".jsonl", "-summary.txt");
+                    fs.writeFileSync(summaryPath, formatErrorSentinel(error), "utf-8");
+                }
+                catch { }
+                result.errors.push({
+                    file: filePath,
+                    error: `Summary generation failed: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * The two record types.
+ *
+ * A **conversation exchange** is harvested: sync copies a transcript out of
+ * `~/.claude/projects` or `~/.codex/sessions` and the indexer derives rows from
+ * it. Nobody chose to write it down.
+ *
+ * A **journal entry** is deliberate: the model called `process_thoughts` and a
+ * markdown file was written. It is authored content with different privacy
+ * properties — a project entry belongs to the codebase, a user entry belongs to
+ * the person.
+ *
+ * They share one encoder and one SQLite file and nothing else. Distinct tables,
+ * distinct MCP tools, distinct result types. This file is where that boundary
+ * is stated.
+ *
+ * Reconciliation note: private-journal-mcp's own `types.ts` was entirely dead —
+ * `JournalEntry`, `ServerConfig` and `ProcessThoughtsRequest` had zero importers
+ * anywhere in its src or tests, while its live journal shape was retyped inline
+ * in four places. The names below are re-established as the single declaration
+ * those four sites now share.
+ */
+export interface ToolCall {
+    id: string;
+    exchangeId: string;
+    toolName: string;
+    toolInput?: unknown;
+    toolResult?: string;
+    isError: boolean;
+    timestamp: string;
+}
+export type ConversationHarness = "claude" | "codex";
+export interface ConversationExchange {
+    id: string;
+    project: string;
+    timestamp: string;
+    userMessage: string;
+    assistantMessage: string;
+    archivePath: string;
+    lineStart: number;
+    lineEnd: number;
+    parentUuid?: string | undefined;
+    isSidechain?: boolean | undefined;
+    harness?: ConversationHarness | undefined;
+    sessionId?: string | undefined;
+    cwd?: string | undefined;
+    gitBranch?: string | undefined;
+    claudeVersion?: string | undefined;
+    agentVersion?: string | undefined;
+    model?: string | undefined;
+    modelProvider?: string | undefined;
+    thinkingLevel?: string | undefined;
+    thinkingDisabled?: boolean | undefined;
+    thinkingTriggers?: string | undefined;
+    toolCalls?: ToolCall[] | undefined;
+}
+/** A conversation-search hit. */
+export interface SearchResult {
+    exchange: ConversationExchange;
+    /** Cosine similarity, or undefined in `mode: 'text'` where there is no vector. */
+    similarity?: number | undefined;
+    snippet: string;
+    /** The conversation's AI summary sidecar, when one exists and is not an error sentinel. */
+    summary?: string | undefined;
+}
+export interface MultiConceptResult {
+    exchange: ConversationExchange;
+    snippet: string;
+    conceptSimilarities: number[];
+    averageSimilarity: number;
+}
+/**
+ * Which journal a record belongs to.
+ *
+ * Upstream this was derived at read time from which directory the file happened
+ * to be walked out of, and was not stored. It is a column now: derivation broke
+ * the moment both roots resolved to the same directory.
+ */
+export type JournalScope = "project" | "user";
+/**
+ * The six thought categories, in the order they are rendered into an entry.
+ *
+ * `project_notes` routes to the project journal; the other five route to the
+ * user journal. Snake_case because these are MCP wire names.
+ */
+export interface JournalThoughts {
+    reflections?: string | undefined;
+    observations?: string | undefined;
+    project_notes?: string | undefined;
+    user_context?: string | undefined;
+    technical_insights?: string | undefined;
+    world_knowledge?: string | undefined;
+}
+/** The rendered `## Heading` for each thought category, in entry order. */
+export declare const JOURNAL_SECTION_HEADINGS: ReadonlyArray<[keyof JournalThoughts, string]>;
+/** One journal entry as it exists on disk and in the index. */
+export interface JournalEntry {
+    /** Stable id: the entry's absolute path is not stable, the id is. */
+    id: string;
+    /** Absolute path of the markdown file, refreshed from the walk on every index. */
+    path: string;
+    /**
+     * Absolute path of the journal root this entry was found under.
+     *
+     * One database serves every project on the machine, so this is what makes a
+     * `project`-scoped entry belong to a repo: retrieval filters on it, and the
+     * index prune only considers rows whose root it is currently walking.
+     */
+    root: string;
+    scope: JournalScope;
+    /** Epoch milliseconds. */
+    timestamp: number;
+    /** Frontmatter-stripped, header-stripped body — what gets embedded. */
+    text: string;
+    /** Rendered section headings present in the entry, e.g. `['Reflections']`. */
+    sections: string[];
+}
+/** A journal-search hit. */
+export interface JournalSearchResult {
+    entry: JournalEntry;
+    /** Cosine similarity in [-1, 1]. 1 for `list_recent_entries`, which does not rank. */
+    score: number;
+    excerpt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}