Merge/docs v2 dev draft into docs v2 20260522

.claude/CLAUDE.md

@@ -43,7 +43,7 @@ Alison Haire (Wonderland). Documentation lead. Decision authority.
 | References | `.claude/references/` — 26 files, 13 categories. Exemplars + best-practice + patterns. Concern-audit methodology validated | Done | 2026-03-31 |
 | Solutions Merge | merge/solutions-to-docs-v2 branch ready, pushed to origin. PR creation blocked by hook — user runs manually | Pending PR | 2026-03-30 |
 | Workflow Alignment Skills | `/thread` v1.4: auto-derive entry (no questions), 10-phase lifecycle. PreEdit auto-gen hook shipped | Done | 2026-03-31 |
-| GitHub Actions Governance | Phases 0-5 + governance design complete. Framework rewritten (pipeline architecture first). 6 enforcement layers designed from first principles. 11 gaps audited. 7-phase implementation plan approved (unified control plane first). Next: Phase 0 (operations/governance/ registry) | Active | 2026-04-05 |
+| GitHub Actions Governance | **Complete (2026-05-22).** 4-tier composable architecture shipped. 53 → 11 active workflows (6 dispatch-{concern}.yml + 5 governance interfaces). 65 pipeline + meta dispatchers under operations/scripts/dispatch/. ~190 atomics + 8 NEW remediators built and tested. D-GOV-08 (every folder governed, prevention at earliest layer) wired across layers 1-5. Smoke test: 66/66 passing. Framework canonical at docs-guide/frameworks/github-actions.mdx | Done | 2026-05-22 |
 | Snippets Audit | Full audit of `snippets/automations` and `snippets/data` with creator/consumer/risk report in `snippets/_workspace/reports/automations-data-audit-2026-04-05.md` | Done | 2026-04-05 |
 | Delegators | Canonical `v2/delegators` IA rebuild: live route migration, glossary move, reference pages, nav/redirect propagation, generated surface sync | Done | 2026-04-06 |
 | Gateways Verify | Consolidated verify page (`v2/gateways/setup/verify/test.mdx`) — health checks, end-to-end tests, on-chain verification for video/AI/dual across Docker/Linux/Windows. Research collated, 3 OS child views built. Scoped distinct from monitor (Prometheus/Grafana) | Done | 2026-04-07 |
@@ -55,6 +55,7 @@ Alison Haire (Wonderland). Documentation lead. Decision authority.
 | Agent Creation Skills | 3 skills (`/create-component`, `/create-script`, `/create-action`) + `generate-component-snippets.js`. Full governance compliance, self-documenting pipelines, VS Code tooling updates. Fills actions-audit.json and concurrency group gaps | Done | 2026-04-08 |
 | Styles Governance | Full pipeline: audit (6 categories), remediator (14 fix types + --verify regression check), self-documenting generator, GH Actions workflow with regression step. Style guide (10 new sections + pixel spacing + brand tokens). WCAG focus-visible + responsive CSS. CoinGecko exchanges + go-livepeer config flags pipelines. Badge reference + engineering guide. 0 non-mermaid violations (3,986 → 0). 68 mermaid dark-mode variants accepted | Done | 2026-04-09 |
 | UK Spelling + Em-Dash Sweep | remediate-em-dashes.js + remediate-us-spelling.js with --write --verify across v2/. First pass: 21 em-dash + 79 spelling. User flagged scope concern; investigation found two zone-detection bugs in the existing scripts: (1) em-dash script missed multi-line frontmatter block scalars (`description: >-`); (2) spelling script zoned ENTIRE frontmatter as skip, missing user-facing keys. Both scripts patched (block-scalar handling + per-key zoning of title/sidebarTitle/description/keywords). Second pass: +42 em-dash (38 files) + 20 spelling (13 files). Independent audit: 0 em-dashes remaining; 38 UK-spelling hits remain — all in technical identifier references (35 React prop name docs in component-library tables, 2 markdown link paths, 1 filename reference). Flags raised: program→programme rule unconditional; component-library prop-doc tables need rule exclusion or skip-zone | Done | 2026-05-04 |
