jekyll-theme-zer0 1.19.1 → 1.21.0

data/scripts/test/lib/test_content_review.sh

@@ -0,0 +1,205 @@
+#!/bin/bash
+
+# Unit tests for the scripts/content-review.rb scoring engine (issue #166).
+#
+# content-review.rb is the deterministic (no-API) tier of the AI content
+# reviewer. It had zero direct unit coverage — it only ran as a side effect of
+# the ai-content-review workflow on PRs touching pages/**. A scoring regression
+# (code-fence false-positive) shipped in v1.18 and was fixed in v1.18.1 (PR
+# #155), which is exactly the class of bug a unit test catches.
+#
+# These tests drive the real production config + schema
+# (.github/config/content_review.yml, frontmatter_schema.yml) against synthetic
+# Markdown fixtures, so they exercise the actual thresholds rather than a copy
+# that can drift. Fixtures live under a temp `pages/_docs/**` tree so the
+# production scope/path-pattern globs match without polluting the content dirs.
+#
+# Run under LC_ALL=C LANG=C for locale-independence parity with the T-015 guard.
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+CR_SCRIPT="$REPO_ROOT/scripts/content-review.rb"
+CR_CONFIG="$REPO_ROOT/.github/config/content_review.yml"
+CR_SCHEMA="$REPO_ROOT/.github/config/frontmatter_schema.yml"
+
+echo "Testing content-review.rb scoring engine..."
+
+# --- Fixture workspace -------------------------------------------------------
+CR_WORK="$(mktemp -d)"
+mkdir -p "$CR_WORK/pages/_docs/test"
+
+# A well-formed docs page: complete front matter, in-range title/description,
+# a keyword list, an H2, a language-tagged code fence, and an image with alt
+# text. Should score high (no errors; at most cosmetic info items).
+cat > "$CR_WORK/pages/_docs/test/good.md" <<'EOF'
+---
+title: Getting Started with the Zer0 Mistakes Theme
+description: A friendly, complete walkthrough that takes you from an empty repository all the way to a deployed Zer0 Mistakes site in roughly ten short minutes.
+lastmod: 2026-06-23T00:00:00.000Z
+layout: default
+categories:
+  - docs
+tags:
+  - jekyll
+  - setup
+keywords:
+  - jekyll
+  - theme
+  - setup
+---
+
+## Overview
+
+This guide walks you through installing the theme, configuring your site, and
+publishing it to GitHub Pages. Each step is short and copy-pasteable so you can
+get a working site quickly without guessing at the details. We cover the local
+development loop first, then the production deployment, and finally a few
+verification checks so you know everything is wired up correctly before you
+share the link with anyone else who might be reviewing your brand new site.
+
+## Install
+
+Run the bundled installer and start the development server with these commands:
+
+```bash
+bundle install
+bundle exec jekyll serve
+```
+
+![Screenshot of the running theme](/assets/images/example.png)
+EOF
+
+# Same page with the required `description` removed: one frontmatter error
+# (required field) plus one SEO warning (no meta description). Must score
+# strictly lower than the well-formed page.
+cat > "$CR_WORK/pages/_docs/test/missing-desc.md" <<'EOF'
+---
+title: Getting Started with the Zer0 Mistakes Theme
+lastmod: 2026-06-23T00:00:00.000Z
+layout: default
+categories:
+  - docs
+tags:
+  - jekyll
+  - setup
+keywords:
+  - jekyll
+  - theme
+  - setup
+---
+
+## Overview
+
+This guide walks you through installing the theme, configuring your site, and
+publishing it to GitHub Pages. Each step is short and copy-pasteable so you can
+get a working site quickly without guessing at the details. We cover the local
+development loop first, then the production deployment, and finally a few
+verification checks so you know everything is wired up correctly before you
+share the link with anyone else.
+EOF
+
+# A page whose only code fence is properly language-tagged. The closing bare
+# ``` must NOT be flagged as a fence without a language (the v1.18.1 regression).
+cat > "$CR_WORK/pages/_docs/test/codefence.md" <<'EOF'
+---
+title: Configuring the Zer0 Mistakes Theme Options
+description: A focused reference covering the handful of configuration options you will set most often when tailoring the Zer0 Mistakes theme to your own project.
+lastmod: 2026-06-23T00:00:00.000Z
+layout: default
+categories:
+  - docs
+tags:
+  - jekyll
+  - config
+keywords:
+  - jekyll
+  - config
+  - options
+---
+
+## Configuration
+
+Set the options you need in your config file, then restart the server so the
+changes take effect. The example below shows the most common starting point for
+a new site and is safe to copy verbatim into your own configuration before you
+begin customizing anything else about the project.
+
+```yaml
+title: My Site
+description: A site built with the theme
+```
+EOF
+
+# A clearly failing page: missing description, layout, categories, and tags
+# (four required-field errors) — well below the fail threshold.
+cat > "$CR_WORK/pages/_docs/test/failing.md" <<'EOF'
+---
+title: Bad
+lastmod: 2026-06-23T00:00:00.000Z
+---
+
+Too short.
+EOF
+
+# --- Helpers -----------------------------------------------------------------
+# Run the reviewer against one fixture (path relative to CR_WORK), writing JSON.
+# Echoes nothing; returns the script's exit code.
+cr_run() { # $1 = relative md path, $2 = json out path, $3..= extra args
+  local rel="$1" out="$2"; shift 2
+  ( cd "$CR_WORK" && LC_ALL=C LANG=C ruby "$CR_SCRIPT" \
+      --files "$rel" --config "$CR_CONFIG" --schema "$CR_SCHEMA" \
+      --json "$out" --quiet "$@" >/dev/null 2>&1 )
+}
+
+cr_score() { # $1 = json path -> prints first file's score
+  ruby -E UTF-8 -rjson -e 'puts JSON.parse(File.read(ARGV[0]))["files"][0]["score"]' "$1"
+}
+
+cr_collection() { # $1 = json path -> prints detected collection
+  ruby -E UTF-8 -rjson -e 'puts JSON.parse(File.read(ARGV[0]))["files"][0]["collection"]' "$1"
+}
+
+cr_has_message() { # $1 = json path, $2 = substring -> exit 0 if any issue contains it
+  ruby -E UTF-8 -rjson -e 'd=JSON.parse(File.read(ARGV[0]))["files"][0]; exit(d["issues"].any?{|i| i["message"].include?(ARGV[1])} ? 0 : 1)' "$1" "$2"
+}
+
+# --- Run + assert ------------------------------------------------------------
+cr_run "pages/_docs/test/good.md"        "$CR_WORK/good.json"
+cr_run "pages/_docs/test/missing-desc.md" "$CR_WORK/missing.json"
+cr_run "pages/_docs/test/codefence.md"   "$CR_WORK/codefence.json"
+
+GOOD_SCORE="$(cr_score "$CR_WORK/good.json")"
+MISSING_SCORE="$(cr_score "$CR_WORK/missing.json")"
+
+assert_equals "docs" "$(cr_collection "$CR_WORK/good.json")" \
+    "fixture under pages/_docs/** is detected as the 'docs' collection"
+
+assert_true "[ '${GOOD_SCORE:-0}' -ge 80 ]" \
+    "a well-formed docs page scores >= 80 (got ${GOOD_SCORE})"
+
+assert_true "[ '${MISSING_SCORE:-100}' -lt '${GOOD_SCORE:-0}' ]" \
+    "removing the required description lowers the score (${MISSING_SCORE} < ${GOOD_SCORE})"
+
+assert_true "cr_has_message '$CR_WORK/missing.json' 'description'" \
+    "the missing-description page reports a description issue"
+
+assert_false "cr_has_message '$CR_WORK/codefence.json' 'Code fence without a language'" \
+    "a closing bare \`\`\` after a tagged fence is not flagged (v1.18.1 regression guard)"
+
+# --strict exit behaviour: a failing page exits 0 in warn mode, non-zero strict.
+cr_run "pages/_docs/test/failing.md" "$CR_WORK/failing.json"
+FAILING_SCORE="$(cr_score "$CR_WORK/failing.json")"
+assert_true "[ '${FAILING_SCORE:-100}' -lt 70 ]" \
+    "the failing fixture scores below the 70 fail threshold (got ${FAILING_SCORE})"
+
+cr_run "pages/_docs/test/failing.md" "$CR_WORK/failing-warn.json"
+assert_equals "0" "$?" \
+    "without --strict, a failing page still exits 0 (advisory mode)"
+
+cr_run "pages/_docs/test/failing.md" "$CR_WORK/failing-strict.json" --strict
+assert_equals "1" "$?" \
+    "with --strict, a failing page exits non-zero (1)"
+
+# --- Cleanup -----------------------------------------------------------------
+rm -rf "$CR_WORK"
+
+echo -e "\n${GREEN}content-review.rb scoring tests complete${NC}"

