akari-video 1.0.0 → 1.0.2

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

@@ -89,7 +89,7 @@ seek → ready → invalidate → paint → verify → write
 
 第1段・第2段とも`--user-data-dir`を渡し、本体アプリの単一インスタンスロック（userData単位）と分離する。既定は`launchElectronExport`が書き出しごとに`os.tmpdir()`直下へ`mkdtemp("akari-osr-")`で作る短い一意なディレクトリで、子のclose後に`finally`で削除する。呼び出し側が`userDataDir`を明示した場合はそれを使い、作らず消さない。これによりアプリ起動中でも書き出せる。子がexit 0で終了して出力を作らなかった場合は、launcherが失敗として扱う。**2026-09-28 改訂（#114）**: 出力の隣に置くとプロジェクトのパス長とChromiumのキャッシュ階層がWindowsのMAX_PATHを超え、キャッシュ作成エラーがstderrに出ていた。
 
-**Windows のアプリ別 GPU 設定の一時上書き（2026-09-01 追記・§11.7）**: `platform === "win32"` かつソフト描画でないとき、第1段・第2段とも launcher（`launchElectronExport`・gpu / osr 共通の spawn 点）は、`auto` では GPU 出口（`options.exit === "gpu"`・gpu-export の electron-main）のときだけ、`force` では OSR 出口でも、spawn の直前に `HKCU\Software\Microsoft\DirectX\UserGpuPreferences` へ「値名 = 実行体のフルパス（`path.win32.resolve` で正規化）・REG_SZ `GpuPreference=2;`」を書き、子の `close` 後（exit code に関わらず・spawn エラーでも）に `finally` で必ず 1 回復元する（無かったなら削除・あったなら元の値へ）。方針は呼び出し側の `gpuPreference` → env `AKARI_EXPORT_GPU_PREFERENCE` → `auto` の順に解決し、`auto` は利用者が明示した値（`GpuPreference=1;` 等）を黙って上書きしない（`force` だけが上書き + 復元する）。書く前に sidecar `<AKARI_HOME ?? ~/.akari>/gpu-preference-override.json` を置き、復元後に削除する。`launchElectronExport` は毎回冒頭で sidecar があれば先に復元する。記録は戻り値の `gpuPreference`（`exit` 込み）と receipt の `provenance.gpu_preference`。OSR 出口を `auto` で外す根拠は §11.7（2026-09-02 改訂）。他 OS はバイト同一の no-op（記録に `reason: platform` だけ残す）。開発用に `AKARI_EXPORT_ALLOW_DESKTOP=0` で第1段（インストール済みアプリ）を候補から外せる（明示引数 `allowDesktop` が env より優先）。
+**Windows のアプリ別 GPU 設定の一時上書き（2026-09-01 追記・§11.7）**: `platform === "win32"` かつソフト描画でないとき、第1段・第2段とも launcher（`launchElectronExport`・gpu / osr 共通の spawn 点）は、`auto` では GPU 出口（`options.exit === "gpu"`・gpu-export の electron-main）のときだけ、`force` では OSR 出口でも、spawn の直前に `HKCU\Software\Microsoft\DirectX\UserGpuPreferences` へ「値名 = 実行体のフルパス（`path.win32.resolve` で正規化）・REG_SZ `GpuPreference=2;`」を書き、子の `close` 後（exit code に関わらず・spawn エラーでも）に `finally` で必ず 1 回復元する（無かったなら削除・あったなら元の値へ）。方針は呼び出し側の `gpuPreference` → env `AKARI_EXPORT_GPU_PREFERENCE` → 保存済みの許可があれば `auto`、なければ `off` の順に解決し、`auto` は利用者が明示した値（`GpuPreference=1;` 等）を黙って上書きしない（`force` だけが上書き + 復元する）。書く前に sidecar `<AKARI_HOME ?? ~/.akari>/gpu-preference-override.json` を置き、復元後に削除する。`launchElectronExport` は毎回冒頭で sidecar があれば先に復元する。記録は戻り値の `gpuPreference`（`exit` 込み）と receipt の `provenance.gpu_preference`。OSR 出口を `auto` で外す根拠は §11.7（2026-09-02 改訂）。他 OS はバイト同一の no-op（記録に `reason: platform` だけ残す）。開発用に `AKARI_EXPORT_ALLOW_DESKTOP=0` で第1段（インストール済みアプリ）を候補から外せる（明示引数 `allowDesktop` が env より優先）。
 
 `--render`は`package.json`の`main`（`electron-entry.js`）がTheiaより前に捕捉する。backend fork・初期ウィンドウ・contribution・単一インスタンスロックを起動せず、`--akari-main`で指定したランタイム（既定はosr-export、gpu-exportも指定可能）へ直行するため、スプラッシュは表示されない。通常起動で`--render`が無い場合は従来どおりTheiaを起動する。
 
@@ -237,7 +237,7 @@ OS のアプリ別 GPU 設定だけが効き、プロセス生成時に評価さ
 裁定（実装 = `packages/osr-export/src/gpu-preference.mjs` / `gpu-adapters.mjs`、`packages/gpu-export/src/gpu-diagnostics.mjs`）:
 
 1. **適用点（2026-09-02 改訂・feedback-r1）**: `launchElectronExport`（gpu / osr 共通の spawn 点）。`platform === "win32"` かつ `options.soft` でないときだけ動く。他 OS / soft は no-op（記録に理由だけ残す）。**`auto` は GPU 出口だけ**（gpu-export の electron-main を起動する launch = export / capture。`launchGpuExport` が `options.exit = "gpu"` を渡す）。OSR 出口（osr-export の electron-main = export / capture。`exportWithOsr` / `captureFramesWithOsr` が `exit: "osr"` を渡す）は `auto` では書かず（skip・reason `not-gpu-exit`）、**`force` のときだけ**書く（終了後の復元は同じ）。`exit` 未指定は `"osr"` 扱い（保守的）。
