akari-video 0.1.72 → 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.72",
+  "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/docs/contract-2026-09-13-generation-v0.md

@@ -1,6 +1,7 @@
 # 生成 v0 契約 — 仮枠クリップ・9 スロット・meta.json・能力カタログ・状態
 
-> 正本の写し（2026-09-13）・技術部分のみ。内部正本の §1〜§9 を公開向けに収録する。
+> 正本の写し（2026-09-13・2026-09-21 改訂）・技術部分のみ。内部正本の §1〜§9 と §11 を公開向けに収録する。
+> 節番号の対応: 本書 §1〜§9 = 内部正本 §1〜§9、本書 §10（コマ保存）= 内部正本 §11。
 
 ## 1. 継ぎ目（仮枠とタイムライン）
 
@@ -10,6 +11,9 @@
 4. 「動画にする」は同じ item の `source.path` を mp4 に書き換える**差し替え**であり、item id・トラック・尺は変わらない（§7）
 5. 絵コンテはタイムラインの印刷（9/6 §5）。生成の入力にしない
 6. plan.json の仮枠役（`confidence` / `fill`）は退役。`plan-comments.json` の `pass: "scaffold"` の対象は `slot` から **clip id** へ
+7. **空の枠**（2026-09-21）: 仮枠ツール（F）で空いているところに描いた枠は、prompt 未記入の**文字カード png** を素材に持つ media item（絵のないクリップを文字カード png で表す規則の延長）。0.5 秒刻み・端に吸着・隣に食い込まない・0.5 秒未満にしない。専用トラックは作らない（どのトラックにも置ける）
+8. **すき間から作る枠**（2026-09-21）: すき間をクリック →「あいだを生成」で、すき間の位置と長さの枠を置く。前のクリップの最後のコマ・次のクリップの最初のコマを抽出して両端（②③）に入れる。動画からの抽出は 1 コマを `assets/captures/` へ書き出す（§10）
+9. 枠は**生成前から尺と場所を持ち、生成物は同じ item に入る**（4 の延長）。メディアパネルは経由しない（タイムライン正本）
 
 ## 2. 9 スロット（生成入力の正規形）
 
@@ -66,9 +70,38 @@
 2. `status: generating` かつ `started_at` から `stale_after_s` 超 = **stale**。シェルは「応答なし・再取得」を出す。既定 900 秒
 3. 状態の遷移は undo に入れない。**差し替え（§7）だけ** edit-store の undo に 1 手として入る
 4. `history[]` は消さない。失敗も残す
-5. `kind: "still"` は `inputs.reference_images` に `--image=` の 1 枚（Codex）か複数枚（Nano Banana Pro）。`kind: "frames"` はパラパラ（別契約・§10）
+5. `kind: "still"` は `inputs.reference_images` に `--image=` の 1 枚（Codex）か複数枚（Nano Banana Pro）。`kind: "frames"` はパラパラ（別契約）
 6. `result.expanded_prompt` は provider が書き換えた prompt。較正では **送った prompt ではなく expanded を評価対象**に添える
 
