purecontext-mcp 1.0.1

package/dist/server/tools/search-semantic.js

@@ -0,0 +1,187 @@
+/**
+ * search_semantic tool — dedicated semantic / hybrid symbol search.
+ *
+ * Uses the Phase 11 HybridSearcher (RRF fusion of FTS5 + HNSW) for repos that
+ * have been semantically indexed.  Returns structured results with per-result
+ * keyword, semantic, and combined scores, plus timing metadata.
+ *
+ * Modes:
+ *   'hybrid'   — RRF-fused FTS5 + HNSW (default)
+ *   'semantic' — HNSW vector search only (keyword_weight implicitly 0)
+ *
+ * Requires a semantic index (embeddings stored in DB). Returns an error when no
+ * embeddings exist for the repo — use search_symbols for keyword-only search.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { countEmbeddings } from '../../core/db/embedding-store.js';
+import { getFileSizesBatch } from '../../core/db/file-store.js';
+import { getConfig } from '../../config/config-loader.js';
+import { computeRepoId } from '../../core/index-manager.js';
+import { createEmbeddingProvider } from '../../semantic/embedding-provider.js';
+import { VectorStore } from '../../semantic/vector-store.js';
+import { HybridSearcher } from '../../semantic/hybrid-search.js';
+import { buildMeta } from './_meta.js';
+import { logger } from '../../core/logger.js';
+export const name = 'search_semantic';
+export const description = 'Search for symbols using natural language with semantic (vector) and hybrid (semantic + keyword) ' +
+    'modes. Requires a semantic index — use index_folder with an embedding provider configured. ' +
+    'Returns results ranked by combined relevance score with per-result keyword, semantic, and ' +
+    'combined scores. Falls back to an error when no semantic index exists for the repo.';
+export const inputSchema = {
+    repo: z.string().describe('Repo ID (16-char hex) or absolute path to the project root'),
+    query: z.string().describe('Natural language query describing what to find'),
+    mode: z
+        .enum(['semantic', 'hybrid'])
+        .optional()
+        .describe("Search mode: 'hybrid' (semantic + keyword RRF fusion, default) or 'semantic' (vector only)"),
+    semantic_weight: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Weight for semantic score in hybrid mode (default 0.5)'),
+    keyword_weight: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Weight for keyword score in hybrid mode (default 0.5)'),
+    max_results: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Maximum results to return (default 10)'),
+    kind: z
+        .enum([
+        'function', 'class', 'method', 'const', 'type', 'interface', 'enum',
+        'component', 'composable', 'hook', 'route', 'decorator', 'middleware',
+    ])
+        .optional()
+        .describe('Filter by symbol kind'),
+    file_pattern: z
+        .string()
+        .optional()
+        .describe('Filter results to files whose path contains this substring'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    // ── Resolve repo ID ──────────────────────────────────────────────────────────
+    const repoId = args.repo.length === 16 && /^[0-9a-f]+$/.test(args.repo)
+        ? args.repo
+        : computeRepoId(args.repo);
+    const db = openDatabase(repoId);
+    try {
+        const repo = getRepo(db, repoId);
+        if (!repo) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: `Repo not found: ${args.repo}` }) }],
+                isError: true,
+            };
+        }
+        // ── Require semantic index ───────────────────────────────────────────────
+        const embeddingCount = countEmbeddings(db, repoId);
+        if (embeddingCount === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `No semantic index found for repo '${args.repo}'. ` +
+                                'Configure an embedding provider and re-run index_folder with semantic.enabled=true. ' +
+                                'Use search_symbols for keyword-only search.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // ── Resolve search weights ───────────────────────────────────────────────
+        const mode = args.mode ?? 'hybrid';
+        const maxResults = args.max_results ?? 10;
+        const keywordWeight = mode === 'semantic' ? 0 : (args.keyword_weight ?? 0.5);
+        const semanticWeight = mode === 'semantic' ? 1 : (args.semantic_weight ?? 0.5);
+        // ── Build VectorStore + HybridSearcher ───────────────────────────────────
+        let provider;
+        try {
+            const config = getConfig();
+            provider = createEmbeddingProvider(config);
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Embedding provider not configured: ${err}. ` +
+                                'Set semantic.provider in config to enable semantic search.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const vectorStore = new VectorStore(repoId, provider, db);
+        await vectorStore.rebuild();
+        const searcher = new HybridSearcher(repoId, vectorStore, db);
+        // ── Search ───────────────────────────────────────────────────────────────
+        const tSearch = Date.now();
+        const results = await searcher.search(args.query, {
+            maxResults,
+            keywordWeight,
+            semanticWeight,
+            kind: args.kind,
+            filePattern: args.file_pattern,
+        });
+        const searchMs = Date.now() - tSearch;
+        logger.debug('search_semantic completed', {
+            repoId,
+            mode,
+            results: results.length,
+            searchMs,
+        });
+        // ── Build response ───────────────────────────────────────────────────────
+        const uniqueFiles = [...new Set(results.map((r) => r.symbol.filePath))];
+        const fileSizes = getFileSizesBatch(db, repoId, uniqueFiles);
+        const rawBytes = uniqueFiles.reduce((sum, fp) => sum + (fileSizes.get(fp) ?? 0), 0);
+        const responseBytes = results.reduce((sum, r) => sum + (r.symbol.endByte - r.symbol.startByte), 0);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        results: results.map((r) => ({
+                            id: r.symbol.id,
+                            name: r.symbol.name,
+                            kind: r.symbol.kind,
+                            file: r.symbol.filePath,
+                            signature: r.symbol.signature,
+                            summary: r.symbol.summary,
+                            scores: {
+                                keyword: round4(r.keywordScore),
+                                semantic: round4(r.semanticScore),
+                                combined: round4(r.combinedScore),
+                            },
+                        })),
+                        _meta: {
+                            ...buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+                            mode,
+                            semantic_index_size: embeddingCount,
+                            search_ms: searchMs,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function round4(n) {
+    return Math.round(n * 10000) / 10000;
+}
+//# sourceMappingURL=search-semantic.js.map

package/dist/server/tools/search-semantic.js.map

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

package/dist/server/tools/search-symbols.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "search_symbols";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    query: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        function: "function";
+        method: "method";
+        class: "class";
+        const: "const";
+        type: "type";
+        interface: "interface";
+        enum: "enum";
+        component: "component";
+        composable: "composable";
+        hook: "hook";
+        route: "route";
+        decorator: "decorator";
+        middleware: "middleware";
+    }>>;
+    filePath: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        semantic: "semantic";
+        keyword: "keyword";
+        hybrid: "hybrid";
+    }>>;
+    semantic_weight: z.ZodOptional<z.ZodNumber>;
+    keyword_weight: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    query: string;
+    kind?: string;
+    filePath?: string;
+    limit?: number;
+    mode?: 'keyword' | 'semantic' | 'hybrid';
+    semantic_weight?: number;
+    keyword_weight?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=search-symbols.d.ts.map

package/dist/server/tools/search-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-symbols.d.ts","sourceRoot":"","sources":["../../../src/server/tools/search-symbols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,mBAAmB,CAAC;AAErC,eAAO,MAAM,WAAW,QAImD,CAAC;AAE5E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BvB,CAAC;AAIF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsK1B"}

package/dist/server/tools/search-symbols.js

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+import { openDatabase } from '../../core/db/schema.js';
+import { searchSymbols, ftsSearchSymbols, hasFtsIndex } from '../../core/db/symbol-store.js';
+import { getFileSizesBatch } from '../../core/db/file-store.js';
+import { countEmbeddings } from '../../core/db/embedding-store.js';
+import { buildMeta } from './_meta.js';
+import { getConfig } from '../../config/config-loader.js';
+import { createEmbeddingProvider } from '../../semantic/embedding-provider.js';
+import { VectorStore } from '../../semantic/vector-store.js';
+import { HybridSearcher } from '../../semantic/hybrid-search.js';
+import { logger } from '../../core/logger.js';
+import { preprocessQuery } from '../../core/search/query-preprocessor.js';
+import { rankSymbols } from '../../core/search/relevance-ranker.js';
+export const name = 'search_symbols';
+export const description = 'Search for symbols (functions, classes, types, etc.) by name across an indexed repo. ' +
+    'Returns signatures and summaries — not raw source code — for token efficiency. ' +
+    'Supports keyword, semantic, and hybrid search modes. ' +
+    'Use get_symbol_source to retrieve the full source of a specific symbol.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    query: z.string().describe('Name fragment or natural-language description to search for'),
+    kind: z
+        .enum(['function', 'class', 'method', 'const', 'type', 'interface', 'enum',
+        'component', 'composable', 'hook', 'route', 'decorator', 'middleware'])
+        .optional()
+        .describe('Filter by symbol kind'),
+    filePath: z.string().optional().describe('Filter to a specific file path'),
+    limit: z.number().int().positive().optional().describe('Max results (default 50)'),
+    mode: z
+        .enum(['keyword', 'semantic', 'hybrid'])
+        .optional()
+        .describe("Search mode: 'keyword' (FTS name match), 'semantic' (vector similarity), " +
+        "'hybrid' (RRF-merged; default when semantic index exists)"),
+    semantic_weight: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Weight for semantic score in hybrid mode (default 0.5)'),
+    keyword_weight: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Weight for keyword score in hybrid mode (default 0.5)'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const db = openDatabase(args.repoId);
+    try {
+        const limit = args.limit ?? 50;
+        const semanticWeight = args.semantic_weight ?? 0.5;
+        const keywordWeight = args.keyword_weight ?? 0.5;
+        // Determine effective mode
+        const embeddingCount = countEmbeddings(db, args.repoId);
+        const hasSemanticIndex = embeddingCount > 0;
+        let effectiveMode = args.mode;
+        if (!effectiveMode) {
+            effectiveMode = hasSemanticIndex ? 'hybrid' : 'keyword';
+        }
+        // For semantic/hybrid modes, fall back to keyword if no index or no provider
+        if ((effectiveMode === 'hybrid' || effectiveMode === 'semantic') && !hasSemanticIndex) {
+            logger.debug('search_symbols: no semantic index found, falling back to keyword', {
+                repoId: args.repoId,
+            });
+            effectiveMode = 'keyword';
+        }
+        // ── Hybrid / Semantic mode ──────────────────────────────────────────────────
+        if (effectiveMode === 'hybrid' || effectiveMode === 'semantic') {
+            try {
+                const config = getConfig();
+                const provider = createEmbeddingProvider(config);
+                const vectorStore = new VectorStore(args.repoId, provider, db);
+                await vectorStore.rebuild();
+                const searcher = new HybridSearcher(args.repoId, vectorStore, db);
+                const kwWeight = effectiveMode === 'semantic' ? 0 : keywordWeight;
+                const semWeight = effectiveMode === 'semantic' ? 1 : semanticWeight;
+                const results = await searcher.search(args.query, {
+                    maxResults: limit,
+                    keywordWeight: kwWeight,
+                    semanticWeight: semWeight,
+                    kind: args.kind,
+                    filePattern: args.filePath,
+                });
+                const uniqueFiles = [...new Set(results.map((r) => r.symbol.filePath))];
+                const fileSizes = getFileSizesBatch(db, args.repoId, uniqueFiles);
+                const rawBytes = uniqueFiles.reduce((sum, fp) => sum + (fileSizes.get(fp) ?? 0), 0);
+                const responseBytes = results.reduce((sum, r) => sum + (r.symbol.endByte - r.symbol.startByte), 0);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                count: results.length,
+                                symbols: results.map((r) => ({
+                                    id: r.symbol.id,
+                                    name: r.symbol.name,
+                                    kind: r.symbol.kind,
+                                    filePath: r.symbol.filePath,
+                                    signature: r.symbol.signature,
+                                    summary: r.symbol.summary,
+                                    scores: {
+                                        keyword: round4(r.keywordScore),
+                                        semantic: round4(r.semanticScore),
+                                        combined: round4(r.combinedScore),
+                                    },
+                                })),
+                                _meta: {
+                                    ...buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+                                    mode: effectiveMode,
+                                    semantic_index_size: embeddingCount,
+                                },
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                // If provider setup fails (not configured), fall back to keyword
+                logger.warn(`search_symbols: semantic search unavailable, falling back to keyword: ${err}`);
+                effectiveMode = 'keyword';
+            }
+        }
+        // ── Keyword mode (default / fallback) ────────────────────────────────────
+        let symbols;
+        let searchMode;
+        const ftsAvailable = hasFtsIndex(db, args.repoId);
+        if (ftsAvailable) {
+            const ftsQuery = preprocessQuery(args.query);
+            try {
+                symbols = ftsSearchSymbols(db, args.repoId, ftsQuery, {
+                    kind: args.kind,
+                    filePath: args.filePath,
+                    limit,
+                });
+                searchMode = 'fts';
+            }
+            catch (err) {
+                logger.warn(`search_symbols: FTS query failed, falling back to LIKE: ${err}`);
+                symbols = searchSymbols(db, args.repoId, args.query, {
+                    kind: args.kind,
+                    filePath: args.filePath,
+                    limit,
+                });
+                searchMode = 'like_fallback';
+            }
+        }
+        else {
+            symbols = searchSymbols(db, args.repoId, args.query, {
+                kind: args.kind,
+                filePath: args.filePath,
+                limit,
+            });
+            searchMode = 'like_fallback';
+        }
+        // Re-rank results by explicit relevance scoring
+        const ranked = rankSymbols(symbols, args.query);
+        const uniqueFiles = [...new Set(ranked.map((r) => r.symbol.filePath))];
+        const fileSizes = getFileSizesBatch(db, args.repoId, uniqueFiles);
+        const rawBytes = uniqueFiles.reduce((sum, fp) => sum + (fileSizes.get(fp) ?? 0), 0);
+        const responseBytes = ranked.reduce((sum, r) => sum + (r.symbol.endByte - r.symbol.startByte), 0);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        count: ranked.length,
+                        symbols: ranked.map((r) => ({
+                            id: r.symbol.id,
+                            name: r.symbol.name,
+                            kind: r.symbol.kind,
+                            filePath: r.symbol.filePath,
+                            signature: r.symbol.signature,
+                            summary: r.symbol.summary,
+                            score: r.score,
+                            matchReason: r.matchReason,
+                        })),
+                        _meta: {
+                            ...buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+                            mode: effectiveMode,
+                            search_mode: searchMode,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function round4(n) {
+    return Math.round(n * 10000) / 10000;
+}
+//# sourceMappingURL=search-symbols.js.map

package/dist/server/tools/search-symbols.js.map

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

package/dist/server/tools/search-text.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "search_text";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    query: z.ZodString;
+    isRegex: z.ZodDefault<z.ZodBoolean>;
+    filePattern: z.ZodOptional<z.ZodString>;
+    contextLines: z.ZodDefault<z.ZodNumber>;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    query: string;
+    isRegex?: boolean;
+    filePattern?: string;
+    contextLines?: number;
+    maxResults?: number;
+}): CallToolResult;
+//# sourceMappingURL=search-text.d.ts.map

package/dist/server/tools/search-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-text.d.ts","sourceRoot":"","sources":["../../../src/server/tools/search-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAG4E,CAAC;AAErG,eAAO,MAAM,WAAW;;;;;;;CAoBvB,CAAC;AAcF,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,cAAc,CAmHjB"}

package/dist/server/tools/search-text.js

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+import { minimatch } from 'minimatch';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getAllFilesWithContent } from '../../core/db/file-store.js';
+import { validatePath } from '../../core/security.js';
+import { buildMeta } from './_meta.js';
+export const name = 'search_text';
+export const description = 'Search for a literal string or regex pattern across all cached file content in an indexed repo. ' +
+    'Returns matching lines with surrounding context. ' +
+    'Complements search_symbols (which searches symbol names) by finding arbitrary strings in source.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    query: z.string().describe('Literal string or regex pattern to search for'),
+    isRegex: z.boolean().default(false).describe('Treat query as a regular expression (default false)'),
+    filePattern: z
+        .string()
+        .optional()
+        .describe("Glob pattern to filter which files are searched (e.g. '**/*.ts')"),
+    contextLines: z
+        .number()
+        .int()
+        .min(0)
+        .default(2)
+        .describe('Lines of context to show before and after each match (default 2)'),
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .default(50)
+        .describe('Maximum number of matches to return (default 50)'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export function handler(args) {
+    const t0 = Date.now();
+    const { repoId, query, isRegex = false, filePattern, contextLines = 2, maxResults = 50 } = args;
+    const db = openDatabase(repoId);
+    const repo = getRepo(db, repoId);
+    if (!repo) {
+        db.close();
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Repo "${repoId}" not found` }) }],
+            isError: true,
+        };
+    }
+    let pattern;
+    try {
+        pattern = isRegex ? new RegExp(query, 'g') : new RegExp(escapeRegex(query), 'g');
+    }
+    catch (err) {
+        db.close();
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Invalid regex: ${err}` }) }],
+            isError: true,
+        };
+    }
+    const files = getAllFilesWithContent(db, repoId);
+    db.close();
+    const matches = [];
+    let filesSearched = 0;
+    let truncated = false;
+    let rawBytes = 0;
+    for (const file of files) {
+        if (!file.rawContent)
+            continue;
+        if (filePattern && !minimatch(file.path, filePattern, { matchBase: false, dot: true })) {
+            continue;
+        }
+        try {
+            validatePath(file.path, repo.rootPath);
+        }
+        catch {
+            continue;
+        }
+        filesSearched++;
+        rawBytes += file.rawContent.length;
+        const text = file.rawContent.toString('utf8');
+        const lines = text.split('\n');
+        for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
+            const line = lines[lineIdx];
+            pattern.lastIndex = 0;
+            let m;
+            while ((m = pattern.exec(line)) !== null) {
+                if (matches.length >= maxResults) {
+                    truncated = true;
+                    break;
+                }
+                const contextBefore = lines
+                    .slice(Math.max(0, lineIdx - contextLines), lineIdx)
+                    .join('\n');
+                const contextAfter = lines
+                    .slice(lineIdx + 1, lineIdx + 1 + contextLines)
+                    .join('\n');
+                const contextParts = [contextBefore, line, contextAfter].filter((p) => p !== '');
+                matches.push({
+                    file: file.path,
+                    line: lineIdx + 1,
+                    column: m.index + 1,
+                    match: m[0],
+                    context: contextParts.join('\n'),
+                });
+                if (m[0].length === 0) {
+                    pattern.lastIndex++;
+                }
+            }
+            if (truncated)
+                break;
+        }
+        if (truncated)
+            break;
+    }
+    const responseBytes = matches.reduce((sum, m) => sum + m.context.length + m.file.length + m.match.length, 0);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    matches,
+                    total_matches: matches.length,
+                    files_searched: filesSearched,
+                    truncated,
+                    _meta: buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=search-text.js.map

package/dist/server/tools/search-text.js.map

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