jekyll-theme-zer0 1.31.2 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +183 -0
  3. data/_data/ai.yml +1 -1
  4. data/_data/backlog.yml +149 -28
  5. data/_data/features.yml +173 -17
  6. data/_data/navigation/admin.yml +26 -8
  7. data/_data/navigation/docs.yml +2 -8
  8. data/_data/site_builder.yml +1 -1
  9. data/_data/theme-manifest.yml +74 -58
  10. data/_data/ui-text.yml +9 -0
  11. data/_includes/README.md +2 -1
  12. data/_includes/analytics/google-analytics.html +46 -9
  13. data/_includes/analytics/posthog.html +101 -77
  14. data/_includes/components/ai-chat.html +3 -3
  15. data/_includes/components/author-bio.html +3 -1
  16. data/_includes/components/author-card.html +9 -9
  17. data/_includes/components/author-eeat.html +13 -3
  18. data/_includes/components/collection-manager.html +2 -2
  19. data/_includes/components/component-showcase.html +7 -7
  20. data/_includes/components/cookie-consent-needed.html +37 -0
  21. data/_includes/components/cookie-consent.html +44 -5
  22. data/_includes/components/page-feedback.html +10 -6
  23. data/_includes/components/post-card.html +2 -2
  24. data/_includes/components/theme-customizer.html +1 -1
  25. data/_includes/content/comments.html +46 -0
  26. data/_includes/content/giscus.html +22 -13
  27. data/_includes/content/intro.html +39 -3
  28. data/_includes/content/jsonld-software.html +4 -9
  29. data/_includes/content/sitemap.html +173 -17
  30. data/_includes/core/favicon.html +42 -6
  31. data/_includes/core/footer.html +38 -17
  32. data/_includes/core/header.html +11 -2
  33. data/_includes/navigation/admin-nav.html +110 -63
  34. data/_includes/navigation/section-sidebar.html +20 -20
  35. data/_includes/navigation/sidebar-config.html +17 -8
  36. data/_includes/navigation/sidebar-right.html +16 -2
  37. data/_includes/setup/wizard.html +2 -2
  38. data/_layouts/README.md +1 -1
  39. data/_layouts/admin.html +49 -20
  40. data/_layouts/article.html +10 -10
  41. data/_layouts/book-story.html +3 -7
  42. data/_layouts/default.html +63 -2
  43. data/_layouts/news.html +8 -7
  44. data/_layouts/note.html +2 -6
  45. data/_layouts/notebook.html +2 -6
  46. data/_layouts/recipe.html +3 -7
  47. data/_layouts/root.html +7 -4
  48. data/_layouts/section.html +43 -42
  49. data/_sass/components/_back-to-top.scss +9 -0
  50. data/_sass/components/_cookie-banner.scss +31 -0
  51. data/_sass/components/_page-feedback.scss +1 -1
  52. data/_sass/components/_ui-enhancements.scss +22 -0
  53. data/_sass/core/_nav-tree.scss +10 -2
  54. data/_sass/core/_navbar.scss +19 -5
  55. data/_sass/core/_obsidian.scss +19 -3
  56. data/_sass/core/_sidebar-categories.scss +4 -2
  57. data/_sass/core/_sidebar-extras.scss +3 -2
  58. data/_sass/layouts/_admin.scss +60 -0
  59. data/_sass/layouts/_navbar-extras.scss +7 -2
  60. data/_sass/theme/_skins.scss +124 -32
  61. data/_sass/tokens/_color.scss +3 -0
  62. data/_sass/tokens/_layers.scss +12 -5
  63. data/_sass/utilities/_focus.scss +12 -1
  64. data/assets/css/main.scss +1 -0
  65. data/assets/js/code-copy.js +30 -2
  66. data/assets/js/modules/navigation/index.js +94 -40
  67. data/assets/js/modules/navigation/scroll-spy.js +70 -7
  68. data/assets/js/setup-wizard.js +2 -2
  69. data/assets/js/ui-enhancements.js +46 -0
  70. data/scripts/ai/README.md +1 -1
  71. data/scripts/ai/api_call.rb +1 -1
  72. data/scripts/bin/audit-consumer +155 -8
  73. data/scripts/bin/manifest +27 -8
  74. data/scripts/bin/validate +3 -2
  75. data/scripts/ci/test_visual_evidence_autogen.py +53 -1
  76. data/scripts/ci/visual_evidence_autogen.py +26 -7
  77. data/scripts/install/ai/client.sh +1 -1
  78. data/scripts/lib/audit.sh +156 -0
  79. data/scripts/lib/preview_generator.py +1 -1
  80. data/scripts/translate.rb +1 -1
  81. data/scripts/validate-features.rb +20 -2
  82. metadata +5 -2
data/_data/features.yml CHANGED
@@ -1,7 +1,10 @@
1
1
  # zer0-mistakes Theme Features Registry
2
2
  # Comprehensive feature tracking for the zer0-mistakes Jekyll theme
3
- # Version: 1.29.0
4
- # Last Updated: 2026-09-07
3
+ # Version: 1.31.3
4
+ # Last Updated: 2026-11-15
5
+
6
+ # PRD this catalog is linked to (governance kit, UPS-WORK-15); the PRD's Feature catalog block is generated from this file.
7
+ prd: docs/architecture/prd-requirements.md
5
8
 
6
9
  features:
7
10
  # ============================================================================
@@ -12,6 +15,7 @@ features:
12
15
  title: "Bootstrap 5.3.3 Theme Integration"
13
16
  description: "Professional Jekyll theme with Bootstrap 5.3.3 CDN integration, responsive design, and custom styling"
14
17
  implemented: true
18
+ prd: ["Feature 3"]
15
19
  version: "0.1.0"
16
20
  link: "/"
17
21
  docs: "/docs/bootstrap/"
@@ -41,6 +45,7 @@ features:
41
45
  title: "Docker-First Development Environment"
42
46
  description: "Universal cross-platform development with Docker Compose. Supports macOS (Intel/Apple Silicon), Linux, and Windows WSL with zero local dependencies"
43
47
  implemented: true
48
+ prd: ["Feature 2"]
44
49
  version: "0.1.0"
45
50
  link: "/"
46
51
  docs: "/docs/docker/"
@@ -68,6 +73,7 @@ features:
68
73
  title: "Modular AI-Powered Installer"
69
74
  description: "Self-healing installer rebuilt as a modular CLI dispatcher with declarative profiles, deploy plugins (Docker, GitHub Pages, custom), AI agent integration, and a cross-platform test matrix. Replaces the monolithic install.sh while preserving the one-line install UX"
70
75
  implemented: true
76
+ prd: ["Feature 1"]
71
77
  version: "1.0.0"
72
78
  link: "/"
73
79
  docs: "/docs/installation/"
@@ -108,6 +114,7 @@ features:
108
114
  title: "AI Preview Image Generator"
109
115
  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"
110
116
  implemented: true
117
+ prd: [TBD]
111
118
  version: "1.27.0"
112
119
  link: "/docs/features/preview-image-generator/"
113
120
  docs: "/docs/features/preview-image-generator/"
@@ -166,6 +173,7 @@ features:
166
173
  title: "AI Agent Integration (Copilot + AGENTS.md)"
167
174
  description: "Comprehensive AI development assistance with the cross-tool AGENTS.md entry point, file-scoped instruction files (layouts, includes, scripts, sass, obsidian, install, features, version-control, testing, documentation), reusable prompts, and Cursor slash-commands"
