@mohantn/gate-keeper 2.1.0

package/dist/mcp/handlers/graph.js

@@ -0,0 +1,283 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleFileContext = handleFileContext;
+exports.handleGraphSummary = handleGraphSummary;
+exports.handleDependencyGraph = handleDependencyGraph;
+const path = __importStar(require("path"));
+const helpers_1 = require("../helpers");
+const universal_analyzer_1 = require("../../analyzer/universal-analyzer");
+const shared_1 = require("./shared");
+const graph_summary_1 = require("../../graph/graph-summary");
+async function handleFileContext(args) {
+    const filePath = String(args.file_path ?? '');
+    if (!filePath)
+        return (0, shared_1.text)('Error: file_path is required.');
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(path.dirname(filePath)));
+    const encodedFile = encodeURIComponent(filePath);
+    const encodedRepo = encodeURIComponent(repo);
+    // Run fresh analysis (language analyzer + coverage) in parallel with daemon queries
+    const analyzer = new universal_analyzer_1.UniversalAnalyzer();
+    const [analysisResult, graphRaw, detailRaw, cyclesRaw, trendsRaw] = await Promise.all([
+        analyzer.analyze(filePath),
+        (0, helpers_1.fetchDaemonApi)(`/api/graph?repo=${encodedRepo}`),
+        (0, helpers_1.fetchDaemonApi)(`/api/file-detail?file=${encodedFile}&repo=${encodedRepo}`),
+        (0, helpers_1.fetchDaemonApi)(`/api/cycles?repo=${encodedRepo}`),
+        (0, helpers_1.fetchDaemonApi)(`/api/trends?file=${encodedFile}&repo=${encodedRepo}`),
+    ]);
+    const graph = graphRaw;
+    const detail = detailRaw;
+    const allCycles = (cyclesRaw ?? []);
+    const trends = (trendsRaw ?? []);
+    // Require at least one data source to succeed
+    const node = graph?.nodes.find(n => n.id === filePath);
+    if (!analysisResult && !node && !detail) {
+        return (0, shared_1.text)('File not found in the dependency graph and could not be analyzed. Ensure the file exists and is a supported type (.ts/.tsx/.jsx/.js/.cs).');
+    }
+    const minRating = (0, helpers_1.getMinRating)();
+    const lines = [];
+    // Use fresh analysis rating when available, fall back to daemon data
+    const rating = analysisResult?.rating ?? node?.rating ?? detail?.analysis?.rating ?? 0;
+    lines.push(`## File Context: ${path.basename(filePath)}`);
+    lines.push(`**Path:** ${filePath}`);
+    lines.push(`**Rating:** ${rating}/10 (minimum: ${minRating}) ${rating >= minRating ? '✅' : '❌'}`);
+    lines.push('');
+    // ── Fresh analysis section (from UniversalAnalyzer) ──
+    if (analysisResult) {
+        if (analysisResult.violations.length > 0) {
+            lines.push(`### Violations (${analysisResult.violations.length})`);
+            for (const v of analysisResult.violations) {
+                const loc = v.line ? ` (line ${v.line})` : '';
+                lines.push(`- **${v.severity.toUpperCase()}** [${v.type}]${loc}: ${v.message}`);
+            }
+            lines.push('');
+        }
+        lines.push('### Metrics');
+        lines.push(`- Lines of Code: ${analysisResult.metrics.linesOfCode}`);
+        lines.push(`- Cyclomatic Complexity: ${analysisResult.metrics.cyclomaticComplexity}`);
+        lines.push(`- Methods/Functions: ${analysisResult.metrics.numberOfMethods}`);
+        lines.push(`- Imports: ${analysisResult.metrics.importCount}`);
+        if (analysisResult.metrics.coveragePercent !== undefined) {
+            lines.push(`- Test Coverage: ${analysisResult.metrics.coveragePercent.toFixed(1)}%`);
+        }
+        else {
+            lines.push('- Test Coverage: no coverage data available');
+        }
+        lines.push('');
+        if (analysisResult.ratingBreakdown && analysisResult.ratingBreakdown.length > 0) {
+            lines.push('### Rating Breakdown');
+            lines.push('Starting at 10.0:');
+            for (const item of analysisResult.ratingBreakdown) {
+                lines.push(`- ${item.category}: −${item.deduction.toFixed(1)} (${item.detail})`);
+            }
+            lines.push(`**Final: ${rating}/10**`);
+            lines.push('');
+        }
+    }
+    // ── Graph data from daemon ──
+    if (graph) {
+        const imports = graph.edges.filter(e => e.source === filePath);
+        if (imports.length > 0) {
+            lines.push(`### Dependencies (${imports.length} files imported)`);
+            for (const edge of imports) {
+                const targetNode = graph.nodes.find(n => n.id === edge.target);
+                const targetRating = targetNode ? ` (rating: ${targetNode.rating})` : '';
+                lines.push(`- ${path.relative(repo, edge.target)}${targetRating} [${edge.type}]`);
+            }
+            lines.push('');
+        }
+        const dependents = graph.edges.filter(e => e.target === filePath);
+        if (dependents.length > 0) {
+            lines.push(`### Used By (${dependents.length} files depend on this)`);
+            for (const edge of dependents) {
+                const sourceNode = graph.nodes.find(n => n.id === edge.source);
+                const sourceRating = sourceNode ? ` (rating: ${sourceNode.rating})` : '';
+                lines.push(`- ${path.relative(repo, edge.source)}${sourceRating}`);
+            }
+            lines.push('');
+        }
+    }
+    const fileCycles = allCycles.filter(c => c.nodes.includes(filePath));
+    if (fileCycles.length > 0) {
+        lines.push(`### Circular Dependencies (${fileCycles.length} cycles)`);
+        for (const cycle of fileCycles) {
+            const chain = cycle.nodes.map(n => path.basename(n)).join(' → ');
+            lines.push(`- ${chain} → ${path.basename(cycle.nodes[0])}`);
+        }
+        lines.push('Each cycle costs −1.0 rating. Break cycles by extracting shared types or using dependency inversion.');
+        lines.push('');
+    }
+    // Fallback to daemon's rating breakdown if fresh analysis didn't provide one
+    if (!analysisResult?.ratingBreakdown?.length && detail?.ratingBreakdown && detail.ratingBreakdown.length > 0) {
+        lines.push('### Rating Breakdown (from daemon cache)');
+        lines.push('Starting at 10.0:');
+        for (const item of detail.ratingBreakdown) {
+            lines.push(`- ${item.category}: −${item.deduction.toFixed(1)} (${item.detail})`);
+        }
+        lines.push(`**Final: ${rating}/10**`);
+        lines.push('');
+    }
+    if (trends.length > 1) {
+        lines.push('### Rating Trend (last ' + trends.length + ' analyses)');
+        const oldest = trends[trends.length - 1];
+        const newest = trends[0];
+        const delta = newest.rating - oldest.rating;
+        const arrow = delta > 0 ? 'improving' : delta < 0 ? 'declining' : '→ stable';
+        lines.push(`${oldest.rating} → ${newest.rating} (${arrow})`);
+        lines.push('');
+    }
+    if (detail?.gitDiff) {
+        lines.push('### Uncommitted Changes');
+        lines.push(`+${detail.gitDiff.added} lines added, −${detail.gitDiff.removed} lines removed`);
+        lines.push('');
+    }
+    const graphImports = graph ? graph.edges.filter(e => e.source === filePath) : [];
+    const graphDependents = graph ? graph.edges.filter(e => e.target === filePath) : [];
+    const data = {
+        filePath,
+        rating,
+        analysis: analysisResult ?? detail?.analysis ?? null,
+        imports: graphImports,
+        dependents: graphDependents,
+        cycles: fileCycles,
+        ratingBreakdown: analysisResult?.ratingBreakdown ?? detail?.ratingBreakdown ?? [],
+        ratingTrend: trends,
+        gitDiff: detail?.gitDiff ?? null,
+    };
+    return (0, shared_1.envelope)('get_file_context', data, lines.join('\n'));
+}
+async function handleGraphSummary(args) {
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(process.cwd()));
+    const encodedRepo = encodeURIComponent(repo);
+    const [graphRaw, cyclesRaw] = await Promise.all([
+        (0, helpers_1.fetchDaemonApi)(`/api/graph?repo=${encodedRepo}`),
+        (0, helpers_1.fetchDaemonApi)(`/api/cycles?repo=${encodedRepo}`),
+    ]);
+    if (!graphRaw) {
+        return (0, shared_1.text)('Error: Gate Keeper daemon is not running. Start it with `npm run daemon` or `npm run dev`.');
+    }
+    const graph = graphRaw;
+    const cycles = (cyclesRaw ?? []);
+    // Initialize empty arrays for all nodes so every file is represented
+    const adjacency = {};
+    const reverseAdjacency = {};
+    for (const n of graph.nodes) {
+        adjacency[n.id] = [];
+        reverseAdjacency[n.id] = [];
+    }
+    for (const edge of graph.edges) {
+        adjacency[edge.source].push(edge.target);
+        reverseAdjacency[edge.target].push(edge.source);
+    }
+    const nodes = graph.nodes.map(n => ({
+        id: n.id,
+        rating: n.rating,
+        violations: n.violations.length,
+        loc: n.metrics.linesOfCode,
+    }));
+    const edges = graph.edges.map(e => ({
+        source: e.source,
+        target: e.target,
+        type: e.type,
+    }));
+    const summary = (0, graph_summary_1.buildGraphSummary)(graph.nodes, graph.edges, cycles, repo);
+    const markdown = (0, graph_summary_1.formatGraphSummaryMarkdown)(summary, repo);
+    const data = { repo, summary, cycles, nodes, edges, adjacency, reverseAdjacency };
+    return (0, shared_1.envelope)('get_graph_summary', data, markdown);
+}
+async function handleDependencyGraph(args) {
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(process.cwd()));
+    const encodedRepo = encodeURIComponent(repo);
+    const [graphRaw, cyclesRaw] = await Promise.all([
+        (0, helpers_1.fetchDaemonApi)(`/api/graph?repo=${encodedRepo}`),
+        (0, helpers_1.fetchDaemonApi)(`/api/cycles?repo=${encodedRepo}`),
+    ]);
+    if (!graphRaw) {
+        return (0, shared_1.text)('Error: Gate Keeper daemon is not running. Start it with `npm run daemon` or `npm run dev`.');
+    }
+    const graph = graphRaw;
+    const cycles = (cyclesRaw ?? []);
+    // ── Path interning: emit paths once in ordered array, reference by index ──
+    // Strip repo prefix so paths are relative (saves ~15% on large repos)
+    const nodeIndex = {};
+    const nodes = [];
+    const nd = [];
+    for (let i = 0; i < graph.nodes.length; i++) {
+        const n = graph.nodes[i];
+        nodeIndex[n.id] = i;
+        nodes.push(path.relative(repo, n.id));
+        nd.push({ r: n.rating, v: n.violations.length, l: n.metrics.linesOfCode });
+    }
+    // Adjacency as integer-indexed arrays (edges are redundant — dropped entirely)
+    const adj = nodes.map(() => []);
+    for (const edge of graph.edges) {
+        const src = nodeIndex[edge.source];
+        const tgt = nodeIndex[edge.target];
+        if (src !== undefined && tgt !== undefined) {
+            adj[src].push(tgt);
+        }
+    }
+    // Convert cycles to relative paths
+    const relativeCycles = cycles.map(c => ({
+        nodes: c.nodes.map(n => path.relative(repo, n)),
+    }));
+    const data = {
+        repo,
+        n: graph.nodes.length,
+        e: graph.edges.length,
+        c: cycles.length,
+        nodes,
+        nd,
+        adj,
+        cycles: relativeCycles,
+    };
+    // Simple LLM-friendly markdown: just counts + instructions
+    const markdown = [
+        `## Dependency Graph (Full)`,
+        `**Files:** ${graph.nodes.length} | **Edges:** ${graph.edges.length} | **Cycles:** ${cycles.length}`,
+        '',
+        'Full graph data is in `structuredContent.data`:',
+        '- `nodes` — ordered array of relative file paths (index = node ID)',
+        '- `nd` — per-file quality matched to nodes: `[{ r: rating, v: violations, l: loc }, ...]`',
+        '- `adj` — imports by node index: `adj[i]` = list of indices that `nodes[i]` imports',
+        '- `cycles` — circular dependency cycles with relative paths',
+        '- `n`/`e`/`c` — node/edge/cycle counts',
+        '',
+        'Reverse dependencies (who imports a file) are derivable from `adj` — iterate and invert.',
+        'Use `get_graph_summary` for pre-computed analytics (hotspots, worst files, module coupling).',
+    ].join('\n');
+    return (0, shared_1.envelope)('get_dependency_graph', data, markdown);
+}
+//# sourceMappingURL=graph.js.map

