@claude-flow/cli 3.0.0-alpha.13 → 3.0.0-alpha.15

package/src/config-adapter.ts

@@ -1,210 +0,0 @@
-/**
- * Configuration Adapter
- * Converts between SystemConfig and V3Config types
- */
-
-import type { SystemConfig } from '@claude-flow/shared';
-import type { V3Config } from './types.js';
-
-/**
- * Convert SystemConfig to V3Config (CLI-specific format)
- */
-export function systemConfigToV3Config(systemConfig: SystemConfig): V3Config {
-  return {
-    version: '3.0.0',
-    projectRoot: systemConfig.orchestrator?.session?.dataDir || process.cwd(),
-
-    // Agent configuration
-    agents: {
-      defaultType: 'coder',
-      autoSpawn: false, // Not in SystemConfig
-      maxConcurrent: systemConfig.orchestrator?.lifecycle?.maxConcurrentAgents ?? 15,
-      timeout: systemConfig.orchestrator?.lifecycle?.spawnTimeout ?? 300000,
-      providers: [],
-    },
-
-    // Swarm configuration
-    swarm: {
-      topology: normalizeTopology(systemConfig.swarm?.topology),
-      maxAgents: systemConfig.swarm?.maxAgents ?? 15,
-      autoScale: systemConfig.swarm?.autoScale?.enabled ?? false,
-      coordinationStrategy: systemConfig.swarm?.coordination?.consensusRequired ? 'consensus' : 'leader',
-      healthCheckInterval: systemConfig.swarm?.coordination?.timeoutMs ?? 10000,
-    },
-
-    // Memory configuration
-    memory: {
-      backend: normalizeMemoryBackend(systemConfig.memory?.type),
-      persistPath: systemConfig.memory?.path || './data/memory',
-      cacheSize: systemConfig.memory?.maxSize ?? 1000000,
-      enableHNSW: systemConfig.memory?.agentdb?.indexType === 'hnsw',
-      vectorDimension: systemConfig.memory?.agentdb?.dimensions ?? 1536,
-    },
-
-    // MCP configuration
-    mcp: {
-      serverHost: systemConfig.mcp?.transport?.host || 'localhost',
-      serverPort: systemConfig.mcp?.transport?.port ?? 3000,
-      autoStart: false, // Not in SystemConfig
-      transportType: systemConfig.mcp?.transport?.type || 'stdio',
-      tools: [], // Not in SystemConfig
-    },
-
-    // CLI preferences
-    cli: {
-      colorOutput: true,
-      interactive: true,
-      verbosity: 'normal',
-      outputFormat: 'text',
-      progressStyle: 'spinner',
-    },
-
-    // Hooks configuration
-    hooks: {
-      enabled: false,
-      autoExecute: false,
-      hooks: [],
-    },
-  };
-}
-
-/**
- * Convert V3Config to SystemConfig
- */
-export function v3ConfigToSystemConfig(v3Config: V3Config): Partial<SystemConfig> {
-  return {
-    orchestrator: {
-      lifecycle: {
-        maxConcurrentAgents: v3Config.agents.maxConcurrent,
-        spawnTimeout: v3Config.agents.timeout,
-        terminateTimeout: 10000,
-        maxSpawnRetries: 3,
-      },
-      session: {
-        dataDir: v3Config.projectRoot,
-        persistSessions: true,
-        sessionRetentionMs: 3600000,
-      },
-      health: {
-        checkInterval: v3Config.swarm.healthCheckInterval,
-        historyLimit: 100,
-        degradedThreshold: 1,
-        unhealthyThreshold: 2,
-      },
-    },
-
-    swarm: {
-      topology: denormalizeTopology(v3Config.swarm.topology),
-      maxAgents: v3Config.swarm.maxAgents,
-      autoScale: {
-        enabled: v3Config.swarm.autoScale,
-        minAgents: 1,
-        maxAgents: v3Config.swarm.maxAgents,
-        scaleUpThreshold: 0.8,
-        scaleDownThreshold: 0.3,
-      },
-      coordination: {
-        consensusRequired: v3Config.swarm.coordinationStrategy === 'consensus',
-        timeoutMs: v3Config.swarm.healthCheckInterval,
-        retryPolicy: {
-          maxRetries: 3,
-          backoffMs: 500,
-        },
-      },
-      communication: {
-        protocol: 'events',
-        batchSize: 10,
-        flushIntervalMs: 100,
-      },
-    },
-
-    memory: {
-      type: denormalizeMemoryBackend(v3Config.memory.backend),
-      path: v3Config.memory.persistPath,
-      maxSize: v3Config.memory.cacheSize,
-      agentdb: {
-        dimensions: v3Config.memory.vectorDimension,
-        indexType: v3Config.memory.enableHNSW ? 'hnsw' : 'flat',
-        efConstruction: 200,
-        m: 16,
-        quantization: 'none',
-      },
-    },
-
-    mcp: {
-      name: 'claude-flow',
-      version: '3.0.0',
-      transport: {
-        type: v3Config.mcp.transportType as 'stdio' | 'http' | 'websocket',
-        host: v3Config.mcp.serverHost,
-        port: v3Config.mcp.serverPort,
-      },
-      capabilities: {
-        tools: true,
-        resources: true,
-        prompts: true,
-        logging: true,
-      },
-    },
-  };
-}
-
-/**
- * Normalize topology from SystemConfig to V3Config
- */
-function normalizeTopology(
-  topology: string | undefined
-): 'hierarchical' | 'mesh' | 'ring' | 'star' | 'hybrid' {
-  switch (topology) {
-    case 'hierarchical':
-    case 'mesh':
-    case 'ring':
-    case 'star':
-      return topology;
-    case 'hierarchical-mesh':
-    case 'adaptive':
-      return 'hybrid';
-    default:
-      return 'hierarchical';
-  }
-}
-
-/**
- * Denormalize topology from V3Config to SystemConfig
- */
-function denormalizeTopology(
-  topology: 'hierarchical' | 'mesh' | 'ring' | 'star' | 'hybrid'
-): 'hierarchical' | 'mesh' | 'ring' | 'star' | 'adaptive' | 'hierarchical-mesh' {
-  if (topology === 'hybrid') {
-    return 'hierarchical-mesh';
-  }
-  return topology;
-}
-
-/**
- * Normalize memory backend from SystemConfig to V3Config
- */
-function normalizeMemoryBackend(
-  backend: string | undefined
-): 'memory' | 'sqlite' | 'agentdb' | 'hybrid' {
-  switch (backend) {
-    case 'memory':
-    case 'sqlite':
-    case 'agentdb':
-    case 'hybrid':
-      return backend;
-    case 'redis':
-      return 'memory'; // Redis maps to memory for CLI purposes
-    default:
-      return 'hybrid';
-  }
-}
-
-/**
- * Denormalize memory backend from V3Config to SystemConfig
- */
-function denormalizeMemoryBackend(
-  backend: 'memory' | 'sqlite' | 'agentdb' | 'hybrid'
-): 'memory' | 'sqlite' | 'agentdb' | 'hybrid' | 'redis' {
-  return backend;
-}

