jekyll-theme-zer0 0.10.6 → 0.15.2

data/scripts/lib/changelog.sh

@@ -2,14 +2,7 @@
 
 # Changelog generation library for zer0-mistakes release scripts
 # Provides automatic changelog generation from git commit history
-
-# Check Bash version (need 4+ for associative arrays)
-if [[ "${BASH_VERSINFO[0]}" -lt 4 ]]; then
-    echo "[ERROR] This script requires Bash 4.0 or higher (current: ${BASH_VERSION})" >&2
-    echo "[INFO] On macOS, install via: brew install bash" >&2
-    echo "[INFO] Then update scripts to use: #!/usr/local/bin/bash" >&2
-    exit 1
-fi
+# Compatible with Bash 3.2+ (macOS default) and Bash 4+
 
 # Source common utilities
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -119,18 +112,19 @@ generate_changelog() {
         return 0
     fi
     
-    # Parse and categorize commits
-    declare -A categories
-    categories=(
-        ["breaking"]=""
-        ["added"]=""
-        ["changed"]=""
-        ["deprecated"]=""
-        ["removed"]=""
-        ["fixed"]=""
-        ["security"]=""
-        ["other"]=""
-    )
+    # Parse and categorize commits using parallel indexed arrays (Bash 3.2 compatible)
+    # Category names in order
+    local category_names=("breaking" "added" "changed" "deprecated" "removed" "fixed" "security" "other")
+    
+    # Initialize category content arrays
+    local cat_breaking=""
+    local cat_added=""
+    local cat_changed=""
+    local cat_deprecated=""
+    local cat_removed=""
+    local cat_fixed=""
+    local cat_security=""
+    local cat_other=""
     
     local commit_count=0
     while IFS='|' read -r hash subject author date; do
@@ -176,10 +170,41 @@ generate_changelog() {
         local clean_msg
         clean_msg=$(clean_commit_message "$subject")
         
-        if [[ -n "${categories[$category]}" ]]; then
-            categories[$category]+=$'\n'
-        fi
-        categories[$category]+="- $clean_msg"
+        # Append to appropriate category variable
+        case "$category" in
+            "breaking")
+                [[ -n "$cat_breaking" ]] && cat_breaking+=$'\n'
+                cat_breaking+="- $clean_msg"
+                ;;
+            "added")
+                [[ -n "$cat_added" ]] && cat_added+=$'\n'
+                cat_added+="- $clean_msg"
+                ;;
+            "changed")
+                [[ -n "$cat_changed" ]] && cat_changed+=$'\n'
+                cat_changed+="- $clean_msg"
+                ;;
+            "deprecated")
+                [[ -n "$cat_deprecated" ]] && cat_deprecated+=$'\n'
+                cat_deprecated+="- $clean_msg"
+                ;;
+            "removed")
+                [[ -n "$cat_removed" ]] && cat_removed+=$'\n'
+                cat_removed+="- $clean_msg"
+                ;;
+            "fixed")
+                [[ -n "$cat_fixed" ]] && cat_fixed+=$'\n'
+                cat_fixed+="- $clean_msg"
+                ;;
+            "security")
+                [[ -n "$cat_security" ]] && cat_security+=$'\n'
+                cat_security+="- $clean_msg"
+                ;;
+            "other")
+                [[ -n "$cat_other" ]] && cat_other+=$'\n'
+                cat_other+="- $clean_msg"
+                ;;
+        esac
         
     done <<< "$commits_raw"
     
