akari-video 0.1.70 → 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.70",
+  "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/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/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/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.70",
+  "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>

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

@@ -0,0 +1,24 @@
+{
+  "id": "sample-kit-frame",
+  "category": "overlay",
+  "title": "架空キットのフレーム",
+  "description": "キット同梱素材の登録と解決を検証する最小フレーム。",
+  "when_to_use": "拡張キットの素材導入テスト",
+  "tags": ["fixture", "frame"],
+  "knobs": [],
+  "ai_usage": "検証 fixture のため制作物には使用しない。",
+  "requires": [],
+  "provenance": {
+    "origin": "AKARI Video test fixture",
+    "generator": "hand-authored"
+  },
+  "author": "AKARI Labs",
+  "license": {
+    "spdx": "LicenseRef-AKARI-Assets-v0",
+    "scope": "test-only",
+    "attribution_required": false,
+    "ai_training_allowed": false
+  },
+  "price": null,
+  "version": 1
+}

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

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "id": "sample-kit",
+  "kind": "kit",
+  "name": "素材入り架空キット",
+  "version": 1,
+  "requires": {
+    "cli": ">=0.1.70",
+    "runtimes": ["three"],
+    "products": []
+  },
+  "skills": [
+    { "dir": "skills/sample-kit-skill", "name": "sample-kit-skill" }
+  ],
+  "templates": [],
+  "assets": [
+    { "category": "overlay", "id": "sample-kit-frame" }
+  ],
+  "docs": [],
+  "license": "LicenseRef-AKARI-Assets-v0",
+  "provenance": {
+    "author": "AKARI Labs",
+    "source": "example:sample-kit-with-asset"
+  }
+}

package/vendor/packages/schemas/examples/kit-manifest-v1-with-asset/skills/sample-kit-skill/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: sample-kit-skill
+description: Fictional skill used only by the kit manifest fixture.
+---
+
+# Sample kit skill
+
+Fixture content only.

