merge: docs-v2-dev into docs-v2 (2026-04-07) by DeveloperAlly · Pull Request #867 · livepeer/docs

DeveloperAlly · 2026-04-07T12:39:57Z

Summary

Merges 1,066 commits from docs-v2-dev into docs-v2. docs-v2-dev is source of truth — all content conflicts resolved in favour of dev (-X theirs), 110 structural rename/rename and rename/delete conflicts resolved to dev's file paths.
Fixes test infrastructure: file-walker.js and mdx-safe-markdown.js now respect .mintignore and skip _workspace/, x-archived/, workspace/ directories during test scans.

What's included

Gateway restructure (new setup pages, archived old paths)
Component governance reorganisation
Delegator canonical rebuild
Contracts pipeline and glossary system
Operations scripts and content pipeline tooling
Session state and workspace reorganisation
docs.json exact match with docs-v2-dev

Verification

Check	Result
Conflict markers	PASS — zero found
docs.json	PASS — valid JSON, exact match with docs-v2-dev
Navigation	PASS — 1,322 entries verified
MDX validation	PASS — 465 files
Page rendering (local dev server)	PASS — 30/30 pages across all 8 tabs
Console errors	PASS — zero
Imports	13 issues (pre-existing on docs-v2-dev, identical)
Broken links	96 (improved from 153 on docs-v2-dev)
run-all.js	9 suites fully pass, all errors pre-existing

Test infrastructure fix

Metric	Before	After
Style issues	253	4
MDX violations	37	9
Files scanned	1,733	1,234

Rollback

Backup tags pushed: pre-merge-dev-backup-20260407, pre-merge-v2-backup-20260407

Test plan

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

@pipeline

…paths Wave 5 decisions: - Keep 5 dual-mode validators as-is, documented @pipeline with both modes - Updated stale lint-* paths in 4 AI skills files Deferred to after component branch merge (Task 13): - Split enforce-generated-file-banners.js (complex, touched by component branch) - Split validate-ai-tools-registry.js (ai-tools/ restructured on main) - Split audit-script-inventory.js (consolidate with add-framework-headers.js) - Resolve .vscode/components.code-snippets conflict (deeply embedded in generate-ui-templates.js) - Compose glossary + terminology-search pipeline Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

@category

… JSDoc Revert Pass 3 (style/className/...rest props) and Pass 4 (polish) changes that broke portal layouts, frame-mode pages, and border styling. Restored: original component code for all 43 JSX files from pre-restructure. Kept: - New folder structure (elements/, wrappers/, displays/, etc.) - PascalCase filenames - JSDoc @category→@type rename - Security: rel="noopener noreferrer", alt="" defaults - Cleanup: console.log removal Reverted: - Pass 3: style/className/...rest prop additions (broke Mintlify CSS) - Pass 4: color/dimension fixes (depended on Pass 3) - Pass 2 WCAG: role="separator", blockquote, aria-labels (restore later carefully) - Pass 1 partial: sanitiser, prefers-reduced-motion (restore later carefully) The extensibility props need to be added one component at a time with visual testing, not as a batch operation. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…ucture + JSDoc" This reverts commit 929eae3.

4 scripts moved to new taxonomy paths but the SOT freshness test still spawned them at the old flat locations: - generate-docs-guide-indexes.js → generators/governance/catalogs/ - generate-docs-guide-pages-index.js → generators/governance/catalogs/ - generate-docs-guide-components-index.js → generators/governance/catalogs/ - generate-ui-templates.js → generators/components/library/ Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

@pipeline

…e-banners Updated 5 stale script paths in CHECK_COMMANDS and WRITE_COMMANDS arrays: - generate-docs-guide-indexes.js → generators/governance/catalogs/ - generate-docs-guide-pages-index.js → generators/governance/catalogs/ - generate-docs-guide-components-index.js → generators/governance/catalogs/ - generate-component-docs.js → generators/components/documentation/ - generate-pages-index.js → generators/content/catalogs/ Wave 5 status: - Splits deferred: dual-mode scripts work correctly, splitting adds risk for minimal gain. Dual modes documented in @pipeline tags. - .vscode/components.code-snippets conflict: resolved (Python script already archived, generate-ui-templates.js is sole owner). - glossary + terminology-search: kept separate, compose as pipeline. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Split 1: enforce-generated-file-banners.js - Generator dispatch (CHECK_COMMANDS, WRITE_COMMANDS, runGeneratorSet) extracted to dispatch/governance/pipelines/sync-generated-files.js - Validator retains banner checking + i18n parity only Split 2: validate-ai-tools-registry.js - --write-report extracted to generators/governance/reports/generate-ai-tools-inventory.js - Validator retains registry validation only Split 3: audit-script-inventory.js - --fix mode wrapped by remediators/governance/scripts/repair-script-inventory.js - Audit script retains full logic (deeply coupled) but canonical fix entry point is now the remediator wrapper Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

