claude-flow-novice 2.9.0 → 2.10.0

package/.claude/skills/cfn-redis-coordination/demos/test-quorum-percentage.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# Quorum Percentage Test Case
+# Tests percentage-based quorum scenarios
+
+source "$(dirname "$0")/test-utils.sh"
+
+# Test Scenario 1: 80% of 10 agents = 8 required, 8/10 complete → SUCCESS
+test_percentage_quorum_success() {
+    local total_agents=10
+    local quorum_percentage=0.8
+    local completed_agents=8
+
+    local result=$(check_percentage_quorum "$total_agents" "$quorum_percentage" "$completed_agents")
+    assert_equals "$result" "SUCCESS" "Quorum not reached when 8/10 agents complete (80% required)"
+}
+
+# Test Scenario 2: 80% of 10 agents = 8 required, 7/10 complete → FAILURE
+test_percentage_quorum_failure() {
+    local total_agents=10
+    local quorum_percentage=0.8
+    local completed_agents=7
+
+    local result=$(check_percentage_quorum "$total_agents" "$quorum_percentage" "$completed_agents")
+    assert_equals "$result" "FAILURE" "Quorum incorrectly reached when only 7/10 agents complete (80% required)"
+}
+
+# Test Scenario 3: 90% of 5 agents = 4.5 → 5 required (round up)
+test_percentage_quorum_round_up() {
+    local total_agents=5
+    local quorum_percentage=0.9
+    local completed_agents=5
+
+    local result=$(check_percentage_quorum "$total_agents" "$quorum_percentage" "$completed_agents")
+    assert_equals "$result" "SUCCESS" "Quorum not reached when all 5/5 agents complete (90% required)"
+}
+
+# Test Scenario 4: 90% of 5 agents = 4.5 → 5 required, 4/5 complete → FAILURE
+test_percentage_quorum_insufficient() {
+    local total_agents=5
+    local quorum_percentage=0.9
+    local completed_agents=4
+
+    local result=$(check_percentage_quorum "$total_agents" "$quorum_percentage" "$completed_agents")
+    assert_equals "$result" "FAILURE" "Quorum incorrectly reached when 4/5 agents complete (90% required)"
+}
+
+# Run the tests
+main() {
+    test_percentage_quorum_success
+    test_percentage_quorum_failure
+    test_percentage_quorum_round_up
+    test_percentage_quorum_insufficient
+    echo "Percentage Quorum Test Complete"
+}
+
+main

package/.claude/skills/cfn-redis-coordination/demos/test-quorum-with-retry.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+# Quorum Retry Mechanism Test Case
+# Tests retry scenarios for agent completion
+
+source "$(dirname "$0")/test-utils.sh"
+
+# Simulated Redis-based retry mechanism
+simulate_agent_retry() {
+    local task_id="$1"
+    local agent_id="$2"
+    local max_retries="${3:-3}"
+    local retry_delay="${4:-5}"
+
+    local attempt=1
+    local success=false
+
+    while [ $attempt -le "$max_retries" ]; do
+        # Simulate agent work
+        if agent_work "$task_id" "$agent_id"; then
+            success=true
+            break
+        fi
+
+        echo "Agent $agent_id - Attempt $attempt failed. Retrying in $retry_delay seconds..."
+        sleep "$retry_delay"
+        ((attempt++))
+    done
+
+    if [ "$success" = true ]; then
+        echo "SUCCESS"
+    else
+        echo "FAILURE"
+    fi
+}
+
+# Mock agent work function with potential failure
+agent_work() {
+    local task_id="$1"
+    local agent_id="$2"
+
+    # Simulated 50% chance of failure on first attempt
+    if [ "$agent_id" == "agent-1" ] && [ -z "$RETRY_COMPLETE" ]; then
+        RETRY_COMPLETE=1
+        return 1
+    fi
+
+    return 0
+}
+
+# Test Scenario: Agent times out on attempt 1, retry succeeds on attempt 2
+test_quorum_retry_mechanism() {
+    local task_id="retry-test-task"
+    local agent_id="agent-1"
+
+    local result=$(simulate_agent_retry "$task_id" "$agent_id")
+    assert_equals "$result" "SUCCESS" "Retry mechanism failed to complete agent work"
+}
+
+# Additional retry tests
+test_multiple_agent_retries() {
+    local total_agents=5
+    local successful_agents=0
+
+    for ((i=1; i<=total_agents; i++)); do
+        local result=$(simulate_agent_retry "multi-retry-task" "agent-$i")
+        if [ "$result" == "SUCCESS" ]; then
+            ((successful_agents++))
+        fi
+    done
+
+    assert_greater_than "$successful_agents" 3 "Insufficient agents completed with retry"
+}
+
+# Run the tests
+main() {
+    test_quorum_retry_mechanism
+    test_multiple_agent_retries
+    echo "Retry Mechanism Test Complete"
+}
+
+main