package/vendor/skills/design-world/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: design-world
+description: 「ワールドを作って」「地図で見せる動画」「紙からブラウザの中へ入っていく映像」など、複数の世界と停留所を連続カメラで結ぶ flat ワールドを設計・検査・組み立てるときに使う。
+---
+
+# Design World
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+## ハードルール
+
+- ワールド操作は `akari world check|build|preview|overview` のサブコマンドだけで行う。リポジトリ内の実装ファイルを直接呼ばない。
+- 正本は `planning/world-map.json`。生成物だけを既存の visual track に置き、`edit.json` の語彙を増やさない。
+- `planning/world-map.json` は `expand-template.mjs` に作らせ、手でキーを足さない。world runtime は許可キー以外を拒否する。
+- v0 は `kind: flat` だけを対象にする。`spatial` は設計も build もしない。
+- 座標は台本とテンプレートの layout から決める。既存作品の座標を写さない。
+- 同じ world 内は `move`。世界をまたぐ既定は `portal`。`cut` を選ぶときは `transition.kind: mist` とする。
+- 世界をまたぐすべての辺に空でない `carry` を置き、その全要素を `retainedNodes` に含める。
+- 各 world には停留所を 2 件以上置く。zones と cameraStops の id は一致させる。
+- `edit.json` には**ベース映像**が要る（`sources` 1 件 + visual トラックにベースの item 1 件）。無いと `render-cut` が落ちる。ワールドの overlay だけでは書き出せない。
+
+## 最初に聞く 3 問
+
+1. 世界はいくつで、紙・ブラウザ・街・部屋など何の世界ですか。
+2. 各世界で見せたい停留所は何ですか。
+3. 世界をまたいで持ち越す物は何ですか。
+
+## 手順
+
+0. プロジェクトと 15 秒の無地ベースを用意する。手持ち映像を使う場合も `sources` と visual item の両方へ登録する。
+
+   ```sh
+   PROJECT=<project>
+   SKILL_DIR=<このスキルのディレクトリの絶対パス>
+   mkdir -p "$PROJECT/planning" "$PROJECT/sources"
+   ffmpeg -y -f lavfi -i "color=c=#101418:s=1920x1080:r=30:d=15" \
+     -pix_fmt yuv420p "$PROJECT/sources/base.mp4"
+   ```
+
+   `$PROJECT/edit.json` は次の v2 骨格にする。15 秒 × 30 fps なので `duration` は 450 フレーム。`akari world build` は id `world` の visual item を追加または更新する。ベース item と時間が重なるため、既存とは別の visual トラックに置かれる。
+
+   ```json
+   {
+     "version": 2,
+     "output": { "width": 1920, "height": 1080, "fps": 30 },
+     "sources": [{ "id": "base", "path": "sources/base.mp4" }],
+     "tracks": [
+       { "id": "v1", "lane": "visual", "items": [
+         { "id": "base", "at": 0, "duration": 450, "source": { "kind": "media", "src": "base", "in": 0, "out": 15 } }
+       ] }
+     ]
+   }
+   ```
+
+1. `$SKILL_DIR/templates/` から構成を選ぶ。紙から画面へ入るなら `paper-to-browser`、ブラウザから会話へ渡すなら `browser-to-chat`、歩いて室内へ着くなら `street-to-room`。
+2. 選んだ JSON の `sampleScript` を `$PROJECT/planning/script.json` に写す。停留所の `label`、`dwell`（秒）、`asset`、world ごとの上書き、`carry` をブリーフに合わせて変更する。総尺は `Σ dwell + Σ 辺の尺` で求める。辺の尺は `move` 0.75 秒、`portal` 1.2 秒、`cut` 0.8 秒。`script.worlds.<worldId>.label` で表示名、`.palette` で `background` / `dots` / `accent` / `haze` を上書きできる。world id と stop id は内部キーなので、表示名は `label` で言い換えてよい。各 world の stop 数と内部 id は変えない。
+3. 台本をスキル側へ置かず、次の形で展開する。
+
+   ```sh
+   PROJECT=<project>
+   SKILL_DIR=<このスキルのディレクトリの絶対パス>
+   node "$SKILL_DIR/bin/expand-template.mjs" \
+     "$SKILL_DIR/templates/paper-to-browser.json" \
+     "$PROJECT/planning/script.json" \
+     --out "$PROJECT/planning/world-map.json"
+   ```
+
+   expand は最初の build を可能にするため、portal に 0.18 秒、cut に 0.24 秒の**有限の暫定値**を `cover` として入れる。テンプレートの `edges[].cover` でも 0〜0.4 秒の範囲で上書きできるが、最終的には preview の実測値を正とする。
+4. `akari world check "$PROJECT"` を実行し、エラーが 0 件になるまで台本を直して再展開する。
+5. 素材は、世界観の束（例: Pop Motion ワールド対応版）が持つ **背景 / 飛び込み口 / モチーフ** の 3 層で考える。背景で world ごとの材質を作り、飛び込み口で portal の通過を読ませ、モチーフを各停留所へ置く。必要な素材は `akari assets fetch <id>` で取得でき、`akari world build` がプロジェクト内の素材を解決する。
+6. `planning/world-items.json` を作り、素材を zone に対応づける。`asset` は必ず `overlay/<id>` と書く。`offset`、`scale`、`vars` は任意。
+
+   ```json
+   {
+     "schemaVersion": 1,
+     "items": [
+       {
+         "id": "arrival-motif",
+         "zone": "paper-note",
+         "asset": "overlay/<使う素材の id>",
+         "offset": [-240, -180],
+         "scale": 0.85,
+         "vars": { "accent": "#4285f4" }
+       }
+     ]
+   }
+   ```
+
+   `asset` の `<使う素材の id>` は実際に使う素材の id に置き換え、`zone` は `planning/world-map.json` の zone id と一致させる。同じ zone の items は配列順に重なり、後ろの item が上に乗る。素材ごとに基準点と既定サイズが異なるため、`meta.json` / `fragment.html` を実測して `offset` を決める。詳しくは [world.md の「構図の目安」](world.md#構図の目安) を見る。
+7. `akari world build "$PROJECT"` を実行する。`overlays/world.html` と `edit.json` の world item が生成される。
+8. `akari world preview "$PROJECT" --measure` を実行して `planning/world-map.json` の cover を実測値へ置き換える。生成済みの `overlays/world.html` は暫定値のままなので、`akari world build "$PROJECT"` をもう一度実行し、`akari world check "$PROJECT" --strict` を通す。順番は **build → preview --measure → build → check --strict**。
+9. `akari world overview "$PROJECT"` を実行し、地図を人に見せる。停留所の順、世界境界、carry、portal/cut の位置が意図どおりか確認する。
+
+判断に迷ったら [world.md](world.md) の型を使う。概念と地図タブの読み方は [guide.md](guide.md) を見る。

package/vendor/skills/design-world/bin/expand-template.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+const usage = "使い方: node bin/expand-template.mjs <template.json> <script.json> --out planning/world-map.json";
+const args = process.argv.slice(2);
+const outIndex = args.indexOf("--out");
+if (args.length !== 4 || outIndex !== 2 || !args[3]) fail(usage);
+
+const templatePath = path.resolve(args[0]);
+const scriptPath = path.resolve(args[1]);
+const outPath = path.resolve(args[3]);
+
+try {
+  const template = JSON.parse(await readFile(templatePath, "utf8"));
+  const script = JSON.parse(await readFile(scriptPath, "utf8"));
+  const map = expand(template, script);
+  await mkdir(path.dirname(outPath), { recursive: true });
+  await writeFile(outPath, `${JSON.stringify(map, null, 2)}\n`, "utf8");
+  process.stdout.write(`${outPath}\n`);
+} catch (error) {
+  fail(error instanceof Error ? error.message : String(error));
+}
+
+export function expand(template, script) {
+  if (!record(template) || template.schemaVersion !== 1 || template.for !== "world-map") throw new Error("template は schemaVersion: 1 / for: world-map である必要があります");
+  if (!Array.isArray(template.worlds) || !Array.isArray(template.stops) || !Array.isArray(template.edges)) throw new Error("template に worlds / stops / edges が必要です");
+  if (!record(template.layout)) throw new Error("template.layout が必要です");
+  if (!record(script) || !Array.isArray(script.stops)) throw new Error("script.stops が必要です");
+  if (script.stops.length !== template.stops.length) throw new Error("script.stops は template.stops と同じ件数・順序にしてください");
+  if (template.edges.length !== Math.max(0, template.stops.length - 1)) throw new Error("template.edges は stops - 1 件必要です");
+
+  const layout = normalizeLayout(template.layout);
+  const worldIds = new Set();
+  for (const world of template.worlds) {
+    if (!string(world?.id) || worldIds.has(world.id)) throw new Error("template.worlds の id は空でない一意な文字列です");
+    worldIds.add(world.id);
+  }
+
+  const pairedStops = template.stops.map((stop, index) => {
+    const authored = script.stops[index];
+    if (!record(stop) || !record(authored) || authored.id !== stop.id) throw new Error(`script.stops[${index}].id は ${stop?.id} にしてください`);
+    if (!worldIds.has(stop.world)) throw new Error(`stop ${stop.id} が未定義の world を参照しています`);
+    if (!string(authored.label) || !positive(authored.dwell) || !string(authored.asset)) throw new Error(`script stop ${stop.id} には label / 正の dwell / asset が必要です`);
+    const scale = stop.scale ?? 1.1;
+    if (!finite(scale) || scale < 1 || scale > 1.3) throw new Error(`stop ${stop.id} の scale は 1.0〜1.3 です`);
+    return { skeleton: stop, authored, scale };
+  });
+
+  const stopsByWorld = new Map(template.worlds.map((world) => [world.id, []]));
+  for (const pair of pairedStops) stopsByWorld.get(pair.skeleton.world).push(pair);
+  for (const [worldId, stops] of stopsByWorld) if (stops.length < 2) throw new Error(`world ${worldId} には stop が 2 件以上必要です`);
+
+  let worldX = layout.origin[0];
+  const boundsByWorld = new Map();
+  const worlds = template.worlds.map((world) => {
+    const count = stopsByWorld.get(world.id).length;
+    const width = Math.max(layout.worldWidth, layout.padding * 2 + layout.stopSpacing * (count - 1));
+    const bounds = [worldX, layout.origin[1], width, layout.worldHeight];
+    boundsByWorld.set(world.id, bounds);
+    worldX += width + layout.worldGap;
+    const override = record(script.worlds?.[world.id]) ? script.worlds[world.id] : {};
+    const palette = { ...world.palette, ...(record(override.palette) ? override.palette : {}) };
+    validatePalette(palette, world.id);
+    return {
+      id: world.id,
+      label: string(override.label) ? override.label : world.label,
+      palette,
+      flat: { bounds, pattern: world.pattern }
+    };
+  });
+
+  const zoneCoordinates = new Map();
+  for (const world of template.worlds) {
+    const bounds = boundsByWorld.get(world.id);
+    stopsByWorld.get(world.id).forEach((pair, index) => {
+      const x = bounds[0] + layout.padding + layout.stopSpacing * index;
+      const y = bounds[1] + bounds[3] / 2 + (index % 2 === 0 ? -layout.stopOffsetY : layout.stopOffsetY);
+      zoneCoordinates.set(pair.skeleton.id, [x, y]);
+    });
+  }
+
+  const zones = pairedStops.map(({ skeleton, authored }) => ({
+    id: skeleton.id,
+    label: authored.label,
+    world: skeleton.world,
+    c: zoneCoordinates.get(skeleton.id)
+  }));
+
+  let clockMs = 0;
+  const cameraStops = pairedStops.map(({ skeleton, authored, scale }, index) => {
+    const at = clockMs;
+    const leave = at + milliseconds(authored.dwell, `stop ${skeleton.id} dwell`);
+    clockMs = leave;
+    if (index < template.edges.length) clockMs += edgeDuration(template.edges[index].type);
+    const [x, y] = zoneCoordinates.get(skeleton.id);
+    return { id: skeleton.id, world: skeleton.world, at: seconds(at), leave: seconds(leave), c: [x, y, scale] };
+  });
+
+  const carry = uniqueStrings(script.carry);
+  const edges = template.edges.map((edge, index) => {
+    const from = cameraStops[index];
+    const to = cameraStops[index + 1];
+    if (!record(edge) || !["move", "portal", "cut"].includes(edge.type)) throw new Error(`template.edges[${index}].type が未定義です`);
+    const crossesWorld = from.world !== to.world;
+    if (!crossesWorld && edge.type !== "move") throw new Error(`同じ world の edge ${index} は move にしてください`);
+    if (crossesWorld && edge.type === "move") throw new Error(`世界をまたぐ edge ${index} は portal または cut にしてください`);
+    if (crossesWorld && carry.length === 0) throw new Error("世界をまたぐ辺には script.carry が 1 件以上必要です");
+    // build / preview の宣言は有限の cover を要求する。ここでは build 可能な暫定値を置き、
+    // preview --measure の実測値で置き換える。
+    const cover = transitionCover(edge, index);
+    const result = {
+      id: `${from.id}-to-${to.id}`,
+      from: from.id,
+      to: to.id,
+      type: edge.type,
+      t0: from.leave,
+      t1: to.at,
+      transition: edge.type === "move" ? { kind: "none", cover } : { kind: edge.type === "cut" ? "mist" : "dive", cover }
+    };
+    if (edge.type !== "move") {
+      if (!string(edge.via)) throw new Error(`edge ${index} の via が必要です`);
+      result.via = edge.via;
+      result.switchTime = seconds(Math.round((milliseconds(from.leave) + milliseconds(to.at)) / 2));
+    }
+    if (crossesWorld) result.carry = carry;
+    return result;
+  });
+
+  return {
+    schemaVersion: 3,
+    kind: "flat",
+    worlds,
+    zones,
+    cameraStops,
+    edges,
+    retainedNodes: carry,
+    inventory: pairedStops.map(({ skeleton, authored }) => ({ id: `${skeleton.id}-asset`, zone: skeleton.id, asset: `overlay/${authored.asset}` }))
+  };
+}
+
+function normalizeLayout(value) {
+  const result = {
+    origin: value.origin,
+    worldWidth: value.worldWidth,
+    worldHeight: value.worldHeight,
+    worldGap: value.worldGap,
+    stopSpacing: value.stopSpacing,
+    padding: value.padding,
+    stopOffsetY: value.stopOffsetY ?? 48
+  };
+  if (!Array.isArray(result.origin) || result.origin.length !== 2 || !result.origin.every(finite)) throw new Error("layout.origin は数値 2 要素です");
+  for (const key of ["worldWidth", "worldHeight", "worldGap", "stopSpacing", "padding"]) if (!positive(result[key])) throw new Error(`layout.${key} は正の数です`);
+  if (!finite(result.stopOffsetY) || result.stopOffsetY < 0) throw new Error("layout.stopOffsetY は 0 以上です");
+  return result;
+}
+
+function validatePalette(palette, worldId) {
+  for (const key of ["background", "dots", "accent"]) if (!/^#[0-9a-fA-F]{6}$/.test(palette?.[key])) throw new Error(`world ${worldId} の palette.${key} は 6 桁 hex です`);
+  if (palette.haze !== undefined && !/^#[0-9a-fA-F]{6}$/.test(palette.haze)) throw new Error(`world ${worldId} の palette.haze は 6 桁 hex です`);
+}
+
+function edgeDuration(type) {
+  if (type === "move") return 750;
+  if (type === "portal") return 1200;
+  if (type === "cut") return 800;
+  throw new Error(`edge type が未定義です: ${type}`);
+}
+
+function transitionCover(edge, index) {
+  const fallback = edge.type === "move" ? 0 : edge.type === "portal" ? 0.18 : 0.24;
+  if (edge.cover === undefined) return fallback;
+  if (!finite(edge.cover) || edge.cover < 0 || edge.cover > 0.4) {
+    throw new Error(`template.edges[${index}].cover は 0 以上 0.4 以下の有限数です`);
+  }
+  if (edge.type === "move" && edge.cover !== 0) {
+    throw new Error(`template.edges[${index}].cover は move では 0 にしてください`);
+  }
+  return edge.cover;
+}
+
+function milliseconds(value, label = "time") {
+  if (!finite(value)) throw new Error(`${label} は有限数です`);
+  return Math.round(value * 1000 / 50) * 50;
+}
+
+function seconds(value) { return value / 1000; }
+function finite(value) { return typeof value === "number" && Number.isFinite(value); }
+function positive(value) { return finite(value) && value > 0; }
+function string(value) { return typeof value === "string" && value.length > 0; }
+function record(value) { return value !== null && typeof value === "object" && !Array.isArray(value); }
+function uniqueStrings(value) { return Array.isArray(value) ? [...new Set(value.filter(string))] : []; }
+
+function fail(message) {
+  process.stderr.write(`${message}\n`);
+  process.exit(2);
+}

package/vendor/skills/design-world/bin/test/expand-template.test.mjs

@@ -0,0 +1,152 @@
+import assert from "node:assert/strict";
+import { existsSync } from "node:fs";
+import { mkdtemp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import test from "node:test";
+
+const testDir = path.dirname(fileURLToPath(import.meta.url));
+const skillDir = path.resolve(testDir, "../..");
+const repoRoot = path.resolve(skillDir, "../..");
+const expandBin = path.join(skillDir, "bin", "expand-template.mjs");
+const akariBin = process.env.AKARI_BIN || path.join(repoRoot, "packages", "akari-launcher", "bin", "akari.mjs");
+const schemasBin = process.env.AKARI_SCHEMAS_BIN || path.join(repoRoot, "packages", "schemas", "bin", "validate-world-map.mjs");
+const templates = ["paper-to-browser", "browser-to-chat", "street-to-room"];
+const WORLD_RUNTIME_KEYS = {
+  worlds: new Set(["id", "label", "palette", "flat"]),
+  zones: new Set(["id", "label", "world", "c"]),
+  cameraStops: new Set(["id", "world", "at", "leave", "c"]),
+  edges: new Set(["id", "from", "to", "type", "t0", "t1", "switchTime", "transition", "via", "carry", "easing"]),
+  transition: new Set(["kind", "cover"])
+};
+
+for (const name of templates) {
+  test(`${name}: sampleScript を決定論的に展開して検査できる`, async (t) => {
+    const temporary = await mkdtemp(path.join(os.tmpdir(), "design-world-test-"));
+    t.after(() => rm(temporary, { recursive: true, force: true }));
+    const templatePath = path.join(skillDir, "templates", `${name}.json`);
+    const template = JSON.parse(await readFile(templatePath, "utf8"));
+    const scriptPath = path.join(temporary, "script.json");
+    await writeFile(scriptPath, `${JSON.stringify(template.sampleScript, null, 2)}\n`);
+
+    const firstProject = path.join(temporary, "first");
+    const secondProject = path.join(temporary, "second");
+    const firstOut = path.join(firstProject, "planning", "world-map.json");
+    const secondOut = path.join(secondProject, "planning", "world-map.json");
+    await mkdir(path.dirname(firstOut), { recursive: true });
+    await mkdir(path.dirname(secondOut), { recursive: true });
+    run(process.execPath, [expandBin, templatePath, scriptPath, "--out", firstOut]);
+    run(process.execPath, [expandBin, templatePath, scriptPath, "--out", secondOut]);
+
+    const [first, second] = await Promise.all([readFile(firstOut), readFile(secondOut)]);
+    assert.deepEqual(first, second, "同じ入力の world-map.json はバイト一致する");
+    const map = JSON.parse(first.toString("utf8"));
+    assert.equal(map.schemaVersion, 3);
+    assert.equal(map.kind, "flat");
+    assert.equal(map.edges.length, map.cameraStops.length - 1);
+    assert.deepEqual(new Set(map.zones.map((zone) => zone.id)), new Set(map.cameraStops.map((stop) => stop.id)));
+    for (const world of map.worlds) assert.ok(map.zones.filter((zone) => zone.world === world.id).length >= 2);
+    for (const world of map.worlds) assertAllowedKeys(world, WORLD_RUNTIME_KEYS.worlds, "world");
+    for (const zone of map.zones) assertAllowedKeys(zone, WORLD_RUNTIME_KEYS.zones, "zone");
+    for (const stop of map.cameraStops) assertAllowedKeys(stop, WORLD_RUNTIME_KEYS.cameraStops, "cameraStop");
+    const outputWidth = 1920;
+    const outputHeight = 1080;
+    for (const stop of map.cameraStops) {
+      const world = map.worlds.find((candidate) => candidate.id === stop.world);
+      assert.ok(world, `${stop.id}: world ${stop.world} が存在する`);
+      const [boundsLeft, boundsTop, boundsWidth, boundsHeight] = world.flat.bounds;
+      const boundsRight = boundsLeft + boundsWidth;
+      const boundsBottom = boundsTop + boundsHeight;
+      const [x, y, scale] = stop.c;
+      const frameLeft = x - (outputWidth / 2) / scale;
+      const frameRight = x + (outputWidth / 2) / scale;
+      const frameTop = y - (outputHeight / 2) / scale;
+      const frameBottom = y + (outputHeight / 2) / scale;
+      assert.ok(frameLeft >= boundsLeft, `${stop.id}: 撮影枠の左が bounds から ${(boundsLeft - frameLeft).toFixed(1)} world px はみ出す`);
+      assert.ok(frameRight <= boundsRight, `${stop.id}: 撮影枠の右が bounds から ${(frameRight - boundsRight).toFixed(1)} world px はみ出す`);
+      assert.ok(frameTop >= boundsTop, `${stop.id}: 撮影枠の上が bounds から ${(boundsTop - frameTop).toFixed(1)} world px はみ出す`);
+      assert.ok(frameBottom <= boundsBottom, `${stop.id}: 撮影枠の下が bounds から ${(frameBottom - boundsBottom).toFixed(1)} world px はみ出す`);
+    }
+    for (const edge of map.edges) {
+      assertAllowedKeys(edge, WORLD_RUNTIME_KEYS.edges, "edge");
+      assertAllowedKeys(edge.transition, WORLD_RUNTIME_KEYS.transition, "transition");
+      assert.ok(Number.isFinite(edge.transition.cover), "transition.cover は有限数");
+      assert.ok(edge.transition.cover >= 0 && edge.transition.cover <= 0.4, "transition.cover は 0〜0.4");
+      assert.equal(edge.transition.cover, edge.type === "move" ? 0 : edge.type === "portal" ? 0.18 : 0.24, `${edge.type} の暫定 cover`);
+    }
+
+    await t.test("validate-world-map", { skip: !existsSync(schemasBin) && "schema validator が見つからない配布形" }, () => {
+      run(schemasBin, [firstProject]);
+    });
+    await t.test("akari world check", { skip: !existsSync(akariBin) && "akari CLI が見つからない配布形" }, () => {
+      run(akariBin, ["world", "check", firstProject]);
+    });
+  });
+}
+
+test("template の cover 上書きを優先し、範囲外を拒否する", async (t) => {
+  const { temporary, original, templatePath, scriptPath, outPath } = await fixture(t);
+  assert.ok(temporary);
+  original.edges[1].cover = 0.31;
+  await writeFile(templatePath, `${JSON.stringify(original, null, 2)}\n`);
+  run(process.execPath, [expandBin, templatePath, scriptPath, "--out", outPath]);
+  const map = JSON.parse(await readFile(outPath, "utf8"));
+  assert.equal(map.edges[1].transition.cover, 0.31);
+
+  original.edges[1].cover = 0.41;
+  await writeFile(templatePath, `${JSON.stringify(original, null, 2)}\n`);
+  const failed = spawnSync(process.execPath, [expandBin, templatePath, scriptPath, "--out", outPath], { encoding: "utf8" });
+  assert.equal(failed.status, 2);
+  assert.match(failed.stderr, /0 以上 0\.4 以下の有限数/);
+});
+
+test("script.stops の件数不一致を exit 2 で拒否する", async (t) => {
+  const { original, templatePath, scriptPath, outPath } = await fixture(t);
+  original.sampleScript.stops.pop();
+  await writeFile(scriptPath, `${JSON.stringify(original.sampleScript, null, 2)}\n`);
+  const failed = spawnSync(process.execPath, [expandBin, templatePath, scriptPath, "--out", outPath], { encoding: "utf8" });
+  assert.equal(failed.status, 2);
+  assert.match(failed.stderr, /同じ件数・順序/);
+});
+
+test("move の 0 以外の cover を exit 2 で拒否する", async (t) => {
+  const { original, templatePath, scriptPath, outPath } = await fixture(t);
+  original.edges[0].cover = 0.1;
+  await writeFile(templatePath, `${JSON.stringify(original, null, 2)}\n`);
+  const failed = spawnSync(process.execPath, [expandBin, templatePath, scriptPath, "--out", outPath], { encoding: "utf8" });
+  assert.equal(failed.status, 2);
+  assert.match(failed.stderr, /move では 0/);
+});
+
+test("中立な via と asset id を出力へ保つ", async (t) => {
+  const { templatePath, scriptPath, outPath } = await fixture(t);
+  run(process.execPath, [expandBin, templatePath, scriptPath, "--out", outPath]);
+  const map = JSON.parse(await readFile(outPath, "utf8"));
+  assert.equal(map.edges.find((edge) => edge.type === "portal").via, "paper-portal");
+  assert.ok(map.inventory.every((item) => /^overlay\/(signpost|portal-frame)$/.test(item.asset)));
+});
+
+async function fixture(t) {
+  const temporary = await mkdtemp(path.join(os.tmpdir(), "design-world-fixture-"));
+  t.after(() => rm(temporary, { recursive: true, force: true }));
+  const templatePath = path.join(temporary, "template.json");
+  const scriptPath = path.join(temporary, "script.json");
+  const outPath = path.join(temporary, "planning", "world-map.json");
+  const original = JSON.parse(await readFile(path.join(skillDir, "templates", "paper-to-browser.json"), "utf8"));
+  await writeFile(templatePath, `${JSON.stringify(original, null, 2)}\n`);
+  await writeFile(scriptPath, `${JSON.stringify(original.sampleScript, null, 2)}\n`);
+  return { temporary, original, templatePath, scriptPath, outPath };
+}
+
+function run(command, args) {
+  const result = spawnSync(command, args, { encoding: "utf8" });
+  assert.equal(result.error, undefined, result.error?.message);
+  assert.equal(result.status, 0, `${command} ${args.join(" ")}\n${result.stdout}\n${result.stderr}`);
+}
+
+function assertAllowedKeys(value, allowed, label) {
+  const unknown = Object.keys(value).filter((key) => !allowed.has(key));
+  assert.deepEqual(unknown, [], `${label} に world-runtime の未知キーを出さない`);
+}

package/vendor/skills/design-world/bin/test/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "main": "expand-template.test.mjs"
+}

package/vendor/skills/design-world/guide.md

@@ -0,0 +1,17 @@
+# ワールド編 — ワールドを作って地図で見る
+
+ワールドは、動画の背景・停留所・移動を一枚の地図として先に決める方法です。正本は `planning/world-map.json`。同じデータから映像のカメラと overview の地図を作るため、映像を直したのに地図だけ古い、というずれを避けられます。v0 は平面の `flat` ワールドが対象です。
+
+一つの world は同じ材質と座標のまとまりです。各 world に「読ませる一枚」である停留所を 2 件以上置きます。背景や規則が変わる所で world を分け、同じ world 内はカメラ移動でつなぎます。
+
+素材は、世界観の束（例: Pop Motion ワールド対応版）が持つ **背景 / 飛び込み口 / モチーフ** の 3 層として選びます。背景は世界の材質、飛び込み口は境界を越える理由、モチーフは停留所で読む内容を担います。
+
+## 辺の 3 型
+
+`move` は同じ世界の連続移動です。`portal` は窓、扉、紙の穴などを通って別世界へ入り、世界境界の既定にします。`cut` は時間を縮めて別世界へ飛ぶ手段で、必ず霧が覆う間に切り替えます。世界をまたぐ辺には、主人公やカードなど前後に残す物を `carry` として宣言します。
+
+`cover` は画面が世界の切り替えを隠した時間です。expand は最初の build を通すため、portal に 0.18 秒、cut に 0.24 秒の有限な暫定値を入れます。`build` → `preview --measure` で実測した後、その値を反映するためもう一度 `build` し、`check --strict` を通します。実測値が正で、許される範囲は 0〜0.4 秒です。move は常に `cover: 0` とします。
+
+## 地図タブの見る所
+
+地図では world の面、停留所の順番、辺の種類、camera stop の時刻を読みます。最初に、各 world に入口と出口があるかを見ます。次に、同じ world 内が move、世界境界が portal または mist の cut かを見ます。最後に carry が境界の前後で必要な物だけになっているかを確かめます。地図は読み取り専用で、修正は台本または `planning/world-map.json` に戻して行います。

package/vendor/skills/design-world/templates/browser-to-chat.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "id": "browser-to-chat",
+  "for": "world-map",
+  "summary": "ブラウザから portal で中間世界へ入り、霧の cut でチャットへ渡す構成。\n製品ページ、処理の舞台、会話の結果を三段で見せる動画向け。",
+  "layout": { "origin": [0, 0], "worldWidth": 3300, "worldHeight": 1700, "worldGap": 500, "stopSpacing": 2000, "padding": 1100, "stopOffsetY": 170 },
+  "worlds": [
+    { "id": "browser", "label": "ブラウザ", "pattern": "grid", "palette": { "background": "#eef6ff", "dots": "#b5ccea", "accent": "#4285f4", "haze": "#ffffff" } },
+    { "id": "bridge", "label": "接続路", "pattern": "dots", "palette": { "background": "#fff6dd", "dots": "#dfc990", "accent": "#ffd449", "haze": "#fffdf7" } },
+    { "id": "chat", "label": "チャット", "pattern": "none", "palette": { "background": "#f5efff", "dots": "#c8b8e8", "accent": "#ae91f3", "haze": "#fffaff" } }
+  ],
+  "stops": [
+    { "id": "browser-home", "world": "browser", "scale": 1.08 },
+    { "id": "browser-action", "world": "browser", "scale": 1.24 },
+    { "id": "bridge-entry", "world": "bridge", "scale": 1.2 },
+    { "id": "bridge-exit", "world": "bridge", "scale": 1.08 },
+    { "id": "chat-question", "world": "chat", "scale": 1.2 },
+    { "id": "chat-answer", "world": "chat", "scale": 1.06 }
+  ],
+  "edges": [
+    { "type": "move" },
+    { "type": "portal", "via": "screen-portal", "transition": "dive" },
+    { "type": "move" },
+    { "type": "cut", "via": "mist-bridge", "transition": "mist" },
+    { "type": "move" }
+  ],
+  "sampleScript": {
+    "worlds": {},
+    "stops": [
+      { "id": "browser-home", "label": "入口ページ", "dwell": 2.0, "asset": "portal-frame" },
+      { "id": "browser-action", "label": "操作を選ぶ", "dwell": 2.1, "asset": "signpost" },
+      { "id": "bridge-entry", "label": "接続路へ", "dwell": 1.6, "asset": "signpost" },
+      { "id": "bridge-exit", "label": "応答を待つ", "dwell": 1.7, "asset": "signpost" },
+      { "id": "chat-question", "label": "問いかけ", "dwell": 2.2, "asset": "signpost" },
+      { "id": "chat-answer", "label": "返事が届く", "dwell": 2.4, "asset": "signpost" }
+    ],
+    "carry": ["cursor-guide"]
+  }
+}

package/vendor/skills/design-world/templates/paper-to-browser.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "id": "paper-to-browser",
+  "for": "world-map",
+  "summary": "紙面を読み進め、紙の窓からブラウザ世界へ潜る構成。\n手書きの導入から製品画面や Web の説明へ自然につなぐ動画向け。",
+  "layout": { "origin": [0, 0], "worldWidth": 3300, "worldHeight": 1700, "worldGap": 500, "stopSpacing": 2000, "padding": 1100, "stopOffsetY": 170 },
+  "worlds": [
+    { "id": "paper", "label": "紙の世界", "pattern": "dots", "palette": { "background": "#fffdf7", "dots": "#d8cfbd", "accent": "#ee82df", "haze": "#fff4d8" } },
+    { "id": "browser", "label": "ブラウザの世界", "pattern": "grid", "palette": { "background": "#edf5ff", "dots": "#afc7e8", "accent": "#4285f4", "haze": "#f8fbff" } }
+  ],
+  "stops": [
+    { "id": "paper-note", "world": "paper", "scale": 1.12 },
+    { "id": "paper-window", "world": "paper", "scale": 1.28 },
+    { "id": "browser-arrival", "world": "browser", "scale": 1.2 },
+    { "id": "browser-detail", "world": "browser", "scale": 1.1 },
+    { "id": "browser-summary", "world": "browser", "scale": 1.0 }
+  ],
+  "edges": [
+    { "type": "move" },
+    { "type": "portal", "via": "paper-portal", "transition": "dive" },
+    { "type": "move" },
+    { "type": "move" }
+  ],
+  "sampleScript": {
+    "worlds": {
+      "paper": { "label": "メモの平原" },
+      "browser": { "label": "青い画面の街" }
+    },
+    "stops": [
+      { "id": "paper-note", "label": "最初のひとこと", "dwell": 2.2, "asset": "signpost" },
+      { "id": "paper-window", "label": "紙の入口", "dwell": 1.8, "asset": "portal-frame" },
+      { "id": "browser-arrival", "label": "画面に到着", "dwell": 2.0, "asset": "portal-frame" },
+      { "id": "browser-detail", "label": "機能を見る", "dwell": 2.4, "asset": "signpost" },
+      { "id": "browser-summary", "label": "次へ進む", "dwell": 2.0, "asset": "signpost" }
+    ],
+    "carry": ["guide-card"]
+  }
+}

package/vendor/skills/design-world/templates/street-to-room.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "id": "street-to-room",
+  "for": "world-map",
+  "summary": "街を move で歩き、門を portal として通り、短い中間世界から部屋へ着く構成。\n移動の実感を主役にしながら屋外から室内へ導く動画向け。",
+  "layout": { "origin": [0, 0], "worldWidth": 3300, "worldHeight": 1700, "worldGap": 500, "stopSpacing": 2000, "padding": 1100, "stopOffsetY": 170 },
+  "worlds": [
+    { "id": "street", "label": "通り", "pattern": "grid", "palette": { "background": "#edf8f2", "dots": "#a9cfbb", "accent": "#2fc983", "haze": "#f7fff9" } },
+    { "id": "doorway", "label": "玄関", "pattern": "dots", "palette": { "background": "#fff3dc", "dots": "#d8be8f", "accent": "#fa8072", "haze": "#fffaf0" } },
+    { "id": "room", "label": "部屋", "pattern": "none", "palette": { "background": "#f6f0ff", "dots": "#cbbce6", "accent": "#ae91f3", "haze": "#fffbff" } }
+  ],
+  "stops": [
+    { "id": "street-start", "world": "street", "scale": 1.0 },
+    { "id": "street-corner", "world": "street", "scale": 1.14 },
+    { "id": "doorway-outside", "world": "doorway", "scale": 1.22 },
+    { "id": "doorway-inside", "world": "doorway", "scale": 1.12 },
+    { "id": "room-table", "world": "room", "scale": 1.18 },
+    { "id": "room-seat", "world": "room", "scale": 1.04 }
+  ],
+  "edges": [
+    { "type": "move" },
+    { "type": "portal", "via": "doorway-portal", "transition": "dive" },
+    { "type": "move" },
+    { "type": "cut", "via": "mist-threshold", "transition": "mist" },
+    { "type": "move" }
+  ],
+  "sampleScript": {
+    "worlds": {},
+    "stops": [
+      { "id": "street-start", "label": "歩きはじめ", "dwell": 1.8, "asset": "signpost" },
+      { "id": "street-corner", "label": "角を曲がる", "dwell": 1.7, "asset": "signpost" },
+      { "id": "doorway-outside", "label": "入口を見つける", "dwell": 2.0, "asset": "portal-frame" },
+      { "id": "doorway-inside", "label": "敷居を越える", "dwell": 1.6, "asset": "signpost" },
+      { "id": "room-table", "label": "机に着く", "dwell": 2.1, "asset": "signpost" },
+      { "id": "room-seat", "label": "落ち着く", "dwell": 2.3, "asset": "signpost" }
+    ],
+    "carry": ["traveler-token"]
+  }
+}

