claude-flow-novice 2.18.5 → 2.18.6

package/.claude/skills/cfn-loop-orchestration-v2/lib/validation/detect-vapor.sh.backup

@@ -0,0 +1,37 @@
+#!/bin/bash
+
+##############################################################################
+# Detect Consensus on Vapor - TypeScript Wrapper
+#
+# Detects when agents claim completion but deliverables are missing.
+#
+# Usage:
+#   ./detect-vapor.sh --output "agent_output.txt" --deliverables file1.js,file2.js [--json]
+#   ./detect-vapor.sh --output "Completed the task" --deliverables file1.js,file2.js [--json]
+#
+# Returns JSON with vapor detection result
+# Exit codes:
+#   0 - No vapor detected
+#   1 - Vapor detected
+##############################################################################
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TS_DIST="$SCRIPT_DIR/dist/cli/detect-vapor.js"
+
+# Check if TypeScript implementation exists
+if [ ! -f "$TS_DIST" ]; then
+  echo "Error: TypeScript implementation not found at: $TS_DIST" >&2
+  echo "Run 'npm run build' in $SCRIPT_DIR" >&2
+  exit 1
+fi
+
+# Check if node is available
+if ! command -v node &>/dev/null; then
+  echo "Error: Node.js is required but not found in PATH" >&2
+  exit 1
+fi
+
+# Execute TypeScript implementation
+exec node "$TS_DIST" "$@"

package/.claude/skills/cfn-loop-orchestration-v2/lib/validation/evidence-chain.sql

