akari-video 0.1.14 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "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/vendor/.akari-capability-sources.json

@@ -40,6 +40,7 @@
     "docs/contract-2026-08-13-avatar-drive-v0.md",
     "docs/contract-2026-08-14-avatar-vrm-v0.md",
     "docs/contract-2026-08-18-v1-render-parity.md",
+    "docs/contract-2026-08-23-captions-emphasis-words-v0.md",
     "docs/contract-2026-08-23-stroke-persistence.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",

package/vendor/docs/contract-2026-07-17-data-contract-versioning.md

@@ -97,3 +97,11 @@ edit.json の `version` は変わらないし、edit.json が `version: 1` に
 task `2026-08-20-v2-audio-tracks` に限り、「機能追加禁止・バグ修正のみ」の明示承認済み・1 回限りの例外として、v0/v1 の `audio.sfx[]`・`audio.narration[]`・`audio.bgm` を v2 の audio lane `tracks[].items[]` へ移す変換を追加した。出力側の `at` / `duration` は整数フレームへ確定し、素材側の `in` / `out` と fade / `bgm.in` は秒のまま保持する。実尺が旧形式だけでは決まらない音声は `duration: 0` センチネルとし、この変換器では ffprobe しない。トップレベル `audio` は `master` が宣言されている場合だけ残す。
 
 これは凍結前に許可された最後の機能追加である。今後この変換器へさらに変換能力を足さず、§6 の期限どおり本体から分離・削除する。
+
+### 6.2 filter レイヤー転写と emphasis_words 移送（2026-08-23・1 回限りの例外）
+
+task `2026-08-23-migrate-filter-emphasis-exception` に限り、2026-08-23 オーナー裁定による「機能追加禁止・バグ修正のみ」の明示承認済み・1 回限りの例外として、v0/v1 の独立した `kind: "filter"` レイヤーを v2 の filter source へ転写し、トップレベル `emphasis_words[]` を edit.json v2 から除外して object ルートの `captions.json.emphasis_words[]` へ移送する変換を追加した。media 系レイヤー（`video` / `baked`）に直付けされた `filter` は v2 に等価表現が無いため転写対象外とし、理由付きで変換を停止する。移送時は edit.json と captions.json の原文をそれぞれ退避し、1 手の revert で両方を復元する。移送先が無い、配列ルートである、または既に `emphasis_words` を持つ場合は理由付きで停止する。
+
+2026-08-21 の廃止裁定は fieldtest 60 本を母集団とし、本番リールでの使用が調査圏外だったという母集団瑕疵があったため、本例外で既存データを損失なく移す。
+
+これ以後この変換器へさらに変換能力を足さず、§6 の期限どおり本体から分離・削除する。

package/vendor/docs/contract-2026-08-23-captions-emphasis-words-v0.md

