claude-flow-novice 2.6.0 → 2.8.1

package/.claude/skills/redis-coordination/invoke-waiting-mode.sh

@@ -3,37 +3,21 @@
 # Redis Waiting Mode CLI Wrapper for Agents
 #
 # Usage:
-#   ./invoke-waiting-mode.sh enter --task-id <task> --agent-id <agent> --context <context>
-#   ./invoke-waiting-mode.sh wake --task-id <task> --agent-id <agent> --reason <reason> [--iteration <n>] [--priority <0-100>]
 #   ./invoke-waiting-mode.sh report --task-id <task> --agent-id <agent> --confidence <score> [--iteration <n>]
 #   ./invoke-waiting-mode.sh collect --task-id <task> --agent-ids <id1,id2,id3>
 #   ./invoke-waiting-mode.sh shutdown --task-id <task> [--reason <reason>]
 #
+# DEPRECATION NOTICE:
+# - 'enter' and 'wake' subcommands are DEPRECATED
+# - This script now only supports 'report', 'collect', and 'shutdown' subcommands
+# - Agents are expected to exit cleanly without waiting mode
+#
 # Priority Levels (0-100, higher = more urgent, default = 50):
 #   90-100: Critical (security patches, system failures)
 #   70-89:  High (urgent features, blocking bugs)
 #   40-60:  Medium (normal tasks, default)
 #   20-39:  Low (optimizations, refactoring)
 #   0-19:   Minimal (documentation, cleanup)
-#
-# Examples:
-#   # Agent enters waiting mode
-#   ./invoke-waiting-mode.sh enter --task-id auth-system --agent-id coder-1 --context "iteration-1"
-#
-#   # Coordinator wakes agent with default priority
-#   ./invoke-waiting-mode.sh wake --task-id auth-system --agent-id coder-1 --reason cfn_loop_iteration --iteration 2
-#
-#   # Coordinator wakes agent with high priority
-#   ./invoke-waiting-mode.sh wake --task-id auth-system --agent-id coder-1 --reason security_patch --priority 95
-#
-#   # Agent reports result
-#   ./invoke-waiting-mode.sh report --task-id auth-system --agent-id coder-1 --confidence 0.85 --iteration 1
-#
-#   # Coordinator collects results
-#   ./invoke-waiting-mode.sh collect --task-id auth-system --agent-ids coder-1,reviewer-1,tester-1
-#
-#   # Coordinator broadcasts shutdown signal
-#   ./invoke-waiting-mode.sh shutdown --task-id auth-system --reason task_complete
 
 set -euo pipefail
 
@@ -48,13 +32,12 @@ shift || true
 TASK_ID=""
 AGENT_ID=""
 AGENT_IDS=""
-CONTEXT=""
 REASON=""
 ITERATION=""
 CONFIDENCE=""
 FEEDBACK=""
-TASK_DESC=""
 PRIORITY=50  # Default medium priority (0-100, higher = more urgent)
+MIN_QUORUM=""  # Minimum quorum for consensus validation
 
 while [[ $# -gt 0 ]]; do
     case $1 in
@@ -70,10 +53,6 @@ while [[ $# -gt 0 ]]; do
             AGENT_IDS="$2"
             shift 2
             ;;
-        --context)
-            CONTEXT="$2"
-            shift 2
-            ;;
         --reason)
             REASON="$2"
             shift 2
@@ -90,14 +69,14 @@ while [[ $# -gt 0 ]]; do
             FEEDBACK="$2"
             shift 2
             ;;
-        --task)
-            TASK_DESC="$2"
-            shift 2
-            ;;
         --priority)
             PRIORITY="$2"
             shift 2
             ;;
+        --min-quorum)
+            MIN_QUORUM="$2"
+            shift 2
+            ;;
         *)
             echo "Unknown argument: $1"
             exit 1
