Integrating v2 docs to repo

.AI-SAFEGUARDS.md

@@ -0,0 +1,56 @@
+# AI Safeguards Configuration
+
+## Protected Branches
+
+These branches CANNOT be modified by AI:
+
+- docs-v2 (source of truth)
+- main
+
+## Allowed Branches for AI
+
+- docs-v2-dev (development branch for hourly commits)
+- fix-\* (feature branches)
+- safepoint/\* (checkpoint branches)
+
+## Forbidden Commands for AI
+
+❌ NEVER execute:
+
+- git reset --hard
+- git restore .
+- git clean -fd
+- git push --force
+- git rebase -i (interactive rebase)
+- git tag --force
+- Any mass git operations without human approval
+
+## Large Change Protocol (>10 files)
+
+1. AI must show file list and get approval
+2. Human creates .ai-commit-verified file
+3. Only then can AI proceed with commit
+4. File is deleted after commit
+
+## Audit Trail
+
+All AI git operations logged to: .ai-operations.log
+
+## Emergency Rollback
+
+If AI makes dangerous changes:
+
+```bash
+git reflog
+git reset --hard <safe-commit>
+```
+
+## Human Commit Override
+
+If AI blocks legitimate commits, use:
+
+```bash
+git commit --no-verify
+```
+
+Updated: 2026-01-06 after safeguard implementation

.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"

.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 `v2/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 `v2/scripts/generate-api-docs.sh` to convert OpenAPI specs to MDX/API
+    docs and navigation JSON. Example:
+    ```bash
+    ./v2/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 `v2/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
+- `v2/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 "[email protected]"
+          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: {}

.verify-large-change.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# AI Large Change Verification Script
+# Used when AI needs to commit more than 10 files
+
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+FILES_COUNT=$(git diff --cached --name-only | wc -l)
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+
+echo ""
+echo "════════════════════════════════════════════════════════════"
+echo "⚠️  LARGE CHANGE VERIFICATION REQUIRED"
+echo "════════════════════════════════════════════════════════════"
+echo ""
+echo "Branch: $BRANCH"
+echo "Files to be modified: $FILES_COUNT"
+echo "Timestamp: $TIMESTAMP"
+echo ""
+echo "Files list:"
+git diff --cached --name-only | sort
+echo ""
+echo "════════════════════════════════════════════════════════════"
+echo ""
+echo "HUMAN ACTION REQUIRED:"
+echo ""
+echo "1. Review the files above carefully"
+echo "2. If safe, create verification file:"
+echo "   touch .ai-commit-verified"
+echo "3. AI will then proceed with commit"
+echo ""
+echo "════════════════════════════════════════════════════════════"
+echo ""