jekyll-theme-zer0 1.8.2 → 1.9.1

data/scripts/install/tasks/scrape.sh

@@ -0,0 +1,348 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/tasks/scrape.sh — Generate Jekyll content from a scraped site
+# =============================================================================
+# Reads SPEC_SCRAPE_SOURCE_URL (+ depth/max_pages) from the spec, runs the
+# crawler, then materialises the rendered Jekyll content under the target:
+#
+#   - Home page  → ${target}/index.md (permalink: /)
+#   - Events     → ${target}/pages/events/<slug>.md
+#   - Posts      → ${target}/pages/news/<slug>.md
+#   - Everything → ${target}/pages/<slug>.md
+#   - Site nav   → ${target}/_data/navigation/main.yml (top-level YAML array)
+#   - Site data  → ${target}/_data/scraped_site.json
+#   - Assets     → ${target}/assets/scraped/ (images downloaded locally)
+#   - Config     → ${target}/_config.yml seeded with title/desc/lang/logo
+#
+# Behaviour:
+#   - Skipped when SPEC_SCRAPE_SOURCE_URL is empty.
+#   - Existing files are preserved unless --force is in effect.
+#   - Existing _data/navigation/main.yml is backed up to main.yml.bak on first
+#     overwrite (so theme defaults are recoverable).
+#   - Honors _FS_DRY_RUN.
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_TASK_SCRAPE:-}" ]] && return 0
+_HAS_TASK_SCRAPE=1
+
+# Source the crawler module (idempotent).
+_TASK_SCRAPE_DIR="${_TASK_SCRAPE_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")/.." 2>/dev/null && pwd)}"
+# shellcheck source=/dev/null
+[[ -f "${_TASK_SCRAPE_DIR}/scrape.sh" ]] && source "${_TASK_SCRAPE_DIR}/scrape.sh"
+
+task_scrape_run() {
+    local target="$1"
+    local src_url="${SPEC_SCRAPE_SOURCE_URL:-}"
+
+    if [[ -z "$src_url" ]]; then
+        log_debug "scrape task: no scrape.source_url in spec — skipping"
+        return 0
+    fi
+
+    local depth="${SPEC_SCRAPE_DEPTH:-2}"
+    local max_pages="${SPEC_SCRAPE_MAX_PAGES:-25}"
+    local include_nav="${SPEC_SCRAPE_INCLUDE_NAV:-true}"
+    local scrape_dir="${SPEC_SCRAPE_OUT_DIR:-${target}/.zer0/scrape}"
+
+    log_info "scrape: $src_url (depth=$depth, max=$max_pages)"
+
+    if [[ "${_FS_DRY_RUN:-0}" == "1" ]]; then
+        log_warning "DRY RUN — scrape would fetch $src_url → $scrape_dir"
+        return 0
+    fi
+
+    mkdir -p "$scrape_dir"
+    if ! scrape_run "$src_url" "$scrape_dir" "$depth" "$max_pages"; then
+        log_error "scrape: crawl failed for $src_url"
+        return 1
+    fi
+
+    local site_json="$scrape_dir/site.json"
+    local pages_dir="$scrape_dir/pages"
+    local jekyll_dir="$scrape_dir/jekyll"
+
+    if [[ ! -d "$jekyll_dir" ]]; then
+        log_warning "scrape: no jekyll output produced (skipping content copy)"
+        return 0
+    fi
+
+    # --- Distribute pages by kind ----------------------------------------
+    _task_scrape_distribute_pages "$target" "$scrape_dir" || return 1
+
+    # --- Copy downloaded assets ------------------------------------------
+    _task_scrape_copy_assets "$target" "$scrape_dir"
+
+    # --- Publish site metadata as a Jekyll data file ---------------------
+    if [[ -f "$site_json" ]]; then
+        mkdir -p "${target}/_data"
+        cp "$site_json" "${target}/_data/scraped_site.json"
+        log_debug "  wrote _data/scraped_site.json"
+    fi
+
+    # --- Wire navigation to the file the theme actually reads ------------
+    if [[ "$include_nav" == "true" && -f "$site_json" ]]; then
+        _task_scrape_write_nav "$target" "$site_json" "$src_url"
+    fi
+
+    # --- Seed _config.yml from scraped site metadata ---------------------
+    _task_scrape_seed_config "$target" "$site_json"
+
+    log_success "scrape: content imported from $src_url"
+    return 0
+}
+
+# ---------------------------------------------------------------------------
+# Distribute rendered Jekyll markdown into kind-based directories.
+# Routes each scrape_dir/jekyll/<slug>.md based on the matching
+# scrape_dir/pages/<slug>.json `kind` field.
+# ---------------------------------------------------------------------------
+_task_scrape_distribute_pages() {
+    local target="$1" scrape_dir="$2"
+    local jekyll_dir="$scrape_dir/jekyll"
+    local pages_dir="$scrape_dir/pages"
+    local copied=0 skipped=0
+    local f base slug kind dest
+
+    for f in "$jekyll_dir"/*.md; do
+        [[ -f "$f" ]] || continue
+        base=$(basename "$f")
+        slug="${base%.md}"
+
+        # Look up kind from the per-page JSON; default to "page".
+        kind="page"
+        if [[ -f "$pages_dir/$slug.json" ]]; then
+            kind=$(python3 -c '
+import json, sys
+try:
+    d = json.load(open(sys.argv[1], encoding="utf-8"))
+    print((d.get("kind") or "page").strip() or "page")
+except Exception:
+    print("page")
+' "$pages_dir/$slug.json" 2>/dev/null)
+            [[ -z "$kind" ]] && kind="page"
+        fi
+
+        case "$kind" in
+            home)
+                dest="${target}/index.md"
+                ;;
+            event)
+                dest="${target}/pages/events/${slug}.md"
+                ;;
+            post)
+                dest="${target}/pages/news/${slug}.md"
+                ;;
+            *)
+                dest="${target}/pages/${slug}.md"
+                ;;
+        esac
+
+        # Home always wins — overwrite the installer's placeholder index.
+        if [[ "$kind" != "home" && -f "$dest" && "${_FS_FORCE:-0}" != "1" ]]; then
+            log_debug "  skip (exists): ${dest#${target}/}"
+            skipped=$((skipped + 1))
+            continue
+        fi
+
+        mkdir -p "$(dirname "$dest")"
+        if [[ "$(type -t fs_copy)" == "function" && "$kind" != "home" ]]; then
+            fs_copy "$f" "$dest"
+        else
+            cp "$f" "$dest"
+        fi
+        copied=$((copied + 1))
+        log_debug "  $kind → ${dest#${target}/}"
+    done
+
+    log_info "scrape: distributed ${copied} page(s)  (skipped ${skipped})"
+}
+
+# ---------------------------------------------------------------------------
+# Copy any downloaded images from scrape_dir/assets/ → target/assets/scraped/.
+# Markdown already references /assets/scraped/<file> (set during scrape).
+# ---------------------------------------------------------------------------
+_task_scrape_copy_assets() {
+    local target="$1" scrape_dir="$2"
+    local src="$scrape_dir/assets"
+    local dst="${target}/assets/scraped"
+    [[ -d "$src" ]] || return 0
+    mkdir -p "$dst"
+    local count=0 f
+    for f in "$src"/*; do
+        [[ -f "$f" ]] || continue
+        cp "$f" "$dst/" 2>/dev/null && count=$((count + 1))
+    done
+    [[ $count -gt 0 ]] && log_info "scrape: copied $count asset(s) → assets/scraped/"
+}
+
+# ---------------------------------------------------------------------------
+# Write the scraped navigation into the file the theme actually reads:
+# _data/navigation/main.yml — top-level YAML array (NOT under a `main:` key).
+# Backs up any existing file once to main.yml.bak.
+# ---------------------------------------------------------------------------
+_task_scrape_write_nav() {
+    local target="$1" site_json="$2" src_url="$3"
+    local nav_yml="${target}/_data/navigation/main.yml"
+    mkdir -p "$(dirname "$nav_yml")"
+
+    # Back up the theme default the first time we overwrite it.
+    if [[ -f "$nav_yml" && ! -f "${nav_yml}.bak" ]]; then
+        cp "$nav_yml" "${nav_yml}.bak"
+        log_debug "  backed up existing main.yml → main.yml.bak"
+    fi
+
+    SITE_JSON="$site_json" OUT="$nav_yml" SRC="$src_url" python3 <<'PY'
+import json, os
+from urllib.parse import urlparse
+
+src_url = os.environ["SRC"]
+with open(os.environ["SITE_JSON"], "r", encoding="utf-8") as f:
+    d = json.load(f)
+
+nav = d.get("nav") or []
+base_host = urlparse(src_url).netloc
+
+# Map scraped pages by URL path so we can pick reasonable icons by kind.
+pages = d.get("pages") or []
+kind_by_path = {}
+for p in pages:
+    u = (p.get("url") or "").strip()
+    if not u: continue
+    path = (urlparse(u).path or "/").rstrip("/") or "/"
+    kind_by_path[path] = p.get("kind") or "page"
+
+ICONS = {
+    "home":    "bi-house-door",
+    "event":   "bi-calendar-event",
+    "post":    "bi-newspaper",
+    "about":   "bi-info-circle",
+    "contact": "bi-envelope",
+    "service": "bi-gear",
+    "faq":     "bi-question-circle",
+    "page":    "bi-file-earmark-text",
+}
+
+out = []
+seen_paths = set()
+
+# Always lead with Home.
+out.append({"title": "Home", "icon": "bi-house-door", "url": "/"})
+seen_paths.add("/")
+
+for item in nav:
+    label = (item.get("label") or "").strip()
+    url   = (item.get("url") or "").strip()
+    if not label or not url: continue
+    p = urlparse(url)
+    if p.netloc and p.netloc != base_host: continue
+    path = (p.path or "/").rstrip("/") or "/"
+    if path in seen_paths: continue
+    seen_paths.add(path)
+    kind = kind_by_path.get(path, "page")
+    out.append({
+        "title": label,
+        "icon":  ICONS.get(kind, "bi-file-earmark-text"),
+        "url":   path if path == "/" else (path + "/"),
+    })
+
+# If the source nav was empty/blocked, fall back to top scraped pages.
+if len(out) <= 1:
+    for p in pages[:6]:
+        url = (p.get("url") or "").strip()
+        if not url: continue
+        path = (urlparse(url).path or "/").rstrip("/") or "/"
+        if path in seen_paths: continue
+        seen_paths.add(path)
+        out.append({
+            "title": (p.get("title") or path.strip("/") or "Page")[:60],
+            "icon":  ICONS.get(p.get("kind") or "page", "bi-file-earmark-text"),
+            "url":   path if path == "/" else (path + "/"),
+        })
+
+def yq(s):
+    return '"' + str(s).replace("\\", "\\\\").replace('"', '\\"') + '"'
+
+lines = ["# Auto-generated from scrape: " + src_url, ""]
+for item in out:
+    lines.append(f'- title: {yq(item["title"])}')
+    lines.append(f'  icon: {item["icon"]}')
+    lines.append(f'  url: {yq(item["url"])}')
+    lines.append("")
+
+with open(os.environ["OUT"], "w", encoding="utf-8") as f:
+    f.write("\n".join(lines).rstrip() + "\n")
+PY
+    log_info "scrape: wrote $(basename "$nav_yml") with $(grep -c '^- title:' "$nav_yml" 2>/dev/null || echo 0) entries"
+}
+
+# ---------------------------------------------------------------------------
+# Seed _config.yml from scraped metadata. Non-destructive: only fills empty
+# or installer-placeholder values.
+# ---------------------------------------------------------------------------
+_task_scrape_seed_config() {
+    local target="$1" site_json="$2"
+    [[ -f "$site_json" ]] || return 0
+    local cfg="${target}/_config.yml"
+    [[ -f "$cfg" ]] || return 0
+
+    SITE_JSON="$site_json" CFG="$cfg" python3 <<'PY'
+import json, os, re
+
+with open(os.environ["SITE_JSON"], encoding="utf-8") as f:
+    s = json.load(f)
+title = (s.get("title") or "").strip()
+desc  = (s.get("description") or "").strip()
+lang  = (s.get("lang") or "").strip() or "en"
+image = (s.get("image") or "").strip()
+
+cfg_path = os.environ["CFG"]
+with open(cfg_path, encoding="utf-8") as f:
+    txt = f.read()
+
+PLACEHOLDERS = {
+    "title": {"", "My Jekyll Site", "Your Site Title", "Jekyll Theme zer0"},
+    "description": {"", "A Jekyll site built with zer0-mistakes",
+                    "A description of your site"},
+    "lang": {"", "en-US"},
+    "logo": {"", "/assets/images/logo.png", "/assets/logo.png"},
+}
+
+def repl_scalar(s, key, val, placeholders):
+    if not val:
+        return s
+    pat = re.compile(r'^(' + re.escape(key) + r'\s*:\s*)(.*)$', re.M)
+    def fn(m):
+        cur = m.group(2).strip().strip('"').strip("'")
+        if cur and cur not in placeholders:
+            return m.group(0)
+        safe = val.replace('"', "")
+        return f'{m.group(1)}"{safe}"'
+    return pat.sub(fn, s, count=1)
+
+txt = repl_scalar(txt, "title",       title, PLACEHOLDERS["title"])
+txt = repl_scalar(txt, "description", desc,  PLACEHOLDERS["description"])
+txt = repl_scalar(txt, "lang",        lang,  PLACEHOLDERS["lang"])
+if image:
+    txt = repl_scalar(txt, "logo", image, PLACEHOLDERS["logo"])
+
+# Ensure lang/logo exist; if not, append a small block.
+appended = []
+if title and not re.search(r'^title\s*:', txt, re.M):
+    appended.append(f'title: "{title}"')
+if desc and not re.search(r'^description\s*:', txt, re.M):
+    appended.append(f'description: "{desc}"')
+if lang and not re.search(r'^lang\s*:', txt, re.M):
+    appended.append(f'lang: "{lang}"')
+if image and not re.search(r'^logo\s*:', txt, re.M):
+    appended.append(f'logo: "{image}"')
+if appended:
+    if not txt.endswith("\n"): txt += "\n"
+    txt += "\n# Seeded from scrape\n" + "\n".join(appended) + "\n"
+
+with open(cfg_path, "w", encoding="utf-8") as f:
+    f.write(txt)
+PY
+    log_debug "  seeded _config.yml from scrape metadata"
+}
+

data/scripts/install/template.sh

@@ -0,0 +1,138 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/template.sh — Template rendering
+# =============================================================================
+# Single source of truth: EVERY generated file comes from a template.
+# Never inline heredocs anywhere else.
+#
+# Provides:
+#   tmpl_render  TEMPLATE_FILE [OUTPUT_FILE]
+#       Substitutes {{VAR}} placeholders from the current environment.
+#       If OUTPUT_FILE is omitted, writes to stdout.
+#
+#   tmpl_apply  TEMPLATE_REL_PATH OUTPUT_FILE
+#       Resolution order:
+#         1. $TEMPLATES_DIR/TEMPLATE_REL_PATH  (local checkout)
+#         2. Remote fetch from $ZER0_RAW_URL/templates/TEMPLATE_REL_PATH
+#            (when ZER0_REMOTE_INSTALL=1)
+#       Respects _FS_DRY_RUN, _FS_FORCE via fs.sh.
+#       Returns 1 if template not found anywhere.
+#
+# Variables substituted (extend by editing the sed chain below):
+#   SITE_TITLE, SITE_DESCRIPTION, SITE_AUTHOR, SITE_EMAIL, SITE_URL
+#   SITE_TIMEZONE, SITE_LOCALE
+#   GITHUB_USER, GITHUB_REPO, GITHUB_URL, ZER0_RAW_URL
+#   GITHUB_PAGES_BRANCH, REPOSITORY_NAME
+#   THEME_NAME, THEME_GEM_NAME, THEME_DISPLAY_NAME, THEME_VERSION
+#   THEME_SOURCE (gem|remote|vendored)
+#   DEFAULT_PORT, DEFAULT_URL
+#   JEKYLL_VERSION, FFI_VERSION, WEBRICK_VERSION
+#   COMMONMARKER_VERSION, COMMONMARKER_MACOS_VERSION
+#   GITHUB_PAGES_MAX_VERSION
+#   RUBY_MIN_VERSION_MACOS
+#   CURRENT_DATE, CURRENT_YEAR
+#   INSTALL_PROFILE, INSTALL_MODE (legacy compat)
+#   REMOTE_BRANCH
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_TEMPLATE_LIB:-}" ]] && return 0
+_HAS_TEMPLATE_LIB=1
+
+# Substitute all {{VAR}} tokens from the environment.
+# BSD sed and GNU sed compatible. Processes one line at a time via awk-delegation.
+tmpl_render() {
+    local template_file="$1"
+    local output_file="${2:-}"
+
+    if [[ ! -f "$template_file" ]]; then
+        log_error "tmpl_render: template not found: $template_file"
+        return 1
+    fi
+
+    local content
+    content=$(cat "$template_file")
+
+    # Apply all substitutions. BSD-sed compatible (no -i without extension).
+    # Pipe chain: each sed -e is one substitution pass.
+    content=$(printf '%s' "$content" | sed \
+        -e "s|{{THEME_NAME}}|${THEME_NAME:-zer0-mistakes}|g" \
+        -e "s|{{THEME_GEM_NAME}}|${THEME_GEM_NAME:-jekyll-theme-zer0}|g" \
+        -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|{{GITHUB_USER}}|${GITHUB_USER:-}|g" \
+        -e "s|{{FORK_GITHUB_USER}}|${GITHUB_USER:-}|g" \
+        -e "s|{{GITHUB_REPO}}|${GITHUB_REPO:-}|g" \
+        -e "s|{{GITHUB_FULL_REPO}}|${GITHUB_USER:-}/${GITHUB_REPO:-}|g" \
+        -e "s|{{GITHUB_URL}}|${GITHUB_URL:-https://github.com/bamr87/zer0-mistakes}|g" \
+        -e "s|{{ZER0_RAW_URL}}|${ZER0_RAW_URL:-https://raw.githubusercontent.com/bamr87/zer0-mistakes/main}|g" \
+        -e "s|{{GITHUB_RAW_URL}}|${ZER0_RAW_URL:-https://raw.githubusercontent.com/bamr87/zer0-mistakes/main}|g" \
+        -e "s|{{GITHUB_PAGES_BRANCH}}|${GITHUB_PAGES_BRANCH:-gh-pages}|g" \
+        -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_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" \
+        -e "s|{{SITE_URL}}|${SITE_URL:-}|g" \
+        -e "s|{{SITE_TIMEZONE}}|${SITE_TIMEZONE:-UTC}|g" \
+        -e "s|{{SITE_LOCALE}}|${SITE_LOCALE:-en}|g" \
+        -e "s|{{DEFAULT_PORT}}|${DEFAULT_PORT:-4000}|g" \
+        -e "s|{{DEFAULT_URL}}|${DEFAULT_URL:-http://localhost:4000}|g" \
+        -e "s|{{JEKYLL_VERSION}}|${JEKYLL_VERSION:-~> 4.3}|g" \
+        -e "s|{{FFI_VERSION}}|${FFI_VERSION:-~> 1.15}|g" \
+        -e "s|{{WEBRICK_VERSION}}|${WEBRICK_VERSION:-~> 1.8}|g" \
+        -e "s|{{COMMONMARKER_VERSION}}|${COMMONMARKER_VERSION:-~> 0.23}|g" \
+        -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|{{INSTALL_PROFILE}}|${INSTALL_PROFILE:-default}|g" \
+        -e "s|{{INSTALL_MODE}}|${INSTALL_MODE:-full}|g" \
+        -e "s|{{CURRENT_DATE}}|$(date +%Y-%m-%d)|g" \
+        -e "s|{{CURRENT_YEAR}}|$(date +%Y)|g" \
+    )
+
+    if [[ -n "$output_file" ]]; then
+        # Delegate to fs.sh for safe write (backup, dry-run, force awareness)
+        if [[ "$(type -t fs_write_file)" == "function" ]]; then
+            fs_write_file "$output_file" "$content"
+        else
+            mkdir -p "$(dirname "$output_file")"
+            printf '%s\n' "$content" > "$output_file"
+        fi
+    else
+        printf '%s\n' "$content"
+    fi
+}
+
+# Apply a template by relative path → output file.
+# Resolution: local TEMPLATES_DIR → remote fetch.
+tmpl_apply() {
+    local tmpl_rel="$1"
+    local output_file="$2"
+
+    # 1. Local templates dir
+    if [[ -n "${TEMPLATES_DIR:-}" && -f "${TEMPLATES_DIR}/${tmpl_rel}" ]]; then
+        tmpl_render "${TEMPLATES_DIR}/${tmpl_rel}" "$output_file"
+        return $?
+    fi
+
+    # 2. Remote fetch (only in remote install mode)
+    if [[ "${ZER0_REMOTE_INSTALL:-0}" == "1" ]]; then
+        local raw_url="${ZER0_RAW_URL:-https://raw.githubusercontent.com/bamr87/zer0-mistakes/main}"
+        local fetch_url="${raw_url}/templates/${tmpl_rel}"
+        local tmp_file
+        tmp_file=$(mktemp /tmp/zer0-tmpl-XXXXXX)
+        if curl -fsSL --max-time 15 "$fetch_url" -o "$tmp_file" 2>/dev/null; then
+            tmpl_render "$tmp_file" "$output_file"
+            local ret=$?
+            rm -f "$tmp_file"
+            return $ret
+        fi
+        rm -f "$tmp_file"
+    fi
+
+    log_error "tmpl_apply: template not found: $tmpl_rel"
+    return 1
+}

data/scripts/install/tui.sh

@@ -0,0 +1,110 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/tui.sh — Non-AI interactive wizard
+# =============================================================================
+# Prompts the user through site configuration using prompt.sh and builds
+# a spec. Replaces the old install.sh interactive path.
+#
+# Provides:
+#   tui_run TARGET_DIR
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_TUI_LIB:-}" ]] && return 0
+_HAS_TUI_LIB=1
+
+tui_run() {
+    local target="${1:-$(pwd)}"
+
+    log_banner "zer0-mistakes Setup Wizard"
+    log_info "Let's configure your Jekyll site."
+    log_info "(Press Enter to accept defaults shown in brackets)"
+    printf "\n" >&2
+
+    # Profile
+    prompt_select SPEC_PROFILE "Installation profile" \
+        default minimal blog docs portfolio github-pages fork
+    export SPEC_PROFILE
+
+    # Site info
+    prompt_ask SPEC_SITE_TITLE "Site title" "My Jekyll Site"
+    prompt_ask SPEC_SITE_DESCRIPTION "Short description" "A Jekyll site built with zer0-mistakes"
+    prompt_ask SPEC_SITE_AUTHOR "Author name" "$(git config user.name 2>/dev/null || echo "Site Author")"
+    prompt_ask SPEC_SITE_EMAIL "Author email" "$(git config user.email 2>/dev/null || echo "")"
+
+    export SPEC_SITE_TITLE SPEC_SITE_DESCRIPTION SPEC_SITE_AUTHOR SPEC_SITE_EMAIL
+
+    # GitHub
+    if prompt_confirm "Configure GitHub integration?"; then
+        prompt_ask SPEC_GITHUB_USER "GitHub username" "${SPEC_GITHUB_USER:-}"
+        prompt_ask SPEC_GITHUB_REPO "Repository name" "$(basename "$target")"
+        export SPEC_GITHUB_USER SPEC_GITHUB_REPO
+
+        if prompt_confirm "Enable GitHub Pages?"; then
+            SPEC_GITHUB_ENABLE_PAGES=true
+        else
+            SPEC_GITHUB_ENABLE_PAGES=false
+        fi
+        export SPEC_GITHUB_ENABLE_PAGES
+    fi
+
+    # Deploy
+    if prompt_confirm "Add a deployment configuration?"; then
+        prompt_select _TUI_DEPLOY "Deploy target" \
+            github-pages azure-swa docker-prod vercel netlify cloudflare-pages none
+        [[ "$_TUI_DEPLOY" != "none" ]] && SPEC_DEPLOY="$_TUI_DEPLOY"
+        export SPEC_DEPLOY
+    fi
+
+    # Agent files
+    if prompt_confirm "Install AI agent files (AGENTS.md, etc.)?"; then
+        printf "\nSelect agent integrations (space-separated, e.g. 'copilot claude'):\n" >&2
+        printf "  generic copilot claude cursor aider all\n" >&2
+        prompt_ask _TUI_AGENTS "Agents" "generic"
+        [[ "$_TUI_AGENTS" != "none" ]] && SPEC_AGENTS="$_TUI_AGENTS"
+        export SPEC_AGENTS
+    fi
+
+    # Options
+    if prompt_confirm "Enable dry-run preview (no files written)?"; then
+        SPEC_OPT_DRY_RUN=true
+    else
+        SPEC_OPT_DRY_RUN=false
+    fi
+    export SPEC_OPT_DRY_RUN
+
+    printf "\n" >&2
+
+    # Build final spec
+    SPEC_TARGET_DIR="$target"
+    export SPEC_TARGET_DIR
+    plan_apply_platform
+
+    if [[ -z "${SPEC_TASKS:-}" ]]; then
+        SPEC_TASKS="config gemfile docker pages nav data gitignore readme marker"
+    fi
+    export SPEC_TASKS
+
+    # Show summary
+    log_info "--- Configuration Summary ---"
+    log_info "Profile   : ${SPEC_PROFILE}"
+    log_info "Title     : ${SPEC_SITE_TITLE}"
+    log_info "Author    : ${SPEC_SITE_AUTHOR}"
+    log_info "GitHub    : ${SPEC_GITHUB_USER:-not set}/${SPEC_GITHUB_REPO:-not set}"
+    log_info "Deploy    : ${SPEC_DEPLOY:-none}"
+    log_info "Agents    : ${SPEC_AGENTS:-none}"
+    log_info "Dry run   : ${SPEC_OPT_DRY_RUN}"
+    log_info "Target    : ${target}"
+    printf "\n" >&2
+
+    if ! prompt_confirm "Proceed with installation?"; then
+        log_info "Aborted."
+        return 0
+    fi
+
+    # Write spec and apply
+    local spec_file
+    spec_file="$(spec_path "$target")"
+    spec_write "$spec_file"
+    apply_run "$spec_file"
+}

data/scripts/install/upgrade.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# =============================================================================
+# scripts/install/upgrade.sh — Re-apply spec to an existing install
+# =============================================================================
+# Reads the existing .zer0/install.spec.json, applies flag overrides,
+# and re-runs apply.sh — safely updating config/agent files without
+# touching user content.
+#
+# Provides:
+#   upgrade_run TARGET_DIR
+#
+# Bash 3.2 compatible. No set -euo pipefail here.
+# =============================================================================
+[[ -n "${_HAS_UPGRADE_LIB:-}" ]] && return 0
+_HAS_UPGRADE_LIB=1
+
+upgrade_run() {
+    local target="${1:-$(pwd)}"
+    local spec_file
+    spec_file="$(spec_path "$target")"
+
+    if [[ ! -f "$spec_file" ]]; then
+        log_error "upgrade: no spec found at $spec_file"
+        log_info "Run 'install init $target' first, or use 'install init --force' to re-create."
+        return 1
+    fi
+
+    log_info "Upgrading existing install at: $target"
+    spec_read "$spec_file"
+
+    # Apply any flag overrides
+    plan_apply_flags
+    plan_apply_platform
+
+    # Never upgrade user content pages by default
+    local safe_tasks=""
+    local t
+    for t in ${SPEC_TASKS}; do
+        case "$t" in
+            pages|nav|data) ;;   # skip content tasks on upgrade
+            *) safe_tasks="${safe_tasks} $t" ;;
+        esac
+    done
+    SPEC_TASKS="${safe_tasks# }"
+    export SPEC_TASKS
+
+    spec_write "$spec_file"
+    apply_run "$spec_file"
+}

data/scripts/lib/install/template.sh

@@ -75,6 +75,7 @@ render_template() {
         -e "s|{{RAW_GITHUB_URL}}|${GITHUB_RAW_URL}|g" \
         -e "s|{{FORK_GITHUB_USER}}|${FORK_GITHUB_USER:-${GITHUB_USER}}|g" \
         -e "s|{{INSTALL_MODE}}|${INSTALL_MODE:-full}|g" \
+        -e "s|{{REMOTE_BRANCH}}|${REMOTE_BRANCH:-gh-pages}|g" \
         -e "s|{{GITHUB_PAGES_URL}}|https://${FORK_GITHUB_USER:-${GITHUB_USER}}.github.io/${REPOSITORY_NAME:-$THEME_NAME}|g")
 
     if [[ -n "$output_file" ]]; then