render-cut

name	render-cut
description	承認済み edit.json と edit-lint PASS を入力に、最終 MP4 の計画、明示承認、ローカル書き出し、ffprobe 検証、キーフレーム視認を完了する。編集が承認済みで、納品用動画の書き出しや最終レンダーを求められたときに使う。

承認済み編集を書き出す

Language: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。

ハードルール

1. edit.json を正本に決定的コマンド生成。自然言語からの即興 ffmpeg 禁止 （エージェントが ffmpeg コマンドを手書きして「これで書き出しました」は契約違反）
2. plan なしの render 禁止（validate→plan→承認→render の順を飛ばさない）
3. edit-lint FAIL のままの render 禁止（override は承認ゲート + render.json 記録）
4. レンダー後の ffprobe 機械検証必須。verify fail の成果物を納品可能と報告しない
5. 既定はローカル ffmpeg のみ。クラウド有償 API（Rendi 等）は v0 不採用 （将来はオプトイン + manage-connections の承認ゲート経由でのみ検討）
6. 原本 source からレンダ（proxy を最終レンダに使わない）
7. 状態は render.json・HTML は可視化のみ（新規サーフェス機構を輸入しない）
8. 外部候補のコード転写禁止（Kinocut / json-to-ffmpeg は構造参考のみ）
9. 既存成果物の silent 上書き禁止
10. カット連結・合成・verify の ffmpeg / ffprobe は本体直叩き（ラッパーライブラリ 禁止。分析・書き出し・検証の各工程で共通の方針）。 例外は HTML ラスタライズ段の HyperFrames のみ（依存は packages/render-cut/ 内に隔離し、リポの他所へ波及させない）
11. 3D overlay は puppeteer-core 経路で焼かれる（HyperFrames より速度差があり得る点に注意）

実行手順

1. 対象プロジェクトの edit.json が承認済みで、.akari/lint.json の verdict が pass であることを確認する。PASS でなければ edit-lint を実行して修正する。--force は lint 結果を上書きする明示承認を得た場合だけ使う。

2. リポジトリルートから plan だけを生成する。

   node packages/render-cut/bin/render-cut.mjs <project-root> --plan-only
   

3. <project>/.akari/render.json と <project>/.akari/reports/render-report.html を読み、予測尺、出力先、ffmpeg コマンド列、中間物、ラスタライズ候補、入力ハッシュを提示する。

4. 今回の書き出し実行に対する人間の明示承認を得て停止を解除する。 無応答、過去の包括承認、plan 以前の承認を今回の承認に読み替えない。

5. 承認後だけ書き出しを実行する。

   node packages/render-cut/bin/render-cut.mjs <project-root>
   

   出力を明示する場合だけ --out <path> を加える。CLI の validate → plan → render → verify を分解して手作業で代替しない。

6. exit code と .akari/render.json を確認する。0 は完走して verify PASS、1 は拒否または verify FAIL、2 は実行エラーを表す。provenance.rasterizer で採用手段と上位候補を落とした理由を確認する。

7. verify PASS 後に成果物から少なくとも冒頭、各カット境界の前後、各オーバーレイまたは字幕の表示中をキーフレームとして抽出し、実画像を視認する。カット元時刻、文字、位置、欠落、透明合成を確認する。

8. 機械検証値、成果物 SHA-256、採用したラスタライズ手段、フォールバック理由、キーフレーム視認結果を報告する。verify FAIL の場合は納品可能と表現せず、.akari/render-tmp/ を保持して原因を報告する。

出力契約

• 成果物は既定で <project>/exports/<source-name>.mp4 に置く。既存名があれば連番を使う。
• 状態の正本は <project>/.akari/render.json とする。HTML レポートは可視化専用とする。
• 成功時だけ <project>/.akari/render-tmp/ を削除する。失敗時は診断用に保持する。
• 字幕は captions.json から決定的な HTML へ生成し、他のオーバーレイと同じ経路で焼き込む。
• 視認用に抽出するキーフレーム静止画は <project>/.akari/reports/ へ置く。CLI 自身が使う .akari/render-tmp/ とは別に、確認用の一時スクリプトや実験的な中間生成物を人が作る場合は <project>/.akari/work/ へ置く（project-structure-v0 契約 §1）。 いずれもプロジェクトルート直下には置かない。

公開契約

• edit.json v0 と書き出し段構成
• edit.json v1 拡張メモ
• 字幕とカット編集