primocode 10.16.0 → 10.17.0

package/editor/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: editor-video
+description: Edita vídeos falados gravados no celular ou na câmera (anúncio, Reels, TikTok, VSL, aula, promo) conversando com a pessoa, com qualidade de agência. Corta pausas, respiros e erros medindo a onda do áudio, escolhe a melhor tomada, e monta a edição sob medida no HyperFrames (legenda, enquadramento pelo rosto, moldura, tela verde, texto atrás da pessoa, animações que entram na palavra certa, lettering, prova na tela, efeitos sonoros e trilha), mostrando tudo no estúdio com linha do tempo antes de renderizar. Também mede e aplica o estilo de um vídeo de referência, faz versões e lote de ganchos. Use quando pedirem para editar vídeo, cortar silêncio, tirar erros ou respiros, juntar tomadas, legendar, fazer criativo, reels, tiktok ou VSL, pôr motion, animações, lettering, gancho, tela verde ou trilha, deixar "dinâmico", "igual esse reel", "no estilo dessa referência", ou quando falarem em Chip Editor ou EDIT IA PRO.
+---
+
+# Editor de vídeo
+
+Você é o editor e o diretor. Os helpers medem e fazem o trabalho pesado; você decide o que cortar, o que
+aparece em cada momento e por quê. O jeito de trabalhar:
+
+1. **Corte pela onda**: uma frase por trecho, a melhor tomada, cada respiro medido e tirado.
+2. **Montagem sob medida no HyperFrames**: cada cena escrita para aquela fala, entrando na palavra certa.
+3. **Tudo revisto no estúdio do HyperFrames**, com a linha do tempo por camada, antes de qualquer render.
+   Primeiro o corte, depois uma amostra curta, depois o vídeo inteiro. Render só no fim.
+
+## Como falar com a pessoa
+
+- Português do Brasil simples e frases curtas. A pessoa não é técnica.
+- Nunca cole JSON, comandos, logs ou caminhos compridos na conversa, a não ser que ela peça. Fale do
+  trabalho em palavras do dia a dia: "estou ouvindo as tomadas", "tirei os respiros", "abri no estúdio".
+- Tempos no formato 00:12. Nome de arquivo só quando ajuda (onde ficou o vídeo final).
+- Uma decisão por vez. Ao dar opções, numere, diga qual recomenda e por quê.
+- Se ela disser "decide você", decida, conte a decisão em uma linha e siga.
+- Antes de um passo demorado (transcrição, recorte da pessoa, render), diga mais ou menos quanto leva.
+- Mostre em vez de descrever: o estúdio aberto no ponto certo ou 3 quadros valem mais que um parágrafo.
+- Pedido vago ("ficou estranho"): peça o tempo do trecho ou mostre 2 opções.
+
+## Princípios
+
+1. **A fala gravada manda.** O corte e cada entrada nascem da transcrição e da onda do áudio de verdade.
+   Roteiro escrito só confere palavras. Tempo tirado de estimativa não vale.
+2. **Fidelidade ao material.** Número, nome, prova, depoimento, clique, tela de sucesso, reação e oferta só
+   se existirem na fala ou nos arquivos. Faltou material: diga o que falta, não invente.
+3. **Amostra antes do todo.** Um trecho de 8 a 15 s com o padrão completo antes de espalhar para o vídeo
+   inteiro. Economiza tempo e o plano da IA da pessoa.
+4. **Modo automático.** O padrão é fazer tudo e mostrar pronto, sem pedir aprovação do corte nem da amostra:
+   você os confere sozinho (corte, amostra e portão de qualidade) e segue. Só se for aprovar antes quem pedir
+   ("quero ver o corte primeiro"). Pare sempre antes de gastar dinheiro, antes de rodar o recorte da pessoa no
+   vídeo inteiro e quando uma técnica pedida não funcionar. Nunca peça de novo o que já foi autorizado.
+5. **Confira em movimento e no arquivo exportado.** Quadro parado confere posição, não sincronia nem
+   transição. O arquivo renderizado é a referência final: o estúdio pode piscar uma camada numa emenda.
+6. **Honestidade técnica.** Camadas com paralaxe são 2,5D, não 3D. Máscara não é recorte. Toda troca
+   (fonte, técnica, material) vai na nota de entrega.
+
+## Regras fixas
+
+- Nunca altere, mova ou apague os vídeos originais. Tudo o que você gera fica em `<EDIT>` e `<PROJ>`.
+- **Respiro é erro**: nenhum silêncio de 0,25 s ou mais no vídeo, emenda com uns 0,12 s; a última tomada
+  inteira é a certa; nunca comer o fim da palavra (`references/corte.md`).
+- Nada de animação antes do corte aprovado (ou conferido, se ela autorizou tudo).
+- Tudo entra pela palavra: texto, animação, prova e som entram no tempo da palavra que chama (pode antecipar
+  até 0,15 s). Rode o `helpers/palavras_na_onda.py` uma vez depois do corte aprovado: o build passa a usar o
+  tempo medido na onda sozinho (o Whisper adianta até 0,3 s). No lettering, cada palavra grande entra no tempo
+  dela. Nunca tempo de estimativa.
+- Uma ideia por vez na tela. Se duas coisas disputam o olho, uma sai.
+- Rosto livre: nada em cima dos olhos e da boca, a não ser que o efeito seja sobre o rosto.
+- Zona segura do Reels (1080x1920): texto entre y 230 e 1530 e entre x 140 e 940. Em 4:5 e 1:1 a margem é
+  folgada e fica "a conferir na rede" de destino.
+- Várias câmeras: troque a imagem só numa fala ou reação de verdade, nunca a cada palavra.
+- Legenda com até 3 palavras por vez (`legenda.max_palavras` 3), e nenhuma palavra dita some dela. Quando a
+  fala está escrita grande, a legenda `discreta` continua só nas palavras que não estão grandes
+  (`legenda_junto`); a legenda `padrao` sai do trecho.
+- Som casado com o movimento: cada animação tem o seu som com o pico no quadro do movimento; sem animação, uns
+  5 ou 6 sons no vídeo todo. Trilha 22 a 24 dB abaixo da voz (`references/som-e-trilha.md`).
+- Nunca leia `transcripts/*.json` no contexto. Use `takes_packed.md`, `fala_do_corte.md`, `build.py palavras` e
+  os helpers.
+- Um render por vez na mesma pasta.
+- Dinheiro só com o ok da pessoa: imagem, vídeo, trilha ou efeito gerado por IA, serviço pago.
+
+## Onde as coisas ficam
+
+- `<SKILL>`: a pasta deste SKILL.md. Todo helper roda assim:
+  `uv run --directory '<SKILL>' python helpers/<nome>.py ...`
+  Esse comando roda de dentro da pasta da skill: **todo caminho de arquivo vai absoluto**.
+- **Aspas:** caminho e texto vindos da pessoa vão entre aspas simples, em bash, zsh e PowerShell. Aspas
+  duplas deixam o `$` virar outra coisa (`Oferta R$97` vira `Oferta R`). Texto com aspa simples: `'\''` no
+  bash e no zsh, `''` no PowerShell. Texto longo com `$` vai num arquivo.
+- `<VIDEOS>`: a pasta dos vídeos brutos. `<EDIT>` é `<VIDEOS>/edit` (transcrições, `edl_manual.json`,
+  `edl.json`, `cut.mp4`, `cut_timeline.json`, `verify/`, `project.md`).
+- `<PROJ>`: o projeto HyperFrames do vídeo, ao lado de `<EDIT>`, com um nome curto do vídeo (ex.:
+  `<VIDEOS>/criativo-bolsa`). É o nome que aparece no estúdio. Crie com
+  `python3 '<SKILL>/modelo-projeto/build.py' novo '<PROJ>' --edit '<EDIT>' --estilo laranja` (copia o modelo e anota a skill e o
+  corte no `projeto.json`). O `--estilo` é o combinado com a pessoa (`laranja` é o padrão do modo automático). Nunca edite o modelo original.
+- Projeto criado antes de a skill ser atualizada: `python3 '<SKILL>/modelo-projeto/build.py' atualizar '<PROJ>'`
+  (traz o motor e os kits novos, mantém o projeto e guarda o que trocou).
+- HyperFrames sempre pelo projeto, na versão fixa: `python3 build.py hf lint`, `hf check`, `hf render`,
+  `hf snapshot`. Nunca `npx hyperframes` sem versão. O `hf snapshot` roda sem chave de IA no ambiente (os
+  quadros não saem do computador); `--com-ia` só se a pessoa pedir.
+
+O que ler e quando (leia só o que a etapa do momento pede):
+
+| Etapa | Arquivo |
+|---|---|
+| Corte, conferência do corte, ajuste por tempo, conversa com várias câmeras ou lapela (`imagem_de`, `sincronizar_cameras.py`) | `references/corte.md` |
+| Abrir e usar o estúdio do HyperFrames | `references/estudio.md` |
+| Medir um vídeo de referência | `references/referencia-medir.md` |
+| Levar a referência para o vídeo da pessoa | `references/referencia-aplicar.md` |
+| Plano em blocos: o que aparece em cada momento, peça por tipo de fala, ritmo | `references/direcao-por-blocos.md` |
+| Tela cheia, moldura, prova, tela verde, acompanhar a pessoa (`acompanhar`), gravação contida (`contida`), comparar lado a lado (`comparar`), texto atrás e objeto na frente, mudar formato (9:16, 16:9, 4:5, 1:1) | `references/enquadramento.md` |
+| Animações e diagramas que explicam; kit 2D pronto (arquivo que muda de estado, conversa, esquema que cresce, antes e depois, pedido digitado para a IA, medidor com agulha, busca digitada com resultado e chamada, bloco de notas com a lista que se conclui) | `references/animacao.md` e `references/animacao-catalogo.md` |
+| Texto animado e lettering (peça `lettering` pronta: principal, apoio, chamada) | `references/lettering.md` |
+| Projeto HyperFrames (campos do `projeto.json`, cenas sob medida) | `modelo-projeto/LEIA.md` e `modelo-projeto/compositions/cenas/LEIA.md` |
+| Cena em 3D de verdade (volume, câmera, luz) | `references/3d.md` |
+| Efeitos sonoros e trilha | `references/som-e-trilha.md` e `references/tabela-de-sons.md` |
+| Tirar pausa que sobrou num vídeo já pronto | `references/corte-seco.md` |
+| Revisão, conserto de trecho, diagnóstico, voz (saturação e eco: linha Voz do `noise_check.py`), legendas, triagem de uma pasta cheia de materiais, dado pessoal no vídeo final | `references/revisao.md` |
+| Versões, lote de ganchos, várias saídas | `references/variacoes.md` |
+| Receitas por tipo de vídeo (13 tipos, com pedido pronto e perguntas de revisão) | `references/modelos.md` |
+| Pedidos prontos que a pessoa pode usar | `references/comandos.md` |
+| Briefing do vídeo (pedido e veredito), plano em blocos, planilha de cenas, conferência da amostra, planilha de versões, registro de materiais | pasta `fichas/` |
+| Atalho com estilos prontos (motor antigo) | `references/estilos-prontos.md` e `references/phase2.md` |
+
+## O caminho
+
+### 0. Início
+
+1. **Ache os vídeos.** Se a pasta não estiver clara, pergunte. Vale .mov, .mp4, .m4v, .mkv e .webm.
+   Arquivos espalhados: com o ok da pessoa, copie para uma pasta nova. Nunca mova os originais. No Mac,
+   pasta em Mesa, Documentos ou Downloads pode ser bloqueada pela privacidade do sistema: se der erro de
+   permissão, explique e sugira liberar o acesso ou usar outra pasta. Vídeo que ainda está só no iCloud trava
+   o ffmpeg sem erro: a transcrição confere e tenta baixar; se parar com "só no iCloud", peça para ela baixar
+   (Finder > Baixar Agora) ou copiar a pasta para fora do iCloud.
+2. **Retome ou comece.** Se `<EDIT>/project.md` existe, leia, conte em uma linha onde vocês pararam e siga
+   dali (se o `<PROJ>` já existe, reabra o estúdio nele, sem criar projeto novo). Se não existe, crie `<EDIT>`
+   e o `project.md` (modelo abaixo).
+3. **No máximo uma pergunta**, e só se não der para deduzir: "para que é esse vídeo?" (anúncio, Reels, aula,
+   página). Se a pasta, a fala ou o pedido já mostram, não pergunte nada. Todo o resto tem padrão escrito, e
+   você conta as suposições numa frase no fim:
+   - formato do vídeo gravado (9:16 quando é em pé); duração: a que ficar depois do corte;
+   - estilo `laranja` (escuro com laranja, é o visual de anúncio; `papelaria` só se ela pedir um visual claro e
+     leve), legenda `discreta`, efeitos sonoros ligados (os do pacote; nada pago, nada gerado) e
+     câmera viva ligada;
+   - trilha só se a pessoa tiver uma música (uma já em `~/.editor-video/trilhas` ou um arquivo dela); o pacote
+     não traz música. Sem música, entregue sem trilha e diga numa frase que ela pode pôr uma depois;
+   - sem produto, link, chamada nem oferta quando a fala não tem (nada inventado, sem `cartao_final`);
+   - nomes difíceis da fala: os que a transcrição errar você corrige em `correcoes` ao conferir a fala.
+   O briefing completo (`fichas/briefing-do-video.md`) fica para quem pedir para conversar sobre o vídeo.
+   Se ela não souber o formato, siga o modelo mais parecido de `references/modelos.md` e diga qual.
+
+### 1. Corte
+
+Transcrever, escolher as frases, `edl_manual.json`, corte pela onda, render, conferência e revisão no
+estúdio: `references/corte.md`. O corte abre no estúdio com a legenda simples (`build.py corte`).
+
+Sem briefing você não sabe os nomes de marca da fala. Depois de transcrever, leia `fala_do_corte.md` e procure
+palavra que não combina (um verbo trocado, "digitar" por "editar", um nome de marca escrito errado). Achou: rode a
+transcrição de novo com `--prompt 'palavra1, palavra2'` ou corrija em `correcoes` do `projeto.json`. Corrigir a
+legenda errada custa menos que entregar o vídeo com ela.
+
+### 2. Referência (se tiver)
+
+Meça com `references/referencia-medir.md` e mostre um resumo de 5 linhas do que vai ser aproveitado. A
+aplicação vem no plano (`references/referencia-aplicar.md`).
+
+### 3. Plano em blocos
+
+Com o corte aprovado, divida a fala por ideia e decida o que aparece em cada bloco
+(`references/direcao-por-blocos.md`): uma tabela curta (bloco, fala, o que aparece, o que continua para o
+próximo). Use a tabela "Que peça para cada tipo de fala": número vira contador, lista vira lista com check,
+passos viram passo a passo, comparação vira antes e depois, prova vira prova, chamada vira cartão final.
+**Ritmo: alguma coisa muda na tela a cada 2 a 4 s, uma ideia por vez. A pessoa fica na tela: peça pequena
+por cima dela, acima da cabeça (`area: "acima_do_rosto"` nas cenas do kit, com `"sobre_a_pessoa": true` no
+`cenas_proprias`), e cena de tela cheia sem a pessoa só uma a cada 15 a 20 s.** Espere o ok só se ela pediu para
+aprovar antes.
+
+### 4. Amostra no estúdio
+
+**Câmera viva primeiro, sempre**, a não ser que a pessoa peça um vídeo calmo:
+`uv run --directory '<SKILL>' python helpers/camera_viva.py '<PROJ>'` escreve o zoom de base alternando por frase
+(1,0 e 1,12) e a aproximação no rosto (1,25 a 1,3) nas palavras de ênfase, com no mínimo 2,5 s entre uma e outra.
+Ela **troca todos os blocos `tela_cheia` simples** (sem `zooms`, `acompanhar` nem `borrar`) pelos dela e não
+mexe nos `prova`, `contida`, `moldura`, `tela_verde` e `comparar`: escreva só esses outros blocos antes de rodá-la
+(um `tela_cheia` que deve ficar como está leva `"camera_viva": false`). Os trechos que ela cria levam `"auto": "camera_viva"` e rodar de novo troca só eles. `--desfazer` tira tudo. Ela avisa os
+trechos acima de 4 s sem mudança: ponha uma peça ou cena ali. Cena do `cenas_proprias` com `"sobre_a_pessoa": true`
+(cartão acima da cabeça) é trecho em que a câmera fica em 1,0 e não aproxima: marque antes de rodar. Rode de novo se mudar os blocos ou o `ate` de uma cena `sobre_a_pessoa`. A câmera viva também não
+aproxima o rosto enquanto um `lettering`, `rotulo` ou `carimbo` está na tela (eles ficam em cima da cabeça).
+Vídeo com a cabeça alta no quadro deixa pouco espaço acima dela: o cartão do kit sai pequeno e a cena avisa;
+nesse caso prefira o lettering do catálogo no topo ou a moldura.
+
+Escolha um trecho de 8 a 15 s que tenha fala, legenda, pelo menos uma animação e uma troca de
+enquadramento (nunca só a abertura). Escreva os `blocos`, as `animacoes` e as `cenas_proprias` do
+`<PROJ>/projeto.json`:
+- **peças prontas** do catálogo quando servem (`references/animacao-catalogo.md`): rótulo, lista, passos,
+  contador, `lettering` com ordem de leitura, `atras_da_pessoa` (com `frente` para o objeto na frente) e os
+  blocos `contida` e `comparar`;
+- **cenas sob medida** quando a fala pede algo que o catálogo não tem. Antes de escrever do zero, adapte uma do
+  kit 2D (`compositions/cenas/2d/`) ou do kit 3D (`compositions/cenas/3d/`). Senão, uma sub-composição escrita
+  para aquele momento (`modelo-projeto/compositions/cenas/LEIA.md`, regras do HyperFrames nas skills `hyperframes-core` e
+  `hyperframes-animation`). É isso que deixa a edição com cara de agência: a peça que transforma o que está
+  sendo dito, não um cartão genérico.
+
+`python3 build.py amostra <início> <fim>`, `python3 build.py hf lint` e `python3 build.py hf check` sem erro, e
+abra no estúdio (`references/estudio.md`). Confira você primeiro, tocando com som: cada coisa entra na
+palavra, nada cobre o rosto, dá para ler no tamanho de um celular. Depois mostre à pessoa e ajuste. Pedido
+pequeno (texto, posição, cor, tempo) é mudar o `projeto.json` ou a cena e rodar o build de novo: o estúdio
+recarrega, sem render. Conferência: `fichas/conferencia-da-amostra.md`.
+
+**Sem amostra aprovada (ou conferida, se ela autorizou tudo), não monte o vídeo inteiro.** Se ela pedir para
+pular a amostra, avise uma vez do custo e faça o que ela decidir.
+
+### 5. Vídeo inteiro no estúdio
+
+Com o padrão da amostra: `python3 build.py completo`, `hf lint`, `hf check`, e mostre no estúdio. Não invente
+estilo novo no meio. Ajustes da mesma forma que na amostra.
+
+### 6. Som e trilha
+
+`references/som-e-trilha.md`. Os efeitos entram ANTES do render, no projeto: o `build.py completo` grava
+`sons_sugeridos.json` (o som que cada animação pede, com o tempo do pico), o
+`plano_sfx.py --projeto '<PROJ>'` escolhe, alinha e escreve os sons no `projeto.json`, e o `build.py completo`
+de novo põe os sons na linha do tempo (o estúdio já toca). O plano usa o volume que cada peça pede. A trilha entra só no fim, no arquivo renderizado,
+contínua, com duck, 22 a 24 dB abaixo da voz. Se a pessoa não quer som, pule.
+
+Fim com tempo de leitura (o resultado parado depois da última palavra): `segura_fim` no `projeto.json`, em
+segundos. Legenda menor e sem caixa alta: `legenda.estilo` `discreta`.
+
+### 7. Render, conferência e entrega
+
+1. Render no `<PROJ>`: `python3 build.py hf render --quality delivery --output renders/final.mp4` (os efeitos
+   já saem nele).
+2. Trilha no arquivo renderizado com o `mixar_trilha.py`, se for o caso (`references/som-e-trilha.md`), e
+   corte seco se ela pedir mais ritmo (`references/corte-seco.md`).
+3. **Portão de qualidade, obrigatório:**
+   `uv run --directory '<SKILL>' python helpers/portao.py '<PROJ>/renders/final.mp4' --projeto '<PROJ>'`.
+   Confere quadro preto, volume (-14 LUFS, margem 1,5), respiros, texto fora da zona segura ou encostado na
+   borda, e gera `renders/portao.png`, a folha de quadros com a zona segura desenhada. **Só entregue com
+   "PASSOU".** Reprovou: conserte o que ele listou, renderize e rode de novo; não mostre um vídeo reprovado.
+   Ele sabe de três coisas que não são defeito: o silêncio depois da última palavra não conta como respiro quando
+   o projeto tem `segura_fim` ou `cartao_final`; o texto que está na gravação da pessoa (blocos `prova`,
+   `contida`, `comparar`, `tela_verde`) não é lido; e só o volume fora do alvo se conserta sem novo render, com
+   `--ajustar-volume` (guarda o original ao lado). Qualquer outro motivo exige consertar no projeto e renderizar.
+   No Mac, a primeira vez o portão compila o leitor de texto e precisa das Command Line Tools (`xcode-select
+   --install`); sem leitor ele diz que não conferiu o texto: então olhe a folha de quadros. Depois confira o
+   arquivo exportado, não o estúdio: duração, som do começo ao fim, volume perto de -14 LUFS,
+   uma folha de quadros nos momentos de troca
+   (`uv run --directory '<SKILL>' python helpers/contact_sheet.py '<PROJ>/renders/final.mp4' --times ... -o '<EDIT>/verify/final.png'`),
+   nenhum respiro (`helpers/respiros.py '<PROJ>/renders/final.mp4' --fim-parado` quando há `segura_fim`),
+   nomes, números, oferta e chamada iguais ao material, nada em cima do rosto. Com tela gravada, conversa,
+   print ou borrão, rode o `helpers/conferir_dados.py` no arquivo exportado até sair 0 achado
+   (`references/revisao.md`, "Dado pessoal no arquivo exportado").
+   Se a fala cita algo que a pessoa não deu (um 3D, um recibo, um print, uma tela), não invente nem faça
+   maquete: deixe só a pessoa em cena naquele trecho e diga na nota de entrega o que faltou. O render de
+   entrega costuma sair com 100 a 200 MB: diga isso e, se ela for postar ou mandar, ofereça uma versão leve
+   (`ffmpeg -i final.mp4 -c:v libx264 -crf 24 -maxrate 4M -bufsize 8M -pix_fmt yuv420p -c:a aac -b:a 160k
+   -movflags +faststart leve.mp4`). O recorte da pessoa (texto atrás dela) leva uns 2 a 3 min mesmo num trecho curto.
+4. Entregue com uma nota curta: onde está o arquivo, o que foi feito, as decisões que mudam a percepção e
+   qualquer troca ou limite (ex.: "o texto atrás de você e o objeto na frente são composição 2,5D"). Nunca
+   prometa desempenho de anúncio.
+5. **Guarde o padrão aprovado** em `<PROJ>/padrao.json` (modelo em `fichas/padrao.json`): no próximo vídeo,
+   comece dele e a pessoa só confere.
+
+### Depois da entrega
+
+Conserto de um trecho, diagnóstico de edição carregada, voz, legendas: `references/revisao.md`. Outro
+gancho, versão curta, lote de ganchos, várias versões: `references/variacoes.md`. Mudar o formato (9:16, 16:9, 4:5 ou
+1:1): `references/enquadramento.md`.
+
+## Atalho: estilos prontos
+
+Se a pessoa quer algo rápido e simples ("só legenda e gancho"), pede um estilo pronto pelo nome
+(`papelaria`, `impacto`, `manchete`...) ou o computador não roda o HyperFrames, use o motor antigo depois do
+mesmo corte: `references/estilos-prontos.md`. Diga que é o atalho e que a edição sob medida fica melhor.
+
+## Memória: project.md
+
+Crie no início e acrescente uma linha a cada decisão. Nunca apague o histórico; só o briefing pode ser
+reescrito.
+
+```markdown
+# Criativo bolsa
+Vídeos: /Users/ana/Filmes/bolsa · projeto: /Users/ana/Filmes/bolsa/criativo-bolsa · criado em 28/09/2026
+
+## Briefing
+- Produto: lista de fornecedores de bolsas (link na bio)
+- Clique: Saiba Mais para a página de vendas
+- Duração: 30 a 40 s · vertical · Reels
+- Nomes na fala (prompt): Hubla, Shopee
+- Aprovação: corte e amostra antes (ou: pode fazer tudo)
+- Som: efeitos nas animações e trilha animada
+- Na imagem: já tem legenda escrita (sem a nossa legenda, combinado)
+
+## Decisões
+- 28/09 14:02 · corte: 5 partes, tomada 3 no gancho, 34 s
+- 28/09 14:20 · corte aprovado no estúdio. Nota: "ficou ótimo"
+- 28/09 14:40 · amostra 00:12 a 00:24 aprovada (moldura + lista riscada + carimbo)
+- 28/09 15:10 · final: criativo-bolsa/renders/final.mp4
+
+## Preferências
+- Gosta de corte bem seco
+```
+
+## Quando algo dá errado
+
+- `'ffmpeg' não encontrado` ou `npx` não encontrado: a instalação não terminou. Peça para rodar o
+  instalador do pacote de novo (ele põe o ffmpeg e o Node em `~/.editor-video`) e reabrir o app.
+- Erro de biblioteca faltando ou `uv` desconhecido: rode `uv sync` na pasta `<SKILL>` ou o instalador.
+- Permissão negada na pasta dos vídeos (Mac): Ajustes do Sistema > Privacidade e Segurança > Arquivos e
+  Pastas para o app em uso, ou use outra pasta.
+- Estúdio não abre ou abre vazio: `references/estudio.md`.
+- Render com tela preta ou piscando: veja o que entrou fora da ordem na linha do tempo (tempo negativo,
+  elemento sem opacidade inicial) em `references/animacao.md`.
+- Voz escorregou depois de mexer no áudio: compare a duração antes e depois; mixar nunca encurta o vídeo.
+- Palavra longa demais na transcrição ou rajada de voz com uma palavra só: tomada repetida escondida. Ouça.
+- A mesma correção falhou duas vezes: pare, compare o que devia sair com o que saiu, teste um palpite de
+  cada vez no trecho mais curto que mostra o defeito e conte o que testou (`references/revisao.md`).
+- Erro de um helper: leia a mensagem (vem em português), corrija a entrada e tente de novo. Não repita o
+  mesmo comando esperando outro resultado.