168
175
  implemented: true
176
+ prd: ["Feature 7"]
169
177
  version: "1.6.0"
170
178
  link: "https://github.com/bamr87/zer0-mistakes/blob/main/AGENTS.md"
171
179
  docs: "/docs/features/copilot-integration/"
@@ -214,6 +222,7 @@ features:
214
222
  title: "PostHog Privacy-First Analytics"
215
223
  description: "GDPR/CCPA compliant analytics with PostHog integration. Environment-aware loading with granular user consent management"
216
224
  implemented: true
225
+ prd: ["Feature 4"]
217
226
  version: "0.6.0"
218
227
  link: "/"
219
228
  docs: "/docs/features/posthog-analytics/"
@@ -227,6 +236,7 @@ features:
227
236
  tests:
228
237
  - "test/test_quality.sh"
229
238
  - "test/visual/core/security.spec.js"
239
+ - "test/visual/features/analytics-consent.spec.js"
230
240
  references:
231
241
  include: "_includes/analytics/posthog.html"
232
242
  config: "_config.yml"
@@ -245,6 +255,7 @@ features:
245
255
  title: "Cookie Consent Management"
246
256
  description: "GDPR/CCPA compliant cookie consent system with granular permissions, 365-day persistence, and Bootstrap modal preferences"
247
257
  implemented: true
258
+ prd: [TBD]
248
259
  version: "0.6.0"
249
260
  link: "/"
250
261
  docs: "/docs/features/cookie-consent/"
@@ -257,6 +268,8 @@ features:
257
268
  issue: null
258
269
  tests:
259
270
  - "test/test_quality.sh"
271
+ - "test/visual/features/banner-inset-skip-link.spec.js"
272
+ - "test/visual/features/cookie-consent-defaults.spec.js"
260
273
  references:
261
274
  include: "_includes/components/cookie-consent.html"
262
275
  config: "_config.yml"
@@ -276,6 +289,7 @@ features:
276
289
  title: "Enhanced Sidebar Navigation System"
277
290
  description: "Modern sidebar with Intersection Observer scroll spy, smooth scrolling, keyboard shortcuts, and swipe gestures. 70% reduction in scroll event overhead"
278
291
  implemented: true
292
+ prd: [TBD]
279
293
  version: "0.14.0"
280
294
  link: "/"
281
295
  docs: "/docs/features/sidebar-navigation/"
@@ -288,6 +302,7 @@ features:
288
302
  issue: null
289
303
  tests:
290
304
  - "test/visual/features/sidebar-navigation.spec.js"
305
+ - "test/visual/features/scroll-spy.spec.js"
291
306
  references:
292
307
  javascript:
293
308
  - "assets/js/modules/navigation/sidebar-state.js"
@@ -316,6 +331,7 @@ features:
316
331
  title: "Keyboard Navigation System"
317
332
  description: "Comprehensive keyboard shortcuts for power users. Navigate sections, toggle sidebars, and access features without mouse"
318
333
  implemented: true
334
+ prd: [TBD]
319
335
  version: "0.14.0"
320
336
  link: "/"
321
337
  docs: "/docs/features/keyboard-navigation/"
@@ -350,6 +366,7 @@ features:
350
366
  title: "Mobile TOC Floating Action Button"
351
367
  description: "Redesigned mobile table of contents access with FAB pattern. Bottom-right positioned 56x56px circular button with proper z-index stacking"
352
368
  implemented: true
369
+ prd: [TBD]
353
370
  version: "0.14.0"
354
371
  link: "/"
355
372
  docs: "/docs/features/mobile-toc/"
@@ -377,6 +394,7 @@ features:
377
394
  title: "Skip-to-Content Accessibility Link"
378
395
  description: "WCAG 2.1 Level AA compliant skip link. Visually hidden until Tab focus, direct jump to main content bypassing navigation"
379
396
  implemented: true
397
+ prd: [TBD]
380
398
  version: "0.14.0"
381
399
  link: "/"
382
400
  docs: "/docs/features/skip-to-content/"
@@ -389,6 +407,7 @@ features:
389
407
  issue: null
390
408
  tests:
391
409
  - "test/visual/core/accessibility.spec.js"
410
+ - "test/visual/features/banner-inset-skip-link.spec.js"
392
411
  references:
393
412
  include: "_includes/core/header.html"
394
413
  styles: "_sass/custom.scss"
@@ -401,6 +420,7 @@ features:
401
420
  title: "Jupyter Notebook Integration"
402
421
  description: "Full Jupyter notebook support with GitHub Pages compatibility. Automated nbconvert conversion, rich content rendering, and responsive design"
403
422
  implemented: true
423
+ prd: [TBD]
404
424
  version: "0.13.0"
405
425
  link: "/"
406
426
  docs: "/docs/features/jupyter-notebooks/"
@@ -437,6 +457,7 @@ features:
437
457
  title: "Mermaid Diagram Support"
438
458
  description: "Client-side Mermaid.js diagrams for 10+ diagram types, rendered as accessible figures: a zoom / fullscreen / copy-source / SVG-export toolbar, accTitle captions, an error card that keeps the source visible, and colours derived from the live design tokens so diagrams follow the colour mode and skin. GitHub Pages compatible with no build plugins required"
439
459
  implemented: true
460
+ prd: ["Feature 8"]
440
461
  version: "1.30.0"
441
462
  link: "/docs/features/mermaid-diagrams/"
442
463
  docs: "/docs/features/mermaid-diagrams/"
@@ -471,6 +492,7 @@ features:
471
492
  title: "Jekyll Collections System"
472
493
  description: "Organized content collections for posts, docs, notebooks, about pages, and quickstart guides with custom permalinks and front matter defaults"
473
494
  implemented: true
495
+ prd: [TBD]
474
496
  version: "0.1.0"
475
497
  link: "/"
476
498
  docs: "/docs/jekyll/collections/"
@@ -505,6 +527,7 @@ features:
505
527
  title: "Automated Release Management"
506
528
  description: "Semantic versioning with automated commit analysis, changelog generation, gem publishing, and GitHub releases. Full release pipeline automation"
507
529
  implemented: true
530
+ prd: ["Feature 10"]
508
531
  version: "0.5.0"
509
532
  link: "/"
510
533
  docs: "/docs/development/release-management/"
@@ -537,6 +560,7 @@ features:
537
560
  title: "Comprehensive Testing Suite"
538
561
  description: "Automated testing with core, deployment, and quality test suites. Docker-based testing, CI/CD integration, and detailed reporting"
539
562
  implemented: true
563
+ prd: ["Feature 6"]
540
564
  version: "0.10.0"
541
565
  link: "/"
542
566
  docs: "/docs/development/testing/"
@@ -567,6 +591,8 @@ features:
567
591
  title: "Automated Version Bump Workflow"
568
592
  description: "Removed in v1.20.0 — the manual version-bump GitHub Actions workflow was superseded by the release-please pipeline (see ZER0-015). Kept for ID stability and historical reference"
569
593
  implemented: false
594
+ status: deprecated
595
+ prd: ["Feature 5"]
570
596
  removed_in: "1.20.0"
571
597
  superseded_by: "ZER0-015"
572
598
  version: "0.14.2"
@@ -594,6 +620,7 @@ features:
594
620
  title: "CodeQL Security Scanning"
595
621
  description: "Automated security vulnerability scanning with GitHub CodeQL for Ruby and JavaScript code"
