@jafreck/lore 0.1.0

package/dist/kb-server/tools/notes.js

@@ -0,0 +1,175 @@
+/**
+ * @module kb-server/tools/notes
+ *
+ * MCP tools:
+ * - kb_notes_write: upsert notes by (key, scope)
+ * - kb_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',
+    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: {
+        type: 'object',
+        properties: {
+            key: { type: 'string', description: 'Topic identifier, e.g. "architecture/overview".' },
+            scope: {
+                type: 'string',
+                description: 'Optional scope (default "global"), e.g. file:<path>, module:<name>.',
+            },
+            content: { type: 'string', description: 'The note text.' },
+            model: { type: 'string', description: 'Model identifier that authored the note.' },
+            source_hash: {
+                type: 'string',
+                description: 'Optional source hash used for staleness detection.',
+            },
+        },
+        required: ['key', 'content'],
+    },
+};
+export const kbNotesReadToolDef = {
+    name: 'kb_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: {
+        type: 'object',
+        properties: {
+            key: { type: 'string', description: 'Exact key match.' },
+            key_prefix: { type: 'string', description: 'Prefix match (e.g. "architecture/").' },
+            scope: { type: 'string', description: 'Optional scope filter.' },
+            limit: { type: 'number', description: 'Max notes to return (default 20, max 200).' },
+        },
+        required: [],
+    },
+};
+function normalizeScope(scope) {
+    const normalized = scope?.trim();
+    return normalized ? normalized : DEFAULT_SCOPE;
+}
+function clampLimit(limit) {
+    if (limit == null)
+        return DEFAULT_LIMIT;
+    return Math.min(Math.max(1, Math.floor(limit)), MAX_LIMIT);
+}
+export function kbNotesWriteHandler(dbPath, args) {
+    const db = new Database(dbPath);
+    try {
+        db.pragma('foreign_keys = ON');
+        const scope = normalizeScope(args.scope);
+        const model = args.model ?? '';
+        const sourceHash = args.source_hash ?? null;
+        db.prepare(`INSERT INTO notes (key, scope, content, model, source_hash, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, unixepoch(), unixepoch())
+       ON CONFLICT(key, scope) DO UPDATE SET
+         content = excluded.content,
+         model = excluded.model,
+         source_hash = excluded.source_hash,
+         updated_at = unixepoch()`).run(args.key, scope, args.content, model, sourceHash);
+        const row = db
+            .prepare('SELECT updated_at FROM notes WHERE key = ? AND scope = ?')
+            .get(args.key, scope);
+        return {
+            ok: true,
+            key: args.key,
+            scope,
+            updated_at: row.updated_at,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+export function kbNotesReadHandler(db, args) {
+    const limit = clampLimit(args.limit);
+    const where = [];
+    const params = [];
+    const key = args.key?.trim();
+    if (key) {
+        where.push('key = ?');
+        params.push(key);
+    }
+    const keyPrefix = args.key_prefix?.trim();
+    if (keyPrefix) {
+        where.push('key LIKE ?');
+        params.push(`${keyPrefix}%`);
+    }
+    const scope = args.scope?.trim();
+    if (scope) {
+        where.push('scope = ?');
+        params.push(scope);
+    }
+    const whereSql = where.length ? `WHERE ${where.join(' AND ')}` : '';
+    const rows = db
+        .prepare(`SELECT key, scope, content, model, source_hash, created_at, updated_at
+       FROM notes
+       ${whereSql}
+       ORDER BY updated_at DESC, id DESC
+       LIMIT ?`)
+        .all(...params, limit);
+    const kbIndexedAtRow = db
+        .prepare('SELECT MAX(indexed_at) AS indexed_at FROM files')
+        .get();
+    const kbIndexedAt = kbIndexedAtRow.indexed_at;
+    const getFileRecency = db.prepare(`SELECT last_hash, indexed_at
+     FROM files
+     WHERE path = ?
+     ORDER BY indexed_at DESC
+     LIMIT 1`);
+    const notes = rows.map((row) => {
+        if (row.scope.startsWith('file:')) {
+            const filePath = row.scope.slice('file:'.length);
+            const fileRow = getFileRecency.get(filePath);
+            let stale = false;
+            let staleReason = null;
+            if (!fileRow) {
+                stale = true;
+                staleReason = 'file_missing';
+            }
+            else if (row.source_hash && fileRow.last_hash && row.source_hash !== fileRow.last_hash) {
+                stale = true;
+                staleReason = 'source_hash_mismatch';
+            }
+            else if (fileRow.indexed_at > row.updated_at) {
+                stale = true;
+                staleReason = 'indexed_after_note';
+            }
+            return {
+                ...row,
+                stale,
+                stale_reason: staleReason,
+                file_last_hash: fileRow?.last_hash ?? null,
+                file_indexed_at: fileRow?.indexed_at ?? null,
+                kb_indexed_at: null,
+            };
+        }
+        if (row.scope === DEFAULT_SCOPE) {
+            const stale = kbIndexedAt != null ? row.updated_at < kbIndexedAt : false;
+            return {
+                ...row,
+                stale,
+                stale_reason: stale ? 'kb_reindexed_since_note' : null,
+                file_last_hash: null,
+                file_indexed_at: null,
+                kb_indexed_at: kbIndexedAt,
+            };
+        }
+        return {
+            ...row,
+            stale: false,
+            stale_reason: null,
+            file_last_hash: null,
+            file_indexed_at: null,
+            kb_indexed_at: null,
+        };
+    });
+    return { notes, count: notes.length };
+}
+export const writeToolDef = kbNotesWriteToolDef;
+export const readToolDef = kbNotesReadToolDef;
+export const writeHandler = kbNotesWriteHandler;
+export const readHandler = kbNotesReadHandler;
+//# sourceMappingURL=notes.js.map

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

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

package/dist/kb-server/tools/routes.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module kb-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 description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly method: {
+                readonly type: "string";
+                readonly description: "Optional HTTP method filter (for example GET, POST).";
+            };
+            readonly path_prefix: {
+                readonly type: "string";
+                readonly description: "Optional route path prefix filter.";
+            };
+            readonly framework: {
+                readonly type: "string";
+                readonly description: "Optional framework filter (for example express, fastapi, gin).";
+            };
+        };
+    };
+};
+export interface RoutesArgs {
+    method?: string;
+    path_prefix?: string;
+    framework?: string;
+}
+export interface RoutesResult {
+    results: ApiRouteRow[];
+}
+export declare function handler(db: Database.Database, args: RoutesArgs): RoutesResult;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/kb-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/tools/routes.js

@@ -0,0 +1,38 @@
+/**
+ * @module kb-server/tools/routes
+ *
+ * MCP tool: query extracted API routes/endpoints.
+ */
+import { listApiRoutes } from '../db.js';
+export const toolDef = {
+    name: 'kb_routes',
+    description: 'Query extracted API routes/endpoints from the knowledge-base index. ' +
+        'Optional filters: `method`, `path_prefix`, and `framework`.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            method: {
+                type: 'string',
+                description: 'Optional HTTP method filter (for example GET, POST).',
+            },
+            path_prefix: {
+                type: 'string',
+                description: 'Optional route path prefix filter.',
+            },
+            framework: {
+                type: 'string',
+                description: 'Optional framework filter (for example express, fastapi, gin).',
+            },
+        },
+    },
+};
+export function handler(db, args) {
+    return {
+        results: listApiRoutes(db, {
+            method: args.method,
+            pathPrefix: args.path_prefix,
+            framework: args.framework,
+        }),
+    };
+}
+//# sourceMappingURL=routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/kb-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,WAAW;IACjB,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/tools/search.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @module kb-server/tools/search
+ *
+ * MCP tool: multi-modal knowledge-base search.
+ *
+ * Modes:
+ *  - "structural"  — BM25 full-text search via FTS5 (symbols_fts).
+ *  - "semantic"    — cosine similarity via sqlite-vec vec0 tables (requires embeddings).
+ *  - "fused"       — Reciprocal Rank Fusion (k=60) combining structural + semantic.
+ *
+ * Semantic and fused modes fall back to structural-only when no EmbeddingProvider
+ * is supplied, clearly indicating the degradation in `mode_used`.
+ */
+import type { Database } from '../db.js';
+import type { EmbeddingProvider } from '../../indexer/embedder.js';
+export declare const toolDef: {
+    readonly name: "kb_search";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query string.";
+            };
+            readonly mode: {
+                readonly type: "string";
+                readonly enum: readonly ["structural", "semantic", "fused"];
+                readonly description: "Search mode (default: \"structural\").";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Maximum number of results to return (default 20).";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+};
+export interface SearchArgs {
+    query: string;
+    mode?: 'structural' | 'semantic' | 'fused';
+    limit?: number;
+    branch?: 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;
+    }>;
+    mode_used: string;
+}
+/** Execute a knowledge-base search in the requested mode. */
+export declare function handler(db: Database.Database, args: SearchArgs, embedder?: EmbeddingProvider): Promise<SearchResult>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/kb-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;AAInE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;CA0BV,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;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AA8HD,6DAA6D;AAC7D,wBAAsB,OAAO,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA4BvB"}