data/scripts/test/lib/test_pixelate_images.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+
+# Unit tests for scripts/features/pixelate_images.py (preview-image pixelator).
+#
+# These drive the dependency-free Python engine as a subprocess and assert on
+# its behaviour: the internal self-test, a real PNG round-trip that shrinks the
+# file, dry-run leaving files untouched, and graceful handling of non-PNG input.
+#
+# Sourced by scripts/test/lib/run_tests.sh (uses its exported assert helpers),
+# but also runnable directly for local iteration.
+
+TEST_SELF_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$TEST_SELF_DIR/../../.." && pwd)"
+ENGINE="$REPO_ROOT/scripts/features/pixelate_images.py"
+
+# Fallback helpers so the file also runs standalone (when not sourced by the
+# library runner that exports these).
+if ! declare -F assert_true >/dev/null 2>&1; then
+    RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
+    TESTS_RUN=0; TESTS_PASSED=0; TESTS_FAILED=0; declare -a FAILED_TESTS=()
+    assert_true() { ((TESTS_RUN++)); if eval "$1"; then ((TESTS_PASSED++)); echo -e "${GREEN}✓${NC} $2"; else ((TESTS_FAILED++)); echo -e "${RED}✗${NC} $2"; FAILED_TESTS+=("$2"); fi; }
+    assert_equals() { ((TESTS_RUN++)); if [[ "$1" == "$2" ]]; then ((TESTS_PASSED++)); echo -e "${GREEN}✓${NC} $3"; else ((TESTS_FAILED++)); echo -e "${RED}✗${NC} $3 (expected '$1' got '$2')"; FAILED_TESTS+=("$3"); fi; }
+    print_suite_header() { echo -e "\n${BLUE}=== $1 ===${NC}"; }
+    STANDALONE=true
+fi
+
+set +e
+
+print_suite_header "pixelate_images.py"
+
+if ! command -v python3 >/dev/null 2>&1; then
+    echo -e "${YELLOW}⚠ python3 not available — skipping pixelate_images tests${NC}"
+else
+    # ---- Test: internal self-test ----------------------------------------
+    if python3 "$ENGINE" --selftest >/dev/null 2>&1; then
+        assert_true "true" "engine --selftest passes"
+    else
+        assert_true "false" "engine --selftest passes"
+    fi
+
+    # ---- Set up a temp workspace with a synthetic gradient PNG -----------
+    PX_TMP="$(mktemp -d)"
+    trap '[[ -n "${PX_TMP:-}" ]] && rm -rf "$PX_TMP"' EXIT
+
+    # Build the input PNG independently of the engine's encoder so the
+    # round-trip genuinely exercises decode + re-encode.
+    python3 - "$PX_TMP/in.png" <<'PY'
+import sys, struct, zlib
+path = sys.argv[1]
+w = h = 256
+body = bytearray()
+for y in range(h):
+    body.append(0)  # filter: none
+    for x in range(w):
+        body += bytes(((x + y) % 256, (x * 2) % 256, (y * 2) % 256))
+def chunk(t, d):
+    return struct.pack(">I", len(d)) + t + d + struct.pack(">I", zlib.crc32(t + d) & 0xffffffff)
+png = (b"\x89PNG\r\n\x1a\n"
+       + chunk(b"IHDR", struct.pack(">IIBBBBB", w, h, 8, 2, 0, 0, 0))
+       + chunk(b"IDAT", zlib.compress(bytes(body), 9))
+       + chunk(b"IEND", b""))
+open(path, "wb").write(png)
+PY
+    assert_true "[[ -s '$PX_TMP/in.png' ]]" "synthetic input PNG created"
+    ORIG_SIZE=$(wc -c < "$PX_TMP/in.png" | tr -d ' ')
+
+    # ---- Test: dry-run does not modify the input -------------------------
+    BEFORE=$(wc -c < "$PX_TMP/in.png" | tr -d ' ')
+    python3 "$ENGINE" --dry-run "$PX_TMP/in.png" >/dev/null 2>&1
+    AFTER=$(wc -c < "$PX_TMP/in.png" | tr -d ' ')
+    assert_equals "$BEFORE" "$AFTER" "dry-run leaves the file unchanged"
+
+    # ---- Test: real run writes a smaller, valid indexed PNG --------------
+    python3 "$ENGINE" --colors 64 --block 4 --output-dir "$PX_TMP/out" "$PX_TMP/in.png" >/dev/null 2>&1
+    OUT="$PX_TMP/out/in.png"
+    assert_true "[[ -s '$OUT' ]]" "optimized output written"
+    NEW_SIZE=$(wc -c < "$OUT" 2>/dev/null | tr -d ' ')
+    assert_true "[[ '${NEW_SIZE:-0}' -lt '$ORIG_SIZE' ]]" "output is smaller than original ($ORIG_SIZE -> ${NEW_SIZE:-0} bytes)"
+
+    # Output must be a valid PNG-8 (colour type 3) that decodes back.
+    if python3 - "$ENGINE" "$OUT" <<'PY'
+import sys, importlib.util
+spec = importlib.util.spec_from_file_location("pixelate_images", sys.argv[1])
+P = importlib.util.module_from_spec(spec); spec.loader.exec_module(P)
+img = P.decode_png(open(sys.argv[2], "rb").read())
+assert img.width == 64 and img.height == 64, (img.width, img.height)
+PY
+    then
+        assert_true "true" "output decodes back to expected 64x64 dimensions"
+    else
+        assert_true "false" "output decodes back to expected 64x64 dimensions"
+    fi
+
+    # ---- Test: non-PNG input is skipped gracefully (no crash) ------------
+    printf 'not a png at all' > "$PX_TMP/fake.png"
+    python3 "$ENGINE" --dry-run "$PX_TMP/fake.png" >/dev/null 2>&1
+    assert_equals "0" "$?" "non-PNG input is handled gracefully (exit 0)"
+
+    rm -rf "$PX_TMP"; PX_TMP=""
+fi
+
+# When run standalone, print a summary and exit with the right code.
+if [[ "${STANDALONE:-false}" == "true" ]]; then
+    echo ""
+    echo -e "Total: $TESTS_RUN  ${GREEN}Passed: $TESTS_PASSED${NC}  ${RED}Failed: $TESTS_FAILED${NC}"
+    [[ $TESTS_FAILED -eq 0 ]]
+    exit $?
+fi

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.19.1
+  version: 1.21.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-16 00:00:00.000000000 Z
+date: 2026-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -86,15 +86,12 @@ files:
 - _data/generate_statistics.sh
 - _data/github-actions-example.yml
 - _data/glossary.yml
