akari-video 0.1.73 → 0.1.74

package/README.md

@@ -1,5 +1,9 @@
 # akari-launcher（`akari` コマンド）
 
+ライブラリの置き場は既定で作業場の `library/`。作業場が無いときは従来の `~/.akari/assets/` を使う。
+`akari-assets list`（または `akari assets list`）の先頭行で実際の置き場を確認する。
+以下の `<ライブラリの置き場>` はその表示先を指し、音源はその下の `audio/` に入る。
+
 「UI に依存したくない。opencode 単体でも、どんなディレクトリでも始められるように」を
 実現する薄いラッパー CLI。npm パッケージ名は `akari-video`、提供するコマンド名は `akari`
 （npm の `akari` は別プロダクトが取得済みのため。オーナー裁定 2026-07-21 §8-2）。
@@ -24,7 +28,7 @@ akari
   ├─ 4. 公式音源ライブラリ（AKARI Sounds）の初回セットアップ（src/sounds-setup.mjs）:
   │     未導入かつ TTY のとき生涯 1 回だけ [Y/n]（既定 Yes）を聞き、Yes なら
   │     packages/audio-library-setup/bin/fetch-akari-sounds.mjs で一括ダウンロード。
-  │     n は marker（~/.akari/assets/audio/.akari-sounds-declined.json）を書いて以後
+  │     n は marker（<ライブラリの置き場>/audio/.akari-sounds-declined.json）を書いて以後
   │     聞かない。再入口は `akari sounds`。失敗しても起動は止めない
   │
   └─ 5. 最後に opencode を exec する
@@ -48,7 +52,7 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `akari store <connect|status|install|download|disconnect>`（AKARI Store 連携。マイページで発行した
 接続トークンを `~/.akari/store-credentials.json`（0600）に保存し、購入済み一覧の確認と
 配布物の取得ができる。`install <productId> [--from <zip>]` は購入パックを展開し、`PACK.json` の
-収載素材を `~/.akari/assets/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
+収載素材を `<ライブラリの置き場>/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
 zip を使う。`src/store-command.mjs`）/
 `akari assets <list|fetch|sync|...>`（素材カタログの一覧・取得・同期。
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.73",
+  "version": "0.1.74",
   "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/cli.mjs

