Changeset 0.36.0 (#212)
This commit is contained in:
@@ -43,7 +43,7 @@ v0.9.x–v0.28.7 Foundation through Platform Polish ✅
|
||||
│ │
|
||||
│ v0.35.0 Workflow Product
|
||||
│ │
|
||||
│ v0.36.0 Full OpenAPI Spec
|
||||
│ v0.36.0 Full OpenAPI Spec ✅
|
||||
│ │
|
||||
══════╪═══════════════════════════════╪══════
|
||||
│ MVP v0.50.0 │
|
||||
@@ -410,7 +410,7 @@ Depends on: v0.32.0 (multi-replica metrics aggregation).
|
||||
WS connections, Go runtime stats, storage status, recent errors,
|
||||
30s auto-refresh.
|
||||
|
||||
**Deferred to v0.36.0:**
|
||||
**Deferred to v0.36.0 (delivered):**
|
||||
- Full OpenAPI spec coverage (all 20 ICD domains)
|
||||
- Bearer token / mTLS auth documentation in spec
|
||||
|
||||
@@ -484,7 +484,7 @@ Depends on: v0.31.2 (team workflow self-service), v0.29.0 (Starlark sandbox).
|
||||
- Data intake: form → Starlark enrichment → human review → follow-up
|
||||
- Onboarding: multi-stage form → conditional branching → team assignment
|
||||
|
||||
### v0.36.0 — Full OpenAPI Spec
|
||||
### v0.36.0 — Full OpenAPI Spec ✅
|
||||
|
||||
Complete OpenAPI 3.0.3 coverage for every API domain. Expand the
|
||||
hand-curated spec from v0.33.0 (core groups only) to cover all 20 ICD
|
||||
@@ -493,38 +493,38 @@ test domains. Document Bearer token auth and mTLS modes.
|
||||
Depends on: v0.33.0 (Swagger UI + initial spec).
|
||||
|
||||
**API domains to document (matching ICD test suite):**
|
||||
- [ ] Admin (system settings, stats, storage, users, provider config)
|
||||
- [ ] Channels (full CRUD + membership, already partially covered)
|
||||
- [ ] Completions (streaming + non-streaming, already partially covered)
|
||||
- [ ] Extensions (package install, permissions, lifecycle)
|
||||
- [ ] Knowledge (KB articles, sources, search, embeddings)
|
||||
- [ ] Memory (conversation memory, compaction, search)
|
||||
- [ ] Models (provider models, BYOK, capability matching)
|
||||
- [ ] Notes (CRUD, graph links, search)
|
||||
- [ ] Notifications (list, mark read, preferences)
|
||||
- [ ] Personas (CRUD, system prompts, tool config)
|
||||
- [ ] Profile (user profile, preferences, avatar)
|
||||
- [ ] Projects (CRUD, membership, file uploads)
|
||||
- [ ] Surfaces (extension surfaces, mounting, lifecycle)
|
||||
- [ ] Tasks (scheduled tasks, execution history, Starlark tasks)
|
||||
- [ ] Teams (CRUD, membership, roles, slugs)
|
||||
- [ ] Team Workflows (team-scoped CRUD, stages, publish)
|
||||
- [ ] Workflows (platform-level CRUD, stages, instances, assignments)
|
||||
- [ ] Workspaces (CRUD, membership, settings)
|
||||
- [ ] Dashboard Package (package-specific API routes)
|
||||
- [ ] Editor Package (package-specific API routes)
|
||||
- [x] Admin (system settings, stats, storage, users, provider config)
|
||||
- [x] Channels (full CRUD + membership, already partially covered)
|
||||
- [x] Completions (streaming + non-streaming, already partially covered)
|
||||
- [x] Extensions (package install, permissions, lifecycle)
|
||||
- [x] Knowledge (KB articles, sources, search, embeddings)
|
||||
- [x] Memory (conversation memory, compaction, search)
|
||||
- [x] Models (provider models, BYOK, capability matching)
|
||||
- [x] Notes (CRUD, graph links, search)
|
||||
- [x] Notifications (list, mark read, preferences)
|
||||
- [x] Personas (CRUD, system prompts, tool config)
|
||||
- [x] Profile (user profile, preferences, avatar)
|
||||
- [x] Projects (CRUD, membership, file uploads)
|
||||
- [x] Surfaces (extension surfaces, mounting, lifecycle)
|
||||
- [x] Tasks (scheduled tasks, execution history, Starlark tasks)
|
||||
- [x] Teams (CRUD, membership, roles, slugs)
|
||||
- [x] Team Workflows (team-scoped CRUD, stages, publish)
|
||||
- [x] Workflows (platform-level CRUD, stages, instances, assignments)
|
||||
- [x] Workspaces (CRUD, membership, settings)
|
||||
- [x] Dashboard Package (package-specific API routes)
|
||||
- [x] Editor Package (package-specific API routes)
|
||||
|
||||
**Auth documentation:**
|
||||
- [ ] Bearer JWT flow (login → token → `Authorization: Bearer <token>`)
|
||||
- [ ] mTLS mode (NPE-to-NPE, no Bearer needed)
|
||||
- [ ] API key mode (for service-to-service integrations)
|
||||
- [ ] Security scheme definitions in OpenAPI spec
|
||||
- [x] Bearer JWT flow (login → token → `Authorization: Bearer <token>`)
|
||||
- [x] mTLS mode (NPE-to-NPE, no Bearer needed)
|
||||
- [x] API key mode (for service-to-service integrations)
|
||||
- [x] Security scheme definitions in OpenAPI spec
|
||||
|
||||
**Quality:**
|
||||
- [ ] Request/response schemas with examples for every endpoint
|
||||
- [ ] Error response schemas (400, 401, 403, 404, 409, 422, 429, 500)
|
||||
- [ ] Pagination parameters documented consistently
|
||||
- [ ] WebSocket event schemas (connection, ticket, event types)
|
||||
- [x] Request/response schemas with examples for every endpoint
|
||||
- [x] Error response schemas (400, 401, 403, 404, 409, 422, 429, 500)
|
||||
- [x] Pagination parameters documented consistently
|
||||
- [x] WebSocket event schemas (connection, ticket, event types)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user