codesearch-mcp 0.0.11-alpha → 0.0.13-alpha

package/dist/app.js

@@ -47,7 +47,7 @@ async function main() {
     const isIndex = argv1 === 'rag-index' || process.argv[2] === 'index';
     const isMcp = argv1 === 'rag-mcp' || process.argv[2] === 'mcp';
     const isSetup = argv1 === 'rag-setup' || process.argv[2] === 'setup';
-    const isBackfill = argv1 === 'rag-index' && process.argv[2] === 'backfill';
+    const isBackfill = (argv1 === 'rag-index' || process.argv[2] === 'backfill') && process.argv[2] === 'backfill';
     const mode = isBackfill ? 'backfill' : isIndex ? 'index' : isMcp ? 'mcp' : isSetup ? 'setup' : (process.argv[2] ?? '');
     if (process.argv.includes('--help') || process.argv.includes('-h')) {
         (0, help_1.printHelp)(argv1 !== 'app.js' ? argv1 : mode);

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

@@ -10,7 +10,7 @@ export interface SymbolEntry {
     project: string;
     filePath: string;
     name: string;
-    kind: 'function' | 'class' | 'interface' | 'type' | 'variable';
+    kind: 'function' | 'class' | 'interface' | 'type' | 'variable' | 'method';
     signature: string | null;
     line: number | null;
     col: number | null;

package/dist/src/services/AstParserService.js

@@ -116,7 +116,8 @@ class AstParserService {
             const resolved = decl.getModuleSpecifierSourceFile();
             if (!resolved) {
                 const specifier = decl.getModuleSpecifierValue();
-                if (specifier.startsWith('.')) {
+                const isCodeImport = !/\.(json|css|scss|less|svg|png|jpg|gif|ico|woff2?|ttf|eot)(\?.*)?$/.test(specifier);
+                if (specifier.startsWith('.') && isCodeImport) {
                     this.logger.debug('AstParser: unresolved import', { specifier, file: filePath });
                 }
                 continue;

package/dist/src/services/IndexerService.js

@@ -80,7 +80,7 @@ class IndexerService {
             }
             try {
                 const { symbols: rawSymbols } = await this.ast.analyzeFile(absPath, serviceName, projectRoot);
-                const symbols = rawSymbols.map(s => ({ ...s, filePath }));
+                const symbols = [...new Map(rawSymbols.map(s => ({ ...s, filePath })).map(s => [`${s.name}:${s.kind}`, s])).values()];
                 await this.db.transaction(async (manager) => {
                     await manager.delete(db_1.CodeSymbol, { project: serviceName, filePath });
                     if (symbols.length > 0) {
@@ -223,7 +223,7 @@ class IndexerService {
                 toFile: path.relative(this.config.workspaceRoot, e.toFile),
             }));
             // normalize symbols: replace absolute filePath with workspace-relative
-            const symbols = rawSymbols.map(s => ({ ...s, filePath: relFilePath }));
+            const symbols = [...new Map(rawSymbols.map(s => ({ ...s, filePath: relFilePath })).map(s => [`${s.name}:${s.kind}`, s])).values()];
             const depsMs = Date.now() - t0;
             const code = fs.readFileSync(filePath, 'utf-8');
             const chunks = await this.getSplitter(filePath).createDocuments([code]);

package/dist/src/services/LoggerService.js

@@ -58,7 +58,21 @@ class LoggerService {
         if (filePath)
             fs.mkdirSync(path.dirname(filePath), { recursive: true });
         const transport = filePath
-            ? pino_1.default.transport({ targets: [{ target: 'pino/file', options: { destination: filePath }, level }] })
+            ? pino_1.default.transport({
+                targets: [{
+                        target: 'pino-roll',
+                        options: {
+                            file: filePath,
+                            frequency: 'daily',
+                            dateFormat: 'yyyy-MM-dd',
+                            mkdir: true,
+                            symlink: true,
+                            limit: { count: 30 },
+                            size: '50m',
+                        },
+                        level,
+                    }],
+            })
             : undefined;
         const logger = transport
             ? (0, pino_1.default)({ level }, transport)

package/dist/src/services/McpServer.js

@@ -58,7 +58,7 @@ You have access to a local semantic code search server. Use these tools to navig
 - **read_file_range** — read a specific line range from any indexed file. Use this to expand context around a search result.
 - **get_dependencies** — show what files a given file imports (direct or transitive). Use to understand what a file depends on.
 - **get_dependents** — show which files import a given file (reverse graph). Use before refactoring to find all callers.
-- **find_symbol** — find where a symbol (function, class, type, interface, variable) is defined by exact name. Faster than semantic search when you know the name.
+- **find_symbol** — find where a symbol (function, class, type, interface, variable, method) is defined by exact name. Faster than semantic search when you know the name.
 - **list_files** — browse the directory tree of a project path. Use to understand project structure before reading files.
 - **read_file** — read a complete file by absolute path with line numbers. Truncates at max_lines with a hint to continue.
 
@@ -68,9 +68,10 @@ You have access to a local semantic code search server. Use these tools to navig
 2. Use \`search_codebase\` to find relevant code by meaning.
 3. If a result looks **truncated or incomplete** (e.g. you see only the middle of a function), call \`read_file_range\` with the returned \`file_path\` and \`start_line\` set to the **Line** number shown in the result. Example: if the result shows **Line:** 150, pass \`start_line: 150\`.
 4. For exploratory searches where you expect results to span chunk boundaries, pass \`include_neighbors: true\` to automatically include the chunk before and after each match.
-5. Use \`find_symbol\` when you know the exact name of a function or class and want its definition location immediately — faster than semantic search.
+5. Use \`find_symbol\` when you know the exact name of a function, class, or method and want its definition location immediately — faster than semantic search. Use \`kind: "method"\` to find public class methods like \`canActivate\`, \`execute\`, \`handle\`.
 6. Use \`list_files\` to explore project structure (src/, components/, etc.) before diving into files.
 7. Use \`read_file\` to read a complete file when you have its absolute path from \`search_codebase\` results.
+8. If \`search_codebase\` returns results that seem off-topic, pass a lower \`threshold\` (e.g. \`0.35\`) to filter out weak semantic matches.
 
 ## When to use read_file_range vs include_neighbors
 
@@ -83,7 +84,7 @@ You have access to a local semantic code search server. Use these tools to navig
 
 ## Relevance scores
 
-Lower score = better match (cosine distance). Results above the configured threshold are filtered out automatically.
+Lower score = better match (cosine distance). Results above the configured threshold are filtered out automatically. Pass \`threshold\` to \`search_codebase\` to override the default per-query (e.g. \`0.35\` for strict matching, \`0.55\` for broader results).
 
 ## Dependency graph
 
@@ -112,6 +113,7 @@ class McpServer {
                             limit: { type: 'number', description: `Max results (default ${this.config.search.defaultLimit}, max ${this.config.search.maxLimit})` },
                             project: { type: 'string', description: 'Filter by project name (optional). Use list_projects to see available names.' },
                             include_neighbors: { type: 'boolean', description: 'Also include the chunk before and after each result from the same file (Small-to-Big retrieval). Useful when results look truncated.' },
+                            threshold: { type: 'number', description: `Max cosine distance (0–1). Lower = stricter. Default: ${this.config.search.similarityThreshold}. Use a lower value (e.g. 0.35) to filter out weak matches.` },
                         },
                         required: ['query'],
                     },
@@ -164,13 +166,13 @@ class McpServer {
                 },
                 {
                     name: 'find_symbol',
-                    description: 'Find TypeScript/JavaScript symbol definitions (functions, classes, types, interfaces, variables) by exact name. Use when you know the symbol name and want its definition location fast.',
+                    description: 'Find TypeScript/JavaScript symbol definitions (functions, classes, types, interfaces, variables, methods) by exact name. Use when you know the symbol name and want its definition location fast.',
                     inputSchema: {
                         type: 'object',
                         properties: {
                             name: { type: 'string', description: 'Exact symbol name (case-sensitive, whole-word match)' },
                             project: { type: 'string', description: 'Limit search to this project (optional). Use list_projects to find names.' },
-                            kind: { type: 'string', enum: ['function', 'class', 'type', 'interface', 'variable', 'all'], description: 'Symbol kind filter. Default: all.' },
+                            kind: { type: 'string', enum: ['function', 'class', 'type', 'interface', 'variable', 'method', 'all'], description: 'Symbol kind filter. Default: all.' },
                         },
                         required: ['name'],
                     },
@@ -232,8 +234,13 @@ class McpServer {
                     const limit = Math.min(Math.max(1, Number(req.params.arguments?.limit) || this.config.search.defaultLimit), this.config.search.maxLimit);
                     const project = req.params.arguments?.project ? String(req.params.arguments.project) : null;
                     const includeNeighbors = Boolean(req.params.arguments?.include_neighbors);
+                    const rawThreshold = req.params.arguments?.threshold;
+                    const parsedThreshold = Number(rawThreshold);
+                    const threshold = rawThreshold != null && !isNaN(parsedThreshold)
+                        ? Math.min(1, Math.max(0, parsedThreshold))
+                        : undefined;
                     const { query, translated } = await this.searcher.prepareQuery(raw);
-                    const results = await this.searcher.searchChunks(query, limit, project);
+                    const results = await this.searcher.searchChunks(query, limit, project, threshold);
                     if (results.length === 0) {
                         return { content: [{ type: 'text', text: 'No relevant results found.' }] };
                     }
@@ -318,7 +325,7 @@ class McpServer {
                     const name = String(req.params.arguments?.name ?? '');
                     const project = req.params.arguments?.project ? String(req.params.arguments.project) : null;
                     const rawKind = req.params.arguments?.kind;
-                    const validKinds = ['function', 'class', 'type', 'interface', 'variable', 'all'];
+                    const validKinds = ['function', 'class', 'type', 'interface', 'variable', 'method', 'all'];
                     const kind = validKinds.includes(rawKind) ? rawKind : 'all';
                     const { hits, truncated } = await this.searcher.findSymbol(name, project, kind);
                     if (hits.length === 0) {

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

@@ -45,7 +45,7 @@ export interface GrepMatch {
     filePath: string;
     line: number;
 }
-export type SymbolKind = 'function' | 'class' | 'type' | 'interface' | 'variable' | 'all';
+export type SymbolKind = 'function' | 'class' | 'type' | 'interface' | 'variable' | 'method' | 'all';
 export interface SymbolHit {
     filePath: string;
     line: number;
@@ -64,7 +64,7 @@ export declare class SearcherService {
         translated: boolean;
     }>;
     listProjects(): Promise<ProjectRow[]>;
-    searchChunks(query: string, limit: number, project: string | null): Promise<SearchResult[]>;
+    searchChunks(query: string, limit: number, project: string | null, threshold?: number): Promise<SearchResult[]>;
     fetchNeighbors(results: SearchResult[]): Promise<NeighborResult[]>;
     getDependencies(filePath: string, project: string, symbol?: string | null, transitive?: boolean): Promise<DependencyRow[]>;
     getDependents(filePath: string, project: string, symbol?: string | null, transitive?: boolean): Promise<DependencyRow[]>;

package/dist/src/services/SearcherService.js

@@ -59,8 +59,11 @@ class SearcherService {
     }
     async prepareQuery(raw) {
         if (this.config.search.autoTranslate && this.isNonEnglish(raw) && this.embedder.translate) {
-            return { query: await this.embedder.translate(raw, this.config.search.translateModel), translated: true };
+            const query = await this.embedder.translate(raw, this.config.search.translateModel);
+            this.logger.debug('SearcherService: prepareQuery', { translated: true, raw: raw.slice(0, 120), query: query.slice(0, 120) });
+            return { query, translated: true };
         }
+        this.logger.debug('SearcherService: prepareQuery', { translated: false, query: raw.slice(0, 120) });
         return { query: raw, translated: false };
     }
     async listProjects() {
@@ -73,25 +76,36 @@ class SearcherService {
             return { ...r, ...(typeof meta === 'object' ? meta : EMPTY_META) };
         });
     }
-    async searchChunks(query, limit, project) {
+    async searchChunks(query, limit, project, threshold) {
+        const effectiveThreshold = threshold ?? this.config.search.similarityThreshold;
+        this.logger.debug('SearcherService: searchChunks', {
+            query: query.slice(0, 120), limit, project, threshold: effectiveThreshold,
+        });
         const embedding = await this.embedder.embed(query);
-        const params = [`[${embedding}]`, this.config.search.similarityThreshold, limit];
+        const params = [`[${embedding}]`, effectiveThreshold, limit];
         let projectFilter = '';
         if (project) {
             params.push(project);
             projectFilter = `AND "serviceName" = $${params.length}`;
         }
-        return this.db.query(`SELECT "serviceName", "filePath", "startLine", content,
+        const results = await this.db.query(`SELECT "serviceName", "filePath", "startLine", content,
               ROUND((embedding <=> $1)::numeric, 4)::float8 AS score
        FROM code_chunk
        WHERE embedding <=> $1 < $2
        ${projectFilter}
        ORDER BY embedding <=> $1
        LIMIT $3`, params);
+        this.logger.debug('SearcherService: searchChunks results', {
+            count: results.length,
+            scores: results.map(r => r.score),
+            files: results.map(r => r.filePath),
+        });
+        return results;
     }
     async fetchNeighbors(results) {
         if (results.length === 0)
             return [];
+        this.logger.debug('SearcherService: fetchNeighbors', { count: results.length });
         const values = results.map((_, i) => `(${i}, $${i * 2 + 1}, $${i * 2 + 2}::int)`).join(',');
         const params = results.flatMap(r => [r.filePath, r.startLine]);
         const rows = await this.db.query(`SELECT r.idx,
@@ -109,13 +123,19 @@ class SearcherService {
          ORDER BY "startLine" ASC LIMIT 1
        ) next ON true
        ORDER BY r.idx`, params);
-        return rows.map((row, i) => ({
+        const neighbors = rows.map((row, i) => ({
             result: results[i],
             prevChunk: row.prev_fp ? { serviceName: row.prev_sn, filePath: row.prev_fp, startLine: row.prev_sl, content: row.prev_c } : null,
             nextChunk: row.next_fp ? { serviceName: row.next_sn, filePath: row.next_fp, startLine: row.next_sl, content: row.next_c } : null,
         }));
+        this.logger.debug('SearcherService: fetchNeighbors results', {
+            withPrev: neighbors.filter(n => n.prevChunk).length,
+            withNext: neighbors.filter(n => n.nextChunk).length,
+        });
+        return neighbors;
     }
     async getDependencies(filePath, project, symbol = null, transitive = false) {
+        this.logger.debug('SearcherService: getDependencies', { filePath, project, symbol, transitive });
         const params = [filePath, project];
         let symbolFilter = '';
         if (symbol) {
@@ -127,8 +147,10 @@ class SearcherService {
        WHERE "fromFile" = $1 AND project = $2
        ${symbolFilter}
        ORDER BY "toFile"`, params);
-        if (!transitive)
+        if (!transitive) {
+            this.logger.debug('SearcherService: getDependencies result', { direct: direct.length });
             return direct;
+        }
         const indirect = await this.db.query(`WITH RECURSIVE deps AS (
          SELECT "toFile", 1 AS depth, "toFile" AS via
          FROM code_dependency
@@ -151,9 +173,11 @@ class SearcherService {
        WHERE depth > 1
        GROUP BY "toFile"
        ORDER BY MIN(depth), "toFile"`, [filePath, project]);
+        this.logger.debug('SearcherService: getDependencies result', { direct: direct.length, indirect: indirect.length });
         return [...direct, ...indirect];
     }
     async getDependents(filePath, project, symbol = null, transitive = false) {
+        this.logger.debug('SearcherService: getDependents', { filePath, project, symbol, transitive });
         const params = [filePath, project];
         let symbolFilter = '';
         if (symbol) {
@@ -165,8 +189,10 @@ class SearcherService {
        WHERE "toFile" = $1 AND project = $2
        ${symbolFilter}
        ORDER BY "fromFile"`, params);
-        if (!transitive)
+        if (!transitive) {
+            this.logger.debug('SearcherService: getDependents result', { direct: direct.length });
             return direct;
+        }
         const indirect = await this.db.query(`WITH RECURSIVE rdeps AS (
          SELECT "fromFile", 1 AS depth, "fromFile" AS via
          FROM code_dependency
@@ -189,9 +215,11 @@ class SearcherService {
        WHERE depth > 1
        GROUP BY "fromFile"
        ORDER BY MIN(depth), "fromFile"`, [filePath, project]);
+        this.logger.debug('SearcherService: getDependents result', { direct: direct.length, indirect: indirect.length });
         return [...direct, ...indirect];
     }
     grepSymbol(symbol, project, excludeFile) {
+        this.logger.debug('SearcherService: grepSymbol', { symbol, project, excludeFile });
         const projectDir = path.join(this.config.workspaceRoot, project);
         const result = (0, child_process_1.spawnSync)('grep', [
             '-rn', '-F', '-w',
@@ -216,16 +244,21 @@ class SearcherService {
                 return [];
             return [{ filePath: path.relative(this.config.workspaceRoot, absFile), line: parseInt(lineNum, 10) }];
         });
-        return { matches: all.slice(0, GREP_MAX_RESULTS), truncated: all.length > GREP_MAX_RESULTS };
+        const truncated = all.length > GREP_MAX_RESULTS;
+        this.logger.debug('SearcherService: grepSymbol result', { matches: Math.min(all.length, GREP_MAX_RESULTS), truncated });
+        return { matches: all.slice(0, GREP_MAX_RESULTS), truncated };
     }
     // Sync wrapper: validates name (throws synchronously), then returns Promise.
-    // Falls back to grep when the symbol index (code_symbol table) is unavailable.
+    // Methods are never indexed — always resolved via grep. Other kinds use index with grep fallback.
     findSymbol(name, project, kind) {
         if (!/^[\w$]+$/.test(name))
             throw new Error('Invalid symbol name');
+        if (kind === 'method')
+            return Promise.resolve(this.grepFindSymbol(name, project, kind));
         return this.findSymbolFromIndex(name, project, kind);
     }
     async findSymbolFromIndex(name, project, kind) {
+        this.logger.debug('SearcherService: findSymbol', { name, project, kind, source: 'index' });
         try {
             const params = [name];
             let projectFilter = '';
@@ -252,6 +285,7 @@ class SearcherService {
                 kind: row.kind,
                 signature: row.signature ?? row.name,
             }));
+            this.logger.debug('SearcherService: findSymbol result', { source: 'index', hits: hits.length, truncated });
             return { hits, truncated };
         }
         catch {
@@ -260,6 +294,7 @@ class SearcherService {
         }
     }
     grepFindSymbol(name, project, kind) {
+        this.logger.debug('SearcherService: findSymbol', { name, project, kind, source: 'grep' });
         const searchDir = project
             ? path.join(this.config.workspaceRoot, project)
             : this.config.workspaceRoot;
@@ -300,9 +335,11 @@ class SearcherService {
                 signature: matchedLine.trim(),
             });
         }
+        this.logger.debug('SearcherService: findSymbol result', { source: 'grep', hits: hits.length, truncated: hits.length >= FIND_SYMBOL_LIMIT });
         return { hits, truncated: hits.length >= FIND_SYMBOL_LIMIT };
     }
     listFiles(relativePath, project, depth, pattern) {
+        this.logger.debug('SearcherService: listFiles', { relativePath, project, depth, pattern });
         const projectRoot = path.join(this.config.workspaceRoot, project);
         const resolvedTarget = path.resolve(projectRoot, relativePath);
         const resolvedProject = path.resolve(projectRoot);
@@ -318,12 +355,14 @@ class SearcherService {
         const clampedDepth = Math.min(5, Math.max(1, depth));
         const lines = [];
         this.walkDir(resolvedTarget, 0, clampedDepth - 1, pattern, lines);
+        this.logger.debug('SearcherService: listFiles result', { entries: lines.length });
         if (lines.length === 0) {
             return { tree: pattern ? `No files matching "${pattern}" found.` : '(empty directory)' };
         }
         return { tree: lines.join('\n') };
     }
     async readFileAbsolute(absPath, maxLines) {
+        this.logger.debug('SearcherService: readFileAbsolute', { absPath, maxLines });
         const resolvedRoot = path.resolve(this.config.workspaceRoot);
         const resolved = path.resolve(absPath);
         if (resolved !== resolvedRoot && !resolved.startsWith(resolvedRoot + path.sep)) {
@@ -356,9 +395,11 @@ class SearcherService {
             throw err;
         }
         const relPath = path.relative(resolvedRoot, resolved);
+        this.logger.debug('SearcherService: readFileAbsolute result', { linesRead: lines.length, hasMore });
         return { ok: true, filePath: relPath, startLine: 1, endLine: lines.length, lines, hasMore };
     }
     async readFileRange(filePath, startLine, endLine) {
+        this.logger.debug('SearcherService: readFileRange', { filePath, startLine, endLine });
         const resolvedRoot = path.resolve(this.config.workspaceRoot);
         const absPath = path.resolve(resolvedRoot, filePath);
         if (absPath !== resolvedRoot && !absPath.startsWith(resolvedRoot + path.sep)) {
@@ -388,6 +429,7 @@ class SearcherService {
                 break;
             }
         }
+        this.logger.debug('SearcherService: readFileRange result', { linesRead: lines.length, hasMore });
         return { ok: true, filePath, startLine, endLine: Math.min(endLine, lastRead), lines, hasMore };
     }
     isNonEnglish(text) {
@@ -432,6 +474,7 @@ class SearcherService {
             type: `(export[[:space:]]+)?type[[:space:]]+${name}[[:space:]=<]`,
             interface: `(export[[:space:]]+)?interface[[:space:]]+${name}[[:space:]{<]`,
             variable: `(export[[:space:]]+)?(const|let|var)[[:space:]]+${name}[[:space:]=:]`,
+            method: `(public[[:space:]]+|async[[:space:]]+|static[[:space:]]+|override[[:space:]]+)+(async[[:space:]]+)?${name}[[:space:]]*[(<]`,
         };
         if (kind === 'all')
             return Object.values(patterns).join('|');
@@ -447,6 +490,8 @@ class SearcherService {
             return 'interface';
         if (/\btype\s+$/.test(before))
             return 'type';
+        if (/\b(public|async|static|override)\s+$/.test(before))
+            return 'method';
         return 'variable';
     }
 }

package/docker/docker-compose.yml

@@ -1,3 +1,5 @@
+name: codesearch-mcp
+
 services:
   db:
     image: pgvector/pgvector:pg17
@@ -8,7 +10,7 @@ services:
     ports:
       - "5433:5432"
     volumes:
-      - ${HOME}/.local/share/codesearch-mcp/pgdata:/var/lib/postgresql/data
+      - pgdata:/var/lib/postgresql/data
 
   ollama:
     image: ollama/ollama
@@ -18,4 +20,5 @@ services:
       - ollama_data:/root/.ollama
 
 volumes:
+  pgdata:
   ollama_data:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesearch-mcp",
-  "version": "0.0.11-alpha",
+  "version": "0.0.13-alpha",
   "description": "Local semantic codebase search via MCP — indexes projects into pgvector, exposes search to Claude",
   "license": "MIT",
   "main": "dist/app.js",
@@ -21,9 +21,11 @@
     "start:mcp": "ts-node app.ts mcp",
     "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"
+    "test:watch": "vitest",
+    "verify": "tsc --noEmit && vitest run"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.1",
@@ -35,6 +37,7 @@
     "ollama": "^0.5.0",
     "pg": "^8.13.0",
     "pino": "^10.3.1",
+    "pino-roll": "^4.0.0",
     "reflect-metadata": "^0.2.2",
     "ts-morph": "^28.0.0",
     "typeorm": "^0.3.20",