chore(governance): post-merge sync -- 265 fixes

.codex/locks-local/808-governance-replay-2026-03-09T17-46-57-674Z.json

@@ -54,5 +54,6 @@
   ],
   "created_at": "2026-03-09T17:46:57.674Z",
   "expires_at": "2026-03-10T01:46:57.674Z",
-  "status": "active"
+  "status": "released",
+  "released_at": "2026-03-09T21:19:08.337Z"
 }

.codex/task-contract.yaml

@@ -1,44 +1,24 @@
-task_id: 20260310
-branch: codex/20260310-post-merge-cleanup-phase-recovered
+task_id: 811
+branch: codex/811-fix-governance-merge
 base_branch: docs-v2
 scope_in:
-  - .codex/README.md
   - .codex/task-contract.yaml
-  - .githooks/README.md
-  - docs-guide/indexes/scripts-index.mdx
-  - tasks/reports/script-classifications.json
-  - tests/integration/openapi-reference-audit.js
-  - tests/package.json
-  - tests/run-all.js
-  - tests/run-pr-checks.js
-  - tests/script-index.md
-  - tests/unit/codex-safe-merge-with-stash.test.js
-  - tests/utils/mdx-parser.js
-  - tools/lib/docs-usefulness/journey-check.js
-  - tools/lib/script-index.md
-  - tools/script-index.md
-  - tools/scripts/audit-scripts.js
-  - tools/scripts/codex-safe-merge-with-stash.js
-  - tools/scripts/codex/lock-release.js
-  - tools/scripts/codex/task-finalize.js
-  - tools/scripts/codex/task-preflight.js
-  - tools/scripts/codex/validate-locks.js
-  - tools/scripts/create-codex-pr.js
-  - tools/scripts/generate-docs-guide-indexes.js
-  - tools/scripts/generate-llms-files.js
-  - tools/scripts/sync-codex-skills.js
-  - tools/scripts/validate-codex-task-contract.js
-  - tools/scripts/validators/components/check-component-css.js
-  - tools/scripts/validators/content/check-description-quality.js
-  - tests/unit/codex-task-cleanup.test.js
-  - tests/unit/codex-task-preflight.test.js
-  - tools/lib/load-js-yaml.js
-  - tools/lib/load-minimatch.js
-  - tools/scripts/codex/task-cleanup.js
+  - .github/workflows/governance-sync.yml
+  - tools/scripts/orchestrators/repair-governance.js
+  - tools/scripts/validators/governance/audit-script-inventory.js
+  - tests/unit/repair-governance.test.js
+  - tests/unit/audit-script-inventory-repair-rules.test.js
 scope_out: []
 allowed_generated:
   - .codex/pr-body.generated.md
+  - tasks/reports/repo-ops/REPAIR_REPORT_LATEST.json
+  - tasks/reports/repo-ops/REPAIR_REPORT_LATEST.md
+  - tasks/reports/repo-ops/SCRIPT_INVENTORY_FULL.json
+  - tasks/reports/repo-ops/SCRIPT_INVENTORY_FULL.md
+  - tasks/reports/script-classifications.json
 acceptance_checks:
+  - node tests/unit/repair-governance.test.js
+  - node tools/scripts/orchestrators/repair-governance.js --dry-run
   - node tests/run-pr-checks.js --base-ref docs-v2
 risk_flags:
   - workflow-governance

.githooks/pre-commit

@@ -400,6 +400,13 @@ if [ -n "$WHITELIST_CHANGES" ]; then
     fi
 fi
 
+# Navigation exclusions — intentional Mintlify workarounds
+# See tools/config/navigation-exclusions.json for documented patterns.
+# Validators must load this config and skip:
+#   - anchors with value " " (empty anchor sidebar separators)
+#   - pages listed in intentionalPatterns.redirectRoutes.paths
+NAVIGATION_EXCLUSIONS_CONFIG="tools/config/navigation-exclusions.json"
+
 # Check for docs.json /redirect route changes (BLOCKED)
 DOCS_JSON_REDIRECT_DIFF=$(git diff --cached --unified=0 -- docs.json | grep -E '^[+-][^+-].*/redirect' || true)
 if [ -n "$DOCS_JSON_REDIRECT_DIFF" ]; then

.github/workflows/governance-sync.yml

@@ -55,7 +55,7 @@ jobs:
         if: steps.repair.outputs.fixes != '0'
         uses: peter-evans/create-pull-request@v7
         with:
-          branch: chore/governance-sync-${{ github.run_id }}
+          branch: automation/governance-sync
           title: 'chore(governance): post-merge sync -- ${{ steps.repair.outputs.fixes }} fixes'
           body: |
             Automated post-merge governance sync triggered by ${{ github.sha }}.

docs-index.json

@@ -1,6 +1,6 @@
 {
   "version": "docs-index.v1",
-  "generated": "2026-03-09T20:06:08.057Z",
+  "generated": "2026-03-10T04:20:54.533Z",
   "pages": [
     {
       "url": "https://docs.livepeer.org/v2/home/mission-control",
@@ -16278,32 +16278,28 @@
       "entities": [],
       "apiEndpoints": [],
       "difficulty": "beginner",
-      "wordCount": 755,
-      "lastVerified": "2026-03-09T19:54:46.469Z",
+      "wordCount": 700,
+      "lastVerified": "2026-03-10T07:07:09+11:00",
       "headings": [
         {
           "level": 2,
-          "text": "Overview"
-        },
-        {
-          "level": 2,
-          "text": "Trigger Chain"
+          "text": "Trigger chain"
         },
         {
           "level": 2,
-          "text": "Auto-Fixed vs Needs Human"
+          "text": "Auto-fixed vs needs human"
         },
         {
           "level": 2,
           "text": "Commands"
         },
         {
           "level": 2,
-          "text": "Adding a New Script"
+          "text": "Adding a new script"
         },
         {
           "level": 2,
-          "text": "The 9-Field Header Schema"
+          "text": "The 9-field schema"
         }
       ],
       "codeLanguages": [
@@ -16672,7 +16668,7 @@
       "apiEndpoints": [],
       "difficulty": "intermediate",
       "wordCount": 41,
-      "lastVerified": "2026-03-10T05:09:37+11:00",
+      "lastVerified": "2026-03-10T07:07:09+11:00",
       "headings": [],
       "codeLanguages": []
     },
@@ -16741,7 +16737,7 @@
       "apiEndpoints": [],
       "difficulty": "intermediate",
       "wordCount": 4073,
-      "lastVerified": "2026-03-10T06:42:22+11:00",
+      "lastVerified": "2026-03-10T07:07:09+11:00",
       "headings": [
         {
           "level": 2,
@@ -16801,7 +16797,7 @@
       "apiEndpoints": [],
       "difficulty": "intermediate",
       "wordCount": 986,
-      "lastVerified": "2026-03-10T06:46:12+11:00",
+      "lastVerified": "2026-03-10T07:07:09+11:00",
       "headings": [],
       "codeLanguages": []
     },