jekyll-theme-zer0 1.24.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f65c3a0d1bdabc361ffa201b1ef8718b51d9d90ac9f562d465cbcf11da23cff3
-  data.tar.gz: 5a688bea4feaf4b0408a072cf0d23dea6922aaab810dfea9e71f5e6d55147b29
+  metadata.gz: af7de9769f05880ab652483a7ff6109e79d04ff6404c71163822ce4cecac3d23
+  data.tar.gz: 7c968f45cbba4655ad0eb5aa25a55e7b5f178957d65036d47236ba7809592733
 SHA512:
-  metadata.gz: 021abbb9996ad7419ce2d27e73ece0234e79f63b8fca7f9ce1619406f91d5e61eabe9ab352257dc09df144c45a75ffa79aa9ff4120c354384fdf3c65420d2557
-  data.tar.gz: 01f76088c04901271942a073140c1ab38ac98bb1ed9ec2defa4d20cb532e331589415f341fa62a0dc34e20ad4a6194a6d9e34477e35d601a8e3593e96d830f22
+  metadata.gz: 3ec2a5423346be22b17120fc586396501218877b70373eae7df03395b4b91211e8d03cf45d79ec71ad717344eae248b967dd5e810092cbf045f0d796ffad1c61
+  data.tar.gz: 55ec85fa55c7ca9c918413e16c86d3a275301a0282a989039face47fad9b9e3dc27f5fcda6ff7eb5e74faf0a557e8307c43a059e2e2bd1ebf8df011e46e82b9c

data/CHANGELOG.md

