@claude-flow/cli 3.0.0-alpha.37 → 3.0.0-alpha.39

package/.claude/helpers/v3.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# V3 Helper Alias Script - Quick access to all V3 development tools
+
+set -e
+
+HELPERS_DIR=".claude/helpers"
+
+case "$1" in
+  "status"|"st")
+    "$HELPERS_DIR/v3-quick-status.sh"
+    ;;
+
+  "progress"|"prog")
+    shift
+    "$HELPERS_DIR/update-v3-progress.sh" "$@"
+    ;;
+
+  "validate"|"check")
+    "$HELPERS_DIR/validate-v3-config.sh"
+    ;;
+
+  "statusline"|"sl")
+    ".claude/statusline.sh"
+    ;;
+
+  "update")
+    if [ -z "$2" ] || [ -z "$3" ]; then
+      echo "Usage: v3 update <metric> <value>"
+      echo "Examples:"
+      echo "  v3 update domain 3"
+      echo "  v3 update agent 8"
+      echo "  v3 update security 2"
+      echo "  v3 update performance 2.5x"
+      echo "  v3 update memory 45%"
+      echo "  v3 update ddd 75"
+      exit 1
+    fi
+    "$HELPERS_DIR/update-v3-progress.sh" "$2" "$3"
+    ;;
+
+  "full-status"|"fs")
+    echo "🔍 V3 Development Environment Status"
+    echo "====================================="
+    echo ""
+    echo "📊 Quick Status:"
+    "$HELPERS_DIR/v3-quick-status.sh"
+    echo ""
+    echo "📺 Full Statusline:"
+    ".claude/statusline.sh"
+    ;;
+
+  "init")
+    echo "🚀 Initializing V3 Development Environment..."
+
+    # Run validation first
+    echo ""
+    echo "1️⃣ Validating configuration..."
+    if "$HELPERS_DIR/validate-v3-config.sh"; then
+      echo ""
+      echo "2️⃣ Showing current status..."
+      "$HELPERS_DIR/v3-quick-status.sh"
+      echo ""
+      echo "✅ V3 development environment is ready!"
+      echo ""
+      echo "🔧 Quick commands:"
+      echo "  v3 status        - Show quick status"
+      echo "  v3 update        - Update progress metrics"
+      echo "  v3 statusline    - Show full statusline"
+      echo "  v3 validate      - Validate configuration"
+    else
+      echo ""
+      echo "❌ Configuration validation failed. Please fix issues before proceeding."
+      exit 1
+    fi
+    ;;
+
+  "help"|"--help"|"-h"|"")
+    echo "Claude Flow V3 Helper Tool"
+    echo "=========================="
+    echo ""
+    echo "Usage: v3 <command> [options]"
+    echo ""
+    echo "Commands:"
+    echo "  status, st              Show quick development status"
+    echo "  progress, prog [args]   Update progress metrics"
+    echo "  validate, check         Validate V3 configuration"
+    echo "  statusline, sl          Show full statusline"
+    echo "  full-status, fs         Show both quick status and statusline"
+    echo "  update <metric> <value> Update specific metric"
+    echo "  init                    Initialize and validate environment"
+    echo "  help                    Show this help message"
+    echo ""
+    echo "Update Examples:"
+    echo "  v3 update domain 3      # Mark 3 domains complete"
+    echo "  v3 update agent 8       # Set 8 agents active"
+    echo "  v3 update security 2    # Mark 2 CVEs fixed"
+    echo "  v3 update performance 2.5x # Set performance to 2.5x"
+    echo "  v3 update memory 45%    # Set memory reduction to 45%"
+    echo "  v3 update ddd 75        # Set DDD progress to 75%"
+    echo ""
+    echo "Quick Start:"
+    echo "  v3 init                 # Initialize environment"
+    echo "  v3 status               # Check current progress"
+    ;;
+
+  *)
+    echo "Unknown command: $1"
+    echo "Run 'v3 help' for usage information"
+    exit 1
+    ;;
+esac