@@ -105,156 +84,17 @@ while [[ $# -gt 0 ]]; do
     esac
 done
 
-# Validate required arguments
 case "$COMMAND" in
     enter)
-        if [ -z "$TASK_ID" ] || [ -z "$AGENT_ID" ] || [ -z "$CONTEXT" ]; then
-            echo "Error: enter requires --task-id, --agent-id, and --context"
-            exit 1
-        fi
-
-        # Enter waiting mode
-        READY_KEY="swarm:${TASK_ID}:${AGENT_ID}:ready"
-        WAKE_QUEUE="swarm:${TASK_ID}:${AGENT_ID}:wake-queue"
-        SHUTDOWN_KEY="swarm:${TASK_ID}:shutdown"
-
-        # Publish ready status
-        READY_MSG=$(jq -n \
-            --arg status "waiting" \
-            --arg context "$CONTEXT" \
-            --arg ts "$(date +%s)" \
-            '{status: $status, context: $context, timestamp: ($ts | tonumber)}')
-
-        echo "$READY_MSG" | redis-cli -x LPUSH "$READY_KEY" >/dev/null
-
-        echo "[$AGENT_ID] Entered waiting mode (context: $CONTEXT)"
-        echo "[$AGENT_ID] Blocking on priority queue $WAKE_QUEUE and $SHUTDOWN_KEY (infinite timeout)..."
-        echo "[$AGENT_ID] Zero token cost while waiting"
-
-        # Poll loop: check shutdown first, then block on wake queue with timeout
-        # This allows us to support both priority queues and shutdown signals
-        while true; do
-            # Check for shutdown signal first (highest priority)
-            SHUTDOWN_CHECK=$(redis-cli LPOP "$SHUTDOWN_KEY")
-
-            if [ -n "$SHUTDOWN_CHECK" ] && [ "$SHUTDOWN_CHECK" != "(nil)" ]; then
-                # Shutdown signal received
-                SHUTDOWN_REASON=$(echo "$SHUTDOWN_CHECK" | jq -r '.reason // "unknown"')
-                echo "[$AGENT_ID] 🛑 Shutdown signal received"
-                echo "[$AGENT_ID] Reason: $SHUTDOWN_REASON"
-                echo "$SHUTDOWN_CHECK" | jq '.'
-
-                # Exit with SIGINT code to indicate graceful shutdown
-                exit 130
-            fi
-
-            # Block on wake queue with 1-second timeout (allows periodic shutdown checks)
-            # BZPOPMIN returns: key, member, score (3 lines)
-            WAKE_RESULT=$(redis-cli BZPOPMIN "$WAKE_QUEUE" 1 2>/dev/null)
-
-            if [ -n "$WAKE_RESULT" ] && [ "$WAKE_RESULT" != "(nil)" ]; then
-                # Parse result (BZPOPMIN returns 3 lines: key, member, score)
-                WAKE_MSG=$(echo "$WAKE_RESULT" | sed -n '2p')
-
-                # Validate JSON before processing
-                if echo "$WAKE_MSG" | jq empty 2>/dev/null; then
-                    echo "[$AGENT_ID] ✅ Woken up!"
-                    echo "$WAKE_MSG" | jq '.'
-
-                    # Return wake message to caller
-                    echo "$WAKE_MSG"
-                    break
-                else
-                    echo "[$AGENT_ID] ⚠️  Invalid JSON in wake message, ignoring"
-                    continue
-                fi
-            fi
-
-            # If no wake signal received, loop back to check shutdown again
-        done
+        echo "[DEPRECATED] 'enter' subcommand is no longer supported."
+        echo "Agents should no longer use waiting mode. Exit cleanly."
+        exit 1
         ;;
 
     wake)
