Release 2026-06-01 — Docs migration + first API epoch

This release marks two significant changes for AlphaSwarm customers:

New

• docs.alpha-swarm.ai is live. The canonical documentation site replaces the previous GitHub-rendered tree at alphaswarm_docs/. Every previous link continues to resolve via 301 redirects in alphaswarm_docs/static/_redirects.
• Interactive API playground at /reference/api. Token persistence works end-to-end; copy a Bearer from alphaswarm-cli auth login and every request from the playground inherits it.
• AI-native surfaces. A curated /llms.txt index, the full corpus at /llms-full.txt, and an RFC 9728 + 8707-compliant MCP server at /mcp are now first-class agent entry points.
• In-product help panel in the operator UI — the help drawer reads directly from the docs corpus, so the in-product reference never drifts from the public site.

Improved

• Search is local-first. Pagefind indexes the entire corpus client-side; no documentation content ever leaves the docs site.
• Quality gates. Every PR to alphaswarm_docs/ runs Vale + alex.js + markdownlint + lychee + Lighthouse + axe-core + executable Python snippets via pytest-markdown-docs.
• Hybrid authoring. Business editors can ship docs through Keystatic at /keystatic — the typed schemas commit to the same branch protection rules as engineers.

API

• First Stripe-style date epoch: 2026-06-01. No surface changes from the prior unversioned API; future epochs will follow the documented 12-month sunset cycle with RFC 8594 Deprecation and Sunset response headers.
• OpenAPI specs committed at alphaswarm_docs/openapi/alphaswarm.json and alphaswarm_docs/openapi/control-plane.json. oasdiff PR gates prevent silent drift.

Internal

• Cloudflare Pages + Cloudflare Access front the docs site as a separate edge property — the cluster tunnel at alpha-swarm.ai / api.alpha-swarm.ai / manage.alpha-swarm.ai continues unchanged.
• Logpush ships request + Access audit logs to a new R2 bucket (alphaswarm-docs-access-logs) with 365-day retention for SOC 2 / ISO 27001 evidence.
• Instatus at status.alpha-swarm.ai is now the canonical status page; the docs site renders a live banner via the Instatus JSON API.

Migration notes

If you have hard-coded references to alphaswarm_docs/<old-path>.md in your own tooling, both shapes resolve correctly today; the legacy shape will return a 410 starting 2027-06-01 (the 12-month sunset window applies to URL paths as well as API epochs).