Merge FASE 3: docs restructure into 8 subfolders

Reorganizes /docs into 8 subfolders (architecture, guides, reference, frameworks,
routing, security, compression, ops). Resolves two conflicts:

- scripts/docs/gen-provider-reference.ts: combined FASE 1's new __dirname-based
  ROOT (two levels up from scripts/docs/) with FASE 3's new output path
  (docs/reference/PROVIDER_REFERENCE.md).
- scripts/check-env-doc-sync.mjs: deleted by FASE 1, modified by FASE 3; FASE 1's
  delete wins (file is at scripts/check/ now). The FASE 3 intent (point to
  docs/reference/ENVIRONMENT.md) was applied to the strict checker at the new path.

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

scripts/check/check-docs-counts-sync.mjs

@@ -59,31 +59,31 @@ const checks = [
     label: "Executors count",
     actual: countFiles("open-sse/executors"),
     docKey: "executors",
-    docs: ["ARCHITECTURE.md", "CODEBASE_DOCUMENTATION.md"],
+    docs: ["architecture/ARCHITECTURE.md", "architecture/CODEBASE_DOCUMENTATION.md"],
   },
   {
     label: "Routing strategies count",
     actual: countRoutingStrategies(),
     docKey: "strategies",
-    docs: ["AUTO-COMBO.md", "RESILIENCE_GUIDE.md"],
+    docs: ["routing/AUTO-COMBO.md", "architecture/RESILIENCE_GUIDE.md"],
   },
   {
     label: "OAuth providers count",
     actual: countFiles("src/lib/oauth/providers"),
     docKey: "OAuth providers",
-    docs: ["ARCHITECTURE.md"],
+    docs: ["architecture/ARCHITECTURE.md"],
   },
   {
     label: "A2A skills count",
     actual: countFiles("src/lib/a2a/skills"),
     docKey: "A2A skills",
-    docs: ["A2A-SERVER.md"],
+    docs: ["frameworks/A2A-SERVER.md"],
   },
   {
     label: "Cloud agents count",
     actual: countFiles("src/lib/cloudAgent/agents"),
     docKey: "cloud agents",
-    docs: ["CLOUD_AGENT.md", "AGENT_PROTOCOLS_GUIDE.md"],
+    docs: ["frameworks/CLOUD_AGENT.md", "frameworks/AGENT_PROTOCOLS_GUIDE.md"],
   },
 ];