jekyll-theme-zer0 1.26.0 → 1.28.0

data/scripts/install/cli.sh

@@ -63,6 +63,7 @@ _cli_load_core() {
     _cli_require "fs.sh"
     _cli_require "template.sh"
     _cli_require "prompt.sh"
+    _cli_require "config.sh"
     _cli_require "spec.sh"
     _cli_require "plan.sh"
     _cli_require "apply.sh"
@@ -95,6 +96,9 @@ _cli_parse_flags() {
     _FLAG_AGENTS=""
     _FLAG_TASKS=""
     _FLAG_AI=0
+    _FLAG_AI_PROVIDER=""
+    _FLAG_AI_MODEL=""
+    _FLAG_CONFIG=""
     _FLAG_SPEC=""
     _FLAG_SCRAPE_URL=""
     _FLAG_SCRAPE_DEPTH=""
@@ -111,6 +115,7 @@ _cli_parse_flags() {
            _FLAG_SITE_URL _FLAG_SITE_AUTHOR _FLAG_SITE_EMAIL \
            _FLAG_GITHUB_USER _FLAG_GITHUB_REPO _FLAG_THEME_SOURCE \
            _FLAG_DEPLOY _FLAG_AGENTS _FLAG_TASKS _FLAG_AI _FLAG_SPEC \
+           _FLAG_AI_PROVIDER _FLAG_AI_MODEL _FLAG_CONFIG \
            _FLAG_SCRAPE_URL _FLAG_SCRAPE_DEPTH _FLAG_SCRAPE_MAX_PAGES
 
     while [[ $# -gt 0 ]]; do
@@ -123,6 +128,14 @@ _cli_parse_flags() {
             --skip-doctor)       _FLAG_SKIP_DOCTOR=1 ;;
             --verbose|-v)        _FLAG_VERBOSE=1 ;;
             --ai)                _FLAG_AI=1 ;;
+            --yes|-y)            _FLAG_AUTO_ACCEPT=1 ;;
+            --ai-provider)       shift; _FLAG_AI_PROVIDER="${1:-}" ;;
+            --ai-provider=*)     _FLAG_AI_PROVIDER="${1#--ai-provider=}" ;;
+            --ai-model)          shift; _FLAG_AI_MODEL="${1:-}" ;;
+            --ai-model=*)        _FLAG_AI_MODEL="${1#--ai-model=}" ;;
+            --config)            shift; _FLAG_CONFIG="${1:-}" ;;
+            --config=*)          _FLAG_CONFIG="${1#--config=}" ;;
+            --no-ai)             _FLAG_AI_PROVIDER="none" ;;
             --profile)           shift; _FLAG_PROFILE="${1:-}" ;;
             --profile=*)         _FLAG_PROFILE="${1#--profile=}" ;;
             --output)            shift; _FLAG_OUTPUT="${1:-}" ;;
@@ -241,6 +254,22 @@ _cmd_wizard() {
     fi
 }
 
