jekyll-theme-zer0 1.29.0 → 1.31.0

data/_data/features.yml

@@ -1,7 +1,7 @@
 # zer0-mistakes Theme Features Registry
 # Comprehensive feature tracking for the zer0-mistakes Jekyll theme
-# Version: 1.26.0
-# Last Updated: 2026-07-17
+# Version: 1.29.0
+# Last Updated: 2026-09-07
 
 features:
   # ============================================================================
@@ -435,22 +435,25 @@ features:
   
   - id: ZER0-013
     title: "Mermaid Diagram Support"
-    description: "Client-side Mermaid.js integration for 10+ diagram types. GitHub Pages compatible with no build plugins required"
+    description: "Client-side Mermaid.js diagrams for 10+ diagram types, rendered as accessible figures: a zoom / fullscreen / copy-source / SVG-export toolbar, accTitle captions, an error card that keeps the source visible, and colours derived from the live design tokens so diagrams follow the colour mode and skin. GitHub Pages compatible with no build plugins required"
     implemented: true
-    version: "0.3.0"
-    link: "/"
+    version: "1.30.0"
+    link: "/docs/features/mermaid-diagrams/"
     docs: "/docs/features/mermaid-diagrams/"
-    tags: [mermaid, diagrams, visualization, documentation]
-    date: 2025-01-27
+    tags: [mermaid, diagrams, visualization, documentation, accessibility, ui]
+    date: 2026-09-05
     provenance:
       introduced_in: "0.3.0"
       pr: null
       commit: "1a6184b"
       issue: null
     tests:
-      - "test/test_core.sh"
+      - "test/visual/features/mermaid.spec.js"
     references:
       include: "_includes/components/mermaid.html"
+      script: "assets/js/mermaid-diagrams.js"
+      styles: "_sass/components/_mermaid.scss"
+      evidence: "test/visual/mermaid-evidence.mjs"
       config: "_config.yml"
     diagram_types:
       - "Flowchart (graph TD)"
@@ -1753,14 +1756,14 @@ features:
       includes:
         - "_includes/content/backlinks.html"
   - id: ZER0-060
-    title: "AI Chat Assistant (Claude + GitHub)"
-    description: "Claude-powered floating chat grounded in the current page: streaming replies, GitHub issue/PR actions (after confirmation), and a dev-only mode that edits the page source file live"
+    title: "AI Chat Assistant (Claude or Grok + GitHub)"
+    description: "Floating chat grounded in the current page, answered by Claude or Grok through the proxy: streaming replies, GitHub issue/PR actions (after confirmation), and a dev-only mode that edits the page source file live"
     implemented: true
-    version: "1.18.0"
+    version: "1.30.0"
     link: "/docs/features/ai-chat-assistant/"
     docs: "/docs/features/ai-chat-assistant/"
-    tags: [ai, chatbot, claude, github, proxy, accessibility]
-    date: 2026-06-13
+    tags: [ai, chatbot, claude, grok, github, proxy, accessibility]
+    date: 2026-09-07
     provenance:
       introduced_in: "1.18.0"
       pr: 33
@@ -1771,7 +1774,7 @@ features:
     references:
       includes: ["_includes/components/ai-chat.html"]
       layouts: ["_layouts/root.html"]
-      scripts: ["assets/js/ai-chat.js", "templates/deploy/chat-proxy/worker.js", "templates/deploy/chat-proxy/dev-proxy.mjs", "templates/deploy/chat-proxy/page-store.mjs"]
+      scripts: ["assets/js/ai-chat.js", "templates/deploy/chat-proxy/worker.js", "templates/deploy/chat-proxy/providers.js", "templates/deploy/chat-proxy/dev-proxy.mjs", "templates/deploy/chat-proxy/page-store.mjs"]
       config: "_config.yml"
       instructions: ".github/instructions/ai-chat.instructions.md"
 
