Build against contracts
The canonical contract lives in contract/. The API server in packages/api/src/server.js is the only truthful HTTP entrypoint; the CLI and MCP surfaces consume the same operationIds.
Contract-first workflow
- OpenAPI defines the operation and its input/output.
- The TypeScript SDK and CLI are generated or checked against that contract.
- MCP tools and docs reference the same operationId.
- Doctor gates and tests verify that no surface drifts.
Health and status
/health and /ready are machine health endpoints. /status reports the deployed build identity when a SHA has been injected. These are diagnostics, not marketing pages.