@claude-flow/cli 3.0.2 → 3.1.0-alpha.2

package/.claude/helpers/auto-commit.sh

@@ -0,0 +1,178 @@
+#!/bin/bash
+# Auto-commit helper for Claude Code hooks
+# Handles git add, commit, and push in a robust way
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Configuration
+MIN_CHANGES=${MIN_CHANGES:-1}
+COMMIT_PREFIX=${COMMIT_PREFIX:-"checkpoint"}
+AUTO_PUSH=${AUTO_PUSH:-true}
+
+log() {
+    echo -e "${GREEN}[auto-commit]${NC} $1"
+}
+
+warn() {
+    echo -e "${YELLOW}[auto-commit]${NC} $1"
+}
+
+error() {
+    echo -e "${RED}[auto-commit]${NC} $1"
+}
+
+# Check if there are changes to commit
+has_changes() {
+    ! git diff --quiet HEAD 2>/dev/null || ! git diff --cached --quiet 2>/dev/null || [ -n "$(git ls-files --others --exclude-standard)" ]
+}
+
+# Count changes
+count_changes() {
+    local staged=$(git diff --cached --numstat | wc -l)
+    local unstaged=$(git diff --numstat | wc -l)
+    local untracked=$(git ls-files --others --exclude-standard | wc -l)
+    echo $((staged + unstaged + untracked))
+}
+
+# Main auto-commit function
+auto_commit() {
+    local message="$1"
+    local file="$2"  # Optional specific file
+
+    # Check if in a git repo
+    if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+        error "Not in a git repository"
+        return 1
+    fi
+
+    # Check for changes
+    if ! has_changes; then
+        log "No changes to commit"
+        return 0
+    fi
+
+    local change_count=$(count_changes)
+    if [ "$change_count" -lt "$MIN_CHANGES" ]; then
+        log "Only $change_count change(s), skipping (min: $MIN_CHANGES)"
+        return 0
+    fi
+
+    # Stage changes
+    if [ -n "$file" ] && [ -f "$file" ]; then
+        git add "$file"
+        log "Staged: $file"
+    else
+        git add -A
+        log "Staged all changes ($change_count files)"
+    fi
+
+    # Create commit message
+    local branch=$(git branch --show-current)
+    local timestamp=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+    if [ -z "$message" ]; then
+        message="$COMMIT_PREFIX: Auto-commit from Claude Code"
+    fi
+
+    # Commit
+    if git commit -m "$message
+
+Automatic checkpoint created by Claude Code
+- Branch: $branch
+- Timestamp: $timestamp
+- Changes: $change_count file(s)
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>" --quiet 2>/dev/null; then
+        log "Created commit: $message"
+
+        # Push if enabled
+        if [ "$AUTO_PUSH" = "true" ]; then
+            if git push origin "$branch" --quiet 2>/dev/null; then
+                log "Pushed to origin/$branch"
+            else
+                warn "Push failed (will retry later)"
+            fi
+        fi
+
+        return 0
+    else
+        warn "Commit failed (possibly nothing to commit)"
+        return 1
+    fi
+}
+
+# Batch commit (commits all changes together)
+batch_commit() {
+    local message="${1:-Batch checkpoint}"
+    auto_commit "$message"
+}
+
+# Single file commit
+file_commit() {
+    local file="$1"
+    local message="${2:-Checkpoint: $file}"
+
+    if [ -z "$file" ]; then
+        error "No file specified"
+        return 1
+    fi
+
+    if [ ! -f "$file" ]; then
+        error "File not found: $file"
+        return 1
+    fi
+
+    auto_commit "$message" "$file"
+}
+
+# Push only (no commit)
+push_only() {
+    local branch=$(git branch --show-current)
+
+    if git push origin "$branch" 2>/dev/null; then
+        log "Pushed to origin/$branch"
+    else
+        warn "Push failed"
+        return 1
+    fi
+}
+
+# Entry point
+case "${1:-batch}" in
+    batch)
+        batch_commit "$2"
+        ;;
+    file)
+        file_commit "$2" "$3"
+        ;;
+    push)
+        push_only
+        ;;
+    check)
+        if has_changes; then
+            echo "Changes detected: $(count_changes) files"
+            exit 0
+        else
+            echo "No changes"
+            exit 1
+        fi
+        ;;
+    *)
+        echo "Usage: $0 {batch|file|push|check} [args]"
+        echo ""
+        echo "Commands:"
+        echo "  batch [message]     Commit all changes with optional message"
+        echo "  file <path> [msg]   Commit specific file"
+        echo "  push                Push without committing"
+        echo "  check               Check if there are uncommitted changes"
+        exit 1
+        ;;
+esac

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

