compile-timeline

compile-timeline

いつ使うか

• 「コンパイルして」「タイムラインを生成して」と言われたとき。
• creative_brief.yaml, selects_candidates.yaml, edit_blueprint.yaml が揃っているとき。

前提条件

• scripts/compile-timeline.ts は compile 前後で scripts/validate-schemas.ts 相当の gate を見る。
• 01_intent/unresolved_blockers.yaml に status: blocker があると compile gate が落ちる。
• fps を 24 以外にしたい場合は --fps <num> を明示する。

やること（ステップ）

1. 必要 artifact が存在することを確認する。
2. compile を実行する。

npx tsx scripts/compile-timeline.ts projects/<project> --fps 30

3. review patch を適用したい場合は patch mode を使う。

npx tsx scripts/compile-timeline.ts projects/<project> --patch projects/<project>/06_review/review_patch.json --fps 30

4. 出力された timeline.json、preview-manifest.json、必要なら adjacency_analysis.json を確認する。
5. 既存preview/finalがある状態でtimelineを更新した場合、それらをfreshとみなさない。Studio確認前にrenderを再実行し、playback-contract-status が exact であることを確認する。

出力 artifact

• 05_timeline/timeline.json
• 05_timeline/preview-manifest.json
• 05_timeline/adjacency_analysis.json ただし active editing skills による transition 解析が走った場合

注意事項

• scripts/compile-timeline.ts の createdAt は 01_intent/creative_brief.yaml.created_at から決まる。
• patch mode は timeline.json を上書きし、同時に preview-manifest.json も再生成する。
• manifest hashだけを手編集して古いpreviewをfresh扱いにしない。
• adjacency_analysis.json は debug / explanation 用 artifact。常に生成されるわけではない。
• Rhythm Sync (Issue #35): 03_analysis/bgm_analysis.json（onset/downbeat/sections）と楽曲アセットの word-level STT（03_analysis/transcripts/TR_<music_asset>.json の items[].words[]）をリズム証拠として、サビ/ブレイク開始のカット境界を ±1.5秒探索で1フレーム精度スナップする（サビは第一声・ダウンビート優先の Hard Snap）。証拠が無い/曖昧な場合は fail-open で timeline.metadata.rhythm_sync に status: degraded と理由を明示し、クリップのジオメトリは変更しない。スナップ後は integrity.gap_frames/overrun_frames = 0 を検証し、parity （±2フレーム、サビ頭違反は fail）を timeline.metadata.rhythm_sync と preview-manifest.json.rhythm_sync の両方へ刻印する。無効化は runtime/compiler-defaults.yaml の rhythm_sync.mode: off。