jekyll-theme-zer0 0.8.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 733d8704f50748a918ed57f3e7a59dce4206763265456dde795643f7e9cc2b63
-  data.tar.gz: 0f7e1075d4975fee6d1fbe283d93e9d5fc791d2226877c6e949828110cc9779b
+  metadata.gz: 11f1a090a15824b7b1fc5754e858839d93318efad779deb8d63f5b5641a08f02
+  data.tar.gz: 476de246227f2f492eb142f7d4f9f0b1e20b9dc97350069bb6b3fff3ef295f8b
 SHA512:
-  metadata.gz: 244c31f280895d914cd5a4b6d1a7199e8d134e5daf9d5b1c33a3454b35b7aa65245396a2e1884e3900732ccbb1d07552863cd7b35c1a0aaffe0ab886473f73cf
-  data.tar.gz: 8a6362bc14e3f7c02d9928d068d98039d69965cfeae0f3a0591845059fe00391a0adb67df3870352f0d4f928c855365933794148241332c8272738e46aceda89
+  metadata.gz: 8a2aba3a52815a120646b1b094a973dd01e4c28555f37de5562a9a262d4ad6dda7944753c9f235862ef60b8ce99ad94c62b98bdabf821b983243812d07b27480
+  data.tar.gz: e54a3074c2d26c178211144219c9e934258edca74f498e073e37edc7e68d4a84d18181295d7467ac6de5647d6bc0d52e41605838171028f96b86dbbdd04caa1f

data/CHANGELOG.md

@@ -1,5 +1,175 @@
 # 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
@@ -48,7 +218,7 @@
   - 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: `{% preview_image_status %}`, `{% preview_images_missing %}`
+  - 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
@@ -145,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
@@ -154,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
@@ -162,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
@@ -173,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/),
@@ -183,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
@@ -208,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
@@ -228,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
@@ -249,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)
@@ -259,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
@@ -270,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
@@ -288,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
@@ -302,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
@@ -341,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
@@ -359,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
@@ -371,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
@@ -378,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
@@ -388,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
@@ -396,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
 
 ---
@@ -403,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
@@ -419,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