# CONTEXT

Glossary of terms used in this codebase. This file is a glossary only — it
holds no implementation decisions or specs (those live in `docs/adr/`).

## Voice

- **Voice activity** — per-user join / leave / AFK *timing metadata*, persisted
  in the `voice_activity` table and updated by `events::handle_voice_state_update`.
  Despite the name, it contains **no audio** — only timestamps and durations.
- **Recording** — capturing the *audio* of a voice channel into a rolling
  in-memory buffer while the bot is connected. Distinct from *voice activity*
  (metadata). A bot "records" continuously while in a VC (unless opted out) and
  "flushes" on `/record`.
- **Window** — the retention horizon of the recording buffer: how many seconds
  of the recent past are kept. Older audio is discarded as new audio arrives.
  Configured via `RECORDING_WINDOW_SECONDS` (default 900 = 15 minutes).
- **Flush** — the `/record` action: snapshot the current recording buffer to an
  mp3 and upload it to Copyparty. Non-destructive — the buffer keeps recording
  after a flush, so successive calls may overlap.