package/.claude/helpers/validate-v3-config.sh

@@ -0,0 +1,216 @@
+#!/bin/bash
+# V3 Configuration Validation Script
+# Ensures all V3 development dependencies and configurations are properly set up
+
+set -e
+
+echo "🔍 Claude Flow V3 Configuration Validation"
+echo "==========================================="
+echo ""
+
+ERRORS=0
+WARNINGS=0
+
+# Color codes
+RED='\033[0;31m'
+YELLOW='\033[0;33m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+RESET='\033[0m'
+
+# Helper functions
+log_error() {
+  echo -e "${RED}❌ ERROR: $1${RESET}"
+  ((ERRORS++))
+}
+
+log_warning() {
+  echo -e "${YELLOW}⚠️  WARNING: $1${RESET}"
+  ((WARNINGS++))
+}
+
+log_success() {
+  echo -e "${GREEN}✅ $1${RESET}"
+}
+
+log_info() {
+  echo -e "${BLUE}ℹ️  $1${RESET}"
+}
+
+# Check 1: Required directories
+echo "📁 Checking Directory Structure..."
+required_dirs=(
+  ".claude"
+  ".claude/helpers"
+  ".claude-flow/metrics"
+  ".claude-flow/security"
+  "src"
+  "src/domains"
+)
+
+for dir in "${required_dirs[@]}"; do
+  if [ -d "$dir" ]; then
+    log_success "Directory exists: $dir"
+  else
+    log_error "Missing required directory: $dir"
+  fi
+done
+
+# Check 2: Required files
+echo ""
+echo "📄 Checking Required Files..."
+required_files=(
+  ".claude/settings.json"
+  ".claude/statusline.sh"
+  ".claude/helpers/update-v3-progress.sh"
+  ".claude-flow/metrics/v3-progress.json"
+  ".claude-flow/metrics/performance.json"
+  ".claude-flow/security/audit-status.json"
+  "package.json"
+)
+
+for file in "${required_files[@]}"; do
+  if [ -f "$file" ]; then
+    log_success "File exists: $file"
+
+    # Additional checks for specific files
+    case "$file" in
+      "package.json")
+        if grep -q "agentic-flow.*alpha" "$file" 2>/dev/null; then
+          log_success "agentic-flow@alpha dependency found"
+        else
+          log_warning "agentic-flow@alpha dependency not found in package.json"
+        fi
+        ;;
+      ".claude/helpers/update-v3-progress.sh")
+        if [ -x "$file" ]; then
+          log_success "Helper script is executable"
+        else
+          log_error "Helper script is not executable: $file"
+        fi
+        ;;
+      ".claude-flow/metrics/v3-progress.json")
+        if jq empty "$file" 2>/dev/null; then
+          log_success "V3 progress JSON is valid"
+          domains=$(jq -r '.domains.total // "unknown"' "$file" 2>/dev/null)
+          agents=$(jq -r '.swarm.totalAgents // "unknown"' "$file" 2>/dev/null)
+          log_info "Configured for $domains domains, $agents agents"
+        else
+          log_error "Invalid JSON in v3-progress.json"
+        fi
+        ;;
+    esac
+  else
+    log_error "Missing required file: $file"
+  fi
+done
+
+# Check 3: Domain structure
+echo ""
+echo "🏗️ Checking Domain Structure..."
+expected_domains=("task-management" "session-management" "health-monitoring" "lifecycle-management" "event-coordination")
+
+for domain in "${expected_domains[@]}"; do
+  domain_path="src/domains/$domain"
+  if [ -d "$domain_path" ]; then
+    log_success "Domain directory exists: $domain"
+  else
+    log_warning "Domain directory missing: $domain (will be created during development)"
+  fi
+done
+
+# Check 4: Git configuration
+echo ""
+echo "🔀 Checking Git Configuration..."
+if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  log_success "Git repository detected"
+
+  current_branch=$(git branch --show-current 2>/dev/null || echo "unknown")
+  log_info "Current branch: $current_branch"
+
+  if [ "$current_branch" = "v3" ]; then
+    log_success "On V3 development branch"
+  else
+    log_warning "Not on V3 branch (current: $current_branch)"
+  fi
+else
+  log_error "Not in a Git repository"
+fi
+
+# Check 5: Node.js and npm
+echo ""
+echo "📦 Checking Node.js Environment..."
+if command -v node >/dev/null 2>&1; then
+  node_version=$(node --version)
+  log_success "Node.js installed: $node_version"
+
+  # Check if Node.js version is 20+
+  node_major=$(echo "$node_version" | cut -d'.' -f1 | sed 's/v//')
+  if [ "$node_major" -ge 20 ]; then
+    log_success "Node.js version meets requirements (≥20.0.0)"
+  else
+    log_error "Node.js version too old. Required: ≥20.0.0, Found: $node_version"
+  fi
+else
+  log_error "Node.js not installed"
+fi
+
+if command -v npm >/dev/null 2>&1; then
+  npm_version=$(npm --version)
+  log_success "npm installed: $npm_version"
+else
+  log_error "npm not installed"
+fi
+
+# Check 6: Development tools
+echo ""
+echo "🔧 Checking Development Tools..."
+dev_tools=("jq" "git")
+
+for tool in "${dev_tools[@]}"; do
+  if command -v "$tool" >/dev/null 2>&1; then
+    tool_version=$($tool --version 2>/dev/null | head -n1 || echo "unknown")
+    log_success "$tool installed: $tool_version"
+  else
+    log_error "$tool not installed"
+  fi
+done
+
+# Check 7: Permissions
+echo ""
+echo "🔐 Checking Permissions..."
+test_files=(
+  ".claude/statusline.sh"
+  ".claude/helpers/update-v3-progress.sh"
+)
+
+for file in "${test_files[@]}"; do
+  if [ -f "$file" ]; then
+    if [ -x "$file" ]; then
+      log_success "Executable permissions: $file"
+    else
+      log_warning "Missing executable permissions: $file"
+      log_info "Run: chmod +x $file"
+    fi
+  fi
+done
+
+# Summary
+echo ""
+echo "📊 Validation Summary"
+echo "===================="
+if [ $ERRORS -eq 0 ] && [ $WARNINGS -eq 0 ]; then
+  log_success "All checks passed! V3 development environment is ready."
+  exit 0
+elif [ $ERRORS -eq 0 ]; then
+  echo -e "${YELLOW}⚠️  $WARNINGS warnings found, but no critical errors.${RESET}"
+  log_info "V3 development can proceed with minor issues to address."
+  exit 0
+else
+  echo -e "${RED}❌ $ERRORS critical errors found.${RESET}"
+  if [ $WARNINGS -gt 0 ]; then
+    echo -e "${YELLOW}⚠️  $WARNINGS warnings also found.${RESET}"
+  fi
+  log_error "Please fix critical errors before proceeding with V3 development."
+  exit 1
+fi

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

