jekyll-theme-zer0 1.25.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ffe866835e858107f670f29086f904914d21bf1159d8c6eb3cbd138f79caf64
-  data.tar.gz: d26f27d6460136cc9f2da67da26523721b52b0e7525e0811498910215e2f29e2
+  metadata.gz: 3cb4259aa073fce4885f3d87ae9e4d7227b6580eba6599c270b0a98660ba52a8
+  data.tar.gz: 1606cb3f5fe102133fccf84ba7e7f11d3338695b41c1f546f15a4c775b956834
 SHA512:
-  metadata.gz: 50038606f12260b1382fceee13299e6f8a9ca0b08b00ba18e285ed88ee762fd425e853d6fde39e8c9f72f8b345f841b04b29a3e4b095a89c36f01dc4d267d036
-  data.tar.gz: e2e2764ca02d2d10250c768beb66ca7b7ba44c60b22e1852f3993f245080b5b2d3ad532245b33e394a078ae912cc60b28b33ee9fb23403194a1e75183841d925
+  metadata.gz: 20b1f33db10f4dde3b0ee980cd481405fc166c765f3ba9c2d740a448aeed77f8aa08f017570d33c8329330009499b4629243e6ea35da3fd635ee87025eae541d
+  data.tar.gz: e7a0a830ea658d6a798ac53001535e849853f177be6e295524289d1e8a41ccb734964ee7d9ce7e85c6811e9409c27c6e922a0c631a26ea63c971a83c4769cfd3

data/CHANGELOG.md

@@ -5,6 +5,207 @@ 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)
+
+
+### Features
+
+* **feedback:** runtime "Improve this page" capture → GitHub issue (logs + AI triage) ([#286](https://github.com/bamr87/zer0-mistakes/issues/286)) ([f7fb20d](https://github.com/bamr87/zer0-mistakes/commit/f7fb20df74c22df7eb823344121c60617f06c7b6))
+
+## [Unreleased]
+
+### 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
+  331-test `smoke` tier; the full smoke tier, the complete shell-suite
+  matrix, and the 9-skin pixel snapshots moved to a nightly workflow
+  (`nightly-extended.yml`) that files a sticky issue on failure instead of
+  blocking PRs. Install/deploy/site-generation shell suites run on PRs only
+  when install-related paths change (always nightly).
+
+### Added
+
+- **Weekly agentic UI/UX audit** (`ui-audit.yml`) — a deterministic
+  Playwright sweep (`test/ui-audit/sweep.mjs`: screenshots, axe WCAG 2.1 AA,
+  console errors, overflow, broken internal links across critical routes ×
+  3 viewports) interpreted by a read-only Claude Code agent
+  (`.claude/agents/ui-auditor.md`) against the component contract in
+  `docs/architecture/ui-components.md`; findings are filed as a
+  `source:ui-audit` issue feeding the continuous-evolution loop.
+
 ## [1.25.0](https://github.com/bamr87/zer0-mistakes/compare/v1.24.0...v1.25.0) (2026-07-03)
 
 

data/README.md

@@ -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
@@ -655,7 +638,7 @@ git commit -m "feat: add new component"
 # Docker-specific tests
 ./test/test_deployment.sh
 
-# Frontend smoke tests (Playwright; starts Jekyll on :4011 unless BASE_URL is set)
+# Frontend smoke tests (Playwright; starts Jekyll on :4000 unless BASE_URL is set)
 npm run test:smoke
 # Pixel regression (skin homepage screenshots; baselines committed for Linux)
 npm run test:snapshots

data/_data/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

@@ -63,7 +63,7 @@
 meta:
   title: "zer0-mistakes Backlog"
   updated: 2026-06-29
-  next_id: 33
+  next_id: 34
 
 tasks:
   # --- Housekeeping (seeded so the loop has work on day one) ------------------
@@ -863,3 +863,56 @@ tasks:
     links: { issue: 241, pr: 253, roadmap: null }
     created: 2026-06-29
     updated: 2026-06-29
+
+  - id: T-033
+    title: "Retire legacy test_installation.sh after equivalence audit against the installer harness"
+    status: open
+    priority: P2
+    area: tests
+    risk: standard
+    effort: M
+    source: user
+    route: test-author
+    summary: >-
+      test_installation.sh (~1,000 lines, "legacy install.sh CLI args") predates the
+      modern test_installer.sh + test_install_*.sh harness and largely overlaps it.
+      Audit each of its scenarios against the harness, port anything genuinely
+      uncovered into test_install_*.sh, then delete the legacy suite and remove the
+      `installation` routing from test_runner.sh, ci.yml, and nightly-extended.yml.
+      Until then it runs nightly and on install-path PRs only (2026-07 CI tiering).
+    acceptance:
+      - "Every test_installation.sh scenario is mapped to a harness equivalent or ported."
+      - "test_installation.sh deleted; test_runner.sh no longer routes an `installation` suite."
+      - "ci.yml and nightly-extended.yml suite lists updated; docs (test/README.md) updated."
+      - "Nightly extended run green after removal."
+    links: { issue: null, pr: null, roadmap: null }
+    created: 2026-07-06
+    updated: 2026-07-06
+  - 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