@@ -1918,25 +1921,27 @@ features:
 
   - id: ZER0-067
     title: "Setup Wizard"
-    description: "Multi-step in-browser wizard that assembles a complete _config.yml and lets you download or copy it, lowering first-run setup friction"
+    description: "Nine-step in-browser wizard that assembles a complete starter project — _config.yml, dev config, Gemfile, docker-compose, navigation, first pages — with per-file download and a self-extracting bundle; the form half of the Site Builder"
     implemented: true
-    version: "0.22.7"
+    version: "1.30.0"
     link: "/setup/"
-    docs: "/docs/quickstart/bare-minimum/"
+    docs: "/docs/features/site-builder/"
     tags: [setup, onboarding, configuration]
-    date: 2026-04-03
+    date: 2026-09-05
     provenance:
       introduced_in: "0.22.7"
       pr: 51
       commit: "a70ae8a5"
       issue: null
     tests:
-      - na: "Client-side config generator; exercised manually and via the build"
+      - "test/visual/features/setup-wizard.spec.js"
     references:
       include: "_includes/setup/wizard.html"
       scripts:
         - "assets/js/setup-wizard.js"
+      styles: ["_sass/components/_setup-wizard.scss"]
       layout: "_layouts/setup.html"
+      data: "_data/site_builder.yml"
 
   - id: ZER0-068
     title: "Table CSV Copy"
@@ -2191,7 +2196,7 @@ features:
       docs: "docs/systems/multilingual-translation.md"
     features:
       - "One large full-translation job (workflow_dispatch) plus bounded incremental runs when English content changes"
-      - "Manifest-driven SHA change detection, pruning of deleted sources, and generated /fr<en-url> permalinks (GitHub Pages safe-mode friendly)"
+      - "Manifest-driven SHA change detection, pruning of deleted sources, and generated /fr/... permalinks mirroring the English URLs (GitHub Pages safe-mode friendly)"
       - "Markdown-safe segment translation: code, Liquid, wiki-links and URLs masked as placeholders and validated"
       - "Navbar language toggle with availability states, hreflang alternates, per-page html lang, machine-translation notice"
 
@@ -2219,7 +2224,7 @@ features:
     features:
       - "Zero-config default: explicit /favicon.ico link on every page (fixes silent 404s and baseurl project sites)"
       - "Optional SVG favicon, PNG sizes, apple-touch-icon, and web manifest links"
-      - "theme-color meta sourced from favicon.theme_color with fallback to theme_color.main design token"
+      - "scheme-aware theme-color metas tracking --bs-body-bg (light #ffffff / dark #212529), emitted even with no config; favicon.theme_color pins a single value"
 
   - id: ZER0-080
     title: "Books Collection — Children's Picture-Book Publishing"
@@ -2413,3 +2418,124 @@ features:
       - "Volume↔weight conversion driven by _data/ingredient_densities.yml, overridable per ingredient with grams_per_cup"
       - "Baker's-percentage ratio table computed at build time, so percentages are correct with JavaScript disabled"
       - "Progressive enhancement: quantities render as authored by Jekyll; the control bar stays hidden until the script reveals it"
