akari-video 0.1.67 → 0.1.68

package/README.md

@@ -56,6 +56,17 @@ sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-com
 `akari clean [project-dir] [--dry-run] [--yes] [--json]`（使い捨ての中間ファイル、保持する
 正本、判断が必要なものを容量付きで一覧する。既定は一覧のみで、削除可能なものだけを承認後に削除）。
 
+## 拡張キット
+
+`manifest.json` を持つ配布物を `akari store install <productId>` で導入すると、CLI / runtime の要件を検査し、素材とスキルを `~/.akari` 配下へ symlink で合成する。導入状況は `akari store status`、解除は `akari store uninstall <productId>` で確認・操作できる。Claude Code では初回だけ次を実行する。
+
+```sh
+claude plugin marketplace add ~/.akari/kits
+claude plugin install akari-kits@akari-kits
+```
+
+`claude` が PATH に無い場合は、Claude Code のプラグイン設定で `~/.akari/kits` を marketplace として追加する。
+
 `akari` に渡した引数はそのまま `opencode` に転送する（例: `akari --continue` は
 `opencode --continue` を起動する）。
 

package/bin/akari.mjs

@@ -14,6 +14,8 @@ import { runMigrateCommand } from '../src/migrate-command.mjs';
 import { runCleanCommand } from '../src/clean-command.mjs';
 import { runDoctorCommand } from '../src/doctor-command.mjs';
 import { runGenerateCommand } from '../src/generate-command.mjs';
+import { runStoryboardCommand } from '../src/storyboard-command.mjs';
+import { runWorldCommand } from '../src/world-command.mjs';
 import { resolveRuntimePaths } from '../src/runtime-diagnostics.mjs';
 import { maybeApplyPendingUpdateOnLaunch, resolveInstalledVersionInfo } from '../src/update-check.mjs';
 import { describeCliHelp, describeInstalledVersions } from '../src/messages.mjs';
