Skip to main content
Generation Script: This file is generated from script(s): 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 tests/unit/script-docs.test.js --write --rebuild-indexes.

​
.githooks

ScriptSummaryUsageDomain
.githooks/install.shInstalls git hooks by routing this worktree to .githooks via worktree-local core.hooksPathbash .githooks/install.sh [flags]docs
.githooks/pre-commitPre-commit hook orchestrator — runs structural checks, unit tests, codex validation, and docs-index freshness check before allowing commitbash .githooks/pre-commit [flags]docs
.githooks/pre-commit-no-deletionsVariant pre-commit hook that blocks file deletions (safety net for content preservation)bash .githooks/pre-commit-no-deletions [flags]docs
.githooks/pre-pushPre-push hook — blocks push if AI stash files present, codex locks stale, or task contract invalidbash .githooks/pre-push [flags]docs
.githooks/server-manager.jsManages Mintlify dev server lifecycle for browser tests (start/stop/health-check)node .githooks/server-manager.js [flags]docs
.githooks/verify-browser.jsVerifies browser availability for Puppeteer-based integration testsnode .githooks/verify-browser.js [flags]docs
.githooks/verify.shPre-commit sub-hook — verifies file-walker is available and runs structural checks on staged filesbash .githooks/verify.sh [flags]docs

​
.github/scripts

ScriptSummaryUsageDomain
.github/scripts/fetch-forum-data.jsFetches latest topics and posts from Livepeer Forum API, writes to snippets/automations/forum/node .github/scripts/fetch-forum-data.js [flags]docs
.github/scripts/fetch-ghost-blog-data.jsFetches blog posts from Ghost CMS API, writes to snippets/automations/blog/node .github/scripts/fetch-ghost-blog-data.js [flags]docs
.github/scripts/fetch-youtube-data.jsFetches video data from YouTube Data API, writes to snippets/automations/youtube/node .github/scripts/fetch-youtube-data.js [flags]docs
.github/scripts/project-showcase-sync.jsFetches project showcase data from external source, writes to snippets/automations/showcase/node .github/scripts/project-showcase-sync.js [flags]docs

​
tests

