prizmkit 1.1.1 → 1.1.4

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

@@ -0,0 +1,358 @@
+#!/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> [refactor-list.json]
+#
+# Examples:
+#   ./retry-refactor.sh R-001
+#   ./retry-refactor.sh R-001 refactor-list.json
+#   SESSION_TIMEOUT=3600 ./retry-refactor.sh R-001
+# ============================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+STATE_DIR="$SCRIPT_DIR/refactor-state"
+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"
+
+# Detect stream-json support
+detect_stream_json_support "$CLI_CMD"
+
+# ============================================================
+# Args
+# ============================================================
+
+if [[ $# -lt 1 ]]; then
+    echo "Usage: $0 <refactor-id> [refactor-list.json]"
+    echo ""
+    echo "  refactor-id           Refactor to retry (e.g. R-001)"
+    echo "  refactor-list.json    Path to refactor list (default: 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:-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")
+
+log_info "Cleaning $REFACTOR_ID artifacts for full restart..."
+python3 "$SCRIPTS_DIR/update-refactor-status.py" \
+    --refactor-list "$REFACTOR_LIST" \
+    --state-dir "$STATE_DIR" \
+    --refactor-id "$REFACTOR_ID" \
+    --project-root "$PROJECT_ROOT" \
+    --action clean >/dev/null 2>&1 || {
+    log_warn "Failed to clean refactor artifacts (continuing with fresh session only)"
+}
+
+# ============================================================
+# 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..."
+python3 "$SCRIPTS_DIR/generate-refactor-prompt.py" \
+    --refactor-list "$REFACTOR_LIST" \
+    --refactor-id "$REFACTOR_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
+
+# ============================================================
+# Run single AI CLI session
+# ============================================================
+
+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)"
+if [[ -n "${MODEL:-}" ]]; then
+    log_info "Model: $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_FLAG=""
+if [[ -n "${MODEL:-}" ]]; then
+    MODEL_FLAG="--model $MODEL"
+fi
+
+unset CLAUDECODE 2>/dev/null || true
+
+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
+    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
+
+# 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/run-bugfix.sh

