codedev-mcp 3.2.0

package/dist/tools/architecture.js

@@ -0,0 +1,176 @@
+import { z } from 'zod';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD } from '../config.js';
+import { checkArchitecture } from '../analyzers/architecture.js';
+import { analyzeDBSchema } from '../analyzers/db-schema.js';
+import { analyzeApiContracts } from '../analyzers/api-contract.js';
+import { analytics } from '../utils/analytics.js';
+/**
+ * Registers architecture tools for checking architectural constraints, database schemas, and API contracts.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerArchitectureTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: architecture_check — Architectural analysis
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('architecture_check', {
+        description: 'Check architectural constraints and patterns. Detects circular dependencies, layered architecture violations, and component isolation issues.',
+        inputSchema: {
+            check_type: z.enum(['layers', 'circular', 'srp']).optional(),
+        },
+        outputSchema: outputSchemas.architecture_check,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            return await analytics.track('architecture_check', async () => {
+                const result = await checkArchitecture(CWD);
+                const lines = [`## Architecture Check\n`];
+                if (result.violations && result.violations.length > 0) {
+                    lines.push(`Found ${result.violations.length} violations:`);
+                    for (const v of result.violations) {
+                        lines.push(`${v.severity === 'error' ? '🔴' : '⚠️'} [${v.rule}] ${v.file}${v.line ? ':' + v.line : ''} — ${v.message}${v.importPath ? ` (imports ${v.importPath})` : ''}`);
+                    }
+                }
+                else {
+                    lines.push('✅ No architectural violations found.');
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        violations: result.violations?.map((v) => ({
+                            rule: v.rule,
+                            file: v.file,
+                            message: v.message,
+                            severity: v.severity,
+                        })) || [],
+                        rulesChecked: result.rulesChecked || [],
+                        passed: result.passed || false,
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `architecture_check failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: db_schema — Analyze database models and schemas
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('db_schema', {
+        description: 'Analyze database schema definitions. Parses Prisma, Drizzle, SQLAlchemy, Django ORM, TypeORM entities, and raw SQL DDL. Returns tables, columns, types, relationships, and migrations.',
+        inputSchema: {
+            directory: z.string().optional().describe('Subdirectory to search for schema files'),
+        },
+        outputSchema: outputSchemas.db_schema,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            return await analytics.track('db_schema', async () => {
+                const result = await analyzeDBSchema(CWD, { directory: params.directory });
+                const lines = [
+                    `## Database Schema\n`,
+                    `Tables: ${result.summary.totalTables}`,
+                    `Columns: ${result.summary.totalColumns}`,
+                    `Relationships: ${result.summary.totalRelationships}`,
+                    `ORMs: ${result.summary.orms.join(', ') || 'none detected'}\n`,
+                ];
+                if (result.summary.totalTables === 0 && result.scannedPatterns?.length) {
+                    lines.push(`Scanned patterns (no schemas found):`);
+                    for (const p of result.scannedPatterns) {
+                        lines.push(`  - ${p}`);
+                    }
+                    lines.push('');
+                }
+                for (const table of result.tables.slice(0, 30)) {
+                    lines.push(`### ${table.name} (${table.orm || table.source})`);
+                    for (const col of table.columns) {
+                        const flags = [
+                            col.primary && 'PK',
+                            col.unique && 'UNIQUE',
+                            col.nullable === false && 'NOT NULL',
+                            col.references && `FK→${col.references}`,
+                        ]
+                            .filter(Boolean)
+                            .join(', ');
+                        lines.push(`  ${col.name}: ${col.type}${flags ? ` (${flags})` : ''}`);
+                    }
+                    lines.push('');
+                }
+                if (result.relationships.length > 0) {
+                    lines.push(`### Relationships(${result.relationships.length})`);
+                    result.relationships
+                        .slice(0, 20)
+                        .forEach((r) => lines.push(`  ${r.from} → ${r.to} (${r.type})${r.through ? ` through ${r.through}` : ''}`));
+                }
+                if (result.migrations.length > 0) {
+                    lines.push(`\n### Migrations(${result.migrations.length})`);
+                    result.migrations
+                        .slice(0, 10)
+                        .forEach((m) => lines.push(`  ${m.file}${m.description ? ` — ${m.description}` : ''}`));
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        tables: result.tables.map((t) => ({ name: t.name, columns: t.columns?.length, source: t.source })),
+                        relationships: result.relationships?.map((r) => ({ from: r.from, to: r.to, type: r.type })) || [],
+                        summary: result.summary || {},
+                        scannedPatterns: result.scannedPatterns || [],
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `db_schema failed: ${error.message}` }], isError: true };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: api_contracts — Find all API endpoints
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('api_contracts', {
+        description: 'Find all API endpoints in the codebase. Parses OpenAPI/Swagger specs, GraphQL schemas, Express/Fastify routes, NestJS controllers, FastAPI decorators. Returns method, path, parameters, and types.',
+        outputSchema: outputSchemas.api_contracts,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            return await analytics.track('api_contracts', async () => {
+                const result = await analyzeApiContracts(CWD);
+                const lines = [
+                    `## API Contracts\n`,
+                    `Total endpoints: ${result.totalEndpoints}`,
+                    `Sources: ${result.sources.join(', ') || 'none detected'}`,
+                ];
+                if (result.totalEndpoints === 0 && result.scannedPatterns?.length) {
+                    lines.push(`\nScanned patterns (no endpoints found):`);
+                    for (const p of result.scannedPatterns) {
+                        lines.push(`  - ${p}`);
+                    }
+                }
+                const { summary } = result;
+                lines.push(`Methods: GET = ${summary.get} POST = ${summary.post} PUT = ${summary.put} DELETE = ${summary.delete} QUERY = ${summary.query} MUTATION = ${summary.mutation}\n`);
+                for (const ep of result.endpoints.slice(0, 50)) {
+                    const params = ep.parameters?.map((p) => `${p.name}:${p.type}`).join(', ') || '';
+                    lines.push(`  ${ep.method.padEnd(10)} ${ep.path}${params ? ` (${params})` : ''}  — ${ep.file}:${ep.line} [${ep.source}]`);
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        endpoints: result.endpoints.map((ep) => ({ method: ep.method, path: ep.path, source: ep.source })),
+                        totalEndpoints: result.endpoints.length,
+                        sources: [...new Set(result.endpoints.map((ep) => ep.source))],
+                        scannedPatterns: result.scannedPatterns || [],
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `api_contracts failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=architecture.js.map

package/dist/tools/architecture.js.map

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

package/dist/tools/devops.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers DevOps tools for infrastructure-as-code analysis, CI/CD pipeline parsing, and monorepo workspace analysis.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerDevOpsTools(server: McpServer): void;
+//# sourceMappingURL=devops.d.ts.map

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

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

package/dist/tools/devops.js

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { CWD } from '../config.js';
+import { analyzeIaC } from '../analyzers/iac.js';
+import { parseCICD } from '../analyzers/cicd.js';
+import { analyzeMonorepo } from '../analyzers/monorepo.js';
+import { analytics } from '../utils/analytics.js';
+/**
+ * Registers DevOps tools for infrastructure-as-code analysis, CI/CD pipeline parsing, and monorepo workspace analysis.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerDevOpsTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: iac_analyze — Infrastructure-as-Code analysis
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('iac_analyze', {
+        description: 'Analyze infrastructure-as-code definitions. Parses Terraform (.tf), CloudFormation, Kubernetes manifests, and Docker Compose files. Returns resources, providers, and issues.',
+        inputSchema: {
+            directory: z.string().optional().describe('Subdirectory to search'),
+        },
+        outputSchema: outputSchemas.iac_analyze,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            return await analytics.track('iac_analyze', async () => {
+                const result = await analyzeIaC(CWD, { directory: params.directory });
+                const lines = [
+                    `## Infrastructure - as - Code\n`,
+                    `Resources: ${result.summary.totalResources}`,
+                    `Platforms: ${result.summary.platforms.join(', ') || 'none detected'}\n`,
+                ];
+                const rtypes = result.summary.resourceTypes;
+                if (Object.keys(rtypes).length > 0) {
+                    lines.push('### Resource Summary');
+                    for (const [rtype, count] of Object.entries(rtypes)
+                        .sort(([, a], [, b]) => b - a)
+                        .slice(0, 20)) {
+                        lines.push(`  ${rtype}: ${count}`);
+                    }
+                }
+                lines.push('\n### Resources');
+                for (const r of result.resources.slice(0, 40)) {
+                    const props = Object.entries(r.properties)
+                        .slice(0, 3)
+                        .map(([k, v]) => `${k}=${v}`)
+                        .join(', ');
+                    lines.push(`  [${r.source}] ${r.type} "${r.name}"${props ? ` (${props})` : ''}`);
+                }
+                if (result.issues.length > 0) {
+                    lines.push(`\n### Issues(${result.issues.length})`);
+                    result.issues
+                        .slice(0, 15)
+                        .forEach((i) => lines.push(`  ${i.severity === 'error' ? '❌' : '⚠️'} ${i.message} — ${i.file}${i.line ? ':' + i.line : ''}`));
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        platform: result.platform,
+                        resources: result.resources?.map((r) => ({ type: r.type, name: r.name })) || [],
+                        issues: result.issues?.map((i) => ({
+                            message: i.message,
+                            severity: i.severity,
+                            file: i.file,
+                            line: i.line,
+                        })) || [],
+                        summary: result.summary || {},
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `iac_analyze failed: ${error.message}` }], isError: true };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: cicd_analyze — CI/CD pipeline analysis
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('cicd_analyze', {
+        description: 'Parse CI/CD pipeline configurations. Supports GitHub Actions, GitLab CI, Jenkins (Jenkinsfile), and CircleCI. Returns pipeline names, jobs, steps, triggers, and dependencies.',
+        outputSchema: outputSchemas.cicd_analyze,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            return await analytics.track('cicd_analyze', async () => {
+                const result = await parseCICD(CWD);
+                const lines = [
+                    `## CI / CD Pipelines\n`,
+                    `Pipelines: ${result.summary.totalPipelines}`,
+                    `Total jobs: ${result.summary.totalJobs}`,
+                    `Issues: ${result.summary.totalIssues}\n`,
+                ];
+                for (const pipeline of result.pipelines) {
+                    lines.push(`### ${pipeline.name || pipeline.file} (${pipeline.platform}) — ${pipeline.file}`);
+                    if (pipeline.triggers.length > 0)
+                        lines.push(`  Triggers: ${pipeline.triggers.join(', ')}`);
+                    for (const job of pipeline.jobs) {
+                        const deps = job.dependsOn?.length ? ` (needs: ${job.dependsOn.join(', ')})` : '';
+                        const runner = job.runsOn ? ` [${job.runsOn}]` : '';
+                        lines.push(`  📋 ${job.name}${deps}${runner}`);
+                        job.steps.slice(0, 5).forEach((s) => lines.push(`     → ${s}`));
+                    }
+                    if (pipeline.issues.length > 0) {
+                        pipeline.issues.forEach((i) => lines.push(`  ${i.severity === 'error' ? '❌' : '⚠️'} ${i.message}`));
+                    }
+                    lines.push('');
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        pipelines: result.pipelines.map((p) => ({ name: p.name, platform: p.platform, file: p.file })),
+                        summary: result.summary || {},
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `cicd_analyze failed: ${error.message}` }], isError: true };
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: monorepo_analyze — Workspace/package relationship analysis
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('monorepo_analyze', {
+        description: 'Analyze monorepo workspace relationships. Supports npm/yarn/pnpm workspaces, Cargo workspaces, Lerna, Nx, and Turborepo. Shows packages, internal dependencies, and issues.',
+        outputSchema: outputSchemas.monorepo_analyze,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            return await analytics.track('monorepo_analyze', async () => {
+                const result = await analyzeMonorepo(CWD);
+                if (result.type === 'none') {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'This project does not appear to be a monorepo. No workspace configuration detected.',
+                            },
+                        ],
+                        structuredContent: { type: 'none', packages: [], summary: {} },
+                    };
+                }
+                const lines = [
+                    `## Monorepo Analysis\n`,
+                    `Type: ${result.type}`,
+                    `Packages: ${result.summary.totalPackages}`,
+                    `Cross - dependencies: ${result.summary.crossDeps}`,
+                    `Root tools: ${result.summary.rootTools.join(', ') || 'none'}\n`,
+                ];
+                for (const pkg of result.packages) {
+                    const deps = pkg.dependencies.length > 0 ? ` → depends on: ${pkg.dependencies.join(', ')}` : '';
+                    lines.push(`  📦 ${pkg.name} (${pkg.path})${pkg.version ? ` v${pkg.version}` : ''}${deps}`);
+                }
+                if (result.dependencyGraph.length > 0) {
+                    lines.push(`\n### Dependency Graph(${result.dependencyGraph.length} edges)`);
+                    result.dependencyGraph.slice(0, 20).forEach((d) => lines.push(`  ${d.from} → ${d.to}`));
+                }
+                if (result.issues.length > 0) {
+                    lines.push(`\n### Issues(${result.issues.length})`);
+                    result.issues.forEach((i) => lines.push(`  ⚠️ ${i}`));
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        type: result.type,
+                        packages: result.packages.map((p) => ({ name: p.name, path: p.path, version: p.version })),
+                        summary: result.summary || {},
+                    },
+                };
+            });
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `monorepo_analyze failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=devops.js.map

package/dist/tools/devops.js.map

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

package/dist/tools/docs.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers documentation tools for extracting and analyzing code documentation across multiple languages.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerDocsTools(server: McpServer): void;
+//# sourceMappingURL=docs.d.ts.map

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

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

package/dist/tools/docs.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { outputSchemas } from '../schemas/output-schemas.js';
+import { safePath } from '../config.js';
+import { detectLanguage } from '../utils/languages.js';
+import { extractDocs, findUndocumented } from '../analyzers/docs.js';
+/**
+ * Registers documentation tools for extracting and analyzing code documentation across multiple languages.
+ * @param server - The MCP server instance to register tools on.
+ */
+export function registerDocsTools(server) {
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOL: code_docs — Documentation extraction
+    // ═══════════════════════════════════════════════════════════════════════
+    server.registerTool('code_docs', {
+        description: 'Extract documentation from code: JSDoc, Python docstrings, Rustdoc, Javadoc, Go doc comments. Shows docs for symbols or finds undocumented APIs.',
+        inputSchema: {
+            action: z
+                .enum(['extract', 'undocumented'])
+                .describe('extract: get docs for a file, undocumented: find undocumented public APIs'),
+            file: z.string().describe('File to analyze'),
+            symbol: z.string().optional().describe('Filter to specific symbol name'),
+        },
+        outputSchema: outputSchemas.code_docs,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const filePath = safePath(params.file);
+            const language = detectLanguage(params.file);
+            if (params.action === 'undocumented') {
+                const undoc = await findUndocumented(filePath, language);
+                if (undoc.length === 0)
+                    return {
+                        content: [{ type: 'text', text: `All public symbols in ${params.file} are documented. ✅` }],
+                        structuredContent: { action: 'undocumented', file: params.file, entries: [], total: 0 },
+                    };
+                const output = undoc.map((u) => `  L${u.line}: ${u.symbol} (${u.type})`).join('\n');
+                return {
+                    content: [
+                        { type: 'text', text: `${undoc.length} undocumented public symbols in ${params.file}:\n\n${output}` },
+                    ],
+                    structuredContent: {
+                        action: 'undocumented',
+                        file: params.file,
+                        entries: undoc.map((u) => ({ symbol: u.symbol, type: u.type, line: u.line })),
+                        total: undoc.length,
+                    },
+                };
+            }
+            const docs = await extractDocs(filePath, language);
+            let filtered = docs;
+            if (params.symbol)
+                filtered = docs.filter((d) => d.symbol.includes(params.symbol));
+            if (filtered.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No documentation found in ${params.file}${params.symbol ? ` for "${params.symbol}"` : ''}. Use code_docs with action "undocumented" to find undocumented APIs.`,
+                        },
+                    ],
+                    structuredContent: { action: 'extract', file: params.file, entries: [], total: 0 },
+                };
+            }
+            const output = filtered
+                .map((d) => {
+                let text = `### ${d.symbolType} ${d.symbol} (L${d.line})${d.deprecated ? ' ⚠️ DEPRECATED' : ''}\n`;
+                text += `${d.doc}\n`;
+                if (d.params?.length)
+                    text += `Parameters:\n${d.params.map((p) => `  - ${p.name}${p.type ? ` (${p.type})` : ''}: ${p.description}`).join('\n')}\n`;
+                if (d.returns)
+                    text += `Returns${d.returns.type ? ` (${d.returns.type})` : ''}: ${d.returns.description}\n`;
+                if (d.examples?.length)
+                    text += `Examples:\n${d.examples.map((e) => `  ${e}`).join('\n')}\n`;
+                return text;
+            })
+                .join('\n');
+            return {
+                content: [
+                    { type: 'text', text: `Documentation for ${params.file} (${filtered.length} symbols):\n\n${output}` },
+                ],
+                structuredContent: {
+                    action: 'extract',
+                    file: params.file,
+                    entries: filtered.map((d) => ({ symbol: d.symbol, type: d.symbolType, line: d.line })),
+                    total: filtered.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `code_docs failed: ${error.message}. Verify the file exists and is a supported language.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

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

package/dist/tools/git.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers git tools for log viewing, diffing, blaming, branching, contributor stats, change impact, and hook management.
+ * @param server - The MCP server instance to register tools on.
+ */
+export declare function registerGitTools(server: McpServer): void;
+//# sourceMappingURL=git.d.ts.map

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

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