1 files changed, 20 insertions, 0 deletions

diff --git a/CONTEXT.md b/CONTEXT.md
new file mode 100644
index 0000000..f39bb31
--- /dev/null
+++ b/CONTEXT.md
@@ -0,0 +1,20 @@
+# 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.