@context-vault/core 2.17.1 → 3.0.0

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AACvD,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAC5B,iDAAiD,CAAC;AAEpD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC5C,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC5C,cAAc,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE;IACvE,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAG1B;IACF,KAAK,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;IAC/B,SAAS,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;CACpC,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,13 @@
+import { DatabaseSync } from "node:sqlite";
+import type { PreparedStatements } from "./types.js";
+export declare class NativeModuleError extends Error {
+    originalError: Error;
+    constructor(originalError: Error);
+}
+export declare const SCHEMA_DDL = "\n  CREATE TABLE IF NOT EXISTS vault (\n    id              TEXT PRIMARY KEY,\n    kind            TEXT NOT NULL,\n    category        TEXT NOT NULL DEFAULT 'knowledge',\n    title           TEXT,\n    body            TEXT NOT NULL,\n    meta            TEXT,\n    tags            TEXT,\n    source          TEXT,\n    file_path       TEXT UNIQUE,\n    identity_key    TEXT,\n    expires_at      TEXT,\n    superseded_by   TEXT,\n    created_at      TEXT DEFAULT (datetime('now')),\n    updated_at      TEXT,\n    hit_count       INTEGER DEFAULT 0,\n    last_accessed_at TEXT,\n    source_files    TEXT,\n    tier            TEXT DEFAULT 'working' CHECK(tier IN ('ephemeral', 'working', 'durable')),\n    related_to      TEXT\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_vault_kind ON vault(kind);\n  CREATE INDEX IF NOT EXISTS idx_vault_category ON vault(category);\n  CREATE INDEX IF NOT EXISTS idx_vault_category_created ON vault(category, created_at DESC);\n  CREATE INDEX IF NOT EXISTS idx_vault_updated ON vault(updated_at DESC);\n  CREATE UNIQUE INDEX IF NOT EXISTS idx_vault_identity ON vault(kind, identity_key) WHERE identity_key IS NOT NULL AND category = 'entity';\n  CREATE INDEX IF NOT EXISTS idx_vault_superseded ON vault(superseded_by) WHERE superseded_by IS NOT NULL;\n  CREATE INDEX IF NOT EXISTS idx_vault_tier ON vault(tier);\n\n  CREATE VIRTUAL TABLE IF NOT EXISTS vault_fts USING fts5(\n    title, body, tags, kind,\n    content='vault', content_rowid='rowid'\n  );\n\n  CREATE TRIGGER IF NOT EXISTS vault_ai AFTER INSERT ON vault BEGIN\n    INSERT INTO vault_fts(rowid, title, body, tags, kind)\n      VALUES (new.rowid, new.title, new.body, new.tags, new.kind);\n  END;\n  CREATE TRIGGER IF NOT EXISTS vault_ad AFTER DELETE ON vault BEGIN\n    INSERT INTO vault_fts(vault_fts, rowid, title, body, tags, kind)\n      VALUES ('delete', old.rowid, old.title, old.body, old.tags, old.kind);\n  END;\n  CREATE TRIGGER IF NOT EXISTS vault_au AFTER UPDATE ON vault BEGIN\n    INSERT INTO vault_fts(vault_fts, rowid, title, body, tags, kind)\n      VALUES ('delete', old.rowid, old.title, old.body, old.tags, old.kind);\n    INSERT INTO vault_fts(rowid, title, body, tags, kind)\n      VALUES (new.rowid, new.title, new.body, new.tags, new.kind);\n  END;\n\n  CREATE VIRTUAL TABLE IF NOT EXISTS vault_vec USING vec0(embedding float[384]);\n";
+export declare function initDatabase(dbPath: string): Promise<DatabaseSync>;
+export declare function prepareStatements(db: DatabaseSync): PreparedStatements;
+export declare function insertVec(stmts: PreparedStatements, rowid: number, embedding: Float32Array): void;
+export declare function deleteVec(stmts: PreparedStatements, rowid: number): void;
+export declare function testConnection(db: DatabaseSync): boolean;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,aAAa,EAAE,KAAK,CAAC;gBACT,aAAa,EAAE,KAAK;CAMjC;AAkCD,eAAO,MAAM,UAAU,szEAoDtB,CAAC;AAIF,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsDxE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,kBAAkB,CA6CtE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,YAAY,GACtB,IAAI,CAIN;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAOxD"}