596
622
  implemented: true
623
+ prd: [TBD]
597
624
  version: "0.10.0"
598
625
  link: "/"
599
626
  docs: "/docs/development/security/"
@@ -622,6 +649,7 @@ features:
622
649
  title: "Comprehensive Layout System"
623
650
  description: "15+ specialized layouts for different content types with consistent hierarchy and Bootstrap integration"
624
651
  implemented: true
652
+ prd: [TBD]
625
653
  version: "0.1.0"
626
654
  link: "/"
627
655
  docs: "/docs/customization/layouts/"
@@ -668,6 +696,7 @@ features:
668
696
  title: "Modular Include Components"
669
697
  description: "70+ reusable include components organized by category for maximum flexibility and maintainability"
670
698
  implemented: true
699
+ prd: [TBD]
671
700
  version: "0.1.0"
672
701
  link: "/"
673
702
  docs: "/docs/customization/includes/"
@@ -705,6 +734,7 @@ features:
705
734
  title: "Theme Version Display Plugin"
706
735
  description: "Automatic theme version extraction from gem specification with modal display and footer integration"
707
736
  implemented: true
737
+ prd: [TBD]
708
738
  version: "0.11.0"
709
739
  link: "/"
710
740
  docs: "/docs/features/theme-version/"
@@ -736,6 +766,7 @@ features:
736
766
  title: "Privacy Policy Page"
737
767
  description: "GDPR/CCPA compliant privacy policy with comprehensive data collection transparency and PostHog analytics disclosure"
738
768
  implemented: true
769
+ prd: ["Feature 4"]
739
770
  version: "0.15.0"
740
771
  link: "/privacy-policy/"
741
772
  docs: "/privacy-policy/"
@@ -761,6 +792,7 @@ features:
761
792
  title: "Terms of Service Page"
762
793
  description: "Legal terms of service framework for site usage with customizable sections"
763
794
  implemented: true
795
+ prd: [TBD]
764
796
  version: "0.15.0"
765
797
  link: "/terms-of-service/"
766
798
  docs: "/terms-of-service/"
@@ -784,6 +816,7 @@ features:
784
816
  title: "Product Requirements Document (PRD)"
785
817
  description: "Comprehensive PRD detailing product vision, goals, architecture, personas, and feature requirements"
786
818
  implemented: true
819
+ prd: [TBD]
787
820
  version: "0.15.0"
788
821
  link: "/"
789
822
  docs: "/docs/development/prd/"
@@ -811,6 +844,7 @@ features:
811
844
  title: "Dual Documentation Architecture"
812
845
  description: "Separate technical (/docs/) and public (/pages/_docs/) documentation with MDX support and conversion workflow"
813
846
  implemented: true
847
+ prd: [TBD]
814
848
  version: "0.15.0"
815
849
  link: "/"
816
850
  docs: "/docs/development/documentation/"
@@ -842,6 +876,7 @@ features:
842
876
  title: "Automated Dependency Updates"
843
877
  description: "GitHub Actions workflow for automated Ruby gem dependency updates with PR creation"
844
878
  implemented: true
879
+ prd: [TBD]
845
880
  version: "0.14.2"
846
881
  link: "/"
847
882
  docs: "/docs/development/dependency-updates/"
@@ -866,6 +901,7 @@ features:
866
901
  title: "Continuous Integration (CI) Workflow"
867
902
  description: "Comprehensive CI pipeline with multi-Ruby version testing, quality checks, and automated deployment validation"
868
903
  implemented: true
904
+ prd: ["Feature 6"]
869
905
  version: "0.10.0"
870
906
  link: "/"
871
907
  docs: "/docs/development/ci-cd/"
@@ -895,6 +931,7 @@ features:
895
931
  title: "Shell Script Automation Library"
896
932
  description: "Collection of 15+ automation scripts for building, testing, releasing, and managing the theme"
897
933
  implemented: true
934
+ prd: [TBD]
898
935
  version: "0.5.0"
899
936
  link: "/"
900
937
  docs: "/docs/development/scripts/"
@@ -933,6 +970,7 @@ features:
933
970
  title: "Back to Top Button"
934
971
  description: "Floating button that appears on scroll, allowing users to quickly return to the top of the page with smooth scrolling animation"
935
972
  implemented: true
973
+ prd: [TBD]
936
974
  version: "0.1.0"
937
975
  link: "/"
938
976
  docs: "/docs/features/back-to-top/"
@@ -945,6 +983,7 @@ features:
945
983
  issue: null
946
984
  tests:
947
985
  - "test/visual/features/content-enhancements.spec.js"
986
+ - "test/visual/features/banner-inset-skip-link.spec.js"
948
987
  references:
949
988
  scripts:
950
989
  - "assets/js/back-to-top.js"
@@ -958,6 +997,7 @@ features:
958
997
  title: "Code Copy Button"
959
998
  description: "One-click copy functionality for code blocks with visual feedback and clipboard API integration"
960
999
  implemented: true
1000
+ prd: [TBD]
961
1001
  version: "0.1.0"
962
1002
  link: "/"
963
1003
  docs: "/docs/features/code-copy/"
@@ -984,6 +1024,7 @@ features:
984
1024
  title: "Dark/Light Mode Toggle"
985
1025
  description: "Theme color mode switcher supporting light, dark, and auto modes with system preference detection, localStorage persistence, and a server+client color_mode_default config knob with FOUC prevention"
986
1026
  implemented: true
1027
+ prd: [TBD]
987
1028
  version: "1.23.0"
988
1029
  link: "/"
989
1030
  docs: "/docs/features/color-modes/"
@@ -1016,6 +1057,7 @@ features:
1016
1057
  title: "GitHub Pages-Compatible Live Search"
1017
1058
  description: "Self-contained client-side search with live modal, JSON index, and keyboard shortcut activation. Algolia-free — works on bare GitHub Pages with no external service or API key"
1018
1059
  implemented: true
1060
+ prd: [TBD]
1019
1061
  version: "1.5.1"
1020
1062
  link: "/"
1021
1063
  docs: "/docs/features/site-search/"
@@ -1049,6 +1091,7 @@ features:
1049
1091
  title: "Auto-hide Navigation"
1050
1092
  description: "Smart navigation bar that hides on scroll down and reappears on scroll up for maximum content visibility"
1051
1093
  implemented: true
1094
+ prd: [TBD]
1052
1095
  version: "0.1.0"
1053
1096
  link: "/"
1054
1097
  docs: "/docs/features/auto-hide-nav/"
@@ -1074,6 +1117,7 @@ features:
1074
1117
  title: "Particles Background"
1075
1118
  description: "Interactive particle animation background using particles.js for visual enhancement on landing pages"
1076
1119
  implemented: true
1120
+ prd: [TBD]
1077
1121
  version: "0.1.0"
1078
1122
  link: "/"
1079
1123
  docs: "/docs/features/particles-background/"
@@ -1104,13 +1148,14 @@ features:
1104
1148
 
1105
1149
  - id: ZER0-035
1106
1150
  title: "Giscus Comments"
1107
- description: "GitHub Discussions-powered comment system with theme-aware styling, reaction support, and Claude-Code-driven conversation building"
1151
+ description: "GitHub Discussions-powered comments with a configurable widget theme, mapping, input position and language, one gated section for every layout, reactions, and Claude-Code-driven conversations"
1108
1152
  implemented: true
