akari-video 0.1.62 → 0.1.64

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.62",
+  "version": "0.1.64",
   "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

@@ -1,13 +1,21 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 
-import { resolveLauncherAssets } from "./repo-assets.mjs";
+import { CAPTURE_SCRIPT_RELATIVE, resolveLauncherAssets } from "./repo-assets.mjs";
 
 export async function runCaptureCommand(argv, options = {}) {
   const logError = options.error ?? options.logError ?? ((line) => console.error(line));
   const assets = options.assets ?? resolveLauncherAssets();
   if (!assets.captureScript || !existsSync(assets.captureScript)) {
-    logError("akari capture の実行スクリプトが見つかりません。AKARI Video を再インストールしてください。");
+    // 再インストールで直る欠けではない（同梱漏れは配布物側の問題）。欠けている同梱物と
+    // 探索した置き場を名指しして、報告・切り分けに使える形で止める（issue #74）。
+    const missing = assets.captureScript ?? CAPTURE_SCRIPT_RELATIVE;
+    logError(
+      `akari capture の実行スクリプトが見つかりません: ${missing}`
+      + `（探索先: ${assets.repoRoot ?? "不明"}）。`
+      + "この AKARI Video 配布物に packages/akari-tools/bin/capture.mjs が同梱されていません。"
+      + "バージョンと OS を添えて https://github.com/AkariLabs/akari-video/issues へ報告してください。",
+    );
     return { exitCode: 1 };
   }
 

package/src/repo-assets.mjs

@@ -35,7 +35,8 @@ const BEATMAP_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'bea
 const PROBE_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'probe-frame.mjs');
 const DECISION_LOG_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'decision-log.mjs');
 const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'captions.mjs');
-const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
+// capture-command.mjs のエラー文と apps/shell の同梱テストが同じ相対パスを名指しできるよう export する。
+export const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
 const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
 const EYE_BAR_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'eye-bar.mjs');
 

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

@@ -66,6 +66,7 @@
     "docs/contract-2026-09-05-clip-adjust-v1.md",
     "docs/contract-2026-09-06-cut-audio-split-v0.md",
     "docs/contract-2026-09-06-vgpu-layer-v0.md",
+    "docs/contract-2026-09-12-review-session-viewer.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",

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

@@ -12,6 +12,7 @@
 | 2026-08-28 | v2 | `packages/frame-engine` の意味論へ統合し、検収をゴールデンフレームへ一本化。出口を OSR と GPU 直結の 2 本に固定し、互換経路を退役節へ移動 |
 | 2026-08-31 | v2.1 | §5.2 に断片 CSS の `vw` / `vh` 系単位の出力サイズ基準化（`viewport-units.js`。プレビューがウィンドウ幅基準で解いていた実機報告の修正）を追記 |
 | 2026-09-02 | v2.2 | §2.8 に字幕時計の規約（active cue の判定は両プレビューとも出力秒。共有カーネル `caption-clock`）を追記。Web UI を shell に揃えた 4 点（字幕時計・字幕フォント名・`slot-params.js` の差し込み・最下段 cut の track 規則）の記録 |
+| 2026-09-10 | v2.3 | §5.8 に shell 合成面の内部解像度（auto / 手動倍率・停止時等倍）と構図一致の許容差を追加 |
 
 ## 1. 役割分担
 
