jekyll-theme-zer0 1.12.1 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70cd99cdba3cc1dd7c1d29044ee5cdad162c1670e5516ff0bdd9dfbf3dbcd720
-  data.tar.gz: fb3f97db3b77236ff36cca5ff7af267d54484da397f64cb3df03e4b28643b240
+  metadata.gz: 300fd839d62b5d716dc62bde6853834fecca0b431871d818511f83b3b118586e
+  data.tar.gz: 7faf9a32a6709bb8bd4cc5c9681910b9595c81761c2582224f71f6623e5573d7
 SHA512:
-  metadata.gz: e38c17c29f540bfcfac2328462b6975f07e566ead4dfcf8920cf029ff9a81db95040995686dc61b412abeb24bdc15b1e427aab77e15ee077993a6acfbf7786c3
-  data.tar.gz: 2e36c4f5b88e0db3c79277f959f8206e65fa94134f60bd8a6391dd839db8e0f79cbe6aadd4729320d790ac7985630f9f31cdbfc44d83079561a87c7f22ff0e31
+  metadata.gz: 5c41e56c171902d054122a1288a10e2a45998cfabd06231d28e78e027ffaa9fc79b7511a3c34a50d7b81ab4f4911797fed2be78891bb45bd0e977aa28d298634
+  data.tar.gz: 143441cff23b9bec1bbf3222d4fcf21fb4949d4a9bf6394aff67c4cefb56e8da1bd71871c76ccdb900a78cc8f8623ce28c4bbcb7004357171e4f032bc02c8242

data/CHANGELOG.md

@@ -1,20 +1,42 @@
 # Changelog
 
-## [1.12.1] - 2026-06-10
+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).
+
+## [1.13.0] - 2026-06-11
 
 ### Changed
-- Version bump: patch release
+- Version bump: minor release
 
 ### Commits in this release
