akari-video 0.1.67 → 0.1.69

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.69",
   "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,79 @@
+# 設計契約 — 拡張キット 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` を直接読める。
+
+## 5. アプリ（ホームの拡張キットカード）
+
+ホームの AKARI Store カードの隣に拡張キットカードを 1 枚出し、未接続では出さず、導入済みは id・version・スキル名・素材数の一覧と未有効化時の有効化案内、購入済み・未導入は `akari store install <id>` の案内、未購入は教材の引換ページの案内、という 3 状態とする（アプリはコマンドを実行せず、コピーと外部ブラウザ起動だけを行う）。
+
+## 6. 更新と版
+
+キットの版は Store の整数版とする。`akari store status` が導入済みの id、version、スキル名、素材数を表示し、同じ `akari store install` で新版へ置換する。