claude-flow 3.28.0 → 3.29.0

package/.claude/helpers/perf-worker.sh

@@ -1,160 +1,160 @@
-#!/bin/bash
-# RuFlo V3 - Performance Benchmark Worker
-# Runs periodic benchmarks and updates metrics using agentic-flow agents
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
-PERF_FILE="$METRICS_DIR/performance.json"
-LAST_RUN_FILE="$METRICS_DIR/.perf-last-run"
-
-mkdir -p "$METRICS_DIR"
-
-# Check if we should run (throttle to once per 5 minutes)
-should_run() {
-  if [ ! -f "$LAST_RUN_FILE" ]; then
-    return 0
-  fi
-
-  local last_run=$(cat "$LAST_RUN_FILE" 2>/dev/null || echo "0")
-  local now=$(date +%s)
-  local diff=$((now - last_run))
-
-  # Run every 5 minutes (300 seconds)
-  [ "$diff" -ge 300 ]
-}
-
-# Simple search benchmark (measures grep/search speed)
-benchmark_search() {
-  local start=$(date +%s%3N)
-
-  # Search through v3 codebase
-  find "$PROJECT_ROOT/v3" -name "*.ts" -type f 2>/dev/null | \
-    xargs grep -l "function\|class\|interface" 2>/dev/null | \
-    wc -l > /dev/null
-
-  local end=$(date +%s%3N)
-  local duration=$((end - start))
-
-  # Baseline is ~100ms, calculate improvement
-  local baseline=100
-  if [ "$duration" -gt 0 ]; then
-    local improvement=$(echo "scale=2; $baseline / $duration" | bc 2>/dev/null || echo "1.0")
-    echo "${improvement}x"
-  else
-    echo "1.0x"
-  fi
-}
-
-# Memory efficiency check
-benchmark_memory() {
-  local node_mem=$(ps aux 2>/dev/null | grep -E "(node|agentic)" | grep -v grep | awk '{sum += $6} END {print int(sum/1024)}')
-  local baseline_mem=4000  # 4GB baseline
-
-  if [ -n "$node_mem" ] && [ "$node_mem" -gt 0 ]; then
-    local reduction=$(echo "scale=0; 100 - ($node_mem * 100 / $baseline_mem)" | bc 2>/dev/null || echo "0")
-    if [ "$reduction" -lt 0 ]; then reduction=0; fi
-    echo "${reduction}%"
-  else
-    echo "0%"
-  fi
-}
-
-# Startup time check
-benchmark_startup() {
-  local start=$(date +%s%3N)
-
-  # Quick check of agentic-flow responsiveness
-  timeout 5 npx agentic-flow@alpha --version >/dev/null 2>&1 || true
-
-  local end=$(date +%s%3N)
-  local duration=$((end - start))
-
-  echo "${duration}ms"
-}
-
-# Run benchmarks and update metrics
-run_benchmarks() {
-  echo "[$(date +%H:%M:%S)] Running performance benchmarks..."
-
-  local search_speed=$(benchmark_search)
-  local memory_reduction=$(benchmark_memory)
-  local startup_time=$(benchmark_startup)
-
-  # Calculate overall speedup (simplified)
-  local speedup_num=$(echo "$search_speed" | tr -d 'x')
-  if [ -z "$speedup_num" ] || [ "$speedup_num" = "1.0" ]; then
-    speedup_num="1.0"
-  fi
-
-  # Update performance.json
-  if [ -f "$PERF_FILE" ] && command -v jq &>/dev/null; then
-    jq --arg search "$search_speed" \
-       --arg memory "$memory_reduction" \
-       --arg startup "$startup_time" \
-       --arg speedup "${speedup_num}x" \
-       --arg updated "$(date -Iseconds)" \
-       '.search.improvement = $search |
-        .memory.reduction = $memory |
-        .startupTime.current = $startup |
-        .flashAttention.speedup = $speedup |
-        ."last-updated" = $updated' \
-       "$PERF_FILE" > "$PERF_FILE.tmp" && mv "$PERF_FILE.tmp" "$PERF_FILE"
-
-    echo "[$(date +%H:%M:%S)] ✓ Metrics updated: search=$search_speed memory=$memory_reduction startup=$startup_time"
-  else
-    echo "[$(date +%H:%M:%S)] ⚠ Could not update metrics (missing jq or file)"
-  fi
-
-  # Record last run time
-  date +%s > "$LAST_RUN_FILE"
-}
-
-# Spawn agentic-flow performance agent for deep analysis
-run_deep_benchmark() {
-  echo "[$(date +%H:%M:%S)] Spawning performance-benchmarker agent..."
-
-  npx agentic-flow@alpha --agent perf-analyzer --task "Analyze current system performance and update metrics" 2>/dev/null &
-  local pid=$!
-
-  # Don't wait, let it run in background
-  echo "[$(date +%H:%M:%S)] Agent spawned (PID: $pid)"
-}
-
-# Main dispatcher
-case "${1:-check}" in
-  "run"|"benchmark")
-    run_benchmarks
-    ;;
-  "deep")
-    run_deep_benchmark
-    ;;
-  "check")
-    if should_run; then
-      run_benchmarks
-    else
-      echo "[$(date +%H:%M:%S)] Skipping benchmark (throttled)"
-    fi
-    ;;
-  "force")
-    rm -f "$LAST_RUN_FILE"
-    run_benchmarks
-    ;;
-  "status")
-    if [ -f "$PERF_FILE" ]; then
-      jq -r '"Search: \(.search.improvement // "1x") | Memory: \(.memory.reduction // "0%") | Startup: \(.startupTime.current // "N/A")"' "$PERF_FILE" 2>/dev/null
-    else
-      echo "No metrics available"
-    fi
-    ;;
-  *)
-    echo "Usage: perf-worker.sh [run|deep|check|force|status]"
-    echo "  run    - Run quick benchmarks"
-    echo "  deep   - Spawn agentic-flow agent for deep analysis"
-    echo "  check  - Run if throttle allows (default)"
-    echo "  force  - Force run ignoring throttle"
-    echo "  status - Show current metrics"
-    ;;
-esac
+#!/bin/bash
+# RuFlo V3 - Performance Benchmark Worker
+# Runs periodic benchmarks and updates metrics using agentic-flow agents
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
+PERF_FILE="$METRICS_DIR/performance.json"
+LAST_RUN_FILE="$METRICS_DIR/.perf-last-run"
+
+mkdir -p "$METRICS_DIR"
+
+# Check if we should run (throttle to once per 5 minutes)
+should_run() {
+  if [ ! -f "$LAST_RUN_FILE" ]; then
+    return 0
+  fi
+
+  local last_run=$(cat "$LAST_RUN_FILE" 2>/dev/null || echo "0")
+  local now=$(date +%s)
+  local diff=$((now - last_run))
+
+  # Run every 5 minutes (300 seconds)
+  [ "$diff" -ge 300 ]
+}
+
+# Simple search benchmark (measures grep/search speed)
+benchmark_search() {
+  local start=$(date +%s%3N)
+
+  # Search through v3 codebase
+  find "$PROJECT_ROOT/v3" -name "*.ts" -type f 2>/dev/null | \
+    xargs grep -l "function\|class\|interface" 2>/dev/null | \
+    wc -l > /dev/null
+
+  local end=$(date +%s%3N)
+  local duration=$((end - start))
+
+  # Baseline is ~100ms, calculate improvement
+  local baseline=100
+  if [ "$duration" -gt 0 ]; then
+    local improvement=$(echo "scale=2; $baseline / $duration" | bc 2>/dev/null || echo "1.0")
+    echo "${improvement}x"
+  else
+    echo "1.0x"
+  fi
+}
+
+# Memory efficiency check
+benchmark_memory() {
+  local node_mem=$(ps aux 2>/dev/null | grep -E "(node|agentic)" | grep -v grep | awk '{sum += $6} END {print int(sum/1024)}')
+  local baseline_mem=4000  # 4GB baseline
+
+  if [ -n "$node_mem" ] && [ "$node_mem" -gt 0 ]; then
+    local reduction=$(echo "scale=0; 100 - ($node_mem * 100 / $baseline_mem)" | bc 2>/dev/null || echo "0")
+    if [ "$reduction" -lt 0 ]; then reduction=0; fi
+    echo "${reduction}%"
+  else
+    echo "0%"
+  fi
+}
+
+# Startup time check
+benchmark_startup() {
+  local start=$(date +%s%3N)
+
+  # Quick check of agentic-flow responsiveness
+  timeout 5 npx agentic-flow@alpha --version >/dev/null 2>&1 || true
+
+  local end=$(date +%s%3N)
+  local duration=$((end - start))
+
+  echo "${duration}ms"
+}
+
+# Run benchmarks and update metrics
+run_benchmarks() {
+  echo "[$(date +%H:%M:%S)] Running performance benchmarks..."
+
+  local search_speed=$(benchmark_search)
+  local memory_reduction=$(benchmark_memory)
+  local startup_time=$(benchmark_startup)
+
+  # Calculate overall speedup (simplified)
+  local speedup_num=$(echo "$search_speed" | tr -d 'x')
+  if [ -z "$speedup_num" ] || [ "$speedup_num" = "1.0" ]; then
+    speedup_num="1.0"
+  fi
+
+  # Update performance.json
+  if [ -f "$PERF_FILE" ] && command -v jq &>/dev/null; then
+    jq --arg search "$search_speed" \
+       --arg memory "$memory_reduction" \
+       --arg startup "$startup_time" \
+       --arg speedup "${speedup_num}x" \
+       --arg updated "$(date -Iseconds)" \
+       '.search.improvement = $search |
+        .memory.reduction = $memory |
+        .startupTime.current = $startup |
+        .flashAttention.speedup = $speedup |
+        ."last-updated" = $updated' \
+       "$PERF_FILE" > "$PERF_FILE.tmp" && mv "$PERF_FILE.tmp" "$PERF_FILE"
+
+    echo "[$(date +%H:%M:%S)] ✓ Metrics updated: search=$search_speed memory=$memory_reduction startup=$startup_time"
+  else
+    echo "[$(date +%H:%M:%S)] ⚠ Could not update metrics (missing jq or file)"
+  fi
+
+  # Record last run time
+  date +%s > "$LAST_RUN_FILE"
+}
+
+# Spawn agentic-flow performance agent for deep analysis
+run_deep_benchmark() {
+  echo "[$(date +%H:%M:%S)] Spawning performance-benchmarker agent..."
+
+  npx agentic-flow@alpha --agent perf-analyzer --task "Analyze current system performance and update metrics" 2>/dev/null &
+  local pid=$!
+
+  # Don't wait, let it run in background
+  echo "[$(date +%H:%M:%S)] Agent spawned (PID: $pid)"
+}
+
+# Main dispatcher
+case "${1:-check}" in
+  "run"|"benchmark")
+    run_benchmarks
+    ;;
+  "deep")
+    run_deep_benchmark
+    ;;
+  "check")
+    if should_run; then
+      run_benchmarks
+    else
+      echo "[$(date +%H:%M:%S)] Skipping benchmark (throttled)"
+    fi
+    ;;
+  "force")
+    rm -f "$LAST_RUN_FILE"
+    run_benchmarks
+    ;;
+  "status")
+    if [ -f "$PERF_FILE" ]; then
+      jq -r '"Search: \(.search.improvement // "1x") | Memory: \(.memory.reduction // "0%") | Startup: \(.startupTime.current // "N/A")"' "$PERF_FILE" 2>/dev/null
+    else
+      echo "No metrics available"
+    fi
+    ;;
+  *)
+    echo "Usage: perf-worker.sh [run|deep|check|force|status]"
+    echo "  run    - Run quick benchmarks"
+    echo "  deep   - Spawn agentic-flow agent for deep analysis"
+    echo "  check  - Run if throttle allows (default)"
+    echo "  force  - Force run ignoring throttle"
+    echo "  status - Show current metrics"
+    ;;
+esac

