akari-video 0.1.37 → 0.1.39

package/README.md

@@ -45,9 +45,11 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `akari narration generate ...`（VOICEVOX / fal-qwen3 ナレーション生成）/
 `akari internal beat-sync-<beatmap|probe-frame|render-when-idle> ...`（beat-sync-edit 内部実行物）/
 `akari sounds [--variant wav] [--force]`（公式音源の一括ダウンロード。プロンプトなし・headless 可）/
-`akari store <connect|status|download|disconnect>`（AKARI Store 連携。マイページで発行した
+`akari store <connect|status|install|download|disconnect>`（AKARI Store 連携。マイページで発行した
 接続トークンを `~/.akari/store-credentials.json`（0600）に保存し、購入済み一覧の確認と
-配布物の取得ができる。`src/store-command.mjs`）/
+配布物の取得ができる。`install <productId> [--from <zip>]` は購入パックを展開し、`PACK.json` の
+収載素材を `~/.akari/assets/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
+zip を使う。`src/store-command.mjs`）/
 `akari assets <list|fetch|sync|...>`（素材カタログの一覧・取得・同期。
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）/

package/package.json

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

@@ -1,7 +1,7 @@
 import { spawnSync } from 'node:child_process';
 import {
   copyFileSync, cpSync, existsSync, mkdirSync, mkdtempSync,
-  readdirSync, rmSync, writeFileSync
+  readFileSync, readdirSync, renameSync, rmSync, writeFileSync
 } from 'node:fs';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
@@ -53,6 +53,123 @@ function findFile(dir, name) {
   return null;
 }
 
+const INSTALLED_ASSETS_SCHEMA = 'akari-installed-assets/v0';
+
+function readJsonFile(filePath) {
+  return JSON.parse(readFileSync(filePath, 'utf8'));
+}
+
+function titleFromMeta(assetRoot) {
+  try {
+    const meta = readJsonFile(path.join(assetRoot, 'meta.json'));
+    return typeof meta.title === 'string' && meta.title ? meta.title : null;
+  } catch {
+    return null;
+  }
+}
+
+function isSafePathSegment(value) {
+  return typeof value === 'string' && value.length > 0
+    && value !== '.' && value !== '..'
+    && !value.includes('/') && !value.includes('\\');
+}
+
+function pathWithin(root, ...parts) {
+  const absoluteRoot = path.resolve(root);
+  const candidate = path.resolve(absoluteRoot, ...parts);
+  if (candidate !== absoluteRoot && !candidate.startsWith(`${absoluteRoot}${path.sep}`)) {
+    throw new Error(`PACK.json の path がパック外を指しています: ${parts.join('/')}`);
+  }
+  return candidate;
+}
+
+function flattenPackContents(pack, packRoot) {
+  if (!Array.isArray(pack?.contents)) {
+    throw new Error('PACK.json に contents[] がありません');
+  }
+
+  const items = [];
+  for (const entry of pack.contents) {
+    const candidates = Array.isArray(entry?.assets)
+      ? entry.assets.map((asset) => ({ asset, parentTitle: entry.title }))
+      : [{ asset: entry, parentTitle: null }];
+    if (candidates.length === 0) {
+      throw new Error('PACK.json の contents[] に空の assets[] があります');
+    }
+
+    for (const { asset, parentTitle } of candidates) {
+      if (!asset || !isSafePathSegment(asset.id)
+        || typeof asset.path !== 'string' || !asset.path) {
+        throw new Error('PACK.json の contents[] に不正な id / path があります');
+      }
+      const assetRoot = pathWithin(packRoot, asset.path);
+      if (!Array.isArray(asset.files) || asset.files.length === 0) {
+        throw new Error(`PACK.json の item に files[] がありません: ${asset.id}`);
+      }
+      const files = asset.files.map((file) => {
+        if (!file || typeof file.path !== 'string' || !file.path
+          || !Number.isInteger(file.bytes) || file.bytes < 0
+          || typeof file.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(file.sha256)) {
+          throw new Error(`PACK.json の files[] が不正です: ${asset.id}`);
+        }
+        pathWithin(assetRoot, file.path);
+        return {
+          path: file.path,
+          bytes: file.bytes,
+          sha256: file.sha256
+        };
+      });
+      const version = asset.version ?? pack.version;
+      if (version === undefined || version === null) {
+        throw new Error(`PACK.json の item に version がありません: ${asset.id}`);
+      }
+      items.push({
+        id: asset.id,
+        title: (typeof asset.title === 'string' && asset.title)
+          || titleFromMeta(assetRoot)
+          || (typeof parentTitle === 'string' && parentTitle)
+          || asset.id,
+        path: asset.path,
+        version,
+        files
+      });
+    }
+  }
+  return items;
+}
+
+function registerInstalledPack(env, productId, packPath) {
+  const home = resolveAkariHome(env);
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  const packRoot = path.dirname(packPath);
+  const pack = readJsonFile(packPath);
+  if ((typeof pack?.version !== 'string' && typeof pack?.version !== 'number')) {
+    throw new Error('PACK.json に version がありません');
+  }
+  let index = { schema: INSTALLED_ASSETS_SCHEMA, packs: {} };
+
+  if (existsSync(indexPath)) {
+    index = readJsonFile(indexPath);
+    if (index?.schema !== INSTALLED_ASSETS_SCHEMA
+      || !index.packs || typeof index.packs !== 'object' || Array.isArray(index.packs)) {
+      throw new Error(`導入済み素材索引の形式が想定と違います: ${indexPath}`);
+    }
+  }
+
+  const items = flattenPackContents(pack, packRoot);
+  index.packs[productId] = {
+    version: pack.version,
+    installedAt: new Date().toISOString(),
+    root: packRoot,
+    items
+  };
+  mkdirSync(path.dirname(indexPath), { recursive: true });
+  const tempPath = `${indexPath}.tmp-${process.pid}`;
+  writeFileSync(tempPath, `${JSON.stringify(index, null, 2)}\n`, { mode: 0o600 });
+  renameSync(tempPath, indexPath);
+  return items;
+}
+
 const KNOWN_BUNDLE_COMPONENTS = new Map([
   ['multi-device-combo', ['phone-pro-titanium', 'laptop-slim-aluminum', 'app-icon-squircle']]
 ]);
@@ -235,13 +352,22 @@ export async function runStoreCommand(args, options = {}) {
 
   if (sub === 'install') {
     const productId = args[1];
-    if (!productId || productId.startsWith('--')) {
-      log('使い方: akari store install <productId>');
+    if (!isSafePathSegment(productId) || productId.startsWith('--')) {
+      log('使い方: akari store install <productId> [--from <zip>]');
+      return { exitCode: 1 };
+    }
+    const hasFrom = args.includes('--from');
+    const fromZip = parseFlag(args, '--from');
+    if (hasFrom && !fromZip) {
+      log('使い方: akari store install <productId> [--from <zip>]');
       return { exitCode: 1 };
     }
     const stage = mkdtempSync(path.join(tmpdir(), 'akari-store-install-'));
     try {
-      const dl = await runStoreCommand(['download', productId, '--dest', stage], options);
+      const dl = fromZip
+        ? { exitCode: existsSync(fromZip) ? 0 : 1, filePath: path.resolve(fromZip) }
+        : await runStoreCommand(['download', productId, '--dest', stage], options);
+      if (fromZip && dl.exitCode !== 0) log(`zip が見つかりません: ${fromZip}`);
       if (dl.exitCode !== 0) return { exitCode: 1 };
       const extractDir = path.join(stage, 'x');
       mkdirSync(extractDir, { recursive: true });
@@ -289,6 +415,12 @@ export async function runStoreCommand(args, options = {}) {
       const readme = findFile(destDir, 'README.md');
       log(`展開しました: ${destDir}`);
       if (readme) log(`導入手順: ${readme}`);
+      const packPath = findFile(destDir, 'PACK.json');
+      if (packPath) {
+        const items = registerInstalledPack(env, productId, packPath);
+        log(`akari assets list に ${items.length} 件を登録しました`);
+        if (items[0]) log(`次の一手: akari assets fetch ${items[0].id}`);
+      }
       return { exitCode: 0 };
     } finally {
       rmSync(stage, { recursive: true, force: true });
@@ -307,7 +439,7 @@ export async function runStoreCommand(args, options = {}) {
   log('使い方: akari store <connect|status|install|download|disconnect>');
   log('  connect                              ブラウザで承認して接続（既定。--token akst_... で手動 / --no-open でブラウザを開かない / --url <base>）');
   log('  status                               接続状態と購入済み一覧');
-  log('  install <productId>                  購入済み商品のダウンロード + 導入まで一括');
+  log('  install <productId> [--from <zip>]   購入済み商品の導入（--from は手元 zip / PACK.json 素材を installed 索引へ登録）');
   log('  download <productId> [--dest <dir>]  購入済み配布物の取得のみ');
   log('  disconnect                           接続解除');
   return { exitCode: sub ? 1 : 0 };

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

@@ -20,7 +20,7 @@
 | 分類 | 適格 | 意味 |
 |---|---|---|
 | `same` | はい | 静的 HTML は起動時、対応済み字幕は unit の初回活性時に 1 回だけスプライト化する |
-| `three` | はい | JSON の宣言型 3D scene と描画先 canvas を持つ overlay。毎コマ Three.js canvas を更新し、登場表現は `three-scene-entrance-curve` または `three-scene-entrance-sampled` で処理する |
+| `three` | はい | JSON の宣言型 3D scene と描画先 canvas を持つ overlay。毎コマ Three.js canvas を更新し、登場表現は `three-scene-entrance-curve`、`three-scene-entrance-sampled`、または `three-scene-sampled-composite` で処理する |
 | `degraded` | いいえ | raster 自体は可能でも live DOM と同じ時間変化を保証できない |
 | `unsupported` | いいえ | v0 の表現範囲外であり、正しい完成画を生成できない |
 
@@ -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 は少なくとも
@@ -305,6 +330,18 @@ CSS 3D は次の 3 群に分けて判定する。
   外部扱いしない（2026-08-31・issue #33。それまでは末尾に `;` の無いインライン style から後続 SVG の
   `fill="url(#id)"` まで走査が届いて誤検出していた）。
 - `drawElementImage` が利用できない実行環境、または device pixel ratio が 1 でない環境。
+- 宣言型 3D が composite 経路の入口条件（`three-or-canvas-runtime` / `animation-timing` /
+  `css-3d-transform` / `advanced-css`）を満たさない場合は `three-sampled-condition:<条件名を , 連結>` とし、
+  curve 解析の失敗理由を流用しない。CSS 3D 幾何は composite 経路で断片全体を転写するため適格とする。
+- root〜Three canvas の祖先チェーン上の `filter` / `clip-path` / `mask(-image)` / `backdrop-filter` /
+  `mix-blend-mode` に対する `three-sampled-chain-css:<プロパティ>` は、canvas だけを合成する方式 A（sampled）専用の
+  ガードとして走査側に保持する。方式 B（composite）はチェーン内外とも断片全体を転写するため `advanced-css` を通す。
+- composite 候補に `@property` がある場合は `three-composite-property` とする。overlay sheet の WAAPI clone と
+  DOM 層の素の CSS animation でカスタムプロパティ補間が割れる可能性があるため、実測までは fail-closed とする。
+- `transform-style: preserve-3d` を宣言する要素の要素の子に、Three canvas への祖先チェーン上の要素と
+  チェーン外の Z を持つ変形を宣言した要素が同居する場合は `three-composite-preserve-3d-siblings` とする。
+  静的に判定できない場合も同じ理由で degraded へ倒す（2026-09-04 実測: 外接矩形 MAD 5.0082。
+  OSR は z 深度で、GPU は DOM 順で重ねるため）。
 
 settle は mount 時に一度だけ決める。`canvas.requestPaint` がある Chromium では rAF 2 回の後に
 `requestPaint()` と `paint` event（上限 250 ms）を待つ。API がない Chromium では computed style、
@@ -433,19 +470,37 @@ Three canvas までの各要素について計算済み opacity と transform
 累積行列が軸平行な translate / scale だけなら 3D canvas を従来の texture のまま使い、中心基準の
 sprite draw state へ変換する。回転またはせん断を含む一般 2D affine は、出力寸法の中間 canvas へ
 `setTransform(a,b,c,d,e,f)` で描いてから恒等 draw state で合成する。perspective、実 Z 成分、その他の
-3D 行列は理由 `three-entrance-3d-matrix` で `degraded` にする。
-
-sampled 方式 A の対象は、断片 root から Three canvas までの祖先チェーン（両端を含む）である。
-このチェーン上の任意の要素にある animation / transition は累積行列へ含める。Three canvas の CSS
-ボックスが出力全面と一致しない場合は、軸平行な行列でも中間 canvas 経路を使い、元の位置と寸法を保つ。
-canvas 以外の HTML（fallback や装飾）を DOM 層で別描画して合成順を保つ方式 B は本版では未実装である。
-祖先チェーン外に animation / transition がある、または保守的な静的走査でチェーン内だけと証明できない
-場合は `three-html-animated-descendants` で `degraded` にする。filter / clip-path など他の既存 hard
-blocker も従来どおり fail-closed とする。
-
-manifest の各 3D sprite は `entranceMode: "curve" | "sampled" | "none"` を持つ。run payload と receipt の
-`gpu.three.overlays[].entrance.mode` は登場表現について `curve` または `sampled` を記録し、
-`gpu.three.sampling` は sampled フレームの `count`、`p50`、`p95` ミリ秒を記録する。
+3D 行列は方式 A では扱わず、方式 B の断片全体転写へ回す。
+
+sampled 方式 A の入口条件は `three-or-canvas-runtime` / `animation-timing` の 2 つで、対象は断片 root から
+Three canvas までの祖先チェーン（両端を含む）である。このチェーン上の任意の要素にある
+animation / transition は累積行列へ含める。Three canvas の CSS ボックスが出力全面と一致しない場合は、軸平行な
+行列でも中間 canvas 経路を使い、元の位置と寸法を保つ。
+
+方式 B（composite）は、方式 A で祖先チェーン内だけと証明できない断片、CSS 3D 幾何、または
+`advanced-css` を持つ断片を理由 `three-scene-sampled-composite` で処理する。Three.js は overlay sheet で従来どおり
+描画し、その Three canvas を DOM 層コピー側の同じ canvas 要素へ毎コマ `drawImage` で中継する。その後、paused WAAPI を
+合成時刻へ seek して断片 root 全体を `drawElementImage` する。DOM 層コピー側の `[data-akari-3d-fallback]` は
+`hidden` と `display:none !important` で隠す。断片内は canvas を含む DOM 順と z-index がそのまま効き、断片間は従来どおり
+track z、宣言 index の順で合成する。これにより祖先チェーン上の 3D 行列と、チェーン内外の `advanced-css` も転写される。
+
+CSS 3D の判定は DOM 層と同じ 3 群を使う。`backface-visibility:hidden` と深度 transform の組み合わせだけは
+`css-3d-backface-hidden` で degraded を維持する。`transform-style:preserve-3d` の交差は composite として通し、
+検出した場合は stderr と receipt の `preserve3dOrderConflicts` へ警告を残す。それ以外の CSS 3D は通す。
+ただし `preserve-3d` 空間で兄弟同士（3D canvas と兄弟要素など）が z 深度で並び替わる断片は、GPU が DOM 順で描くため
+OSR と絵が変わる（2026-09-04 実測: 外接矩形 MAD 5.0082、OSR では z>0 の兄弟だけが canvas の前）。この型は
+`three-composite-preserve-3d-siblings` で fail-closed にし、警告なしで絵が変わる断片を通さない。DOM 層の
+`preserve3dOrderConflicts` 検出器を兄弟対まで広げれば再解禁できる（次ラウンド候補）。親子対は従来どおり、
+検出器の警告を receipt に残して通す（実測パリティ 0.6374）。
+composite 候補の `@property` は、overlay sheet と DOM 層で補間結果が割れる可能性があるため
+`three-composite-property` で fail-closed とする。方式 A の `three-sampled-chain-css:<プロパティ>` ガードは残すが、
+方式 B ではチェーン内外とも断片全体を描くため `advanced-css` を通す。その他の入口外条件は
+`three-sampled-condition:<条件名>` とし、curve 解析の失敗理由を流用しない。
+
+manifest の各 3D sprite は `entranceMode: "curve" | "sampled" | "composite" | "none"` を持つ。run payload と receipt の
+`gpu.three.overlays[].entrance.mode` は `curve` / `sampled` / `composite` を記録し、`gpu.three.sampling` は sampled
+フレームの `count`、`p50`、`p95` ミリ秒を記録する。composite がある場合は `gpu.three.composite` に overlay 数、
+DOM 要素数、canvas 中継費用と DOM 層費用の p50/p95 を記録する。
 
 ## 11. v2 の cut 音声中間物（2026-08-29 追記）
 

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/README.md

@@ -45,9 +45,11 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `akari narration generate ...`（VOICEVOX / fal-qwen3 ナレーション生成）/
 `akari internal beat-sync-<beatmap|probe-frame|render-when-idle> ...`（beat-sync-edit 内部実行物）/
 `akari sounds [--variant wav] [--force]`（公式音源の一括ダウンロード。プロンプトなし・headless 可）/
-`akari store <connect|status|download|disconnect>`（AKARI Store 連携。マイページで発行した
+`akari store <connect|status|install|download|disconnect>`（AKARI Store 連携。マイページで発行した
 接続トークンを `~/.akari/store-credentials.json`（0600）に保存し、購入済み一覧の確認と
-配布物の取得ができる。`src/store-command.mjs`）/
+配布物の取得ができる。`install <productId> [--from <zip>]` は購入パックを展開し、`PACK.json` の
+収載素材を `~/.akari/assets/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
+zip を使う。`src/store-command.mjs`）/
 `akari assets <list|fetch|sync|...>`（素材カタログの一覧・取得・同期。
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）/

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.37",
+  "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/asset-resolver/README.md

