jekyll-theme-zer0 1.31.3 → 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 (63) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +131 -0
  3. data/_data/backlog.yml +97 -28
  4. data/_data/features.yml +164 -15
  5. data/_data/navigation/admin.yml +26 -8
  6. data/_data/navigation/docs.yml +2 -8
  7. data/_data/theme-manifest.yml +63 -47
  8. data/_data/ui-text.yml +9 -0
  9. data/_includes/README.md +2 -1
  10. data/_includes/components/ai-chat.html +2 -2
  11. data/_includes/components/author-bio.html +3 -1
  12. data/_includes/components/author-card.html +9 -9
  13. data/_includes/components/author-eeat.html +13 -3
  14. data/_includes/components/collection-manager.html +2 -2
  15. data/_includes/components/component-showcase.html +7 -7
  16. data/_includes/components/cookie-consent-needed.html +37 -0
  17. data/_includes/components/cookie-consent.html +15 -5
  18. data/_includes/components/page-feedback.html +9 -5
  19. data/_includes/components/post-card.html +2 -2
  20. data/_includes/components/theme-customizer.html +1 -1
  21. data/_includes/content/comments.html +46 -0
  22. data/_includes/content/giscus.html +22 -13
  23. data/_includes/content/intro.html +17 -1
  24. data/_includes/content/jsonld-software.html +4 -9
  25. data/_includes/core/footer.html +36 -14
  26. data/_includes/navigation/admin-nav.html +110 -63
  27. data/_includes/navigation/section-sidebar.html +20 -20
  28. data/_includes/navigation/sidebar-config.html +17 -8
  29. data/_includes/navigation/sidebar-right.html +16 -2
  30. data/_layouts/README.md +1 -1
  31. data/_layouts/admin.html +49 -20
  32. data/_layouts/article.html +10 -10
  33. data/_layouts/book-story.html +3 -7
  34. data/_layouts/default.html +55 -1
  35. data/_layouts/news.html +8 -7
  36. data/_layouts/note.html +2 -6
  37. data/_layouts/notebook.html +2 -6
  38. data/_layouts/recipe.html +3 -7
  39. data/_layouts/root.html +7 -4
  40. data/_layouts/section.html +43 -42
  41. data/_sass/components/_page-feedback.scss +1 -1
  42. data/_sass/components/_ui-enhancements.scss +22 -0
  43. data/_sass/core/_nav-tree.scss +10 -2
  44. data/_sass/core/_navbar.scss +19 -5
  45. data/_sass/core/_obsidian.scss +19 -3
  46. data/_sass/core/_sidebar-categories.scss +4 -2
  47. data/_sass/core/_sidebar-extras.scss +3 -2
  48. data/_sass/layouts/_admin.scss +60 -0
  49. data/_sass/layouts/_navbar-extras.scss +7 -2
  50. data/_sass/theme/_skins.scss +124 -32
  51. data/_sass/tokens/_color.scss +3 -0
  52. data/_sass/tokens/_layers.scss +12 -5
  53. data/assets/css/main.scss +1 -0
  54. data/assets/js/code-copy.js +30 -2
  55. data/assets/js/setup-wizard.js +2 -2
  56. data/assets/js/ui-enhancements.js +46 -0
  57. data/scripts/ai/README.md +1 -1
  58. data/scripts/bin/audit-consumer +155 -8
  59. data/scripts/bin/manifest +27 -8
  60. data/scripts/bin/validate +3 -2
  61. data/scripts/lib/audit.sh +156 -0
  62. data/scripts/validate-features.rb +20 -2
  63. 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/"
@@ -246,6 +255,7 @@ features:
246
255
  title: "Cookie Consent Management"
247
256
  description: "GDPR/CCPA compliant cookie consent system with granular permissions, 365-day persistence, and Bootstrap modal preferences"
248
257
  implemented: true
258
+ prd: [TBD]
249
259
  version: "0.6.0"
250
260
  link: "/"
251
261
  docs: "/docs/features/cookie-consent/"
@@ -259,6 +269,7 @@ features:
259
269
  tests:
260
270
  - "test/test_quality.sh"
261
271
  - "test/visual/features/banner-inset-skip-link.spec.js"
272
+ - "test/visual/features/cookie-consent-defaults.spec.js"
262
273
  references:
263
274
  include: "_includes/components/cookie-consent.html"
264
275
  config: "_config.yml"
@@ -278,6 +289,7 @@ features:
278
289
  title: "Enhanced Sidebar Navigation System"
279
290
  description: "Modern sidebar with Intersection Observer scroll spy, smooth scrolling, keyboard shortcuts, and swipe gestures. 70% reduction in scroll event overhead"
280
291
  implemented: true
292
+ prd: [TBD]
281
293
  version: "0.14.0"
