jekyll-theme-zer0 1.24.0 → 1.26.0

data/assets/js/skin-editor.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-065
 /**
  * skin-editor.js — Colorffy-inspired skin editor for zer0-mistakes theme
  *

data/assets/js/table-copy.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-068
 /**
  * Content table CSV copy — injects a toolbar button on markdown/HTML tables
  * in main reading areas. Scoped to content wrappers; skips admin and sitemap.

data/assets/js/theme-customizer.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-065
 /**
  * theme-customizer.js
  * Powers the Theme Customizer admin page.

data/scripts/analyze-commits.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Features: ZER0-015, ZER0-028
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/utils/analyze-commits

data/scripts/bin/giscus-discussions

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Features: ZER0-035, ZER0-073
 
 # giscus-discussions — read, draft, and post the GitHub Discussions that back
 # the site's Giscus comment threads. This is the engine the Claude Code

data/scripts/bin/install

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Feature: ZER0-003
 # scripts/bin/install — zer0-mistakes installer entrypoint (v2)
 #
 # Routes to scripts/install/cli.sh (new spec-driven architecture).

data/scripts/bin/validate

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Feature: ZER0-048
 
 # Canonical preflight validator for zer0-mistakes.
 # Usage: ./scripts/bin/validate [options]

data/scripts/build

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Feature: ZER0-028
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/bin/build

data/scripts/content-review.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# Feature: ZER0-072
 # frozen_string_literal: true
 
 # =============================================================================

data/scripts/convert-notebooks.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Features: ZER0-012, ZER0-028
 #
 # Script Name: convert-notebooks.sh
 # Description: Converts Jupyter notebooks (.ipynb) to Jekyll-compatible Markdown
@@ -339,7 +340,7 @@ clean_converted() {
                 rm -f "$md_file"
                 info "Removed: $md_file"
             fi
-            ((count++))
+            count=$((count + 1))
         fi
     done < <(find "$OUTPUT_DIR" -name "*.md" -print0 2>/dev/null)
     
@@ -364,7 +365,7 @@ list_notebooks() {
     else
         while IFS= read -r -d '' notebook_file; do
             echo "$notebook_file"
-            ((count++))
+            count=$((count + 1))
         done < <(find "$NOTEBOOKS_DIR" -name "*.ipynb" -print0 2>/dev/null)
     fi
     
@@ -400,7 +401,7 @@ main() {
         local count=0
         while IFS= read -r -d '' notebook_file; do
             convert_notebook "$notebook_file"
-            ((count++))
+            count=$((count + 1))
         done < <(find "$NOTEBOOKS_DIR" -name "*.ipynb" -print0 2>/dev/null)
         
         if [[ $count -eq 0 ]]; then

data/scripts/fix-markdown-format.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Feature: ZER0-028
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/utils/fix-markdown

data/scripts/generate-preview-images.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Features: ZER0-004, ZER0-028
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/features/generate-preview-images

data/scripts/generate-roadmap.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Feature: ZER0-052
 # =============================================================================
 # generate-roadmap.sh
 # =============================================================================

data/scripts/install-preview-generator.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Feature: ZER0-004
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/features/install-preview-generator

data/scripts/release

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Features: ZER0-015, ZER0-028
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/bin/release

data/scripts/requirements.txt

@@ -0,0 +1,11 @@
+# Python toolchain for repository automation scripts.
+#
+# Currently the notebook-conversion pipeline: scripts/convert-notebooks.sh and
+# .github/workflows/convert-notebooks.yml use nbconvert to render
+# pages/_notebooks/*.ipynb into Jekyll-compatible Markdown.
+#
+# This file also acts as the pip cache key for actions/setup-python in that
+# workflow (see `cache-dependency-path`). Keep it in sync with the toolchain the
+# scripts import; a missing file here makes `cache: pip` hard-fail the run.
+jupyter
+nbconvert

data/scripts/setup.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Features: ZER0-002, ZER0-028
 
 # ============================================================================
 # WRAPPER: This script forwards to scripts/utils/setup

data/scripts/tag-features

@@ -0,0 +1,136 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ---------------------------------------------------------------------------
+# tag-features — reverse-traceability enforcement for the feature registry.
+#
+# Every source file a feature lists under `references:` carries a top-of-file
+# `Feature: ZER0-NNN` comment, so the link runs both ways (registry -> code and
+# code -> registry). This tool is the single source of truth for that rule:
+#
+#   ruby scripts/tag-features            # --check (default): exit 1 + list any
+#                                        #   referenced source file missing its tag
+#   ruby scripts/tag-features --write    # insert the missing tags (idempotent,
+#                                        #   line-ending-preserving)
+#
+# The `features` test suite runs `--check`, so a new feature that forgets to tag
+# its files fails CI. Governance: .github/instructions/features.instructions.md.
+#
+# Scope (mirrors what a feature's references implement, and only what can carry a
+# comment): .rb .js .mjs .scss .sh .html .yml, plus Dockerfile/Makefile and the
+# scripts/{bin/*,build,release} wrappers. Excluded by design: markdown docs,
+# JSON (no comment syntax), vendored/minified third-party libs, directory refs,
+# and _config.yml (it has an exact-copy admin mirror enforced elsewhere).
+#
+# Portable across Ruby 2.6 (macOS system) and 3.x (CI/Docker).
+# ---------------------------------------------------------------------------
+
+require 'date'
+require 'yaml'
+
+MIRROR = '_data/features.yml'
+MODE = ARGV.include?('--write') ? :write : :check
+
+CODE_EXT = %w[.rb .js .mjs .scss .sh .html .yml].freeze
+SLASH_EXT = %w[.js .mjs .scss].freeze
+NOEXT_FILES = %w[docker/Dockerfile Makefile scripts/release scripts/build].freeze
+EXCLUDE_FILES = %w[_config.yml assets/js/particles.js assets/js/halfmoon.js].freeze
+
+def load_yaml(path)
+  YAML.load_file(path, permitted_classes: [Date, Time], aliases: true)
+rescue ArgumentError
+  YAML.load_file(path)
+end
+
+def ref_paths(refs)
+  return [] unless refs.is_a?(Hash)
+
+  refs.values.flat_map { |v| v.is_a?(Array) ? v : [v] }.select { |v| v.is_a?(String) }
+end
+
+def vendored?(path)
+  path.include?('/vendor/') || path.end_with?('.min.js') || EXCLUDE_FILES.include?(path)
+end
+
+# Which referenced paths must carry a tag.
+def taggable?(path)
+  return false if path.end_with?('/') || vendored?(path)
+
+  ext = File.extname(path)
+  return false if %w[.md .json].include?(ext)
+
+  CODE_EXT.include?(ext) || NOEXT_FILES.include?(path) || (path.start_with?('scripts/bin/') && ext.empty?)
+end
+
+def tag_text(ids)
+  (ids.length == 1 ? 'Feature: ' : 'Features: ') + ids.join(', ')
+end
+
+def already_tagged?(raw, ids)
+  head = raw[0, 500].to_s
+  ids.any? { |id| head.include?(id) }
+end
+
+# Insert the tag with type-aware placement, preserving the file's line endings.
+def insert_tag(path, ids)
+  raw = File.binread(path).force_encoding('UTF-8')
+  return :skipped if already_tagged?(raw, ids)
+
+  nl = raw.include?("\r\n") ? "\r\n" : "\n"
+  ext = File.extname(path)
+  tag = tag_text(ids)
+  lines = raw.each_line.to_a
+
+  if ext == '.html' && raw.lstrip.start_with?('---')
+    idx = lines.index { |l| l.strip == '---' } || 0
+    lines.insert(idx + 1, "# #{tag}#{nl}")            # invisible YAML front-matter comment
+  elsif ext == '.html'
+    lines.unshift("{% comment %} #{tag} {% endcomment %}#{nl}")  # stripped at build
+  else
+    prefix = SLASH_EXT.include?(ext) ? '//' : '#'
+    line = "#{prefix} #{tag}#{nl}"
+    first = lines[0].to_s
+    if first.start_with?('#!') || first.lstrip.start_with?('# syntax=') || first.lstrip.start_with?('# escape=')
+      lines.insert(1, line)                            # keep shebang / Dockerfile directive on line 1
+    else
+      lines.unshift(line)
+    end
+  end
+
+  File.binwrite(path, lines.join)
+  :written
+end
+
+data = load_yaml(MIRROR)
+feats = data && data['features']
+abort 'tag-features: could not read features registry' unless feats.is_a?(Array)
+
+by_file = Hash.new { |h, k| h[k] = [] }
+feats.each do |f|
+  next if f['implemented'] == false   # removed features keep (absent) refs; nothing to tag
+
+  ref_paths(f['references']).each do |p|
+    by_file[p] << f['id'] if taggable?(p) && File.exist?(p)
+  end
+end
+
+if MODE == :write
+  written = 0
+  by_file.each { |path, ids| written += 1 if insert_tag(path, ids.uniq.sort) == :written }
+  puts "tag-features: wrote #{written} tag(s); #{by_file.size - written} already current"
+  exit 0
+end
+
+missing = by_file.reject do |path, ids|
+  already_tagged?(File.binread(path).force_encoding('UTF-8'), ids.uniq.sort)
+end
+
+if missing.empty?
+  puts "tag-features: all #{by_file.size} referenced source files carry their Feature tag"
+  exit 0
+end
+
+warn "tag-features: #{missing.length} referenced source file(s) missing a `Feature: ZER0-NNN` comment:"
+missing.each { |path, ids| warn "  - #{path}  (needs #{ids.uniq.sort.join(', ')})" }
+warn 'Fix: run `ruby scripts/tag-features --write` (or add the comment by hand).'
+exit 1

data/scripts/validate-features.rb

@@ -81,6 +81,13 @@ feats.each_with_index do |f, i|
     die "#{id}: required field `#{key}` is missing/empty" if val.nil? || (val.respond_to?(:empty?) && val.empty?)
   end
 
+  # Title/description are rendered UNwrapped into HTML on /features/; a raw
+  # angle bracket (e.g. "/authors/<key>/") becomes a stray tag that swallows
+  # every following card. Keep them plain prose.
+  %w[title description].each do |key|
+    die "#{id}: `#{key}` must not contain raw `<`/`>` (breaks HTML on /features/ — use :key or &lt;)" if f[key].to_s =~ /[<>]/
+  end
+
   die "#{id}: id must match ZER0-NNN" unless f['id'] =~ /\AZER0-\d{3}\z/
   die "#{id}: duplicate id" if seen[f['id']]
   seen[f['id']] = true

data/scripts/vendor-install.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Feature: ZER0-053
 
 # Vendor asset installer for zer0-mistakes Jekyll theme
 # Downloads third-party JS/CSS libraries defined in vendor-manifest.json

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-01 00:00:00.000000000 Z
+date: 2026-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -83,6 +83,7 @@ files:
 - _data/backlog.yml
 - _data/content_statistics.yml
 - _data/features.yml
+- _data/feedback_types.yml
 - _data/generate_statistics.rb
 - _data/generate_statistics.sh
 - _data/github-actions-example.yml
@@ -98,7 +99,6 @@ files:
 - _data/navigation/quickstart.yml
 - _data/posts_organization.yml
 - _data/prerequisites.yml
-- _data/prompts.yml
 - _data/roadmap.yml
 - _data/roadmap_plan.yml
 - _data/routing.yml
@@ -114,6 +114,7 @@ files:
 - _includes/analytics/google-tag-manager-head.html
 - _includes/analytics/posthog.html
 - _includes/components/README.md
+- _includes/components/admin-links.html
 - _includes/components/admin-tabs.html
 - _includes/components/ai-chat.html
 - _includes/components/analytics-dashboard.html
@@ -143,6 +144,7 @@ files:
 - _includes/components/nav-editor.html
 - _includes/components/nav-export.html
 - _includes/components/nav-overview.html
+- _includes/components/page-feedback.html
 - _includes/components/post-card.html
 - _includes/components/post-type-badge.html
 - _includes/components/powered-by.html
@@ -173,6 +175,7 @@ files:
 - _includes/content/transclude.html
 - _includes/core/branding.html
 - _includes/core/color-mode-init.html
+- _includes/core/console-capture.html
 - _includes/core/footer-fabs.html
 - _includes/core/footer.html
 - _includes/core/head.html
@@ -191,8 +194,10 @@ files:
 - _includes/navigation/navbar.html
 - _includes/navigation/section-sidebar.html
 - _includes/navigation/sidebar-categories.html
+- _includes/navigation/sidebar-config.html
 - _includes/navigation/sidebar-folders.html
 - _includes/navigation/sidebar-left.html
+- _includes/navigation/sidebar-nav.html
 - _includes/navigation/sidebar-right.html
 - _includes/navigation/toc-fab.html
 - _includes/navigation/unified-drawer.html
@@ -227,7 +232,6 @@ files:
 - _layouts/stats.html
 - _layouts/tag.html
 - _layouts/welcome.html
-- _plugins/admin_page_urls.rb
 - _plugins/author_pages_generator.rb
 - _plugins/content_statistics_generator.rb
 - _plugins/obsidian_links.rb
@@ -243,6 +247,7 @@ files:
 - _sass/components/_footer.scss
 - _sass/components/_notes-index.scss
 - _sass/components/_notes.scss
+- _sass/components/_page-feedback.scss
 - _sass/components/_post-navigation.scss
 - _sass/components/_search-modal.scss
 - _sass/components/_skeleton.scss
@@ -282,6 +287,7 @@ files:
 - _sass/tokens/_spacing.scss
 - _sass/tokens/_typography.scss
 - _sass/utilities/_focus.scss
+- _sass/utilities/_layout.scss
 - _sass/utilities/_motion.scss
 - assets/css/custom.css
 - assets/css/main.scss
@@ -322,6 +328,7 @@ files:
 - assets/js/obsidian-graph.js
 - assets/js/obsidian-local-graph.js
 - assets/js/obsidian-wiki-links.js
+- assets/js/page-feedback.js
 - assets/js/palette-generator.js
 - assets/js/particles-source.js
 - assets/js/particles.js
@@ -498,11 +505,13 @@ files:
 - scripts/platform/setup-wsl.sh
 - scripts/post-template-setup.sh
 - scripts/release
+- scripts/requirements.txt
 - scripts/setup.sh
 - scripts/sync-backlog.rb
 - scripts/sync-backlog.sh
 - scripts/sync-plan.rb
 - scripts/sync-plan.sh
+- scripts/tag-features
 - scripts/test-auto-version.sh
 - scripts/test-mermaid.sh
 - scripts/test-notebook-conversion.sh