package/.claude/skills/cfn-redis-coordination/demos/test-quorum.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# Master Quorum Validation Test Suite
+# Task ID: redis-phase2-1760875940
+# Agent ID: tester-2
+
+set -euo pipefail
+
+# Source common testing utilities
+source "$(dirname "$0")/test-utils.sh"
+
+# Test Results Tracking
+TOTAL_TESTS=4
+PASSED_TESTS=0
+FAILED_TESTS=0
+
+# Run Quorum Test Cases
+run_test "test-quorum-absolute.sh"
+run_test "test-quorum-percentage.sh"
+run_test "test-quorum-with-retry.sh"
+run_test "test-quorum-fallback.sh"
+
+# Generate Test Report
+generate_test_report
+
+# Signal Completion to Redis
+signal_task_complete() {
+    local confidence=$(calculate_confidence)
+    redis-cli lpush "swarm:redis-phase2-1760875940:tester-2:done" "complete"
+
+    # Report to waiting mode
+    ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh report \
+        --task-id redis-phase2-1760875940 \
+        --agent-id tester-2 \
+        --confidence "$confidence" \
+        --iteration 1
+
+    # Enter waiting mode
+    ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh enter \
+        --task-id redis-phase2-1760875940 \
+        --agent-id tester-2 \
+        --context "task-2-3-complete"
+}
+
+# Run main test suite
+main() {
+    # Setup any required test environments
+    setup_test_environment
+
+    # Execute test cases
+    run_all_tests
+
+    # Signal completion
+    signal_task_complete
+}
+
+# Execute main function
+main

package/.claude/skills/cfn-redis-coordination/demos/test-shutdown-handling.sh