@@ -192,39 +217,46 @@ generate_changelog() {
     
     changelog_entry+="## [$new_version] - $date"$'\n\n'
     
-    # Add sections in order
-    for category in "breaking" "added" "changed" "deprecated" "removed" "fixed" "security" "other"; do
-        if [[ -n "${categories[$category]}" ]]; then
-            case "$category" in
-                "breaking")
-                    changelog_entry+="### ⚠️  BREAKING CHANGES"$'\n'
-                    ;;
-                "added")
-                    changelog_entry+="### Added"$'\n'
-                    ;;
-                "changed")
-                    changelog_entry+="### Changed"$'\n'
-                    ;;
-                "deprecated")
-                    changelog_entry+="### Deprecated"$'\n'
-                    ;;
-                "removed")
-                    changelog_entry+="### Removed"$'\n'
-                    ;;
-                "fixed")
-                    changelog_entry+="### Fixed"$'\n'
-                    ;;
-                "security")
-                    changelog_entry+="### Security"$'\n'
-                    ;;
-                "other")
-                    changelog_entry+="### Other"$'\n'
-                    ;;
-            esac
-            
-            changelog_entry+="${categories[$category]}"$'\n\n'
-        fi
-    done
+    # Add sections in order (using individual variables instead of associative array)
+    if [[ -n "$cat_breaking" ]]; then
+        changelog_entry+="### ⚠️  BREAKING CHANGES"$'\n'
+        changelog_entry+="$cat_breaking"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_added" ]]; then
+        changelog_entry+="### Added"$'\n'
+        changelog_entry+="$cat_added"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_changed" ]]; then
+        changelog_entry+="### Changed"$'\n'
+        changelog_entry+="$cat_changed"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_deprecated" ]]; then
+        changelog_entry+="### Deprecated"$'\n'
+        changelog_entry+="$cat_deprecated"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_removed" ]]; then
+        changelog_entry+="### Removed"$'\n'
+        changelog_entry+="$cat_removed"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_fixed" ]]; then
+        changelog_entry+="### Fixed"$'\n'
+        changelog_entry+="$cat_fixed"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_security" ]]; then
+        changelog_entry+="### Security"$'\n'
+        changelog_entry+="$cat_security"$'\n\n'
+    fi
+    
+    if [[ -n "$cat_other" ]]; then
+        changelog_entry+="### Other"$'\n'
+        changelog_entry+="$cat_other"$'\n\n'
+    fi
     
     # Preview changelog
     info "Changelog preview:"

data/scripts/lib/gem.sh

@@ -47,15 +47,27 @@ build_gem() {
         error "Gem file not found after build: $gem_file"
     fi
     
-    # Show gem info
-    local file_count
-    file_count=$(tar -tzf "$gem_file" 2>/dev/null | wc -l | tr -d ' ')
-    local file_size
-    file_size=$(ls -lh "$gem_file" | awk '{print $5}')
+    # Show gem info (with error handling for tar extraction)
+    local file_count="unknown"
+    local file_size="unknown"
+    
+    # Try to get file count (may fail on some platforms/tar versions)
+    if command -v tar &> /dev/null; then
+        file_count=$(tar -tzf "$gem_file" 2>/dev/null | wc -l | tr -d ' ') || file_count="unknown"
+    fi
+    
+    # Get file size (should always work)
+    if command -v ls &> /dev/null; then
+        file_size=$(ls -lh "$gem_file" 2>/dev/null | awk '{print $5}') || file_size="unknown"
+    fi
     
     success "Built $gem_file"
-    info "  Files: $file_count"
-    info "  Size: $file_size"
+    if [[ "$file_count" != "unknown" ]]; then
+        info "  Files: $file_count"
+    fi
+    if [[ "$file_size" != "unknown" ]]; then
+        info "  Size: $file_size"
+    fi
 }
 
 # Check if gem version exists on RubyGems

data/scripts/release

@@ -1,240 +1,11 @@
 #!/bin/bash
 
-# Simplified release command for zer0-mistakes Jekyll theme
-# Usage: ./scripts/release [patch|minor|major] [options]
-#
-# This replaces the complex gem-publish.sh with a clean, library-based approach.
+# ============================================================================
+# WRAPPER: This script forwards to scripts/bin/release
+# 
+# The canonical location is scripts/bin/release. This wrapper exists for
+# backward compatibility with existing workflows and VS Code tasks.
+# ============================================================================
 
