akari-video 0.1.97 → 0.1.99

package/README.md

@@ -123,6 +123,25 @@ npm i -g akari-video && akari
 npx akari-video
 ```
 
+### akari doctor の cli.node
+
+`akari doctor --json` の `cli.node` は、この CLI を動かしている実行体と、スクリプトを Node として呼ぶ方法を返す。
+
+| フィールド | 意味 |
+|---|---|
+| `exec_path` | 診断を実行した実行体のパス。Electron アプリの EXE になることもある |
+| `electron_run_as_node` | 診断を実行したプロセスの環境変数が `ELECTRON_RUN_AS_NODE=1` だったか |
+| `version` | 実行体の Node のバージョン（Electron では内蔵の Node） |
+| `runtime` | 実行体が `electron` か `node` か |
+| `electron_version` | Electron のバージョン。Node 実行体では `null` |
+| `run_as_node_supported` | Electron 実行体を Node として呼べるか |
+| `required_env` | Node として呼ぶために必要な環境変数。Electron では `{ "ELECTRON_RUN_AS_NODE": "1" }`、Node では `{}` |
+| `invocation` | `shell` は既定シェル、`example` はそのシェル用の呼び方。`cmd` と `sh` は両方常に出る。`<script>` を実際のスクリプトパスに置き換える |
+
+`electron_run_as_node` は診断時の環境だけを表す。Node として使えるかは `runtime`、`run_as_node_supported`、`required_env` で判断する。`runtime` が `electron` なら `required_env` を付けて呼ぶ。Windows の `cmd` では `set "ELECTRON_RUN_AS_NODE=1"` と引用符で囲む。`set ELECTRON_RUN_AS_NODE=1 &&` と書くと末尾の空白が値に入る。
+
+Electron を Node として呼んだプロセスから GUI の Electron を子プロセスとして起動するときは、子へ渡す環境から `ELECTRON_RUN_AS_NODE` を外す。
+
 ## 既知の制約
 
 - npm tarball は追跡済み skills・雛形・schemas と capability source set を `vendor/` に同梱する。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.97",
+  "version": "0.1.99",
   "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/doctor-command.mjs

@@ -29,6 +29,9 @@ export async function runDoctorCommand(argv, options = {}) {
 export function formatDoctorReport(report) {
   const rows = [
     ['cli', 'ok', `v${report.cli.version} — ${report.cli.entry_path}`],
+    ['node', report.cli.node?.runtime ?? 'unknown', report.cli.node
+      ? `v${report.cli.node.version} — ${report.cli.node.exec_path}${report.cli.node.runtime === 'electron' ? ' （Node として使うには ELECTRON_RUN_AS_NODE=1 を付けて呼ぶ）' : ''}`
+      : '診断情報がありません'],
     ['app_managed', report.app_managed.status, detail(report.app_managed.path, report.app_managed.version)],
     ['app_bundle', report.app_bundle.found ? 'found' : 'missing', detail(report.app_bundle.path, report.app_bundle.version)],
     ['render_cut', report.render_cut.origin, report.render_cut.path ?? '見つかりません'],

package/src/runtime-diagnostics.mjs

@@ -128,6 +128,36 @@ export function resolveRuntimePaths(options = {}) {
   };
 }
 
+export function describeNodeRuntime(options = {}) {
+  const execPath = options.execPath ?? process.execPath;
+  const platform = options.platform ?? process.platform;
+  const env = options.env ?? process.env;
+  const versions = options.versions ?? process.versions;
+  const runtime = versions.electron ? 'electron' : 'node';
+  const quotedExecPath = `"${execPath}"`;
+  const cmd = runtime === 'electron'
+    ? `set "ELECTRON_RUN_AS_NODE=1" && ${quotedExecPath} <script>`
+    : `${quotedExecPath} <script>`;
+  const sh = runtime === 'electron'
+    ? `ELECTRON_RUN_AS_NODE=1 ${quotedExecPath} <script>`
+    : `${quotedExecPath} <script>`;
+  return {
+    exec_path: execPath,
+    electron_run_as_node: env.ELECTRON_RUN_AS_NODE === '1',
+    version: options.nodeVersion ?? versions.node,
+    runtime,
+    electron_version: versions.electron ?? null,
+    run_as_node_supported: runtime === 'electron',
+    required_env: runtime === 'electron' ? { ELECTRON_RUN_AS_NODE: '1' } : {},
+    invocation: {
+      shell: platform === 'win32' ? 'cmd' : 'sh',
+      example: platform === 'win32' ? cmd : sh,
+      cmd,
+      sh,
+    },
+  };
+}
+
 export async function resolveDoctorReport(options = {}) {
   const env = options.env ?? process.env;
   const platform = options.platform ?? process.platform;
@@ -144,11 +174,11 @@ export async function resolveDoctorReport(options = {}) {
     cli: {
       version: options.cliVersion ?? readOwnVersion(),
       entry_path: options.entryPath ?? process.argv[1] ?? null,
-      node: {
-        exec_path: execPath,
-        electron_run_as_node: env.ELECTRON_RUN_AS_NODE === '1',
-        version: options.nodeVersion ?? process.versions.node,
-      },
+      node: describeNodeRuntime({
+        execPath, platform, env,
+        versions: options.versions ?? process.versions,
+        nodeVersion: options.nodeVersion,
+      }),
     },
     ...runtime,
     ffmpeg: mediaBin.ffmpeg,

package/src/store-command.mjs

@@ -265,7 +265,7 @@ export async function runStoreCommand(args, options = {}) {
       return { exitCode: 1 };
     }
 
-    log('ブラウザで AKARI Store を開いて接続を承認してください。');
+    log('ブラウザで AKARI Video Lab を開いて、AKARI アカウントの接続を承認してください。');
     log(`  確認コード: ${start.userCode}`);
     log(`  URL: ${start.verificationUrl}`);
     if (!args.includes('--no-open')) {

package/src/store-device-connect.mjs

@@ -62,10 +62,10 @@ export async function fetchStoreEntitlements(fetchImpl, baseUrl, token) {
       headers: { authorization: `Bearer ${token}` }
     });
   } catch (error) {
-    return { error: `ストアに接続できませんでした: ${error instanceof Error ? error.message : String(error)}` };
+    return { error: `AKARI Video Lab に接続できませんでした: ${error instanceof Error ? error.message : String(error)}` };
   }
   if (response.status === 401) return { error: 'トークンが無効です。マイページで発行し直してください。' };
-  if (!response.ok) return { error: `ストアがエラーを返しました（${response.status}）` };
+  if (!response.ok) return { error: `AKARI Video Lab がエラーを返しました（${response.status}）` };
   return { data: await response.json() };
 }
 
@@ -125,16 +125,16 @@ export async function startDeviceConnection({
   } catch (error) {
     return {
       status: 'network-error',
-      error: `ストアに接続できませんでした: ${error instanceof Error ? error.message : String(error)}`
+      error: `AKARI Video Lab に接続できませんでした: ${error instanceof Error ? error.message : String(error)}`
     };
   }
   if (!response.ok) {
-    return { status: 'error', error: `ストアに接続できませんでした（${response.status}）` };
+    return { status: 'error', error: `AKARI Video Lab に接続できませんでした（${response.status}）` };
   }
   const body = await response.json().catch(() => ({}));
   if (typeof body.device_code !== 'string' || typeof body.user_code !== 'string'
     || typeof body.verification_url !== 'string') {
-    return { status: 'error', error: 'ストアから接続に必要な情報を受け取れませんでした。' };
+    return { status: 'error', error: 'AKARI Video Lab から接続に必要な情報を受け取れませんでした。' };
   }
   const result = {
     status: 'started',
@@ -168,7 +168,7 @@ export async function pollDeviceConnection({
   } catch (error) {
     return {
       status: 'network-error',
-      error: `ストアに接続できませんでした: ${error instanceof Error ? error.message : String(error)}`
+      error: `AKARI Video Lab に接続できませんでした: ${error instanceof Error ? error.message : String(error)}`
     };
   }
   if (response.status === 410) {

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

@@ -178,5 +178,5 @@ x264、その他の環境で x264 の順に解決する。ハードウェア対
 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` を使用する。
