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): 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".