CPT-Dawn/souvi

Motor SouVi

souvi está en el PATH y funciona desde cualquier directorio. El motor reside en /home/cptdawn/Kode/SouVi-Engine (en adelante: $SOUVI). souvi <cmd> -h muestra las banderas; souvi presets lista los formatos de entrega, estilos visuales, estilos de título, transiciones y efectos de sonido.

Espacio de trabajo

Cada conjunto de entregables es un proyecto en $SOUVI:

• projects/<slug>/ — timeline.json (la edición) y BRIEF.md (brief + registro de decisiones fechadas)
• assets/<slug>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/ — fuentes, nunca modificadas
• output/<slug>/{drafts,renders,final,review}/ — resultados, versionados _vNNN, nunca sobrescritos

Cuando se invoca desde otro repositorio: slug = nombre de la carpeta de ese repositorio (añade un sufijo para un entregable separado, ej. myapp-teaser). Importa medios con souvi import <slug> <archivos…> (--as voice|sfx para audio no musical, --link para footage grande); entrega con souvi promote <render> --to <carpeta en el repo llamante>. No toques git en $SOUVI a menos que el usuario lo solicite.

Los agentes paralelos son seguros: cada trabajo se ejecuta en una carpeta privada y los renders de un proyecto se encolan en un bloqueo. Dale a cada entregable de un agente su propio slug.

Ciclo

1. souvi new <slug> --preset <delivery>; escribe el brief en BRIEF.md.
2. souvi import …, souvi assets <slug>, luego souvi look <clip> en cada fuente candidata.
3. Escribe timeline.json después de leer $SOUVI/docs/timeline.md; ejecuta souvi plan <slug> hasta que esté limpio.
4. souvi render <slug> --draft (--gpu, --until N), revisa, corrige.
5. souvi render <slug> (el QC debe PASAR), revisa, souvi promote <render> [--to …].

Revisión — no puedes ver ni escuchar, así que lee los PNG que estos imprimen: souvi look <video> (hoja de contacto; --from/--to para hojas densas alrededor de los cortes), souvi frame <video> --at <t…>, souvi hear <file> (espectrograma, forma de onda, sonoridad). El trabajo está terminado cuando el render final pasa esta revisión y el QC.

Creación

Antes de decisiones creativas, lee video.md para imagen y audio.md para sonido. Aplica cada elemento de sus listas de verificación de revisión.

Herramientas de archivo único

export --preset, master, voice, sfx, reverb, stabilize, denoise, grade, retime, qc, loudness, probe. Los archivos procesados se colocan junto a su fuente como <nombre>.<etiqueta>_vNNN.<ext>. Para cualquier otra cosa, ffmpeg puro es adecuado siempre que mantenga procesamiento de 10 bits, escalado lanczos, etiquetas BT.709 y remuestreo soxr; finaliza la sonoridad con souvi master y codifica los entregables con souvi export.