1109
- version: "0.1.0"
1153
+ prd: [TBD]
1154
+ version: "1.32.0"
1110
1155
  link: "/"
1111
1156
  docs: "/docs/features/giscus-comments/"
1112
1157
  tags: [comments, github, discussions, engagement, claude-code]
1113
- date: 2025-01-01
1158
+ date: 2026-11-15
1114
1159
  provenance:
1115
1160
  introduced_in: "0.1.0"
1116
1161
  pr: null
@@ -1118,10 +1163,12 @@ features:
1118
1163
  issue: null
1119
1164
  tests:
1120
1165
  - "test/visual/features/comments.spec.js"
1166
+ - "test/test_giscus_config.rb"
1121
1167
  references:
1122
1168
  includes:
1169
+ - "_includes/content/comments.html"
1123
1170
  - "_includes/content/giscus.html"
1124
- layouts: ["_layouts/article.html", "_layouts/note.html", "_layouts/notebook.html"]
1171
+ layouts: ["_layouts/article.html", "_layouts/note.html", "_layouts/notebook.html", "_layouts/recipe.html", "_layouts/book-story.html"]
1125
1172
  config: "_config.yml"
1126
1173
  script: "scripts/bin/giscus-discussions"
1127
1174
  skill: ".github/skills/giscus-conversation/SKILL.md"
@@ -1130,17 +1177,18 @@ features:
1130
1177
  - "pages/_docs/features/giscus-comments.md"
1131
1178
  features:
1132
1179
  - "GitHub Discussions integration"
1133
- - "Automatic theme detection"
1134
- - "Pathname-based mapping"
1180
+ - "Widget theme from giscus.data-theme: follows the visitor's OS (preferred_color_scheme) by default, or a fixed theme such as transparent_dark for a dark skin (#574)"
1181
+ - "Page-to-discussion mapping from giscus.data-mapping (pathname by default; url, title, og:title)"
1135
1182
  - "Reaction support"
1136
- - "Top-positioned input"
1137
- - "Consistent site.giscus.enabled gating across layouts"
1183
+ - "Comment box position from giscus.data-input-position (top by default) and widget language from giscus.data-lang (en by default)"
1184
+ - "One comment section for every layout (content/comments.html): gated on site.giscus.enabled, on by default in article/note/notebook, opt-in (comments: true) in recipe/book-story; a consumer layout needs one include line"
1138
1185
  - "Claude Code conversation building (read/draft/seed/post via gh)"
1139
1186
 
1140
1187
  - id: ZER0-036
1141
1188
  title: "MathJax Math Rendering"
1142
1189
  description: "LaTeX-style mathematical equation rendering with MathJax integration for technical documentation"
1143
1190
  implemented: true
1191
+ prd: [TBD]
1144
1192
  version: "0.1.0"
1145
1193
  link: "/"
1146
1194
  docs: "/docs/features/mathjax-math/"
@@ -1166,6 +1214,7 @@ features:
1166
1214
  title: "Table of Contents"
1167
1215
  description: "Automatic table of contents generation from page headings with scroll spy and smooth scrolling"
1168
1216
  implemented: true
1217
+ prd: [TBD]
1169
1218
  version: "0.1.0"
1170
1219
  link: "/"
1171
1220
  docs: "/docs/features/toc/"
@@ -1196,6 +1245,7 @@ features:
1196
1245
  title: "Google Analytics"
1197
1246
  description: "Google Analytics 4 integration for website traffic analysis with privacy-conscious configuration"
1198
1247
  implemented: true
1248
+ prd: ["Feature 4"]
1199
1249
  version: "0.1.0"
1200
1250
  link: "/"
1201
1251
  docs: "/docs/analytics/google-analytics/"
@@ -1208,6 +1258,7 @@ features:
1208
1258
  issue: null
1209
1259
  tests:
1210
1260
  - "test/test_quality.sh"
1261
+ - "test/visual/features/analytics-consent.spec.js"
1211
1262
  references:
1212
1263
  includes:
1213
1264
  - "_includes/analytics/google-analytics.html"
@@ -1221,6 +1272,7 @@ features:
1221
1272
  title: "Google Tag Manager"
1222
1273
  description: "Google Tag Manager integration for centralized tag management and marketing analytics"
1223
1274
  implemented: true
1275
+ prd: [TBD]
1224
1276
  version: "0.1.0"
1225
1277
  link: "/"
1226
1278
  docs: "/docs/analytics/google-tag-manager/"
@@ -1251,6 +1303,7 @@ features:
1251
1303
  title: "Breadcrumbs Navigation"
1252
1304
  description: "Hierarchical breadcrumb navigation with Schema.org structured data for SEO and user orientation"
1253
1305
  implemented: true
1306
+ prd: [TBD]
1254
1307
  version: "0.1.0"
1255
1308
  link: "/"
1256
1309
  docs: "/docs/features/breadcrumbs/"
@@ -1282,6 +1335,7 @@ features:
1282
1335
  title: "SEO Optimization"
1283
1336
  description: "Comprehensive SEO meta tag generation including Open Graph, Twitter Cards, and JSON-LD structured data"
1284
1337
  implemented: true
1338
+ prd: [TBD]
1285
1339
  version: "0.1.0"
1286
1340
  link: "/"
1287
1341
  docs: "/docs/seo/meta-tags/"
@@ -1309,6 +1363,7 @@ features:
1309
1363
  title: "Sitemap Generation"
1310
1364
  description: "Automatic XML sitemap and JSON search index generation for search engine discovery and site search"
1311
1365
  implemented: true
1366
+ prd: [TBD]
1312
1367
  version: "0.1.0"
1313
1368
  link: "/"
1314
1369
  docs: "/docs/seo/sitemap/"
@@ -1322,6 +1377,7 @@ features:
1322
1377
  tests:
1323
1378
  - "test/test_core.sh"
1324
1379
  - "test/test_deployment.sh"
1380
+ - "test/visual/features/sitemap-pagination.spec.js"
1325
1381
  references:
1326
1382
  includes:
1327
1383
  - "_includes/content/sitemap.html"
@@ -1345,6 +1401,7 @@ features:
1345
1401
  title: "Statistics Dashboard"
1346
1402
  description: "Content statistics dashboard layout with metrics visualization for posts, categories, and tags"
1347
1403
  implemented: true
1404
+ prd: [TBD]
1348
1405
  version: "0.1.0"
1349
1406
  link: "/"
1350
1407
  docs: "/docs/features/statistics-dashboard/"
@@ -1382,6 +1439,7 @@ features:
1382
1439
  title: "Obsidian Vault Integration"
1383
1440
  description: "Render an Obsidian vault as a Jekyll site without losing wiki-links, embeds, callouts, or backlinks. Includes a Liquid wiki-index, JS client-side resolver, optional Ruby plugin, and a contract that keeps GitHub Pages and self-build deployments rendering identically"
1384
1441
  implemented: true
1442
+ prd: [TBD]
1385
1443
  version: "1.3.0"
1386
1444
  link: "/docs/obsidian/"
1387
1445
  docs: "/docs/obsidian/"
@@ -1420,6 +1478,7 @@ features:
1420
1478
  title: "Obsidian Graph Views (Full + Local)"
1421
1479
  description: "Obsidian-desktop-style graph views: a full site graph with a Filters/Display/Forces settings panel, collection legend-filters, tag:/path: search, zoom + fullscreen controls and hover previews, plus a per-page local graph panel with depth and direction controls"
