codedev-mcp 3.2.0

package/dist/tools/nav.js

@@ -0,0 +1,275 @@
+import { z } from 'zod';
+import path from 'node:path';
+import { readFile, stat } from 'node:fs/promises';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD, safePath } from '../config.js';
+import { cache } from '../cache/memory-cache.js';
+import { readFileRange, listFiles } from '../search/fast-search.js';
+/**
+ * Format file size in human-readable format.
+ * @param bytes - The file size in bytes.
+ * @returns A human-readable string representation of the file size.
+ */
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+/**
+ * Format modification time as relative time string.
+ * @param mtime - The modification date to format.
+ * @returns A relative time string like "5m ago" or "2d ago".
+ */
+function formatRelativeTime(mtime) {
+    const now = Date.now();
+    const diff = now - mtime.getTime();
+    const mins = Math.floor(diff / 60000);
+    if (mins < 1)
+        return 'just now';
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 30)
+        return `${days}d ago`;
+    const months = Math.floor(days / 30);
+    return `${months}mo ago`;
+}
+/**
+ * Get file type icon based on file extension.
+ * @param filename - The filename to determine the icon for.
+ * @returns An emoji icon representing the file type.
+ */
+function getFileIcon(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    const iconMap = {
+        '.ts': '🔷',
+        '.tsx': '🔷',
+        '.js': '🟨',
+        '.jsx': '🟨',
+        '.py': '🐍',
+        '.rb': '💎',
+        '.go': '🔵',
+        '.rs': '🦀',
+        '.java': '☕',
+        '.kt': '🟣',
+        '.swift': '🍎',
+        '.c': '⚙️',
+        '.cpp': '⚙️',
+        '.h': '📋',
+        '.md': '📝',
+        '.json': '📦',
+        '.yaml': '📄',
+        '.yml': '📄',
+        '.toml': '📄',
+        '.html': '🌐',
+        '.css': '🎨',
+        '.scss': '🎨',
+        '.sql': '🗃️',
+        '.sh': '🖥️',
+        '.dockerfile': '🐳',
+        '.lock': '🔒',
+        '.env': '🔐',
+    };
+    return iconMap[ext] || '📄';
+}
+/**
+ * Registers navigation tools for reading files and listing directory trees with metadata.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerNavTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: read_files — Read one or more files (consolidated)
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('read_files', {
+        description: 'Read one or more files. Pass a single path or array of paths. Supports line ranges for single files and truncation for batch reads.',
+        inputSchema: {
+            path: z.string().optional().describe('Single file path relative to project root'),
+            paths: z.array(z.string()).optional().describe('Multiple file paths for batch read'),
+            start_line: z.number().optional().describe('Start line for single file (1-indexed)'),
+            end_line: z.number().optional().describe('End line for single file (inclusive)'),
+            max_lines_per_file: z.number().optional().describe('Truncate each file in batch mode (default: 200)'),
+        },
+        outputSchema: outputSchemas.read_files,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        // Single file mode
+        if (params.path) {
+            try {
+                const filePath = safePath(params.path);
+                const cached = await cache.get(`read:${params.path}:${params.start_line}:${params.end_line}`, filePath);
+                if (cached)
+                    return {
+                        content: [{ type: 'text', text: cached }],
+                        structuredContent: { files: [{ path: params.path, content: cached, lines: cached.split('\n').length }] },
+                    };
+                const { content, totalLines } = await readFileRange(filePath, params.start_line, params.end_line);
+                const startNum = params.start_line || 1;
+                const numbered = content
+                    .split('\n')
+                    .map((line, i) => `${String(startNum + i).padStart(5)} │ ${line}`)
+                    .join('\n');
+                const range = params.start_line || params.end_line
+                    ? ` (lines ${params.start_line || 1}-${params.end_line || totalLines})`
+                    : '';
+                const result = `${params.path}${range} — ${totalLines} total lines\n\n${numbered}`;
+                await cache.set(`read:${params.path}:${params.start_line}:${params.end_line}`, result, 30_000, filePath);
+                return {
+                    content: [{ type: 'text', text: result }],
+                    structuredContent: { files: [{ path: params.path, content: result, lines: result.split('\n').length }] },
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `read_files failed: ${error.message}. Verify the file path exists. Use file_tree to discover files or search_code to find files by content.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // Batch mode
+        if (params.paths) {
+            const maxLines = params.max_lines_per_file || 200;
+            const results = [];
+            for (const filePath of params.paths) {
+                try {
+                    const fullPath = safePath(filePath);
+                    const content = await readFile(fullPath, 'utf-8');
+                    const lines = content.split('\n');
+                    const truncated = lines.length > maxLines;
+                    const displayLines = truncated ? lines.slice(0, maxLines) : lines;
+                    const numbered = displayLines.map((line, i) => `${String(i + 1).padStart(5)} │ ${line}`).join('\n');
+                    results.push(`\n━━━ ${filePath} (${lines.length} lines${truncated ? `, showing first ${maxLines}` : ''}) ━━━\n${numbered}`);
+                }
+                catch (error) {
+                    results.push(`\n━━━ ${filePath} ━━━\nError: ${error.message}`);
+                }
+            }
+            return {
+                content: [{ type: 'text', text: results.join('\n') }],
+                structuredContent: {
+                    files: results.map((r, i) => ({ path: params.paths[i], content: r, lines: r.split('\n').length })),
+                },
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'read_files requires either "path" (single file) or "paths" (batch). Use file_tree to discover available files.',
+                },
+            ],
+            isError: true,
+        };
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: file_tree — Smart directory listing with sizes and dates
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('file_tree', {
+        description: 'List files and directories with sizes, modification times, and type icons. Automatically excludes node_modules, .git, build artifacts.',
+        inputSchema: {
+            directory: z.string().optional().describe('Directory to list (default: project root)'),
+            glob: z.string().optional().describe('File pattern filter, e.g. "*.ts", "*.py"'),
+            max_depth: z.number().optional().describe('Maximum directory depth (default: 3)'),
+            type: z.enum(['file', 'dir', 'all']).optional().describe('Show only files, only directories, or all'),
+            show_details: z.boolean().optional().describe('Show sizes and dates (default: true)'),
+        },
+        outputSchema: outputSchemas.file_tree,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const targetDir = params.directory ? safePath(params.directory) : CWD;
+            const showDetails = params.show_details !== false;
+            const maxDepth = params.max_depth || 3;
+            const files = await listFiles(targetDir, {
+                glob: params.glob,
+                maxDepth: maxDepth,
+                type: params.type,
+            });
+            const fileInfos = [];
+            for (const file of files.slice(0, 200)) {
+                // Limit to 200 files
+                const filePath = path.join(targetDir, file);
+                const depth = file.split(path.sep).length - 1;
+                const info = {
+                    path: file,
+                    dir: path.dirname(file) || '.',
+                    name: path.basename(file),
+                    depth,
+                };
+                if (showDetails) {
+                    try {
+                        const stats = await stat(filePath);
+                        info.size = stats.size;
+                        info.mtime = stats.mtime;
+                    }
+                    catch {
+                        // Skip stat errors
+                    }
+                }
+                fileInfos.push(info);
+            }
+            // Group by directory
+            const byDir = new Map();
+            for (const info of fileInfos) {
+                const existing = byDir.get(info.dir) || [];
+                existing.push(info);
+                byDir.set(info.dir, existing);
+            }
+            // Build output
+            let output = `📂 ${params.directory || '.'} (${files.length} items${files.length > 200 ? ', showing first 200' : ''})\n\n`;
+            const sortedDirs = Array.from(byDir.keys()).sort();
+            for (const dir of sortedDirs) {
+                const items = byDir.get(dir);
+                const indent = dir === '.' ? '' : '  '.repeat(dir.split(path.sep).length);
+                if (dir !== '.') {
+                    output += `${indent}📁 ${dir}/\n`;
+                }
+                const fileIndent = dir === '.' ? '' : '  '.repeat(dir.split(path.sep).length + 1);
+                for (const item of items.sort((a, b) => a.name.localeCompare(b.name))) {
+                    const icon = getFileIcon(item.name);
+                    const sizePart = item.size !== undefined ? ` ${formatSize(item.size).padStart(8)}` : '';
+                    const timePart = item.mtime ? ` ${formatRelativeTime(item.mtime).padStart(10)}` : '';
+                    if (showDetails && (sizePart || timePart)) {
+                        output += `${fileIndent}${icon} ${item.name}${sizePart}${timePart}\n`;
+                    }
+                    else {
+                        output += `${fileIndent}${icon} ${item.name}\n`;
+                    }
+                }
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+                structuredContent: {
+                    tree: output,
+                    fileCount: files.length,
+                    files: fileInfos.slice(0, 50).map((f) => ({
+                        path: f.path,
+                        size: f.size,
+                        modified: f.mtime?.toISOString(),
+                    })),
+                },
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `file_tree failed: ${error.message}. Verify the directory path exists and is accessible.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=nav.js.map

package/dist/tools/nav.js.map

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

package/dist/tools/notebook.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers notebook analysis tools for parsing and inspecting Jupyter notebooks.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerNotebookTools(server: McpServer): void;
+//# sourceMappingURL=notebook.d.ts.map

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

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

package/dist/tools/notebook.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD, safePath } from '../config.js';
+import { findNotebooks, parseNotebook, extractCode, notebookHealth } from '../analyzers/notebook.js';
+/**
+ * Registers notebook analysis tools for parsing and inspecting Jupyter notebooks.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerNotebookTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: notebook_analyze — Jupyter notebook analysis
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('notebook_analyze', {
+        description: 'Analyze Jupyter notebooks (.ipynb): extract code cells, check execution order, find imports/functions, assess notebook health.',
+        inputSchema: {
+            action: z
+                .enum(['analyze', 'list', 'code', 'health'])
+                .describe('analyze: full notebook breakdown, list: find all notebooks, code: extract code cells, health: quality assessment'),
+            file: z.string().optional().describe('Notebook file path (required for analyze/code/health)'),
+        },
+        outputSchema: outputSchemas.notebook_analyze,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            if (params.action === 'list') {
+                const notebooks = await findNotebooks(CWD);
+                if (notebooks.length === 0)
+                    return {
+                        content: [{ type: 'text', text: 'No Jupyter notebooks (.ipynb) found in the project.' }],
+                        structuredContent: { action: 'list', data: '' },
+                    };
+                return {
+                    content: [{ type: 'text', text: `Found ${notebooks.length} notebooks:\n\n${notebooks.join('\n')}` }],
+                    structuredContent: { action: 'list', data: notebooks.join('\n') },
+                };
+            }
+            if (!params.file)
+                return {
+                    content: [{ type: 'text', text: 'File path required. Use action "list" to find notebooks.' }],
+                    isError: true,
+                };
+            const filePath = safePath(params.file);
+            const notebook = await parseNotebook(filePath);
+            switch (params.action) {
+                case 'analyze': {
+                    let output = `## Notebook: ${params.file}\n`;
+                    output += `Kernel: ${notebook.kernelDisplayName} (${notebook.kernelLanguage})\n`;
+                    output += `Cells: ${notebook.totalCells} (${notebook.codeCells} code, ${notebook.markdownCells} markdown)\n`;
+                    output += `Execution order: ${notebook.executedInOrder ? '✅ sequential' : '⚠️ out of order'}\n`;
+                    if (notebook.hasUnexecutedCells)
+                        output += `⚠️ Has unexecuted cells\n`;
+                    if (notebook.imports.length > 0)
+                        output += `\nImports:\n${notebook.imports.map((i) => `  ${i}`).join('\n')}\n`;
+                    if (notebook.functions.length > 0)
+                        output += `\nFunctions:\n${notebook.functions.map((f) => `  ${f}`).join('\n')}\n`;
+                    output += `\n### Cells:\n`;
+                    for (const cell of notebook.cells.slice(0, 30)) {
+                        const preview = cell.source.split('\n')[0]?.slice(0, 80) || '(empty)';
+                        const errorMark = cell.hasError ? ' ❌' : '';
+                        output += `  [${cell.index}] ${cell.cellType} ${cell.executionCount ? `(${cell.executionCount})` : ''}${errorMark}: ${preview}\n`;
+                    }
+                    return {
+                        content: [{ type: 'text', text: output }],
+                        structuredContent: { action: 'outline', data: output },
+                    };
+                }
+                case 'code': {
+                    const code = extractCode(notebook);
+                    return { content: [{ type: 'text', text: code }], structuredContent: { action: 'code', data: code } };
+                }
+                case 'health': {
+                    const health = notebookHealth(notebook);
+                    let output = `Notebook health score: ${health.score}/100\n`;
+                    if (health.issues.length > 0) {
+                        output += `\nIssues:\n${health.issues.map((i) => `  - ${i}`).join('\n')}\n`;
+                    }
+                    else {
+                        output += `\nNo issues found! ✅\n`;
+                    }
+                    return {
+                        content: [{ type: 'text', text: output }],
+                        structuredContent: { action: 'health', data: { score: health.score, issues: health.issues } },
+                    };
+                }
+                default:
+                    return { content: [{ type: 'text', text: `Unknown action: ${params.action}` }], isError: true };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `notebook_analyze failed: ${error.message}. Verify the file is a valid .ipynb notebook.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=notebook.js.map

package/dist/tools/notebook.js.map

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

package/dist/tools/performance.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers performance tools for profiling, bundle analysis, and dependency weight detection.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerPerformanceTools(server: McpServer): void;
+//# sourceMappingURL=performance.d.ts.map

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

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

package/dist/tools/performance.js

@@ -0,0 +1,59 @@
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD } from '../config.js';
+import { analyzePerformance } from '../analyzers/perf-profile.js';
+import { analytics } from '../utils/analytics.js';
+/**
+ * Registers performance tools for profiling, bundle analysis, and dependency weight detection.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerPerformanceTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: perf_profile — Performance profiling & bundle analysis
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('perf_profile', {
+        description: 'Analyze performance: parses V8 CPU profiles (.cpuprofile), webpack bundle stats, detects large source files, and flags heavy npm dependencies with lighter alternatives. Returns severity-ranked findings.',
+        outputSchema: outputSchemas.perf_profile,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            return await analytics.track('perf_profile', async () => {
+                const result = await analyzePerformance(CWD);
+                const lines = [`## Performance Analysis\n`];
+                lines.push(`Sources: ${result.sources.join(', ') || 'file sizes + dependency weights'}`);
+                const s = result.summary;
+                lines.push(`Findings: ${s.critical} critical, ${s.warning} warnings, ${s.info} info\n`);
+                if (result.bundleSize) {
+                    lines.push(`### Bundle Size: ${(result.bundleSize.total / (1024 * 1024)).toFixed(2)} MB total`);
+                    result.bundleSize.largest.forEach((b) => lines.push(`  ${b.name}: ${(b.size / 1024).toFixed(0)} KB`));
+                    lines.push('');
+                }
+                const grouped = new Map();
+                result.entries.forEach((e) => {
+                    if (!grouped.has(e.type))
+                        grouped.set(e.type, []);
+                    grouped.get(e.type).push(e);
+                });
+                for (const [type, entries] of grouped) {
+                    const label = type.replace(/_/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+                    lines.push(`### ${label} (${entries.length})`);
+                    for (const e of entries.slice(0, 10)) {
+                        const icon = e.severity === 'critical' ? '🔴' : e.severity === 'warning' ? '🟡' : '🔵';
+                        lines.push(`  ${icon} ${e.name} — ${e.value} ${e.unit}${e.recommendation ? ` (${e.recommendation})` : ''}`);
+                    }
+                    lines.push('');
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        entries: result.entries.map((e) => ({ name: e.name, value: e.value, unit: e.unit })),
+                        summary: result.summary || {},
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `perf_profile failed: ${error.message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=performance.js.map

package/dist/tools/performance.js.map

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

package/dist/tools/quality.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.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 declare function registerQualityTools(server: McpServer): void;
+//# sourceMappingURL=quality.d.ts.map

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

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