driftdetect-mcp 0.4.6 → 0.5.1

package/dist/tools/generation/explain.d.ts

@@ -0,0 +1,75 @@
+/**
+ * drift_explain - Comprehensive Code Explanation
+ * Uses LEARNED DATA from Drift's pattern detection and boundary analysis
+ *
+ * This tool leverages what Drift has already learned about the codebase:
+ * - PatternStore: Patterns discovered through semantic clustering
+ * - BoundaryStore: Data access points learned from scanning
+ * - CallGraphStore: Call relationships and reachability
+ */
+import { PatternStore, ManifestStore, BoundaryStore, CallGraphStore } from 'driftdetect-core';
+export type ExplanationDepth = 'summary' | 'detailed' | 'comprehensive';
+export type ExplanationFocus = 'security' | 'performance' | 'architecture' | 'testing';
+export interface ExplainArgs {
+    target: string;
+    depth?: ExplanationDepth;
+    focus?: ExplanationFocus;
+}
+export interface CodeExplanation {
+    summary: string;
+    purpose: string;
+    context: {
+        module: string;
+        role: string;
+        importance: 'critical' | 'high' | 'medium' | 'low';
+    };
+    patterns: Array<{
+        name: string;
+        category: string;
+        compliance: 'follows' | 'partial' | 'deviates';
+        note: string;
+    }>;
+    dependencies: {
+        imports: string[];
+        usedBy: string[];
+        calls: string[];
+        dataAccess: Array<{
+            table: string;
+            operation: string;
+            fields: string[];
+        }>;
+    };
+    security?: {
+        sensitiveData: string[];
+        accessLevel: string;
+        concerns: string[];
+        reachableSensitiveFields?: string[];
+    };
+    semantics?: {
+        functions: number;
+        asyncFunctions: number;
+        exportedFunctions: number;
+        dataAccessPoints: number;
+        frameworks: string[];
+    };
+    insights: string[];
+    nextSteps: string[];
+}
+export interface ExplainData {
+    target: string;
+    depth: ExplanationDepth;
+    focus?: ExplanationFocus | undefined;
+    explanation: CodeExplanation;
+}
+export declare function handleExplain(stores: {
+    pattern: PatternStore;
+    manifest: ManifestStore;
+    boundary: BoundaryStore;
+    callGraph: CallGraphStore;
+}, projectRoot: string, args: ExplainArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/tools/generation/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAG3D,MAAM,kBAAkB,CAAC;AAK1B,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAAE;AAEpG,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;KAAE,CAAC;IAC9F,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClH,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAClJ,QAAQ,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrH,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrI,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,eAAe,CAAC;CAAE;AAE7I,wBAAsB,aAAa,CACjC,MAAM,EAAE;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,cAAc,CAAA;CAAE,EAC9G,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GACrC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA2C7D"}

package/dist/tools/generation/explain.js

@@ -0,0 +1,238 @@
+/**
+ * drift_explain - Comprehensive Code Explanation
+ * Uses LEARNED DATA from Drift's pattern detection and boundary analysis
+ *
+ * This tool leverages what Drift has already learned about the codebase:
+ * - PatternStore: Patterns discovered through semantic clustering
+ * - BoundaryStore: Data access points learned from scanning
+ * - CallGraphStore: Call relationships and reachability
+ */
+import { PatternStore, ManifestStore, BoundaryStore, CallGraphStore, createCallGraphAnalyzer, } from 'driftdetect-core';
+import { createResponseBuilder } from '../../infrastructure/index.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export async function handleExplain(stores, projectRoot, args) {
+    const builder = createResponseBuilder();
+    const { target, depth = 'detailed', focus } = args;
+    await stores.pattern.initialize();
+    await stores.manifest.load();
+    const isFile = target.includes('/') || target.includes('.');
+    const relativePath = isFile ? (target.startsWith('/') ? path.relative(projectRoot, target) : target) : null;
+    let fileContent = null;
+    if (relativePath) {
+        try {
+            fileContent = await fs.readFile(path.join(projectRoot, relativePath), 'utf-8');
+        }
+        catch { /* not found */ }
+    }
+    if (!fileContent && !relativePath) {
+        return builder.withSummary(`Symbol search not yet implemented for: ${target}`)
+            .withData({ target, depth, focus, explanation: {
+                summary: `Could not find target: ${target}`, purpose: 'Unknown',
+                context: { module: 'unknown', role: 'unknown', importance: 'low' },
+                patterns: [], dependencies: { imports: [], usedBy: [], calls: [], dataAccess: [] },
+                insights: ['Target not found - try providing a file path'], nextSteps: ['Use drift_files_list to find relevant files'],
+            } }).buildContent();
+    }
+    // Use LEARNED data from BoundaryStore instead of re-extracting
+    await stores.boundary.initialize();
+    const fileAccessInfo = stores.boundary.getFileAccess(relativePath || '');
+    let dataAccessPoints = [];
+    // Get data access points that Drift has already learned for this file
+    if (fileAccessInfo.length > 0 && fileAccessInfo[0]) {
+        dataAccessPoints = fileAccessInfo[0].accessPoints;
+    }
+    const allPatterns = stores.pattern.getAll();
+    const filePatterns = relativePath ? allPatterns.filter(p => p.locations.some(l => l.file === relativePath) || p.outliers.some(o => o.file === relativePath)) : [];
+    const explanation = await analyzeCode(relativePath || target, fileContent || '', filePatterns, dataAccessPoints, projectRoot, depth, focus);
+    return builder.withSummary(explanation.summary)
+        .withData({ target: relativePath || target, depth, focus, explanation })
+        .withHints({ nextActions: explanation.nextSteps.slice(0, 3), relatedTools: ['drift_impact_analysis', 'drift_reachability', 'drift_code_examples'] })
+        .buildContent();
+}
+async function analyzeCode(file, _content, patterns, dataAccessPoints, projectRoot, depth, focus) {
+    const purpose = inferPurpose(file, dataAccessPoints);
+    const context = inferContext(file, patterns, dataAccessPoints);
+    const patternAnalysis = analyzePatterns(patterns, file);
+    const dependencies = await extractDependencies(dataAccessPoints, file, projectRoot);
+    let security;
+    if (depth !== 'summary' || focus === 'security') {
+        security = await analyzeSecurityContext(file, dataAccessPoints, projectRoot);
+    }
+    let semantics;
+    if (dataAccessPoints.length > 0) {
+        semantics = { functions: 0, asyncFunctions: 0, exportedFunctions: 0, dataAccessPoints: dataAccessPoints.length, frameworks: detectFrameworks(dataAccessPoints) };
+    }
+    const insights = generateInsights(file, patterns, dependencies, security, dataAccessPoints, focus);
+    const nextSteps = generateNextSteps(file, patterns, security, dataAccessPoints, focus);
+    const summary = buildSummary(file, purpose, context, patternAnalysis, security, semantics);
+    const result = { summary, purpose, context, patterns: patternAnalysis, dependencies, insights, nextSteps };
+    if (security)
+        result.security = security;
+    if (semantics)
+        result.semantics = semantics;
+    return result;
+}
+function inferPurpose(file, dataAccessPoints) {
+    const fileName = path.basename(file, path.extname(file));
+    if (dataAccessPoints.length > 0) {
+        const tables = [...new Set(dataAccessPoints.map(a => a.table))];
+        const operations = [...new Set(dataAccessPoints.map(a => a.operation))];
+        return `Data access layer for ${tables.join(', ')} (${operations.join(', ')})`;
+    }
+    if (/controller/i.test(fileName))
+        return 'HTTP request handler';
+    if (/service/i.test(fileName))
+        return 'Business logic service';
+    if (/repository/i.test(fileName))
+        return 'Data access layer';
+    if (/middleware/i.test(fileName))
+        return 'Request/response interceptor';
+    return 'Module providing specific functionality';
+}
+function inferContext(file, patterns, dataAccessPoints) {
+    const parts = file.split('/');
+    const module = parts.length > 1 ? parts[parts.length - 2] ?? 'root' : 'root';
+    let role = 'utility';
+    if (dataAccessPoints.length > 0)
+        role = 'data layer';
+    else if (patterns.some(p => p.category === 'api'))
+        role = 'API layer';
+    else if (patterns.some(p => p.category === 'data-access'))
+        role = 'data layer';
+    let importance = 'medium';
+    const sensitivePatterns = ['password', 'secret', 'token', 'api_key', 'ssn'];
+    if (dataAccessPoints.some(a => a.fields.some(f => sensitivePatterns.some(p => f.toLowerCase().includes(p)))))
+        importance = 'critical';
+    else if (dataAccessPoints.length > 0)
+        importance = 'high';
+    return { module, role, importance };
+}
+function analyzePatterns(patterns, file) {
+    return patterns.slice(0, 5).map(p => {
+        const isOutlier = p.outliers.some(o => o.file === file);
+        const isLocation = p.locations.some(l => l.file === file);
+        return {
+            name: p.name, category: p.category,
+            compliance: isOutlier ? 'deviates' : isLocation ? 'follows' : 'partial',
+            note: isOutlier ? `Deviates from ${p.locations.length} implementations` : `Consistent with ${p.locations.length} implementations`,
+        };
+    });
+}
+async function extractDependencies(dataAccessPoints, file, projectRoot) {
+    const imports = [];
+    const usedBy = [];
+    const dataAccess = [];
+    for (const access of dataAccessPoints) {
+        dataAccess.push({ table: access.table, operation: access.operation, fields: access.fields });
+    }
+    try {
+        const analyzer = createCallGraphAnalyzer({ rootDir: projectRoot });
+        await analyzer.initialize();
+        const graph = analyzer.getGraph();
+        if (graph) {
+            for (const func of analyzer.getFunctionsInFile(file)) {
+                for (const caller of func.calledBy) {
+                    const callerFunc = graph.functions.get(caller.callerId);
+                    if (callerFunc && !usedBy.includes(callerFunc.qualifiedName))
+                        usedBy.push(callerFunc.qualifiedName);
+                }
+            }
+        }
+    }
+    catch { /* Call graph not available */ }
+    return { imports: imports.slice(0, 10), usedBy: usedBy.slice(0, 10), calls: [], dataAccess };
+}
+async function analyzeSecurityContext(file, dataAccessPoints, projectRoot) {
+    const sensitiveData = [];
+    const concerns = [];
+    const reachableSensitiveFields = [];
+    const sensitivePatterns = ['password', 'secret', 'token', 'api_key', 'ssn'];
+    for (const access of dataAccessPoints) {
+        for (const field of access.fields) {
+            if (sensitivePatterns.some(p => field.toLowerCase().includes(p)) && !sensitiveData.includes(field))
+                sensitiveData.push(field);
+        }
+        if (access.isRawSql)
+            concerns.push(`Raw SQL at line ${access.line}`);
+    }
+    try {
+        const analyzer = createCallGraphAnalyzer({ rootDir: projectRoot });
+        await analyzer.initialize();
+        const graph = analyzer.getGraph();
+        if (graph) {
+            for (const func of analyzer.getFunctionsInFile(file)) {
+                const reachable = analyzer.getReachableDataFromFunction(`${file}:${func.name}`, { sensitiveOnly: true, maxDepth: 5 });
+                for (const sf of reachable.sensitiveFields) {
+                    const fieldName = `${sf.field.table}.${sf.field.field}`;
+                    if (!reachableSensitiveFields.includes(fieldName))
+                        reachableSensitiveFields.push(fieldName);
+                }
+            }
+        }
+    }
+    catch { /* Call graph not available */ }
+    if (!sensitiveData.length && !concerns.length && !reachableSensitiveFields.length)
+        return undefined;
+    const accessLevel = file.includes('admin') ? 'admin-only' : file.includes('api') ? 'public' : 'internal';
+    const result = { sensitiveData, accessLevel, concerns };
+    if (reachableSensitiveFields.length > 0)
+        result.reachableSensitiveFields = reachableSensitiveFields;
+    return result;
+}
+function detectFrameworks(dataAccessPoints) {
+    const frameworks = new Set();
+    const frameworkNames = {
+        'supabase': 'Supabase', 'prisma': 'Prisma', 'typeorm': 'TypeORM', 'sequelize': 'Sequelize',
+        'mongoose': 'Mongoose', 'django': 'Django', 'sqlalchemy': 'SQLAlchemy', 'efcore': 'Entity Framework',
+        'eloquent': 'Laravel/Eloquent', 'spring-data': 'Spring Data JPA', 'hibernate': 'Hibernate',
+        'drizzle': 'Drizzle', 'knex': 'Knex', 'doctrine': 'Doctrine',
+    };
+    for (const access of dataAccessPoints) {
+        if (access.framework)
+            frameworks.add(frameworkNames[access.framework] || access.framework);
+    }
+    return Array.from(frameworks);
+}
+function generateInsights(_file, patterns, _deps, security, dataAccessPoints, _focus) {
+    const insights = [];
+    if (dataAccessPoints.length > 0) {
+        const tables = [...new Set(dataAccessPoints.map(a => a.table))];
+        insights.push(`Accesses ${dataAccessPoints.length} data point(s) across ${tables.length} table(s)`);
+    }
+    if (patterns.length)
+        insights.push(`Participates in ${patterns.length} pattern(s)`);
+    if (security?.concerns.length)
+        insights.push(`⚠️ ${security.concerns.length} security concern(s)`);
+    if (security?.reachableSensitiveFields?.length)
+        insights.push(`🔒 Can reach ${security.reachableSensitiveFields.length} sensitive field(s)`);
+    return insights;
+}
+function generateNextSteps(file, patterns, security, dataAccessPoints, _focus) {
+    const steps = [];
+    if (security?.concerns.length)
+        steps.push('Run drift_suggest_changes with issue="security"');
+    if (security?.reachableSensitiveFields?.length)
+        steps.push('Use drift_reachability to trace sensitive data');
+    const outliers = patterns.filter(p => p.outliers.some(o => o.file === file));
+    if (outliers.length && outliers[0])
+        steps.push(`Review pattern "${outliers[0].name}" with drift_pattern_get`);
+    if (dataAccessPoints.some(a => a.isRawSql))
+        steps.push('Review raw SQL queries for injection vulnerabilities');
+    if (!steps.length)
+        steps.push('Use drift_code_examples to see similar implementations');
+    return steps;
+}
+function buildSummary(file, purpose, context, patterns, security, semantics) {
+    const fileName = path.basename(file);
+    let summary = `**${fileName}** is a ${context.importance}-importance ${context.role} file. ${purpose}. `;
+    if (semantics)
+        summary += `${semantics.dataAccessPoints} data access point(s). `;
+    const deviates = patterns.filter(p => p.compliance === 'deviates').length;
+    if (deviates)
+        summary += `⚠️ Deviates from ${deviates} pattern(s). `;
+    if (security?.concerns.length)
+        summary += `🔒 ${security.concerns.length} security concern(s).`;
+    return summary;
+}
+//# sourceMappingURL=explain.js.map

