From 7a565f377203ba8e01574952014a23dfa8d94fa3 Mon Sep 17 00:00:00 2001 From: salmonik Date: Thu, 30 Jul 2026 15:09:51 +0200 Subject: fix: auto completion timing out before ready + fix preexisting warns --- CONTEXT.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 CONTEXT.md (limited to 'CONTEXT.md') 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. -- cgit v1.2.3