police sweep 2026-06-05: docs sync — v2 surface note + endpoint count fix

[onebit0fme]

Summary

Police sweep 2026-06-05 docs-repo sync (driven by the monorepo sweep at onebit0fme/optimal-agency#24).

Fixes

• Public surfaces table: /v2 alpha surface — api/v2/ is live in the monorepo and publicly reachable at u22a8.ai/v2. Added a row noting it as alpha (spaces/capabilities vocabulary per DR 042/046). The row explicitly says "not yet documented" to prevent writers from accidentally treating it as a stable reference target.
• REST API /v1 endpoint count — Changed "16 resource paths" to "17 paths" with the explicit breakdown. The old count was off-by-one (missed /v1/health); the new wording lists the paths so future readers can count themselves.

What was not changed

• No v2 concept pages or reference pages authored — the surface is alpha and the treatment is a judgment call. Filed as a Public Docs Linear issue to decide when/how to document it.
• No OpenAPI snapshot refresh in this PR — the snapshot drift check requires the live spec to be reachable; that check runs from the monorepo's police sweep environment.
• Leak scan passed clean (exit 0, 34 files, no errors).

Monorepo sweep: onebit0fme/optimal-agency#24
Commit range: initial HEAD sweep (no prior police sweep found in last 50 commits)

https://claude.ai/code/session_011Uw8zfHbfQcpjSMWiHkoW9

---

Generated by Claude Code

[mintlify]

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

Project	Status	Preview	Updated (UTC)
u22a8	🟢 Ready	View Preview	Jun 5, 2026, 7:38 AM