-2. **方針値 `gpuPreference`**: `"auto"`（既定）| `"off"` | `"force"`。解決順 = 呼び出し側の `options.gpuPreference` → env `AKARI_EXPORT_GPU_PREFERENCE` → `"auto"`。不正値は許容値を含むメッセージで throw。render-cut は `--gpu-preference auto|off|force`。
+2. **方針値 `gpuPreference`**: `"auto"` | `"off"`（許可なしの既定）| `"force"`。解決順 = 呼び出し側の `options.gpuPreference` → env `AKARI_EXPORT_GPU_PREFERENCE` → 保存済みの許可があれば `"auto"`、なければ `"off"`。不正値は許容値を含むメッセージで throw。render-cut は `--gpu-preference auto|off|force`。
 3. **対象 exe** = `launcher.executable` を `path.win32.resolve` で正規化（`/` → `\`、Windows 設定アプリが書く形式）。レジストリは `HKCU\Software\Microsoft\DirectX\UserGpuPreferences`、値名 = exe フルパス、REG_SZ `GpuPreference=2;`。読み書きは `%SystemRoot%\System32\reg.exe`（`query` / `add ... /f` / `delete ... /f`）を `spawnSync` で叩く。ネイティブモジュール禁止・管理者権限不要・`reg query` は値の部分（ASCII）だけ parse する。`registry` 依存 `{ read, write, remove }` は注入可能。
 4. **判定は純関数** `planGpuPreference({ platform, policy, soft, current, exit })` → `{ action: "write" | "skip", value, restore, reason }`: platform ≠ win32 → skip `platform` / soft → skip `soft` / off → skip `policy-off` / **auto かつ exit ≠ gpu → skip `not-gpu-exit`（2026-09-02 改訂）** / current === `GpuPreference=2;` → skip `already-high-performance` / current === null → write + 終了後 remove / current がそれ以外（`GpuPreference=1;` 等）: `auto` → skip `user-preference-respected`（利用者の明示設定を黙って上書きしない）、`force` → write + 終了後 current へ戻す。defensive な skip 理由 4 つ（いずれも stderr に warning を出して spawn は続ける・r0 受理）: `executable-missing`（正規化後の exe が存在しない）/ `registry-unavailable`（`reg query` を spawn できない）/ `sidecar-unavailable`（sidecar が書けないのでレジストリも書かない）/ `write-failed`（`reg add` 失敗・sidecar を消して続行）。
 5. **順序と復元**: write → spawn → 子の `close`（exit code に関わらず・spawn エラーでも）→ `finally` で restore を必ず 1 回。復元に失敗したら stderr に `[gpu-preference] restore failed: ...` を出し記録に `restored: false` を残す（throw しない）。

package/vendor/docs/contract-2026-09-02-shape-item-v0.md

@@ -23,6 +23,7 @@
 ```
 
 - `shape`: `rect | rounded-rect | ellipse | line | arrow | speech-bubble`
+- `line` / `arrow` の `params.startCapScale` と `params.endCapScale` は任意の数値（0.5〜3.0、未指定時 1.0）。始点・終点の飾りを個別に拡大縮小する。既存データへの追記は不要。
 - `params`（全部 optional・additionalProperties false で開始 — 広げる方向は互換）:
   `width`（>0・既定 600）/ `height`（>0・既定 340。line / arrow は既定 80）/
   `fill`（既定 `#f97316`）/ `stroke`（既定なし = 描かない）/ `strokeWidth`（≥0・既定 0。line / arrow は 8）/

package/vendor/docs/contract-2026-10-02-fragment-font-subset-v0.md

