claude-flow-novice 2.10.5 → 2.10.7

package/claude-assets/skills/cfn-ace-system/sprint-7-lessons.json

@@ -0,0 +1,46 @@
+{
+    "lessons": [
+        {
+            "bullet_id": "STRAT-007",
+            "category": "strategy",
+            "content": "When implementing long-running orchestration workflows (>10 minutes), use background execution with Redis-based status monitoring instead of synchronous Bash calls. Bash tool has hard 10-minute timeout limit that cannot be extended.",
+            "confidence": 0.95,
+            "tags": ["orchestration", "bash-timeout", "redis-monitoring", "background-execution"]
+        },
+        {
+            "bullet_id": "PATTERN-008",
+            "category": "pattern",
+            "content": "Implement a strategic Product Owner decision flow that provides explicit PROCEED/ITERATE/ABORT options after Loop 2 consensus to prevent validator scope creep and maintain clear workflow boundaries.",
+            "confidence": 0.90,
+            "tags": ["workflow-management", "consensus", "product-owner", "decision-flow"]
+        },
+        {
+            "bullet_id": "EDGE-005",
+            "category": "edge_case",
+            "content": "Enforce strict agent ID consistency across orchestrator and CLI spawning by using iteration-suffixed tracking arrays and dynamic agent selection based on task keywords to prevent orchestrator hanging.",
+            "confidence": 0.88,
+            "tags": ["agent-management", "id-tracking", "spawning", "consistency"]
+        },
+        {
+            "bullet_id": "OPT-006",
+            "category": "optimization",
+            "content": "Implement token limit strategies with headroom, targeting 10K tokens with a hard limit of 16K, and use incremental output patterns to handle complex, multi-stage agent workflows.",
+            "confidence": 0.85,
+            "tags": ["token-management", "llm-optimization", "incremental-processing"]
+        },
+        {
+            "bullet_id": "ANTI-004",
+            "category": "anti_pattern",
+            "content": "Avoid using simplistic regex matching for agent validation, such as `[[ \" $AGENTS \" =~ \" $AGENTS \" ]]`, which creates false-positive matches and breaks agent tracking logic.",
+            "confidence": 0.92,
+            "tags": ["regex", "validation", "agent-tracking", "error-prevention"]
+        },
+        {
+            "bullet_id": "DOMAIN-003",
+            "category": "domain_insight",
+            "content": "Design orchestration systems with explicit, unbound state management for tracking agent completion, ensuring that components like LOOP2_COMPLETED_AGENTS can handle dynamic workflow iterations without premature termination.",
+            "confidence": 0.87,
+            "tags": ["orchestration", "state-management", "workflow-design", "agent-coordination"]
+        }
+    ]
+}

package/claude-assets/skills/cfn-ace-system/store-reflection.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+# Parse arguments
+while [ $# -gt 0 ]; do
+    key="$1"
+    case $key in
+        --sprint)
+            SPRINT="$2"
+            shift 2
+            ;;
+        --file)
+            LESSONS_FILE="$2"
+            shift 2
+            ;;
+        *)
+            echo "Unknown parameter: $1"
+            exit 1
+            ;;
+    esac
+done
+
+# Validate required arguments
+if [ -z "$SPRINT" ] || [ -z "$LESSONS_FILE" ]; then
+    echo "Usage: $0 --sprint <sprint_number> --file <lessons_file_path>"
+    exit 1
+fi
+
+# Ensure artifacts directory exists
+mkdir -p .claude/artifacts/ace-reflections
+
+# Store reflection with timestamp
+TIMESTAMP=$(date -u +"%Y%m%d_%H%M%S")
+OUTPUT_FILE=".claude/artifacts/ace-reflections/sprint-${SPRINT}_${TIMESTAMP}.json"
+
+# Copy lessons file to artifacts
+cp "$LESSONS_FILE" "$OUTPUT_FILE"
+
+# Update latest reflection pointer
+echo "$OUTPUT_FILE" > .claude/artifacts/ace-reflections/LATEST
+
+echo "Reflection for Sprint $SPRINT stored successfully at $OUTPUT_FILE"
+
+# Optional: Use Redis to broadcast reflection event
+if command -v redis-cli &> /dev/null; then
+    redis-cli lpush "ace:reflections" "$OUTPUT_FILE"
+fi

