codesearch-mcp 0.2.0-alpha → 0.2.1-alpha

package/docs/architecture.svg

@@ -0,0 +1,103 @@
+<svg width="840" height="320" viewBox="0 0 840 320" xmlns="http://www.w3.org/2000/svg" font-family="system-ui,-apple-system,sans-serif">
+  <defs>
+    <marker id="a" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
+      <polygon points="0 0,8 3,0 6" fill="#64748b"/>
+    </marker>
+    <marker id="ad" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
+      <polygon points="0 0,8 3,0 6" fill="#94a3b8"/>
+    </marker>
+  </defs>
+
+  <!-- Background -->
+  <rect width="840" height="320" fill="#f8fafc" rx="12"/>
+
+  <!-- ── INDEXING lane ───────────────────────────────────────────── -->
+  <rect x="12" y="12" width="816" height="128" rx="8" fill="#eff6ff" stroke="#bfdbfe" stroke-width="1"/>
+  <text x="24" y="30" font-size="10" fill="#6b7280" font-weight="700" letter-spacing="1.2">INDEXING</text>
+
+  <!-- Source files -->
+  <rect x="30" y="42" width="104" height="52" rx="6" fill="#fff" stroke="#3b82f6" stroke-width="1.5"/>
+  <text x="82" y="64" font-size="11" text-anchor="middle" fill="#1e40af" font-weight="600">Source files</text>
+  <text x="82" y="80" font-size="10" text-anchor="middle" fill="#94a3b8">.ts · .tsx · .js</text>
+
+  <line x1="134" y1="68" x2="158" y2="68" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- AST parser -->
+  <rect x="160" y="42" width="120" height="52" rx="6" fill="#fff" stroke="#3b82f6" stroke-width="1.5"/>
+  <text x="220" y="64" font-size="11" text-anchor="middle" fill="#1e40af" font-weight="600">AST parser</text>
+  <text x="220" y="80" font-size="10" text-anchor="middle" fill="#94a3b8">symbols · imports</text>
+
+  <line x1="280" y1="68" x2="304" y2="68" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- Chunker -->
+  <rect x="306" y="42" width="110" height="52" rx="6" fill="#fff" stroke="#3b82f6" stroke-width="1.5"/>
+  <text x="361" y="64" font-size="11" text-anchor="middle" fill="#1e40af" font-weight="600">Chunker</text>
+  <text x="361" y="80" font-size="10" text-anchor="middle" fill="#94a3b8">symbol-aligned</text>
+
+  <line x1="416" y1="68" x2="440" y2="68" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- Embedder -->
+  <rect x="442" y="42" width="128" height="52" rx="6" fill="#fff" stroke="#3b82f6" stroke-width="1.5"/>
+  <text x="506" y="61" font-size="11" text-anchor="middle" fill="#1e40af" font-weight="600">Embedder</text>
+  <text x="506" y="76" font-size="10" text-anchor="middle" fill="#94a3b8">Infinity · OpenAI</text>
+  <text x="506" y="89" font-size="10" text-anchor="middle" fill="#94a3b8">Voyage</text>
+
+  <line x1="570" y1="68" x2="610" y2="68" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- PostgreSQL -->
+  <rect x="612" y="36" width="200" height="116" rx="8" fill="#faf5ff" stroke="#7c3aed" stroke-width="1.5"/>
+  <text x="712" y="58" font-size="11" text-anchor="middle" fill="#5b21b6" font-weight="700">PostgreSQL + pgvector</text>
+  <line x1="628" y1="66" x2="796" y2="66" stroke="#c4b5fd" stroke-width="1"/>
+  <text x="712" y="84" font-size="10" text-anchor="middle" fill="#7c3aed">code_chunk  (vectors)</text>
+  <text x="712" y="100" font-size="10" text-anchor="middle" fill="#7c3aed">code_symbol</text>
+  <text x="712" y="116" font-size="10" text-anchor="middle" fill="#7c3aed">code_dependency · code_call</text>
+
+  <!-- AST → DB (graph data) dashed -->
+  <path d="M220 94 Q220 136 612 136" stroke="#94a3b8" stroke-width="1" stroke-dasharray="4,3" fill="none" marker-end="url(#ad)"/>
+  <text x="400" y="150" font-size="10" text-anchor="middle" fill="#94a3b8">symbols · import graph · call graph</text>
+
+  <!-- ── QUERY lane ──────────────────────────────────────────────── -->
+  <rect x="12" y="182" width="816" height="126" rx="8" fill="#f0fdf4" stroke="#bbf7d0" stroke-width="1"/>
+  <text x="24" y="200" font-size="10" fill="#6b7280" font-weight="700" letter-spacing="1.2">QUERY</text>
+
+  <!-- Claude -->
+  <ellipse cx="72" cy="248" rx="52" ry="28" fill="#fff" stroke="#f97316" stroke-width="1.5"/>
+  <text x="72" y="244" font-size="11" text-anchor="middle" fill="#9a3412" font-weight="600">Claude</text>
+  <text x="72" y="259" font-size="10" text-anchor="middle" fill="#94a3b8">AI agent</text>
+
+  <line x1="124" y1="248" x2="152" y2="248" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- rag-mcp -->
+  <rect x="154" y="224" width="110" height="48" rx="6" fill="#fff" stroke="#f97316" stroke-width="1.5"/>
+  <text x="209" y="244" font-size="11" text-anchor="middle" fill="#9a3412" font-weight="600">rag-mcp</text>
+  <text x="209" y="260" font-size="10" text-anchor="middle" fill="#94a3b8">MCP server</text>
+
+  <line x1="264" y1="248" x2="292" y2="248" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- Embed query -->
+  <rect x="294" y="224" width="110" height="48" rx="6" fill="#fff" stroke="#22c55e" stroke-width="1.5"/>
+  <text x="349" y="244" font-size="11" text-anchor="middle" fill="#166534" font-weight="600">Embed query</text>
+  <text x="349" y="260" font-size="10" text-anchor="middle" fill="#94a3b8">query vector</text>
+
+  <line x1="404" y1="248" x2="432" y2="248" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- HNSW search -->
+  <rect x="434" y="224" width="118" height="48" rx="6" fill="#fff" stroke="#22c55e" stroke-width="1.5"/>
+  <text x="493" y="244" font-size="11" text-anchor="middle" fill="#166534" font-weight="600">HNSW search</text>
+  <text x="493" y="260" font-size="10" text-anchor="middle" fill="#94a3b8">cosine distance</text>
+
+  <!-- DB → HNSW dashed -->
+  <line x1="712" y1="152" x2="712" y2="178" stroke="#94a3b8" stroke-width="1" stroke-dasharray="4,3"/>
+  <line x1="712" y1="178" x2="550" y2="224" stroke="#94a3b8" stroke-width="1" stroke-dasharray="4,3" marker-end="url(#ad)"/>
+
+  <line x1="552" y1="248" x2="580" y2="248" stroke="#64748b" stroke-width="1.5" marker-end="url(#a)"/>
+
+  <!-- Reranker -->
+  <rect x="582" y="224" width="118" height="48" rx="6" fill="#fff" stroke="#22c55e" stroke-width="1.5"/>
+  <text x="641" y="244" font-size="11" text-anchor="middle" fill="#166534" font-weight="600">Reranker</text>
+  <text x="641" y="260" font-size="10" text-anchor="middle" fill="#94a3b8">cross-encoder</text>
+
+  <!-- Reranker → Claude return arc -->
+  <path d="M700 262 Q760 296 720 296 Q440 296 140 296 Q114 296 72 276" stroke="#64748b" stroke-width="1.5" fill="none" marker-end="url(#a)"/>
+  <text x="430" y="309" font-size="10" text-anchor="middle" fill="#94a3b8">top results + symbol breadcrumbs</text>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesearch-mcp",
-  "version": "0.2.0-alpha",
+  "version": "0.2.1-alpha",
   "description": "Local semantic codebase search via MCP — indexes projects into pgvector, exposes search to Claude",
   "license": "MIT",
   "keywords": [
@@ -42,7 +42,6 @@
     "start:web": "ts-node app.ts web",
     "index:workspace": "ts-node app.ts index",
     "index:reindex": "ts-node app.ts index --reindex",
-    "index:backfill": "ts-node app.ts backfill",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",

package/dist/src/commands/BackfillCommand.d.ts

@@ -1,7 +0,0 @@
-import type { Container } from '../container';
-import type { ICommand } from './ICommand';
-export declare class BackfillCommand implements ICommand {
-    private container;
-    constructor(container: Container);
-    execute(): Promise<void>;
-}

package/dist/src/commands/BackfillCommand.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BackfillCommand = void 0;
-const interrupt_1 = require("../interrupt");
-class BackfillCommand {
-    container;
-    constructor(container) {
-        this.container = container;
-    }
-    async execute() {
-        const { db, indexer } = this.container;
-        await db.initDbWithSchema();
-        const doCalls = process.argv.includes('--calls');
-        const controller = new AbortController();
-        const teardown = (0, interrupt_1.setupInterrupt)(controller);
-        try {
-            if (doCalls) {
-                console.log('Backfilling call graph...\n');
-                const stats = await indexer.backfillCalls(controller.signal);
-                if (controller.signal.aborted)
-                    console.log('\nBackfill interrupted.');
-                console.log(`\nDone. Total: ${stats.total}, Processed: ${stats.processed}, Skipped (not on disk): ${stats.skipped}, Failed: ${stats.failed}`);
-            }
-            else {
-                console.log('Backfilling symbol index...\n');
-                const stats = await indexer.backfillSymbols(controller.signal);
-                if (controller.signal.aborted)
-                    console.log('\nBackfill interrupted.');
-                console.log(`\nDone. Total: ${stats.total}, Processed: ${stats.processed}, Skipped (not on disk): ${stats.skipped}, Failed: ${stats.failed}`);
-            }
-        }
-        finally {
-            teardown();
-        }
-    }
-}
-exports.BackfillCommand = BackfillCommand;