Generation Script: This file is generated from script(s):
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
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. 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|--write] [--files <paths>|--staged|--full] |
repair-folder-allowlist.js | Reads each governed folder’s .allowlist, identifies drift, archives drift via git mv to {folder}/x-archive/. Supports —dry-run preview and —verify (re-runs check after repair, asserts drift count = 0). | P6 | governance | node operations/scripts/remediators/governance/repo/repair-folder-allowlist.js [--dry-run|--write] [--verify] [--folder <path>] |
repair-governance-artifacts.js | Regenerates governance map, updates lastVerified dates on verified frameworks, and reports unfixable issues | manual | governance | node operations/scripts/remediators/governance/compliance/repair-governance-artifacts.js [--dry-run|--write] |
repair-lint-structure.js | Pairs with lint-structure.js. Applies deterministic whitespace + spacing fixes only. Anything requiring judgment (heading-level reorganisation) stays flagged for human review. | P6 | health | node operations/scripts/remediators/content/structure/repair-lint-structure.js [--write] [--files <paths>|--staged|--full] |
repair-mdx-safe-markdown.js | Auto-repairs deterministic MDX-unsafe markdown patterns across first-party markdown and MDX content. | manual | health | node operations/scripts/remediators/content/repair/repair-mdx-safe-markdown.js --dry-run [--staged|--files a,b] |
repair-openapi-reference.js | Pairs with openapi-reference-audit. On detected drift between live API spec and committed reference docs, invokes generate-api-docs.sh against each tracked spec to regenerate the v2 API reference pages. PR is opened by the workflow layer after successful regen. | P6 | health | node operations/scripts/remediators/content/health/repair-openapi-reference.js [--dry-run|--write] |
repair-ownerless-language.js | Applies a closed list of deterministic 1:1 phrase rewrites (e.g. “Awaiting maintainer triage” → “Awaiting repository routing”, “policy ownership” → “policy layering”) to a fixed set of governed contributor surfaces. Reads no external rules — the phrase map is hard-coded for auditability. Pairs with dispatch-ownerless-language.js. | P3, P6 | copy | node operations/scripts/remediators/content/style/repair-ownerless-language.js [--check|--write] [--files a,b] |
repair-page-imports.js | Repair only proven-safe page import failures from canonical operations scripts while leaving ambiguous import issues unchanged for review. | manual | health | node operations/scripts/remediators/content/repair/repair-page-imports.js [--dry-run|--write] [--files <paths>] [--output-dir <dir>] |
repair-page-links.js | Repair deterministic page-link path issues from canonical operations scripts while leaving ambiguous targets unchanged for review. | manual | health | node operations/scripts/remediators/content/repair/repair-page-links.js --dry-run --files v2/about --report-dir operations/reports/health/page-links |
repair-relative-page-hrefs.js | Preserve the legacy relative-href repair command while the canonical implementation lives under repair-page-links.js. | manual | health | node operations/scripts/remediators/content/repair/repair-relative-page-hrefs.js [flags] |
repair-script-inventory.js | Repairs script headers and classification data. Thin wrapper that runs audit-script-inventory with —fix. Split from audit-script-inventory.js. | manual | governance | node operations/scripts/remediators/governance/scripts/repair-script-inventory.js [--dry-run] [--staged-only] [--files <path,...>] [--json] [--md] [--output <dir>] |
repair-spelling.js | Auto-corrects spelling errors using the shared cspell configuration. Safe, dictionary-based corrections only. | manual | health | node operations/scripts/remediators/content/repair/repair-spelling.js --dry-run |
repair-term-capitalisation.js | Reads rules from tools/config/quality/term-capitalisation.json. Scans content text for lowercase or wrong-case occurrences and rewrites them. Skips code blocks, frontmatter, URLs, import/export lines, JSX attribute values. —verify re-runs check-proper-nouns.js per file and reverts any regression. Pairs with dispatch-proper-nouns.js. | P6 | brand | node operations/scripts/remediators/content/style/repair-term-capitalisation.js [--dry-run|--write] [--verify] [--staged] [--files path,path] |
repair-wcag.js | Pattern E remediator. Wraps the WCAG audit engine’s —fix mode to apply safe accessibility autofixes (heading hierarchy, alt text, contrast tokens). Supports —dry-run preview, —verify per-file revert on regression, and —files scoping. Paired with check-wcag in remediation-verify-registry. | P6 | health | node operations/scripts/remediators/content/health/repair-wcag.js [--dry-run|--write] [--verify] [--files <path[,path...]>] [--staged] [--full] [--fail-impact <level>] |
replace-og-image.py | Deprecated wrapper for the legacy OG image replacement helper. Use the canonical OG generator workflow instead. | manual | replace-og-image.py | python3 tools/scripts/dev/replace-og-image.py |
sync-docs-paths.js | Docs path sync remediator — applies deterministic docs.json and governed reference rewrites for moved docs pages. | manual | health | node operations/scripts/remediators/content/repair/sync-docs-paths.js --staged --dry-run |
sync-mintlify-canonical-consumers.js | Repair registered Mintlify consumer surfaces by applying exact path rewrites from the canonical sync registry without broad repo-wide content mutation. | manual | health | node operations/scripts/remediators/content/repair/sync-mintlify-canonical-consumers.js [--staged] [--check|--write] [--stage] [--json] |
update-all-og-images.js | Deprecated wrapper for legacy bulk OG image replacement. Use the canonical OG generator workflow instead. | manual | update-all-og-images.js | node tools/scripts/dev/update-all-og-images.js |
update-jsdoc-headers.js | Paired remediator for check-jsdoc-headers validator. Iterates scripts under operations/scripts/ and tools/scripts/, infers missing tags from path + existing content, applies a template-string scaffold. —check reports what would change; —write applies. Note: the inline template strings below this header use ${var} literals — they are template-literal source, not part of this script’s own JSDoc. | P6 | governance | node operations/scripts/remediators/governance/scaffold/update-jsdoc-headers.js [--check|--write] [--files <paths>] |
update-og-image.js | Deprecated wrapper for legacy OG image replacement. Use the canonical OG generator workflow instead. | manual | update-og-image.js | node tools/scripts/dev/update-og-image.js |
🔌 Integrators
| Script | Description | Pipeline | Concern | Usage |
|---|---|---|---|---|
blockchain-page-spec.js | Contract data pipeline module: blockchain-page-spec | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
branch-watch.js | Contract data pipeline module: branch-watch | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
catalog-config.js | Contract data pipeline module: catalog-config | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
cleanup-local-dev-sessions.js | Local dev session cleanup — preserves Mint on port 3333 and terminates stale Playwright plus non-3333 Mint session trees | manual | governance | node operations/scripts/integrators/governance/cleanup-local-dev-sessions.js [--apply] [--install-cron] [--remove-cron] [--keep-port 3333] |
constants.js | Contract data pipeline module: constants | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
contract-address-routes.test.js | manual | integrations | ||
contract-verifier.test.js | manual | integrations | ||
contracts-browser-harness.js | Unified scoped-browser harness for the contracts recovery browser gates. | manual | testing | node operations/tests/contracts-browser-harness.js |
convert-rss-to-mdx.js | Reads .rss files from v2/internal/assets/transcripts/, parses each entry (title, pubDate, link, excerpt, audio link, transcript), emits one MDX page per entry under v2/internal/assets/transcripts/{source}/{episode-slug}.mdx with proper frontmatter. Manual-use only — run when new RSS feeds are added or existing feeds need refresh. | manual | integrations | node operations/scripts/integrators/content/data/transforms/convert-rss-to-mdx.js [--dry-run] [--source <name>] |
cross-agent-packager.js | Reads the canonical skills catalog and execution manifest from ai-tools/ai-skills/, the latest audit reports from workspace/reports/, and the per-agent target rules. Produces a per-agent pack under ai-tools/agent-packs/{agent}/ (e.g. claude/CLAUDE.md, codex/skills-manifest.json, cursor/rules.md). Called by repo-audit-orchestrator.js when —agent-pack is set. | manual | governance | node operations/scripts/integrators/ai/agents/cross-agent-packager.js --agent-pack <name> --output-dir ai-tools/agent-packs |
docs-path-sync.js | Library module imported by page-links-audit.js, precommit-staged-cache.js, and run-all.js. Exports planRewrites(stagedMoves), applyRewrites(plan), checkDrift() so page renames don’t leave broken inbound links. Pairs with the page-integrity pipeline (dispatch-page-integrity.js indirectly via page-links-audit). | manual | health | const sync = require('operations/scripts/config/docs-path-sync'); |
export-portable-skills.js | Reads the template-skill catalog, projects each into the per-agent pack format (e.g. CLAUDE.md fragment, codex skill manifest entry, cursor rules entry). —check validates the per-agent packs match the templates; —write regenerates them. Used by cross-agent-packager and runnable standalone. | manual | governance | node operations/scripts/integrators/ai/agents/export-portable-skills.js --write|--check [--skills name[,name...]] |
fetch-config-flags.js | Scheduled-weekly integrator. Hits GitHub raw URL for go-livepeer’s flag-defining Go source files, parses flag definitions, normalises into a JSX export at snippets/data/config-flags/. Pairs with dispatch-config-flags.js. Required for the v2 config-flags reference page to stay current with go-livepeer releases. | P5 | maintenance | node operations/scripts/integrators/maintenance/data-feeds/fetch-config-flags.js [--dry-run] |
fetch-contract-addresses.js | Thin CLI entrypoint for the chain-first contracts pipeline. | manual | maintenance | node .github/scripts/fetch-contract-addresses.js [--dry-run] [--check] [--skip-verify] |
fetch-contract-addresses.test.js | manual | integrations | ||
fetch-discord-announcements.js | Reads channel ID + bot token from env, hits Discord API for each configured solution, transforms messages into a JSX module per solution and a shared community module. Writes outputs to snippets/data/social-feed-solutions/{product}/discordData.jsx and snippets/data/social-feeds/discordAnnouncementsData.jsx. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-discord-announcements.js [--dry-run] |
fetch-exchanges-data.js | Scheduled-weekly integrator. Hits CoinGecko’s tickers-by-coin endpoint for LPT, classifies each ticker by exchange type (centralised vs decentralised) using a known-exchange config, writes snippets/data/exchanges/exchangesData.jsx. Pairs with dispatch-exchanges-data.js. | P5 | maintenance | node operations/scripts/integrators/maintenance/data-feeds/fetch-exchanges-data.js [--dry-run] |
fetch-external-docs.sh | Iterates a config-mapped list of external repos and files, downloads each via curl, runs mdx-sanitise on the output, writes to snippets/composables/pages/shared/. Pre-build dependency for the dev preview (mint-dev.sh runs it first) so external composables exist before Mintlify boots. Also referenced by page-imports-audit which validates that referenced shared composables exist. | P2 | integrations | bash operations/scripts/integrators/content/data/fetching/fetch-external-docs.sh [flags] |
fetch-forum-data.js | Polls the public Livepeer Forum Discourse API, extracts topic title, slug, category, reply count, view count, and last-activity timestamp. Writes multiple sorted JSX exports to snippets/data/social-feeds/forumData.jsx. Consumed by the social-feeds composable on Community pages. Supports —dry-run. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-forum-data.js [--dry-run] |
fetch-ghost-blog-data.js | Reads RSS XML from the public Livepeer Ghost blog endpoint, parses entries (title, link, pubDate, excerpt, author), writes a sorted JSX export to snippets/data/social-feeds/ghostBlogData.jsx. No auth required. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-ghost-blog-data.js [--dry-run] |
fetch-github-discussions.js | Reads solution → repo mapping from config, hits GitHub GraphQL API for the Discussions feed, transforms entries (title, body excerpt, author, category, replies, upvotes) into JSX exports. Writes per-solution outputs to snippets/data/social-feed-solutions/{product}/githubDiscussionsData.jsx. Requires GITHUB_TOKEN (anonymous works for public repos but is rate-limited). | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-github-discussions.js [--dry-run] |
fetch-github-releases.js | Reads solution → repo mapping from config, hits GitHub REST API for the Releases endpoint, transforms entries (tag, title, body excerpt, author, published date, prerelease flag) into JSX exports. Writes per-solution outputs to snippets/data/social-feed-solutions/{product}/githubReleasesData.jsx. Requires GITHUB_TOKEN. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-github-releases.js [--dry-run] |
fetch-lpt-exchanges.sh | Hits CoinGecko’s public exchanges-by-token endpoint for the LPT coin ID, transforms the response (exchange name, pair, volume, trust score) into an MDX table, appends or updates the table in snippets/data/exchanges/lpt-exchanges.mdx. Manual-use only — documented in docs-guide/tooling/lpd-cli.mdx as a contributor workflow. | manual | integrations | bash operations/scripts/integrators/content/data/fetching/fetch-lpt-exchanges.sh [flags] |
fetch-luma-events.js | Reads the public Livepeer calendar at https://api2.luma.com/ics/get?entity=calendar&id=livepeer (no auth required — public iCal). Parses VEVENT blocks, extracts title/date/location/URL, splits into upcoming (start > now) and past (start <= now), sorts past desc / upcoming asc, writes a sorted JSX export to snippets/data/social-feeds/lumaEventsData.jsx. Matches the n8n workflow at snippets/assets/data/n8n/Luma-To-Mintlify.json so the schedule, endpoint, and transform are identical. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-luma-events.js [--dry-run] |
fetch-openapi-specs.sh | Iterates a config-mapped list of Livepeer service OpenAPI spec URLs, downloads each via curl, validates JSON/YAML parses, writes to api/{service}-openapi.{yaml,json}. Mintlify’s reference-page generator picks them up. Manual-use; not yet wired into a scheduled or post-merge pipeline (tracked as RFP gap “OpenAPI fetcher 2/5”). | manual | integrations | bash operations/scripts/integrators/content/data/fetching/fetch-openapi-specs.sh [flags] |
fetch-rss-blog-data.js | Reads solution → RSS URL mapping from config, parses each feed (title, link, pubDate, excerpt, author), transforms into JSX exports. Writes per-solution outputs to snippets/data/social-feed-solutions/{product}/blogData.jsx. Distinct from fetch-ghost-blog-data which handles only the main Livepeer Ghost blog. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-rss-blog-data.js [--dry-run] |
fetch-youtube-data.js | Reads channel ID + API key from env, hits YouTube Data API v3 for the channel’s uploads playlist, transforms entries into a sorted JSX export. Writes to snippets/data/social-feeds/youtubeData.jsx. Requires YOUTUBE_API_KEY. | P5 | copy | node operations/scripts/integrators/copy/social-feeds/fetch-youtube-data.js [--dry-run] |
generate-changelog.js | Unified changelog generator driven by config key (CHANGELOG_KEY env var). Fetches releases from GitHub/GitLab REST API, optionally enhances entries via an LLM call, optionally verifies on-chain (for the contracts changelog), renders to v2/solutions/{product}/changelog.mdx or v2/resources/changelog/{section}.mdx. Pairs with dispatch-changelogs.js. | P3, P5 | copy | CHANGELOG_KEY=contracts node operations/scripts/integrators/copy/changelogs/generate-changelog.js [--dry-run] [--enhance] [--contract] |
generate-localized-docs-json.js | Locale docs.json generator — produces localised docs.json variants from route-map and source docs.json | manual | integrations | node operations/scripts/integrators/content/language-translation/generate-localized-docs-json.js [flags] |
incidents.js | Contract data pipeline module: incidents | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
lock-release.js | Reads the current task ID from .codex/task-contract.yaml, removes .codex/locks-local/{task-id}.lock, validates the lock was held by the calling session (prevents accidental cross-session release). Called by task-finalise.js at end-of-session. | manual | governance | node operations/scripts/integrators/ai/codex/lock-release.js [flags] |
mdx-sanitise.js | Library used by all 6 social-feed integrators (fetch-forum-data, fetch-discord-announcements, fetch-ghost-blog-data, fetch-rss-blog-data, fetch-github-discussions, fetch-github-releases, fetch-youtube-data) to safely embed external content in the generated *.jsx data modules. Exports sanitiseForMdx, escapeForJsx, stripDangerousPatterns. | manual | copy | const { sanitiseForMdx, escapeForJsx } = require('operations/scripts/config/mdx-sanitise') |
mintlify-canonical-sync.js | Library imported by check-mintlify-canonical-sync.js (validator) and sync-mintlify-canonical-consumers.js (remediator). Exports listConsumers(), planRewrites(canonicalChanges), validateArchiveState(). Pairs with dispatch-canonical-sync.js as the shared logic layer. | manual | copy | const sync = require('operations/scripts/config/mintlify-canonical-sync'); |
og-image-policy.js | Library module (not a CLI). Exports resolveOgImage(route) → { src, alt, section, isFallback } given a v2/ route. Reads section → image mapping from snippets/assets/media/og-images/manifest.json. Treated as @type integrator because it’s the resolver bridge between the OG generation pipeline output and the consumer surfaces. | manual | discoverability | require('operations/scripts/config/og-image-policy').resolveOgImage(route) |
pipeline.js | Contract data pipeline module: pipeline | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
playwright-blockchain-contracts.js | CP-7: Verifies the blockchain-contracts page renders from generated pipeline data, | manual | testing | node operations/tests/playwright-blockchain-contracts.js |
playwright-contract-addresses.js | CP-6: Verifies the canonical contract-addresses reference page, the dedicated verifier page, | manual | testing | node operations/tests/playwright-contract-addresses.js |
project-showcase-sync.js | Reads pending submissions and review-decision rows from the configured Google Sheet, applies decisions (approve / reject / defer), writes the approved list to snippets/data/showcase-feed/showcaseData.jsx and showcaseDataPopulated.jsx. Consumed by snippets/composables/pages/home/project-showcase.mdx and snippets/composables/pages/showcase.mdx. Pairs with dispatch-showcase.js. | P5 | copy | node operations/scripts/integrators/copy/showcase/project-showcase-sync.js [--mode poll|dispatch] [--dry-run] |
publish-v2-internal-reports.js | Report publisher — publishes v2 internal audit reports to configured output locations | manual | governance | node operations/scripts/integrators/governance/pipelines/publish-v2-internal-reports.js [flags] |
solidity-parser.js | Contract data pipeline module: solidity-parser | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
spec.js | Contract data pipeline module: spec | manual | integrations | Internal module — imported by fetch-contract-addresses.js |
sync-codex-skills.js | Reads the canonical skill templates, applies Codex-specific projections (skill manifest format, companion resource paths), writes outputs under ai-tools/agent-packs/codex/. —check fails if Codex pack is stale; —write regenerates. Different from export-portable-skills which handles all agents — this one is Codex-only with deeper Codex-specific transformations. | manual | governance | node operations/scripts/integrators/ai/agents/sync-codex-skills.js [flags] |
task-cleanup.js | Lists local git worktrees and branches matching codex/, cross-references against merged PRs via gh CLI, removes worktrees whose branch is merged, removes stale .codex/locks-local/.lock files whose task PR has merged. Reports what it would prune in dry-run mode. | manual | governance | node operations/scripts/integrators/ai/codex/task-cleanup.js [--dry-run] [--write] |
task-preflight.js | Run before the Codex agent starts work. Creates the task-contract YAML with task ID, scope, acceptance criteria fields. Acquires a local execution lock at .codex/locks-local/{task-id}.lock to prevent parallel-session conflicts. Verifies branch is on codex/* prefix, no stash markers present, no other locks held. | manual | governance | node operations/scripts/integrators/ai/codex/task-preflight.js [flags] |
translate-docs.js | Translation generator — translates v2 MDX pages to target languages via OpenRouter API | manual | integrations | node operations/scripts/integrators/content/language-translation/translate-docs.js [flags] |
update-livepeer-release.js | Fetches or accepts the latest go-livepeer release tag and writes the canonical release data module. | manual | maintenance | node .github/scripts/update-livepeer-release.js [--version <tag>] |
validate-generated.js | Generated localisation validator — checks generated translated MDX files and route-map outputs for integrity | manual | integrations | node operations/scripts/integrators/content/language-translation/validate-generated.js [flags] |
🚦 Dispatch
| Script | Description | Pipeline | Concern | Usage |
|---|---|---|---|---|
auto-remediate.js | Central remediation dispatcher for lpd dev. Chains safe remediators in sequence: frontmatter keys, MDX safety, spelling, UK/US spelling, em-dashes, term capitalisation, page links, page imports. Each remediator runs independently — failures are logged but do not halt the chain. Always exits 0. | manual | governance | node tools/dev/remediation/auto-remediate.js --mode startup [--staged|--full] [--language en-gb|en-us] [--dry-run] [--json] |
blast-radius-scanner.js | PostToolUse hook for Edit/Write. When a file in snippets/components/, | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
check-codex-pr-overlap.js | Lists open codex/* PRs via gh CLI, extracts the changed-file set per PR, flags pairs whose changed-file sets intersect. Used by the Codex pre-task workflow to abort a session before it starts work on territory another agent already claimed. | P2 | governance | node operations/scripts/dispatch/ai/codex/check-codex-pr-overlap.js [flags] |
codex-commit.js | Invoked by the Codex AI agent at end-of-task. Inspects staged changes, validates branch is on codex/* prefix, checks for AI stash markers, generates a commit message that includes the task ID and follows the repo’s <type>(<scope>): <subject> convention. Pairs with the Codex skills-manifest entry for end-of-task commits. | manual | governance | node operations/scripts/dispatch/ai/codex/codex-commit.js [flags] |
completion-gate.js | PreToolUse hook for Write/Edit. Detects writes to session-log.txt, | manual | governance | Called automatically by Claude Code PreToolUse hook. Not invoked directly. |
create-codex-pr.js | Invoked by the Codex AI agent at end-of-task after codex-commit. Reads .codex/task-contract.yaml for task ID, summary, scope. Validates branch name matches the codex/* pattern, opens PR via gh CLI with required labels (codex, ai-generated, task:{id}) and body containing summary + acceptance criteria + linked task. Pairs with the Codex skills-manifest entry. | manual | governance | node operations/scripts/dispatch/ai/codex/create-codex-pr.js [flags] |
dispatch-action-docs.js | Self-doc pipeline: regenerate actions-library on workflow changes. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-action-docs.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-ai-sitemap.js | AI sitemap pipeline (PR drift check + post-merge regen + verify). | P3, P5, P6 | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-ai-sitemap.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-banned-words.js | Reads canonical lists from tools/lib/copy-governance/banned-{words,phrases}.txt via lint-copy.js. PR: detect + advisory. Scheduled: rolling-issue. Banned terms require manual rewrite (no auto-repair) — the rolling-issue model is the response. | P3, P5 | brand | node operations/scripts/dispatch/content/brand/dispatch-banned-words.js [--mode pr|scheduled] |
dispatch-brand-check.js | Runs every brand pipeline with —mode pr. Aggregates exit codes. | P3 | brand | node operations/scripts/dispatch/content/brand/dispatch-brand-check.js [--dry-run] |
dispatch-brand-repair.js | Repair-only mode with —verify, opens PR with fixes. | manual | brand | node operations/scripts/dispatch/content/brand/dispatch-brand-repair.js [--write] [--files <paths>|--staged|--full] |
dispatch-brand-scan.js | Full audit + repair (—write) + verify + rolling-issue. | P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-brand-scan.js [--write] [--verify] |
dispatch-canonical-sync.js | Detects drift between archived Mintlify sources and active consumers; repairs via sync-mintlify-canonical-consumers. | P3, P5, P6 | copy | node operations/scripts/dispatch/content/copy/dispatch-canonical-sync.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-catalogs.js | docs-guide catalog pipeline (PR check + post-merge regen). | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-catalogs.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-changelogs.js | Pipeline for changelog regeneration from upstream repo releases. | P3, P5, P6 | copy | node operations/scripts/dispatch/content/copy/dispatch-changelogs.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-codex-compliance.js | Codex branch + task contract compliance. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-codex-compliance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-companions.js | AI companion manifest pipeline (PR drift check + post-merge regen + verify). | P3, P5, P6 | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-companions.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-component-registry.js | Component registry pipeline (PR drift check + post-merge regen + component validators). | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-component-registry.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-config-flags.js | go-livepeer config flags fetcher. | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-config-flags.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-content-quality.js | Mode-driven orchestrator over docs-quality-and-freshness-audit.js. PR mode runs audit on staged with advisory comment. Scheduled mode runs full audit, applies deterministic fixes via repair-content-quality (Phase 3.X), escalates residual via rolling-issue. | P3, P5, P6 | health | node operations/scripts/dispatch/content/health/dispatch-content-quality.js [--mode pr|scheduled|manual] [--dry-run|--write] [--files <paths>|--staged|--full] |
dispatch-contract-addresses.js | Contract addresses fetch from on-chain. | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-contract-addresses.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-contract-shadow.js | Shadow contract pipeline (verify production matches shadow). | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-contract-shadow.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-copy-check.js | PR meta for copy concern. | P3 | copy | node operations/scripts/dispatch/content/copy/dispatch-copy-check.js [--dry-run|--write] [--verify] |
dispatch-copy-repair.js | Manual repair meta for copy concern. | manual | copy | node operations/scripts/dispatch/content/copy/dispatch-copy-repair.js [--dry-run|--write] [--verify] |
dispatch-copy-update.js | Scheduled meta for copy integrators. | P5 | copy | node operations/scripts/dispatch/content/copy/dispatch-copy-update.js [--dry-run|--write] [--verify] |
dispatch-discoverability-check.js | PR meta for discoverability concern. | P3 | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-check.js [--dry-run|--write] [--verify] |
dispatch-discoverability-generate.js | Post-merge meta for discoverability generators. | manual | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-generate.js [--dry-run|--write] [--verify] |
dispatch-discoverability-repair.js | Manual repair meta for discoverability concern. | manual | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-repair.js [--dry-run|--write] [--verify] |
dispatch-docs-index.js | docs-index.json pipeline (PR drift check + post-merge regen). | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-docs-index.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-em-dashes.js | Detects em-dashes in v2 MDX and replaces with sentence-appropriate punctuation. PR: detect + advisory. Scheduled: scan + repair + verify + rolling-issue. Manual: repair-only with —verify. | P3, P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-em-dashes.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-exchanges-data.js | CoinGecko exchanges data fetcher. | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-exchanges-data.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-folder-allowlist.js | Pipeline orchestrator. Mode-driven entry point: —mode pr (detect + advisory comment), —mode scheduled (audit + repair + verify + rolling issue), —mode manual (repair-only with —verify). Wraps the three atomic scripts (check / audit / repair) into one composable lifecycle. Independently runnable locally via node dispatch-folder-allowlist.js --dry-run. | P2, P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-folder-allowlist.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--folder <path>] |
dispatch-governance-check.js | PR meta for governance concern. | P3 | governance | node operations/scripts/dispatch/governance/dispatch-governance-check.js [--dry-run|--write] [--verify] |
dispatch-governance-generate.js | Self-doc generate meta. | manual | governance | node operations/scripts/dispatch/governance/dispatch-governance-generate.js [--dry-run|--write] [--verify] |
dispatch-governance-map.js | Governance markers validity + drift repair pipeline. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-governance-map.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-governance-scan.js | Scheduled meta for governance scans. | P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-governance-scan.js [--dry-run|--write] [--verify] |
dispatch-governance-sync.js | Post-merge meta for governance state repair. | manual | governance | node operations/scripts/dispatch/governance/dispatch-governance-sync.js [--dry-run|--write] [--verify] |
dispatch-grammar-en-gb.js | Detects UK English grammar issues (subject-verb agreement, article use, comma placement) and applies safe deterministic fixes via the EN-GB homogeniser. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only. | P3, P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-grammar-en-gb.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-health-check.js | Runs every health pipeline dispatcher with —mode pr in sequence. Aggregates exit codes. Used by dispatch-health.yml on pull_request events. | P3 | health | node operations/scripts/dispatch/content/health/dispatch-health-check.js [--dry-run|--write] [--files <paths>|--staged|--full] |
dispatch-health-repair.js | Runs repair-only mode across health pipelines that support remediation. Opens PR with verified fixes. | manual | health | node operations/scripts/dispatch/content/health/dispatch-health-repair.js [--dry-run|--write] [--files <paths>|--staged|--full] |
dispatch-health-scan.js | Runs every health pipeline with —mode scheduled. Full audit + repair (if —write) + verify + rolling issue routing. | P5, P6 | health | node operations/scripts/dispatch/content/health/dispatch-health-scan.js [--dry-run|--write] [--verify] |
dispatch-jsdoc-headers.js | 11-tag JSDoc enforcement pipeline. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-jsdoc-headers.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-large-assets.js | Large asset sync to docs-v2-assets branch. | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-large-assets.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-llms-files.js | llms.txt + llms-full.txt pipeline. | P3, P5, P6 | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-llms-files.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-maintenance-check.js | PR meta for maintenance concern. | P3 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-maintenance-check.js [--dry-run|--write] [--verify] |
dispatch-maintenance-generate.js | Post-merge meta for maintenance generators. | manual | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-maintenance-generate.js [--dry-run|--write] [--verify] |
dispatch-maintenance-update.js | Scheduled meta for maintenance integrators. | P5 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-maintenance-update.js [--dry-run|--write] [--verify] |
dispatch-new-file-governance.js | New file metadata enforcement pipeline. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-new-file-governance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-og-images.js | OG image pipeline (Puppeteer generate + verify per page). | P3, P5, P6 | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-og-images.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-openapi-reference.js | Wraps the existing OpenAPI audit + reference regen flow. PR mode: drift check only. Scheduled: full audit + open PR if drift. Manual: regenerate reference docs from canonical spec. | P3, P5, P6 | health | node operations/scripts/dispatch/content/health/dispatch-openapi-reference.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-ownerless-language.js | Detects owner-dependent phrasing in v2 MDX; repairs via repair-ownerless-language with —verify. | P3, P5, P6 | copy | node operations/scripts/dispatch/content/copy/dispatch-ownerless-language.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-page-integrity.js | Mode-driven orchestrator wrapping the existing page-integrity-dispatch.js chain. —mode pr runs audits on staged + previews repairs. —mode scheduled runs full audit + repair —verify + rolling issue for residual. —mode manual runs repairs only. Replaces direct workflow calls to page-integrity-dispatch.js with the canonical pipeline contract. | P3, P5, P6 | health | node operations/scripts/dispatch/content/health/dispatch-page-integrity.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-page-rendering.js | Mode-driven orchestrator over test-v2-pages.js and check-broken-links.js. Render errors typically need human review, so the cycle is: detect (Puppeteer + link check) → repair (broken-link replacements where deterministic) → escalate via rolling-issue. | P3, P5 | health | node operations/scripts/dispatch/content/health/dispatch-page-rendering.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-page-structure.js | Mode-driven orchestrator over the 8 structure validators and their paired remediators. PR mode runs validators in —staged and posts advisory. Scheduled mode runs validators repo-wide, applies safe repairs, escalates residual via rolling-issue. Manual mode runs only remediators with —verify. | P3, P5, P6 | health | node operations/scripts/dispatch/content/health/dispatch-page-structure.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-pipelines.js | Weekly governance repair orchestrator wrapper. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-pipelines.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-proper-nouns.js | Detects lowercase/wrong-case proper nouns and corrects. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only. | P3, P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-proper-nouns.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-release-version.js | go-livepeer release version fetcher. | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-release-version.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-root-governance.js | Root governance artifact regen + sync check. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-root-governance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-script-inventory.js | Script registry inventory pipeline. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-script-inventory.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-script-locations.js | Script folder placement enforcement. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-script-locations.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-script-registry.js | Script registry self-doc pipeline. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-script-registry.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-sdk-clients.js | SDK client generation (Speakeasy wrapper). | P3, P5, P6 | maintenance | node operations/scripts/dispatch/content/maintenance/dispatch-sdk-clients.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-seo-metadata.js | SEO metadata repair pipeline (frontmatter completeness, descriptions). | P3, P5, P6 | discoverability | node operations/scripts/dispatch/content/discoverability/dispatch-seo-metadata.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-showcase.js | Pipeline for project showcase data sync. | P3, P5, P6 | copy | node operations/scripts/dispatch/content/copy/dispatch-showcase.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-social-feeds.js | Pipeline for scheduled social feed integration (Discord, Forum, Ghost, GitHub, RSS, YouTube). Matrix per-source under one dispatcher. | P3, P5, P6 | copy | node operations/scripts/dispatch/content/copy/dispatch-social-feeds.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-spelling.js | Detects US spellings and corrects to UK forms. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only with —verify. | P3, P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-spelling.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-style-tokens.js | Detects style tokens not from the brand system. Scheduled: audit + repair (Phase 3.X wire). Manual: repair-only. | P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-style-tokens.js [--mode scheduled|manual] |
dispatch-voice-register.js | Detects voice violations (hedging, conditionals, weakened value, per-audience prohibited phrases) and applies safe deterministic fixes. PR: detect + advisory. Scheduled: scan + repair + verify. Manual: repair-only with —verify. | P3, P5, P6 | brand | node operations/scripts/dispatch/content/brand/dispatch-voice-register.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-wcag.js | Mode-driven pipeline orchestrator. —mode pr runs check-wcag (validator) and posts advisory. —mode scheduled runs audit-wcag (engine full scan) + repair-wcag (—write —verify) + rolling issue for residual. —mode manual runs repair-wcag with —verify against staged or specified files. Independently runnable locally. | P3, P5, P6 | health | node operations/scripts/dispatch/content/health/dispatch-wcag.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] [--files <paths>|--staged|--full] |
dispatch-workflow-governance.js | Workflow YAML governance header pipeline. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-workflow-governance.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
dispatch-workspace-retention.js | Workspace structure + retention audit. | P3, P5, P6 | governance | node operations/scripts/dispatch/governance/dispatch-workspace-retention.js [--mode pr|scheduled|manual] [--dry-run|--write] [--verify] |
docs-page-research-pr-report.js | Docs page research PR report — runs the fact-check research runner on changed docs pages and emits an advisory PR artifact summarizing claim families, contradictions, unresolved factual risk, and propagation follow-up. | manual | health | node operations/scripts/dispatch/content/veracity/docs-page-research-pr-report.js [flags] |
docs-page-research-pr-report.test.js | Tests docs-page-research-pr-report.js — validates changed-file advisory reporting for the fact-check research runner. | manual | node operations/tests/unit/docs-page-research-pr-report.test.js [flags] | |
docs-research-packet.js | Docs research packet generator — derives nav, manifest, or explicit path scope; runs the research stack tranche-by-tranche; and writes reusable packet reports plus a master rollup. | manual | health | node operations/scripts/dispatch/content/veracity/docs-research-packet.js [flags] |
edit-loop-guard.js | PostToolUse hook for Edit/Write. Tracks per-file edit counts within a session. | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
friction-logger.js | UserPromptSubmit hook. Scans user messages for frustration indicators | manual | governance | Called automatically by Claude Code UserPromptSubmit hook. Not invoked directly. |
governance-pipeline.js | Run the bounded governance repair pipeline and regenerate the active repo-ops governance reports. | P6 | governance | node operations/scripts/dispatch/governance/pipelines/governance-pipeline.js [--dry-run] [--auto-commit] [--report-only] [--strict] [--staged|--files <path[,path...]>|--full] |
grep-loop-guard.js | Tracks consecutive Grep calls that return no results. At 3 in a row, | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
headless-batch.sh | Executes a prompt against files non-interactively with restricted tools. Use for bulk quality checks, changelog regeneration, stale reference scans, and other well-defined batch tasks. | manual | governance | ./operations/scripts/dispatch/governance/headless-batch.sh --prompt "..." --tools "Read,Grep,Glob" --output report.md |
install.sh | Installs git hooks by routing this worktree to .githooks via worktree-local core.hooksPath | manual | governance | bash .githooks/install.sh [flags] |
mdx-constraints-injector.js | UserPromptSubmit hook. Keyword-matches the user message for MDX/component/page | manual | governance | Called automatically by Claude Code UserPromptSubmit hook. Not invoked directly. |
mdx-frontmatter-sanitise.js | PostToolUse hook for Edit/Write on ANY .mdx file. Auto-fixes (1) duplicate frontmatter keys, (2) em-dash characters in user-facing text, and (3) single-quoted frontmatter scalars (standardises to double quotes). All fixes are applied silently to the file already on disk; the hook only emits a systemMessage when something was changed. | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
mdx-render-gate.js | PreToolUse hook for Write/Edit. Reads the verification state written by | manual | governance | Called automatically by Claude Code PreToolUse hook. Not invoked directly. |
mdx-render-verify.js | PostToolUse hook for Edit/Write on v2 .mdx files. Launches Puppeteer, | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
mdx-validate-hook.js | PostToolUse hook for Edit/Write on .mdx files. Uses the shared | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
message-backup.js | UserPromptSubmit hook. If a message is longer than 200 chars, saves it to | manual | governance | Called automatically by Claude Code UserPromptSubmit hook. Not invoked directly. |
move-detect-hook.js | PostToolUse hook on Bash. Detects mv/git mv commands targeting v2/ paths, | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
orchestrator-guides-research-review.js | Orchestrator guides research review packet wrapper — delegates to the generic docs-research-packet engine with the live Orchestrators Guides nav scope and legacy default output root. | manual | health | node operations/scripts/audits/content/veracity/orchestrator-guides-research-review.js [flags] |
page-integrity-dispatch.js | Orchestrate the page-integrity family from canonical operations scripts so audit, repair, rerun, and report publication share one stable workflow contract. | P6 | health | node operations/scripts/dispatch/content/health/page-integrity-dispatch.js [--staged|--files <paths>|--tab <tab>] [--strict] [--no-repair] [--issue-mode off|plan] [--output-dir <dir>] |
page-integrity-rolling-issue.js | Provide a stable rolling-issue contract for page-integrity dispatch runs so unresolved link and import failures stay visible in GitHub automation. | manual | health | node operations/scripts/dispatch/content/health/page-integrity-rolling-issue.js [flags] |
phase-gate-hook.js | PostToolUse hook for Edit/Write. Reads phase-gate.jsonl and emits unverified | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
post-remediation-verify.js | Looks up validators for a given remediator from the registry, runs them | manual | governance | node operations/scripts/dispatch/governance/post-remediation-verify.js --remediator <path> --files <a,b,c> [--revert-on-fail] [--json] |
post-tool-verify.js | Tracks consecutive failures for circuit breaker. Fires after tool use failures. | manual | governance | Called automatically by Claude Code PostToolUseFailure hook. Not invoked directly. |
pre-commit | Pre-commit hook — hard gates only (syntax, security, safety). All soft checks run in GitHub Actions PR workflows. | P1 | bash .githooks/pre-commit [flags] | |
pre-commit-no-deletions | Variant pre-commit hook that blocks file deletions (safety net for content preservation) | manual | bash .githooks/pre-commit-no-deletions [flags] | |
pre-commit-v1 | Pre-commit hook orchestrator — runs structural checks, unit tests, codex validation, and docs-index freshness check before allowing commit | P1 | pre-commit-v1 | bash .githooks/pre-commit [flags] |
pre-compact-checkpoint.js | Fires before Claude Code compacts context in long sessions. Reads the | manual | governance | Called automatically by Claude Code PreCompact hook. Not invoked directly. |
pre-push | Pre-push hook — blocks push if AI stash files present, codex locks stale, or task contract invalid | P2 | bash .githooks/pre-push [flags] | |
pre-tool-guard.js | Mechanically enforces co-work rules before tool execution. Blocks destructive git, public posts, and unconfirmed writes. | manual | governance | Called automatically by Claude Code PreToolUse hook. Not invoked directly. |
read-logger.js | PostToolUse hook on Read. Logs file paths to a session-scoped temp file. | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
repo-audit-orchestrator.js | Repo audit orchestrator — dispatches all static analysis validators in sequence. Supports —mode (static/full), —scope (full/changed), —quarantine, —agent-pack. | manual | governance | node operations/scripts/audits/governance/repo/repo-audit-orchestrator.js [flags] |
run-all.js | Main test-suite orchestrator for local, pre-commit, and package-script execution across the governed documentation validators. | P1, P2, P3 | governance | node operations/tests/run-all.js [flags] |
run-pr-checks.js | Changed-file PR validation orchestrator for the branch-health lane, including the strict page-integrity dispatch on changed docs pages. | P2, P3 | governance | node operations/tests/run-pr-checks.js [flags] |
run-solutions-social-fetch.js | Mirrors what dispatch-social-feeds.yml does in CI but with .env support, selective —mode (e.g. only forum+youtube), and —skip flag for offline-only fetchers. Iterates the configured fetchers under operations/scripts/integrators/copy/social-feeds/, runs each, captures success/failure summary. Local-use only — not in any GitHub Actions workflow. | manual | integrations | node operations/scripts/dispatch/content/data/run-solutions-social-fetch.js [--mode forum,youtube] [--dry-run] [--env path/to/.env] [--skip discord] |
scope-checkpoint.js | PostToolUse hook for Edit/Write. Tracks total edit count per session. | manual | governance | Called automatically by Claude Code PostToolUse hook. Not invoked directly. |
server-lifecycle.js | SessionStart hook + CLI tool. Auto-starts the Mintlify dev server via | manual | governance | node server-lifecycle.js [health|restart [scope-prefix]] |
server-manager.js | Manages Mintlify dev server lifecycle for browser tests (start/stop/health-check) | manual | governance | node .githooks/server-manager.js [flags] |
session-register.js | SessionStart hook that registers this session in a shared registry file. | manual | governance | Called automatically by Claude Code hooks. Not invoked directly. |
session-state.js | Reads ALL active plans and live project state. Run at session start. | manual | governance | node operations/scripts/dispatch/governance/session-state.js |
sync-generated-files.js | Dispatches generator scripts to sync generated catalog/index files, then validates banners. | P1 | governance | node operations/scripts/dispatch/governance/pipelines/sync-generated-files.js --write | --check [--staged] |
task-finalise.js | End-of-session gate for the Codex AI agent. Validates that .codex/task-contract.yaml acceptance criteria are checked, runs validate-locks, runs any registered post-task validators, runs lock-release. If any step fails, blocks the session close so the agent must address it. | manual | governance | node operations/scripts/dispatch/ai/codex/task-finalise.js [flags] |
verify-browser.js | Verifies browser availability for Puppeteer-based integration tests | manual | governance | node .githooks/verify-browser.js [flags] |
verify.sh | Pre-commit sub-hook — verifies file-walker is available and runs structural checks on staged files | manual | governance | bash .githooks/verify.sh [flags] |
💬 Interfaces
| Script | Description | Pipeline | Concern | Usage |
|---|---|---|---|---|
assign-reviewers.js | Three-phase reviewer assignment: (1) gate checks if PR is eligible | manual | governance | Called by github-script in workflow — not invoked directly |
close-linked-issues.js | Parses PR body for closing keywords (fixes/closes/resolves #N), | manual | governance | Called by github-script in workflow — not invoked directly |
discord-issue-intake.js | Validates repository_dispatch payload from Discord bot (n8n workflow), | manual | governance | Called by github-script in workflow — not invoked directly |
issue-auto-label.js | Detects issue template type (docs_page_issue, bug_report, feature_request, etc.), | manual | governance | Called by github-script in workflow — not invoked directly |
issue-indexer.js | Searches all docs-v2 labelled issues, sorts by classification/priority, | manual | governance | Called by github-script in workflow — not invoked directly |
load-labels.js | Returns the labels object and managed_prefixes from the central config. | manual | governance | const { labels, managedPrefixes } = require('./lib/load-labels.js'); |
notify-linked-issues.js | Parses PR body for closing keywords and Task: #N patterns, | manual | governance | Called by github-script in workflow — not invoked directly |
rolling-issue.js | Provides ensureLabels(), upsert(), and close() for the rolling issue | manual | governance | const ri = require('./lib/rolling-issue.js'); await ri.upsert({ github, context, label, title, body }); |
📚 Library Modules — 57
📚 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
⚠️ 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 |