compile-timeline

name	compile-timeline
description	Use when edit_blueprint.yaml and selects_candidates.yaml are ready and the user asks to compile the rough cut, generate timeline.json, or apply a review patch.
metadata	{"filePattern":["**/05_timeline/timeline.json","**/05_timeline/preview-manifest.json","**/05_timeline/adjacency_analysis.json"],"bashPattern":["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。常に生成されるわけではない。