Painel: ordenar fila de cortes, horário específico ao publicar e capas preservadas

Clipador (fila de cortes)
- Seletor "Ordenar": mais novos, mais antigos, maior/menor nota da IA, sinal
  mais forte e mais longos; a escolha fica lembrada no navegador.
- A fila abre filtrada pela sessão que está gravando.
- Gancho automático logo abaixo da câmera e legenda desviada enquanto o gancho
  a cobriria; posição do gancho editável no painel.

Publicação
- "Publicar este corte" ganha "Horário específico": um dia e hora para todas
  as redes ou um diferente por rede (timing "at" + scheduledAt por rede na rota
  POST /api/publishing/clips/[id]), com validação e testes.
- Capa do vídeo publicado copiada para output/publishing/covers/: apagar a
  sessão no Clipador não quebra mais a miniatura do dashboard; jobs antigos
  migram no ciclo de sincronização.
- Dashboard só usa capa que existe no disco; corrige a regex do número do
  episódio (link do episódio).
- Canais de publicação: seletor compacto de canais e detalhe reorganizado.
- Publicador: confirmação pela página pública quando o YouTube Studio fica com
  a caixa de envio aberta; estatísticas por rede.

Skill cenaforge 1.44.0 com as regras e a armadilha das capas.

Testes: painel 68/68, Clipador 279, Publicador 84.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 19:54:13 -03:00
co-authored by Claude Opus 5.5
parent 84f30bbc2d
commit f165659e4e
30 changed files with 1174 additions and 370 deletions
+26
View File
@@ -7,6 +7,32 @@ Versão semântica da **skill** (não do projeto):
Mantido pelo subagente `cenaforge-skill-updater`. Entradas mais novas no topo.
## 1.44.0 — 17/11/2026
Ordenação da fila de cortes, "Horário específico" ao publicar corte e capa que sumia do dashboard.
- `references/panel.md`: "Ordenar a fila" (`QUEUE_SORTS`, `useQueueSort`, chave `cenaforge.clipper.queueSort`).
- `references/publishing.md`: regra "Horário específico" (`timing: "at"`, `scheduledAt` por rede, `ClipTiming`,
`readChosenTimes`, `preferredAt`, `toLocalInput` exportado) e regra da capa copiada para `output/publishing/covers/`.
- `references/gotchas.md`: item 155 (capa sumia ao apagar sessão; recuperar pela miniatura `oar2.jpg`; regex `/^ep(\d+)/i`).
- `SKILL.md`: versão, `description` e resumo de armadilhas.
- Evidência: conferido no código (`publishing.ts`, `clipper-queue.tsx`, `publishing-client.ts`). Informados, não
reexecutados: painel 68/68. Não verificado: envio real agendado por "Horário específico".
## 1.43.0 — 17/11/2026
Confirmação de publicação no YouTube Studio, números dos posts no Dashboard, botão "Publicar no <rede>" e repositório git.
- `references/publishing.md`: regra "YouTube Studio: confirmar a publicação" (`wait_enabled`, `confirm_published`, reclique
único); seção "Números dos posts" (rota `/v1/profiles/{id}/stats`, leitura por rede com o medido em 17/11/2026,
`parse_count`, migração v8 `metric_syncs`, `metrics-sync.ts`, `metricsEveryHours`, UI); seção do botão "Publicar no
<rede>" em `publishing-board.tsx`; banco até v8.
- `references/gotchas.md`: itens novos 151 (YouTube não confirmou), 152 (Instagram: grade antes da API), 153 (`curl -d` com
acento), 154 (repositório público Gitea, segredos); CRLF do painel ligado ao item 63.
- `SKILL.md`: versão, `description` (números dos posts, YouTube não confirmou, botão Publicar), esquema v8, linha de
publicação, resumo de armadilhas.
- Evidência: `pnpm test:publisher` → 83 passed (reexecutado). Informados, não reexecutados: `test:panel` 66/66, typecheck,
medições com conta real. Não verificado: confirmação do YouTube num envio real; leitura automática com o painel ao vivo;
precisa reiniciar o `pnpm dev`.
## 1.42.0 — 17/11/2026
Instagram sem corte quadrado, corte sem rótulo de IA e ação "Apaguei na rede".
+7 -5
View File
@@ -1,11 +1,11 @@
---
name: cenaforge
description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude/Codex) no painel, mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo editável/refinável pela IA, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge".
description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude/Codex) no painel, mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo editável/refinável pela IA, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada e com "Horário específico" por rede, ordenar a fila de cortes, capa que sumiu do dashboard, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou, YouTube Studio que "não confirmou" a publicação, botão "Publicar no <rede>" nos cartões de Publicações), números dos posts (views, curtidas, comentários) lidos das redes e mostrados no Dashboard (leitura automática a cada N horas, "Atualizar números agora"), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge".
---
# CenaForge — vídeo a partir de cena descrita por JSON
**Versão da skill: 1.42.0** (17/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md).
**Versão da skill: 1.44.0** (17/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md).
Mantida pelo subagente `cenaforge-skill-updater` (ver "Manutenção" no fim).
## Regra zero
@@ -59,7 +59,7 @@ outra, teste olhando o `inspect/`); detalhes em [references/panel.md](references
| Opções do episódio (A–D) | `stories/<história>/<file_key>.choices.json` |
| Cena do episódio | `config/<história>-<file_key>.json` (ex.: `new_scene.py --id <história>-ep02`) |
| Assets da história / biblioteca | `stories/<história>/assets/<tipo>/<id>/` · `assets/library/<tipo>/<id>/` (cada um com `asset.json`) |
| Estado (episódios, vertentes, votos, canais de publicação, fila de publicação, métricas, execuções) | `data/cenaforge.db` (esquema v7; backup antes de migrar em `data/backups/`), gerido pelo painel (`panel/`, http://127.0.0.1:4500) — detalhes em [references/panel.md](references/panel.md) |
| Estado (episódios, vertentes, votos, canais de publicação, fila de publicação, métricas, execuções) | `data/cenaforge.db` (esquema v8; backup antes de migrar em `data/backups/`), gerido pelo painel (`panel/`, http://127.0.0.1:4500) — detalhes em [references/panel.md](references/panel.md) |
| Serviço de voz | `voice/` (http://127.0.0.1:4510); clonagem em `voice/clone/worker.py` (127.0.0.1:4511, venv `voice/.venv-clone`); pesos e estado em `data/voice/` |
| Clipador (cortes de live) | `clipper/` (http://127.0.0.1:4520); banco e blocos em `data/clipper/`, cortes em `output/clipper/<sessão>/` — ver [references/clipper.md](references/clipper.md) |
| Publicador (envio às redes) | `publisher/` (http://127.0.0.1:4530); dados em `data/publisher/` — ver [references/publishing.md](references/publishing.md) |
@@ -110,7 +110,7 @@ Interativa = 2–4 vertentes, mas o overlay só desenha `choiceA`/`choiceB`. Tab
| Serviço de voz (TTS, RVC, transcrição, Azure, clonagem) | `voice/app/` (`engine.py`, `catalog.py`, `config.py`, `errors.py`, `rvc.py`, `stt.py`, `main.py`) · worker `voice/clone/worker.py` | `voice/tests/`, `voice/README.md` |
| Vozes padrão / pesos baixados | `voice/voices/catalog.json` / `voice/models.lock.json` (URL fixada em commit + sha256) | `voice/README.md` |
| Instalação / subida | `setup.bat` → `scripts/setup.ps1` (UTF-8 com BOM; passo 6b = Clipador, 6b2 = Publicador) · `start.bat` → `scripts/dev.ts` | `README.md` |
| Publicação nas redes (Publicador, despachante, canais de publicação, fila, Configurações) | `publisher/app/` · `panel/src/lib/` (`publisher.ts`, `publishing.ts`, `publishing-rules.ts`, `dispatcher.ts`, `settings.ts`) · `panel/src/instrumentation.ts` · botão "Publicar" do corte `components/clip-publish.tsx` — tabela em [references/publishing.md](references/publishing.md) | `publisher/tests/`, `panel/src/lib/publishing-*.test.ts`, `doc/publicacao/PLANO.md` se mudar o contrato |
| Publicação nas redes (Publicador, despachante, canais de publicação, fila, Configurações) | `publisher/app/` · `panel/src/lib/` (`publisher.ts`, `publishing.ts`, `publishing-rules.ts`, `dispatcher.ts`, `settings.ts`) · `panel/src/instrumentation.ts` · botão "Publicar" do corte `components/clip-publish.tsx` · números dos posts: `publisher/app/platforms/stats.py` + `session/stats.py`, `panel/src/lib/metrics-sync.ts`, `metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx` — tabela em [references/publishing.md](references/publishing.md) | `publisher/tests/` (`test_stats.py`), `panel/src/lib/publishing-*.test.ts`, `doc/publicacao/PLANO.md` se mudar o contrato |
| Localizar executáveis / encoders | `scripts/lib/tools.ts` | [references/tools.md](references/tools.md) |
| Painel: páginas, API, votação, agentes (prompt por provedor, lista de modelos `models()`, mensagem durante a execução `sendFollowUp`) | `panel/src/app/`, `panel/src/lib/` (`agents.ts`, `prompts.ts`, `decisions.ts`, `assets.ts`, `renders.ts`); console em `components/agent-console.tsx` | `panel/README.md`; `AGENTS.md` se mudar regra do Codex |
| Painel: página Vozes (`/voices`) | servidor `panel/src/lib/voice.ts` + `panel/src/app/api/voice/*`; cliente `panel/src/components/voice-*.ts(x)` (`voice-client.ts` tipos e `uploadWithProgress`; `voice-cards.tsx` catálogo e filtros; `voice-clone-form.tsx`; `AzureForm` em `voice-studio.tsx`) | `voice/README.md` se mudar o contrato; largura de `Select`/`Input`: gotchas item 62 |
@@ -220,7 +220,9 @@ início do processo com o `LastWriteTime` do arquivo antes de validar (143)**; l
do jogo sem `hashtags` (144); Instagram em modo sessão com "não achei o botão" (o botão agora é "Postar" e os botões do
fluxo ficam presos ao diálogo, 145) e rótulo de IA coberto pela lista de hashtags (sem `force=True`, 146; valide seletor
com `prepare`, sem publicar); reel do Instagram saindo 1:1 (formato "Original" em `keep_original_shape`, 147); corte nunca leva
rótulo de IA (148); vídeo apagado na rede: ação "Apaguei na rede" (149); script `python -I` ignora `PYTHONIOENCODING` (150).
rótulo de IA (148); vídeo apagado na rede: ação "Apaguei na rede" (149); script `python -I` ignora `PYTHONIOENCODING` (150); YouTube "não confirmou" mas o vídeo saiu (`ytcp-button`, 151);
números do Instagram sem curtidas (grade antes da API, 152); `curl -d` com acento no Git Bash (153: `--data-binary @arquivo`);
repositório Gitea PÚBLICO: procure segredos antes de subir, commit só a pedido (154); capa de vídeo publicado some ao apagar a sessão do Clipador (155: cópia em `output/publishing/covers/`); `.tsx`/`.ts` do painel em CRLF (63).
## Manutenção desta skill
+33 -2
View File
@@ -3,7 +3,7 @@
Cada item: **sintoma → causa → correção → onde está tratado**. Observadas na implementação da
prova de conceito com Godot 4.7.2 / FFmpeg 7.1.1 / pnpm 11.22 (16/11/2026). Registro formal em
`doc/TEST_RESULT.md`: itens 1–5, 7, 13–15, 17 e 18; itens 30–33 estão em `voice/README.md`
("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação.
("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação.
Ao descobrir uma nova, registre aqui via `cenaforge-skill-updater`. Os números são estáveis
(outros textos os citam): item novo entra na seção do assunto com o próximo número livre.
@@ -693,9 +693,40 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md).
Usada no job 3 (Instagram do corte 68). Teste em `publishing-db.test.ts`.
150. **Script Python de diagnóstico com `-I` imprime `?`/falha ao escrever acentos no Windows.** `python -I` ignora
`PYTHONIOENCODING` e `PYTHONUTF8`. Correção: no script, `sys.stdout.reconfigure(encoding="utf-8")`.
151. **YouTube Studio (modo sessão): "Cliquei em Publicar mas o YouTube Studio não confirmou", e o vídeo saiu.** Sintoma
(17/11/2026): a captura 60 s depois do clique mostrava a caixa de envio ainda aberta, com o botão Publicar. Causa
provável (não isolada): `#done-button` é um `ytcp-button`, não `<button>` nativo; o Playwright clica nele mesmo
desativado e o clique se perde. Correção: `is_enabled`/`wait_enabled` (lê `disabled`/`aria-disabled` do elemento e do
`<button>` interno; espera até 10 min), `dismiss_tips` + `click_through` antes de clicar e `confirm_published` (45
checagens de 2 s; aceita "publicado", "sendo processado" ou a caixa fechar; se o botão segue liberado depois de ~16 s,
clica de novo UMA vez). O erro final traz o link visto antes do clique: confira na rede e use "Já saiu: informar o
link" (nunca "Tentar de novo" sem conferir). Teste: `test_youtube_confirms_when_upload_box_closes_and_retries_once`.
Só vale depois de reiniciar o `pnpm dev` (item 143). Onde: `publisher/app/platforms/session/youtube_studio.py`.
152. **Números do Instagram vêm só com views (curtidas e comentários faltando).** Causa: a grade da aba Reels aparece ANTES
da resposta de `/api/graphql`; parar ao achar a grade perde `like_count`/`comment_count`. Correção: a API tem
prioridade e a grade só entra como reserva depois de 3 voltas (`instagram_stats`, `session/stats.py`). TikTok e
Instagram não têm leitura sem janela logada (página pública devolve só verificação ou nada). Ver [publishing.md](publishing.md).
153. **Corpo JSON com acento por `curl -d` no Git Bash chega com UTF-8 inválido** (`jsontext: invalid UTF-8`). Correção:
gravar o corpo num arquivo (scratchpad) e enviar com `--data-binary @arquivo`, com `Origin` e `Content-Type` (item 125).
154. **Publicar o repositório (Gitea) expondo segredo ou e-mail pessoal.** O projeto é PÚBLICO em
`https://git.origininteractivestudios.com/Mateuus/CenaForge` (Gitea 1.27.3; 1º commit `84f30bb`, 484 arquivos,
~7,4 MB, 17/11/2026). Fora do git: `data/`, `.env`, venvs (inclui `publisher/.venv/`) e `output/`. Commits neste
repositório usam o e-mail noreply do Gitea (`git config` local). Antes de subir: procurar segredos (chave do serviço do
Publicador, tokens, e-mails) nos arquivos que vão. Commit e push só quando o dono pedir.
155. **Capa do vídeo publicado some do dashboard ("Views de cada vídeo") com imagem quebrada.** Causa: apagar uma sessão no
Clipador (`worker.delete_session`) faz `rmtree` de `output/clipper/<sessão>/`, levando vídeo e capa, e
`publish_jobs.cover` apontava para lá. Correção (17/11/2026): `clipCover()` copia a capa para
`output/publishing/covers/clip-<id>.<ext>` (pasta só do painel, `keepCover`); `keepClipCovers()` migra jobs antigos no
início de `syncClips` enquanto o arquivo existe (22 de 25 na hora); `metrics.ts` só devolve capa que existe no disco.
Capa já perdida: a miniatura do próprio Short serve, `https://i.ytimg.com/vi/<remote_id>/oar2.jpg` é a vertical
1080×1920 (`maxresdefault` é 1280×720 horizontal); foi o que se fez no corte 91. Junto: em `metrics.ts` a regex do
episódio era `/^ep(d+)/i` (faltava a barra) e o link ia só para a história; agora `/^ep(\d+)/i`. Onde:
`panel/src/lib/publishing.ts`, `panel/src/lib/metrics.ts`.
Relacionadas, já registradas acima:
- Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`,
`app/dashboard/page.tsx`): item 63 — uma substituição com "\n" não acha o trecho; normalize e grave de volta em CRLF.
- `codex.cmd` sem shell: item 28.
- Script de patch com regex (`\b`) passado por heredoc: item 44.
- Publicador roda sem `--reload`: mudança em `publisher/app/` só vale depois de reiniciar o `pnpm dev` (itens 137, 139, 140, 142, 143, 145 e 147; o Clipador também: 144).
- Migração do painel (v3 … v7) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).
- Migração do painel (v3 … v8) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).
@@ -360,6 +360,10 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos).
- `clipper-queue.tsx`: cartão do corte mostra a análise do juiz e recua/avança o início (`START_STEPS`
−30/−10/−5/−2/+2 s). `clipper-judge.tsx`: modelos do editor e do analista, varredura, visão, câmera.
- **Ordenar a fila** (`clipper-queue.tsx`, seletor "Ordenar" ao lado do filtro de sessão; `QUEUE_SORTS`, `useQueueSort`):
Mais novos (padrão, id desc), Mais antigos, Maior/Menor nota da IA (`judge.score` 0–10; corte sem nota vai sempre para
o fim), Sinal mais forte (`clip.score`), Mais longos (`durationS`); desempate: mais novo. Só reordena no navegador; a
escolha fica em `localStorage` na chave `cenaforge.clipper.queueSort`.
- `clipper-queue.tsx` também tem o botão "Editar" (ou "Continuar edição" se `edit.origin === "user"`) que abre o
editor.
- **Apagar na fila** (`clipper-queue.tsx`; regras do serviço em [clipper.md](clipper.md#apagar-cortes-clip_deletepy)):
@@ -37,7 +37,7 @@ Painel (4500) = cérebro ──► Publicador (4530) = executor ──► YouTub
| Regras puras (horário bom, limite, ações do job, sincronização de cortes, leitura do resultado, reencaixe, idempotência) | `panel/src/lib/publishing-rules.ts` (`placeJob`, `nextFreeSlot`, `planClipSync`, `readPublisherJob`, `jobActions`, `aiGeneratedFor`, `tagsFromCaption`, `needsReflow`/`STALE_AFTER_MS`, `clientRefFor`, `mayBeLive`, `parseVideoUrl`) + `publishing-rules.test.ts` |
| Fila, aprovação, envio, episódio | `panel/src/lib/publishing.ts` (`approveJob`, `placeApproved`, `retryJob`, `sendDue`, `promoteDue`, `pollPublishing`, `finishFromPublisher`, `markPublished`) + `publishing-db.test.ts` |
| Pausar tudo, horários bons, fuso | `panel/src/lib/settings.ts` (tabela `app_settings`) |
| Banco | `panel/src/lib/db.ts`: **v5** (`account_networks` reconstruída sem `mock`, `publish_jobs`, `publications` com `clip_id`/`job_id`, `app_settings`, `clip_auto_approvals`, colunas novas em `accounts` e `episodes`), **v6** (`publish_jobs` reconstruída: `schedule_source` `auto`/`manual`/`now`, `cancel_reason` aceita `unlinked`) e **v7** (`publish_jobs.origin` `link`/`manual`, padrão `link`) |
| Banco | `panel/src/lib/db.ts`: **v5** (`account_networks` reconstruída sem `mock`, `publish_jobs`, `publications` com `clip_id`/`job_id`, `app_settings`, `clip_auto_approvals`, colunas novas em `accounts` e `episodes`), **v6** (`publish_jobs` reconstruída: `schedule_source` `auto`/`manual`/`now`, `cancel_reason` aceita `unlinked`), **v7** (`publish_jobs.origin` `link`/`manual`, padrão `link`) e **v8** (`metric_syncs`) |
| "Publicar" no cartão do corte (sem fonte ligada) | UI `panel/src/components/clip-publish.tsx` (`ClipPublishButton` + diálogo; usado em `clipper-queue.tsx`, em `approved` e, como "Publicar em outra rede", em `published`; `useClipPublishing().reload()`); cliente `publishClip` em `publishing-client.ts`; rota `POST /api/publishing/clips/[id]` (`app/api/publishing/clips/[id]/route.ts`); servidor `publishClip` em `publishing.ts` |
| Guarda da API do painel | `panel/src/proxy.ts` (Next 16: o middleware se chama `proxy`; `checkRequest` exportado) + `proxy.test.ts`; `readJson` em `panel/src/lib/http.ts` (415 sem JSON) |
| Rotas | `/api/settings` e `/api/settings/apps/[platform]`, `/api/publisher/status`, `/api/publishing/jobs[/[id][/[action]]]`, `/api/publishing/summary`, `/api/episodes/[id]/approve`, `/api/accounts/[id]/networks/[platform]/(connect|token|check|reopen|creator-info)` |
@@ -75,12 +75,24 @@ No texto visível do Clipador "Canais" virou **"Fontes"**; código, tabelas e ro
cortes do intervalo desligado). Cancelar no meio de um ciclo vale (UPDATEs condicionais; se o Publicador já criou o
envio, o painel cancela lá). Aprovação automática é registrada em `clip_auto_approvals` antes do PATCH no Clipador.
- **Botão "Publicar" do corte** (`POST /api/publishing/clips/<id>`, corpo `{accountId, platforms[], timing?: "now"|"best_slot"}`,
resposta `{jobs, skipped[{platform, reason}], placed}`; `publishClip`): serve para corte aprovado cuja fonte **não** está
resposta `{jobs, skipped[{platform, reason}], placed}`; `publishClip`; `timing` também aceita `"at"`, ver abaixo): serve para corte aprovado cuja fonte **não** está
ligada a canal (`account_channels`) ou para outra rede. O clique é a aprovação humana. `timing` omitido = o do canal.
`"now"` força `queued` com `schedule_source='now'` e ignora o limite do dia. Job existente cancelado, `failed` ou
`needs_login` é reaproveitado (`attempts`+1 via `placeApproved`, que ganhou `opts.timing`); rede não conectada,
pausada, já publicada, na fila, agendada, enviando ou "pode ter saído" (`mayBeLive`) entra em `skipped` com motivo.
O diálogo lista essas redes bloqueadas com o motivo. Título e legenda são os do cartão.
- **"Horário específico"** no diálogo do corte: `timing: "at"` + `scheduledAt: { youtube?, tiktok?, instagram? }` (ISO, um
por rede escolhida, obrigatório para cada uma). `ClipTiming = PublishTiming | "at"` (`publishing.ts` e
`publishing-client.ts`; o "quando sai" do canal continua `now|best_slot`). `readChosenTimes` ⇒ `UserError` em português
para rede sem horário, horário passado (> 1 min) ou além de 1 ano. `placeApproved` com `preferredAt` (mínimo agora+5 s)
⇒ `scheduled`, `schedule_source 'manual'`, "Agendado por você."; ignora horário bom e limite do dia (como "now"). Rede
já `scheduled`/`queued` sem `publisher_job_id` é reagendada. UI: terceira opção, `datetime-local` (sugestão: próxima
hora cheia ≥ 30 min, horário do navegador); com mais de uma rede, "Horário diferente para cada rede". `toLocalInput()`
agora é export de `publishing-client.ts`. Testes: 2 em `publishing-db.test.ts` ("horário específico: …"); painel 68/68
(informado, `npx tsx --test src/lib/*.test.ts`; não reexecutado).
- **Capa do corte publicado** (gotchas 155): `clipCover()` copia a capa para `output/publishing/covers/clip-<id>.<ext>`
(`keepCover`); `keepClipCovers()` roda no início de `syncClips` e migra jobs antigos; `metrics.ts` só devolve capa que
existe no disco.
- **`publish_jobs.origin`**: `link` (criado pelo vínculo fonte↔canal) ou `manual` (botão "Publicar"). Job `manual` **não**
é cancelado por "fonte desligada" (`planClipSync` com `ExistingJob.origin`, `linkActive`, `accounts.endChannel` só
cancela `origin = 'link'`); corte editado, rejeitado ou apagado ainda cancela o job. Armadilha de migração: gotchas 138.
@@ -116,7 +128,8 @@ No texto visível do Clipador "Canais" virou **"Fontes"**; código, tabelas e ro
- **Primeiro envio real (TikTok, modo sessão, 17/11/2026 13:35):** público, `https://www.tiktok.com/@vortplay/video/7709179978520284437`
(informado; login, upload, legenda, privacidade e "Publicar" funcionaram com conta real). O job terminou `failed` por falta
do link (gotchas 140) e foi marcado como publicado pela rota acima. Seletores do TikTok validados nesse envio; **YouTube e
Instagram em modo sessão: só o ensaio sem publicar (próxima regra); YouTube segue sem validação.**
Instagram em modo sessão: só o ensaio sem publicar (próxima regra). YouTube: o vídeo saiu em envio real, mas o painel não
confirmou (regra "YouTube Studio"); a confirmação nova não foi testada.**
- **Instagram em modo sessão** (`publisher/app/platforms/session/instagram_web.py`; layout novo de 17/11/2026, barra
lateral só de ícones). Fluxo: o botão é `<a>` com `<svg aria-label="Postar">` e abre DIRETO o diálogo "Criar novo
post" (sem submenu; `create_post` só para o layout antigo), com o `input[type=file]` dentro do diálogo.
@@ -153,6 +166,57 @@ No texto visível do Clipador "Canais" virou **"Fontes"**; código, tabelas e ro
roda antes da legenda e antes de "Publicar". `TIP_BUTTONS` só aceita `^(Entendi|Entendido|Ok, entendi|Got it)$`:
**nunca aceitar ou recusar opções por esse caminho**, só fechar avisos. Gotchas 142.
- **YouTube Studio (modo sessão): confirmar a publicação** (`youtube_studio.py`; gotchas 151). O `#done-button` é um
componente `ytcp-button`, não um `<button>` nativo: o Playwright clica mesmo desativado e o clique se perde.
`is_enabled`/`wait_enabled` leem `disabled`/`aria-disabled` do elemento e do `<button>` de dentro e esperam até 10 min;
`dismiss_tips` + `click_through` rodam antes do clique. `confirm_published(page, done, sleep, checks=45, retry_at=8)`
(45 checagens de 2 s) conta como publicado a caixa "Vídeo/Short publicado", "ainda está sendo processado" ou a caixa
de envio fechar (o botão sumir); se o botão continua na tela e liberado depois de ~16 s, clica de novo UMA vez (o
vídeo já existe, não duplica). O erro final traz o link visto antes do clique e manda usar "Já saiu: informar o link".
Teste: `test_youtube_confirms_when_upload_box_closes_and_retries_once` (`publisher/tests/test_browser.py`). Só vale
depois de reiniciar o `pnpm dev`; **não testado num envio real**.
## Números dos posts (views, curtidas, comentários)
Fluxo: despachante → `collectMetrics` → Publicador lê → grava `publication_metrics` (`simulated = 0`, `INSERT OR REPLACE`).
- **Publicador**: rota `POST /v1/profiles/{id}/stats`, corpo `{ids: [...]}`, resposta `{capturedAt, items[{remoteId, views,
likes, comments, shares, saves}], missing}` (`Publisher.post_stats` em `service.py`). Arquivos: `app/platforms/stats.py`
(`PostStats`, `parse_count`, `youtube_public`, `youtube_from_html`) e `app/platforms/session/stats.py` (`tiktok_stats`,
`tiktok_row_stats`, `instagram_stats`, `instagram_media`, `READERS`). `SessionRunner.read_stats` usa a trava de
navegador, espera um envio até 120 s e fecha a janela só se ela não estava aberta antes. Testes:
`publisher/tests/test_stats.py`; `pnpm test:publisher` → **83 passed** (reexecutado na skill, 17/11/2026).
- **Como cada rede é lida** (medido com conta real, 17/11/2026):
- YouTube: página pública `watch?v=` sem navegador dá `viewCount` e `likeCount` exatos; comentários só arredondados
("5,2 mil"). Funciona em qualquer modo.
- TikTok: a página pública devolve só verificação (1,4 KB): precisa da janela logada. Em `/tiktokstudio/content`, cada
linha `data-tt="components_RowLayout_FlexRow"` tem o link `/video/<id>` e termina em "Todos\n<views>\n<curtidas>\n<comentários>".
~4 s.
- Instagram: sem login não há números. Pela aba Reels do perfil a página chama `/api/graphql` com `code`, `play_count`
(views), `like_count`, `comment_count`; a grade mostra só views ("1.499"). **A grade aparece ANTES da resposta da API**:
parar ao achá-la perde curtidas e comentários. Por isso a API tem prioridade e a grade é reserva, depois de 3 voltas.
~15 s.
- Modo oficial do TikTok/Instagram: ainda não lê (409 "por enquanto só funciona no modo Sessão logada").
- `parse_count`: "1.499" → 1499, "1,2 mil" / "1.2K" → 1200, "3,4 mi" → 3400000.
- **Painel**: migração **v8** (`metric_syncs`: account_id, platform, last_run_at, last_ok_at, last_error, read_count,
missing_count). `panel/src/lib/metrics-sync.ts`: `collectMetrics({accountId?, force?})` nunca roda duas ao mesmo tempo
(estado em `globalThis`) e para em 503; `autoCollectMetrics` é chamado sem `await` no fim do `dispatcherTick`, no máximo
a cada 10 min. Configuração `metricsEveryHours` (0/3/6/12/24; padrão 6; `app_settings.metrics_every_hours`): a automática
lê só posts dos últimos 90 dias; o botão lê todos. Rota `/api/dashboard/metrics`: GET `{running, syncs}`; POST lê tudo agora.
`lib/metrics.ts` `dashboard()` ganhou `byVideo` (um por corte/episódio, total e números por rede; título de
`publish_jobs.title`) e `syncs`.
- **UI**: `VideoTable` (`components/metrics-view.tsx`: colunas YouTube/TikTok/Instagram com link, total, curtidas,
comentários); `MetricsSyncControls` (`dashboard-controls.tsx`: "Atualizar números agora", "lido há X h" ou o erro de
cada rede); card "Números das redes" em Configurações → Publicação. Cards de episódio e história somem sem dados.
- Painel: `test:panel` 66/66 e typecheck verde (informados, não reexecutados). Não verificado: leitura automática com o
painel ao vivo.
## Botão "Publicar no <rede>" nos cartões de Publicações
`components/publishing-board.tsx`: para cortes, mostra as redes conectadas e ligadas do canal que ainda não têm job do
corte (job cancelado conta como livre). Confirma com `askConfirm` e chama `publishClip(clipId, {accountId, platforms:
[rede], timing})` com o timing do canal ("now" ou "best_slot"). O quadro carrega `/api/accounts` junto com o status.
## Fatos das plataformas (resumo; detalhe e fontes em `doc/publicacao/PESQUISA.md`)
- YouTube: projeto não verificado já publica público (desde 02/11/2026); `videos.insert` 100 envios/dia; app em