# 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.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 " 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 " 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". - `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//`, 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//godot/-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"`, `` único em `app/layout.tsx` com fila e `` 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/-/`, 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/`) 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-/` (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 `` 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//`, `config/-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.