@@ -0,0 +1,44 @@
+# contract — 断片書体の部分化と字形検査 v0
+
+- 決定日: 2026-10-02
+- 対象: HTML 断片の `@font-face`
+- 状態: 段 1 の字形検査を実装。段 2 の書き出し時の自動部分化と段 3 のキャッシュ掃除は予定
+
+## 1. 目的と順序
+
+断片の文言を直すたびに手で部分フォントを作り直す負担と、追加した字だけが別書体に切り替わる見落としを減らす。段 1 は `edit-lint` の字形検査、段 2 は書き出し時の自動部分化、段 3 は不要になったキャッシュの掃除とする。プレビューは原本の書体をそのまま読む。3D テキストと字幕の書体は対象外。
+
+## 2. 使う字の集合
+
+lint は断片から**描画される字**を集める。テキストノード（コメント・`<style>`・通常の `<script>` を除く）、文字参照を解いた字、CSS `content:` の文字列と CSS エスケープを解いた字、`content: attr(x)` の属性値、`params` / `vars` の文字列値、`type="application/json"` の宣言内の文字列値、`data-akari-font-chars`、`text-transform` の変換後の字を含む。数値文字参照と HTML 4.01 の名前付き文字参照 252 個を解く。`text-transform` は `uppercase`・`lowercase`・`capitalize`・`full-width` の対応する字を足し、`none` では足さない。空白・制御文字・既定で描画されない字は数えない。通常の `alt`・`title` などの属性値や、CSS のカスタムプロパティに置いた文字列は描画集合に直接は入れない。
+
+段 2 の部分化は**ソース全体の字**を使う予定である。書体の `data:` URI の中身を除くソース、文字参照と CSS エスケープを解いた字、`params` / `vars`、`data-akari-font-chars` に、ASCII 印字可能文字・和文約物・省略記号などの安全余白を足す。**部分化用の広い集合 ⊇ lint 用の狭い集合**を保つ。
+
+実行時の script が字を生成する断片は、ルート要素に `data-akari-font-chars="追加され得る字"` を置く。この値は lint の描画集合にも入る。宣言のない通常の `<script>` について lint は静的収集が不完全であることを info で知らせ、段 2 では書体を絞らない予定である。
+
+```html
+<div data-akari-font-chars="晴雨雪">
+  <style>@font-face { font-family: MyFont; src: url("../assets/font/my-font.ttf"); }</style>
+  <span>今日の天気</span>
+</div>
+```
+
+## 3. 字形検査
+
+`overlays.fragment-font-glyphs` は `@font-face` を持つファイル参照の断片を対象とする。プロジェクト内の断片と共有ライブラリ参照の断片を同じように扱い、相対パスと `data:` URI の書体を読む。断片が読む書体の cmap の**和集合**に描画集合の字が無ければ、欠けた字の先頭 20 字と件数、コードポイント、断片と書体のパスを含む warning を 1 件出す。通常の `<script>` があり宣言のない断片には静的に集めきれない旨の info を出す。書体を読めない場合やプロジェクト外への参照には info を出し、その断片で 1 本でも書体を読めなければ欠けた字の warning は出さない。`@font-face` のない断片は対象外。
+
+ファイル参照で読める拡張子は `.ttf` / `.otf` / `.woff` / `.woff2` で、TTC は `data:` URI のときだけ読める。クエリつきの参照（`a.woff2?v=2`）や他の拡張子、`local()` や `https:` だけの `src` は「読める書体参照がありません」の info になる。Unicode cmap の format 4 / 12 を読み、異体字セレクタ用の format 14 は見ない。Unicode cmap がない書体（記号用の符号化だけの書体など）、壊れた書体、WOFF2 コレクションは読めない旨を info で知らせる。
+
+和集合の検査は、ある要素に指定された書体に字が無くても、別の参照書体にその字があれば見逃す。`src` の代替リスト（`url(a), url(b)`）も全部の和集合で数えるが、ブラウザは使える先頭しか使わないため見逃しがあり得る。`unicode-range` は見ない。体験版など字数を制限した書体でも見逃しが起こり得る。書き出しでは全断片を 1 枚の文書に並べるため、他の断片の `@font-face` で描かれる字も、その断片の検査では警告になり得る。部品アイテムの `source.text` による文字の差し替えは数えない。結合文字（NFD。例: `か` + U+3099）は、合成済みの字だけを持つ書体だと誤警告になる。CSS の `font-family`、変数、代替書体を静的に確定しないため、warning は表示上の欠けを断定せず、書き出しを止めない。
+
+## 4. 自動部分化とキャッシュ（予定）
+
+段 2 では書き出し時に断片と書体ごとに部分化し、プレビューでは原本を読む。部分化器は版を固定した hb-subset の WASM を同梱する予定である。TTF / OTF は元と同じ sfnt 形式で、レイアウト機能、ヒンティング、可変軸、`.notdef` を保持する。通常の `<script>` があり `data-akari-font-chars` のない断片、WOFF2 の書体、部分化に失敗した書体は絞らず、理由を報告する。既存の手作業の部分フォントはそのまま利用できる。`AKARI_FONT_SUBSET=off` で部分化を外せるようにする。16MiB の埋め込み上限は部分化**後**の大きさに適用する。
+
+一時ファイルはプロジェクトの `.akari/cache/font-subset/` に置く。鍵は書体内容の SHA-256、使う字、部分化器の版と設定から作る。段 3 では書き出し後に今回使わなかった期限切れの鍵だけを掃除する。`akari clean` の既存の `.akari/cache/**` 規則を使い、`assets/` の原本は削除しない。未参照の原本書体の一覧化は別途検討する。
+
+出力プレビューで同じ書体が断片ごとに別 URL になる可能性は、実測してから別途扱う。この契約ではプレビューの配信方法を変えない。
+
+## 5. 利用許諾
+
+書き出し時の一時的な部分化は、書体の種類を問わずプロジェクト内のキャッシュだけに置き、部分フォントを頒布しない運用として扱う。字形自体は変更しない。利用者が部分化を外す手段を設ける。

package/vendor/docs/contract-2026-10-02-textstyle-v1-rich.md

@@ -62,7 +62,7 @@ v1.1（2026-10-02）では pattern に限り `id` に `heart` / `thunder` を追
 
 ## 3. 柄の定義と変換元
 
-初期 7 id の図形、タイルの位相・基準寸法・重ね順は素材側 `assets/overlay/telop-pattern-*/fragment.html` の `--i-fill` と SVG データ URI を正本として固定する。`diamond` は斜め筋と菱形、`dot` はずれた水玉、`stripe` は帯、`gingham` は格子、`skull` は髑髏、`hazard` は警告三角、`night` は星点と星形を持つ。描画側は id から固定テンプレートを選び、検証済み `fg` / `bg` と `scale` を埋めて自己完結した CSS 画像を作る。同じ id と 3 値は 4 経路で同じ画素入力とする。素材の多色グラデや複数の独立した色を単一 `fg` / `bg` に縮約できないときは、変換プリセットに別の展開済み色を追加する改訂契約を起こすか §9 の残留とする。CSS `mask` による切り抜きはこの v1 pattern に含めない。
+初期 7 id の図形、タイルの位相・基準寸法・重ね順は素材側 `assets/overlay/telop-pattern-*/fragment.html` の `--i-fill` と SVG データ URI を正本として固定する。`diamond` は 45deg / -45deg の筋（各 2px / 13px 周期、`fg` 32%）を菱形 SVG（幅 26px、図形 opacity .5）の上に重ねる。`dot` は 16px タイルの radial 2 層で、中心 (8,8) は 2→3px のフェードと `fg` 50%、中心 (0,0) は 1.6→2.6px のフェードと `fg` 35% を持つ。`gingham` は 90deg / 0deg の格子 2 層（各 9px / 22px 周期、`fg` 55%）で、0deg 層は下端起点、交差部の合成 opacity は .7975 とする。`stripe` は帯、`skull` は髑髏、`hazard` は警告三角、`night` は星点と星形を持つ。描画側は id から固定テンプレートを選び、検証済み `fg` / `bg` と `scale` を埋めて自己完結した CSS 画像を作る。これら 3 柄の筋・水玉・格子は fragment と同じ CSS gradient 層で作り、菱形だけ SVG データ URI を使う。同じ id と 3 値は 4 経路で同じ画素入力とする。素材の多色グラデや複数の独立した色を単一 `fg` / `bg` に縮約できないときは、変換プリセットに別の展開済み色を追加する改訂契約を起こすか §9 の残留とする。CSS `mask` による切り抜きはこの v1 pattern に含めない。
 
 v1.1 の `heart` / `thunder` は別の正本 URI を §11 で追加する。透過柄の下に `bg` のグラデーションを敷く 2 層合成を用いるため、上記の 2 色縮約条件はこの 2 id には適用しない。
 
