jekyll-theme-zer0 1.21.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8552bc1992ed59b6f63392207f6a49d12bc9e66ac16cd43b61bb57700f45395e
-  data.tar.gz: 54304e964cff2dc7fafe3ab03c722dfac994011994be96201d700a67e224ec35
+  metadata.gz: 73435219bd711a7e8485d895f8e07156804569313c0213be215495e994a72c6b
+  data.tar.gz: ff65b97cd663f7cacd18757aad849725c18c9e036563e72bff8185e894dd8c47
 SHA512:
-  metadata.gz: d656b64ce2440c13047ce0802ca968c767cbcfe20eb8b442973e5cc0a63aafb29263081f2ab5c5737260775643193e9fad9eaa08680fe0151b8442efae15128d
-  data.tar.gz: a1a9000773b53140084dd986072d1cbfacda99ba66859cfd5cd82965e163b1aa47184ef64e56cb41ed0a6e0ae2950a96a5f4935e637f073c756de757afb36a53
+  metadata.gz: 94a2e3468724372bbf8478f3615b3195a6182a0775dd4ab45be19d9b0a57cdb0af7e85d7d990faa2456cbdc66b23e58b71af7a3fa487fd9e021ffb6175f4edd3
+  data.tar.gz: 1bbacd96a15484f01b193394addcc354afb9b35364d9eedf388b0dfce1dd24dafefdc9b7fee46fb1862e5212a50bddb325e3fbe0c8c0808bc254527b2a2e86b7

data/CHANGELOG.md

