akari-video 0.1.11 → 0.1.12

package/bin/akari.mjs

@@ -10,6 +10,7 @@ import { runAcceptCommand } from '../src/accept-command.mjs';
 import { runCapabilityCommand } from '../src/capability-command.mjs';
 import { runStoreCommand } from '../src/store-command.mjs';
 import { runAssetsCommand } from '../src/assets-command.mjs';
+import { runMigrateCommand } from '../src/migrate-command.mjs';
 import { maybeApplyPendingUpdateOnLaunch, readOwnVersion } from '../src/update-check.mjs';
 import { describeCliHelp } from '../src/messages.mjs';
 
@@ -67,6 +68,7 @@ const invoke = (argv[0] === '--version' || argv[0] === '-v') ? printVersion()
   : argv[0] === 'capability' ? runCapabilityCommand(argv.slice(1))
   : argv[0] === 'store' ? runStoreCommand(argv.slice(1))
   : argv[0] === 'assets' ? runAssetsCommand(argv.slice(1))
+  : argv[0] === 'migrate' ? runMigrateCommand(argv.slice(1))
   : run(argv);
 
 const result = await invoke.catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "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": {
@@ -37,6 +37,6 @@
   "scripts": {
     "prepack": "node scripts/prepack.mjs",
     "postpack": "node scripts/prepack.mjs clean",
-    "test": "node --test test/*.mjs"
+    "test": "node --test --test-concurrency=1 test/*.mjs"
   }
 }

package/src/messages.mjs

