akari-video 0.1.28 → 0.1.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/src/capture-command.mjs

@@ -14,7 +14,7 @@ export async function runCaptureCommand(argv, options = {}) {
   }
 
   const isHelp = argv.includes("--help") || argv.includes("-h");
-  if (!isHelp) {
+  if (!isHelp && captureNeedsChrome(argv, options.platform ?? process.platform)) {
     const browser = await resolveBrowserDiagnostics(assets, options);
     if (!await browser.findChromePath()) {
       logError(await browser.describeChromeNotFound());
@@ -30,6 +30,15 @@ export async function runCaptureCommand(argv, options = {}) {
   return { exitCode: typeof result.status === "number" ? result.status : 1 };
 }
 
+export function captureNeedsChrome(argv, platform = process.platform) {
+  let engine = "auto";
+  for (let index = 0; index < argv.length; index += 1) {
+    if (argv[index] === "--engine" && argv[index + 1] !== undefined) engine = argv[index + 1];
+    else if (argv[index].startsWith("--engine=")) engine = argv[index].slice("--engine=".length);
+  }
+  return engine === "legacy" || (engine === "auto" && !["darwin", "win32"].includes(platform));
+}
+
 async function resolveBrowserDiagnostics(assets, options) {
   if (options.findChromePath && options.describeChromeNotFound) {
     return {

package/src/migrate-command.mjs

@@ -39,7 +39,15 @@ export async function runMigrateCommand(args, options = {}) {
     // captions.json の不在・読み取り失敗・壊れた JSON は cue なしとして移行を続ける。
   }
   const hasCaptions = migrate.captionsHaveRenderableCues(captionsRoot);
-  const proposal = migrate.planMigration(projectRoot, editPath, text, { hasCaptions, now: options.now });
+  let editVersion;
+  try {
+    editVersion = migrate.detectEditVersion(JSON.parse(text));
+  } catch {
+    // JSON error の文言は従来どおり planMigration に一元化する。
+  }
+  const proposal = editVersion === 2
+    ? migrate.planV2Normalization(projectRoot, editPath, text, { now: options.now })
+    : migrate.planMigration(projectRoot, editPath, text, { hasCaptions, now: options.now });
   if (proposal.ok === false) {
     if (parsed.json) {
       log(JSON.stringify({ ok: false, error: 'このプロジェクトは変換できません', blockers: proposal.blockers }));
@@ -49,13 +57,18 @@ export async function runMigrateCommand(args, options = {}) {
     }
     return { exitCode: 2 };
   }
+  if (proposal.noop === true) {
+    if (parsed.json) log(JSON.stringify({ ok: true, noop: true, version: proposal.version }));
+    else log('変換の必要はありません。');
+    return { exitCode: 0, proposal };
+  }
   if (parsed.json) {
     log(JSON.stringify({
       ok: true, dryRun: parsed.dryRun, version: proposal.version,
       filePath: proposal.filePath, backupPath: proposal.backupPath, changes: proposal.changes
     }));
   } else {
-    log(`変換対象: ${proposal.filePath} (version ${proposal.version} -> 2)`);
+    log(`変換対象: ${proposal.filePath} (version ${proposal.version}${proposal.version === 2 ? ' 正規化' : ' -> 2'})`);
     for (const change of proposal.changes) log(`- ${change.path}: ${change.note}`);
     log(`変換前の退避先: ${proposal.backupPath}`);
   }
@@ -78,7 +91,11 @@ export async function runMigrateCommand(args, options = {}) {
     }
   }
   await migrate.applyMigration(proposal);
-  if (!parsed.json) log(`version 2 へ変換しました。元ファイル: ${proposal.backupPath}`);
+  if (!parsed.json) {
+    log(proposal.version === 2
+      ? `version 2 を正規化しました。元ファイル: ${proposal.backupPath}`
+      : `version 2 へ変換しました。元ファイル: ${proposal.backupPath}`);
+  }
   return { exitCode: 0, proposal };
 }
 
@@ -121,7 +138,7 @@ export function migrateHelp() {
   return [
     '使い方: akari migrate [dir] [--yes] [--dry-run] [--json]',
     '',
-    'v0/v1 の edit.json を v2 へ片道変換します。',
+    'v0/v1 の edit.json を v2 へ片道変換し、v2 は正規形へ移行します。',
     '既定は変更内容を表示して y/n で確認し、変換前の全文を .akari/backup/ へ退避します。',
     '',
     '  --yes, -y   表示後の確認を省略',

package/vendor/.akari-capability-sources.json

@@ -31,6 +31,7 @@
     "docs/contract-2026-08-03-cut-candidate-bridge-v1.md",
     "docs/contract-2026-08-03-status-integrity-v1.md",
     "docs/contract-2026-08-05-fx-v0.md",
+    "docs/contract-2026-08-09-transform-keyframes-v0.md",
     "docs/contract-2026-08-11-analysis-vision-tracks-v0.md",
     "docs/contract-2026-08-11-review-session-ui-events.md",
     "docs/contract-2026-08-12-chat-approval-v0.md",
@@ -48,6 +49,8 @@
     "docs/contract-2026-08-28-v2-audio-roles-v0.md",
     "docs/contract-2026-08-29-capture-v0.md",
     "docs/contract-2026-08-29-media-inspect-cli-v0.md",
+    "docs/contract-2026-08-30-edit-json-v2-object-tree-v0.md",
+    "docs/contract-2026-08-30-motion-and-keyframes-v0.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -69,6 +72,7 @@
     "packages/edit-lint/package.json",
     "packages/edit-lint/README.md",
     "packages/edit-store/package.json",
+    "packages/edit-store/README.md",
     "packages/export-nle/package.json",
     "packages/frame-engine/package.json",
     "packages/frame-engine/README.ja.md",
@@ -120,6 +124,8 @@
     "skills/compile-review-session/dev-fixtures/README.md",
     "skills/compile-review-session/SKILL.md",
     "skills/create-project/SKILL.md",
+    "skills/critique-cut/SKILL.md",
+    "skills/critique-cut/workflow.md",
     "skills/declare-audio/after-save.md",
     "skills/declare-audio/launch.md",
     "skills/declare-audio/SKILL.md",

package/vendor/docs/contract-2026-07-18-edit-json-v1-sources.md

@@ -44,6 +44,10 @@
 
 `sources[].proxy` の生成規格は [プレビュー用プロキシの規格](./contract-2026-08-02-preview-parity.md#55-プレビュー用プロキシの規格) に従う。
 
+v2 プレビューでは `sources[].proxy` は任意の最適化である。宣言されていれば既定でそれを使い、
+起動を速くする。宣言が無ければ `VideoDecoder.isConfigSupported` で器の実力を調べ、原本を直接読む。
+器が原本を扱えない場合は preview-server が同じプロキシ規格で自動生成する。
+
 参照は path ではなく安定した `id` で行う。これにより素材の差し替えや path 変更で cut や
 サイドカーの参照が壊れない。JSON Schema は将来の任意フィールドを許容する tolerant reader とし、
 既知フィールドの型、version ごとの必須形、`source` / `sources[]` の排他を検証する。

package/vendor/docs/contract-2026-07-22-render-basics.md

@@ -40,7 +40,7 @@
    素の色のまま合成されて、窓の継ぎ目で肌色が食い違った。「プロジェクト全体の色」だと
    誤解しやすいため、ここに明記する。
 4. **書き出しエンジンの既定（2026-08-28 改訂）**: `--engine` 省略時は `auto`。
-   darwin では v2（OSR）、win32 / linux では legacy に解決する。従来経路へ戻す場合は
+   darwin / win32 では適格なら GPU、不適格なら OSR、linux では legacy に解決する。従来経路へ戻す場合は
    `render-cut --engine legacy` を明示する。
 
 ### 2-4. reveal 系トランジション（`reveal-down` / `reveal-up`。2026-08-14 追加）
@@ -168,3 +168,11 @@ x264、その他の環境で x264 の順に解決する。ハードウェア対
 誤判定を避けるため 256x144 で試し焼きし、`AKARI_EXPORT_FORCE_X264=1` のときは試し焼きせず
 すべて不採用とする。明示指定した Windows 向け方式が利用不能なら x264 へ暗黙移行せず停止する。
 `AKARI_EXPORT_FORCE_X264=1` のときに Windows 向け方式を明示指定した場合も、同じく停止する。
+
+## 7. v2 書き出しの cut 中間物（2026-08-29 追記）
+
+OSR / GPU の v2 書き出しでは、映像エンジンが `edit.sources` から直接描画するため、cut 段と
+tail-pad 段は音声専用中間物だけを生成する。通常は `cut-audio.mp4`、最終尺までの音声 padding が
+必要な場合は `cut-audio-tail-padded.mp4` を使用し、どちらも `-vn` で映像を処理しない。
+legacy 書き出しは従来どおり `cut.mp4` と必要時の `cut-tail-padded.mp4` を使用する。
+音声入力は cut ごとに入力側シーク（`-ss` / `-t`）し、cut 頭 0.5 s の先読みガード（AAC の overlap-add 用）を設け、cut 段の費用を素材長に依存させない。

package/vendor/docs/contract-2026-07-25-project-structure-v0.md

@@ -149,3 +149,15 @@ updated: 2026-08-26
 - スキーマ変更（`edit.json` 等の既存契約ファイル形は不変）
 - 「paths 宣言」（プロジェクトごとの置き場所カスタマイズ UI）の導入
 - ルート直下 `cache/`（レガシー）の最終的な扱いの裁定（§3・§6）
+
+## 8. 追記（2026-08-30）— `motion/` を正本ディレクトリとして登録
+
+`contract-2026-08-30-edit-json-v2-object-tree-v0.md` / `contract-2026-08-30-motion-and-keyframes-v0.md` により、
+プロジェクト直下に **`motion/`** を追加する。
+
+| 用途 | 置き場 | 作成者 | 性質 |
+|---|---|---|---|
+| キーフレーム曲線の袋（`motion/<group-id>.json`。edit.json の `keyframes: { path, count }` から参照）| `motion/` | edit-store（保存時に inline から振り分け）| **正本**（再生成不可。`.akari/cache/` ではない）|
+
+- edit.json / captions.json と同じトランザクションで保存され、同じ lint ゲートを通る
+- §2 の「ルート直下への新規ファイル作成は正本ファイルに限る」の例外ではなく、正本ファイルの追加である

package/vendor/docs/contract-2026-08-02-preview-parity.md

@@ -10,6 +10,7 @@
 |---|---|---|
 | 2026-08-02 | v0 | Web UI と shell の挙動仕様を統合 |
 | 2026-08-28 | v2 | `packages/frame-engine` の意味論へ統合し、検収をゴールデンフレームへ一本化。出口を OSR と GPU 直結の 2 本に固定し、互換経路を退役節へ移動 |
+| 2026-08-31 | v2.1 | §5.2 に断片 CSS の `vw` / `vh` 系単位の出力サイズ基準化（`viewport-units.js`。プレビューがウィンドウ幅基準で解いていた実機報告の修正）を追記 |
 
 ## 1. 役割分担
 
@@ -242,6 +243,14 @@ legacy 合成経路は、移行中の既存利用者と Windows を支えるた
 `edit.json` のあるディレクトリからの相対ファイルパスとして解決する。`vars` は `--` で始まるキーだけを
 CSS カスタムプロパティとして overlay root へ適用し、それ以外のキーは DOM や JavaScript へ注入しない。
 
+断片 CSS の `vw` / `vh` / `vmin` / `vmax`（`dvw` 等の接頭辞付き・`vi` / `vb` 含む）は**出力サイズ基準**で
+解決する（`1vw` = `output.width / 100` px）。書き出しは出力サイズちょうどの viewport で overlay sheet を
+描くので素のままで正しいが、器のプレビューはステージを `scale()` でペインへ収めるため素の `vw` は
+ウィンドウ幅基準になってしまう。器は mount 時に `packages/overlay-runtime/src/viewport-units.js` で
+`<style>` / `style=""` の `<数値><単位>` を `calc(<数値> * var(--akari-vw, 1vw))` へ書き換え、ステージ要素に
+`--akari-vw` 等（出力サイズ / 100 px）を定義して一致させる（2026-08-31。shell / Web 共通。`@media` 等の
+プレリュード・文字列・`url()` は書き換えない）。
+
 ### 5.3 書き込み経路
 
 UI、API、RPC の別を問わず、`edit.json` / `captions.json` へのすべての書き込みは edit-lint ゲートを通す。
@@ -267,3 +276,42 @@ frame-engine がランダムアクセスするプレビュー用プロキシは
 いずれも `packages/media-bin/src/proxy-recipe.mjs` を唯一の定義として使う。レシピ版
 `gop1s-v1` は shell のキャッシュキーと preview-server の出力名へ含め、旧規格のキャッシュを
 次回参照時に再利用しない。
+
+### 5.6 読み込み予算と原本 / proxy の選択規則
+
+frame-engine のソース読み込み予算は、`Content-Length` が得られる場合
+`max(10 秒, bytes / 8 MiB毎秒)` とする。予算を超えても受信進捗が続く間は打ち切らず、進捗が
+5 秒間止まった場合に失敗とする。同一 URL の fetch はセッションにつき 1 回に限り、再試行では
+取得済みバイトと解析済み moov / キーフレーム索引を再利用する。
+
+v2 プレビューの既定選択は次の順序とする。
+
+1. 宣言済み proxy があれば proxy を使う（`declared`）
+2. proxy が無ければ codec をプローブし、`hw || any` で扱える場合は原本を使う
+   （`hardware-ok` / `decoder-ok`）
+3. 扱えない場合は preview-server に自動プロキシを要求し、生成中は非致命の通知を表示する
+   （`auto-proxy`）
+
+Web UI の `?frameEngineSource=original`、または shell の
+`AKARI_FRAME_ENGINE_SOURCE=original` では 1 を飛ばして器の実力判定へ進む。`=proxy` では従来どおり
+proxy を無条件に優先する。
+`AKARI_FRAME_ENGINE_FORCE_SW=1` はハードウェアデコード不可を模擬するテスト用スイッチである。
+HEVC は `prefer-software` が通らないため、codec プローブが `sw=false` を返した系列について
+ClipSessionPool はソフトウェア退避を学習しない。ソフトウェア退避の学習対象は H.264 のみとする。
+
+tkhd に 90 / 180 / 270 度の回転を持つ素材は、既定でデコーダ出力を毎フレームの
+OffscreenCanvas へ焼き直さない。frame-engine は回転メタをフレームへ付帯し、compositor の
+UV 逆写像で表示回転を 1 回だけ適用する。crop、framing、keyframe、既存 transform / perspective は
+回転後の論理空間を基準とし、90 / 270 度では coded width / height を入れ替えた論理寸法を使う。
+この規則は VideoFrame の直接 upload と copyTo の両経路に共通である。
+
+デコーダエラーは window 全域イベントで飛ぶため、他クリップの失敗と区別できない。frame-engine は
+検出後 `decoderErrorGraceMs`（既定 1 秒）だけ自分の操作の成功を待ち、期限内に成功した場合はその
+エラーを無視する。prime がフレームを返さず、かつエラーを観測した場合だけ、その試行を失敗とする。
+
+### 5.7 映像ソースの読み方とパリティ
+
+frame-engine が MP4 を全体ストリームとして読むか、`ftyp` / `moov` の索引と必要な圧縮サンプルの
+Range として読むかは、完成画の意味論に影響しない。どちらの読み込み経路も同じ presentation 時刻の
+VideoFrame を §4.1 の評価点へ供給し、`elst.media_time`、B フレームの並べ替え、メディア終端を含めて
+golden の `diff 0` を満たさなければならない。ソース取得方法の変更をパリティ差の許容理由にしてはならない。

package/vendor/docs/contract-2026-08-09-transform-keyframes-v0.md

@@ -0,0 +1,35 @@
+---
+lifecycle: implemented
+created: 2026-08-09
+updated: 2026-08-30
+---
+
+# 変形キーフレーム契約 v0（`layers[].keyframes` / v2 `items[].keyframes`）— 2026-08-30 復元
+
+> **復元の注記（2026-08-30）**: 本契約は `packages/schemas/edit.schema.json`（`layerKeyframe` / `layerItem` / `keyframeV2` の `$comment`）・
+> `packages/schemas/bin/validate-edit.mjs`・`packages/render-cut/src/layer-keyframes.mjs` ほか 10 箇所から参照されていたが、
+> 実ファイルがどのブランチの履歴にも存在しなかった。スキーマの `$comment` に残っていた意味論からそのまま再構成した。
+> **後継 = `contract-2026-08-30-motion-and-keyframes-v0.md` §2**（opacity の追加・easing 語彙の拡張・`motion/` 袋への参照形）。
+> 本ファイルは v0 の意味論の記録であり、これ以上追記しない。
+
+- 日付: 2026-08-09（実装済み・`contract-2026-07-22-render-basics.md` §4-4 に要約あり）
+- 状態: implemented（v1 `layers[].keyframes`・v2 `items[].keyframes` の両方で有効）
+
+## 1. 意味論
+
+- `keyframes[]` はレイヤー / アイテムの `transform` / `crop` / `perspective` を時間で動かす共通機構
+- `t` は**ローカル時間**: v1 `layers[].keyframes[].t` はレイヤー内秒（`layerItem.t` を 0 とする。`cuts[].framing.keyframes[].t` と同じ規約）、
+  v2 `items[].keyframes[].t` は**アイテム内の整数フレーム**（`item.at` を 0 とする）
+- `transform` / `crop` / `perspective` はそれぞれ**独立の任意プロパティ**（プロパティごとの別トラックにはしない — 1 点で複数プロパティを同時に動かせる）
+- ある区間の両端点が同じプロパティを持てばその間は**線形補間**。片方の端点にしか無ければ直近の宣言値を**保持（hold）**
+- どの点にも一度も宣言されないプロパティは、レイヤー / アイテム直下の**静的値**（省略時は各 `$def` の既定値）を全区間で保持する
+- `easing` は点ごとに設定し、**その点へ入る区間**（1 つ前の点からこの点まで）の補間カーブを決める。先頭点の `easing` は無視。省略時 `linear`。語彙は `linear` / `ease-in-out`
+- 2 点以上・`t` 昇順・重複禁止（`validate-edit.mjs` で検証）。`keyframes` が無い、または使える点が 2 点未満のときは既存の静的値のみが効く（回帰なし・バイト等価）
+- render-cut は cuts 合成後のベース映像へ `t` 順に合成する。プレビューは同じ補間を CSS / WebGL で再現する（`contract-2026-08-02-preview-parity.md`）
+
+## 2. 参照元（復元時点）
+
+`packages/schemas/edit.schema.json` / `packages/schemas/bin/validate-edit.mjs` / `packages/render-cut/src/layer-keyframes.mjs` / `packages/render-cut/src/layers.mjs` /
+`packages/render-cut/test/layer-keyframes.test.mjs` / `packages/preview-server/test/layer-keyframes-visual.test.mjs` /
+`apps/shell/extensions/akari-preview/src/common/edit-summary-fields.ts` / `apps/shell/extensions/akari-preview/src/common/layer-keyframes-visual.ts` /
+`apps/shell/extensions/akari-preview/src/browser/akari-preview-open-handler.ts` とそのテスト

package/vendor/docs/contract-2026-08-12-still-image-cut-source-v0.md

@@ -23,6 +23,12 @@ updated: 2026-08-12
   - `contract-2026-07-17-data-contract-versioning.md`（version 整数・追加のみ・寛容リーダーの三原則）
 - スコープ: `edit.json` の `cuts[]` がメイン時間軸で静止画ソース（png/jpg/jpeg/webp/bmp/gif）を
   直接読めるようにする。**新しいスキーマフィールドは作らない**（判定は拡張子のみ）
+- 2026-08-31 追記（issue #30）: frame-engine 経路（`--engine gpu` / `osr`、および v2 プレビュー）でも同じ
+  意味論で描く。runtime が拡張子で `CachedStillImageSource` として登録した素材を、`plan.ts` が
+  `kind: 'image'` の base 層（`sourceTimeUs` は常に 0・尺は `out - in`・transform / crop / keyframes は
+  動画 cut と同じ・トランジションの outgoing / incoming にもなれる）として評価し、compositor は
+  layers と同じ texture cache を base の RGBA 経路へ結ぶ。それまでは `layerFromPlacement` が
+  `decode` 持ちしか受けず `no video frame source registered` で落ちていた（legacy との受理差）
 
 ## 0. 背景
 

package/vendor/docs/contract-2026-08-28-gpu-export-v0.md

@@ -27,6 +27,22 @@ CSS animation/transition/keyframes、filter/mask/clip-path 等を検出する。
 `<script type="application/json" data-akari-3d-scene>` 宣言を属性順にかかわらずちょうど 1 個持ち、
 それ以外の script と video を持たない宣言型 3D は `three` とする。3D の描画先である canvas は許可する。
 
+`data-akari-slot` への文言注入（`source.params`。正本 `contract-2026-08-22-overlay-html-slots.md`）は、
+静的 HTML のスプライト化の直前と DOM 層の mount 時に、legacy の rasterize / プレビューの overlay-runtime と
+同じ `packages/overlay-runtime/src/slot-params.js` の `renderTextSlots` で適用する。params を持つ overlay が
+1 件でもあればページに同 runtime を inline し、receipt の manifest に `textSlotOverlayCount` を残す。
+params があるのに runtime が無い状態は既定文言を黙って焼かず fail-closed にする（2026-08-31・issue #32）。
+
+frame-engine のメイン時間軸（cuts）は静止画ソース（edit-store の `isStillImageSourcePath`）を
+`kind: 'image'` の base 層として描く（尺は `out - in`・ソース時刻なし・transform / crop / keyframes は動画 cut と
+同じ。正本 `contract-2026-08-12-still-image-cut-source-v0.md`。2026-08-31・issue #30）。2 本目以降の visual
+トラックの映像クリップは `at` / `track` を保持して絶対配置し、番号が大きいトラックが前面（v2 の `tracks[]` 配列順）。
+track 0 は従来どおり連結チェーン（freeze で伸び、トランジション重なりは宣言から再計算）のまま
+（2026-08-31・issue #31。それまでは GPU / OSR の runtime が導出 `at` / `track` を全 cut から外していたため、
+上段のクリップが直列に連結されて出力尺の外へ押し出され、PASS のまま絵が消えていた）。同じ規則を
+frame-engine へ cuts を渡す残り 2 面（preview-server の Web UI プレビュー・シェルのプレビュー）にも適用し、
+プレビューと書き出しが同じ絵を出す（preview parity。シェルは `renderTrack` の最小値を最下段とみなす）。
+
 字幕は cue ごとに rasterize し、出現・loop・消失を解析的な opacity と中心基準 affine 変換で
 再現する。v2 では `words[]` を持つ karaoke、pop、reveal、reveal-word と `emphasis_words` も
 語矩形タイルとして GPU-native に合成する。次は引き続き `unsupported` とする。
@@ -89,8 +105,8 @@ SVG の入力は data URL に固定する。Blob URL と同一オリジン HTTP
 2 走一致、製品経路の読み戻し 0 を要求する。性能 gate は cue ラスタ p50 500 ms 以下、karaoke 44 cue の
 akari-video-pv 18 ms/コマ以下、小 fixture（360 コマ・3 cue）の RSS peak 900 MB 以下とする。
 
-`--engine auto` は macOS で全件適格なら `gpu`、不適格なら `osr` を選ぶ。他 OS の `auto` は従来の
-選択を維持する。明示 `--engine gpu` と不適格の組み合わせは理由を全件表示して fail-closed とし、
+`--engine auto` は macOS / Windows で全件適格なら `gpu`、不適格なら `osr` を選ぶ。Linux の `auto` は
+`legacy` を維持する。明示 `--engine gpu` と不適格の組み合わせは理由を全件表示して fail-closed とし、
 黙って OSR へ変更しない。GPU launcher が利用できない明示指定も fail-closed とする。
 
 ## 3. 合成順と LUT
@@ -195,8 +211,8 @@ OSR receipt と同じ warning/hard-stop 語彙を使う。`--engine osr` と `--
 
 - 語矩形で表せない演出、色補間と幾何変形が同居する cue、縦書きの語単位字幕は glyph atlas 等の次段が必要。
 - 動的自由 HTML は OSR または事前ベイクが必要。
-- Windows / Linux は launcher tier 1 / 2 があれば `--engine gpu` 明示で利用できる。`auto` の GPU 候補は
-  macOS のみとし、Windows の既定切替は実機実測後の別契約で扱う。
+- Windows は launcher tier 1 / 2 があれば `auto` で適格時に GPU、不適格時に OSR を使う。Linux は
+  `--engine gpu` 明示時だけ GPU を利用でき、`auto` は legacy を維持する。
 - 長尺の区間並列、複数 process 並列は非対応。
 - ~~インストール済みデスクトップアプリ経由（launcher tier 1）の GPU 書き出しは未配線~~ **2026-08-29 解消**: shell の `electron-entry.js` が `--akari-main packages/gpu-export/src/electron-main.mjs` を受け、`buildElectronArguments` が tier 1 にそれを渡す（osr 契約 §6）。`resolveGpuLauncher` の fail-closed（allowDesktop 既定 false）は v0.1.28 で解除。以下は v0.1.26〜v0.1.27 の記録: （v0.1.25 で判明）。shell の `--render` は OSR ランタイムしか読まず、`buildElectronArguments` は tier 2 にしか mainScript を渡さない。v0.1.26 から `resolveGpuLauncher` は tier 1 を候補から外す（fail-closed）: `auto` は OSR へ（provenance に `engine_fallback` と理由）、`--engine gpu` 明示は拒否。tier 1 の配線（shell contribution に GPU ランタイム選択を足す）は別票。
 
@@ -205,7 +221,7 @@ OSR receipt と同じ warning/hard-stop 語彙を使う。`--engine osr` と `--
 | platform | `--engine gpu` | `--engine auto` | launcher |
 |---|---|---|---|
 | macOS | 明示利用可 | 適格なら GPU、不適格なら OSR | tier 1 / 2（ただし tier 1 は現状未配線で fail-closed） |
-| Windows | 明示利用可 | legacy のまま | tier 1 / 2（同上） |
+| Windows | 明示利用可 | 適格なら GPU、不適格なら OSR | tier 1 / 2（同上） |
 | Linux | 明示利用可 | legacy のまま | tier 1 / 2（同上） |
 
 npm Electron の tier 2 は `node_modules/electron/path.txt` を必須とする。値は win32 が
@@ -233,9 +249,17 @@ GPU 出口だけに `--enable-features=CanvasDrawElement`、`--disable-gpu-vsync
 - `perspective`、`preserve-3d`、`rotateX/Y/3d`、`matrix3d`、`translateZ/3d` のいずれかを含む
   CSS 3D transform。先行実験では `translateZ` 単独・`perspective` 単独は正しく転写できたため、
   将来はこの粒度まで緩和できる余地があるが、v1 では緩和しない。
+  **例外（2026-08-31・issue #34）**: Z 成分がリテラル 0 の `translateZ(0)` / `translate3d(x, y, 0)` は
+  2D の `translate` と描画結果が同一（実測: 静的スプライトで全コマ YMAX=0）なので検出しない。
+  Z が 0 以外、引数の個数が違う、Z が `var()` / `calc()` 等でリテラルとして読めない場合は従来どおり `degraded`。
+  引数の切り出しは括弧の入れ子を数えるので、`translate3d(var(--x), calc(1px + 2px), 0)` のように X / Y が
+  CSS 変数・calc 駆動でも Z のリテラル 0 を読める（オーバーレイ規約は調整値を CSS 変数に出すため自然に現れる形）。
 - `requestAnimationFrame`、`setTimeout`、`setInterval`、`Date.now`、`performance.now` で自走する時計。
 - `video`、`audio`、canvas/宣言型 3D 以外の runtime、JSON 以外の script。
-- 絶対 URL と外部 font/image/background resource。
+- 絶対 URL と外部 font/image/background resource。`background(-image)` の `url(` 走査は宣言の区切り
+  （`;` `}`）に加えて引用符とタグ境界（`"` `'` `<` `>`）で止め、`url(#id)` の同一文書内フラグメント参照は
+  外部扱いしない（2026-08-31・issue #33。それまでは末尾に `;` の無いインライン style から後続 SVG の
+  `fill="url(#id)"` まで走査が届いて誤検出していた）。
 - `drawElementImage` が利用できない実行環境、または device pixel ratio が 1 でない環境。
 
 settle は mount 時に一度だけ決める。`canvas.requestPaint` がある Chromium では rAF 2 回の後に
@@ -272,11 +296,36 @@ OSR より遅く、同じ題材から字幕を外した実測は GPU 19.2 ms/コ
 +23.4 ms/コマから +1.65 ms/コマへ縮小した。毎コマの字幕描画費用という限界は解消し、実素材
 `akari-video-pv`（5,999 コマ）では GPU / OSR 7.2〜8.2 倍へ到達した。
 
-残る字幕差は毎コマの合成費用ではなく、cue 採寸と SVG ラスタの起動費用である。実素材 PV の字幕ありは
+（2026-08-29 #120f 時点の記述）残る字幕差は毎コマの合成費用ではなく、cue 採寸と SVG ラスタの起動費用である。実素材 PV の字幕ありは
 150.7 秒（25.1 ms/コマ）、字幕なし対照は 88.0 秒（14.7 ms/コマ）で 1.71 倍だった。30 cue の
 `akari-project/dynamic` では字幕ラスタが約 47 秒から 9.95 秒へ短縮したが、30 秒級の短い題材では
 起動費用の比率が大きく、GPU / OSR は 1.07〜1.14 倍にとどまる。
 
+2026-08-30 の #120h では、実素材 `akari-video-pv`（5,999 コマ・44 cue・88 band / 6 batch）の
+receipt `gpu.captionStartup` をラッパーが 5 走実測した。#120f 時点で約 63 秒だった字幕の起動費用
+（SVG ラスタ 20.5〜21.3 秒 + cue 採寸 88 variant）は、`captionStartup.totalMs` 2.75〜5.01 秒と
+`captionRasterTotalMs` 5.90〜7.34 秒、合計 **8.7〜12.3 秒**になった。代表する 1 走の内訳は、
+フォントの base64 符号化 0.66 秒（符号化後 13.6 MB・走に 1 回だけ）、cue 採寸 1.54 秒
+（88 stable call / 176 pass / 264 variant・うちフォント待ち 0.75 秒・レイアウト 0.073 秒）、
+SVG ラスタ 5.90 秒（SVG 組み立て 0.046 秒、data URL 割り当て 0.52 秒、decode 2.80 秒、
+中間 sheet への描画 1.72 秒、band の blit 0.11 秒、テクスチャ登録 0.004 秒）である。
+
+frame loop 中の `stages.captionRasterBatch` は **0 回**で、6 バッチすべてが書き出し開始前に焼き終わる。
+frame loop の `stages.captions` は p50 0 ms / p95 0.1 ms である。採寸の使い回しは cue の内容
+（出力寸法・CSS 変数・cue の HTML・unit index・CSS 変種列）が完全に一致したときだけ効く。PV の
+44 cue は本文がすべて異なるため `reusedStableCalls` は 0 で、88 stable call は 88 distinct key の
+ままである。同じ本文を共有する 3 cue の fixture では、6 stable call のうち 4 が使い回され、
+distinct key は 2 へ落ちる。採寸が 32 回で収束しない unit は、その unit だけ sprite へ降格し、
+receipt の `gpu.captions[].mode = "sprite"` と warning に出して書き出しは完走する（fail-closed にしない）。
+
+速度の絶対値は 2026-08-30 の測定では取れていない。1 分 load < 20 の静かな窓を 40 分 × 3 回待っても
+来ず、観測した最小 load は 52 だった。PV は load 77〜421 の下で 250.6〜687.4 秒、同じ高負荷下の
+字幕なし対照は 220.4〜785.4 秒で、字幕ありとの差は走ごとの 3 倍以上の load 変動に埋もれ、対照より
+速い走もあった。したがって、静かな窓での「PV ≤ 110 秒」「dynamic ≥ 2×（OSR 比）」は未検証である。
+参考値として、高負荷下の `akari-project/dynamic` は GPU 71.1〜80.7 秒 / OSR 93.6〜97.8 秒
+（1.2〜1.3 倍）で、#120f 時点の 1.07〜1.14 倍からは改善している。RSS の上限は 531〜914 MB
+（1 GB 以内）、`--trap-readback` の読み戻しは 0 だった。
+
 ## 10. v3 — 宣言型 3D の登場曲線
 
 v3 は、宣言型 Three.js scene のルート要素にある 1 回きりの登場 CSS animation を時刻の関数へ解析し、
@@ -332,3 +381,100 @@ value    = from + (to - from) * eased
 `getComputedStyle` と delay 前・登場中 3 点・終了後の 5 時刻で突き合わせた実測差は、translate 最大
 0.00043 px、scale 最大 0.000001、opacity 0 だった。検収閾値は translate 0.5 px 以下、opacity 0.005
 以下、3D 登場区間の GPU / OSR 外接矩形内 MAD 1.0 以下とする。
+
+## 11. v2 の cut 音声中間物（2026-08-29 追記）
+
+GPU 経路の映像は `edit.sources` をページ側で直接読み、`cut.mp4` の映像を使用しない。そのため
+cut 段は `cut-audio.mp4`、尺延長が必要な場合は続けて `cut-audio-tail-padded.mp4` を生成し、
+音声ストリームだけを最終 mux へ渡す。両コマンドは `-vn` とし、映像のデコード・フィルタ・
+エンコードを行わない。音声の trim、速度、freeze 無音、transition、gap、AAC 48 kHz の意味論は
+従来の映像込み cut / tail-pad と同じである。legacy 経路は従来どおり映像込み中間物を使用する。
+音声入力は cut ごとに入力側シーク（`-ss` / `-t`）し、cut 頭 0.5 s の先読みガード（AAC の overlap-add 用）を設け、cut 段の費用を素材長に依存させない。
+
+## 12. 採寸不安定の根治・実行時フォールバック・生フレーム dump（2026-08-30 追記）
+
+### 12.1 事実（2026-08-30・capture-v2-engine レーンの実測と司令塔のコード確認）
+
+- 内部 fieldtest 案件（11 秒・1080p・字幕 **3 cue・`words[]` 無し・style 無指定**・HTML オーバーレイ 2・LUT）で、
+  §2.1 の採寸が **32 回で収束せず `caption-measure-unstable` で fail-closed** する。`6da9a353` 以前の main でも同じ地点で落ちる既存不良。
+  いちばん単純な字幕でも起こるため、原因は karaoke / pop の語矩形ではなく採寸の土台にある可能性が高い（未特定）
+- `render-cut.mjs` は `exportWithGpu` の**実行時失敗を捕捉しない**。`engine_fallback` が発火するのは launcher tier 3（Electron 不在）だけで、
+  page runtime が fail-closed すると書き出し全体が失敗する。`--engine auto` は事前の適格判定で gpu を選ぶが、採寸の収束は実行時にしか
+  分からないため、適格判定では弾けない
+- `akari capture --engine auto` は書き出しと同じ関数でエンジンを解決する（capture 契約 §9.2）ので、同じ案件で同じ地点で落ちる。
+  `--engine osr` 明示なら通る
+- gpu 書き出しには、エンコーダへ渡す直前のフレームを取り出す機構が無い（読み戻しゼロの設計 §4）。osr には `--dump-frames`
+  （`raw/frame-N.bgra`）があり、capture 契約 §9.3 の可逆比較は osr でだけ成立している
+
+### 12.2 要求 A — 採寸不安定の原因特定と決定論化
+
+- 収束しなかった試行について、**どの cue のどの値がどれだけ揺れたか**（variant / token / rect の差分）を run.json と receipt に残す
+  （現状は attempts の count / p50 / max だけ）。原因は推測で決めず、この差分と再現案件で特定する
+- 特定した原因に対して決定論化の手を入れる。**許容差・平均・丸めで揺らぎを隠さない**（§2.1 の原則は不変）。
+  候補は実測で選ぶ: レイアウト確定の待ち方（`getBoundingClientRect` 1 回で足りているか・rAF / フォント metrics の遅延）、
+  root の挿入位置・サイズの固定、DPR / zoom の固定、など
+- 根治できた範囲と、できなかった条件（あれば）を契約に追記できる形で報告する
+
+### 12.3 要求 B — 実行時フォールバック（必須）
+
+- `--engine auto` で gpu の page runtime が **閉じた集合の理由コード**（v0 は `caption-measure-unstable` のみ）で fail-closed したとき、
+  render-cut は **osr で再実行**し、`provenance.engine_fallback = { from: "gpu", reason: "<reasonCode>" }` と gpu 側の失敗 run.json への
+  参照を receipt に残す。中間物は捨てて osr を最初から回す（部分再利用しない）
+- 明示 `--engine gpu` は従来どおり fail-closed（理由を表示して exit ≠ 0）。フォールバックは `auto` だけ
+- `akari capture --engine auto` も同じ関数・同じ理由コード集合でフォールバックし、`capture.json.engine.fallback` に記録する
+- フォールバック対象外の失敗（デコード不可・Electron クラッシュ等）は従来どおり失敗のまま。集合を広げるときは本契約に追記する
+
+### 12.4 要求 C — gpu 書き出しの生フレーム dump（検証専用）
+
+- `--dump-frames <n,...>` を gpu 書き出しに追加。エンコーダへ渡す直前の `finalCanvas` を読み戻して `raw/frame-N.rgba`（8bit・行順は
+  osr の dump と同じ規約で明記）に書く。osr の `--dump-frames` と引数・出力先の形を揃える
+- **フラグ無しの製品経路は読み戻しゼロを維持**（`assert-zero-readback` の静的監査と `--trap-readback` の両方が引き続き通ること）。
+  dump は `--verify-frames` と同じ検証専用の枠に置く
+- capture 契約 §9.3 の可逆比較を gpu でも成立させる: `capture --engine gpu -t N` の PNG ≡ `--dump-frames N` の raw（MAD 0）
+
+### 12.5 受け入れ
+
+- fieldtest 案件（複製）で `render-cut --engine auto` が**完走**する。根治できていれば gpu で、できていなければ osr へのフォールバックで。
+  receipt にどちらだったかと理由が残る。`capture --engine auto -t 0 3 6` も同様に完走
+- 収束しなかった試行の差分ログが run.json / receipt に出る（フィクスチャで再現できなければ、揺らぎを注入したユニットテストで形を固定）
+- `--dump-frames` で取った raw と `capture --engine gpu` の PNG が bit 一致（MAD 0・3 フレーム）
+- フォールバックが発火しない既存フィクスチャの mp4 SHA は不変。`assert-zero-readback` PASS・`--trap-readback` 完走
+- 明示 `--engine gpu` の fail-closed 挙動と exit code は不変（テストで固定）
+
+### 12.6 実装レーンの実測による追記（2026-08-30・検収後）
+
+- **原因（確定）**: `captions.mjs` の `.akari-caption__plate` に付く entrance fade（`akari-caption-fade 180ms ease-out`・
+  `translateY(0.18em → 0)` = 既定 38 px で 6.84 px）を、ラスタ側は `settleCss` で停止していたが**採寸 root には当てていなかった**
+  （`CAPTION_WORD_FREEZE_CSS` が止めるのは語単位の 6 セレクタのみ）。採寸は生きている transform を任意時点でサンプルしていたため、
+  `ease-out` 終端の 0〜0.5 px の残差が毎回違い、許容差ゼロの連続 2 回一致が 32 回でも成立しなかった。#120c r0 の「語矩形 y が
+  最大 1.71 px 揺れる」も同じ現象。差分ログの実測: 31 対すべて不一致・揺れたフィールドは `plate.y/bottom` `line[0].y/bottom` の 4 つだけ・
+  試行 1→2 で −6.33〜−6.43 px（= 0.18em）
+- **原則（§2.1 に追加）**: **採寸 root に適用する CSS は、ラスタ band に適用する CSS と同一集合でなければならない**
+  （採寸 = ラスタされる幾何、を構成上保証する）。実装は `measureCss = CAPTION_WORD_FREEZE_CSS + settleCss` で採寸・probe・両 variant を揃え、
+  静的テスト「caption measurement roots are frozen in the same settled state the raster uses」で固定。許容差・丸め・平均は入れていない
+- **根治の実測**: fieldtest 案件で `captionMeasureAttempts = {count 3, p50 2, max 2}`（理論下限）・diffs 0・`captionLayoutMaxDeltaPx` 0・
+  gpu 2 走 mp4 SHA 一致。§12.1 の「32 回で収束せず」は正確には**高確率で**（base では確率的に収束することもある）
+- **32 回の上限**は据え置く。根治後は 2 回で確定するため上限は実質保険。下げるなら揺らぎが残る条件を別途観測してから
+- **`--dump-frames` の形**: 行順は上から下で osr と同規約。チャネル順はエンジンが本来読み戻す形式のまま（gpu = RGBA `raw/frame-N.rgba` /
+  osr = BGRA `raw/frame-N.bgra`）で拡張子が表す。`--trap-readback` とは相互排他
+- **receipt / provenance のキー**: フォールバック時は `provenance.engine = "osr"`・`engine_fallback = { from: "gpu", reason }`・
+  **`provenance.gpu_failure_run`**（gpu 失敗 run.json のプロジェクト相対パス）。capture は `capture.json.engine.fallback` に同じ内容
+- **capture の parity ガード**: render-cut がフォールバックした receipt（`provenance.engine = "osr"`）に対し、capture 側の解決が `"gpu"` でも
+  `engine_fallback.from` が一致すれば parity として受ける（これが無いと capture がフォールバックに到達する前に落ちる。launcher tier 3 由来の
+  既存フォールバックにも同じ穴があり同時に塞いだ）
+- 判定は構造化された `error.reasonCode` だけを見る（メッセージ文字列一致では発火しない）
+
+### 12.7 §9（#120h の「降格して完走」）との関係 — 司令塔裁定（2026-08-30・r3 合流時）
+
+- **事実**: #120h（§9 追記）は採寸が収束しない unit を **sprite へ降格して書き出しを完走**させる（語アニメが落ちる・receipt の
+  `captionStartup.measure.degradedUnits` に計上）。§12.3 は「`auto` は osr へフォールバック / 明示 `gpu` は fail-closed」を要求する。
+  r3 の合流はこれを **「実測由来の不安定 = 降格（§9）/ 故障注入 `AKARI_GPU_CAPTION_MEASURE_FAULT` = `caption-measure-unstable` を伝播
+  → `auto` は osr フォールバック・明示 `gpu` は fail-closed（§12.3）」** に分けて両方を残した。注入は「復旧不能な採寸失敗の代役」であり、
+  降格経路を撃つスイッチではなくなった
+- **裁定（v0）**: この分離を**採る**。根治（§12.6）により実測由来の不安定は理論下限 2 回で収束しており、降格経路は保険。
+  降格が起きたときは warning と `degradedUnits` で**黙らずに**記録される（§2.1「揺らぎを隠さない」に反しない）
+- **次版の候補（別票 D・小）**: `auto` で `degradedUnits > 0` になった走は「近似で完走」より「osr で正確に完走」を選ぶべきかを裁定し、
+  採るなら降格を `FALLBACK_REASONS` 相当（例 `caption-measure-degraded`）として `auto` だけ osr へ回す。明示 `gpu` は降格 + warning のまま。
+  降格経路を実機で撃つための注入モード（例: 値の接尾辞で降格を選ぶ）も同票で
+- 採寸 settle の実装は #120h の **`.akari-measure-root` にスコープした `measureSettleCss`** に一本化（§12.6 の原則を満たし、ページ全体の
+  アニメは止めない）。`contentKey` で再利用される安定結果は `cssVariants` を鍵に含むため必ず settled 状態で測ったもの（実機確認済み）

package/vendor/docs/contract-2026-08-28-osr-export-v0.md

@@ -10,7 +10,7 @@
 | platform | `auto` の解決 | 備考 |
 |---|---|---|
 | darwin | `osr` | v2 を既定とする |
-| win32 | `legacy` | Windows 実機実測 #14 が完了するまで OSR は opt-in |
+| win32 | 適格なら `gpu`、不適格なら `osr` | GPU / OSR launcher が利用不能なら順に `legacy` へフォールバック |
 | linux | `legacy` | OSR は opt-in |
 
 `.akari/render.json` の provenance は、指定値を `engine_requested`、解決後の実走値を `engine` に
@@ -166,6 +166,20 @@ v0.1.27 からの挙動: `resolveOsrLauncher`（製品入口）はインスト
 
 **2026-08-29 追記（根治）**: 書き出し専用の入口 `apps/shell/electron-entry.js` が合流した（§6 / §11.4）。`resolveOsrLauncher` の既定を戻し、インストール済みアプリを再び tier 1 の候補にする（v0.1.28〜）。`allowInstalledDesktop: false` は明示の opt-out として残す。
 
+### 11.6 親の `ELECTRON_RUN_AS_NODE` が Electron 子プロセスへ継承される（2026-08-29 追記・#27）
+
+v0.1.28 実機（macOS Apple Silicon / Windows RTX 5060）で実証: shell 配布の `akari` shim
+（`ELECTRON_RUN_AS_NODE=1 exec <同梱 Electron> akari.mjs`）・アプリ内書き出し・パートナー CLI サーバーは、同梱 Electron を
+node として使うためにこの変数を立てる。`launchElectronExport` が親の環境をそのまま子へ渡していたため、tier 1 の AKARI Video は
+Chromium スイッチを `bad option` で拒否して exit 9、tier 2 の npm Electron は `electron-main.mjs` を素の Node で実行して
+`app` が undefined になり、いずれも PROGRESS 0 行で終わる。GPU 出口（§12）も同じ launcher を共有するため同時に落ちる。
+§11.4 / §11.5 の解消後に露出した、起動環境の問題。
+
+修正後: `spawnAndWait` は `electronChildEnvironment(env)` を通した環境で起動する
+（`ELECTRON_CHILD_ENV_BLOCKLIST = ["ELECTRON_RUN_AS_NODE"]`、名前は Windows に合わせ大文字小文字非区別で比較）。
+他の変数（`AKARI_OSR_*` / `AKARI_FFMPEG_BIN` / `PATH` 等）は従来どおり継承する。shim 側で変数を外す案は採らない
+（shim の外で立てられた変数には効かず、書き出し側で一律に守るのが唯一の境界）。
+
 ## 12. GPU 直結出口との共有境界（2026-08-28 追記）
 
 [GPU 直結書き出し v0](./contract-2026-08-28-gpu-export-v0.md) は、本契約の launcher 3 段、static
@@ -174,3 +188,12 @@ server、page builder の入力解決、memory guard、ffprobe、音声 mux、re
 mux、fail-closed 条件は GPU 契約を正本とし、OSR の seek/paint/stamp 経路へ逆流させない。
 §1 の darwin `auto → osr` は GPU 出口追加前の記述であり、GPU 契約の適格性を満たさない場合、
 または GPU launcher が利用できない場合の選択として読む。適格時の `auto → gpu` は GPU 契約を優先する。
+
+## 13. v2 の cut 音声中間物（2026-08-29 追記）
+
+OSR 経路の映像は `edit.sources` をページ側で直接読み、`cut.mp4` の映像を使用しない。そのため
+cut 段は `cut-audio.mp4`、尺延長が必要な場合は続けて `cut-audio-tail-padded.mp4` を生成し、
+音声ストリームだけを最終 mux へ渡す。両コマンドは `-vn` とし、映像のデコード・フィルタ・
+エンコードを行わない。音声の trim、速度、freeze 無音、transition、gap、AAC 48 kHz の意味論は
+従来の映像込み cut / tail-pad と同じである。legacy 経路は従来どおり映像込み中間物を使用する。
+音声入力は cut ごとに入力側シーク（`-ss` / `-t`）し、cut 頭 0.5 s の先読みガード（AAC の overlap-add 用）を設け、cut 段の費用を素材長に依存させない。

package/vendor/docs/contract-2026-08-28-v2-audio-roles-v0.md

@@ -140,3 +140,23 @@ ms へ換算し、絶対値で集計する。全 59 点の最大は 16.667 ms、
 `atempo` チェーンから決まり、同じ入力は再生成しない。生成またはデコードに失敗した項目だけは
 警告を 1 行出して従来の `playbackRate` 経路へ退避し、映像および他の音声のプレビューを止めない。
 したがって §5 の「残す近似」に速度変更した台詞のピッチ差は含めない。
+
+## 8. プレビュー音声サイドカーと先読み（§7 の更新）
+
+§7 の WAV は廃止し、撮影素材の台詞は速度にかかわらず、使用区間だけを 48 kHz・元チャンネル数の
+FLAC（compression level 5）へ一度だけ切り出す。`transition_out` 境界では前後のハンドルも同じ
+サイドカーへ含め、プレビュー予定表は ffmpeg `acrossfade` の既定
+`c1=tri:c2=tri` と同じ線形ゲインで重ねる。したがって「台詞の供給元」と
+「トランジション区間の音」は §2 / §5 の近似対象に含めない。
+
+生成先は案件内の `.akari/cache/preview-audio/` とする。ファイル名は
+`sha1(sourcePath|size|mtime|in|out|speed|padBefore|padAfter|recipe)` で、recipe は
+`preview-audio-flac-v1`。同じキーは再生成せず、予定表を作るたびに現在使うキー集合を正として、
+集合に無い FLAC と旧 `.akari/cache/speech-atempo/*.wav` を掃除する。生成失敗時だけ元ファイルへ
+退避し、台詞の元ファイルが 64 MB 以上ならレンダラへ全体を載せず、その項目を警告 1 行で省く。
+
+BGM / SFX / narration は、元ファイルが WAV かつ 8 MB 超のとき同じ FLAC サイドカーを使う。
+frame-engine は映像の ready を先に成立させ、その直後から予定表上の初回使用時刻順・同時 2 本で
+全音声を非同期にデコードする。デコード済み PCM は合計バイトで管理し、既定上限は 256 MB。
+上限超過時は次に使う時刻が最も遠い項目から退避する。再生開始は先読み済みの項目を再利用し、
+未着の項目だけを待つため、先読み処理は初期フレームの描画を止めない。