150b3730ef
Some checks failed
AOC Guard CI / aoc-guard (push) Has been cancelled
AOC Guard CI / aoc-verify (push) Has been cancelled
Docs CI / lint-and-preview (push) Has been cancelled
Mirror Thin Bundle Sign & Verify / mirror-sign (push) Has been cancelled
api-governance / spectral-lint (push) Has been cancelled
4.1 KiB
4.1 KiB
Sprint 511 - Ops & Offline · 190.F) Api
Active items only. Completed/historic work now resides in docs/implplan/archived/tasks.md (updated 2025-11-08).
[Ops & Offline] 190.F) Api Depends on: Sprint 100.A - Attestor, Sprint 110.A - AdvisoryAI, Sprint 120.A - AirGap, Sprint 130.A - Scanner, Sprint 140.A - Graph, Sprint 150.A - Orchestrator, Sprint 160.A - EvidenceLocker, Sprint 170.A - Notifier, Sprint 180.A - Cli Summary: Ops & Offline focus on Api).
| Task ID | State | Task description | Owners (Source) |
|---|---|---|---|
| APIGOV-61-001 | DONE (2025-11-18) | Spectral config + CI workflow added; npm script api:lint runs spectral via npx. |
API Governance Guild (src/Api/StellaOps.Api.Governance) |
| APIGOV-61-002 | DONE (2025-11-18) | Implement example coverage checker ensuring every operation has at least one request/response example. Dependencies: APIGOV-61-001. | API Governance Guild (src/Api/StellaOps.Api.Governance) |
| APIGOV-62-001 | DONE (2025-11-18) | Build compatibility diff tool producing additive/breaking reports comparing prior release. Dependencies: APIGOV-61-002. | API Governance Guild (src/Api/StellaOps.Api.Governance) |
| APIGOV-62-002 | DONE (2025-11-24) | Automate changelog generation and publish signed artifacts to src/Sdk/StellaOps.Sdk.Release pipeline. Dependencies: APIGOV-62-001. |
API Governance Guild, DevOps Guild (src/Api/StellaOps.Api.Governance) |
| APIGOV-63-001 | BLOCKED | Notification Studio templates and deprecation metadata schema not present; waiting on Notifications Guild assets. | API Governance Guild, Notifications Guild (src/Api/StellaOps.Api.Governance) |
| OAS-61-001 | DONE (2025-11-18) | Scaffold per-service OpenAPI 3.1 files with shared components, info blocks, and initial path stubs. | API Contracts Guild (src/Api/StellaOps.Api.OpenApi) |
| OAS-61-002 | DONE (2025-11-18) | Implement aggregate composer (stella.yaml) resolving $refs and merging shared components; wire into CI. Dependencies: OAS-61-001. |
API Contracts Guild, DevOps Guild (src/Api/StellaOps.Api.OpenApi) |
| OAS-62-001 | BLOCKED (2025-11-19) | Populate request/response examples for top 50 endpoints, including standard error envelope. Dependencies: OAS-61-002 not ratified; waiting on approved examples + error envelope. | API Contracts Guild, Service Guilds (src/Api/StellaOps.Api.OpenApi) |
| OAS-62-002 | BLOCKED | Depends on 62-001 examples to tune lint rules. | API Contracts Guild (src/Api/StellaOps.Api.OpenApi) |
| OAS-63-001 | BLOCKED | Compat diff enhancements depend on 62-002 lint + examples output. | API Contracts Guild (src/Api/StellaOps.Api.OpenApi) |
| OAS-63-002 | TODO | Add /.well-known/openapi discovery endpoint schema metadata (extensions, version info). Dependencies: OAS-63-001. |
API Contracts Guild, Gateway Guild (src/Api/StellaOps.Api.OpenApi) |
Execution Log
| Date (UTC) | Update | Owner |
|---|---|---|
| 2025-11-08 | Archived completed/historic work to docs/implplan/archived/tasks.md (updated 2025-11-08). | Planning |
| 2025-11-18 | Added Spectral config (.spectral.yaml), npm api:lint (npx spectral) script, and CI workflow .gitea/workflows/api-governance.yml; marked APIGOV-61-001 DONE. |
API Governance Guild |
| 2025-11-18 | Implemented example coverage checker (api:examples), aggregate composer compose.mjs, and initial per-service OAS stubs (authority/orchestrator/policy/export-center); OAS-61-001/002 set to DONE. |
API Contracts Guild |
| 2025-11-19 | Added scheduler/export-center/graph shared endpoints, shared paging/security components, and CI diff gates (previous commit + baseline). Created baseline stella-baseline.yaml. |
API Contracts Guild |
| 2025-11-19 | Implemented API changelog generator (api:changelog), wired compose/examples/compat/changelog into CI, and added new policy revisions + scheduler queue/job endpoints. |
API Contracts Guild |
| 2025-11-24 | Completed APIGOV-62-002: api:changelog now copies release-ready artifacts + digest/signature to src/Sdk/StellaOps.Sdk.Release/out/api-changelog for SDK pipeline consumption. |
Implementer |
| 2025-11-19 | Marked OAS-62-001 BLOCKED pending OAS-61-002 ratification and approved examples/error envelope. | Implementer |