# Kao — TODO

Feature ideas for future work, roughly in priority order.

## REST API improvements

- **`/status` SSE stream** — replace frontend polling with a Server-Sent Events
  endpoint so the display reacts instantly and the 2s polling overhead disappears
- **Notification queue** — buffer rapid `/notify` calls and auto-advance through
  them instead of clobbering; important when HA fires several events at once
- **Sticky notifications** — a `sticky: true` flag on `/notify` to keep a
  notification visible until explicitly cleared via `/clear`, rather than TTL-expiring
- **Named presets** — define reusable notification profiles in `config.json`
  (e.g. `"doorbell"` → specific emote/sound/color/duration) so callers can
  POST `{"preset": "doorbell"}` without repeating fields every time
- **Batch `/notify`** — accept an array in a single POST so multiple
  notifications can be queued atomically
- **`/history` endpoint** — a ring buffer of the last N state changes/events
  received, for auditing what fired overnight without tailing logs

## Display / frontend

- **Brightness curve** — dim gradually after dark rather than hard-sleeping;
  reduces OLED burn-in without losing glanceability
- **Scrolling ticker** — when multiple events are active, cycle through their
  messages rather than only showing the top one