+
+  - id: ZER0-085
+    title: "Visual Evidence Autogen"
+    description: "CI produces a UI pull request's visual artifacts instead of only verifying them: before/after evidence from the PR's generator or a generic base-vs-head render, and 9-skin pixel baselines refreshed only when the reviewer agent judges the diff to be the change the PR describes"
+    implemented: true
+    version: "1.30.0"
+    link: "/"
+    docs: "/docs/development/testing/"
+    tags: [ci-cd, testing, automation, ai, quality]
+    date: 2026-09-05
+    provenance:
+      introduced_in: "1.30.0"
+      pr: 462
+      commit: "d0bfc0d1"
+      issue: null
+    tests:
+      - "scripts/ci/test_visual_evidence_autogen.py"
+    references:
+      workflow: ".github/workflows/visual-evidence-autogen.yml"
+      scripts:
+        - "scripts/ci/visual_evidence_autogen.py"
+        - "test/visual/pr-evidence.mjs"
+        - "test/visual/snapshot-diff-montage.mjs"
+        - "test/update-snapshots.sh"
+      agent: ".claude/agents/visual-evidence-reviewer.md"
+      docs: "docs/systems/continuous-evolution.md"
+    features:
+      - "Runs on every same-repo PR event: plans from the diff, brings Jekyll up with docker compose, and renders inside the same jammy Playwright image the snapshot gate compares with"
+      - "Evidence from the PR's own test/visual/*-evidence.mjs generators, or from the generic base-vs-head generator that renders the base branch and the head side by side — no hand-written unfixCss needed"
+      - "Pixel baselines are refreshed only on an 'intentional' verdict from the visual-evidence-reviewer agent, which views the expected | actual | diff montage; a code step disposes, the model only proposes (#417)"
+      - "Loop guard on its own [visual-autogen] commits, a three-commit budget per PR, per-folder manifests so author-made evidence is never overwritten, kill switch VISUAL_EVIDENCE_AUTOGEN_ENABLED=false, and the evidence gate's opt-out labels"
+      - "One sticky PR comment with the montages and the verdict; render output uploaded as an artifact on every run; the evidence gate now requires generated proof and ci-self-repair hands a red Visual Snapshots job to this lane"
+
+  - id: ZER0-086
+    title: "Claude-Guided Site Builder"
+    description: "An embedded Claude session that rides alongside the setup wizard: it sees every answer, fills in the forms, checks the machine, reads the theme's real source, writes the generated project to disk and starts Docker — through the local dev proxy, with a confirmation card before every action"
+    implemented: true
+    version: "1.30.0"
+    link: "/setup/"
+    docs: "/docs/features/site-builder/"
+    tags: [ai, claude, grok, setup, onboarding, docker, proxy]
+    date: 2026-09-07
+    provenance:
+      introduced_in: "1.30.0"
+      pr: null
+      commit: "331ae16c"
+      issue: null
+    tests:
+      - "test/visual/features/setup-wizard.spec.js"
+      - "test/test_wizard_store.mjs"
+    references:
+      includes:
+        - "_includes/setup/wizard.html"
+        - "_includes/setup/claude-session.html"
+        - "_includes/setup/prereq-checklist.html"
+      scripts:
+        - "assets/js/site-builder.js"
+        - "templates/deploy/chat-proxy/wizard-store.mjs"
+        - "templates/deploy/chat-proxy/dev-proxy.mjs"
+        - "test/visual/site-builder-walkthrough.mjs"
+        - "test/visual/site-builder-scenarios.mjs"
+      data: "_data/site_builder.yml"
+      config: "_config.yml"
+      instructions: ".github/instructions/ai-chat.instructions.md"
+      pages:
+        - "pages/_quickstart/site-builder.md"
+        - "pages/_docs/features/site-builder.md"
+    components:
+      - "Connect step — detects the dev proxy, shows the three commands to connect (claude setup-token → .env → node --env-file), re-checks every 15 s"
+      - "Prerequisites — live Docker/Git/gh/VS Code/Node/Claude CLI checks through a fixed command table, per-OS install commands from machine-setup, manual toggles offline"
+      - "Tools — get/set wizard fields, go to step, get/override generated files, read theme source, list theme dirs, search the docs index, resolve target, write project, docker compose up/ps/logs/down, check the site is live"
+      - "Context propagation — the whole wizard state, field schema and generated-file list are in the system prompt on every turn; the form is the single source of truth"
+      - "Safety — proxy-only (no credential in the page), escape-first rendering, confirmation cards for every mutation, scaffold confined to a new folder beside the theme"
+      - "Validation — test/visual/site-builder-walkthrough.mjs samples a random brief per site type (site-builder-scenarios.mjs), drives the wizard on video, builds the site with Docker and asserts routes/title/skin; replayable by seed"
+      - "Site plan — plan_schema in _data/site_builder.yml (JSON-Schema subset, validated in the browser) describes landing templates/sections, navigation style + sidebar, palette/font/radius overrides and example pages; set_site_plan applies it behind a confirmation card and the generators emit index.md + _data/landing.yml, navigation data, assets/css/user-overrides.css + _includes/custom/head.html and one file per planned page"
+      - "Providers, bring-your-own token, open sessions, project editing and image generation — see ZER0-087"
+
+  - id: ZER0-087
+    title: "Bring-Your-Own AI Provider (Claude or Grok) and Open Site Builder Sessions"
+    description: "The Site Builder and chat proxy answer with Claude (Anthropic) or Grok (xAI): users paste their own token on the Connect step, pick a model and an image renderer, and run a guided or open session that can also modify an existing site file by file and render images with Grok Imagine"
+    implemented: true
+    version: "1.30.0"
+    link: "/setup/"
+    docs: "/docs/features/site-builder/"
+    tags: [ai, claude, grok, xai, setup, onboarding, proxy, images]
+    date: 2026-09-07
+    provenance:
+      introduced_in: "1.30.0"
+      pr: null
+      commit: "b43a2bf6"
+      issue: null
+    tests:
+      - "test/test_providers.mjs"
+      - "test/test_wizard_store.mjs"
+      - "test/visual/features/setup-wizard.spec.js"
+    references:
+      includes:
+        - "_includes/setup/wizard.html"
+        - "_includes/setup/claude-session.html"
+      scripts:
+        - "assets/js/site-builder.js"
+        - "assets/js/setup-wizard.js"
+        - "templates/deploy/chat-proxy/providers.js"
+        - "templates/deploy/chat-proxy/credential-store.mjs"
+        - "templates/deploy/chat-proxy/worker.js"
+        - "templates/deploy/chat-proxy/dev-proxy.mjs"
+        - "templates/deploy/chat-proxy/wizard-store.mjs"
+        - "test/visual/site-builder-providers-evidence.mjs"
+      data: "_data/site_builder.yml"
+      config: "_config.yml"
+      instructions: ".github/instructions/ai-chat.instructions.md"
+      pages:
+        - "pages/_docs/features/site-builder.md"
+        - "pages/_quickstart/site-builder.md"
+    components:
+      - "Provider layer (providers.js, Worker + Node) — Anthropic Messages dialect translated to and from xAI's OpenAI-compatible chat API, streaming tool calls included, so ai-chat.js, site-builder.js and the feedback triage are unchanged; CHAT_PROVIDER / CHAT_MODEL / XAI_CHAT_MODEL pinned server-side, client models accepted only from the selected provider's family"
+      - "Connect step — Claude and Grok cards with masked key state, a password token field posted once to the localhost proxy (memory only, probed upstream, optional .env save with mode 600, Forget), model catalog, image renderer (Grok Imagine / OpenAI Images) and guided vs open session; the dev proxy starts without a credential"
+      - "Open session — chat-driven, any order, up to 24 tool rounds per turn with a Stop button; interrupted tool calls get synthetic results so the history stays valid"
+      - "Project session — list/open an existing site under WIZARD_TARGET_ROOT, tree/read, write/edit (unique snippet)/delete text files behind confirmation cards, git status/diff/log/init, jekyll build inside the container"
+      - "Image generation — generate_image renders with grok-imagine-image-2.0 (or gpt-image-2) into assets/ (PNG/JPEG/WebP sniffed, 8 MB cap) with a thumbnail card; generated sites carry ai_chat.provider, preview_images and the matching .env.example keys"
+      - "Validation — test/test_providers.mjs (mock xAI + Anthropic upstreams), test/test_wizard_store.mjs (project + asset rules), setup-wizard.spec.js (mocked proxy: connect as Grok, token never stored, open mode, existing sites), evidence in test/visual/evidence/site-builder-providers/"

