akari-video 0.1.0

package/vendor/skills/edit-plan/beat-sync.md

@@ -0,0 +1,545 @@
+# 見せ場マーカーを演出へ連動させる（beats → SE 発火）
+
+承認済みの `beats[]`（見せ場マーカー）から、既存の `edit.json` 語彙だけで「見せ場で鳴って画が動く」を
+組むための翻訳規約である。[beats.md](beats.md) が「見せ場をどう**書くか**」（導出規約）を定めるのに対し、
+本リーフは「書かれた見せ場をどう**使うか**」（消費規約）を定める。
+
+[edit.json v1 見せ場マーカー契約](../../docs/contract-2026-07-22-edit-json-v1-beats.md) §6 は、
+「beats を読んで実際にどんな演出を発火するか」を契約スコープ外＝消費側の別契約と明記している。
+本リーフはその消費側規約の v0 であり、契約が消費側に課す 2 つの不変条件（source 秒アンカーの尊重・
+劣化規約の尊重）の上に立つ。
+
+## v0 のスコープ（オーナー裁定済み・ここで広げない）
+
+- SE は**手持ちライブラリのみ**を使う。新規取得・外部ダウンロードをしない。
+- 視覚トランジションの `edit.json` 語彙は未契約である。v0 の同時発火は
+  **SE + カット境界 + overlay 装飾**の 3 点で構成し、専用トランジション語彙を発明しない。
+- BGM は「冒頭とエンディングのみ」の既定を尊重し、**ビート連動の BGM 操作をしない**
+  （ダッキングは narration 由来の既存機構のまま。ビート連動の BGM 変化はツマミ導入まで席）。
+- 囲い・ラメ等の専用視覚部品の新設はスコープ外である（既存 overlay 部品の選択提案までは可）。
+
+## 入力
+
+- 入力は**人間承認済みの `beats[]`** である（[beats.md](beats.md) の導出規約 — 下限 `strength`
+  0.5 と根拠必須 — を通過したもの）。**承認前の beats から演出を組まない。**
+- 密度（60 秒あたりの件数・同一 kind の間隔）は導出段では課されていない。**演出過多の抑制は
+  本リーフの責務**であり、§評価順の「密度ガードレール」で射影後の timeline 秒に対して適用する。
+- 承認の記録は `decision-log.md`（[report-guide.md](report-guide.md#decision_log)）に残っている
+  ものを指す。無操作・タイムアウト・過去の包括承認を今回の承認に読み替えない。
+- **演出の強さの入力は `edit.json` の `direction { preset, intensity }`**（演出宣言）である。
+  本リーフの演出数値はすべてここから導く（§演出プリセットと `intensity` 写像）。`direction` が
+  無ければ既定動作（`youtube-long-standard` + `intensity` 50）で従来どおりに振る舞う。
+
+## 射影 — source 秒から timeline 秒へ
+
+`beats[].t` は **source 秒**である（[beats.md](beats.md) §座標 / beats 契約 §3）。発火位置は毎回
+`cuts[]` から計算し、計算結果を `beats[]` へ書き戻さない。
+
+- `beats[].t`（source 秒）を `cuts[]` で timeline 秒へ射影して**発火位置**とする。
+- 射影式は [execution.md](execution.md) §2 と同じ:
+  source 時刻 `s` が keep-range `[in, out)` にあるとき、
+  `timeline = （それ以前の keep-range 長の合計） + (s - in)`。
+- **一対多**（同一 beat の複数出現。同じ source 区間がタイムライン上に複数回現れる場合）は、
+  **出現ごとに発火**する。
+- **射影先 0 件の beat は発火なし**（カットで落とした区間の見せ場）。これは正常であり、
+  エラーでも warning でもない（beats 契約 §4）。
+
+## 演出プリセットと `intensity` 写像
+
+本リーフの演出数値（強度ゲート・密度・`gain_db` の目安・儀式スナップ窓）は固定値ではなく、
+`edit.json` の `direction { preset, intensity }`
+（[演出宣言契約](../../docs/contract-2026-07-23-edit-json-v1-direction.md)）から**決定的に**導く。
+契約は器と意味論だけを定め、「どの規則のどの数値をどうスケールするかの写像表は消費側が持つ」と
+明記している（同 §4 / §7）。**本節がその写像の正である。**
+
+### プリセット実パラメータ表（`intensity` = 50 のときの値）
+
+| パラメータ | `youtube-long-standard` | `shorts-high-energy` | `calm-explainer` |
+|---|---|---|---|
+| 強度ゲート | 0.8 | 0.7 | 0.9 |
+| 密度: 60 秒あたり最大 | 2 件 | 4 件 | 1 件 |
+| 密度: 同 kind 間隔 | 20 秒 | 10 秒 | 30 秒 |
+| `gain_db` 基準（目安表の標準行） | -6 | -4 | -8 |
+| 儀式スナップ窓 | ±1.0 秒 | ±1.0 秒 | ±0.5 秒 |
+
+`preset` は enum ではない（契約 §2 / §3）。上表に無い `preset`（未知のプリセット）は下記の
+**既定動作**へフォールバックする。上表の 3 プリセット以外を勝手に増やさない
+（増設はオーナー裁定・別契約の仕事である）。
+
+### `intensity` 写像（全プリセット共通・決定的）
+
+`i` = `direction.intensity`（整数 `[0, 100]`。50 が基準）。上表の値を `base` として次で決まる。
+
+| パラメータ | 写像式 | 備考 |
+|---|---|---|
+| 強度ゲート | `gate = base - (i - 50) * 0.002` | `i=0` で +0.1・`i=100` で -0.1。`[0.5, 0.95]` にクランプ |
+| 60 秒あたり最大件数 | `max = round(base * (0.5 + i / 100))` | `i=0` で半分・`i=100` で 1.5 倍。最小 1 |
+| 同 kind 間隔 | `interval = base * (1.5 - i / 100)` 秒 | `i=0` で 1.5 倍・`i=100` で 0.5 倍 |
+| `gain_db` 目安表の 3 値 | `各値 + (i - 50) * 0.04` dB | `i=100` で +2 dB・`i=0` で -2 dB。`[-60, 12]` にクランプ |
+| 儀式スナップ窓 | **写像しない**（プリセット固有値のまま） | 儀式は `intensity` で増減しない |
+
+- `round` は四捨五入（`.5` は大きい方へ）。件数は写像後に最小 1 でクランプする。
+- 途中式は丸めずに計算し、レポートへ書くときだけ表示桁を落とす。
+- 写像は**単調**である。`i` を上げると強度ゲートは下がり・件数上限は増え・同 kind 間隔は縮み・
+  `gain_db` は上がる。どれも「発火を減らす方向へは動かない」ため、**同一入力（同じ `beats[]` と
+  `cuts[]`）に対する SE 件数は `i` について単調非減少**になる（減ることはない。増えるとは限らない）。
+
+### `direction` 欠落時・不正時の既定動作
+
+`direction` フィールドが無い、または劣化規約（契約 §5）で宣言ごと無視されたときは、
+**`preset` = `youtube-long-standard` + `intensity` = 50** として本リーフを適用する
+（契約 §5 の既定動作と同文）。このときの値は上表の 1 列目 = 強度ゲート 0.8 / 60 秒あたり最大
+2 件 / 同 kind 間隔 20 秒 / `gain_db` 標準 -6 / 儀式スナップ窓 ±1.0 秒であり、**`direction` 導入前に
+本リーフが固定値として書いていた数値と一致する**（現行動作の非退行）。
+
+### `intensity` に依存しないもの
+
+次は `intensity` を動かしても変わらない。
+
+- **儀式スナップ窓**（プリセット固有値のまま。写像しない）
+- **儀式が強度ゲート・密度に優先する規則**（儀式スナップが成立した `turn` を密度で落とさない）
+- **同一時刻 ±0.5 秒以内に SE は 1 個**の制限（窓幅も「`strength` の高い方を残す」優先規則も固定）
+- **評価順そのもの**（射影 → 儀式スナップ → 強度ゲート → 密度 → ±0.5 秒制限 → 昇順追記）
+
+## 評価順（決定的に処理する）
+
+同じ `beats[]` と `cuts[]` からは常に同じ `audio.sfx[]` が出るように、次の順で処理する。
+
+1. **射影**: 全 beat を timeline 秒へ射影する（0 件の beat はここで脱落）。
+2. **章転換の儀式**: `turn` の射影先がカット境界の**儀式スナップ窓**以内なら、その境界時刻へ
+   スナップする（窓幅は §演出プリセットと `intensity` 写像。既定 ±1.0 秒）。
+3. **強度ゲート**: `strength` が**強度ゲート値**以上の beat のみ SE を残す（値は同節。既定 0.8。
+   2 で儀式が成立した `turn` は儀式側が優先し、ゲートで落とさない。§章転換の儀式を見る）。
+4. **密度ガードレール**: **射影後の timeline 秒**で「60 秒あたり最大件数」「同一 kind の連続は
+   同 kind 間隔以上空ける」を適用する（値は同節。既定 2 件 / 20 秒。§密度ガードレール）。
+5. **同時多発の制限**: 同一時刻 ±0.5 秒以内に SE が 2 個以上あれば、`strength` が高い beat を残す。
+6. **書き出し**: 残った発火を `audio.sfx[]` へ timeline 秒昇順で追記する。
+
+評価順は **射影 → 儀式スナップ → 強度ゲート → 密度 → ±0.5 秒制限 → 昇順追記** である。
+
+## 密度ガードレール
+
+演出過多を防ぐための規則である。**数値は `direction { preset, intensity }` から導く**
+（§演出プリセットと `intensity` 写像）。素材ジャンル・配信先による調整は `direction` 宣言の
+仕事であり、ここで勝手に緩めない。
+
+- **60 秒あたり最大件数**（既定 preset・`i=50` で **2 件**）
+- **同一 kind の連続は同 kind 間隔以上空ける**（既定 preset・`i=50` で **20 秒**）
+
+適用のしかたは次のとおり。
+
+- **数える座標は射影後の timeline 秒**である。source 秒で数えると、カットで落とした区間の beat が
+  枠を消費し、生き残るべき発火を押し出す（この取りこぼしは dogfood で実測された。だから
+  [beats.md](beats.md) の導出段から本リーフの発火段へ移した）。
+- 枠を超えたときは **`strength` が高い方を残す**。同値なら timeline 秒が早い方を残す（決定性）。
+- **儀式スナップが成立した `turn` は密度でも落とさない**（強度ゲートに優先するのと同じ理由で、
+  章転換で音と画を同時に切り替える儀式が原理的に成立しなくなるため）。密度の件数勘定には
+  含めるが、落とす対象は儀式以外の発火から選ぶ。
+- 密度で落とした発火は「不採用候補」として編集判断レポート（[decision-log.md](report-guide.md#decision_log)）
+  に残す。落ちた beat は `beats[]` から消さない（**無音の見せ場**として残る）。
+
+## SE 発火規則
+
+- `audio.sfx[]` に `{ path, t: <射影後 timeline 秒>, gain_db }` を追記する。**`gain_db` の既定は
+  目安表の標準行**（§`gain_db` の目安。既定 preset・`i=50` で **-6**）。
+  （`audio.sfx[].t` は**タイムライン秒**である。
+  [音声契約](../../docs/contract-2026-07-14-edit-json-v1-audio.md) §1 のフィールド表を見る。
+  `gain_db` のクランプ範囲は `[-60, 12]`。）
+- **同時多発の制限**: 同一時刻 ±0.5 秒以内に SE は 1 個までとする（`strength` が高い beat を優先）。
+  この窓幅は `intensity` に依存しない。
+- **密度ガードレール**: 射影後の timeline 秒で 60 秒あたり最大件数・同一 kind の連続は同 kind
+  間隔以上空ける（§密度ガードレール。既定 2 件 / 20 秒）。
+- **`strength` が強度ゲート値以上の beat のみ SE を付ける**（既定 preset・`i=50` で 0.8。
+  それ未満は**無音の見せ場**として残す）。
+  無音の見せ場は beats から消さない。SE を付けなかったという判断であり、見せ場でなくなった
+  わけではない。
+
+### `gain_db` の目安
+
+下表は **`youtube-long-standard` の `intensity` = 50**（= `direction` 欠落時の既定動作）の値である。
+場面に合わせて次を目安に振る。
+
+| 条件 | `gain_db` |
+|---|---|
+| `strength >= 0.9`、または hook の儀式的な一発 | -4 |
+| 標準 | -6 |
+| `emotion` kind・静かな場面・連続発火の 2 発目 | -8 |
+
+**プリセットが変わると標準行が変わり**（`shorts-high-energy` は -4 / `calm-explainer` は -8。
+§プリセット実パラメータ表）、上下 2 行は標準行との相対差 +2 / -2 dB を保つ。さらに `intensity`
+に応じて 3 値すべてへ `(i - 50) * 0.04` dB を加える（§`intensity` 写像）。既定 preset での例:
+
+| `i` | 加算 | -4 の行 | 標準行 | -8 の行 |
+|---|---|---|---|---|
+| 30 | -0.8 dB | -4.8 | -6.8 | -8.8 |
+| 50 | ±0 dB | -4 | -6 | -8 |
+| 80 | +1.2 dB | -2.8 | -4.8 | -6.8 |
+
+範囲は音声契約の `[-60, 12]` クランプのままである。表以外の値を使ってもよいが、その場合は
+理由を編集レポートへ 1 行で記録する（**写像後の 3 値**は理由の記録を要しない既定である）。
+
+## 章転換の儀式（turn beat）
+
+射影先が**カット境界の儀式スナップ窓以内**（§演出プリセットと `intensity` 写像。既定 preset で
+±1.0 秒 / `calm-explainer` で ±0.5 秒。**`intensity` では動かない**）にある場合、SE の `t` は
+その**境界時刻へスナップ**する（音と画の切替を同時発火させる）。**境界から遠い `turn` は通常規則**
+（射影位置そのまま・強度ゲートも通常どおり）に従う。
+
+- カット境界の集合 = 各 keep-range の開始 timeline 秒（先頭の 0 を含む）+ タイムライン終端。
+- スナップは `audio.sfx[].t` にだけ効く。`beats[].t` は書き換えない（source 秒アンカー）。
+- **儀式は強度ゲートに優先する**。「境界から遠い `turn` は通常規則」という規定は、境界に近い
+  `turn` が通常規則の外にあることを意味する。[beats.md](beats.md) の既定マッピングでは
+  `chapter` event → `turn` の `strength` は 0.5 ±0.2（最大 0.7）であり、儀式がゲートに従属すると
+  `turn` の SE は原理的に発火しない。章転換で音と画を同時に切り替えるという儀式の目的が
+  成り立たなくなるため、スナップ窓以内の `turn` は強度ゲートを通さずスナップ発火させる。
+  ここは v0 の解釈であり、`direction` 導入後も**そのまま維持する**（儀式は `intensity` 非依存 =
+  演出を最小まで絞っても残る、契約 §4 の `intensity` = 0「演出最小限（儀式のみ）」と整合する）。
+  見直しはオーナー裁定による。
+
+## SE 既定表（kind → 手持ち SE）
+
+### 探索層と充足状況（2026-07-22 実測）
+
+素材の探索順は [report-guide.md](report-guide.md#素材計画) の全スコープ層（プロジェクト `assets/` →
+上位ディレクトリの `.akari/assets/` → `~/.akari/assets/` → 製品リポ `assets/` →
+`catalog/`）に従う。2026-07-22 時点の実測は次のとおりである。
+
+| 層 | 実体 | 状態 |
+|---|---|---|
+| 製品リポ `assets/audio/` | `INDEX.md` のみ（「まだ素材なし」） | **未充足**（全 kind） |
+| `catalog/audio/`（15 パック） | `meta.json` のみ。全件 `"remote": true` | **未充足**（参照配布のみ・実体バイナリを置かない規約） |
+| ユーザーライブラリ `~/.akari/assets/audio/`（10 パック・340 ファイル） | 音源実体あり | **充足**（下表はここの実体を指す） |
+
+したがって**製品リポジトリ内には SE の実体が 1 件も無く、リポジトリ層としては 5 kind すべてが
+未充足**である。下表の既定はユーザーライブラリ層の実在ファイルであり、この層が無い環境では
+既定表は空になる。**未充足の kind・未充足の環境に対する調達は
+[setup-audio-library](../setup-audio-library/SKILL.md) 側の仕事であり、本リーフでは代用音源を
+勝手に選ばない。**
+
+### 既定表
+
+パス基点は `~/.akari/assets/audio/`。`catalog/audio/<pack-id>/meta.json` が
+ライセンス・クレジット要件の正であり、下表の値はそれと突き合わせ済みである。
+
+| kind | 音の性格 | 既定 SE（実在パス・優先順） | ライセンス | クレジット | 状態 |
+|---|---|---|---|---|---|
+| `hook` | インパクト系（ドン/ガツン） | `soundeffect-lab-ambient-life-pack/和太鼓でドン.mp3`<br>`soundeffect-lab-anime-direction-pack/シャキーン1.mp3` | LicenseRef-SoundEffectLab-Free | 不要（任意） | 充足（ライブラリ層） |
+| `turn` | スウィッシュ系（シュッ/whoosh） | `soundeffect-lab-anime-direction-pack/シュッ！.mp3`<br>`soundeffect-lab-anime-direction-pack/シーン切り替え1.mp3` | LicenseRef-SoundEffectLab-Free | 不要（任意） | 充足（ライブラリ層） |
+| `punchline` | ポップ/決定音系（ポン/ジャン） | `soundeffect-lab-ui-signal-pack/決定ボタンを押す1.mp3`<br>`musmus-onomatope-sfx-pack/ポッ.mp3` | LicenseRef-SoundEffectLab-Free<br>LicenseRef-MusMus-Free | 1 点目は不要<br>2 点目は**必須**（下記 MusMus） | 充足（ライブラリ層） |
+| `reveal` | キラーン/チャイム系 | `soundeffect-lab-anime-direction-pack/きらーん1.mp3`<br>`musmus-onomatope-sfx-pack/チャイム.mp3` | LicenseRef-SoundEffectLab-Free<br>LicenseRef-MusMus-Free | 1 点目は不要<br>2 点目は**必須**（下記 MusMus） | 充足（ライブラリ層） |
+| `emotion` | 控えめなポップ系（強い衝撃音を使わない） | `otologic-motion-pop-sfx-pack/Motion-Pop19-1.mp3`<br>`soundeffect-lab-anime-direction-pack/パッ.mp3` | CC-BY-4.0<br>LicenseRef-SoundEffectLab-Free | 1 点目は**必須**（下記 OtoLogic）<br>2 点目は不要 | 充足（ライブラリ層） |
+
+`kind` は enum ではない（beats 契約 §2）。上表に無い `kind` の beat は既定 SE を持たないため、
+SE を付けずに無音の見せ場として残すか、素材計画としてチャットで提案して承認を得る。
+
+### 文脈による選び分け（優先順は既定のまま）
+
+既定は**機械的固定 = 常に優先順の 1 点目**である。そのうえで、**同 kind の表内・同ライセンス
+確認済みの範囲で、文脈（場面のトーン・直前 SE との重複回避）を理由に 2 点目以降や別採用を
+選んでよい。選んだ理由は編集レポートの選択根拠に 1 行で記録する（理由なき逸脱は不可 =
+既定の 1 点目）。**
+
+- 選び分けの範囲は**同 kind の行の中**に限る。別 kind の行から借りてこない。
+- 2 点目以降が `attribution_required: true` のパックなら、採用した時点でクレジット文の義務が
+  発生する（§`attribution_required: true` の採用時に必要なクレジット文）。「同ライセンス確認済み」
+  とは、この義務まで確認したうえで選ぶという意味である。
+- 理由の例: 「直前 4.4 秒で `hook` 1 点目（和太鼓）が鳴っているため、22.0 秒の `turn` は重複を
+  避けて 2 点目のシーン切り替え音を採用」「静かな独白の場面のため `emotion` は 2 点目の軽い
+  『パッ』を採用」。
+
+### `attribution_required: true` の採用時に必要なクレジット文
+
+採用したら編集レポートのクレジット文へ次の文言をそのまま載せる（`meta.json` の `ai_usage` に
+書かれた表記をそのまま使い、要約・言い換えをしない）。
+
+| パック | クレジット文 |
+|---|---|
+| `musmus-onomatope-sfx-pack` | `BGM:MusMus`（フル表記: `フリーBGM・音楽素材 MusMus https://musmus.main.jp`） |
+| `otologic-motion-pop-sfx-pack` | `音：OtoLogic（https://otologic.jp/）` |
+
+`attribution_required: false` のパック（効果音ラボ・DOVA-SYNDROME）はクレジット任意である。
+ただし効果音ラボ・MusMus・OtoLogic はいずれも**素材単体の再配布を禁じている**。採用 SE を
+プロジェクトへ複製するのは可だが、**公開リポジトリへコミットしない**。
+
+### プロジェクトへの取り込みとパス
+
+`audio.sfx[].path` は edit.json からの相対パスまたは絶対パスである（音声契約 §2）。可搬性のため、
+採用した SE はプロジェクトの `assets/audio/<pack-id>/<file>` へ複製し、**相対パスで参照する**ことを
+既定とする（[execution.md](execution.md) §2 の「同一ツリーでは相対を使う」に従う）。複製しない
+運用ではライブラリ層の絶対パスを書いてもよいが、プロジェクトの可搬性は失われる。
+
+## overlay 装飾の選択肢
+
+見せ場での視覚は、**カット境界の切替そのもの + 既存 overlay 部品（telop / motion カテゴリ）の
+提案まで**とする。
+
+- 既存部品の選択は [overlay-authoring](../overlay-authoring/SKILL.md) のカテゴリから行い、
+  素材計画（Checkpoint 2）としてチャットで提案・承認を得る。
+- **部品の新設・トランジション語彙の発明をしない。** `edit.json` に `transition` 系の未契約
+  フィールドを足さない。囲い・ラメ等の専用視覚部品を新設しない。
+- overlay を置く場合の `overlays[].start` は SE と同じ timeline 秒であり、SE の `t` と揃える
+  （儀式でスナップした `turn` では、スナップ後の境界時刻へ揃える）。
+
+## worked example
+
+### 入力 1 — `beats[]`（[beats.md](beats.md) の worked example の出力そのまま）
+
+| id | kind | `t`（source 秒） | strength |
+|---|---|---|---|
+| `b-0001` | `hook` | 12.4 | 0.8 |
+| `b-0002` | `turn` | 48.0 | 0.7 |
+| `b-0003` | `emotion` | 96.2 | 0.7 |
+| `b-0004` | `punchline` | 132.0 | 0.8 |
+| `b-0005` | `emotion` | 12.4 | 0.6 |
+
+### 入力 2 — `cuts[]`（keep-range 3 件）
+
+```json
+{
+  "cuts": [
+    { "in": 8.0, "out": 30.0 },
+    { "in": 47.2, "out": 60.0 },
+    { "in": 94.0, "out": 100.0 }
+  ]
+}
+```
+
+keep-range 長は 22.0 / 12.8 / 6.0 秒。timeline 上の区間と境界は次のとおり。
+
+| cut | source `[in, out)` | timeline `[開始, 終了)` |
+|---|---|---|
+| `cuts[0]` | `[8.0, 30.0)` | `[0.0, 22.0)` |
+| `cuts[1]` | `[47.2, 60.0)` | `[22.0, 34.8)` |
+| `cuts[2]` | `[94.0, 100.0)` | `[34.8, 40.8)` |
+
+カット境界の集合 = `{ 0.0, 22.0, 34.8, 40.8 }`（タイムライン長 40.8 秒）。
+
+### 射影と儀式（`intensity` 非依存の段）
+
+射影と儀式スナップは `direction` に依存しない（儀式スナップ窓は既定 preset で ±1.0 秒であり、
+`intensity` では動かない）。ここまでは 3 通りで共通である。
+
+| beat | 所属 cut | 先行 keep-range 長の合計 | `t - in` | 射影後 timeline 秒 | 最近傍境界との距離 | 儀式 |
+|---|---|---|---|---|---|---|
+| `b-0001` `hook` 0.8 | `cuts[0]` | 0.0 | `12.4 - 8.0 = 4.4` | **4.4** | `4.4 - 0.0 = 4.4` | 対象外（`turn` ではない） |
+| `b-0002` `turn` 0.7 | `cuts[1]` | 22.0 | `48.0 - 47.2 = 0.8` | 22.8 | `22.8 - 22.0 = 0.8 ≤ 1.0` | **成立 → 22.0 へスナップ** |
+| `b-0003` `emotion` 0.7 | `cuts[2]` | 34.8 | `96.2 - 94.0 = 2.2` | **37.0** | `37.0 - 34.8 = 2.2` | 対象外（`turn` ではない） |
+| `b-0004` `punchline` 0.8 | なし（`132.0` はどの keep-range にも含まれない） | — | — | — | — | — |
+| `b-0005` `emotion` 0.6 | `cuts[0]` | 0.0 | `12.4 - 8.0 = 4.4` | **4.4** | `4.4 - 0.0 = 4.4` | 対象外（`turn` ではない） |
+
+`b-0004` は**射影先 0 件**であり、以降どの `intensity` でも発火しない（正常）。
+
+### `intensity` 30 / 50 / 80 の比較（`preset` = `youtube-long-standard`）
+
+適用後パラメータ（§`intensity` 写像の途中式）:
+
+| パラメータ | `i=30` | `i=50` | `i=80` |
+|---|---|---|---|
+| 強度ゲート `0.8 - (i-50)*0.002` | `0.8 - (-20)*0.002 =` **0.84** | `0.8 - 0*0.002 =` **0.8** | `0.8 - 30*0.002 =` **0.74** |
+| 60 秒あたり最大 `round(2*(0.5+i/100))` | `round(2*0.8) = round(1.6) =` **2 件** | `round(2*1.0) =` **2 件** | `round(2*1.3) = round(2.6) =` **3 件** |
+| 同 kind 間隔 `20*(1.5-i/100)` | `20*1.2 =` **24 秒** | `20*1.0 =` **20 秒** | `20*0.7 =` **14 秒** |
+| `gain_db` 標準行 `-6 + (i-50)*0.04` | `-6 - 0.8 =` **-6.8** | **-6** | `-6 + 1.2 =` **-4.8** |
+| 儀式スナップ窓（写像しない） | ±1.0 秒 | ±1.0 秒 | ±1.0 秒 |
+
+各通りの強度ゲート判定と発火:
+
+| beat（射影後） | `i=30`（ゲート 0.84） | `i=50`（ゲート 0.8） | `i=80`（ゲート 0.74） |
+|---|---|---|---|
+| `b-0001` `hook` 0.8 @ 4.4 | 0.8 < 0.84 → **不通過** | 0.8 ≥ 0.8 → 通過 | 0.8 ≥ 0.74 → 通過 |
+| `b-0002` `turn` 0.7 @ 22.0（儀式成立） | 儀式が優先 → **発火** | 儀式が優先 → **発火** | 儀式が優先 → **発火** |
+| `b-0003` `emotion` 0.7 @ 37.0 | 0.7 < 0.84 → 不通過 | 0.7 < 0.8 → 不通過 | 0.7 < 0.74 → 不通過 |
+| `b-0004` `punchline` 0.8 | 射影先 0 件 | 射影先 0 件 | 射影先 0 件 |
+| `b-0005` `emotion` 0.6 @ 4.4 | 0.6 < 0.84 → 不通過 | 0.6 < 0.8 → 不通過 | 0.6 < 0.74 → 不通過 |
+| **発火した SE** | 22.0 `turn` | 4.4 `hook` / 22.0 `turn` | 4.4 `hook` / 22.0 `turn` |
+| **件数** | **1** | **2** | **2** |
+
+密度ガードレールの検算: 発火候補は `i=30` が 1 件・`i=50` が 2 件（上限 2 ちょうど）・`i=80` が
+2 件（上限 3 に対し余裕）で、タイムライン長 40.8 秒のどの 60 秒窓を取っても上限内である。
+同一 kind の連続は 3 通りとも無い（`hook` と `turn`）ため、同 kind 間隔（24 / 20 / 14 秒）の
+規則にも触れない。落ちる発火は 3 通りとも 0 件である。
+
+同時多発の制限の検算: `i=50` / `i=80` の発火は 4.4 と 22.0 の 2 件で差は 17.6 秒。±0.5 秒以内の
+重なりは無いためどちらも残る。`b-0005` は `b-0001` と同じ 4.4 へ射影されるが、3 通りとも
+その前の強度ゲートで脱落しているため ±0.5 秒の競合にはならない（仮に `b-0005` がゲート以上
+だったなら、`strength` の高い `b-0001` が残る）。
+
+**単調性の確認**: SE 件数は **1（`i=30`）≤ 2（`i=50`）≤ 2（`i=80`）** で単調非減少である。
+`i=50 → 80` で増えていないのは、ゲートが 0.74 まで下がってもこの入力に `[0.74, 0.8)` の
+`strength` を持つ beat が存在しない（次点が 0.7）ためであり、写像が単調でも件数が必ず増えるとは
+限らないことの実例である。逆向き（`i` を上げて件数が減る）は写像の単調性から起きない。
+
+`gain_db` は各通りとも標準行の値（-6.8 / -6 / -4.8）とした（`strength` は 0.8 で 0.9 未満、
+`hook` の 4.4 秒は儀式スナップではないため -4 の行の条件に当たらない）。SE はいずれも既定表の
+1 点目であり、文脈による選び分けを行っていないため選択根拠の追記も発生しない。
+
+### 出力 — `edit.json`（`i=50` の完全 JSON）
+
+```json
+{
+  "version": 0,
+  "output": { "width": 1280, "height": 720, "fps": 30 },
+  "source": { "path": "source.mp4", "proxy": null },
+  "direction": { "preset": "youtube-long-standard", "intensity": 50 },
+  "cuts": [
+    { "in": 8.0, "out": 30.0 },
+    { "in": 47.2, "out": 60.0 },
+    { "in": 94.0, "out": 100.0 }
+  ],
+  "overlays": [],
+  "audio": {
+    "sfx": [
+      { "path": "assets/audio/soundeffect-lab-ambient-life-pack/和太鼓でドン.mp3", "t": 4.4, "gain_db": -6 },
+      { "path": "assets/audio/soundeffect-lab-anime-direction-pack/シュッ！.mp3", "t": 22.0, "gain_db": -6 }
+    ]
+  },
+  "beats": [
+    {
+      "id": "b-0001",
+      "t": 12.4,
+      "kind": "hook",
+      "strength": 0.8,
+      "basis": "hook event 12.4–24.0s / 5 軸合計 21/25 → 0.8。発話『ついに来ました、今日はこれを全部お見せします。』"
+    },
+    {
+      "id": "b-0002",
+      "t": 48.0,
+      "kind": "turn",
+      "strength": 0.7,
+      "basis": "chapter event『セットアップ手順』@ 48.0s。本編の入口として既定 0.5 から +0.2"
+    },
+    {
+      "id": "b-0003",
+      "t": 96.2,
+      "kind": "emotion",
+      "strength": 0.7,
+      "basis": "発話『正直、ここまで変わるとは思っていませんでした。』@ 96.2s"
+    },
+    {
+      "id": "b-0004",
+      "t": 132.0,
+      "kind": "punchline",
+      "strength": 0.8,
+      "basis": "highlight event importance 4『処理時間は 12 分から 90 秒になりました。』@ 132.0s"
+    },
+    {
+      "id": "b-0005",
+      "t": 12.4,
+      "kind": "emotion",
+      "strength": 0.6,
+      "basis": "発話『ついに来ました、今日はこれを全部お見せします。』@ 12.4s。冒頭の高揚を hook とは別に感情の山として記録"
+    }
+  ]
+}
+```
+
+`beats[].t` は射影後も source 秒のまま（12.4 / 48.0 / 96.2 / 132.0 / 12.4）であり、スナップした `turn` も
+書き換えていない。SE の 2 件はいずれも既定表 `hook` / `turn` の 1 点目であり、どちらも
+`attribution_required: false` のためクレジット文は発生しない。BGM は `audio` に一切書いていない
+（ビート連動の BGM 操作をしない）。`direction` は演出の入力宣言であり、`beats[]` と同じく
+書き出し成否を左右しない（[演出宣言契約](../../docs/contract-2026-07-23-edit-json-v1-direction.md) §5）。
+
+### 出力の差分 — `i=30` / `i=80`
+
+`i=30` / `i=80` は上の完全 JSON のうち **`direction.intensity` と `audio.sfx[]` だけ**が差し替わり、
+`version` / `output` / `source` / `cuts` / `overlays` / `beats` は同一である
+（`beats[]` は素材の事実であり `intensity` で変わらない）。
+
+```jsonc
+// i = 30 — 強度ゲート 0.84 で hook 0.8 が落ち、儀式スナップした turn だけが残る
+"direction": { "preset": "youtube-long-standard", "intensity": 30 },
+"audio": {
+  "sfx": [
+    { "path": "assets/audio/soundeffect-lab-anime-direction-pack/シュッ！.mp3", "t": 22.0, "gain_db": -6.8 }
+  ]
+}
+```
+
+```jsonc
+// i = 80 — 強度ゲート 0.74。発火は i=50 と同じ 2 件で、gain_db だけが +1.2 dB される
+"direction": { "preset": "youtube-long-standard", "intensity": 80 },
+"audio": {
+  "sfx": [
+    { "path": "assets/audio/soundeffect-lab-ambient-life-pack/和太鼓でドン.mp3", "t": 4.4, "gain_db": -4.8 },
+    { "path": "assets/audio/soundeffect-lab-anime-direction-pack/シュッ！.mp3", "t": 22.0, "gain_db": -4.8 }
+  ]
+}
+```
+
+### 検証（2026-07-23 実測 / `intensity` 3 通り）
+
+3 通りそれぞれを `edit.json` として別々の一時プロジェクトへ置き、SE を
+`assets/audio/<pack-id>/` へ実体配置して検証した（`analysis.json` は `duration: 180` のみ、
+`source.mp4` は実ファイル。3 プロジェクトとも同じ素材構成）。
+
+```
+$ node packages/schemas/bin/validate-edit.mjs <tmp>/proj-i30/edit.json
+OK: <tmp>/proj-i30/edit.json                          # exit 0 / 0.097s
+$ node packages/edit-lint/bin/edit-lint.mjs <tmp>/proj-i30
+PASS: <tmp>/proj-i30 (0 findings, 4 skipped)          # exit 0 / 0.125s
+
+$ node packages/schemas/bin/validate-edit.mjs <tmp>/proj-i50/edit.json
+OK: <tmp>/proj-i50/edit.json                          # exit 0 / 0.107s
+$ node packages/edit-lint/bin/edit-lint.mjs <tmp>/proj-i50
+PASS: <tmp>/proj-i50 (0 findings, 4 skipped)          # exit 0 / 0.135s
+
+$ node packages/schemas/bin/validate-edit.mjs <tmp>/proj-i80/edit.json
+OK: <tmp>/proj-i80/edit.json                          # exit 0 / 0.093s
+$ node packages/edit-lint/bin/edit-lint.mjs <tmp>/proj-i80
+PASS: <tmp>/proj-i80 (0 findings, 4 skipped)          # exit 0 / 0.104s
+```
+
+`gain_db` の写像後の値（-6.8 / -4.8）が音声契約の `[-60, 12]` クランプ内であることも、この
+PASS で機械的に確認されている。参照解決が実際に効いていることは、SE 1 点を退避した状態で
+`[warning] audio.sfx.file: sfx path does not resolve to a regular file: ...` が 1 件出ることで確認した
+（戻すと 0 findings に復帰）。
+
+## 検証
+
+書いた `audio.sfx[]` は既存の検証手順（[execution.md](execution.md) §4 の
+[edit-lint](../edit-lint/SKILL.md) 実行）で `edit.json` ごと検証する。edit-lint は次を見る。
+
+- `audio.sfx[].t` が負・非有限ならエラー、タイムライン長を超えていれば warning。
+- `audio.sfx[].gain_db` が `[-60, 12]` の外ならエラー。
+- `audio.sfx[].path` が実ファイルへ解決できなければ warning（音声は装飾であり、映像本体の
+  書き出し成否を左右しない — 音声契約 §5 の劣化規約）。**warning でも放置しない。**
+  パス誤り・未取り込みのまま書き出すと無音で仕上がる。
+
+## よくある間違い
+
+- 承認前の `beats[]` から先回りして SE を組む。
+- `audio.sfx[].t` に source 秒（`beats[].t`）をそのまま書く。SE は timeline 秒である。
+- 射影結果を `beats[].t` へ書き戻す。beats は素材の事実であり、カットを変えるたびにずれる値を
+  焼き込まない。
+- 射影先 0 件の beat を「取りこぼし」と誤認し、cuts を変えてでも鳴らそうとする
+  （カットで落とした見せ場が鳴らないのは正常）。
+- 強度ゲート未満の `strength` の beat に SE を付けて演出過多にする（既定 preset・`i=50` なら
+  0.8 未満）。無音の見せ場を残すのが既定である。
+- `edit.json` の `direction` を見ずに、強度ゲート 0.8 / 密度 2 件・20 秒 / スナップ窓 ±1.0 秒を
+  固定値として使う。これらは `direction { preset, intensity }` から導く値であり、既定 preset・
+  `i=50` のときだけ従来の固定値と一致する。
+- `intensity` を「なんとなく強め・弱め」と定性的に解釈する。写像式（§`intensity` 写像）で
+  数値へ落とし、途中式をレポートに残す。
+- `intensity` で儀式スナップ窓を伸縮させる、または `intensity` を下げて儀式スナップ済みの `turn`
+  を消す。儀式は `intensity` 非依存であり、`intensity` = 0 でも残る。
+- `direction` が壊れているのを理由に書き出しを止める。宣言ごと捨てて既定動作
+  （`youtube-long-standard` + `intensity` 50）へ倒すのが劣化規約である。
+- 同一時刻 ±0.5 秒に SE を重ねる（複数の beat が近接したら `strength` の高い 1 件だけを残す）。
+- `turn` のスナップで `beats[].t` を境界へ動かす（動かすのは `audio.sfx[].t` だけ）。
+- 密度ガードレールを **source 秒**（`beats[].t`）で数える。数えるのは射影後の timeline 秒であり、
+  カットで落とした区間の beat に枠を消費させない。
+- 密度を導出段（[beats.md](beats.md)）へ持ち帰って beats 自体を間引く。beats は素材の事実であり、
+  間引くのは発火の方である。
+- 密度ガードレールで儀式スナップ済みの `turn` を落とす（章転換の儀式は密度にも優先する）。
+- 密度で落とした発火を `decision-log.md` に残さず、黙って消す。
+- 評価順を入れ替える（例: ±0.5 秒制限を密度より先に効かせる）。順は
+  射影 → 儀式スナップ → 強度ゲート → 密度 → ±0.5 秒制限 → 昇順追記で固定である。
+- 既定表の 2 点目以降を採用したのに、選んだ理由を編集レポートの選択根拠へ 1 行で残さない
+  （理由なき逸脱は不可。既定は 1 点目である）。
+- 文脈の選び分けと称して**別 kind の行**から音を借りる、または表外・ライセンス未確認の音源を使う。
+- `gain_db` を目安表以外の値にしたのに理由を記録しない。逆に、**写像後の**目安表の 3 値
+  （既定 preset・`i=50` で -4 / -6 / -8）へいちいち理由を書く必要はない。
+- 既定表に無い kind へ「近そうな音」を勝手に割り当てる。未充足は未充足として残し、調達は
+  setup-audio-library に回す。
+- ビートに合わせて BGM の音量・曲を切り替える（v0 では BGM を触らない）。
+- `edit.json` に未契約のトランジションフィールドを足す、または見せ場用の新規 overlay 部品を新設する。
+- `attribution_required: true` の SE を採用したのにクレジット文を編集レポートへ載せない。