claude-flow-novice 2.10.4 → 2.10.6

package/claude-assets/skills/cfn-loop-validation/examples/coordinator-full-cfn-loop.sh

@@ -0,0 +1,234 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# Example: Full CFN Loop Integration
+#
+# Scenario: Complete CFN loop workflow with validation at each gate
+# Flow: Loop 3 (confidence) → Loop 2 (consensus) → Loop 4 (product owner)
+##############################################################################
+
+set -euo pipefail
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VALIDATOR="${SCRIPT_DIR}/.claude/skills/cfn-cfn-validate-iteration.sh"
+
+# Configuration
+CFN_MODE="standard"
+TASK_ID="feature-payment-processing"
+MAX_LOOP3_RETRIES=3
+MAX_LOOP2_RETRIES=2
+
+echo "╔════════════════════════════════════════════════════════════╗"
+echo "║           CFN LOOP ORCHESTRATION - Full Example            ║"
+echo "╚════════════════════════════════════════════════════════════╝"
+echo ""
+echo "Task: $TASK_ID"
+echo "Mode: $CFN_MODE"
+echo "Max Loop 3 Retries: $MAX_LOOP3_RETRIES"
+echo "Max Loop 2 Retries: $MAX_LOOP2_RETRIES"
+echo ""
+
+# ============================================================================
+# LOOP 3: Primary Swarm Execution with Confidence Gate
+# ============================================================================
+
+echo "┌────────────────────────────────────────────────────────────┐"
+echo "│ LOOP 3: Primary Swarm Execution (Confidence Gate)         │"
+echo "└────────────────────────────────────────────────────────────┘"
+echo ""
+
+LOOP3_ITERATION=0
+LOOP3_PASSED=false
+
+while [[ $LOOP3_ITERATION -lt $MAX_LOOP3_RETRIES ]]; do
+  LOOP3_ITERATION=$((LOOP3_ITERATION + 1))
+
+  echo "--- Loop 3 Iteration $LOOP3_ITERATION ---"
+  echo "Executing primary swarm (coder + tester)..."
+
+  # Simulate agent work
+  sleep 1
+
+  # Simulated confidence score (improves with each iteration)
+  case $LOOP3_ITERATION in
+    1) AGENT_CONFIDENCE=0.75 ;;  # Below threshold
+    2) AGENT_CONFIDENCE=0.82 ;;  # Above threshold
+    3) AGENT_CONFIDENCE=0.88 ;;  # Well above threshold
+  esac
+
+  echo "Agent self-assessed confidence: $AGENT_CONFIDENCE"
+
+  # Validate confidence gate
+  GATE_RESULT=$("$VALIDATOR" \
+    --mode "$CFN_MODE" \
+    --iteration "$LOOP3_ITERATION" \
+    --confidence "$AGENT_CONFIDENCE" \
+    --task-id "$TASK_ID" \
+    --agent-id "coordinator-loop3" \
+    --json)
+
+  GATE_PASSED=$(echo "$GATE_RESULT" | jq -r '.passed')
+  GATE_STATUS=$(echo "$GATE_RESULT" | jq -r '.status')
+  GATE_THRESHOLD=$(echo "$GATE_RESULT" | jq -r '.threshold')
+
+  echo "Validation: $GATE_STATUS (threshold: $GATE_THRESHOLD)"
+
+  if [[ "$GATE_PASSED" == "true" ]]; then
+    echo "✓ Loop 3 gate PASSED"
+    echo ""
+    LOOP3_PASSED=true
+    break
+  else
+    echo "✗ Loop 3 gate FAILED"
+    echo "  → Injecting feedback and retrying..."
+    echo ""
+    sleep 1
+  fi
+done
+
+if [[ "$LOOP3_PASSED" != "true" ]]; then
+  echo "CRITICAL: Loop 3 failed after $MAX_LOOP3_RETRIES attempts"
+  echo "Action: Escalating to human review"
+  exit 2
+fi
+
+# ============================================================================
+# LOOP 2: Validator Consensus
+# ============================================================================
+
+echo "┌────────────────────────────────────────────────────────────┐"
+echo "│ LOOP 2: Validator Consensus (Byzantine Agreement)         │"
+echo "└────────────────────────────────────────────────────────────┘"
+echo ""
+
+LOOP2_ITERATION=0
+LOOP2_PASSED=false
+
+while [[ $LOOP2_ITERATION -lt $MAX_LOOP2_RETRIES ]]; do
+  LOOP2_ITERATION=$((LOOP2_ITERATION + 1))
+
+  echo "--- Loop 2 Iteration $LOOP2_ITERATION ---"
+  echo "Spawning validator swarm..."
+  echo "  - reviewer"
+  echo "  - security-specialist"
+  echo "  - tester"
+  echo "  - analyst"
+  echo ""
+
+  sleep 1
+
+  # Simulated consensus (improves with each iteration)
+  case $LOOP2_ITERATION in
+    1) CONSENSUS_SCORE=0.88 ;;  # Below threshold
+    2) CONSENSUS_SCORE=0.92 ;;  # Above threshold
+  esac
+
+  echo "Byzantine consensus result: $CONSENSUS_SCORE"
+
+  # Validate consensus
+  CONSENSUS_RESULT=$("$VALIDATOR" \
+    --mode "$CFN_MODE" \
+    --iteration "$LOOP2_ITERATION" \
+    --confidence "$AGENT_CONFIDENCE" \
+    --consensus "$CONSENSUS_SCORE" \
+    --task-id "$TASK_ID" \
+    --agent-id "coordinator-loop2" \
+    --json)
+
+  CONSENSUS_PASSED=$(echo "$CONSENSUS_RESULT" | jq -r '.passed')
+  CONSENSUS_STATUS=$(echo "$CONSENSUS_RESULT" | jq -r '.status')
+  CONSENSUS_THRESHOLD=$(echo "$CONSENSUS_RESULT" | jq -r '.threshold')
+
+  echo "Validation: $CONSENSUS_STATUS (threshold: $CONSENSUS_THRESHOLD)"
+
+  if [[ "$CONSENSUS_PASSED" == "true" ]]; then
+    echo "✓ Loop 2 consensus ACHIEVED"
+    echo ""
+    LOOP2_PASSED=true
+    break
+  else
+    echo "✗ Loop 2 consensus FAILED"
+    echo "  → Analyzing validator feedback and retrying..."
+    echo ""
+    sleep 1
+  fi
+done
+
+if [[ "$LOOP2_PASSED" != "true" ]]; then
+  echo "CRITICAL: Loop 2 consensus failed after $LOOP2_RETRIES attempts"
+  echo "Action: Escalating to human review"
+  exit 2
+fi
+
+# ============================================================================
+# LOOP 4: Product Owner Decision Gate (GOAP)
+# ============================================================================
+
+echo "┌────────────────────────────────────────────────────────────┐"
+echo "│ LOOP 4: Product Owner Decision Gate (GOAP)                │"
+echo "└────────────────────────────────────────────────────────────┘"
+echo ""
+
+echo "Invoking product owner decision..."
+sleep 1
+
+# Simulated product owner decision
+PO_DECISION="PROCEED"
+PO_CONFIDENCE=0.92
+PO_REASONING="Payment processing implementation meets security and compliance standards. Ready for deployment."
+
+echo "Product Owner Decision:"
+echo "  Decision: $PO_DECISION"
+echo "  Confidence: $PO_CONFIDENCE"
+echo "  Reasoning: $PO_REASONING"
+echo ""
+
+case "$PO_DECISION" in
+  PROCEED)
+    echo "✓ Product Owner APPROVED"
+    echo "  → Phase complete, proceeding to next phase"
+    echo ""
+    ;;
+
+  LOOP)
+    echo "↻ Product Owner requested LOOP"
+    echo "  → Returning to Loop 3 with updated requirements"
+    echo ""
+    exit 1
+    ;;
+
+  DEFER)
+    echo "⊗ Product Owner DEFERRED items to backlog"
+    echo "  → Proceeding with reduced scope"
+    echo ""
+    ;;
+
+  ESCALATE)
+    echo "⚠ Product Owner ESCALATED to human"
+    echo "  → Critical blockers require manual review"
+    echo ""
+    exit 2
+    ;;
+esac
+
+# ============================================================================
+# SUCCESS: Phase Complete
+# ============================================================================
+
+echo "╔════════════════════════════════════════════════════════════╗"
+echo "║                  PHASE COMPLETE - SUCCESS                  ║"
+echo "╚════════════════════════════════════════════════════════════╝"
+echo ""
+echo "Summary:"
+echo "  Task: $TASK_ID"
+echo "  Mode: $CFN_MODE"
+echo "  Loop 3 Iterations: $LOOP3_ITERATION"
+echo "  Loop 2 Iterations: $LOOP2_ITERATION"
+echo "  Final Confidence: $AGENT_CONFIDENCE"
+echo "  Final Consensus: $CONSENSUS_SCORE"
+echo "  Product Owner: $PO_DECISION ($PO_CONFIDENCE confidence)"
+echo ""
+echo "Next Action: Proceed to next phase or deployment"
+
+exit 0

