jekyll-theme-zer0 0.8.1 → 0.10.3

data/scripts/utils/analyze-commits

@@ -0,0 +1,300 @@
+#!/bin/bash
+
+# Commit Analysis Script for Automated Version Bumping
+# Analyzes git commits to determine appropriate semantic version bump
+# Usage: ./scripts/utils/analyze-commits [commit-range]
+# Output: patch|minor|major|none
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+# Default values
+COMMIT_RANGE="${1:-HEAD~1..HEAD}"
+DEBUG=${DEBUG:-false}
+
+# Override debug function to use DEBUG flag
+log_debug() {
+    if [[ "$DEBUG" == "true" ]]; then
+        debug "$1"
+    fi
+}
+
+# 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/utils/fix-markdown

@@ -0,0 +1,251 @@
+#!/usr/bin/env bash
+
+#
+# Markdown Formatting Fix Script
+# Addresses common markdown linting violations across the repository
+#
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+PROJECT_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+# Aliases for backward compatibility with logging function names
+log_info() { info "$@"; }
+log_success() { success "$@"; }
+log_warning() { warn "$@"; }
+log_error() { error "$@"; }
+
+# Function to fix common markdown issues
+fix_markdown_file() {
+    local file="$1"
+    local temp_file="${file}.tmp"
+    
+    info "Fixing markdown formatting in: $file"
+    
+    # Create backup
+    cp "$file" "${file}.backup"
+    
+    # Apply fixes using sed (macOS compatible)
+    sed -e 's/[[:space:]]*$//' \
+        -e '/^#/a\
+' \
+        -e '/^##/a\
+' \
+        -e '/^###/a\
+' \
+        -e '/^####/a\
+' \
+        -e '/^#####/a\
+' \
+        -e '/^######/a\
+' \
+        -e '/^- /i\
+' \
+        -e '/^* /i\
+' \
+        -e '/^+ /i\
+' \
+        -e '/^[0-9]/i\
+' \
+        -e 's/```$/```bash/' \
+        -e 's/^```[[:space:]]*$/```bash/' \
+        "$file" > "$temp_file"
+    
+    # Additional fixes with awk for more complex patterns
+    awk '
+    BEGIN { prev_was_heading = 0; prev_was_list = 0 }
+    
+    # Handle headings - ensure blank line before and after
+    /^#/ {
+        if (NR > 1 && prev_line != "" && !prev_was_heading) print ""
+        print $0
+        prev_was_heading = 1
+        prev_was_list = 0
+        prev_line = $0
+        next
+    }
+    
+    # Handle list items - ensure blank line before first item
+    /^[[:space:]]*[-*+]/ || /^[[:space:]]*[0-9]+\./ {
+        if (!prev_was_list && prev_line != "" && !prev_was_heading) print ""
+        print $0
+        prev_was_list = 1
+        prev_was_heading = 0
+        prev_line = $0
+        next
+    }
+    
+    # Handle code blocks - ensure they have language specification
+    /^```[[:space:]]*$/ {
+        print "```bash"
+        prev_was_heading = 0
+        prev_was_list = 0
+        prev_line = $0
+        next
+    }
+    
+    # Regular lines
+    {
+        print $0
+        prev_was_heading = 0
+        prev_was_list = 0
+        prev_line = $0
+    }
+    ' "$temp_file" > "$file"
+    
+    # Clean up
+    rm "$temp_file"
+    
+    log_success "Fixed formatting in: $file"
+}
+
+# Function to remove trailing whitespace
+remove_trailing_whitespace() {
+    local file="$1"
+    log_info "Removing trailing whitespace from: $file"
+    
+    # Remove trailing whitespace
+    sed -i '' 's/[[:space:]]*$//' "$file"
+    
+    log_success "Removed trailing whitespace from: $file"
+}
+
+# Function to fix heading punctuation
+fix_heading_punctuation() {
+    local file="$1"
+    log_info "Fixing heading punctuation in: $file"
+    
+    # Remove trailing punctuation from headings
+    sed -i '' 's/^\(#\+[[:space:]]*.*\)[.!?:;,]*[[:space:]]*$/\1/' "$file"
+    
+    log_success "Fixed heading punctuation in: $file"
+}
+
+# Function to fix emphasis formatting
+fix_emphasis_formatting() {
+    local file="$1"
+    log_info "Fixing emphasis formatting in: $file"
+    
+    # Fix common emphasis issues
+    sed -i '' \
+        -e 's/\*\*\([^*]*\) \*\*/\*\*\1\*\*/g' \
+        -e 's/\*\([^*]*\) \*/\*\1\*/g' \
+        "$file"
+    
+    log_success "Fixed emphasis formatting in: $file"
+}
+
+# Main execution function
+main() {
+    log_info "Starting markdown formatting fixes..."
+    
+    # Find all markdown files
+    local md_files
+    mapfile -t md_files < <(find "$PROJECT_ROOT" -name "*.md" \
+        -not -path "*/node_modules/*" \
+        -not -path "*/.git/*" \
+        -not -path "*/vendor/*" \
+        -not -path "*/_site/*")
+    
+    if [ ${#md_files[@]} -eq 0 ]; then
+        log_warning "No markdown files found"
+        return 0
+    fi
+    
+    log_info "Found ${#md_files[@]} markdown files to process"
+    
+    # Process each file
+    for file in "${md_files[@]}"; do
+        if [ -f "$file" ]; then
+            remove_trailing_whitespace "$file"
+            fix_heading_punctuation "$file"
+            fix_emphasis_formatting "$file"
+            fix_markdown_file "$file"
+        fi
+    done
+    
+    log_success "Completed markdown formatting fixes for ${#md_files[@]} files"
+    
+    # Provide summary
+    echo
+    log_info "Summary of fixes applied:"
+    echo "  ✓ Removed trailing whitespace"
+    echo "  ✓ Added blank lines around headings"
+    echo "  ✓ Added blank lines before list items"
+    echo "  ✓ Fixed code block language specifications"
+    echo "  ✓ Fixed heading punctuation"
+    echo "  ✓ Fixed emphasis formatting"
+    echo
+    log_info "Backup files created with .backup extension"
+    log_info "Run 'git diff' to review changes before committing"
+}
+
+# Help function
+show_help() {
+    cat << EOF
+Markdown Formatting Fix Script
+
+USAGE:
+    $0 [OPTIONS]
+
+OPTIONS:
+    -h, --help     Show this help message
+    --dry-run      Show what would be fixed without making changes
+    --file FILE    Fix only the specified file
+
+EXAMPLES:
+    $0                          # Fix all markdown files
+    $0 --file README.md         # Fix only README.md
+    $0 --dry-run               # Preview changes without applying
+
+This script fixes common markdown linting violations:
+- Trailing whitespace
+- Missing blank lines around headings
+- Missing blank lines before lists
+- Code blocks without language specification
+- Heading punctuation issues
+- Emphasis formatting problems
+
+EOF
+}
+
+# Parse command line arguments
+case "${1:-}" in
+    -h|--help)
+        show_help
+        exit 0
+        ;;
+    --dry-run)
+        log_info "DRY RUN MODE - No changes will be made"
+        # Implementation for dry run would go here
+        exit 0
+        ;;
+    --file)
+        if [ -n "${2:-}" ] && [ -f "$2" ]; then
+            log_info "Fixing single file: $2"
+            remove_trailing_whitespace "$2"
+            fix_heading_punctuation "$2"
+            fix_emphasis_formatting "$2"
+            fix_markdown_file "$2"
+            log_success "Completed fixing: $2"
+        else
+            log_error "File not found: ${2:-}"
+            exit 1
+        fi
+        exit 0
+        ;;
+    "")
+        main
+        ;;
+    *)
+        log_error "Unknown option: $1"
+        show_help
+        exit 1
+        ;;
+esac

data/scripts/utils/setup

@@ -0,0 +1,137 @@
+#!/bin/bash
+
+# Development setup script for zer0-mistakes Jekyll theme
+# Usage: ./scripts/utils/setup
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+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"