driftdetect-mcp 0.4.4 → 0.5.0

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":"AAAA;;;;GAIG;AAIH,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAClG,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AAC1G,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,kOAAkO;QAC/O,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,qBAAqB;oBAC3B,WAAW,EAAE,0EAA0E;iBACxF;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,mCAAmC;iBACjD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;oBAC/B,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,8RAA8R;QAC3S,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,gBAAgB;oBACtB,WAAW,EAAE,uFAAuF;iBACrG;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC;oBACrC,WAAW,EAAE,6CAA6C;iBAC3D;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,yPAAyP;QACtQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,sBAAsB;oBAC5B,WAAW,EAAE,iEAAiE;iBAC/E;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2CAA2C;iBACzD;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;oBAC3C,WAAW,EAAE,uDAAuD;iBACrE;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAkD,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,cAAc,EAA0C,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAoD,MAAM,qBAAqB,CAAC"}

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"}

package/dist/tools/analysis/test-topology.js

@@ -0,0 +1,294 @@
+/**
+ * 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 * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { createTestTopologyAnalyzer, createCallGraphAnalyzer, } from 'driftdetect-core';
+import { createResponseBuilder, Errors } from '../../infrastructure/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DRIFT_DIR = '.drift';
+const TEST_TOPOLOGY_DIR = 'test-topology';
+// ============================================================================
+// Handler
+// ============================================================================
+export async function handleTestTopology(projectRoot, args) {
+    const { action } = args;
+    switch (action) {
+        case 'status':
+            return handleStatus(projectRoot);
+        case 'coverage':
+            return handleCoverage(projectRoot, args.file);
+        case 'uncovered':
+            return handleUncovered(projectRoot, args.limit, args.minRisk);
+        case 'mocks':
+            return handleMocks(projectRoot);
+        case 'affected':
+            return handleAffected(projectRoot, args.files ?? []);
+        case 'quality':
+            return handleQuality(projectRoot, args.file);
+        default:
+            throw Errors.invalidArgument('action', `Invalid action: ${action}. Valid actions: status, coverage, uncovered, mocks, affected, quality`);
+    }
+}
+// ============================================================================
+// Action Handlers
+// ============================================================================
+async function handleStatus(projectRoot) {
+    const builder = createResponseBuilder();
+    // Try to load cached data first
+    const summaryPath = path.join(projectRoot, DRIFT_DIR, TEST_TOPOLOGY_DIR, 'summary.json');
+    try {
+        const data = JSON.parse(await fs.readFile(summaryPath, 'utf-8'));
+        const { summary, mockAnalysis } = data;
+        let summaryText = `🧪 ${summary.testCases} tests in ${summary.testFiles} files. `;
+        summaryText += `Coverage: ${summary.functionCoveragePercent}% functions. `;
+        summaryText += `Quality: ${summary.avgQualityScore}/100.`;
+        const hints = {
+            nextActions: [
+                summary.functionCoveragePercent < 50
+                    ? 'Run drift_test_topology action="uncovered" to find gaps'
+                    : 'Good coverage - consider drift_test_topology action="mocks" for quality',
+            ],
+            relatedTools: ['drift_test_topology action="uncovered"', 'drift_test_topology action="mocks"'],
+        };
+        return builder
+            .withSummary(summaryText)
+            .withData({ summary, mockAnalysis, generatedAt: data.generatedAt })
+            .withHints(hints)
+            .buildContent();
+    }
+    catch {
+        throw Errors.custom('NO_TEST_TOPOLOGY', 'No test topology found. Build it first using the CLI: drift test-topology build', ['drift test-topology build']);
+    }
+}
+async function handleCoverage(projectRoot, file) {
+    const builder = createResponseBuilder();
+    if (!file) {
+        throw Errors.missingParameter('file');
+    }
+    // Build analyzer on-demand
+    const analyzer = await buildAnalyzer(projectRoot);
+    const coverage = analyzer.getCoverage(file);
+    if (!coverage) {
+        throw Errors.custom('NO_COVERAGE_DATA', `No coverage data for ${file}. Ensure call graph is built.`, ['drift callgraph build']);
+    }
+    const coveredCount = coverage.functions.filter((f) => f.isCovered).length;
+    let summaryText = `📊 ${file}: ${coverage.coveragePercent}% coverage. `;
+    summaryText += `${coveredCount}/${coverage.functions.length} functions tested.`;
+    const uncoveredFunctions = coverage.functions
+        .filter((f) => !f.isCovered)
+        .map((f) => f.name);
+    const hints = {
+        nextActions: uncoveredFunctions.length > 0
+            ? [`Add tests for: ${uncoveredFunctions.slice(0, 3).join(', ')}`]
+            : ['Full coverage achieved!'],
+        relatedTools: ['drift_test_topology action="uncovered"'],
+    };
+    return builder
+        .withSummary(summaryText)
+        .withData({ file, coverage })
+        .withHints(hints)
+        .buildContent();
+}
+async function handleUncovered(projectRoot, limit, minRisk) {
+    const builder = createResponseBuilder();
+    const analyzer = await buildAnalyzer(projectRoot);
+    const uncovered = analyzer.getUncoveredFunctions({
+        limit: limit ?? 20,
+        minRisk: minRisk ?? 'medium',
+        includeReasons: true,
+    });
+    const highRisk = uncovered.filter((f) => f.riskScore >= 60);
+    const mediumRisk = uncovered.filter((f) => f.riskScore >= 30 && f.riskScore < 60);
+    let summaryText = `🔍 ${uncovered.length} uncovered functions. `;
+    if (highRisk.length > 0) {
+        summaryText += `🔴 ${highRisk.length} high risk. `;
+    }
+    if (mediumRisk.length > 0) {
+        summaryText += `🟡 ${mediumRisk.length} medium risk.`;
+    }
+    const hints = {
+        nextActions: highRisk.length > 0
+            ? [`Priority: Add tests for ${highRisk[0]?.qualifiedName ?? 'high-risk functions'}`]
+            : ['Consider adding tests for medium-risk functions'],
+        warnings: highRisk.filter((f) => f.accessesSensitiveData).length > 0
+            ? ['Some uncovered functions access sensitive data']
+            : undefined,
+        relatedTools: ['drift_impact_analysis', 'drift_reachability'],
+    };
+    return builder
+        .withSummary(summaryText)
+        .withData({ uncovered, total: uncovered.length })
+        .withHints(hints)
+        .buildContent();
+}
+async function handleMocks(projectRoot) {
+    const builder = createResponseBuilder();
+    // Load cached data
+    const summaryPath = path.join(projectRoot, DRIFT_DIR, TEST_TOPOLOGY_DIR, 'summary.json');
+    try {
+        const data = JSON.parse(await fs.readFile(summaryPath, 'utf-8'));
+        const { mockAnalysis } = data;
+        const warnings = [];
+        if (mockAnalysis.internalPercent > 50) {
+            warnings.push('High internal mocking (>50%) may indicate tight coupling');
+        }
+        if (mockAnalysis.avgMockRatio > 0.7) {
+            warnings.push('High average mock ratio - tests may be brittle');
+        }
+        if (mockAnalysis.highMockRatioTests.length > 5) {
+            warnings.push(`${mockAnalysis.highMockRatioTests.length} tests have >70% mock ratio`);
+        }
+        let summaryText = `🎭 ${mockAnalysis.totalMocks} mocks. `;
+        summaryText += `${mockAnalysis.externalPercent}% external, ${mockAnalysis.internalPercent}% internal. `;
+        summaryText += `Avg ratio: ${Math.round(mockAnalysis.avgMockRatio * 100)}%.`;
+        const hints = {
+            nextActions: warnings.length > 0
+                ? ['Review high-mock tests for potential refactoring']
+                : ['Mock patterns look healthy'],
+            warnings: warnings.length > 0 ? warnings : undefined,
+            relatedTools: ['drift_test_topology action="quality"'],
+        };
+        return builder
+            .withSummary(summaryText)
+            .withData({ analysis: mockAnalysis, warnings })
+            .withHints(hints)
+            .buildContent();
+    }
+    catch {
+        throw Errors.custom('NO_TEST_TOPOLOGY', 'No test topology found. Build it first.', ['drift test-topology build']);
+    }
+}
+async function handleAffected(projectRoot, files) {
+    const builder = createResponseBuilder();
+    if (files.length === 0) {
+        throw Errors.missingParameter('files');
+    }
+    const analyzer = await buildAnalyzer(projectRoot);
+    const result = analyzer.getMinimumTestSet(files);
+    let summaryText = `🎯 ${result.selectedTests}/${result.totalTests} tests needed. `;
+    summaryText += `Coverage: ${result.changedCodeCoverage}%. `;
+    summaryText += `Time saved: ~${result.timeSaved}.`;
+    const hints = {
+        nextActions: result.tests.length > 0
+            ? [`Run: ${result.tests.slice(0, 3).map((t) => t.name).join(', ')}`]
+            : ['No tests found for changed files - consider adding coverage'],
+        relatedTools: ['drift_test_topology action="uncovered"'],
+    };
+    return builder
+        .withSummary(summaryText)
+        .withData({ changedFiles: files, result })
+        .withHints(hints)
+        .buildContent();
+}
+async function handleQuality(projectRoot, file) {
+    const builder = createResponseBuilder();
+    // Load cached data
+    const summaryPath = path.join(projectRoot, DRIFT_DIR, TEST_TOPOLOGY_DIR, 'summary.json');
+    try {
+        const data = JSON.parse(await fs.readFile(summaryPath, 'utf-8'));
+        const { summary } = data;
+        let summaryText = `📈 Test Quality: ${summary.avgQualityScore}/100. `;
+        summaryText += `Mock ratio: ${Math.round(summary.avgMockRatio * 100)}%.`;
+        const hints = {
+            nextActions: summary.avgQualityScore < 50
+                ? ['Improve test quality by adding assertions and error cases']
+                : ['Test quality is good'],
+            relatedTools: ['drift_test_topology action="mocks"'],
+        };
+        return builder
+            .withSummary(summaryText)
+            .withData({ file, summary })
+            .withHints(hints)
+            .buildContent();
+    }
+    catch {
+        throw Errors.custom('NO_TEST_TOPOLOGY', 'No test topology found. Build it first.', ['drift test-topology build']);
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+async function buildAnalyzer(projectRoot) {
+    const analyzer = createTestTopologyAnalyzer({});
+    // Load call graph
+    try {
+        const callGraphAnalyzer = createCallGraphAnalyzer({ rootDir: projectRoot });
+        await callGraphAnalyzer.initialize();
+        const graph = callGraphAnalyzer.getGraph();
+        if (graph) {
+            analyzer.setCallGraph(graph);
+        }
+    }
+    catch {
+        // Continue without call graph
+    }
+    // Extract tests by walking directory
+    const testFiles = await findTestFiles(projectRoot);
+    for (const testFile of testFiles) {
+        try {
+            const content = await fs.readFile(path.join(projectRoot, testFile), 'utf-8');
+            analyzer.extractFromFile(content, testFile);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    analyzer.buildMappings();
+    return analyzer;
+}
+/**
+ * Find test files by walking the directory tree
+ */
+async function findTestFiles(rootDir, subDir = '') {
+    const testFiles = [];
+    const currentDir = path.join(rootDir, subDir);
+    try {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = path.join(subDir, entry.name);
+            // Skip common non-source directories
+            if (entry.isDirectory()) {
+                if (['node_modules', 'vendor', 'dist', 'build', '.git', '.drift'].includes(entry.name)) {
+                    continue;
+                }
+                // Recurse into subdirectories
+                const subFiles = await findTestFiles(rootDir, relativePath);
+                testFiles.push(...subFiles);
+            }
+            else if (entry.isFile()) {
+                // Check if it's a test file
+                if (isTestFile(entry.name)) {
+                    testFiles.push(relativePath);
+                }
+            }
+        }
+    }
+    catch {
+        // Directory not readable, skip
+    }
+    return testFiles;
+}
+/**
+ * Check if a filename matches test file patterns
+ */
+function isTestFile(filename) {
+    const testPatterns = [
+        /\.test\.[jt]sx?$/,
+        /\.spec\.[jt]sx?$/,
+        /_test\.py$/,
+        /test_.*\.py$/,
+        /Test\.java$/,
+        /Tests\.java$/,
+        /Test\.cs$/,
+        /Tests\.cs$/,
+        /Test\.php$/,
+    ];
+    return testPatterns.some(pattern => pattern.test(filename));
+}
+//# sourceMappingURL=test-topology.js.map

