jekyll-theme-zer0 1.8.2 → 1.9.0

data/scripts/install/plan.sh

@@ -0,0 +1,299 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/plan.sh — Build an install spec from inputs
+# =============================================================================
+# Accepts: profile, CLI flags, environment variables, detected platform.
+# Produces: populated SPEC_* globals (see spec.sh for the full list).
+# The three front-ends (flags, tui.sh, ai/wizard.sh) all call plan_build.
+#
+# Provides:
+#   plan_build TARGET_DIR [PROFILE]
+#       Merge layers (profile → env-var overrides → CLI flags → platform
+#       defaults) into SPEC_* globals. Does NOT write any files.
+#
+#   plan_load_profile PROFILE_FILE
+#       Read a templates/profiles/*.yml file into SPEC_* globals
+#       (lower priority than explicit flag overrides).
+#
+#   plan_apply_flags
+#       Copy flag globals (_FLAG_*) set by cli.sh into SPEC_* globals.
+#
+#   plan_apply_platform
+#       Auto-detect SPEC_THEME_SOURCE if not set:
+#         - Docker available → gem
+#         - GitHub Pages mode → remote
+#         - fallback → gem
+#
+#   plan_print [FILE]
+#       Print the spec to stdout or FILE as formatted JSON.
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_PLAN_LIB:-}" ]] && return 0
+_HAS_PLAN_LIB=1
+
+# ---------------------------------------------------------------------------
+# plan_load_profile PROFILE_FILE
+# ---------------------------------------------------------------------------
+plan_load_profile() {
+    local profile_file="$1"
+    [[ -f "$profile_file" ]] || return 0
+
+    # Read scalar fields
+    local val
+    # profile_get_scalar is provided by profile.sh if sourced; fall back to awk
+    _plan_yaml_scalar() {
+        local file="$1" key="$2"
+        awk -v k="$key" '
+            $0 ~ "^[[:space:]]*" k "[[:space:]]*:" {
+                sub("^[[:space:]]*" k "[[:space:]]*:[[:space:]]*", "")
+                sub(/[[:space:]]+#.*$/, "")
+                gsub(/^["'"'"']|["'"'"']$/, "")
+                print; exit
+            }
+        ' "$file"
+    }
+
+    val=$(_plan_yaml_scalar "$profile_file" "profile")
+    [[ -n "$val" ]] && SPEC_PROFILE="$val"
+
+    val=$(_plan_yaml_scalar "$profile_file" "theme_source")
+    [[ -n "$val" ]] && SPEC_THEME_SOURCE="$val"
+
+    val=$(_plan_yaml_scalar "$profile_file" "theme_version")
+    [[ -n "$val" ]] && SPEC_THEME_VERSION="$val"
+
+    val=$(_plan_yaml_scalar "$profile_file" "site_title")
+    [[ -n "$val" ]] && : "${SPEC_SITE_TITLE:=$val}"
+
+    val=$(_plan_yaml_scalar "$profile_file" "site_description")
+    [[ -n "$val" ]] && : "${SPEC_SITE_DESCRIPTION:=$val}"
+
+    val=$(_plan_yaml_scalar "$profile_file" "site_timezone")
+    [[ -n "$val" ]] && : "${SPEC_SITE_TIMEZONE:=$val}"
+
+    val=$(_plan_yaml_scalar "$profile_file" "github_pages_branch")
+    [[ -n "$val" ]] && : "${SPEC_GITHUB_PAGES_BRANCH:=$val}"
+
+    # Tasks list from profile (space-separated after join)
+    local tasks
+    tasks=$(awk '
+        /^[[:space:]]*tasks[[:space:]]*:/ { found=1; next }
+        found && /^[[:space:]]*-[[:space:]]+/ {
+            line=$0; sub(/^[[:space:]]*-[[:space:]]+/, "", line)
+            gsub(/[[:space:]]/, "", line)
+            printf "%s ", line
+        }
+        found && !/^[[:space:]]*-/ && NF { exit }
+    ' "$profile_file" | sed 's/[[:space:]]*$//')
+    [[ -n "$tasks" ]] && SPEC_TASKS="$tasks"
+
+    # Deploy list from profile (accepts `deploy:` or `deploy_targets:`)
+    local deploy
+    deploy=$(awk '
+        /^[[:space:]]*deploy(_targets)?[[:space:]]*:/ { found=1; next }
+        found && /^[[:space:]]*-[[:space:]]+/ {
+            line=$0; sub(/^[[:space:]]*-[[:space:]]+/, "", line)
+            gsub(/[[:space:]]/, "", line)
+            printf "%s ", line
+        }
+        found && !/^[[:space:]]*-/ && NF { exit }
+    ' "$profile_file" | sed 's/[[:space:]]*$//')
+    [[ -n "$deploy" ]] && : "${SPEC_DEPLOY:=$deploy}"
+
+    # Agents list from profile (accepts top-level `agents:` or nested `ai_features.agent_files:`)
+    local agents
+    agents=$(awk '
+        /^[[:space:]]*agents[[:space:]]*:/ { in_agents=1; in_af=0; next }
+        /^[[:space:]]*ai_features[[:space:]]*:/ { in_af_block=1; next }
+        in_af_block && /^[[:space:]]*agent_files[[:space:]]*:/ {
+            in_af=1
+            # Inline flow form: agent_files: [foo, bar]
+            line=$0; sub(/^[^\[]*\[/, "", line); sub(/\].*$/, "", line)
+            gsub(/[[:space:],]+/, " ", line)
+            if (length(line) > 0 && line !~ /^[[:space:]]*$/) printf "%s ", line
+            next
+        }
+        (in_agents || in_af) && /^[[:space:]]*-[[:space:]]+/ {
+            line=$0; sub(/^[[:space:]]*-[[:space:]]+/, "", line)
+            gsub(/[[:space:]]/, "", line)
+            printf "%s ", line
+            next
+        }
+        (in_agents || in_af) && /^[^[:space:]-]/ { in_agents=0; in_af=0 }
+        /^[^[:space:]]/ { in_af_block=0 }
+    ' "$profile_file" | sed 's/[[:space:]]*$//')
+    [[ -n "$agents" ]] && : "${SPEC_AGENTS:=$agents}"
+    return 0
+}
+
+# ---------------------------------------------------------------------------
+# plan_apply_flags — copy _FLAG_* set by cli.sh → SPEC_* (highest priority)
+# ---------------------------------------------------------------------------
+plan_apply_flags() {
+    # Strings — only override when flag was explicitly set (non-empty)
+    [[ -n "${_FLAG_PROFILE:-}" ]]     && SPEC_PROFILE="$_FLAG_PROFILE"
+    [[ -n "${_FLAG_SITE_TITLE:-}" ]]  && SPEC_SITE_TITLE="$_FLAG_SITE_TITLE"
+    [[ -n "${_FLAG_SITE_DESC:-}" ]]   && SPEC_SITE_DESCRIPTION="$_FLAG_SITE_DESC"
+    [[ -n "${_FLAG_SITE_URL:-}" ]]    && SPEC_SITE_URL="$_FLAG_SITE_URL"
+    [[ -n "${_FLAG_SITE_AUTHOR:-}" ]] && SPEC_SITE_AUTHOR="$_FLAG_SITE_AUTHOR"
+    [[ -n "${_FLAG_SITE_EMAIL:-}" ]]  && SPEC_SITE_EMAIL="$_FLAG_SITE_EMAIL"
+    [[ -n "${_FLAG_GITHUB_USER:-}" ]] && SPEC_GITHUB_USER="$_FLAG_GITHUB_USER"
+    [[ -n "${_FLAG_GITHUB_REPO:-}" ]] && SPEC_GITHUB_REPO="$_FLAG_GITHUB_REPO"
+    [[ -n "${_FLAG_THEME_SOURCE:-}" ]] && SPEC_THEME_SOURCE="$_FLAG_THEME_SOURCE"
+    [[ -n "${_FLAG_DEPLOY:-}" ]]      && SPEC_DEPLOY="$_FLAG_DEPLOY"
+    [[ -n "${_FLAG_AGENTS:-}" ]]      && SPEC_AGENTS="$_FLAG_AGENTS"
+    [[ -n "${_FLAG_TASKS:-}" ]]       && SPEC_TASKS="$_FLAG_TASKS"
+
+    # Booleans — flags are set to "1" when present
+    [[ "${_FLAG_DRY_RUN:-0}" == "1" ]]     && SPEC_OPT_DRY_RUN=true
+    [[ "${_FLAG_FORCE:-0}" == "1" ]]        && SPEC_OPT_FORCE=true
+    [[ "${_FLAG_NO_BACKUP:-0}" == "1" ]]    && SPEC_OPT_BACKUP=false
+    [[ "${_FLAG_NON_INTERACTIVE:-0}" == "1" ]] && SPEC_OPT_NON_INTERACTIVE=true
+    [[ "${_FLAG_AUTO_ACCEPT:-0}" == "1" ]]  && SPEC_OPT_AUTO_ACCEPT=true
+    [[ "${_FLAG_SKIP_DOCTOR:-0}" == "1" ]]  && SPEC_OPT_SKIP_DOCTOR=true
+    [[ "${_FLAG_VERBOSE:-0}" == "1" ]]      && SPEC_OPT_VERBOSE=true
+    [[ -n "${_FLAG_OUTPUT:-}" ]]            && SPEC_OPT_OUTPUT="$_FLAG_OUTPUT"
+
+    # Scrape flags — when --scrape URL is given, register the scrape task
+    # so apply.sh runs it (after pages so it can overlay).
+    if [[ -n "${_FLAG_SCRAPE_URL:-}" ]]; then
+        SPEC_SCRAPE_SOURCE_URL="$_FLAG_SCRAPE_URL"
+        [[ -n "${_FLAG_SCRAPE_DEPTH:-}" ]]     && SPEC_SCRAPE_DEPTH="$_FLAG_SCRAPE_DEPTH"
+        [[ -n "${_FLAG_SCRAPE_MAX_PAGES:-}" ]] && SPEC_SCRAPE_MAX_PAGES="$_FLAG_SCRAPE_MAX_PAGES"
+        case " ${SPEC_TASKS:-} " in
+            *" scrape "*) ;;
+            *) SPEC_TASKS="${SPEC_TASKS:-} scrape" ;;
+        esac
+    fi
+    return 0
+}
+
+# ---------------------------------------------------------------------------
+# plan_apply_platform — fill platform-dependent defaults when not set
+# ---------------------------------------------------------------------------
+plan_apply_platform() {
+    # Theme source heuristic
+    if [[ -z "${SPEC_THEME_SOURCE:-}" ]]; then
+        case "${SPEC_PROFILE:-default}" in
+            github-pages) SPEC_THEME_SOURCE="remote" ;;
+            *)            SPEC_THEME_SOURCE="gem"     ;;
+        esac
+    fi
+
+    # Ensure github.repo defaults to REPOSITORY_NAME from env when set
+    if [[ -z "${SPEC_GITHUB_REPO:-}" && -n "${REPOSITORY_NAME:-}" ]]; then
+        SPEC_GITHUB_REPO="$REPOSITORY_NAME"
+    fi
+
+    # Devcontainer task auto-include for github-pages profile
+    if [[ "${SPEC_PROFILE:-}" == "github-pages" && -n "${SPEC_TASKS:-}" ]]; then
+        case "$SPEC_TASKS" in
+            *devcontainer*) ;;
+            *) SPEC_TASKS="$SPEC_TASKS devcontainer" ;;
+        esac
+    fi
+}
+
+# ---------------------------------------------------------------------------
+# plan_build TARGET_DIR [PROFILE]
+# Orchestrates: set target_dir, resolve profile file, load it, apply flags,
+# apply platform defaults.
+# ---------------------------------------------------------------------------
+plan_build() {
+    local target_dir="$1"
+    local profile_hint="${2:-${_FLAG_PROFILE:-default}}"
+
+    # Canonical absolute path
+    case "$target_dir" in
+        /*) ;;
+        *) target_dir="$(pwd)/${target_dir}" ;;
+    esac
+
+    # Seed required fields
+    SPEC_TARGET_DIR="$target_dir"
+    SPEC_PROFILE="${profile_hint}"
+
+    # Set global template variable mirrors used by template.sh
+    SITE_TITLE="${SPEC_SITE_TITLE:-${SITE_TITLE:-My Jekyll Site}}"
+    INSTALL_PROFILE="$SPEC_PROFILE"
+
+    # Locate profile file
+    local profile_file=""
+    if [[ -n "${TEMPLATES_DIR:-}" ]]; then
+        profile_file="${TEMPLATES_DIR}/profiles/${SPEC_PROFILE}.yml"
+        if [[ ! -f "$profile_file" ]]; then
+            log_warning "Profile not found: ${SPEC_PROFILE} — using defaults"
+            profile_file=""
+        fi
+    fi
+
+    # Layer 1: Profile defaults
+    [[ -n "$profile_file" ]] && plan_load_profile "$profile_file"
+
+    # Layer 2: Environment variable overrides (ZER0_SITE_* etc.)
+    [[ -n "${ZER0_SITE_TITLE:-}" ]]  && SPEC_SITE_TITLE="$ZER0_SITE_TITLE"
+    [[ -n "${ZER0_SITE_AUTHOR:-}" ]] && SPEC_SITE_AUTHOR="$ZER0_SITE_AUTHOR"
+    [[ -n "${ZER0_SITE_EMAIL:-}" ]]  && SPEC_SITE_EMAIL="$ZER0_SITE_EMAIL"
+    [[ -n "${ZER0_GITHUB_USER:-}" ]] && SPEC_GITHUB_USER="$ZER0_GITHUB_USER"
+    [[ -n "${ZER0_GITHUB_REPO:-}" ]] && SPEC_GITHUB_REPO="$ZER0_GITHUB_REPO"
+
+    # Layer 3: CLI flags (highest priority)
+    plan_apply_flags
+
+    # Layer 4: Platform defaults
+    plan_apply_platform
+
+    # Ensure tasks list is never empty
+    if [[ -z "${SPEC_TASKS:-}" ]]; then
+        SPEC_TASKS="config gemfile docker pages nav data gitignore readme marker"
+    fi
+
+    # Propagate spec values to template.sh globals
+    SITE_TITLE="${SPEC_SITE_TITLE:-My Jekyll Site}"
+    SITE_DESCRIPTION="${SPEC_SITE_DESCRIPTION:-}"
+    SITE_AUTHOR="${SPEC_SITE_AUTHOR:-}"
+    SITE_EMAIL="${SPEC_SITE_EMAIL:-}"
+    SITE_URL="${SPEC_SITE_URL:-}"
+    SITE_TIMEZONE="${SPEC_SITE_TIMEZONE:-UTC}"
+    SITE_LOCALE="${SPEC_SITE_LOCALE:-en}"
+    GITHUB_USER="${SPEC_GITHUB_USER:-}"
+    GITHUB_REPO="${SPEC_GITHUB_REPO:-}"
+    GITHUB_PAGES_BRANCH="${SPEC_GITHUB_PAGES_BRANCH:-gh-pages}"
+    THEME_SOURCE="${SPEC_THEME_SOURCE:-gem}"
+    REPOSITORY_NAME="${SPEC_GITHUB_REPO:-${REPOSITORY_NAME:-}}"
+
+    export SPEC_TARGET_DIR SPEC_PROFILE SPEC_TASKS SPEC_DEPLOY SPEC_AGENTS \
+        SPEC_SITE_TITLE SPEC_SITE_DESCRIPTION SPEC_SITE_URL \
+        SPEC_SITE_AUTHOR SPEC_SITE_EMAIL SPEC_SITE_TIMEZONE SPEC_SITE_LOCALE \
+        SPEC_GITHUB_USER SPEC_GITHUB_REPO SPEC_GITHUB_PAGES_BRANCH \
+        SPEC_GITHUB_ENABLE_PAGES SPEC_THEME_SOURCE SPEC_THEME_VERSION \
+        SPEC_OPT_DRY_RUN SPEC_OPT_FORCE SPEC_OPT_BACKUP \
+        SPEC_OPT_NON_INTERACTIVE SPEC_OPT_OUTPUT SPEC_OPT_AUTO_ACCEPT \
+        SPEC_OPT_SKIP_DOCTOR SPEC_OPT_VERBOSE \
+        SITE_TITLE SITE_DESCRIPTION SITE_AUTHOR SITE_EMAIL SITE_URL \
+        SITE_TIMEZONE SITE_LOCALE GITHUB_USER GITHUB_REPO \
+        GITHUB_PAGES_BRANCH THEME_SOURCE REPOSITORY_NAME INSTALL_PROFILE
+
+    log_debug "plan_build: target=$SPEC_TARGET_DIR profile=$SPEC_PROFILE tasks='$SPEC_TASKS'"
+}
+
+# ---------------------------------------------------------------------------
+# plan_print [FILE] — print the spec (uses spec_write to a tmp then cat)
+# ---------------------------------------------------------------------------
+plan_print() {
+    local out="${1:-}"
+    # Temporarily disable dry-run so spec_write actually writes
+    local saved_dry="${_FS_DRY_RUN:-0}"
+    _FS_DRY_RUN=0
+    if [[ -n "$out" ]]; then
+        spec_write "$out"
+    else
+        local tmp
+        tmp=$(mktemp /tmp/zer0-plan-XXXXXX.json)
+        spec_write "$tmp"
+        cat "$tmp"
+        rm -f "$tmp"
+    fi
+    _FS_DRY_RUN="$saved_dry"
+}

data/scripts/install/platform.sh

@@ -0,0 +1,122 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/platform.sh — Platform & dependency detection
+# =============================================================================
+# Provides:
+#   platform_detect_os           → Darwin | Linux | CYGWIN | MINGW | unknown
+#   platform_detect_runtime      → macos | linux | wsl | windows | unknown
+#   platform_detect_ruby         → "X.Y.Z" or "none"
+#   platform_ruby_lt_27          → returns 0 (true) when ruby < 2.7
+#   platform_needs_macos_gemfile → returns 0 when macOS + ruby < 2.7
+#   platform_detect_docker       → "yes" | "no"
+#   platform_detect_gh           → "yes" | "no"
+#   platform_detect_git          → "yes" | "no"
+#   platform_detect_jq           → "yes" | "no"
+#   platform_detect_bundler      → "X.Y.Z" or "none"
+#   platform_summary             → emit a JSON-compatible summary object
+#
+# Bash 3.2 compatible. No declare -A. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_PLATFORM_LIB:-}" ]] && return 0
+_HAS_PLATFORM_LIB=1
+
+platform_detect_os() {
+    uname -s 2>/dev/null || echo "unknown"
+}
+
+# Returns: macos | linux | wsl | windows | unknown
+platform_detect_runtime() {
+    if [[ "${PLATFORM:-auto}" != "auto" ]]; then
+        echo "$PLATFORM"
+        return
+    fi
+    if grep -qiE '(microsoft|wsl)' /proc/version 2>/dev/null; then
+        echo "wsl"
+        return
+    fi
+    local os
+    os=$(platform_detect_os)
+    case "$os" in
+        Darwin) echo "macos"   ;;
+        Linux)  echo "linux"   ;;
+        CYGWIN*|MINGW*) echo "windows" ;;
+        *) echo "unknown" ;;
+    esac
+}
+
+# Returns ruby version "X.Y.Z" or "none"
+platform_detect_ruby() {
+    if ! command -v ruby >/dev/null 2>&1; then
+        echo "none"
+        return
+    fi
+    # Wrap in subshell at / to avoid Gemfile.lock interference
+    ( cd / && ruby --version 2>/dev/null ) \
+        | awk '{print $2}' \
+        | sed 's/p[0-9]*//' \
+        | sed 's/-.*//' \
+        | tr -d '\r\n'
+}
+
+# Returns 0 (true) when ruby < 2.7
+platform_ruby_lt_27() {
+    local ver
+    ver=$(platform_detect_ruby)
+    [ "$ver" = "none" ] && return 1
+    awk -v ver="$ver" 'BEGIN {
+        n = split(ver, a, ".")
+        if (n >= 2 && a[1]+0 == 2 && a[2]+0 < 7) exit 0
+        exit 1
+    }'
+}
+
+# Returns 0 when macOS + system ruby < 2.7 (needs special Gemfile caps)
+platform_needs_macos_gemfile() {
+    local os
+    os=$(platform_detect_os)
+    [ "$os" = "Darwin" ] && platform_ruby_lt_27
+}
+
+# Returns "X.Y.Z" or "none"
+platform_detect_bundler() {
+    if ! command -v bundler >/dev/null 2>&1 && ! command -v bundle >/dev/null 2>&1; then
+        echo "none"
+        return
+    fi
+    ( cd / && bundle --version 2>/dev/null ) \
+        | awk '{print $NF}' \
+        | tr -d '\r\n'
+}
+
+platform_detect_docker() {
+    if command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1; then
+        echo "yes"
+    else
+        echo "no"
+    fi
+}
+
+platform_detect_gh() {
+    command -v gh >/dev/null 2>&1 && echo "yes" || echo "no"
+}
+
+platform_detect_git() {
+    command -v git >/dev/null 2>&1 && echo "yes" || echo "no"
+}
+
+platform_detect_jq() {
+    command -v jq >/dev/null 2>&1 && echo "yes" || echo "no"
+}
+
+# Emit a compact single-line summary of detected platform (JSON-compatible)
+platform_summary() {
+    printf '{"os":"%s","runtime":"%s","ruby":"%s","bundler":"%s","docker":"%s","gh":"%s","git":"%s","jq":"%s"}\n' \
+        "$(platform_detect_os)" \
+        "$(platform_detect_runtime)" \
+        "$(platform_detect_ruby)" \
+        "$(platform_detect_bundler)" \
+        "$(platform_detect_docker)" \
+        "$(platform_detect_gh)" \
+        "$(platform_detect_git)" \
+        "$(platform_detect_jq)"
+}