+_cmd_suggest() {
+    # install suggest [TARGET_DIR] [GOAL...]
+    #   Recommends a profile + deploy target from an optional goal description.
+    #   Uses the resolved AI provider; falls back to rule-based defaults.
+    local target="${_CLI_POS_0:-$(pwd)}"
+    local goal="${_CLI_POS_1:-}"
+    local sug="${_CLI_DIR}/ai/suggest.sh"
+    if [[ ! -f "$sug" ]]; then
+        log_error "suggest: module not available: $sug"
+        return 1
+    fi
+    # shellcheck source=/dev/null
+    source "$sug"
+    ai_suggest_run "$target" "$goal"
+}
+
 _cmd_agents() {
     local target="${_CLI_TARGET:-$(pwd)}"
     local spec_file
@@ -299,8 +328,12 @@ _cmd_deploy() {
     fi
 
     # Caller explicitly asked for this deploy target — override spec defaults.
+    # Deploy is deploy-only: no base tasks and no agent rewrites (use
+    # `install agents` for those). SPEC_TASKS="" now serialises to [] rather
+    # than falling back to the full default list (which would clobber content).
     SPEC_DEPLOY="$target_name"
-    SPEC_TASKS=""   # only run deploy plugins
+    SPEC_TASKS=""
+    SPEC_AGENTS=""
 
     spec_write "$spec_file"
     apply_run "$spec_file"
@@ -460,9 +493,10 @@ Usage:
 Subcommands:
   init           Install from flags + profile (default)
   wizard         Interactive wizard (--ai for AI-driven spec)
+  suggest        Recommend a profile + deploy target (AI or rule-based)
   agents         Install AI agent files only
   deploy         Configure deployment plugin(s)
-  doctor         Run pre-install health checks
+  doctor         Run pre-install health checks (incl. AI provider status)
   scrape         Crawl an existing site into ./.zer0/scrape (no install)
   diagnose       Diagnose an existing install (--ai for suggestions)
   upgrade        Re-apply spec to an existing install
@@ -494,7 +528,12 @@ Global options:
   --skip-doctor          Skip pre-install health checks
   --verbose, -v          Extra debug output
   --output json|human    Log format (default: human)
+  --yes, -y              Auto-confirm all yes/no prompts (alias of --auto-accept)
+  --config FILE          Load installer settings from a YAML config file
   --ai                   Use AI assistant for wizard/diagnose
+  --ai-provider NAME     AI provider: auto|claude-cli|anthropic|openai|none
+  --ai-model NAME        Override the AI model id for the active provider
+  --no-ai                Disable AI (equivalent to --ai-provider none)
   --spec FILE            Load spec from FILE instead of detecting
   --scrape URL           Import content from URL during init (adds 'scrape' task)
   --scrape-depth N       Max crawl depth (default: 2)
@@ -503,9 +542,12 @@ Global options:
 Examples:
   install init . --profile blog --site-title "My Blog"
   install init ~/mysite --profile github-pages --github-user bamr87
-  install wizard . --ai
+  install wizard . --ai                       # uses Claude Code OAuth if available
+  install wizard . --ai --ai-provider anthropic
+  install suggest . "a docs site for a Rust CLI"
+  install init . --config zer0.install.yml
   install agents . --copilot --claude
-  install doctor .
+  install doctor .                            # includes AI provider status
   install diff .
   install upgrade . --force
   install plan . --profile docs
@@ -537,9 +579,17 @@ cli_main() {
     [[ "$_FLAG_VERBOSE" == "1" ]] && _LOG_VERBOSE=1 && export _LOG_VERBOSE
     [[ -n "$_FLAG_OUTPUT" ]]       && _LOG_OUTPUT="$_FLAG_OUTPUT" && export _LOG_OUTPUT
 
+    # Propagate AI selection + config path to the environment so provider
+    # resolution and config discovery see them regardless of the spec flow
+    # (e.g. `doctor`, `suggest`, `wizard --ai`).
+    [[ -n "$_FLAG_AI_PROVIDER" ]] && export ZER0_AI_PROVIDER="$_FLAG_AI_PROVIDER"
+    [[ -n "$_FLAG_AI_MODEL" ]]    && export ZER0_AI_MODEL="$_FLAG_AI_MODEL"
+    [[ -n "$_FLAG_CONFIG" ]]      && export ZER0_CONFIG="$_FLAG_CONFIG"
+
     case "$subcommand" in
         init)           _cmd_init ;;
         wizard)         _cmd_wizard ;;
+        suggest)        _cmd_suggest ;;
         agents)         _cmd_agents ;;
         deploy)         _cmd_deploy ;;
         doctor)         _cmd_doctor ;;

