prizmkit 1.1.9 → 1.1.12

package/bundled/skills/refactor-pipeline-launcher/SKILL.md

@@ -227,7 +227,7 @@ Detect user intent from their message, then follow the corresponding workflow:
    **If foreground**: Pipeline runs to completion in the terminal. After it finishes:
    - Summarize results: total refactors, succeeded, failed, skipped
    - If all succeeded: each refactor session has already run `prizmkit-retrospective` internally. Ask user what's next.
-   - If some failed: show failed refactor IDs and suggest `retry-refactor.sh <R-XXX>` or `reset-refactor.sh <R-XXX> --clean --run`
+   - If some failed: show failed refactor IDs and suggest `reset-refactor.sh <R-XXX> --clean --run` for a fresh retry
 
    **If background daemon**:
    1. Verify launch:
@@ -315,25 +315,14 @@ Detect user intent from their message, then follow the corresponding workflow:
 
 #### Intent E: Retry Single Refactor
 
-When user says "retry R-001":
-
-```bash
-dev-pipeline/retry-refactor.sh R-001 .prizmkit/plans/refactor-list.json
-```
-
-When user says "clean retry R-001" or "retry R-001 from scratch":
+When user says "retry R-001" or "clean retry R-001":
 
 ```bash
 dev-pipeline/reset-refactor.sh R-001 --clean --run .prizmkit/plans/refactor-list.json
 ```
 
-Environment variables (optional):
-```bash
-SESSION_TIMEOUT=3600 STRICT_BEHAVIOR_CHECK=1 dev-pipeline/retry-refactor.sh R-001 .prizmkit/plans/refactor-list.json
-```
-
 Notes:
-- `retry-refactor.sh` runs exactly one refactor session and exits. It **preserves prior session artifacts and checkpoint state** — reads `retry_count` and `resume_from_phase` from `status.json` so the AI session can resume from where it left off. For a full clean retry, use `dev-pipeline/reset-refactor.sh <R-XXX> --clean --run`.
+- `reset-refactor.sh --clean --run` performs a full clean (deletes session history and artifacts) before retrying — this gives a fresh start.
 - Keep pipeline daemon mode for main run management (`launch-refactor-daemon.sh`).
 
 ---
@@ -350,7 +339,7 @@ Notes:
 | Refactor pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `launch-refactor-daemon.sh` auto-cleans, retry start |
 | Launch failed (process died immediately) | Show last 20 lines of log: `tail -20 .prizmkit/state/refactor/pipeline-daemon.log` |
-| Refactor stuck/blocked | Use `retry-refactor.sh <R-XXX>` to retry; use `reset-refactor.sh <R-XXX> --clean --run` for fresh start |
+| Refactor stuck/blocked | Use `reset-refactor.sh <R-XXX> --clean --run` for a fresh retry |
 | All refactors blocked/failed | Show status, suggest recovery: `dev-pipeline/reset-refactor.sh <R-XXX> --clean --run .prizmkit/plans/refactor-list.json` |
 | Permission denied on script | Run `chmod +x dev-pipeline/launch-refactor-daemon.sh dev-pipeline/run-refactor.sh` |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.9",
+  "version": "1.1.12",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

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

