akari-video 0.1.69 → 0.1.71

package/bin/akari.mjs

@@ -38,7 +38,7 @@ async function printVersion() {
 // `--help` は claude/opencode へそのまま転送されてしまっていた — AKARI Video 自身の
 // コマンド一覧が一度も出ない行き止まりだったため新設した）。
 async function printCliHelp() {
-  for (const line of [...describeCliHelp(), '  world                    ワールド地図を検査・生成・プレビュー']) {
+  for (const line of [...describeCliHelp(), '  world                    ワールド地図を検査・生成・プレビュー・停留所移動']) {
     console.log(line);
   }
   return { exitCode: 0 };

package/package.json

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

@@ -2,7 +2,7 @@ import { existsSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import path from 'node:path';
 
-import { resolveLauncherAssets } from './repo-assets.mjs';
+import { FINGER_FRAME_SCRIPT_RELATIVE, resolveLauncherAssets } from './repo-assets.mjs';
 
 const commands = [
   'beat-sync-beatmap',
@@ -31,12 +31,10 @@ export async function runInternalCommand(args, options = {}) {
     return { exitCode: 0 };
   }
 
-  // vision-finger-frame は task/2026-08-11-finger-frame-generator の境界規約により
-  // repo-assets.mjs（別タスク task/2026-08-11-eye-bar-generator と衝突しやすい共有ファイル）を
-  // 編集せず、他コマンドと違い assets.repoRoot から自己解決する（resolveRepoAssets() 側に
-  // フィールドを追加していない唯一の例外 -- 経緯は非公開の内部記録を参照）。
+  // vision-finger-frame は他コマンドと違い assets.repoRoot から自己解決するが、
+  // 相対パス自体は配布検査と共有する repo-assets.mjs の正本を使う。
   const fingerFrameScript = assets.repoRoot
-    ? path.join(assets.repoRoot, 'packages', 'akari-tools', 'bin', 'finger-frame.mjs')
+    ? path.join(assets.repoRoot, FINGER_FRAME_SCRIPT_RELATIVE)
     : null;
 
   const definitions = {

package/src/kits.mjs

@@ -1,13 +1,15 @@
 import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
 import {
   existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync,
-  renameSync, rmSync, symlinkSync, writeFileSync
+  readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync
 } from 'node:fs';
 import path from 'node:path';
 
 import { resolveLauncherAssets } from './repo-assets.mjs';
 
 const KITS_SCHEMA = 'akari-installed-kits/v0';
+const INSTALLED_ASSETS_SCHEMA = 'akari-installed-assets/v0';
 const PLUGIN_DESCRIPTION = 'AKARI Video 拡張キットのスキルをまとめて提供するローカルプラグイン。';
 
 function parseVersion(value) {
@@ -93,9 +95,47 @@ function replaceSymlink(source, destination, {
   }
 }
 
+function listAssetFiles(assetRoot, current = assetRoot) {
+  const files = [];
+  for (const entry of readdirSync(current, { withFileTypes: true })) {
+    const filePath = path.join(current, entry.name);
+    const stat = statSync(filePath);
+    if (stat.isDirectory()) {
+      files.push(...listAssetFiles(assetRoot, filePath));
+    } else if (stat.isFile()) {
+      const content = readFileSync(filePath);
+      files.push({
+        path: path.relative(assetRoot, filePath).split(path.sep).join('/'),
+        bytes: stat.size,
+        sha256: createHash('sha256').update(content).digest('hex')
+      });
+    }
+  }
+  return files.sort((left, right) => left.path.localeCompare(right.path));
+}
+
+function installedAssetItem(source, asset, manifest) {
+  const assetRoot = realpathSync(source);
+  let title = asset.id;
+  try {
+    const meta = JSON.parse(readFileSync(path.join(assetRoot, 'meta.json'), 'utf8'));
+    if (typeof meta.title === 'string' && meta.title) title = meta.title;
+  } catch {
+    // validate-asset が検査済み。配布環境で検査器が無い場合だけ id へフォールバックする。
+  }
+  return {
+    id: asset.id,
+    title,
+    path: ['assets', asset.category, asset.id].join('/'),
+    version: manifest.version,
+    files: listAssetFiles(assetRoot)
+  };
+}
+
 export function linkKitAssets(kitDir, manifest, home, options = {}) {
   const warnings = [];
   const linked = [];
+  const items = [];
   const assets = options.assets?.schemasSourceDir !== undefined
     ? options.assets
     : resolveLauncherAssets(options.assets);
@@ -113,9 +153,14 @@ export function linkKitAssets(kitDir, manifest, home, options = {}) {
       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, 'assets', asset.category, asset.id)
+      relativeTarget: path.join(
+        '..', '..', 'assets', 'store', manifest.id, kitSubdir,
+        'assets', asset.category, asset.id
+      )
     });
     if (result.status === 'occupied') {
       warnings.push(`既存の実ディレクトリを保持しました: ${destination}`);
@@ -123,9 +168,55 @@ export function linkKitAssets(kitDir, manifest, home, options = {}) {
       warnings.push(`symlink を作成できませんでした（Windows の権限を確認してください）: ${destination}`);
     } else {
       linked.push({ category: asset.category, id: asset.id });
+      items.push(installedAssetItem(source, asset, manifest));
     }
   }
-  return { linked, warnings };
+  return { linked, items, warnings };
+}
+
+function readInstalledAssetsIndex(home) {
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  if (!existsSync(indexPath)) return { schema: INSTALLED_ASSETS_SCHEMA, packs: {} };
+  const index = JSON.parse(readFileSync(indexPath, 'utf8'));
+  if (index?.schema !== INSTALLED_ASSETS_SCHEMA
+    || !index.packs || typeof index.packs !== 'object' || Array.isArray(index.packs)) {
+    throw new Error(`導入済み素材索引の形式が想定と違います: ${indexPath}`);
+  }
+  return index;
+}
+
+function writeInstalledAssetsIndex(home, index) {
+  const indexPath = path.join(home, 'assets', '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) {
+  const root = path.resolve(kitDir);
+  const storeRoot = path.join(path.resolve(home), 'assets', 'store', manifest.id);
+  if (root !== storeRoot && !root.startsWith(`${storeRoot}${path.sep}`)) {
+    throw new Error(`キット素材の root が展開先の外を指しています: ${root}`);
+  }
+  const index = readInstalledAssetsIndex(home);
+  index.packs[manifest.id] = {
+    version: manifest.version,
+    installedAt: new Date().toISOString(),
+    root,
+    items
+  };
+  writeInstalledAssetsIndex(home, index);
+  return items;
+}
+
+function unregisterKitAssets(home, productId) {
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  if (!existsSync(indexPath)) return;
+  const index = readInstalledAssetsIndex(home);
+  if (!Object.hasOwn(index.packs, productId)) return;
+  delete index.packs[productId];
+  writeInstalledAssetsIndex(home, index);
 }
 
 export function linkKitSkills(kitDir, manifest, home, options = {}) {
@@ -198,6 +289,7 @@ export function removeKit(home, productId) {
   const temporary = `${ledgerPath}.tmp-${process.pid}`;
   writeFileSync(temporary, `${JSON.stringify(ledger, null, 2)}\n`, { mode: 0o600 });
   renameSync(temporary, ledgerPath);
+  unregisterKitAssets(home, productId);
   return true;
 }
 

package/src/repo-assets.mjs

@@ -19,28 +19,59 @@ const SKILLS_MARKER = path.join('skills', 'analyze-footage', 'SKILL.md');
 // 雛形側の .gitignore 実体は project-scaffold の writeFallbackTemplate が補完する。
 const TEMPLATE_MARKER = path.join('templates', 'project-default', 'CLAUDE.md');
 const SCHEMAS_MARKER = path.join('packages', 'schemas', 'analysis.schema.json');
-const DOCTOR_SCRIPT_RELATIVE = path.join('skills', 'manage-connections', 'bin', 'doctor.mjs');
-const SCAFFOLD_MODULE_RELATIVE = path.join('packages', 'project-scaffold', 'src', 'index.mjs');
+export const DOCTOR_SCRIPT_RELATIVE = path.join('skills', 'manage-connections', 'bin', 'doctor.mjs');
+export const SCAFFOLD_MODULE_RELATIVE = path.join('packages', 'project-scaffold', 'src', 'index.mjs');
 // 作業場（creator-root）モジュール。① Wave（packages/creator-root）の成果物で、本パッケージ
 // からは読み取り専用（動的 import のみ）。scaffoldModulePath と同型の解決方式。
-const CREATOR_ROOT_MODULE_RELATIVE = path.join('packages', 'creator-root', 'src', 'index.mjs');
+export const CREATOR_ROOT_MODULE_RELATIVE = path.join('packages', 'creator-root', 'src', 'index.mjs');
 // 公式音源ライブラリ（AKARI Sounds）の一括取得スクリプト。初回動線（sounds-setup.mjs）と
 // `akari sounds` が子プロセスとして起動する。未同梱なら null（機能スキップ）。
-const AUDIO_FETCH_SCRIPT_RELATIVE = path.join('packages', 'audio-library-setup', 'bin', 'fetch-akari-sounds.mjs');
+export const AUDIO_FETCH_SCRIPT_RELATIVE = path.join('packages', 'audio-library-setup', 'bin', 'fetch-akari-sounds.mjs');
 // 素材 resolver（アカウントの素材 = 無料 + 購入済みの一覧・取得）の CLI 実体。
 // `akari assets <list|fetch|sync|...>`（assets-command.mjs）が子プロセスとして起動する。
 // 未同梱なら null（`akari assets` はその旨のエラーを返す。他コマンドは無影響）。
-const ASSET_RESOLVER_CLI_RELATIVE = path.join('packages', 'asset-resolver', 'bin', 'akari-assets.mjs');
-const BEATMAP_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'beatmap.mjs');
-const PROBE_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'probe-frame.mjs');
-const DECISION_LOG_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'decision-log.mjs');
-const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'captions.mjs');
+export const ASSET_RESOLVER_CLI_RELATIVE = path.join('packages', 'asset-resolver', 'bin', 'akari-assets.mjs');
+export const BEATMAP_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'beatmap.mjs');
+export const PROBE_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'probe-frame.mjs');
+export const DECISION_LOG_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'decision-log.mjs');
+export const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'captions.mjs');
 // capture-command.mjs のエラー文と apps/shell の同梱テストが同じ相対パスを名指しできるよう export する。
 export const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