@@ -0,0 +1,251 @@
+#!/bin/bash
+# Claude Checkpoint Manager
+# Provides easy rollback and management of Claude Code checkpoints
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+CHECKPOINT_DIR=".claude/checkpoints"
+BACKUP_DIR=".claude/backups"
+
+# Help function
+show_help() {
+    cat << EOF
+Claude Checkpoint Manager
+========================
+
+Usage: $0 <command> [options]
+
+Commands:
+  list              List all checkpoints
+  show <id>         Show details of a specific checkpoint
+  rollback <id>     Rollback to a specific checkpoint
+  diff <id>         Show diff since checkpoint
+  clean             Clean old checkpoints (older than 7 days)
+  summary           Show session summary
+  
+Options:
+  --hard            For rollback: use git reset --hard (destructive)
+  --soft            For rollback: use git reset --soft (default)
+  --branch          For rollback: create new branch from checkpoint
+
+Examples:
+  $0 list
+  $0 show checkpoint-20240130-143022
+  $0 rollback checkpoint-20240130-143022 --branch
+  $0 diff session-end-session-20240130-150000
+EOF
+}
+
+# List all checkpoints
+function list_checkpoints() {
+    echo -e "${BLUE}📋 Available Checkpoints:${NC}"
+    echo ""
+    
+    # List checkpoint tags
+    echo -e "${YELLOW}Git Tags:${NC}"
+    local tags=$(git tag -l 'checkpoint-*' -l 'session-end-*' -l 'task-*' --sort=-creatordate | head -20)
+    if [ -n "$tags" ]; then
+        echo "$tags"
+    else
+        echo "No checkpoint tags found"
+    fi
+    
+    echo ""
+    
+    # List checkpoint branches
+    echo -e "${YELLOW}Checkpoint Branches:${NC}"
+    local branches=$(git branch -a | grep "checkpoint/" | sed 's/^[ *]*//')
+    if [ -n "$branches" ]; then
+        echo "$branches"
+    else
+        echo "No checkpoint branches found"
+    fi
+    
+    echo ""
+    
+    # List checkpoint files
+    if [ -d "$CHECKPOINT_DIR" ]; then
+        echo -e "${YELLOW}Recent Checkpoint Files:${NC}"
+        find "$CHECKPOINT_DIR" -name "*.json" -type f -printf "%T@ %p\n" | \
+            sort -rn | head -10 | cut -d' ' -f2- | xargs -I {} basename {}
+    fi
+}
+
+# Show checkpoint details
+function show_checkpoint() {
+    local checkpoint_id="$1"
+    
+    echo -e "${BLUE}📍 Checkpoint Details: $checkpoint_id${NC}"
+    echo ""
+    
+    # Check if it's a tag
+    if git tag -l "$checkpoint_id" | grep -q "$checkpoint_id"; then
+        echo -e "${YELLOW}Type:${NC} Git Tag"
+        echo -e "${YELLOW}Commit:${NC} $(git rev-list -n 1 "$checkpoint_id")"
+        echo -e "${YELLOW}Date:${NC} $(git log -1 --format=%ai "$checkpoint_id")"
+        echo -e "${YELLOW}Message:${NC}"
+        git log -1 --format=%B "$checkpoint_id" | sed 's/^/  /'
+        echo ""
+        echo -e "${YELLOW}Files changed:${NC}"
+        git diff-tree --no-commit-id --name-status -r "$checkpoint_id" | sed 's/^/  /'
+    # Check if it's a branch
+    elif git branch -a | grep -q "$checkpoint_id"; then
+        echo -e "${YELLOW}Type:${NC} Git Branch"
+        echo -e "${YELLOW}Latest commit:${NC}"
+        git log -1 --oneline "$checkpoint_id"
+    else
+        echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}"
+        exit 1
+    fi
+}
+
+# Rollback to checkpoint
+function rollback_checkpoint() {
+    local checkpoint_id="$1"
+    local mode="$2"
+    
+    echo -e "${YELLOW}🔄 Rolling back to checkpoint: $checkpoint_id${NC}"
+    echo ""
+    
+    # Verify checkpoint exists
+    if ! git tag -l "$checkpoint_id" | grep -q "$checkpoint_id" && \
+       ! git branch -a | grep -q "$checkpoint_id"; then
+        echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}"
+        exit 1
+    fi
+    
+    # Create backup before rollback
+    local backup_name="backup-$(date +%Y%m%d-%H%M%S)"
+    echo "Creating backup: $backup_name"
+    git tag "$backup_name" -m "Backup before rollback to $checkpoint_id"
+    
+    case "$mode" in
+        "--hard")
+            echo -e "${RED}⚠️  Performing hard reset (destructive)${NC}"
+            git reset --hard "$checkpoint_id"
+            echo -e "${GREEN}✅ Rolled back to $checkpoint_id (hard reset)${NC}"
+            ;;
+        "--branch")
+            local branch_name="rollback-$checkpoint_id-$(date +%Y%m%d-%H%M%S)"
+            echo "Creating new branch: $branch_name"
+            git checkout -b "$branch_name" "$checkpoint_id"
+            echo -e "${GREEN}✅ Created branch $branch_name from $checkpoint_id${NC}"
+            ;;
+        "--stash"|*)
+            echo "Stashing current changes..."
+            git stash push -m "Stash before rollback to $checkpoint_id"
+            git reset --soft "$checkpoint_id"
+            echo -e "${GREEN}✅ Rolled back to $checkpoint_id (soft reset)${NC}"
+            echo "Your changes are stashed. Use 'git stash pop' to restore them."
+            ;;
+    esac
+}
+
+# Show diff since checkpoint
+function diff_checkpoint() {
+    local checkpoint_id="$1"
+    
+    echo -e "${BLUE}📊 Changes since checkpoint: $checkpoint_id${NC}"
+    echo ""
+    
+    if git tag -l "$checkpoint_id" | grep -q "$checkpoint_id"; then
+        git diff "$checkpoint_id"
+    elif git branch -a | grep -q "$checkpoint_id"; then
+        git diff "$checkpoint_id"
+    else
+        echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}"
+        exit 1
+    fi
+}
+
+# Clean old checkpoints
+function clean_checkpoints() {
+    local days=${1:-7}
+    
+    echo -e "${YELLOW}🧹 Cleaning checkpoints older than $days days...${NC}"
+    echo ""
+    
+    # Clean old checkpoint files
+    if [ -d "$CHECKPOINT_DIR" ]; then
+        find "$CHECKPOINT_DIR" -name "*.json" -type f -mtime +$days -delete
+        echo "✅ Cleaned old checkpoint files"
+    fi
+    
+    # List old tags (but don't delete automatically)
+    echo ""
+    echo "Old checkpoint tags (manual deletion required):"
+    git tag -l 'checkpoint-*' --sort=-creatordate | tail -n +50 || echo "No old tags found"
+}
+
+# Show session summary
+function show_summary() {
+    echo -e "${BLUE}📊 Session Summary${NC}"
+    echo ""
+    
+    # Find most recent session summary
+    if [ -d "$CHECKPOINT_DIR" ]; then
+        local latest_summary=$(find "$CHECKPOINT_DIR" -name "summary-*.md" -type f -printf "%T@ %p\n" | \
+            sort -rn | head -1 | cut -d' ' -f2-)
+        
+        if [ -n "$latest_summary" ]; then
+            echo -e "${YELLOW}Latest session summary:${NC}"
+            cat "$latest_summary"
+        else
+            echo "No session summaries found"
+        fi
+    fi
+}
+
+# Main command handling
+case "$1" in
+    list)
+        list_checkpoints
+        ;;
+    show)
+        if [ -z "$2" ]; then
+            echo -e "${RED}Error: Please specify a checkpoint ID${NC}"
+            show_help
+            exit 1
+        fi
+        show_checkpoint "$2"
+        ;;
+    rollback)
+        if [ -z "$2" ]; then
+            echo -e "${RED}Error: Please specify a checkpoint ID${NC}"
+            show_help
+            exit 1
+        fi
+        rollback_checkpoint "$2" "$3"
+        ;;
+    diff)
+        if [ -z "$2" ]; then
+            echo -e "${RED}Error: Please specify a checkpoint ID${NC}"
+            show_help
+            exit 1
+        fi
+        diff_checkpoint "$2"
+        ;;
+    clean)
+        clean_checkpoints "$2"
+        ;;
+    summary)
+        show_summary
+        ;;
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        echo -e "${RED}Error: Unknown command: $1${NC}"
+        echo ""
+        show_help
+        exit 1
+        ;;
+esac

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

