jekyll-theme-zer0 0.7.2 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 121248addc514b434e43346120d084f2d85adc56a7d42f270e3f0814e3074811
-  data.tar.gz: 0eddaa825036a05ab63eebaf333ca9e4829b133a15b1700f7f83f87b9dac0bf6
+  metadata.gz: 11f1a090a15824b7b1fc5754e858839d93318efad779deb8d63f5b5641a08f02
+  data.tar.gz: 476de246227f2f492eb142f7d4f9f0b1e20b9dc97350069bb6b3fff3ef295f8b
 SHA512:
-  metadata.gz: 5cf3ef0e1dbd0d2c71c5738e9c2bf8efe46c2b3a2a3d28fa6335665b4e1c86d4268d0554f5abc195e6e1e5e56357cfa858be9e553158d774b465b331e8b47f9c
-  data.tar.gz: 404bbdeee6fb4cf0f977b193a744462a9b2c7951fc399e127bed72a2dbc485d5f542e83d916ac622b7c01d28a81c22cbd7758fa6b44e6f03e4c46e7e1ff9b654
+  metadata.gz: 8a2aba3a52815a120646b1b094a973dd01e4c28555f37de5562a9a262d4ad6dda7944753c9f235862ef60b8ce99ad94c62b98bdabf821b983243812d07b27480
+  data.tar.gz: e54a3074c2d26c178211144219c9e934258edca74f498e073e37edc7e68d4a84d18181295d7467ac6de5647d6bc0d52e41605838171028f96b86dbbdd04caa1f

data/CHANGELOG.md

@@ -1,5 +1,247 @@
 # Changelog
 
