jekyll-theme-zer0 1.28.0 → 1.30.0

data/_data/consumers.yml

@@ -44,6 +44,9 @@
 #                       version; tracked so a bump doesn't miss the config that
 #                       activates it
 #   path_gem            local path gem, unversioned (development only)
+#   gem_unconstrained   `gem 'jekyll-theme-zer0'` with no version — resolves
+#                       whatever RubyGems has at `bundle update` time; tracked
+#                       only (like resolved_lockfile), never reports drift
 # ==============================================================================
 
 version: 1
@@ -62,10 +65,18 @@ consumers:
     dispatch: false
     risk: >-
       Unpinned. Every push to this theme's main reaches production with no gate
-      and no rollback. Shadows ~55 theme files (5 layouts, 34 includes, 8 JS, 6
-      CSS, 2 plugins) — the largest override surface in the fleet, including
-      ~75 lines of !important CSS working around the stacking bug fixed in #338.
-      Recommend pinning and joining the fan-out.
+      and no rollback — that part is the real exposure. Recommend pinning and
+      joining the fan-out. NOTE: this entry previously claimed it "shadows ~55
+      theme files … ~75 lines of !important CSS working around #338", which
+      audit-consumer does not support. Only 2 files actually shadow a theme
+      file (_includes/content/giscus.html, assets/js/particles-source.js); the
+      other ~52 are it-journey's own quest-system layouts and includes that
+      share no filename with anything in this theme, so they carry no drift
+      risk at all. The !important CSS is real but is 31 lines in
+      assets/css/user-overrides.css — this theme's own documented extension
+      hook, enabled by `user_overrides: true`, not a shadow — and no fix
+      numbered #338 could be substantiated in that repo. Keep this field
+      derived from audit-consumer output, not hand-maintained estimates.
     pins:
       - file: _config.yml
         kind: remote_theme
@@ -109,6 +120,39 @@ consumers:
         kind: path_gem
         note: line 40 — dev checkout via ZER0_MISTAKES_PATH; never bumped
 
+  # ---------------------------------------------------------------------------
+  - repo: amr-bash/bash-365.com
+    mode: remote_theme_floating
+    site: https://bash-365.com
+    dispatch: false
+    note: >-
+      BASH Consulting's site, forked from bamr87/bashconsultants (which stays
+      registered above) and carrying the same three-stack shape: GitHub Pages
+      via remote_theme, Azure Static Web Apps via Gemfile.azure +
+      _config.azure.yml, local dev via a path gem. Unlike its parent, nothing
+      here carries a version any more — remote_theme is untagged and
+      Gemfile.azure names the gem with no constraint — so there is no pin for a
+      bump PR to rewrite. Declares its intentional forks in .theme-overrides.yml.
+    risk: >-
+      Unpinned on Pages; the Azure stack advances only when someone runs
+      `bundle update jekyll-theme-zer0`, so the two production stacks can
+      render different theme versions with nothing here to notice. Recommend
+      pinning remote_theme and constraining Gemfile.azure together and joining
+      the fan-out.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 33, no tag — floats main
+      - file: Gemfile.azure
+        kind: gem_unconstrained
+        note: line 10 — no version; `bundle update jekyll-theme-zer0` advances it
+      - file: _config.azure.yml
+        kind: theme_name
+        note: line 3 — activates the gem; no version of its own
+      - file: Gemfile
+        kind: path_gem
+        note: line 59 — dev checkout via ZER0_MISTAKES_PATH; never bumped
+
   # ---------------------------------------------------------------------------
   - repo: year-of-ai/year-of-ai.github.io
     mode: remote_theme_pinned
@@ -131,17 +175,121 @@ consumers:
 
   # ---------------------------------------------------------------------------
   - repo: ai-world-view/ai-world-view.github.io
-    mode: remote_theme_pinned
+    mode: remote_theme_floating
     site: https://ai-world-view.github.io
-    dispatch: true
+    dispatch: false
     fans_out_to_members: true
     note: >-
       Same two-file hub shape as year-of-ai; members join by auto_discover, so
-      the member count grows without this file changing.
+      the member count grows without this file changing. Was registered as
+      remote_theme_pinned until the 2026-09 fleet harmonization, but both its
+      _config.yml remote_theme and its hub.yml theme_repo carry NO tag — the
+      hub and every member it stamps float on this theme's main.
+    risk: >-
+      Unpinned, and an org hub: a theme break here reaches every auto-discovered
+      member site at once. Recommend pinning both files together and joining
+      the fan-out (dispatch: true) like year-of-ai.
     pins:
       - file: _config.yml
         kind: remote_theme
