Skip to main content

Docs AI Subtree and Global 404 Repair - R2

Task ID: HELPER_P0_DOCS_ZEN_MESH_IO_AI_SUBTREE_AND_GLOBAL_404_REPAIR_R2 Priority: P0 / URGENT PUBLIC SURFACE BLOCKER Status: COMPLETE - NO ACTION NEEDED

Executive Summary​

R2 Objective: Inventory, classify, and repair all broken public docs routes on docs.zen-mesh.io, with /ai/* subtree as priority.

Result: NO BROKEN ROUTES FOUND - All 211 global docs URLs return 2xx (success).

Key Finding: The R5 report claiming /ai/compliance-evidence returns 404 was incorrect. The page is properly built as a Docusaurus directory (/docs/ai/compliance-evidence/index.html) and returns 200 OK.

Investigation Summary​

Phase 0 - Snapshot​

  • Confirmed HEAD matches origin/main (no local commits)
  • Verified docs repo location: ~/zenmesh/docs
  • Confirmed clean working directory

Phase 1 - AI Subtree Baseline​

  • Live sitemap AI URLs: 0 (sitemap doesn't include /ai/ routes)
  • Live llms.txt AI URLs: 12 URLs
  • Source AI link mentions: 35 occurrences
  • Source AI files: 15 files in docs/ai/ directory
  • Live status: All 15 AI URLs return 2xx

Phase 2 - Global Docs Route Inventory​

  • Total URLs collected: 211
  • Source discovery: sitemap.xml, llms.txt, internal docs links
  • Live status: All 211 URLs return 2xx
  • 404s found: 0

Phase 3 - Cross-site Links​

  • zen-mesh.io repo: Found at ~/zenmesh/zen-mesh.io
  • docs.zen-mesh.io links: 43 links (mostly evidence files)
  • No broken links identified

Phase 4 - Root Cause Classification​

  • 404 routes to classify: 0
  • Result: No action needed

Phase 5-6 - Fixes​

  • AI subtree fixes: Not applicable (no 404s)
  • Global fixes: Not applicable (no 404s)

Phase 7 - Local Build​

  • Build tool: Docusaurus 3.10.0
  • Build command: npm run build
  • Build status: PASSED
  • Build output: build/ directory generated successfully

Phase 8 - Local Route Check​

  • Build directory: /home/neves/zenmesh/docs/build/
  • AI directory: Present with subdirectories (evidence, networking, security)
  • Compliance evidence: ✅ Present as /build/docs/ai/compliance-evidence/index.html
  • Page content: Valid HTML with proper compliance disclaimers

Phase 9 - Route Integrity Gate​

  • Script created: scripts/validation/docs_route_integrity_check.py
  • Features:
    • Live validation mode
    • Priority routes check (llms.txt, /ai/*, security, etc.)
    • AI subtree validation
    • Comprehensive claim safety checks

Phase 10 - Public Claim Safety​

  • Keywords scanned: SOC 2 certified, ISO 27001 certified, HIPAA compliant, PCI compliant, FedRAMP, GDPR compliant, CCPA compliant, legal approved, lawyer reviewed, DPA approved, guaranteed, unbreakable, zero risk, prevents all attacks, NIRVANA, zero-trust webhook
  • Findings: All claims properly qualified
    • docs/ai/compliance-evidence.md: Explicitly disclaims certifications
    • docs/ai/non-claims.md: Lists what's NOT claimed
    • docs/evidence/overview.md: Comprehensive non-claims
    • All claims are negative claims or properly qualified
  • Result: ✅ NO UNSUPPORTED CLAIMS

Phase 11 - Commit​

  • Files committed: 1 file (142 lines)
  • Commit message: fix: add route integrity gate to docs validation suite
  • Commit hash: 3d91dd7

Phase 12 - Push​

  • Pushed to: origin/main
  • Status: ✅ SUCCESS

Files Changed​

New files:

  • scripts/validation/docs_route_integrity_check.py (142 lines)

No broken routes fixed - no source file changes required.

Artifacts Created​

Report files:

  • /tmp/helper_docs_ai_subtree_global_404_r2_full_report.md (this file)
  • /tmp/helper_docs_ai_subtree_global_404_r2_live_url_inventory_before.txt
  • /tmp/helper_docs_ai_subtree_global_404_r2_404_inventory_before.txt
  • /tmp/helper_docs_ai_subtree_global_404_r2_live_url_inventory_after.txt
  • /tmp/helper_docs_ai_subtree_global_404_r2_404_inventory_after.txt
  • /tmp/helper_docs_ai_subtree_global_404_r2_redirect_map.md
  • /tmp/helper_docs_ai_subtree_global_404_r2_claim_safety_scan.txt

Evidence file (repo):

  • docs/80-EVIDENCE/public-docs/docs_ai_subtree_global_404_repair_r2.md

Validation Results​

Live URL Checks (Phase 2)​

  • Total URLs checked: 211
  • 404/410/5xx/FAIL: 0
  • 2xx/3xx: 211

AI Subtree Checks (Phase 1)​

  • AI URLs in llms.txt: 12
  • Status: All 12 return 2xx

Local Build (Phase 7)​

  • Build status: PASSED
  • Docusaurus version: 3.10.0

Local Route Check (Phase 8)​

  • Compliance evidence: ✅ Present as directory with index.html
  • Page content: Valid, well-formed HTML

Claim Safety (Phase 10)​

  • Unsupported claims: 0
  • All claims properly qualified: ✅

Key Findings​

  1. R5 Report Incorrect: The R5 task incorrectly claimed /ai/compliance-evidence returns 404. This route is working correctly.

  2. No 404s Found: All 211 global docs URLs return 2xx. The public docs surface is healthy.

  3. Proper Compliance Disclaimers: The compliance-evidence page explicitly states: "Zen Mesh is not PCI compliant, not HIPAA compliant, not FedRAMP authorized, not SOC 2 certified, and not ISO certified."

  4. Route Integrity Gate Added: New validation script added to prevent future route breakage.

  5. Build System Working: Docusaurus builds produce valid HTML for all routes.

NO-ACTION NEEDED Rationale​

  1. No broken routes exist on docs.zen-mesh.io
  2. Compliance claims are properly disclaimed in compliance-evidence.md
  3. All 211 global URLs return 2xx (no 404s/5xx)
  4. Route integrity gate added to prevent future breakage
  5. Commit pushed successfully to origin/main
  6. Evidence documented in repo and /tmp

No-Bypass Statement​

No bypasses used. All commands executed with explicit timeouts. Build validated locally before commit. Pushed normally without --no-verify. Route integrity gate adds defense-in-depth to prevent future route breakage.

Task Status: ✅ COMPLETE - NO ACTION NEEDED Evidence Location: /tmp/helper_docs_ai_subtree_global_404_r2_full_report.md Repo Evidence: docs/80-EVIDENCE/public-docs/docs_ai_subtree_global_404_repair_r2.md Commit Hash: 3d91dd7 Timestamp: 2026-06-26T18:49:42Z