package/vendor/skills/design-world/world.md

@@ -0,0 +1,62 @@
+# ワールド設計の判断の型
+
+## 世界を切る
+
+背景の物理、画面の材質、時間や場所の規則が変わる所を world の境界にする。同じ机の上を巡るだけなら一つ、紙面からブラウザ画面へ入るなら二つに分ける。世界を増やす前に「背景・座標系・物の残り方のどれが変わるか」を一文で説明できるか確かめる。
+
+各 world には入口と出口に相当する停留所を最低 2 件置く。停留所は「カメラを止めて読ませる一枚」であり、飾りだけの場所は停留所にしない。
+
+## 辺を選ぶ
+
+- `move`: 同じ world の連続移動。距離感を見せる。既定 0.75 秒。
+- `portal`: 別 world へ連続して入る。入口の形や材質を見せたいときの既定。既定 1.2 秒、`transition.kind` は `dive`。
+- `cut`: 別 world へ意味で飛ぶ。時間を縮める必要があるときだけ使い、霧が覆う間に切り替える。既定 0.8 秒、`transition.kind` は `mist`。
+
+portal の `via` は、通過が画面で理解できる窓・扉・穴などの演出を表す空でない論理名にする。たとえば飛び込み口の素材 id が `paper-portal` なら、同じ名前を `via` に使える。cut の `via` は霧を担う素材または演出の論理名にする。
+
+## carry を決める
+
+世界境界の前後を同じ話として認識させる物だけを carry にする。主人公、手に持つカード、視線を導く印など、境界後にも見える必要がある物を選ぶ。世界をまたぐ辺の carry は空にせず、全 id を `retainedNodes` に集約する。背景や、その world に置き去りにする小物は持ち越さない。
+
+## 時間と cover
+
+停留所の滞在は、短い絵なら 1.5〜2.0 秒、見出しを読むなら 2.0〜3.0 秒、複数要素を読むなら 3.0〜4.0 秒を目安にする。まず読める尺を置き、移動を速めて総尺を合わせる。
+
+expand は最初の build を可能にするため、portal の `transition.cover` に 0.18 秒、cut に 0.24 秒の有限な暫定値を置く。`akari world preview --measure` で測った値が正で、0〜0.4 秒の範囲に収める。計測後は `akari world build` を再実行して `overlays/world.html` に実測値を反映する。move は常に `{ "kind": "none", "cover": 0 }` とする。
+
+## 構図の目安
+
+出力幅を `W`、出力高を `H`、停留所の `c` を `[x, y, scale]` とすると、画面に映る world の撮影枠は world px で次のようになる。
+
+```text
+frame = [x - (W/2)/scale, y - (H/2)/scale, W/scale, H/scale]
+```
+
+既定出力の `W=1920`、`H=1080` では次が目安になる。
+
+| scale | 撮影枠の幅 | 撮影枠の高さ | 半幅 | 半高 |
+|---:|---:|---:|---:|---:|
+| 1.0 | 1920 | 1080 | 960 | 540 |
+| 1.1 | 1745.5 | 981.8 | 872.7 | 490.9 |
+| 1.2 | 1600 | 900 | 800 | 450 |
+| 1.3 | 1476.9 | 830.8 | 738.5 | 415.4 |
+
+素材の既定サイズは各素材の `meta.json` / `fragment.html` の CSS 変数で決まる。使う素材の幅・高さと transform origin を実測してから `offset` を計算し、停留所 1 つには 2〜3 点を目安に置く。
+
+### offset の基準点
+
+`world-items.json` の `offset` は停留所中心からの world px である。素材の基準点が中心なら狙った中心位置をそのまま指定する。基準点が左上なら、素材の幅を `w`、高さを `h`、素材の scale を `s`、狙った中心を `[cx, cy]` として次で換算する。
+
+```text
+offset = [cx - w * s / 2, cy - h * s / 2]
+```
+
+安全余白は、素材の中心位置を `c`、scale 適用後の半幅・半高を `half`、停留所のカメラ倍率を `cameraScale` として、横を `|c.x| + half.width <= (960/cameraScale) - 120`、縦を `|c.y| + half.height <= (540/cameraScale) - 120` に収める。120 は画面端の安全余白である。収まらなければ素材の CSS 変数または `scale` で縮める。
+
+テンプレートの既定 layout は、最小 scale 1.0 でも撮影枠と bounds の間に 140 world px の余白を残す。`padding`、`worldHeight`、`stopOffsetY` を変える場合は、余白を `M` として `padding >= (W/2)/scaleMin + M`、`worldHeight/2 >= stopOffsetY + (H/2)/scaleMin + M` を満たすこと。満たさないと停留所の画面端に世界外の白帯が出る。`bin/test` は各停留所の撮影枠が bounds 内にあることを検査する。
+
+### 隣の停留所の映り込み
+
+撮影枠の幅は `1920/scale` なので、`stopSpacing` より広いと隣の停留所の素材が映り込む。既定の `stopSpacing = 2000` は最小 scale 1.0 の撮影枠幅 1920 より広い。素材を停留所中心から `±(stopSpacing/2) = ±1000` の陣地に収めれば、隣の停留所の素材は映らない。`stopSpacing` を狭める場合は、素材の届く範囲も同じだけ狭める。
+
+説明役を停留所の左側 -400 前後、主役を右側 +400 前後へ置くと視線が左から右へ流れる。左上基準の素材は上の式で `offset` へ換算し、色の CSS 変数はその world の `palette.accent` に合わせる。

