mcp-code-context 3.9.2 → 7.0.0

package/dist/src/operations/blastRadiusReport.js

@@ -0,0 +1,236 @@
+/**
+ * Cryptographic AST Impact & Blast Radius Report Generator (v5.0.0)
+ *
+ * Compiles a deterministic Markdown audit report + SHA-256 cryptographic digest
+ * analyzing changed symbols across git refs or working tree, identifying impacted
+ * test suites via Test Impact Analysis (TIA), and verifying architectural boundaries.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+import { getImpactedTests } from "./testImpact.js";
+import { enforceArchitectureRules } from "./architectureLinter.js";
+import { analyzeImpact } from "./impactAnalysis.js";
+const execFileAsync = promisify(execFile);
+const GIT_REF_REGEX = /^[a-zA-Z0-9_.~^/@{}-]+$/;
+function isValidGitRef(ref) {
+    return typeof ref === "string" && GIT_REF_REGEX.test(ref) && !ref.startsWith("-");
+}
+/**
+ * Main generateAstImpactReport operation
+ */
+export async function generateAstImpactReport(params) {
+    try {
+        const baseRef = params.baseBranch || "main";
+        const targetRef = params.targetBranch || "HEAD";
+        if (!isValidGitRef(baseRef)) {
+            return {
+                success: false,
+                error: `Invalid base git reference: "${baseRef}"`,
+            };
+        }
+        if (targetRef !== "WORKING_TREE" && !isValidGitRef(targetRef)) {
+            return {
+                success: false,
+                error: `Invalid target git reference: "${targetRef}"`,
+            };
+        }
+        // 1. Get changed files via git diff
+        const diffArgs = targetRef === "WORKING_TREE"
+            ? ["diff", "--name-status", baseRef]
+            : ["diff", "--name-status", baseRef, targetRef];
+        let diffOutput = "";
+        try {
+            const res = await execFileAsync("git", diffArgs, { cwd: params.projectRoot, timeout: 15000 });
+            diffOutput = res.stdout;
+        }
+        catch {
+            // Fallback: If baseRef doesn't exist, try diffing against HEAD~1 or uncommitted changes
+            try {
+                const fallback = await execFileAsync("git", ["diff", "--name-status", "HEAD~1"], { cwd: params.projectRoot, timeout: 15000 });
+                diffOutput = fallback.stdout;
+            }
+            catch {
+                diffOutput = "";
+            }
+        }
+        const lines = diffOutput.trim().split("\n").filter(Boolean);
+        const modifiedSymbols = [];
+        const impactedTests = [];
+        const filesModified = [];
+        const commandsSet = new Set();
+        for (const line of lines) {
+            const parts = line.split(/\s+/);
+            const status = parts[0];
+            const relFile = parts[1];
+            if (!relFile || !relFile.match(/\.(ts|tsx|js|jsx|py|rb|php|go)$/)) {
+                continue;
+            }
+            filesModified.push(relFile);
+            const fullPath = path.join(params.projectRoot, relFile);
+            // Check patch for modified symbols
+            let filePatch = "";
+            try {
+                const patchArgs = targetRef === "WORKING_TREE"
+                    ? ["diff", "-U0", baseRef, "--", relFile]
+                    : ["diff", "-U0", baseRef, targetRef, "--", relFile];
+                const patchRes = await execFileAsync("git", patchArgs, { cwd: params.projectRoot });
+                filePatch = patchRes.stdout;
+            }
+            catch {
+                filePatch = "";
+            }
+            const patchLines = filePatch.split("\n");
+            const changedLines = patchLines
+                .filter(l => (l.startsWith("+") || l.startsWith("-")) && !l.startsWith("+++") && !l.startsWith("---"))
+                .map(l => l.substring(1).trim());
+            const fileSymbols = new Set();
+            for (const pLine of changedLines) {
+                const funcMatch = pLine.match(/(?:function|def|async|class|public|private)\s+([a-zA-Z0-9_$]+)/);
+                if (funcMatch && funcMatch[1] && !["function", "async", "class", "def", "if", "for", "while"].includes(funcMatch[1])) {
+                    fileSymbols.add(funcMatch[1]);
+                }
+            }
+            for (const sym of fileSymbols) {
+                let callersCount = 0;
+                try {
+                    const impact = await analyzeImpact({
+                        filePath: fullPath,
+                        projectRoot: params.projectRoot,
+                        rootDir: params.projectRoot,
+                    });
+                    if (impact && impact.content) {
+                        const parsed = JSON.parse(impact.content);
+                        callersCount = (parsed.dependents || []).length;
+                    }
+                }
+                catch { }
+                modifiedSymbols.push({
+                    filePath: relFile,
+                    symbolName: sym,
+                    changeType: status.startsWith("A") ? "ADDED" : status.startsWith("D") ? "DELETED" : "MODIFIED",
+                    callersCount,
+                });
+                // Run TIA on modified symbol if requested
+                if (params.includeTests !== false) {
+                    try {
+                        const tiaResult = await getImpactedTests({
+                            filePath: fullPath,
+                            symbolName: sym,
+                            projectRoot: params.projectRoot,
+                        });
+                        if (tiaResult.totalImpactedTests > 0) {
+                            for (const it of tiaResult.impactedTests) {
+                                const cmd = `${tiaResult.testRunner.command} ${it.testFile}`;
+                                impactedTests.push({
+                                    symbolName: sym,
+                                    testFile: path.relative(params.projectRoot, it.testFile).replace(/\\/g, "/"),
+                                    executionCommand: cmd,
+                                });
+                                commandsSet.add(cmd);
+                            }
+                        }
+                    }
+                    catch { }
+                }
+            }
+        }
+        // Check architectural compliance on modified files
+        let architecturalCompliance = true;
+        if (params.includeArchitecture !== false && filesModified.length > 0) {
+            for (const rel of filesModified.slice(0, 10)) {
+                try {
+                    const archRes = await enforceArchitectureRules({
+                        filePath: path.join(params.projectRoot, rel),
+                        projectRoot: params.projectRoot,
+                    });
+                    if (archRes.success && archRes.content) {
+                        const jsonPart = archRes.content.split("\n\n")[0];
+                        const parsed = JSON.parse(jsonPart);
+                        if (!parsed.compliant) {
+                            architecturalCompliance = false;
+                            break;
+                        }
+                    }
+                }
+                catch { }
+            }
+        }
+        // Determine Risk Level
+        let riskLevel = "LOW";
+        const totalCallers = modifiedSymbols.reduce((acc, s) => acc + s.callersCount, 0);
+        if (!architecturalCompliance || totalCallers > 20 || modifiedSymbols.some(s => s.changeType === "DELETED" && s.callersCount > 0)) {
+            riskLevel = "HIGH";
+        }
+        else if (totalCallers > 5 || filesModified.length > 5) {
+            riskLevel = "MEDIUM";
+        }
+        // Compute Cryptographic SHA-256 Digest
+        const digestPayload = JSON.stringify({
+            baseRef,
+            targetRef,
+            filesModified,
+            modifiedSymbols,
+            riskLevel,
+        });
+        const sha256Digest = crypto.createHash("sha256").update(digestPayload).digest("hex");
+        const recommendedTestCommand = Array.from(commandsSet).join(" && ") || "npm test";
+        // Build Markdown Report
+        const mdLines = [
+            `# 🛡️ AST Impact & Blast Radius Audit Report`,
+            ``,
+            `- **Branch Diff:** \`${baseRef}\` ➔ \`${targetRef}\``,
+            `- **Cryptographic SHA-256 Digest:** \`${sha256Digest}\``,
+            `- **Overall Blast Radius Risk:** **${riskLevel}**`,
+            `- **Files Modified:** ${filesModified.length}`,
+            `- **Symbols Altered:** ${modifiedSymbols.length}`,
+            `- **Impacted Test Suites (TIA):** ${impactedTests.length}`,
+            `- **Architectural Guardrails Compliance:** ${architecturalCompliance ? "✅ 100% Compliant (Zero Layer Violations)" : "⚠️ Boundary Violations Detected"}`,
+            ``,
+            `### 🔬 Modified Symbols & Callers Hierarchy`,
+            `| File | Symbol | Change Type | Impacted Callers |`,
+            `|---|---|:---:|:---:|`,
+        ];
+        if (modifiedSymbols.length === 0) {
+            mdLines.push(`| *(None detected or clean working tree)* | - | - | - |`);
+        }
+        else {
+            for (const s of modifiedSymbols) {
+                mdLines.push(`| \`${s.filePath}\` | \`${s.symbolName}\` | ${s.changeType} | **${s.callersCount}** |`);
+            }
+        }
+        mdLines.push(``);
+        mdLines.push(`### 🧪 Targeted Minimal Test Execution Plan`);
+        mdLines.push(`Run only the tests directly impacted by changed AST symbols:`);
+        mdLines.push(`\`\`\`bash`);
+        mdLines.push(recommendedTestCommand);
+        mdLines.push(`\`\`\``);
+        const markdownReport = mdLines.join("\n");
+        const data = {
+            baseRef,
+            targetRef,
+            sha256Digest,
+            riskLevel,
+            filesModifiedCount: filesModified.length,
+            symbolsModifiedCount: modifiedSymbols.length,
+            impactedTestsCount: impactedTests.length,
+            architecturalCompliance,
+            modifiedSymbols,
+            impactedTests,
+            recommendedTestCommand,
+            markdownReport,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(data, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `generate_ast_impact_report failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=blastRadiusReport.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { BaseParser } from "../parsers/base.js";
+import type { Tree } from "web-tree-sitter";
+export interface CallHierarchyNode {
+    name: string;
+    file: string;
+    hop: number;
+    direction: "caller" | "callee" | "root";
+    parent?: string;
+}
+export interface CallHierarchyResult {
+    root: {
+        symbol: string;
+        file: string;
+    };
+    nodes: CallHierarchyNode[];
+    mermaid: string;
+    totalNodes: number;
+    maxHopsReached: number;
+}
+export declare function getCallHierarchy(params: {
+    filePath: string;
+    symbolName: string;
+    direction?: "callers" | "callees" | "both";
+    maxHops?: number;
+    projectRoot: string;
+    parser?: BaseParser;
+    tree?: Tree;
+}): Promise<CallHierarchyResult>;

package/dist/src/operations/callHierarchy.js

@@ -0,0 +1,166 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { walkDir } from "../utils/fileWalker.js";
+import { SUPPORTED_EXTENSIONS, EXCLUDE_DIRS } from "../utils/constants.js";
+export async function getCallHierarchy(params) {
+    const direction = params.direction || "both";
+    const maxHops = Math.min(Math.max(1, params.maxHops || 3), 5);
+    const relRootFile = path.relative(params.projectRoot, params.filePath).replace(/\\/g, "/");
+    const nodes = [
+        {
+            name: params.symbolName,
+            file: relRootFile,
+            hop: 0,
+            direction: "root",
+        },
+    ];
+    const mermaidEdges = [];
+    const visitedSymbols = new Set([`${relRootFile}:${params.symbolName}`]);
+    // 1. CALLEES (What does this symbol call?)
+    if (direction === "callees" || direction === "both") {
+        let currentHopSymbols = [{ name: params.symbolName, file: params.filePath, relFile: relRootFile }];
+        for (let hop = 1; hop <= maxHops; hop++) {
+            const nextHopSymbols = [];
+            for (const cur of currentHopSymbols) {
+                try {
+                    const content = await fs.readFile(cur.file, "utf-8");
+                    // Locate symbol and extract its body using brace matching
+                    let body = content;
+                    const symIdx = content.indexOf(cur.name);
+                    if (symIdx !== -1) {
+                        const braceIdx = content.indexOf("{", symIdx);
+                        if (braceIdx !== -1 && braceIdx - symIdx < 200) {
+                            let depth = 1;
+                            let i = braceIdx + 1;
+                            while (i < content.length && depth > 0) {
+                                if (content[i] === "{")
+                                    depth++;
+                                else if (content[i] === "}")
+                                    depth--;
+                                i++;
+                            }
+                            body = content.substring(braceIdx + 1, i - 1);
+                        }
+                    }
+                    // Find calls: foo( or obj.foo(
+                    const callRegex = /(?:([a-zA-Z0-9_]+)\.)?([a-zA-Z0-9_]{3,})\s*\(/g;
+                    let callMatch;
+                    const discoveredInHop = new Set();
+                    while ((callMatch = callRegex.exec(body)) !== null) {
+                        const calleeName = callMatch[2];
+                        if (["if", "for", "while", "switch", "catch", "import", "require", "console", "return", "throw", "typeof"].includes(calleeName)) {
+                            continue;
+                        }
+                        const key = `${cur.relFile}:${calleeName}`;
+                        if (!visitedSymbols.has(key) && !discoveredInHop.has(calleeName)) {
+                            discoveredInHop.add(calleeName);
+                            visitedSymbols.add(key);
+                            nodes.push({
+                                name: calleeName,
+                                file: cur.relFile,
+                                hop,
+                                direction: "callee",
+                                parent: cur.name,
+                            });
+                            mermaidEdges.push(`  "${cur.name}" --> "${calleeName}"`);
+                            if (hop < maxHops) {
+                                nextHopSymbols.push({ name: calleeName, file: cur.file, relFile: cur.relFile });
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // ignore read failure
+                }
+            }
+            currentHopSymbols = nextHopSymbols;
+            if (currentHopSymbols.length === 0)
+                break;
+        }
+    }
+    // 2. CALLERS (Who calls this symbol?)
+    if (direction === "callers" || direction === "both") {
+        // Collect candidate caller files in a single pass to eliminate redundant disk I/O thrashing
+        const candidateCallerFiles = [];
+        await walkDir(params.projectRoot, {
+            extensions: SUPPORTED_EXTENSIONS,
+            excludeDirs: EXCLUDE_DIRS,
+            onFile: async (callerPath) => {
+                candidateCallerFiles.push(callerPath);
+            },
+        });
+        let currentTargets = [{ name: params.symbolName, relFile: relRootFile }];
+        for (let hop = 1; hop <= maxHops; hop++) {
+            const nextTargets = [];
+            for (const target of currentTargets) {
+                for (const callerPath of candidateCallerFiles) {
+                    try {
+                        const content = await fs.readFile(callerPath, "utf-8");
+                        if (!content.includes(target.name))
+                            continue;
+                        const relCaller = path.relative(params.projectRoot, callerPath).replace(/\\/g, "/");
+                        if (relCaller === target.relFile) {
+                            // Skip self file for caller detection
+                            continue;
+                        }
+                        // Locate enclosing function/method that calls target.name
+                        const lines = content.split("\n");
+                        let currentEnclosingFunction = path.basename(callerPath, path.extname(callerPath));
+                        for (const line of lines) {
+                            const funcDefMatch = line.match(/(?:(?:export|default|async|public|private|protected|static)\s+)*(?:function|def|class)\s+([a-zA-Z0-9_]+)|(?:(?:public|private|protected|async|static)\s+)*([a-zA-Z0-9_]+)\s*\([^)]*\)\s*\{/);
+                            if (funcDefMatch) {
+                                const candidate = funcDefMatch[1] || funcDefMatch[2];
+                                if (candidate && !["function", "class", "if", "for", "while", "switch", "catch", "return", "const", "let", "var", "default"].includes(candidate)) {
+                                    currentEnclosingFunction = candidate;
+                                }
+                            }
+                            if (line.includes(target.name) && currentEnclosingFunction !== target.name) {
+                                if (["function", "class", "if", "for", "while", "switch", "catch", "return", "const", "let", "var"].includes(currentEnclosingFunction)) {
+                                    continue;
+                                }
+                                const key = `${relCaller}:${currentEnclosingFunction}`;
+                                if (!visitedSymbols.has(key)) {
+                                    visitedSymbols.add(key);
+                                    nodes.push({
+                                        name: currentEnclosingFunction,
+                                        file: relCaller,
+                                        hop,
+                                        direction: "caller",
+                                        parent: target.name,
+                                    });
+                                    mermaidEdges.push(`  "${currentEnclosingFunction}" --> "${target.name}"`);
+                                    if (hop < maxHops) {
+                                        nextTargets.push({ name: currentEnclosingFunction, relFile: relCaller });
+                                    }
+                                }
+                                break;
+                            }
+                        }
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+            }
+            currentTargets = nextTargets;
+            if (currentTargets.length === 0)
+                break;
+        }
+    }
+    // Generate Mermaid diagram
+    const mermaidGraph = [
+        "graph TD",
+        ...Array.from(new Set(mermaidEdges)),
+    ].join("\n");
+    return {
+        root: {
+            symbol: params.symbolName,
+            file: relRootFile,
+        },
+        nodes,
+        mermaid: mermaidGraph,
+        totalNodes: nodes.length,
+        maxHopsReached: Math.max(...nodes.map(n => n.hop)),
+    };
+}
+//# sourceMappingURL=callHierarchy.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * AST Circular Import Cycle Detector (Tarjan's SCC Algorithm)
+ * v7.0.0 Enterprise AST Intelligence
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export interface DependencyCycle {
+    cycleLength: number;
+    cyclePath: string[];
+    recommendation: string;
+}
+export interface CircularDependenciesReport {
+    projectRoot: string;
+    totalFilesAnalyzed: number;
+    totalCyclesFound: number;
+    cycles: DependencyCycle[];
+    summary: string;
+}
+export interface CircularDependenciesOptions {
+    filesMap?: Record<string, string>;
+    filePaths?: string[];
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Detects circular import dependencies across codebase
+ */
+export declare function detectCircularDependencies(params: CircularDependenciesOptions): Promise<ReadResult>;