@fodx/codelens 1.0.0

package/build/src/cli.js

@@ -0,0 +1,265 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { openDb } from "./db/db.js";
+import { openContextDb } from "./context/store.js";
+import { detectScope } from "./git/scope.js";
+import { buildIndex } from "./index/indexer.js";
+import { getActiveIndexId } from "./index/manager.js";
+import { ctxSearch } from "./tools/search.js";
+import { ctxRelated } from "./tools/related.js";
+import { gatherStats } from "./obs/stats.js";
+import { runDoctor } from "./obs/doctor.js";
+import { UsageTracker, openGlobalUsageDb } from "./obs/usage.js";
+import { scheduleAutoPrune } from "./index/autoprune.js";
+import { runInstall, runUninstall, printConfig, HOSTS } from "./installer/agents.js";
+import { VERSION } from "./version.js";
+import { checkUpgrade, performUpgrade } from "./upgrade.js";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/**
+ * Minimal CLI (Gap #9): lets non-MCP users run diagnostics, build the index,
+ * and query from the terminal.
+ *
+ * Usage:
+ *   codelens current        # cl_current
+ *   codelens index          # cl_refresh (build/update current branch)
+ *   codelens search <query> # cl_search
+ *   codelens related <path> # cl_related
+ *   codelens stats          # cl_stats
+ *   codelens doctor         # cl_doctor
+ *   codelens (no args)      # start MCP stdio server
+ */
+function dbPathFor(repoRoot) {
+    const dir = join(homedir(), ".codelens", "indexes");
+    mkdirSync(dir, { recursive: true });
+    const rid = createHash("sha256").update(repoRoot).digest("hex").slice(0, 16);
+    return join(dir, `index-${rid}.db`);
+}
+function openCore(repoRoot) {
+    try {
+        return openDb(dbPathFor(repoRoot));
+    }
+    catch {
+        // corrupt → remove and rebuild on next index
+        try {
+            rmSync(dbPathFor(repoRoot));
+        }
+        catch { /* ignore */ }
+        return openDb(dbPathFor(repoRoot));
+    }
+}
+function ensureActiveIndex(coreDb, repoRoot) {
+    const scope = detectScope(repoRoot);
+    if (!scope)
+        throw new Error("not inside a git repo (or a directory with files)");
+    if (!getActiveIndexId())
+        buildIndex(coreDb, scope);
+}
+export async function cli(args) {
+    const cmd = args[0];
+    const repoRoot = process.cwd();
+    if (!cmd || cmd === "--help" || cmd === "-h") {
+        console.log("codelens [current|index|search <q>|related <path>|stats|doctor|install|uninstall|upgrade|version]");
+        return 0;
+    }
+    // ── DB-free commands (no repo/index needed) ──────────────────
+    if (cmd === "version" || cmd === "-v" || cmd === "--version") {
+        console.log(`codelens ${VERSION}`);
+        return 0;
+    }
+    if (cmd === "--print-config") {
+        const hostId = args[1];
+        const cmdExe = args[2] ?? defaultServerCommand() ?? "codelens";
+        if (!hostId) {
+            console.error("--print-config requires a host id (one of: " + HOSTS.map((h) => h.id).join(",") + ")");
+            return 1;
+        }
+        const out = printConfig(hostId, cmdExe);
+        if (out === null) {
+            console.error(`unknown host: ${hostId}`);
+            return 1;
+        }
+        console.log(out);
+        return 0;
+    }
+    if (cmd === "install") {
+        const { target, location, yes, command } = parseInstallArgs(args.slice(1));
+        const serverCommand = command ?? defaultServerCommand();
+        if (!serverCommand) {
+            console.error("could not determine the server executable. Run install.sh first, or pass --command <path-to-launcher>.");
+            return 1;
+        }
+        const report = runInstall({ serverCommand, location, target, yes, instructions: true });
+        console.log(`Server command: ${serverCommand}`);
+        console.log(`Configured (${report.configured.filter((c) => c.wrote).length} written, ${report.configured.filter((c) => c.already).length} already):`);
+        for (const c of report.configured)
+            console.log(`  ${c.host}: ${c.path} ${c.already ? "(already configured)" : c.wrote ? "(written)" : "(no change)"}`);
+        if (report.instructions.length)
+            console.log("Instructions written: " + report.instructions.map((i) => i.host).join(", "));
+        if (report.commands.length)
+            console.log("Slash commands written: " + report.commands.map((c) => `${c.host} (${c.wrote})`).join(", "));
+        if (report.skipped.length)
+            console.log("Skipped: " + report.skipped.join(", "));
+        console.log("Restart your agent(s) for the MCP server + commands to load.");
+        return 0;
+    }
+    if (cmd === "uninstall") {
+        const { target, location } = parseInstallArgs(args.slice(1));
+        const report = runUninstall({ location, target, instructions: true });
+        console.log("Removed:");
+        for (const c of report.configured)
+            if (c.wrote)
+                console.log(`  ${c.host}: ${c.path}`);
+        if (!report.configured.some((c) => c.wrote))
+            console.log("  (nothing to remove)");
+        return 0;
+    }
+    if (cmd === "upgrade") {
+        const sub = args[1];
+        if (sub === "--check") {
+            const r = await checkUpgrade();
+            console.log(r.message);
+            return r.upToDate ? 0 : 0;
+        }
+        const r = await performUpgrade(args[1]);
+        console.log(r.message);
+        return r.ok ? 0 : 1;
+    }
+    const coreDb = openCore(repoRoot);
+    const ctxDb = openContextDb(repoRoot);
+    void ctxDb;
+    scheduleAutoPrune(coreDb);
+    try {
+        switch (cmd) {
+            case "current": {
+                const scope = detectScope(repoRoot);
+                if (!scope) {
+                    console.log(JSON.stringify({ inGitRepo: false }));
+                    break;
+                }
+                if (!getActiveIndexId())
+                    buildIndex(coreDb, scope);
+                console.log(JSON.stringify({ branch: scope.branch, headSha: scope.headSha, dirtyFiles: scope.dirtyFiles.length }, null, 2));
+                break;
+            }
+            case "index":
+            case "refresh": {
+                const scope = detectScope(repoRoot);
+                if (!scope) {
+                    console.error("not inside a git repo");
+                    return 1;
+                }
+                const r = buildIndex(coreDb, scope);
+                console.log(JSON.stringify(r, null, 2));
+                break;
+            }
+            case "search": {
+                // support --type code|prose
+                const typeIdx = args.indexOf("--type");
+                const contentType = typeIdx >= 0 ? args[typeIdx + 1] : undefined;
+                const queryArgs = args.slice(1).filter((a) => a !== "--type" && a !== contentType);
+                const query = queryArgs.join(" ");
+                if (!query) {
+                    console.error("search requires a query");
+                    return 1;
+                }
+                ensureActiveIndex(coreDb, repoRoot);
+                const r = ctxSearch(coreDb, query, { scope: detectScope(repoRoot) ?? undefined, contentType });
+                for (const h of r.results) {
+                    console.log(`${h.score.toFixed(3)}  ${h.path}:${h.startLine}-${h.endLine}  [${h.why?.join(",")}]`);
+                }
+                break;
+            }
+            case "related": {
+                const path = args[1];
+                if (!path) {
+                    console.error("related requires a path");
+                    return 1;
+                }
+                ensureActiveIndex(coreDb, repoRoot);
+                const r = ctxRelated(coreDb, path);
+                for (const h of r.results)
+                    console.log(`${h.edgeType} (${h.hops}h)  ${h.path}`);
+                break;
+            }
+            case "stats": {
+                ensureActiveIndex(coreDb, repoRoot);
+                console.log(JSON.stringify(gatherStats(coreDb), null, 2));
+                break;
+            }
+            case "usage": {
+                const snap = new UsageTracker(openGlobalUsageDb()).snapshot();
+                console.log(`Global usage — calls: ${snap.totals.calls}  served: ${fmt(snap.totals.bytes_served)}  saved(est): ${fmt(snap.totals.bytes_saved)}`);
+                console.log("Per tool:");
+                for (const t of snap.perTool)
+                    console.log(`  ${t.tool.padEnd(14)} calls=${t.calls}  served=${fmt(t.bytes_served)}  saved=${fmt(t.bytes_saved)}`);
+                console.log("Per repo:");
+                for (const r of snap.perRepo)
+                    console.log(`  ${r.repo_id.slice(0, 8)}  calls=${r.calls}  served=${fmt(r.bytes_served)}  saved=${fmt(r.bytes_saved)}`);
+                break;
+            }
+            case "doctor": {
+                console.log(JSON.stringify(runDoctor(coreDb, repoRoot), null, 2));
+                break;
+            }
+            default:
+                console.error(`unknown command: ${cmd}`);
+                return 1;
+        }
+        return 0;
+    }
+    finally {
+        coreDb.close();
+    }
+}
+function fmt(n) {
+    if (n < 1024)
+        return `${n}B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)}KB`;
+    return `${(n / 1024 / 1024).toFixed(2)}MB`;
+}
+function defaultServerCommand() {
+    // Prefer the launcher the bootstrap installer put on PATH.
+    const launcher = join(homedir(), ".local", "bin", "codelens");
+    if (existsSync(launcher))
+        return launcher;
+    // Dev fallback: the currently running server.js (only meaningful for --print-config).
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const serverJs = join(here, "..", "server.js");
+        if (existsSync(serverJs))
+            return serverJs;
+    }
+    catch { /* ignore */ }
+    return null;
+}
+function parseInstallArgs(args) {
+    let target = "auto";
+    let location = "global";
+    let yes = false;
+    let command;
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--target") {
+            const v = args[++i];
+            target = v === "all" || v === "auto" || v === "none" ? v : (v ?? "").split(",");
+        }
+        else if (a === "--location") {
+            const v = args[++i];
+            if (v === "local" || v === "global")
+                location = v;
+        }
+        else if (a === "--yes" || a === "-y")
+            yes = true;
+        else if (a === "--command")
+            command = args[++i];
+        else if (a === "--args")
+            rest.push(...(args[++i] ?? "").split(" "));
+    }
+    return { target, location, yes, command, args: rest };
+}
+//# sourceMappingURL=cli.js.map