@@ -0,0 +1,170 @@
+#!/bin/bash
+# Claude Flow V3 - Unified Worker Manager
+# Orchestrates all background workers with proper scheduling
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
+PID_FILE="$METRICS_DIR/worker-manager.pid"
+LOG_FILE="$METRICS_DIR/worker-manager.log"
+
+mkdir -p "$METRICS_DIR"
+
+# Worker definitions: name:script:interval_seconds
+WORKERS=(
+  "perf:perf-worker.sh:300"           # 5 min
+  "health:health-monitor.sh:300"       # 5 min
+  "patterns:pattern-consolidator.sh:900"  # 15 min
+  "ddd:ddd-tracker.sh:600"             # 10 min
+  "adr:adr-compliance.sh:900"          # 15 min
+  "security:security-scanner.sh:1800"  # 30 min
+  "learning:learning-optimizer.sh:1800" # 30 min
+)
+
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_FILE"
+}
+
+run_worker() {
+  local name="$1"
+  local script="$2"
+  local script_path="$SCRIPT_DIR/$script"
+
+  if [ -x "$script_path" ]; then
+    "$script_path" check 2>/dev/null &
+  fi
+}
+
+run_all_workers() {
+  log "Running all workers (non-blocking)..."
+
+  for worker_def in "${WORKERS[@]}"; do
+    IFS=':' read -r name script interval <<< "$worker_def"
+    run_worker "$name" "$script"
+  done
+
+  # Don't wait - truly non-blocking
+  log "All workers spawned"
+}
+
+run_daemon() {
+  local interval="${1:-60}"
+
+  log "Starting worker manager daemon (interval: ${interval}s)"
+  echo $$ > "$PID_FILE"
+
+  trap 'log "Shutting down..."; rm -f "$PID_FILE"; exit 0' SIGTERM SIGINT
+
+  while true; do
+    run_all_workers
+    sleep "$interval"
+  done
+}
+
+status_all() {
+  echo "╔══════════════════════════════════════════════════════════════╗"
+  echo "║           Claude Flow V3 - Worker Status                      ║"
+  echo "╠══════════════════════════════════════════════════════════════╣"
+
+  for worker_def in "${WORKERS[@]}"; do
+    IFS=':' read -r name script interval <<< "$worker_def"
+    local script_path="$SCRIPT_DIR/$script"
+
+    if [ -x "$script_path" ]; then
+      local status=$("$script_path" status 2>/dev/null || echo "No data")
+      printf "║ %-10s │ %-48s ║\n" "$name" "$status"
+    fi
+  done
+
+  echo "╠══════════════════════════════════════════════════════════════╣"
+
+  # Check if daemon is running
+  if [ -f "$PID_FILE" ] && kill -0 "$(cat "$PID_FILE")" 2>/dev/null; then
+    echo "║ Daemon: RUNNING (PID: $(cat "$PID_FILE"))                           ║"
+  else
+    echo "║ Daemon: NOT RUNNING                                          ║"
+  fi
+
+  echo "╚══════════════════════════════════════════════════════════════╝"
+}
+
+force_all() {
+  log "Force running all workers..."
+
+  for worker_def in "${WORKERS[@]}"; do
+    IFS=':' read -r name script interval <<< "$worker_def"
+    local script_path="$SCRIPT_DIR/$script"
+
+    if [ -x "$script_path" ]; then
+      log "Running $name..."
+      "$script_path" force 2>&1 | while read -r line; do
+        log "  [$name] $line"
+      done
+    fi
+  done
+
+  log "All workers completed"
+}
+
+case "${1:-help}" in
+  "start"|"daemon")
+    if [ -f "$PID_FILE" ] && kill -0 "$(cat "$PID_FILE")" 2>/dev/null; then
+      echo "Worker manager already running (PID: $(cat "$PID_FILE"))"
+      exit 1
+    fi
+    run_daemon "${2:-60}" &
+    echo "Worker manager started (PID: $!)"
+    ;;
+  "stop")
+    if [ -f "$PID_FILE" ]; then
+      kill "$(cat "$PID_FILE")" 2>/dev/null || true
+      rm -f "$PID_FILE"
+      echo "Worker manager stopped"
+    else
+      echo "Worker manager not running"
+    fi
+    ;;
+  "run"|"once")
+    run_all_workers
+    ;;
+  "force")
+    force_all
+    ;;
+  "status")
+    status_all
+    ;;
+  "logs")
+    tail -50 "$LOG_FILE" 2>/dev/null || echo "No logs available"
+    ;;
+  "help"|*)
+    cat << EOF
+Claude Flow V3 - Worker Manager
+
+Usage: $0 <command> [options]
+
+Commands:
+  start [interval]  Start daemon (default: 60s cycle)
+  stop              Stop daemon
+  run               Run all workers once
+  force             Force run all workers (ignore throttle)
+  status            Show all worker status
+  logs              Show recent logs
+
+Workers:
+  perf              Performance benchmarks (5 min)
+  health            System health monitoring (5 min)
+  patterns          Pattern consolidation (15 min)
+  ddd               DDD progress tracking (10 min)
+  adr               ADR compliance checking (15 min)
+  security          Security scanning (30 min)
+  learning          Learning optimization (30 min)
+
+Examples:
+  $0 start 120      # Start with 2-minute cycle
+  $0 force          # Run all now
+  $0 status         # Check all status
+EOF
+    ;;
+esac