+| Repo Features Documentation Audit | Two-track effort consolidated. **Track A** (`workspace/plan/active/REPO-FEATURES-DOCS-AUDIT/`): locked D-DG-01..D-DG-13 IA migration plan, source-of-truth matrix, feature verification, framework/policy gap report, archive deletion queue, `check-docs-guide-reference-freshness.js` validator. **Track B** (`workspace/thread-outputs/repo-docs-consolidation/`): 7 product-forward audits + 00-SYNTHESIS.md (110+ features, 80+ community-help opportunities). **Session 2 (2026-05-19, plan: `~/.claude/plans/ok-i-want-a-rippling-metcalfe.md`)**: rewrote `docs-guide/index.mdx` as the canonical docs-as-infrastructure overview (Hero + Quickstart + Philosophy + Personas + IA Tree + 8 feature sections + Ownerless Mgmt + Community Help). Built two new pages: `docs-guide/tooling/mintlify-built-ins.mdx` (Phase 2) and `docs-guide/contributing/community-help.mdx` (Phase 3 — 80+ opportunities indexed by feature domain with file paths + acceptance criteria). Refreshed `README.md` with live counts (341 scripts, 59 workflows, 35 SKILL.md, 132 components, 1,128 v2 .mdx, 693 docs.json routes — corrected from synthesis estimates). Refreshed public `contribute-to-the-docs.mdx` (lpd workflow, `docs-v2` branch, proposal section removed) and filled in empty public `lpd-cli.mdx`. Render-verified: all 5 touched routes return HTTP 200; lint-structure 0 blocking on new files. One blocked item: `documentation-overview.mdx` retirement to a thin `<IndexSource />` pointer is blocked by a render-gate cache that won't clear until contribute-to-the-docs passes Puppeteer (page renders fine via curl in 0.5s; headless times out at 30s). Needs manual cache-clear or longer Puppeteer timeout to ship — non-blocking for everything else. **Session 3 (2026-05-22)**: RFP Phase 1 — filled 6 empty/skeletal Internal stubs from canonical sources (`v2/internal/rfp/outcomes.mdx`, `rfp/deliverables.mdx`, `definitions.mdx`, `ecosystem.mdx`, `references.mdx`, `overview/strategic-alignment.mdx`). All 6 pass static checks (frontmatter, no em-dashes, structure); smoke-test server-start timed out at 5min so render-verify is structural-only. Appended **Part 13 addendum** (2026-02-21 → 2026-05-22) to `v2/internal/rfp/reports/livepeer-docs-v2-report.md` preserving the original 2026-02-21 record intact — covers numbers refresh (320 scripts, 11 workflows, 35 SKILL.md, 1,128 v2 .mdx, 686 docs.json routes, 132 components), the substantial post-handover work (ownerless governance spine, 34 AI skills, agent adapters, GitHub Actions 4-tier refactor, contracts pipeline gold-standard, styles pipeline, asset/changelog pipelines, contributor toolchain), re-graded RFP matrix rows (Changelog Cancelled → Partial; Tutorials Incomplete → Completed; WCAG audited), and named the new post-handover gaps (218 JSDoc backfill, 307-row v2 cleanup, OpenAPI fetcher 2/5, manual OG/SEO, dead Luma feed, stale governance map). Then user picked orphans #2 + #3 (voice-rules collapse, dev-tools retire). **Voice-rules collapse done**: voice-and-copy.mdx absorbed unique voice-rules content (UK English table extended +5 rows: optimise/utilise/customise/analyse/fibre; per-audience table extended with Tone + Lead-with columns; banned phrases extended with "what it takes" / "not just X" / "can generate|may produce" in value claims; new Heading rules section). voice-rules.mdx (27 lines) is a thin retired pointer to voice-and-copy. 3 inbound links updated in governance-index.mdx. **Dev-tools retire done**: contributor-tools.mdx absorbed the VS Code snippets reference (5 files, live counts 23/25/113/125/26, generator command). dev-tools.mdx (39 lines) is a thin retired pointer to contributor-tools / lpd-cli / lpd-mdx-preview. Inbound links updated in source-of-truth-guide.mdx and canonical/Mintlify/index.md; contributor-tools Related section refreshed. UI-2 and TOOL-3 community-help items marked DONE 2026-05-22 in `docs-guide/contributing/community-help.mdx`. Remaining: contracts-pipeline merge into data-integrations.mdx (needs merge-direction call), counts sweep. | Active — RFP Phase 1 + Part 13 + 2 orphan retirements done; contracts-pipeline merge + counts sweep deferred | 2026-05-22 |
 
 **Rule:** When you finish a task or change status, update your row in this table before closing. If the master-tasks.md file has a matching item, update that too.
 