@@ -1,429 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# ============================================================
-# dev-pipeline/retry-bugfix.sh - Retry a single failed bug fix
-#
-# Runs exactly ONE AI CLI session for the specified bug, then exits.
-# Use this to manually retry a failed bug without restarting
-# the full bugfix pipeline.
-#
-# Usage:
-#   ./retry-bugfix.sh <bug-id> [.prizmkit/plans/bug-fix-list.json]
-#
-# Examples:
-#   ./retry-bugfix.sh B-001
-#   ./retry-bugfix.sh B-001 .prizmkit/plans/bug-fix-list.json
-#   SESSION_TIMEOUT=3600 ./retry-bugfix.sh B-001
-# ============================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/bugfix"
-SCRIPTS_DIR="$SCRIPT_DIR/scripts"
-
-SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}
-HEARTBEAT_INTERVAL=${HEARTBEAT_INTERVAL:-30}
-AUTO_PUSH=${AUTO_PUSH:-0}
-DEV_BRANCH=${DEV_BRANCH:-""}
-
-# Source shared libraries (CLI/platform detection + logs + deps)
-source "$SCRIPT_DIR/lib/common.sh"
-prizm_detect_cli_and_platform
-
-# Source shared heartbeat library
-source "$SCRIPT_DIR/lib/heartbeat.sh"
-
-# Source shared branch library
-source "$SCRIPT_DIR/lib/branch.sh"
-
-# Detect stream-json support
-detect_stream_json_support "$CLI_CMD"
-
-# ============================================================
-# Args
-# ============================================================
-
-if [[ $# -lt 1 ]]; then
-    echo "Usage: $0 <bug-id> [.prizmkit/plans/bug-fix-list.json]"
-    echo ""
-    echo "  bug-id              Bug to retry (e.g. B-001)"
-    echo "  bug-fix-list.json   Path to bug fix list (default: .prizmkit/plans/bug-fix-list.json)"
-    echo ""
-    echo "Environment Variables:"
-    echo "  SESSION_TIMEOUT     Timeout in seconds (default: 0 = no limit)"
-    echo "  HEARTBEAT_INTERVAL  Heartbeat interval in seconds (default: 30)"
-    echo "  AI_CLI              AI CLI command (auto-detected: cbc or claude)"
-    echo "  AUTO_PUSH           Auto-push to remote after fix (default: 0)"
-    echo "  DEV_BRANCH          Custom dev branch name (default: auto-generated)"
-    exit 1
-fi
-
-BUG_ID="$1"
-BUG_LIST="${2:-.prizmkit/plans/bug-fix-list.json}"
-
-if [[ ! "$BUG_LIST" = /* ]]; then
-    BUG_LIST="$(pwd)/$BUG_LIST"
-fi
-
-# ============================================================
-# Validation
-# ============================================================
-
-if [[ ! -f "$BUG_LIST" ]]; then
-    log_error "Bug fix list not found: $BUG_LIST"
-    exit 1
-fi
-
-if ! command -v jq &>/dev/null; then
-    log_error "jq is required. Install with: brew install jq"
-    exit 1
-fi
-
-# 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
-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
-}
-
-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"
-
-# ============================================================
-# Clean bug artifacts + reset status for a full restart
-# ============================================================
-
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-ORIGINAL_BRANCH=$(git -C "$PROJECT_ROOT" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
-
-# Branch tracking (for cleanup on interrupt)
-_DEV_BRANCH_NAME=""
-
-log_info "Reading retry state for $BUG_ID..."
-RETRY_COUNT=$(python3 -c "
-import json, os
-status_path = os.path.join('$STATE_DIR', 'bugs', '$BUG_ID', 'status.json')
-if os.path.isfile(status_path):
-    with open(status_path) as f:
-        d = json.load(f)
-    print(d.get('retry_count', 0))
-else:
-    print(0)
-" 2>/dev/null || echo "0")
-RESUME_PHASE=$(python3 -c "
-import json, os
-status_path = os.path.join('$STATE_DIR', 'bugs', '$BUG_ID', 'status.json')
-if os.path.isfile(status_path):
-    with open(status_path) as f:
-        d = json.load(f)
-    print(d.get('resume_from_phase') or 'null')
-else:
-    print('null')
-" 2>/dev/null || echo "null")
-log_info "Retry count: $RETRY_COUNT, Resume phase: $RESUME_PHASE"
-
-# ============================================================
-# Generate 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..."
-GEN_ARGS=(
-    --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"
-)
-
-# Support PIPELINE_MODE env var
-if [[ -n "${PIPELINE_MODE:-}" ]]; then
-    GEN_ARGS+=(--mode "$PIPELINE_MODE")
-fi
-
-# Support ENABLE_CRITIC env var
-if [[ "${ENABLE_CRITIC:-}" == "true" || "${ENABLE_CRITIC:-}" == "1" ]]; then
-    GEN_ARGS+=(--critic "true")
-elif [[ "${ENABLE_CRITIC:-}" == "false" || "${ENABLE_CRITIC:-}" == "0" ]]; then
-    GEN_ARGS+=(--critic "false")
-fi
-
-GEN_OUTPUT=$(python3 "$SCRIPTS_DIR/generate-bugfix-prompt.py" "${GEN_ARGS[@]}" 2>/dev/null) || {
-    log_error "Failed to generate bootstrap prompt"
-    exit 1
-}
-BUG_MODEL=$(echo "$GEN_OUTPUT" | python3 -c "import json,sys; print(json.load(sys.stdin).get('model',''))" 2>/dev/null || echo "")
-
-# ============================================================
-# Run single AI CLI session
-# ============================================================
-
-# Branch lifecycle: create and checkout bugfix branch
-_branch_name="${DEV_BRANCH:-bugfix/${BUG_ID}-$(date +%s)}"
-if branch_create "$PROJECT_ROOT" "$_branch_name" "$ORIGINAL_BRANCH"; then
-    _DEV_BRANCH_NAME="$_branch_name"
-    log_info "Dev branch: $_branch_name"
-else
-    log_warn "Failed to create branch; running session on current branch"
-fi
-
-echo ""
-echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
-echo -e "${BOLD}  Retry Bug Fix: $BUG_ID — $BUG_TITLE${NC}"
-echo -e "${BOLD}  Severity: $BUG_SEVERITY${NC}"
-echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
-log_info "CLI: $CLI_CMD (platform: $PLATFORM)"
-EFFECTIVE_MODEL="${BUG_MODEL:-${MODEL:-}}"
-if [[ -n "$EFFECTIVE_MODEL" ]]; then
-    log_info "Model: $EFFECTIVE_MODEL"
-else
-    log_info "Model: (CLI default)"
-fi
-if [[ $SESSION_TIMEOUT -gt 0 ]]; then
-    log_info "Session timeout: ${SESSION_TIMEOUT}s"
-else
-    log_info "Session timeout: none"
-fi
-log_info "Prompt: $BOOTSTRAP_PROMPT"
-log_info "Log: $SESSION_DIR/logs/session.log"
-echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
-echo ""
-
-SESSION_LOG="$SESSION_DIR/logs/session.log"
-PROGRESS_JSON="$SESSION_DIR/logs/progress.json"
-
-# Build stream-json flag
-STREAM_JSON_FLAG=""
-if [[ "$USE_STREAM_JSON" == "true" ]]; then
-    STREAM_JSON_FLAG="--output-format stream-json"
-fi
-
-# claude-internal requires --verbose when using stream-json with -p/--print
-VERBOSE_FLAG=""
-if [[ "$USE_STREAM_JSON" == "true" ]]; then
-    VERBOSE_FLAG="--verbose"
-fi
-
-# Spawn AI CLI session — model priority: bug.model > $MODEL env > none
-EFFECTIVE_MODEL="${BUG_MODEL:-${MODEL:-}}"
-MODEL_FLAG=""
-if [[ -n "$EFFECTIVE_MODEL" ]]; then
-    MODEL_FLAG="--model $EFFECTIVE_MODEL"
-fi
-
-unset CLAUDECODE 2>/dev/null || true
-
-# Log bootstrap prompt in test mode
-prizm_log_bootstrap_prompt "$BOOTSTRAP_PROMPT" "$BUG_ID"
-
-case "$CLI_CMD" in
-    *claude*)
-        # Claude Code: prompt via -p argument, --dangerously-skip-permissions for auto-accept
-        "$CLI_CMD" \
-            -p "$(cat "$BOOTSTRAP_PROMPT")" \
-            --dangerously-skip-permissions \
-            $VERBOSE_FLAG \
-            $STREAM_JSON_FLAG \
-            $MODEL_FLAG \
-            > "$SESSION_LOG" 2>&1 &
-        ;;
-    *)
-        # CodeBuddy (cbc) and others: prompt via stdin
-        "$CLI_CMD" \
-            --print \
-            -y \
-            $STREAM_JSON_FLAG \
-            $MODEL_FLAG \
-            < "$BOOTSTRAP_PROMPT" \
-            > "$SESSION_LOG" 2>&1 &
-        ;;
-esac
-CLI_PID=$!
-
-# Start progress parser (no-op if stream-json not supported)
-start_progress_parser "$SESSION_LOG" "$PROGRESS_JSON" "$SCRIPTS_DIR"
-PARSER_PID="${_PARSER_PID:-}"
-
-# Timeout watchdog
-WATCHER_PID=""
-if [[ $SESSION_TIMEOUT -gt 0 ]]; then
-    ( sleep "$SESSION_TIMEOUT" && kill -TERM "$CLI_PID" 2>/dev/null ) &
-    WATCHER_PID=$!
-fi
-
-# Heartbeat
-start_heartbeat "$CLI_PID" "$SESSION_LOG" "$PROGRESS_JSON" "$HEARTBEAT_INTERVAL"
-HEARTBEAT_PID="${_HEARTBEAT_PID:-}"
-
-# Ctrl+C cleanup
-cleanup() {
-    echo ""
-    log_warn "Interrupted. Killing session..."
-    kill "$CLI_PID" 2>/dev/null || true
-    [[ -n "$WATCHER_PID" ]] && kill "$WATCHER_PID" 2>/dev/null || true
-    stop_heartbeat "$HEARTBEAT_PID"
-    stop_progress_parser "$PARSER_PID"
-    wait "$CLI_PID" 2>/dev/null || true
-    [[ -n "$WATCHER_PID" ]] && wait "$WATCHER_PID" 2>/dev/null || true
-    if [[ -n "$_DEV_BRANCH_NAME" ]]; then
-        log_info "Development was on branch: $_DEV_BRANCH_NAME"
-        log_info "Original branch was: $ORIGINAL_BRANCH"
-    fi
-    log_info "Session log: $SESSION_LOG"
-    exit 130
-}
-trap cleanup SIGINT SIGTERM
-
-# Wait
-EXIT_CODE=0
-if wait "$CLI_PID" 2>/dev/null; then
-    EXIT_CODE=0
-else
-    EXIT_CODE=$?
-fi
-
-# Cleanup background processes
-[[ -n "$WATCHER_PID" ]] && kill "$WATCHER_PID" 2>/dev/null || true
-stop_heartbeat "$HEARTBEAT_PID"
-stop_progress_parser "$PARSER_PID"
-[[ -n "$WATCHER_PID" ]] && wait "$WATCHER_PID" 2>/dev/null || true
-
-[[ $EXIT_CODE -eq 143 ]] && EXIT_CODE=124
-
-# ============================================================
-# Check result
-# ============================================================
-
-echo ""
-if [[ -f "$SESSION_LOG" ]]; then
-    FINAL_LINES=$(wc -l < "$SESSION_LOG" 2>/dev/null | tr -d ' ')
-    FINAL_SIZE=$(wc -c < "$SESSION_LOG" 2>/dev/null | tr -d ' ')
-    log_info "Session log: $FINAL_LINES lines, $((FINAL_SIZE / 1024))KB"
-fi
-log_info "exit_code=$EXIT_CODE"
-
-# ── Determine session outcome from observable signals ──────────────
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-DEFAULT_BRANCH="$ORIGINAL_BRANCH"
-
-if [[ $EXIT_CODE -eq 124 ]]; then
-    log_warn "Session timed out after ${SESSION_TIMEOUT}s"
-    SESSION_STATUS="timed_out"
-elif [[ $EXIT_CODE -ne 0 ]]; then
-    log_warn "Session exited with code $EXIT_CODE"
-    SESSION_STATUS="crashed"
-else
-    # Exit code 0 — check if the session produced commits
-    HAS_COMMITS=""
-    if git -C "$PROJECT_ROOT" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-        HAS_COMMITS=$(git -C "$PROJECT_ROOT" log "${DEFAULT_BRANCH}..HEAD" --oneline 2>/dev/null | head -1)
-    fi
-
-    if [[ -n "$HAS_COMMITS" ]]; then
-        SESSION_STATUS="success"
-    else
-        UNCOMMITTED=$(git -C "$PROJECT_ROOT" status --porcelain 2>/dev/null | 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
-            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"
-            else
-                log_warn "Auto-commit failed — no changes to commit"
-                SESSION_STATUS="crashed"
-            fi
-        else
-            log_warn "Session exited cleanly but produced no commits and no changes"
-            SESSION_STATUS="crashed"
-        fi
-    fi
-fi
-
-# ── Post-success validation ──────────────────────────────────────────
-if [[ "$SESSION_STATUS" == "success" ]]; then
-    if git -C "$PROJECT_ROOT" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-        DIRTY_FILES=$(git -C "$PROJECT_ROOT" status --porcelain 2>/dev/null || true)
-        if [[ -n "$DIRTY_FILES" ]]; then
-            log_info "Auto-committing remaining session artifacts..."
-            git -C "$PROJECT_ROOT" add -A 2>/dev/null || true
-            git -C "$PROJECT_ROOT" commit --no-verify --amend --no-edit -a 2>/dev/null \
-                || git -C "$PROJECT_ROOT" commit --no-verify -m "chore($BUG_ID): include remaining session artifacts" 2>/dev/null \
-                || true
-        fi
-    fi
-fi
-
-# ── Merge dev branch back to original on success ────────────────────
-if [[ "$SESSION_STATUS" == "success" && -n "$_DEV_BRANCH_NAME" ]]; then
-    if branch_merge "$PROJECT_ROOT" "$_DEV_BRANCH_NAME" "$ORIGINAL_BRANCH" "$AUTO_PUSH"; then
-        _DEV_BRANCH_NAME=""
-    else
-        log_warn "Auto-merge failed — dev branch preserved: $_DEV_BRANCH_NAME"
-    fi
-fi
-
-# 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 999 \
-    --action update >/dev/null 2>&1 || true
-
-# Commit bug-fix-list.json status update (pipeline management commit)
-if ! git -C "$PROJECT_ROOT" diff --quiet "$BUG_LIST" 2>/dev/null; then
-    git -C "$PROJECT_ROOT" add "$BUG_LIST"
-    git -C "$PROJECT_ROOT" commit --no-verify -m "chore($BUG_ID): update bug status" 2>/dev/null || true
-fi
-
-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_LOG"
-    log_error "════════════════════════════════════════════════════"
-fi