package/claude-assets/skills/cfn-loop-validation/examples/coordinator-loop2-consensus.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# Example: Loop 2 Consensus Validation
+#
+# Scenario: Coordinator validates consensus from validator swarm
+# Use Case: Validators (reviewer, security, tester, analyst) complete review,
+#           coordinator checks if consensus is strong enough for product owner
+##############################################################################
+
+set -euo pipefail
+
+# Get script directory for relative path to validator
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VALIDATOR="${SCRIPT_DIR}/.claude/skills/cfn-cfn-validate-iteration.sh"
+
+# Configuration
+MODE="enterprise"
+TASK_ID="compliance-gdpr-implementation"
+AGENT_ID="coordinator-loop2"
+
+echo "=== Loop 2: Consensus Validation ==="
+echo "Task: $TASK_ID"
+echo "Mode: $MODE"
+echo ""
+
+# Simulated validator execution
+echo "Spawning validator swarm..."
+echo "  - Validator 1: reviewer (confidence: 0.92)"
+echo "  - Validator 2: security-specialist (confidence: 0.95)"
+echo "  - Validator 3: tester (confidence: 0.88)"
+echo "  - Validator 4: analyst (confidence: 0.91)"
+echo "  - Validator 5: architect (confidence: 0.93)"
+echo ""
+
+sleep 1
+
+# Aggregate scores from validators
+AGENT_CONFIDENCE=0.918  # Average of validator confidences
+CONSENSUS_SCORE=0.952   # Byzantine consensus algorithm result
+
+echo "Consensus Results:"
+echo "  Average Confidence: $AGENT_CONFIDENCE"
+echo "  Consensus Score: $CONSENSUS_SCORE"
+echo ""
+
+# Validate consensus
+echo "=== Validating Loop 2 Consensus Threshold ==="
+ITERATION=1
+
+VALIDATION_RESULT=$("$VALIDATOR" \
+  --mode "$MODE" \
+  --iteration "$ITERATION" \
+  --confidence "$AGENT_CONFIDENCE" \
+  --consensus "$CONSENSUS_SCORE" \
+  --task-id "$TASK_ID" \
+  --agent-id "$AGENT_ID" \
+  --json)
+
+# Parse validation result
+PASSED=$(echo "$VALIDATION_RESULT" | jq -r '.passed')
+STATUS=$(echo "$VALIDATION_RESULT" | jq -r '.status')
+VALIDATION_TYPE=$(echo "$VALIDATION_RESULT" | jq -r '.validationType')
+THRESHOLD=$(echo "$VALIDATION_RESULT" | jq -r '.threshold')
+CODE=$(echo "$VALIDATION_RESULT" | jq -r '.code')
+
+echo ""
+echo "Validation Result:"
+echo "  Type: $VALIDATION_TYPE"
+echo "  Status: $STATUS"
+echo "  Passed: $PASSED"
+echo "  Consensus: $CONSENSUS_SCORE"
+echo "  Threshold: $THRESHOLD"
+echo "  Exit Code: $CODE"
+echo ""
+
+# Decision logic
+case "$CODE" in
+  0)
+    echo "✓ Consensus ACHIEVED"
+    echo "  → Proceeding to Loop 4 (Product Owner Decision Gate)"
+    echo ""
+
+    echo "Next Action: Invoke product owner decision"
+    echo "  - Enterprise mode: Stakeholder board decision"
+    echo "  - CTO vote (weight: 0.35)"
+    echo "  - Product Owner vote (weight: 0.30)"
+    echo "  - User Power vote (weight: 0.20)"
+    echo "  - User Accessibility vote (weight: 0.15)"
+
+    # Example: Invoke product owner team decision
+    # The board will decide: PROCEED | LOOP | DEFER | ESCALATE
+
+    exit 0
+    ;;
+
+  1)
+    echo "✗ Consensus BELOW THRESHOLD"
+    echo "  → Retrying validators with targeted feedback"
+    echo ""
+
+    # Analyze which validators had low confidence
+    echo "Analysis: Validators with concerns"
+    echo "  - tester: 0.88 (concerns about edge cases)"
+    echo ""
+
+    echo "Feedback injection strategy:"
+    echo "  1. Add edge case tests for identified gaps"
+    echo "  2. Re-run tester validator with enhanced test suite"
+    echo "  3. Validate consensus again"
+
+    exit 1
+    ;;
+
+  2)
+    echo "✗ MAX ITERATIONS REACHED"
+    echo "  → Escalating to human review"
+    echo ""
+
+    echo "Escalation reason:"
+    echo "  - Unable to achieve consensus after $ITERATION attempts"
+    echo "  - Fundamental disagreement among validators"
+    echo "  - Requires human architectural decision"
+
+    exit 2
+    ;;
+
+  *)
+    echo "Unexpected error: Code $CODE"
+    exit "$CODE"
+    ;;
+esac