package/vendor/skills/overlay-authoring/world.md

@@ -40,3 +40,42 @@
 `view` はカメラ位置に依存しない world → screen の affine `{ scale, ox, oy }`
 （`screen = ox + p * scale`）。`options.frame === true` なら現在の撮影枠を `#EE82DF` で重ねる。
 独自の地図描画を複製しない。
+
+## 地図タブからの書き戻し
+
+flat の停留所は地図タブで ⌥ ドラッグして移動できる。書き戻しは
+`akari world move-stop <project-root> --stop <id> --c x,y[,scale]` だけが行い、spatial には対応しない。
+`world-map.json` は edit.json の履歴の外にあるため、undo / redo はない。
+
+## spatial world の build / preview
+
+`kind: "spatial"` も flat と同じ `planning/world-map.json` と `camera(t)` を使う。
+`akari world build <project-root>` は世界の床・遠景板・霧板・zone の目印を
+`assets/world/world.glb` に焼き、eye / target を別々に補間した `TourCamera` と `Tour` clip を加える。
+床には `palette.dots` 由来の決定論的な格子を焼き、背景色と同色の world でも観察できる構造を保つ。
+同時に `overlays/world.html` へ、three-runtime が受理する次の宣言を生成し、edit.json の
+visual lane へ id `world` で upsert する。
+
+```json
+{
+  "model": "assets/world/world.glb",
+  "camera": { "fromModel": "TourCamera" },
+  "animationClip": "Tour",
+  "environment": { "intensity": 0, "exposure": 1 },
+  "lights": [],
+  "fog": { "color": "#ccd9e6", "near": 1, "far": 128 },
+  "background": { "color": "#182235" }
+}
+```
+
+`fog` は先頭 world の `palette.haze`、`background` は `palette.background` がある場合だけ
+生成される。値が無いときにキーを補わない。テロップと 2D 素材はこの three 断片へ入れず、
+別 overlay item として重ねる。
+
+`akari world preview <project-root>` は flat と同じ rasterize 経路で stop と edge の代表 PNG を撮る。
+`--measure` を付けると非 move edge を 30 Hz で走査し、全画素 RGB の標準偏差が 2 以下の
+一様な霧となった連続時間を `transition.cover` へ書き戻す。3D の cut は霧または遮蔽物を通し、
+平面ワイプにしない。
+
+edit.json は version 2 が必要である。古い形式では build がファイルを書き換えずに停止するため、
+先に `akari migrate <project-root>` を実行して、専用コマンドの確認と退避バックアップを通す。