feat(docs): add header script count badge and include setup/shared docs in nav

Author: rudraditya21

docs/javascripts/script-count.js

@@ -0,0 +1,74 @@
+(() => {
+  const BADGE_ID = "script-total-badge";
+
+  function normalizePath(href) {
+    try {
+      const url = new URL(href, window.location.href);
+      let path = url.pathname || "";
+
+      if (!path) {
+        return "";
+      }
+
+      path = path.replace(/\/{2,}/g, "/");
+      if (path.startsWith("scripts/")) {
+        path = `/${path}`;
+      }
+
+      return path.replace(/\/+$/, "");
+    } catch {
+      return "";
+    }
+  }
+
+  function getScriptDocCount() {
+    const paths = new Set();
+
+    document.querySelectorAll("a[href]").forEach((anchor) => {
+      const href = anchor.getAttribute("href");
+      if (!href || href.startsWith("#")) {
+        return;
+      }
+
+      const path = normalizePath(href);
+      if (!path || !path.includes("/scripts/")) {
+        return;
+      }
+
+      paths.add(path);
+    });
+
+    return paths.size;
+  }
+
+  function renderBadge() {
+    const container = document.querySelector("header .ml-auto");
+    if (!container) {
+      return;
+    }
+
+    const count = getScriptDocCount();
+    if (count <= 0) {
+      return;
+    }
+
+    let badge = document.getElementById(BADGE_ID);
+    if (!badge) {
+      badge = document.createElement("span");
+      badge.id = BADGE_ID;
+      badge.className = "script-total-badge";
+      container.prepend(badge);
+    }
+
+    badge.textContent = `Total Scripts: ${count}`;
+    badge.setAttribute("aria-label", `Total scripts ${count}`);
+  }
+
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", renderBadge, { once: true });
+  } else {
+    renderBadge();
+  }
+
+  window.addEventListener("load", renderBadge);
+})();

docs/stylesheets/extra.css

@@ -77,3 +77,26 @@ article .typography pre.is-copied .code-copy-button {
 footer .text-muted-foreground.w-full.text-center.text-xs.leading-loose.sm\:text-sm {
   display: none;
 }
+
+/* Header badge showing the total script count from docs navigation links. */
+.script-total-badge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: 1.75rem;
+  padding: 0 0.65rem;
+  border: 1px solid var(--color-border);
+  border-radius: 999px;
+  background-color: var(--color-secondary);
+  color: var(--color-secondary-foreground);
+  font-size: 0.72rem;
+  font-weight: 600;
+  line-height: 1;
+  white-space: nowrap;
+}
+
+@media (max-width: 767px) {
+  .script-total-badge {
+    display: none;
+  }
+}

mkdocs.yml

@@ -21,6 +21,7 @@ extra_css:
 
 extra_javascript:
   - javascripts/code-copy.js
+  - javascripts/script-count.js
 
 markdown_extensions:
   - admonition
@@ -121,6 +122,7 @@ nav:
       - repo-healthcheck.sh: scripts/git/repo-healthcheck.md
       - clean-stale-branches.sh: scripts/git/clean-stale-branches.md
   - setup/local:
+      - cleanup.sh: scripts/setup/local/cleanup.md
       - install-cli-tools.sh: scripts/setup/local/install-cli-tools.md
       - setup-shell.sh: scripts/setup/local/setup-shell.md
       - setup-ssh.sh: scripts/setup/local/setup-ssh.md
@@ -132,10 +134,26 @@ nav:
   - setup/runner:
       - bootstrap-linux-runner.sh: scripts/setup/runner/bootstrap-linux-runner.md
       - bootstrap-macos-runner.sh: scripts/setup/runner/bootstrap-macos-runner.md
+      - cleanup.sh: scripts/setup/runner/cleanup.md
+      - configure.sh: scripts/setup/runner/configure.md
       - install-docker.sh: scripts/setup/runner/install-docker.md
       - install-k8s-tools.sh: scripts/setup/runner/install-k8s-tools.md
       - install-cloud-clis.sh: scripts/setup/runner/install-cloud-clis.md
       - runner-healthcheck.sh: scripts/setup/runner/runner-healthcheck.md
+  - setup/ci-agent:
+      - cleanup.sh: scripts/setup/ci-agent/cleanup.md
+      - configure.sh: scripts/setup/ci-agent/configure.md
+  - setup/kube-workstation:
+      - cleanup.sh: scripts/setup/kube-workstation/cleanup.md
+      - install.sh: scripts/setup/kube-workstation/install.md
+      - verify.sh: scripts/setup/kube-workstation/verify.md
+  - setup/db-tools:
+      - cleanup.sh: scripts/setup/db-tools/cleanup.md
+      - configure.sh: scripts/setup/db-tools/configure.md
+      - verify.sh: scripts/setup/db-tools/verify.md
+  - setup/security-tools:
+      - cleanup.sh: scripts/setup/security-tools/cleanup.md
+      - verify.sh: scripts/setup/security-tools/verify.md
   - shared/core:
       - log-info.sh: scripts/shared/core/log-info.md
       - log-warn.sh: scripts/shared/core/log-warn.md
@@ -154,3 +172,23 @@ nav:
       - dry-run.sh: scripts/shared/safety/dry-run.md
       - confirm-dangerous.sh: scripts/shared/safety/confirm-dangerous.md
       - audit-event.sh: scripts/shared/safety/audit-event.md
+  - shared/logging:
+      - doc.sh: scripts/shared/logging/doc.md
+      - example.sh: scripts/shared/logging/example.md
+      - test.sh: scripts/shared/logging/test.md
+  - shared/validation:
+      - doc.sh: scripts/shared/validation/doc.md
+      - example.sh: scripts/shared/validation/example.md
+      - test.sh: scripts/shared/validation/test.md
+  - shared/retry:
+      - doc.sh: scripts/shared/retry/doc.md
+      - example.sh: scripts/shared/retry/example.md
+      - test.sh: scripts/shared/retry/test.md
+  - shared/timeout:
+      - doc.sh: scripts/shared/timeout/doc.md
+      - example.sh: scripts/shared/timeout/example.md
+      - test.sh: scripts/shared/timeout/test.md
+  - shared/lock:
+      - doc.sh: scripts/shared/lock/doc.md
+      - example.sh: scripts/shared/lock/example.md
+      - test.sh: scripts/shared/lock/test.md