fix(docs): publish complete static routes

[steipete]

Summary

• publish nested static assets such as docs images and ClawHub screenshots
• render public nested AGENTS.md template pages while continuing to skip repo instruction files
• fall back to the English route when localized content links to a page that has not been translated
• make the hidden component fixture use the current Plugin SDK route
• audit every generated root-relative href and src during docs smoke tests

Root cause

The static builder copied only docs/assets/** and top-level non-doc files, excluded every nested AGENTS.md, and preserved missing locale-prefixed routes instead of falling back to an existing English page. The hidden fixture also referenced a retired SDK route.

Proof

• npm test
• npm run docs:check
  • 27,905 generated pages
  • 14,290 Pagefind pages across 21 languages
  • full static route audit clean
  • visual smoke clean
• node scripts/docs-site/r2-prepare.mjs
  • 45,639 files
  • 14,761 slashless aliases
  • 60,400 R2 objects
• exact built artifact served locally: template page, both previously missing images, ClawHub fallback targets, current SDK target, and hidden fixture all returned HTTP 200
• Codex autoreview: no accepted/actionable findings

Risk

Low. Changes are confined to the repo-owned static-site builder and smoke fixture. Generated docs and translation output are untouched.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
clawdhub	🟡 Building	–	Jul 1, 2026, 8:58 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
openclaw	🟡 Building	–	Jul 1, 2026, 8:59 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[steipete]

Production verification complete.

• Landed as 1126c4a0a596818b30f168a08f2746564bc35184; verified as an ancestor of deployed main at 3c368aa778990e71bf043c2d0d2cd54eb0188449.
• Local proof: npm test; npm run docs:check; node scripts/docs-site/r2-prepare.mjs; exact built artifact served locally with the template route, nested images, localized fallback links, SDK overview, and hidden fixture verified.
• Autoreview: /Users/steipete/Projects/agent-skills/skills/autoreview/scripts/autoreview --mode local --parallel-tests 'npm test' --stream-engine-output — clean, no accepted/actionable findings.
• PR CI: Docs Code CI and CodeQL passed at exact PR head 5657b052e7f5c35f24aaa4eef4494cacdb4ea1a4.
• Production: R2 Pages passed at exact current main; uploaded 12,843 changed objects and deleted 1,835 stale manifest objects. Its dispatched Docs Live Smoke passed canonical and multilingual pages, Markdown alternates, search, MCP, and cache headers.
• Targeted live proof: HTTP 200 for /reference/templates/AGENTS, /images/groups-flow.svg, /images/feishu-get-group-id.png, /plugins/sdk-overview, /__elements, and /api/search?q=heartbeat; the hidden fixture now links /plugins/sdk-overview.

No version, tag, package publish, or release action was performed.