@jafreck/lore 0.1.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-map.js","sourceRoot":"","sources":["../../../src/kb-server/tools/test-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,iFAAiF;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACO,CAAC;AAaX,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,IAAiB;IAC9D,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;QAC3B,QAAQ,EAAE,4BAA4B,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;KAC1E,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * @module kb-server/tools/writeback
+ *
+ * MCP tool: write LLM-generated summaries back to the `symbol_summaries`
+ * table.  Unlike other tools this handler opens a **read-write** DB
+ * connection so it can INSERT/REPLACE rows.
+ */
+export declare const toolDef: {
+    readonly name: "kb_writeback";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly symbol_id: {
+                readonly type: "number";
+                readonly description: "The id of the symbol row to attach the summary to.";
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "The natural-language summary text.";
+            };
+            readonly model: {
+                readonly type: "string";
+                readonly description: "Identifier of the LLM model that produced the summary.";
+            };
+        };
+        readonly required: readonly ["symbol_id", "summary", "model"];
+    };
+};
+export interface WritebackArgs {
+    symbol_id: number;
+    summary: string;
+    model: string;
+    branch?: string;
+}
+export interface WritebackResult {
+    ok: boolean;
+    symbol_id: number;
+}
+/**
+ * Upsert a symbol summary.
+ *
+ * @param dbPath  Absolute path to the knowledge-base SQLite file.
+ *                A **new** read-write connection is opened for each call so
+ *                this function can safely be used alongside read-only handles.
+ * @param args    Tool arguments.
+ */
+export declare function handler(dbPath: string, args: WritebackArgs): WritebackResult;
+//# sourceMappingURL=writeback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../src/kb-server/tools/writeback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;CAwBV,CAAC;AAIX,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAgC5E"}

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

@@ -0,0 +1,68 @@
+/**
+ * @module kb-server/tools/writeback
+ *
+ * MCP tool: write LLM-generated summaries back to the `symbol_summaries`
+ * table.  Unlike other tools this handler opens a **read-write** DB
+ * connection so it can INSERT/REPLACE rows.
+ */
+import Database from 'better-sqlite3';
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'kb_writeback',
+    description: 'Persist an LLM-generated natural-language summary for a symbol back into ' +
+        'the knowledge-base `symbol_summaries` table.  The summary can be retrieved ' +
+        'later via kb_lookup.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            symbol_id: {
+                type: 'number',
+                description: 'The id of the symbol row to attach the summary to.',
+            },
+            summary: {
+                type: 'string',
+                description: 'The natural-language summary text.',
+            },
+            model: {
+                type: 'string',
+                description: 'Identifier of the LLM model that produced the summary.',
+            },
+        },
+        required: ['symbol_id', 'summary', 'model'],
+    },
+};
+/**
+ * Upsert a symbol summary.
+ *
+ * @param dbPath  Absolute path to the knowledge-base SQLite file.
+ *                A **new** read-write connection is opened for each call so
+ *                this function can safely be used alongside read-only handles.
+ * @param args    Tool arguments.
+ */
+export function handler(dbPath, args) {
+    // Open a fresh read-write connection (separate from any read-only handle).
+    const db = new Database(dbPath);
+    try {
+        db.pragma('foreign_keys = ON');
+        // When branch is supplied, verify the symbol belongs to that branch.
+        if (args.branch !== undefined) {
+            const row = db
+                .prepare(`SELECT s.id FROM symbols s
+             JOIN files f ON f.id = s.file_id
+            WHERE s.id = ? AND f.branch = ?`)
+                .get(args.symbol_id, args.branch);
+            if (!row) {
+                throw new Error(`Symbol ${args.symbol_id} not found in branch '${args.branch}'`);
+            }
+        }
+        db
+            .prepare(`INSERT OR REPLACE INTO symbol_summaries (symbol_id, summary, model, created_at)
+         VALUES (?, ?, ?, unixepoch())`)
+            .run(args.symbol_id, args.summary, args.model);
+        return { ok: true, symbol_id: args.symbol_id };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=writeback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.js","sourceRoot":"","sources":["../../../src/kb-server/tools/writeback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,2EAA2E;QAC3E,6EAA6E;QAC7E,sBAAsB;IACxB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;KAC5C;CACO,CAAC;AAgBX;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,IAAmB;IACzD,2EAA2E;IAC3E,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAE/B,qEAAqE;QACrE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CACN;;4CAEkC,CACnC;iBACA,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,SAAS,yBAAyB,IAAI,CAAC,MAAM,GAAG,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,EAAE;aACC,OAAO,CACN;uCAC+B,CAChC;aACA,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@jafreck/lore",
+  "version": "0.1.0",
+  "description": "Language-aware codebase indexer — tree-sitter parsing, symbol extraction, call-graph construction, and optional embeddings for semantic search",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./mcp": {
+      "default": "./dist/kb-server/server.js"
+    }
+  },
+  "bin": {
+    "lore": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jafreck/Lore.git"
+  },
+  "homepage": "https://github.com/jafreck/Lore#readme",
+  "keywords": [
+    "code-indexing",
+    "tree-sitter",
+    "call-graph",
+    "symbol-extraction",
+    "embeddings",
+    "knowledge-base"
+  ],
+  "author": "Jacob Freck",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.6.2",
+    "fast-glob": "^3.3.3",
+    "simple-git": "^3.32.3",
+    "sqlite-vec": "^0.1.6",
+    "tree-sitter": "0.21.1",
+    "tree-sitter-bash": "^0.25.1",
+    "tree-sitter-c": "0.23.2",
+    "tree-sitter-c-sharp": "0.23.1",
+    "tree-sitter-cpp": "0.23.4",
+    "tree-sitter-dart": "^1.0.0",
+    "tree-sitter-elixir": "^0.3.4",
+    "tree-sitter-elm": "^4.5.0",
+    "tree-sitter-go": "0.23.4",
+    "tree-sitter-haskell": "^0.23.1",
+    "tree-sitter-java": "0.23.5",
+    "tree-sitter-javascript": "0.23.1",
+    "tree-sitter-julia": "^0.23.1",
+    "tree-sitter-kotlin": "^0.3.8",
+    "tree-sitter-lua": "^2.1.3",
+    "tree-sitter-objc": "^3.0.2",
+    "tree-sitter-ocaml": "^0.24.2",
+    "tree-sitter-php": "^0.24.2",
+    "tree-sitter-python": "0.23.4",
+    "tree-sitter-ruby": "^0.23.1",
+    "tree-sitter-rust": "0.23.1",
+    "tree-sitter-scala": "^0.24.0",
+    "tree-sitter-swift": "^0.7.1",
+    "tree-sitter-typescript": "0.23.2",
+    "tree-sitter-zig": "^0.2.0",
+    "zod": "^4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22",
+    "@vitest/coverage-v8": "^4.0",
+    "typescript": "^5.9",
+    "vitest": "^4.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}