1422
1480
  implemented: true
1481
+ prd: [TBD]
1423
1482
  version: "1.28.0"
1424
1483
  link: "/docs/obsidian/graph/"
1425
1484
  docs: "/docs/obsidian/graph/"
@@ -1457,11 +1516,12 @@ features:
1457
1516
  title: "Bare-Minimum Remote-Theme Starter"
1458
1517
  description: "Three-file welcome starter (_config.yml + Gemfile + index.md) that bootstraps a working remote-theme site with no scaffolding required. Footer, welcome, and info partials degrade gracefully when collections are empty"
1459
1518
  implemented: true
1460
- version: "1.2.0"
1519
+ prd: [TBD]
1520
+ version: "1.32.0"
1461
1521
  link: "/"
1462
1522
  docs: "/docs/quickstart/bare-minimum/"
1463
1523
  tags: [setup, quickstart, remote-theme, github-pages]
1464
- date: 2026-02-25
1524
+ date: 2026-11-15
1465
1525
  provenance:
1466
1526
  introduced_in: "1.2.0"
1467
1527
  pr: null
@@ -1469,16 +1529,23 @@ features:
1469
1529
  issue: null
1470
1530
  tests:
1471
1531
  - "test/test_site_generation.sh"
1532
+ - "test/test_newsletter_gate.rb"
1533
+ - "test/visual/core/footer-newsletter.spec.js"
1472
1534
  references:
1473
1535
  includes:
1474
1536
  - "_includes/components/info-section.html"
1475
1537
  - "_includes/core/footer.html"
1476
1538
  layout: "_layouts/welcome.html"
1539
+ config: "_config.yml"
1540
+ docs: "pages/_docs/quickstart/bare-minimum.md"
1541
+ features:
1542
+ - "Footer newsletter signup is opt-in: it renders only when a provider endpoint is configured (newsletter.endpoint, else news.newsletter.endpoint) and then POSTs the address there; enabled: false hides it, and with no form the policy links span the row (#554)"
1477
1543
 
1478
1544
  - id: ZER0-047
1479
1545
  title: "Site Configuration Detection & Smart 404"
1480
1546
  description: "Auto-detects whether the site is a fork, remote-theme consumer, or full clone, and renders a smart 404 page that guides users back to a working entry point"
1481
1547
  implemented: true
1548
+ prd: [TBD]
1482
1549
  version: "0.22.18"
1483
1550
  link: "/404.html"
1484
1551
  docs: "/docs/features/smart-404/"
@@ -1500,6 +1567,7 @@ features:
1500
1567
  title: "Config-Driven Frontmatter Validation"
1501
1568
  description: "Schema-driven frontmatter validation system with configurable rules per collection. Catches missing required fields, bad date formats, and unknown layouts before Jekyll builds"
1502
1569
  implemented: true
1570
+ prd: [TBD]
1503
1571
  version: "0.22.17"
1504
1572
  link: "/"
1505
1573
  docs: "/docs/development/frontmatter-validation/"
@@ -1521,6 +1589,7 @@ features:
1521
1589
  title: "Dynamic Collection-Based Navigation Fallback"
1522
1590
  description: "Zero-config navigation: when no _data/navigation entry exists, the navbar auto-populates from Jekyll collections so brand-new sites have a usable nav out of the box"
1523
1591
  implemented: true
1592
+ prd: [TBD]
1524
1593
  version: "0.22.15"
1525
1594
  link: "/"
1526
1595
  docs: "/docs/features/dynamic-navigation/"
@@ -1541,11 +1610,12 @@ features:
1541
1610
  title: "Admin Layout & Configuration Dashboards"
1542
1611
  description: "Admin-style layout and dashboard partials for surfacing site configuration, build info, and feature flags in a single place"
1543
1612
  implemented: true
1544
- version: "0.21.4"
1545
- link: "/admin/"
1613
+ prd: [TBD]
1614
+ version: "1.32.0"
1615
+ link: "/about/config/"
1546
1616
  docs: "/docs/features/admin-dashboard/"
1547
1617
  tags: [admin, dashboard, ui, configuration]
1548
- date: 2025-12-28
1618
+ date: 2026-11-15
1549
1619
  provenance:
1550
1620
  introduced_in: "0.21.4"
1551
1621
  pr: 57
@@ -1558,11 +1628,17 @@ features:
1558
1628
  includes:
1559
1629
  - "_includes/navigation/admin-nav.html"
1560
1630
  - "_includes/components/admin-tabs.html"
1631
+ styles: "_sass/layouts/_admin.scss"
1632
+ data: "_data/navigation/admin.yml"
1633
+ features:
1634
+ - "Header actions reachable at every width: the first admin_actions entry is a button, the rest open from a \"More actions\" dropdown"
1635
+ - "Sidebar grouped by each item's group: key (Configure / System / Links) under list labels; counts as plain numerals, statuses as a dot plus a word, the active item a skin tint with aria-current"
1561
1636
 
1562
1637
  - id: ZER0-051
1563
1638
  title: "AGENTS.md Cross-Tool Agent Entry Point"
1564
1639
  description: "Repository-root entry point for AI coding agents (Copilot, Codex, Cursor, Aider, Jules, Continue, Claude Code, \u2026) that links into the layered guidance under .github/. Single source of truth, no per-tool duplication"
1565
1640
  implemented: true
1641
+ prd: ["Feature 7"]
1566
1642
  version: "0.22.16"
1567
1643
  link: "https://github.com/bamr87/zer0-mistakes/blob/main/AGENTS.md"
1568
1644
  docs: "/docs/development/agents/"
@@ -1583,6 +1659,7 @@ features:
1583
1659
  title: "Data-Driven Roadmap with Auto-Generated Diagram"
1584
1660
  description: "Roadmap page rendered from a YAML data source, with an auto-generated Mermaid diagram embedded in README.md"
1585
1661
  implemented: true
1662
+ prd: [TBD]
1586
1663
  version: "0.22.21"
1587
1664
  link: "/roadmap/"
1588
1665
  docs: "/roadmap/"
@@ -1604,6 +1681,7 @@ features:
1604
1681
  title: "Vendored Bootstrap & Icon Assets"
1605
1682
  description: "Bootstrap 5.3.3 CSS/JS and Bootstrap Icons committed under assets/vendor/ for GitHub Pages safety and offline development. Refreshable via scripts/vendor-install.sh"
1606
1683
  implemented: true
1684
+ prd: [TBD]
1607
1685
  version: "0.21.3"
1608
1686
  link: "/"
1609
1687
  docs: "/docs/features/vendored-assets/"
@@ -1627,6 +1705,7 @@ features:
1627
1705
  title: "AIEO Structured Data, FAQ & Glossary"
1628
1706
  description: "AI-Engine Optimization toolkit: Schema.org JSON-LD, E-E-A-T signals, FAQ page, and glossary collection for stronger AI search and LLM grounding"
1629
1707
  implemented: true
1708
+ prd: [TBD]
1630
1709
  version: "0.21.5"
1631
1710
  link: "/glossary/"
1632
1711
  docs: "/docs/seo/aieo/"
@@ -1652,6 +1731,7 @@ features:
1652
1731
  title: "ES6 Modular Navigation Architecture"
1653
1732
  description: "Navigation JavaScript refactored into ES6 modules with hover dropdowns, settings modal, and a navbar that degrades gracefully on slow connections"
1654
1733
  implemented: true
1734
+ prd: [TBD]
1655
1735
  version: "0.18.0"