package/.claude/helpers/quick-start.sh

@@ -1,19 +1,19 @@
-#!/bin/bash
-# Quick start guide for Claude Flow
-
-echo "🚀 Claude Flow Quick Start"
-echo "=========================="
-echo ""
-echo "1. Initialize a swarm:"
-echo "   npx claude-flow swarm init --topology hierarchical"
-echo ""
-echo "2. Spawn agents:"
-echo "   npx claude-flow agent spawn --type coder --name "API Developer""
-echo ""
-echo "3. Orchestrate tasks:"
-echo "   npx claude-flow task orchestrate --task "Build REST API""
-echo ""
-echo "4. Monitor progress:"
-echo "   npx claude-flow swarm monitor"
-echo ""
-echo "📚 For more examples, see .claude/commands/"
+#!/bin/bash
+# Quick start guide for Claude Flow
+
+echo "🚀 Claude Flow Quick Start"
+echo "=========================="
+echo ""
+echo "1. Initialize a swarm:"
+echo "   npx claude-flow swarm init --topology hierarchical"
+echo ""
+echo "2. Spawn agents:"
+echo "   npx claude-flow agent spawn --type coder --name "API Developer""
+echo ""
+echo "3. Orchestrate tasks:"
+echo "   npx claude-flow task orchestrate --task "Build REST API""
+echo ""
+echo "4. Monitor progress:"
+echo "   npx claude-flow swarm monitor"
+echo ""
+echo "📚 For more examples, see .claude/commands/"