+旧 legacy 書き出しは `cut.mp4` と必要時の `cut-tail-padded.mp4` を使用していた（現在は廃止）。
 音声入力は cut ごとに入力側シーク（`-ss` / `-t`）し、cut 頭 0.5 s の先読みガード（AAC の overlap-add 用）を設け、cut 段の費用を素材長に依存させない。

package/vendor/docs/contract-2026-07-23-analysis-person-matte.md

@@ -279,7 +279,7 @@ frame-engine を使う消費側は、VP9 alpha WebM または alpha pixel format
 明示 `mask` がある場合も color / mask の取り込みは行い、frame-engine のマスク入力には明示参照を優先する。
 
 変換失敗は非致命警告とし、該当 layer だけを frame-engine から外す。旧 `<video>` プレビューは
-元素材の `src` を維持し、legacy 書き出しの alpha filtergraph もこの取り込み変換を使わない。
+元素材の `src` を維持する。旧 legacy 書き出しの alpha filtergraph はこの取り込み変換を使わなかった（現在は廃止）。
 
 ## 9. 既知の追随事項（本契約が作る宿題）
 

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

@@ -258,7 +258,7 @@ legacy 合成経路は、移行中の既存利用者と Windows を支えるた
 エンジン意味論や完成画の仕様の正本ではない。
 
 - `<video>` ベースの二つの互換プレビューは、各器で frame-engine が既定になった後 **2 リリース**保持する。
-- legacy 書き出しは明示的な互換選択で到達可能なまま残し、コードとテストを削除・無効化しない。
+- 当時は legacy 書き出しを明示的な互換選択で残す計画だった。現在は廃止済み。
 - legacy 削除（#100b）は、#14 の Windows 実機で OSR が PASS するか、Windows でも OSR を既定にする
   オーナー裁定がある場合にだけ開始する。
 - 退役前も新しい意味論を互換経路へ追加しない。差は清算表へ記録し、v2 の合否は §4.1 と §4.2 で決める。

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

@@ -163,15 +163,18 @@ The `filter_report.normalized.output_tp` loudnorm reports for the PCM stage is n
 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
+additive mitigations apply to explicit `true_peak_dbtp` in `audio.master` — the -1.5
 dBTP default is unchanged and unmargined:
 
