Port documentation to Zensical

[wesm]

Summary

• Replace the Astro/Starlight docs stack with Zensical, uv, and a dedicated site-docs content root.
• Port the docs content, assets, routes, navigation, redirects, sitemap, 404, search, Mermaid, screenshots, lightbox behavior, and Roborev green/slate theme.
• Preserve the top Discord invite announcement and global Open Graph/Twitter metadata.

Test Plan

• uv run --frozen zensical build --strict
• uv run --frozen python scripts/check_built_site.py
• uv run --frozen python scripts/check_vercel_redirects.py
• Server-backed smoke checks for key pages, search data, metadata, tables, Mermaid, and lightbox hooks

Note: the in-app browser backend was unavailable in this session, so click/screenshot QA was covered with generated HTML and local server checks instead.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
roborev-docs	Ready	Preview, Comment	Jun 13, 2026 1:24am

[roborev-ci]

roborev: Combined Review (24ad43a)

Review verdict: One medium issue needs fixing before the migration is fully consistent.

Medium

• screenshots/screenshot-all.sh:7
  The screenshot generator still writes assets to ../public, but public/ was removed and Zensical serves assets from site-docs/. Regenerating screenshots will create an unused public/ tree while the docs continue serving stale images.
  Fix: Change the output directory to "$SCRIPT_DIR/../site-docs" or make the docs asset directory configurable with site-docs as the default.

---

Panel: ci_default_security | Synthesis: codex, 7s | Members: codex_default (codex/default, done, 5m35s), codex_security (codex/security, done, 48s) | Total: 6m30s

[roborev-ci]

roborev: Combined Review (1e6b595)

Medium issue found; security review found no issues.

Medium

• [screenshots/screenshot-all.sh:7] Screenshot generation still writes to ../public, but this migration deletes public/ and serves assets from site-docs/. Regenerated screenshots will land in an obsolete untracked directory and will not update the docs.
  • Fix: Change the output directory to ../site-docs or make the target configurable and document the new default.

---

Panel: ci_default_security | Synthesis: codex, 6s | Members: codex_default (codex/default, done, 5m16s), codex_security (codex/security, done, 15s) | Total: 5m37s

[mariusvniekerk]

vercel preview seems to work