feat: API sidebar sync automation (#367)

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Author: steve-calvert-glean

.github/workflows/ci.yml

@@ -40,6 +40,9 @@ jobs:
             echo "No usage of support@glean.com found"
           fi
 
+      - name: Check API sidebar completeness
+        run: pnpm sidebar:check
+
       - name: Build website
         run: pnpm build
         env:

package.json

@@ -41,9 +41,11 @@
     "format:check": "prettier --check .",
     "links:check": "scripts/check-links.sh https://developers.glean.com true",
     "links:check:local": "pnpm build && (pnpm serve --port 8888 & SERVER_PID=$!; sleep 5; scripts/check-links.sh http://localhost:8888 true; RESULT=$?; kill $SERVER_PID 2>/dev/null || true; exit $RESULT)",
-    "openapi:regenerate:all": "pnpm run openapi:clean:before:all && pnpm run openapi:transform:all && pnpm run generate:deprecations && pnpm run generate:deprecations:rss && pnpm run openapi:generate:all && pnpm run openapi:clean:after:all",
-    "openapi:regenerate:client": "pnpm run openapi:clean:before:client && pnpm run openapi:transform:client && pnpm run generate:deprecations && pnpm run generate:deprecations:rss && pnpm run openapi:generate:client && pnpm run openapi:clean:after:client",
-    "openapi:regenerate:indexing": "pnpm run openapi:clean:before:indexing && pnpm run openapi:transform:indexing && pnpm run generate:deprecations && pnpm run generate:deprecations:rss && pnpm run openapi:generate:indexing && pnpm run openapi:clean:after:indexing",
+    "sidebar:check": "node scripts/sync-api-sidebar.mjs --check",
+    "sidebar:fix": "node scripts/sync-api-sidebar.mjs --fix",
+    "openapi:regenerate:all": "pnpm run openapi:clean:before:all && pnpm run openapi:transform:all && pnpm run generate:deprecations && pnpm run generate:deprecations:rss && pnpm run openapi:generate:all && pnpm run openapi:clean:after:all && pnpm run sidebar:fix",
+    "openapi:regenerate:client": "pnpm run openapi:clean:before:client && pnpm run openapi:transform:client && pnpm run generate:deprecations && pnpm run generate:deprecations:rss && pnpm run openapi:generate:client && pnpm run openapi:clean:after:client && pnpm run sidebar:fix",
+    "openapi:regenerate:indexing": "pnpm run openapi:clean:before:indexing && pnpm run openapi:transform:indexing && pnpm run generate:deprecations && pnpm run generate:deprecations:rss && pnpm run openapi:generate:indexing && pnpm run openapi:clean:after:indexing && pnpm run sidebar:fix",
     "openapi:clean:before:all": "pnpm run openapi:clean:before:client && pnpm run openapi:clean:before:indexing",
     "openapi:clean:before:client": "find docs/api/client-api -type f ! -name 'overview.mdx' -delete",
     "openapi:clean:before:indexing": "find docs/api/indexing-api -type f ! -name '*-overview.mdx' -delete",
@@ -134,6 +136,7 @@
     "@vitest/ui": "^4.0.18",
     "fast-levenshtein": "^3.0.0",
     "fixturify-project": "^7.1.3",
+    "jscodeshift": "^17.3.0",
     "jsdom": "^27.4.0",
     "nock": "^14.0.0",
     "npm-run-all": "^4.1.5",