feat: expose server mode in /health and /ready endpoints #39

New Issue

forbes · 2026-02-08T21:40:04Z

forbes commented

2026-02-08 21:40:04 +00:00

Summary

Clients need to know the server's operational state to adjust UI behavior (disable writes, show banners).

Proposed modes

Mode	Meaning
`normal`	Full read/write
`read-only`	DB reads work, writes return 503
`degraded`	DB up, MinIO unreachable (file ops fail)

Changes to existing endpoints

Add mode field to both existing endpoints:

GET /health
{ "status": "ok", "mode": "normal" }

GET /ready
{
  "status": "ok",
  "mode": "degraded",
  "database": "ok",
  "minio": "unreachable",
  "sse_clients": 2
}

Mode also pushed via SSE server.state event when it changes (depends on #38).

Acceptance criteria

mode field added to /health and /ready responses
Mode derived from actual connectivity checks, not just config
read-only mode settable via config flag or SIGUSR1
Write endpoints return 503 with {"error":"server_read_only"} when in read-only mode

## Summary Clients need to know the server's operational state to adjust UI behavior (disable writes, show banners). ## Proposed modes | Mode | Meaning | |------|---------| | `normal` | Full read/write | | `read-only` | DB reads work, writes return 503 | | `degraded` | DB up, MinIO unreachable (file ops fail) | ## Changes to existing endpoints Add `mode` field to both existing endpoints: ```json GET /health { "status": "ok", "mode": "normal" } GET /ready { "status": "ok", "mode": "degraded", "database": "ok", "minio": "unreachable", "sse_clients": 2 } ``` Mode also pushed via SSE `server.state` event when it changes (depends on #38). ## Acceptance criteria - [ ] `mode` field added to `/health` and `/ready` responses - [ ] Mode derived from actual connectivity checks, not just config - [ ] `read-only` mode settable via config flag or `SIGUSR1` - [ ] Write endpoints return 503 with `{"error":"server_read_only"}` when in read-only mode

forbes referenced this issue from a commit

2026-02-08 21:59:32 +00:00

feat: add SSE endpoint and server mode system

forbes referenced a pull request that will close this issue

2026-02-08 21:59:48 +00:00

feat: SSE endpoint and server mode system (#38, #39) #40

forbes closed this issue

2026-02-08 22:00:13 +00:00

forbes referenced this issue from a commit

2026-02-08 22:00:14 +00:00

Merge pull request 'feat: SSE endpoint and server mode system (#38, #39)' (#40) from feat-38-39-sse-server-mode into main

Sign in to join this conversation.