package/dist/src/init/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/init/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAgIxE;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAiF3E;AAwjBD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/init/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAgIxE;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAiF3E;AAspBD,eAAe,WAAW,CAAC"}

package/dist/src/init/executor.js

@@ -397,35 +397,79 @@ async function copyAgents(targetDir, options, result) {
         }
     }
 }
+/**
+ * Find source helpers directory
+ */
+function findSourceHelpersDir(sourceBaseDir) {
+    const possiblePaths = [];
+    // If explicit source base directory is provided, check it first
+    if (sourceBaseDir) {
+        possiblePaths.push(path.join(sourceBaseDir, '.claude', 'helpers'));
+    }
+    // IMPORTANT: Check the package's own .claude/helpers directory
+    // This is the primary path when running as an npm package
+    // __dirname is typically /path/to/node_modules/@claude-flow/cli/dist/src/init
+    // We need to go up 4 levels to reach the package root
+    const packageRoot = path.resolve(__dirname, '..', '..', '..', '..');
+    const packageHelpers = path.join(packageRoot, '.claude', 'helpers');
+    if (fs.existsSync(packageHelpers)) {
+        possiblePaths.unshift(packageHelpers); // Add to beginning (highest priority)
+    }
+    // From dist/src/init -> go up to project root
+    let currentDir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        const parentDir = path.dirname(currentDir);
+        const helpersPath = path.join(parentDir, '.claude', 'helpers');
+        if (fs.existsSync(helpersPath)) {
+            possiblePaths.push(helpersPath);
+        }
+        currentDir = parentDir;
+    }
+    // Also check relative to process.cwd() for development
+    const cwdBased = [
+        path.join(process.cwd(), '.claude', 'helpers'),
+        path.join(process.cwd(), '..', '.claude', 'helpers'),
+        path.join(process.cwd(), '..', '..', '.claude', 'helpers'),
+    ];
+    possiblePaths.push(...cwdBased);
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
 /**
  * Write helper scripts
  */
 async function writeHelpers(targetDir, options, result) {
     const helpersDir = path.join(targetDir, '.claude', 'helpers');
-    const sourceBaseDir = options.sourceBaseDir;
+    // Find source helpers directory (works for npm package and local dev)
+    const sourceHelpersDir = findSourceHelpersDir(options.sourceBaseDir);
     // Try to copy existing helpers from source first
-    if (sourceBaseDir) {
-        const sourceHelpersDir = path.join(sourceBaseDir, '.claude', 'helpers');
-        if (fs.existsSync(sourceHelpersDir)) {
-            const helperFiles = fs.readdirSync(sourceHelpersDir);
-            for (const file of helperFiles) {
-                const sourcePath = path.join(sourceHelpersDir, file);
-                const destPath = path.join(helpersDir, file);
-                // Skip directories and only copy files
-                if (!fs.statSync(sourcePath).isFile())
-                    continue;
-                if (!fs.existsSync(destPath) || options.force) {
-                    fs.copyFileSync(sourcePath, destPath);
-                    // Make shell scripts executable
-                    if (file.endsWith('.sh')) {
-                        fs.chmodSync(destPath, '755');
-                    }
-                    result.created.files.push(`.claude/helpers/${file}`);
-                }
-                else {
-                    result.skipped.push(`.claude/helpers/${file}`);
+    if (sourceHelpersDir && fs.existsSync(sourceHelpersDir)) {
+        const helperFiles = fs.readdirSync(sourceHelpersDir);
+        let copiedCount = 0;
+        for (const file of helperFiles) {
+            const sourcePath = path.join(sourceHelpersDir, file);
+            const destPath = path.join(helpersDir, file);
+            // Skip directories and only copy files
+            if (!fs.statSync(sourcePath).isFile())
+                continue;
+            if (!fs.existsSync(destPath) || options.force) {
+                fs.copyFileSync(sourcePath, destPath);
+                // Make shell scripts and mjs files executable
+                if (file.endsWith('.sh') || file.endsWith('.mjs')) {
+                    fs.chmodSync(destPath, '755');
                 }
+                result.created.files.push(`.claude/helpers/${file}`);
+                copiedCount++;
+            }
+            else {
+                result.skipped.push(`.claude/helpers/${file}`);
             }
+        }
+        if (copiedCount > 0) {
             return; // Skip generating if we copied from source
         }
     }
@@ -452,28 +496,61 @@ async function writeHelpers(targetDir, options, result) {
         }
     }
 }
+/**
+ * Find source .claude directory for statusline files
+ */
+function findSourceClaudeDir(sourceBaseDir) {
+    const possiblePaths = [];
+    // If explicit source base directory is provided, check it first
+    if (sourceBaseDir) {
+        possiblePaths.push(path.join(sourceBaseDir, '.claude'));
+    }
+    // IMPORTANT: Check the package's own .claude directory
+    const packageRoot = path.resolve(__dirname, '..', '..', '..', '..');
+    const packageClaude = path.join(packageRoot, '.claude');
+    if (fs.existsSync(packageClaude)) {
+        possiblePaths.unshift(packageClaude); // Add to beginning (highest priority)
+    }
+    // From dist/src/init -> go up to project root
+    let currentDir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        const parentDir = path.dirname(currentDir);
+        const claudePath = path.join(parentDir, '.claude');
+        if (fs.existsSync(claudePath)) {
+            possiblePaths.push(claudePath);
+        }
+        currentDir = parentDir;
+    }
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
 /**
  * Write statusline configuration
  */
 async function writeStatusline(targetDir, options, result) {
     const claudeDir = path.join(targetDir, '.claude');
     const helpersDir = path.join(targetDir, '.claude', 'helpers');
+    // Find source .claude directory (works for npm package and local dev)
+    const sourceClaudeDir = findSourceClaudeDir(options.sourceBaseDir);
     // Try to copy existing advanced statusline files from source
-    const sourceBaseDir = options.sourceBaseDir;
     const advancedStatuslineFiles = [
         { src: 'statusline.sh', dest: 'statusline.sh', dir: claudeDir },
         { src: 'statusline.mjs', dest: 'statusline.mjs', dir: claudeDir },
     ];
     let copiedAdvanced = false;
-    if (sourceBaseDir) {
+    if (sourceClaudeDir) {
         for (const file of advancedStatuslineFiles) {
-            const sourcePath = path.join(sourceBaseDir, '.claude', file.src);
+            const sourcePath = path.join(sourceClaudeDir, file.src);
             const destPath = path.join(file.dir, file.dest);
             if (fs.existsSync(sourcePath)) {
                 if (!fs.existsSync(destPath) || options.force) {
                     fs.copyFileSync(sourcePath, destPath);
-                    // Make shell scripts executable
-                    if (file.src.endsWith('.sh')) {
+                    // Make shell scripts and mjs executable
+                    if (file.src.endsWith('.sh') || file.src.endsWith('.mjs')) {
                         fs.chmodSync(destPath, '755');
                     }
                     result.created.files.push(`.claude/${file.dest}`);