switchboard/core
Archived
1
0
Fork 0
Code Issues Pull Requests Actions Releases 9 Wiki Activity

Changeset 0.33.0 (#207)

Browse Source 
Co-authored-by: Jeffrey Smith <jasafpro@gmail.com>
Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>
This commit is contained in:
Jeffrey Smith
2026-03-19 21:37:32 +00:00
committed by xcaliber
parent b1266b0d7c
commit ed3e9363f2
42 changed files with 2527 additions and 129 deletions
Download Patch File Download Diff File Expand all files Collapse all files

79
docs/ROADMAP.md
View File

@@ -31,7 +31,7 @@ v0.9.x–v0.28.7 Foundation through Platform Polish ✅
Extension Track Operations Track
│ │
v0.29.0 Starlark Sandbox ✅ v0.32.0 Multi-Replica HA ✅
v0.29.1 API Extensions ✅ v0.33.0 Observability
v0.29.1 API Extensions ✅ v0.33.0 Observability ✅
v0.29.2 DB Extensions ✅ v0.34.0 Data Portability
v0.29.3 Workflow Forms ✅ │
v0.30.0 Package Lifecycle ✅ │
@@ -43,6 +43,8 @@ v0.9.x–v0.28.7 Foundation through Platform Polish ✅
│ │
│ v0.35.0 Workflow Product
│ │
│ v0.36.0 Full OpenAPI Spec
│ │
══════╪═══════════════════════════════╪══════
│ MVP v0.50.0 │
│ (v0.31.2 + v0.35.0 │
@@ -384,23 +386,33 @@ no new coordination infrastructure. See `docs/DESIGN-0.32.0.md`.
**Schema:** `020_ha.sql` — `ws_tickets`, `rate_limit_counters`.
### v0.33.0 — Observability
### v0.33.0 — Observability ✅
Metrics, dashboards, alerting. Operate the platform without reading
Go source code.
Depends on: v0.32.0 (multi-replica metrics aggregation).
- [ ] Prometheus `/metrics` endpoint: request latency, active WebSocket
gauge, completion token counters, DB pool stats, provider health
- [ ] Grafana dashboard template: system overview, per-team usage,
provider latency, error rates
- [ ] Structured logging: `LOG_FORMAT=json`, request ID propagation,
correlation IDs in completion chains
- [ ] Alerting rules: OOM recovery, provider down, pool exhaustion,
task failure rate
- [ ] Admin dashboard surface: real-time health (built-in, no Grafana)
- [ ] Swagger/OpenAPI: auto-generated spec from route definitions, served at /api/docs
**Delivered (6 changesets):**
- [x] Structured logging (`slog`): `LOG_FORMAT=json|text`,
`LOG_LEVEL=debug|info|warn|error`. Request ID middleware
(`X-Request-Id`), correlation IDs through completion chain.
- [x] Prometheus `/metrics` endpoint: HTTP request counters/histograms,
WebSocket gauge, completion tokens/duration, provider status,
DB pool stats, task/sandbox execution counters.
- [x] OpenAPI 3.0.3 spec (hand-curated, core API groups) + Swagger UI
at `/api/docs` with system dark/light mode, WCAG AA contrast.
- [x] Grafana dashboard JSON: request rate, latency percentiles,
provider health, token usage, DB pool, Go runtime.
- [x] PrometheusRule alerting: OOM recovery, provider down, pool
exhaustion, high error rate, task failure spike.
- [x] Admin monitoring dashboard: provider health, 24h usage, DB pool,
WS connections, Go runtime stats, storage status, recent errors,
30s auto-refresh.
**Deferred to v0.36.0:**
- Full OpenAPI spec coverage (all 20 ICD domains)
- Bearer token / mTLS auth documentation in spec
### v0.34.0 — Data Portability
@@ -472,6 +484,48 @@ 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
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
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)
**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
**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)
---
## MVP v0.50.0
@@ -487,6 +541,7 @@ reading Go source code. Team admins build workflows visually.
data portability)
- Workflow product v0.35.0 (form rendering, data pipeline, conditional
routing, structured review, monitoring dashboard)
- Full OpenAPI spec v0.36.0 (complete API documentation for all domains)
**Additionally requires:**
- [ ] Deployment guide: step-by-step for IT team (PG cluster,