driftdetect-mcp 0.6.1 → 0.7.0

package/dist/tools/surgical/imports.d.ts

@@ -0,0 +1,61 @@
+/**
+ * drift_imports - Resolve Correct Imports
+ *
+ * Layer: Surgical
+ * Token Budget: 300 target, 600 max
+ * Cache TTL: 5 minutes
+ * Invalidation Keys: callgraph, file:{targetFile}
+ *
+ * Resolves correct import statements based on codebase conventions.
+ * Solves: Every codebase has different import conventions. AI guesses wrong.
+ */
+import type { CallGraphStore } from 'driftdetect-core';
+export interface ImportsArgs {
+    /** Symbols that need to be imported */
+    symbols: string[];
+    /** File where imports will be added */
+    targetFile: string;
+}
+export interface ImportConventions {
+    style: 'barrel' | 'deep' | 'mixed';
+    pathStyle: 'relative' | 'alias' | 'absolute';
+    alias?: string;
+    preferNamed: boolean;
+    preferType: boolean;
+}
+export interface ImportsData {
+    imports: string[];
+    unresolved: string[];
+    conventions: ImportConventions;
+}
+export declare function handleImports(store: CallGraphStore, args: ImportsArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Tool definition for MCP registration
+ */
+export declare const importsToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            symbols: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            targetFile: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=imports.d.ts.map

package/dist/tools/surgical/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/tools/surgical/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AAQrE,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,SAAS,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAMD,wBAAsB,aAAa,CACjC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6G7D;AA0GD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;CAkBjC,CAAC"}

package/dist/tools/surgical/imports.js

@@ -0,0 +1,211 @@
+/**
+ * drift_imports - Resolve Correct Imports
+ *
+ * Layer: Surgical
+ * Token Budget: 300 target, 600 max
+ * Cache TTL: 5 minutes
+ * Invalidation Keys: callgraph, file:{targetFile}
+ *
+ * Resolves correct import statements based on codebase conventions.
+ * Solves: Every codebase has different import conventions. AI guesses wrong.
+ */
+import { createResponseBuilder, Errors, metrics } from '../../infrastructure/index.js';
+import * as path from 'node:path';
+// ============================================================================
+// Handler
+// ============================================================================
+export async function handleImports(store, args) {
+    const startTime = Date.now();
+    const builder = createResponseBuilder();
+    // Validate input
+    if (!args.symbols || args.symbols.length === 0) {
+        throw Errors.missingParameter('symbols');
+    }
+    if (!args.targetFile) {
+        throw Errors.missingParameter('targetFile');
+    }
+    const symbols = args.symbols.map(s => s.trim()).filter(s => s.length > 0);
+    const targetFile = args.targetFile;
+    // Load call graph
+    await store.initialize();
+    const graph = store.getGraph();
+    if (!graph) {
+        throw Errors.custom('CALLGRAPH_NOT_BUILT', 'Call graph has not been built. Run "drift callgraph build" first.', ['drift_status']);
+    }
+    // Analyze existing import conventions in the codebase
+    const conventions = analyzeImportConventions(graph);
+    // Find where each symbol is exported
+    const symbolSources = new Map();
+    for (const [, func] of graph.functions) {
+        if (func.isExported) {
+            // Check if this function matches any requested symbol
+            for (const symbol of symbols) {
+                if (func.name === symbol || func.qualifiedName.endsWith(`.${symbol}`)) {
+                    symbolSources.set(symbol, {
+                        file: func.file,
+                        isDefault: false, // Functions are typically named exports
+                        isType: false,
+                    });
+                }
+            }
+        }
+    }
+    // Build import statements
+    const imports = [];
+    const unresolved = [];
+    // Group symbols by source file
+    const bySource = new Map();
+    for (const symbol of symbols) {
+        const source = symbolSources.get(symbol);
+        if (source) {
+            const existing = bySource.get(source.file) ?? [];
+            existing.push(symbol);
+            bySource.set(source.file, existing);
+        }
+        else {
+            unresolved.push(symbol);
+        }
+    }
+    // Generate import statements
+    for (const [sourceFile, syms] of bySource) {
+        const importPath = resolveImportPath(sourceFile, targetFile, conventions);
+        const importStatement = buildImportStatement(syms, importPath, conventions);
+        imports.push(importStatement);
+    }
+    const data = {
+        imports,
+        unresolved,
+        conventions,
+    };
+    // Build summary
+    let summary;
+    if (imports.length === 0 && unresolved.length > 0) {
+        summary = `Could not resolve imports for: ${unresolved.join(', ')}`;
+    }
+    else if (unresolved.length > 0) {
+        summary = `Generated ${imports.length} import${imports.length !== 1 ? 's' : ''}, ${unresolved.length} unresolved`;
+    }
+    else {
+        summary = `Generated ${imports.length} import${imports.length !== 1 ? 's' : ''} for ${symbols.length} symbol${symbols.length !== 1 ? 's' : ''}`;
+    }
+    // Build hints
+    const hints = {
+        nextActions: imports.length > 0
+            ? ['Copy imports to your file', 'Use drift_prevalidate to check your code']
+            : ['Use drift_signature to find the correct symbol name', 'Check if the symbol exists in the codebase'],
+        relatedTools: ['drift_signature', 'drift_prevalidate', 'drift_similar'],
+    };
+    if (unresolved.length > 0) {
+        hints.warnings = [`Could not find exports for: ${unresolved.join(', ')}`];
+    }
+    // Record metrics
+    metrics.recordRequest('drift_imports', Date.now() - startTime, true, false);
+    return builder
+        .withSummary(summary)
+        .withData(data)
+        .withHints(hints)
+        .buildContent();
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Analyze import conventions from the codebase
+ */
+function analyzeImportConventions(graph) {
+    // Default conventions (TypeScript-style)
+    const conventions = {
+        style: 'mixed',
+        pathStyle: 'relative',
+        preferNamed: true,
+        preferType: true,
+    };
+    // Look for path alias patterns in file paths
+    for (const [, func] of graph.functions) {
+        // Check for common alias patterns
+        if (func.file.includes('@/') || func.file.includes('~/')) {
+            conventions.pathStyle = 'alias';
+            conventions.alias = func.file.includes('@/') ? '@/' : '~/';
+            break;
+        }
+    }
+    // Check for barrel file patterns (index.ts exports)
+    let barrelCount = 0;
+    let deepCount = 0;
+    for (const [, func] of graph.functions) {
+        if (func.file.endsWith('index.ts') || func.file.endsWith('index.js')) {
+            barrelCount++;
+        }
+        else {
+            deepCount++;
+        }
+    }
+    if (barrelCount > deepCount * 0.3) {
+        conventions.style = 'barrel';
+    }
+    else if (barrelCount < deepCount * 0.1) {
+        conventions.style = 'deep';
+    }
+    return conventions;
+}
+/**
+ * Resolve the import path from target to source
+ */
+function resolveImportPath(sourceFile, targetFile, conventions) {
+    // If using alias, try to use it
+    if (conventions.pathStyle === 'alias' && conventions.alias) {
+        // Assume src/ is the alias root
+        if (sourceFile.includes('/src/')) {
+            const srcIndex = sourceFile.indexOf('/src/');
+            return conventions.alias + sourceFile.slice(srcIndex + 5).replace(/\.(ts|js|tsx|jsx)$/, '');
+        }
+    }
+    // Calculate relative path
+    const targetDir = path.dirname(targetFile);
+    let relativePath = path.relative(targetDir, sourceFile);
+    // Ensure it starts with ./ or ../
+    if (!relativePath.startsWith('.')) {
+        relativePath = './' + relativePath;
+    }
+    // Remove extension
+    relativePath = relativePath.replace(/\.(ts|js|tsx|jsx)$/, '');
+    // If barrel style and path ends with /index, remove it
+    if (conventions.style === 'barrel' && relativePath.endsWith('/index')) {
+        relativePath = relativePath.slice(0, -6);
+    }
+    return relativePath;
+}
+/**
+ * Build an import statement
+ */
+function buildImportStatement(symbols, importPath, conventions) {
+    // For now, always use named imports
+    const symbolList = symbols.join(', ');
+    // Use type import if conventions prefer it and all symbols look like types
+    const allTypes = symbols.every(s => /^[A-Z]/.test(s) && !s.includes('create') && !s.includes('use'));
+    const typePrefix = conventions.preferType && allTypes ? 'type ' : '';
+    return `import ${typePrefix}{ ${symbolList} } from '${importPath}';`;
+}
+/**
+ * Tool definition for MCP registration
+ */
+export const importsToolDefinition = {
+    name: 'drift_imports',
+    description: 'Resolve correct import statements based on codebase conventions. Returns ready-to-use import statements and detected conventions (barrel vs deep, alias vs relative).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            symbols: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Symbols that need to be imported',
+            },
+            targetFile: {
+                type: 'string',
+                description: 'File where imports will be added (relative path)',
+            },
+        },
+        required: ['symbols', 'targetFile'],
+    },
+};
+//# sourceMappingURL=imports.js.map