data/scripts/install/prompt.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/prompt.sh — Interactive TTY prompts
+# =============================================================================
+# Provides:
+#   prompt_ask     VAR_NAME QUESTION [DEFAULT]
+#       Read a string answer into VAR_NAME. Prints default in brackets.
+#       Returns default if user enters blank.
+#       No-ops (uses DEFAULT) when _PROMPT_NON_INTERACTIVE=1.
+#
+#   prompt_confirm QUESTION [DEFAULT_Y]
+#       Ask a y/N question. Returns 0 for yes, 1 for no.
+#       DEFAULT_Y="y" makes the default yes.
+#       No-ops returning yes when _PROMPT_AUTO_ACCEPT=1.
+#
+#   prompt_select  VAR_NAME QUESTION OPTION1 [OPTION2 ...]
+#       Present a numbered menu. Sets VAR_NAME to chosen option.
+#       No-ops (uses first option) when _PROMPT_NON_INTERACTIVE=1.
+#
+# Globals:
+#   _PROMPT_NON_INTERACTIVE  — "1" → never read, use defaults
+#   _PROMPT_AUTO_ACCEPT      — "1" → confirm always returns yes
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_PROMPT_LIB:-}" ]] && return 0
+_HAS_PROMPT_LIB=1
+
+_PROMPT_NON_INTERACTIVE="${_PROMPT_NON_INTERACTIVE:-0}"
+_PROMPT_AUTO_ACCEPT="${_PROMPT_AUTO_ACCEPT:-0}"
+
+# Prompt for a string value.
+# Usage: prompt_ask VARNAME "Question text" ["default value"]
+prompt_ask() {
+    local _var_name="$1"
+    local _question="$2"
+    local _default="${3:-}"
+    local _answer=""
+
+    if [[ "${_PROMPT_NON_INTERACTIVE:-0}" == "1" ]]; then
+        # Non-interactive: use default or fail if required
+        if [[ -z "$_default" ]]; then
+            log_error "prompt_ask: required value '$_var_name' has no default in non-interactive mode"
+            return 1
+        fi
+        _answer="$_default"
+    else
+        if [[ -n "$_default" ]]; then
+            printf "${_LOG_BLUE:-}?${_LOG_NC:-} %s [%s]: " "$_question" "$_default" >&2
+        else
+            printf "${_LOG_BLUE:-}?${_LOG_NC:-} %s: " "$_question" >&2
+        fi
+        read -r _answer </dev/tty
+        _answer="${_answer:-$_default}"
+    fi
+
+    # Assign to the named variable (bash 3.2 compatible — no nameref)
+    eval "${_var_name}=\$_answer"
+}
+
+# Ask a yes/no confirmation.
+# Usage: prompt_confirm "Question?" ["y"|"n"]  → returns 0=yes 1=no
+prompt_confirm() {
+    local _question="$1"
+    local _default="${2:-n}"
+
+    if [[ "${_PROMPT_AUTO_ACCEPT:-0}" == "1" || "${_PROMPT_NON_INTERACTIVE:-0}" == "1" ]]; then
+        return 0
+    fi
+
+    local _prompt
+    if [[ "$_default" == "y" || "$_default" == "Y" ]]; then
+        _prompt="[Y/n]"
+    else
+        _prompt="[y/N]"
+    fi
+
+    local _answer=""
+    printf "${_LOG_BLUE:-}?${_LOG_NC:-} %s %s: " "$_question" "$_prompt" >&2
+    read -r _answer </dev/tty
+    _answer="${_answer:-$_default}"
+
+    case "$_answer" in
+        [yY][eE][sS]|[yY]) return 0 ;;
+        *)                  return 1 ;;
+    esac
+}
+
+# Present a numbered menu.
+# Usage: prompt_select VARNAME "Question?" opt1 opt2 opt3
+prompt_select() {
+    local _var_name="$1"
+    local _question="$2"
+    shift 2
+    local _options=("$@")
+    local _count=${#_options[@]}
+
+    if [[ "${_PROMPT_NON_INTERACTIVE:-0}" == "1" ]]; then
+        eval "${_var_name}=\${_options[0]}"
+        return 0
+    fi
+
+    printf "${_LOG_BLUE:-}?${_LOG_NC:-} %s\n" "$_question" >&2
+    local _i=1
+    while [[ $_i -le $_count ]]; do
+        printf "  %d) %s\n" "$_i" "${_options[$(( _i - 1 ))]}" >&2
+        _i=$(( _i + 1 ))
+    done
+
+    local _choice=""
+    while true; do
+        printf "  Enter 1-%d [1]: " "$_count" >&2
+        read -r _choice </dev/tty
+        _choice="${_choice:-1}"
+        if [[ "$_choice" =~ ^[0-9]+$ ]] && \
+           [[ "$_choice" -ge 1 ]] && \
+           [[ "$_choice" -le "$_count" ]]; then
+            break
+        fi
+        printf "  Invalid choice. Try again.\n" >&2
+    done
+
+    eval "${_var_name}=\${_options[$(( _choice - 1 ))]}"
+}

data/scripts/install/repair.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/repair.sh — Re-apply spec to fix drift
+# =============================================================================
+# Compares spec intent against disk state (diff.sh), then re-applies
+# only the tasks whose output files are missing or changed.
+#
+# Provides:
+#   repair_run TARGET_DIR
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_REPAIR_LIB:-}" ]] && return 0
+_HAS_REPAIR_LIB=1
+
+repair_run() {
+    local target="${1:-$(pwd)}"
+    local spec_file
+    spec_file="$(spec_path "$target")"
+
+    if [[ ! -f "$spec_file" ]]; then
+        log_error "repair: no spec found at $spec_file"
+        return 1
+    fi
+
+    log_info "Checking for drift at: $target"
+
+    # Run diff (non-destructive) — prints what needs repair
+    diff_spec "$spec_file"
+    local diff_ret=$?
+
+    if [[ $diff_ret -eq 0 ]]; then
+        log_success "No drift detected — nothing to repair."
+        return 0
+    fi
+
+    log_info "Drift detected. Re-applying spec..."
+    spec_read "$spec_file"
+
+    # Force-rewrite everything to fix drift
+    _FS_FORCE=1
+    export _FS_FORCE
+
+    apply_run "$spec_file"
+}