package/claude-assets/skills/cfn-ace-system/test-ace-skill.sh

@@ -0,0 +1,312 @@
+#!/usr/bin/env bash
+
+##############################################################################
+# ACE System Skill Test Suite
+# Validates all ACE skill wrapper functionality
+#
+# Usage:
+#   ./test-ace-skill.sh
+##############################################################################
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TEST_DIR=$(mktemp -d)
+trap "rm -rf $TEST_DIR" EXIT
+
+PASS_COUNT=0
+FAIL_COUNT=0
+
+# Test helper functions
+pass() {
+  echo "[PASS] $1"
+  ((PASS_COUNT++))
+}
+
+fail() {
+  echo "[FAIL] $1"
+  ((FAIL_COUNT++))
+}
+
+# Test 1: Context Reflection
+test_context_reflect() {
+  echo "Running: Context Reflection Test"
+
+  local test_context='{"task": "test-reflection", "complexity": "high", "constraints": ["time", "budget"]}'
+
+  if result=$("$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context "$test_context" \
+    --memory-path "$TEST_DIR/test-reflections.sqlite" 2>&1); then
+
+    # Validate JSON output
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      # Check required fields
+      if echo "$result" | jq -e '.id and .timestamp and .complexity and .insights' > /dev/null 2>&1; then
+        pass "Context reflection generates valid output"
+      else
+        fail "Context reflection missing required fields"
+      fi
+    else
+      fail "Context reflection returned invalid JSON"
+    fi
+  else
+    fail "Context reflection script failed: $result"
+  fi
+}
+
+# Test 2: Context Stats - Reflections Query
+test_context_stats() {
+  echo "Running: Context Stats Test"
+
+  # First create some reflections
+  "$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context '{"task": "stats-test-1"}' \
+    --memory-path "$TEST_DIR/test-stats.sqlite" > /dev/null 2>&1
+
+  "$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context '{"task": "stats-test-2"}' \
+    --complexity 0.8 \
+    --memory-path "$TEST_DIR/test-stats.sqlite" > /dev/null 2>&1
+
+  # Query reflections
+  if result=$("$SCRIPT_DIR/invoke-context-stats.sh" \
+    --query reflections \
+    --filter '{"complexity": {"$gt": 0.5}}' \
+    --limit 10 \
+    --memory-path "$TEST_DIR/test-stats.sqlite" 2>&1); then
+
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      # Check if array returned
+      if echo "$result" | jq -e 'type == "array"' > /dev/null 2>&1; then
+        pass "Context stats returns filtered reflections"
+      else
+        fail "Context stats did not return array"
+      fi
+    else
+      fail "Context stats returned invalid JSON"
+    fi
+  else
+    fail "Context stats script failed: $result"
+  fi
+}
+
+# Test 3: Context Stats - Summary Query
+test_context_stats_summary() {
+  echo "Running: Context Stats Summary Test"
+
+  # Use same database as previous test
+  if result=$("$SCRIPT_DIR/invoke-context-stats.sh" \
+    --query summary \
+    --memory-path "$TEST_DIR/test-stats.sqlite" 2>&1); then
+
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      # Check summary fields
+      if echo "$result" | jq -e '.totalReflections and .avgComplexity and .maxComplexity' > /dev/null 2>&1; then
+        pass "Context stats summary provides analytics"
+      else
+        fail "Context stats summary missing required fields"
+      fi
+    else
+      fail "Context stats summary returned invalid JSON"
+    fi
+  else
+    fail "Context stats summary script failed: $result"
+  fi
+}
+
+# Test 4: Context Query
+test_context_query() {
+  echo "Running: Context Query Test"
+
+  # Create reflections with specific keywords
+  "$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context '{"task": "authentication", "features": ["JWT", "OAuth"]}' \
+    --memory-path "$TEST_DIR/test-query.sqlite" > /dev/null 2>&1
+
+  "$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context '{"task": "deployment", "features": ["Docker", "K8s"]}' \
+    --memory-path "$TEST_DIR/test-query.sqlite" > /dev/null 2>&1
+
+  # Query for authentication-related contexts
+  if result=$("$SCRIPT_DIR/invoke-context-query.sh" \
+    --keywords "authentication,JWT" \
+    --similarity-threshold 0.3 \
+    --max-results 5 \
+    --memory-path "$TEST_DIR/test-query.sqlite" 2>&1); then
+
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      # Check if results have similarity scores
+      if echo "$result" | jq -e '.[0].similarity' > /dev/null 2>&1; then
+        pass "Context query finds similar contexts"
+      else
+        fail "Context query results missing similarity scores"
+      fi
+    else
+      fail "Context query returned invalid JSON"
+    fi
+  else
+    fail "Context query script failed: $result"
+  fi
+}
+
+# Test 5: Context Injection
+test_context_inject() {
+  echo "Running: Context Injection Test"
+
+  # Create source context file
+  local context_file="$TEST_DIR/inject-source.json"
+  echo '{"historical": "data", "priority": 0.9, "insights": ["learned behavior"]}' > "$context_file"
+
+  # Test deep merge strategy
+  if result=$("$SCRIPT_DIR/invoke-context-inject.sh" \
+    --context-file "$context_file" \
+    --target-task "test-inject-task" \
+    --merge-strategy deep 2>&1); then
+
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      # Check injection metadata
+      if echo "$result" | jq -e '.taskId and .mergeStrategy and .context' > /dev/null 2>&1; then
+        pass "Context injection merges successfully"
+      else
+        fail "Context injection missing required fields"
+      fi
+    else
+      fail "Context injection returned invalid JSON"
+    fi
+  else
+    fail "Context injection script failed: $result"
+  fi
+}
+
+# Test 6: Context Curation - Simple Merge
+test_context_curate_simple() {
+  echo "Running: Context Curation (Simple) Test"
+
+  # Create multiple context files
+  local ctx1="$TEST_DIR/curate-ctx1.json"
+  local ctx2="$TEST_DIR/curate-ctx2.json"
+  local ctx3="$TEST_DIR/curate-ctx3.json"
+
+  echo '{"agent": "coder-1", "confidence": 0.85, "result": "implemented"}' > "$ctx1"
+  echo '{"agent": "reviewer-1", "confidence": 0.90, "result": "approved"}' > "$ctx2"
+  echo '{"agent": "tester-1", "confidence": 0.80, "result": "validated"}' > "$ctx3"
+
+  # Test simple merge
+  if result=$("$SCRIPT_DIR/invoke-context-curate.sh" \
+    --contexts "$ctx1,$ctx2,$ctx3" \
+    --strategy simple 2>&1); then
+
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      # Check curation metadata
+      if echo "$result" | jq -e '.curated and .strategy == "simple" and .sourceCount == 3' > /dev/null 2>&1; then
+        pass "Context curation handles simple merge"
+      else
+        fail "Context curation metadata incorrect"
+      fi
+    else
+      fail "Context curation returned invalid JSON"
+    fi
+  else
+    fail "Context curation script failed: $result"
+  fi
+}
+
+# Test 7: Context Curation - Consensus Weighted
+test_context_curate_consensus() {
+  echo "Running: Context Curation (Consensus) Test"
+
+  # Use same files as simple test
+  local ctx1="$TEST_DIR/curate-ctx1.json"
+  local ctx2="$TEST_DIR/curate-ctx2.json"
+  local ctx3="$TEST_DIR/curate-ctx3.json"
+
+  # Test consensus-weighted merge
+  if result=$("$SCRIPT_DIR/invoke-context-curate.sh" \
+    --contexts "$ctx1,$ctx2,$ctx3" \
+    --strategy consensus-weighted 2>&1); then
+
+    if echo "$result" | jq . > /dev/null 2>&1; then
+      if echo "$result" | jq -e '.strategy == "consensus-weighted"' > /dev/null 2>&1; then
+        pass "Context curation handles consensus weighting"
+      else
+        fail "Context curation strategy not applied"
+      fi
+    else
+      fail "Context curation consensus returned invalid JSON"
+    fi
+  else
+    fail "Context curation consensus script failed: $result"
+  fi
+}
+
+# Test 8: Integration Test - Full CFN Loop Workflow
+test_cfn_loop_integration() {
+  echo "Running: CFN Loop Integration Test"
+
+  local loop_db="$TEST_DIR/cfn-loop.sqlite"
+
+  # Loop 3: Primary implementation
+  "$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context '{"phase": "loop3", "agent": "coder-1", "task": "implement-feature"}' \
+    --memory-path "$loop_db" \
+    --output "$TEST_DIR/loop3-agent1.json" > /dev/null 2>&1
+
+  "$SCRIPT_DIR/invoke-context-reflect.sh" \
+    --context '{"phase": "loop3", "agent": "devops-1", "task": "deploy-infrastructure"}' \
+    --memory-path "$loop_db" \
+    --output "$TEST_DIR/loop3-agent2.json" > /dev/null 2>&1
+
+  # Loop 2: Validation consensus
+  "$SCRIPT_DIR/invoke-context-curate.sh" \
+    --contexts "$TEST_DIR/loop3-agent1.json,$TEST_DIR/loop3-agent2.json" \
+    --strategy consensus-weighted \
+    --output "$TEST_DIR/loop2-merged.json" > /dev/null 2>&1
+
+  # Product Owner: Final decision
+  if "$SCRIPT_DIR/invoke-context-inject.sh" \
+    --context-file "$TEST_DIR/loop2-merged.json" \
+    --target-task "cfn-loop-final" \
+    --merge-strategy deep \
+    --output "$TEST_DIR/final-context.json" > /dev/null 2>&1; then
+
+    # Validate final output exists and is valid JSON
+    if [ -f "$TEST_DIR/final-context.json" ] && jq . "$TEST_DIR/final-context.json" > /dev/null 2>&1; then
+      pass "CFN Loop integration workflow completes successfully"
+    else
+      fail "CFN Loop final context invalid"
+    fi
+  else
+    fail "CFN Loop integration workflow failed"
+  fi
+}
+
+# Run all tests
+echo "========================================="
+echo "ACE System Skill Test Suite"
+echo "========================================="
+echo ""
+
+test_context_reflect
+test_context_stats
+test_context_stats_summary
+test_context_query
+test_context_inject
+test_context_curate_simple
+test_context_curate_consensus
+test_cfn_loop_integration
+
+echo ""
+echo "========================================="
+echo "Test Results"
+echo "========================================="
+echo "PASS: $PASS_COUNT"
+echo "FAIL: $FAIL_COUNT"
+echo ""
+
+if [ $FAIL_COUNT -eq 0 ]; then
+  echo "All tests passed!"
+  exit 0
+else
+  echo "Some tests failed."
+  exit 1
+fi

package/claude-assets/skills/cfn-ace-system/track-ab-test.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# ACE System A/B Test Tracking
+
+set -euo pipefail
+
+# Input parameters
+TASK_ID="${1:?Task ID required}"
+AGENT_ID="${2:?Agent ID required}"
+ACE_ENABLED="${3:-false}"
+
+# Redis key for A/B test tracking
+REDIS_KEY="ace:ab_test:${TASK_ID}:${AGENT_ID}"
+
+# Track A/B test metadata
+track_ab_test() {
+    local context_relevance_score="${4:-0.5}"
+
+    redis-cli HMSET "$REDIS_KEY" \
+        enabled "$ACE_ENABLED" \
+        timestamp "$(date +%s)" \
+        context_relevance_score "$context_relevance_score"
+
+    # Set 7-day expiration
+    redis-cli EXPIRE "$REDIS_KEY" 604800
+}
+
+# Log context injection details
+log_context_injection() {
+    local domain="${4:-undefined}"
+    local injection_time="${5:-0}"
+
+    redis-cli HMSET "${REDIS_KEY}:injection" \
+        domain "$domain" \
+        injection_time "$injection_time"
+}
+
+# Main execution
+track_ab_test "$@"
+log_context_injection "$@"
+
+# Output for logging/debugging
+echo "Tracked A/B test for Task: $TASK_ID, Agent: $AGENT_ID, ACE Enabled: $ACE_ENABLED"

package/claude-assets/skills/cfn-ace-system/update-reflection.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Update reflection status
+# Usage: ./update-reflection.sh --reflection-id refl-123 --status merged --merged-bullet-ids '["STRAT-007"]'
+
+set -e
+
+DB_PATH="${ACE_DB_PATH:-./.artifacts/database/swarm-memory.db}"
+REFLECTION_ID=""
+STATUS=""
+MERGED_BULLET_IDS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --reflection-id) REFLECTION_ID="$2"; shift 2 ;;
+    --status) STATUS="$2"; shift 2 ;;
+    --merged-bullet-ids) MERGED_BULLET_IDS="$2"; shift 2 ;;
+    *) echo "Unknown option: $1"; exit 1 ;;
+  esac
+done
+
+if [ -z "$REFLECTION_ID" ] || [ -z "$STATUS" ]; then
+  echo "Error: --reflection-id and --status required"
+  exit 1
+fi
+
+sqlite3 "$DB_PATH" <<EOF
+UPDATE context_reflections
+SET curator_status = '${STATUS}',
+    merged_bullet_ids = $([ -n "$MERGED_BULLET_IDS" ] && echo "'$MERGED_BULLET_IDS'" || echo "NULL"),
+    processed_at = CURRENT_TIMESTAMP
+WHERE id = '${REFLECTION_ID}';
+EOF
+
+COUNT=$(sqlite3 "$DB_PATH" "SELECT changes();")
+
+if [ "$COUNT" -gt 0 ]; then
+  echo "{\"status\":\"success\",\"reflection_id\":\"${REFLECTION_ID}\",\"new_status\":\"${STATUS}\"}"
+else
+  echo "{\"status\":\"error\",\"message\":\"Reflection not found: ${REFLECTION_ID}\"}"
+  exit 1
+fi

