caption-writer
Três coisas separadas: legendas na tela (video/captions/, props.captions, speech.srt); texto de post (captions/<plataforma>.md, skill eda-marketing:content-repurposer); texto editorial (accents com spoken: false, editorialCta) — nunca no SRT.
O texto da legenda está no idioma da marca (brand.json → language). As regras de agrupamento, tipografia e sílabas vêm do pacote de idioma (packages/core/src/lang/<en|ru>.ts).
Antes da gravação (rascunho)
npm run mos -- captions build <pkg> — temporização estimada a partir do script (brand.json → speech.syllablesPerSec), selo "TEMPO ESTIMADO", render final bloqueado.
Após a gravação
npm run mos -- footage <pkg>(se as fontes estiverem eminput/).npm run mos -- captions transcribe <pkg> <arquivo de voz>— faster-whisper local, sem downloads. Sem modelo → pedir permissão antes de instalar (docs/VIDEO_PIPELINE.md).- O ASR é um rascunho. Verificar nomes, números, negações, terminações de palavras, palavras silenciosas, limites de frases. Correções vão para
transcript/corrected.<arquivo>.json+ uma linha emtranscript/CORRECTIONS.md;transcript/raw-asr.*é imutável. Não claro →[inaudivel]+ perguntar ao usuário; nunca chutar. Nunca afirmar que ouviu se não ouviu. - Se a fala real diferir do script, mostrar a diferença e decidir com o usuário (manter a fala / reeditar / regravar). As legendas seguem a fala real; nunca adicionar palavras que não estão no áudio.
npm run mos -- captions map <pkg>→npm run mos -- captions build <pkg> --source transcribed.- Opcional:
npm run mos -- captions calibrate <pkg> raw-asr.<arquivo>.json --write— o ritmo real do autor embrand.json.
Modos e agrupamento
Modo padrão: brand.json → defaults.captionMode; por vídeo: props.captions.mode. replace — grupos curtos substituem uns aos outros; accumulate — palavras constroem um bloco escalonado pequeno; highlight — sob consulta. Ênfase: *palavra* no script (para fala transcrita, marcar emphasis em corrected).
Agrupar por significado. Nunca separar uma negação de seu verbo ("não / sei"), uma preposição de sua palavra ("no / app"), um número de sua unidade ("30 / segundos"), ou um nome. Evitar uma palavra solta em uma linha. Manter brand.json → captions.protectedPhrases intacto. As regras do russo estão no pacote de idioma ru.
Verificação
Estúdio: início/fim de cada página, transição legenda-acento sem duplicatas, legibilidade em celular, sem texto sobre os olhos. mos qa verifica estouro de linha com métricas reais de fonte.