package/dist/db.js

@@ -0,0 +1,191 @@
+import { unlinkSync, copyFileSync, existsSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+export class NativeModuleError extends Error {
+    originalError;
+    constructor(originalError) {
+        const diagnostic = formatNativeModuleError(originalError);
+        super(diagnostic);
+        this.name = "NativeModuleError";
+        this.originalError = originalError;
+    }
+}
+function formatNativeModuleError(err) {
+    const msg = err.message || "";
+    return [
+        `sqlite-vec extension failed to load: ${msg}`,
+        "",
+        `  Running Node.js: ${process.version} (${process.execPath})`,
+        "",
+        "  Fix: Reinstall context-vault:",
+        "    npx -y context-vault@latest setup",
+    ].join("\n");
+}
+let _sqliteVec = null;
+async function loadSqliteVec() {
+    if (_sqliteVec)
+        return _sqliteVec;
+    const vecMod = await import("sqlite-vec");
+    _sqliteVec = vecMod;
+    return _sqliteVec;
+}
+function runTransaction(db, fn) {
+    db.exec("BEGIN");
+    try {
+        fn();
+        db.exec("COMMIT");
+    }
+    catch (e) {
+        db.exec("ROLLBACK");
+        throw e;
+    }
+}
+export const SCHEMA_DDL = `
+  CREATE TABLE IF NOT EXISTS vault (
+    id              TEXT PRIMARY KEY,
+    kind            TEXT NOT NULL,
+    category        TEXT NOT NULL DEFAULT 'knowledge',
+    title           TEXT,
+    body            TEXT NOT NULL,
+    meta            TEXT,
+    tags            TEXT,
+    source          TEXT,
+    file_path       TEXT UNIQUE,
+    identity_key    TEXT,
+    expires_at      TEXT,
+    superseded_by   TEXT,
+    created_at      TEXT DEFAULT (datetime('now')),
+    updated_at      TEXT,
+    hit_count       INTEGER DEFAULT 0,
+    last_accessed_at TEXT,
+    source_files    TEXT,
+    tier            TEXT DEFAULT 'working' CHECK(tier IN ('ephemeral', 'working', 'durable')),
+    related_to      TEXT
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_vault_kind ON vault(kind);
+  CREATE INDEX IF NOT EXISTS idx_vault_category ON vault(category);
+  CREATE INDEX IF NOT EXISTS idx_vault_category_created ON vault(category, created_at DESC);
+  CREATE INDEX IF NOT EXISTS idx_vault_updated ON vault(updated_at DESC);
+  CREATE UNIQUE INDEX IF NOT EXISTS idx_vault_identity ON vault(kind, identity_key) WHERE identity_key IS NOT NULL AND category = 'entity';
+  CREATE INDEX IF NOT EXISTS idx_vault_superseded ON vault(superseded_by) WHERE superseded_by IS NOT NULL;
+  CREATE INDEX IF NOT EXISTS idx_vault_tier ON vault(tier);
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS vault_fts USING fts5(
+    title, body, tags, kind,
+    content='vault', content_rowid='rowid'
+  );
+
+  CREATE TRIGGER IF NOT EXISTS vault_ai AFTER INSERT ON vault BEGIN
+    INSERT INTO vault_fts(rowid, title, body, tags, kind)
+      VALUES (new.rowid, new.title, new.body, new.tags, new.kind);
+  END;
+  CREATE TRIGGER IF NOT EXISTS vault_ad AFTER DELETE ON vault BEGIN
+    INSERT INTO vault_fts(vault_fts, rowid, title, body, tags, kind)
+      VALUES ('delete', old.rowid, old.title, old.body, old.tags, old.kind);
+  END;
+  CREATE TRIGGER IF NOT EXISTS vault_au AFTER UPDATE ON vault BEGIN
+    INSERT INTO vault_fts(vault_fts, rowid, title, body, tags, kind)
+      VALUES ('delete', old.rowid, old.title, old.body, old.tags, old.kind);
+    INSERT INTO vault_fts(rowid, title, body, tags, kind)
+      VALUES (new.rowid, new.title, new.body, new.tags, new.kind);
+  END;
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS vault_vec USING vec0(embedding float[384]);
+`;
+const CURRENT_VERSION = 15;
+export async function initDatabase(dbPath) {
+    const sqliteVec = await loadSqliteVec();
+    function createDb(path) {
+        const db = new DatabaseSync(path, { allowExtension: true });
+        db.exec("PRAGMA journal_mode = WAL");
+        db.exec("PRAGMA foreign_keys = ON");
+        try {
+            sqliteVec.load(db);
+        }
+        catch (e) {
+            throw new NativeModuleError(e);
+        }
+        return db;
+    }
+    const db = createDb(dbPath);
+    const version = db.prepare("PRAGMA user_version").get().user_version;
+    if (version > 0 && version < 15) {
+        console.error(`[context-vault] Schema v${version} is outdated. Rebuilding database...`);
+        const backupPath = `${dbPath}.v${version}.backup`;
+        try {
+            db.close();
+            if (existsSync(dbPath)) {
+                copyFileSync(dbPath, backupPath);
+                console.error(`[context-vault] Backed up old database to: ${backupPath}`);
+            }
+        }
+        catch (backupErr) {
+            console.error(`[context-vault] Warning: could not backup old database: ${backupErr.message}`);
+        }
+        unlinkSync(dbPath);
+        try {
+            unlinkSync(dbPath + "-wal");
+        }
+        catch { }
+        try {
+            unlinkSync(dbPath + "-shm");
+        }
+        catch { }
+        const freshDb = createDb(dbPath);
+        freshDb.exec(SCHEMA_DDL);
+        freshDb.exec(`PRAGMA user_version = ${CURRENT_VERSION}`);
+        return freshDb;
+    }
+    if (version < 15) {
+        db.exec(SCHEMA_DDL);
+        db.exec(`PRAGMA user_version = ${CURRENT_VERSION}`);
+    }
+    return db;
+}
+export function prepareStatements(db) {
+    try {
+        return {
+            insertEntry: db.prepare(`INSERT INTO vault (id, kind, category, title, body, meta, tags, source, file_path, identity_key, expires_at, created_at, updated_at, source_files, tier) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+            updateEntry: db.prepare(`UPDATE vault SET title = ?, body = ?, meta = ?, tags = ?, source = ?, category = ?, identity_key = ?, expires_at = ?, updated_at = datetime('now') WHERE file_path = ?`),
+            deleteEntry: db.prepare(`DELETE FROM vault WHERE id = ?`),
+            getRowid: db.prepare(`SELECT rowid FROM vault WHERE id = ?`),
+            getRowidByPath: db.prepare(`SELECT rowid FROM vault WHERE file_path = ?`),
+            getEntryById: db.prepare(`SELECT * FROM vault WHERE id = ?`),
+            getByIdentityKey: db.prepare(`SELECT * FROM vault WHERE kind = ? AND identity_key = ?`),
+            upsertByIdentityKey: db.prepare(`UPDATE vault SET title = ?, body = ?, meta = ?, tags = ?, source = ?, category = ?, file_path = ?, expires_at = ?, source_files = ?, updated_at = datetime('now') WHERE kind = ? AND identity_key = ?`),
+            updateSourceFiles: db.prepare(`UPDATE vault SET source_files = ? WHERE id = ?`),
+            updateRelatedTo: db.prepare(`UPDATE vault SET related_to = ? WHERE id = ?`),
+            insertVecStmt: db.prepare(`INSERT INTO vault_vec (rowid, embedding) VALUES (?, ?)`),
+            deleteVecStmt: db.prepare(`DELETE FROM vault_vec WHERE rowid = ?`),
+            updateSupersededBy: db.prepare(`UPDATE vault SET superseded_by = ? WHERE id = ?`),
+            clearSupersededByRef: db.prepare(`UPDATE vault SET superseded_by = NULL WHERE superseded_by = ?`),
+        };
+    }
+    catch (e) {
+        throw new Error(`Failed to prepare database statements. The database may be corrupted.\n` +
+            `Try deleting and rebuilding: context-vault reindex\n` +
+            `Original error: ${e.message}`);
+    }
+}
+export function insertVec(stmts, rowid, embedding) {
+    const safeRowid = BigInt(rowid);
+    if (safeRowid < 1n)
+        throw new Error(`Invalid rowid: ${rowid}`);
+    stmts.insertVecStmt.run(safeRowid, embedding);
+}
+export function deleteVec(stmts, rowid) {
+    const safeRowid = BigInt(rowid);
+    if (safeRowid < 1n)
+        throw new Error(`Invalid rowid: ${rowid}`);
+    stmts.deleteVecStmt.run(safeRowid);
+}
+export function testConnection(db) {
+    try {
+        db.prepare("SELECT 1").get();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/embed.d.ts

@@ -0,0 +1,5 @@
+export declare function embed(text: string): Promise<Float32Array | null>;
+export declare function embedBatch(texts: string[]): Promise<(Float32Array | null)[]>;
+export declare function resetEmbedPipeline(): void;
+export declare function isEmbedAvailable(): boolean | null;
+//# sourceMappingURL=embed.d.ts.map

package/dist/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAgDA,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAYtE;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAmBlF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED,wBAAgB,gBAAgB,IAAI,OAAO,GAAG,IAAI,CAEjD"}

package/dist/embed.js

@@ -0,0 +1,78 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdirSync } from "node:fs";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let extractor = null;
+let embedAvailable = null;
+let loadingPromise = null;
+async function ensurePipeline() {
+    if (embedAvailable === false)
+        return null;
+    if (extractor)
+        return extractor;
+    if (loadingPromise)
+        return loadingPromise;
+    loadingPromise = (async () => {
+        try {
+            const { pipeline, env } = await import("@huggingface/transformers");
+            const modelCacheDir = join(homedir(), ".context-mcp", "models");
+            mkdirSync(modelCacheDir, { recursive: true });
+            env.cacheDir = modelCacheDir;
+            console.error("[context-vault] Loading embedding model (first run may download ~22MB)...");
+            extractor = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+            embedAvailable = true;
+            return extractor;
+        }
+        catch (e) {
+            embedAvailable = false;
+            console.error(`[context-vault] Failed to load embedding model: ${e.message}`);
+            console.error(`[context-vault] Semantic search disabled. Full-text search still works.`);
+            return null;
+        }
+        finally {
+            loadingPromise = null;
+        }
+    })();
+    return loadingPromise;
+}
+export async function embed(text) {
+    const ext = await ensurePipeline();
+    if (!ext)
+        return null;
+    const result = await ext([text], { pooling: "mean", normalize: true });
+    if (!result?.data?.length) {
+        extractor = null;
+        embedAvailable = null;
+        loadingPromise = null;
+        throw new Error("Embedding pipeline returned empty result");
+    }
+    return new Float32Array(result.data);
+}
+export async function embedBatch(texts) {
+    if (!texts.length)
+        return [];
+    const ext = await ensurePipeline();
+    if (!ext)
+        return texts.map(() => null);
+    const result = await ext(texts, { pooling: "mean", normalize: true });
+    if (!result?.data?.length) {
+        extractor = null;
+        embedAvailable = null;
+        loadingPromise = null;
+        throw new Error("Embedding pipeline returned empty result");
+    }
+    const dim = result.data.length / texts.length;
+    if (!Number.isInteger(dim) || dim <= 0) {
+        throw new Error(`Unexpected embedding dimension: ${result.data.length} / ${texts.length} = ${dim}`);
+    }
+    return texts.map((_, i) => result.data.subarray(i * dim, (i + 1) * dim));
+}
+export function resetEmbedPipeline() {
+    extractor = null;
+    embedAvailable = null;
+    loadingPromise = null;
+}
+export function isEmbedAvailable() {
+    return embedAvailable;
+}
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,8DAA8D;AAC9D,IAAI,SAAS,GAAQ,IAAI,CAAC;AAC1B,IAAI,cAAc,GAAmB,IAAI,CAAC;AAC1C,IAAI,cAAc,GAAqC,IAAI,CAAC;AAE5D,KAAK,UAAU,cAAc;IAC3B,IAAI,cAAc,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAEpE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;YAChE,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,GAAG,CAAC,QAAQ,GAAG,aAAa,CAAC;YAE7B,OAAO,CAAC,KAAK,CACX,2EAA2E,CAC5E,CAAC;YACF,SAAS,GAAG,MAAM,QAAQ,CACxB,oBAAoB,EACpB,yBAAyB,CAC1B,CAAC;YACF,cAAc,GAAG,IAAI,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,cAAc,GAAG,KAAK,CAAC;YACvB,OAAO,CAAC,KAAK,CACX,mDAAoD,CAAW,CAAC,OAAO,EAAE,CAC1E,CAAC;YACF,OAAO,CAAC,KAAK,CACX,yEAAyE,CAC1E,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,SAAS,GAAG,IAAI,CAAC;QACjB,cAAc,GAAG,IAAI,CAAC;QACtB,cAAc,GAAG,IAAI,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe;IAC9C,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,SAAS,GAAG,IAAI,CAAC;QACjB,cAAc,GAAG,IAAI,CAAC;QACtB,cAAc,GAAG,IAAI,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,KAAK,CAAC,MAAM,MAAM,GAAG,EAAE,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,SAAS,GAAG,IAAI,CAAC;IACjB,cAAc,GAAG,IAAI,CAAC;IACtB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/files.d.ts

@@ -0,0 +1,13 @@
+export declare function ulid(): string;
+export declare function slugify(text: string, maxLen?: number): string;
+export declare function kindToDir(kind: string): string;
+export declare function dirToKind(dirName: string): string;
+export declare function normalizeKind(input: string): string;
+export declare function kindToPath(kind: string): string;
+export declare function safeJoin(base: string, ...parts: string[]): string;
+export interface WalkResult {
+    filePath: string;
+    relDir: string;
+}
+export declare function walkDir(dir: string): WalkResult[];
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAMA,wBAAgB,IAAI,IAAI,MAAM,CAa7B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAUzD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CASjE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAcjD"}

package/dist/files.js

@@ -0,0 +1,66 @@
+import { readdirSync } from "node:fs";
+import { join, resolve, sep } from "node:path";
+import { categoryDirFor } from "./categories.js";
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export function ulid() {
+    const now = Date.now();
+    let ts = "";
+    let t = now;
+    for (let i = 0; i < 10; i++) {
+        ts = CROCKFORD[t & 31] + ts;
+        t = Math.floor(t / 32);
+    }
+    let rand = "";
+    for (let i = 0; i < 16; i++) {
+        rand += CROCKFORD[Math.floor(Math.random() * 32)];
+    }
+    return ts + rand;
+}
+export function slugify(text, maxLen = 60) {
+    let slug = text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (slug.length > maxLen) {
+        slug =
+            slug.slice(0, maxLen).replace(/-[^-]*$/, "") || slug.slice(0, maxLen);
+    }
+    return slug;
+}
+export function kindToDir(kind) {
+    return kind;
+}
+export function dirToKind(dirName) {
+    return dirName;
+}
+export function normalizeKind(input) {
+    return input;
+}
+export function kindToPath(kind) {
+    return `${categoryDirFor(kind)}/${kindToDir(kind)}`;
+}
+export function safeJoin(base, ...parts) {
+    const resolvedBase = resolve(base);
+    const result = resolve(join(base, ...parts));
+    if (!result.startsWith(resolvedBase + sep) && result !== resolvedBase) {
+        throw new Error(`Path traversal blocked: resolved path escapes base directory`);
+    }
+    return result;
+}
+export function walkDir(dir) {
+    const results = [];
+    function walk(currentDir, relDir) {
+        for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
+            const fullPath = join(currentDir, entry.name);
+            if (entry.isDirectory() && !entry.name.startsWith("_")) {
+                walk(fullPath, relDir ? join(relDir, entry.name) : entry.name);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".md")) {
+                results.push({ filePath: fullPath, relDir });
+            }
+        }
+    }
+    walk(dir, "");
+    return results;
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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

package/dist/formatters.d.ts

@@ -0,0 +1,8 @@
+interface FormatInput {
+    title?: string | null;
+    body: string;
+    meta?: Record<string, unknown>;
+}
+export declare function formatBody(kind: string, input: FormatInput): string;
+export {};
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAoBD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB,MAAM,CAGR"}

package/dist/formatters.js

@@ -0,0 +1,18 @@
+const FORMATTERS = {
+    insight: ({ body }) => "\n" + body + "\n",
+    decision: ({ title, body }) => {
+        const t = title || body.slice(0, 80);
+        return "\n## Decision\n\n" + t + "\n\n## Rationale\n\n" + body + "\n";
+    },
+    pattern: ({ title, body, meta }) => {
+        const t = title || body.slice(0, 80);
+        const lang = meta?.language || "";
+        return "\n# " + t + "\n\n```" + lang + "\n" + body + "\n```\n";
+    },
+};
+const DEFAULT_FORMATTER = ({ title, body }) => title ? "\n# " + title + "\n\n" + body + "\n" : "\n" + body + "\n";
+export function formatBody(kind, input) {
+    const fn = FORMATTERS[kind] || DEFAULT_FORMATTER;
+    return fn(input);
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,GAAmD;IACjE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI;IAEzC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,mBAAmB,GAAG,CAAC,GAAG,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,GAAI,IAAI,EAAE,QAAmB,IAAI,EAAE,CAAC;QAC9C,OAAO,MAAM,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IACjE,CAAC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAe,EAAU,EAAE,CACjE,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErE,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,KAAkB;IAElB,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC;IACjD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,12 @@
+export declare function formatFrontmatter(meta: Record<string, unknown>): string;
+export declare function parseFrontmatter(text: string): {
+    meta: Record<string, unknown>;
+    body: string;
+};
+export declare function extractCustomMeta(fmMeta: Record<string, unknown>): Record<string, unknown> | null;
+export declare function parseEntryFromMarkdown(kind: string, body: string, fmMeta: Record<string, unknown>): {
+    title: string | null;
+    body: string;
+    meta: Record<string, unknown> | null;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAevE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CAoCA;AAcD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CA6B9E"}

package/dist/frontmatter.js

@@ -0,0 +1,101 @@
+const NEEDS_QUOTING = /[:#'"{}[\],>|&*?!@`]/;
+export function formatFrontmatter(meta) {
+    const lines = ["---"];
+    for (const [k, v] of Object.entries(meta)) {
+        if (v === undefined || v === null)
+            continue;
+        if (Array.isArray(v)) {
+            lines.push(`${k}: [${v.map((i) => JSON.stringify(i)).join(", ")}]`);
+        }
+        else {
+            const str = String(v);
+            lines.push(`${k}: ${NEEDS_QUOTING.test(str) ? JSON.stringify(str) : str}`);
+        }
+    }
+    lines.push("---");
+    return lines.join("\n");
+}
+export function parseFrontmatter(text) {
+    const normalized = text.replace(/\r\n/g, "\n");
+    const match = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, body: normalized.trim() };
+    const meta = {};
+    for (const line of match[1].split("\n")) {
+        const idx = line.indexOf(":");
+        if (idx === -1)
+            continue;
+        const key = line.slice(0, idx).trim();
+        let val = line.slice(idx + 1).trim();
+        if (typeof val === "string" &&
+            val.length >= 2 &&
+            val.startsWith('"') &&
+            val.endsWith('"') &&
+            !val.startsWith('["')) {
+            try {
+                val = JSON.parse(val);
+            }
+            catch {
+                /* keep as-is */
+            }
+        }
+        if (typeof val === "string" && val.startsWith("[") && val.endsWith("]")) {
+            try {
+                val = JSON.parse(val);
+            }
+            catch {
+                val = val
+                    .slice(1, -1)
+                    .split(",")
+                    .map((s) => s.trim().replace(/^"|"$/g, ""));
+            }
+        }
+        meta[key] = val;
+    }
+    return { meta, body: match[2].trim() };
+}
+const RESERVED_FM_KEYS = new Set([
+    "id",
+    "tags",
+    "source",
+    "created",
+    "updated",
+    "identity_key",
+    "expires_at",
+    "supersedes",
+    "related_to",
+]);
+export function extractCustomMeta(fmMeta) {
+    const custom = {};
+    for (const [k, v] of Object.entries(fmMeta)) {
+        if (!RESERVED_FM_KEYS.has(k))
+            custom[k] = v;
+    }
+    return Object.keys(custom).length ? custom : null;
+}
+export function parseEntryFromMarkdown(kind, body, fmMeta) {
+    if (kind === "insight") {
+        return { title: null, body, meta: extractCustomMeta(fmMeta) };
+    }
+    if (kind === "decision") {
+        const titleMatch = body.match(/^## Decision\s*\n+([\s\S]*?)(?=\n## |\n*$)/);
+        const rationaleMatch = body.match(/## Rationale\s*\n+([\s\S]*?)$/);
+        const title = titleMatch ? titleMatch[1].trim() : body.slice(0, 100);
+        const rationale = rationaleMatch ? rationaleMatch[1].trim() : body;
+        return { title, body: rationale, meta: extractCustomMeta(fmMeta) };
+    }
+    if (kind === "pattern") {
+        const titleMatch = body.match(/^# (.+)/);
+        const title = titleMatch ? titleMatch[1].trim() : body.slice(0, 80);
+        const codeMatch = body.match(/```[\w]*\n([\s\S]*?)```/);
+        const content = codeMatch ? codeMatch[1].trim() : body;
+        return { title, body: content, meta: extractCustomMeta(fmMeta) };
+    }
+    const headingMatch = body.match(/^#+ (.+)/);
+    return {
+        title: headingMatch ? headingMatch[1].trim() : null,
+        body,
+        meta: extractCustomMeta(fmMeta),
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { BaseCtx, IndexEntryInput, ReindexStats } from "./types.js";
+export declare function indexEntry(ctx: BaseCtx, entry: IndexEntryInput & {
+    supersedes?: string[] | null;
+    related_to?: string[] | null;
+}): Promise<void>;
+export declare function pruneExpired(ctx: BaseCtx): Promise<number>;
+export declare function reindex(ctx: BaseCtx, opts?: {
+    fullSync?: boolean;
+}): Promise<ReindexStats>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMzE,wBAAsB,UAAU,CAC9B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,GACtF,OAAO,CAAC,IAAI,CAAC,CAuFf;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBhE;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,YAAY,CAAC,CA8NvB"}