RubyGems - jekyll-theme-zer0 - Versions diffs - 1.12.0 → 1.12.2 - Mend

jekyll-theme-zer0 1.12.0 → 1.12.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +50 -28
data/README.md +14 -6
data/_data/backlog.yml +111 -12
data/_data/roadmap.yml +62 -6
data/_includes/components/mermaid.html +1 -1
data/_layouts/search.html +5 -0
data/scripts/bin/validate +3 -1
data/scripts/generate-roadmap.rb +5 -3
data/scripts/lib/changelog.sh +49 -8
data/scripts/sync-backlog.rb +1 -1
data/scripts/test/integration/auto-version +73 -107
data/scripts/test/integration/mermaid +13 -19
data/scripts/test/lib/test_changelog.sh +68 -0
metadata +2 -2

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad67d8675eed54308dc843c4f5025aaa20f7fe2b627d517dfaada7522cb68151
-  data.tar.gz: b1156a1f8b0f70bfbc1ca0299be338c78c989740b8c40c7f249dfee73d161dd5
+  metadata.gz: fbc99ee38514486f868b91a616bcfece9ab588d4c27c18f358592c12bac98225
+  data.tar.gz: 864ff57c952cfb6c6761ab4b140545401f762bb8485d192c48a31ffee1e9ab65
 SHA512:
-  metadata.gz: 58ec18a1c0e3f222340325fd44677c64798c4bb1e33f4e69f0247fa73f547a4aeabc6dfd81735f98096f01303405f25178a7fbff3e29000e2d31f85720fec4b6
-  data.tar.gz: 00d341d37e50337fc262ce6055cebfcfe040713bf768c673c7a653045649299c06e95c94e46225c7bfab5b3190817196642f950a956573dae3a8c5056f96b8ed
+  metadata.gz: ad7d6da5e0c707aa5ea232e5d3a714bbd0ed3955cc220d950dec7103715665a4e9a799f9a028e2eb57e1f161b0bf286dd39a5d145110f0a2936067405a698aae
+  data.tar.gz: b5428a640a6a5aee60e170d4c69780e3538704575a9a1ff2d23d26c9583429f0e2ad1da79185906260e75a60092f4d88b139e01fa2b7cf954fa9a77258f2879b

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,46 @@
 # Changelog
