codesearch-mcp 0.0.14-alpha → 0.0.16-alpha

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [0.0.16-alpha] - 2026-05-02
+
+### Added
+
+- **Hybrid incremental indexing (mtime + SHA-256)** — `rag-index` now uses a two-step skip check per file: fast `mtime` comparison first (no file read), then SHA-256 content hash if `mtime` changed. Files with identical content but reset timestamps (after `git clone`, DB transfer, or `touch`) are skipped without re-embedding. `lastModified` is refreshed in a single batch SQL `UPDATE` after each project scan. `--reindex` clears both fields.
+- `contentHash varchar(64)` column added to `code_chunk`; applied automatically via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS` on startup — no manual migration needed.
+
+### Changed
+
+- **Migrated from TypeORM to Drizzle ORM**
+- **Batch AST parsing (`analyzeProject`)** — `IndexerService` now parses all project files in a single `MorphProject` instance instead of one per file, reducing ts-morph overhead on large projects
+- **Enriched embedding context** — chunks now include `[Symbols: class Foo, function bar]` tag when the chunk overlaps known symbol definitions, improving semantic search quality for partial/truncated chunks. **Requires full re-index** (`rag-index /path --reindex`) — existing embeddings were built without symbol context and will produce degraded similarity scores against new chunks if mixed.
+- **`endLine` added to `SymbolEntry`** — enables accurate chunk-to-symbol overlap detection used by enriched prompts
+- **`analyzeProject` error isolation** — parse failures are caught per-file; one broken file no longer aborts the entire project scan
+- **Memory cleanup in `analyzeProject`** — source files are explicitly removed from `MorphProject` after parsing to release memory
+- **Logging improvements** — `AstParser: analyzeProject done` debug log reports total files, parsed count, and elapsed ms; per-file `depsMs` renamed to `astMs` (now ~0 since AST work is done upfront)
+
+## [0.0.15-alpha] - 2026-05-02
+
+### Changed
+
+- **MCP server instructions restructured** — `Step 0` (query classification table) moved before the `Tools` list so it arrives before the truncation threshold and is always visible to the model
+- **Lookup workflow fixed** — corrected order to `find_symbol` first (faster, exact match), `search_codebase` as fallback
+- **Path distinction clarified** — `read_file_range` (relative path) and `read_file` (absolute path) now labelled directly in the Tools list, reducing wrong-path errors
+- **Threshold contradiction resolved** — removed conflicting `0.35` example from Lookup/Conceptual workflow; canonical threshold guidance kept only in Relevance scores section

package/README.md

@@ -6,6 +6,8 @@ Ask Claude things like *"where is the payment retry logic?"* or *"show me how au
 
 > **Alpha** — works well locally, API may change before 1.0.
 
+See [CHANGELOG.md](./CHANGELOG.md) for version history.
+
 ## How it works
 
 1. `rag-index` scans your projects, chunks source files, embeds them with [bge-m3](https://huggingface.co/BAAI/bge-m3) via Ollama, and stores vectors in PostgreSQL

package/dist/src/db/index.d.ts

@@ -1,3 +1,2 @@
-export { CodeChunk } from './entities/code-chunk.entity';
-export { CodeDependency } from './entities/code-dependency.entity';
-export { CodeSymbol } from './entities/code-symbol.entity';
+export { codeChunk, codeDependency, codeSymbol } from './schema';
+export type { CodeChunkInsert } from './schema';

package/dist/src/db/index.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodeSymbol = exports.CodeDependency = exports.CodeChunk = void 0;
-var code_chunk_entity_1 = require("./entities/code-chunk.entity");
-Object.defineProperty(exports, "CodeChunk", { enumerable: true, get: function () { return code_chunk_entity_1.CodeChunk; } });
-var code_dependency_entity_1 = require("./entities/code-dependency.entity");
-Object.defineProperty(exports, "CodeDependency", { enumerable: true, get: function () { return code_dependency_entity_1.CodeDependency; } });
-var code_symbol_entity_1 = require("./entities/code-symbol.entity");
-Object.defineProperty(exports, "CodeSymbol", { enumerable: true, get: function () { return code_symbol_entity_1.CodeSymbol; } });
+exports.codeSymbol = exports.codeDependency = exports.codeChunk = void 0;
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "codeChunk", { enumerable: true, get: function () { return schema_1.codeChunk; } });
+Object.defineProperty(exports, "codeDependency", { enumerable: true, get: function () { return schema_1.codeDependency; } });
+Object.defineProperty(exports, "codeSymbol", { enumerable: true, get: function () { return schema_1.codeSymbol; } });

package/dist/src/db/schema.d.ts

@@ -0,0 +1,417 @@
+export declare const codeChunk: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "code_chunk";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "code_chunk";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        serviceName: import("drizzle-orm/pg-core").PgColumn<{
+            name: "serviceName";
+            tableName: "code_chunk";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        filePath: import("drizzle-orm/pg-core").PgColumn<{
+            name: "filePath";
+            tableName: "code_chunk";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        startLine: import("drizzle-orm/pg-core").PgColumn<{
+            name: "startLine";
+            tableName: "code_chunk";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        content: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content";
+            tableName: "code_chunk";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        embedding: import("drizzle-orm/pg-core").PgColumn<{
+            name: "embedding";
+            tableName: "code_chunk";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: string;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            pgColumnBuilderBrand: "PgCustomColumnBuilderBrand";
+        }>;
+        lastModified: import("drizzle-orm/pg-core").PgColumn<{
+            name: "lastModified";
+            tableName: "code_chunk";
+            dataType: "number";
+            columnType: "PgDoublePrecision";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        contentHash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "contentHash";
+            tableName: "code_chunk";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 64;
+        }>;
+    };
+    dialect: "pg";
+}>;
+export declare const codeDependency: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "code_dependency";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        project: import("drizzle-orm/pg-core").PgColumn<{
+            name: "project";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fromFile: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fromFile";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fromSymbol: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fromSymbol";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toFile: import("drizzle-orm/pg-core").PgColumn<{
+            name: "toFile";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toSymbol: import("drizzle-orm/pg-core").PgColumn<{
+            name: "toSymbol";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        depType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "depType";
+            tableName: "code_dependency";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const codeSymbol: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "code_symbol";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "code_symbol";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        project: import("drizzle-orm/pg-core").PgColumn<{
+            name: "project";
+            tableName: "code_symbol";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        filePath: import("drizzle-orm/pg-core").PgColumn<{
+            name: "filePath";
+            tableName: "code_symbol";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/pg-core").PgColumn<{
+            name: "name";
+            tableName: "code_symbol";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kind";
+            tableName: "code_symbol";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        signature: import("drizzle-orm/pg-core").PgColumn<{
+            name: "signature";
+            tableName: "code_symbol";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        line: import("drizzle-orm/pg-core").PgColumn<{
+            name: "line";
+            tableName: "code_symbol";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        col: import("drizzle-orm/pg-core").PgColumn<{
+            name: "col";
+            tableName: "code_symbol";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type CodeChunkInsert = typeof codeChunk.$inferInsert;

package/dist/src/db/schema.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codeSymbol = exports.codeDependency = exports.codeChunk = void 0;
+const pg_core_1 = require("drizzle-orm/pg-core");
+const vector = (0, pg_core_1.customType)({
+    dataType(config) { return `vector(${config?.dimensions ?? 1024})`; },
+});
+exports.codeChunk = (0, pg_core_1.pgTable)('code_chunk', {
+    id: (0, pg_core_1.uuid)('id').primaryKey().defaultRandom(),
+    serviceName: (0, pg_core_1.text)('serviceName').notNull(),
+    filePath: (0, pg_core_1.text)('filePath').notNull(),
+    startLine: (0, pg_core_1.integer)('startLine'),
+    content: (0, pg_core_1.text)('content').notNull(),
+    embedding: vector('embedding', { dimensions: 1024 }).notNull(),
+    lastModified: (0, pg_core_1.doublePrecision)('lastModified'),
+    contentHash: (0, pg_core_1.varchar)('contentHash', { length: 64 }),
+});
+exports.codeDependency = (0, pg_core_1.pgTable)('code_dependency', {
+    id: (0, pg_core_1.uuid)('id').primaryKey().defaultRandom(),
+    project: (0, pg_core_1.text)('project').notNull(),
+    fromFile: (0, pg_core_1.text)('fromFile').notNull(),
+    fromSymbol: (0, pg_core_1.text)('fromSymbol'),
+    toFile: (0, pg_core_1.text)('toFile').notNull(),
+    toSymbol: (0, pg_core_1.text)('toSymbol'),
+    depType: (0, pg_core_1.text)('depType').notNull(),
+});
+exports.codeSymbol = (0, pg_core_1.pgTable)('code_symbol', {
+    id: (0, pg_core_1.uuid)('id').primaryKey().defaultRandom(),
+    project: (0, pg_core_1.text)('project').notNull(),
+    filePath: (0, pg_core_1.text)('filePath').notNull(),
+    name: (0, pg_core_1.text)('name').notNull(),
+    kind: (0, pg_core_1.text)('kind').notNull(),
+    signature: (0, pg_core_1.text)('signature'),
+    line: (0, pg_core_1.integer)('line'),
+    col: (0, pg_core_1.integer)('col'),
+});

package/dist/src/interfaces/IAstParser.d.ts

@@ -13,6 +13,7 @@ export interface SymbolEntry {
     kind: 'function' | 'class' | 'interface' | 'type' | 'variable' | 'method';
     signature: string | null;
     line: number | null;
+    endLine: number | null;
     col: number | null;
 }
 export interface FileAnalysis {
@@ -20,5 +21,10 @@ export interface FileAnalysis {
     symbols: SymbolEntry[];
 }
 export interface IAstParser {
+    /**
+     * @deprecated Use analyzeProject instead for project-wide context.
+     */
     analyzeFile(filePath: string, serviceName: string, projectRoot?: string): Promise<FileAnalysis>;
+    analyzeProject(filePaths: string[], serviceName: string, projectRoot?: string): Promise<Map<string, FileAnalysis>>;
+    clearCache(projectRoot?: string): void;
 }

package/dist/src/services/AstParserService.d.ts

@@ -4,8 +4,11 @@ export declare class AstParserService implements IAstParser {
     private logger;
     private morphProjects;
     constructor(logger?: LoggerService);
+    analyzeProject(filePaths: string[], serviceName: string, projectRoot?: string): Promise<Map<string, FileAnalysis>>;
+    clearCache(projectRoot?: string): void;
     analyzeFile(filePath: string, serviceName: string, projectRoot?: string): Promise<FileAnalysis>;
     extractImportEdges(filePath: string, serviceName: string, projectRoot?: string): Promise<DepEdge[]>;
+    private createMorphProject;
     private getMorphProject;
     private extractEdges;
     private resolveFromSymbol;