@@ -0,0 +1,187 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# Test: Shutdown Handling in Orchestrator
+# Verifies that orchestrator responds to shutdown signals and cleans up
+##############################################################################
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TEST_TASK_ID="test-shutdown-$(date +%s)"
+CLEANUP_NEEDED=1
+
+# Cleanup function
+cleanup() {
+  if [ $CLEANUP_NEEDED -eq 1 ]; then
+    echo ""
+    echo "=== Cleanup ==="
+    redis-cli DEL "swarm:${TEST_TASK_ID}:shutdown" >/dev/null 2>&1 || true
+    redis-cli DEL "swarm:${TEST_TASK_ID}:*" >/dev/null 2>&1 || true
+    echo "Cleanup complete"
+  fi
+}
+
+trap cleanup EXIT
+
+echo "=== Test: Shutdown Handling in Orchestrator ==="
+echo "Test Task ID: $TEST_TASK_ID"
+echo ""
+
+# Test 1: Start orchestrator in background
+echo "Test 1: Starting orchestrator in background..."
+
+# Create mock agents (we'll send shutdown before they complete)
+MOCK_LOOP3="mock-agent-1,mock-agent-2"
+MOCK_LOOP2="mock-validator-1"
+MOCK_PO="mock-po"
+
+# Start orchestrator in background with high timeout (so it doesn't fail quickly)
+timeout 30 "$SCRIPT_DIR/orchestrate-cfn-loop.sh" \
+  --task-id "$TEST_TASK_ID" \
+  --mode standard \
+  --loop3-agents "$MOCK_LOOP3" \
+  --loop2-agents "$MOCK_LOOP2" \
+  --product-owner "$MOCK_PO" \
+  --timeout 3600 \
+  --max-iterations 5 > /tmp/orchestrator-output-${TEST_TASK_ID}.log 2>&1 &
+
+ORCHESTRATOR_PID=$!
+echo "Orchestrator started (PID: $ORCHESTRATOR_PID)"
+
+# Wait for orchestrator to initialize and start shutdown monitor
+sleep 2
+
+# Verify orchestrator is running
+if ! kill -0 $ORCHESTRATOR_PID 2>/dev/null; then
+  echo "❌ FAIL: Orchestrator process died prematurely"
+  cat /tmp/orchestrator-output-${TEST_TASK_ID}.log
+  exit 1
+fi
+
+echo "✅ PASS: Orchestrator is running"
+echo ""
+
+# Test 2: Send shutdown signal via Redis
+echo "Test 2: Sending shutdown signal via Redis..."
+
+SHUTDOWN_PAYLOAD=$(jq -n --arg reason "test_shutdown" '{reason: $reason}')
+echo "$SHUTDOWN_PAYLOAD" | redis-cli -x LPUSH "swarm:${TEST_TASK_ID}:shutdown" >/dev/null
+
+echo "Shutdown signal sent: $SHUTDOWN_PAYLOAD"
+echo "Waiting for orchestrator to shutdown..."
+
+# Wait up to 5 seconds for graceful shutdown
+for i in {1..10}; do
+  if ! kill -0 $ORCHESTRATOR_PID 2>/dev/null; then
+    echo "✅ PASS: Orchestrator shutdown gracefully"
+    break
+  fi
+  sleep 0.5
+done
+
+# Verify orchestrator has stopped
+if kill -0 $ORCHESTRATOR_PID 2>/dev/null; then
+  echo "❌ FAIL: Orchestrator did not shutdown within 5 seconds"
+  kill -9 $ORCHESTRATOR_PID 2>/dev/null || true
+  exit 1
+fi
+
+echo ""
+
+# Test 3: Verify cleanup happened
+echo "Test 3: Verifying cleanup..."
+
+# Check orchestrator output for shutdown messages
+if grep -q "Orchestrator shutting down gracefully" /tmp/orchestrator-output-${TEST_TASK_ID}.log; then
+  echo "✅ PASS: Found shutdown message in output"
+else
+  echo "❌ FAIL: Shutdown message not found in output"
+  echo "Output:"
+  cat /tmp/orchestrator-output-${TEST_TASK_ID}.log
+  exit 1
+fi
+
+if grep -q "Shutdown complete" /tmp/orchestrator-output-${TEST_TASK_ID}.log; then
+  echo "✅ PASS: Found completion message in output"
+else
+  echo "⚠️  WARNING: Completion message not found (non-critical)"
+fi
+
+# Check if swarm was marked as cancelled (may not be present if init-swarm never ran)
+if grep -q "Marking swarm as cancelled" /tmp/orchestrator-output-${TEST_TASK_ID}.log || grep -q "Failed to mark swarm as cancelled" /tmp/orchestrator-output-${TEST_TASK_ID}.log; then
+  echo "✅ PASS: Attempted to mark swarm as cancelled"
+else
+  echo "⚠️  INFO: Swarm cancellation not attempted (may not have initialized yet)"
+fi
+
+echo ""
+
+# Test 4: Send SIGTERM signal
+echo "Test 4: Testing SIGTERM signal handling..."
+
+# Start another orchestrator instance
+timeout 30 "$SCRIPT_DIR/orchestrate-cfn-loop.sh" \
+  --task-id "${TEST_TASK_ID}-sigterm" \
+  --mode standard \
+  --loop3-agents "$MOCK_LOOP3" \
+  --loop2-agents "$MOCK_LOOP2" \
+  --product-owner "$MOCK_PO" \
+  --timeout 3600 \
+  --max-iterations 5 > /tmp/orchestrator-output-${TEST_TASK_ID}-sigterm.log 2>&1 &
+
+ORCHESTRATOR_PID_2=$!
+echo "Second orchestrator started (PID: $ORCHESTRATOR_PID_2)"
+
+# Wait for initialization
+sleep 2
+
+# Send SIGTERM
+echo "Sending SIGTERM to orchestrator..."
+kill -TERM $ORCHESTRATOR_PID_2 2>/dev/null || true
+
+# Wait for shutdown
+for i in {1..10}; do
+  if ! kill -0 $ORCHESTRATOR_PID_2 2>/dev/null; then
+    echo "✅ PASS: Orchestrator responded to SIGTERM"
+    break
+  fi
+  sleep 0.5
+done
+
+# Verify shutdown
+if kill -0 $ORCHESTRATOR_PID_2 2>/dev/null; then
+  echo "❌ FAIL: Orchestrator did not respond to SIGTERM within 5 seconds"
+  kill -9 $ORCHESTRATOR_PID_2 2>/dev/null || true
+  exit 1
+fi
+
+# Check for SIGTERM handling in output
+if grep -q "SIGTERM_received" /tmp/orchestrator-output-${TEST_TASK_ID}-sigterm.log; then
+  echo "✅ PASS: SIGTERM signal was properly caught and handled"
+else
+  echo "⚠️  WARNING: SIGTERM handling message not clear in output"
+fi
+
+echo ""
+echo "=== All Tests Passed ==="
+echo ""
+echo "Orchestrator output (Test 1 - Redis shutdown):"
+echo "----------------------------------------------"
+cat /tmp/orchestrator-output-${TEST_TASK_ID}.log
+echo ""
+echo "Orchestrator output (Test 2 - SIGTERM):"
+echo "----------------------------------------"
+cat /tmp/orchestrator-output-${TEST_TASK_ID}-sigterm.log
+
+# Cleanup test files
+rm -f /tmp/orchestrator-output-${TEST_TASK_ID}.log
+rm -f /tmp/orchestrator-output-${TEST_TASK_ID}-sigterm.log
+redis-cli DEL "swarm:${TEST_TASK_ID}-sigterm:shutdown" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TEST_TASK_ID}-sigterm:*" >/dev/null 2>&1 || true
+
+CLEANUP_NEEDED=0  # Prevent duplicate cleanup
+
+echo ""
+echo "✅ All shutdown handling tests passed successfully"
+exit 0