@@ -224,6 +224,7 @@ export function describeCliHelp() {
     '  sounds                 公式音源ライブラリを一括ダウンロード（無料）',
     '  update                 更新を確認する',
     '  status                 接続状態を確認する',
+    '  migrate [dir]          古い edit.json を退避バックアップ付きで v2 へ変換',
     '',
     '開発者向け:',
     '  --opencode              Claude Code の代わりに opencode を起動する',

package/src/migrate-command.mjs

@@ -0,0 +1,127 @@
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+
+const require = createRequire(import.meta.url);
+
+export async function runMigrateCommand(args, options = {}) {
+  const log = options.log ?? ((line) => console.log(line));
+  const error = options.error ?? ((line) => console.error(line));
+  const cwd = options.cwd ?? process.cwd();
+  const parsed = parseArguments(args, cwd);
+  if (!parsed.ok) {
+    error(parsed.message);
+    return { exitCode: 2 };
+  }
+  if (parsed.help) {
+    for (const line of migrateHelp()) log(line);
+    return { exitCode: 0 };
+  }
+  const projectRoot = parsed.projectRoot;
+  const editPath = path.join(projectRoot, 'edit.json');
+  let text;
+  try {
+    text = await (options.readFile ?? readFile)(editPath, 'utf8');
+  } catch (cause) {
+    error(`edit.json を読めません: ${editPath} (${messageOf(cause)})`);
+    return { exitCode: 2 };
+  }
+  const migrate = options.migrate ?? loadMigrateModule(options.assets ?? resolveLauncherAssets());
+  const proposal = migrate.planMigration(projectRoot, editPath, text, { now: options.now });
+  if (proposal.ok === false) {
+    if (parsed.json) {
+      log(JSON.stringify({ ok: false, error: 'このプロジェクトは変換できません', blockers: proposal.blockers }));
+    } else {
+      error('このプロジェクトは変換できません。');
+      for (const blocker of proposal.blockers) error(`- ${blocker}`);
+    }
+    return { exitCode: 2 };
+  }
+  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)`);
+    for (const change of proposal.changes) log(`- ${change.path}: ${change.note}`);
+    log(`変換前の退避先: ${proposal.backupPath}`);
+  }
+  if (parsed.dryRun) {
+    if (!parsed.json) log('--dry-run のため、ファイルは変更しません。');
+    return { exitCode: 0, proposal };
+  }
+  if (!parsed.yes) {
+    const isTTY = options.isTTY ?? (process.stdin.isTTY && process.stdout.isTTY);
+    if (!isTTY) {
+      error('非 TTY では明示承認が必要です。内容を確認し、--yes を付けて再実行してください。');
+      return { exitCode: 2, proposal };
+    }
+    const accepted = options.confirm
+      ? await options.confirm()
+      : await promptForConfirmation();
+    if (!accepted) {
+      if (!parsed.json) log('変換しませんでした。edit.json は変更されていません。');
+      return { exitCode: 0, proposal };
+    }
+  }
+  await migrate.applyMigration(proposal);
+  if (!parsed.json) log(`version 2 へ変換しました。元ファイル: ${proposal.backupPath}`);
+  return { exitCode: 0, proposal };
+}
+
+function loadMigrateModule(assets) {
+  const modulePath = path.join(assets.repoRoot, 'packages', 'edit-store', 'lib', 'migrate', 'index.js');
+  try {
+    return require(modulePath);
+  } catch (cause) {
+    throw new Error(`変換器を読み込めません: ${modulePath} (${messageOf(cause)})`);
+  }
+}
+
+function parseArguments(args, cwd) {
+  const flags = new Set(args.filter(value => value.startsWith('-')));
+  const unknown = [...flags].filter(value => !['--yes', '-y', '--dry-run', '--json', '--help', '-h'].includes(value));
+  if (unknown.length > 0) return { ok: false, message: `未知のオプションです: ${unknown.join(', ')}` };
+  const positional = args.filter(value => !value.startsWith('-'));
+  if (positional.length > 1) return { ok: false, message: '引数のプロジェクトディレクトリは 1 つだけ指定できます。' };
+  return {
+    ok: true,
+    help: flags.has('--help') || flags.has('-h'),
+    yes: flags.has('--yes') || flags.has('-y'),
+    dryRun: flags.has('--dry-run'),
+    json: flags.has('--json'),
+    projectRoot: path.resolve(cwd, positional[0] ?? '.')
+  };
+}
+
+async function promptForConfirmation() {
+  const readline = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await readline.question('上記の内容で version 2 へ変換しますか? [y/N] ');
+    return /^(?:y|yes)$/iu.test(answer.trim());
+  } finally {
+    readline.close();
+  }
+}
+
+export function migrateHelp() {
+  return [
+    '使い方: akari migrate [dir] [--yes] [--dry-run] [--json]',
+    '',
+    'v0/v1 の edit.json を v2 へ片道変換します。',
+    '既定は変更内容を表示して y/n で確認し、変換前の全文を .akari/backup/ へ退避します。',
+    '',
+    '  --yes, -y   表示後の確認を省略',
+    '  --dry-run   提案の表示だけで書き込まない',
+    '  --json      機械可読な JSON を出力',
+    '  --help, -h  このヘルプを表示'
+  ];
+}
+
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}

package/src/status-core/status.mjs

@@ -7,6 +7,7 @@ import { resolveProjectDisplayName } from "./display-name.mjs";
 import { inspectFullIntegrity } from "./integrity.mjs";
 import { validateAndCountReview } from "./review.mjs";
 
+
 export {
   detectStatusScope,
   resolveWorkspaceStatus,
@@ -218,30 +219,38 @@ function validatePlan(value, problems) {
 
 function validateEdit(value, problems) {
   if (!value) return;
-  if (value.version !== 0 && value.version !== 1) {
+  if (value.version !== 2) {
     problems.push(`edit.json has unsupported version ${String(value.version)}`);
     return;
   }
-  if (!isRecord(value.output) || !Array.isArray(value.overlays)) problems.push("edit.json has an invalid output/overlays shape");
-  if (value.version === 0) {
-    if (!isNonEmptyString(value.source?.path) || Object.hasOwn(value, "sources")) problems.push("edit.json v0 source shape is invalid");
-  } else {
-    if (!Array.isArray(value.sources) || Object.hasOwn(value, "source") || !Array.isArray(value.cuts)) {
-      problems.push("edit.json v1 sources/cuts shape is invalid");
+  if (!isRecord(value.output) || !Array.isArray(value.sources) || !Array.isArray(value.tracks)) {
+    problems.push("edit.json v2 has an invalid output/sources/tracks shape");
+    return;
+  }
+  const sourceIds = new Set();
+  for (const source of value.sources) {
+    if (!isNonEmptyString(source?.id) || !isNonEmptyString(source?.path) || sourceIds.has(source.id)) {
+      problems.push("edit.json v2 sources are invalid or duplicated");
       return;
     }
-    const ids = new Set();
-    for (const source of value.sources) {
-      if (!isNonEmptyString(source?.id) || !isNonEmptyString(source?.path) || ids.has(source.id)) {
-        problems.push("edit.json v1 sources are invalid or duplicated");
-        break;
-      }
-      ids.add(source.id);
+    sourceIds.add(source.id);
+  }
+  const trackIds = new Set();
+  for (const track of value.tracks) {
+    const hasItems = Array.isArray(track?.items);
+    const hasContent = isRecord(track?.content);
+    if (!isNonEmptyString(track?.id) || trackIds.has(track.id)
+      || (track?.lane !== "visual" && track?.lane !== "audio") || hasItems === hasContent) {
+      problems.push("edit.json v2 tracks are invalid or duplicated");
+      return;
     }
-    for (const cut of value.cuts) {
-      if (!isRecord(cut) || !ids.has(cut.src)) {
-        problems.push(`edit.json cut references unknown source ${String(cut?.src)}`);
-        break;
+    trackIds.add(track.id);
+    if (!hasItems) continue;
+    for (const item of track.items) {
+      if (!isRecord(item) || !isRecord(item.source)
+        || (item.source.kind === "media" && !sourceIds.has(item.source.src))) {
+        problems.push(`edit.json v2 item references unknown source ${String(item?.source?.src)}`);
+        return;
       }
     }
   }
@@ -270,14 +279,14 @@ function resolveMaterialState({ projectRoot, edit, interpretation, problems, war
   let fixed = false;
   if (edit) {
     fixed = true;
-    if (edit.version === 0 && isNonEmptyString(edit.source?.path)) {
-      sources = [resolveProjectPath(projectRoot, edit.source.path, "edit source", problems)];
-    } else if (edit.version === 1 && Array.isArray(edit.sources) && Array.isArray(edit.cuts)) {
-      const usedIds = new Set(edit.cuts.map((cut) => cut?.src));
-      sources = edit.sources
-        .filter((source) => usedIds.has(source.id))
-        .map((source) => resolveProjectPath(projectRoot, source.path, `edit source ${source.id}`, problems));
-    }
+    const mainVisualTrack = Array.isArray(edit.tracks)
+      ? edit.tracks.find(track => track?.lane === "visual" && Array.isArray(track.items)) : null;
+    const usedIds = new Set((mainVisualTrack?.items ?? [])
+      .filter(item => item?.source?.kind === "media")
+      .map(item => item.source.src));
+    sources = (Array.isArray(edit.sources) ? edit.sources : [])
+      .filter(source => usedIds.has(source?.id) && isNonEmptyString(source?.path))
+      .map(source => resolveProjectPath(projectRoot, source.path, `edit source ${source.id}`, problems));
   } else if (interpretation && Array.isArray(interpretation.inputs?.analyses)) {
     fixed = true;
     for (const [index, entry] of interpretation.inputs.analyses.entries()) {

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

@@ -39,6 +39,7 @@
     "docs/contract-2026-08-12-still-image-cut-source-v0.md",
     "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",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",

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

@@ -64,3 +64,30 @@
 2. 「追加のみ進化・tolerant reader」を契約文書に明記する
 3. 破壊的変更時の変換手順を書く節を契約文書に確保する（bump するまで空でよい）
 4. 読み手の forward-compat 挙動（原則 3）を実装する
+
+## 5. 契約ファイル名の `-vN` と edit.json スキーマ版の語彙衝突（2026-08-18 追記）
+
+契約ファイル名の `-vN` サフィックス（例: `contract-2026-08-12-still-image-cut-source-v0.md`）は
+**その契約文書自身のリビジョン**であり、本書が定めるデータ契約の `version` フィールド
+（edit.json 等のスキーマ版）とは無関係である。両者は独立に増減する — 契約文書が改訂されても
+edit.json の `version` は変わらないし、edit.json が `version: 1` に上がっても関連契約が
+`-v1.md` へリネームされるわけではない。
+
+「still-image-cut-source-v0（契約の第 1 版）を読んで edit.json は v1（スキーマ版）で書く」の
+ような読み替えは誤読を招く。edit.json のスキーマ版に言及する契約文書は、本文冒頭で
+**「edit v0」「edit v1」の表記**を使い分け、ファイル名の `-vN` と区別できるようにする（例:
+「本契約は edit v1 の `sources[]` を対象とする」）。読み手（エージェント・人間）も、契約
+ファイル名の `-vN` を見て自動的にスキーマ版だと解釈しない。
+
+## 6. edit.json v0/v1 凍結変換器の終了方針（2026-08-18 オーナー裁定）
+
+- 変換器は機能追加禁止・バグ修正のみとする。未知の v0/v1 ケースに対応を
+  追加せず、「このプロジェクトは変換できません」と理由付きで止まる。
+- AKARI Video 本体から変換器を外す期限は、製品版 `1.0.0` の公開日または
+  `2026-12-31` のいずれか早い方とする。
+- 期限到達時は変換器を破棄せず、単体 npm パッケージ `akari-migrate` へ切り出して
+  1 回だけ publish し、以後更新しない。publish 自体は本移行タスクでは行わず、
+  本体から外す作業の一部とする。
+- 本体から外した後のエラー文言は次で固定する。
+
+  > このプロジェクトは古い形式です。`npx akari-migrate@<版> <dir>` で変換してから開いてください。

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

@@ -79,6 +79,8 @@
 - **`tpad` の `start_mode=clone` は使わない**: カット先頭（`at_sec=0`）での静止を素直に `tpad=start_mode=clone:start_duration=X` で実装すると、後続に（本機能の他パスも含め）`fps` フィルタが一つでも挟まると出力の**最終フレームが 1 枚欠落する**バグをこの ffmpeg ビルドで実機検証した（`stop_mode=clone` には同じ問題が無いことも確認済み）。代わりに、`split` で複製した全区間トリムの一方を `trim=start_frame=0:end_frame=1`（フレーム番号ベース・fps に依存しない）で 1 フレームへ切り、`stop_mode=clone` + `stop=<フレーム数-1>`（時間指定の `stop_duration` ではなく整数フレーム数）で伸ばしてから元の全区間へ concat する
 - **フリーズ中の音声は無音挿入**（direct 音の継続やループはしない）: 直前音をループさせるとループ境目でクリックノイズが乗る（PCM の非ゼロ交差での接続）のに対し、無音挿入は決定論的でグリッチが無い。narration/BGM/SFX は出力タイムライン上の絶対秒で独立に配置される既存契約（`cuts[].speed` と同じ前提）のため、freeze による尺の伸びに合わせて自動シフトはしない
 - **v0 は gap-aware タイムライン（明示 `at`/`track`）との併用不可**: gap-aware パス（`computeVideoRuns`）の出力秒→ソース秒写像は速度係数のみを前提にした線形式で、フリーズによる非線形な静止区間があると破綻する。`cuts[].freeze` が宣言された状態で gap-aware 判定（`needsGapAwareCutTimeline`）が真になる場合、render-cut は明示的に例外を投げて止まる（silent drop を許さない契約の原則どおり、機能を無言で無視しない）。デフォルトの逐次タイムラインでのみ有効
+- **v1（2026-08-18 追記）も同じ制約**: `contract-2026-08-18-v1-render-parity.md` で v1
+  （`sources[]`）の `buildMultiSourceCutCommand` にも gap-aware タイムライン（`buildGapAwareMultiSourceCutCommand`）が入った。理由は v0 と全く同じ（`computeVideoRuns` の線形写像がフリーズを表現できない）ため、`cuts[].freeze` + 明示 `at`/`track` の組み合わせは v1 でも同じ例外で止まる
 
 ### 4-3. プレビュー乖離
 

package/vendor/docs/contract-2026-07-25-r6-audio-tracks-and-trim.md

@@ -63,3 +63,44 @@
 - UI: 実機で (a) 配置原則どおりの表示 (b) 音声トラック追加とアイテム移動が edit.json に
   書き戻る (c) 音源バー端ドラッグで in/out 書き戻り・リロード後保持 (d) トリマーの
   表示・調整が機能 (e) 既存トラック UI・z 順の無退行
+
+## 5. §2 追記 — sfx フェード（audio-clip-fades, 2026-08-18・オーナー裁定「クリップ主義」T2）
+
+BGM をクリップ化する裁定（内部リポ `tasks/2026-08-18-bgm-clip-placement-ruling`）に伴い、
+「音楽をクリップ（audio.sfx[]）として置いても BGM ベッドと同じフェード表現ができる」を
+満たすため、`sfxItem` に optional の `fade_in` / `fade_out`（秒・0 以上）を追加のみ拡張する
+（`version` 不変・`contract-2026-07-17-data-contract-versioning.md` の原則に従う）。
+
+### schema
+
+- `sfxItem.fade_in` / `fade_out`: 秒・省略時 0（フェードなし）。`audio.bgm.fadeIn` /
+  `fadeOut`（camelCase）とは異なり **snake_case**（既存の `gain_db` と同じ命名系列）
+- フェード対象はこのクリップの実効再生窓 `[t, t + 実効尺)`。実効尺は §2 の `[in, out)` が
+  既知なら `out − in`、`in`/`out` 省略時は素材尺（消費側が実尺を解決できた場合のみ）
+- クランプ規則は `audio.bgm.fadeIn`/`fadeOut` と同型: `fade_in`/`fade_out` それぞれ独立に
+  実効尺の半分までクランプ（render-cut が実装、edit-lint は `in`/`out` が両方既知のときだけ
+  警告できる — lint は ffprobe を持たないため実尺越えの検知は消費側の責務、という §2 本文の
+  既存原則をフェードにもそのまま適用）
+
+### 消費（render-cut + preview 3 面）
+
+- render-cut: sfx の afade を volume の直後・adelay の直前に挿入する（adelay 後だと
+  `st=0` が delay 由来の無音区間を指してしまうため）。`in`/`out` 併用時は atrim/asetpts で
+  尺をリセットした後の実効尺基準で afade を計算する
+- シェルプレビュー（akari-preview）: sfx は 1 回きりの `BufferSourceNode` 再生のため、
+  bgm の毎 tick 再計算（fadeMultiplier）ではなく、schedule 時点で
+  `gain.gain.setValueAtTime`/`linearRampToValueAtTime` によるブレークポイント列を組む
+  （`sfxFadeGainSchedule`、シーク再開時は経過秒からブレークポイントを再構成）
+- Web UI（preview-server）: bgm と同じ毎 tick 再計算方式。ただしこの層は現状 sfx の
+  `in`/`out` トリム自体を未実装のため、フェードの実効尺は常にデコード済み素材全長を使う
+  （トリム実装時に合わせて見直す）
+
+### インスペクター
+
+- akari-annotations: sfx 選択時に bgm と同じ「フェード」タブ（`fadeIn`/`fadeOut` ノブ）を出す。
+  ducking は bgm 概念のため sfx には出さない
+- 正本は `packages/edit-store`（edit.json テキスト手術）だが、本追記の実装レーン
+  （task 2026-08-18-audio-clip-fades）のファイル境界が `packages/edit-store` を含まないため、
+  書き戻りは `apps/shell/extensions/akari-annotations/src/common/sfx-fade-store.ts` に
+  境界内で完結する独立実装として置いた（`updateArrayElementByIndex` 等 edit-store の
+  export 済みユーティリティは再利用）。将来 edit-store 側の担当タスクが正本へ統合してよい

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

@@ -556,7 +556,7 @@ ffmpeg の `perspective` フィルタの制約（式に時刻変数を持たな
 | `layers[].perspective`（2026-08-06 実装） | ✅（§2.4.4。実ブラウザ実測済み） | ✅（§2.4.4。tsc -b + ユニット + Web 同一計算式で担保） |
 | `cuts[].fx`（2026-08-07 実装・近似あり） | 🟡（§2.4.5。5 種対応、3 種は近似バッジ付き） | ❌（未実装） |
 | `layers[].keyframes`（2026-08-09 実装） | ✅（§2.4.7。transform/crop は連続補間。perspective は blend:"normal" のみ・書き出しの段階保持とサンプル点で一致） | ✅（§2.4.7。同左） |
-| `cuts[].static-image-source`（2026-08-12 実装。正本: `contract-2026-08-12-still-image-cut-source-v0.md`） | 🟡（`<img>`/`<video>` 出し分け + preview-engine ClipSession/Timeline の image 対応を実装。framing/freeze/transform は流用。実ブラウザでの対話的スクラブ・複数区間切替の実機検証は未実施） | ❌（スコープ外・未対応） |
+| `cuts[].static-image-source`（2026-08-12 実装。正本: `contract-2026-08-12-still-image-cut-source-v0.md`） | 🟡（`<img>`/`<video>` 出し分け + preview-engine ClipSession/Timeline の image 対応を実装。framing/freeze/transform は流用。実ブラウザでの対話的スクラブ・複数区間切替の実機検証は未実施。2026-08-17: 静止画が stylesheet の display:none に隠れたまま永久に出ない実機バグ（`img.style.display=''`）を是正） | 🟡（2026-08-17 実装 — task/2026-08-17-shell-still-image-cut-preview。#preview-still + gap と同じ壁時計クロックで表示。cut transform/framing/freeze/選択ドラッグは video のスタイル鏡写しで流用。タイムラインの静止画フィルムストリップ/サムネも同時是正（probeForFilmstrip の duration 必須ガードが静止画分岐を dead code 化していた）。Electron 実機での対話検証は未実施） |
 
 - `cuts[].framing`（静的クロップ / ズームキーフレーム）・`cuts[].freeze`（フリーズ）は
   `contract-2026-07-22-render-basics.md` #6/#7 としてレンダ（render-cut）に加え、

package/vendor/docs/contract-2026-08-03-caption-display-encoding-qc-v1.md

@@ -72,6 +72,40 @@ before checksum confirmation. Parse, field, process, or 1 MiB capture failures b
 `MEASUREMENT_ERROR` shape, keep a content-addressed artifact and receipt when structurally possible,
 leave render state in `phase:error`, return exit 1, and cannot produce an integrity candidate.
 
+### 3.1 True peak AAC overshoot guard (2026-08-17, task 2026-08-17-render-cut-true-peak-guard)
+
+The `filter_report.normalized.output_tp` loudnorm reports for the PCM stage is not the artifact's
+real true peak: the AAC re-encode that follows can measurably overshoot it (a real render measured
+`filter_report` at -1.00 dBTP against a decoded artifact at +0.23 dBFS — about +1.2 dB of
+codec-introduced overshoot; `planning/notes-2026-08-17-mac-fresh-install-bug-reports.md` #05). Two
+additive mitigations apply only when `true_peak_dbtp` is **explicit** in `audio.master` — the -1.5
+dBTP default is unchanged and unmargined:
+
+- **Applied margin.** `packages/render-cut/src/plan.mjs` hands loudnorm `configured -
+  AAC_TRUE_PEAK_OVERSHOOT_MARGIN_DBTP` (1.5 dB, `packages/render-cut/src/audio-qc.mjs`) instead of
+  the raw configured value, so the *decoded* artifact — not just the PCM stage — has a better chance
+  of landing under what the caller asked for. The receipt records both under an additive
+  `audio_qc.true_peak_margin: { overshoot_margin_dbtp, applied_true_peak_dbtp }` field;
+  `audio_qc.configured.true_peak_dbtp` is unchanged and still reports the caller's original value.
+  The margin is a fixed mitigation, not a guarantee — real-render testing found synthetic
+  high-transient material where even the margined target still decodes above 0 dBFS (this is what
+  the next mitigation exists to catch).
+- **Overshoot detection.** When `decoded_measurement.normalized.input_tp` exceeds
+  `configured.true_peak_dbtp` by more than a 0.1 dB tolerance, `buildAudioQc` appends an additive
+  `audio_qc.warnings: ["TRUE_PEAK_EXCEEDED: ..."]` entry — readable from the receipt alone, no
+  human needs to eyeball the two numbers. `verdict` deliberately **stays `"INCONCLUSIVE"`**, not a
+  new value: `packages/akari-launcher/src/status-core/integrity.mjs` (mirrored at
+  `plugin/runtime/status-core/integrity.mjs`) closed-world-validates the successful-measurement
+  branch and rejects any verdict string other than `"INCONCLUSIVE"` as a structural integrity
+  problem, and `accept-command.mjs` keys its human-review warning off that exact string. A new
+  verdict value would have misreported a legitimate receipt as malformed instead of surfacing the
+  overshoot, so exceeding true peak is additive evidence on an otherwise-`INCONCLUSIVE` receipt, not
+  a verdict of its own.
+
+Both fields are additive to the existing `configured` / `filter_report` / `decoded_measurement`
+triple — nothing already reading `audio_qc` needs to change, and their absence (when
+`true_peak_dbtp` is left at its default, or when nothing exceeded) is the unchanged legacy shape.
+
 ## 4. Recipe boundary and evidence grade
 
 Recipe `caption_style_ref` is descriptive only. It is not registry-backed and never injects caption

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

@@ -6,6 +6,11 @@ updated: 2026-08-12
 
 # 静止画 cut ソース契約 v0
 
+> **読み替え注記**: 表題の `-v0` は本契約文書自身のリビジョンであり、edit.json の
+> スキーマ版（`version`）とは別物。本契約が対象とするのは edit v0 の `source.path` と
+> edit v1 の `sources[].path` の両方（語彙の区別は
+> [contract-2026-07-17-data-contract-versioning.md](./contract-2026-07-17-data-contract-versioning.md) §5）。
+
 - 日付: 2026-08-12
 - 状態: **ドラフト**（v0 実装と同時に確定させる。実装で判明した齟齬は追記で解消）
 - 前提:
@@ -157,6 +162,14 @@ Electron シェル本体（`apps/shell`）のプレビュー対応は本タス
 image-layer-parity ではシェル側 webview も同時対応していたが、本タスクの司令塔裁定でシェルは
 別タスクへ切り出されている。§3 の適合状況表にシェル列は `❌`（未対応）として記録する。
 
+**追記（2026-08-17）**: 切り出されていたシェル対応を task/2026-08-17-shell-still-image-cut-preview
+で実装した。方式は Web UI（§5.2）と同型 — `#preview-still`（`<img>`）を `#preview-video` に重ね、
+静止画セグメントのクロックは gap セグメントと同じ壁時計原点を共用する。カットの
+transform / framing / 選択ドラッグは video 要素のインラインスタイルを毎フレーム鏡写しにする
+ことで既存レールをそのまま流用。タイムライン（akari-annotations）の静止画フィルムストリップも
+同タスクで是正（`probeForFilmstrip` の duration>0 必須ガードが、ffprobe が duration を報告しない
+静止画〔§2.3〕で既存の isImage 分岐を dead code 化していた）。適合状況はパリティ契約 §3 を参照。
+
 ## 6. 適合状況の更新
 
 `contract-2026-08-02-preview-parity.md` §3 の適合状況表に `cuts[].static-image-source` 行を

package/vendor/docs/contract-2026-08-18-v1-render-parity.md

@@ -0,0 +1,115 @@
+---
+lifecycle: draft
+created: 2026-08-18
+updated: 2026-08-18
+---
+
+# v1 レンダー経路パリティ契約 — cuts[].at / cuts[].track
+
+- 日付: 2026-08-18
+- 状態: **ドラフト**（実装と同時に確定させる）
+- 前提:
+  - `contract-2026-07-22-render-basics.md`（`cuts[].freeze` とゲートアウェア・タイムラインの
+    非併用制約。本契約はその制約を v1 の等価経路へそのまま延長する）
+  - `contract-2026-08-12-still-image-cut-source-v0.md`（`buildMultiSourceCutCommand` の
+    静止画 `-loop 1` レシピ。本契約が追加する経路もこのレシピをそのまま継承する）
+- スコープ: `packages/render-cut/src/plan.mjs`（cut コマンド生成）/
+  `packages/edit-lint/src/edit-lint.mjs`（警告の整合）
+
+## 0. 背景・実害
+
+v0（`source` 単一）の `cuts[]` は `at`（明示配置・ギャップ）と `track`（多段合成）を
+`buildGapAwareCutCommand` / `buildTrackStackPlan` で解釈していたが、v1（`sources[]`）の
+`buildMultiSourceCutCommand` は `cuts[]` を配列順に**連結するだけ**で `at`/`track` を一切見て
+いなかった。UI のドラッグ操作は v1 プロジェクトへ `at`/`track` を普通に書くため、プレビュー
+（kernel は `at`/`track` を正しく写像）と書き出しが食い違う WYSIWYG 破綻が実機で発生した
+（2026-08-18）。`track` >= 1 のカットは合成されず出力尺へそのまま連結され、一度も画面に出ない
+まま尺だけ伸びた mp4 が焼き上がっていた。
+
+## 1. 裁定 — どの dispatch を直すか
+
+v1 で `at`/`track` が実際に効く経路は 2 つあり、**症状が出ていたのは片方だけ**だった:
+
+1. **既定順（`usesDefaultTrackOrder` が true）**: `buildPlan` が `buildMultiSourceCutCommand` を
+   `edit.cuts` へ直接呼ぶ。UI が書く典型（`timeline.tracks` を明示宣言しない）はこちら。
+   **ここが壊れていた** — `at`/`track` を一切見ない単純連結だった。
+2. **カスタム順（`timeline.tracks` が既定と異なる並びを明示宣言）**: `buildTrackStackPlan` が
+   `track` ごとに `cuts[]` をフィルタし、`buildMultiSourceCutCommand`（フィルタ後の配列。素の
+   逐次連結のまま）→ `resolveCutTrackRanges`（`track-compose.mjs`）が「素の逐次連結クリップの
+   どこに各カットの中身があるか」を `offsets` 累積和で追跡し、`buildCutTrackCompositeCommand`
+   の `overlay=...enable=...` で `at` 位置へ配置する、という**補正込みの設計で最初から正しく
+   動いていた**（`track-compose.test.mjs` の実レンダーテストで確認済み・pixel 検証あり）。
+
+よって本タスクは **(1) の dispatch だけを直す**。`buildMultiSourceCutCommand` 自体・
+`buildTrackStackPlan`・`resolveCutTrackRanges` は変更しない — (2) の補正ロジックは
+`buildMultiSourceCutCommand` が「常に素の逐次連結を返す」ことに依存しており、(1) の dispatch
+内部で分岐を追加すると (2) を壊す（`track` >= 1 のフィルタ済み配列は常に
+`needsGapAwareCutTimeline` が真になるため、素の分岐と衝突する）。
+
+## 2. 実装
+
+### 2.1 新規関数 `buildGapAwareMultiSourceCutCommand`（`plan.mjs`）
+
+v0 の `buildGapAwareCutCommand` の v1 版。`buildPlan` の v1 分岐だけが呼ぶ
+（`buildTrackStackPlan` の per-track 呼び出しは既存の `buildMultiSourceCutCommand` のまま）。
+
+```
+cut = needsGapAwareCutTimeline(edit.cuts)
+  ? buildGapAwareMultiSourceCutCommand(...)  // at ギャップ or track>=1 が宣言されている
+  : buildMultiSourceCutCommand(...)          // 既存の単純連結（無改修）
+```
+
+- **ギャップの埋め方**: v0 と同一（`color=c=black:...` で尺ぶん黒塗り）。`look`（LUT）は
+  無視した素の黒 — v0 の `buildGapAwareCutCommand` と同じ挙動
+- **多段合成の意味論**: `computeVideoRuns`（`cut-timeline.mjs`）の winner-take-all スイッチ。
+  ある瞬間に最も高い `track` 番号のカットが**画面全体を占有**する（同時アルファ合成ではない）
+  — v0 が既定順で行っているのと全く同じモデルで、新しいリッチな合成モデルではない
+- **音声はカット単位（ラン単位ではない）**: 各カットの `[in,out)` がそれぞれの `at` 位置で
+  再生され、`amix` で重ね合わさる。画面はどちらか一方しか映らなくても、音声は両方鳴る
+  （v0 の `buildGapAwareCutCommand` の音声ループをそのまま踏襲）
+- **`cuts[].freeze` との非併用**: v0 と同じ理由（`computeVideoRuns` の出力秒→ソース秒写像が
+  speed のみを前提にした線形式で、フリーズの非線形な静止区間を表現できない）で、
+  `hasCutFreeze(cuts)` なら例外を投げて止める（silent drop しない）
+- **静止画 `-loop 1`・`transform`（scale/x/y/rotate）・`fx`・LUT**: 既存の
+  `appendCutVisualTransform` / `appendCutFxChain` / `isImageLayerSource` をそのまま再利用
+
+### 2.2 `predictedDuration` の並び替え
+
+v1 は従来 `version === 1` の分岐が最初に来ており、`needsGapAwareCutTimeline` の判定に
+一度も到達しなかった（= at ギャップ・PiP を考慮しない `sequentialDurationWithTransitionOverlap`
+の単純合計を常に返していた）。ギャップアウェア判定をバージョン分岐より前に出し、v0/v1 共通で
+「セグメント終端の最大値」（`resolveCutSegments` の `end` の max）を使うよう修正。これにより
+`verify.duration` が新しい（正しい）レンダー尺と整合する。
+
+### 2.3 `cut_track_declaration_unrendered` フラグの撤去
+
+`buildPlan` が返していた「v1 の track/at 宣言が効いていない」ヒント旗（`verifyArtifact` が
+`verify.duration` 失敗時に付加していた注記）は、根本原因が解消されたため撤去。誤解を招く
+古い注記を残さない。
+
+## 3. edit-lint の警告撤去
+
+`cuts.track-render-unsupported` / `cuts.at-render-unsupported`
+（`packages/edit-lint/src/edit-lint.mjs` の `validateCutTrackRenderSupport`）は
+「v1 の書き出しは track/at を無視する」ことを警告するためだけに存在していた。2.1 の実装で
+根本原因が解消されたため、チェックごと撤去した。`cuts.track-transition-unsupported`
+（カスタム `timeline.tracks` 順での `transition_out` 非対応）は本契約の対象外 — §1 の (2) の
+経路自体は変更していないため、既存のまま有効。
+
+## 4. 既知の制約（v0 と同一 — 新規に増やしていない）
+
+- `cuts[].freeze` と at/track ギャップアウェア・タイムラインの併用は不可（§2.1）。lint での
+  事前警告はない（v0 も render 時の例外のみで、lint チェックは元から無い。同じ姿勢を踏襲）
+- 多段合成は同時アルファオーバーレイではなく winner-take-all スイッチ（§2.1）。カスタム
+  `timeline.tracks` 順（§1 の (2)）を使えば `buildTrackStackPlan` 経由の本当の重ね合わせ
+  （`overlay=...enable=...`）になる — 使い分けは v0 と同じ
+
+## 5. 検証
+
+- L0: `packages/render-cut` / `packages/edit-lint` の `npm test` 全 PASS
+- 実 ffmpeg（`packages/render-cut/test/v1-track-parity.test.mjs`）:
+  (a) at ギャップ入り v1 プロジェクトの出力尺・各カットの出現時刻が宣言どおり（±1 フレーム）
+  (b) `track:1` の PiP が実際に画面に合成される（PiP 領域の画素が下段と異なる）
+  (c) 既存 v1 プロジェクト（at 無し・連結）の非回帰（フィルタグラフが従来のまま byte 一致）
+  加えて、オーナーの実プロジェクト相当（v1・全静止画・at ギャップ・音声クリップ）の fixture で
+  書き出し尺とタイミングがタイムライン宣言と一致することを確認

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "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": [
@@ -34,7 +34,7 @@
   "scripts": {
     "prepack": "node scripts/prepack.mjs",
     "postpack": "node scripts/prepack.mjs clean",
-    "test": "node --test test/*.mjs"
+    "test": "node --test --test-concurrency=1 test/*.mjs"
   },
   "akariVideoVendor": {
     "execution": "reference-only",

package/vendor/packages/audio-library-setup/README.md

@@ -15,8 +15,8 @@
 | `bin/fetch-akari-sounds.mjs` | AKARI Sounds を GitHub Release から**一括取得**し user スコープへ登録する CLI（first-party のみ許可。取得先は AkariLabs/akari-sounds に限定） |
 | `shared/bgm-suggest.mjs` | BGM 自動提案の純粋ロジック — tone 語彙（表現選定と同じ 8 語）× 系統対応表 `FAMILY_TONE_RULES` × 体感 BPM で決定論ランキング |
 | `bin/suggest-bgm.mjs` | BGM 自動提案 CLI。導入済みスナップショット（`.origin-catalog.json`）を読み、`--tone`（複数可）`--tempo` から候補 + ローカル実体パスを提示（`--json` あり）。`--declarations`（または env `AKARI_SOUNDS_DECLARATIONS`）で耳検証済み宣言を合流 — 実測 BPM 置換・耳検証ボーナス・**サビ頭出し（`audio.bgm.in` の推奨値）**・構成表示が付く。ネットワーク不使用 |
-| `shared/beat-grid.mjs` | 宣言（bpm / 頭拍 / キメ / 構成）を **timeline 秒**へ写す純粋ロジック。`audio.bgm.in` とループ（**1 周目は in から・2 周目以降はファイル先頭から**。2026-08-04 に ffmpeg 実測で確定）を反映し、スナップ（キメ > 小節頭 > 拍）とカット候補を返す |
-| `bin/beat-grid.mjs` | 音楽グリッド CLI（`--edit` / `--track` + `--timeline`・`--snap`・`--json`）。edit-plan の [beat-sync](../../skills/edit-plan/beat-sync.md) が発火位置を拍へ寄せるのに使う |
+| `shared/beat-grid.mjs` | 宣言（bpm / 頭拍 / キメ / 構成）を timeline へ写す純粋ロジック。`musicGrid()` の秒グリッドは検査用の内部計算として維持し、`toFrameGrid()` / `snapToGrid()` / `cutCandidates()` が出力 fps 上の整数フレームを返す。`audio.bgm.in` とループ（**1 周目は in から・2 周目以降はファイル先頭から**。2026-08-04 に ffmpeg 実測で確定）を反映する |
+| `bin/beat-grid.mjs` | 音楽グリッド CLI（`--edit` / `--track` + `--timeline`・`--fps`・`--snap`・`--json`）。`--edit` では `output.fps` を使い、拍・小節頭・キメ・スナップ・カット候補を整数フレームで返す。edit-plan の [beat-sync](../../skills/edit-plan/beat-sync.md) が発火位置を拍へ寄せるのに使う |
 | `shared/sfx-suggest.mjs` | SFX / ジングル自動提案の純粋ロジック — 「場面の意味」14 語 × 宣言表 `MEANING_RULES`（候補順 = 優先順・外部補完の参照つき） |
 | `bin/suggest-sfx.mjs` | SFX / ジングル自動提案 CLI（`--meaning` / `--list` / `--json`）。suggest-bgm の姉妹 |
 | `bin/review-sfx-mapping.mjs` | 「意味 → 音」対応表の**耳レビュー面**を生成（全意味 × 候補の試聴プレイヤー + 判定 JSON 書き出し。既定出力 `~/.akari/reviews/sfx-mapping.html`） |