feat(docs): add YAML frontmatter to all docs (title/version/lastUpdated)

Every .md under docs/{architecture,guides,reference,frameworks,routing,
security,compression,ops,diagrams} plus docs/README.md now opens with:

  ---
  title: "<inferred from first H1>"
  version: 3.8.0
  lastUpdated: 2026-05-13
  ---

46 files updated (no docs were skipped — none had pre-existing
frontmatter). [slug]/page.tsx already reads frontmatter.version and
frontmatter.lastUpdated via gray-matter and renders a "v3.8.0" pill
plus a "Last updated" caption, so the UI picks these up automatically.

Helper: scripts/docs/add-frontmatter.mjs — idempotent (skips files that
already start with `---`), falls back to a humanized basename when no
leading H1 exists. Excludes docs/i18n/, docs/screenshots/,
docs/superpowers/, docs/diagrams/exported/. Re-runnable safely.

Also regenerated src/app/docs/lib/docs-auto-generated.ts: 44 docs across
8 sections (Architecture / Guides / Reference / Frameworks / Routing /
Security / Compression / Ops), which now includes the 14 docs that were
missing from the v3.7 sidebar (Cloud Agents, Guardrails, Memory, Skills,
Webhooks, Evals, Authz, Agent Protocols, Repository Map, Provider
Reference, Reasoning Replay, Stealth Guide, Tunnels Guide, Electron
Guide).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

docs/frameworks/A2A-SERVER.md

@@ -1,3 +1,9 @@
+---
+title: "OmniRoute A2A Server Documentation"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # OmniRoute A2A Server Documentation
 
 > Agent-to-Agent Protocol v0.3 — OmniRoute as an intelligent routing agent

docs/frameworks/AGENT_PROTOCOLS_GUIDE.md

@@ -1,3 +1,9 @@
+---
+title: "Agent Protocols Guide"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # Agent Protocols Guide
 
 > **Source:** `src/lib/{a2a,acp,cloudAgent}/`, `src/app/api/{a2a,acp,cloud}/`, `src/app/api/v1/agents/`

docs/frameworks/CLOUD_AGENT.md

@@ -1,3 +1,9 @@
+---
+title: "Cloud Agents"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # Cloud Agents
 
 > **Source of truth:** `src/lib/cloudAgent/` and `src/app/api/v1/agents/tasks/`

docs/frameworks/EVALS.md

@@ -1,3 +1,9 @@
+---
+title: "Evaluations (Evals)"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # Evaluations (Evals)
 
 > **Source of truth:** `src/lib/evals/`, `src/lib/db/evals.ts`, `src/app/api/evals/`

docs/frameworks/MCP-SERVER.md

@@ -1,3 +1,9 @@
+---
+title: "OmniRoute MCP Server Documentation"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # OmniRoute MCP Server Documentation
 
 > Model Context Protocol server with 37 tools across routing, cache, compression, memory, skills, and proxy operations.

docs/frameworks/MEMORY.md

@@ -1,3 +1,9 @@
+---
+title: "Memory System"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # Memory System
 
 > **Source of truth:** `src/lib/memory/` and `src/app/api/memory/`

docs/frameworks/SKILLS.md

@@ -1,3 +1,9 @@
+---
+title: "Skills Framework"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # Skills Framework
 
 > **Source of truth:** `src/lib/skills/` and `src/app/api/skills/`

docs/frameworks/WEBHOOKS.md

@@ -1,3 +1,9 @@
+---
+title: "Webhooks"
+version: 3.8.0
+lastUpdated: 2026-05-13
+---
+
 # Webhooks
 
 > **Source of truth:** `src/lib/webhookDispatcher.ts`, `src/lib/db/webhooks.ts`, `src/app/api/webhooks/`