package/dist/kb-server/tools/search.js

@@ -0,0 +1,170 @@
+/**
+ * @module kb-server/tools/search
+ *
+ * MCP tool: multi-modal knowledge-base search.
+ *
+ * Modes:
+ *  - "structural"  — BM25 full-text search via FTS5 (symbols_fts).
+ *  - "semantic"    — cosine similarity via sqlite-vec vec0 tables (requires embeddings).
+ *  - "fused"       — Reciprocal Rank Fusion (k=60) combining structural + semantic.
+ *
+ * Semantic and fused modes fall back to structural-only when no EmbeddingProvider
+ * is supplied, clearly indicating the degradation in `mode_used`.
+ */
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'kb_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). ' +
+        'mode="fused" combines both with Reciprocal Rank Fusion (RRF k=60).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query string.',
+            },
+            mode: {
+                type: 'string',
+                enum: ['structural', 'semantic', 'fused'],
+                description: 'Search mode (default: "structural").',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default 20).',
+            },
+        },
+        required: ['query'],
+    },
+};
+/**
+ * Sanitise a user-provided query string for FTS5 MATCH.
+ *
+ * FTS5 has its own query grammar where characters like `*`, `OR`, `NOT`, `-`,
+ * `^`, `"`, `(`, `)` carry special meaning.  Wrapping the query in escaped
+ * double-quotes forces FTS5 to treat it as a literal phrase, preventing
+ * syntax errors and injection from symbol names like `operator+` or `T*`.
+ */
+function sanitizeFts5Query(query) {
+    // Escape interior double-quotes, then wrap in double-quotes for a phrase query.
+    return `"${query.replace(/"/g, '""')}"`;
+}
+/** 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 = ?' : '';
+    try {
+        const sql = `SELECT s.id AS symbol_id, s.name, s.kind, f.path AS file_path,
+                s.start_line, s.end_line,
+                bm25(symbols_fts) AS score,
+                f.branch AS branch
+           FROM symbols_fts
+           JOIN symbols s ON s.rowid = symbols_fts.rowid
+           JOIN files   f ON f.id   = s.file_id
+          WHERE symbols_fts MATCH ?${branchClause}
+          ORDER BY score
+          LIMIT ?`;
+        const params = branch !== undefined ? [safeQuery, branch, limit] : [safeQuery, limit];
+        const rows = db.prepare(sql).all(...params);
+        return rows;
+    }
+    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,
+                s.start_line, s.end_line,
+                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 ?`;
+        const params = branch !== undefined ? [likeQuery, branch, limit] : [likeQuery, limit];
+        return db.prepare(sql).all(...params);
+    }
+}
+/**
+ * Attempt a semantic (cosine) search via the vec0 virtual table.
+ * Returns `null` when no embedder is available or the table has no rows.
+ */
+async function semanticSearch(db, query, limit, embedder, branch) {
+    try {
+        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);
+        return rows.length > 0 ? rows : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reciprocal Rank Fusion (k=60) over structural and semantic result lists.
+ *
+ * RRF score = Σ 1/(k + rank_i) for each list i where the item appears.
+ * Higher score → better rank.
+ */
+function rrfFuse(structural, semantic, limit) {
+    const k = 60;
+    const scores = new Map();
+    const addList = (list) => {
+        list.forEach((item, idx) => {
+            const existing = scores.get(item.symbol_id);
+            const contrib = 1 / (k + idx + 1);
+            if (existing) {
+                existing.score += contrib;
+            }
+            else {
+                scores.set(item.symbol_id, { item, score: contrib });
+            }
+        });
+    };
+    addList(structural);
+    if (semantic)
+        addList(semantic);
+    return Array.from(scores.values())
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map(({ item, score }) => ({ ...item, score }));
+}
+/** Execute a knowledge-base search in the requested mode. */
+export async function handler(db, args, embedder) {
+    const limit = args.limit ?? 20;
+    const mode = args.mode ?? 'structural';
+    const structural = structuralSearch(db, args.query, limit, args.branch);
+    if (mode === 'structural') {
+        return { results: structural, mode_used: 'structural' };
+    }
+    if (!embedder) {
+        // No query-time embedder available — callers can detect this degradation.
+        return { results: structural, mode_used: 'structural (no query-time embedder)' };
+    }
+    const semantic = await semanticSearch(db, args.query, limit, embedder, args.branch);
+    if (mode === 'semantic') {
+        if (semantic) {
+            return { results: semantic, mode_used: 'semantic' };
+        }
+        return { results: structural, mode_used: 'structural (fallback: no embeddings)' };
+    }
+    // mode === 'fused'
+    const fused = rrfFuse(structural, semantic, limit);
+    const modeUsed = semantic ? 'fused' : 'structural (fallback: no embeddings)';
+    return { results: fused, mode_used: modeUsed };
+}
+//# sourceMappingURL=search.js.map

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

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

package/dist/kb-server/tools/snippet.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module kb-server/tools/snippet
+ *
+ * MCP tool: extract source-code snippets for a given file path and
+ * optional line range directly from the filesystem.
+ */
+import type { Database } from '../db.js';
+export declare const toolDef: {
+    readonly name: "kb_snippet";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly description: "Absolute file path as stored in the knowledge-base index.";
+            };
+            readonly start_line: {
+                readonly type: "number";
+                readonly description: "First line to include (1-based, inclusive).  Defaults to 1.";
+            };
+            readonly end_line: {
+                readonly type: "number";
+                readonly description: "Last line to include (1-based, inclusive).  Defaults to end-of-file.";
+            };
+        };
+        readonly required: readonly ["path"];
+    };
+};
+export interface SnippetArgs {
+    path: string;
+    start_line?: number;
+    end_line?: number;
+    branch?: string;
+}
+export interface SnippetResult {
+    path: string;
+    start_line: number;
+    end_line: number;
+    text: string;
+}
+/** Read source lines from the filesystem for the given indexed file path. */
+export declare function handler(db: Database.Database, args: SnippetArgs): SnippetResult;
+//# sourceMappingURL=snippet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/snippet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;CAwBV,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;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CAiB/E"}

