claude-flow 3.0.0-alpha.5 → 3.0.0-alpha.63

package/dist/src/init/types.js

@@ -0,0 +1,216 @@
+/**
+ * V3 Init System Types
+ * Configuration options for initializing Claude Code integration
+ */
+import os from 'os';
+import path from 'path';
+/**
+ * Detect current platform
+ */
+export function detectPlatform() {
+    const platform = os.platform();
+    const arch = os.arch();
+    const homeDir = os.homedir();
+    let osType;
+    let shell;
+    let configDir;
+    switch (platform) {
+        case 'win32':
+            osType = 'windows';
+            shell = process.env.PSModulePath ? 'powershell' : 'cmd';
+            configDir = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+            break;
+        case 'darwin':
+            osType = 'darwin';
+            shell = process.env.SHELL?.includes('zsh') ? 'zsh' : 'bash';
+            configDir = path.join(homeDir, 'Library', 'Application Support');
+            break;
+        default:
+            osType = 'linux';
+            shell = process.env.SHELL?.includes('zsh') ? 'zsh' : (process.env.SHELL?.includes('bash') ? 'bash' : 'sh');
+            configDir = process.env.XDG_CONFIG_HOME || path.join(homeDir, '.config');
+    }
+    return {
+        os: osType,
+        arch: arch,
+        nodeVersion: process.version,
+        shell,
+        homeDir,
+        configDir,
+    };
+}
+/**
+ * Default init options - full V3 setup
+ */
+export const DEFAULT_INIT_OPTIONS = {
+    targetDir: process.cwd(),
+    force: false,
+    interactive: true,
+    components: {
+        settings: true,
+        skills: true,
+        commands: true,
+        agents: true,
+        helpers: true,
+        statusline: true,
+        mcp: true,
+        runtime: true,
+        claudeMd: true,
+    },
+    hooks: {
+        preToolUse: true,
+        postToolUse: true,
+        userPromptSubmit: true,
+        sessionStart: true,
+        stop: true,
+        notification: true,
+        permissionRequest: true,
+        timeout: 5000,
+        continueOnError: true,
+    },
+    skills: {
+        core: true,
+        agentdb: true,
+        github: true,
+        flowNexus: false,
+        v3: true,
+        all: false,
+    },
+    commands: {
+        core: true,
+        analysis: true,
+        automation: true,
+        github: true,
+        hooks: true,
+        monitoring: true,
+        optimization: true,
+        sparc: true,
+        all: false,
+    },
+    agents: {
+        core: true,
+        consensus: true,
+        github: true,
+        hiveMind: true,
+        sparc: true,
+        swarm: true,
+        v3: true,
+        optimization: true,
+        testing: true,
+        all: true,
+    },
+    statusline: {
+        enabled: true,
+        showProgress: true,
+        showSecurity: true,
+        showSwarm: true,
+        showHooks: true,
+        showPerformance: true,
+        refreshInterval: 5000,
+    },
+    mcp: {
+        claudeFlow: true,
+        ruvSwarm: false,
+        flowNexus: false,
+        autoStart: false,
+        port: 3000,
+    },
+    runtime: {
+        topology: 'hierarchical-mesh',
+        maxAgents: 15,
+        memoryBackend: 'hybrid',
+        enableHNSW: true,
+        enableNeural: true,
+    },
+};
+/**
+ * Minimal init options
+ */
+export const MINIMAL_INIT_OPTIONS = {
+    ...DEFAULT_INIT_OPTIONS,
+    components: {
+        settings: true,
+        skills: true,
+        commands: false,
+        agents: false,
+        helpers: false,
+        statusline: false,
+        mcp: true,
+        runtime: true,
+        claudeMd: true,
+    },
+    hooks: {
+        ...DEFAULT_INIT_OPTIONS.hooks,
+        userPromptSubmit: false,
+        stop: false,
+        notification: false,
+    },
+    skills: {
+        core: true,
+        agentdb: false,
+        github: false,
+        flowNexus: false,
+        v3: false,
+        all: false,
+    },
+    agents: {
+        core: true,
+        consensus: false,
+        github: false,
+        hiveMind: false,
+        sparc: false,
+        swarm: false,
+        v3: false,
+        optimization: false,
+        testing: false,
+        all: false,
+    },
+    runtime: {
+        topology: 'mesh',
+        maxAgents: 5,
+        memoryBackend: 'memory',
+        enableHNSW: false,
+        enableNeural: false,
+    },
+};
+/**
+ * Full init options (everything enabled)
+ */
+export const FULL_INIT_OPTIONS = {
+    ...DEFAULT_INIT_OPTIONS,
+    components: {
+        settings: true,
+        skills: true,
+        commands: true,
+        agents: true,
+        helpers: true,
+        statusline: true,
+        mcp: true,
+        runtime: true,
+        claudeMd: true,
+    },
+    skills: {
+        core: true,
+        agentdb: true,
+        github: true,
+        flowNexus: true,
+        v3: true,
+        all: true,
+    },
+    commands: {
+        ...DEFAULT_INIT_OPTIONS.commands,
+        all: true,
+    },
+    agents: {
+        ...DEFAULT_INIT_OPTIONS.agents,
+        all: true,
+    },
+    mcp: {
+        claudeFlow: true,
+        ruvSwarm: true,
+        flowNexus: true,
+        autoStart: false,
+        port: 3000,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/src/init/types.js.map

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

package/dist/src/mcp-client.d.ts

@@ -0,0 +1,92 @@
+/**
+ * V3 CLI MCP Client
+ *
+ * Thin wrapper for calling MCP tools from CLI commands.
+ * Implements ADR-005: MCP-First API Design - CLI as thin wrapper around MCP tools
+ *
+ * This provides a simple interface for CLI commands to call MCP tools without
+ * containing hardcoded business logic. All business logic lives in MCP tool handlers.
+ */
+import type { MCPTool } from './mcp-tools/types.js';
+/**
+ * MCP Client Error
+ */
+export declare class MCPClientError extends Error {
+    toolName: string;
+    cause?: Error | undefined;
+    constructor(message: string, toolName: string, cause?: Error | undefined);
+}
+/**
+ * Call an MCP tool by name with input parameters
+ *
+ * @param toolName - Name of the MCP tool (e.g., 'agent/spawn', 'swarm/init')
+ * @param input - Input parameters for the tool
+ * @param context - Optional tool context
+ * @returns Promise resolving to tool result
+ * @throws {MCPClientError} If tool not found or execution fails
+ *
+ * @example
+ * ```typescript
+ * // Spawn an agent
+ * const result = await callMCPTool('agent/spawn', {
+ *   agentType: 'coder',
+ *   priority: 'normal'
+ * });
+ *
+ * // Initialize swarm
+ * const swarm = await callMCPTool('swarm/init', {
+ *   topology: 'hierarchical-mesh',
+ *   maxAgents: 15
+ * });
+ * ```
+ */
+export declare function callMCPTool<T = unknown>(toolName: string, input?: Record<string, unknown>, context?: Record<string, unknown>): Promise<T>;
+/**
+ * Get tool metadata by name
+ *
+ * @param toolName - Name of the MCP tool
+ * @returns Tool metadata or undefined if not found
+ */
+export declare function getToolMetadata(toolName: string): Omit<MCPTool, 'handler'> | undefined;
+/**
+ * List all available MCP tools
+ *
+ * @param category - Optional category filter
+ * @returns Array of tool metadata
+ */
+export declare function listMCPTools(category?: string): Array<Omit<MCPTool, 'handler'>>;
+/**
+ * Check if an MCP tool exists
+ *
+ * @param toolName - Name of the MCP tool
+ * @returns True if tool exists
+ */
+export declare function hasTool(toolName: string): boolean;
+/**
+ * Get all tool categories
+ *
+ * @returns Array of unique categories
+ */
+export declare function getToolCategories(): string[];
+/**
+ * Validate tool input against schema
+ *
+ * @param toolName - Name of the MCP tool
+ * @param input - Input to validate
+ * @returns Validation result with errors if any
+ */
+export declare function validateToolInput(toolName: string, input: Record<string, unknown>): {
+    valid: boolean;
+    errors?: string[];
+};
+declare const _default: {
+    callMCPTool: typeof callMCPTool;
+    getToolMetadata: typeof getToolMetadata;
+    listMCPTools: typeof listMCPTools;
+    hasTool: typeof hasTool;
+    getToolCategories: typeof getToolCategories;
+    validateToolInput: typeof validateToolInput;
+    MCPClientError: typeof MCPClientError;
+};
+export default _default;
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/src/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA2CpD;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,QAAQ,EAAE,MAAM;IAChB,KAAK,CAAC,EAAE,KAAK;gBAFpB,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,SAAS,CAkBtF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAiB/E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAU5C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BvC;;;;;;;;;;AAED,wBAQE"}

package/dist/src/mcp-client.js

@@ -0,0 +1,207 @@
+/**
+ * V3 CLI MCP Client
+ *
+ * Thin wrapper for calling MCP tools from CLI commands.
+ * Implements ADR-005: MCP-First API Design - CLI as thin wrapper around MCP tools
+ *
+ * This provides a simple interface for CLI commands to call MCP tools without
+ * containing hardcoded business logic. All business logic lives in MCP tool handlers.
+ */
+// Import MCP tool handlers from local package
+import { agentTools } from './mcp-tools/agent-tools.js';
+import { swarmTools } from './mcp-tools/swarm-tools.js';
+import { memoryTools } from './mcp-tools/memory-tools.js';
+import { configTools } from './mcp-tools/config-tools.js';
+import { hooksTools } from './mcp-tools/hooks-tools.js';
+import { taskTools } from './mcp-tools/task-tools.js';
+import { sessionTools } from './mcp-tools/session-tools.js';
+import { hiveMindTools } from './mcp-tools/hive-mind-tools.js';
+import { workflowTools } from './mcp-tools/workflow-tools.js';
+import { analyzeTools } from './mcp-tools/analyze-tools.js';
+import { progressTools } from './mcp-tools/progress-tools.js';
+/**
+ * MCP Tool Registry
+ * Maps tool names to their handler functions
+ */
+const TOOL_REGISTRY = new Map();
+// Register all tools
+function registerTools(tools) {
+    tools.forEach(tool => {
+        TOOL_REGISTRY.set(tool.name, tool);
+    });
+}
+// Initialize registry with all available tools
+registerTools([
+    ...agentTools,
+    ...swarmTools,
+    ...memoryTools,
+    ...configTools,
+    ...hooksTools,
+    ...taskTools,
+    ...sessionTools,
+    ...hiveMindTools,
+    ...workflowTools,
+    ...analyzeTools,
+    ...progressTools,
+]);
+/**
+ * MCP Client Error
+ */
+export class MCPClientError extends Error {
+    toolName;
+    cause;
+    constructor(message, toolName, cause) {
+        super(message);
+        this.toolName = toolName;
+        this.cause = cause;
+        this.name = 'MCPClientError';
+    }
+}
+/**
+ * Call an MCP tool by name with input parameters
+ *
+ * @param toolName - Name of the MCP tool (e.g., 'agent/spawn', 'swarm/init')
+ * @param input - Input parameters for the tool
+ * @param context - Optional tool context
+ * @returns Promise resolving to tool result
+ * @throws {MCPClientError} If tool not found or execution fails
+ *
+ * @example
+ * ```typescript
+ * // Spawn an agent
+ * const result = await callMCPTool('agent/spawn', {
+ *   agentType: 'coder',
+ *   priority: 'normal'
+ * });
+ *
+ * // Initialize swarm
+ * const swarm = await callMCPTool('swarm/init', {
+ *   topology: 'hierarchical-mesh',
+ *   maxAgents: 15
+ * });
+ * ```
+ */
+export async function callMCPTool(toolName, input = {}, context) {
+    // Look up tool in registry
+    const tool = TOOL_REGISTRY.get(toolName);
+    if (!tool) {
+        throw new MCPClientError(`MCP tool not found: ${toolName}`, toolName);
+    }
+    try {
+        // Call the tool handler
+        const result = await tool.handler(input, context);
+        return result;
+    }
+    catch (error) {
+        // Wrap and re-throw with context
+        throw new MCPClientError(`Failed to execute MCP tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`, toolName, error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Get tool metadata by name
+ *
+ * @param toolName - Name of the MCP tool
+ * @returns Tool metadata or undefined if not found
+ */
+export function getToolMetadata(toolName) {
+    const tool = TOOL_REGISTRY.get(toolName);
+    if (!tool) {
+        return undefined;
+    }
+    // Return everything except the handler function
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        category: tool.category,
+        tags: tool.tags,
+        version: tool.version,
+        cacheable: tool.cacheable,
+        cacheTTL: tool.cacheTTL,
+    };
+}
+/**
+ * List all available MCP tools
+ *
+ * @param category - Optional category filter
+ * @returns Array of tool metadata
+ */
+export function listMCPTools(category) {
+    const tools = Array.from(TOOL_REGISTRY.values());
+    const filtered = category
+        ? tools.filter(t => t.category === category)
+        : tools;
+    return filtered.map(tool => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        category: tool.category,
+        tags: tool.tags,
+        version: tool.version,
+        cacheable: tool.cacheable,
+        cacheTTL: tool.cacheTTL,
+    }));
+}
+/**
+ * Check if an MCP tool exists
+ *
+ * @param toolName - Name of the MCP tool
+ * @returns True if tool exists
+ */
+export function hasTool(toolName) {
+    return TOOL_REGISTRY.has(toolName);
+}
+/**
+ * Get all tool categories
+ *
+ * @returns Array of unique categories
+ */
+export function getToolCategories() {
+    const categories = new Set();
+    TOOL_REGISTRY.forEach(tool => {
+        if (tool.category) {
+            categories.add(tool.category);
+        }
+    });
+    return Array.from(categories).sort();
+}
+/**
+ * Validate tool input against schema
+ *
+ * @param toolName - Name of the MCP tool
+ * @param input - Input to validate
+ * @returns Validation result with errors if any
+ */
+export function validateToolInput(toolName, input) {
+    const tool = TOOL_REGISTRY.get(toolName);
+    if (!tool) {
+        return {
+            valid: false,
+            errors: [`Tool '${toolName}' not found`],
+        };
+    }
+    // Basic validation - check required fields
+    const schema = tool.inputSchema;
+    const errors = [];
+    if (schema.required && Array.isArray(schema.required)) {
+        for (const requiredField of schema.required) {
+            if (!(requiredField in input)) {
+                errors.push(`Missing required field: ${requiredField}`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors: errors.length > 0 ? errors : undefined,
+    };
+}
+export default {
+    callMCPTool,
+    getToolMetadata,
+    listMCPTools,
+    hasTool,
+    getToolCategories,
+    validateToolInput,
+    MCPClientError,
+};
+//# sourceMappingURL=mcp-client.js.map

package/dist/src/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;GAGG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEjD,qBAAqB;AACrB,SAAS,aAAa,CAAC,KAAgB;IACrC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACnB,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+CAA+C;AAC/C,aAAa,CAAC;IACZ,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,aAAa;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAG9B;IACA;IAHT,YACE,OAAe,EACR,QAAgB,EAChB,KAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAQ;QAGpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,QAAiC,EAAE,EACnC,OAAiC;IAEjC,2BAA2B;IAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,cAAc,CACtB,uBAAuB,QAAQ,EAAE,EACjC,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,wBAAwB;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,MAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iCAAiC;QACjC,MAAM,IAAI,cAAc,CACtB,+BAA+B,QAAQ,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACrG,QAAQ,EACR,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gDAAgD;IAChD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,QAAQ;QACvB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC5C,CAAC,CAAC,KAAK,CAAC;IAEV,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC3B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,KAA8B;IAE9B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,CAAC,SAAS,QAAQ,aAAa,CAAC;SACzC,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5C,IAAI,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KAC/C,CAAC;AACJ,CAAC;AAED,eAAe;IACb,WAAW;IACX,eAAe;IACf,YAAY;IACZ,OAAO;IACP,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;CACf,CAAC"}

package/dist/src/mcp-server.d.ts

@@ -0,0 +1,158 @@
+/**
+ * V3 CLI MCP Server Management
+ *
+ * Provides server lifecycle management for MCP integration:
+ * - Start/stop/status methods with process management
+ * - Health check endpoint integration
+ * - Graceful shutdown handling
+ * - PID file management for daemon detection
+ * - Event-based status monitoring
+ *
+ * Performance Targets:
+ * - Server startup: <400ms
+ * - Health check: <10ms
+ * - Graceful shutdown: <5s
+ *
+ * @module @claude-flow/cli/mcp-server
+ * @version 3.0.0
+ */
+import { EventEmitter } from 'events';
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerOptions {
+    transport?: 'stdio' | 'http' | 'websocket';
+    host?: string;
+    port?: number;
+    pidFile?: string;
+    logFile?: string;
+    tools?: string[] | 'all';
+    daemonize?: boolean;
+    timeout?: number;
+}
+/**
+ * MCP Server status
+ */
+export interface MCPServerStatus {
+    running: boolean;
+    pid?: number;
+    transport?: string;
+    host?: string;
+    port?: number;
+    uptime?: number;
+    tools?: number;
+    startedAt?: string;
+    health?: {
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    };
+}
+/**
+ * MCP Server Manager
+ *
+ * Manages the lifecycle of the MCP server process
+ */
+export declare class MCPServerManager extends EventEmitter {
+    private options;
+    private process?;
+    private server?;
+    private startTime?;
+    private healthCheckInterval?;
+    constructor(options?: MCPServerOptions);
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<MCPServerStatus>;
+    /**
+     * Stop the MCP server
+     */
+    stop(force?: boolean): Promise<void>;
+    /**
+     * Get server status
+     */
+    getStatus(): Promise<MCPServerStatus>;
+    /**
+     * Check server health
+     */
+    checkHealth(): Promise<{
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    }>;
+    /**
+     * Restart the server
+     */
+    restart(): Promise<MCPServerStatus>;
+    /**
+     * Start stdio server in-process
+     * Handles stdin/stdout directly like V2 implementation
+     */
+    private startStdioServer;
+    /**
+     * Handle incoming MCP message
+     */
+    private handleMCPMessage;
+    /**
+     * Start HTTP server in-process
+     */
+    private startHttpServer;
+    /**
+     * Wait for server to be ready
+     */
+    private waitForReady;
+    /**
+     * Wait for process to exit
+     */
+    private waitForExit;
+    /**
+     * Start health monitoring
+     */
+    private startHealthMonitoring;
+    /**
+     * Write PID file
+     */
+    private writePidFile;
+    /**
+     * Read PID file
+     */
+    private readPidFile;
+    /**
+     * Remove PID file
+     */
+    private removePidFile;
+    /**
+     * Check if process is running
+     */
+    private isProcessRunning;
+    /**
+     * Make HTTP request
+     */
+    private httpRequest;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+}
+/**
+ * Create MCP server manager
+ */
+export declare function createMCPServerManager(options?: MCPServerOptions): MCPServerManager;
+/**
+ * Get or create server manager singleton
+ */
+export declare function getServerManager(options?: MCPServerOptions): MCPServerManager;
+/**
+ * Quick start MCP server
+ */
+export declare function startMCPServer(options?: MCPServerOptions): Promise<MCPServerStatus>;
+/**
+ * Quick stop MCP server
+ */
+export declare function stopMCPServer(force?: boolean): Promise<void>;
+/**
+ * Get MCP server status
+ */
+export declare function getMCPServerStatus(): Promise<MCPServerStatus>;
+export default MCPServerManager;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/src/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAatC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;CACH;AAgBD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,mBAAmB,CAAC,CAAiB;gBAEjC,OAAO,GAAE,gBAAqB;IAK1C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IA2CvC;;OAEG;IACG,IAAI,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDxC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAsC3C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IA+BF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAKzC;;;OAGG;YACW,gBAAgB;IA4F9B;;OAEG;YACW,gBAAgB;IAiH9B;;OAEG;YACW,eAAe;IAgC7B;;OAEG;YACW,YAAY;IAmB1B;;OAEG;YACW,WAAW;IAezB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;YACW,YAAY;IAK1B;;OAEG;YACW,WAAW;IAUzB;;OAEG;YACW,aAAa;IAQ3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;YACW,WAAW;IA0CzB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,gBAAgB,GACzB,gBAAgB,CAElB;AAOD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,gBAAgB,CAKlB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAGnE;AAED,eAAe,gBAAgB,CAAC"}