Files
MateuusandClaude Opus 5.5 dbb5e8ef92 Sincronização: detecção do jogo + revisão/final, dublagem, falantes, expressões e Equipe de IA
Conflitos resolvidos juntando os dois lados:
- db.py: v16 (detecção do jogo) e v17 (Equipe de IA) em sequência.
- judge.py: a varredura exige os campos das duas frentes (screen_game_confidence/screen_evidence e lines).
- proxy do painel: libera judge/report e sessions/id/game/detect.
- skill: detecção do jogo vira a 1.55.0 (gotcha 180 → 186), acima da 1.54.0 das cinco frentes.

Suíte do Clipador inteira passa; painel: tsc + 119 testes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 05:11:47 -03:00
..
2026-11-17 16:35:09 -03:00
2026-11-17 16:35:09 -03:00

Painel CenaForge

Painel local (Next.js 16.4 + React 19 + TypeScript + Tailwind 4) para trabalhar com várias histórias, cada uma com seus episódios, assets e votação A/B nos comentários, e para mandar pedidos aos agentes de código (Claude Code e Codex) pela CLI, como no VS Code.

pnpm install          # na raiz do repositório
pnpm panel            # http://127.0.0.1:4500

Só escuta em 127.0.0.1. Não há login: é uma ferramenta local.

O que tem

