Spaces:
Sleeping
Sleeping
|
Download docs/plan/03-interaction.md from JuanCS-Dev/twitch-byte-bot: direct link, hf CLI and curl.
- Browser
- Download file 2.93 kB
-
https://huggingface.co/spaces/JuanCS-Dev/twitch-byte-bot/resolve/main/docs/plan/03-interaction.md
- Command line
-
hf download hf://spaces/JuanCS-Dev/twitch-byte-bot/docs/plan/03-interaction.md
-
curl -L -o 03-interaction.md https://huggingface.co/spaces/JuanCS-Dev/twitch-byte-bot/resolve/main/docs/plan/03-interaction.md
2.93 kB
| # Fase 3 — Interação (o viewer sente) · Tier B | |
| **Objetivo:** o público interage diretamente com o Byte. Contém o **MVP do "uau"** (3.1 + Fase 2.1). | |
| ## Tarefas | |
| - **3.1 Channel Points → Byte fala** ⭐ — handler EventSub `channel.channel_points_custom_reward_redemption.add` em `eventsub_runtime.py` (subscription no `setup_hook`) → **risk queue** existente (`control_plane`, anti-abuso) → `voice_runtime`. | |
| - **3.2 Memória de regulars** — saudação por nome de quem volta, via `persistence_semantic_memory_repository` (após Fase 1.3). | |
| - **3.3 Segmentos/bits** — segmentos (trivia, "pergunte ao Byte", marcos de hype) como `ops_playbooks` (máquina de estados auditável); gatilho no `/studio`. | |
| ## Testes científicos | |
| `bot/tests/scientific/test_phase28_interaction_scientific.py` — prova: redemption vira item de risk queue e só fala após aprovação/política; saudação de regular usa memória persistida e não repete; playbook de segmento transita estados corretamente. Estende `suite_irc_control.py`, `suite_recap.py`. | |
| ## Meta-Reflexão (2026-06-29) | |
| Os 3 módulos foram construídos e testados; a **ativação ao vivo** de cada um depende de infra/modo (documentado abaixo), por isso não foram fiados nos hot paths do bot em produção (risco não-validável). | |
| **3.3 Segmentos — ✅ CONCLUÍDA e LIVE.** `segments_runtime` + `/api/segments` + `/api/segments/run`. Validação e2e ao vivo: `POST /api/segments/run {hype}` → linha entrou na fila de voz (`source=segment`). Testes: `test_phase28` (known→fala, unknown→lista, rotas). | |
| **3.1 Channel Points — ✅ código pronto + testado.** `channel_points_runtime.process_redemption`: voice reward → voz; outros → risk queue (anti-abuso). Testes provam os 3 caminhos. **Ativação:** `TWITCH_CHAT_MODE=eventsub` + scope `channel:read:redemptions` + subscription de redemption no `setup_hook` chamando `process_redemption`. | |
| **3.2 Regulars — ✅ código pronto + testado.** `regulars_runtime.note_chatter`: first-timer não saúda; retorno após gap → saúda 1x; chat contínuo não re-saúda. **Ativação:** chamar `note_chatter` no handler de mensagem (IRC/eventsub) e mandar a saudação via voz/chat; memória persistente entra com Supabase (Fase 1.3). | |
| **Go:** ✅ código concluído. Abuso de redemption é contido (voice reward limita 200 chars + sanitiza; não-voz vai pra fila). Memória de regulars é por sessão (in-memory, com eviction LRU), respeitando isolamento por canal. | |
| > ⚠️ **Status honesto (ver [VALIDATION_REPORT](../VALIDATION_REPORT_2026-06-29.md)):** `channel_points_runtime` e `regulars_runtime` são **lógica testada, NÃO wiradas** (0 refs de produção). Ativação pendente de ambiente validável (EventSub mode + scope de redemptions; hook no caminho de mensagens). Não foram injetadas nos hot paths do bot live sem validação — decisão de integridade pro backend "relógio suíço". | |