.claude/skills/build/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: build
+description: Agent-delegated execution against approved design. Validates against design criteria. Use after approved design exists.
+---
+
+Read and follow the full skill at `ai-tools/ai-skills/build/SKILL.md`.

.github/.allowlist

@@ -0,0 +1,25 @@
+# .github/ folder allowlist (D-GOV-08)
+# Explicit closed list of permitted entries. Anything not on this list is drift.
+# One entry per line. Trailing / denotes a directory.
+# Enforced by operations/scripts/dispatch/governance/dispatch-folder-allowlist.js
+
+# Required by GitHub
+workflows/
+ISSUE_TEMPLATE/
+pull_request_template.md
+pull-request-template-v2.md
+CODEOWNERS
+
+# Repo config (labels, branch protection rules, etc.)
+config/
+
+# Internal governance workspace (decisions, actions-library, design, framework spec)
+workspace/
+
+# AI tool conventions (each tool expects a specific location)
+AGENTS.md
+copilot-instructions.md
+augment-instructions.md
+
+# Folder governance marker (every governed folder declares one)
+GOVERNANCE.md

.github/workflows/dispatch-brand.yml

@@ -0,0 +1,89 @@
+# type: dispatch
+# concern: brand
+# pipeline: composite (P3 + P5/P6 + manual)
+# dispatch-brand.yml — Action workflow for brand concern.
+name: Brand Pipeline
+
+on:
+  pull_request:
+    paths:
+      - "v2/**/*.mdx"
+      - "snippets/**/*.mdx"
+      - "snippets/components/**"
+  schedule:
+    - cron: "30 6 * * 1"
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: "Mode"
+        type: choice
+        options: [pr, scheduled, manual]
+        default: manual
+      dry_run:
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+concurrency:
+  group: dispatch-brand-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  pr-check:
+    if: github.event_name == 'pull_request'
+    name: Brand · PR Check
+    runs-on: ubuntu-latest
+    permissions: { contents: read, pull-requests: write }
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-node@v4
+        with: { node-version: "20" }
+      - run: cd tools && npm ci
+      - name: Brand PR meta
+        env: { NODE_PATH: tools/node_modules }
+        run: node operations/scripts/dispatch/content/brand/dispatch-brand-check.js --staged
+
+  scheduled-scan:
+    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && inputs.mode == 'scheduled')
+    name: Brand · Scheduled Scan
+    runs-on: ubuntu-latest
+    permissions: { contents: write, issues: write, pull-requests: write }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: "20" }
+      - run: cd tools && npm ci
+      - name: Brand scheduled meta
+        env: { NODE_PATH: tools/node_modules }
+        run: |
+          FLAGS=""
+          if [[ "${{ inputs.dry_run }}" == "false" ]]; then FLAGS="--write --verify"; fi
+          node operations/scripts/dispatch/content/brand/dispatch-brand-scan.js $FLAGS
+
+  manual-repair:
+    if: github.event_name == 'workflow_dispatch' && inputs.mode == 'manual'
+    name: Brand · Manual Repair
+    runs-on: ubuntu-latest
+    permissions: { contents: write, pull-requests: write }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: "20" }
+      - run: cd tools && npm ci
+      - name: Brand manual repair
+        env: { NODE_PATH: tools/node_modules }
+        run: |
+          FLAGS=""
+          if [[ "${{ inputs.dry_run }}" == "false" ]]; then FLAGS="--write --verify"; fi
+          node operations/scripts/dispatch/content/brand/dispatch-brand-repair.js $FLAGS
+      - name: Open PR with fixes
+        if: ${{ inputs.dry_run == false }}
+        uses: peter-evans/create-pull-request@v7
+        with:
+          title: "chore(brand): manual repair sweep"
+          commit-message: "chore(brand): apply brand fixes [skip ci]"
+          branch: chore/brand-repair-${{ github.run_id }}
+          labels: brand, auto-generated, needs-review