package/.claude/skills/cfn-redis-coordination/demos/test-shutdown.sh

@@ -0,0 +1,160 @@
+#!/bin/bash
+#
+# Test shutdown handling for waiting agents
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WAITING_MODE_SCRIPT="$SCRIPT_DIR/invoke-waiting-mode.sh"
+
+TASK_ID="test-shutdown-$(date +%s)"
+AGENT_ID="test-agent-1"
+
+echo "=========================================="
+echo "Testing Shutdown Handling"
+echo "=========================================="
+echo ""
+echo "Task ID: $TASK_ID"
+echo "Agent ID: $AGENT_ID"
+echo ""
+
+# Clean up Redis keys before test
+echo "Cleaning up Redis keys..."
+redis-cli DEL "swarm:${TASK_ID}:${AGENT_ID}:ready" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TASK_ID}:${AGENT_ID}:wake-queue" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TASK_ID}:shutdown" >/dev/null 2>&1 || true
+
+echo ""
+echo "Test 1: Agent enters waiting mode in background"
+echo "------------------------------------------------"
+
+# Start agent in background
+{
+    $WAITING_MODE_SCRIPT enter \
+        --task-id "$TASK_ID" \
+        --agent-id "$AGENT_ID" \
+        --context "test-shutdown"
+
+    EXIT_CODE=$?
+    echo "Agent exited with code: $EXIT_CODE"
+
+    if [ $EXIT_CODE -eq 130 ]; then
+        echo "✅ Agent gracefully shutdown with SIGINT code (130)"
+    else
+        echo "❌ Expected exit code 130, got $EXIT_CODE"
+        exit 1
+    fi
+} &
+
+AGENT_PID=$!
+echo "Agent started (PID: $AGENT_PID)"
+
+# Wait for agent to enter waiting mode
+sleep 2
+
+# Check if agent published ready status
+READY_STATUS=$(redis-cli LPOP "swarm:${TASK_ID}:${AGENT_ID}:ready")
+if [ -n "$READY_STATUS" ] && [ "$READY_STATUS" != "(nil)" ]; then
+    echo "✅ Agent published ready status:"
+    echo "$READY_STATUS" | jq '.'
+else
+    echo "❌ Agent did not publish ready status"
+    kill $AGENT_PID 2>/dev/null || true
+    exit 1
+fi
+
+echo ""
+echo "Test 2: Send shutdown signal"
+echo "-----------------------------"
+
+$WAITING_MODE_SCRIPT shutdown \
+    --task-id "$TASK_ID" \
+    --reason "test_shutdown"
+
+echo ""
+echo "Test 3: Verify agent receives shutdown and exits"
+echo "------------------------------------------------"
+
+# Wait for agent to process shutdown (max 2 seconds for poll cycle)
+sleep 3
+
+# Check if agent process is still running
+if ps -p $AGENT_PID >/dev/null 2>&1; then
+    echo "❌ Agent still running after shutdown signal"
+    kill $AGENT_PID 2>/dev/null || true
+    exit 1
+else
+    echo "✅ Agent terminated after shutdown signal"
+fi
+
+# Wait for background process to finish and capture exit code
+wait $AGENT_PID 2>/dev/null || true
+
+echo ""
+echo "Test 4: Verify shutdown with wake signal priority"
+echo "-------------------------------------------------"
+
+# Clean up
+redis-cli DEL "swarm:${TASK_ID}:${AGENT_ID}:ready" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TASK_ID}:${AGENT_ID}:wake-queue" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TASK_ID}:shutdown" >/dev/null 2>&1 || true
+
+# Start agent in background
+{
+    $WAITING_MODE_SCRIPT enter \
+        --task-id "$TASK_ID" \
+        --agent-id "$AGENT_ID" \
+        --context "test-priority"
+
+    EXIT_CODE=$?
+    if [ $EXIT_CODE -eq 130 ]; then
+        echo "✅ Agent prioritized shutdown over wake signal"
+    else
+        echo "⚠️  Agent exited with code $EXIT_CODE (may have received wake signal first)"
+    fi
+} &
+
+AGENT_PID=$!
+
+# Wait for agent to enter waiting mode
+sleep 2
+
+# Send both wake and shutdown signals (shutdown should take priority)
+$WAITING_MODE_SCRIPT wake \
+    --task-id "$TASK_ID" \
+    --agent-id "$AGENT_ID" \
+    --reason "test_wake" \
+    --priority 50 &
+
+$WAITING_MODE_SCRIPT shutdown \
+    --task-id "$TASK_ID" \
+    --reason "test_shutdown_priority" &
+
+# Wait for signals to be sent
+sleep 1
+
+# Wait for agent to process
+sleep 3
+
+# Check if agent terminated
+if ps -p $AGENT_PID >/dev/null 2>&1; then
+    echo "⚠️  Agent still running (may have processed wake signal)"
+    kill $AGENT_PID 2>/dev/null || true
+else
+    echo "✅ Agent terminated (shutdown had priority)"
+fi
+
+wait $AGENT_PID 2>/dev/null || true
+
+echo ""
+echo "=========================================="
+echo "✅ All shutdown handling tests passed!"
+echo "=========================================="
+
+# Cleanup
+redis-cli DEL "swarm:${TASK_ID}:${AGENT_ID}:ready" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TASK_ID}:${AGENT_ID}:wake-queue" >/dev/null 2>&1 || true
+redis-cli DEL "swarm:${TASK_ID}:shutdown" >/dev/null 2>&1 || true
+
+exit 0

