claude-flow-novice 2.9.0 → 2.10.0

package/.claude/skills/cfn-event-bus/test-event-bus.sh

@@ -0,0 +1,280 @@
+#!/bin/bash
+#
+# Event Bus Skill - Test Suite
+#
+# Tests:
+#   1. Event Publishing
+#   2. Event Subscription (manual verification)
+#   3. Lifecycle Tracking (spawn, complete, fail, timeout)
+#   4. Event Statistics
+#   5. Trace ID Propagation
+#   6. Invalid Input Handling
+#
+# Usage:
+#   ./test-event-bus.sh
+
+set -euo pipefail
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Test counters
+TESTS_RUN=0
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+# Color output
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Test helper functions
+run_test() {
+    local test_name="$1"
+    TESTS_RUN=$((TESTS_RUN + 1))
+    echo -e "\n${YELLOW}[Test $TESTS_RUN]${NC} $test_name"
+}
+
+assert_success() {
+    if [ $? -eq 0 ]; then
+        echo -e "${GREEN}✓ PASSED${NC}"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "${RED}✗ FAILED${NC}"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+assert_equals() {
+    local expected="$1"
+    local actual="$2"
+    if [ "$expected" == "$actual" ]; then
+        echo -e "${GREEN}✓ PASSED${NC} (expected: $expected, got: $actual)"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "${RED}✗ FAILED${NC} (expected: $expected, got: $actual)"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+assert_contains() {
+    local needle="$1"
+    local haystack="$2"
+    if echo "$haystack" | grep -q "$needle"; then
+        echo -e "${GREEN}✓ PASSED${NC} (contains: $needle)"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        return 0
+    else
+        echo -e "${RED}✗ FAILED${NC} (does not contain: $needle)"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
+echo "========================================"
+echo "Event Bus Skill - Test Suite"
+echo "========================================"
+
+# Test 1: Basic Event Publishing
+run_test "Event Publishing - Basic"
+RESULT=$("$SCRIPT_DIR/invoke-event-publish.sh" \
+    --topic "test:basic" \
+    --payload '{"message": "Hello Event Bus", "testId": 1}')
+
+STATUS=$(echo "$RESULT" | jq -r '.status')
+TOPIC=$(echo "$RESULT" | jq -r '.topic')
+assert_equals "published" "$STATUS"
+assert_equals "test:basic" "$TOPIC"
+
+# Test 2: Event Publishing with Trace ID
+run_test "Event Publishing - With Trace ID"
+RESULT=$("$SCRIPT_DIR/invoke-event-publish.sh" \
+    --topic "test:traced" \
+    --payload '{"message": "Traced event", "testId": 2}' \
+    --trace-id "trace-test-123")
+
+STATUS=$(echo "$RESULT" | jq -r '.status')
+TRACE_ID=$(echo "$RESULT" | jq -r '.traceId')
+assert_equals "published" "$STATUS"
+assert_equals "trace-test-123" "$TRACE_ID"
+
+# Test 3: Lifecycle Tracking - Spawn
+run_test "Lifecycle Tracking - Agent Spawn"
+RESULT=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-1" \
+    --event "spawn" \
+    --metadata '{"taskId": "test-task", "role": "tester"}')
+
+STATUS=$(echo "$RESULT" | jq -r '.status')
+EVENT=$(echo "$RESULT" | jq -r '.event')
+assert_equals "tracked" "$STATUS"
+assert_equals "spawn" "$EVENT"
+
+# Test 4: Lifecycle Tracking - Complete
+run_test "Lifecycle Tracking - Agent Complete"
+RESULT=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-1" \
+    --event "complete" \
+    --metadata '{"taskId": "test-task", "confidence": 0.95, "duration": 30000}')
+
+STATUS=$(echo "$RESULT" | jq -r '.status')
+EVENT=$(echo "$RESULT" | jq -r '.event')
+AGENT_ID=$(echo "$RESULT" | jq -r '.agentId')
+assert_equals "tracked" "$STATUS"
+assert_equals "complete" "$EVENT"
+assert_equals "test-agent-1" "$AGENT_ID"
+
+# Test 5: Lifecycle Tracking - Fail
+run_test "Lifecycle Tracking - Agent Fail"
+RESULT=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-2" \
+    --event "fail" \
+    --metadata '{"taskId": "test-task", "error": "Test error", "stage": "validation"}')
+
+STATUS=$(echo "$RESULT" | jq -r '.status')
+EVENT=$(echo "$RESULT" | jq -r '.event')
+assert_equals "tracked" "$STATUS"
+assert_equals "fail" "$EVENT"
+
+# Test 6: Lifecycle Tracking - Timeout
+run_test "Lifecycle Tracking - Agent Timeout"
+RESULT=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-3" \
+    --event "timeout" \
+    --metadata '{"taskId": "test-task", "timeLimit": 60000, "elapsed": 65000}')
+
+STATUS=$(echo "$RESULT" | jq -r '.status')
+EVENT=$(echo "$RESULT" | jq -r '.event')
+assert_equals "tracked" "$STATUS"
+assert_equals "timeout" "$EVENT"
+
+# Test 7: Invalid Event Type
+run_test "Lifecycle Tracking - Invalid Event Type"
+OUTPUT=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-4" \
+    --event "invalid-event" \
+    --metadata '{"taskId": "test-task"}' 2>&1 || true)
+
+assert_contains "Invalid event type" "$OUTPUT"
+
+# Test 8: Invalid JSON Payload
+run_test "Event Publishing - Invalid JSON"
+OUTPUT=$("$SCRIPT_DIR/invoke-event-publish.sh" \
+    --topic "test:invalid" \
+    --payload 'not-valid-json' 2>&1 || true)
+
+assert_contains "Invalid JSON" "$OUTPUT"
+
+# Test 9: Missing Required Arguments - Publish
+run_test "Event Publishing - Missing Arguments"
+OUTPUT=$("$SCRIPT_DIR/invoke-event-publish.sh" \
+    --topic "test:missing" 2>&1 || true)
+
+assert_contains "required" "$OUTPUT"
+
+# Test 10: Missing Required Arguments - Lifecycle
+run_test "Lifecycle Tracking - Missing Arguments"
+OUTPUT=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-5" \
+    --event "spawn" 2>&1 || true)
+
+assert_contains "required" "$OUTPUT"
+
+# Test 11: Event ID Generation
+run_test "Event Publishing - Unique Event IDs"
+RESULT1=$("$SCRIPT_DIR/invoke-event-publish.sh" \
+    --topic "test:id-check" \
+    --payload '{"test": 1}')
+EVENT_ID1=$(echo "$RESULT1" | jq -r '.eventId')
+
+RESULT2=$("$SCRIPT_DIR/invoke-event-publish.sh" \
+    --topic "test:id-check" \
+    --payload '{"test": 2}')
+EVENT_ID2=$(echo "$RESULT2" | jq -r '.eventId')
+
+if [ "$EVENT_ID1" != "$EVENT_ID2" ]; then
+    echo -e "${GREEN}✓ PASSED${NC} (Event IDs are unique)"
+    TESTS_PASSED=$((TESTS_PASSED + 1))
+else
+    echo -e "${RED}✗ FAILED${NC} (Event IDs are not unique)"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+fi
+
+# Test 12: Tracking ID Generation
+run_test "Lifecycle Tracking - Unique Tracking IDs"
+RESULT1=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-6" \
+    --event "spawn" \
+    --metadata '{"test": 1}')
+TRACKING_ID1=$(echo "$RESULT1" | jq -r '.trackingId')
+
+RESULT2=$("$SCRIPT_DIR/invoke-lifecycle-track.sh" \
+    --agent-id "test-agent-7" \
+    --event "spawn" \
+    --metadata '{"test": 2}')
+TRACKING_ID2=$(echo "$RESULT2" | jq -r '.trackingId')
+
+if [ "$TRACKING_ID1" != "$TRACKING_ID2" ]; then
+    echo -e "${GREEN}✓ PASSED${NC} (Tracking IDs are unique)"
+    TESTS_PASSED=$((TESTS_PASSED + 1))
+else
+    echo -e "${RED}✗ FAILED${NC} (Tracking IDs are not unique)"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+fi
+
+# Test 13: Event Statistics (via Node.js)
+run_test "Event Statistics - Verification"
+STATS=$(node -e "
+const path = require('path');
+const { eventBus } = require(path.join('$SCRIPT_DIR', 'eventbus-wrapper.cjs'));
+
+// Emit test events
+eventBus.emitEvent('stats:test:1', { data: 'test1' });
+eventBus.emitEvent('stats:test:2', { data: 'test2' });
+eventBus.emitEvent('stats:test:1', { data: 'test3' });
+
+// Get stats
+const stats = eventBus.getEventStats();
+const test1Stats = stats.find(s => s.event === 'stats:test:1');
+
+console.log(JSON.stringify({
+    count: test1Stats ? test1Stats.count : 0,
+    hasLastEmitted: test1Stats && test1Stats.lastEmitted !== null
+}));
+")
+
+COUNT=$(echo "$STATS" | jq -r '.count')
+if [ "$COUNT" -ge 2 ]; then
+    echo -e "${GREEN}✓ PASSED${NC} (Event count tracked correctly: $COUNT)"
+    TESTS_PASSED=$((TESTS_PASSED + 1))
+else
+    echo -e "${RED}✗ FAILED${NC} (Event count incorrect: $COUNT)"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+fi
+
+# Test Summary
+echo ""
+echo "========================================"
+echo "Test Summary"
+echo "========================================"
+echo "Total Tests:  $TESTS_RUN"
+echo -e "${GREEN}Passed:       $TESTS_PASSED${NC}"
+if [ $TESTS_FAILED -gt 0 ]; then
+    echo -e "${RED}Failed:       $TESTS_FAILED${NC}"
+else
+    echo "Failed:       $TESTS_FAILED"
+fi
+echo "========================================"
+
+# Exit with appropriate code
+if [ $TESTS_FAILED -gt 0 ]; then
+    exit 1
+else
+    echo -e "${GREEN}All tests passed!${NC}"
+    exit 0
+fi

package/.claude/skills/cfn-fleet-manager/SKILL.md

@@ -0,0 +1,412 @@
+# Fleet Manager Skill
+
+## Version
+**Version:** 1.0.0
+**Status:** OPERATIONAL
+
+## Overview
+Fleet Manager provides comprehensive resource allocation, tier-based resource management, performance monitoring, and load balancing for distributed agent swarms.
+
+## Features
+- Agent Registration with Resource Tiers
+- Dynamic Resource Allocation
+- Real-time Performance Metrics
+- Intelligent Load Balancing
+- Resource Quota Management
+- Health Monitoring
+
+## Resource Tiers
+
+### Shared Tier (Default)
+- **CPU:** 0.5 cores
+- **Memory:** 512 MB
+- **Use Case:** Lightweight tasks, research, documentation
+- **Cost:** Minimal
+
+### Dedicated Tier
+- **CPU:** 2.0 cores
+- **Memory:** 2048 MB
+- **Use Case:** Backend development, testing, code analysis
+- **Cost:** Standard
+
+### Premium Tier
+- **CPU:** 4.0 cores
+- **Memory:** 4096 MB
+- **Use Case:** CFN Loop validation, compilation, heavy processing
+- **Cost:** Maximum
+
+## Agent Integration Examples
+
+### 1. Register Agent with Resource Tier
+
+```bash
+# Register agent with shared tier (default)
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "researcher-1" \
+  --tier shared
+
+# Register agent with dedicated tier
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "backend-dev-1" \
+  --tier dedicated
+
+# Register agent with premium tier
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "cfn-validator-1" \
+  --tier premium
+```
+
+**Output:**
+```json
+{
+  "status": "registered",
+  "agentId": "backend-dev-1",
+  "tier": "dedicated",
+  "resources": {
+    "cpu": 2.0,
+    "memory": 2048
+  },
+  "timestamp": 1729332000
+}
+```
+
+### 2. Allocate Resources to Agent
+
+```bash
+# Allocate custom resources
+./.claude/skills/fleet-manager/invoke-fleet-allocate.sh \
+  --agent-id "backend-dev-1" \
+  --cpu 3.0 \
+  --memory 3072
+
+# Allocate with priority flag
+./.claude/skills/fleet-manager/invoke-fleet-allocate.sh \
+  --agent-id "cfn-validator-1" \
+  --cpu 4.0 \
+  --memory 4096 \
+  --priority high
+```
+
+**Output:**
+```json
+{
+  "status": "allocated",
+  "agentId": "backend-dev-1",
+  "allocated": {
+    "cpu": 3.0,
+    "memory": 3072
+  },
+  "availability": {
+    "cpuRemaining": 5.0,
+    "memoryRemaining": 4096
+  },
+  "timestamp": 1729332100
+}
+```
+
+### 3. Get Performance Metrics
+
+```bash
+# Get metrics for specific agent
+./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+  --agent-id "backend-dev-1"
+
+# Get metrics with detailed breakdown
+./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+  --agent-id "backend-dev-1" \
+  --detailed
+
+# Get fleet-wide metrics
+./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+  --all
+```
+
+**Output:**
+```json
+{
+  "agentId": "backend-dev-1",
+  "metrics": {
+    "cpuUsage": 2.4,
+    "cpuUtilization": 0.80,
+    "memoryUsage": 1800,
+    "memoryUtilization": 0.88,
+    "taskCompletionRate": 0.95,
+    "averageResponseTime": 120
+  },
+  "health": "healthy",
+  "timestamp": 1729332200
+}
+```
+
+### 4. Trigger Load Balancing
+
+```bash
+# Balance resources across multiple agents
+./.claude/skills/fleet-manager/invoke-fleet-balance.sh \
+  --agents "backend-dev-1,backend-dev-2,backend-dev-3"
+
+# Balance with strategy
+./.claude/skills/fleet-manager/invoke-fleet-balance.sh \
+  --agents "cfn-validator-1,cfn-validator-2" \
+  --strategy round-robin
+
+# Balance entire fleet
+./.claude/skills/fleet-manager/invoke-fleet-balance.sh \
+  --all
+```
+
+**Output:**
+```json
+{
+  "status": "balanced",
+  "strategy": "round-robin",
+  "agents": [
+    {
+      "agentId": "backend-dev-1",
+      "beforeLoad": 0.80,
+      "afterLoad": 0.65,
+      "adjustment": "reduced"
+    },
+    {
+      "agentId": "backend-dev-2",
+      "beforeLoad": 0.45,
+      "afterLoad": 0.60,
+      "adjustment": "increased"
+    }
+  ],
+  "timestamp": 1729332300
+}
+```
+
+## Integration Patterns
+
+### Pattern 1: CFN Loop with Resource Management
+
+```bash
+# Register all CFN Loop agents with appropriate tiers
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "coder-1" --tier dedicated
+
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "reviewer-1" --tier dedicated
+
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "product-owner-1" --tier premium
+
+# Monitor performance during loop
+metrics=$(
+  ./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+    --agent-id "coder-1"
+)
+
+# If CPU utilization high, trigger rebalancing
+cpu_util=$(echo "$metrics" | jq '.metrics.cpuUtilization')
+if (( $(echo "$cpu_util > 0.85" | bc -l) )); then
+  ./.claude/skills/fleet-manager/invoke-fleet-balance.sh \
+    --agents "coder-1,coder-2,coder-3"
+fi
+```
+
+### Pattern 2: Dynamic Resource Scaling
+
+```bash
+# Start with shared tier
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "researcher-1" --tier shared
+
+# If task complexity increases, allocate more resources
+./.claude/skills/fleet-manager/invoke-fleet-allocate.sh \
+  --agent-id "researcher-1" \
+  --cpu 2.0 \
+  --memory 2048
+
+# Monitor and adjust
+metrics=$(
+  ./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+    --agent-id "researcher-1"
+)
+
+memory_util=$(echo "$metrics" | jq '.metrics.memoryUtilization')
+if (( $(echo "$memory_util > 0.90" | bc -l) )); then
+  ./.claude/skills/fleet-manager/invoke-fleet-allocate.sh \
+    --agent-id "researcher-1" \
+    --memory 4096 \
+    --priority high
+fi
+```
+
+### Pattern 3: Health-Based Resource Adjustment
+
+```bash
+# Check agent health
+metrics=$(
+  ./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+    --agent-id "backend-dev-1"
+)
+
+health=$(echo "$metrics" | jq -r '.health')
+
+if [ "$health" = "degraded" ]; then
+  # Reduce load on degraded agent
+  ./.claude/skills/fleet-manager/invoke-fleet-balance.sh \
+    --agents "backend-dev-1,backend-dev-2" \
+    --strategy offload
+fi
+```
+
+## Performance Characteristics
+
+### Resource Allocation Latency
+- Registration: <50ms
+- Allocation: <100ms
+- Metrics Retrieval: <30ms
+- Load Balancing: <200ms
+
+### Scalability
+- Max Concurrent Agents: 100+
+- Max Resource Pool: 400 cores, 400GB RAM
+- Metrics Collection Rate: 1Hz per agent
+- Balancing Frequency: On-demand or scheduled
+
+### Resource Efficiency
+- Shared Tier: 95% resource utilization
+- Dedicated Tier: 85% resource utilization
+- Premium Tier: 75% resource utilization (reserved headroom)
+
+## Redis Key Structure
+
+```
+# Agent Registration
+fleet:agent:{agentId}:registration -> {tier, cpu, memory, timestamp}
+
+# Resource Allocation
+fleet:agent:{agentId}:allocation -> {cpu, memory, priority, timestamp}
+
+# Performance Metrics
+fleet:agent:{agentId}:metrics -> {cpuUsage, memoryUsage, health, timestamp}
+
+# Load Balancing State
+fleet:balance:{balanceId}:state -> {agents, strategy, status, timestamp}
+
+# Resource Pool
+fleet:pool:available -> {totalCpu, totalMemory, allocated, reserved}
+```
+
+## Error Handling
+
+### Common Errors
+
+**Insufficient Resources:**
+```json
+{
+  "error": "RESOURCE_UNAVAILABLE",
+  "message": "Requested resources exceed available pool",
+  "requested": {"cpu": 4.0, "memory": 4096},
+  "available": {"cpu": 2.0, "memory": 2048}
+}
+```
+
+**Agent Not Found:**
+```json
+{
+  "error": "AGENT_NOT_FOUND",
+  "message": "Agent backend-dev-1 not registered",
+  "suggestion": "Register agent first using invoke-fleet-register.sh"
+}
+```
+
+**Invalid Tier:**
+```json
+{
+  "error": "INVALID_TIER",
+  "message": "Tier 'ultra' not recognized",
+  "validTiers": ["shared", "dedicated", "premium"]
+}
+```
+
+## Best Practices
+
+1. **Register Before Allocation:** Always register agents before allocating custom resources
+2. **Monitor Regularly:** Check metrics at least once per iteration for long-running tasks
+3. **Balance Proactively:** Trigger load balancing when fleet-wide utilization >70%
+4. **Use Appropriate Tiers:** Match tier to task complexity to optimize cost
+5. **Graceful Degradation:** Handle resource scarcity by queuing tasks or reducing quality
+
+## Testing
+
+Run comprehensive test suite:
+```bash
+./.claude/skills/fleet-manager/test-fleet-manager.sh
+```
+
+### Test Coverage
+- Agent registration (all tiers)
+- Resource allocation (standard and high-priority)
+- Metrics collection (individual and fleet-wide)
+- Load balancing (multiple strategies)
+- Error handling (resource exhaustion, invalid inputs)
+- Concurrency (parallel agent operations)
+
+## Coordination with Other Skills
+
+### Redis Coordination Integration
+```bash
+# Register CFN Loop agents with Fleet Manager
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "coder-1" --tier dedicated
+
+# Start CFN Loop with orchestration
+./.claude/skills/redis-coordination/orchestrate-cfn-loop.sh \
+  --task-id "auth-system" \
+  --loop3-agents "coder-1,coder-2" \
+  --loop2-agents "reviewer-1" \
+  --product-owner "product-owner-1"
+
+# Monitor resource usage during loop
+./.claude/skills/fleet-manager/invoke-fleet-metrics.sh \
+  --agent-id "coder-1"
+```
+
+### Agent Spawning Integration
+```bash
+# Register agent in spawning script
+./.claude/skills/fleet-manager/invoke-fleet-register.sh \
+  --agent-id "$AGENT_ID" --tier dedicated
+
+# Spawn agent with Task tool
+# ... agent spawning logic ...
+
+# Deallocate resources when agent completes
+./.claude/skills/fleet-manager/invoke-fleet-allocate.sh \
+  --agent-id "$AGENT_ID" --cpu 0 --memory 0
+```
+
+## Maintenance
+
+### Daily Health Checks
+```bash
+# Check fleet-wide health
+./.claude/skills/fleet-manager/invoke-fleet-metrics.sh --all | jq '.agents[] | select(.health != "healthy")'
+```
+
+### Weekly Resource Audits
+```bash
+# Identify underutilized agents
+./.claude/skills/fleet-manager/invoke-fleet-metrics.sh --all | jq '.agents[] | select(.metrics.cpuUtilization < 0.20)'
+```
+
+### Monthly Capacity Planning
+```bash
+# Analyze resource trends
+# Export metrics to analytics system for trend analysis
+```
+
+## Version History
+
+### v1.0.0 (2025-10-19)
+- Initial release
+- Agent registration with 3-tier resource model
+- Dynamic resource allocation
+- Real-time performance metrics
+- Load balancing with multiple strategies
+- Comprehensive test suite