@@ -263,14 +263,14 @@ TODO（B-2 所有外）: インスペクタの「文字色」操作は `fill`
 
 ## 11. v1.1（2026-10-02）
 
-素材側の仕分けで、`telop-pop-heart` と `telop-pop-thunder` は地がグラデーションであり、単色 `pattern.bg` では原画を表せないと確定した。`pattern.bg` の gradient は保存時に停止点と角度を展開し、描画時は `background-image: <透過 pattern SVG>, linear-gradient(...)` の順に合成する。**`bg` 文字列は v1 の 1 層（SVG 内の `<rect>`）をバイト不変で維持し、2 層は `bg` がグラデーションオブジェクトのときだけ使う。**第 1 層のサイズは基準タイル × `scale`、第 2 層のグラデーションは行全体の描画矩形とする。両層の位置は行の共通原点に合わせ、`words[]` 分割後も位相を戻さない。2 層の SVG に地色を焼き込まない。
+素材側の仕分けで、`telop-pop-heart` は地がグラデーション、`telop-pop-thunder` は地が繰り返し縞（`repeating-linear-gradient`）であり、単色 `pattern.bg` では原画を表せないと確定した。v1.1 の `thunder` は縞を 2 色グラデーションで近似する。`pattern.bg` の gradient は保存時に停止点と角度を展開し、描画時は `background-image: <透過 pattern SVG>, linear-gradient(...)` の順に合成する。**`diamond` / `dot` / `gingham` 以外の `bg` 文字列は v1 の 1 層（SVG 内の `<rect>`）をバイト不変で維持し、2 層は `bg` がグラデーションオブジェクトのときだけ使う。**3 柄は §3 の CSS gradient 層を保つため、`bg` が文字列でも最背面に単色の CSS gradient を敷く。第 1 層のサイズは基準タイル × `scale`、地のグラデーションは行全体の描画矩形とする。各層の位置は行の共通原点に合わせ、`words[]` 分割後も位相を戻さない。透過 SVG に地色を焼き込まない。
 
 | 項目 | v1 | v1.1 |
 |---|---|---|
 | `pattern.id` enum | `diamond` / `dot` / `stripe` / `gingham` / `skull` / `hazard` / `night` | 左記に `heart` / `thunder` を追加 |
 | `pattern.bg` の型 | `hexColor` 文字列 | `hexColor` 文字列または `{stops,angle_deg}` |
 | `fg` の alpha | `hexColor` の `#RRGGBBAA` を受理 | 9 id とも SVG の `fill` に alpha を保持し、図形固有の opacity と合成 |
-| CSS 合成式 `background-image` | `url("<rect を持つ pattern SVG>")` の 1 層 | `bg` 文字列は v1 とバイト一致。`bg` グラデのみ `<透過 pattern>, linear-gradient(...)` の 2 層 |
+| CSS 合成式 `background-image` | `url("<rect を持つ pattern SVG>")` の 1 層 | `diamond` / `dot` / `gingham` は §3 の CSS gradient 層 + 地の CSS gradient。他の id は `bg` 文字列で v1 とバイト一致し、`bg` グラデのみ `<透過 pattern>, linear-gradient(...)` の 2 層 |
 | 位相・タイル寸法 | 初期 7 id の既定タイルと位相 | `heart` は 14px、`thunder` は 30px。`thunder` の位相は 4px 2px。1 層は位置 1 組・サイズ 1 組、2 層は位置 2 組・サイズはタイルと行全体 |
 | 対象外の `night` / `skull` / `stripe` | id は受理 | 素材の textstyle 変換は対象外。`night` は星点が別色、`skull` は SVG 2 色、`stripe` は独立した斜線グラデーションが必要 |
 

package/vendor/docs/contract-2026-10-04-asset-tier-v1.md

