SouVi Engine

O que SouVi Engine faz?

souvi está no PATH e funciona de qualquer diretório. O motor reside em /home/cptdawn/Kode/SouVi-Engine (abaixo: $SOUVI). souvi <cmd> -h mostra flags; souvi presets lista formatos de entrega, looks, estilos de título, transições e sfx.

Workspace

Cada conjunto de entregáveis é um projeto em $SOUVI:

• projects/<slug>/ — timeline.json (a edição) e BRIEF.md (brief + registro de decisões datado)
• assets/<slug>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/ — fontes, nunca modificadas
• output/<slug>/{drafts,renders,final,review}/ — resultados, versionados _vNNN, nunca sobrescritos

Quando chamado de outro repositório: slug = nome da pasta desse repositório (adicione sufixo para um entregável separado, ex. myapp-teaser). Importe mídia com souvi import <slug> <files…> (--as voice|sfx para áudio não musical, --link para grandes volumes); entregue com souvi promote <render> --to <folder no repositório chamador>. Não mexa no git em $SOUVI a menos que o usuário peça.

Agentes paralelos são seguros: cada trabalho roda em uma pasta privada e as renderizações de um projeto seguem em fila com um bloqueio. Dê a cada entregável de um agente seu próprio slug.

Loop

1. souvi new <slug> --preset <delivery>; escreva o brief em BRIEF.md.
2. souvi import …, souvi assets <slug>, depois souvi look <clip> em cada fonte candidata.
3. Escreva timeline.json após ler $SOUVI/docs/timeline.md; execute souvi plan <slug> até ficar limpo.
4. souvi render <slug> --draft (--gpu, --until N), revise, corrija.
5. souvi render <slug> (QC deve PASSAR), revise, souvi promote <render> [--to …].

Revisão — você não pode assistir ou ouvir, então leia os PNGs que estes comandos imprimem: souvi look <video> (folha de contato; --from/--to para folhas densas ao redor de cortes), souvi frame <video> --at <t…>, souvi hear <file> (espectrograma, forma de onda, loudness). O trabalho está concluído quando a renderização final passa por essa revisão e QC.

Craft

Antes de decisões criativas, leia video.md para imagem e audio.md para som. Aplique cada item de suas listas de verificação de revisão.

Ferramentas de arquivo único

export --preset, master, voice, sfx, reverb, stabilize, denoise, grade, retime, qc, loudness, probe. Arquivos processados são salvos ao lado da fonte como <nome>.<tag>_vNNN.<ext>. Para qualquer outra coisa, ffmpeg puro é aceitável quando mantém processamento de 10 bits, escalonamento lanczos, tags BT.709 e reamostragem soxr; finalize a loudness com souvi master e codifique os entregáveis com souvi export.