Spaces:
Sleeping
Sleeping
| # Planos do Byte | |
| - **[Co-Streamer](#plano-de-implementação--byte-co-streamer)** (este doc) — vê/fala/comenta/aparece. | |
| - **[Studio Dashboard State-of-the-Art](studio-state-of-the-art.md)** — evoluir o `/studio` pra referência. ✅ S0–S6 concluído. | |
| - **[Ops Dashboard Redesign](ops-dashboard-redesign.md)** — `/` ops com a identidade do studio + mascote reativo maior + wow vendável. (base: [auditoria validada](../OPS_DASHBOARD_AUDIT_2026-06-29.md)) | |
| --- | |
| # Plano de Implementação — Byte Co-Streamer | |
| Roteiro faseado que converte a [auditoria](../DEEP_AUDIT_2026-06-29.md) + o [report do co-streamer](../CO_STREAMER_REPORT_2026-06-29.md) em execução. Cada fase entrega **código + testes científicos + Meta-Reflexão**. | |
| ## Fases | |
| | Fase | Doc | Estado | | |
| | :--- | :--- | :--- | | |
| | 0 — Fundação (suíte hermética) | [00-foundation.md](00-foundation.md) | ✅ concluída (1057 verde, 85% cob.) | | |
| | 1 — Ativar o dormente | [01-activate-dormant.md](01-activate-dormant.md) | ✅ código: 1.2 visão LIVE · 1.1 verificado · 1.3/1.4 = credenciais | | |
| | 2 — Expressão (voz + presença) | [02-expression-voice-presence.md](02-expression-voice-presence.md) | ✅ LIVE (2.1 voz · 2.2 avatar · 2.3 comentário) | | |
| | 3 — Interação | [03-interaction.md](03-interaction.md) | ✅ código: 3.3 segmentos LIVE · 3.1/3.2 testados (ativação documentada) | | |
| | 4 — Produção & crescimento | [04-production-growth.md](04-production-growth.md) | ✅ código: 4.2 recap + 4.3 churn LIVE · 4.1 highlights testado | | |
| ## ✅ PLANO CONCLUÍDO (código) | |
| Todo o código das 5 fases está implementado, testado (**1057 testes verdes, 85% cobertura, suíte hermética**) e deployado. As superfícies que não dependem de infra externa estão **LIVE e validadas** (`/studio`, `/capture`, `/voice`, `/avatar`, `/recap`, segmentos, churn). O que resta é **configuração de operador**, não código. | |
| ### Checklist de operador (ativa o que falta) | |
| | Ação | Destrava | | |
| | :--- | :--- | | |
| | Secret `TTS_API_KEY` (ElevenLabs) | voz/comentário/segmentos viram **áudio** (hoje legenda) | | |
| | OBS browser sources `…/voice?token=X` e `…/avatar?token=X` + abrir `…/capture` | presença na live | | |
| | `SUPABASE_URL/KEY` (1.3) | persistência + memória de regulars (3.2) | | |
| | Re-auth Twitch scope `editor:manage:clips` (1.4) | clipes + auto-highlights (4.1) | | |
| | `control_plane.update_config({"autonomy_enabled": True})` (1.1) | autonomia proativa (+ highlights no loop) | | |
| | `TWITCH_CHAT_MODE=eventsub` + scope `channel:read:redemptions` + subscription (3.1) | Channel Points → Byte fala | | |
| ⚠️ **Segurança pendente** (do audit): rotacionar tokens Twitch versionados em `docs/` (a re-auth de clipes já gera novos). | |
| ## Princípios (todas as fases) | |
| 1. **Testes científicos comportamentais** — convenção `bot/tests/scientific/test_phaseN_*_scientific.py` + `suite_*.py`; valida contratos, não implementação. Novas fases = Phase 26+. | |
| 2. **Provider-neutral** — serviços externos seguem o padrão `LLM_PROVIDER` (`bot/config.py`). | |
| 3. **Reaproveitar módulos existentes** — sem reescrever o que já está pronto. | |
| 4. **Overlays pelo dashboard_server** — padrão `/studio` (`_dashboard_asset_route` + assets sob `dashboard/`). | |
| 5. **Validação ao vivo** — playwright/curl após deploy. | |
| ## Protocolo de Meta-Reflexão (fim de CADA fase) | |
| Registrar o resultado na seção "Meta-Reflexão" do doc da fase: | |
| 1. **Re-derivar** os comportamentos esperados da fase — listar. | |
| 2. **Rastreabilidade comportamento↔teste** — cada comportamento aponta o teste que o prova. Sem teste = lacuna. | |
| 3. **Rodar** suíte da fase + suíte completa: termina (hermética) e verde. | |
| 4. **Caça a regressão** — nada antes ativo quebrou; nada dormente ligado sem guardrail. | |
| 5. **Validação ao vivo** — evidência real, não suposição. | |
| 6. **Go/No-Go** — registrar lacunas e decisão. | |