-- _data/hub.yml
-- _data/hub_index.yml
 - _data/landing.yml
 - _data/navigation/README.md
 - _data/navigation/about.yml
 - _data/navigation/admin.yml
 - _data/navigation/docs.yml
 - _data/navigation/home.yml
-- _data/navigation/hub.yml
 - _data/navigation/main.yml
 - _data/navigation/posts.yml
 - _data/navigation/quickstart.yml
@@ -102,6 +99,8 @@ files:
 - _data/prerequisites.yml
 - _data/prompts.yml
 - _data/roadmap.yml
+- _data/roadmap_plan.yml
+- _data/routing.yml
 - _data/statistics_config.yml
 - _data/theme-manifest.yml
 - _data/theme_backgrounds.yml
@@ -117,6 +116,8 @@ files:
 - _includes/components/admin-tabs.html
 - _includes/components/ai-chat.html
 - _includes/components/analytics-dashboard.html
+- _includes/components/author-avatar-url.html
+- _includes/components/author-bio.html
 - _includes/components/author-card.html
 - _includes/components/author-eeat.html
 - _includes/components/background-customizer.html
@@ -170,6 +171,7 @@ files:
 - _includes/content/toc.html
 - _includes/content/transclude.html
 - _includes/core/branding.html
+- _includes/core/footer-fabs.html
 - _includes/core/footer.html
 - _includes/core/head.html
 - _includes/core/header.html
