driftdetect-mcp 0.4.6 → 0.5.0

package/dist/tools/analysis/error-handling.js

@@ -0,0 +1,220 @@
+/**
+ * drift_error_handling - Error Handling Analysis
+ *
+ * Analysis tool for error handling patterns, boundaries, and gaps.
+ * Detects unhandled error paths and swallowed exceptions.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { createErrorHandlingAnalyzer, createCallGraphAnalyzer, } from 'driftdetect-core';
+import { createResponseBuilder, Errors } from '../../infrastructure/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DRIFT_DIR = '.drift';
+const ERROR_HANDLING_DIR = 'error-handling';
+// ============================================================================
+// Handler
+// ============================================================================
+export async function handleErrorHandling(projectRoot, args) {
+    const { action } = args;
+    switch (action) {
+        case 'status':
+            return handleStatus(projectRoot);
+        case 'gaps':
+            return handleGaps(projectRoot, args.limit, args.minSeverity);
+        case 'boundaries':
+            return handleBoundaries(projectRoot);
+        case 'unhandled':
+            return handleUnhandled(projectRoot, args.minSeverity);
+        case 'analyze':
+            return handleAnalyze(projectRoot, args.function);
+        default:
+            throw Errors.invalidArgument('action', `Invalid action: ${action}. Valid: status, gaps, boundaries, unhandled, analyze`);
+    }
+}
+// ============================================================================
+// Action Handlers
+// ============================================================================
+async function handleStatus(projectRoot) {
+    const builder = createResponseBuilder();
+    const dataPath = path.join(projectRoot, DRIFT_DIR, ERROR_HANDLING_DIR, 'topology.json');
+    try {
+        const data = JSON.parse(await fs.readFile(dataPath, 'utf-8'));
+        const { summary, metrics, topology } = data;
+        let summaryText = `🛡️ ${summary.totalFunctions} functions. `;
+        summaryText += `Coverage: ${summary.coveragePercent}%. `;
+        summaryText += `Quality: ${summary.avgQuality}/100. `;
+        summaryText += `${summary.unhandledPaths} unhandled paths.`;
+        const warnings = [];
+        if (summary.criticalUnhandled > 0) {
+            warnings.push(`${summary.criticalUnhandled} critical unhandled error paths`);
+        }
+        if (metrics.swallowedErrorCount > 0) {
+            warnings.push(`${metrics.swallowedErrorCount} swallowed errors`);
+        }
+        const hints = {
+            nextActions: summary.unhandledPaths > 0
+                ? ['Run drift_error_handling action="gaps" to see specific issues']
+                : ['Error handling looks good'],
+            warnings: warnings.length > 0 ? warnings : undefined,
+            relatedTools: ['drift_error_handling action="gaps"', 'drift_error_handling action="boundaries"'],
+        };
+        return builder
+            .withSummary(summaryText)
+            .withData({ summary, metrics, generatedAt: topology.generatedAt })
+            .withHints(hints)
+            .buildContent();
+    }
+    catch {
+        throw Errors.custom('NO_ERROR_HANDLING_DATA', 'No error handling analysis found. Build it first using the CLI: drift error-handling build', ['drift error-handling build']);
+    }
+}
+async function handleGaps(projectRoot, limit, minSeverity) {
+    const builder = createResponseBuilder();
+    const analyzer = await buildAnalyzer(projectRoot);
+    const gaps = analyzer.getGaps({
+        limit: limit ?? 20,
+        minSeverity: minSeverity ?? 'medium',
+        includeSuggestions: true,
+    });
+    const bySeverity = {
+        critical: 0,
+        high: 0,
+        medium: 0,
+        low: 0,
+    };
+    for (const gap of gaps) {
+        bySeverity[gap.severity]++;
+    }
+    let summaryText = `🔍 ${gaps.length} error handling gaps. `;
+    if (bySeverity.critical > 0)
+        summaryText += `🔴 ${bySeverity.critical} critical. `;
+    if (bySeverity.high > 0)
+        summaryText += `🟡 ${bySeverity.high} high. `;
+    const hints = {
+        nextActions: gaps.length > 0
+            ? [`Fix: ${gaps[0]?.suggestion ?? 'Add error handling'}`]
+            : ['No gaps found - good error handling!'],
+        relatedTools: ['drift_error_handling action="analyze"'],
+    };
+    return builder
+        .withSummary(summaryText)
+        .withData({ gaps, total: gaps.length, bySeverity })
+        .withHints(hints)
+        .buildContent();
+}
+async function handleBoundaries(projectRoot) {
+    const builder = createResponseBuilder();
+    const dataPath = path.join(projectRoot, DRIFT_DIR, ERROR_HANDLING_DIR, 'topology.json');
+    try {
+        const data = JSON.parse(await fs.readFile(dataPath, 'utf-8'));
+        const boundaries = data.topology.boundaries;
+        const frameworkBoundaries = boundaries.filter(b => b.isFrameworkBoundary).length;
+        let summaryText = `🛡️ ${boundaries.length} error boundaries. `;
+        summaryText += `${frameworkBoundaries} framework boundaries.`;
+        const hints = {
+            nextActions: boundaries.length === 0
+                ? ['Consider adding error boundaries to protect critical paths']
+                : ['Review boundary coverage'],
+            relatedTools: ['drift_error_handling action="unhandled"'],
+        };
+        return builder
+            .withSummary(summaryText)
+            .withData({ boundaries, total: boundaries.length, frameworkBoundaries })
+            .withHints(hints)
+            .buildContent();
+    }
+    catch {
+        throw Errors.custom('NO_ERROR_HANDLING_DATA', 'No error handling analysis found. Build it first.', ['drift error-handling build']);
+    }
+}
+async function handleUnhandled(projectRoot, minSeverity) {
+    const builder = createResponseBuilder();
+    const dataPath = path.join(projectRoot, DRIFT_DIR, ERROR_HANDLING_DIR, 'topology.json');
+    try {
+        const data = JSON.parse(await fs.readFile(dataPath, 'utf-8'));
+        let paths = data.topology.unhandledPaths;
+        // Filter by severity
+        if (minSeverity) {
+            const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+            const minOrder = severityOrder[minSeverity];
+            paths = paths.filter(p => severityOrder[p.severity] <= minOrder);
+        }
+        const bySeverity = {
+            critical: 0,
+            high: 0,
+            medium: 0,
+            low: 0,
+        };
+        for (const p of paths) {
+            bySeverity[p.severity]++;
+        }
+        let summaryText = `⚠️ ${paths.length} unhandled error paths. `;
+        if (bySeverity.critical > 0)
+            summaryText += `🔴 ${bySeverity.critical} critical. `;
+        if (bySeverity.high > 0)
+            summaryText += `🟡 ${bySeverity.high} high.`;
+        const hints = {
+            nextActions: paths.length > 0
+                ? [`Add error boundary at: ${paths[0]?.suggestedBoundary ?? 'entry point'}`]
+                : ['All error paths are handled!'],
+            warnings: bySeverity.critical > 0
+                ? ['Critical unhandled paths can cause application crashes']
+                : undefined,
+            relatedTools: ['drift_error_handling action="boundaries"'],
+        };
+        return builder
+            .withSummary(summaryText)
+            .withData({ paths, total: paths.length, bySeverity })
+            .withHints(hints)
+            .buildContent();
+    }
+    catch {
+        throw Errors.custom('NO_ERROR_HANDLING_DATA', 'No error handling analysis found. Build it first.', ['drift error-handling build']);
+    }
+}
+async function handleAnalyze(projectRoot, funcPath) {
+    const builder = createResponseBuilder();
+    if (!funcPath) {
+        throw Errors.missingParameter('function');
+    }
+    const analyzer = await buildAnalyzer(projectRoot);
+    const analysis = analyzer.getFunctionAnalysis(funcPath);
+    if (!analysis) {
+        throw Errors.custom('FUNCTION_NOT_FOUND', `Function not found: ${funcPath}`, ['Check the function path']);
+    }
+    const { profile, issues } = analysis;
+    let summaryText = `🔍 ${funcPath}: `;
+    summaryText += profile.hasTryCatch ? 'Has error handling. ' : 'No error handling. ';
+    summaryText += `Quality: ${profile.qualityScore}/100. `;
+    summaryText += `${issues.length} issues.`;
+    const hints = {
+        nextActions: analysis.suggestions,
+        warnings: issues.length > 0
+            ? issues.map(i => i.message)
+            : undefined,
+        relatedTools: ['drift_error_handling action="gaps"'],
+    };
+    return builder
+        .withSummary(summaryText)
+        .withData({ function: funcPath, analysis })
+        .withHints(hints)
+        .buildContent();
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+async function buildAnalyzer(projectRoot) {
+    const callGraphAnalyzer = createCallGraphAnalyzer({ rootDir: projectRoot });
+    await callGraphAnalyzer.initialize();
+    const callGraph = callGraphAnalyzer.getGraph();
+    if (!callGraph) {
+        throw Errors.custom('NO_CALL_GRAPH', 'Call graph required for error handling analysis', ['drift callgraph build']);
+    }
+    const analyzer = createErrorHandlingAnalyzer({ rootDir: projectRoot });
+    analyzer.setCallGraph(callGraph);
+    analyzer.build();
+    return analyzer;
+}
+//# sourceMappingURL=error-handling.js.map

package/dist/tools/analysis/error-handling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handling.js","sourceRoot":"","sources":["../../../src/tools/analysis/error-handling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,GAQxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAiD9E,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,IAAuB;IAEvB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/D,KAAK,YAAY;YACf,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,WAAW;YACd,OAAO,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD;YACE,MAAM,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,mBAAmB,MAAM,uDAAuD,CAAC,CAAC;IAC7H,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,KAAK,UAAU,YAAY,CACzB,WAAmB;IAEnB,MAAM,OAAO,GAAG,qBAAqB,EAA2B,CAAC;IAEjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAExF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE5C,IAAI,WAAW,GAAG,OAAO,OAAO,CAAC,cAAc,cAAc,CAAC;QAC9D,WAAW,IAAI,aAAa,OAAO,CAAC,eAAe,KAAK,CAAC;QACzD,WAAW,IAAI,YAAY,OAAO,CAAC,UAAU,QAAQ,CAAC;QACtD,WAAW,IAAI,GAAG,OAAO,CAAC,cAAc,mBAAmB,CAAC;QAE5D,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,iBAAiB,iCAAiC,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,mBAAmB,mBAAmB,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,WAAW,EAAE,OAAO,CAAC,cAAc,GAAG,CAAC;gBACrC,CAAC,CAAC,CAAC,+DAA+D,CAAC;gBACnE,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACpD,YAAY,EAAE,CAAC,oCAAoC,EAAE,0CAA0C,CAAC;SACjG,CAAC;QAEF,OAAO,OAAO;aACX,WAAW,CAAC,WAAW,CAAC;aACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;aACjE,SAAS,CAAC,KAAK,CAAC;aAChB,YAAY,EAAE,CAAC;IAEpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,CAAC,MAAM,CACjB,wBAAwB,EACxB,4FAA4F,EAC5F,CAAC,4BAA4B,CAAC,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,WAAmB,EACnB,KAAc,EACd,WAA2B;IAE3B,MAAM,OAAO,GAAG,qBAAqB,EAAyB,CAAC;IAE/D,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC5B,KAAK,EAAE,KAAK,IAAI,EAAE;QAClB,WAAW,EAAE,WAAW,IAAI,QAAQ;QACpC,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAkC;QAChD,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,GAAG,EAAE,CAAC;KACP,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,wBAAwB,CAAC;IAC5D,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC;QAAE,WAAW,IAAI,MAAM,UAAU,CAAC,QAAQ,aAAa,CAAC;IACnF,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC;QAAE,WAAW,IAAI,MAAM,UAAU,CAAC,IAAI,SAAS,CAAC;IAEvE,MAAM,KAAK,GAAG;QACZ,WAAW,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,oBAAoB,EAAE,CAAC;YACzD,CAAC,CAAC,CAAC,sCAAsC,CAAC;QAC5C,YAAY,EAAE,CAAC,uCAAuC,CAAC;KACxD,CAAC;IAEF,OAAO,OAAO;SACX,WAAW,CAAC,WAAW,CAAC;SACxB,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;SAClD,SAAS,CAAC,KAAK,CAAC;SAChB,YAAY,EAAE,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,WAAmB;IAEnB,MAAM,OAAO,GAAG,qBAAqB,EAA+B,CAAC;IAErE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAExF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAoB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC7D,MAAM,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC;QAEjF,IAAI,WAAW,GAAG,OAAO,UAAU,CAAC,MAAM,qBAAqB,CAAC;QAChE,WAAW,IAAI,GAAG,mBAAmB,wBAAwB,CAAC;QAE9D,MAAM,KAAK,GAAG;YACZ,WAAW,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;gBAClC,CAAC,CAAC,CAAC,4DAA4D,CAAC;gBAChE,CAAC,CAAC,CAAC,0BAA0B,CAAC;YAChC,YAAY,EAAE,CAAC,yCAAyC,CAAC;SAC1D,CAAC;QAEF,OAAO,OAAO;aACX,WAAW,CAAC,WAAW,CAAC;aACxB,QAAQ,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;aACvE,SAAS,CAAC,KAAK,CAAC;aAChB,YAAY,EAAE,CAAC;IAEpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,CAAC,MAAM,CACjB,wBAAwB,EACxB,mDAAmD,EACnD,CAAC,4BAA4B,CAAC,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,WAAmB,EACnB,WAA2B;IAE3B,MAAM,OAAO,GAAG,qBAAqB,EAA8B,CAAC;IAEpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAExF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,KAAK,GAAyB,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAE/D,qBAAqB;QACrB,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,aAAa,GAAkC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACjG,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;YAC5C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,UAAU,GAAkC;YAChD,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,GAAG,EAAE,CAAC;SACP,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,WAAW,GAAG,MAAM,KAAK,CAAC,MAAM,0BAA0B,CAAC;QAC/D,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC;YAAE,WAAW,IAAI,MAAM,UAAU,CAAC,QAAQ,aAAa,CAAC;QACnF,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC;YAAE,WAAW,IAAI,MAAM,UAAU,CAAC,IAAI,QAAQ,CAAC;QAEtE,MAAM,KAAK,GAAG;YACZ,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;gBAC3B,CAAC,CAAC,CAAC,0BAA0B,KAAK,CAAC,CAAC,CAAC,EAAE,iBAAiB,IAAI,aAAa,EAAE,CAAC;gBAC5E,CAAC,CAAC,CAAC,8BAA8B,CAAC;YACpC,QAAQ,EAAE,UAAU,CAAC,QAAQ,GAAG,CAAC;gBAC/B,CAAC,CAAC,CAAC,wDAAwD,CAAC;gBAC5D,CAAC,CAAC,SAAS;YACb,YAAY,EAAE,CAAC,0CAA0C,CAAC;SAC3D,CAAC;QAEF,OAAO,OAAO;aACX,WAAW,CAAC,WAAW,CAAC;aACxB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;aACpD,SAAS,CAAC,KAAK,CAAC;aAChB,YAAY,EAAE,CAAC;IAEpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,CAAC,MAAM,CACjB,wBAAwB,EACxB,mDAAmD,EACnD,CAAC,4BAA4B,CAAC,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,WAAmB,EACnB,QAAiB;IAEjB,MAAM,OAAO,GAAG,qBAAqB,EAA4B,CAAC;IAElE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,CAAC,MAAM,CACjB,oBAAoB,EACpB,uBAAuB,QAAQ,EAAE,EACjC,CAAC,yBAAyB,CAAC,CAC5B,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAErC,IAAI,WAAW,GAAG,MAAM,QAAQ,IAAI,CAAC;IACrC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACpF,WAAW,IAAI,YAAY,OAAO,CAAC,YAAY,QAAQ,CAAC;IACxD,WAAW,IAAI,GAAG,MAAM,CAAC,MAAM,UAAU,CAAC;IAE1C,MAAM,KAAK,GAAG;QACZ,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5B,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,CAAC,oCAAoC,CAAC;KACrD,CAAC;IAEF,OAAO,OAAO;SACX,WAAW,CAAC,WAAW,CAAC;SACxB,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;SAC1C,SAAS,CAAC,KAAK,CAAC;SAChB,YAAY,EAAE,CAAC;AACpB,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,KAAK,UAAU,aAAa,CAAC,WAAmB;IAC9C,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5E,MAAM,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IAE/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,MAAM,CACjB,eAAe,EACf,iDAAiD,EACjD,CAAC,uBAAuB,CAAC,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,2BAA2B,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACvE,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEjB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/analysis/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Analysis Tools Index
+ *
+ * Tools for deeper analysis of codebase patterns and quality.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const ANALYSIS_TOOLS: Tool[];
+export { handleTestTopology, type TestTopologyArgs, type TestTopologyAction } from './test-topology.js';
+export { handleCoupling, type CouplingArgs, type CouplingAction } from './coupling.js';
+export { handleErrorHandling, type ErrorHandlingArgs, type ErrorHandlingAction } from './error-handling.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAM/D,eAAO,MAAM,cAAc,EAAE,IAAI,EAkGhC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/analysis/index.js

@@ -0,0 +1,111 @@
+/**
+ * Analysis Tools Index
+ *
+ * Tools for deeper analysis of codebase patterns and quality.
+ */
+const TEST_TOPOLOGY_ACTIONS = ['status', 'coverage', 'uncovered', 'mocks', 'affected', 'quality'];
+const COUPLING_ACTIONS = ['status', 'cycles', 'hotspots', 'analyze', 'refactor-impact', 'unused-exports'];
+const ERROR_HANDLING_ACTIONS = ['status', 'gaps', 'boundaries', 'unhandled', 'analyze'];
+export const ANALYSIS_TOOLS = [
+    {
+        name: 'drift_test_topology',
+        description: 'Analyze test-to-code mappings, mock patterns, and test quality. Actions: status (overview), coverage (file coverage), uncovered (find gaps), mocks (mock analysis), affected (minimum test set), quality (test quality metrics).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: TEST_TOPOLOGY_ACTIONS,
+                    description: 'Action to perform: status, coverage, uncovered, mocks, affected, quality',
+                },
+                file: {
+                    type: 'string',
+                    description: 'File path for coverage/quality actions',
+                },
+                files: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Changed files for affected action',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results for uncovered action (default: 20)',
+                },
+                minRisk: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high'],
+                    description: 'Minimum risk level for uncovered action (default: medium)',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'drift_coupling',
+        description: 'Analyze module dependencies, detect cycles, and calculate coupling metrics (Robert C. Martin metrics). Actions: status (overview), cycles (dependency cycles), hotspots (highly coupled modules), analyze (specific module), refactor-impact (change impact), unused-exports (dead exports).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: COUPLING_ACTIONS,
+                    description: 'Action to perform: status, cycles, hotspots, analyze, refactor-impact, unused-exports',
+                },
+                module: {
+                    type: 'string',
+                    description: 'Module path for analyze/refactor-impact actions',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results for hotspots/unused-exports (default: 15/20)',
+                },
+                minCoupling: {
+                    type: 'number',
+                    description: 'Minimum coupling threshold for hotspots (default: 3)',
+                },
+                maxCycleLength: {
+                    type: 'number',
+                    description: 'Maximum cycle length to report (default: 10)',
+                },
+                minSeverity: {
+                    type: 'string',
+                    enum: ['info', 'warning', 'critical'],
+                    description: 'Minimum severity for cycles (default: info)',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'drift_error_handling',
+        description: 'Analyze error handling patterns, boundaries, and gaps. Detects unhandled error paths and swallowed exceptions. Actions: status (overview), gaps (find issues), boundaries (error boundaries), unhandled (unhandled paths), analyze (specific function).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ERROR_HANDLING_ACTIONS,
+                    description: 'Action to perform: status, gaps, boundaries, unhandled, analyze',
+                },
+                function: {
+                    type: 'string',
+                    description: 'Function path for analyze action',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results for gaps action (default: 20)',
+                },
+                minSeverity: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'critical'],
+                    description: 'Minimum severity for gaps/unhandled (default: medium)',
+                },
+            },
+            required: ['action'],
+        },
+    },
+];
+export { handleTestTopology } from './test-topology.js';
+export { handleCoupling } from './coupling.js';
+export { handleErrorHandling } from './error-handling.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/analysis/index.js.map

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

