akari-video 0.1.30 → 0.1.32

package/README.md

@@ -52,20 +52,6 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）。
 
-### Chrome の導入
-
-動画の書き出しに使う Chrome for Testing は、次のコマンドで導入できる。
-
-```sh
-akari chrome install
-akari chrome install --cache-dir /path/to/cache
-akari chrome install --build-id 150.0.7339.16
-```
-
-保存先の既定は `~/.cache/puppeteer`。`--cache-dir` で保存先、`--build-id` で導入する
-buildId を指定できる。実行環境から `@puppeteer/browsers` を解決できる必要があり、
-AKARI Video アプリの配布物には必要なモジュールが同梱されている。
-
 `akari` に渡した引数はそのまま `opencode` に転送する（例: `akari --continue` は
 `opencode --continue` を起動する）。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "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,7 +1,5 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { pathToFileURL } from "node:url";
 
 import { resolveLauncherAssets } from "./repo-assets.mjs";
 
@@ -13,15 +11,6 @@ export async function runCaptureCommand(argv, options = {}) {
     return { exitCode: 1 };
   }
 
-  const isHelp = argv.includes("--help") || argv.includes("-h");
-  if (!isHelp && captureNeedsChrome(argv, options.platform ?? process.platform)) {
-    const browser = await resolveBrowserDiagnostics(assets, options);
-    if (!await browser.findChromePath()) {
-      logError(await browser.describeChromeNotFound());
-      return { exitCode: 1 };
-    }
-  }
-
   const spawn = options.spawn ?? spawnSync;
   const result = spawn(process.execPath, [assets.captureScript, ...argv], {
     stdio: "inherit",
@@ -29,27 +18,3 @@ export async function runCaptureCommand(argv, options = {}) {
   });
   return { exitCode: typeof result.status === "number" ? result.status : 1 };
 }
-
-export function captureNeedsChrome(argv, platform = process.platform) {
-  let engine = "auto";
-  for (let index = 0; index < argv.length; index += 1) {
-    if (argv[index] === "--engine" && argv[index + 1] !== undefined) engine = argv[index + 1];
-    else if (argv[index].startsWith("--engine=")) engine = argv[index].slice("--engine=".length);
-  }
-  return engine === "legacy" || (engine === "auto" && !["darwin", "win32"].includes(platform));
-}
-
-async function resolveBrowserDiagnostics(assets, options) {
-  if (options.findChromePath && options.describeChromeNotFound) {
-    return {
-      findChromePath: options.findChromePath,
-      describeChromeNotFound: options.describeChromeNotFound,
-    };
-  }
-  const modulePath = join(assets.repoRoot, "packages", "render-cut", "src", "render-cut.mjs");
-  const module = await import(pathToFileURL(modulePath).href);
-  return {
-    findChromePath: options.findChromePath ?? module.findChromePath,
-    describeChromeNotFound: options.describeChromeNotFound ?? module.describeChromeNotFound,
-  };
-}

package/src/cli.mjs

@@ -22,7 +22,6 @@ import {
   triggerBackgroundRefresh
 } from './update-check.mjs';
 import { applySelfUpdate, isRunningFromAppDir, rollbackSelfUpdate } from './self-update.mjs';
-import { runChromeCommand } from './chrome-command.mjs';
 import { runCaptureCommand } from './capture-command.mjs';
 import { runMediaCommand } from './media-command.mjs';
 import { resolveRuntimePaths } from './runtime-diagnostics.mjs';