package/dist/tools/generation/explain.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * Generation Tools
+ *
+ * AI-powered tools for code generation, validation, and explanation.
+ * These tools close the loop between understanding and action.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const GENERATION_TOOLS: Tool[];
+export { handleSuggestChanges } from './suggest-changes.js';
+export { handleValidateChange } from './validate-change.js';
+export { handleExplain } from './explain.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAK/D,eAAO,MAAM,gBAAgB,EAAE,IAAI,EA6ElC,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/tools/generation/index.js

@@ -0,0 +1,90 @@
+/**
+ * Generation Tools
+ *
+ * AI-powered tools for code generation, validation, and explanation.
+ * These tools close the loop between understanding and action.
+ */
+const ISSUE_TYPES = ['outlier', 'security', 'coupling', 'error-handling', 'test-coverage', 'pattern-violation'];
+const EXPLANATION_DEPTHS = ['summary', 'detailed', 'comprehensive'];
+export const GENERATION_TOOLS = [
+    {
+        name: 'drift_suggest_changes',
+        description: 'Get AI-guided suggestions for fixing pattern violations, security issues, or code quality problems. Returns specific code changes with before/after examples and rationale.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                target: {
+                    type: 'string',
+                    description: 'File path or function name to analyze',
+                },
+                issue: {
+                    type: 'string',
+                    enum: ISSUE_TYPES,
+                    description: 'Type of issue to address: outlier (pattern violation), security, coupling, error-handling, test-coverage, pattern-violation',
+                },
+                patternId: {
+                    type: 'string',
+                    description: 'Specific pattern ID if addressing an outlier (from drift_patterns_list)',
+                },
+                maxSuggestions: {
+                    type: 'number',
+                    description: 'Maximum suggestions to return (default: 3)',
+                },
+            },
+            required: ['target'],
+        },
+    },
+    {
+        name: 'drift_validate_change',
+        description: 'Validate proposed code changes against codebase patterns. Returns compliance score, violations, and suggestions. Use before committing changes to ensure consistency.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                file: {
+                    type: 'string',
+                    description: 'File path where the change will be made',
+                },
+                content: {
+                    type: 'string',
+                    description: 'The proposed code content to validate',
+                },
+                diff: {
+                    type: 'string',
+                    description: 'Alternative: unified diff format of the change',
+                },
+                strictMode: {
+                    type: 'boolean',
+                    description: 'Fail on any pattern violation (default: false)',
+                },
+            },
+            required: ['file'],
+        },
+    },
+    {
+        name: 'drift_explain',
+        description: 'Get a comprehensive explanation of code in context of the codebase. Combines pattern analysis, call graph, security implications, and dependencies into a coherent narrative.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                target: {
+                    type: 'string',
+                    description: 'File path, function name, or code symbol to explain',
+                },
+                depth: {
+                    type: 'string',
+                    enum: EXPLANATION_DEPTHS,
+                    description: 'Level of detail: summary (quick overview), detailed (patterns + dependencies), comprehensive (full analysis)',
+                },
+                focus: {
+                    type: 'string',
+                    description: 'Optional focus area: security, performance, architecture, testing',
+                },
+            },
+            required: ['target'],
+        },
+    },
+];
+export { handleSuggestChanges } from './suggest-changes.js';
+export { handleValidateChange } from './validate-change.js';
+export { handleExplain } from './explain.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;AAChH,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAW;IACtC;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,6KAA6K;QAC1L,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,6HAA6H;iBAC3I;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yEAAyE;iBACvF;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,uKAAuK;QACpL,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,gDAAgD;iBAC9D;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,+KAA+K;QAC5L,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EAAE,8GAA8G;iBAC5H;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mEAAmE;iBACjF;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/tools/generation/suggest-changes.d.ts