ScriptSummaryUsageDomain
tests/integration/browser.test.jsPuppeteer browser integration test — renders pages from docs.json and checks for console errors, load failures, and visual regressionsnode tests/integration/browser.test.js [flags]docs
tests/integration/domain-pages-audit.jsAudits deployed docs page HTTP status codes (v1, v2, or both) and emits a stable JSON reportnode tests/integration/domain-pages-audit.js [flags]docs
tests/integration/mdx-component-runtime-smoke.jsSmoke-tests sentinel MDX routes for runtime component failures, focused on page-killing render errors from MDX-imported JSX modules.node tests/integration/mdx-component-runtime-smoke.js [--routes route[,route...]] [--base-url http://localhost:3000]docs
tests/integration/openapi-reference-audit.jsComprehensive OpenAPI spec validation — checks references, schemas, examples. Supports —strict (validate), —fix (repair), and report modes.node tests/integration/openapi-reference-audit.js [flags]docs
tests/integration/v2-link-audit.jsComprehensive V2 MDX link audit — checks internal links, external links, anchor refs. Supports —staged, —full, —strict, —write-links modes.node tests/integration/v2-link-audit.js [flags]docs
tests/integration/v2-link-audit.selftest.jsSelf-test suite for v2-link-audit.js — validates audit logic against known fixturesnode tests/integration/v2-link-audit.selftest.js [flags]docs
tests/integration/v2-wcag-audit.jsWCAG accessibility audit for v2 pages — checks heading hierarchy, alt text, ARIA. Supports —fix mode for auto-repair.node tests/integration/v2-wcag-audit.js [flags]docs
tests/integration/v2-wcag-audit.selftest.jsSelf-test suite for v2-wcag-audit.js — validates WCAG audit logic against known fixturesnode tests/integration/v2-wcag-audit.selftest.js [flags]docs
tests/run-all.jsTest orchestrator — dispatches all unit test suites. Called by pre-commit hook and npm test.node tests/run-all.js [flags]docs
tests/run-pr-checks.jsPR orchestrator — runs changed-file scoped validation checks for pull request CI. Dispatches per-file validators based on PR diff.node tests/run-pr-checks.js [flags]docs
tests/unit/ai-tools-registry.test.jsValidates the AI-tools registry contract, full tracked ai-tools coverage, and the Wave 1 inventory source-of-truth boundary.node tests/unit/ai-tools-registry.test.js [--staged|--files path[,path]]docs
tests/unit/audit-script-inventory-repair-rules.test.jsTests audit-script-inventory repair hardening rules for judgement-field backfill and pipeline safety.node tests/unit/audit-script-inventory-repair-rules.test.jsdocs
tests/unit/check-agent-docs-freshness.test.jsTests the agent governance freshness validator against the canonical runtime file set.node tests/unit/check-agent-docs-freshness.test.jsdocs
tests/unit/codex-commit.test.jsTests codex-commit.js — validates commit message generation and contract compliancenode tests/unit/codex-commit.test.js [flags]docs
tests/unit/codex-safe-merge-with-stash.test.jsTests codex-safe-merge-with-stash.js — asserts the deprecated stash helper hard-fails and points callers to the supported Codex lifecyclenode tests/unit/codex-safe-merge-with-stash.test.js [flags]docs
tests/unit/codex-skill-sync.test.jsTests sync-codex-skills.js — validates skill file and companion bundle synchronisation between sourcesnode tests/unit/codex-skill-sync.test.js [flags]docs
tests/unit/codex-task-cleanup.test.jsTests codex/task-cleanup.js — verifies safe worktree pruning, dirty-worktree preservation, branch pruning, and repo-root protectionnode tests/unit/codex-task-cleanup.test.js [flags]docs
tests/unit/codex-task-preflight.test.jsTests codex/task-preflight.js — verifies managed worktree default behavior and the explicit in-place overridenode tests/unit/codex-task-preflight.test.js [flags]docs
tests/unit/component-governance-generators.test.jsVerifies component governance generators produce coherent registry, usage-map, and docs outputs.node tests/unit/component-governance-generators.test.jsdocs
tests/unit/component-governance-utils.test.jsVerifies shared component governance utility parsing, scanning, and archive exclusion behavior.node tests/unit/component-governance-utils.test.jsdocs
tests/unit/components/TEMPLATE.test.jsTemplate for category-scoped component unit tests.node tests/unit/components/TEMPLATE.test.jsdocs
tests/unit/copy-lint.test.jsCopy lint unit suite — validates fixture-driven copy-governance checks and runs changed-file scoped lint aggregation for authored docs pages.node tests/unit/copy-lint.test.js [--staged] [--files <a,b,c>]docs
tests/unit/create-codex-pr.test.jsTests create-codex-pr.js — validates PR creation logic and branch namingnode tests/unit/create-codex-pr.test.js [flags]docs
tests/unit/docs-authoring-rules.test.jsVerifies guide-layout warning rules and deterministic code-block icon repair for authored docs pages.node tests/unit/docs-authoring-rules.test.jsdocs
tests/unit/docs-fact-registry.test.jsTests docs-fact-registry.js — validates claim-family registry schema checks and normalized loading by domain.node tests/unit/docs-fact-registry.test.js [flags]docs
tests/unit/docs-guide-sot.test.jsValidates docs-guide source-of-truth coverage, README pointers, and generated index freshnessnode tests/unit/docs-guide-sot.test.js [flags]docs
tests/unit/docs-navigation.test.jsValidates docs.json page-entry syntax, reports missing routes, warns on orphaned canonical v2 pages, suggests remaps, and optionally applies approved remapsnode tests/unit/docs-navigation.test.js [flags]docs
tests/unit/docs-page-research-pr-report.test.jsTests docs-page-research-pr-report.js — validates changed-file advisory reporting for the fact-check research runner.node tests/unit/docs-page-research-pr-report.test.js [flags]docs
tests/unit/docs-page-research.test.jsTests docs-page-research.js — validates claim extraction, contradiction detection, and evidence-source adapters for the experimental research runner.node tests/unit/docs-page-research.test.js [flags]docs
tests/unit/docs-page-scope.test.jsVerifies generated authored-page scope helpers so warning-only validators skip generated docs pages while keeping authored pages in scope.node tests/unit/docs-page-scope.test.jsdocs
tests/unit/docs-path-sync.test.jsUnit tests for docs path sync — validates staged move detection, deterministic docs.json/reference rewrites, validator behavior, and remediator write mode.node tests/unit/docs-path-sync.test.jsdocs
tests/unit/docs-research-adjudication.test.jsTests docs-research-adjudication.js — validates adjudication-ledger schema, report-aware outcome recording, and trust-tier summary rules for measured research-skill review outcomes.node tests/unit/docs-research-adjudication.test.js [flags]docs
tests/unit/docs-research-packet.test.jsTests docs-research-packet.js — validates nav, manifest, and path tranche derivation plus packet-summary rollups for the generic research packet engine.node tests/unit/docs-research-packet.test.jsdocs
tests/unit/docs-route-scope.test.jsVerifies docs.json-derived tab and group route scopes resolve to live files.node tests/unit/docs-route-scope.test.jsdocs
tests/unit/export-portable-skills.test.jsTests export-portable-skills.js — validates portable skill export packs from canonical templates.node tests/unit/export-portable-skills.test.js [flags]docs
tests/unit/frontmatter-taxonomy.test.jsVerifies shared docs frontmatter taxonomy normalization and purpose mapping.node tests/unit/frontmatter-taxonomy.test.jsdocs
tests/unit/generated-artifacts-policy.test.jsTests generated artifact governance manifest — validates enums, path matching, and hook-policy expectationsnode tests/unit/generated-artifacts-policy.test.jsdocs
tests/unit/legacy-root-v1-redirects.test.jsValidates legacy root-to-v1 redirect integrity, docs.json sync, root catch-all fallbacks, and legacy fallback-page cleanup behavior.node tests/unit/legacy-root-v1-redirects.test.jsdocs
tests/unit/links-imports.test.jsValidates MDX internal links and snippet import paths are resolvablenode tests/unit/links-imports.test.js [flags]docs
tests/unit/lpd-scoped-mint-dev.test.jsTests lpd scoped mint-dev functionality — validates dev server scope filteringnode tests/unit/lpd-scoped-mint-dev.test.js [flags]docs
tests/unit/mdx-component-runtime-smoke.test.jsUnit tests for the MDX runtime smoke helpers — covers arg parsing, sentinel route selection, trigger logic, and failure classification.node tests/unit/mdx-component-runtime-smoke.test.jsdocs
tests/unit/mdx-component-scope.test.jsUnit tests for the MDX-facing component scope validator — covers unsafe private helpers, safe inline logic, and imported helper patterns.node tests/unit/mdx-component-scope.test.jsdocs
tests/unit/mdx-guards.test.jsEnforces MDX guardrails — globals imports, math delimiters, markdown table line breaksnode tests/unit/mdx-guards.test.js [flags]docs
tests/unit/mdx-safe-markdown.test.jsFixture-driven unit tests for repo-wide MDX-safe markdown repair and validation helpers.node tests/unit/mdx-safe-markdown.test.jsdocs
tests/unit/mdx.test.jsValidates MDX syntax and structure — checks for parse errors, invalid JSX, broken componentsnode tests/unit/mdx.test.js [flags]docs
tests/unit/migrate-assets-to-branch.test.jsUnit 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 reponode tests/unit/migrate-assets-to-branch.test.jsdocs
tests/unit/og-image-policy.test.jsUnit tests for og-image-policy — validates route mapping, locale asset selection, fallback assignment, and URL guardrails.node tests/unit/og-image-policy.test.js [flags]docs
tests/unit/openapi-reference-audit.test.jsUnit tests for openapi-reference-audit.js — tests individual audit rules and fix logicnode tests/unit/openapi-reference-audit.test.js [flags]docs
tests/unit/openapi-rolling-issue.test.jsTests OpenAPI rolling issue tracker — validates issue creation and dedup logicnode tests/unit/openapi-rolling-issue.test.js [flags]docs
tests/unit/orchestrator-guides-research-review.test.jsTests orchestrator-guides-research-review.js — validates live Orchestrators Guides tranche extraction, report summary helpers, and registry-drift detection for the research packet generator.node tests/unit/orchestrator-guides-research-review.test.jsdocs
tests/unit/ownerless-governance.test.jsValidates the ownerless governance manifest, primary gate-layer contract, and forbidden human-owner dependency in governed policy and GitHub surfaces.node tests/unit/ownerless-governance.test.js [--staged|--files a,b]docs
tests/unit/precommit-staged-cache.test.jsTests precommit-staged-cache.js — validates staged-tree cache hits, invalidation, and pruningnode tests/unit/precommit-staged-cache.test.jsdocs
tests/unit/quality.test.jsContent quality checks — validates frontmatter completeness, thin content detection, placeholder flaggingnode tests/unit/quality.test.js [flags]docs
tests/unit/repair-governance.test.jsTests repair-governance.js for safe dry-run, fix, rollback, strict exit handling, and workflow contract coverage.node tests/unit/repair-governance.test.jsdocs
tests/unit/repair-spelling.test.jsUnit tests for repair-spelling.js — validates deterministic spelling fixes and exclusion rangesnode tests/unit/repair-spelling.test.js [flags]docs
tests/unit/repo-audit-pipeline.test.jsTests repo-audit-orchestrator.js pipeline — validates mode/scope combinations and report outputnode tests/unit/repo-audit-pipeline.test.js [flags]docs
tests/unit/root-allowlist-format.test.jsValidates that .allowlist stays machine-readable, root-only, and aligned with the canonical agent root layout.node tests/unit/root-allowlist-format.test.jsdocs
tests/unit/run-pr-checks.test.jsTests run-pr-checks lane parsing, branch-health registry coverage, and incremental summary/progress behavior.node tests/unit/run-pr-checks.test.jsdocs
tests/unit/script-docs.test.jsEnforces script header schema, keeps group script indexes in sync, and builds aggregate script catalognode tests/unit/script-docs.test.js [flags]docs
tests/unit/skill-docs.test.jsValidates governed skill documentation frontmatter, references, and contract integrity for canonical templates and local skill files.node tests/unit/skill-docs.test.js [--staged] [--files path[,path]]docs
tests/unit/spelling.test.jsSpelling check — validates content against custom dictionary with en-GB rulesnode tests/unit/spelling.test.js [flags]docs
tests/unit/style-guide.test.jsStyle guide compliance — checks en-GB conventions, heading case, formatting rulesnode tests/unit/style-guide.test.js [flags]docs
tests/unit/ui-template-generator.test.jsValidates UI template generator snippet outputs are valid JSON, deterministic, and safe for after-< component insertionnode tests/unit/ui-template-generator.test.js [flags]docs
tests/unit/usefulness-journey.test.jsTests journey-check evaluation logic against fixture pages.node tests/unit/usefulness-journey.test.jsdocs
tests/unit/usefulness-rubric.test.jsTests rubric-based scoring logic against fixture pages.node tests/unit/usefulness-rubric.test.jsdocs
tests/unit/v2-folder-governance-cleanup-matrix.test.jsUnit tests for the v2 folder governance cleanup matrix generator — verifies core classification, targeting, and age-bucket rules.node tests/unit/v2-folder-governance-cleanup-matrix.test.jsdocs
tests/unit/v2-link-audit.test.jsUnit tests for v2-link-audit.js — tests individual link checking rulesnode tests/unit/v2-link-audit.test.js [flags]docs
tests/unit/v2-wcag-audit.test.jsUnit tests for v2-wcag-audit.js — tests individual WCAG rulesnode tests/unit/v2-wcag-audit.test.js [flags]docs
tests/unit/validate-codex-task-contract.test.jsTests validate-codex-task-contract.js — validates contract checking logicnode tests/unit/validate-codex-task-contract.test.js [flags]docs
tests/utils/file-walker.jsFile tree walker — recursively finds files matching patterns. Used by pre-commit hook and validators.node tests/utils/file-walker.js [flags]docs
tests/utils/mdx-parser.jsMDX parser utility — extracts frontmatter, components, content blocks from MDX filesnode tests/utils/mdx-parser.js [flags]docs
tests/utils/mintignore.jsMintignore utility — reads .mintignore patterns and filters file listsnode tests/utils/mintignore.js [flags]docs
tests/utils/openapi-rolling-issue.jsOpenAPI rolling issue utility — creates/updates GitHub issues for persistent OpenAPI audit findingsnode tests/utils/openapi-rolling-issue.js [flags]docs
tests/utils/spell-checker.jsSpell checker utility — checks text against custom dictionary with en-GB locale supportnode tests/utils/spell-checker.js [flags]docs

​
tools/scripts

ScriptSummaryUsageDomain
tools/scripts/add-framework-headers.jsInserts or extends framework headers on all repo scripts from classification data.node tools/scripts/add-framework-headers.js --data script-classifications.json --dry-rundocs
tools/scripts/add-pagetype-mechanical.jsMechanically assigns pageType frontmatter to eligible v2 MDX pages.node tools/scripts/add-pagetype-mechanical.js [flags]docs
tools/scripts/assign-purpose-metadata.jsPurpose metadata assigner — fills purpose and audience frontmatter for routable v2 pagesnode tools/scripts/assign-purpose-metadata.js [flags]docs
tools/scripts/audit-component-usage.jsComponent usage auditor — scans pages for component usage patterns and reports statisticsnode tools/scripts/audit-component-usage.js [flags]docs
tools/scripts/audit-media-assets.jsAudits repo media assets, references, ignore leakage, and externalized asset branch inventory.node tools/scripts/audit-media-assets.js [flags]docs
tools/scripts/audit-scripts.jsScript auditor — analyses all repo scripts, categorises usage/overlap, generates SCRIPT_AUDIT reportsnode tools/scripts/audit-scripts.js [flags]docs
tools/scripts/audit-tasks-folders.jsTasks folder auditor — checks tasks/ structure, normalises report locations, applies recommendations with conflict-safe movesnode tools/scripts/audit-tasks-folders.js [flags]docs
tools/scripts/audit-v2-usefulness.jsUsefulness auditor — scores v2 MDX pages on human and agent usefulness with source-weighted 2026 accuracy verificationnode tools/scripts/audit-v2-usefulness.js [flags]docs
tools/scripts/check-codex-pr-overlap.jsPR enforcer — checks for conflicting codex PRs targeting the same files/branchesnode tools/scripts/check-codex-pr-overlap.js [flags]docs
tools/scripts/check-no-ai-stash.shAI stash enforcer — blocks push if AI temporary/stash files are present in working treebash tools/scripts/check-no-ai-stash.sh [flags]docs
tools/scripts/cleanup-quarantine-manager.jsQuarantine manager — classifies files for quarantine (default) or applies quarantine moves (—apply)node tools/scripts/cleanup-quarantine-manager.js [flags]docs
tools/scripts/codex-commit.jsCodex commit helper — audits codex branch state and generates compliant commit messagesnode tools/scripts/codex-commit.js [flags]docs
tools/scripts/codex-safe-merge-with-stash.jsDeprecated compatibility shim — blocks stash-based Codex merge flow and directs users to task-finalize, lock-release, and task-cleanupnode tools/scripts/codex-safe-merge-with-stash.js [flags]docs
tools/scripts/codex/lock-release.jsCodex lock release utility — releases stale codex lock filesnode tools/scripts/codex/lock-release.js [flags]docs
tools/scripts/codex/task-cleanup.jsCodex task cleanup utility — reports and prunes merged clean worktrees plus stale local codex branches after mergenode tools/scripts/codex/task-cleanup.js [flags]docs
tools/scripts/codex/task-finalize.jsCodex task finaliser — enforces task completion requirements before closingnode tools/scripts/codex/task-finalize.js [flags]docs
tools/scripts/codex/task-preflight.jsCodex task preflight — generates task setup files and validates preconditionsnode tools/scripts/codex/task-preflight.js [flags]docs
tools/scripts/codex/validate-locks.jsCodex lock validator — checks for stale or conflicting lock files before pushnode tools/scripts/codex/validate-locks.js [flags]docs
tools/scripts/component-layout-governance.jsComponent layout governance validator — checks v2 page layouts against approved component contractsnode tools/scripts/component-layout-governance.js [flags]docs
tools/scripts/convert-rss-to-mdx.jsRSS-to-MDX converter — imports RSS feed items and converts to MDX page formatnode tools/scripts/convert-rss-to-mdx.js [flags]docs
tools/scripts/create-codex-pr.jsCodex PR creator — generates codex PR with correct branch naming, labels, and body templatenode tools/scripts/create-codex-pr.js [flags]docs
tools/scripts/cross-agent-packager.jsCross-agent packager — bundles audit reports and repo state into agent-consumable packagesnode tools/scripts/cross-agent-packager.js [flags]docs
tools/scripts/debug-mint-dev.jsMintlify dev debugger — diagnostic tool for troubleshooting mint dev server issuesnode tools/scripts/debug-mint-dev.js [flags]docs
tools/scripts/dev/add-callouts.jsCallout inserter — adds Note/Tip/Warning callout components to MDX files based on content patternsnode tools/scripts/dev/add-callouts.js [flags]docs
tools/scripts/dev/batch-update-og-image.shDeprecated wrapper for the legacy bulk OG image replacement helper. Use the canonical OG generator workflow instead.bash tools/scripts/dev/batch-update-og-image.shdocs
tools/scripts/dev/ensure-mint-watcher-patch.shMint watcher patcher — applies patch to fix Mintlify file watcher issues in dev modebash tools/scripts/dev/ensure-mint-watcher-patch.sh [flags]docs
tools/scripts/dev/generate-mint-dev-scope.jsMint dev scope generator — creates a scoped docs.json for running mint dev on a subset of pagesnode tools/scripts/dev/generate-mint-dev-scope.js [flags]docs
tools/scripts/dev/lib/resolve-scoped-docs-config.jsScoped docs config resolver — resolves named scoped navigation configs and explicit docs config paths for mint-dev toolingnode -e "require('./tools/scripts/dev/lib/resolve-scoped-docs-config')"docs
tools/scripts/dev/mint-custom-loader.shMint custom loader — launches lpd dev with an alternate docs config as the active Mint navigation source.bash tools/scripts/dev/mint-custom-loader.sh [flags]docs
tools/scripts/dev/replace-og-image.pyDeprecated wrapper for the legacy OG image replacement helper. Use the canonical OG generator workflow instead.python3 tools/scripts/dev/replace-og-image.pydocs
tools/scripts/dev/seo-generator-safe.jsDeprecated wrapper for the legacy safe SEO generator. Use the canonical OG generator workflow instead.node tools/scripts/dev/seo-generator-safe.jsdocs
tools/scripts/dev/test-add-callouts.jsTest for add-callouts.js — validates callout insertion logic against fixturesnode tools/scripts/dev/test-add-callouts.js [flags]docs
tools/scripts/dev/test-seo-generator.jsTest for seo-generator — validates SEO generation logicnode tools/scripts/dev/test-seo-generator.js [flags]docs
tools/scripts/dev/update-all-og-images.jsDeprecated wrapper for legacy bulk OG image replacement. Use the canonical OG generator workflow instead.node tools/scripts/dev/update-all-og-images.jsdocs
tools/scripts/dev/update-og-image.jsDeprecated wrapper for legacy OG image replacement. Use the canonical OG generator workflow instead.node tools/scripts/dev/update-og-image.jsdocs
tools/scripts/docs-fact-registry.jsDocs fact registry validator — validates repo-native research claim registries and provides normalized claim-family data for the manual research runner.node tools/scripts/docs-fact-registry.js [flags]docs
tools/scripts/docs-page-research-pr-report.jsDocs 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.node tools/scripts/docs-page-research-pr-report.js [flags]docs
tools/scripts/docs-page-research.jsDocs page research runner — extracts factual claims from docs pages, checks evidence sources, detects contradictions across related pages, and emits manual-first research reports.node tools/scripts/docs-page-research.js [flags]docs
tools/scripts/docs-quality-and-freshness-audit.jsContent freshness audit — checks for TODO/TBD/Coming Soon markers, thin pages, stale contentnode tools/scripts/docs-quality-and-freshness-audit.js [flags]docs
tools/scripts/docs-research-adjudication.jsDocs 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.node tools/scripts/docs-research-adjudication.js [flags]docs
tools/scripts/docs-research-packet.jsDocs 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.node tools/scripts/docs-research-packet.js [flags]docs
tools/scripts/enforce-generated-file-banners.jsGenerated file banner enforcer — checks (—check) or writes (default) “do not edit” banners on generated files.node tools/scripts/enforce-generated-file-banners.js --check &#124; --write [--staged]docs
tools/scripts/enforcers/pr/check-component-immutability.jsFlags modifications to existing component files in PR context. New files allowed. Modifications require approval label.node tools/scripts/enforcers/pr/check-component-immutability.js --base-ref maindocs
tools/scripts/enforcers/pr/check-pr-template.jsEnforces that PR descriptions include required change and rationale sections before mergePR_BODY="..." node tools/scripts/enforcers/pr/check-pr-template.jsdocs
tools/scripts/export-portable-skills.jsPortable skills exporter — copies canonical template skills into cross-agent pack folders and validates drift.node tools/scripts/export-portable-skills.js --write&#124;--check [--skills name[,name...]]docs
tools/scripts/generate-ai-sitemap.jsAI sitemap generator — produces AI-optimised sitemap files. Dual-mode: —check (enforcer) / —write (generator).node tools/scripts/generate-ai-sitemap.js [flags]docs
tools/scripts/generate-ai-skills-indexes.jsGenerates ai-tools/ai-skills inventory.json and content-map.md from the canonical agent-governance surface manifest.node tools/scripts/generate-ai-skills-indexes.js [--check&#124;--write]docs
tools/scripts/generate-component-docs.jsGenerates published component library MDX pages from the registry. Replaces update-component-library.sh.node tools/scripts/generate-component-docs.js [--dry-run&#124;--fix&#124;--write&#124;--check] [--template-only] [--category &lt;name&gt;]docs
tools/scripts/generate-component-governance-remediation-reports.jsGenerates component-governance remediation reports from the approved audit and live repo state, including defensive-rendering guidance for MDX-facing components.node tools/scripts/generate-component-governance-remediation-reports.js [flags]docs
tools/scripts/generate-component-registry.jsParses JSDoc from all component exports and produces component-registry.json.node tools/scripts/generate-component-registry.js [--validate-only]docs
tools/scripts/generate-component-snippets.pyGenerates VS Code component snippets from the component registry for local editor authoring workflows.python3 tools/scripts/generate-component-snippets.pydocs
tools/scripts/generate-content-gap-reconciliation.jsContent-gap reconciliation generator — compares blueprint coverage against v2 MDX and writes reconciliation artefactsnode tools/scripts/generate-content-gap-reconciliation.js [flags]docs
tools/scripts/generate-docs-guide-components-index.jsGenerates components-catalog.mdx in docs-guide/catalog/ from component-registry.json and component-usage-map.json.node tools/scripts/generate-docs-guide-components-index.js [--fix&#124;--write&#124;--check]docs
tools/scripts/generate-docs-guide-indexes.jsGenerates docs-guide workflow/template catalogs and optionally verifies freshnessnode tools/scripts/generate-docs-guide-indexes.js [flags]docs
tools/scripts/generate-docs-guide-pages-index.jsGenerates the docs-guide pages catalognode tools/scripts/generate-docs-guide-pages-index.js [flags]docs
tools/scripts/generate-docs-index.jsDocs index generator — produces docs-index.json from v2 frontmatter and docs.json. Dual-mode: —check (enforcer) / —write (generator). Most-called script in the repo.node tools/scripts/generate-docs-index.js [flags]docs
tools/scripts/generate-llms-files.jsLLMs file generator — produces llms.txt and llms-full.txt for AI consumption. Dual-mode: —check / —write.node tools/scripts/generate-llms-files.js [flags]docs
tools/scripts/generate-pages-index.jsPages index generator — generates and verifies section-style index.mdx files for v2 docs folders plus root aggregate indexnode tools/scripts/generate-pages-index.js [flags]docs
tools/scripts/generate-ui-templates.jsGenerates the UI template catalog, template preview routes, and VS Code snippets from canonical template/component sourcesnode tools/scripts/generate-ui-templates.js [flags]docs
tools/scripts/generate-v2-folder-governance-cleanup-matrix.jsV2 folder governance cleanup matrix generator — inventories non-publishable and legacy v2 artifacts and emits human-review markdown/json recommendations before any moves are applied.node tools/scripts/generate-v2-folder-governance-cleanup-matrix.js [--report-md &lt;path&gt;] [--report-json &lt;path&gt;] [--as-of &lt;YYYY-MM-DD&gt;]docs
tools/scripts/i18n/generate-localized-docs-json.jsLocale docs.json generator — produces localised docs.json variants from route-map and source docs.jsonnode tools/scripts/i18n/generate-localized-docs-json.js [flags]docs
tools/scripts/i18n/lib/common.jsi18n shared utilities — common helper functions for translation pipelinenode tools/scripts/i18n/lib/common.js [flags]docs
tools/scripts/i18n/lib/config.jsi18n configuration — language codes, locale paths, translation settingsnode tools/scripts/i18n/lib/config.js [flags]docs
tools/scripts/i18n/lib/docs-json-localizer.jsdocs.json localiser engine — transforms docs.json navigation for locale variantsnode tools/scripts/i18n/lib/docs-json-localizer.js [flags]docs
tools/scripts/i18n/lib/docs-routes.jsdocs route resolver — maps page paths to locale-aware routesnode tools/scripts/i18n/lib/docs-routes.js [flags]docs
tools/scripts/i18n/lib/frontmatter.jsFrontmatter parser/writer — reads and writes MDX frontmatter for translationnode tools/scripts/i18n/lib/frontmatter.js [flags]docs
tools/scripts/i18n/lib/mdx-parser.jsMDX parser for i18n — extracts translatable content blocks from MDXnode tools/scripts/i18n/lib/mdx-parser.js [flags]docs
tools/scripts/i18n/lib/mdx-translate.jsMDX translation engine — applies translations to MDX content blocksnode tools/scripts/i18n/lib/mdx-translate.js [flags]docs
tools/scripts/i18n/lib/path-utils.jsPath utilities for i18n — locale-aware path resolution and mappingnode tools/scripts/i18n/lib/path-utils.js [flags]docs
tools/scripts/i18n/lib/provenance.jsTranslation provenance tracker — records source, timestamp, and provider for each translated segmentnode tools/scripts/i18n/lib/provenance.js [flags]docs
tools/scripts/i18n/lib/provider-mock.jsMock translation provider — returns placeholder translations for testing without API callsnode tools/scripts/i18n/lib/provider-mock.js [flags]docs
tools/scripts/i18n/lib/provider-openrouter.jsOpenRouter translation provider — calls OpenRouter API for actual translationsnode tools/scripts/i18n/lib/provider-openrouter.js [flags]docs
tools/scripts/i18n/lib/providers.jsProvider registry — selects translation provider (OpenRouter or mock) based on configurationnode tools/scripts/i18n/lib/providers.js [flags]docs
tools/scripts/i18n/test-mintlify-version-language-toggle.jsMintlify language toggle checker — validates Mintlify version supports language toggle featurenode tools/scripts/i18n/test-mintlify-version-language-toggle.js [flags]docs
tools/scripts/i18n/test/cli-guardrails.test.jsTests i18n CLI guardrails — validates argument validation and safety checksnode tools/scripts/i18n/test/cli-guardrails.test.js [flags]docs
tools/scripts/i18n/test/docs-json-localizer.test.jsTests docs-json-localizer — validates locale docs.json transformation logicnode tools/scripts/i18n/test/docs-json-localizer.test.js [flags]docs
tools/scripts/i18n/test/frontmatter.test.jsTests frontmatter parser — validates frontmatter read/write roundtripnode tools/scripts/i18n/test/frontmatter.test.js [flags]docs
tools/scripts/i18n/test/mdx-translate.test.jsTests MDX translation — validates content block translation logicnode tools/scripts/i18n/test/mdx-translate.test.js [flags]docs
tools/scripts/i18n/test/provenance.test.jsTests provenance tracker — validates translation provenance recordingnode tools/scripts/i18n/test/provenance.test.js [flags]docs
tools/scripts/i18n/test/provider-openrouter.test.jsTests OpenRouter provider — validates API call logic and response parsingnode tools/scripts/i18n/test/provider-openrouter.test.js [flags]docs
tools/scripts/i18n/translate-docs.jsTranslation generator — translates v2 MDX pages to target languages via OpenRouter APInode tools/scripts/i18n/translate-docs.js [flags]docs
tools/scripts/i18n/validate-generated.jsGenerated localisation validator — checks generated translated MDX files and route-map outputs for integritynode tools/scripts/i18n/validate-generated.js [flags]docs
tools/scripts/lib/docs-path-sync.jsShared docs path sync library — detects staged page moves, plans deterministic route rewrites, and applies governed docs.json/path reference updates.const sync = require('./docs-path-sync');docs
tools/scripts/lint-copy.jsEnforce banned word and phrase rules on MDX content files.node tools/scripts/lint-copy.js [file or glob] [flags]docs
tools/scripts/lint-patterns.jsEnforce Tier 2 copy pattern rules on MDX content files.node tools/scripts/lint-patterns.js [file or glob] [flags]docs
tools/scripts/lint-structure.jsEnforce structural rules on MDX content files.node tools/scripts/lint-structure.js [file] [flags]docs
tools/scripts/mint-dev.shMintlify dev server launcher — starts mint dev with correct configurationbash tools/scripts/mint-dev.sh [flags]docs
tools/scripts/new-script.jsScript scaffolder — creates a new script file prefilled with the required docs header templatenode tools/scripts/new-script.js [flags]docs
tools/scripts/orchestrator-guides-research-review.jsOrchestrator 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.node tools/scripts/orchestrator-guides-research-review.js [flags]docs
tools/scripts/orchestrators/repair-governance.jsChains audit, safe repair, verification, and reporting into a single self-healing governance pipeline.node tools/scripts/orchestrators/repair-governance.js [--dry-run] [--auto-commit] [--report-only] [--strict] [--staged&#124;--files &lt;path[,path...]&gt;&#124;--full]docs
tools/scripts/pattern-observer.jsAggregate copy pattern violations across a tab or full v2 tree and emit a diagnostic report.node tools/scripts/pattern-observer.js --tab &lt;name&gt; &#124; --all [--output &lt;file&gt;]docs
tools/scripts/publish-v2-internal-reports.jsReport publisher — publishes v2 internal audit reports to configured output locationsnode tools/scripts/publish-v2-internal-reports.js [flags]docs
tools/scripts/redirects/sync-legacy-root-v1.jsLegacy root redirect synchronizer — bootstraps root-level legacy-to-v1 mappings, rewrites managed docs.json redirects, installs root catch-all fallbacks, and removes legacy generated fallback pagesnode tools/scripts/redirects/sync-legacy-root-v1.js [--bootstrap-manifest] [--write] [--repo-root &lt;path&gt;] [--manifest &lt;path&gt;] [--docs-json &lt;path&gt;]docs
tools/scripts/remediators/assets/migrate-assets-to-branch.jsReads the media-audit manifest, migrates flagged assets to docs-v2-assets, and rewrites MDX/JSX references to raw GitHub URLs.node tools/scripts/remediators/assets/migrate-assets-to-branch.js --manifest tasks/reports/media-audit/media-audit-manifest.json --target migrate_r2,migrate_cloudinary --dry-rundocs
tools/scripts/remediators/components/repair-component-metadata.jsAuto-repairs derived JSDoc metadata fields from repo state. Safe fields only. Mirrors AUDIT-00 —fix pattern for components.node tools/scripts/remediators/components/repair-component-metadata.js [--dry-run] [--fix] [--staged]docs
tools/scripts/remediators/content/repair-mdx-safe-markdown.jsAuto-repairs deterministic MDX-unsafe markdown patterns across first-party markdown and MDX content.node tools/scripts/remediators/content/repair-mdx-safe-markdown.js --dry-run [--staged&#124;--files a,b]docs
tools/scripts/remediators/content/repair-spelling.jsAuto-corrects spelling errors using the shared cspell configuration. Safe, dictionary-based corrections only.node tools/scripts/remediators/content/repair-spelling.js --dry-rundocs
tools/scripts/remediators/content/sync-docs-paths.jsDocs path sync remediator — applies deterministic docs.json and governed reference rewrites for moved docs pages.node tools/scripts/remediators/content/sync-docs-paths.js --staged --dry-rundocs
tools/scripts/repair-ownerless-language.jsApplies deterministic wording repairs that remove human-owner dependency from governed GitHub and contributor surfaces.node tools/scripts/repair-ownerless-language.js [--check&#124;--write] [--files a,b]docs
tools/scripts/repo-audit-orchestrator.jsRepo audit orchestrator — dispatches all static analysis validators in sequence. Supports —mode (static/full), —scope (full/changed), —quarantine, —agent-pack.node tools/scripts/repo-audit-orchestrator.js [flags]docs
tools/scripts/scan-component-imports.jsScans MDX imports to produce component-usage-map.json and detect @usedIn drift.node tools/scripts/scan-component-imports.js [--verify]docs
tools/scripts/script-footprint-and-usage-audit.jsScript footprint auditor — analyses script file sizes, dependencies, and usage patterns across the reponode tools/scripts/script-footprint-and-usage-audit.js [flags]docs
tools/scripts/snippets/fetch-external-docs.shExternal docs fetcher — pulls doc fragments from external GitHub repos into snippets/data/ for inclusion in buildsbash tools/scripts/snippets/fetch-external-docs.sh [flags]docs
tools/scripts/snippets/fetch-lpt-exchanges.shLPT exchange data fetcher — pulls exchange listing data for LPT token pagesbash tools/scripts/snippets/fetch-lpt-exchanges.sh [flags]docs
tools/scripts/snippets/fetch-openapi-specs.shOpenAPI spec fetcher — pulls latest OpenAPI specs from Livepeer services for reference pagesbash tools/scripts/snippets/fetch-openapi-specs.sh [flags]docs
tools/scripts/snippets/generate-api-docs.shAPI docs generator — generates API reference pages from OpenAPI specsbash tools/scripts/snippets/generate-api-docs.sh [flags]docs
tools/scripts/snippets/generate-data/scripts/generate-glossary.jsGlossary generator — produces glossary data file from terminology sourcesnode tools/scripts/snippets/generate-data/scripts/generate-glossary.js [flags]docs
tools/scripts/snippets/generate-data/scripts/terminology-search.jsTerminology search — searches glossary/terminology data for definitionsnode tools/scripts/snippets/generate-data/scripts/terminology-search.js [flags]docs
tools/scripts/snippets/generate-og-images.jsGenerate canonical site-level Open Graph image assets and manifest for fallback and section-level social previews.node tools/scripts/snippets/generate-og-images.js [--dry-run] [--only &lt;locale:section-id&#124;fallback&gt;]docs
tools/scripts/snippets/generate-seo.jsSEO generator — generates SEO metadata (title, description, keywords) for v2 pages from content analysisnode tools/scripts/snippets/generate-seo.js [flags]docs
tools/scripts/snippets/lib/og-image-policy.jsOG image policy helper — resolves authored MDX pages to canonical section or fallback social images and metadata.node tools/scripts/snippets/lib/og-image-policy.js [flags]docs
tools/scripts/snippets/test-scripts.shSnippet test runner — runs basic validation on snippet scriptsbash tools/scripts/snippets/test-scripts.sh [flags]docs
tools/scripts/style-and-language-homogenizer-en-gb.jsEN-GB style homogeniser — finds and fixes American English spellings, style guide violations, and formatting inconsistencies across v2 contentnode tools/scripts/style-and-language-homogenizer-en-gb.js [flags]docs
tools/scripts/sync-codex-skills.jsCodex skills sync — synchronises skill definition files and managed companion resources between canonical templates and local Codex installs. Supports —check mode.node tools/scripts/sync-codex-skills.js [flags]docs
tools/scripts/test-v2-pages.jsV2 page tester — validates v2 pages via Puppeteer browser renderingnode tools/scripts/test-v2-pages.js [flags]docs
tools/scripts/validate-ai-tools-registry.jsAI-tools registry validator and report writer for source-of-truth coverage, lifecycle, lane alignment, and generated inventory output.node tools/scripts/validate-ai-tools-registry.js [--check] [--coverage] [--lanes] [--write-report]docs
tools/scripts/validate-codex-task-contract.jsCodex task contract enforcer — validates branch naming, task files, PR body, and issue state for codex branchesnode tools/scripts/validate-codex-task-contract.js [flags]docs
tools/scripts/validators/components/check-component-css.jsValidates component files against component governance styling rules.node tools/scripts/validators/components/check-component-css.js [--path snippets/components] [--staged] [--fix] [--help]docs
tools/scripts/validators/components/check-component-docs.jsValidates component JSDoc coverage, prop documentation, docs-entry coverage, and governance metadata.node tools/scripts/validators/components/check-component-docs.js [--path snippets/components] [--base-ref docs-v2] [--staged] [--strict-governance] [--help]docs
tools/scripts/validators/components/check-mdx-component-scope.jsValidates MDX-facing component modules do not depend on private file-scope helper bindings from exported components.node tools/scripts/validators/components/check-mdx-component-scope.js [--files path[,path...]] [--staged]docs
tools/scripts/validators/components/check-naming-conventions.jsValidates active component filenames against directory-aware file naming and PascalCase exports under snippets/components.node tools/scripts/validators/components/check-naming-conventions.js [--path snippets/components] [--files path[,path...]] [--mode migration&#124;strict-camel]docs
tools/scripts/validators/content/check-anchor-usage.jsValidates same-page anchor links in maintained v2 MDX files against heading IDs on the same pagenode tools/scripts/validators/content/check-anchor-usage.js [--json] [--scope &lt;glob&gt;]docs
tools/scripts/validators/content/check-description-quality.jsValidates English v2 frontmatter descriptions for SEO length, boilerplate openings, and duplicate reusenode tools/scripts/validators/content/check-description-quality.js [--path &lt;repo-path&gt;] [--strict]docs
tools/scripts/validators/content/check-docs-path-sync.jsDocs path sync validator — detects staged page moves that require docs.json or governed path reference rewrites.node tools/scripts/validators/content/check-docs-path-sync.js --stageddocs
tools/scripts/validators/content/check-double-headers.jsDetects duplicate body H1 headings and opening paragraphs that repeat frontmatter title or description content.node tools/scripts/validators/content/check-double-headers.js [--staged&#124;--file &lt;path&gt;&#124;--files &lt;a,b&gt;] [--fix]docs
tools/scripts/validators/content/check-grammar-en-gb.jsDeterministic UK English grammar checker for prose content with optional conservative autofix for safe rules.node tools/scripts/validators/content/check-grammar-en-gb.js [--scope full&#124;changed] [--file &lt;path[,path...]&gt;] [--fix] [--strict]docs
tools/scripts/validators/content/check-mdx-safe-markdown.jsValidates first-party markdown and MDX content for repo-wide MDX-safe syntax, including parse failures and deterministic unsafe patterns.node tools/scripts/validators/content/check-mdx-safe-markdown.js [--staged&#124;--files a,b] [--json]docs
tools/scripts/validators/content/check-page-endings.jsValidates that English v2 MDX pages end with an approved navigational or closing elementnode tools/scripts/validators/content/check-page-endings.js [--fix] [--json]docs
tools/scripts/validators/content/check-proper-nouns.jsDetects and fixes incorrect proper noun capitalisation in prose while skipping code, frontmatter, URLs, and path-like tokens.node tools/scripts/validators/content/check-proper-nouns.js [--file &lt;path[,path...]&gt;] [--fix]docs
tools/scripts/validators/governance/audit-script-inventory.jsDeep inventory audit of every script in the repo. Traces triggers, outputs, downstream chains, and governance compliance. Produces reports grouped by trigger category.node tools/scripts/validators/governance/audit-script-inventory.js [--fix] [--dry-run] [--staged-only&#124;--staged] [--files &lt;path[,path...]&gt;] [--quiet] [--json] [--md] [--output &lt;dir&gt;] [--verbose]docs
tools/scripts/validators/governance/check-agent-docs-freshness.jsValidates that canonical agent governance docs and native adapters exist and have been touched within a freshness thresholdnode tools/scripts/validators/governance/check-agent-docs-freshness.js [--threshold &lt;days&gt;] [--json]docs
tools/scripts/validators/governance/review-governance-repair-checklist.jsGenerates a review checklist for dry-run governance repair proposals that require human approval before fix mode is applied.node tools/scripts/validators/governance/review-governance-repair-checklist.js [--output &lt;dir&gt;] [--json] [--md]docs
tools/scripts/verify-all-pages.jsLoads component-library routes in a headless browser and fails on render, console, or 404 issues.node tools/scripts/verify-all-pages.jsdocs
tools/scripts/verify-pay-orc-gate-finalize.shPayment/orchestrator gate verifier — checks payment and orchestrator documentation gate conditionsbash tools/scripts/verify-pay-orc-gate-finalize.sh [flags]docs
tools/scripts/verify/.verify-large-change.shLarge change verifier — blocks or warns when a commit touches an unusually large number of filesbash tools/scripts/verify/.verify-large-change.sh [flags]docs
tools/scripts/wcag-repair-common.jsWCAG repair shared logic — common repair functions used by WCAG audit fix modenode tools/scripts/wcag-repair-common.js [flags]docs

​
tools/lib

ScriptSummaryUsageDomain
tools/lib/ai-tools-registry.jsShared loader, validator, coverage checker, and report renderer for the AI-tools registry contract and generated inventory report.const registry = require('../lib/ai-tools-registry');docs
tools/lib/codex-skill-templates.jsShared helper for validating, selecting, and loading canonical Codex skill templates.const &#123; discoverTemplates &#125; = require('../lib/codex-skill-templates');docs
tools/lib/component-governance-utils.jsShared parsing and validation utilities for component governance scripts.const utils = require('../lib/component-governance-utils');docs
tools/lib/docs-authoring-rules.jsShared warning-level authoring rules for guide layouts and code-block metadata, plus deterministic code-block icon repair.const &#123; analyzeGuideLayoutWarnings, repairCodeBlockMetadata &#125; = require('../lib/docs-authoring-rules');docs
tools/lib/docs-index-utils.jsShared utilities for docs-index.json generation — path resolution, frontmatter extraction, index mergingnode tools/lib/docs-index-utils.js [flags]docs
tools/lib/docs-page-scope.jsShared authored-page scope helpers that distinguish generated docs pages from authored docs pages for warning-only validators and reports.const &#123; filterAuthoredDocsPageFiles &#125; = require('../lib/docs-page-scope');docs
tools/lib/docs-publishability.jsShared path publishability rules for v2 docs content and tooling.const &#123; isExcludedV2ExperimentalPath &#125; = require('../lib/docs-publishability');docs
tools/lib/docs-usefulness/config-validator.jsValidates docs-usefulness config structure and field completeness.const &#123; validateConfig &#125; = require('../lib/docs-usefulness/config-validator');docs
tools/lib/docs-usefulness/journey-check.jsEvaluates docs pages against user journey completeness criteria.const &#123; checkJourney &#125; = require('../lib/docs-usefulness/journey-check');docs
tools/lib/docs-usefulness/llm-evaluator.jsWraps LLM API calls for rubric-based page quality evaluation.const &#123; evaluate &#125; = require('../lib/docs-usefulness/llm-evaluator');docs
tools/lib/docs-usefulness/prompts/changelog.jsLLM prompt template for changelog page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/changelog');docs
tools/lib/docs-usefulness/prompts/concept.jsLLM prompt template for concept page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/concept');docs
tools/lib/docs-usefulness/prompts/faq.jsLLM prompt template for faq page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/faq');docs
tools/lib/docs-usefulness/prompts/glossary.jsLLM prompt template for glossary page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/glossary');docs
tools/lib/docs-usefulness/prompts/how_to.jsLLM prompt template for how_to page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/how_to');docs
tools/lib/docs-usefulness/prompts/index.jsLLM prompt template for index page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/index');docs
tools/lib/docs-usefulness/prompts/landing.jsLLM prompt template for landing page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/landing');docs
tools/lib/docs-usefulness/prompts/overview.jsLLM prompt template for overview page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/overview');docs
tools/lib/docs-usefulness/prompts/reference.jsLLM prompt template for reference page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/reference');docs
tools/lib/docs-usefulness/prompts/troubleshooting.jsLLM prompt template for troubleshooting page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/troubleshooting');docs
tools/lib/docs-usefulness/prompts/tutorial.jsLLM prompt template for tutorial page-type usefulness evaluation.const &#123; getPrompt &#125; = require('../lib/docs-usefulness/prompts/tutorial');docs
tools/lib/docs-usefulness/quality-gate.jsApplies pass/fail thresholds to usefulness scores.const &#123; applyGate &#125; = require('../lib/docs-usefulness/quality-gate');docs
tools/lib/docs-usefulness/rubric-loader.jsLoads and parses rubric YAML/JSON for page-type scoring rules.const &#123; loadRubric &#125; = require('../lib/docs-usefulness/rubric-loader');docs
tools/lib/docs-usefulness/rule-evaluators.jsEvaluates individual rubric rules against page content.const &#123; evaluateRule &#125; = require('../lib/docs-usefulness/rule-evaluators');docs
tools/lib/docs-usefulness/scoring.jsAggregates rule scores into a final usefulness score per page.const &#123; score &#125; = require('../lib/docs-usefulness/scoring');docs
tools/lib/frontmatter-taxonomy.jsShared frontmatter taxonomy utilities for routable docs pages.const taxonomy = require('../lib/frontmatter-taxonomy');docs
tools/lib/generated-artifacts.jsGenerated artifact governance helpers — load the manifest, validate enums, and match staged files to managed artifactsnode tools/lib/generated-artifacts.js [flags]docs
tools/lib/generated-file-banners.jsGenerated file banner template — provides standard banner text for auto-generated filesnode tools/lib/generated-file-banners.js [flags]docs
tools/lib/load-js-yaml.jsYAML loader utility — resolves js-yaml from repo-local installs and falls back to a minimal parser for task-contract style files in bare worktreesnode -e "require('./tools/lib/load-js-yaml')"docs
tools/lib/load-minimatch.jsGlob matcher loader — resolves minimatch from repo-local installs and falls back to a simple glob matcher for bare worktreesnode -e "require('./tools/lib/load-minimatch')"docs
tools/lib/mdx-safe-markdown.jsShared MDX-safe markdown helpers that collect first-party markdown files, detect unsafe patterns, and apply deterministic repairs.node tools/lib/mdx-safe-markdown.js [flags]docs
tools/lib/precommit-staged-cache.jsShared pre-commit staged-cache helpers — fingerprint staged content plus hook inputs and persist reusable pass markersconst cache = require('./precommit-staged-cache');docs
tools/lib/script-governance-config.jsShared governance constants for script discovery, indexing, classification, and pipeline normalisation across the repo.const config = require('../lib/script-governance-config');docs
tools/lib/script-header-utils.jsShared helpers for extracting and reading top-of-file script governance headers without scanning into executable source.const &#123; extractLeadingScriptHeader &#125; = require('../lib/script-header-utils');docs

​
tools/notion

ScriptSummaryUsageDomain
tools/notion/1-read-notion-to-csv.jsReads the Notion pages database, filters v2 rows, and writes CSV/JSON exports for downstream sync steps.node tools/notion/1-read-notion-to-csv.js [flags]docs
tools/notion/2-read-docs-to-csv.jsParses docs.json v2 navigation and writes CSV/JSON exports with section-group metadata for Notion sync.node tools/notion/2-read-docs-to-csv.js [flags]docs
tools/notion/3-check-duplicates.jsAnalyzes the exported Notion snapshot for duplicate page keys and writes JSON and Markdown reports.node tools/notion/3-check-duplicates.js [flags]docs
tools/notion/4-remove-duplicates.jsArchives duplicate Notion pages from the duplicate report while keeping the first record in each group.node tools/notion/4-remove-duplicates.js [flags]docs
tools/notion/5-export-to-notion.jsUpdates existing Notion page grouping fields from the exported docs navigation snapshot.node tools/notion/5-export-to-notion.js [flags]docs
tools/notion/backup-notion-table.jsBacks up the current Notion data source rows and metadata into timestamped JSON and CSV artifacts with a manifest.node tools/notion/backup-notion-table.js [flags]docs
tools/notion/install-local-sync-hook.shInstalls the managed local post-commit hook that invokes the Notion sync runner and preserves any prior hook as a backup.bash tools/notion/install-local-sync-hook.sh [flags]docs
tools/notion/local-post-commit-sync.shDetects docs.json or v2 content changes in the latest commit and runs the canonical Notion sync locally when enabled.bash tools/notion/local-post-commit-sync.sh [flags]docs
tools/notion/remove-local-sync-hook.shRemoves the managed local Notion post-commit hook when it is present.bash tools/notion/remove-local-sync-hook.sh [flags]docs
tools/notion/sync-v2-en-canonical.jsBuilds canonical v2 English page metadata and syncs Notion schema, row metadata, and optional page-body blocks to match docs.node tools/notion/sync-v2-en-canonical.js [flags]docs

​
tools/config

ScriptSummaryUsageDomain
tools/config/v2-internal-report-pages.jsConfiguration data — list of internal report page paths for publish-v2-internal-reports.jsnode tools/config/v2-internal-report-pages.js [flags]docs

​
tasks/scripts

ScriptSummaryUsageDomain
tasks/scripts/audit-python.pyPython audit utility — runs Python-based audit checks (alternative to Node auditors)python3 tasks/scripts/audit-python.py [flags]docs

​
snippets/automations

ScriptSummaryUsageDomain
snippets/automations/youtube/filterVideos.jsYouTube video filter — post-processes fetched YouTube data to filter/sort videos for displaynode snippets/automations/youtube/filterVideos.js [flags]docs
Last modified on March 16, 2026