jekyll-theme-zer0 1.26.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af7de9769f05880ab652483a7ff6109e79d04ff6404c71163822ce4cecac3d23
-  data.tar.gz: 7c968f45cbba4655ad0eb5aa25a55e7b5f178957d65036d47236ba7809592733
+  metadata.gz: 3cb4259aa073fce4885f3d87ae9e4d7227b6580eba6599c270b0a98660ba52a8
+  data.tar.gz: 1606cb3f5fe102133fccf84ba7e7f11d3338695b41c1f546f15a4c775b956834
 SHA512:
-  metadata.gz: 3ec2a5423346be22b17120fc586396501218877b70373eae7df03395b4b91211e8d03cf45d79ec71ad717344eae248b967dd5e810092cbf045f0d796ffad1c61
-  data.tar.gz: 55ec85fa55c7ca9c918413e16c86d3a275301a0282a989039face47fad9b9e3dc27f5fcda6ff7eb5e74faf0a557e8307c43a059e2e2bd1ebf8df011e46e82b9c
+  metadata.gz: 20b1f33db10f4dde3b0ee980cd481405fc166c765f3ba9c2d740a448aeed77f8aa08f017570d33c8329330009499b4629243e6ea35da3fd635ee87025eae541d
+  data.tar.gz: e7a0a830ea658d6a798ac53001535e849853f177be6e295524289d1e8a41ccb734964ee7d9ce7e85c6811e9409c27c6e922a0c631a26ea63c971a83c4769cfd3

data/CHANGELOG.md

