@swarmdo/cli 1.4.8

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 "Swarmdo 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 "🔍 Swarmdo 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"
+  ".swarmdo/metrics"
+  ".swarmdo/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"
+  ".swarmdo/metrics/v3-progress.json"
+  ".swarmdo/metrics/performance.json"
+  ".swarmdo/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
+        ;;
+      ".swarmdo/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
+# Swarmdo 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/.swarmdo/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 "║           Swarmdo 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
+Swarmdo 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/.claude/settings.json

@@ -0,0 +1,182 @@
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "SWARMDO_V3_ENABLED": "true",
+    "SWARMDO_HOOKS_ENABLED": "true"
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" pre-bash",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" post-edit",
+            "timeout": 10000
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" route",
+            "timeout": 10000
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" session-restore",
+            "timeout": 15000,
+            "continueOnError": true
+          },
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/auto-memory-hook.mjs" import",
+            "timeout": 8000,
+            "continueOnError": true
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" session-end",
+            "timeout": 10000,
+            "continueOnError": true
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" status",
+            "timeout": 3000,
+            "continueOnError": true
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/auto-memory-hook.mjs" sync",
+            "timeout": 10000,
+            "continueOnError": true
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "node "$CLAUDE_PROJECT_DIR/.claude/helpers/statusline.cjs"",
+    "refreshMs": 5000,
+    "enabled": true
+  },
+  "permissions": {
+    "allow": [
+      "Bash(npx @swarmdo*)",
+      "Bash(npx swarmdo*)",
+      "Bash(node .claude/*)",
+      "mcp__swarmdo__:*"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)"
+    ]
+  },
+  "attribution": {
+    "commit": "Co-Authored-By: swarmdo-bot <swarmdo-bot@users.noreply.github.com>",
+    "pr": "Generated with [swarmdo](the upstream project (see NOTICE))"
+  },
+  "claudeFlow": {
+    "version": "3.1.0",
+    "enabled": true,
+    "modelPreferences": {
+      "default": "claude-opus-4-6",
+      "routing": "claude-haiku-4-5-20251001"
+    },
+    "agentTeams": {
+      "enabled": true,
+      "teammateMode": "auto",
+      "taskListEnabled": true,
+      "mailboxEnabled": true,
+      "coordination": {
+        "autoAssignOnIdle": true,
+        "trainPatternsOnComplete": true,
+        "notifyLeadOnComplete": true,
+        "sharedMemoryNamespace": "agent-teams"
+      }
+    },
+    "swarm": {
+      "topology": "hierarchical-mesh",
+      "maxAgents": 15
+    },
+    "memory": {
+      "backend": "hybrid",
+      "enableHNSW": true,
+      "learningBridge": {
+        "enabled": true,
+        "sonaMode": "balanced",
+        "confidenceDecayRate": 0.005,
+        "accessBoostAmount": 0.03,
+        "consolidationThreshold": 10
+      },
+      "memoryGraph": {
+        "enabled": true,
+        "pageRankDamping": 0.85,
+        "communityAlgorithm": "label-propagation"
+      },
+      "agentScopes": {
+        "enabled": true,
+        "scopes": ["project", "local", "user"]
+      }
+    },
+    "neural": {
+      "enabled": true
+    },
+    "security": {
+      "autoScan": true,
+      "scanOnEdit": true,
+      "cveCheck": true
+    },
+    "daemon": {
+      "autoStart": true,
+      "workers": ["map", "audit", "optimize", "consolidate", "testgaps", "ultralearn"]
+    },
+    "learning": {
+      "enabled": true,
+      "autoTrain": true,
+      "patterns": ["coordination", "optimization", "prediction"]
+    }
+  }
+}