package/dist/mcp/handlers/graph.js.map

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

package/dist/mcp/handlers/impact-format.d.ts

@@ -0,0 +1,9 @@
+import { CycleInfo } from '../../graph/dependency-graph';
+import { RemediationPlan } from '../../types';
+import { GraphResponse } from './types';
+export declare function renderDirectDependents(graph: GraphResponse, directDeps: Set<string>, repo: string): string[];
+export declare function renderTransitiveDependents(graph: GraphResponse, transitiveDeps: string[], repo: string): string[];
+export declare function renderAtRiskDependents(graph: GraphResponse, allDeps: Set<string>, repo: string): string[];
+export declare function renderRemediationPlan(graph: GraphResponse, allDeps: Set<string>, cycles: CycleInfo[], repo: string): Promise<string[]>;
+export declare function buildRemediationPlan(rootFile: string, graph: GraphResponse, directDeps: Set<string>, allDeps: Set<string>): Promise<RemediationPlan>;
+//# sourceMappingURL=impact-format.d.ts.map

package/dist/mcp/handlers/impact-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-format.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/impact-format.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAY,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAIL,eAAe,EAGhB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAevD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAUV;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,cAAc,EAAE,MAAM,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAaV;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAcV;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB;AAyBD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB,OAAO,CAAC,eAAe,CAAC,CAsC1B"}