@@ -205,6 +207,8 @@ files:
 - _layouts/README.md
 - _layouts/admin.html
 - _layouts/article.html
+- _layouts/author.html
+- _layouts/authors.html
 - _layouts/collection.html
 - _layouts/default.html
 - _layouts/home.html
@@ -222,32 +226,41 @@ files:
 - _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
 - _plugins/preview_image_generator.rb
 - _plugins/sanitize_config_filter.rb
 - _plugins/search_and_sitemap_generator.rb
 - _plugins/theme_version.rb
+- _sass/components/_author.scss
 - _sass/components/_back-to-top.scss
 - _sass/components/_callout.scss
 - _sass/components/_content-tables.scss
 - _sass/components/_cookie-banner.scss
 - _sass/components/_footer.scss
+- _sass/components/_notes-index.scss
 - _sass/components/_notes.scss
 - _sass/components/_post-navigation.scss
+- _sass/components/_search-modal.scss
 - _sass/components/_skeleton.scss
 - _sass/components/_theme-preview.scss
+- _sass/components/_ui-enhancements.scss
+- _sass/core/_docs-code-examples.scss
 - _sass/core/_docs-layout.scss
 - _sass/core/_nav-tree.scss
 - _sass/core/_navbar.scss
 - _sass/core/_obsidian.scss
 - _sass/core/_offcanvas-panels.scss
 - _sass/core/_sidebar-categories.scss