@@ -224,6 +224,41 @@ spawn_and_wait_session() {
 
     log_info "Session result: $session_status"
 
+    # Validate checkpoint completeness after successful session
+    if [[ "$session_status" == "success" ]]; then
+        local _ckpt_root
+        _ckpt_root="$(cd "$SCRIPT_DIR/.." && pwd)"
+        local checkpoint_file="$_ckpt_root/.prizmkit/bugfix/${bug_id}/workflow-checkpoint.json"
+        if [[ -f "$checkpoint_file" ]]; then
+            local checkpoint_result
+            checkpoint_result=$(python3 -c "
+import json, sys
+try:
+    with open(sys.argv[1]) as f:
+        data = json.load(f)
+except json.JSONDecodeError as e:
+    print('CORRUPTED: {}'.format(e))
+    sys.exit(2)
+incomplete = [s for s in data['steps'] if s['status'] not in ('completed', 'skipped')]
+if incomplete:
+    for s in incomplete:
+        print('INCOMPLETE: {} {} = {}'.format(s['id'], s['skill'], s['status']))
+    sys.exit(1)
+print('ALL_COMPLETE')
+sys.exit(0)
+" "$checkpoint_file" 2>&1)
+            local check_exit=$?
+            if [[ $check_exit -eq 2 ]]; then
+                log_warn "CHECKPOINT_CORRUPTED: workflow-checkpoint.json is not valid JSON"
+            elif [[ $check_exit -eq 1 ]]; then
+                log_warn "CHECKPOINT_INCOMPLETE: Not all workflow steps completed:"
+                echo "$checkpoint_result" | while read -r line; do log_warn "  $line"; done
+            else
+                log_info "CHECKPOINT: All workflow steps completed"
+            fi
+        fi
+    fi
+
     # Subagent detection
     prizm_detect_subagents "$session_log"
 
@@ -237,6 +272,12 @@ spawn_and_wait_session() {
         --max-retries "$max_retries" \
         --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
+
     _SPAWN_RESULT="$session_status"
 }
 

package/bundled/dev-pipeline/{run.sh → run-feature.sh}

@@ -2,17 +2,17 @@
 set -euo pipefail
 
 # ============================================================
-# dev-pipeline/run.sh - Autonomous Dev Pipeline Runner
+# dev-pipeline/run-feature.sh - Autonomous Dev Pipeline Runner
 #
 # Drives the prizm-dev-team multi-agent team through iterative
 # AI CLI sessions (CodeBuddy or Claude Code) to build a complete app
 # from a feature list.
 #
 # Usage:
-#   ./run.sh run [feature-list.json]            Run all features
-#   ./run.sh run <feature-id> [options]         Run a single feature
-#   ./run.sh status [feature-list.json]         Show pipeline status
-#   ./run.sh reset                              Clear all state
+#   ./run-feature.sh run [feature-list.json]            Run all features
+#   ./run-feature.sh run <feature-id> [options]         Run a single feature
+#   ./run-feature.sh status [feature-list.json]         Show pipeline status
+#   ./run-feature.sh reset                              Clear all state
 #
 # Environment Variables:
 #   MAX_RETRIES           Max retries per feature (default: 3)
@@ -116,7 +116,7 @@ spawn_and_wait_session() {
     fi
 
     # Unset CLAUDECODE to prevent "nested session" error when launched from
-    # within an existing Claude Code session (e.g. via launch-daemon.sh).
+    # within an existing Claude Code session (e.g. via launch-feature-daemon.sh).
     unset CLAUDECODE 2>/dev/null || true
 
     case "$CLI_CMD" in
@@ -287,6 +287,39 @@ sys.exit(1)
         if [[ ! -f "$plan_file" ]]; then
             log_warn "ARTIFACT_MISSING: plan.md not found at $plan_file"
         fi
+
+        # Validate checkpoint completeness
+        local checkpoint_file="$project_root_for_artifacts/.prizmkit/specs/${feature_slug}/workflow-checkpoint.json"
+        if [[ -f "$checkpoint_file" ]]; then
+            local checkpoint_result
+            checkpoint_result=$(python3 -c "
+import json, sys
+try:
+    with open(sys.argv[1]) as f:
+        data = json.load(f)
+except json.JSONDecodeError as e:
+    print('CORRUPTED: {}'.format(e))
+    sys.exit(2)
+incomplete = [s for s in data['steps'] if s['status'] not in ('completed', 'skipped')]
+if incomplete:
+    for s in incomplete:
+        print('INCOMPLETE: {} {} = {}'.format(s['id'], s['skill'], s['status']))
+    sys.exit(1)
+print('ALL_COMPLETE')
+sys.exit(0)
+" "$checkpoint_file" 2>&1)
+            local check_exit=$?
+            if [[ $check_exit -eq 2 ]]; then
+                log_warn "CHECKPOINT_CORRUPTED: workflow-checkpoint.json is not valid JSON"
+            elif [[ $check_exit -eq 1 ]]; then
+                log_warn "CHECKPOINT_INCOMPLETE: Not all workflow steps completed:"
+                echo "$checkpoint_result" | while read -r line; do log_warn "  $line"; done
+            else
+                log_info "CHECKPOINT: All workflow steps completed"
+            fi
+        else
+            log_info "CHECKPOINT: No workflow-checkpoint.json found (checkpoint system not active)"
+        fi
     fi
 
     # Check if session produced a failure-log for future retries
@@ -316,8 +349,8 @@ sys.exit(1)
     }
 
     # Commit feature status update (pipeline management commit)
-    if ! git -C "$project_root" diff --quiet feature-list.json 2>/dev/null; then
-        git -C "$project_root" add feature-list.json
+    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
 
@@ -349,7 +382,7 @@ cleanup() {
             --action pause 2>/dev/null || true
     fi
 
-    log_info "Pipeline paused. Run './run.sh run' to resume."
+    log_info "Pipeline paused. Run './run-feature.sh run' to resume."
     exit 130
 }
 trap cleanup SIGINT SIGTERM
@@ -809,8 +842,8 @@ main() {
     # Validate feature list exists
     if [[ ! -f "$feature_list" ]]; then
         log_error "Feature list not found: $feature_list"
-        log_info "Create a feature list first using the app-planner skill,"
-        log_info "or provide a path: ./run.sh run <path-to-feature-list.json>"
+        log_info "Create a feature list first using the feature-planner skill,"
+        log_info "or provide a path: ./run-feature.sh run <path-to-feature-list.json>"
         exit 1
     fi
 
@@ -956,8 +989,8 @@ print(count)
             if [[ "$auto_skipped_count" -gt 0 ]]; then
                 echo ""
                 log_warn "$auto_skipped_count feature(s) were auto-skipped due to failed dependencies."
-                log_warn "Run './run.sh status' to see details."
-                log_warn "Run './run.sh unskip' to reset and retry them."
+                log_warn "Run './run-feature.sh status' to see details."
+                log_warn "Run './run-feature.sh unskip' to reset and retry them."
             fi
 
             break
@@ -965,7 +998,7 @@ print(count)
 
         if [[ "$next_feature" == "PIPELINE_BLOCKED" ]]; then
             log_warn "All remaining features are blocked by dependencies or failed."
-            log_warn "Run './run.sh status' to see details."
+            log_warn "Run './run-feature.sh status' to see details."
             log_warn "Waiting 60s before re-checking... (Ctrl+C to stop)"
             sleep 60
             continue
@@ -1027,12 +1060,12 @@ print(count)
             --output "$bootstrap_prompt"
         )
 
-        # Support PIPELINE_MODE env var (set by launch-daemon.sh --mode)
+        # Support PIPELINE_MODE env var (set by launch-feature-daemon.sh --mode)
         if [[ -n "${PIPELINE_MODE:-}" ]]; then
             main_prompt_args+=(--mode "$PIPELINE_MODE")
         fi
 
-        # Support ENABLE_CRITIC env var (set by launch-daemon.sh --critic)
+        # Support ENABLE_CRITIC env var (set by launch-feature-daemon.sh --critic)
         if [[ "${ENABLE_CRITIC:-}" == "true" || "${ENABLE_CRITIC:-}" == "1" ]]; then
             main_prompt_args+=(--critic "true")
         elif [[ "${ENABLE_CRITIC:-}" == "false" || "${ENABLE_CRITIC:-}" == "0" ]]; then
@@ -1154,18 +1187,18 @@ show_help() {
     echo "  ENABLE_CRITIC         Enable critic review for all features: true|false"
     echo ""
     echo "Examples:"
-    echo "  ./run.sh run                                         # Run all features"
-    echo "  ./run.sh run --features F-001,F-003,F-005             # Run specific features"
-    echo "  ./run.sh run --features F-001:F-010                   # Run features F-001 through F-010"
-    echo "  ./run.sh run F-007 --dry-run                          # Inspect generated prompt"
-    echo "  ./run.sh run F-007 --dry-run --mode lite               # Test lite mode"
-    echo "  ./run.sh run F-007 --resume-phase 6                    # Skip to implementation"
-    echo "  ./run.sh run F-007 --mode full --timeout 3600          # Full mode, 1h timeout"
-    echo "  ./run.sh run F-007 --clean --mode standard             # Clean + run standard"
-    echo "  ./run.sh status                                        # Show pipeline status"
-    echo "  MAX_RETRIES=5 SESSION_TIMEOUT=7200 ./run.sh run        # Custom config"
-    echo "  MODEL=claude-sonnet-4.6 ./run.sh run                    # Use Sonnet model"
-    echo "  MODEL=claude-haiku-4.5 ./run.sh test-cli                # Test with Haiku"
+    echo "  ./run-feature.sh run                                         # Run all features"
+    echo "  ./run-feature.sh run --features F-001,F-003,F-005             # Run specific features"
+    echo "  ./run-feature.sh run --features F-001:F-010                   # Run features F-001 through F-010"
+    echo "  ./run-feature.sh run F-007 --dry-run                          # Inspect generated prompt"
+    echo "  ./run-feature.sh run F-007 --dry-run --mode lite               # Test lite mode"
+    echo "  ./run-feature.sh run F-007 --resume-phase 6                    # Skip to implementation"
+    echo "  ./run-feature.sh run F-007 --mode full --timeout 3600          # Full mode, 1h timeout"
+    echo "  ./run-feature.sh run F-007 --clean --mode standard             # Clean + run standard"
+    echo "  ./run-feature.sh status                                        # Show pipeline status"
+    echo "  MAX_RETRIES=5 SESSION_TIMEOUT=7200 ./run-feature.sh run        # Custom config"
+    echo "  MODEL=claude-sonnet-4.6 ./run-feature.sh run                    # Use Sonnet model"
+    echo "  MODEL=claude-haiku-4.5 ./run-feature.sh test-cli                # Test with Haiku"
 }
 
 case "${1:-run}" in
@@ -1201,7 +1234,7 @@ case "${1:-run}" in
     status)
         check_dependencies
         if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
-            log_error "No pipeline state found. Run './run.sh run' first."
+            log_error "No pipeline state found. Run './run-feature.sh run' first."
             exit 1
         fi
         python3 "$SCRIPTS_DIR/update-feature-status.py" \
@@ -1270,12 +1303,12 @@ case "${1:-run}" in
     reset)
         log_warn "Resetting pipeline state..."
         rm -rf "$STATE_DIR"
-        log_success "State cleared. Run './run.sh run' to start fresh."
+        log_success "State cleared. Run './run-feature.sh run' to start fresh."
         ;;
     unskip)
         check_dependencies
         if [[ ! -f "$STATE_DIR/pipeline.json" ]]; then
-            log_error "No pipeline state found. Run './run.sh run' first."
+            log_error "No pipeline state found. Run './run-feature.sh run' first."
             exit 1
         fi
         _unskip_feature_list="feature-list.json"