jekyll-theme-zer0 1.19.1 → 1.20.2

data/_data/features.yml

@@ -1,7 +1,7 @@
 # zer0-mistakes Theme Features Registry
 # Comprehensive feature tracking for the zer0-mistakes Jekyll theme
-# Version: 1.16.0
-# Last Updated: 2026-06-12
+# Version: 1.6.2
+# Last Updated: 2026-06-13
 
 features:
   # ============================================================================
@@ -1293,27 +1293,6 @@ features:
     references:
       includes: ["_includes/components/ai-chat.html"]
       layouts: ["_layouts/root.html"]
+      scripts: ["assets/js/ai-chat.js", "templates/deploy/chat-proxy/worker.js", "templates/deploy/chat-proxy/dev-proxy.mjs", "templates/deploy/chat-proxy/page-store.mjs"]
       config: "_config.yml"
-
-  - id: ZER0-061
-    title: "Org Content Hub (Federated)"
-    description: "Tooling to publish one GitHub Pages site per org repository — each renders its own content at <org>.github.io/<repo>/ with this theme via remote_theme — plus a /hub/ dashboard that tracks them all from GitHub API metadata. Content never leaves the source repo"
-    implemented: true
-    version: "1.17.0"
-    link: "/hub/"
-    docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/systems/content-hub.md"
-    tags: [content, automation, ci-cd, navigation]
-    date: 2026-06-12
-    references:
-      scripts:
-        - "scripts/provision-org-sites.rb"
-        - "scripts/sync-hub-metadata.rb"
-        - "scripts/lib/hub.rb"
-      data: "_data/hub.yml"
-      workflow: ".github/workflows/hub-sync.yml"
-      docs: "docs/systems/content-hub.md"
-    features:
-      - "Provisions org repos as Pages sites (remote_theme) via PR — templates/org-site/*"
-      - "Auto-discovers org repositories via the gh CLI (registry: _data/hub.yml)"
-      - "Metadata-only dashboard — clones nothing, copies no content"
-      - "Dashboard at /hub/ shows each site's live/pending status and links"
+      instructions: ".github/instructions/ai-chat.instructions.md"

data/_data/navigation/README.md

@@ -42,6 +42,30 @@
 #   nav: docs  # Uses _data/navigation/docs.yml
 # ```
 #
+# ## Navbar capacity & responsive constraints (main.yml)
+#
+# The top navbar adapts the `main.yml` items to the viewport automatically:
+#
+# - **≥ lg (992px+):** items render inline. The center track degrades in tiers
+#   as it gets crowded — full labels → ellipsized labels → icon-only — before
+#   anything is dropped.
+# - **< lg:** the full menu moves into the slide-in offcanvas (hamburger), so
+#   item count and label length never affect the bar itself there.
+#
+# Guidance:
+# - Aim for **~6–7 top-level items**. More still work, but on compact desktops
+#   (≈992–1200px) they collapse to icon-only and, past the track's capacity,
+#   would clip. Group extras under `children:` dropdowns instead of adding more
+#   top-level entries.
+# - Long titles ellipsize rather than overflow; keep them short for legibility.
+# - On local/dev hosts the navbar logs a `console.warn` ("[zer0-mistakes
+#   navbar]") when items don't fit or page content overflows the viewport — your
+#   cue that a config exceeds what the bar can show. (Silent in production.)
+# - 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.
+#
 # ## Schema Validation
 #
 # Navigation YAML is validated at build time by _plugins/navigation_validator.rb

data/_data/navigation/about.yml

@@ -10,6 +10,8 @@
   children:
     - title: Overview
       url: /about/
+    - title: Authors
+      url: /authors/
     - title: Features
       url: /about/features/
     - title: AI Development Guide

data/_data/navigation/main.yml

@@ -51,13 +51,6 @@
     - title: Test Notebook
       url: /notebooks/test-notebook/
 
-- title: Hub
-  icon: bi-collection
-  url: /hub/
-  # Per-repo links live in the generated sidebar (_data/navigation/hub.yml);
-  # the navbar only needs the dashboard entry so new org repos appear without
-  # touching this file.
-
 - title: Docs
   icon: bi-journal-bookmark
   url: /docs/
@@ -81,6 +74,8 @@
   children:
     - title: Features
       url: /features/
