akari-video 0.1.38 → 0.1.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

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

@@ -123,11 +123,16 @@ cuts と layers が同時に空のフレームは、出力解像度の黒 1 枚
 スプライト合成は通常どおりこの黒い frame-engine canvas の上へ重ねる。
 
 3D は engine の時計から得た local seconds を `threeRuntime.render(container, t)` へ直接渡して駆動する。
-GPU 出口は overlay sheet の `__akariSeek` を使用しない。毎コマの DOM animation 同期、全 container の
-visibility 更新、video seek 待ちを 3D canvas の texture 更新へ持ち込まないためである。sheet の
+GPU 出口は overlay sheet の `__akariSeek` を使用しない。毎コマの DOM animation 同期と全 container の
+visibility 更新を 3D canvas の texture 更新へ持ち込まないためである。sheet の
 `__akariReady` は起動時に 1 回だけ待ち、各 scene が ready でない場合は overlay id と状態を示して
 fail-closed にする。active 区間は最終 compositor の draw へ積むかどうかで決める。
 
+**2026-09-04 改訂（issue #53）**: video seek 待ちだけは例外とし、sheet が公開する `__akariSeekVideos(seconds)`
+（`__akariSeek` から切り出した video 部分・OSR と同一実装）を毎コマ、3D 描画の前に呼ぶ。3D 断片の動画テクスチャは
+`<video>` の提示フレームから上がるため、シーク → 提示確定 → 3D 描画 の順序が必要で（`3d.md`）、呼ばないと
+GPU 経路の動画テクスチャは起動時の 0 秒の絵に固定される。シートに `<video>` が無ければ呼ばない。
+
 ## 4. 読み戻しゼロ
 
 製品実行経路は GPU frame surface を CPU へ読む API を使用しない。静的監査は
@@ -187,6 +192,26 @@ software MP4 SHA はエンコーダが決定論的な場合だけ必須とし、
 GPU と OSR の decode 比較は、engine-only 区間の per-frame MAD 1.0 以下、字幕 cue の代表 5 時刻の
 下半分 MAD 1.0 以下、3D 区間 MAD 1.0 以下を固定閾値とする。
 
+**2026-09-04 追加（issue #53）— 2 経路で同じでなければならない 4 点**:
+
+1. **overlay へ渡す時刻は `frameNumber / fps`**。µs へ丸めてはならない。overlay の `start` は必ず
+   `atFrames / fps` なので、丸めると比較が 1 ulp で反転し、カット境界の 1 コマだけ絵が食い違う。
+   この `seconds` は時間窓判定・CSS アニメ位相・item keyframes のフレーム番号すべてに流れる。
+2. **時間窓の外の container も毎コマ pause して `currentTime` を書く**。飛ばすと窓の外の断片の CSS アニメが
+   壁時計（書き出しは分単位）で走り切り、`animation-fill-mode: both/forwards` の最終姿勢に張り付いたまま
+   窓へ入ってくる = 同じ時刻でも直前に何を撮ったかで絵が変わる。OSR の `__akariSyncAnimations` は
+   active 判定を持たない。
+3. **DOM ステージのルートに `data-no-timeline`**。断片の規約は
+   `[data-akari-active] .x, [data-no-timeline] .x { animation: … }` の 2 アームで、OSR のシートは `#stage` に
+   これを持つ。GPU 側に無いと no-timeline アームだけで宣言した断片が GPU でのみ動かない。
+4. **静的スプライトは overlay の `transform` を落とさない**。`.akari-sprite-root` に OSR の
+   `.akari-overlay-container` と同じ `translate/scale/rotate` + `transform-origin: center` を宣言する
+   （`role: "background"` は両経路とも恒等固定）。
+
+あわせて、manifest 生成時に overlay の `start` / `duration` が有限数でなければ fail-closed とする。
+既定値（`?? 0` / `?? duration`）を置くと、欠けたときに「OSR は絶対に出さない・GPU は全尺出す」という
+最悪の非対称になる（OSR は `formatNumber(undefined)` が `"NaN"` を書き、`seconds >= NaN` が常に偽になる）。
+
 ## 7. receipt
 
 `.akari/render.json` は `provenance.engine = "gpu"` と GPU receipt を持つ。GPU receipt は少なくとも

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