@@ -0,0 +1,252 @@
+#!/bin/bash
+# Claude Flow V3 - Daemon Manager
+# Manages background services for real-time statusline updates
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PID_DIR="$PROJECT_ROOT/.claude-flow/pids"
+LOG_DIR="$PROJECT_ROOT/.claude-flow/logs"
+METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
+
+# Ensure directories exist
+mkdir -p "$PID_DIR" "$LOG_DIR" "$METRICS_DIR"
+
+# PID files
+SWARM_MONITOR_PID="$PID_DIR/swarm-monitor.pid"
+METRICS_DAEMON_PID="$PID_DIR/metrics-daemon.pid"
+
+# Log files
+DAEMON_LOG="$LOG_DIR/daemon.log"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+RESET='\033[0m'
+
+log() {
+    local msg="[$(date '+%Y-%m-%d %H:%M:%S')] $1"
+    echo -e "${CYAN}$msg${RESET}"
+    echo "$msg" >> "$DAEMON_LOG"
+}
+
+success() {
+    local msg="[$(date '+%Y-%m-%d %H:%M:%S')] SUCCESS: $1"
+    echo -e "${GREEN}$msg${RESET}"
+    echo "$msg" >> "$DAEMON_LOG"
+}
+
+error() {
+    local msg="[$(date '+%Y-%m-%d %H:%M:%S')] ERROR: $1"
+    echo -e "${RED}$msg${RESET}"
+    echo "$msg" >> "$DAEMON_LOG"
+}
+
+# Check if a process is running
+is_running() {
+    local pid_file="$1"
+    if [ -f "$pid_file" ]; then
+        local pid=$(cat "$pid_file")
+        if ps -p "$pid" > /dev/null 2>&1; then
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Start the swarm monitor daemon
+start_swarm_monitor() {
+    local interval="${1:-30}"
+
+    if is_running "$SWARM_MONITOR_PID"; then
+        log "Swarm monitor already running (PID: $(cat "$SWARM_MONITOR_PID"))"
+        return 0
+    fi
+
+    log "Starting swarm monitor daemon (interval: ${interval}s)..."
+
+    # Run the monitor in background
+    nohup "$SCRIPT_DIR/swarm-monitor.sh" monitor "$interval" >> "$LOG_DIR/swarm-monitor.log" 2>&1 &
+    local pid=$!
+
+    echo "$pid" > "$SWARM_MONITOR_PID"
+    success "Swarm monitor started (PID: $pid)"
+
+    return 0
+}
+
+# Start the metrics update daemon
+start_metrics_daemon() {
+    local interval="${1:-60}"  # Default 60 seconds - less frequent updates
+
+    if is_running "$METRICS_DAEMON_PID"; then
+        log "Metrics daemon already running (PID: $(cat "$METRICS_DAEMON_PID"))"
+        return 0
+    fi
+
+    log "Starting metrics daemon (interval: ${interval}s, using SQLite)..."
+
+    # Use SQLite-based metrics (10.5x faster than bash/JSON)
+    # Run as Node.js daemon process
+    nohup node "$SCRIPT_DIR/metrics-db.mjs" daemon "$interval" >> "$LOG_DIR/metrics-daemon.log" 2>&1 &
+    local pid=$!
+
+    echo "$pid" > "$METRICS_DAEMON_PID"
+    success "Metrics daemon started (PID: $pid) - SQLite backend"
+
+    return 0
+}
+
+# Stop a daemon by PID file
+stop_daemon() {
+    local pid_file="$1"
+    local name="$2"
+
+    if [ -f "$pid_file" ]; then
+        local pid=$(cat "$pid_file")
+        if ps -p "$pid" > /dev/null 2>&1; then
+            log "Stopping $name (PID: $pid)..."
+            kill "$pid" 2>/dev/null
+            sleep 1
+
+            # Force kill if still running
+            if ps -p "$pid" > /dev/null 2>&1; then
+                kill -9 "$pid" 2>/dev/null
+            fi
+
+            success "$name stopped"
+        fi
+        rm -f "$pid_file"
+    else
+        log "$name not running"
+    fi
+}
+
+# Start all daemons
+start_all() {
+    log "Starting all Claude Flow daemons..."
+    start_swarm_monitor "${1:-30}"
+    start_metrics_daemon "${2:-60}"
+
+    # Initial metrics update
+    "$SCRIPT_DIR/swarm-monitor.sh" check > /dev/null 2>&1
+
+    success "All daemons started"
+    show_status
+}
+
+# Stop all daemons
+stop_all() {
+    log "Stopping all Claude Flow daemons..."
+    stop_daemon "$SWARM_MONITOR_PID" "Swarm monitor"
+    stop_daemon "$METRICS_DAEMON_PID" "Metrics daemon"
+    success "All daemons stopped"
+}
+
+# Restart all daemons
+restart_all() {
+    stop_all
+    sleep 1
+    start_all "$@"
+}
+
+# Show daemon status
+show_status() {
+    echo ""
+    echo -e "${CYAN}═══════════════════════════════════════════════════${RESET}"
+    echo -e "${CYAN}       Claude Flow V3 Daemon Status${RESET}"
+    echo -e "${CYAN}═══════════════════════════════════════════════════${RESET}"
+    echo ""
+
+    # Swarm Monitor
+    if is_running "$SWARM_MONITOR_PID"; then
+        echo -e "  ${GREEN}●${RESET} Swarm Monitor    ${GREEN}RUNNING${RESET} (PID: $(cat "$SWARM_MONITOR_PID"))"
+    else
+        echo -e "  ${RED}○${RESET} Swarm Monitor    ${RED}STOPPED${RESET}"
+    fi
+
+    # Metrics Daemon
+    if is_running "$METRICS_DAEMON_PID"; then
+        echo -e "  ${GREEN}●${RESET} Metrics Daemon   ${GREEN}RUNNING${RESET} (PID: $(cat "$METRICS_DAEMON_PID"))"
+    else
+        echo -e "  ${RED}○${RESET} Metrics Daemon   ${RED}STOPPED${RESET}"
+    fi
+
+    # MCP Server
+    local mcp_count=$(ps aux 2>/dev/null | grep -E "mcp.*start" | grep -v grep | wc -l)
+    if [ "$mcp_count" -gt 0 ]; then
+        echo -e "  ${GREEN}●${RESET} MCP Server       ${GREEN}RUNNING${RESET}"
+    else
+        echo -e "  ${YELLOW}○${RESET} MCP Server       ${YELLOW}NOT DETECTED${RESET}"
+    fi
+
+    # Agentic Flow
+    local af_count=$(ps aux 2>/dev/null | grep -E "agentic-flow" | grep -v grep | grep -v "daemon-manager" | wc -l)
+    if [ "$af_count" -gt 0 ]; then
+        echo -e "  ${GREEN}●${RESET} Agentic Flow     ${GREEN}ACTIVE${RESET} ($af_count processes)"
+    else
+        echo -e "  ${YELLOW}○${RESET} Agentic Flow     ${YELLOW}IDLE${RESET}"
+    fi
+
+    echo ""
+    echo -e "${CYAN}───────────────────────────────────────────────────${RESET}"
+
+    # Show latest metrics
+    if [ -f "$METRICS_DIR/swarm-activity.json" ]; then
+        local last_update=$(jq -r '.timestamp // "unknown"' "$METRICS_DIR/swarm-activity.json" 2>/dev/null)
+        local agent_count=$(jq -r '.swarm.agent_count // 0' "$METRICS_DIR/swarm-activity.json" 2>/dev/null)
+        echo -e "  Last Update: ${last_update}"
+        echo -e "  Active Agents: ${agent_count}"
+    fi
+
+    echo -e "${CYAN}═══════════════════════════════════════════════════${RESET}"
+    echo ""
+}
+
+# Main command handling
+case "${1:-status}" in
+    "start")
+        start_all "${2:-30}" "${3:-60}"
+        ;;
+    "stop")
+        stop_all
+        ;;
+    "restart")
+        restart_all "${2:-30}" "${3:-60}"
+        ;;
+    "status")
+        show_status
+        ;;
+    "start-swarm")
+        start_swarm_monitor "${2:-30}"
+        ;;
+    "start-metrics")
+        start_metrics_daemon "${2:-60}"
+        ;;
+    "help"|"-h"|"--help")
+        echo "Claude Flow V3 Daemon Manager"
+        echo ""
+        echo "Usage: $0 [command] [options]"
+        echo ""
+        echo "Commands:"
+        echo "  start [swarm_interval] [metrics_interval]  Start all daemons"
+        echo "  stop                                       Stop all daemons"
+        echo "  restart [swarm_interval] [metrics_interval] Restart all daemons"
+        echo "  status                                     Show daemon status"
+        echo "  start-swarm [interval]                     Start swarm monitor only"
+        echo "  start-metrics [interval]                   Start metrics daemon only"
+        echo "  help                                       Show this help"
+        echo ""
+        echo "Examples:"
+        echo "  $0 start           # Start with defaults (30s swarm, 60s metrics)"
+        echo "  $0 start 10 30     # Start with 10s swarm, 30s metrics intervals"
+        echo "  $0 status          # Show current status"
+        echo "  $0 stop            # Stop all daemons"
+        ;;
+    *)
+        error "Unknown command: $1"
+        echo "Use '$0 help' for usage information"
+        exit 1
+        ;;
+esac