mcp-code-context 3.9.2 → 7.0.0

package/dist/src/operations/incrementalDiff.js

@@ -0,0 +1,216 @@
+/**
+ * WASM Incremental AST Re-Parsing & Subtree Diff Engine (v5.5.0)
+ *
+ * Computes sub-millisecond AST re-parsing deltas between old and new code using
+ * Tree-sitter's tree.edit() and incremental re-parsing. Identifies exact affected
+ * AST nodes, enclosing declarations, and validates syntax error integrity (hasError)
+ * in O(log N) time without re-parsing unaffected subtrees.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { existsSync } from "node:fs";
+import { performance } from "node:perf_hooks";
+import { ParserRegistry } from "../parsers/registry.js";
+import { CodeContextEngine } from "../core/engine.js";
+/**
+ * Calculates common prefix length between two strings
+ */
+function getCommonPrefix(s1, s2) {
+    let i = 0;
+    const max = Math.min(s1.length, s2.length);
+    while (i < max && s1[i] === s2[i])
+        i++;
+    return i;
+}
+/**
+ * Calculates common suffix length between two strings given prefix offset
+ */
+function getCommonSuffix(s1, s2, prefixLen) {
+    let len = 0;
+    let i1 = s1.length - 1;
+    let i2 = s2.length - 1;
+    while (i1 >= prefixLen && i2 >= prefixLen && s1[i1] === s2[i2]) {
+        len++;
+        i1--;
+        i2--;
+    }
+    return len;
+}
+/**
+ * Converts byte index into row/column Point
+ */
+function indexToPoint(str, index) {
+    const slice = str.slice(0, index);
+    const lines = slice.split("\n");
+    const row = lines.length - 1;
+    const column = lines[lines.length - 1].length;
+    return { row, column };
+}
+/**
+ * Finds the enclosing declaration (function, class, method, or interface)
+ */
+function findEnclosingDeclaration(node) {
+    let curr = node;
+    while (curr) {
+        if (curr.type === "function_declaration" ||
+            curr.type === "function_definition" ||
+            curr.type === "method_definition" ||
+            curr.type === "class_declaration" ||
+            curr.type === "class_definition" ||
+            curr.type === "interface_declaration" ||
+            curr.type === "arrow_function") {
+            const name = curr.childForFieldName("name")?.text ||
+                (curr.parent?.type === "variable_declarator" ? curr.parent.childForFieldName("name")?.text : undefined);
+            return { type: curr.type, name };
+        }
+        curr = curr.parent;
+    }
+    return null;
+}
+/**
+ * Main incrementalAstDiff operation
+ */
+export async function incrementalAstDiff(params) {
+    let oldTree = null;
+    let newTree = null;
+    try {
+        const targetPath = params.filePath || "in_memory.ts";
+        let oldContent = params.oldCode ?? params.oldContent;
+        if (oldContent === undefined) {
+            if (params.filePath && existsSync(params.filePath)) {
+                oldContent = await fs.readFile(params.filePath, "utf-8");
+            }
+            else {
+                oldContent = "";
+            }
+        }
+        let newContent = params.newCode ?? params.newContent;
+        if (newContent === undefined) {
+            if (params.filePath && existsSync(params.filePath)) {
+                newContent = await fs.readFile(params.filePath, "utf-8");
+            }
+            else {
+                return {
+                    success: false,
+                    error: "newCode or newContent is required",
+                };
+            }
+        }
+        const ext = path.extname(targetPath).toLowerCase();
+        // Initialize Parser Registry
+        let registry = params.registry;
+        if (!registry) {
+            const engine = new CodeContextEngine();
+            await engine.init();
+            registry = new ParserRegistry(engine);
+            await registry.init();
+        }
+        const parser = registry.getParser(ext === ".py" ? ".py" : ".ts");
+        if (!parser) {
+            return {
+                success: false,
+                error: `No AST parser available for extension ${ext}`,
+            };
+        }
+        // Parse base tree
+        oldTree = parser.parse(oldContent);
+        // Compute diff offsets
+        const prefixLen = getCommonPrefix(oldContent, newContent);
+        const suffixLen = getCommonSuffix(oldContent, newContent, prefixLen);
+        const startIndex = prefixLen;
+        const oldEndIndex = oldContent.length - suffixLen;
+        const newEndIndex = newContent.length - suffixLen;
+        const startPos = indexToPoint(oldContent, startIndex);
+        const oldEndPos = indexToPoint(oldContent, oldEndIndex);
+        const newEndPos = indexToPoint(newContent, newEndIndex);
+        // Execute tree-sitter edit on oldTree
+        oldTree.edit({
+            startIndex,
+            oldEndIndex,
+            newEndIndex,
+            startPosition: startPos,
+            oldEndPosition: oldEndPos,
+            newEndPosition: newEndPos,
+        });
+        // Benchmark sub-millisecond re-parsing
+        const t0 = performance.now();
+        newTree = parser.parse(newContent, oldTree);
+        const reparseDurationMs = Number((performance.now() - t0).toFixed(3));
+        // Verify syntax integrity
+        const hasErrors = newTree.rootNode.hasError;
+        // Count error nodes if syntax broke
+        let errorNodesCount = 0;
+        if (hasErrors) {
+            function countErrors(node) {
+                if (node.type === "ERROR" || node.isMissing) {
+                    errorNodesCount++;
+                }
+                for (let i = 0; i < node.namedChildCount; i++) {
+                    const c = node.namedChild(i);
+                    if (c && c.hasError)
+                        countErrors(c);
+                }
+            }
+            countErrors(newTree.rootNode);
+        }
+        // Locate affected node in newTree
+        const targetIdx = Math.min(startIndex, newContent.length > 0 ? newContent.length - 1 : 0);
+        const targetEndIdx = Math.max(targetIdx, Math.min(newEndIndex, newContent.length));
+        const rawNode = newTree.rootNode.descendantForIndex(targetIdx, targetEndIdx);
+        const affectedNode = rawNode ?? newTree.rootNode;
+        const enclosing = findEnclosingDeclaration(affectedNode);
+        const startRow = affectedNode.startPosition.row;
+        const endRow = affectedNode.endPosition.row;
+        const newLines = newContent.split("\n");
+        const previewLines = newLines.slice(Math.max(0, startRow - 1), Math.min(newLines.length, endRow + 2));
+        const affectedDetail = {
+            type: affectedNode.type,
+            symbolName: enclosing?.name,
+            enclosingScope: enclosing ? `${enclosing.type} ${enclosing.name || "(anonymous)"}` : "global",
+            startLine: startRow + 1,
+            endLine: endRow + 1,
+            startColumn: affectedNode.startPosition.column,
+            endColumn: affectedNode.endPosition.column,
+            snippet: previewLines.join("\n"),
+        };
+        const summary = hasErrors
+            ? `⚠️ Incremental Re-parse: Syntax Error introduced in '${affectedDetail.enclosingScope}' (Lines ${affectedDetail.startLine}-${affectedDetail.endLine}) in ${reparseDurationMs}ms.`
+            : `✅ Incremental Re-parse: Clean syntax update in '${affectedDetail.enclosingScope}' (Lines ${affectedDetail.startLine}-${affectedDetail.endLine}) in ${reparseDurationMs}ms.`;
+        const report = {
+            filePath: params.filePath,
+            reparseDurationMs,
+            isSyntaxValid: !hasErrors,
+            hasErrors,
+            errorNodesCount,
+            deltaByteRange: {
+                startIndex,
+                oldEndIndex,
+                newEndIndex,
+            },
+            affectedNode: affectedDetail,
+            summary,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2) + "\n\n" + summary,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `incremental_ast_diff failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    finally {
+        // SRE Guardrail: Strict WASM Linear Memory Disposal
+        try {
+            oldTree?.delete();
+        }
+        catch { }
+        try {
+            newTree?.delete();
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=incrementalDiff.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * Scope-Aware Semantic Scope Resolver & Shadowing Guard
+ * v5.7.0 Enterprise AST Intelligence
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export interface ScopeVariable {
+    name: string;
+    kind: "var" | "let" | "const" | "parameter" | "function" | "class";
+    line: number;
+    column: number;
+}
+export interface ShadowingIncident {
+    identifier: string;
+    innerScopeLine: number;
+    outerScopeLine: number;
+    warning: string;
+}
+export interface LexicalScopeInfo {
+    id: number;
+    type: "global" | "module" | "function" | "block";
+    startLine: number;
+    endLine: number;
+    parentId?: number;
+    variables: ScopeVariable[];
+}
+export interface LexicalScopeReport {
+    filePath?: string;
+    totalScopes: number;
+    shadowingIncidents: ShadowingIncident[];
+    scopes: LexicalScopeInfo[];
+    canSafelyRename?: boolean;
+    renameCollisionWarning?: string;
+    summary: string;
+}
+export interface LexicalScopeOptions {
+    filePath?: string;
+    code?: string;
+    content?: string;
+    proposedRename?: {
+        targetSymbol: string;
+        newSymbolName: string;
+        atLine: number;
+    };
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Main lexical scope resolver
+ */
+export declare function resolveLexicalScope(params: LexicalScopeOptions): Promise<ReadResult>;

package/dist/src/operations/lexicalScope.js

@@ -0,0 +1,212 @@
+/**
+ * Scope-Aware Semantic Scope Resolver & Shadowing Guard
+ * v5.7.0 Enterprise AST Intelligence
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { existsSync } from "node:fs";
+import { ParserRegistry } from "../parsers/registry.js";
+import { CodeContextEngine } from "../core/engine.js";
+/**
+ * Builds the lexical scope tree and tracks identifier declarations
+ */
+function buildScopeTree(rootNode) {
+    const scopes = [];
+    const incidents = [];
+    let nextScopeId = 1;
+    function traverseScope(n, parentId) {
+        const isGlobal = !parentId && (n.type === "program" || n.type === "module");
+        const isFunction = n.type === "function_declaration" ||
+            n.type === "function_definition" ||
+            n.type === "method_definition" ||
+            n.type === "arrow_function";
+        const isBlock = n.type === "statement_block" || n.type === "block";
+        let currentScopeId = parentId;
+        if (isGlobal || isFunction || isBlock) {
+            currentScopeId = nextScopeId++;
+            const scopeType = isGlobal ? "global" : isFunction ? "function" : "block";
+            scopes.push({
+                id: currentScopeId,
+                type: scopeType,
+                startLine: n.startPosition.row + 1,
+                endLine: n.endPosition.row + 1,
+                parentId,
+                variables: [],
+            });
+        }
+        // Capture parameter declarations
+        if (isFunction) {
+            const params = n.childForFieldName("parameters");
+            if (params) {
+                for (let i = 0; i < params.namedChildCount; i++) {
+                    const p = params.namedChild(i);
+                    if (p && (p.type === "required_parameter" || p.type === "identifier")) {
+                        const name = p.type === "identifier" ? p.text : p.childForFieldName("pattern")?.text || p.text;
+                        const targetScope = scopes.find(s => s.id === currentScopeId);
+                        if (targetScope && name) {
+                            targetScope.variables.push({
+                                name,
+                                kind: "parameter",
+                                line: p.startPosition.row + 1,
+                                column: p.startPosition.column,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // Capture variable declarators
+        if (n.type === "variable_declarator") {
+            const name = n.childForFieldName("name")?.text;
+            if (name && currentScopeId) {
+                const targetScope = scopes.find(s => s.id === currentScopeId);
+                if (targetScope) {
+                    targetScope.variables.push({
+                        name,
+                        kind: "const",
+                        line: n.startPosition.row + 1,
+                        column: n.startPosition.column,
+                    });
+                }
+            }
+        }
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child)
+                traverseScope(child, currentScopeId);
+        }
+        return currentScopeId || 0;
+    }
+    traverseScope(rootNode);
+    // Detect shadowing across parent scopes
+    for (const scope of scopes) {
+        if (!scope.parentId)
+            continue;
+        for (const v of scope.variables) {
+            let ancestorId = scope.parentId;
+            while (ancestorId) {
+                const ancestor = scopes.find(s => s.id === ancestorId);
+                if (ancestor) {
+                    const shadowed = ancestor.variables.find(av => av.name === v.name);
+                    if (shadowed) {
+                        incidents.push({
+                            identifier: v.name,
+                            innerScopeLine: v.line,
+                            outerScopeLine: shadowed.line,
+                            warning: `Variable '${v.name}' at line ${v.line} shadows outer declaration at line ${shadowed.line}`,
+                        });
+                    }
+                    ancestorId = ancestor.parentId;
+                }
+                else {
+                    break;
+                }
+            }
+        }
+    }
+    return { scopes, incidents };
+}
+/**
+ * Main lexical scope resolver
+ */
+export async function resolveLexicalScope(params) {
+    let tree = null;
+    try {
+        const targetPath = params.filePath || "in_memory.ts";
+        let content = params.code ?? params.content;
+        if (content === undefined) {
+            if (params.filePath && existsSync(params.filePath)) {
+                content = await fs.readFile(params.filePath, "utf-8");
+            }
+            else {
+                return {
+                    success: false,
+                    error: `File does not exist: ${params.filePath || "none"}`,
+                };
+            }
+        }
+        const ext = path.extname(targetPath).toLowerCase();
+        let registry = params.registry;
+        if (!registry) {
+            const engine = new CodeContextEngine();
+            await engine.init();
+            registry = new ParserRegistry(engine);
+            await registry.init();
+        }
+        const parser = registry.getParser(ext === ".py" ? ".py" : ".ts");
+        if (!parser) {
+            return {
+                success: false,
+                error: `No parser available for extension: ${ext}`,
+            };
+        }
+        tree = parser.parse(content);
+        const { scopes, incidents } = buildScopeTree(tree.rootNode);
+        let canSafelyRename = true;
+        let renameCollisionWarning = undefined;
+        if (params.proposedRename) {
+            const { targetSymbol, newSymbolName, atLine } = params.proposedRename;
+            // Find innermost scope enclosing atLine (smallest line span)
+            const targetScope = scopes
+                .filter(s => atLine >= s.startLine && atLine <= s.endLine)
+                .sort((a, b) => (a.endLine - a.startLine) - (b.endLine - b.startLine))[0];
+            if (targetScope) {
+                // Check if newSymbolName already exists in this scope, its ancestors, or direct children
+                const checkScopes = [targetScope];
+                let curr = targetScope;
+                while (curr.parentId) {
+                    const parent = scopes.find(s => s.id === curr.parentId);
+                    if (parent) {
+                        checkScopes.push(parent);
+                        curr = parent;
+                    }
+                    else {
+                        break;
+                    }
+                }
+                for (const s of scopes) {
+                    if (s.parentId === targetScope.id && !checkScopes.includes(s)) {
+                        checkScopes.push(s);
+                    }
+                }
+                for (const s of checkScopes) {
+                    if (s.variables.some(v => v.name === newSymbolName)) {
+                        canSafelyRename = false;
+                        renameCollisionWarning = `Cannot safely rename '${targetSymbol}' to '${newSymbolName}': identifier '${newSymbolName}' is already declared in scope (Lines ${s.startLine}-${s.endLine}).`;
+                        break;
+                    }
+                }
+            }
+        }
+        const report = {
+            filePath: params.filePath,
+            totalScopes: scopes.length,
+            shadowingIncidents: incidents,
+            scopes,
+            canSafelyRename,
+            renameCollisionWarning,
+            summary: `Analyzed ${scopes.length} lexical scopes. Detected ${incidents.length} variable shadowing incidents.${renameCollisionWarning ? " ⚠️ Rename collision detected." : ""}`,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `resolve_lexical_scope failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    finally {
+        if (tree) {
+            try {
+                tree.delete();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=lexicalScope.js.map

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

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

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

@@ -4,3 +4,24 @@ export { extractSymbol, readLines } from "./readCore.js";
 export { searchPattern } from "./searchOperation.js";
 export { analyzeImpact } from "./impactAnalysis.js";
 export { searchSymbols, explainSymbol, batchRead } from "./symbolQuery.js";
+export { searchCodeConcept } from "./conceptSearch.js";
+export { verifyImportIntegrity } from "./importIntegrity.js";
+export { traceTaintFlow } from "./taintAnalysis.js";
+export { backfillTypes } from "./typeInference.js";
+export { enforceArchitectureRules } from "./architectureLinter.js";
+export { compactContextLedger } from "./contextCompactor.js";
+export { generateAstImpactReport } from "./blastRadiusReport.js";
+export { queryCodeAst } from "./astQuery.js";
+export { incrementalAstDiff } from "./incrementalDiff.js";
+export { getAstComplexityMatrix } from "./astComplexity.js";
+export { generateAstMocks } from "./astMockGenerator.js";
+export { detectDeadAstSymbols } from "./deadSymbols.js";
+export { resolveLexicalScope } from "./lexicalScope.js";
+export { validateSqlAst } from "./sqlValidator.js";
+export { astCodemodTranspile } from "./cstCodemod.js";
+export { detectAsyncEventloopBlockers } from "./asyncBlockers.js";
+export { verifyEnvContractDrift } from "./envContract.js";
+export { auditErrorHandlingContracts } from "./errorAudit.js";
+export { extractApiRouteMatrix } from "./apiRoutes.js";
+export { flattenClassHierarchy } from "./classHierarchyFlattener.js";
+export { detectCircularDependencies } from "./circularDependencies.js";

package/dist/src/operations/read.js

@@ -2,4 +2,25 @@ export { extractSymbol, readLines } from "./readCore.js";
 export { searchPattern } from "./searchOperation.js";
 export { analyzeImpact } from "./impactAnalysis.js";
 export { searchSymbols, explainSymbol, batchRead } from "./symbolQuery.js";
+export { searchCodeConcept } from "./conceptSearch.js";
+export { verifyImportIntegrity } from "./importIntegrity.js";
+export { traceTaintFlow } from "./taintAnalysis.js";
+export { backfillTypes } from "./typeInference.js";
+export { enforceArchitectureRules } from "./architectureLinter.js";
+export { compactContextLedger } from "./contextCompactor.js";
+export { generateAstImpactReport } from "./blastRadiusReport.js";
+export { queryCodeAst } from "./astQuery.js";
+export { incrementalAstDiff } from "./incrementalDiff.js";
+export { getAstComplexityMatrix } from "./astComplexity.js";
+export { generateAstMocks } from "./astMockGenerator.js";
+export { detectDeadAstSymbols } from "./deadSymbols.js";
+export { resolveLexicalScope } from "./lexicalScope.js";
+export { validateSqlAst } from "./sqlValidator.js";
+export { astCodemodTranspile } from "./cstCodemod.js";
+export { detectAsyncEventloopBlockers } from "./asyncBlockers.js";
+export { verifyEnvContractDrift } from "./envContract.js";
+export { auditErrorHandlingContracts } from "./errorAudit.js";
+export { extractApiRouteMatrix } from "./apiRoutes.js";
+export { flattenClassHierarchy } from "./classHierarchyFlattener.js";
+export { detectCircularDependencies } from "./circularDependencies.js";
 //# sourceMappingURL=read.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/operations/read.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/operations/read.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/operations/readCore.js

@@ -23,8 +23,18 @@ export async function extractSymbol(params) {
                 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);
+                    let tree;
+                    let extracted = null;
+                    try {
+                        tree = params.parser.parse(content);
+                        extracted = params.parser.extractSymbol(tree, params.symbolName, params.className);
+                    }
+                    finally {
+                        try {
+                            tree?.delete();
+                        }
+                        catch { }
+                    }
                     if (extracted) {
                         return { success: true, content: extracted };
                     }
@@ -33,23 +43,33 @@ export async function extractSymbol(params) {
         }
         // 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(),
-            });
+        let tree;
+        let symbols = [];
+        let extracted = null;
+        try {
+            tree = params.parser.parse(content);
+            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(),
+                });
+            }
+            extracted = params.parser.extractSymbol(tree, params.symbolName, params.className);
+        }
+        finally {
+            try {
+                tree?.delete();
+            }
+            catch { }
         }
-        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(", ")}`,