package/claude-assets/skills/cfn-loop-validation/examples/coordinator-loop3-gate.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# Example: Loop 3 Confidence Gate Validation
+#
+# Scenario: Coordinator validates agent confidence before proceeding to Loop 2
+# Use Case: Primary swarm (coder, tester) completes work, coordinator checks
+#           if confidence is high enough to spawn validators
+##############################################################################
+
+set -euo pipefail
+
+# Get script directory for relative path to validator
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VALIDATOR="${SCRIPT_DIR}/.claude/skills/cfn-cfn-validate-iteration.sh"
+
+# Configuration
+MODE="standard"
+TASK_ID="feature-user-authentication"
+AGENT_ID="coordinator-loop3"
+
+# Simulated agent execution with confidence score
+echo "=== Loop 3: Primary Swarm Execution ==="
+echo "Task: $TASK_ID"
+echo "Mode: $MODE"
+echo ""
+
+# Simulate agent work (in real scenario, this would be actual agent execution)
+echo "Executing primary swarm (coder + tester)..."
+sleep 1
+
+# Agent self-assessment confidence score (from agent's own evaluation)
+AGENT_CONFIDENCE=0.85
+echo "Agent reported confidence: $AGENT_CONFIDENCE"
+echo ""
+
+# Validate confidence gate
+echo "=== Validating Loop 3 Confidence Gate ==="
+ITERATION=1
+
+VALIDATION_RESULT=$("$VALIDATOR" \
+  --mode "$MODE" \
+  --iteration "$ITERATION" \
+  --confidence "$AGENT_CONFIDENCE" \
+  --task-id "$TASK_ID" \
+  --agent-id "$AGENT_ID" \
+  --json)
+
+# Parse validation result
+PASSED=$(echo "$VALIDATION_RESULT" | jq -r '.passed')
+STATUS=$(echo "$VALIDATION_RESULT" | jq -r '.status')
+THRESHOLD=$(echo "$VALIDATION_RESULT" | jq -r '.threshold')
+CODE=$(echo "$VALIDATION_RESULT" | jq -r '.code')
+
+echo ""
+echo "Validation Result:"
+echo "  Status: $STATUS"
+echo "  Passed: $PASSED"
+echo "  Confidence: $AGENT_CONFIDENCE"
+echo "  Threshold: $THRESHOLD"
+echo "  Exit Code: $CODE"
+echo ""
+
+# Decision logic based on validation
+if [[ "$PASSED" == "true" ]]; then
+  echo "✓ Confidence gate PASSED"
+  echo "  → Proceeding to Loop 2 (spawning validators)"
+  echo ""
+
+  # Next step: Spawn validator swarm for consensus
+  echo "Next Action: Spawn validators for consensus validation"
+  # Example: npx claude-flow-novice swarm "validate feature-user-authentication" \
+  #   --agents reviewer,security-specialist,tester,analyst
+
+  exit 0
+
+else
+  echo "✗ Confidence gate FAILED"
+  echo "  → Status: $STATUS"
+  echo ""
+
+  case "$CODE" in
+    1)
+      echo "Reason: Confidence below threshold"
+      echo "Action: Injecting feedback and retrying Loop 3"
+      echo ""
+
+      # Extract feedback from agent reasoning
+      echo "Suggested improvements:"
+      echo "  - Review agent's reasoning for low confidence"
+      echo "  - Inject targeted feedback"
+      echo "  - Retry primary swarm execution"
+
+      exit 1
+      ;;
+
+    2)
+      echo "Reason: Maximum iterations exceeded"
+      echo "Action: Escalating to human review"
+      echo ""
+
+      echo "Escalation details:"
+      echo "  - Task attempted $ITERATION times"
+      echo "  - Confidence never reached threshold"
+      echo "  - Manual intervention required"
+
+      exit 2
+      ;;
+
+    *)
+      echo "Unexpected error: Code $CODE"
+      exit "$CODE"
+      ;;
+  esac
+fi