282
294
  link: "/"
283
295
  docs: "/docs/features/sidebar-navigation/"
@@ -319,6 +331,7 @@ features:
319
331
  title: "Keyboard Navigation System"
320
332
  description: "Comprehensive keyboard shortcuts for power users. Navigate sections, toggle sidebars, and access features without mouse"
321
333
  implemented: true
334
+ prd: [TBD]
322
335
  version: "0.14.0"
323
336
  link: "/"
324
337
  docs: "/docs/features/keyboard-navigation/"
@@ -353,6 +366,7 @@ features:
353
366
  title: "Mobile TOC Floating Action Button"
354
367
  description: "Redesigned mobile table of contents access with FAB pattern. Bottom-right positioned 56x56px circular button with proper z-index stacking"
355
368
  implemented: true
369
+ prd: [TBD]
356
370
  version: "0.14.0"
357
371
  link: "/"
358
372
  docs: "/docs/features/mobile-toc/"
@@ -380,6 +394,7 @@ features:
380
394
  title: "Skip-to-Content Accessibility Link"
381
395
  description: "WCAG 2.1 Level AA compliant skip link. Visually hidden until Tab focus, direct jump to main content bypassing navigation"
382
396
  implemented: true
397
+ prd: [TBD]
383
398
  version: "0.14.0"
384
399
  link: "/"
385
400
  docs: "/docs/features/skip-to-content/"
@@ -405,6 +420,7 @@ features:
405
420
  title: "Jupyter Notebook Integration"
406
421
  description: "Full Jupyter notebook support with GitHub Pages compatibility. Automated nbconvert conversion, rich content rendering, and responsive design"
407
422
  implemented: true
423
+ prd: [TBD]
408
424
  version: "0.13.0"
409
425
  link: "/"
410
426
  docs: "/docs/features/jupyter-notebooks/"
@@ -441,6 +457,7 @@ features:
441
457
  title: "Mermaid Diagram Support"
442
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"
443
459
  implemented: true
460
+ prd: ["Feature 8"]
444
461
  version: "1.30.0"
445
462
  link: "/docs/features/mermaid-diagrams/"
446
463
  docs: "/docs/features/mermaid-diagrams/"
@@ -475,6 +492,7 @@ features:
475
492
  title: "Jekyll Collections System"
476
493
  description: "Organized content collections for posts, docs, notebooks, about pages, and quickstart guides with custom permalinks and front matter defaults"
477
494
  implemented: true
495
+ prd: [TBD]
478
496
  version: "0.1.0"
479
497
  link: "/"
480
498
  docs: "/docs/jekyll/collections/"
@@ -509,6 +527,7 @@ features:
509
527
  title: "Automated Release Management"
510
528
  description: "Semantic versioning with automated commit analysis, changelog generation, gem publishing, and GitHub releases. Full release pipeline automation"
511
529
  implemented: true
530
+ prd: ["Feature 10"]
512
531
  version: "0.5.0"
513
532
  link: "/"
514
533
  docs: "/docs/development/release-management/"
@@ -541,6 +560,7 @@ features:
541
560
  title: "Comprehensive Testing Suite"
542
561
  description: "Automated testing with core, deployment, and quality test suites. Docker-based testing, CI/CD integration, and detailed reporting"
543
562
  implemented: true
563
+ prd: ["Feature 6"]
544
564
  version: "0.10.0"
545
565
  link: "/"
546
566
  docs: "/docs/development/testing/"
@@ -571,6 +591,8 @@ features:
571
591
  title: "Automated Version Bump Workflow"
572
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"
573
593
  implemented: false
594
+ status: deprecated
595
+ prd: ["Feature 5"]
574
596
  removed_in: "1.20.0"
575
597
  superseded_by: "ZER0-015"
576
598
  version: "0.14.2"
@@ -598,6 +620,7 @@ features:
598
620
  title: "CodeQL Security Scanning"
599
621
  description: "Automated security vulnerability scanning with GitHub CodeQL for Ruby and JavaScript code"
600
622
  implemented: true
623
+ prd: [TBD]
601
624
  version: "0.10.0"
602
625
  link: "/"
603
626
  docs: "/docs/development/security/"
@@ -626,6 +649,7 @@ features:
626
649
  title: "Comprehensive Layout System"
627
650
  description: "15+ specialized layouts for different content types with consistent hierarchy and Bootstrap integration"
628
651
  implemented: true
652
+ prd: [TBD]
629
653
  version: "0.1.0"
630
654
  link: "/"
631
655
  docs: "/docs/customization/layouts/"
@@ -672,6 +696,7 @@ features:
672
696
  title: "Modular Include Components"
673
697
  description: "70+ reusable include components organized by category for maximum flexibility and maintainability"
674
698
  implemented: true