-set -euo pipefail
-
-# Get script and library directories
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-LIB_DIR="$SCRIPT_DIR/lib"
-
-# Source all required libraries
-source "$LIB_DIR/common.sh"
-source "$LIB_DIR/validation.sh"
-source "$LIB_DIR/version.sh"
-source "$LIB_DIR/git.sh"
-source "$LIB_DIR/changelog.sh"
-source "$LIB_DIR/gem.sh"
-
-# Show usage function
-show_usage() {
-    cat << EOF
-🚀 Simplified Release Command for zer0-mistakes
-
-USAGE:
-    ./scripts/release [VERSION_TYPE] [OPTIONS]
-
-VERSION TYPES:
-    patch       Bump patch version (0.0.X) - Bug fixes (default)
-    minor       Bump minor version (0.X.0) - New features
-    major       Bump major version (X.0.0) - Breaking changes
-
-OPTIONS:
-    --dry-run              Preview changes without executing
-    --skip-tests           Skip running test suite
-    --skip-publish         Build but don't publish to RubyGems
-    --no-github-release    Skip creating GitHub release
-    --non-interactive      Run without confirmation prompts
-    --verbose              Show detailed debug output
-    --help, -h             Show this help message
-
-EXAMPLES:
-    ./scripts/release                    # Patch release (0.6.0 → 0.6.1)
-    ./scripts/release minor              # Minor release (0.6.0 → 0.7.0)
-    ./scripts/release major --dry-run    # Preview major release
-    ./scripts/release patch --skip-tests # Quick release without tests
-
-ENVIRONMENT VARIABLES:
-    DRY_RUN=true           Enable dry run mode
-    INTERACTIVE=false      Disable confirmation prompts
-    VERBOSE=true           Enable debug output
-
-WORKFLOW:
-    1. Validate environment
-    2. Calculate new version
-    3. Generate changelog from commits
-    4. Update version files
-    5. Run tests (unless --skip-tests)
-    6. Build gem
-    7. Commit and tag
-    8. Publish to RubyGems (unless --skip-publish)
-    9. Create GitHub release (unless --no-github-release)
-    10. Push changes to repository
-
-For more information, see: scripts/lib/README.md
-EOF
-}
-
-# Default configuration
-VERSION_TYPE="patch"
-SKIP_TESTS=false
-SKIP_PUBLISH=false
-SKIP_GITHUB_RELEASE=false
-SHOW_HELP=false
-
-# Parse arguments
-for arg in "$@"; do
-    case $arg in
-        --help|-h)
-            SHOW_HELP=true
-            ;;
-        patch|minor|major)
-            VERSION_TYPE="$arg"
-            ;;
-    esac
-done
-
-# Show help if requested
-if [[ "$SHOW_HELP" == "true" ]]; then
-    show_usage
-    exit 0
-fi
-
-# Parse remaining arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        patch|minor|major)
-            # Already handled above
-            shift
-            ;;
-        --help|-h)
-            # Already handled above
-            shift
-            ;;
-        --dry-run)
-            export DRY_RUN=true
-            shift
-            ;;
-        --skip-tests)
-            SKIP_TESTS=true
-            shift
-            ;;
-        --skip-publish)
-            SKIP_PUBLISH=true
-            shift
-            ;;
-        --no-github-release)
-            SKIP_GITHUB_RELEASE=true
-            shift
-            ;;
-        --non-interactive)
-            export INTERACTIVE=false
-            shift
-            ;;
-        --verbose)
-            export VERBOSE=true
-            shift
-            ;;
-        *)
-            error "Unknown option: $1 (use --help for usage)"
-            ;;
-    esac
-done
-
-# Main release workflow
-main() {
-    print_header "🚀 Release Automation"
-    
-    # Show configuration
-    info "Version type: $VERSION_TYPE"
-    info "Dry run: ${DRY_RUN:-false}"
-    info "Interactive: ${INTERACTIVE:-true}"
-    echo ""
-    
-    # Step 1: Validate environment
-    validate_environment "$SKIP_PUBLISH" "$SKIP_GITHUB_RELEASE"
-    
-    # Step 2: Version calculation
-    step "Calculating new version..."
-    local current_version
-    current_version=$(get_current_version)
-    info "Current version: $current_version"
-    
-    local new_version
-    new_version=$(calculate_new_version "$current_version" "$VERSION_TYPE")
-    info "New version: $new_version"
-    
-    # Confirm before proceeding
-    if [[ "$INTERACTIVE" == "true" ]] && [[ "$DRY_RUN" != "true" ]]; then
-        echo ""
-        if ! confirm "Proceed with release $current_version → $new_version?"; then
-            warn "Release cancelled by user"
-            exit 0
-        fi
-    fi
-    echo ""
-    
-    # Step 3: Generate changelog
-    step "Generating changelog..."
-    local last_tag
-    last_tag=$(get_last_version_tag)
-    generate_changelog "$new_version" "$last_tag" "HEAD"
-    echo ""
-    
-    # Step 4: Update version files
-    update_version_files "$new_version"
-    echo ""
-    
-    # Step 5: Run tests
-    if [[ "$SKIP_TESTS" != "true" ]]; then
-        run_tests
-        echo ""
-    else
-        warn "Skipping tests (--skip-tests specified)"
-        echo ""
-    fi
-    
-    # Step 6: Build gem
-    build_gem "$new_version"
-    echo ""
-    
-    # Step 7: Commit and tag
-    commit_and_tag "$new_version"
-    echo ""
-    
-    # Step 8: Publish gem
-    if [[ "$SKIP_PUBLISH" != "true" ]]; then
-        publish_gem "$new_version"
-        echo ""
-    else
-        warn "Skipping RubyGems publication (--skip-publish specified)"
-        echo ""
-    fi
-    
-    # Step 9: Create GitHub release
-    if [[ "$SKIP_GITHUB_RELEASE" != "true" ]]; then
-        create_github_release "$new_version"
-        echo ""
-    else
-        warn "Skipping GitHub release (--no-github-release specified)"
-        echo ""
-    fi
-    
-    # Step 10: Push changes
-    push_changes
-    echo ""
-    
-    # Step 11: Cleanup
-    cleanup_gem_files "$new_version"
-    echo ""
-    
-    # Success summary
-    print_header "✅ Release Complete!"
-    
-    print_summary "Release $new_version" \
-        "Version: $current_version → $new_version" \
-        "Type: $VERSION_TYPE bump" \
-        "Tag: v$new_version" \
-        "" \
-        "📦 RubyGems: https://rubygems.org/gems/jekyll-theme-zer0/versions/$new_version" \
-        "🏷️  GitHub: https://github.com/bamr87/zer0-mistakes/releases/tag/v$new_version" \
-        "📂 Repository: https://github.com/bamr87/zer0-mistakes"
-    
-    success "Release workflow completed successfully!"
-}
-
-# Run main function
-main "$@"
+exec "$SCRIPT_DIR/bin/release" "$@"