102 scripts catalogued by type with accordion groups: - Audits (16), Generators (15), Validators (27), Remediators (14), Dispatch (10), Automations (13) - Plus git hooks (5) and dev tools (9) Each entry includes name, description, and usage. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…cripts 1,357-line comprehensive specification covering: - 3-tier taxonomy (type/concern/niche) with decision tree - 11-tag JSDoc header standard with all allowed values - Script structure standard (file layout, REPO_ROOT, config-at-top) - Best practices (composability, idempotency, --dry-run, --staged) - Governance rules (pre-commit gates, naming, x-archive, branch discipline) - Pipeline integration patterns - Complete templates for all 6 script types + shell - Appendices: governance tiers, quick-reference card Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

MDX previewer with Cmd+Shift+V keybinding that renders Livepeer custom components, Mintlify built-ins, and Mermaid diagrams in a side panel. Follows the same extension conventions as authoring-tools, components, and markdown-list. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…rences Remove references to deprecated ThemeData/themeStyles.jsx from FrameMode and Portals example files, and add script governance framework draft. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…s flag - component-governance-utils: add getChangedMdxFilesSince(ref) and files option on scanMDXImports for incremental MDX scans - scan-component-imports: add --since <commit> incremental mode; narrows MDX scan to changed files while keeping full component inventory - audit-component-usage: remove execSync/child_process; use getComponentFiles, extractExports, scanMDXImports from shared utils; fix REPORT_PATH to use REPO_ROOT instead of brittle __dirname traversal - lint-structure: add --files path1,path2,... flag; priority order is LINT_FILE_LIST > --files > --changed-files > positional arg Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ent branch lint-structure.js is a content validator, not component governance tooling. The --files flag addition belongs on docs-v2-dev directly. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… restructure - Fix 136 stale paths in script-classifications.json (111 remapped to new taxonomy locations, 8 remapped to x-archive, 17 deleted entries) - Add 21 missing classification rows for new and split scripts - Regenerate scripts-catalog.mdx, pages-catalog.mdx, and all group script-index.md files - Fix stale spawn path in export-portable-skills.test.js - Fix stale component path in authoring-tools.test.js (quote.jsx moved) - Fix stale generate-ai-skills-indexes.js path in ai-tools-registry.json - Fix 4 stale artifact paths in ai-tools-registry.json (files moved to _workspace/ in latest docs-v2-dev merge) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

@param

Add missing @param className/style to all 22 component exports that destructure those props without JSDoc entries. Fix EmbedMarkdown JSDoc detection (archived comment was breaking block parse). Add @SubNiche to MermaidColours. Fix OPTIONAL_GOVERNANCE_FIELDS not being mapped onto parsed JSDoc object (causing false @Datasource warnings on all integrators). 0 violations on generate-component-registry.js --strict. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Replace __dirname traversal with process.cwd()/git rev-parse REPO_ROOT in 6 scripts: audit-component-usage, terminology-search, generate-glossary, generate-seo, test-v2-pages, lint-copy - Extract magic string 'tools/scripts' to SCRIPTS_ROOT constant in script-footprint-and-usage-audit.js - Extract buried path constant RETENTION_POLICY_PATH to config block in quarantine-manager.js - Extract hardcoded audit-script-inventory.js path to AUDIT_SCRIPT constant in repair-script-inventory.js - Extract V2_ROOT constant in generate-seo.js; replace all /v2/ magic strings with template literals - Add Task 13 (script docs consolidation analysis) to plan.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Analysis of all current script documentation surfaces, problems identified (schema drift, duplication, no single source of truth), and proposed architecture for Task 13 execution. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Fix fabricated import paths across 59 files - Restore SearchTable.jsx component imports - Remove unauthorised CDN asset contract system - Restore inline CDN URLs in 8 consumer files - Fix duplicate frontmatter keys in 6 About pages - Fix multi-view-layout.mdx broken JSX comment syntax - Fix 5 gateway custom composable imports - Remove moved x-deprecated files from docs.json nav Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> allow-deletions: true

allow-deletions: true # Conflicts: # operations/reports/health/page-imports/page-imports-audit.json # operations/reports/health/page-imports/page-imports-audit.md # snippets/templates/pages/gold-standard/multi-view-layout.mdx # v2/about/concepts/core-concepts.mdx # v2/about/network/overview.mdx # v2/about/protocol/design-philosophy.mdx # v2/about/protocol/economics.mdx # v2/about/resources/reference/technical-roadmap.mdx # v2/gateways/custom/views/quickstart/docker/dockerOffChainTab.mdx # v2/gateways/custom/views/quickstart/docker/dockerOnChainTab.mdx # v2/gateways/quickstart/views/docker/dockerOffChainTab.mdx # v2/gateways/quickstart/views/docker/dockerOnChainTab.mdx # v2/home/mission-control.mdx # workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/core-concepts.mdx # workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/design-philosophy.mdx # workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/economics.mdx # workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/economics2.mdx # workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/network-overview.mdx # workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/technical-roadmap.mdx

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…ate-assets-to-branch] allow-deletions: true

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Stage all in-progress changes before creating merge worktree. Includes: resources portal rename, style updates, render gate scripts, docs-navigation test, console baseline, session log. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> allow-deletions: true allowlist-edit: true

