jekyll-theme-zer0 1.25.0 → 1.27.0

data/_data/features.yml

@@ -1,7 +1,7 @@
 # zer0-mistakes Theme Features Registry
 # Comprehensive feature tracking for the zer0-mistakes Jekyll theme
-# Version: 1.24.0
-# Last Updated: 2026-06-30
+# Version: 1.26.0
+# Last Updated: 2026-07-17
 
 features:
   # ============================================================================
@@ -23,8 +23,8 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/component-showcase.spec.js"
-      - "test/visual/styling.spec.js"
+      - "test/visual/features/component-showcase.spec.js"
+      - "test/visual/core/styling.spec.js"
     references:
       layouts: ["_layouts/root.html", "_layouts/default.html"]
       includes: ["_includes/core/head.html"]
@@ -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"
   
@@ -216,7 +226,7 @@ features:
       issue: null
     tests:
       - "test/test_quality.sh"
-      - "test/visual/security.spec.js"
+      - "test/visual/core/security.spec.js"
     references:
       include: "_includes/analytics/posthog.html"
       config: "_config.yml"
@@ -277,7 +287,7 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/interactions.spec.js"
+      - "test/visual/features/sidebar-navigation.spec.js"
     references:
       javascript:
         - "assets/js/modules/navigation/sidebar-state.js"
@@ -317,8 +327,8 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
-      - "test/visual/accessibility.spec.js"
+      - "test/visual/features/layouts.spec.js"
+      - "test/visual/core/accessibility.spec.js"
     references:
       javascript:
         - "assets/js/modules/navigation/keyboard.js"
@@ -351,8 +361,7 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
-      - "test/visual/ui-refresh.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       include: "_includes/navigation/sidebar-right.html"
       styles: "_sass/custom.scss"
@@ -379,7 +388,7 @@ features:
       commit: "0ea51c6"
       issue: null
     tests:
-      - "test/visual/accessibility.spec.js"
+      - "test/visual/core/accessibility.spec.js"
     references:
       include: "_includes/core/header.html"
       styles: "_sass/custom.scss"
@@ -621,7 +630,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layouts:
         - "_layouts/root.html"
@@ -667,7 +676,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/component-showcase.spec.js"
+      - "test/visual/features/component-showcase.spec.js"
     references:
       includes:
         - "_includes/core/"
@@ -932,7 +941,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       scripts:
         - "assets/js/back-to-top.js"
@@ -957,7 +966,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       scripts:
         - "assets/js/code-copy.js"
@@ -983,7 +992,7 @@ features:
       commit: "55bee97"
       issue: null
     tests:
-      - "test/visual/color-mode-default.spec.js"
+      - "test/visual/features/appearance.spec.js"
     references:
       scripts:
         - "assets/js/modules/theme/appearance.js"
@@ -1015,8 +1024,7 @@ features:
       commit: "21eb458"
       issue: null
     tests:
-      - "test/visual/search.spec.js"
-      - "test/visual/search-degradation.spec.js"
+      - "test/visual/features/search.spec.js"
     references:
       scripts:
         - "assets/js/search-modal.js"
@@ -1048,7 +1056,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/navbar.spec.js"
     references:
       scripts:
         - "assets/js/auto-hide-nav.js"
@@ -1073,7 +1081,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/backgrounds.spec.js"
+      - "test/visual/features/appearance.spec.js"
     references:
       scripts:
         - "assets/js/particles.js"
@@ -1105,7 +1113,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/giscus-comments.spec.js"
+      - "test/visual/features/comments.spec.js"
     references:
       includes:
         - "_includes/content/giscus.html"
@@ -1140,7 +1148,7 @@ features:
       commit: "31f827e"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       docs:
         - "pages/_docs/features/mathjax-math.md"
@@ -1165,8 +1173,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/feature-coverage.spec.js"
-      - "test/visual/ui-refresh.spec.js"
+      - "test/visual/features/content-enhancements.spec.js"
     references:
       includes:
         - "_includes/content/toc.html"
@@ -1251,8 +1258,8 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
-      - "test/visual/authors-breadcrumb-degradation.spec.js"
+      - "test/visual/features/layouts.spec.js"
+      - "test/visual/features/authors.spec.js"
     references:
       includes:
         - "_includes/navigation/breadcrumbs.html"
@@ -1421,7 +1428,7 @@ features:
       issue: null
     tests:
       - "test/test_obsidian.sh"
-      - "test/visual/obsidian-callouts.spec.js"
+      - "test/visual/features/obsidian-callouts.spec.js"
     references:
       includes:
         - "_includes/obsidian/full-graph.html"
@@ -1471,7 +1478,7 @@ features:
       issue: null
     tests:
       - "test/test_core.sh"
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       page: "404.html"
       docs: "pages/_docs/features/smart-404.md"
