driftdetect-mcp 0.6.0 → 0.7.0

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

@@ -0,0 +1,66 @@
+/**
+ * drift_recent - Show Recent Changes
+ *
+ * Layer: Surgical
+ * Token Budget: 400 target, 800 max
+ * Cache TTL: 1 minute (changes frequently)
+ * Invalidation Keys: git, decisions
+ *
+ * Shows what changed recently in a specific area.
+ * Solves: AI writes code using OLD patterns because it read an old file.
+ */
+export interface RecentArgs {
+    /** Directory or file to check */
+    area: string;
+    /** How far back to look (default: 7) */
+    days?: number;
+    /** Filter by change type */
+    type?: 'feat' | 'fix' | 'refactor' | 'all';
+}
+export interface RecentChange {
+    file: string;
+    type: 'added' | 'modified' | 'deleted';
+    commitType: string;
+    summary: string;
+    date: string;
+    author: string;
+}
+export interface RecentData {
+    changes: RecentChange[];
+    patternsChanged: string[];
+    newConventions: string[];
+    preferFiles: string[];
+}
+export declare function handleRecent(args: RecentArgs, projectRoot: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Tool definition for MCP registration
+ */
+export declare const recentToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            area: {
+                type: string;
+                description: string;
+            };
+            days: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=recent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recent.d.ts","sourceRoot":"","sources":["../../../src/tools/surgical/recent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC;CAC5C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD,wBAAsB,YAAY,CAChC,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqJ7D;AAkFD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CAsBhC,CAAC"}

package/dist/tools/surgical/recent.js

@@ -0,0 +1,238 @@
+/**
+ * drift_recent - Show Recent Changes
+ *
+ * Layer: Surgical
+ * Token Budget: 400 target, 800 max
+ * Cache TTL: 1 minute (changes frequently)
+ * Invalidation Keys: git, decisions
+ *
+ * Shows what changed recently in a specific area.
+ * Solves: AI writes code using OLD patterns because it read an old file.
+ */
+import { createResponseBuilder, Errors, metrics } from '../../infrastructure/index.js';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+// ============================================================================
+// Handler
+// ============================================================================
+export async function handleRecent(args, projectRoot) {
+    const startTime = Date.now();
+    const builder = createResponseBuilder();
+    // Validate input
+    if (!args.area || args.area.trim() === '') {
+        throw Errors.missingParameter('area');
+    }
+    const area = args.area.trim();
+    const days = Math.min(args.days ?? 7, 30);
+    const typeFilter = args.type ?? 'all';
+    // Get git log for the area
+    const since = `${days}.days.ago`;
+    try {
+        // Get commits affecting the area
+        const { stdout: logOutput } = await execAsync(`git log --since="${since}" --pretty=format:"%H|%s|%an|%ai" --name-status -- "${area}"`, { cwd: projectRoot, maxBuffer: 1024 * 1024 });
+        if (!logOutput.trim()) {
+            const data = {
+                changes: [],
+                patternsChanged: [],
+                newConventions: [],
+                preferFiles: [],
+            };
+            return builder
+                .withSummary(`No changes in "${area}" in the last ${days} days`)
+                .withData(data)
+                .withHints({
+                nextActions: ['Area is stable - existing code is current', 'Use drift_similar to find examples'],
+                relatedTools: ['drift_similar', 'drift_code_examples'],
+            })
+                .buildContent();
+        }
+        // Parse git log output
+        const changes = [];
+        const lines = logOutput.split('\n');
+        let currentCommit = null;
+        for (const line of lines) {
+            if (line.includes('|')) {
+                // Commit line
+                const [hash, message, author, date] = line.split('|');
+                currentCommit = {
+                    hash: hash ?? '',
+                    message: message ?? '',
+                    author: author ?? '',
+                    date: date?.split(' ')[0] ?? '',
+                };
+            }
+            else if (line.trim() && currentCommit) {
+                // File change line (A/M/D followed by filename)
+                const match = line.match(/^([AMD])\t(.+)$/);
+                if (match) {
+                    const [, status, file] = match;
+                    // Parse conventional commit type
+                    const commitType = parseCommitType(currentCommit.message);
+                    // Apply type filter
+                    if (typeFilter !== 'all' && commitType !== typeFilter) {
+                        continue;
+                    }
+                    changes.push({
+                        file: file ?? '',
+                        type: status === 'A' ? 'added' : status === 'D' ? 'deleted' : 'modified',
+                        commitType,
+                        summary: currentCommit.message.slice(0, 80),
+                        date: currentCommit.date,
+                        author: currentCommit.author,
+                    });
+                }
+            }
+        }
+        // Deduplicate by file (keep most recent)
+        const byFile = new Map();
+        for (const change of changes) {
+            if (!byFile.has(change.file)) {
+                byFile.set(change.file, change);
+            }
+        }
+        const uniqueChanges = Array.from(byFile.values()).slice(0, 15);
+        // Analyze patterns changed
+        const patternsChanged = analyzePatternChanges(uniqueChanges);
+        // Detect new conventions
+        const newConventions = detectNewConventions(uniqueChanges);
+        // Files to prefer (recently modified = more current)
+        const preferFiles = uniqueChanges
+            .filter(c => c.type === 'modified' && c.commitType !== 'fix')
+            .map(c => c.file)
+            .slice(0, 5);
+        const data = {
+            changes: uniqueChanges,
+            patternsChanged,
+            newConventions,
+            preferFiles,
+        };
+        // Build summary
+        const summary = `${uniqueChanges.length} change${uniqueChanges.length !== 1 ? 's' : ''} in "${area}" over last ${days} days. ${preferFiles.length} files recommended as current examples.`;
+        // Build hints
+        const hints = {
+            nextActions: preferFiles.length > 0
+                ? [
+                    `Use "${preferFiles[0]}" as a reference - it's recently updated`,
+                    'Check patternsChanged for any migration notes',
+                ]
+                : [
+                    'No recent modifications - existing patterns are stable',
+                    'Use drift_similar to find examples',
+                ],
+            relatedTools: ['drift_similar', 'drift_signature', 'drift_code_examples'],
+        };
+        if (patternsChanged.length > 0) {
+            hints.warnings = [`Patterns changed recently: ${patternsChanged.join(', ')}`];
+        }
+        // Record metrics
+        metrics.recordRequest('drift_recent', Date.now() - startTime, true, false);
+        return builder
+            .withSummary(summary)
+            .withData(data)
+            .withHints(hints)
+            .buildContent();
+    }
+    catch (error) {
+        // Git command failed - might not be a git repo
+        throw Errors.custom('GIT_ERROR', 'Failed to read git history. Ensure this is a git repository.', ['drift_status']);
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Parse conventional commit type from message
+ */
+function parseCommitType(message) {
+    const match = message.match(/^(feat|fix|refactor|chore|docs|test|style|perf|ci|build)(\(.+\))?:/i);
+    if (match) {
+        return match[1].toLowerCase();
+    }
+    // Fallback heuristics
+    const lower = message.toLowerCase();
+    if (lower.includes('fix') || lower.includes('bug'))
+        return 'fix';
+    if (lower.includes('add') || lower.includes('new') || lower.includes('implement'))
+        return 'feat';
+    if (lower.includes('refactor') || lower.includes('clean') || lower.includes('improve'))
+        return 'refactor';
+    return 'other';
+}
+/**
+ * Analyze which patterns might have changed
+ */
+function analyzePatternChanges(changes) {
+    const patterns = [];
+    for (const change of changes) {
+        const msg = change.summary.toLowerCase();
+        // Look for pattern-related keywords
+        if (msg.includes('error') || msg.includes('exception')) {
+            patterns.push('error-handling');
+        }
+        if (msg.includes('auth') || msg.includes('permission')) {
+            patterns.push('auth');
+        }
+        if (msg.includes('api') || msg.includes('endpoint')) {
+            patterns.push('api');
+        }
+        if (msg.includes('test')) {
+            patterns.push('testing');
+        }
+        if (msg.includes('style') || msg.includes('css') || msg.includes('theme')) {
+            patterns.push('styling');
+        }
+        if (msg.includes('migrat') || msg.includes('deprecat')) {
+            patterns.push('migration');
+        }
+    }
+    // Deduplicate
+    return [...new Set(patterns)];
+}
+/**
+ * Detect new conventions from commit messages
+ */
+function detectNewConventions(changes) {
+    const conventions = [];
+    for (const change of changes) {
+        const msg = change.summary.toLowerCase();
+        // Look for convention-related keywords
+        if (msg.includes('migrat') && msg.includes('to')) {
+            conventions.push(change.summary);
+        }
+        if (msg.includes('switch') || msg.includes('replace')) {
+            conventions.push(change.summary);
+        }
+        if (msg.includes('new pattern') || msg.includes('introduce')) {
+            conventions.push(change.summary);
+        }
+    }
+    return conventions.slice(0, 3);
+}
+/**
+ * Tool definition for MCP registration
+ */
+export const recentToolDefinition = {
+    name: 'drift_recent',
+    description: 'Show what changed recently in a specific area. Returns recent commits, pattern changes, and files to prefer as current examples. Use to avoid writing code based on outdated patterns.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            area: {
+                type: 'string',
+                description: 'Directory or file to check (e.g., "src/api/", "src/services/user.ts")',
+            },
+            days: {
+                type: 'number',
+                description: 'How far back to look (default: 7, max: 30)',
+            },
+            type: {
+                type: 'string',
+                enum: ['feat', 'fix', 'refactor', 'all'],
+                description: 'Filter by commit type (default: all)',
+            },
+        },
+        required: ['area'],
+    },
+};
+//# sourceMappingURL=recent.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * drift_signature - Get Function/Class Signatures
+ *
+ * Layer: Surgical
+ * Token Budget: 200 target, 500 max
+ * Cache TTL: 5 minutes
+ * Invalidation Keys: callgraph, file:{path}
+ *
+ * Returns just the signature without reading entire files.
+ * Solves: AI reads 500-line files just to see a 1-line signature.
+ */
+import type { CallGraphStore } from 'driftdetect-core';
+export interface SignatureArgs {
+    /** Symbol to look up (function, method, class name) */
+    symbol: string;
+    /** Optional: specific file to search in */
+    file?: string;
+    /** Include JSDoc/docstring? (default: true) */
+    includeDocs?: boolean;
+}
+export interface SignatureInfo {
+    file: string;
+    line: number;
+    kind: 'function' | 'method' | 'class' | 'interface' | 'type';
+    signature: string;
+    parameters?: Array<{
+        name: string;
+        type: string;
+        required: boolean;
+        default?: string | undefined;
+    }>;
+    returnType?: string | undefined;
+    docs?: string | undefined;
+    exported: boolean;
+    className?: string | undefined;
+    decorators?: string[] | undefined;
+}
+export interface SignatureData {
+    found: boolean;
+    signatures: SignatureInfo[];
+}
+export declare function handleSignature(store: CallGraphStore, args: SignatureArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Tool definition for MCP registration
+ */
+export declare const signatureToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            symbol: {
+                type: string;
+                description: string;
+            };
+            file: {
+                type: string;
+                description: string;
+            };
+            includeDocs: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=signature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../src/tools/surgical/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AAOrE,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAMD,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA4H7D;AAwDD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;CAqBnC,CAAC"}

package/dist/tools/surgical/signature.js

@@ -0,0 +1,190 @@
+/**
+ * drift_signature - Get Function/Class Signatures
+ *
+ * Layer: Surgical
+ * Token Budget: 200 target, 500 max
+ * Cache TTL: 5 minutes
+ * Invalidation Keys: callgraph, file:{path}
+ *
+ * Returns just the signature without reading entire files.
+ * Solves: AI reads 500-line files just to see a 1-line signature.
+ */
+import { createResponseBuilder, Errors, metrics } from '../../infrastructure/index.js';
+// ============================================================================
+// Handler
+// ============================================================================
+export async function handleSignature(store, args) {
+    const startTime = Date.now();
+    const builder = createResponseBuilder();
+    // Validate input
+    if (!args.symbol || args.symbol.trim() === '') {
+        throw Errors.missingParameter('symbol');
+    }
+    const symbol = args.symbol.trim();
+    // includeDocs reserved for future use
+    // const includeDocs = args.includeDocs !== false;
+    // 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']);
+    }
+    // Find matching functions
+    const matches = [];
+    for (const [, func] of graph.functions) {
+        // Match by name or qualified name
+        const nameMatch = func.name === symbol ||
+            func.qualifiedName === symbol ||
+            func.qualifiedName.endsWith(`.${symbol}`);
+        // If file specified, filter by file
+        const fileMatch = !args.file ||
+            func.file === args.file ||
+            func.file.endsWith(args.file);
+        if (nameMatch && fileMatch) {
+            matches.push(func);
+        }
+    }
+    // Build signatures
+    const signatures = matches.map(func => {
+        const sig = buildSignature(func);
+        return {
+            file: func.file,
+            line: func.startLine,
+            kind: func.className ? 'method' : 'function',
+            signature: sig,
+            parameters: func.parameters.map(p => ({
+                name: p.name,
+                type: p.type || 'unknown',
+                required: !p.hasDefault,
+                default: p.hasDefault ? '...' : undefined,
+            })),
+            returnType: func.returnType,
+            exported: func.isExported,
+            className: func.className,
+            decorators: func.decorators.length > 0 ? func.decorators : undefined,
+        };
+    });
+    // Sort by relevance: exact name match first, then exported, then by file
+    signatures.sort((a, b) => {
+        // Exact name match
+        const aExact = a.signature.includes(` ${symbol}(`) ? 0 : 1;
+        const bExact = b.signature.includes(` ${symbol}(`) ? 0 : 1;
+        if (aExact !== bExact)
+            return aExact - bExact;
+        // Exported first
+        if (a.exported !== b.exported)
+            return a.exported ? -1 : 1;
+        // Alphabetical by file
+        return a.file.localeCompare(b.file);
+    });
+    // Limit results
+    const limitedSignatures = signatures.slice(0, 5);
+    const data = {
+        found: limitedSignatures.length > 0,
+        signatures: limitedSignatures,
+    };
+    // Build summary
+    let summary;
+    if (limitedSignatures.length === 0) {
+        summary = `No signature found for "${symbol}"`;
+    }
+    else if (limitedSignatures.length === 1) {
+        const sig = limitedSignatures[0];
+        summary = `Found ${sig.kind} "${symbol}" in ${sig.file}:${sig.line}`;
+    }
+    else {
+        summary = `Found ${limitedSignatures.length} matches for "${symbol}"`;
+    }
+    // Build hints
+    const hints = {
+        nextActions: limitedSignatures.length > 0
+            ? [
+                `Use drift_callers to see who calls "${symbol}"`,
+                `Use drift_imports to get correct import statement`,
+            ]
+            : [
+                'Check spelling or try a partial name',
+                'Use drift_files_list to find relevant files',
+            ],
+        relatedTools: ['drift_callers', 'drift_imports', 'drift_type'],
+    };
+    if (signatures.length > 5) {
+        hints.warnings = [`${signatures.length - 5} additional matches not shown. Specify file to narrow results.`];
+    }
+    // Record metrics
+    metrics.recordRequest('drift_signature', Date.now() - startTime, true, false);
+    return builder
+        .withSummary(summary)
+        .withData(data)
+        .withHints(hints)
+        .buildContent();
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Build a human-readable signature string
+ */
+function buildSignature(func) {
+    const parts = [];
+    // Decorators (first one only for brevity)
+    if (func.decorators.length > 0) {
+        parts.push(`@${func.decorators[0]}`);
+    }
+    // Export keyword
+    if (func.isExported) {
+        parts.push('export');
+    }
+    // Async keyword
+    if (func.isAsync) {
+        parts.push('async');
+    }
+    // Function keyword
+    parts.push('function');
+    // Name
+    parts.push(func.name);
+    // Parameters
+    const params = func.parameters.map(p => {
+        let param = p.name;
+        if (p.type) {
+            param += `: ${p.type}`;
+        }
+        if (p.hasDefault) {
+            param += ' = ...';
+        }
+        return param;
+    }).join(', ');
+    // Build signature
+    let sig = parts.join(' ') + `(${params})`;
+    // Return type
+    if (func.returnType) {
+        sig += `: ${func.returnType}`;
+    }
+    return sig;
+}
+/**
+ * Tool definition for MCP registration
+ */
+export const signatureToolDefinition = {
+    name: 'drift_signature',
+    description: 'Get function/class signature without reading entire files. Returns signature, parameters, return type, and location. Use when you need to know a function\'s interface.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            symbol: {
+                type: 'string',
+                description: 'Function, method, or class name to look up',
+            },
+            file: {
+                type: 'string',
+                description: 'Optional: specific file to search in (relative path)',
+            },
+            includeDocs: {
+                type: 'boolean',
+                description: 'Include JSDoc/docstring (default: true)',
+            },
+        },
+        required: ['symbol'],
+    },
+};
+//# sourceMappingURL=signature.js.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * drift_similar - Find Semantically Similar Code
+ *
+ * Layer: Surgical
+ * Token Budget: 500 target, 1000 max
+ * Cache TTL: 5 minutes
+ * Invalidation Keys: patterns, callgraph
+ *
+ * Finds code semantically similar to what the AI is about to write.
+ * Solves: AI needs to see an example but there are 50 options. Which is most relevant?
+ */
+import type { CallGraphStore, PatternStore } from 'driftdetect-core';
+export interface SimilarArgs {
+    /** What kind of code are you writing? */
+    intent: 'api_endpoint' | 'service' | 'component' | 'hook' | 'utility' | 'test' | 'middleware';
+    /** Natural language description */
+    description: string;
+    /** Optional: limit to specific directory */
+    scope?: string;
+    /** Max results (default: 3) */
+    limit?: number;
+}
+export interface SimilarMatch {
+    file: string;
+    function?: string | undefined;
+    class?: string | undefined;
+    similarity: number;
+    reason: string;
+    preview: string;
+    patterns: string[];
+}
+export interface SimilarConventions {
+    naming: string;
+    errorHandling: string;
+    imports: string;
+}
+export interface SimilarData {
+    matches: SimilarMatch[];
+    conventions: SimilarConventions;
+}
+export declare function handleSimilar(callGraphStore: CallGraphStore, patternStore: PatternStore, args: SimilarArgs): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * Tool definition for MCP registration
+ */
+export declare const similarToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            intent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=similar.d.ts.map