699
+ prd: [TBD]
675
700
  version: "0.1.0"
676
701
  link: "/"
677
702
  docs: "/docs/customization/includes/"
@@ -709,6 +734,7 @@ features:
709
734
  title: "Theme Version Display Plugin"
710
735
  description: "Automatic theme version extraction from gem specification with modal display and footer integration"
711
736
  implemented: true
737
+ prd: [TBD]
712
738
  version: "0.11.0"
713
739
  link: "/"
714
740
  docs: "/docs/features/theme-version/"
@@ -740,6 +766,7 @@ features:
740
766
  title: "Privacy Policy Page"
741
767
  description: "GDPR/CCPA compliant privacy policy with comprehensive data collection transparency and PostHog analytics disclosure"
742
768
  implemented: true
769
+ prd: ["Feature 4"]
743
770
  version: "0.15.0"
744
771
  link: "/privacy-policy/"
745
772
  docs: "/privacy-policy/"
@@ -765,6 +792,7 @@ features:
765
792
  title: "Terms of Service Page"
766
793
  description: "Legal terms of service framework for site usage with customizable sections"
767
794
  implemented: true
795
+ prd: [TBD]
768
796
  version: "0.15.0"
769
797
  link: "/terms-of-service/"
770
798
  docs: "/terms-of-service/"
@@ -788,6 +816,7 @@ features:
788
816
  title: "Product Requirements Document (PRD)"
789
817
  description: "Comprehensive PRD detailing product vision, goals, architecture, personas, and feature requirements"
790
818
  implemented: true
819
+ prd: [TBD]
791
820
  version: "0.15.0"
792
821
  link: "/"
793
822
  docs: "/docs/development/prd/"
@@ -815,6 +844,7 @@ features:
815
844
  title: "Dual Documentation Architecture"
816
845
  description: "Separate technical (/docs/) and public (/pages/_docs/) documentation with MDX support and conversion workflow"
817
846
  implemented: true
847
+ prd: [TBD]
818
848
  version: "0.15.0"
819
849
  link: "/"
820
850
  docs: "/docs/development/documentation/"
@@ -846,6 +876,7 @@ features:
846
876
  title: "Automated Dependency Updates"
847
877
  description: "GitHub Actions workflow for automated Ruby gem dependency updates with PR creation"
848
878
  implemented: true
879
+ prd: [TBD]
849
880
  version: "0.14.2"
850
881
  link: "/"
851
882
  docs: "/docs/development/dependency-updates/"
@@ -870,6 +901,7 @@ features:
870
901
  title: "Continuous Integration (CI) Workflow"
871
902
  description: "Comprehensive CI pipeline with multi-Ruby version testing, quality checks, and automated deployment validation"
872
903
  implemented: true
904
+ prd: ["Feature 6"]
873
905
  version: "0.10.0"
874
906
  link: "/"
875
907
  docs: "/docs/development/ci-cd/"
@@ -899,6 +931,7 @@ features:
899
931
  title: "Shell Script Automation Library"
900
932
  description: "Collection of 15+ automation scripts for building, testing, releasing, and managing the theme"
901
933
  implemented: true
934
+ prd: [TBD]
902
935
  version: "0.5.0"
903
936
  link: "/"
904
937
  docs: "/docs/development/scripts/"
@@ -937,6 +970,7 @@ features:
937
970
  title: "Back to Top Button"
938
971
  description: "Floating button that appears on scroll, allowing users to quickly return to the top of the page with smooth scrolling animation"
939
972
  implemented: true
973
+ prd: [TBD]
940
974
  version: "0.1.0"
941
975
  link: "/"
942
976
  docs: "/docs/features/back-to-top/"
@@ -963,6 +997,7 @@ features:
963
997
  title: "Code Copy Button"
964
998
  description: "One-click copy functionality for code blocks with visual feedback and clipboard API integration"
965
999
  implemented: true
1000
+ prd: [TBD]
966
1001
  version: "0.1.0"
967
1002
  link: "/"
968
1003
  docs: "/docs/features/code-copy/"
@@ -989,6 +1024,7 @@ features:
989
1024
  title: "Dark/Light Mode Toggle"
990
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"
991
1026
  implemented: true
1027
+ prd: [TBD]
992
1028
  version: "1.23.0"
993
1029
  link: "/"
994
1030
  docs: "/docs/features/color-modes/"
@@ -1021,6 +1057,7 @@ features:
1021
1057
  title: "GitHub Pages-Compatible Live Search"
1022
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"
1023
1059
  implemented: true
1060
+ prd: [TBD]
1024
1061
  version: "1.5.1"
1025
1062
  link: "/"
1026
1063
  docs: "/docs/features/site-search/"
@@ -1054,6 +1091,7 @@ features:
1054
1091
  title: "Auto-hide Navigation"
