@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/staleness/git-staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-staleness.d.ts","sourceRoot":"","sources":["../../../src/staleness/git-staleness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAkDjF"}

package/dist/src/staleness/git-staleness.js

@@ -0,0 +1,46 @@
+import { execSync } from 'child_process';
+export function checkStaleness(db, repoPath) {
+    // 1. Get stored commit hash
+    const row = db.prepare("SELECT value FROM index_meta WHERE key = 'last_commit_hash'").get();
+    const indexedCommitFull = row?.value ?? null;
+    // 2. Get current HEAD (full SHA — --short output length varies by repo size)
+    let currentCommit = null;
+    try {
+        currentCommit = execSync('git rev-parse HEAD', { cwd: repoPath, encoding: 'utf8' }).trim();
+    }
+    catch {
+        // Not a git repo or git not available
+        return { isStale: false, indexedAt: null, indexedCommit: null, currentCommit: null, changedSince: [], staleSince: null };
+    }
+    // Display short SHA (7 chars) for the interface field; compare full SHAs for correctness
+    const indexedCommitShort = indexedCommitFull ? indexedCommitFull.slice(0, 7) : null;
+    const currentCommitShort = currentCommit ? currentCommit.slice(0, 7) : null;
+    // 3. If no stored commit or full SHAs match, not stale
+    if (!indexedCommitFull || indexedCommitFull === currentCommit) {
+        return { isStale: false, indexedAt: null, indexedCommit: indexedCommitShort, currentCommit: currentCommitShort, changedSince: [], staleSince: null };
+    }
+    // Guard: indexedCommitFull is read from SQLite — validate before shell interpolation
+    if (!/^[0-9a-f]{7,40}$/i.test(indexedCommitFull)) {
+        return { isStale: true, indexedAt: null, indexedCommit: indexedCommitShort, currentCommit: currentCommitShort, changedSince: [], staleSince: null };
+    }
+    // 4. Get changed files between indexed commit and HEAD
+    let changedSince = [];
+    try {
+        const diff = execSync(`git diff --name-only ${indexedCommitFull}..HEAD`, { cwd: repoPath, encoding: 'utf8' });
+        changedSince = diff.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        changedSince = [];
+    }
+    // 5. Get staleSince timestamp (first diverging commit after indexed commit)
+    let staleSince = null;
+    try {
+        const firstCommit = execSync(`git log --format="%ai" ${indexedCommitFull}..HEAD --reverse --max-count=1`, { cwd: repoPath, encoding: 'utf8' }).trim();
+        staleSince = firstCommit || null;
+    }
+    catch {
+        staleSince = null;
+    }
+    return { isStale: true, indexedAt: null, indexedCommit: indexedCommitShort, currentCommit: currentCommitShort, changedSince, staleSince };
+}
+//# sourceMappingURL=git-staleness.js.map

package/dist/src/staleness/git-staleness.js.map

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

package/dist/src/storage/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAStC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAE5C,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAWlD;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAE7C;AAYD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CActF"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAUtC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAE5C,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAWlD;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAE7C;AAcD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CActF"}

package/dist/src/storage/db.js

@@ -1,7 +1,7 @@
 import Database from 'better-sqlite3';
 import { mkdirSync, existsSync, renameSync, unlinkSync } from 'fs';
 import { dirname } from 'path';
