# API Contracts Tasks

| Task | Status | Notes |
| --- | --- | --- |
| OAS-61-001 | DONE | Scaffold per-service OpenAPI 3.1 files with shared components, info blocks, and initial path stubs. |
| OAS-61-002 | DONE (2025-11-18) | Composer (`compose.mjs`) emits `stella.yaml` with namespaced paths/components; CI job validates aggregate stays up to date. |
| OAS-62-001 | DONE (2025-11-26) | Added examples across Authority, Policy, Orchestrator, Scheduler, Export, and Graph stubs covering top flows; standard error envelopes present via shared components. |
| OAS-62-002 | DONE (2025-11-26) | Added pagination/Idempotency-Key/operationId lint rules; enforced cursor on orchestrator jobs list and kept lint clean. |
| OAS-63-001 | DONE (2025-11-26) | Compat diff now tracks parameter adds/removals/requiredness, request bodies, and response content types with updated fixtures/tests. |
| OAS-63-002 | DONE (2025-11-24) | Discovery endpoint metadata and schema extensions added; composed spec exports `/.well-known/openapi` entry. |