@@ -5,6 +5,28 @@ 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.27.0](https://github.com/bamr87/zer0-mistakes/compare/v1.26.0...v1.27.0) (2026-07-22)
+
+
+### Features
+
+* **analytics:** wire posthog.html into head.html ([#317](https://github.com/bamr87/zer0-mistakes/issues/317)) ([7977fe1](https://github.com/bamr87/zer0-mistakes/commit/7977fe189dec3b62eb9779feac56ec27e513f2c3))
+* **article:** show_hero front-matter flag opts standard posts into the hero image ([#309](https://github.com/bamr87/zer0-mistakes/issues/309)) ([6344473](https://github.com/bamr87/zer0-mistakes/commit/6344473c14c613825ab7ac9083b87f17a2a1e858))
+* **i18n:** AI-generated multilingual support with language toggle ([#316](https://github.com/bamr87/zer0-mistakes/issues/316)) ([72b2ab6](https://github.com/bamr87/zer0-mistakes/commit/72b2ab6980742e26305a22e3aff535f465ade084))
+* **scripts:** Claude-orchestrated preview images — Claude analyzes & reviews, image models render ([#296](https://github.com/bamr87/zer0-mistakes/issues/296)) ([acac205](https://github.com/bamr87/zer0-mistakes/commit/acac2051ec79a81c04efb1af76fb4031e106a852))
+
+
+### Bug Fixes
+
+* **a11y:** keep a single <main> landmark per page ([#310](https://github.com/bamr87/zer0-mistakes/issues/310)) ([fae920e](https://github.com/bamr87/zer0-mistakes/commit/fae920eb5c60b5e792e9842c9b112bd5eb60e391)), closes [#299](https://github.com/bamr87/zer0-mistakes/issues/299)
+* **author:** build avatar path with relative_url, never protocol-relative ([#306](https://github.com/bamr87/zer0-mistakes/issues/306)) ([ac597d2](https://github.com/bamr87/zer0-mistakes/commit/ac597d2c029157bb47da5a336812f764a3946da4))
+* **ci:** secret scan matches added lines only, not context/removals/hunk headers ([#301](https://github.com/bamr87/zer0-mistakes/issues/301)) ([1b7175d](https://github.com/bamr87/zer0-mistakes/commit/1b7175ddece3d95aefc406f3b59df682db9fd0f2))
+* **includes:** gate Quick Links Dev row on is_production ([#308](https://github.com/bamr87/zer0-mistakes/issues/308)) ([03b6877](https://github.com/bamr87/zer0-mistakes/commit/03b687713b8552c6ceb6b2ab30ac8caea0d6632d))
+* **obsidian:** graph reads OBSIDIAN_CONFIG.wikiIndexUrl that js-cdn.html emits ([#305](https://github.com/bamr87/zer0-mistakes/issues/305)) ([2875912](https://github.com/bamr87/zer0-mistakes/commit/28759128b7b352a054e642d153e5e38e16aa1e48))
+* **sass:** stack left-side FABs to prevent obsidian/feedback overlap ([#289](https://github.com/bamr87/zer0-mistakes/issues/289)) ([6cc4596](https://github.com/bamr87/zer0-mistakes/commit/6cc4596dff28d164386a16a6637420f84b4571bf))
+* **test:** repoint ZER0-003 to test_install_legacy_flags.sh after retirement ([#292](https://github.com/bamr87/zer0-mistakes/issues/292)) ([fd7a2ce](https://github.com/bamr87/zer0-mistakes/commit/fd7a2ce256e32d2f630bd82732227b54ba13d3dd))
+* **theme:** apply relative_url to preview_path exactly once ([#307](https://github.com/bamr87/zer0-mistakes/issues/307)) ([012e577](https://github.com/bamr87/zer0-mistakes/commit/012e577fe3131e0be42f7d33a6f5161dc666cc81))
+
 ## [1.26.0](https://github.com/bamr87/zer0-mistakes/compare/v1.25.0...v1.26.0) (2026-07-07)
 
 
@@ -14,8 +36,157 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Changed
+### Added
+
+- **Multilingual support via AI-generated translations** (ZER0-078) — the
+  theme now serves alternate-language versions of the site without storing
+  hand-written translations in source. English under `pages/**` +
+  `_data/ui-text.yml` `en` is the only human-maintained language; a
+  build-time utility ([`scripts/translate.rb`](scripts/translate.rb),
+  Claude Code OAuth with API-key fallback, stdlib-only Ruby) generates the
+  alternates and the
+  [`translate.yml`](.github/workflows/translate.yml) workflow commits them
+  via PR — one large `mode=full` dispatch job for the initial conversion,
+  plus bounded incremental runs whenever English content changes on `main`:
+  - Generated artifacts: `fr/**` page files (plain Jekyll pages with
+    explicit `/fr<en-url>` permalinks — GitHub Pages safe-mode friendly, no
+    plugin required), `_data/i18n/<lang>.yml` UI strings, and
+    `_data/i18n/manifest.yml` (en URL → translations map + SHA-based
+    incremental change detection with pruning of deleted sources).
+  - Markdown safety by construction: per-line segment translation with
+    `⟦N⟧` masking of code, Liquid, wiki-links and URLs, placeholder
+    set-equality validation with one retry, code fences never sent.
+  - Frontend: navbar **language toggle**
+    ([`language-toggle.html`](_includes/components/language-toggle.html))
+    with per-page availability states and `localStorage` preference,
+    `hreflang` alternates in `<head>`, per-page `<html lang>`, and a
+    machine-translation disclosure banner linking back to the original.
+  - Refactor: UI-string lookup centralized in
+    [`core/i18n.html`](_includes/core/i18n.html) and made per-page-language
+    aware (cached chrome includes take a `lang` parameter so each language
+    gets its own `include_cached` entry); the hand-maintained es/fr/de/ar
+    blocks in `_data/ui-text.yml` were **removed** in favor of the
+    generated pipeline.
+  - Offline test suite `test/test_i18n.sh` (stub provider, no network),
+    registered as the `i18n` suite in `test_runner.sh`, plus the
+    `language-toggle` Playwright smoke spec; docs in
+    [`docs/systems/multilingual-translation.md`](docs/systems/multilingual-translation.md).
+    (evidence:
+    [`test/visual/evidence/language-toggle/`](test/visual/evidence/language-toggle/README.md)
+    and
+    [`test/visual/evidence/language-toggle-fr/`](test/visual/evidence/language-toggle-fr/README.md)
+    — toggle at 6 widths + generated French page with 0px overflow, code
+    blocks byte-identical)
+
+- **`show_hero` front-matter flag** — a post of any `post_type` can now opt
+  its `preview:` image into the top-of-article hero with `show_hero: true`,
+  without being promoted to `featured`/`breaking` (layout width, sidebar,
+  typography, and the post-type badge keep their `post_type` defaults);
+  existing posts are unchanged by construction — the flag is falsy everywhere
+  it isn't set ([#303](https://github.com/bamr87/zer0-mistakes/issues/303)).
+  (evidence:
+  [`test/visual/evidence/show-hero/`](test/visual/evidence/show-hero/README.md)
+  — hero renders only on the opted-in demo post; whole-build before/after
+  diff: exactly 1 page differs)
+
+- **Claude-orchestrated preview-image engine** (ZER0-004) — the three
+  divergent implementations (1,404-line Bash engine, drifted Python
+  duplicate, dead Jekyll plugin) are consolidated into ONE Python engine,
+  [`scripts/lib/preview_generator.py`](scripts/lib/preview_generator.py).
+  Claude directs; an image model renders:
+  - **Analyze** (`prompt_engine: claude`, default) — Claude reads each
+    article and writes a subject-specific art-direction brief, replacing the
+    generic template prompt that produced unrepresentative banners.
+  - **Produce** — the configured renderer executes the brief: `openai`
+    (gpt-image-2 / DALL-E, default), `xai` (grok-2-image), `stability`,
+    **`gemini` (new)** — or `local`, upgraded from a `.txt` stub to a real
+    deterministic SVG/PNG banner (sanitized, rasterized via `rsvg-convert` →
+    `inkscape` → `magick` → the new Playwright helper
+    [`scripts/dev/rasterize-svg.js`](scripts/dev/rasterize-svg.js)).
+  - **Review** (`review_engine: claude`, default) — Claude inspects the
+    rendered image with vision against the article and style; when it
+    misrepresents the subject or contains text artifacts, Claude writes a
+    corrected prompt and the engine regenerates once.
+  - Claude credential chain: `CLAUDE_CODE_OAUTH_TOKEN` (`claude setup-token`)
+    → `ANTHROPIC_AUTH_TOKEN` → `ANTHROPIC_API_KEY` → a logged-in `claude` CLI
+    (zero-setup for Claude Code users); orchestration degrades gracefully to
+    template prompts without one.
+  - New unit suite [`test/test_preview_generator.py`](test/test_preview_generator.py)
+    (83 tests, zero network) wired into `test_core.sh`.
+
+### Fixed
 
+- **Obsidian graph loads its wiki index on project sites** — the full-graph
+  renderer (`assets/js/obsidian-graph.js`) now reads the baseurl-aware
+  `window.OBSIDIAN_CONFIG.wikiIndexUrl` that `js-cdn.html` emits (falling back
+  to the legacy `OBSIDIAN_WIKI_INDEX_URL` override, then the `<base>`-relative
+  path), instead of only the never-set legacy global — whose fallback dropped
+  the baseurl and 404'd the `wiki-index.json` fetch on GitHub Pages project
+  sites, leaving `/docs/obsidian/graph/` a "Failed to load graph data" alert
+  ([#294](https://github.com/bamr87/zer0-mistakes/issues/294)). (evidence:
+  [`test/visual/evidence/obsidian-graph-index/`](test/visual/evidence/obsidian-graph-index/README.md)
+  — wiki-index fetch 404 → 200, alert → rendered graph, on a baseurl'd build)
+
+- **Quick Links no longer ships a dead `localhost:4000` Dev row to production
+  visitors** — the env-switcher's Development URL row (rendered in the
+  site-wide Settings offcanvas on every page) is now wrapped in
+  {% raw %}`{% unless is_production %}`{% endraw %}, using the same `env-detect.html` flag the card
+  already keys its badge on; serving locally with `JEKYLL_ENV=production`
+  still counts as dev context, so the row stays available for Docker workflows
+  ([#298](https://github.com/bamr87/zer0-mistakes/issues/298)). (evidence:
+  [`test/visual/evidence/env-switcher-prod/`](test/visual/evidence/env-switcher-prod/README.md)
+  — production Settings-chrome `localhost:4000` occurrences 5 → 0, Dev row
+  intact in development)
+- **Author avatars never render as protocol-relative `//assets/…` URLs** —
+  `author-avatar-url.html` now builds the relative-path branch in a capture,
+  collapses doubled slashes, and applies `relative_url` exactly once, instead
+  of the manual `{{ site.baseurl }}/{{ site.public_folder }}{{ avatar }}`
+  concatenation that produced `src="//assets/…"` (a URL browsers resolve
+  against a host named `assets`) on consumer sites where `public_folder` is
+  unset or carries a leading slash
+  ([#297](https://github.com/bamr87/zer0-mistakes/issues/297)). (evidence:
+  [`test/visual/evidence/author-avatar-url/`](test/visual/evidence/author-avatar-url/README.md)
+  — 4 protocol-relative avatars → 0, all avatars loading, on a misconfigured
+  consumer build)
+
+- **Intro hero banner renders on project sites** — `content/intro.html` now
+  applies `relative_url` to the banner image exactly once (in the
+  `preview_path` assignment logic), instead of a second time at the point of
+  use, which doubled the baseurl segment on any site with a non-empty
+  `baseurl` (`url('/reponame/reponame/assets/…')` → 404 → gradient-only hero)
+  and mangled absolute preview URLs
+  ([#293](https://github.com/bamr87/zer0-mistakes/issues/293)). (evidence:
+  [`test/visual/evidence/intro-banner-baseurl/`](test/visual/evidence/intro-banner-baseurl/README.md)
+  — background fetch 404 → 200 on both preview branches of a baseurl'd build)
+
+- **Preview-image config keys `enabled`, `assets_prefix`, `auto_prefix` and
+  `collections` are now honored by the generator** (the Bash engine ignored
+  them), and front-matter `preview:` updates are scoped to the front-matter
+  block only — the previous file-wide `sed` could corrupt body lines starting
+  with `preview:`. External-URL previews are no longer silently regenerated,
+  and a configured model from the wrong vendor family falls back to the
+  provider default instead of a guaranteed API error.
+
+- **Left-side FAB overlap** — the Obsidian local-graph button and the
+  page-feedback "Improve this page" button were both positioned at
+  `bottom: 1rem; left: 1rem` and completely overlapped each other. The
+  Obsidian FAB is now at slot 2 (`bottom: offset + size + gap`), stacking
+  above the feedback FAB — the same pattern the TOC FAB uses above
+  back-to-top on the right side. The docs-sidebar restore-mode FAB was
+  also offset to slot 2 so it cannot overlap the feedback FAB on mobile.
+  Closes #288. (evidence:
+  [`test/visual/evidence/fab-stack/`](test/visual/evidence/fab-stack/README.md)
+  — feedback↔obsidian FAB overlap 3136px² → 0; regression test
+  [`test/visual/features/fab-stack.spec.js`](test/visual/features/fab-stack.spec.js)).
+
+### Changed
+
+- **Preview-image generation is now Claude-orchestrated by default**
+  (`prompt_engine: claude` + `review_engine: claude`; disable with
+  `--prompt-engine template --review none`). The renderer default stays
+  `openai`. `scripts/features/generate-preview-images` is now a thin wrapper
+  delegating to the Python engine (full CLI flag surface preserved;
+  `rake preview:*` and the VS Code tasks work unchanged).
 - **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

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/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"
   
@@ -2137,3 +2147,40 @@ 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"

data/_data/i18n/languages.yml

@@ -0,0 +1,36 @@
+# Feature: ZER0-078
+# Language display metadata for the language toggle
+# (_includes/components/language-toggle.html).
+#
+# This file is CONFIGURATION, not translated content: a language's native
+# name is a fixed fact, not something the translation pipeline generates.
+# Add an entry here when adding a language to `translation.languages` in
+# _config.yml. Everything else under _data/i18n/ (<lang>.yml, manifest.yml)
+# is GENERATED by scripts/translate.rb — never hand-edited.
+en:
+  name: English
+  native: English
+fr:
+  name: French
+  native: Français
+es:
+  name: Spanish
+  native: Español
+de:
+  name: German
+  native: Deutsch
+pt:
+  name: Portuguese
+  native: Português
+it:
+  name: Italian
+  native: Italiano
+ja:
+  name: Japanese
+  native: 日本語
+zh:
+  name: Chinese
+  native: 中文
+ar:
+  name: Arabic
+  native: العربية

data/_data/theme-manifest.yml

@@ -26,7 +26,6 @@ theme_data_paths:
 # Plugin files that consumers using remote_theme MUST vendor locally.
 # GitHub Pages does not load plugins from a remote_theme source.
 required_plugin_paths:
-  - _plugins/preview_image_generator.rb
   - _plugins/obsidian_links.rb
 # Optional plugins consumers can vendor for enhanced functionality.
 optional_plugin_paths:
@@ -36,7 +35,6 @@ optional_plugin_paths:
 
 # Legacy alias — all plugin paths combined (kept for backward compatibility).
 plugin_paths:
-  - _plugins/preview_image_generator.rb
   - _plugins/obsidian_links.rb
   - _plugins/admin_page_urls.rb
   - _plugins/content_statistics_generator.rb