Prepare

1#!/usr/bin/env bash
2# prepare.sh — one-command pre-processing for a captions project.
3#
4#   bash prepare.sh <project-dir>
5#
6# Runs the three deterministic pre-steps with maximum parallelism:
7#   matte.cjs (CPU-heavy ONNX)  ∥  transcribe.cjs (whisper)   → then safe-zones.cjs
8# (matte and transcribe are independent; safe-zones needs the matte's frames_fg.)
9# Replaces hand-running steps 2 / 3 / 3b — one call, nothing forgotten, ~the cost
10# of the slower of the two instead of their sum.
11#
12# After this completes the project has: frames_bg/ frames_fg/ matte.fps
13# transcript.json safe-zones.json — everything the authoring step needs.
14set -euo pipefail
15
16PROJECT="${1:?usage: prepare.sh <project-dir>}"
17PROJECT="$(cd "$PROJECT" && pwd)"
18SD="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
19
20echo "[prepare] matte ∥ transcribe ∥ envelope …"
21MLOG="$PROJECT/_prepare_matte.log"; TLOG="$PROJECT/_prepare_transcribe.log"; ELOG="$PROJECT/_prepare_envelope.log"
22node "$SD/matte.cjs" "$PROJECT"      > "$MLOG" 2>&1 &  MPID=$!
23node "$SD/transcribe.cjs" "$PROJECT" > "$TLOG" 2>&1 &  TPID=$!
24node "$SD/audio-envelope.cjs" "$PROJECT" > "$ELOG" 2>&1 &  EPID=$!
25
26MRC=0; TRC=0
27wait "$MPID" || MRC=$?
28wait "$TPID" || TRC=$?
29wait "$EPID" || echo "[prepare] (envelope skipped — hero amplitude falls back to neutral)" >&2
30# surface both logs (they contain the guards' warnings — near-silent audio, tail trim)
31sed 's/^/  [matte] /'      "$MLOG" | tail -6
32sed 's/^/  [transcribe] /' "$TLOG" | tail -12
33if (( MRC != 0 )); then echo "[prepare] matte FAILED (rc=$MRC) — see $MLOG" >&2; exit "$MRC"; fi
34if (( TRC != 0 )); then echo "[prepare] transcribe FAILED (rc=$TRC) — see $TLOG" >&2; exit "$TRC"; fi
35
36echo "[prepare] safe-zones …"
37node "$SD/safe-zones.cjs" "$PROJECT"
38
39echo "[prepare] ✅ ready: frames_fg/ transcript.json safe-zones.json — author next (see SKILL.md step 4)"