@@ -117,6 +117,17 @@ ffprobe timeoutは `max(120000, frames × 100)` msとする。尺、フレーム
 - `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）も読む。
+- 書き出しは厳密に前方順で過去フレームを読み直さないため、**評価 plan から外れたカットのデコーダセッションは解放する**
+  （`StreamReaper`。frame-engine が `plan.base` / `plan.layers` の `streamId` を集め、最後に使ったフレームから 1 秒ぶんの
+  猶予を過ぎたものを `LookaheadFrameSource.releaseStream` で落とす）。解放しないとカット本数ぶんのセッションが最後まで
+  積み上がり、RSS が単調に伸びて長尺ほど後ろで hard stop に当たる（2026-09-04 追加・issue #52。
+  244 秒 / 7,320 コマの実機報告で 98% 地点・RSS 4.01 GB）。トランジション中の送出カットは plan に載るので残る。
+- receipt / run.json の `memory.decoderSessions` に生存セッション数（`live`）と累計解放数（`released`）を記録する。
+  RSS はセッション数に比例するため、ランプの原因を後から突き合わせられるようにする（同・issue #52。
+  #28 の時点で比例は分かっていたが記録が無く、再発時にまた手探りになった）。
+- hard stop に当たった GPU 直結出口の失敗は reasonCode `memory-hard-stop` とし、`--engine auto` のときは OSR で
+  走り直して完走させる（`FALLBACK_REASONS`。同・issue #52。それまでは成果物ゼロで終わり、前版で出せていたものが
+  出せない退行になっていた）。`--engine gpu` 明示は従来どおり fail-closed。
 - 並列予算1 worker = 1 GiBはGPU前提の値である。v0のworker数は1。
 - 10秒ごとにRSSを記録し、ウィンドウ破棄後も採る。
 - 固定Nコマごとのページ再生成は行わない。再生成を許すのはページ境界、renderer crash、watchdog回復時だけである。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "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-store/lib/caption-store.js

@@ -296,7 +296,10 @@ function updateCaptionStylePresetInSource(source, captionIds, presetId) {
             changed++;
             continue;
         }
-        if (hasPreset && record.style_preset === presetId)
+        const shadowed = shadowedPresetStyleKeys(presetId, record.text_style);
+        // 同じテンプレの再適用でも、そのテンプレを覆い隠している字幕個別の指定が残っていれば
+        // 掃除する仕事が残っている（「変更はありません」で終わらせない）。
+        if (hasPreset && record.style_preset === presetId && shadowed.length === 0)
             continue;
         let nextElement;
         if (hasPreset) {
@@ -317,11 +320,46 @@ function updateCaptionStylePresetInSource(source, captionIds, presetId) {
                     + element.text.slice(textStyle.start);
             }
         }
+        nextElement = pruneShadowedTextStyle(nextElement, shadowed, captionId);
         output = replaceElement(output, array.openIndex + 1, element, nextElement);
         changed++;
     }
     return { source: output, changed };
 }
+/**
+ * そのテンプレが決めるツマミのうち、字幕個別の text_style が上書きしてしまっているキーを挙げる。
+ *
+ * 合成規則は `{ ...presetStyle, ...text_style }`（caption-style-preset.ts）で **字幕側が強い**。
+ * そのため text_style に既定値が丸ごと書かれていると、テンプレを当てても見た目が変わらない
+ * （オーナー報告 2026-09-04:「ニュース帯だけ効く」= ニュース風の background だけが text_style に
+ *  無いツマミだった）。テンプレを選ぶ操作は「このツマミはテンプレに任せる」という意思表示なので、
+ * 適用時に該当キーを落としてテンプレを表に出す。テンプレが決めないツマミ（ドラッグした position /
+ * zone / max_characters など）は字幕個別の指定として残す。
+ */
+function shadowedPresetStyleKeys(presetId, textStyle) {
+    const preset = Object.prototype.hasOwnProperty.call(textstyle_catalog_1.TEXTSTYLE_CATALOG, presetId)
+        ? textstyle_catalog_1.TEXTSTYLE_CATALOG[presetId] : undefined;
+    if (!preset || textStyle === null || typeof textStyle !== 'object' || Array.isArray(textStyle)) {
+        return [];
+    }
+    const style = textStyle;
+    return Object.keys(preset.style)
+        .filter(key => Object.prototype.hasOwnProperty.call(style, key));
+}
+/** text_style から指定キーを取り除く。空になったら text_style ごと落とす。 */
+function pruneShadowedTextStyle(element, keys, captionId) {
+    if (keys.length === 0) {
+        return element;
+    }
+    const located = locateTopLevelObjectProperty(element, 'text_style', `字幕 ${captionId}`);
+    let textStyle = located.text;
+    for (const key of keys) {
+        textStyle = removeObjectProperty(textStyle, key);
+    }
+    return Object.keys(JSON.parse(textStyle)).length === 0
+        ? removeObjectProperty(element, 'text_style')
+        : element.slice(0, located.start) + textStyle + element.slice(located.end);
+}
 function insertCaptionLine(source, caption) {
     const parsed = parseCaptions(source);
     if (!normalizeCaption(caption)) {

package/vendor/skills/overlay-authoring/3d.md

@@ -118,6 +118,21 @@ fragment は単一ルートとし、透明 canvas、任意の静的 fallback、
   clip を分けるので、1 個のモデルに複数の動きがあるときは `"*"` で束ねる（1 本しか再生しないと
   片方しか動かない）。存在しない clip 名を書いた場合はエラーになる。
 - `materialOverrides` は `{ "<material 名>": { "texture": "<画像または動画の相対パス>" } }` の形で、名前が一致するマテリアルの `emissiveMap` を差し替える。**差し替え先が `emissiveMap` である以上、貼り先の材質が発光しない（glTF の `emissiveFactor` が未設定 = 黒）と「0 × テクスチャ」で何も出ない**（2026-08-14 実害。詳細は後述「発光しない材質には貼れない」）。edit.json のあるディレクトリからの相対 PNG / JPEG / WebP 等、または MP4 / MOV / WebM を指定し、URL や CDN を書かない。該当するマテリアル名がモデル内にない場合は警告して無視される。
+  - `textureVar` は画面に映すものをツマミ（CSS カスタムプロパティ）にする任意キー。`"--screen-src"` のような変数名を書き、overlay の `vars` でその変数に相対パスを入れると `texture` の代わりに差し込まれる。空・未設定なら `texture` がそのまま使われる。
+  - `textureVar` を使う場合も `texture` は実在する相対パスのままにする。書き出し前の宣言済み入力検査が実ファイルを要求するため、`texture` に `var(--screen-src)` を直接書く形はライブプレビューでは動くが書き出しでは失敗する。
+  - `brightness` は任意の発光倍率（0〜4、既定 1）で、差し替えたテクスチャの `emissiveIntensity` に掛かる。`var(--screen-brightness)` のような CSS 変数も書き出しを含めて使える。既定の 1 のときは `emissiveIntensity` に触れず、既存宣言の見た目を維持する。
+  - ツマミへ結線する宣言例:
+    ```json
+    {
+      "materialOverrides": {
+        "ScreenMaterial": {
+          "texture": "placeholder.png",
+          "textureVar": "--screen-src",
+          "brightness": "var(--screen-brightness)"
+        }
+      }
+    }
+    ```
   - **パスは「edit.json のあるディレクトリ」から。断片の場所からの相対ではない。** `model` も同様。
     断片を `overlays/3d-phone/fragment.html` へ置いたなら `"overlays/3d-phone/model.glb"` と書く
     （`"model.glb"` はプロジェクト直下を探して ENOENT になる）。