1055
1092
  description: "Smart navigation bar that hides on scroll down and reappears on scroll up for maximum content visibility"
1056
1093
  implemented: true
1094
+ prd: [TBD]
1057
1095
  version: "0.1.0"
1058
1096
  link: "/"
1059
1097
  docs: "/docs/features/auto-hide-nav/"
@@ -1079,6 +1117,7 @@ features:
1079
1117
  title: "Particles Background"
1080
1118
  description: "Interactive particle animation background using particles.js for visual enhancement on landing pages"
1081
1119
  implemented: true
1120
+ prd: [TBD]
1082
1121
  version: "0.1.0"
1083
1122
  link: "/"
1084
1123
  docs: "/docs/features/particles-background/"
@@ -1109,13 +1148,14 @@ features:
1109
1148
 
1110
1149
  - id: ZER0-035
1111
1150
  title: "Giscus Comments"
1112
- 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"
1113
1152
  implemented: true
1114
- version: "0.1.0"
1153
+ prd: [TBD]
1154
+ version: "1.32.0"
1115
1155
  link: "/"
1116
1156
  docs: "/docs/features/giscus-comments/"
1117
1157
  tags: [comments, github, discussions, engagement, claude-code]
1118
- date: 2025-01-01
1158
+ date: 2026-11-15
1119
1159
  provenance:
1120
1160
  introduced_in: "0.1.0"
1121
1161
  pr: null
@@ -1123,10 +1163,12 @@ features:
1123
1163
  issue: null
1124
1164
  tests:
1125
1165
  - "test/visual/features/comments.spec.js"
1166
+ - "test/test_giscus_config.rb"
1126
1167
  references:
1127
1168
  includes:
1169
+ - "_includes/content/comments.html"
1128
1170
  - "_includes/content/giscus.html"
1129
- 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"]
1130
1172
  config: "_config.yml"
1131
1173
  script: "scripts/bin/giscus-discussions"
1132
1174
  skill: ".github/skills/giscus-conversation/SKILL.md"
@@ -1135,17 +1177,18 @@ features:
1135
1177
  - "pages/_docs/features/giscus-comments.md"
1136
1178
  features:
1137
1179
  - "GitHub Discussions integration"
1138
- - "Automatic theme detection"
1139
- - "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)"
1140
1182
  - "Reaction support"
1141
- - "Top-positioned input"
1142
- - "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"
1143
1185
  - "Claude Code conversation building (read/draft/seed/post via gh)"
1144
1186
 
1145
1187
  - id: ZER0-036
1146
1188
  title: "MathJax Math Rendering"
1147
1189
  description: "LaTeX-style mathematical equation rendering with MathJax integration for technical documentation"
1148
1190
  implemented: true
1191
+ prd: [TBD]
1149
1192
  version: "0.1.0"
1150
1193
  link: "/"
1151
1194
  docs: "/docs/features/mathjax-math/"
@@ -1171,6 +1214,7 @@ features:
1171
1214
  title: "Table of Contents"
1172
1215
  description: "Automatic table of contents generation from page headings with scroll spy and smooth scrolling"
1173
1216
  implemented: true
1217
+ prd: [TBD]
1174
1218
  version: "0.1.0"
1175
1219
  link: "/"
1176
1220
  docs: "/docs/features/toc/"
@@ -1201,6 +1245,7 @@ features:
1201
1245
  title: "Google Analytics"
1202
1246
  description: "Google Analytics 4 integration for website traffic analysis with privacy-conscious configuration"
1203
1247
  implemented: true
1248
+ prd: ["Feature 4"]
1204
1249
  version: "0.1.0"
1205
1250
  link: "/"
1206
1251
  docs: "/docs/analytics/google-analytics/"
@@ -1227,6 +1272,7 @@ features:
1227
1272
  title: "Google Tag Manager"
1228
1273
  description: "Google Tag Manager integration for centralized tag management and marketing analytics"
1229
1274
  implemented: true
1275
+ prd: [TBD]
1230
1276
  version: "0.1.0"
1231
1277
  link: "/"
1232
1278
  docs: "/docs/analytics/google-tag-manager/"
@@ -1257,6 +1303,7 @@ features:
1257
1303
  title: "Breadcrumbs Navigation"
1258
1304
  description: "Hierarchical breadcrumb navigation with Schema.org structured data for SEO and user orientation"
1259
1305
  implemented: true
1306
+ prd: [TBD]
1260
1307
  version: "0.1.0"
1261
1308
  link: "/"
1262
1309
  docs: "/docs/features/breadcrumbs/"
@@ -1288,6 +1335,7 @@ features:
1288
1335
  title: "SEO Optimization"