package/build/src/cli.js.map

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

package/build/src/context/schema.sql

@@ -0,0 +1,23 @@
+-- saved_contexts schema (separate DB file — survives core-index rebuild, Step 21)
+
+CREATE TABLE IF NOT EXISTS saved_contexts (
+  id              TEXT PRIMARY KEY,
+  repo_id         TEXT NOT NULL,        -- hash of repo root (scoping)
+  name            TEXT NOT NULL,
+  notes           TEXT,
+  pinned          INTEGER NOT NULL DEFAULT 0,
+  created_at      INTEGER NOT NULL,
+  last_accessed_at INTEGER NOT NULL,
+  UNIQUE (repo_id, name)
+);
+
+CREATE TABLE IF NOT EXISTS saved_context_items (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  context_id   TEXT NOT NULL,
+  handle       TEXT,
+  path          TEXT,
+  symbol_id     TEXT,
+  chunk_id      TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_items_context ON saved_context_items(context_id);
+CREATE UNIQUE INDEX IF NOT EXISTS uq_items ON saved_context_items(context_id, COALESCE(chunk_id, handle), path);

package/build/src/context/store.js

@@ -0,0 +1,91 @@
+import Database from "better-sqlite3";
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { mkdirSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+/**
+ * Saved context store (Step 21).
+ *
+ * Lives in a SEPARATE SQLite DB file (contexts.db) keyed by repo_id, so it
+ * survives core-index corruption rebuilds (Step 12) — only the core index DB
+ * is rebuilt; saved contexts are untouched. Items reference path+symbol (not
+ * chunk_id) so they remain valid across reindexes.
+ */
+const SCHEMA = readSchema();
+function readSchema() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return readFileSync(join(here, "schema.sql"), "utf-8");
+}
+export function repoId(repoRoot) {
+    return createHash("sha256").update(repoRoot).digest("hex").slice(0, 16);
+}
+function contextDbPath(repoRoot) {
+    const dir = join(homedir(), ".codelens", "contexts");
+    mkdirSync(dir, { recursive: true });
+    return join(dir, `contexts-${repoId(repoRoot)}.db`);
+}
+/** Open (or create) the separate contexts DB for a repo. */
+export function openContextDb(repoRoot) {
+    const path = contextDbPath(repoRoot);
+    const db = new Database(path);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    db.exec(SCHEMA);
+    return db;
+}
+/** For tests: open an in-memory contexts DB. */
+export function openMemoryContextDb() {
+    const db = new Database(":memory:");
+    db.pragma("foreign_keys = ON");
+    db.exec(SCHEMA);
+    return db;
+}
+export function saveContext(db, repoRoot, name, items, opts) {
+    const rid = repoId(repoRoot);
+    const now = Date.now();
+    const id = "ctx_" + createHash("sha256").update(rid + name).digest("hex").slice(0, 16);
+    const tx = db.transaction(() => {
+        db.prepare(`INSERT INTO saved_contexts (id, repo_id, name, notes, pinned, created_at, last_accessed_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET notes=excluded.notes, pinned=excluded.pinned, last_accessed_at=excluded.last_accessed_at`).run(id, rid, name, opts?.notes ?? null, opts?.pinned ? 1 : 0, now, now);
+        db.prepare("DELETE FROM saved_context_items WHERE context_id = ?").run(id);
+        const ins = db.prepare(`INSERT INTO saved_context_items (context_id, handle, path, symbol_id, chunk_id) VALUES (?, ?, ?, ?, ?)`);
+        for (const it of items) {
+            ins.run(id, it.handle ?? null, it.path ?? null, it.symbol_id ?? null, it.chunk_id ?? null);
+        }
+    });
+    tx();
+    return {
+        id, repo_id: rid, name, notes: opts?.notes ?? null,
+        pinned: !!opts?.pinned, created_at: now, last_accessed_at: now,
+    };
+}
+export function loadContext(db, repoRoot, name) {
+    const rid = repoId(repoRoot);
+    const ctx = db.prepare("SELECT * FROM saved_contexts WHERE repo_id = ? AND name = ?").get(rid, name);
+    if (!ctx)
+        return { context: null, items: [] };
+    db.prepare("UPDATE saved_contexts SET last_accessed_at = ? WHERE id = ?").run(Date.now(), ctx.id);
+    const items = db.prepare("SELECT handle, path, symbol_id, chunk_id FROM saved_context_items WHERE context_id = ?").all(ctx.id);
+    return { context: { ...ctx, pinned: !!ctx.pinned }, items };
+}
+export function listContexts(db, repoRoot) {
+    const rid = repoId(repoRoot);
+    const rows = db.prepare("SELECT * FROM saved_contexts WHERE repo_id = ? ORDER BY last_accessed_at DESC").all(rid);
+    return rows.map((r) => ({ ...r, pinned: !!r.pinned }));
+}
+export function deleteContext(db, repoRoot, name) {
+    const rid = repoId(repoRoot);
+    const ctx = db.prepare("SELECT id FROM saved_contexts WHERE repo_id = ? AND name = ?").get(rid, name);
+    if (!ctx)
+        return false;
+    db.transaction(() => {
+        db.prepare("DELETE FROM saved_context_items WHERE context_id = ?").run(ctx.id);
+        db.prepare("DELETE FROM saved_contexts WHERE id = ?").run(ctx.id);
+    })();
+    return true;
+}
+export { contextDbPath, existsSync };
+//# sourceMappingURL=store.js.map

package/build/src/context/store.js.map

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

package/build/src/db/db.js

@@ -0,0 +1,65 @@
+import Database from "better-sqlite3";
+import { runMigrations, DbVersionMismatch } from "./migrations.js";
+import { checkIntegrity, isCorruptionError } from "../index/recovery.js";
+/**
+ * Open a codelens SQLite database with safe defaults:
+ *   - WAL journal mode (concurrent readers, single writer — Step 11)
+ *   - foreign keys ON (cascade deletes scoped by index_id)
+ *   - busy_timeout to tolerate brief write locks
+ *   - migrations applied with version guard
+ *
+ * On `DbVersionMismatch`, the caller (recovery.ts — Step 12) decides whether
+ * to rebuild the core index.
+ */
+export function openDb(path, opts) {
+    let db;
+    try {
+        db = new Database(path, { readonly: opts?.readonly ?? false });
+        db.pragma("journal_mode = WAL");
+        db.pragma("foreign_keys = ON");
+        db.pragma("busy_timeout = 5000");
+        // Quick integrity check on startup (Section 16 risk 6). On corruption the
+        // caller may catch CorruptDb and rebuild the core index.
+        if (!opts?.skipIntegrityCheck) {
+            const integrity = checkIntegrity(db);
+            if (!integrity.ok) {
+                db.close();
+                throw new CorruptDb(integrity.message);
+            }
+        }
+        runMigrations(db, path);
+    }
+    catch (err) {
+        if (err instanceof DbVersionMismatch)
+            throw err;
+        if (err instanceof CorruptDb)
+            throw err;
+        if (isCorruptionError(err)) {
+            try {
+                db?.close();
+            }
+            catch { /* ignore */ }
+            throw new CorruptDb(err instanceof Error ? err.message : String(err));
+        }
+        try {
+            db?.close();
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+    return db;
+}
+/** In-memory DB for tests (still applies migrations; no integrity backup path). */
+export function openMemoryDb() {
+    const db = new Database(":memory:");
+    db.pragma("foreign_keys = ON");
+    runMigrations(db);
+    return db;
+}
+export class CorruptDb extends Error {
+    constructor(message) {
+        super(`database corruption detected: ${message}`);
+        this.name = "CorruptDb";
+    }
+}
+//# sourceMappingURL=db.js.map

package/build/src/db/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/db/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAA2D;IAC9F,IAAI,EAAiC,CAAC;IACtC,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;QAC/D,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAEjC,0EAA0E;QAC1E,yDAAyD;QACzD,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;gBAClB,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QACD,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,iBAAiB;YAAE,MAAM,GAAG,CAAC;QAChD,IAAI,GAAG,YAAY,SAAS;YAAE,MAAM,GAAG,CAAC;QACxC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBAAC,EAAE,EAAE,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,IAAI,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC;YAAC,EAAE,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY;IAC1B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/build/src/db/migrations.js

@@ -0,0 +1,88 @@
+import { existsSync } from "node:fs";
+import { SCHEMA_V1 } from "./schema.js";
+import { backupBeforeMigration, restoreBackup } from "../index/recovery.js";
+/**
+ * Versioned schema + migration runner.
+ *
+ * - `runMigrations(db)` applies additive migrations up to CODE_SCHEMA_VERSION.
+ * - Version guard: if the DB's applied version > CODE_SCHEMA_VERSION, throw
+ *   `DbVersionMismatch` (caller must rebuild core index; saved contexts survive
+ *   in a separate DB — Step 21).
+ * - Migrations run inside a single transaction; a pre-migration backup copy is
+ *   made before the first migration (Step 12 enhances with restore-on-failure).
+ */
+export class DbVersionMismatch extends Error {
+    dbVersion;
+    codeVersion;
+    constructor(dbVersion, codeVersion) {
+        super(`DB schema version ${dbVersion} is newer than code ${codeVersion}; rebuild required`);
+        this.dbVersion = dbVersion;
+        this.codeVersion = codeVersion;
+        this.name = "DbVersionMismatch";
+    }
+}
+/** v1 migration: create the full initial schema. */
+export const MIGRATIONS = [
+    { version: 1, description: "initial schema", sql: SCHEMA_V1 },
+];
+export const CODE_SCHEMA_VERSION = MIGRATIONS.reduce((m, x) => Math.max(m, x.version), 0);
+/** Read the highest applied version from the DB (0 if fresh). */
+function appliedVersion(db) {
+    // schema_version may not exist yet on a truly fresh DB.
+    const row = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='schema_version'")
+        .get();
+    if (!row?.name)
+        return 0;
+    const r = db.prepare("SELECT MAX(version) AS v FROM schema_version").get();
+    return r.v ?? 0;
+}
+/**
+ * Apply pending migrations. Throws DbVersionMismatch if the DB is newer than
+ * the code. Each migration runs in its own transaction. For file-backed DBs,
+ * a backup copy is made before the first migration; on failure the backup is
+ * restored (Section 16 risk 3).
+ */
+export function runMigrations(db, dbPath) {
+    const current = appliedVersion(db);
+    if (current > CODE_SCHEMA_VERSION) {
+        throw new DbVersionMismatch(current, CODE_SCHEMA_VERSION);
+    }
+    const pending = MIGRATIONS.filter((m) => m.version > current);
+    if (pending.length === 0)
+        return current;
+    // Ensure schema_version table exists (v1 migration creates it, but guard).
+    db.exec("CREATE TABLE IF NOT EXISTS schema_version (version INTEGER PRIMARY KEY, applied_at INTEGER NOT NULL)");
+    // Backup file-backed DB before the first migration so we can restore on failure.
+    let backed = false;
+    if (dbPath && existsSync(dbPath)) {
+        try {
+            backupBeforeMigration(dbPath, pending[0].version);
+            backed = true;
+        }
+        catch {
+            // best-effort backup; continue without it
+        }
+    }
+    for (const m of pending) {
+        try {
+            const apply = db.transaction(() => {
+                db.exec(m.sql);
+                db.prepare("INSERT INTO schema_version (version, applied_at) VALUES (?, ?)").run(m.version, Date.now());
+            });
+            apply();
+        }
+        catch (err) {
+            // Migration failed: attempt restore from backup.
+            if (backed && dbPath) {
+                try {
+                    restoreBackup(dbPath, pending[0].version);
+                }
+                catch { /* best-effort */ }
+            }
+            throw err;
+        }
+    }
+    return CODE_SCHEMA_VERSION;
+}
+//# sourceMappingURL=migrations.js.map

package/build/src/db/migrations.js.map

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

package/build/src/db/schema.js

@@ -0,0 +1,11 @@
+// Auto-generated from schema.sql — single source of truth for the DB schema.
+// Re-exported so migrations.ts can bundle it without runtime fs reads.
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const here = dirname(fileURLToPath(import.meta.url));
+// In dev (vitest from src/): here = src/db/. In build: build/src/db/.
+// schema.sql lives alongside this file in src; for the build it is copied by
+// the `build` script (cp src/db/schema.sql build/src/db/schema.sql).
+export const SCHEMA_V1 = readFileSync(join(here, "schema.sql"), "utf-8");
+//# sourceMappingURL=schema.js.map

package/build/src/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/db/schema.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uEAAuE;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,sEAAsE;AACtE,6EAA6E;AAC7E,qEAAqE;AACrE,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC"}