@@ -7,7 +7,7 @@ import { detectProjectState } from './project-state.mjs';
 import { findClaudeExecutable, findExecutable, findOpencodeExecutable } from './path-lookup.mjs';
 import { loadTaskLabels } from './task-labels.mjs';
 import { describeForceReinstall, describeInstalledVersions, describeIntake, claudeMissingGuidance, opencodeMissingGuidance, describeUpdateCacheFallback, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
-import { resolveEffectiveProjectRoot } from './first-run.mjs';
+import { defaultLoadCreatorRootModule, resolveEffectiveProjectRoot } from './first-run.mjs';
 import { maybeShowAssetIntroNotice } from './sounds-setup.mjs';
 import {
   checkForUpdateSync,
@@ -82,6 +82,14 @@ export async function run(args, options = {}) {
     projectRoot = await resolveEffectiveProjectRoot({ projectRoot, env, platform, now, log, assets, autoConfirm, options });
   }
 
+  try {
+    const creatorRoot = await defaultLoadCreatorRootModule(assets);
+    const migration = await creatorRoot?.migrateAssetLibrary({ env, platform, automatic: true, notify: log });
+    for (const failure of migration?.failures ?? []) log(`素材の移行を再試行します: ${failure.message}`);
+  } catch (error) {
+    log(`素材の移行を再試行します: ${error.message}`);
+  }
+
   let state = detectProjectState(projectRoot);
 
   if (!state.scaffolded) {

package/src/kits.mjs

@@ -1,3 +1,4 @@
+import { pathToFileURL } from 'node:url';
 import { spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import {
@@ -7,6 +8,12 @@ import {
 import path from 'node:path';
 
 import { resolveLauncherAssets } from './repo-assets.mjs';
+const creatorRootModulePath = resolveLauncherAssets().creatorRootModulePath;
+const creatorRoot = creatorRootModulePath ? await import(pathToFileURL(creatorRootModulePath).href) : null;
+function resolveAssetLibraryRoots(env) {
+  if (!creatorRoot) throw new Error('creator-root が見つからないため素材の置き場を解決できません。AKARI Video を再インストールしてください。');
+  return creatorRoot.resolveAssetLibraryRoots(env);
+}
 
 const KITS_SCHEMA = 'akari-installed-kits/v0';
 const INSTALLED_ASSETS_SCHEMA = 'akari-installed-assets/v0';
@@ -152,16 +159,8 @@ export function linkKitAssets(kitDir, manifest, home, options = {}) {
     } else {
       warnings.push(`素材 ${asset.category}/${asset.id} の検査ツールが見つからないため検査をスキップしました。`);
     }
-    const destination = path.join(home, 'assets', asset.category, asset.id);
-    const productRoot = path.join(home, 'assets', 'store', manifest.id);
-    const kitSubdir = path.relative(productRoot, kitDir);
-    const result = replaceSymlink(source, destination, {
-      ...options,
-      relativeTarget: path.join(
-        '..', '..', 'assets', 'store', manifest.id, kitSubdir,
-        'assets', asset.category, asset.id
-      )
-    });
+    const destination = path.join(resolveAssetLibraryRoots({ ...(options.env ?? process.env), AKARI_HOME: home }).write, asset.category, asset.id);
+    const result = replaceSymlink(source, destination, options);
     if (result.status === 'occupied') {
       warnings.push(`既存の実ディレクトリを保持しました: ${destination}`);
     } else if (result.status === 'permission-denied') {
@@ -174,8 +173,8 @@ export function linkKitAssets(kitDir, manifest, home, options = {}) {
   return { linked, items, warnings };
 }
 
-function readInstalledAssetsIndex(home) {
-  const indexPath = path.join(home, 'assets', 'installed.json');
+function readInstalledAssetsIndex(home, env = process.env) {
+  const indexPath = path.join(resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).write, 'installed.json');
   if (!existsSync(indexPath)) return { schema: INSTALLED_ASSETS_SCHEMA, packs: {} };
   const index = JSON.parse(readFileSync(indexPath, 'utf8'));
   if (index?.schema !== INSTALLED_ASSETS_SCHEMA
@@ -185,38 +184,38 @@ function readInstalledAssetsIndex(home) {
   return index;
 }
 
-function writeInstalledAssetsIndex(home, index) {
-  const indexPath = path.join(home, 'assets', 'installed.json');
+function writeInstalledAssetsIndex(home, index, env = process.env) {
+  const indexPath = path.join(resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).write, 'installed.json');
   mkdirSync(path.dirname(indexPath), { recursive: true });
   const temporary = `${indexPath}.tmp-${process.pid}`;
   writeFileSync(temporary, `${JSON.stringify(index, null, 2)}\n`, { mode: 0o600 });
   renameSync(temporary, indexPath);
 }
 
-export function registerKitAssets(home, manifest, kitDir, items) {
+export function registerKitAssets(home, manifest, kitDir, items, env = process.env) {
   const root = path.resolve(kitDir);
-  const storeRoot = path.join(path.resolve(home), 'assets', 'store', manifest.id);
+  const storeRoot = path.join(resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).write, 'store', manifest.id);
   if (root !== storeRoot && !root.startsWith(`${storeRoot}${path.sep}`)) {
     throw new Error(`キット素材の root が展開先の外を指しています: ${root}`);
   }
-  const index = readInstalledAssetsIndex(home);
+  const index = readInstalledAssetsIndex(home, env);
   index.packs[manifest.id] = {
     version: manifest.version,
     installedAt: new Date().toISOString(),
     root,
     items
   };
-  writeInstalledAssetsIndex(home, index);
+  writeInstalledAssetsIndex(home, index, env);
   return items;
 }
 
-function unregisterKitAssets(home, productId) {
-  const indexPath = path.join(home, 'assets', 'installed.json');
+function unregisterKitAssets(home, productId, env = process.env) {
+  const indexPath = path.join(resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).write, 'installed.json');
   if (!existsSync(indexPath)) return;
-  const index = readInstalledAssetsIndex(home);
+  const index = readInstalledAssetsIndex(home, env);
   if (!Object.hasOwn(index.packs, productId)) return;
   delete index.packs[productId];
-  writeInstalledAssetsIndex(home, index);
+  writeInstalledAssetsIndex(home, index, env);
 }
 
 export function linkKitSkills(kitDir, manifest, home, options = {}) {
@@ -276,20 +275,20 @@ export function writeKitsLedger(home, entry) {
   return ledger;
 }
 
-export function removeKit(home, productId) {
+export function removeKit(home, productId, env = process.env) {
   const ledger = readKitsLedger(home);
   const entry = ledger.kits.find((kit) => kit.id === productId);
   if (!entry) return false;
   for (const name of entry.skills ?? []) removeOwnedSymlink(path.join(home, 'kits', 'plugin', 'skills', name), entry.kitDir);
   for (const asset of entry.assets ?? []) {
-    removeOwnedSymlink(path.join(home, 'assets', asset.category, asset.id), entry.kitDir);
+    for (const root of resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).read) removeOwnedSymlink(path.join(root, asset.category, asset.id), entry.kitDir);
   }
   ledger.kits = ledger.kits.filter((kit) => kit.id !== productId);
   const ledgerPath = path.join(home, 'kits', 'installed.json');
   const temporary = `${ledgerPath}.tmp-${process.pid}`;
   writeFileSync(temporary, `${JSON.stringify(ledger, null, 2)}\n`, { mode: 0o600 });
   renameSync(temporary, ledgerPath);
-  unregisterKitAssets(home, productId);
+  unregisterKitAssets(home, productId, env);
   return true;
 }
 

package/src/store-command.mjs

@@ -20,6 +20,12 @@ import {
 } from './store-device-connect.mjs';
 import { readOwnVersion } from './update-check.mjs';
 import { resolveLauncherAssets } from './repo-assets.mjs';
+const creatorRootModulePath = resolveLauncherAssets().creatorRootModulePath;
+const creatorRoot = creatorRootModulePath ? await import(pathToFileURL(creatorRootModulePath).href) : null;
+function resolveAssetLibraryRoots(env) {
+  if (!creatorRoot) throw new Error('creator-root が見つからないため素材の置き場を解決できません。AKARI Video を再インストールしてください。');
+  return creatorRoot.resolveAssetLibraryRoots(env);
+}
 import {
   checkRequires,
   enableHint,
@@ -154,8 +160,7 @@ function flattenPackContents(pack, packRoot) {
 }
 
 function registerInstalledPack(env, productId, packPath) {
-  const home = resolveAkariHome(env);
-  const indexPath = path.join(home, 'assets', 'installed.json');
+  const indexPath = path.join(resolveAssetLibraryRoots(env).write, 'installed.json');
   const packRoot = path.dirname(packPath);
   const pack = readJsonFile(packPath);
   if ((typeof pack?.version !== 'string' && typeof pack?.version !== 'number')) {
@@ -319,7 +324,7 @@ export async function runStoreCommand(args, options = {}) {
       log('使い方: akari store uninstall <productId>');
       return { exitCode: 1 };
     }
-    if (!removeKit(resolveAkariHome(env), productId)) {
+    if (!removeKit(resolveAkariHome(env), productId, env)) {
       log(`導入済みの拡張キットが見つかりません: ${productId}`);
       return { exitCode: 1 };
     }
@@ -430,7 +435,7 @@ export async function runStoreCommand(args, options = {}) {
           log('パック内に declarations.json が見つかりませんでした。zip の中身を確認してください。');
           return { exitCode: 1 };
         }
-        const destDir = path.join(resolveAkariHome(env), 'assets', 'audio');
+        const destDir = path.join(resolveAssetLibraryRoots(env).write, 'audio');
         mkdirSync(destDir, { recursive: true });
         const dest = path.join(destDir, 'declarations.json');
         if (existsSync(dest)) {
@@ -445,7 +450,7 @@ export async function runStoreCommand(args, options = {}) {
       }
 
       // 既知の導入手順が無い商品は素材置き場に展開して README を案内
-      const destDir = path.join(resolveAkariHome(env), 'assets', 'store', productId);
+      const destDir = path.join(resolveAssetLibraryRoots(env).write, 'store', productId);
       rmSync(destDir, { recursive: true, force: true });
       cpSync(extractDir, destDir, { recursive: true });
       const readme = findFile(destDir, 'README.md');
@@ -531,6 +536,7 @@ export async function runStoreCommand(args, options = {}) {
 
         const hadInstalledKit = readKitsLedger(home).kits.length > 0;
         const assetLinks = linkKitAssets(kitDir, manifest, home, {
+          env,
           assets: options.assets,
           spawnSyncImpl: options.spawnSync,
           platform: options.platform
@@ -541,7 +547,7 @@ export async function runStoreCommand(args, options = {}) {
           for (const blocker of skillLinks.blockers) log(`導入できません: ${blocker}`);
           return { exitCode: 1 };
         }
-        registerKitAssets(home, manifest, kitDir, assetLinks.items);
+        registerKitAssets(home, manifest, kitDir, assetLinks.items, env);
         writeKitsLedger(home, {
           id: manifest.id,
           version: manifest.version,

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

@@ -1,5 +1,9 @@
 # 素材ライブラリ契約 v0
 
+ライブラリの置き場は既定で作業場の `library/`。作業場が無いときは従来の `~/.akari/assets/` を使う。
+`akari-assets list`（または `akari assets list`）の先頭行で実際の置き場を確認する。
+以下の `<ライブラリの置き場>` はその表示先を指し、音源はその下の `audio/` に入る。
+
 - 日付: 2026-07-13
 - 状態: 設計確定
 - 前提: 本体（エンジン）は合成だけ。素材とその知識は全部外側に置く
@@ -215,7 +219,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 |---|---|---|
 | `local` | `<プロジェクト>/assets/` | そのプロジェクトのみ |
 | `shared` | プロジェクトから上位へ辿った各ディレクトリの `.akari/assets/`（2026-07-25 第三裁定で確定） | そのディレクトリ配下の全プロジェクト（事業・組織単位。複数層可） |
-| `user` | `~/.akari/assets/`（2026-07-25 第三裁定で確定） | そのマシンの全プロジェクト |
+| `user` | `<ライブラリの置き場>/`（2026-07-25 第三裁定で確定） | そのマシンの全プロジェクト |
 | `builtin` | 本リポの `assets/` | 製品出荷デフォルト |
 | `catalog` | 本リポの `catalog/`（remote） | 取得して任意の層へ入庫 |
 
@@ -241,7 +245,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 ~~**確定裁定（2026-07-25 再裁定）: プロジェクト外の置き場所は `~/.akari-video/` をベースに
 統一する。** 初期案保留（旧「`.akari-video/` は初期案」項）はこれで解消。~~
 
-**確定裁定（2026-07-25 第三裁定）: プロジェクト外の置き場所は `~/.akari/` 直下に統一する。**
+**履歴（2026-07-25 第三裁定）: 当時の user 素材は `~/.akari/` 直下だった。2026-09-21 から素材は作業場 `library/` に移行し、マシン状態のみ `~/.akari/` に残す。**
 `~/.akari/` 直下には他ソフトウェアの既存物が併存する場合があるため、共存規約
 （本節末尾を参照）を必ず守る。
 
@@ -250,7 +254,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 
 確定事項（2026-07-25 第三裁定で更新。カッコ内は第二裁定時点の値）:
 
-- `user` 層: `~/.akari/assets/`（第二裁定時点: `~/.akari-video/assets/`）
+- `user` 層: `<ライブラリの置き場>/`（第二裁定時点: `~/.akari-video/assets/`）
 - `shared` 層: 上位ディレクトリの `.akari/assets/`（第二裁定時点: `.akari-video/assets/`）
 - レシピ: `~/.akari/recipes/`（recipe v0 の現行表記のまま・変更不要。出所は
   `docs/contract-2026-07-25-recipe-v0.md` §2 に追記）
@@ -380,7 +384,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 - **カテゴリを増やさない**のが本改訂の要点である。新しい主題（ホワイトボード、ノート風、付箋…）は
   既存カテゴリ + tags で表す。カテゴリ追加を提案するときは「既存 6 つのどの形にも当てはまらない
   配布・消費のされ方か」を先に示す
-- `audio` を `media` に畳む案は見送った。`~/.akari/assets/audio/`（user 層）に実データがあり、
+- `audio` を `media` に畳む案は見送った。`<ライブラリの置き場>/audio/`（user 層）に実データがあり、
   リポ外のユーザー資産の移設を伴うため。`audio` と `broll` は消費経路（音声トラック / 映像トラック）が
   異なるので、形の軸としても分けたままで筋が通る
 - 移行時の実績: `assets/` 3 件・`catalog/` 3 件のディレクトリ移動と `category` 値の書き換え、

package/vendor/docs/contract-2026-08-02-creator-root-v1.md

@@ -1,5 +1,9 @@
 # creator-root-v1（作業場）契約
 
+ライブラリの置き場は既定で作業場の `library/`。作業場が無いときは従来の `~/.akari/assets/` を使う。
+`akari-assets list`（または `akari assets list`）の先頭行で実際の置き場を確認する。
+以下の `<ライブラリの置き場>` はその表示先を指し、音源はその下の `audio/` に入る。
+
 - 日付: 2026-08-02
 - 状態: **v1 ドラフト・要オーナーレビュー**（設計方針はオーナー承認済み 2026-08-02。
   判断根拠・出典調査は非公開の内部記録で管理する）
@@ -41,8 +45,8 @@ AKARI Video がマシン上に持ってよい場所は次の 3 つ**だけ**で
 - マシン状態の実パスは**既存実装の規約を追認**する（`~/.akari/` = 更新キャッシュ・接続マーカー・
   可搬 Node runtime 等 / 資格情報は `~/.config/akari-video/credentials.env`）。新たな隠し場所を増やさない
 - 原則: マシン状態には**ユーザーの内容物（作品・素材・記憶）を置かない**。
-  既存の `~/.akari/assets/audio`（audio library 既定）は v1 時点の既存例外であり、
-  作業場 `library/` への移行は別タスクで扱う
+  旧音源ライブラリの例外は 2026-09-21 の移行で回収した。素材は作業場 `library/` へ移し、
+  マシン設定の `library-location.json` に置き場を固定する（作業場なし・同期フォルダは移さない）。
 
 - **secrets（API キー・トークン類）はマシン設定にのみ置く**。作業場は可視・バックアップ・
   同期対象なので、secrets を混ぜてはならない

package/vendor/docs/contract-2026-09-02-asset-reference-model.md

@@ -1,5 +1,9 @@
 # contract — 素材の参照モデル v0（共有ライブラリ参照の台帳と解決規則）
 
+ライブラリの置き場は既定で作業場の `library/`。作業場が無いときは従来の `~/.akari/assets/` を使う。
+`akari-assets list`（または `akari assets list`）の先頭行で実際の置き場を確認する。
+以下の `<ライブラリの置き場>` はその表示先を指し、音源はその下の `audio/` に入る。
+
 - 状態: 実装済み（機械層のみ。シェル UI の採用は後続）
 - 決定日: 2026-09-02
 - 実装: `packages/asset-resolver`（記帳・実体化）/ `packages/render-cut`・`packages/edit-lint`（解決）
@@ -7,7 +11,7 @@
 ## 1. 目的
 
 カタログ素材をプロジェクトごとに実体コピーすると、同じ素材が何度もダウンロード・複製されて
-プロジェクトが肥大する。実体は**マシン単位の共有ライブラリ**（`~/.akari/assets/<category>/<id>/`）に
+プロジェクトが肥大する。実体は**マシン単位の共有ライブラリ**（`<ライブラリの置き場>/<category>/<id>/`）に
 1 部だけ置き、プロジェクトには**参照だけを記録**できるようにする。
 
 ## 2. 設計の要点
@@ -25,11 +29,11 @@
   edit.json の version とは無関係。
 - **解決規則**: 宣言されたプロジェクト相対パスが `assets/<category>/<id>/<rest>` の形で、
   (1) プロジェクト実体が存在せず、(2) 台帳に `{category, id}` があるとき、
-  `<AKARI_HOME>/assets/<category>/<id>/<rest>`（AKARI_HOME 既定 `~/.akari`・env で上書き可）へ
-  フォールバックする。解決先は realpath 後も `<AKARI_HOME>/assets` 配下に収まる正規ファイルで
+  `resolveAssetLibraryRoots().read` の順（新しい置き場 → 従来の置き場）にフォールバックする。
+  解決先は各ルートで字句・realpath containment を満たす正規ファイルで
   あること（`..` 等の脱出は fail-closed で拒否）。
 - render-cut は解決した入力を render inputs 記録に `scope: "library"` として残す
-  （既存 `scope: "akari"` と同列の additive 記録）。edit-lint は解決できる参照を欠落と報告せず、
+  （既存 `scope: "akari"` と同列の additive 記録）。採用した実ルートを `library_root` に保存して後段でも検査する。edit-lint は解決できる参照を欠落と報告せず、
   台帳にあるが実体が無い参照は「共有ライブラリ参照（未取得）」として欠落報告する。
 - render-cut / edit-lint は依存ゼロ CLI のため、解決ロジックは各パッケージ内に**同一実装を重複**して
   持つ（`src/library-reference.mjs`）。挙動同一性は両テストの同一ケース表で担保する。
@@ -47,7 +51,53 @@ akari-assets bundle --project <dir> [--dry-run]
 bundle は台帳の各参照をキャッシュから `assets/<category>/<id>/` へ実体化して台帳から除去する。
 未取得の参照は resolve（取得）を試み、取得できないものは台帳に残して部分成功（exit 非 0）で報告する。冪等。
 
-## 4. スコープ外（後続）
+## 4. 書き出しエンジンの配信
+
+OSR / GPU の共通配信サーバーは、render-cut が解決した入力のうち `scope: "library"` の
+全件を許可表として受け取る。映像だけでなく、音・静止画・オーバーレイ内の素材も対象。
+キーは宣言パス `assets/<category>/<id>/<rest>`（区切りは `/`）、値は
+`{ absolute: <実体の絶対パス>, library_root: <採用ルート> }`。
+配信側は置き場の探索や台帳からの再解決を行わない。
+
+ffmpeg の計画には、同じ render inputs の解決結果で素材パス欄だけを絶対パスへ置き換えた
+edit の写しを渡す。BGM・SFX・ナレーション・分離音声・レイヤー音声の入力と尺の probe が対象。
+映像ソースの cut 音声は既存の解決済み capabilities を使い、contact sheet は書き出した動画を読む。
+元の edit.json、配信用の宣言パス、receipt の入力パスは書き換えない。
+
+別プロセスへの受け渡しには
+`<projectRoot>/.akari/render-tmp/media-references-<render-cut の PID>.json` を使う。
+表の形式は `{ "token": "<合言葉>", "references": { "<宣言パス>": { "absolute": "<実体の絶対パス>", "library_root": "<採用ルート>" } } }`。
+render-cut は実行ごとに `crypto.randomBytes(32)` の合言葉を hex 文字列として生成し、
+同じ値を環境変数 `AKARI_RENDER_MEDIA_REFERENCES_TOKEN` に設定してから書き出しを起動する。
+この変数は Electron 子プロセスへ継承される。終了時は `finally` で元の値へ戻し、元が未定義なら削除する。
+合言葉はログ・エラー文・render.json に出さない。
+render-cut は子プロセスの起動前に排他的に作成し、OSR / GPU（GPU から OSR への再試行を含む）の
+終了時に `finally` で成功・失敗とも削除する。Electron は親 PID からパスを決め、サーバー生成時に
+一度だけ読む。別 CLI の並行実行は表を共有しない。プロセス内の使用中パス集合で
+同じプロジェクトの重複実行（ネスト呼び出しを含む）を拒否する。集合に無い自 PID の既存表は、
+クラッシュや PID 再利用による残存表として削除してから排他的に作り直す。
+使用中の記録は作成・書き出し・後片付けの失敗時にも解除する。他 PID の表は回収しない。
+ファイル経由の表は、環境変数が無い・空、表の token が文字列でない、UTF-8 バイト長が異なる、
+または `crypto.timingSafeEqual` で一致しない場合は一切使わない。token の無い旧形式や壊れた JSON も空の表として扱う。
+これにより単体 CLI など render-cut を通らない起動では、プロジェクトに植え込まれた表から外部ファイルを配信しない。
+配信 API の明示引数 `mediaReferences` がある場合は従来どおりそちらを優先し、
+表が無い場合や認証できない場合はプロジェクト内だけを配信する。
+
+`/media/<宣言パス>` は次の順で検査する。
+
+1. デコード後に `..` セグメント（`/` と `\` の両区切り）を含む要求は 403。
+2. プロジェクト内の実体があれば優先する。字句・realpath の両方でプロジェクト内に収まることを
+   検査し、symlink による脱出は 403、正規ファイルでなければ 404。
+3. プロジェクトに実体が無い場合のみ、許可表の完全一致キーを調べる。表に無いファイルは
+   ライブラリ配下に存在しても 404。
+4. 表の実体が採用ルート内にあることを字句で確認し、さらに実体と採用ルートを毎回 realpath で
+   解決して包含を再検査する。脱出は 403、欠落・非正規ファイルは 404。
+5. 許可した実体は既存のファイル配信を使い、通常取得は 200、Range 取得は 206 とする。
+
+台帳にあっても置き場に無い必須素材は、従来の render inputs / 計画段階のエラーで停止する。
+配信ページの 404 を待ってから失敗させない。
+
+## 5. スコープ外（後続）
 
 - シェル UI の採用（取り込みフローの reference 既定化・プロジェクト面の「参照」バッジ・
   プレビュー経路のフォールバック）

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

@@ -1,5 +1,9 @@
 # akari-launcher（`akari` コマンド）
 
+ライブラリの置き場は既定で作業場の `library/`。作業場が無いときは従来の `~/.akari/assets/` を使う。
+`akari-assets list`（または `akari assets list`）の先頭行で実際の置き場を確認する。
+以下の `<ライブラリの置き場>` はその表示先を指し、音源はその下の `audio/` に入る。
+
 「UI に依存したくない。opencode 単体でも、どんなディレクトリでも始められるように」を
 実現する薄いラッパー CLI。npm パッケージ名は `akari-video`、提供するコマンド名は `akari`
 （npm の `akari` は別プロダクトが取得済みのため。オーナー裁定 2026-07-21 §8-2）。
@@ -24,7 +28,7 @@ akari
   ├─ 4. 公式音源ライブラリ（AKARI Sounds）の初回セットアップ（src/sounds-setup.mjs）:
   │     未導入かつ TTY のとき生涯 1 回だけ [Y/n]（既定 Yes）を聞き、Yes なら
   │     packages/audio-library-setup/bin/fetch-akari-sounds.mjs で一括ダウンロード。
-  │     n は marker（~/.akari/assets/audio/.akari-sounds-declined.json）を書いて以後
+  │     n は marker（<ライブラリの置き場>/audio/.akari-sounds-declined.json）を書いて以後
   │     聞かない。再入口は `akari sounds`。失敗しても起動は止めない
   │
   └─ 5. 最後に opencode を exec する
@@ -48,7 +52,7 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `akari store <connect|status|install|download|disconnect>`（AKARI Store 連携。マイページで発行した
 接続トークンを `~/.akari/store-credentials.json`（0600）に保存し、購入済み一覧の確認と
 配布物の取得ができる。`install <productId> [--from <zip>]` は購入パックを展開し、`PACK.json` の
-収載素材を `~/.akari/assets/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
+収載素材を `<ライブラリの置き場>/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
 zip を使う。`src/store-command.mjs`）/
 `akari assets <list|fetch|sync|...>`（素材カタログの一覧・取得・同期。
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.73",
+  "version": "0.1.74",
   "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

@@ -1,9 +1,13 @@
 # @akari-video/asset-resolver
 
+ライブラリの置き場は既定で作業場の `library/`。作業場が無いときは従来の `~/.akari/assets/` を使う。
+`akari-assets list`（または `akari assets list`）の先頭行で実際の置き場を確認する。
+以下の `<ライブラリの置き場>` はその表示先を指し、音源はその下の `audio/` に入る。
+
 無料素材の参照配布 + オンデマンド取得 resolver v0。
 
 「このアカウントで使える素材（無料 + 購入済み）」をカタログ + entitlements + ローカル取得状態から
-1 リストに合成し、**使った素材だけ**を `~/.akari/assets/<category>/<id>/` へ取得・検証して登録する。
+1 リストに合成し、**使った素材だけ**を `<ライブラリの置き場>/<category>/<id>/` へ取得・検証して登録する。
 「全部ダウンロード」を既定にしない、という設計契約（内部リポ
 `planning/notes-2026-08-04-asset-reference-distribution.md`）の本体側実装。
 
@@ -17,6 +21,7 @@
 ```sh
 akari-assets list [--category <c>] [--json]          # 合成カタログ一覧（取得状態バッジ込み）
 akari-assets fetch <id> [--project <dir>] [--force]   # 素材を解決してローカルへ登録
+akari-assets migrate [--dry-run]                      # 旧置き場を再移行（dry-run は変更しない）
 akari-assets sync                                      # カタログを取得してローカルにキャッシュ
 akari-assets browse [--port <n>]                       # ローカル HTTP サーバでカタログを閲覧・投入
 ```
@@ -25,14 +30,14 @@ akari-assets browse [--port <n>]                       # ローカル HTTP サ
 `[installed]` `akari store install` で導入済み。
 
 `akari store install <productId> [--from <zip>]` が `PACK.json` を持つ購入パックを展開すると、
-収載素材は `~/.akari/assets/installed.json` に登録される。resolver はこの索引をリモートカタログへ
+収載素材は `<ライブラリの置き場>/installed.json` に登録される。resolver はこの索引をリモートカタログへ
 マージし、同じ id があれば導入済みのローカル実体を優先する。`fetch` はネットワークや entitlement
 照会を使わずパックからコピーし、`PACK.json` 記載の sha256 と照合してから通常の素材ライブラリへ
 原子的に登録する。
 
 `fetch` はキャッシュヒットなら即座にそのパスを返す。未取得なら、カタログの `files[]` を全部
 一時ディレクトリへ実体化 → sha256 検証 → （`meta.json` を含む素材は）`validate-asset.mjs` で
-契約検証 → 全部通ってから `~/.akari/assets/<category>/<id>/` へ原子的に登録する。
+契約検証 → 全部通ってから `<ライブラリの置き場>/<category>/<id>/` へ原子的に登録する。
 途中で失敗したら一時ディレクトリを破棄し、登録先には一切書き込まない（fail-closed。部分状態を
 残さない）。有料で未購入（`price > 0` かつ entitlements に無い）は `fetch` を拒否する
 （一度取得済みのキャッシュはそのまま使える — ゲートは「新規取得」だけにかかる）。
@@ -54,7 +59,7 @@ BSD `cp -Rc`（`clonefile(2)` 直呼び）を試し、失敗時のみ上記 `fs.
    直下）で全ファイルの sha256 を検証
 3. `README.md` / `LICENSE.md` / `checksums.txt` を除く素材ペイロードを一時ディレクトリへコピー
 4. （`meta.json` を含む素材は）`validate-asset.mjs` で契約検証
-5. 全部通ってから `~/.akari/assets/<category>/<id>/` へ原子的に登録
+5. 全部通ってから `<ライブラリの置き場>/<category>/<id>/` へ原子的に登録
 
 無料経路と同じ fail-closed の規律（1 件でも失敗したら一時ディレクトリを破棄し、登録先には
 一切書き込まない）を踏襲する。ダウンロード失敗（オフライン・トークン失効）・zip 構成不正・
@@ -101,7 +106,8 @@ checksums 不一致は、いずれも `AssetResolverError`（`code: 'download_fa
 
 | 変数 | 既定値 | 用途 |
 | --- | --- | --- |
-| `AKARI_HOME` | `~/.akari` | ライブラリ（`assets/`）・カタログキャッシュ・`store-credentials.json` の置き場 |
+| `AKARI_HOME` | `~/.akari` | マシン状態（library-location.json・カタログキャッシュ・store-credentials.json）。作業場なしでは旧 assets/ もここに置く |
+| `AKARI_LIBRARY_ROOT` | 未設定 | ライブラリの書き込み先の明示上書き（読みは旧置き場にもフォールバック） |
 | `AKARI_ASSETS_CATALOG` | `https://akari-oss.app/assets/catalog.json` | カタログの取得元。**URL** ならリモート fetch、それ以外はローカルファイルパスとして読む（未デプロイの開発時は store リポのローカル出力を指す） |
 | `AKARI_ASSETS_BASE` | カタログの `base` フィールド | 素材実体の配信ベースの上書き（ローカル開発でディレクトリを直接指すときに使う） |
 | `AKARI_STORE_API` | `https://akari-oss.app` | entitlements API のホスト上書き。未設定時は `~/.akari/store-credentials.json` の `url`（`akari store connect` が書き込む値）から組み立てる |
@@ -145,3 +151,22 @@ node --test
 - `packages/akari-launcher/src/store-command.mjs` の `akari store connect` が書く
   `~/.akari/store-credentials.json`（`{ url, token, email }`）をそのまま読む
   （依存追加を避けるため import はせず、同じファイル規約だけを踏襲）
+
+## ライブラリの解決と移行
+
+`resolveAssetLibraryRoots(env, { platform })` の正本は `packages/creator-root/src/index.mjs`。
+書き込みは `AKARI_LIBRARY_ROOT` → `<AKARI_HOME>/library-location.json` → 従来の `assets/` の順で 1 か所に決まる。
+location が有効なのは migrating / done のときだけ。pending / declined では旧置き場への読み書きを維持し、同期フォルダへは書き込まない。
+明示の AKARI_LIBRARY_ROOT は最優先。読み取りは有効な置き場と従来の置き場を重複なく見る（新しい方を優先）。cwd の上方探索はしない。
+`list --json` は互換性のため従来どおり素材配列のみを返す。置き場表示は通常の `list` の先頭行。
+
+シェルと launcher の起動時に共通の移行実装を呼ぶ。`library-location.json` は version 0、
+root（絶対パス）、state（pending / migrating / done / declined）、decidedAt、migratedAt、notifiedAt を持ち、
+一時ファイル + rename で原子的に更新する。不在・壊れは従来の置き場へフォールバックする。
+移行先を初めて決めるときだけ `AKARI_CREATOR_ROOT` とマシンポインタの `lastRoot` を使う。
+
+同一ディスクは rename、EXDEV は複製・サイズと sha256 照合・旧側削除。同名素材は上書きせず旧側に残し、
+結果の skipped に記録する。カテゴリの中の新規素材は再移行できる。付随ファイルとキットの参照も追随する。
+途中失敗は migrating のまま再開可能。done 後に旧 CLI が追加した素材は `akari-assets migrate` で寄せる。
+作業場なしは何もしない。OneDrive / Dropbox / iCloud Drive / Google Drive 配下は pending に留め、
+結果に同期先と総容量を返す。ドロップフォルダと reviews はマシン状態として元の場所に残す。

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

@@ -7,6 +7,7 @@
 //   akari-assets sync
 //   akari-assets browse [--port <n>]
 
+import { migrateAssetLibrary } from '../../creator-root/src/index.mjs';
 import { startBrowseServer } from '../src/browse-server.mjs';
 import { bundleProjectReferences } from '../src/bundle.mjs';
 import { cacheCatalog, loadCatalog } from '../src/catalog.mjs';
@@ -29,7 +30,7 @@ function badgeOf(item) {
 async function cmdList(args, env) {
   const category = flagValue(args, '--category');
   const asJson = args.includes('--json');
-  const { home, items } = await composeState({ env });
+  const { libraryRoots, items } = await composeState({ env });
   const filtered = category ? items.filter((item) => item.category === category) : items;
 
   if (asJson) {
@@ -37,7 +38,7 @@ async function cmdList(args, env) {
     return;
   }
 
-  console.log(`使える素材 ${filtered.length} 件（ライブラリ: ${home}）`);
+  console.log(`使える素材 ${filtered.length} 件（ライブラリ: ${libraryRoots.write}）`);
   for (const item of filtered) {
     console.log(`  ${badgeOf(item)}  ${item.id}\t[${item.category}]\t${item.title}`);
   }
@@ -119,17 +120,19 @@ async function cmdBrowse(args, env) {
 }
 
 function printUsage() {
-  console.log(`使い方: akari-assets <list|fetch|bundle|sync|browse> [options]
+  console.log(`使い方: akari-assets <list|fetch|bundle|migrate|sync|browse> [options]
 
   list [--category <c>] [--json]          合成カタログ一覧（取得状態バッジ込み）
   fetch <id> [--project <dir>] [--reference] [--force]
                                           素材を解決して登録（--reference はコピーせず参照を記帳）
   bundle --project <dir> [--dry-run]      参照素材をプロジェクトへ実体化（素材をまとめる）
+  migrate [--dry-run]                     ライブラリを作業場へ移行
   sync                                    カタログを取得してローカルにキャッシュ（オフライン用）
   browse [--port <n>]                     ローカル HTTP サーバでカタログを閲覧・投入（既定 8910）
 
 環境変数:
-  AKARI_HOME             ライブラリの置き場（既定: ~/.akari）
+  AKARI_HOME             マシン設定の置き場（既定: ~/.akari）
+  AKARI_LIBRARY_ROOT     ライブラリの置き場の上書き
   AKARI_ASSETS_CATALOG   カタログの取得元。URL またはローカルパス（既定: akari-oss.app/assets/catalog.json）
   AKARI_ASSETS_BASE      素材実体の配信ベースの上書き（既定はカタログの "base" フィールド）
   AKARI_STORE_API        entitlements API のホスト上書き（既定: akari-oss.app）`);
@@ -139,6 +142,12 @@ async function main() {
   const [sub, ...rest] = process.argv.slice(2);
   const env = process.env;
 
+  if (sub === 'migrate') {
+    const result = await migrateAssetLibrary({ env, dryRun: rest.includes('--dry-run') });
+    console.log(JSON.stringify(result, null, 2));
+    if (result.failures.length) process.exitCode = 1;
+    return;
+  }
   if (sub === 'list') return cmdList(rest, env);
   if (sub === 'fetch') return cmdFetch(rest, env);
   if (sub === 'bundle') return cmdBundle(rest, env);

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

@@ -1,5 +1,4 @@
-import { resolveAkariHome } from './env.mjs';
-import { isAssetCached, localAssetDir } from './library.mjs';
+import { isAssetCached, cachedAssetDir } from './library.mjs';
 import { readProjectReferences, removeProjectReference } from './project-references.mjs';
 import { copyIntoProject, resolve as resolveAsset } from './resolve.mjs';
 
@@ -12,10 +11,9 @@ export async function bundleProjectReferences({
   const result = { planned, materialized: [], failures: [] };
   if (dryRun) return result;
 
-  const home = resolveAkariHome(env);
   for (const reference of planned) {
     try {
-      if (!isAssetCached(home, reference.category, reference.id)) {
+      if (!isAssetCached(env, reference.category, reference.id)) {
         const resolved = await resolveAsset(reference.id, { env });
         if (resolved.category !== reference.category) {
           throw new Error(
@@ -23,7 +21,7 @@ export async function bundleProjectReferences({
           );
         }
       }
-      const sourceDir = localAssetDir(home, reference.category, reference.id);
+      const sourceDir = cachedAssetDir(env, reference.category, reference.id);
       const projectDir = await copyIntoProject(
         sourceDir,
         project,