@jafreck/lore 0.2.0 → 0.2.2

package/dist/{kb-server → lore-server}/tools/notes.js

@@ -1,16 +1,16 @@
 /**
- * @module kb-server/tools/notes
+ * @module lore-server/tools/notes
  *
  * MCP tools:
- * - kb_notes_write: upsert notes by (key, scope)
- * - kb_notes_read: retrieve notes with staleness/recency metadata
+ * - lore_notes_write: upsert notes by (key, scope)
+ * - lore_notes_read: retrieve notes with staleness/recency metadata
  */
 import Database from 'better-sqlite3';
 const DEFAULT_SCOPE = 'global';
 const DEFAULT_LIMIT = 20;
 const MAX_LIMIT = 200;
-export const kbNotesWriteToolDef = {
-    name: 'kb_notes_write',
+export const loreNotesWriteToolDef = {
+    name: 'lore_notes_write',
     description: 'Upsert an LLM-authored note in the knowledge base by key and scope. ' +
         'Defaults scope to "global" and updates updated_at on existing notes.',
     inputSchema: {
@@ -31,8 +31,8 @@ export const kbNotesWriteToolDef = {
         required: ['key', 'content'],
     },
 };
-export const kbNotesReadToolDef = {
-    name: 'kb_notes_read',
+export const loreNotesReadToolDef = {
+    name: 'lore_notes_read',
     description: 'Read notes by exact key and/or key prefix, optionally filtered by scope. ' +
         'Returns staleness metadata for file-scoped notes and recency metadata for global notes.',
     inputSchema: {
@@ -55,7 +55,19 @@ function clampLimit(limit) {
         return DEFAULT_LIMIT;
     return Math.min(Math.max(1, Math.floor(limit)), MAX_LIMIT);
 }
-export function kbNotesWriteHandler(dbPath, args) {
+function parseDocScope(scope) {
+    if (!scope.startsWith('doc:'))
+        return null;
+    const encoded = scope.slice('doc:'.length);
+    const branchSeparator = encoded.lastIndexOf('@');
+    if (branchSeparator <= 0)
+        return null;
+    return {
+        path: encoded.slice(0, branchSeparator),
+        branch: encoded.slice(branchSeparator + 1),
+    };
+}
+export function loreNotesWriteHandler(dbPath, args) {
     const db = new Database(dbPath);
     try {
         db.pragma('foreign_keys = ON');
@@ -83,7 +95,7 @@ export function kbNotesWriteHandler(dbPath, args) {
         db.close();
     }
 }
-export function kbNotesReadHandler(db, args) {
+export function loreNotesReadHandler(db, args) {
     const limit = clampLimit(args.limit);
     const where = [];
     const params = [];
@@ -110,16 +122,39 @@ export function kbNotesReadHandler(db, args) {
        ORDER BY updated_at DESC, id DESC
        LIMIT ?`)
         .all(...params, limit);
-    const kbIndexedAtRow = db
+    const loreIndexedAtRow = db
         .prepare('SELECT MAX(indexed_at) AS indexed_at FROM files')
         .get();
-    const kbIndexedAt = kbIndexedAtRow.indexed_at;
+    const loreIndexedAt = loreIndexedAtRow.indexed_at;
     const getFileRecency = db.prepare(`SELECT last_hash, indexed_at
      FROM files
      WHERE path = ?
      ORDER BY indexed_at DESC
      LIMIT 1`);
+    const getDocRecency = db.prepare(`SELECT content_hash, indexed_at
+     FROM docs
+     WHERE path = ? AND branch = ?
+     ORDER BY indexed_at DESC
+     LIMIT 1`);
     const notes = rows.map((row) => {
+        const docScope = parseDocScope(row.scope);
+        if (docScope) {
+            const docRow = getDocRecency.get(docScope.path, docScope.branch);
+            const stale = !docRow || (row.source_hash != null && row.source_hash !== docRow.content_hash);
+            const staleReason = !docRow
+                ? 'doc_missing'
+                : stale
+                    ? 'source_hash_mismatch'
+                    : null;
+            return {
+                ...row,
+                stale,
+                stale_reason: staleReason,
+                file_last_hash: null,
+                file_indexed_at: null,
+                lore_indexed_at: null,
+            };
+        }
         if (row.scope.startsWith('file:')) {
             const filePath = row.scope.slice('file:'.length);
             const fileRow = getFileRecency.get(filePath);
@@ -143,18 +178,18 @@ export function kbNotesReadHandler(db, args) {
                 stale_reason: staleReason,
                 file_last_hash: fileRow?.last_hash ?? null,
                 file_indexed_at: fileRow?.indexed_at ?? null,
-                kb_indexed_at: null,
+                lore_indexed_at: null,
             };
         }
         if (row.scope === DEFAULT_SCOPE) {
-            const stale = kbIndexedAt != null ? row.updated_at < kbIndexedAt : false;
+            const stale = loreIndexedAt != null ? row.updated_at < loreIndexedAt : false;
             return {
                 ...row,
                 stale,
-                stale_reason: stale ? 'kb_reindexed_since_note' : null,
+                stale_reason: stale ? 'lore_reindexed_since_note' : null,
                 file_last_hash: null,
                 file_indexed_at: null,
-                kb_indexed_at: kbIndexedAt,
+                lore_indexed_at: loreIndexedAt,
             };
         }
         return {
@@ -163,13 +198,13 @@ export function kbNotesReadHandler(db, args) {
             stale_reason: null,
             file_last_hash: null,
             file_indexed_at: null,
-            kb_indexed_at: null,
+            lore_indexed_at: null,
         };
     });
     return { notes, count: notes.length };
 }
-export const writeToolDef = kbNotesWriteToolDef;
-export const readToolDef = kbNotesReadToolDef;
-export const writeHandler = kbNotesWriteHandler;
-export const readHandler = kbNotesReadHandler;
+export const writeToolDef = loreNotesWriteToolDef;
+export const readToolDef = loreNotesReadToolDef;
+export const writeHandler = loreNotesWriteHandler;
+export const readHandler = loreNotesReadHandler;
 //# sourceMappingURL=notes.js.map

package/dist/lore-server/tools/notes.js.map

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

package/dist/{kb-server → lore-server}/tools/routes.d.ts

@@ -1,12 +1,12 @@
 /**
- * @module kb-server/tools/routes
+ * @module lore-server/tools/routes
  *
  * MCP tool: query extracted API routes/endpoints.
  */
 import type { Database } from '../db.js';
 import { type ApiRouteRow } from '../db.js';
 export declare const toolDef: {
-    readonly name: "kb_routes";
+    readonly name: "lore_routes";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";

package/dist/lore-server/tools/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/lore-server/tools/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;CAsBV,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAQ7E"}

package/dist/{kb-server → lore-server}/tools/routes.js

@@ -1,11 +1,11 @@
 /**
- * @module kb-server/tools/routes
+ * @module lore-server/tools/routes
  *
  * MCP tool: query extracted API routes/endpoints.
  */
 import { listApiRoutes } from '../db.js';
 export const toolDef = {
-    name: 'kb_routes',
+    name: 'lore_routes',
     description: 'Query extracted API routes/endpoints from the knowledge-base index. ' +
         'Optional filters: `method`, `path_prefix`, and `framework`.',
     inputSchema: {

package/dist/lore-server/tools/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/lore-server/tools/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAoB,MAAM,UAAU,CAAC;AAE3D,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,sEAAsE;QACtE,6DAA6D;IAC/D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sDAAsD;aACpE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gEAAgE;aAC9E;SACF;KACF;CACO,CAAC;AAYX,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,IAAgB;IAC7D,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,EAAE,EAAE;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/{kb-server → lore-server}/tools/search.d.ts

@@ -1,5 +1,5 @@
 /**
- * @module kb-server/tools/search
+ * @module lore-server/tools/search
  *
  * MCP tool: multi-modal knowledge-base search.
  *
@@ -14,7 +14,7 @@
 import type { Database } from '../db.js';
 import type { EmbeddingProvider } from '../../indexer/embedder.js';
 /**
- * Observation emitted after every `kb_search` invocation.
+ * Observation emitted after every `lore_search` invocation.
  * Consumers can use this to log, collect metrics, or detect search-quality issues.
  */
 export interface SearchObservation {
@@ -38,7 +38,7 @@ export interface SearchObservation {
 /** Callback invoked after each search completes. Fire-and-forget — errors are swallowed. */
 export type SearchObserver = (observation: SearchObservation) => void;
 export declare const toolDef: {
-    readonly name: "kb_search";
+    readonly name: "lore_search";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -56,6 +56,26 @@ export declare const toolDef: {
                 readonly type: "number";
                 readonly description: "Maximum number of results to return (default 20).";
             };
+            readonly path_prefix: {
+                readonly type: "string";
+                readonly description: "Optional source file path prefix filter for symbol results.";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly description: "Optional source language filter for symbol results.";
+            };
+            readonly kind: {
+                readonly type: "string";
+                readonly description: "Optional symbol kind filter for symbol results.";
+            };
+            readonly doc_path_prefix: {
+                readonly type: "string";
+                readonly description: "Optional documentation path prefix filter for semantic/fused doc-section results.";
+            };
+            readonly doc_kind: {
+                readonly type: "string";
+                readonly description: "Optional documentation kind filter for semantic/fused doc-section results.";
+            };
         };
         readonly required: readonly ["query"];
     };
@@ -65,20 +85,44 @@ export interface SearchArgs {
     mode?: 'structural' | 'semantic' | 'fused';
     limit?: number;
     branch?: string;
+    path_prefix?: string;
+    language?: string;
+    kind?: string;
+    doc_path_prefix?: string;
+    doc_kind?: string;
 }
 export interface SearchResult {
-    results: Array<{
-        symbol_id: number;
-        name: string;
-        kind: string;
-        file_path: string;
-        start_line: number;
-        end_line: number;
-        score: number;
-        branch: string;
-    }>;
+    results: SearchResultItem[];
     mode_used: string;
 }
+export interface SearchSymbolResult {
+    result_type: 'symbol';
+    symbol_id: number;
+    name: string;
+    kind: string;
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    score: number;
+    branch: string;
+}
+export interface SearchDocSectionResult {
+    result_type: 'doc_section';
+    doc_section_id: number;
+    doc_id: number;
+    doc_kind: string;
+    doc_title: string;
+    section_index: number;
+    heading_path: string;
+    name: string;
+    kind: string;
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    score: number;
+    branch: string;
+}
+export type SearchResultItem = SearchSymbolResult | SearchDocSectionResult;
 /** Execute a knowledge-base search in the requested mode. */
 export declare function handler(db: Database.Database, args: SearchArgs, embedder?: EmbeddingProvider, observer?: SearchObserver): Promise<SearchResult>;
 //# sourceMappingURL=search.d.ts.map

package/dist/lore-server/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/lore-server/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKnE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,aAAa,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IACnD,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4FAA4F;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAItE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CV,CAAC;AAIX,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,QAAQ,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,aAAa,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;AAmO3E,6DAA6D;AAC7D,wBAAsB,OAAO,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,YAAY,CAAC,CAgDvB"}

package/dist/{kb-server → lore-server}/tools/search.js

@@ -1,5 +1,5 @@
 /**
- * @module kb-server/tools/search
+ * @module lore-server/tools/search
  *
  * MCP tool: multi-modal knowledge-base search.
  *
@@ -11,9 +11,10 @@
  * Semantic and fused modes fall back to structural-only when no EmbeddingProvider
  * is supplied, clearly indicating the degradation in `mode_used`.
  */
+import { semanticSearchDocSections } from '../db.js';
 // ─── Tool definition ──────────────────────────────────────────────────────────
 export const toolDef = {
-    name: 'kb_search',
+    name: 'lore_search',
     description: 'Search the knowledge-base index for symbols matching a natural-language or code query. ' +
         'mode="structural" uses BM25 FTS5 (fast, exact-ish). ' +
         'mode="semantic" uses cosine similarity over embedding vectors (requires indexed embeddings). ' +
@@ -34,6 +35,26 @@ export const toolDef = {
                 type: 'number',
                 description: 'Maximum number of results to return (default 20).',
             },
+            path_prefix: {
+                type: 'string',
+                description: 'Optional source file path prefix filter for symbol results.',
+            },
+            language: {
+                type: 'string',
+                description: 'Optional source language filter for symbol results.',
+            },
+            kind: {
+                type: 'string',
+                description: 'Optional symbol kind filter for symbol results.',
+            },
+            doc_path_prefix: {
+                type: 'string',
+                description: 'Optional documentation path prefix filter for semantic/fused doc-section results.',
+            },
+            doc_kind: {
+                type: 'string',
+                description: 'Optional documentation kind filter for semantic/fused doc-section results.',
+            },
         },
         required: ['query'],
     },
@@ -50,13 +71,33 @@ function sanitizeFts5Query(query) {
     // Escape interior double-quotes, then wrap in double-quotes for a phrase query.
     return `"${query.replace(/"/g, '""')}"`;
 }
+function symbolEnrichmentProjection(db) {
+    let columns = new Set();
+    try {
+        const rows = db.prepare('PRAGMA table_info(symbols)').all();
+        columns = new Set(rows.map((row) => row.name));
+    }
+    catch {
+        columns = new Set();
+    }
+    const column = (name) => (columns.has(name) ? `s.${name} AS ${name}` : `NULL AS ${name}`);
+    return [
+        column('resolved_type_signature'),
+        column('resolved_return_type'),
+        column('definition_uri'),
+        column('definition_path'),
+    ].join(',\n                ');
+}
 /** Run a structural BM25 FTS5 search and return ranked rows. */
 function structuralSearch(db, query, limit, branch) {
     const safeQuery = sanitizeFts5Query(query);
     const branchClause = branch !== undefined ? ' AND f.branch = ?' : '';
+    const enrichmentProjection = symbolEnrichmentProjection(db);
     try {
-        const sql = `SELECT s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
+        const sql = `SELECT 'symbol' AS result_type,
+                s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
                 s.start_line, s.end_line,
+                ${enrichmentProjection},
                 bm25(symbols_fts) AS score,
                 f.branch AS branch
            FROM symbols_fts
@@ -64,7 +105,7 @@ function structuralSearch(db, query, limit, branch) {
            JOIN files   f ON f.id   = s.file_id
           WHERE symbols_fts MATCH ?${branchClause}
           ORDER BY score
-          LIMIT ?`;
+           LIMIT ?`;
         const params = branch !== undefined ? [safeQuery, branch, limit] : [safeQuery, limit];
         const rows = db.prepare(sql).all(...params);
         return rows;
@@ -72,18 +113,85 @@ function structuralSearch(db, query, limit, branch) {
     catch {
         // FTS5 parse error — fall back to LIKE-based search.
         const likeQuery = `%${query}%`;
-        const sql = `SELECT s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
+        const sql = `SELECT 'symbol' AS result_type,
+                s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
                 s.start_line, s.end_line,
+                ${enrichmentProjection},
                 0.0 AS score,
                 f.branch AS branch
            FROM symbols s
            JOIN files f ON f.id = s.file_id
           WHERE s.name LIKE ?${branchClause}
-          LIMIT ?`;
+           LIMIT ?`;
         const params = branch !== undefined ? [likeQuery, branch, limit] : [likeQuery, limit];
         return db.prepare(sql).all(...params);
     }
 }
+function hasVirtualTable(db, name) {
+    const row = db
+        .prepare("SELECT 1 AS present FROM sqlite_master WHERE type IN ('table', 'virtual table') AND name = ? LIMIT 1")
+        .get(name);
+    return row?.present === 1;
+}
+function semanticSymbolSearch(db, queryVector, limit, branch) {
+    if (!hasVirtualTable(db, 'symbol_embeddings')) {
+        return [];
+    }
+    const branchClause = branch !== undefined ? ' AND f.branch = ?' : '';
+    const enrichment = symbolEnrichmentProjection(db);
+    const sql = `SELECT 'symbol' AS result_type,
+              s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
+              s.start_line, s.end_line,
+              ${enrichment},
+              distance AS score,
+              f.branch AS branch
+         FROM symbol_embeddings
+         JOIN symbols s ON s.rowid = symbol_embeddings.rowid
+         JOIN files   f ON f.id   = s.file_id
+        WHERE embedding MATCH ?${branchClause}
+        ORDER BY distance
+        LIMIT ?`;
+    const params = branch !== undefined
+        ? [JSON.stringify(queryVector), branch, limit]
+        : [JSON.stringify(queryVector), limit];
+    try {
+        return db.prepare(sql).all(...params);
+    }
+    catch {
+        return [];
+    }
+}
+function semanticDocSectionSearch(db, queryVector, limit, branch) {
+    if (!hasVirtualTable(db, 'doc_section_embeddings')) {
+        return [];
+    }
+    try {
+        const rows = semanticSearchDocSections(db, {
+            queryVector,
+            branch,
+            limit,
+        });
+        return rows.map((row) => ({
+            result_type: 'doc_section',
+            doc_section_id: row.id,
+            doc_id: row.doc_id,
+            doc_kind: row.doc_kind,
+            doc_title: row.doc_title,
+            section_index: row.section_index,
+            heading_path: row.heading_path,
+            name: row.title || row.doc_title,
+            kind: 'doc_section',
+            file_path: row.doc_path,
+            start_line: row.line_start,
+            end_line: row.line_end,
+            score: row.score,
+            branch: row.doc_branch,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
 /**
  * Attempt a semantic (cosine) search via the vec0 virtual table.
  * Returns `null` when no embedder is available or the table has no rows.
@@ -93,21 +201,11 @@ async function semanticSearch(db, query, limit, embedder, branch) {
         const [queryVec] = await embedder.embed([query]);
         if (!queryVec)
             return null;
-        const branchClause = branch !== undefined ? ' AND f.branch = ?' : '';
-        const sql = `SELECT s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
-                s.start_line, s.end_line,
-                distance AS score,
-                f.branch AS branch
-           FROM symbol_embeddings
-           JOIN symbols s ON s.rowid = symbol_embeddings.rowid
-           JOIN files   f ON f.id   = s.file_id
-          WHERE embedding MATCH ?${branchClause}
-          ORDER BY distance
-          LIMIT ?`;
-        const params = branch !== undefined
-            ? [JSON.stringify(queryVec), branch, limit]
-            : [JSON.stringify(queryVec), limit];
-        const rows = db.prepare(sql).all(...params);
+        const symbolRows = semanticSymbolSearch(db, queryVec, limit, branch);
+        const docRows = semanticDocSectionSearch(db, queryVec, limit, branch);
+        const rows = [...symbolRows, ...docRows]
+            .sort((a, b) => a.score - b.score)
+            .slice(0, limit);
         return rows.length > 0 ? rows : null;
     }
     catch {
@@ -123,15 +221,17 @@ async function semanticSearch(db, query, limit, embedder, branch) {
 function rrfFuse(structural, semantic, limit) {
     const k = 60;
     const scores = new Map();
+    const resultKey = (item) => item.result_type === 'symbol' ? `symbol:${item.symbol_id}` : `doc:${item.doc_section_id}`;
     const addList = (list) => {
         list.forEach((item, idx) => {
-            const existing = scores.get(item.symbol_id);
+            const key = resultKey(item);
+            const existing = scores.get(key);
             const contrib = 1 / (k + idx + 1);
             if (existing) {
                 existing.score += contrib;
             }
             else {
-                scores.set(item.symbol_id, { item, score: contrib });
+                scores.set(key, { item, score: contrib });
             }
         });
     };

package/dist/lore-server/tools/search.js.map

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

package/dist/{kb-server → lore-server}/tools/snippet.d.ts

@@ -1,12 +1,12 @@
 /**
- * @module kb-server/tools/snippet
+ * @module lore-server/tools/snippet
  *
  * MCP tool: extract source-code snippets for a given file path and
- * optional line range directly from the filesystem.
+ * optional line range directly from indexed source snapshots.
  */
 import type { Database } from '../db.js';
 export declare const toolDef: {
-    readonly name: "kb_snippet";
+    readonly name: "lore_snippet";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -23,6 +23,14 @@ export declare const toolDef: {
                 readonly type: "number";
                 readonly description: "Last line to include (1-based, inclusive).  Defaults to end-of-file.";
             };
+            readonly symbol: {
+                readonly type: "string";
+                readonly description: "Optional symbol name to resolve snippet bounds from indexed symbol metadata.";
+            };
+            readonly branch: {
+                readonly type: "string";
+                readonly description: "Optional branch to disambiguate the file path.";
+            };
         };
         readonly required: readonly ["path"];
     };
@@ -31,14 +39,22 @@ export interface SnippetArgs {
     path: string;
     start_line?: number;
     end_line?: number;
+    symbol?: string;
     branch?: string;
 }
+export interface SnippetContainingSymbol {
+    name: string;
+    kind: string;
+    start_line: number;
+    end_line: number;
+}
 export interface SnippetResult {
     path: string;
     start_line: number;
     end_line: number;
     text: string;
+    containing_symbol?: SnippetContainingSymbol;
 }
-/** Read source lines from the filesystem for the given indexed file path. */
+/** Read source lines from indexed source snapshots for the given indexed file path. */
 export declare function handler(db: Database.Database, args: SnippetArgs): SnippetResult;
 //# sourceMappingURL=snippet.d.ts.map

package/dist/lore-server/tools/snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../../src/lore-server/tools/snippet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCV,CAAC;AAIX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AA+DD,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CA6C/E"}