VideoShorts Cutter (+ audio)

Роль

Нарезка 9:16 по layout из brief и loudnorm. Отдельный Task audio-polisher в slim-пайплайне не вызывается.

Вход

• Исходное видео (brief)
• refined-moments.json, montage-plan.json, clip-decisions.json
• brief: layout (webinar|regular|podcast|sales, default webinar), quality_preset, loudnorm (default true)

Действия

1. Прочитать pitfalls. Gate: только agent decisions; не резать reject; предпочитать refined-moments.
2. Editorial-bundle gate (обязательно перед cut): сверка moments/scores/editor/virality/refined/decisions/montage как единого бандла:

cd scripts
python validate_agent_artifacts.py editorial-bundle "../videoshorts-memory/moments"

Если exit ≠ 0 — не резать, вернуться к boundary-refiner с ошибками валидатора.

3. Cut — обязательно передать --layout из brief:

cd scripts
$env:VIDEOSHORTS_AGENT_MODE="1"
python cut_clips.py "<video_path>" "../videoshorts-memory/moments/refined-moments.json" `
  -o "../videoshorts-memory/output/clips/<stem>" `
  --montage-plan "../videoshorts-memory/moments/montage-plan.json" `
  --layout webinar `
  --quality-preset release `
  --require-agent-decisions

Подставьте layout из 00-brief.md (layout: ...). Не хардкодьте webinar, если в brief regular / podcast / sales.

4. Сразу после успешного cut — audio polish (механика-скрипт ок):

cd scripts
python audio_polish.py "../videoshorts-memory/output/clips/<stem>" --apply-loudnorm --quality-preset release

Пишет audio-metrics.json + audio-polish-manifest.json в clips dir. Если brief loudnorm: false — только metrics (--no-apply-loudnorm).

После loudnorm audio_polish.py сам меряет volumedetect. Если max_volume > -1.0 dB → условный alimiter (ceiling ≈ TP=-1.5) и повторный measure. Не чинить clipping one-off руками на одном клипе.

5. Layouts:
   • regular / sales — один кадр 9:16, кроп по лицу
   • webinar — dual-screen 30/70 (экран / лицо)
   • podcast — tracking-камера по лицу
   • release 1080×1920

Выход

output/clips/<stem>/
  clip_XX_cropped.mp4
  manifest.json
  audio-metrics.json
  audio-polish-manifest.json

Fragment fragments/cutter.md — статус cut + loudnorm summary + incident_report.