+## [0.10.0] - 2025-11-28
+
+### Added
+
+- **New: Zero Version Pin Strategy** - Enterprise-grade dependency management paradigm
+  - Always use latest compatible versions with zero pins anywhere
+  - Fail fast in CI if incompatible → caught early, not in production
+  - Production uses immutable image tags (date+commit hash), never `:latest`
+  - Full documentation in `docs/systems/ZERO_PIN_STRATEGY.md`
+
+- **New: Docker Multi-Stage Dockerfile** (`docker/Dockerfile`)
+  - `base` stage: Ruby slim + build dependencies
+  - `dev-test` stage: Full dev/test gems for CI validation
+  - `build` stage: Production Jekyll build
+  - `production` stage: Minimal runtime for serving
+
+- **New: Docker Compose Configurations**
+  - `docker-compose.yml`: Development environment with live reload
+  - `docker-compose.test.yml`: CI testing overlay with validation
+  - `docker-compose.prod.yml`: Production with immutable tags only
+
+- **New: CI Workflow for Zero Pin Strategy** (`.github/workflows/test-latest.yml`)
+  - Builds with `--no-cache` for latest dependencies
+  - Documents resolved versions in workflow summary
+  - Tags and publishes immutable images on success
+  - Debug information on failure
+
+- **New: `.dockerignore`** - Optimized Docker build context
+  - Excludes development files, tests, logs, and build artifacts
+  - Keeps only files needed for container builds
+
+- **New: VS Code Workspace Configuration** (`zer0-mistakes.code-workspace`)
+  - Copilot settings for all file types
+  - File associations for Jekyll/Liquid
+  - Terminal environment variables for Docker
+
+### Changed
+
+- **Improved: `Gemfile`** - Refactored for zero version pin strategy
+  - Removed all version constraints
+  - Added development/test group with html-proofer, rspec, rake, rubocop
+  - Added platform-specific dependencies for Windows
+  - Comprehensive documentation comments
+
+- **Improved: `docker-compose.yml`** - Enhanced for zero pin strategy
+  - Uses custom Dockerfile instead of jekyll/jekyll image
+  - Added bundle cache volume for faster rebuilds
+  - LiveReload port (35729) exposed
+  - TTY enabled for interactive commands
+
+- **Improved: `jekyll-theme-zer0.gemspec`** - Compatibility updates
+  - Ruby requirement lowered to >= 2.7.0 (from 3.0.0) for broader compatibility
+  - Bundler dependency changed to ~> 2.3 (from >= 2.3)
+
+- **Improved: CI Workflow** (`.github/workflows/ci.yml`)
+  - Added documentation comments explaining version strategy
+  - Clarified that explicit versions are for backwards compatibility testing
+
+### Fixed
+
+- **Fixed: `scripts/generate-preview-images.sh`** - Reverted to simpler collection handling
+  - Removed dynamic collection reading (caused issues in some environments)
+  - Restored hardcoded collection list for reliability
+  - Fixed yq vs sed front matter update logic
+
+## [0.9.2] - 2025-11-28
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 509d705 fix(ci): fix false positive failure detection in test report validation
+- 77dc04b fix(ci): fix shell syntax error in test-suite validation step
+
+
+## [0.9.1] - 2025-11-27
+
+### Fixed
+
+- **CI: Test suite failures across Ruby versions** - Resolved issues causing CI failures
+  - Fixed `--skip-docker` option error by only passing it to deployment tests (not quality tests)
+  - Fixed bash arithmetic syntax error in Liquid tag validation by sanitizing grep output
+  - Added bundler 2.5 requirement to setup-ruby action for Ruby 3.0 compatibility
+
+## [0.9.0] - 2025-06-30
+
+### Changed
+
+- **Refactored: Scripts Directory Structure** - Complete reorganization for better maintainability
+  - New `bin/` directory for main entry points (`release`, `build`, `test`)
+  - New `utils/` directory for utility scripts (`setup`, `analyze-commits`, `fix-markdown`)
+  - New `features/` directory for feature-specific scripts (`generate-preview-images`, `install-preview-generator`)
+  - New `test/` directory hierarchy with `lib/`, `theme/`, and `integration/` subdirectories
+  - Unified test runner in `bin/test` that runs all test suites with single command
+
+- **Improved: Script Library Integration** - All scripts now use shared `lib/common.sh`
+  - Consistent logging functions (`log`, `info`, `success`, `warn`, `error`, `debug`)
+  - Standardized color output and formatting
+  - Removed duplicate code from individual scripts
+
+- **Updated: Documentation** - Complete rewrite of `scripts/README.md`
+  - Clear directory structure overview
+  - Quick start guide for common operations
+  - Migration table from legacy to new script locations
+  - Dependency graph for library modules
+
+### Added
+
+- **New: `bin/test` Unified Test Runner** - Single command to run all tests
+  - Supports running specific test suites (`lib`, `theme`, `integration`, `all`)
+  - Verbose output mode with `--verbose` flag
+  - Summary of passed/failed test suites
+
+- **New: `test/theme/validate`** - Theme structure validation tests
+  - Validates layouts, includes, and assets directories
+  - Sources shared library for consistent output
+
+- **New: `test/integration/auto-version`** - Auto-version integration tests
+  - Moved from `tests/` directory with updated library paths
+
+### Deprecated
+
+- **Deprecated: `scripts/version.sh`** - Now displays deprecation warning
+  - Recommends using `bin/release` for full workflow
+  - Will be removed in future release
+
+### Migration Guide
+
+| Legacy Script | New Location |
+|--------------|--------------|
+| `version.sh` | `bin/release` |
+| `setup.sh` | `utils/setup` |
+| `test.sh` | `bin/test` or `test/theme/validate` |
+| `analyze-commits.sh` | `utils/analyze-commits` |
+| `fix-markdown-format.sh` | `utils/fix-markdown` |
+| `generate-preview-images.sh` | `features/generate-preview-images` |
+| `install-preview-generator.sh` | `features/install-preview-generator` |
+
+## [0.8.2] - 2025-11-27
+
+### Changed
+
+- **Refactored: GitHub Actions Workflows** - Consolidated 5 workflows into 3 streamlined workflows
+  - Merged `auto-version-bump.yml` into `version-bump.yml` with both automatic and manual triggers
+  - Merged `gem-release.yml` and `github-release.yml` into unified `release.yml`
+  - Removed duplicate `quality` job from `ci.yml` (functionality retained in `quality-checks` job)
+  - Updated `ci.yml` build job to use `scripts/build` instead of deprecated `build.sh`
+
+- **Updated: Composite Action `prepare-release`** - Now uses `scripts/build` instead of deprecated `build.sh`
+
+### Added
+
+- **New Documentation: `.github/workflows/README.md`** - Comprehensive workflow documentation
+  - Workflow trigger flow diagram
+  - Job descriptions and timeout configurations
+  - Manual dispatch options and troubleshooting guide
+
+- **New Documentation: `.github/actions/README.md`** - Composite actions documentation
+  - Input/output specifications for all 5 actions
+  - Usage examples and best practices
+  - Action creation guide and troubleshooting
+
+### Removed
+
+- **Deleted: `auto-version-bump.yml`** - Functionality merged into `version-bump.yml`
+- **Deleted: `gem-release.yml`** - Functionality merged into `release.yml`
+- **Deleted: `github-release.yml`** - Functionality merged into `release.yml`
+- **Deleted: Deprecated wrapper scripts** - `build.sh`, `gem-publish.sh`, `release.sh` and their `.legacy` versions
+  - These were deprecated redirects to the new modular commands (`scripts/build`, `scripts/release`)
+
+## [0.8.1] - 2025-11-27
+
+### Added
+
+- **New Page: `pages/categories.md`** - Browse all categories with post counts and links
+  - Alphabetical category overview with badge sizing based on post count
+  - Post listing under each category with descriptions and dates
+  - Smooth anchor navigation between categories
+- **New Page: `posts.html`** - Paginated posts index with jekyll-paginate support
+  - Responsive 3-column card grid layout
+  - Smart pagination with ellipsis for many pages
+  - Page jump feature for quick navigation when >10 pages
+- **New Page: `index.html`** - Alternative posts index with client-side pagination
+  - Responsive 5-column compact card grid for high-density display
+  - URL hash-based page state (#page=2) for bookmarkable pages
+  - Empty state handling when no posts exist
+
+### Changed
+
+- **Enhanced: `README.md`** - Consolidated landing page content
+  - Changed layout from `default` to `landing` for proper homepage rendering
+  - Updated permalink from `/zer0/` to `/` for clean root URL
+  - Added hero_image and updated preview image
+  - Added "Welcome to Error-Free Jekyll Development" section with proven results metrics
+  - Added "Perfect For" section highlighting target audiences
+- **Enhanced: `pages/index.html`** - Improved posts archive page
+  - Responsive card grid (1→2→3→4→5 columns as screen grows)
+  - Client-side pagination (10 posts per page)
+  - Compact card design with constrained image height
+  - Category badges and post metadata display
+  - Filter buttons for Categories and Tags pages
+- **Improved: `pages/_posts/development/2025-01-22-git-workflow-best-practices.md`** - Front matter formatting standardization
+
+### Removed
+
+- **Deleted: `index.md`** - Content merged into README.md to avoid duplicate landing pages
+
+## [0.8.0] - 2025-11-27
+
+### Added
+
+- **New Feature: AI Preview Image Generator (ZER0-003)** - Automatic AI-powered preview image generation for Jekyll posts
+  - Supports OpenAI DALL-E 3, Stability AI, and local placeholder generation
+  - Configurable via `_config.yml` under `preview_images` section
+  - Default retro pixel art style with 1792x1024 landscape banners
+  - One-command remote installation for other Jekyll sites
+- **New Plugin: `_plugins/preview_image_generator.rb`** - Jekyll integration with:
+  - Liquid filters: `has_preview_image`, `preview_image_path`, `preview_filename`
+  - Liquid tags: {% raw %}`{% preview_image_status %}`, `{% preview_images_missing %}`{% endraw %}
+  - Build hook that reports missing preview images during Jekyll build
+- **New Script: `scripts/generate-preview-images.sh`** - Main CLI for image generation
+  - `--list-missing` to find posts without preview images
+  - `--dry-run` to preview without making changes
+  - `--collection` to target specific collections
+  - `--provider` to choose AI provider (openai, stability, local)
+- **New Script: `scripts/install-preview-generator.sh`** - Remote installer for other repos
+  - One-line installation: `curl -fsSL .../install-preview-generator.sh | bash`
+  - Automatic configuration, VS Code tasks, and environment setup
+- **New Script: `scripts/lib/preview_generator.py`** - Python alternative implementation
+- **New Documentation: `docs/features/preview-image-generator.md`** - Comprehensive feature documentation
+- **New Rake Tasks**: `preview:missing`, `preview:generate`, `preview:dry_run`, `preview:posts`, `preview:docs`, `preview:force`, `preview:file`
+- **New VS Code Tasks**: Four preview image tasks for IDE integration
+- **New Config Section**: `preview_images` in `_config.yml` with full customization options
+- **New Feature Entry**: ZER0-003 in `features/features.yml`
+
+### Changed
+
+- **Updated: `jekyll-theme-zer0.gemspec`** - Now includes `_plugins/` and `scripts/` directories in gem distribution
+- **Updated: `Rakefile`** - Added preview image tasks and development/test task namespaces
+- **Updated: `scripts/README.md`** - Documented new preview generator scripts
+- **Updated: `.gitignore`** - Added `.env` for API key security
+
 ## [0.7.2] - 2025-11-26
 
 ### Fixed
@@ -73,6 +315,7 @@
 ## [0.6.0] - 2025-11-22
 
 ### Added
+
 - Implement PostHog analytics and cookie consent
 - Add code copy functionality and enhance documentation structure
 - Revise copilot instructions and add comprehensive Jekyll include development guidelines
@@ -82,6 +325,7 @@
 - Enhance CI/CD testing framework with comprehensive documentation and automated workflows
 
 ### Changed
+
 - Ignore .frontmatter directory
 - Update VS Code settings
 - Documentation: Update README with new features and architecture
@@ -90,6 +334,7 @@
 - Update version control instructions and add feature documentation
 
 ### Other
+
 - Revert "Merge pull request #10 from bamr87/copilot/plan-mdx-file-handling"
 - Add Mermaid documentation and test suite, enhance site structure
 - Merge pull request #9 from bamr87/copilot/setup-copilot-instructions
@@ -101,8 +346,6 @@
 - Initial plan
 - Initial plan
 
-
-
 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/),