@@ -0,0 +1,64 @@
+/**
+ * drift_suggest_changes - AI-Guided Refactoring Suggestions
+ *
+ * Analyzes code issues using LEARNED DATA from Drift's semantic analysis
+ * and provides specific, actionable suggestions for fixing pattern violations,
+ * security issues, or quality problems.
+ *
+ * Uses:
+ * - PatternStore: Patterns learned through semantic clustering
+ * - BoundaryStore: Data access points learned from scanning
+ * - ErrorHandlingAnalyzer: Error handling gaps
+ * - CallGraphAnalyzer: Security and reachability analysis
+ */
+import { PatternStore, BoundaryStore } from 'driftdetect-core';
+export type IssueType = 'outlier' | 'security' | 'coupling' | 'error-handling' | 'test-coverage' | 'pattern-violation';
+export interface SuggestChangesArgs {
+    target: string;
+    issue?: IssueType;
+    patternId?: string;
+    maxSuggestions?: number;
+}
+export interface CodeSuggestion {
+    id: string;
+    title: string;
+    description: string;
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    category: IssueType;
+    location: {
+        file: string;
+        startLine: number;
+        endLine: number;
+    };
+    before: string;
+    after: string;
+    rationale: string;
+    relatedPattern?: {
+        id: string;
+        name: string;
+        confidence: number;
+    };
+    effort: 'trivial' | 'small' | 'medium' | 'large';
+    impact: string;
+}
+export interface SuggestChangesData {
+    summary: string;
+    target: string;
+    issueType: IssueType | 'all';
+    suggestions: CodeSuggestion[];
+    stats: {
+        totalIssues: number;
+        bySeverity: Record<string, number>;
+        estimatedEffort: string;
+    };
+}
+export declare function handleSuggestChanges(stores: {
+    pattern: PatternStore;
+    boundary: BoundaryStore;
+}, projectRoot: string, args: SuggestChangesArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=suggest-changes.d.ts.map

package/dist/tools/generation/suggest-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-changes.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/suggest-changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,YAAY,EACZ,aAAa,EAMd,MAAM,kBAAkB,CAAC;AAS1B,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAMD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE;IACN,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;CACzB,EACD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA+H7D"}