@@ -346,3 +347,38 @@ frame-engine が MP4 を全体ストリームとして読むか、`ftyp` / `moov
 Range として読むかは、完成画の意味論に影響しない。どちらの読み込み経路も同じ presentation 時刻の
 VideoFrame を §4.1 の評価点へ供給し、`elst.media_time`、B フレームの並べ替え、メディア終端を含めて
 golden の `diff 0` を満たさなければならない。ソース取得方法の変更をパリティ差の許容理由にしてはならない。
+
+### 5.8 プレビュー内部解像度（render scale）
+
+shell の frame-engine 合成面は、辺あたり倍率 `s ∈ {1, 0.5, 0.25}` を使える。
+設定 `akari.preview.renderScale` の語彙は `'auto' | '1' | '0.5' | '0.25'`、既定は `'auto'`。
+環境変数 `AKARI_FRAME_ENGINE_RENDER_SCALE` は設定より優先し、不正値は `auto` とする。
+設定項目のみとし、専用ボタンやポップアップは設けない。
+
+`auto` は canvas の `getBoundingClientRect()` に `devicePixelRatio` を掛けた表示寸法に対し、
+`output.width × s ≥ 表示幅` かつ `output.height × s ≥ 表示高` を満たす最小の倍率を選ぶ。
+上限は `1`、表示寸法が 0 の場合も `1` とする。canvas の `ResizeObserver` と
+`matchMedia('(resolution: <dpr>dppx)')` の change で再評価し、100 ms デバウンスする。
+内部寸法は各辺を `roundEven(output寸法 × s)`（最寄りの偶数へ丸め、中間は上へ）とし、下限は 2 px。
+
+`auto` では再生停止・スクラブ終了から 250 ms 後に `s = 1` で 1 コマ描き直し、
+再生・スクラブの再開で表示寸法に応じた倍率へ戻す。手動倍率は停止中も固定し、停止による追加描画はしない。
+倍率変更は scheduler・評価 plan・compose が共有する `renderOutput` の width / height を in-place で更新する。
+scheduler を作り直して warmup を捨てず、停止中の寸法更新は 1 コマの再描画へ反映する。
+developerMode の計測パネルに倍率・内部寸法・等倍寸法・モードを 1 行表示する。
+
+エンジンのレイヤー / layer-style cut の幾何は出力 px 基準（box = crop × 素材 px × scale、
+出力中心 + (x, y)）なので、shell は評価 plan の px 基準の transform（x / y、および px 基準の scale）を
+`s` で射影してから合成する。fit 基準の通常 cut の scale と正規化座標は不変とし、入力 plan を変更せず、
+`plan.output` は共有参照を保つ。エンジン・ゴールデン検収・書き出しは不変。
+
+一致条件は**構図一致 = 位置・大きさ・時刻・ツマミ値の一致**であり、内部画素数は異なってよい。
+[vgpu レイヤー契約 §4](./contract-2026-09-06-vgpu-layer-v0.md#4-api解像度ツマミ) の例外を
+shell の合成面全体へ拡張する。等倍の完成画を縮小した画像と縮小倍率で描いた画像を比較し、
+`packages/frame-engine/src/metrics/frame-diff.ts` の MAD で **≤ 2.0 / 255** を要求する。
+粒状ノイズ FX と dissolve 区間はこの比較から除外する。DOM 層（字幕 / overlay / 3D / ペン）、
+`summary.output`、`frameScale`、当たり判定、インスペクター、書き込み経路の規約は不変。
+
+**書き出しとゴールデン検収は常に等倍で、本設定の対象外**。GPU / OSR の page-runtime、
+書き出し receipt、§4.1・§4.2 のゴールデンと許容差、`packages/frame-engine` とその生成バンドルは変更しない。
+Web UI の合成面、デコード解像度、vgpu 固有の `previewScale`、3D の `PREVIEW_3D_MAX_RENDER_SIZE` も対象外とする。

package/vendor/docs/contract-2026-08-11-review-session-ui-events.md

@@ -46,6 +46,7 @@
 | `panel:<id>` | シェルの主要パネル | `panel:assets` / `panel:inspector` / `panel:review` / `panel:timeline` |
 | `tab:<id>` | タブ | `tab:assets-builtin` |
 | `timeline:cut:<n>` | タイムラインのカット（cuts[] index） | `timeline:cut:3` |
+| `timeline:item:<id>` | v2 タイムラインのカット（tracks[].items[].id。compile 時に legacy cuts[] index へ射影） | `timeline:item:cut-4` |
 | `timeline:overlay:<id>` | タイムラインのオーバーレイ | `timeline:overlay:o-0002` |
 | `asset:<path>` | 素材（プロジェクト相対 or カタログ id） | `asset:assets/broll/city.mp4` |
 | `asset:<category>/<id>` | 素材（カタログ由来カード。key = `<category>/<id>`） | `asset:still/br-typing-laptop` |

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

@@ -27,6 +27,7 @@
       "t_end": 12.44,
       "word": "最高",
       "emotion": "joy",
+      "style_preset": "neon",
       "style_hint": "size-pulse"
     }
   ],
@@ -49,11 +50,12 @@
    `captions.json.emphasis_words` へ移す。
 2. `edit.json` v2 へは書かない。v0/v1 の旧席は後方互換の読取専用として残す。
 
-したがって各レコードは `{ id, word, emotion, src?, t_start, t_end, style_hint? }` で、`id` は
+したがって各レコードは `{ id, word, emotion, src?, t_start, t_end, style_preset?, 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` も描画側への
-提案に留まる。
+提案に留まる。`style_preset` は任意で、字幕テンプレと同じ `textstyle-catalog` の id を語の見た目として
+提案する。台本パネルの単語選択から「🎨 テンプレ」を適用すると、この席へ範囲ごとに 1 件を書く。
 
 ## 3. 読取優先順
 
@@ -75,3 +77,21 @@
 語と `captions[].words[]` の実測値の突き合わせは v1 契約と同じく書き手の規律であり、静的検証では
 行わない。
 edit-lint は object ルートの `emphasis_words` を受理し、同じ規則で検証する。
+
+## 5. style_preset の描画
+
+共有字幕カーネルは、`style_preset` を持つ `emphasis_words[]` が投影後の語へ当たった場合にだけ、
+display cue へ `words[]` と `word_styles[]` を追加する。`words[]` は出力秒の `start` / `end`、本文
+`text`、`display_lines` の行番号 `line` を持つ。`word_styles[]` は `words[]` の半開区間 `from` / `to`、
+プリセット id `preset_id`、解決済み CSS 変数 `style_vars` を持つ。時間範囲が語の途中だけと重なる場合も、
+その語全体へ丸める（含む側）。該当語が無い cue には両キーとも追加せず、従来の出力を変えない。
+
+描画 DOM は通常の語を `akari-caption__tok`、プリセット付きの語を
+`akari-caption__tok akari-caption__tok--preset` とし、後者へ `data-emphasis-preset` と解決済み
+`style_vars` のインライン CSS を付ける。shell プレビュー、Web プレビュー、render-cut、gpu-export の
+4 出口はこの同じ規則で描く。台本パネルは語 span の `data-emphasis-preset` を読み取れる形で残し、
+プリセット色と薄い下線だけを表示する。既存の行テンプレチップは維持する。
+
+`style_preset` の無いレコードは従来の `emotion` / `style_hint` 経路のままである。現状、語へ渡す
+`style_vars` は color / font-size / font-weight / line-height / stroke 系だけであり、glow、shadow、
+`letter_spacing`、`text_transform` は未対応とする。

package/vendor/docs/contract-2026-08-23-stroke-persistence.md

@@ -1,7 +1,7 @@
 ---
 lifecycle: implemented
 created: 2026-08-23
-updated: 2026-08-23
+updated: 2026-09-12
 ---
 
 # 注釈ストローク永続表示契約
@@ -20,12 +20,24 @@ updated: 2026-08-23
   変更で座標は変わらない。
 - pointerup 後は従来のグロー・きらめき・600 ms フェードをそのまま再生し、その後段の静的
   ビットマップへ同じ正規化図形を残す。新しい録音セッションの開始時に前セッションの表示を
-  クリアし、録音終了では消さない。
+  クリアし、録音終了では消さない。※ 2026-09-12 改訂（§1.1）
 - 描線 canvas は非描画モードで `pointer-events: none` とする。ペンまたは四角モードのドラッグ中
   だけ既存どおり入力面になる。
 - 注釈パネルの「描線を表示」チェックは既定 ON。OFF は残留描線と明示的に再表示した描線を隠し、
   データを削除しない。ON に戻すと保持した正規化座標から即時再描画する。
 
+### 1.1 表示の寿命（2026-09-12 追記）
+
+- 描線はプレイヘッド近傍表示とする。録音中は `recT - recTEnd`、録音外の再表示では
+  `|playheadT - frame.timelineT|` を距離として、直近または近傍の複数描線だけを表示する。
+- 表示規則の単一正本は `PEN_TUNING.visibleWindowSec`（既定 8 秒）と
+  `PEN_TUNING.fadeOutMs`（既定 1500 ms）である。時間窓内は不透明とし、窓を超えた描線は
+  `fadeOutMs` をかけて薄れて非表示になる。
+- `fadeOutMs` は表示寿命のための値であり、pointerup 直後のきらめきと描き味を担う既存の
+  `fadeDurationMs`（600 ms）とは別物である。
+- 録音停止時は画面上の表示プールをクリアするが、記録側の `strokes.json` は変更しない。
+  録音済みセッションの描線は再表示できるため、手動のクリアボタンは設けない。
+
 ## 2. 既存セッションの読み出しと再表示
 
 `readReviewSessionStrokes({projectRootUri, sessionId})` は

package/vendor/docs/contract-2026-09-12-review-session-viewer.md

@@ -0,0 +1,97 @@
+---
+lifecycle: draft
+created: 2026-09-12
+updated: 2026-09-12
+---
+
+# レビューセッション見返しビューア契約
+
+- 日付: 2026-09-12
+- 状態: draft
+- 前提: `contract-2026-08-11-review-session-ui-events.md`、
+  `contract-2026-08-23-stroke-persistence.md`
+- スコープ: 録音時計 `recT` を基準にした音声・出力プレビュー・描線・文字起こしの同期表示と、
+  録音時点の `edit.snapshot.json` と現在の `edit.json` の差分表示
+
+## 0. 版と互換
+
+本機能は `review/sessions/s-NNNN/` の原本の形を変えず、すべて読むだけで扱う。欠けたファイル、
+壊れた行、未知フィールドは警告または情報なしへ縮退させ、既知の残りを表示する寛容リーダーとする。
+記録原本、manifest、edit.json の migration や書き戻しは行わない。
+
+## 1. `readReviewSessionBundle` 読み出し口
+
+入力は次のとおり。
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `projectRootUri` | `string` | ワークスペース内のプロジェクトルート URI |
+| `sessionId` | `string` | `s-NNNN` 形式のセッション ID |
+
+出力は次のとおり。
+
+| フィールド | 型 | 意味 |
+|---|---|---|
+| `sessionId` | `string` | 読み出したセッション ID |
+| `audioUri` | `string \| null` | `audio.wav` の file URI。欠落時は `null` |
+| `audioDurationSec` | `number` | WAV ヘッダから得た録音尺。読めなければ `0` |
+| `events` | `ReviewSessionEvent[]` | 有効行を `recT` 昇順で安定ソートしたイベント |
+| `strokes` | `ReviewStroke[]` | 既存の寛容な strokes リーダーが返す描線 |
+| `transcript` | `ReviewSessionTranscriptSegment[] \| null` | 発話列。未コンパイル時は `null` |
+| `proposals` | `ReviewSessionProposalSummary[] \| null` | 対象解決の表示用要約。欠落時は `null` |
+| `editSnapshotText` | `string \| null` | 8 MiB 以下の snapshot 生テキスト |
+| `warnings` | `string[]` | 読み飛ばした原本・行の説明 |
+
+入口の不正 ID、ワークスペース外、セッションディレクトリ不在だけは例外とする。それ以外の欠落・
+破損は残りを返し、原本へ書き込まない。
+
+## 2. `recT` から `timelineT` への写像
+
+状態は `{playing, anchorTimelineT, anchorRecT, rate}` とし、位置を次で求める。
+
+`playing ? anchorTimelineT + (recT - anchorRecT) * rate : anchorTimelineT`
+
+| イベント | anchor と状態の更新 |
+|---|---|
+| `start` | `timelineT` / `recT` を anchor、`playing` を記録値、`rate=1` |
+| `play` | 先に現位置を求め、有効な `timelineT` または現位置を anchor、`playing=true` |
+| `pause` | 有効な `timelineT` または現位置を anchor、`playing=false` |
+| `seek` | `to` を timeline anchor、イベント `recT` を rec anchor にする |
+| `rate` | 先に現位置を anchor にし、正の `value` を rate にする |
+| `tick` | イベント `timelineT` / `recT` で anchor を打ち直す |
+| `end` | 有効な `timelineT` または現位置を anchor、`playing=false` |
+
+この意味論は `compile-review-session` の時刻写像と同一である。ビューアは `audio.currentTime` を
+`recT` の正本とし、出力プレビューへの seek は既存の requestAnimationFrame 経路で間引く。
+
+## 3. 描線の再表示
+
+描線の寿命と薄れ方は `contract-2026-08-23-stroke-persistence.md` および
+`PEN_TUNING.visibleWindowSec` を正本とする。ビューアはセッションの描線をプレビューへ attach し、
+録音プレイヘッドを動かし、閉じると detach するだけである。描画規則や原本は変更しない。
+
+## 4. 文字起こしと対象表示
+
+`transcript.json` があれば発話単位で並べ、現在の `recT` に該当する発話を強調する。発話クリックは
+その開始 `recT` へシークする。`compile-proposals.json` は発話と同じ index で突き合わせ、
+`target`、`sourceT`、low confidence の要確認表示を添える。本票は人間が解決結果を目視確認する
+表示のみで、対象を修正する UI は次段とする。未コンパイル時の導線は定型文をコピーするだけで、
+compile 自体を実行しない。
+
+## 5. `edit.snapshot.json` との差分
+
+両文書を `readInternalEdit` で読み、全 track の item と再帰的な children を ID で突き合わせる。
+表示する変化は追加、削除、`at` の移動、`duration` の尺変更、media source の `in/out` の素材区間変更の
+5 種である。1 item に複数の変化があれば別々に表示する。v0 / v1 snapshot は「旧形式のため差分を
+出せない」と明示し、migrate しない。
+
+## 6. 映像
+
+映像面には現在の `edit.json` の出力プレビューを使う。当時の素材や映像を探索・復元しない。
+
+## 7. 非目標
+
+- audio、events、strokes、snapshot、transcript、proposals の書き換え
+- compile の実行や文字起こし生成
+- compile の対象解決や注釈内容の編集
+- 当時の映像・素材の復元

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.62",
+  "version": "0.1.64",
   "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/edit-lint/README.md

@@ -42,15 +42,26 @@ item. Each source is probed once, and media finding paths include the source ID.
   warnings unless `--silence-error-seconds` promotes long intervals to errors.
 - `media.volume`: reports mean and maximum volume. Findings are warnings unless
   `--max-volume-error-db` promotes an over-limit maximum to an error.
+- `media.source-range`: errors when a media item asks for a span the source does not have. Every
+  lane is covered (visual cuts, `bgm` / `narration` / `sfx` items, nested bag items) plus the v1
+  `audio.*` declarations, and the container duration is used so sources without an audio stream are
+  checked too. `source.in` at or beyond the duration and an effective `source.out` past the duration
+  are both errors; sources whose container duration is unavailable are skipped with a reason.
 - `media.audio-shorter-than-out`: warns for each visual media item whose effective source `out`
-  exceeds that source's audio-stream duration. The message includes the missing duration.
+  exceeds that source's audio-stream duration while staying inside the container duration (the
+  source plays but its audio ends early). The message includes the missing duration. Items that run
+  past the container duration are reported by `media.source-range` instead.
 - `media.caption-silence-coverage`: warns when more than 30% of caption display time overlaps a
   silence interval of at least one second. `--caption-silence-warn-percent` changes the threshold.
 - `audio.narration.trim`: warns when a narration media item's `in` is at or beyond its audio-stream
-  duration. Invalid or reversed narration `in`/`out` values are errors even without `--media`.
+  duration but still inside the container duration. Invalid or reversed narration `in`/`out` values
+  are errors even without `--media`; an `in` past the container duration is a `media.source-range`
+  error.
 
 Silence and volume checks are skipped for a source without an audio stream or when ffprobe cannot
 inspect it. Duration-dependent checks are skipped when the audio-stream duration is unavailable.
+One ffprobe invocation per source path reads both the container duration and the first audio
+stream's duration.
 Caption/silence coverage runs only when the captions can be associated with exactly one referenced
 visual source: either every caption declares the same `src`, or the timeline references a single
 visual source and captions do not contradict it. Missing, empty, or multi-source/ambiguous captions