@@ -1512,8 +1519,7 @@ features:
       commit: "a8426a5"
       issue: null
     tests:
-      - "test/visual/ui-refresh.spec.js"
-      - "test/visual/navbar-responsive.spec.js"
+      - "test/visual/features/navbar.spec.js"
     references:
       includes:
         - "_includes/navigation/navbar.html"
@@ -1533,8 +1539,7 @@ features:
       commit: "27550da"
       issue: null
     tests:
-      - "test/visual/admin-layout.spec.js"
-      - "test/visual/admin-nav.spec.js"
+      - "test/visual/features/admin.spec.js"
     references:
       layout: "_layouts/admin.html"
       includes:
@@ -1645,8 +1650,7 @@ features:
       commit: "5533f34"
       issue: null
     tests:
-      - "test/visual/navbar-responsive.spec.js"
-      - "test/visual/ui-refresh.spec.js"
+      - "test/visual/features/navbar.spec.js"
     references:
       scripts:
         - "assets/js/modules/"
@@ -1753,7 +1757,7 @@ features:
       commit: "341cc67"
       issue: null
     tests:
-      - "test/visual/ai-chat.spec.js"
+      - "test/visual/features/ai-chat.spec.js"
     references:
       includes: ["_includes/components/ai-chat.html"]
       layouts: ["_layouts/root.html"]
@@ -1780,7 +1784,7 @@ features:
       commit: "a6db3042"
       issue: null
     tests:
-      - "test/visual/authors-breadcrumb-degradation.spec.js"
+      - "test/visual/features/authors.spec.js"
     references:
       plugin: "_plugins/author_pages_generator.rb"
       layouts:
@@ -1805,7 +1809,7 @@ features:
       commit: "53132416"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layout: "_layouts/news.html"
 
@@ -1824,8 +1828,8 @@ features:
       commit: "06691f93"
       issue: null
     tests:
-      - "test/visual/section-sidebar-tags-gate.spec.js"
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/sidebar-navigation.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layout: "_layouts/section.html"
 
@@ -1844,7 +1848,7 @@ features:
       commit: "06691f93"
       issue: null
     tests:
-      - "test/visual/layouts.spec.js"
+      - "test/visual/features/layouts.spec.js"
     references:
       layout: "_layouts/article.html"
       include: "_includes/components/post-type-badge.html"
@@ -1864,9 +1868,8 @@ features:
       commit: "27550dac"
       issue: null
     tests:
-      - "test/visual/skins.spec.js"
-      - "test/visual/backgrounds.spec.js"
-      - "test/visual/theme-colors.spec.js"
+      - "test/visual/features/appearance.spec.js"
+      - "test/visual/features/appearance-snapshot.spec.js"
     references:
       scripts:
         - "assets/js/background-customizer.js"
@@ -1999,7 +2002,7 @@ features:
       commit: "7ba0f834"
       issue: null
     tests:
-      - "test/visual/component-showcase.spec.js"
+      - "test/visual/features/component-showcase.spec.js"
     references:
       include: "_includes/components/component-showcase.html"
 
@@ -2125,7 +2128,7 @@ features:
       commit: "3b951604"
       issue: null
     tests:
-      - "test/visual/settings-panel.spec.js"
+      - "test/visual/features/settings-panel.spec.js"
     references:
       includes:
         - "_includes/components/info-section.html"
@@ -2144,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/feedback_types.yml

