codedev-mcp 3.2.0

package/dist/tools/quality.js

@@ -0,0 +1,279 @@
+import { z } from 'zod';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD, safePath } from '../config.js';
+import { searchCode } from '../search/fast-search.js';
+/**
+ * Registers code quality tools for finding TODOs, debug logs, secrets, empty catches, duplicates, and dead code.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerQualityTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_todos — Find TODO/FIXME/HACK comments
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_todos', {
+        description: 'Find TODO, FIXME, HACK, XXX, BUG, and OPTIMIZE comments in the codebase.',
+        inputSchema: {
+            file_glob: z.string().optional().describe('Filter by file pattern, e.g. "*.ts"'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const searchCwd = params.directory ? safePath(params.directory) : CWD;
+            const results = await searchCode({
+                cwd: searchCwd,
+                pattern: '(TODO|FIXME|HACK|XXX|WARN|BUG|OPTIMIZE)\\b',
+                isRegex: true,
+                fileGlob: params.file_glob,
+                maxResults: 100,
+            });
+            const output = results.map((r) => `${r.file}:${r.line} │ ${r.text.trim()}`).join('\n');
+            return {
+                content: [{ type: 'text', text: `Found ${results.length} TODOs:\n\n${output}` }],
+                structuredContent: {
+                    check: 'todos',
+                    matches: results.map((r) => ({ file: r.file, line: r.line, text: r.text.trim() })),
+                    total: results.length,
+                },
+            };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `find_todos failed: ${error.message}` }], isError: true };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_debug_logs — Find console.log/print statements
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_debug_logs', {
+        description: 'Find debug/log statements: console.log, print, println, Debug.Log, etc.',
+        inputSchema: {
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const searchCwd = params.directory ? safePath(params.directory) : CWD;
+            const results = await searchCode({
+                cwd: searchCwd,
+                pattern: '(console\\.(log|debug|info|warn|error)|print\\(|println!|fmt\\.Print|System\\.out|Debug\\.Log)',
+                isRegex: true,
+                fileGlob: params.file_glob,
+                maxResults: 100,
+            });
+            const output = results.map((r) => `${r.file}:${r.line} │ ${r.text.trim()}`).join('\n');
+            return {
+                content: [{ type: 'text', text: `Found ${results.length} debug/log statements:\n\n${output}` }],
+                structuredContent: {
+                    check: 'debug_logs',
+                    matches: results.map((r) => ({ file: r.file, line: r.line, text: r.text.trim() })),
+                    total: results.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `find_debug_logs failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_secrets — Find hardcoded secrets/credentials
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_secrets', {
+        description: 'Find potential hardcoded secrets: passwords, API keys, tokens, credentials.',
+        inputSchema: {
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const searchCwd = params.directory ? safePath(params.directory) : CWD;
+            const results = await searchCode({
+                cwd: searchCwd,
+                pattern: '(password|secret|api_key|apikey|token|credential)\\s*[:=]\\s*["\'][^"\']+["\']',
+                isRegex: true,
+                caseSensitive: false,
+                fileGlob: params.file_glob,
+                maxResults: 50,
+            });
+            const output = results.map((r) => `⚠️  ${r.file}:${r.line} │ ${r.text.trim()}`).join('\n');
+            return {
+                content: [{ type: 'text', text: `Found ${results.length} potential hardcoded secrets:\n\n${output}` }],
+                structuredContent: {
+                    check: 'secrets',
+                    matches: results.map((r) => ({ file: r.file, line: r.line, text: r.text.trim() })),
+                    total: results.length,
+                },
+            };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `find_secrets failed: ${error.message}` }], isError: true };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_empty_catches — Find empty error handlers
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_empty_catches', {
+        description: 'Find empty catch blocks and swallowed exceptions.',
+        inputSchema: {
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const searchCwd = params.directory ? safePath(params.directory) : CWD;
+            const results = await searchCode({
+                cwd: searchCwd,
+                pattern: '(catch\\s*\\([^)]*\\)\\s*\\{\\s*\\}|except:\\s*pass|rescue\\s*=>\\s*nil)',
+                isRegex: true,
+                fileGlob: params.file_glob,
+                maxResults: 50,
+                contextLines: 1,
+            });
+            const output = results.map((r) => `${r.file}:${r.line} │ ${r.text.trim()}`).join('\n');
+            return {
+                content: [{ type: 'text', text: `Found ${results.length} empty/swallowed error handlers:\n\n${output}` }],
+                structuredContent: {
+                    check: 'empty_catches',
+                    matches: results.map((r) => ({ file: r.file, line: r.line, text: r.text.trim() })),
+                    total: results.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `find_empty_catches failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_long_functions — Find overly long functions
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_long_functions', {
+        description: 'Find functions that exceed a line count threshold (complexity indicator).',
+        inputSchema: {
+            threshold: z.number().optional().describe('Line count threshold (default: 50)'),
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const threshold = params.threshold || 50;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Tip: Use "code_metrics" or "analyze_file" to find functions over ${threshold} lines. These tools use AST parsing for accurate function length detection.`,
+                },
+            ],
+            structuredContent: { check: 'long_functions', matches: [], total: 0 },
+        };
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_large_files — Find overly large files
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_large_files', {
+        description: 'Find files that exceed a line count threshold.',
+        inputSchema: {
+            threshold: z.number().optional().describe('Line count threshold (default: 500)'),
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const threshold = params.threshold || 500;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Tip: Use "codebase_map" or "file_tree" to see file sizes. Use "code_metrics" with a threshold of ${threshold} to identify large files programmatically.`,
+                },
+            ],
+            structuredContent: { check: 'large_files', matches: [], total: 0 },
+        };
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_duplicates — Find duplicate code patterns
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_duplicates', {
+        description: 'Find duplicate code patterns and copy-pasted blocks.',
+        inputSchema: {
+            pattern: z.string().optional().describe('Specific pattern to search for duplicates'),
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        if (params.pattern) {
+            try {
+                const searchCwd = params.directory ? safePath(params.directory) : CWD;
+                const results = await searchCode({
+                    cwd: searchCwd,
+                    pattern: params.pattern,
+                    isRegex: false,
+                    fileGlob: params.file_glob,
+                    maxResults: 100,
+                });
+                const output = results.map((r) => `${r.file}:${r.line} │ ${r.text.trim()}`).join('\n');
+                return {
+                    content: [{ type: 'text', text: `Found ${results.length} occurrences of pattern:\n\n${output}` }],
+                    structuredContent: {
+                        check: 'duplicates',
+                        matches: results.map((r) => ({ file: r.file, line: r.line, text: r.text.trim() })),
+                        total: results.length,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: `find_duplicates failed: ${error.message}` }],
+                    isError: true,
+                };
+            }
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Tip: Use "search_code" to find repeated patterns. Provide a specific pattern to this tool to count occurrences across the codebase.',
+                },
+            ],
+            structuredContent: { check: 'duplicates', matches: [], total: 0 },
+        };
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: find_dead_code — Find unused exports
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('find_dead_code', {
+        description: 'Find potentially dead code: unused exports, unreferenced functions.',
+        inputSchema: {
+            file_glob: z.string().optional().describe('Filter by file pattern'),
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.find_pattern,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Tip: Use "search_symbols" to find all exports, then use "find_references" on each symbol to check usage. Symbols with 0 references (excluding their definition) are potentially dead code.',
+                },
+            ],
+            structuredContent: { check: 'dead_code', matches: [], total: 0 },
+        };
+    });
+}
+//# sourceMappingURL=quality.js.map

package/dist/tools/quality.js.map

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

package/dist/tools/scaffold.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers scaffold tools for generating boilerplate code based on project conventions.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerScaffoldTools(server: McpServer): void;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/tools/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA2EtD"}

package/dist/tools/scaffold.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD } from '../config.js';
+import { listTemplates, generateScaffold } from '../analyzers/scaffold.js';
+import { analytics } from '../utils/analytics.js';
+/**
+ * Registers scaffold tools for generating boilerplate code based on project conventions.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerScaffoldTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: scaffold — Code generation from project conventions
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('scaffold', {
+        description: 'Generate boilerplate code based on detected project conventions. Returns generated code as text output — does NOT write files to disk. Templates: component (React), route (Express), test, service, hook, util. Auto-detects TypeScript, testing framework, CSS framework, and ORM.',
+        inputSchema: {
+            action: z.enum(['list', 'generate']).describe('"list" to see available templates, "generate" to create code'),
+            template: z.string().optional().describe('Template name: component, test, route, service, hook, util'),
+            name: z.string().optional().describe('Name for the generated code (e.g. "UserProfile", "auth")'),
+            target_file: z.string().optional().describe('For test template: path to the file being tested'),
+        },
+        outputSchema: outputSchemas.scaffold,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            return await analytics.track('scaffold', async () => {
+                if (params.action === 'list') {
+                    const result = await listTemplates(CWD);
+                    const lines = [
+                        `## Scaffold Templates\n`,
+                        `Project type: ${result.projectType}`,
+                        `Detected: ${result.detectedPatterns.join(', ') || 'no patterns'}\n`,
+                        `### Available Templates`,
+                    ];
+                    for (const t of result.templates) {
+                        lines.push(`  📝 ${t.name} — ${t.description} (${t.language})`);
+                    }
+                    return {
+                        content: [{ type: 'text', text: lines.join('\n') }],
+                        structuredContent: {
+                            projectType: result.projectType,
+                            templates: result.templates,
+                        },
+                    };
+                }
+                if (params.action === 'generate') {
+                    if (!params.template || !params.name) {
+                        throw new Error('Template and name are required for "generate" action');
+                    }
+                    const result = await generateScaffold(CWD, {
+                        template: params.template,
+                        name: params.name,
+                        targetFile: params.target_file,
+                    });
+                    const lines = [
+                        `## Generated: ${result.fileName}\n`,
+                        `Template: ${result.template}`,
+                        `Conventions applied: ${result.conventions.join(', ') || 'none'}\n`,
+                        '```' + result.language,
+                        result.generatedCode,
+                        '```',
+                    ];
+                    return {
+                        content: [{ type: 'text', text: lines.join('\n') }],
+                        structuredContent: {
+                            fileName: result.fileName,
+                            code: result.generatedCode,
+                            conventions: result.conventions,
+                        },
+                    };
+                }
+                return { content: [{ type: 'text', text: 'Invalid action' }], isError: true };
+            });
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `scaffold failed: ${error.message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/tools/scaffold.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers search tools for text/regex search, symbol finding, reference lookup, and semantic search.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerSearchTools(server: McpServer): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QA4UpD"}