@@ -0,0 +1,163 @@
+-- CFN Loop Validation Evidence Chain Schema
+-- SQLite database schema for storing validation results and audit trails
+
+-- Main validation runs table
+CREATE TABLE IF NOT EXISTS validation_runs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    run_id TEXT NOT NULL UNIQUE,
+    template_id TEXT NOT NULL,
+    template_version TEXT NOT NULL,
+    validation_mode TEXT NOT NULL CHECK (validation_mode IN ('mvp', 'standard', 'enterprise')),
+    status TEXT NOT NULL CHECK (status IN ('pending', 'running', 'completed', 'failed', 'retrying')),
+    start_time INTEGER NOT NULL,
+    end_time INTEGER,
+    consensus_score REAL,
+    consensus_threshold REAL,
+    validator_count INTEGER,
+    max_retries INTEGER,
+    retry_count INTEGER DEFAULT 0,
+    error_message TEXT,
+    created_at INTEGER DEFAULT (strftime('%s', 'now'))
+);
+
+-- Individual validator results table
+CREATE TABLE IF NOT EXISTS validator_results (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    run_id TEXT NOT NULL,
+    validator_id TEXT NOT NULL,
+    validator_type TEXT NOT NULL,
+    score REAL NOT NULL CHECK (score >= 0 AND score <= 1),
+    execution_time INTEGER NOT NULL,
+    status TEXT NOT NULL CHECK (status IN ('success', 'failed', 'timeout', 'error')),
+    error_message TEXT,
+    metadata TEXT, -- JSON blob for additional data
+    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+    FOREIGN KEY (run_id) REFERENCES validation_runs(run_id) ON DELETE CASCADE
+);
+
+-- Evidence chain table for detailed validation steps
+CREATE TABLE IF NOT EXISTS evidence_chain (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    run_id TEXT NOT NULL,
+    step_type TEXT NOT NULL,
+    step_order INTEGER NOT NULL,
+    validator_id TEXT,
+    input_data TEXT, -- JSON blob
+    output_data TEXT, -- JSON blob
+    validation_result TEXT, -- JSON blob
+    timestamp INTEGER NOT NULL,
+    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+    FOREIGN KEY (run_id) REFERENCES validation_runs(run_id) ON DELETE CASCADE
+);
+
+-- Retry log table for tracking retry attempts
+CREATE TABLE IF NOT EXISTS retry_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    run_id TEXT NOT NULL,
+    attempt_number INTEGER NOT NULL,
+    delay_ms INTEGER NOT NULL,
+    reason TEXT NOT NULL,
+    consensus_score REAL,
+    validator_count INTEGER,
+    timestamp INTEGER NOT NULL,
+    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+    FOREIGN KEY (run_id) REFERENCES validation_runs(run_id) ON DELETE CASCADE
+);
+
+-- Performance metrics table
+CREATE TABLE IF NOT EXISTS performance_metrics (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    run_id TEXT NOT NULL,
+    metric_name TEXT NOT NULL,
+    metric_value REAL NOT NULL,
+    unit TEXT NOT NULL,
+    timestamp INTEGER NOT NULL,
+    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+    FOREIGN KEY (run_id) REFERENCES validation_runs(run_id) ON DELETE CASCADE
+);
+
+-- Error tracking table
+CREATE TABLE IF NOT EXISTS error_tracking (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    run_id TEXT NOT NULL,
+    error_type TEXT NOT NULL,
+    error_message TEXT NOT NULL,
+    stack_trace TEXT,
+    validator_id TEXT,
+    timestamp INTEGER NOT NULL,
+    created_at INTEGER DEFAULT (strftime('%s', 'now')),
+    FOREIGN KEY (run_id) REFERENCES validation_runs(run_id) ON DELETE CASCADE
+);
+
+-- Indexes for performance optimization
+CREATE INDEX IF NOT EXISTS idx_validation_runs_status ON validation_runs(status);
+CREATE INDEX IF NOT EXISTS idx_validation_runs_mode ON validation_runs(validation_mode);
+CREATE INDEX IF NOT EXISTS idx_validation_runs_created_at ON validation_runs(created_at);
+CREATE INDEX IF NOT EXISTS idx_validator_results_run_id ON validator_results(run_id);
+CREATE INDEX IF NOT EXISTS idx_validator_results_validator_id ON validator_results(validator_id);
+CREATE INDEX IF NOT EXISTS idx_validator_results_created_at ON validator_results(created_at);
+CREATE INDEX IF NOT EXISTS idx_evidence_chain_run_id ON evidence_chain(run_id);
+CREATE INDEX IF NOT EXISTS idx_evidence_chain_timestamp ON evidence_chain(timestamp);
+CREATE INDEX IF NOT EXISTS idx_retry_log_run_id ON retry_log(run_id);
+CREATE INDEX IF NOT EXISTS idx_performance_metrics_run_id ON performance_metrics(run_id);
+CREATE INDEX IF NOT EXISTS idx_error_tracking_run_id ON error_tracking(run_id);
+
+-- View for completed validation runs
+CREATE VIEW IF NOT EXISTS completed_validation_runs AS
+SELECT 
+    vr.run_id,
+    vr.template_id,
+    vr.template_version,
+    vr.validation_mode,
+    vr.status,
+    vr.start_time,
+    vr.end_time,
+    vr.consensus_score,
+    vr.consensus_threshold,
+    vr.validator_count,
+    vr.error_message,
+    (vr.end_time - vr.start_time) as duration_ms,
+    COUNT(vr.id) as total_validators,
+    SUM(CASE WHEN vrs.status = 'success' THEN 1 ELSE 0 END) as successful_validators,
+    AVG(vrs.score) as average_score
+FROM validation_runs vr
+LEFT JOIN validator_results vrs ON vr.run_id = vrs.run_id
+WHERE vr.status = 'completed'
+GROUP BY vr.run_id, vr.template_id, vr.template_version, vr.validation_mode, vr.status;
+
+-- View for retry statistics
+CREATE VIEW IF NOT EXISTS retry_statistics AS
+SELECT 
+    rl.run_id,
+    vr.template_id,
+    vr.validation_mode,
+    COUNT(rl.id) as total_retries,
+    MAX(rl.attempt_number) as max_attempt,
+    AVG(rl.delay_ms) as avg_delay_ms,
+    MIN(rl.consensus_score) as min_consensus_score,
+    MAX(rl.consensus_score) as max_consensus_score
+FROM retry_log rl
+JOIN validation_runs vr ON rl.run_id = vr.run_id
+GROUP BY rl.run_id, vr.template_id, vr.validation_mode;
+
+-- Trigger to cleanup old records (optional - uncomment if needed)
+-- CREATE TRIGGER IF NOT EXISTS cleanup_old_records 
+-- AFTER INSERT ON validation_runs
+-- FOR EACH ROW
+-- BEGIN
+--     DELETE FROM validator_results WHERE run_id IN (
+--         SELECT run_id FROM validation_runs WHERE created_at < strftime('%s', 'now') - 2592000 -- 30 days
+--     );
+--     DELETE FROM evidence_chain WHERE run_id IN (
+--         SELECT run_id FROM validation_runs WHERE created_at < strftime('%s', 'now') - 2592000
+--     );
+--     DELETE FROM retry_log WHERE run_id IN (
+--         SELECT run_id FROM validation_runs WHERE created_at < strftime('%s', 'now') - 2592000
+--     );
+--     DELETE FROM performance_metrics WHERE run_id IN (
+--         SELECT run_id FROM validation_runs WHERE created_at < strftime('%s', 'now') - 2592000
+--     );
+--     DELETE FROM error_tracking WHERE run_id IN (
+--         SELECT run_id FROM validation_runs WHERE created_at < strftime('%s', 'now') - 2592000
+--     );
+-- END;