data/_data/feedback_types.yml

@@ -16,11 +16,16 @@
 #   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.
+#   labels       GitHub labels applied to the issue. Drawn from the FLEET
+#                ISSUE-PIPELINE label set (bamr87/bamr87 _data/fleet.yml
+#                issue_pipeline.labels.types: bug feature docs chore ci refactor
+#                test security question) plus optional area:*, so an issue filed
+#                from this widget is pipeline-eligible on the next scan instead
+#                of carrying labels only this repo understands.
+#                Every one 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.
 #   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
@@ -50,7 +55,7 @@
   group: This page
   scope: page
   description: Polish the copy, structure, or presentation
-  labels: [enhancement, "area:docs"]
+  labels: [docs]
   agent: true
   directive: >-
     Act as a content editor for the page in Page Context. Tighten copy, fix
@@ -64,7 +69,7 @@
   group: This page
   scope: page
   description: Add depth, examples, or a section a reader would expect
-  labels: [enhancement, "area:docs"]
+  labels: [docs]
   agent: true
   directive: >-
     Expand the page in Page Context with concrete examples, prerequisites, and
@@ -77,7 +82,7 @@
   group: This page
   scope: page
   description: Stale versions, dead links, or old screenshots
-  labels: [documentation, "area:docs"]
+  labels: [docs]
   agent: true
   directive: >-
     Audit the page in Page Context for stale versions, dead links, and outdated