@@ -37,7 +36,12 @@ import { resolveRuntimePaths } from './runtime-diagnostics.mjs';
  * options 経由で差し替え可能にしてあり、node --test から実プロセスを起動せずに分岐を検証できる。
  */
 export async function run(args, options = {}) {
-  if (args[0] === 'chrome') return runChromeCommand(args.slice(1), options);
+  const retiredBrowserCommand = 'chrome';
+  if (args[0] === retiredBrowserCommand) {
+    const error = options.error ?? ((line) => console.error(line));
+    error(`akari ${retiredBrowserCommand} は廃止されました（Chrome は不要になりました）`);
+    return { exitCode: 1 };
+  }
   if (args[0] === 'capture') return runCaptureCommand(args.slice(1), options);
   if (args[0] === 'media') return runMediaCommand(args.slice(1), options);
 

package/src/doctor-command.mjs

@@ -35,7 +35,6 @@ export function formatDoctorReport(report) {
     ['edit_lint', report.edit_lint.origin, report.edit_lint.path ?? '見つかりません'],
     ['ffmpeg', report.ffmpeg.origin, report.ffmpeg.path ?? '見つかりません'],
     ['ffprobe', report.ffprobe.origin, report.ffprobe.path ?? '見つかりません'],
-    ['chrome', report.chrome.found ? 'found' : 'missing', report.chrome.path ?? report.chrome.cache_dir],
     ['gpu_export', report.gpu_export?.available ? 'ok' : 'unavailable', report.gpu_export?.reason ?? '診断情報がありません'],
     ['path', report.path.on_path ? 'ok' : 'missing', report.path.cli_shim_dir],
   ];

package/src/messages.mjs

@@ -326,7 +326,6 @@ export function describeCliHelp() {
     '  (引数なし)              プロジェクトを開いて AI エージェントを起動（未作成なら自動作成）',
     '  store connect          アカウント連携（無料の素材パックと購入済み素材が使えるようになる）',
     '  sounds                 公式音源ライブラリを一括ダウンロード（無料）',
-    '  chrome install         動画書き出しに使う Chrome をダウンロードして導入する',
     '  doctor [--json]        必須部品の実在と解決元を診断する',
     '  update [--force]       更新を確認する（--force で install.sh 経路の本体を入れ直す）',
     '  status                 接続状態を確認する',

package/src/runtime-diagnostics.mjs

@@ -1,9 +1,7 @@
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import { homedir } from 'node:os';
+import { existsSync, readFileSync } from 'node:fs';
 import path, { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { resolveChromeCacheDir } from './chrome-command.mjs';
 import { findExecutable } from './path-lookup.mjs';
 import { readInstalledAppVersionInfo, readOwnVersion, resolveAkariHome } from './update-check.mjs';
 
@@ -133,7 +131,6 @@ export async function resolveDoctorReport(options = {}) {
   const pathExt = env.PATHEXT ?? process.env.PATHEXT;
   const runtime = resolveRuntimePaths(options);
   const mediaBin = await resolveMediaTools({ ...options, env, platform, pathEnv, pathExt });
-  const chrome = await resolveChromeInstallation({ ...options, env });
   const gpuExport = await resolveGpuExportAvailability({ ...options, env, platform });
   const akariHome = resolveAkariHome(env);
   const cliShimDir = join(akariHome, 'cli', 'bin');
@@ -150,7 +147,6 @@ export async function resolveDoctorReport(options = {}) {
     ...runtime,
     ffmpeg: mediaBin.ffmpeg,
     ffprobe: mediaBin.ffprobe,
-    chrome,
     gpu_export: gpuExport,
     path: {
       cli_shim_dir: cliShimDir,
@@ -234,48 +230,6 @@ function resolveMediaTool(name, resolver, options) {
   return executable ? { path: executable, origin: 'path' } : { path: null, origin: 'none' };
 }
 
-async function resolveChromeInstallation(options) {
-  const cacheDir = resolveChromeCacheDir(options.homeDirectory ?? homedir(), options.chromeCacheDir);
-  try {
-    const browsers = options.loadBrowsers
-      ? await options.loadBrowsers()
-      : await import('@puppeteer/browsers');
-    if (typeof browsers.Cache === 'function') {
-      const installed = new browsers.Cache(cacheDir).getInstalledBrowsers();
-      const chrome = installed.find((entry) => entry.browser === 'chrome' && existsSync(entry.executablePath));
-      if (chrome) return { found: true, path: resolve(chrome.executablePath), cache_dir: cacheDir };
-    }
-  } catch {
-    // optional dependency が無くても既定キャッシュ規約の直接探索で診断を続ける。
-  }
-  const executable = findChromeExecutable(cacheDir);
-  return { found: executable !== null, path: executable, cache_dir: cacheDir };
-}
-
-function findChromeExecutable(cacheDir) {
-  const executableNames = new Set(['chrome', 'chrome.exe', 'Google Chrome for Testing']);
-  const walk = (directory, depth) => {
-    if (depth > 7) return null;
-    let entries;
-    try {
-      entries = readdirSync(directory, { withFileTypes: true });
-    } catch {
-      return null;
-    }
-    for (const entry of entries) {
-      const candidate = join(directory, entry.name);
-      if (entry.isFile() && executableNames.has(entry.name)) return resolve(candidate);
-    }
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const found = walk(join(directory, entry.name), depth + 1);
-      if (found) return found;
-    }
-    return null;
-  };
-  return walk(cacheDir, 0);
-}
-
 function pathContains(pathEnv, directory, platform) {
   const delimiter = platform === 'win32' ? ';' : path.delimiter;
   const normalize = (value) => {
@@ -308,7 +262,6 @@ function doctorNextSteps(report) {
   }
   if (report.ffmpeg.origin === 'none') steps.push('ffmpeg を導入し、PATH または AKARI_FFMPEG_BIN で参照できるようにしてください。');
   if (report.ffprobe.origin === 'none') steps.push('ffprobe を導入し、PATH または AKARI_FFPROBE_BIN で参照できるようにしてください。');
-  if (!report.chrome.found) steps.push('Chrome が未導入です。`akari chrome install` を実行してください。');
   if (!report.path.on_path && report.render_cut.origin !== 'monorepo') {
     steps.push('`~/.akari/cli/bin` を PATH に追加してください。');
   }

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

@@ -1,5 +1,7 @@
 # レンダー基礎機能契約（速度 / クロマキー背景置換 / 基本トランジション / LUT / 音声マスター処理 / 画角操作 / フリーズ）
 
+> **2026-09-01 終了注記:** ffmpeg フィルタグラフ合成は #130d で退役した。以下の ffmpeg 実装記述は参照記録として残す。
+
 - 日付: 2026-07-22（2026-08-06 追記: #6 画角操作 / #7 フリーズを増築。2026-08-09 追記:
   `layers[].keyframes` への一般化を §4-4 に追記）
 - 状態: **draft**（実装と並走で approved 化）。本書は技術仕様のみ。
@@ -40,8 +42,7 @@
    素の色のまま合成されて、窓の継ぎ目で肌色が食い違った。「プロジェクト全体の色」だと
    誤解しやすいため、ここに明記する。
 4. **書き出しエンジンの既定（2026-08-28 改訂）**: `--engine` 省略時は `auto`。
-   darwin / win32 では適格なら GPU、不適格なら OSR、linux では legacy に解決する。従来経路へ戻す場合は
-   `render-cut --engine legacy` を明示する。
+   全 platform で適格なら GPU、不適格なら OSR に解決する。`legacy` は廃止済み。
 
 ### 2-4. reveal 系トランジション（`reveal-down` / `reveal-up`。2026-08-14 追加）
 
@@ -133,7 +134,7 @@ perspective のレイヤー分割フォールバック — perspective は `crop
   transform キーフレーム無し、キーフレーム rotate が非 0、rotate が時間変化する構成は、rotate
   ステップが実際に出るため従来互換経路を維持する。
 
-## 5. macOS の字幕レンダ用 Chrome 起動（2026-08-24 追記）
+## 5. 退役済みブラウザラスタライズの参照記録（2026-09-01 終了）
 
 - macOS では `.app` 内の Chrome 実行ファイルを子プロセスとして直接起動しない。書き出し専用の
   一意な `user-data-dir` を作り、`/usr/bin/open -na <Chrome.app> --args` で LaunchServices

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

@@ -61,6 +61,12 @@ cut 境界の選択は宣言順ではなく解決済みタイムラインと z-o
   指定補間を使う。
 - `cuts[].transform` は出力中央を基準に scale、rotate、x / y を適用し、`opacity` は合成前の alpha に掛ける。
 - framing と transform は一つの評価グラフで順序を固定する。器の CSS pivot や要素箱へ意味論を委ねない。
+- v2 media item（edit-store が `cuts` へ投影するもの）の `crop`（静的）と `keyframes[]` の `transform` / `crop` /
+  `opacity` は **layer-style**（ソース実寸 × scale の box、crop 窓、box 中心の rotate。§2.3 の layer と同じ幾何）で
+  評価し、frame-engine の base 経路が GPU / OSR 書き出しへそのまま描く（issue #39・2026-09-01）。`keyframes[].t` は
+  cut の出力ローカル秒（freeze 中も進む）。`crop` / `perspective` / 2 点以上の `keyframes` を持たない cut は従来の
+  fit 基準のままバイト同一。`perspective` は base 経路では未適用で、
+  `cut <id>: perspective is not applied by the frame-engine base path yet (issue #39)` を warning に出す（無警告で捨てない）。
 - `freeze = {at_sec, duration_sec}` は指定 frame を保持し、cut の出力尺を `duration_sec` だけ伸ばして
   後続の逐次 cut を移動する。freeze の画と独立音声予定表を混同しない。
 
@@ -151,6 +157,8 @@ SHA-256 一致を要求する。GPU は同一マシン一致率を診断値と
 | 時刻 `T`、cuts、gap、track | ✅ 評価 | ✅ 呼び出し・提示 | ✅ 呼び出し・提示 | ✅ 連番駆動 | ✅ 連番駆動 |
 | framing / transform / opacity / freeze | ✅ 評価 | ✅ 完成 frame を提示 | ✅ 完成 frame を提示 | ✅ 完成 frame を捕捉 | ✅ canvas を直結 |
 | layers / perspective / keyframes | ✅ 評価 | ✅ 完成 frame を提示 | ✅ 完成 frame を提示 | ✅ 完成 frame を捕捉 | ✅ canvas を直結 |
+| cuts の crop / transform / opacity keyframes（v2 media item・layer-style） | ✅ 評価（2026-09-01） | 🟡 `public/frame-engine.bundle.js` の再生成待ち | ✅ DOM 層（`applyLayerStyleMediaLayout`） | ✅ 完成 frame を捕捉 | ✅ canvas を直結 |
+| cuts の perspective | 🟡 未適用・warning のみ（issue #39） | 🟡 同左 | ✅ DOM 層 | 🟡 warning を run.json へ | 🟡 warning を run.json へ |
 | 5 transitions | ✅ 評価 | ✅ 完成 frame を提示 | ✅ 完成 frame を提示 | ✅ 完成 frame を捕捉 | ✅ canvas を直結 |
 | matte / chroma key | ✅ 評価 | ✅ stamp 同期 | ✅ stamp 同期 | ✅ stamp 同期・捕捉 | ✅ 同一 frame 評価 |
 | LUT / `bt709-limited` | ✅ 評価 | ✅ 提示 | ✅ 提示 | ✅ 捕捉・encode | ✅ LUT 後 canvas を直結 |
@@ -204,7 +212,9 @@ OSR の比較は H.264 を再 decode した画像ではなく捕捉時の raw BG
 ### 4.3 互換経路の残置と退役スケジュール
 
 Web UI と shell に残る `<video>` ベースのプレビュー、および render-cut の ffmpeg filtergraph による
-legacy 合成経路は、移行中の既存利用者と Windows を支えるための**互換期間の残置**である。どちらも
+> **2026-09-01 退役:** 以下の互換期間の記述は履歴記録であり、現在の書き出し出口は GPU / OSR のみ。
+
+legacy 合成経路は、移行中の既存利用者と Windows を支えるための**互換期間の残置**だった。どちらも
 エンジン意味論や完成画の仕様の正本ではない。
 
 - `<video>` ベースの二つの互換プレビューは、各器で frame-engine が既定になった後 **2 リリース**保持する。

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

@@ -47,6 +47,62 @@ positive `duration_sec`, a non-empty CSS `ease`, and a positive `amp`; `ease` an
 selected recipe, and `loop` repeats it for the caption lifetime. The single-line sequential policy
 continues to disable caption animation as specified above.
 
+### 1.2 Reference-height scaling for zone captions (2026-09-01, issue #40 §2)
+
+The shared `textStyle` contract accepts an optional `reference_height_px` (integer >= 1) in both
+`default_text_style` and `captions[].text_style`; the cue-level value overrides the default field by
+field like every other text-style field. It declares that the pixel fields of that text style were
+written for an output whose height is `reference_height_px`. The kernel resolves
+
+`scale = output.height / reference_height_px` (omitted: `scale = 1`)
+
+and multiplies every declared pixel field by it. The reference is the output *height* because type
+size is a vertical quantity, so the same declaration stays natural for portrait outputs. Without a
+declaration nothing changes: an existing project renders byte-identical CSS variables (the zone path
+kept `scale = 1` before this contract, which is why a 720p `size_px: 36` came out at one third of the
+frame height on a 4K export).
+
+`reference_height_px` and `layout` (reference-pixel) are mutually exclusive. The exclusion is enforced
+three times in the same shape as `zone` + `layout`: `captions.schema.json`
+(`allOf: [{ not: { required: ["layout", "reference_height_px"] } }]`), the kernel
+(`STYLE_LAYOUT_CONFLICT` from `validateCaptionTextStyle`, `mergeCaptionDisplayStyles`, and
+`resolveCaptionStyleForOutput`), and edit-lint (`captions.text-style`). `layout` keeps its own
+`output.width / reference_width_px` scale unchanged. When `reference_height_px` is present and
+`output.height` is unknown, the kernel fails with `INVALID_OUTPUT_GEOMETRY`, the same code the
+reference-pixel path uses.
+
+Scaled fields are exactly the fields that produce CSS `px`. Fields declared in `em`, `%` / `pct`,
+frame ratios, or unitless factors are untouched. Renderer defaults that stand in for an omitted field
+(the 1.5px stroke, the 40px glow spread, the 38px default font size) are not declarations and are not
+scaled, matching the reference-pixel path.
+
+| Field | CSS variable | Scaled |
+|---|---|---|
+| `size_px` | `--caption-font-size` | yes |
+| `stroke.width_px` | `--caption-webkit-text-stroke` / `--caption-text-shadow` (kernel), `--caption-stroke` (render-cut) | yes |
+| `shadow.blur_px`, `shadow.distance_px` | `--caption-text-shadow` | yes |
+| `glow.spread`, `glow.offset_x`, `glow.offset_y` | `--caption-text-shadow` | yes |
+| `background.radius_px` | `--plate-radius` / `--plate-block-radius` / `--plate-ext-radius` | yes |
+| `background.padding_px` | `--plate-pad-x` / `--plate-pad-y` / `--plate-ext-width` / `--plate-ext-height` | yes |
+| `background.offset_x`, `background.offset_y` | `--plate-offset-x` / `--plate-offset-y` | yes |
+| `letter_spacing_em` | `--caption-letter-spacing` (`em`) | no |
+| `max_width_pct`, `background.width_pct`, `background.height_pct` | `--caption-line-max-width` / `--plate-ext-*` (`%`) | no |
+| `line_height`, `shadow.opacity`, `shadow.angle_deg`, `glow.density`, `background.opacity` | unitless | no |
+| `position.x`, `position.y` | frame ratio 0..1 | no |
+
+The scale has one definition, `resolveCaptionReferenceScale` in
+`packages/edit-store/src/caption-display.ts` (with `scaleCaptionPx`, which rounds a scaled value to
+six decimals and returns the input untouched at `scale = 1`). `resolveCaptionStyleForOutput` applies
+it to the fields the kernel emits (`size_px`, `stroke.width_px`, `background.radius_px`);
+`packages/render-cut/src/captions.mjs` `captionTextStyleVars(style, output)` applies the same scale
+to every field in the table for the zone rail that both the GPU page builder and the OSR page builder
+consume through `generateCaptionOverlays`, so both export engines see the same effective pixels; the
+GPU sprite manifest's `emPx` is read back from that `--caption-font-size`, not from the raw `size_px`.
+Real-render evidence (task 2026-09-01-caption-style-reference-scale): one caption declared with
+`size_px: 36` / `reference_height_px: 720` measures the same 4.72% of the frame height at 1280×720 and
+at 3840×2160 (34 px and 102 px), while the same caption without the declaration measures 1.57% at
+3840×2160 (the pre-contract behaviour).
+
 ## 2. Encoding resolution
 
 `output.encoding` accepts `quality: master|high|standard|light` and

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

@@ -6,9 +6,8 @@ updated: 2026-08-18
 
 # v1 レンダー経路パリティ契約 — cuts[].at / cuts[].track
 
-> **互換期間の注記（2026-08-28）:** 本書は render-cut の legacy 合成経路にだけ適用する契約であり、
-> エンジン v2 の意味論や出口の正本ではない。Windows の OSR 移行条件が成立するまで有効とし、
-> legacy 経路を削除する #100b で本契約も廃止する。
+> **終了注記（2026-09-01）:** 本書が対象とした ffmpeg 合成経路は #130d で退役した。
+> 実装記述は参照記録として残す。
 
 - 日付: 2026-08-18
 - 状態: **ドラフト**（実装と同時に確定させる）

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

@@ -105,8 +105,8 @@ SVG の入力は data URL に固定する。Blob URL と同一オリジン HTTP
 2 走一致、製品経路の読み戻し 0 を要求する。性能 gate は cue ラスタ p50 500 ms 以下、karaoke 44 cue の
 akari-video-pv 18 ms/コマ以下、小 fixture（360 コマ・3 cue）の RSS peak 900 MB 以下とする。
 
-`--engine auto` は macOS / Windows で全件適格なら `gpu`、不適格なら `osr` を選ぶ。Linux の `auto` は
-`legacy` を維持する。明示 `--engine gpu` と不適格の組み合わせは理由を全件表示して fail-closed とし、
+`--engine auto` は全 platform で全件適格なら `gpu`、不適格なら `osr` を選ぶ。明示
+`--engine gpu` と不適格の組み合わせは理由を全件表示して fail-closed とし、
 黙って OSR へ変更しない。GPU launcher が利用できない明示指定も fail-closed とする。
 
 ## 3. 合成順と LUT
@@ -135,18 +135,28 @@ raw frame 読み戻しではない。
 
 ## 5. エンコード、mux、音声
 
-映像は H.264 `avc1.640028`、2 秒ごとの keyframe とし、製品は hardware preference、
+映像は H.264 High profile とし、level は解像度・fps・ビットレートを満たす最小値を H.264 Table A-1
+（MaxFS / MaxMBPS / MaxBR × 1.25）から導出する。下限は Level 4.0 で、1080p30 = `avc1.640028`（従来と
+バイト同一）、1080p60 = `avc1.64002a`、1440p30 = `avc1.640032`、4K30 = `avc1.640033`、4K60 = `avc1.640034`。
+`codec` オプションで明示の文字列に上書きできる（2026-09-01 改訂。固定 `avc1.640028` は Blink の
+`VerifyCodecSupportStatic` が MaxFS 8192 MB 超を拒否するため、1440p / 4K が HW / SW を問わず全 OS で
+`isConfigSupported=false` になっていた — 2026-08-29 調査 §5-4）。
+2 秒ごとの keyframe とし、製品は hardware preference、
 `--soft` は software preference を指定する。ビットレートは render-cut の quality プリセットにある
-GPU ビットレート値（mac では VideoToolbox 用の値と共用）を正本とし、`high = 12 Mbps`、
-`standard = 8 Mbps`、`light = 5 Mbps` とする。
-`--bitrate` の明示値は quality より優先する。`master` は VideoToolbox ビットレートを宣言しないため、
+GPU ビットレート値（mac では VideoToolbox 用の値と共用）を正本とし、**1080p（1920×1080）基準**で
+`high = 12 Mbps`、`standard = 8 Mbps`、`light = 5 Mbps` とする。出力ピクセル数が 1080p を超えるときは
+その比で増やし（4K = 4 倍で `high = 48 Mbps`、1440p ≈ 1.78 倍、100 kbps 単位に丸め）、基準未満は 1 倍に
+留める（2026-09-01 改訂。receipt の `bitrateSource` は `quality-preset-scaled`）。
+`--bitrate` の明示値は quality より優先し、スケールしない。`master` は VideoToolbox ビットレートを宣言しないため、
 GPU 出口では `--bitrate` が無ければ理由付きで fail-closed にする。
 
-エンコード済み Annex B sample を main process へ渡し、
-SPS/PPS または decoder config から avcC を作って mp4box へ直接格納する。追加の映像 process は起動しない。
-MP4 の時刻は timescale 1,000,000 上で各境界を `round(frameIndex × timescale / fps)` として求め、
-各 sample duration を隣接境界の差にする。track の `duration` / `media_duration` は全 sample duration の
-総和、すなわち `round(frames × timescale / fps)` と一致させ、1 コマ尺の丸めを累積してはならない。
+エンコード済み Annex B sample を main process へ渡し、逐次 muxer が SPS/PPS または decoder config から
+avcC を作って `out.mp4` へ直接書き足す。映像の仮ファイルも追加の映像 process も作らない。
+MP4 の timescale は `frameRateRational(fps)` が返すレート分子、1 コマは同じ関数が返す分母ティックとし、
+track duration は `frames × frameTicks` にする。dts = cts とし、ctts は持たない。
+`frames` から計算した上界の `free` 箱を `ftyp` の直後に予約し、finish で moov をその先頭へ上書きして
+余りを `free` として残す。mdat は先頭から 64-bit largesize、サンプル位置は co64 で表し、本文を移動せず
+moov を mdat より前に置く。2026-09-01 改訂。#37（ffmpeg remux・2026-08-31〜09-01）を経てこの形へ移行した。
 
 GPU 映像は video-only である。現行の正典 audio filtergraph が入力 0 の音声を読めるよう、元の cut 音声を
 copy し、音声がない場合は `frames / fps` 秒の無音 carrier を付ける。以後の mux は `-c:v copy` と
@@ -175,7 +185,7 @@ GPU と OSR の decode 比較は、engine-only 区間の per-frame MAD 1.0 以
   "provenance": {
     "engine": "gpu",
     "launcher_tier": 2,
-    "mux": "mp4box-direct",
+    "mux": "incremental-mp4",
     "video_reencode": false
   },
   "gpu": {
@@ -211,8 +221,7 @@ OSR receipt と同じ warning/hard-stop 語彙を使う。`--engine osr` と `--
 
 - 語矩形で表せない演出、色補間と幾何変形が同居する cue、縦書きの語単位字幕は glyph atlas 等の次段が必要。
 - 動的自由 HTML は OSR または事前ベイクが必要。
-- Windows は launcher tier 1 / 2 があれば `auto` で適格時に GPU、不適格時に OSR を使う。Linux は
-  `--engine gpu` 明示時だけ GPU を利用でき、`auto` は legacy を維持する。
+- 全 platform で launcher tier 1 / 2 があれば `auto` で適格時に GPU、不適格時に OSR を使う。
 - 長尺の区間並列、複数 process 並列は非対応。
 - ~~インストール済みデスクトップアプリ経由（launcher tier 1）の GPU 書き出しは未配線~~ **2026-08-29 解消**: shell の `electron-entry.js` が `--akari-main packages/gpu-export/src/electron-main.mjs` を受け、`buildElectronArguments` が tier 1 にそれを渡す（osr 契約 §6）。`resolveGpuLauncher` の fail-closed（allowDesktop 既定 false）は v0.1.28 で解除。以下は v0.1.26〜v0.1.27 の記録: （v0.1.25 で判明）。shell の `--render` は OSR ランタイムしか読まず、`buildElectronArguments` は tier 2 にしか mainScript を渡さない。v0.1.26 から `resolveGpuLauncher` は tier 1 を候補から外す（fail-closed）: `auto` は OSR へ（provenance に `engine_fallback` と理由）、`--engine gpu` 明示は拒否。tier 1 の配線（shell contribution に GPU ランタイム選択を足す）は別票。
 
@@ -222,7 +231,7 @@ OSR receipt と同じ warning/hard-stop 語彙を使う。`--engine osr` と `--
 |---|---|---|---|
 | macOS | 明示利用可 | 適格なら GPU、不適格なら OSR | tier 1 / 2（ただし tier 1 は現状未配線で fail-closed） |
 | Windows | 明示利用可 | 適格なら GPU、不適格なら OSR | tier 1 / 2（同上） |
-| Linux | 明示利用可 | legacy のまま | tier 1 / 2（同上） |
+| Linux | 明示利用可 | 適格なら GPU、不適格なら OSR | tier 1 / 2（同上） |
 
 npm Electron の tier 2 は `node_modules/electron/path.txt` を必須とする。値は win32 が
 `electron.exe`、darwin が `Electron.app/Contents/MacOS/Electron`、linux が `electron` である。

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

@@ -4,18 +4,20 @@
 
 この契約は `render-cut --engine osr` が生成する映像ページと、そのページを Electron オフスクリーン描画で駆動するプロトコルを定める。
 
-**2026-08-28 改訂:** `--engine` の既定は `auto` とし、次のように解決する。従来経路へ戻す場合は
-プラットフォームを問わず `--engine legacy` を明示する。
+**2026-09-01 改訂:** `--engine` の既定は `auto` とし、全 platform で同じ規則に解決する。
+`legacy` は廃止済みで、OSR launcher の tier 3 は明示エラーになる。
 
 | platform | `auto` の解決 | 備考 |
 |---|---|---|
-| darwin | `osr` | v2 を既定とする |
-| win32 | 適格なら `gpu`、不適格なら `osr` | GPU / OSR launcher が利用不能なら順に `legacy` へフォールバック |
-| linux | `legacy` | OSR は opt-in |
+| darwin | 適格なら `gpu`、不適格なら `osr` | GPU 実行体なしは OSR、OSR 実行体なしはエラー |
+| win32 | 適格なら `gpu`、不適格なら `osr` | GPU 実行体なしは OSR、OSR 実行体なしはエラー |
+| linux | 適格なら `gpu`、不適格なら `osr` | GPU 実行体なしは OSR、OSR 実行体なしはエラー |
 
 `.akari/render.json` の provenance は、指定値を `engine_requested`、解決後の実走値を `engine` に
-記録する。OSR launcher が tier 3 へフォールバックした場合、`engine` は `legacy` とし、
-`engine_fallback: { from: "osr", reason: <launcher.reason> }` を追加する。
+記録する。OSR launcher が tier 3 の場合は、Electron の入手方法（アプリ同梱 / `npm install electron` /
+`AKARI_OSR_ELECTRON`）を示して exit 2 で停止し、render.json や `engine_fallback` は書かない。
+`engine_fallback` は gpu → osr の 1 種だけで、`auto` が `gpu` に解決した後、その launcher が
+tier 3 の場合に `{ from: "gpu", reason: <launcher.reason> }` を記録する。
 
 ## 2. ページ契約
 
@@ -93,9 +95,15 @@ ffprobe timeoutは `max(120000, frames × 100)` msとする。尺、フレーム
 
 ## 8. メモリと長尺
 
-- GPU描画の警戒線: 768 MiB / export、hard stop: 1,024 MiB / export。
+- GPU描画の警戒線: 768 MiB / export、hard stop: 1,024 MiB / export（1080p 基準）。
 - ソフト描画（SwiftShader）は1080pで1.1 GiB台に達するため、警戒線1,536 MiB / hard stop 2,048 MiBの別枠を使う。
-- `AKARI_OSR_MEMORY_WARN_MIB` / `AKARI_OSR_MEMORY_HARD_STOP_MIB`で正の整数MiBへ上書きでき、適用値はwarning < hard stopを必須とする。
+- 出力ピクセル数が 1080p（1920×1080）を超えるときは既定値をその比で増やす（4K = 4 倍、MiB 切り上げ）。
+  ただしスケール後の hard stop は物理メモリの 50% を上限とし、超えるときは切り詰めて warning を hard stop の
+  75% に置く（`memory.machine_capped` を receipt に残す）。1080p 以下の既定値は機種に関係なく変えない
+  （2026-09-01 改訂。4K の係数は予測値で未較正 — 初回の実測 peak で較正する）。
+- `AKARI_OSR_MEMORY_WARN_MIB` / `AKARI_OSR_MEMORY_HARD_STOP_MIB`で正の整数MiBへ上書きでき（絶対値・スケールと上限を受けない）、
+  適用値はwarning < hard stopを必須とする。hard stop だけを上書きし既定 warning がそれ以上になるときは warning を hard stop の 75% に追従させる。
+  同じ変数を GPU 直結出口（gpu-export）も読む。
 - 並列予算1 worker = 1 GiBはGPU前提の値である。v0のworker数は1。
 - 10秒ごとにRSSを記録し、ウィンドウ破棄後も採る。
 - 固定Nコマごとのページ再生成は行わない。再生成を許すのはページ境界、renderer crash、watchdog回復時だけである。

package/vendor/docs/contract-2026-08-30-edit-json-v2-object-tree-v0.md

@@ -114,6 +114,26 @@ updated: 2026-08-30
 - 折りたたみ・選択・フォーカス中のスコープは**表示状態**で、edit.json に保存しない
 - `id` は木全体で一意（袋から写した子の id は `<袋 id>.<名札>` を UI が合成する。明示アイテムにした時点でその id が edit.json に書かれる）
 
+### 1.8 語彙と提示（2026-09-01・オーナー裁定）: 「グループ」は純グループだけを指す
+
+データ模型は §1.2（**純グループ** = 人間が ⌘G で作る）と §1.3（**袋グループ** = 取り込み時にデータ由来でできる）を既に分けている。**UI ではこの 2 つを同じ語で呼ばない。**
+
+| | 純グループ（§1.2） | 袋（§1.3） |
+|---|---|---|
+| 誰が作るか | 人間が ⌘G で作る | データがそうなっている（勝手にできる） |
+| UI での呼び名 | **「グループ」** | 素材の種類で呼ぶ（「字幕」「オーバーレイ」「SFX」）。**グループとは呼ばない** |
+| 展開トグル | **出す** | **出さない** |
+| ばらす（⌘⇧G） | できる | **できない**（§3.3 で既定済み） |
+
+- **1 トラック = 常に 1 行。** 葉のアイテム（子を持たないもの）は帯の中のチップであって、ヘッダ列の行ではない。ヘッダ列の行になるのは (a) 子を持つ純グループ (b) 展開中の純グループの子 だけ
+- **袋の子へ届く経路は 2 つ**: (a) 帯のチップを直接クリックして選ぶ (b) ダブルクリックでフォーカスモードに入る（§7 の「中に入る」）。袋を段の上で展開する操作は**無い**
+- 畳んだ帯に子の位置を刻みで示すのは従来どおり（どこに何があるかは帯で分かる）
+- 「出す」（§3.1）・「テロップに変換」（§1.5）は**帯のチップに対する操作**として従来どおり使える（行が無くても届く）
+
+**根拠**: 袋は「データがそうなっている入れ物」で、人間が作ったものでも、ばらせるものでもない。それを UI で「グループ」と呼ぶと「ではばらせるのか」「展開する必要があるのか」という**答えのない問い**が立つ。実案件（SFX 30・字幕 30 行）で葉まで行にした結果ヘッダ列が 71 行に膨らみ、この混同が破綻として顕在化した。
+
+**変わるのは提示だけ**（§1.3 の「折りたたみは UI の表示状態であってデータではない」は維持。データ形式・直列化・lint は不変）。
+
 ## 2. 段（`tracks[]`）の不変条件
 
 | # | 不変条件 | 破ったとき |

package/vendor/docs/contract-2026-08-30-motion-and-keyframes-v0.md

@@ -75,6 +75,9 @@ updated: 2026-08-30
 - 参照形は `path`（プロジェクト相対）+ `count`（袋の中のその item の点数。lint が突き合わせる）。読み込み層は参照を解決して inline と同じ配列を消費者へ渡す（消費者は形を区別しない）
 - `<group-id>` = そのアイテムが属する**最も近いグループ**の id（段直下のアイテムは自分の id）。フォーカスモードの単位 = 袋の単位
 
+media item（cuts）での適用先 = frame-engine base 経路（2026-09-01・issue #39）: edit-store が cut へ投影した `crop` /
+`keyframes[]`（`transform` / `crop` / `opacity`）を GPU / OSR 書き出しが layer-style の幾何で評価する。`perspective` は未適用で warning。
+
 ## 3. `motion/<group-id>.json` 袋
 
 ```jsonc

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

@@ -52,20 +52,6 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）。
 
-### Chrome の導入
-
-動画の書き出しに使う Chrome for Testing は、次のコマンドで導入できる。
-
-```sh
-akari chrome install
-akari chrome install --cache-dir /path/to/cache
-akari chrome install --build-id 150.0.7339.16
-```
-
-保存先の既定は `~/.cache/puppeteer`。`--cache-dir` で保存先、`--build-id` で導入する
-buildId を指定できる。実行環境から `@puppeteer/browsers` を解決できる必要があり、
-AKARI Video アプリの配布物には必要なモジュールが同梱されている。
-
 `akari` に渡した引数はそのまま `opencode` に転送する（例: `akari --continue` は
 `opencode --continue` を起動する）。
 

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "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/src/edit-lint.mjs

@@ -3126,6 +3126,17 @@ function validateTextStyle(value, label, findings, path) {
       path,
     );
   }
+  if (
+    Object.hasOwn(value, "reference_height_px")
+    && (!Number.isInteger(value.reference_height_px) || value.reference_height_px < 1)
+  ) {
+    captionFinding(
+      findings,
+      "captions.text-style",
+      `${label}.reference_height_px must be an integer greater than or equal to one`,
+      path,
+    );
+  }
   if (Object.hasOwn(value, "font_weight") && (!Number.isInteger(value.font_weight) || value.font_weight < 1 || value.font_weight > 1000)) {
     captionFinding(findings, "captions.text-style", `${label}.font_weight must be an integer within [1, 1000]`, path);
   }
@@ -3158,6 +3169,14 @@ function validateTextStyle(value, label, findings, path) {
       path,
     );
   }
+  if (Object.hasOwn(value, "layout") && Object.hasOwn(value, "reference_height_px")) {
+    captionFinding(
+      findings,
+      "captions.text-style",
+      `${label} cannot contain both layout and reference_height_px`,
+      path,
+    );
+  }
 }
 
 function validateCaptionAnimation(value, label, findings, path) {

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

@@ -96,6 +96,22 @@ export declare function scheduleCaptionFragments(start: number, end: number, fra
     text: string;
 }>;
 export declare function mergeCaptionDisplayStyles(base: unknown, override: unknown): UnknownRecord | undefined;
+/**
+ * zone 方式の px 系フィールドに掛ける scale（issue #40 §2）。`reference_height_px` が無ければ 1
+ * （既存出力はバイト同一）。あれば output.height / reference_height_px — 基準は高さ（文字サイズは
+ * 縦方向の量。縦型出力でも自然）。`layout`（reference-pixel）との併用は禁止。output.height が無いと
+ * layout 経路の INVALID_OUTPUT_GEOMETRY と同型で fail する。render-cut の captionTextStyleVars と
+ * gpu-export page-builder はこの単一定義を使い、GPU / OSR の両経路で同じ実効 px になる。
+ */
+export declare function resolveCaptionReferenceScale(style: unknown, output: {
+    width?: number;
+    height?: number;
+} | undefined): number;
+/**
+ * 宣言 px × scale。scale === 1 なら値をそのまま返す（`${value}` の文字列が従来とバイト同一）。
+ * それ以外は小数 6 桁へ丸めて浮動小数の端数（0.1 × 3 = 0.30000000000000004）を CSS に漏らさない。
+ */
+export declare function scaleCaptionPx(value: number, scale: number): number;
 /**
  * text_anchor（9 点）+ position（0..1 相対）→ プレート配置の CSS 変数。単一定義
  * （プレビュー = shell captionTextStyleVars / 書き出し = render-cut captions.mjs の両消費者が