@@ -0,0 +1,76 @@
+# captions.json v0 語レベル演出（emphasis_words）データ契約
+
+- 日付: 2026-08-23
+- 状態: 実装ラウンドの SSOT（`captions.json` の席と優先順を確定）
+- 前提: [edit.json v1 語レベル演出契約](contract-2026-07-23-edit-json-v1-emphasis-words.md)
+- スコープ: `captions.json` の object ルートに置くトップレベル任意フィールド
+  `emphasis_words[]` と、旧 `edit.json` 席との読取優先順
+
+## 背景
+
+字幕表示に属する語レベル演出は、編集タイムラインではなく字幕の SSOT である `captions.json` 側へ置く。
+`edit.json` v2 から `emphasis_words` を廃止した 2026-08-21 裁定は維持し、v2 の exact-keys に席を
+戻さない。一方、その裁定の根拠だった fieldtest 60 本の使用 0 件は母集団外の本番リールを含んでおらず、
+本番リールでは 15 語が実際に使用されていたため、「語レベル演出自体が不要」という根拠は訂正する。
+
+## 1. 席
+
+`captions.json` が object ルートのときだけ、トップレベルに `emphasis_words[]` を任意で置ける。
+
+```jsonc
+{
+  "emphasis_words": [
+    {
+      "id": "e-0001",
+      "src": "main",
+      "t_start": 12.08,
+      "t_end": 12.44,
+      "word": "最高",
+      "emotion": "joy",
+      "style_hint": "size-pulse"
+    }
+  ],
+  "captions": [ /* 既存のまま */ ]
+}
+```
+
+従来の配列ルート（`[{ ...caption... }]`）にはトップレベルのフィールドを置けないため、
+`emphasis_words[]` の席はない。語レベル演出を書く場合は object ルートへ移し、既存配列を
+`captions[]` に包む。
+
+## 2. レコード契約と差分
+
+レコード形、フィールド語彙、source 秒アンカー、実測 word-level タイムスタンプを写す規律、
+選定規律、劣化規約はすべて
+[edit.json v1 語レベル演出契約](contract-2026-07-23-edit-json-v1-emphasis-words.md) と同じである。
+本契約が定める差分は次の 2 点だけである。
+
+1. 配列の置き場を `edit.json.emphasis_words` から、object ルートの
+   `captions.json.emphasis_words` へ移す。
+2. `edit.json` v2 へは書かない。v0/v1 の旧席は後方互換の読取専用として残す。
+
+したがって各レコードは `{ id, word, emotion, src?, t_start, t_end, style_hint? }` で、`id` は
+`^e-\d{4}$` かつファイル内一意、`word` と `emotion` は空でない文字列、時刻は source 秒で
+`0 <= t_start < t_end` とする。`emotion` は `joy` / `pain` / `surprise` / `anger` / `sadness` /
+`emphasis` を標準語彙として使うが、v1 契約どおり enum 強制はしない。`style_hint` も描画側への
+提案に留まる。
+
+## 3. 読取優先順
+
+消費側は次の優先順で 1 つの席だけを読む。
+
+1. object ルートの `captions.json` に `emphasis_words` キーが在れば、その値を採用する。
+2. キーが無ければ、v0/v1 の `edit.json.emphasis_words` を後方互換として読む。
+3. どちらにも無ければ語レベル演出なしとする。
+
+両方の席が在る場合もマージしない。`captions.json` 側だけを採用し、警告は出さない。これにより
+新しい字幕 SSOT が常に優先される一方、`captions.json` に席を持たない既存 v0/v1 プロジェクトは
+従来どおり `edit.json` 側だけで描画され、回帰しない。
+
+## 4. 検証責務
+
+`captions.schema.json` は object ルートだけに任意の `emphasis_words[]` を定義し、要素の必須項目、
+型、`id` 形式、非負時刻、非空の `word` / `emotion` を検査する。JSON Schema 標準では兄弟値を
+比較できない `t_end > t_start` と、配列内の `id` 一意性は `validate-captions.mjs` が検査する。
+語と `captions[].words[]` の実測値の突き合わせは v1 契約と同じく書き手の規律であり、静的検証では
+行わない。