package/dist/kb-server/tools/snippet.js

@@ -0,0 +1,49 @@
+/**
+ * @module kb-server/tools/snippet
+ *
+ * MCP tool: extract source-code snippets for a given file path and
+ * optional line range directly from the filesystem.
+ */
+import { readFileSync } from 'node:fs';
+import { getFileByPath } from '../db.js';
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'kb_snippet',
+    description: 'Return the source lines for a given file path (as recorded in the index). ' +
+        'Optionally restrict the output to a line range using `start_line` and `end_line` ' +
+        '(1-based, inclusive).  Returns the raw source text.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Absolute file path as stored in the knowledge-base index.',
+            },
+            start_line: {
+                type: 'number',
+                description: 'First line to include (1-based, inclusive).  Defaults to 1.',
+            },
+            end_line: {
+                type: 'number',
+                description: 'Last line to include (1-based, inclusive).  Defaults to end-of-file.',
+            },
+        },
+        required: ['path'],
+    },
+};
+/** Read source lines from the filesystem for the given indexed file path. */
+export function handler(db, args) {
+    // Confirm the path is known to the index; use branch to disambiguate if provided.
+    const fileRow = getFileByPath(db, args.path, args.branch);
+    if (!fileRow) {
+        throw new Error(`File not found in index: ${args.path}`);
+    }
+    const raw = readFileSync(args.path, 'utf8');
+    const lines = raw.split('\n');
+    const startLine = Math.max(1, args.start_line ?? 1);
+    const endLine = Math.min(lines.length, args.end_line ?? lines.length);
+    // slice is 0-based; lines are 1-based
+    const text = lines.slice(startLine - 1, endLine).join('\n');
+    return { path: args.path, start_line: startLine, end_line: endLine, text };
+}
+//# sourceMappingURL=snippet.js.map

