@jafreck/lore 0.2.1 → 0.2.3

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

@@ -1,12 +1,13 @@
 /**
- * @module kb-server/tools/docs
+ * @module lore-server/tools/docs
  *
  * MCP tool: list, fetch, and search indexed documentation.
  */
 import type { Database } from '../db.js';
 import { type DocRow, type DocSectionRow } from '../db.js';
+import type { EmbeddingProvider } from '../../indexer/embedder.js';
 export declare const toolDef: {
-    readonly name: "kb_docs";
+    readonly name: "lore_docs";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -24,6 +25,11 @@ export declare const toolDef: {
                 readonly type: "string";
                 readonly description: "Search query text (used by action=\"search\").";
             };
+            readonly mode: {
+                readonly type: "string";
+                readonly enum: readonly ["text", "semantic", "fused"];
+                readonly description: "Search mode for action=\"search\" (default: \"text\").";
+            };
             readonly kind: {
                 readonly type: "string";
                 readonly description: "Optional single doc kind filter.";
@@ -59,6 +65,7 @@ export interface DocsArgs {
     action: 'list' | 'get' | 'search';
     path?: string;
     query?: string;
+    mode?: 'text' | 'semantic' | 'fused';
     kind?: string;
     kinds?: string[];
     include_sections?: boolean;
@@ -69,10 +76,11 @@ export interface DocsArgs {
 export interface DocsResult {
     action: DocsArgs['action'];
     count: number;
+    mode_used?: string;
     docs?: DocRow[];
     doc?: DocRow | null;
     sections?: DocSectionRow[];
     results?: DocSectionRow[];
 }
-export declare function handler(db: Database.Database, args: DocsArgs): DocsResult;
+export declare function handler(db: Database.Database, args: DocsArgs, embedder?: EmbeddingProvider): Promise<DocsResult>;
 //# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/lore-server/tools/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAML,KAAK,MAAM,EACX,KAAK,aAAa,EAEnB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDV,CAAC;AAEX,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AA0FD,wBAAsB,OAAO,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA8HrB"}

package/dist/lore-server/tools/docs.js

@@ -0,0 +1,243 @@
+/**
+ * @module lore-server/tools/docs
+ *
+ * MCP tool: list, fetch, and search indexed documentation.
+ */
+import { listDocs, getDocByPath, listDocSections, searchDocSections, semanticSearchDocSections, } from '../db.js';
+export const toolDef = {
+    name: 'lore_docs',
+    description: 'Query indexed documentation. ' +
+        'Use action="list" to list docs, action="get" to fetch a document and optional sections, ' +
+        'or action="search" to search section/chunk content. ' +
+        'For action="search", mode="text" uses LIKE matching, mode="semantic" uses embedding similarity, ' +
+        'and mode="fused" combines both.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['list', 'get', 'search'],
+                description: 'Operation to execute.',
+            },
+            path: {
+                type: 'string',
+                description: 'Optional doc path filter. Required for precise get/path-scoped search.',
+            },
+            query: {
+                type: 'string',
+                description: 'Search query text (used by action="search").',
+            },
+            mode: {
+                type: 'string',
+                enum: ['text', 'semantic', 'fused'],
+                description: 'Search mode for action="search" (default: "text").',
+            },
+            kind: {
+                type: 'string',
+                description: 'Optional single doc kind filter.',
+            },
+            kinds: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional list of doc kinds to include.',
+            },
+            include_sections: {
+                type: 'boolean',
+                description: 'When action="get", include section/chunk rows (default true).',
+            },
+            section_index: {
+                type: 'number',
+                description: 'Optional section index filter for get/search results.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of rows to return.',
+            },
+            branch: {
+                type: 'string',
+                description: 'Optional branch filter.',
+            },
+        },
+        required: ['action'],
+    },
+};
+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 filterSectionIndex(rows, sectionIndex) {
+    if (sectionIndex === undefined) {
+        return rows;
+    }
+    return rows.filter((row) => row.section_index === sectionIndex);
+}
+function docSectionKey(row) {
+    return `${row.doc_id}:${row.section_index}:${row.id}`;
+}
+function fuseDocSections(textResults, semanticResults, limit) {
+    const k = 60;
+    const scored = new Map();
+    const addList = (rows) => {
+        rows.forEach((row, idx) => {
+            const key = docSectionKey(row);
+            const contribution = 1 / (k + idx + 1);
+            const existing = scored.get(key);
+            if (existing) {
+                existing.score += contribution;
+            }
+            else {
+                scored.set(key, { row, score: contribution });
+            }
+        });
+    };
+    addList(textResults);
+    addList(semanticResults);
+    return Array.from(scored.values())
+        .sort((a, b) => b.score - a.score
+        || a.row.doc_path.localeCompare(b.row.doc_path)
+        || a.row.doc_branch.localeCompare(b.row.doc_branch)
+        || a.row.section_index - b.row.section_index
+        || a.row.id - b.row.id)
+        .slice(0, limit)
+        .map(({ row }) => row);
+}
+async function semanticDocSearch(db, args, query, limit, embedder) {
+    if (!hasVirtualTable(db, 'doc_section_embeddings')) {
+        return null;
+    }
+    try {
+        const [queryVector] = await embedder.embed([query]);
+        if (!queryVector || queryVector.length === 0) {
+            return null;
+        }
+        return semanticSearchDocSections(db, {
+            queryVector,
+            path: args.path,
+            branch: args.branch,
+            kind: args.kind,
+            kinds: args.kinds,
+            limit,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+export async function handler(db, args, embedder) {
+    if (args.action === 'list') {
+        const docs = listDocs(db, {
+            branch: args.branch,
+            kind: args.kind,
+            kinds: args.kinds,
+            limit: args.limit ?? 100,
+        });
+        return {
+            action: 'list',
+            docs,
+            count: docs.length,
+        };
+    }
+    if (args.action === 'get') {
+        const path = args.path?.trim();
+        if (!path) {
+            return {
+                action: 'get',
+                doc: null,
+                sections: [],
+                count: 0,
+            };
+        }
+        const doc = getDocByPath(db, path, args.branch);
+        if (!doc) {
+            return {
+                action: 'get',
+                doc: null,
+                sections: [],
+                count: 0,
+            };
+        }
+        const includeSections = args.include_sections ?? true;
+        let sections = [];
+        if (includeSections) {
+            sections = listDocSections(db, {
+                path: doc.path,
+                branch: doc.branch,
+                kind: args.kind,
+                kinds: args.kinds,
+                limit: args.limit ?? 200,
+            });
+            if (args.section_index !== undefined) {
+                sections = sections.filter((section) => section.section_index === args.section_index);
+            }
+        }
+        return {
+            action: 'get',
+            doc,
+            sections,
+            count: includeSections ? sections.length : 1,
+        };
+    }
+    const query = args.query?.trim() ?? '';
+    const mode = args.mode ?? 'text';
+    const limit = args.limit ?? 20;
+    if (!query) {
+        return {
+            action: 'search',
+            results: [],
+            count: 0,
+            mode_used: mode,
+        };
+    }
+    const textResults = filterSectionIndex(searchDocSections(db, {
+        query,
+        path: args.path,
+        branch: args.branch,
+        kind: args.kind,
+        kinds: args.kinds,
+        limit,
+    }), args.section_index);
+    if (mode === 'text') {
+        return {
+            action: 'search',
+            results: textResults,
+            count: textResults.length,
+            mode_used: 'text',
+        };
+    }
+    if (!embedder) {
+        return {
+            action: 'search',
+            results: textResults,
+            count: textResults.length,
+            mode_used: 'text (fallback: no query-time embedder)',
+        };
+    }
+    const semanticResults = await semanticDocSearch(db, args, query, limit, embedder);
+    if (!semanticResults) {
+        return {
+            action: 'search',
+            results: textResults,
+            count: textResults.length,
+            mode_used: 'text (fallback: no embeddings)',
+        };
+    }
+    const filteredSemantic = filterSectionIndex(semanticResults, args.section_index);
+    if (mode === 'semantic') {
+        return {
+            action: 'search',
+            results: filteredSemantic,
+            count: filteredSemantic.length,
+            mode_used: 'semantic',
+        };
+    }
+    const fusedResults = fuseDocSections(textResults, filteredSemantic, limit);
+    return {
+        action: 'search',
+        results: fusedResults,
+        count: fusedResults.length,
+        mode_used: 'fused',
+    };
+}
+//# sourceMappingURL=docs.js.map

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

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

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

@@ -1,5 +1,5 @@
 /**
- * @module kb-server/tools/graph
+ * @module lore-server/tools/graph
  *
  * MCP tool: query the call graph and import graph.
  *
@@ -8,7 +8,7 @@
  */
 import type { Database } from '../db.js';
 export declare const toolDef: {
-    readonly name: "kb_graph";
+    readonly name: "lore_graph";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
@@ -30,15 +30,40 @@ export declare const toolDef: {
                 readonly type: "string";
                 readonly description: "Optional branch name to filter edges by source branch.";
             };
+            readonly mode: {
+                readonly type: "string";
+                readonly enum: readonly ["structural", "semantic"];
+                readonly description: "Query mode. \"structural\" (default) returns edges only; \"semantic\" also returns related nodes.";
+            };
+            readonly query_vector: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                };
+                readonly description: "Embedding vector used by semantic mode to find related nodes.";
+            };
+            readonly semantic_limit: {
+                readonly type: "number";
+                readonly description: "Maximum semantic related nodes to evaluate (default min(limit, 20)).";
+            };
+            readonly semantic_max_distance: {
+                readonly type: "number";
+                readonly description: "Optional maximum embedding distance threshold for semantic matches.";
+            };
         };
         readonly required: readonly ["kind"];
     };
 };
