@jafreck/lore 0.1.0

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

@@ -0,0 +1,47 @@
+/**
+ * @module kb-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';
+export declare const toolDef: {
+    readonly name: "kb_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 description: "Query mode.";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results to return (default 20, max 200).";
+            };
+        };
+        readonly required: readonly ["mode"];
+    };
+};
+export interface HistoryArgs {
+    mode: 'file' | 'commit' | 'author' | 'ref' | 'recent';
+    query?: string;
+    limit?: number;
+}
+export interface CommitWithFiles extends CommitRow {
+    files?: CommitFileRow[];
+    refs?: CommitRefRow[];
+}
+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;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAIlB,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;CAkCV,CAAC;AAIX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IACtD,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,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CA8C/E"}

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

@@ -0,0 +1,91 @@
+/**
+ * @module kb-server/tools/history
+ *
+ * MCP tool: query commit history by file, commit SHA, author, or recency.
+ */
+import { getCommitBySha, listRecentCommits, listCommitsByFile, listCommitsByAuthor, listCommitsByRef, listCommitFiles, listCommitRefs, } from '../db.js';
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'kb_history',
+    description: 'Query git commit history indexed in the knowledge base. ' +
+        'Supports four modes: "file" (commits that touched a file path), ' +
+        '"commit" (look up a commit by full or partial SHA), ' +
+        '"author" (commits by a given author name or email), ' +
+        '"ref" (commits matching branch/tag refs), and ' +
+        '"recent" (most recent commits). ' +
+        'All modes support an optional `limit` parameter (default 20, max 200).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mode: {
+                type: 'string',
+                enum: ['file', 'commit', 'author', 'ref', 'recent'],
+                description: 'Query mode.',
+            },
+            query: {
+                type: 'string',
+                description: 'For mode="file": the file path. ' +
+                    'For mode="commit": full or partial commit SHA. ' +
+                    'For mode="author": author name or email substring. ' +
+                    'For mode="ref": branch/tag ref name or substring (e.g. refs/heads/main, main, v1.2.0). ' +
+                    'Not required for mode="recent".',
+            },
+            limit: {
+                type: 'number',
+                description: 'Max results to return (default 20, max 200).',
+            },
+        },
+        required: ['mode'],
+    },
+};
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 200;
+function clampLimit(limit) {
+    if (limit == null)
+        return DEFAULT_LIMIT;
+    return Math.min(Math.max(1, Math.floor(limit)), MAX_LIMIT);
+}
+/** Handle a kb_history tool invocation against the open read-only database. */
+export function handler(db, args) {
+    const limit = clampLimit(args.limit);
+    switch (args.mode) {
+        case 'file': {
+            const filePath = args.query?.trim() ?? '';
+            const rows = filePath
+                ? listCommitsByFile(db, filePath, limit)
+                : listRecentCommits(db, limit);
+            return { mode: 'file', results: rows, count: rows.length };
+        }
+        case 'commit': {
+            const sha = args.query?.trim() ?? '';
+            if (!sha) {
+                return { mode: 'commit', results: [], count: 0 };
+            }
+            const commit = getCommitBySha(db, sha);
+            if (!commit) {
+                return { mode: 'commit', results: [], count: 0 };
+            }
+            const files = listCommitFiles(db, commit.sha);
+            const refs = listCommitRefs(db, commit.sha);
+            const result = { ...commit, files, refs };
+            return { mode: 'commit', results: [result], count: 1 };
+        }
+        case 'author': {
+            const author = args.query?.trim() ?? '';
+            const rows = author
+                ? listCommitsByAuthor(db, author, limit)
+                : listRecentCommits(db, limit);
+            return { mode: 'author', results: rows, count: rows.length };
+        }
+        case 'ref': {
+            const ref = args.query?.trim() ?? '';
+            const rows = listCommitsByRef(db, ref, limit);
+            return { mode: 'ref', results: rows, count: rows.length };
+        }
+        case 'recent': {
+            const rows = listRecentCommits(db, limit);
+            return { mode: 'recent', results: rows, count: rows.length };
+        }
+    }
+}
+//# sourceMappingURL=history.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * @module kb-server/tools/lookup
+ *
+ * MCP tool: look up symbols by name or files by path.
+ */
+import type { Database } from '../db.js';
+export declare const toolDef: {
+    readonly name: "kb_lookup";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly kind: {
+                readonly type: "string";
+                readonly enum: readonly ["symbol", "file"];
+                readonly description: "Whether to look up a symbol or a file.";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: string;
+            };
+        };
+        readonly required: readonly ["kind", "query"];
+    };
+};
+export interface LookupArgs {
+    kind: 'symbol' | 'file';
+    query: string;
+    branch?: string;
+}
+export interface LookupResult {
+    results: unknown[];
+}
+/** Resolve a lookup request against the open read-only database. */
+export declare function handler(db: Database.Database, args: LookupArgs): LookupResult;
+//# sourceMappingURL=lookup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/lookup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;CAsBV,CAAC;AAIX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAa7E"}

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