-        if [ -z "$TASK_ID" ] || [ -z "$AGENT_ID" ] || [ -z "$REASON" ]; then
-            echo "Error: wake requires --task-id, --agent-id, and --reason"
-            exit 1
-        fi
-
-        WAKE_QUEUE="swarm:${TASK_ID}:${AGENT_ID}:wake-queue"
-
-        # Build wake message (compact JSON for Redis storage)
-        WAKE_MSG=$(jq -nc \
-            --arg reason "$REASON" \
-            --arg iteration "${ITERATION:-0}" \
-            --arg task "${TASK_DESC:-}" \
-            --arg feedback "${FEEDBACK:-}" \
-            --arg priority "$PRIORITY" \
-            --arg ts "$(date +%s)" \
-            '{
-                reason: $reason,
-                iteration: ($iteration | tonumber),
-                task: $task,
-                feedback: ($feedback | split(",") | map(select(length > 0))),
-                priority: ($priority | tonumber),
-                timestamp: ($ts | tonumber)
-            }')
-
-        # Store feedback in Redis for agent to read (if provided and iteration > 0)
-        # Debug: Echo values before conditional (only if feedback provided)
-        if [ -n "$FEEDBACK" ]; then
-            [ "$DEBUG" = "true" ] && echo "[DEBUG] Checking feedback storage: FEEDBACK='$FEEDBACK', ITERATION='${ITERATION:-0}'"
-        fi
-
-        # Only store feedback if: feedback is non-empty AND iteration > 0
-        # Check iteration value explicitly (not just default)
-        if [ -n "$FEEDBACK" ] && [ -n "$ITERATION" ] && [ "$ITERATION" -gt 0 ]; then
-            FEEDBACK_KEY="swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${ITERATION}"
-            FEEDBACK_ARRAY=$(echo "$FEEDBACK" | jq -Rc 'split(",") | map(select(length > 0))')
-
-            # Only store if feedback array is not empty after filtering
-            ARRAY_LENGTH=$(echo "$FEEDBACK_ARRAY" | jq 'length')
-            if [ "$ARRAY_LENGTH" -gt 0 ]; then
-                # Store as JSON array with 24-hour TTL using redis-cli -x (reads from stdin)
-                # Note: -x reads LAST argument from stdin, so we can't use SET key value EX ttl
-                # Instead: SET key (value from stdin), then EXPIRE key ttl
-                REDIS_RESULT=$(printf '%s' "$FEEDBACK_ARRAY" | redis-cli -x SET "$FEEDBACK_KEY")
-                redis-cli EXPIRE "$FEEDBACK_KEY" 86400 >/dev/null
-
-                # Always log feedback storage (not just in DEBUG mode)
-                if [ "$REDIS_RESULT" = "OK" ]; then
-                    echo "  [Feedback] Stored $ARRAY_LENGTH items in Redis (TTL: 24h)"
-                fi
-
-                if [ "$DEBUG" = "true" ]; then
-                    echo "[DEBUG] Stored feedback in $FEEDBACK_KEY (TTL: 24h)"
-                    echo "[DEBUG] Feedback: $FEEDBACK_ARRAY"
-                    echo "[DEBUG] Redis SET result: $REDIS_RESULT"
-                fi
-            fi
-        fi
-
-        # Calculate priority score (lower score = higher priority, popped first)
-        # Score = (100 - priority) * 1000000 + timestamp
-        # This ensures higher priority messages are processed first, with FIFO for same priority
-        TIMESTAMP=$(date +%s)
-        PRIORITY_SCORE=$(echo "(100 - $PRIORITY) * 1000000 + $TIMESTAMP" | bc)
-
-        # Debug output
-        if [ "$DEBUG" = "true" ]; then
-            echo "[DEBUG] WAKE_QUEUE: $WAKE_QUEUE"
-            echo "[DEBUG] PRIORITY: $PRIORITY"
-            echo "[DEBUG] Priority score: $PRIORITY_SCORE"
-            echo "[DEBUG] Message: $WAKE_MSG"
-        fi
-
-        # Add to sorted set (ZADD with calculated score)
-        # Use redis-cli with ZADD and pass JSON as the member directly
-        redis-cli ZADD "$WAKE_QUEUE" "$PRIORITY_SCORE" "$WAKE_MSG" >/dev/null
-
-        echo "[Coordinator] ✅ Wake signal sent to $AGENT_ID"
-        echo "  Reason: $REASON"
-        echo "  Priority: $PRIORITY (score: $PRIORITY_SCORE)"
-        [ -n "$ITERATION" ] && echo "  Iteration: $ITERATION"
+        echo "[DEPRECATED] 'wake' subcommand is no longer supported."
+        echo "Coordinator should spawn agents directly without waiting mode."
+        exit 1
         ;;
 
     report)
@@ -290,12 +130,13 @@ case "$COMMAND" in
 
     collect)
         if [ -z "$TASK_ID" ] || [ -z "$AGENT_IDS" ]; then
-            echo "Error: collect requires --task-id and --agent-ids"
+            echo "Error: collect requires --task-id and --agent-ids" >&2
             exit 1
         fi
 
-        echo "[Coordinator] Collecting results from agents..."
-        echo ""
+        # Output verbose messages to stderr
+        echo "[Coordinator] Collecting results from agents..." >&2
+        echo "" >&2
 
         # Split agent IDs
         IFS=',' read -ra AGENTS <<< "$AGENT_IDS"
