jekyll-theme-zer0 1.26.0 → 1.28.0

data/README.md

@@ -44,14 +44,7 @@ hero_image: /assets/images/wizard-on-journey.png
 excerpt: "AI-native Jekyll theme for GitHub Pages — multi-agent ready (Copilot, Codex, Cursor, Claude), AI-powered install & preview images, AIEO-optimized, with Docker-first development and 43 documented features"
 ---
 
-[![pages-build-deployment](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment)
-[![Gem Version](https://badge.fury.io/rb/jekyll-theme-zer0.svg)](https://badge.fury.io/rb/jekyll-theme-zer0)
-[![CI](https://github.com/bamr87/zer0-mistakes/actions/workflows/ci.yml/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Docker](https://img.shields.io/badge/docker-ready-blue.svg)](https://github.com/bamr87/zer0-mistakes/blob/main/docker-compose.yml)
-[![Bootstrap](https://img.shields.io/badge/Bootstrap-5.3.3-purple.svg)](https://getbootstrap.com/)
-[![AI-Native](https://img.shields.io/badge/AI--Native-Copilot%20%7C%20Codex%20%7C%20Cursor%20%7C%20Claude-8A2BE2)](AGENTS.md)
-[![AIEO](https://img.shields.io/badge/AIEO-Optimized-ff69b4)](#-aieo-optimized--built-for-ai-citation)
+[![pages-build-deployment](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/pages/pages-build-deployment) [![Gem Version](https://badge.fury.io/rb/jekyll-theme-zer0.svg)](https://badge.fury.io/rb/jekyll-theme-zer0) [![CI](https://github.com/bamr87/zer0-mistakes/actions/workflows/ci.yml/badge.svg)](https://github.com/bamr87/zer0-mistakes/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Docker](https://img.shields.io/badge/docker-ready-blue.svg)](https://github.com/bamr87/zer0-mistakes/blob/main/docker-compose.yml) [![Bootstrap](https://img.shields.io/badge/Bootstrap-5.3.3-purple.svg)](https://getbootstrap.com/) [![AI-Native](https://img.shields.io/badge/AI--Native-Copilot%20%7C%20Codex%20%7C%20Cursor%20%7C%20Claude-8A2BE2)](AGENTS.md) [![AIEO](https://img.shields.io/badge/AIEO-Optimized-ff69b4)](#-aieo-optimized--built-for-ai-citation)
 
 # zer0-mistakes
 
@@ -155,9 +148,7 @@ The installer auto-detects your operating system, sets up Docker, downloads the
 
 ## 🎯 Bare-Minimum Starter (3 files, zero install)
 
-Don't want to run the installer? You can publish a working site to GitHub
-Pages with **just three files** in your repo. The remote theme provides every
-layout, style, and even an in-browser configuration wizard.
+Don't want to run the installer? You can publish a working site to GitHub Pages with **just three files** in your repo. The remote theme provides every layout, style, and even an in-browser configuration wizard.
 
 ```text
 my-site/
@@ -200,11 +191,7 @@ title: Home
 # Welcome to my site
 ```
 
-Push to a GitHub Pages–enabled repository and visit your site. Until you set
-`site_configured: true`, the home page renders the **welcome layout** — a hero
-card and a full in-browser wizard that generates a personalised `_config.yml`
-you can download. Flip the flag (or fill in `title`/`founder`/`email`) and your
-own content takes over.
+Push to a GitHub Pages–enabled repository and visit your site. Until you set `site_configured: true`, the home page renders the **welcome layout** — a hero card and a full in-browser wizard that generates a personalised `_config.yml` you can download. Flip the flag (or fill in `title`/`founder`/`email`) and your own content takes over.
 
 ---
 
@@ -248,7 +235,7 @@ zer0-mistakes treats AI as core infrastructure across **install → author → b
 | **File-scoped instructions** | `applyTo:` globs auto-load guidance for `_layouts/`, `_includes/`, `scripts/`, `test/`, `docs/`, version files | [`.github/instructions/`](.github/instructions/) |
 | **Reusable agent prompts** | `commit-publish`, `frontmatter-maintainer`, `seed` (full-rebuild blueprint) | [`.github/prompts/`](.github/prompts/) |
 | **Cursor slash-commands** | Mirrors prompts as `/commit-publish`, `/frontend-run-improve` | [`.cursor/commands/`](.cursor/commands/) |
-| **AI preview images** | Jekyll plugin + script generate OpenAI/DALL·E images for posts missing previews | [`_plugins/preview_image_generator.rb`](_plugins/preview_image_generator.rb), [`scripts/generate-preview-images.sh`](scripts/generate-preview-images.sh) |
+| **AI preview images** | Python engine + script generate OpenAI/DALL·E images for posts missing previews | [`scripts/lib/preview_generator.py`](scripts/lib/preview_generator.py), [`scripts/generate-preview-images.sh`](scripts/generate-preview-images.sh) |
 | **AI release pipeline** | Conventional-commit analyzer chooses MAJOR/MINOR/PATCH, writes CHANGELOG, tags & publishes | [`scripts/analyze-commits.sh`](scripts/analyze-commits.sh), [`scripts/bin/release`](scripts/bin/release) |
 | **AIEO content layer** | `SoftwareApplication`, `WebPage`, `FAQPage`, `Person` JSON-LD; glossary; FAQ; dated roadmap | [See AIEO section](#-aieo-optimized--built-for-ai-citation) |
 
@@ -303,7 +290,7 @@ zer0-mistakes is a layered system: your content (Markdown + YAML) flows through
 | **Development** | Docker | Cross-platform consistency |
 | **Templates** | Liquid | Dynamic content rendering |
 | **AI Agents** | Copilot · Codex · Cursor · Claude Code · Aider · Jules · Continue | Multi-tool agentic development via [`AGENTS.md`](AGENTS.md) + `.github/instructions/` |
-| **AI Content** | OpenAI Images API | AI-generated preview images via [`_plugins/preview_image_generator.rb`](_plugins/preview_image_generator.rb) |
+| **AI Content** | OpenAI Images API | AI-generated preview images via [`scripts/lib/preview_generator.py`](scripts/lib/preview_generator.py) |
 | **AI Automation** | Conventional-commit analyzer | Auto semantic versioning + changelog ([`scripts/analyze-commits.sh`](scripts/analyze-commits.sh)) |
 | **AIEO** | JSON-LD + FAQ + Glossary schema | Optimized for AI citation and retrieval |
 | **Analytics** | PostHog | Privacy-first tracking |
@@ -430,8 +417,7 @@ GDPR/CCPA compliant PostHog integration with granular consent: it respects Do No
 
 ### 🧠 Obsidian Vault Integration
 
-Edit your content as an [Obsidian](https://obsidian.md) vault — same files,
-same git history, identical rendering on the published site:
+Edit your content as an [Obsidian](https://obsidian.md) vault — same files, same git history, identical rendering on the published site:
 
 - **Open repo as a vault**: shared `.obsidian/` config commits with the repo.
 - **Wiki-links** `[[Page Title]]` and aliases `[[Page|Alias]]` resolve to permalinks.
@@ -440,17 +426,14 @@ same git history, identical rendering on the published site:
 - **Backlinks panel** auto-renders on every note (and on any page with `backlinks: true`).
 - **Inline tags** `#topic` link to the tag index, hierarchical tags supported.
 - **Zero plugin requirements**: works on the default GitHub Pages
-  `remote_theme` build via a client-side resolver
-  (`assets/js/obsidian-wiki-links.js`) backed by a Liquid-generated
-  `assets/data/wiki-index.json`.
+`remote_theme` build via a client-side resolver (`assets/js/obsidian-wiki-links.js`) backed by a Liquid-generated `assets/data/wiki-index.json`.
 
 ```bash
 # Open the repo root as an Obsidian vault, edit, then commit & push
 git commit -am "note: today's thinking" && git push
 ```
 
-Read the [Obsidian docs](pages/_docs/obsidian/) for setup, syntax reference,
-authoring workflow, and troubleshooting.
+Read the [Obsidian docs](pages/_docs/obsidian/) for setup, syntax reference, authoring workflow, and troubleshooting.
 
 ### 📓 Jupyter Notebook Support
 
@@ -646,8 +629,8 @@ git commit -m "feat: add new component"
 ### Testing Commands
 
 ```bash
-# Quick validation
-./test/test_installation.sh
+# Quick validation (preflight)
+./scripts/validate --quick
 
 # Full test suite
 ./test/test_runner.sh --verbose

data/_data/authors.yml

@@ -47,11 +47,12 @@
 #                         generator. When a post sets `author: <this key>`, these
 #                         values WIN over _config.yml › preview_images for that
 #                         post's banner, giving each AI author a distinct look.
-#                         (scripts/features/generate-preview-images and
-#                          scripts/lib/preview_generator.py read this block.)
+#                         (Read by the consolidated engine
+#                          scripts/lib/preview_generator.py — every provider.)
 #     style: ..           Art-style prompt fragment (overrides preview_images.style).
 #     style_modifiers: .. Extra modifiers (overrides preview_images.style_modifiers).
-#     size/quality/model: Optional generator overrides (bash generator only).
+#     size/quality/model: Optional generator overrides (all providers; a model
+#                         from another vendor family falls back to the default).
 
 default:
   name: "Zer0-Mistakes Team"

data/_data/backlog.yml

@@ -888,3 +888,31 @@ tasks:
     links: { issue: null, pr: null, roadmap: null }
     created: 2026-07-06
     updated: 2026-07-06
+  - id: T-034
+    title: "Remove the dead preview_image_generator.rb Jekyll plugin and its test surface"
+    status: done
+    priority: P3
+    area: infra
+    risk: standard
+    effort: M
+    source: user
+    route: code-fixer
+    summary: >-
+      _plugins/preview_image_generator.rb never loads anywhere (the github-pages gem
+      forces safe mode + a randomized plugins_dir), and the consolidated Python engine
+      (scripts/lib/preview_generator.py, ZER0-004) now owns all generation logic while
+      _includes/components/preview-image.html + _includes/content/seo.html cover
+      rendering in pure Liquid. Remove the plugin, its PreviewImageGeneratorTest half
+      of test/test_plugins.rb, the consumer fixture
+      test/fixtures/consumer-remote/_plugins/preview_image_generator.rb, and its
+      entries in REQUIRED_PLUGIN_FILES (scripts/bin/audit-consumer, sync-plugins,
+      manifest) and the installer SOURCE/DEST_FILES. Touches CODEOWNERS-owned
+      _plugins/ and scripts/bin/ paths, so this is a human-review PR.
+    acceptance:
+      - "_plugins/preview_image_generator.rb deleted; docs no longer advertise its Liquid filters."
+      - "test_plugins.rb keeps its content-statistics coverage; preview plugin specs removed."
+      - "audit-consumer/sync-plugins/manifest lists and the consumer fixture updated; test_audit.sh green."
+      - "install-preview-generator no longer ships the plugin; installer tests green."
+    links: { issue: 302, pr: null, roadmap: null }
+    created: 2026-07-12
+    updated: 2026-07-16

data/_data/consumers.yml

@@ -0,0 +1,147 @@
+# ==============================================================================
+# _data/consumers.yml — downstream consumers of this theme
+# ==============================================================================
+#
+# The registry that makes theme releases propagate instead of sitting unnoticed.
+# Every site that renders with zer0-mistakes is listed here together with HOW it
+# consumes the theme and WHICH files hold its version pin.
+#
+# Read by:
+#   - scripts/bin/propagate         report pin drift; dispatch release events
+#   - .github/workflows/propagate-theme.yml   release fan-out
+#
+# Why this exists: nothing connected a release to the sites built on it. When
+# 1.27.0 shipped, all five consumers were still on v1.26.0 (or floating on main)
+# and none of them knew. Bumps were a manual, five-repo chore that nobody
+# remembered, so pins drifted until a site broke.
+#
+# ------------------------------------------------------------------------------
+# Consumption modes
+# ------------------------------------------------------------------------------
+#   remote_theme_pinned    `remote_theme: bamr87/zer0-mistakes@vX.Y.Z` — GitHub
+#                          Pages fetches the tagged theme at build time. Gets a
+#                          bump PR on release.
+#   remote_theme_floating  `remote_theme: bamr87/zer0-mistakes` with no tag —
+#                          tracks main, so every push to this repo reaches
+#                          production immediately. Nothing to bump; what these
+#                          need is a canary, not a PR. See `risk` below.
+#   gem                    `gem "jekyll-theme-zer0", "~> X.Y.Z"` — the theme is
+#                          resolved from RubyGems, not GitHub. Bumping means
+#                          editing a Gemfile and re-locking. This is the mode the
+#                          scheduled updater matters most for: no remote_theme
+#                          means no automatic pickup of anything, ever.
+#   path                   `gem "jekyll-theme-zer0", path: ...` — a local
+#                          checkout for development. Never version-pinned and
+#                          never bumped; listed so audits don't flag it.
+#
+# ------------------------------------------------------------------------------
+# Pin kinds (scripts/bin/propagate knows how to read/rewrite each)
+# ------------------------------------------------------------------------------
+#   remote_theme        `remote_theme: "bamr87/zer0-mistakes@vX.Y.Z"` in a config
+#   hub_registry        `theme_repo: bamr87/zer0-mistakes@vX.Y.Z` in _data/hub.yml
+#   gem_constraint      `gem 'jekyll-theme-zer0', '~> X.Y.Z'` in a Gemfile
+#   theme_name          `theme: "jekyll-theme-zer0"` — names the gem, carries no
+#                       version; tracked so a bump doesn't miss the config that
+#                       activates it
+#   path_gem            local path gem, unversioned (development only)
+# ==============================================================================
+
+version: 1
+
+defaults:
+  branch: main
+  # repository_dispatch event type consumers listen for. Their side of the
+  # contract lives in templates/consumer/theme-bump.yml.
+  dispatch_event: theme-release
+
+consumers:
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/it-journey
+    mode: remote_theme_floating
+    site: https://it-journey.dev
+    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.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 36, no tag — floats main
+
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/lifehacker.dev
+    mode: remote_theme_floating
+    site: https://lifehacker.dev
+    dispatch: false
+    risk: >-
+      Unpinned, same exposure as it-journey. Small override surface (2 includes).
+      Recommend pinning and joining the fan-out.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 40, no tag — floats main
+
+  # ---------------------------------------------------------------------------
+  - repo: bamr87/bashconsultants
+    mode: gem
+    site: https://bashconsultants.com
+    dispatch: true
+    note: >-
+      Three stacks, three theme surfaces: GitHub Pages uses the pinned
+      remote_theme, Azure Static Web Apps resolves the published gem via
+      Gemfile.azure + _config.azure.yml, and local dev mounts a path gem. A bump
+      must move the remote_theme tag and the gem constraint together or the two
+      production stacks render different theme versions.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 31
+      - file: Gemfile.azure
+        kind: gem_constraint
+        note: line 9 — must match the remote_theme tag
+      - 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 40 — dev checkout via ZER0_MISTAKES_PATH; never bumped
+
+  # ---------------------------------------------------------------------------
+  - repo: year-of-ai/year-of-ai.github.io
+    mode: remote_theme_pinned
+    site: https://year-of-ai.github.io
+    dispatch: true
+    fans_out_to_members: true
+    note: >-
+      An org hub, not just a site. Its _data/hub.yml theme_repo is the value
+      stamped into every member repo's _config.yml by scripts/provision-org-sites.rb,
+      so one bump here re-rolls the whole org (12 sites). The hub's own
+      _config.yml and hub.yml must move together — they are read by different
+      code paths and drift silently otherwise.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 40
+      - file: _data/hub.yml
+        kind: hub_registry
+        note: "line 42 (pages.theme_repo) — re-roll members after bumping"
+
+  # ---------------------------------------------------------------------------
+  - repo: ai-world-view/ai-world-view.github.io
+    mode: remote_theme_pinned
+    site: https://ai-world-view.github.io
+    dispatch: true
+    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.
+    pins:
+      - file: _config.yml
+        kind: remote_theme
+        note: line 35
+      - file: _data/hub.yml
+        kind: hub_registry
+        note: "line 39 (pages.theme_repo) — re-roll members after bumping"

data/_data/features.yml

@@ -1,7 +1,7 @@
 # zer0-mistakes Theme Features Registry
 # Comprehensive feature tracking for the zer0-mistakes Jekyll theme
-# Version: 1.25.0
-# Last Updated: 2026-07-03
+# Version: 1.26.0
+# Last Updated: 2026-07-17
 
 features:
   # ============================================================================
@@ -80,7 +80,7 @@ features:
       issue: null
     tests:
       - "test/test_installer.sh"
-      - "test/test_installation.sh"
+      - "test/test_install_legacy_flags.sh"
     references:
       script: "install.sh"
       cli: "scripts/bin/install"
@@ -106,13 +106,13 @@ features:
   
   - id: ZER0-004
     title: "AI Preview Image Generator"
-    description: "AI-powered automatic preview image generation for posts using OpenAI gpt-image-2 / DALL-E, Stability AI, xAI, or local placeholders. Configurable assets prefix, retro pixel art defaults, batch regeneration"
+    description: "Claude-orchestrated preview-image engine: Claude analyzes each article into an art brief and vision-reviews the render (one corrective regeneration), while OpenAI gpt-image-2 / DALL-E (default), xAI, Stability AI, Google Gemini, or a deterministic local template renders. Per-author styles, batch regeneration"
     implemented: true
-    version: "1.5.0"
+    version: "1.27.0"
     link: "/docs/features/preview-image-generator/"
     docs: "/docs/features/preview-image-generator/"
-    tags: [ai, images, automation, openai, content]
-    date: 2025-01-28
+    tags: [ai, images, automation, claude, openai, content]
+    date: 2026-07-12
     provenance:
       introduced_in: "1.5.0"
       pr: 83
@@ -120,9 +120,11 @@ features:
       issue: null
     tests:
       - "test/test_core.sh"
+      - "test/test_preview_generator.py"
     references:
-      plugin: "_plugins/preview_image_generator.rb"
+      engine: "scripts/lib/preview_generator.py"
       script: "scripts/generate-preview-images.sh"
+      rasterizer: "scripts/dev/rasterize-svg.js"
       install: "scripts/install-preview-generator.sh"
       config: "_config.yml"
       include: "_includes/components/preview-image.html"
@@ -130,25 +132,33 @@ features:
       script: "scripts/install-preview-generator.sh"
       config_section: "preview_images"
     dependencies:
-      required: [curl, jq]
-      optional: [yq, python3]
+      required: [python3, pyyaml]
+      optional: [librsvg, inkscape, imagemagick, node]
+    orchestration:
+      name: claude
+      description: "Claude analyzes articles into art briefs and vision-reviews renders (prompt_engine/review_engine)"
+      env_var: CLAUDE_CODE_OAUTH_TOKEN
     providers:
       - name: openai
-        description: "OpenAI gpt-image-2 / DALL-E 3 image generation"
+        description: "OpenAI gpt-image-2 / DALL-E 3 image generation (default renderer; + --enhance edits)"
         env_var: OPENAI_API_KEY
-      - name: stability
-        description: "Stability AI Stable Diffusion"
-        env_var: STABILITY_API_KEY
       - name: xai
         description: "xAI Grok image generation"
         env_var: XAI_API_KEY
+      - name: stability
+        description: "Stability AI Stable Diffusion"
+        env_var: STABILITY_API_KEY
+      - name: gemini
+        description: "Google Gemini image generation"
+        env_var: GEMINI_API_KEY
       - name: local
-        description: "Local placeholder (no API needed)"
+        description: "Deterministic template SVG/PNG (no API needed)"
         env_var: null
     features:
-      - "Multiple AI provider support"
-      - "Automatic image optimization"
-      - "Retro pixel art default style"
+      - "Claude orchestration: article analysis into art briefs + vision review with one corrective regeneration"
+      - "Five-renderer framework with per-vendor model validation"
+      - "Graceful degradation to template prompts without a Claude credential"
+      - "Retro pixel art default style with per-author overrides"
       - "Front matter integration"
       - "Batch processing"
   
@@ -1403,14 +1413,14 @@ features:
       - "Optional Ruby plugin for self-builds"
 
   - id: ZER0-045
-    title: "Obsidian Local Graph Panel"
-    description: "Standalone neighborhood graph view for the current note, extracted as a reusable include for sidebars and modals"
+    title: "Obsidian Graph Views (Full + Local)"
+    description: "Obsidian-desktop-style graph views: a full site graph with a Filters/Display/Forces settings panel, collection legend-filters, tag:/path: search, zoom + fullscreen controls and hover previews, plus a per-page local graph panel with depth and direction controls"
     implemented: true
-    version: "1.4.0"
+    version: "1.28.0"
     link: "/docs/obsidian/graph/"
     docs: "/docs/obsidian/graph/"
     tags: [obsidian, graph, visualization, navigation]
-    date: 2026-03-25
+    date: 2026-08-08
     provenance:
       introduced_in: "1.4.0"
       pr: 77
@@ -1418,13 +1428,22 @@ features:
       issue: null
     tests:
       - "test/test_obsidian.sh"
-      - "test/visual/features/obsidian-callouts.spec.js"
+      - "test/visual/features/obsidian-graph.spec.js"
     references:
       includes:
         - "_includes/obsidian/full-graph.html"
         - "_includes/navigation/local-graph.html"
       scripts:
         - "assets/js/obsidian-graph.js"
+        - "assets/js/obsidian-local-graph.js"
+      styles:
+        - "_sass/core/_obsidian.scss"
+    features:
+      - "Filters: search with tag:/path: operators, per-collection toggles generated from the wiki-index (count + color swatch = legend), show-orphans, show-unresolved"
+      - "Display: link arrows, node size, link thickness, label fade threshold — applied live"
+      - "Forces: repel force + link distance sliders with animated re-layout; settings persist to localStorage"
+      - "Hover preview card, zoom/fit/fullscreen stack, live dark-mode restyling"
+      - "Local graph: depth selector (1-3) + outgoing/incoming switches, re-rendered in place"
 
   # ============================================================================
   # SETUP, NAVIGATION & DEVELOPER UX (v0.20+)
@@ -2137,3 +2156,103 @@ 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"
+
+  - id: ZER0-078
+    title: "AI-Generated Multilingual Translations"
+    description: "Build-time translation pipeline: English stays the only human-maintained language while scripts/translate.rb (Claude Code OAuth) generates alternate-language pages, UI strings, and the manifest behind the language toggle"
+    implemented: true
+    version: "1.27.0"
+    link: "/"
+    docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/systems/multilingual-translation.md"
+    tags: [i18n, ai, automation, content, ui]
+    date: 2026-07-17
+    provenance:
+      introduced_in: "1.27.0"
+      pr: 316
+      commit: "01dc8fa"
+      issue: null
+    tests:
+      - "test/test_i18n.sh"
+      - "test/visual/features/language-toggle.spec.js"
+    references:
+      includes:
+        - "_includes/core/i18n.html"
+        - "_includes/core/hreflang.html"
+        - "_includes/components/language-toggle.html"
+        - "_includes/components/translation-notice.html"
+      scripts:
+        - "scripts/translate.rb"
+      workflows:
+        - ".github/workflows/translate.yml"
+      data:
+        - "_data/ui-text.yml"
+        - "_data/i18n/languages.yml"
+      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)"
+      - "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"
+
+  - id: ZER0-079
+    title: "Config-Driven Favicon and Browser Identity"
+    description: "Head include emitting favicon, SVG icon, Apple touch icon, web manifest, and theme-color tags from an optional favicon config block, with an explicit /favicon.ico fallback that works on baseurl deployments"
+    implemented: true
+    version: "1.28.0"
+    link: "/"
+    docs: "/docs/features/favicon/"
+    tags: [seo, branding, ui, configuration]
+    date: 2026-07-22
+    provenance:
+      introduced_in: "1.28.0"
+      pr: null
+      commit: "a11e29f"
+      issue: null
+    tests:
+      - "test/test_core.sh"
+    references:
+      includes:
+        - "_includes/core/favicon.html"
+        - "_includes/core/head.html"
+      docs: "pages/_docs/features/favicon.md"
+    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"
+
+  - id: ZER0-080
+    title: "Books Collection — Children's Picture-Book Publishing"
+    description: "A `books` collection with immersive cover-to-cover layouts: book landing page (cover hero + TOC), story reading pages with illustration plates and prev/next navigation, bookshelf components, and AI-provenance colophons whose front matter doubles as the image-generation manifest"
+    implemented: true
+    version: "1.28.0"
+    link: "/books/zer0-tales/"
+    docs: "/docs/features/book-collection/"
+    tags: [books, collections, layouts, storybook, ai-images, children]
+    date: 2026-07-22
+    provenance:
+      introduced_in: "1.28.0"
+      pr: 328
+      commit: "1b521f6"
+      issue: null
+    tests:
+      - "test/visual/features/books.spec.js"
+      - "pages/_books/zer0-tales/index.md"
+    references:
+      layouts:
+        - "_layouts/book.html"
+        - "_layouts/book-story.html"
+      includes:
+        - "_includes/components/bookshelf.html"
+        - "_includes/components/book-card.html"
+        - "_includes/components/book-toc.html"
+        - "_includes/components/book-nav.html"
+        - "_includes/components/book-plate.html"
+      styles:
+        - "_sass/components/_book.scss"
+      config: "_config.yml"
+      docs: "pages/_docs/features/book-collection.md"
+    features:
+      - "Book = folder of chapters + index.md; numeric chapter: front matter drives TOC and prev/next ordering (no dates needed)"
+      - "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"

data/_data/i18n/fr.yml

@@ -0,0 +1,98 @@
+# ================================================================
+# GENERATED FILE — do not edit by hand.
+# Machine-translated UI strings (fr) produced by
+# scripts/translate.rb from _data/ui-text.yml (en). Regenerate via
+# the Translate workflow or: ruby scripts/translate.rb --langs fr
+# ================================================================
+skip_links: Liens d'évitement
+skip_primary_nav: Aller à la navigation principale
+skip_content: Aller au contenu
+skip_main_content: Aller au contenu principal
+skip_footer: Aller au pied de page
+page: Page
+pagination_previous: Précédent
+pagination_next: Suivant
+breadcrumb_home_label: Accueil
+breadcrumb_separator: "/"
+menu_label: Afficher/masquer le menu
+search_label: Afficher/masquer la recherche
+toc_label: Sur cette page
+ext_link_label: Lien direct
+less_than: moins de
+minute_read: minute de lecture
+share_on_label: Partager sur
+tags_label: 'Étiquettes :'
+categories_label: 'Catégories :'
+date_label: 'Mis à jour :'
+author_label: 'Auteur :'
+comments_label: Laisser un commentaire
+comments_title: Commentaires
+more_label: En savoir plus
+related_label: Vous aimerez peut-être aussi
+follow_label: 'Suivre :'
+feed_label: Flux
+powered_by: Propulsé par
+website_label: Site web
+email_label: E-mail
+recent_posts: Articles récents
+undefined_wpm: Paramètre words_per_minute non défini dans _config.yml
+comment_form_info: Votre adresse e-mail ne sera pas publiée. Les champs obligatoires
+  sont indiqués
+comment_form_comment_label: Commentaire
+comment_form_md_info: Le Markdown est pris en charge.
+comment_form_name_label: Nom
+comment_form_email_label: Adresse e-mail
+comment_form_website_label: Site web (facultatif)
+comment_btn_submit: Envoyer le commentaire
+comment_btn_submitted: Envoyé
+comment_success_msg: Merci pour votre commentaire ! Il apparaîtra sur le site une
+  fois approuvé.
+comment_error_msg: Désolé, une erreur s'est produite lors de l'envoi. Veuillez vérifier
+  que tous les champs obligatoires sont remplis et réessayer.
+loading_label: Chargement...
+search_label_text: Saisissez votre terme de recherche...
+search_placeholder_text: Saisissez votre terme de recherche...
+search_no_results: Aucun résultat
+results_found: Résultat(s) trouvé(s)
+back_to_top: Retour en haut
+stats_total_posts: Total des articles
+stats_total_pages: Total des pages
+stats_categories: Catégories
+stats_tags: Étiquettes
+stats_last_updated: Dernière mise à jour
+stats_overview: Aperçu
+stats_content_breakdown: Répartition du contenu
+theme_toggle: Changer de thème
+dark_mode: Mode sombre
+light_mode: Mode clair
+view_source: Voir la source
+edit_page: Modifier cette page
+report_issue: Signaler un problème
+breadcrumbs_root: Accueil
+breadcrumbs_aria: Fil d'Ariane
+shortcuts_title: Raccourcis clavier
+shortcuts_search: Ouvrir la recherche
+shortcuts_prev_section: Section précédente
+shortcuts_next_section: Section suivante
+shortcuts_toggle_sidebar: Afficher/masquer la barre latérale
+shortcuts_toggle_toc: Afficher/masquer la table des matières
+shortcuts_show_help: Afficher cette aide
+home_label: Accueil
+main_nav_label: Navigation principale
+search_button_label: Rechercher
+settings_button_label: Paramètres
+toc_title: Table des matières
+published_label: Publié
+updated_label: Mis à jour
+reading_time_label: 'Temps de lecture estimé :'
+reading_time_minute: minute
+share_label: Partager
+copy_link_label: Copier le lien
+improve_label: Améliorer
+edit_on_github: Modifier sur GitHub
+lang_toggle_label: Langue
+lang_toggle_aria: Changer de langue
+lang_not_available: Pas encore traduit
+machine_translation_notice: Cette page a été traduite automatiquement à partir de
+  l'original en anglais.
+machine_translation_view_source: Voir l'original