prizmkit 1.1.91 → 1.1.93

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

@@ -8,14 +8,14 @@ set -euo pipefail
 # fix bugs from a .prizmkit/plans/bug-fix-list.json specification.
 #
 # Usage:
-#   ./run-bugfix.sh run [.prizmkit/plans/bug-fix-list.json]          Run all bugs
+#   ./run-bugfix.sh run [.prizmkit/plans/bug-fix-list.json] [options] Run all bugs
 #   ./run-bugfix.sh run <bug-id> [options]            Run a single bug
 #   ./run-bugfix.sh status [.prizmkit/plans/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)
+#   MAX_RETRIES           Max code retries per bug (default: 3)
+#   MAX_INFRA_RETRIES     Max infrastructure/provider retries per bug (default: 3)
 #   AI_CLI                AI CLI command name (auto-detected: cbc, claude, or codex)
 #   CODEBUDDY_CLI         Legacy alias for AI_CLI (deprecated, use AI_CLI instead)
 #   PRIZMKIT_PLATFORM     Platform hint for custom AI_CLI wrappers: codebuddy, claude, or codex
@@ -23,9 +23,6 @@ set -euo pipefail
 #   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
 #   STALE_KILL_THRESHOLD   Auto-kill session after N seconds of no progress (default: 900)
 #   HEARTBEAT_STALE_THRESHOLD  Heartbeat stale threshold in seconds (default: 600)
-#   LOG_CLEANUP_ENABLED   Run periodic log cleanup (default: 1)
-#   LOG_RETENTION_DAYS    Delete logs older than N days (default: 14)
-#   LOG_MAX_TOTAL_MB      Keep total logs under N MB via oldest-first cleanup (default: 1024)
 #   DEV_BRANCH            Custom dev branch name (default: auto-generated bugfix/pipeline-{run_id})
 #   AUTO_PUSH             Auto-push to remote after successful bug fix (default: 0). Set to 1 to enable.
 #   STOP_ON_FAILURE       Stop pipeline after a task exhausts all retries (default: 0). Set to 1 to stop.
@@ -42,13 +39,10 @@ SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 
 # Configuration
 MAX_RETRIES=${MAX_RETRIES:-3}
-SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}
+MAX_INFRA_RETRIES=${MAX_INFRA_RETRIES:-3}
 HEARTBEAT_STALE_THRESHOLD=${HEARTBEAT_STALE_THRESHOLD:-600}
 HEARTBEAT_INTERVAL=${HEARTBEAT_INTERVAL:-30}
 STALE_KILL_THRESHOLD=${STALE_KILL_THRESHOLD:-900}
-LOG_CLEANUP_ENABLED=${LOG_CLEANUP_ENABLED:-1}
-LOG_RETENTION_DAYS=${LOG_RETENTION_DAYS:-14}
-LOG_MAX_TOTAL_MB=${LOG_MAX_TOTAL_MB:-1024}
 VERBOSE=${VERBOSE:-0}
 MODEL=${MODEL:-""}
 PRIZMKIT_EFFORT=${PRIZMKIT_EFFORT:-""}