+    - title: Authors
+      url: /authors/
     - title: Statistics
       url: /about/stats/
     - title: Config

data/_data/roadmap.yml

@@ -20,7 +20,7 @@
 #      is internally consistent and still tracks the shipped gem version.
 #   4. Commit both this file and the resulting README.md changes.
 #
-# A GitHub Actions workflow (`.github/workflows/roadmap-sync.yml`) also runs
+# A GitHub Actions workflow (`.github/workflows/sync.yml`) also runs
 # the generator and the validator automatically: it regenerates the README on
 # push, fails PRs whose README is stale, and flags whenever the roadmap drifts
 # behind the version in `lib/jekyll-theme-zer0/version.rb`.
@@ -60,7 +60,7 @@
 meta:
   title: "zer0-mistakes Roadmap"
   tagline: "Past releases, current focus, and future plans for the zer0-mistakes Jekyll theme."
-  updated: 2026-06-12
+  updated: 2026-06-16
 
 milestones:
   # --- Completed -------------------------------------------------------------
@@ -340,23 +340,97 @@ milestones:
       - "Release changelog single source of truth; workflow lint cleanup (T-017)"
       - "Gate-coverage controls contract documented in the workflows README"
 
-  # --- Current ---------------------------------------------------------------
-
   - version: "1.14"
     title: "Zer0-Mistake Quality Framework"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-11
+    summary: "Second wave of the Zer0-Mistake Quality Framework: DOM sanitization hardening and workflow lint cleanup."
+    features:
+      - "Admin config-page Liquid sanitization layer (T-009 hardening) — protects GitHub Pages builds where the plugin filter is a no-op"
+      - "version-bump.yml yamllint cleanup (T-017) — trailing spaces, bracket spacing, sequence indentation"
+      - "Changelog tooling: update_changelog_file normalizes trailing newlines and folds stale Unreleased sections"
+
+  - version: "1.15"
+    title: "Quality Framework Batch"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-12
+    summary: "Quality framework batch: docs lint baseline, locale guard, strict site_generation, contribution templates, and YAML export fix."
+    features:
+      - "Contribution templates (T-003): bug-report / feature-request forms, PR template with conventional-commit checklist"
+      - "Docs lint baseline + gate re-armed (T-004/T-014): ~1,600 markdownlint violations fixed, both `|| true` suppressions removed"
+      - "Theme customizer YAML export fix (T-008): hex color values quoted; frozen regression test promoted to live"
+      - "Locale-independence guard (T-015): validators run under `LC_ALL=C` in the lib test suite"
+      - "Strict site_generation suite (T-016): `jekyll build` failures now fail the gate"
+      - "Ruby gemspec floor raised to `>= 3.2` to match modern dependency requirements"
+
+  - version: "1.16"
+    title: "AI Chat + Consumer Audit"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-12
+    summary: "AI chat widget (ZER0-060) and consumer audit tooling; render guard bug fixed."
+    features:
+      - "AI Chat Assistant (ZER0-060): opt-in floating chat widget grounded in the current page with proxy-first auth"
+      - "Consumer audit tooling and theme manifest for downstream site health checks"
+      - "Chat render guard fix: Liquid `assign` truthy bug would have shown a dead FAB on every page"
+      - "Locale independence in `scripts/lib/frontmatter.sh` (multibyte post YAML errors under C locale)"
+
+  - version: "1.17"
+    title: "A11y, Mermaid & Migration Tests"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-12
+    summary: "Plugin unit specs, coverage baseline, config-page sync, WCAG 2.1 AA fixes, Mermaid on 12 more pages, and migration tests."
+    features:
+      - "Plugin unit specs (T-011): 19 Minitest specs for preview_image_generator, content_statistics_generator, admin_page_urls"
+      - "Coverage baseline (T-005): structural survey at docs/development/coverage-baseline.md; T-019/T-020 follow-ups filed"
+      - "Admin config-page sync (T-018): byte-synced copy, drift check in validate, Raw-YAML tab sanitized"
+      - "Navbar & site WCAG 2.1 AA fixes (T-007): all axe-core violations resolved; three test.fixme blocks promoted to live tests"
+      - "Mermaid on 12 more pages: missing `mermaid: true` front-matter flags added across the docs"
+      - "Obsidian graph view restored at `/docs/obsidian/graph/` (161 nodes, 269 edges)"
+      - "Migration & theme-version coverage (T-019): test_migrate.sh (14 assertions) and ThemeVersionGeneratorTest"
+
+  - version: "1.18"
+    title: "AI Content Reviewer"
+    status: completed
+    section: Completed
+    start: 2026-06
+    end: 2026-06
+    released: 2026-06-13
+    summary: "Two-tier AI content reviewer framework and chat GitHub action tools (issue/PR creation via Claude tool use)."
+    features:
+      - "Deterministic reviewer tier (`scripts/content-review.rb`): scores Markdown files 0–100 per-collection; posts sticky PR comment"
+      - "Claude Code agent tier (`.claude/agents/content-reviewer.md`): tone, clarity, consistency, accessibility review"
+      - "AI Content Review workflow (`.github/workflows/ai-content-review.yml`): runs on every PR touching `pages/**`"
+      - "Chat GitHub actions: file issues and open PRs via Claude tool use with in-chat confirmation cards"
+      - "Chat proxy template (Cloudflare Worker + Node dev proxy) with OAuth and API-key auth modes"
+      - "AI Chat rebuilt on the Claude Messages API (SSE streaming, `claude-opus-4-8` default)"
+
+  # --- Current ---------------------------------------------------------------
+
+  - version: "1.19"
+    title: "Site Hardening & Polish"
     status: active
     section: Current
     start: 2026-06
     end: 2026-08
