twitch-byte-bot / docs /plan /03-interaction.md
JuanCS-Dev's picture
Deploy: streamer Stream Deck dashboard at /studio
ea7430b verified
|
Raw History Blame Contribute Delete
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".