package/claude-assets/skills/cfn-loop-validation/examples/coordinator-redis-integration.sh

@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# Example: Redis Integration for Async Validation
+#
+# Scenario: Coordinator publishes validation results to Redis for distributed
+#           agent coordination and event-driven workflows
+##############################################################################
+
+set -euo pipefail
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VALIDATOR="${SCRIPT_DIR}/.claude/skills/cfn-cfn-validate-iteration.sh"
+
+# Configuration
+TASK_ID="distributed-task-microservices"
+MODE="enterprise"
+ITERATION=2
+CONFIDENCE=0.88
+CONSENSUS=0.94
+AGENT_ID="coordinator-redis"
+
+# Redis configuration
+REDIS_HOST="${REDIS_HOST:-localhost}"
+REDIS_PORT="${REDIS_PORT:-6379}"
+REDIS_VALIDATION_LIST="cfn:validation:${TASK_ID}"
+REDIS_EVENT_CHANNEL="cfn:events"
+
+echo "═══════════════════════════════════════════════════════════"
+echo "  CFN Loop Validation with Redis Integration"
+echo "═══════════════════════════════════════════════════════════"
+echo ""
+echo "Task: $TASK_ID"
+echo "Mode: $MODE"
+echo "Iteration: $ITERATION"
+echo "Redis: ${REDIS_HOST}:${REDIS_PORT}"
+echo ""
+
+# Check Redis connectivity
+echo "Checking Redis connectivity..."
+if command -v redis-cli &>/dev/null; then
+  if redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" ping &>/dev/null; then
+    echo "✓ Redis connection successful"
+  else
+    echo "✗ Redis connection failed"
+    echo "  Continuing without Redis persistence (validation only)"
+  fi
+else
+  echo "⚠ redis-cli not found"
+  echo "  Install: sudo apt-get install redis-tools"
+  echo "  Continuing without Redis persistence (validation only)"
+fi
+echo ""
+
+# Run validation
+echo "Running CFN Loop validation..."
+VALIDATION_RESULT=$("$VALIDATOR" \
+  --mode "$MODE" \
+  --iteration "$ITERATION" \
+  --confidence "$CONFIDENCE" \
+  --consensus "$CONSENSUS" \
+  --task-id "$TASK_ID" \
+  --agent-id "$AGENT_ID" \
+  --json)
+
+# Parse result
+PASSED=$(echo "$VALIDATION_RESULT" | jq -r '.passed')
+STATUS=$(echo "$VALIDATION_RESULT" | jq -r '.status')
+CODE=$(echo "$VALIDATION_RESULT" | jq -r '.code')
+
+echo "Validation Result:"
+echo "  Status: $STATUS"
+echo "  Passed: $PASSED"
+echo "  Code: $CODE"
+echo ""
+
+# Publish to Redis (if available)
+if command -v redis-cli &>/dev/null && \
+   redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" ping &>/dev/null; then
+
+  echo "Publishing validation result to Redis..."
+
+  # 1. Store full validation result in list
+  redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" lpush "$REDIS_VALIDATION_LIST" "$VALIDATION_RESULT" >/dev/null
+  echo "✓ Stored in list: $REDIS_VALIDATION_LIST"
+
+  # 2. Set validation status with TTL (1 hour)
+  redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" setex \
+    "cfn:validation:${TASK_ID}:status" 3600 "$STATUS" >/dev/null
+  echo "✓ Set status key (TTL: 1 hour)"
+
+  # 3. Publish event to channel
+  if [[ "$PASSED" == "true" ]]; then
+    EVENT_PAYLOAD=$(jq -n \
+      --arg type "validation_passed" \
+      --arg taskId "$TASK_ID" \
+      --arg mode "$MODE" \
+      --argjson iteration "$ITERATION" \
+      --argjson confidence "$CONFIDENCE" \
+      --argjson consensus "$CONSENSUS" \
+      '{
+        type: $type,
+        taskId: $taskId,
+        mode: $mode,
+        iteration: $iteration,
+        confidence: $confidence,
+        consensus: $consensus,
+        timestamp: now
+      }')
+
+    redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" publish "$REDIS_EVENT_CHANNEL" "$EVENT_PAYLOAD" >/dev/null
+    echo "✓ Published event: validation_passed"
+
+  else
+    EVENT_PAYLOAD=$(jq -n \
+      --arg type "validation_failed" \
+      --arg taskId "$TASK_ID" \
+      --arg mode "$MODE" \
+      --arg status "$STATUS" \
+      --argjson code "$CODE" \
+      '{
+        type: $type,
+        taskId: $taskId,
+        mode: $mode,
+        status: $status,
+        code: $code,
+        timestamp: now
+      }')
+
+    redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" publish "$REDIS_EVENT_CHANNEL" "$EVENT_PAYLOAD" >/dev/null
+    echo "✓ Published event: validation_failed"
+  fi
+
+  # 4. Update task metadata
+  redis-cli -h "$REDIS_HOST" -p "$REDIS_PORT" hset \
+    "cfn:task:${TASK_ID}:metadata" \
+    "last_validation_status" "$STATUS" \
+    "last_validation_timestamp" "$(date +%s)" \
+    "validation_iteration" "$ITERATION" >/dev/null
+  echo "✓ Updated task metadata"
+
+  echo ""
+  echo "Redis Integration Summary:"
+  echo "  List: $REDIS_VALIDATION_LIST (validation history)"
+  echo "  Key: cfn:validation:${TASK_ID}:status (current status)"
+  echo "  Channel: $REDIS_EVENT_CHANNEL (event stream)"
+  echo "  Hash: cfn:task:${TASK_ID}:metadata (task metadata)"
+  echo ""
+
+  # Example: Other agents can listen for events
+  echo "Other agents can subscribe to events:"
+  echo "  redis-cli -h $REDIS_HOST -p $REDIS_PORT subscribe $REDIS_EVENT_CHANNEL"
+  echo ""
+
+  echo "Query validation history:"
+  echo "  redis-cli -h $REDIS_HOST -p $REDIS_PORT lrange $REDIS_VALIDATION_LIST 0 -1"
+  echo ""
+
+fi
+
+# Decision logic based on validation
+case "$CODE" in
+  0)
+    echo "✓ VALIDATION PASSED"
+    echo "  → Proceeding to next phase"
+    exit 0
+    ;;
+
+  1)
+    echo "✗ VALIDATION FAILED"
+    echo "  → Retrying with feedback"
+    exit 1
+    ;;
+
+  2)
+    echo "✗ MAX ITERATIONS EXCEEDED"
+    echo "  → Escalating to human"
+    exit 2
+    ;;
+
+  *)
+    echo "✗ UNEXPECTED ERROR"
+    exit "$CODE"
+    ;;
+esac