1289
1336
  description: "Comprehensive SEO meta tag generation including Open Graph, Twitter Cards, and JSON-LD structured data"
1290
1337
  implemented: true
1338
+ prd: [TBD]
1291
1339
  version: "0.1.0"
1292
1340
  link: "/"
1293
1341
  docs: "/docs/seo/meta-tags/"
@@ -1315,6 +1363,7 @@ features:
1315
1363
  title: "Sitemap Generation"
1316
1364
  description: "Automatic XML sitemap and JSON search index generation for search engine discovery and site search"
1317
1365
  implemented: true
1366
+ prd: [TBD]
1318
1367
  version: "0.1.0"
1319
1368
  link: "/"
1320
1369
  docs: "/docs/seo/sitemap/"
@@ -1352,6 +1401,7 @@ features:
1352
1401
  title: "Statistics Dashboard"
1353
1402
  description: "Content statistics dashboard layout with metrics visualization for posts, categories, and tags"
1354
1403
  implemented: true
1404
+ prd: [TBD]
1355
1405
  version: "0.1.0"
1356
1406
  link: "/"
1357
1407
  docs: "/docs/features/statistics-dashboard/"
@@ -1389,6 +1439,7 @@ features:
1389
1439
  title: "Obsidian Vault Integration"
1390
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"
1391
1441
  implemented: true
1442
+ prd: [TBD]
1392
1443
  version: "1.3.0"
1393
1444
  link: "/docs/obsidian/"
1394
1445
  docs: "/docs/obsidian/"
@@ -1427,6 +1478,7 @@ features:
1427
1478
  title: "Obsidian Graph Views (Full + Local)"
1428
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"
1429
1480
  implemented: true
1481
+ prd: [TBD]
1430
1482
  version: "1.28.0"
1431
1483
  link: "/docs/obsidian/graph/"
1432
1484
  docs: "/docs/obsidian/graph/"
@@ -1464,11 +1516,12 @@ features:
1464
1516
  title: "Bare-Minimum Remote-Theme Starter"
1465
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"
1466
1518
  implemented: true
1467
- version: "1.2.0"
1519
+ prd: [TBD]
1520
+ version: "1.32.0"
1468
1521
  link: "/"
1469
1522
  docs: "/docs/quickstart/bare-minimum/"
1470
1523
  tags: [setup, quickstart, remote-theme, github-pages]
1471
- date: 2026-02-25
1524
+ date: 2026-11-15
1472
1525
  provenance:
1473
1526
  introduced_in: "1.2.0"
1474
1527
  pr: null
@@ -1476,16 +1529,23 @@ features:
1476
1529
  issue: null
1477
1530
  tests:
1478
1531
  - "test/test_site_generation.sh"
1532
+ - "test/test_newsletter_gate.rb"
1533
+ - "test/visual/core/footer-newsletter.spec.js"
1479
1534
  references:
1480
1535
  includes:
1481
1536
  - "_includes/components/info-section.html"
1482
1537
  - "_includes/core/footer.html"
1483
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)"
1484
1543
 
1485
1544
  - id: ZER0-047
1486
1545
  title: "Site Configuration Detection & Smart 404"
1487
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"
1488
1547
  implemented: true
1548
+ prd: [TBD]
1489
1549
  version: "0.22.18"
1490
1550
  link: "/404.html"
1491
1551
  docs: "/docs/features/smart-404/"
@@ -1507,6 +1567,7 @@ features:
1507
1567
  title: "Config-Driven Frontmatter Validation"
1508
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"
1509
1569
  implemented: true
1570
+ prd: [TBD]
1510
1571
  version: "0.22.17"
1511
1572
  link: "/"
1512
1573
  docs: "/docs/development/frontmatter-validation/"
@@ -1528,6 +1589,7 @@ features:
1528
1589
  title: "Dynamic Collection-Based Navigation Fallback"
1529
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"
1530
1591
  implemented: true
1592
+ prd: [TBD]
1531
1593
  version: "0.22.15"
1532
1594
  link: "/"
1533
1595
  docs: "/docs/features/dynamic-navigation/"
@@ -1548,11 +1610,12 @@ features:
1548
1610
  title: "Admin Layout & Configuration Dashboards"
1549
1611
  description: "Admin-style layout and dashboard partials for surfacing site configuration, build info, and feature flags in a single place"
1550
1612
  implemented: true
1551
- version: "0.21.4"
1552
- link: "/admin/"
1613
+ prd: [TBD]
1614
+ version: "1.32.0"
1615
+ link: "/about/config/"
1553
1616
  docs: "/docs/features/admin-dashboard/"
1554
1617
  tags: [admin, dashboard, ui, configuration]
1555
- date: 2025-12-28
1618
+ date: 2026-11-15
1556
1619
  provenance:
1557
1620
  introduced_in: "0.21.4"
