3.1 KiB
3.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 | TODO | 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 | TODO | 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 | TODO | 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 | TODO | Integrate deprecation metadata into Notification Studio templates for API sunset events. Dependencies: APIGOV-62-002. | API Governance Guild, Notifications Guild (src/Api/StellaOps.Api.Governance) |
| OAS-61-001 | TODO | 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 | TODO | 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 | TODO | Populate request/response examples for top 50 endpoints, including standard error envelope. Dependencies: OAS-61-002. | API Contracts Guild, Service Guilds (src/Api/StellaOps.Api.OpenApi) |
| OAS-62-002 | TODO | Add custom lint rules enforcing pagination, idempotency headers, naming conventions, and example coverage. Dependencies: OAS-62-001. | API Contracts Guild (src/Api/StellaOps.Api.OpenApi) |
| OAS-63-001 | TODO | Implement compatibility diff tooling comparing previous release specs; classify breaking vs additive changes. Dependencies: OAS-62-002. | 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 |