+## [1.12.2] - 2026-06-10
+### 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
+### Commits in this release
+- 0c04f703 fix: repair failing test suites, validator crashes, and roadmap/changelog drift (#132)
+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
+- **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
+### 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
+- **Test suite**: repaired the three test suites that failed on `main`:
+  - `scripts/test/integration/auto-version` rewritten against the current release architecture (`scripts/analyze-commits.sh` wrapper, `scripts/utils/analyze-commits`, `scripts/bin/release`, `version-bump.yml`) — it previously targeted the retired `gem-publish.sh`/`auto-version-bump.yml` and aborted under `set -e` due to `((var++))` returning non-zero
+  - `scripts/test/integration/mermaid` repointed at `pages/_docs/features/mermaid-diagrams.md` (the doc moved from `pages/_docs/jekyll/`) and at the current Bootstrap-aware theming instead of the removed forest theme/FontAwesome config
+  - `_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
 ## [1.12.0] - 2026-06-03
 ### Changed
@@ -37,9 +78,6 @@
 ### Commits in this release
 - 8a5ba7e2 feat(ci): add continuous-evolution backlog loop (#114)
-## [Unreleased]
 ### Added
 - **Continuous-evolution loop**: a self-sustaining backlog mechanism so AI agents can keep improving the repo between human sessions.
   - `_data/backlog.yml` — tactical task queue (single source of truth), mirroring the `_data/roadmap.yml` pattern.
@@ -50,6 +88,8 @@
   - `.github/instructions/backlog.instructions.md` — file-scoped guidance for the backlog.
   - `docs/systems/continuous-evolution.md` — full design, autonomy policy, and setup.
   - `CLAUDE.md` — Claude Code pointer to `AGENTS.md` (per the documented convention).
 ## [1.10.0] - 2026-06-01
 ### Changed
@@ -153,9 +193,6 @@
 ### Commits in this release
 - 8a2bd84 feat(install): modular installer with deploy plugins, AI wizard pipeline, scrape v2, and test suite (#111)
-## [Unreleased]
 ### Added
 - **Modular installer (`scripts/install/`)**: spec-driven, AI-aware installer dispatched by `scripts/bin/install`. Single `.zer0/install.spec.json` contract feeds CLI flags, the TUI wizard, and the OpenAI wizard into one apply pipeline.
 - **Deploy plugins**: `tasks/deploy_github-pages.sh`, `tasks/deploy_azure-swa.sh`, `tasks/deploy_docker-prod.sh`. Spec deploy targets now auto-render the matching workflow / config from `templates/deploy/`.
@@ -171,17 +208,16 @@
 - Rewrote `ai/prompts/wizard.system.md` with explicit profile, deploy, and agent heuristics plus a full example output, eliminating empty AI responses.
 - `plan_load_profile` and `plan_apply_flags` now return `0` explicitly so Bash 3.2 doesn't propagate a trailing-test exit code.
 ## [1.8.2] - 2026-05-26
 ### Changed
 - Version bump: patch release
-## [Unreleased]
 ### Changed
 - **Gem packaging**: `jekyll-theme-zer0.gemspec` now excludes `assets/images/` (287 MB of content previews/author photos), `assets/backgrounds/`, `.DS_Store` files, and binary media outside `assets/vendor/`, reducing gem payload to ~8.9 MB
 ## [1.8.1] - 2026-05-26
 ### Changed
@@ -217,9 +253,6 @@
 ### Commits in this release
 - 580f2b4 perf: Jekyll build performance improvements + MathJax 3 fix + richer Obsidian cache (#100)
-## [Unreleased]
 ### Added
 - **Design system & layouts**: Sass token layers (`_sass/tokens/`), component and layout partials (`_sass/components/`, `_sass/layouts/`), skins (`theme_skins.yml` + `_sass/theme/_skins.scss`), utilities, and developer docs (`docs/design-system.md`, `design-tokens.md`, `theming.md`, `layouts-and-navigation.md`, and related guides). Homepage sections are driven by `_data/landing.yml` per `_includes/components/README.md`.
 - **Navigation & chrome**: Drawer/TOC FAB and sidebar visibility modules (`assets/js/modules/navigation/`), `appearance.js` theme helper, refreshed navbar/footer/breadcrumb markup aligned with Bootstrap 5.3.
@@ -261,6 +294,7 @@
 ### Fixed (UI)
 - **Contrast skin — light mode**: The `contrast` skin's `zer0-skin-palette` mixin sets `--bs-link-color: #ffffff` (white accent) which rendered sidebar nav links invisible on a white background in light mode. Added `[data-theme-skin="contrast"]:not([data-bs-theme="dark"])` override in `_sass/theme/_skins.scss` to pin link color to `#111111` in light mode while leaving dark-mode behavior unchanged.
 ## [1.6.5] - 2026-05-19
 ### Changed
@@ -394,9 +428,6 @@
 - 3d91006 fix(release): replace ((var++)) with var=$((var + 1)) in release path
 - d33e5e6 feat(intro): refocus Copilot Agent prompts on frontend/CMS workflows (#74)
-## [Unreleased]
 ### Changed
 - **Docker/Jekyll build performance** — Reduced repeated full-page Liquid scans in the footer, settings offcanvas, and cookie consent includes; cached preview image checks during generation; skipped server-side Obsidian rewrites for documents without Obsidian syntax; and changed Docker dev startup to run `bundle install` only when `bundle check` reports missing dependencies. The profiled Docker build improved from 119.2s to 86.8s in local validation.
@@ -501,6 +532,7 @@
   `/#setup-wizard`, which is provided by the new welcome layout.
 - **Version-bump workflow no longer crashes on bash 5.x runners.** `scripts/utils/analyze-commits` (and `scripts/lib/changelog.sh`, `scripts/lib/migrate.sh`) used the `((var++))` post-increment idiom. On bash 5.x, when `var` is 0 the expression evaluates to 0 → exit code 1 → `set -euo pipefail` terminates the script silently. macOS bash 3.2 was more forgiving, so the bug only surfaced in CI. Replaced all release-path sites with `var=$((var + 1))`, which always returns 0. Added a static regression check to the unit tests so the pattern can't return.
 ## [1.0.0] - 2026-04-20
 First stable major release. Consolidates the breaking-change installer rewrite
@@ -573,9 +605,6 @@ See [`docs/installation/migration-from-0.x.md`](docs/installation/migration-from
 ### Commits in this release
 - 7f00e4d docs(roadmap): data-driven roadmap with auto-generated README mermaid diagram (#71)
-## [Unreleased]
 ### Changed
 - **Copilot Agent prompts (`_data/prompts.yml`)**: rewritten to focus on
   frontend/CMS workflows for the Jekyll theme. Replaced the previous
@@ -625,6 +654,7 @@ See [`docs/installation/migration-from-0.x.md`](docs/installation/migration-from
 - **Fork cleanup**: `scripts/fork-cleanup.sh` — `posthog`/`giscus` blocks reset only within their own YAML range (no stray matches in unrelated blocks)
 - **Welcome post**: `templates/pages/welcome-post.md.template` and embedded fallback in `scripts/fork-cleanup.sh` — corrected `layout: journals` → `layout: article` so the generated welcome post builds without “Layout does not exist” warnings on a freshly cleaned fork
 ## [0.22.20] - 2026-04-19
 ### Changed
@@ -766,9 +796,6 @@ See [`docs/installation/migration-from-0.x.md`](docs/installation/migration-from
 ### Commits in this release
 - a70ae8a chore: consolidate configuration, dependencies, and installation (PRs #48, #51, #52, #53) (#51)
-## [Unreleased] — Universal Installer
 ### Added
 - **Installer**: New `--remote` install mode — forks repo and creates an orphan `gh-pages` branch with only the bare minimum files needed to render via `remote_theme` (no local theme source)
 - **Installer**: New `--github` install mode — interactive fork via `gh` CLI with automatic platform detection and setup
@@ -793,6 +820,7 @@ See [`docs/installation/migration-from-0.x.md`](docs/installation/migration-from
 - **Templates**: `configuration.md.template` — comprehensive rewrite with URL tables, all config sections, cookie consent, dev config
 - **Templates**: `welcome-post.md.template` — enhanced Day 1 tutorial with folder structure diagram, commands table, feature checklist
 ## [0.22.6] - 2026-04-03
 ### Changed
@@ -2376,13 +2404,6 @@ See [`docs/installation/migration-from-0.x.md`](docs/installation/migration-from
 - 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/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-## [Unreleased]
 ### Added
 - Comprehensive documentation organization system in `/docs/` directory
@@ -2394,6 +2415,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Migrated scattered documentation files to organized structure
 - Improved documentation discoverability and maintenance
 ## [0.5.0] - 2025-10-25
 ### Added

data/README.md CHANGED Viewed

@@ -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.0
+version: 1.12.2
 layout: landing
 tags:
   - jekyll
@@ -20,7 +20,7 @@ categories:
   - bootstrap
   - ai-tooling
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2026-06-03T01:23:07.000Z
+lastmod: 2026-06-10T22:17:20.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -827,9 +827,13 @@ gantt
     v1.6 About Page & Search Cleanup :done, 2026-04, 2026-04
     v1.7 Build Performance & MathJax 3 :done, 2026-05, 2026-05
     v1.8 Design Tokens & Navigation Chrome :done, 2026-05, 2026-05
+    v1.9 Installer v2 & Site Scraper :done, 2026-05, 2026-05
+    v1.10 Roadmap Validation     :done, 2026-06, 2026-06
+    v1.11 Continuous-Evolution Loop :done, 2026-06, 2026-06
     section Current
-    v1.9 Installer v2 & Site Scraper :active, 2026-05, 2026-05
+    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
@@ -857,7 +861,11 @@ gantt
 | **v1.6** | ✅ Completed | Apr 2026 | Expanded About page and removal of the Algolia search dependency. |
 | **v1.7** | ✅ Completed | May 2026 | Significant Jekyll build speedups and a MathJax 3 inline-math fix. |
 | **v1.8** | ✅ Completed | May 2026 | Sass design-token system, refreshed navigation chrome, and a docs overhaul. |
-| **v1.9** | 🚧 In Progress | Current (1.9.x) | Modular installer v2 with deploy plugins, AI wizard pipeline, and a site scraper. |
+| **v1.9** | ✅ Completed | May 2026 | Modular installer v2 with deploy plugins, AI wizard pipeline, and a site scraper. |
+| **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. |
@@ -901,7 +909,7 @@ git push origin feature/awesome-feature
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 1.12.0 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
+| **Current Version** | 1.12.2 ([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/)) |
@@ -956,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.0** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
+**v1.12.2** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)

data/_data/backlog.yml CHANGED Viewed

@@ -55,15 +55,15 @@
 meta:
   title: "zer0-mistakes Backlog"
-  updated: 2026-06-01
-  next_id: 12
+  updated: 2026-06-10
+  next_id: 16
 tasks:
   # --- Housekeeping (seeded so the loop has work on day one) ------------------
   - id: T-001
     title: "Reconcile roadmap milestone numbering with the published gem version"
-    status: open
+    status: done
     priority: P2
     area: docs
     risk: standard
@@ -73,17 +73,19 @@ tasks:
       `_data/roadmap.yml` milestones run 0.17–1.0 while the gem ships as 1.9.9.
       Decide on a single numbering scheme (or document the mapping) so the
       roadmap, README, and RubyGems version no longer contradict each other.
+      Done 2026-06-10: roadmap advanced to track the shipped gem — v1.9
+      completed, v1.10/v1.11 recorded, v1.12 active.
     acceptance:
       - "Roadmap version line and gem version no longer contradict (either remapped or an explicit mapping note added to `_data/roadmap.yml` and `pages/roadmap.md`)."
       - "`./scripts/generate-roadmap.sh --check` passes after the change."
       - "No edit to `lib/jekyll-theme-zer0/version.rb`."
     links: { issue: null, pr: null, roadmap: null }
     created: 2026-05-31
-    updated: 2026-05-31
+    updated: 2026-06-10
   - id: T-002
     title: "Refresh roadmap `updated:` date and review milestone statuses"
-    status: open
+    status: done
     priority: P3
     area: docs
     risk: low
@@ -92,13 +94,15 @@ tasks:
     summary: >-
       `_data/roadmap.yml` `meta.updated` is 2026-04-18. Refresh it and confirm
       the 0.22 "active" milestone still reflects reality.
+      Done 2026-06-10: `meta.updated` refreshed and statuses reconciled with
+      shipped releases through v1.12.0.
     acceptance:
       - "`meta.updated` set to the current date."
       - "Active/planned statuses reviewed against shipped work."
       - "`./scripts/generate-roadmap.sh --check` passes."
     links: { issue: null, pr: null, roadmap: null }
     created: 2026-05-31
-    updated: 2026-05-31
+    updated: 2026-06-10
   - id: T-003
     title: "Add GitHub issue templates and a pull-request template"
@@ -141,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
@@ -149,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 -------------------------------------------------------
@@ -272,3 +277,97 @@ 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: open
+    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.
+    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

data/_data/roadmap.yml CHANGED Viewed

@@ -60,7 +60,7 @@
 meta:
   title: "zer0-mistakes Roadmap"
   tagline: "Past releases, current focus, and future plans for the zer0-mistakes Jekyll theme."
-  updated: 2026-05-30
+  updated: 2026-06-10
 milestones:
   # --- Completed -------------------------------------------------------------
@@ -270,15 +270,12 @@ milestones:
       - "Unified Playwright test tiers (smoke / snapshots / regression)"
       - "Design-system developer docs"
-  # --- Current ---------------------------------------------------------------
   - version: "1.9"
     title: "Installer v2 & Site Scraper"
-    status: active
-    section: Current
+    status: completed
+    section: Completed
     start: 2026-05
     end: 2026-05
-    target: "Current (1.9.x)"
     released: 2026-05-27
     summary: "Modular installer v2 with deploy plugins, AI wizard pipeline, and a site scraper."
     features:
@@ -288,8 +285,67 @@ milestones:
       - "Quickstart documentation rewrite with screenshots"
       - "Hardened one-line installer path"
+  - version: "1.10"
+    title: "Roadmap Validation"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-01
+    summary: "Roadmap integrity validation and catch-up milestones so the roadmap tracks the shipped gem."
+    features:
+      - "`generate-roadmap.rb --validate` mode (status/section/version/date checks)"
+      - "Catch-up milestones v1.0–1.9 recorded in the roadmap"
+      - "README roadmap accuracy fixes"
+  - version: "1.11"
+    title: "Continuous-Evolution Loop"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-01
+    summary: "Self-sustaining backlog loop so AI agents keep improving the repo between human sessions."
+    features:
+      - "`_data/backlog.yml` tactical task queue (single source of truth)"
+      - "Backlog ↔ GitHub Issues sync workflow with schema validation"
+      - "Auto-merge for low-risk (docs/deps/lint) PRs once CI is green"
+      - "`/repo-audit` and `/backlog-implement` agent routines"
+      - "Documentation maintenance system and consolidation"
+  # --- Current ---------------------------------------------------------------
+  - version: "1.12"
+    title: "Headless Endpoints"
+    status: active
+    section: Current
+    start: 2026-06
+    end: 2026-06
+    target: "Current (1.12.x)"
+    summary: "Machine-readable site endpoints for downstream sites and AI agents."
+    features:
+      - "Auto-generated `/search.json` endpoint for downstream sites"
+      - "Auto-generated `/sitemap/` endpoint"
+      - "Ruby gem and Mermaid dependency updates"
   # --- 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/_includes/components/mermaid.html CHANGED Viewed

@@ -27,7 +27,7 @@
   Configuration:
   - Mermaid v10 bundled locally (_config.yml mermaid.src)
-  - Forest theme for dark mode compatibility
+  - Adaptive light/dark theme following Bootstrap's data-bs-theme
   - Client-side code block conversion for GitHub Pages compatibility
   GitHub Pages Compatibility:

data/_layouts/search.html CHANGED Viewed

@@ -1 +1,6 @@
+---
+# Bare layout that renders the client-side search index as pure JSON.
+# Used by /search.json (see search.json in the site root); downstream
+# sites get the endpoint automatically via the theme gem.
+---
 {% include search-data.json %}

data/scripts/bin/validate CHANGED Viewed

@@ -236,7 +236,9 @@ versions = {
 }
 if File.file?('package.json')
-  versions['package.json'] = JSON.parse(File.read('package.json')).fetch('version').to_s
+  # Explicit UTF-8: package.json contains multibyte characters and the default
+  # external encoding is US-ASCII when no locale is set (containers, some CI).
+  versions['package.json'] = JSON.parse(File.read('package.json', encoding: 'UTF-8')).fetch('version').to_s
 end
 expected = versions.values.first

data/scripts/generate-roadmap.rb CHANGED Viewed

@@ -149,7 +149,7 @@ end
 def current_gem_version
   return nil unless File.exist?(VERSION_RB)
-  m = File.read(VERSION_RB).match(/VERSION\s*=\s*["']([^"']+)["']/)
+  m = File.read(VERSION_RB, encoding: 'UTF-8').match(/VERSION\s*=\s*["']([^"']+)["']/)
   m && m[1]
 end
@@ -318,7 +318,7 @@ def main
     begin
       YAML.load_file(DATA_FILE, permitted_classes: [Date, Time])
     rescue ArgumentError
-      YAML.safe_load(File.read(DATA_FILE), permitted_classes: [Date, Time], aliases: false)
+      YAML.safe_load(File.read(DATA_FILE, encoding: 'UTF-8'), permitted_classes: [Date, Time], aliases: false)
     end
   return run_validation(data) if options[:mode] == :validate
@@ -333,7 +333,9 @@ def main
     return 0
   end
-  original = File.read(README)
+  # Force UTF-8: the README contains emoji, and the default external encoding
+  # is US-ASCII when no locale is set (minimal containers, some CI runners).
+  original = File.read(README, encoding: 'UTF-8')
   updated  = original.dup
   updated  = replace_block(updated, MERMAID_START, MERMAID_END, mermaid)
   updated  = replace_block(updated, TABLE_START,   TABLE_END,   table)

data/scripts/lib/changelog.sh CHANGED Viewed

@@ -305,18 +305,59 @@ update_changelog_file() {
     # Create backup
     cp "$CHANGELOG_FILE" "${CHANGELOG_FILE}.bak"
-    # Insert new entry after header (preserve first line)
+    # Fold any pending "## [Unreleased]" section into the new entry so its
+    # notes ship with this release instead of getting buried beneath it
+    # (stale Unreleased blocks used to accumulate mid-file).
+    local unreleased_start
+    unreleased_start=$(grep -n '^## \[Unreleased\]' "$CHANGELOG_FILE" | head -1 | cut -d: -f1)
+    if [[ -n "$unreleased_start" ]]; then
+        # First "## " heading after the Unreleased one (relative offset)
+        local rel_next
+        rel_next=$(tail -n +"$((unreleased_start + 1))" "$CHANGELOG_FILE" | grep -n '^## ' | head -1 | cut -d: -f1)
+        local unreleased_body
+        if [[ -n "$rel_next" ]]; then
+            unreleased_body=$(sed -n "$((unreleased_start + 1)),$((unreleased_start + rel_next - 1))p" "$CHANGELOG_FILE")
+        else
+            unreleased_body=$(tail -n +"$((unreleased_start + 1))" "$CHANGELOG_FILE")
+        fi
+        # Drop the Unreleased section (header + body) from the file
+        {
+            head -n "$((unreleased_start - 1))" "$CHANGELOG_FILE"
+            [[ -n "$rel_next" ]] && tail -n +"$((unreleased_start + rel_next))" "$CHANGELOG_FILE"
+        } > "${CHANGELOG_FILE}.tmp"
+        mv "${CHANGELOG_FILE}.tmp" "$CHANGELOG_FILE"
+        # Append the pending notes to the new entry (if any are non-blank)
+        if [[ -n "${unreleased_body//[[:space:]]/}" ]]; then
+            debug "Folding pending [Unreleased] notes into the new entry"
+            entry+=$'\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.
+    local first_release
+    first_release=$(grep -n '^## ' "$CHANGELOG_FILE" | head -1 | cut -d: -f1)
     {
-        head -n 1 "$CHANGELOG_FILE"
-        echo ""
-        echo "$entry"
-        tail -n +2 "$CHANGELOG_FILE"
+        if [[ -n "$first_release" ]]; then
+            head -n "$((first_release - 1))" "$CHANGELOG_FILE"
+            echo "$entry"
+            tail -n +"$first_release" "$CHANGELOG_FILE"
+        else
+            cat "$CHANGELOG_FILE"
+            echo ""
+            echo "$entry"
+        fi
     } > "${CHANGELOG_FILE}.tmp"
     mv "${CHANGELOG_FILE}.tmp" "$CHANGELOG_FILE"
     rm -f "${CHANGELOG_FILE}.bak"
     debug "✓ Updated $CHANGELOG_FILE"
 }

data/scripts/sync-backlog.rb CHANGED Viewed

@@ -78,7 +78,7 @@ def load_data
   begin
     YAML.load_file(DATA_FILE, permitted_classes: [Date, Time])
   rescue ArgumentError
-    YAML.safe_load(File.read(DATA_FILE), permitted_classes: [Date, Time], aliases: false)
+    YAML.safe_load(File.read(DATA_FILE, encoding: 'UTF-8'), permitted_classes: [Date, Time], aliases: false)
   end
 end

data/scripts/test/integration/auto-version CHANGED Viewed

@@ -21,6 +21,13 @@ log_warning() { warn "$@"; }
 log_error() { error "$@"; }
 log_test() { step "$@"; }
+# Paths under test (the workflow calls the wrapper; the implementation
+# lives in scripts/utils/; releases go through scripts/bin/release)
+ANALYZE_WRAPPER="$SCRIPTS_ROOT/analyze-commits.sh"
+ANALYZE_IMPL="$SCRIPTS_ROOT/utils/analyze-commits"
+RELEASE_BIN="$SCRIPTS_ROOT/bin/release"
+WORKFLOW_FILE="$PROJECT_ROOT/.github/workflows/version-bump.yml"
 # Test counter
 TESTS_RUN=0
 TESTS_PASSED=0
@@ -29,49 +36,64 @@ run_test() {
     local test_name="$1"
     local test_command="$2"
     local expected_result="${3:-}"
-    ((TESTS_RUN++))
+    # Plain arithmetic assignment: ((VAR++)) returns the pre-increment value,
+    # which is non-zero-exit when 0 and aborts the script under `set -e`.
+    TESTS_RUN=$((TESTS_RUN + 1))
     log_test "Running: $test_name"
     local actual_result
     if actual_result=$(eval "$test_command" 2>&1); then
         if [[ -n "$expected_result" ]]; then
             if [[ "$actual_result" == "$expected_result" ]]; then
                 log_success "✅ $test_name"
-                ((TESTS_PASSED++))
+                TESTS_PASSED=$((TESTS_PASSED + 1))
             else
                 log_error "❌ $test_name - Expected: '$expected_result', Got: '$actual_result'"
             fi
         else
             log_success "✅ $test_name"
-            ((TESTS_PASSED++))
+            TESTS_PASSED=$((TESTS_PASSED + 1))
         fi
     else
         log_error "❌ $test_name - Command failed: $actual_result"
     fi
 }
+# Test file permissions and executability
+test_file_permissions() {
+    log_info "Testing file permissions..."
+    local scripts=(
+        "$ANALYZE_WRAPPER"
+        "$ANALYZE_IMPL"
+        "$RELEASE_BIN"
+    )
+    for script in "${scripts[@]}"; do
+        local script_name=$(basename "$script")
+        run_test "$script_name is executable" "test -x '$script'"
+    done
+}
 # Test the commit analysis script
 test_commit_analysis() {
     log_info "Testing commit analysis functionality..."
-    # Test script exists and is executable
-    run_test "Commit analysis script exists" "test -x '$SCRIPT_DIR/analyze-commits.sh'"
     # Test help output
-    run_test "Help output works" "$SCRIPT_DIR/analyze-commits.sh --help | grep -q 'Commit Analysis Script'"
+    run_test "Help output works" "$ANALYZE_IMPL --help | grep -q 'Commit Analysis Script'"
     # Test with sample commit ranges (if we have git history)
     if git rev-list --count HEAD >/dev/null 2>&1; then
         local commit_count=$(git rev-list --count HEAD)
         if [[ $commit_count -gt 1 ]]; then
-            # Test analyzing last commit
-            run_test "Analyze last commit" "$SCRIPT_DIR/analyze-commits.sh HEAD~1..HEAD | grep -E '^(patch|minor|major|none)$'"
+            # Test analyzing last commit (through the wrapper, like the workflow)
+            run_test "Analyze last commit" "$ANALYZE_WRAPPER HEAD~1..HEAD | grep -E '^(patch|minor|major|none)$'"
             # Test analyzing multiple commits if available
             if [[ $commit_count -gt 3 ]]; then
-                run_test "Analyze multiple commits" "$SCRIPT_DIR/analyze-commits.sh HEAD~3..HEAD | grep -E '^(patch|minor|major|none)$'"
+                run_test "Analyze multiple commits" "$ANALYZE_WRAPPER HEAD~3..HEAD | grep -E '^(patch|minor|major|none)$'"
             fi
         fi
     else
@@ -79,102 +101,51 @@ test_commit_analysis() {
     fi
 }
-# Test gem publication script compatibility
-test_gem_publish_script() {
-    log_info "Testing gem publication script compatibility..."
-    # Test script exists and is executable
-    run_test "Gem publish script exists" "test -x '$SCRIPT_DIR/gem-publish.sh'"
-    # Test new automated options
-    run_test "Automated release option works" "$SCRIPT_DIR/gem-publish.sh --help | grep -q 'automated-release'"
-    run_test "Auto commit range option works" "$SCRIPT_DIR/gem-publish.sh --help | grep -q 'auto-commit-range'"
-    # Test dry run with automated options
-    if [[ -f "$PROJECT_ROOT/lib/jekyll-theme-zer0/version.rb" ]]; then
-        run_test "Dry run with automated options" "$SCRIPT_DIR/gem-publish.sh patch --dry-run --automated-release --skip-tests --skip-publish --no-github-release | grep -q 'Automated Release Mode'"
-    fi
+# Test release command compatibility (replaces the retired gem-publish.sh)
+test_release_command() {
+    log_info "Testing release command compatibility..."
+    run_test "Release help works" "$RELEASE_BIN --help | grep -q 'VERSION TYPES'"
+    run_test "Dry-run option documented" "$RELEASE_BIN --help | grep -q -- '--dry-run'"
+    run_test "Skip-publish option documented" "$RELEASE_BIN --help | grep -q -- '--skip-publish'"
 }
 # Test workflow files syntax
 test_workflow_syntax() {
     log_info "Testing GitHub Actions workflow syntax..."
+    run_test "version-bump workflow exists" "test -f '$WORKFLOW_FILE'"
     # Check if yamllint is available
     if command -v yamllint >/dev/null 2>&1; then
-        run_test "Auto-version-bump workflow syntax" "yamllint '$PROJECT_ROOT/.github/workflows/auto-version-bump.yml'"
+        run_test "version-bump workflow syntax" "yamllint -c '$PROJECT_ROOT/.github/config/.yamllint.yml' '$WORKFLOW_FILE'"
     else
-        # Basic YAML syntax check with Python
-        if command -v python3 >/dev/null 2>&1; then
-            run_test "Auto-version-bump workflow syntax" "python3 -c 'import yaml; yaml.safe_load(open(\"$PROJECT_ROOT/.github/workflows/auto-version-bump.yml\"))'"
-        else
-            log_warning "Neither yamllint nor python3 available for YAML validation"
-        fi
+        # Basic YAML syntax check with Ruby (always present for this repo)
+        run_test "version-bump workflow syntax" "ruby -ryaml -e 'YAML.safe_load_file(\"$WORKFLOW_FILE\", aliases: true)'"
     fi
 }
-# Test file permissions and executability
-test_file_permissions() {
-    log_info "Testing file permissions..."
-    local scripts=(
-        "$SCRIPT_DIR/analyze-commits.sh"
-        "$SCRIPT_DIR/gem-publish.sh"
-    )
-    for script in "${scripts[@]}"; do
-        local script_name=$(basename "$script")
-        run_test "$script_name is executable" "test -x '$script'"
-    done
-}
 # Test integration between components
 test_integration() {
     log_info "Testing integration between components..."
-    # Test that analyze-commits.sh can be called by the workflow
-    if [[ -x "$SCRIPT_DIR/analyze-commits.sh" ]]; then
-        # Test with a simple commit range
-        if git rev-list --count HEAD >/dev/null 2>&1; then
-            local commit_count=$(git rev-list --count HEAD)
-            if [[ $commit_count -gt 0 ]]; then
-                run_test "Integration: commit analysis returns valid output" "$SCRIPT_DIR/analyze-commits.sh HEAD~1..HEAD | grep -E '^(patch|minor|major|none)$'"
-            fi
+    # The workflow invokes ./scripts/analyze-commits.sh and validates its output
+    if git rev-list --count HEAD >/dev/null 2>&1; then
+        local commit_count=$(git rev-list --count HEAD)
+        if [[ $commit_count -gt 0 ]]; then
+            run_test "Integration: commit analysis returns valid output" "$ANALYZE_WRAPPER HEAD~1..HEAD | grep -E '^(patch|minor|major|none)$'"
         fi
     fi
-    # Test that gem-publish.sh accepts the new parameters
-    if [[ -x "$SCRIPT_DIR/gem-publish.sh" ]]; then
-        run_test "Integration: gem-publish accepts automated params" "$SCRIPT_DIR/gem-publish.sh patch --dry-run --automated-release --auto-commit-range=HEAD~1..HEAD --skip-tests --skip-publish --no-github-release | grep -q 'DRY RUN MODE'"
-    fi
 }
 # Test conventional commit detection
 test_conventional_commits() {
     log_info "Testing conventional commit detection..."
-    # Create test commits in memory (don't actually commit)
-    local test_commits=(
-        "feat: add new feature"
-        "fix: resolve bug in component"
-        "BREAKING CHANGE: remove deprecated API"
-        "chore: update dependencies"
-        "docs: improve documentation"
-    )
-    local expected_results=(
-        "minor"
-        "patch"
-        "major"
-        "patch"
-        "patch"
-    )
-    # Note: This would require a more sophisticated test setup
-    # For now, just test that the patterns exist in the script
-    run_test "Conventional commit patterns exist" "grep -q 'feat.*minor' '$SCRIPT_DIR/analyze-commits.sh'"
-    run_test "Fix patterns exist" "grep -q 'fix.*patch' '$SCRIPT_DIR/analyze-commits.sh'"
-    run_test "Breaking change patterns exist" "grep -q 'BREAKING.*major' '$SCRIPT_DIR/analyze-commits.sh'"
+    # Test that the documented mapping exists in the analyzer
+    run_test "Conventional commit patterns exist" "grep -q 'feat.*minor' '$ANALYZE_IMPL'"
+    run_test "Fix patterns exist" "grep -q 'fix.*patch' '$ANALYZE_IMPL'"
+    run_test "Breaking change patterns exist" "grep -q 'BREAKING.*major' '$ANALYZE_IMPL'"
 }
 # Main test execution
@@ -182,18 +153,18 @@ main() {
     log_info "🧪 Starting Automated Version Bump System Tests"
     echo "=================================================="
     echo ""
     # Change to project root
     cd "$PROJECT_ROOT"
     # Run all test suites
     test_file_permissions
     test_commit_analysis
-    test_gem_publish_script
+    test_release_command
     test_workflow_syntax
     test_integration
     test_conventional_commits
     # Test summary
     echo ""
     echo "=================================================="
@@ -201,7 +172,7 @@ main() {
     echo "Tests Run: $TESTS_RUN"
     echo "Tests Passed: $TESTS_PASSED"
     echo "Tests Failed: $((TESTS_RUN - TESTS_PASSED))"
     if [[ $TESTS_PASSED -eq $TESTS_RUN ]]; then
         log_success "🎉 All tests passed! Automated version bump system is ready."
         exit 0
@@ -221,23 +192,18 @@ USAGE:
 DESCRIPTION:
     This script tests the automated version bump system including:
-    - Commit analysis functionality
-    - Gem publication script compatibility
-    - Workflow file syntax validation
+    - Commit analysis functionality (scripts/analyze-commits.sh wrapper
+      and scripts/utils/analyze-commits implementation)
+    - Release command compatibility (scripts/bin/release)
+    - Workflow file syntax validation (.github/workflows/version-bump.yml)
     - Integration between components
     - Conventional commit detection
 REQUIREMENTS:
     - Git repository with commit history
-    - Executable scripts in scripts/ directory
-    - Valid GitHub Actions workflow files
-OUTPUT:
-    Detailed test results and summary
-    Exit code 0 on success, 1 on failure
+    - Bash 3.2+ compatible environment
 EOF
     exit 0
 fi
-# Execute main function
-main "$@"
+main "$@"

data/scripts/test/integration/mermaid CHANGED Viewed

@@ -166,9 +166,7 @@ main() {
     log_info "Testing core files..."
     test_file_exists "_includes/components/mermaid.html" "Mermaid include file exists"
-    test_file_exists "pages/_docs/jekyll/mermaid.md" "Main documentation exists"
-    test_file_exists "pages/_docs/jekyll/mermaid-test-suite.md" "Test suite exists"
-    test_file_exists "pages/_docs/jekyll/jekyll-diagram-with-mermaid.md" "Tutorial exists"
+    test_file_exists "pages/_docs/features/mermaid-diagrams.md" "Main documentation exists"
     # Configuration tests
     log_info "Testing configuration..."
@@ -183,16 +181,14 @@ main() {
     test_file_content "_includes/components/mermaid.html" "site.mermaid.src" "Mermaid script from _config (local vendor path)"
     test_file_content "_includes/components/mermaid.html" "mermaid.initialize" "Mermaid initialization script"
-    test_file_content "_includes/components/mermaid.html" "forest" "Forest theme configured"
-    test_file_content "_includes/components/mermaid.html" "FontAwesome" "FontAwesome support included"
+    test_file_content "_includes/components/mermaid.html" "data-bs-theme" "Bootstrap theme detection configured"
+    test_file_content "_includes/components/mermaid.html" "getMermaidConfig" "Adaptive light/dark theming configured"
     # Documentation tests
     log_info "Testing documentation..."
-    test_file_content "pages/_docs/jekyll/mermaid.md" "mermaid: true" "Main docs have front matter"
-    test_file_content "pages/_docs/jekyll/mermaid-test-suite.md" "mermaid: true" "Test suite has front matter"
-    test_file_content "pages/_docs/jekyll/mermaid.md" "graph TD" "Main docs have examples"
-    test_file_content "pages/_docs/jekyll/mermaid-test-suite.md" "graph TD" "Test suite has examples"
+    test_file_content "pages/_docs/features/mermaid-diagrams.md" "mermaid: true" "Main docs have front matter"
+    test_file_content "pages/_docs/features/mermaid-diagrams.md" "graph TD" "Main docs have examples"
     # Server tests (if not quick mode)
     if [ "$QUICK" = false ]; then
@@ -204,11 +200,10 @@ main() {
             # Check if local server is running
             if curl -s -f "http://localhost:4000" >/dev/null 2>&1; then
-                test_url "http://localhost:4000/docs/jekyll/mermaid/" "Main documentation accessible"
-                test_url "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Test suite accessible"
-                test_mermaid_script "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Mermaid script loads on test page"
-                test_mermaid_init "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Mermaid initializes on test page"
-                test_diagram_rendering "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Diagrams render on test page"
+                test_url "http://localhost:4000/docs/features/mermaid-diagrams/" "Main documentation accessible"
+                test_mermaid_script "http://localhost:4000/docs/features/mermaid-diagrams/" "Mermaid script loads on docs page"
+                test_mermaid_init "http://localhost:4000/docs/features/mermaid-diagrams/" "Mermaid initializes on docs page"
+                test_diagram_rendering "http://localhost:4000/docs/features/mermaid-diagrams/" "Diagrams render on docs page"
             else
                 log_warning "Local Jekyll server not running. Start with: bundle exec jekyll serve"
             fi
@@ -220,11 +215,10 @@ main() {
             # Check if Docker container is running
             if docker ps | grep -q "zer0-mistakes-jekyll"; then
-                test_url "http://localhost:4000/docs/jekyll/mermaid/" "Docker: Main documentation accessible"
-                test_url "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Test suite accessible"
-                test_mermaid_script "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Mermaid script loads"
-                test_mermaid_init "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Mermaid initializes"
-                test_diagram_rendering "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Diagrams render"
+                test_url "http://localhost:4000/docs/features/mermaid-diagrams/" "Docker: Main documentation accessible"
+                test_mermaid_script "http://localhost:4000/docs/features/mermaid-diagrams/" "Docker: Mermaid script loads"
+                test_mermaid_init "http://localhost:4000/docs/features/mermaid-diagrams/" "Docker: Mermaid initializes"
+                test_diagram_rendering "http://localhost:4000/docs/features/mermaid-diagrams/" "Docker: Diagrams render"
             else
                 log_warning "Docker container not running. Start with: docker-compose up -d"
             fi

data/scripts/test/lib/test_changelog.sh CHANGED Viewed

@@ -87,4 +87,72 @@ test_categorization "security: patch vulnerability" "security"
 test_categorization "BREAKING: major change" "breaking"
 test_categorization "random commit" "other"
+# Test: update_changelog_file
+echo -e "\nTesting update_changelog_file..."
+# Each case runs in a throwaway directory; CHANGELOG_FILE is the relative
+# default ("CHANGELOG.md"), so the function operates on the temp copy.
+_changelog_tmp=$(mktemp -d)
+pushd "$_changelog_tmp" >/dev/null
+# Case 1: pending [Unreleased] notes are folded into the new entry and the
+# preamble stays at the top of the file.
+cat > CHANGELOG.md <<'FIXTURE'
+# Changelog
+All notable changes are documented here.
+## [Unreleased]
+### Added
+- Pending feature A
+## [1.0.0] - 2026-01-01
+### Added
+- Initial release
+FIXTURE
+update_changelog_file "## [1.1.0] - 2026-06-10
+### Changed
+- Version bump: minor release
+" >/dev/null 2>&1
+assert_false "grep -q '^## \[Unreleased\]' CHANGELOG.md" "Pending Unreleased section is consumed"
+assert_true "grep -q 'Pending feature A' CHANGELOG.md" "Pending notes are preserved"
+assert_equals "# Changelog" "$(head -n 1 CHANGELOG.md)" "Preamble heading stays on line 1"
+# The folded notes must land inside the new 1.1.0 entry (above 1.0.0)
+_pending_line=$(grep -n 'Pending feature A' CHANGELOG.md | cut -d: -f1)
+_v110_line=$(grep -n '^## \[1.1.0\]' CHANGELOG.md | cut -d: -f1)
+_v100_line=$(grep -n '^## \[1.0.0\]' CHANGELOG.md | cut -d: -f1)
+assert_true "[[ $_pending_line -gt $_v110_line && $_pending_line -lt $_v100_line ]]" "Folded notes live inside the new entry"
+# Case 2: without an Unreleased section the entry is inserted before the
+# first release heading, after the preamble.
+cat > CHANGELOG.md <<'FIXTURE'
+# Changelog
+All notable changes are documented here.
+## [1.0.0] - 2026-01-01
+### Added
+- Initial release
+FIXTURE
+update_changelog_file "## [1.0.1] - 2026-06-10
+### Fixed
+- A bug
+" >/dev/null 2>&1
+_v101_line=$(grep -n '^## \[1.0.1\]' CHANGELOG.md | cut -d: -f1)
+_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"
+popd >/dev/null
+rm -rf "$_changelog_tmp"
 echo -e "\n${GREEN}changelog.sh tests complete${NC}"

metadata CHANGED Viewed

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