merge: docs-v2-dev into docs-v2#875
Merged
DeveloperAlly merged 1152 commits intodocs-v2from Apr 8, 2026
Merged
Conversation
- Add `aiDiscoverability` to OPTIONAL_GOVERNANCE_FIELDS in component-governance-utils.js - Fix isLegacyDuplicateComponentPath macOS case-sensitivity bug (fs.existsSync → readdirSync) - Registry generator: separate validation warnings from hard errors — warnings no longer block registry write; --strict flag still exits non-zero on warnings - Add missing @deprecated + @see tags to BasicBtn, LivepeerIconOld, LivepeerIconFlipped - Regenerate component-registry.json: 121 components (was 42), 10 with aiDiscoverability Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…y files CDA-2: Write docs-guide/catalog/ai-companion-schema.json - JSON Schema 2020-12 for both companion types: snapshot and props-extracted - snapshot: _meta block + exchanges array (CoinGeckoExchanges) - props-extracted: glossaryCompanion (terms[]) + showcaseCardsCompanion (items[]) - Updated manifest schema pointer from stub reference to actual file CDA-4: Commit companion files - v2/home/solutions/showcase-data.json: ShowcaseCards companion (all locale pages share it) - Manifest: promote ShowcaseCards from pendingCompanions → companions (status: current) - 9 glossary-data.json files: commit pre-generated output from generate-glossary-companions.js Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…es and skills Rename /tasks → /workspace affected 48 AI tool files. Updates: - agent-packs: claude/CLAUDE.md, cursor/rules.md, windsurf/rules.md, codex/skills-manifest.json - agent-packs/skills: 12 SKILL.md files + 2 reference docs - ai-skills: 10 SKILL.md files, skill-catalog.json, source-content augment-instructions, templates (14 files) - registry: ai-tools-registry.json - .cursor/rules/no-deletions.mdc, .github/AGENTS.md, .github/augment-instructions.md All workspace/reports/repo-ops/, workspace/research/claims, workspace/plan/ paths now correct. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
components-catalog, scripts-catalog, workflows-catalog, ui-templates snippets/UI template artifacts, and script-registry all drift after the CDA-1/2/4 commits. Regenerated with existing generator scripts. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documents the full secrets/env-var handover for the solutions social data pipeline: YouTube, Ghost, Discord, GitHub, RSS fetch scripts with their workflows, schedules, and setup checklist. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Moved from repo root to docs-guide/repoOps/config/ (no allowlist change needed). Grouped into clear blocks: Solutions Social Data Automations, Docs Infrastructure, Project Showcase Pipeline, Local-Only Tooling. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…wiring
New community pages for all 5 products:
- daydream/community.mdx: YouTube, GitHub README, X, Discord, Blog
- embody/community.mdx: YouTube, GitHub README, Forum threads
- frameworks/community.mdx: YouTube, GitHub README, X, Discord, Forum
- livepeer-studio/community.mdx: full data feeds (YT, blog, forum, Discord)
- streamplace/community.mdx: GitHub, Bluesky, Discord, Blog, Forum, Apps
Also:
- trending-topics.mdx: added Product Communities CardGroup (cols={2})
- docs.json: wired community pages into each product nav group
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Restructures the two main executable roots into operations/: tools/scripts/ → operations/scripts/ tests/ → operations/tests/ Updates all path references across 8+ surfaces: - tools/package.json (~50 npm scripts) - operations/tests/package.json (~30 npm scripts) - .github/workflows/*.yml (20+ files) - .githooks/pre-commit + verify.sh - tools/config/*.json (ownerless-governance, generated-artifacts, report-retention) - tools/lib/*.js (path.join calls, relative requires) - AGENTS.md + .codex/task-contract.yaml - .allowlist (tests → operations) - ai-tools/registry/ai-tools-registry.json + ai-skills/inventory.json - docs-guide/component-registry.json + component-usage-map.json - tools/config/script-registry.json (regenerated, 265 entries) - tools/lib/script-governance-config.js (DISCOVERY/GOVERNED/INDEXED_ROOTS) Fixes Node module resolution: adds operations/node_modules → ../tools/node_modules symlink. Regenerates stale catalogs: pages-index, docs-guide indexes, component-docs. Test suite: 673 errors (−12 vs 685 baseline), 10111 warnings. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> allow-deletions: true allowlist-edit: true
…rations/ Merges docs-v2-dev-scripts into docs-v2-dev. Resolves conflicts in: - AGENTS.md (updated to operations/scripts/ paths) - ai-tools/registry/ai-tools-registry.json (operations/ path + correct docs-guide/tooling/ path) - docs-guide/component-registry.json (updated generator path, kept componentCount: 121) - operations/tests/unit/ai-tools-registry.test.js (correct full operations/ path) - operations/tests/unit/codex-skill-sync.test.js (correct automations/ai/agents/ path) - v2/*/index.mdx (kept docs-v2-dev versions; will regenerate) - tools/config/script-registry.json (kept operations/ paths from scripts branch) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> allowlist-edit: true
- structure.md → component-framework-canonical.md - audit-report.md, component-docs.md → Audits/ - jsdoc-reference.md → Frameworks/ - doc-recommendation.md, script-thread-sync-note.md → Tasks/ - composables-research.md → Research/ - Update all internal links in plan.md, index.md, Research file Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Full audit of all governance pipelines, documentation surfaces, redundancies, manual vs automated, AI vs human responsibilities, and prioritised recommendations (P1/P2/P3). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Full phased execution plan covering P1/P2/P3 audit items: - Phase 1: aiDiscoverability batch-fill, CATALOG.md archive, CI path fix - Phase 2: CI wiring (registry, docs pages, CDA-6 checker, taxonomy publish) - Phase 3: @param warnings, layout decisions re-verify, catalog.md header Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
UNIVERSAL-AI-PROTOCOL.md was already in _retired. Moves AI-ACCOUNTABILITY-CHECKLIST.md and removes duplicate root AI_GUIDELINES.md (_retired copy is the archive). All three described fictional infrastructure that does not exist: - .ai-operations.log (never existed) - checkpoint/YYYY-MM-DD_HHMMSS auto-commit system (never existed) - .ai-commit-verified token file (never existed) Core policy is in AGENTS.md. HUMAN-OVERRIDE-POLICY.md and rules/git-safety.md stay. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> allow-deletions: true
… AGENTS.md and ROLLBACK-GUIDE AGENTS.md — 4 targeted additions: - Safety/Git: check git status before staging, don't mix concerns in one commit, fix pre-commit root causes, conventional commit convention - Structure: docs.json requires user confirmation before commit, workspace/ usage rules, read-before-edit requirement - Validation: change-type → validator mapping table replaces flat list - Response contract: scope discipline, surface decisions, checkpoint on long tasks ROLLBACK-GUIDE.md — stripped fictional checkpoint system (5-min auto-commits, checkpoint/ branches never existed). Added "Diagnose Before You Fix" as the opening principle. All git recovery commands retained and accurate. best-practices.md — new file covering the craft of working well: scope discipline, when to ask vs proceed, handling ambiguity, communicating findings and errors, checkpointing, workspace/ usage, read-before-edit, working with the user. No existing file covered any of this. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…rate stale catalogs Resolves all path breakages introduced by the tools/scripts → operations/scripts and tests/ → operations/tests/ restructure (Task 11/14). Fixes: - 84 scripts: batch-update stale @scope tags and usage strings from tools/scripts/ → operations/scripts/ - operations/tests/run-all.js: fix REPO_ROOT (2 ups, not 3), correct spawnSync paths, fix staged-file comparisons - operations/tests/run-pr-checks.js: fix 20 stale tests/unit/ and tests/integration/ paths + require() depth - operations/tests/unit/docs-path-sync.test.js: fix REMEDIATOR_PATH and VALIDATOR_PATH (tools/scripts → scripts) - tools/lib/docs-usefulness/scoring.js: fix require path to operations/tests/utils/mdx-parser - tools/lib/ai-tools-registry.js: fix repo prefix validation list (tests/ → operations/) - operations/tests/unit/component-governance-generators.test.js: fix REPO_ROOT depth (2 → 3 ups) - operations/scripts/audits/governance/scripts/script-footprint-and-usage-audit.js: fix SCRIPTS_ROOT and walkFiles paths - operations/scripts/audits/governance/repo/audit-tasks-folders.js: fix runtime recommendation strings - operations/scripts/remediators/content/repair/quarantine-manager.js: fix tests/ → operations/tests/ path - operations/scripts/remediators/content/repair/migrate-assets-to-branch.js: fix cwd path - operations/scripts/remediators/content/style/wcag-repair-common.js: fix require path for wcag audit - operations/scripts/automations/governance/pipelines/publish-v2-internal-reports.js: fix require depth (4→5 ups) - operations/scripts/validators/content/structure/check-description-quality.js: fix forEach parameter name collision - v2/resources/documentation-guide/automations-workflows.mdx: fix broken link tools/scripts/README.md → operations/scripts/README.md Catalog/index regeneration: - docs-guide/catalog/scripts-catalog.mdx, pages-catalog.mdx, components-catalog.mdx, workflows-catalog.mdx, templates-catalog.mdx, ui-templates.mdx - .vscode/templates.code-snippets (UI template snapshots) - v2/*/index.mdx (generated banner run command strings updated) - v2/cn/ + v2/fr/ component library docs (regenerated via generate-component-docs --fix --template-only) - operations/scripts/script-index.md + operations/tests/script-index.md (regenerated) Pre-existing errors unchanged: Style Guide (559), MDX-safe markdown (98), Nav (4), Allowlist (3), Usefulness (2). Total errors: 666 (down from 673 at Task 14 baseline). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…cripts Merges commit 4b3be01 — all path fixes, module errors, and catalog regeneration from the operations/ restructure pipeline audit. Resolves 13 merge conflicts: - .vscode/templates.code-snippets: took scripts branch (updated snapshots) - docs-guide/catalog/scripts-catalog.mdx, ui-templates.mdx: took scripts branch - i18n test files (6): took scripts branch (correct operations/ paths) - validate-ai-tools-registry.js: took scripts branch - generate-ui-templates.js: merged @scope from scripts + kept correct runCommand from HEAD - generate-docs-guide-indexes.js, generate-docs-guide-pages-index.js: merged @pipeline from HEAD + @scope/@Usage paths from scripts branch Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…e/style (P1-A + P3-A) - Added @aiDiscoverability none to all 111 components that had empty field (37 files) - Added missing @param {string} [className=''] to 63 components - Added missing @param {object} [style={}] to 53 components - Registry regenerated: 0 errors, 0 warnings, 121 components all with explicit aiDiscoverability Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…uthoritative (P1-B) - Moved snippets/components/CATALOG.md to snippets/components/x-archive/CATALOG.md - Added browsable catalog pointer to README (docs-guide/catalog/components-catalog.mdx) - Zero references to CATALOG.md remain outside the archive Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…aths (P1-C) - Added .github/workflows/generate-component-registry.yml: auto-regenerates component-registry.json on push to main when snippets/components/**/*.jsx changes - Added registry --validate-only check step to check-docs-guide-catalogs.yml so registry is validated on every PR - Fixed stale tools/scripts/ paths → operations/scripts/ in 4 workflows: check-docs-guide-catalogs.yml, generate-docs-guide-catalogs.yml, check-ai-companions.yml, generate-ai-companions.yml - Added missing npm install step to check-ai-companions.yml and generate-ai-companions.yml Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- check-docs-guide-catalogs.yml: added generate-component-docs.js --check step so PR CI fails if component docs pages are stale vs registry - generate-docs-guide-catalogs.yml: added generate-component-docs.js --write step so component docs pages are auto-regenerated on main push Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Added check-naming-conventions.js (PascalCase + folder taxonomy) to test-suite.yml without continue-on-error — violations now block PRs - Added check-mdx-component-scope.js (no cross-.jsx imports, Decision D4) to test-suite.yml without continue-on-error — violations now block PRs - Both validators are deterministic with zero false-positive risk Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- New operations/scripts/validators/governance/ai/check-companion-manifest.js: validates ai-companion-manifest.json is consistent with registry aiDiscoverability fields. Fails if a component tagged snapshot/props-extracted has no manifest entry, or if any companionPath doesn't exist on disk. - pendingCompanions[] entries count as acknowledged (no false positives for deferred). - Added MarkdownEmbed to pendingCompanions (deferred — usage audit required). - Wired --check step into check-ai-companions.yml CI workflow. - Checker passes on current state (4 registry components, 13 manifest entries). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Added docs-guide/frameworks/component-framework-canonical.mdx: published version of the canonical taxonomy with proper MDX frontmatter - Includes: full folder tree, decision rules, component counts, JSDoc tag reference, @status/@accepts/@aiDiscoverability value tables, example headers - Excludes: plan-phase "Alignment with script governance" comparison table - Added to docs.json navigation under docs-guide/frameworks/ - Updated workspace source file header to reference the published path Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…3-B) - Added guide (208 active pages), quickstart (20), resource (5) to matrix - All 3 were in active use in v2/ but had no layout contract - Fixed stale tools/scripts/ path in validation command → operations/scripts/ - Updated lastVerified to 2026-03-21 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…bplan (P3-C) - pipeline-audit.md: replaced all tools/scripts/ paths with operations/scripts/ (operations/ is the correct active path; tools/ has no scripts/ subdirectory) - governance-pipeline-subplan.md: corrected Pre-work and P1-C sections that had the path direction backwards. Added correction notes and documented the actual fix applied (tools/scripts/ → operations/scripts/ in 4 CI workflows) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Full record of all P1/P2/P3 items, design lock-ins, CI gate state, registry metrics, and deferred items. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…dge tag migration Root cause fix in component-governance-utils.js: - updateJSDocTags() was filtering through GOVERNANCE_FIELDS which only contained migrated names (type/subniche). Replacements using legacy names (category/subcategory) were silently dropped. Fixed by expanding the filter to include all known fields + any key in replacements. generate-component-registry.js: - Added subniche || subcategory bridge for data extraction (line 140) repair-component-metadata.js: - Fixed broken string literal in help text (sed damage from --verify addition) - Batch applied 406 repairs across 32 component files: category, subcategory, status, aiDiscoverability, usedIn, breakingChangeRisk, lastMeaningfulChange update-jsdoc-headers.js: - Made blank @niche a warning (not failure) in --verify MermaidColours.jsx: - Set @subcategory config (was blank — config/ has no subfolder) Registry regenerated: 132 components, 2026-04-09 timestamp. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The merge took --theirs for 39 content files, which reintroduced old import paths that our consolidation had updated. Fixed: - CustomCardTitle.jsx -> Text.jsx (27 files) - LazyLoad.jsx -> Layout.jsx (32 files) - ScrollBox.jsx -> Layout.jsx (22 files) - Table.jsx/SearchTable.jsx -> displays/tables/Tables.jsx (23 files) - Various card/grid/step paths -> displays/ (12 files) Also fixed: updateJSDocTags root cause (GOVERNANCE_FIELDS whitelist didn't include category/subcategory), registry subniche bridge, MermaidColours @subcategory, repair-component-metadata help text syntax. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Merged 9 commits including verify flag additions and taxonomy updates. Conflict resolution: - 142 script JSDoc headers: took theirs (canonical 7-concern taxonomy) - update-jsdoc-headers.js: took theirs (canonical taxonomy + legacy maps) - v2/ content files: took theirs (newer content) - generate-component-registry.js: theirs header + our subniche||subcategory bridge - repair-component-metadata.js: merged — theirs header taxonomy + our --auto-issue flag + our expanded SAFE_FIELDS + our verify logic Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> allowlist-edit: true
Resolved 1 conflict (Links.jsx): kept consolidation's re-exports (BlinkingIcon → Icons.jsx, CustomCallout/TipWithArrow → Callouts.jsx). Applied 3 pixel spacing fixes in new files from consolidation (Steps.jsx, Callouts.jsx). Verified with --verify flag. Audit: 0 violations. Remediator: idempotent. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
allow-deletions: true allowlist-edit: true
Contributor
📊 V2 Browser Sweep Results❌ Test report not found. The test may have failed before report generation.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
github-project-automation
bot
moved this from Ready
to Done
in Documentation Restructure
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
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
docs-v2-devintodocs-v2from a dedicated merge worktree/branchdocs-v2-devtreated as source of truth on conflictsValidation run
docs-v2-dev) validations previously run:mint validatepassed after the import-path fixes pushed todocs-v2-devmint validatesnippets/composables/pages/gpu/diagrams/orchestratorRole.mdx:102:3node operations/tests/run-pr-checks.js --base-ref docs-v2Notes
/Users/alisonhaire/Documents/Livepeer/Docs-v2-merge-20260409codex/20260409-docs-v2-dev-into-docs-v2docs-v2-dev -> docs-v2PR path that showed unresolved conflicts.