jekyll-theme-zer0 1.27.0 → 1.28.0

data/assets/js/obsidian-local-graph.js

@@ -1,3 +1,4 @@
+// Feature: ZER0-045
 /*
  * obsidian-local-graph.js
  *
@@ -12,8 +13,13 @@
  * Subgraph:
  *   - center  = current page (matched against entry.url, falling back to
  *               normalized title/basename/aliases for permalink quirks)
- *   - depth   = configurable via data-depth attribute (default 1)
- *   - direction = both incoming and outgoing wiki-links
+ *   - depth   = 1–3, user-adjustable in the panel (default from the
+ *               data-depth attribute / `local_graph_depth` front matter)
+ *   - direction = outgoing and/or incoming wiki-links, user-toggleable
+ *
+ * Depth + direction preferences persist to localStorage
+ * (zer0.obsidianLocalGraph.v1) and the graph re-renders in place when they
+ * change — same for Bootstrap color-mode (data-bs-theme) switches.
  *
  * If the current page is in the wiki-index but has no local links, the panel
  * stays available and renders a single-node graph for the current page.
@@ -26,6 +32,7 @@
   var PANEL_SELECTOR = '[data-obsidian-local-graph-panel]';
   var TOGGLE_SELECTOR = '[data-obsidian-local-graph-toggle]';
   var STATUS_SELECTOR = '[data-obsidian-local-graph-status]';
+  var STORAGE_KEY = 'zer0.obsidianLocalGraph.v1';
 
   // Cytoscape is vendored under assets/vendor/ (no runtime CDN — matches the
   // Bootstrap / Icons / Mermaid policy). The path is supplied by Liquid via
@@ -57,6 +64,28 @@
       .replace(/"/g, '"').replace(/'/g, ''');
   }
 
+  // Depth + direction preferences. Depth falls back to the page's data-depth
+  // (front-matter `local_graph_depth`), directions default to both on.
+  function loadPrefs(defaultDepth) {
+    var prefs = { depth: defaultDepth, outgoing: true, incoming: true };
+    try {
+      var saved = JSON.parse(window.localStorage.getItem(STORAGE_KEY) || 'null');
+      if (saved && typeof saved === 'object') {
+        var d = parseInt(saved.depth, 10);
+        if (d >= 1 && d <= 3) prefs.depth = d;
+        if (typeof saved.outgoing === 'boolean') prefs.outgoing = saved.outgoing;
+        if (typeof saved.incoming === 'boolean') prefs.incoming = saved.incoming;
+      }
+    } catch (e) { /* private mode / corrupt payload — use defaults */ }
+    return prefs;
+  }
+
+  function savePrefs(prefs) {
+    try {
+      window.localStorage.setItem(STORAGE_KEY, JSON.stringify(prefs));
+    } catch (e) { /* storage unavailable — prefs are session-only */ }
+  }
+
   function companionElements(container) {
     return {
       panel: container.closest(PANEL_SELECTOR),
@@ -143,10 +172,11 @@
     return palette[name] || '#6c757d';
   }
 
-  // BFS from the current entry up to `depth` hops, following both
-  // outgoing edges and incoming edges (any other entry whose `outgoing`
-  // includes one of our keys).
-  function buildSubgraph(entries, lookup, current, depth) {
+  // BFS from the current entry up to `depth` hops. Directions are opt-in:
+  // opts.outgoing follows this page's [[links]], opts.incoming follows any
+  // other entry whose `outgoing` includes one of our keys.
+  function buildSubgraph(entries, lookup, current, depth, opts) {
+    opts = opts || { outgoing: true, incoming: true };
     var visited = Object.create(null);
     var queue = [{ entry: current, dist: 0 }];
     var nodes = [];
@@ -206,45 +236,49 @@
       if (item.dist >= depth) continue;
 
       // Outgoing edges
-      (entry.outgoing || []).forEach(function (target) {
-        var nk = normalize(target);
-        var resolved = lookup.byKey[nk];
-        if (resolved) {
-          if (resolved.url === entry.url) return;
-          addEdge(entry.url, resolved.url, false);
-          if (!visited[resolved.url]) {
-            queue.push({ entry: resolved, dist: item.dist + 1 });
+      if (opts.outgoing) {
+        (entry.outgoing || []).forEach(function (target) {
+          var nk = normalize(target);
+          var resolved = lookup.byKey[nk];
+          if (resolved) {
+            if (resolved.url === entry.url) return;
+            addEdge(entry.url, resolved.url, false);
+            if (!visited[resolved.url]) {
+              queue.push({ entry: resolved, dist: item.dist + 1 });
+            }
+          } else {
+            var brokenId = '__broken__:' + nk;
+            if (!visited[brokenId]) {
+              visited[brokenId] = true;
+              nodes.push({
+                group: 'nodes',
+                data: {
+                  id: brokenId,
+                  label: target,
+                  url: null,
+                  collection: 'broken',
+                  color: '#dc3545',
+                  broken: true
+                }
+              });
+            }
+            addEdge(entry.url, brokenId, true);
           }
-        } else {
-          var brokenId = '__broken__:' + nk;
-          if (!visited[brokenId]) {
-            visited[brokenId] = true;
-            nodes.push({
-              group: 'nodes',
-              data: {
-                id: brokenId,
-                label: target,
-                url: null,
-                collection: 'broken',
-                color: '#dc3545',
-                broken: true
-              }
-            });
-          }
-          addEdge(entry.url, brokenId, true);
-        }
-      });
+        });
+      }
 
       // Incoming edges (anyone whose outgoing matches one of our keys)
-      keysFor(entry).forEach(function (k) {
-        (reverse[k] || []).forEach(function (src) {
-          if (src.url === entry.url) return;
-          addEdge(src.url, entry.url, false);
-          if (!visited[src.url]) {
-            queue.push({ entry: src, dist: item.dist + 1 });
-          }
+      if (opts.incoming) {
+        keysFor(entry).forEach(function (k) {
+          (reverse[k] || []).forEach(function (src) {
+            if (src.url === entry.url) return;
+            addEdge(src.url, entry.url, false);
+            if (!visited[src.url]) {
+              queue.push({ entry: src, dist: item.dist + 1 });
+            }
+          });
         });
-      });
+      }
     }
 
     return nodes.concat(edges);
@@ -299,6 +333,11 @@
   }
 
   function render(container, elements, currentUrl) {
+    // Re-renders (depth/direction/theme changes) replace the prior instance.
+    if (container.__obsidianLocalGraph) {
+      try { container.__obsidianLocalGraph.destroy(); } catch (e) { /* ignore */ }
+      container.__obsidianLocalGraph = null;
+    }
     var theme = readTheme();
     container.style.backgroundColor = theme.canvasBg;
     var motion = prefersReducedMotion() ? '0ms' : '160ms';
@@ -460,6 +499,59 @@
     return nav;
   }
 
+  // Reflect prefs into the depth radio group + direction switches.
+  function syncControls(prefs) {
+    var radio = document.getElementById('obsidian-lg-depth-' + prefs.depth);
+    if (radio) radio.checked = true;
+    var outgoing = document.getElementById('obsidian-lg-outgoing');
+    if (outgoing) outgoing.checked = prefs.outgoing;
+    var incoming = document.getElementById('obsidian-lg-incoming');
+    if (incoming) incoming.checked = prefs.incoming;
+  }
+
+  function wireControls(prefs, rebuild) {
+    [1, 2, 3].forEach(function (d) {
+      var radio = document.getElementById('obsidian-lg-depth-' + d);
+      if (!radio) return;
+      radio.addEventListener('change', function () {
+        if (!radio.checked) return;
+        prefs.depth = d;
+        savePrefs(prefs);
+        rebuild();
+      });
+    });
+    var outgoing = document.getElementById('obsidian-lg-outgoing');
+    if (outgoing) {
+      outgoing.addEventListener('change', function () {
+        prefs.outgoing = outgoing.checked;
+        savePrefs(prefs);
+        rebuild();
+      });
+    }
+    var incoming = document.getElementById('obsidian-lg-incoming');
+    if (incoming) {
+      incoming.addEventListener('change', function () {
+        prefs.incoming = incoming.checked;
+        savePrefs(prefs);
+        rebuild();
+      });
+    }
+  }
+
+  // Re-render on Bootstrap color-mode changes so canvas colors track the
+  // theme without a reload. Local graphs are small — a full rebuild is cheap.
+  function watchTheme(rebuild) {
+    var restyle = debounce(rebuild, 60);
+    var observer = new MutationObserver(restyle);
+    [document.documentElement, document.body].forEach(function (el) {
+      observer.observe(el, { attributes: true, attributeFilter: ['data-bs-theme'] });
+    });
+    if (window.matchMedia) {
+      var mq = window.matchMedia('(prefers-color-scheme: dark)');
+      if (mq.addEventListener) mq.addEventListener('change', restyle);
+    }
+  }
+
   function init() {
     var container = document.getElementById(CONTAINER_ID);
     if (!container) return;
@@ -478,8 +570,9 @@
       resizeGraph(container);
     }, 150));
 
-    var depth = parseInt(container.getAttribute('data-depth') || '1', 10);
-    if (!isFinite(depth) || depth < 1) depth = 1;
+    var defaultDepth = parseInt(container.getAttribute('data-depth') || '1', 10);
+    if (!isFinite(defaultDepth) || defaultDepth < 1) defaultDepth = 1;
+    var prefs = loadPrefs(Math.min(defaultDepth, 3));
     var indexUrl = container.getAttribute('data-index-url') ||
       ((document.querySelector('base') || {}).href || '/') +
       'assets/data/wiki-index.json';
@@ -496,17 +589,21 @@
         // Confirmed in-index: reveal the panel + FAB now.
         setPanelAvailable(container, true);
         setStatus(container, 'Loading graph…', false);
-
-        var elements = buildSubgraph(entries, lookup, current, depth);
-        var nodeCount = elements.filter(function (element) { return element.group === 'nodes'; }).length;
-        var edgeCount = elements.filter(function (element) { return element.group === 'edges'; }).length;
-        // Accessible text fallback (also the graceful degradation if cytoscape
-        // can't load): a list of linked neighbours below the canvas.
-        var fallback = renderTextFallback(container, elements, current);
-
-        loadCytoscape(function (ok) {
-          if (ok === false) {
-            // Keep the text list visible; hide the empty canvas.
+        syncControls(prefs);
+
+        var graphAvailable = null; // unknown until loadCytoscape resolves
+
+        function rebuild() {
+          var elements = buildSubgraph(entries, lookup, current, prefs.depth, {
+            outgoing: prefs.outgoing,
+            incoming: prefs.incoming
+          });
+          var nodeCount = elements.filter(function (el) { return el.group === 'nodes'; }).length;
+          var edgeCount = elements.filter(function (el) { return el.group === 'edges'; }).length;
+          // Accessible text fallback (also the graceful degradation if
+          // cytoscape can't load): a list of linked neighbours below the canvas.
+          var fallback = renderTextFallback(container, elements, current);
+          if (graphAvailable === false) {
             container.hidden = true;
             setStatus(container, 'Showing linked pages (interactive graph unavailable).', false);
             return;
@@ -515,6 +612,16 @@
           setStatus(container, nodeCount + ' pages · ' + edgeCount + ' links', false);
           // Graph is the visual representation; keep the list for AT only.
           if (fallback) fallback.classList.add('visually-hidden');
+        }
+
+        wireControls(prefs, rebuild);
+        watchTheme(function () {
+          if (container.__obsidianLocalGraph) rebuild();
+        });
+
+        loadCytoscape(function (ok) {
+          graphAvailable = ok !== false;
+          rebuild();
         });
       })
       .catch(function (err) {

data/assets/js/search-modal.js

@@ -74,8 +74,11 @@
             if (typeof bootstrap === 'undefined') return;
             const cookieEl = document.getElementById('cookieSettingsModal');
             const infoEl = document.getElementById('info-section');
+            const drawerEl = document.getElementById('zer0UnifiedDrawer');
             afterModalClosed(cookieEl, () => {
-                afterOffcanvasClosed(infoEl, showSearchModal);
+                afterOffcanvasClosed(infoEl, () => {
+                    afterOffcanvasClosed(drawerEl, showSearchModal);
+                });
             });
         };
 

data/scripts/bin/manifest

@@ -35,12 +35,15 @@ DESCRIPTION:
     Run automatically by scripts/bin/release before tagging.
 
 OPTIONS:
+    --check         Exit non-zero if the committed manifest is stale; write
+                    nothing. `generated_at` is ignored in the comparison.
     --dry-run       Print manifest to stdout; don't write the file
     --verbose       Show each file being processed
     --help, -h      Show this help message
 
 EXAMPLES:
     ./scripts/bin/manifest                  # Regenerate _data/theme-manifest.yml
+    ./scripts/bin/manifest --check          # CI gate: is the manifest current?
     ./scripts/bin/manifest --dry-run        # Preview output
     ./scripts/bin/manifest --verbose        # Show every file being hashed
 EOF
@@ -81,9 +84,11 @@ OPTIONAL_PLUGIN_PATHS=(
 # Argument parsing
 DRY_RUN=false
 VERBOSE=false
+CHECK=false
 
 while [[ $# -gt 0 ]]; do
     case $1 in
+        --check)     CHECK=true; DRY_RUN=true ;;
         --dry-run)   DRY_RUN=true ;;
         --verbose)   VERBOSE=true ;;
         --help|-h)   show_usage; exit 0 ;;
@@ -93,7 +98,14 @@ while [[ $# -gt 0 ]]; do
 done
 
 # ---------------------------------------------------------------------------
-step "Generating theme manifest..."
+# Under --dry-run stdout carries only the manifest YAML — the CI freshness gate
+# (ci.yml "Theme manifest freshness") diffs that stdout straight against the
+# committed file, so progress logs must not pollute it.
+if [[ "$DRY_RUN" == "true" ]]; then
+    step "Generating theme manifest..." >&2
+else
+    step "Generating theme manifest..."
+fi
 cd "$REPO_ROOT"
 
 CURRENT_VERSION=$(get_current_version)
@@ -173,10 +185,25 @@ YAML
 )
 
 # ---------------------------------------------------------------------------
-if [[ "$DRY_RUN" == "true" ]]; then
-    info "[DRY RUN] Would write _data/theme-manifest.yml:"
+MANIFEST_FILE="$REPO_ROOT/_data/theme-manifest.yml"
+
+if [[ "$CHECK" == "true" ]]; then
+    # Staleness = any difference other than the generation timestamp, which moves
+    # on every run and would otherwise report a false positive every time.
+    if [[ ! -f "$MANIFEST_FILE" ]]; then
+        error "Manifest missing: _data/theme-manifest.yml — run ./scripts/bin/manifest"
+    fi
+    if diff -u \
+        <(grep -v '^generated_at:' "$MANIFEST_FILE") \
+        <(echo "$MANIFEST_CONTENT" | grep -v '^generated_at:') >&2; then
+        success "Manifest is current (version $CURRENT_VERSION)" >&2
+        exit 0
+    fi
+    error "Manifest is stale — run ./scripts/bin/manifest and commit the result"
+elif [[ "$DRY_RUN" == "true" ]]; then
+    info "[DRY RUN] Would write _data/theme-manifest.yml:" >&2
     echo "$MANIFEST_CONTENT"
 else
-    echo "$MANIFEST_CONTENT" > "$REPO_ROOT/_data/theme-manifest.yml"
+    echo "$MANIFEST_CONTENT" > "$MANIFEST_FILE"
     success "Written: _data/theme-manifest.yml (version $CURRENT_VERSION)"
 fi

data/scripts/bin/validate

@@ -391,7 +391,11 @@ if File.file?('_config_secrets_local.yml')
   assert(!tracked, '_config_secrets_local.yml must remain untracked and ignored')
 end
 
-ignored_dirs = %w[.git _site node_modules vendor .jekyll-cache .sass-cache test/fixtures]
+# examples/ holds self-contained demo sites, each with its own _config.yml and
+# _config_dev.yml. Those belong to the example, not to this site's config
+# surface, so prune the tree rather than registering every example's configs in
+# classified_files below (which would need editing for each new example).
+ignored_dirs = %w[.git _site node_modules vendor .jekyll-cache .sass-cache test/fixtures examples]
 config_like_files = []
 
 Find.find('.') do |path|

data/scripts/install/README.md

@@ -86,8 +86,11 @@ This installer runs on macOS's `/bin/bash` (3.2). Restrictions:
 # Local development
 ./scripts/bin/install help
 ./scripts/bin/install init . --profile blog --site-title "My Blog"
-./scripts/bin/install wizard . --ai
-./scripts/bin/install doctor .
+./scripts/bin/install init . --config zer0.install.yml     # config-file driven
+./scripts/bin/install wizard . --ai                        # Claude Code OAuth if available
+./scripts/bin/install wizard . --ai --ai-provider anthropic
+./scripts/bin/install suggest . "a docs site for a Rust CLI"
+./scripts/bin/install doctor .                             # shows the active AI provider
 ./scripts/bin/install diff .
 ./scripts/bin/install plan . --profile docs
 
@@ -110,17 +113,55 @@ curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/scripts/b
 3. Add template to `templates/config/` or `templates/pages/`
 4. List in the appropriate profile YAML under `templates/profiles/`
 
+## Config file layer
+
+Sites can persist installer choices in a small YAML file instead of re-typing flags. `config.sh` discovers and merges these (low→high precedence):
+
+1. `~/.config/zer0/install.yml` (user-global)
+2. `<target>/zer0.install.yml` (project-local)
+3. `<target>/.zer0/config.yml` (project-local, hidden)
+4. `$ZER0_CONFIG` / `--config FILE` (explicit — wins)
+
+The config layer sits between profile defaults and env/flag overrides:
+
+```
+defaults < profile < CONFIG FILE < env vars < CLI flags
+```
+
+Recognised keys (nested **or** flat/dotted both work): `profile`, `site.{title,description,author,email,url,timezone,locale}`, `github.{user,repo,pages_branch,enable_pages}`, `theme.{source,version}`, `deploy`, `agents`, `tasks`, `ai.provider`, `ai.model`. Example:
+
+```yaml
+profile: github-pages
+site:
+  title: "My Docs"
+deploy: [github-pages]
+ai:
+  provider: claude-cli      # auto | claude-cli | anthropic | openai | none
+```
+
+API keys are **never** read from config files — they stay in the environment.
+
 ## AI integration
 
 The AI path is a first-class citizen but never mandatory:
 
 - `ai_wizard_run` → interactive LLM spec generation
-- `ai_diagnose_run` → post-build error analysis  
-- `ai_suggest_run` → profile + deploy recommendation
+- `ai_diagnose_run` → post-build error analysis
+- `ai_suggest_run` → profile + deploy recommendation (also `install suggest`)
+
+All are guarded by the `ZER0_NO_AI=1` kill-switch and degrade gracefully to defaults or rule-based logic when AI is unavailable.
+
+### Providers (`ai/client.sh`)
+
+The client is multi-provider. `ZER0_AI_PROVIDER` (or config `ai.provider`, or `--ai-provider`) selects one; the default `auto` resolves in this order:
 
-All three are guarded by `ZER0_NO_AI=1` kill-switch and degrade gracefully to defaults or rule-based logic when AI is unavailable.
+| # | Provider     | Auth                                            | Notes |
+|---|--------------|-------------------------------------------------|-------|
+| 1 | `claude-cli` | the logged-in `claude` CLI (**Claude Code OAuth**) | Zero key handling — reuses `claude setup-token` / `claude login`. Preferred when the `claude` binary is on `PATH`. |
+| 2 | `anthropic`  | `CLAUDE_CODE_OAUTH_TOKEN` (OAuth) or `ANTHROPIC_API_KEY` | Anthropic Messages API over HTTPS. |
+| 3 | `openai`     | `OPENAI_API_KEY` (or `OPENAI_BASE_URL` for Azure/Ollama) | OpenAI-compatible `/chat/completions`. |
 
-To enable: set `OPENAI_API_KEY` (or `OPENAI_BASE_URL` for Azure/Ollama).
+Model is auto-defaulted per provider and overridable with `ZER0_AI_MODEL` / `--ai-model` (`ANTHROPIC_MODEL` / `OPENAI_MODEL` also honoured). Run `install doctor` to see which provider is active. All calls are single-attempt with a 30s timeout; user context is sanitized before it leaves the host.
 
 ## Deploy plugins