1558
1621
  pr: 57
@@ -1565,11 +1628,17 @@ features:
1565
1628
  includes:
1566
1629
  - "_includes/navigation/admin-nav.html"
1567
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"
1568
1636
 
1569
1637
  - id: ZER0-051
1570
1638
  title: "AGENTS.md Cross-Tool Agent Entry Point"
1571
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"
1572
1640
  implemented: true
1641
+ prd: ["Feature 7"]
1573
1642
  version: "0.22.16"
1574
1643
  link: "https://github.com/bamr87/zer0-mistakes/blob/main/AGENTS.md"
1575
1644
  docs: "/docs/development/agents/"
@@ -1590,6 +1659,7 @@ features:
1590
1659
  title: "Data-Driven Roadmap with Auto-Generated Diagram"
1591
1660
  description: "Roadmap page rendered from a YAML data source, with an auto-generated Mermaid diagram embedded in README.md"
1592
1661
  implemented: true
1662
+ prd: [TBD]
1593
1663
  version: "0.22.21"
1594
1664
  link: "/roadmap/"
1595
1665
  docs: "/roadmap/"
@@ -1611,6 +1681,7 @@ features:
1611
1681
  title: "Vendored Bootstrap & Icon Assets"
1612
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"
1613
1683
  implemented: true
1684
+ prd: [TBD]
1614
1685
  version: "0.21.3"
1615
1686
  link: "/"
1616
1687
  docs: "/docs/features/vendored-assets/"
@@ -1634,6 +1705,7 @@ features:
1634
1705
  title: "AIEO Structured Data, FAQ & Glossary"
1635
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"
1636
1707
  implemented: true
1708
+ prd: [TBD]
1637
1709
  version: "0.21.5"
1638
1710
  link: "/glossary/"
1639
1711
  docs: "/docs/seo/aieo/"
@@ -1659,6 +1731,7 @@ features:
1659
1731
  title: "ES6 Modular Navigation Architecture"
1660
1732
  description: "Navigation JavaScript refactored into ES6 modules with hover dropdowns, settings modal, and a navbar that degrades gracefully on slow connections"
1661
1733
  implemented: true
1734
+ prd: [TBD]
1662
1735
  version: "0.18.0"
1663
1736
  link: "/"
1664
1737
  docs: "/docs/features/navigation-architecture/"
@@ -1682,6 +1755,7 @@ features:
1682
1755
  title: "DevContainer Configuration"
1683
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"
1684
1757
  implemented: true
1758
+ prd: [TBD]
1685
1759
  version: "0.17.0"
1686
1760
  link: "/"
1687
1761
  docs: "/docs/development/devcontainer/"
@@ -1702,6 +1776,8 @@ features:
1702
1776
  title: "Local Docker Publishing Pipeline"
1703
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"
1704
1778
  implemented: false
1779
+ status: deprecated
1780
+ prd: ["Feature 10"]
1705
1781
  removed_in: "1.8.1"
1706
1782
  superseded_by: "ZER0-015"
1707
1783
  version: "0.21.1"
@@ -1724,6 +1800,7 @@ features:
1724
1800
  title: "Notes Collection & Notebook Layout"
1725
1801
  description: "Dedicated _notes collection alongside _notebooks, with shared standardized layouts for short-form knowledge capture distinct from blog posts"
1726
1802
  implemented: true
1803
+ prd: [TBD]
1727
1804
  version: "0.20.0"
1728
1805
  link: "/notes/"
1729
1806
  docs: "/notes/"
@@ -1746,6 +1823,7 @@ features:
1746
1823
  title: "Performance: Page-URL Cache for Obsidian Resolver"
1747
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"
1748
1825
  implemented: true
1826
+ prd: [TBD]
1749
1827
  version: "1.6.0"
1750
1828
  link: "/docs/obsidian/performance/"
1751
1829
  docs: "/docs/obsidian/performance/"
@@ -1766,6 +1844,7 @@ features:
1766
1844
  title: "AI Chat Assistant (Claude or Grok + GitHub)"
1767
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"
1768
1846
  implemented: true
1847
+ prd: [TBD]
1769
1848
  version: "1.30.0"
1770
1849
  link: "/docs/features/ai-chat-assistant/"
1771
1850
  docs: "/docs/features/ai-chat-assistant/"
@@ -1793,6 +1872,7 @@ features:
1793
1872
  title: "Author Profiles System"
1794
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"
1795
1874
  implemented: true
1875
+ prd: [TBD]
1796
1876
  version: "1.20.0"
1797
1877
  link: "/authors/"
1798
1878
  docs: "/authors/"
@@ -1818,6 +1898,7 @@ features:
1818
1898
  title: "News Homepage Layout"
