Overview

Contents

api-guidelines.md

• 1. Naming
• 2. Required headers
• 3. Versioning
• 4. Authentication
• 5. Pagination, filtering, sorting
• 6. Error envelope (RFC 9457)
• 7. Real-time stream — deployment events (SSE)
• 8. Append-only semantics
• 9. Rate limiting
• 10. Security notes
• 11. Control plane — Kubernetes-style orchestration
• 12. Analytics — DORA-anchored aggregate reads
• 13. Examples → api-examples.md
• 14. Known carry-over for implementers

api-examples.md

HTTP examples — ingest (success, in-progress), matrix snapshot, SSE, fetcher cursor, control reset, control stream subscription, component event post.