1656
1736
  link: "/"
1657
1737
  docs: "/docs/features/navigation-architecture/"
@@ -1675,6 +1755,7 @@ features:
1675
1755
  title: "DevContainer Configuration"
1676
1756
  description: "VS Code Dev Container configuration for one-click cloud development environments (GitHub Codespaces, JetBrains Gateway, etc.) with Jekyll, Ruby, and Bootstrap toolchain pre-installed"
1677
1757
  implemented: true
1758
+ prd: [TBD]
1678
1759
  version: "0.17.0"
1679
1760
  link: "/"
1680
1761
  docs: "/docs/development/devcontainer/"
@@ -1695,6 +1776,8 @@ features:
1695
1776
  title: "Local Docker Publishing Pipeline"
1696
1777
  description: "Removed in v1.8.1 — the dedicated docker-compose.publish.yml / docker-compose.prod.yml local-publish path was retired; gem publishing now runs through the release-please CI pipeline (see ZER0-015) and scripts/bin/release. Kept for ID stability"
1697
1778
  implemented: false
1779
+ status: deprecated
1780
+ prd: ["Feature 10"]
1698
1781
  removed_in: "1.8.1"
1699
1782
  superseded_by: "ZER0-015"
1700
1783
  version: "0.21.1"
@@ -1717,6 +1800,7 @@ features:
1717
1800
  title: "Notes Collection & Notebook Layout"
1718
1801
  description: "Dedicated _notes collection alongside _notebooks, with shared standardized layouts for short-form knowledge capture distinct from blog posts"
1719
1802
  implemented: true
1803
+ prd: [TBD]
1720
1804
  version: "0.20.0"
1721
1805
  link: "/notes/"
1722
1806
  docs: "/notes/"
@@ -1739,6 +1823,7 @@ features:
1739
1823
  title: "Performance: Page-URL Cache for Obsidian Resolver"
1740
1824
  description: "Cached page-URL lookups and short-circuited rewrites in the Obsidian Liquid pipeline. Measurable build-time improvement on vaults with hundreds of cross-links"
1741
1825
  implemented: true
1826
+ prd: [TBD]
1742
1827
  version: "1.6.0"
1743
1828
  link: "/docs/obsidian/performance/"
1744
1829
  docs: "/docs/obsidian/performance/"
@@ -1759,6 +1844,7 @@ features:
1759
1844
  title: "AI Chat Assistant (Claude or Grok + GitHub)"
1760
1845
  description: "Floating chat grounded in the current page, answered by Claude or Grok through the proxy: streaming replies, GitHub issue/PR actions (after confirmation), and a dev-only mode that edits the page source file live"
1761
1846
  implemented: true
1847
+ prd: [TBD]
1762
1848
  version: "1.30.0"
1763
1849
  link: "/docs/features/ai-chat-assistant/"
1764
1850
  docs: "/docs/features/ai-chat-assistant/"
@@ -1786,6 +1872,7 @@ features:
1786
1872
  title: "Author Profiles System"
1787
1873
  description: "Auto-generated author profile pages and a searchable author directory from _data/authors.yml — each author gets a /authors/:key/ hub with bio, stats, and a filterable grid of their content across collections"
1788
1874
  implemented: true
1875
+ prd: [TBD]
1789
1876
  version: "1.20.0"
1790
1877
  link: "/authors/"
1791
1878
  docs: "/authors/"
@@ -1811,6 +1898,7 @@ features:
1811
1898
  title: "News Homepage Layout"
1812
1899
  description: "Magazine-style news homepage layout with configurable section styles (magazine, grid, list) and full-width content sections"
1813
1900
  implemented: true
1901
+ prd: [TBD]
1814
1902
  version: "0.1.5"
1815
1903
  link: "/"
1816
1904
  docs: "/docs/customization/layouts/"
@@ -1830,6 +1918,7 @@ features:
1830
1918
  title: "Section Layout"
1831
1919
  description: "News section layout with a collapsible sub-category sidebar, section styles, and a featured hero card for organizing posts by section"
1832
1920
  implemented: true
1921
+ prd: [TBD]
1833
1922
  version: "0.20.3"
1834
1923
  link: "/"
1835
1924
  docs: "/docs/customization/layouts/"
@@ -1850,6 +1939,7 @@ features:
1850
1939
  title: "Article Layout & Post Types"
1851
1940
  description: "Article layout for blog posts with post-type variations (standard, featured, breaking, opinion, review, tutorial, listicle, interview) surfaced via a post-type badge"
1852
1941
  implemented: true
1942
+ prd: [TBD]
1853
1943
  version: "0.20.3"
1854
1944
  link: "/"
1855
1945
  docs: "/docs/customization/layouts/"
@@ -1870,6 +1960,7 @@ features:
1870
1960
  title: "Theme Skins & Background Customizer"
1871
1961
  description: "Nine switchable theme skins with fffuel-style SVG backgrounds, a runtime customizer (skin + opacity), a palette generator, and a skin editor — all persisted to localStorage"
1872
1962
  implemented: true
1963
+ prd: ["Feature 13"]
1873
1964
  version: "0.22.10"
1874
1965
  link: "/"
1875
1966
  docs: "/docs/features/color-modes/"
@@ -1899,6 +1990,7 @@ features:
1899
1990
  title: "Nanobar Progress Bar"
1900
1991
  description: "Config-driven page-loading progress bar (color, height, position, z-index, step timing) driven by site.nanobar and injected via a thin include"
1901
1992
  implemented: true
1993
+ prd: [TBD]
1902
1994
  version: "0.22.20"
1903
1995
  link: "/"
1904
1996
  docs: "/docs/features/"
@@ -1923,6 +2015,7 @@ features:
1923
2015
  title: "Setup Wizard"
1924
2016
  description: "Nine-step in-browser wizard that assembles a complete starter project — _config.yml, dev config, Gemfile, docker-compose, navigation, first pages — with per-file download and a self-extracting bundle; the form half of the Site Builder"
1925
2017
  implemented: true
2018
+ prd: [TBD]
1926
2019
  version: "1.30.0"
1927
2020
  link: "/setup/"
1928
2021
  docs: "/docs/features/site-builder/"
@@ -1947,6 +2040,7 @@ features:
1947
2040
  title: "Table CSV Copy"
1948
2041
  description: "One-click CSV copy control injected onto content tables, scoped to article/content wrappers (skips admin and sitemap tables)"
1949
2042
  implemented: true
2043
+ prd: [TBD]
1950
2044
  version: "1.8.0"
1951
2045
  link: "/"
1952
2046
  docs: "/docs/features/"
@@ -1967,6 +2061,7 @@ features:
1967
2061
  title: "Social Share Actions"
1968
2062
  description: "Helper that builds normalized social-share text and URLs (whitespace-collapsed, deduped, length-truncated) for sharing posts"
1969
2063
  implemented: true
2064
+ prd: [TBD]
1970
2065
  version: "1.14.0"
1971
2066
  link: "/"
1972
2067
  docs: "/docs/features/"
@@ -1987,6 +2082,7 @@ features:
1987
2082
  title: "Monthly Archives Page"
1988
2083
  description: "Date-grouped archive of all posts with anchor-linked month sections for chronological browsing"
1989
2084
  implemented: true
2085
+ prd: [TBD]
1990
2086
  version: "0.16.1"
1991
2087
  link: "/archives/"
1992
2088
  docs: "/archives/"