package/.claude/helpers/router.cjs

@@ -1,62 +1,62 @@
-#!/usr/bin/env node
-/**
- * Claude Flow Agent Router
- * Routes tasks to optimal agents based on learned patterns
- */
-
-const AGENT_CAPABILITIES = {
-  coder: ['code-generation', 'refactoring', 'debugging', 'implementation'],
-  tester: ['unit-testing', 'integration-testing', 'coverage', 'test-generation'],
-  reviewer: ['code-review', 'security-audit', 'quality-check', 'best-practices'],
-  researcher: ['web-search', 'documentation', 'analysis', 'summarization'],
-  architect: ['system-design', 'architecture', 'patterns', 'scalability'],
-  'backend-dev': ['api', 'database', 'server', 'authentication'],
-  'frontend-dev': ['ui', 'react', 'css', 'components'],
-  devops: ['ci-cd', 'docker', 'deployment', 'infrastructure'],
-};
-
-const TASK_PATTERNS = {
-  'implement|create|build|add|write code': 'coder',
-  'test|spec|coverage|unit test|integration': 'tester',
-  'review|audit|check|validate|security': 'reviewer',
-  'research|find|search|documentation|explore': 'researcher',
-  'design|architect|structure|plan': 'architect',
-  'api|endpoint|server|backend|database': 'backend-dev',
-  'ui|frontend|component|react|css|style': 'frontend-dev',
-  'deploy|docker|ci|cd|pipeline|infrastructure': 'devops',
-};
-
-function routeTask(task) {
-  const taskLower = task.toLowerCase();
-
-  for (const [pattern, agent] of Object.entries(TASK_PATTERNS)) {
-    const regex = new RegExp(pattern, 'i');
-    if (regex.test(taskLower)) {
-      return {
-        agent,
-        confidence: 0.8,
-        reason: `Matched pattern: ${pattern}`,
-      };
-    }
-  }
-
-  return {
-    agent: 'coder',
-    confidence: 0.5,
-    reason: 'Default routing - no specific pattern matched',
-  };
-}
-
-module.exports = { routeTask, AGENT_CAPABILITIES, TASK_PATTERNS };
-
-// CLI - only run when executed directly
-if (require.main === module) {
-  const task = process.argv.slice(2).join(' ');
-  if (task) {
-    const result = routeTask(task);
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    console.log('Usage: router.js <task description>');
-    console.log('\nAvailable agents:', Object.keys(AGENT_CAPABILITIES).join(', '));
-  }
-}
+#!/usr/bin/env node
+/**
+ * Claude Flow Agent Router
+ * Routes tasks to optimal agents based on learned patterns
+ */
+
+const AGENT_CAPABILITIES = {
+  coder: ['code-generation', 'refactoring', 'debugging', 'implementation'],
+  tester: ['unit-testing', 'integration-testing', 'coverage', 'test-generation'],
+  reviewer: ['code-review', 'security-audit', 'quality-check', 'best-practices'],
+  researcher: ['web-search', 'documentation', 'analysis', 'summarization'],
+  architect: ['system-design', 'architecture', 'patterns', 'scalability'],
+  'backend-dev': ['api', 'database', 'server', 'authentication'],
+  'frontend-dev': ['ui', 'react', 'css', 'components'],
+  devops: ['ci-cd', 'docker', 'deployment', 'infrastructure'],
+};
+
+const TASK_PATTERNS = {
+  'implement|create|build|add|write code': 'coder',
+  'test|spec|coverage|unit test|integration': 'tester',
+  'review|audit|check|validate|security': 'reviewer',
+  'research|find|search|documentation|explore': 'researcher',
+  'design|architect|structure|plan': 'architect',
+  'api|endpoint|server|backend|database': 'backend-dev',
+  'ui|frontend|component|react|css|style': 'frontend-dev',
+  'deploy|docker|ci|cd|pipeline|infrastructure': 'devops',
+};
+
+function routeTask(task) {
+  const taskLower = task.toLowerCase();
+
+  for (const [pattern, agent] of Object.entries(TASK_PATTERNS)) {
+    const regex = new RegExp(pattern, 'i');
+    if (regex.test(taskLower)) {
+      return {
+        agent,
+        confidence: 0.8,
+        reason: `Matched pattern: ${pattern}`,
+      };
+    }
+  }
+
+  return {
+    agent: 'coder',
+    confidence: 0.5,
+    reason: 'Default routing - no specific pattern matched',
+  };
+}
+
+module.exports = { routeTask, AGENT_CAPABILITIES, TASK_PATTERNS };
+
+// CLI - only run when executed directly
+if (require.main === module) {
+  const task = process.argv.slice(2).join(' ');
+  if (task) {
+    const result = routeTask(task);
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log('Usage: router.js <task description>');
+    console.log('\nAvailable agents:', Object.keys(AGENT_CAPABILITIES).join(', '));
+  }
+}