package/claude-assets/skills/cfn-agent-discovery/SKILL.md

@@ -0,0 +1,40 @@
+# Agent Discovery Skill
+
+## Purpose
+Automatically discover and catalog available agents in the Claude Flow Novice system by scanning the `.claude/agents/` directory and extracting metadata from agent definition files.
+
+## Key Features
+- Scan `.claude/agents/*.md` files
+- Extract metadata: name, description, type, keywords/tags
+- Generate structured JSON registry
+- Categorize agents by loop (Loop 3 or Loop 2)
+
+## Agent Categorization
+- **Loop 3 (Implementers)**:
+  - Types: coder, developer, backend-dev, react-frontend-engineer, architect, researcher, designer, writer, analyst
+- **Loop 2 (Validators)**:
+  - Types: reviewer, tester, security-auditor, performance-analyzer, validator
+- **Coordinators**: Separate category, not included in agent selection
+
+## Usage
+```bash
+./.claude/skills/agent-discovery/discover-agents.sh
+```
+
+## Output
+Generates `.claude/skills/agent-discovery/agents-registry.json` with comprehensive agent metadata.
+
+## Error Handling
+- Robust parsing of agent files
+- Handles missing or malformed frontmatter
+- Generates sensible defaults for missing metadata
+
+## Performance
+- Optimized for quick scanning of agent files
+- Minimal computational overhead
+- Periodic refresh recommended
+
+## Best Practices
+- Keep agent definition files well-structured
+- Include comprehensive frontmatter
+- Use consistent metadata across agent definitions

package/claude-assets/skills/cfn-agent-discovery/agents-registry-fixed.json

@@ -0,0 +1,19 @@
+{
+  "agents": [
+    {
+      "name": "coder",
+      "description": "MUST BE USED when implementing features, writing code, fixing bugs.\nUse PROACTIVELY for API development, component creation, refactoring.\nKeywords - implement, code, build, develop, create, refactor, optimize, fix\n",
+      "type": "specialist",
+      "keywords": [
+        "code-implementation",
+        "feature-development",
+        "test-driven-development",
+        "refactoring",
+        "api-design",
+        "quality-engineering"
+      ]
+    }
+  ],
+  "last_updated": "2025-10-24T18:00:47Z",
+  "total_agents": 1
+}