prizmkit 1.1.9 → 1.1.12

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

@@ -1,441 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# ============================================================
-# dev-pipeline/retry-refactor.sh - Retry a single failed refactor
-#
-# Runs exactly ONE AI CLI session for the specified refactor, then exits.
-# Use this to manually retry a failed refactor without restarting
-# the full refactor pipeline.
-#
-# Usage:
-#   ./retry-refactor.sh <refactor-id> [.prizmkit/plans/refactor-list.json]
-#
-# Examples:
-#   ./retry-refactor.sh R-001
-#   ./retry-refactor.sh R-001 .prizmkit/plans/refactor-list.json
-#   SESSION_TIMEOUT=3600 ./retry-refactor.sh R-001
-# ============================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/refactor"
-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 common helpers (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 <refactor-id> [.prizmkit/plans/refactor-list.json]"
-    echo ""
-    echo "  refactor-id           Refactor to retry (e.g. R-001)"
-    echo "  refactor-list.json    Path to refactor list (default: .prizmkit/plans/refactor-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)"
-    exit 1
-fi
-
-REFACTOR_ID="$1"
-REFACTOR_LIST="${2:-.prizmkit/plans/refactor-list.json}"
-
-if [[ ! "$REFACTOR_LIST" = /* ]]; then
-    REFACTOR_LIST="$(pwd)/$REFACTOR_LIST"
-fi
-
-# ============================================================
-# Validation
-# ============================================================
-
-if [[ ! -f "$REFACTOR_LIST" ]]; then
-    log_error "Refactor list not found: $REFACTOR_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 refactor pipeline state..."
-    python3 "$SCRIPTS_DIR/init-refactor-pipeline.py" \
-        --refactor-list "$REFACTOR_LIST" \
-        --state-dir "$STATE_DIR" >/dev/null 2>&1 || {
-        log_error "Failed to initialize refactor pipeline state"
-        exit 1
-    }
-fi
-
-# Verify refactor exists
-REFACTOR_TITLE=$(python3 -c "
-import json, sys
-with open('$REFACTOR_LIST') as f:
-    data = json.load(f)
-for item in data.get('refactors', []):
-    if item.get('id') == '$REFACTOR_ID':
-        print(item.get('title', ''))
-        sys.exit(0)
-sys.exit(1)
-" 2>/dev/null) || {
-    log_error "Refactor $REFACTOR_ID not found in $REFACTOR_LIST"
-    exit 1
-}
-
-REFACTOR_COMPLEXITY=$(python3 -c "
-import json, sys
-with open('$REFACTOR_LIST') as f:
-    data = json.load(f)
-for item in data.get('refactors', []):
-    if item.get('id') == '$REFACTOR_ID':
-        print(item.get('complexity', 'medium'))
-        sys.exit(0)
-sys.exit(1)
-" 2>/dev/null) || REFACTOR_COMPLEXITY="medium"
-
-# ============================================================
-# Clean refactor 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 $REFACTOR_ID..."
-RETRY_COUNT=$(python3 -c "
-import json, os
-status_path = os.path.join('$STATE_DIR', 'refactors', '$REFACTOR_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', 'refactors', '$REFACTOR_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="${REFACTOR_ID}-$(date +%Y%m%d%H%M%S)"
-SESSION_DIR="$STATE_DIR/refactors/$REFACTOR_ID/sessions/$SESSION_ID"
-mkdir -p "$SESSION_DIR/logs"
-
-BOOTSTRAP_PROMPT="$SESSION_DIR/bootstrap-prompt.md"
-
-log_info "Generating refactor bootstrap prompt..."
-GEN_ARGS=(
-    --refactor-list "$REFACTOR_LIST"
-    --refactor-id "$REFACTOR_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-refactor-prompt.py" "${GEN_ARGS[@]}" 2>/dev/null) || {
-    log_error "Failed to generate bootstrap prompt"
-    exit 1
-}
-REFACTOR_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 refactor branch
-_branch_name="${DEV_BRANCH:-refactor/${REFACTOR_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 Refactor: $REFACTOR_ID — $REFACTOR_TITLE${NC}"
-echo -e "${BOLD}  Complexity: $REFACTOR_COMPLEXITY${NC}"
-echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
-log_info "CLI: $CLI_CMD (platform: $PLATFORM)"
-EFFECTIVE_MODEL="${REFACTOR_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: refactor.model > $MODEL env > none
-EFFECTIVE_MODEL="${REFACTOR_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" "$REFACTOR_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($REFACTOR_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($REFACTOR_ID): include remaining session artifacts" 2>/dev/null \
-                || true
-        fi
-    fi
-fi
-
-# ── Propagate completion notes for dependency context ─────────────────
-if [[ "$SESSION_STATUS" == "success" ]]; then
-    SUMMARY_PATH="$PROJECT_ROOT/.prizmkit/refactor/$REFACTOR_ID/completion-summary.json"
-    if [[ -f "$SUMMARY_PATH" ]]; then
-        python3 "$SCRIPTS_DIR/patch-completion-notes.py" \
-            --refactor-list "$REFACTOR_LIST" \
-            --refactor-id "$REFACTOR_ID" \
-            --summary "$SUMMARY_PATH" >/dev/null 2>&1 && {
-            log_info "Propagated completion notes for $REFACTOR_ID"
-        } || {
-            log_warn "Failed to propagate completion notes for $REFACTOR_ID"
-        }
-    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 refactor status
-python3 "$SCRIPTS_DIR/update-refactor-status.py" \
-    --refactor-list "$REFACTOR_LIST" \
-    --state-dir "$STATE_DIR" \
-    --refactor-id "$REFACTOR_ID" \
-    --session-status "$SESSION_STATUS" \
-    --session-id "$SESSION_ID" \
-    --max-retries 999 \
-    --action update >/dev/null 2>&1 || true
-
-# Commit refactor-list.json status update (pipeline management commit)
-if ! git -C "$PROJECT_ROOT" diff --quiet "$REFACTOR_LIST" 2>/dev/null; then
-    git -C "$PROJECT_ROOT" add "$REFACTOR_LIST"
-    git -C "$PROJECT_ROOT" commit --no-verify -m "chore($REFACTOR_ID): update refactor status" 2>/dev/null || true
-fi
-
-echo ""
-if [[ "$SESSION_STATUS" == "success" ]]; then
-    log_success "════════════════════════════════════════════════════"
-    log_success "  $REFACTOR_ID completed successfully!"
-    log_success "════════════════════════════════════════════════════"
-else
-    log_error "════════════════════════════════════════════════════"
-    log_error "  $REFACTOR_ID result: $SESSION_STATUS"
-    log_error "  Review log: $SESSION_LOG"
-    log_error "════════════════════════════════════════════════════"
-fi

package/bundled/dev-pipeline/templates/sections/failure-log-check.md

@@ -1,9 +0,0 @@
-**Check for previous failure log** (diagnostic context only — do NOT use to determine resume point):
-```bash
-cat .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md 2>/dev/null || echo "NO_PREVIOUS_FAILURE"
-```
-If failure-log.md exists:
-- Read ROOT_CAUSE and SUGGESTION — adjust your approach accordingly
-- Read DISCOVERED_TRAPS — if any are genuine, inject into .prizm-docs/ during the commit phase retrospective
-- Do NOT delete failure-log.md until this session completes all phases and commits successfully
-- **Note**: The resume point is determined by `workflow-checkpoint.json`, not by failure-log.md

package/bundled/dev-pipeline/templates/sections/resume-header.md

@@ -1,5 +0,0 @@
-### Resume from Phase {{RESUME_PHASE}}
-
-**Primary**: Read `{{CHECKPOINT_PATH}}` — find the first step with `"pending"` or `"in_progress"` status and resume from there. Steps already `"completed"` or `"skipped"` must NOT be re-executed.
-
-**Fallback**: If `workflow-checkpoint.json` is missing or corrupted, check `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` — if it exists, skip context building and use it directly.

package/bundled/dev-pipeline/templates/sections/test-failure-recovery.md

@@ -1,75 +0,0 @@
-## Test Failure Recovery Protocol
-
-When tests fail during implementation (Phase 3 / Phase 4):
-
-### Immediate Action — Recovery Attempt (Max 2 Rounds)
-
-1. **Analyze failure output**:
-   - Read the test failure message carefully
-   - Identify: root cause (code bug vs. test brittleness vs. environment issue)
-   - Check if baseline already recorded this failure (in BASELINE_FAILURES)
-
-2. **Categorize failure**:
-   - **Pre-existing baseline failure** (expected): Record as acceptable, do NOT fix
-   - **New regression**: Code introduced a bug, fix the code
-   - **Brittle test**: Test passes/fails inconsistently, fix the test or environment
-   - **Environment issue**: Missing dependency, wrong config, fix setup
-
-3. **Fix and re-run** (first round):
-   - Apply fix (code or test, not environment)
-   - Re-run `$TEST_CMD` to verify
-   - If now passing → continue to next task
-   - If still failing → **proceed to Round 2**
-
-4. **Second fix attempt** (second round only):
-   - Re-analyze the failure with fresh perspective
-   - Try alternate fix approach
-   - Re-run `$TEST_CMD`
-   - If still failing after Round 2 → **escalate** (see below)
-
-### Escalation Paths
-
-**Tier 1 (Single Agent)**:
-- After max 2 fix rounds with tests still failing
-- Document failure in Implementation Log with root cause analysis
-- Attempt one manual fix by re-reading related source code
-- If unable to resolve: record PARTIAL status with known failure list
-- **Do NOT block commit**; tests can fail during development (recovery may be deferred to next session)
-
-**Tier 2/3 (Dev + Reviewer)**:
-- After Dev completes max 2 fix rounds with tests still failing
-- Dev appends failure details to Implementation Log
-- Reviewer agent runs full test suite in Phase 5
-- If Reviewer confirms NEW regressions (not in baseline): mark verdict as `NEEDS_FIXES`
-- If Reviewer confirms only baseline failures remain: proceed with `PASS_WITH_WARNINGS`
-
-### Context-Aware Test Re-run (Performance Optimization)
-
-**Skip redundant re-runs**:
-- If Implementation Log section in context-snapshot.md already confirms "all tests passing"
-- → Skip Phase 5 test suite re-run (Reviewer will verify baseline log instead)
-- This avoids rebuilding/re-running tests when already verified
-
-**When to re-run**:
-- If Implementation Log is missing or incomplete
-- If any new code was added after the last test run
-- If Reviewer suspects brittleness or environment drift
-
-### Failure Capture Rules
-
-If tests remain broken after recovery:
-
-```
-## Test Failures Encountered
-
-- **Test**: [test name/path]
-  - Root Cause: [explanation]
-  - Category: [pre-existing baseline | new regression | brittle test | environment]
-  - Fix Attempted: [describe what was tried]
-  - Status: [still failing | requires next session | known limitation]
-
-- **Impact on Feature**: [can AC be verified despite failure | blocks AC verification]
-```
-
-**Rule**: If any AC cannot be verified due to test failure, the feature is incomplete. Document in failure-log.md for next session.
-