-- **Applied margin.** `packages/render-cut/src/plan.mjs` hands loudnorm `configured -
+- **Applied margin.** Only when the output audio codec is AAC (h264 / hevc),
+  `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.true_peak_margin: { overshoot_margin_dbtp, applied_true_peak_dbtp, reason: "aac_reencode_overshoot", audio_codec: "aac" }` field;
   `audio_qc.configured.true_peak_dbtp` is unchanged and still reports the caller's original value.
+  PCM output (prores422 / png → `pcm_s16le`) passes the configured target directly to loudnorm
+  and has no `audio_qc.true_peak_margin` field (#122, 2026-09-28).
   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).
@@ -183,7 +186,8 @@ dBTP default is unchanged and unmargined:
   configured target, decoded measurement, and tool version; a mismatch is a structural error.
 
 These two fields are additive to the existing `configured` / `filter_report` /
-`decoded_measurement` fields. No margin is recorded when `true_peak_dbtp` is omitted, and no
+`decoded_measurement` fields. No margin is recorded when `true_peak_dbtp` is omitted or the output
+audio codec is PCM, and no
 overshoot warning is recorded when the measured peak does not exceed the threshold.
 
 ## 4. Recipe boundary and evidence grade

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

@@ -55,7 +55,7 @@ A = 255
 
 BGRA bitmapでは `[0x55, G, R, 255]` となる。左端、中央、右端の3画素を復号し、期待番号との全点一致を要求する。確認後、ffmpegへ渡す前に `buffer.subarray(0, W * H * 4)` で最下行を除く。
 
-`--verify stamp|hash|off` を持ち、既定は `stamp` とする。`hash` は直前の映像領域と同じSHA-256ならsettle後に再取得し、静止画で上限へ達した場合は曖昧件数を記録して受理する。`off` は比較計測用である。通常書き出しではverifyを無効にしない。
+`--verify stamp|hash|off` を持ち、既定は `stamp` とする。`hash` は直前の映像領域と同じSHA-256ならsettle後に再取得し、上限は8回かつ`OSR_STAMP_RETRY_BUDGET_MS`、待ちは伸ばさない。静止画で上限へ達した場合は曖昧件数を記録して受理する。`off` は比較計測用である。通常書き出しではverifyを無効にしない。
 
 ## 4. 駆動プロトコル
 
@@ -71,6 +71,8 @@ seek → ready → invalidate → paint → verify → write
 
 `run.json` はseek、paint、toBitmap、verify、writeのp50/p95、1000コマ区切りmedian、先頭と末尾のdriftRatio、paint timeout、verify retry、verify前delta histogram、backpressure、メモリ、ffprobe結果を記録する。
 
+**2026-09-28 追記（#113 / #88）**: stampの再試行は時間予算3000 msと回数上限32の先に達した方で失敗する。2回目からsettleの前に16、32、64、…最大500 msを追加で待つ。並走実測では再試行1回が約33〜40 ms、2〜3本並走でも最大2回、1コマ平均が212〜312 msだった。従来の固定8回は約0.3秒で諦めていたため、3秒は並走中の平均1コマの約10倍の猶予とする。失敗文は従来の先頭、読めたstamp値と分類、活性オーバーレイとCSS機能、予算、再実行の案内を順に含む。`run.json` の `verify.budget` / `verify.retryElapsedMs` は完了・失敗の両方に、`verify.failure` はstamp失敗時だけに記録する。
+
 ## 5. LUT
 
 `output.look` のLUTはframe-engine canvas内のsampler3Dで適用する。ページ全体へCSS filterを掛けない。したがって字幕、自由HTML、3DはLUTの外にあり、映像canvasだけが色変換の対象となる。
@@ -85,7 +87,7 @@ seek → ready → invalidate → paint → verify → write
 
 第1段・第2段とも、実プロセスのコマンドラインに`--force-device-scale-factor=1`、`--force-color-profile=srgb`、background throttling無効化スイッチを渡す。npm Electronではスクリプトパスを`argv[1]`に保ち、その後へChromiumスイッチを置く。ソフト描画時は加えてGPU無効化とSwiftShaderスイッチを渡す。
 
-第1段・第2段とも`--user-data-dir=<run 一時ディレクトリ>/electron-user-data`を渡し、本体アプリの単一インスタンスロック（userData単位）と分離する。これによりアプリ起動中でも書き出せる。子がexit 0で終了して出力を作らなかった場合は、launcherが失敗として扱う。
+第1段・第2段とも`--user-data-dir`を渡し、本体アプリの単一インスタンスロック（userData単位）と分離する。既定は`launchElectronExport`が書き出しごとに`os.tmpdir()`直下へ`mkdtemp("akari-osr-")`で作る短い一意なディレクトリで、子のclose後に`finally`で削除する。呼び出し側が`userDataDir`を明示した場合はそれを使い、作らず消さない。これによりアプリ起動中でも書き出せる。子がexit 0で終了して出力を作らなかった場合は、launcherが失敗として扱う。**2026-09-28 改訂（#114）**: 出力の隣に置くとプロジェクトのパス長とChromiumのキャッシュ階層がWindowsのMAX_PATHを超え、キャッシュ作成エラーがstderrに出ていた。
 
 **Windows のアプリ別 GPU 設定の一時上書き（2026-09-01 追記・§11.7）**: `platform === "win32"` かつソフト描画でないとき、第1段・第2段とも launcher（`launchElectronExport`・gpu / osr 共通の spawn 点）は、`auto` では GPU 出口（`options.exit === "gpu"`・gpu-export の electron-main）のときだけ、`force` では OSR 出口でも、spawn の直前に `HKCU\Software\Microsoft\DirectX\UserGpuPreferences` へ「値名 = 実行体のフルパス（`path.win32.resolve` で正規化）・REG_SZ `GpuPreference=2;`」を書き、子の `close` 後（exit code に関わらず・spawn エラーでも）に `finally` で必ず 1 回復元する（無かったなら削除・あったなら元の値へ）。方針は呼び出し側の `gpuPreference` → env `AKARI_EXPORT_GPU_PREFERENCE` → `auto` の順に解決し、`auto` は利用者が明示した値（`GpuPreference=1;` 等）を黙って上書きしない（`force` だけが上書き + 復元する）。書く前に sidecar `<AKARI_HOME ?? ~/.akari>/gpu-preference-override.json` を置き、復元後に削除する。`launchElectronExport` は毎回冒頭で sidecar があれば先に復元する。記録は戻り値の `gpuPreference`（`exit` 込み）と receipt の `provenance.gpu_preference`。OSR 出口を `auto` で外す根拠は §11.7（2026-09-02 改訂）。他 OS はバイト同一の no-op（記録に `reason: platform` だけ残す）。開発用に `AKARI_EXPORT_ALLOW_DESKTOP=0` で第1段（インストール済みアプリ）を候補から外せる（明示引数 `allowDesktop` が env より優先）。
 
@@ -195,7 +197,7 @@ fieldtest / 検収に receipt が 1 件も無く、一度も動いていない
 
 v0.1.27 からの挙動: `resolveOsrLauncher`（製品入口）はインストール済みアプリを既定で候補から外す
 （`allowInstalledDesktop: false`）。`AKARI_OSR_ELECTRON` の明示指定は従来どおり tier 1。npm Electron（tier 2）が無い
-パッケージ版では tier 3 = legacy へ警告付きで落ち、provenance に `engine_fallback` と理由が残る（`auto` / `osr` とも）。
+当時のパッケージ版では tier 3 = legacy へ警告付きで落ちていた。現在は legacy へフォールバックせず、OSR の Electron が見つからない場合は書き出しを拒否する。
 根本修正 = `--render` を Theia より前に捕捉する書き出し専用の Electron 入口（別票）。入口が入ったら既定を戻す。
 
 **2026-08-29 追記（根治）**: 書き出し専用の入口 `apps/shell/electron-entry.js` が合流した（§6 / §11.4）。`resolveOsrLauncher` の既定を戻し、インストール済みアプリを再び tier 1 の候補にする（v0.1.28〜）。`allowInstalledDesktop: false` は明示の opt-out として残す。

package/vendor/docs/contract-2026-08-28-v2-approximation-ledger.md

@@ -4,7 +4,7 @@
 
 ## 1. 目的と判定規則
 
-本表は、プレビュー、legacy 書き出し、エンジン v2 の間に蓄積した恒久近似を一件ずつ清算する正本である。
+本表は、プレビュー、当時の legacy 書き出し、エンジン v2 の間に蓄積した恒久近似を一件ずつ清算した履歴である。legacy 書き出しは現在廃止済み。
 状態は次の三つに限る。
 
 - **解消**: `packages/frame-engine/test/golden` の点群、`test:seek`、または契約に記録された実測値がある。

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

@@ -176,3 +176,34 @@ frame-engine は映像の ready を先に成立させ、その直後から予定
 他の圧縮音声は符号化サイズの 16 倍で行う。再生開始は先読み済みの項目を再利用し、未着の項目だけを
 待つため、先読み処理は初期フレームの描画を止めない。decode に失敗した項目は 5 秒空けて再試行し、
 それまで `debug().prefetch.failed` に載る。
+
+## 9. BGM の重ね（クロスフェード）
+
+複数の `role:"bgm"` item は別の audio トラックに置けば時間で重ねてよい。
+重なり区間は両方が鳴る。render-cut は各 BGM にフェードと ducking 包絡を掛けてから
+`amix normalize=0` で足す。クロスフェードは前の item の `fade_out` と後の item の
+`fade_in` に秒数を指定する。
+
+edit-lint は「前に `fade_out` が無く、かつ後に `fade_in` が無い」重なりだけを
+`v2.audio-bgm-multiple` の warning にする（2026-09-28 に error から緩和。#120）。
+同じトラック内の重なりは従来どおり `v2.track-no-overlap` の error となる。
+
+実書き出しの測定は `packages/render-cut/test/bgm-crossfade-overlap.test.mjs` に固定した。
+2026-09-28 に Windows・ffmpeg 9.0 で測定。帯域レベルは各時刻の 0.2 秒窓に
+`bandpass`（Q=15）と `volumedetect` を適用し、ピークは `astats` で測った（単位は dB / dBFS）。
+
+| 測定項目 | フェードあり | フェードなし |
+|---|---:|---:|
+| 440 Hz 帯域、1.0 / 1.55 / 1.75 / 1.95 / 2.5 秒 | -9.4 / -10.7 / -15.5 / -26.5 / -36.1 | -9.4 / -9.4 / -9.4 / -11.5 / -36.1 |
+| 880 Hz 帯域、同時刻 | -36.1 / -23.7 / -14.6 / -10.0 / -9.3 | -36.1 / -10.3 / -9.2 / -9.3 / -9.3 |
+| 素材 `a.wav` のピーク | -3.06 | -3.06 |
+| 出力全体のピーク | -5.82 | -0.96 |
+| 重なり区間（1.5〜2.0 秒）のピーク | -6.05 | -0.96 |
+| 単独区間・前（0.5〜1.3 秒）のピーク | -5.89 | -5.89 |
+| 単独区間・後のピーク | -5.82 | — |
+
+フェードありは重なり区間で両周波数が鳴りつつ、ピークは単独区間を超えない
+（-6.05 対 -5.89 dBFS）。フェードなしは重なり区間のピークが約 4.9 dB 上がる
+（-0.96 dBFS。素材がもっと大きければ 0 dBFS に届き得る）。このためフェードなしの重なりを warning にする。
+
+プレビュー（Web Audio）側の実測は未実施。

package/vendor/docs/contract-2026-08-29-capture-v0.md

@@ -118,6 +118,8 @@ akari capture [-p <project>] (-t <time…> | --auto) [--separate] [--full] [--pe
 
 ## 9. v1 改訂（2026-08-30）— v2 経路への載せ替え
 
+> **現況（2026-09-27）:** 以下の legacy 分岐と非 macOS フォールバックは当時の設計記録。現在の書き出しは全 OS で `auto` が GPU 適格性により GPU / OSR を選び、`--engine legacy` は拒否する。
+
 ### 9.1 なぜ改訂するか（確定事実）
 
 - v0 の実装は `packages/akari-tools/src/capture/run.mjs` が `renderProject(…, { engine: "legacy" })` を**固定**で呼び、

package/vendor/packages/akari-launcher/README.md

@@ -123,6 +123,25 @@ npm i -g akari-video && akari
 npx akari-video
 ```
 
