merge: docs-v2-dev into docs-v2 (2026-05-04)#891
Merged
DeveloperAlly merged 1182 commits intodocs-v2from May 4, 2026
Merged
Conversation
Phase 1 — path accuracy fixes: - AGENTS.md validator table: replace tools/scripts/ with operations/scripts/, replace non-existent validate-frontmatter.js with lint-structure.js - ai-tools/README.md: fix registry script path (tools/ → operations/) - Archive ai-tools/ai-rules/rules/imported/copilot-instructions.md → _retired/ Phase 2 — AI discoverability: - llms.txt: remove 7 duplicate URL entries (stale gateway/changelog entries from old docs.json state; placeholder Resource HUB livepeer-glossary groups) Phase 3 — ai-tools docs cleanup: - contribute/CONTRIBUTING/AGENT-INSTRUCTIONS.md: reduce to pointer to AGENTS.md (Codex paths were stale, content duplicated in AGENTS.md + .github/AGENTS.md) Phase 4 — ai-skills structural integrity: - skill-spec-contract.md: add content-pipeline to category taxonomy (6 values) - skill-docs.test.js: add content-pipeline to VALID_CATEGORIES enum - Regenerate all agent-pack exports via cross-agent-packager - workspace/plan/active/AI-TOOLS-GOVERNANCE/plan.md: write active plan Verification: skill-docs.test.js passes (62 targets, 0 errors); template/agent-pack parity confirmed (42 each); 0 duplicate URLs in llms.txt. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ndations, artefact refs Added three missing sections per completion-reports.md template: - Dependencies on other frameworks (AI Discoverability, Content Framework, composables, script governance, PR allowlist) - Further recommendations R1-R9 (pre-commit hook, CDA-5, @contentAffinity, CI hardening, smoke tests, style overrides registry) - Artefacts reference table — all created/modified files with one-liners Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…checks run-all.js, run-pr-checks.js, tests/package.json, and the integration smoke test had hardcoded require() paths and string literals using old check-* filenames that sed missed (require paths with directory separators). Updated to validate-*, enforce-* per the Task 5 mass rename. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ead learnings - Extended Co-Creation Baseline: dry-run clause for batch/hard-to-reverse ops - Extended Read Before Working: empirical verification of claims and fix directions (verify both sides before writing "X is wrong, should be Y") - New: Verify Pre-conditions Before Executing - New: Evaluate Plans Against Outcomes, Not Task Lists - New: One-Shot Tools Have a Cleanup Step Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Moves 5 JSON files from docs-guide/ root and docs-guide/catalog/ to docs-guide/config/ and updates all 20+ consumers. Files moved: - docs-guide/component-registry.json → docs-guide/config/ - docs-guide/component-registry-schema.json → docs-guide/config/ - docs-guide/component-usage-map.json → docs-guide/config/ - docs-guide/catalog/ai-companion-manifest.json → docs-guide/config/ - docs-guide/catalog/ai-companion-schema.json → docs-guide/config/ Consumers updated: generate-component-registry.js, generate-ui-templates.js, generate-docs-guide-components-index.js, generate-component-docs.js, scan-component-imports.js, check-companion-manifest.js, generate-component-registry.yml, run-all.js, run-pr-checks.js, component-governance.mdx, ownerless-governance-surfaces.json, script-registry.json, dev-tools.mdx, ui-system.mdx, ui-template-generator.test.js, automations-workflows.mdx, all v2/component-library MDX pages, generators/ai/README.md, components-catalog.mdx. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…k plan complete - Fix: pageVariant landing → overview on all 5 community pages + template (landing is only valid for pageType: navigation, not resource) - All other checks passed: docs.json nav, component imports, external URLs - Plan marked complete (all 4 phases done) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix all path references: tools/scripts/config → operations/scripts/config - Fix docs-guide/repoOps → docs-guide/repo-ops - Fix pageVariant example: landing → overview (matches Phase 4 fix) - Move socials-research.md → _workspace/research/ per folder structuring guide - Rewrite Section 7 as accurate artefact inventory (as-built tables) - Update .env.example and solutions-secrets.mdx cross-references - Update product-social-config.json source path Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Script restructuring (Task 11) moved tools/scripts/config/ →
operations/scripts/config/ but the .github/scripts/ fetch scripts
were not updated, causing hard crashes in 4/5 scripts (no try-catch
around fs.readFileSync(CONFIG_PATH)).
fetch scripts — fix CONFIG_PATH default:
- fetch-discord-announcements.js: tools/ → operations/ (hard crash)
- fetch-github-discussions.js: tools/ → operations/ (hard crash)
- fetch-github-releases.js: tools/ → operations/ (hard crash)
- fetch-rss-blog-data.js: tools/ → operations/ (hard crash)
- fetch-youtube-data.js: tools/ → operations/ + fix product output path
fetch-ghost-blog-data.js — add $ escaping to safeHTML():
- Template literal injection risk: ${...} in blog HTML content
would evaluate as JS expression. Add .replace(/\$/g, "\\$").
update-livepeer-release.yml — fix stale path:
- snippets/automationData/globals/globals.mdx (never existed)
- → snippets/automations/globals/globals.mdx
- Was silently failing every 30 minutes.
update-discord-data.yml — fix git add glob:
- automations/*/discordData.jsx only matches 1 level deep
- → automations/**/discordData.jsx to include solutions/{product}/
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Fixed 9 script @scope headers still referencing tools/scripts/ — updated to their actual operations/scripts/<type>/<concern>/<niche> paths - Fixed .githooks/pre-push runtime calls to tools/scripts/validators/ — broken for all codex/* branch pushes; now points to operations/scripts/ - Fixed audit-python.py @Usage header (stale tools/scripts/ path) - Regenerated tools/config/script-registry.json (277 entries) - Marked Task 14 complete in plan; added Task 14.9 for the header fixes Also includes pre-existing automation data updates: - snippets/automations/solutions/daydream/blogData.jsx — HTML entity cleanup - snippets/automations/solutions/daydream/youtubeData.jsx — character encoding fixes - snippets/automations/solutions/embody/discordData.jsx — added new announcement entry - snippets/automations/solutions/livepeer-studio/youtubeData.jsx — encoding fixes - v2/solutions/daydream/community.mdx — added DiscordAnnouncements, MarkdownEmbed, wide mode Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Removed cron schedule from update-blog-data.yml — it was running daily at midnight but never worked: uses YOUR_CONTENT_API_KEY placeholder and writes raw JSON (not JSX) which would break imports if it ever ran. Ghost blog data is handled by n8n Ghost-to-Mintlify (→ docs-v2-preview) and .github/scripts/fetch-ghost-blog-data.js (→ main). Forum data is handled by n8n Forum-To-Mintlify-Latest-Topics (→ docs-v2-preview). Updated plan with full n8n path verification findings. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Flags the automations folder restructure (socials-data, showcase-data, product-data) as a new task with full dependency map, risks, and steps. Includes n8n coordination requirement and globals duplication resolution. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Ghost (update-ghost-blog-data.yml): - DOCS_V2 → GITHUB_TOKEN (stale PAT reference) - Added git diff check — only commits when data actually changed - Node 18 → 20 Forum (update-forum-data.yml): - ref: docs-v2 → ref: main (was pointing at old branch) - DOCS_V2 → GITHUB_TOKEN - Added git diff check - Node 18 → 20 Discord (fetch-discord-announcements.js + product-social-config.json): - Extracted writeJSX() helper — DRY, used by both product and global paths - Added globals.discord loop — reads config.globals.discord[] and writes each entry to its explicit outputPath with its explicit exportName - Added livepeer-community global channel entry to product-social-config.json (server 1066890817425387581, channel 1463391944746078319) → writes to snippets/automations/discord/discordAnnouncementsData.jsx - GHA now covers the global community Discord feed previously n8n-only Also: workspace/plan/active/AUTOMATIONS-RESTRUCTURE/plan.md — full subplan for snippets/automations/ restructure with dependency map, execution order, and risk table. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Replace all hardcoded branch refs with vars.DEPLOY_BRANCH / vars.TEST_BRANCH - Add use_test_branch boolean input to all data workflow_dispatch blocks - Fix sync-large-assets.yml: use "**" push trigger + job-level if: condition (GHA limitation prevents vars.* in on: push: branches:) - Rewrite fetch-ghost-blog-data.js to use public RSS feed (blog.livepeer.org/rss/) — removes GHOST_CONTENT_API_KEY dependency entirely - Remove GHOST_CONTENT_API_KEY from update-ghost-blog-data.yml - Update product-social-config.json: livepeer-studio fetchMethod ghost-api → rss - Rename vars.DEPLOY_BRANCH_TEST → vars.TEST_BRANCH in all workflows Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…nkedin Adds `iconColor` prop that overrides all icons to one colour when passed, falling back to per-brand colours when absent. Also adds linkedin to both the colour map and icon map. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…verview Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Bulk merge of 1,170 commits from docs-v2-dev into docs-v2 from a fresh worktree branched off origin/docs-v2. Conflict resolution policy - docs-v2-dev = source of truth for content - 920 conflicts resolved en-masse (810 take-theirs + 110 dev-side deletions) - 188 paths force-removed where dev moved/renamed/deleted them Overrides (preserved docs-v2 versions to avoid losing forward-only content) - v2/solutions/daydream/changelog.mdx — keeps Scope v0.2.0..v0.2.4 (PRs #880, #882, #885, #888) - v2/resources/changelog/protocol/go-livepeer.mdx — keeps Apr 2026 macOS binary fix + Mar 2026 BYOC/webcam updates (PRs #879, #881) - v2/resources/changelog/go-livepeer.mdx — keeps lastVerified 2026-04-18 Auto-generated artefacts - sitemap-ai.xml, llms.txt, glossary-data.json, resource-hub-terms-data.json are taken from dev; expected to regenerate on next pipeline run. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
📊 V2 Browser Sweep Results❌ Test report not found. The test may have failed before report generation.
|
Standardised frontmatter scalars to double quotes and replaced em-dash characters with en-dash in authored MDX. Generated by .github/workflows/remediator-brand-repair-frontmatter-and-em-dashes.yml
Brings forward the latest docs-v2-dev commit (`update token, architecture`, 7576184) which post-dates the initial merge. Reverted the 3 prior content overrides — dev refactored these changelogs into composable wrappers, so taking dev's version preserves the architectural intent. Dev's snippet-backed pages are now in: - v2/solutions/daydream/changelog.mdx -> renders <DaydreamChangelog /> from /snippets/composables/pages/changelogs/solutions/daydream.mdx - v2/resources/changelog/protocol/go-livepeer.mdx -> renders <GoLivepeerChangelog /> from /snippets/composables/pages/changelogs/protocol/go-livepeer.mdx - v2/resources/changelog/go-livepeer.mdx removed (dev consolidated) Note for follow-up: dev's snippet content is missing some recent docs-v2 entries (daydream v0.2.2/v0.2.3/v0.2.4, go-livepeer Apr macOS binary fix, Mar BYOC/webcam). These should be ported into the snippets in a separate PR. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…hub.com/livepeer/docs into merge/docs-v2-dev-into-docs-v2-20260504
Standardised frontmatter scalars to double quotes and replaced em-dash characters with en-dash in authored MDX. Generated by .github/workflows/remediator-brand-repair-frontmatter-and-em-dashes.yml
Standardised frontmatter scalars to double quotes and replaced em-dash characters with en-dash in authored MDX. Generated by .github/workflows/remediator-brand-repair-frontmatter-and-em-dashes.yml
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Bulk merge of all commits from
docs-v2-dev(current HEADce0fa917d remove dev2 tab) intodocs-v2(HEAD31e954808 chore(seo): refresh AI sitemap) from a fresh worktree.Branch is in sync with
docs-v2-devHEAD as of 2026-05-04. Merge commits in this PR:5575bc907— initial merge of dev (52a7ad9) into docs-v2 (31e9548), 920 conflicts resolved73daaa70b— second merge bringing forward dev's757618409 update token, architecture, 2 conflicts resolved06d103f5f— pull of remote auto-repair commit146d34e6a— auto-repair (em-dashes + frontmatter quoting) commit from the workflowd1d4625d6— third merge bringing forward dev's3aea198ce remove dev2 tabandce0fa917d remove dev2 tabConflict resolution policy
docs-v2-dev= source of truth.UU)docs-v2-devAA)docs-v2-devAU)docs-v2-devUA)docs-v2-devUD)DD)What "force-removed" means here
These 188 paths exist on
docs-v2but not ondocs-v2-dev. Most are renames dev already applied — the merge correctly brought in dev's new file at the new path; the old path was removed to match dev's tree. Examples:operations/scripts/integrators/copy/showcase/fetch-config-flags.jsoperations/scripts/integrators/maintenance/data-feeds/fetch-config-flags.jsoperations/scripts/integrators/copy/showcase/fetch-contract-addresses.jsoperations/scripts/integrators/maintenance/contracts/fetch-contract-addresses.jsv2/about/concepts/core-concepts.mdxv2/about/protocol/economics.mdxv2/_workspace/archive/language-pages/es/cn/community/livepeer-community/...language-pages/es/cn/community/...The full 188-file list is in commit
5575bc907. None of these are content losses — they reflect dev's intentional restructuring.Auto-generated artefacts taken from dev
Will regenerate on the next pipeline run, no manual action required:
sitemap-ai.xmlllms.txtv2/resources/glossary-data.jsonv2/resources/resource-hub-terms-data.jsondocs-index.jsonHeads-up: changelog snippets missing recent entries
Dev refactored
daydream/changelog.mdxandprotocol/go-livepeer.mdxinto composable wrappers that render content from/snippets/composables/pages/changelogs/. The wrappers were taken from dev (preserves the architectural refactor), but dev's snippet content is missing some recent entries that landed ondocs-v2after the last merge:These should be ported into the snippet files in a follow-up PR. Not blocking this merge.
Test plan
<DaydreamChangelog />snippet)v2/orchestrators/portalrenders (CenteredContainer import preserved on dev side)sitemap-ai.xmlandllms.txtregenerate on next pipeline rundocs.json(took dev's version — note: dev removed 263 lines of nav config and added scoped-navigation/docs-dev-work.json)🤖 Generated with Claude Code