package/vendor/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "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 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Run them from a full AKARI Video app installation (normally ~/.akari/app) or a monorepo checkout.]",
   "type": "module",
   "files": [

package/vendor/packages/edit-lint/src/edit-lint.mjs

@@ -254,6 +254,7 @@ export async function lintProject(input, options = {}) {
   validateCutTransformFields(edit.cuts, findings);
   validateStillImageCuts(edit, findings);
   const cutTrackSegments = computeCutTrackSegments(edit.cuts);
+  validateTransitionAdjacency(edit.cuts, cutTrackSegments, edit.fps, findings);
   for (const segment of findTrackOverlaps(cutTrackSegments)) {
     if (isDeclaredTransitionOverlap(edit.cuts, cutTrackSegments, segment, edit.fps)) continue;
     addFinding(findings, {
@@ -313,6 +314,28 @@ export async function lintProject(input, options = {}) {
   return writeResult(findings, skipped, inputs, paths, options);
 }
 
+function validateTransitionAdjacency(cuts, segments, fps, findings) {
+  for (let position = 0; position < segments.length; position += 1) {
+    const earlier = segments[position];
+    const transition = cuts?.[earlier.index]?.transition_out;
+    if (!isRecord(transition) || !isPositiveNumber(transition.duration)) continue;
+    const later = segments.slice(position + 1).find(candidate => candidate.track === earlier.track);
+    if (!later || later.start <= earlier.end) continue;
+    if (areCutsAdjacent(
+      { tlEnd: earlier.end, transitionOut: { duration: transition.duration } },
+      { tlStart: later.start },
+      fps,
+    )) continue;
+    addFinding(findings, {
+      severity: "error",
+      check: "cuts.transition-out.non-adjacent",
+      message: "transition_out の次のクリップとの間にすき間があります。すき間を詰めるか、トランジションを削除してください。",
+      path: `edit.json#cuts[${earlier.index}].transition_out`,
+      range: { start: earlier.end, end: later.start },
+    });
+  }
+}
+
 function projectAudioForLint(internalEdit) {
   const sfx = [];
   const narration = [];
@@ -1314,13 +1337,8 @@ export function validateTrackTransitionOutCompatibility(edit, findings) {
       severity: "error",
       check: "cuts.track-transition-unsupported",
       message:
-        `cuts[].transition_out is declared on track ${trackRef}, which timeline.tracks composites through the `
-        + `gap-aware track engine. That engine treats adjacent same-track cuts as separate, non-overlapping `
-        + `windows, so it cannot represent an xfade's intentional overlap -- the composited window and the `
-        + `actually-shrunk clip diverge, and content disappears early (verified with a real render: the base `
-        + `track's background visibly leaked through where the dissolved clip should still have been `
-        + `playing). Remove transition_out from this track's cuts, or drop the custom timeline.tracks order `
-        + `for this track so it renders through the plain sequential path instead.`,
+        `映像トラック ${trackRef} の transition_out は、PiP または複数トラックを合成する方式では書き出せません。`
+        + `トランジションを削除するか、映像を単一の cuts トラックへ戻してください。`,
       path: `edit.json#cuts[${cutIndex}]`,
     });
   }

package/vendor/packages/edit-store/lib/edit-store.d.ts

@@ -11,7 +11,7 @@ export interface EditCut {
     opacity?: number;
     speed?: number;
     transitionOut?: {
-        type: 'dissolve' | 'fade-black' | 'fade-white';
+        type: 'dissolve' | 'fade-black' | 'fade-white' | 'reveal-down' | 'reveal-up';
         duration: number;
     };
     at?: number;
@@ -140,7 +140,7 @@ export declare function updateCutTransformInSource(source: string, cutIndex: num
 }): string;
 export declare function updateCutOpacityInSource(source: string, cutIndex: number, opacity: number | null): string;
 export declare function setCutTransitionOutInSource(source: string, cutIndex: number, transitionOut: {
-    type: 'dissolve' | 'fade-black' | 'fade-white';
+    type: 'dissolve' | 'fade-black' | 'fade-white' | 'reveal-down' | 'reveal-up';
     duration: number;
 } | null): string;
 export declare function reorderCutsInSource(source: string, fromIndex: number, toIndex: number): string;

package/vendor/packages/edit-store/lib/edit-store.js

@@ -318,7 +318,9 @@ function updateCutOpacityInSource(source, cutIndex, opacity) {
 }
 function setCutTransitionOutInSource(source, cutIndex, transitionOut) {
     if (transitionOut !== null) {
-        if (transitionOut.type !== 'dissolve' && transitionOut.type !== 'fade-black' && transitionOut.type !== 'fade-white') {
+        if (transitionOut.type !== 'dissolve' && transitionOut.type !== 'fade-black'
+            && transitionOut.type !== 'fade-white' && transitionOut.type !== 'reveal-down'
+            && transitionOut.type !== 'reveal-up') {
             throw new Error('トランジションの種別が不正です。');
         }
         if (!Number.isFinite(transitionOut.duration) || transitionOut.duration <= 0) {

package/vendor/packages/edit-store/lib/index.d.ts

@@ -11,6 +11,7 @@ export * from './caption-display';
 export * from './edit-v2';
 export * from './edit-v2-item-write';
 export * from './internal-model';
+export * from './legacy-audio-view';
 export * from './retime';
 export * from './track-order';
 export * from './track-transition-compatibility';

package/vendor/packages/edit-store/lib/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./caption-display"), exports);
 __exportStar(require("./edit-v2"), exports);
 __exportStar(require("./edit-v2-item-write"), exports);
 __exportStar(require("./internal-model"), exports);
+__exportStar(require("./legacy-audio-view"), exports);
 __exportStar(require("./retime"), exports);
 __exportStar(require("./track-order"), exports);
 __exportStar(require("./track-transition-compatibility"), exports);

package/vendor/packages/edit-store/lib/internal-model.js

@@ -121,8 +121,13 @@ function readV2Internal(raw) {
     // 推測（旧 mainVisualTrackId）自体を撤去した。media アイテムの旧種別は常に 'cuts'
     // （= layers 相当の見た目・機能も含めて描ける唯一の経路）。'layers' に残るのは、
     // まだ cuts 経路へ移していない機能（非 normal blend の合成時ブレンド演算・
-    // アニメーションする perspective）を宣言するアイテムだけ（needsLayersEngine 参照。
-    // これも段ではなくアイテム自身の宣言だけで決まる）。
+    // アニメーションする perspective）を宣言するアイテムと、cuts の構造では同時表示できない
+    // 時間重なりだけ（needsLayersEngine / computeOverlappingItemIds 参照）。
+    // cuts の winner-take-all 経路では、同一トラック内だけでなく別 visual トラック間の
+    // 同時表示も表現できない。先に全 visual media アイテムを横断して区間交差を求め、
+    // 参加したアイテムを各トラックの build へ同じ集合として渡す。これにより preview / render
+    // の両方が、トラックごとに独立した要素を合成できる layers 経路を選ぶ。
+    const overlappingItemIds = computeOverlappingItemIds(edit.tracks.flatMap(track => 'items' in track && track.lane === 'visual' ? [track.items] : []));
     const tracks = edit.tracks.map(track => {
         // P0 2026-08-21 render-path-unification (実測で発覚): 'cuts' 経路（concat チェーン）は
         // 同じトラック上の複数アイテムを「順番に連結される別セグメント」として扱う構造的前提を
@@ -140,8 +145,6 @@ function readV2Internal(raw) {
         // 倒れているのに track 自体は 'cuts' 名乗ったままになり、usesDefaultInternalTrackOrder が
         // 無関係に buildTrackStackPlan（実際には不要な余分なエンコード世代）へ倒れてしまう
         // （非回帰監査で実測: pip-perspective-crop-check が本来要らない track_stack を経由していた）。
-        const overlappingItemIds = 'items' in track && track.lane === 'visual'
-            ? computeOverlappingItemIds(track.items) : new Set();
         const kind = legacyKindOfV2Track(track, chromaKeyOf, overlappingItemIds);
         const ref = kind === 'captions' ? undefined : nextRef(refCounters, kind);
         const items = [];
@@ -206,13 +209,15 @@ function legacyKindOfV2Track(track, chromaKeyOf, overlappingItemIds) {
         // 'layers' は別カウンタなので、空トラックの存在が実クリップの分類・ref に影響しない
         // （P0 2026-08-20 track-identity-and-duration r1 で踏んだのと同じ罠）。
         default: return first === undefined
+            || track.items.some(item => overlappingItemIds.has(item.id))
             || needsLayersEngine(first, chromaKeyOf, overlappingItemIds.has(first.id))
             ? 'layers' : 'cuts';
     }
 }
 // P0 2026-08-21 render-path-unification: cuts 経路（packages/render-cut/src/cut-transform.mjs）へ
-// まだ移していない機能を宣言する media アイテムだけが 'layers' に残る。段（トラック）は一切見ない
-// — アイテム自身の宣言だけで決まるので、移動しても判定は変わらない。
+// まだ移していない機能を宣言する media アイテム、または computeOverlappingItemIds が
+// 同時表示のために指定した media アイテムだけが 'layers' に残る。機能判定自体は段を見ないが、
+// 重なり判定は宣言された時刻とトラックの z 関係を使う。
 // - blend: 'normal' 以外は合成時（前面までに何があるか）に依存するブレンド演算が要り、
 //   それは packages/render-cut/src/layers.mjs にしか実装が無い
 // - perspective keyframes: ffmpeg の perspective フィルタはフレームごとの式評価に対応しないため、
@@ -253,66 +258,60 @@ function needsLayersEngine(item, chromaKeyOf, hasOverlappingSibling = false) {
         return true;
     return false;
 }
-// P0 2026-08-21 render-path-unification: 'cuts' 経路は同一トラック上の複数アイテムを
-// 「順に連結される別セグメント」として扱えるだけで、時間的に重なる（同時に映る）複数アイテムは
-// 表現できない（buildMultiSourceCutCommand の concat 前提。needsLayersEngine 自身のコメント参照）。
-// このトラックの items[] を総当りで比較し、他のどれかと時間区間が重なる media アイテムの id を
-// 集める。
+// P0 2026-08-23 cuts-cross-track-overlap: 'cuts' 経路は同一トラック内の同時表示だけでなく、
+// 別トラック間の同時表示も winner-take-all になり、下段を描画できない。全 visual トラックの
+// items[] を総当りで比較し、半開区間 [at, at+duration) が正の長さで交差する media アイテムを
+// layers へ退避する。終端と開始が接するだけなら交差ではない。同一トラックの交差は両方を
+// layers へ送る。別トラックの交差は、下段を cuts の不透明な基底として残し、上段が全画面不透明
+// ではない宣言を持つときだけ layers へ送る。上段が全画面不透明なら winner-take-all でも同じ絵に
+// なるため、従来の cuts / track-stack 経路を保つ。
 //
-// r2（合流前ゲート検収 REJECT・実測 204/205 で発見）: 判定を「at/duration がわずかでも交差したら
-// 重なり」から「at と duration が完全一致（同一の開始・同一の尺 = 完全に同一の時間区間）」へ
-// 絞った。理由: apps/shell/extensions/akari-annotations の insertCutIntoEdit
-// （timeline-material-insert.ts）は sequential モードでの挿入時、**既存アイテムの at を
-// 再計算しない**という明示契約を持つ（同ファイル自身のコメント参照）。そのため、タイムライン
-// 中間へドラッグ挿入すると、新規挿入アイテムの at（挿入直前のアイテムの終端 = 挿入前は後続
-// アイテムの at と同じ位置）と、まだ古い at のままの後続アイテムが、同じ at で始まる**部分的な**
-// 重なりを起こす（例: 新規 at=120/duration=60 と、後続の古い at=120/duration=90 —
-// 実測: insertCutIntoEdit で cut-1[0,120) → cut-3[120,180) → cut-2[120,210) という配列になる）。
-// これは「本当に同時に映る PiP」ではなく、単に配列順で連結されるはずの 2 アイテムの片方の at が
-// まだ更新されていないだけ（insertCutIntoEdit の『at 不変・配列順が正』という契約どおりの、
-// 一時的に不正確な at）。v2 の at/duration はどちらも常に必須の整数フレーム値で、
-// 「宣言された絶対配置」と「まだ書き戻されていない sequential 連結」を区別する情報が
-// スキーマ上に残らないため、両者を汎用に見分けることはできない。一方、実際に 'layers' への
-// 退避が必要だと判明している唯一の実例（fieldtest/2026-08-06-pip-perspective-crop-check の
-// pip-crop-demo/pip-perspective-demo、いずれも at=0・duration=240 で完全同一区間）は、
-// 常に完全一致（同じ開始・同じ尺）のケースだった（このファイル自身の発見コメント・
-// packages/edit-store/test/internal-model.test.mjs の該当テスト名 "fully overlapping
-// at/duration" も参照）。完全一致のみを重なりとみなすことで、実証済みの本物の重なりは
-// 引き続き検出しつつ、insertCutIntoEdit の sequential 挿入という日常操作を誤検知しなくなる。
-function computeOverlappingItemIds(items) {
+// transition_out は同一トラックの隣接カットが意図的に作る狭い重なりで、cuts/xfade が表現する。
+// その例外は同一トラックのペアだけに適用する。別トラックとの交差は transition の有無にかかわらず
+// 真の同時表示なので layers へ退避する。
+function computeOverlappingItemIds(itemGroups) {
     const overlapping = new Set();
-    for (let i = 0; i < items.length; i++) {
-        const a = items[i];
+    const entries = itemGroups.flatMap((items, trackIndex) => items.map(item => ({ item, trackIndex })));
+    for (let i = 0; i < entries.length; i++) {
+        const { item: a, trackIndex: aTrackIndex } = entries[i];
         if (a.source.kind !== 'media')
             continue;
-        for (let j = i + 1; j < items.length; j++) {
-            const b = items[j];
+        for (let j = i + 1; j < entries.length; j++) {
+            const { item: b, trackIndex: bTrackIndex } = entries[j];
             if (b.source.kind !== 'media')
                 continue;
-            // r3 (Codex re-review, MINOR): a zero-duration item is an empty interval that can
-            // never actually be visible on screen at the same instant as anything else, so two
-            // zero-duration items sharing the same `at` are not a genuine overlap -- require a
-            // positive duration too, or an empty-interval pair would be forced to 'layers' for
-            // no real reason.
-            if (a.at === b.at && a.duration === b.duration && a.duration > 0) {
-                // cuts[].transition_out (a crossfade into the next cut) is a DELIBERATE, narrow
-                // overlap between two otherwise-sequential same-track items -- the concat engine's
-                // own xfade support (packages/render-cut/src/plan.mjs) already represents this
-                // correctly, so it must not be caught by this "cuts can't represent overlap" rule
-                // (only a genuine simultaneous-PiP overlap, with no transition_out involved at
-                // all, structurally can't be represented by concat). Declaring transition_out on
-                // either item in an overlapping pair is enough to exclude it: a real simultaneous
-                // PiP overlay never declares transition_out (it has no "next clip" to transition
-                // into within the same track).
-                if (a.source.transition_out !== undefined || b.source.transition_out !== undefined)
-                    continue;
+            if (!(a.at < b.at + b.duration && b.at < a.at + a.duration))
+                continue;
+            const sameTrack = aTrackIndex === bTrackIndex;
+            if (sameTrack
+                && (a.source.transition_out !== undefined || b.source.transition_out !== undefined))
+                continue;
+            if (sameTrack) {
                 overlapping.add(a.id);
                 overlapping.add(b.id);
             }
+            else {
+                const upper = aTrackIndex > bTrackIndex ? a : b;
+                if (needsCrossTrackLayers(upper))
+                    overlapping.add(upper.id);
+            }
         }
     }
     return overlapping;
 }
+// cuts の winner-take-all が下段を隠してよいのは、上段が全画面を不透明に覆う場合だけ。
+// transform の単位元を明示しただけなら従来経路を維持する。crop / 半透明 / keyframes は、
+// 現在または途中フレームで下段が見える可能性があるため宣言の存在だけで layers へ退避する。
+function needsCrossTrackLayers(item) {
+    const transform = item.transform;
+    return (transform?.scale !== undefined && transform.scale !== 1)
+        || (transform?.x !== undefined && transform.x !== 0)
+        || (transform?.y !== undefined && transform.y !== 0)
+        || (transform?.rotate !== undefined && transform.rotate !== 0)
+        || item.crop !== undefined
+        || (item.opacity !== undefined && item.opacity < 1)
+        || item.keyframes !== undefined;
+}
 function nextRef(counters, kind) {
     const ref = counters.get(kind) ?? 0;
     counters.set(kind, ref + 1);

package/vendor/packages/edit-store/lib/legacy-audio-view.d.ts

@@ -0,0 +1,16 @@
+import type { InternalEdit } from './internal-model';
+export type LegacyAudioDeclaration = Record<string, unknown>;
+/**
+ * tracks-first の内部表現を、旧 audio 消費者が読む形へ射影したビュー。
+ * 生の edit.json.audio は参照せず、同じ宣言を二重に列挙しない。
+ */
+export interface LegacyAudioView {
+    bgm?: LegacyAudioDeclaration;
+    sfx: LegacyAudioDeclaration[];
+    narration: LegacyAudioDeclaration[];
+}
+/**
+ * 内部表現の audio item だけから legacy audio 形を組み立てる純関数。
+ * render-cut の互換射影と同じく legacy.index 順で処理し、bgm は単数として後勝ちにする。
+ */
+export declare function projectLegacyAudioView(internal: InternalEdit): LegacyAudioView;

package/vendor/packages/edit-store/lib/legacy-audio-view.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectLegacyAudioView = projectLegacyAudioView;
+/**
+ * 内部表現の audio item だけから legacy audio 形を組み立てる純関数。
+ * render-cut の互換射影と同じく legacy.index 順で処理し、bgm は単数として後勝ちにする。
+ */
+function projectLegacyAudioView(internal) {
+    const ordered = internal.tracks
+        .flatMap(track => track.items)
+        .filter(item => item.legacy.collection === 'sfx'
+        || item.legacy.collection === 'narration'
+        || item.legacy.collection === 'bgm')
+        .sort((left, right) => left.legacy.index - right.legacy.index);
+    const sfx = [];
+    const narration = [];
+    let bgm;
+    for (const item of ordered) {
+        if (item.legacy.value === undefined)
+            continue;
+        const declaration = projectAudioDeclaration(item);
+        switch (item.legacy.collection) {
+            case 'sfx':
+                sfx.push(declaration);
+                break;
+            case 'narration':
+                narration.push(declaration);
+                break;
+            case 'bgm':
+                bgm = declaration;
+                break;
+            default:
+                break;
+        }
+    }
+    return {
+        ...(bgm !== undefined ? { bgm } : {}),
+        sfx,
+        narration
+    };
+}
+// Internal legacy values use camelCase display fields. Legacy audio consumers retain the
+// historical JSON spelling for gain_db while declaration-only compatibility fields stay intact.
+function projectAudioDeclaration(item) {
+    const value = item.legacy.value;
+    if (item.source.kind === 'media' && item.source.sourceId === undefined && isRecord(item.declaration)) {
+        return {
+            ...item.declaration,
+            ...(value.gainDb !== undefined ? { gain_db: value.gainDb } : {})
+        };
+    }
+    return {
+        ...(isRecord(item.declaration) ? item.declaration : {}),
+        ...value,
+        ...(value.gainDb !== undefined ? { gain_db: value.gainDb } : {})
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}

package/vendor/packages/edit-store/lib/migrate/index.d.ts

@@ -33,6 +33,12 @@ export interface MigrationProposal {
     nextText: string;
     previousText: string;
     backupPath: string;
+    captions?: {
+        filePath: string;
+        nextText: string;
+        previousText: string;
+        backupPath: string;
+    };
 }
 export interface MigrationBlocked {
     ok: false;
@@ -47,7 +53,7 @@ export declare function planMigration(projectRoot: string, editPath: string, tex
     hasCaptions?: boolean;
     now?: Date;
 }): MigrationProposal | MigrationBlocked;
-/** 承認後のみ実行する。先に .akari/backup/ へ原文を退避し、次に atomic rename する。 */
+/** 承認後のみ実行する。先に全原文を .akari/backup/ へ退避し、次に atomic rename する。 */
 export declare function applyMigration(proposal: MigrationProposal): Promise<void>;
-/** 退避した原文を 1 手で edit.json へ戻す。backup 自体は監査記録として残す。 */
+/** 退避した原文を 1 手で edit.json / captions.json へ戻す。backup 自体は監査記録として残す。 */
 export declare function revertMigration(proposal: MigrationProposal): Promise<void>;