lemma-mcp 0.19.0 → 0.21.0

package/README.md

@@ -77,7 +77,7 @@ Lemma runs intelligence in the background — no manual triggering needed:
 
 Manual deep analysis is also available via dedicated tools.
 
-## Tools (26)
+## Tools (29)
 
 Lemma exposes short MCP tool names such as `memory_read`, `memory_add`, and `session_start`. Most clients display tools with the server namespace prepended, so you may see names like `mcp_lemma_memory_add`; that is expected. Redundant doubled names like `mcp_lemma_lemma_memory_add` are not used.
 
@@ -127,6 +127,55 @@ Lemma exposes short MCP tool names such as `memory_read`, `memory_add`, and `ses
 | `project_analytics` | Cross-session project health, growth rate, skill coverage |
 | `semantic_search` | TF-IDF similarity search across memories |
 
+### Backup and restore (3)
+
+| Tool | Purpose |
+|------|---------|
+| `backup_create` | Create and verify one portable backup of all database records |
+| `backup_preview` | Validate a backup, compare record counts, and prepare a confirmation token |
+| `backup_restore` | Replace memory after explicit confirmation, with a mandatory safety backup |
+
+## Backup and restore through MCP
+
+No terminal command is needed. Ask your assistant **"Back up my Lemma memory to this folder"** or **"Restore my Lemma memory from this backup file"**. The assistant uses the three tools above.
+
+1. **Back up:** `backup_create` accepts an optional absolute `directory` (also supports `~/...`). It returns the path of a verified `.lemma-backup` file. By default files go to `~/.lemma/backups/`, with unique timestamped names; existing backups are never overwritten.
+2. **Move:** copy that file to your external drive or chosen storage. On a new computer, install a compatible Lemma MCP release and make the file available locally. The format is independent of Windows, macOS and Linux; it contains no destination directory paths.
+3. **Preview:** the assistant calls `backup_preview` with the file's absolute `path`. It shows backup/current record counts and explains that restore **replaces all projects and global memory**, rather than merging them. It also reports connection readiness: `ready` means no other cooperating connections were detected; `blocked` explains the connection blocker. A blocked preview returns no confirmation token, invalidates earlier tokens, and does not ask for approval. Close the other Lemma connections or visualizers as indicated, keep the assistant's current MCP connection open, and preview again. Once ready, explicitly approve that preview. Open conversation tabs alone do not determine readiness; registered database connections do. This check cannot detect older Lemma versions or external SQLite tools.
+4. **Restore:** the assistant passes the preview's `confirmation_token` and `confirm: true` to `backup_restore`. Lemma first creates and verifies a `before-restore-*.lemma-backup` of the current database, then restores and checks the records in one SQLite transaction. On failure before commit the old database remains intact. The returned `safety_backup_path` can be used in the same preview/restore flow to undo a restore.
+
+The current MCP connection stays usable. Its old in-memory session is discarded so it cannot overwrite restored history. Sessions that were active when the backup was taken become abandoned history. Existing conversation text is not erased; start a new conversation when you need a fresh context.
+
+The preview identifies the serving connection in `readiness.current_connection` and lists every detected live peer in `readiness.blocking_connections`, with process IDs and distinct connection IDs. `same_process` flags another connection inside the current process: do not terminate that process. Conversation names and IDs cannot be inferred from these registrations (`conversation_mapping: "unavailable"`). Unverifiable registrations and inspection failures remain blockers and are reported separately. These are diagnostic details, not instructions to terminate processes; close other connections through their application and preview again.
+
+**Included:** all persisted database records, including global/project memories, invalidated fragments, archives, guides and learnings, relationships, evidence, feedback, fragment versions, session history, attempts, suggestions and search cache. Search indexes are rebuilt during restore. Paths quoted *inside* memory/evidence remain unchanged; project folder names and evidence paths may need attention after moving computers.
+
+**Excluded:** `config.json`, raw session/traffic logs, diagnostic logs, installed skills/models, and the MCP client's own configuration. These are machine-specific settings or auxiliary files and are left unchanged on restore. This is a database recovery feature, not a full installation backup or cloud synchronization service. `lemma -lib` is a readable report, not a restorable backup.
+
+**Limits and safeguards:**
+
+Upgraded installations may retain the unused `memory_vectors` / `vec0` scaffold removed in Lemma 0.15.0. Backups accept only its known table definitions, version metadata and empty payload tables with no prior write counters. The original snapshot retains these legacy structures. Restore preserves them if already present on the target, but does not recreate the retired index on a fresh installation. Memories, guides and current search data are restored normally. Nonempty vectors, altered scaffolding and other unknown schema changes are rejected; the live database is never cleaned up automatically.
+
+- Backups are unencrypted and contain private knowledge. Keep them in trusted storage. A backup on the disk being formatted will also be lost; keep a copy elsewhere.
+- This initial format supports databases up to 128 MiB. Backups in this format with known database schemas 1–8 can be restored to the current schema (8). Older schemas are matched against their exact known definitions and complete migration history, then upgraded and verified on an in-memory copy using only bundled migrations. The original file is unchanged. Preview reports `schema_upgrade` with the version range and notes; show these before requesting confirmation. Upgrades from schema 1 or 2 normalize project paths/names and global scope, just as the corresponding application migration does. Unknown/newer formats or schemas, changed definitions, failed checksums, broken relationships and invalid SQLite/search indexes are rejected before replacement. This does not import arbitrary old SQLite or JSONL files and does not guarantee compatibility with future releases.
+- Confirmation tokens expire after 10 minutes, are single-use, and are bound to both the exact file and current database state. If memory changes while you are deciding, or the MCP connection restarts, preview and confirm again.
+- SQLite snapshots include committed WAL data while Lemma is running. Restore holds the SQLite writer lock; other cooperating Lemma connections block restore and newly opening clients wait for that lock. Older Lemma versions and external SQLite programs do not register as clients, so close them before confirming. SQLite still performs the replacement atomically; it never swaps a database file underneath an open connection.
+- A checksum detects damaged data; it is not a signature proving who created the backup. Import files only from a trusted source.
+
+## Why was a memory recalled?
+
+Ask your assistant to explain a recall, or pass `explain: true` to `memory_read` or `semantic_search`. It is off by default and adds no new tool. For example:
+
+```json
+{"query":"retry policy","project":"my-project","explain":true,"response_format":"json"}
+```
+
+The optional `recall_explanation` shows the actual selection method and score, recorded source/session, citations, and evidence-check status. Keyword search reports BM25; browsing reports confidence ordering; semantic search reports TF-IDF; hybrid search exposes its rank-fusion components and distinguishes the score from diversity ordering. Direct ID reads say that the ID was requested, and graph expansion reports its root/depth. Ranks refer to the current filtered search window, subject to existing candidate limits.
+
+This explains **the current call**, not why an earlier conversation or automatic context injection selected a memory. Metadata is captured before this read boosts access/confidence. Scores and source labels do not establish correctness, and last access is not last verification. Citation checks run only when `verification.stale_check` is enabled, check at most five citations per record, and report truncation. A present snippet is not proof that the claim is true; without evidence or with verification disabled the result says so. Both readable text and JSON are supported.
+
+No correction is applied by asking for an explanation. After reviewing it, use `memory_update` to correct content, `memory_forget` with `invalidate: true` to hide outdated knowledge while preserving history, or `memory_relate` to record a replacement/contradiction.
+
 ## Configuration
 
 Optional config at `~/.lemma/config.json`:

package/dist/db/backup.d.ts

@@ -0,0 +1,63 @@
+export declare const MAX_DATABASE_BYTES: number;
+export declare const RESTORE_PREVIEW_TTL_MS: number;
+export interface BackupSummary {
+    memories: number;
+    guides: number;
+    sessions: number;
+    relations: number;
+    archived_memories: number;
+    active_sessions: number;
+}
+export declare function createBackup(directory?: string): {
+    path: string;
+    verified: boolean;
+    summary: BackupSummary;
+    excluded: string[];
+    message: string;
+};
+export declare function previewRestore(file: string): {
+    path: string;
+    valid: boolean;
+    created_at: string;
+    lemma_version: string;
+    schema_upgrade: {
+        required: boolean;
+        from: number;
+        to: number;
+        applied_versions: number[];
+        notes: string[];
+    };
+    backup: BackupSummary;
+    current: BackupSummary;
+    confirmation_token: `${string}-${string}-${string}-${string}-${string}` | null;
+    readiness: {
+        conversation_mapping: "unavailable";
+        message: string;
+        current_connection: {
+            pid: number;
+            connection_id: string | null;
+        };
+        blocking_connections: {
+            pid: number;
+            connection_id: string;
+            same_process: boolean;
+        }[];
+        unverifiable_leases: number;
+        inspection_error: string | null;
+        status: "blocked" | "ready";
+    };
+    expires_at: string | null;
+    excluded: string[];
+    compatibility_note: string;
+    message: string;
+};
+export declare function restoreBackup(token: string | null, confirm: boolean): {
+    restored: boolean;
+    verified: boolean;
+    path: string;
+    safety_backup_path: string;
+    summary: BackupSummary;
+    closed_sessions: number;
+    message: string;
+};
+//# sourceMappingURL=backup.d.ts.map

package/dist/db/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/db/backup.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,kBAAkB,QAAoB,CAAC;AAEpD,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AAkBrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAoMD,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;;EAe9C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC1C;AA4BD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO;;;;;;;;EAsCnE"}

package/dist/db/backup.js

@@ -0,0 +1,342 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import Database from "better-sqlite3";
+import { getDb, LemmaDB } from "./database.js";
+import { MIGRATIONS } from "./schema.js";
+import { VERSION } from "../version.js";
+import { assertEmptyLegacyVectors, isLegacyVectorTable, LEGACY_VECTOR_NOTE } from "./legacy-vectors.js";
+// Snapshots and their base64 representation coexist in memory; bound both.
+export const MAX_DATABASE_BYTES = 128 * 1024 * 1024;
+const MAX_FILE_BYTES = Math.ceil(MAX_DATABASE_BYTES / 3) * 4 + 4096;
+export const RESTORE_PREVIEW_TTL_MS = 10 * 60 * 1000;
+const FORMAT = "lemma-backup";
+const FORMAT_VERSION = 1;
+const SCHEMA_VERSION = Math.max(...MIGRATIONS.map(([version]) => version));
+// Extend this list only after testing the historical schema and its upgrade path.
+const SUPPORTED_SOURCE_SCHEMAS = new Set([1, 2, 3, 4, 5, 6, 7, 8]);
+const EXCLUDED = ["config.json", "diagnostic logs", "raw session/traffic logs", "installed skills and models", "MCP client configuration"];
+const pendingRestores = new Map();
+const expectedSchemas = new Map();
+function sha256(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function quoteIdentifier(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+function schemaSignature(db) {
+    const rows = db.prepare("SELECT type, name, tbl_name, sql FROM sqlite_master WHERE name NOT LIKE 'sqlite_%' ORDER BY type, name").all();
+    const legacy = assertEmptyLegacyVectors(db, rows);
+    const applicationRows = rows.filter(row => !(legacy && row.type === "table" && isLegacyVectorTable(row.name)));
+    return sha256(JSON.stringify(applicationRows.map(row => ({ ...row, sql: row.sql?.replace(/\s+/g, " ").trim() }))));
+}
+function assertSupportedSchema(db, version = SCHEMA_VERSION) {
+    if (!expectedSchemas.has(version)) {
+        const reference = new LemmaDB(":memory:");
+        try {
+            for (const [step, ddl] of MIGRATIONS) {
+                if (step <= version)
+                    reference.db.exec(ddl);
+            }
+            expectedSchemas.set(version, schemaSignature(reference.db));
+        }
+        finally {
+            reference.close();
+        }
+    }
+    if (schemaSignature(db) !== expectedSchemas.get(version)) {
+        throw new Error(`Incompatible database schema. Expected the known Lemma schema ${version}; no data was replaced.`);
+    }
+    // memory-store uses -1 as the last decay timestamp, not a schema migration.
+    const history = db.prepare("SELECT version FROM schema_version WHERE version <> -1 ORDER BY version").all();
+    const expected = MIGRATIONS.filter(([step]) => step <= version).map(([step]) => step);
+    if (JSON.stringify(history.map(row => row.version)) !== JSON.stringify(expected)) {
+        throw new Error("Unsupported Lemma database version history; no data was replaced.");
+    }
+}
+function assertIntegrity(db) {
+    if (db.pragma("integrity_check", { simple: true }) !== "ok")
+        throw new Error("Backup database failed the SQLite integrity check.");
+    if (db.pragma("foreign_key_check").length !== 0)
+        throw new Error("Backup contains broken database relationships.");
+    // Fixed application SQL, never statements supplied by a backup.
+    for (const table of ["memory_fts", "guides_fts"]) {
+        db.prepare(`INSERT INTO ${table} (${table}, rank) VALUES ('integrity-check', 1)`).run();
+    }
+}
+function summarize(db) {
+    const count = (table) => db.prepare(`SELECT count(*) AS n FROM ${quoteIdentifier(table)}`).get().n;
+    return {
+        memories: count("memories"), guides: count("guides"), sessions: count("sessions"),
+        relations: count("relations"), archived_memories: count("fragments_archive"),
+        active_sessions: db.prepare("SELECT count(*) AS n FROM sessions WHERE status = 'active'").get().n,
+    };
+}
+/** Caller holds a transaction so other WAL writers cannot change this snapshot. */
+function snapshot(db) {
+    const pageCount = db.pragma("page_count", { simple: true });
+    const pageSize = db.pragma("page_size", { simple: true });
+    if (pageCount * pageSize > MAX_DATABASE_BYTES)
+        throw new Error("Database exceeds the 128 MiB backup limit for this release.");
+    const bytes = db.serialize();
+    if (bytes.length > MAX_DATABASE_BYTES)
+        throw new Error("Database exceeds the 128 MiB backup limit for this release.");
+    // sqlite3_deserialize cannot open WAL images. SQLite documents this conversion
+    // of the PRIVATE serialized image; the live database remains in WAL mode.
+    // https://sqlite.org/c3ref/deserialize.html
+    bytes[18] = 1;
+    bytes[19] = 1;
+    return bytes;
+}
+function absolutePath(value) {
+    const expanded = value.startsWith("~/") || value.startsWith("~\\")
+        ? path.join(os.homedir(), value.slice(2)) : value;
+    if (!path.isAbsolute(expanded))
+        throw new Error("Please provide an absolute backup path (or a path starting with ~/).");
+    return path.resolve(expanded);
+}
+function backupDirectory(lemma) {
+    if (lemma.db.memory)
+        throw new Error("Choose a backup directory for an in-memory database.");
+    return path.join(path.dirname(path.resolve(lemma.db.name)), "backups");
+}
+function buildEnvelope(bytes) {
+    return {
+        format: FORMAT, format_version: FORMAT_VERSION, lemma_version: VERSION,
+        schema_version: SCHEMA_VERSION, created_at: new Date().toISOString(),
+        database_sha256: sha256(bytes), database: bytes.toString("base64"),
+    };
+}
+function openSnapshot(bytes, version = SCHEMA_VERSION) {
+    const db = new Database(bytes);
+    try {
+        // Validate BEFORE any migration: only application-owned DDL is accepted.
+        assertSupportedSchema(db, version);
+        assertIntegrity(db);
+        if (version !== SCHEMA_VERSION) {
+            db.transaction(() => {
+                for (const [step, ddl] of MIGRATIONS) {
+                    if (step <= version)
+                        continue;
+                    db.exec(ddl);
+                    db.prepare("INSERT INTO schema_version(version) VALUES (?)").run(step);
+                }
+                assertSupportedSchema(db);
+                assertIntegrity(db);
+                snapshot(db); // Enforce the size bound after expansion as well.
+            })();
+        }
+        return db;
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+}
+function loadBackup(file) {
+    const fd = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NONBLOCK);
+    let bytes;
+    try {
+        const info = fs.fstatSync(fd);
+        if (!info.isFile() || info.size > MAX_FILE_BYTES)
+            throw new Error("Not a regular backup file, or backup exceeds the supported size limit.");
+        // Bounded even if another process grows the file after fstat.
+        bytes = Buffer.alloc(info.size);
+        let offset = 0;
+        while (offset < bytes.length) {
+            const read = fs.readSync(fd, bytes, offset, bytes.length - offset, offset);
+            if (!read)
+                throw new Error("Backup file changed or is truncated. Preview a complete backup file.");
+            offset += read;
+        }
+        if (fs.fstatSync(fd).size !== info.size)
+            throw new Error("Backup file changed while being read.");
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    const data = JSON.parse(bytes.toString("utf8"));
+    if (!data || typeof data !== "object")
+        throw new Error("Not a Lemma backup file.");
+    const envelope = data;
+    if (envelope.format !== FORMAT || envelope.format_version !== FORMAT_VERSION)
+        throw new Error("Unsupported Lemma backup format.");
+    if (!Number.isSafeInteger(envelope.schema_version) || !SUPPORTED_SOURCE_SCHEMAS.has(envelope.schema_version) || envelope.schema_version > SCHEMA_VERSION) {
+        throw new Error(`Unsupported Lemma database schema ${envelope.schema_version}. This release accepts known schemas 1–8 up to ${SCHEMA_VERSION}. Use a compatible Lemma release; no data was replaced.`);
+    }
+    if (typeof envelope.lemma_version !== "string" || envelope.lemma_version.length > 64 ||
+        typeof envelope.created_at !== "string" || !Number.isFinite(Date.parse(envelope.created_at)) ||
+        typeof envelope.database_sha256 !== "string" || !/^[a-f0-9]{64}$/.test(envelope.database_sha256) ||
+        typeof envelope.database !== "string")
+        throw new Error("Invalid backup metadata.");
+    const image = Buffer.from(envelope.database, "base64");
+    if (image.length < 100 || image.length > MAX_DATABASE_BYTES || image.toString("base64") !== envelope.database ||
+        image.subarray(0, 16).toString() !== "SQLite format 3\0" || image[18] !== 1 || image[19] !== 1 ||
+        sha256(image) !== envelope.database_sha256)
+        throw new Error("Backup checksum or database payload is invalid.");
+    const db = openSnapshot(image, envelope.schema_version);
+    try {
+        return { envelope, db, fingerprint: sha256(bytes), summary: summarize(db) };
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+}
+function saveBackup(bytes, directory, prefix) {
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const file = path.join(directory, `${prefix}-${new Date().toISOString().replace(/[:.]/g, "-")}-${randomUUID()}.lemma-backup`);
+    const fd = fs.openSync(file, "wx", 0o600);
+    try {
+        fs.writeFileSync(fd, JSON.stringify(buildEnvelope(bytes)));
+        fs.fsyncSync(fd);
+    }
+    catch (error) {
+        fs.closeSync(fd);
+        fs.unlinkSync(file);
+        throw error;
+    }
+    fs.closeSync(fd);
+    const verified = loadBackup(file);
+    verified.db.close();
+    return file;
+}
+export function createBackup(directory) {
+    const lemma = getDb();
+    const destination = directory === undefined ? backupDirectory(lemma) : absolutePath(directory);
+    const bytes = lemma.db.transaction(() => {
+        assertSupportedSchema(lemma.db);
+        return snapshot(lemma.db);
+    })();
+    const source = openSnapshot(bytes);
+    try {
+        const file = saveBackup(bytes, destination, "lemma");
+        return { path: file, verified: true, summary: summarize(source), excluded: EXCLUDED,
+            message: "Backup verified. Keep a copy outside this computer or the disk you plan to format. The file contains your private memory and is not encrypted. " + LEGACY_VECTOR_NOTE };
+    }
+    finally {
+        source.close();
+    }
+}
+export function previewRestore(file) {
+    const resolved = absolutePath(file);
+    const source = loadBackup(resolved);
+    try {
+        const lemma = getDb();
+        const target = lemma.db.transaction(() => {
+            assertSupportedSchema(lemma.db);
+            return { hash: sha256(snapshot(lemma.db)), summary: summarize(lemma.db) };
+        })();
+        const now = Date.now();
+        for (const [token, preview] of pendingRestores)
+            if (preview.expiresAt <= now)
+                pendingRestores.delete(token);
+        if (pendingRestores.size >= 16)
+            pendingRestores.delete(pendingRestores.keys().next().value);
+        const readiness = lemma.getRestoreReadiness();
+        const token = readiness.status === "ready" ? randomUUID() : null;
+        const expiresAt = now + RESTORE_PREVIEW_TTL_MS;
+        if (token)
+            pendingRestores.set(token, { path: resolved, sourceHash: source.fingerprint, targetHash: target.hash, target: lemma, expiresAt });
+        else
+            pendingRestores.clear(); // A blocked preview must not leave an older approval usable.
+        return {
+            path: resolved, valid: true, created_at: source.envelope.created_at, lemma_version: source.envelope.lemma_version,
+            schema_upgrade: {
+                required: source.envelope.schema_version !== SCHEMA_VERSION,
+                from: source.envelope.schema_version, to: SCHEMA_VERSION,
+                applied_versions: MIGRATIONS.filter(([step]) => step > source.envelope.schema_version).map(([step]) => step),
+                notes: source.envelope.schema_version < 3
+                    ? ["Project keys are normalized: paths become project names, names become lowercase, and 'global' becomes global scope. The original backup file is unchanged."]
+                    : ["The original backup file is unchanged. Known migrations are validated on an in-memory copy."],
+            },
+            backup: source.summary, current: target.summary, confirmation_token: token,
+            readiness, expires_at: token ? new Date(expiresAt).toISOString() : null, excluded: EXCLUDED,
+            compatibility_note: `Backup schema ${source.envelope.schema_version}; target schema ${SCHEMA_VERSION}. ` +
+                (source.envelope.schema_version !== SCHEMA_VERSION ? "Show schema_upgrade and its notes before asking for confirmation. The validated in-memory copy has been upgraded; the original backup file is unchanged. " : "No schema upgrade needed. ") + LEGACY_VECTOR_NOTE,
+            message: (token ? "Show this preview to the user and ask for explicit confirmation before backup_restore. " : "Show the connection blocker to the user. Do not ask for restore confirmation yet; resolve the blocker and call backup_preview again. ") + "Restore REPLACES all projects and global memory; it does not merge. Active sessions in the backup become abandoned history. Keep this MCP connection open. Older Lemma versions and external SQLite tools cannot be detected by this check and must be closed separately. Readiness is a point-in-time connection check, not a guarantee that restore will succeed. A verified safety backup is required before any replacement. Computer settings and diagnostic logs stay unchanged.",
+        };
+    }
+    finally {
+        source.db.close();
+    }
+}
+function replaceRows(target, source) {
+    // Enumerate the validated LOCAL schema. Never execute SQL supplied by a backup.
+    const tables = target.pragma("table_list")
+        .filter(row => row.schema === "main" && row.type === "table" && !row.name.startsWith("sqlite_") && !isLegacyVectorTable(row.name))
+        .map(row => row.name).sort();
+    const triggers = target.prepare("SELECT name, sql FROM sqlite_master WHERE type = 'trigger' ORDER BY name").all();
+    target.pragma("defer_foreign_keys = ON");
+    for (const trigger of triggers)
+        target.exec(`DROP TRIGGER ${quoteIdentifier(trigger.name)}`);
+    for (const table of tables)
+        target.exec(`DELETE FROM ${quoteIdentifier(table)}`);
+    for (const table of tables) {
+        const columns = target.pragma(`table_info(${quoteIdentifier(table)})`).map(row => quoteIdentifier(row.name));
+        const insert = target.prepare(`INSERT INTO ${quoteIdentifier(table)} (${columns.join(",")}) VALUES (${columns.map(() => "?").join(",")})`);
+        for (const row of source.prepare(`SELECT ${columns.join(",")} FROM ${quoteIdentifier(table)}`).raw().safeIntegers().iterate()) {
+            insert.run(...row);
+        }
+    }
+    target.exec("DELETE FROM sqlite_sequence");
+    const insertSequence = target.prepare("INSERT INTO sqlite_sequence(name, seq) VALUES (?, ?)");
+    for (const row of source.prepare("SELECT name, seq FROM sqlite_sequence").raw().safeIntegers().iterate())
+        insertSequence.run(...row);
+    for (const trigger of triggers)
+        target.exec(trigger.sql);
+    for (const table of ["memory_fts", "guides_fts"])
+        target.exec(`INSERT INTO ${table} (${table}) VALUES ('rebuild')`);
+    // Sessions from another machine must not be resumed by the auto-session hook.
+    target.prepare("UPDATE sessions SET status = 'abandoned', outcome = COALESCE(outcome, 'abandoned'), ended_at = COALESCE(ended_at, ?) WHERE status = 'active'").run(new Date().toISOString());
+    assertIntegrity(target);
+}
+export function restoreBackup(token, confirm) {
+    if (confirm !== true)
+        throw new Error("Explicit user confirmation is required. Show backup_preview first, then call backup_restore with confirm=true only after the user approves.");
+    if (!token)
+        throw new Error("Restore preview is not ready. Resolve the connection blocker, call backup_preview and ask for confirmation again.");
+    const preview = pendingRestores.get(token);
+    if (!preview || preview.expiresAt <= Date.now()) {
+        pendingRestores.delete(token);
+        throw new Error("Restore preview is missing or expired. Call backup_preview and ask for confirmation again.");
+    }
+    pendingRestores.delete(token); // One attempt per confirmed preview, including failures.
+    const lemma = getDb();
+    if (preview.target !== lemma)
+        throw new Error("The target database connection changed. Preview the backup again.");
+    const source = loadBackup(preview.path);
+    let safetyBackup;
+    try {
+        if (source.fingerprint !== preview.sourceHash)
+            throw new Error("The backup changed after preview. Preview it again before confirming.");
+        const previousSync = lemma.db.pragma("synchronous", { simple: true });
+        try {
+            lemma.db.pragma("synchronous = FULL");
+            lemma.withRestoreLock(() => {
+                assertSupportedSchema(lemma.db);
+                const current = snapshot(lemma.db);
+                if (sha256(current) !== preview.targetHash)
+                    throw new Error("Your memory changed after preview. Preview the backup again to review the current records.");
+                safetyBackup = saveBackup(current, backupDirectory(lemma), "before-restore");
+                replaceRows(lemma.db, source.db);
+            });
+        }
+        finally {
+            lemma.db.pragma(`synchronous = ${previousSync}`);
+            lemma.clearStatementCache();
+        }
+        pendingRestores.clear();
+        return { restored: true, verified: true, path: preview.path, safety_backup_path: safetyBackup,
+            summary: summarize(lemma.db), closed_sessions: source.summary.active_sessions,
+            message: "Memory restored and verified. Continue using this MCP connection; no terminal command or restart is needed. This replaces saved memory, not the text already in your current conversation. Start a new conversation if you need a fresh context." };
+    }
+    catch (error) {
+        throw new Error(`${error.message}${safetyBackup ? ` Safety backup: ${safetyBackup}.` : ""}`);
+    }
+    finally {
+        source.db.close();
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/db/backup.js.map

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

package/dist/db/clients.d.ts

@@ -0,0 +1,26 @@
+import type Database from "better-sqlite3";
+/** Cooperative leases cover MCP servers and visualizers using this version. */
+export interface ConnectionInspection {
+    current_connection: {
+        pid: number;
+        connection_id: string | null;
+    };
+    blocking_connections: {
+        pid: number;
+        connection_id: string;
+        same_process: boolean;
+    }[];
+    unverifiable_leases: number;
+    inspection_error: string | null;
+}
+export declare function connectionBlocker(info: ConnectionInspection): string | null;
+export declare class DatabaseClient {
+    private readonly directory;
+    private readonly lease;
+    private readonly prefix;
+    constructor(dbPath: string, db: Database.Database);
+    inspectConnections(): ConnectionInspection;
+    assertSoleClient(): void;
+    close(): void;
+}
+//# sourceMappingURL=clients.d.ts.map

package/dist/db/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/db/clients.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAgB3C,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClE,oBAAoB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACtF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAmBjD,kBAAkB,IAAI,oBAAoB;IAsB1C,gBAAgB,IAAI,IAAI;IAKxB,KAAK,IAAI,IAAI;CAGd"}

package/dist/db/clients.js

@@ -0,0 +1,97 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+function isMissing(error) {
+    return error.code === "ENOENT";
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // Access denied is not evidence that a process has stopped.
+        return error.code !== "ESRCH";
+    }
+}
+export function connectionBlocker(info) {
+    if (info.inspection_error)
+        return `Cannot inspect Lemma connections: ${info.inspection_error}`;
+    if (info.unverifiable_leases)
+        return `Cannot verify ${info.unverifiable_leases} Lemma client lease(s).`;
+    if (info.blocking_connections.length) {
+        const pids = [...new Set(info.blocking_connections.map(connection => connection.pid))].join(", ");
+        return `Another Lemma client is using this memory. Blocking process IDs: ${pids}.`;
+    }
+    return null;
+}
+export class DatabaseClient {
+    directory;
+    lease;
+    prefix;
+    constructor(dbPath, db) {
+        const canonical = fs.realpathSync(dbPath);
+        this.directory = path.dirname(canonical);
+        this.prefix = `${path.basename(canonical)}.client-`;
+        this.lease = path.join(this.directory, `${this.prefix}${process.pid}-${randomUUID()}`);
+        // Registration shares SQLite's writer lock with restore. A new client cannot
+        // load data between the peer check and the destructive commit. SQLite also
+        // releases this lock after a crash; there is no stale maintenance lock file.
+        try {
+            db.transaction(() => {
+                // Ownership is in the filename: a crash cannot leave half-written JSON.
+                fs.writeFileSync(this.lease, "", { flag: "wx", mode: 0o600 });
+            }).immediate();
+        }
+        catch (error) {
+            this.close();
+            throw error;
+        }
+    }
+    inspectConnections() {
+        const result = {
+            current_connection: { pid: process.pid, connection_id: path.basename(this.lease) },
+            blocking_connections: [], unverifiable_leases: 0, inspection_error: null,
+        };
+        let entries;
+        try {
+            entries = fs.readdirSync(this.directory);
+        }
+        catch (error) {
+            result.inspection_error = error.message;
+            return result;
+        }
+        for (const name of entries.sort()) {
+            if (!name.startsWith(this.prefix))
+                continue;
+            const file = path.join(this.directory, name);
+            if (file === this.lease)
+                continue;
+            const match = /^([1-9]\d*)-[0-9a-f-]{36}$/.exec(name.slice(this.prefix.length));
+            const pid = match ? Number(match[1]) : NaN;
+            if (!Number.isSafeInteger(pid)) {
+                result.unverifiable_leases++;
+                continue;
+            }
+            if (processIsAlive(pid)) {
+                result.blocking_connections.push({ pid, connection_id: name, same_process: pid === process.pid });
+            }
+        }
+        return result;
+    }
+    assertSoleClient() {
+        const blocker = connectionBlocker(this.inspectConnections());
+        if (blocker)
+            throw new Error(`${blocker} Close other Lemma connections through their application, then preview again. Keep this MCP connection open; never terminate its process.`);
+    }
+    close() {
+        try {
+            fs.unlinkSync(this.lease);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=clients.js.map

package/dist/db/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/db/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4DAA4D;QAC5D,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAUD,MAAM,UAAU,iBAAiB,CAAC,IAA0B;IAC1D,IAAI,IAAI,CAAC,gBAAgB;QAAE,OAAO,qCAAqC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC/F,IAAI,IAAI,CAAC,mBAAmB;QAAE,OAAO,iBAAiB,IAAI,CAAC,mBAAmB,yBAAyB,CAAC;IACxG,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClG,OAAO,oEAAoE,IAAI,GAAG,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,cAAc;IACR,SAAS,CAAS;IAClB,KAAK,CAAS;IACd,MAAM,CAAS;IAEhC,YAAY,MAAc,EAAE,EAAqB;QAC/C,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,CAAC,CAAC;QACvF,6EAA6E;QAC7E,2EAA2E;QAC3E,6EAA6E;QAC7E,IAAI,CAAC;YACH,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBAClB,wEAAwE;gBACxE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,MAAM,MAAM,GAAyB;YACnC,kBAAkB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YAClF,oBAAoB,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,EAAE,gBAAgB,EAAE,IAAI;SACzE,CAAC;QACF,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;QACjD,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,CAAC,gBAAgB,GAAI,KAAe,CAAC,OAAO,CAAC;YAAC,OAAO,MAAM,CAAC;QAAC,CAAC;QACpF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,SAAS;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC7C,IAAI,IAAI,KAAK,IAAI,CAAC,KAAK;gBAAE,SAAS;YAClC,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAChF,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC3E,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gBAAgB;QACd,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7D,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,2IAA2I,CAAC,CAAC;IACtL,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;QAAC,CAAC;IAC1F,CAAC;CACF"}