.github/workflows/dispatch-copy.yml

@@ -0,0 +1,94 @@
+# type: dispatch
+# concern: copy
+# pipeline: composite (P3 + P5/P6 + manual)
+# dispatch-copy.yml — Action workflow for copy concern.
+name: Copy Pipeline
+
+on:
+  pull_request:
+    paths:
+      - "v2/**/*.mdx"
+      - "snippets/data/**"
+  schedule:
+    - cron: "0 3 * * *"
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: "Mode"
+        type: choice
+        options: [pr, scheduled, manual]
+        default: manual
+      dry_run:
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+concurrency:
+  group: dispatch-copy-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  pr-check:
+    if: github.event_name == 'pull_request'
+    name: Copy · PR Check
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: copy PR meta
+        env:
+          NODE_PATH: tools/node_modules
+        run: node operations/scripts/dispatch/content/copy/dispatch-copy-check.js --staged
+
+  scheduled:
+    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && inputs.mode == 'scheduled')
+    name: Copy · Scheduled
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: copy scheduled meta
+        env:
+          NODE_PATH: tools/node_modules
+        run: |
+          FLAGS=""
+          if [[ "${{ inputs.dry_run }}" == "false" ]]; then FLAGS="--write --verify"; fi
+          node operations/scripts/dispatch/content/copy/dispatch-copy-update.js $FLAGS
+
+  manual-repair:
+    if: github.event_name == 'workflow_dispatch' && inputs.mode == 'manual'
+    name: Copy · Manual Repair
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: copy manual repair
+        env:
+          NODE_PATH: tools/node_modules
+        run: |
+          FLAGS=""
+          if [[ "${{ inputs.dry_run }}" == "false" ]]; then FLAGS="--write --verify"; fi
+          node operations/scripts/dispatch/content/copy/dispatch-copy-repair.js $FLAGS

.github/workflows/dispatch-discoverability.yml

@@ -0,0 +1,118 @@
+# type: dispatch
+# concern: discoverability
+# pipeline: composite (P3 + P5/P6 + manual + P4 post-merge)
+# dispatch-discoverability.yml — Action workflow for discoverability concern.
+name: Discoverability Pipeline
+
+on:
+  pull_request:
+    paths:
+      - "v2/**"
+      - "snippets/**"
+      - "docs.json"
+  push:
+    branches: [docs-v2]
+    paths:
+      - "v2/**"
+      - "snippets/**"
+      - "docs.json"
+  schedule:
+    - cron: "0 4 * * *"
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: "Mode"
+        type: choice
+        options: [pr, scheduled, manual, post-merge]
+        default: manual
+      dry_run:
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+concurrency:
+  group: dispatch-discoverability-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  pr-check:
+    if: github.event_name == 'pull_request'
+    name: Discoverability · PR Check
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: discoverability PR meta
+        env:
+          NODE_PATH: tools/node_modules
+        run: node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-check.js --staged
+
+  post-merge:
+    if: github.event_name == 'push'
+    name: Discoverability · Post-merge
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: discoverability post-merge meta
+        env:
+          NODE_PATH: tools/node_modules
+        run: node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-generate.js --write
+
+  scheduled:
+    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && inputs.mode == 'scheduled')
+    name: Discoverability · Scheduled
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: discoverability scheduled meta
+        env:
+          NODE_PATH: tools/node_modules
+        run: |
+          FLAGS=""
+          if [[ "${{ inputs.dry_run }}" == "false" ]]; then FLAGS="--write --verify"; fi
+          node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-generate.js $FLAGS
+
+  manual-repair:
+    if: github.event_name == 'workflow_dispatch' && inputs.mode == 'manual'
+    name: Discoverability · Manual Repair
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: cd tools && npm ci
+      - name: discoverability manual repair
+        env:
+          NODE_PATH: tools/node_modules
+        run: |
+          FLAGS=""
+          if [[ "${{ inputs.dry_run }}" == "false" ]]; then FLAGS="--write --verify"; fi
+          node operations/scripts/dispatch/content/discoverability/dispatch-discoverability-repair.js $FLAGS