package/dist/mcp/handlers/impact-format.js

@@ -0,0 +1,189 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderDirectDependents = renderDirectDependents;
+exports.renderTransitiveDependents = renderTransitiveDependents;
+exports.renderAtRiskDependents = renderAtRiskDependents;
+exports.renderRemediationPlan = renderRemediationPlan;
+exports.buildRemediationPlan = buildRemediationPlan;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const dependency_graph_1 = require("../../graph/dependency-graph");
+const refactoring_advisor_1 = require("../../analyzer/refactoring-advisor");
+const universal_analyzer_1 = require("../../analyzer/universal-analyzer");
+const SEVERITY_GAIN = {
+    error: 1.5,
+    warning: 0.5,
+    info: 0.1,
+};
+// ── Shared instances ───────────────────────────────────────
+const fileAnalyzer = new universal_analyzer_1.UniversalAnalyzer();
+const refactoringAdvisor = new refactoring_advisor_1.RefactoringAdvisor();
+// ── Display helpers ─────────────────────────────────────────
+function renderDirectDependents(graph, directDeps, repo) {
+    if (directDeps.size === 0)
+        return [];
+    const lines = ['### Direct Dependents'];
+    for (const dep of directDeps) {
+        const node = graph.nodes.find(n => n.id === dep);
+        const ratingStr = node ? ` (rating: ${node.rating}, ${node.violations.length} violations)` : '';
+        lines.push(`- ${path.relative(repo, dep)}${ratingStr}`);
+    }
+    lines.push('');
+    return lines;
+}
+function renderTransitiveDependents(graph, transitiveDeps, repo) {
+    if (transitiveDeps.length === 0)
+        return [];
+    const lines = ['### Transitive Dependents'];
+    for (const dep of transitiveDeps.slice(0, 20)) {
+        const node = graph.nodes.find(n => n.id === dep);
+        const ratingStr = node ? ` (rating: ${node.rating})` : '';
+        lines.push(`- ${path.relative(repo, dep)}${ratingStr}`);
+    }
+    if (transitiveDeps.length > 20) {
+        lines.push(`... and ${transitiveDeps.length - 20} more`);
+    }
+    lines.push('');
+    return lines;
+}
+function renderAtRiskDependents(graph, allDeps, repo) {
+    const affectedNodes = graph.nodes.filter(n => allDeps.has(n.id));
+    const lowRated = affectedNodes.filter(n => n.rating < 6);
+    if (lowRated.length === 0)
+        return [];
+    const lines = [
+        '### At-Risk Dependents (rating < 6)',
+        'These files already have quality issues and may be fragile to upstream changes:',
+    ];
+    for (const node of lowRated.sort((a, b) => a.rating - b.rating)) {
+        lines.push(`- **${node.rating}/10** — ${path.relative(repo, node.id)} (${node.violations.length} violations)`);
+    }
+    lines.push('');
+    return lines;
+}
+async function renderRemediationPlan(graph, allDeps, cycles, repo) {
+    const affectedNodes = graph.nodes.filter(n => allDeps.has(n.id));
+    const atRisk = affectedNodes.filter(n => n.rating < 6).sort((a, b) => a.rating - b.rating);
+    if (atRisk.length === 0) {
+        if (allDeps.size === 0)
+            return [];
+        return ['No at-risk dependents (all affected files have rating ≥ 6). Change appears safe.', ''];
+    }
+    const lines = [
+        `### Remediation Plan for At-Risk Dependents (${atRisk.length} files with rating < 6)`,
+        'These files already have quality issues and need targeted fixes:',
+        '',
+    ];
+    for (const node of atRisk.slice(0, 5)) {
+        lines.push(`#### ${path.relative(repo, node.id)} — Rating: ${node.rating}/10`);
+        const hints = await computeHints(node, cycles);
+        if (hints.length === 0) {
+            lines.push(`- ${node.violations.length} violations detected. Re-analyze with \`analyze_file\` for specific hints.`);
+        }
+        else {
+            lines.push(`**Top fix (${hints[0].patternName}):** ${hints[0].rationale}`);
+            hints[0].steps.slice(0, 3).forEach((step, i) => lines.push(`${i + 1}. ${step}`));
+            if (hints.length > 1) {
+                lines.push(`_(and ${hints.length - 1} more hints — use \`suggest_refactoring\` for full detail)_`);
+            }
+        }
+        lines.push('');
+    }
+    if (atRisk.length > 5) {
+        lines.push(`... and ${atRisk.length - 5} more at-risk files. Use \`suggest_refactoring\` on each.`);
+    }
+    return lines;
+}
+async function computeHints(node, cycles) {
+    if (!fs.existsSync(node.id) || !fileAnalyzer.isSupportedFile(node.id))
+        return [];
+    const freshAnalysis = await fileAnalyzer.analyze(node.id);
+    return freshAnalysis ? refactoringAdvisor.suggest(freshAnalysis, cycles) : [];
+}
+function topViolationStep(analysis, dependencyOrder) {
+    const v = analysis.violations[0];
+    if (!v)
+        return null;
+    const fixObj = typeof v.fix === 'object' ? v.fix : undefined;
+    const action = fixObj?.confidence === 'deterministic' && fixObj.replacement !== undefined ? 'replace' : 'manual';
+    return {
+        filePath: analysis.path,
+        ruleId: v.ruleId ?? v.type,
+        span: fixObj?.replaceSpan ?? v.span,
+        action,
+        replacement: action === 'replace' ? fixObj?.replacement : undefined,
+        estimatedRatingGain: SEVERITY_GAIN[v.severity] ?? 0.1,
+        dependencyOrder,
+    };
+}
+async function buildRemediationPlan(rootFile, graph, directDeps, allDeps) {
+    const affectedNodes = graph.nodes.filter(n => allDeps.has(n.id));
+    const atRiskIds = affectedNodes
+        .filter(n => n.rating < 6)
+        .sort((a, b) => a.rating - b.rating)
+        .slice(0, 10)
+        .map(n => n.id);
+    // Restrict edges to the at-risk subgraph for ordering. Use full graph rating
+    // as the tiebreaker when a cycle stalls.
+    const subEdges = graph.edges.filter(e => atRiskIds.includes(e.source) && atRiskIds.includes(e.target));
+    const ratingByNode = new Map();
+    for (const n of graph.nodes)
+        ratingByNode.set(n.id, n.rating);
+    const ordered = (0, dependency_graph_1.topoSort)(atRiskIds, subEdges, ratingByNode);
+    const steps = [];
+    for (let i = 0; i < ordered.length; i++) {
+        const filePath = ordered[i];
+        if (!fs.existsSync(filePath) || !fileAnalyzer.isSupportedFile(filePath))
+            continue;
+        const analysis = await fileAnalyzer.analyze(filePath);
+        if (!analysis)
+            continue;
+        const step = topViolationStep(analysis, i);
+        if (step)
+            steps.push(step);
+    }
+    const estimatedTotalGain = steps.reduce((acc, s) => acc + s.estimatedRatingGain, 0);
+    return {
+        rootFile,
+        blastRadius: {
+            direct: [...directDeps],
+            transitive: [...allDeps].filter(d => !directDeps.has(d)),
+        },
+        steps,
+        estimatedTotalGain: Math.round(estimatedTotalGain * 10) / 10,
+    };
+}
+//# sourceMappingURL=impact-format.js.map

package/dist/mcp/handlers/impact-format.js.map

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

package/dist/mcp/handlers/impact.d.ts

@@ -0,0 +1,4 @@
+import { McpResponse } from './shared';
+export declare function handleImpactAnalysis(args: Record<string, unknown>): Promise<McpResponse>;
+export declare function handlePredictImpactWithRemediation(args: Record<string, unknown>): Promise<McpResponse>;
+//# sourceMappingURL=impact.d.ts.map

package/dist/mcp/handlers/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/impact.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,WAAW,EAAE,MAAM,UAAU,CAAC;AAyCvD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CA0CtB;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAwCtB"}