package/dist/tools/analysis/test-topology.js.map

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

package/dist/tools/detail/code-examples.d.ts

@@ -3,8 +3,11 @@
  *
  * Detail tool that returns actual code snippets demonstrating patterns.
  * Essential before generating new code to match codebase conventions.
+ *
+ * MIGRATION: Now supports both legacy PatternStore and new IPatternService.
+ * The service-based approach is preferred for new code.
  */
-import type { PatternStore } from 'driftdetect-core';
+import type { PatternStore, IPatternService } from 'driftdetect-core';
 export interface CodeExample {
     patternId: string;
     patternName: string;
@@ -19,12 +22,26 @@ export interface CodeExamplesData {
     patternsFound: number;
     examplesReturned: number;
 }
-export declare function handleCodeExamples(store: PatternStore, projectRoot: string, args: {
+export interface CodeExamplesArgs {
     categories?: string[];
     pattern?: string;
     maxExamples?: number;
     contextLines?: number;
-}): Promise<{
+}
+/**
+ * Handle code examples using IPatternService (preferred)
+ */
+export declare function handleCodeExamplesWithService(service: IPatternService, projectRoot: string, args: CodeExamplesArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Handle code examples using legacy PatternStore (backward compatibility)
+ * @deprecated Use handleCodeExamplesWithService instead
+ */
+export declare function handleCodeExamples(store: PatternStore, projectRoot: string, args: CodeExamplesArgs): Promise<{
     content: Array<{
         type: string;
         text: string;

package/dist/tools/detail/code-examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-examples.d.ts","sourceRoot":"","sources":["../../../src/tools/detail/code-examples.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AAKtE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAYD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA0G7D"}
+{"version":3,"file":"code-examples.d.ts","sourceRoot":"","sources":["../../../src/tools/detail/code-examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAmB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKvF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAYD;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,eAAe,EACxB,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,CA4G7D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,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,CA0G7D"}

package/dist/tools/detail/code-examples.js

@@ -3,6 +3,9 @@
  *
  * Detail tool that returns actual code snippets demonstrating patterns.
  * Essential before generating new code to match codebase conventions.
+ *
+ * MIGRATION: Now supports both legacy PatternStore and new IPatternService.
+ * The service-based approach is preferred for new code.
  */
 import { createResponseBuilder, Errors } from '../../infrastructure/index.js';
 import * as fs from 'fs/promises';
@@ -15,6 +18,107 @@ const VALID_CATEGORIES = [
 ];
 const DEFAULT_MAX_EXAMPLES = 3;
 const DEFAULT_CONTEXT_LINES = 10;
+/**
+ * Handle code examples using IPatternService (preferred)
+ */
+export async function handleCodeExamplesWithService(service, projectRoot, args) {
+    const builder = createResponseBuilder();
+    // Validate categories
+    if (args.categories) {
+        for (const cat of args.categories) {
+            if (!VALID_CATEGORIES.includes(cat)) {
+                throw Errors.invalidCategory(cat, VALID_CATEGORIES);
+            }
+        }
+    }
+    const maxExamples = args.maxExamples ?? DEFAULT_MAX_EXAMPLES;
+    const contextLines = args.contextLines ?? DEFAULT_CONTEXT_LINES;
+    // Get patterns to show examples for
+    const result = await service.query({
+        filter: {
+            categories: args.categories,
+            search: args.pattern,
+        },
+        sort: {
+            field: 'confidence',
+            direction: 'desc',
+        },
+        pagination: {
+            offset: 0,
+            limit: 10, // Limit patterns to process
+        },
+    });
+    let patterns = result.patterns;
+    // If searching by specific pattern ID, also check exact match
+    if (args.pattern && !patterns.some(p => p.id === args.pattern)) {
+        const exactMatch = await service.getPattern(args.pattern);
+        if (exactMatch) {
+            patterns = [exactMatch, ...patterns];
+        }
+    }
+    const examples = [];
+    for (const pattern of patterns) {
+        // Get best locations (highest confidence, not outliers)
+        const outlierFiles = new Set(pattern.outliers.map(o => `${o.file}:${o.line}`));
+        const goodLocations = pattern.locations
+            .filter(loc => !outlierFiles.has(`${loc.file}:${loc.line}`))
+            .slice(0, maxExamples);
+        for (const loc of goodLocations) {
+            try {
+                const code = await extractCodeSnippet(path.join(projectRoot, loc.file), loc.line, contextLines);
+                if (code) {
+                    examples.push({
+                        patternId: pattern.id,
+                        patternName: pattern.name,
+                        category: pattern.category,
+                        file: loc.file,
+                        line: loc.line,
+                        code,
+                        explanation: pattern.description,
+                    });
+                }
+            }
+            catch {
+                // Skip files that can't be read
+                continue;
+            }
+            // Limit total examples
+            if (examples.length >= maxExamples * 5)
+                break;
+        }
+        if (examples.length >= maxExamples * 5)
+            break;
+    }
+    const data = {
+        examples,
+        patternsFound: patterns.length,
+        examplesReturned: examples.length,
+    };
+    // Build summary
+    let summary = `${examples.length} code examples from ${patterns.length} patterns.`;
+    if (args.categories?.length) {
+        summary = `${args.categories.join(', ')}: ${summary}`;
+    }
+    return builder
+        .withSummary(summary)
+        .withData(data)
+        .withHints({
+        nextActions: examples.length > 0
+            ? [
+                'Use these examples as templates for new code',
+                'Use drift_pattern_get for more details on specific patterns',
+            ]
+            : [
+                'Try different categories or run drift scan',
+            ],
+        relatedTools: ['drift_pattern_get', 'drift_patterns_list'],
+    })
+        .buildContent();
+}
+/**
+ * Handle code examples using legacy PatternStore (backward compatibility)
+ * @deprecated Use handleCodeExamplesWithService instead
+ */
 export async function handleCodeExamples(store, projectRoot, args) {
     const builder = createResponseBuilder();
     // Validate categories