+### akari doctor の cli.node
+
+`akari doctor --json` の `cli.node` は、この CLI を動かしている実行体と、スクリプトを Node として呼ぶ方法を返す。
+
+| フィールド | 意味 |
+|---|---|
+| `exec_path` | 診断を実行した実行体のパス。Electron アプリの EXE になることもある |
+| `electron_run_as_node` | 診断を実行したプロセスの環境変数が `ELECTRON_RUN_AS_NODE=1` だったか |
+| `version` | 実行体の Node のバージョン（Electron では内蔵の Node） |
+| `runtime` | 実行体が `electron` か `node` か |
+| `electron_version` | Electron のバージョン。Node 実行体では `null` |
+| `run_as_node_supported` | Electron 実行体を Node として呼べるか |
+| `required_env` | Node として呼ぶために必要な環境変数。Electron では `{ "ELECTRON_RUN_AS_NODE": "1" }`、Node では `{}` |
+| `invocation` | `shell` は既定シェル、`example` はそのシェル用の呼び方。`cmd` と `sh` は両方常に出る。`<script>` を実際のスクリプトパスに置き換える |
+
+`electron_run_as_node` は診断時の環境だけを表す。Node として使えるかは `runtime`、`run_as_node_supported`、`required_env` で判断する。`runtime` が `electron` なら `required_env` を付けて呼ぶ。Windows の `cmd` では `set "ELECTRON_RUN_AS_NODE=1"` と引用符で囲む。`set ELECTRON_RUN_AS_NODE=1 &&` と書くと末尾の空白が値に入る。
+
+Electron を Node として呼んだプロセスから GUI の Electron を子プロセスとして起動するときは、子へ渡す環境から `ELECTRON_RUN_AS_NODE` を外す。
+
 ## 既知の制約
 
 - npm tarball は追跡済み skills・雛形・schemas と capability source set を `vendor/` に同梱する。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.97",