@@ -2006,6 +2102,7 @@ features:
2006
2102
  title: "Live Component Showcase"
2007
2103
  description: "Interactive gallery of Bootstrap 5.3 and theme components (alerts, buttons, cards, accordions, tabs, …) for visual reference and design QA"
2008
2104
  implemented: true
2105
+ prd: [TBD]
2009
2106
  version: "0.22.12"
2010
2107
  link: "/"
2011
2108
  docs: "/docs/customization/includes/"
@@ -2025,6 +2122,7 @@ features:
2025
2122
  title: "AI Content Review Workflow"
2026
2123
  description: "PR workflow that reviews changed Markdown for SEO and quality via a deterministic scorer plus a Claude Code editorial agent, with docs and front-matter validation"
2027
2124
  implemented: true
2125
+ prd: [TBD]
2028
2126
  version: "1.18.0"
2029
2127
  link: "/"
2030
2128
  docs: "/docs/"
@@ -2047,6 +2145,7 @@ features:
2047
2145
  title: "Giscus Digest Workflow"
2048
2146
  description: "Scheduled read-only workflow that surfaces new Giscus (GitHub Discussions) comments to maintainers as a job-summary digest"
2049
2147
  implemented: true
2148
+ prd: [TBD]
2050
2149
  version: "1.22.0"
2051
2150
  link: "/"
2052
2151
  docs: "/docs/features/giscus-comments/"
@@ -2068,6 +2167,7 @@ features:
2068
2167
  title: "Visual Evidence Gate"
2069
2168
  description: "CI gate that requires a regression test plus before/after evidence for any UI or behavioural PR (or an explicit opt-out label), enforcing the visual-evidence standard"
2070
2169
  implemented: true
2170
+ prd: [TBD]
2071
2171
  version: "1.20.2"
2072
2172
  link: "/"
2073
2173
  docs: "/docs/development/testing/"
@@ -2089,6 +2189,7 @@ features:
2089
2189
  title: "Autonomous Issue & CI Pipeline"
2090
2190
  description: "Issue-triage to resolve-to-PR autopilot plus a CI self-repair loop and auto-merge, extending the continuous-evolution system (off by default)"
2091
2191
  implemented: true
2192
+ prd: [TBD]
2092
2193
  version: "1.23.0"
2093
2194
  link: "/"
2094
2195
  docs: "/docs/development/ci-cd/"
@@ -2113,6 +2214,7 @@ features:
2113
2214
  title: "Secret Scanning Workflow"
2114
2215
  description: "CI workflow that scans pushes and pull requests for leaked secrets, complementing CodeQL static analysis"
2115
2216
  implemented: true
2217
+ prd: [TBD]
2116
2218
  version: "1.21.0"
2117
2219
  link: "/"
2118
2220
  docs: "/docs/development/security/"
@@ -2132,6 +2234,7 @@ features:
2132
2234
  title: "Unified Settings Panel"
2133
2235
  description: "Navbar settings offcanvas reorganized into Appearance, Site, and Developer tabs — consolidated color-mode/skin/background controls, delegated copy-to-clipboard, and existence-gated admin quick links computed in cached Liquid"
2134
2236
  implemented: true
2237
+ prd: [TBD]
2135
2238
  version: "1.25.0"
2136
2239
  link: "/"
2137
2240
  docs: "/docs/customization/includes/"
@@ -2167,6 +2270,7 @@ features:
2167
2270
  title: "AI-Generated Multilingual Translations"
2168
2271
  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"
2169
2272
  implemented: true
2273
+ prd: [TBD]
2170
2274
  version: "1.27.0"
2171
2275
  link: "/"
2172
2276
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/systems/multilingual-translation.md"
@@ -2202,8 +2306,9 @@ features:
2202
2306
 
2203
2307
  - id: ZER0-079
2204
2308
  title: "Config-Driven Favicon and Browser Identity"
2205
- description: "Head include emitting favicon, SVG icon, Apple touch icon, web manifest, and theme-color tags from an optional favicon config block, with an explicit /favicon.ico fallback that works on baseurl deployments"
2309
+ description: "Head include emitting favicon, SVG icon, Apple touch icon, web manifest, and theme-color tags from an optional favicon config block, with an existence-gated root favicon fallback (.ico, .png, .svg) that works on baseurl deployments and never links a missing file"
2206
2310
  implemented: true
2311
+ prd: [TBD]
2207
2312
  version: "1.28.0"
2208
2313
  link: "/"
2209
2314
  docs: "/docs/features/favicon/"
@@ -2222,7 +2327,7 @@ features:
2222
2327
  - "_includes/core/head.html"
2223
2328
  docs: "pages/_docs/features/favicon.md"
2224
2329
  features:
2225
- - "Zero-config default: explicit /favicon.ico link on every page (fixes silent 404s and baseurl project sites)"
2330
+ - "Zero-config default: explicit link to the root /favicon.ico (else /favicon.png, else /favicon.svg) only when that file exists in site.static_files — no 404 for remote-theme consumers without one (#536)"
2226
2331
  - "Optional SVG favicon, PNG sizes, apple-touch-icon, and web manifest links"
2227
2332
  - "scheme-aware theme-color metas tracking --bs-body-bg (light #ffffff / dark #212529), emitted even with no config; favicon.theme_color pins a single value"
2228
2333
 
@@ -2230,6 +2335,7 @@ features:
2230
2335
  title: "Books Collection — Children's Picture-Book Publishing"
2231
2336
  description: "A `books` collection with immersive cover-to-cover layouts: book landing page (cover hero + TOC), story reading pages with illustration plates and prev/next navigation, bookshelf components, and AI-provenance colophons whose front matter doubles as the image-generation manifest"
2232
2337
  implemented: true
2338
+ prd: [TBD]
2233
2339
  version: "1.28.0"
2234
2340
  link: "/books/zer0-tales/"
2235
2341
  docs: "/docs/features/book-collection/"
@@ -2267,6 +2373,7 @@ features:
2267
2373
  title: "Claude Design System Round-Trip"
2268
2374
  description: "Design-token layer aligned with the zer0-mistakes Claude Design project: corner-radius, logo-palette, and display-size tokens join _sass/tokens/; a git mirror of the design project lives under _design-system/ (plain-CSS tokens, React component specs from buttons to FABs to post cards to skeletons, foundation cards, website UI kit); and a CI parity check fails when theme and mirror drift"
2269
2375
  implemented: true
2376
+ prd: [TBD]
2270
2377
  version: "1.29.0"
2271
2378
  link: "/"
2272
2379
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/ui/design-system.md"
@@ -2302,6 +2409,7 @@ features:
2302
2409
  title: "Live Design System Pages"
2303
2410
  description: "The design system published on the site itself: _design-system/ is force-included in the Jekyll build so tokens, styles.css, specimen cards, and component sources get real URLs under /_design-system/, and a /design/ hub page renders the foundation specimens in live iframes, catalogs the component twins, and links the Claude Design page canvas covering all 24 layouts"
2304
2411
  implemented: true
2412
+ prd: [TBD]
2305
2413
  version: "1.29.0"
2306
2414
  link: "/design/"
2307
2415
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/ui/design-system.md"
@@ -2336,6 +2444,7 @@ features:
2336
2444
  title: "Page View Counter"
2337
2445
  description: "Per-page view tracking with the count shown in the article meta row — a local-first provider that needs no server, or an HTTP counter endpoint, both gated by DNT, GPC, and consent"