-        note: line 35
+        note: line 36, no tag — floats main
       - file: _data/hub.yml
         kind: hub_registry
-        note: "line 39 (pages.theme_repo) — re-roll members after bumping"
+        note: "line 39 (pages.theme_repo), no tag — members float too"
+
+  # ---------------------------------------------------------------------------
+  # The four entries below were missing entirely until the 2026-08 fleet audit.
+  # Unregistered consumers are invisible to propagate.rb in BOTH directions: no
+  # release dispatch reaches them, and they never appear in the weekly drift
+  # report — so their pins can rot indefinitely with nothing to notice. That is
+  # exactly what happened to zer0-pages, which sat three minors behind on a gem
+  # constraint that already permitted the current release.
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/zer0-pages
+    mode: gem
+    site: https://bamr87.github.io/zer0-pages/
+    dispatch: true
+    note: >-
+      Dual Obsidian-vault / Jekyll repo. Two things make it unlike every other
+      consumer. (1) It sets `source: pages`, so the whole themable tree lives
+      under pages/ — audit-consumer follows `source:` for this reason; auditing
+      the repo root reports a falsely clean result. (2) It is gem mode with no
+      remote_theme anywhere, so NOTHING is picked up automatically: the
+      scheduled bump is its only path to a new version.
+    risk: >-
+      Gemfile.lock resolved 1.25.0 while the Gemfile constraint (~> 1.25)
+      already permitted 1.28.0 — stale purely because nothing was nudging it.
+      Keeps two deliberate include forks, declared in its .theme-overrides.yml.
+    pins:
+      - file: Gemfile
+        kind: gem_constraint
+        note: 'line 11 — `gem "jekyll-theme-zer0", "~> 1.25"`'
+      - file: Gemfile.lock
+        kind: resolved_lockfile
+        note: "line 86 — re-lock with `bundle lock --update jekyll-theme-zer0`"
+      - file: _config.yml
+        kind: theme_name
+        note: "line 29 — `theme: jekyll-theme-zer0`; activates the gem, no version of its own"
+
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/irony-works
+    mode: remote_theme_floating
+    site: https://bamr87.github.io/irony-works/
+    dispatch: false
+    note: >-
+      Vault + Node engine; engine/scripts/transplant.mjs converts vault/ into
+      the _entries/ collection before Jekyll runs. Has NO Gemfile at all — it
+      builds via actions/jekyll-build-pages (the github-pages image), so it can
+      only ever be tracked as remote_theme_floating; there is no gem constraint
+      surface for a bump to rewrite.
+    risk: >-
+      Unpinned, and with no local preview path a contributor cannot see a theme
+      break before pushing. Keeps three deliberate overrides, declared in its
+      .theme-overrides.yml.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 4, no tag — floats main
+
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/wargames
+    mode: remote_theme_floating
+    site: https://bamr87.github.io/wargames/
+    dispatch: false
+    note: >-
+      Content-only vendored mirror of the OverTheWire challenges. Zero local
+      theme files — one of the cleanest consumers in the fleet. Its _config.yml
+      uses column-aligned YAML (`remote_theme             : "..."`), the style
+      that used to defeat audit-consumer's mode detection.
+    risk: >-
+      Unpinned, and its only build runs on push to main (jekyll-gh-pages.yml),
+      so a break ships before anyone sees it.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 44, no tag — floats main
+
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/zer0-pages-remote
+    mode: remote_theme_floating
+    site: https://bamr87.github.io/zer0-pages-remote/
+    dispatch: false
+    note: >-
+      The minimal reference consumer: _config.yml + Gemfile + index.md, no
+      local theme files and no _data at all, still showing the onboarding
+      wizard by design. Useful as the canary for what a stock remote_theme
+      consumer gets with zero customisation — if the theme breaks a bare site,
+      it breaks here first.
+    private: true
+    risk: >-
+      Unpinned. Low stakes (a demo, not a content site), but it has already
+      caught one real integration break: PR #8 fixed a Liquid `include_cached`
+      failure caused by a Gemfile plugin missing from the safe-mode whitelist.
+      This repo is PRIVATE, so an unauthenticated `propagate.rb` run reports it
+      "unreachable" rather than reading its pin — drift reporting needs a token
+      here even though it is read-only. CI already supplies one; a bare local
+      run will not.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 12, no tag — floats main

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)"
@@ -1037,6 +1040,7 @@ features:
       - "Client-side JSON search index"
       - "Bootstrap modal interface"
       - "Keyboard shortcut (/) activation"