@@ -111,17 +354,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
+
 - Comprehensive documentation organization system in `/docs/` directory
 - Standardized templates for feature documentation, release notes, and change tracking
 - Organized directory structure for releases, features, systems, and configuration documentation
 
 ### Changed
+
 - Migrated scattered documentation files to organized structure
 - Improved documentation discoverability and maintenance
 
 ## [0.5.0] - 2025-10-25
 
 ### Added
+
 - **📊 Comprehensive Sitemap Integration**: Unified layout combining collections, statistics, and navigation
   - Real-time site statistics dashboard with 6 key performance indicators
   - Interactive search and filtering across all content types
@@ -136,16 +382,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Comprehensive documentation and implementation guides
 
 ### Changed
+
 - **🏗️ Navigation System**: Consolidated duplicate sitemap entries into unified comprehensive view
 - **🎨 Visual Design**: Updated to modern card-based layout with smooth transitions
 - **📱 Mobile Experience**: Enhanced mobile responsiveness and touch interactions
 
 ### Fixed
+
 - **🐛 Dark Mode Compatibility**: Resolved background color issues in dark theme
 - **🔧 Collection Filtering**: Fixed functionality for dynamic content filtering
 - **🔗 Link Navigation**: Corrected internal link behavior and navigation flow
 
 ### Technical Details