@@ -0,0 +1,44 @@
+# 素材 tier 契約 v1
+
+- 日付: 2026-10-04
+- 状態: 実装契約 v1
+- 関連: [素材ライブラリ契約](contract-2026-07-13-asset-library.md)
+
+`meta.json` の `tier: "free" | "pro"` は必須。`price` は廃止予定の任意フィールドとして残すが、`tier` がある場合は無視し、1 版後に削除する。旧メタを読むときだけ、`tier` が無ければ `price === 0` の場合に限り `free` と解釈し、`null`・欠落・非数値を含むそれ以外は `pro` とする（fail-closed）。新規メタと v1 validator には `tier` が必要。
+
+`tier: "pro"` と `license.spdx: "CC0-1.0"` の組み合わせは validator のエラー。`tier: "free"` には CC0 を推奨し、それ以外のライセンスには warning を出す。tier はライセンスの許諾内容を置き換えない。
+
+切替前に CC0 で取得されたコピーは CC0 のまま。後から tier を変更しても、既に配布された CC0 コピーの利用条件は変更されない。
+
+- 鍵はライブラリ側に置く。`composeState` は `tier === "pro" && !entitled` を `locked` とし、fetch も同じ条件で認可する。解錠は (a) 店応答の `pass` が非 null（Lifetime パス保有。`all-access-pass` id も同値）なら全 Pro、または (b) item の `product_id` が `entitlements[].product_id` に含まれる場合。店はパス対象商品を entitlement 行へ展開するため、応答に `all-access-pass` id は入らない。item と無関係に全 Pro を解錠できるのは (a) だけ。取得済み素材は `cached` のまま使える。
+- resolver の一覧出力は各 item に `tier` と `machineTags` の `tier:<tier>` を持たせる。
+- 公開 catalog の Pro 項目は `files` を持たない。非空の `files` があれば `invalid_catalog_item` として取得を拒否する。locked 項目の一覧・`/api/items` 応答にも `files` を含めない。
+- 利用者取り込み（`akari assets add`）は `tier: "free"` とする。
+
+## § 取得時の素材参照（2026-10-05）
+
+resolver・CLI・shell からの取得参照は `category/id` とする。bare id はカタログ内で一意な場合だけ互換解決する。複数の category に同じ id があれば、候補の `category/id` を含む `ambiguous_id` エラーを返し、先頭の item を選ばない。
+
+## § `source` の union（2026-10-04）
+
+`source` は **external**（既存 v0）または **akari-r2** の一方だけを取る。external は `url` が必須で、`acquisition`・`license_at_source`・`attribution_required` は従来どおり。akari-r2 は絶対 URL または R2 key の `image` と `preview` が必須で、`width`・`height`・`bytes` は任意の正整数。`url` があれば external、`image` があれば akari-r2 と判別する。両方ある形、どちらもない形は不正。
+
+`remote: true` の素材は実体がディレクトリに無いため akari-r2 の `source` を必須とする。`remote` が無い、または false の素材では `source` は任意。既存の公開 `catalog/` は external + `remote: true` の旧形式のため、validator は `catalog/` 配下に限って互換性を維持する。新規メタは akari-r2 に従う。
+JSON Schema は `remote: true` なら `source` 必須までを表し、akari-r2 必須と既存 `catalog/` の external 互換は validator が経路を見て判定する。
+
+## § textstyle（字幕スタイル）の Pro item（2026-10-05）
+
+公開カタログの textstyle Pro item は `id`、`category: "textstyle"`、`tier: "pro"`、
+`product_id: "telop-rich-pack-01"`、`version`、`preview`、`license`、`tags`、`title` を持つ。
+`files` は持たせない。
+
+束 zip は `<product_id>-v<version>/` の直下に `README.md`、`LICENSE.md`、
+`checksums.txt` を置き、各素材を次の形で収める。
+
+`assets/textstyle/<id>/{meta.json,preset.json,preview.png}`
+
+`resolve` は対象の 1 件だけを `<ライブラリ>/textstyle/<id>/` へ配置し、
+`validate-asset` で `preset.json` の `format: "akari-textstyle"` と `id` の一致を検証する。
+`preview` URL は `https://akari.video/lab/media/telop-rich-pack/textstyle/<id>.png` の形とする。
+配置後は既存の textstyle ライブラリ読み込みが `preset.json` を読み、
+「テキスト > スタイル」へ並べる。未取得 textstyle の棚カード表示は別票で扱う。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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/bin/akari-assets.mjs

@@ -4,7 +4,7 @@
 //   akari-assets list [--category <c>] [--source <lab|site|own>] [--json]
 //   akari-assets add <path...> --plan [--json]
 //   akari-assets add --apply <plan.json> [--json]
-//   akari-assets fetch <id> [--project <dir>] [--reference] [--force]
+//   akari-assets fetch <ref> [--project <dir>] [--reference] [--force]  （ref は category/id）
 //   akari-assets bundle --project <dir> [--dry-run]
 //   akari-assets sync
 //   akari-assets browse [--port <n>]
@@ -58,16 +58,17 @@ function validateArgs(sub, args) {
   if (sub === 'bundle' && !seen.has('--project')) throw new Error('--project <dir> が必要です');
   if (sub === 'credits' && !seen.has('--project')) throw new Error('--project <dir> が必要です');
   if (sub === 'fetch') {
-    if (args[0] !== positional[0]) throw new Error('fetch の先頭には素材 ID を指定してください');
+    if (args[0] !== positional[0]) throw new Error('fetch の先頭には素材参照 category/id を指定してください');
     if (seen.has('--reference') && !seen.has('--project')) throw new Error('--reference には --project <dir> が必要です');
   }
 }
 
-const STATE_BADGE = { cached: '✓', locked: '¥', available: '☁' };
+const STATE_BADGE = { cached: '✓', locked: '🔒 Pro', available: '☁' };
 
 function badgeOf(item) {
   if (item.source === 'installed') return '[installed]';
-  if (item.state === 'locked') return `¥${(item.price ?? 0).toLocaleString()}`;
+  if (item.state === 'locked') return STATE_BADGE.locked;
+  if (item.state === 'available' && item.tier === 'pro') return '✓ Pro';
   return STATE_BADGE[item.state] ?? '?';
 }
 
@@ -87,7 +88,7 @@ async function cmdList(args, env) {
 
   console.log(`使える素材 ${filtered.length} 件（ライブラリ: ${libraryRoots.write}）`);
   for (const item of filtered) {
-    console.log(`  ${badgeOf(item)}  ${item.id}\t${item.sourceKind}\t[${item.category}]\t${item.title}`);
+    console.log(`  ${badgeOf(item)}  ${item.category}/${item.id}\t${item.sourceKind}\t[${item.category}]\t${item.title}`);
   }
 }
 