@@ -5,6 +5,129 @@ 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.26.0](https://github.com/bamr87/zer0-mistakes/compare/v1.25.0...v1.26.0) (2026-07-07)
+
+
+### Features
+
+* **feedback:** runtime "Improve this page" capture → GitHub issue (logs + AI triage) ([#286](https://github.com/bamr87/zer0-mistakes/issues/286)) ([f7fb20d](https://github.com/bamr87/zer0-mistakes/commit/f7fb20df74c22df7eb823344121c60617f06c7b6))
+
+## [Unreleased]
+
+### Changed
+
+- **CI test tiering** — the PR-blocking Playwright gate is now the new
+  `critical` project (118 `@critical`-tagged, user-facing tests: navigation,
+  search, mobile survival, theming baseline, security) instead of the full
+  331-test `smoke` tier; the full smoke tier, the complete shell-suite
+  matrix, and the 9-skin pixel snapshots moved to a nightly workflow
+  (`nightly-extended.yml`) that files a sticky issue on failure instead of
+  blocking PRs. Install/deploy/site-generation shell suites run on PRs only
+  when install-related paths change (always nightly).
+
+### Added
+
+- **Weekly agentic UI/UX audit** (`ui-audit.yml`) — a deterministic
+  Playwright sweep (`test/ui-audit/sweep.mjs`: screenshots, axe WCAG 2.1 AA,
+  console errors, overflow, broken internal links across critical routes ×
+  3 viewports) interpreted by a read-only Claude Code agent
+  (`.claude/agents/ui-auditor.md`) against the component contract in
+  `docs/architecture/ui-components.md`; findings are filed as a
+  `source:ui-audit` issue feeding the continuous-evolution loop.
+
+## [1.25.0](https://github.com/bamr87/zer0-mistakes/compare/v1.24.0...v1.25.0) (2026-07-03)
+
+
+### Features
+
+* **features:** reverse-traceability source tags — applied and enforced ([#270](https://github.com/bamr87/zer0-mistakes/issues/270)) ([f2c0c07](https://github.com/bamr87/zer0-mistakes/commit/f2c0c073c08bce62956a56b4b3e77d48a00ba309))
+* **includes:** rebuild settings offcanvas into 3 coherent tabs ([#276](https://github.com/bamr87/zer0-mistakes/issues/276)) ([6d7fa5e](https://github.com/bamr87/zer0-mistakes/commit/6d7fa5e028a540576205462cb37797f6ee11c98a))
+* **navigation:** collection-aware sidebar modes with shared resolver ([#273](https://github.com/bamr87/zer0-mistakes/issues/273)) ([104285f](https://github.com/bamr87/zer0-mistakes/commit/104285fbed2d27646549c9aa956dea5108d91f77))
+
+
+### Bug Fixes
+
+* **features:** stop ZER0-061 card from swallowing every following card ([#268](https://github.com/bamr87/zer0-mistakes/issues/268)) ([46a604d](https://github.com/bamr87/zer0-mistakes/commit/46a604d1bf4331422b382bf895aeecae928fda70))
+* **navigation:** remove redundant entries from navigation menus ([916eca2](https://github.com/bamr87/zer0-mistakes/commit/916eca269726c984c5c0c9dc9533c83d9975f906))
+* **sass:** mobile audit — contain author card, restore consent z-order, grow tap targets ([#275](https://github.com/bamr87/zer0-mistakes/issues/275)) ([8ec9867](https://github.com/bamr87/zer0-mistakes/commit/8ec9867858ff87e9b8a6fcd4a68ec7e50582c3c1))
+
+## [Unreleased]
+
+### Changed
+
+- **Settings panel rebuilt** — the navbar Settings offcanvas (`#info-section`)
+  is reorganized from four overlapping tabs (Settings / Environment /
+  Developer / Background) into three with one purpose each, guarded by the
+  new `test/visual/settings-panel.spec.js` smoke suite
+  (evidence: [`test/visual/evidence/settings-panel/`](test/visual/evidence/settings-panel/README.md)
+  — 4 tabs → 3, duplicate color-mode controls 6 → 3, dead search box
+  removed, admin links 0 → 4):
+  - **Appearance** consolidates every look-and-feel control exactly once:
+    color mode (one-click segmented control replacing the two-click
+    dropdown), theme skin, background toggle + layer opacity with inline
+    values, and the primary-color picker — now mounted *inside* the tab
+    instead of appended below the tab content where it duplicated the
+    color-mode buttons under every tab.
+  - **Site** stacks the environment card (copyable page URL via a delegated
+    `data-zer0-copy` handler — inline `onclick` handlers removed),
+    quick links, deduplicated theme & build info, and Admin quick links.
+  - **Developer** keeps page location (rendered only where breadcrumbs
+    render — no more empty heading on the homepage), page metadata, and
+    source shortcuts (dead never-initialized tooltip attributes dropped).
+  - The dead Settings-tab search box (an empty `#searchbox` no JS ever
+    bound to) is removed; the search modal remains the one search surface.
+  - Mobile tabs keep their text labels (their accessible names) at every
+    width and drop the decorative icons instead of the reverse.
+
+### Fixed
+
+- **Settings panel admin links never rendered** — the
+  `_plugins/admin_page_urls.rb` lookup powering them never ran: the
+  `github-pages` gem forces safe mode and randomizes `plugins_dir`, so local
+  `_plugins` are disabled on GitHub Pages, in CI, and in the Docker dev
+  server alike. The plugin is replaced with a pure-Liquid scan in the cached
+  `_includes/components/admin-links.html` (jekyll-include-cache is
+  whitelisted), so the Admin section now renders its existence-gated links
+  (0 → 4 on the demo site).
+
+- **Mobile responsive audit** — four defects found by driving every key route
+  and component under phone emulation (320–414px), each guarded by the new
+  `test/visual/mobile-responsive.spec.js` smoke suite
+  (evidence: [`test/visual/evidence/mobile-responsive/`](test/visual/evidence/mobile-responsive/README.md) —
+  author-card page overflow 19px → 0 on small phones; consent buttons 0
+  tap-blocked; all footer/copy tap targets ≥24px):
+  - **Author card**: a long nowrap expertise badge propagated through flexbox
+    `min-width: auto` and pushed the whole page past the viewport on ≤340px
+    phones, widening the layout viewport so the fixed navbar rendered "cut
+    off" and the page panned sideways.
+  - **Cookie consent banner**: the `.zer0-bg-body` child-elevation rule
+    flattened the banner (and the TOC FAB) to `z-index: 1`, letting the chat
+    and local-graph FABs paint over — and steal taps from — the banner's
+    Reject All / Accept All buttons on mobile. The rule now excludes
+    `.position-fixed`, restoring the `--zer0-layer-*` token order.
+  - **Footer tap targets**: text links (~19px) and icon-only social links
+    (~16px) now meet the WCAG 2.5.8 24px minimum via block padding and
+    minimum boxes — text size and visual design unchanged.
+  - **Breadcrumb tap targets**: breadcrumb links (~19px bare text) gain a
+    ≥24px tap box via block padding + matching negative margin, without
+    shifting the visual baseline.
+  - **Code-copy buttons**: grown from ~22px to ≥24px tall (32px on
+    coarse/touch pointers).
+  - **ToC / chat FAB collision**: on mobile, the table-of-contents FAB and
+    the AI-chat toggle both claimed the right-edge slot above back-to-top
+    and overlapped (ToC painting over the chat button). The chat toggle and
+    its panel now step one slot higher on pages that render the ToC FAB,
+    and the chat panel is capped to the viewport so it can't poke above
+    short tablet/landscape screens.
+
+### Added
+
+- **Mobile test tier**: `test/visual/mobile-responsive.spec.js` runs the above
+  guards plus offcanvas-menu, search-modal, and settings-panel fit/tap checks
+  under real Pixel-class emulation in the `smoke` tier; `npm run test:mobile`
+  runs just this suite. New `dismissCookieConsent` fixture pre-seeds the
+  consent choice for tests that interact with lower-screen chrome.
+
 ## [1.24.0](https://github.com/bamr87/zer0-mistakes/compare/v1.23.0...v1.24.0) (2026-07-01)
 
 
@@ -42,6 +165,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Bug Fixes
 
+* **features:** stop a feature card from swallowing every card after it on `/features/` — a raw `<key>` in the ZER0-061 description rendered as a stray HTML element. Fixed the description (`/authors/:key/`), escaped all `description` output on the features page and in `feature-card.html`, and added a registry-gate check that rejects raw `<`/`>` in titles/descriptions. (evidence: [`test/visual/evidence/features-card-escape/`](test/visual/evidence/features-card-escape/README.md))
 * **includes:** existence-guard component-showcase demo links — breadcrumb and list-group items now render as real links when the target page exists in the build (`/docs/`, `/docs/customization/`, `/categories/`, `/tags/`) and as plain text when absent; removes inert `href="#"` / `onclick="return false;"` workaround ([#219](https://github.com/bamr87/zer0-mistakes/issues/219)) (evidence: [`test/visual/evidence/component-showcase/`](test/visual/evidence/component-showcase/README.md))
 
 ### Tests

data/README.md

@@ -655,7 +655,7 @@ git commit -m "feat: add new component"
 # Docker-specific tests
 ./test/test_deployment.sh
 
-# Frontend smoke tests (Playwright; starts Jekyll on :4011 unless BASE_URL is set)
+# Frontend smoke tests (Playwright; starts Jekyll on :4000 unless BASE_URL is set)
 npm run test:smoke
 # Pixel regression (skin homepage screenshots; baselines committed for Linux)
 npm run test:snapshots
@@ -757,11 +757,11 @@ All workflows live under [`.github/workflows/`](.github/workflows/).
 
 | # | Workflow | File | Trigger | Purpose |
 |---|----------|------|---------|---------|
-| 1 | **Comprehensive CI Pipeline** | [`ci.yml`](.github/workflows/ci.yml) | push / PR / dispatch | Detect changes → fast checks → quality control → matrix test suite → integration tests → build & validate |
-| 2 | **TEST (Latest Dependencies)** | [`test-latest.yml`](.github/workflows/test-latest.yml) | daily schedule / push / PR / dispatch | Zero-pin Docker build with bleeding-edge gems; tests then promotes passing images to Docker Hub |
+| 1 | **Comprehensive CI Pipeline** | [`ci.yml`](.github/workflows/ci.yml) | push / PR / dispatch | Detect changes → quality control (incl. quick preflight) → matrix test suite → integration tests → build & validate |
+| 2 | **TEST (Latest Dependencies)** | [`test-latest.yml`](.github/workflows/test-latest.yml) | daily schedule / push / dispatch | Zero-pin Docker build with bleeding-edge gems; tests then promotes passing images to Docker Hub |
 | 3 | **Release** | [`release.yml`](.github/workflows/release.yml) | push to `main` | release-please opens a release PR from Conventional Commits; merging it tags `vX.Y.Z` and publishes the gem to [RubyGems](https://rubygems.org/gems/jekyll-theme-zer0) |
 | 4 | **Update Dependencies** | [`update-dependencies.yml`](.github/workflows/update-dependencies.yml) | weekly schedule | Refreshes `Gemfile.lock` to latest compatible versions and opens an automated PR |
-| 5 | **CodeQL Security Scanning** | [`codeql.yml`](.github/workflows/codeql.yml) | push / PR on code paths + weekly | Static security analysis across Ruby, JavaScript/TypeScript, Python, Actions, and YAML |
+| 5 | **CodeQL Security Scanning** | [`codeql.yml`](.github/workflows/codeql.yml) | push / PR on code paths + weekly | Static security analysis across Ruby, JavaScript/TypeScript, Python, and Actions |
 | 6 | **Content & Docs Review** | [`ai-content-review.yml`](.github/workflows/ai-content-review.yml) | PR on docs/content | Deterministic SEO/quality review + optional Claude agent + docs front matter, internal-link, and markdownlint checks |
 | 7 | **Convert Jupyter Notebooks** | [`convert-notebooks.yml`](.github/workflows/convert-notebooks.yml) | push to `pages/_notebooks/**.ipynb` | Auto-converts `.ipynb` → Jekyll-friendly Markdown with extracted images |
 | 8 | **Sync** | [`sync.yml`](.github/workflows/sync.yml) | push affecting `_data/backlog.yml` or `_data/roadmap.yml` | Mirrors the backlog to GitHub Issues and regenerates the README roadmap section |

data/_data/authors.yml

@@ -1,3 +1,4 @@
+# Feature: ZER0-061
 # Authors Data File
 # =================
 # Define author profiles for blog posts

data/_data/backlog.yml

@@ -63,7 +63,7 @@
 meta:
   title: "zer0-mistakes Backlog"
   updated: 2026-06-29
-  next_id: 33
+  next_id: 34
 
 tasks:
   # --- Housekeeping (seeded so the loop has work on day one) ------------------
@@ -863,3 +863,28 @@ tasks:
     links: { issue: 241, pr: 253, roadmap: null }
     created: 2026-06-29
     updated: 2026-06-29
+
+  - id: T-033
+    title: "Retire legacy test_installation.sh after equivalence audit against the installer harness"
+    status: open
+    priority: P2
+    area: tests
+    risk: standard
+    effort: M
+    source: user
+    route: test-author
+    summary: >-
+      test_installation.sh (~1,000 lines, "legacy install.sh CLI args") predates the
+      modern test_installer.sh + test_install_*.sh harness and largely overlaps it.
+      Audit each of its scenarios against the harness, port anything genuinely
+      uncovered into test_install_*.sh, then delete the legacy suite and remove the
+      `installation` routing from test_runner.sh, ci.yml, and nightly-extended.yml.
+      Until then it runs nightly and on install-path PRs only (2026-07 CI tiering).
+    acceptance:
+      - "Every test_installation.sh scenario is mapped to a harness equivalent or ported."
+      - "test_installation.sh deleted; test_runner.sh no longer routes an `installation` suite."
+      - "ci.yml and nightly-extended.yml suite lists updated; docs (test/README.md) updated."
+      - "Nightly extended run green after removal."
+    links: { issue: null, pr: null, roadmap: null }
+    created: 2026-07-06
+    updated: 2026-07-06

data/_data/features.yml

@@ -1,7 +1,7 @@
 # zer0-mistakes Theme Features Registry
 # Comprehensive feature tracking for the zer0-mistakes Jekyll theme
-# Version: 1.23.0
-# Last Updated: 2026-06-30
+# Version: 1.25.0
+# Last Updated: 2026-07-03
 
 features:
   # ============================================================================
@@ -23,8 +23,8 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/component-showcase.spec.js"
-      - "test/visual/styling.spec.js"
+      - "test/visual/features/component-showcase.spec.js"
+      - "test/visual/core/styling.spec.js"
     references:
       layouts: ["_layouts/root.html", "_layouts/default.html"]
       includes: ["_includes/core/head.html"]
@@ -216,7 +216,7 @@ features:
       issue: null
     tests:
       - "test/test_quality.sh"
-      - "test/visual/security.spec.js"
+      - "test/visual/core/security.spec.js"
     references:
       include: "_includes/analytics/posthog.html"
       config: "_config.yml"
@@ -277,7 +277,7 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/interactions.spec.js"
+      - "test/visual/features/sidebar-navigation.spec.js"
     references:
       javascript:
         - "assets/js/modules/navigation/sidebar-state.js"
@@ -317,8 +317,8 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
-      - "test/visual/accessibility.spec.js"
+      - "test/visual/features/layouts.spec.js"
+      - "test/visual/core/accessibility.spec.js"
     references:
       javascript:
         - "assets/js/modules/navigation/keyboard.js"
@@ -351,8 +351,7 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
-      - "test/visual/ui-refresh.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       include: "_includes/navigation/sidebar-right.html"
       styles: "_sass/custom.scss"
@@ -379,7 +378,7 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/accessibility.spec.js"
+      - "test/visual/core/accessibility.spec.js"
     references:
       include: "_includes/core/header.html"
       styles: "_sass/custom.scss"
@@ -621,7 +620,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layouts:
         - "_layouts/root.html"
@@ -667,7 +666,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/component-showcase.spec.js"
+      - "test/visual/features/component-showcase.spec.js"
     references:
       includes:
         - "_includes/core/"
@@ -932,7 +931,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       scripts:
         - "assets/js/back-to-top.js"
@@ -957,7 +956,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       scripts:
         - "assets/js/code-copy.js"
@@ -983,7 +982,7 @@ features:
       commit: "55bee97"
       issue: null
     tests:
-      - "test/visual/color-mode-default.spec.js"
+      - "test/visual/features/appearance.spec.js"
     references:
       scripts:
         - "assets/js/modules/theme/appearance.js"
@@ -1015,8 +1014,7 @@ features:
       commit: "21eb458"
       issue: null
     tests:
-      - "test/visual/search.spec.js"
-      - "test/visual/search-degradation.spec.js"
+      - "test/visual/features/search.spec.js"
     references:
       scripts:
         - "assets/js/search-modal.js"
@@ -1048,7 +1046,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/navbar.spec.js"
     references:
       scripts:
         - "assets/js/auto-hide-nav.js"
@@ -1073,7 +1071,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/backgrounds.spec.js"
+      - "test/visual/features/appearance.spec.js"
     references:
       scripts:
         - "assets/js/particles.js"
@@ -1105,7 +1103,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/giscus-comments.spec.js"
+      - "test/visual/features/comments.spec.js"
     references:
       includes:
         - "_includes/content/giscus.html"
@@ -1140,7 +1138,7 @@ features:
       commit: "31f827e"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       docs:
         - "pages/_docs/features/mathjax-math.md"
@@ -1165,8 +1163,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
-      - "test/visual/ui-refresh.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       includes:
         - "_includes/content/toc.html"
@@ -1251,8 +1248,8 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
-      - "test/visual/authors-breadcrumb-degradation.spec.js"
+      - "test/visual/features/layouts.spec.js"
+      - "test/visual/features/authors.spec.js"
     references:
       includes:
         - "_includes/navigation/breadcrumbs.html"
@@ -1421,7 +1418,7 @@ features:
       issue: null
     tests:
       - "test/test_obsidian.sh"
-      - "test/visual/obsidian-callouts.spec.js"
+      - "test/visual/features/obsidian-callouts.spec.js"
     references:
       includes:
         - "_includes/obsidian/full-graph.html"
@@ -1471,7 +1468,7 @@ features:
       issue: null
     tests:
       - "test/test_core.sh"
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       page: "404.html"
       docs: "pages/_docs/features/smart-404.md"
@@ -1512,8 +1509,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/ui-refresh.spec.js"
-      - "test/visual/navbar-responsive.spec.js"
+      - "test/visual/features/navbar.spec.js"
     references:
       includes:
         - "_includes/navigation/navbar.html"
@@ -1533,8 +1529,7 @@ features:
       commit: "27550da"
       issue: null
     tests:
-      - "test/visual/admin-layout.spec.js"
-      - "test/visual/admin-nav.spec.js"
+      - "test/visual/features/admin.spec.js"
     references:
       layout: "_layouts/admin.html"
       includes:
@@ -1645,8 +1640,7 @@ features:
       commit: "5533f34"
       issue: null
     tests:
-      - "test/visual/navbar-responsive.spec.js"
-      - "test/visual/ui-refresh.spec.js"
+      - "test/visual/features/navbar.spec.js"
     references:
       scripts:
         - "assets/js/modules/"
@@ -1753,7 +1747,7 @@ features:
       commit: "341cc67"
       issue: null
     tests:
-      - "test/visual/ai-chat.spec.js"
+      - "test/visual/features/ai-chat.spec.js"
     references:
       includes: ["_includes/components/ai-chat.html"]
       layouts: ["_layouts/root.html"]
@@ -1767,7 +1761,7 @@ features:
 
   - id: ZER0-061
     title: "Author Profiles System"
-    description: "Auto-generated author profile pages and a searchable author directory from _data/authors.yml — each author gets a /authors/<key>/ hub with bio, stats, and a filterable grid of their content across collections"
+    description: "Auto-generated author profile pages and a searchable author directory from _data/authors.yml — each author gets a /authors/:key/ hub with bio, stats, and a filterable grid of their content across collections"
     implemented: true
     version: "1.20.0"
     link: "/authors/"
@@ -1780,7 +1774,7 @@ features:
       commit: "a6db3042"
       issue: null
     tests:
-      - "test/visual/authors-breadcrumb-degradation.spec.js"
+      - "test/visual/features/authors.spec.js"
     references:
       plugin: "_plugins/author_pages_generator.rb"
       layouts:
@@ -1805,7 +1799,7 @@ features:
       commit: "53132416"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layout: "_layouts/news.html"
 
@@ -1824,8 +1818,8 @@ features:
       commit: "06691f93"
       issue: null
     tests:
-      - "test/visual/section-sidebar-tags-gate.spec.js"
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/sidebar-navigation.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layout: "_layouts/section.html"
 
@@ -1844,7 +1838,7 @@ features:
       commit: "06691f93"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layout: "_layouts/article.html"
       include: "_includes/components/post-type-badge.html"
@@ -1864,9 +1858,8 @@ features:
       commit: "27550dac"
       issue: null
     tests:
-      - "test/visual/skins.spec.js"
-      - "test/visual/backgrounds.spec.js"
-      - "test/visual/theme-colors.spec.js"
+      - "test/visual/features/appearance.spec.js"
+      - "test/visual/features/appearance-snapshot.spec.js"
     references:
       scripts:
         - "assets/js/background-customizer.js"
@@ -1999,7 +1992,7 @@ features:
       commit: "7ba0f834"
       issue: null
     tests:
-      - "test/visual/component-showcase.spec.js"
+      - "test/visual/features/component-showcase.spec.js"
     references:
       include: "_includes/components/component-showcase.html"
 
@@ -2109,3 +2102,38 @@ features:
       - na: "CI security scan — .github/workflows/secret-scan.yml"
     references:
       workflow: ".github/workflows/secret-scan.yml"
+
+  - id: ZER0-077
+    title: "Unified Settings Panel"
+    description: "Navbar settings offcanvas reorganized into Appearance, Site, and Developer tabs — consolidated color-mode/skin/background controls, delegated copy-to-clipboard, and existence-gated admin quick links computed in cached Liquid"
+    implemented: true
+    version: "1.25.0"
+    link: "/"
+    docs: "/docs/customization/includes/"
+    tags: [ui, navigation, bootstrap, accessibility]
+    date: 2026-07-02
+    provenance:
+      introduced_in: "1.25.0"
+      pr: 276
+      commit: "3b951604"
+      issue: null
+    tests:
+      - "test/visual/features/settings-panel.spec.js"
+    references:
+      includes:
+        - "_includes/components/info-section.html"
+        - "_includes/components/admin-links.html"
+        - "_includes/components/halfmoon.html"
+        - "_includes/components/env-switcher.html"
+        - "_includes/components/theme-info.html"
+        - "_includes/components/background-settings.html"
+        - "_includes/components/dev-shortcuts.html"
+      scripts:
+        - "assets/js/halfmoon.js"
+        - "assets/js/modules/theme/appearance.js"
+      sass:
+        - "_sass/utilities/_layout.scss"
+    features:
+      - "Appearance tab: one-click color mode, 9 theme skins, background layer opacity, primary color"
+      - "Site tab: environment badge, copyable page URL, quick links, theme & build info, admin links"
+      - "Developer tab: breadcrumb page location, page metadata, source-code shortcuts"