+
 - **Files Added**: `_layouts/sitemap-collection.html`, enhanced navigation data files
 - **Files Modified**: Main navigation configuration, sitemap pages
 - **Performance**: Optimized DOM manipulation and content rendering
@@ -156,6 +405,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.0] - 2025-10-10
 
 ### Added
+
 - **📊 Comprehensive Site Statistics Dashboard**: Complete analytics system for content insights
   - Dynamic statistics generation from site content using Ruby script
   - Real-time analytics showing content pieces, categories, tags, and word counts
@@ -177,6 +427,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Smooth scroll navigation and fade-in animations for modern UX
 
 ### Changed
+
 - **📈 Activity Level Intelligence**: Dynamic threshold calculation replacing static values
   - Categories: High activity (≥70% of max), Medium (≥40% of max), Low (remainder)
   - Tags: Frequently used (≥60% of max), Moderately used (≥20% of max), Occasionally used (remainder)
@@ -187,6 +438,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Optimized data processing without complex sorting operations
 
 ### Fixed
+
 - **🐛 Data Display Issues**: Resolved template rendering and data access problems
   - Fixed Liquid template syntax errors causing empty displays
   - Corrected data structure references across all components
@@ -198,6 +450,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.3.0] - 2025-01-27
 
 ### Added
+
 - **🎨 Mermaid Diagram Integration v2.0**: Comprehensive diagramming system
   - Complete diagram support: flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, git graphs, journey diagrams, and mindmaps
   - GitHub Pages compatibility with both local development and deployment