@@ -36,7 +38,7 @@ async function printVersion() {
 // `--help` は claude/opencode へそのまま転送されてしまっていた — AKARI Video 自身の
 // コマンド一覧が一度も出ない行き止まりだったため新設した）。
 async function printCliHelp() {
-  for (const line of describeCliHelp()) {
+  for (const line of [...describeCliHelp(), '  world                    ワールド地図を検査・生成・プレビュー']) {
     console.log(line);
   }
   return { exitCode: 0 };
@@ -82,6 +84,8 @@ const invoke = (argv[0] === '--version' || argv[0] === '-v') ? printVersion()
   : argv[0] === 'migrate' ? runMigrateCommand(argv.slice(1))
   : argv[0] === 'clean' ? runCleanCommand(argv.slice(1))
   : argv[0] === 'generate' ? runGenerateCommand(argv.slice(1))
+  : argv[0] === 'storyboard' ? runStoryboardCommand(argv.slice(1))
+  : argv[0] === 'world' ? runWorldCommand(argv.slice(1))
   : run(argv);
 
 const result = await invoke.catch((error) => {

package/package.json

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

@@ -0,0 +1,238 @@
+import { spawnSync } from 'node:child_process';
+import {
+  existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync,
+  renameSync, rmSync, symlinkSync, writeFileSync
+} from 'node:fs';
+import path from 'node:path';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+
+const KITS_SCHEMA = 'akari-installed-kits/v0';
+const PLUGIN_DESCRIPTION = 'AKARI Video 拡張キットのスキルをまとめて提供するローカルプラグイン。';
+
+function parseVersion(value) {
+  const match = String(value).match(/^(\d+)\.(\d+)\.(\d+)$/u);
+  return match ? match.slice(1).map(Number) : null;
+}
+
+function compareVersions(left, right) {
+  for (let index = 0; index < 3; index += 1) {
+    if (left[index] !== right[index]) return left[index] - right[index];
+  }
+  return 0;
+}
+
+function satisfies(version, range) {
+  const actual = parseVersion(version);
+  const match = String(range).match(/^(\^|~|>=)?(\d+\.\d+\.\d+)$/u);
+  if (!actual || !match) return false;
+  const required = parseVersion(match[2]);
+  if (compareVersions(actual, required) < 0) return false;
+  if (match[1] === '^') {
+    return actual[0] === required[0] && (required[0] !== 0 || actual[1] === required[1]);
+  }
+  if (match[1] === '~') return actual[0] === required[0] && actual[1] === required[1];
+  if (match[1] === '>=') return true;
+  return compareVersions(actual, required) === 0;
+}
+
+export function readKitManifest(kitDir) {
+  const manifestPath = path.join(kitDir, 'manifest.json');
+  return existsSync(manifestPath) ? JSON.parse(readFileSync(manifestPath, 'utf8')) : null;
+}
+
+export function checkRequires(manifest, { cliVersion, runtimeIds = [], entitledProductIds = [] }) {
+  const blockers = [];
+  const warnings = [];
+  const requires = manifest?.requires ?? {};
+  if (!satisfies(cliVersion, requires.cli)) {
+    blockers.push(`CLI ${requires.cli} が必要です（現在 ${cliVersion}）。AKARI Video を更新してください。`);
+  }
+  const availableRuntimes = new Set(runtimeIds);
+  for (const runtimeId of requires.runtimes ?? []) {
+    if (!availableRuntimes.has(runtimeId)) {
+      blockers.push(`runtime ${runtimeId} がありません。このアプリ版ではキットを利用できません。`);
+    }
+  }
+  const entitled = new Set(entitledProductIds);
+  for (const productId of requires.products ?? []) {
+    if (!entitled.has(productId)) {
+      warnings.push(`依存商品 ${productId} の購入が確認できません。\`akari store install ${productId}\` で導入してください。`);
+    }
+  }
+  return { ok: blockers.length === 0, blockers, warnings };
+}
+
+function safeKitPath(kitDir, ...parts) {
+  const root = path.resolve(kitDir);
+  const candidate = path.resolve(root, ...parts);
+  if (candidate !== root && !candidate.startsWith(`${root}${path.sep}`)) {
+    throw new Error(`キット外のパスは参照できません: ${parts.join('/')}`);
+  }
+  return candidate;
+}
+
+function replaceSymlink(source, destination, {
+  platform = process.platform,
+  relativeTarget,
+  symlinkSyncImpl = symlinkSync
+} = {}) {
+  if (existsSync(destination) || (() => { try { lstatSync(destination); return true; } catch { return false; } })()) {
+    const stat = lstatSync(destination);
+    if (!stat.isSymbolicLink()) return { status: 'occupied' };
+    rmSync(destination);
+  }
+  mkdirSync(path.dirname(destination), { recursive: true });
+  const target = relativeTarget ?? path.relative(path.dirname(destination), source);
+  try {
+    symlinkSyncImpl(target, destination, 'dir');
+    return { status: 'linked', target };
+  } catch (error) {
+    if (platform === 'win32' && error?.code === 'EPERM') return { status: 'permission-denied' };
+    throw error;
+  }
+}
+
+export function linkKitAssets(kitDir, manifest, home, options = {}) {
+  const warnings = [];
+  const linked = [];
+  const assets = options.assets?.schemasSourceDir !== undefined
+    ? options.assets
+    : resolveLauncherAssets(options.assets);
+  const validator = options.validateAssetPath
+    ?? (assets.schemasSourceDir ? path.join(assets.schemasSourceDir, 'bin', 'validate-asset.mjs') : null);
+  for (const asset of manifest.assets ?? []) {
+    const source = safeKitPath(kitDir, 'assets', asset.category, asset.id);
+    if (validator && existsSync(validator)) {
+      const result = (options.spawnSyncImpl ?? spawnSync)(process.execPath, [validator, source], { stdio: 'pipe' });
+      if (result.status !== 0) {
+        warnings.push(`素材 ${asset.category}/${asset.id} は検査に失敗したためリンクしませんでした。`);
+        continue;
+      }
+    } else {
+      warnings.push(`素材 ${asset.category}/${asset.id} の検査ツールが見つからないため検査をスキップしました。`);
+    }
+    const destination = path.join(home, 'assets', asset.category, asset.id);
+    const result = replaceSymlink(source, destination, {
+      ...options,
+      relativeTarget: path.join('..', '..', 'assets', 'store', manifest.id, 'assets', asset.category, asset.id)
+    });
+    if (result.status === 'occupied') {
+      warnings.push(`既存の実ディレクトリを保持しました: ${destination}`);
+    } else if (result.status === 'permission-denied') {
+      warnings.push(`symlink を作成できませんでした（Windows の権限を確認してください）: ${destination}`);
+    } else {
+      linked.push({ category: asset.category, id: asset.id });
+    }
+  }
+  return { linked, warnings };
+}
+
+export function linkKitSkills(kitDir, manifest, home, options = {}) {
+  const warnings = [];
+  const blockers = [];
+  const linked = [];
+  const planned = [];
+  for (const skill of manifest.skills ?? []) {
+    const source = safeKitPath(kitDir, skill.dir);
+    const destination = path.join(home, 'kits', 'plugin', 'skills', skill.name);
+    try {
+      const stat = lstatSync(destination);
+      if (!stat.isSymbolicLink()) {
+        blockers.push(`スキル名 ${skill.name} は既存の実ディレクトリと重複しています。`);
+        continue;
+      }
+      const current = path.resolve(path.dirname(destination), readlinkSync(destination));
+      if (current !== source) {
+        blockers.push(`スキル名 ${skill.name} は別のキットと重複しています。`);
+        continue;
+      }
+    } catch (error) {
+      if (error?.code !== 'ENOENT') throw error;
+    }
+    planned.push({ skill, source, destination });
+  }
+  if (blockers.length > 0) return { linked, blockers, warnings };
+  for (const { skill, source, destination } of planned) {
+    const result = replaceSymlink(source, destination, options);
+    if (result.status === 'permission-denied') {
+      warnings.push(`symlink を作成できませんでした（Windows の権限を確認してください）: ${destination}`);
+    } else {
+      linked.push(skill.name);
+    }
+  }
+  return { linked, blockers, warnings };
+}
+
+export function readKitsLedger(home) {
+  const ledgerPath = path.join(home, 'kits', 'installed.json');
+  if (!existsSync(ledgerPath)) return { schema: KITS_SCHEMA, kits: [] };
+  const ledger = JSON.parse(readFileSync(ledgerPath, 'utf8'));
+  if (ledger?.schema !== KITS_SCHEMA || !Array.isArray(ledger.kits)) {
+    throw new Error(`拡張キット台帳の形式が想定と違います: ${ledgerPath}`);
+  }
+  return ledger;
+}
+
+export function writeKitsLedger(home, entry) {
+  const ledger = readKitsLedger(home);
+  ledger.kits = [...ledger.kits.filter((kit) => kit.id !== entry.id), entry];
+  const ledgerPath = path.join(home, 'kits', 'installed.json');
+  mkdirSync(path.dirname(ledgerPath), { recursive: true });
+  const temporary = `${ledgerPath}.tmp-${process.pid}`;
+  writeFileSync(temporary, `${JSON.stringify(ledger, null, 2)}\n`, { mode: 0o600 });
+  renameSync(temporary, ledgerPath);
+  return ledger;
+}
+
+export function removeKit(home, productId) {
+  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);
+  }
+  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);
+  return true;
+}
+
+function removeOwnedSymlink(linkPath, kitDir) {
+  try {
+    if (!lstatSync(linkPath).isSymbolicLink()) return;
+    const target = path.resolve(path.dirname(linkPath), readlinkSync(linkPath));
+    if (target === path.resolve(kitDir) || target.startsWith(`${path.resolve(kitDir)}${path.sep}`)) rmSync(linkPath);
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error;
+  }
+}
+
+export function ensureKitsMarketplace(home) {
+  const marketplacePath = path.join(home, 'kits', '.claude-plugin', 'marketplace.json');
+  const pluginPath = path.join(home, 'kits', 'plugin', '.claude-plugin', 'plugin.json');
+  const marketplace = {
+    name: 'akari-kits',
+    owner: { name: 'AKARI Video' },
+    plugins: [{ name: 'akari-kits', source: './plugin', description: PLUGIN_DESCRIPTION }]
+  };
+  const plugin = { name: 'akari-kits', description: PLUGIN_DESCRIPTION };
+  for (const [filePath, value] of [[marketplacePath, marketplace], [pluginPath, plugin]]) {
+    mkdirSync(path.dirname(filePath), { recursive: true });
+    const content = `${JSON.stringify(value, null, 2)}\n`;
+    if (!existsSync(filePath) || readFileSync(filePath, 'utf8') !== content) writeFileSync(filePath, content);
+  }
+  return { marketplacePath, pluginPath };
+}
+
+export function enableHint() {
+  return [
+    'Claude Code で拡張キットを有効化してください:',
+    '  claude plugin marketplace add ~/.akari/kits',
+    '  claude plugin install akari-kits@akari-kits',
+    'claude が PATH に無い場合は、Claude Code のプラグイン設定で ~/.akari/kits を marketplace として追加してください。'
+  ].join('\n');
+}

package/src/messages.mjs

@@ -331,6 +331,7 @@ export function describeCliHelp() {
     '  status                 接続状態を確認する',
     '  migrate [dir]          古い edit.json を退避バックアップ付きで v2 へ変換',
     '  generate               台本のビートから静止画クリップを生成',
+    '  storyboard             タイムラインから印刷用の絵コンテを作成',
     '  akari clean [dir]      使い捨ての中間ファイルを一覧・削除（既定は一覧のみ）',
     '',
     '開発者向け:',

package/src/repo-assets.mjs

@@ -40,6 +40,7 @@ export const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin
 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 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');
 
 /**
  * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装・creator-root
@@ -62,6 +63,7 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const decisionLogScript = path.join(repoRoot, DECISION_LOG_SCRIPT_RELATIVE);
   const wordBookScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'word-book.mjs');
   const generateScript = path.join(repoRoot, GENERATE_CLI_RELATIVE);
+  const storyboardScript = path.join(repoRoot, STORYBOARD_CLI_RELATIVE);
 
   return {
     repoRoot,
@@ -82,7 +84,8 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
     mediaScript: existsSync(mediaScript) ? mediaScript : null,
     ...(existsSync(decisionLogScript) ? { decisionLogScript } : {}),
     ...(existsSync(wordBookScript) ? { wordBookScript } : {}),
-    ...(existsSync(generateScript) ? { generateScript } : {})
+    ...(existsSync(generateScript) ? { generateScript } : {}),
+    ...(existsSync(storyboardScript) ? { storyboardScript } : {})
   };
 }
 
@@ -121,6 +124,9 @@ export function resolveLauncherAssets({
     ...(candidate.generateScript ?? vendor.generateScript
       ? { generateScript: candidate.generateScript ?? vendor.generateScript }
       : {}),
+    ...(candidate.storyboardScript ?? vendor.storyboardScript
+      ? { storyboardScript: candidate.storyboardScript ?? vendor.storyboardScript }
+      : {}),
     ...(candidate.decisionLogScript ?? vendor.decisionLogScript ? { decisionLogScript: candidate.decisionLogScript ?? vendor.decisionLogScript } : {}),
     ...(candidate.wordBookScript ?? vendor.wordBookScript
       ? { wordBookScript: candidate.wordBookScript ?? vendor.wordBookScript }

package/src/store-command.mjs

@@ -5,6 +5,7 @@ import {
 } from 'node:fs';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
+import { pathToFileURL } from 'node:url';
 import {
   DEFAULT_STORE_BASE_URL,
   defaultOpenBrowser,
@@ -17,6 +18,19 @@ import {
   startDeviceConnection,
   validateAndSaveCredentials
 } from './store-device-connect.mjs';
+import { readOwnVersion } from './update-check.mjs';
+import { resolveLauncherAssets } from './repo-assets.mjs';
+import {
+  checkRequires,
+  enableHint,
+  ensureKitsMarketplace,
+  linkKitAssets,
+  linkKitSkills,
+  readKitManifest,
+  readKitsLedger,
+  removeKit,
+  writeKitsLedger
+} from './kits.mjs';
 
 export { readCredentials, resolveCredentialsPath } from './store-device-connect.mjs';
 
@@ -288,6 +302,27 @@ export async function runStoreCommand(args, options = {}) {
     }
     log(`接続中: ${data.email}（${creds.url}）`);
     formatStoreEntitlements(data, log);
+    const kits = readKitsLedger(resolveAkariHome(env)).kits;
+    if (kits.length > 0) {
+      log('拡張キット:');
+      for (const kit of kits) {
+        log(`  ${kit.id} v${kit.version} / スキル: ${(kit.skills ?? []).join(', ') || 'なし'} / 素材: ${(kit.assets ?? []).length} 件`);
+      }
+    }
+    return { exitCode: 0 };
+  }
+
+  if (sub === 'uninstall') {
+    const productId = args[1];
+    if (!isSafePathSegment(productId) || productId.startsWith('--')) {
+      log('使い方: akari store uninstall <productId>');
+      return { exitCode: 1 };
+    }
+    if (!removeKit(resolveAkariHome(env), productId)) {
+      log(`導入済みの拡張キットが見つかりません: ${productId}`);
+      return { exitCode: 1 };
+    }
+    log(`拡張キットを無効化しました: ${productId}（展開済みファイルは残しています）`);
     return { exitCode: 0 };
   }
 
@@ -415,6 +450,107 @@ export async function runStoreCommand(args, options = {}) {
       const readme = findFile(destDir, 'README.md');
       log(`展開しました: ${destDir}`);
       if (readme) log(`導入手順: ${readme}`);
+      // 深い階層の無関係な manifest.json をキットと誤認すると、従来成功していた素材商品の
+      // install を壊す。キットの規定位置は展開ルート、または zip が単一トップディレクトリを
+      // 持つ場合のその直下だけとし、JSON として読めても kind !== kit なら完全に素通りする。
+      let manifestPath = path.join(destDir, 'manifest.json');
+      if (!existsSync(manifestPath)) {
+        const rootEntries = readdirSync(destDir, { withFileTypes: true });
+        manifestPath = rootEntries.length === 1 && rootEntries[0].isDirectory()
+          ? path.join(destDir, rootEntries[0].name, 'manifest.json')
+          : null;
+        if (manifestPath && !existsSync(manifestPath)) manifestPath = null;
+      }
+      let manifest = null;
+      if (manifestPath) {
+        try {
+          manifest = readKitManifest(path.dirname(manifestPath));
+        } catch {
+          log('キットの検査に失敗しました。展開済みファイルを確認してください。');
+          return { exitCode: 1 };
+        }
+      }
+      if (manifest?.kind === 'kit') {
+        const kitDir = path.dirname(manifestPath);
+        const home = resolveAkariHome(env);
+        const launcherAssets = options.assets ?? resolveLauncherAssets();
+        const validator = launcherAssets.schemasSourceDir
+          ? path.join(launcherAssets.schemasSourceDir, 'bin', 'validate-kit-manifest.mjs')
+          : null;
+        if (validator && existsSync(validator)) {
+          const validateArgs = [validator, kitDir];
+          if (launcherAssets.skillsSourceDir) validateArgs.push('--public-skills', launcherAssets.skillsSourceDir);
+          const validation = (options.spawnSync ?? spawnSync)(process.execPath, validateArgs, { stdio: 'pipe' });
+          if (validation.status !== 0) {
+            log('キットの検査に失敗しました。展開済みファイルを確認してください。');
+            return { exitCode: 1 };
+          }
+        } else {
+          // npm 配布物には schemas の検査 bin が無い場合がある。runtime と同じく、
+          // 器の欠落で購入済みコンテンツを利用不能にしないため warning へ degrade する。
+          log('キットの検査ツールが見つからないため検査をスキップしました');
+        }
+        const requirementWarnings = [];
+        let runtimeIds;
+        const runtimePath = path.join(launcherAssets.repoRoot, 'packages', 'overlay-runtime', 'runtimes.mjs');
+        if (existsSync(runtimePath)) {
+          try {
+            const runtimeModule = await import(pathToFileURL(runtimePath).href);
+            runtimeIds = runtimeModule.runtimes.map((runtime) => runtime.id);
+          } catch {
+            runtimeIds = null;
+          }
+        }
+        if (!runtimeIds) {
+          // overlay-runtime は launcher の npm tarball に同梱されない。照合不能は
+          // manifest 不備ではないため warning に落とし、要求 id を既知扱いして続行する。
+          requirementWarnings.push('runtime registry が見つからないため runtime id の照合をスキップしました。');
+          runtimeIds = manifest.requires?.runtimes ?? [];
+        }
+        let entitledProductIds = [];
+        const credentials = readCredentials(env);
+        if (credentials) {
+          const entitlementResult = await fetchStoreEntitlements(fetchImpl, credentials.url, credentials.token);
+          entitledProductIds = (entitlementResult.data?.entitlements ?? [])
+            .map((entry) => entry.product_id ?? entry.id)
+            .filter(Boolean);
+        }
+        const requires = checkRequires(manifest, {
+          cliVersion: options.cliVersion ?? readOwnVersion(),
+          runtimeIds,
+          entitledProductIds
+        });
+        if (manifest.id !== productId) requires.blockers.push(`manifest id が商品 id と一致しません: ${manifest.id} != ${productId}`);
+        requires.ok = requires.blockers.length === 0;
+        for (const warning of [...requirementWarnings, ...requires.warnings]) log(`警告: ${warning}`);
+        if (!requires.ok) {
+          for (const blocker of requires.blockers) log(`導入できません: ${blocker}`);
+          return { exitCode: 1 };
+        }
+
+        const hadInstalledKit = readKitsLedger(home).kits.length > 0;
+        const assetLinks = linkKitAssets(kitDir, manifest, home, {
+          assets: options.assets,
+          spawnSyncImpl: options.spawnSync,
+          platform: options.platform
+        });
+        const skillLinks = linkKitSkills(kitDir, manifest, home, { platform: options.platform });
+        for (const warning of [...assetLinks.warnings, ...skillLinks.warnings]) log(`警告: ${warning}`);
+        if (skillLinks.blockers.length > 0) {
+          for (const blocker of skillLinks.blockers) log(`導入できません: ${blocker}`);
+          return { exitCode: 1 };
+        }
+        writeKitsLedger(home, {
+          id: manifest.id,
+          version: manifest.version,
+          installedAt: new Date().toISOString(),
+          kitDir,
+          skills: skillLinks.linked,
+          assets: assetLinks.linked
+        });
+        ensureKitsMarketplace(home);
+        if (!hadInstalledKit) log(enableHint());
+      }
       const packPath = findFile(destDir, 'PACK.json');
       if (packPath) {
         const items = registerInstalledPack(env, productId, packPath);
@@ -436,10 +572,11 @@ export async function runStoreCommand(args, options = {}) {
     return { exitCode: 0 };
   }
 
-  log('使い方: akari store <connect|status|install|download|disconnect>');
+  log('使い方: akari store <connect|status|install|uninstall|download|disconnect>');
   log('  connect                              ブラウザで承認して接続（既定。--token akst_... で手動 / --no-open でブラウザを開かない / --url <base>）');
   log('  status                               接続状態と購入済み一覧');
   log('  install <productId> [--from <zip>]   購入済み商品の導入（--from は手元 zip / PACK.json 素材を installed 索引へ登録）');
+  log('  uninstall <productId>                拡張キットの symlink と台帳登録を解除（展開済みファイルは保持）');
   log('  download <productId> [--dest <dir>]  購入済み配布物の取得のみ');
   log('  disconnect                           接続解除');
   return { exitCode: sub ? 1 : 0 };

package/src/storyboard-command.mjs

@@ -0,0 +1,24 @@
+import { spawnSync } from "node:child_process";
+
+import { resolveLauncherAssets } from "./repo-assets.mjs";
+
+const USAGE = "使い方: akari storyboard <projectDir> [--no-capture] [--captures <dir>] [--out <dir>]";
+
+export async function runStoryboardCommand(args, options = {}) {
+  const log = options.log ?? ((line) => console.log(line));
+  if (args.includes("--help")) {
+    log(USAGE);
+    return { exitCode: 0 };
+  }
+
+  const logError = options.logError ?? ((line) => console.error(line));
+  const assets = options.assets ?? resolveLauncherAssets();
+  const spawn = options.spawn ?? spawnSync;
+  if (!assets.storyboardScript) {
+    logError("akari storyboard の実行スクリプトが見つかりません。完全な AKARI Video を再導入してください:");
+    logError("  npm install -g akari-video");
+    return { exitCode: 2 };
+  }
+  const result = spawn(process.execPath, [assets.storyboardScript, ...args], { stdio: "inherit" });
+  return { exitCode: typeof result?.status === "number" ? result.status : 1 };
+}

package/src/world-command.mjs

@@ -0,0 +1,17 @@
+import { existsSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+
+import { resolveLauncherAssets } 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;
+  if (!script || !existsSync(script)) {
+    logError('内部コマンド world の実行スクリプトが見つかりません。AKARI Video の完全な checkout または配布物を確認してください。');
+    return { exitCode: 1 };
+  }
+  const result = (options.spawn ?? spawnSync)(process.execPath, [script, ...args], { stdio: 'inherit' });
+  return { exitCode: typeof result?.status === 'number' ? result.status : 1 };
+}

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

@@ -67,7 +67,9 @@
     "docs/contract-2026-09-06-cut-audio-split-v0.md",
     "docs/contract-2026-09-06-vgpu-layer-v0.md",
     "docs/contract-2026-09-12-review-session-viewer.md",
+    "docs/contract-2026-09-13-extension-kit-v0.md",
     "docs/contract-2026-09-13-generation-v0.md",
+    "docs/contract-2026-09-13-world-map-v0.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -188,6 +190,7 @@
     "skills/overlay-authoring/telop.md",
     "skills/overlay-authoring/text-behind-person.md",
     "skills/overlay-authoring/thumbnail.md",
+    "skills/overlay-authoring/world.md",
     "skills/render-cut/SKILL.md",
     "skills/research-plan/competitor.md",
     "skills/research-plan/ideate.md",

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

@@ -0,0 +1,75 @@
+# 設計契約 — 拡張キット v0（技術契約）
+
+## 1. 定義と構成
+
+拡張キットは、公開されている AKARI Video の器へスキル・テンプレート・素材・説明書を追加するコンテキスト束である。既存の `akari store install <productId>` が次へ展開する。
+
+```text
+~/.akari/assets/store/<productId>/
+├── manifest.json
+├── skills/<skill-name>/SKILL.md
+├── templates/<name>.json
+├── assets/<category>/<id>/{meta.json, …}
+├── docs/*.md
+├── README.md
+├── LICENSE.md
+└── checksums.txt
+```
+
+`productId` は Store の商品 id、`version` は商品の整数版である。キット全体のライセンスは `LicenseRef-AKARI-Assets-v0` とし、各素材の `meta.json` も個別の `license` を持つ。
+
+## 2. `manifest.json`
+
+`schemaVersion: 1` の manifest は additive-only とする。例:
+
+```json
+{
+  "schemaVersion": 1,
+  "id": "world-kit",
+  "kind": "kit",
+  "name": "ワールドキット",
+  "version": 1,
+  "requires": {
+    "cli": ">=0.1.70",
+    "runtimes": ["world", "three"],
+    "products": ["akari-pop-motion-set"]
+  },
+  "skills": [{ "dir": "skills/design-world", "name": "design-world" }],
+  "templates": [{ "path": "templates/paper-to-browser.json", "for": "world-map", "label": "紙の地図 → ブラウザの中" }],
+  "assets": [{ "category": "overlay", "id": "world-far-bands" }],
+  "docs": [{ "path": "docs/world-hen.md", "label": "ワールド編（抜粋）" }],
+  "license": "LicenseRef-AKARI-Assets-v0",
+  "provenance": { "author": "AKARI Labs", "source": "example:world-kit" }
+}
+```
+
+必須フィールドは `schemaVersion`、`id`、`kind`、`name`、`version`、`requires.cli`、`license`。`kind` は v0 では `kit` のみ。`validate-kit-manifest.mjs` はスキル実体、素材メタデータ、テンプレート用途語彙を含めて検査する。
+
+## 3. 展開
+
+`akari store install <productId>` は従来の entitlement 確認、zip 取得、checksum 照合、展開を終えたあと、`manifest.json` がある商品だけ次を行う。
+
+1. manifest と `requires` を検査する。CLI または runtime の不足は fail-closed、依存商品の不足は警告と導入案内にする。
+2. `assets[]` を `~/.akari/assets/<category>/<id>` へ相対 symlink で公開する。各素材はリンク前に `validate-asset.mjs` で検査する。
+3. `skills[]` を `~/.akari/kits/plugin/skills/<name>` へ相対 symlink で公開する。
+4. `~/.akari/kits/installed.json` に id、version、導入日時、展開先、スキル、素材を記録する。
+5. `templates[]` は移動せず、CLI が各展開先の manifest を列挙して読む。
+
+manifest が無い商品は従来の素材商品として扱う。検査器や runtime registry が npm 配布物に同梱されておらず照合できない場合は、その検査だけを警告付きでスキップする。`akari store uninstall <productId>` は台帳に記録した symlink と台帳エントリを外し、再導入用の展開ディレクトリは残す。
+
+## 4. スキルの発見
+
+Claude Code 向けには `~/.akari/kits` を directory marketplace として生成する。`plugin/skills/` は全キットの合成ディレクトリで、名前空間は純正の `akari:` と分離した `akari-kits:` になる。初回だけ次を実行する。
+
+```sh
+claude plugin marketplace add ~/.akari/kits
+claude plugin install akari-kits@akari-kits
+```
+
+`claude` が PATH に無い場合は、Claude Code のプラグイン設定で `~/.akari/kits` を marketplace として追加する。SessionStart hook は導入済みキットがあり、`enabledPlugins` に `akari-kits@akari-kits` が無い場合だけこの案内を 1 行表示し、設定を変更しない。
+
+Codex、Cursor、opencode では、プロジェクトの `.agents/.codex/.cursor/.opencode/skills` へキットスキルも合成する。同名があれば純正スキルを優先する。plugin が利用できない環境でも `~/.akari/kits/plugin/skills/<name>/SKILL.md` を直接読める。
+
+## 6. 更新と版
+
+キットの版は Store の整数版とする。`akari store status` が導入済みの id、version、スキル名、素材数を表示し、同じ `akari store install` で新版へ置換する。

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

@@ -0,0 +1,50 @@
+# ワールドマップ v0 契約
+
+## 1. ファイルとスキーマ
+
+ワールドマップはプロジェクトの `planning/world-map.json` に置く。このファイルの存在を地図 UI の表示条件とする。公開 v0 は `schemaVersion: 3` で、以後の変更は additive-only とする。旧 `schemaVersion: 2` は CLI の読み口で v3 に正規化できる。
+
+共通のルートは `kind`、`worlds[]`、`zones[]`、`cameraStops[]`、`edges[]`、`retainedNodes[]` からなる。`kind` は `flat` または `spatial`。flat world は `flat.bounds` と `flat.pattern`、spatial world は `spatial.c` を持つ。zone は世界内の位置、cameraStop は滞在窓とカメラ位置、edge は連続する停留所間の移動または切替を宣言する。
+
+機械検査する不変条件は次のとおり。
+
+1. world は 1 件以上で、各 world は zone を 2 件以上持つ。
+2. zones と cameraStops の id 集合は一致し、stop は `at` 昇順、`at < leave`、窓は非重複とする。
+3. edge 数は stop 数より 1 少なく、順序と `from` / `to` / `t0` / `t1` が stop 列に一致する。
+4. edge type は `move` / `portal` / `cut`。非 move は `via`、`transition`、区間内の `switchTime` が必須。
+5. 世界をまたぐ edge は空でない `carry` を持ち、その値は `retainedNodes` の部分集合とする。
+6. transition kind は `none` / `dive` / `mist` / `occluder` / `fade` / `push`。spatial では `push` を禁止する。
+7. cut の実測 `cover` は 0.4 秒以下。未測定の `null` は通常検査では警告、strict 検査ではエラーとする。portal の cover には上限を設けない。
+8. palette は 6 桁 hex、flat bounds と spatial floor size は有限かつ正とする。
+9. 同一 world 内の連続 stop 間は move とする。
+
+## 2. カメラ関数
+
+`camera(t)` は world-map だけを入力にする純関数である。stop 窓では宣言値を返し、move では両 stop 間を補間する。portal / cut では `switchTime` より前を接近、後を脱出として `via` を経由し、切替時点で world を切り替える。同一入力時刻には常に同じ値を返す。
+
+## 3. 描画
+
+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 とする。
+
+## 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` だけを書き戻す。
+- `akari world overview`: 外部通信を行わず `file://` で開ける自己完結の俯瞰 HTML を生成する。
+
+同じ入力から得る HTML と画像は決定論的でなければならない。素材 id は asset resolver で解決し、未解決時は失敗として扱う。
+
+## 5. 地図 UI
+
+地図 UI は world-map を読み取り専用で表示する。2D 俯瞰、ワールド帯、再生時刻に追従する撮影枠、選択中の stop / edge 詳細を提供し、データの編集機能は持たない。
+
+## 6. 制作フロー
+
+企画と絵コンテで章を world として宣言し、モーション区間は `world-map.json` → `akari world build` → overlay → 書き出しの順に処理する。実写区間との接点は portal とカットアウェイ章に限定する。
+
+## 7. 将来拡張
+
+生成動画を world の zone や edge へ配置する機能、world camera と別 overlay の 3D を世界座標で同期する機能、より大規模な world の間引きは v0 の外とし、後方互換な追加として導入する。

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

@@ -56,6 +56,17 @@ sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-com
 `akari clean [project-dir] [--dry-run] [--yes] [--json]`（使い捨ての中間ファイル、保持する
 正本、判断が必要なものを容量付きで一覧する。既定は一覧のみで、削除可能なものだけを承認後に削除）。
 
+## 拡張キット
+
+`manifest.json` を持つ配布物を `akari store install <productId>` で導入すると、CLI / runtime の要件を検査し、素材とスキルを `~/.akari` 配下へ symlink で合成する。導入状況は `akari store status`、解除は `akari store uninstall <productId>` で確認・操作できる。Claude Code では初回だけ次を実行する。
+
+```sh
+claude plugin marketplace add ~/.akari/kits
+claude plugin install akari-kits@akari-kits
+```
+
+`claude` が PATH に無い場合は、Claude Code のプラグイン設定で `~/.akari/kits` を marketplace として追加する。
+
 `akari` に渡した引数はそのまま `opencode` に転送する（例: `akari --continue` は
 `opencode --continue` を起動する）。
 

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.67",
+  "version": "0.1.68",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

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

@@ -13,13 +13,14 @@
     "@akari-video/render-cut": "0.0.0",
     "puppeteer-core": "25.2.1"
   },
-  "description": "@akari-video/akari-tools [akari-video npm vendor: bin/capture.mjs is reference-only; bin/media.mjs is reference-only; bin/word-book.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.]",
+  "description": "@akari-video/akari-tools [akari-video npm vendor: bin/capture.mjs is reference-only; bin/media.mjs is reference-only; bin/word-book.mjs is reference-only; bin/world.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.]",
   "akariVideoVendor": {
     "execution": "reference-only",
     "omittedBin": {
       "akari-capture": "bin/capture.mjs",
       "akari-media": "bin/media.mjs",
-      "akari-word-book": "bin/word-book.mjs"
+      "akari-word-book": "bin/word-book.mjs",
+      "akari-world": "bin/world.mjs"
     },
     "guidance": "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."
   }

package/vendor/packages/edit-lint/src/edit-lint.mjs

@@ -22,6 +22,7 @@ import { musicGrid } from "../../audio-library-setup/shared/beat-grid.mjs";
 import { resolveFfmpeg, resolveFfprobe } from "../../media-bin/src/index.mjs";
 import { buildMatcher, protectedTermsFrom } from "../../word-book/src/index.mjs";
 import { resolveWordBookSync, scanRecord } from "../../word-book/src/index.mjs";
+import { validateWorldSceneDeclaration } from "./world-scene-declaration.mjs";
 import {
   readProjectReferences,
   resolveAkariAssetsDir,
@@ -2542,6 +2543,7 @@ async function validateOverlays(overlays, timeline, findings, paths) {
       isHtmlFile ? relativePath(paths.projectRoot, htmlPath) : `${itemPath}.html`,
       findings,
     );
+    for (const finding of validateWorldSceneDeclaration(html, await readFile(join(paths.projectRoot, "planning/world-map.json"), "utf8").catch(error => error?.code === "ENOENT" ? null : Promise.reject(error)), isHtmlFile ? relativePath(paths.projectRoot, htmlPath) : `${itemPath}.html`)) addFinding(findings, finding);
     if (!isHtmlFile) continue;
 
     validateOverlayFragmentAssets(html, overlay, paths, findings);

package/vendor/packages/edit-lint/src/world-scene-declaration.mjs

@@ -0,0 +1,64 @@
+const CHECK = "overlays.world-scene-declaration";
+const isRecord = value => value !== null && typeof value === "object" && !Array.isArray(value);
+const finite = value => typeof value === "number" && Number.isFinite(value);
+const nonEmptyString = value => typeof value === "string" && value.length > 0;
+
+function finding(path, message) {
+  return { severity: "error", check: CHECK, message, path };
+}
+
+function sameIds(left, right) {
+  if (!Array.isArray(left) || !Array.isArray(right)) return false;
+  const ids = values => values.map(value => value?.id).sort();
+  return JSON.stringify(ids(left)) === JSON.stringify(ids(right));
+}
+
+function sameTimes(left, right, fields) {
+  if (!sameIds(left, right)) return false;
+  const byId = new Map(right.map(value => [value.id, value]));
+  return left.every(value => fields.every(field => {
+    const expected = byId.get(value.id)?.[field];
+    const actual = value[field];
+    return actual === expected || (actual === undefined && expected === undefined);
+  }));
+}
+
+function validateShape(value) {
+  if (!isRecord(value)) return "宣言は JSON object である必要があります";
+  const allowed = new Set(["schemaVersion", "kind", "frame", "worlds", "zones", "cameraStops", "edges", "retainedNodes", "render"]);
+  const unknown = Object.keys(value).find(key => !allowed.has(key));
+  if (unknown) return `未知のキーです: ${unknown}`;
+  if (value.schemaVersion !== 1) return "schemaVersion は 1 である必要があります";
+  if (value.kind !== "flat") return "kind は flat である必要があります";
+  if (!isRecord(value.frame) || !finite(value.frame.width) || value.frame.width <= 0 || !finite(value.frame.height) || value.frame.height <= 0) return "frame は正の width / height を持つ必要があります";
+  for (const name of ["worlds", "zones", "cameraStops", "edges", "retainedNodes"]) if (!Array.isArray(value[name])) return `${name} は配列である必要があります`;
+  if (!value.worlds.every(world => isRecord(world) && nonEmptyString(world.id) && isRecord(world.palette) && isRecord(world.flat) && Array.isArray(world.flat.bounds) && world.flat.bounds.length === 4 && world.flat.bounds.every(finite) && ["dots", "grid", "none"].includes(world.flat.pattern))) return "worlds の形が不正です";
+  if (!value.zones.every(zone => isRecord(zone) && nonEmptyString(zone.id) && nonEmptyString(zone.world) && Array.isArray(zone.c) && zone.c.length === 2 && zone.c.every(finite))) return "zones の形が不正です";
+  if (!value.cameraStops.every(stop => isRecord(stop) && nonEmptyString(stop.id) && nonEmptyString(stop.world) && finite(stop.at) && finite(stop.leave) && Array.isArray(stop.c) && stop.c.length === 3 && stop.c.every(finite))) return "cameraStops の形が不正です";
+  if (!value.edges.every(edge => isRecord(edge) && nonEmptyString(edge.id) && nonEmptyString(edge.from) && nonEmptyString(edge.to) && nonEmptyString(edge.type) && finite(edge.t0) && finite(edge.t1) && isRecord(edge.transition) && nonEmptyString(edge.transition.kind) && finite(edge.transition.cover) && (edge.switchTime === undefined || finite(edge.switchTime)))) return "edges の形が不正です";
+  if (value.render !== undefined && (!isRecord(value.render) || ["dotStep", "margin", "hazeAlpha"].some(name => value.render[name] !== undefined && !finite(value.render[name])))) return "render の形が不正です";
+  return null;
+}
+
+export function validateWorldSceneDeclaration(html, worldMapText, path) {
+  const pattern = /<script\b(?=[^>]*\btype\s*=\s*(?:"application\/json"|'application\/json'))(?=[^>]*\sdata-akari-world-scene(?=\s|=|\/?>))[^>]*>([\s\S]*?)<\/script\s*>/giu;
+  const declarations = [...html.matchAll(pattern)];
+  if (!declarations.length) return [];
+  if (declarations.length !== 1) return [finding(path, "data-akari-world-scene 宣言は 1 個である必要があります")];
+  let descriptor;
+  try { descriptor = JSON.parse(declarations[0][1]); }
+  catch (error) { return [finding(path, `宣言 JSON を読めません: ${error.message}`)]; }
+  const shapeError = validateShape(descriptor);
+  if (shapeError) return [finding(path, shapeError)];
+  if (worldMapText === null) return [];
+  let worldMap;
+  try { worldMap = JSON.parse(worldMapText); }
+  catch (error) { return [finding(path, `planning/world-map.json を読めません: ${error.message}`)]; }
+  for (const name of ["worlds", "zones", "cameraStops", "edges"]) {
+    if (!sameIds(descriptor[name], worldMap?.[name])) return [finding(path, `planning/world-map.json と ${name} の id 集合が一致しません`)];
+  }
+  if (!sameTimes(descriptor.cameraStops, worldMap.cameraStops, ["at", "leave"])) return [finding(path, "planning/world-map.json と cameraStops の時刻が一致しません")];
+  if (!sameTimes(descriptor.edges, worldMap.edges, ["t0", "t1", "switchTime"])) return [finding(path, "planning/world-map.json と edges の時刻が一致しません")];
+  const transitionTimesMatch = descriptor.edges.every(edge => worldMap.edges.find(item => item.id === edge.id)?.transition?.cover === edge.transition.cover);
+  return transitionTimesMatch ? [] : [finding(path, "planning/world-map.json と edges.transition.cover が一致しません")];
+}

package/vendor/packages/edit-store/lib/generation-meta-node.js

@@ -13,7 +13,7 @@ function readGenerationMeta(options) {
         return { state: 'none', meta: null, sidecarPath, binding: null };
     }
     const meta = parseMeta(sidecarPath);
-    const expected = bindingSha(meta);
+    const expected = (0, generation_meta_1.bindingShaFor)(meta);
     let binding = null;
     let state = (0, generation_meta_1.resolveGenerationState)(meta, options.now);
     if (expected) {
@@ -37,21 +37,12 @@ function findGenerationMetaBySha(options) {
         return null;
     for (const sidecarPath of generationSidecars(generatedRoot)) {
         const meta = parseMeta(sidecarPath);
-        const expected = bindingSha(meta);
+        const expected = (0, generation_meta_1.bindingShaFor)(meta);
         if (expected?.sha256 === options.sha256)
             return meta;
     }
     return null;
 }
-function bindingSha(meta) {
-    if (meta.status === 'done' && typeof meta.result?.sha256 === 'string') {
-        return { sha256: meta.result.sha256, source: 'result' };
-    }
-    if ((meta.kind === 'still' || meta.status === 'planned') && typeof meta.inputs?.first_frame?.sha256 === 'string') {
-        return { sha256: meta.inputs.first_frame.sha256, source: 'first_frame' };
-    }
-    return null;
-}
 function generationSidecars(directory) {
     const found = [];
     for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {

package/vendor/packages/edit-store/lib/generation-meta.d.ts

@@ -38,6 +38,10 @@ export interface ReadGenerationMetaResult {
     binding: GenerationBinding | null;
 }
 export declare function sidecarPathFor(sourcePath: string): string;
+export declare function bindingShaFor(meta: GenerationMetaV1 | null | undefined): {
+    sha256: string;
+    source: 'result' | 'first_frame';
+} | null;
 /**
  * fs に触れず、サイドカー自身が表す状態だけを解決する。
  * `job.stale_after_s` が未指定・不正な場合は既定 900 秒を使う。

package/vendor/packages/edit-store/lib/generation-meta.js

@@ -6,10 +6,21 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sidecarPathFor = sidecarPathFor;
+exports.bindingShaFor = bindingShaFor;
 exports.resolveGenerationState = resolveGenerationState;
 function sidecarPathFor(sourcePath) {
     return `${sourcePath}.meta.json`;
 }
+function bindingShaFor(meta) {
+    if (meta?.status === 'done' && typeof meta.result?.sha256 === 'string') {
+        return { sha256: meta.result.sha256, source: 'result' };
+    }
+    if ((meta?.kind === 'still' || meta?.status === 'planned')
+        && typeof meta.inputs?.first_frame?.sha256 === 'string') {
+        return { sha256: meta.inputs.first_frame.sha256, source: 'first_frame' };
+    }
+    return null;
+}
 /**
  * fs に触れず、サイドカー自身が表す状態だけを解決する。
  * `job.stale_after_s` が未指定・不正な場合は既定 900 秒を使う。

package/vendor/packages/generate/README.md

@@ -13,6 +13,6 @@ A model without recorded pricing remains valid and returns `cost.needs_explicit_
 
 `akari generate still <projectDir> --spec beats.json` はビートごとの静止画を Codex で生成します。
 `--parallel N` で並列数を指定でき、既定は 4 です。
-`--placeholder` は Codex を呼ばず、無料の文字カード PNG を置きます。
+`--placeholder` は Codex を呼ばず、Chrome → ffmpeg drawtext → 単色の順で無料の文字カード PNG を置きます。
 `--dry-run` は edit.json や素材を書かず、配置予定だけを表示します。
 生成物と meta は `assets/generated/`、クリップは edit.json v2 の visual トラック末尾に入ります。

package/vendor/packages/overlay-runtime/README.md

@@ -623,6 +623,24 @@ npm グローバルインストール禁止の制約内で完結するよう、
 `prepare` を指定したランタイムは seek ごとにそのメソッドを await し、render 直後に ready を確認する。
 この場合、t=0 の事前描画と ready ポーリングは生成しない。
 
+## Canvas 2D ワールドランタイム
+
+`src/world-runtime.js` は `<script type="application/json" data-akari-world-scene>` を持つ
+`kind: "flat"` 断片を描く。宣言は `schemaVersion: 1`、出力枠 `frame`、および
+`worlds` / `zones` / `cameraStops` / `edges` / `retainedNodes` を持つ。任意の `render` は
+`dotStep: 90`、`margin: 0.25`、`hazeAlpha: 0.92` を既定値とする。
+
+registry は `world-camera.js`、`world-runtime.js` の順で読み込む。前者は
+`packages/akari-tools/src/world/camera.mjs` から `npm run gen:world-camera` で生成した classic script
+で、`npm run check:world-camera` が正本とのドリフトを検査する。
+
+ランタイムは Canvas に背景・遠景・格子・portal 枠・遷移 cover を描き、同じ `camera(seconds)`
+から断片直下の `.akari-world-sheet[data-world]` の transform と
+`.akari-world-zone[data-zone]` の画面外カリングを同期する。描画は外部時刻だけに依存する。
+俯瞰は公開 API `worldRuntime.drawOverview(ctx, descriptor, { scale, ox, oy }, seconds, options)` を使い、
+`view` はカメラ位置に依存しない world → screen の affine（`screen = ox + p * scale`）として扱う。
+`options.frame: true` で現在の撮影枠を重ねられる。
+
 ## vgpu vendor の固定と再生成
 
 `src/vendor/vgpu-bundle.js` は `vgpu@0.4.0` の browser entry を `esbuild@0.24.2` で

package/vendor/packages/overlay-runtime/package.json

@@ -11,6 +11,8 @@
     "README.md"
   ],
   "scripts": {
+    "gen:world-camera": "node scripts/gen-world-camera.mjs",
+    "check:world-camera": "node scripts/gen-world-camera.mjs --check",
     "check": "node --check src/parts.mjs && node --check src/vendor/three-bundle.js && node --check src/vendor/vendor-3d-text-bundle.js && node --check src/three-runtime.js && node --check src/slot-params.js && node --check src/video-fx.js && node --check src/viewport-units.js && node --check src/vendor/budoux-ja-bundle.js && node --check src/text-split.js && node --check src/overlay-runtime.js && node --check src/interaction.js && node --check src/minimap.js",
     "test": "node --test test-harness/*.test.mjs"
   }

package/vendor/packages/project-scaffold/src/index.mjs

@@ -1,6 +1,7 @@
 import { execFile } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import fs from 'node:fs/promises';
+import { homedir } from 'node:os';
 import path from 'node:path';
 import { promisify } from 'node:util';
 
@@ -341,15 +342,25 @@ export async function installProjectSkills(destinationDir, skillsSourceDir, sche
 }
 
 export async function installSkillAdapters(destinationDir, options = {}) {
-    const { fsImpl = fs, platform = process.platform } = options;
+    const { fsImpl = fs, platform = process.platform, env = process.env } = options;
     const skillsDir = path.join(destinationDir, '.claude', 'skills');
     const skillNames = (await fsImpl.readdir(skillsDir, { withFileTypes: true }))
         .filter(entry => entry.isDirectory())
         .map(entry => entry.name);
+    const kitSkillsDir = path.join(env.AKARI_HOME || path.join(homedir(), '.akari'), 'kits', 'plugin', 'skills');
+    let kitSkillNames = [];
+    try {
+        kitSkillNames = (await fsImpl.readdir(kitSkillsDir, { withFileTypes: true }))
+            .filter(entry => entry.isDirectory() || entry.isSymbolicLink())
+            .map(entry => entry.name);
+    } catch (error) {
+        if (!error || typeof error !== 'object' || error.code !== 'ENOENT') throw error;
+    }
 
     const created = [];
     const skippedExisting = [];
     const degraded = [];
+    const warnings = [];
     for (const adapter of SKILL_ADAPTER_DIRECTORIES) {
         const adapterDir = path.join(destinationDir, adapter, 'skills');
         await fsImpl.mkdir(adapterDir, { recursive: true });
@@ -372,8 +383,27 @@ export async function installSkillAdapters(destinationDir, options = {}) {
                 skippedExisting.push(relativeName);
             }
         }
+        for (const name of kitSkillNames) {
+            const relativeName = `${adapter}/skills/${name}`;
+            if (skillNames.includes(name)) {
+                warnings.push(`${relativeName}: 純正スキルを優先し、同名の拡張キットスキルをスキップしました`);
+                continue;
+            }
+            try {
+                const { method } = await createSkillAdapterLink(
+                    path.relative(adapterDir, path.join(kitSkillsDir, name)),
+                    path.join(adapterDir, name),
+                    { fsImpl, platform }
+                );
+                created.push(relativeName);
+                if (method !== 'symlink') degraded.push({ name: relativeName, method });
+            } catch (error) {
+                if (!isAlreadyExists(error)) throw error;
+                skippedExisting.push(relativeName);
+            }
+        }
     }
-    return { created, skippedExisting, degraded };
+    return { created, skippedExisting, degraded, warnings };
 }
 
 export async function readSkillsVersion(destinationDir) {
@@ -517,7 +547,7 @@ export async function createProject(destinationDir, templateDir, options = {}) {
     const fallback = await writeFallbackTemplate(destination);
     if (options.skillsSourceDir) {
         await installProjectSkills(destination, options.skillsSourceDir, options.schemasSourceDir);
-        await installSkillAdapters(destination);
+        await installSkillAdapters(destination, { env: options.env });
     }
     const skillsVersion = await readSkillsVersion(destination);
     const boundary = await checkGitBoundary(destination);

package/vendor/packages/project-scaffold/test/kit-skill-adapter.test.mjs

@@ -0,0 +1,38 @@
+import assert from 'node:assert/strict';
+import { mkdir, mkdtemp, readlink, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+
+import { installSkillAdapters } from '../src/index.mjs';
+
+test('installSkillAdapters: kits の skill を全アダプタへ合成し、重複は純正を優先する', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'akari-project-kit-adapter-test-'));
+  const home = await mkdtemp(path.join(tmpdir(), 'akari-home-kit-adapter-test-'));
+  try {
+    await mkdir(path.join(root, '.claude', 'skills', 'official'), { recursive: true });
+    await writeFile(path.join(root, '.claude', 'skills', 'official', 'SKILL.md'), '# official\n');
+    const kitSkills = path.join(home, 'kits', 'plugin', 'skills');
+    await mkdir(path.join(kitSkills, 'kit-only'), { recursive: true });
+    await mkdir(path.join(kitSkills, 'official'), { recursive: true });
+
+    const report = await installSkillAdapters(root, { env: { AKARI_HOME: home } });
+    for (const adapter of ['.agents', '.codex', '.cursor', '.opencode']) {
+      const kitLink = path.join(root, adapter, 'skills', 'kit-only');
+      assert.equal(
+        path.resolve(path.dirname(kitLink), await readlink(kitLink)),
+        path.join(kitSkills, 'kit-only')
+      );
+      const officialLink = path.join(root, adapter, 'skills', 'official');
+      assert.equal(
+        path.resolve(path.dirname(officialLink), await readlink(officialLink)),
+        path.join(root, '.claude', 'skills', 'official')
+      );
+    }
+    assert.equal(report.warnings.length, 4);
+    assert.ok(report.warnings.every((line) => line.includes('純正スキルを優先')));
+  } finally {
+    await rm(root, { recursive: true, force: true });
+    await rm(home, { recursive: true, force: true });
+  }
+});

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

@@ -39,6 +39,7 @@ description: AKARI Video のオーバーレイ HTML、字幕、表・グラフ
 - 表・グラフの HTML/CSS 構成とアニメーション: [table.md](table.md)
 - Three.js + glTF、動画テクスチャ、3D 性能: [3d.md](3d.md)。端末の画面・キーの生成や反射調整は [device-materials.md](device-materials.md) も読む。
 - ガラス屈折の宣言、入れ子、ツマミ、静止背景: [glass.md](glass.md)
+- Canvas 2D 世界、DOM シート同期、俯瞰: [world.md](world.md)
 - 新しい描画の種類は `packages/overlay-runtime/runtimes.mjs` のマニフェストへ登録する（追加手順: `packages/overlay-runtime/README.md`）。
 - 決定的モーション、イージング、compositor 制約: [motion.md](motion.md)
 - サムネイルの型、デザイン語彙、生成経路、HTML スクショ: [thumbnail.md](thumbnail.md)

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

@@ -0,0 +1,42 @@
+# Canvas 2D ワールド
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる。
+
+`kind: "flat"` の世界は、断片内の Canvas 背景と DOM 素材を同じ純粋な `camera(t)` で動かす。
+断片は単一ルートを守り、その中に宣言を 1 個置く。
+
+```html
+<div class="world-fragment">
+  <div class="akari-world-sheet" data-world="paper">
+    <div class="akari-world-zone" data-zone="desk" style="left:10px;top:12px">
+      <!-- 素材・テロップ -->
+    </div>
+  </div>
+  <script type="application/json" data-akari-world-scene>{
+    "schemaVersion": 1,
+    "kind": "flat",
+    "frame": { "width": 1920, "height": 1080 },
+    "worlds": [], "zones": [], "cameraStops": [], "edges": [], "retainedNodes": [],
+    "render": { "dotStep": 90, "margin": 0.25, "hazeAlpha": 0.92 }
+  }</script>
+</div>
+```
+
+`worlds` / `zones` / `cameraStops` / `edges` / `retainedNodes` は `planning/world-map.json`
+から `inventory` を除いて写す。`worlds[].flat` は `bounds`、`pattern`（`dots` / `grid` /
+`none`）、任意の遠景 `far: [{ z, color }]` を持ち、`palette` は `background` / `dots` /
+`accent` と任意の `haze` を持つ。
+
+各 world に対応する `.akari-world-sheet[data-world]` を断片直下へ置く。zone は world の
+`bounds` 原点基準の px で配置し、`.akari-world-zone[data-zone]` を付ける。ランタイムが毎 tick
+書くのは sheet の `transform` / `transform-origin` と zone の画面外カリング用 `display` だけで、
+素材やテロップの中身には触れない。
+
+時刻は `render(container, seconds)` からだけ受け取り、乱数・壁時計・delta 積算を使わない。
+同じ宣言と seconds は Canvas、DOM transform、カリングの同じ結果を返す。cut / portal の
+`switchTime ± transition.cover / 2` は一様な haze で覆う。
+
+俯瞰は `window.akari.worldRuntime.drawOverview(ctx, descriptor, view, seconds, options)` を使う。
+`view` はカメラ位置に依存しない world → screen の affine `{ scale, ox, oy }`
+（`screen = ox + p * scale`）。`options.frame === true` なら現在の撮影枠を `#EE82DF` で重ねる。
+独自の地図描画を複製しない。

package/vendor/skills/render-cut/SKILL.md

@@ -87,7 +87,7 @@ node の解決順は `AKARI_NODE_BIN` → PATH の node（20 以上）→ 同梱
 タイムラインの初回確認にだけ、次のコマンドで L1 通しマップを作る。
 
 ```sh
-node packages/decision-cards/render-storyboard-print.mjs <project-root>
+akari storyboard <project-root>
 ```
 
 置き場は `<project>/.akari/reports/storyboard/`。絵コンテは初回だけ作り、タイムライン変更に合わせて