@@ -21,7 +21,14 @@ akari-assets sync                                      # カタログを取得
 akari-assets browse [--port <n>]                       # ローカル HTTP サーバでカタログを閲覧・投入
 ```
 
-`list` の状態バッジ: `☁` 未取得 / `✓` 取得済み（ローカルにキャッシュ済み） / `¥<price>` 未購入。
+`list` の状態バッジ: `☁` 未取得 / `✓` 取得済み（ローカルにキャッシュ済み） / `¥<price>` 未購入 /
+`[installed]` `akari store install` で導入済み。
+
+`akari store install <productId> [--from <zip>]` が `PACK.json` を持つ購入パックを展開すると、
+収載素材は `~/.akari/assets/installed.json` に登録される。resolver はこの索引をリモートカタログへ
+マージし、同じ id があれば導入済みのローカル実体を優先する。`fetch` はネットワークや entitlement
+照会を使わずパックからコピーし、`PACK.json` 記載の sha256 と照合してから通常の素材ライブラリへ
+原子的に登録する。
 
 `fetch` はキャッシュヒットなら即座にそのパスを返す。未取得なら、カタログの `files[]` を全部
 一時ディレクトリへ実体化 → sha256 検証 → （`meta.json` を含む素材は）`validate-asset.mjs` で
@@ -108,8 +115,9 @@ checksums 不一致は、いずれも `AssetResolverError`（`code: 'download_fa
 `AKARI_ASSETS_CATALOG` がリモート URL のとき、`loadCatalog` は取得成功のたびに
 `~/.akari/catalog-cache.json` へ自動キャッシュする。オフライン時（fetch 失敗）はこのキャッシュへ
 フォールバックする。キャッシュも無い場合は「取得できていない」ことを明示するエラーで止まる
