jekyll-theme-zer0 1.25.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ffe866835e858107f670f29086f904914d21bf1159d8c6eb3cbd138f79caf64
-  data.tar.gz: d26f27d6460136cc9f2da67da26523721b52b0e7525e0811498910215e2f29e2
+  metadata.gz: af7de9769f05880ab652483a7ff6109e79d04ff6404c71163822ce4cecac3d23
+  data.tar.gz: 7c968f45cbba4655ad0eb5aa25a55e7b5f178957d65036d47236ba7809592733
 SHA512:
-  metadata.gz: 50038606f12260b1382fceee13299e6f8a9ca0b08b00ba18e285ed88ee762fd425e853d6fde39e8c9f72f8b345f841b04b29a3e4b095a89c36f01dc4d267d036
-  data.tar.gz: e2e2764ca02d2d10250c768beb66ca7b7ba44c60b22e1852f3993f245080b5b2d3ad532245b33e394a078ae912cc60b28b33ee9fb23403194a1e75183841d925
+  metadata.gz: 3ec2a5423346be22b17120fc586396501218877b70373eae7df03395b4b91211e8d03cf45d79ec71ad717344eae248b967dd5e810092cbf045f0d796ffad1c61
+  data.tar.gz: 55ec85fa55c7ca9c918413e16c86d3a275301a0282a989039face47fad9b9e3dc27f5fcda6ff7eb5e74faf0a557e8307c43a059e2e2bd1ebf8df011e46e82b9c

data/CHANGELOG.md

@@ -5,6 +5,36 @@ 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)
 
 

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

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.24.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"]
@@ -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"
 
@@ -2125,7 +2118,7 @@ features:
       commit: "3b951604"
       issue: null
     tests:
-      - "test/visual/settings-panel.spec.js"
+      - "test/visual/features/settings-panel.spec.js"
     references:
       includes:
         - "_includes/components/info-section.html"

data/_data/feedback_types.yml

