spec-gen-cli 1.0.0

package/dist/cli/commands/mcp.d.ts

@@ -0,0 +1,638 @@
+/**
+ * spec-gen MCP Server
+ *
+ * Exposes spec-gen's static analysis capabilities as Model Context Protocol
+ * tools, usable from Cline, Claude Code, or any MCP-compatible AI agent.
+ *
+ * Transport: stdio (standard for editor-embedded MCP servers)
+ *
+ * Configuration for Cline / Claude Code:
+ *   {
+ *     "mcpServers": {
+ *       "spec-gen": {
+ *         "command": "node",
+ *         "args": ["/path/to/spec-gen/dist/cli/index.js", "mcp"]
+ *       }
+ *     }
+ *   }
+ */
+import { Command } from 'commander';
+import { sanitizeMcpError, validateDirectory } from '../../core/services/mcp-handlers/utils.js';
+import { handleGetCallGraph, handleGetSubgraph, handleAnalyzeImpact, handleGetLowRiskRefactorCandidates, handleGetLeafFunctions, handleGetCriticalHubs, handleGetGodFunctions } from '../../core/services/mcp-handlers/graph.js';
+import { handleSearchCode, handleSuggestInsertionPoints } from '../../core/services/mcp-handlers/semantic.js';
+import { handleAnalyzeCodebase, handleGetArchitectureOverview, handleGetRefactorReport, handleGetDuplicateReport, handleGetSignatures, handleGetMapping, handleCheckSpecDrift, handleGetFunctionSkeleton } from '../../core/services/mcp-handlers/analysis.js';
+export { sanitizeMcpError, validateDirectory };
+export { handleGetCallGraph, handleGetSubgraph, handleAnalyzeImpact, handleGetLowRiskRefactorCandidates, handleGetLeafFunctions, handleGetCriticalHubs, handleGetGodFunctions, handleSearchCode, handleSuggestInsertionPoints, handleAnalyzeCodebase, handleGetArchitectureOverview, handleGetRefactorReport, handleGetDuplicateReport, handleGetSignatures, handleGetMapping, handleCheckSpecDrift, handleGetFunctionSkeleton, };
+export declare const TOOL_DEFINITIONS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            force: {
+                type: string;
+                description: string;
+            };
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            filePattern: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            functionName: {
+                type: string;
+                description: string;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            maxDepth: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            domain: {
+                type: string;
+                description: string;
+            };
+            orphansOnly: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            base: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            domains: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            failOn: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            maxFiles: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            symbol: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            filePattern: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            filePattern: {
+                type: string;
+                description: string;
+            };
+            sortBy: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            force?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            minFanIn: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            sortBy?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            filePath: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            filePath: {
+                type: string;
+                description: string;
+            };
+            fanOutThreshold: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            limit?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            description?: undefined;
+            language?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            language: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            sortBy?: undefined;
+            minFanIn?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            language: {
+                type: string;
+                description: string;
+            };
+            minFanIn: {
+                type: string;
+                description: string;
+            };
+            force?: undefined;
+            filePattern?: undefined;
+            functionName?: undefined;
+            direction?: undefined;
+            maxDepth?: undefined;
+            format?: undefined;
+            domain?: undefined;
+            orphansOnly?: undefined;
+            base?: undefined;
+            files?: undefined;
+            domains?: undefined;
+            failOn?: undefined;
+            maxFiles?: undefined;
+            symbol?: undefined;
+            depth?: undefined;
+            sortBy?: undefined;
+            filePath?: undefined;
+            fanOutThreshold?: undefined;
+            description?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare const mcpCommand: Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/cli/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,8CAA8C,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,4BAA4B,EAC5B,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,GAC1B,CAAC;AAMF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqc5B,CAAC;AA+GF,eAAO,MAAM,UAAU,SAEE,CAAC"}