Docs v2 Preview [Public Link]

.augment/.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/copilot-instructions.md

@@ -13,7 +13,7 @@ containerized with Docker.
   - 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
+  - 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
@@ -32,10 +32,10 @@ containerized with 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:
+  - Use `snippets/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"
+    ./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:**
@@ -72,8 +72,8 @@ containerized with Docker.
 - **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.
+- **Automations:** Scripts in `snippets/scripts/` automate API doc generation
+  and external data sync.
 
 ## Key Files & Directories
 
@@ -83,7 +83,7 @@ containerized with Docker.
 - `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)
+- `snippets/scripts/` — Automation scripts (API docs, data fetching)
 
 ---
 

.github/scripts/fetch-forum-data.js

@@ -0,0 +1,198 @@
+const https = require("https");
+const fs = require("fs");
+
+// Fetch JSON from URL
+function fetchJSON(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (res) => {
+        let data = "";
+        res.on("data", (chunk) => {
+          data += chunk;
+        });
+        res.on("end", () => {
+          try {
+            resolve(JSON.parse(data));
+          } catch (e) {
+            reject(e);
+          }
+        });
+      })
+      .on("error", reject);
+  });
+}
+
+// Check if topic is old pinned
+function isOldPinned(topic) {
+  const pinned = topic.pinned === true || topic.pinned_globally === true;
+  if (!pinned) return false;
+  const created = new Date(topic.created_at);
+  const now = new Date();
+  const ageDays = (now - created) / (1000 * 60 * 60 * 24);
+  return ageDays > 30;
+}
+
+// Clean and format HTML
+function cleanAndFormatHTML(html) {
+  let cleanHTML = html;
+
+  // Remove anchor navigation links
+  cleanHTML = cleanHTML.replace(
+    /<a[^>]*name="[^"]*"[^>]*class="anchor"[^>]*>.*?<\/a>/g,
+    ""
+  );
+
+  // Clean up headings
+  cleanHTML = cleanHTML.replace(/<h1[^>]*>(.*?)<\/h1>/g, "<h3>$1</h3>");
+  cleanHTML = cleanHTML.replace(/<h2[^>]*>(.*?)<\/h2>/g, "<h4>$1</h4>");
+  cleanHTML = cleanHTML.replace(/<h3[^>]*>(.*?)<\/h3>/g, "<h5>$1</h5>");
+  cleanHTML = cleanHTML.replace(/<h[4-6][^>]*>(.*?)<\/h[4-6]>/g, "<h6>$1</h6>");
+
+  // Clean up images and their references
+  cleanHTML = cleanHTML.replace(/<a[^>]*class="lightbox"[^>]*>.*?<\/a>/g, "");
+  cleanHTML = cleanHTML.replace(
+    /<div[^>]*class="lightbox-wrapper"[^>]*>.*?<\/div>/g,
+    ""
+  );
+  cleanHTML = cleanHTML.replace(/<img[^>]*>/g, "");
+  cleanHTML = cleanHTML.replace(/\[!\[.*?\]\(.*?\)\]\(.*?\)/g, "");
+  cleanHTML = cleanHTML.replace(/image\d+×\d+\s+[\d.]+\s*[KM]B/gi, "");
+
+  // Keep paragraphs, lists, emphasis, code
+  cleanHTML = cleanHTML.replace(/<p>/g, "<p>");
+  cleanHTML = cleanHTML.replace(/<\/p>/g, "</p>");
+  cleanHTML = cleanHTML.replace(/<ul>/g, "<ul>");
+  cleanHTML = cleanHTML.replace(/<\/ul>/g, "</ul>");
+  cleanHTML = cleanHTML.replace(/<ol>/g, "<ol>");
+  cleanHTML = cleanHTML.replace(/<\/ol>/g, "</ol>");
+  cleanHTML = cleanHTML.replace(/<li>/g, "<li>");
+  cleanHTML = cleanHTML.replace(/<\/li>/g, "</li>");
+  cleanHTML = cleanHTML.replace(
+    /<strong>(.*?)<\/strong>/g,
+    "<strong>$1</strong>"
+  );
+  cleanHTML = cleanHTML.replace(/<em>(.*?)<\/em>/g, "<em>$1</em>");
+  cleanHTML = cleanHTML.replace(/<code>(.*?)<\/code>/g, "<code>$1</code>");
+
+  // Simplify links
+  cleanHTML = cleanHTML.replace(
+    /<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/g,
+    '<a href="$1" target="_blank">$2</a>'
+  );
+
+  // Decode HTML entities
+  cleanHTML = cleanHTML.replace(/&amp;/g, "&");
+  cleanHTML = cleanHTML.replace(/&lt;/g, "<");
+  cleanHTML = cleanHTML.replace(/&gt;/g, ">");
+  cleanHTML = cleanHTML.replace(/&quot;/g, '"');
+  cleanHTML = cleanHTML.replace(/&#39;/g, "'");
+  cleanHTML = cleanHTML.replace(/&nbsp;/g, " ");
+
+  // Clean up whitespace
+  cleanHTML = cleanHTML.replace(/\s+/g, " ");
+  cleanHTML = cleanHTML.replace(/<p>\s*<\/p>/g, "");
+
+  return cleanHTML.trim();
+}
+
+async function main() {
+  console.log("Fetching latest topics...");
+  const latestData = await fetchJSON("https://forum.livepeer.org/latest.json");
+
+  const topics = latestData.topic_list?.topics || [];
+  console.log(`Found ${topics.length} topics`);
+
+  // Filter out old pinned topics
+  const filteredTopics = topics.filter((t) => !isOldPinned(t));
+  console.log(`After filtering: ${filteredTopics.length} topics`);
+
+  // Get top 4
+  const top4 = filteredTopics.slice(0, 4);
+  console.log(`Processing top 4 topics...`);
+
+  const processedTopics = [];
+
+  for (const topic of top4) {
+    console.log(`Processing topic ${topic.id}: ${topic.title}`);
+
+    // Fetch full topic data
+    const topicData = await fetchJSON(
+      `https://forum.livepeer.org/t/${topic.id}.json`
+    );
+
+    // Extract first post
+    const firstPost = topicData.post_stream?.posts?.find(
+      (p) => p.post_number === 1
+    );
+
+    if (!firstPost) {
+      console.log(`  No first post found, skipping`);
+      continue;
+    }
+
+    const htmlContent = cleanAndFormatHTML(firstPost.cooked || "");
+    const datePosted = topic.created_at
+      ? new Date(topic.created_at).toLocaleDateString("en-US", {
+          year: "numeric",
+          month: "short",
+          day: "numeric",
+        })
+      : "";
+
+    processedTopics.push({
+      title: topic.title,
+      href: `https://forum.livepeer.org/t/${topic.id}`,
+      author: `By ${firstPost.name || firstPost.username || "Unknown"} (@${
+        firstPost.username || "unknown"
+      })`,
+      content: htmlContent,
+      replyCount: (topic.posts_count || 1) - 1,
+      datePosted: datePosted,
+    });
+  }
+
+  console.log(`Processed ${processedTopics.length} topics`);
+
+  // Generate JavaScript export with exact formatting
+  let jsExport = "export const forumData = [\n";
+
+  processedTopics.forEach((item, index) => {
+    jsExport += "  {\n";
+    jsExport += `    title: "${item.title
+      .replace(/\\/g, "\\\\")
+      .replace(/"/g, '\\"')}",\n`;
+    jsExport += `    href: "${item.href}",\n`;
+    jsExport += `    author: "${item.author
+      .replace(/\\/g, "\\\\")
+      .replace(/"/g, '\\"')}",\n`;
+
+    // Content with proper escaping and indentation
+    const escapedContent = item.content
+      .replace(/\\/g, "\\\\")
+      .replace(/"/g, '\\"')
+      .replace(/\n/g, " ");
+
+    jsExport += `    content:\n      "${escapedContent}",\n`;
+    jsExport += `    replyCount: ${item.replyCount},\n`;
+    jsExport += `    datePosted: "${item.datePosted}",\n`;
+    jsExport += "  }";
+
+    if (index < processedTopics.length - 1) {
+      jsExport += ",";
+    }
+    jsExport += "\n";
+  });
+
+  jsExport += "];\n";
+
+  // Write to file
+  const outputPath = "snippets/automations/forum/forumData.jsx";
+  fs.mkdirSync("snippets/automations/forum", { recursive: true });
+  fs.writeFileSync(outputPath, jsExport);
+  console.log(`Written to ${outputPath}`);
+}
+
+main().catch((err) => {
+  console.error("Error:", err);
+  process.exit(1);
+});