prizmkit 1.1.99 → 1.1.101

package/bundled/dev-pipeline/lib/common.sh

@@ -1,1257 +0,0 @@
-#!/usr/bin/env bash
-# ============================================================
-# dev-pipeline/lib/common.sh - Shared shell helpers
-#
-# Shared by feature and bugfix pipeline runners.
-# Provides:
-#   - CLI/platform detection
-#   - Common color + log helpers
-#   - Common dependency checks
-# ============================================================
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-MAGENTA='\033[0;35m'
-BOLD='\033[1m'
-NC='\033[0m'
-
-log_info()    { echo -e "${BLUE}[INFO]${NC}    $(date '+%Y-%m-%d %H:%M:%S') $*"; }
-log_warn()    { echo -e "${YELLOW}[WARN]${NC}    $(date '+%Y-%m-%d %H:%M:%S') $*"; }
-log_error()   { echo -e "${RED}[ERROR]${NC}   $(date '+%Y-%m-%d %H:%M:%S') $*"; }
-log_success() { echo -e "${GREEN}[SUCCESS]${NC} $(date '+%Y-%m-%d %H:%M:%S') $*"; }
-
-prizm_require_positive_int() {
-    local option_name="$1"
-    local option_value="$2"
-    if [[ ! "$option_value" =~ ^[1-9][0-9]*$ ]]; then
-        log_error "$option_name must be a positive integer: $option_value"
-        exit 1
-    fi
-}
-
-# Ignore temporary git worktrees created under root-level hidden AI tool dirs
-# matching .<tool>/worktree(s), without hiding normal source directories.
-PRIZM_GIT_HIDDEN_TOOL_WORKTREE_EXCLUDES=(
-    ':(top,exclude,glob).*/worktree'
-    ':(top,exclude,glob).*/worktree/**'
-    ':(top,exclude,glob).*/worktrees'
-    ':(top,exclude,glob).*/worktrees/**'
-)
-
-prizm_git_status_safe() {
-    local project_root="$1"
-    git -C "$project_root" status --porcelain -- . \
-        "${PRIZM_GIT_HIDDEN_TOOL_WORKTREE_EXCLUDES[@]}" 2>/dev/null
-}
-
-prizm_git_add_all_safe() {
-    local project_root="$1"
-    git -C "$project_root" add -A -- . \
-        "${PRIZM_GIT_HIDDEN_TOOL_WORKTREE_EXCLUDES[@]}" 2>/dev/null
-}
-
-prizm_git_relative_path() {
-    local project_root="$1"
-    local target_path="$2"
-    python3 - "$project_root" "$target_path" <<'PY' 2>/dev/null || true
-import os
-import sys
-root = os.path.abspath(sys.argv[1])
-target = os.path.abspath(sys.argv[2])
-print(os.path.relpath(target, root).replace(os.sep, "/"))
-PY
-}
-
-prizm_git_status_non_bookkeeping() {
-    local project_root="$1"
-    local state_dir="$2"
-    local list_path="$3"
-
-    local state_rel list_rel
-    state_rel="$(prizm_git_relative_path "$project_root" "$state_dir")"
-    list_rel="$(prizm_git_relative_path "$project_root" "$list_path")"
-
-    local line path
-    while IFS= read -r line; do
-        [[ -n "$line" ]] || continue
-        path="${line:3}"
-        if [[ "$path" == *" -> "* ]]; then
-            path="${path##* -> }"
-        fi
-        path="${path%\"}"
-        path="${path#\"}"
-        path="${path#./}"
-        if [[ -n "$list_rel" && "$path" == "$list_rel" ]]; then
-            continue
-        fi
-        if [[ -n "$state_rel" && ( "$path" == "$state_rel" || "$path" == "$state_rel/"* ) ]]; then
-            continue
-        fi
-        printf '%s\n' "$line"
-    done < <(prizm_git_status_safe "$project_root")
-}
-
-prizm_git_status_bookkeeping() {
-    local project_root="$1"
-    local state_dir="$2"
-    local list_path="$3"
-
-    local state_rel list_rel
-    state_rel="$(prizm_git_relative_path "$project_root" "$state_dir")"
-    list_rel="$(prizm_git_relative_path "$project_root" "$list_path")"
-
-    local line path
-    while IFS= read -r line; do
-        [[ -n "$line" ]] || continue
-        path="${line:3}"
-        if [[ "$path" == *" -> "* ]]; then
-            path="${path##* -> }"
-        fi
-        path="${path%\"}"
-        path="${path#\"}"
-        path="${path#./}"
-        if [[ -n "$list_rel" && "$path" == "$list_rel" ]]; then
-            printf '%s\n' "$line"
-            continue
-        fi
-        if [[ -n "$state_rel" && ( "$path" == "$state_rel" || "$path" == "$state_rel/"* ) ]]; then
-            printf '%s\n' "$line"
-        fi
-    done < <(prizm_git_status_safe "$project_root")
-}
-
-prizm_git_commit_paths() {
-    local project_root="$1"
-    local message="$2"
-    shift 2
-
-    local paths=()
-    local path rel_path
-    for path in "$@"; do
-        [[ -n "$path" && -e "$path" ]] || continue
-        rel_path="$(prizm_git_relative_path "$project_root" "$path")"
-        [[ -n "$rel_path" ]] || continue
-        paths+=("$rel_path")
-    done
-    [[ ${#paths[@]} -gt 0 ]] || return 0
-
-    git -C "$project_root" add -- "${paths[@]}" 2>/dev/null || true
-    if ! git -C "$project_root" diff --cached --quiet -- "${paths[@]}" 2>/dev/null; then
-        git -C "$project_root" commit --no-verify -m "$message" -- "${paths[@]}" 2>/dev/null || true
-    fi
-}
-
-
-# ============================================================
-# Path resolution (single source of truth)
-# ============================================================
-# Exports three directories used throughout dev-pipeline scripts:
-#   PIPELINE_DIR  — directory containing the dev-pipeline scripts
-#   PRIZMKIT_DIR  — the .prizmkit/ runtime directory
-#   PROJECT_ROOT  — the user's project root
-#
-# Layout detection (no override case):
-#   - If PIPELINE_DIR's parent is named ".prizmkit" → user-install layout
-#       (.prizmkit/dev-pipeline/). PRIZMKIT_DIR = parent.
-#   - Otherwise → framework repo source (<repo>/dev-pipeline/).
-#       PROJECT_ROOT = parent, PRIZMKIT_DIR = <repo>/.prizmkit.
-#
-# Callers (tests) may pre-set any of these env vars to override detection.
-if [[ -z "${PIPELINE_DIR:-}" ]]; then
-    PIPELINE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-fi
-if [[ -z "${PRIZMKIT_DIR:-}" || -z "${PROJECT_ROOT:-}" ]]; then
-    _pipeline_parent="$(dirname "$PIPELINE_DIR")"
-    if [[ "$(basename "$_pipeline_parent")" == ".prizmkit" ]]; then
-        : "${PRIZMKIT_DIR:=$_pipeline_parent}"
-        : "${PROJECT_ROOT:=$(dirname "$_pipeline_parent")}"
-    else
-        : "${PROJECT_ROOT:=$_pipeline_parent}"
-        : "${PRIZMKIT_DIR:=$PROJECT_ROOT/.prizmkit}"
-    fi
-    unset _pipeline_parent
-fi
-export PIPELINE_DIR PRIZMKIT_DIR PROJECT_ROOT
-
-# ============================================================
-# .env file loading
-# ============================================================
-
-# Load .env file if it exists. Does NOT override already-set env vars.
-# Supports: KEY=VALUE, KEY="VALUE", KEY='VALUE', comments (#), empty lines.
-# If the file does not exist, silently continues (no error).
-prizm_load_env() {
-    local env_file="${1:-.env}"
-    [[ -f "$env_file" ]] || return 0
-
-    while IFS= read -r line || [[ -n "$line" ]]; do
-        # Skip empty lines and comments
-        [[ -z "$line" || "$line" =~ ^[[:space:]]*# ]] && continue
-        # Remove inline comments (not inside quotes)
-        line="${line%%#*}"
-        # Trim whitespace
-        line="$(echo "$line" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
-        [[ -z "$line" ]] && continue
-        # Parse KEY=VALUE
-        if [[ "$line" =~ ^([A-Za-z_][A-Za-z0-9_]*)=(.*)$ ]]; then
-            local key="${BASH_REMATCH[1]}"
-            local val="${BASH_REMATCH[2]}"
-            # Strip surrounding quotes
-            val="${val#\"}" ; val="${val%\"}"
-            val="${val#\'}" ; val="${val%\'}"
-            # Only set if not already defined in environment
-            if [[ -z "${!key+x}" ]]; then
-                export "$key=$val"
-            fi
-        fi
-    done < "$env_file"
-}
-
-# ============================================================
-# Test mode: bootstrap prompt logging
-# ============================================================
-
-# Log bootstrap prompt content when PRIZMKIT_ENV=test.
-# Called after prompt generation, before AI CLI session spawn.
-# Usage: prizm_log_bootstrap_prompt <prompt_path> <item_id>
-prizm_log_bootstrap_prompt() {
-    local prompt_path="$1"
-    local item_id="$2"
-
-    [[ "${PRIZMKIT_ENV:-}" == "test" ]] || return 0
-    [[ -f "$prompt_path" ]] || return 0
-
-    local lines size
-    lines=$(wc -l < "$prompt_path" 2>/dev/null | tr -d ' ')
-    size=$(wc -c < "$prompt_path" 2>/dev/null | tr -d ' ')
-
-    echo ""
-    echo -e "${MAGENTA}[TEST]${NC} ════════════════════════════════════════════════════"
-    echo -e "${MAGENTA}[TEST]${NC} Bootstrap Prompt for $item_id"
-    echo -e "${MAGENTA}[TEST]${NC} Lines: $lines | Size: $((size / 1024))KB"
-    echo -e "${MAGENTA}[TEST]${NC} Path: $prompt_path"
-    echo -e "${MAGENTA}[TEST]${NC} ════════════════════════════════════════════════════"
-    cat "$prompt_path"
-    echo ""
-    echo -e "${MAGENTA}[TEST]${NC} ════════════════════════ END ═══════════════════════"
-    echo ""
-}
-
-# Detect AI CLI + platform.
-# Priority:
-#   AI_CLI env > .prizmkit/config.json ai_cli > manifest/config platform > CODEBUDDY_CLI
-#   > installed PrizmKit platform artifacts > PATH auto-detect > error
-#
-# Exports:
-#   CLI_CMD
-#   PLATFORM
-#   PRIZMKIT_PLATFORM
-_prizm_json_value() {
-    local json_file="$1"
-    local key="$2"
-    [[ -f "$json_file" ]] || return 0
-    JSON_FILE="$json_file" JSON_KEY="$key" python3 - <<'PY' 2>/dev/null || true
-import json
-import os
-
-try:
-    with open(os.environ["JSON_FILE"], encoding="utf-8") as fh:
-        data = json.load(fh)
-    value = data.get(os.environ["JSON_KEY"], "")
-    if value is not None and value != "":
-        print(value)
-except Exception:
-    pass
-PY
-}
-
-_prizm_normalize_platform() {
-    printf '%s' "$1" | tr '[:upper:]' '[:lower:]'
-}
-
-_prizm_concrete_platform() {
-    case "$(_prizm_normalize_platform "$1")" in
-        codex|claude|codebuddy) printf '%s\n' "$(_prizm_normalize_platform "$1")" ;;
-    esac
-}
-
-_prizm_cli_names_for_platform() {
-    case "$(_prizm_normalize_platform "$1")" in
-        codex) printf '%s\n' codex ;;
-        claude) printf '%s\n' claude ;;
-        codebuddy) printf '%s\n' cbc ;;
-        both) printf '%s\n' claude cbc ;;
-        all) printf '%s\n' codex claude cbc ;;
-    esac
-}
-
-_prizm_expected_cli_text() {
-    _prizm_cli_names_for_platform "$1" | awk 'BEGIN { sep="" } { printf "%s%s", sep, $0; sep=", " } END { if (sep != "") print "" }'
-}
-
-_prizm_resolve_cli_name() {
-    local cli_name="$1"
-    if [[ "$cli_name" == "cbc" && -n "${CODEBUDDY_CLI:-}" ]]; then
-        printf '%s\n' "$CODEBUDDY_CLI"
-        return 0
-    fi
-    if command -v "$cli_name" &>/dev/null; then
-        printf '%s\n' "$cli_name"
-        return 0
-    fi
-    return 1
-}
-
-_prizm_cli_for_platform() {
-    local platform="$1"
-    local cli_name cli_cmd
-    while IFS= read -r cli_name; do
-        [[ -n "$cli_name" ]] || continue
-        cli_cmd="$(_prizm_resolve_cli_name "$cli_name" || true)"
-        if [[ -n "$cli_cmd" ]]; then
-            printf '%s\n' "$cli_cmd"
-            return 0
-        fi
-    done < <(_prizm_cli_names_for_platform "$platform")
-    return 1
-}
-
-_prizm_known_platform_from_cli() {
-    local cli_cmd="$1"
-    local cli_token="${cli_cmd%%[[:space:]]*}"
-    cli_token="${cli_token#\"}" ; cli_token="${cli_token%\"}"
-    cli_token="${cli_token#\'}" ; cli_token="${cli_token%\'}"
-    local cli_name="${cli_token##*/}"
-    if [[ "$cli_name" == *"claude"* ]]; then
-        printf '%s\n' claude
-    elif [[ "$cli_name" == *"codex"* ]]; then
-        printf '%s\n' codex
-    elif [[ "$cli_name" == *"cbc"* || "$cli_name" == *"codebuddy"* ]]; then
-        printf '%s\n' codebuddy
-    else
-        return 1
-    fi
-}
-
-_prizm_platform_from_cli() {
-    local cli_cmd="$1"
-    if ! _prizm_known_platform_from_cli "$cli_cmd"; then
-        printf '%s\n' codebuddy
-    fi
-}
-
-_prizm_session_platform() {
-    local cli_platform
-    cli_platform="$(_prizm_known_platform_from_cli "$CLI_CMD" || true)"
-    if [[ -n "$cli_platform" ]]; then
-        printf '%s\n' "$cli_platform"
-        return 0
-    fi
-
-    local platform="${PRIZMKIT_PLATFORM:-${PLATFORM:-}}"
-    case "$(_prizm_normalize_platform "$platform")" in
-        codex|claude|codebuddy) printf '%s\n' "$(_prizm_normalize_platform "$platform")" ;;
-        *) _prizm_platform_from_cli "$CLI_CMD" ;;
-    esac
-}
-
-_prizm_project_platform_for_cli() {
-    local cli_cmd="$1"
-    local manifest_platform="$2"
-    local config_platform="$3"
-    local cli_platform
-    cli_platform="$(_prizm_known_platform_from_cli "$cli_cmd" || true)"
-    if [[ -n "$cli_platform" ]]; then
-        printf '%s\n' "$cli_platform"
-    elif [[ -n "${PRIZMKIT_PLATFORM:-}" ]]; then
-        printf '%s\n' "$PRIZMKIT_PLATFORM"
-    elif [[ -n "$(_prizm_concrete_platform "$manifest_platform")" ]]; then
-        _prizm_concrete_platform "$manifest_platform"
-    elif [[ -n "$(_prizm_concrete_platform "$config_platform")" ]]; then
-        _prizm_concrete_platform "$config_platform"
-    else
-        printf '%s\n' codebuddy
-    fi
-}
-
-prizm_detect_cli_and_platform() {
-    # Load .env from .prizmkit/.env if it exists (does not override existing env vars)
-    if [[ -n "${PRIZMKIT_DIR:-}" ]]; then
-        prizm_load_env "$PRIZMKIT_DIR/.env"
-    fi
-
-    local _raw_cli=""
-    local _config_ai_cli=""
-    local _config_platform=""
-    local _manifest_platform=""
-    local _installed_cli=""
-    local _platform_cli=""
-    local _platform_cli_names=""
-
-    if [[ -n "${PRIZMKIT_DIR:-}" ]]; then
-        _config_ai_cli="$(_prizm_json_value "$PRIZMKIT_DIR/config.json" ai_cli)"
-        _config_platform="$(_prizm_json_value "$PRIZMKIT_DIR/config.json" platform)"
-        _manifest_platform="$(_prizm_json_value "$PRIZMKIT_DIR/manifest.json" platform)"
-    fi
-
-    _detect_installed_platform_cli() {
-        if [[ -f "$PROJECT_ROOT/.codex/agents/prizm-dev-team-dev.toml" || -f "$PROJECT_ROOT/.agents/skills/prizm-kit/SKILL.md" ]] && command -v codex &>/dev/null; then
-            echo "codex"
-        elif [[ -f "$PROJECT_ROOT/.claude/commands/prizm-kit.md" ]] && command -v claude &>/dev/null; then
-            echo "claude"
-        elif [[ -f "$PROJECT_ROOT/.codebuddy/agents/prizm-dev-team-dev.md" || -f "$PROJECT_ROOT/.codebuddy/skills/prizm-kit/SKILL.md" ]]; then
-            _prizm_resolve_cli_name cbc || true
-        fi
-    }
-
-    if [[ -n "${AI_CLI:-}" ]]; then
-        _raw_cli="$AI_CLI"
-    elif [[ -n "$_config_ai_cli" ]]; then
-        _raw_cli="$_config_ai_cli"
-    elif [[ -n "$_manifest_platform" ]]; then
-        _platform_cli="$(_prizm_cli_for_platform "$_manifest_platform" || true)"
-        _platform_cli_names="$(_prizm_cli_names_for_platform "$_manifest_platform")"
-        if [[ -n "$_platform_cli" ]]; then
-            _raw_cli="$_platform_cli"
-        elif [[ -n "$_platform_cli_names" ]]; then
-            echo "ERROR: Installed PrizmKit platform '$_manifest_platform' requires one of: $(_prizm_expected_cli_text "$_manifest_platform"). Install it or set AI_CLI." >&2
-            exit 1
-        fi
-    elif [[ -n "$_config_platform" ]]; then
-        _platform_cli="$(_prizm_cli_for_platform "$_config_platform" || true)"
-        _platform_cli_names="$(_prizm_cli_names_for_platform "$_config_platform")"
-        if [[ -n "$_platform_cli" ]]; then
-            _raw_cli="$_platform_cli"
-        elif [[ -n "$_platform_cli_names" ]]; then
-            echo "ERROR: Configured PrizmKit platform '$_config_platform' requires one of: $(_prizm_expected_cli_text "$_config_platform"). Install it or set AI_CLI." >&2
-            exit 1
-        fi
-    fi
-
-    if [[ -z "$_raw_cli" && -n "${CODEBUDDY_CLI:-}" ]]; then
-        _raw_cli="$CODEBUDDY_CLI"
-    fi
-    if [[ -z "$_raw_cli" ]]; then
-        _installed_cli="$(_detect_installed_platform_cli || true)"
-        if [[ -n "$_installed_cli" ]]; then
-            _raw_cli="$_installed_cli"
-        fi
-    fi
-    if [[ -z "$_raw_cli" ]] && command -v claude &>/dev/null; then
-        _raw_cli="claude"
-    elif [[ -z "$_raw_cli" ]] && command -v cbc &>/dev/null; then
-        _raw_cli="cbc"
-    elif [[ -z "$_raw_cli" ]] && command -v codex &>/dev/null; then
-        _raw_cli="codex"
-    elif [[ -z "$_raw_cli" ]]; then
-        echo "ERROR: No AI CLI found. Install CodeBuddy (cbc), Claude Code (claude), or Codex (codex)." >&2
-        exit 1
-    fi
-
-    CLI_CMD="$_raw_cli"
-
-    PLATFORM="$(_prizm_project_platform_for_cli "$_raw_cli" "$_manifest_platform" "$_config_platform")"
-
-    export CLI_CMD
-    export PLATFORM
-    export PRIZMKIT_PLATFORM="$PLATFORM"
-}
-
-# Validate PRIZMKIT_EFFORT against the detected platform's supported values.
-# Exits with a friendly error if the value is unsupported.
-prizm_validate_effort() {
-    [[ -n "${PRIZMKIT_EFFORT:-}" ]] || return 0
-
-    local session_platform
-    session_platform="$(_prizm_session_platform)"
-
-    local allowed_values
-    case "$session_platform" in
-        claude)    allowed_values="low, medium, high, xhigh, max" ;;
-        codex)     allowed_values="low, medium, high, xhigh" ;;
-        *)         allowed_values="low, medium, high, xhigh" ;;
-    esac
-
-    local valid=0
-    local val
-    for val in $allowed_values; do
-        val="${val%,}"
-        [[ "$val" == "$PRIZMKIT_EFFORT" ]] && valid=1 && break
-    done
-
-    if [[ "$valid" -ne 1 ]]; then
-        local platform_label="$session_platform"
-        [[ "$session_platform" == "claude" ]] && platform_label="Claude Code"
-        [[ "$session_platform" == "codebuddy" ]] && platform_label="CodeBuddy"
-        [[ "$session_platform" == "codex" ]] && platform_label="Codex"
-
-        log_error "PRIZMKIT_EFFORT='$PRIZMKIT_EFFORT' is not supported by the detected CLI ($platform_label)."
-        log_error "  Supported values for $platform_label: $allowed_values"
-        log_error "  Set PRIZMKIT_EFFORT to one of the above, or unset it to use the CLI default."
-        exit 1
-    fi
-}
-
-# Start an AI CLI session in the background.
-# Usage: prizm_start_ai_session <prompt_path> <log_path> <model>
-# Sets PRIZM_AI_PID to the spawned process PID. Do not call this function via
-# command substitution; the background process must remain a child of the
-# runner shell so wait/heartbeat/trap handling works correctly.
-PRIZM_AI_PID=""
-
-_prizm_codex_subagent_timeout_seconds() {
-    local configured="${CODEX_SUBAGENT_TIMEOUT_SECONDS:-}"
-    if [[ "$configured" =~ ^[0-9]+$ && "$configured" -gt 0 ]]; then
-        printf '%s\n' "$configured"
-        return 0
-    fi
-
-    local wait_threshold="${CODEX_WAIT_STALE_KILL_THRESHOLD:-3600}"
-    if [[ "$wait_threshold" =~ ^[0-9]+$ && "$wait_threshold" -gt 600 ]]; then
-        printf '%s\n' "$((wait_threshold - 300))"
-        return 0
-    fi
-
-    printf '%s\n' 3300
-}
-
-prizm_start_ai_session() {
-    local prompt_path="$1"
-    local log_path="$2"
-    local model="${3:-}"
-
-    unset CLAUDECODE 2>/dev/null || true
-
-    # Create backup outside project tree. Claude Code subagents can unlink
-    # session.log inside the project, but cannot reach $HOME/.prizmkit/.
-    # tee writes to the backup file while >> redirects to the main log.
-    # If the main log gets severed (unlinked+recreated by subagent),
-    # prizm_recover_session_log copies the backup back when the session ends.
-    local backup_dir="$HOME/.prizmkit/session-backups"
-    mkdir -p "$backup_dir"
-    local session_dir
-    session_dir="$(dirname "$(dirname "$log_path")")"
-    local session_id
-    session_id="$(basename "$session_dir")"
-    local backup_log="$backup_dir/${session_id}.log"
-    PRIZM_BACKUP_LOG="$backup_log"
-
-    # Write preamble to both files
-    {
-        echo "=== PRIZMKIT SESSION START ==="
-        echo "Prompt: $prompt_path"
-        echo "Model: ${model:-default}"
-        echo "Started at: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
-        echo "--- OUTPUT BELOW ---"
-    } > "$log_path"
-    cp "$log_path" "$backup_log"
-
-    local session_platform
-    session_platform="$(_prizm_session_platform)"
-
-    case "$session_platform" in
-        claude)
-            local claude_args=(-p "$(cat "$prompt_path")" --dangerously-skip-permissions)
-            if [[ "$VERBOSE" == "1" || "$USE_STREAM_JSON" == "true" ]]; then
-                claude_args+=(--verbose)
-            fi
-            if [[ "$USE_STREAM_JSON" == "true" ]]; then
-                claude_args+=(--output-format stream-json)
-            fi
-            if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
-                claude_args+=(--effort "$PRIZMKIT_EFFORT")
-            fi
-            if [[ -n "$model" ]]; then
-                claude_args+=(--model "$model")
-            fi
-            "$CLI_CMD" "${claude_args[@]}" 2>&1 | tee -a "$backup_log" >> "$log_path" &
-            ;;
-        codex)
-            local codex_args=(--ask-for-approval never --sandbox danger-full-access)
-            local codex_subagent_timeout
-            codex_subagent_timeout="$(_prizm_codex_subagent_timeout_seconds)"
-            if [[ "$codex_subagent_timeout" =~ ^[0-9]+$ && "$codex_subagent_timeout" -gt 0 ]]; then
-                codex_args+=(--config "agents.job_max_runtime_seconds=$codex_subagent_timeout")
-            fi
-            codex_args+=(exec --cd "$PROJECT_ROOT" --skip-git-repo-check)
-            if [[ "$USE_STREAM_JSON" == "true" ]]; then
-                codex_args+=(--json)
-            fi
-            if [[ -n "$model" ]]; then
-                codex_args+=(--model "$model")
-            fi
-            if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
-                codex_args+=(--config "model_reasoning_effort=$PRIZMKIT_EFFORT")
-            fi
-            "$CLI_CMD" "${codex_args[@]}" - < "$prompt_path" 2>&1 | tee -a "$backup_log" >> "$log_path" &
-            ;;
-        *)
-            local cb_args=(--print -y)
-            if [[ "$VERBOSE" == "1" ]]; then
-                cb_args+=(--verbose)
-            fi
-            if [[ "$USE_STREAM_JSON" == "true" ]]; then
-                cb_args+=(--output-format stream-json)
-            fi
-            if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
-                cb_args+=(--effort "$PRIZMKIT_EFFORT")
-            fi
-            if [[ -n "$model" ]]; then
-                cb_args+=(--model "$model")
-            fi
-            "$CLI_CMD" "${cb_args[@]}" < "$prompt_path" 2>&1 | tee -a "$backup_log" >> "$log_path" &
-            ;;
-    esac
-    PRIZM_AI_PID=$!
-}
-
-# Detect AI CLI/provider infrastructure failures that are outside the
-# generated code's control. These should be retried without consuming the
-# item's code retry budget.
-prizm_detect_infra_error() {
-    local session_log="${1:-}"
-    local progress_json="${2:-}"
-
-    local haystack=""
-    if [[ -n "$session_log" && -f "$session_log" ]]; then
-        haystack="$(tail -c 65536 "$session_log" 2>/dev/null || true)"
-    fi
-    if [[ -n "$progress_json" && -f "$progress_json" ]]; then
-        haystack+=$'\n'
-        haystack+="$(cat "$progress_json" 2>/dev/null || true)"
-    fi
-
-    [[ -n "$haystack" ]] || return 1
-
-    if printf '%s' "$haystack" | grep -Eiq \
-        'auth_unavailable|no auth available|502 Bad Gateway|503 Service Unavailable|504 Gateway Timeout|gateway timeout|upstream (connect )?error|connection reset|ECONNRESET|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|rate limit|rate_limit|temporarily unavailable|overloaded'; then
-        return 0
-    fi
-
-    return 1
-}
-
-# Detect AI runtime/provider request failures that are not caused by generated
-# project code. Unlike generic infra errors, these can be deterministic for the
-# current transcript (for example context_too_large), so the runner must first
-# check semantic completion before deciding whether to retry.
-prizm_detect_ai_runtime_error() {
-    local session_log="${1:-}"
-    local progress_json="${2:-}"
-
-    if [[ -n "$progress_json" && -f "$progress_json" ]]; then
-        local fatal_error_code
-        fatal_error_code=$(python3 - "$progress_json" <<'PY' 2>/dev/null || true
-import json
-import sys
-
-try:
-    with open(sys.argv[1], encoding="utf-8") as fh:
-        progress = json.load(fh)
-except Exception:
-    raise SystemExit(0)
-
-code = progress.get("fatal_error_code")
-if code:
-    print(str(code))
-PY
-)
-        if [[ -n "$fatal_error_code" ]]; then
-            return 0
-        fi
-    fi
-
-    local haystack=""
-    if [[ -n "$session_log" && -f "$session_log" ]]; then
-        haystack="$(tail -c 65536 "$session_log" 2>/dev/null || true)"
-    fi
-    if [[ -n "$progress_json" && -f "$progress_json" ]]; then
-        haystack+=$'\n'
-        haystack+="$(cat "$progress_json" 2>/dev/null || true)"
-    fi
-
-    [[ -n "$haystack" ]] || return 1
-
-    if printf '%s' "$haystack" | grep -Eiq \
-        'context_too_large|model_context_window_exceeded|input exceeds the context window|context window of this model|context window (was )?exceeded|exceeded (the )?context window|invalid_request_error.*context window|context window.*invalid_request_error'; then
-        if printf '%s' "$haystack" | grep -Eiq \
-            'api error|invalid_request_error|api_error_status|api_error_code|status[[:space:]]*[:=]?[[:space:]]*(400|413)|last_result_is_error[[:space:]"'\'':=]+true|is_error[[:space:]"'\'':=]+true'; then
-            return 0
-        fi
-    fi
-
-    return 1
-}
-
-prizm_feature_slug_from_list() {
-    local feature_list="$1"
-    local feature_id="$2"
-    python3 - "$feature_list" "$feature_id" <<'PY'
-import json
-import re
-import sys
-
-feature_list, feature_id = sys.argv[1], sys.argv[2]
-with open(feature_list, encoding="utf-8") as fh:
-    data = json.load(fh)
-for feature in data.get("features", []):
-    if feature.get("id") == feature_id:
-        number = feature.get("id", "").replace("F-", "").replace("f-", "").zfill(3)
-        title = str(feature.get("title", "")).lower()
-        title = re.sub(r"[^a-z0-9\s-]", "", title)
-        title = re.sub(r"[\s]+", "-", title.strip())
-        title = re.sub(r"-+", "-", title).strip("-")
-        print(f"{number}-{title}" if title else number)
-        raise SystemExit(0)
-raise SystemExit(1)
-PY
-}
-
-prizm_checkpoint_all_complete() {
-    local checkpoint_file="$1"
-    [[ -f "$checkpoint_file" ]] || return 1
-    python3 - "$checkpoint_file" <<'PY'
-import json
-import sys
-
-try:
-    with open(sys.argv[1], encoding="utf-8") as fh:
-        data = json.load(fh)
-except Exception:
-    raise SystemExit(2)
-steps = data.get("steps")
-if not isinstance(steps, list) or not steps:
-    raise SystemExit(1)
-for step in steps:
-    if not isinstance(step, dict) or step.get("status") not in ("completed", "skipped"):
-        raise SystemExit(1)
-raise SystemExit(0)
-PY
-}
-
-# Return the successful feature commit SHA if one exists in base_ref..HEAD.
-# Prefer messages containing the feature ID. If checkpoint is complete, allow an
-# older prompt variant only when the non-WIP commit identifies the feature title.
-prizm_find_feature_commit() {
-    local project_root="$1"
-    local base_ref="$2"
-    local feature_id="$3"
-    local allow_title_fallback="${4:-false}"
-    local feature_title="${5:-}"
-
-    git -C "$project_root" rev-parse --is-inside-work-tree >/dev/null 2>&1 || return 1
-
-    local range="${base_ref}..HEAD"
-    if [[ -z "$base_ref" ]] || ! git -C "$project_root" rev-parse --verify "$base_ref" >/dev/null 2>&1; then
-        range="HEAD"
-    fi
-
-    local feature_commit
-    feature_commit=$(git -C "$project_root" log "$range" --format='%H%x09%s' 2>/dev/null \
-        | awk -F '\t' -v fid="$feature_id" 'index($2, fid) > 0 && $2 !~ /^wip(\(|:)/ { print $1; exit }')
-    if [[ -n "$feature_commit" ]]; then
-        printf '%s\n' "$feature_commit"
-        return 0
-    fi
-
-    if [[ "$allow_title_fallback" == "true" && -n "$feature_title" ]]; then
-        feature_commit=$(git -C "$project_root" log "$range" --format='%H%x09%s' 2>/dev/null \
-            | python3 -c '
-import re
-import sys
-
-title = sys.argv[1]
-
-def words(text):
-    return [w for w in re.split(r"[^a-z0-9]+", text.lower()) if len(w) >= 3]
-
-title_words = words(title)
-if not title_words:
-    raise SystemExit(1)
-# Require all title words for short titles, or a strong majority for longer
-# titles so punctuation/articles do not make older commits unmatchable.
-required = len(title_words) if len(title_words) <= 3 else max(3, int(len(title_words) * 0.75 + 0.999))
-for line in sys.stdin:
-    commit, sep, subject = line.rstrip("\n").partition("\t")
-    if not sep or re.match(r"^wip(\(|:)", subject):
-        continue
-    subject_words = set(words(subject))
-    if sum(1 for word in title_words if word in subject_words) >= required:
-        print(commit)
-        raise SystemExit(0)
-raise SystemExit(1)
-' "$feature_title")
-        if [[ -n "$feature_commit" ]]; then
-            printf '%s\n' "$feature_commit"
-            return 0
-        fi
-    fi
-
-    return 1
-}
-
-# Semantic completion means the durable workflow checkpoint is complete and a
-# non-WIP feature commit exists. This intentionally runs before exit-code based
-# failure classification so delayed post-commit model errors cannot strand a
-# completed feature on its dev branch.
-PRIZM_SEMANTIC_FEATURE_SLUG=""
-PRIZM_SEMANTIC_COMMIT_SHA=""
-prizm_feature_semantically_complete() {
-    local feature_list="$1"
-    local feature_id="$2"
-    local project_root="$3"
-    local base_ref="$4"
-    local prizmkit_dir="$5"
-
-    PRIZM_SEMANTIC_FEATURE_SLUG=""
-    PRIZM_SEMANTIC_COMMIT_SHA=""
-
-    local feature_slug
-    feature_slug=$(prizm_feature_slug_from_list "$feature_list" "$feature_id" 2>/dev/null) || return 1
-    local checkpoint_file="$prizmkit_dir/specs/${feature_slug}/workflow-checkpoint.json"
-    prizm_checkpoint_all_complete "$checkpoint_file" || return 1
-
-    local feature_title
-    feature_title=$(python3 - "$feature_list" "$feature_id" <<'PY' 2>/dev/null || true
-import json
-import sys
-with open(sys.argv[1], encoding="utf-8") as fh:
-    data = json.load(fh)
-for feature in data.get("features", []):
-    if feature.get("id") == sys.argv[2]:
-        print(feature.get("title", ""))
-        break
-PY
-)
-
-    local commit_sha
-    commit_sha=$(prizm_find_feature_commit "$project_root" "$base_ref" "$feature_id" true "$feature_title" 2>/dev/null) || return 1
-
-    PRIZM_SEMANTIC_FEATURE_SLUG="$feature_slug"
-    PRIZM_SEMANTIC_COMMIT_SHA="$commit_sha"
-    return 0
-}
-
-prizm_synthesize_failure_log() {
-    local failure_log="$1"
-    local feature_id="$2"
-    local session_id="$3"
-    local session_status="$4"
-    local exit_code="$5"
-    local stale_kill_marker="$6"
-    local progress_json="$7"
-    local checkpoint_file="$8"
-    local project_root="$9"
-    local base_ref="${10:-}"
-
-    [[ -n "$failure_log" ]] || return 0
-    [[ -f "$failure_log" ]] && return 0
-    mkdir -p "$(dirname "$failure_log")" || return 0
-
-    local progress_summary="Progress data unavailable."
-    if [[ -f "$progress_json" ]]; then
-        progress_summary=$(python3 - "$progress_json" <<'PY' 2>/dev/null || true
-import json
-import sys
-try:
-    with open(sys.argv[1], encoding="utf-8") as fh:
-        data = json.load(fh)
-except Exception as exc:
-    print(f"Progress parse error: {exc}")
-    raise SystemExit(0)
-fields = [
-    ("fatal_error_code", data.get("fatal_error_code")),
-    ("api_error_status", data.get("api_error_status")),
-    ("api_error_code", data.get("api_error_code")),
-    ("current_phase", data.get("current_phase")),
-    ("current_tool", data.get("current_tool")),
-    ("last_text_snippet", data.get("last_text_snippet")),
-    ("terminal_result_text", data.get("terminal_result_text")),
-]
-for key, value in fields:
-    if value not in (None, "", []):
-        text = str(value).replace("\n", " ")
-        print(f"- {key}: {text[:500]}")
-PY
-)
-        [[ -n "$progress_summary" ]] || progress_summary="Progress data contained no terminal fields."
-    fi
-
-    local stale_summary="No stale-kill marker."
-    if [[ -f "$stale_kill_marker" ]]; then
-        stale_summary="$(cat "$stale_kill_marker" 2>/dev/null || true)"
-    fi
-
-    local checkpoint_summary="No checkpoint file found."
-    if [[ -f "$checkpoint_file" ]]; then
-        checkpoint_summary=$(python3 - "$checkpoint_file" <<'PY' 2>/dev/null || true
-import json
-import sys
-try:
-    with open(sys.argv[1], encoding="utf-8") as fh:
-        data = json.load(fh)
-except Exception as exc:
-    print(f"Checkpoint parse error: {exc}")
-    raise SystemExit(0)
-steps = data.get("steps") or []
-complete = sum(1 for step in steps if isinstance(step, dict) and step.get("status") in ("completed", "skipped"))
-print(f"{complete}/{len(steps)} steps completed_or_skipped")
-for step in steps:
-    if isinstance(step, dict) and step.get("status") not in ("completed", "skipped"):
-        print(f"- incomplete: {step.get('id')} {step.get('skill')} = {step.get('status')}")
-PY
-)
-    fi
-
-    local latest_commit="unavailable"
-    local feature_commit="no"
-    if git -C "$project_root" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-        latest_commit=$(git -C "$project_root" rev-parse --short HEAD 2>/dev/null || echo unavailable)
-        if prizm_find_feature_commit "$project_root" "$base_ref" "$feature_id" false >/dev/null 2>&1; then
-            feature_commit="yes"
-        fi
-    fi
-
-    local dirty_summary="unavailable"
-    dirty_summary=$(git -C "$project_root" status --short 2>/dev/null || true)
-    [[ -n "$dirty_summary" ]] || dirty_summary="clean"
-
-    cat > "$failure_log" <<EOF
-# Runtime-synthesized failure log
-
-## Session
-
-- feature_id: $feature_id
-- session_id: ${session_id:-unknown}
-- session_status: $session_status
-- exit_code: $exit_code
-
-## Stale kill marker
-
-\`\`\`json
-$stale_summary
-\`\`\`
-
-## Progress
-
-$progress_summary
-
-## Checkpoint
-
-$checkpoint_summary
-
-## Git state
-
-- feature_commit_exists: $feature_commit
-- latest_commit: $latest_commit
-
-\`\`\`text
-$dirty_summary
-\`\`\`
-
-## Recommended recovery action
-
-- If this is an AI runtime/provider error before checkpoint completion, retry the session with a fresh context.
-- If the working tree is dirty, preserve or review those changes before any reset or merge.
-EOF
-}
-
-prizm_extract_update_new_status() {
-    python3 -c "
-import json, sys
-raw = sys.stdin.read()
-try:
-    data = json.loads(raw)
-except Exception:
-    sys.exit(0)
-value = data.get('new_status')
-if value:
-    print(value)
-"
-}
-
-# Run an AI CLI session synchronously.
-# Usage: prizm_run_ai_session <prompt_path> <log_path> <model>
-prizm_run_ai_session() {
-    local prompt_path="$1"
-    local log_path="$2"
-    local model="${3:-}"
-
-    unset CLAUDECODE 2>/dev/null || true
-
-    # Create backup outside project tree (same rationale as prizm_start_ai_session)
-    local backup_dir="$HOME/.prizmkit/session-backups"
-    mkdir -p "$backup_dir"
-    local session_dir
-    session_dir="$(dirname "$(dirname "$log_path")")"
-    local session_id
-    session_id="$(basename "$session_dir")"
-    local backup_log="$backup_dir/${session_id}.log"
-    PRIZM_BACKUP_LOG="$backup_log"
-
-    # Write preamble to both files
-    {
-        echo "=== PRIZMKIT SESSION START ==="
-        echo "Prompt: $prompt_path"
-        echo "Model: ${model:-default}"
-        echo "Started at: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
-        echo "--- OUTPUT BELOW ---"
-    } > "$log_path"
-    cp "$log_path" "$backup_log"
-
-    local session_platform
-    session_platform="$(_prizm_session_platform)"
-
-    case "$session_platform" in
-        claude)
-            local claude_args=(-p "$(cat "$prompt_path")" --dangerously-skip-permissions)
-            if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
-                claude_args+=(--effort "$PRIZMKIT_EFFORT")
-            fi
-            if [[ -n "$model" ]]; then
-                claude_args+=(--model "$model")
-            fi
-            "$CLI_CMD" "${claude_args[@]}" 2>&1 | tee -a "$backup_log" >> "$log_path"
-            ;;
-        codex)
-            local codex_args=(--ask-for-approval never --sandbox danger-full-access)
-            local codex_subagent_timeout
-            codex_subagent_timeout="$(_prizm_codex_subagent_timeout_seconds)"
-            if [[ "$codex_subagent_timeout" =~ ^[0-9]+$ && "$codex_subagent_timeout" -gt 0 ]]; then
-                codex_args+=(--config "agents.job_max_runtime_seconds=$codex_subagent_timeout")
-            fi
-            codex_args+=(exec --cd "$PROJECT_ROOT" --skip-git-repo-check)
-            if [[ "$USE_STREAM_JSON" == "true" ]]; then
-                codex_args+=(--json)
-            fi
-            if [[ -n "$model" ]]; then
-                codex_args+=(--model "$model")
-            fi
-            if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
-                codex_args+=(--config "model_reasoning_effort=$PRIZMKIT_EFFORT")
-            fi
-            "$CLI_CMD" "${codex_args[@]}" - < "$prompt_path" 2>&1 | tee -a "$backup_log" >> "$log_path"
-            ;;
-        *)
-            local cb_args=(--print -y)
-            if [[ -n "${PRIZMKIT_EFFORT:-}" ]]; then
-                cb_args+=(--effort "$PRIZMKIT_EFFORT")
-            fi
-            if [[ -n "$model" ]]; then
-                cb_args+=(--model "$model")
-            fi
-            "$CLI_CMD" "${cb_args[@]}" < "$prompt_path" 2>&1 | tee -a "$backup_log" >> "$log_path"
-            ;;
-    esac
-}
-
-# Recover session log from backup if the main log was truncated during execution.
-# Claude Code subagents can unlink session.log at the filesystem level. The backup
-# lives in $HOME/.prizmkit/ — outside the project tree — so it survives.
-#
-# Must be called AFTER the AI CLI process exits and BEFORE the session summary
-# reads session.log. Uses PRIZM_BACKUP_LOG set by prizm_start_ai_session /
-# prizm_run_ai_session.
-prizm_recover_session_log() {
-    local session_log="${1:-}"
-    local backup_log="${PRIZM_BACKUP_LOG:-}"
-
-    if [[ -z "$backup_log" || ! -f "$backup_log" ]]; then
-        return 0
-    fi
-
-    local main_size=0
-    if [[ -f "$session_log" ]]; then
-        main_size=$(wc -c < "$session_log" 2>/dev/null | tr -d ' ') || true
-    fi
-
-    local backup_size=0
-    backup_size=$(wc -c < "$backup_log" 2>/dev/null | tr -d ' ') || true
-
-    if [[ "$main_size" -lt 1024 && "$backup_size" -gt "$main_size" ]]; then
-        # Ensure parent directory exists before copying (subagent may have
-        # deleted it along with session.log).
-        local log_dir
-        log_dir="$(dirname "$session_log")"
-        mkdir -p "$log_dir" 2>/dev/null || true
-        if cp "$backup_log" "$session_log" 2>/dev/null; then
-            log_info "Session log recovered from backup (${backup_size}B → $session_log)"
-        else
-            log_warn "Session log recovery failed: could not copy backup to $session_log"
-        fi
-    fi
-
-    # Clean up backup either way (rm is safe even with set -e)
-    rm -f "$backup_log" 2>/dev/null || true
-    return 0
-}
-
-# prizm_detect_subagents <session_log>
-#
-# Scan session log for subagent spawns, count them, and log the result.
-# Sets _SUBAGENT_COUNT to the number of Agent tool calls detected.
-# Requires: USE_STREAM_JSON (from detect_stream_json_support)
-_SUBAGENT_COUNT=0
-prizm_detect_subagents() {
-    local session_log="$1"
-    _SUBAGENT_COUNT=0
-    [[ -f "$session_log" ]] || return 0
-
-    local count=0
-    if [[ "$USE_STREAM_JSON" == "true" && "${STREAM_JSON_FORMAT:-}" == "codex-json" ]]; then
-        count=$(grep -c '"tool"[[:space:]]*:[[:space:]]*"spawn_agent"' "$session_log" 2>/dev/null) || true
-    elif [[ "$USE_STREAM_JSON" == "true" ]]; then
-        count=$(grep -c '"name"[[:space:]]*:[[:space:]]*"Agent"' "$session_log" 2>/dev/null) || true
-    else
-        count=$(grep -cE '(Tool: Agent|"tool":\s*"Agent"|"tool":\s*"spawn_agent"|tool_use.*Agent|subagent_type|collab: SpawnAgent)' "$session_log" 2>/dev/null) || true
-    fi
-
-    count=${count:-0}
-    _SUBAGENT_COUNT=$count
-    if [[ "$count" -gt 0 ]]; then
-        log_info "Subagent calls detected in session: $count"
-    else
-        log_info "Subagent calls detected in session: 0 (single-agent mode)"
-    fi
-}
-
-# Common dependency check (jq + python3 + optional CLI in PATH)
-# Args:
-#   $1 - cli command (optional)
-prizm_check_common_dependencies() {
-    local cli_cmd="${1:-}"
-
-    if ! command -v jq &>/dev/null; then
-        log_error "jq is required but not installed. Install with: brew install jq"
-        exit 1
-    fi
-
-    if ! command -v python3 &>/dev/null; then
-        log_error "python3 is required but not installed."
-        exit 1
-    fi
-
-    if [[ -n "$cli_cmd" ]] && ! command -v "$cli_cmd" &>/dev/null; then
-        log_warn "AI CLI '$cli_cmd' not found in PATH."
-        log_warn "Set AI_CLI environment variable to the correct command."
-        log_warn "Continuing anyway (will fail when spawning sessions)..."
-    fi
-}
-
-# Ensure git is installed and a given directory is a git repository.
-# If git is missing, attempt auto-install; on failure print instructions and exit.
-# If not inside a git repo, run git init + initial commit automatically.
-#
-# Usage: prizm_ensure_git_repo [directory]
-#   directory — path to check/initialize (defaults to current working directory)
-prizm_ensure_git_repo() {
-    local target_dir="${1:-.}"
-
-    # --- helper: run a command with a timeout (macOS-compatible) ---
-    # Uses GNU timeout / gtimeout if available, otherwise a background+kill fallback.
-    _run_with_timeout() {
-        local secs="$1"; shift
-        if command -v timeout &>/dev/null; then
-            timeout "$secs" "$@"
-        elif command -v gtimeout &>/dev/null; then
-            gtimeout "$secs" "$@"
-        else
-            # background + kill fallback
-            "$@" &
-            local pid=$!
-            ( sleep "$secs" && kill "$pid" 2>/dev/null ) &
-            local watchdog=$!
-            if wait "$pid" 2>/dev/null; then
-                kill "$watchdog" 2>/dev/null; wait "$watchdog" 2>/dev/null
-                return 0
-            else
-                kill "$watchdog" 2>/dev/null; wait "$watchdog" 2>/dev/null
-                return 1
-            fi
-        fi
-    }
-
-    if ! command -v git &>/dev/null; then
-        log_warn "git is not installed. Attempting automatic installation..."
-        local _install_ok=false
-        case "$(uname -s)" in
-            Darwin)
-                if command -v brew &>/dev/null; then
-                    log_info "Installing git via Homebrew..."
-                    if _run_with_timeout 120 brew install git &>/dev/null; then
-                        _install_ok=true
-                    fi
-                else
-                    # xcode-select --install opens a GUI dialog that cannot be automated;
-                    # skip auto-install and fall through to manual instructions.
-                    log_info "Homebrew not found; cannot auto-install git on macOS."
-                fi
-                ;;
-            Linux)
-                # Verify passwordless sudo is available (daemon/CI safety)
-                if ! sudo -n true 2>/dev/null; then
-                    log_info "sudo requires a password; cannot auto-install git."
-                elif command -v apt-get &>/dev/null; then
-                    log_info "Installing git via apt-get..."
-                    _run_with_timeout 120 sudo apt-get update -y &>/dev/null
-                    if _run_with_timeout 120 sudo apt-get install -y git &>/dev/null; then
-                        _install_ok=true
-                    fi
-                elif command -v yum &>/dev/null; then
-                    log_info "Installing git via yum..."
-                    if _run_with_timeout 120 sudo yum install -y git &>/dev/null; then
-                        _install_ok=true
-                    fi
-                elif command -v dnf &>/dev/null; then
-                    log_info "Installing git via dnf..."
-                    if _run_with_timeout 120 sudo dnf install -y git &>/dev/null; then
-                        _install_ok=true
-                    fi
-                elif command -v pacman &>/dev/null; then
-                    log_info "Installing git via pacman..."
-                    if _run_with_timeout 120 sudo pacman -S --noconfirm git &>/dev/null; then
-                        _install_ok=true
-                    fi
-                fi
-                ;;
-        esac
-
-        if $_install_ok && command -v git &>/dev/null; then
-            log_success "git installed successfully ($(git --version))."
-        else
-            log_error "Automatic git installation failed or timed out."
-            log_error "Please install git manually:"
-            log_error "  macOS:   brew install git   or   xcode-select --install"
-            log_error "  Ubuntu:  sudo apt-get install git"
-            log_error "  CentOS:  sudo yum install git"
-            log_error "  Windows: https://git-scm.com/download/win"
-            exit 1
-        fi
-    fi
-
-    # Validate target directory exists
-    if [[ ! -d "$target_dir" ]]; then
-        log_error "Target directory does not exist: $target_dir"
-        exit 1
-    fi
-
-    if ! git -C "$target_dir" rev-parse --is-inside-work-tree &>/dev/null 2>&1; then
-        log_warn "Directory is not a git repository: $target_dir"
-        log_info "Initializing git repository..."
-        git -C "$target_dir" init -b main
-        log_info "Git repository initialized at: $target_dir"
-        # Create initial commit so branches and diffs work
-        if ! git -C "$target_dir" add -A; then
-            log_error "Failed to stage files in: $target_dir"
-            exit 1
-        fi
-        git -C "$target_dir" commit --no-verify -m "chore: initial commit (auto-created by dev-pipeline)" || {
-            # If nothing to commit (empty project), create an empty initial commit
-            git -C "$target_dir" commit --no-verify --allow-empty -m "chore: initial commit (auto-created by dev-pipeline)"
-        }
-        log_success "Initial commit created — workspace content committed."
-    fi
-}