@@ -90,8 +84,9 @@ spawn_and_wait_session() {
     local bootstrap_prompt="$4"
     local session_dir="$5"
     local max_retries="$6"
-    local item_model="${7:-}"
-    local base_branch="${8:-main}"
+    local max_infra_retries="$7"
+    local item_model="${8:-}"
+    local base_branch="${9:-main}"
 
     local session_log="$session_dir/logs/session.log"
     local progress_json="$session_dir/logs/progress.json"
@@ -114,13 +109,6 @@ spawn_and_wait_session() {
     start_progress_parser "$session_log" "$progress_json" "$SCRIPTS_DIR"
     local parser_pid="${_PARSER_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 (with stale-kill protection)
     start_heartbeat "$cli_pid" "$session_log" "$progress_json" "$HEARTBEAT_INTERVAL" "$STALE_KILL_THRESHOLD"
     local heartbeat_pid="${_HEARTBEAT_PID:-}"
@@ -133,23 +121,34 @@ spawn_and_wait_session() {
         exit_code=$?
     fi
 
-    # Cleanup
-    [[ -n "$watcher_pid" ]] && kill "$watcher_pid" 2>/dev/null || true
+    # Clean up heartbeat and parser
     stop_heartbeat "$heartbeat_pid"
     stop_progress_parser "$parser_pid"
-    [[ -n "$watcher_pid" ]] && wait "$watcher_pid" 2>/dev/null || true
 
     # Recover session log from backup if truncated by subagent stdout redirection
     prizm_recover_session_log "$session_log"
 
-    [[ $exit_code -eq 143 ]] && exit_code=124
 
     # Check for stale-kill marker (heartbeat killed the process due to no progress)
     local stale_kill_marker="$session_dir/logs/stale-kill.json"
     local was_stale_killed=false
+    local stale_kill_reason=""
     if [[ -f "$stale_kill_marker" ]]; then
         was_stale_killed=true
-        log_warn "Session was stale-killed by heartbeat monitor (no progress for too long)"
+        stale_kill_reason=$(python3 - "$stale_kill_marker" <<'PY' 2>/dev/null || true
+import json, sys
+try:
+    with open(sys.argv[1], encoding="utf-8") as fh:
+        print(json.load(fh).get("reason") or "")
+except Exception:
+    pass
+PY
+)
+        if [[ "$stale_kill_reason" == "error_loop" ]]; then
+            log_warn "Session was killed by heartbeat monitor due to repeated read-offset/wasted-call errors"
+        else
+            log_warn "Session was stale-killed by heartbeat monitor (no progress for too long)"
+        fi
     fi
 
     local was_infra_error=false
@@ -175,15 +174,16 @@ spawn_and_wait_session() {
     project_root="$PROJECT_ROOT"
     local default_branch="$base_branch"
 
-    if [[ $exit_code -eq 124 ]]; then
-        log_warn "Session timed out after ${SESSION_TIMEOUT}s"
-        session_status="timed_out"
-    elif [[ "$was_infra_error" == true ]]; then
+    if [[ "$was_infra_error" == true ]]; then
         log_warn "Session failed due to AI CLI/provider infrastructure error"
         log_warn "Infrastructure errors are retried without consuming code retry budget"
         session_status="infra_error"
     elif [[ "$was_stale_killed" == true ]]; then
-        log_warn "Session stale-killed (no progress for ${STALE_KILL_THRESHOLD}s)"
+        if [[ "$stale_kill_reason" == "error_loop" ]]; then
+            log_warn "Session killed due to repeated read-offset/wasted-call error loop"
+        else
+            log_warn "Session stale-killed (no progress for ${STALE_KILL_THRESHOLD}s)"
+        fi
         log_warn "Stale-killed sessions are treated as failed; dev branch is preserved for inspection"
         session_status="crashed"
     elif [[ $exit_code -ne 0 ]]; then
@@ -200,10 +200,10 @@ spawn_and_wait_session() {
             session_status="success"
         else
             local uncommitted=""
-            uncommitted=$(git -C "$project_root" status --porcelain 2>/dev/null | head -1 || true)
+            uncommitted=$(prizm_git_status_safe "$project_root" | head -1 || true)
             if [[ -n "$uncommitted" ]]; then
                 log_warn "Session exited cleanly but produced no commits (uncommitted changes found) — auto-committing..."
-                git -C "$project_root" add -A 2>/dev/null || true
+                prizm_git_add_all_safe "$project_root" || true
                 if git -C "$project_root" commit --no-verify -m "chore($bug_id): auto-commit session work" 2>/dev/null; then
                     log_info "Auto-commit succeeded"
                     session_status="success"
@@ -222,10 +222,10 @@ spawn_and_wait_session() {
     if [[ "$session_status" == "success" ]]; then
         if git -C "$project_root" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
             local dirty_files=""
-            dirty_files=$(git -C "$project_root" status --porcelain 2>/dev/null || true)
+            dirty_files=$(prizm_git_status_safe "$project_root" || true)
             if [[ -n "$dirty_files" ]]; then
                 log_info "Auto-committing remaining session artifacts..."
-                git -C "$project_root" add -A 2>/dev/null || true
+                prizm_git_add_all_safe "$project_root" || true
                 git -C "$project_root" commit --no-verify --amend --no-edit 2>/dev/null \
                     || git -C "$project_root" commit --no-verify -m "chore($bug_id): include remaining session artifacts" 2>/dev/null \
                     || true
@@ -278,7 +278,20 @@ sys.exit(0)
     # Subagent detection
     prizm_detect_subagents "$session_log"
 
-    # Update bug status (do NOT commit on dev branch — commit happens after merge)
+    # Final status updates happen after the caller returns to the original branch.
+    _SPAWN_RESULT="$session_status"
+}
+
+finalize_bug_status_after_branch_return() {
+    local bug_id="$1"
+    local bug_list="$2"
+    local session_id="$3"
+    local session_status="$4"
+    local max_retries="$5"
+    local max_infra_retries="$6"
+
+    # Update bug status on the original branch. The caller commits the resulting
+    # bug-list diff immediately after this helper returns.
     local update_output
     update_output=$(python3 "$SCRIPTS_DIR/update-bug-status.py" \
         --bug-list "$bug_list" \
@@ -287,14 +300,13 @@ sys.exit(0)
         --session-status "$session_status" \
         --session-id "$session_id" \
         --max-retries "$max_retries" \
+        --max-infra-retries "$max_infra_retries" \
         --action update 2>&1) || {
         log_error "Failed to update bug status: $update_output"
         update_output=""
     }
 
     _SPAWN_ITEM_STATUS="$(printf '%s' "$update_output" | prizm_extract_update_new_status)"
-
-    _SPAWN_RESULT="$session_status"
 }
 
 # ============================================================
@@ -334,6 +346,8 @@ for bug in data.get('bugs', []):
                 --state-dir "$STATE_DIR" \
                 --bug-id "$_interrupted_id" \
                 --session-status "failed" \
+                --max-retries "$MAX_RETRIES" \
+                --max-infra-retries "$MAX_INFRA_RETRIES" \
                 --action update 2>/dev/null || true
             log_info "Bug $_interrupted_id marked as failed due to interrupt"
         fi
@@ -364,28 +378,6 @@ check_dependencies() {
     prizm_ensure_git_repo "$_project_root"
 }
 
-run_log_cleanup() {
-    if [[ "$LOG_CLEANUP_ENABLED" != "1" ]]; then
-        return 0
-    fi
-
-    local cleanup_result
-    cleanup_result=$(python3 "$SCRIPTS_DIR/cleanup-logs.py" \
-        --state-dir "$STATE_DIR" \
-        --retention-days "$LOG_RETENTION_DAYS" \
-        --max-total-mb "$LOG_MAX_TOTAL_MB" 2>/dev/null) || {
-        log_warn "Log cleanup failed (continuing)"
-        return 0
-    }
-
-    local deleted reclaimed_kb
-    deleted=$(echo "$cleanup_result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('deleted_files', 0))" 2>/dev/null || echo "0")
-    reclaimed_kb=$(echo "$cleanup_result" | python3 -c "import sys,json; print(int(json.load(sys.stdin).get('reclaimed_bytes', 0)/1024))" 2>/dev/null || echo "0")
-
-    if [[ "$deleted" -gt 0 ]]; then
-        log_info "Log cleanup: deleted $deleted files, reclaimed ${reclaimed_kb}KB"
-    fi
-}
 
 # ============================================================
 # run-one: Run a single bug fix
@@ -405,7 +397,16 @@ run_one() {
             --dry-run) dry_run=true; shift ;;
             --clean) do_clean=true; shift ;;
             --no-reset) no_reset=true; shift ;;
-            --timeout) shift; SESSION_TIMEOUT="${1:-0}"; shift ;;
+            --max-infra-retries)
+                shift
+                if [[ $# -eq 0 ]]; then
+                    log_error "--max-infra-retries requires a value"
+                    exit 1
+                fi
+                prizm_require_positive_int "--max-infra-retries" "$1"
+                MAX_INFRA_RETRIES="$1"
+                shift
+                ;;
             --mode)
                 shift
                 if [[ $# -eq 0 ]]; then
@@ -446,7 +447,6 @@ run_one() {
     fi
 
     check_dependencies
-    run_log_cleanup
 
     # Initialize state if needed
     if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
@@ -695,6 +695,8 @@ else:
                 --state-dir "$STATE_DIR" \
                 --bug-id "$bug_id" \
                 --session-status "failed" \
+                --max-retries "$MAX_RETRIES" \
+                --max-infra-retries "$MAX_INFRA_RETRIES" \
                 --action update 2>/dev/null || true
             log_info "Bug $bug_id marked as failed due to interrupt"
         fi
@@ -728,12 +730,13 @@ else:
     if branch_create "$_proj_root" "$_branch_name" "$_source_branch"; then
         _DEV_BRANCH_NAME="$_branch_name"
     else
-        log_warn "Failed to create branch; running session on current branch"
+        log_error "Failed to create branch: $_branch_name from $_source_branch — aborting to avoid running on $_source_branch"
+        return 1
     fi
 
     spawn_and_wait_session \
         "$bug_id" "$bug_list" "$session_id" \
-        "$bootstrap_prompt" "$session_dir" 999 "$bug_model" "$_ORIGINAL_BRANCH"
+        "$bootstrap_prompt" "$session_dir" "$MAX_RETRIES" "$MAX_INFRA_RETRIES" "$bug_model" "$_ORIGINAL_BRANCH"
     local session_status="$_SPAWN_RESULT"
 
     # Merge dev branch back to original on success
@@ -743,7 +746,7 @@ else:
         else
             log_warn "Auto-merge failed — dev branch preserved: $_DEV_BRANCH_NAME"
             log_warn "Merge manually: git checkout $_ORIGINAL_BRANCH && git rebase $_DEV_BRANCH_NAME"
-            _DEV_BRANCH_NAME=""
+            session_status="merge_conflict"
         fi
     elif [[ -n "$_DEV_BRANCH_NAME" ]]; then
         # Session failed — preserve dev branch for inspection
@@ -754,10 +757,12 @@ else:
     # GUARANTEED: always return to original branch regardless of success/failure/merge outcome
     branch_ensure_return "$_proj_root" "$_ORIGINAL_BRANCH"
 
+    finalize_bug_status_after_branch_return \
+        "$bug_id" "$bug_list" "$session_id" "$session_status" "$MAX_RETRIES" "$MAX_INFRA_RETRIES"
+
     # Commit bug status update on the original branch (after guaranteed return)
     if ! git -C "$_proj_root" diff --quiet "$bug_list" 2>/dev/null; then
-        git -C "$_proj_root" add "$bug_list"
-        git -C "$_proj_root" commit --no-verify -m "chore($bug_id): update bug status" 2>/dev/null || true
+        prizm_git_commit_paths "$_proj_root" "chore($bug_id): update bug status" "$bug_list"
     fi
 
     echo ""
@@ -778,7 +783,41 @@ else:
 # ============================================================
 
 main() {
-    local bug_list="${1:-$PRIZMKIT_DIR/plans/bug-fix-list.json}"
+    local bug_list="$PRIZMKIT_DIR/plans/bug-fix-list.json"
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --max-infra-retries)
+                shift
+                if [[ $# -eq 0 ]]; then
+                    log_error "--max-infra-retries requires a value"
+                    exit 1
+                fi
+                prizm_require_positive_int "--max-infra-retries" "$1"
+                MAX_INFRA_RETRIES="$1"
+                shift
+                ;;
+            --)
+                shift
+                break
+                ;;
+            -*)
+                log_error "Unknown option: $1"
+                show_help
+                exit 1
+                ;;
+            *)
+                bug_list="$1"
+                shift
+                ;;
+        esac
+    done
+
+    if [[ $# -gt 0 ]]; then
+        log_error "Unexpected arguments: $*"
+        show_help
+        exit 1
+    fi
 
     if [[ ! "$bug_list" = /* ]]; then
         bug_list="$(pwd)/$bug_list"
@@ -793,7 +832,6 @@ main() {
     fi
 
     check_dependencies
-    run_log_cleanup
 
     # Initialize pipeline state if needed
     if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
@@ -840,12 +878,8 @@ main() {
     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 "Max code retries per bug: $MAX_RETRIES"
+    log_info "Max infrastructure retries per bug: $MAX_INFRA_RETRIES"
     log_info "AI CLI: $CLI_CMD (platform: $PLATFORM)"
     if [[ -n "${MODEL:-}" ]]; then
         log_info "Default Model: $MODEL"
@@ -885,6 +919,7 @@ main() {
             --bug-list "$bug_list" \
             --state-dir "$STATE_DIR" \
             --max-retries "$MAX_RETRIES" \
+            --max-infra-retries "$MAX_INFRA_RETRIES" \
             --action get_next 2>/dev/null); then
             log_error "Failed to get next bug"
             break
@@ -972,27 +1007,40 @@ DEPLOY_PROMPT_EOF
         fi
 
         # Parse bug info
-        local bug_id bug_title bug_severity retry_count resume_phase
+        local bug_id bug_title bug_severity retry_count infra_error_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')
+        infra_error_count=$(echo "$next_bug" | jq -r '.infra_error_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"
+        log_info "Severity: $bug_severity"
+        log_info "Code retry: $retry_count / $MAX_RETRIES"
+        log_info "Infrastructure retry: $infra_error_count / $MAX_INFRA_RETRIES"
         if [[ "$resume_phase" != "null" ]]; then
             log_info "Resuming from Phase $resume_phase"
         fi
         echo -e "${BOLD}────────────────────────────────────────────────────${NC}"
 
-        # Pre-commit any dirty tree from previous iteration
-        if ! git -C "$_proj_root" diff --quiet HEAD 2>/dev/null || [ -n "$(git -C "$_proj_root" ls-files --others --exclude-standard 2>/dev/null)" ]; then
-            log_info "Dirty working tree detected — committing before $bug_id..."
-            git -C "$_proj_root" add -A 2>/dev/null || true
-            git -C "$_proj_root" commit --no-verify -m "chore: capture artifacts before $bug_id session" 2>/dev/null || true
+        # Auto-commit any uncommitted workspace changes before starting the pipeline.
+        # This ensures a clean baseline without blocking execution.
+        local _dirty_files=""
+        _dirty_files=$(prizm_git_status_non_bookkeeping "$_proj_root" "$STATE_DIR" "$bug_list" || true)
+        if [[ -n "$_dirty_files" ]]; then
+            log_info "Auto-committing workspace changes before $bug_id..."
+            prizm_git_add_all_safe "$_proj_root"
+            git -C "$_proj_root" commit --no-verify -m "chore: workspace snapshot ready for run $bug_id" 2>/dev/null || true
+        fi
+
+        local _bookkeeping_dirty=""
+        _bookkeeping_dirty=$(prizm_git_status_bookkeeping "$_proj_root" "$STATE_DIR" "$bug_list" || true)
+        if [[ -n "$_bookkeeping_dirty" ]]; then
+            log_info "Committing pending pipeline bookkeeping before $bug_id..."
+            prizm_git_commit_paths "$_proj_root" "chore($bug_id): include pipeline bookkeeping" "$bug_list" "$STATE_DIR"
         fi
 
         # Mark bug as in-progress BEFORE creating dev branch
@@ -1005,8 +1053,7 @@ DEPLOY_PROMPT_EOF
             --action start >/dev/null 2>&1 || true
         # Commit the in_progress status on the original branch
         if ! git -C "$_proj_root" diff --quiet "$bug_list" 2>/dev/null; then
-            git -C "$_proj_root" add "$bug_list" 2>/dev/null || true
-            git -C "$_proj_root" commit --no-verify -m "chore($bug_id): mark in_progress" 2>/dev/null || true
+            prizm_git_commit_paths "$_proj_root" "chore($bug_id): mark in_progress" "$bug_list"
         fi
 
         # Create per-bug dev branch (from the now-updated original branch)
@@ -1015,8 +1062,9 @@ DEPLOY_PROMPT_EOF
             _DEV_BRANCH_NAME="$_bug_branch"
             log_info "Dev branch: $_bug_branch"
         else
-            log_warn "Failed to create dev branch; running on current branch: $_ORIGINAL_BRANCH"
+            log_error "Failed to create dev branch: $_bug_branch from $_ORIGINAL_BRANCH — aborting to avoid running on $_ORIGINAL_BRANCH"
             _DEV_BRANCH_NAME=""
+            break
         fi
 
         # Generate session
@@ -1086,10 +1134,9 @@ DEPLOY_PROMPT_EOF
 
         spawn_and_wait_session \
             "$bug_id" "$bug_list" "$session_id" \
-            "$bootstrap_prompt" "$session_dir" "$MAX_RETRIES" "$bug_model" "$_ORIGINAL_BRANCH"
+            "$bootstrap_prompt" "$session_dir" "$MAX_RETRIES" "$MAX_INFRA_RETRIES" "$bug_model" "$_ORIGINAL_BRANCH"
 
         local session_status="$_SPAWN_RESULT"
-        local item_status_after_session="${_SPAWN_ITEM_STATUS:-}"
 
         # Merge per-bug dev branch back to original on success
         if [[ "$session_status" == "success" && -n "$_DEV_BRANCH_NAME" ]]; then
@@ -1098,7 +1145,7 @@ DEPLOY_PROMPT_EOF
             else
                 log_warn "Auto-merge failed — dev branch preserved: $_DEV_BRANCH_NAME"
                 log_warn "Merge manually: git checkout $_ORIGINAL_BRANCH && git rebase $_DEV_BRANCH_NAME"
-                _DEV_BRANCH_NAME=""
+                session_status="merge_conflict"
             fi
         elif [[ -n "$_DEV_BRANCH_NAME" ]]; then
             # Session failed — preserve dev branch for inspection
@@ -1109,10 +1156,13 @@ DEPLOY_PROMPT_EOF
         # GUARANTEED: always return to original branch regardless of success/failure/merge outcome
         branch_ensure_return "$_proj_root" "$_ORIGINAL_BRANCH"
 
+        finalize_bug_status_after_branch_return \
+            "$bug_id" "$bug_list" "$session_id" "$session_status" "$MAX_RETRIES" "$MAX_INFRA_RETRIES"
+        local item_status_after_session="${_SPAWN_ITEM_STATUS:-}"
+
         # Commit bug status update on the original branch (after guaranteed return)
         if ! git -C "$_proj_root" diff --quiet "$bug_list" 2>/dev/null; then
-            git -C "$_proj_root" add "$bug_list"
-            git -C "$_proj_root" commit --no-verify -m "chore($bug_id): update bug status" 2>/dev/null || true
+            prizm_git_commit_paths "$_proj_root" "chore($bug_id): update bug status" "$bug_list"
         fi
 
         session_count=$((session_count + 1))
@@ -1129,7 +1179,7 @@ DEPLOY_PROMPT_EOF
             log_error "════════════════════════════════════════════════════"
             break
         elif [[ "$session_status" != "success" && "$STOP_ON_FAILURE" == "1" ]]; then
-            log_info "STOP_ON_FAILURE: $bug_id is ${item_status_after_session:-unknown}; retry budget not exhausted, continuing."
+            log_info "STOP_ON_FAILURE: $bug_id is ${item_status_after_session:-unknown}; code/infra retry budget not exhausted, continuing."
         fi
 
         # Stuck detection
@@ -1166,7 +1216,7 @@ show_help() {
     echo "Usage: $0 <command> [options]"
     echo ""
     echo "Commands:"
-    echo "  run [.prizmkit/plans/bug-fix-list.json]                 Run all bugs by severity/priority order"
+    echo "  run [.prizmkit/plans/bug-fix-list.json] [options]         Run all bugs by severity/priority order"
     echo "  run <bug-id> [options]                   Run a single bug fix"
     echo "  status [.prizmkit/plans/bug-fix-list.json]               Show bug fix pipeline status"
     echo "  reset                                    Clear all bugfix state"
@@ -1176,14 +1226,17 @@ show_help() {
     echo "  --dry-run                   Generate bootstrap prompt only, don't spawn session"
     echo "  --clean                     Delete artifacts and reset before running"
     echo "  --no-reset                  Skip status reset (preserve retry count)"
-    echo "  --timeout N                 Session timeout in seconds (default: 0 = no limit)"
+    echo "  --max-infra-retries N       Max infrastructure/provider retries (default: 3)"
     echo "  --mode <lite|standard|full> Override pipeline mode"
     echo "  --critic                    Enable adversarial critic review"
     echo "  --no-critic                 Disable adversarial critic review"
     echo ""
+    echo "Pipeline Options (run all):"
+    echo "  --max-infra-retries N       Max infrastructure/provider retries (default: 3)"
+    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 "  MAX_RETRIES           Max code retries per bug (default: 3)"
+    echo "  MAX_INFRA_RETRIES     Max infrastructure/provider retries per bug (default: 3)"
     echo "  MODEL                 Default AI model (overridden by per-bug model in bug list)"
     echo "  PRIZMKIT_EFFORT       AI reasoning effort (low|medium|high|xhigh|max; max is Claude Code only)"
     echo "  PIPELINE_MODE         Default pipeline mode: lite|standard|full (overridden by --mode)"
@@ -1193,9 +1246,6 @@ show_help() {
     echo "  HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)"
     echo "  STALE_KILL_THRESHOLD  Auto-kill session after N seconds of no progress (default: 900)"
     echo "  STOP_ON_FAILURE       Stop pipeline when a task exhausts retries: 0|1 (default: 0)"
-    echo "  LOG_CLEANUP_ENABLED   Run log cleanup before execution (default: 1)"
-    echo "  LOG_RETENTION_DAYS    Delete logs older than N days (default: 14)"
-    echo "  LOG_MAX_TOTAL_MB      Keep total logs under N MB (default: 1024)"
     echo ""
     echo "Examples:"
     echo "  ./run-bugfix.sh run                                    # Run all bugs"
@@ -1203,7 +1253,6 @@ show_help() {
     echo "  ./run-bugfix.sh run B-001 --dry-run                    # Inspect generated prompt"
     echo "  ./run-bugfix.sh run B-001 --clean                      # Clean artifacts + reset + run"
     echo "  ./run-bugfix.sh run B-001 --no-reset                   # Retry without resetting status"
-    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"
 }
@@ -1214,7 +1263,7 @@ case "${1:-run}" in
         if [[ "${1:-}" =~ ^[Bb]-[0-9]+ ]]; then
             run_one "$@"
         else
-            main "${1:-$PRIZMKIT_DIR/plans/bug-fix-list.json}"
+            main "$@"
         fi
         ;;
     status)
@@ -1226,6 +1275,8 @@ case "${1:-run}" in
         python3 "$SCRIPTS_DIR/update-bug-status.py" \
             --bug-list "${2:-$PRIZMKIT_DIR/plans/bug-fix-list.json}" \
             --state-dir "$STATE_DIR" \
+            --max-retries "$MAX_RETRIES" \
+            --max-infra-retries "$MAX_INFRA_RETRIES" \
             --action status
         ;;
     reset)