> ## Documentation Index > Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt > Use this file to discover all available pages before exploring further. # Scripts Catalog > Generated catalog of all governed repository scripts, grouped by type with pipeline flow diagram. **Generation Script**: This file is generated from script(s): `operations/tests/unit/script-docs.test.js`.
**Purpose**: Enforce script header schema, keep group script indexes in sync, and build aggregate script catalog.
**Run when**: Script metadata changes in validation roots or script changes in indexed roots.
**Important**: Do not manually edit this file; run `node operations/tests/unit/script-docs.test.js --write --rebuild-indexes`.
The governed script library currently indexes **505** script(s). ## Pipeline Flow ```mermaid theme={"theme":{"light":"github-light","dark":"dark-plus"}} flowchart LR DEV([👤 Developer]) subgraph P1["🔴 P1 — Commit Gate (48)"] direction TB c0["pre-commit"] c1["sync-generated-files.js"] c2["generate-docs-guide-components-index.js"] c3["check-no-ai-stash.sh"] c4["validate-locks.js"] c5["enforce-generated-file-banners.js"] c6["check-new-file-governance.js"] c7["validate-codex-task-contract.js"] c8["audit-script-inventory.js"] c9["pre-commit-v1"] c10["browser.test.js"] c11["v2-link-audit.js"] cmore["... 36 more"] end subgraph P2["🟠 P2 — Push Gate (16)"] direction TB p0["pre-push"] p1["check-codex-pr-overlap.js"] p2["dispatch-folder-allowlist.js"] p3["generate-glossary-companions.js"] p4["generate-docs-guide-indexes.js"] p5["generate-docs-guide-pages-index.js"] p6["fetch-external-docs.sh"] p7["remediate-frontmatter-quotes.js"] p8["check-no-ai-stash.sh"] p9["validate-locks.js"] p10["validate-codex-task-contract.js"] p11["openapi-reference-audit.js"] pmore["... 4 more"] end subgraph P3["🟡 P3 — PR Gate (113)"] direction TB r0["audit-ai-discoverability.js"] r1["style-and-language-homogenizer-en-gb.js"] r2["dispatch-banned-words.js"] r3["dispatch-brand-check.js"] r4["dispatch-em-dashes.js"] r5["dispatch-grammar-en-gb.js"] r6["dispatch-proper-nouns.js"] r7["dispatch-spelling.js"] r8["dispatch-voice-register.js"] r9["dispatch-canonical-sync.js"] r10["dispatch-changelogs.js"] r11["dispatch-copy-check.js"] rmore["... 101 more"] end subgraph P5_P6["🔵 P5/P6 — Scheduled (95)"] direction TB s0["scan-component-imports.js"] s1["audit-wcag.js"] s2["page-links-audit.js"] s3["style-and-language-homogenizer-en-gb.js"] s4["audit-folder-allowlist.js"] s5["dispatch-banned-words.js"] s6["dispatch-brand-scan.js"] s7["dispatch-em-dashes.js"] s8["dispatch-grammar-en-gb.js"] s9["dispatch-proper-nouns.js"] s10["dispatch-spelling.js"] s11["dispatch-style-tokens.js"] smore["... 83 more"] end DEV -->|commit| P1 P1 -->|push| P2 P2 -->|open PR| P3 P3 -->|merge| P5_P6 ``` **Type key:** 🔍 audit · 🏭 generator · ✅ validator · 🔧 remediator · 🔌 integrator · 🚦 dispatch · 💬 interface · 📚 library module · ⚠️ unclassified ## 🔍 Audits | Script | Description | Pipeline | Concern | Usage | | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `audit-ai-discoverability.js` | Scans .jsx files for React hook usage (useState, useEffect, useMemo, custom hooks). For each hook-using component, checks the JSDoc declares the AI-discoverability tags + a matching snapshot exists at snippets/data/snapshots/\{Component}.json. Emits JSON (--json) or markdown (--md) report. | P3 | maintenance | `node operations/scripts/audits/components/library/audit-ai-discoverability.js [--json] [--md] [--staged]` | | `audit-component-styles.js` | Audit JSX components for style pattern violations: inline styles, top-level constants, missing named style objects. | manual | maintenance | `node operations/scripts/audits/components/library/audit-component-styles.js [--json] [--md] [--staged] [--fix-preview]` | | `audit-component-usage.js` | Component usage auditor — scans pages for component usage patterns and reports statistics | manual | maintenance | `node operations/scripts/audits/components/documentation/audit-component-usage.js` | | `audit-copy-patterns.js` | Aggregate copy pattern violations across a tab or full v2 tree and emit a diagnostic report. | manual | health | `node operations/scripts/audits/content/quality/audit-copy-patterns.js --tab <name> | --all [--output <file>]` | | `audit-folder-allowlist.js` | Layer-5 fail-safe drift scanner. Reads every governed folder's .allowlist, lists actual entries, and reports drift to workspace/reports/governance/folder-allowlist/. Anything caught here represents an upstream layer (write-time hook, pre-commit, PR validator, post-merge) that failed to prevent the file from landing. | P5 | governance | `node operations/scripts/audits/governance/repo/audit-folder-allowlist.js [--json]` | | `audit-glossary-gaps.js` | Glossary gap auditor — scans v2 MDX pages for terminology candidates not | manual | maintenance | `node operations/scripts/audits/content/reference/audit-glossary-gaps.js [flags]` | | `audit-icon-usage.js` | Icon usage auditor — scans v2 and docs-guide MDX pages for icon prop | manual | maintenance | `node operations/scripts/audits/content/reference/audit-icon-usage.js [flags]` | | `audit-media-assets.js` | Audits repo media assets, references, ignore leakage, and externalized asset branch inventory. | manual | health | `node operations/scripts/audits/content/quality/audit-media-assets.js [flags]` | | `audit-pipeline-inventory.js` | Walks operations/scripts/dispatch/ for every dispatcher. Parses JSDoc for concern/niche/type/pipeline/mode/purpose. Statically extracts the atomics each dispatcher invokes (ATOMICS const + runAtomic/runIfExists/runIfExists). Greps v2/ + snippets/ for live consumers of declared outputs. Cross-references workflow YAMLs for the Tier-1 caller. Checks pipeline-smoke-test exclusion list and pipeline-functional-tests TESTS array for test coverage. Emits per-concern sections to workspace/reports/governance/pipeline-inventory.md plus a JSON sibling for programmatic consumers. | manual | governance | `node operations/scripts/audits/governance/repo/audit-pipeline-inventory.js [--json] [--concern <name>]` | | `audit-python.py` | Python page audit utility — validates routed docs files, snippet imports, and internal links, then writes page-audit reports | manual | health | `python3 operations/scripts/audits/content/quality/audit-python.py [flags]` | | `audit-script-categories.js` | Script auditor — analyses all repo scripts, categorises usage/overlap, generates SCRIPT\_AUDIT reports | manual | governance | `node operations/scripts/audits/governance/scripts/audit-script-categories.js [flags]` | | `audit-script-purpose-fit.js` | Walks operations/scripts/ and tools/scripts/. Parses JSDoc 11-tag block. Statically scans the source for file reads, writes, and require calls. Greps callers across workflows + other scripts. Cross-checks the @concern tag against the 7 canonical concerns. Flags writes outside governed folders, reads from archive paths, vague purposes, duplicate niches, and orphans. Outputs per-concern markdown packets the SME reviews to verdict each script. The SME records verdicts in script-registry.json as sme\_status. | manual | governance | `node operations/scripts/audits/governance/repo/audit-script-purpose-fit.js [--concern <name>] [--json]` | | `audit-tasks-folders.js` | Tasks folder auditor — checks workspace/ structure, normalises report locations, applies recommendations with conflict-safe moves | manual | governance | `node operations/scripts/audits/governance/repo/audit-tasks-folders.js [flags]` | | `audit-v2-usefulness.js` | Usefulness auditor — scores v2 MDX pages on human and agent usefulness with source-weighted 2026 accuracy verification | manual | health | `node operations/scripts/audits/content/quality/audit-v2-usefulness.js [flags]` | | `audit-wcag.js` | Pattern D scan-report-act. Runs the WCAG audit engine in --no-fix --full mode, writes report to workspace/reports/health/wcag/, and emits a structured JSON summary on stdout so the workflow can route findings (rolling issue create/update/close). | P5 | health | `node operations/scripts/audits/content/health/audit-wcag.js [--fail-impact minor|moderate|serious|critical] [--max-pages <n>] [--json]` | | `docs-page-research.js` | Docs page research runner — extracts factual claims from docs pages, checks evidence sources, detects contradictions across related pages, and emits manual-first research reports. | manual | health | `node operations/scripts/audits/content/veracity/docs-page-research.js [flags]` | | `docs-quality-and-freshness-audit.js` | Content freshness audit — checks for TODO/TBD/Coming Soon markers, thin pages, stale content | manual | health | `node operations/scripts/audits/content/quality/docs-quality-and-freshness-audit.js [flags]` | | `docs-research-adjudication.js` | Docs research adjudication ledger — validates, records, and summarizes measured review outcomes for the page-content research workflow so trust decisions are based on real usage rather than intuition. | manual | health | `node operations/scripts/audits/content/veracity/docs-research-adjudication.js [flags]` | | `generate-content-gap-reconciliation.js` | Content-gap reconciliation generator — compares blueprint coverage against v2 MDX and writes reconciliation artefacts | manual | maintenance | `node operations/scripts/audits/content/reconciliation/generate-content-gap-reconciliation.js [flags]` | | `generate-v2-folder-governance-cleanup-matrix.js` | V2 folder governance cleanup matrix generator — inventories non-publishable and legacy v2 artifacts and emits human-review markdown/json recommendations before any moves are applied. | manual | governance | `node operations/scripts/audits/governance/reports/generate-v2-folder-governance-cleanup-matrix.js [--report-md <path>] [--report-json <path>] [--as-of <YYYY-MM-DD>]` | | `page-imports-audit.js` | Audit page-reachable import health from canonical operations scripts, with stable outputs under operations/reports/health/page-imports. | manual | health | `node operations/scripts/audits/content/health/page-imports-audit.js [--staged|--scope routable-v2|repo|--files <paths>|--tab <tab>] [--strict] [--output-dir <dir>]` | | `page-links-audit.js` | Audit page-facing link health from canonical operations scripts, with stable outputs under operations/reports/health/page-links. | P6 | health | `node operations/scripts/audits/content/health/page-links-audit.js [--full|--staged|--files <paths>|--tab <tab>] [--strict] [--external-policy classify|validate] [--output-dir <dir>]` | | `scan-component-imports.js` | Scans MDX imports to produce component-usage-map.json and detect @usedIn drift. | P6 | maintenance | `node operations/scripts/audits/components/library/scan-component-imports.js [--verify] [--since <commit>]` | | `script-footprint-and-usage-audit.js` | Script footprint auditor — analyses script file sizes, dependencies, and usage patterns across the repo | manual | governance | `node operations/scripts/audits/governance/scripts/script-footprint-and-usage-audit.js [flags]` | | `style-and-language-homogenizer-en-gb.js` | EN-GB style homogeniser. Reads the style-language profile for word/phrase rules, scans v2 MDX for US spellings and style guide violations, supports --check (report) and --fix (apply known-safe replacements). Skips frontmatter, code blocks, inline code, and JSX attribute values. | P3, P6 | brand | `node operations/scripts/audits/content/style/style-and-language-homogenizer-en-gb.js [--check|--fix] [--scope changed|full] [--files <paths>]` | | `terminology-search.js` | Terminology search — searches glossary/terminology data for definitions | manual | maintenance | `node operations/scripts/audits/content/reference/terminology-search.js [flags]` | ## 🏭 Generators | Script | Description | Pipeline | Concern | Usage | | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `create-codex-pr.test.js` | Tests create-codex-pr.js — validates PR creation logic and branch naming | manual | | `node operations/tests/unit/create-codex-pr.test.js [flags]` | | `docs-research-packet.test.js` | Tests docs-research-packet.js — validates nav, manifest, and path tranche derivation plus packet-summary rollups for the generic research packet engine. | manual | | `node operations/tests/unit/docs-research-packet.test.js` | | `generate-ai-sitemap.js` | Reads docs.json navigation tree + per-page frontmatter, emits sitemap-ai.xml at repo root. --check mode validates the committed sitemap-ai.xml matches the regenerated output (exits non-zero on drift). --write mode regenerates. Pairs with dispatch-ai-sitemap.js. | P3 | discoverability | `node operations/scripts/generators/content/seo/generate-ai-sitemap.js [--check|--write]` | | `generate-ai-skills-indexes.js` | \* @mode read-only | manual | governance | `node operations/scripts/generators/governance/catalogs/generate-ai-skills-indexes.js [--check|--write]` | | `generate-ai-tools-inventory.js` | Generates the AI tools inventory report from the registry. Split from validate-ai-tools-registry.js. | manual | governance | `node operations/scripts/generators/governance/reports/generate-ai-tools-inventory.js [--output <path>]` | | `generate-ai-tools-registry-artifacts.js` | Keep ai-tools/registry/ai-tools-registry.json aligned with live skill/template/export files so ownerless governance coverage stays complete. | manual | governance | `node operations/scripts/generators/governance/catalogs/generate-ai-tools-registry-artifacts.js [--write|--check]` | | `generate-ai-tools-visual-library.js` | Generates the canonical AI-tools visual library for GitHub workflows and dispatcher actions, plus staged audit outputs. | manual | governance | `node operations/scripts/generators/governance/catalogs/generate-ai-tools-visual-library.js [--check|--write]` | | `generate-api-docs.sh` | API docs generator — generates API reference pages from OpenAPI specs | manual | maintenance | `bash operations/scripts/generators/content/reference/generate-api-docs.sh [flags]` | | `generate-component-docs.js` | Generates published component library MDX pages from the registry. Replaces update-component-library.sh. | manual | maintenance | `node operations/scripts/generators/components/documentation/generate-component-docs.js [--dry-run|--fix|--write|--check] [--template-only] [--category <name>]` | | `generate-component-examples.js` | Keeps per-file example MDX files in sync with the component registry | manual | maintenance | `node operations/scripts/generators/components/library/generate-component-examples.js [--scaffold] [--fix-imports] [--check]` | | `generate-component-index.js` | Reads docs-guide/config/component-registry.json (all components) + the component-usage map (where each is imported). For each top-level grouping (wrappers, config, scaffolding, displays, elements, etc.) emits an INDEX.md with the components in that group. Distinct from generate-component-library.js which emits the longer LIBRARY.md docs. Manual-use — not in dispatch-component-registry pipeline yet; tracked as follow-up. | manual | maintenance | `node operations/scripts/generators/components/library/generate-component-index.js [--dry-run] [--check] [--category elements]` | | `generate-component-library.js` | Reads docs-guide/config/component-registry.json + the component-usage map. Renders LIBRARY.md per top-level grouping plus a root index. Paired with generate-component-index.js (INDEX.md = short table; LIBRARY.md = full docs). Manual-use — not in dispatch-component-registry pipeline yet; tracked as follow-up. | manual | maintenance | `node operations/scripts/generators/components/library/generate-component-library.js [--dry-run] [--check] [--category elements]` | | `generate-component-registry.js` | Parses JSDoc from all component exports and produces component-registry.json. | P3, P5, P6 | maintenance | `node operations/scripts/generators/components/library/generate-component-registry.js [--validate-only]` | | `generate-component-snippets.js` | Reads the component registry, projects each entry into a VS Code snippet definition (prefix, body, description, params), writes .vscode/components.code-snippets. --check fails if the generated snippets file drifts from the registry source; --write regenerates. Tracked in operations/governance/config/generated-artifacts.json so pre-commit checks freshness on registry changes. | P3 | maintenance | `node operations/scripts/generators/components/library/generate-component-snippets.js [--check] [--write]` | | `generate-docs-guide-components-index.js` | Generates components-catalog.mdx in docs-guide/catalog/ from component-registry.json and component-usage-map.json. | P1 | governance | `node operations/scripts/generators/governance/catalogs/generate-docs-guide-components-index.js [--fix|--write|--check]` | | `generate-docs-guide-indexes.js` | Generates docs-guide workflow/template catalogs and optionally verifies freshness | P2 | governance | `node operations/scripts/generators/governance/catalogs/generate-docs-guide-indexes.js [flags]` | | `generate-docs-guide-pages-index.js` | Generates the docs-guide pages catalog | P2 | governance | `node operations/scripts/generators/governance/catalogs/generate-docs-guide-pages-index.js [flags]` | | `generate-docs-index.js` | Docs index generator — produces docs-index.json from v2 frontmatter and docs.json. Dual-mode: --check (enforcer) / --write (generator). Most-called script in the repo. | P3, P6 | maintenance | `node operations/scripts/generators/content/catalogs/generate-docs-index.js [flags]` | | `generate-glossary-companions.js` | Companion JSON generator — extracts SearchTable itemsList data from glossary MDX pages | P2 | maintenance | `node operations/scripts/generators/content/reference/generate-glossary-companions.js [--dry-run] [--check]` | | `generate-glossary.js` | Glossary generator — produces glossary data file from terminology sources | manual | maintenance | `node operations/scripts/generators/content/reference/generate-glossary.js [flags]` | | `generate-governance-map.js` | Reads GOVERNANCE.md markers from every root folder and produces a governance map report | manual | governance | `node operations/scripts/generators/governance/generate-governance-map.js [--write] [--check]` | | `generate-governance-map.js` | Walks all GOVERNANCE.md markers, validates links, detects staleness, and generates the governance map | manual | governance | `node operations/scripts/generators/governance/map/generate-governance-map.js [--write|--check|--json]` | | `generate-hero-background.js` | Generates the hero background PNG used at v2/index. Reads brand colour tokens from style.css, renders the gradient/pattern via Canvas or Puppeteer, writes to snippets/assets/media/hero/. Manual-use script — not in any dispatcher; run by hand when the brand updates. | manual | brand | `node operations/scripts/generators/media/generate-hero-background.js` | | `generate-hero-image.js` | Generates the hero foreground PNG/SVG used at v2/index. Reads brand assets + hero copy from config, renders via Puppeteer or Canvas, writes to snippets/assets/media/hero/. Pairs with generate-hero-background.js. Manual-use only — not wired to any dispatcher. | manual | brand | `node operations/scripts/generators/media/generate-hero-image.js` | | `generate-llms-files.js` | Reads docs.json navigation + per-page frontmatter (title, description, sidebarTitle). llms.txt = short index (one line per page). llms-full.txt = same index + first-paragraph excerpt per page. --check validates committed files match the regen output; --write regenerates. Pairs with dispatch-llms-files.js. | P3 | discoverability | `node operations/scripts/generators/ai/llm/generate-llms-files.js [--check|--write]` | | `generate-og-images.js` | Uses Puppeteer to render section-templated images at the OG canonical 1200x630 size with title/section overlay. Reads section labels and brand tokens from config, writes PNGs to snippets/assets/media/og-images/ plus a manifest JSON mapping route → image. Pairs with og-image-policy.js (the resolver consumers use) and dispatch-og-images.js. | manual | discoverability | `node operations/scripts/generators/content/seo/generate-og-images.js [--dry-run] [--only <locale:section-id|fallback>]` | | `generate-pages-index.js` | Pages index generator — generates and verifies section-style index.mdx files for v2 docs folders plus root aggregate index | manual | maintenance | `node operations/scripts/generators/content/catalogs/generate-pages-index.js [flags]` | | `generate-repo-governance-status.js` | Generates the top-level repo-governance map and status reports from the canonical steady-state registry. | manual | governance | `node operations/scripts/generators/governance/reports/generate-repo-governance-status.js [--write|--check]` | | `generate-root-governance-artifacts.js` | Generates root-governance projections from the canonical manifest, including .allowlist, the generated root map, and sync reports. | P3 | governance | `node operations/scripts/generators/governance/root/generate-root-governance-artifacts.js [--write|--check]` | | `generate-script-registry.js` | Generate the governed script registry from script headers so classification, catalogs, and script-docs enforcement share one derived source of truth. | manual | governance | `node operations/scripts/generators/governance/catalogs/generate-script-registry.js [--dry-run]` | | `generate-snippets-registry.js` | Generates the snippets root registry from the live snippets filesystem plus structured folder metadata embedded in snippets/guide.mdx. | P3 | governance | `node operations/scripts/generators/governance/catalogs/generate-snippets-registry.js [--write|--check]` | | `generate-ui-templates.js` | Generates the UI template catalog and VS Code snippets from canonical template/component sources. | manual | maintenance | `node operations/scripts/generators/components/library/generate-ui-templates.js [flags]` | | `new-script.js` | \$\{params.summary}\`, | manual | governance | \$\{cmd} \[flags]\`, | | `orchestrator-guides-research-review.test.js` | Tests orchestrator-guides-research-review\.js — validates live Orchestrators Guides tranche extraction, report summary helpers, and registry-drift detection for the research packet generator. | manual | | `node operations/tests/unit/orchestrator-guides-research-review.test.js` | | `seo-generator-safe.js` | Deprecated wrapper for the legacy safe SEO generator. Use the canonical OG generator workflow instead. | manual | seo-generator-safe.js | `node tools/scripts/dev/seo-generator-safe.js` | ## ✅ Validators | Script | Description | Pipeline | Concern | Usage | | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `.verify-large-change.sh` | Large change verifier — blocks or warns when a commit touches an unusually large number of files | manual | .verify-large-change.sh | `bash tools/scripts/verify/.verify-large-change.sh [flags]` | | `agent-write-admission.test.js` | Enforces narrow agent-write admission rules for staged or explicit files: no tracked local-only outputs and no undeclared root writes. | manual | | `node operations/tests/unit/agent-write-admission.test.js [--staged|--files a,b]` | | `ai-tools-registry.test.js` | Validates the AI-tools registry contract, full tracked ai-tools coverage, and the Wave 1 inventory source-of-truth boundary. | P1, P3 | | `node operations/tests/unit/ai-tools-registry.test.js [--staged|--files path[,path]]` | | `ai-tools-visual-library.test.js` | Validates that the canonical AI-tools visual library is current, complete, and synchronized with the repo workflow inventory. | P1, P3 | | `node operations/tests/unit/ai-tools-visual-library.test.js [--staged] [--files path[,path]]` | | `audit-script-inventory-repair-rules.test.js` | Tests audit-script-inventory repair hardening rules for judgement-field backfill and pipeline safety. | manual | | `node operations/tests/unit/audit-script-inventory-repair-rules.test.js` | | `audit-script-inventory.js` | Audit the governed script corpus and regenerate the canonical script inventory outputs from current headers and filesystem state. | P1 | governance | `node operations/scripts/validators/governance/pr/audit-script-inventory.js [--fix] [--dry-run] [--staged-only|--staged] [--files <path[,path...]>] [--quiet] [--json] [--md] [--output <dir>] [--verbose]` | | `authoring-tools.test.js` | Unit tests for repo-owned authoring tools — verifies MDX formatting and real-path completion/validation helpers. | P1, P3 | | `node operations/tests/unit/authoring-tools.test.js` | | `browser.test.js` | Puppeteer browser integration test — renders pages from docs.json and checks for console errors, load failures, and visual regressions | P1 | | `node operations/tests/integration/browser.test.js [flags]` | | `check-agent-docs-freshness.js` | \* @mode read-only | manual | governance | `node operations/scripts/validators/governance/compliance/check-agent-docs-freshness.js [--threshold <days>] [--json]` | | `check-agent-docs-freshness.test.js` | Tests the agent governance freshness validator against the canonical runtime file set. | P1, P3 | | `node operations/tests/unit/check-agent-docs-freshness.test.js` | | `check-anchor-usage.js` | Validates same-page anchor links in maintained v2 MDX files against heading IDs on the same page | manual | health | `node operations/scripts/validators/content/structure/check-anchor-usage.js [--json] [--scope <glob>]` | | `check-broken-links.js` | Delegates to page-links-audit.js which already implements the canonical link health check across v2 pages. This script provides the canonical entry point so dispatchers can call check-broken-links by stable name. | P3 | health | `node operations/scripts/validators/content/health/check-broken-links.js [--files <paths>|--staged|--full]` | | `check-companion-manifest.js` | check companion manifest | manual | governance | `node operations/scripts/validators/governance/ai/check-companion-manifest.js` | | `check-component-css.js` | Validates component files against component governance styling rules. | P3 | maintenance | `node operations/scripts/validators/components/library/check-component-css.js [--path snippets/components] [--staged] [--fix] [--help]` | | `check-component-docs.js` | Validates component JSDoc coverage, prop documentation, docs-entry coverage, and governance metadata. | P3 | maintenance | `node operations/scripts/validators/components/documentation/check-component-docs.js [--path snippets/components] [--base-ref docs-v2] [--staged] [--strict-governance] [--help]` | | `check-component-health.js` | Checks component library health: imports, exports, registry sync, and usage patterns | manual | maintenance | `node operations/scripts/validators/components/library/check-component-health.js [--check] [--report]` | | `check-component-immutability.js` | Flags modifications to existing component files in PR context. New files allowed. Modifications require approval label. | manual | governance | `node operations/scripts/validators/governance/pr/check-component-immutability.js --base-ref main` | | `check-component-props.js` | Enforces the prop-governance checks documented as 5.18-5.20, 5.22, 5.26-5.28, 5.34 in the canonical-data deps files. Reads v2/ MDX, applies the prop-pattern rules, emits violations with file:line evidence. JSON or Markdown report. Wired into dispatch-component-registry.js PR detect list. | P3 | maintenance | `node operations/scripts/validators/components/library/check-component-props.js [--scope=full|changed] [--json] [--md] [--help]` | | `check-component-props.test.js` | Unit tests for check-component-props.js validator. Tests each check function with inline MDX fixtures. | manual | | `node operations/tests/unit/check-component-props.test.js` | | `check-description-quality.js` | Validates English v2 frontmatter descriptions for SEO length, boilerplate openings, and duplicate reuse | manual | health | `node operations/scripts/validators/content/structure/check-description-quality.js [--path <repo-path>] [--strict]` | | `check-docs-guide-reference-freshness.js` | Checks docs-guide feature/reference pages for missing internal links, retired root references, unmanaged TODO markers, and missing evidence dates. | manual | governance | `node operations/scripts/validators/governance/compliance/check-docs-guide-reference-freshness.js [--json] [--include-reference]` | | `check-docs-path-sync.js` | Docs path sync validator — detects staged page moves that require docs.json or governed path reference rewrites. | manual | health | `node operations/scripts/validators/content/structure/check-docs-path-sync.js --staged` | | `check-double-headers.js` | Detects duplicate body H1 headings and opening paragraphs that repeat frontmatter title or description content. | manual | health | `node operations/scripts/validators/content/structure/check-double-headers.js [--staged|--file <path>|--files <a,b>] [--fix]` | | `check-folder-allowlist.js` | PR-time validator. For each folder containing a .allowlist file, lists actual entries and fails if any entry is not on the allowlist. Used as the layer-3 gate in the folder-allowlist prevention chain. | P3 | governance | `node operations/scripts/validators/governance/repo/check-folder-allowlist.js [--folder <path>] [--json]` | | `check-governance-approvals.js` | Validate governance-sensitive PR changes against the canonical approval policy, required labels, and PR-body evidence. | manual | governance | `node operations/scripts/validators/governance/pr/check-governance-approvals.js [--base-ref <branch>] [--files <path[,path...]>] [--json]` | | `check-governance-markers.js` | Validates GOVERNANCE.md presence in all required folders and checks link integrity | manual | governance | `node operations/scripts/validators/governance/compliance/check-governance-markers.js [--json]` | | `check-grammar-en-gb.js` | Deterministic UK English grammar checker for prose content. Reads rules from a closed enum (no LLM); applies only the rules with documented, unambiguous corrections. --fix performs the autofix for the safe subset. Skips code blocks, frontmatter, JSX comments, JSX attribute values, import/export lines. Exit non-zero if any violation detected. | P3, P6 | brand | `node operations/scripts/validators/content/grammar/check-grammar-en-gb.js [--scope full|changed] [--files <path[,path...]>] [--fix] [--strict]` | | `check-jsdoc-headers.js` | Validates that all JS files in governed locations have core JSDoc tags | manual | governance | `node operations/scripts/validators/governance/compliance/check-jsdoc-headers.js [--json]` | | `check-mdx-component-scope.js` | Validates MDX-facing component modules do not depend on private file-scope helper bindings from exported components. | manual | maintenance | `node operations/scripts/validators/components/library/check-mdx-component-scope.js [--files path[,path...]] [--staged]` | | `check-mdx-safe-markdown.js` | Validates first-party markdown and MDX content for repo-wide MDX-safe syntax, including parse failures and deterministic unsafe patterns. | manual | health | `node operations/scripts/validators/content/structure/check-mdx-safe-markdown.js [--staged|--files a,b] [--json]` | | `check-mintlify-canonical-sync.js` | Enforce the Mintlify canonical-sync contract so archived legacy sources stay moved, registered consumers stay updated, and retained-source logs match the registry. | manual | governance | `node operations/scripts/validators/governance/compliance/check-mintlify-canonical-sync.js [--staged] [--json]` | | `check-mintlify-canonical-sync.test.js` | Tests the Mintlify canonical-sync registry, validator, and remediator contract against the canonical cleanup surfaces. | P1, P3 | | `node operations/tests/unit/check-mintlify-canonical-sync.test.js [--staged]` | | `check-naming-conventions.js` | Validates active component filenames against directory-aware file naming and PascalCase exports under snippets/components. | manual | maintenance | `node operations/scripts/validators/components/library/check-naming-conventions.js [--path snippets/components] [--files path[,path...]] [--mode migration|strict-camel|strict-pascal]` | | `check-new-file-governance.js` | Validates newly staged files have required governance metadata (JSDoc, frontmatter, workflow headers) | P1 | governance | `node operations/scripts/validators/governance/compliance/check-new-file-governance.js [--all|--staged]` | | `check-no-ai-stash.sh` | Scans the working tree (excluding .gitignore'd paths) for known AI agent temporary file patterns. Exits non-zero if any found, listing the offenders. Called by .githooks/pre-commit and .githooks/pre-push. | P1, P2 | governance | `bash operations/scripts/validators/ai/codex/check-no-ai-stash.sh [flags]` | | `check-page-endings.js` | Validates that English v2 MDX pages end with an approved navigational or closing element | manual | health | `node operations/scripts/validators/content/structure/check-page-endings.js [--fix] [--json]` | | `check-pr-template.js` | Enforces that PR descriptions include required change and rationale sections before merge | P3 | governance | `PR_BODY="..." node operations/scripts/enforcers/pr/check-pr-template.js` | | `check-proper-nouns.js` | Reads canonical proper-noun rules from operations/tests/config/spell-dict.json. Scans prose for lowercase or wrong-case occurrences of governed proper nouns. Exit non-zero if any violation. Paired with repair-term-capitalisation.js for auto-fix. | P3 | brand | `node operations/scripts/validators/content/grammar/check-proper-nouns.js [--files <path[,path...]>] [--fix]` | | `check-repo-governance-sync.js` | Validates the canonical repo-governance registry, generated outputs, and referenced ownerless steady-state paths. | manual | governance | `node operations/scripts/validators/governance/compliance/check-repo-governance-sync.js [--json]` | | `check-root-governance-sync.js` | Validates that root-governance generated outputs, required documentation references, and public root artifact declarations stay aligned with the canonical manifest. | manual | governance | `node operations/scripts/validators/governance/compliance/check-root-governance-sync.js [--json]` | | `check-script-locations.js` | Validates all JS files are in governed locations per the script framework | manual | governance | `node operations/scripts/validators/governance/compliance/check-script-locations.js [--json]` | | `check-translation-freshness.js` | Compares modification dates of source pages to translations, flags stale translations | manual | integrations | `node operations/scripts/validators/content/language-translation/check-translation-freshness.js [--json]` | | `check-voice-register.js` | Checks MDX pages with audience frontmatter for prohibited phrases from the wrong voice register | manual | brand | `node operations/scripts/validators/content/copy/check-voice-register.js [--json]` | | `check-wcag.js` | PR-time advisory validator. Wraps the WCAG audit engine in --no-fix mode and reports blocking findings (impact level configurable). Exits non-zero if blocking violations are found. | P3 | health | `node operations/scripts/validators/content/health/check-wcag.js [--files <path[,path...]>] [--staged] [--full] [--fail-impact minor|moderate|serious|critical] [--json]` | | `check-workflow-governance.js` | Checks every .github/workflows/\*.yml for: (1) governance comment headers | manual | governance | `node operations/scripts/validators/governance/pr/check-workflow-governance.js [--check|--json|--fix-audit]` | | `check-workflow-headers.js` | Validates that GitHub Actions workflow YAML files have governance comment headers | manual | governance | `node operations/scripts/validators/governance/compliance/check-workflow-headers.js [--json]` | | `cli-guardrails.test.js` | Tests i18n CLI guardrails — validates argument validation and safety checks | manual | content | `node operations/scripts/i18n/test/cli-guardrails.test.js [flags]` | | `codex-commit.test.js` | Tests codex-commit.js — validates commit message generation and contract compliance | manual | | `node operations/tests/unit/codex-commit.test.js [flags]` | | `codex-skill-sync.test.js` | Tests sync-codex-skills.js — validates skill file and companion bundle synchronisation between sources | manual | | `node operations/tests/unit/codex-skill-sync.test.js [flags]` | | `component-governance-generators.test.js` | Verifies component governance generators produce coherent registry, usage-map, and docs outputs. | P1 | | `node operations/tests/unit/component-governance-generators.test.js` | | `component-governance-utils.test.js` | Verifies shared component governance utility parsing, scanning, and archive exclusion behavior. | P1 | | `node operations/tests/unit/component-governance-utils.test.js` | | `component-layout-governance.js` | Component layout governance validator — checks v2 page layouts against approved component contracts | manual | maintenance | `node operations/scripts/validators/components/library/component-layout-governance.js [flags]` | | `contracts-addresses-pipeline.test.js` | Regression tests for the contracts proof catalog, generated registry output, shared contracts surface wiring, blocking anomaly behavior, workflow cadence alignment, and route freshness dependencies. | P1 | | `node operations/tests/unit/contracts-addresses-pipeline.test.js` | | `contracts-view-model.test.js` | Focused regression tests for the shared contracts view-model helper surface. | P3 | | `node operations/tests/unit/contracts-view-model.test.js` | | `copy-lint.test.js` | Copy lint unit suite — validates fixture-driven copy-governance checks and runs changed-file scoped lint aggregation for authored docs pages. | P1, P3 | | `node operations/tests/unit/copy-lint.test.js [--staged] [--files <a,b,c>]` | | `dispatch-concern-simulation.js` | Loads each .github/workflows/dispatch-\{concern}.yml, parses the YAML, walks each job's steps, extracts the dispatcher scripts referenced, verifies each exists and exposes the modes/flags the workflow uses. For each job, runs the referenced dispatcher's --help to confirm its CLI is wired. This is the local equivalent of pushing each workflow to GitHub and watching it parse — what 5.4 of the GitHub Actions Governance plan calls "end-to-end CI dry-run". | P3 | governance | `node operations/tests/integration/dispatch-concern-simulation.js [--concern <name>]` | | `docs-authoring-rules.test.js` | Verifies guide-layout warning rules and deterministic code-block icon repair for authored docs pages. | P1 | | `node operations/tests/unit/docs-authoring-rules.test.js` | | `docs-fact-registry.js` | Docs fact registry validator — validates repo-native research claim registries and provides normalized claim-family data for the manual research runner. | manual | health | `node operations/scripts/audits/content/veracity/docs-fact-registry.js [flags]` | | `docs-fact-registry.test.js` | Tests docs-fact-registry.js — validates claim-family registry schema checks and normalized loading by domain. | manual | | `node operations/tests/unit/docs-fact-registry.test.js [flags]` | | `docs-guide-sot.test.js` | Validates docs-guide source-of-truth coverage, README pointers, and generated index freshness | P1, P2, P3 | | `node operations/tests/unit/docs-guide-sot.test.js [flags]` | | `docs-json-localizer.test.js` | Tests docs-json-localizer — validates locale docs.json transformation logic | manual | content | `node operations/scripts/i18n/test/docs-json-localizer.test.js [flags]` | | `docs-navigation.test.js` | Validates docs.json page-entry syntax, reports missing routes, warns on orphaned canonical v2 pages, suggests remaps, and optionally applies approved remaps | P1, P3, P6 | | `node operations/tests/unit/docs-navigation.test.js [flags]` | | `docs-page-research.test.js` | Tests docs-page-research.js — validates claim extraction, contradiction detection, and evidence-source adapters for the experimental research runner. | manual | | `node operations/tests/unit/docs-page-research.test.js [flags]` | | `docs-page-scope.test.js` | Verifies generated authored-page scope helpers so warning-only validators skip generated docs pages while keeping authored pages in scope. | P1 | | `node operations/tests/unit/docs-page-scope.test.js` | | `docs-path-sync.test.js` | Unit tests for docs path sync — validates staged move detection, deterministic docs.json/reference rewrites, validator behavior, and remediator write mode. | P1, P3 | | `node operations/tests/unit/docs-path-sync.test.js` | | `docs-research-adjudication.test.js` | Tests docs-research-adjudication.js — validates adjudication-ledger schema, report-aware outcome recording, and trust-tier summary rules for measured research-skill review outcomes. | manual | | `node operations/tests/unit/docs-research-adjudication.test.js [flags]` | | `docs-route-scope.test.js` | Verifies docs.json-derived tab and group route scopes resolve to live files. | P1 | | `node operations/tests/unit/docs-route-scope.test.js` | | `domain-pages-audit.js` | Audits deployed docs page HTTP status codes (v1, v2, or both) and emits a stable JSON report | manual | | `node operations/tests/integration/domain-pages-audit.js [flags]` | | `enforce-generated-file-banners.js` | Validates "do not edit" banners and i18n parity on generated MDX files. Generator dispatch split to sync-generated-files.js. | P1 | health | `node operations/scripts/validators/content/structure/enforce-generated-file-banners.js --check [--staged]` | | `export-portable-skills.test.js` | Tests export-portable-skills.js — validates portable skill export packs from canonical templates. | P1, P3 | | `node operations/tests/unit/export-portable-skills.test.js [flags]` | | `frontmatter-taxonomy.test.js` | Verifies shared docs frontmatter taxonomy normalization and purpose mapping. | P1 | governance | `node operations/tests/unit/frontmatter-taxonomy.test.js` | | `frontmatter.test.js` | Tests frontmatter parser — validates frontmatter read/write roundtrip | manual | content | `node operations/scripts/i18n/test/frontmatter.test.js [flags]` | | `generated-artifacts-policy.test.js` | Tests generated artifact governance manifest — validates enums, path matching, and hook-policy expectations | manual | | `node operations/tests/unit/generated-artifacts-policy.test.js` | | `governance-approval-policy.test.js` | Tests the production governance approval policy and PR approval validator scenarios. | P3 | | `node operations/tests/unit/governance-approval-policy.test.js` | | `imports-cli.test.js` | Unit tests for imports.test.js — validates CLI arg parsing, import resolution, and markdown exclusion. | manual | | `node operations/tests/unit/imports-cli.test.js` | | `imports.test.js` | Compatibility wrapper for page-imports-audit.js that preserves the legacy imports.test surface while delegating to the canonical operations audit. | P1, P3 | health | `node operations/tests/unit/imports.test.js [--dry-run] [--scope routable-v2|repo] [--staged] [--files <paths>]` | | `links-cli.test.js` | Unit tests for links.test.js — validates CLI arg parsing, JSX href detection, and repo-scope markdown handling. | manual | | `node operations/tests/unit/links-cli.test.js` | | `links-imports.test.js` | Compatibility alias for links.test.js that preserves the legacy links-imports entrypoint while delegating to the link-only validator. | P1, P3 | health | `node operations/tests/unit/links-imports.test.js [--dry-run] [--scope routable-v2|repo] [--staged] [--files <paths>]` | | `links.test.js` | Fast link validator for staged and repo-scoped markdown/MDX checks, with explicit file-read failures and JSX href detection for local validation lanes. | P1, P3 | health | `node operations/tests/unit/links.test.js [--dry-run] [--scope routable-v2|repo] [--staged] [--files <paths>]` | | `lint-copy.js` | Reads the two canonical lists (10 banned words + 17 banned phrases from the CLAUDE.md voice rules) and scans v2 MDX for occurrences. Exit non-zero on any hit. No auto-fix — banned terms require manual rewrite via the rolling-issue model. Pairs with dispatch-banned-words.js. | P3, P5 | brand | `node operations/scripts/validators/content/copy/lint-copy.js [--files <paths>|--staged|--full]` | | `lint-patterns.js` | Pairs with check-voice-register.js. Where check-voice-register detects prohibited phrases, lint-patterns detects structural pattern violations (e.g. unnecessary qualifiers, hedging openers, indirect constructions). Exit non-zero on any hit. Used by dispatch-voice-register.js as the secondary detector. | P3 | brand | `node operations/scripts/validators/content/copy/lint-patterns.js [--files <paths>|--staged|--full]` | | `lint-structure.js` | Enforce structural rules on MDX content files. | manual | health | `node operations/scripts/validators/content/structure/lint-structure.js [file] [flags]` | | `mdx-component-runtime-smoke.js` | Smoke-tests sentinel MDX routes for runtime component failures, focused on page-killing render errors from MDX-imported JSX modules. | manual | | `node operations/tests/integration/mdx-component-runtime-smoke.js [--routes route[,route...]] [--base-url http://localhost:3000]` | | `mdx-component-runtime-smoke.test.js` | Unit tests for the MDX runtime smoke helpers — covers arg parsing, sentinel route selection, trigger logic, and failure classification. | manual | | `node operations/tests/unit/mdx-component-runtime-smoke.test.js` | | `mdx-component-scope.test.js` | Unit tests for the MDX-facing component scope validator — covers unsafe private helpers, safe inline logic, and imported helper patterns. | manual | | `node operations/tests/unit/mdx-component-scope.test.js` | | `mdx-guards.test.js` | Enforces MDX guardrails — globals imports, math delimiters, markdown table line breaks | P1, P3 | | `node operations/tests/unit/mdx-guards.test.js [flags]` | | `mdx-safe-markdown.test.js` | Fixture-driven unit tests for repo-wide MDX-safe markdown repair and validation helpers. | P1 | | `node operations/tests/unit/mdx-safe-markdown.test.js` | | `mdx-translate.test.js` | Tests MDX translation — validates content block translation logic | manual | content | `node operations/scripts/i18n/test/mdx-translate.test.js [flags]` | | `mdx.test.js` | Validates MDX syntax and structure — checks for parse errors, invalid JSX, broken components | P1, P3 | | `node operations/tests/unit/mdx.test.js [flags]` | | `migrate-assets-to-branch.test.js` | Unit tests for migrate-assets-to-branch.js — validates CLI defaults, ambiguous basename detection, deterministic rewrites, and end-to-end branch migration in a temp git repo | manual | | `node operations/tests/unit/migrate-assets-to-branch.test.js` | | `og-image-policy.test.js` | Unit tests for og-image-policy — validates route mapping, locale asset selection, fallback assignment, and URL guardrails. | manual | | `node operations/tests/unit/og-image-policy.test.js [flags]` | | `openapi-reference-audit.js` | Comprehensive OpenAPI spec validation — checks references, schemas, examples. Supports --strict (validate), --fix (repair), and report modes. | P2, P3, P5, P6 | | `node operations/tests/integration/openapi-reference-audit.js [flags]` | | `openapi-reference-audit.test.js` | Unit tests for openapi-reference-audit.js — tests individual audit rules and fix logic | manual | | `node operations/tests/unit/openapi-reference-audit.test.js [flags]` | | `openapi-rolling-issue.test.js` | Tests OpenAPI rolling issue tracker — validates issue creation and dedup logic | manual | | `node operations/tests/unit/openapi-rolling-issue.test.js [flags]` | | `ownerless-governance.test.js` | Validates the ownerless governance manifest, primary gate-layer contract, and forbidden human-owner dependency in governed policy and GitHub surfaces. | P1, P3 | | `node operations/tests/unit/ownerless-governance.test.js [--staged|--files a,b]` | | `page-imports-audit.test.js` | Tests page-imports-audit.js — validates forbidden React imports, missing JSON imports, and output-dir parsing. | manual | | `node operations/tests/unit/page-imports-audit.test.js` | | `page-integrity-dispatch.test.js` | Tests page-integrity-dispatch.js — validates repair sequencing across page links and page imports on a temporary v2 fixture. | manual | | `node operations/tests/unit/page-integrity-dispatch.test.js` | | `page-integrity-rolling-issue.test.js` | Tests page integrity rolling issue helper — validates dedup, issue action selection, and issue body structure. | manual | | `node operations/tests/unit/page-integrity-rolling-issue.test.js` | | `pipeline-functional-tests.js` | Runs synthetic-violation cycles against the 10 foundational pipeline dispatchers. Each test drops a known-bad fixture, runs detect, asserts the violation is found, runs repair (where supported), asserts the violation is gone, re-runs detect to verify clean. Honest exit codes — non-zero if any pipeline cannot prove its lifecycle. | P3, P5 | governance | `node operations/tests/integration/pipeline-functional-tests.js [--only <name>] [--json]` | | `pipeline-smoke-test.js` | Discovers every dispatch-\{niche}.js under operations/scripts/dispatch/, runs each in safe mode, captures exit codes, reports pass/fail summary. Foundational test that asserts the architecture is wired correctly. Functional depth (synthetic violations + repair + verify cycles) lives in per-pipeline tests under operations/tests/integration/dispatch-\*.test.js. | manual | governance | `node operations/tests/integration/pipeline-smoke-test.js [--json]` | | `post-remediation-verify.test.js` | 10 test cases covering registry loading, file substitution, per-file | manual | governance | `node operations/tests/unit/post-remediation-verify.test.js` | | `precommit-staged-cache.test.js` | Tests precommit-staged-cache.js — validates staged-tree cache hits, invalidation, and pruning | P1 | | `node operations/tests/unit/precommit-staged-cache.test.js` | | `provenance.test.js` | Tests provenance tracker — validates translation provenance recording | manual | content | `node operations/scripts/i18n/test/provenance.test.js [flags]` | | `provider-openrouter.test.js` | Tests OpenRouter provider — validates API call logic and response parsing | manual | content | `node operations/scripts/i18n/test/provider-openrouter.test.js [flags]` | | `quality.test.js` | Content quality checks — validates frontmatter completeness, thin content detection, placeholder flagging | P1, P3 | | `node operations/tests/unit/quality.test.js [flags]` | | `regression-bisect.js` | Uses git bisect with an automated Puppeteer test to binary-search | manual | health | `node operations/scripts/validators/content/structure/regression-bisect.js --route /v2/path --error "ReferenceError" [--good abc123] [--bad HEAD]` | | `remediate-styles.test.js` | Unit tests for deterministic style remediations, including audit-category aliases. | P1, P3 | | `node operations/tests/unit/remediate-styles.test.js` | | `repair-governance.test.js` | Tests repair-governance.js for safe dry-run, fix, rollback, strict exit handling, and workflow contract coverage. | manual | | `node operations/tests/unit/repair-governance.test.js` | | `repair-spelling.test.js` | Unit tests for repair-spelling.js — validates deterministic spelling fixes and exclusion ranges | manual | | `node operations/tests/unit/repair-spelling.test.js [flags]` | | `repo-audit-pipeline.test.js` | Tests repo-audit-orchestrator.js pipeline — validates mode/scope combinations and report output | manual | | `node operations/tests/unit/repo-audit-pipeline.test.js [flags]` | | `repo-governance-sync.test.js` | Tests the top-level repo-governance registry, generated map and status outputs, and sync validator. | P3 | | `node operations/tests/unit/repo-governance-sync.test.js` | | `review-governance-repair-checklist.js` | Generates a review checklist for dry-run governance repair proposals that require human approval before fix mode is applied. | manual | governance | `node operations/scripts/validators/governance/compliance/review-governance-repair-checklist.js [--output <dir>] [--json] [--md]` | | `root-allowlist-format.test.js` | Validates that .allowlist stays machine-readable, root-only, and aligned with the canonical root-governance manifest. | P1, P3 | | `node operations/tests/unit/root-allowlist-format.test.js` | | `root-governance-sync.test.js` | Tests the canonical root-governance manifest, generated projections, and sync validator. | P3 | | `node operations/tests/unit/root-governance-sync.test.js` | | `run-pr-checks.test.js` | Tests run-pr-checks lane parsing, branch-health registry coverage, and incremental summary/progress behavior. | manual | | `node operations/tests/unit/run-pr-checks.test.js` | | `script-docs.test.js` | Enforces script header schema, keeps group script indexes in sync, and builds aggregate script catalog | P1, P3 | | `node operations/tests/unit/script-docs.test.js [flags]` | | `skill-docs.test.js` | Validates governed skill documentation frontmatter, references, and contract integrity for canonical templates and local skill files. | P1, P3 | | `node operations/tests/unit/skill-docs.test.js [--staged] [--files path[,path]]` | | `snippets-root-governance.test.js` | Validates the governed two-file snippets root model and enforces freshness for the generated snippets registry. | P3 | | `node operations/tests/unit/snippets-root-governance.test.js` | | `spelling.test.js` | Spelling check — validates content against custom dictionary with en-GB rules | P1, P3 | | `node operations/tests/unit/spelling.test.js [flags]` | | `style-guide.test.js` | Style guide compliance — checks en-GB conventions, heading case, formatting rules | P1, P3 | | `node operations/tests/unit/style-guide.test.js [flags]` | | `sweep-console-errors.js` | Visits every v2 route registered in docs.json, captures HTTP status, | manual | health | `node operations/scripts/validators/content/structure/sweep-console-errors.js [--update-baseline] [--routes /v2/a,/v2/b] [--base-url http://localhost:3000]` | | `sweep-delta-report.js` | Runs a full-site (or targeted) Puppeteer sweep, loads the existing baseline, | manual | health | `node operations/scripts/validators/content/structure/sweep-delta-report.js [--update-baseline] [--routes /v2/a,/v2/b] [--base-url http://localhost:3000]` | | `TEMPLATE.test.js` | Template for category-scoped component unit tests. | manual | | `node operations/tests/unit/components/TEMPLATE.test.js` | | `test-mintlify-version-language-toggle.js` | test mintlify version language toggle | manual | content | `node operations/scripts/i18n/test-mintlify-version-language-toggle.js [flags]` | | `test-scripts.sh` | Iterates the snippet scripts directory, runs each with --help (or equivalent), checks exit code is 0, captures stderr, reports a pass/fail summary. Manual-use only; not wired to a dispatcher. Documented in docs-guide/tooling/lpd-cli.mdx as a contributor workflow. | manual | governance | `bash operations/scripts/snippets/test-scripts.sh [flags]` | | `test-v2-pages.js` | Puppeteer-driven browser tester. Reads docs.json for the route list, navigates each in headless Chrome, waits for body content, checks for console errors / network failures / missing components. Used by dispatch-page-rendering.js as the rendering atomic. Also called directly by v2-wcag-audit.js (which loads each page then runs axe-core) and browser.test.js. | P3 | health | `node operations/scripts/validators/content/structure/test-v2-pages.js [--routes <comma-list>] [--full]` | | `ui-template-generator.test.js` | Validates UI template artifacts, canonical template MDX safety, and Mint parse-surface boundaries before mint dev encounters them | P1, P3 | | `node operations/tests/unit/ui-template-generator.test.js [flags]` | | `update-livepeer-release.test.js` | Verifies the go-livepeer release updater writes the canonical release data module shape. | P2 | | `node operations/tests/unit/update-livepeer-release.test.js` | | `v2-folder-governance-cleanup-matrix.test.js` | Unit tests for the v2 folder governance cleanup matrix generator — verifies core classification, targeting, and age-bucket rules. | manual | | `node operations/tests/unit/v2-folder-governance-cleanup-matrix.test.js` | | `v2-link-audit.js` | Compatibility wrapper for page-links-audit.js that preserves the legacy v2-link-audit entrypoint while delegating to the canonical operations audit. | P1, P5, P6 | health | `node operations/tests/integration/v2-link-audit.js [flags]` | | `v2-link-audit.selftest.js` | Self-test suite for v2-link-audit.js — validates audit logic against known fixtures | manual | | `node operations/tests/integration/v2-link-audit.selftest.js [flags]` | | `v2-link-audit.test.js` | Unit tests for v2-link-audit.js — tests individual link checking rules | manual | | `node operations/tests/unit/v2-link-audit.test.js [flags]` | | `v2-wcag-audit.js` | WCAG accessibility audit for v2 pages — checks heading hierarchy, alt text, ARIA. Supports --fix mode for auto-repair. | P1 | | `node operations/tests/integration/v2-wcag-audit.js [flags]` | | `v2-wcag-audit.selftest.js` | Self-test suite for v2-wcag-audit.js — validates WCAG audit logic against known fixtures | manual | | `node operations/tests/integration/v2-wcag-audit.selftest.js [flags]` | | `v2-wcag-audit.test.js` | Unit tests for v2-wcag-audit.js — tests individual WCAG rules | manual | | `node operations/tests/unit/v2-wcag-audit.test.js [flags]` | | `validate-ai-tools-registry.js` | Validate the AI-tools registry contract and coverage so ownerless governance and AI subsystem inventory stay aligned. | manual | governance | `node operations/scripts/validators/governance/compliance/validate-ai-tools-registry.js [--check] [--coverage] [--lanes] [--write-report]` | | `validate-codex-task-contract.js` | Codex task contract enforcer — validates branch naming, task files, PR body, and issue state for codex branches | P1, P2, P3 | governance | `node operations/scripts/validators/governance/compliance/validate-codex-task-contract.js [flags]` | | `validate-codex-task-contract.test.js` | Tests validate-codex-task-contract.js — validates contract checking logic | manual | | `node operations/tests/unit/validate-codex-task-contract.test.js [flags]` | | `validate-locks.js` | Pre-push validator for Codex sessions. Checks .codex/locks-local/ for lock files, validates each lock's task ID matches the current branch's codex/\* prefix, validates each lock's age is within session-lifetime threshold. Exits non-zero on stale or foreign locks. Called by .githooks/pre-push for codex/\* branches. | P1, P2 | governance | `node operations/scripts/validators/ai/codex/validate-locks.js [flags]` | | `validate-lpd-paths.js` | Validates that every script path referenced in `lpd` exists on disk. Parses the lpd bash CLI for node and script\_path invocations and checks each file against the filesystem. Exits non-zero if any path is missing. | manual | governance | `node operations/scripts/validators/governance/repo/validate-lpd-paths.js [--json]` | | `verify-all-pages.js` | Loads component-library routes in a headless browser and fails on render, console, or 404 issues. | manual | health | `node operations/scripts/validators/content/structure/verify-all-pages.js` | | `verify-pay-orc-gate-finalize.sh` | Payment/orchestrator gate verifier — checks payment and orchestrator documentation gate conditions | manual | governance | `bash operations/scripts/validators/governance/compliance/verify-pay-orc-gate-finalize.sh [flags]` | | `verify-pipeline-end-to-end.js` | Reads workspace/reports/governance/pipeline-inventory.json. For every entry not on the infrastructure-dependent exclusion list, spawns the dispatcher with --mode pr --dry-run and a 90s timeout. Captures exit code + last 400 chars of combined output. Applies drift-signal regex (stale generated file, missing companion, "out of date" reports) to classify exit-1 as drift-detected (working pipeline + stale repo state) vs fail (real bug). Writes back into pipeline-inventory.json under each row's `verification` block + emits workspace/reports/governance/pipeline-verification.md with summary + failures section. | manual | governance | `node operations/scripts/validators/governance/pipelines/verify-pipeline-end-to-end.js [--concern <name>] [--timeout <ms>] [--limit <N>]` | | `vsix-parity.test.js` | Unit tests for repo-owned VS Code extension packaging parity — verifies the checked-in VSIX matches governed source files and stale artifacts are detected deterministically. | P1, P3 | | `node operations/tests/unit/vsix-parity.test.js` | ## 🔧 Remediators | Script | Description | Pipeline | Concern | Usage | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-framework-headers.js` | Inserts or extends framework headers on all repo scripts from classification data. | manual | governance | `node operations/scripts/remediators/content/classification/add-framework-headers.js --data script-classifications.json --dry-run` | | `add-pagetype-mechanical.js` | Mechanically assigns pageType frontmatter to eligible v2 MDX pages. | manual | governance | `node operations/scripts/remediators/content/classification/add-pagetype-mechanical.js [flags]` | | `add-workflow-governance-headers.js` | Adds governance comment headers to GitHub Actions workflow YAML files based on their governed filename pattern | manual | governance | `node operations/scripts/remediators/governance/compliance/add-workflow-governance-headers.js [--dry-run|--write]` | | `assign-purpose-metadata.js` | Purpose metadata assigner — fills purpose and audience frontmatter for routable v2 pages | manual | governance | `node operations/scripts/remediators/content/classification/assign-purpose-metadata.js [flags]` | | `backfill-vague-purpose.js` | Reads the SME audit's flagged-list JSON, opens each script, finds the existing @purpose line in the JSDoc block, replaces the value with a sentence built from the @description tag (if present) prefixed by the canonical verb for the @type (Detect / Validate / Repair / Generate / Audit / Dispatch / Integrate). Skips scripts whose @description is too short to make a useful purpose. --dry-run preview; --write apply. | manual | governance | `node operations/scripts/remediators/governance/scaffold/backfill-vague-purpose.js [--dry-run|--write] [--input <path>] [--limit <N>]` | | `batch-update-og-image.sh` | Deprecated wrapper for the legacy bulk OG image replacement helper. Use the canonical OG generator workflow instead. | manual | batch-update-og-image.sh | `bash tools/scripts/dev/batch-update-og-image.sh` | | `fix-usage-paths.js` | fix usage paths | manual | governance | `*/` | | `generate-seo.js` | Content-analysis-based SEO frontmatter generator. Reads each v2 .mdx file, parses frontmatter, and for missing/low-quality title/description/keywords writes a derived value into a frontmatter patch. --dry-run shows proposed patches; --write applies them and runs --verify to re-check. Pairs with dispatch-seo-metadata.js. | P3, P6 | discoverability | `node operations/scripts/remediators/content/seo/generate-seo.js [--dry-run|--write] [--verify] [--files <paths>]` | | `migrate-assets-to-branch.js` | Reads the media-audit manifest, migrates flagged assets to docs-v2-assets, and rewrites MDX/JSX references to raw GitHub URLs. | manual | health | `node operations/scripts/remediators/content/repair/migrate-assets-to-branch.js --manifest workspace/reports/media-audit/media-audit-manifest.json --target migrate_r2,migrate_cloudinary --dry-run` | | `normalise-frontmatter-keys.js` | Normalises capitalised frontmatter YAML keys to lowercase canonical form across v2 MDX pages. | manual | governance | `node operations/scripts/remediators/content/classification/normalise-frontmatter-keys.js [--dry-run] [--write] [--staged] [--files path,path]` | | `quarantine-manager.js` | Quarantine manager — classifies files for quarantine (default) or applies quarantine moves (--apply) | manual | health | `node operations/scripts/remediators/content/repair/quarantine-manager.js [flags]` | | `remediate-em-dashes.js` | Scans content text and user-facing frontmatter keys (title, sidebarTitle, description) for U+2014. Skips other frontmatter keys, code blocks, inline code, JSX comments, import/export lines, and JSX attribute values. --verify re-runs detection after write and reverts any file that still contains an em-dash. Pairs with dispatch-em-dashes.js. | P6 | brand | `node operations/scripts/remediators/content/style/remediate-em-dashes.js [--dry-run|--write] [--verify] [--staged] [--files path,path]` | | `remediate-frontmatter-quotes.js` | Decodes YAML single-quoted strings (including ''-escaped apostrophes) and re-encodes them as double-quoted strings, escaping internal double quotes and backslashes. Skips multi-line block scalars (\| or >), explicit YAML tags, sequences, and mappings. Wired into the PostToolUse:Edit\|Write hook so every MDX edit is normalised automatically. | P2, P6 | brand | `node operations/scripts/remediators/content/style/remediate-frontmatter-quotes.js [--dry-run|--write] [--verify] [--staged] [--files path,path]` | | `remediate-us-spelling.js` | Default direction: US → UK. Use --language en-us to reverse. Skips frontmatter, code blocks, inline code, JSX comments, import/export lines, URLs, and JSX attribute values. --verify re-runs the spelling check after write and reverts any file that still has US forms. Pairs with dispatch-spelling.js. | P6 | brand | `node operations/scripts/remediators/content/style/remediate-us-spelling.js [--dry-run|--write] [--verify] [--language en-gb|en-us] [--staged] [--files path,path]` | | `remediate-voice-violations.js` | Pairs with check-voice-register.js. Applies safe deterministic rewrites only — universal phrase replacements plus audience-keyed deletions (orchestrator, gateway, developer). Skips code blocks, frontmatter, and JSX comments. Ambiguous cases stay flagged for human review via rolling-issue. Supports --dry-run preview and --verify (re-runs check after fix, reverts regressions per file). | P6 | brand | `node operations/scripts/remediators/content/style/remediate-voice-violations.js [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `repair-ai-discoverability.js` | Repair AI discoverability compliance: add missing @aiDiscoverability tags to hook-using components, create placeholder companion JSON files. | manual | maintenance | `node operations/scripts/remediators/components/library/repair-ai-discoverability.js [--dry-run] [--write] [--staged]` | | `repair-anchor-usage.js` | Pairs with check-anchor-usage.js. For each broken anchor link [text](#slug), reads the target page's H1-H6 headings, computes their slugs, and if a unique fuzzy match exists (>= 0.8 similarity), rewrites the anchor. Ambiguous matches stay flagged for human review. | P6 | health | `node operations/scripts/remediators/content/structure/repair-anchor-usage.js [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `repair-broken-links.js` | Pairs with check-broken-links. Reads page-links-audit findings, attempts canonical path rewrites for internal v2/ links that match a moved/renamed page registered in docs.json. External link repairs (redirect resolution) are not in scope here. | P6 | health | `node operations/scripts/remediators/content/health/repair-broken-links.js [--dry-run|--write] [--files <paths>|--staged]` | | `repair-component-metadata.js` | Auto-repairs derived JSDoc metadata fields from repo state. Safe fields only. Mirrors AUDIT-00 --fix pattern for components. | P6 | maintenance | `node operations/scripts/remediators/components/library/repair-component-metadata.js [--dry-run] [--fix] [--staged]` | | `repair-component-styles.js` | Repair JSX component style violations: extract inline styles to named const, move top-level constants inside function body. | manual | maintenance | `node operations/scripts/remediators/components/library/repair-component-styles.js [--dry-run] [--write] [--staged]` | | `repair-content-quality.js` | Pairs with docs-quality-and-freshness-audit. Removes orphan single-line TODO/FIXME comments at end of file. Anything that requires judgment (thin pages, stale content) escalates via rolling-issue. | P6 | health | `node operations/scripts/remediators/content/quality/repair-content-quality.js [--write] [--files <paths>|--staged]` | | `repair-description-quality.js` | Pairs with check-description-quality.js. Trims boilerplate openings ("This page describes", "This document covers", "Learn how to"), normalises trailing punctuation, flags too-short (\<80) and too-long (>160) descriptions for human review. | P6 | health | `node operations/scripts/remediators/content/structure/repair-description-quality.js [--dry-run|--write] [--files <paths>|--staged|--full]` | | `repair-folder-allowlist.js` | Reads each governed folder's .allowlist, identifies drift, archives drift via git mv to \{folder}/x-archive/. Supports --dry-run preview and --verify (re-runs check after repair, asserts drift count = 0). | P6 | governance | `node operations/scripts/remediators/governance/repo/repair-folder-allowlist.js [--dry-run|--write] [--verify] [--folder <path>]` | | `repair-governance-artifacts.js` | Regenerates governance map, updates lastVerified dates on verified frameworks, and reports unfixable issues | manual | governance | `node operations/scripts/remediators/governance/compliance/repair-governance-artifacts.js [--dry-run|--write]` | | `repair-lint-structure.js` | Pairs with lint-structure.js. Applies deterministic whitespace + spacing fixes only. Anything requiring judgment (heading-level reorganisation) stays flagged for human review. | P6 | health | `node operations/scripts/remediators/content/structure/repair-lint-structure.js [--write] [--files <paths>|--staged|--full]` | | `repair-mdx-safe-markdown.js` | Auto-repairs deterministic MDX-unsafe markdown patterns across first-party markdown and MDX content. | manual | health | `node operations/scripts/remediators/content/repair/repair-mdx-safe-markdown.js --dry-run [--staged|--files a,b]` | | `repair-openapi-reference.js` | Pairs with openapi-reference-audit. On detected drift between live API spec and committed reference docs, invokes generate-api-docs.sh against each tracked spec to regenerate the v2 API reference pages. PR is opened by the workflow layer after successful regen. | P6 | health | `node operations/scripts/remediators/content/health/repair-openapi-reference.js [--dry-run|--write]` | | `repair-ownerless-language.js` | Applies a closed list of deterministic 1:1 phrase rewrites (e.g. "Awaiting maintainer triage" → "Awaiting repository routing", "policy ownership" → "policy layering") to a fixed set of governed contributor surfaces. Reads no external rules — the phrase map is hard-coded for auditability. Pairs with dispatch-ownerless-language.js. | P3, P6 | copy | `node operations/scripts/remediators/content/style/repair-ownerless-language.js [--check|--write] [--files a,b]` | | `repair-page-imports.js` | Repair only proven-safe page import failures from canonical operations scripts while leaving ambiguous import issues unchanged for review. | manual | health | `node operations/scripts/remediators/content/repair/repair-page-imports.js [--dry-run|--write] [--files <paths>] [--output-dir <dir>]` | | `repair-page-links.js` | Repair deterministic page-link path issues from canonical operations scripts while leaving ambiguous targets unchanged for review. | manual | health | `node operations/scripts/remediators/content/repair/repair-page-links.js --dry-run --files v2/about --report-dir operations/reports/health/page-links` | | `repair-relative-page-hrefs.js` | Preserve the legacy relative-href repair command while the canonical implementation lives under repair-page-links.js. | manual | health | `node operations/scripts/remediators/content/repair/repair-relative-page-hrefs.js [flags]` | | `repair-script-inventory.js` | Repairs script headers and classification data. Thin wrapper that runs audit-script-inventory with --fix. Split from audit-script-inventory.js. | manual | governance | `node operations/scripts/remediators/governance/scripts/repair-script-inventory.js [--dry-run] [--staged-only] [--files <path,...>] [--json] [--md] [--output <dir>]` | | `repair-spelling.js` | Auto-corrects spelling errors using the shared cspell configuration. Safe, dictionary-based corrections only. | manual | health | `node operations/scripts/remediators/content/repair/repair-spelling.js --dry-run` | | `repair-term-capitalisation.js` | Reads rules from tools/config/quality/term-capitalisation.json. Scans content text for lowercase or wrong-case occurrences and rewrites them. Skips code blocks, frontmatter, URLs, import/export lines, JSX attribute values. --verify re-runs check-proper-nouns.js per file and reverts any regression. Pairs with dispatch-proper-nouns.js. | P6 | brand | `node operations/scripts/remediators/content/style/repair-term-capitalisation.js [--dry-run|--write] [--verify] [--staged] [--files path,path]` | | `repair-wcag.js` | Pattern E remediator. Wraps the WCAG audit engine's --fix mode to apply safe accessibility autofixes (heading hierarchy, alt text, contrast tokens). Supports --dry-run preview, --verify per-file revert on regression, and --files scoping. Paired with check-wcag in remediation-verify-registry. | P6 | health | `node operations/scripts/remediators/content/health/repair-wcag.js [--dry-run|--write] [--verify] [--files <path[,path...]>] [--staged] [--full] [--fail-impact <level>]` | | `replace-og-image.py` | Deprecated wrapper for the legacy OG image replacement helper. Use the canonical OG generator workflow instead. | manual | replace-og-image.py | `python3 tools/scripts/dev/replace-og-image.py` | | `sync-docs-paths.js` | Docs path sync remediator — applies deterministic docs.json and governed reference rewrites for moved docs pages. | manual | health | `node operations/scripts/remediators/content/repair/sync-docs-paths.js --staged --dry-run` | | `sync-mintlify-canonical-consumers.js` | Repair registered Mintlify consumer surfaces by applying exact path rewrites from the canonical sync registry without broad repo-wide content mutation. | manual | health | `node operations/scripts/remediators/content/repair/sync-mintlify-canonical-consumers.js [--staged] [--check|--write] [--stage] [--json]` | | `update-all-og-images.js` | Deprecated wrapper for legacy bulk OG image replacement. Use the canonical OG generator workflow instead. | manual | update-all-og-images.js | `node tools/scripts/dev/update-all-og-images.js` | | `update-jsdoc-headers.js` | Paired remediator for check-jsdoc-headers validator. Iterates scripts under operations/scripts/ and tools/scripts/, infers missing tags from path + existing content, applies a template-string scaffold. --check reports what would change; --write applies. Note: the inline template strings below this header use `${var}` literals — they are template-literal source, not part of this script's own JSDoc. | P6 | governance | `node operations/scripts/remediators/governance/scaffold/update-jsdoc-headers.js [--check|--write] [--files <paths>]` | | `update-og-image.js` | Deprecated wrapper for legacy OG image replacement. Use the canonical OG generator workflow instead. | manual | update-og-image.js | `node tools/scripts/dev/update-og-image.js` | ## 🔌 Integrators | Script | Description | Pipeline | Concern | Usage | | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `blockchain-page-spec.js` | Contract data pipeline module: blockchain-page-spec | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `branch-watch.js` | Contract data pipeline module: branch-watch | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `catalog-config.js` | Contract data pipeline module: catalog-config | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `cleanup-local-dev-sessions.js` | Local dev session cleanup — preserves Mint on port 3333 and terminates stale Playwright plus non-3333 Mint session trees | manual | governance | `node operations/scripts/integrators/governance/cleanup-local-dev-sessions.js [--apply] [--install-cron] [--remove-cron] [--keep-port 3333]` | | `constants.js` | Contract data pipeline module: constants | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `contract-address-routes.test.js` | | manual | integrations | | | `contract-verifier.test.js` | | manual | integrations | | | `contracts-browser-harness.js` | Unified scoped-browser harness for the contracts recovery browser gates. | manual | testing | `node operations/tests/contracts-browser-harness.js` | | `convert-rss-to-mdx.js` | Reads .rss files from v2/internal/assets/transcripts/, parses each entry (title, pubDate, link, excerpt, audio link, transcript), emits one MDX page per entry under v2/internal/assets/transcripts/\{source}/\{episode-slug}.mdx with proper frontmatter. Manual-use only — run when new RSS feeds are added or existing feeds need refresh. | manual | integrations | `node operations/scripts/integrators/content/data/transforms/convert-rss-to-mdx.js [--dry-run] [--source <name>]` | | `cross-agent-packager.js` | Reads the canonical skills catalog and execution manifest from ai-tools/ai-skills/, the latest audit reports from workspace/reports/, and the per-agent target rules. Produces a per-agent pack under ai-tools/agent-packs/\{agent}/ (e.g. claude/CLAUDE.md, codex/skills-manifest.json, cursor/rules.md). Called by repo-audit-orchestrator.js when --agent-pack is set. | manual | governance | `node operations/scripts/integrators/ai/agents/cross-agent-packager.js --agent-pack <name> --output-dir ai-tools/agent-packs` | | `docs-path-sync.js` | Library module imported by page-links-audit.js, precommit-staged-cache.js, and run-all.js. Exports planRewrites(stagedMoves), applyRewrites(plan), checkDrift() so page renames don't leave broken inbound links. Pairs with the page-integrity pipeline (dispatch-page-integrity.js indirectly via page-links-audit). | manual | health | `const sync = require('operations/scripts/config/docs-path-sync');` | | `export-portable-skills.js` | Reads the template-skill catalog, projects each into the per-agent pack format (e.g. CLAUDE.md fragment, codex skill manifest entry, cursor rules entry). --check validates the per-agent packs match the templates; --write regenerates them. Used by cross-agent-packager and runnable standalone. | manual | governance | `node operations/scripts/integrators/ai/agents/export-portable-skills.js --write|--check [--skills name[,name...]]` | | `fetch-config-flags.js` | Scheduled-weekly integrator. Hits GitHub raw URL for go-livepeer's flag-defining Go source files, parses flag definitions, normalises into a JSX export at snippets/data/config-flags/. Pairs with dispatch-config-flags.js. Required for the v2 config-flags reference page to stay current with go-livepeer releases. | P5 | maintenance | `node operations/scripts/integrators/maintenance/data-feeds/fetch-config-flags.js [--dry-run]` | | `fetch-contract-addresses.js` | Thin CLI entrypoint for the chain-first contracts pipeline. | manual | maintenance | `node .github/scripts/fetch-contract-addresses.js [--dry-run] [--check] [--skip-verify]` | | `fetch-contract-addresses.test.js` | | manual | integrations | | | `fetch-discord-announcements.js` | Reads channel ID + bot token from env, hits Discord API for each configured solution, transforms messages into a JSX module per solution and a shared community module. Writes outputs to snippets/data/social-feed-solutions/\{product}/discordData.jsx and snippets/data/social-feeds/discordAnnouncementsData.jsx. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-discord-announcements.js [--dry-run]` | | `fetch-exchanges-data.js` | Scheduled-weekly integrator. Hits CoinGecko's tickers-by-coin endpoint for LPT, classifies each ticker by exchange type (centralised vs decentralised) using a known-exchange config, writes snippets/data/exchanges/exchangesData.jsx. Pairs with dispatch-exchanges-data.js. | P5 | maintenance | `node operations/scripts/integrators/maintenance/data-feeds/fetch-exchanges-data.js [--dry-run]` | | `fetch-external-docs.sh` | Iterates a config-mapped list of external repos and files, downloads each via curl, runs mdx-sanitise on the output, writes to snippets/composables/pages/shared/. Pre-build dependency for the dev preview (mint-dev.sh runs it first) so external composables exist before Mintlify boots. Also referenced by page-imports-audit which validates that referenced shared composables exist. | P2 | integrations | `bash operations/scripts/integrators/content/data/fetching/fetch-external-docs.sh [flags]` | | `fetch-forum-data.js` | Polls the public Livepeer Forum Discourse API, extracts topic title, slug, category, reply count, view count, and last-activity timestamp. Writes multiple sorted JSX exports to snippets/data/social-feeds/forumData.jsx. Consumed by the social-feeds composable on Community pages. Supports --dry-run. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-forum-data.js [--dry-run]` | | `fetch-ghost-blog-data.js` | Reads RSS XML from the public Livepeer Ghost blog endpoint, parses entries (title, link, pubDate, excerpt, author), writes a sorted JSX export to snippets/data/social-feeds/ghostBlogData.jsx. No auth required. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-ghost-blog-data.js [--dry-run]` | | `fetch-github-discussions.js` | Reads solution → repo mapping from config, hits GitHub GraphQL API for the Discussions feed, transforms entries (title, body excerpt, author, category, replies, upvotes) into JSX exports. Writes per-solution outputs to snippets/data/social-feed-solutions/\{product}/githubDiscussionsData.jsx. Requires GITHUB\_TOKEN (anonymous works for public repos but is rate-limited). | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-github-discussions.js [--dry-run]` | | `fetch-github-releases.js` | Reads solution → repo mapping from config, hits GitHub REST API for the Releases endpoint, transforms entries (tag, title, body excerpt, author, published date, prerelease flag) into JSX exports. Writes per-solution outputs to snippets/data/social-feed-solutions/\{product}/githubReleasesData.jsx. Requires GITHUB\_TOKEN. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-github-releases.js [--dry-run]` | | `fetch-lpt-exchanges.sh` | Hits CoinGecko's public exchanges-by-token endpoint for the LPT coin ID, transforms the response (exchange name, pair, volume, trust score) into an MDX table, appends or updates the table in snippets/data/exchanges/lpt-exchanges.mdx. Manual-use only — documented in docs-guide/tooling/lpd-cli.mdx as a contributor workflow. | manual | integrations | `bash operations/scripts/integrators/content/data/fetching/fetch-lpt-exchanges.sh [flags]` | | `fetch-luma-events.js` | Reads the public Livepeer calendar at [https://api2.luma.com/ics/get?entity=calendar\&id=livepeer](https://api2.luma.com/ics/get?entity=calendar\&id=livepeer) (no auth required — public iCal). Parses VEVENT blocks, extracts title/date/location/URL, splits into upcoming (start > now) and past (start \<= now), sorts past desc / upcoming asc, writes a sorted JSX export to snippets/data/social-feeds/lumaEventsData.jsx. Matches the n8n workflow at snippets/assets/data/n8n/Luma-To-Mintlify.json so the schedule, endpoint, and transform are identical. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-luma-events.js [--dry-run]` | | `fetch-openapi-specs.sh` | Iterates a config-mapped list of Livepeer service OpenAPI spec URLs, downloads each via curl, validates JSON/YAML parses, writes to api/\{service}-openapi.\{yaml,json}. Mintlify's reference-page generator picks them up. Manual-use; not yet wired into a scheduled or post-merge pipeline (tracked as RFP gap "OpenAPI fetcher 2/5"). | manual | integrations | `bash operations/scripts/integrators/content/data/fetching/fetch-openapi-specs.sh [flags]` | | `fetch-rss-blog-data.js` | Reads solution → RSS URL mapping from config, parses each feed (title, link, pubDate, excerpt, author), transforms into JSX exports. Writes per-solution outputs to snippets/data/social-feed-solutions/\{product}/blogData.jsx. Distinct from fetch-ghost-blog-data which handles only the main Livepeer Ghost blog. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-rss-blog-data.js [--dry-run]` | | `fetch-youtube-data.js` | Reads channel ID + API key from env, hits YouTube Data API v3 for the channel's uploads playlist, transforms entries into a sorted JSX export. Writes to snippets/data/social-feeds/youtubeData.jsx. Requires YOUTUBE\_API\_KEY. | P5 | copy | `node operations/scripts/integrators/copy/social-feeds/fetch-youtube-data.js [--dry-run]` | | `generate-changelog.js` | Unified changelog generator driven by config key (CHANGELOG\_KEY env var). Fetches releases from GitHub/GitLab REST API, optionally enhances entries via an LLM call, optionally verifies on-chain (for the contracts changelog), renders to v2/solutions/\{product}/changelog.mdx or v2/resources/changelog/\{section}.mdx. Pairs with dispatch-changelogs.js. | P3, P5 | copy | `CHANGELOG_KEY=contracts node operations/scripts/integrators/copy/changelogs/generate-changelog.js [--dry-run] [--enhance] [--contract]` | | `generate-localized-docs-json.js` | Locale docs.json generator — produces localised docs.json variants from route-map and source docs.json | manual | integrations | `node operations/scripts/integrators/content/language-translation/generate-localized-docs-json.js [flags]` | | `incidents.js` | Contract data pipeline module: incidents | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `lock-release.js` | Reads the current task ID from .codex/task-contract.yaml, removes .codex/locks-local/\{task-id}.lock, validates the lock was held by the calling session (prevents accidental cross-session release). Called by task-finalise.js at end-of-session. | manual | governance | `node operations/scripts/integrators/ai/codex/lock-release.js [flags]` | | `mdx-sanitise.js` | Library used by all 6 social-feed integrators (fetch-forum-data, fetch-discord-announcements, fetch-ghost-blog-data, fetch-rss-blog-data, fetch-github-discussions, fetch-github-releases, fetch-youtube-data) to safely embed external content in the generated \*.jsx data modules. Exports sanitiseForMdx, escapeForJsx, stripDangerousPatterns. | manual | copy | `const { sanitiseForMdx, escapeForJsx } = require('operations/scripts/config/mdx-sanitise')` | | `mintlify-canonical-sync.js` | Library imported by check-mintlify-canonical-sync.js (validator) and sync-mintlify-canonical-consumers.js (remediator). Exports listConsumers(), planRewrites(canonicalChanges), validateArchiveState(). Pairs with dispatch-canonical-sync.js as the shared logic layer. | manual | copy | `const sync = require('operations/scripts/config/mintlify-canonical-sync');` | | `og-image-policy.js` | Library module (not a CLI). Exports resolveOgImage(route) → \{ src, alt, section, isFallback } given a v2/ route. Reads section → image mapping from snippets/assets/media/og-images/manifest.json. Treated as @type integrator because it's the resolver bridge between the OG generation pipeline output and the consumer surfaces. | manual | discoverability | `require('operations/scripts/config/og-image-policy').resolveOgImage(route)` | | `pipeline.js` | Contract data pipeline module: pipeline | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `playwright-blockchain-contracts.js` | CP-7: Verifies the blockchain-contracts page renders from generated pipeline data, | manual | testing | `node operations/tests/playwright-blockchain-contracts.js` | | `playwright-contract-addresses.js` | CP-6: Verifies the canonical contract-addresses reference page, the dedicated verifier page, | manual | testing | `node operations/tests/playwright-contract-addresses.js` | | `project-showcase-sync.js` | Reads pending submissions and review-decision rows from the configured Google Sheet, applies decisions (approve / reject / defer), writes the approved list to snippets/data/showcase-feed/showcaseData.jsx and showcaseDataPopulated.jsx. Consumed by snippets/composables/pages/home/project-showcase.mdx and snippets/composables/pages/showcase.mdx. Pairs with dispatch-showcase.js. | P5 | copy | `node operations/scripts/integrators/copy/showcase/project-showcase-sync.js [--mode poll|dispatch] [--dry-run]` | | `publish-v2-internal-reports.js` | Report publisher — publishes v2 internal audit reports to configured output locations | manual | governance | `node operations/scripts/integrators/governance/pipelines/publish-v2-internal-reports.js [flags]` | | `solidity-parser.js` | Contract data pipeline module: solidity-parser | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `spec.js` | Contract data pipeline module: spec | manual | integrations | `Internal module — imported by fetch-contract-addresses.js` | | `sync-codex-skills.js` | Reads the canonical skill templates, applies Codex-specific projections (skill manifest format, companion resource paths), writes outputs under ai-tools/agent-packs/codex/. --check fails if Codex pack is stale; --write regenerates. Different from export-portable-skills which handles all agents — this one is Codex-only with deeper Codex-specific transformations. | manual | governance | `node operations/scripts/integrators/ai/agents/sync-codex-skills.js [flags]` | | `task-cleanup.js` | Lists local git worktrees and branches matching codex/*, cross-references against merged PRs via gh CLI, removes worktrees whose branch is merged, removes stale .codex/locks-local/*.lock files whose task PR has merged. Reports what it would prune in dry-run mode. | manual | governance | `node operations/scripts/integrators/ai/codex/task-cleanup.js [--dry-run] [--write]` | | `task-preflight.js` | Run before the Codex agent starts work. Creates the task-contract YAML with task ID, scope, acceptance criteria fields. Acquires a local execution lock at .codex/locks-local/\{task-id}.lock to prevent parallel-session conflicts. Verifies branch is on codex/\* prefix, no stash markers present, no other locks held. | manual | governance | `node operations/scripts/integrators/ai/codex/task-preflight.js [flags]` | | `translate-docs.js` | Translation generator — translates v2 MDX pages to target languages via OpenRouter API | manual | integrations | `node operations/scripts/integrators/content/language-translation/translate-docs.js [flags]` | | `update-livepeer-release.js` | Fetches or accepts the latest go-livepeer release tag and writes the canonical release data module. | manual | maintenance | `node .github/scripts/update-livepeer-release.js [--version <tag>]` | | `validate-generated.js` | Generated localisation validator — checks generated translated MDX files and route-map outputs for integrity | manual | integrations | `node operations/scripts/integrators/content/language-translation/validate-generated.js [flags]` | ## 🚦 Dispatch | Script | Description | Pipeline | Concern | Usage | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `auto-remediate.js` | Central remediation dispatcher for lpd dev. Chains safe remediators in sequence: frontmatter keys, MDX safety, spelling, UK/US spelling, em-dashes, term capitalisation, page links, page imports. Each remediator runs independently — failures are logged but do not halt the chain. Always exits 0. | manual | governance | `node tools/dev/remediation/auto-remediate.js --mode startup [--staged|--full] [--language en-gb|en-us] [--dry-run] [--json]` | | `blast-radius-scanner.js` | PostToolUse hook for Edit/Write. When a file in snippets/components/, | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `check-codex-pr-overlap.js` | Lists open codex/\* PRs via gh CLI, extracts the changed-file set per PR, flags pairs whose changed-file sets intersect. Used by the Codex pre-task workflow to abort a session before it starts work on territory another agent already claimed. | P2 | governance | `node operations/scripts/dispatch/ai/codex/check-codex-pr-overlap.js [flags]` | | `codex-commit.js` | Invoked by the Codex AI agent at end-of-task. Inspects staged changes, validates branch is on codex/\* prefix, checks for AI stash markers, generates a commit message that includes the task ID and follows the repo's `<type>(<scope>): <subject>` convention. Pairs with the Codex skills-manifest entry for end-of-task commits. | manual | governance | `node operations/scripts/dispatch/ai/codex/codex-commit.js [flags]` | | `completion-gate.js` | PreToolUse hook for Write/Edit. Detects writes to session-log.txt, | manual | governance | `Called automatically by Claude Code PreToolUse hook. Not invoked directly.` | | `create-codex-pr.js` | Invoked by the Codex AI agent at end-of-task after codex-commit. Reads .codex/task-contract.yaml for task ID, summary, scope. Validates branch name matches the codex/\* pattern, opens PR via gh CLI with required labels (codex, ai-generated, task:\{id}) and body containing summary + acceptance criteria + linked task. Pairs with the Codex skills-manifest entry. | manual | governance | `node operations/scripts/dispatch/ai/codex/create-codex-pr.js [flags]` | | `dispatch-action-docs.js` | Self-doc pipeline: regenerate actions-library on workflow changes. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-action-docs.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-ai-sitemap.js` | AI sitemap pipeline (PR drift check + post-merge regen + verify). | P3, P5, P6 | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-ai-sitemap.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-banned-words.js` | Reads canonical lists from tools/lib/copy-governance/banned-\{words,phrases}.txt via lint-copy.js. PR: detect + advisory. Scheduled: rolling-issue. Banned terms require manual rewrite (no auto-repair) — the rolling-issue model is the response. | P3, P5 | brand | `node operations/scripts/dispatch/content/brand/dispatch-banned-words.js [--mode pr|scheduled]` | | `dispatch-brand-check.js` | Runs every brand pipeline with --mode pr. Aggregates exit codes. | P3 | brand | `node operations/scripts/dispatch/content/brand/dispatch-brand-check.js [--dry-run]` | | `dispatch-brand-repair.js` | Repair-only mode with --verify, opens PR with fixes. | manual | brand | `node operations/scripts/dispatch/content/brand/dispatch-brand-repair.js [--write] [--files <paths>|--staged|--full]` | | `dispatch-brand-scan.js` | Full audit + repair (--write) + verify + rolling-issue. | P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-brand-scan.js [--write] [--verify]` | | `dispatch-canonical-sync.js` | Detects drift between archived Mintlify sources and active consumers; repairs via sync-mintlify-canonical-consumers. | P3, P5, P6 | copy | `node operations/scripts/dispatch/content/copy/dispatch-canonical-sync.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-catalogs.js` | docs-guide catalog pipeline (PR check + post-merge regen). | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-catalogs.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-changelogs.js` | Pipeline for changelog regeneration from upstream repo releases. | P3, P5, P6 | copy | `node operations/scripts/dispatch/content/copy/dispatch-changelogs.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-codex-compliance.js` | Codex branch + task contract compliance. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-codex-compliance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-companions.js` | AI companion manifest pipeline (PR drift check + post-merge regen + verify). | P3, P5, P6 | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-companions.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-component-registry.js` | Component registry pipeline (PR drift check + post-merge regen + component validators). | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-component-registry.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-config-flags.js` | go-livepeer config flags fetcher. | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-config-flags.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-content-quality.js` | Mode-driven orchestrator over docs-quality-and-freshness-audit.js. PR mode runs audit on staged with advisory comment. Scheduled mode runs full audit, applies deterministic fixes via repair-content-quality (Phase 3.X), escalates residual via rolling-issue. | P3, P5, P6 | health | `node operations/scripts/dispatch/content/health/dispatch-content-quality.js [--mode pr|scheduled|manual] [--dry-run|--write] [--files <paths>|--staged|--full]` | | `dispatch-contract-addresses.js` | Contract addresses fetch from on-chain. | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-contract-addresses.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-contract-shadow.js` | Shadow contract pipeline (verify production matches shadow). | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-contract-shadow.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-copy-check.js` | PR meta for copy concern. | P3 | copy | `node operations/scripts/dispatch/content/copy/dispatch-copy-check.js [--dry-run|--write] [--verify]` | | `dispatch-copy-repair.js` | Manual repair meta for copy concern. | manual | copy | `node operations/scripts/dispatch/content/copy/dispatch-copy-repair.js [--dry-run|--write] [--verify]` | | `dispatch-copy-update.js` | Scheduled meta for copy integrators. | P5 | copy | `node operations/scripts/dispatch/content/copy/dispatch-copy-update.js [--dry-run|--write] [--verify]` | | `dispatch-discoverability-check.js` | PR meta for discoverability concern. | P3 | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-check.js [--dry-run|--write] [--verify]` | | `dispatch-discoverability-generate.js` | Post-merge meta for discoverability generators. | manual | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-generate.js [--dry-run|--write] [--verify]` | | `dispatch-discoverability-repair.js` | Manual repair meta for discoverability concern. | manual | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-repair.js [--dry-run|--write] [--verify]` | | `dispatch-docs-index.js` | docs-index.json pipeline (PR drift check + post-merge regen). | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-docs-index.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-em-dashes.js` | Detects em-dashes in v2 MDX and replaces with sentence-appropriate punctuation. PR: detect + advisory. Scheduled: scan + repair + verify + rolling-issue. Manual: repair-only with --verify. | P3, P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-em-dashes.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-exchanges-data.js` | CoinGecko exchanges data fetcher. | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-exchanges-data.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-folder-allowlist.js` | Pipeline orchestrator. Mode-driven entry point: --mode pr (detect + advisory comment), --mode scheduled (audit + repair + verify + rolling issue), --mode manual (repair-only with --verify). Wraps the three atomic scripts (check / audit / repair) into one composable lifecycle. Independently runnable locally via `node dispatch-folder-allowlist.js --dry-run`. | P2, P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-folder-allowlist.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--folder <path>]` | | `dispatch-governance-check.js` | PR meta for governance concern. | P3 | governance | `node operations/scripts/dispatch/governance/dispatch-governance-check.js [--dry-run|--write] [--verify]` | | `dispatch-governance-generate.js` | Self-doc generate meta. | manual | governance | `node operations/scripts/dispatch/governance/dispatch-governance-generate.js [--dry-run|--write] [--verify]` | | `dispatch-governance-map.js` | Governance markers validity + drift repair pipeline. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-governance-map.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-governance-scan.js` | Scheduled meta for governance scans. | P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-governance-scan.js [--dry-run|--write] [--verify]` | | `dispatch-governance-sync.js` | Post-merge meta for governance state repair. | manual | governance | `node operations/scripts/dispatch/governance/dispatch-governance-sync.js [--dry-run|--write] [--verify]` | | `dispatch-grammar-en-gb.js` | Detects UK English grammar issues (subject-verb agreement, article use, comma placement) and applies safe deterministic fixes via the EN-GB homogeniser. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only. | P3, P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-grammar-en-gb.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-health-check.js` | Runs every health pipeline dispatcher with --mode pr in sequence. Aggregates exit codes. Used by dispatch-health.yml on pull\_request events. | P3 | health | `node operations/scripts/dispatch/content/health/dispatch-health-check.js [--dry-run|--write] [--files <paths>|--staged|--full]` | | `dispatch-health-repair.js` | Runs repair-only mode across health pipelines that support remediation. Opens PR with verified fixes. | manual | health | `node operations/scripts/dispatch/content/health/dispatch-health-repair.js [--dry-run|--write] [--files <paths>|--staged|--full]` | | `dispatch-health-scan.js` | Runs every health pipeline with --mode scheduled. Full audit + repair (if --write) + verify + rolling issue routing. | P5, P6 | health | `node operations/scripts/dispatch/content/health/dispatch-health-scan.js [--dry-run|--write] [--verify]` | | `dispatch-jsdoc-headers.js` | 11-tag JSDoc enforcement pipeline. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-jsdoc-headers.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-large-assets.js` | Large asset sync to docs-v2-assets branch. | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-large-assets.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-llms-files.js` | llms.txt + llms-full.txt pipeline. | P3, P5, P6 | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-llms-files.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-maintenance-check.js` | PR meta for maintenance concern. | P3 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-maintenance-check.js [--dry-run|--write] [--verify]` | | `dispatch-maintenance-generate.js` | Post-merge meta for maintenance generators. | manual | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-maintenance-generate.js [--dry-run|--write] [--verify]` | | `dispatch-maintenance-update.js` | Scheduled meta for maintenance integrators. | P5 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-maintenance-update.js [--dry-run|--write] [--verify]` | | `dispatch-new-file-governance.js` | New file metadata enforcement pipeline. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-new-file-governance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-og-images.js` | OG image pipeline (Puppeteer generate + verify per page). | P3, P5, P6 | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-og-images.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-openapi-reference.js` | Wraps the existing OpenAPI audit + reference regen flow. PR mode: drift check only. Scheduled: full audit + open PR if drift. Manual: regenerate reference docs from canonical spec. | P3, P5, P6 | health | `node operations/scripts/dispatch/content/health/dispatch-openapi-reference.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-ownerless-language.js` | Detects owner-dependent phrasing in v2 MDX; repairs via repair-ownerless-language with --verify. | P3, P5, P6 | copy | `node operations/scripts/dispatch/content/copy/dispatch-ownerless-language.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-page-integrity.js` | Mode-driven orchestrator wrapping the existing page-integrity-dispatch.js chain. --mode pr runs audits on staged + previews repairs. --mode scheduled runs full audit + repair --verify + rolling issue for residual. --mode manual runs repairs only. Replaces direct workflow calls to page-integrity-dispatch.js with the canonical pipeline contract. | P3, P5, P6 | health | `node operations/scripts/dispatch/content/health/dispatch-page-integrity.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-page-rendering.js` | Mode-driven orchestrator over test-v2-pages.js and check-broken-links.js. Render errors typically need human review, so the cycle is: detect (Puppeteer + link check) → repair (broken-link replacements where deterministic) → escalate via rolling-issue. | P3, P5 | health | `node operations/scripts/dispatch/content/health/dispatch-page-rendering.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-page-structure.js` | Mode-driven orchestrator over the 8 structure validators and their paired remediators. PR mode runs validators in --staged and posts advisory. Scheduled mode runs validators repo-wide, applies safe repairs, escalates residual via rolling-issue. Manual mode runs only remediators with --verify. | P3, P5, P6 | health | `node operations/scripts/dispatch/content/health/dispatch-page-structure.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-pipelines.js` | Weekly governance repair orchestrator wrapper. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-pipelines.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-proper-nouns.js` | Detects lowercase/wrong-case proper nouns and corrects. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only. | P3, P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-proper-nouns.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-release-version.js` | go-livepeer release version fetcher. | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-release-version.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-root-governance.js` | Root governance artifact regen + sync check. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-root-governance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-script-inventory.js` | Script registry inventory pipeline. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-script-inventory.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-script-locations.js` | Script folder placement enforcement. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-script-locations.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-script-registry.js` | Script registry self-doc pipeline. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-script-registry.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-sdk-clients.js` | SDK client generation (Speakeasy wrapper). | P3, P5, P6 | maintenance | `node operations/scripts/dispatch/content/maintenance/dispatch-sdk-clients.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-seo-metadata.js` | SEO metadata repair pipeline (frontmatter completeness, descriptions). | P3, P5, P6 | discoverability | `node operations/scripts/dispatch/content/discoverability/dispatch-seo-metadata.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-showcase.js` | Pipeline for project showcase data sync. | P3, P5, P6 | copy | `node operations/scripts/dispatch/content/copy/dispatch-showcase.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-social-feeds.js` | Pipeline for scheduled social feed integration (Discord, Forum, Ghost, GitHub, RSS, YouTube). Matrix per-source under one dispatcher. | P3, P5, P6 | copy | `node operations/scripts/dispatch/content/copy/dispatch-social-feeds.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-spelling.js` | Detects US spellings and corrects to UK forms. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only with --verify. | P3, P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-spelling.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-style-tokens.js` | Detects style tokens not from the brand system. Scheduled: audit + repair (Phase 3.X wire). Manual: repair-only. | P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-style-tokens.js [--mode scheduled|manual]` | | `dispatch-voice-register.js` | Detects voice violations (hedging, conditionals, weakened value, per-audience prohibited phrases) and applies safe deterministic fixes. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only with --verify. | P3, P5, P6 | brand | `node operations/scripts/dispatch/content/brand/dispatch-voice-register.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-wcag.js` | Mode-driven pipeline orchestrator. --mode pr runs check-wcag (validator) and posts advisory. --mode scheduled runs audit-wcag (engine full scan) + repair-wcag (--write --verify) + rolling issue for residual. --mode manual runs repair-wcag with --verify against staged or specified files. Independently runnable locally. | P3, P5, P6 | health | `node operations/scripts/dispatch/content/health/dispatch-wcag.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full]` | | `dispatch-workflow-governance.js` | Workflow YAML governance header pipeline. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-workflow-governance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `dispatch-workspace-retention.js` | Workspace structure + retention audit. | P3, P5, P6 | governance | `node operations/scripts/dispatch/governance/dispatch-workspace-retention.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify]` | | `docs-page-research-pr-report.js` | Docs page research PR report — runs the fact-check research runner on changed docs pages and emits an advisory PR artifact summarizing claim families, contradictions, unresolved factual risk, and propagation follow-up. | manual | health | `node operations/scripts/dispatch/content/veracity/docs-page-research-pr-report.js [flags]` | | `docs-page-research-pr-report.test.js` | Tests docs-page-research-pr-report.js — validates changed-file advisory reporting for the fact-check research runner. | manual | | `node operations/tests/unit/docs-page-research-pr-report.test.js [flags]` | | `docs-research-packet.js` | Docs research packet generator — derives nav, manifest, or explicit path scope; runs the research stack tranche-by-tranche; and writes reusable packet reports plus a master rollup. | manual | health | `node operations/scripts/dispatch/content/veracity/docs-research-packet.js [flags]` | | `edit-loop-guard.js` | PostToolUse hook for Edit/Write. Tracks per-file edit counts within a session. | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `friction-logger.js` | UserPromptSubmit hook. Scans user messages for frustration indicators | manual | governance | `Called automatically by Claude Code UserPromptSubmit hook. Not invoked directly.` | | `governance-pipeline.js` | Run the bounded governance repair pipeline and regenerate the active repo-ops governance reports. | P6 | governance | `node operations/scripts/dispatch/governance/pipelines/governance-pipeline.js [--dry-run] [--auto-commit] [--report-only] [--strict] [--staged|--files <path[,path...]>|--full]` | | `grep-loop-guard.js` | Tracks consecutive Grep calls that return no results. At 3 in a row, | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `headless-batch.sh` | Executes a prompt against files non-interactively with restricted tools. Use for bulk quality checks, changelog regeneration, stale reference scans, and other well-defined batch tasks. | manual | governance | `./operations/scripts/dispatch/governance/headless-batch.sh --prompt "..." --tools "Read,Grep,Glob" --output report.md` | | `install.sh` | Installs git hooks by routing this worktree to .githooks via worktree-local core.hooksPath | manual | governance | `bash .githooks/install.sh [flags]` | | `mdx-constraints-injector.js` | UserPromptSubmit hook. Keyword-matches the user message for MDX/component/page | manual | governance | `Called automatically by Claude Code UserPromptSubmit hook. Not invoked directly.` | | `mdx-frontmatter-sanitise.js` | PostToolUse hook for Edit/Write on ANY .mdx file. Auto-fixes (1) duplicate frontmatter keys, (2) em-dash characters in user-facing text, and (3) single-quoted frontmatter scalars (standardises to double quotes). All fixes are applied silently to the file already on disk; the hook only emits a systemMessage when something was changed. | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `mdx-render-gate.js` | PreToolUse hook for Write/Edit. Reads the verification state written by | manual | governance | `Called automatically by Claude Code PreToolUse hook. Not invoked directly.` | | `mdx-render-verify.js` | PostToolUse hook for Edit/Write on v2 .mdx files. Launches Puppeteer, | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `mdx-validate-hook.js` | PostToolUse hook for Edit/Write on .mdx files. Uses the shared | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `message-backup.js` | UserPromptSubmit hook. If a message is longer than 200 chars, saves it to | manual | governance | `Called automatically by Claude Code UserPromptSubmit hook. Not invoked directly.` | | `move-detect-hook.js` | PostToolUse hook on Bash. Detects mv/git mv commands targeting v2/ paths, | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `orchestrator-guides-research-review.js` | Orchestrator guides research review packet wrapper — delegates to the generic docs-research-packet engine with the live Orchestrators Guides nav scope and legacy default output root. | manual | health | `node operations/scripts/audits/content/veracity/orchestrator-guides-research-review.js [flags]` | | `page-integrity-dispatch.js` | Orchestrate the page-integrity family from canonical operations scripts so audit, repair, rerun, and report publication share one stable workflow contract. | P6 | health | `node operations/scripts/dispatch/content/health/page-integrity-dispatch.js [--staged|--files <paths>|--tab <tab>] [--strict] [--no-repair] [--issue-mode off|plan] [--output-dir <dir>]` | | `page-integrity-rolling-issue.js` | Provide a stable rolling-issue contract for page-integrity dispatch runs so unresolved link and import failures stay visible in GitHub automation. | manual | health | `node operations/scripts/dispatch/content/health/page-integrity-rolling-issue.js [flags]` | | `phase-gate-hook.js` | PostToolUse hook for Edit/Write. Reads phase-gate.jsonl and emits unverified | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `post-remediation-verify.js` | Looks up validators for a given remediator from the registry, runs them | manual | governance | `node operations/scripts/dispatch/governance/post-remediation-verify.js --remediator <path> --files <a,b,c> [--revert-on-fail] [--json]` | | `post-tool-verify.js` | Tracks consecutive failures for circuit breaker. Fires after tool use failures. | manual | governance | `Called automatically by Claude Code PostToolUseFailure hook. Not invoked directly.` | | `pre-commit` | Pre-commit hook — hard gates only (syntax, security, safety). All soft checks run in GitHub Actions PR workflows. | P1 | | `bash .githooks/pre-commit [flags]` | | `pre-commit-no-deletions` | Variant pre-commit hook that blocks file deletions (safety net for content preservation) | manual | | `bash .githooks/pre-commit-no-deletions [flags]` | | `pre-commit-v1` | Pre-commit hook orchestrator — runs structural checks, unit tests, codex validation, and docs-index freshness check before allowing commit | P1 | pre-commit-v1 | `bash .githooks/pre-commit [flags]` | | `pre-compact-checkpoint.js` | Fires before Claude Code compacts context in long sessions. Reads the | manual | governance | `Called automatically by Claude Code PreCompact hook. Not invoked directly.` | | `pre-push` | Pre-push hook — blocks push if AI stash files present, codex locks stale, or task contract invalid | P2 | | `bash .githooks/pre-push [flags]` | | `pre-tool-guard.js` | Mechanically enforces co-work rules before tool execution. Blocks destructive git, public posts, and unconfirmed writes. | manual | governance | `Called automatically by Claude Code PreToolUse hook. Not invoked directly.` | | `read-logger.js` | PostToolUse hook on Read. Logs file paths to a session-scoped temp file. | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `repo-audit-orchestrator.js` | Repo audit orchestrator — dispatches all static analysis validators in sequence. Supports --mode (static/full), --scope (full/changed), --quarantine, --agent-pack. | manual | governance | `node operations/scripts/audits/governance/repo/repo-audit-orchestrator.js [flags]` | | `run-all.js` | Main test-suite orchestrator for local, pre-commit, and package-script execution across the governed documentation validators. | P1, P2, P3 | governance | `node operations/tests/run-all.js [flags]` | | `run-pr-checks.js` | Changed-file PR validation orchestrator for the branch-health lane, including the strict page-integrity dispatch on changed docs pages. | P2, P3 | governance | `node operations/tests/run-pr-checks.js [flags]` | | `run-solutions-social-fetch.js` | Mirrors what dispatch-social-feeds.yml does in CI but with .env support, selective --mode (e.g. only forum+youtube), and --skip flag for offline-only fetchers. Iterates the configured fetchers under operations/scripts/integrators/copy/social-feeds/, runs each, captures success/failure summary. Local-use only — not in any GitHub Actions workflow. | manual | integrations | `node operations/scripts/dispatch/content/data/run-solutions-social-fetch.js [--mode forum,youtube] [--dry-run] [--env path/to/.env] [--skip discord]` | | `scope-checkpoint.js` | PostToolUse hook for Edit/Write. Tracks total edit count per session. | manual | governance | `Called automatically by Claude Code PostToolUse hook. Not invoked directly.` | | `server-lifecycle.js` | SessionStart hook + CLI tool. Auto-starts the Mintlify dev server via | manual | governance | `node server-lifecycle.js [health|restart [scope-prefix]]` | | `server-manager.js` | Manages Mintlify dev server lifecycle for browser tests (start/stop/health-check) | manual | governance | `node .githooks/server-manager.js [flags]` | | `session-register.js` | SessionStart hook that registers this session in a shared registry file. | manual | governance | `Called automatically by Claude Code hooks. Not invoked directly.` | | `session-state.js` | Reads ALL active plans and live project state. Run at session start. | manual | governance | `node operations/scripts/dispatch/governance/session-state.js` | | `sync-generated-files.js` | Dispatches generator scripts to sync generated catalog/index files, then validates banners. | P1 | governance | `node operations/scripts/dispatch/governance/pipelines/sync-generated-files.js --write | --check [--staged]` | | `task-finalise.js` | End-of-session gate for the Codex AI agent. Validates that .codex/task-contract.yaml acceptance criteria are checked, runs validate-locks, runs any registered post-task validators, runs lock-release. If any step fails, blocks the session close so the agent must address it. | manual | governance | `node operations/scripts/dispatch/ai/codex/task-finalise.js [flags]` | | `verify-browser.js` | Verifies browser availability for Puppeteer-based integration tests | manual | governance | `node .githooks/verify-browser.js [flags]` | | `verify.sh` | Pre-commit sub-hook — verifies file-walker is available and runs structural checks on staged files | manual | governance | `bash .githooks/verify.sh [flags]` | ## 💬 Interfaces | Script | Description | Pipeline | Concern | Usage | | ------------------------- | ------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------- | | `assign-reviewers.js` | Three-phase reviewer assignment: (1) gate checks if PR is eligible | manual | governance | `Called by github-script in workflow — not invoked directly` | | `close-linked-issues.js` | Parses PR body for closing keywords (fixes/closes/resolves #N), | manual | governance | `Called by github-script in workflow — not invoked directly` | | `discord-issue-intake.js` | Validates repository\_dispatch payload from Discord bot (n8n workflow), | manual | governance | `Called by github-script in workflow — not invoked directly` | | `issue-auto-label.js` | Detects issue template type (docs\_page\_issue, bug\_report, feature\_request, etc.), | manual | governance | `Called by github-script in workflow — not invoked directly` | | `issue-indexer.js` | Searches all docs-v2 labelled issues, sorts by classification/priority, | manual | governance | `Called by github-script in workflow — not invoked directly` | | `load-labels.js` | Returns the labels object and managed\_prefixes from the central config. | manual | governance | `const { labels, managedPrefixes } = require('./lib/load-labels.js');` | | `notify-linked-issues.js` | Parses PR body for closing keywords and Task: #N patterns, | manual | governance | `Called by github-script in workflow — not invoked directly` | | `rolling-issue.js` | Provides ensureLabels(), upsert(), and close() for the rolling issue | manual | governance | `const ri = require('./lib/rolling-issue.js'); await ri.upsert({ github, context, label, title, body });` | | Module | Description | Concern | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `agent-write-governance.js` | Agent write-governance helpers — load and validate the canonical manifest for admitted agent output classes and destinations. | | | `ai-tools-registry.js` | Shared loader, validator, coverage checker, and report renderer for the AI-tools registry contract and generated inventory report. | | | `changelog.js` | LLM prompt template for changelog page-type usefulness evaluation. | | | `codex-skill-templates.js` | Shared helper for validating, selecting, and loading canonical Codex skill templates. | | | `common.js` | i18n shared utilities — common helper functions for translation pipeline | integrations | | `component-governance-utils.js` | Shared parsing and validation utilities for component governance scripts. | | | `concept.js` | LLM prompt template for concept page-type usefulness evaluation. | | | `config-validator.js` | Validates docs-usefulness config structure and field completeness. | | | `config.js` | i18n configuration — language codes, locale paths, translation settings | integrations | | `docs-authoring-rules.js` | Shared warning-level authoring rules for guide layouts and code-block metadata, plus deterministic code-block icon repair. | | | `docs-index-utils.js` | Shared utilities for docs-index.json generation — path resolution, frontmatter extraction, index merging | | | `docs-json-localizer.js` | docs.json localiser engine — transforms docs.json navigation for locale variants | integrations | | `docs-page-scope.js` | Shared authored-page scope helpers that distinguish generated docs pages from authored docs pages for warning-only validators and reports. | | | `docs-publishability.js` | Shared path publishability rules for v2 docs content and tooling. | | | `docs-routes.js` | docs route resolver — maps page paths to locale-aware routes | integrations | | `faq.js` | LLM prompt template for faq page-type usefulness evaluation. | | | `file-walker.js` | File tree walker — recursively finds files matching patterns. Used by pre-commit hook and validators. | | | `frontmatter-taxonomy.js` | Shared frontmatter taxonomy utilities for routable docs pages. | governance | | `frontmatter.js` | Frontmatter parser/writer for translation surfaces. | copy | | `generated-artifacts.js` | Generated artifact governance helpers — load the manifest, validate enums, and match staged files to managed artifacts | | | `generated-file-banners.js` | Generated file banner template — provides standard banner text for auto-generated files | | | `glossary.js` | LLM prompt template for glossary page-type usefulness evaluation. | | | `how_to.js` | LLM prompt template for how\_to page-type usefulness evaluation. | | | `index.js` | LLM prompt template for index page-type usefulness evaluation. | | | `journey-check.js` | Evaluates docs pages against user journey completeness criteria. | | | `landing.js` | LLM prompt template for landing page-type usefulness evaluation. | | | `llm-evaluator.js` | Wraps LLM API calls for rubric-based page quality evaluation. | | | `load-js-yaml.js` | YAML loader utility — resolves js-yaml from repo-local installs and falls back to a minimal parser for task-contract style files in bare worktrees | | | `load-minimatch.js` | Glob matcher loader — resolves minimatch from repo-local installs and falls back to a simple glob matcher for bare worktrees | | | `mdx-parser.js` | MDX parser for i18n — extracts translatable content blocks from MDX | integrations | | `mdx-parser.js` | MDX parser utility — extracts frontmatter, components, content blocks from MDX files | | | `mdx-safe-markdown.js` | Shared MDX-safe markdown helpers that collect first-party markdown files, detect unsafe patterns, and apply deterministic repairs. | | | `mdx-translate.js` | MDX translation engine — applies translations to MDX content blocks | integrations | | `mintignore.js` | Mintignore utility — reads .mintignore patterns and filters file lists | | | `openapi-rolling-issue.js` | OpenAPI rolling issue utility — creates/updates GitHub issues for persistent OpenAPI audit findings | | | `overview.js` | LLM prompt template for overview page-type usefulness evaluation. | | | `path-utils.js` | Path utilities for i18n — locale-aware path resolution and mapping | integrations | | `precommit-staged-cache.js` | Shared pre-commit staged-cache helpers — fingerprint staged content plus hook inputs and persist reusable pass markers | | | `provenance.js` | Translation provenance tracker — records source, timestamp, and provider for each translated segment | integrations | | `provider-mock.js` | Mock translation provider — returns placeholder translations for testing without API calls | integrations | | `provider-openrouter.js` | OpenRouter translation provider — calls OpenRouter API for actual translations | integrations | | `providers.js` | Provider registry — selects translation provider (OpenRouter or mock) based on configuration | integrations | | `quality-gate.js` | Applies pass/fail thresholds to usefulness scores. | | | `reference.js` | LLM prompt template for reference page-type usefulness evaluation. | | | `repo-governance.js` | Repo governance helpers — load the canonical registry, validate its schema, and expose derived state for generators and validators. | | | `repo-node-paths.js` | Shared repo Node path bootstrap helpers — discover repo-local node\_modules roots and provide consistent NODE\_PATH setup for test and script runners. | | | `resolve-scoped-docs-config.js` | Scoped docs config resolver — resolves named scoped navigation configs and explicit docs config paths for mint-dev tooling | | | `root-governance.js` | Root governance helpers — load the canonical manifest, validate the governed root contract, and project derived allowlist/report state. | | | `rubric-loader.js` | Loads and parses rubric YAML/JSON for page-type scoring rules. | | | `rule-evaluators.js` | Evaluates individual rubric rules against page content. | | | `scoring.js` | Aggregates rule scores into a final usefulness score per page. | | | `script-governance-config.js` | Shared governance constants for script discovery, indexing, classification, and pipeline normalisation across the repo. | | | `script-header-utils.js` | Shared helpers for extracting and reading top-of-file script governance headers without scanning into executable source. | | | `spell-checker.js` | Spell checker utility — checks text against custom dictionary with en-GB locale support | | | `troubleshooting.js` | LLM prompt template for troubleshooting page-type usefulness evaluation. | | | `tutorial.js` | LLM prompt template for tutorial page-type usefulness evaluation. | | | `validate-component-creation.js` | Write-time governance for component creation (layer-2 of D-GOV-08 chain). Reads each staged .jsx under snippets/components/, parses or infers the 7-tag JSDoc (script/type/concern/niche/purpose/description/usage), checks naming + folder convention, applies --fix where unambiguous, --verify re-runs the check after fix. Used by repair-component-metadata.js as the gating step. | maintenance | | Script | Path | Pipeline | Notes | | ------------------------------------ | ----------------------------------------------------- | -------- | ------------------------------- | | `contracts-validator-contract.js` | `operations/tests/contracts-validator-contract.js` | manual | Missing `@type` in JSDoc header | | `playwright-community-components.js` | `operations/tests/playwright-community-components.js` | manual | Missing `@type` in JSDoc header | | `mdx-sanitise.test.js` | `operations/tests/unit/mdx-sanitise.test.js` | manual | Missing `@type` in JSDoc header | | `folder-allowlist.js` | `tools/lib/governance/folder-allowlist.js` | manual | Missing `@type` in JSDoc header | | `pipeline-mode.js` | `tools/lib/governance/pipeline-mode.js` | manual | Missing `@type` in JSDoc header | | `pipeline-test-harness.js` | `tools/lib/governance/pipeline-test-harness.js` | manual | Missing `@type` in JSDoc header | | `repair-registry.py` | `workspace/scripts/repair-registry.py` | manual | Missing `@type` in JSDoc header |