claude-code-workflow 6.3.36 → 6.3.37

package/ccw/dist/types/loop.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Loop System Type Definitions
+ * CCW Loop System - JSON-based state management for multi-CLI orchestration
+ * Reference: .workflow/.scratchpad/loop-system-complete-design-20260121.md
+ */
+/**
+ * Loop status enumeration
+ */
+export declare enum LoopStatus {
+    CREATED = "created",
+    RUNNING = "running",
+    PAUSED = "paused",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * CLI step configuration
+ * Defines a single step in the CLI execution sequence
+ */
+export interface CliStepConfig {
+    /** Step unique identifier */
+    step_id: string;
+    /** CLI tool name */
+    tool: 'bash' | 'gemini' | 'codex' | 'qwen' | string;
+    /** Execution mode (for gemini/codex/claude) */
+    mode?: 'analysis' | 'write' | 'review';
+    /** Bash command (when tool='bash') */
+    command?: string;
+    /** Prompt template with variable replacement support */
+    prompt_template?: string;
+    /** Step failure behavior */
+    on_error?: 'continue' | 'pause' | 'fail_fast';
+    /** Custom parameters */
+    custom_args?: Record<string, unknown>;
+}
+/**
+ * Error policy configuration
+ */
+export interface ErrorPolicy {
+    /** Failure behavior */
+    on_failure: 'pause' | 'retry' | 'fail_fast';
+    /** Retry count */
+    retry_count: number;
+    /** Maximum retries (optional) */
+    max_retries?: number;
+}
+/**
+ * Loop state - complete definition
+ * Single source of truth stored in loop-state.json
+ */
+export interface LoopState {
+    /** Loop unique identifier */
+    loop_id: string;
+    /** Associated task ID */
+    task_id: string;
+    /** Current status */
+    status: LoopStatus;
+    /** Current iteration (1-indexed) */
+    current_iteration: number;
+    /** Maximum iterations */
+    max_iterations: number;
+    /** Current CLI step index (0-indexed) */
+    current_cli_step: number;
+    /** CLI execution sequence */
+    cli_sequence: CliStepConfig[];
+    /**
+     * Session mapping table
+     * Key format: {tool}_{step_index}
+     * Value: conversation_id or execution_id
+     */
+    session_mapping: Record<string, string>;
+    /**
+     * State variables
+     * Key format: {step_id}_{stdout|stderr}
+     * Value: corresponding output content
+     */
+    state_variables: Record<string, string>;
+    /** Success condition expression (JavaScript) */
+    success_condition?: string;
+    /** Error policy */
+    error_policy: ErrorPolicy;
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+    /** Completion timestamp (if applicable) */
+    completed_at?: string;
+    /** Failure reason (if applicable) */
+    failure_reason?: string;
+    /** Execution history (optional) */
+    execution_history?: ExecutionRecord[];
+}
+/**
+ * Execution record for history tracking
+ */
+export interface ExecutionRecord {
+    iteration: number;
+    step_index: number;
+    step_id: string;
+    tool: string;
+    conversation_id: string;
+    exit_code: number;
+    duration_ms: number;
+    timestamp: string;
+}
+/**
+ * Skill State - Extension fields managed by ccw-loop skill
+ * Stored in .workflow/.loop/{loopId}.json alongside API fields
+ */
+export interface SkillState {
+    /** Current action being executed */
+    current_action: 'init' | 'develop' | 'debug' | 'validate' | 'complete' | null;
+    /** Last completed action */
+    last_action: string | null;
+    /** List of completed action names */
+    completed_actions: string[];
+    /** Execution mode */
+    mode: 'interactive' | 'auto';
+    /** Development phase state */
+    develop: {
+        total: number;
+        completed: number;
+        current_task?: string;
+        tasks: DevelopTask[];
+        last_progress_at: string | null;
+    };
+    /** Debug phase state */
+    debug: {
+        active_bug?: string;
+        hypotheses_count: number;
+        hypotheses: Hypothesis[];
+        confirmed_hypothesis: string | null;
+        iteration: number;
+        last_analysis_at: string | null;
+    };
+    /** Validation phase state */
+    validate: {
+        pass_rate: number;
+        coverage: number;
+        test_results: TestResult[];
+        passed: boolean;
+        failed_tests: string[];
+        last_run_at: string | null;
+    };
+    /** Error tracking */
+    errors: Array<{
+        action: string;
+        message: string;
+        timestamp: string;
+    }>;
+}
+/**
+ * Development task
+ */
+export interface DevelopTask {
+    id: string;
+    description: string;
+    tool: 'gemini' | 'qwen' | 'codex' | 'bash';
+    mode: 'analysis' | 'write';
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    files_changed?: string[];
+    created_at: string;
+    completed_at?: string;
+}
+/**
+ * Debug hypothesis
+ */
+export interface Hypothesis {
+    id: string;
+    description: string;
+    testable_condition: string;
+    logging_point: string;
+    evidence_criteria: {
+        confirm: string;
+        reject: string;
+    };
+    likelihood: number;
+    status: 'pending' | 'confirmed' | 'rejected' | 'inconclusive';
+    evidence?: Record<string, unknown>;
+    verdict_reason?: string;
+}
+/**
+ * Test result
+ */
+export interface TestResult {
+    test_name: string;
+    suite: string;
+    status: 'passed' | 'failed' | 'skipped';
+    duration_ms: number;
+    error_message?: string;
+    stack_trace?: string;
+}
+/**
+ * V2 Loop Storage Format (simplified, for Dashboard API)
+ * This is the unified state structure used by both API and ccw-loop skill
+ */
+export interface V2LoopState {
+    loop_id: string;
+    title: string;
+    description: string;
+    max_iterations: number;
+    status: LoopStatus;
+    current_iteration: number;
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+    failure_reason?: string;
+    skill_state?: SkillState;
+}
+/**
+ * Task Loop control configuration
+ * Extension to Task JSON schema
+ */
+export interface TaskLoopControl {
+    /** Enable loop */
+    enabled: boolean;
+    /** Loop description */
+    description: string;
+    /** Maximum iterations */
+    max_iterations: number;
+    /** Success condition (JavaScript expression) */
+    success_condition: string;
+    /** Error policy */
+    error_policy: {
+        on_failure: 'pause' | 'retry' | 'fail_fast';
+        max_retries?: number;
+    };
+    /** CLI execution sequence */
+    cli_sequence: CliStepConfig[];
+}
+/**
+ * Minimal Task interface for loop operations
+ * Compatible with task JSON schema
+ */
+export interface Task {
+    /** Task ID */
+    id: string;
+    /** Task title */
+    title?: string;
+    /** Task description */
+    description?: string;
+    /** Task status */
+    status?: string;
+    /** Task metadata */
+    meta?: {
+        type?: string;
+        created_by?: string;
+    };
+    /** Task context */
+    context?: {
+        requirements?: string[];
+        acceptance?: string[];
+    };
+    /** Loop control configuration */
+    loop_control?: TaskLoopControl;
+}
+//# sourceMappingURL=loop.d.ts.map

package/ccw/dist/types/loop.d.ts.map

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

package/ccw/dist/types/loop.js

@@ -0,0 +1,17 @@
+/**
+ * Loop System Type Definitions
+ * CCW Loop System - JSON-based state management for multi-CLI orchestration
+ * Reference: .workflow/.scratchpad/loop-system-complete-design-20260121.md
+ */
+/**
+ * Loop status enumeration
+ */
+export var LoopStatus;
+(function (LoopStatus) {
+    LoopStatus["CREATED"] = "created";
+    LoopStatus["RUNNING"] = "running";
+    LoopStatus["PAUSED"] = "paused";
+    LoopStatus["COMPLETED"] = "completed";
+    LoopStatus["FAILED"] = "failed";
+})(LoopStatus || (LoopStatus = {}));
+//# sourceMappingURL=loop.js.map

package/ccw/dist/types/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/types/loop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;AACnB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB"}

package/ccw/src/cli.ts

@@ -14,6 +14,7 @@ import { coreMemoryCommand } from './commands/core-memory.js';
 import { hookCommand } from './commands/hook.js';
 import { issueCommand } from './commands/issue.js';
 import { workflowCommand } from './commands/workflow.js';
+import { loopCommand } from './commands/loop.js';
 import { readFileSync, existsSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -172,7 +173,7 @@ export function run(argv: string[]): void {
     .description('Unified CLI tool executor (gemini/qwen/codex/claude)')
     .option('-p, --prompt <prompt>', 'Prompt text (alternative to positional argument)')
     .option('-f, --file <file>', 'Read prompt from file (best for multi-line prompts)')
-    .option('--tool <tool>', 'CLI tool to use', 'gemini')
+    .option('--tool <tool>', 'CLI tool to use (reads from cli-settings.json defaultTool if not specified)')
     .option('--mode <mode>', 'Execution mode: analysis, write, auto', 'analysis')
     .option('-d, --debug', 'Enable debug logging for troubleshooting')
     .option('--model <model>', 'Model override')
@@ -301,6 +302,13 @@ export function run(argv: string[]): void {
     .option('--queue <queue-id>', 'Target queue ID for multi-queue operations')
     .action((subcommand, args, options) => issueCommand(subcommand, args, options));
 
+  // Loop command - Loop management for multi-CLI orchestration
+  program
+    .command('loop [subcommand] [args...]')
+    .description('Loop management for automated multi-CLI execution')
+    .option('--session <name>', 'Specify workflow session')
+    .action((subcommand, args, options) => loopCommand(subcommand, args, options));
+
   // Workflow command - Workflow installation and management
   program
     .command('workflow [subcommand] [args...]')

package/ccw/src/commands/cli.ts

@@ -30,6 +30,7 @@ import {
 } from '../tools/storage-manager.js';
 import { getHistoryStore } from '../tools/cli-history-store.js';
 import { createSpinner } from '../utils/ui.js';
+import { loadClaudeCliSettings } from '../tools/claude-cli-tools.js';
 
 // Dashboard notification settings
 const DASHBOARD_PORT = process.env.CCW_PORT || 3456;
@@ -548,7 +549,19 @@ async function statusAction(debug?: boolean): Promise<void> {
  * @param {Object} options - CLI options
  */
 async function execAction(positionalPrompt: string | undefined, options: CliExecOptions): Promise<void> {
-  const { prompt: optionPrompt, file, tool = 'gemini', mode = 'analysis', model, cd, includeDirs, stream, resume, id, noNative, cache, injectMode, debug, uncommitted, base, commit, title, rule } = options;
+  const { prompt: optionPrompt, file, tool: userTool, mode = 'analysis', model, cd, includeDirs, stream, resume, id, noNative, cache, injectMode, debug, uncommitted, base, commit, title, rule } = options;
+
+  // Determine the tool to use: explicit --tool option, or defaultTool from config
+  let tool = userTool;
+  if (!tool) {
+    try {
+      const settings = loadClaudeCliSettings(cd || process.cwd());
+      tool = settings.defaultTool || 'gemini';
+    } catch {
+      // Fallback to gemini if config cannot be loaded
+      tool = 'gemini';
+    }
+  }
 
   // Enable debug mode if --debug flag is set
   if (debug) {

package/ccw/src/commands/loop.ts

@@ -0,0 +1,344 @@
+/**
+ * Loop Command
+ * CCW Loop System - CLI interface for loop management
+ * Reference: .workflow/.scratchpad/loop-system-complete-design-20260121.md section 4.3
+ */
+
+import chalk from 'chalk';
+import { readFile } from 'fs/promises';
+import { join, resolve } from 'path';
+import { existsSync } from 'fs';
+import { LoopManager } from '../tools/loop-manager.js';
+import type { TaskLoopControl } from '../types/loop.js';
+
+// Minimal Task interface for task config files
+interface Task {
+  id: string;
+  title?: string;
+  loop_control?: TaskLoopControl;
+}
+
+/**
+ * Read task configuration
+ */
+async function readTaskConfig(taskId: string, workflowDir: string): Promise<Task> {
+  const taskFile = join(workflowDir, '.task', `${taskId}.json`);
+
+  if (!existsSync(taskFile)) {
+    throw new Error(`Task file not found: ${taskFile}`);
+  }
+
+  const content = await readFile(taskFile, 'utf-8');
+  return JSON.parse(content) as Task;
+}
+
+/**
+ * Find active workflow session
+ */
+function findActiveSession(cwd: string): string | null {
+  const workflowDir = join(cwd, '.workflow', 'active');
+
+  if (!existsSync(workflowDir)) {
+    return null;
+  }
+
+  const { readdirSync } = require('fs');
+  const sessions = readdirSync(workflowDir).filter((d: string) => d.startsWith('WFS-'));
+
+  if (sessions.length === 0) {
+    return null;
+  }
+
+  if (sessions.length === 1) {
+    return join(cwd, '.workflow', 'active', sessions[0]);
+  }
+
+  // Multiple sessions, require user to specify
+  console.error(chalk.red('\n  Error: Multiple active sessions found:'));
+  sessions.forEach((s: string) => console.error(chalk.gray(`    - ${s}`)));
+  console.error(chalk.yellow('\n  Please specify session with --session <name>\n'));
+  return null;
+}
+
+/**
+ * Get status badge with color
+ */
+function getStatusBadge(status: string): string {
+  switch (status) {
+    case 'created':
+      return chalk.gray('○ created');
+    case 'running':
+      return chalk.cyan('● running');
+    case 'paused':
+      return chalk.yellow('⏸ paused');
+    case 'completed':
+      return chalk.green('✓ completed');
+    case 'failed':
+      return chalk.red('✗ failed');
+    default:
+      return status;
+  }
+}
+
+/**
+ * Format time ago
+ */
+function timeAgo(timestamp: string): string {
+  const now = Date.now();
+  const then = new Date(timestamp).getTime();
+  const diff = Math.floor((now - then) / 1000);
+
+  if (diff < 60) return `${diff}s ago`;
+  if (diff < 3600) return `${Math.floor(diff / 60)}m ago`;
+  if (diff < 86400) return `${Math.floor(diff / 3600)}h ago`;
+  return `${Math.floor(diff / 86400)}d ago`;
+}
+
+/**
+ * Start action
+ */
+async function startAction(taskId: string, options: { session?: string }): Promise<void> {
+  const currentCwd = process.cwd();
+
+  // Find workflow session
+  let sessionDir: string | null;
+
+  if (options.session) {
+    sessionDir = join(currentCwd, '.workflow', 'active', options.session);
+    if (!existsSync(sessionDir)) {
+      console.error(chalk.red(`\n  Error: Session not found: ${options.session}\n`));
+      process.exit(1);
+    }
+  } else {
+    sessionDir = findActiveSession(currentCwd);
+    if (!sessionDir) {
+      console.error(chalk.red('\n  Error: No active workflow session found.'));
+      console.error(chalk.gray('  Run "ccw workflow:plan" first to create a session.\n'));
+      process.exit(1);
+    }
+  }
+
+  console.log(chalk.cyan(`  Using session: ${sessionDir.split(/[\\/]/).pop()}`));
+
+  // Read task config
+  const task = await readTaskConfig(taskId, sessionDir);
+
+  if (!task.loop_control?.enabled) {
+    console.error(chalk.red(`\n  Error: Task ${taskId} does not have loop enabled.\n`));
+    process.exit(1);
+  }
+
+  // Start loop
+  const loopManager = new LoopManager(sessionDir);
+  const loopId = await loopManager.startLoop(task as any); // Task interface compatible
+
+  console.log(chalk.green(`\n  ✓ Loop started: ${loopId}`));
+  console.log(chalk.dim(`  Status:  ccw loop status ${loopId}`));
+  console.log(chalk.dim(`  Pause:   ccw loop pause ${loopId}`));
+  console.log(chalk.dim(`  Stop:    ccw loop stop ${loopId}\n`));
+}
+
+/**
+ * Status action
+ */
+async function statusAction(loopId: string | undefined, options: { session?: string }): Promise<void> {
+  const currentCwd = process.cwd();
+  const sessionDir = options?.session
+    ? join(currentCwd, '.workflow', 'active', options.session)
+    : findActiveSession(currentCwd);
+
+  if (!sessionDir) {
+    console.error(chalk.red('\n  Error: No active session found.\n'));
+    process.exit(1);
+  }
+
+  const loopManager = new LoopManager(sessionDir);
+
+  if (loopId) {
+    // Show single loop detail
+    const state = await loopManager.getStatus(loopId);
+
+    console.log(chalk.bold.cyan('\n  Loop Status\n'));
+    console.log(`  ${chalk.gray('ID:')}         ${state.loop_id}`);
+    console.log(`  ${chalk.gray('Task:')}       ${state.task_id}`);
+    console.log(`  ${chalk.gray('Status:')}     ${getStatusBadge(state.status)}`);
+    console.log(`  ${chalk.gray('Iteration:')}  ${state.current_iteration}/${state.max_iterations}`);
+    console.log(`  ${chalk.gray('Step:')}       ${state.current_cli_step + 1}/${state.cli_sequence.length}`);
+    console.log(`  ${chalk.gray('Created:')}    ${state.created_at}`);
+    console.log(`  ${chalk.gray('Updated:')}    ${state.updated_at}`);
+
+    if (state.failure_reason) {
+      console.log(`  ${chalk.gray('Reason:')}     ${chalk.red(state.failure_reason)}`);
+    }
+
+    console.log(chalk.bold.cyan('\n  CLI Sequence\n'));
+    state.cli_sequence.forEach((step, i) => {
+      const current = i === state.current_cli_step ? chalk.cyan('→') : ' ';
+      console.log(`  ${current} ${i + 1}. ${chalk.bold(step.step_id)} (${step.tool})`);
+    });
+
+    if (state.execution_history && state.execution_history.length > 0) {
+      console.log(chalk.bold.cyan('\n  Recent Executions\n'));
+      const recent = state.execution_history.slice(-5);
+      recent.forEach(exec => {
+        const status = exec.exit_code === 0 ? chalk.green('✓') : chalk.red('✗');
+        console.log(`  ${status} ${exec.step_id} (${exec.tool}) - ${(exec.duration_ms / 1000).toFixed(1)}s`);
+      });
+    }
+
+    console.log();
+  } else {
+    // List all loops
+    const loops = await loopManager.listLoops();
+
+    if (loops.length === 0) {
+      console.log(chalk.yellow('\n  No loops found.\n'));
+      return;
+    }
+
+    console.log(chalk.bold.cyan('\n  Active Loops\n'));
+    console.log(chalk.gray('  Status  ID                                Iteration  Task'));
+    console.log(chalk.gray('  ' + '─'.repeat(70)));
+
+    loops.forEach(loop => {
+      const status = getStatusBadge(loop.status);
+      const iteration = `${loop.current_iteration}/${loop.max_iterations}`;
+      console.log(`  ${status}  ${chalk.dim(loop.loop_id.padEnd(35))}  ${iteration.padEnd(9)}  ${loop.task_id}`);
+    });
+
+    console.log();
+  }
+}
+
+/**
+ * Pause action
+ */
+async function pauseAction(loopId: string, options: { session?: string }): Promise<void> {
+  const currentCwd = process.cwd();
+  const sessionDir = options.session
+    ? join(currentCwd, '.workflow', 'active', options.session)
+    : findActiveSession(currentCwd);
+
+  if (!sessionDir) {
+    console.error(chalk.red('\n  Error: No active session found.\n'));
+    process.exit(1);
+  }
+
+  const loopManager = new LoopManager(sessionDir);
+  await loopManager.pauseLoop(loopId);
+}
+
+/**
+ * Resume action
+ */
+async function resumeAction(loopId: string, options: { session?: string }): Promise<void> {
+  const currentCwd = process.cwd();
+  const sessionDir = options.session
+    ? join(currentCwd, '.workflow', 'active', options.session)
+    : findActiveSession(currentCwd);
+
+  if (!sessionDir) {
+    console.error(chalk.red('\n  Error: No active session found.\n'));
+    process.exit(1);
+  }
+
+  const loopManager = new LoopManager(sessionDir);
+  await loopManager.resumeLoop(loopId);
+}
+
+/**
+ * Stop action
+ */
+async function stopAction(loopId: string, options: { session?: string }): Promise<void> {
+  const currentCwd = process.cwd();
+  const sessionDir = options.session
+    ? join(currentCwd, '.workflow', 'active', options.session)
+    : findActiveSession(currentCwd);
+
+  if (!sessionDir) {
+    console.error(chalk.red('\n  Error: No active session found.\n'));
+    process.exit(1);
+  }
+
+  const loopManager = new LoopManager(sessionDir);
+  await loopManager.stopLoop(loopId);
+}
+
+/**
+ * Loop command entry point
+ */
+export async function loopCommand(
+  subcommand: string,
+  args: string | string[],
+  options: any
+): Promise<void> {
+  const argsArray = Array.isArray(args) ? args : (args ? [args] : []);
+
+  try {
+    switch (subcommand) {
+      case 'start':
+        if (!argsArray[0]) {
+          console.error(chalk.red('\n  Error: Task ID is required\n'));
+          console.error(chalk.gray('  Usage: ccw loop start <task-id> [--session <name>]\n'));
+          process.exit(1);
+        }
+        await startAction(argsArray[0], options);
+        break;
+
+      case 'status':
+        await statusAction(argsArray[0], options);
+        break;
+
+      case 'pause':
+        if (!argsArray[0]) {
+          console.error(chalk.red('\n  Error: Loop ID is required\n'));
+          console.error(chalk.gray('  Usage: ccw loop pause <loop-id>\n'));
+          process.exit(1);
+        }
+        await pauseAction(argsArray[0], options);
+        break;
+
+      case 'resume':
+        if (!argsArray[0]) {
+          console.error(chalk.red('\n  Error: Loop ID is required\n'));
+          console.error(chalk.gray('  Usage: ccw loop resume <loop-id>\n'));
+          process.exit(1);
+        }
+        await resumeAction(argsArray[0], options);
+        break;
+
+      case 'stop':
+        if (!argsArray[0]) {
+          console.error(chalk.red('\n  Error: Loop ID is required\n'));
+          console.error(chalk.gray('  Usage: ccw loop stop <loop-id>\n'));
+          process.exit(1);
+        }
+        await stopAction(argsArray[0], options);
+        break;
+
+      default:
+        // Show help
+        console.log(chalk.bold.cyan('\n  CCW Loop System\n'));
+        console.log('  Manage automated CLI execution loops\n');
+        console.log('  Subcommands:');
+        console.log(chalk.gray('    start <task-id>    Start a new loop from task configuration'));
+        console.log(chalk.gray('    status [loop-id]   Show loop status (all or specific)'));
+        console.log(chalk.gray('    pause <loop-id>    Pause a running loop'));
+        console.log(chalk.gray('    resume <loop-id>   Resume a paused loop'));
+        console.log(chalk.gray('    stop <loop-id>     Stop a loop'));
+        console.log();
+        console.log('  Options:');
+        console.log(chalk.gray('    --session <name>   Specify workflow session'));
+        console.log();
+        console.log('  Examples:');
+        console.log(chalk.gray('    ccw loop start IMPL-3'));
+        console.log(chalk.gray('    ccw loop status'));
+        console.log(chalk.gray('    ccw loop status loop-IMPL-3-20260121120000'));
+        console.log(chalk.gray('    ccw loop pause loop-IMPL-3-20260121120000'));
+        console.log();
+    }
+  } catch (error) {
+    console.error(chalk.red(`\n  ✗ Error: ${error instanceof Error ? error.message : error}\n`));
+    process.exit(1);
+  }
+}