-import { CREATE_NODES, CREATE_EDGES, CREATE_COMMUNITIES, CREATE_INDEX_META, CREATE_NODES_FTS, CREATE_INDEXES, FTS_SYNC_TRIGGERS, } from './schema.js';
+import { CREATE_NODES, CREATE_EDGES, CREATE_COMMUNITIES, CREATE_INDEX_META, CREATE_NODES_FTS, CREATE_INDEXES, FTS_SYNC_TRIGGERS, CREATE_EMBEDDINGS, CREATE_WIKI_PAGES, } from './schema.js';
 import { MonographError } from '../types.js';
 export function openDb(dbPath) {
     try {
@@ -28,6 +28,8 @@ function applyMigrations(db) {
     for (const idx of CREATE_INDEXES)
         db.exec(idx);
     db.exec(FTS_SYNC_TRIGGERS);
+    db.exec(CREATE_EMBEDDINGS);
+    db.exec(CREATE_WIKI_PAGES);
 }
 /** Write to a .tmp file then rename for atomic replacement. */
 export function atomicRebuild(dbPath, buildFn) {

package/dist/src/storage/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAC9C,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,GACvE,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/B,eAAe,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CAAC,8BAA8B,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAe;IACrC,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,EAAe;IACtC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtB,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtB,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5B,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,cAAc;QAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC7B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAkC;IAC9E,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAC9C,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EACtE,iBAAiB,EAAE,iBAAiB,GACrC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/B,eAAe,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CAAC,8BAA8B,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAe;IACrC,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,EAAe;IACtC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtB,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtB,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5B,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,cAAc;QAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC7B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAkC;IAC9E,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/src/storage/edge-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-store.d.ts","sourceRoot":"","sources":["../../../src/storage/edge-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAY3E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAO/E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAK1F;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAK1F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"edge-store.d.ts","sourceRoot":"","sources":["../../../src/storage/edge-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAc3E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAO/E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAK1F;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAK1F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAGxD"}

package/dist/src/storage/edge-store.js

@@ -1,8 +1,8 @@
 export function insertEdge(db, edge) {
     db.prepare(`
-    INSERT OR REPLACE INTO edges (id, source_id, target_id, relation, confidence, confidence_score)
-    VALUES (?, ?, ?, ?, ?, ?)
-  `).run(edge.id, edge.sourceId, edge.targetId, edge.relation, edge.confidence, edge.confidenceScore);
+    INSERT OR REPLACE INTO edges (id, source_id, target_id, relation, confidence, confidence_score, reason, evidence)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(edge.id, edge.sourceId, edge.targetId, edge.relation, edge.confidence, edge.confidenceScore, edge.reason ?? null, edge.evidence != null ? JSON.stringify(edge.evidence) : null);
 }
 export function insertEdges(db, edges) {
     const insertMany = db.transaction((rows) => {
@@ -41,6 +41,8 @@ function rowToEdge(row) {
         relation: row.relation,
         confidence: row.confidence,
         confidenceScore: row.confidence_score,
+        reason: row.reason,
+        evidence: row.evidence ? JSON.parse(row.evidence) : undefined,
     };
 }
 //# sourceMappingURL=edge-store.js.map

package/dist/src/storage/edge-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"edge-store.js","sourceRoot":"","sources":["../../../src/storage/edge-store.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,IAAmB;IACnE,EAAE,CAAC,OAAO,CAAC;;;GAGV,CAAC,CAAC,GAAG,CACJ,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAqB,EAAE,KAAsB;IACvE,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,IAAqB,EAAE,EAAE;QAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,QAAgB;IACvE,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,yCAAyC,CAAC;SAClD,GAAG,CAAC,QAAQ,CAA8B,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,QAAgB;IACvE,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,yCAAyC,CAAC;SAClD,GAAG,CAAC,QAAQ,CAA8B,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAqB,EAAE,QAAgB;IACxE,EAAE,CAAC,OAAO,CAAC;;GAEV,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAqB;IAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAAmB,CAAC;IACjF,OAAO,GAAG,CAAC,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAA4B;IAC7C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,QAAQ,EAAE,GAAG,CAAC,SAAmB;QACjC,QAAQ,EAAE,GAAG,CAAC,SAAmB;QACjC,QAAQ,EAAE,GAAG,CAAC,QAAqC;QACnD,UAAU,EAAE,GAAG,CAAC,UAAyC;QACzD,eAAe,EAAE,GAAG,CAAC,gBAA0B;KAChD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"edge-store.js","sourceRoot":"","sources":["../../../src/storage/edge-store.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,IAAmB;IACnE,EAAE,CAAC,OAAO,CAAC;;;GAGV,CAAC,CAAC,GAAG,CACJ,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,MAAM,IAAI,IAAI,EACnB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAqB,EAAE,KAAsB;IACvE,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,IAAqB,EAAE,EAAE;QAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,QAAgB;IACvE,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,yCAAyC,CAAC;SAClD,GAAG,CAAC,QAAQ,CAA8B,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,QAAgB;IACvE,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,yCAAyC,CAAC;SAClD,GAAG,CAAC,QAAQ,CAA8B,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAqB,EAAE,QAAgB;IACxE,EAAE,CAAC,OAAO,CAAC;;GAEV,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAqB;IAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAAmB,CAAC;IACjF,OAAO,GAAG,CAAC,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAA4B;IAC7C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,QAAQ,EAAE,GAAG,CAAC,SAAmB;QACjC,QAAQ,EAAE,GAAG,CAAC,SAAmB;QACjC,QAAQ,EAAE,GAAG,CAAC,QAAqC;QACnD,UAAU,EAAE,GAAG,CAAC,UAAyC;QACzD,eAAe,EAAE,GAAG,CAAC,gBAA0B;QAC/C,MAAM,EAAE,GAAG,CAAC,MAA4B;QACxC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAkB,CAAoB,CAAC,CAAC,CAAC,SAAS;KAC3F,CAAC;AACJ,CAAC"}

package/dist/src/storage/embedding-store.d.ts

@@ -0,0 +1,13 @@
+import type Database from 'better-sqlite3';
+/**
+ * CRUD operations for the embeddings table.
+ *
+ * Vectors are stored as BLOBs (raw Float32Array bytes) and reconstructed on read.
+ */
+export declare function upsertEmbedding(db: Database.Database, nodeId: string, vector: Float32Array, contentHash?: string): void;
+export declare function getEmbeddingContentHash(db: Database.Database, nodeId: string): string | null;
+export declare function isEmbeddingStale(db: Database.Database, nodeId: string, currentHash: string): boolean;
+export declare function getEmbedding(db: Database.Database, nodeId: string): Float32Array | null;
+export declare function getAllEmbeddings(db: Database.Database): Map<string, Float32Array>;
+export declare function countEmbeddings(db: Database.Database): number;
+//# sourceMappingURL=embedding-store.d.ts.map

package/dist/src/storage/embedding-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-store.d.ts","sourceRoot":"","sources":["../../../src/storage/embedding-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;;;GAIG;AAEH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAaN;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5F;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAGT;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMvF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAUjF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAG7D"}

package/dist/src/storage/embedding-store.js

@@ -0,0 +1,53 @@
+/**
+ * CRUD operations for the embeddings table.
+ *
+ * Vectors are stored as BLOBs (raw Float32Array bytes) and reconstructed on read.
+ */
+export function upsertEmbedding(db, nodeId, vector, contentHash) {
+    // Migrate existing DBs that may not have the content_hash column yet.
+    try {
+        db.exec('ALTER TABLE embeddings ADD COLUMN content_hash TEXT');
+    }
+    catch {
+        // Column already exists — ignore.
+    }
+    const buf = Buffer.from(vector.buffer, vector.byteOffset, vector.byteLength);
+    db
+        .prepare('INSERT OR REPLACE INTO embeddings (node_id, vector, content_hash) VALUES (?, ?, ?)')
+        .run(nodeId, buf, contentHash ?? null);
+}
+export function getEmbeddingContentHash(db, nodeId) {
+    const row = db
+        .prepare('SELECT content_hash FROM embeddings WHERE node_id = ?')
+        .get(nodeId);
+    return row?.content_hash ?? null;
+}
+export function isEmbeddingStale(db, nodeId, currentHash) {
+    const stored = getEmbeddingContentHash(db, nodeId);
+    return stored !== currentHash;
+}
+export function getEmbedding(db, nodeId) {
+    const row = db.prepare('SELECT vector FROM embeddings WHERE node_id = ?').get(nodeId);
+    if (!row)
+        return null;
+    return bufToFloat32(row.vector);
+}
+export function getAllEmbeddings(db) {
+    const rows = db.prepare('SELECT node_id, vector FROM embeddings').all();
+    const result = new Map();
+    for (const row of rows) {
+        result.set(row.node_id, bufToFloat32(row.vector));
+    }
+    return result;
+}
+export function countEmbeddings(db) {
+    const row = db.prepare('SELECT COUNT(*) AS n FROM embeddings').get();
+    return row.n;
+}
+// ── Internal helpers ──────────────────────────────────────────────────────────
+function bufToFloat32(buf) {
+    // Copy to a fresh ArrayBuffer so slice offset doesn't cause issues
+    const ab = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+    return new Float32Array(ab);
+}
+//# sourceMappingURL=embedding-store.js.map

package/dist/src/storage/embedding-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-store.js","sourceRoot":"","sources":["../../../src/storage/embedding-store.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,MAAc,EACd,MAAoB,EACpB,WAAoB;IAEpB,sEAAsE;IACtE,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7E,EAAE;SACC,OAAO,CACN,oFAAoF,CACrF;SACA,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,EAAqB,EAAE,MAAc;IAC3E,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,uDAAuD,CAAC;SAChE,GAAG,CAAC,MAAM,CAAgD,CAAC;IAC9D,OAAO,GAAG,EAAE,YAAY,IAAI,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,EAAqB,EACrB,MAAc,EACd,WAAmB;IAEnB,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,MAAM,KAAK,WAAW,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAqB,EAAE,MAAc;IAChE,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,CAAC,MAAM,CAEvE,CAAC;IACd,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAqB;IACpD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,EAGlE,CAAC;IACJ,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAqB;IACnD,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAAmB,CAAC;IACtF,OAAO,GAAG,CAAC,CAAC,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF,SAAS,YAAY,CAAC,GAAW;IAC/B,mEAAmE;IACnE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7E,OAAO,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/src/storage/file-cache.d.ts

@@ -0,0 +1,18 @@
+import type { MonographDb } from './db.js';
+export interface FileCacheEntry {
+    filePath: string;
+    contentHash: string;
+    lastParsed: number;
+    nodeCount: number;
+    edgeCount: number;
+}
+export declare function hashFileContent(content: string): string;
+export declare function isFileCached(db: MonographDb, filePath: string, contentHash: string): boolean;
+export declare function updateFileCache(db: MonographDb, entry: FileCacheEntry): void;
+export declare function getFileCacheStats(db: MonographDb): {
+    totalCached: number;
+    hitRate: number;
+    stalePaths: string[];
+};
+export declare function clearFileCache(db: MonographDb): void;
+//# sourceMappingURL=file-cache.d.ts.map

package/dist/src/storage/file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../src/storage/file-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAK5F;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAK5E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CA0BA;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAEpD"}

package/dist/src/storage/file-cache.js

@@ -0,0 +1,30 @@
+import { createHash } from 'crypto';
+export function hashFileContent(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+export function isFileCached(db, filePath, contentHash) {
+    const row = db.prepare('SELECT content_hash FROM file_cache WHERE file_path = ?').get(filePath);
+    return row?.content_hash === contentHash;
+}
+export function updateFileCache(db, entry) {
+    db.prepare(`
+    INSERT OR REPLACE INTO file_cache (file_path, content_hash, last_parsed, node_count, edge_count)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(entry.filePath, entry.contentHash, entry.lastParsed, entry.nodeCount, entry.edgeCount);
+}
+export function getFileCacheStats(db) {
+    const totalCached = db.prepare('SELECT COUNT(*) as c FROM file_cache').get().c;
+    const totalNodes = db.prepare("SELECT COUNT(DISTINCT file_path) as c FROM nodes WHERE file_path IS NOT NULL").get().c;
+    const hitRate = totalNodes > 0 ? totalCached / totalNodes : 0;
+    // Find stale paths: cached entries whose file no longer exists in nodes table
+    const cachedPaths = db.prepare('SELECT file_path, content_hash FROM file_cache').all();
+    const indexedPaths = new Set(db.prepare("SELECT DISTINCT file_path FROM nodes WHERE file_path IS NOT NULL").all().map(r => r.file_path));
+    const stalePaths = cachedPaths
+        .filter(r => !indexedPaths.has(r.file_path))
+        .map(r => r.file_path);
+    return { totalCached, hitRate, stalePaths };
+}
+export function clearFileCache(db) {
+    db.prepare('DELETE FROM file_cache').run();
+}
+//# sourceMappingURL=file-cache.js.map

package/dist/src/storage/file-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.js","sourceRoot":"","sources":["../../../src/storage/file-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAWpC,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAe,EAAE,QAAgB,EAAE,WAAmB;IACjF,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CACpB,yDAAyD,CAC1D,CAAC,GAAG,CAAC,QAAQ,CAAyC,CAAC;IACxD,OAAO,GAAG,EAAE,YAAY,KAAK,WAAW,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAe,EAAE,KAAqB;IACpE,EAAE,CAAC,OAAO,CAAC;;;GAGV,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAe;IAK/C,MAAM,WAAW,GAAI,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IAElG,MAAM,UAAU,GAAI,EAAE,CAAC,OAAO,CAC5B,8EAA8E,CAC/E,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IAE5B,MAAM,OAAO,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,8EAA8E;IAC9E,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,EAGjF,CAAC;IAEJ,MAAM,YAAY,GAAG,IAAI,GAAG,CACzB,EAAE,CAAC,OAAO,CAAC,kEAAkE,CAAC,CAAC,GAAG,EAE/E,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAC3B,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAe;IAC5C,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,GAAG,EAAE,CAAC;AAC7C,CAAC"}

package/dist/src/storage/fts-store.d.ts

@@ -8,4 +8,18 @@ export interface FtsResult {
     rank: number;
 }
 export declare function ftsSearch(db: Database.Database, query: string, limit: number, label?: string): FtsResult[];
+export interface HybridSearchResult extends FtsResult {
+    combinedScore: number;
+    matchStrategy: 'fts' | 'like' | 'fuzzy';
+}
+/**
+ * Hybrid search combining three strategies:
+ *  1. FTS5 (trigram) BM25 match via `ftsSearch`
+ *  2. LIKE fallback for short queries (≤3 chars) or when FTS returns 0 results
+ *  3. In-memory fuzzy character-sequence scoring applied to all candidates
+ *
+ * Results are deduped by id (highest combinedScore wins), re-ranked, and
+ * trimmed to `limit`. The existing `ftsSearch` is left unchanged.
+ */
+export declare function hybridSearch(db: Database.Database, query: string, limit: number, label?: string): HybridSearchResult[];
 //# sourceMappingURL=fts-store.d.ts.map

package/dist/src/storage/fts-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fts-store.d.ts","sourceRoot":"","sources":["../../../src/storage/fts-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,EAAE,CAmCb"}
+{"version":3,"file":"fts-store.d.ts","sourceRoot":"","sources":["../../../src/storage/fts-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,EAAE,CA4Eb;AAID,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;CACzC;AAyCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,kBAAkB,EAAE,CAqEtB"}

package/dist/src/storage/fts-store.js

@@ -1,26 +1,61 @@
 export function ftsSearch(db, query, limit, label) {
-    // Clean and sanitize the query for FTS5
-    const safeQuery = query.replace(/['"*]/g, ' ').trim();
+    // Sanitize: strip only characters that break FTS5 MATCH syntax (* still stripped,
+    // trigram handles substring natively; " is now preserved since trigram doesn't need it removed)
+    const safeQuery = query.replace(/[*]/g, ' ').trim();
     if (!safeQuery)
         return [];
-    // Add wildcard for prefix matching
-    const ftsPrefixQuery = safeQuery.split(/\s+/).map((term) => term + '*').join(' ');
-    let sql = `
+    // Trigram handles substring matching natively — no need to append * to each term
+    const ftsQuery = safeQuery.split(/\s+/).join(' ');
+    let matchSql = `
     SELECT n.id, n.name, n.norm_label, n.file_path, n.label,
            nodes_fts.rank
     FROM nodes_fts
     JOIN nodes n ON n.rowid = nodes_fts.rowid
     WHERE nodes_fts MATCH ?
   `;
-    const params = [ftsPrefixQuery];
+    const matchParams = [ftsQuery];
     if (label) {
-        sql += ' AND n.label = ?';
-        params.push(label);
+        matchSql += ' AND n.label = ?';
+        matchParams.push(label);
     }
-    sql += ' ORDER BY nodes_fts.rank LIMIT ?';
-    params.push(limit);
-    const rows = db.prepare(sql).all(...params);
-    return rows.map((r) => ({
+    matchSql += ' ORDER BY nodes_fts.rank LIMIT ?';
+    matchParams.push(limit);
+    let matchRows = [];
+    try {
+        matchRows = db.prepare(matchSql).all(...matchParams);
+    }
+    catch {
+        // FTS MATCH can throw on malformed queries; fall through to LIKE path
+    }
+    // For short queries (≤2 chars) trigram requires at least 3 characters to fire, so
+    // supplement with a LIKE fallback to catch single/double-character matches.
+    if (safeQuery.length <= 2) {
+        const escapedQuery = safeQuery.replace(/%/g, '\\%').replace(/_/g, '\\_');
+        const likePattern = `%${escapedQuery}%`;
+        let likeSql = `
+      SELECT n.id, n.name, n.norm_label, n.file_path, n.label,
+             0 AS rank
+      FROM nodes n
+      WHERE (n.name LIKE ? OR n.norm_label LIKE ? OR n.file_path LIKE ?)
+    `;
+        const likeParams = [likePattern, likePattern, likePattern];
+        if (label) {
+            likeSql += ' AND n.label = ?';
+            likeParams.push(label);
+        }
+        likeSql += ' LIMIT ?';
+        likeParams.push(limit);
+        const likeRows = db.prepare(likeSql).all(...likeParams);
+        // Merge: MATCH results first, append LIKE results not already present
+        const seenIds = new Set(matchRows.map((r) => r.id));
+        for (const r of likeRows) {
+            if (!seenIds.has(r.id)) {
+                matchRows.push(r);
+                seenIds.add(r.id);
+            }
+        }
+    }
+    return matchRows.slice(0, limit).map((r) => ({
         id: r.id,
         name: r.name,
         normLabel: r.norm_label,
@@ -29,4 +64,117 @@ export function ftsSearch(db, query, limit, label) {
         rank: r.rank,
     }));
 }
+/**
+ * Computes an in-memory fuzzy sequence score for `query` against `name`.
+ * Walks through query chars left-to-right, finding each in `name` sequentially.
+ * Returns a score in [0, 1]: higher means a tighter match.
+ */
+function computeFuzzyScore(name, query) {
+    if (!query.length)
+        return 0;
+    const lname = name.toLowerCase();
+    const lquery = query.toLowerCase();
+    let nameIdx = 0;
+    let matched = 0;
+    let gapPenalty = 0;
+    let lastMatchPos = -1;
+    for (let qi = 0; qi < lquery.length; qi++) {
+        const ch = lquery[qi];
+        const pos = lname.indexOf(ch, nameIdx);
+        if (pos === -1)
+            break;
+        matched++;
+        if (lastMatchPos !== -1) {
+            gapPenalty += pos - lastMatchPos - 1;
+        }
+        lastMatchPos = pos;
+        nameIdx = pos + 1;
+    }
+    if (matched === 0)
+        return 0;
+    const matchRatio = matched / lquery.length;
+    const normalizedGap = gapPenalty / (lname.length || 1);
+    return matchRatio * (1 / (1 + normalizedGap));
+}
+/** Returns a small bonus based on node label to favour structural node types. */
+function computeNodeTypeBonus(label) {
+    if (label === 'File' || label === 'Module')
+        return 0.02;
+    if (label === 'Class')
+        return 0.01;
+    return 0;
+}
+/**
+ * Hybrid search combining three strategies:
+ *  1. FTS5 (trigram) BM25 match via `ftsSearch`
+ *  2. LIKE fallback for short queries (≤3 chars) or when FTS returns 0 results
+ *  3. In-memory fuzzy character-sequence scoring applied to all candidates
+ *
+ * Results are deduped by id (highest combinedScore wins), re-ranked, and
+ * trimmed to `limit`. The existing `ftsSearch` is left unchanged.
+ */
+export function hybridSearch(db, query, limit, label) {
+    const safeQuery = query.replace(/[*]/g, ' ').trim();
+    if (!safeQuery)
+        return [];
+    // id → best result so far
+    const best = new Map();
+    const upsert = (result) => {
+        const existing = best.get(result.id);
+        if (!existing || result.combinedScore > existing.combinedScore) {
+            best.set(result.id, result);
+        }
+    };
+    // ── Strategy 1: FTS5 BM25 ──────────────────────────────────────────────────
+    const ftsRows = ftsSearch(db, safeQuery, limit * 2, label);
+    for (const row of ftsRows) {
+        // FTS5 rank is negative; larger magnitude = better match. Map to (0,1) with higher = better.
+        const absRank = Math.abs(row.rank);
+        const ftsScore = absRank / (1 + absRank);
+        const fuzz = computeFuzzyScore(row.name, safeQuery);
+        const combined = ftsScore + fuzz + computeNodeTypeBonus(row.label);
+        upsert({ ...row, combinedScore: combined, matchStrategy: 'fts' });
+    }
+    // ── Strategy 2: LIKE fallback ──────────────────────────────────────────────
+    // Always run for short queries (≤3 chars) or when FTS returned nothing.
+    if (safeQuery.length <= 3 || ftsRows.length === 0) {
+        const escapedSafeQuery = safeQuery.replace(/%/g, '\\%').replace(/_/g, '\\_');
+        const likePattern = `%${escapedSafeQuery}%`;
+        let likeSql = `
+      SELECT n.id, n.name, n.norm_label, n.file_path, n.label
+      FROM nodes n
+      WHERE (n.name LIKE ? OR n.norm_label LIKE ?)
+    `;
+        const likeParams = [likePattern, likePattern];
+        if (label) {
+            likeSql += ' AND n.label = ?';
+            likeParams.push(label);
+        }
+        likeSql += ' LIMIT ?';
+        likeParams.push(limit * 2);
+        const likeRows = db
+            .prepare(likeSql)
+            .all(...likeParams);
+        for (const r of likeRows) {
+            const name = r.name;
+            const lbl = r.label;
+            const fuzz = computeFuzzyScore(name, safeQuery);
+            const combined = 0.3 + fuzz + computeNodeTypeBonus(lbl);
+            upsert({
+                id: r.id,
+                name,
+                normLabel: r.norm_label,
+                filePath: r.file_path ?? null,
+                label: lbl,
+                rank: 0,
+                combinedScore: combined,
+                matchStrategy: 'like',
+            });
+        }
+    }
+    // ── Sort, dedupe (handled by Map), slice ───────────────────────────────────
+    return Array.from(best.values())
+        .sort((a, b) => b.combinedScore - a.combinedScore)
+        .slice(0, limit);
+}
 //# sourceMappingURL=fts-store.js.map

package/dist/src/storage/fts-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"fts-store.js","sourceRoot":"","sources":["../../../src/storage/fts-store.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,SAAS,CACvB,EAAqB,EACrB,KAAa,EACb,KAAa,EACb,KAAc;IAEd,wCAAwC;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,mCAAmC;IACnC,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAElF,IAAI,GAAG,GAAG;;;;;;GAMT,CAAC;IACF,MAAM,MAAM,GAAc,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,IAAI,kBAAkB,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,GAAG,IAAI,kCAAkC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAI,MAAiC,CAGnE,CAAC;IACJ,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,CAAC,CAAC,EAAY;QAClB,IAAI,EAAE,CAAC,CAAC,IAAc;QACtB,SAAS,EAAE,CAAC,CAAC,UAAoB;QACjC,QAAQ,EAAG,CAAC,CAAC,SAA2B,IAAI,IAAI;QAChD,KAAK,EAAE,CAAC,CAAC,KAAe;QACxB,IAAI,EAAE,CAAC,CAAC,IAAc;KACvB,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"fts-store.js","sourceRoot":"","sources":["../../../src/storage/fts-store.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/node-store.d.ts

@@ -6,4 +6,33 @@ export declare function getNode(db: Database.Database, id: string): MonographNod
 export declare function getNodesForFile(db: Database.Database, filePath: string): MonographNode[];
 export declare function deleteNodesForFile(db: Database.Database, filePath: string): void;
 export declare function countNodes(db: Database.Database): number;
+export interface PropertyDef {
+    ident: string;
+    type: string;
+    cardinality: string;
+    viewContext: string;
+    closedValues: string[] | null;
+    description: string | null;
+    queryable: boolean;
+}
+/** List all registered property definitions */
+export declare function listProperties(db: Database.Database): PropertyDef[];
+/** Get a single property definition */
+export declare function getProperty(db: Database.Database, ident: string): PropertyDef | null;
+/** Register or update a custom property */
+export declare function upsertProperty(db: Database.Database, def: PropertyDef): void;
+/**
+ * Query nodes by a typed property value extracted from their JSON properties column.
+ * For queryable properties only.
+ * @param ident - property ident (e.g. 'layer', 'tags', 'ua_type')
+ * @param value - value to match (exact for closed/text, numeric comparison for number)
+ * @param comparator - '=' | 'LIKE' | '>' | '<' (default '=')
+ */
+export declare function queryByProperty(db: Database.Database, ident: string, value: string | number | boolean, comparator?: '=' | 'LIKE' | '>' | '<', limit?: number): Array<{
+    id: string;
+    name: string;
+    label: string;
+    filePath: string | null;
+    propertyValue: unknown;
+}>;
 //# sourceMappingURL=node-store.d.ts.map

package/dist/src/storage/node-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-store.d.ts","sourceRoot":"","sources":["../../../src/storage/node-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAmB3E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAO/E;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAKpF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAKxF;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"node-store.d.ts","sourceRoot":"","sources":["../../../src/storage/node-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAmB3E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAO/E;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAKpF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAKxF;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAGxD;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB;AAcD,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,EAAE,CAGnE;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGpF;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAoB5E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAChC,UAAU,GAAE,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,GAAS,EAC1C,KAAK,SAAM,GACV,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBrG"}

package/dist/src/storage/node-store.js

@@ -1,4 +1,4 @@
-import { toNormLabel } from '../types.js';
+import { toNormLabel, MonographError } from '../types.js';
 export function insertNode(db, node) {
     db.prepare(`
     INSERT OR REPLACE INTO nodes
@@ -34,6 +34,72 @@ export function countNodes(db) {
     const row = db.prepare('SELECT COUNT(*) as n FROM nodes').get();
     return row.n;
 }
+function rowToPropDef(row) {
+    return {
+        ident: row.ident,
+        type: row.type,
+        cardinality: row.cardinality,
+        viewContext: row.view_context,
+        closedValues: row.closed_values ? JSON.parse(row.closed_values) : null,
+        description: row.description ?? null,
+        queryable: row.queryable === 1,
+    };
+}
+/** List all registered property definitions */
+export function listProperties(db) {
+    const rows = db.prepare('SELECT * FROM node_properties ORDER BY ident').all();
+    return rows.map(rowToPropDef);
+}
+/** Get a single property definition */
+export function getProperty(db, ident) {
+    const row = db.prepare('SELECT * FROM node_properties WHERE ident = ?').get(ident);
+    return row ? rowToPropDef(row) : null;
+}
+/** Register or update a custom property */
+export function upsertProperty(db, def) {
+    db.prepare(`
+    INSERT INTO node_properties (ident, type, cardinality, view_context, closed_values, description, queryable)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(ident) DO UPDATE SET
+      type = excluded.type,
+      cardinality = excluded.cardinality,
+      view_context = excluded.view_context,
+      closed_values = excluded.closed_values,
+      description = excluded.description,
+      queryable = excluded.queryable
+  `).run(def.ident, def.type, def.cardinality, def.viewContext, def.closedValues != null ? JSON.stringify(def.closedValues) : null, def.description ?? null, def.queryable ? 1 : 0);
+}
+/**
+ * Query nodes by a typed property value extracted from their JSON properties column.
+ * For queryable properties only.
+ * @param ident - property ident (e.g. 'layer', 'tags', 'ua_type')
+ * @param value - value to match (exact for closed/text, numeric comparison for number)
+ * @param comparator - '=' | 'LIKE' | '>' | '<' (default '=')
+ */
+export function queryByProperty(db, ident, value, comparator = '=', limit = 100) {
+    const propDef = getProperty(db, ident);
+    if (!propDef) {
+        throw new MonographError(`Unknown property: '${ident}'. Register it first with upsertProperty.`);
+    }
+    if (!propDef.queryable) {
+        throw new MonographError(`Property '${ident}' is not queryable (view_context may be 'never' or queryable=false).`);
+    }
+    const extractExpr = `json_extract(properties, '$.${ident}')`;
+    const rows = db.prepare(`
+    SELECT id, name, label, file_path, ${extractExpr} AS property_value
+    FROM nodes
+    WHERE properties IS NOT NULL
+      AND ${extractExpr} ${comparator} ?
+    LIMIT ?
+  `).all(value, limit);
+    return rows.map(r => ({
+        id: r.id,
+        name: r.name,
+        label: r.label,
+        filePath: r.file_path ?? null,
+        propertyValue: r.property_value,
+    }));
+}
 function rowToNode(row) {
     return {
         id: row.id,