package/.claude/skills/cfn-redis-coordination/demos/test-utils-unix.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+# Utility functions for quorum testing
+
+# Check absolute quorum
+check_quorum() {
+    local total_agents="$1"
+    local quorum="$2"
+    local completed_agents="$3"
+
+    if [ "$completed_agents" -ge "$quorum" ]; then
+        echo "SUCCESS"
+    else
+        echo "FAILURE"
+    fi
+}
+
+# Check percentage-based quorum
+check_percentage_quorum() {
+    local total_agents="$1"
+    local quorum_percentage="$2"
+    local completed_agents="$3"
+
+    # Calculate the minimum number of agents required (round up)
+    local required_agents=$(echo "scale=0; ceil($total_agents * $quorum_percentage)" | bc)
+
+    if [ "$completed_agents" -ge "$required_agents" ]; then
+        echo "SUCCESS"
+    else
+        echo "FAILURE"
+    fi
+}
+
+# Graceful degradation strategy
+simulate_graceful_degradation() {
+    local total_agents="$1"
+    local initial_quorum="$2"
+    local max_failures="$3"
+
+    # Dynamically adjust quorum based on failures
+    local current_quorum="$initial_quorum"
+    local adjusted_agents=$((total_agents - max_failures))
+    local adjusted_quorum_threshold=$(echo "scale=2; $current_quorum * 0.8" | bc)
+
+    if (( $(echo "$adjusted_quorum_threshold <= 0.65" | bc -l) )); then
+        echo "HALT"  # Prevent degradation below minimum viable quorum
+    else
+        echo "$(check_percentage_quorum "$adjusted_agents" "$adjusted_quorum_threshold" "$adjusted_agents")"
+    fi
+}
+
+# Assertion functions
+assert_equals() {
+    local actual="$1"
+    local expected="$2"
+    local message="${3:-Assertion failed}"
+
+    if [ "$actual" != "$expected" ]; then
+        echo "FAIL: $message (Expected: $expected, Got: $actual)"
+        exit 1
+    fi
+}
+
+assert_greater_than() {
+    local actual="$1"
+    local expected="$2"
+    local message="${3:-Assertion failed}"
+
+    if [ "$actual" -le "$expected" ]; then
+        echo "FAIL: $message (Expected > $expected, Got: $actual)"
+        exit 1
+    fi
+}
+
+assert_not_empty() {
+    local value="$1"
+    local message="${2:-Value is empty}"
+
+    if [ -z "$value" ]; then
+        echo "FAIL: $message"
+        exit 1
+    fi
+}
+
+# Error handling and logging
+log_error() {
+    local message="$1"
+    echo "[ERROR] $message" >&2
+}
+
+# Cleanup function
+cleanup() {
+    # Remove any temporary files or reset test environments
+    echo "Cleaning up test environment..."
+}
+
+# Trap to ensure cleanup happens even if script fails
+trap cleanup EXIT