🔧 Compuertas, scripts y determinismo

El corte no confía en los tiempos que devuelve Whisper — tienen un jitter de ±0,2–0,3s, lo que deja restos de silencio y palabras a medias. En su lugar, el motor mide el silencio real del audio con el silencedetect de ffmpeg. El script islands.py usa esa energía para encontrar los fragmentos de voz y proponer cuáles conservar, quedándote con la última toma de cada frase.

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

Conceptos clave: silencedetect, jitter, isla de voz, KEEP/DROP.

El corte es una cadena de tres scripts con una comporta dura al final. islands.py propone qué conservar; cut.py une las islitas con keep=true en un solo archivo; y verify-cut.py comprueba que el resultado esté limpio — sin silencios largos en el cuerpo ni repeticiones. Sale con exit 0 cuando pasa y exit 1 cuando falla. No animas nada antes de ese 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

Conceptos clave: cadena de scripts, compuerta estricta, exit 0/1.

La regla de ritmo «nunca más de 4s sin impacto visual» deja de ser un consejo y se convierte en verificación automática. O lint-timeline.py lee el motion/index.html de Hyperframes, mide la distancia entre los beats visuales y señala un error cuando encuentra un hueco mayor que el --max-gap (4s por defecto). Es una red de seguridad para el ritmo: no reemplaza revisar los fotogramas, pero detecta el fallo obvio 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

Conceptos clave: lint estático, beat visual, --max-gap, compuerta de ritmo.

O captions.py genera «beats» de subtítulos de 2–3 palabras, sincronizados con la voz, con estilo de retención. El truco anticliché está en el resaltado: las palabras que pasas en --keywords (números, nombres de marca, conceptos clave) se pintan en la tu color de acento. Como las keywords cambian con cada video, tus subtítulos nunca salen iguales a los de nadie.

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

Conceptos clave: beat de subtítulos, --keywords, color de acento, área segura.

El sonido se crea en dos pasos. make-sfx.sh sintetiza la paleta de efectos (whoosh, pop, type, buzz, boom, ding, riser) con ffmpeg — sin descargar nada, libre de derechos y siempre igual. Después, mix-sfx.py superpone cada efecto en el momento justo por debajo de la voz, con un limitador para que no sature. Pasas los eventos como una 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]]'

Conceptos clave: paleta de SFX, eventos [nombre, t], ducking, limitador.

Nada de esto funciona si cada render sale diferente. Por eso, las animaciones de Hyperframes son determinísticas: sin Math.random() y sin Date.now(), nada de repeat:-1 (repeticiones infinitas), y las líneas de tiempo quedan en estado paused, registradas para que el motor controle cada frame. Mismo proyecto → mismo frame, cada vez — condición para que el lint y el QC sean confiables.

# 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"

Conceptos clave: determinismo, repetición finita, pausado, reproducibilidad.