1819
1899
  description: "Magazine-style news homepage layout with configurable section styles (magazine, grid, list) and full-width content sections"
1820
1900
  implemented: true
1901
+ prd: [TBD]
1821
1902
  version: "0.1.5"
1822
1903
  link: "/"
1823
1904
  docs: "/docs/customization/layouts/"
@@ -1837,6 +1918,7 @@ features:
1837
1918
  title: "Section Layout"
1838
1919
  description: "News section layout with a collapsible sub-category sidebar, section styles, and a featured hero card for organizing posts by section"
1839
1920
  implemented: true
1921
+ prd: [TBD]
1840
1922
  version: "0.20.3"
1841
1923
  link: "/"
1842
1924
  docs: "/docs/customization/layouts/"
@@ -1857,6 +1939,7 @@ features:
1857
1939
  title: "Article Layout & Post Types"
1858
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"
1859
1941
  implemented: true
1942
+ prd: [TBD]
1860
1943
  version: "0.20.3"
1861
1944
  link: "/"
1862
1945
  docs: "/docs/customization/layouts/"
@@ -1877,6 +1960,7 @@ features:
1877
1960
  title: "Theme Skins & Background Customizer"
1878
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"
1879
1962
  implemented: true
1963
+ prd: ["Feature 13"]
1880
1964
  version: "0.22.10"
1881
1965
  link: "/"
1882
1966
  docs: "/docs/features/color-modes/"
@@ -1906,6 +1990,7 @@ features:
1906
1990
  title: "Nanobar Progress Bar"
1907
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"
1908
1992
  implemented: true
1993
+ prd: [TBD]
1909
1994
  version: "0.22.20"
1910
1995
  link: "/"
1911
1996
  docs: "/docs/features/"
@@ -1930,6 +2015,7 @@ features:
1930
2015
  title: "Setup Wizard"
1931
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"
1932
2017
  implemented: true
2018
+ prd: [TBD]
1933
2019
  version: "1.30.0"
1934
2020
  link: "/setup/"
1935
2021
  docs: "/docs/features/site-builder/"
@@ -1954,6 +2040,7 @@ features:
1954
2040
  title: "Table CSV Copy"
1955
2041
  description: "One-click CSV copy control injected onto content tables, scoped to article/content wrappers (skips admin and sitemap tables)"
1956
2042
  implemented: true
2043
+ prd: [TBD]
1957
2044
  version: "1.8.0"
1958
2045
  link: "/"
1959
2046
  docs: "/docs/features/"
@@ -1974,6 +2061,7 @@ features:
1974
2061
  title: "Social Share Actions"
1975
2062
  description: "Helper that builds normalized social-share text and URLs (whitespace-collapsed, deduped, length-truncated) for sharing posts"
1976
2063
  implemented: true
2064
+ prd: [TBD]
1977
2065
  version: "1.14.0"
1978
2066
  link: "/"
1979
2067
  docs: "/docs/features/"
@@ -1994,6 +2082,7 @@ features:
1994
2082
  title: "Monthly Archives Page"
1995
2083
  description: "Date-grouped archive of all posts with anchor-linked month sections for chronological browsing"
1996
2084
  implemented: true
2085
+ prd: [TBD]
1997
2086
  version: "0.16.1"
1998
2087
  link: "/archives/"
1999
2088
  docs: "/archives/"
@@ -2013,6 +2102,7 @@ features:
2013
2102
  title: "Live Component Showcase"
2014
2103
  description: "Interactive gallery of Bootstrap 5.3 and theme components (alerts, buttons, cards, accordions, tabs, …) for visual reference and design QA"
2015
2104
  implemented: true
2105
+ prd: [TBD]
2016
2106
  version: "0.22.12"
2017
2107
  link: "/"
2018
2108
  docs: "/docs/customization/includes/"
@@ -2032,6 +2122,7 @@ features:
2032
2122
  title: "AI Content Review Workflow"
2033
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"
2034
2124
  implemented: true
2125
+ prd: [TBD]
2035
2126
  version: "1.18.0"
2036
2127
  link: "/"
2037
2128
  docs: "/docs/"
@@ -2054,6 +2145,7 @@ features:
2054
2145
  title: "Giscus Digest Workflow"
2055
2146
  description: "Scheduled read-only workflow that surfaces new Giscus (GitHub Discussions) comments to maintainers as a job-summary digest"
2056
2147
  implemented: true
2148
+ prd: [TBD]
2057
2149
  version: "1.22.0"
2058
2150
  link: "/"
2059
2151
  docs: "/docs/features/giscus-comments/"
@@ -2075,6 +2167,7 @@ features:
2075
2167
  title: "Visual Evidence Gate"
2076
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"
2077
2169
  implemented: true
2170
+ prd: [TBD]
2078
2171
  version: "1.20.2"
