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

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, 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&#124;--write] [--files &lt;paths&gt;&#124;--staged&#124;--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&#124;--write] [--verify] [--folder &lt;path&gt;]
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&#124;--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 &lt;paths&gt;&#124;--staged&#124;--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&#124;--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&#124;--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&#124;--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&#124;--write] [--files &lt;paths&gt;] [--output-dir &lt;dir&gt;]
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 &lt;path,...&gt;] [--json] [--md] [--output &lt;dir&gt;]
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&#124;--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&#124;--write] [--verify] [--files &lt;path[,path...]&gt;] [--staged] [--full] [--fail-impact &lt;level&gt;]
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&#124;--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 $&#123;var&#125; 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&#124;--write] [--files &lt;paths&gt;]
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&amp;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 &#123; sanitiseForMdx, escapeForJsx &#125; = 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&#124;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 &lt;tag&gt;]
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 });

📚 Library Modules — 57

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

⚠️ Unclassified — 7 scripts need @type

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