package/dist/tools/surgical/imports.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * Surgical Tools
+ *
+ * Ultra-focused, minimal-token tools for AI coding assistants.
+ * These tools provide surgical access to codebase intelligence,
+ * returning exactly what's needed for code generation.
+ *
+ * Layer: Surgical (between Orchestration and Detail)
+ * Token Budget: 200-500 target, 1000 max
+ *
+ * Tools:
+ * - drift_signature: Get function signatures without reading files
+ * - drift_callers: Lightweight "who calls this" lookup
+ * - drift_imports: Resolve correct import statements
+ * - drift_prevalidate: Validate code before writing
+ * - drift_similar: Find semantically similar code
+ * - drift_type: Expand type definitions
+ * - drift_recent: Show recent changes in area
+ * - drift_test_template: Generate test scaffolding
+ * - drift_dependencies: Package dependencies lookup (multi-language)
+ * - drift_middleware: Middleware pattern lookup
+ * - drift_hooks: React/Vue hooks lookup
+ * - drift_errors: Error types and handling gaps
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export * from './signature.js';
+export * from './callers.js';
+export * from './imports.js';
+export * from './prevalidate.js';
+export * from './similar.js';
+export * from './type.js';
+export * from './recent.js';
+export * from './test-template.js';
+export * from './dependencies.js';
+export * from './middleware.js';
+export * from './hooks.js';
+export * from './errors.js';
+/**
+ * All surgical tools
+ */
+export declare const SURGICAL_TOOLS: Tool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/surgical/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAe5B;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IAAI,EAahC,CAAC"}

