fix(workflows): correct pipeline classification and action version drift in two validators

.augment/GOVERNANCE.md

@@ -0,0 +1,8 @@
+# .augment/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [AI Tools Governance](../docs-guide/frameworks/ai-tools-governance.mdx)
+**Type:** IDE adapter (thin wrapper pointing at canonical governance)
+**Status:** Active
+
+Augment IDE adapter rules. Must remain a thin pointer to repo governance; no unique logic.

.augment/rules/repo-governance.md

@@ -6,14 +6,14 @@ type: always_apply
 
 Read `AGENTS.md` first for repo-wide rules.
 
-Use this file only for Augment-specific adapter behavior. Keep shared policy in:
+Use this file only for Augment-specific adapter behaviour. Keep shared policy in:
 
-- `AGENTS.md`
-- `docs-guide/policies/agent-governance-framework.mdx`
-- `docs-guide/policies/root-allowlist-governance.mdx`
-- `docs-guide/canonical/collation-data/Mintlify/mintlify-repo-best-practices.md`
-- Treat the Mintlify canonical reference above as the source of truth for preview behavior, MDX constraints, and repo authoring rules.
-- Do not use port `3000` for local Mintlify or preview sessions; choose a non-3000 port explicitly.
+- `AGENTS.md` — repo-wide agent baseline
+- `docs-guide/policies/governance-index.mdx` — all 10 governed surfaces
+- `docs-guide/frameworks/` — how to build (scripts, components, workflows)
+- `docs-guide/standards/` — how to write (voice, naming, frontmatter)
+- Every folder has a `GOVERNANCE.md` with links to its framework and validator
+- Do not use port `3000` for local Mintlify or preview sessions.
 
 ## Approved runtime targets
 

.claude/CLAUDE.md

@@ -41,6 +41,9 @@ Alison Haire (Wonderland). Documentation lead. Decision authority.
 | 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 |
 | Gateways Monitoring | Holistic `monitor.mdx` for `v2/gateways/setup/monitor/` with Docker/Linux/Windows tabs, Prometheus, Grafana, Explorer, alerts. Research + OS view files + parent page created | Active - page built, awaiting review | 2026-04-07 |
 | Gateways Connect | Holistic `connect.mdx` at `v2/gateways/setup/` with Docker/Linux/Windows tabs. Off-chain/on-chain connection, discovery verification, service publication, selection tuning. Research collated, 3 OS view files + parent page + nav registration | Active - page built, testing | 2026-04-07 |
+| Canonical Consolidation | 3-layer governance spine (published/enforcement/plans). 13 frameworks in docs-guide/frameworks/ with lastVerified. 5 standards in docs-guide/standards/. 18 GOVERNANCE.md markers. Generator + 3 validators + repair script + CI workflow. Decision index unified | Done | 2026-04-07 |
+| Zombie Prevention | 158 zombie processes killed (MCP servers, Puppeteer, stale sweeps). 3 redundancy layers: SessionStart cleanup expanded, SessionEnd hook added, UserPromptSubmit Chrome reaper. sweep-console-errors.js + mdx-render-verify.js hardened with signal handlers and timeouts. pre-tool-guard.js regex false positive fixed + Plan agent unblocked | Done | 2026-04-08 |
+| Docs Library | `docs-guide/docs-library/` — 8 pages: index, 6 pipeline concern pages (content quality, governance compliance, component health, discoverability, data integration, copy/brand) with real Mermaid diagrams, full script/workflow inventories, and gap analysis. Gap report: 17 gaps (2 P0, 5 P1, 6 P2, 4 P3) | Done | 2026-04-08 |
 
 **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.
 
@@ -238,14 +241,16 @@ If the sidebar is broken: run `full-repair.sh --dry-run` first, then without `--
 | `workspace/plan/active/CONTENT-WRITING/decisions/tab-status.md` | Per-tab gate status |
 | `workspace/plan/active/CONTENT-WRITING/decisions/blocking-items.md` | Items blocking phases |
 | `workspace/plan/active/CONTENT-WRITING/plan-canonical.md` | Full execution plan, phases, dependency graph |
-| `workspace/plan/active/CONTENT-WRITING/Prompts/voice-rules.md` | Voice rules for all 7 audiences |
-| `workspace/plan/active/CONTENTI-PIPLEINE/00-TRACKER.md` | Orchestrators pipeline tracker |
-| `v2/orchestrators/_workspace/canonical/Frameworks.mdx` | Full taxonomy/voice/content frameworks |
+| `docs-guide/standards/voice-and-copy.mdx` | Voice and copy standards (UK English, banned words, per-audience rules) |
+| `docs-guide/docs-library/index.mdx` | Docs library: pipeline diagrams, script inventories, gap analysis |
+| `workspace/reports/governance/gap-report.mdx` | Governance gap report (17 original, 11 resolved, 6 remaining) |
 | `docs.json` | Mintlify navigation and routing config |
 | `docs-guide/policies/governance-index.mdx` | Canonical governance index — all governed surfaces, what to read before writing |
-| `workspace/thread-outputs/research/component-script-placement-reference.md` | Component/script folder placement rules |
+| `docs-guide/frameworks/` | Published governance frameworks (13 files) — promoted from workspace/plan/ |
+| `docs-guide/standards/` | Published standards (voice, authoring, naming, frontmatter) |
+| `docs-guide/decisions/registry.md` | Unified decision registry — cross-references all 7+ decision logs |
 | `docs-guide/canonical/collation-data/Mintlify/mintlify-repo-best-practices.md` | Canonical Mintlify and repo best-practices reference |
-| `docs-guide/canonical/collation-data/Mintlify/dep-files/workspace/thread-outputs/research/mintlify-constraints-reference.md` | Supporting Mintlify constraints research snapshot |
+| `workspace/reports/repo-ops/GOVERNANCE_MAP_LATEST.json` | Generated governance map — run `generate-governance-map.js --write` |
 | `.claude/references/` | Exemplary work to emulate — read before designing, writing, or building |
 
 ---

.claude/GOVERNANCE.md

@@ -0,0 +1,18 @@
+# .claude/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [AI Tools Governance](../docs-guide/frameworks/ai-tools-governance.mdx)
+**Standards:** CLAUDE.md is the AI coworker contract. References, hooks, and memory are session infrastructure.
+**Status:** Active
+
+Claude Code adapter directory. Contains the project-level CLAUDE.md (AI coworker contract), references (exemplary work), hooks (session automation), plans, skills (symlinked), and persistent memory.
+
+## Structure
+
+| Subfolder | Purpose | Editable |
+|-----------|---------|----------|
+| `references/` | 13 categories of exemplary work to emulate | Hand-maintained |
+| `hooks/` | Session automation (pre/post tool use) | Governed by hook framework |
+| `plans/` | Session plan files (ephemeral) | Auto-managed |
+| `skills/` | Symlinks to `ai-tools/ai-skills/` | Auto-managed |
+| `memory/` | Persistent cross-session memory | Auto-managed |

.claude/settings.json

@@ -26,7 +26,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "pkill -f 'Chromium.*--headless' 2>/dev/null; pkill -f 'chrome.*--headless' 2>/dev/null; pkill -f 'playwright.*BrowserServer' 2>/dev/null; pkill -f 'mintlify.*dev.*--port' 2>/dev/null; pkill -f '@mintlify/cli.*start.*dev' 2>/dev/null; echo '{\"systemMessage\":\"Cleaned up stale headless browsers and Mintlify dev servers.\"}'",
+            "command": "pkill -f 'Chromium.*--headless' 2>/dev/null; pkill -f 'chrome.*--headless' 2>/dev/null; pkill -f 'chrome.*Testing.*puppeteer' 2>/dev/null; pkill -f 'playwright.*BrowserServer' 2>/dev/null; pkill -f 'mintlify.*dev.*--port 3145' 2>/dev/null; pkill -f '@mintlify/cli.*start.*dev.*3145' 2>/dev/null; pkill -f 'claude-session-continuity-mcp' 2>/dev/null; pkill -f 'thedotmack.*mcp-server' 2>/dev/null; echo '{\"systemMessage\":\"Cleaned up stale browsers, agent dev servers (port 3145 only), and MCP zombies.\"}'",
             "statusMessage": "Cleaning up stale processes..."
           }
         ]
@@ -68,6 +68,15 @@
       }
     ],
     "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "ORPHAN_CHROME=$(pgrep -f 'chrome.*Testing.*puppeteer_dev_chrome' 2>/dev/null | wc -l | tr -d ' '); if [ \"$ORPHAN_CHROME\" -gt 15 ]; then pkill -f 'chrome.*Testing.*puppeteer_dev_chrome' 2>/dev/null && echo '{\"systemMessage\":\"WARNING: Killed '\"$ORPHAN_CHROME\"' orphan Puppeteer Chrome processes.\"}'; else echo '{\"systemMessage\":\"\"}'; fi",
+            "statusMessage": "Checking for orphan processes..."
+          }
+        ]
+      },
       {
         "hooks": [
           {
@@ -169,6 +178,16 @@
           }
         ]
       },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node operations/scripts/dispatch/governance/mdx-frontmatter-sanitise.js",
+            "statusMessage": "Checking frontmatter integrity..."
+          }
+        ]
+      },
       {
         "matcher": "Edit|Write",
         "hooks": [
@@ -261,6 +280,17 @@
           }
         ]
       }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "pkill -f 'chrome.*Testing.*puppeteer' 2>/dev/null; pkill -f 'chrome.*--headless' 2>/dev/null; SWEEP_PIDS=$(pgrep -f 'sweep-console-errors' 2>/dev/null); [ -n \"$SWEEP_PIDS\" ] && kill $SWEEP_PIDS 2>/dev/null; echo '{\"systemMessage\":\"Session cleanup complete.\"}'",
+            "statusMessage": "Cleaning up session processes..."
+          }
+        ]
+      }
     ]
   }
 }

.codex/GOVERNANCE.md

@@ -0,0 +1,8 @@
+# .codex/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [AI Tools Governance](../docs-guide/frameworks/ai-tools-governance.mdx)
+**Type:** IDE adapter (thin wrapper pointing at canonical governance)
+**Status:** Active
+
+Codex IDE adapter rules. Must remain a thin pointer to repo governance; no unique logic.

.codex/README.md

@@ -29,7 +29,7 @@ Each lock is a JSON file with this shape:
 ## Lifecycle
 
 1. Create branch + contract + lock:
-   - `node operations/scripts/automations/ai/codex/task-preflight.js --task <id> --slug <slug> --scope <a,b,c>`
+   - `node operations/scripts/integrators/ai/codex/task-preflight.js --task <id> --slug <slug> --scope <a,b,c>`
    - Default behavior provisions a managed worktree at `../codex-worktrees/<task-id>-<slug>`.
    - Use `--in-place` only when the task must reuse the current worktree.
 2. Validate lock before commit/push:
@@ -39,6 +39,6 @@ Each lock is a JSON file with this shape:
 4. Commit or merge the task commit onto `docs-v2-dev`.
    - A codex branch commit is not task completion by itself.
 5. Release lock only after `docs-v2-dev` contains the task commit:
-   - `node operations/scripts/automations/ai/codex/lock-release.js --branch codex/<id>-<slug>`
+   - `node operations/scripts/integrators/ai/codex/lock-release.js --branch codex/<id>-<slug>`
 6. Cleanup merged local worktrees and stale local codex branches only after `docs-v2-dev` contains the task commit:
-   - `node operations/scripts/automations/ai/codex/task-cleanup.js --branch codex/<id>-<slug> --apply`
+   - `node operations/scripts/integrators/ai/codex/task-cleanup.js --branch codex/<id>-<slug> --apply`

.cursor/GOVERNANCE.md

@@ -0,0 +1,8 @@
+# .cursor/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [AI Tools Governance](../docs-guide/frameworks/ai-tools-governance.mdx)
+**Type:** IDE adapter (thin wrapper pointing at canonical governance)
+**Status:** Active
+
+Cursor IDE adapter rules. Must remain a thin pointer to repo governance; no unique logic.

.cursor/rules/repo-governance.mdc

@@ -7,11 +7,12 @@ description: Repo governance adapter for Livepeer Docs
 
 Read `AGENTS.md` first for repo-wide rules.
 
-Use this file only for Cursor-specific adapter behavior. Keep shared policy in:
+Use this file only for Cursor-specific adapter behaviour. Keep shared policy in:
 
-- `AGENTS.md`
-- `docs-guide/policies/agent-governance-framework.mdx`
-- `docs-guide/policies/root-allowlist-governance.mdx`
-- `docs-guide/canonical/collation-data/Mintlify/mintlify-repo-best-practices.md`
-- Treat the Mintlify canonical reference above as the source of truth for preview behavior, MDX constraints, and repo authoring rules.
+- `AGENTS.md` — repo-wide agent baseline
+- `docs-guide/policies/governance-index.mdx` — all 10 governed surfaces
+- `docs-guide/frameworks/` — how to build (scripts, components, workflows)
+- `docs-guide/standards/` — how to write (voice, naming, frontmatter)
+- `docs-guide/canonical/collation-data/Mintlify/mintlify-repo-best-practices.md` — Mintlify constraints
+- Every folder has a `GOVERNANCE.md` with links to its framework and validator
 - Do not use port `3000` for direct Mintlify preview runs or port `3333` via `lpd dev`; those ports are reserved for human-owned local servers.

.githooks/GOVERNANCE.md

@@ -0,0 +1,21 @@
+# .githooks/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [Script Framework](../docs-guide/frameworks/script-framework.mdx) (for JS hooks) | Shell conventions (for bash hooks)
+**Standards:** JS hooks follow 11-tag JSDoc. Bash hooks follow the patterns in `verify.sh`.
+**Status:** Active
+
+Local git hooks for pre-commit validation, pre-push checks, and browser verification. Installed via `.githooks/install.sh`.
+
+## Files
+
+| File | Type | Purpose |
+|------|------|---------|
+| `pre-commit` | Bash | Runs staged file validators before commit |
+| `pre-push` | Bash | Runs push-time checks |
+| `verify.sh` | Bash | Core verification logic |
+| `verify-browser.js` | JS (JSDoc) | Browser-based render verification |
+| `server-manager.js` | JS (JSDoc) | Mintlify dev server lifecycle (library, not CLI) |
+| `install.sh` | Bash | Hook installer |
+| `README.md` | Docs | Usage documentation |
+| `BYPASS.md` | Docs | Hook bypass instructions |

.githooks/install.sh

@@ -9,7 +9,6 @@
 # @pipeline    manual — developer tool
 # @scope       .githooks
 # @usage       bash .githooks/install.sh [flags]
-# @policy      E-C6, F-C1
 # Install git hooks
 
 set -euo pipefail

.githooks/pre-commit

@@ -138,7 +138,7 @@ enforce_docs_v2_codex_isolation() {
     echo "  git switch -c codex/<issue-id>-<slug>"
     echo ""
     echo -e "${YELLOW}Then initialize contract + lock:${NC}"
-    echo "  node operations/scripts/automations/ai/codex/task-preflight.js --task <issue-id> --slug <slug> --scope \"<path1,path2>\""
+    echo "  node operations/scripts/integrators/ai/codex/task-preflight.js --task <issue-id> --slug <slug> --scope \"<path1,path2>\""
     echo ""
     echo -e "${YELLOW}Human override (explicit chat instruction required):${NC}"
     echo "  ALLOW_MAIN_COMMIT=1 git commit -m \"...\" --trailer \"allow-main-commit=true\""

.githooks/server-manager.js

@@ -10,7 +10,6 @@
  * @pipeline    manual — legacy browser-validation module imported by .githooks/verify-browser.js
  * @scope       .githooks
  * @usage       node .githooks/server-manager.js [flags]
- * @policy      E-C6, F-C1
  */
 /**
  * Server management utility for browser tests

.githooks/verify-browser.js

@@ -10,7 +10,6 @@
  * @pipeline    manual — developer tool
  * @scope       .githooks
  * @usage       node .githooks/verify-browser.js [flags]
- * @policy      E-C6, F-C1
  */
 /**
  * Headless browser validation for staged MDX files

.githooks/verify.sh

@@ -9,7 +9,6 @@
 # @pipeline    manual — developer tool
 # @scope       .githooks
 # @usage       bash .githooks/verify.sh [flags]
-# @policy      E-C6, F-C1
 # Verification script for pre-commit hook
 # Runs various validation checks on staged files
 

.github/GOVERNANCE.md

@@ -0,0 +1,9 @@
+# .github/ Governance
+
+**Owner:** @livepeer/docs-team
+**Framework:** [GitHub Actions Framework](../docs-guide/frameworks/github-actions.mdx)
+**Standards:** Workflow naming: `type-concern-verb-name.yml`
+**Decisions:** [.github/workspace/decisions-log.mdx](workspace/decisions-log.mdx)
+**Status:** Active — 8 locked decisions (D-ACT-01 through D-ACT-08)
+
+CI/CD workflows, issue/PR templates, and Copilot instructions. Workflows follow the 7-type taxonomy with pipeline tags (P2-P6).