package/.claude/skills/cfn-loop-orchestration-v2/lib/validation/index.ts

@@ -0,0 +1,12 @@
+/**
+ * CFN Loop Validation Module Index
+ */
+
+export { ValidationFramework, CommonRules } from './validation-framework';
+export type {
+  ValidationRule,
+  ValidationResult,
+  ValidationLayer,
+  ValidationReport,
+  LayerResult
+} from './validation-framework';

package/.claude/skills/cfn-loop-orchestration-v2/lib/validation/orchestrate-cfn-loop.sh

@@ -0,0 +1,274 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# ⚠️  DEPRECATED - This bash script is deprecated
+#
+# Deprecation Date: 2025-11-20
+# Removal Date: 2026-02-20 (90 days)
+# Replacement: dist/validator.js
+#
+# This script will be removed in 90 days. Please migrate to TypeScript.
+#
+# Migration Guide: See docs/BASH_DEPRECATION_NOTICE.md
+# TypeScript Benefits:
+#   - Type safety (zero runtime type errors)
+#   - 90%+ test coverage
+#   - Better performance
+#   - Comprehensive documentation
+#
+# Automatic Migration:
+#   Set USE_TYPESCRIPT=true to use TypeScript implementation automatically
+#
+##############################################################################
+
+
+##############################################################################
+# CFN Loop Orchestration v1.0.0
+# Manages multi-loop CFN execution with dependency tracking and consensus
+#
+# Usage:
+#   ./orchestrate-cfn-loop.sh --task-id <id> \
+#                             --mode <mvp|standard|enterprise> \
+#                             --loop3-agents <agent1,agent2,...> \
+#                             --loop2-agents <agent1,agent2,...> \
+#                             --product-owner <agent-id> \
+#                             [--max-iterations <n>]
+#
+# CFN Loop Structure:
+#   Loop 3 (Primary Swarm) → Loop 2 (Consensus) → Product Owner Decision
+#
+# Dependency Enforcement:
+#   - Loop 2 agents BLOCK until all Loop 3 agents signal completion
+#   - Product Owner BLOCKS until all Loop 2 agents signal completion
+#   - Uses Redis BLPOP for zero-token waiting
+##############################################################################
+
+set -euo pipefail
+
+# Configuration
+TASK_ID=""
+MODE="standard"
+LOOP3_AGENTS=""
+LOOP2_AGENTS=""
+PRODUCT_OWNER=""
+MAX_ITERATIONS=10
+TIMEOUT=3600  # 1 hour timeout for agent completion
+
+# Thresholds by mode
+declare -A GATE_THRESHOLD=(
+  [mvp]=0.70
+  [standard]=0.75
+  [enterprise]=0.75
+)
+
+declare -A CONSENSUS_THRESHOLD=(
+  [mvp]=0.80
+  [standard]=0.90
+  [enterprise]=0.95
+)
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --task-id)
+      TASK_ID="$2"
+      shift 2
+      ;;
+    --mode)
+      MODE="$2"
+      shift 2
+      ;;
+    --loop3-agents)
+      LOOP3_AGENTS="$2"
+      shift 2
+      ;;
+    --loop2-agents)
+      LOOP2_AGENTS="$2"
+      shift 2
+      ;;
+    --product-owner)
+      PRODUCT_OWNER="$2"
+      shift 2
+      ;;
+    --max-iterations)
+      MAX_ITERATIONS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown option: $1"
+      exit 1
+      ;;
+  esac
+done
+
+# Validation
+if [ -z "$TASK_ID" ] || [ -z "$LOOP3_AGENTS" ] || [ -z "$LOOP2_AGENTS" ] || [ -z "$PRODUCT_OWNER" ]; then
+  echo "Error: Required parameters missing"
+  echo "Usage: $0 --task-id <id> --mode <mode> --loop3-agents <agents> --loop2-agents <agents> --product-owner <agent>"
+  exit 1
+fi
+
+GATE=${GATE_THRESHOLD[$MODE]}
+CONSENSUS=${CONSENSUS_THRESHOLD[$MODE]}
+
+echo "=== CFN Loop Orchestration ==="
+echo "Task ID: $TASK_ID"
+echo "Mode: $MODE (Gate: $GATE, Consensus: $CONSENSUS)"
+echo "Max Iterations: $MAX_ITERATIONS"
+echo ""
+
+# Iteration loop
+for ITERATION in $(seq 1 $MAX_ITERATIONS); do
+  echo "=== Iteration $ITERATION/$MAX_ITERATIONS ==="
+
+  # Step 1: Wait for Loop 3 agents to complete
+  echo "[Loop 3] Waiting for implementers to complete..."
+  IFS=',' read -ra AGENTS <<< "$LOOP3_AGENTS"
+
+  for AGENT in "${AGENTS[@]}"; do
+    DONE_KEY="swarm:${TASK_ID}:${AGENT}:done"
+    echo "  Waiting for $AGENT..."
+
+    # BLPOP with timeout (blocks until agent signals done)
+    RESULT=$(timeout $TIMEOUT redis-cli blpop "$DONE_KEY" 0 2>/dev/null || echo "")
+
+    if [ -z "$RESULT" ]; then
+      echo "  ❌ ERROR: $AGENT timeout after ${TIMEOUT}s"
+      exit 1
+    fi
+
+    echo "  ✅ $AGENT complete"
+  done
+
+  echo "[Loop 3] All implementers complete!"
+  echo ""
+
+  # Step 2: Collect Loop 3 confidence scores
+  echo "[Loop 3] Collecting confidence scores..."
+  LOOP3_CONSENSUS=$(./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh collect \
+    --task-id "$TASK_ID" \
+    --agent-ids "$LOOP3_AGENTS" | tail -1)
+
+  echo "[Loop 3] Average confidence: $LOOP3_CONSENSUS"
+
+  # Gate check
+  if (( $(echo "$LOOP3_CONSENSUS < $GATE" | bc -l) )); then
+    echo "❌ Gate FAILED ($LOOP3_CONSENSUS < $GATE)"
+    echo "Decision: RELAUNCH iteration $((ITERATION + 1))"
+
+    # Wake Loop 3 agents for next iteration
+    IFS=',' read -ra AGENTS <<< "$LOOP3_AGENTS"
+    for AGENT in "${AGENTS[@]}"; do
+      ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh wake \
+        --task-id "$TASK_ID" \
+        --agent-id "$AGENT" \
+        --reason "gate_failed" \
+        --iteration $((ITERATION + 1)) \
+        --feedback "Improve confidence from $LOOP3_CONSENSUS to >$GATE"
+    done
+
+    continue  # Next iteration
+  fi
+
+  echo "✅ Gate PASSED ($LOOP3_CONSENSUS >= $GATE)"
+  echo ""
+
+  # Step 3: Wait for Loop 2 validators to complete
+  echo "[Loop 2] Waiting for validators to complete..."
+  IFS=',' read -ra VALIDATORS <<< "$LOOP2_AGENTS"
+
+  for VALIDATOR in "${VALIDATORS[@]}"; do
+    DONE_KEY="swarm:${TASK_ID}:${VALIDATOR}:done"
+    echo "  Waiting for $VALIDATOR..."
+
+    RESULT=$(timeout $TIMEOUT redis-cli blpop "$DONE_KEY" 0 2>/dev/null || echo "")
+
+    if [ -z "$RESULT" ]; then
+      echo "  ❌ ERROR: $VALIDATOR timeout after ${TIMEOUT}s"
+      exit 1
+    fi
+
+    echo "  ✅ $VALIDATOR complete"
+  done
+
+  echo "[Loop 2] All validators complete!"
+  echo ""
+
+  # Step 4: Collect Loop 2 consensus scores
+  echo "[Loop 2] Collecting consensus scores..."
+  LOOP2_CONSENSUS=$(./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh collect \
+    --task-id "$TASK_ID" \
+    --agent-ids "$LOOP2_AGENTS" | tail -1)
+
+  echo "[Loop 2] Average consensus: $LOOP2_CONSENSUS"
+
+  # Consensus check
+  if (( $(echo "$LOOP2_CONSENSUS >= $CONSENSUS" | bc -l) )); then
+    echo "✅ CONSENSUS REACHED ($LOOP2_CONSENSUS >= $CONSENSUS)"
+    echo ""
+
+    # Signal Product Owner that consensus is ready
+    DECISION_KEY="swarm:${TASK_ID}:${PRODUCT_OWNER}:consensus-ready"
+    redis-cli lpush "$DECISION_KEY" "{\"iteration\": $ITERATION, \"consensus\": $LOOP2_CONSENSUS}" > /dev/null
+
+    # Wait for Product Owner decision
+    echo "[Product Owner] Waiting for GOAP decision..."
+    DECISION_KEY="swarm:${TASK_ID}:${PRODUCT_OWNER}:decision"
+    DECISION=$(timeout $TIMEOUT redis-cli blpop "$DECISION_KEY" 0 2>/dev/null | tail -1)
+
+    if [ -z "$DECISION" ]; then
+      echo "❌ ERROR: Product Owner timeout"
+      exit 1
+    fi
+
+    DECISION_TYPE=$(echo "$DECISION" | jq -r '.decision')
+
+    echo "[Product Owner] Decision: $DECISION_TYPE"
+
+    if [ "$DECISION_TYPE" = "PROCEED" ]; then
+      echo ""
+      echo "🎉 CFN Loop Complete!"
+      echo "Final Consensus: $LOOP2_CONSENSUS (Iteration $ITERATION)"
+
+      # Wake all agents with completion signal
+      IFS=',' read -ra ALL_AGENTS <<< "$LOOP3_AGENTS,$LOOP2_AGENTS"
+      for AGENT in "${ALL_AGENTS[@]}"; do
+        ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh wake \
+          --task-id "$TASK_ID" \
+          --agent-id "$AGENT" \
+          --reason "cfn_complete" \
+          --iteration "$ITERATION"
+      done
+
+      exit 0
+    fi
+
+  else
+    echo "⚠️ CONSENSUS NOT REACHED ($LOOP2_CONSENSUS < $CONSENSUS)"
+    echo "Decision: RELAUNCH iteration $((ITERATION + 1))"
+    echo ""
+  fi
+
+  # Relaunch next iteration
+  if [ $ITERATION -eq $MAX_ITERATIONS ]; then
+    echo "❌ Maximum iterations ($MAX_ITERATIONS) reached without consensus"
+    exit 1
+  fi
+
+  # Wake all agents for next iteration
+  echo "[Coordinator] Waking agents for iteration $((ITERATION + 1))..."
+  IFS=',' read -ra ALL_AGENTS <<< "$LOOP3_AGENTS,$LOOP2_AGENTS"
+  for AGENT in "${ALL_AGENTS[@]}"; do
+    ./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh wake \
+      --task-id "$TASK_ID" \
+      --agent-id "$AGENT" \
+      --reason "cfn_loop_iteration" \
+      --iteration $((ITERATION + 1)) \
+      --feedback "Improve consensus from $LOOP2_CONSENSUS to >=$CONSENSUS"
+  done
+
+  echo ""
+done
+
+echo "❌ CFN Loop failed after $MAX_ITERATIONS iterations"
+exit 1