prizmkit 1.0.0 → 1.0.1

package/bundled/dev-pipeline/run-bugfix.sh

@@ -0,0 +1,638 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ============================================================
+# dev-pipeline/run-bugfix.sh - Autonomous Bug Fix Pipeline Runner
+#
+# Drives the prizm-dev-team through iterative AI CLI sessions to
+# fix bugs from a bug-fix-list.json specification.
+#
+# Usage:
+#   ./run-bugfix.sh run [bug-fix-list.json]          Run all bugs
+#   ./run-bugfix.sh run <bug-id> [options]            Run a single bug
+#   ./run-bugfix.sh status [bug-fix-list.json]        Show pipeline status
+#   ./run-bugfix.sh reset                             Clear all state
+#
+# Environment Variables:
+#   MAX_RETRIES           Max retries per bug (default: 3)
+#   SESSION_TIMEOUT       Session timeout in seconds (default: 0 = no limit)
+#   AI_CLI                AI CLI command name (auto-detected: cbc or claude)
+#   VERBOSE               Set to 1 to enable --verbose on AI CLI
+#   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
+#   HEARTBEAT_STALE_THRESHOLD  Heartbeat stale threshold in seconds (default: 600)
+# ============================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+STATE_DIR="$SCRIPT_DIR/bugfix-state"
+SCRIPTS_DIR="$SCRIPT_DIR/scripts"
+
+# Configuration
+MAX_RETRIES=${MAX_RETRIES:-3}
+SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}
+HEARTBEAT_STALE_THRESHOLD=${HEARTBEAT_STALE_THRESHOLD:-600}
+HEARTBEAT_INTERVAL=${HEARTBEAT_INTERVAL:-30}
+VERBOSE=${VERBOSE:-0}
+
+# AI CLI detection
+if [[ -n "${AI_CLI:-}" ]]; then
+    CLI_CMD="$AI_CLI"
+elif [[ -n "${CODEBUDDY_CLI:-}" ]]; then
+    CLI_CMD="$CODEBUDDY_CLI"
+elif command -v cbc &>/dev/null; then
+    CLI_CMD="cbc"
+elif command -v claude &>/dev/null; then
+    CLI_CMD="claude"
+else
+    echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude)." >&2
+    exit 1
+fi
+
+# Platform detection
+if [[ -n "${PRIZMKIT_PLATFORM:-}" ]]; then
+    PLATFORM="$PRIZMKIT_PLATFORM"
+elif [[ "$CLI_CMD" == *"claude"* ]]; then
+    PLATFORM="claude"
+else
+    PLATFORM="codebuddy"
+fi
+export PRIZMKIT_PLATFORM="$PLATFORM"
+
+# Bug list path (set in main, used by cleanup trap)
+BUG_LIST=""
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+log_info()    { echo -e "${BLUE}[INFO]${NC}    $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+log_warn()    { echo -e "${YELLOW}[WARN]${NC}    $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+log_error()   { echo -e "${RED}[ERROR]${NC}   $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+
+# ============================================================
+# Shared: Spawn AI CLI session and wait for result
+# ============================================================
+
+spawn_and_wait_session() {
+    local bug_id="$1"
+    local bug_list="$2"
+    local session_id="$3"
+    local bootstrap_prompt="$4"
+    local session_dir="$5"
+    local max_retries="$6"
+
+    local session_log="$session_dir/logs/session.log"
+
+    local verbose_flag=""
+    if [[ "$VERBOSE" == "1" ]]; then
+        verbose_flag="--verbose"
+    fi
+
+    case "$CLI_CMD" in
+        *claude*)
+            "$CLI_CMD" \
+                --print \
+                -p "$(cat "$bootstrap_prompt")" \
+                --yes \
+                $verbose_flag \
+                > "$session_log" 2>&1 &
+            ;;
+        *)
+            "$CLI_CMD" \
+                --print \
+                -y \
+                $verbose_flag \
+                < "$bootstrap_prompt" \
+                > "$session_log" 2>&1 &
+            ;;
+    esac
+    local cli_pid=$!
+
+    # Timeout watchdog
+    local watcher_pid=""
+    if [[ $SESSION_TIMEOUT -gt 0 ]]; then
+        ( sleep "$SESSION_TIMEOUT" && kill -TERM "$cli_pid" 2>/dev/null ) &
+        watcher_pid=$!
+    fi
+
+    # Heartbeat monitor
+    local heartbeat_interval=$HEARTBEAT_INTERVAL
+    (
+        local elapsed=0
+        local prev_size=0
+        while kill -0 "$cli_pid" 2>/dev/null; do
+            sleep "$heartbeat_interval"
+            elapsed=$((elapsed + heartbeat_interval))
+            kill -0 "$cli_pid" 2>/dev/null || break
+
+            local cur_size=0
+            if [[ -f "$session_log" ]]; then
+                cur_size=$(wc -c < "$session_log" 2>/dev/null || echo 0)
+                cur_size=$(echo "$cur_size" | tr -d ' ')
+            fi
+
+            local growth=$((cur_size - prev_size))
+            prev_size=$cur_size
+
+            local size_display
+            if [[ $cur_size -gt 1048576 ]]; then
+                size_display="$((cur_size / 1048576))MB"
+            elif [[ $cur_size -gt 1024 ]]; then
+                size_display="$((cur_size / 1024))KB"
+            else
+                size_display="${cur_size}B"
+            fi
+
+            local mins=$((elapsed / 60))
+            local secs=$((elapsed % 60))
+
+            local last_activity=""
+            if [[ -f "$session_log" ]]; then
+                last_activity=$(tail -20 "$session_log" 2>/dev/null | grep -v '^$' | tail -1 | cut -c1-80 || echo "")
+            fi
+
+            local status_icon
+            if [[ $growth -gt 0 ]]; then
+                status_icon="${GREEN}▶${NC}"
+            else
+                status_icon="${YELLOW}⏸${NC}"
+            fi
+
+            echo -e "  ${status_icon} ${BLUE}[HEARTBEAT]${NC} ${mins}m${secs}s elapsed | log: ${size_display} (+${growth}B) | ${last_activity}"
+        done
+    ) &
+    local heartbeat_pid=$!
+
+    # Wait for AI CLI to finish
+    local exit_code=0
+    if wait "$cli_pid" 2>/dev/null; then
+        exit_code=0
+    else
+        exit_code=$?
+    fi
+
+    # Cleanup
+    [[ -n "$watcher_pid" ]] && kill "$watcher_pid" 2>/dev/null || true
+    kill "$heartbeat_pid" 2>/dev/null || true
+    [[ -n "$watcher_pid" ]] && wait "$watcher_pid" 2>/dev/null || true
+    wait "$heartbeat_pid" 2>/dev/null || true
+
+    [[ $exit_code -eq 143 ]] && exit_code=124
+
+    # Session summary
+    if [[ -f "$session_log" ]]; then
+        local final_size=$(wc -c < "$session_log" 2>/dev/null | tr -d ' ')
+        local final_lines=$(wc -l < "$session_log" 2>/dev/null | tr -d ' ')
+        log_info "Session log: $final_lines lines, $((final_size / 1024))KB"
+    fi
+
+    # Check session outcome
+    local session_status_file="$session_dir/session-status.json"
+    local session_status
+
+    if [[ $exit_code -eq 124 ]]; then
+        log_warn "Session timed out after ${SESSION_TIMEOUT}s"
+        session_status="timed_out"
+    elif [[ -f "$session_status_file" ]]; then
+        session_status=$(python3 "$SCRIPTS_DIR/check-session-status.py" \
+            --status-file "$session_status_file" 2>/dev/null) || session_status="crashed"
+    else
+        log_warn "Session ended without status file — treating as crashed"
+        session_status="crashed"
+    fi
+
+    log_info "Session result: $session_status"
+
+    # Update bug status
+    python3 "$SCRIPTS_DIR/update-bug-status.py" \
+        --bug-list "$bug_list" \
+        --state-dir "$STATE_DIR" \
+        --bug-id "$bug_id" \
+        --session-status "$session_status" \
+        --session-id "$session_id" \
+        --max-retries "$max_retries" \
+        --action update >/dev/null 2>&1 || true
+
+    _SPAWN_RESULT="$session_status"
+}
+
+# ============================================================
+# Graceful Shutdown
+# ============================================================
+
+cleanup() {
+    echo ""
+    log_warn "Received interrupt signal. Saving state..."
+
+    if [[ -n "$BUG_LIST" && -f "$BUG_LIST" ]]; then
+        python3 "$SCRIPTS_DIR/update-bug-status.py" \
+            --bug-list "$BUG_LIST" \
+            --state-dir "$STATE_DIR" \
+            --action pause 2>/dev/null || true
+    fi
+
+    log_info "Bug fix pipeline paused. Run './run-bugfix.sh run' to resume."
+    exit 130
+}
+trap cleanup SIGINT SIGTERM
+
+# ============================================================
+# Dependency Check
+# ============================================================
+
+check_dependencies() {
+    if ! command -v jq &>/dev/null; then
+        log_error "jq is required but not installed. Install with: brew install jq"
+        exit 1
+    fi
+    if ! command -v python3 &>/dev/null; then
+        log_error "python3 is required but not installed."
+        exit 1
+    fi
+}
+
+# ============================================================
+# run-one: Run a single bug fix
+# ============================================================
+
+run_one() {
+    local bug_id=""
+    local bug_list=""
+    local dry_run=false
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --dry-run) dry_run=true; shift ;;
+            --timeout) shift; SESSION_TIMEOUT="${1:-0}"; shift ;;
+            B-*|b-*) bug_id="$1"; shift ;;
+            *) bug_list="$1"; shift ;;
+        esac
+    done
+
+    if [[ -z "$bug_id" ]]; then
+        log_error "Bug ID is required (e.g. B-001)"
+        echo ""
+        show_help
+        exit 1
+    fi
+
+    if [[ -z "$bug_list" ]]; then
+        bug_list="bug-fix-list.json"
+    fi
+    if [[ ! "$bug_list" = /* ]]; then
+        bug_list="$(pwd)/$bug_list"
+    fi
+    BUG_LIST="$bug_list"
+
+    if [[ ! -f "$bug_list" ]]; then
+        log_error "Bug fix list not found: $bug_list"
+        exit 1
+    fi
+
+    check_dependencies
+
+    # Initialize state if needed
+    if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
+        log_info "Initializing bugfix pipeline state..."
+        python3 "$SCRIPTS_DIR/init-bugfix-pipeline.py" \
+            --bug-list "$bug_list" \
+            --state-dir "$STATE_DIR" >/dev/null 2>&1 || {
+            log_error "Failed to initialize bugfix pipeline state"
+            exit 1
+        }
+    fi
+
+    # Verify bug exists
+    local bug_title
+    bug_title=$(python3 -c "
+import json, sys
+with open('$bug_list') as f:
+    data = json.load(f)
+for bug in data.get('bugs', []):
+    if bug.get('id') == '$bug_id':
+        print(bug.get('title', ''))
+        sys.exit(0)
+sys.exit(1)
+" 2>/dev/null) || {
+        log_error "Bug $bug_id not found in $bug_list"
+        exit 1
+    }
+
+    local bug_severity
+    bug_severity=$(python3 -c "
+import json, sys
+with open('$bug_list') as f:
+    data = json.load(f)
+for bug in data.get('bugs', []):
+    if bug.get('id') == '$bug_id':
+        print(bug.get('severity', 'medium'))
+        sys.exit(0)
+sys.exit(1)
+" 2>/dev/null) || bug_severity="medium"
+
+    # Reset bug status
+    python3 "$SCRIPTS_DIR/update-bug-status.py" \
+        --bug-list "$bug_list" \
+        --state-dir "$STATE_DIR" \
+        --bug-id "$bug_id" \
+        --action reset >/dev/null 2>&1 || true
+
+    # Generate bootstrap prompt
+    local run_id session_id session_dir bootstrap_prompt
+    run_id=$(jq -r '.run_id' "$STATE_DIR/pipeline.json")
+    session_id="${bug_id}-$(date +%Y%m%d%H%M%S)"
+    session_dir="$STATE_DIR/bugs/$bug_id/sessions/$session_id"
+    mkdir -p "$session_dir/logs"
+
+    bootstrap_prompt="$session_dir/bootstrap-prompt.md"
+
+    log_info "Generating bugfix bootstrap prompt..."
+    python3 "$SCRIPTS_DIR/generate-bugfix-prompt.py" \
+        --bug-list "$bug_list" \
+        --bug-id "$bug_id" \
+        --session-id "$session_id" \
+        --run-id "$run_id" \
+        --retry-count 0 \
+        --resume-phase "null" \
+        --state-dir "$STATE_DIR" \
+        --output "$bootstrap_prompt" >/dev/null 2>&1
+
+    if [[ "$dry_run" == true ]]; then
+        echo ""
+        echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+        echo -e "${BOLD}  Dry Run: $bug_id — $bug_title${NC}"
+        echo -e "${BOLD}  Severity: $bug_severity${NC}"
+        echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+        echo ""
+        log_info "Bootstrap prompt written to:"
+        echo "  $bootstrap_prompt"
+        echo ""
+        log_success "Dry run complete. Inspect full prompt with:"
+        echo "  cat $bootstrap_prompt"
+        return 0
+    fi
+
+    echo ""
+    echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}  Bug Fix: $bug_id — $bug_title${NC}"
+    echo -e "${BOLD}  Severity: $bug_severity${NC}"
+    echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+    log_info "Session ID: $session_id"
+    log_info "Prompt: $bootstrap_prompt"
+    log_info "Log: $session_dir/logs/session.log"
+    echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+    echo ""
+
+    cleanup() {
+        echo ""
+        log_warn "Interrupted. Killing session..."
+        kill 0 2>/dev/null || true
+        log_info "Session log: $session_dir/logs/session.log"
+        exit 130
+    }
+    trap cleanup SIGINT SIGTERM
+
+    _SPAWN_RESULT=""
+    spawn_and_wait_session \
+        "$bug_id" "$bug_list" "$session_id" \
+        "$bootstrap_prompt" "$session_dir" 999
+    local session_status="$_SPAWN_RESULT"
+
+    echo ""
+    if [[ "$session_status" == "success" ]]; then
+        log_success "════════════════════════════════════════════════════"
+        log_success "  $bug_id fixed successfully!"
+        log_success "════════════════════════════════════════════════════"
+    else
+        log_error "════════════════════════════════════════════════════"
+        log_error "  $bug_id result: $session_status"
+        log_error "  Review log: $session_dir/logs/session.log"
+        log_error "════════════════════════════════════════════════════"
+    fi
+}
+
+# ============================================================
+# Main Loop: Run all bugs
+# ============================================================
+
+main() {
+    local bug_list="${1:-bug-fix-list.json}"
+
+    if [[ ! "$bug_list" = /* ]]; then
+        bug_list="$(pwd)/$bug_list"
+    fi
+    BUG_LIST="$bug_list"
+
+    if [[ ! -f "$bug_list" ]]; then
+        log_error "Bug fix list not found: $bug_list"
+        log_info "Create a bug fix list first using the bug-planner skill,"
+        log_info "or provide a path: ./run-bugfix.sh run <path-to-bug-fix-list.json>"
+        exit 1
+    fi
+
+    check_dependencies
+
+    # Initialize pipeline state if needed
+    if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
+        log_info "Initializing bugfix pipeline state..."
+        local init_result
+        init_result=$(python3 "$SCRIPTS_DIR/init-bugfix-pipeline.py" \
+            --bug-list "$bug_list" \
+            --state-dir "$STATE_DIR" 2>&1)
+
+        local init_valid
+        init_valid=$(echo "$init_result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('valid', False))" 2>/dev/null || echo "False")
+
+        if [[ "$init_valid" != "True" ]]; then
+            log_error "Bugfix pipeline initialization failed:"
+            echo "$init_result"
+            exit 1
+        fi
+
+        local bugs_count
+        bugs_count=$(echo "$init_result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('bugs_count', 0))" 2>/dev/null || echo "0")
+        log_success "Bugfix pipeline initialized with $bugs_count bugs"
+    else
+        log_info "Resuming existing bugfix pipeline..."
+    fi
+
+    # Print header
+    echo ""
+    echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}        Bug-Fix Pipeline Runner Started${NC}"
+    echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+    log_info "Bug fix list: $bug_list"
+    log_info "Max retries per bug: $MAX_RETRIES"
+    if [[ $SESSION_TIMEOUT -gt 0 ]]; then
+        log_info "Session timeout: ${SESSION_TIMEOUT}s"
+    else
+        log_info "Session timeout: none"
+    fi
+    log_info "AI CLI: $CLI_CMD (platform: $PLATFORM)"
+    echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
+    echo ""
+
+    local session_count=0
+
+    while true; do
+        # Find next bug to process
+        local next_bug
+        next_bug=$(python3 "$SCRIPTS_DIR/update-bug-status.py" \
+            --bug-list "$bug_list" \
+            --state-dir "$STATE_DIR" \
+            --max-retries "$MAX_RETRIES" \
+            --action get_next 2>/dev/null) || true
+
+        if [[ "$next_bug" == "PIPELINE_COMPLETE" ]]; then
+            echo ""
+            log_success "════════════════════════════════════════════════════"
+            log_success "  All bugs processed! Bug fix pipeline finished."
+            log_success "  Total sessions: $session_count"
+            log_success "════════════════════════════════════════════════════"
+            break
+        fi
+
+        if [[ "$next_bug" == "PIPELINE_BLOCKED" ]]; then
+            log_warn "All remaining bugs are blocked (needs_info/failed)."
+            log_warn "Run './run-bugfix.sh status' to see details."
+            log_warn "Waiting 60s before re-checking... (Ctrl+C to stop)"
+            sleep 60
+            continue
+        fi
+
+        # Parse bug info
+        local bug_id bug_title bug_severity retry_count resume_phase
+        bug_id=$(echo "$next_bug" | jq -r '.bug_id')
+        bug_title=$(echo "$next_bug" | jq -r '.title')
+        bug_severity=$(echo "$next_bug" | jq -r '.severity')
+        retry_count=$(echo "$next_bug" | jq -r '.retry_count // 0')
+        resume_phase=$(echo "$next_bug" | jq -r '.resume_from_phase // "null"')
+
+        echo ""
+        echo -e "${BOLD}────────────────────────────────────────────────────${NC}"
+        log_info "Bug: ${BOLD}$bug_id${NC} — $bug_title"
+        log_info "Severity: $bug_severity | Retry: $retry_count / $MAX_RETRIES"
+        if [[ "$resume_phase" != "null" ]]; then
+            log_info "Resuming from Phase $resume_phase"
+        fi
+        echo -e "${BOLD}────────────────────────────────────────────────────${NC}"
+
+        # Generate session
+        local session_id run_id
+        run_id=$(jq -r '.run_id' "$STATE_DIR/pipeline.json")
+        session_id="${bug_id}-$(date +%Y%m%d%H%M%S)"
+
+        local session_dir="$STATE_DIR/bugs/$bug_id/sessions/$session_id"
+        mkdir -p "$session_dir/logs"
+
+        local bootstrap_prompt="$session_dir/bootstrap-prompt.md"
+        python3 "$SCRIPTS_DIR/generate-bugfix-prompt.py" \
+            --bug-list "$bug_list" \
+            --bug-id "$bug_id" \
+            --session-id "$session_id" \
+            --run-id "$run_id" \
+            --retry-count "$retry_count" \
+            --resume-phase "$resume_phase" \
+            --state-dir "$STATE_DIR" \
+            --output "$bootstrap_prompt" >/dev/null 2>&1
+
+        # Track current session
+        python3 -c "
+import json
+from datetime import datetime
+data = {
+    'bug_id': '$bug_id',
+    'session_id': '$session_id',
+    'started_at': datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')
+}
+with open('$STATE_DIR/current-session.json', 'w') as f:
+    json.dump(data, f, indent=2)
+"
+
+        # Spawn session
+        log_info "Spawning AI CLI session: $session_id"
+        _SPAWN_RESULT=""
+        spawn_and_wait_session \
+            "$bug_id" "$bug_list" "$session_id" \
+            "$bootstrap_prompt" "$session_dir" "$MAX_RETRIES"
+
+        session_count=$((session_count + 1))
+
+        log_info "Pausing 5s before next bug..."
+        sleep 5
+    done
+}
+
+# ============================================================
+# Entry Point
+# ============================================================
+
+show_help() {
+    echo "Usage: $0 <command> [options]"
+    echo ""
+    echo "Commands:"
+    echo "  run [bug-fix-list.json]                 Run all bugs by severity/priority order"
+    echo "  run <bug-id> [options]                   Run a single bug fix"
+    echo "  status [bug-fix-list.json]               Show bug fix pipeline status"
+    echo "  reset                                    Clear all bugfix state"
+    echo "  help                                     Show this help message"
+    echo ""
+    echo "Single Bug Options (run <bug-id>):"
+    echo "  --dry-run                   Generate bootstrap prompt only, don't spawn session"
+    echo "  --timeout N                 Session timeout in seconds (default: 0 = no limit)"
+    echo ""
+    echo "Environment Variables:"
+    echo "  MAX_RETRIES           Max retries per bug (default: 3)"
+    echo "  SESSION_TIMEOUT       Session timeout in seconds (default: 0 = no limit)"
+    echo "  AI_CLI                AI CLI command name (auto-detected: cbc or claude)"
+    echo "  VERBOSE               Set to 1 for verbose AI CLI output"
+    echo "  HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)"
+    echo ""
+    echo "Examples:"
+    echo "  ./run-bugfix.sh run                                    # Run all bugs"
+    echo "  ./run-bugfix.sh run bug-fix-list.json                  # Custom bug list"
+    echo "  ./run-bugfix.sh run B-001 --dry-run                    # Inspect generated prompt"
+    echo "  ./run-bugfix.sh run B-001 --timeout 3600               # 1h timeout"
+    echo "  ./run-bugfix.sh status                                 # Show status"
+    echo "  MAX_RETRIES=5 ./run-bugfix.sh run                      # Custom retries"
+}
+
+case "${1:-run}" in
+    run|resume)
+        shift || true
+        if [[ "${1:-}" =~ ^[Bb]-[0-9]+ ]]; then
+            run_one "$@"
+        else
+            main "${1:-bug-fix-list.json}"
+        fi
+        ;;
+    status)
+        check_dependencies
+        if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
+            log_error "No bugfix pipeline state found. Run './run-bugfix.sh run' first."
+            exit 1
+        fi
+        python3 "$SCRIPTS_DIR/update-bug-status.py" \
+            --bug-list "${2:-bug-fix-list.json}" \
+            --state-dir "$STATE_DIR" \
+            --action status
+        ;;
+    reset)
+        log_warn "Resetting bugfix pipeline state..."
+        rm -rf "$STATE_DIR"
+        log_success "Bugfix state cleared. Run './run-bugfix.sh run' to start fresh."
+        ;;
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        log_error "Unknown command: $1"
+        show_help
+        exit 1
+        ;;
+esac