merge: docs-v2-dev into docs-v2 with import fixes#876
Merged
DeveloperAlly merged 1154 commits intodocs-v2from Apr 8, 2026
Merged
merge: docs-v2-dev into docs-v2 with import fixes#876DeveloperAlly merged 1154 commits intodocs-v2from
DeveloperAlly merged 1154 commits intodocs-v2from
Conversation
…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>
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>
…ify + docs Phase 1: Self-documenting generator - generate-styles-docs.js reads remediator/audit/style.css source - Produces manifest: 57 tokens, 6 audit categories, 14 capabilities - --check mode verifies docs match source, --write updates manifest Phase 2: Missing patterns #5, #6, #10 - icon-label-to-customcardtitle: extracts icon name + text via regex - bold-text-to-subtitle: matches hero-text + bold spans - date-label-to-subtitle: matches changelog date divs - Dynamic replacement function support in component migrator Phase 3: --verify flag - Post-write regression check: re-runs audit on modified files - MDX parse checks (conflict markers, import blank lines) - Reverts ALL changes on failure, exits non-zero Phase 4: Workflow regression step - styles-governance.yml now passes --write --verify - Added regression check step with mint validate - needs-review label on regression failures Phase 5: Documentation updated - Engineering guide: 14 remediator capabilities, --verify docs, final metrics - Style guide: pixel spacing tokens, brand colour tokens - CLAUDE.md: thread row updated to final (0 non-mermaid violations) - Fixed stale automations/ paths to data/exchanges/ and data/gateways/ Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ipt headers Rewrote update-jsdoc-headers.js from scratch: - Old version replaced entire JSDoc blocks, destroying existing values, multi-line descriptions, @Policy tags, and correct @mode settings - New version patches ONLY blank @type/@concern/@niche fields in-place - Never overwrites existing non-empty values - Derives taxonomy from file path: operations/scripts/<type>/<concern>/<niche>/ - Includes --verify flag (layer 1 self-verification) - Line-by-line tag extraction prevents cross-line regex matching bugs Applied to 144 scripts across the repo: - All 12 incomplete component scripts now have correct headers - 132 additional scripts across audits, generators, validators, remediators, dispatch, and config - 23 scripts have blank @niche (path structure lacks niche folder) — flagged by --verify for manual resolution Co-Authored-By: Claude Opus 4.6 (1M context) <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
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
DeveloperAlly
deleted the
codex/20260409-docs-v2-dev-into-docs-v2-import-fixes
branch
Contributor
📊 V2 Browser Sweep Results❌ Test report not found. The test may have failed before report generation.
|
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
docs-v2-devintodocs-v2from a dedicated merge branch/worktreeLinks.jsxexport surface on the merge branchBlinkingIcon,TipWithArrow, andCustomCalloutimports to their canonical source files across affectedv2/**pages and templatesValidation status
lpd devbrowser checks were rerun on the portal-family routes after the import-path fixesBaseBlinkingIcon is not definedis cleared on the local scoped merge previewNotes
docs-v2-dev/Users/alisonhaire/Documents/Livepeer/Docs-v2-merge-20260409