Página Para quê
Dashboard (/dashboard) Totais e desempenho por rede, conta, história e episódio (melhores e piores), views por dia, filtro por conta. Enquanto não há integração com as redes, os números são simulados (selo visível; gerar/apagar).
Histórias (/) Criar e listar histórias: interativa (o público escolhe entre 2–4 vertentes por episódio, "Vertentes por decisão"), linear ou documental (vídeo único sobre fatos reais, com nomes reais e fontes). Regras de roteiro de cada formato: doc/roteiro/. Excluir (lixeira no cartão ou no topo da história): os arquivos vão para data/trash/.
História (/stories/<id>) Abas Episódios (estágios, assets, envio), Fluxo (árvore estilo n8n: início, vertentes candidatas/escolhidas/descartadas, "Preparar vertentes" com a IA) e Canais de publicação que publicam a história.
Canais de publicação (/accounts) Cada canal agrupa perfis de YouTube, TikTok e Instagram, conectados por API oficial ou sessão logada, e se liga a histórias e a fontes do Clipador; regras de aprovação e horário por canal.
Publicações (/publishing) Fila de publicação: aguardando aprovação, agendadas, publicando, publicadas e com problema.
Configurações (/settings) Pausar publicações, horários bons por rede, apps das redes (Client ID/Secret) e navegador do modo sessão.
Episódio (/stories/<id>/episodes/<n>) Roteiro, cena (chamada e opções), render prévia/final com player, comentários, apuração e fechamento da votação, criação do próximo episódio a partir da escolha vencedora.
Assets (/assets) Biblioteca compartilhada e assets exclusivos de cada história; envio e promoção para a biblioteca.
Vozes (/voices) Estado do serviço de voz (GPU/CPU e motivo), ouvir cada voz com velocidade, adicionar/remover voz de personagem (RVC: .pth + .index, origem e licença obrigatórias), testar legenda (texto, frases ou palavras; baixa .srt) e configurações (dispositivo, Whisper, RVC). Fala com voice/ (127.0.0.1:4510) por /api/voice/*; detalhes em voice/README.md.
Editor de corte (/clipper/edit/<id>) Tela cheia (sem o menu lateral), aberto pelo botão "Editar" do cartão do corte no Clipador. O corte chega com o projeto que a IA montou (gancho, legenda pop, zoom no pico, silêncios). Você ajusta o trecho pela transcrição ou pela timeline, legenda animada, textos, zoom, narração, música e capa, e exporta. Detalhes em clipper/README.md.
Agente (/agent) Pedido para Claude ou Codex, com tarefa (livre, roteiro, cena), modelo e contexto (história/episódio). Saída ao vivo, custo, cancelar, continuar a conversa, histórico.

Onde ficam os dados

O quê Onde
Metadados e estado (histórias, episódios, renders, assets, comentários, decisões, execuções de agente) data/cenaforge.db (SQLite via node:sqlite, embutido no Node 24; ignorado pelo Git)
Logs de agentes e renders data/logs/
Roteiros stories/<história>/biblia.md, stories/<história>/epNN.md
Cena renderizável config/<história>-epNN.json
Assets da história stories/<história>/assets/<tipo>/<asset-id>/ (arquivo + asset.json)
Biblioteca de assets assets/library/<tipo>/<asset-id>/
Vídeos output/runs/ (gerados pelo lançador pnpm render)
Vertentes de um episódio stories/<história>/<file_key>.md (ex.: ep02-b.md), opções em <file_key>.choices.json, cena em config/<história>-<file_key>.json
Backups antes de migrar o banco data/backups/
Configuração da voz voice/.env (chave, porta, dispositivo, Whisper, RVC)
Pesos de voz e vozes de personagem data/voice/models/ (Piper, Whisper, rvc/<id>/) e data/voice/user-voices.json

Agentes (Claude / Codex)

  • O painel chama a CLI no servidor com cwd = raiz do repositório e o pedido como argumento, sem shell e com a entrada padrão fechada.
  • Claude: claude -p … --output-format stream-json --verbose --permission-mode acceptEdits --allowedTools …. Edição automática só dentro do projeto. Bash só para os comandos liberados em src/lib/agents.ts (CLAUDE_ALLOWED_TOOLS): render, verify, testes, typecheck, doctor e scripts da skill. "Continuar conversa" usa --resume <sessão>.
  • Codex (codex-cli 0.169.0, npm install -g @openai/codex@0.169.0 e codex login): codex exec --json --skip-git-repo-check --sandbox workspace-write -C <raiz>. O repositório não é Git, por isso --skip-git-repo-check. "Continuar conversa" usa codex exec resume <sessão> com -c sandbox_mode="workspace-write", porque a retomada não aceita --sandbox/-C. No Windows o npm instala codex.cmd, e o painel executa o codex.js do pacote pelo Node. O Codex informa tokens, não custo em US$. O Codex lê o AGENTS.md da raiz, que remete ao CLAUDE.md.
  • Um agente por vez; cancelar encerra a árvore de processos.
  • Modelo: escolhido no console e no "Nova história com IA". A lista do Codex vem do cache da própria CLI (~/.codex/models_cache.json), e o padrão é o model do ~/.codex/config.toml. No Claude, as tarefas cena e vertentes usam Sonnet 5.5 por padrão; as demais usam o padrão da CLI. O custo de cada execução aparece no histórico (o Codex informa tokens, não US$).
  • Comentários do público nunca entram no prompt. Só a escolha A/B já fechada.

Votação

Regra (src/lib/decisions.ts):

  • 1 voto por conta, e vale o último voto explícito.
  • Só conta comentário que começa com A ou B ("A", "opção B", "B!", "voto no A").
  • Comentário que cita as duas opções é ambíguo e não conta.
  • Empate ou zero votos exigem decisão manual com justificativa.

Fechar a votação grava uma fotografia imutável (decisions.snapshot_json), e o próximo episódio herda a escolha vencedora. Por enquanto, os comentários são colados no painel (autor: texto); a integração com o Instagram é fase futura.

Limitações atuais

  • A cena Godot ainda usa só o cenário de rua e o entregador provisório. Assets enviados ficam catalogados, mas ainda não são carregados pela Godot: é o próximo passo, com o nó adaptador de GLB.
  • Sem testes automatizados do painel nesta versão. A lógica foi testada por script (ver doc/TEST_RESULT.md).
  • Porta 4500. Convenção do projeto: serviços locais do CenaForge usam a faixa 4500–4599, para não conflitar com outros projetos da máquina.