-（黙って空のカタログを返したりしない）。`akari-assets sync` はオンライン環境で明示的にキャッシュを
-温めておくためのコマンド。
+（黙って空のカタログを返したりしない）。ただし `installed.json` に導入済み素材がある場合は、
+キャッシュが無くてもその素材だけを `list` / `fetch` できる。`akari-assets sync` はオンライン環境で
+明示的にキャッシュを温めておくためのコマンド。
 
 ## テスト
 

package/vendor/packages/asset-resolver/bin/akari-assets.mjs

@@ -21,6 +21,7 @@ function flagValue(args, name) {
 const STATE_BADGE = { cached: '✓', locked: '¥', available: '☁' };
 
 function badgeOf(item) {
+  if (item.source === 'installed') return '[installed]';
   if (item.state === 'locked') return `¥${(item.price ?? 0).toLocaleString()}`;
   return STATE_BADGE[item.state] ?? '?';
 }
@@ -106,7 +107,7 @@ async function cmdBundle(args, env) {
 }
 
 async function cmdSync(_args, env) {
-  const catalog = await loadCatalog({ env });
+  const catalog = await loadCatalog({ env, includeInstalled: false });
   await cacheCatalog(env, catalog);
   console.log(`カタログを同期しました: ${catalog.items.length} 件（version ${catalog.version ?? '不明'}）`);
 }

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

@@ -4,6 +4,7 @@
 
 import { readFile, mkdir, writeFile } from 'node:fs/promises';
 import { catalogCachePath, resolveAkariHome, resolveCatalogSource } from './env.mjs';
+import { loadInstalledItems, mergeInstalledItems } from './installed.mjs';
 
 function normalizeCatalog(catalog) {
   if (!catalog || !Array.isArray(catalog.items)) {
@@ -30,29 +31,37 @@ export async function cacheCatalog(env = process.env, catalog) {
  * カタログを読む。リモート取得が失敗した場合（オフライン等）はローカルキャッシュへ
  * フォールバックする（黙って劣化させるのではなく、キャッシュが無ければ明示的に失敗する）。
  */
-export async function loadCatalog({ env = process.env, fetchImpl = fetch } = {}) {
+export async function loadCatalog({ env = process.env, fetchImpl = fetch, includeInstalled = true } = {}) {
   const source = resolveCatalogSource(env);
+  const installedItems = includeInstalled ? await loadInstalledItems(env) : [];
+  let catalog;
 
   if (source.kind === 'file') {
     const raw = await readFile(source.value, 'utf8');
-    return normalizeCatalog(JSON.parse(raw));
+    catalog = normalizeCatalog(JSON.parse(raw));
+  } else {
+    try {
+      const res = await fetchImpl(source.value);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      catalog = normalizeCatalog(await res.json());
+      await cacheCatalog(env, catalog);
+    } catch (error) {
+      const cached = await readCatalogCache(env);
+      if (cached) {
+        catalog = cached;
+      } else if (installedItems.length > 0) {
+        catalog = { schema: 'akari-assets-catalog/v0', version: null, base: null, items: [] };
+      } else {
+        throw new Error(
+          `カタログを取得できず、キャッシュもありません（${source.value}）: ${
+            error instanceof Error ? error.message : String(error)
+          }。オンライン環境で先に \`akari-assets sync\` を実行してください`,
+        );
+      }
+    }
   }
 
-  try {
-    const res = await fetchImpl(source.value);
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    const catalog = normalizeCatalog(await res.json());
-    await cacheCatalog(env, catalog);
-    return catalog;
-  } catch (error) {
-    const cached = await readCatalogCache(env);
-    if (cached) return cached;
-    throw new Error(
-      `カタログを取得できず、キャッシュもありません（${source.value}）: ${
-        error instanceof Error ? error.message : String(error)
-      }。オンライン環境で先に \`akari-assets sync\` を実行してください`,
-    );
-  }
+  return includeInstalled ? mergeInstalledItems(catalog, installedItems) : catalog;
 }
 
 export { resolveEffectiveBase } from './env.mjs';

package/vendor/packages/asset-resolver/src/fetch-file.mjs

@@ -19,6 +19,9 @@ function joinRemote(base, key) {
 
 /** files[] エントリ 1 件を { location, remote } に解決する */
 export function resolveFileLocation(base, fileEntry) {
+  if (fileEntry.local_path) {
+    return { location: fileEntry.local_path, remote: false };
+  }
   if (fileEntry.url) {
     if (!isRemoteLocation(fileEntry.url)) {
       throw new Error(`files[].url は絶対 URL である必要があります: ${fileEntry.url}`);
@@ -31,7 +34,7 @@ export function resolveFileLocation(base, fileEntry) {
     }
     return { location: path.join(base, fileEntry.key), remote: false };
   }
-  throw new Error('files[] エントリに url か key のどちらかが必要です');
+  throw new Error('files[] エントリに local_path / url / key のいずれかが必要です');
 }
 
 /**

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

@@ -0,0 +1,116 @@
+// `akari store install` が書くローカル導入索引を、カタログ item の形へ変換する。
+
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveAkariHome } from './env.mjs';
+
+export const INSTALLED_ASSETS_SCHEMA = 'akari-installed-assets/v0';
+
+export function installedAssetsPath(env = process.env) {
+  return path.join(resolveAkariHome(env), 'assets', 'installed.json');
+}
+
+function localPathWithin(root, ...parts) {
+  const absoluteRoot = path.resolve(root);
+  const candidate = path.resolve(absoluteRoot, ...parts);
+  if (candidate !== absoluteRoot && !candidate.startsWith(`${absoluteRoot}${path.sep}`)) {
+    throw new Error(`導入済み素材のパスがパック外を指しています: ${parts.join('/')}`);
+  }
+  return candidate;
+}
+
+function isSafePathSegment(value) {
+  return typeof value === 'string' && value.length > 0
+    && value !== '.' && value !== '..'
+    && !value.includes('/') && !value.includes('\\');
+}
+
+function categoryFromItemPath(itemPath) {
+  const segments = itemPath.replaceAll('\\', '/').split('/').filter(Boolean);
+  return segments[0] === 'assets' && isSafePathSegment(segments[1]) ? segments[1] : 'pack';
+}
+
+function catalogItem(packId, pack, item) {
+  if (!item || !isSafePathSegment(item.id)
+    || typeof item.title !== 'string' || !item.title
+    || typeof item.path !== 'string' || !item.path
+    || item.version === undefined || item.version === null) {
+    throw new Error(`導入済み素材索引に不正な item があります: ${packId}`);
+  }
+  if (!Array.isArray(item.files) || item.files.length === 0) {
+    throw new Error(`導入済み素材索引の item に files[] がありません: ${item.id}`);
+  }
+  const itemRoot = localPathWithin(pack.root, item.path);
+
+  return {
+    id: item.id,
+    title: item.title,
+    category: categoryFromItemPath(item.path),
+    version: item.version,
+    price: 0,
+    source: 'installed',
+    files: item.files.map((file) => {
+      if (!file || typeof file.path !== 'string' || !file.path
+        || !Number.isInteger(file.bytes) || file.bytes < 0
+        || typeof file.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(file.sha256)) {
+        throw new Error(`導入済み素材索引の files[] が不正です: ${item.id}`);
+      }
+      return {
+        name: file.path,
+        local_path: localPathWithin(itemRoot, file.path),
+        sha256: file.sha256,
+        bytes: file.bytes,
+      };
+    }),
+  };
+}
+
+/** installed.json が無ければ空配列、壊れていれば明示エラーを返す。 */
+export async function loadInstalledItems(env = process.env) {
+  const indexPath = installedAssetsPath(env);
+  let index;
+  try {
+    index = JSON.parse(await readFile(indexPath, 'utf8'));
+  } catch (error) {
+    if (error?.code === 'ENOENT') return [];
+    throw new Error(`導入済み素材索引を読めません: ${indexPath}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+
+  if (index?.schema !== INSTALLED_ASSETS_SCHEMA
+    || !index.packs || typeof index.packs !== 'object' || Array.isArray(index.packs)) {
+    throw new Error(`導入済み素材索引の形式が想定と違います: ${indexPath}`);
+  }
+
+  const byId = new Map();
+  for (const [packId, pack] of Object.entries(index.packs)) {
+    if (!isSafePathSegment(packId)
+      || !pack || typeof pack.root !== 'string' || !path.isAbsolute(pack.root)
+      || (typeof pack.version !== 'string' && typeof pack.version !== 'number')
+      || typeof pack.installedAt !== 'string' || !pack.installedAt
+      || !Array.isArray(pack.items)) {
+      throw new Error(`導入済み素材索引に不正な pack があります: ${packId}`);
+    }
+    localPathWithin(path.join(resolveAkariHome(env), 'assets', 'store', packId), pack.root);
+    for (const item of pack.items) {
+      const normalized = catalogItem(packId, pack, item);
+      byId.set(normalized.id, normalized);
+    }
+  }
+  return [...byId.values()];
+}
+
+/** 同じ id は installed item で置換し、ローカルだけの item は末尾へ足す。 */
+export function mergeInstalledItems(catalog, installedItems) {
+  const items = [...catalog.items];
+  const positions = new Map(items.map((item, index) => [item.id, index]));
+  for (const item of installedItems) {
+    const position = positions.get(item.id);
+    if (position === undefined) {
+      positions.set(item.id, items.length);
+      items.push(item);
+    } else {
+      items[position] = item;
+    }
+  }
+  return { ...catalog, items };
+}

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

@@ -130,7 +130,7 @@ export async function resolve(
     throw new AssetResolverError(`カタログに files[] がありません: ${item.id}`, 'invalid_catalog_item');
   }
 
-  const base = resolveEffectiveBase(env, catalog);
+  const base = item.source === 'installed' ? null : resolveEffectiveBase(env, catalog);
   await mkdir(home, { recursive: true });
   const tempRoot = await mkdtemp(path.join(home, '.tmp-resolve-'));
   // validate-asset はディレクトリ名（basename）= id・親ディレクトリ名 = category を要求するので、

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

@@ -13,7 +13,8 @@ import { scanLocalLibrary } from './library.mjs';
 export async function composeState({ env = process.env, fetchImpl = fetch } = {}) {
   const home = resolveAkariHome(env);
   const catalog = await loadCatalog({ env, fetchImpl });
-  const base = resolveEffectiveBase(env, catalog);
+  const hasCatalogItems = catalog.items.some((item) => item.source !== 'installed');
+  const base = hasCatalogItems ? resolveEffectiveBase(env, catalog) : null;
   const installed = scanLocalLibrary(home);
 
   // entitlements API は有料商品が無ければ叩く必要がない（無駄な認証リクエストを避ける）

package/vendor/packages/asset-resolver/test/installed-assets.test.mjs

@@ -0,0 +1,184 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+import { loadCatalog } from '../src/catalog.mjs';
+import { AssetResolverError, resolve as resolveAsset } from '../src/resolve.mjs';
+import { composeState } from '../src/state.mjs';
+import { setupFixtureEnv } from './helpers.mjs';
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const bin = path.join(packageRoot, 'bin', 'akari-assets.mjs');
+
+function sha256(value) {
+  return createHash('sha256').update(value).digest('hex');
+}
+
+function writeInstalled({ home, id = 'installed-one', title = 'Installed One', category = 'pack', payload = 'local payload' }) {
+  const packRoot = path.join(home, 'assets', 'store', 'fixture-pack', 'fixture-pack-v1');
+  const itemPath = category === 'pack' ? `custom/${id}` : `assets/${category}/${id}`;
+  const assetRoot = path.join(packRoot, itemPath);
+  mkdirSync(assetRoot, { recursive: true });
+  writeFileSync(path.join(assetRoot, 'payload.txt'), payload);
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  mkdirSync(path.dirname(indexPath), { recursive: true });
+  writeFileSync(indexPath, `${JSON.stringify({
+    schema: 'akari-installed-assets/v0',
+    packs: {
+      'fixture-pack': {
+        version: 1,
+        installedAt: '2026-01-01T00:00:00.000Z',
+        root: packRoot,
+        items: [{
+          id,
+          title,
+          path: itemPath,
+          version: 1,
+          files: [{ path: 'payload.txt', bytes: Buffer.byteLength(payload), sha256: sha256(payload) }]
+        }]
+      }
+    }
+  }, null, 2)}\n`);
+  return { packRoot, assetRoot, indexPath };
+}
+
+function runCli(args, env) {
+  return spawnSync(process.execPath, [bin, ...args], {
+    encoding: 'utf8',
+    env: { ...process.env, ...env },
+  });
+}
+
+test('installed item をカタログへマージし、CLI は [installed] と source を表示する', async () => {
+  const { env, home } = setupFixtureEnv();
+  writeInstalled({ home, category: 'scene3d' });
+
+  const catalog = await loadCatalog({ env });
+  const item = catalog.items.find((entry) => entry.id === 'installed-one');
+  assert.equal(item.source, 'installed');
+  assert.equal(item.category, 'scene3d');
+  assert.equal(item.price, 0);
+  assert.ok(path.isAbsolute(item.files[0].local_path));
+  assert.deepEqual(Object.keys(item.files[0]).sort(), ['bytes', 'local_path', 'name', 'sha256']);
+
+  const text = runCli(['list'], env);
+  assert.equal(text.status, 0, text.stderr);
+  assert.match(text.stdout, /\[installed\]\s+installed-one/);
+  const json = runCli(['list', '--json'], env);
+  assert.equal(json.status, 0, json.stderr);
+  assert.equal(JSON.parse(json.stdout).find((entry) => entry.id === 'installed-one').source, 'installed');
+});
+
+test('同じ id はリモート catalog より installed item を優先する', async () => {
+  const { env, home } = setupFixtureEnv();
+  writeInstalled({ home, id: 'mini-still', title: '購入済みローカル版', category: 'scene3d' });
+
+  const { items } = await composeState({ env });
+  const item = items.find((entry) => entry.id === 'mini-still');
+  assert.equal(item.title, '購入済みローカル版');
+  assert.equal(item.category, 'scene3d');
+  assert.equal(item.source, 'installed');
+  assert.equal(item.state, 'available');
+});
+
+test('installed item の fetch はローカル実体をコピーし sha256 一致時だけ登録する', async () => {
+  const { env, home, root } = setupFixtureEnv();
+  const payload = 'verified local payload';
+  writeInstalled({ home, category: 'pack', payload });
+  const project = path.join(root, 'project');
+  mkdirSync(project, { recursive: true });
+
+  const result = await resolveAsset('installed-one', { env, project });
+  assert.equal(result.cached, false);
+  assert.equal(result.category, 'pack');
+  assert.equal(readFileSync(path.join(result.dir, 'payload.txt'), 'utf8'), payload);
+  assert.equal(readFileSync(path.join(result.projectDir, 'payload.txt'), 'utf8'), payload);
+});
+
+test('installed item の実体改竄は integrity エラーで fail-closed にする', async () => {
+  const { env, home } = setupFixtureEnv();
+  const { assetRoot } = writeInstalled({ home, category: 'still' });
+  writeFileSync(path.join(assetRoot, 'payload.txt'), 'tampered');
+
+  await assert.rejects(
+    () => resolveAsset('installed-one', { env }),
+    (error) => error instanceof AssetResolverError && error.code === 'integrity',
+  );
+  assert.equal(existsSync(path.join(home, 'assets', 'still', 'installed-one')), false);
+});
+
+for (const indexState of ['missing', 'empty']) {
+  test(`installed.json が ${indexState} のとき既存 list / fetch 出力を変えない`, () => {
+    const { env, home } = setupFixtureEnv();
+    if (indexState === 'empty') {
+      mkdirSync(path.join(home, 'assets'), { recursive: true });
+      writeFileSync(path.join(home, 'assets', 'installed.json'), '{"schema":"akari-installed-assets/v0","packs":{}}\n');
+    }
+    const list = runCli(['list'], env);
+    assert.equal(list.status, 0, list.stderr);
+    assert.equal(list.stdout,
+      `使える素材 2 件（ライブラリ: ${home}）\n`
+      + '  ☁  mini-still\t[still]\tフィクスチャ素材 mini-still\n'
+      + '  ¥500  mini-paid\t[still]\tフィクスチャ素材 mini-paid（有料）\n');
+
+    const fetchResult = runCli(['fetch', 'mini-still'], env);
+    assert.equal(fetchResult.status, 0, fetchResult.stderr);
+    assert.equal(fetchResult.stdout, `取得しました: ${path.join(home, 'assets', 'still', 'mini-still')}\n`);
+  });
+}
+
+test('カタログ到達不能・キャッシュ無しでも installed item だけで一覧化できる', async () => {
+  const { env, home } = setupFixtureEnv({ AKARI_ASSETS_CATALOG: 'https://catalog.invalid/catalog.json' });
+  writeInstalled({ home, category: 'scene3d' });
+  const { base, items } = await composeState({
+    env,
+    fetchImpl: async () => { throw new Error('offline'); },
+  });
+  assert.equal(base, null);
+  assert.deepEqual(items.map((item) => item.id), ['installed-one']);
+  assert.equal(items[0].source, 'installed');
+});
+
+test('カタログ到達不能・キャッシュ無しで installed item も無ければ従来どおり失敗する', async () => {
+  const { env } = setupFixtureEnv({ AKARI_ASSETS_CATALOG: 'https://catalog.invalid/catalog.json' });
+  await assert.rejects(
+    () => loadCatalog({ env, fetchImpl: async () => { throw new Error('offline'); } }),
+    /カタログを取得できず、キャッシュもありません/,
+  );
+});
+
+test('壊れた installed.json は欠損を黙って無視せず明示エラーにする', async () => {
+  const { env, home } = setupFixtureEnv();
+  writeInstalled({ home });
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  const index = JSON.parse(readFileSync(indexPath, 'utf8'));
+  delete index.packs['fixture-pack'].items[0].files[0].sha256;
+  writeFileSync(indexPath, `${JSON.stringify(index)}\n`);
+
+  await assert.rejects(() => loadCatalog({ env }), /files\[\] が不正/);
+});
+
+test('installed item の path が素材ディレクトリ外を指す索引は拒否する', async () => {
+  const { env, home } = setupFixtureEnv();
+  writeInstalled({ home });
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  const index = JSON.parse(readFileSync(indexPath, 'utf8'));
+  index.packs['fixture-pack'].items[0].files[0].path = '../../outside.txt';
+  writeFileSync(indexPath, `${JSON.stringify(index)}\n`);
+
+  await assert.rejects(() => loadCatalog({ env }), /パック外を指しています/);
+});
+
+test('sync のキャッシュへ installed item を混ぜない', () => {
+  const { env, home, catalog } = setupFixtureEnv();
+  writeInstalled({ home });
+
+  const result = runCli(['sync'], env);
+  assert.equal(result.status, 0, result.stderr);
+  const cached = JSON.parse(readFileSync(path.join(home, 'catalog-cache.json'), 'utf8'));
+  assert.deepEqual(cached, catalog);
+  assert.equal(cached.items.some((item) => item.source === 'installed'), false);
+});

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/packages/gpu-export/README.ja.md

@@ -60,11 +60,26 @@ sprite draw state、回転・せん断・非全画面 canvas は中間 2D canvas
 clone では GPU / OSR ともプロパティが初期値のままです。直接宣言した opacity / transform は補間され、
 両エンジンのパリティは保たれます。カスタムプロパティ補間は書き出し用 sheet 側の別課題です。
 
-実 3D 行列は `three-entrance-3d-matrix` で fail-closed になります。root→canvas の祖先チェーン外に
-animation / transition がある場合は、fallback・装飾を別の DOM 描画で合成する方式が本版では未実装の
-ため、`three-html-animated-descendants` で fail-closed になります。既存の filter / clip-path blocker は不変です。
-manifest は `entranceMode`、receipt は `curve` / `sampled` mode と sample 数・sampling 費用 p50/p95 を
-記録します。CSS animation のない scene は従来どおり `three-scene-canvas-direct` です。
+sampled 経路の入口条件は `three-or-canvas-runtime` / `animation-timing` の 2 つです。方式 A が
+root→canvas の祖先チェーンだけでは断片を説明できない場合は、方式 B で
+`three-scene-sampled-composite` に分類します。Three.js は従来どおり overlay sheet で描画し、毎コマその
+canvas を DOM 層コピー内の対応 canvas へ中継し、`[data-akari-3d-fallback]` を隠してから断片全体を
+`drawElementImage` で転写します。これにより canvas 前後の DOM 順と z-index を保ち、断片間は track z と
+宣言 index の順を維持します。
+
+composite は canvas チェーン内外の CSS 3D 幾何と `advanced-css` を扱います。CSS 3D は DOM 層と同じ判定を
+再利用し、深度 transform は通し、preserve-3d の順序競合は警告付きで通し、深度を伴う
+`backface-visibility:hidden` だけ `css-3d-backface-hidden` で degraded のままにします。`@property` は
+sheet / DOM 間のカスタムプロパティ補間パリティを実測するまで `three-composite-property` で fail-closed です。
+`preserve-3d` 要素に Three canvas チェーン上の子と、深度 transform を持つチェーン外の子が同居する composite は
+`three-composite-preserve-3d-siblings` で fail-closed にします。GPU はこれらの兄弟を DOM 順で描くため OSR と
+絵が変わっていました（2026-09-04 実測: 外接矩形 MAD 5.0082。OSR では z>0 の兄弟だけが canvas の前）。
+`preserve3dOrderConflicts` を兄弟対まで広げれば次ラウンドで再解禁できます。親子対は従来どおり警告付きで通します
+（実測パリティ 0.6374）。
+composite の入口外条件は `three-sampled-condition:<条件名>` を報告します。方式 A の
+`three-sampled-chain-css:<プロパティ>` ガードは残します。manifest は `entranceMode`、receipt は
+`curve` / `sampled` / `composite` mode、sampling 費用、composite の DOM 要素数と canvas 中継・DOM 層費用の
+p50/p95 を記録します。CSS animation のない scene は従来どおり `three-scene-canvas-direct` です。
 
 `render-cut --engine auto` は macOS / Windows で GPU を候補にし、プロジェクト全体が適格なら GPU、
 不適格なら OSR を使います。Linux の `auto` は legacy のままで、`--engine gpu` を明示した場合だけ

package/vendor/packages/gpu-export/README.md

@@ -67,11 +67,27 @@ clone currently leaves those properties at their initial values in both GPU and
 opacity and transform keyframes still interpolate, so engine parity is preserved. Custom-property
 interpolation remains a separate export-sheet issue.
 
-Real 3D matrices fail closed as `three-entrance-3d-matrix`. Animation or transition outside the
-root-to-canvas ancestor chain fails closed as `three-html-animated-descendants`, because separate DOM
-rendering for fallback and decoration is not implemented in this version. Existing filter and clip-path
-blockers are unchanged. Manifests record `entranceMode`, and receipts record `curve` / `sampled` mode plus
-sample-count and p50/p95 sampling cost. Scenes without CSS animation remain `three-scene-canvas-direct`.
+The sampled path admits `three-or-canvas-runtime` and `animation-timing`. When method A cannot describe the fragment
+from its root-to-canvas chain, method B classifies it as `three-scene-sampled-composite`. Three.js still renders in
+the overlay sheet; each frame copies that canvas into the matching canvas in the DOM-layer clone, hides
+`[data-akari-3d-fallback]`, then transfers the whole fragment with `drawElementImage`. This preserves DOM order and
+z-index around the canvas, while overlays remain ordered by track z and declaration index.
+
+Composite scenes admit CSS 3D geometry and `advanced-css` both inside and outside the canvas chain. They reuse the
+DOM layer's CSS 3D policy: depth transforms pass, preserve-3d order conflicts pass with a warning, and
+`backface-visibility:hidden` with depth remains degraded as `css-3d-backface-hidden`. `@property` remains fail-closed
+as `three-composite-property` until sheet/DOM custom-property interpolation parity is measured. Other conditions
+outside the composite entry set report `three-sampled-condition:<condition>`. The method-A scan retains
+`three-sampled-chain-css:<property>` as its own guard.
+
+Composite scenes now fail closed as `three-composite-preserve-3d-siblings` when a `preserve-3d` element has both the
+Three-canvas chain child and an off-chain child with a depth transform. GPU paints those siblings in DOM order, so it
+diverged from OSR (measured 2026-09-04: bounding-box MAD 5.0082; OSR put only z>0 siblings in front of the canvas).
+Extending `preserve3dOrderConflicts` to sibling pairs can re-enable this shape in a later round. Parent-child conflicts
+continue to pass with a warning (measured parity 0.6374).
+Manifests record `entranceMode`, and receipts record
+`curve` / `sampled` / `composite`, sampling cost, plus composite DOM-element and p50/p95 copy/DOM-layer costs.
+Scenes without CSS animation remain `three-scene-canvas-direct`.
 
 `render-cut --engine auto` considers GPU export on macOS and Windows, using it when the complete
 project is eligible and otherwise using OSR. On Linux, `auto` remains legacy and GPU export is

package/vendor/packages/render-cut/README.ja.md

@@ -38,6 +38,10 @@ stem はファイル名に使える形へ sanitize されます。既存成果
 
 書き出した動画の空フレーム検証は既定で有効です。ffmpeg の `signalstats,metadata=print` を全フレームに 1 パスだけ実行し、全 YMAX 観測値の下位 5% の中央値を背景 YMAX として推定します。`YMAX <= 背景 + 8` のフレームを背景への張り付きとみなし、0.3 秒以上連続した区間だけを報告します。
 
-走査には `-skip_frame` も縮小も使わないため、デコードした全フレームを測定し、報告可能な最小区間は 0.3 秒のままです。各区間は `verification.declared.blank_frames` と HTML レポートへ、活性な overlay / cut の ID とともに保存されます。宣言上活性な overlay または cut が 1 件以上あれば `warning`、0 件なら `info` です。これらの finding は検証 verdict を変えません。
+走査には `-skip_frame` も縮小も使わないため、デコードした全フレームを測定し、報告可能な最小区間は 0.3 秒のままです。各区間は `verify.declared.blank_frames` と HTML レポートへ、活性な overlay / cut の ID とともに保存されます。宣言上活性な overlay または cut が 1 件以上あれば `warning`、0 件なら `info` です。これらの finding は検証 verdict を変えません。
 
 この走査を無効にするには `--no-verify-blank` を指定します。
+
+## 開発専用の GPU 強制経路
+
+degraded overlay を best-effort の DOM 層で検証する場合に限り、明示した `--engine gpu` とともに `AKARI_FORCE_GPU=1` を設定します。この迂回は検証専用で、出力には GPU 強制の刻印が付くため、納品物には絶対に使用しないでください。

package/vendor/packages/render-cut/README.md

@@ -39,6 +39,10 @@ allowed to replace a declared input.
 
 Blank-frame verification is enabled by default for rendered video artifacts. One full-frame ffmpeg pass runs `signalstats,metadata=print` and estimates the background YMAX as the median of the lowest 5% of YMAX observations. A frame is background-stuck when `YMAX <= background + 8`; only continuous intervals of at least 0.3 seconds are reported.
 
-The scan does not use `-skip_frame` or scaling, so every decoded frame is measured and the minimum reportable interval remains 0.3 seconds. Each interval is stored in `verification.declared.blank_frames` and shown in the HTML report with active overlay and cut IDs. An interval is a `warning` when at least one declared overlay or cut is active and `info` otherwise. These findings never change the verification verdict.
+The scan does not use `-skip_frame` or scaling, so every decoded frame is measured and the minimum reportable interval remains 0.3 seconds. Each interval is stored in `verify.declared.blank_frames` and shown in the HTML report with active overlay and cut IDs. An interval is a `warning` when at least one declared overlay or cut is active and `info` otherwise. These findings never change the verification verdict.
 
 Use `--no-verify-blank` to disable this scan.
+
+## Development-only GPU override
+
+Set `AKARI_FORCE_GPU=1` only when running an explicit `--engine gpu` export to evaluate degraded overlays through the best-effort DOM layer. This override is strictly for verification, marks the output as GPU-forced, and must never be used for a deliverable.

package/vendor/skills/edit-lint/SKILL.md

@@ -61,7 +61,7 @@ node の解決順は `AKARI_NODE_BIN` → PATH の node（20 以上）→ 同梱
 4. 同じコマンドを再実行し、error finding がなく `verdict: "pass"` になるまで繰り返す。analysis.json または captions.json が無い検査は `skipped[]` で確認する。
 5. 書き出し前は、使う出口に合わせて `--engine gpu` または `--engine osr` を追加して再実行する。
    書き出し側が出口を自動選択する場合は `--engine auto` を使い、エンジン適合性も PASS させる。
-6. PASS 後に、カット境界と overlay の開始・終了フレームを実際に視認する。機械検査の PASS を意味的な品質確認の代わりにしない。
+6. PASS 後に、カット境界と overlay の開始・終了フレームを実際に視認する。**開始・終了フレームに加えて中間時刻（各区間の 1/4・1/2・3/4）も必ず視認する** — 拍ちょうど・カット境界ちょうどのフレームは区間の境界値（0% / 100% = 画面外・opacity 0）に必ず当たるため、正常な動きを事故と誤診する（`akari capture --auto` は各オーバーレイ / 字幕区間の中点を含む代表時刻を決定論で導出する）。機械検査の PASS を意味的な品質確認の代わりにしない。
 7. `<project>/.akari/reports/edit-lint-report.html` とフレーム視認結果を編集レポートへ反映し、checkpoint 状態と provenance を実態に合わせて閉じる。
 
 音声も確認するときだけ `--media` を追加する。無音区間と音量値は既定で warning になり、次の明示閾値を指定した検査だけが FAIL になり得る。

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 になる）。

package/vendor/skills/overlay-authoring/motion.md

@@ -131,3 +131,10 @@ base で `transform: translate(-50%, -50%)` により中央配置した要素に
 
 - 実例: 中央チップのポップイン中、接続線との間に隙間が発生（チップだけ右下へずれて拡大）
 - 直し方: keyframe の全ステップに base 分を含める（`translate(-50%,-50%) scale(0.2)` → `translate(-50%,-50%) scale(1)`）。そもそも centering は親ラッパー（grid `place-items: center`）に任せ、アニメ対象要素の base transform を空にしておくのが最安全
+
+### `duration` = 1 拍の要素は拍ちょうどのフレームで必ず 0% / 100% になる（2026-09-04 実測）
+
+拍やカット境界にぴったり合わせた要素（`duration` = ちょうど 1 拍）は、**その拍ちょうどのフレームで必ず境界値**（`0%` / `100%` = 画面外・`opacity: 0`）に当たる。拍ちょうど・カット境界ちょうどの時刻だけを抜いて眺めると、区間の中では正しく動いている要素が全コマ不在に見える。**断片の欠陥ではなく検収側のサンプリングの罠**である点が本節の他項目と異なる。
+
+- 実例: 実制作の目視検収で、拍に合わせた入退場を持つ断片について **2 名が「アニメが死んでいる」と誤認しかけた**（実体は正常動作）
+- 直し方: 目視を境界時刻だけで判定しない。`akari capture --auto` は各オーバーレイ / 字幕区間の**中点**を含む代表時刻を決定論で導出するので、**`capture --auto` の中点フレームで確認する**（`render.json` の `contact_sheet.timestamps_seconds` に中点が入っているかを先に見る）。逆に「本当に何も映っていない」区間の検出は目視に頼らず、render-cut の空フレーム走査（`verify.blank-frames`・連続 0.3 秒以上・活性 overlay / cut があれば `warning`、活性 0 件は `info`）に任せる

package/vendor/skills/render-cut/SKILL.md

@@ -75,6 +75,11 @@ node の解決順は `AKARI_NODE_BIN` → PATH の node（20 以上）→ 同梱
 6. exit code と `.akari/render.json` を確認する。`0` は完走して verify PASS、`1` は拒否または verify FAIL、`2` は実行エラーを表す。`provenance.rasterizer` で採用手段と上位候補を落とした理由を確認する。`verify.findings` には
    尺・フレーム数厳密一致（`verify.frame-count`）・全フレームデコード成功（`verify.decode`）・解像度・fps・コーデック等が並ぶ。
 7. verify PASS 後、CLI が `<project>/.akari/reports/contact-sheet.png` へ自動生成したコンタクトシート（plan から決定論導出した代表時刻 — 冒頭・各カット境界の直後・各オーバーレイ/字幕区間の中点・終盤 — をタイル結合した静止画。`render.json` の `contact_sheet.timestamps_seconds` に時刻列を記録）をキーフレーム視認の起点にする。これで足りない区間（コンタクトシートの上限枚数を超えて間引かれた箇所など）だけ追加でフレーム抽出して視認する。カット元時刻、文字、位置、欠落、透明合成を確認する。
+
+   **サンプリングの罠 — 境界時刻のフレームだけで判定しない。** 拍ちょうど・カット境界ちょうどのフレームは、区間の境界値（0% / 100% = 画面外・opacity 0）に必ず当たる。duration がちょうど 1 拍の要素はこの位置で消えて見えるため、**正常な動きを「アニメが死んでいる」と誤診する**。
+
+   - **中間時刻（各区間の 1/4・1/2・3/4）を必ず見る**。時刻列（`render.json` の `contact_sheet.timestamps_seconds`）に各オーバーレイ / 字幕区間の**中点**が含まれていることを確認し、間引かれて中点が無い区間は [`akari capture --auto`](../../docs/contract-2026-08-29-capture-v0.md)（同じ代表時刻を決定論で導出。`-t <時刻>` との和集合も可）で撮り足す。
+   - **空フレーム走査 warning の読み方**（既定 ON・`--no-verify-blank` で OFF）: `verify.findings` の `verify.blank-frames` は、輝度が背景レベルに張り付いた**連続 0.3 秒以上**の区間を挙げたもの。severity は、その区間に宣言上活性な overlay / cut が **1 件以上あれば `warning`**（カットの尺に対して中身のアニメが先に終わった疑い＝要調査）、**活性 0 件なら `info`**（意図した黒区間の可能性が高く、そのまま無視してよい）。区間表と活性 id は `render.json` の `verify.declared.blank_frames` と HTML レポートで読む。これらの finding は verify の verdict を変えない。
 8. 機械検証値、成果物 SHA-256、採用したラスタライズ手段、フォールバック理由、コンタクトシート起点のキーフレーム視認結果を報告する。verify FAIL の場合は納品可能と表現せず、`.akari/render-tmp/` を保持して原因を報告する。
 
 ## 出力契約

package/vendor/skills/verify/SKILL.md

@@ -52,6 +52,11 @@ npm run lint                                       # eslint "extensions/*/src/**
 `shell-s12-preview-tab` / `shell-sc-repair` / `shell-strip-menu-repair` 等）。
 以下は `shell-s4-tabs`（report.md §6-2）と `preview-streaming`（report.md §2）で確立・実証済みの再現手順。
 
+**フレーム視認は境界時刻だけで判定しない**。拍ちょうど・カット境界ちょうどのフレームは区間の境界値
+（0% / 100% = 画面外・opacity 0）に必ず当たるため、正常な動きを事故と誤診する。区間の中間時刻
+（1/4・1/2・3/4）も必ず撮る（`akari capture --auto` は各オーバーレイ / 字幕区間の中点を含む代表時刻を
+決定論で導出する）。
+
 ### 手順
 
 1. **ビルド**（L0 に加え electron 実体が要る）: