chore(docs): replace inline styles with semantic classes

.ai-audit.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# AI Operations Audit Log
+# Logs every git operation attempted by the AI assistant
+
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+COMMAND="$*"
+FILES_CHANGED=$(git status --porcelain 2>/dev/null | wc -l)
+
+LOG_ENTRY="[$TIMESTAMP] BRANCH=$BRANCH | COMMAND=$COMMAND | FILES_STAGED=$FILES_CHANGED"
+
+# Write to audit log
+echo "$LOG_ENTRY" >> .ai-operations.log
+
+# Also print for visibility
+echo "$LOG_ENTRY"

.augment-guidelines

@@ -0,0 +1,17 @@
+# Standard Operating Procedure for Scripts
+
+<!-- ## 1. Documentation & Testing Requirements
+- Whenever creating or modifying a script, you MUST:
+  - Generate documentation in the `/docs` folder (x folder).
+  - Generate comprehensive tests in the `/tests` folder (y folder).
+  - Use the naming convention `[script_name].test.js` (or applicable extension). -->
+
+## 1. Safety & Verification Workflow
+
+- Before applying changes to existing files, you MUST:
+  1. Create a "checkpoint" backup using the internal checkpoint tool.
+  2. Create a new git branch named `agent/[feature-name]`.
+  3. Verify the script's logic by applying it to a temporary copy of the target
+     file first.
+  4. Only after verification and user approval, apply the changes to the project
+     files in the new branch.

.augment/rules/git-safety.md

@@ -0,0 +1,5 @@
+# GIT WRITE PROTOCOL
+- **ENFORCEMENT:** You MUST verify the existence of local Git hooks in `.git/hooks/` before initiating any write command (commit, push, rebase).
+- **FORBIDDEN:** You are STRICTLY FORBIDDEN from using `--no-verify` or `-n`.
+- **BEHAVIOR:** When a write command is initiated, you MUST announce: "Initiating [action]. Please approve the safety checkpoint in your terminal."
+- **RECOVERY:** If a command fails, suggest restoring from the latest `checkpoint/` branch.

.github/AGENTS.md

@@ -0,0 +1,39 @@
+# 🤖 PROJECT AGENT RULES & SAFETY PROTOCOLS
+
+## 🛠️ CRITICAL BOUNDARIES (READ FIRST)
+
+- **ALWAYS** check for the existence of local Git hooks in `.git/hooks/` before
+  initiating a write command.
+- **NEVER** use `--no-verify` or `-n` flags to bypass safety checks. These are
+  hard project constraints.
+- **NEVER** perform a `git reset --hard` or `git push --force` without an
+  explicit, multi-turn plan confirmed by the user.
+- **NEVER** perform a `git reset --hard` or `git push --force` without a saved
+  branch to revert to in case of failure.
+
+## 📦 GIT WORKFLOW & CHECKPOINTS
+
+This project enforces a "Human-in-the-Loop" (HitL) verification for all
+destructive or history-altering actions.
+
+- **Automatic Checkpoints:** Every `commit`, `push`, and `rebase` triggers a
+  safety hook that creates a branch named `checkpoint/YYYY-MM-DD_HHMMSS`.
+- **Pre-Write Announcement:** Before executing a write command, you MUST state:
+  _"I am initiating [COMMAND]. A safety checkpoint will be created. Please
+  switch to your terminal to type 'yes' when prompted."_
+- **Recovery:** If a command fails, the latest pre-failure state is stored in
+  the most recent `checkpoint/` branch.
+
+## 🧪 VALIDATION COMMANDS
+
+Before asking for a commit, you should ideally run these to ensure code quality:
+
+```bash
+# Verify build
+mint dev
+```
+
+# Run local test suite
+
+Make a test for mintlify in the v2/tests file. DO NOT EVER run a script without
+testing it on a local branch first.

.github/CODEOWNERS

@@ -1,3 +1,4 @@
 # Default reviewers for the AI documentation.
 ai/ @rickstaa
 * @livepeer/studio-team
+* @DeveloperAlly

.github/copilot-instructions.md

