akari-video 1.1.0 → 1.2.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.1.0",
+  "version": "1.2.0-beta.1",
   "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/doctor-command.mjs

@@ -60,9 +60,14 @@ export function formatDoctorReport(report) {
     '',
     `判定: ${report.verdict}`,
   ];
-  if (report.next_steps.length > 0) {
+  const steps = [...report.next_steps];
+  if (report.cli.node?.runtime === 'electron' && report.cli.node.exec_path && report.render_cut.path) {
+    const quote = (value) => `"${value.replaceAll('"', '\\"')}"`;
+    steps.push(`Node が PATH に無い場合の書き出し: ELECTRON_RUN_AS_NODE=1 ${quote(report.cli.node.exec_path)} ${quote(report.render_cut.path)} <project-root>`);
+  }
+  if (steps.length > 0) {
     lines.push('次の手順:');
-    lines.push(...report.next_steps.map((step) => `  - ${step}`));
+    lines.push(...steps.map((step) => `  - ${step}`));
   }
   return lines.join('\n');
 }

package/src/migrate-command.mjs

@@ -64,11 +64,14 @@ export async function runMigrateCommand(args, options = {}) {
   }
   if (parsed.json) {
     log(JSON.stringify({
-      ok: true, dryRun: parsed.dryRun, version: proposal.version,
+      ok: true, dryRun: parsed.dryRun, version: proposal.emptyProject ? null : proposal.version,
+      ...(proposal.emptyProject ? { emptyProject: true } : {}),
       filePath: proposal.filePath, backupPath: proposal.backupPath, changes: proposal.changes
     }));
   } else {
-    log(`変換対象: ${proposal.filePath} (version ${proposal.version}${proposal.version === 2 ? ' 正規化' : ' -> 2'})`);
+    log(proposal.emptyProject
+      ? `初期化対象: ${proposal.filePath} (空の edit.json -> version 2)`
+      : `変換対象: ${proposal.filePath} (version ${proposal.version}${proposal.version === 2 ? ' 正規化' : ' -> 2'})`);
     for (const change of proposal.changes) log(`- ${change.path}: ${change.note}`);
     log(`変換前の退避先: ${proposal.backupPath}`);
   }