@@ -107,9 +108,9 @@ async function cmdAdd(args, env) {
 }
 
 async function cmdFetch(args, env) {
-  const id = args[0];
-  if (!id || id.startsWith('--')) {
-    console.error('使い方: akari-assets fetch <id> [--project <dir>] [--reference] [--force]');
+  const ref = args[0];
+  if (!ref || ref.startsWith('--')) {
+    console.error('使い方: akari-assets fetch <ref> [--project <dir>] [--reference] [--force]（ref は category/id）');
     process.exitCode = 1;
     return;
   }
@@ -122,7 +123,7 @@ async function cmdFetch(args, env) {
     return;
   }
   try {
-    const result = await resolveAsset(id, { env, project, force, reference });
+    const result = await resolveAsset(ref, { env, project, force, reference });
     console.log(`${result.cached ? '取得済み（キャッシュ）を使用' : '取得しました'}: ${result.dir}`);
     if (result.projectDir) console.log(`  プロジェクトへコピー: ${result.projectDir}`);
     if (result.referenced) console.log(`  参照を記帳: ${result.category}/${result.id}`);
@@ -202,8 +203,8 @@ function printUsage() {
                                           出どころ・取得状態つき素材一覧
   add <path...> --plan [--json]           ローカル素材の取り込み計画（書き込みなし）
   add --apply <plan.json> [--json]        計画で選択した素材を複製して登録
-  fetch <id> [--project <dir>] [--reference] [--force]
-                                          素材を解決して登録（--reference はコピーせず参照を記帳）
+  fetch <ref> [--project <dir>] [--reference] [--force]
+                                          ref は category/id（bare id は一意な場合のみ）。--reference はコピーせず参照を記帳
   bundle --project <dir> [--dry-run]      参照素材をプロジェクトへ実体化（素材をまとめる）
   migrate [--dry-run]                     ライブラリを作業場へ移行
   sync                                    カタログを取得してローカルにキャッシュ（オフライン用）

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

@@ -43,9 +43,10 @@
 
   /* ---- グリッド ---- */
   const grid = $('#grid');
+  const tierLabel = (item) => item.tier === 'free' ? '無料' : 'Pro';
   function badgeOf(item) {
     if (item.state === 'cached') return '<span class="badge got">✓ 取得済み</span>';
-    if (item.state === 'locked') return `<span class="badge paid">¥${(item.price ?? 0).toLocaleString()}</span>`;
+    if (item.state === 'locked') return `<span class="badge paid">${tierLabel(item)}</span>`;
     return '<span class="badge">☁ 未取得</span>';
   }
   function renderGrid() {
@@ -76,9 +77,9 @@
     const isAudio = item.category === 'audio';
     detail.append(el(`<div>
       ${item.preview && !isAudio ? `<img class="big" src="/thumb/${encodeURIComponent(item.id)}" alt="">` : ''}
-      ${item.preview && isAudio ? `<audio controls preload="none" src="/media/${encodeURIComponent(item.id)}"></audio>` : ''}
+      ${isAudio && item.mediaAvailable ? `<audio controls preload="none" src="/media/${encodeURIComponent(item.id)}"></audio>` : ''}
       <h2>${esc(item.title)}</h2>
-      <p class="id">${esc(item.id)} ・ ${esc(item.license?.spdx ?? '')}${item.price ? ` ・ ¥${item.price.toLocaleString()}` : ' ・ 無料'}</p>
+      <p class="id">${esc(item.id)} ・ ${esc(item.license?.spdx ?? '')} ・ ${tierLabel(item)}</p>
       <div class="tagrow">${(item.tags || []).map((t) => `<span>${esc(t)}</span>`).join('')}</div>
       ${item.provenance?.prompt ? `<details class="prompt"><summary>生成プロンプト</summary><p>${esc(item.provenance.prompt)}</p></details>` : ''}
       <div class="actions" id="actions"></div>
@@ -89,7 +90,7 @@
     const say = (ok, text) => { msg.className = `msg ${ok ? 'ok' : 'err'}`; msg.textContent = text; };
 
     if (item.state === 'locked') {
-      actions.append(el(`<button class="btn" disabled>未購入（¥${(item.price ?? 0).toLocaleString()}） — AKARI Video Lab で購入してください</button>`));
+      actions.append(el('<button class="btn" disabled>Pro — AKARI Video Lab で利用資格を確認してください</button>'));
     } else if (item.state === 'cached') {
       actions.append(el('<p class="note">✓ ライブラリに取得済みです。</p>'));
     } else {

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

@@ -162,7 +162,7 @@ export function createImportMeta(entry, options = {}) {
     requires: [], provenance: { origin: '利用者がローカルから取り込み', generator: null },
     author: 'user',
     license: { spdx: 'LicenseRef-user-owned', scope: 'private-owned', attribution_required: Boolean(credit), ai_training_allowed: false },
-    price: 0,
+    tier: 'free',
   };
   if (origin === 'site') {
     meta.source = {

package/vendor/packages/asset-resolver/src/browse-server.mjs

@@ -12,6 +12,7 @@ import { loadCatalog, resolveEffectiveBase } from './catalog.mjs';
 import { resolvePreviewLocation } from './fetch-file.mjs';
 import { AssetResolverError, resolve as resolveAsset } from './resolve.mjs';
 import { composeState } from './state.mjs';
+import { readLocalLibraryItem } from './library.mjs';
 
 const here = path.dirname(fileURLToPath(import.meta.url));
 const BROWSE_DIR = path.resolve(here, '..', 'browse');
@@ -61,6 +62,27 @@ function statusForError(error) {
   return 400;
 }
 
+function audioFile(files) {
+  return files?.find((file) => /\.(mp3|wav|m4a|ogg|aac|flac|aif|aiff)$/i.test(file.name ?? ''));
+}
+
+function audioPreview(item) {
+  return typeof item.preview === 'string' && /\.(mp3|wav|m4a|ogg|aac|flac|aif|aiff)(?:[?#]|$)/i.test(item.preview)
+    ? item.preview : null;
+}
+
+function localAudioPath(env, item) {
+  const local = readLocalLibraryItem(env, item.category, item.id);
+  return local?.mediaFile ? path.join(local.libraryDir, local.mediaFile) : null;
+}
+
+function canServeAudio(env, item, base) {
+  return item.category === 'audio' && item.state !== 'locked'
+    && Boolean(localAudioPath(env, item) || audioFile(item.files)?.local_path
+      || audioFile(item.files)?.url || (base && audioFile(item.files)?.key)
+      || (audioPreview(item) && (base || /^https?:\/\//i.test(item.preview))));
+}
+
 export async function startBrowseServer({
   env = process.env,
   fetchImpl = fetch,
@@ -82,20 +104,32 @@ export async function startBrowseServer({
 
       if (pathname === '/api/items' && req.method === 'GET') {
         const state = await composeState({ env, fetchImpl });
-        return sendJson(res, 200, state);
+        return sendJson(res, 200, {
+          ...state,
+          items: state.items.map((item) => {
+            const visibleItem = { ...item, mediaAvailable: canServeAudio(env, item, state.base) };
+            if (item.state !== 'locked') return visibleItem;
+            const { files, ...visible } = item;
+            return { ...visible, mediaAvailable: false };
+          }),
+        });
       }
 
       // 試聴: 音源など実体ファイルへの参照。リモート（url 型 / リモート base）は 302 で
       // 実体 URL へ委ね、ローカル base は静的配信する。/thumb と同じ解決規則（fetch-file 共有）。
       if (pathname.startsWith('/media/') && req.method === 'GET') {
         const id = decodeURIComponent(pathname.slice('/media/'.length));
-        const catalog = await loadCatalog({ env, fetchImpl });
-        const item = catalog.items.find((entry) => entry.id === id);
-        const file = item?.files?.find((f) => /\.(mp3|wav|m4a|ogg)$/i.test(f.name ?? '')) ?? item?.files?.[0];
-        const ref = file?.url ?? file?.key;
+        const state = await composeState({ env, fetchImpl });
+        const item = state.items.find((entry) => entry.id === id && entry.category === 'audio');
+        if (!item || item.state === 'locked') return res.writeHead(404).end();
+        const localPath = localAudioPath(env, item);
+        if (localPath) return await serveStaticFile(res, localPath);
+        const file = audioFile(item.files);
+        if (file?.local_path) return await serveStaticFile(res, file.local_path);
+        const ref = file?.url ?? file?.key ?? audioPreview(item);
         if (!ref) return res.writeHead(404).end();
-        const base = resolveEffectiveBase(env, catalog);
-        const resolved = resolvePreviewLocation(base, ref);
+        if (!state.base && !/^https?:\/\//i.test(ref)) return res.writeHead(404).end();
+        const resolved = resolvePreviewLocation(state.base, ref);
         if (!resolved) return res.writeHead(404).end();
         if (resolved.remote) {
           res.writeHead(302, { location: resolved.location });

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

@@ -4,7 +4,10 @@
 
 import { readFile, mkdir, writeFile } from 'node:fs/promises';
 import { catalogCachePath, resolveAkariHome, resolveCatalogSource } from './env.mjs';
+import { join } from 'node:path';
 import { loadInstalledItems, mergeInstalledItems } from './installed.mjs';
+import { fetchTimed, readTimedJson } from './fetch-file.mjs';
+import { assetTier } from './tier.mjs';
 
 function normalizeCatalog(catalog) {
   if (!catalog || !Array.isArray(catalog.items)) {
@@ -15,37 +18,68 @@ function normalizeCatalog(catalog) {
 
 export async function readCatalogCache(env = process.env) {
   try {
-    return normalizeCatalog(JSON.parse(await readFile(catalogCachePath(env), 'utf8')));
+    return publicCatalog(normalizeCatalog(JSON.parse(await readFile(catalogCachePath(env), 'utf8'))));
   } catch {
     return null;
   }
 }
 
+function publicCatalog(catalog) {
+  return {
+    ...catalog,
+    items: catalog.items.map(item => {
+      if (item.state !== 'locked' && assetTier(item) !== 'pro') return item;
+      const { files, ...visible } = item;
+      return visible;
+    }),
+  };
+}
+
+/** The update preference is the shared source for shell and resolver automatic requests. */
+export async function automaticChecksEnabled(env = process.env) {
+  try {
+    const settings = JSON.parse(await readFile(join(resolveAkariHome(env), 'update-preferences.json'), 'utf8'));
+    return settings.autoCheck !== false;
+  } catch {
+    return true;
+  }
+}
+
+export async function catalogNetworkAllowed(intent = 'user', env = process.env) {
+  return intent !== 'automatic' || await automaticChecksEnabled(env);
+}
+
 export async function cacheCatalog(env = process.env, catalog) {
   const home = resolveAkariHome(env);
   await mkdir(home, { recursive: true });
-  await writeFile(catalogCachePath(env), `${JSON.stringify(catalog, null, 2)}\n`);
+  await writeFile(catalogCachePath(env), `${JSON.stringify(publicCatalog(normalizeCatalog(catalog)), null, 2)}\n`);
 }
 
 /**
  * カタログを読む。リモート取得が失敗した場合（オフライン等）はローカルキャッシュへ
  * フォールバックする（黙って劣化させるのではなく、キャッシュが無ければ明示的に失敗する）。
  */
-export async function loadCatalog({ env = process.env, fetchImpl = fetch, includeInstalled = true } = {}) {
+export async function loadCatalog({ env = process.env, fetchImpl = fetch, includeInstalled = true, intent = 'user', timeouts, fallbackToCache = true } = {}) {
   const source = resolveCatalogSource(env);
   const installedItems = includeInstalled ? await loadInstalledItems(env) : [];
   let catalog;
 
+  if (source.kind === 'url' && !await catalogNetworkAllowed(intent, env)) {
+    catalog = await readCatalogCache(env) ?? { schema: 'akari-assets-catalog/v0', version: null, base: null, items: [] };
+    return includeInstalled ? mergeInstalledItems(catalog, installedItems) : catalog;
+  }
+
   if (source.kind === 'file') {
     const raw = await readFile(source.value, 'utf8');
     catalog = normalizeCatalog(JSON.parse(raw));
   } else {
     try {
-      const res = await fetchImpl(source.value);
+      const { response: res, controller } = await fetchTimed(source.value, { fetchImpl, timeouts, label: 'カタログ' });
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      catalog = normalizeCatalog(await res.json());
+      catalog = normalizeCatalog(await readTimedJson(res, controller, { timeouts, label: 'カタログ' }));
       await cacheCatalog(env, catalog);
     } catch (error) {
+      if (!fallbackToCache) throw new Error('カタログの取得に失敗しました: ' + (error instanceof Error ? error.message : String(error)));
       const cached = await readCatalogCache(env);
       if (cached) {
         catalog = cached;
@@ -64,4 +98,23 @@ export async function loadCatalog({ env = process.env, fetchImpl = fetch, includ
   return includeInstalled ? mergeInstalledItems(catalog, installedItems) : catalog;
 }
 
+/** Resolve uses a valid local cache first; listing/sync remains responsible for freshness. */
+export async function loadCatalogForResolve(ref, { env = process.env, fetchImpl = fetch, timeouts } = {}) {
+  // ref は category/id か bare id（resolve.mjs の findCatalogItem と同じ受け方）
+  const matches = typeof ref === 'string' && ref.includes('/')
+    ? item => `${item.category}/${item.id}` === ref
+    : item => item.id === ref;
+  const installedItems = await loadInstalledItems(env);
+  if (installedItems.some(matches)) {
+    return { schema: 'akari-assets-catalog/v0', version: null, base: null, items: installedItems };
+  }
+  if (resolveCatalogSource(env).kind === 'url') {
+    const cached = await readCatalogCache(env);
+    if (cached && cached.items.some(matches)) {
+      return mergeInstalledItems(cached, installedItems);
+    }
+  }
+  return loadCatalog({ env, fetchImpl, timeouts, fallbackToCache: false });
+}
+
 export { resolveEffectiveBase } from './env.mjs';

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

@@ -6,7 +6,9 @@
 // 自体は別途 fail-closed で拒否するので、ここで例外を投げて全体を止める必要はない）。
 
 import { readFile } from 'node:fs/promises';
+import { automaticChecksEnabled } from './catalog.mjs';
 import { resolveCredentialsPath, resolveEntitlementsUrl } from './env.mjs';
+import { fetchTimed, readTimedJson } from './fetch-file.mjs';
 
 export async function readStoreCredentials(env = process.env) {
   try {
@@ -19,34 +21,39 @@ export async function readStoreCredentials(env = process.env) {
 }
 
 /**
- * 購入済み商品 id の Set + 取得結果。取得できない場合も ids は空集合
+ * 購入済み商品 id の Set + パス情報 + 取得結果。取得できない場合も ids は空集合、pass は null
  * （= 無料のみ使える）のままで、既存のフォールバックを変えない。
- * @returns {Promise<{ ids: Set<string>, status: 'ok'|'no_credentials'|'unauthorized'|'error' }>}
+ * @returns {Promise<{ ids: Set<string>, status: 'ok'|'no_credentials'|'unauthorized'|'error', pass: { tier: unknown, seat_no: unknown } | null }>}
  */
-export async function fetchEntitlements({ env = process.env, fetchImpl = fetch } = {}) {
+export async function fetchEntitlements({ env = process.env, fetchImpl = fetch, intent = 'user', timeouts } = {}) {
+  if (intent === 'automatic' && !await automaticChecksEnabled(env)) {
+    return { ids: new Set(), status: 'no_credentials', pass: null };
+  }
   const credentials = await readStoreCredentials(env);
-  if (!credentials) return { ids: new Set(), status: 'no_credentials' };
+  if (!credentials) return { ids: new Set(), status: 'no_credentials', pass: null };
 
   const url = resolveEntitlementsUrl(env, credentials);
   try {
-    const res = await fetchImpl(url, { headers: { authorization: `Bearer ${credentials.token}` } });
+    const { response: res, controller } = await fetchTimed(url, { fetchImpl, request: { headers: { authorization: `Bearer ${credentials.token}` } }, timeouts, label: '権利確認' });
     if (res.status === 401 || res.status === 403) {
-      return { ids: new Set(), status: 'unauthorized' };
+      return { ids: new Set(), status: 'unauthorized', pass: null };
     }
     let data;
     try {
-      data = await res.json();
+      data = await readTimedJson(res, controller, { timeouts, label: '権利確認' });
     } catch {
-      return { ids: new Set(), status: 'error' };
+      return { ids: new Set(), status: 'error', pass: null };
     }
     if (data?.error === 'token_revoked') {
-      return { ids: new Set(), status: 'unauthorized' };
+      return { ids: new Set(), status: 'unauthorized', pass: null };
     }
-    if (!res.ok) return { ids: new Set(), status: 'error' };
+    if (!res.ok) return { ids: new Set(), status: 'error', pass: null };
     const list = Array.isArray(data?.entitlements) ? data.entitlements : [];
     const ids = list.map((entry) => (typeof entry === 'string' ? entry : entry?.product_id ?? entry?.id)).filter(Boolean);
-    return { ids: new Set(ids), status: 'ok' };
-  } catch {
-    return { ids: new Set(), status: 'error' };
+    const pass = data?.pass !== null && typeof data?.pass === 'object' && !Array.isArray(data.pass)
+      ? { tier: data.pass.tier, seat_no: data.pass.seat_no } : null;
+    return { ids: new Set(ids), status: 'ok', pass };
+  } catch (error) {
+    return { ids: new Set(), status: 'error', pass: null, error: error instanceof Error ? error.message : String(error) };
   }
 }

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

@@ -1,5 +1,5 @@
 // resolve() が投げるエラーの型。code で分岐できるようにする
-// （'locked' | 'not_found' | 'invalid_catalog_item' | 'integrity' | 'validation' | 'download_failed'）。
+// （'locked' | 'not_found' | 'ambiguous_id' | 'invalid_catalog_item' | 'integrity' | 'validation' | 'download_failed'）。
 
 export class AssetResolverError extends Error {
   constructor(message, code) {