-- 0c04f703 fix: repair failing test suites, validator crashes, and roadmap/changelog drift (#132)
+- cee6f379 feat(ci): gate PRs on the full canonical test entrypoint (T-012) (#138)
 
+### Added
+- **CI gate parity (T-012)**: the `ci.yml` test job now runs every non-Playwright theme suite (core, deployment, quality, installation, installer, site_generation, obsidian) plus the canonical `./scripts/bin/test` script suites (lib unit, theme validate, integration, installer e2e) on every code PR — previously only `core,quality,installation` gated, which is how three suites rotted unnoticed before PR #132; a "Gate Coverage — What Enforces What" table in `.github/workflows/README.md` now documents the controls contract
 
-All notable changes to this project will be documented in this file.
+### Fixed
+- **Release changelog path**: `version-bump.yml` now inserts release entries via the shared `update_changelog_file` library instead of an inline `head`/`tail` prepend that duplicated (and regressed) the insertion logic — the 1.12.1 release had pushed the file preamble below its entry and stranded the pending `[Unreleased]` notes; both repaired 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).
+## [1.12.2] - 2026-06-10
+
+### Added
+- **Zer0-Mistake Quality Framework (planning)**: new roadmap milestone v1.13 and backlog tasks T-012–T-015 to close the gap between the repo's quality gates and what CI enforces — CI gate parity with the canonical `./scripts/bin/test` entrypoint (whose integration suites previously rotted unnoticed), re-armed pixel-snapshot and docs link-check gates, and a locale-independence regression guard; coverage baseline task T-005 repointed at the new milestone
 
-## [Unreleased]
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 846bd9ff chore(backlog): plan the Zer0-Mistake Quality Framework (roadmap v1.13, T-012–T-015) (#133)
+- 33a727c0 docs: expand CLAUDE.md into a comprehensive Claude Code guide (#131)
+
+## [1.12.1] - 2026-06-10
+
+### Changed
+- Version bump: patch release
+- **Roadmap**: advanced to track the shipped gem — v1.9 marked completed, v1.10 (Roadmap Validation) and v1.11 (Continuous-Evolution Loop) recorded, v1.12 (Headless Endpoints) is the active milestone (closes backlog T-001, T-002)
+- **Changelog**: restored the Keep a Changelog preamble at the top of this file
 
 ### Fixed
 - **Tooling encoding**: `generate-roadmap.rb`, `sync-backlog.rb`, and `scripts/bin/validate` now read repo files as UTF-8 explicitly, fixing `invalid byte sequence in US-ASCII` crashes in environments without a UTF-8 locale (minimal containers, some CI runners) — `generate-roadmap.sh --check` and `validate --quick` both crashed in such environments
@@ -24,9 +46,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `_layouts/search.html` given a front matter block so theme layout validation passes
 - **Changelog tooling**: `update_changelog_file` now folds any pending `## [Unreleased]` section into the new release entry and inserts before the first release heading (preserving the file preamble) — stale Unreleased blocks no longer accumulate mid-file; the eight historical stray blocks were folded into the releases that shipped them
 
-### Changed
-- **Roadmap**: advanced to track the shipped gem — v1.9 marked completed, v1.10 (Roadmap Validation) and v1.11 (Continuous-Evolution Loop) recorded, v1.12 (Headless Endpoints) is the active milestone (closes backlog T-001, T-002)
-- **Changelog**: restored the Keep a Changelog preamble at the top of this file
+### Commits in this release
+- 0c04f703 fix: repair failing test suites, validator crashes, and roadmap/changelog drift (#132)
 
 ## [1.12.0] - 2026-06-03
 

data/README.md

@@ -2,7 +2,7 @@
 title: zer0-mistakes
 sub-title: AI-Native Jekyll Theme
 description: AI-native Jekyll theme for GitHub Pages — Docker-first development, AI-powered installation, multi-agent integration (Copilot, Codex, Cursor, Claude), AI preview-image generation, and AIEO content optimization with Bootstrap 5.3.
-version: 1.12.1
+version: 1.13.0
 layout: landing
 tags:
   - jekyll
@@ -20,7 +20,7 @@ categories:
   - bootstrap
   - ai-tooling
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2026-06-10T22:03:08.000Z
+lastmod: 2026-06-11T04:16:44.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -833,6 +833,7 @@ gantt
     section Current
     v1.12 Headless Endpoints     :active, 2026-06, 2026-06
     section Future
+    v1.13 Zer0-Mistake Quality Framework :2026-06, 2026-08
     v2.0 CMS Integration         :2026-06, 2026-08
     v2.1 i18n Support            :2026-08, 2026-10
     v2.2 Advanced Analytics      :2026-10, 2026-12
@@ -864,6 +865,7 @@ gantt
 | **v1.10** | ✅ Completed | Jun 2026 | Roadmap integrity validation and catch-up milestones so the roadmap tracks the shipped gem. |
 | **v1.11** | ✅ Completed | Jun 2026 | Self-sustaining backlog loop so AI agents keep improving the repo between human sessions. |
 | **v1.12** | 🚧 In Progress | Current (1.12.x) | Machine-readable site endpoints for downstream sites and AI agents. |
+| **v1.13** | 🗓 Planned | Q3 2026 | Close the gap between the repo's quality gates and what CI actually enforces — no mistake lands green. |
 | **v2.0** | 🗓 Planned | Q3 2026 | Headless CMS integration with a content API and admin dashboard. |
 | **v2.1** | 🗓 Planned | Q4 2026 | Multi-language content support with locale-aware routing. |
 | **v2.2** | 🗓 Planned | Q4 2026 | Visual theme customizer, A/B testing, and conversion funnels. |
@@ -907,7 +909,7 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 1.12.1 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
+| **Current Version** | 1.13.0 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
 | **Documented Features** | 43 ([Feature Registry](https://github.com/bamr87/zer0-mistakes/blob/main/_data/features.yml)) |
 | **Setup Time** | 2-5 minutes ([install.sh benchmarks](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh)) |
 | **Documentation Pages** | 70+ ([browse docs](https://zer0-mistakes.com/pages/)) |
@@ -962,6 +964,6 @@ And these AI partners that make zer0-mistakes truly AI-native:
 
 **Built with ❤️ — and a little help from our AI partners — for the Jekyll community**
 
-**v1.12.1** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
+**v1.13.0** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
 
 

data/_data/backlog.yml

@@ -56,7 +56,7 @@
 meta:
   title: "zer0-mistakes Backlog"
   updated: 2026-06-10
-  next_id: 12
+  next_id: 17
 
 tasks:
   # --- Housekeeping (seeded so the loop has work on day one) ------------------
@@ -145,7 +145,7 @@ tasks:
     updated: 2026-05-31
 
   - id: T-005
-    title: "Coverage baseline: identify the lowest-covered subsystems toward the v1.0 90% goal"
+    title: "Coverage baseline: identify the lowest-covered subsystems toward the 90% goal"
     status: open
     priority: P1
     area: tests
@@ -153,16 +153,17 @@ tasks:
     effort: L
     source: roadmap
     summary: >-
-      The v1.0 milestone targets 90%+ automated test coverage. Produce a
-      coverage baseline and file follow-up tasks for the lowest-covered areas
-      (start with the modular installer and the Obsidian resolver paths).
+      The 3.0 LTS milestone targets 90%+ automated test coverage, and the v1.13
+      Zer0-Mistake Quality Framework starts with knowing where coverage stands.
+      Produce a coverage baseline and file follow-up tasks for the lowest-covered
+      areas (start with the modular installer and the Obsidian resolver paths).
     acceptance:
       - "A coverage baseline is recorded (test/coverage or a docs note)."
       - "The 2–3 lowest-covered subsystems are identified and filed as new backlog tasks."
       - "No reduction in existing passing tests (`./scripts/bin/test` stays green)."
-    links: { issue: null, pr: null, roadmap: "1.0" }
+    links: { issue: null, pr: null, roadmap: "1.13" }
     created: 2026-05-31
-    updated: 2026-05-31
+    updated: 2026-06-10
 
   # --- 2026-06-01 audit -------------------------------------------------------
 
@@ -276,3 +277,129 @@ tasks:
     links: { issue: null, pr: null, roadmap: "3.0" }
     created: 2026-06-01
     updated: 2026-06-01
+
+  # --- 2026-06-10 Zer0-Mistake Quality Framework (roadmap v1.13) --------------
+  #
+  # Origin: main carried 3 failing test suites and 2 crashing validators while
+  # every CI check stayed green (fixed in PR #132). Root cause: the PR gate runs
+  # only a subset of the canonical test entrypoint, and two checks are warn-only.
+  # These tasks close the gap between the quality gates and what CI enforces.
+
+  - id: T-012
+    title: "CI gate parity: run the full canonical test entrypoint on PRs"
+    status: done
+    priority: P1
+    area: infra
+    risk: standard
+    effort: M
+    source: roadmap
+    summary: >-
+      `ci.yml`'s test job runs `test/test_runner.sh --suites core,quality,installation`,
+      which skips the lib unit tests (`scripts/test/lib/`), the integration suites
+      (`scripts/test/integration/` — exactly the ones that rotted unnoticed before
+      PR #132), the obsidian suite, and the installer e2e suites that
+      `./scripts/bin/test` runs locally. PRs must gate on the same entrypoint
+      contributors are told to run.
+      Done 2026-06-10: test job expanded to all seven non-Playwright theme
+      suites plus a `./scripts/bin/test` step; gate-coverage table added to
+      the workflows README. Canary experiment: a deliberately failing
+      integration test was committed and reverted on the implementing PR;
+      GitHub did not schedule the CI pipeline on the canary push, so the
+      gate failure was verified locally (`./scripts/bin/test` exit 1) and
+      the new gate is exercised for real by the PR's final CI run.
+    acceptance:
+      - "The `ci.yml` test job executes `./scripts/bin/test` (or an explicit suite list that includes lib, integration, obsidian, and installer e2e) on every code PR."
+      - "A deliberately broken integration test fails CI in a draft PR experiment (then reverted)."
+      - "`.github/workflows/README.md` documents which gates run on PR vs push vs schedule."
+      - "Total PR wall-clock stays under 25 minutes (parallelize jobs if needed)."
+    links: { issue: null, pr: null, roadmap: "1.13" }
+    created: 2026-06-10
+    updated: 2026-06-10
+
+  - id: T-013
+    title: "Refresh Playwright snapshot baselines and re-arm the pixel gate"
+    status: open
+    priority: P2
+    area: tests
+    risk: standard
+    effort: M
+    source: roadmap
+    summary: >-
+      The snapshot tier in `ci.yml` is `continue-on-error: true` because the
+      committed baselines predate the PR #108 UI overhaul. Regenerate the Linux
+      baselines via `./test/update-snapshots.sh` and make the tier blocking again
+      so visual regressions cannot land silently.
+    acceptance:
+      - "Baselines under `test/visual/snapshots/` regenerated and committed."
+      - "`continue-on-error: true` removed from the snapshot step in `ci.yml`."
+      - "Snapshot tier passes in CI on an unchanged follow-up commit."
+    links: { issue: null, pr: null, roadmap: "1.13" }
+    created: 2026-06-10
+    updated: 2026-06-10
+
+  - id: T-014
+    title: "Re-arm the docs link-check gate (remove warn-only || true)"
+    status: open
+    priority: P2
+    area: lint
+    risk: standard
+    effort: M
+    source: roadmap
+    summary: >-
+      `docs-validate.yml` runs markdown-link-check with `|| true` ("warn-only
+      until baseline is clean"), so broken links accumulate. Fix the links it
+      currently reports, then drop the `|| true` so the gate blocks.
+    acceptance:
+      - "All links reported by the current `docs-validate.yml` run are fixed or allowlisted in `.github/config/.markdown-link-check.json`."
+      - "Both `|| true` suppressions removed from `docs-validate.yml`."
+      - "`docs-validate.yml` passes blocking on a follow-up PR."
+    links: { issue: null, pr: null, roadmap: "1.13" }
+    created: 2026-06-10
+    updated: 2026-06-10
+
+  - id: T-015
+    title: "Locale-independence regression guard for Ruby/Bash tooling"
+    status: open
+    priority: P2
+    area: infra
+    risk: standard
+    effort: S
+    source: roadmap
+    summary: >-
+      PR #132 fixed `invalid byte sequence in US-ASCII` crashes in
+      `generate-roadmap.rb`, `sync-backlog.rb`, and `scripts/bin/validate` that
+      only reproduced without a UTF-8 locale. Add a guard so the bug class
+      cannot return: run the validators under `LC_ALL=C` in a lib test or a
+      dedicated CI step.
+    acceptance:
+      - "A test (scripts/test/lib/) or CI step runs `generate-roadmap.rb --check`, `sync-backlog.rb --check`, and `validate --quick` with `LC_ALL=C LANG=C`."
+      - "The guard fails when the explicit-UTF-8 reads are reverted (verified once locally)."
+      - "`./scripts/bin/test` stays green."
+    links: { issue: null, pr: null, roadmap: "1.13" }
+    created: 2026-06-10
+    updated: 2026-06-10
+
+  - id: T-016
+    title: "site_generation suite: fail on Jekyll build errors instead of warning"
+    status: open
+    priority: P2
+    area: tests
+    risk: standard
+    effort: S
+    source: audit
+    summary: >-
+      `test/test_site_generation.sh` downgrades `bundle exec jekyll build`
+      failures to a warning ("Don't fail the test for build issues (may be
+      environment)"), so the suite reports success even when every mode's
+      build fails — a masked gate discovered while implementing T-012. With
+      the suite now gating PRs in CI (working bundler guaranteed), build
+      failures should fail the suite; keep the skip only for genuinely
+      missing toolchain (no bundler).
+    acceptance:
+      - "A non-zero `jekyll build` exit fails the suite when bundler is available."
+      - "The bundler-missing path still skips with a warning (local minimal environments)."
+      - "Suite passes in CI and via `./test/test_runner.sh --suites site_generation` locally."
+    links: { issue: null, pr: null, roadmap: "1.13" }
+    created: 2026-06-10
+    updated: 2026-06-10
+

data/_data/roadmap.yml

@@ -330,6 +330,22 @@ milestones:
 
   # --- Future ----------------------------------------------------------------
 
+  - version: "1.13"
+    title: "Zer0-Mistake Quality Framework"
+    status: planned
+    section: Future
+    start: 2026-06
+    end: 2026-08
+    target: "Q3 2026"
+    summary: "Close the gap between the repo's quality gates and what CI actually enforces — no mistake lands green."
+    features:
+      - "CI gate parity — PRs run the full canonical test entrypoint (lib unit, theme, integration, installer e2e), not a subset"
+      - "Re-armed pixel-snapshot gate (refreshed baselines, no `continue-on-error`)"
+      - "Re-armed docs link-check gate (clean baseline, no warn-only `|| true`)"
+      - "Locale-independence regression guard for the Ruby/Bash tooling"
+      - "Coverage baseline with follow-up tasks for the lowest-covered subsystems"
+      - "Documented required status checks per branch (the 'controls' contract)"
+
   - version: "2.0"
     title: "CMS Integration"
     status: planned

data/scripts/lib/changelog.sh

@@ -331,27 +331,33 @@ update_changelog_file() {
         } > "${CHANGELOG_FILE}.tmp"
         mv "${CHANGELOG_FILE}.tmp" "$CHANGELOG_FILE"
 
-        # Append the pending notes to the new entry (if any are non-blank)
+        # Append the pending notes to the new entry (if any are non-blank),
+        # separated by a blank line so section headings don't collide.
         if [[ -n "${unreleased_body//[[:space:]]/}" ]]; then
             debug "Folding pending [Unreleased] notes into the new entry"
-            entry+=$'\n'"$(echo "$unreleased_body" | sed -e '/./,$!d')"$'\n'
+            entry="${entry%$'\n'}"$'\n\n'"$(echo "$unreleased_body" | sed -e '/./,$!d')"$'\n'
         fi
     fi
 
     # Insert the new entry before the first release heading so the file
     # header/preamble (title, Keep a Changelog blurb) stays at the top.
+    # Normalize the entry's trailing newlines first: callers that build the
+    # entry via command substitution (e.g. version-bump.yml's
+    # `"$(cat "$TEMP_FILE")"`) lose them, so guarantee exactly one blank
+    # line between the entry and the next release block here.
+    while [[ "$entry" == *$'\n' ]]; do entry="${entry%$'\n'}"; done
+
     local first_release
     first_release=$(grep -n '^## ' "$CHANGELOG_FILE" | head -1 | cut -d: -f1)
 
     {
         if [[ -n "$first_release" ]]; then
             head -n "$((first_release - 1))" "$CHANGELOG_FILE"
-            echo "$entry"
+            printf '%s\n\n' "$entry"
             tail -n +"$first_release" "$CHANGELOG_FILE"
         else
             cat "$CHANGELOG_FILE"
-            echo ""
-            echo "$entry"
+            printf '\n%s\n' "$entry"
         fi
     } > "${CHANGELOG_FILE}.tmp"
 

data/scripts/test/lib/test_changelog.sh

@@ -152,6 +152,15 @@ _v100_line=$(grep -n '^## \[1.0.0\]' CHANGELOG.md | cut -d: -f1)
 assert_true "[[ $_v101_line -lt $_v100_line ]]" "New entry inserted before previous release"
 assert_true "grep -q 'All notable changes' CHANGELOG.md" "Preamble preserved without Unreleased"
 
+# Case 3: entries passed via command substitution lose trailing newlines
+# (e.g. version-bump.yml's "$(cat "$TEMP_FILE")"); the insert must still
+# leave exactly one blank line before the next release block.
+printf '## [1.0.2] - 2026-06-11\n\n### Fixed\n- Another bug\n\n' > entry.txt
+update_changelog_file "$(cat entry.txt)" >/dev/null 2>&1
+_v101_line=$(grep -n '^## \[1.0.1\]' CHANGELOG.md | cut -d: -f1)
+assert_true "[[ -z \"\$(sed -n $((_v101_line - 1))p CHANGELOG.md)\" ]]" "Blank line separates entry from next release block"
+assert_true "[[ -n \"\$(sed -n $((_v101_line - 2))p CHANGELOG.md)\" ]]" "Exactly one blank line (no double spacing)"
+
 popd >/dev/null
 rm -rf "$_changelog_tmp"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.12.1
+  version: 1.13.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-10 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll