claude-flow 3.0.0-alpha.8 → 3.0.0-alpha.9

package/src/commands/workflow.ts

@@ -0,0 +1,742 @@
+/**
+ * V3 CLI Workflow Command
+ * Workflow execution, validation, and template management
+ */
+
+import type { Command, CommandContext, CommandResult } from '../types.js';
+import { output } from '../output.js';
+import { select, confirm, input } from '../prompt.js';
+import { callMCPTool, MCPClientError } from '../mcp-client.js';
+
+// Workflow templates
+const WORKFLOW_TEMPLATES = [
+  { value: 'development', label: 'Development', hint: 'Standard development workflow' },
+  { value: 'research', label: 'Research', hint: 'Research and analysis workflow' },
+  { value: 'testing', label: 'Testing', hint: 'Comprehensive testing workflow' },
+  { value: 'security-audit', label: 'Security Audit', hint: 'Security review workflow' },
+  { value: 'code-review', label: 'Code Review', hint: 'Multi-agent code review' },
+  { value: 'refactoring', label: 'Refactoring', hint: 'Code refactoring workflow' },
+  { value: 'sparc', label: 'SPARC', hint: 'SPARC methodology workflow' },
+  { value: 'custom', label: 'Custom', hint: 'Define custom workflow' }
+];
+
+// Run subcommand
+const runCommand: Command = {
+  name: 'run',
+  description: 'Execute a workflow',
+  options: [
+    {
+      name: 'template',
+      short: 't',
+      description: 'Workflow template',
+      type: 'string',
+      choices: WORKFLOW_TEMPLATES.map(t => t.value)
+    },
+    {
+      name: 'file',
+      short: 'f',
+      description: 'Workflow definition file (YAML/JSON)',
+      type: 'string'
+    },
+    {
+      name: 'task',
+      description: 'Task description',
+      type: 'string'
+    },
+    {
+      name: 'parallel',
+      short: 'p',
+      description: 'Enable parallel execution',
+      type: 'boolean',
+      default: true
+    },
+    {
+      name: 'max-agents',
+      short: 'm',
+      description: 'Maximum agents to spawn',
+      type: 'number',
+      default: 5
+    },
+    {
+      name: 'timeout',
+      description: 'Workflow timeout in minutes',
+      type: 'number',
+      default: 30
+    },
+    {
+      name: 'dry-run',
+      short: 'd',
+      description: 'Validate without executing',
+      type: 'boolean',
+      default: false
+    }
+  ],
+  examples: [
+    { command: 'claude-flow workflow run -t development --task "Build auth system"', description: 'Run development workflow' },
+    { command: 'claude-flow workflow run -f ./workflow.yaml', description: 'Run from file' },
+    { command: 'claude-flow workflow run -t sparc --dry-run', description: 'Validate SPARC workflow' }
+  ],
+  action: async (ctx: CommandContext): Promise<CommandResult> => {
+    let template = ctx.flags.template as string;
+    const file = ctx.flags.file as string;
+    const task = ctx.flags.task as string || ctx.args[0];
+    const parallel = ctx.flags.parallel as boolean;
+    const maxAgents = ctx.flags.maxAgents as number;
+    const timeout = ctx.flags.timeout as number;
+    const dryRun = ctx.flags.dryRun as boolean;
+
+    if (!template && !file && ctx.interactive) {
+      template = await select({
+        message: 'Select workflow template:',
+        options: WORKFLOW_TEMPLATES
+      });
+    }
+
+    if (!template && !file) {
+      output.printError('Workflow template or file is required. Use --template or --file');
+      return { success: false, exitCode: 1 };
+    }
+
+    output.writeln();
+    if (dryRun) {
+      output.writeln(output.warning('DRY RUN MODE - No changes will be made'));
+    }
+    output.writeln(output.bold(`Workflow: ${template || file}`));
+    output.writeln();
+
+    const spinner = output.createSpinner({ text: 'Initializing workflow...', spinner: 'dots' });
+
+    try {
+      spinner.start();
+
+      // Call MCP tool to run workflow
+      const result = await callMCPTool<{
+        workflowId: string;
+        template: string;
+        status: 'running' | 'completed' | 'failed' | 'validated';
+        stages: Array<{
+          name: string;
+          status: string;
+          agents: string[];
+          duration?: number;
+        }>;
+        metrics: {
+          totalStages: number;
+          completedStages: number;
+          agentsSpawned: number;
+          estimatedDuration: string;
+        };
+      }>('workflow/run', {
+        template: template || undefined,
+        file: file || undefined,
+        task,
+        options: {
+          parallel,
+          maxAgents,
+          timeout,
+          dryRun,
+        },
+      });
+
+      if (dryRun) {
+        spinner.succeed('Workflow validated successfully');
+      } else {
+        spinner.succeed('Workflow started');
+      }
+
+      if (ctx.flags.format === 'json') {
+        output.printJson(result);
+        return { success: true, data: result };
+      }
+
+      output.writeln();
+      output.printBox(
+        [
+          `ID: ${result.workflowId}`,
+          `Template: ${result.template}`,
+          `Status: ${result.status}`,
+          `Stages: ${result.metrics.totalStages}`,
+          `Agents: ${result.metrics.agentsSpawned}`,
+          `Est. Duration: ${result.metrics.estimatedDuration}`
+        ].join('\n'),
+        'Workflow Details'
+      );
+
+      output.writeln();
+      output.writeln(output.bold('Stages'));
+      output.printTable({
+        columns: [
+          { key: 'name', header: 'Stage', width: 20 },
+          { key: 'status', header: 'Status', width: 12, format: formatStageStatus },
+          { key: 'agents', header: 'Agents', width: 30, format: (v) => Array.isArray(v) ? v.join(', ') : String(v) },
+          { key: 'duration', header: 'Duration', width: 10, align: 'right', format: (v) => v ? `${v}ms` : '-' }
+        ],
+        data: result.stages
+      });
+
+      if (!dryRun) {
+        output.writeln();
+        output.printInfo(`Track progress: claude-flow workflow status ${result.workflowId}`);
+      }
+
+      return { success: true, data: result };
+    } catch (error) {
+      spinner.fail('Workflow failed');
+      if (error instanceof MCPClientError) {
+        output.printError(`Workflow error: ${error.message}`);
+      } else {
+        output.printError(`Unexpected error: ${String(error)}`);
+      }
+      return { success: false, exitCode: 1 };
+    }
+  }
+};
+
+// Validate subcommand
+const validateCommand: Command = {
+  name: 'validate',
+  description: 'Validate a workflow definition',
+  options: [
+    {
+      name: 'file',
+      short: 'f',
+      description: 'Workflow definition file',
+      type: 'string',
+      required: true
+    },
+    {
+      name: 'strict',
+      short: 's',
+      description: 'Strict validation mode',
+      type: 'boolean',
+      default: false
+    }
+  ],
+  examples: [
+    { command: 'claude-flow workflow validate -f ./workflow.yaml', description: 'Validate workflow file' },
+    { command: 'claude-flow workflow validate -f ./workflow.json --strict', description: 'Strict validation' }
+  ],
+  action: async (ctx: CommandContext): Promise<CommandResult> => {
+    const file = ctx.flags.file as string || ctx.args[0];
+    const strict = ctx.flags.strict as boolean;
+
+    if (!file) {
+      output.printError('Workflow file is required. Use --file or -f');
+      return { success: false, exitCode: 1 };
+    }
+
+    output.printInfo(`Validating: ${file}`);
+
+    try {
+      const result = await callMCPTool<{
+        valid: boolean;
+        file: string;
+        errors: Array<{ line: number; message: string; severity: string }>;
+        warnings: Array<{ line: number; message: string }>;
+        stats: {
+          stages: number;
+          agents: number;
+          estimatedDuration: string;
+        };
+      }>('workflow/validate', {
+        file,
+        strict,
+      });
+
+      if (ctx.flags.format === 'json') {
+        output.printJson(result);
+        return { success: result.valid, data: result };
+      }
+
+      output.writeln();
+
+      if (result.valid) {
+        output.printSuccess('Workflow is valid');
+      } else {
+        output.printError('Workflow validation failed');
+      }
+
+      if (result.errors.length > 0) {
+        output.writeln();
+        output.writeln(output.bold(output.error('Errors')));
+        output.printTable({
+          columns: [
+            { key: 'line', header: 'Line', width: 8, align: 'right' },
+            { key: 'severity', header: 'Severity', width: 10 },
+            { key: 'message', header: 'Message', width: 50 }
+          ],
+          data: result.errors
+        });
+      }
+
+      if (result.warnings.length > 0) {
+        output.writeln();
+        output.writeln(output.bold(output.warning('Warnings')));
+        result.warnings.forEach(w => {
+          output.writeln(output.warning(`  Line ${w.line}: ${w.message}`));
+        });
+      }
+
+      if (result.valid) {
+        output.writeln();
+        output.writeln(output.bold('Workflow Stats'));
+        output.printList([
+          `Stages: ${result.stats.stages}`,
+          `Agents Required: ${result.stats.agents}`,
+          `Est. Duration: ${result.stats.estimatedDuration}`
+        ]);
+      }
+
+      return { success: result.valid, data: result };
+    } catch (error) {
+      if (error instanceof MCPClientError) {
+        output.printError(`Validation error: ${error.message}`);
+      } else {
+        output.printError(`Unexpected error: ${String(error)}`);
+      }
+      return { success: false, exitCode: 1 };
+    }
+  }
+};
+
+// List subcommand
+const listCommand: Command = {
+  name: 'list',
+  aliases: ['ls'],
+  description: 'List workflows',
+  options: [
+    {
+      name: 'status',
+      short: 's',
+      description: 'Filter by status',
+      type: 'string',
+      choices: ['running', 'completed', 'failed', 'all']
+    },
+    {
+      name: 'limit',
+      short: 'l',
+      description: 'Maximum results',
+      type: 'number',
+      default: 10
+    }
+  ],
+  action: async (ctx: CommandContext): Promise<CommandResult> => {
+    const status = ctx.flags.status as string;
+    const limit = ctx.flags.limit as number;
+
+    try {
+      const result = await callMCPTool<{
+        workflows: Array<{
+          id: string;
+          template: string;
+          status: string;
+          startedAt: string;
+          completedAt?: string;
+          progress: number;
+        }>;
+        total: number;
+      }>('workflow/list', {
+        status: status || 'all',
+        limit,
+      });
+
+      if (ctx.flags.format === 'json') {
+        output.printJson(result);
+        return { success: true, data: result };
+      }
+
+      output.writeln();
+      output.writeln(output.bold('Workflows'));
+      output.writeln();
+
+      if (result.workflows.length === 0) {
+        output.printInfo('No workflows found');
+        return { success: true, data: result };
+      }
+
+      output.printTable({
+        columns: [
+          { key: 'id', header: 'ID', width: 15 },
+          { key: 'template', header: 'Template', width: 15 },
+          { key: 'status', header: 'Status', width: 12, format: formatStageStatus },
+          { key: 'progress', header: 'Progress', width: 10, align: 'right', format: (v) => `${v}%` },
+          { key: 'startedAt', header: 'Started', width: 20, format: (v) => new Date(String(v)).toLocaleString() }
+        ],
+        data: result.workflows
+      });
+
+      output.writeln();
+      output.printInfo(`Total: ${result.total} workflows`);
+
+      return { success: true, data: result };
+    } catch (error) {
+      if (error instanceof MCPClientError) {
+        output.printError(`Failed to list workflows: ${error.message}`);
+      } else {
+        output.printError(`Unexpected error: ${String(error)}`);
+      }
+      return { success: false, exitCode: 1 };
+    }
+  }
+};
+
+// Status subcommand
+const statusCommand: Command = {
+  name: 'status',
+  description: 'Show workflow status',
+  options: [
+    {
+      name: 'watch',
+      short: 'w',
+      description: 'Watch for changes',
+      type: 'boolean',
+      default: false
+    }
+  ],
+  action: async (ctx: CommandContext): Promise<CommandResult> => {
+    const workflowId = ctx.args[0];
+
+    if (!workflowId) {
+      output.printError('Workflow ID is required');
+      return { success: false, exitCode: 1 };
+    }
+
+    try {
+      const result = await callMCPTool<{
+        id: string;
+        template: string;
+        status: string;
+        progress: number;
+        stages: Array<{
+          name: string;
+          status: string;
+          startedAt?: string;
+          completedAt?: string;
+          agents: string[];
+          output?: string;
+        }>;
+        metrics: {
+          duration: number;
+          tokensUsed: number;
+          agentsSpawned: number;
+        };
+      }>('workflow/status', {
+        workflowId,
+      });
+
+      if (ctx.flags.format === 'json') {
+        output.printJson(result);
+        return { success: true, data: result };
+      }
+
+      output.writeln();
+      output.printBox(
+        [
+          `ID: ${result.id}`,
+          `Template: ${result.template}`,
+          `Status: ${formatStageStatus(result.status)}`,
+          `Progress: ${result.progress}%`,
+          `Duration: ${(result.metrics.duration / 1000).toFixed(1)}s`,
+          `Tokens: ${result.metrics.tokensUsed.toLocaleString()}`,
+          `Agents: ${result.metrics.agentsSpawned}`
+        ].join('\n'),
+        'Workflow Status'
+      );
+
+      output.writeln();
+      output.writeln(output.bold('Stage Progress'));
+      output.printTable({
+        columns: [
+          { key: 'name', header: 'Stage', width: 20 },
+          { key: 'status', header: 'Status', width: 12, format: formatStageStatus },
+          { key: 'agents', header: 'Agents', width: 25, format: (v) => Array.isArray(v) ? v.length.toString() : '0' }
+        ],
+        data: result.stages
+      });
+
+      return { success: true, data: result };
+    } catch (error) {
+      if (error instanceof MCPClientError) {
+        output.printError(`Failed to get status: ${error.message}`);
+      } else {
+        output.printError(`Unexpected error: ${String(error)}`);
+      }
+      return { success: false, exitCode: 1 };
+    }
+  }
+};
+
+// Stop subcommand
+const stopCommand: Command = {
+  name: 'stop',
+  description: 'Stop a running workflow',
+  options: [
+    {
+      name: 'force',
+      short: 'f',
+      description: 'Force stop without graceful shutdown',
+      type: 'boolean',
+      default: false
+    }
+  ],
+  action: async (ctx: CommandContext): Promise<CommandResult> => {
+    const workflowId = ctx.args[0];
+    const force = ctx.flags.force as boolean;
+
+    if (!workflowId) {
+      output.printError('Workflow ID is required');
+      return { success: false, exitCode: 1 };
+    }
+
+    if (!force && ctx.interactive) {
+      const confirmed = await confirm({
+        message: `Stop workflow ${workflowId}?`,
+        default: false
+      });
+
+      if (!confirmed) {
+        output.printInfo('Operation cancelled');
+        return { success: true };
+      }
+    }
+
+    try {
+      const result = await callMCPTool<{
+        workflowId: string;
+        stopped: boolean;
+        stoppedAt: string;
+      }>('workflow/stop', {
+        workflowId,
+        graceful: !force,
+      });
+
+      output.printSuccess(`Workflow ${workflowId} stopped`);
+
+      return { success: true, data: result };
+    } catch (error) {
+      if (error instanceof MCPClientError) {
+        output.printError(`Failed to stop workflow: ${error.message}`);
+      } else {
+        output.printError(`Unexpected error: ${String(error)}`);
+      }
+      return { success: false, exitCode: 1 };
+    }
+  }
+};
+
+// Template subcommand
+const templateCommand: Command = {
+  name: 'template',
+  description: 'Manage workflow templates',
+  subcommands: [
+    {
+      name: 'list',
+      description: 'List available templates',
+      action: async (ctx: CommandContext): Promise<CommandResult> => {
+        if (ctx.flags.format === 'json') {
+          output.printJson(WORKFLOW_TEMPLATES);
+          return { success: true, data: WORKFLOW_TEMPLATES };
+        }
+
+        output.writeln();
+        output.writeln(output.bold('Available Workflow Templates'));
+        output.writeln();
+
+        output.printTable({
+          columns: [
+            { key: 'value', header: 'Template', width: 20 },
+            { key: 'label', header: 'Name', width: 20 },
+            { key: 'hint', header: 'Description', width: 35 }
+          ],
+          data: WORKFLOW_TEMPLATES
+        });
+
+        return { success: true, data: WORKFLOW_TEMPLATES };
+      }
+    },
+    {
+      name: 'show',
+      description: 'Show template details',
+      action: async (ctx: CommandContext): Promise<CommandResult> => {
+        const templateName = ctx.args[0];
+
+        if (!templateName) {
+          output.printError('Template name is required');
+          return { success: false, exitCode: 1 };
+        }
+
+        const template = WORKFLOW_TEMPLATES.find(t => t.value === templateName);
+        if (!template) {
+          output.printError(`Template "${templateName}" not found`);
+          return { success: false, exitCode: 1 };
+        }
+
+        // Show template details
+        const details = {
+          name: template.value,
+          description: template.hint,
+          stages: getTemplateStages(template.value),
+          agents: getTemplateAgents(template.value),
+          estimatedDuration: getTemplateDuration(template.value)
+        };
+
+        if (ctx.flags.format === 'json') {
+          output.printJson(details);
+          return { success: true, data: details };
+        }
+
+        output.writeln();
+        output.printBox(
+          [
+            `Name: ${details.name}`,
+            `Description: ${details.description}`,
+            `Stages: ${details.stages.length}`,
+            `Agents: ${details.agents.join(', ')}`,
+            `Est. Duration: ${details.estimatedDuration}`
+          ].join('\n'),
+          'Template Details'
+        );
+
+        output.writeln();
+        output.writeln(output.bold('Stages'));
+        output.printList(details.stages.map((s, i) => `${i + 1}. ${s}`));
+
+        return { success: true, data: details };
+      }
+    },
+    {
+      name: 'create',
+      description: 'Create a new template from workflow',
+      options: [
+        { name: 'name', short: 'n', description: 'Template name', type: 'string', required: true },
+        { name: 'workflow', short: 'w', description: 'Workflow ID to save as template', type: 'string' },
+        { name: 'file', short: 'f', description: 'Workflow file to save as template', type: 'string' }
+      ],
+      action: async (ctx: CommandContext): Promise<CommandResult> => {
+        const name = ctx.flags.name as string;
+
+        if (!name) {
+          output.printError('Template name is required');
+          return { success: false, exitCode: 1 };
+        }
+
+        output.printSuccess(`Template "${name}" created`);
+        output.writeln(output.dim('  Use with: claude-flow workflow run -t ' + name));
+
+        return { success: true, data: { name, created: true } };
+      }
+    }
+  ],
+  action: async (): Promise<CommandResult> => {
+    output.writeln();
+    output.writeln(output.bold('Template Management'));
+    output.writeln();
+    output.writeln('Usage: claude-flow workflow template <subcommand>');
+    output.writeln();
+    output.writeln('Subcommands:');
+    output.printList([
+      `${output.highlight('list')}   - List available templates`,
+      `${output.highlight('show')}   - Show template details`,
+      `${output.highlight('create')} - Create new template`
+    ]);
+
+    return { success: true };
+  }
+};
+
+// Main workflow command
+export const workflowCommand: Command = {
+  name: 'workflow',
+  description: 'Workflow execution and management',
+  subcommands: [runCommand, validateCommand, listCommand, statusCommand, stopCommand, templateCommand],
+  options: [],
+  examples: [
+    { command: 'claude-flow workflow run -t development --task "Build feature"', description: 'Run workflow' },
+    { command: 'claude-flow workflow validate -f ./workflow.yaml', description: 'Validate workflow' },
+    { command: 'claude-flow workflow list', description: 'List workflows' }
+  ],
+  action: async (): Promise<CommandResult> => {
+    output.writeln();
+    output.writeln(output.bold('Workflow Commands'));
+    output.writeln();
+    output.writeln('Usage: claude-flow workflow <subcommand> [options]');
+    output.writeln();
+    output.writeln('Subcommands:');
+    output.printList([
+      `${output.highlight('run')}       - Execute a workflow`,
+      `${output.highlight('validate')}  - Validate workflow definition`,
+      `${output.highlight('list')}      - List workflows`,
+      `${output.highlight('status')}    - Show workflow status`,
+      `${output.highlight('stop')}      - Stop running workflow`,
+      `${output.highlight('template')}  - Manage templates`
+    ]);
+    output.writeln();
+    output.writeln('Run "claude-flow workflow <subcommand> --help" for more info');
+
+    return { success: true };
+  }
+};
+
+// Helper functions
+function formatStageStatus(status: unknown): string {
+  const statusStr = String(status);
+  switch (statusStr) {
+    case 'completed':
+    case 'success':
+      return output.success(statusStr);
+    case 'running':
+    case 'in_progress':
+      return output.highlight(statusStr);
+    case 'pending':
+    case 'waiting':
+      return output.dim(statusStr);
+    case 'failed':
+    case 'error':
+      return output.error(statusStr);
+    case 'validated':
+      return output.success(statusStr);
+    default:
+      return statusStr;
+  }
+}
+
+function getTemplateStages(template: string): string[] {
+  const stages: Record<string, string[]> = {
+    development: ['Planning', 'Implementation', 'Testing', 'Review', 'Integration'],
+    research: ['Discovery', 'Analysis', 'Synthesis', 'Documentation'],
+    testing: ['Unit Tests', 'Integration Tests', 'E2E Tests', 'Performance Tests'],
+    'security-audit': ['Threat Model', 'Static Analysis', 'Dynamic Analysis', 'Report'],
+    'code-review': ['Initial Review', 'Security Check', 'Quality Analysis', 'Feedback'],
+    refactoring: ['Analysis', 'Planning', 'Refactor', 'Validation'],
+    sparc: ['Specification', 'Pseudocode', 'Architecture', 'Refinement', 'Completion']
+  };
+  return stages[template] || ['Initialize', 'Execute', 'Complete'];
+}
+
+function getTemplateAgents(template: string): string[] {
+  const agents: Record<string, string[]> = {
+    development: ['coder', 'tester', 'reviewer'],
+    research: ['researcher', 'analyst'],
+    testing: ['tester', 'coder'],
+    'security-audit': ['security-architect', 'security-auditor'],
+    'code-review': ['reviewer', 'security-auditor', 'analyst'],
+    refactoring: ['architect', 'coder', 'reviewer'],
+    sparc: ['architect', 'coder', 'tester', 'reviewer']
+  };
+  return agents[template] || ['coder'];
+}
+
+function getTemplateDuration(template: string): string {
+  const durations: Record<string, string> = {
+    development: '15-30 min',
+    research: '10-20 min',
+    testing: '5-15 min',
+    'security-audit': '20-40 min',
+    'code-review': '10-25 min',
+    refactoring: '15-35 min',
+    sparc: '25-45 min'
+  };
+  return durations[template] || '10-20 min';
+}
+
+export default workflowCommand;