package/dist/kb-server/tools/snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../../src/kb-server/tools/snippet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,4EAA4E;QAC5E,mFAAmF;QACnF,qDAAqD;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACO,CAAC;AAkBX,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,IAAiB;IAC9D,kFAAkF;IAClF,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtE,sCAAsC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7E,CAAC"}

package/dist/kb-server/tools/test-map.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module kb-server/tools/test-map
+ *
+ * MCP tool: query mapped tests for a source file.
+ */
+import type { Database } from '../db.js';
+export declare const toolDef: {
+    readonly name: "kb_test_map";
+    readonly description: "Return mapped test files (with confidence values) for a given source file path.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly source_path: {
+                readonly type: "string";
+                readonly description: "Source file path to resolve mapped test files for.";
+            };
+            readonly branch: {
+                readonly type: "string";
+                readonly description: "Optional branch to constrain mappings.";
+            };
+        };
+        readonly required: readonly ["source_path"];
+    };
+};
+export interface TestMapArgs {
+    source_path: string;
+    branch?: string;
+}
+export interface TestMapResult {
+    source_path: string;
+    branch: string | null;
+    mappings: Array<{
+        test_path: string;
+        confidence: string;
+    }>;
+}
+export declare function handler(db: Database.Database, args: TestMapArgs): TestMapResult;
+//# sourceMappingURL=test-map.d.ts.map

package/dist/kb-server/tools/test-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-map.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/test-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;CAkBV,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CAM/E"}