@@ -0,0 +1,148 @@
+# _data/feedback_types.yml
+#
+# Request types for the page-feedback capture widget:
+#   _includes/components/page-feedback.html + assets/js/page-feedback.js
+#
+# This REPLACES the build-time "Copilot Agent" dropdown that baked
+# _data/prompts.yml into every <a href> at build time. The widget now injects
+# this list as JSON and assembles the GitHub issue at RUNTIME, so it can also
+# attach live page context and a captured console-log buffer — things a
+# build-time Liquid link can never see.
+#
+# ─── Schema (per entry) ──────────────────────────────────────────────────────
+#   id           unique slug — used in the issue title tag ([id]) and analytics
+#   label        short text shown in the type selector
+#   icon         Bootstrap Icons class (https://icons.getbootstrap.com/)
+#   group        section header in the selector ("This page" | "The site")
+#   scope        page | site — targets this page, or the theme as a whole
+#   description  one-line helper shown under the label
+#   labels       GitHub labels applied to the issue. MUST already exist in the
+#                repo: GitHub SILENTLY DROPS unknown labels from a prefilled URL
+#                (this was the old feature's `labels=ai-agent` bug). Verify with
+#                `gh label list`. The marker label from
+#                site.page_feedback.default_labels is added on top of these.
+#   agent        true  → assign @copilot and attach `directive` for autonomous work
+#                false → human triage only (no assignee, no directive)
+#   directive    compact agent instruction. Kept SHORT on purpose — it rides in
+#                the prefilled issue URL, and long bodies blow the URL-length
+#                budget. The full context table + logs are added by the widget.
+#   placeholder  textarea placeholder tailored to this request type
+# ─────────────────────────────────────────────────────────────────────────────
+
+# ─── This page — scoped to the page the widget was opened from ───────────────
+
+- id: fix-page
+  label: Report a problem
+  icon: bi-bug
+  group: This page
+  scope: page
+  description: A typo, broken link, wrong information, or something rendering badly
+  labels: [bug]
+  agent: true
+  directive: >-
+    Reproduce and fix the reported defect on the page identified in Page
+    Context. Keep the change minimal and surgical; verify with a Jekyll build.
+  placeholder: What is wrong, where on the page, and what did you expect instead?
+
+- id: improve-page
+  label: Improve this page
+  icon: bi-stars
+  group: This page
+  scope: page
+  description: Polish the copy, structure, or presentation
+  labels: [enhancement, "area:docs"]
+  agent: true
+  directive: >-
+    Act as a content editor for the page in Page Context. Tighten copy, fix
+    grammar, improve heading hierarchy and visual rhythm — without changing the
+    core message or breaking links.
+  placeholder: What would make this page clearer, tighter, or more useful?
+
+- id: expand-page
+  label: Add missing detail
+  icon: bi-arrows-angle-expand
+  group: This page
+  scope: page
+  description: Add depth, examples, or a section a reader would expect
+  labels: [enhancement, "area:docs"]
+  agent: true
+  directive: >-
+    Expand the page in Page Context with concrete examples, prerequisites, and
+    any expected-but-missing sections. Preserve tone and front matter.
+  placeholder: What is missing? Which examples or sections would help?
+
+- id: update-page
+  label: Flag outdated content
+  icon: bi-arrow-clockwise
+  group: This page
+  scope: page
+  description: Stale versions, dead links, or old screenshots
+  labels: [documentation, "area:docs"]
+  agent: true
+  directive: >-
+    Audit the page in Page Context for stale versions, dead links, and outdated
+    screenshots; refresh them and bump `lastmod`.
+  placeholder: What is out of date? Paste the stale value or link if you can.
+
+- id: accessibility
+  label: Accessibility issue
+  icon: bi-universal-access
+  group: This page
+  scope: page
+  description: Contrast, keyboard, screen-reader, or focus problems
+  labels: ["area:a11y"]
+  agent: true
+  directive: >-
+    Audit the page in Page Context against WCAG 2.1 AA for the reported barrier
+    (contrast, keyboard, focus, ARIA, alt text) and propose concrete fixes.
+  placeholder: What barrier did you hit? Which assistive tech or input method?
+
+# ─── The site — theme-wide UI, components, features, performance ──────────────
+
+- id: ui-ux
+  label: UI / UX improvement
+  icon: bi-palette
+  group: The site
+  scope: site
+  description: A design or usability refinement for the theme
+  labels: [enhancement, "area:feat"]
+  agent: true
+  directive: >-
+    Propose a Bootstrap-first UI/UX refinement, using the page in Page Context
+    as the starting example. Cover responsive behaviour, dark mode, and a11y.
+  placeholder: What feels off, and how might it look or behave instead?
+
+- id: performance
+  label: Performance
+  icon: bi-speedometer2
+  group: The site
+  scope: site
+  description: Slow load, layout shift, or heavy assets
+  labels: ["area:perf"]
+  agent: true
+  directive: >-
+    Profile the page in Page Context (LCP, CLS, INP), identify the bottleneck,
+    and propose GitHub Pages-safe fixes.
+  placeholder: What felt slow? On what device / connection?
+
+- id: feature
+  label: Feature request
+  icon: bi-lightbulb
+  group: The site
+  scope: site
+  description: Propose a new site-wide capability
+  labels: [enhancement, "area:feat"]
+  agent: false
+  directive: ""
+  placeholder: What should it do, and who benefits?
+
+- id: question
+  label: Ask a question
+  icon: bi-question-circle
+  group: The site
+  scope: site
+  description: Something unclear — not necessarily a bug
+  labels: [question]
+  agent: false
+  directive: ""
+  placeholder: What are you trying to do, and where did you get stuck?

data/_data/navigation/README.md

@@ -74,7 +74,7 @@
 # - The theme also clips stray horizontal page overflow at the root, so an
 #   over-stuffed nav or wide content can never make the fixed navbar look "cut
 #   off". Wide tables/code keep their own local scroll. Regression-guarded by
-#   test/visual/navbar-responsive.spec.js.
+#   test/visual/features/navbar.spec.js.
 #
 # ## Schema Validation
 #

data/_includes/components/README.md

@@ -91,6 +91,7 @@ If a component needs a token that doesn't exist yet, propose it in `_sass/tokens
 | `info-section.html`      | Settings offcanvas — Appearance / Site / Developer.   |
 | `js-cdn.html`            | Body-end script bundle.                               |
 | `search-modal.html`      | Global search modal.                                  |
+| `page-feedback.html`     | "Improve this page" capture widget — request type + live page context + captured console logs → GitHub issue (base prefill + optional AI enrichment). Pairs with `assets/js/page-feedback.js` and `core/console-capture.html`; types from `_data/feedback_types.yml`. |
 
 ## Adding a new component