package/dist/tools/analysis/test-topology.d.ts

@@ -0,0 +1,43 @@
+/**
+ * drift_test_topology - Test Topology Analysis
+ *
+ * Analysis tool for test-to-code mappings, mock patterns, and test quality.
+ * Answers: "Which tests cover this code?" and "What's the minimum test set?"
+ */
+import { type TestTopologySummary, type MockAnalysis, type MinimumTestSet, type UncoveredFunction, type TestCoverage } from 'driftdetect-core';
+export type TestTopologyAction = 'status' | 'coverage' | 'uncovered' | 'mocks' | 'affected' | 'quality';
+export interface TestTopologyArgs {
+    action: TestTopologyAction;
+    file?: string;
+    files?: string[];
+    limit?: number;
+    minRisk?: 'low' | 'medium' | 'high';
+}
+export interface TestTopologyStatusData {
+    summary: TestTopologySummary;
+    mockAnalysis: MockAnalysis;
+    generatedAt?: string;
+}
+export interface TestTopologyCoverageData {
+    file: string;
+    coverage: TestCoverage;
+}
+export interface TestTopologyUncoveredData {
+    uncovered: UncoveredFunction[];
+    total: number;
+}
+export interface TestTopologyMocksData {
+    analysis: MockAnalysis;
+    warnings: string[];
+}
+export interface TestTopologyAffectedData {
+    changedFiles: string[];
+    result: MinimumTestSet;
+}
+export declare function handleTestTopology(projectRoot: string, args: TestTopologyArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=test-topology.d.ts.map

package/dist/tools/analysis/test-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-topology.d.ts","sourceRoot":"","sources":["../../../src/tools/analysis/test-topology.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAO1B,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,WAAW,GACX,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;CACxB;AAaD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmB7D"}