data/scripts/install/config.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/config.sh — User config-file layer
+# =============================================================================
+# Lets a site persist its installer choices in a small YAML file instead of
+# re-typing flags every run. Discovered files are merged low→high precedence:
+#
+#   1. ~/.config/zer0/install.yml        (user-global defaults)
+#   2. <target>/zer0.install.yml         (project-local)
+#   3. <target>/.zer0/config.yml         (project-local, hidden)
+#   4. $ZER0_CONFIG  /  --config FILE    (explicit — wins over the rest)
+#
+# In the plan pipeline this sits between profile defaults and env/flag
+# overrides:  defaults < profile < CONFIG FILE < env vars < CLI flags.
+#
+# Recognised keys (nested or flat/dotted both work):
+#   profile
+#   site.title|description|author|email|url|timezone|locale
+#   github.user|repo|pages_branch|enable_pages
+#   theme.source|version
+#   deploy            (scalar or list → space-joined)
+#   agents            (scalar or list → space-joined)
+#   tasks             (scalar or list → space-joined)
+#   ai.provider       (auto|claude-cli|anthropic|openai|none)
+#   ai.model
+#
+# API keys are deliberately NOT read from config files — they stay in the
+# environment only (see ai/client.sh).
+#
+# Bash 3.2 compatible. No `declare -A`, no `set -euo pipefail` here.
+# =============================================================================
+[[ -n "${_HAS_CONFIG_LIB:-}" ]] && return 0
+_HAS_CONFIG_LIB=1
+
+# ---------------------------------------------------------------------------
+# config_discover TARGET_DIR → print existing config files, low→high priority.
+# ---------------------------------------------------------------------------
+config_discover() {
+    local target="${1:-$(pwd)}"
+    local f
+    for f in \
+        "${HOME:-/nonexistent}/.config/zer0/install.yml" \
+        "${target}/zer0.install.yml" \
+        "${target}/zer0.install.yaml" \
+        "${target}/.zer0/config.yml" \
+        "${_FLAG_CONFIG:-}" \
+        "${ZER0_CONFIG:-}" ; do
+        [[ -n "$f" && -f "$f" ]] && printf '%s\n' "$f"
+    done
+}
+
+# ---------------------------------------------------------------------------
+# _config_flatten FILE → emit `key=value` for a small YAML subset:
+#   - top-level scalars           foo: bar          → foo=bar
+#   - one level of nested maps     site:\n  title: x → site.title=x
+#   - block lists                  deploy:\n  - a    → deploy=a b
+#   - inline flow lists            deploy: [a, b]    → deploy=a b
+# Quotes and inline comments are stripped. Not a full YAML parser — just
+# enough for installer config, mirroring plan.sh's awk profile reader.
+# ---------------------------------------------------------------------------
+_config_flatten() {
+    local file="$1"
+    [[ -f "$file" ]] || return 0
+    awk '
+        function strip(s) {
+            sub(/[[:space:]]*#.*$/, "", s)               # trailing comment
+            sub(/^[[:space:]]+/, "", s); sub(/[[:space:]]+$/, "", s)
+            gsub(/^["'"'"']|["'"'"']$/, "", s)           # surrounding quotes
+            return s
+        }
+        # blank / comment lines
+        /^[[:space:]]*$/ { next }
+        /^[[:space:]]*#/ { next }
+        {
+            indent = 0
+            tmp = $0
+            while (substr(tmp,1,1) == " ") { indent++; tmp = substr(tmp,2) }
+        }
+        # list item under the current parent key
+        indent > 0 && tmp ~ /^-[[:space:]]+/ {
+            if (listkey != "") {
+                item = tmp; sub(/^-[[:space:]]+/, "", item); item = strip(item)
+                vals[listkey] = (vals[listkey] == "" ? item : vals[listkey] " " item)
+            }
+            next
+        }
+        # key: value  (any depth we care about is 0 or 1)
+        match(tmp, /^[A-Za-z0-9_.-]+[[:space:]]*:/) {
+            key = tmp; sub(/[[:space:]]*:.*$/, "", key)
+            val = tmp; sub(/^[A-Za-z0-9_.-]+[[:space:]]*:/, "", val); val = strip(val)
+
+            if (indent == 0) {
+                parent = key
+                listkey = ""
+                if (val == "") { listkey = key; next }        # map/list header
+                # inline flow list?  key: [a, b, c]
+                if (val ~ /^\[.*\]$/) {
+                    gsub(/^\[|\]$/, "", val); gsub(/[[:space:],]+/, " ", val)
+                    val = strip(val)
+                }
+                print key "=" val
+            } else {
+                # nested child of the last top-level parent
+                if (parent != "") print parent "." key "=" val
+            }
+            next
+        }
+        END {
+            for (k in vals) print k "=" vals[k]
+        }
+    ' "$file"
+}
+
+# ---------------------------------------------------------------------------
+# config_apply_file FILE → map recognised keys onto SPEC_* globals + AI env.
+# ---------------------------------------------------------------------------
+config_apply_file() {
+    local file="$1"
+    [[ -f "$file" ]] || return 0
+    log_debug "config: loading ${file}"
+
+    local line key val
+    while IFS= read -r line; do
+        key="${line%%=*}"
+        val="${line#*=}"
+        [[ -z "$key" || "$key" == "$line" ]] && continue
+        case "$key" in
+            profile)              SPEC_PROFILE="$val" ;;
+            site.title|site_title)             SPEC_SITE_TITLE="$val" ;;
+            site.description|site_description) SPEC_SITE_DESCRIPTION="$val" ;;
+            site.author|site_author)           SPEC_SITE_AUTHOR="$val" ;;
+            site.email|site_email)             SPEC_SITE_EMAIL="$val" ;;
+            site.url|site_url)                 SPEC_SITE_URL="$val" ;;
+            site.timezone|site_timezone)       SPEC_SITE_TIMEZONE="$val" ;;
+            site.locale|site_locale)           SPEC_SITE_LOCALE="$val" ;;
+            github.user|github_user)           SPEC_GITHUB_USER="$val" ;;
+            github.repo|github_repo)           SPEC_GITHUB_REPO="$val" ;;
+            github.pages_branch)               SPEC_GITHUB_PAGES_BRANCH="$val" ;;
+            github.enable_pages)               SPEC_GITHUB_ENABLE_PAGES="$val" ;;
+            theme.source|theme_source)         SPEC_THEME_SOURCE="$val" ;;
+            theme.version|theme_version)       SPEC_THEME_VERSION="$val" ;;
+            deploy|deploy_targets)             SPEC_DEPLOY="$val" ;;
+            agents|agent_files)                SPEC_AGENTS="$val" ;;
+            tasks)                             SPEC_TASKS="$val" ;;
+            ai.provider|ai_provider)
+                SPEC_AI_PROVIDER="$val"
+                export ZER0_AI_PROVIDER="${ZER0_AI_PROVIDER:-$val}" ;;
+            ai.model|ai_model)
+                SPEC_AI_MODEL="$val"
+                export ZER0_AI_MODEL="${ZER0_AI_MODEL:-$val}" ;;
+            *) log_debug "config: ignoring unknown key '${key}'" ;;
+        esac
+    done < <(_config_flatten "$file")
+    return 0
+}
+
+# ---------------------------------------------------------------------------
+# config_load TARGET_DIR → apply every discovered config file in order.
+# ---------------------------------------------------------------------------
+config_load() {
+    local target="${1:-$(pwd)}"
+    local f
+    while IFS= read -r f; do
+        [[ -n "$f" ]] && config_apply_file "$f"
+    done < <(config_discover "$target")
+    return 0
+}