-    target: "Current (1.14.x)"
-    summary: "Close the gap between the repo's quality gates and what CI actually enforces — no mistake lands green."
+    target: "Current (1.19.x)"
+    summary: "Production config hardening, analytics privacy fix, landing-page opt-out flags, and a documentation freshness sweep."
     features:
-      - "Re-armed docs lint gate on a zero-violation baseline (T-014)"
-      - "Locale-independence regression guard for the Ruby/Bash tooling (T-015)"
-      - "Strict site_generation suite — build failures fail the gate (T-016)"
-      - "Re-armed pixel-snapshot gate (refreshed baselines, no continue-on-error) (T-013)"
-      - "Coverage baseline with follow-up tasks for the lowest-covered subsystems (T-005)"
-      - "Navbar WCAG 2.1 AA fixes unlocking the axe-core full audit (T-007)"
+      - "Config hardening: restored `zer0-mistakes.com` site identity + `CNAME` and the `remote_theme` contract (#174, #176)"
+      - "Opt-out flags for RSS link and visible landing-page title (`feat(home)`)"
+      - "Analytics fix: GA/GTM load only in production, skipping dev hostnames"
+      - "Documentation freshness sweep: broken cross-links repaired (T-004 follow-up)"
 
   - version: "2.0"
     title: "CMS Integration"

data/_includes/components/author-avatar-url.html

@@ -0,0 +1,28 @@
+{%- comment -%}
+  ===================================================================
+  AUTHOR AVATAR URL RESOLVER
+  ===================================================================
+  Resolves an author's avatar image URL from an author data hash.
+  Pass the author entry (from _data/authors.yml) as `data`.
+
+  Resolution order:
+  1. `avatar` is a full URL (contains "://") — used as-is. This is how you
+     reference an external avatar, e.g. a GitHub one:
+     avatar: "https://avatars.githubusercontent.com/u/10567847?v=4"
+  2. `avatar` is a relative path (e.g. /images/authors/me.png) — prefixed with
+     the site's assets path ({{ site.baseurl }}/{{ site.public_folder }}).
+  3. No `avatar`, but a `github` handle is set — falls back to that account's
+     GitHub avatar: https://github.com/<handle>.png
+  4. Otherwise — empty output (the caller renders a fallback icon).
+
+  Output is the bare URL with no surrounding whitespace. Capture it (the example
+  below is brace-free so this comment does not self-execute):
+    capture avatar_url -> include components/author-avatar-url.html data=author_data
+  ===================================================================
+{%- endcomment -%}
+{%- assign _avatar = include.data.avatar -%}
+{%- if _avatar and _avatar != "" -%}
+  {%- if _avatar contains "://" -%}{{ _avatar }}{%- else -%}{{ site.baseurl }}/{{ site.public_folder }}{{ _avatar }}{%- endif -%}
+{%- elsif include.data.github and include.data.github != "" -%}
+https://github.com/{{ include.data.github }}.png
+{%- endif -%}