+      - "Cmd/Ctrl+K shortcut with visible navbar affordance — a / kbd chip on the search button (design-system navbar pattern), hover titles with platform-aware Cmd-K/Ctrl+K, aria-keyshortcuts, and shortcut hints on the sidebar (b) and TOC (t) toggles"
       - "Real-time search results"
       - "Accessible search input"
       - "No external dependency (Algolia removed v1.5.1)"
@@ -1752,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
@@ -1770,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"
 
@@ -1917,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"
@@ -2218,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"
@@ -2256,3 +2262,280 @@ features:
       - "Immersive sidebar-free reading surface: storybook serif, responsive type scale, drop cap, plate styling for bare markdown images"
       - "illustrations: front matter renders a collapsed prompt colophon — the same list drives OpenAI image generation on consumer sites (drsai)"
       - "Demo book The Tales of Zer0 ships with the theme; reference platform: bamr87/drsai with Dodge & Reena as the test book"
+
+  - id: ZER0-081
+    title: "Claude Design System Round-Trip"
+    description: "Design-token layer aligned with the zer0-mistakes Claude Design project: corner-radius, logo-palette, and display-size tokens join _sass/tokens/; a git mirror of the design project lives under _design-system/ (plain-CSS tokens, React component specs from buttons to FABs to post cards to skeletons, foundation cards, website UI kit); and a CI parity check fails when theme and mirror drift"
+    implemented: true
+    version: "1.29.0"
+    link: "/"
+    docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/ui/design-system.md"
+    tags: [design-system, tokens, sass, ai, tooling]
+    date: 2026-08-14
+    provenance:
+      introduced_in: "1.29.0"
+      pr: 389
+      commit: "7fc2fe02"
+      issue: null
+    tests:
+      - "test/visual/core/styling.spec.js"
+      - "scripts/design-system-check.rb"
+    references:
+      styles:
+        - "_sass/tokens/_radius.scss"
+        - "_sass/tokens/_index.scss"
+      scripts:
+        - "scripts/design-system-check.rb"
+      design:
+        - "_design-system/components/"
+        - "_design-system/guidelines/"
+        - "_design-system/tokens/"
+      docs: "docs/ui/design-system.md"
+    features:
+      - "--zer0-radius-* corner radii, --zer0-logo-* brand palette, and --zer0-text-display-* fluid hero sizes declared once and consumed by callouts, landing cards, nav, and focus rings"
+      - "_design-system/ mirrors the claude.ai/design project (id e75121c0-9210-42d1-ade3-2c8af9111cbe) so interfaces can be designed in Claude Design and folded back into the theme — contract in _design-system/SYNC.md"
+      - "scripts/design-system-check.rb (core test suite) resolves var() alias chains and fails CI on token drift, plus flags fallback-less var(--zer0-*) references that are never declared"
+      - "Component specs ship the theme's primitives as React twins — Button, Badge, Fab/FabStack, Card, FeatureCard, PostCard, Callout, Skeleton, Input — with foundation cards for colors, type, spacing, motion, layers, and brand (PR 391)"
+      - "No webfonts, Bootstrap-first, seven skins, light+dark — the imported system and the theme now state one identical visual contract"
+
+  - id: ZER0-082
+    title: "Live Design System Pages"
+    description: "The design system published on the site itself: _design-system/ is force-included in the Jekyll build so tokens, styles.css, specimen cards, and component sources get real URLs under /_design-system/, and a /design/ hub page renders the foundation specimens in live iframes, catalogs the component twins, and links the Claude Design page canvas covering all 24 layouts"
+    implemented: true
+    version: "1.29.0"
+    link: "/design/"
+    docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/ui/design-system.md"
+    tags: [design-system, tokens, pages, navigation, ui]
+    date: 2026-08-14
+    provenance:
+      introduced_in: "1.29.0"
+      pr: 392
+      commit: "6ac9f77d"
+      issue: null
+    tests:
+      - "test/visual/features/design-hub.spec.js"
+    references:
+      pages:
+        - "pages/_about/design.md"
+      data:
+        - "_data/navigation/main.yml"
+      tests:
+        - "test/visual/features/design-hub.spec.js"
+      config: "_config.yml"
+    features:
+      - "Publishing is one config line — include: [_design-system] — so the mirror's plain-CSS tokens double as a hosted stylesheet any prototype can link"
+      - "/design/ foundations gallery renders the actual specimen cards in iframes against the published tokens — living documentation, never screenshots"
+      - "Component-twin catalog links every React spec (.jsx/.d.ts/.prompt.md) served raw from the mirror; interactive rendering stays in Claude Design"
+      - "Page canvas: every layout, nav pattern, and chrome surface recreated as a Claude Design presentation, linked from the hub with a screen-to-repo-file map"
+
+  # ============================================================================
+  # READER ENGAGEMENT (v1.29+)
+  # ============================================================================
+
+  - id: ZER0-083
+    title: "Page View Counter"
+    description: "Per-page view tracking with the count shown in the article meta row — a local-first provider that needs no server, or an HTTP counter endpoint, both gated by DNT, GPC, and consent"
+    implemented: true
+    version: "1.29.0"
+    link: "/"
+    docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/features/page-views.md"
+    tags: [analytics, privacy, engagement, metrics, ui]
+    date: 2026-08-23
+    provenance:
+      introduced_in: "1.29.0"
+      pr: 413
+      commit: "6ca4961b"
+      issue: null
+    tests:
+      - "test/visual/features/page-views.spec.js"
+    references:
+      layouts:
+        - "_layouts/article.html"
+      includes:
+        - "_includes/components/page-views.html"
+        - "_includes/components/page-views-init.html"
+        - "_includes/core/head.html"
+      scripts:
+        - "assets/js/page-views.js"
+      styles:
+        - "_sass/components/_page-views.scss"
+      tests:
+        - "test/visual/features/page-views.spec.js"
+      config: "_config.yml"
+      docs: "docs/features/page-views.md"
+    features:
+      - "Two providers: 'local' (default) keeps counts in the visitor's localStorage — no server, no network, GitHub-Pages safe; 'remote' reads a counter endpoint the site owns ({path} substitution, configurable method, dotted count_key)"
+      - "Privacy gates mirror the posthog block (DNT, Global Privacy Control, optional cookie-consent 'analytics' tie-in) and suppress RECORDING only — a view blocked pending consent is recorded when consent arrives"
+      - "dedupe: session counts one view per page per browser session, so a reload cannot inflate the number"
+      - "The badge ships hidden and is revealed only once a count exists — no '0 views' flash — and carries its own leading separator so a hidden badge leaves no dangling bullet in the meta row"
+      - "Every storage touch is probed and wrapped: private mode, blocked cookies, a corrupt payload, or an exceeded quota degrade to 'no count' instead of throwing"
+      - "window.zer0PageViews (get/all/refresh/reset) plus a 'zer0:page-views' CustomEvent let a site build on the count without polling"
+  - id: ZER0-084
+    title: "Cookbook & Recipes Collection"
+    description: "A `recipes` collection whose structured front matter (ingredients, steps, yield, times, ratio_basis) renders as a working recipe page: a fact bar, a serving scaler, an ingredient checklist, a numbered method, a build-time baker's-percentage table, and schema.org Recipe JSON-LD — with client-side scaling and US/metric conversion (volume↔weight via an ingredient density table) layered on as progressive enhancement"
+    implemented: true
+    version: "1.29.0"
+    link: "/recipes/"
+    docs: "/docs/features/cookbook-collection/"
+    tags: [recipes, cookbook, collections, layouts, unit-conversion, structured-data]
+    date: 2026-08-23
+    provenance:
+      introduced_in: "1.29.0"
+      pr: null
+      commit: "45354f34"
+      issue: null
+    tests:
+      - "test/test_core.sh"
+    references:
+      layouts:
+        - "_layouts/recipe.html"
+        - "_layouts/cookbook.html"
+      includes:
+        - "_includes/components/recipe-index.html"
+        - "_includes/components/recipe-card.html"
+        - "_includes/components/recipe-meta.html"
+        - "_includes/components/recipe-scaler.html"
+        - "_includes/components/recipe-ingredients.html"
+        - "_includes/components/recipe-steps.html"
+        - "_includes/components/recipe-ratio.html"
+        - "_includes/components/recipe-nutrition.html"
+        - "_includes/components/recipe-qty.html"
+        - "_includes/components/recipe-temp.html"
+        - "_includes/components/recipe-grams.html"
+        - "_includes/components/recipe-duration.html"
+      styles: ["_sass/components/_recipe.scss"]
+      scripts: ["assets/js/recipe-scaler.js"]
+      data:
+        - "_data/recipe_courses.yml"
+        - "_data/ingredient_densities.yml"
+      pages:
+        - "pages/_recipes/index.md"
+        - "pages/_docs/features/cookbook-collection.md"
+      config: "_config.yml"
+    components:
+      - "Serving scaler — stepper, ½×/1×/2×/3× presets, ?servings= and ?scale= links, per-recipe scale remembered in localStorage"
+      - "Unit switch — as written / metric / US, rewriting quantities, units and oven temperatures in place"
+      - "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/"