package/src/index.ts

@@ -1,443 +0,0 @@
-/**
- * V3 CLI Main Entry Point
- * Modernized CLI for Claude Flow V3
- *
- * Created with ❤️ by ruv.io
- */
-
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import type { Command, CommandContext, CommandResult, V3Config, CLIError } from './types.js';
-import { CommandParser, commandParser } from './parser.js';
-import { OutputFormatter, output } from './output.js';
-import { commands, commandRegistry, getCommand, getCommandNames } from './commands/index.js';
-import { suggestCommand } from './suggest.js';
-
-// Read version from package.json at runtime
-function getPackageVersion(): string {
-  try {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    // Navigate from dist/src to package root
-    const pkgPath = join(__dirname, '..', '..', 'package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-    return pkg.version || '3.0.0';
-  } catch {
-    return '3.0.0';
-  }
-}
-
-export const VERSION = getPackageVersion();
-
-export interface CLIOptions {
-  name?: string;
-  description?: string;
-  version?: string;
-  interactive?: boolean;
-}
-
-/**
- * V3 CLI Application
- */
-export class CLI {
-  private name: string;
-  private description: string;
-  private version: string;
-  private parser: CommandParser;
-  private output: OutputFormatter;
-  private interactive: boolean;
-
-  constructor(options: CLIOptions = {}) {
-    this.name = options.name || 'claude-flow';
-    this.description = options.description || 'Claude Flow V3 - AI Agent Orchestration Platform';
-    this.version = options.version || VERSION;
-    this.parser = commandParser;
-    this.output = output;
-    this.interactive = options.interactive ?? process.stdin.isTTY ?? false;
-
-    // Register all commands
-    for (const cmd of commands) {
-      this.parser.registerCommand(cmd);
-    }
-  }
-
-  /**
-   * Run the CLI with given arguments
-   */
-  async run(args: string[] = process.argv.slice(2)): Promise<void> {
-    try {
-      // Parse arguments
-      const parseResult = this.parser.parse(args);
-      const { command: commandPath, flags, positional } = parseResult;
-
-      // Handle global flags
-      if (flags.version || flags.V) {
-        this.showVersion();
-        return;
-      }
-
-      if (flags.noColor) {
-        this.output.setColorEnabled(false);
-      }
-
-      // Set verbosity level based on flags
-      if (flags.quiet) {
-        this.output.setVerbosity('quiet');
-      } else if (flags.verbose) {
-        this.output.setVerbosity(process.env.DEBUG ? 'debug' : 'verbose');
-      }
-
-      // Verbose mode: show parsed arguments
-      if (this.output.isVerbose()) {
-        this.output.printDebug(`Command: ${commandPath.join(' ') || '(none)'}`);
-        this.output.printDebug(`Positional: [${positional.join(', ')}]`);
-        this.output.printDebug(`Flags: ${JSON.stringify(Object.fromEntries(Object.entries(flags).filter(([k]) => k !== '_')))}`);
-        this.output.printDebug(`CWD: ${process.cwd()}`);
-      }
-
-      // No command - show help or suggest correction
-      if (commandPath.length === 0 || flags.help || flags.h) {
-        if (commandPath.length > 0) {
-          // Show command-specific help
-          this.showCommandHelp(commandPath[0]);
-        } else if (positional.length > 0 && !positional[0].startsWith('-')) {
-          // First positional looks like an attempted command - suggest correction
-          const attemptedCommand = positional[0];
-          this.output.printError(`Unknown command: ${attemptedCommand}`);
-          const availableCommands = Array.from(new Set(commands.map(c => c.name)));
-          const { message } = suggestCommand(attemptedCommand, availableCommands);
-          this.output.writeln(this.output.dim(`  ${message}`));
-          process.exit(1);
-        } else {
-          this.showHelp();
-        }
-        return;
-      }
-
-      // Find and execute command
-      const commandName = commandPath[0];
-      // First check the parser's registry (for dynamically registered commands)
-      // Then fall back to the static registry
-      const command = this.parser.getCommand(commandName) || getCommand(commandName);
-
-      if (!command) {
-        this.output.printError(`Unknown command: ${commandName}`);
-        // Smart suggestions
-        const availableCommands = Array.from(new Set(commands.map(c => c.name)));
-        const { message } = suggestCommand(commandName, availableCommands);
-        this.output.writeln(this.output.dim(`  ${message}`));
-        process.exit(1);
-      }
-
-      // Handle subcommand (supports nested subcommands)
-      let targetCommand = command;
-      let subcommandArgs = positional;
-
-      // Process command path (e.g., ['hooks', 'worker', 'list'])
-      // Note: When parser includes subcommand in commandPath, positional already excludes it
-      if (commandPath.length > 1 && command.subcommands) {
-        const subcommandName = commandPath[1];
-        const subcommand = command.subcommands.find(
-          sc => sc.name === subcommandName || sc.aliases?.includes(subcommandName)
-        );
-
-        if (subcommand) {
-          targetCommand = subcommand;
-          // Parser already extracted subcommand from positional, so use as-is
-          subcommandArgs = positional;
-
-          // Check for nested subcommand (level 2)
-          if (commandPath.length > 2 && subcommand.subcommands) {
-            const nestedName = commandPath[2];
-            const nestedSubcommand = subcommand.subcommands.find(
-              sc => sc.name === nestedName || sc.aliases?.includes(nestedName)
-            );
-            if (nestedSubcommand) {
-              targetCommand = nestedSubcommand;
-              // Parser already extracted nested subcommand too
-              subcommandArgs = positional;
-            }
-          }
-        }
-      } else if (positional.length > 0 && command.subcommands) {
-        // Check if first positional is a subcommand
-        const subcommandName = positional[0];
-        const subcommand = command.subcommands.find(
-          sc => sc.name === subcommandName || sc.aliases?.includes(subcommandName)
-        );
-
-        if (subcommand) {
-          targetCommand = subcommand;
-          subcommandArgs = positional.slice(1);
-
-          // Check for nested subcommand (level 2 from positional)
-          if (subcommandArgs.length > 0 && subcommand.subcommands) {
-            const nestedName = subcommandArgs[0];
-            const nestedSubcommand = subcommand.subcommands.find(
-              sc => sc.name === nestedName || sc.aliases?.includes(nestedName)
-            );
-            if (nestedSubcommand) {
-              targetCommand = nestedSubcommand;
-              subcommandArgs = subcommandArgs.slice(1);
-            }
-          }
-        }
-      }
-
-      // Validate flags
-      const validationErrors = this.parser.validateFlags(flags, targetCommand);
-      if (validationErrors.length > 0) {
-        for (const error of validationErrors) {
-          this.output.printError(error);
-        }
-        process.exit(1);
-      }
-
-      // Build context
-      const ctx: CommandContext = {
-        args: subcommandArgs,
-        flags,
-        config: await this.loadConfig(flags.config as string),
-        cwd: process.cwd(),
-        interactive: this.interactive && !flags.quiet
-      };
-
-      // Execute command
-      if (targetCommand.action) {
-        if (this.output.isVerbose()) {
-          this.output.printDebug(`Executing: ${targetCommand.name}`);
-        }
-
-        const startTime = Date.now();
-        const result = await targetCommand.action(ctx);
-
-        if (this.output.isVerbose()) {
-          this.output.printDebug(`Completed in ${Date.now() - startTime}ms`);
-        }
-
-        if (result && !result.success) {
-          process.exit(result.exitCode || 1);
-        }
-      } else {
-        // No action - show command help
-        this.showCommandHelp(commandName);
-      }
-    } catch (error) {
-      // Don't re-handle if this is a process.exit error (from mocked tests)
-      const errorMessage = (error as Error).message;
-      if (errorMessage && errorMessage.startsWith('process.exit:')) {
-        throw error; // Re-throw so tests can capture the exit code
-      }
-      this.handleError(error as Error);
-    }
-  }
-
-  /**
-   * Show main help
-   */
-  private showHelp(): void {
-    this.output.writeln();
-    this.output.writeln(this.output.bold(`${this.name} v${this.version}`));
-    this.output.writeln(this.output.dim(this.description));
-    this.output.writeln();
-
-    this.output.writeln(this.output.bold('USAGE:'));
-    this.output.writeln(`  ${this.name} <command> [subcommand] [options]`);
-    this.output.writeln();
-
-    this.output.writeln(this.output.bold('COMMANDS:'));
-    for (const cmd of commands) {
-      if (cmd.hidden) continue;
-      const name = cmd.name.padEnd(12);
-      this.output.writeln(`  ${this.output.highlight(name)} ${cmd.description}`);
-    }
-    this.output.writeln();
-
-    this.output.writeln(this.output.bold('GLOBAL OPTIONS:'));
-    for (const opt of this.parser.getGlobalOptions()) {
-      const flags = opt.short ? `-${opt.short}, --${opt.name}` : `    --${opt.name}`;
-      this.output.writeln(`  ${flags.padEnd(25)} ${opt.description}`);
-    }
-    this.output.writeln();
-
-    this.output.writeln(this.output.bold('V3 FEATURES:'));
-    this.output.printList([
-      '15-agent hierarchical mesh coordination',
-      'AgentDB with HNSW indexing (150x-12,500x faster)',
-      'Flash Attention (2.49x-7.47x speedup)',
-      'Unified SwarmCoordinator engine',
-      'Event-sourced state management',
-      'Domain-Driven Design architecture'
-    ]);
-    this.output.writeln();
-
-    this.output.writeln(this.output.bold('EXAMPLES:'));
-    this.output.writeln(`  ${this.name} agent spawn -t coder              # Spawn a coder agent`);
-    this.output.writeln(`  ${this.name} swarm init --v3-mode              # Initialize V3 swarm`);
-    this.output.writeln(`  ${this.name} memory search -q "auth patterns"  # Semantic search`);
-    this.output.writeln(`  ${this.name} mcp start                         # Start MCP server`);
-    this.output.writeln();
-
-    this.output.writeln(this.output.dim('Run "claude-flow <command> --help" for command help'));
-    this.output.writeln();
-    this.output.writeln(this.output.dim('Created with ❤️ by ruv.io'));
-    this.output.writeln();
-  }
-
-  /**
-   * Show command-specific help
-   */
-  private showCommandHelp(commandName: string): void {
-    const command = getCommand(commandName);
-
-    if (!command) {
-      this.output.printError(`Unknown command: ${commandName}`);
-      return;
-    }
-
-    this.output.writeln();
-    this.output.writeln(this.output.bold(`${this.name} ${command.name}`));
-    this.output.writeln(command.description);
-    this.output.writeln();
-
-    // Subcommands
-    if (command.subcommands && command.subcommands.length > 0) {
-      this.output.writeln(this.output.bold('SUBCOMMANDS:'));
-      for (const sub of command.subcommands) {
-        if (sub.hidden) continue;
-        const name = sub.name.padEnd(15);
-        const aliases = sub.aliases ? this.output.dim(` (${sub.aliases.join(', ')})`) : '';
-        this.output.writeln(`  ${this.output.highlight(name)} ${sub.description}${aliases}`);
-      }
-      this.output.writeln();
-    }
-
-    // Options
-    if (command.options && command.options.length > 0) {
-      this.output.writeln(this.output.bold('OPTIONS:'));
-      for (const opt of command.options) {
-        const flags = opt.short ? `-${opt.short}, --${opt.name}` : `    --${opt.name}`;
-        const required = opt.required ? this.output.error(' (required)') : '';
-        const defaultVal = opt.default !== undefined ? this.output.dim(` [default: ${opt.default}]`) : '';
-        this.output.writeln(`  ${flags.padEnd(25)} ${opt.description}${required}${defaultVal}`);
-      }
-      this.output.writeln();
-    }
-
-    // Examples
-    if (command.examples && command.examples.length > 0) {
-      this.output.writeln(this.output.bold('EXAMPLES:'));
-      for (const example of command.examples) {
-        this.output.writeln(`  ${this.output.dim('$')} ${example.command}`);
-        this.output.writeln(`    ${this.output.dim(example.description)}`);
-      }
-      this.output.writeln();
-    }
-  }
-
-  /**
-   * Show version
-   */
-  private showVersion(): void {
-    this.output.writeln(`${this.name} v${this.version}`);
-  }
-
-  /**
-   * Load configuration file
-   */
-  private async loadConfig(configPath?: string): Promise<V3Config | undefined> {
-    try {
-      // Import config utilities
-      const { loadConfig: loadSystemConfig } = await import('@claude-flow/shared');
-      const { systemConfigToV3Config } = await import('./config-adapter.js');
-
-      // Load configuration
-      const loaded = await loadSystemConfig({
-        file: configPath,
-        paths: configPath ? undefined : [process.cwd()],
-      });
-
-      // Convert to V3Config format
-      const v3Config = systemConfigToV3Config(loaded.config);
-
-      // Log warnings if any
-      if (loaded.warnings && loaded.warnings.length > 0) {
-        for (const warning of loaded.warnings) {
-          this.output.printWarning(warning);
-        }
-      }
-
-      return v3Config;
-    } catch (error) {
-      // Config loading is optional - don't fail if it doesn't exist
-      if (process.env.DEBUG) {
-        this.output.writeln(
-          this.output.dim(`Config loading failed: ${(error as Error).message}`)
-        );
-      }
-      return undefined;
-    }
-  }
-
-  /**
-   * Handle errors
-   */
-  private handleError(error: Error): void {
-    if ('code' in error) {
-      // CLIError
-      const cliError = error as CLIError;
-      this.output.printError(cliError.message);
-
-      if (cliError.details) {
-        this.output.writeln(this.output.dim(JSON.stringify(cliError.details, null, 2)));
-      }
-
-      process.exit(cliError.exitCode);
-    } else {
-      // Generic error
-      this.output.printError(error.message);
-
-      if (process.env.DEBUG) {
-        this.output.writeln();
-        this.output.writeln(this.output.dim(error.stack || ''));
-      }
-
-      process.exit(1);
-    }
-  }
-}
-
-// =============================================================================
-// Module Exports
-// =============================================================================
-
-// Types
-export * from './types.js';
-
-// Parser
-export { CommandParser, commandParser } from './parser.js';
-
-// Output
-export { OutputFormatter, output, Progress, Spinner, type VerbosityLevel } from './output.js';
-
-// Prompt
-export * from './prompt.js';
-
-// Commands (internal use)
-export * from './commands/index.js';
-
-// MCP Server management
-export {
-  MCPServerManager,
-  createMCPServerManager,
-  getServerManager,
-  startMCPServer,
-  stopMCPServer,
-  getMCPServerStatus,
-  type MCPServerOptions,
-  type MCPServerStatus,
-} from './mcp-server.js';
-
-// Default export
-export default CLI;