🔧 Comportas, scripts e determinismo

O corte não confia nos tempos que o Whisper devolve — eles têm um jitter de ±0,2–0,3s, o que deixa restos de silêncio e meias-palavras. Em vez disso, o motor mede o silêncio real do áudio com o silencedetect do ffmpeg. O script islands.py usa essa energia para achar as ilhotas de voz e propor quais manter, ficando com a última tomada de cada frase.

python3 islands.py \
  --media  \
  --transcript word.json \
  --noise -30dB --d 0.35 \
  --out islands.json

Conceitos-chave: silencedetect, jitter, ilhota de voz, KEEP/DROP.

O corte é uma cadeia de três scripts com uma comporta dura no fim. islands.py propõe o que manter; cut.py cola as ilhotas com keep=true num único arquivo; e verify-cut.py confere que o resultado está limpo — sem silêncios longos no corpo nem repetições. Ele sai com exit 0 quando passa e exit 1 quando falha. Você não anima nada antes desse PASS.

# 1) monta o corte a partir das ilhotas com keep=true
python3 cut.py --islands islands.json --out edicion/corte-final.mp4

# 2) re-transcreva o CORTE (word-level) e verifique — bloqueante
python3 verify-cut.py \
  --media edicion/corte-final.mp4 \
  --transcript corte-word.json \
  --max-sil 0.6
echo "exit: $?"   # 0 = PASSA · 1 = FALHA

Conceitos-chave: cadeia de scripts, comporta dura, exit 0/1.

A regra de ritmo "nunca mais de 4s sem golpe visual" deixa de ser um conselho e vira verificação automática. O lint-timeline.py lê o motion/index.html do Hyperframes, mede a distância entre os beats visuais e acusa erro quando encontra um buraco maior que o --max-gap (4s por padrão). É uma rede de segurança do ritmo — não substitui olhar os frames, mas pega o furo óbvio antes de renderizar.

# lint do ritmo: falha se houver >4s sem beat visual
python3 lint-timeline.py motion/index.html --max-gap 4.0
echo "exit: $?"   # 0 = ritmo ok · ≠0 = buraco de ritmo

Conceitos-chave: lint estático, beat visual, --max-gap, comporta de ritmo.

O captions.py gera "beats" de legenda de 2–3 palavras, sincronizados com a voz, no estilo retenção. O truque anti-clichê está no destaque: as palavras que você passa em --keywords (números, nomes de marca, conceitos fortes) são pintadas na sua cor de acento. Como as keywords mudam a cada vídeo, suas legendas nunca saem iguais às de ninguém.

python3 captions.py \
  --transcript corte-final.json \
  --max-words 3 \
  --keywords "" \
  --out captions.json

Conceitos-chave: beat de legenda, --keywords, cor de acento, área segura.

O som é feito em dois passos. make-sfx.sh sintetiza a paleta de efeitos (whoosh, pop, type, buzz, boom, ding, riser) com o ffmpeg — sem baixar nada, livre de direitos e sempre igual. Depois, mix-sfx.py sobrepõe cada efeito no tempo certo por baixo da voz, com um limitador para não saturar. Você passa os eventos como uma lista de [nome, segundo].

# 1) sintetiza a paleta de SFX em ./sfx
bash make-sfx.sh sfx

# 2) mistura os efeitos sobre o render, por baixo da voz
python3 mix-sfx.py \
  --base render.mp4 --sfx-dir sfx --out final.mp4 \
  --events '[["boom",0.0],["whoosh",6.5],["ding",8.6]]'

Conceitos-chave: paleta de SFX, eventos [nome, t], ducking, limitador.

Nada disso funciona se cada render sair diferente. Por isso as animações do Hyperframes são determinísticas: sem Math.random() e sem Date.now(), nada de repeat:-1 (repetições infinitas), e as timelines ficam em estado paused, registradas para o motor controlar frame a frame. Mesmo projeto → mesmo frame, toda vez — condição para o lint e o QC serem confiáveis.

# confere que o motor de motion está disponível
npx hyperframes --version

# checagem rápida: nenhuma fonte de aleatoriedade na timeline
grep -nE "Math\.random|Date\.now|repeat:\s*-1" motion/index.html || echo "OK: determinístico"

Conceitos-chave: determinismo, repeat finito, paused, reprodutibilidade.