data/scripts/install/doctor.sh

@@ -118,6 +118,43 @@ doctor_check_gh() {
     _doctor_pass "GitHub CLI $ghver"
 }
 
+# ---------------------------------------------------------------------------
+# doctor_check_ai — report which AI provider (if any) will serve wizard/
+# suggest/diagnose. Warn-only: AI is always opt-in and never blocks install.
+# ---------------------------------------------------------------------------
+doctor_check_ai() {
+    if [[ "$(type -t ai_client_provider)" != "function" ]]; then
+        local _d
+        _d="${_CLI_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" 2>/dev/null && pwd)}"
+        [[ -f "${_d}/ai/client.sh" ]] && source "${_d}/ai/client.sh"
+    fi
+    if [[ "$(type -t ai_client_provider)" != "function" ]]; then
+        _doctor_warn "AI: client module unavailable (wizard/suggest/diagnose disabled)"
+        return 0
+    fi
+
+    if [[ "${ZER0_NO_AI:-0}" == "1" ]]; then
+        _doctor_pass "AI: disabled via ZER0_NO_AI (rule-based fallbacks only)"
+        return 0
+    fi
+    case "${ZER0_AI_PROVIDER:-}" in
+        none|off|disabled)
+            _doctor_pass "AI: disabled by choice (rule-based fallbacks only)"
+            return 0 ;;
+    esac
+
+    local provider
+    provider="$(ai_client_provider)"
+    if [[ "$provider" == "none" ]] || ! ai_client_available; then
+        _doctor_warn "AI: no provider available — install the 'claude' CLI (Claude Code OAuth), or set CLAUDE_CODE_OAUTH_TOKEN / ANTHROPIC_API_KEY / OPENAI_API_KEY"
+        return 0
+    fi
+
+    local model
+    model="$(ai_client_model "$provider")"
+    _doctor_pass "AI: ${provider} via $(ai_client_auth_source)${model:+ (model ${model})}"
+}
+
 # ---------------------------------------------------------------------------
 # doctor_check_writable TARGET_DIR
 # ---------------------------------------------------------------------------