@@ -5,6 +5,63 @@ 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.23.0](https://github.com/bamr87/zer0-mistakes/compare/v1.22.0...v1.23.0) (2026-06-30)
+
+
+### Features
+
+* **automation:** issue-triage→PR autopilot (off by default) ([#243](https://github.com/bamr87/zer0-mistakes/issues/243)) ([229e076](https://github.com/bamr87/zer0-mistakes/commit/229e07654915a9a0e401b30796c4f6c078eda926))
+* **automation:** verify-and-close lane — autopilot closes human issues fixed on main when CI is green ([#247](https://github.com/bamr87/zer0-mistakes/issues/247)) ([7cc7cb0](https://github.com/bamr87/zer0-mistakes/commit/7cc7cb0cdada7f64d59f46c2f4c3a7e88afbde6b))
+* **layouts:** add color_mode_default config knob with FOUC prevention ([#253](https://github.com/bamr87/zer0-mistakes/issues/253)) ([55bee97](https://github.com/bamr87/zer0-mistakes/commit/55bee970686c10a08aeed15bff43c3b66b5293e7))
+
+
+### Bug Fixes
+
+* **ci:** make claude-run truly OAuth-first — drop API key whenever an OAuth token is set ([#248](https://github.com/bamr87/zer0-mistakes/issues/248)) ([d2b44d2](https://github.com/bamr87/zer0-mistakes/commit/d2b44d2766f5c8543f4c5d8ddb79015e726f88fd))
+* **ci:** pass -R to gh pr view in the self-repair opt-in gate ([#260](https://github.com/bamr87/zer0-mistakes/issues/260)) ([67d67d7](https://github.com/bamr87/zer0-mistakes/commit/67d67d74146366afe6d495f529ba2c86a4513e18))
+* **includes:** existence-guard component-showcase demo links ([#219](https://github.com/bamr87/zer0-mistakes/issues/219)) ([#256](https://github.com/bamr87/zer0-mistakes/issues/256)) ([ef15e79](https://github.com/bamr87/zer0-mistakes/commit/ef15e79dc64db0dc7e721ca10bb7c1e826612473))
+* **layouts:** existence-gate /authors/ breadcrumb in author.html for remote-theme consumers ([#252](https://github.com/bamr87/zer0-mistakes/issues/252)) ([cae21a7](https://github.com/bamr87/zer0-mistakes/commit/cae21a7107b1875ac876f9e30cf71590ac7b0cc5))
+* **search:** existence-gate search modal form action for remote-theme consumers ([#257](https://github.com/bamr87/zer0-mistakes/issues/257)) ([b915c4d](https://github.com/bamr87/zer0-mistakes/commit/b915c4dead5eff3d6a2986720ebacdcf2bed5e33))
+* **skins:** map dark + contrast skins to their background assets ([#245](https://github.com/bamr87/zer0-mistakes/issues/245)) ([fb8808e](https://github.com/bamr87/zer0-mistakes/commit/fb8808e5ec754785b8239b01bccfab99569b70fa)), closes [#240](https://github.com/bamr87/zer0-mistakes/issues/240)
+
+## [Unreleased]
+
+### Bug Fixes
+
+* **includes:** existence-guard component-showcase demo links — breadcrumb and list-group items now render as real links when the target page exists in the build (`/docs/`, `/docs/customization/`, `/categories/`, `/tags/`) and as plain text when absent; removes inert `href="#"` / `onclick="return false;"` workaround ([#219](https://github.com/bamr87/zer0-mistakes/issues/219)) (evidence: [`test/visual/evidence/component-showcase/`](test/visual/evidence/component-showcase/README.md))
+
+### Tests
+
+* **navigation:** regression spec for section-sidebar /tags/ existence gate — asserts "Browse All Tags" and "View All Tags" links only render when /tags/ page is present in the build (issue #218, `test/visual/section-sidebar-tags-gate.spec.js`)
+### Features
+
+- **color_mode_default config knob** — new `color_mode_default` setting (`dark` | `light` | `auto`, default `auto`) in `_config.yml` controls Bootstrap's `data-bs-theme` both server-side (in `_layouts/root.html`) and client-side. An early inline script (`_includes/core/color-mode-init.html`, loaded before Bootstrap CSS) applies the correct theme before any `[data-bs-theme]` selector is evaluated, preventing FOUC. `localStorage["theme"]` (the Appearance panel override) always wins over the config default. `auto` follows `prefers-color-scheme` — backward-compatible with the previous behaviour. (evidence: [`test/visual/evidence/color-mode-default/`](test/visual/evidence/color-mode-default/README.md))
+### Bug Fixes
+
+* **search:** existence-gate search modal form action to `/sitemap/` only when that page is present in the build; falls back to `#` (safe no-op) for remote-theme Pages consumers without a `/sitemap/` stub (closes [#202](https://github.com/bamr87/zer0-mistakes/issues/202))
+* **layouts:** existence-gate `/authors/` breadcrumb link in author.html for remote-theme consumers ([#204](https://github.com/bamr87/zer0-mistakes/issues/204))
+### Tests
+
+* **tests:** add negative-path smoke tests for AI chat render guard — asserts FAB/panel are absent when `proxy_ready: false` and no `api_key` is set (closes #168)
+
+## [1.22.0](https://github.com/bamr87/zer0-mistakes/compare/v1.21.0...v1.22.0) (2026-06-26)
+
+
+### Features
+
+* **ci:** autonomous CI self-repair loop (pipeline Phase 6) ([#237](https://github.com/bamr87/zer0-mistakes/issues/237)) ([a43db45](https://github.com/bamr87/zer0-mistakes/commit/a43db45eae2da2fcf141ac959d0268dd7e6a52bd))
+* **comments:** enable Giscus + wire Claude Code conversation building ([#214](https://github.com/bamr87/zer0-mistakes/issues/214)) ([fef60a5](https://github.com/bamr87/zer0-mistakes/commit/fef60a5cf78697e94c40f098c336112fe5cdd845))
+* **obsidian:** interactive callouts, parity fixes, a11y + vendored graph ([#200](https://github.com/bamr87/zer0-mistakes/issues/200)) ([affbcd6](https://github.com/bamr87/zer0-mistakes/commit/affbcd62b3f7023457195d5137d5ace2a3751367))
+
+
+### Bug Fixes
+
+* **ci:** enable auto-merge via GraphQL (no git checkout) + graceful no-op ([#232](https://github.com/bamr87/zer0-mistakes/issues/232)) ([4c8c74c](https://github.com/bamr87/zer0-mistakes/commit/4c8c74cfb0775feda9103b379ebcecc4874d517f))
+* **includes:** existence-gate category badge links for remote-theme consumers ([#235](https://github.com/bamr87/zer0-mistakes/issues/235)) ([16ed0a8](https://github.com/bamr87/zer0-mistakes/commit/16ed0a8c77f4cd66b98918a66d00133fa90f4457))
+* **includes:** make component-showcase demo links inert to avoid consumer 404s ([#236](https://github.com/bamr87/zer0-mistakes/issues/236)) ([e96646b](https://github.com/bamr87/zer0-mistakes/commit/e96646b196c2931fc240411ded23184a1e01c8f5))
+* **navigation:** existence-gate the section-sidebar /tags/ links ([#231](https://github.com/bamr87/zer0-mistakes/issues/231)) ([a02b062](https://github.com/bamr87/zer0-mistakes/commit/a02b0622a4f16dfea375629ad347891861283fe3))
+* **search:** degrade search UI gracefully when /search.json is absent ([#234](https://github.com/bamr87/zer0-mistakes/issues/234)) ([f3a718d](https://github.com/bamr87/zer0-mistakes/commit/f3a718d1a9219bee92e2d1a46d2e32c870efb624))
+
 ## [1.21.0](https://github.com/bamr87/zer0-mistakes/compare/v1.20.2...v1.21.0) (2026-06-26)
 
 

data/_data/ai.yml

@@ -0,0 +1,10 @@
+# =============================================================================
+# _data/ai.yml — one place the AI model is configured for zer0-mistakes agents
+# -----------------------------------------------------------------------------
+# Read by .github/actions/claude-run (the issue-autopilot's AI step). Change the
+# model here and every autopilot agent call uses it. Auth is NOT here — it comes
+# from the CLAUDE_CODE_OAUTH_TOKEN (preferred) or ANTHROPIC_API_KEY secret.
+# =============================================================================
+provider: anthropic
+model: claude-opus-4-8
+max_tokens: 8000

data/_data/backlog.yml

@@ -62,8 +62,8 @@
 
 meta:
   title: "zer0-mistakes Backlog"
-  updated: 2026-06-15
-  next_id: 27
+  updated: 2026-06-29
+  next_id: 33
 
 tasks:
   # --- Housekeeping (seeded so the loop has work on day one) ------------------
@@ -270,7 +270,7 @@ tasks:
 
   - id: T-010
     title: "Complete v1.9 quickstart docs rewrite with getting-started guide and screenshots"
-    status: open
+    status: done
     priority: P2
     area: docs
     risk: low
@@ -286,9 +286,9 @@ tasks:
       - "At least one guide beyond `bare-minimum.md` covers the standard fork/remote-theme workflow."
       - "Each guide includes at least one screenshot stored under `assets/images/docs/quickstart/`."
       - "All new pages pass `docs-validate.yml` front-matter and link checks."
-    links: { issue: null, pr: null, roadmap: "1.9" }
+    links: { issue: 126, pr: null, roadmap: "1.9" }
     created: 2026-06-01
-    updated: 2026-06-01
+    updated: 2026-06-29
 
   - id: T-011
     title: "Add Ruby unit tests for uncovered _plugins/ generators"
@@ -358,7 +358,7 @@ tasks:
 
   - id: T-013
     title: "Refresh Playwright snapshot baselines and re-arm the pixel gate"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -373,9 +373,9 @@ tasks:
       - "Baselines under `test/visual/snapshots/` regenerated and committed."
       - "`continue-on-error: true` removed from the snapshot step in `ci.yml`."
       - "Snapshot tier passes in CI on an unchanged follow-up commit."
-    links: { issue: null, pr: null, roadmap: "1.13" }
+    links: { issue: 135, pr: null, roadmap: "1.13" }
     created: 2026-06-10
-    updated: 2026-06-10
+    updated: 2026-06-29
 
   - id: T-014
     title: "Re-arm the docs link-check gate (remove warn-only || true)"
@@ -538,7 +538,7 @@ tasks:
 
   - id: T-020
     title: "CI coverage for installer interactive wizard and upgrade path (coverage rank #2)"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -554,13 +554,13 @@ tasks:
       - "Wizard prompt helpers exercised non-interactively (piped answers) in a test_install_* suite."
       - "An upgrade fixture covers detect→migrate→verify for at least one version gap."
       - "Suites run in CI via the standard installer e2e discovery (test_install_*.sh)."
-    links: { issue: null, pr: null, roadmap: "1.14" }
+    links: { issue: 147, pr: null, roadmap: "1.14" }
     created: 2026-06-12
-    updated: 2026-06-12
+    updated: 2026-06-29
 
   - id: T-021
     title: "Vendor cytoscape.js so the Obsidian graph works without a CDN"
-    status: open
+    status: done
     priority: P3
     area: feat
     risk: standard
@@ -577,9 +577,9 @@ tasks:
       - "cytoscape.min.js committed under assets/vendor/ and referenced via a local path."
       - "full-graph.html no longer references cdn.jsdelivr.net."
       - "The graph page renders nodes/edges with the vendored file (no network)."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 152, pr: null, roadmap: null }
     created: 2026-06-13
-    updated: 2026-06-13
+    updated: 2026-06-29
 
   # --- 2026-06-15 audit -------------------------------------------------------
 
@@ -637,7 +637,7 @@ tasks:
 
   - id: T-024
     title: "Unit tests for scripts/content-review.rb scoring engine"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -657,13 +657,13 @@ tasks:
       - "At least one test verifies the `--strict` flag exits non-zero when the fail threshold is crossed."
       - "Tests run under `LC_ALL=C` (locale-independence parity with T-015 guard)."
       - "`./scripts/bin/test` stays green with the new tests included."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 166, pr: null, roadmap: null }
     created: 2026-06-15
-    updated: 2026-06-15
+    updated: 2026-06-29
 
   - id: T-025
     title: "Playwright smoke tests for the site-wide search modal"
-    status: open
+    status: done
     priority: P2
     area: tests
     risk: standard
@@ -683,13 +683,13 @@ tasks:
       - "A result-population check: query matching a known post title (e.g. 'Hello World') yields at least one result `<a>` element."
       - "Mutual-exclusion guard: opening search while Settings offcanvas is open closes the offcanvas first (no stacked backdrops)."
       - "Spec runs in the smoke project (`npx playwright test --project=smoke`) without a network request to an external index."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 167, pr: 208, roadmap: null }
     created: 2026-06-15
-    updated: 2026-06-15
+    updated: 2026-06-29
 
   - id: T-026
     title: "Playwright smoke test for AI chat widget render guard and FAB visibility"
-    status: open
+    status: done
     priority: P3
     area: tests
     risk: standard
@@ -710,6 +710,156 @@ tasks:
       - "A mock-config test (inject `data-ai-chat-enabled` attribute or use a fixture page with the widget force-enabled) verifies the FAB renders and the chat panel toggles open/closed on click."
       - "The test passes in the smoke project without a live AI backend."
       - "`./scripts/bin/test` (including the Playwright smoke tier) stays green."
-    links: { issue: null, pr: null, roadmap: null }
+    links: { issue: 168, pr: 250, roadmap: null }
     created: 2026-06-15
-    updated: 2026-06-15
+    updated: 2026-06-29
+
+  # --- Issue intake 2026-06-26: remote-theme 404 cluster + docs ----------------
+  # Cap: 5 of 7 open issues triaged this run. Deferred (next run): #203 (consumer
+  # checklist docs — companion to T-031); #201 (giscus typo — already in-flight in
+  # PR #214, so no task, to avoid duplicating live work).
+
+  - id: T-027
+    title: "Theme chrome injects unconditional links (/authors/, /news/, /tags/, /posts/, graph) that 404 for remote-theme consumers"
+    status: done
+    priority: P2
+    area: a11y
+    risk: standard
+    effort: M
+    source: issue
+    route: a11y
+    summary: >-
+      Umbrella for the remote-theme 404 class (#204): the theme chrome itself
+      injects internal links to pages whose generators live in `_plugins` (skipped
+      by GitHub Pages safe mode), so a built consumer site has broken links on
+      every page. Guard each link by existence the way the footer "Quick Links"
+      block already does. Specific instances are T-029 (#218 sidebar) and T-030
+      (#219 showcase); T-028 (#202) is the search/sitemap variant. Any fix that
+      edits `_plugins/` is CODEOWNERS-gated -> human review.
+    acceptance:
+      - "Theme-injected chrome links render only when their target exists (mirror the footer Quick-Links existence guard)."
+      - "A link check over a built remote-theme `_site` reports no theme-injected 404s."
+      - "No edit to `lib/jekyll-theme-zer0/version.rb` or release files."
+    links: { issue: 204, pr: 252, roadmap: null }
+    created: 2026-06-26
+    updated: 2026-06-29
+
+  - id: T-028
+    title: "remote_theme Pages consumers 404 on /search.json and /sitemap/ (generator is plugin-only)"
+    status: done
+    priority: P2
+    area: feat
+    risk: standard
+    effort: M
+    source: issue
+    route: code-fixer
+    summary: >-
+      On a pure remote-theme Pages consumer, `/search.json` and `/sitemap/` 404
+      because `_plugins/search_and_sitemap_generator.rb` never runs under Pages
+      safe mode (#202). Provide a Pages-safe fallback (committed stubs the navbar
+      search + sitemap link can resolve, or graceful degradation in
+      `assets/js/search-modal.js`). NOTE: editing `_plugins/` is CODEOWNERS-gated
+      -> human review; prefer the non-plugin path.
+    acceptance:
+      - "On a remote-theme Pages build, the navbar search resolves (no /search.json 404) or degrades gracefully."
+      - "The /sitemap/ link resolves (no 404) for a remote-theme consumer."
+      - "No new runtime dependency; no edit to version/release files."
+    links: { issue: 202, pr: 257, roadmap: null }
+    created: 2026-06-26
+    updated: 2026-06-29
+
+  - id: T-029
+    title: "Guard the unconditional /tags/ link in section-sidebar.html for remote-theme consumers"
+    status: done
+    priority: P2
+    area: feat
+    risk: low
+    effort: S
+    source: issue
+    route: theme-ui
+    summary: >-
+      `_includes/navigation/section-sidebar.html:69` hardcodes a `/tags/` link;
+      remote-theme consumers have no `/tags/` index (plugin-only), so it 404s
+      (#218). Guard it the way `_includes/core/footer.html` (~138-147) guards its
+      links, or gate on a `site.tags_page` flag. Instance of the T-027 class.
+    acceptance:
+      - "The sidebar 'View All Tags' link renders only when the tags index exists (or a documented site flag is set)."
+      - "Remote-theme consumers no longer 404 from the sidebar link; the Jekyll build stays green."
+      - "A `test/visual/*.spec.js` regression asserts the conditional render (theme-ui / visual-evidence)."
+    links: { issue: 218, pr: 254, roadmap: null }
+    created: 2026-06-26
+    updated: 2026-06-29
+
+  - id: T-030
+    title: "component-showcase.html hardcodes demo links (/docs/, /pages/, /docs/customization/) that 404 for consumers"
+    status: done
+    priority: P3
+    area: feat
+    risk: low
+    effort: S
+    source: issue
+    route: theme-ui
+    summary: >-
+      `_includes/components/component-showcase.html` hardcodes absolute demo links
+      (~323-325, 417/421) that 404 for any consumer without those exact routes
+      (#219). Parameterize them (the component already accepts `sections`) or guard
+      each by existence. Low priority — demo component — but it makes the showcase
+      un-includable as-is. Instance of the T-027 class.
+    acceptance:
+      - "The showcase's demo links are parameterized or existence-guarded (no hardcoded absolute paths that can 404)."
+      - "Including the showcase on a consumer site produces no theme-injected 404s; the Jekyll build stays green."
+      - "A `test/visual/*.spec.js` regression covers the parameterized/guarded links (theme-ui / visual-evidence)."
+    links: { issue: 219, pr: 256, roadmap: null }
+    created: 2026-06-26
+    updated: 2026-06-29
+
+  - id: T-031
+    title: "Document the safe-mode build-overlay recipe for consumers building outside GitHub Pages"
+    status: done
+    priority: P3
+    area: docs
+    risk: low
+    effort: S
+    source: issue
+    route: content
+    summary: >-
+      Consumers who build the theme outside GitHub Pages (own CI/Actions) must
+      reinvent the safe-mode overlay: clone the remote theme, overlay content,
+      strip `_plugins`, then `jekyll build --strict_front_matter` (#220). Document
+      the recipe in the docs (companion to the #203 consumer checklist). A proven
+      reference exists in lifehacker.dev's `scripts/ci/build.sh`.
+    acceptance:
+      - "A docs page/section under `pages/_docs/` documents the build-overlay recipe (clone -> overlay -> strip _plugins -> strict build)."
+      - "It is cross-linked from the remote-theme/deploy docs and passes markdownlint + the content-review deterministic tier."
+      - "No code change; docs only."
+    links: { issue: 220, pr: 251, roadmap: null }
+    created: 2026-06-26
+    updated: 2026-06-26
+
+  - id: T-032
+    title: "Add color_mode_default config knob (dark|light|auto) with FOUC prevention"
+    status: done
+    priority: P2
+    area: feat
+    risk: low
+    effort: S
+    source: issue
+    route: theme-ui
+    summary: >-
+      Implement a color_mode_default config key (values dark|light|auto, default auto).
+      Server-side: root.html reads site.color_mode_default and sets data-bs-theme
+      accordingly (auto resolves to dark as SSR fallback). Client-side: an early inline
+      script (_includes/core/color-mode-init.html, before Bootstrap CSS) applies the
+      correct theme respecting both the config default and a localStorage["theme"] override,
+      preventing FOUC. auto follows prefers-color-scheme — backward-compatible.
+    acceptance:
+      - "site.color_mode_default: dark|light|auto is documented in _config.yml."
+      - "root.html server-renders data-bs-theme from the config (not hardcoded 'dark')."
+      - "An early inline script before Bootstrap CSS prevents FOUC for all three modes."
+      - "localStorage['theme'] override wins over the config default."
+      - "auto follows prefers-color-scheme; backward-compatible with the previous behaviour."
+      - "Regression spec test/visual/color-mode-default.spec.js passes (smoke tier)."
+      - "Before/after evidence committed under test/visual/evidence/color-mode-default/."
+    links: { issue: 241, pr: 253, roadmap: null }
+    created: 2026-06-29
+    updated: 2026-06-29

data/_data/navigation/docs.yml

@@ -70,6 +70,10 @@
       url: /docs/deployment/
     - title: GitHub Pages
       url: /docs/deployment/github-pages/
+    - title: Remote-Theme Consumer Checklist
+      url: /docs/deployment/remote-theme-checklist/
+    - title: Safe-Mode Build Overlay
+      url: /docs/deployment/build-overlay/
     - title: Netlify
       url: /docs/deployment/netlify/
     - title: Custom Domain

data/_data/theme_backgrounds.yml

@@ -99,3 +99,27 @@ skins:
     gradient: "assets/backgrounds/gradients/sunrise.svg"
     pattern: "assets/backgrounds/patterns/sunrise.svg"
     noise: "assets/backgrounds/noise/sunrise.svg"
+
+  # `dark` is the DEFAULT theme_skin, and `contrast` is advertised as valid, but
+  # neither was mapped here — so the SVG-background feature had no entry for them
+  # (issue #240). The gradient/pattern/noise assets already ship; these entries
+  # wire them up. Colors are taken from each skin's gradient stops.
+  dark:
+    label: "Dark"
+    colors:
+      primary: "#1a1a2e"
+      secondary: "#16213e"
+      accent: "#0f3460"
+    gradient: "assets/backgrounds/gradients/dark.svg"
+    pattern: "assets/backgrounds/patterns/dark.svg"
+    noise: "assets/backgrounds/noise/dark.svg"
+
+  contrast:
+    label: "Contrast"
+    colors:
+      primary: "#111111"
+      secondary: "#333333"
+      accent: "#ffcc00"
+    gradient: "assets/backgrounds/gradients/contrast.svg"
+    pattern: "assets/backgrounds/patterns/contrast.svg"
+    noise: "assets/backgrounds/noise/contrast.svg"

data/_includes/components/component-showcase.html

@@ -15,13 +15,22 @@
                         tabs,progress,breadcrumbs,table,tooltips,list-group
                         Default: all sections
 
-  Usage:
-    {% include components/component-showcase.html %}
-    {% include components/component-showcase.html sections="alerts,buttons,cards" %}
+  Usage (wrapped in raw so these examples are shown literally and NOT executed —
+  un-wrapped, Liquid runs them even inside this HTML comment and the include
+  recursively includes itself → "stack level too deep"):
+    {% raw %}{% include components/component-showcase.html %}
+    {% include components/component-showcase.html sections="alerts,buttons,cards" %}{% endraw %}
 
   Dependencies:
   - Bootstrap 5.3 CSS & JS (loaded by theme)
   - Bootstrap Icons (loaded by theme)
+
+  Note: The breadcrumb and list-group demo links are existence-guarded (issue #219).
+        Each target URL is resolved against site.html_pages (and collection docs
+        for collection-backed routes). When the page exists in the build the link
+        is real; when it does not the label renders as plain text. This keeps the
+        showcase safe for remote-theme consumers who may lack /docs/, /posts/,
+        /categories/, /tags/, or /docs/customization/.
   ===================================================================
 -->
 {% assign sections = include.sections | default: "alerts,buttons,badges,cards,accordion,tabs,progress,breadcrumbs,table,tooltips,list-group" %}
@@ -318,11 +327,29 @@ theme: jekyll-theme-zer0</code></pre>
 <!-- ===== BREADCRUMBS ===== -->
 <h3 id="showcase-breadcrumbs">Breadcrumbs</h3>
 <p>Hierarchical navigation trail showing current page position:</p>
+{% comment %} Existence-guard the demo breadcrumb links so they never 404 on
+   remote-theme consumers that lack /docs/ or /docs/customization/. When the
+   target page is in the build the crumb is a real link; otherwise plain text.
+   Home (/) is always present. Pattern mirrors _includes/navigation/breadcrumbs.html. {% endcomment %}
+{% assign _demo_docs_page = site.html_pages | where: "url", "/docs/" | first %}
+{% unless _demo_docs_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_docs_page = _col.docs | where: "url", "/docs/" | first %}
+    {% if _demo_docs_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
+{% assign _demo_custom_page = site.html_pages | where: "url", "/docs/customization/" | first %}
+{% unless _demo_custom_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_custom_page = _col.docs | where: "url", "/docs/customization/" | first %}
+    {% if _demo_custom_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
 <nav aria-label="breadcrumb example" class="mb-4">
   <ol class="breadcrumb">
-    <li class="breadcrumb-item"><a href="/" class="text-decoration-none"><i class="bi bi-house me-1"></i>Home</a></li>
-    <li class="breadcrumb-item"><a href="/docs/" class="text-decoration-none">Documentation</a></li>
-    <li class="breadcrumb-item"><a href="/docs/customization/" class="text-decoration-none">Customization</a></li>
+    <li class="breadcrumb-item"><a href="{{ '/' | relative_url }}" class="text-decoration-none"><i class="bi bi-house me-1"></i>Home</a></li>
+    <li class="breadcrumb-item">{% if _demo_docs_page %}<a href="{{ '/docs/' | relative_url }}" class="text-decoration-none">Documentation</a>{% else %}Documentation{% endif %}</li>
+    <li class="breadcrumb-item">{% if _demo_custom_page %}<a href="{{ '/docs/customization/' | relative_url }}" class="text-decoration-none">Customization</a>{% else %}Customization{% endif %}</li>
     <li class="breadcrumb-item active" aria-current="page">Theme Colors</li>
   </ol>
 </nav>
@@ -411,25 +438,67 @@ document.addEventListener('DOMContentLoaded', () => {
 <!-- ===== LIST GROUP ===== -->
 <h3 id="showcase-list-group">List Group</h3>
 <p>Organized content lists with icons, badges, and action states:</p>
+{% comment %} Existence-guard the demo list-group links (issue #219). Each target
+   URL is resolved against site.html_pages + collection docs. When present the
+   item is a real <a>; when absent it renders as a non-linking <div> so no 404
+   is injected on remote-theme consumers that lack /posts/, /docs/, /categories/,
+   or /tags/. Pattern mirrors section-sidebar.html and author-bio.html. {% endcomment %}
+{% assign _demo_posts_page = site.html_pages | where: "url", "/posts/" | first %}
+{% unless _demo_posts_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_posts_page = _col.docs | where: "url", "/posts/" | first %}
+    {% if _demo_posts_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
+{% assign _demo_cats_page = site.html_pages | where: "url", "/categories/" | first %}
+{% unless _demo_cats_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_cats_page = _col.docs | where: "url", "/categories/" | first %}
+    {% if _demo_cats_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
+{% assign _demo_tags_page = site.html_pages | where: "url", "/tags/" | first %}
+{% unless _demo_tags_page %}
+  {% for _col in site.collections %}
+    {% assign _demo_tags_page = _col.docs | where: "url", "/tags/" | first %}
+    {% if _demo_tags_page %}{% break %}{% endif %}
+  {% endfor %}
+{% endunless %}
 <div class="row g-4 mb-4">
   <div class="col-md-6">
     <div class="list-group">
-      <a href="/pages/" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_posts_page %}
+      <a href="{{ '/posts/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-journal-richtext text-primary me-2"></i>Blog Posts</span>
         <span class="badge bg-primary rounded-pill">{{ site.posts.size | default: "12" }}</span>
-      </a>
-      <a href="/docs/" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_posts_page %}</a>{% else %}</div>{% endif %}
+      {% if _demo_docs_page %}
+      <a href="{{ '/docs/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-book text-success me-2"></i>Documentation</span>
         <span class="badge bg-success rounded-pill">{{ site.documents.size | default: "8" }}</span>
-      </a>
-      <a href="/categories/" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_docs_page %}</a>{% else %}</div>{% endif %}
+      {% if _demo_cats_page %}
+      <a href="{{ '/categories/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-collection text-info me-2"></i>Categories</span>
         <span class="badge bg-info rounded-pill">{{ site.categories.size | default: "6" }}</span>
-      </a>
-      <a href="/tags/" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% if _demo_cats_page %}</a>{% else %}</div>{% endif %}
+      {% if _demo_tags_page %}
+      <a href="{{ '/tags/' | relative_url }}" class="list-group-item list-group-item-action d-flex justify-content-between align-items-center">
+      {% else %}
+      <div class="list-group-item d-flex justify-content-between align-items-center">
+      {% endif %}
         <span><i class="bi bi-tags text-warning me-2"></i>Tags</span>
         <span class="badge bg-warning text-dark rounded-pill">{{ site.tags.size | default: "24" }}</span>
-      </a>
+      {% if _demo_tags_page %}</a>{% else %}</div>{% endif %}
     </div>
   </div>
   <div class="col-md-6">

data/_includes/components/js-cdn.html

@@ -44,15 +44,23 @@
 {% endif %}
 
 <!-- Obsidian wiki-link / embed / tag client-side resolver (fallback for the
-     remote_theme GH Pages build, where _plugins/obsidian_links.rb cannot run). -->
+     remote_theme GH Pages build, where _plugins/obsidian_links.rb cannot run).
+     Honours `obsidian: { enabled: false }` in _config.yml — when disabled the
+     resolver script is not loaded and the flag self-disables any fork that
+     loads it another way. Note: `| default: true` would flip `false` back to
+     true (Liquid treats false as falsy), so test enabled == false explicitly. -->
 {%- assign obsidian_attachments_path = site.obsidian.attachments_path | default: '/assets/images/notes' -%}
 <script>
   window.OBSIDIAN_CONFIG = window.OBSIDIAN_CONFIG || {};
+  window.OBSIDIAN_CONFIG.enabled = {% if site.obsidian.enabled == false %}false{% else %}true{% endif %};
   window.OBSIDIAN_CONFIG.wikiIndexUrl = {{ '/assets/data/wiki-index.json' | relative_url | jsonify }};
   window.OBSIDIAN_CONFIG.attachmentsPath = {{ obsidian_attachments_path | relative_url | jsonify }};
   window.OBSIDIAN_CONFIG.tagBase = {{ '/tags/' | relative_url | jsonify }};
+  window.OBSIDIAN_CONFIG.cytoscapeUrl = {{ '/assets/vendor/cytoscape/cytoscape.min.js' | relative_url | jsonify }};
 </script>
-<script defer src="{{ '/assets/js/obsidian-wiki-links.js' | relative_url }}"></script>
+{%- if site.obsidian.enabled != false -%}
+<script defer src="{{ '/assets/js/obsidian-wiki-links.js' | relative_url }}?v={{ site.time | date: '%s' }}"></script>
+{%- endif -%}
 
 <!-- Optional fork overrides: opt-in via `site.user_overrides: true` in _config.yml. -->
 {% if site.user_overrides %}

data/_includes/components/post-card.html

@@ -108,16 +108,30 @@
     <div class="card-body d-flex flex-column">
       
       <!-- Category Badge -->
-      {% comment %} Category base is configurable (`category_base`, default `/news`)
-         to avoid hardcoded 404s for remote-theme consumers. See issue #204. {% endcomment %}
+      {% comment %} Category base is configurable (`category_base`, default `/news`).
+         Only link the badge when that category index page exists in the build;
+         otherwise render a plain badge so remote-theme consumers (whose category
+         section is plugin/page-generated and absent) don't get a 404. Mirrors
+         the tag-badge / footer Quick-Links existence guard. See issue #204. {% endcomment %}
       {% if show_category and include.post.categories.size > 0 %}
         {% assign _category_base = site.category_base | default: '/news' %}
+        {% assign primary_category = include.post.categories | first %}
+        {% capture _category_url %}{{ _category_base }}/{{ primary_category | slugify }}/{% endcapture %}
+        {% comment %} Category index pages can live in site.pages (a regular page) or
+           site.posts (a dated section index), so check both. {% endcomment %}
+        {% assign _category_page = site.html_pages | where: "url", _category_url | first %}
+        {% unless _category_page %}
+          {% assign _category_page = site.posts | where: "url", _category_url | first %}
+        {% endunless %}
         <div class="mb-2">
-          {% assign primary_category = include.post.categories | first %}
-          <a href="{{ site.baseurl }}{{ _category_base }}/{{ primary_category | slugify }}/"
+          {% if _category_page %}
+          <a href="{{ site.baseurl }}{{ _category_url }}"
              class="badge bg-primary text-decoration-none">
             {{ primary_category }}
           </a>
+          {% else %}
+          <span class="badge bg-primary">{{ primary_category }}</span>
+          {% endif %}
         </div>
       {% endif %}