package/dist/tools/surgical/index.js

@@ -0,0 +1,66 @@
+/**
+ * Surgical Tools
+ *
+ * Ultra-focused, minimal-token tools for AI coding assistants.
+ * These tools provide surgical access to codebase intelligence,
+ * returning exactly what's needed for code generation.
+ *
+ * Layer: Surgical (between Orchestration and Detail)
+ * Token Budget: 200-500 target, 1000 max
+ *
+ * Tools:
+ * - drift_signature: Get function signatures without reading files
+ * - drift_callers: Lightweight "who calls this" lookup
+ * - drift_imports: Resolve correct import statements
+ * - drift_prevalidate: Validate code before writing
+ * - drift_similar: Find semantically similar code
+ * - drift_type: Expand type definitions
+ * - drift_recent: Show recent changes in area
+ * - drift_test_template: Generate test scaffolding
+ * - drift_dependencies: Package dependencies lookup (multi-language)
+ * - drift_middleware: Middleware pattern lookup
+ * - drift_hooks: React/Vue hooks lookup
+ * - drift_errors: Error types and handling gaps
+ */
+export * from './signature.js';
+export * from './callers.js';
+export * from './imports.js';
+export * from './prevalidate.js';
+export * from './similar.js';
+export * from './type.js';
+export * from './recent.js';
+export * from './test-template.js';
+export * from './dependencies.js';
+export * from './middleware.js';
+export * from './hooks.js';
+export * from './errors.js';
+import { signatureToolDefinition } from './signature.js';
+import { callersToolDefinition } from './callers.js';
+import { importsToolDefinition } from './imports.js';
+import { prevalidateToolDefinition } from './prevalidate.js';
+import { similarToolDefinition } from './similar.js';
+import { typeToolDefinition } from './type.js';
+import { recentToolDefinition } from './recent.js';
+import { testTemplateToolDefinition } from './test-template.js';
+import { dependenciesToolDefinition } from './dependencies.js';
+import { middlewareToolDefinition } from './middleware.js';
+import { hooksToolDefinition } from './hooks.js';
+import { errorsToolDefinition } from './errors.js';
+/**
+ * All surgical tools
+ */
+export const SURGICAL_TOOLS = [
+    signatureToolDefinition,
+    callersToolDefinition,
+    importsToolDefinition,
+    prevalidateToolDefinition,
+    similarToolDefinition,
+    typeToolDefinition,
+    recentToolDefinition,
+    testTemplateToolDefinition,
+    dependenciesToolDefinition,
+    middlewareToolDefinition,
+    hooksToolDefinition,
+    errorsToolDefinition,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/surgical/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,uBAAuB;IACvB,qBAAqB;IACrB,qBAAqB;IACrB,yBAAyB;IACzB,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;IACpB,0BAA0B;IAC1B,0BAA0B;IAC1B,wBAAwB;IACxB,mBAAmB;IACnB,oBAAoB;CACrB,CAAC"}

package/dist/tools/surgical/middleware.d.ts

@@ -0,0 +1,69 @@
+/**
+ * drift_middleware - Middleware Pattern Lookup
+ *
+ * Layer: Surgical
+ * Token Budget: 300 target, 800 max
+ *
+ * Returns middleware patterns in the codebase.
+ * Solves: AI needs to know existing middleware when adding auth/logging/etc.
+ */
+export interface MiddlewareArgs {
+    /** Filter by type: auth, logging, validation, error, all */
+    type?: 'auth' | 'logging' | 'validation' | 'error' | 'all';
+    /** Framework filter: express, koa, fastify, nestjs, laravel, spring */
+    framework?: string;
+    /** Max results */
+    limit?: number;
+}
+export interface MiddlewareInfo {
+    name: string;
+    file: string;
+    line: number;
+    type: string;
+    framework?: string | undefined;
+    usages: number;
+    parameters?: string[] | undefined;
+}
+export interface MiddlewareData {
+    middleware: MiddlewareInfo[];
+    byType: Record<string, number>;
+    stats: {
+        total: number;
+        authCount: number;
+        loggingCount: number;
+        validationCount: number;
+        errorCount: number;
+    };
+}
+export declare function handleMiddleware(args: MiddlewareArgs, rootDir: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Tool definition for MCP registration
+ */
+export declare const middlewareToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            framework: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/tools/surgical/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/tools/surgical/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;IAC3D,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAMD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAyI7D;AAkFD;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;CAqBpC,CAAC"}