mcp-code-context 3.6.2 → 3.7.0

package/dist/src/operations/readCore.js

@@ -0,0 +1,142 @@
+/**
+ * Read core — extractSymbol and readLines
+ */
+import * as fs from "node:fs/promises";
+import * as crypto from "node:crypto";
+import { safeRegexFindFirst } from "../utils/safeRegex.js";
+import { validateRegexPattern } from "../utils/regexValidator.js";
+async function getFileHash(filePath) {
+    const content = await fs.readFile(filePath, "utf-8");
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+/**
+ * Extract a specific symbol from a file
+ */
+export async function extractSymbol(params) {
+    try {
+        const cache = params.cache;
+        // Try cache first
+        if (cache) {
+            const hash = await getFileHash(params.filePath);
+            const cached = await cache.get(params.filePath, hash);
+            if (cached) {
+                const symbol = cached.symbols.find(s => s.name === params.symbolName && (!params.className || s.className === params.className));
+                if (symbol) {
+                    const content = await fs.readFile(params.filePath, "utf-8");
+                    const tree = params.parser.parse(content);
+                    const extracted = params.parser.extractSymbol(tree, params.symbolName, params.className);
+                    if (extracted) {
+                        return { success: true, content: extracted };
+                    }
+                }
+            }
+        }
+        // Cache miss - parse file
+        const content = await fs.readFile(params.filePath, "utf-8");
+        const tree = params.parser.parse(content);
+        const symbols = params.parser.findSymbols(tree);
+        // Update cache
+        if (cache) {
+            const hash = await getFileHash(params.filePath);
+            const stat = await fs.stat(params.filePath);
+            await cache.set({
+                filePath: params.filePath,
+                hash,
+                symbols,
+                lastModified: stat.mtimeMs,
+                cachedAt: Date.now(),
+            });
+        }
+        const extracted = params.parser.extractSymbol(tree, params.symbolName, params.className);
+        if (!extracted) {
+            const symbols = params.parser.findSymbols(tree);
+            return {
+                success: false,
+                error: `Symbol "${params.symbolName}" not found. Available: ${symbols.map(s => s.name).join(", ")}`,
+                symbols,
+            };
+        }
+        return {
+            success: true,
+            content: extracted,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Read specific line ranges from a file
+ */
+export async function readLines(params) {
+    try {
+        const content = await fs.readFile(params.filePath, "utf-8");
+        const lines = content.split("\n");
+        if (params.aroundPattern) {
+            const validation = validateRegexPattern(params.aroundPattern);
+            if (!validation.safe) {
+                return {
+                    success: false,
+                    error: `Unsafe regex pattern: ${validation.issues.join(", ")}`,
+                };
+            }
+            const findResult = await safeRegexFindFirst(params.aroundPattern, lines);
+            if (findResult.timedOut) {
+                return {
+                    success: false,
+                    error: `Regex timed out searching for pattern (potential ReDoS)`,
+                };
+            }
+            if (!findResult.success) {
+                return { success: false, error: findResult.error };
+            }
+            const matchIndex = findResult.matchIndex;
+            if (matchIndex === -1) {
+                return {
+                    success: false,
+                    error: `Pattern "${params.aroundPattern}" not found`,
+                };
+            }
+            const context = params.contextLines || 5;
+            const start = Math.max(0, matchIndex - context);
+            const end = Math.min(lines.length, matchIndex + context + 1);
+            const matchLine = matchIndex + 1;
+            return {
+                success: true,
+                content: `Match found at line ${matchLine} (showing lines ${start + 1}-${end}):\n${lines.slice(start, end).join("\n")}`,
+            };
+        }
+        if (params.startLine !== undefined && params.endLine !== undefined) {
+            const start = Math.max(0, params.startLine - 1);
+            // Clamp endLine to actual file length instead of erroring
+            const clampedEnd = Math.min(params.endLine, lines.length);
+            const clampWarning = params.endLine > lines.length
+                ? `\n⚠️ endLine ${params.endLine} clamped to ${lines.length} (file has ${lines.length} lines)\n`
+                : "";
+            if (start >= lines.length) {
+                return {
+                    success: false,
+                    error: `startLine ${params.startLine} exceeds file length (${lines.length} lines)`,
+                };
+            }
+            return {
+                success: true,
+                content: clampWarning + lines.slice(start, clampedEnd).join("\n"),
+            };
+        }
+        return {
+            success: false,
+            error: "Must provide either startLine+endLine or aroundPattern",
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=readCore.js.map

package/dist/src/operations/readCore.js.map

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

package/dist/src/operations/rename.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Rename symbol operations — AST definition + text-based dependents
+ */
+import { BaseParser } from "../parsers/base.js";
+import type { WriteResult } from "./write.js";
+export declare function renameSymbol(params: {
+    filePath: string;
+    projectRoot: string;
+    oldName: string;
+    newName: string;
+    rootDir: string;
+    parser: BaseParser;
+}): Promise<WriteResult>;

package/dist/src/operations/rename.js

@@ -0,0 +1,130 @@
+/**
+ * Rename symbol operations — AST definition + text-based dependents
+ */
+import * as fs from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { SecurityValidator } from "../core/validator.js";
+import { EXCLUDE_DIRS, SUPPORTED_EXTENSIONS } from "../utils/constants.js";
+import { generateUnifiedDiff } from "../utils/diff.js";
+import { sanitizeRegexPattern } from "../utils/regexValidator.js";
+import { safeRegexAnyTest, safeRegexReplaceAll } from "../utils/safeRegex.js";
+import { walkDir } from "../utils/fileWalker.js";
+async function validateRenameParams(params) {
+    const validator = new SecurityValidator(params.projectRoot);
+    const defValidation = await validator.validateFilePath(params.filePath);
+    if (!defValidation.valid) {
+        return { valid: false, error: defValidation.error };
+    }
+    return {
+        valid: true,
+        resolvedPath: defValidation.resolvedPath,
+        sanitizedOld: sanitizeRegexPattern(params.oldName),
+    };
+}
+async function findDependentFiles(rootDir, sanitizedOldName, projectRoot) {
+    const dependents = [];
+    const validator = new SecurityValidator(projectRoot);
+    await walkDir(rootDir, {
+        extensions: SUPPORTED_EXTENSIONS,
+        excludeDirs: EXCLUDE_DIRS,
+        onFile: async (fullPath) => {
+            const depValidation = await validator.validateFilePath(fullPath);
+            if (!depValidation.valid)
+                return;
+            const fileContent = await fs.readFile(fullPath, "utf-8");
+            const importPatterns = [
+                `import.*\\b${sanitizedOldName}\\b`,
+                `from.*\\b${sanitizedOldName}\\b`,
+                `require.*\\b${sanitizedOldName}\\b`,
+                `use.*\\b${sanitizedOldName}\\b`,
+            ];
+            const matchResult = await safeRegexAnyTest(importPatterns, fileContent);
+            if (matchResult.timedOut) {
+                throw new Error(matchResult.error ?? "Regex timed out finding rename dependents (ReDoS prevented)");
+            }
+            if (!matchResult.success) {
+                throw new Error(matchResult.error ?? "Rename dependent scan failed");
+            }
+            if (matchResult.matched) {
+                dependents.push({ path: fullPath, content: fileContent });
+            }
+        },
+    });
+    return dependents;
+}
+async function generateRenameChanges(oldName, newName, sanitizedOld, definitionPath, definitionContent, definitionNewContent, dependents) {
+    const pendingWrites = [];
+    const diffParts = [];
+    const wordPattern = `\\b${sanitizedOld}\\b`;
+    for (const dep of dependents) {
+        const replaceResult = await safeRegexReplaceAll(wordPattern, newName, dep.content);
+        if (replaceResult.timedOut) {
+            throw new Error(replaceResult.error ?? "Regex timed out during rename (ReDoS prevented)");
+        }
+        if (!replaceResult.success || replaceResult.output === undefined) {
+            throw new Error(replaceResult.error ?? "Rename replace failed");
+        }
+        const depNewContent = replaceResult.output;
+        pendingWrites.push({
+            filePath: dep.path,
+            newContent: depNewContent,
+            originalHash: createHash("sha256").update(dep.content).digest("hex"),
+        });
+        diffParts.push(`--- ${dep.path}\n${generateUnifiedDiff(dep.content, depNewContent)}`);
+    }
+    pendingWrites.push({
+        filePath: definitionPath,
+        newContent: definitionNewContent,
+        originalHash: createHash("sha256").update(definitionContent).digest("hex"),
+    });
+    diffParts.push(`--- ${definitionPath}\n${generateUnifiedDiff(definitionContent, definitionNewContent)}`);
+    const textWarning = dependents.length > 0
+        ? `\n⚠️ Dependent files (${dependents.length}) use text-based rename — strings/comments may be affected. Definition file uses AST.`
+        : "";
+    const consolidatedDiff = `Renamed "${oldName}" \u2192 "${newName}" in ${pendingWrites.length} files${textWarning}\n\n${diffParts.join("\n\n")}`;
+    return { pendingWrites, diff: consolidatedDiff };
+}
+export async function renameSymbol(params) {
+    try {
+        const validation = await validateRenameParams({
+            filePath: params.filePath,
+            projectRoot: params.projectRoot,
+            oldName: params.oldName,
+        });
+        if (!validation.valid) {
+            return { success: false, error: validation.error };
+        }
+        const { resolvedPath, sanitizedOld } = validation;
+        const content = await fs.readFile(resolvedPath, "utf-8");
+        const tree = params.parser.parse(content);
+        const symbols = params.parser.findSymbols(tree);
+        const targetSymbol = symbols.find((s) => s.name === params.oldName);
+        if (!targetSymbol) {
+            return { success: false, error: `Symbol "${params.oldName}" not found in ${params.filePath}` };
+        }
+        const symbolSlice = content.substring(targetSymbol.startIndex, targetSymbol.endIndex);
+        const symbolReplace = await safeRegexReplaceAll(`\\b${sanitizedOld}\\b`, params.newName, symbolSlice);
+        if (symbolReplace.timedOut) {
+            return { success: false, error: symbolReplace.error ?? "Regex timed out during rename (ReDoS prevented)" };
+        }
+        if (!symbolReplace.success || symbolReplace.output === undefined) {
+            return { success: false, error: symbolReplace.error ?? "Rename replace failed" };
+        }
+        const newContent = content.substring(0, targetSymbol.startIndex) +
+            symbolReplace.output +
+            content.substring(targetSymbol.endIndex);
+        const dependents = await findDependentFiles(params.rootDir, sanitizedOld, params.projectRoot);
+        const { pendingWrites, diff } = await generateRenameChanges(params.oldName, params.newName, sanitizedOld, resolvedPath, content, newContent, dependents);
+        return {
+            success: true,
+            newContent,
+            diff,
+            originalHash: createHash("sha256").update(content).digest("hex"),
+            pendingWrites,
+        };
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=rename.js.map

package/dist/src/operations/rename.js.map

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

package/dist/src/operations/searchOperation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Search pattern operation
+ */
+import type { ReadResult } from "./readCore.js";
+export declare function searchPattern(params: {
+    rootDir: string;
+    pattern: string;
+    fileExtensions?: string[];
+    excludeDirs?: string[];
+    showContext?: boolean;
+    contextLines?: number;
+    maxResults?: number;
+    startIndex?: number;
+    fuzzyMatch?: boolean;
+    fuzzyThreshold?: number;
+}): Promise<ReadResult>;

package/dist/src/operations/searchOperation.js

@@ -0,0 +1,113 @@
+/**
+ * Search pattern operation
+ */
+import * as fs from "node:fs/promises";
+import { EXCLUDE_DIRS, SUPPORTED_EXTENSIONS, MAX_FILES_SEARCH, OPERATION_TIMEOUT_MS } from "../utils/constants.js";
+import { safeRegexMultiFileBatchTest } from "../utils/safeRegex.js";
+import { validateRegexPattern } from "../utils/regexValidator.js";
+import { walkDir } from "../utils/fileWalker.js";
+import { fuzzySearch } from "../utils/fuzzySearch.js";
+import { searchWithNativeTool } from "../utils/searchTools.js";
+const DEFAULT_MAX_RESULTS = 10;
+const SCAN_TIMEOUT_BASE_MS = 1000;
+const SCAN_TIMEOUT_PER_FILE_MS = 10;
+export async function searchPattern(params) {
+    try {
+        const maxResults = params.maxResults || DEFAULT_MAX_RESULTS;
+        const validation = validateRegexPattern(params.pattern);
+        if (!validation.safe) {
+            return {
+                success: false,
+                error: `Unsafe regex pattern: ${validation.issues.join(", ")}`,
+            };
+        }
+        // Try native tools after regex safety gate (ripgrep > ugrep > ag > findstr/grep)
+        const nativeResult = await searchWithNativeTool(params.pattern, params.rootDir, maxResults, 10000);
+        if (nativeResult && !nativeResult.timedOut && nativeResult.matches.length > 0) {
+            const startIdx = params.startIndex || 0;
+            const paginatedMatches = nativeResult.matches.slice(startIdx, startIdx + maxResults);
+            const results = paginatedMatches.map(m => ({
+                file: m.file,
+                line: m.line,
+                content: m.content,
+            }));
+            const totalResults = nativeResult.matches.length;
+            const hasMore = startIdx + maxResults < totalResults;
+            const footer = `\n\nShowing ${startIdx + 1}-${startIdx + results.length} of ${totalResults} results (via ${nativeResult.tool})${hasMore ? ' (use startIndex to see more)' : ''}`;
+            return { success: true, content: JSON.stringify(results, null, 2) + footer };
+        }
+        const extensions = params.fileExtensions || SUPPORTED_EXTENSIONS;
+        const excludeDirs = params.excludeDirs || EXCLUDE_DIRS;
+        // Step 1: Collect file paths first (preventing memory exhaustion)
+        const filePaths = [];
+        await walkDir(params.rootDir, {
+            extensions,
+            excludeDirs,
+            maxFiles: MAX_FILES_SEARCH + 1, // Stop early if we exceed the limit
+            onFile: (fullPath) => {
+                filePaths.push(fullPath);
+            },
+        });
+        // CRITICAL: Prevent OOM in large monorepos
+        if (filePaths.length > MAX_FILES_SEARCH) {
+            return {
+                success: false,
+                error: `Too many files to search (${filePaths.length - 1}+). Maximum: ${MAX_FILES_SEARCH}. Try narrowing your search with fileExtensions or excludeDirs.`
+            };
+        }
+        const fileEntries = [];
+        for (const filePath of filePaths) {
+            const content = await fs.readFile(filePath, "utf-8");
+            fileEntries.push({ path: filePath, lines: content.split("\n") });
+        }
+        // Step 2: ONE worker for ALL files — eliminates N worker spawns
+        const scanTimeout = Math.min(OPERATION_TIMEOUT_MS, SCAN_TIMEOUT_BASE_MS + fileEntries.length * SCAN_TIMEOUT_PER_FILE_MS);
+        const batchResult = await safeRegexMultiFileBatchTest(params.pattern, fileEntries, scanTimeout);
+        if (batchResult.timedOut) {
+            console.warn(`⚠️  Regex scan timed out across ${fileEntries.length} files`);
+            return { success: false, error: `Regex scan timed out (${fileEntries.length} files, potential ReDoS)` };
+        }
+        if (!batchResult.success) {
+            return { success: false, error: batchResult.error };
+        }
+        // Step 3: Collect results with pagination
+        const startIdx = params.startIndex || 0;
+        const maxRes = params.maxResults || DEFAULT_MAX_RESULTS;
+        const allMatches = batchResult.results;
+        // Apply fuzzy filtering if requested
+        let filteredMatches = allMatches;
+        if (params.fuzzyMatch) {
+            const fuzzyThreshold = params.fuzzyThreshold ?? 0.4;
+            const searchItems = allMatches.map(m => ({
+                ...m,
+                searchText: `${m.file} ${m.content}`,
+            }));
+            const fuzzyResults = fuzzySearch(searchItems, params.pattern, {
+                threshold: fuzzyThreshold,
+                keys: ['searchText'],
+            });
+            filteredMatches = fuzzyResults.map(r => r.item);
+        }
+        const paginatedMatches = filteredMatches.slice(startIdx, startIdx + maxRes);
+        const results = paginatedMatches.map(match => ({
+            file: match.file,
+            line: match.index + 1,
+            content: match.content,
+        }));
+        // Add pagination footer
+        const totalResults = filteredMatches.length;
+        const hasMore = startIdx + maxRes < totalResults;
+        const footer = `\n\nShowing ${startIdx + 1}-${startIdx + results.length} of ${totalResults} results${hasMore ? ' (use startIndex to see more)' : ''}`;
+        return {
+            success: true,
+            content: JSON.stringify(results, null, 2) + footer,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=searchOperation.js.map

package/dist/src/operations/searchOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchOperation.js","sourceRoot":"","sources":["../../../src/operations/searchOperation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACnH,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAWnC;IACC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAE5D,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,yBAAyB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC/D,CAAC;QACJ,CAAC;QAED,iFAAiF;QACjF,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACnG,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9E,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;YACxC,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;YACrF,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC,CAAC;YACJ,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;YACjD,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;YACrD,MAAM,MAAM,GAAG,eAAe,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM,OAAO,YAAY,iBAAiB,YAAY,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACjL,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;QAC/E,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,IAAI,oBAAoB,CAAC;QACjE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,YAAY,CAAC;QAEvD,kEAAkE;QAClE,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;YAC5B,UAAU;YACV,WAAW;YACX,QAAQ,EAAE,gBAAgB,GAAG,CAAC,EAAE,oCAAoC;YACpE,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACnB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC,CAAC;QAEH,2CAA2C;QAC3C,IAAI,SAAS,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6BAA6B,SAAS,CAAC,MAAM,GAAG,CAAC,gBAAgB,gBAAgB,iEAAiE;aAC1J,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAA6C,EAAE,CAAC;QACjE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,gEAAgE;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,WAAW,CAAC,MAAM,GAAG,wBAAwB,CAAC,CAAC;QACzH,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAEhG,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,mCAAmC,WAAW,CAAC,MAAM,QAAQ,CAAC,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,WAAW,CAAC,MAAM,0BAA0B,EAAE,CAAC;QAC1G,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;QACtD,CAAC;QAED,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;QACxD,MAAM,UAAU,GAAG,WAAW,CAAC,OAAQ,CAAC;QAExC,qCAAqC;QACrC,IAAI,eAAe,GAAG,UAAU,CAAC;QACjC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC;YACpD,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvC,GAAG,CAAC;gBACJ,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE;aACrC,CAAC,CAAC,CAAC;YAEJ,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE;gBAC5D,SAAS,EAAE,cAAc;gBACzB,IAAI,EAAE,CAAC,YAAY,CAAC;aACrB,CAAC,CAAC;YAEH,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QASD,MAAM,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAkB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC;YACrB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;QAEJ,wBAAwB;QACxB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC;QAC5C,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;QACjD,MAAM,MAAM,GAAG,eAAe,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM,OAAO,YAAY,WAAW,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEtJ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,MAAM;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/operations/symbolQuery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Symbol query operations — search, explain, batch read
+ */
+import { BaseParser } from "../parsers/base.js";
+import { type ReadResult } from "./readCore.js";
+export declare function searchSymbols(params: {
+    rootDir: string;
+    query: string;
+    projectRoot: string;
+    fuzzy?: boolean;
+    types?: string[];
+    fileExtensions?: string[];
+    excludeDirs?: string[];
+    maxResults?: number;
+}): Promise<ReadResult>;
+/**
+ * NEW-03: Explain a symbol — signature + callers + callees in one call
+ */
+export declare function explainSymbol(params: {
+    filePath: string;
+    projectRoot: string;
+    symbolName: string;
+    className?: string;
+    parser: BaseParser;
+    rootDir: string;
+}): Promise<ReadResult>;
+/**
+ * NEW-05: Batch read multiple symbols in one call
+ */
+export declare function batchRead(params: {
+    reads: Array<{
+        filePath: string;
+        symbolName: string;
+        className?: string;
+    }>;
+    projectRoot: string;
+    parser: (ext: string) => BaseParser | null;
+}): Promise<ReadResult>;