data/_includes/components/author-bio.html

@@ -0,0 +1,86 @@
+{% comment %}
+  ===================================================================
+  AUTHOR BIO COMPONENT - "About the Author" section
+  ===================================================================
+
+  File: author-bio.html
+  Path: _includes/components/author-bio.html
+  Purpose: Canonical end-of-content "About the Author" block, shared by the
+           article, note, and notebook layouts. Wraps the full author-card
+           primitive in a titled <aside> and links to the author's profile
+           page when the author resolves to a known _data/authors.yml entry —
+           either by key (default) or by display name ("Zer0-Mistakes Team").
+
+  Parameters:
+  - author (required): Author key from _data/authors.yml OR a plain name string.
+  - heading (optional): Section heading text (default: "About the Author").
+  - show_profile_link (optional): Show the "More from <name>" link when the
+                     author is a known key (default: true).
+
+  Usage (wrap each line in Liquid include tags — braces omitted here because
+  Liquid parses tags even inside HTML comments, which would self-recurse):
+    include components/author-bio.html author=page.author
+    include components/author-bio.html author=page.author heading="Written by"
+
+  Gating: callers decide whether to render this at all — the article/note/
+  notebook layouts only include it when `page.author` is set and the
+  `author_profile` front-matter flag is not false.
+
+  Dependencies:
+  - components/author-card.html (style="full")
+  - _data/authors.yml
+  ===================================================================
+{% endcomment %}
+{% assign bio_heading = include.heading | default: "About the Author" %}
+
+{% assign show_profile_link = true %}
+{% if include.show_profile_link == false %}{% assign show_profile_link = false %}{% endif %}
+
+{% comment %} Resolve the author to a known _data/authors.yml key — directly, or
+   by matching the display name / display_name — so the "More from" link works
+   whether front matter uses the key (default) or the name ("Zer0-Mistakes Team").
+   The profile URL is always built from the resolved KEY so the slug is correct. {% endcomment %}
+{% assign bio_author_key = nil %}
+{% assign bio_author_data = site.data.authors[include.author] %}
+{% if bio_author_data %}
+  {% assign bio_author_key = include.author %}
+{% elsif include.author and include.author != "" %}
+  {% for entry in site.data.authors %}
+    {% if entry[1].name == include.author or entry[1].display_name == include.author %}
+      {% assign bio_author_data = entry[1] %}
+      {% assign bio_author_key = entry[0] %}
+      {% break %}
+    {% endif %}
+  {% endfor %}
+{% endif %}
+{% comment %} Only build the "More from" profile URL when the author's profile
+   page exists in the build — generated author pages aren't delivered by
+   remote_theme, so the link would 404 on a Pages consumer. See issue #204. {% endcomment %}
+{% assign bio_profile_url = nil %}
+{% if bio_author_key %}
+  {% assign bio_author_name = bio_author_data.name | default: include.author %}
+  {% assign bio_author_slug = bio_author_key | slugify %}
+  {% capture bio_author_path %}/authors/{{ bio_author_slug }}/{% endcapture %}
+  {% assign bio_author_page = site.html_pages | where: "url", bio_author_path | first %}
+  {% if bio_author_page %}
+    {% capture bio_profile_url %}{{ site.baseurl }}{{ bio_author_path }}{% endcapture %}
+  {% endif %}
+{% endif %}
+
+{% if include.author %}
+<aside class="author-section my-5 pt-4 border-top" aria-labelledby="about-the-author">
+  <h2 id="about-the-author" class="h5 mb-3">
+    <i class="bi bi-person-badge me-2" aria-hidden="true"></i>{{ bio_heading }}
+  </h2>
+
+  {% include components/author-card.html author=include.author style="full" %}
+
+  {% if show_profile_link and bio_profile_url %}
+    <div class="mt-3">
+      <a href="{{ bio_profile_url }}" class="btn btn-sm btn-outline-primary">
+        <i class="bi bi-collection me-1" aria-hidden="true"></i>More from {{ bio_author_name }}
+      </a>
+    </div>
+  {% endif %}
+</aside>
+{% endif %}