@@ -90,7 +95,7 @@
   group: This page
   scope: page
   description: Contrast, keyboard, screen-reader, or focus problems
-  labels: ["area:a11y"]
+  labels: [bug, "area:a11y"]
   agent: true
   directive: >-
     Audit the page in Page Context against WCAG 2.1 AA for the reported barrier
@@ -105,7 +110,7 @@
   group: The site
   scope: site
   description: A design or usability refinement for the theme
-  labels: [enhancement, "area:feat"]
+  labels: [feature]
   agent: true
   directive: >-
     Propose a Bootstrap-first UI/UX refinement, using the page in Page Context
@@ -118,7 +123,7 @@
   group: The site
   scope: site
   description: Slow load, layout shift, or heavy assets
-  labels: ["area:perf"]
+  labels: [bug, "area:perf"]
   agent: true
   directive: >-
     Profile the page in Page Context (LCP, CLS, INP), identify the bottleneck,
@@ -131,7 +136,7 @@
   group: The site
   scope: site
   description: Propose a new site-wide capability
-  labels: [enhancement, "area:feat"]
+  labels: [feature]
   agent: false
   directive: ""
   placeholder: What should it do, and who benefits?

data/_data/landing.yml

@@ -22,12 +22,15 @@ hero:
     label: "Features"
     url: "/features/"
     icon: "bi-list-check"
-    variant: "outline"
+    # This hero is `bg-primary text-white`, so its outlined buttons need the
+    # light variant. Plain `outline` is an outlined PRIMARY button, for the
+    # normal page background — see components/cta-button.html.
+    variant: "outline-light"
   cta_tertiary:
     label: "GitHub"
     url: ""                # falls back to site.resources.github_repo
     icon: "bi-github"
-    variant: "outline"
+    variant: "outline-light"
     external: true
 
 # Features section ------------------------------------------------------------

data/_data/navigation/quickstart.yml

@@ -9,6 +9,10 @@
   url: /quickstart/
   expanded: true
   children:
+    - title: "Site Builder (guided)"
+      url: /quickstart/site-builder/
+      icon: bi-magic
+      description: "Let Claude walk you from prerequisites to a running site"
     - title: "1. Machine Setup"
       url: /quickstart/machine-setup/
       icon: bi-laptop