CPT-Dawn/souvi

SouVi Engine

souvi ist im PATH und funktioniert aus jedem Verzeichnis. Die Engine befindet sich unter /home/cptdawn/Kode/SouVi-Engine (im Folgenden: $SOUVI). souvi <cmd> -h zeigt Flags; souvi presets listet Lieferformate, Looks, Titelstile, Übergänge und Soundeffekte.

Arbeitsbereich

Jede Lieferungseinheit ist ein Projekt in $SOUVI:

• projects/<slug>/ — timeline.json (der Schnitt) und BRIEF.md (Brief + datierte Entscheidungsliste)
• assets/<slug>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/ — Quellen, niemals verändert
• output/<slug>/{drafts,renders,final,review}/ — Ergebnisse, versioniert _vNNN, niemals überschrieben

Wird von einem anderen Repository aufgerufen: slug = der Ordnername dieses Repos (für eine separate Lieferung suffixen, z. B. myapp-teaser). Medien importieren mit souvi import <slug> <files…> (--as voice|sfx für nicht-musikalische Audiodateien, --link für große Footage); ausliefern mit souvi promote <render> --to <ordner im aufrufenden Repo>. Git in $SOUVI in Ruhe lassen, es sei denn, der Benutzer fragt danach.

Parallele Agenten sind sicher: Jeder Job läuft in einem eigenen Ordner, und Render-Vorgänge eines Projekts warten auf eine Sperre. Gib jeder Lieferung eines Agenten einen eigenen Slug.

Schleife

1. souvi new <slug> --preset <lieferformat>; schreibe das Briefing in BRIEF.md.
2. souvi import …, souvi assets <slug>, dann souvi look <clip> auf jede Quellkandidatin.
3. timeline.json nach dem Lesen von $SOUVI/docs/timeline.md schreiben; souvi plan <slug> ausführen, bis es sauber ist.
4. souvi render <slug> --draft (--gpu, --until N), prüfen, überarbeiten.
5. souvi render <slug> (QC muss BESTANDEN sein), prüfen, souvi promote <render> [--to …].

Prüfung — Du kannst weder sehen noch hören, also lies die PNGs, die diese Befehle ausgeben: souvi look <video> (Kontaktbogen; --from/--to für dichte Bögen um Schnitte herum), souvi frame <video> --at <t…>, souvi hear <file> (Spektrogramm, Wellenform, Lautstärke). Die Arbeit ist abgeschlossen, wenn der endgültige Render diese Prüfung und QC besteht.

Handwerk

Vor kreativen Entscheidungen lies video.md für Bild und audio.md für Ton. Wende jeden Punkt der dazugehörigen Prüflisten an.

Einzeldatei-Werkzeuge

export --preset, master, voice, sfx, reverb, stabilize, denoise, grade, retime, qc, loudness, probe. Verarbeitete Dateien landen neben ihrer Quelle als <name>.<tag>_vNNN.<ext>. Für alles andere ist rohes ffmpeg in Ordnung, solange es 10-Bit-Verarbeitung, Lanczos-Skalierung, BT.709-Tags und soxr-Resampling beibehält; Lautstärke mit souvi master abschließen und Lieferformate mit souvi export codieren.