Governance scripts, blueprint mapping, session log, and minor content fixes. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merges 1,066 commits from docs-v2-dev. docs-v2-dev is source of truth — all content conflicts resolved in favour of dev (-X theirs), 110 structural rename/rename and rename/delete conflicts resolved to dev's paths. Also fixes test infrastructure: file-walker and mdx-safe-markdown now respect .mintignore and skip _workspace/x-archived/workspace directories. Style issues: 253 → 4. MDX violations: 37 → 9. File scan: 1733 → 1234. Backup tags: pre-merge-dev-backup-20260407, pre-merge-v2-backup-20260407 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> allow-deletions: true

mintlify · 2026-04-07T12:40:12Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
na-36	🟢 Ready	View Preview	Apr 7, 2026, 12:45 PM

…y conflict) allow-deletions: true

github-actions · 2026-04-07T12:49:02Z

📊 V2 Browser Sweep Results

❌ Test report not found. The test may have failed before report generation.

Likely failed in setup/cache/server-start steps before npm run test:v2-pages.

DeveloperAlly and others added 30 commits March 20, 2026 02:42

chore: stage auto-modified skill templates

6d8f7b0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

update docs.json

7192b48

Revert "revert(components): restore original component code, keep str…

dee55eb

…ucture + JSDoc" This reverts commit 929eae3.

teminology work

409e6aa

update mintignore, add temrinology

fc0a2c9

component tooling

54719e3

clean up components

f4d751d

Merge branch 'docs-v2-dev' into docs-v2-dev-components

9e0538c

fix(docs): update component notes to remove deprecated ThemeData refe…

e48f98a

…rences Remove references to deprecated ThemeData/themeStyles.jsx from FrameMode and Portals example files, and add script governance framework draft. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Merge branch 'docs-v2-dev-components' into docs-v2-dev

55e370e

restructure

d5f33aa

Merge branch 'docs-v2-dev' into docs-v2-dev-scripts

1cdc030

handy preview tool

72c777e

revert(scope): remove lint-structure change — out of scope for compon…

b5606ad

…ent branch lint-structure.js is a content validator, not component governance tooling. The --files flag addition belongs on docs-v2-dev directly. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Merge branch 'docs-v2-dev' into docs-v2-dev-scripts

4992fb5

updates

40bcff1

Merge branch 'docs-v2-dev' into docs-v2-dev-components

b320290

DeveloperAlly and others added 23 commits April 5, 2026 21:31

fix delegator portal

7383a77

restucture delegators

390b78e

restucture developers

c015ff1

repo govenance enforcement and cleanup

57364a7

update developer content

18b4d01

implement repo govenance standards execution

53a4583

developers content

c864414

restructure and consolidate gateway setup guide

8ccfa5d

restructure and consolidate gateway setup guide

9c70f8f

restructure and consolidate gateway setup guide

0d2050c

fix assets & about

ad4394d

docs(process): add v2 site map

e9c98fa

fix docs.json

d12425d

fix: restore Shrek gif CDN URL on mission-control

caaa644

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(assets): remove migrated assets from docs-v2 working tree [migr…

66609ed

…ate-assets-to-branch] allow-deletions: true

chore(assets): regenerate media-audit manifest with current file state

c946848

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix assets

503e669

fix assets

35b99be

chore: commit working state before docs-v2 merge

7eeb3db

Governance scripts, blueprint mapping, session log, and minor content fixes. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

mintlify Bot deployed to staging April 7, 2026 12:45 View deployment

merge: incorporate latest docs-v2 commits (resolve deprecated glossar…

fdde516

…y conflict) allow-deletions: true

mintlify Bot deployed to staging April 7, 2026 12:51 View deployment

DeveloperAlly merged commit 01544f0 into docs-v2 Apr 7, 2026
6 of 14 checks passed

DeveloperAlly deleted the merge/docs-v2-dev-to-docs-v2 branch April 7, 2026 12:53

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

merge: docs-v2-dev into docs-v2 (2026-04-07)#867

merge: docs-v2-dev into docs-v2 (2026-04-07)#867
DeveloperAlly merged 1070 commits intodocs-v2from
merge/docs-v2-dev-to-docs-v2

DeveloperAlly commented Apr 7, 2026

Uh oh!

mintlify Bot commented Apr 7, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

DeveloperAlly commented Apr 7, 2026

Summary

What's included

Verification

Test infrastructure fix

Rollback

Test plan

Uh oh!

mintlify Bot commented Apr 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Apr 7, 2026

📊 V2 Browser Sweep Results

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

mintlify Bot commented Apr 7, 2026 •

edited

Loading