compose-creator-layer

Run

python compose.py --layer layer.mp4 --beats cutlist.aligned.json --creator creator.mp4 \
    --out reel.mp4 [--music bed.mp3 --music-db -20] [--head 0.30]

• --layer: footage-cutlist cut.py output rendered from the same cut list as --beats (re-render it after align_beats.py). --draft layers are refused.
• --creator: create-creator-takes-h3 join_takes.py output, reel time from 0.
• --audio creator|music|none: the voice (+ ducked --music), the --music bed alone (voiceless paid ads), or a silent master (organic posts: the track is added in-platform at upload, which is licensed for organic use only).
• The creator track may be shorter than the reel (a 2.3s reaction hook): it only shows during its own creator beats.
• --head: where the crop sits vertically when the creator is scaled to cover an area (0 keeps the top, 0.5 centres). 0.30 keeps the head in the upper third.