@@ -307,31 +148,70 @@ case "$COMMAND" in
         for AGENT in "${AGENTS[@]}"; do
             RESULT_KEY="swarm:${TASK_ID}:${AGENT}:result"
 
-            # Get latest result (non-blocking)
-            RESULT=$(redis-cli LPOP "$RESULT_KEY")
+            # Get latest result (non-blocking, non-destructive)
+            # Use LINDEX instead of LPOP to preserve results for multiple reads
+            RESULT=$(redis-cli LINDEX "$RESULT_KEY" 0)
 
             if [ -n "$RESULT" ] && [ "$RESULT" != "(nil)" ]; then
-                CONF=$(echo "$RESULT" | jq -r '.confidence')
-                echo "  [$AGENT] Confidence: $CONF"
-                RESULTS+=("$RESULT")
-                CONFIDENCES+=("$CONF")
-
-                # Check if result includes feedback array
-                FEEDBACK=$(echo "$RESULT" | jq -r '.feedback // empty | .[]?' 2>/dev/null)
-                if [ -n "$FEEDBACK" ]; then
-                    echo "  [$AGENT] Feedback provided:"
-                    echo "$RESULT" | jq -r '.feedback[]' | sed 's/^/    - /'
-
-                    # Collect all feedback items
-                    while IFS= read -r ITEM; do
-                        ALL_FEEDBACK+=("$ITEM")
-                    done < <(echo "$RESULT" | jq -r '.feedback[]')
+                # Handle both simple numeric format and JSON format
+                # Try to parse as JSON first, fall back to simple number
+                if CONF=$(echo "$RESULT" | jq -r '.confidence' 2>/dev/null) && [ "$CONF" != "null" ]; then
+                    # JSON format: {"confidence":0.85,"iteration":1,...}
+                    echo "  [$AGENT] Confidence: $CONF" >&2
+                    RESULTS+=("$RESULT")
+                    CONFIDENCES+=("$CONF")
+
+                    # Check if result includes feedback array
+                    FEEDBACK=$(echo "$RESULT" | jq -r '.feedback // empty | .[]?' 2>/dev/null)
+                    if [ -n "$FEEDBACK" ]; then
+                        echo "  [$AGENT] Feedback provided:" >&2
+                        echo "$RESULT" | jq -r '.feedback[]' | sed 's/^/    - /' >&2
+
+                        # Collect all feedback items
+                        while IFS= read -r ITEM; do
+                            ALL_FEEDBACK+=("$ITEM")
+                        done < <(echo "$RESULT" | jq -r '.feedback[]')
+                    fi
+                elif [[ "$RESULT" =~ ^[0-9]+\.?[0-9]*$ ]]; then
+                    # Simple numeric format: "0.85"
+                    CONF="$RESULT"
+                    echo "  [$AGENT] Confidence: $CONF" >&2
+                    CONFIDENCES+=("$CONF")
+                else
+                    echo "  [$AGENT] ⚠️  Invalid result format: $RESULT" >&2
                 fi
             else
-                echo "  [$AGENT] ⚠️  No result found"
+                echo "  [$AGENT] ⚠️  No result found" >&2
             fi
         done
 