@@ -0,0 +1,148 @@
+# _data/feedback_types.yml
+#
+# Request types for the page-feedback capture widget:
+#   _includes/components/page-feedback.html + assets/js/page-feedback.js
+#
+# This REPLACES the build-time "Copilot Agent" dropdown that baked
+# _data/prompts.yml into every <a href> at build time. The widget now injects
+# this list as JSON and assembles the GitHub issue at RUNTIME, so it can also
+# attach live page context and a captured console-log buffer — things a
+# build-time Liquid link can never see.
+#
+# ─── Schema (per entry) ──────────────────────────────────────────────────────
+#   id           unique slug — used in the issue title tag ([id]) and analytics
+#   label        short text shown in the type selector
+#   icon         Bootstrap Icons class (https://icons.getbootstrap.com/)
+#   group        section header in the selector ("This page" | "The site")
+#   scope        page | site — targets this page, or the theme as a whole
+#   description  one-line helper shown under the label
+#   labels       GitHub labels applied to the issue. MUST already exist in the
+#                repo: GitHub SILENTLY DROPS unknown labels from a prefilled URL
+#                (this was the old feature's `labels=ai-agent` bug). Verify with
+#                `gh label list`. The marker label from
+#                site.page_feedback.default_labels is added on top of these.
+#   agent        true  → assign @copilot and attach `directive` for autonomous work
+#                false → human triage only (no assignee, no directive)
+#   directive    compact agent instruction. Kept SHORT on purpose — it rides in
+#                the prefilled issue URL, and long bodies blow the URL-length
+#                budget. The full context table + logs are added by the widget.
+#   placeholder  textarea placeholder tailored to this request type
+# ─────────────────────────────────────────────────────────────────────────────
+
+# ─── This page — scoped to the page the widget was opened from ───────────────
+
+- id: fix-page
+  label: Report a problem
+  icon: bi-bug
+  group: This page
+  scope: page
+  description: A typo, broken link, wrong information, or something rendering badly
+  labels: [bug]
+  agent: true
+  directive: >-
+    Reproduce and fix the reported defect on the page identified in Page
+    Context. Keep the change minimal and surgical; verify with a Jekyll build.
+  placeholder: What is wrong, where on the page, and what did you expect instead?
+
+- id: improve-page
+  label: Improve this page
+  icon: bi-stars
+  group: This page
+  scope: page
+  description: Polish the copy, structure, or presentation
+  labels: [enhancement, "area:docs"]
+  agent: true
+  directive: >-
+    Act as a content editor for the page in Page Context. Tighten copy, fix
+    grammar, improve heading hierarchy and visual rhythm — without changing the
+    core message or breaking links.
+  placeholder: What would make this page clearer, tighter, or more useful?
+
+- id: expand-page
+  label: Add missing detail
+  icon: bi-arrows-angle-expand
+  group: This page
+  scope: page
+  description: Add depth, examples, or a section a reader would expect
+  labels: [enhancement, "area:docs"]
+  agent: true
+  directive: >-
+    Expand the page in Page Context with concrete examples, prerequisites, and
+    any expected-but-missing sections. Preserve tone and front matter.
+  placeholder: What is missing? Which examples or sections would help?
+
+- id: update-page
+  label: Flag outdated content
+  icon: bi-arrow-clockwise
+  group: This page
+  scope: page
+  description: Stale versions, dead links, or old screenshots
+  labels: [documentation, "area:docs"]
+  agent: true
+  directive: >-
+    Audit the page in Page Context for stale versions, dead links, and outdated
+    screenshots; refresh them and bump `lastmod`.
+  placeholder: What is out of date? Paste the stale value or link if you can.
+
+- id: accessibility
+  label: Accessibility issue
+  icon: bi-universal-access
+  group: This page
+  scope: page
+  description: Contrast, keyboard, screen-reader, or focus problems
+  labels: ["area:a11y"]
+  agent: true
+  directive: >-
+    Audit the page in Page Context against WCAG 2.1 AA for the reported barrier
+    (contrast, keyboard, focus, ARIA, alt text) and propose concrete fixes.
+  placeholder: What barrier did you hit? Which assistive tech or input method?
+
+# ─── The site — theme-wide UI, components, features, performance ──────────────
+
+- id: ui-ux
+  label: UI / UX improvement
+  icon: bi-palette
+  group: The site
+  scope: site
+  description: A design or usability refinement for the theme
+  labels: [enhancement, "area:feat"]
+  agent: true
+  directive: >-
+    Propose a Bootstrap-first UI/UX refinement, using the page in Page Context
+    as the starting example. Cover responsive behaviour, dark mode, and a11y.
+  placeholder: What feels off, and how might it look or behave instead?
+
+- id: performance
+  label: Performance
+  icon: bi-speedometer2
+  group: The site
+  scope: site
+  description: Slow load, layout shift, or heavy assets
+  labels: ["area:perf"]
+  agent: true
+  directive: >-
+    Profile the page in Page Context (LCP, CLS, INP), identify the bottleneck,
+    and propose GitHub Pages-safe fixes.
+  placeholder: What felt slow? On what device / connection?
+
+- id: feature
+  label: Feature request
+  icon: bi-lightbulb
+  group: The site
+  scope: site
+  description: Propose a new site-wide capability
+  labels: [enhancement, "area:feat"]
+  agent: false
+  directive: ""
+  placeholder: What should it do, and who benefits?
+
+- id: question
+  label: Ask a question
+  icon: bi-question-circle
+  group: The site
+  scope: site
+  description: Something unclear — not necessarily a bug
+  labels: [question]
+  agent: false
+  directive: ""
+  placeholder: What are you trying to do, and where did you get stuck?

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/navigation/README.md

@@ -74,7 +74,7 @@
 # - The theme also clips stray horizontal page overflow at the root, so an
 #   over-stuffed nav or wide content can never make the fixed navbar look "cut
 #   off". Wide tables/code keep their own local scroll. Regression-guarded by
-#   test/visual/navbar-responsive.spec.js.
+#   test/visual/features/navbar.spec.js.
 #
 # ## Schema Validation
 #

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