+type GraphKind = 'call' | 'import' | 'module' | 'inheritance';
 export interface GraphArgs {
-    kind: 'call' | 'import' | 'module' | 'inheritance';
+    kind: GraphKind;
     source_id?: number;
     limit?: number;
     branch?: string;
+    mode?: 'structural' | 'semantic';
+    query_vector?: number[];
+    semantic_limit?: number;
+    semantic_max_distance?: number;
 }
 export interface GraphEdge {
     source_id: number;
@@ -50,7 +75,19 @@ export interface GraphEdge {
 }
 export interface GraphResult {
     edges: GraphEdge[];
+    mode_used: string;
+    semantic_nodes?: GraphSemanticNode[];
+}
+export interface GraphSemanticNode {
+    node_type: 'symbol' | 'module';
+    id: number;
+    name: string;
+    branch: string;
+    score: number;
+    kind: string;
+    file_path?: string;
 }
 /** Return adjacency-list edges from the call graph or import graph. */
 export declare function handler(db: Database.Database, args: GraphArgs): GraphResult;
+export {};
 //# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/lore-server/tools/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDV,CAAC;AAIX,KAAK,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwMD,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAgF3E"}

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

@@ -1,18 +1,18 @@
 /**
- * @module kb-server/tools/graph
+ * @module lore-server/tools/graph
  *
  * MCP tool: query the call graph and import graph.
  *
  * Both queries return adjacency lists so callers can build their own
  * traversals without additional round-trips.
  */
-import { getCoveragePercentBySymbolIds } from '../db.js';
+import { getCoveragePercentBySymbolIds, semanticSearchSymbols } from '../db.js';
 // ─── Tool definition ──────────────────────────────────────────────────────────
 export const toolDef = {
-    name: 'kb_graph',
+    name: 'lore_graph',
     description: 'Query call, import, module, or inheritance graph edges stored in the knowledge-base index. ' +
         'Set `kind` to "call", "import", "module", or "inheritance". ' +
-        'Optionally filter by a source node id.',
+        'Optionally set mode="semantic" with query_vector to retrieve semantically related symbol/module nodes alongside edges.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -34,13 +34,35 @@ export const toolDef = {
                 type: 'string',
                 description: 'Optional branch name to filter edges by source branch.',
             },
+            mode: {
+                type: 'string',
+                enum: ['structural', 'semantic'],
+                description: 'Query mode. "structural" (default) returns edges only; "semantic" also returns related nodes.',
+            },
+            query_vector: {
+                type: 'array',
+                items: { type: 'number' },
+                description: 'Embedding vector used by semantic mode to find related nodes.',
+            },
+            semantic_limit: {
+                type: 'number',
+                description: 'Maximum semantic related nodes to evaluate (default min(limit, 20)).',
+            },
+            semantic_max_distance: {
+                type: 'number',
+                description: 'Optional maximum embedding distance threshold for semantic matches.',
+            },
         },
         required: ['kind'],
     },
 };
