Files
CenaForge/.claude/skills/cenaforge/CHANGELOG.md
T
MateuusandClaude Opus 5.5 84f30bbc2d CenaForge: primeira versão pública
Gerador de vídeos narrativos (Godot + FFmpeg), painel Next.js, serviço de voz,
Clipador de lives e Publicador para YouTube, TikTok e Instagram.

Inclui a leitura das visualizações dos posts para o Dashboard e o botão
"Publicar no <rede>" nos cartões das publicações.

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

671 lines
50 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Histórico da skill cenaforge
Versão semântica da **skill** (não do projeto):
- **patch** — correção de texto, dado ou caminho;
- **minor** — capacidade, ferramenta, preset, comando ou armadilha nova;
- **major** — mudança incompatível no contrato JSON ou no pipeline.
Mantido pelo subagente `cenaforge-skill-updater`. Entradas mais novas no topo.
## 1.42.0 — 17/11/2026
Instagram sem corte quadrado, corte sem rótulo de IA e ação "Apaguei na rede".
- `references/publishing.md`: regra do formato "Original" (`keep_original_shape`), corte nunca leva rótulo de IA, ação
`removed`/`markRemoved`; evidência do 1º reel real.
- `references/gotchas.md`: itens novos 147 (reel 1:1; `common.find` olha até 6 ocorrências), 148 (rótulo de IA em corte;
"Perfil gerado por IA" provavelmente do perfil, não confirmado), 149 ("Apaguei na rede"), 150 (`python -I` e
`PYTHONIOENCODING`).
- `SKILL.md`: versão e resumo de armadilhas.
- Evidência: `pnpm test:publisher` → 78 passed (reexecutado). Informados, não reexecutados: `test:panel` 66/66, typecheck,
ensaio ao vivo sem publicar. Não verificado: publicação real com o formato novo (precisa reiniciar o `pnpm dev`).
## 1.41.0 — 17/11/2026
Modo sessão do Instagram: botão "Postar", seletores presos ao diálogo, `prepare`/`upload`, rótulo de IA e link do reel.
- `references/publishing.md`: regra "Instagram em modo sessão" (fluxo, `prepare` sem clicar, `find_ai_switch`,
`close_suggestions`, `find_reel_url`, ensaio sem publicar, o que foi e o que não foi validado); evidência; linha do
"Primeiro envio real" atualizada.
- `references/gotchas.md`: itens novos 145 (botão Postar e "Compartilhar" do feed) e 146 (sugestões de hashtag por cima do
rótulo de IA; sem `force=True`); nota "Relacionadas".
- `SKILL.md`: versão e resumo de armadilhas.
- Evidência: `pnpm test:publisher` → 78 passed (reexecutado). Informado, não reexecutado: ensaio ao vivo com conta real.
Não verificado: Compartilhar, confirmação e `find_reel_url` com conta real; falta reiniciar o `pnpm dev`.
## 1.40.0 — 17/11/2026
Hashtags da legenda dos cortes, espera do link do TikTok com recarga da lista e armadilha do serviço com código antigo.
- `references/clipper.md`: seção "Hashtags da legenda" (`hashtags.py`: `to_tag`, `fold`, `split_hashtags`, `compose`,
`build_caption`; campo `hashtags` no veredito e no perfil do jogo; painel), linha em "Onde mexer", `hashtags` no `PUT
/v1/games`, evidência e "Não verificado".
- `references/publishing.md`: `find_video_url` com 12 cargas × 5 leituras (~3 min) e progresso; mensagem do painel
"Saiu na rede…" (`readPublisherJob`); evidência.
- `references/gotchas.md`: item 140 atualizado (2ª versão); itens novos 143 (processo mais antigo que o arquivo: rodou código
antigo) e 144 (hashtags do perfil/cortes antigos).
- `SKILL.md`: versão, `description`, linha em "Onde mexer" e resumo de armadilhas.
- API do perfil: `GameRefineIn.section` aceita `"hashtags"` e `GameProfileIn.hashtags` (máx. 20) evita apagar as tags ao
salvar o perfil à mão (corrigido pelo coordenador; registrado em `clipper.md`).
- Evidência: `pnpm test:clipper` → 278 passed e `pnpm test:publisher` → 76 passed (ambos reexecutados). Informados, não
reexecutados: `test:panel` 65/65, typecheck, validação ao vivo do link.
## 1.39.0 — 17/11/2026
Modo sessão (TikTok): aviso de novidade do Studio bloqueava o clique na legenda.
- `references/gotchas.md`: item 142 (sintoma, causa, `TIP_BUTTONS`/`dismiss_tips`/`click_through`, regra de só fechar
avisos "entendi", mensagens de `browser_error_text`, testes); nota "Relacionadas".
- `references/publishing.md`: linha do modo sessão (`click_through`, `dismiss_tips`, `browser_error_text`), regra "Avisos de
novidade do site", evidência.
- `SKILL.md`: versão e resumo de armadilhas.
- Evidência: `pnpm test:publisher` → 76 passed (reexecutado); funções, usos em `tiktok_studio.py`, testes e captura
`20261117-134508` conferidos. Não verificado: envio real depois da correção (falta reiniciar o `pnpm dev`); a imagem
não foi aberta (o aviso é o descrito por quem chamou).
## 1.38.0 — 17/11/2026
Primeiro post real no TikTok (modo sessão), link do vídeo e ação "Já saiu: informar o link".
- `references/publishing.md`: regra do link do TikTok (`find_video_url`, `caption_key`), ação `mark-published`
(`parseVideoUrl`, `markPublished`, rota, UI), registro do primeiro envio real, evidência; nota do `tick` no despachante;
removida a frase "nenhuma rede teve envio real" (TikTok validado; YouTube/Instagram em sessão seguem sem validação).
- `references/gotchas.md`: itens 140 (publicou sem confirmar o link) e 141 (`tick` do despachante preso no HMR).
- `SKILL.md`: versão, `description` e resumo de armadilhas.
- Evidência: `pnpm test:publisher` → 74 passed (reexecutado); `find_video_url`, `parseVideoUrl`, `markPublished`, rota,
UI e bloco do `tick` conferidos no código. Informados e não reexecutados: `test:panel` 65/65, typecheck, validação ao
vivo da lista, o post real. Pendente: reiniciar o `pnpm dev` para valer `find_video_url` e `is_local`.
## 1.37.0 — 17/11/2026
Modo sessão do Publicador: envio de arquivo > 50 MB (cortes de 100–108 MB) falhava no TikTok.
- `references/gotchas.md`: item 139 (sintoma, causa `connect_over_cdp` tratado como remoto, correção `is_local=True` em
`runner.py` e `browser.py`, mensagem genérica "navegador travou", reinício do `pnpm dev`); nota "Relacionadas".
- `references/publishing.md`: linha do modo sessão (`is_local`, mensagem genérica) e evidência.
- `SKILL.md`: versão e resumo de armadilhas.
- Evidência: `pnpm test:publisher` → 73 passed (reexecutado); `is_local` conferido nos dois arquivos e na assinatura do
playwright 1.65.2. Não verificado: envio real (falta reiniciar o `pnpm dev`); captura PNG existe, mas não foi aberta.
## 1.36.1 — 17/11/2026
Correção: migração do banco do painel agora se aplica sozinha no HMR (`checkedThisModule` em `panel/src/lib/db.ts`).
- `references/gotchas.md`: item 138 reescrito (migra na 1ª requisição depois da recarga; sintoma só se o `db.ts` não
recarregou; remédio: qualquer requisição ou reiniciar); item 51 e nota "Relacionadas" ajustados.
- `references/panel.md` e `references/publishing.md`: removida a afirmação de que só reiniciar migra.
- `SKILL.md`: versão e resumo de armadilhas.
- Evidência (informada, 17/11/2026): `GET /api/publishing/summary` levou o banco real a `user_version` 7 com backup
`cenaforge-v6-2026-11-17T16-28-39-725Z.db`; typecheck verde, `test:panel` 63/63. Código de `db()` conferido; testes não reexecutados.
## 1.36.0 — 17/11/2026
Clipador: botão "Publicar" nos cortes aprovados (publicação manual sem fonte ligada) e banco v7 (`publish_jobs.origin`).
- `references/publishing.md`: linhas "Onde mexer" (UI, rota, `publishClip`) e do banco (v7); regras do botão e de
`origin` (`manual` não é cancelado por fonte desligada); evidência (63/63, informada).
- `references/gotchas.md`: item 138 ("no such column: origin" até reiniciar o `pnpm dev`); nota "Relacionadas" até v7.
- `references/panel.md`: esquema v7. `references/clipper.md`: ponteiro na regra "Aprovar publica".
- `SKILL.md`: versão, esquema v7, linha de publicação, `description` e resumo de armadilhas.
- Não verificado: testes e typecheck não reexecutados aqui (vêm do relato); sem conta real; `doc/publicacao/PLANO.md` §7c não lido.
## 1.35.0 — 17/11/2026
Modo sessão do Publicador com Chrome 157: `owns_port` deixou de depender só do `DevToolsActivePort`.
- `references/gotchas.md`: item 137 (sintoma, causa, marca `CenaForgeWindow.json` + `listener_pid`, aviso de janela já
aberta com o perfil, reiniciar `pnpm dev`); nota nas "Relacionadas".
- `references/publishing.md`: linha do modo sessão cita a marca; evidência registra 73 passed (informado).
- `SKILL.md`: versão e resumo de armadilhas.
- Não verificado: `pnpm test:publisher` não reexecutado aqui; teste ao vivo e 73 passed vêm do relato; versão do Chrome não conferida.
## 1.34.0 — 17/11/2026
Economia de tokens do juiz do Clipador (`clipper/app/judge.py`): `codex_lean_overrides` e `--setting-sources` no Claude.
- `references/token-economy.md`: subseção "Juiz do Clipador" com medições (Codex ~77 mil → ~35 mil caracteres fixos;
Claude 3,7 → 2,6 mil tokens, 5,5 → 2,8 s) e propostas não implementadas (pré-filtro, juntar analista+editor).
- `references/clipper.md`: bullet de custo fixo na seção Juízes.
- `references/gotchas.md`: item 136 (cota esgotada pelo juiz; vale só após reiniciar o Clipador).
- Não verificado: resposta do modelo Codex com a configuração enxuta (cota esgotada na medição).
## 1.33.0 — 17/11/2026
Economia de tokens dos agentes do painel: flags enxutas do Claude CLI, teto de gasto, overrides do Codex e dois scripts
novos (`frame_check.py`, `check_script.py`).
- `references/token-economy.md`: scripts novos na tabela; regras duras (uma imagem por render, pesquisa curta, resume
caro); seção "Custo fixo dos agentes do painel" com as medições (62,4 → 14,9 mil tokens, 8,0 → 4,3 s; #6, #7, #8).
- `references/gotchas.md`: novos 133 (OAuth expirado em `~/.claude`), 134 (execução cara: causas e correções),
135 (`-c mcp_servers={}` não desliga; `collaboration` fica).
- `SKILL.md`: lista de scripts e resumo de armadilhas (133–135); versão.
- Não verificado: reexecução do `tsc`/testes do painel (informado como passou); `frame_check.py` conferido só por `--help`.
## 1.32.0 — 17/11/2026
Cenas 3D com personagens: kits `godot/kits/` (`person.gd`, `boat.gd`), ilha com noite e uso como cenário
(`embedded`), cena nova `castaways` (náufragos da Ilha das Cobras), `SCENE_SCRIPT_INVALID` no `doc_main.gd`. Montagem
"Tudo em 3D" com cartão de foto e cartões de informação em sequência; `POST /api/stories`. Fluxo provado de ponta a
ponta (história → cena → MP4 de 101,7 s).
- `SKILL.md`: `description` cita náufragos, kits, cena dentro de outra, "Tudo em 3D", cartão de foto, `POST
/api/stories` e agente parado (limite/reinício); bloco do documentário lista `island` e `castaways`, tempo de prévia
e `SCENE_SCRIPT_INVALID`; "Onde mexer" ganha kits/`embedded` e `planShot3d`/cartão; resumo de armadilhas cita 131–132.
- `references/panel.md`: banco real em v6 (conferido); `style`, `inset`/`InsetCard`, textos `; depois:`; `planShot3d`;
`applyInternetImage(..., "inset")` sem repetir fotos entre principais e cartões; `regenerateShot(..., target)` e rota
`{index, target?}`; cartão no FFmpeg (62%, borda 12 px, 21%, fades) e fonte menor > 26 caracteres; ilha (`night`,
`variant` só câmera, `embedded`/`environment`/`sea_detail`, métodos públicos); `castaways` e kits; `POST /api/stories`;
evidência de ponta a ponta.
- `references/gotchas.md`: novos 129 (template que não compila: laço infinito → `SCENE_SCRIPT_INVALID`), 130 ("shadows
a native class"), 131 (reiniciar o painel mata o agente), 132 (limite de uso → outro provedor); item 9 ampliado;
item 125 cita a mensagem e que só parte das rotas usa `readJson`.
- `references/tools.md`: Godot cita `castaways`/kits; tempos medidos do `castaways` (prévia 5,8–15,6 s, 65 execuções;
finais 9,8–89,7 s); candidata nova "`.glb` por `GLTFDocument`" (só documentado, sem teste).
## 1.31.0 — 17/11/2026
Correções das revisões de segurança e correção da publicação automática: migração v6 do painel, guarda da API
(`panel/src/proxy.ts`), idempotência por `clientRef`, `mayBeLive`, reencaixe de agendados vencidos, `unlinked`, e
endurecimento do Publicador (pastas permitidas, janela do navegador, ACL, capturas, PKCE em memória, loggers).
- `SKILL.md`: `description` cita "Confira na rede" e chamada da API do painel por script; esquema v6; invariante nova
da API do painel (`Origin` + JSON, gotchas 125).
- `references/publishing.md`: "Onde mexer" com `paths.py` (`output/`/`stories/`/`assets/`, `data/` recusado), `acl.py`,
`db.py` v2 (`client_ref`), `browser.py` (`DevToolsActivePort`, fechamento), `step_pause`/`fill_text`, funções novas
das regras (`needsReflow`, `clientRefFor`, `mayBeLive`), banco v6 e linha "Guarda da API do painel"; regras novas
(idempotência, `confirm: true`, reencaixe > 30 min, `unlinked`/`linked_at`, cancelar no ciclo, rótulo de IA por
cautela, janela do modo sessão, capturas, segurança do Publicador); evidência 71 passed / 59/59 e bancos reais
(painel ainda v5, Publicador v2).
- `references/gotchas.md`: itens 118 (`mayBeLive`/409), 119 (401/403/404 e timeout ficam na fila), 121 (`unlinked`),
122 (religar zera `linked_at`) ampliados; novos 125 (API do painel 403/415 a curl), 126 (reencaixe do agendado),
127 (OAuth: Publicador reiniciado / espera de 10 min), 128 (janela do modo sessão fecha sozinha).
- `references/panel.md`: banco v6 e guarda da API (`proxy.ts`, `readJson`).
- `references/tools.md`: evidência do Publicador 71 passed (versões reconferidas, sem mudança).
## 1.30.0 — 17/11/2026
Publicação automática em YouTube, TikTok e Instagram: serviço Publicador (`publisher/`, 4530), despachante do painel
(laço de 20 s em `instrumentation.ts`), migração v5, telas "Canais de publicação", "Publicações" e "Configurações";
"Canais" do Clipador viram "Fontes" na UI. Tira da skill o "publicação é a próxima fase / nada fala com as redes".
- `references/publishing.md` (novo): papéis painel × Publicador × Clipador, subida/instalação/testes, tabela "onde
mexer" (serviço, uploaders, seletores `SELECTORS`, `publishing-rules.ts`, rotas, telas, `Dialog`/`Steps`,
`NoticeBar`/`PublishChips`, `actions[]`), regras (nunca `published` sem link, aprovar = vídeo inteiro,
`auto_since`, episódio sempre manual, limite diário em "Na hora", `publishAt` não usado, modo sessão com "Entendi o
risco"), resumo dos fatos das plataformas apontando para `doc/publicacao/PESQUISA.md`, evidência e lacunas.
- `SKILL.md`: `description` cita publicação; docs de `doc/publicacao/` e `publisher/README.md`; esquema v5; linha do
Publicador e portas 4530 e 4540–4549; "Onde mexer" ganha publicação, passo 6b2 do setup e `Dialog`; invariante "fora
do escopo: publicação real" trocada por regras de publicação; `pnpm test:publisher`; seção de voz compactada.
- `panel.md`: banco v5 e `test:panel`; "Contas e dashboard" → "Canais de publicação e dashboard" (sem `mock`; métricas
simuladas, `publications` real com `simulated = 0`; card "Fontes de corte").
- `clipper.md`: linha "Fontes" e linha nova "Publicação dos cortes" (`GET /v1/clips` com `channel=`/`ids=`); regra
"Aprovar só marca o corte" substituída.
- `gotchas.md`: seção nova "Publicação", itens 118–124 (terminou sem link, job esperando/409, `expired`, jobs
cancelados ao exportar, automática não pega cortes antigos, "Na hora" agendado, TikTok só "Somente eu"); item 51
cita v5.
- `tools.md`: seção do Publicador com versões do `publisher/.venv` (Python 3.12.13, FastAPI 0.159.1, uvicorn 0.54.0,
pydantic 2.14.1, httpx 0.28.1, playwright 1.65.2, pytest 9.1.1) e 55 passed; candidata "publicação próxima fase"
trocada por APIs oficiais e modo sessão "código pronto, sem envio real".
## 1.29.1 — 17/11/2026
Correção: a limpeza da fila antes do render (`discard_pending_duplicates`) agora usa o mesmo veto do juiz.
- `clipper.md`: "Duplicados" diz que saem da fila os pendentes iguais a um corte pronto, aprovado, publicado,
rejeitado, apagado num desses estados ou a um pendente mais antigo (antes dizia que não comparava com rejeitados);
"Apagar cortes" cita a limpeza da fila; evidência 270 passed (medido; informado 269) com o teste novo.
- `tools.md`: evidência do Clipador 270 passed.
## 1.29.0 — 17/11/2026
Clipador: apagar cortes (um, lote ou aba inteira; o momento apagado não volta), veto do rejeitado depois do juiz e
varredura que conta propostas. Painel: "Apagar" e seleção discreta na fila, relógio da gravação e cadência do resumo
no cartão da sessão, prévia do editor igual ao render na legenda e no recorte. (A 1.28.0 é de outra sessão, publicada
em paralelo.)
- `SKILL.md`: `description` cita apagar corte, rejeitado/apagado que não volta, relógio e cadência, prévia igual ao
render e "não sai corte"; linha do Clipador em "Onde mexer" cita `clip_delete.py`/`deleted_clips` e `METHODS`.
- `clipper.md`: banco v10 (`deleted_clips`); linha nova "Apagar cortes" em "Onde mexer"; `KEPT_STATUSES`/
`VETO_STATUSES`; seção nova "Apagar cortes" (rotas, recusas, o que some, marca, `METHODS`, ids mostrados);
duplicados reescritos (rejeitado e apagado vetam; descartado não; `discard_pending_duplicates` não olha rejeitado);
varredura grava `proposals`/`created`; editor: porte da legenda e `ffmpegCropFill` com regra de mudar junto;
linha da página `/clipper` cita `SelectionPill`, `RecordingClock`, `SummaryCadence`; evidência (268 passed,
`tsc` exit 0, banco real em v10) e lacunas.
- `panel.md`: aba Sessões ganha relógio (`CLOCK_TICK_MS` 250, `CLOCK_MAX_AHEAD_S` 45) e cadência (`scanIntervalS` de
`/status`); fila ganha "Apagar" e seleção discreta; `METHODS` na regra de rota nova; prévia do editor deixa de ser
"aproximada" na legenda e no recorte; evidência.
- `gotchas.md`: itens 114 ("não sai corte" = live fria), 115 (resumo "travado"), 116 (barra de seleção reprovada),
117 (prévia 1–3 px deslocada / legenda diferente).
- `tools.md`: evidência do Clipador 268 passed.
## 1.28.0 — 17/11/2026
Biblioteca de cenas 3D na Godot (`kind: "doc3d"`, `godot/library/<id>/`, primeira: `island`) e montagem documental com
fotos reais do Wikimedia Commons, "Gerar de novo" por trecho e "Refazer tudo do zero". Tira o aviso "doc3d em
desenvolvimento".
- `SKILL.md`: `description` cita a biblioteca 3D, criar cena nova (`doc/godot/cenas.md`, tarefa "Cena no Godot"), fotos
do Commons, "Gerar de novo" e "Refazer tudo do zero"; parágrafo "Cenas do documentário" reescrito (`doc2d`/`doc3d`,
`variant`, erro de cena inexistente, tempos); "Onde mexer" ganha a linha da cena 3D (`template.gd` + `manifest.json`)
e cita `scene-library.ts`/`image-search.ts`; "Validação" aponta o checklist do guia; seções de voz, tokens e
armadilhas compactadas.
- `panel.md`: "Montagem documental" reescrita — `VISUAL_KINDS` com rótulos, `ShotVisual.search`/`auto`, pergunta da
tela antes da fala, licença opcional, `SceneEditor` 3D pelo manifesto; subseções novas "Plano do trecho"
(`scriptEntities`, ordem do `planShot`, modelos 2D com `variant`), "Fotos da internet" e "Biblioteca de cenas 3D";
"Gerar o MP4" com `replan`, `regenerateShot` e foto com fundo desfocado; rota `.../montage/regenerate`; tarefa
`godot` do agente e `?prompt=`; evidência (13 prévias da ilha, final 3D, erro de cena inexistente, MP4 88,33 s).
- `gotchas.md`: 110 vale para `doc3d`; 44 ampliado (`node -e` quebrou o build do painel); novos 111 (espuma por
elipse no shader do mar) e 112 (Next dev roda o módulo antigo na 1ª montagem pós-edição).
- `tools.md`: Godot também monta a biblioteca 3D (ACES na ilha), tempos medidos da `island`; FFmpeg com `boxblur`;
API do Wikimedia Commons em uso.
## 1.27.0 — 17/11/2026
Cenas 2D do documentário na Godot (`kind: "doc2d"`: título, contador, mapa do litoral de SP) e vídeo documental
automático num clique no painel. Corrige a skill onde dizia que "Animação 2D (Godot)" não existia e que o documental
saía só pelo FFmpeg, sem Godot.
- `SKILL.md`: `description` cita cena 2D e "Gerar vídeo automático"; parágrafo do `doc2d` no Pipeline (contrato,
comando de prévia, tempos); "Várias histórias" e "Voz e legenda" atualizados; "Onde mexer" ganha a linha da cena
2D (`godot/scripts/doc/`: `doc_config.gd`, `doc2d_canvas.gd`, `doc_main.gd`; cena `doc.tscn`; `MAP_PLACES` =
`PRESETS.places`) e cita o ramo `doc2d` do `render.ts`; `doc3d` marcado como em desenvolvimento e o `montage-godot.ts`; "Validação": quadros de inspeção pulados em cena curta. Seção de voz
compactada (detalhes já em `voice/README.md`).
- `panel.md`: "Montagem documental" reescrita — `godot2d` disponível (`scene`/`sceneKey`), botão "Gerar vídeo
automático" + modo manual ("Só montar"), `SceneEditor` e "Prévia da cena", config em
`stories/<id>/godot/<file_key>-tNN.json`; subseções "Cena 2D: plano e render" (`planScene` por regras,
`MAP_PLACES`, `renderGodotScene`) e "Gerar o MP4" (`startMontageRender(id, { auto })`, `montageJob`); `godot2d` sem
texto na tela; rotas `.../montage/scene` e `{auto}`, GET com `templates` e `job`; evidência e lacunas.
- `gotchas.md`: item 110 (checagens da rua reprovavam a cena 2D: luma ≈ 13 < 20 e sem moto).
- `tools.md`: Godot também desenha as cenas 2D (`doc.tscn` + `doc2d_canvas.gd`, SystemFont), reconferida 4.7.2 em 17/11/2026; tempos
medidos do `doc2d`.
## 1.26.0 — 17/11/2026
Clipador: duração mínima garantida, gancho em tarja animada, fontes empacotadas, reenquadramento do jogo com keyframes,
camadas inseridas e qualidade de gravação configurável (até 2K). Painel: editor com Programa 16:9, trilhas ENQ/INS,
câmera editável na Fonte e prévia de texto pelas métricas da fonte.
- `SKILL.md`: `description` cita mínimo garantido, qualidade de gravação, tarja, fontes, reenquadramento, camadas e
câmera editável na Fonte; linha do Clipador em "Onde mexer" cita `capture.py`, `fit_window`, `assets/fonts/` e
`reframe.py`.
- `clipper.md`: banco v9 (`sessions.capture_json`); linha das fontes empacotadas; "Onde mexer" ganha qualidade de
gravação, busca em `.ts`/emenda de resolução e reenquadramento/camadas, e cita `fit_window`, `min_target`, grupos
`hook`/`capture`, `ass_filter` e as chaves novas das rotas de settings; "Configuração do corte" reescreve a duração
(≥ `minS` + 1 s em todo corte automático) e ganha `hook`, fontes e `capture.quality`; seção nova "Qualidade de
gravação"; editor: sai "Programa sempre 9:16", campos `style`/`bg`/`color`/`font`/`anim`, `inset` e `reframe`,
limite de 0,48 da largura, custo medido, a IA não propõe reframe/camadas; regra de aplicar por edição pontual;
evidência (251 passed) e lacunas.
- `panel.md`: modal do corte em 5 abas (Gancho, "Qualidade da gravação"); cartão da sessão "gravando em"; editor:
trilhas INS/ENQ, Programa por `frames`, fontes por `FontFace`, keyframes, câmera na Fonte, arquivos novos
(`clip-editor-fonts.tsx`, `clip-editor-keyframes.tsx`, `clip-editor-source.tsx`, `rect-geometry.ts`), atalhos `[`/`]`
e Ctrl+C/V; gestos da Fonte sem os botões antigos; evidência.
- `gotchas.md`: itens novos 103 (corte automático curto), 104 (`\blur` com contorno), 105 (`fontsdir` e nome da
família), 106 (`crop` × `perspective` `eval=frame`, `in` começa em 1), 107 (busca em `.ts`, HEVC cinza), 108 (emenda
de resolução na retomada), 109 (updater do `setState` puro); 86 ampliado (CDP: `Fetch` antes de navegar, Ctrl+Z
como `keyDown`); 87 ampliado (aplicar por edição pontual com agentes em paralelo).
- `tools.md`: evidência do Clipador 251 passed; Streamlink e FFmpeg reconferidos (8.6.3 / 7.1.1) com os usos novos;
linha das fontes empacotadas (commit do google/fonts + licenças).
## 1.25.0 — 17/11/2026
Painel: modal de confirmação/aviso global no lugar de `window.confirm`/`window.alert`.
- `SKILL.md`: linha nova em "Onde mexer" (`askConfirm`/`showAlert`/`confirmSubmit` de
`components/confirm-dialog.tsx`; proibidos `confirm()`/`alert()` nativos).
- `panel.md`: seção nova "Confirmação e aviso" (API, `confirmSubmit` com `requestSubmit` + `data-confirmed="1"`,
`tone: "danger"`, `<ConfirmHost />` único em `app/layout.tsx` com fila e `<dialog>` nativo, `Button` com
`ComponentProps<"button">`/`ref`); "Excluir história" deixa de citar `window.confirm` (agora `confirmSubmit` +
`showAlert`); evidência.
## 1.24.0 — 17/11/2026
Painel: montagem documental (áudio e visual por trecho → MP4 pelo FFmpeg). Substitui o aviso "a montagem
documental não existe".
- `SKILL.md`: `description` cita a montagem documental; "Várias histórias" diz que o documental vira MP4 pela
montagem do painel; "Onde mexer" ganha a linha da montagem (`montage.ts`, `montage-ffmpeg.ts`, `speech-text.ts`,
`montage-editor.tsx`, rotas `.../montage/`); "Voz e legenda": só o render da Godot não chama o serviço.
- `panel.md`: seção nova "Montagem documental" (trecho = linha "t (s)", áudio por parágrafo, texto falado por
extenso, `VISUAL_KINDS`, upload com licença, `.montage.json`, `audioKey`, `startMontageRender`/`profile =
'documentary'`, parâmetros do FFmpeg, rotas, `/api/files` com .webm/.mov/.mkv); evidência e lacunas.
- `gotchas.md`: item 52 ampliado (tsx pela raiz, `f:/` não é URL); itens novos 99 (importar `db.ts` marca execuções
como `interrupted`), 100 (`fileUrl()` + `&v=`), 101 (markdown no texto na tela), 102 (duração real da fala ×
tempo da tabela).
- `tools.md`: FFmpeg também usado pela montagem documental (7.1.1 reconferido).
## 1.23.0 — 17/11/2026
Painel: leitor de roteiro.
- `SKILL.md`: `description` cita o leitor de roteiro e que a montagem documental em MP4 não existe; "Várias
histórias" avisa que o documental ainda não vira MP4; "Onde mexer" ganha a linha do leitor (`script-doc.ts`,
`script-reader.tsx`, página `.../roteiro`).
- `panel.md`: seção "Leitor de roteiro" (`parseScript`, papéis das seções, tabela "t (s)", `WORDS_PER_SECOND` 2,5,
alertas 1,1×/1,15×, markdown sem HTML cru, páginas que usam, episódio documental sem "Montar cena"); evidência.
## 1.22.0 — 17/11/2026
Painel: mensagem ao agente durante a execução, termos episódio × vídeo e leitura UTF-8 no Codex.
- `SKILL.md`: `description` cita correção/mensagem durante a execução e termos episódio × vídeo; "Onde mexer" —
linha de agentes cita `sendFollowUp` e `agent-console.tsx`; formato novo inclui `unitTerms`.
- `panel.md`: seção "Mensagem com o agente rodando" ("Corrigir agora"/"Enviar ao terminar", rota
`POST /api/agent/runs/[id]/messages`, `ActiveRun.emit/followUp/progressed`, continuação antes do "end" com
`followUpRunId`, só no fim ao vivo); "Formatos de história" ganha `unitTerms` e o episódio sem título no
documental; nota do `Get-Content -Encoding UTF8`; evidência e lacunas.
- `gotchas.md`: item 97 (Codex retomado cedo demais esquece o pedido — medido no 0.169) e item 98 (PowerShell 5.1
lê UTF-8 sem BOM como ANSI → "história").
## 1.21.0 — 17/11/2026
Regras de roteiro numa fonte única (`doc/roteiro/`) e exclusão de história no painel.
- `SKILL.md`: `description` cita `doc/roteiro/` e excluir história; "Várias histórias" aponta as regras de roteiro
para `doc/roteiro/` (sai "restrições do `cenaforge-story-writer`") e cita a 1ª linha `Formato:` da `biblia.md`;
"Onde mexer" ganha a linha "Regra de roteiro" (editar os .md, não o código), a linha do painel cita
`deleteStory`/`stories.ts`, e formato novo usa `GUIDE_BY_KIND`/`FORMAT_LABEL` no lugar de "regras no prompt";
"Economia de tokens": subagente segue `doc/roteiro/`, sem busca na web ("a confirmar").
- `panel.md`: "Formatos de história" resume os três guias (sai `DOCUMENTARY_RULES`/`DOCUMENTARY_SCRIPT_FORMAT` e o
detalhe do documental duplicado); "Agentes e modelos" descreve `writingRules(provider, kind)`; seção nova
"Excluir história" (recusas, `data/trash/<id>-<timestamp>/`, transação, CASCADE/SET NULL, sem exclusão de asset
da biblioteca); evidência e lacunas.
- `gotchas.md`: item 96 aponta para `doc/roteiro/` e `writingRules` (saem `fictionRules`/`DOCUMENTARY_RULES`).
## 1.20.0 — 17/11/2026
Painel: formato de história documental, prompt sensível ao agente e lista de modelos dinâmica.
- `SKILL.md`: `description` cita histórias lineares/documentais e escolha de agente/modelo; esquema do banco v4;
formatos `interactive`/`linear`/`documentary` em "Várias histórias"; "Onde mexer" — formato novo exige também
migração do CHECK (`db.ts`), regras em `prompts.ts` e layout do Fluxo; linha de agentes cita `prompts.ts`,
`models()` e `AGENTS.md`.
- `panel.md`: banco v4 (reconstrói `stories` para o CHECK aceitar `documentary`) e migração só ao reiniciar o
`pnpm panel`; novas seções "Formatos de história" (tabela dos três `kind`, ficha de pauta e roteiro do documental,
`DOCUMENTARY_RULES`/`DOCUMENTARY_SCRIPT_FORMAT`) e "Agentes e modelos" (`buildPrompt` por `provider`, `models()`:
Codex por `models_cache.json`/`config.toml`, Claude com ids `claude-*`, `DEFAULT_MODEL` = `claude-sonnet-5-5` em
scene/branches, seletor no "Nova história com IA"); linha "Gerar vertentes" sem o modelo `sonnet` fixo; evidência.
- `gotchas.md`: item 29 com os filtros novos de stderr (Codex "unrecognized configuration setting", Claude
`unrecognized_model`); item 51 generalizado (cache em `globalThis.__cenaforgeDb`, v4); item 96 novo (Codex
aplicando as restrições de ficção a pedido documental).
- `tools.md`: linhas do Codex CLI e do Claude Code CLI citam a escolha de modelo; versões reconferidas (0.169.0 /
2.1.314).
## 1.19.0 — 17/11/2026
Rastreio de reação testado ao vivo (instância isolada na 4521; `doc/FACE_BAKEOFF.md`, "Testes de 17/11 — ao vivo").
- `clipper.md`: `locate_cam` com `ReactionParams.min_cam_score` 0,7; sem linha "Rosto do streamer" com o plano B
OpenSeeFace (`FaceService.summary`); receita da instância de teste isolada (`CLIPPER_DATA_DIR`/`CLIPPER_OUTPUT_DIR`
dentro do repo, `sqlite_sequence` de `sessions` em 90000); evidência nova (download real, OSF × MediaPipe, serviço
real com 25 blocos, lofigirl, painel; pytest 170 passed e tsc do painel conferidos); "Não verificado" do rastreio
trocado (download, plano B, serviço real e painel saem; entram câmera cheia/escura/minúscula, GPU, live > 15 min,
linha do rosto no juiz ao vivo, interruptor real).
- `gotchas.md`: itens 92 (câmera falsa em live sem câmera), 93 (chave da voz colidindo em banco de teste novo),
94 (analista lendo "sem reação" com o plano B) e 95 (WARNING de pesquisa a cada 30 s com juiz `off`).
- `tools.md`: evidência do serviço real ao vivo; números ao vivo do MediaPipe; OpenSeeFace deixa de ser "não testado"
(medido com os pesos reais); piso 0,7 citado no YuNet.
## 1.18.0 — 17/11/2026
Clipador: formato horizontal, durações novas, legenda com fala rápida, retomada de live, render que falha e cortes
duplicados; modal do corte em abas e aba Sessões refeita no painel.
- `clipper.md`: corte vertical ou horizontal; banco em `user_version` 8 (`clips.aspect`); "Onde mexer" ganha a linha de
retomada/render/duplicados (`worker.py`, `test_resume.py`, `test_render_and_duplicates.py`), cita `DEFAULTS`/`merge`/
`validate`, `ASPECTS`/`FRAME_SIZES`/`CANVAS_SIZES`, `resolved_mode` = `full`, `aspects`/`frames` das rotas de settings,
o SHA de referência do vertical e `Aspect`/`aspectOf`/`withFormat`; a linha da legenda deixa de ser "caminho antigo"
(`clean_words`/`group_words`/`caption_blocks`, usada pelo worker e pelo editor). Analista com 6 ou 8 frames;
`backtrackS` padrão 120 s; `duration` corrigido (padrão 60/90/120; `minS` 5–120). Nova seção "Retomada, render que
falha e cortes duplicados" (com `POST /v1/sessions/{id}/resume`). Editor: `settings.format` por corte, Programa ainda
em 9:16; `cover.atStart` agora também na `preview-render` com `fromS` = 0 (sai o "só no export"). Regra de reiniciar
só com a suíte verde; nota do `FakeJudge.ask`; evidência (170 passed medido) e lacunas novas.
- `gotchas.md`: itens 87 (reinício com código intermediário → cortes presos em `rendering`), 88 (retomada que checava
uma vez só), 89 (juiz recua o corte → duplicados), 90 (legenda empilhada com fala rápida) e 91
(`[contain:inline-size]`); item 77 ganha "a cópia herda sessões" e a 4521 de outra sessão; item 86 ganha
`requestStage: "Response"`; item 69 cita os 8 frames.
- `panel.md`: modal em quatro abas, `clipper-client.ts` (`Aspect`, `withFormat`), fila em 16:9, cartão da aba Sessões
(`sessionHealth`, altura fixa, "Retomar gravação").
- `tools.md`: evidência do Clipador → 170 passed; FFmpeg faz render vertical e horizontal (NVENC horizontal não testado).
- `SKILL.md`: `description` e linha do Clipador em "Onde mexer" citam formato, duração, retomada e duplicados.
## 1.17.0 — 16/11/2026
Redesenho do editor de cortes do Clipador (padrão de editor de vídeo) e camadas novas do projeto de edição.
- `clipper.md`: modo `cam_only` (`MODES`, `resolved_mode`, queda para `blur`); "Onde mexer" cita `normalize_cuts`,
`pick_hook`, `chat_events`, `build_filter`/`build_project_ass`, `chat_for`, `clipper/tests/test_editor_layers.py`,
os tipos espelhados no painel e os tokens `--color-nle-*`; regra do gancho por `pick_hook`; tabela dos campos
`cuts[].mode`, `cuts[].muted`, `overlays[].x`, `chat` e `cover.atStart` (só no export) com limites; ponteiro para
"Mexer com a mão" do README; limites (uma trilha de vídeo, sem B-roll); evidência (136 passed, teste de UI por
CDP informado) e lacunas refeitas.
- `panel.md`: seção "Editor de cortes" reescrita — desenho NLE, disposição com Camadas e monitor "Fonte · Programa",
trilhas C1/V3/V2/CAM/V1/A1/A2/A3/CH, modais no lugar das abas do inspetor, tabela de papel por arquivo (novos
`clip-editor-ui.tsx` e `clip-editor-layers.tsx`), gestos, "Salvar projeto", atalhos atuais (Ctrl+K, Ctrl+Shift+clique,
Ctrl+E, V/C/N, Home/End, ?). Sai a disposição antiga (inspetor em abas).
- `gotchas.md`: item 44 cita escapes como `\b`; item 73 cita o serviço antigo recusando `cam_only`; item 76 passa a
apontar para `pick_hook` (tempo da gravação no gancho); novos itens 85 (camadas do canvas achadas pelo cursor) e
86 (interceptar escritas em teste de UI sobre corte real).
- `tools.md`: evidência do Clipador → 136 passed.
- `SKILL.md`: `description` cita o editor no padrão de editor de vídeo e as camadas novas.
## 1.16.0 — 16/11/2026
Rastreio de reação do Clipador (câmera achada sem IA + expressões do rosto do streamer).
- `clipper.md`: pasta `data/clipper/models/` + `clipper/models.lock.json`; "Onde mexer" ganha `face.py`/`_face_loop`/
`face_bench.py` e `reaction.py` (`ReactionParams`), e cita `_face_moments`/`face_*` em `scoring.py`, `detect_cam`
local primeiro e `CAM_RETRY_S` em `intel.py`, a linha "Rosto do streamer" do analista e os componentes do painel
(`FaceSignal`, interruptor, selo da câmera); fonte de corte `face`; `faceTrack` no `PUT /v1/judge`; `detect-cam`
com YuNet, `?ai=true` e `cam_json.source`; timeout de 30 s de `face(/reset)`; nova seção "Rastreio de reação"
(stack e licenças, fluxo, sinal, regras de corte, modelos, rotas, bancada); evidência da bancada e lacunas; sai a
nota dos 2 testes de rosto instáveis (120 passed em 2 execuções).
- `tools.md`: tabela do rastreio (mediapipe 1.2.3, opencv-contrib-python 5.0.0.93, numpy 2.5.5, onnxruntime 1.32.0,
pesos e licenças) e descartados por licença; evidência do Clipador → 120 passed.
- `gotchas.md`: itens 79 (import do MediaPipe 1.2.3), 80 (`opencv-python-headless` junto), 81 (jawOpen/eyeWide não
sobem; risada pelo sorriso), 82 (agrupar pelo centro do grupo), 83 ("sustos" do rastreio perdendo o rosto) e 84
(neutro sorridente sem pico).
- `SKILL.md`: `description` e linha do Clipador em "Onde mexer" citam o rastreio de reação e o `models.lock.json`.
## 1.15.0 — 16/11/2026
Chat com a IA por seção no perfil do jogo (aba Jogos do Clipador).
- `clipper.md`: `POST /v1/games/{id}/refine` documenta `section` (`Literal`, 422 se inválido), `history` (máx. 20;
IA vê 8 turnos de 400 caracteres) e a resposta `{games, reply}`; `notes[].section?`; `REFINE_SCHEMA`,
`PROFILE_SECTIONS`, nova assinatura de `refine_game` e `Intel.refine` → `(profile, reply)`; painel com chat por
seção (padrão de "Confirmar na web" difere da API); evidência com IA simulada e lacuna da IA real.
- `panel.md`: redesenho do card do jogo em `clipper-games.tsx` (selo de iniciais, cartões por seção, `AiChat`,
selo "novo", chips de gírias, Fontes/Memória recolhidas).
## 1.14.0 — 16/11/2026
Editor de cortes do Clipador (`/clipper/edit/<id>`) e render único pelo projeto de edição.
- `clipper.md`: banco detalha v4 `edits` e v7 `origin`/`ai_project_json` + regra "nunca alterar migração aplicada";
pasta `edit-<id>/` (proxy, TTS); "Onde mexer" ganha `editor.py`, `editor_render.py`, `editor_api.py`,
`layout_chain` e a página do editor, e marca `media.render_vertical` como fora do render de cortes; timeout de
5 min do proxy; nova seção "Editor de cortes" (caminho do render, projeto da IA, origem/rejudge, tempo, validação,
rotas) apontando para o README e `doc/clip-editor-research.md`; evidência e lacunas do editor.
- `panel.md`: seção "Editor de cortes" (tela cheia sem mudar o layout raiz, disposição, componentes `clip-editor*`,
autosave com `rev`, atalhos) e botão "Editar"/"Continuar edição" em `clipper-queue.tsx`.
- `gotchas.md`: item 57 aponta para `editor_render.py`; novos itens 74 (palavra de duração zero), 75 (capa vazia
com mjpeg/faixa "tv"; `-g` curto em teste), 76 (gancho longo), 77 (instância de teste sobre cópia do banco:
`keep_hours = 0`, sem monitor/varredura) e 78 (emoji monocromático no libass).
- `SKILL.md`: `description` e linha do Clipador em "Onde mexer" citam o editor de cortes.
## 1.13.0 — 16/11/2026
Perfil do jogo editável no Clipador (aba Jogos).
- `clipper.md`: banco corrigido para `user_version` 7 (v4 `edits`, v5 `face_track`, v6 `games.notes_json`/`edited_at`,
v7 `edits.origin`/`ai_project_json`); "Onde mexer" cita `clean_profile`/`save_profile`/`refine`/`delete_note` e
`REFINE_SYSTEM`/`refine_game`; nova seção "Perfil do jogo" (rotas `PUT /v1/games/{id}`, `POST …/refine`,
`DELETE …/notes/{index}`, campos novos de `GET /v1/games`, pedido guardado × edição à mão); timeout de 8 min do
proxy vale para `research|refine`; evidência e lacunas.
- `panel.md`: `clipper-games.tsx` com Editar, Pedir à IA e pedidos guardados.
- `SKILL.md`: `description` cita o perfil do jogo editável.
## 1.12.0 — 17/11/2026
Fase 2 do Clipador.
- `SKILL.md`: `description` cita emotes, varredura da IA, juízes analista/editor, contexto do jogo, webcam e layout do
corte; linha do Clipador em "Onde mexer" cita o timeout por rota do proxy.
- `clipper.md`: banco v3 (colunas e tabelas `games`/`emotes`); "Onde mexer" com `emotes.py`, `intel.py`, `layout.py`,
`clipper-cut-settings.tsx`, `clipper-games.tsx`; novas seções "Como os momentos nascem" (mínimo proporcional, chat
fraco, varredura, aprendizado dos emotes), "Juízes" (analista + editor, `analystModel`, `backtrackS`, `-i`/`--search`
do Codex) e "Configuração do corte" (camadas, modos, rotas, timeouts do proxy); evidência da fase 2
(`pnpm test:clipper` → 46 passed) e lacunas (UI nova contra o serviço novo, juiz `claude`).
- `gotchas.md`: item 59 aponta para o mínimo proporcional; novos itens 68 (chat pequeno sem corte), 69 (título preso à
transcrição), 70 (crédito sobre o rosto no `cam_top`), 71 (cor ASS `&H00BBGGRR&` × `&HBBGGRR&`), 72 (download de
emotes fora da thread do chat), 73 (reiniciar o Clipador após código novo).
- `panel.md`: seção da página `/clipper` (modal do corte, aba Jogos e emotes, cartão com análise e recuo do início).
- `tools.md`: evidência do Clipador atualizada (46 passed, sem dependência nova); papel das CLIs nos juízes; APIs
públicas de emotes 7TV/BTTV/FFZ (chamada real não registrada).
## 1.11.0 — 16/11/2026
- `SKILL.md`:
- `description` cita Azure Speech, filtros de voz e clonagem de voz (Chatterbox, com consentimento);
- estrutura e portas: worker de clonagem na 4511 (`voice/.venv-clone`);
- "Onde mexer": arquivos do serviço de voz (`catalog.py`, `config.py`, `errors.py`, `voice/clone/worker.py`) e
do painel (`voice-cards.tsx`, `voice-clone-form.tsx`, `AzureForm`);
- "Voz e legenda" reescrita e enxugada: `setup.bat -Clone`, aba Catálogo com sub-abas, busca e filtros,
catálogo 62 → 76 vozes (14 Azure ocultas sem chave), Azure pelo painel/`voice/.env`, voz clonada
(`kind: "clone"`, consentimento, `503 clone_unavailable`, sem `speed`, marca d'água). Detalhes ficam no `voice/README.md`.
- `tools.md`: evidência `pnpm test:voice` → 133 passed; nova subseção "Clonagem de voz" (Python 3.12.13,
chatterbox-tts 0.1.7, torch/torchaudio 2.6.0+cu124, numpy 1.26.4, transformers 5.2.0, verificados no venv)
com os tempos do teste na GPU; Azure continua em candidatas como "código pronto, sem chave real".
- `gotchas.md`: item 44 ampliado (aspas, gravar o script em arquivo); item 53 cita `azure`/`clone` e o
reinício do worker; novos itens 62 (`w-full` fixo em `Select`/`Input` e `cx()` sem merge), 63 (`.tsx` CRLF),
64 (Xet travando o download, pesos não fixados), 65 (venv separado), 66 (timeout em fala clonada longa),
67 (`speed` ignorado e marca d'água PerTh).
## 1.10.1 — 16/11/2026
- `SKILL.md`: logo após "Documentos do projeto", um ponteiro para a skill `content-pipeline`
(metodologia de 8 etapas: o *quê* e o portão de cada etapa). Esta skill continua sendo o *como*
técnico. O conteúdo da `content-pipeline` não foi duplicado.
## 1.10.0 — 16/11/2026
- Novo `references/clipper.md`: Clipador (`clipper/`, 127.0.0.1:4520), banco `data/clipper/clipper.db`
(v2), pastas de blocos e cortes, tabela "Onde mexer", juiz pela CLI sem chave de API (Codex
`gpt-6-luna` padrão, Claude ou off; `PUT /v1/judge`), regras, evidência da live real e lacunas.
O arquivo aponta para `clipper/README.md` em vez de duplicá-lo.
- `SKILL.md`:
- `description` cita o Clipador;
- `clipper/README.md` entra nos documentos de consulta;
- estrutura ganhou a linha do Clipador, portas 4500/4510/4520 e banco do painel v3;
- "Onde mexer" ganhou a linha do Clipador e o passo 6b do setup;
- subida/testes incluem `pnpm test:clipper` e o aviso quando o Clipador não está instalado ou a porta está ocupada;
- a invariante de escopo agora diz que a publicação real em qualquer rede segue fora, que é a próxima fase pedida pelo usuário e que "Aprovar" só marca o corte;
- a seção "Manutenção" foi enxugada.
- `gotchas.md`:
- nova seção "Clipador", itens 57–61: `-ss` antes do `-i` com o filtro `ass`, `.upper()` quebrando a tag `\c`, falsos positivos com o chat calmo, pico escolhido antes do filtro de assentado, e hora do chat por `wall_end`;
- item 28 agora inclui o juiz do Clipador (`codex.js`);
- item 51 cita a migração v3.
- `tools.md`:
- nova seção do Clipador com versões verificadas: Python 3.12.13, FastAPI 0.159.1, uvicorn 0.54.0, httpx 0.28.1, websockets 17.4, Streamlink 8.6.3, pytest 9.1.1 e FFmpeg com libass;
- candidatas novas: publicação dos cortes (próxima fase) e chat do YouTube.
- `panel.md`: banco v3 (`account_channels`) e card/rotas "Canais de live".
## 1.9.0 — 16/11/2026
- "Voz e legenda": catálogo 15 → 62 vozes, motores novos `kokoro` (offline, CPU; feminina pt-BR
offline `kokoro-pf-dora`) e `google` (gTTS, online, só normal/lenta); campos do catálogo
`kokoroVoice`/`kokoroLang`/`googleLang`/`googleTld`; `ONLINE_ENGINES`; rótulo
offline/online nos selects do painel (`voiceOptionLabel()`); regra de URL do lock ampliada
para release versionado no GitHub. `description` cita os quatro motores.
- `tools.md`: kokoro-onnx 0.6.1, phonemizer 3.6.0, espeakng-loader 0.2.4, gTTS 2.5.4; teste das
54 vozes Kokoro (45 aprovadas) e tempos de síntese; `pnpm test:voice` → 127 passed; candidatas
Azure Speech e SAPI do Windows; vozes famosas do TikTok/CapCut marcadas "não copiar".
- `gotchas.md`: item 53 ampliado (motor novo exige reiniciar); itens 54 (int8 do Kokoro não roda),
55 (avisos "constant folding" do fp16), 56 (cache do sha256 na recarga do catálogo).
## 1.8.0 — 16/11/2026
- "Voz e legenda": catálogo recarrega sozinho (`_refresh_voices_if_changed` em
`voice/app/main.py`, chamado em `GET /v1/voices`, `GET /v1/voices/{id}` e
`POST /v1/synthesize`); catálogo com defeito mantém as vozes atuais. Substitui a instrução da
1.6.0 de chamar `POST /v1/voices/reload` após editar o catálogo (a rota segue para forçar).
- `gotchas.md`: item 53 (uvicorn sem `--reload` no `scripts/dev.ts`: código novo exige reiniciar).
- `tools.md`: evidência `pnpm test:voice` → 124 passed.
## 1.7.0 — 16/11/2026
- Novo `references/panel.md`: banco v2 (backup em `data/backups/`, `foreign_key_check`),
árvore de vertentes (`branch_count` 1–4, `file_key`, `status`, `branches_status`), votação A–D,
`prepareBranches` + fila em `onAgentRunClosed`, contas (redes `mock`) e dashboard com métricas
simuladas; evidência e lacunas.
- `SKILL.md`: estrutura com `<file_key>` e `.choices.json`; limitação do overlay (só A/B);
painel é do usuário; linha "Onde mexer" das vertentes/contas/dashboard; `description` ampliado.
- `tools.md`: `@xyflow/react` 13.0.1.
- `gotchas.md`: itens 48–52 (clique no xyflow, rolagem do canvas, `grid-cols-1`, conexão em
`globalThis`, `.mts` + `file:///`).
- Pedido como 1.6.0, mas essa versão já tinha sido usada por outra rodada (catálogo de vozes).
## 1.6.0 — 16/11/2026
- "Voz e legenda": catálogo base com 15 vozes (Piper offline faber/cadu/jeff; Edge pt-BR, pt-PT e
`multi-*`), ponteiro para a tabela de `voice/README.md`; voz nova no catálogo entra com
`POST /v1/voices/reload`, sem reiniciar.
- `tools.md`: papéis de edge-tts/piper atualizados, evidência do catálogo de 15 vozes, `edresson`
fora; RVC pt-BR no Hugging Face sem licença clara → nada em `user-voices.json`.
- `gotchas.md`: itens 45–47 (Edge `NoAudioReceived`, acentos no teste manual do Piper,
`faster_whisper.decode_audio` com o PyAV do venv — só teste avulso).
## 1.5.0 — 16/11/2026
- Página Vozes do painel (`/voices`): seção "Voz e legenda" (ouvir, voz de personagem com
origem/licença, legenda + `.srt`, configurações que gravam `voice/.env` e reiniciam o serviço);
`description` cita `.srt` e a página.
- "Onde mexer": linhas da página Vozes (`panel/src/lib/voice.ts`, `api/voice/*`, `voice-*`),
formato de história (`STORY_FORMATS` + `StoryKind`, `DescribedSelect`) e logo/ícones
(`logo.tsx` + `app/icon.svg` juntos, `shrink-0`).
- `VOICE_DEVICE=auto` agora escolhe CPU com GPU ocupada na subida; `422 rvc_failed`.
- `tools.md`: 122 testes, medição da legenda na CPU, modelos RVC candidatos sem licença.
- `gotchas.md`: item 31 reescrito (auto + nova medição); itens 40–44 (órfão na 4510, `.pth`
não-RVC, ícone que some, grade da barra lateral, heredoc que perde `\\`); números estáveis.
## 1.4.1 — 16/11/2026
- `gotchas.md`: itens 37–39 do `setup.ps1` (`Select-Object -First 1` no `nvidia-smi` escondia a
GPU, variante explícita do torch no `uv`, `ErrorActionPreference` e stderr do uv).
- `tools.md`: torch `2.11.0+cu128` com CUDA verificado, `VoiceConverter` em `cuda:0`,
pré-requisitos do Applio baixados, setup repetível (2x saída 0); RVC ponta a ponta segue não verificado.
## 1.4.0 — 16/11/2026
- Serviço de voz (`voice/`, 127.0.0.1:4510): seção "Voz e legenda" no `SKILL.md` apontando para
`voice/README.md`; linhas novas em "Várias histórias" e "Onde mexer" (serviço, catálogo/lock,
`setup.bat`/`start.bat`); `description` cobre narração, RVC, transcrição e instalação/subida.
- Escopo: painel/API/banco saíram de "fora do escopo" (já existem); Applio próprio em
`voice/vendor/applio`, Applio pessoal do usuário continua intocável.
- `tools.md`: seção do serviço de voz com versões verificadas (uv 0.11.26, Python 3.12.13,
edge-tts 7.3.1, piper-tts 1.8.0, faster-whisper 1.2.1, ctranslate2 4.8.3, Applio 3.7.0,
torch 2.11.0), evidência `pnpm test:voice` 117 passed; integração com o render como candidata.
- `gotchas.md`: itens 30–36 (cuBLAS na 1ª inferência, GPU disputada, Edge 403, lock do Piper,
LRU no Windows, `\\` no `package.json`, BOM do `setup.ps1`).
## 1.3.0 — 16/11/2026
- Codex CLI 0.169.0 integrado ao painel (flags e eventos verificados); `AGENTS.md` na raiz.
- Novo agente `cenaforge-dashboard-designer` (opus, a pedido do usuário: design exige mais capacidade) para a interface do painel.
- `gotchas.md`: itens 27–29 (Codex fora de Git, shims do npm, ruído do stderr).
## 1.2.1 — 16/11/2026
- Convenção de portas: faixa 4500–4599; painel movido de 4310 para 4500.
## 1.2.0 — 16/11/2026
- Estrutura para várias histórias: `stories/<história>/`, `config/<história>-epNN.json`,
assets por história e biblioteca `assets/library/`.
- Painel Next.js (`panel/`, `pnpm panel`, porta 4310): histórias, episódios, render com player,
votação A/B, assets e agentes Claude/Codex pela CLI. Linha na tabela "Onde mexer".
- `tools.md`: Next.js, `node:sqlite`, Claude Code CLI 2.1.314; Codex como candidato não testado.
- `gotchas.md`: itens 22–26 (porta, `.cmd`, Next 16.4, `.mts`, stdin do `claude -p`).
## 1.1.1 — 16/11/2026
- `godot/scripts/` organizado em `core/` (main, scene_config, timeline_controller),
`builders/` (street_builder, rider_builder, facade_painter) e `view/` (camera_controller,
overlay_controller); caminhos da tabela "Onde mexer" atualizados.
- Pasta `stories/` criada com guia de estrutura (usada pelo `cenaforge-story-writer`).
## 1.1.0 — 16/11/2026
- Economia de tokens: `references/token-economy.md` (modelo por tarefa, regras de leitura barata).
- Scripts Python (biblioteca padrão) em `scripts/`: `runs_summary.py`, `inspect_strip.py`,
`new_scene.py`, `check_skill.py`, `clean_runs.py`, mais `_common.py`. Testados nos casos
normal e de erro.
- Agentes novos: `cenaforge-story-writer` (sonnet; enredo, diálogos, overlay em `stories/`) e
`cenaforge-token-auditor` (sonnet; encontra repetição e cria scripts).
## 1.0.1 — 16/11/2026
Correções vindas da primeira auditoria do `cenaforge-skill-updater` (rodada sem edição):
- "Onde mexer": listas fechadas do contrato (`LIGHTING_PRESETS`, `RIDER_ASSETS`,
`BACKGROUND_MODES`) apontadas em `scene_config.gd`.
- Receita: opções do `render` e `pnpm verify`; tempo da prévia corrigido para 42–44 s.
- Validação: comando da tira generalizado para qualquer FPS/duração, gravando em `inspect/`;
aviso de que os quadros de `inspect/` são fixos até 11 s.
- `tools.md`: origem real das configurações do renderizador; proporção do tempo de render corrigida.
- `gotchas.md`: cabeçalho diz quais itens têm registro no TEST_RESULT; seção inclui TypeScript.
## 1.0.0 — 16/11/2026
- Criação da skill a partir da prova de conceito validada (ver `doc/TEST_RESULT.md`).
- Pipeline JSON → Godot 4.7.2 (Mobile) → PNG → FFmpeg 7.1.1 (libx264) → FFprobe.
- Receita de vídeo, mapa "onde mexer", invariantes, checklist de validação.
- `references/tools.md`: inventário com versões verificadas e critérios para ferramentas novas.
- `references/gotchas.md`: 21 armadilhas observadas no teste.