oh-my-second-brain 0.2.0 → 0.6.1

package/dist/engine/embed/store.js

@@ -1,416 +0,0 @@
-/**
- * SQLite-backed EngineStore: FTS5 lexical search + sqlite-vec ANN.
- *
- * RALPLAN constraints (approved):
- * - Core schema (meta + FTS + engine_meta) MUST exist even when sqlite-vec is unavailable.
- * - vec/HyDE MUST NOT silently degrade to empty hits; vector usage must fail loudly.
- * - A core-only open path must exist for lex-only operation without embedding config.
- */
-import { mkdirSync } from "node:fs";
-import path from "node:path";
-import Database from "better-sqlite3";
-import * as sqliteVec from "sqlite-vec";
-export const DEFAULT_SQLITE_VEC_LOADER = (db) => sqliteVec.load(db);
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-export const ENGINE_EMBED_META_VERSION = "oms-embed-meta-v1";
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-/** Pack a Float32Array as raw-bytes Buffer for sqlite-vec MATCH queries. */
-function vecBuf(vector) {
-    return Buffer.from(vector.buffer, vector.byteOffset, vector.byteLength);
-}
-/** Simple tokeniser for FTS5 query building — mirrors the legacy search layer. */
-function makeFtsQuery(text) {
-    const terms = text
-        .toLowerCase()
-        .replace(/[^a-z0-9가-힣\s]/g, " ")
-        .split(/\s+/)
-        .filter((t) => t.length >= 2)
-        .slice(0, 32);
-    if (terms.length === 0)
-        return "";
-    return terms.map((t) => `${t.replace(/"/g, "")}*`).join(" OR ");
-}
-function ensureCoreSchema(db) {
-    db.pragma("journal_mode = WAL");
-    // (1) engine_meta — single-row embedding identity metadata
-    // updated_at is initialised at schema creation and updated again only when
-    // writeEmbeddingIdentity() is called.
-    db.exec(`
-    CREATE TABLE IF NOT EXISTS engine_meta (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      embedding_provider TEXT,
-      embedding_model TEXT,
-      embedding_dimensions INTEGER,
-      embedding_fingerprint TEXT,
-      embedding_schema_version TEXT NOT NULL,
-      updated_at TEXT NOT NULL
-    );
-  `);
-    db.prepare("INSERT OR IGNORE INTO engine_meta (id, embedding_schema_version, updated_at) VALUES (1, ?, strftime('%Y-%m-%dT%H:%M:%fZ','now'))").run(ENGINE_EMBED_META_VERSION);
-    // (2) engine_chunk_meta + engine_chunk_fts
-    db.exec(`
-    CREATE TABLE IF NOT EXISTS engine_chunk_meta (
-      rowid  INTEGER PRIMARY KEY AUTOINCREMENT,
-      doc_path TEXT NOT NULL,
-      ordinal  INTEGER NOT NULL,
-      text     TEXT NOT NULL,
-      sha      TEXT NOT NULL,
-      UNIQUE(doc_path, ordinal)
-    );
-
-    CREATE VIRTUAL TABLE IF NOT EXISTS engine_chunk_fts USING fts5(
-      doc_path UNINDEXED,
-      ordinal  UNINDEXED,
-      text
-    );
-  `);
-}
-function vecTableExists(db) {
-    const row = db
-        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='engine_chunk_vec'")
-        .get();
-    return row !== undefined;
-}
-function createVecTable(db, dimensions) {
-    db.exec(`CREATE VIRTUAL TABLE engine_chunk_vec USING vec0(embedding float[${dimensions}]);`);
-}
-// ---------------------------------------------------------------------------
-// Public factories
-// ---------------------------------------------------------------------------
-/**
- * Open (or create) an engine store at `dbPath` in CORE-ONLY mode.
- *
- * Core-only mode:
- * - creates core schema (meta + FTS + engine_meta)
- * - does NOT create vec0
- * - queryVec() throws
- * - upsert() throws
- */
-export function openEngineStoreCore(dbPath) {
-    mkdirSync(path.dirname(dbPath), { recursive: true });
-    const db = new Database(dbPath);
-    ensureCoreSchema(db);
-    // Optional: load sqlite-vec so lex-only sync can delete stale vectors for
-    // modified chunks (prevents silent cross-model reuse on later vec queries).
-    let stmtDeleteVec = null;
-    let stmtClearDocVec = null;
-    try {
-        DEFAULT_SQLITE_VEC_LOADER(db);
-        if (vecTableExists(db)) {
-            stmtDeleteVec = db.prepare("DELETE FROM engine_chunk_vec WHERE rowid = ?");
-            stmtClearDocVec = db.prepare("DELETE FROM engine_chunk_vec WHERE rowid IN (SELECT rowid FROM engine_chunk_meta WHERE doc_path = ?)");
-        }
-    }
-    catch {
-        // sqlite-vec unavailable or vec table absent — core-only mode still works.
-    }
-    // Prepared statements — core only
-    const stmtGetMeta = db.prepare("SELECT rowid, doc_path, ordinal, text, sha FROM engine_chunk_meta WHERE doc_path = ? AND ordinal = ?");
-    const stmtInsertMeta = db.prepare("INSERT INTO engine_chunk_meta (doc_path, ordinal, text, sha) VALUES (?, ?, ?, ?)");
-    const stmtUpdateMeta = db.prepare("UPDATE engine_chunk_meta SET text = ?, sha = ? WHERE doc_path = ? AND ordinal = ?");
-    const stmtDeleteFts = db.prepare("DELETE FROM engine_chunk_fts WHERE rowid = ?");
-    const stmtInsertFts = db.prepare("INSERT INTO engine_chunk_fts(rowid, doc_path, ordinal, text) VALUES (?, ?, ?, ?)");
-    const stmtQueryLex = db.prepare(`SELECT m.doc_path, m.ordinal, bm25(engine_chunk_fts) AS rank
-     FROM engine_chunk_fts
-     JOIN engine_chunk_meta m ON m.rowid = engine_chunk_fts.rowid
-     WHERE engine_chunk_fts MATCH ?
-     ORDER BY rank
-     LIMIT ?`);
-    const stmtGetShas = db.prepare("SELECT ordinal, sha FROM engine_chunk_meta WHERE doc_path = ?");
-    const stmtClearDocFts = db.prepare("DELETE FROM engine_chunk_fts WHERE rowid IN (SELECT rowid FROM engine_chunk_meta WHERE doc_path = ?)");
-    const stmtClearDocMeta = db.prepare("DELETE FROM engine_chunk_meta WHERE doc_path = ?");
-    const stmtListDocPaths = db.prepare("SELECT DISTINCT doc_path FROM engine_chunk_meta");
-    const stmtReadIdentity = db.prepare("SELECT embedding_provider, embedding_model, embedding_dimensions, embedding_fingerprint FROM engine_meta WHERE id = 1");
-    const stmtWriteIdentity = db.prepare("UPDATE engine_meta SET embedding_provider = ?, embedding_model = ?, embedding_dimensions = ?, embedding_fingerprint = ?, updated_at = strftime('%Y-%m-%dT%H:%M:%fZ','now') WHERE id = 1");
-    const doUpsertLex = db.transaction((rows) => {
-        for (const row of rows) {
-            const existing = stmtGetMeta.get(row.docPath, row.ordinal);
-            if (existing) {
-                const id = BigInt(existing.rowid);
-                stmtDeleteVec?.run(id);
-                stmtDeleteFts.run(id);
-                stmtUpdateMeta.run(row.text, row.sha, row.docPath, row.ordinal);
-                stmtInsertFts.run(id, row.docPath, row.ordinal, row.text);
-            }
-            else {
-                const info = stmtInsertMeta.run(row.docPath, row.ordinal, row.text, row.sha);
-                const id = BigInt(info.lastInsertRowid);
-                stmtInsertFts.run(id, row.docPath, row.ordinal, row.text);
-            }
-        }
-    });
-    const doClearDocument = db.transaction((docPath) => {
-        stmtClearDocVec?.run(docPath);
-        stmtClearDocFts.run(docPath);
-        stmtClearDocMeta.run(docPath);
-    });
-    return {
-        capabilities() {
-            return { vecAvailable: false };
-        },
-        upsertLex(rows) {
-            doUpsertLex(rows);
-        },
-        // VectorStore
-        upsert() {
-            throw new Error("EngineStore(core-only): vector upsert is unavailable.");
-        },
-        queryVec() {
-            throw new Error("EngineStore(core-only): vector queries are unavailable.");
-        },
-        queryLex(text, k) {
-            const ftsQ = makeFtsQuery(text);
-            if (!ftsQ)
-                return [];
-            let rows;
-            try {
-                rows = stmtQueryLex.all(ftsQ, k);
-            }
-            catch {
-                return [];
-            }
-            return rows.map((r, index) => ({
-                docPath: r.doc_path,
-                chunkOrdinal: r.ordinal,
-                score: 1 / (1 + index),
-            }));
-        },
-        close() {
-            db.pragma("wal_checkpoint(PASSIVE)");
-            db.close();
-        },
-        // EngineStore extensions
-        readEmbeddingIdentity() {
-            const row = stmtReadIdentity.get();
-            if (!row)
-                return null;
-            if (!row.embedding_provider ||
-                !row.embedding_model ||
-                row.embedding_dimensions === null ||
-                !row.embedding_fingerprint) {
-                return null;
-            }
-            return {
-                provider: row.embedding_provider,
-                model: row.embedding_model,
-                dimensions: row.embedding_dimensions,
-                fingerprint: row.embedding_fingerprint,
-            };
-        },
-        writeEmbeddingIdentity(identity) {
-            stmtWriteIdentity.run(identity.provider, identity.model, identity.dimensions, identity.fingerprint);
-        },
-        getShas(docPath) {
-            const rows = stmtGetShas.all(docPath);
-            const out = new Map();
-            for (const r of rows)
-                out.set(r.ordinal, r.sha);
-            return out;
-        },
-        clearDocument(docPath) {
-            doClearDocument(docPath);
-        },
-        listDocPaths() {
-            return stmtListDocPaths.all().map((r) => r.doc_path);
-        },
-    };
-}
-/**
- * Open (or create) an engine store at `dbPath` with vector capability.
- *
- * Vector-capable mode still guarantees core schema exists even when sqlite-vec
- * cannot be loaded, but in that case vecAvailable=false and vector operations
- * throw.
- */
-export function openEngineStore(dbPath, dimensions, opts = {}) {
-    mkdirSync(path.dirname(dbPath), { recursive: true });
-    const db = new Database(dbPath);
-    ensureCoreSchema(db);
-    const sqliteVecLoader = opts.sqliteVecLoader ?? DEFAULT_SQLITE_VEC_LOADER;
-    let vecLoaded = false;
-    try {
-        sqliteVecLoader(db);
-        vecLoaded = true;
-    }
-    catch {
-        vecLoaded = false;
-    }
-    // Create vec table only when the extension is loaded.
-    let vecAvailable = false;
-    if (vecLoaded) {
-        if (!vecTableExists(db)) {
-            try {
-                createVecTable(db, dimensions);
-                vecAvailable = true;
-            }
-            catch {
-                vecAvailable = false;
-            }
-        }
-        else {
-            vecAvailable = true;
-        }
-    }
-    // Prepared statements (core)
-    const stmtGetMeta = db.prepare("SELECT rowid, doc_path, ordinal, text, sha FROM engine_chunk_meta WHERE doc_path = ? AND ordinal = ?");
-    const stmtInsertMeta = db.prepare("INSERT INTO engine_chunk_meta (doc_path, ordinal, text, sha) VALUES (?, ?, ?, ?)");
-    const stmtUpdateMeta = db.prepare("UPDATE engine_chunk_meta SET text = ?, sha = ? WHERE doc_path = ? AND ordinal = ?");
-    const stmtDeleteFts = db.prepare("DELETE FROM engine_chunk_fts WHERE rowid = ?");
-    const stmtInsertFts = db.prepare("INSERT INTO engine_chunk_fts(rowid, doc_path, ordinal, text) VALUES (?, ?, ?, ?)");
-    const stmtQueryLex = db.prepare(`SELECT m.doc_path, m.ordinal, bm25(engine_chunk_fts) AS rank
-     FROM engine_chunk_fts
-     JOIN engine_chunk_meta m ON m.rowid = engine_chunk_fts.rowid
-     WHERE engine_chunk_fts MATCH ?
-     ORDER BY rank
-     LIMIT ?`);
-    const stmtGetShas = db.prepare("SELECT ordinal, sha FROM engine_chunk_meta WHERE doc_path = ?");
-    const stmtClearDocFts = db.prepare("DELETE FROM engine_chunk_fts WHERE rowid IN (SELECT rowid FROM engine_chunk_meta WHERE doc_path = ?)");
-    const stmtClearDocMeta = db.prepare("DELETE FROM engine_chunk_meta WHERE doc_path = ?");
-    const stmtListDocPaths = db.prepare("SELECT DISTINCT doc_path FROM engine_chunk_meta");
-    const stmtReadIdentity = db.prepare("SELECT embedding_provider, embedding_model, embedding_dimensions, embedding_fingerprint FROM engine_meta WHERE id = 1");
-    const stmtWriteIdentity = db.prepare("UPDATE engine_meta SET embedding_provider = ?, embedding_model = ?, embedding_dimensions = ?, embedding_fingerprint = ?, updated_at = strftime('%Y-%m-%dT%H:%M:%fZ','now') WHERE id = 1");
-    // Prepared statements (vec)
-    const stmtDeleteVec = vecAvailable
-        ? db.prepare("DELETE FROM engine_chunk_vec WHERE rowid = ?")
-        : null;
-    const stmtInsertVec = vecAvailable
-        ? db.prepare("INSERT INTO engine_chunk_vec(rowid, embedding) VALUES (?, ?)")
-        : null;
-    const stmtQueryVec = vecAvailable
-        ? db.prepare(`SELECT m.doc_path, m.ordinal, v.distance
-         FROM engine_chunk_vec v
-         JOIN engine_chunk_meta m ON m.rowid = v.rowid
-         WHERE v.embedding MATCH ? AND k = ?
-         ORDER BY v.distance`)
-        : null;
-    const stmtClearDocVec = vecAvailable
-        ? db.prepare("DELETE FROM engine_chunk_vec WHERE rowid IN (SELECT rowid FROM engine_chunk_meta WHERE doc_path = ?)")
-        : null;
-    const doClearDocument = db.transaction((docPath) => {
-        stmtClearDocVec?.run(docPath);
-        stmtClearDocFts.run(docPath);
-        stmtClearDocMeta.run(docPath);
-    });
-    const doUpsertLex = db.transaction((rows) => {
-        for (const row of rows) {
-            const existing = stmtGetMeta.get(row.docPath, row.ordinal);
-            if (existing) {
-                const id = BigInt(existing.rowid);
-                stmtDeleteFts.run(id);
-                stmtUpdateMeta.run(row.text, row.sha, row.docPath, row.ordinal);
-                stmtInsertFts.run(id, row.docPath, row.ordinal, row.text);
-            }
-            else {
-                const info = stmtInsertMeta.run(row.docPath, row.ordinal, row.text, row.sha);
-                const id = BigInt(info.lastInsertRowid);
-                stmtInsertFts.run(id, row.docPath, row.ordinal, row.text);
-            }
-        }
-    });
-    const doUpsert = db.transaction((rows) => {
-        if (!vecAvailable || !stmtInsertVec || !stmtDeleteVec) {
-            throw new Error("EngineStore: vector layer unavailable (sqlite-vec not loaded).");
-        }
-        for (const row of rows) {
-            const existing = stmtGetMeta.get(row.docPath, row.ordinal);
-            if (existing) {
-                const id = BigInt(existing.rowid);
-                stmtDeleteVec.run(id);
-                stmtDeleteFts.run(id);
-                stmtUpdateMeta.run(row.text, row.sha, row.docPath, row.ordinal);
-                stmtInsertVec.run(id, vecBuf(row.vector));
-                stmtInsertFts.run(id, row.docPath, row.ordinal, row.text);
-            }
-            else {
-                const info = stmtInsertMeta.run(row.docPath, row.ordinal, row.text, row.sha);
-                const id = BigInt(info.lastInsertRowid);
-                stmtInsertVec.run(id, vecBuf(row.vector));
-                stmtInsertFts.run(id, row.docPath, row.ordinal, row.text);
-            }
-        }
-    });
-    return {
-        capabilities() {
-            return { vecAvailable };
-        },
-        upsertLex(rows) {
-            doUpsertLex(rows);
-        },
-        readEmbeddingIdentity() {
-            const row = stmtReadIdentity.get();
-            if (!row)
-                return null;
-            if (!row.embedding_provider ||
-                !row.embedding_model ||
-                row.embedding_dimensions === null ||
-                !row.embedding_fingerprint) {
-                return null;
-            }
-            return {
-                provider: row.embedding_provider,
-                model: row.embedding_model,
-                dimensions: row.embedding_dimensions,
-                fingerprint: row.embedding_fingerprint,
-            };
-        },
-        writeEmbeddingIdentity(identity) {
-            stmtWriteIdentity.run(identity.provider, identity.model, identity.dimensions, identity.fingerprint);
-        },
-        // VectorStore
-        upsert(rows) {
-            doUpsert(rows);
-        },
-        queryVec(vec, k) {
-            if (!stmtQueryVec) {
-                throw new Error("EngineStore: vector queries are unavailable (sqlite-vec not loaded).");
-            }
-            const buf = vecBuf(vec);
-            const rows = stmtQueryVec.all(buf, k);
-            return rows.map((r) => ({
-                docPath: r.doc_path,
-                chunkOrdinal: r.ordinal,
-                score: 1 / (1 + Math.max(0, r.distance)),
-            }));
-        },
-        queryLex(text, k) {
-            const ftsQ = makeFtsQuery(text);
-            if (!ftsQ)
-                return [];
-            let rows;
-            try {
-                rows = stmtQueryLex.all(ftsQ, k);
-            }
-            catch {
-                return [];
-            }
-            return rows.map((r, index) => ({
-                docPath: r.doc_path,
-                chunkOrdinal: r.ordinal,
-                score: 1 / (1 + index),
-            }));
-        },
-        close() {
-            db.pragma("wal_checkpoint(PASSIVE)");
-            db.close();
-        },
-        // EngineStore extensions
-        getShas(docPath) {
-            const rows = stmtGetShas.all(docPath);
-            const out = new Map();
-            for (const r of rows)
-                out.set(r.ordinal, r.sha);
-            return out;
-        },
-        clearDocument(docPath) {
-            doClearDocument(docPath);
-        },
-        listDocPaths() {
-            return stmtListDocPaths.all().map((r) => r.doc_path);
-        },
-    };
-}
-//# sourceMappingURL=store.js.map