+  "version": "0.1.99",
   "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. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/asset-resolver/browse/app.js

@@ -89,7 +89,7 @@
     const say = (ok, text) => { msg.className = `msg ${ok ? 'ok' : 'err'}`; msg.textContent = text; };
 
     if (item.state === 'locked') {
-      actions.append(el(`<button class="btn" disabled>未購入（¥${(item.price ?? 0).toLocaleString()}） — ストアで購入してください</button>`));
+      actions.append(el(`<button class="btn" disabled>未購入（¥${(item.price ?? 0).toLocaleString()}） — AKARI Video Lab で購入してください</button>`));
     } else if (item.state === 'cached') {
       actions.append(el('<p class="note">✓ ライブラリに取得済みです。</p>'));
     } else {

package/vendor/packages/asset-resolver/src/resolve.mjs

@@ -118,7 +118,7 @@ export async function resolve(
     const { ids: entitlements } = await fetchEntitlements({ env, fetchImpl });
     if (!entitlements.has(item.id) && !entitlements.has(item.product_id)) {
       throw new AssetResolverError(
-        `未購入の素材です（¥${price.toLocaleString()}）。ストアで購入してから再度お試しください: ${item.id}`,
+        `未購入の素材です（¥${price.toLocaleString()}）。AKARI Video Lab で購入してから再度お試しください: ${item.id}`,
         'locked',
       );
     }
@@ -200,7 +200,7 @@ async function resolvePaidZip(item, { env, fetchImpl, project, reference, home,
   if (!credentials) {
     // entitled 判定（fetchEntitlements）が通った直後にここへ来るので通常は発生しないが、
     // その間にトークンが失効した場合も黙って劣化させず拒否する（fail-closed）。
-    throw new AssetResolverError(`ストア接続情報がありません（トークン失効の可能性）: ${item.id}`, 'locked');
+    throw new AssetResolverError(`AKARI アカウントの接続情報がありません（トークン失効の可能性）: ${item.id}`, 'locked');
   }
 
   await mkdir(home, { recursive: true });

package/vendor/packages/edit-lint/README.md

@@ -78,6 +78,13 @@ non-decreasing `at` order. It does not change the render meaning or fail lint.
 
 `timeline.duration-derived` is an info finding when a project without visual media derives its duration from overlays, captions, narration, or SFX; BGM never extends that fallback duration.
 
+For v2, `at` and `duration` are frames; `source.in`, `source.out`, and fade values are seconds.
+`v2.item-duration-short` warns when a non-audio item is shorter than half a second (excluding
+caption items). `v2.item-duration-source-mismatch` warns when a media item's source interval,
+after speed adjustment, differs from its timeline duration by at least fivefold. The latter
+also applies to audio items but excludes still images and frozen sources. Both are warnings
+and leave the pass/fail verdict unchanged.
+
 ## Engine compatibility (`--engine`)
 
 Before export, check v2 projects against the selected renderer. Use `auto` when engine selection is

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

@@ -204,7 +204,8 @@ export async function lintProject(input, options = {}) {
   if (findings.some(finding => finding.severity === "error")) {
     return writeResult(findings, skipped, inputs, paths, options);
   }
-  const rawEdit = edit;
+  const rawEdit = edit.version === 2 && edit.sources === undefined
+    ? { ...edit, sources: [] } : edit;
   const internalEdit = readEditWithProviderGuidance(rawEdit, { allowCutAudioSplit: true });
   const legacyEdit = projectLegacyEdit(internalEdit);
   if (engineCapabilities !== null && rawEdit.version === 2) {
@@ -1029,7 +1030,7 @@ function validateEditStructure(edit, findings, paths) {
     validateLook(edit.output.look, findings, "edit.json#output.look");
   }
   const sourceIds = new Set();
-  if (!Array.isArray(edit.sources)) {
+  if (!Array.isArray(edit.sources) && !(edit.version === 2 && edit.sources === undefined)) {
     structureFinding(findings, editRelative, "sources must be an array");
   } else {
     for (const [index, source] of edit.sources.entries()) {
@@ -1154,6 +1155,8 @@ function validateEditV2(edit, findings) {
     }
   }
 
+  const fps = edit.output?.fps;
+
   for (const [trackIndex, track] of edit.tracks.entries()) {
     if (!isRecord(track) || !Array.isArray(track.items)) continue;
     const visit = (items, parent, parentPath) => {
@@ -1168,6 +1171,34 @@ function validateEditV2(edit, findings) {
         if (track.lane === "audio" && Object.hasOwn(item, "link")) {
           linkedAudioItems.push({ item, path: `${itemPath}.link` });
         }
+        if (isPositiveNumber(fps) && Number.isInteger(item.duration) && item.duration > 0) {
+          const duration = item.duration;
+          const seconds = (duration / fps).toFixed(2);
+          if (track.lane !== "audio" && item.source?.kind !== "caption"
+            && duration < Math.round(0.5 * fps)) {
+            addFinding(findings, {
+              severity: "warning", check: "v2.item-duration-short",
+              message: `item ${String(item.id)} の duration は ${duration} フレーム（${seconds} 秒）です。at / duration の単位はフレームです。${duration} 秒のつもりなら ${formatNumber(duration * fps)} フレームにしてください（×fps = ${formatNumber(fps)}）。`,
+              path: `${itemPath}.duration`,
+            });
+          }
+          const source = item.source;
+          if (source?.kind === "media" && isFiniteNumber(source.out)
+            && !isStillImageSourcePath(sourcePaths.get(source.src)) && !isRecord(source.freeze)) {
+            const sourceIn = source.in ?? 0;
+            const sourceSeconds = (effectiveSourceOut(item, fps) - sourceIn)
+              / (isPositiveNumber(source.speed) ? source.speed : 1);
+            const timelineSeconds = duration / fps;
+            const ratio = Math.max(sourceSeconds / timelineSeconds, timelineSeconds / sourceSeconds);
+            if (sourceSeconds > 0 && ratio >= 5) {
+              addFinding(findings, {
+                severity: "warning", check: "v2.item-duration-source-mismatch",
+                message: `item ${String(item.id)} の duration ${duration} フレーム（${seconds} 秒）と source の区間 in ${formatNumber(sourceIn)} 秒 〜 out ${formatNumber(source.out)} 秒（${sourceSeconds.toFixed(2)} 秒${isPositiveNumber(source.speed) && source.speed !== 1 ? `・speed ${formatNumber(source.speed)}` : ""}）が ${ratio.toFixed(1)} 倍食い違っています。at / duration はフレーム、source.in / out は秒です。取り違えていないか確かめてください（duration を秒で書いたなら ×fps = ${formatNumber(fps)}）。`,
+                path: `${itemPath}.duration`,
+              });
+            }
+          }
+        }
         if (track.lane === "visual" && item.source?.kind === "media" && item.audio === false
           && (Object.hasOwn(item.source, "gain_db") || Object.hasOwn(item.source, "mute"))) {
           addFinding(findings, {
@@ -1258,6 +1289,7 @@ function validateEditV2(edit, findings) {
       ? track.items.flatMap((item, itemIndex) =>
         isRecord(item) && item.role === "bgm" ? [{
           id: item.id, trackIndex, itemIndex, start: item.at, end: item.at + item.duration,
+          fadeIn: item.fade_in, fadeOut: item.fade_out,
         }] : [])
       : []
   );
@@ -1269,13 +1301,19 @@ function validateEditV2(edit, findings) {
         const start = Math.max(bgmItems[i].start, bgmItems[j].start);
         const end = Math.min(bgmItems[i].end, bgmItems[j].end);
         if (Number.isFinite(start) && Number.isFinite(end) && start < end) {
-          overlaps.push(`${String(bgmItems[i].id)} / ${String(bgmItems[j].id)} [${start}, ${end})`);
+          const [before, after] = bgmItems[i].start <= bgmItems[j].start
+            ? [bgmItems[i], bgmItems[j]] : [bgmItems[j], bgmItems[i]];
+          if (!(before.fadeOut > 0) && !(after.fadeIn > 0)) {
+            overlaps.push({ label: `${String(before.id)} / ${String(after.id)} [${start}, ${end})`, frames: end - start });
+          }
         }
       }
     }
+    const exampleSeconds = overlaps.length && isPositiveNumber(fps)
+      ? formatNumber(Number((overlaps[0].frames / fps).toFixed(2))) : null;
     if (overlaps.length) addFinding(findings, {
-      severity: "error", check: "v2.audio-bgm-multiple",
-      message: `BGM ${bgmItems.map(describe).join('、')}。重なり: ${overlaps.length ? overlaps.join('、') : 'なし'}。BGM の時間が重ならないように配置してください。`,
+      severity: "warning", check: "v2.audio-bgm-multiple",
+      message: `BGM ${bgmItems.map(describe).join('、')}。重なり: ${overlaps.map(overlap => overlap.label).join('、')}。重なった区間は両方の BGM が鳴ります。クロスフェードにするなら、前の item に fade_out（秒）、後の item に fade_in（秒）を付けてください${exampleSeconds !== null ? `（例: 重なり ${formatNumber(overlaps[0].frames)} フレーム = ${exampleSeconds} 秒なら "fade_out": ${exampleSeconds} / "fade_in": ${exampleSeconds}）` : ""}。意図しない重なりなら時間が重ならないように配置してください。（同じトラックの中では重ねられません。別の audio トラックに置いてください）`,
       path: "edit.json#tracks",
     });
   }
@@ -2198,19 +2236,27 @@ function validateSfxTracks(sfx, findings) {
     const hasValidTrack = Object.hasOwn(item, "track") && Number.isInteger(item.track) && item.track >= 0;
     const track = hasValidTrack ? item.track : 0;
     if (!pointsByTrack.has(track)) pointsByTrack.set(track, []);
-    pointsByTrack.get(track).push({ index, t: item.t });
+    pointsByTrack.get(track).push({ index, t: item.t, path: isNonEmptyString(item.path) ? item.path : undefined, track });
   });
   for (const list of pointsByTrack.values()) {
     list.sort((a, b) => a.t - b.t);
+    let groupStart = 0;
     for (let i = 1; i < list.length; i += 1) {
       if (Math.abs(list[i].t - list[i - 1].t) <= EPSILON) {
+        const current = list[i];
+        const samePath = current.path !== undefined
+          && list.slice(groupStart, i).some(previous => previous.path !== undefined && previous.path === current.path);
         addFinding(findings, {
-          severity: "warning",
+          severity: samePath ? "warning" : "info",
           check: "audio.sfx.track-overlap",
-          message: "sfx item shares the same track and t as another sfx item",
-          path: `edit.json#audio.sfx[${list[i].index}]`,
-          range: { start: list[i].t, end: list[i].t },
+          message: samePath
+            ? `効果音 audio.sfx[${current.index}] が同じ track ${current.track}・同じ時刻 ${formatNumber(current.t)} 秒に同じ素材 ${current.path} で置かれています（二重置きの可能性）。意図した重ねなら track を分けてください（書き出しのミックスは track を見ずに全部鳴らしますが、NLE 書き出しは track を NLE のトラック単位にするため同じトラックに重なります）。`
+            : `効果音 audio.sfx[${current.index}] が同じ track ${current.track}・同じ時刻 ${formatNumber(current.t)} 秒に別素材と重なっています。書き出しのミックスは track を見ずに両方鳴らします。重ねるつもりなら track を分けてください（NLE 書き出しは track を NLE のトラック単位にするため、同じトラックに重なります）。`,
+          path: `edit.json#audio.sfx[${current.index}]`,
+          range: { start: current.t, end: current.t },
         });
+      } else {
+        groupStart = i;
       }
     }
   }

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

@@ -225,7 +225,7 @@ function readV2Internal(raw) {
     // 同時表示も表現できない。先に全 visual media アイテムを横断して区間交差を求め、
     // 参加したアイテムを各トラックの build へ同じ集合として渡す。これにより preview / render
     // の両方が、トラックごとに独立した要素を合成できる layers 経路を選ぶ。
-    const overlappingItemIds = computeOverlappingItemIds(edit.tracks.flatMap(track => 'items' in track && track.lane === 'visual' ? [track.items] : []), pathOf);
+    const overlappingItemIds = computeOverlappingItemIds(edit.tracks.flatMap(track => 'items' in track && track.lane === 'visual' ? [track.items] : []), pathOf, chromaKeyOf);
     const contentDurationFrames = edit.tracks.reduce((maximum, track) => 'items' in track && track.lane === 'visual' ? track.items.reduce((trackMaximum, item) => Math.max(trackMaximum, item.at + item.duration), maximum) : maximum, 0);
     const tracks = edit.tracks.map(track => {
         // P0 2026-08-21 render-path-unification (実測で発覚): 'cuts' 経路（concat チェーン）は
@@ -457,7 +457,7 @@ function needsLayersEngine(item, chromaKeyOf, hasOverlappingSibling = false) {
         return true;
     return false;
 }
-function analyzeOverlappingItems(itemGroups, pathOf) {
+function analyzeOverlappingItems(itemGroups, pathOf, chromaKeyOf) {
     const overlapping = new Set();
     const crossTrackEvacuations = [];
     const entries = itemGroups.flatMap((group, trackIndex) => group.items.map(item => ({ item, trackIndex, trackId: group.trackId })));
@@ -497,13 +497,47 @@ function analyzeOverlappingItems(itemGroups, pathOf) {
             }
         }
     }
+    // 各パスの開始時点の集合だけを原因判定に使う。同じ upper に複数の lower が
+    // 重なれば全て記録し、新しく退避した upper は次のパスから原因にする。
+    for (;;) {
+        const newlyEvacuated = new Set();
+        for (let i = 0; i < entries.length; i++) {
+            const { item: lower, trackIndex: lowerTrackIndex, trackId: lowerTrackId } = entries[i];
+            const lowerIsLayer = lower.source.kind === 'media'
+                ? needsLayersEngine(lower, chromaKeyOf, overlapping.has(lower.id))
+                : lower.source.kind === 'telop' || lower.source.kind === 'filter';
+            if (!lowerIsLayer)
+                continue;
+            for (let j = 0; j < entries.length; j++) {
+                const { item: upper, trackIndex: upperTrackIndex, trackId: upperTrackId } = entries[j];
+                if (upperTrackIndex <= lowerTrackIndex || upper.source.kind !== 'media'
+                    || overlapping.has(upper.id) || needsLayersEngine(upper, chromaKeyOf, false))
+                    continue;
+                if (!(lower.at < upper.at + upper.duration && upper.at < lower.at + lower.duration))
+                    continue;
+                newlyEvacuated.add(upper.id);
+                crossTrackEvacuations.push({
+                    itemId: upper.id,
+                    trackId: upperTrackId,
+                    causeItemId: lower.id,
+                    causeTrackId: lowerTrackId,
+                    overlapStartFrames: Math.max(lower.at, upper.at),
+                    overlapEndFrames: Math.min(lower.at + lower.duration, upper.at + upper.duration)
+                });
+            }
+        }
+        if (newlyEvacuated.size === 0)
+            break;
+        for (const id of newlyEvacuated)
+            overlapping.add(id);
+    }
     return { itemIds: overlapping, crossTrackEvacuations };
 }
-function computeOverlappingItemIds(itemGroups, pathOf) {
+function computeOverlappingItemIds(itemGroups, pathOf, chromaKeyOf) {
     return analyzeOverlappingItems(itemGroups.map((items, index) => ({
         items,
         trackId: String(index)
-    })), pathOf).itemIds;
+    })), pathOf, chromaKeyOf).itemIds;
 }
 /**
  * 別 visual track との重なりが原因で upper item が layers へ退避される組を返す。
@@ -513,11 +547,13 @@ function findCrossTrackLayerEvacuations(edit) {
     const raw = toRecord(edit);
     const parsed = (0, edit_v2_1.readEditV2)(raw === undefined ? edit : extractV2MediaCaptionSwitches(raw).input);
     const pathOf = (id) => parsed.sources.find(entry => entry.id === id)?.path;
+    const chromaKeyOf = (id) => parsed.sources.find(entry => entry.id === id)?.chroma_key ?? undefined;
     return analyzeOverlappingItems(parsed.tracks.flatMap(track => track.lane === 'visual' && 'items' in track
         ? [{ items: track.items, trackId: track.id }]
-        : []), pathOf).crossTrackEvacuations;
+        : []), pathOf, chromaKeyOf).crossTrackEvacuations;
 }
-// cuts の winner-take-all が下段を隠してよいのは、上段が全画面を不透明に覆う場合だけ。
+// cuts の winner-take-all が下段を隠してよいのは、上段が全画面を不透明に覆い、下段が全部 cuts の場合だけ。
+// 下段に layers があれば上段 cuts はその下に描かれるため、不動点で上段も退避する（#90）。
 // 全画面不透明なソースで transform の単位元を明示しただけなら従来経路を維持する。crop / 半透明 / keyframes は、
 // 現在または途中フレームで下段が見える可能性があるため宣言の存在だけで layers へ退避する。
 // 加えて、アルファを運べるコンテナ（webm / mov — 本製品のマット生成パイプラインの出力形式）は