@@ -0,0 +1,91 @@
+docs. The docs are built and previewed using Mintlify CLI, and can be
+containerized with Docker.
+
+# Copilot Instructions for Livepeer Docs (2026)
+
+## Big Picture & Architecture
+
+- **Multi-version Docs:**
+  - `v1/` = legacy, `v2/` = current. Navigation in `docs.json`/`docs_v2.json`.
+- **Component System:**
+  - Custom React/TSX/JSX components in `snippets/components/` (see
+    README-custom-view.md for advanced usage).
+  - Use `.tsx` for new components; `.jsx` is legacy but supported.
+- **Automations & Scripts:**
+  - All dynamic, AI, and data-fetching logic in `automations/` and `ai-tools/`.
+  - Scripts for API doc generation and external data in `snippets/scripts/` (see
+    generate-api-docs.sh, fetch-openapi-specs.sh).
+- **API Reference:**
+  - OpenAPI spec in `openapi.yaml` (AI API: see ai/worker/api/openapi.yaml). Use
+    scripts to generate MDX/API docs.
+- **Assets:**
+  - Images/logos in `images/`, `logo/`, and static assets in `assets/`.
+
+## Developer Workflows
+
+- **Preview Locally:**
+  1. Install Mintlify CLI: `npm i -g mintlify`
+  2. Run: `mint dev` (from repo root, where `mint.json` or `mint_v1.json`
+     exists)
+- **Build/Deploy:**
+  - Docker:
+    `docker buildx build --platform linux/amd64 --load -t livepeer/docs .`
+  - Makefile: `make all`
+- **API Docs Generation:**
+  - Use `snippets/scripts/generate-api-docs.sh` to convert OpenAPI specs to
+    MDX/API docs and navigation JSON. Example:
+    ```bash
+    ./snippets/scripts/generate-api-docs.sh ai/worker/api/openapi.yaml v2/pages/04_gateways/guides-references/api-reference/AI-API "AI API"
+    ```
+  - Output: MDX files + navigation snippet for `docs.json`.
+- **External Data Fetching:**
+  - Use `fetch-openapi-specs.sh` and `fetch-external-docs.sh` for syncing
+    specs/docs from other repos.
+- **Component Usage:**
+  - Import with relative paths from `snippets/components/` in `.mdx` files.
+  - For custom dropdowns, see `CustomViewDropdown` in
+    `snippets/components/custom-view-dropdown.jsx` and its README.
+
+## Project Conventions & Patterns
+
+- **MDX-First:** All docs are `.mdx` (Markdown + JSX/TSX components).
+- **Versioning:** New docs in `v2/`, legacy in `v1/` or
+  `deprecated-references/`.
+- **AI/Dynamic Content:** All AI-generated or dynamic content in `automations/`
+  or `ai-tools/`.
+- **SEO & Metadata:** Add SEO tags/metadata in page frontmatter (see
+  `README_V2.md`).
+- **No Formal Test Suite:** Preview changes locally before merging.
+- **Architecture:**
+  - Docs mirror protocol architecture: Gateway, Orchestrator, Transcoder, AI
+    Worker. See `README_V2.md` for detailed flows and node roles.
+  - Gateways do not process video; they route jobs to orchestrators. Node roles
+    are mutually exclusive (see `README_V2.md`).
+- **Custom Views:**
+  - Use `CustomViewDropdown` for Mintlify-style view switching. See
+    `snippets/components/README-custom-view.md` for migration and usage.
+
+## Integration Points
+
+- **Mintlify:** All build/preview flows use Mintlify CLI and config files
+  (`mint.json`, `docs.json`).
+- **OpenAPI:** API docs generated from `openapi.yaml` (see also
+  `ai/worker/api/openapi.yaml`).
+- **Docker:** Containerized builds for CI/CD and local dev.
+- **Automations:** Scripts in `snippets/scripts/` automate API doc generation
+  and external data sync.
+
+## Key Files & Directories
+
+- `docs.json`, `docs_v2.json` — Navigation/config
+- `snippets/components/` — Custom components (see README-custom-view.md)
+- `automations/`, `ai-tools/` — Scripts, AI, dynamic content
+- `openapi.yaml`, `ai/worker/api/openapi.yaml` — API reference
+- `Dockerfile`, `Makefile` — Build/deploy
+- `README.md`, `README_V2.md` — Developer notes, protocol/architecture
+- `snippets/scripts/` — Automation scripts (API docs, data fetching)
+
+---
+
+If any conventions or workflows are unclear, review the latest `README.md`,
+`README_V2.md`, or automation READMEs, or ask for clarification.

.github/workflows/broken-links.yml

@@ -16,8 +16,8 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
-        
+          node-version: "22"
+
       - name: Install Mintlify globally
         run: npm install -g mintlify
 

.github/workflows/update-livepeer-release.yml