package/dist/engine/embed/store.js.map

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

package/dist/engine/embed/sync.d.ts

@@ -1,45 +0,0 @@
-/**
- * Vault → engine store synchronisation.
- *
- * RALPLAN constraints (approved):
- * - vec/HyDE require sqlite-vec + real embeddings; no fake/hash fallback.
- * - embed=false is a lex-only sync: it MUST NOT fabricate vectors.
- * - Fingerprint mismatch fails fast by default; destructive rebuild only with explicit force.
- */
-import type { ChunkerOptions } from "../types.js";
-import type { EmbeddingIdentity } from "./store.js";
-export interface EngineSyncOptions {
-    /** Absolute path to the vault root (OMS_VAULT). */
-    vault: string;
-    /** Logical collection name stored in the index (default: "vault"). */
-    collection?: string;
-    /** Vault-relative sub-path to sync (default: entire vault). */
-    collectionPath?: string;
-    /** Absolute path to the SQLite engine store database file. Default: <vault>/.oms/engine-store.sqlite */
-    dbPath?: string;
-    /** When false, updates lexical index only (no vectors). Default: true. */
-    embed?: boolean;
-    /** Allow destructive rebuild when embedding identity mismatches. Default: false. */
-    force?: boolean;
-    /** Explicit embedding provider id (OMS_EMBEDDING_PROVIDER). */
-    embeddingProvider?: string;
-    /** Explicit embedding model/id/path (OMS_EMBEDDING_MODEL). */
-    embeddingModel?: string;
-    /** Chunker overrides (maxTokens, overlapRatio). */
-    chunkerOpts?: Partial<ChunkerOptions>;
-}
-export interface EngineSyncResult {
-    available: boolean;
-    reason?: string;
-    warnings?: string[];
-    collection: string;
-    dbPath: string;
-    scanned: number;
-    added: number;
-    updated: number;
-    skipped: number;
-    storedIdentity?: EmbeddingIdentity;
-    configuredIdentity?: EmbeddingIdentity;
-}
-export declare function walkMarkdown(dir: string, base: string): AsyncGenerator<string>;
-export declare function syncEngineStore(opts: EngineSyncOptions): Promise<EngineSyncResult>;