@@ -0,0 +1,45 @@
+/**
+ * @module kb-server/tools/lookup
+ *
+ * MCP tool: look up symbols by name or files by path.
+ */
+import { getSymbolsByName, getFileByPath, listSymbols, listFiles } from '../db.js';
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'kb_lookup',
+    description: 'Look up symbols by name or source files by path in the knowledge-base index. ' +
+        'Set `kind` to "symbol" or "file". Returns an array of matching rows.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            kind: {
+                type: 'string',
+                enum: ['symbol', 'file'],
+                description: 'Whether to look up a symbol or a file.',
+            },
+            query: {
+                type: 'string',
+                description: 'For kind="symbol": the symbol name to look up (case-insensitive). ' +
+                    'For kind="file": the exact file path stored in the index.',
+            },
+        },
+        required: ['kind', 'query'],
+    },
+};
+/** Resolve a lookup request against the open read-only database. */
+export function handler(db, args) {
+    if (args.kind === 'symbol') {
+        const rows = args.query.trim()
+            ? getSymbolsByName(db, args.query, args.branch)
+            : listSymbols(db, 20, args.branch);
+        return { results: rows };
+    }
+    else {
+        if (args.query.trim()) {
+            const row = getFileByPath(db, args.query, args.branch);
+            return { results: row ? [row] : [] };
+        }
+        return { results: listFiles(db, 20, args.branch) };
+    }
+}
+//# sourceMappingURL=lookup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../../src/kb-server/tools/lookup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnF,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,+EAA+E;QAC/E,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACxB,WAAW,EAAE,wCAAwC;aACtD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oEAAoE;oBACpE,2DAA2D;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5B;CACO,CAAC;AAcX,oEAAoE;AACpE,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,IAAgB;IAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAC5B,CAAC,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACrD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * @module kb-server/tools/metrics
+ *
+ * MCP tool: return high-level code metrics from the knowledge-base index.
+ */
+import type { Database } from '../db.js';
+export declare const toolDef: {
+    readonly name: "kb_metrics";
+    readonly description: "Return aggregate KB metrics or top symbols by stored complexity.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly mode: {
+                readonly type: "string";
+                readonly enum: readonly ["aggregate", "complexity"];
+                readonly description: "Metrics mode: aggregate counts (default) or complexity-ranked symbols.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max symbols returned for complexity mode (default 20, max 200).";
+            };
+            readonly min_cyclomatic: {
+                readonly type: "number";
+                readonly description: "Minimum cyclomatic score filter for complexity mode (default 0).";
+            };
+        };
+        readonly required: readonly [];
+    };
+};
+export interface MetricsArgs {
+    mode?: 'aggregate' | 'complexity';
+    limit?: number;
+    min_cyclomatic?: number;
+}
+export interface AggregateMetricsResult {
+    symbol_count: number;
+    file_count: number;
+    import_edge_count: number;
+    coverage_available: boolean;
+    coverage_commit: string | null;
+    current_commit: string | null;
+    commits_behind: number;
+    stale: boolean;
+    global_lines_found: number | null;
+    global_lines_hit: number | null;
+    global_coverage_percent: number | null;
+    per_branch: Array<{
+        branch: string;
+        file_count: number;
+        symbol_count: number;
+    }>;
+}
+export interface ComplexitySymbolRow {
+    id: number;
+    file_id: number;
+    name: string;
+    kind: string;
+    start_line: number;
+    end_line: number;
+    signature: string | null;
+    doc_comment: string | null;
+    line_count: number;
+    param_count: number;
+    cyclomatic: number;
+    max_nesting: number;
+}
+export interface ComplexityMetricsResult {
+    symbols: ComplexitySymbolRow[];
+}
+export type MetricsResult = AggregateMetricsResult | ComplexityMetricsResult;
+/** Collect aggregate counts from the knowledge-base tables. */
+export declare function handler(db: Database.Database, args: MetricsArgs): MetricsResult;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;CAuBV,CAAC;AAIX,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAE7E,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CA+D/E"}

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

