jekyll-theme-zer0 0.22.20 → 0.22.22

data/scripts/lib/install/platform.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# =========================================================================
+# scripts/lib/install/platform.sh
+# =========================================================================
+# Platform / Ruby detection helpers used by install.sh.
+#
+# Bash 3.2-compatible — no `declare -A`, no `=~` capture groups.
+#
+# Functions exported:
+#   detect_os               -> Darwin | Linux | CYGWIN | MINGW | unknown
+#   detect_ruby_version     -> e.g. "2.6.8" or "none"
+#   ruby_version_lt_27      -> exit 0 when ruby < 2.7
+#   needs_macos_gemfile     -> exit 0 when macOS + ruby < 2.7
+#   detect_platform         -> auto | wsl | macos | linux | unknown
+# =========================================================================
+
+# Returns: Darwin | Linux | CYGWIN | MINGW | unknown
+detect_os() {
+    uname -s 2>/dev/null || echo "unknown"
+}
+
+# Returns the ruby version string (e.g. "2.6.8"), or "none" if ruby is absent.
+detect_ruby_version() {
+    if ! command -v ruby >/dev/null 2>&1; then
+        echo "none"
+        return
+    fi
+    # ruby --version prints: ruby 2.6.8p205 (2021-07-07 ...) [platform]
+    # We want "2.6.8" — strip the trailing pNNN patch indicator via sed.
+    ruby --version 2>/dev/null | awk '{print $2}' | sed 's/p[0-9]*//' | sed 's/-.*//' | tr -d '\r'
+}
+
+# Returns 0 (true) if the current Ruby version is < 2.7.0, 1 (false) otherwise.
+# Uses awk so arithmetic is safe even with partial version strings.
+ruby_version_lt_27() {
+    local ver
+    ver=$(detect_ruby_version)
+    [ "$ver" = "none" ] && return 1  # no ruby → don't apply macOS caps
+    awk -v ver="$ver" 'BEGIN {
+        n = split(ver, a, ".")
+        if (a[1]+0 == 2 && a[2]+0 < 7) exit 0
+        exit 1
+    }'
+}
+
+# Returns 0 (true) when running on macOS with system Ruby < 2.7.
+# This is the condition that triggers use of Gemfile.macos.template.
+needs_macos_gemfile() {
+    local os
+    os=$(detect_os)
+    [ "$os" = "Darwin" ] && ruby_version_lt_27
+}
+
+# Detect runtime platform. Honours $PLATFORM if explicitly set.
+# Returns: macos | linux | wsl | unknown
+detect_platform() {
+    if [[ "${PLATFORM:-auto}" != "auto" ]]; then
+        echo "$PLATFORM"
+        return
+    fi
+    # WSL detection (check before generic Linux)
+    if grep -qiE '(microsoft|wsl)' /proc/version 2>/dev/null; then
+        echo "wsl"
+    elif [[ "$(uname -s)" == "Darwin" ]]; then
+        echo "macos"
+    elif [[ "$(uname -s)" == "Linux" ]]; then
+        echo "linux"
+    else
+        echo "unknown"
+    fi
+}

