claude-flow-novice 2.15.11 → 2.16.1

package/dist/cli/coordination/wait-for-threshold.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+/**
+ * Wait for Threshold Completion - Parallel Agent Coordination
+ *
+ * Waits for N/M agents to complete (e.g., 3/4 = 75% threshold) before continuing.
+ * Enables parallel agent spawning with graceful degradation on partial completion.
+ *
+ * Usage:
+ *   npx tsx src/cli/coordination/wait-for-threshold.ts \
+ *     --task-id <id> \
+ *     --total-agents <n> \
+ *     --threshold <0.0-1.0> \
+ *     --timeout <seconds>
+ *
+ * Example:
+ *   # Wait for 3/4 agents (75%) with 120s timeout
+ *   npx tsx src/cli/coordination/wait-for-threshold.ts \
+ *     --task-id cfn-cli-12345 \
+ *     --total-agents 4 \
+ *     --threshold 0.75 \
+ *     --timeout 120
+ */ import { createClient } from 'redis';
+/**
+ * Wait for threshold completion of agents
+ *
+ * Uses Redis BLPOP with short timeouts to poll for completion signals
+ * while tracking progress toward the threshold.
+ */ export async function waitForThreshold(config) {
+    const { taskId, totalAgents, threshold, timeoutSeconds, redisHost = process.env.CFN_REDIS_HOST || 'localhost', redisPort = parseInt(process.env.CFN_REDIS_PORT || '6379', 10), redisPassword = process.env.CFN_REDIS_PASSWORD || undefined } = config;
+    const requiredCount = Math.ceil(totalAgents * threshold);
+    const signalKey = `cfn-completion:${taskId}`;
+    const completed = [];
+    const startTime = Date.now();
+    const timeoutMs = timeoutSeconds * 1000;
+    // Connect to Redis
+    const client = createClient({
+        socket: {
+            host: redisHost,
+            port: redisPort
+        },
+        password: redisPassword || undefined
+    });
+    try {
+        await client.connect();
+        console.log(`[wait-threshold] Connected to Redis at ${redisHost}:${redisPort}`);
+        console.log(`[wait-threshold] Waiting for ${requiredCount}/${totalAgents} agents (${(threshold * 100).toFixed(0)}% threshold)`);
+        console.log(`[wait-threshold] Signal key: ${signalKey}`);
+        console.log(`[wait-threshold] Timeout: ${timeoutSeconds}s`);
+        // Poll loop with short BLPOP timeouts
+        const pollIntervalSeconds = 5; // Check every 5 seconds
+        while(completed.length < requiredCount){
+            const elapsed = Date.now() - startTime;
+            // Check overall timeout
+            if (elapsed >= timeoutMs) {
+                console.log(`[wait-threshold] Timeout reached after ${(elapsed / 1000).toFixed(1)}s`);
+                break;
+            }
+            // Calculate remaining time for this poll
+            const remainingMs = timeoutMs - elapsed;
+            const pollTimeout = Math.min(pollIntervalSeconds, Math.ceil(remainingMs / 1000));
+            try {
+                // BLPOP with short timeout - returns null on timeout
+                const result = await client.blPop(signalKey, pollTimeout);
+                if (result) {
+                    try {
+                        const signal = JSON.parse(result.element);
+                        completed.push(signal);
+                        console.log(`[wait-threshold] Received signal ${completed.length}/${requiredCount}: ${signal.agentId} (${signal.status})`);
+                        // Check if threshold met
+                        if (completed.length >= requiredCount) {
+                            console.log(`[wait-threshold] Threshold met! ${completed.length}/${totalAgents} agents completed`);
+                            break;
+                        }
+                    } catch (parseErr) {
+                        console.warn(`[wait-threshold] Failed to parse signal: ${result.element}`);
+                    }
+                } else {
+                    // Timeout on BLPOP - no signal received, continue polling
+                    const elapsedSec = ((Date.now() - startTime) / 1000).toFixed(1);
+                    console.log(`[wait-threshold] Polling... ${completed.length}/${requiredCount} completed (${elapsedSec}s elapsed)`);
+                }
+            } catch (blpopErr) {
+                // Redis error during BLPOP
+                console.error(`[wait-threshold] BLPOP error:`, blpopErr);
+                break;
+            }
+        }
+        const elapsedMs = Date.now() - startTime;
+        const thresholdMet = completed.length >= requiredCount;
+        return {
+            success: thresholdMet,
+            completed,
+            timedOut: !thresholdMet && Date.now() - startTime >= timeoutMs,
+            thresholdMet,
+            completedCount: completed.length,
+            requiredCount,
+            totalAgents,
+            elapsedMs
+        };
+    } finally{
+        await client.disconnect();
+    }
+}
+/**
+ * Parse CLI arguments
+ */ function parseArgs(args) {
+    const config = {
+        threshold: 0.75,
+        timeoutSeconds: 120
+    };
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        const value = args[i + 1];
+        switch(arg){
+            case '--task-id':
+            case '-t':
+                config.taskId = value;
+                i++;
+                break;
+            case '--total-agents':
+            case '-n':
+                config.totalAgents = parseInt(value, 10);
+                i++;
+                break;
+            case '--threshold':
+                config.threshold = parseFloat(value);
+                i++;
+                break;
+            case '--timeout':
+                config.timeoutSeconds = parseInt(value, 10);
+                i++;
+                break;
+            case '--redis-host':
+                config.redisHost = value;
+                i++;
+                break;
+            case '--redis-port':
+                config.redisPort = parseInt(value, 10);
+                i++;
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+        }
+    }
+    // Validate required fields
+    if (!config.taskId) {
+        console.error('Error: --task-id is required');
+        return null;
+    }
+    if (!config.totalAgents || config.totalAgents < 1) {
+        console.error('Error: --total-agents must be a positive integer');
+        return null;
+    }
+    if (config.threshold < 0 || config.threshold > 1) {
+        console.error('Error: --threshold must be between 0.0 and 1.0');
+        return null;
+    }
+    return config;
+}
+function printHelp() {
+    console.log(`
+Wait for Threshold Completion - Parallel Agent Coordination
+
+USAGE:
+  npx tsx src/cli/coordination/wait-for-threshold.ts [OPTIONS]
+
+OPTIONS:
+  -t, --task-id <id>        Task ID for coordination (required)
+  -n, --total-agents <n>    Total number of agents spawned (required)
+      --threshold <0.0-1.0> Completion threshold (default: 0.75 = 75%)
+      --timeout <seconds>   Overall timeout (default: 120)
+      --redis-host <host>   Redis host (default: localhost)
+      --redis-port <port>   Redis port (default: 6379)
+  -h, --help                Show this help message
+
+EXAMPLES:
+  # Wait for 3/4 agents (75%) with 120s timeout
+  npx tsx src/cli/coordination/wait-for-threshold.ts \\
+    --task-id cfn-cli-12345 \\
+    --total-agents 4 \\
+    --threshold 0.75 \\
+    --timeout 120
+
+  # Wait for all agents (100%) with 300s timeout
+  npx tsx src/cli/coordination/wait-for-threshold.ts \\
+    --task-id cfn-cli-12345 \\
+    --total-agents 4 \\
+    --threshold 1.0 \\
+    --timeout 300
+
+OUTPUT:
+  JSON result with completion status:
+  {
+    "success": true,
+    "thresholdMet": true,
+    "completedCount": 3,
+    "requiredCount": 3,
+    "totalAgents": 4,
+    "elapsedMs": 45000,
+    "completed": [...]
+  }
+`);
+}
+/**
+ * CLI entry point
+ */ async function main() {
+    const config = parseArgs(process.argv.slice(2));
+    if (!config) {
+        console.error('Use --help for usage information');
+        process.exit(1);
+    }
+    try {
+        const result = await waitForThreshold(config);
+        // Output result as JSON for scripting
+        console.log('\n[wait-threshold] Result:');
+        console.log(JSON.stringify(result, null, 2));
+        // Exit with appropriate code
+        process.exit(result.success ? 0 : 1);
+    } catch (error) {
+        console.error('[wait-threshold] Fatal error:', error);
+        process.exit(2);
+    }
+}
+// Run if called directly
+if (import.meta.url.endsWith(process.argv[1]?.replace(/\\/g, '/') || '')) {
+    main();
+}
+export { parseArgs };
+
+//# sourceMappingURL=wait-for-threshold.js.map