@@ -0,0 +1,79 @@
+/**
+ * @module kb-server/tools/metrics
+ *
+ * MCP tool: return high-level code metrics from the knowledge-base index.
+ */
+import { getCoverageStaleness, getLatestCoverageTotals } from '../db.js';
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'kb_metrics',
+    description: 'Return aggregate KB metrics or top symbols by stored complexity.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mode: {
+                type: 'string',
+                enum: ['aggregate', 'complexity'],
+                description: 'Metrics mode: aggregate counts (default) or complexity-ranked symbols.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Max symbols returned for complexity mode (default 20, max 200).',
+            },
+            min_cyclomatic: {
+                type: 'number',
+                description: 'Minimum cyclomatic score filter for complexity mode (default 0).',
+            },
+        },
+        required: [],
+    },
+};
+/** Collect aggregate counts from the knowledge-base tables. */
+export function handler(db, args) {
+    if (args.mode === 'complexity') {
+        const minCyclomatic = Math.max(0, args.min_cyclomatic ?? 0);
+        const limit = Math.min(Math.max(1, args.limit ?? 20), 200);
+        const symbols = db
+            .prepare(`SELECT s.*,
+                sm.line_count,
+                sm.param_count,
+                sm.cyclomatic,
+                sm.max_nesting
+           FROM symbol_metrics sm
+           JOIN symbols s ON s.id = sm.symbol_id
+          WHERE sm.cyclomatic >= ?
+          ORDER BY sm.cyclomatic DESC, s.id ASC
+          LIMIT ?`)
+            .all(minCyclomatic, limit);
+        return { symbols };
+    }
+    const symbolCount = db.prepare('SELECT COUNT(*) AS c FROM symbols').get().c;
+    const fileCount = db.prepare('SELECT COUNT(*) AS c FROM files').get().c;
+    const importEdgeCount = db.prepare('SELECT COUNT(*) AS c FROM file_imports').get().c;
+    const perBranch = db
+        .prepare(`SELECT f.branch,
+              COUNT(DISTINCT f.id) AS file_count,
+              COUNT(DISTINCT s.id) AS symbol_count
+         FROM files f
+         LEFT JOIN symbols s ON s.file_id = f.id
+        GROUP BY f.branch
+        ORDER BY f.branch`)
+        .all();
+    const coverageTotals = getLatestCoverageTotals(db);
+    const staleness = getCoverageStaleness(db);
+    return {
+        symbol_count: symbolCount,
+        file_count: fileCount,
+        import_edge_count: importEdgeCount,
+        coverage_available: coverageTotals !== undefined,
+        coverage_commit: staleness.coverage_commit,
+        current_commit: staleness.current_commit,
+        commits_behind: staleness.commits_behind,
+        stale: staleness.stale,
+        global_lines_found: coverageTotals?.lines_found ?? null,
+        global_lines_hit: coverageTotals?.lines_hit ?? null,
+        global_coverage_percent: coverageTotals?.coverage_percent ?? null,
+        per_branch: perBranch,
+    };
+}
+//# sourceMappingURL=metrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/kb-server/tools/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEzE,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;gBACjC,WAAW,EAAE,wEAAwE;aACtF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACO,CAAC;AA8CX,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,IAAiB;IAC9D,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,EAAE;aACf,OAAO,CACN;;;;;;;;;kBASU,CACX;aACA,GAAG,CAAC,aAAa,EAAE,KAAK,CAA0B,CAAC;QAEtD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GACf,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EACpD,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GACb,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAClD,CAAC,CAAC,CAAC;IAEJ,MAAM,eAAe,GACnB,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,EACzD,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GAAG,EAAE;SACjB,OAAO,CACN;;;;;;0BAMoB,CACrB;SACA,GAAG,EAAyE,CAAC;IAEhF,MAAM,cAAc,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAE3C,OAAO;QACL,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,SAAS;QACrB,iBAAiB,EAAE,eAAe;QAClC,kBAAkB,EAAE,cAAc,KAAK,SAAS;QAChD,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,kBAAkB,EAAE,cAAc,EAAE,WAAW,IAAI,IAAI;QACvD,gBAAgB,EAAE,cAAc,EAAE,SAAS,IAAI,IAAI;QACnD,uBAAuB,EAAE,cAAc,EAAE,gBAAgB,IAAI,IAAI;QACjE,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,165 @@
+/**
+ * @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 type { Database as KbDatabase } from '../db.js';
+export declare const kbNotesWriteToolDef: {
+    readonly name: "kb_notes_write";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly key: {
+                readonly type: "string";
+                readonly description: "Topic identifier, e.g. \"architecture/overview\".";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly description: "Optional scope (default \"global\"), e.g. file:<path>, module:<name>.";
+            };
+            readonly content: {
+                readonly type: "string";
+                readonly description: "The note text.";
+            };
+            readonly model: {
+                readonly type: "string";
+                readonly description: "Model identifier that authored the note.";
+            };
+            readonly source_hash: {
+                readonly type: "string";
+                readonly description: "Optional source hash used for staleness detection.";
+            };
+        };
+        readonly required: readonly ["key", "content"];
+    };
+};
+export declare const kbNotesReadToolDef: {
+    readonly name: "kb_notes_read";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly key: {
+                readonly type: "string";
+                readonly description: "Exact key match.";
+            };
+            readonly key_prefix: {
+                readonly type: "string";
+                readonly description: "Prefix match (e.g. \"architecture/\").";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly description: "Optional scope filter.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max notes to return (default 20, max 200).";
+            };
+        };
+        readonly required: readonly [];
+    };
+};
+export interface NotesWriteArgs {
+    key: string;
+    scope?: string;
+    content: string;
+    model?: string;
+    source_hash?: string;
+}
+export interface NotesWriteResult {
+    ok: boolean;
+    key: string;
+    scope: string;
+    updated_at: number;
+}
+interface NoteRow {
+    key: string;
+    scope: string;
+    content: string;
+    model: string;
+    source_hash: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface NotesReadArgs {
+    key?: string;
+    key_prefix?: string;
+    scope?: string;
+    limit?: number;
+}
+export interface NoteWithMetadata extends NoteRow {
+    stale: boolean;
+    stale_reason: 'source_hash_mismatch' | 'file_missing' | 'indexed_after_note' | 'kb_reindexed_since_note' | null;
+    file_last_hash: string | null;
+    file_indexed_at: number | null;
+    kb_indexed_at: number | null;
+}
+export interface NotesReadResult {
+    notes: NoteWithMetadata[];
+    count: number;
+}
+export declare function kbNotesWriteHandler(dbPath: string, args: NotesWriteArgs): NotesWriteResult;
+export declare function kbNotesReadHandler(db: KbDatabase.Database, args: NotesReadArgs): NotesReadResult;
+export declare const writeToolDef: {
+    readonly name: "kb_notes_write";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly key: {
+                readonly type: "string";
+                readonly description: "Topic identifier, e.g. \"architecture/overview\".";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly description: "Optional scope (default \"global\"), e.g. file:<path>, module:<name>.";
+            };
+            readonly content: {
+                readonly type: "string";
+                readonly description: "The note text.";
+            };
+            readonly model: {
+                readonly type: "string";
+                readonly description: "Model identifier that authored the note.";
+            };
+            readonly source_hash: {
+                readonly type: "string";
+                readonly description: "Optional source hash used for staleness detection.";
+            };
+        };
+        readonly required: readonly ["key", "content"];
+    };
+};
+export declare const readToolDef: {
+    readonly name: "kb_notes_read";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly key: {
+                readonly type: "string";
+                readonly description: "Exact key match.";
+            };
+            readonly key_prefix: {
+                readonly type: "string";
+                readonly description: "Prefix match (e.g. \"architecture/\").";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly description: "Optional scope filter.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max notes to return (default 20, max 200).";
+            };
+        };
+        readonly required: readonly [];
+    };
+};
+export declare const writeHandler: typeof kbNotesWriteHandler;
+export declare const readHandler: typeof kbNotesReadHandler;
+export {};
+//# sourceMappingURL=notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/notes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AAMvD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBtB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;CAerB,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,OAAO;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EACR,sBAAsB,GACtB,cAAc,GACd,oBAAoB,GACpB,yBAAyB,GACzB,IAAI,CAAC;IACT,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAgC1F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAkGhG;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,CAAC;AAChD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAAqB,CAAC;AAC9C,eAAO,MAAM,YAAY,4BAAsB,CAAC;AAChD,eAAO,MAAM,WAAW,2BAAqB,CAAC"}