@@ -0,0 +1,60 @@
+name: Update Livepeer Release Version
+
+on:
+  schedule:
+    # Run every 30 minutes
+    - cron: "*/30 * * * *"
+  workflow_dispatch:
+
+jobs:
+  check-and-update:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout docs repository
+        uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get latest go-livepeer release
+        id: get_release
+        run: |
+          LATEST_RELEASE=$(curl -s https://api.github.com/repos/livepeer/go-livepeer/releases/latest | jq -r .tag_name)
+          echo "release=${LATEST_RELEASE}" >> $GITHUB_OUTPUT
+          echo "Latest release: ${LATEST_RELEASE}"
+
+      - name: Read current version from globals.mdx
+        id: current_version
+        run: |
+          CURRENT=$(grep -oP 'latestVersion\s*=\s*["'"'"']?\K[^"'"'"']+' snippets/automationData/globals/globals.mdx || echo "")
+          echo "current=${CURRENT}" >> $GITHUB_OUTPUT
+          echo "Current version: ${CURRENT}"
+
+      - name: Update globals.mdx if needed
+        if:
+          steps.get_release.outputs.release !=
+          steps.current_version.outputs.current
+        run: |
+          # Create backup
+          cp snippets/automationData/globals/globals.mdx snippets/automationData/globals/globals.mdx.bak
+
+          # Update the latestVersion value
+          sed -i "s/latestVersion[[:space:]]*=[[:space:]]*[\"'][^\"']*[\"']/latestVersion = \"${{ steps.get_release.outputs.release }}\"/" snippets/automationData/globals/globals.mdx
+
+          # Update the latestVersionUrl value
+          sed -i "s|latestVersionUrl[[:space:]]*=[[:space:]]*[\"'][^\"']*[\"']|latestVersionUrl = \"https://github.com/livepeer/go-livepeer/releases/download/${{ steps.get_release.outputs.release }}\"|" snippets/automationData/globals/globals.mdx
+
+          # Verify the changes
+          echo "Updated content:"
+          grep "latestVersion" snippets/automationData/globals/globals.mdx
+
+      - name: Commit and push if changed
+        if:
+          steps.get_release.outputs.release !=
+          steps.current_version.outputs.current
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add snippets/automationData/globals/globals.mdx
+          git commit -m "chore: update latest release to ${{ steps.get_release.outputs.release }}"
+          git push

.gitignore

@@ -4,3 +4,67 @@ node_modules
 # IDE
 .vscode
 *.code-workspace
+
+# V2
+# ------------------------------------
+# Node
+# ------------------------------------
+# node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Optional: ignore local `.env` files
+.env
+.env.*local
+
+# ------------------------------------
+# Logs
+# ------------------------------------
+logs/
+*.log
+*.log.*
+debug.log
+
+# ------------------------------------
+# OS / Editor files
+# ------------------------------------
+# .DS_Store
+Thumbs.db
+.idea/
+
+# VSCode — allow settings.json, ignore rest
+# .vscode/*
+# !.vscode/settings.json
+# !.vscode/extensions.json
+
+# ------------------------------------
+# Mintlify / Build Stuff
+# ------------------------------------
+.mintlify/
+.mintlify-cache/
+.out/
+dist/
+build/
+
+# ------------------------------------
+# Temporary files
+# ------------------------------------
+*.tmp
+*.temp
+*.swp
+*.swo
+
+# ------------------------------------
+# TypeScript
+# ------------------------------------
+*.tsbuildinfo
+
+# ------------------------------------
+# External docs (fetched at build time)
+# ------------------------------------
+snippets/external/

.speakeasy/workflow.yaml

@@ -1,25 +1,25 @@
 workflowVersion: 1.0.0
 speakeasyVersion: latest
 sources:
-    livepeer-ai-api:
-        inputs:
-            - location: https://raw.githubusercontent.com/livepeer/ai-worker/main/runner/gateway.openapi.yaml
-        overlays:
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-js/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-go/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-python/main/codeSamples.yaml
-        output: ai/api-reference/gateway.openapi.yaml
-        registry:
-            location: registry.speakeasyapi.dev/livepeer/livepeer-ai/livepeer-ai-oas
-    livepeer-studio-api:
-        inputs:
-            - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/api-schema.yaml
-            - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/ai-api-schema.yaml
-        overlays:
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-js/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-go/main/codeSamples.yaml
-            - location: https://raw.githubusercontent.com/livepeer/livepeer-python/main/codeSamples.yaml
-        output: openapi.yaml
-        registry:
-            location: registry.speakeasyapi.dev/livepeer/livepeer-studio/livepeer-studio-api
+  livepeer-ai-api:
+    inputs:
+      - location: https://raw.githubusercontent.com/livepeer/ai-worker/main/runner/gateway.openapi.yaml
+    overlays:
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-js/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-go/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-ai-python/main/codeSamples.yaml
+    output: ai/api-reference/gateway.openapi.yaml
+    registry:
+      location: registry.speakeasyapi.dev/livepeer/livepeer-ai/livepeer-ai-oas
+  livepeer-studio-api:
+    inputs:
+      - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/api-schema.yaml
+      - location: https://raw.githubusercontent.com/livepeer/studio/master/packages/api/src/schema/ai-api-schema.yaml
+    overlays:
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-js/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-go/main/codeSamples.yaml
+      - location: https://raw.githubusercontent.com/livepeer/livepeer-python/main/codeSamples.yaml
+    output: openapi.yaml
+    registry:
+      location: registry.speakeasyapi.dev/livepeer/livepeer-studio/livepeer-studio-api
 targets: {}