data/scripts/lib/install/profile.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# scripts/lib/install/profile.sh
+#
+# Minimal pure-bash YAML reader for templates/profiles/*.yml.
+# Bash 3.2 compatible. Schema is intentionally simple (scalar key/value
+# + flat string lists) so we don't need yq/python.
+#
+# Public API:
+#   profiles_dir <REPO_ROOT>             — absolute path to profiles dir
+#   list_profile_names <REPO_ROOT>       — newline-separated profile slugs
+#   profile_path <REPO_ROOT> <name>      — absolute path to a profile yml
+#   profile_get_scalar <file> <key>      — print a scalar value or empty
+#   profile_get_list <file> <key>        — print list items, one per line
+#   profile_print_summary <file>         — pretty-print full profile
+
+profiles_dir() {
+    local repo_root="$1"
+    echo "$repo_root/templates/profiles"
+}
+
+list_profile_names() {
+    local repo_root="$1"
+    local dir
+    dir="$(profiles_dir "$repo_root")"
+    [ -d "$dir" ] || return 1
+    # List *.yml stems, sorted, excluding any leading-dot files
+    ( cd "$dir" && for f in *.yml; do
+        [ -e "$f" ] || continue
+        echo "${f%.yml}"
+    done ) | sort
+}
+
+profile_path() {
+    local repo_root="$1" name="$2"
+    local p
+    p="$(profiles_dir "$repo_root")/${name}.yml"
+    [ -f "$p" ] || return 1
+    echo "$p"
+}
+
+# Extract a scalar value: lines like `key: value`. Strips surrounding
+# whitespace and quotes. Ignores list lines (starting with `-`).
+profile_get_scalar() {
+    local file="$1" key="$2"
+    [ -f "$file" ] || return 1
+    awk -v k="$key" '
+        # match "  key: value" or "key: value" at top level (no leading dash)
+        $0 ~ "^[[:space:]]*" k "[[:space:]]*:" {
+            sub("^[[:space:]]*" k "[[:space:]]*:[[:space:]]*", "")
+            # strip trailing comments
+            sub(/[[:space:]]+#.*$/, "")
+            # strip surrounding quotes
+            gsub(/^["'\'']|["'\'']$/, "")
+            print
+            exit
+        }
+    ' "$file"
+}
+
+# Extract a flat list under a key. Returns nothing for `key: []` or missing.
+profile_get_list() {
+    local file="$1" key="$2"
+    [ -f "$file" ] || return 1
+    awk -v k="$key" '
+        BEGIN { inblock = 0 }
+        # Start: "key:" line with nothing (or just a comment) after it
+        $0 ~ "^[[:space:]]*" k "[[:space:]]*:[[:space:]]*(#.*)?$" {
+            inblock = 1
+            next
+        }
+        inblock {
+            # End block on next non-list, non-blank, non-indented line
+            if ($0 ~ /^[[:space:]]*-[[:space:]]+/) {
+                line = $0
+                sub(/^[[:space:]]*-[[:space:]]+/, "", line)
+                sub(/[[:space:]]+#.*$/, "", line)
+                gsub(/^["'\'']|["'\'']$/, "", line)
+                print line
+                next
+            }
+            if ($0 ~ /^[[:space:]]*#/) next
+            if ($0 ~ /^[[:space:]]*$/) next
+            inblock = 0
+        }
+    ' "$file"
+}
+
+profile_print_summary() {
+    local file="$1"
+    [ -f "$file" ] || { echo "(profile file not found: $file)" >&2; return 1; }
+    local name display desc legacy rec
+    name="$(profile_get_scalar "$file" name)"
+    display="$(profile_get_scalar "$file" display_name)"
+    desc="$(profile_get_scalar "$file" description)"
+    legacy="$(profile_get_scalar "$file" legacy_flag)"
+    rec="$(profile_get_scalar "$file" recommended_for)"
+    printf '  %-9s %s\n' "$name" "$display"
+    [ -n "$desc" ]   && printf '            %s\n' "$desc"
+    [ -n "$legacy" ] && printf '            → install.sh %s\n' "$legacy"
+    [ -n "$rec" ]    && printf '            For: %s\n' "$rec"
+    local includes excludes
+    includes="$(profile_get_list "$file" includes)"
+    excludes="$(profile_get_list "$file" excludes)"
+    if [ -n "$includes" ]; then
+        printf '            Includes:\n'
+        echo "$includes" | sed 's/^/              - /'
+    fi
+    if [ -n "$excludes" ]; then
+        printf '            Excludes:\n'
+        echo "$excludes" | sed 's/^/              - /'
+    fi
+    echo
+}

data/scripts/lib/install/template.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+# =========================================================================
+# scripts/lib/install/template.sh
+# =========================================================================
+# Template rendering for install.sh.
+#
+# Functions exported:
+#   render_template TEMPLATE_FILE [OUTPUT_FILE]
+#       Replace {{VAR_NAME}} placeholders. If OUTPUT_FILE omitted, writes
+#       to stdout.
+#
+#   create_from_template TEMPLATE_REL OUTPUT_FILE [FALLBACK_CONTENT]
+#       Resolution order:
+#         1. Local templates ($TEMPLATES_DIR/$TEMPLATE_REL)
+#         2. Remote fetch from $GITHUB_RAW_URL/templates/$TEMPLATE_REL
+#            (only when REMOTE_INSTALL=true)
+#         3. FALLBACK_CONTENT (literal string)
+#       Existing OUTPUT_FILE is preserved (skipped with a warning).
+#
+#   templates_available
+#       Returns 0 when $TEMPLATES_DIR is set and points to an existing dir.
+#
+# Required globals (provided by install.sh / install.conf):
+#   THEME_NAME, THEME_GEM_NAME, THEME_DISPLAY_NAME,
+#   GITHUB_USER, GITHUB_REPO, GITHUB_URL, GITHUB_RAW_URL,
+#   DEFAULT_PORT, DEFAULT_URL,
+#   JEKYLL_VERSION, FFI_VERSION, WEBRICK_VERSION, COMMONMARKER_VERSION,
+#   GITHUB_PAGES_MAX_VERSION, COMMONMARKER_MACOS_VERSION,
+#   RUBY_MIN_VERSION_MACOS, INSTALL_MODE, REMOTE_INSTALL, TEMPLATES_DIR
+#
+# Optional globals (used when set):
+#   FORK_GITHUB_USER, FORK_SITE_NAME, FORK_AUTHOR, FORK_EMAIL,
+#   SITE_TITLE, SITE_DESCRIPTION, SITE_AUTHOR, SITE_EMAIL,
+#   REPOSITORY_NAME
+# =========================================================================
+
+# Render a template file, replacing {{VAR_NAME}} placeholders.
+render_template() {
+    local template_file="$1"
+    local output_file="${2:-}"
+
+    if [[ ! -f "$template_file" ]]; then
+        return 1
+    fi
+
+    local content
+    content=$(cat "$template_file")
+
+    # Replace all known placeholders. Order matches the original install.sh
+    # implementation to guarantee identical output.
+    content=$(echo "$content" | sed \
+        -e "s|{{THEME_NAME}}|${THEME_NAME}|g" \
+        -e "s|{{THEME_GEM_NAME}}|${THEME_GEM_NAME}|g" \
+        -e "s|{{THEME_DISPLAY_NAME}}|${THEME_DISPLAY_NAME}|g" \
+        -e "s|{{GITHUB_USER}}|${FORK_GITHUB_USER:-$GITHUB_USER}|g" \
+        -e "s|{{GITHUB_REPO}}|${GITHUB_REPO}|g" \
+        -e "s|{{GITHUB_URL}}|${GITHUB_URL}|g" \
+        -e "s|{{GITHUB_RAW_URL}}|${GITHUB_RAW_URL}|g" \
+        -e "s|{{DEFAULT_PORT}}|${DEFAULT_PORT}|g" \
+        -e "s|{{DEFAULT_URL}}|${DEFAULT_URL}|g" \
+        -e "s|{{JEKYLL_VERSION}}|${JEKYLL_VERSION}|g" \
+        -e "s|{{FFI_VERSION}}|${FFI_VERSION}|g" \
+        -e "s|{{WEBRICK_VERSION}}|${WEBRICK_VERSION}|g" \
+        -e "s|{{COMMONMARKER_VERSION}}|${COMMONMARKER_VERSION}|g" \
+        -e "s|{{GITHUB_PAGES_MAX_VERSION}}|${GITHUB_PAGES_MAX_VERSION:-232}|g" \
+        -e "s|{{COMMONMARKER_MACOS_VERSION}}|${COMMONMARKER_MACOS_VERSION:-~> 0.23}|g" \
+        -e "s|{{RUBY_MIN_VERSION_MACOS}}|${RUBY_MIN_VERSION_MACOS:-2.6.0}|g" \
+        -e "s|{{SITE_TITLE}}|${FORK_SITE_NAME:-${SITE_TITLE:-My Jekyll Site}}|g" \
+        -e "s|{{SITE_DESCRIPTION}}|${SITE_DESCRIPTION:-A Jekyll site built with ${THEME_NAME}}|g" \
+        -e "s|{{SITE_AUTHOR}}|${FORK_AUTHOR:-${SITE_AUTHOR:-Site Author}}|g" \
+        -e "s|{{SITE_EMAIL}}|${FORK_EMAIL:-${SITE_EMAIL:-your@email.com}}|g" \
+        -e "s|{{CURRENT_DATE}}|$(date +%Y-%m-%d)|g" \
+        -e "s|{{CURRENT_YEAR}}|$(date +%Y)|g" \
+        -e "s|{{REPOSITORY_NAME}}|${REPOSITORY_NAME:-$THEME_NAME}|g" \
+        -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|{{GITHUB_PAGES_URL}}|https://${FORK_GITHUB_USER:-${GITHUB_USER}}.github.io/${REPOSITORY_NAME:-$THEME_NAME}|g")
+
+    if [[ -n "$output_file" ]]; then
+        mkdir -p "$(dirname "$output_file")"
+        echo "$content" > "$output_file"
+    else
+        echo "$content"
+    fi
+}
+
+# Create a file from template with automatic fallback to embedded content.
+create_from_template() {
+    local template_path="$1"
+    local output_file="$2"
+    local fallback_content="${3:-}"
+
+    # Skip if output already exists
+    if [[ -f "$output_file" ]]; then
+        log_warning "$(basename "$output_file") already exists, skipping to preserve content"
+        return 0
+    fi
+
+    # Try local template first
+    if [[ -n "${TEMPLATES_DIR:-}" ]] && [[ -f "$TEMPLATES_DIR/$template_path" ]]; then
+        render_template "$TEMPLATES_DIR/$template_path" "$output_file"
+        log_info "Created $(basename "$output_file") from template"
+        return 0
+    fi
+
+    # Try to fetch from GitHub for remote installs
+    if [[ "${REMOTE_INSTALL:-false}" == "true" ]]; then
+        local remote_url="${GITHUB_RAW_URL}/templates/$template_path"
+        local remote_content
+        if remote_content=$(curl -fsSL "$remote_url" 2>/dev/null); then
+            local temp_file
+            temp_file=$(mktemp)
+            echo "$remote_content" > "$temp_file"
+            render_template "$temp_file" "$output_file"
+            rm -f "$temp_file"
+            log_info "Created $(basename "$output_file") from remote template"
+            return 0
+        fi
+    fi
+
+    # Use fallback content if provided
+    if [[ -n "$fallback_content" ]]; then
+        mkdir -p "$(dirname "$output_file")"
+        echo "$fallback_content" > "$output_file"
+        log_info "Created $(basename "$output_file") from fallback"
+        return 0
+    fi
+
+    log_warning "Could not create $(basename "$output_file") (no template or fallback)"
+    return 1
+}
+
+# Check if templates are available (TEMPLATES_DIR set + directory exists).
+templates_available() {
+    [[ -n "${TEMPLATES_DIR:-}" ]] && [[ -d "$TEMPLATES_DIR" ]]
+}

data/scripts/lib/install/upgrade.sh

@@ -0,0 +1,184 @@
+#!/usr/bin/env bash
+# scripts/lib/install/upgrade.sh
+#
+# `install upgrade` — version-aware migration over an existing site.
+#
+# Strategy:
+#   1. Detect installed version from .zer0-installed (drop-marker) or
+#      _config.yml's `version:` field, or fall back to "unknown".
+#   2. Print a diff-summary of what will change (theme files only — never
+#      touches user content under pages/, _posts/, _drafts/).
+#   3. Re-runs the agent-files install (always safe, additive) and offers
+#      to refresh templated workflows under .github/workflows/.
+#   4. Writes a fresh .zer0-installed marker with the new version + date.
+#
+# Public API:
+#     upgrade_run <target_dir> <repo_root> [--from <version>] [--force]
+#                                          [--dry-run] [--auto-accept]
+#
+# Bash 3.2-compatible. Idempotent. Never destructive without explicit --force.
+
+# shellcheck disable=SC2034
+UPGRADE_LIB_VERSION="1.0.0"
+
+UPGRADE_MARKER=".zer0-installed"
+
+# Read theme version from lib/jekyll-theme-zer0/version.rb
+_upgrade_theme_version() {
+    local repo_root="$1"
+    local vfile="$repo_root/lib/jekyll-theme-zer0/version.rb"
+    [[ -f "$vfile" ]] || { echo "unknown"; return; }
+    grep -E 'VERSION\s*=' "$vfile" | head -n1 | sed -E 's/.*"([^"]+)".*/\1/'
+}
+
+# Detect the previously installed version (best-effort).
+_upgrade_detect_installed() {
+    local target_dir="$1"
+    if [[ -f "$target_dir/$UPGRADE_MARKER" ]]; then
+        grep -E '^version:' "$target_dir/$UPGRADE_MARKER" 2>/dev/null \
+            | head -n1 | sed -E 's/version:[[:space:]]*//'
+        return
+    fi
+    # Fallback: probe _config.yml for a `version:` line
+    if [[ -f "$target_dir/_config.yml" ]]; then
+        local v
+        v="$(grep -E '^version:' "$target_dir/_config.yml" 2>/dev/null \
+            | head -n1 | sed -E 's/version:[[:space:]]*//' \
+            | tr -d '"' | tr -d "'")"
+        [[ -n "$v" ]] && { echo "$v"; return; }
+    fi
+    echo "unknown"
+}
+
+# Write/update the install marker.
+_upgrade_write_marker() {
+    local target_dir="$1" version="$2" dry_run="$3"
+    local marker="$target_dir/$UPGRADE_MARKER"
+    local content
+    content="$(cat <<EOF
+# zer0-mistakes install marker — do not edit manually
+version: $version
+upgraded_at: $(date -u +%Y-%m-%dT%H:%M:%SZ)
+EOF
+)"
+    if [[ "$dry_run" = "1" ]]; then
+        log_info "[dry-run] Would write marker: $marker"
+        return
+    fi
+    printf '%s\n' "$content" > "$marker"
+    log_success "Wrote $UPGRADE_MARKER (version: $version)"
+}
+
+# Re-run agents install in --force mode (theme files are safe to refresh).
+_upgrade_refresh_agents() {
+    local target_dir="$1" repo_root="$2" force="$3" dry_run="$4"
+    if ! declare -F agents_install >/dev/null 2>&1; then
+        log_warning "agents.sh not loaded — skipping agent-file refresh"
+        return 0
+    fi
+    if [[ "$dry_run" = "1" ]]; then
+        log_info "[dry-run] Would refresh agent files in $target_dir"
+        return 0
+    fi
+    local force_flag=""
+    [[ "$force" = "1" ]] && force_flag="--force"
+    log_info "Refreshing AI agent files..."
+    agents_install "$target_dir" "$repo_root" $force_flag || true
+}
+
+# Compare a workflow file in target_dir vs theme template — list
+# differences so user can decide whether to merge.
+_upgrade_check_workflows() {
+    local target_dir="$1" repo_root="$2"
+    local wf_dir="$target_dir/.github/workflows"
+    [[ -d "$wf_dir" ]] || return 0
+    local f base tpl
+    log_info "Checking .github/workflows/ for theme-managed files..."
+    local found=0
+    for f in "$wf_dir"/*.yml "$wf_dir"/*.yaml; do
+        [[ -f "$f" ]] || continue
+        base="$(basename "$f")"
+        # Look for a matching template under templates/deploy/*/
+        for tpl in "$repo_root/templates/deploy"/*/"$base.template" \
+                   "$repo_root/templates/deploy"/*/"$base"; do
+            [[ -f "$tpl" ]] || continue
+            found=$((found+1))
+            if diff -q "$f" "$tpl" >/dev/null 2>&1; then
+                log_success "  $base — up to date"
+            else
+                log_warning "  $base — differs from theme template"
+                log_info "    Compare: diff $f $tpl"
+            fi
+            break
+        done
+    done
+    [[ "$found" = "0" ]] && log_info "  No theme-managed workflows detected"
+}
+
+# Public entrypoint.
+upgrade_run() {
+    local target_dir="$1" repo_root="$2"
+    shift 2 || true
+
+    local from_version="" force=0 dry_run=0 auto_accept=0
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --from)        from_version="${2:-}"; shift ;;
+            -f|--force)    force=1 ;;
+            -n|--dry-run)  dry_run=1 ;;
+            --auto-accept) auto_accept=1 ;;
+            *) log_warning "upgrade_run: ignoring unknown flag: $1" ;;
+        esac
+        shift
+    done
+
+    if [[ ! -d "$target_dir" ]]; then
+        log_error "Target directory does not exist: $target_dir"
+        return 1
+    fi
+
+    local installed_version theme_version
+    installed_version="${from_version:-$(_upgrade_detect_installed "$target_dir")}"
+    theme_version="$(_upgrade_theme_version "$repo_root")"
+
+    log_info "🔧 Upgrading site at: $target_dir"
+    log_info "  From version: $installed_version"
+    log_info "  To   version: $theme_version"
+    [[ "$dry_run" = "1" ]] && log_warning "  Mode: dry-run (no files will be changed)"
+    echo
+
+    if [[ "$installed_version" = "$theme_version" ]] && [[ "$force" != "1" ]]; then
+        log_success "Already on $theme_version. Use --force to re-run anyway."
+        return 0
+    fi
+
+    # Confirmation gate (skipped when --auto-accept or --dry-run)
+    if [[ "$auto_accept" != "1" ]] && [[ "$dry_run" != "1" ]]; then
+        printf "Proceed with upgrade? [y/N] "
+        local reply
+        read -r reply || reply=""
+        case "$reply" in
+            y|Y|yes|YES) ;;
+            *) log_warning "Upgrade cancelled by user."; return 0 ;;
+        esac
+    fi
+
+    # 1. Refresh agent files (always additive/safe)
+    _upgrade_refresh_agents "$target_dir" "$repo_root" "$force" "$dry_run"
+    echo
+
+    # 2. Check workflows (read-only — never auto-overwrite)
+    _upgrade_check_workflows "$target_dir" "$repo_root"
+    echo
+
+    # 3. Write/update marker (only if not dry-run)
+    _upgrade_write_marker "$target_dir" "$theme_version" "$dry_run"
+    echo
+
+    log_success "Upgrade complete."
+    log_info "Next steps:"
+    log_info "  1. Run 'install doctor' to verify environment"
+    log_info "  2. Review any workflow files flagged above"
+    log_info "  3. Check CHANGELOG.md in the theme repo for breaking changes"
+    return 0
+}