claude-flow-novice 2.14.3 → 2.14.5

package/claude-assets/skills/seo-orchestration/validate-consensus.sh

@@ -0,0 +1,270 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# SEO Consensus Validation Script
+# Version: 1.0.0
+#
+# Validates SEO consensus scores against thresholds and quorum requirements.
+# Used to determine if SEO optimizations meet quality standards.
+##############################################################################
+
+set -euo pipefail
+
+# Configuration
+TASK_ID=""
+AGENTS=""
+THRESHOLD="0.80"
+MIN_QUORUM="0.66"
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+# Logging
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] SEO-VALIDATE-CONSENSUS: $*" >&2
+}
+
+error() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] SEO-VALIDATE-CONSENSUS ERROR: $*" >&2
+  exit 1
+}
+
+# Display usage
+usage() {
+  cat << EOF
+SEO Consensus Validation
+
+Usage: $0 [OPTIONS]
+
+Required Options:
+  --task-id <id>          Unique identifier for SEO task
+  --agents <agents>       Comma-separated list of SEO agent IDs
+  --threshold <value>     Minimum confidence threshold (0.0-1.0)
+  --min-quorum <value>    Minimum quorum (n, n%, or 0.n format)
+
+Optional Options:
+  --help                  Show this help message
+
+Examples:
+  $0 --task-id seo-001 --agents seo-analyst,content-writer --threshold 0.75 --min-quorum 0.66
+
+EOF
+}
+
+# Parse command line arguments
+parse_args() {
+  while [[ $# -gt 0 ]]; do
+    case $1 in
+      --task-id)
+        TASK_ID="$2"
+        shift 2
+        ;;
+      --agents)
+        AGENTS="$2"
+        shift 2
+        ;;
+      --threshold)
+        THRESHOLD="$2"
+        shift 2
+        ;;
+      --min-quorum)
+        MIN_QUORUM="$2"
+        shift 2
+        ;;
+      --help)
+        usage
+        exit 0
+        ;;
+      *)
+        error "Unknown option: $1. Use --help for usage information."
+        ;;
+    esac
+  done
+}
+
+# Validate inputs
+validate_inputs() {
+  [[ -z "$TASK_ID" ]] && error "Task ID is required"
+  [[ -z "$AGENTS" ]] && error "Agents list is required"
+  [[ -z "$THRESHOLD" ]] && error "Threshold is required"
+  [[ -z "$MIN_QUORUM" ]] && error "Min quorum is required"
+  
+  # Validate threshold
+  if ! [[ "$THRESHOLD" =~ ^[0-9]*\.?[0-9]+$ ]]; then
+    error "Threshold must be a numeric value between 0.0 and 1.0"
+  fi
+  
+  local threshold_float
+  threshold_float=$(echo "$THRESHOLD" | bc -l 2>/dev/null || echo "0")
+  if [[ $(echo "$threshold_float < 0 || $threshold_float > 1" | bc -l) -eq 1 ]]; then
+    error "Threshold must be between 0.0 and 1.0"
+  fi
+  
+  # Check Redis connectivity
+  if ! command -v redis-cli &> /dev/null; then
+    error "redis-cli is required but not installed"
+  fi
+  
+  if ! redis-cli ping &> /dev/null; then
+    error "Cannot connect to Redis server"
+  fi
+}
+
+# Calculate quorum requirement
+calculate_quorum_requirement() {
+  local total_agents=$1
+  local min_quorum_spec="$2"
+  
+  # Parse quorum specification
+  if [[ "$min_quorum_spec" =~ ^[0-9]+$ ]]; then
+    # Absolute number
+    echo "$min_quorum_spec"
+  elif [[ "$min_quorum_spec" =~ ^([0-9]+)%$ ]]; then
+    # Percentage
+    local percentage="${BASH_REMATCH[1]}"
+    local required
+    required=$(echo "scale=0; ($total_agents * $percentage) / 100" | bc -l)
+    echo "$required"
+  elif [[ "$min_quorum_spec" =~ ^0\.[0-9]+$ ]]; then
+    # Fraction
+    local required
+    required=$(echo "scale=0; $total_agents * $min_quorum_spec" | bc -l)
+    echo "$required"
+  else
+    error "Invalid quorum specification: $min_quorum_spec"
+  fi
+}
+
+# Collect agent confidence scores
+collect_agent_scores() {
+  local agents_array
+  IFS=',' read -ra agents_array <<< "$AGENTS"
+  
+  local scores=()
+  local completed_agents=()
+  
+  log "Collecting confidence scores from agents"
+  
+  for agent_id in "${agents_array[@]}"; do
+    agent_id=$(echo "$agent_id" | xargs) # trim whitespace
+    
+    # Get confidence score from Redis
+    local confidence_key="swarm:${TASK_ID}:${agent_id}:confidence"
+    local confidence_score
+    confidence_score=$(redis-cli get "$confidence_key" 2>/dev/null || echo "")
+    
+    if [[ -n "$confidence_score" ]] && [[ "$confidence_score" =~ ^[0-9]*\.?[0-9]+$ ]]; then
+      scores+=("$confidence_score")
+      completed_agents+=("$agent_id")
+      log "Agent $agent_id confidence: $confidence_score"
+    else
+      log "Warning: No confidence score found for agent $agent_id"
+    fi
+  done
+  
+  # Store results in Redis for debugging
+  printf '%s\n' "${completed_agents[@]}" | redis-cli -x set "swarm:${TASK_ID}:validated-agents" > /dev/null 2>&1 || true
+  printf '%s\n' "${scores[@]}" | redis-cli -x set "swarm:${TASK_ID}:confidence-scores" > /dev/null 2>&1 || true
+  
+  # Return scores array
+  printf '%s\n' "${scores[@]}"
+}
+
+# Validate consensus
+validate_consensus() {
+  local scores=("$@")
+  
+  if [[ ${#scores[@]} -eq 0 ]]; then
+    error "No confidence scores available for validation"
+  fi
+  
+  # Calculate required quorum
+  local total_agents
+  total_agents=$(echo "$AGENTS" | tr ',' '\n' | wc -l)
+  local required_quorum
+  required_quorum=$(calculate_quorum_requirement "$total_agents" "$MIN_QUORUM")
+  
+  log "Total agents: $total_agents, Required quorum: $required_quorum"
+  log "Available scores: ${#scores[@]}"
+  
+  # Check quorum requirement
+  if [[ ${#scores[@]} -lt $required_quorum ]]; then
+    log "Consensus validation failed: Insufficient agent responses (${#scores[@]} < $required_quorum)"
+    return 1
+  fi
+  
+  # Calculate average confidence
+  local sum=0.0
+  local count=0
+  
+  for score in "${scores[@]}"; do
+    sum=$(echo "$sum + $score" | bc -l)
+    ((count++))
+  done
+  
+  local average_confidence
+  average_confidence=$(echo "scale=3; $sum / $count" | bc -l)
+  
+  log "Average confidence: $average_confidence, Threshold: $THRESHOLD"
+  
+  # Compare against threshold
+  local comparison
+  comparison=$(echo "$average_confidence >= $THRESHOLD" | bc -l 2>/dev/null || echo "0")
+  
+  # Store validation results
+  local validation_result
+  validation_result=$(cat << EOF
+{
+  "task_id": "$TASK_ID",
+  "timestamp": "$(date -Iseconds)",
+  "total_agents": $total_agents,
+  "completed_agents": $count,
+  "required_quorum": $required_quorum,
+  "quorum_met": $([[ $count -ge $required_quorum ]] && echo "true" || echo "false"),
+  "confidence_scores": [$(IFS=','; echo "${scores[*]}")],
+  "average_confidence": $average_confidence,
+  "threshold": $THRESHOLD,
+  "threshold_met": $([[ $comparison -eq 1 ]] && echo "true" || echo "false"),
+  "consensus_validated": $([[ $comparison -eq 1 ]] && echo "true" || echo "false")
+}
+EOF
+  )
+  
+  echo "$validation_result" | redis-cli -x set "swarm:${TASK_ID}:consensus-validation" > /dev/null
+  log "Validation result stored: $validation_result"
+  
+  if [[ $comparison -eq 1 ]]; then
+    log "SEO consensus validation PASSED (average: $average_confidence >= threshold: $THRESHOLD)"
+    return 0
+  else
+    log "SEO consensus validation FAILED (average: $average_confidence < threshold: $THRESHOLD)"
+    return 1
+  fi
+}
+
+# Main function
+main() {
+  parse_args "$@"
+  validate_inputs
+  
+  log "Starting SEO consensus validation for task: $TASK_ID"
+  
+  # Collect agent scores
+  local scores_array
+  readarray -t scores_array < <(collect_agent_scores)
+  
+  # Validate consensus
+  if validate_consensus "${scores_array[@]}"; then
+    log "SEO consensus validation completed successfully"
+    exit 0
+  else
+    log "SEO consensus validation failed"
+    exit 1
+  fi
+}
+
+# Script entry point
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  main "$@"
+fi

package/dist/agents/agent-loader.js

@@ -1,12 +1,145 @@
+"use strict";
 /**
  * Dynamic Agent Loader - Reads agent definitions from .claude/agents/ directory
  * Single source of truth for agent types in the system
- */ import { readFileSync, existsSync } from 'node:fs';
-import { glob } from 'glob';
-import { resolve, dirname } from 'node:path';
-import { parse as parseYaml } from 'yaml';
+ */ var __awaiter = this && this.__awaiter || function(thisArg, _arguments, P, generator) {
+    function adopt(value) {
+        return value instanceof P ? value : new P(function(resolve) {
+            resolve(value);
+        });
+    }
+    return new (P || (P = Promise))(function(resolve, reject) {
+        function fulfilled(value) {
+            try {
+                step(generator.next(value));
+            } catch (e) {
+                reject(e);
+            }
+        }
+        function rejected(value) {
+            try {
+                step(generator["throw"](value));
+            } catch (e) {
+                reject(e);
+            }
+        }
+        function step(result) {
+            result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
+        }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = this && this.__generator || function(thisArg, body) {
+    var _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+};
+var __spreadArray = this && this.__spreadArray || function(to, from, pack) {
+    if (pack || arguments.length === 2) for(var i = 0, l = from.length, ar; i < l; i++){
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+exports.refreshAgents = exports.getAgentsByCategory = exports.isValidAgentType = exports.searchAgents = exports.getAgentCategories = exports.getAllAgents = exports.getAgent = exports.getAvailableAgentTypes = exports.agentLoader = exports.AgentLoader = void 0;
+exports.resolveLegacyAgentType = resolveLegacyAgentType;
+var node_fs_1 = require("node:fs");
+var glob_1 = require("glob");
+var node_path_1 = require("node:path");
+var yaml_1 = require("yaml");
 // Legacy agent type mapping for backward compatibility
-const LEGACY_AGENT_MAPPING = {
+var LEGACY_AGENT_MAPPING = {
     analyst: 'code-analyzer',
     coordinator: 'hierarchical-coordinator',
     optimizer: 'perf-analyzer',
@@ -17,38 +150,40 @@ const LEGACY_AGENT_MAPPING = {
 };
 /**
  * Resolve legacy agent types to current equivalents
- */ export function resolveLegacyAgentType(legacyType) {
+ */ function resolveLegacyAgentType(legacyType) {
     return LEGACY_AGENT_MAPPING[legacyType] || legacyType;
 }
-export class AgentLoader {
-    agentCache = new Map();
-    categoriesCache = [];
-    lastLoadTime = 0;
-    CACHE_EXPIRY = 60_000;
-    getAgentsDirectory() {
-        let currentDir = process.cwd();
+var AgentLoader = /** @class */ function() {
+    function AgentLoader() {
+        this.agentCache = new Map();
+        this.categoriesCache = [];
+        this.lastLoadTime = 0;
+        this.CACHE_EXPIRY = 60000; // 1 minute cache
+    }
+    AgentLoader.prototype.getAgentsDirectory = function() {
+        var currentDir = process.cwd();
         while(currentDir !== '/'){
-            const claudeAgentsPath = resolve(currentDir, '.claude', 'agents');
-            if (existsSync(claudeAgentsPath)) {
+            var claudeAgentsPath = (0, node_path_1.resolve)(currentDir, '.claude', 'agents');
+            if ((0, node_fs_1.existsSync)(claudeAgentsPath)) {
                 return claudeAgentsPath;
             }
-            currentDir = dirname(currentDir);
+            currentDir = (0, node_path_1.dirname)(currentDir);
         }
-        return resolve(process.cwd(), '.claude', 'agents');
-    }
-    parseAgentFile(filePath) {
+        return (0, node_path_1.resolve)(process.cwd(), '.claude', 'agents');
+    };
+    AgentLoader.prototype.parseAgentFile = function(filePath) {
         try {
-            const content = readFileSync(filePath, 'utf-8');
-            const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+            var content = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+            var frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
             if (!frontmatterMatch) {
-                console.warn(`No frontmatter found in ${filePath}`);
+                console.warn("No frontmatter found in ".concat(filePath));
                 return null;
             }
-            const [, yamlContent, markdownContent] = frontmatterMatch;
-            const frontmatter = parseYaml(yamlContent);
-            const description = frontmatter.description;
+            var yamlContent = frontmatterMatch[1], markdownContent = frontmatterMatch[2];
+            var frontmatter = (0, yaml_1.parse)(yamlContent);
+            var description = frontmatter.description;
             if (!frontmatter.name || !description) {
-                console.warn(`Missing required fields (name, description) in ${filePath}`);
+                console.warn("Missing required fields (name, description) in ".concat(filePath));
                 return null;
             }
             return {
@@ -69,129 +204,13 @@ export class AgentLoader {
                 content: markdownContent.trim()
             };
         } catch (error) {
-            console.error(`Error parsing agent file ${filePath}:`, error);
+            console.error("Error parsing agent file ".concat(filePath, ":"), error);
             return null;
         }
-    }
-    parseTools(frontmatter) {
-        const extractTools = (input)=>{
+    };
+    AgentLoader.prototype.parseTools = function(frontmatter) {
+        var extractTools = function(input) {
             if (Array.isArray(input)) return input.map(String);
-            if (typeof input === 'string') {
-                return input.split(/[,\s]+/).map((t)=>t.trim()).filter((t)=>t.length > 0);
-            }
-            return [];
-        };
-        // Safely handle tools and capabilities.tools
-        const toolsFromFrontmatter = frontmatter.tools ? extractTools(frontmatter.tools) : [];
-        const toolsFromCapabilities = frontmatter.capabilities && typeof frontmatter.capabilities === 'object' ? extractTools(Object(frontmatter.capabilities).tools) : [];
-        return [
-            ...toolsFromFrontmatter,
-            ...toolsFromCapabilities
-        ];
-    }
-    async loadAgents() {
-        const agentsDir = this.getAgentsDirectory();
-        if (!existsSync(agentsDir)) {
-            console.warn(`Agents directory not found: ${agentsDir}`);
-            return;
-        }
-        const agentFiles = await new Promise((resolve, reject)=>{
-            glob('**/*.md', {
-                cwd: agentsDir,
-                ignore: [
-                    '**/README.md',
-                    '**/MIGRATION_SUMMARY.md'
-                ],
-                absolute: true
-            }, (err, matches)=>{
-                if (err) reject(err);
-                else resolve(matches);
-            });
-        });
-        this.agentCache.clear();
-        this.categoriesCache = [];
-        const categoryMap = new Map();
-        for (const filePath of agentFiles){
-            const agent = this.parseAgentFile(filePath);
-            if (agent) {
-                this.agentCache.set(agent.name, agent);
-                const relativePath = filePath.replace(agentsDir, '');
-                const pathParts = relativePath.split('/');
-                const category = pathParts[1] || 'uncategorized';
-                if (!categoryMap.has(category)) {
-                    categoryMap.set(category, []);
-                }
-                categoryMap.get(category).push(agent);
-            }
-        }
-        this.categoriesCache = Array.from(categoryMap.entries()).map(([name, agents])=>({
-                name,
-                agents: agents.sort((a, b)=>a.name.localeCompare(b.name))
-            }));
-        this.lastLoadTime = Date.now();
-    }
-    // Rest of the methods remain similar to the original implementation
-    needsRefresh() {
-        return Date.now() - this.lastLoadTime > this.CACHE_EXPIRY;
-    }
-    async ensureLoaded() {
-        if (this.agentCache.size === 0 || this.needsRefresh()) {
-            await this.loadAgents();
-        }
-    }
-    async getAvailableAgentTypes() {
-        await this.ensureLoaded();
-        const currentTypes = Array.from(this.agentCache.keys());
-        const legacyTypes = Object.keys(LEGACY_AGENT_MAPPING);
-        return Array.from(new Set([
-            ...currentTypes,
-            ...legacyTypes
-        ])).sort();
-    }
-    async getAgent(name) {
-        await this.ensureLoaded();
-        return this.agentCache.get(name) || this.agentCache.get(resolveLegacyAgentType(name)) || null;
-    }
-    async getAllAgents() {
-        await this.ensureLoaded();
-        return Array.from(this.agentCache.values()).sort((a, b)=>a.name.localeCompare(b.name));
-    }
-    async getAgentCategories() {
-        await this.ensureLoaded();
-        return this.categoriesCache;
-    }
-    async searchAgents(query) {
-        await this.ensureLoaded();
-        const lowerQuery = query.toLowerCase();
-        return Array.from(this.agentCache.values()).filter((agent)=>agent.name.toLowerCase().includes(lowerQuery) || agent.description.toLowerCase().includes(lowerQuery) || agent.capabilities?.some((cap)=>cap.toLowerCase().includes(lowerQuery)));
-    }
-    async isValidAgentType(name) {
-        await this.ensureLoaded();
-        return this.agentCache.has(name) || this.agentCache.has(resolveLegacyAgentType(name));
-    }
-    async getAgentsByCategory(category) {
-        const categories = await this.getAgentCategories();
-        const found = categories.find((cat)=>cat.name === category);
-        return found?.agents || [];
-    }
-    async refresh() {
-        this.lastLoadTime = 0;
-        await this.loadAgents();
-    }
-}
-// Singleton instance
-export const agentLoader = new AgentLoader();
-// Convenience exports for use in other modules
-export const getAvailableAgentTypes = ()=>agentLoader.getAvailableAgentTypes();
-export const getAgent = (name)=>agentLoader.getAgent(name);
-export const getAllAgents = ()=>agentLoader.getAllAgents();
-export const getAgentCategories = ()=>agentLoader.getAgentCategories();
-export const searchAgents = (query)=>agentLoader.searchAgents(query);
-export const isValidAgentType = (name)=>agentLoader.isValidAgentType(name);
-export const getAgentsByCategory = (category)=>agentLoader.getAgentsByCategory(category);
-export const refreshAgents = ()=>agentLoader.refresh();
-
-//# sourceMappingURL=agent-loader.js.map.isArray(input)) return input.map(String);
             if (typeof input === 'string') {
                 return input.split(/[,\s]+/).map(function(t) {
                     return t.trim();