2079
2172
  link: "/"
2080
2173
  docs: "/docs/development/testing/"
@@ -2096,6 +2189,7 @@ features:
2096
2189
  title: "Autonomous Issue & CI Pipeline"
2097
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)"
2098
2191
  implemented: true
2192
+ prd: [TBD]
2099
2193
  version: "1.23.0"
2100
2194
  link: "/"
2101
2195
  docs: "/docs/development/ci-cd/"
@@ -2120,6 +2214,7 @@ features:
2120
2214
  title: "Secret Scanning Workflow"
2121
2215
  description: "CI workflow that scans pushes and pull requests for leaked secrets, complementing CodeQL static analysis"
2122
2216
  implemented: true
2217
+ prd: [TBD]
2123
2218
  version: "1.21.0"
2124
2219
  link: "/"
2125
2220
  docs: "/docs/development/security/"
@@ -2139,6 +2234,7 @@ features:
2139
2234
  title: "Unified Settings Panel"
2140
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"
2141
2236
  implemented: true
2237
+ prd: [TBD]
2142
2238
  version: "1.25.0"
2143
2239
  link: "/"
2144
2240
  docs: "/docs/customization/includes/"
@@ -2174,6 +2270,7 @@ features:
2174
2270
  title: "AI-Generated Multilingual Translations"
2175
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"
2176
2272
  implemented: true
2273
+ prd: [TBD]
2177
2274
  version: "1.27.0"
2178
2275
  link: "/"
2179
2276
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/systems/multilingual-translation.md"
@@ -2211,6 +2308,7 @@ features:
2211
2308
  title: "Config-Driven Favicon and Browser Identity"
2212
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"
2213
2310
  implemented: true
2311
+ prd: [TBD]
2214
2312
  version: "1.28.0"
2215
2313
  link: "/"
2216
2314
  docs: "/docs/features/favicon/"
@@ -2237,6 +2335,7 @@ features:
2237
2335
  title: "Books Collection — Children's Picture-Book Publishing"
2238
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"
2239
2337
  implemented: true
2338
+ prd: [TBD]
2240
2339
  version: "1.28.0"
2241
2340
  link: "/books/zer0-tales/"
2242
2341
  docs: "/docs/features/book-collection/"
@@ -2274,6 +2373,7 @@ features:
2274
2373
  title: "Claude Design System Round-Trip"
2275
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"
2276
2375
  implemented: true
2376
+ prd: [TBD]
2277
2377
  version: "1.29.0"
2278
2378
  link: "/"
2279
2379
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/ui/design-system.md"
@@ -2309,6 +2409,7 @@ features:
2309
2409
  title: "Live Design System Pages"
2310
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"
2311
2411
  implemented: true
2412
+ prd: [TBD]
2312
2413
  version: "1.29.0"
2313
2414
  link: "/design/"
2314
2415
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/ui/design-system.md"
@@ -2343,6 +2444,7 @@ features:
2343
2444
  title: "Page View Counter"
2344
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"
2345
2446
  implemented: true
2447
+ prd: [TBD]
2346
2448
  version: "1.29.0"
2347
2449
  link: "/"
2348
2450
  docs: "https://github.com/bamr87/zer0-mistakes/blob/main/docs/features/page-views.md"
@@ -2381,6 +2483,7 @@ features:
2381
2483
  title: "Cookbook & Recipes Collection"
2382
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"
2383
2485
  implemented: true
2486
+ prd: [TBD]
2384
2487
  version: "1.29.0"
2385
2488
  link: "/recipes/"
2386
2489
  docs: "/docs/features/cookbook-collection/"
@@ -2430,6 +2533,7 @@ features:
2430
2533
  title: "Visual Evidence Autogen"
2431
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"
2432
2535
  implemented: true
2536
+ prd: [TBD]
2433
2537
  version: "1.30.0"
2434
2538
  link: "/"
2435
2539
  docs: "/docs/development/testing/"
@@ -2462,6 +2566,7 @@ features:
2462
2566
  title: "Claude-Guided Site Builder"
2463
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"
2464
2568
  implemented: true
2569
+ prd: [TBD]
2465
2570
  version: "1.30.0"
2466
2571
  link: "/setup/"
2467
2572
  docs: "/docs/features/site-builder/"
@@ -2506,6 +2611,7 @@ features:
2506
2611
  title: "Bring-Your-Own AI Provider (Claude or Grok) and Open Site Builder Sessions"
2507
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"
2508
2613
  implemented: true
2614
+ prd: [TBD]
2509
2615
  version: "1.30.0"
2510
2616
  link: "/setup/"
2511
2617
  docs: "/docs/features/site-builder/"
@@ -2546,3 +2652,46 @@ features:
2546
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"
2547
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"
2548
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"