jekyll-theme-zer0 0.7.2 → 0.8.1

data/scripts/analyze-commits.sh

@@ -0,0 +1,313 @@
+#!/bin/bash
+
+# Commit Analysis Script for Automated Version Bumping
+# Analyzes git commits to determine appropriate semantic version bump
+# Usage: ./scripts/analyze-commits.sh [commit-range]
+# Output: patch|minor|major|none
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Default values
+COMMIT_RANGE="${1:-HEAD~1..HEAD}"
+DEBUG=${DEBUG:-false}
+
+# Logging functions
+log_debug() {
+    if [[ "$DEBUG" == "true" ]]; then
+        echo -e "${CYAN}[DEBUG]${NC} $1" >&2
+    fi
+}
+
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1" >&2
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1" >&2
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1" >&2
+}
+
+# Function to analyze individual commit
+analyze_commit() {
+    local commit_hash="$1"
+    local commit_message
+    local commit_files
+    local bump_level="none"
+    
+    commit_message=$(git log --format="%s%n%b" -n 1 "$commit_hash")
+    commit_files=$(git diff-tree --no-commit-id --name-only -r "$commit_hash" 2>/dev/null || echo "")
+    
+    log_debug "Analyzing commit: $commit_hash"
+    log_debug "Message: $(echo "$commit_message" | head -1)"
+    
+    # Check for breaking changes (MAJOR)
+    if echo "$commit_message" | grep -qi "BREAKING CHANGE\|breaking:"; then
+        echo "major"
+        return 0
+    fi
+    
+    # Check for major version indicators in commit message
+    if echo "$commit_message" | grep -qE "^(major|MAJOR|breaking|BREAKING)[\s:]"; then
+        echo "major"
+        return 0
+    fi
+    
+    # Check commit message patterns for conventional commits
+    local subject_line=$(echo "$commit_message" | head -1)
+    
+    # MAJOR changes
+    if echo "$subject_line" | grep -qE "^(revert|remove|delete)[\s:].*[Bb]reaking"; then
+        echo "major"
+        return 0
+    fi
+    
+    # MINOR changes (new features)
+    if echo "$subject_line" | grep -qE "^(feat|feature|add|new)[\s:]"; then
+        echo "minor"
+        return 0
+    fi
+    
+    # MINOR changes - significant additions
+    if echo "$subject_line" | grep -qE "^(enhance|improve|update)[\s:].*[Ff]eature"; then
+        echo "minor"
+        return 0
+    fi
+    
+    # PATCH changes (bug fixes, small improvements)
+    if echo "$subject_line" | grep -qE "^(fix|bug|patch|hotfix|chore|docs|style|refactor|test|perf)[\s:]"; then
+        echo "patch"
+        return 0
+    fi
+    
+    # PATCH changes - maintenance and small improvements
+    if echo "$subject_line" | grep -qE "^(update|improve|enhance|optimize|clean)[\s:]"; then
+        echo "patch"
+        return 0
+    fi
+    
+    # File-based analysis for changes without conventional commit messages
+    if [[ -n "$commit_files" ]]; then
+        local critical_files=0
+        local feature_files=0
+        local patch_files=0
+        
+        while IFS= read -r file; do
+            [[ -z "$file" ]] && continue
+            
+            log_debug "Analyzing file: $file"
+            
+            # Critical/breaking change files (MAJOR)
+            if echo "$file" | grep -qE "(Gemfile|gemspec|_config\.yml|docker-compose\.yml|Dockerfile)$"; then
+                ((critical_files++))
+                log_debug "Critical file detected: $file"
+            
+            # Feature files (MINOR)  
+            elif echo "$file" | grep -qE "(_layouts/|_includes/|assets/|pages/.*\.md$|\.rb$|\.js$)"; then
+                ((feature_files++))
+                log_debug "Feature file detected: $file"
+            
+            # Documentation and minor files (PATCH)
+            elif echo "$file" | grep -qE "(README|CHANGELOG|\.md$|\.txt$|\.yml$|\.yaml$|test/)"; then
+                ((patch_files++))
+                log_debug "Patch file detected: $file"
+            fi
+        done <<< "$commit_files"
+        
+        # Determine bump level based on file analysis
+        if [[ $critical_files -gt 0 ]]; then
+            # But only if there are significant changes to critical files
+            local lines_changed=$(git diff --shortstat "$commit_hash^" "$commit_hash" 2>/dev/null | grep -oE '[0-9]+ insertion|[0-9]+ deletion' | grep -oE '[0-9]+' | paste -sd+ | bc 2>/dev/null || echo "0")
+            if [[ $lines_changed -gt 10 ]]; then
+                echo "minor"  # Significant changes to critical files = minor
+                return 0
+            else
+                echo "patch"  # Small changes to critical files = patch
+                return 0
+            fi
+        elif [[ $feature_files -gt 0 ]]; then
+            echo "patch"  # Changes to feature files without explicit feat: = patch
+            return 0
+        elif [[ $patch_files -gt 0 ]]; then
+            echo "patch"
+            return 0
+        fi
+    fi
+    
+    # If we reach here, no clear classification - default to patch for any real changes
+    if [[ -n "$commit_files" ]]; then
+        echo "patch"
+    else
+        echo "none"
+    fi
+}
+
+# Function to determine highest bump level from multiple commits
+determine_overall_bump() {
+    local commits=("$@")
+    local highest_bump="none"
+    local patch_count=0
+    local minor_count=0
+    local major_count=0
+    
+    log_info "Analyzing ${#commits[@]} commits for version bump determination"
+    
+    for commit in "${commits[@]}"; do
+        local bump_level
+        bump_level=$(analyze_commit "$commit")
+        
+        log_debug "Commit $commit: $bump_level"
+        
+        case "$bump_level" in
+            "major")
+                ((major_count++))
+                highest_bump="major"
+                ;;
+            "minor")
+                ((minor_count++))
+                if [[ "$highest_bump" != "major" ]]; then
+                    highest_bump="minor"
+                fi
+                ;;
+            "patch")
+                ((patch_count++))
+                if [[ "$highest_bump" == "none" ]]; then
+                    highest_bump="patch"
+                fi
+                ;;
+        esac
+    done
+    
+    log_info "Bump analysis summary:"
+    log_info "  - Major changes: $major_count"
+    log_info "  - Minor changes: $minor_count"  
+    log_info "  - Patch changes: $patch_count"
+    log_info "  - Overall recommendation: $highest_bump"
+    
+    echo "$highest_bump"
+}
+
+# Main execution
+main() {
+    local commit_range="$COMMIT_RANGE"
+    
+    log_info "Analyzing commits in range: $commit_range"
+    
+    # Validate git repository
+    if ! git rev-parse --git-dir > /dev/null 2>&1; then
+        log_error "Not in a git repository"
+        exit 1
+    fi
+    
+    # Get list of commits in range
+    local commits
+    if ! commits=($(git rev-list --reverse "$commit_range" 2>/dev/null)); then
+        log_warning "No commits found in range: $commit_range"
+        echo "none"
+        exit 0
+    fi
+    
+    if [[ ${#commits[@]} -eq 0 ]]; then
+        log_warning "No commits to analyze"
+        echo "none"
+        exit 0
+    fi
+    
+    # Filter out merge commits and automated commits
+    local filtered_commits=()
+    for commit in "${commits[@]}"; do
+        local commit_subject
+        commit_subject=$(git log --format="%s" -n 1 "$commit")
+        
+        # Skip merge commits
+        if echo "$commit_subject" | grep -qE "^Merge (branch|pull request|remote-tracking branch)"; then
+            log_debug "Skipping merge commit: $commit"
+            continue
+        fi
+        
+        # Skip automated commits (version bumps, changelog updates)
+        if echo "$commit_subject" | grep -qE "^(chore: bump version|chore: update changelog|Automated|Auto-update)"; then
+            log_debug "Skipping automated commit: $commit"
+            continue
+        fi
+        
+        # Skip commits that only modify ignored files
+        local commit_files
+        commit_files=$(git diff-tree --no-commit-id --name-only -r "$commit" 2>/dev/null || echo "")
+        
+        local has_significant_files=false
+        while IFS= read -r file; do
+            [[ -z "$file" ]] && continue
+            
+            # Skip if only changelog, version files, or workflow files changed
+            if ! echo "$file" | grep -qE "^(CHANGELOG\.md|lib/.*version\.rb|package\.json|\.github/workflows/)$"; then
+                has_significant_files=true
+                break
+            fi
+        done <<< "$commit_files"
+        
+        if [[ "$has_significant_files" == "true" ]]; then
+            filtered_commits+=("$commit")
+        else
+            log_debug "Skipping commit with only version/changelog files: $commit"
+        fi
+    done
+    
+    if [[ ${#filtered_commits[@]} -eq 0 ]]; then
+        log_info "No significant commits found after filtering"
+        echo "none"
+        exit 0
+    fi
+    
+    log_info "Analyzing ${#filtered_commits[@]} significant commits (filtered from ${#commits[@]} total)"
+    
+    # Determine the appropriate version bump
+    determine_overall_bump "${filtered_commits[@]}"
+}
+
+# Show usage if requested
+if [[ "${1:-}" == "--help" ]] || [[ "${1:-}" == "-h" ]]; then
+    cat << EOF
+Commit Analysis Script for Automated Version Bumping
+
+USAGE:
+    $0 [commit-range]
+
+ARGUMENTS:
+    commit-range    Git commit range to analyze (default: HEAD~1..HEAD)
+
+OUTPUT:
+    patch           Bug fixes, documentation, small improvements
+    minor           New features, enhancements
+    major           Breaking changes, major refactors
+    none            No version bump needed
+
+EXAMPLES:
+    $0                          # Analyze last commit
+    $0 HEAD~5..HEAD            # Analyze last 5 commits  
+    $0 v1.0.0..HEAD            # Analyze since last tag
+
+ENVIRONMENT:
+    DEBUG=true                  # Enable debug output
+
+CONVENTIONAL COMMIT PATTERNS:
+    feat:, feature:, add:       → minor
+    fix:, bug:, patch:          → patch
+    BREAKING CHANGE, breaking:  → major
+    chore:, docs:, style:       → patch
+EOF
+    exit 0
+fi
+
+# Execute main function
+main "$@"

data/scripts/build

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Simplified build command for zer0-mistakes Jekyll theme
+# Usage: ./scripts/build [options]
+#
+# Quick gem building without the full release workflow.
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/lib"
+
+# Source required libraries
+source "$LIB_DIR/common.sh"
+source "$LIB_DIR/validation.sh"
+source "$LIB_DIR/version.sh"
+source "$LIB_DIR/gem.sh"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            export DRY_RUN=true
+            shift
+            ;;
+        --verbose)
+            export VERBOSE=true
+            shift
+            ;;
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        *)
+            error "Unknown option: $1 (use --help for usage)"
+            ;;
+    esac
+done
+
+# Show usage
+show_usage() {
+    cat << EOF
+🔨 Simplified Build Command for zer0-mistakes
+
+USAGE:
+    ./scripts/build [OPTIONS]
+
+DESCRIPTION:
+    Builds the Jekyll theme gem without running the full release workflow.
+    Useful for testing gem packaging or preparing for manual publication.
+
+OPTIONS:
+    --dry-run     Preview build without creating files
+    --verbose     Show detailed debug output
+    --help, -h    Show this help message
+
+EXAMPLES:
+    ./scripts/build                # Build gem with current version
+    ./scripts/build --dry-run      # Preview what would be built
+    ./scripts/build --verbose      # Build with debug output
+
+ENVIRONMENT VARIABLES:
+    DRY_RUN=true     Enable dry run mode
+    VERBOSE=true     Enable debug output
+
+OUTPUT:
+    Creates: jekyll-theme-zer0-VERSION.gem in current directory
+
+For full release workflow, use: ./scripts/release
+EOF
+}
+
+# Main build workflow
+main() {
+    print_header "🔨 Gem Build"
+    
+    # Step 1: Basic validation (no RubyGems auth needed for build)
+    step "Validating environment..."
+    validate_git_repo
+    validate_required_files
+    validate_gemspec
+    success "Environment validated"
+    echo ""
+    
+    # Step 2: Get current version
+    step "Reading version..."
+    local version
+    version=$(get_current_version)
+    info "Current version: $version"
+    info "Gem file: jekyll-theme-zer0-${version}.gem"
+    echo ""
+    
+    # Step 3: Build gem
+    build_gem "$version"
+    echo ""
+    
+    # Success summary
+    if [[ "$DRY_RUN" != "true" ]]; then
+        print_summary "Build Complete" \
+            "✅ Built: jekyll-theme-zer0-${version}.gem" \
+            "" \
+            "Next steps:" \
+            "  • Test: gem install jekyll-theme-zer0-${version}.gem" \
+            "  • Publish: gem push jekyll-theme-zer0-${version}.gem" \
+            "  • Or use: ./scripts/release for full workflow"
+    else
+        info "Dry run complete - no files created"
+    fi
+    
+    success "Build completed successfully!"
+}
+
+# Run main function
+main "$@"

data/scripts/build.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# DEPRECATED: This script is deprecated and will be removed in v0.8.0
+# Please use the new simplified build command instead.
+
+set -e
+
+# Colors
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+echo -e "${YELLOW}╔════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${YELLOW}║  ⚠️  DEPRECATION WARNING                                   ║${NC}"
+echo -e "${YELLOW}╚════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "${YELLOW}This script (build.sh) is deprecated and will be removed in v0.8.0${NC}"
+echo ""
+echo -e "Please use the new simplified command instead:"
+echo -e "  ${CYAN}./scripts/build${NC} [options]"
+echo ""
+echo -e "The new command is:"
+echo -e "  ✅ Simpler and more focused"
+echo -e "  ✅ Uses modular libraries"
+echo -e "  ✅ Better error handling"
+echo -e "  ✅ Fully tested"
+echo ""
+echo -e "${YELLOW}Redirecting to new command in 3 seconds...${NC}"
+sleep 3
+echo ""
+
+# Redirect to new command
+exec "$(dirname "$0")/build" "$@"

data/scripts/build.sh.legacy

@@ -0,0 +1,174 @@
+#!/bin/bash
+
+# Build and publish script for zer0-mistakes Jekyll theme
+# Usage: ./scripts/build.sh [--publish] [--dry-run]
+
+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
+
+# Default values
+PUBLISH=false
+DRY_RUN=false
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --publish)
+            PUBLISH=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        *)
+            echo -e "${RED}Unknown option: $1${NC}"
+            exit 1
+            ;;
+    esac
+done
+
+# Function to log messages
+log() {
+    echo -e "${GREEN}[BUILD]${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"
+}
+
+# Check if gemspec exists
+if [[ ! -f "jekyll-theme-zer0.gemspec" ]]; then
+    error "jekyll-theme-zer0.gemspec not found"
+fi
+
+# Check if package.json exists
+if [[ ! -f "package.json" ]]; then
+    error "package.json not found"
+fi
+
+# Get version from package.json
+VERSION=$(jq -r '.version' package.json)
+if [[ "$VERSION" == "null" ]]; then
+    error "Could not read version from package.json"
+fi
+
+log "Building jekyll-theme-zer0 version $VERSION"
+
+# Create build directory
+log "Creating build directory..."
+mkdir -p build
+
+# Clean up old gem files
+log "Cleaning up old gem files..."
+rm -f jekyll-theme-zer0-*.gem
+rm -f build/jekyll-theme-zer0-*.gem
+
+# Validate dependencies
+log "Checking dependencies..."
+if ! command -v bundle &> /dev/null; then
+    error "Bundler is not installed. Run 'gem install bundler' first."
+fi
+
+if ! command -v jq &> /dev/null; then
+    error "jq is not installed. Run 'brew install jq' (macOS) or appropriate package manager."
+fi
+
+# Run bundle install to ensure dependencies are up to date
+log "Installing/updating dependencies..."
+if [[ "$DRY_RUN" != true ]]; then
+    bundle install
+fi
+
+# Validate gemspec
+log "Validating gemspec..."
+if [[ "$DRY_RUN" != true ]]; then
+    ruby -c jekyll-theme-zer0.gemspec > /dev/null
+    info "✓ Gemspec is valid"
+fi
+
+# Build the gem
+log "Building gem..."
+if [[ "$DRY_RUN" == true ]]; then
+    log "Dry run mode - would build jekyll-theme-zer0-${VERSION}.gem"
+else
+    if gem build jekyll-theme-zer0.gemspec; then
+        # Move gem to build directory
+        mv jekyll-theme-zer0-${VERSION}.gem build/
+        info "✓ Successfully built jekyll-theme-zer0-${VERSION}.gem"
+    else
+        error "Failed to build gem"
+    fi
+fi
+
+# List gem contents for verification
+if [[ "$DRY_RUN" != true ]] && [[ -f "build/jekyll-theme-zer0-${VERSION}.gem" ]]; then
+    log "Gem contents:"
+    # Use tar to list contents since gem contents only works for installed gems
+    tar -tzf build/jekyll-theme-zer0-${VERSION}.gem | head -20
+    echo "..."
+    echo "Total files: $(tar -tzf build/jekyll-theme-zer0-${VERSION}.gem | wc -l)"
+fi
+
+# Check if we should publish
+if [[ "$PUBLISH" == true ]]; then
+    if [[ "$DRY_RUN" == true ]]; then
+        log "Dry run mode - would publish jekyll-theme-zer0-${VERSION}.gem to RubyGems"
+    else
+        log "Publishing gem to RubyGems..."
+        
+        # Check if user is authenticated with RubyGems
+        if [[ ! -f ~/.gem/credentials ]]; then
+            error "Not authenticated with RubyGems. Run 'gem signin' first."
+        fi
+        
+        # Check if this version already exists on RubyGems
+        if gem list --remote jekyll-theme-zer0 | grep -q "jekyll-theme-zer0 (${VERSION})"; then
+            warn "Version ${VERSION} already exists on RubyGems"
+            echo -e "${YELLOW}You need to bump the version first. Use ./scripts/version.sh --bump [--major|--minor|--patch]${NC}"
+            error "Cannot republish existing version ${VERSION}"
+        fi
+        
+        # Confirm publication
+        echo -e "${YELLOW}Are you sure you want to publish jekyll-theme-zer0-${VERSION}.gem to RubyGems? (y/N)${NC}"
+        read -r response
+        if [[ "$response" =~ ^[Yy]$ ]]; then
+            if gem push build/jekyll-theme-zer0-${VERSION}.gem; then
+                info "✓ Successfully published jekyll-theme-zer0-${VERSION}.gem"
+                log "Gem is now available at: https://rubygems.org/gems/jekyll-theme-zer0"
+            else
+                error "Failed to publish gem"
+            fi
+        else
+            log "Publication cancelled"
+        fi
+    fi
+else
+    log "Build complete! Gem file: jekyll-theme-zer0-${VERSION}.gem"
+    log "To publish, run: ./scripts/build.sh --publish"
+fi
+
+# Cleanup option
+if [[ "$PUBLISH" == true ]] && [[ "$DRY_RUN" != true ]]; then
+    echo -e "${YELLOW}Remove local gem file? (y/N)${NC}"
+    read -r response
+    if [[ "$response" =~ ^[Yy]$ ]]; then
+        rm -f build/jekyll-theme-zer0-${VERSION}.gem
+        log "Local gem file removed"
+    fi
+fi