+        # Validate quorum if specified
+        TOTAL_AGENTS=${#AGENTS[@]}
+        RESPONDING_AGENTS=${#CONFIDENCES[@]}
+
+        if [ -n "$MIN_QUORUM" ]; then
+            # Parse min-quorum (supports: absolute number, percentage, or decimal)
+            if [[ "$MIN_QUORUM" =~ ^[0-9]+%$ ]]; then
+                # Percentage format: "66%"
+                PCT=${MIN_QUORUM%\%}
+                REQUIRED=$(echo "scale=0; ($TOTAL_AGENTS * $PCT) / 100" | bc)
+            elif [[ "$MIN_QUORUM" =~ ^0\.[0-9]+$ ]]; then
+                # Decimal format: "0.66"
+                REQUIRED=$(echo "scale=0; ($TOTAL_AGENTS * $MIN_QUORUM) / 1" | bc)
+            else
+                # Absolute number format: "2"
+                REQUIRED=$MIN_QUORUM
+            fi
+
+            if [ "$RESPONDING_AGENTS" -lt "$REQUIRED" ]; then
+                echo "" >&2
+                echo "[Coordinator] ❌ Quorum not met" >&2
+                echo "  Required: $REQUIRED agents" >&2
+                echo "  Responding: $RESPONDING_AGENTS agents" >&2
+                exit 1
+            fi
+        fi
+
         # Calculate consensus
         if [ ${#CONFIDENCES[@]} -gt 0 ]; then
             SUM=0
@@ -341,19 +221,25 @@ case "$COMMAND" in
             COUNT=${#CONFIDENCES[@]}
             CONSENSUS=$(echo "scale=2; $SUM / $COUNT" | bc)
 
-            echo ""
-            echo "[Coordinator] Consensus: $CONSENSUS"
+            # Ensure leading zero for bc output (handles .87 -> 0.87)
+            if [[ "$CONSENSUS" =~ ^\. ]]; then
+                CONSENSUS="0$CONSENSUS"
+            fi
+
+            echo "" >&2
+            echo "[Coordinator] Consensus: $CONSENSUS" >&2
 
             # Print aggregated feedback if available
             if [ ${#ALL_FEEDBACK[@]} -gt 0 ]; then
-                echo "[Coordinator] Aggregated Feedback (${#ALL_FEEDBACK[@]} items):"
-                printf '%s\n' "${ALL_FEEDBACK[@]}" | sort -u | sed 's/^/  - /'
+                echo "[Coordinator] Aggregated Feedback (${#ALL_FEEDBACK[@]} items):" >&2
+                printf '%s\n' "${ALL_FEEDBACK[@]}" | sort -u | sed 's/^/  - /' >&2
             fi
 
+            # Output only consensus value to stdout for callers
             echo "$CONSENSUS"
         else
-            echo ""
-            echo "[Coordinator] No results to calculate consensus"
+            echo "" >&2
+            echo "[Coordinator] No results to calculate consensus" >&2
             echo "0.0"
         fi
         ;;
@@ -375,43 +261,23 @@ case "$COMMAND" in
                 timestamp: ($ts | tonumber)
             }')
 
-        # Broadcast shutdown signal (use LPUSH to add to list)
-        # All waiting agents will check this key and exit gracefully
+        # Broadcast shutdown signal
         echo "$SHUTDOWN_MSG" | redis-cli -x LPUSH "$SHUTDOWN_KEY" >/dev/null
 
         echo "[Coordinator] 🛑 Shutdown signal broadcasted"
         echo "  Task ID: $TASK_ID"
         echo "  Reason: ${REASON:-task_complete}"
-        echo ""
-        echo "Note: Signal added to $SHUTDOWN_KEY"
-        echo "All waiting agents will receive shutdown on next poll cycle (max 1 second)"
         ;;
 
     *)
-
         echo "Usage: $0 <command> [options]"
         echo ""
         echo "Commands:"
-        echo "  enter    - Agent enters waiting mode"
-        echo "  wake     - Coordinator wakes an agent (supports --priority 0-100)"
         echo "  report   - Agent reports result"
         echo "  collect  - Coordinator collects results"
-        echo "  shutdown - Coordinator broadcasts shutdown signal to all waiting agents"
-        echo ""
-        echo "Priority Levels (0-100, higher = more urgent, default = 50):"
-        echo "  90-100: Critical (security patches, system failures)"
-        echo "  70-89:  High (urgent features, blocking bugs)"
-        echo "  40-60:  Medium (normal tasks, default)"
-        echo "  20-39:  Low (optimizations, refactoring)"
-        echo "  0-19:   Minimal (documentation, cleanup)"
+        echo "  shutdown - Coordinator broadcasts shutdown signal"
         echo ""
-        echo "Examples:"
-        echo "  $0 enter --task-id auth --agent-id coder-1 --context iteration-1"
-        echo "  $0 wake --task-id auth --agent-id coder-1 --reason cfn_loop_iteration --iteration 2"
-        echo "  $0 wake --task-id auth --agent-id coder-1 --reason security_patch --priority 95"
-        echo "  $0 report --task-id auth --agent-id coder-1 --confidence 0.85 --iteration 1"
-        echo "  $0 collect --task-id auth --agent-ids coder-1,reviewer-1,tester-1"
-        echo "  $0 shutdown --task-id auth --reason task_complete"
+        echo "Note: 'enter' and 'wake' subcommands are DEPRECATED"
         exit 1
         ;;
-esac
+esac