data/scripts/setup.sh

@@ -1,155 +1,11 @@
 #!/bin/bash
 
-# Development setup script for zer0-mistakes Jekyll theme
-# Usage: ./scripts/setup.sh
-
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Function to log messages
-log() {
-    echo -e "${GREEN}[SETUP]${NC} $1"
-}
-
-warn() {
-    echo -e "${YELLOW}[WARNING]${NC} $1"
-}
-
-error() {
-    echo -e "${RED}[ERROR]${NC} $1"
-    exit 1
-}
-
-info() {
-    echo -e "${BLUE}[INFO]${NC} $1"
-}
-
-log "Setting up zer0-mistakes Jekyll theme development environment..."
-
-# Check system requirements
-log "Checking system requirements..."
-
-# Check Ruby
-if ! command -v ruby &> /dev/null; then
-    error "Ruby is not installed. Please install Ruby >= 2.7.0"
-fi
-
-RUBY_VERSION=$(ruby --version | awk '{print $2}')
-log "Ruby version: $RUBY_VERSION"
-
-# Check Bundler
-if ! command -v bundle &> /dev/null; then
-    log "Installing Bundler..."
-    gem install bundler
-fi
-
-# Check jq
-if ! command -v jq &> /dev/null; then
-    warn "jq is not installed. Installing via Homebrew (macOS)..."
-    if command -v brew &> /dev/null; then
-        brew install jq
-    else
-        error "jq is required but not installed. Please install jq manually."
-    fi
-fi
-
-# Check Git
-if ! command -v git &> /dev/null; then
-    error "Git is not installed"
-fi
-
-# Install dependencies
-log "Installing Ruby dependencies..."
-bundle install
-
-# Make scripts executable
-log "Making scripts executable..."
-chmod +x scripts/*.sh
-
-# Validate gemspec
-log "Validating gemspec..."
-if gem specification jekyll-theme-zer0.gemspec > /dev/null 2>&1; then
-    info "✓ Gemspec is valid"
-else
-    error "Gemspec validation failed"
-fi
-
-# Create CHANGELOG if it doesn't exist
-if [[ ! -f "CHANGELOG.md" ]]; then
-    log "Creating CHANGELOG.md..."
-    cat > CHANGELOG.md << 'EOF'
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-- Initial development setup
-
-EOF
-fi
-
-# Create .gitignore additions for gem development
-if ! grep -q "*.gem" .gitignore 2>/dev/null; then
-    log "Adding gem development entries to .gitignore..."
-    cat >> .gitignore << 'EOF'
-
-# Gem development
-*.gem
-.bundle/
-vendor/
-pkg/
-EOF
-fi
-
-# Setup Git hooks (optional)
-if [[ -d ".git" ]]; then
-    log "Setting up Git hooks..."
-    mkdir -p .git/hooks
-    
-    # Pre-commit hook to run basic validations
-    cat > .git/hooks/pre-commit << 'EOF'
-#!/bin/bash
-# Pre-commit hook for zer0-mistakes Jekyll theme
-
-echo "Running pre-commit validations..."
-
-# Validate gemspec
-if ! gem specification jekyll-theme-zer0.gemspec > /dev/null 2>&1; then
-    echo "❌ Gemspec validation failed"
-    exit 1
-fi
-
-# Check if package.json version is valid
-if ! jq -e '.version' package.json > /dev/null 2>&1; then
-    echo "❌ Invalid version in package.json"
-    exit 1
-fi
-
-echo "✅ Pre-commit validations passed"
-EOF
-    chmod +x .git/hooks/pre-commit
-fi
-
-log "Setup complete!"
-log ""
-log "Available commands:"
-log "  ./scripts/version.sh [patch|minor|major]  - Bump version"
-log "  ./scripts/build.sh [--publish]            - Build (and optionally publish) gem"
-log "  ./scripts/test.sh                         - Run tests"
-log ""
-log "Development workflow:"
-log "1. Make your changes"
-log "2. Run ./scripts/test.sh to validate"
-log "3. Run ./scripts/version.sh to bump version"
-log "4. Run ./scripts/build.sh --publish to release"
+# ============================================================================
+# WRAPPER: This script forwards to scripts/utils/setup
+# 
+# The canonical location is scripts/utils/setup. This wrapper exists for
+# backward compatibility with existing workflows.
+# ============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec "$SCRIPT_DIR/utils/setup" "$@"

data/scripts/test/lib/run_tests.sh

@@ -3,8 +3,7 @@
 # Test runner for library unit tests
 # Usage: ./scripts/test/lib/run_tests.sh
 #
-# Note: Requires Bash 4.0+ (for associative arrays in changelog.sh)
-# On macOS: brew install bash
+# Compatible with Bash 3.2+ (macOS default) and Bash 4+
 
 # Note: We intentionally don't use set -e here because test assertions 
 # may return non-zero and we want to continue running tests