package/dist/cli/coordination/wait-for-threshold.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/coordination/wait-for-threshold.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * Wait for Threshold Completion - Parallel Agent Coordination\r\n *\r\n * Waits for N/M agents to complete (e.g., 3/4 = 75% threshold) before continuing.\r\n * Enables parallel agent spawning with graceful degradation on partial completion.\r\n *\r\n * Usage:\r\n *   npx tsx src/cli/coordination/wait-for-threshold.ts \\\r\n *     --task-id <id> \\\r\n *     --total-agents <n> \\\r\n *     --threshold <0.0-1.0> \\\r\n *     --timeout <seconds>\r\n *\r\n * Example:\r\n *   # Wait for 3/4 agents (75%) with 120s timeout\r\n *   npx tsx src/cli/coordination/wait-for-threshold.ts \\\r\n *     --task-id cfn-cli-12345 \\\r\n *     --total-agents 4 \\\r\n *     --threshold 0.75 \\\r\n *     --timeout 120\r\n */\r\n\r\nimport { createClient, RedisClientType } from 'redis';\r\n\r\nexport interface ThresholdConfig {\r\n  taskId: string;\r\n  totalAgents: number;\r\n  threshold: number;  // 0.75 for 3/4\r\n  timeoutSeconds: number;\r\n  redisHost?: string;\r\n  redisPort?: number;\r\n  redisPassword?: string;\r\n}\r\n\r\nexport interface CompletionSignal {\r\n  agentId: string;\r\n  taskId: string;\r\n  status: 'completed' | 'failed' | 'timeout';\r\n  timestamp: string;\r\n  confidence?: number;\r\n  metadata?: Record<string, unknown>;\r\n}\r\n\r\nexport interface ThresholdResult {\r\n  success: boolean;\r\n  completed: CompletionSignal[];\r\n  timedOut: boolean;\r\n  thresholdMet: boolean;\r\n  completedCount: number;\r\n  requiredCount: number;\r\n  totalAgents: number;\r\n  elapsedMs: number;\r\n}\r\n\r\n/**\r\n * Wait for threshold completion of agents\r\n *\r\n * Uses Redis BLPOP with short timeouts to poll for completion signals\r\n * while tracking progress toward the threshold.\r\n */\r\nexport async function waitForThreshold(config: ThresholdConfig): Promise<ThresholdResult> {\r\n  const {\r\n    taskId,\r\n    totalAgents,\r\n    threshold,\r\n    timeoutSeconds,\r\n    redisHost = process.env.CFN_REDIS_HOST || 'localhost',\r\n    redisPort = parseInt(process.env.CFN_REDIS_PORT || '6379', 10),\r\n    redisPassword = process.env.CFN_REDIS_PASSWORD || undefined\r\n  } = config;\r\n\r\n  const requiredCount = Math.ceil(totalAgents * threshold);\r\n  const signalKey = `cfn-completion:${taskId}`;\r\n  const completed: CompletionSignal[] = [];\r\n  const startTime = Date.now();\r\n  const timeoutMs = timeoutSeconds * 1000;\r\n\r\n  // Connect to Redis\r\n  const client: RedisClientType = createClient({\r\n    socket: { host: redisHost, port: redisPort },\r\n    password: redisPassword || undefined\r\n  });\r\n\r\n  try {\r\n    await client.connect();\r\n    console.log(`[wait-threshold] Connected to Redis at ${redisHost}:${redisPort}`);\r\n    console.log(`[wait-threshold] Waiting for ${requiredCount}/${totalAgents} agents (${(threshold * 100).toFixed(0)}% threshold)`);\r\n    console.log(`[wait-threshold] Signal key: ${signalKey}`);\r\n    console.log(`[wait-threshold] Timeout: ${timeoutSeconds}s`);\r\n\r\n    // Poll loop with short BLPOP timeouts\r\n    const pollIntervalSeconds = 5; // Check every 5 seconds\r\n\r\n    while (completed.length < requiredCount) {\r\n      const elapsed = Date.now() - startTime;\r\n\r\n      // Check overall timeout\r\n      if (elapsed >= timeoutMs) {\r\n        console.log(`[wait-threshold] Timeout reached after ${(elapsed / 1000).toFixed(1)}s`);\r\n        break;\r\n      }\r\n\r\n      // Calculate remaining time for this poll\r\n      const remainingMs = timeoutMs - elapsed;\r\n      const pollTimeout = Math.min(pollIntervalSeconds, Math.ceil(remainingMs / 1000));\r\n\r\n      try {\r\n        // BLPOP with short timeout - returns null on timeout\r\n        const result = await client.blPop(signalKey, pollTimeout);\r\n\r\n        if (result) {\r\n          try {\r\n            const signal: CompletionSignal = JSON.parse(result.element);\r\n            completed.push(signal);\r\n\r\n            console.log(`[wait-threshold] Received signal ${completed.length}/${requiredCount}: ${signal.agentId} (${signal.status})`);\r\n\r\n            // Check if threshold met\r\n            if (completed.length >= requiredCount) {\r\n              console.log(`[wait-threshold] Threshold met! ${completed.length}/${totalAgents} agents completed`);\r\n              break;\r\n            }\r\n          } catch (parseErr) {\r\n            console.warn(`[wait-threshold] Failed to parse signal: ${result.element}`);\r\n          }\r\n        } else {\r\n          // Timeout on BLPOP - no signal received, continue polling\r\n          const elapsedSec = ((Date.now() - startTime) / 1000).toFixed(1);\r\n          console.log(`[wait-threshold] Polling... ${completed.length}/${requiredCount} completed (${elapsedSec}s elapsed)`);\r\n        }\r\n      } catch (blpopErr) {\r\n        // Redis error during BLPOP\r\n        console.error(`[wait-threshold] BLPOP error:`, blpopErr);\r\n        break;\r\n      }\r\n    }\r\n\r\n    const elapsedMs = Date.now() - startTime;\r\n    const thresholdMet = completed.length >= requiredCount;\r\n\r\n    return {\r\n      success: thresholdMet,\r\n      completed,\r\n      timedOut: !thresholdMet && (Date.now() - startTime) >= timeoutMs,\r\n      thresholdMet,\r\n      completedCount: completed.length,\r\n      requiredCount,\r\n      totalAgents,\r\n      elapsedMs\r\n    };\r\n\r\n  } finally {\r\n    await client.disconnect();\r\n  }\r\n}\r\n\r\n/**\r\n * Parse CLI arguments\r\n */\r\nfunction parseArgs(args: string[]): ThresholdConfig | null {\r\n  const config: Partial<ThresholdConfig> = {\r\n    threshold: 0.75,\r\n    timeoutSeconds: 120\r\n  };\r\n\r\n  for (let i = 0; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n      case '-t':\r\n        config.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--total-agents':\r\n      case '-n':\r\n        config.totalAgents = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--threshold':\r\n        config.threshold = parseFloat(value);\r\n        i++;\r\n        break;\r\n      case '--timeout':\r\n        config.timeoutSeconds = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--redis-host':\r\n        config.redisHost = value;\r\n        i++;\r\n        break;\r\n      case '--redis-port':\r\n        config.redisPort = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        printHelp();\r\n        process.exit(0);\r\n    }\r\n  }\r\n\r\n  // Validate required fields\r\n  if (!config.taskId) {\r\n    console.error('Error: --task-id is required');\r\n    return null;\r\n  }\r\n  if (!config.totalAgents || config.totalAgents < 1) {\r\n    console.error('Error: --total-agents must be a positive integer');\r\n    return null;\r\n  }\r\n  if (config.threshold! < 0 || config.threshold! > 1) {\r\n    console.error('Error: --threshold must be between 0.0 and 1.0');\r\n    return null;\r\n  }\r\n\r\n  return config as ThresholdConfig;\r\n}\r\n\r\nfunction printHelp(): void {\r\n  console.log(`\r\nWait for Threshold Completion - Parallel Agent Coordination\r\n\r\nUSAGE:\r\n  npx tsx src/cli/coordination/wait-for-threshold.ts [OPTIONS]\r\n\r\nOPTIONS:\r\n  -t, --task-id <id>        Task ID for coordination (required)\r\n  -n, --total-agents <n>    Total number of agents spawned (required)\r\n      --threshold <0.0-1.0> Completion threshold (default: 0.75 = 75%)\r\n      --timeout <seconds>   Overall timeout (default: 120)\r\n      --redis-host <host>   Redis host (default: localhost)\r\n      --redis-port <port>   Redis port (default: 6379)\r\n  -h, --help                Show this help message\r\n\r\nEXAMPLES:\r\n  # Wait for 3/4 agents (75%) with 120s timeout\r\n  npx tsx src/cli/coordination/wait-for-threshold.ts \\\\\r\n    --task-id cfn-cli-12345 \\\\\r\n    --total-agents 4 \\\\\r\n    --threshold 0.75 \\\\\r\n    --timeout 120\r\n\r\n  # Wait for all agents (100%) with 300s timeout\r\n  npx tsx src/cli/coordination/wait-for-threshold.ts \\\\\r\n    --task-id cfn-cli-12345 \\\\\r\n    --total-agents 4 \\\\\r\n    --threshold 1.0 \\\\\r\n    --timeout 300\r\n\r\nOUTPUT:\r\n  JSON result with completion status:\r\n  {\r\n    \"success\": true,\r\n    \"thresholdMet\": true,\r\n    \"completedCount\": 3,\r\n    \"requiredCount\": 3,\r\n    \"totalAgents\": 4,\r\n    \"elapsedMs\": 45000,\r\n    \"completed\": [...]\r\n  }\r\n`);\r\n}\r\n\r\n/**\r\n * CLI entry point\r\n */\r\nasync function main(): Promise<void> {\r\n  const config = parseArgs(process.argv.slice(2));\r\n\r\n  if (!config) {\r\n    console.error('Use --help for usage information');\r\n    process.exit(1);\r\n  }\r\n\r\n  try {\r\n    const result = await waitForThreshold(config);\r\n\r\n    // Output result as JSON for scripting\r\n    console.log('\\n[wait-threshold] Result:');\r\n    console.log(JSON.stringify(result, null, 2));\r\n\r\n    // Exit with appropriate code\r\n    process.exit(result.success ? 0 : 1);\r\n  } catch (error) {\r\n    console.error('[wait-threshold] Fatal error:', error);\r\n    process.exit(2);\r\n  }\r\n}\r\n\r\n// Run if called directly\r\nif (import.meta.url.endsWith(process.argv[1]?.replace(/\\\\/g, '/') || '')) {\r\n  main();\r\n}\r\n\r\nexport { parseArgs };\r\n"],"names":["createClient","waitForThreshold","config","taskId","totalAgents","threshold","timeoutSeconds","redisHost","process","env","CFN_REDIS_HOST","redisPort","parseInt","CFN_REDIS_PORT","redisPassword","CFN_REDIS_PASSWORD","undefined","requiredCount","Math","ceil","signalKey","completed","startTime","Date","now","timeoutMs","client","socket","host","port","password","connect","console","log","toFixed","pollIntervalSeconds","length","elapsed","remainingMs","pollTimeout","min","result","blPop","signal","JSON","parse","element","push","agentId","status","parseErr","warn","elapsedSec","blpopErr","error","elapsedMs","thresholdMet","success","timedOut","completedCount","disconnect","parseArgs","args","i","arg","value","parseFloat","printHelp","exit","main","argv","slice","stringify","url","endsWith","replace"],"mappings":"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"}