+- _sass/core/_sidebar-extras.scss
 - _sass/core/_syntax.scss
 - _sass/core/_theme.scss
+- _sass/core/_toc.scss
 - _sass/core/_variables.scss
 - _sass/core/code-copy.scss
 - _sass/custom.scss
+- _sass/layouts/_global-chrome.scss
 - _sass/layouts/_landing.scss
 - _sass/layouts/_navbar-extras.scss
 - _sass/layouts/_section.scss
@@ -278,6 +291,7 @@ files:
 - assets/data/notebooks/weather_data.csv
 - assets/data/wiki-index.json
 - assets/js/ai-chat.js
+- assets/js/author-profile.js
 - assets/js/auto-hide-nav.js
 - assets/js/back-to-top.js
 - assets/js/background-customizer.js
@@ -327,18 +341,9 @@ files:
 - assets/vendor/bootstrap-icons/font/fonts/bootstrap-icons.woff2
 - assets/vendor/bootstrap/css/bootstrap.min.css
 - assets/vendor/bootstrap/js/bootstrap.bundle.min.js
-- assets/vendor/font-awesome/css/all.min.css
-- assets/vendor/font-awesome/webfonts/fa-brands-400.ttf
-- assets/vendor/font-awesome/webfonts/fa-brands-400.woff2
-- assets/vendor/font-awesome/webfonts/fa-regular-400.ttf
-- assets/vendor/font-awesome/webfonts/fa-regular-400.woff2
-- assets/vendor/font-awesome/webfonts/fa-solid-900.ttf
-- assets/vendor/font-awesome/webfonts/fa-solid-900.woff2
-- assets/vendor/font-awesome/webfonts/fa-v4compatibility.ttf
-- assets/vendor/font-awesome/webfonts/fa-v4compatibility.woff2
+- assets/vendor/cytoscape/cytoscape.min.js
 - assets/vendor/github-calendar/github-calendar-responsive.css
 - assets/vendor/github-calendar/github-calendar.min.js
-- assets/vendor/jquery/jquery-3.7.1.min.js
 - assets/vendor/mathjax/es5/adaptors/liteDOM.js
 - assets/vendor/mathjax/es5/core.js
 - assets/vendor/mathjax/es5/output/chtml/fonts/woff-v2/MathJax_AMS-Regular.woff
@@ -380,6 +385,8 @@ files:
 - scripts/build
 - scripts/content-review.rb
 - scripts/convert-notebooks.sh
+- scripts/dev/css-diff.sh
+- scripts/dev/shot.js
 - scripts/docker-publish
 - scripts/docs/check-freshness.sh
 - scripts/docs/check-links.sh
@@ -388,6 +395,8 @@ files:
 - scripts/example-usage.sh
 - scripts/features/generate-preview-images
 - scripts/features/install-preview-generator
+- scripts/features/pixelate-preview-images
+- scripts/features/pixelate_images.py
 - scripts/features/validate_preview_urls.py
 - scripts/fix-markdown-format.sh
 - scripts/fork-cleanup.sh
@@ -446,7 +455,6 @@ files:
 - scripts/lib/frontmatter.sh
 - scripts/lib/gem.sh
 - scripts/lib/git.sh
-- scripts/lib/hub.rb
 - scripts/lib/install/README.md
 - scripts/lib/install/agents.sh
 - scripts/lib/install/ai/diagnose.sh