@@ -216,11 +469,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Performance validation and benchmarking
 
 ### Changed
+
 - **📁 File Organization**: 53% reduction from 15 to 7 Mermaid-related files
 - **🏗️ Architecture**: Modular include system with clear responsibilities
 - **📖 Documentation**: Consolidated and improved documentation structure
 
 ### Fixed
+
 - **🔧 Configuration**: Enhanced Jekyll and GitHub Pages compatibility
 - **⚡ Performance**: Optimized loading and rendering speed
 - **🎯 Usability**: Improved setup process and error handling
@@ -230,27 +485,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.2.1] - 2025-09-30
 
 ### Added
+
 - Enhanced markdown linting configuration
 - Improved Jekyll template support for link checking
 - Better configuration for markdown validation
 
 ### Changed
+
 - Updated markdown-link-check configuration with Jekyll-specific patterns
 - Relaxed line length requirements in markdownlint configuration
 - Added support for more HTML elements in markdown
 
 ### Fixed
+
 - Improved markdown validation for Jekyll projects
 - Better handling of Liquid templates in link validation
 
 ## [0.2.0] - 2025-09-01
 
 ### Changed
+
 - Version bump to 0.2.0 with improvements
 
 ## [0.1.9] - 2025-01-27
 
 ### Added
+
 - **🐳 Docker-First Development Evolution**: Complete transformation to containerized development
   - AI-powered `init_setup.sh` with intelligent environment detection and auto-healing
   - Cross-platform Docker Compose configuration with Apple Silicon optimization
@@ -269,12 +529,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - AI-generated documentation and setup instructions
 
 ### Changed
+
 - **🔧 Installation Philosophy**: Shifted from traditional Ruby/Jekyll setup to Docker-first approach
   - Disabled local theme dependencies to avoid gemspec issues
   - Optimized for containerized development environments
   - Enhanced cross-platform compatibility and consistency
 
 ### Fixed
+
 - **🐛 Theme Dependency Issues**: Resolved Jekyll theme not found errors
   - Commented out problematic Jekyll includes in README.md
   - Disabled `remote_theme` in development configuration
@@ -287,6 +549,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.8] - 2025-01-03
 
 ### Added
+
 - **Comprehensive Gem Automation System**: Unified automation ecosystem
   - Zero-click releases with multi-environment testing
   - Production-ready CI/CD pipeline with GitHub Actions integration
@@ -299,6 +562,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Cleanup Functions**: Automatic cleanup of temporary files after remote installation
 
 ### Changed
+
 - **Feature Documentation Restructure**: Consolidated redundant automation feature entries
 - **Simplified Installation Process**: Updated to use single install command
 - **Azure-Ready Configuration**: Pre-configured directory structure for Azure Static Web Apps
@@ -306,9 +570,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Improved Help System**: Added remote installation examples
 
 ### Removed
+
 - **Redundant Documentation**: Eliminated duplicate automation documentation files
 
 ### Fixed
+
 - **Installation Script Compatibility**: Made compatible with both local and remote execution
 - **Directory Structure**: Optimized for Azure Static Web Apps deployment
 - **Markdown Lint Issues**: Fixed all markdown formatting violations
@@ -316,6 +582,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.7] - 2024-12-01
 
 ### Added
+
 - Bootstrap Jekyll theme for headless GitHub Pages CMS
 - Basic theme structure with layouts, includes, and assets
 - Jekyll compatibility with GitHub Pages
@@ -324,6 +591,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Makefile for simplified command access
 
 ### Changed
+
 - Initial theme implementation and project structure
 
 ---
@@ -331,6 +599,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Documentation
 
 For detailed documentation on features, systems, and configuration:
+
 - **[Documentation Center](docs/README.md)** - Complete documentation overview
 - **[Release Documentation](docs/releases/README.md)** - Historical release information
 - **[Feature Documentation](docs/features/README.md)** - Detailed feature guides
@@ -347,4 +616,4 @@ For detailed documentation on features, systems, and configuration:
 [0.2.0]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.9...v0.2.0
 [0.1.9]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/bamr87/zer0-mistakes/compare/v0.1.7...v0.1.8
-[0.1.7]: https://github.com/bamr87/zer0-mistakes/releases/tag/v0.1.7
+[0.1.7]: https://github.com/bamr87/zer0-mistakes/releases/tag/v0.1.7