package/dist/cli/index.js

@@ -86,6 +86,10 @@ import { agentCommand } from './agent-command.js';
             case '--debug':
                 options.debug = true;
                 break;
+            case '--provider':
+                options.provider = value;
+                i++;
+                break;
         }
     }
     return {
@@ -112,6 +116,9 @@ Examples:
   # Spawn an agent
   npx claude-flow-novice agent coder --context "Implement feature"
 
+  # Spawn an agent with ZAI provider
+  npx claude-flow-novice agent coder --provider zai --context "Implement feature"
+
   # List available agents
   npx claude-flow-novice agent --list
 
@@ -139,6 +146,10 @@ For more information:
     const { command, agentType, options } = parseArgs(args);
     switch(command){
         case 'agent':
+            // Set provider environment variable if specified
+            if (options.provider) {
+                process.env.CLAUDE_API_PROVIDER = options.provider;
+            }
             await agentCommand(agentType, options);
             break;
         default:

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * CLI Entry Point - v2.1\r\n *\r\n * Handles agent spawning commands with memory management:\r\n *   npx claude-flow-novice agent <type> [options]\r\n */\r\n\r\n// Load environment variables from .env file\r\nimport 'dotenv/config';\r\n\r\n// Apply safe memory defaults if not configured\r\nif (!process.env.NODE_OPTIONS) {\r\n  // Set conservative 8GB limit (reduced from default 16GB)\r\n  process.env.NODE_OPTIONS = '--max-old-space-size=8192';\r\n} else if (!process.env.NODE_OPTIONS.includes('max-old-space-size')) {\r\n  // Append memory limit to existing NODE_OPTIONS\r\n  process.env.NODE_OPTIONS += ' --max-old-space-size=8192';\r\n}\r\n\r\n// Enable memory profiling in development/debug mode\r\nif (process.env.NODE_ENV === 'development' || process.env.CLAUDE_DEBUG) {\r\n  if (!process.env.NODE_OPTIONS.includes('inspect')) {\r\n    process.env.NODE_OPTIONS += ' --inspect=0.0.0.0:9229';\r\n  }\r\n  if (!process.env.NODE_OPTIONS.includes('heap-prof')) {\r\n    process.env.NODE_OPTIONS += ' --heap-prof';\r\n  }\r\n}\r\n\r\nimport { VERSION } from '../core/index.js';\r\nimport { agentCommand, AgentCommandOptions } from './agent-command.js';\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nfunction parseArgs(args: string[]): { command: string; agentType?: string; options: AgentCommandOptions } {\r\n  const command = args[0] || 'help';\r\n  const agentType = args[1] && !args[1].startsWith('--') ? args[1] : undefined;\r\n  const options: AgentCommandOptions = {};\r\n\r\n  // Parse options and capture positional context argument\r\n  for (let i = agentType ? 2 : 1; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    // Capture non-flag positional arguments as context (before any flags)\r\n    if (!arg.startsWith('--') && !options.context) {\r\n      options.context = arg;\r\n      continue;\r\n    }\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--agent-id':\r\n        options.agentId = value;\r\n        i++;\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        i++;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        i++;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        i++;\r\n        break;\r\n      case '--list':\r\n        options.list = true;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        options.help = true;\r\n        break;\r\n      case '--memory-limit':\r\n        options.memoryLimit = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--enable-profiling':\r\n        options.enableProfiling = true;\r\n        break;\r\n      case '--debug':\r\n        options.debug = true;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return { command, agentType, options };\r\n}\r\n\r\n/**\r\n * Display main CLI help\r\n */\r\nfunction displayHelp(): void {\r\n  console.log(`\r\nClaude Flow Novice CLI v${VERSION}\r\n\r\nUsage:\r\n  npx claude-flow-novice <command> [options]\r\n\r\nCommands:\r\n  agent <type> [options]    Spawn an agent for task execution\r\n  --version                 Show version number\r\n  --help                    Show this help message\r\n\r\nExamples:\r\n  # Spawn an agent\r\n  npx claude-flow-novice agent coder --context \"Implement feature\"\r\n\r\n  # List available agents\r\n  npx claude-flow-novice agent --list\r\n\r\n  # Show version\r\n  npx claude-flow-novice --version\r\n\r\nFor more information:\r\n  https://github.com/yourusername/claude-flow-novice\r\n`);\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nasync function main() {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Handle version flag\r\n  if (args.includes('--version') || args.includes('-v')) {\r\n    console.log(`Claude Flow Novice v${VERSION}`);\r\n    return;\r\n  }\r\n\r\n  // Handle help flag\r\n  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\r\n    displayHelp();\r\n    return;\r\n  }\r\n\r\n  const { command, agentType, options } = parseArgs(args);\r\n\r\n  switch (command) {\r\n    case 'agent':\r\n      await agentCommand(agentType, options);\r\n      break;\r\n\r\n    default:\r\n      console.error(`Unknown command: ${command}`);\r\n      console.log('Run with --help for usage information');\r\n      process.exit(1);\r\n  }\r\n}\r\n\r\n// Run CLI\r\nmain().catch((error) => {\r\n  console.error('[claude-flow-novice] Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"names":["process","env","NODE_OPTIONS","includes","NODE_ENV","CLAUDE_DEBUG","VERSION","agentCommand","parseArgs","args","command","agentType","startsWith","undefined","options","i","length","arg","value","context","taskId","iteration","parseInt","agentId","mode","priority","parentTaskId","list","help","memoryLimit","enableProfiling","debug","displayHelp","console","log","main","argv","slice","error","exit","catch"],"mappings":"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"}
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * CLI Entry Point - v2.1\r\n *\r\n * Handles agent spawning commands with memory management:\r\n *   npx claude-flow-novice agent <type> [options]\r\n */\r\n\r\n// Load environment variables from .env file\r\nimport 'dotenv/config';\r\n\r\n// Apply safe memory defaults if not configured\r\nif (!process.env.NODE_OPTIONS) {\r\n  // Set conservative 8GB limit (reduced from default 16GB)\r\n  process.env.NODE_OPTIONS = '--max-old-space-size=8192';\r\n} else if (!process.env.NODE_OPTIONS.includes('max-old-space-size')) {\r\n  // Append memory limit to existing NODE_OPTIONS\r\n  process.env.NODE_OPTIONS += ' --max-old-space-size=8192';\r\n}\r\n\r\n// Enable memory profiling in development/debug mode\r\nif (process.env.NODE_ENV === 'development' || process.env.CLAUDE_DEBUG) {\r\n  if (!process.env.NODE_OPTIONS.includes('inspect')) {\r\n    process.env.NODE_OPTIONS += ' --inspect=0.0.0.0:9229';\r\n  }\r\n  if (!process.env.NODE_OPTIONS.includes('heap-prof')) {\r\n    process.env.NODE_OPTIONS += ' --heap-prof';\r\n  }\r\n}\r\n\r\nimport { VERSION } from '../core/index.js';\r\nimport { agentCommand, AgentCommandOptions } from './agent-command.js';\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nfunction parseArgs(args: string[]): { command: string; agentType?: string; options: AgentCommandOptions } {\r\n  const command = args[0] || 'help';\r\n  const agentType = args[1] && !args[1].startsWith('--') ? args[1] : undefined;\r\n  const options: AgentCommandOptions = {};\r\n\r\n  // Parse options and capture positional context argument\r\n  for (let i = agentType ? 2 : 1; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    // Capture non-flag positional arguments as context (before any flags)\r\n    if (!arg.startsWith('--') && !options.context) {\r\n      options.context = arg;\r\n      continue;\r\n    }\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--agent-id':\r\n        options.agentId = value;\r\n        i++;\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        i++;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        i++;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        i++;\r\n        break;\r\n      case '--list':\r\n        options.list = true;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        options.help = true;\r\n        break;\r\n      case '--memory-limit':\r\n        options.memoryLimit = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--enable-profiling':\r\n        options.enableProfiling = true;\r\n        break;\r\n      case '--debug':\r\n        options.debug = true;\r\n        break;\r\n      case '--provider':\r\n        options.provider = value;\r\n        i++;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return { command, agentType, options };\r\n}\r\n\r\n/**\r\n * Display main CLI help\r\n */\r\nfunction displayHelp(): void {\r\n  console.log(`\r\nClaude Flow Novice CLI v${VERSION}\r\n\r\nUsage:\r\n  npx claude-flow-novice <command> [options]\r\n\r\nCommands:\r\n  agent <type> [options]    Spawn an agent for task execution\r\n  --version                 Show version number\r\n  --help                    Show this help message\r\n\r\nExamples:\r\n  # Spawn an agent\r\n  npx claude-flow-novice agent coder --context \"Implement feature\"\r\n\r\n  # Spawn an agent with ZAI provider\r\n  npx claude-flow-novice agent coder --provider zai --context \"Implement feature\"\r\n\r\n  # List available agents\r\n  npx claude-flow-novice agent --list\r\n\r\n  # Show version\r\n  npx claude-flow-novice --version\r\n\r\nFor more information:\r\n  https://github.com/yourusername/claude-flow-novice\r\n`);\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nasync function main() {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Handle version flag\r\n  if (args.includes('--version') || args.includes('-v')) {\r\n    console.log(`Claude Flow Novice v${VERSION}`);\r\n    return;\r\n  }\r\n\r\n  // Handle help flag\r\n  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\r\n    displayHelp();\r\n    return;\r\n  }\r\n\r\n  const { command, agentType, options } = parseArgs(args);\r\n\r\n  switch (command) {\r\n    case 'agent':\r\n      // Set provider environment variable if specified\r\n      if (options.provider) {\r\n        process.env.CLAUDE_API_PROVIDER = options.provider;\r\n      }\r\n      await agentCommand(agentType, options);\r\n      break;\r\n\r\n    default:\r\n      console.error(`Unknown command: ${command}`);\r\n      console.log('Run with --help for usage information');\r\n      process.exit(1);\r\n  }\r\n}\r\n\r\n// Run CLI\r\nmain().catch((error) => {\r\n  console.error('[claude-flow-novice] Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"names":["process","env","NODE_OPTIONS","includes","NODE_ENV","CLAUDE_DEBUG","VERSION","agentCommand","parseArgs","args","command","agentType","startsWith","undefined","options","i","length","arg","value","context","taskId","iteration","parseInt","agentId","mode","priority","parentTaskId","list","help","memoryLimit","enableProfiling","debug","provider","displayHelp","console","log","main","argv","slice","CLAUDE_API_PROVIDER","error","exit","catch"],"mappings":"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"}

package/dist/cli/iteration-history.js

@@ -11,7 +11,8 @@
  * Sprint 3 - Phase 2 Implementation
  */ import { execSync } from 'child_process';
 // Bug #6 Fix: Read Redis connection parameters from process.env
-const redisHost = process.env.CFN_REDIS_HOST || 'cfn-redis';
+// FIX: Default to 'localhost' for CLI mode (host execution), not 'cfn-redis' (Docker)
+const redisHost = process.env.CFN_REDIS_HOST || 'localhost';
 const redisPort = process.env.CFN_REDIS_PORT || '6379';
 /**
  * Load iteration history for an agent from Redis

package/dist/cli/iteration-history.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/iteration-history.ts"],"sourcesContent":["/**\r\n * Iteration History Management\r\n *\r\n * Loads and formats iteration history from Redis for CLI-spawned agents.\r\n * Enables agents to learn from previous attempts and feedback.\r\n *\r\n * Storage Pattern:\r\n *   swarm:${TASK_ID}:${AGENT_ID}:result:iteration-${N} → Result text + confidence\r\n *   swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${N} → Validator feedback\r\n *\r\n * Sprint 3 - Phase 2 Implementation\r\n */\r\n\r\nimport { execSync } from 'child_process';\r\n\r\n// Bug #6 Fix: Read Redis connection parameters from process.env\r\nconst redisHost = process.env.CFN_REDIS_HOST || 'cfn-redis';\r\nconst redisPort = process.env.CFN_REDIS_PORT || '6379';\r\n\r\nexport interface IterationResult {\r\n  iteration: number;\r\n  result: string;\r\n  confidence: number;\r\n  timestamp: string;\r\n  feedback?: string;\r\n}\r\n\r\n/**\r\n * Load iteration history for an agent from Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param currentIteration - Current iteration number (loads 1 to N-1)\r\n * @returns Array of iteration results\r\n */\r\nexport async function loadIterationHistory(\r\n  taskId: string,\r\n  agentId: string,\r\n  currentIteration: number\r\n): Promise<IterationResult[]> {\r\n  const history: IterationResult[] = [];\r\n\r\n  // Load previous iterations (1 to currentIteration - 1)\r\n  for (let i = 1; i < currentIteration; i++) {\r\n    try {\r\n      // Load result data\r\n      const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${i}`;\r\n      const resultJson = execSync(`redis-cli -h ${redisHost} -p ${redisPort} get \"${resultKey}\"`, { encoding: 'utf8' }).trim();\r\n\r\n      if (resultJson === '(nil)' || !resultJson) {\r\n        // No result for this iteration (shouldn't happen in normal flow)\r\n        continue;\r\n      }\r\n\r\n      const resultData = JSON.parse(resultJson);\r\n\r\n      // Load feedback data (may not exist for all iterations)\r\n      const feedbackKey = `swarm:${taskId}:${agentId}:feedback:iteration-${i}`;\r\n      let feedback: string | undefined;\r\n\r\n      try {\r\n        const feedbackJson = execSync(`redis-cli -h ${redisHost} -p ${redisPort} get \"${feedbackKey}\"`, { encoding: 'utf8' }).trim();\r\n        if (feedbackJson !== '(nil)' && feedbackJson) {\r\n          const feedbackData = JSON.parse(feedbackJson);\r\n          feedback = feedbackData.feedback || feedbackData.comments;\r\n        }\r\n      } catch (err) {\r\n        // Feedback may not exist for this iteration\r\n        feedback = undefined;\r\n      }\r\n\r\n      history.push({\r\n        iteration: i,\r\n        result: resultData.result || resultData.output || '',\r\n        confidence: resultData.confidence || 0,\r\n        timestamp: resultData.timestamp || new Date().toISOString(),\r\n        feedback\r\n      });\r\n    } catch (err) {\r\n      console.error(`[iteration-history] Failed to load iteration ${i}:`, err);\r\n      // Continue loading other iterations\r\n    }\r\n  }\r\n\r\n  return history;\r\n}\r\n\r\n/**\r\n * Store iteration result in Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param iteration - Iteration number\r\n * @param result - Result text/output\r\n * @param confidence - Confidence score (0.0-1.0)\r\n */\r\nexport async function storeIterationResult(\r\n  taskId: string,\r\n  agentId: string,\r\n  iteration: number,\r\n  result: string,\r\n  confidence: number\r\n): Promise<void> {\r\n  const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${iteration}`;\r\n  const resultData = {\r\n    result,\r\n    confidence,\r\n    timestamp: new Date().toISOString(),\r\n    iteration\r\n  };\r\n\r\n  const resultJson = JSON.stringify(resultData);\r\n\r\n  try {\r\n    // Store with 24 hour TTL\r\n    execSync(`redis-cli -h ${redisHost} -p ${redisPort} setex \"${resultKey}\" 86400 '${resultJson.replace(/'/g, \"'\\\\''\")}'`, {\r\n      encoding: 'utf8'\r\n    });\r\n    console.log(`[iteration-history] Stored result for iteration ${iteration}`);\r\n  } catch (err) {\r\n    console.error(`[iteration-history] Failed to store result:`, err);\r\n    throw err;\r\n  }\r\n}\r\n\r\n/**\r\n * Format iteration history as markdown for system prompt\r\n *\r\n * @param history - Array of iteration results\r\n * @param currentIteration - Current iteration number\r\n * @returns Formatted markdown string\r\n */\r\nexport function formatIterationHistory(\r\n  history: IterationResult[],\r\n  currentIteration: number\r\n): string {\r\n  if (history.length === 0) {\r\n    return `## Current Iteration: ${currentIteration}\r\n\r\nThis is your first attempt at this task. No previous iteration history available.\r\n`;\r\n  }\r\n\r\n  const sections: string[] = [];\r\n\r\n  sections.push('## Iteration History');\r\n  sections.push('');\r\n  sections.push('Learn from your previous attempts and feedback:');\r\n  sections.push('');\r\n\r\n  // Format each iteration\r\n  for (const iter of history) {\r\n    sections.push(`### Iteration ${iter.iteration}`);\r\n    sections.push('');\r\n\r\n    sections.push('**Result:**');\r\n    sections.push(iter.result.substring(0, 500)); // Truncate to 500 chars\r\n    if (iter.result.length > 500) {\r\n      sections.push('... (truncated)');\r\n    }\r\n    sections.push('');\r\n\r\n    if (iter.feedback) {\r\n      sections.push('**Feedback from Validators:**');\r\n      sections.push(iter.feedback);\r\n      sections.push('');\r\n    }\r\n\r\n    sections.push(`**Confidence:** ${iter.confidence.toFixed(2)}`);\r\n    sections.push(`**Timestamp:** ${iter.timestamp}`);\r\n    sections.push('');\r\n    sections.push('---');\r\n    sections.push('');\r\n  }\r\n\r\n  // Add current iteration context\r\n  sections.push(`## Current Iteration: ${currentIteration}`);\r\n  sections.push('');\r\n\r\n  if (history.length > 0) {\r\n    const lastIteration = history[history.length - 1];\r\n    if (lastIteration.feedback) {\r\n      sections.push('**Your Task:** Address the feedback from the previous iteration:');\r\n      sections.push('');\r\n      sections.push(lastIteration.feedback);\r\n      sections.push('');\r\n    } else {\r\n      sections.push(`**Your Task:** Improve upon iteration ${lastIteration.iteration} (confidence: ${lastIteration.confidence.toFixed(2)})`);\r\n      sections.push('');\r\n    }\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Check if iteration history exists for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns True if any iteration history exists\r\n */\r\nexport async function hasIterationHistory(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<boolean> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli -h ${redisHost} -p ${redisPort} --scan --pattern \"${pattern}\"`, { encoding: 'utf8' }).trim();\r\n    return keys.length > 0;\r\n  } catch (err) {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get the latest iteration number for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns Latest iteration number (0 if no history)\r\n */\r\nexport async function getLatestIteration(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<number> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli -h ${redisHost} -p ${redisPort} --scan --pattern \"${pattern}\"`, { encoding: 'utf8' })\r\n      .trim()\r\n      .split('\\n')\r\n      .filter((k) => k.length > 0);\r\n\r\n    if (keys.length === 0) return 0;\r\n\r\n    // Extract iteration numbers and find max\r\n    const iterations = keys.map((key) => {\r\n      const match = key.match(/iteration-(\\d+)$/);\r\n      return match ? parseInt(match[1], 10) : 0;\r\n    });\r\n\r\n    return Math.max(...iterations);\r\n  } catch (err) {\r\n    return 0;\r\n  }\r\n}\r\n"],"names":["execSync","redisHost","process","env","CFN_REDIS_HOST","redisPort","CFN_REDIS_PORT","loadIterationHistory","taskId","agentId","currentIteration","history","i","resultKey","resultJson","encoding","trim","resultData","JSON","parse","feedbackKey","feedback","feedbackJson","feedbackData","comments","err","undefined","push","iteration","result","output","confidence","timestamp","Date","toISOString","console","error","storeIterationResult","stringify","replace","log","formatIterationHistory","length","sections","iter","substring","toFixed","lastIteration","join","hasIterationHistory","pattern","keys","getLatestIteration","split","filter","k","iterations","map","key","match","parseInt","Math","max"],"mappings":"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"}
+{"version":3,"sources":["../../src/cli/iteration-history.ts"],"sourcesContent":["/**\r\n * Iteration History Management\r\n *\r\n * Loads and formats iteration history from Redis for CLI-spawned agents.\r\n * Enables agents to learn from previous attempts and feedback.\r\n *\r\n * Storage Pattern:\r\n *   swarm:${TASK_ID}:${AGENT_ID}:result:iteration-${N} → Result text + confidence\r\n *   swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${N} → Validator feedback\r\n *\r\n * Sprint 3 - Phase 2 Implementation\r\n */\r\n\r\nimport { execSync } from 'child_process';\r\n\r\n// Bug #6 Fix: Read Redis connection parameters from process.env\r\n// FIX: Default to 'localhost' for CLI mode (host execution), not 'cfn-redis' (Docker)\r\nconst redisHost = process.env.CFN_REDIS_HOST || 'localhost';\r\nconst redisPort = process.env.CFN_REDIS_PORT || '6379';\r\n\r\nexport interface IterationResult {\r\n  iteration: number;\r\n  result: string;\r\n  confidence: number;\r\n  timestamp: string;\r\n  feedback?: string;\r\n}\r\n\r\n/**\r\n * Load iteration history for an agent from Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param currentIteration - Current iteration number (loads 1 to N-1)\r\n * @returns Array of iteration results\r\n */\r\nexport async function loadIterationHistory(\r\n  taskId: string,\r\n  agentId: string,\r\n  currentIteration: number\r\n): Promise<IterationResult[]> {\r\n  const history: IterationResult[] = [];\r\n\r\n  // Load previous iterations (1 to currentIteration - 1)\r\n  for (let i = 1; i < currentIteration; i++) {\r\n    try {\r\n      // Load result data\r\n      const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${i}`;\r\n      const resultJson = execSync(`redis-cli -h ${redisHost} -p ${redisPort} get \"${resultKey}\"`, { encoding: 'utf8' }).trim();\r\n\r\n      if (resultJson === '(nil)' || !resultJson) {\r\n        // No result for this iteration (shouldn't happen in normal flow)\r\n        continue;\r\n      }\r\n\r\n      const resultData = JSON.parse(resultJson);\r\n\r\n      // Load feedback data (may not exist for all iterations)\r\n      const feedbackKey = `swarm:${taskId}:${agentId}:feedback:iteration-${i}`;\r\n      let feedback: string | undefined;\r\n\r\n      try {\r\n        const feedbackJson = execSync(`redis-cli -h ${redisHost} -p ${redisPort} get \"${feedbackKey}\"`, { encoding: 'utf8' }).trim();\r\n        if (feedbackJson !== '(nil)' && feedbackJson) {\r\n          const feedbackData = JSON.parse(feedbackJson);\r\n          feedback = feedbackData.feedback || feedbackData.comments;\r\n        }\r\n      } catch (err) {\r\n        // Feedback may not exist for this iteration\r\n        feedback = undefined;\r\n      }\r\n\r\n      history.push({\r\n        iteration: i,\r\n        result: resultData.result || resultData.output || '',\r\n        confidence: resultData.confidence || 0,\r\n        timestamp: resultData.timestamp || new Date().toISOString(),\r\n        feedback\r\n      });\r\n    } catch (err) {\r\n      console.error(`[iteration-history] Failed to load iteration ${i}:`, err);\r\n      // Continue loading other iterations\r\n    }\r\n  }\r\n\r\n  return history;\r\n}\r\n\r\n/**\r\n * Store iteration result in Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param iteration - Iteration number\r\n * @param result - Result text/output\r\n * @param confidence - Confidence score (0.0-1.0)\r\n */\r\nexport async function storeIterationResult(\r\n  taskId: string,\r\n  agentId: string,\r\n  iteration: number,\r\n  result: string,\r\n  confidence: number\r\n): Promise<void> {\r\n  const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${iteration}`;\r\n  const resultData = {\r\n    result,\r\n    confidence,\r\n    timestamp: new Date().toISOString(),\r\n    iteration\r\n  };\r\n\r\n  const resultJson = JSON.stringify(resultData);\r\n\r\n  try {\r\n    // Store with 24 hour TTL\r\n    execSync(`redis-cli -h ${redisHost} -p ${redisPort} setex \"${resultKey}\" 86400 '${resultJson.replace(/'/g, \"'\\\\''\")}'`, {\r\n      encoding: 'utf8'\r\n    });\r\n    console.log(`[iteration-history] Stored result for iteration ${iteration}`);\r\n  } catch (err) {\r\n    console.error(`[iteration-history] Failed to store result:`, err);\r\n    throw err;\r\n  }\r\n}\r\n\r\n/**\r\n * Format iteration history as markdown for system prompt\r\n *\r\n * @param history - Array of iteration results\r\n * @param currentIteration - Current iteration number\r\n * @returns Formatted markdown string\r\n */\r\nexport function formatIterationHistory(\r\n  history: IterationResult[],\r\n  currentIteration: number\r\n): string {\r\n  if (history.length === 0) {\r\n    return `## Current Iteration: ${currentIteration}\r\n\r\nThis is your first attempt at this task. No previous iteration history available.\r\n`;\r\n  }\r\n\r\n  const sections: string[] = [];\r\n\r\n  sections.push('## Iteration History');\r\n  sections.push('');\r\n  sections.push('Learn from your previous attempts and feedback:');\r\n  sections.push('');\r\n\r\n  // Format each iteration\r\n  for (const iter of history) {\r\n    sections.push(`### Iteration ${iter.iteration}`);\r\n    sections.push('');\r\n\r\n    sections.push('**Result:**');\r\n    sections.push(iter.result.substring(0, 500)); // Truncate to 500 chars\r\n    if (iter.result.length > 500) {\r\n      sections.push('... (truncated)');\r\n    }\r\n    sections.push('');\r\n\r\n    if (iter.feedback) {\r\n      sections.push('**Feedback from Validators:**');\r\n      sections.push(iter.feedback);\r\n      sections.push('');\r\n    }\r\n\r\n    sections.push(`**Confidence:** ${iter.confidence.toFixed(2)}`);\r\n    sections.push(`**Timestamp:** ${iter.timestamp}`);\r\n    sections.push('');\r\n    sections.push('---');\r\n    sections.push('');\r\n  }\r\n\r\n  // Add current iteration context\r\n  sections.push(`## Current Iteration: ${currentIteration}`);\r\n  sections.push('');\r\n\r\n  if (history.length > 0) {\r\n    const lastIteration = history[history.length - 1];\r\n    if (lastIteration.feedback) {\r\n      sections.push('**Your Task:** Address the feedback from the previous iteration:');\r\n      sections.push('');\r\n      sections.push(lastIteration.feedback);\r\n      sections.push('');\r\n    } else {\r\n      sections.push(`**Your Task:** Improve upon iteration ${lastIteration.iteration} (confidence: ${lastIteration.confidence.toFixed(2)})`);\r\n      sections.push('');\r\n    }\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Check if iteration history exists for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns True if any iteration history exists\r\n */\r\nexport async function hasIterationHistory(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<boolean> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli -h ${redisHost} -p ${redisPort} --scan --pattern \"${pattern}\"`, { encoding: 'utf8' }).trim();\r\n    return keys.length > 0;\r\n  } catch (err) {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get the latest iteration number for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns Latest iteration number (0 if no history)\r\n */\r\nexport async function getLatestIteration(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<number> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli -h ${redisHost} -p ${redisPort} --scan --pattern \"${pattern}\"`, { encoding: 'utf8' })\r\n      .trim()\r\n      .split('\\n')\r\n      .filter((k) => k.length > 0);\r\n\r\n    if (keys.length === 0) return 0;\r\n\r\n    // Extract iteration numbers and find max\r\n    const iterations = keys.map((key) => {\r\n      const match = key.match(/iteration-(\\d+)$/);\r\n      return match ? parseInt(match[1], 10) : 0;\r\n    });\r\n\r\n    return Math.max(...iterations);\r\n  } catch (err) {\r\n    return 0;\r\n  }\r\n}\r\n"],"names":["execSync","redisHost","process","env","CFN_REDIS_HOST","redisPort","CFN_REDIS_PORT","loadIterationHistory","taskId","agentId","currentIteration","history","i","resultKey","resultJson","encoding","trim","resultData","JSON","parse","feedbackKey","feedback","feedbackJson","feedbackData","comments","err","undefined","push","iteration","result","output","confidence","timestamp","Date","toISOString","console","error","storeIterationResult","stringify","replace","log","formatIterationHistory","length","sections","iter","substring","toFixed","lastIteration","join","hasIterationHistory","pattern","keys","getLatestIteration","split","filter","k","iterations","map","key","match","parseInt","Math","max"],"mappings":"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"}