prizmkit 1.1.10 → 1.1.12

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

@@ -1,445 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# ============================================================
-# dev-pipeline/retry-feature.sh - Retry a single failed feature
-#
-# Runs exactly ONE AI CLI session for the specified feature, then exits.
-# Use this to manually retry a failed feature without restarting
-# the full pipeline.
-#
-# Usage:
-#   ./retry-feature.sh <feature-id> [.prizmkit/plans/feature-list.json]
-#
-# Examples:
-#   ./retry-feature.sh F-007
-#   ./retry-feature.sh F-007 .prizmkit/plans/feature-list.json
-#   SESSION_TIMEOUT=3600 ./retry-feature.sh F-007  # with 1h timeout
-# ============================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-STATE_DIR="${PROJECT_ROOT}/.prizmkit/state/features"
-SCRIPTS_DIR="$SCRIPT_DIR/scripts"
-
-SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}
-HEARTBEAT_INTERVAL=${HEARTBEAT_INTERVAL:-30}
-
-# 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"
-
-# Branch tracking
-_ORIGINAL_BRANCH=""
-_DEV_BRANCH_NAME=""
-AUTO_PUSH=${AUTO_PUSH:-0}
-
-# ============================================================
-# Args
-# ============================================================
-
-if [[ $# -lt 1 ]]; then
-    echo "Usage: $0 <feature-id> [.prizmkit/plans/feature-list.json]"
-    echo ""
-    echo "  feature-id          Feature to retry (e.g. F-007)"
-    echo "  feature-list.json   Path to feature list (default: .prizmkit/plans/feature-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)"
-    exit 1
-fi
-
-FEATURE_ID="$1"
-FEATURE_LIST="${2:-.prizmkit/plans/feature-list.json}"
-
-# Resolve absolute path
-if [[ ! "$FEATURE_LIST" = /* ]]; then
-    FEATURE_LIST="$(pwd)/$FEATURE_LIST"
-fi
-
-# ============================================================
-# Validation
-# ============================================================
-
-if [[ ! -f "$FEATURE_LIST" ]]; then
-    log_error "Feature list not found: $FEATURE_LIST"
-    exit 1
-fi
-
-if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
-    log_error "No pipeline state found. Run './run-feature.sh run' first to initialize."
-    exit 1
-fi
-
-if ! command -v jq &>/dev/null; then
-    log_error "jq is required. Install with: brew install jq"
-    exit 1
-fi
-
-# Verify feature exists in feature list
-FEATURE_TITLE=$(python3 -c "
-import json, sys
-with open('$FEATURE_LIST') as f:
-    data = json.load(f)
-for feat in data.get('features', []):
-    if feat.get('id') == '$FEATURE_ID':
-        print(feat.get('title', ''))
-        sys.exit(0)
-sys.exit(1)
-" 2>/dev/null) || {
-    log_error "Feature $FEATURE_ID not found in $FEATURE_LIST"
-    exit 1
-}
-
-# ============================================================
-# Clean feature 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")
-_ORIGINAL_BRANCH="$ORIGINAL_BRANCH"
-FEATURE_SLUG=$(FEATURE_ID="$FEATURE_ID" FEATURE_TITLE="$FEATURE_TITLE" python3 -c "
-import os, re
-fid = os.environ['FEATURE_ID'].replace('F-', '').replace('f-', '').zfill(3)
-title = os.environ.get('FEATURE_TITLE', '').lower()
-title = re.sub(r'[^a-z0-9\s-]', '', title)
-title = re.sub(r'[\s]+', '-', title.strip())
-title = re.sub(r'-+', '-', title).strip('-') or 'feature'
-print(f'{fid}-{title}')
-" 2>/dev/null)
-
-log_info "Reading retry state for $FEATURE_ID..."
-RETRY_COUNT=$(python3 -c "
-import json, os
-status_path = os.path.join('$STATE_DIR', 'features', '$FEATURE_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', 'features', '$FEATURE_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="${FEATURE_ID}-$(date +%Y%m%d%H%M%S)"
-SESSION_DIR="$STATE_DIR/features/$FEATURE_ID/sessions/$SESSION_ID"
-mkdir -p "$SESSION_DIR/logs"
-
-BOOTSTRAP_PROMPT="$SESSION_DIR/bootstrap-prompt.md"
-
-log_info "Generating bootstrap prompt..."
-GEN_ARGS=(
-    --feature-list "$FEATURE_LIST"
-    --feature-id "$FEATURE_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-bootstrap-prompt.py" "${GEN_ARGS[@]}" 2>/dev/null) || {
-    log_error "Failed to generate bootstrap prompt"
-    exit 1
-}
-FEATURE_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
-# ============================================================
-
-echo ""
-echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
-echo -e "${BOLD}  Retry: $FEATURE_ID — $FEATURE_TITLE${NC}"
-echo -e "${BOLD}════════════════════════════════════════════════════${NC}"
-log_info "CLI: $CLI_CMD (platform: $PLATFORM)"
-EFFECTIVE_MODEL="${FEATURE_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 ""
-
-# Create per-feature dev branch (consistent with run-feature.sh behavior)
-_feature_branch="${DEV_BRANCH:-dev/${FEATURE_ID}-retry-$(date +%Y%m%d%H%M)}"
-if branch_create "$PROJECT_ROOT" "$_feature_branch" "$_ORIGINAL_BRANCH"; then
-    _DEV_BRANCH_NAME="$_feature_branch"
-    log_info "Dev branch: $_feature_branch"
-else
-    log_warn "Failed to create dev branch; running on current branch"
-fi
-
-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
-
-# Mark feature as in-progress before spawning session
-python3 "$SCRIPTS_DIR/update-feature-status.py" \
-    --feature-list "$FEATURE_LIST" \
-    --state-dir "$STATE_DIR" \
-    --feature-id "$FEATURE_ID" \
-    --action start >/dev/null 2>&1 || true
-
-# Spawn AI CLI session
-# Spawn AI CLI session — model priority: feature.model > $MODEL env > none
-EFFECTIVE_MODEL="${FEATURE_MODEL:-${MODEL:-}}"
-MODEL_FLAG=""
-if [[ -n "$EFFECTIVE_MODEL" ]]; then
-    MODEL_FLAG="--model $EFFECTIVE_MODEL"
-    log_info "Model: $EFFECTIVE_MODEL"
-fi
-
-unset CLAUDECODE 2>/dev/null || true
-
-# Log bootstrap prompt in test mode
-prizm_log_bootstrap_prompt "$BOOTSTRAP_PROMPT" "$FEATURE_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
-CBC_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 (only if SESSION_TIMEOUT > 0)
-WATCHER_PID=""
-if [[ $SESSION_TIMEOUT -gt 0 ]]; then
-    ( sleep "$SESSION_TIMEOUT" && kill -TERM "$CBC_PID" 2>/dev/null ) &
-    WATCHER_PID=$!
-fi
-
-# Heartbeat
-start_heartbeat "$CBC_PID" "$SESSION_LOG" "$PROGRESS_JSON" "$HEARTBEAT_INTERVAL"
-HEARTBEAT_PID="${_HEARTBEAT_PID:-}"
-
-# Ctrl+C cleanup
-cleanup() {
-    echo ""
-    log_warn "Interrupted. Killing session..."
-    kill "$CBC_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 "$CBC_PID" 2>/dev/null || true
-    [[ -n "$WATCHER_PID" ]] && wait "$WATCHER_PID" 2>/dev/null || true
-    log_info "Session log: $SESSION_LOG"
-    exit 130
-}
-trap cleanup SIGINT SIGTERM
-
-# Wait
-EXIT_CODE=0
-if wait "$CBC_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($FEATURE_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($FEATURE_ID): include remaining session artifacts" 2>/dev/null \
-                || true
-        fi
-    fi
-fi
-
-# ── Propagate completion notes for dependency context ─────────────────
-if [[ "$SESSION_STATUS" == "success" && -n "$FEATURE_SLUG" ]]; then
-    SUMMARY_PATH="$PROJECT_ROOT/.prizmkit/specs/$FEATURE_SLUG/completion-summary.json"
-    if [[ -f "$SUMMARY_PATH" ]]; then
-        python3 "$SCRIPTS_DIR/patch-completion-notes.py" \
-            --feature-list "$FEATURE_LIST" \
-            --feature-id "$FEATURE_ID" \
-            --summary "$SUMMARY_PATH" >/dev/null 2>&1 && {
-            log_info "Propagated completion notes for $FEATURE_ID"
-        } || {
-            log_warn "Failed to propagate completion notes for $FEATURE_ID"
-        }
-    fi
-fi
-
-# Update feature status
-python3 "$SCRIPTS_DIR/update-feature-status.py" \
-    --feature-list "$FEATURE_LIST" \
-    --state-dir "$STATE_DIR" \
-    --feature-id "$FEATURE_ID" \
-    --session-status "$SESSION_STATUS" \
-    --session-id "$SESSION_ID" \
-    --max-retries 999 \
-    --action update >/dev/null 2>&1 || true
-
-# Commit feature-list.json status update (pipeline management commit)
-if ! git -C "$PROJECT_ROOT" diff --quiet "$FEATURE_LIST" 2>/dev/null; then
-    git -C "$PROJECT_ROOT" add "$FEATURE_LIST"
-    git -C "$PROJECT_ROOT" commit --no-verify -m "chore($FEATURE_ID): update feature status" 2>/dev/null || true
-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
-elif [[ -n "$_DEV_BRANCH_NAME" ]]; then
-    # Session failed — return to original branch, preserve dev branch for inspection
-    git -C "$PROJECT_ROOT" checkout "$_ORIGINAL_BRANCH" 2>/dev/null || true
-    log_warn "Session failed — dev branch preserved for inspection: $_DEV_BRANCH_NAME"
-    _DEV_BRANCH_NAME=""
-fi
-
-echo ""
-if [[ "$SESSION_STATUS" == "success" ]]; then
-    log_success "════════════════════════════════════════════════════"
-    log_success "  $FEATURE_ID completed successfully!"
-    log_success "════════════════════════════════════════════════════"
-else
-    log_error "════════════════════════════════════════════════════"
-    log_error "  $FEATURE_ID result: $SESSION_STATUS"
-    log_error "  Review log: $SESSION_LOG"
-    log_error "════════════════════════════════════════════════════"
-fi