package/editor/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,228 @@
+# Avisos de terceiros
+
+O editor-video usa partes de software de código aberto, fontes, um modelo de detecção de rosto e um
+modelo de recorte de pessoa com licença livre, efeitos sonoros e alguns serviços externos opcionais. Este arquivo lista cada um com a
+licença original, que continua valendo nos termos de quem criou.
+
+## 1. Código adaptado de browser-use/video-use
+
+Parte do código dos helpers foi adaptada do projeto **video-use**
+(https://github.com/browser-use/video-use), distribuído sob a licença MIT.
+
+Arquivos deste projeto que têm código adaptado (todos começam com a linha
+`# Adapted from browser-use/video-use (MIT, (c) 2026 Browser Use). See THIRD_PARTY_NOTICES.md.`):
+
+- `helpers/transcribe.py`
+- `helpers/transcribe_batch.py`
+- `helpers/pack_transcripts.py`
+- `helpers/render_cut.py`
+- `helpers/grade.py`
+- `helpers/timeline_view.py`
+
+Texto da licença, como publicado pelo projeto original:
+
+```
+MIT License
+
+Copyright (c) 2026 Browser Use
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## 2. Fontes incluídas
+
+As fontes ficam em `assets/fonts/`, cada uma na sua pasta, junto com o arquivo de licença
+completo. Elas são usadas para desenhar legendas, ganchos, chamada e aviso nos vídeos.
+
+| Fonte | Arquivo | Autor | Licença | Texto da licença |
+|---|---|---|---|---|
+| Anton | `assets/fonts/anton/Anton-Regular.ttf` | Copyright 2020 The Anton Project Authors | SIL Open Font License 1.1 | `assets/fonts/anton/OFL.txt` |
+| Montserrat | `assets/fonts/montserrat/Montserrat-Variable.ttf` | Copyright 2024 The Montserrat.Git Project Authors | SIL Open Font License 1.1 | `assets/fonts/montserrat/OFL.txt` |
+| Figtree | `assets/fonts/figtree/Figtree-Variable.ttf` | Copyright 2022 The Figtree Project Authors | SIL Open Font License 1.1 | `assets/fonts/figtree/OFL.txt` |
+| Caveat | `assets/fonts/caveat/Caveat-Variable.ttf` | Copyright 2014 The Caveat Project Authors | SIL Open Font License 1.1 | `assets/fonts/caveat/OFL.txt` |
+| Permanent Marker | `assets/fonts/permanentmarker/PermanentMarker-Regular.ttf` | Copyright (c) 2010 Font Diner, Inc. | Apache License 2.0 | `assets/fonts/permanentmarker/LICENSE.txt` |
+
+As fontes sob a SIL Open Font License podem ser usadas, embutidas e distribuídas junto com
+software, mas não podem ser vendidas sozinhas. "Permanent Marker" é marca da Font Diner, Inc.
+
+O projeto-modelo do HyperFrames (`modelo-projeto/assets/fontes/`) leva as próprias cópias de Montserrat,
+Caveat e JetBrains Mono (Copyright 2020 The JetBrains Mono Project Authors), todas sob a SIL Open Font
+License 1.1, com o texto da licença ao lado de cada uma (`OFL-Montserrat.txt`, `OFL-Caveat.txt` e
+`OFL-JetBrainsMono.txt`). Elas vão junto porque o modelo é copiado para a pasta dos vídeos e o render do
+HyperFrames só usa fonte em arquivo.
+
+## 3. Modelos incluídos
+
+Os modelos ficam em `assets/models/`, cada um com o arquivo de licença completo. O de rosto é usado para
+achar o rosto de quem fala e não pôr texto nem imagem em cima dele (`helpers/face_layout.py`,
+`helpers/render_cut.py`, `helpers/compose_final.py`, `helpers/style_samples.py`). O de recorte separa a
+pessoa do fundo da gravação na tela verde (`helpers/matte.py`, `helpers/tela_verde.py`).
+
+| Modelo | Arquivo | Origem | Autor | Licença | Texto da licença |
+|---|---|---|---|---|---|
+| YuNet (face_detection_yunet_2023mar) | `assets/models/face_detection_yunet_2023mar.onnx` | OpenCV Zoo (https://github.com/opencv/opencv_zoo) | Copyright (c) 2020 Shiqi Yu | MIT License | `assets/models/YUNET_LICENSE.txt` |
+| MediaPipe Selfie Multiclass Segmentation 256x256 (selfie_multiclass_256x256) | `assets/models/selfie_multiclass_256x256.onnx` | Google MediaPipe (https://ai.google.dev/edge/mediapipe/solutions/vision/image_segmenter) | Google (autor no cartão do modelo: Adel Ahmadyan) | Apache License 2.0 | `assets/models/SELFIE_MULTICLASS_LICENSE.txt` |
+
+Sobre o modelo de recorte:
+- A licença está no cartão oficial do modelo ("LICENSED UNDER Apache License, Version 2.0"):
+  https://storage.googleapis.com/mediapipe-assets/Model%20Card%20Multiclass%20Segmentation.pdf
+- Arquivo original (TFLite), baixado em 16/09/2026:
+  https://storage.googleapis.com/mediapipe-models/image_segmenter/selfie_multiclass_256x256/float32/latest/selfie_multiclass_256x256.tflite
+  (sha256 `c6748b1253a99067ef71f7e26ca71096cd449baefa8f101900ea23016507e0e0`).
+- Mudança feita por este projeto (Apache-2.0, seção 4b): só o formato. O arquivo foi convertido de TFLite
+  para ONNX com o tf2onnx 1.17.0 (Apache-2.0, usado só na conversão, não vai junto), sem mudar os pesos.
+  Arquivo incluído: sha256 `35549e14dc62c73b34f0fd04ec1765d9f1577230a2d068cb25c39f600350f477`. Os detalhes e o
+  texto completo da licença estão em `assets/models/SELFIE_MULTICLASS_LICENSE.txt`. O Google não publica um
+  arquivo NOTICE para este modelo.
+- O cartão do modelo diz que ele não serve para vigilância nem para reconhecer pessoas; aqui ele só separa
+  quem fala do fundo, no computador de quem edita.
+
+## 4. Efeitos sonoros incluídos
+
+Os efeitos prontos ficam em `assets/sfx/` e podem ir junto com o produto: cada um é **CC0 / domínio
+público** ou feito pelo código do próprio editor-video. Nenhum deles exige crédito. O comprovante de
+licença de cada som fica em `assets/sfx/licencas/<efeito>.txt`, com a página de origem, o autor, o
+nome da licença, a frase da licença palavra por palavra, a data em que ela foi lida e a receita de
+como o arquivo foi preparado.
+
+| Efeito | Arquivo | Origem | Autor | Licença | Comprovante |
+|---|---|---|---|---|---|
+| `whoosh` | `assets/sfx/whoosh.wav` | [SSE Library: SWOOSHES](https://archive.org/details/SSE_Library_SWOOSHES) no Internet Archive (bobina de fogos) | USC Cinema / Sunset Editorial Collection | CC0 1.0 Universal | `assets/sfx/licencas/whoosh.txt` |
+| `pop` | `assets/sfx/pop.wav` | [Kenney Interface Sounds](https://kenney.nl/assets/interface-sounds) (`select_006.ogg`) | Kenney (Kenney Vleugels) | CC0 1.0 Universal | `assets/sfx/licencas/pop.txt` |
+| `click` | `assets/sfx/click.wav` | [Kenney UI Audio](https://kenney.nl/assets/ui-audio) (`switch3.ogg`, usado duas vezes) | Kenney Vleugels | CC0 1.0 Universal | `assets/sfx/licencas/click.txt` |
+| `tick` | `assets/sfx/sinteticos/tick.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/tick.txt` |
+| `rise` | `assets/sfx/rise.wav` | [Phonk Riser (1) Sample](https://commons.wikimedia.org/wiki/File:Phonk_Riser_(1)_Sample.wav) no Wikimedia Commons | UnKnownrNone (trabalho próprio) | CC0 1.0 Universal | `assets/sfx/licencas/rise.txt` |
+| `cash` | `assets/sfx/cash.wav` | [Metal drawer #1](https://bigsoundbank.com/metal-drawers-1-s0792.html) + [Counter bell #4](https://bigsoundbank.com/counter-bell-4-s2532.html) na BigSoundBank | Joseph SARDIN (BigSoundBank.com) | CC0 (domínio público), nas duas partes | `assets/sfx/licencas/cash.txt` |
+| `coin` | `assets/sfx/coin.wav` | [Coin in cup #1](https://bigsoundbank.com/coin-in-cup-1-s0339.html) na BigSoundBank | DavidGreck, publicado pela BigSoundBank.com | CC0 (domínio público) | `assets/sfx/licencas/coin.txt` |
+| `notification` | `assets/sfx/notification.wav` | [clinking of empty glass (Toast)](https://bigsoundbank.com/clinking-of-empty-glass-toast-s0471.html) na BigSoundBank | Joseph SARDIN (BigSoundBank.com) | CC0 (domínio público) | `assets/sfx/licencas/notification.txt` |
+| `success` | `assets/sfx/success.wav` | [Kenney Music Jingles](https://kenney.nl/assets/music-jingles) (`jingles_STEEL00.ogg`) | Kenney Vleugels | CC0 1.0 Universal | `assets/sfx/licencas/success.txt` |
+| `error` | `assets/sfx/sinteticos/error.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/error.txt` |
+| `count` | `assets/sfx/count.wav` | [Hi-Tech Button Sound Pack I](https://opengameart.org/content/hi-tech-button-sound-pack-i-non-themed) no OpenGameArt (`Button Sound 9.wav`, repetido) | Circlerun | CC0 1.0 Universal | `assets/sfx/licencas/count.txt` |
+| `keyboard` | `assets/sfx/keyboard.wav` | [Computer Keyboard](https://bigsoundbank.com/computer-keyboard-s0229.html) na BigSoundBank | Joseph SARDIN (BigSoundBank.com) | CC0 (domínio público) | `assets/sfx/licencas/keyboard.txt` |
+| `snap` | `assets/sfx/snap.wav` | [Snap of the fingers sounds](https://opengameart.org/content/snap-of-the-fingers-sounds) no OpenGameArt + cauda de sala feita pelo código | Vinrax | CC0 1.0 Universal | `assets/sfx/licencas/snap.txt` |
+| `mouse_click` | `assets/sfx/mouse_click.wav` | [Raspberry Mouse, Single Click](https://bigsoundbank.com/raspberry-mouse-single-click-s1735.html) na BigSoundBank | Joseph SARDIN (BigSoundBank.com) | CC0 (domínio público) | `assets/sfx/licencas/mouse_click.txt` |
+| `bass_drop` | `assets/sfx/sinteticos/bass_drop.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/bass_drop.txt` |
+| `metal_hit` | `assets/sfx/metal_hit.wav` | [Anvil #2](https://bigsoundbank.com/anvil-2-s3590.html) na BigSoundBank + grave feito pelo código | Pablo BERGEL, publicado pela BigSoundBank.com | CC0 (domínio público) | `assets/sfx/licencas/metal_hit.txt` |
+| `synth_hit` | `assets/sfx/sinteticos/synth_hit.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/synth_hit.txt` |
+| `flash` | `assets/sfx/sinteticos/flash.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/flash.txt` |
+| `charge` | `assets/sfx/sinteticos/charge.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/charge.txt` |
+| `metal_riser` | `assets/sfx/metal_riser.wav` | [Cymbale 16" #3](https://bigsoundbank.com/cymbale-16-3-s2313.html) na BigSoundBank, de trás para frente, + grave feito pelo código | Joseph SARDIN (BigSoundBank.com) | CC0 (domínio público) | `assets/sfx/licencas/metal_riser.txt` |
+| `wind` | `assets/sfx/sinteticos/wind.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/wind.txt` |
+| `rewind` | `assets/sfx/sinteticos/rewind.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/rewind.txt` |
+| `gears` | `assets/sfx/gears.wav` | [Winder #1](https://bigsoundbank.com/winder-1-s1674.html) na BigSoundBank + [Kenney RPG Audio](https://kenney.nl/assets/rpg-audio) (`doorClose_4.ogg`) + grave feito pelo código | Joseph SARDIN (BigSoundBank.com) e Kenney Vleugels | CC0, nas duas gravações | `assets/sfx/licencas/gears.txt` |
+| `data` | `assets/sfx/sinteticos/data.wav` | gerado por `helpers/make_sfx.py` | SHK Soluções Digitais | a do editor-video, sem terceiros | `assets/sfx/licencas/data.txt` |
+
+**Crédito não é obrigatório em nenhum deles.** CC0 é dedicação ao domínio público: dá para usar,
+copiar, mudar, distribuir e vender, inclusive sozinho, sem pedir permissão e sem citar o autor. Se
+você quiser agradecer de todo jeito, uma linha assim basta em qualquer lugar (descrição do vídeo,
+página do produto, um arquivo de créditos):
+
+```
+Efeitos sonoros: BigSoundBank (Joseph SARDIN, DavidGreck e Pablo BERGEL), Kenney.nl, OpenGameArt
+(Circlerun e Vinrax), USC Cinema / Sunset Editorial Collection (Internet Archive) e UnKnownrNone
+(Wikimedia Commons). Todos CC0 / domínio público.
+```
+
+Alguns autores **pedem** o crédito, sem exigir: a Kenney.nl escreve no `License.txt` que "Credit
+(Kenney or www.kenney.nl) would be nice but is not mandatory", a BigSoundBank pede na página de
+licenças "Add in your credits: 'Additional sounds: Joseph SARDIN - BigSoundBank.com'" e o Circlerun
+escreve na página do pacote dele no OpenGameArt "Just "SFX by Circlerun" will do just fine". Como a
+licença é CC0, isso é pedido e não condição: usar e vender sem citar ninguém continua permitido. A
+linha acima atende esses pedidos de uma vez, se você quiser.
+
+Nenhum dos efeitos escolhidos é CC-BY, então **não existe crédito obrigatório a colocar em lugar
+nenhum**. Se um dia entrar um som CC-BY no lugar de algum destes, o arquivo de licença dele vai
+trazer a linha de crédito exata e onde ela precisa aparecer (na descrição do vídeo, na página do
+produto ou num arquivo de créditos entregue junto).
+
+Alguns efeitos não são uma gravação solta, e o arquivo de licença de cada um explica a receita inteira:
+
+- **`cash`** é a soma de dois sons CC0, porque nenhum arquivo CC0 sozinho era uma caixa registradora
+  de verdade (gaveta batendo mais sino brilhante). A gaveta vem de "Metal drawer #1" (em 8,00 s,
+  ganho 0,9) e o sino de "Counter bell #4" (em 0,13 s, ganho 1,0) 50 ms depois, com uma limpeza leve
+  do chiado de sala.
+- **`click`** é o mesmo estalo CC0 duas vezes, o segundo 30 ms depois no ganho 0,9, porque um
+  obturador de câmera são dois estalos e porque um estalo sozinho é tão seco que não chega no volume
+  certo sem estourar o pico.
+- **`count`** é um bipe CC0 (Circlerun) repetido 14 vezes, um a cada 47 ms: nenhum arquivo CC0 era um
+  contador pronto.
+- **`gears`** soma duas gravações CC0 (a catraca "Winder #1" e o baque `doorClose_4` da Kenney) a um
+  grave que cresce, feito pelo código.
+- **`snap`**, **`metal_hit`** e **`metal_riser`** são uma gravação CC0 cada (estalo, bigorna e prato de
+  trás para frente) com uma camada feita pelo código deste projeto: a cauda de sala do estalo e o grave
+  dos outros dois. Essa camada não vem de nenhuma gravação.
+- **`notification`** é uma batida num copo de vidro de verdade, afinada 2 semitons acima. Não é o som de
+  nenhum celular.
+
+Os arquivos de `assets/sfx/sinteticos/` também não vêm de terceiros: são gerados pelo próprio código do
+editor-video (`helpers/make_sfx.py`), com semente fixa, então rodar de novo dá os mesmos bytes. Nove
+efeitos da lista vêm de lá: `tick`, `error`, `bass_drop`, `synth_hit`, `flash`, `charge`, `wind`,
+`rewind` e `data`. Nenhuma gravação CC0 chegava perto desses sons, então eles são do próprio projeto.
+Veja `assets/sfx/licencas/sinteticos.txt`.
+
+Os 35 sons de `assets/sfx/woven/`, que o `helpers/plano_sfx.py` usa com o prefixo `woven:` (pop, whoosh,
+impacto, notificação, clique e os outros da tabela de sons da direção), vêm do **Woven SFX**
+(https://www.woven.video/sfx, repositório https://github.com/woven-video/woven-sfx) e também são
+**CC0 1.0 Universal**. Os arquivos são os originais, sem nenhuma mudança: a lista com o sha256 de cada um
+fica em `assets/sfx/sfx_woven.json` e a licença, com a frase do repositório palavra por palavra, em
+`assets/sfx/woven/LICENCA.md`. Crédito não é obrigatório; se quiser, "Efeitos sonoros: Woven SFX (CC0)".
+
+
+## 5. Bibliotecas instaladas pelo uv
+
+Não vêm dentro desta pasta: o instalador baixa cada uma com `uv sync`, e cada uma segue a própria
+licença.
+
+| Biblioteca | Para que serve | Licença |
+|---|---|---|
+| numpy | cálculos de áudio e imagem | BSD-3-Clause |
+| Pillow | desenho dos textos e imagens | MIT-CMU (HPND) |
+| requests | busca de imagens e OpenRouter | Apache-2.0 |
+| opencv-python-headless | roda o modelo YuNet para achar o rosto; fluxo óptico, filtros e mistura da tela verde | Apache-2.0 (o pacote traz bibliotecas de terceiros, listadas no `LICENSE-3RD-PARTY.txt` que vem dentro dele) |
+| onnxruntime | roda o modelo de recorte da pessoa (tela verde); também é usado pelo faster-whisper | MIT |
+| mlx-whisper (Mac com chip Apple) | transcrição local | MIT |
+| faster-whisper (Windows e outros) | transcrição local | MIT |
+
+Essas bibliotecas instalam outras das quais dependem (por exemplo `mlx`, `ctranslate2`, `flatbuffers`,
+`protobuf`, `coloredlogs`, `sympy`, `tokenizers` e `huggingface-hub`), cada uma com a própria licença.
+
+O modelo de voz Whisper (OpenAI, licença MIT) é baixado do Hugging Face na primeira transcrição.
+
+## 6. Programas que você instala à parte
+
+- **FFmpeg** (https://ffmpeg.org): usado para ler, cortar e montar os vídeos. Não vem junto com o
+  editor-video; você instala pelo Homebrew ou pelo winget. Licença LGPL ou GPL, conforme o build.
+- **uv** (https://github.com/astral-sh/uv): instala o Python e as bibliotecas. Licença MIT ou
+  Apache-2.0.
+- **Node.js e HyperFrames** (https://github.com/heygen-com/hyperframes): montam o vídeo do
+  `modelo-projeto/`; o `npx` baixa o HyperFrames na primeira vez. HyperFrames é Apache-2.0. O GSAP
+  (licença padrão da GreenSock, uso gratuito) vem do CDN ou é baixado pelo `build.py preparar`, e o
+  modelo de mãos do MediaPipe (Apache-2.0) é baixado na primeira vez pelo `ferramentas/rastrear_maos.py`.
+  Nenhum dos três vai no pacote.
+
+## 7. Serviços externos opcionais
+
+Nenhum deles é necessário para cortar, legendar e montar o vídeo.
+
+| Serviço | Quando é usado | O que vai para lá | Termos |
+|---|---|---|---|
+| Wikimedia Commons | `fetch_images.py` (padrão) | o texto da busca | Cada imagem tem a própria licença (CC0, domínio público, CC BY ou CC BY-SA). Autor, link e licença ficam em `edit/assets/credits.json`. Licenças CC BY e CC BY-SA pedem crédito ao autor. |
+| Pexels | `fetch_images.py --source pexels`, com `PEXELS_API_KEY` | o texto da busca e a sua chave | Licença do Pexels (https://www.pexels.com/license/). Crédito em `edit/assets/credits.json`. |
+| OpenRouter | `gen_image.py`, com `OPENROUTER_API_KEY` | a descrição da imagem e a sua chave | Termos do OpenRouter (https://openrouter.ai/terms) e do modelo escolhido. Cobrança por uso na sua conta. |
+| Hugging Face | primeira transcrição | pedido de download do modelo | Termos do Hugging Face e licença do modelo. |