+### 3-2. 動画予定の下書き `next`（2026-09-21）
+
+mp4 がまだ無い「動画予定」は、**仮枠の素材の meta**（静止画なら `<still>.meta.json`、空の枠なら文字カードの meta）の中に `next` ブロックで持つ。
+
+```json
+{
+  "version": 1, "kind": "still", "status": "done",          // 静止画自身の記録はそのまま
+  "…": "…",
+  "next": {
+    "kind": "video", "status": "planned",
+    "model": { "id": "fal:h3-i2v" },
+    "inputs": { "prompt": "…", "first_frame": { "path": "…", "sha256": "…" }, "last_frame": null,
+                "reference_images": [], "reference_videos": [], "reference_audios": [],
+                "camera": null, "seed": null, "extra": {}, "frames_or_refs": "frames" },
+    "output": { "duration_s": 5, "resolution": "768P", "aspect": null, "audio_out": null },
+    "updated_at": "…"
+  }
+}
+```
+
+1. **読み手の判定**: `next.kind === "video"` かつ `next.status === "planned"` = 「動画予定」。`next` が無い静止画 = 「画像のまま」= 完成品。文字カード（meta 自体が `planned`）で `next` が無いか prompt が空 = 「空の枠」
+2. `next.inputs` は §2 の 9 スロットの下書き。`first_frame` は**そのクリップの絵とは限らない**（前のクリップの最後のコマ・キャプチャ・空 = プロンプトだけ）
+3. **`inputs.frames_or_refs`** = `"frames"` / `"references"`（`next` の下書きだけが持つ欄。§2 ⑦ の `mode` = 元動画のモードとは別物）。最初 / 最後と参照が排他のとき（`frames_and_refs_exclusive: true` の行、または同じ family の i2v 行と ref 行の切替）、**下書きは両側を保持し、送るのは `frames_or_refs` の側だけ**。切り替えで中身を消さない。バリデータはこの欄を見て反対側を送信 body から外し、生成物 meta の `inputs` にはこの欄を書かない（送った側だけが残る）
+4. **送るとき**: CLI は `next`（または `--inputs`）を読み、従来どおり**生成物の隣**に video meta（`generating`）を書く。このとき **`placeholder: { path, sha256, item_id }`** = その item が今指している素材（静止画 / 文字カード）を必ず書く。item への逆引きは `placeholder` が正、`inputs.first_frame.path` は 9/13 時点の meta のための後方互換。`next` は消さない（「同じ入力でもう一度」の元）
+5. **状態の優先**: `placeholder` で結線された生成物 meta が `generating` / stale / `failed` ならそれを描く。無ければ `next` の `planned` を描く。`done` で差し替わった後は mp4 の meta が直接当たる（§7）
+6. `next` の更新は undo に入れない（§3 規則 3 と同じ）。右パネルの編集は即保存
+7. 移行: `.akari/generation/<itemId>.inputs.json` があり `next` が無いときだけ読み、次の保存で `next` へ移す。新規の書き込みはしない
+8. ビート表（`akari generate still --spec`）はビートごとに動画予定（最初だけ / 最初→最後）を指定でき、指定があれば CLI が `next` を書く。指定が無ければ「画像のまま」
+
 ## 4. 能力カタログ `gen-models.json`（公開リポ `packages/schemas/`）
 
 ### 4-1. 形（1 行 = 1 エンドポイント）
@@ -146,21 +179,26 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 
 | 状態 | タイムライン | プレビュー（編集中） | 書き出し |
 |---|---|---|---|
-| `planned`（文字カード） | 点線 + 「planned」 | 文字カード + 左上小札 | 文字カードのまま。lint WARN |
-| 静止画（meta なし or `done` の still） | 「静止画」バッジ | 静止画 + 左上小札「静止画（仮枠）」 | そのまま。小札なし |
-| `generating` | 黄の縞 + 進捗バー | 静止画の上にシマー + 下端の帯 | 静止画のまま |
+| 空の枠（文字カード・`next` なし or prompt 空） | 点線 + 「planned」 | 文字カード + 左上小札 | 文字カードのまま。lint WARN |
+| **動画予定**（`next` = video · planned。§3-2） | **紫の点線 + 上下のフィルムの穴 + 「▶ 動画予定」**。中身は 最初の絵 1 枚 ・ 生成で埋める空き ・ 最後の絵 1 枚（同じ絵を並べない）。プロンプトだけは文字。最後の絵 = 次のクリップの絵なら境目に 🔗 | 左上小札「▶ 動画予定 · <種類>」+ 最後の絵があれば右下の小窓 | 静止画 / 文字カードのまま。小札・小窓 0 px |
+| 静止画 = 画像のまま（`next` なし） | 「静止画」バッジ | 静止画。**小札なし**（完成品） | そのまま |
+| `generating` | 黄の縞 + 進捗バー | **参照の絵をぼかした背景** + シマー + 下端の帯。進捗は擬似でなく provider の状態 | 静止画のまま |
 | stale | 縞 + 「応答なし・再取得」 | 帯に「応答なし」 | 静止画のまま |
 | `done`（動画） | 通常 + コマ帯 + 「生成」由来バッジ | 動画。表示なし | 通常 |
-| `failed` | 朱枠 + 「失敗」 | 静止画 + 朱の小札 | 静止画のまま |
+| `failed` | 朱枠 + 「失敗」+ **「同じ入力でもう一度」** | 静止画 + 朱の小札 | 静止画のまま |
 