2338
2446
  implemented: true
2447
+ prd: [TBD]
2339
2448
  version: "1.29.0"
2340
2449
  link: "/"
2341
2450
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/features/page-views.md"
@@ -2374,6 +2483,7 @@ features:
2374
2483
  title: "Cookbook & Recipes Collection"
2375
2484
  description: "A `recipes` collection whose structured front matter (ingredients, steps, yield, times, ratio_basis) renders as a working recipe page: a fact bar, a serving scaler, an ingredient checklist, a numbered method, a build-time baker's-percentage table, and schema.org Recipe JSON-LD — with client-side scaling and US/metric conversion (volume↔weight via an ingredient density table) layered on as progressive enhancement"
2376
2485
  implemented: true
2486
+ prd: [TBD]
2377
2487
  version: "1.29.0"
2378
2488
  link: "/recipes/"
2379
2489
  docs: "/docs/features/cookbook-collection/"
@@ -2423,6 +2533,7 @@ features:
2423
2533
  title: "Visual Evidence Autogen"
2424
2534
  description: "CI produces a UI pull request's visual artifacts instead of only verifying them: before/after evidence from the PR's generator or a generic base-vs-head render, and 9-skin pixel baselines refreshed only when the reviewer agent judges the diff to be the change the PR describes"
2425
2535
  implemented: true
2536
+ prd: [TBD]
2426
2537
  version: "1.30.0"
2427
2538
  link: "/"
2428
2539
  docs: "/docs/development/testing/"
@@ -2455,6 +2566,7 @@ features:
2455
2566
  title: "Claude-Guided Site Builder"
2456
2567
  description: "An embedded Claude session that rides alongside the setup wizard: it sees every answer, fills in the forms, checks the machine, reads the theme's real source, writes the generated project to disk and starts Docker — through the local dev proxy, with a confirmation card before every action"
2457
2568
  implemented: true
2569
+ prd: [TBD]
2458
2570
  version: "1.30.0"
2459
2571
  link: "/setup/"
2460
2572
  docs: "/docs/features/site-builder/"
@@ -2499,6 +2611,7 @@ features:
2499
2611
  title: "Bring-Your-Own AI Provider (Claude or Grok) and Open Site Builder Sessions"
2500
2612
  description: "The Site Builder and chat proxy answer with Claude (Anthropic) or Grok (xAI): users paste their own token on the Connect step, pick a model and an image renderer, and run a guided or open session that can also modify an existing site file by file and render images with Grok Imagine"
2501
2613
  implemented: true
2614
+ prd: [TBD]
2502
2615
  version: "1.30.0"
2503
2616
  link: "/setup/"
2504
2617
  docs: "/docs/features/site-builder/"
@@ -2539,3 +2652,46 @@ features:
2539
2652
  - "Project session — list/open an existing site under WIZARD_TARGET_ROOT, tree/read, write/edit (unique snippet)/delete text files behind confirmation cards, git status/diff/log/init, jekyll build inside the container"
2540
2653
  - "Image generation — generate_image renders with grok-imagine-image-2.0 (or gpt-image-2) into assets/ (PNG/JPEG/WebP sniffed, 8 MB cap) with a thumbnail card; generated sites carry ai_chat.provider, preview_images and the matching .env.example keys"
2541
2654
  - "Validation — test/test_providers.mjs (mock xAI + Anthropic upstreams), test/test_wizard_store.mjs (project + asset rules), setup-wizard.spec.js (mocked proxy: connect as Grok, token never stored, open mode, existing sites), evidence in test/visual/evidence/site-builder-providers/"
2655
+
2656
+ - id: ZER0-088
2657
+ title: "zer0 studio — the Rails theme workbench"
2658
+ description: "A Rails 8.1 app at studio/ that designs, customizes and updates this theme from a browser: token and skin editors with live diffs and WCAG contrast, a read-only theme doctor, docs-site preview builds shown in a cross-origin iframe, consumer-site registration with the audit as a live-logged job, the version lockstep table, release dry runs and the consumer pin matrix. Every write is a digest-guarded atomic rename of a file the allow-list names; every script run is the theme's own"
2659
+ implemented: true
2660
+ prd: ["Feature 13"]
2661
+ version: "1.32.0"
2662
+ link: "https://github.com/bamr87/zer0-mistakes/tree/main/studio"
2663
+ docs: "https://github.com/bamr87/zer0-mistakes/blob/main/studio/README.md"
2664
+ tags: [studio, rails, design-tokens, skins, doctor, preview, consumers, release]
2665
+ date: 2026-10-21
2666
+ provenance:
2667
+ introduced_in: "1.32.0"
2668
+ pr: null
2669
+ commit: "89068b2"
2670
+ issue: null
2671
+ tests:
2672
+ - "studio/test/services/token_editor_test.rb"
2673
+ - "studio/test/services/skin_editor_test.rb"
2674
+ - "studio/test/services/theme_doctor_test.rb"
2675
+ - "studio/test/services/script_runner_test.rb"
2676
+ - "studio/test/integration/security_test.rb"
2677
+ - "studio/test/integration/previews_test.rb"
2678
+ - "studio/test/integration/gem_boundary_test.rb"
2679
+ references:
2680
+ scripts:
2681
+ - "studio/app/services/token_editor.rb"
2682
+ - "studio/app/services/skin_editor.rb"
2683
+ - "studio/app/services/site_theme_config.rb"
2684
+ - "studio/app/services/theme_doctor.rb"
2685
+ - "studio/app/services/script_runner.rb"
2686
+ - "studio/app/services/preview_builder.rb"
2687
+ config: "_config.yml"
2688
+ pages:
2689
+ - "studio/README.md"
2690
+ - "studio/AGENTS.md"
2691
+ components:
2692
+ - "Design — _sass/tokens/* with their _design-system/tokens/* mirrors edited together (ScssDeclarations splices values by byte range, so comments and formatting survive), skins across _skins.scss, skins.css, _backgrounds.scss and theme_backgrounds.yml with the RGB triplet derived from the brand, a live unified diff under every form, WCAG 2.1 contrast per skin, and scripts/design-system-check.rb after every save"
2693
+ - "Doctor — read-only rules with findings.jsonl-shaped output: token parity, the skin registries, background assets the gem does not ship, link contrast, the settings page's byte copy of _config.yml, the studio/ exclusion"
2694
+ - "Previews — the docs site built as a job with the theme's own bundle exec jekyll build into studio/tmp/previews/<id>, shown from the OTHER loopback origin so the theme's colour-mode storage stays apart from the studio's; the newest five builds are kept"
2695
+ - "Customize — consumer checkouts under SITES_DIR registered by realpath, their theme keys in _config.yml rewritten one line at a time, scripts/bin/audit-consumer as a job whose JSON report lands on the site, _data/consumers.yml joined by repository name"
2696
+ - "Update — the six version files against lib/jekyll-theme-zer0/version.rb, scripts/bin/release --dry-run and scripts/propagate.rb (report mode) as jobs; the studio never releases or dispatches"
2697
+ - "Boundary — studio/ is excluded by both Jekyll configs and scripts/bin/validate, never packaged by the gemspec (gem_boundary_test), never in the theme image (.dockerignore); loopback-only unless STUDIO_PASSWORD; nonce CSP without unsafe-inline; every path through ConfinedPath, every write through AtomicWrite; the Docker image runs Solid Queue inside Puma with Solid Cable for live logs"