-const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
-const EYE_BAR_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'eye-bar.mjs');
+export const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
+export const EYE_BAR_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'eye-bar.mjs');
+export const FINGER_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'finger-frame.mjs');
+export const MEDIA_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'media.mjs');
+export const WORD_BOOK_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'word-book.mjs');
 export const GENERATE_CLI_RELATIVE = path.join('packages', 'generate', 'src', 'cli', 'index.mjs');
 export const STORYBOARD_CLI_RELATIVE = path.join('packages', 'decision-cards', 'render-storyboard-print.mjs');
+export const WORLD_CLI_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'world.mjs');
+export const WORLD_VALIDATOR_RELATIVE = path.join('packages', 'schemas', 'bin', 'validate-world-map.mjs');
+
+// launcher が直接または起動した CLI の子プロセスとして解決する実行体の正本。
+// launcher-assets は resolveLauncherAssets() が資産フィールド単位で vendor を補完できる経路、
+// resources は assets.repoRoot または実行中 CLI の位置から自己解決し、vendor を見ない経路。
+// relative は上の解決定数だけから組み立て、配布検査と実行時解決の文字列を乖離させない。
+export const LAUNCHER_SUBCOMMAND_EXECUTABLES = [
+  { command: '接続 doctor（manage-connections）', relative: DOCTOR_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari new', relative: SCAFFOLD_MODULE_RELATIVE, resolution: 'launcher-assets' },
+  { command: '初回動線（first-run）の作業場モジュール', relative: CREATOR_ROOT_MODULE_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari sounds', relative: AUDIO_FETCH_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari assets', relative: ASSET_RESOLVER_CLI_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari internal beat-sync-beatmap', relative: BEATMAP_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari internal beat-sync-probe-frame', relative: PROBE_FRAME_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari decision-log', relative: DECISION_LOG_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari captions', relative: CAPTIONS_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari capture', relative: CAPTURE_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari internal beat-sync-render-when-idle', relative: RENDER_WHEN_IDLE_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari internal eye-bar', relative: EYE_BAR_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari internal vision-finger-frame', relative: FINGER_FRAME_SCRIPT_RELATIVE, resolution: 'resources' },
+  { command: 'akari media', relative: MEDIA_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari word-book', relative: WORD_BOOK_SCRIPT_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari generate', relative: GENERATE_CLI_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari storyboard', relative: STORYBOARD_CLI_RELATIVE, resolution: 'launcher-assets' },
+  { command: 'akari world', relative: WORLD_CLI_RELATIVE, resolution: 'resources' },
+  { command: 'akari world check', relative: WORLD_VALIDATOR_RELATIVE, resolution: 'resources' }
+];
 
 /**
  * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装・creator-root
@@ -59,9 +90,9 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const probeFrameScript = path.join(repoRoot, PROBE_FRAME_SCRIPT_RELATIVE);
   const renderWhenIdleScript = path.join(repoRoot, RENDER_WHEN_IDLE_SCRIPT_RELATIVE);
   const eyeBarScript = path.join(repoRoot, EYE_BAR_SCRIPT_RELATIVE);
-  const mediaScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'media.mjs');
+  const mediaScript = path.join(repoRoot, MEDIA_SCRIPT_RELATIVE);
   const decisionLogScript = path.join(repoRoot, DECISION_LOG_SCRIPT_RELATIVE);
-  const wordBookScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'word-book.mjs');
+  const wordBookScript = path.join(repoRoot, WORD_BOOK_SCRIPT_RELATIVE);
   const generateScript = path.join(repoRoot, GENERATE_CLI_RELATIVE);
   const storyboardScript = path.join(repoRoot, STORYBOARD_CLI_RELATIVE);
 

package/src/store-command.mjs

@@ -28,6 +28,7 @@ import {
   linkKitSkills,
   readKitManifest,
   readKitsLedger,
+  registerKitAssets,
   removeKit,
   writeKitsLedger
 } from './kits.mjs';
@@ -540,6 +541,7 @@ export async function runStoreCommand(args, options = {}) {
           for (const blocker of skillLinks.blockers) log(`導入できません: ${blocker}`);
           return { exitCode: 1 };
         }
+        registerKitAssets(home, manifest, kitDir, assetLinks.items);
         writeKitsLedger(home, {
           id: manifest.id,
           version: manifest.version,

package/src/vendor-sources.mjs

@@ -0,0 +1,47 @@
+// prepack の vendor コピー、配布同梱ゲート、GPL 再配布ゲートが、vendor/ へ入る
+// リポジトリ相対パスを同じ prefix 規則で判定するための共有正本。prepack.mjs は
+// import 時にコピーを始める副作用モジュールなので、安全に共有できるデータだけを分離した。
+// GPL 再配布ゲートは import せずテキストとして配列リテラルを読む。この宣言を
+// `export const` + `VENDOR_SOURCES = [` の形とベタ書き文字列のまま保つこと。変数展開・spread・
+// 他ファイルからの合成を入れると、安全に検査できないためゲートが fail-closed で落ちる。
+export const VENDOR_SOURCES = [
+  'skills',
+  'templates/project-default',
+  'presets/luts',
+  // edit-lint は外部 npm 依存ゼロだが、src から edit-store のビルド済み実装と
+  // textanim preset を参照する。既に同梱済みの schemas / audio-library-setup /
+  // media-bin と合わせ、CLI の実行時閉包を明示的に揃える。
+  'presets/textanim',
+  'assets/font/noto-sans-jp/NotoSansJP-Variable.ttf',
+  'packages/schemas',
+  'packages/project-scaffold',
+  // analysis-report は package.json / README.md を capability source として既に収集する。
+  // 実行に必要な CLI と同居必須テンプレートだけを追加し、test/ は配布しない。
+  'packages/analysis-report/render-analysis-report.mjs',
+  'packages/analysis-report/template.html',
+  // decision-log-report も package.json / README.md は capability source として収集する。
+  // 実行に必要な CLI と同居必須テンプレートだけを追加し、test/ は配布しない。
+  'packages/decision-log-report/render-decision-log-report.mjs',
+  'packages/decision-log-report/template.html',
+  'packages/edit-lint/bin',
+  'packages/edit-lint/src',
+  'packages/edit-store/lib',
+  // 作業場（creator-root）モジュール。npm 配布時も初回動線（first-run.mjs 経由の
+  // 動的 import）が機能するよう同梱する。未同梱の場合は repo-assets.mjs 側で
+  // creatorRootModulePath が null になり、現行動作へフォールバックする。
+  'packages/creator-root',
+  // 公式音源ライブラリ（AKARI Sounds）の一括取得（sounds-setup.mjs / `akari sounds`）。
+  // media-bin は fetch スクリプトの preview.png 生成（waveform-preview.mjs）が ffmpeg 解決に
+  // 使う。未同梱なら audioFetchScriptPath が null になり、音源セットアップだけスキップされる。
+  'packages/audio-library-setup',
+  'packages/media-bin',
+  // 素材 resolver（`akari assets` — アカウントの素材 = 無料 + 購入済みの一覧・取得）。
+  // 未同梱なら assetResolverCliPath が null になり、`akari assets` だけスキップされる
+  // （タスク契約 2026-08-09-agent-assets-discovery）。
+  'packages/asset-resolver',
+  // 履歴に何を入れるかの宣言（history-policy.mjs）。project-scaffold が相対パスで参照するため、
+  // vendor ミラーにもモノレポと同じ深さで置く（`vendor/packages/akari-launcher/src/` →
+  // `vendor/packages/project-scaffold/src/` から `../../akari-launcher/src/` で解決できる）。
+  // 本体の src/ にも同じファイルが入るが、配布物の中で相対パスを 1 本に保つ方を採る。
+  'packages/akari-launcher/src/history-policy.mjs'
+];

package/src/world-command.mjs

@@ -2,12 +2,12 @@ import { existsSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import path from 'node:path';
 
-import { resolveLauncherAssets } from './repo-assets.mjs';
+import { resolveLauncherAssets, WORLD_CLI_RELATIVE } from './repo-assets.mjs';
 
 export async function runWorldCommand(args, options = {}) {
   const logError = options.logError ?? ((line) => console.error(line));
   const assets = options.assets ?? resolveLauncherAssets();
-  const script = assets.repoRoot ? path.join(assets.repoRoot, 'packages', 'akari-tools', 'bin', 'world.mjs') : null;
+  const script = assets.repoRoot ? path.join(assets.repoRoot, WORLD_CLI_RELATIVE) : null;
   if (!script || !existsSync(script)) {
     logError('内部コマンド world の実行スクリプトが見つかりません。AKARI Video の完全な checkout または配布物を確認してください。');
     return { exitCode: 1 };

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

@@ -152,6 +152,9 @@
     "skills/declare-audio/launch.md",
     "skills/declare-audio/SKILL.md",
     "skills/declare-audio/what-to-declare.md",
+    "skills/design-world/guide.md",
+    "skills/design-world/SKILL.md",
+    "skills/design-world/world.md",
     "skills/edit-lint/preview.md",
     "skills/edit-lint/SKILL.md",
     "skills/edit-plan/approvals-and-generation.md",

package/vendor/docs/contract-2026-09-13-extension-kit-v0.md

@@ -51,6 +51,7 @@
 
 1. manifest と `requires` を検査する。CLI または runtime の不足は fail-closed、依存商品の不足は警告と導入案内にする。
 2. `assets[]` を `~/.akari/assets/<category>/<id>` へ相対 symlink で公開する。各素材はリンク前に `validate-asset.mjs` で検査する。
+   素材の実体ファイルと checksum は `~/.akari/assets/installed.json` にも登録し、素材 id から解決できるようにする。
 3. `skills[]` を `~/.akari/kits/plugin/skills/<name>` へ相対 symlink で公開する。
 4. `~/.akari/kits/installed.json` に id、version、導入日時、展開先、スキル、素材を記録する。
 5. `templates[]` は移動せず、CLI が各展開先の manifest を列挙して読む。
@@ -72,7 +73,7 @@ Codex、Cursor、opencode では、プロジェクトの `.agents/.codex/.cursor
 
 ## 5. アプリ（ホームの拡張キットカード）
 
-ホームの AKARI Store カードの隣に拡張キットカードを 1 枚出し、未接続では出さず、導入済みは id・version・スキル名・素材数の一覧と未有効化時の有効化案内、購入済み・未導入は `akari store install <id>` の案内、未購入は教材の引換ページの案内、という 3 状態とする（アプリはコマンドを実行せず、コピーと外部ブラウザ起動だけを行う）。
+ホームの AKARI Store カードの隣に拡張キットカードを 1 枚出し、未接続では出さず、導入済みは id・version・スキル名・素材数の一覧と未有効化時の有効化案内、購入済み・未導入は `akari store install <id>` の案内、未購入は Lab の商品ページの案内（Lifetime パス対象）、という 3 状態とする（アプリはコマンドを実行せず、コピーと外部ブラウザ起動だけを行う）。
 
 ## 6. 更新と版
 

package/vendor/docs/contract-2026-09-13-world-map-v0.md

@@ -26,27 +26,47 @@
 
 flat world は 1 個の overlay 断片で構成する。Canvas 層は背景、格子、遠景、portal、cut の覆いを描き、DOM sheet 層は素材と文字を持つ。各 world は直下の `.akari-world-sheet[data-world]`、zone はその子の `.akari-world-zone[data-zone]` とし、sheet 自身は left / top 0、zone の px は bounds 原点を引かない world 座標そのままとする。sheet の transform は authoring 時に固定せず、ランタイムが `camera(t)` から設定する。DOM と Canvas の混在出力は rasterize 経路を使う。
 
-spatial world は three 断片で構成し、座標・床・背景・霧を宣言する。画面座標の 3D 小物は別 overlay item とする。
+spatial world は `akari world build` が `assets/world/world.glb` と `overlays/world.html` の
+three 断片へ決定論的に焼く。GLB は `worlds[].spatial.floor`、`background`、`haze`、
+`zones[].c` の目印と、`camera(t)` を 60 Hz でサンプルした `TourCamera` / `Tour` clip を持つ。
+three 宣言は `model`、`camera.fromModel: "TourCamera"`、`animationClip: "Tour"` に加え、
+先頭 world の `palette.haze` / `palette.background` がある場合だけ `fog` / `background` を持つ。
+画面座標の 3D 小物とテロップは別 overlay item とする。
 
 ## 4. CLI
 
 - `akari world check [--strict] [--migrate] [--json]`: スキーマと不変条件を検査し、必要なら v2 を v3 へ正規化する。
-- `akari world build`: flat world の宣言、sheet、zone、解決済み素材断片を `overlays/world.html` に生成し、edit.json の `world` item を id 安定で upsert する。
-- `akari world preview [--measure]`: stop と edge の代表時点を PNG と `camera-proof.json` にする。measure 時は非 move edge の完全被覆区間を 30 Hz で測り、該当する `transition.cover` だけを書き戻す。
+- `check --migrate` はラベル文字列または `null` の `cover` と v3 語彙外の `pattern` を落として有限の暫定値へ正規化し、元の値と実測が必要な旨を注記に残す。
+- `akari world build`: flat は宣言、sheet、zone、解決済み素材断片を `overlays/world.html` に生成する。spatial は世界 GLB と three 断片を生成する。どちらも edit.json の `world` item を id 安定で upsert する。edit.json が version 2 でなければ変更せず停止するため、先に `akari migrate <project-root>` を実行する。
+- `akari world preview [--measure]`: flat / spatial とも rasterize 経路で stop と edge の代表時点を PNG と `camera-proof.json` にする。measure 時は非 move edge の全画素 RGB 標準偏差が 2 以下になる完全被覆区間を 30 Hz で測り、該当する `transition.cover` だけを書き戻す。
+- `preview --measure` は入口では C7 を問わず、実測値を書き戻した後に C7 を含む全項目を検査する。
 - `akari world overview`: 外部通信を行わず `file://` で開ける自己完結の俯瞰 HTML を生成する。
+- `akari world move-stop <project-root> --stop <id> --c x,y[,scale] [--json]`: flat の停留所座標だけを更新する。元テキストの整形と他の欄を変えず、bounds 外・spatial・不変条件違反では一切書き込まない。
 
 同じ入力から得る HTML と画像は決定論的でなければならない。素材 id は asset resolver で解決し、未解決時は失敗として扱う。
 
+実行順は flat / spatial 共通で、プロジェクトルートに対して次のようにする。
+
+```sh
+akari world check . --migrate
+akari world build .
+akari world preview .
+akari world preview . --measure
+akari world overview .
+```
+
 ## 5. 地図 UI
 
 - 実装のマーカー判定は `akari-shell-strip` の ContextKey `akari.worldMap` に一元化する。
 - main の「地図」タブは `akari-world-view` が担う。
 - タイムラインのワールド帯と地図インスペクターは `akari-annotations` が担う。
 
-地図 UI は world-map を読み取り専用で表示する。2D 俯瞰、ワールド帯、再生時刻に追従する撮影枠、選択中の stop / edge 詳細を提供し、データの編集機能は持たない。
+地図 UI は 2D 俯瞰、ワールド帯、再生時刻に追従する撮影枠、選択中の stop / edge 詳細を提供する。v1 では flat の停留所の座標だけを ⌥ ドラッグで `world-map.json` へ書き戻せる。書き手は `akari world move-stop` の 1 本に限定し、bounds 外・spatial・不変条件違反では書き込まない。`world-map.json` は edit.json の履歴の外にあるため、undo / redo は未対応とする。
 
 ## 6. 制作フロー
 
+作り方（ブリーフ → テンプレート → 台本 → `world-map.json` → `akari world`）は無料の純正スキル `akari:design-world`（`skills/design-world/SKILL.md`）が持つ。
+
 企画と絵コンテで章を world として宣言し、モーション区間は `world-map.json` → `akari world build` → overlay → 書き出しの順に処理する。実写区間との接点は portal とカットアウェイ章に限定する。
 
 ## 7. 将来拡張

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

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

@@ -24,14 +24,21 @@ export function scanLocalLibrary(home) {
   if (!existsSync(assetsDir)) return installed;
 
   for (const categoryEntry of readdirSync(assetsDir, { withFileTypes: true })) {
-    if (!categoryEntry.isDirectory()) continue;
     const categoryDir = path.join(assetsDir, categoryEntry.name);
-    for (const idEntry of readdirSync(categoryDir, { withFileTypes: true })) {
-      if (!idEntry.isDirectory()) continue;
-      const dir = path.join(categoryDir, idEntry.name);
-      if (readdirSync(dir).length > 0) {
-        installed.add(`${categoryEntry.name}/${idEntry.name}`);
+    try {
+      if (!statSync(categoryDir).isDirectory()) continue;
+      for (const idEntry of readdirSync(categoryDir, { withFileTypes: true })) {
+        const dir = path.join(categoryDir, idEntry.name);
+        try {
+          if (statSync(dir).isDirectory() && readdirSync(dir).length > 0) {
+            installed.add(`${categoryEntry.name}/${idEntry.name}`);
+          }
+        } catch {
+          // 壊れた symlink や読めない素材は取得済みとして数えない。
+        }
       }
+    } catch {
+      // ファイルや壊れた category symlink は対象外。
     }
   }
   return installed;

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

@@ -11,7 +11,7 @@
 // checksums.txt 検証（paid-zip.mjs）→ 同じ validate-asset / 原子的 move の経路に合流する。
 
 import { spawnSync } from 'node:child_process';
-import { constants, existsSync } from 'node:fs';
+import { constants, existsSync, realpathSync } from 'node:fs';
 import { cp, mkdir, mkdtemp, rename, rm } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -38,6 +38,7 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
   // 素材箱側が「meta.json を含むディレクトリ = 1 カード」でグルーピングする際、
   // 深さではなくディレクトリ形で判定するため、置き場の形をライブラリと合わせておく必要はないが、
   // カテゴリ別に整理された配置の方が人間が見ても分かりやすいのでライブラリ型に統一する。
+  const realSourceDir = realpathSync(sourceDir);
   const dest = path.join(path.resolve(projectDir), 'assets', category, id);
   await mkdir(path.dirname(dest), { recursive: true });
   await rm(dest, { recursive: true, force: true });
@@ -46,7 +47,7 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
     // このマシンの Node（libuv）は clonefileat 相当が ENOSYS を返し、fs.cp の
     // COPYFILE_FICLONE では節約が効かない（前段 2026-08-09-project-copy-cow-clone で実測確認済み）。
     // BSD cp -c は clonefile(2) を Node を介さず直接使うため、同じ OS/FS 上で実際にクローンできる。
-    const clone = spawnSync('/bin/cp', ['-Rc', sourceDir, dest], { stdio: 'ignore' });
+    const clone = spawnSync('/bin/cp', ['-Rc', realSourceDir, dest], { stdio: 'ignore' });
     if (!clone.error && clone.status === 0) {
       return dest;
     }
@@ -57,7 +58,7 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
 
   // COPYFILE_FICLONE（_FORCE ではない）: 対応 FS（APFS 等）では CoW クローンで実体化コピーを
   // 省略し、非対応環境では黙って通常コピーへフォールバックする（失敗しない）。
-  await cp(sourceDir, dest, { recursive: true, mode: constants.COPYFILE_FICLONE });
+  await cp(realSourceDir, dest, { recursive: true, mode: constants.COPYFILE_FICLONE });
   return dest;
 }
 

package/vendor/packages/asset-resolver/test/resolve-kit-symlink.test.mjs

@@ -0,0 +1,69 @@
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import {
+  lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync
+} from 'node:fs';
+import path from 'node:path';
+import test from 'node:test';
+import { isAssetCached, scanLocalLibrary } from '../src/library.mjs';
+import { resolve as resolveAsset } from '../src/resolve.mjs';
+import { setupFixtureEnv } from './helpers.mjs';
+
+function sha256(value) {
+  return createHash('sha256').update(value).digest('hex');
+}
+
+test('キット素材の symlink 越し fetch はプロジェクトへ実体をコピーする', async () => {
+  const { env, home, root } = setupFixtureEnv();
+  try {
+    const id = 'sample-kit-frame';
+    const category = 'overlay';
+    const packRoot = path.join(home, 'assets', 'store', 'sample-kit');
+    const assetRoot = path.join(packRoot, 'assets', category, id);
+    const fragment = '<div>sample kit frame</div>\n';
+    mkdirSync(assetRoot, { recursive: true });
+    writeFileSync(path.join(assetRoot, 'fragment.html'), fragment);
+    mkdirSync(path.join(home, 'assets', category), { recursive: true });
+    symlinkSync(path.relative(path.join(home, 'assets', category), assetRoot), path.join(home, 'assets', category, id), 'dir');
+    writeFileSync(path.join(home, 'assets', 'installed.json'), `${JSON.stringify({
+      schema: 'akari-installed-assets/v0',
+      packs: {
+        'sample-kit': {
+          version: 1,
+          installedAt: '2026-09-14T00:00:00.000Z',
+          root: packRoot,
+          items: [{
+            id,
+            title: 'Sample Kit Frame',
+            path: `assets/${category}/${id}`,
+            version: 1,
+            files: [{ path: 'fragment.html', bytes: Buffer.byteLength(fragment), sha256: sha256(fragment) }]
+          }]
+        }
+      }
+    }, null, 2)}\n`);
+
+    assert.equal(isAssetCached(home, category, id), true);
+    assert.equal(scanLocalLibrary(home).has(`${category}/${id}`), true);
+    const project = path.join(root, 'project');
+    const result = await resolveAsset(id, { env, project });
+    assert.equal(result.cached, true);
+    assert.equal(lstatSync(result.projectDir).isSymbolicLink(), false);
+    assert.equal(readFileSync(path.join(result.projectDir, 'fragment.html'), 'utf8'), fragment);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test('壊れた素材 symlink は cached 扱いにもローカル一覧にも入れない', () => {
+  const { home, root } = setupFixtureEnv();
+  try {
+    const categoryDir = path.join(home, 'assets', 'overlay');
+    mkdirSync(categoryDir, { recursive: true });
+    symlinkSync('../../store/missing/assets/overlay/broken-frame', path.join(categoryDir, 'broken-frame'), 'dir');
+    assert.equal(isAssetCached(home, 'overlay', 'broken-frame'), false);
+    assert.equal(scanLocalLibrary(home).has('overlay/broken-frame'), false);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});

package/vendor/packages/schemas/examples/kit-manifest-v1-with-asset/LICENSE.md

@@ -0,0 +1,3 @@
+# Fixture license
+
+This fictional fixture represents `LicenseRef-AKARI-Assets-v0` metadata.

package/vendor/packages/schemas/examples/kit-manifest-v1-with-asset/README.md

@@ -0,0 +1,3 @@
+# Fictional sample kit with an asset
+
+This directory is a validation fixture and is not a distributed product.

package/vendor/packages/schemas/examples/kit-manifest-v1-with-asset/assets/overlay/sample-kit-frame/fragment.html

@@ -0,0 +1,10 @@
+<div class="sample-kit-frame" aria-hidden="true"></div>
+
+<style>
+  .sample-kit-frame {
+    position: absolute;
+    inset: 8%;
+    border: 12px solid #ffb000;
+    border-radius: 24px;
+  }
+</style>