@@ -155,6 +192,7 @@ doctor_run() {
     doctor_check_docker
     doctor_check_git      || failures=$(( failures + 1 ))
     doctor_check_gh
+    doctor_check_ai
     [[ -n "$target" ]] && { doctor_check_writable "$target" || failures=$(( failures + 1 )); }
 
     if [[ $failures -eq 0 ]]; then

data/scripts/install/plan.sh

@@ -144,6 +144,8 @@ plan_apply_flags() {
     [[ -n "${_FLAG_DEPLOY:-}" ]]      && SPEC_DEPLOY="$_FLAG_DEPLOY"
     [[ -n "${_FLAG_AGENTS:-}" ]]      && SPEC_AGENTS="$_FLAG_AGENTS"
     [[ -n "${_FLAG_TASKS:-}" ]]       && SPEC_TASKS="$_FLAG_TASKS"
+    [[ -n "${_FLAG_AI_PROVIDER:-}" ]] && SPEC_AI_PROVIDER="$_FLAG_AI_PROVIDER"
+    [[ -n "${_FLAG_AI_MODEL:-}" ]]    && SPEC_AI_MODEL="$_FLAG_AI_MODEL"
 
     # Booleans — flags are set to "1" when present
     [[ "${_FLAG_DRY_RUN:-0}" == "1" ]]     && SPEC_OPT_DRY_RUN=true
@@ -231,12 +233,19 @@ plan_build() {
     # Layer 1: Profile defaults
     [[ -n "$profile_file" ]] && plan_load_profile "$profile_file"
 
+    # Layer 1.5: User config file(s) — override profile, sit below env/flags.
+    if [[ "$(type -t config_load)" == "function" ]]; then
+        config_load "$target_dir"
+    fi
+
     # 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"
+    [[ -n "${ZER0_AI_PROVIDER:-}" ]] && SPEC_AI_PROVIDER="$ZER0_AI_PROVIDER"
+    [[ -n "${ZER0_AI_MODEL:-}" ]]    && SPEC_AI_MODEL="$ZER0_AI_MODEL"
 
     # Layer 3: CLI flags (highest priority)
     plan_apply_flags
@@ -271,6 +280,7 @@ plan_build() {
         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 \
+        SPEC_AI_PROVIDER SPEC_AI_MODEL \
         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

data/scripts/install/spec.sh

@@ -85,7 +85,7 @@ spec_default() {
   },
   "ai": {
     "used": false,
-    "provider": "openai",
+    "provider": "auto",
     "model": "",
     "tokens_estimated": 0,
     "spec_hash": ""
@@ -108,10 +108,18 @@ spec_write() {
     local out_file="$1"
     local dry_run="${_FS_DRY_RUN:-0}"
 
-    # Build tasks array from space-separated SPEC_TASKS
+    # Build tasks array from space-separated SPEC_TASKS.
+    # Distinguish UNSET (→ default task list) from EMPTY (→ [], e.g. a
+    # deploy-only run). Using `${SPEC_TASKS:-default}` here would turn an
+    # intentional empty list back into the full default and clobber content.
     local tasks_json=""
-    local t
-    for t in ${SPEC_TASKS:-config gemfile docker pages nav data gitignore readme marker}; do
+    local t _tasks_src
+    if [[ -z "${SPEC_TASKS+set}" ]]; then
+        _tasks_src="config gemfile docker pages nav data gitignore readme marker"
+    else
+        _tasks_src="${SPEC_TASKS}"
+    fi
+    for t in ${_tasks_src}; do
         tasks_json="${tasks_json}\"${t}\","
     done
     tasks_json="[${tasks_json%,}]"
@@ -168,7 +176,7 @@ spec_write() {
   },
   "ai": {
     "used": ${SPEC_AI_USED:-false},
-    "provider": "${SPEC_AI_PROVIDER:-openai}",
+    "provider": "${SPEC_AI_PROVIDER:-auto}",
     "model": "${SPEC_AI_MODEL:-}",
     "tokens_estimated": ${SPEC_AI_TOKENS:-0},
     "spec_hash": ""
@@ -248,7 +256,7 @@ _spec_read_jq() {
     SPEC_OPT_SKIP_DOCTOR=$(jq -r '.options.skip_doctor // false' "$f")
     SPEC_OPT_VERBOSE=$(jq -r '.options.verbose // false' "$f")
     SPEC_AI_USED=$(jq -r '.ai.used // false' "$f")
-    SPEC_AI_PROVIDER=$(jq -r '.ai.provider // "openai"' "$f")
+    SPEC_AI_PROVIDER=$(jq -r '.ai.provider // "auto"' "$f")
     SPEC_AI_MODEL=$(jq -r '.ai.model // ""' "$f")
     SPEC_AI_TOKENS=$(jq -r '.ai.tokens_estimated // 0' "$f")
     SPEC_SCRAPE_SOURCE_URL=$(jq -r '.scrape.source_url // ""' "$f")
@@ -369,7 +377,7 @@ _spec_read_awk() {
     SPEC_OPT_SKIP_DOCTOR="${SPEC_OPT_SKIP_DOCTOR:-false}"
     SPEC_OPT_VERBOSE="${SPEC_OPT_VERBOSE:-false}"
     SPEC_AI_USED="${SPEC_AI_USED:-false}"
-    SPEC_AI_PROVIDER="${SPEC_AI_PROVIDER:-openai}"
+    SPEC_AI_PROVIDER="${SPEC_AI_PROVIDER:-auto}"
     SPEC_AI_MODEL="${SPEC_AI_MODEL:-}"
     SPEC_AI_TOKENS="${SPEC_AI_TOKENS:-0}"
     SPEC_SCRAPE_SOURCE_URL="${SPEC_SCRAPE_SOURCE_URL:-$(awk '/"source_url"/ { gsub(/.*"source_url"[[:space:]]*:[[:space:]]*"/, ""); gsub(/".*/, ""); print; exit }' "$f" 2>/dev/null)}"

data/scripts/install/template.sh

@@ -61,6 +61,7 @@ tmpl_render() {
         -e "s|{{THEME_DISPLAY_NAME}}|${THEME_DISPLAY_NAME:-Zer0-Mistakes}|g" \
         -e "s|{{THEME_VERSION}}|${THEME_VERSION:-}|g" \
         -e "s|{{THEME_SOURCE}}|${THEME_SOURCE:-gem}|g" \
+        -e "s|{{THEME_REMOTE}}|${THEME_REMOTE:-bamr87/zer0-mistakes}|g" \
         -e "s|{{GITHUB_USER}}|${GITHUB_USER:-}|g" \
         -e "s|{{FORK_GITHUB_USER}}|${GITHUB_USER:-}|g" \
         -e "s|{{GITHUB_REPO}}|${GITHUB_REPO:-}|g" \
@@ -72,6 +73,7 @@ tmpl_render() {
         -e "s|{{REMOTE_BRANCH}}|${REMOTE_BRANCH:-${GITHUB_PAGES_BRANCH:-gh-pages}}|g" \
         -e "s|{{REPOSITORY_NAME}}|${REPOSITORY_NAME:-${GITHUB_REPO:-my-site}}|g" \
         -e "s|{{SITE_TITLE}}|${SITE_TITLE:-My Jekyll Site}|g" \
+        -e "s|{{SITE_NAME}}|${SITE_TITLE:-My Jekyll Site}|g" \
         -e "s|{{SITE_DESCRIPTION}}|${SITE_DESCRIPTION:-A Jekyll site built with zer0-mistakes}|g" \
         -e "s|{{SITE_AUTHOR}}|${SITE_AUTHOR:-Site Author}|g" \
         -e "s|{{SITE_EMAIL}}|${SITE_EMAIL:-}|g" \
@@ -87,6 +89,8 @@ tmpl_render() {
         -e "s|{{COMMONMARKER_MACOS_VERSION}}|${COMMONMARKER_MACOS_VERSION:-~> 0.23}|g" \
         -e "s|{{GITHUB_PAGES_MAX_VERSION}}|${GITHUB_PAGES_MAX_VERSION:-232}|g" \
         -e "s|{{RUBY_MIN_VERSION_MACOS}}|${RUBY_MIN_VERSION_MACOS:-2.6.0}|g" \
+        -e "s|{{DEFAULT_BRANCH}}|${DEFAULT_BRANCH:-main}|g" \
+        -e "s|{{RUBY_VERSION}}|${RUBY_VERSION:-3.3}|g" \
         -e "s|{{INSTALL_PROFILE}}|${INSTALL_PROFILE:-default}|g" \
         -e "s|{{INSTALL_MODE}}|${INSTALL_MODE:-full}|g" \
         -e "s|{{CURRENT_DATE}}|$(date +%Y-%m-%d)|g" \

data/scripts/lib/README.md

@@ -49,11 +49,7 @@ validate_environment false false  # skip_publish=false, require_gh=false
 
 ### ✅ `scripts/bin/validate` - Preflight Validation
 
-Canonical command for local and CI preflight checks. It composes the release
-validation helpers with project-specific checks for version consistency, YAML
-configuration/data files, active configuration contracts, config-file
-classification, navigation data shape, Jekyll build/doctor, compiled assets,
-and optional test suites.
+Canonical command for local and CI preflight checks. It composes the release validation helpers with project-specific checks for version consistency, YAML configuration/data files, active configuration contracts, config-file classification, navigation data shape, Jekyll build/doctor, compiled assets, and optional test suites.
 
 **Usage:**
 

data/scripts/lib/install/deploy/README.md

@@ -1,8 +1,6 @@
 # scripts/lib/install/deploy/
 
-Pluggable deploy-target modules consumed by `scripts/bin/install deploy`
-(Phase 4 of the installer refactor). Each module configures one target;
-the registry coordinates discovery, dispatch, and verification.
+Pluggable deploy-target modules consumed by `scripts/bin/install deploy` (Phase 4 of the installer refactor). Each module configures one target; the registry coordinates discovery, dispatch, and verification.
 
 ## Files
 
@@ -26,16 +24,12 @@ Every module must define:
 | `deploy_<slug>_verify <dir>`            | Confirm expected files exist + look correct.             |
 | `deploy_<slug>_doc_url`                 | Print the canonical upstream documentation URL.          |
 
-Modules use the lightweight `deploy_render` placeholder set
-(`{{RUBY_VERSION}}`, `{{DEFAULT_BRANCH}}`, `{{GITHUB_USER}}`,
-`{{SITE_NAME}}`) so they can run without the full install.sh global
-environment.
+Modules use the lightweight `deploy_render` placeholder set (`{{RUBY_VERSION}}`, `{{DEFAULT_BRANCH}}`, `{{GITHUB_USER}}`, `{{SITE_NAME}}`) so they can run without the full install.sh global environment.
 
 ## Adding a target
 
 1. Add `templates/deploy/<slug>/` with the assets (workflow YAML,
-   Dockerfile, README, etc.). Use `*.template` for files that need
-   variable substitution.
+Dockerfile, README, etc.). Use `*.template` for files that need variable substitution.
 2. Create `scripts/lib/install/deploy/<slug>.sh` exporting the four
    hooks above.
 3. Add `<slug>` to `DEPLOY_TARGETS_LIST` in `registry.sh` (alphabetical).