-- プレビューに付くのは**左上の小札と下端の帯だけ**。承認・比較の UI はプレビューに置かない
+- プレビューに付くのは**左上の小札・下端の帯・動画予定の右下の小窓・コマ保存のカメラボタン（§10）だけ**。承認・比較の UI はプレビューに置かない
+- 種類の表示は「プロンプトだけ / 画像から / 最初→最後 / 参照から」。枠を埋めたかで決まり、モード選択の UI は作らない
+- 失敗の「同じ入力でもう一度」はクリップと右パネルの両方に出す
 - **書き出し経路には小札・帯・点線が 0 px**。画素比較で担保（w3-b）
 
 ## 7. 差し替え規則（done になったとき）
 
 ### 7-1. 何を書き換えるか
 
-同じ item の `sources[].path` を mp4 に。item id・トラック・`at` は不変。静止画の path は `meta.inputs.first_frame` に残る（由来）。**1 手の undo**。
+同じ item の `sources[].path` を mp4 に。item id・トラック・`at` は不変。静止画の path は生成物 meta の `placeholder`（§3-2）に残る（由来。9/13 時点の meta は `inputs.first_frame`）。**1 手の undo**。
+
+**クリップ側の設定は保持する**（2026-09-21）。変形（拡大率・位置・不透明度・反転）と色（LUT・明るさ等）は item の上に重ねる設定であり、差し替えで入れ替わるのは**素材だけ**。逆に、**生成に送る絵は素材のまま**で、クリップの LUT・サイズは送らない（キャプチャを枠に入れた場合は §10-2）。
 
 ### 7-2. 実尺のずれ
 
@@ -178,7 +216,7 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 ## 8. 費用承認（有償生成のゲート）
 
 1. 語彙: 有償生成の承認は「**費用承認**」。「判子」は 9/6 契約どおり書き出しの 1 回にだけ使う
-2. 回数: 1 クリップずつが既定。複数を選んで**合計金額を出して 1 回**は可。「全部を自動で動画にする」は無い
+2. 回数: 1 クリップずつが既定。複数を選んで**合計金額を出して 1 回**は可。「全部を自動で動画にする」は無い。複数選択時の右パネル（対象一覧 + 合計見積 + まとめて費用承認 1 回）を正の UI とする。対象外（画像のまま・空の枠・生成済み）は送らない。見積は送信ボタンの横に常時出す
 3. 見積: `price.by_resolution × duration_s × audio_multiplier`、as_of 付き。`actual_usd` が取れない provider は `estimate` を写して `cost.source: "estimate"`。見積不可（price null）は明示確認で通す
 4. 停止条件は autonomy §4 と同じ（有償 or 外部送信）。Codex 画像生成は無償扱い
 
@@ -187,9 +225,18 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 | 語 | 意味 |
 |---|---|
 | 仮枠 | 尺と場所を持つ静止画クリップ。完成品でもある |
+| 動画予定 | 仮枠に動画生成の下書き（`next`）が付いた状態。mp4 はまだ無い |
+| 空の枠 | 絵も prompt もまだ無い仮枠（文字カード） |
+| 画像のまま | 動画にしない静止画クリップ。完成品 |
 | 参照動画 | 動きやカメラワークを**真似る元**。貼り込まれない |
 | 元動画 | **続ける・直す元**（extend / edit / motion / frame-edit） |
 | 費用承認 | 有償生成の実行前ゲート |
 | 判子 | 書き出しの 1 回（9/6） |
 | 事実帯 | モデル選択の 1 行（価格・尺・入力・音声・較正）。レーダーの代わり |
 
+## 10. コマ保存（キャプチャ）（2026-09-21）
+
+1. プレビューの**カメラのアイコンだけのボタン**（文字なし・絵文字にしない）= 今のコマを **見たまま（合成後・LUT とサイズ込み）** で `assets/captures/frame-<t>.png` に保存し、トーストを出す。素材パネルに出る
+2. キャプチャを生成の入力（②③④）に使うときは、**その png が素材**。LUT 込みで撮ったなら込みで送られる（§7-1 の「送る絵は素材のまま」と矛盾しない — 素材がそういう絵である）。UI は枠に入れるとき「見たままのコマ（色・サイズ込み）」と明示する
+3. 「あいだを生成」（§1-8）の前後コマ抽出は**素材の画素**（合成前）を使う。見たままが要るときは人がカメラボタンで撮る
+4. 書き出し経路にボタンは 0 px（§6）

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.72",
+  "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": [