@@ -476,18 +484,17 @@ files:
 - scripts/lint-pages
 - scripts/migrate-nav-modes.sh
 - scripts/migrate.sh
+- scripts/pixelate-preview-images.sh
 - scripts/platform/setup-linux.sh
 - scripts/platform/setup-macos.sh
 - scripts/platform/setup-wsl.sh
 - scripts/post-template-setup.sh
-- scripts/provision-org-sites.rb
-- scripts/provision-org-sites.sh
 - scripts/release
 - scripts/setup.sh
 - scripts/sync-backlog.rb
 - scripts/sync-backlog.sh
-- scripts/sync-hub-metadata.rb
-- scripts/sync-hub-metadata.sh
+- scripts/sync-plan.rb
+- scripts/sync-plan.sh
 - scripts/test-auto-version.sh
 - scripts/test-mermaid.sh
 - scripts/test-notebook-conversion.sh
@@ -497,10 +504,12 @@ files:
 - scripts/test/lib/run_tests.sh
 - scripts/test/lib/test_analyze_commits.sh
 - scripts/test/lib/test_changelog.sh
+- scripts/test/lib/test_content_review.sh
 - scripts/test/lib/test_gem.sh
 - scripts/test/lib/test_git.sh
 - scripts/test/lib/test_locale_independence.sh
 - scripts/test/lib/test_migrate.sh
+- scripts/test/lib/test_pixelate_images.sh
 - scripts/test/lib/test_validation.sh
 - scripts/test/lib/test_version.sh
 - scripts/test/theme/validate

data/_data/hub.yml

@@ -1,68 +0,0 @@
-# =============================================================================
-# Content Hub registry — _data/hub.yml
-# =============================================================================
-#
-# Source of truth for the org content hub. Content NEVER leaves the source
-# repos: each org repo publishes its own GitHub Pages project site at
-# https://<org>.github.io/<repo>/ using this theme via `remote_theme`, and
-# this site is the dashboard that presents and monitors them.
-#
-# Consumers of this registry:
-#   scripts/provision-org-sites.sh   rolls the Pages scaffold out to org repos
-#                                    (templates/org-site/*) and enables Pages
-#   scripts/sync-hub-metadata.sh     refreshes the generated dashboard data:
-#                                      _data/hub_index.yml      (repo stats)
-#                                      _data/navigation/hub.yml (sidebar tree)
-#
-# Validated by `./scripts/sync-hub-metadata.sh --check` (CI gate).
-# =============================================================================
-
-# GitHub organization (or user) whose repositories make up the hub.
-org: year-of-ai
-
-# When true, every non-archived repo in the org is included unless listed in
-# `exclude_repos`. When false, only repos listed under `repos:` are included.
-auto_discover: true
-
-# Repos that are never treated as content sites.
-exclude_repos:
-  - zer0-mistakes # this site/theme itself
-  - .github # org meta repo, if one appears
-
-# Settings applied when provisioning org repos as Pages sites.
-pages:
-  # Value for `remote_theme:` in the generated _config.yml of each org repo.
-  # The org root site (year-of-ai/year-of-ai.github.io) is a fork of the
-  # zer0-mistakes theme and doubles as the remote_theme source for the years.
-  theme_repo: year-of-ai/year-of-ai.github.io
-  # Git ref to scaffold against / publish from. Empty = repo default branch.
-  branch: ""
-
-# Rules applied to every repo unless overridden per-repo below.
-defaults:
-  # Paths that are repo/agent plumbing rather than content. Used both for the
-  # generated Pages `exclude:` list and for the dashboard page counts.
-  exclude:
-    - "README.md" # rendered as the site homepage, not counted as content
-    - "CLAUDE.md"
-    - "AGENTS.md"
-    - "LIFECYCLE.md"
-    - "ROADMAP.md"
-    - "lifecycle.yml"
-    - "seed.md"
-    - "seed-package/**"
-    - "telemetry/**"
-    - ".github/**"
-    - ".claude/**"
-
-# Optional per-repo overrides, merged onto discovered repos by `name`.
-# Supported keys: name (required), title, description, branch.
-repos:
-  - name: "2005"
-    title: "2005 — Year Knowledge Base"
-  - name: "2006"
-    title: "2006 — Year Knowledge Base"
-  - name: "2007"
-    title: "2007 — Year Knowledge Base"
-  - name: "2008"
-    title: "2008 — Year Knowledge Base"