-/** Return adjacency-list edges from the call graph or import graph. */
-export function handler(db, args) {
-    const limit = args.limit ?? 200;
+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 getStructuralEdges(db, args, limit) {
     if (args.kind === 'call') {
         // Symbol-level: symbol_refs rows
         const hasFilter = args.source_id !== undefined;
@@ -76,7 +98,7 @@ export function handler(db, args) {
             ...edge,
             callee_coverage_percent: edge.target_id !== null ? (coverageBySymbolId.get(edge.target_id) ?? null) : null,
         }));
-        return { edges: edgesWithCoverage };
+        return edgesWithCoverage;
     }
     else if (args.kind === 'import') {
         // File-level: file_imports rows
@@ -107,7 +129,7 @@ export function handler(db, args) {
             ? (args.branch !== undefined ? [args.source_id, args.branch, limit] : [args.source_id, limit])
             : (args.branch !== undefined ? [args.branch, limit] : [limit]);
         const edges = db.prepare(sql).all(...edgeParams);
-        return { edges };
+        return edges;
     }
     else if (args.kind === 'module') {
         // Module-level: inferred from file_imports + file_modules
@@ -148,7 +170,7 @@ export function handler(db, args) {
             ? (args.branch !== undefined ? [args.source_id, args.branch, limit] : [args.source_id, limit])
             : (args.branch !== undefined ? [args.branch, limit] : [limit]);
         const edges = db.prepare(sql).all(...edgeParams);
-        return { edges };
+        return edges;
     }
     else {
         // Symbol-level inheritance edges (e.g., class extends)
@@ -182,7 +204,96 @@ export function handler(db, args) {
             ? (args.branch !== undefined ? [args.source_id, args.branch, limit] : [args.source_id, limit])
             : (args.branch !== undefined ? [args.branch, limit] : [limit]);
         const edges = db.prepare(sql).all(...edgeParams);
-        return { edges };
+        return edges;
+    }
+}
+function getSemanticModuleMappings(db, symbolIds) {
+    if (symbolIds.length === 0) {
+        return [];
+    }
+    const placeholders = symbolIds.map(() => '?').join(', ');
+    return db.prepare(`SELECT s.id AS symbol_id,
+            m.id AS module_id,
+            m.name AS module_name,
+            m.kind AS module_kind,
+            f.branch AS source_branch
+       FROM symbols s
+       JOIN files f ON f.id = s.file_id
+       JOIN file_modules fm ON fm.file_id = f.id
+       JOIN modules m ON m.id = fm.module_id
+      WHERE s.id IN (${placeholders})`).all(...symbolIds);
+}
+/** Return adjacency-list edges from the call graph or import graph. */
+export function handler(db, args) {
+    const limit = args.limit ?? 200;
+    const edges = getStructuralEdges(db, args, limit);
+    const mode = args.mode ?? 'structural';
+    if (mode !== 'semantic') {
+        return { edges, mode_used: 'structural' };
+    }
+    const queryVector = args.query_vector;
+    if (!queryVector || queryVector.length === 0) {
+        return {
+            edges,
+            semantic_nodes: [],
+            mode_used: 'structural (fallback: missing query_vector)',
+        };
+    }
+    if (!hasVirtualTable(db, 'symbol_embeddings')) {
+        return {
+            edges,
+            semantic_nodes: [],
+            mode_used: 'structural (fallback: no embeddings)',
+        };
+    }
+    const semanticLimit = Math.max(1, Math.floor(args.semantic_limit ?? Math.min(limit, 20)));
+    const maxDistance = args.semantic_max_distance;
+    const symbolRows = semanticSearchSymbols(db, {
+        queryVector,
+        branch: args.branch,
+        limit: semanticLimit,
+    });
+    const filteredSymbols = maxDistance === undefined
+        ? symbolRows
+        : symbolRows.filter((row) => row.score <= maxDistance);
+    const symbolNodes = filteredSymbols.map((row) => ({
+        node_type: 'symbol',
+        id: row.id,
+        name: row.name,
+        branch: row.file_branch,
+        score: row.score,
+        kind: row.kind,
+        file_path: row.file_path,
+    }));
+    const scoreBySymbolId = new Map(filteredSymbols.map((row) => [row.id, row.score]));
+    const moduleNodesByKey = new Map();
+    const moduleMappings = getSemanticModuleMappings(db, Array.from(scoreBySymbolId.keys()));
+    for (const mapping of moduleMappings) {
+        const symbolScore = scoreBySymbolId.get(mapping.symbol_id);
+        if (symbolScore === undefined) {
+            continue;
+        }
+        const moduleKey = `${mapping.module_id}:${mapping.source_branch}`;
+        const existing = moduleNodesByKey.get(moduleKey);
+        if (!existing || symbolScore < existing.score) {
+            moduleNodesByKey.set(moduleKey, {
+                node_type: 'module',
+                id: mapping.module_id,
+                name: mapping.module_name,
+                branch: mapping.source_branch,
+                score: symbolScore,
+                kind: mapping.module_kind,
+            });
+        }
     }
+    const moduleNodes = Array.from(moduleNodesByKey.values()).sort((a, b) => a.score - b.score
+        || a.branch.localeCompare(b.branch)
+        || a.name.localeCompare(b.name)
+        || a.id - b.id);
+    return {
+        edges,
+        semantic_nodes: [...symbolNodes, ...moduleNodes],
+        mode_used: 'semantic',
+    };
 }
 //# sourceMappingURL=graph.js.map

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

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

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

@@ -1,19 +1,20 @@
 /**
- * @module kb-server/tools/history
+ * @module lore-server/tools/history
  *
  * MCP tool: query commit history by file, commit SHA, author, or recency.
  */
 import type { Database } from '../db.js';
 import { type CommitRow, type CommitFileRow, type CommitRefRow } from '../db.js';
+import type { EmbeddingProvider } from '../../indexer/embedder.js';
 export declare const toolDef: {
-    readonly name: "kb_history";
+    readonly name: "lore_history";
     readonly description: string;
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
             readonly mode: {
                 readonly type: "string";
-                readonly enum: readonly ["file", "commit", "author", "ref", "recent"];
+                readonly enum: readonly ["file", "commit", "author", "ref", "semantic", "recent"];
                 readonly description: "Query mode.";
             };
             readonly query: {
@@ -29,7 +30,7 @@ export declare const toolDef: {
     };
 };
 export interface HistoryArgs {
-    mode: 'file' | 'commit' | 'author' | 'ref' | 'recent';
+    mode: 'file' | 'commit' | 'author' | 'ref' | 'semantic' | 'recent';
     query?: string;
     limit?: number;
 }
@@ -37,11 +38,17 @@ export interface CommitWithFiles extends CommitRow {
     files?: CommitFileRow[];
     refs?: CommitRefRow[];
 }
+export interface CommitEnrichmentOptions {
+    includeFiles?: boolean;
+    includeRefs?: boolean;
+}
 export interface HistoryResult {
     mode: string;
     results: CommitWithFiles[];
     count: number;
 }
-/** Handle a kb_history tool invocation against the open read-only database. */
-export declare function handler(db: Database.Database, args: HistoryArgs): HistoryResult;
+/** Enrich commit rows with touched files and refs metadata. */
+export declare function enrichCommitsWithContext(db: Database.Database, commits: CommitRow[], options?: CommitEnrichmentOptions): CommitWithFiles[];
+/** Handle a lore_history tool invocation against the open read-only database. */
+export declare function handler(db: Database.Database, args: HistoryArgs, embedder?: EmbeddingProvider): Promise<HistoryResult>;
 //# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/lore-server/tools/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAUL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAInE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;CAoCV,CAAC;AAIX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,+DAA+D;AAC/D,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,GAAE,uBAA4B,GACpC,eAAe,EAAE,CASnB;AAED,iFAAiF;AACjF,wBAAsB,OAAO,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,WAAW,EACjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAmExB"}