@@ -92,7 +95,9 @@ export async function runMigrateCommand(args, options = {}) {
   }
   await migrate.applyMigration(proposal);
   if (!parsed.json) {
-    log(proposal.version === 2
+    log(proposal.emptyProject
+      ? `空の edit.json を初期化しました。元ファイル: ${proposal.backupPath}`
+      : proposal.version === 2
       ? `version 2 を正規化しました。元ファイル: ${proposal.backupPath}`
       : `version 2 へ変換しました。元ファイル: ${proposal.backupPath}`);
   }

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

@@ -83,6 +83,8 @@
     "docs/contract-2026-10-02-textstyle-v1-rich.md",
     "docs/contract-2026-10-04-asset-tier-v1.md",
     "docs/contract-2026-10-06-timeline-ripple-v0.md",
+    "packages/akari-ear/package.json",
+    "packages/akari-ear/README.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -109,6 +111,8 @@
     "packages/frame-engine/package.json",
     "packages/frame-engine/README.ja.md",
     "packages/frame-engine/README.md",
+    "packages/frame-scene/package.json",
+    "packages/frame-scene/README.md",
     "packages/generate/package.json",
     "packages/generate/README.md",
     "packages/gpu-export/package.json",

package/vendor/docs/contract-2026-07-13-asset-library.md

@@ -373,7 +373,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 
 | v1 category | 形の定義 | 判定 | 旧 category |
 |---|---|---|---|
-| `overlay` | 時間を持つ HTML 断片 | `fragment.html` + `data-start` / `data-duration` を持ち `overlays[]` から合成 | `telop` / `motion` |
+| `overlay` | 時間を持つ HTML 断片 | `fragment.html` を `overlays[]` から合成。断片ルートに時刻を置かず、素材本来の長さは `data-akari-natural-duration`（秒）に記録 | `telop` / `motion` |
 | `still` | 時間を持たない HTML シート | `fragment.html`。決定的スクショで画像に焼く | `thumbnail` |
 | `scene3d` | 3D モデル + 表示断片、またはベイクレシピ | `fragment.html` + glTF、または `scene.py` | `3d` |
 | `audio` | 音声トラックに載るバイナリ | `edit.json` の `audio.bgm` / `sfx` が参照 | `audio`（変更なし） |

package/vendor/docs/contract-2026-07-25-project-structure-v0.md

@@ -40,6 +40,7 @@ updated: 2026-09-06
 |---|---|---|
 | 人間の一次素材 | `assets/`（下位分類自由） | 人間・取り込み UI |
 | 企画・プラン | `planning/` | スキル + 人間承認 |
+| 仮枠のシーン JSON（AI が書く・人が微調整。仮枠の meta の `frame.content.scene` が指す） | `planning/frames/` | スキル・仮枠の編集 |
 | エージェント中間物・ad-hoc 検証スクリプトと結果 | `.akari/work/` | スキル・エージェント |
 | 検証証跡・レポート（キーフレーム視認 PNG・render-report 等） | `.akari/reports/` | スキル |
 | 絵コンテ（タイムラインの印刷・初回だけ・AI は後から読まない） | `.akari/reports/storyboard/` | スキル |
@@ -47,6 +48,8 @@ updated: 2026-09-06
 | 納品物 | `exports/` | `render-cut` |
 | 契約サイドカー（既存） | `.akari/`（`sidecars/` `diffs/` `events/` 等） | 既存のまま |
 
+`planning/frames/<stem>.scene.json` は仮枠（生成 v0 契約）の中身を記述する正本で、変更履歴に入る（`planning/**`）。仮枠の絵（png）と meta は従来どおり `assets/generated/`。
+
 `.akari/` 直下にはこの表にない契約サイドカーファイルも存在する（`intake.json`・
 `workflow.json`・`connections.json`・`lint.json`・`render.json` 等）。これらは各自の
 契約文書が正本であり、本契約は「置き場所の層」を追加で確定させるだけで、個々のファイル形は

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

@@ -42,10 +42,15 @@ overlap; and reference/output aspect mismatch. A resolved production render stor
 projection digest, and its immutable render receipt references the file and summary.
 Captions with `time_domain: "output"` (placed text) are exempt from overlap and order checks; any number may share the same time (2026-09-22 decision). Source-domain captions retain their per-source checks.
 
-Under `display_policy`, an omitted `captions[].style` remains valid. The known word-display styles
-`karaoke`, `pop`, `reveal`, and `reveal-word` remain `STYLE_CONFLICT` errors, while any other value is
-an `INVALID_CAPTION` error that names the unknown value and the accepted vocabulary. Without
-`display_policy`, caption style handling remains on the unchanged legacy path.
+2026-10-06 amendment: `display_policy.word_style` is the global word display default (`none` when
+omitted, or `karaoke`). An explicit `captions[].style: "karaoke"` or `"plain"` takes priority over
+that default; `plain` restores ordinary display for one row under a global karaoke policy.
+Under `display_policy`, `pop`, `reveal`, and `reveal-word` remain `STYLE_CONFLICT` errors, while any
+unknown style is `INVALID_CAPTION`. Karaoke uses measured `words[]` projected into each resolved
+fragment. Missing words or synthetic timing fall back to ordinary text. Without `display_policy`,
+caption style handling remains on the unchanged legacy path.
+If measured words omit only punctuation, symbols, or whitespace, those characters remain visible as
+untimed unlit tokens while the measured words keep karaoke timing; other text mismatches fall back to ordinary text.
 
 `reference-pixel` geometry is scaled only after exact aspect agreement. `webkit-outline` produces
 real `-webkit-text-stroke` plus `paint-order:stroke fill` and disables shadow. Single-line consumers

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

@@ -334,3 +334,7 @@ await p.save();                         // 正規直列化 → lint ゲート
 - 観察・手術の CLI コマンド（作らない。§5.2-5）
 - 種類ごとに違うグループ（sequence / scene 等）— 「段」と「グループ」の 2 つだけ
 - 文字ごとのキーフレーム（姉妹契約 §8）
+
+## 音声片のカット端
+
+edit.json v2 の audio lane にある分離済み speech item は、カットで素材端が失われたとき、任意の `cut_edge: { "in": 秒, "out": 秒, "at": 整数フレーム }` を持てる。`in` と `out` はこの音声片自身の元の素材端であり、頭がまたぎで削られた場合だけ `in` が現在の `source.in` と異なり、尻がまたぎで削られた場合だけ `out` が現在の `source.out` と異なる。両端が現在の素材端と等しくなれば欄を消す。`at` は「頭を `cut_edge.in` まで戻したときの開始フレーム」で、現在の `at - round((source.in - cut_edge.in) / 1 フレームぶんの素材秒)` から求める派生値である。カットで音声片を割ったときはそれぞれの片の端だけを保持し、結合時は左片の `in` と右片の `out` を採る。`in` と `out` は 0 以上の有限数で `in < out`、`at` は整数。先行カットのリップルを反映した途中状態では `cut_edge.at` が負になることもある。再生範囲の `source.in/out` と現在位置の `at` はそのまま正本とする。`provenance` はナレーションの生成元専用で、この用途には使わない。欄のない既存 item の意味は変わらない。

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

@@ -42,3 +42,11 @@ JSON Schema は `remote: true` なら `source` 必須までを表し、akari-r2
 `preview` URL は `https://akari.video/lab/media/telop-rich-pack/textstyle/<id>.png` の形とする。
 配置後は既存の textstyle ライブラリ読み込みが `preset.json` を読み、
 「テキスト > スタイル」へ並べる。未取得 textstyle の棚カード表示は別票で扱う。
+
+## § Pro item の 1 件ずつの取得（2026-10-06）
+
+resolver は取得済みの素材をキャッシュから先に返す。新規取得の Pro item は店の entitlements と catalog 行で資格を事前判定し、資格があれば `GET /api/store/v1/assets/<category>/<id>` で記述子を取得する。記述子が示す各ファイルを Bearer 認証で取得し、`sha256` と `bytes` を照合する。`meta.json` を必須として `validate-asset` に通し、全件成功後に `<ライブラリ>/<category>/<id>/` へ原子的に配置する。失敗時は一時ディレクトリを破棄する。
+
+記述子の `schema` は `akari-pro-asset/v1`。`category`、`id`、正の整数 `version` と、空でない `files` 配列を持つ。各 `files[]` は相対パス `name`、小文字 64 桁の `sha256`、0 以上の整数 `bytes`、記述子 API と同じオリジンの絶対 HTTP(S) `url` を持つ。`name` は `/` 区切りで、空の区間、`.`、`..`、先頭の `/`、バックスラッシュ、NUL を含めない。`name` は一意で `meta.json` を必ず含む。
+
+記述子またはファイル取得で 409 `stale_version` が返ったら、一時取得物を捨てて記述子を 1 回だけ取り直す。記述子 API が 404 `asset_not_found` を返した場合だけ、`product_id ?? id` の束 zip 取得へ進む。束 zip は予備経路として段階的に退役する。記述子 API の上書きは `AKARI_PRO_ASSET_API` を使い、`AKARI_STORE_API`、接続情報の URL、既定ホストより優先する。

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

@@ -0,0 +1,9 @@
+# AKARI バイブの耳
+
+耳はマイクを開き、音声を文字にして辞書を適用する共有部品です。判断サービスの資格や鍵に依存せず、マイクの持ち主を 1 つにします。
+
+段階 A では、試し聞きとメモ、区画の「いま」が耳を使います。Jev は従来どおり自分のマイクを使い、同時利用は禁止します。Jev 動作中は耳を使用中として扱います。
+
+段階 B では、Jev の聞き取りも耳へ統一します。発話と音量を係の `/say` と `/level` へ渡し、マイクの持ち主を耳に一本化します。
+
+現時点は骨組みのみで、実装は今後行います。

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

@@ -0,0 +1,11 @@
+{
+  "name": "@akari-video/akari-ear",
+  "version": "0.0.0",
+  "private": true,
+  "description": "AKARI バイブの耳（マイク → 文字起こし → 辞書）の共有部品。依存ゼロ。",
+  "type": "module",
+  "main": "src/index.mjs",
+  "scripts": {
+    "test": "node --test \"test/*.test.mjs\""
+  }
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.1.0",
+  "version": "1.2.0-beta.1",
   "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/akari-vibe/README.md

@@ -1,7 +1,7 @@
 # AKARI バイブ
 
-このディレクトリは内部リポジトリの正本から自動生成する配布物です。直接編集しないでください。
-変更は内部へ戻し、検査を通して書き出し直します。版はシェルと一緒に管理します。
+このディレクトリは公開リポジトリが正本です。変更は通常のプルリクエスト・コミットで行います。
+版はシェルと一緒に管理します。
 判断は `https://akari.video/api/vibe` のサービスで行い、その実装は同梱しません。
 
 ## 起動

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // akari-assets — 素材 resolver v0 の CLI（list / add / fetch / bundle / migrate / sync / browse）。
 //
-//   akari-assets list [--category <c>] [--source <lab|site|own>] [--json]
+//   akari-assets list [--category <c>] [--source <lab|site|own>] [--tag <t> ...] [--query <s>] [--json]
 //   akari-assets add <path...> --plan [--json]
 //   akari-assets add --apply <plan.json> [--json]
 //   akari-assets fetch <ref> [--project <dir>] [--reference] [--force]  （ref は category/id）
@@ -19,6 +19,7 @@ import { resolve as resolveAsset } from '../src/resolve.mjs';
 import { DEFAULT_CATALOG_URL, DEFAULT_STORE_API } from '../src/service-urls.mjs';
 import { composeState } from '../src/state.mjs';
 import { checkLibrary, projectCredits } from '../src/library-check.mjs';
+import { filterListItems } from '../src/list-filter.mjs';
 
 function flagValue(args, name) {
   const i = args.indexOf(name);
@@ -28,7 +29,7 @@ function flagValue(args, name) {
 // Validate the entire command before any handler can read or mutate user data.
 function validateArgs(sub, args) {
   const specs = {
-    list: { values: ['--category', '--source'], flags: ['--json'], max: 0 },
+    list: { values: ['--category', '--source', '--tag', '--query'], flags: ['--json'], max: 0 },
     add: { values: ['--apply'], flags: ['--plan', '--json'], max: Infinity },
     fetch: { values: ['--project'], flags: ['--reference', '--force'], min: 1, max: 1 },
     bundle: { values: ['--project'], flags: ['--dry-run'], max: 0 },
@@ -46,7 +47,7 @@ function validateArgs(sub, args) {
     const arg = args[i];
     if (!arg.startsWith('-')) { positional.push(arg); continue; }
     if (!spec.values.includes(arg) && !spec.flags.includes(arg)) throw new Error(`不明なオプション: ${arg}`);
-    if (seen.has(arg)) throw new Error(`重複したオプション: ${arg}`);
+    if (seen.has(arg) && !(sub === 'list' && arg === '--tag')) throw new Error(`重複したオプション: ${arg}`);
     seen.add(arg);
     if (spec.values.includes(arg) && (!args[++i] || args[i].startsWith('-'))) throw new Error(`${arg} には値が必要です`);
   }
@@ -76,10 +77,12 @@ async function cmdList(args, env) {
   const category = flagValue(args, '--category');
   const asJson = args.includes('--json');
   const source = flagValue(args, '--source');
+  const tags = args.flatMap((arg, index) => arg === '--tag' ? [args[index + 1]] : []);
+  const query = flagValue(args, '--query');
   if (args.includes('--source') && !['lab', 'site', 'own'].includes(source)) throw new Error('--source は lab / site / own で指定してください');
   const { libraryRoots, items, warnings } = await composeState({ env });
   for (const warning of warnings) console.error(`警告: ${warning}`);
-  const filtered = items.filter(item => (!category || item.category === category) && (!source || item.sourceKind === source));
+  const filtered = filterListItems(items, { category, source, tags, query });
 
   if (asJson) {
     console.log(JSON.stringify(filtered, null, 2));
@@ -88,7 +91,7 @@ async function cmdList(args, env) {
 
   console.log(`使える素材 ${filtered.length} 件（ライブラリ: ${libraryRoots.write}）`);
   for (const item of filtered) {
-    console.log(`  ${badgeOf(item)}  ${item.category}/${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.tier === 'pro' ? 'pro' : 'free'}\t${item.title}`);
   }
 }
 
@@ -199,8 +202,8 @@ async function cmdCredits(args, env) {
 function printUsage() {
   console.log(`使い方: akari-assets <list|add|fetch|bundle|migrate|sync|browse|check|credits> [options]
 
-  list [--category <c>] [--source <lab|site|own>] [--json]
-                                          出どころ・取得状態つき素材一覧
+  list [--category <c>] [--source <lab|site|own>] [--tag <t> ...] [--query <s>] [--json]
+                                          タグ完全一致（複数は AND）・題名/id/タグ部分一致で絞る素材一覧
   add <path...> --plan [--json]           ローカル素材の取り込み計画（書き込みなし）
   add --apply <plan.json> [--json]        計画で選択した素材を複製して登録
   fetch <ref> [--project <dir>] [--reference] [--force]

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

@@ -14,7 +14,7 @@ export async function bundleProjectReferences({
   for (const reference of planned) {
     try {
       if (!isAssetCached(env, reference.category, reference.id)) {
-        const resolved = await resolveAsset(reference.id, { env });
+        const resolved = await resolveAsset(`${reference.category}/${reference.id}`, { env });
         if (resolved.category !== reference.category) {
           throw new Error(
             `カタログのカテゴリが台帳と一致しません: ${reference.category}/${reference.id}（実際: ${resolved.category}）`,

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

@@ -2,7 +2,7 @@
 // ~/.akari/catalog-cache.json へ自動キャッシュ（オフライン時のフォールバック）。
 // ローカルパス指定（開発・テスト）はファイルをそのまま読む。
 
-import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { readFile, mkdir, writeFile, stat } from 'node:fs/promises';
 import { catalogCachePath, resolveAkariHome, resolveCatalogSource } from './env.mjs';
 import { join } from 'node:path';
 import { loadInstalledItems, mergeInstalledItems } from './installed.mjs';
@@ -16,9 +16,26 @@ function normalizeCatalog(catalog) {
   return catalog;
 }
 
+// The local catalog is large; keep the parsed value until the file changes.
+const parsedCatalogs = new Map();
+async function readLocalCatalog(file, visible = false) {
+  const info = await stat(file);
+  const cached = parsedCatalogs.get(file);
+  if (cached && cached.mtimeMs === info.mtimeMs && cached.ctimeMs === info.ctimeMs
+      && cached.size === info.size) {
+    if (visible && !cached.public) cached.public = publicCatalog(cached.catalog);
+    return visible ? cached.public : cached.catalog;
+  }
+  const catalog = normalizeCatalog(JSON.parse(await readFile(file, 'utf8')));
+  const entry = { mtimeMs: info.mtimeMs, ctimeMs: info.ctimeMs, size: info.size, catalog,
+    ...(visible ? { public: publicCatalog(catalog) } : {}) };
+  parsedCatalogs.set(file, entry);
+  return visible ? entry.public : catalog;
+}
+
 export async function readCatalogCache(env = process.env) {
   try {
-    return publicCatalog(normalizeCatalog(JSON.parse(await readFile(catalogCachePath(env), 'utf8'))));
+    return await readLocalCatalog(catalogCachePath(env), true);
   } catch {
     return null;
   }
@@ -53,6 +70,7 @@ export async function cacheCatalog(env = process.env, catalog) {
   const home = resolveAkariHome(env);
   await mkdir(home, { recursive: true });
   await writeFile(catalogCachePath(env), `${JSON.stringify(publicCatalog(normalizeCatalog(catalog)), null, 2)}\n`);
+  parsedCatalogs.delete(catalogCachePath(env));
 }
 
 /**
@@ -70,8 +88,7 @@ export async function loadCatalog({ env = process.env, fetchImpl = fetch, includ
   }
 
   if (source.kind === 'file') {
-    const raw = await readFile(source.value, 'utf8');
-    catalog = normalizeCatalog(JSON.parse(raw));
+    catalog = await readLocalCatalog(source.value);
   } else {
     try {
       const { response: res, controller } = await fetchTimed(source.value, { fetchImpl, timeouts, label: 'カタログ' });

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

@@ -90,3 +90,18 @@ export function resolveDownloadUrl(env = process.env, credentials, productId) {
   }
   return `${DEFAULT_STORE_API}/api/store/v1/download/${encodeURIComponent(productId)}`;
 }
+
+/** Pro item の記述子 API。専用上書き → 店 API → 接続情報 → 既定ホスト。 */
+export function resolveProAssetUrl(env = process.env, credentials, category, id) {
+  const suffix = `${encodeURIComponent(category)}/${encodeURIComponent(id)}`;
+  if (env.AKARI_PRO_ASSET_API) {
+    return `${trimTrailingSlash(env.AKARI_PRO_ASSET_API)}/api/store/v1/assets/${suffix}`;
+  }
+  if (env.AKARI_STORE_API) {
+    return `${trimTrailingSlash(env.AKARI_STORE_API)}/api/store/v1/assets/${suffix}`;
+  }
+  if (credentials?.url) {
+    return `${trimTrailingSlash(credentials.url)}/v1/assets/${suffix}`;
+  }
+  return `${DEFAULT_STORE_API}/api/store/v1/assets/${suffix}`;
+}

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

@@ -6,11 +6,12 @@
 // （開発時は store リポのローカル出力を指す運用）。
 
 import { createWriteStream } from 'node:fs';
-import { copyFile, mkdir } from 'node:fs/promises';
+import { copyFile, mkdir, rm } from 'node:fs/promises';
 import path from 'node:path';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { isRemoteLocation } from './env.mjs';
+import { AssetResolverError } from './errors.mjs';
 
 export const DEFAULT_FETCH_TIMEOUTS = { responseMs: 15_000, idleMs: 30_000 };
 
@@ -98,14 +99,50 @@ export function resolvePreviewLocation(base, preview) {
 }
 
 /** 解決済みロケーションを destPath へ実体化する（リモートは fetch、ローカルはファイルコピー） */
-export async function materialize({ location, remote }, destPath, { fetchImpl = fetch, timeouts } = {}) {
+export async function materialize({ location, remote }, destPath, { fetchImpl = fetch, timeouts, request, maxBytes } = {}) {
   await mkdir(path.dirname(destPath), { recursive: true });
   if (remote) {
-    const { response: res, controller } = await fetchTimed(location, { fetchImpl, timeouts, label: '素材ファイル' });
+    const { response: res, controller } = await fetchTimed(location, { fetchImpl, request, timeouts, label: '素材ファイル' });
     if (!res.ok || !res.body) {
-      throw new Error(`ダウンロード失敗: ${location} → HTTP ${res.status}`);
+      if (!request) throw new Error(`ダウンロード失敗: ${location} → HTTP ${res.status}`);
+      let detail = '';
+      let storeCode;
+      try {
+        const data = await readTimedJson(res, controller, { timeouts, label: '素材ファイル' });
+        storeCode = typeof data?.error === 'string' ? data.error : undefined;
+        detail = [storeCode, typeof data?.message === 'string' ? data.message : ''].filter(Boolean).join(': ');
+      } catch (error) {
+        if (error instanceof Error && error.message.includes('時間切れ')) throw error;
+        // エラー本文が JSON でない場合も HTTP status を残す。
+      }
+      controller.abort();
+      const error = new Error(`ダウンロード失敗: ${location} → HTTP ${res.status}${detail ? ` (${detail})` : ''}`);
+      error.status = res.status;
+      error.storeCode = storeCode;
+      throw error;
+    }
+    if (maxBytes === undefined) {
+      await pipeline(Readable.from(timedBody(res.body, controller, { timeouts, label: '素材ファイル' })), createWriteStream(destPath));
+      return;
+    }
+    async function* limitedBody() {
+      let received = 0;
+      for await (const chunk of timedBody(res.body, controller, { timeouts, label: '素材ファイル' })) {
+        received += chunk.byteLength;
+        if (received > maxBytes) {
+          controller.abort();
+          throw new AssetResolverError(`bytes が宣言値を超えました: ${received} > ${maxBytes}`, 'integrity');
+        }
+        yield chunk;
+      }
+    }
+    try {
+      await pipeline(Readable.from(limitedBody()), createWriteStream(destPath));
+    } catch (error) {
+      controller.abort();
+      await rm(destPath, { force: true });
+      throw error;
     }
-    await pipeline(Readable.from(timedBody(res.body, controller, { timeouts, label: '素材ファイル' })), createWriteStream(destPath));
     return;
   }
   await copyFile(location, destPath);

package/vendor/packages/asset-resolver/src/list-filter.mjs

@@ -0,0 +1,10 @@
+/** Filter composed catalogue rows without changing their order or contents. */
+export function filterListItems(items, { category, source, tags = [], query } = {}) {
+  const needle = query?.toLocaleLowerCase();
+  return items.filter(item =>
+    (!category || item.category === category)
+    && (!source || item.sourceKind === source)
+    && tags.every(tag => item.tags?.includes(tag))
+    && (!needle || [item.title, item.id, ...(item.tags ?? [])]
+      .some(value => typeof value === 'string' && value.toLocaleLowerCase().includes(needle))));
+}

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

@@ -0,0 +1,103 @@
+// Pro item の記述子と店の HTTP 応答を検査する。ファイル取得前に全件を検査する。
+import { AssetResolverError } from './errors.mjs';
+import { resolveProAssetUrl } from './env.mjs';
+import { fetchTimed, readTimedJson } from './fetch-file.mjs';
+
+function timedOut(error) {
+  return error instanceof Error && error.message.includes('時間切れ');
+}
+
+export function storeFailure(status, data, context) {
+  const storeCode = typeof data?.error === 'string' ? data.error : undefined;
+  const message = typeof data?.message === 'string' ? data.message : undefined;
+  const details = [storeCode, message].filter(Boolean).join(': ');
+  const error = new AssetResolverError(
+    `${context}に失敗しました（HTTP ${status ?? '不明'}${details ? `: ${details}` : ''}）`,
+    status === 401 || (status === 403 && storeCode === 'pro_required') ? 'locked' : 'download_failed',
+  );
+  error.status = status;
+  error.storeCode = storeCode;
+  return error;
+}
+
+function invalid(reason) {
+  throw new AssetResolverError(`Pro 素材の記述子が不正です: ${reason}`, 'integrity');
+}
+
+export function validateProAssetDescriptor(data, item, descriptorUrl) {
+  if (!data || typeof data !== 'object' || Array.isArray(data)) invalid('JSON object が必要です');
+  if (data.schema !== 'akari-pro-asset/v1') invalid('schema');
+  if (data.category !== item.category || data.id !== item.id) invalid('category/id');
+  if (!Number.isInteger(data.version) || data.version <= 0) invalid('version');
+  if (!Array.isArray(data.files) || data.files.length === 0) invalid('files');
+  const origin = new URL(descriptorUrl).origin;
+  const names = new Set();
+  const files = [];
+  for (const file of data.files) {
+    if (!file || typeof file !== 'object' || Array.isArray(file)) invalid('file');
+    if (Object.keys(file).length !== 4
+      || Object.keys(file).some(key => !['name', 'sha256', 'bytes', 'url'].includes(key))) invalid('file のキー');
+    const name = file.name;
+    if (typeof name !== 'string' || !name || name.startsWith('/') || name.includes('\\')
+      || name.split('/').some(part => !part || part === '.' || part === '..'
+        || /[:\x00-\x1f\x7f<>"|?*]/.test(part) || /[. ]$/.test(part)
+        || /^(?:con|prn|aux|nul|com[0-9]|lpt[0-9])(?:\.|$)/i.test(part))) invalid('name');
+    const foldedName = name.toLowerCase();
+    if (names.has(foldedName)) invalid('name が重複しています');
+    names.add(foldedName);
+    if (typeof file.sha256 !== 'string' || !/^[0-9a-f]{64}$/.test(file.sha256)) invalid('sha256');
+    if (!Number.isInteger(file.bytes) || file.bytes < 0) invalid('bytes');
+    let url;
+    try { url = new URL(file.url); } catch { invalid('url'); }
+    if (!['http:', 'https:'].includes(url.protocol) || url.origin !== origin) invalid('url のオリジン');
+    files.push({ name, sha256: file.sha256, bytes: file.bytes, url: file.url });
+  }
+  if (!files.some(file => file.name === 'meta.json')) invalid('meta.json');
+  return { ...data, files };
+}
+
+/** 404 asset_not_found だけを null として返し、zip 予備経路へ渡す。 */
+export async function fetchProAssetDescriptor(item, credentials, { env, fetchImpl, timeouts }) {
+  const url = resolveProAssetUrl(env, credentials, item.category, item.id);
+  let res;
+  let controller;
+  try {
+    ({ response: res, controller } = await fetchTimed(url, {
+      fetchImpl, request: { headers: { authorization: `Bearer ${credentials.token}` }, redirect: 'error' },
+      timeouts, label: 'Pro 素材の記述子',
+    }));
+  } catch (error) {
+    throw new AssetResolverError(`Pro 素材の記述子取得に失敗しました: ${error.message}`, timedOut(error) ? 'timeout' : 'download_failed');
+  }
+  let data;
+  try {
+    data = await readTimedJson(res, controller, { timeouts, label: 'Pro 素材の記述子' });
+  } catch (error) {
+    if (timedOut(error)) throw new AssetResolverError(error.message, 'timeout');
+    if (res.ok) invalid('JSON');
+    const failure = storeFailure(res.status, null, 'Pro 素材の記述子取得');
+    if (res.status === 401) failure.message += '。トークン失効の可能性があります。akari store connect をやり直してください';
+    throw failure;
+  } finally {
+    controller.abort();
+  }
+  if (!res.ok) {
+    if (res.status === 404 && data?.error === 'asset_not_found') return null;
+    if (res.status === 403 && data?.error === 'pro_required') {
+      const error = new AssetResolverError(
+        `Pro 素材は all-access-pass（Lifetime パス）または購入済み product_id が必要です: ${item.id}${data?.message ? `（${data.message}）` : ''}`,
+        'locked',
+      );
+      error.status = res.status;
+      error.storeCode = data.error;
+      throw error;
+    }
+    if (res.status === 401) {
+      const failure = storeFailure(res.status, data, 'Pro 素材の記述子取得');
+      failure.message += '。トークン失効の可能性があります。akari store connect をやり直してください';
+      throw failure;
+    }
+    throw storeFailure(res.status, data, 'Pro 素材の記述子取得');
+  }
+  return validateProAssetDescriptor(data, item, url);
+}

package/vendor/packages/asset-resolver/src/project-references.mjs

@@ -157,8 +157,13 @@ export async function readProjectReferences(projectDir) {
 
 export async function recordProjectReference(projectDir, reference) {
   assertReference(reference);
+  const alreadyRecorded = references => references.some(entry =>
+    entry.id === reference.id && entry.category === reference.category);
+  const current = await readProjectReferences(projectDir);
+  if (alreadyRecorded(current)) return current;
   return withReferencesLock(projectDir, async () => {
     const references = await readProjectReferences(projectDir);
+    if (alreadyRecorded(references)) return references;
     references.push({ id: reference.id, category: reference.category });
     const normalized = normalizeReferences(references);
     await writeProjectReferences(projectDir, normalized);