akari-video 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # akari-launcher（`akari` コマンド）
 
-「UI に依存したくない。Claude Code 単体でも、どんなディレクトリでも始められるように」を
+「UI に依存したくない。opencode 単体でも、どんなディレクトリでも始められるように」を
 実現する薄いラッパー CLI。npm パッケージ名は `akari-video`、提供するコマンド名は `akari`
 （npm の `akari` は別プロダクトが取得済みのため。オーナー裁定 2026-07-21 §8-2）。
 
@@ -21,12 +21,12 @@ akari
   │     .akari/connections.json の doctor ブロックを更新・表示する
   │     （キーの値は一切表示しない）
   │
-  └─ 4. 最後に claude を exec する
-        （PATH に claude が無ければ、インストール案内を出して終了する）
+  └─ 4. 最後に opencode を exec する
+        （PATH に opencode が無ければ、インストール案内を出して終了する）
 ```
 
-`akari` に渡した引数はそのまま `claude` に転送する（例: `akari --continue` は
-`claude --continue` を起動する）。
+`akari` に渡した引数はそのまま `opencode` に転送する（例: `akari --continue` は
+`opencode --continue` を起動する）。
 
 ## 3 入口の対応表
 
@@ -35,23 +35,29 @@ AKARI Video は「同じファイル契約（`.akari/` 配下の JSON）に収
 
 | 入口 | 実体 | 発動方法 |
 |---|---|---|
-| ターミナル | この `akari` ランチャー CLI | シェルで `akari` と打つ（`npm i -g akari-video` または `npx akari-video` 相当。器のみ、npm publish は本タスクのスコープ外） |
-| セッション内 | プラグインの `/akari` スラッシュコマンド、または発話 | Claude Code セッション内で `/akari` と打つ、または普通に話しかけて `create-project` スキルを発動させる |
+| ターミナル | この `akari` ランチャー CLI | `npm i -g akari-video` で導入し、シェルで `akari`（または `akari --opencode`）と打つ |
+| セッション内 | opencode スキルの自動発見、またはプラグインの `/akari` スラッシュコマンド | opencode セッション内で「新しい動画プロジェクトを作りたい」と発話、または Claude Code セッション内で `/akari` と打つ |
 | アプリ | 接続ボタン（AKARI Video アプリ） | アプリの「はじめる」画面から接続 → はじめかた選択 |
 
 3 つとも最終的に同じもの（`.akari/connections.json` / `.akari/intake.json` /
 `skills/create-project`）を読み書きするため、どの入口から始めても続きは他の入口から
 再開できる。
 
-## インストール（現状の到達点）
+## インストール
 
-npm publish は本タスクのスコープ外（「器まで」）。現状は次のいずれかで実行できる:
+npm publish 済み（v0.1.0 から・provenance 付き）。npm 版はランチャー + エージェント
+ワークフロー（skills / 雛形 / schemas を vendor 同梱）のみで、ブラウザプレビュー
+（`packages/preview-server`）は含まない。フル構成はリポジトリのインストーラー
+（`install.sh` — リリースタグ固定配布）を使う。実行方法:
 
 ```sh
-# モノレポ checkout 内から、bin を直接実行する
+# モノレポ checkout 内から、bin を直接実行する（opencode モード）
+node packages/akari-launcher/bin/akari.mjs --opencode
+
+# Claude Code モード
 node packages/akari-launcher/bin/akari.mjs
 
-# 将来 npm publish された場合の想定コマンド（現状は publish していないため未検証）
+# 既定の導入（npm publish 済み）
 npm i -g akari-video && akari
 npx akari-video
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "akari-video",
-  "version": "0.1.0",
-  "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code. AKARI Video を Claude Code 単体・どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → `claude` を起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
+  "version": "0.1.2",
+  "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": {
     "akari": "bin/akari.mjs"

package/src/cli.mjs

@@ -4,9 +4,9 @@ import { pathToFileURL } from 'node:url';
 
 import { resolveLauncherAssets } from './repo-assets.mjs';
 import { detectProjectState } from './project-state.mjs';
-import { findClaudeExecutable } from './path-lookup.mjs';
+import { findClaudeExecutable, findOpencodeExecutable } from './path-lookup.mjs';
 import { loadTaskLabels } from './task-labels.mjs';
-import { describeIntake, claudeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
+import { describeIntake, claudeMissingGuidance, opencodeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
 import {
   checkForUpdateSync,
   readCacheSync,
@@ -31,9 +31,16 @@ export async function run(args, options = {}) {
   const scaffold = options.scaffold ?? defaultScaffold;
   const runDoctor = options.runDoctor ?? defaultRunDoctor;
   const resolveClaude = options.resolveClaude ?? (() => findClaudeExecutable());
+  const resolveOpencode = options.resolveOpencode ?? (() => findOpencodeExecutable());
   const spawnClaude = options.spawnClaude ?? defaultSpawnClaude;
+  const spawnOpencode = options.spawnOpencode ?? defaultSpawnOpencode;
   const env = options.env ?? process.env;
   const currentVersion = options.currentVersion ?? readOwnVersion();
+  
+  // --opencode / --claude / --claudecode / --yes フラグを解析
+  const useOpencode = args.includes('--opencode');
+  const autoConfirm = args.includes('--yes') || args.includes('-y');
+  const filteredArgs = args.filter(arg => arg !== '--opencode' && arg !== '--claude' && arg !== '--claudecode' && arg !== '--yes' && arg !== '-y');
 
   let state = detectProjectState(projectRoot);
 
@@ -78,16 +85,40 @@ export async function run(args, options = {}) {
   }
   (options.refreshUpdate ?? triggerBackgroundRefresh)({ env });
 
-  log('Claude Code を起動します…');
-  const claudePath = resolveClaude();
-  if (!claudePath) {
-    log(claudeMissingGuidance());
-    return { exitCode: 1, scaffolded: state.scaffolded, claudeLaunched: false };
-  }
+  if (useOpencode) {
+    log('opencode を起動します…');
+    const opencodePath = resolveOpencode();
+    if (!opencodePath) {
+      log(opencodeMissingGuidance());
+      return { exitCode: 1, scaffolded: state.scaffolded, opencodeLaunched: false };
+    }
+
+    const opencodeArgs = autoConfirm ? ['--auto', ...filteredArgs] : filteredArgs;
+    const result = spawnOpencode(opencodePath, opencodeArgs, projectRoot);
+    const exitCode = typeof result.status === 'number' ? result.status : (result.error ? 1 : 0);
+    return { exitCode, scaffolded: state.scaffolded, opencodeLaunched: true };
+  } else {
+    const claudePath = resolveClaude();
+    if (claudePath) {
+      log('Claude Code を起動します…');
+      const claudeArgs = autoConfirm ? ['--permission-mode', 'acceptEdits', ...filteredArgs] : filteredArgs;
+      const result = spawnClaude(claudePath, claudeArgs, projectRoot);
+      const exitCode = typeof result.status === 'number' ? result.status : (result.error ? 1 : 0);
+      return { exitCode, scaffolded: state.scaffolded, claudeLaunched: true };
+    }
 
-  const result = spawnClaude(claudePath, args, projectRoot);
-  const exitCode = typeof result.status === 'number' ? result.status : (result.error ? 1 : 0);
-  return { exitCode, scaffolded: state.scaffolded, claudeLaunched: true };
+    log('Claude Code が見つかりません。opencode を起動します…');
+    const opencodePath = resolveOpencode();
+    if (!opencodePath) {
+      log(claudeMissingGuidance());
+      return { exitCode: 1, scaffolded: state.scaffolded, opencodeLaunched: false };
+    }
+
+    const opencodeArgs = autoConfirm ? ['--auto', ...filteredArgs] : filteredArgs;
+    const result = spawnOpencode(opencodePath, opencodeArgs, projectRoot);
+    const exitCode = typeof result.status === 'number' ? result.status : (result.error ? 1 : 0);
+    return { exitCode, scaffolded: state.scaffolded, opencodeLaunched: true };
+  }
 }
 
 async function defaultScaffold(projectRoot, assets) {
@@ -111,6 +142,10 @@ function defaultSpawnClaude(claudePath, args, projectRoot) {
   return spawnSync(claudePath, args, { stdio: 'inherit', cwd: projectRoot });
 }
 
+function defaultSpawnOpencode(opencodePath, args, projectRoot) {
+  return spawnSync(opencodePath, args, { stdio: 'inherit', cwd: projectRoot });
+}
+
 /**
  * `akari update`: 現在版・最新版・リリースノート URL を表示し、更新手順を**案内するだけ**
  * （自動実行はしない — 契約 §4-1）。`--dismiss` を渡すと、キャッシュに載っている最新版の

package/src/messages.mjs

@@ -45,6 +45,14 @@ export function claudeMissingGuidance() {
   ].join('\n');
 }
 
+export function opencodeMissingGuidance() {
+  return [
+    'opencode コマンドが見つかりませんでした。',
+    'opencode をインストールしてください: npm install -g opencode',
+    'インストール後、このフォルダーで再度 `akari --opencode` を実行してください。'
+  ].join('\n');
+}
+
 /**
  * `akari` 起動時、claude 起動直前に出す 1 行通知（契約 §4-1）。
  * `checkForUpdateSync` が返す状態から組み立てる。新版が無ければ null。

package/src/path-lookup.mjs

@@ -45,3 +45,26 @@ export function findClaudeExecutable(pathEnv = process.env.PATH ?? '', platform
   }
   return null;
 }
+
+/**
+ * PATH 上に `opencode` 実行ファイルがあるかを探す。`findClaudeExecutable` と同じ規約。
+ */
+export function findOpencodeExecutable(pathEnv = process.env.PATH ?? '', platform = process.platform, pathExt = process.env.PATHEXT) {
+  const directories = pathEnv.split(path.delimiter).filter(Boolean);
+  const candidateNames = platform === 'win32'
+    ? resolveWindowsExtensions(pathExt).map((extension) => `opencode${extension.toLowerCase()}`)
+    : ['opencode'];
+
+  for (const directory of directories) {
+    for (const name of candidateNames) {
+      const candidate = path.join(directory, name);
+      try {
+        accessSync(candidate, fsConstants.X_OK);
+        return candidate;
+      } catch {
+        // このディレクトリには無い。次を探す。
+      }
+    }
+  }
+  return null;
+}

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

@@ -29,7 +29,7 @@ const FALLBACK_CLAUDE_GUIDANCE = [
     '- `.akari/sidecars/` は分析結果、`.akari/events/` は作業の節目の記録を置く場所です。',
     '- 節目の記録は 1 件ずつ新しく追加し、すでにある記録は変更しません。',
     '- 編集スキルは `.claude/skills/` にあり、`/analyze-footage` などの素の名前で使えます。',
-    '- Codex など他の AI エージェント用の入り口が `.agents/skills/` と `.codex/skills/` にあります（中身は `.claude/skills/` へのリンク）。',
+    '- Codex や Cursor など他の AI エージェント用の入り口が `.agents/skills/`、`.cursor/skills/`、`.codex/skills/` にあります（中身は `.claude/skills/` へのリンク）。',
     '- `.akari/intake.json` の `status` が `submitted` なら、そこに書かれた `tasks` / `target` / `autonomy` に従って進めます。`autonomy` が `checkpoint`（既定）なら、企画の承認や書き出し前などの要所で必ず人に確認します。`status` が `draft` のときは進め方がまだ決まっていないので、フォームや対話で確定させてから作業を始めます。',
     '- 利用者へは日本語で、内部の仕組みではなく「変更履歴」「企画メモ」「素材」などの言葉で説明します。',
     '',
@@ -46,7 +46,7 @@ const FALLBACK_AGENT_GUIDANCE = [
     'スキルは `/analyze-footage`、`/edit-plan`、`/overlay-authoring`、`/setup-library`、',
     '`/harvest-asset`、`/bake-3d` の素の名前で使う。手順を直接読む場合は',
     '`.claude/skills/<スキル名>/SKILL.md` を開く。',
-    'Codex 等のハーネスでは `.agents/skills/` / `.codex/skills/`（`.claude/skills/` への',
+    'Codex / Cursor 等のハーネスでは `.agents/skills/` / `.cursor/skills/` / `.codex/skills/`（`.claude/skills/` への',
     'symlink）から同じスキルが自動発見される。',
     '',
     '`.akari/intake.json` の `status` が `submitted` なら `tasks` / `target` / `autonomy` に従って進める。',
@@ -63,7 +63,7 @@ const FALLBACK_SKILLS_GUIDANCE = [
     '',
     '6 本の編集スキルはこのフォルダーに実体で入り、素の名前で使えます。',
     '各手順は `.claude/skills/<スキル名>/SKILL.md` から直接読めます。',
-    '`.agents/skills/` と `.codex/skills/` は他の AI エージェント用の入り口で、この実体への symlink です。',
+    '`.agents/skills/`、`.cursor/skills/`、`.codex/skills/` は他の AI エージェント用の入り口で、この実体への symlink です。',
     '`AKARI-SKILLS-VERSION` はプロジェクト作成時のスキル内容を示します。',
     'この案内と各スキルは、運用に合わせて自由に書き換えて構いません。',
     ''
@@ -88,7 +88,7 @@ const FALLBACK_WORKFLOW = {
         { path: 'exports', label: '書き出し', kind: 'exports' }
     ],
     tree: {
-        hidden: ['.claude', '.agents', '.codex', '.akari', 'CLAUDE.md', 'AGENTS.md', '.gitignore', '.gitkeep'],
+        hidden: ['.claude', '.agents', '.codex', '.cursor', '.akari', 'CLAUDE.md', 'AGENTS.md', '.gitignore', '.gitkeep'],
         sidecarSuffixes: ['.meta.json', '.decisions.json', '.analysis.json'],
         developerModePreference: 'akari.developerMode'
     },
@@ -164,6 +164,22 @@ export async function writeFallbackTemplate(destinationDir) {
             }
         }, null, 2) + '\n',
         '.claude/skills/README.md': FALLBACK_SKILLS_GUIDANCE,
+        '.opencode/config.json': JSON.stringify({
+            name: "AKARI Video Project",
+            version: "1.0.0",
+            description: "AKARI Video プロジェクト設定",
+            skills: {
+                autoDiscover: true,
+                path: "./skills"
+            },
+            hooks: {
+                sessionStart: "./hooks/session-start.mjs"
+            },
+            project: {
+                type: "akari-video",
+                version: "0.1.0"
+            }
+        }, null, 2) + '\n',
         '.akari/workflow.json': JSON.stringify(FALLBACK_WORKFLOW, null, 2) + '\n',
         '.akari/intake.json': JSON.stringify(FALLBACK_INTAKE, null, 2) + '\n',
         'assets/.gitkeep': '',
@@ -191,7 +207,7 @@ export async function writeFallbackTemplate(destinationDir) {
     return { writtenFiles, skippedExisting };
 }
 
-const SKILL_ADAPTER_DIRECTORIES = ['.agents', '.codex'];
+const SKILL_ADAPTER_DIRECTORIES = ['.agents', '.codex', '.cursor', '.opencode'];
 
 function isPermissionDenied(error) {
     return error && typeof error === 'object' && (error.code === 'EPERM' || error.code === 'EACCES');

package/vendor/packages/project-scaffold/test/opencode-scaffold.test.mjs

@@ -0,0 +1,94 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, readFile, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import test from "node:test";
+
+import { createProject } from "../src/index.mjs";
+
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+const repoRoot = join(packageRoot, "..", "..");
+
+async function withScratchRoot(callback) {
+  const root = await mkdtemp(join(tmpdir(), "akari-scaffold-opencode-test-"));
+  try {
+    return await callback(root);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+}
+
+test("opencode 対応: .opencode/config.json が生成される", async () => {
+  await withScratchRoot(async (root) => {
+    const templateDir = join(repoRoot, "templates", "project-default");
+    const destination = join(root, "project");
+
+    const report = await createProject(destination, templateDir);
+
+    const configPath = join(destination, ".opencode", "config.json");
+    assert.ok((await stat(configPath)).isFile());
+
+    const config = JSON.parse(await readFile(configPath, "utf8"));
+    assert.equal(config.name, "AKARI Video Project");
+    assert.equal(config.project.type, "akari-video");
+    assert.ok(config.skills.autoDiscover);
+    assert.equal(config.skills.path, "./skills");
+    assert.equal(config.hooks.sessionStart, "./hooks/session-start.mjs");
+  });
+});
+
+test("opencode 対応: .opencode/skills/ にスキル定義ファイルが生成される", async () => {
+  await withScratchRoot(async (root) => {
+    const templateDir = join(repoRoot, "templates", "project-default");
+    const destination = join(root, "project");
+
+    await createProject(destination, templateDir);
+
+    const skillsDir = join(destination, ".opencode", "skills");
+    assert.ok((await stat(skillsDir)).isDirectory());
+
+    // スキル定義ファイルが存在することを確認
+    const analyzeFootage = join(skillsDir, "analyze-footage.yml");
+    const editPlan = join(skillsDir, "edit-plan.yml");
+    const createProjectSkill = join(skillsDir, "create-project.yml");
+
+    assert.ok((await stat(analyzeFootage)).isFile());
+    assert.ok((await stat(editPlan)).isFile());
+    assert.ok((await stat(createProjectSkill)).isFile());
+  });
+});
+
+test("opencode 対応: .opencode/hooks/session-start.mjs が生成される", async () => {
+  await withScratchRoot(async (root) => {
+    const templateDir = join(repoRoot, "templates", "project-default");
+    const destination = join(root, "project");
+
+    await createProject(destination, templateDir);
+
+    const hookPath = join(destination, ".opencode", "hooks", "session-start.mjs");
+    assert.ok((await stat(hookPath)).isFile());
+
+    const hookContent = await readFile(hookPath, "utf8");
+    assert.ok(hookContent.includes("SessionStart"));
+    assert.ok(hookContent.includes(".akari"));
+  });
+});
+
+test("opencode 対応: .opencode/skills/ にアダプタリンクが作成される", async () => {
+  await withScratchRoot(async (root) => {
+    const templateDir = join(repoRoot, "templates", "project-default");
+    const destination = join(root, "project");
+    const skillsSourceDir = join(repoRoot, "skills");
+
+    await createProject(destination, templateDir, { skillsSourceDir });
+
+    // .opencode/skills/ にスキルディレクトリが存在することを確認
+    const opencodeSkillsDir = join(destination, ".opencode", "skills");
+    assert.ok((await stat(opencodeSkillsDir)).isDirectory());
+
+    // スキルディレクトリに至少 1 つのスキルがあることを確認
+    const entries = await import("node:fs/promises").then(fs => fs.readdir(opencodeSkillsDir));
+    assert.ok(entries.length > 0, ".opencode/skills/ にスキルが至少 1 つ存在すること");
+  });
+});

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

@@ -180,10 +180,12 @@ test("installSkillAdapters: on win32 with symlink EPERM, all adapters degrade to
 
     assert.deepEqual(report.created.sort(), [
       ".agents/skills/analyze-footage",
-      ".codex/skills/analyze-footage"
+      ".codex/skills/analyze-footage",
+      ".cursor/skills/analyze-footage",
+      ".opencode/skills/analyze-footage"
     ]);
     assert.deepEqual(report.skippedExisting, []);
-    assert.equal(report.degraded.length, 2);
+    assert.equal(report.degraded.length, 4);
     assert.ok(report.degraded.every((entry) => entry.method === "junction"));
   });
 });
@@ -197,7 +199,9 @@ test("installSkillAdapters: real fs on the current platform still creates plain
 
     assert.deepEqual(report.created.sort(), [
       ".agents/skills/analyze-footage",
-      ".codex/skills/analyze-footage"
+      ".codex/skills/analyze-footage",
+      ".cursor/skills/analyze-footage",
+      ".opencode/skills/analyze-footage"
     ]);
     assert.deepEqual(report.degraded, []);
   });

package/vendor/packages/schemas/asset-meta.schema.json

@@ -27,7 +27,8 @@
     },
     "category": {
       "type": "string",
-      "enum": ["3d", "motion", "telop", "audio", "broll", "font", "thumbnail"]
+      "$comment": "2026-07-29 に主題（3d/motion/telop/thumbnail…）から配布物の形へ切り替えた。overlay=時間を持つ HTML 断片 / still=時間を持たない HTML シート / scene3d=glTF+Three.js またはベイクレシピ / audio=音声トラックに載るバイナリ / broll=映像トラックに載る実写バイナリ / font=書体バイナリ。主題は tags に逃がす（カテゴリを増やさない）。",
+      "enum": ["overlay", "still", "scene3d", "audio", "broll", "font"]
     },
     "title": {
       "type": "string",
@@ -94,6 +95,16 @@
       "$comment": "drop-folder タイトル正規化照合の来歴フィールド（2026-07-22 導入）。将来の照合経路追加時は enum を拡張する。",
       "enum": ["title-normalized"]
     },
+    "version": {
+      "$comment": "素材の版（2026-07-30 導入。data-contract-versioning 契約 §3 の宿題を果たすもの）。初版は 1。ツマミの削除・改名・type/unit 変更・範囲の縮小、クラス構造やスロットの変更は破壊的変更として bump する。ラベル・説明・tags・ai_usage の更新では上げない。harness/knob-diff.mjs が bump 漏れを検出する。",
+      "type": "integer",
+      "minimum": 1
+    },
+    "min_app_version": {
+      "$comment": "この素材が要求する AKARI Video の最低版（任意）。古い版で開いたら推測せず正直に止まるための宣言（versioning 契約 原則 3 と同型）。特定版を要求しない素材では省略する。",
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
     "remote": {
       "type": "boolean",
       "description": "true の場合、このエントリはカタログ上のみに存在し実体ファイルを持たない。source ブロックが実体の代わりになる（2026-07-14 追記・任意フィールド）。"

package/vendor/packages/schemas/bin/validate-asset.mjs

@@ -6,7 +6,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-const usage = "使い方: node packages/schemas/bin/validate-asset.mjs assets/telop/<id>";
+const usage = "使い方: node packages/schemas/bin/validate-asset.mjs assets/overlay/<id>";
 const assetArgument = process.argv[2];
 
 if (!assetArgument || process.argv.length !== 3) {
@@ -68,9 +68,9 @@ function validateMeta(value) {
     "license",
     "price",
   ];
-  // source / remote / matched_by は任意フィールド。
-  // 後方互換のため必須フィールドには加えない。
-  const optionalFields = ["source", "remote", "matched_by"];
+  // source / remote / matched_by / version / min_app_version は任意フィールド。
+  // 後方互換のため必須フィールドには加えない（version は 2026-07-30 導入で、既存エントリは未設定）。
+  const optionalFields = ["source", "remote", "matched_by", "version", "min_app_version"];
   const allowedFields = [...requiredFields, ...optionalFields];
   for (const field of requiredFields) {
     if (!hasOwn(value, field)) fail(`必須フィールドがありません: ${field}`);
@@ -84,9 +84,10 @@ function validateMeta(value) {
     fail("id は英小文字・数字の kebab-case である必要があります");
   }
 
-  const categories = new Set(["3d", "motion", "telop", "audio", "broll", "font", "thumbnail"]);
+  // 2026-07-29: 主題（3d/motion/telop/thumbnail）から配布物の形へ切り替え。主題は tags に逃がす。
+  const categories = new Set(["overlay", "still", "scene3d", "audio", "broll", "font"]);
   if (typeof value.category !== "string" || !categories.has(value.category)) {
-    fail("category は 3d / motion / telop / audio / broll / font / thumbnail のいずれかである必要があります");
+    fail("category は overlay / still / scene3d / audio / broll / font のいずれかである必要があります");
   }
 
   for (const field of ["title", "description", "when_to_use", "ai_usage", "author"]) {
@@ -103,6 +104,16 @@ function validateMeta(value) {
     fail("price は null または 0 以上の有限数である必要があります");
   }
 
+  if (hasOwn(value, "version")) {
+    if (!Number.isInteger(value.version) || value.version < 1) {
+      fail("version は 1 以上の整数である必要があります");
+    }
+  }
+
+  if (hasOwn(value, "min_app_version") && !/^\d+\.\d+\.\d+$/.test(String(value.min_app_version))) {
+    fail("min_app_version は x.y.z 形式である必要があります");
+  }
+
   const matchedByValues = new Set(["title-normalized"]);
   if (hasOwn(value, "matched_by") && !matchedByValues.has(value.matched_by)) {
     fail(`matched_by は ${[...matchedByValues].join(" / ")} のいずれかである必要があります`);
@@ -331,23 +342,23 @@ function validateFiles() {
   }
 
   const category = path.basename(path.dirname(assetDir));
-  if (["motion", "telop", "thumbnail"].includes(category)) {
+  if (["overlay", "still"].includes(category)) {
     const fragmentPath = path.join(assetDir, "fragment.html");
     if (!isRegularFile(fragmentPath)) {
       fail(`${category} 素材には fragment.html が必要です`);
     }
   }
 
-  if (category === "3d") {
-    // 3d は fragment.html（経路 A: オーバーレイ）か scene.py（経路 B: ベイクレシピ）のどちらか一方
+  if (category === "scene3d") {
+    // scene3d は fragment.html（経路 A: オーバーレイ）か scene.py（経路 B: ベイクレシピ）のどちらか一方
     // （契約: docs/contract-2026-07-14-3d-bake-recipe.md）
     const hasFragment = isRegularFile(path.join(assetDir, "fragment.html"));
     const hasScene = isRegularFile(path.join(assetDir, "scene.py"));
     if (hasFragment === hasScene) {
-      fail("3d 素材は fragment.html（オーバーレイ）か scene.py（ベイクレシピ）のどちらか一方を実体に持つ必要があります");
+      fail("scene3d 素材は fragment.html（オーバーレイ）か scene.py（ベイクレシピ）のどちらか一方を実体に持つ必要があります");
     }
     if (hasFragment && !payloadFiles.some((filePath) => /\.(?:glb|gltf)$/i.test(filePath))) {
-      fail("3d オーバーレイ素材には glTF 実体（.glb または .gltf）が必要です");
+      fail("scene3d 素材には glTF 実体（.glb または .gltf）が必要です");
     }
   }
 

package/vendor/packages/schemas/edit.schema.json

@@ -28,7 +28,7 @@
         "lut": { "type": "string", "minLength": 1, "pattern": "\\S" },
         "intensity": { "type": "number", "minimum": 0, "maximum": 1 }
       },
-      "$comment": "docs/contract-2026-07-22-render-basics.md #4。lut はカタログ参照名（catalog/luts/ 配下）または .cube への相対パス。intensity 省略時 1.0。"
+      "$comment": "docs/contract-2026-07-22-render-basics.md #4。lut はプリセット参照名（presets/luts/ 配下）または .cube への相対パス。intensity 省略時 1.0。"
     },
     "output": {
       "type": "object",

package/vendor/packages/schemas/recipe.schema.json

@@ -39,7 +39,7 @@
       "properties": {
         "aspect": {
           "enum": ["16:9", "9:16", "1:1"],
-          "$comment": "既存カタログタグの慣用値（例 catalog/3d/vintage-camera/meta.json の tags[]）をそのまま採用。新しい語彙を作らない。"
+          "$comment": "既存カタログタグの慣用値（例 catalog/scene3d/vintage-camera/meta.json の tags[]）をそのまま採用。新しい語彙を作らない。"
         },
         "target_duration_band": {
           "$ref": "#/$defs/nonEmptyString",

package/vendor/packages/schemas/test/fixtures/asset/valid-library/{telop → overlay}/lower-third-clean/meta.json

@@ -1,6 +1,6 @@
 {
   "id": "lower-third-clean",
-  "category": "telop",
+  "category": "overlay",
   "title": "クリーン・ロワーサード",
   "description": "名前と肩書を端正な2行で見せる、ダークプレートとアクセントラインのロワーサード。日本語の人物紹介に最適化している。",
   "when_to_use": "インタビュー、登壇者紹介、採用・企業映像など、話者の名前と肩書を落ち着いたトーンで提示するシーン",

package/vendor/packages/schemas/test/validate-asset.test.mjs

@@ -15,7 +15,7 @@ function run(fixture) {
 }
 
 test("library meta with title-normalized matched_by passes", () => {
-  const executed = run("valid-library/telop/lower-third-clean");
+  const executed = run("valid-library/overlay/lower-third-clean");
   assert.equal(executed.status, 0, executed.stderr);
   assert.match(executed.stdout, /^OK: /);
   assert.equal(executed.stderr.trim(), "");

package/vendor/skills/bake-3d/SKILL.md

@@ -33,7 +33,7 @@ test -x "$BLENDER" && "$BLENDER" --version | head -1
 
 # 2. scene.py の authoring 契約
 
-参照実装: [`assets/3d/vintage-camera-turntable/scene.py`](../../assets/3d/vintage-camera-turntable/scene.py)
+参照実装: [`assets/scene3d/vintage-camera-turntable/scene.py`](../../assets/scene3d/vintage-camera-turntable/scene.py)
 
 - **自己完結**: レシピディレクトリ単体をプロジェクトへコピーしても動くこと。リポ内の他ファイルを import しない。アセットは `os.path.dirname(os.path.abspath(__file__))` 相対で読む
 - **引数契約**（`--` 以降を argparse で受ける）:
@@ -60,13 +60,13 @@ test -x "$BLENDER" && "$BLENDER" --version | head -1
 
 1. `ffprobe` で解像度・fps・フレーム数が指定と一致することを確認する
 2. 先頭・中間・末尾のフレームを `ffmpeg -ss <t> -frames:v 1` で抽出して目視する（構図・ライティング・アニメーションの向き）
-3. ライブラリ入庫時は中間フレームから `preview.png` を作り、`node packages/schemas/bin/validate-asset.mjs assets/3d/<id>` を通す
+3. ライブラリ入庫時は中間フレームから `preview.png` を作り、`node packages/schemas/bin/validate-asset.mjs assets/scene3d/<id>` を通す
 
 # 5. ライブラリ入庫 / プロジェクト採用
 
 - 入庫基準は素材ライブラリ契約と同じ: シーン構築・ライティング・カメラワークの設計コストが高いレシピだけを入れる
 - meta.json は knobs を `param` で宣言し、`requires: ["blender"]`。provenance にアセットの取得元・ライセンス・梱包手順を書く
-- プロジェクト採用 = レシピ一式を `<project>/assets/3d/<id>/` へ複製 → params 上書き → ベイク → mp4 を edit.json にクリップ配置。provenance にレシピ id / 版 / params / Blender バージョンを記録する
+- プロジェクト採用 = レシピ一式を `<project>/assets/scene3d/<id>/` へ複製 → params 上書き → ベイク → mp4 を edit.json にクリップ配置。provenance にレシピ id / 版 / params / Blender バージョンを記録する
 
 # よくある間違い
 

package/vendor/skills/create-project/SKILL.md

@@ -41,6 +41,26 @@ node skills/create-project/bin/create-project.mjs <target-dir> [--template <path
 - `<target-dir>`: 作成先ディレクトリ。新規でも既存の非空フォルダでもよい。既存ファイルは上書きしない。
 - `--template <path>`: 雛形ディレクトリを明示指定する。省略時はリポ checkout の `templates/project-default/` を使う。それ以外の解決手段はない。
 
+## 作例から始めたいと言われたとき
+
+「解説ショートを作りたい」「あの縦型の解説動画みたいなやつ」のように**完成形の作例から
+始めたい**依頼は、雛形解決の 2 択（ハードルール 1）とは別の話である。本スキルは**器**を作る
+ものであり、作例は器ではない。
+
+- 解説ショート（3 面構成の縦型・VOICEVOX ナレーション駆動・図解カードの段階表示）:
+  [`templates/kaisetsu-short/`](../../templates/kaisetsu-short/README.ja.md)
+- 使い方はディレクトリごと複製し、`sample-project/` を自分の台本 JSON に置き換える。
+  まず動作確認するなら同梱サンプル（音声同梱のため VOICEVOX 不要）:
+
+  ```sh
+  cd templates/kaisetsu-short && node tools/build.mjs sample-project --no-synthesize
+  ```
+
+- **作例を `--template` に渡さない。** `.akari/` などの器の構造を持たないため、
+  雛形として解決すると不完全なプロジェクトになる。器が要るなら通常どおり
+  `templates/project-default/` で作成し、そのうえで作例を複製して中身を持ち込む
+- テンプレート 2 種（器 / 作例）の違いは [`templates/INDEX.md`](../../templates/INDEX.md) を参照
+
 ## intake.json（進め方フォームの保存先）
 
 作成直後の `.akari/intake.json` は `status: "draft"`・空 `tasks` から始まる（契約: `packages/schemas/intake.schema.json`）。プロジェクトの CLAUDE.md には intake の規律を追記する — `status: "submitted"` なら `tasks` / `target` / `autonomy` に従い、`autonomy: "checkpoint"`（既定）なら企画承認・書き出し前などの要所で人に確認し、`status: "draft"` のままなら進め方をフォームまたは対話で確定させてから進める。

package/vendor/skills/edit-plan/expression-selection.md

@@ -102,9 +102,10 @@
     コミットしない。**
   - `catalog/` は `remote: true` の**取得先索引であり実体を持たない**（[catalog/INDEX.md](../../catalog/INDEX.md)）。
     未取得なら「取得が要る」ことを素材計画に明記する。
-  - 例外: `catalog/telop/` だけは本リポへベンダリングされた目次方式カタログで、`meta.json` を
-    持たない（実測: `index.jsonl` に license フィールドは無い）。ライセンス根拠は
-    [catalog/telop/INDEX.md](../../catalog/telop/INDEX.md) の来歴で確認し、実際にレンダリングへ
+  - `presets/telop/` は素材カタログではなく、bake CLI が id で引く参照表である（本リポへ
+    ベンダリングされた目次方式・`meta.json` を持たない。実測: `index.jsonl` に license
+    フィールドは無い）。ライセンス根拠は
+    [presets/telop/INDEX.md](../../presets/telop/INDEX.md) の来歴で確認し、実際にレンダリングへ
     使う書体のライセンスは `catalog/font/<id>/meta.json` で別途確認する。
 - 該当ヒットが無いことを「あれば提案」と記録しない。[report-guide.md](report-guide.md#素材計画) の
   三択（あれば提案 / なければ生成 / 使わない）へ落とし、プレビュー・検索結果を捏造しない。
@@ -157,23 +158,23 @@
 
 | scene | 表の行 | 第一候補 | フィルタ判定 | 採用手段 | 採用素材 |
 |---|---|---|---|---|---|
-| `sc-01` | 製品・物体の説明 | 3D モデル | `3D` は許可 → 通過 | 3D | `catalog/3d/modern-smartphone` |
+| `sc-01` | 製品・物体の説明 | 3D モデル | `3D` は許可 → 通過 | 3D | `catalog/scene3d/modern-smartphone` |
 | `sc-02` | データ・数値・比較 | HTML グラフ/表 | `HTML 図解` は許可 → 通過 | HTML 図解 | 生成（overlay HTML）+ 書体 `catalog/font/noto-sans-jp` |
-| `sc-03` | 感情・主張の瞬間 | 文字演出（語レベル） | `文字演出` は許可 → 通過 | 文字演出 | `catalog/telop/ref3_mincho_flash` |
+| `sc-03` | 感情・主張の瞬間 | 文字演出（語レベル） | `文字演出` は許可 → 通過 | 文字演出 | `presets/telop/ref3_mincho_flash` |
 
 素材の選定根拠（カタログ実測）:
 
-- `sc-01`: `catalog/3d/` の 3 件を `when_to_use` で突き合わせ、`modern-smartphone` の
+- `sc-01`: `catalog/scene3d/` の 3 件を `when_to_use` で突き合わせ、`modern-smartphone` の
   「アプリ紹介・UI 解説・プロダクトデモで、実機に画面を映し込んだモックアップ映像を作るとき」が
   シーンの意味と一致する（`vintage-camera` はレトロ小物、`studio-hdri` は環境光であり不一致）。
   `license.spdx` = `CC0-1.0` / `attribution_required: false` → クレジット不要。`remote: true` の
   ため取得が要ることを素材計画に明記する。
 - `sc-02`: `catalog/` にグラフ・表のカテゴリは存在しない（実測のディレクトリは
-  3d / audio / broll / font / luts / telop）。
+  scene3d / audio / avatars / broll / font）。
   三択の「なければ生成」として overlay HTML を自作し、書体は `catalog/font/noto-sans-jp`
   （`OFL-1.1` / クレジット不要）を使う。**「使わない」列の 3D の飾りは、`3D` が許可されていても
   置かない。**
-- `sc-03`: `catalog/telop/index.jsonl` を `use_when.beats ⊇ emotion` で検索するとヒットは 3 件
+- `sc-03`: `presets/telop/index.jsonl` を `use_when.beats ⊇ emotion` で検索するとヒットは 3 件
   （`ref3_karaoke_flash` = エモい歌モノ / `ref3_kid_karaoke` = 子ども向け / `ref3_tl_r3s7_07` =
   昭和ラジオ風）で、いずれも解説トーン（真面目）と不一致だった。**同じ「文字演出」の範囲内で**
   `tone` 一致を優先し、`roles: emphasis` かつ `tone: 真面目・エモい` の `ref3_mincho_flash`
@@ -185,7 +186,7 @@
 ```text
 sc-01 @ 24.0 | 意味: 製品・物体の説明 | 行: 製品・物体の説明 / 第一候補 | 手段: 3D | 素材: modern-smartphone（catalog / CC0-1.0 / クレジット不要） | 理由: when_to_use「実機に画面を映し込んだモックアップ」がシーンの意味に一致
 sc-02 @ 98.0 | 意味: データ・数値・比較 | 行: データ・数値・比較 / 第一候補 | 手段: HTML 図解 | 素材: overlays/sc-02-chart.html（生成 / 書体 noto-sans-jp OFL-1.1 / クレジット不要） | 理由: catalog にグラフ素材のカテゴリが無く三択の「なければ生成」。3D の飾りは禁止列のため不使用
-sc-03 @ 232.0 | 意味: 感情・主張の瞬間 | 行: 感情・主張の瞬間 / 第一候補 | 手段: 文字演出 | 素材: ref3_mincho_flash（catalog/telop / 来歴 akari-telop / クレジット不要） | 理由: emotion 一致の 3 件はトーン不一致のため、同じ文字演出の中で tone 一致（真面目・エモい）の emphasis を採用
+sc-03 @ 232.0 | 意味: 感情・主張の瞬間 | 行: 感情・主張の瞬間 / 第一候補 | 手段: 文字演出 | 素材: ref3_mincho_flash（presets/telop / 来歴 akari-telop / クレジット不要） | 理由: emotion 一致の 3 件はトーン不一致のため、同じ文字演出の中で tone 一致（真面目・エモい）の emphasis を採用
 ```
 
 ### ケース 2 — `3D` と `AI 生成` が不許可（5 値）
@@ -198,7 +199,7 @@ sc-03 @ 232.0 | 意味: 感情・主張の瞬間 | 行: 感情・主張の瞬間
 |---|---|---|---|---|---|
 | `sc-01` | 製品・物体の説明 | 3D モデル | `3D` が**除外** → 第二候補へ | 実写 B ロール | `catalog/broll/laptop-typing-closeup` |
 | `sc-02` | データ・数値・比較 | HTML グラフ/表 | `HTML 図解` は許可 → 通過 | HTML 図解 | 生成（overlay HTML）+ 書体 `catalog/font/noto-sans-jp` |
-| `sc-03` | 感情・主張の瞬間 | 文字演出（語レベル） | `文字演出` は許可 → 通過 | 文字演出 | `catalog/telop/ref3_mincho_flash` |
+| `sc-03` | 感情・主張の瞬間 | 文字演出（語レベル） | `文字演出` は許可 → 通過 | 文字演出 | `presets/telop/ref3_mincho_flash` |
 
 ケース 1 との差分と、`AI 生成` 不許可が効いた箇所:
 
@@ -248,9 +249,9 @@ sc-01 @ 24.0 | 意味: 製品・物体の説明 | 行: 製品・物体の説明
 worked example が引いたカタログの実データは次で確認した（`catalog/` は読み取りのみ）。
 
 ```
-$ ls catalog/3d | tr '\n' ' '
+$ ls catalog/scene3d | tr '\n' ' '
 INDEX.md modern-smartphone studio-hdri vintage-camera
-$ node -e "const m=require('./catalog/3d/modern-smartphone/meta.json');console.log(m.license.spdx,m.license.attribution_required,m.remote)"
+$ node -e "const m=require('./catalog/scene3d/modern-smartphone/meta.json');console.log(m.license.spdx,m.license.attribution_required,m.remote)"
 CC0-1.0 false true
 $ node -e "const m=require('./catalog/broll/laptop-typing-closeup/meta.json');console.log(m.license.spdx,m.license.attribution_required)"
 LicenseRef-Mixkit-Free-License false
@@ -258,7 +259,7 @@ $ node -e "const m=require('./catalog/font/noto-sans-jp/meta.json');console.log(
 OFL-1.1 false
 ```
 
-`catalog/telop/index.jsonl`（36 件）を `use_when.beats ⊇ emotion` で絞ると 3 件
+`presets/telop/index.jsonl`（36 件）を `use_when.beats ⊇ emotion` で絞ると 3 件
 （`ref3_karaoke_flash` / `ref3_kid_karaoke` / `ref3_tl_r3s7_07`）であり、採用した
 `ref3_mincho_flash` は `roles: ["emphasis"]` / `tone: ["真面目","エモい"]` / `strength: high` である。
 

package/vendor/skills/harvest-asset/SKILL.md

@@ -46,7 +46,7 @@ source fragment と同階層の依存 asset を読み、作業用一時ディレ
 ### その他の自動導出
 
 - `id`: source 名と内容から kebab-case で生成する。
-- `category`: `3d` / `motion` / `telop` / `audio` / `broll` / `font` / `thumbnail` から単一カテゴリを内容から選ぶ。横断軸は `tags` にする。サムネイルの HTML 文字組テンプレは `thumbnail`（背景差し替え前提で、文字組レイヤーだけを素材化する）。
+- `category`: `overlay` / `still` / `scene3d` / `audio` / `broll` / `font` から単一カテゴリを**配布物の形**で選ぶ（2026-07-29 に主題軸から変更）。時間を持つ HTML 断片は `overlay`、時間を持たず画像に焼く HTML シート（サムネ構図等）は `still`、Three.js + glTF またはベイクレシピは `scene3d`。**主題（テロップ・黒板・ロワーサード・BGM・SFX・サムネ等）はカテゴリにせず `tags` に逃がす。カテゴリを増やさない。**
 - `title` / `description` / `tags`: 見た目、役割、aspect、scene を source と利用文脈から要約する。
 - `provenance`: origin project、元 path、生成手、prompt、日時を既存情報から埋める。分からない値を捏造しない。
 - media の寸法、duration、codec、model 情報は `sips`、`ffprobe`、利用可能な GLB inspector などで読める場合だけ確認し、description / tags / preview 判断へ使う。schema にないトップレベル field は追加しない。

package/vendor/templates/project-default/.claude/skills/README.md

@@ -17,7 +17,7 @@ AKARI Video の編集スキルは、このフォルダーに実体で入って
 分析結果と節目の記録の詳しい約束は
 `.claude/skills/analyze-footage/references/akari-data-contract.md` を参照してください。
 
-`.agents/skills/` と `.codex/skills/` は Codex など他の AI エージェント用の入り口で、
+`.agents/skills/`、`.cursor/skills/`、`.codex/skills/` は Codex / Cursor など他の AI エージェント用の入り口で、
 このフォルダーの実体への symlink です。
 
 `AKARI-SKILLS-VERSION` は、このプロジェクトを作ったときのスキル内容を示す記録です。

package/vendor/templates/project-default/.opencode/config.json

@@ -0,0 +1,16 @@
+{
+  "name": "AKARI Video Project",
+  "version": "1.0.0",
+  "description": "AKARI Video プロジェクト設定",
+  "skills": {
+    "autoDiscover": true,
+    "path": "./skills"
+  },
+  "hooks": {
+    "sessionStart": "./hooks/session-start.mjs"
+  },
+  "project": {
+    "type": "akari-video",
+    "version": "0.1.0"
+  }
+}

package/vendor/templates/project-default/.opencode/hooks/session-start.mjs

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+// SessionStart hook for opencode: カレントに .akari/ プロジェクトがあれば「続きから」体験として
+// 進捗（intake 状態・直近イベント）+ 次の一手をコンテキストへ注入する。無ければ
+// 何もしない。
+
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const FALLBACK_TASK_LABELS = {
+  'transcribe-captions': '文字起こし・テロップ',
+  'silence-cut': 'いらない間・NG のカット',
+  'bgm-sfx': 'BGM・効果音',
+  narration: 'ナレーション（自分の声 / 既製の声）',
+  '3d-inserts': '3D・画面はめ込みの演出'
+};
+
+const AUTONOMY_LABELS = {
+  'full-auto': 'すべておまかせ',
+  checkpoint: '要所で確認（既定）',
+  collaborative: '相談しながら'
+};
+
+async function main() {
+  const stdin = await readStdin();
+  let hookInput = {};
+  try {
+    hookInput = JSON.parse(stdin || '{}');
+  } catch {
+    hookInput = {};
+  }
+
+  const cwd = typeof hookInput.cwd === 'string' && hookInput.cwd
+    ? hookInput.cwd
+    : process.cwd();
+
+  const akariDir = path.join(cwd, '.akari');
+  if (!existsSync(akariDir)) {
+    return;
+  }
+
+  const context = buildContext(cwd, akariDir);
+  if (!context) return;
+
+  // opencode のフック形式に合わせて出力
+  process.stdout.write(JSON.stringify({
+    hookEventName: 'SessionStart',
+    additionalContext: context
+  }));
+}
+
+function buildContext(cwd, akariDir) {
+  const lines = ['AKARI Video プロジェクトの続きから。'];
+
+  const intake = readJsonSafe(path.join(akariDir, 'intake.json'));
+  lines.push(summarizeIntake(intake, cwd));
+
+  const latestEvent = readLatestEvent(path.join(akariDir, 'events'));
+  lines.push(latestEvent ? nudgeFor(latestEvent) : 'まだ記録された節目はありません。');
+
+  return lines.join('\n');
+}
+
+function summarizeIntake(intake) {
+  if (!intake) {
+    return '進め方フォーム（.akari/intake.json）がまだありません。';
+  }
+  if (intake.status !== 'submitted') {
+    return '進め方はまだ未確定です（.akari/intake.json: draft）。フォーム・対話で「やること・尺・おまかせ度」を確定してください。';
+  }
+  const labels = loadTaskLabels();
+  const tasks = Array.isArray(intake.tasks) ? intake.tasks : [];
+  const taskText = tasks.length > 0 ? tasks.map((id) => labels[id] ?? id).join('、') : '（やること未選択）';
+  const autonomyText = AUTONOMY_LABELS[intake.autonomy] ?? intake.autonomy ?? '未設定';
+  const target = intake.target ?? {};
+  const targetText = target.keep_length
+    ? '尺は素材のまま'
+    : typeof target.duration_s === 'number'
+      ? `目標尺 ${target.duration_s} 秒`
+      : '尺は未指定';
+  return `進め方: ${taskText} / ${targetText} / 進め方は${autonomyText}。checkpoint なら企画承認・書き出し前などの要所で人に確認する。`;
+}
+
+function loadTaskLabels() {
+  try {
+    const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+    const repoRoot = path.resolve(scriptDir, '..', '..', '..');
+    const schemaPath = path.join(repoRoot, 'packages', 'schemas', 'intake.schema.json');
+    const schema = readJsonSafe(schemaPath);
+    const labels = schema?.['x-akari-labels'];
+    if (labels && typeof labels === 'object' && !Array.isArray(labels)) {
+      return labels;
+    }
+  } catch {
+    // フォールバックへ。
+  }
+  return FALLBACK_TASK_LABELS;
+}
+
+function readLatestEvent(eventsDir) {
+  if (!existsSync(eventsDir)) return null;
+  let entries;
+  try {
+    entries = readdirSync(eventsDir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith('.json'));
+  } catch {
+    return null;
+  }
+
+  let latest = null;
+  let latestTime = -Infinity;
+  for (const entry of entries) {
+    const parsed = readJsonSafe(path.join(eventsDir, entry.name));
+    if (!parsed || typeof parsed.type !== 'string') continue;
+    const timestamp = parsed.occurredAt ?? parsed.at;
+    const time = typeof timestamp === 'string' ? Date.parse(timestamp) : NaN;
+    if (Number.isNaN(time)) continue;
+    if (time > latestTime) {
+      latestTime = time;
+      latest = parsed;
+    }
+  }
+  return latest;
+}
+
+function nudgeFor(event) {
+  const subject = sanitize(event.asset ?? event.artifact ?? event.path);
+  switch (event.type) {
+    case 'video-added':
+      return subject
+        ? `${subject} が追加されました。analyze-footage スキルで分析を開始してください。`
+        : '新しい素材が追加されました。analyze-footage スキルで分析を開始してください。';
+    case 'report-generated':
+      return subject
+        ? `レポートを作成しました（${subject}）。内容を確認し、問題なければ承認してください。`
+        : 'レポートを作成しました。内容を確認し、問題なければ承認してください。';
+    case 'report-approved':
+      return 'レポートが承認されました。edit-plan スキルで編集を進めてください。';
+    case 'edit-completed':
+      return '編集が完了しました。プレビューで仕上がりを確認し、必要ならテロップ等を overlay-authoring スキルで調整してください。';
+    case 'export-completed':
+      return subject
+        ? `書き出しが完了しました（${subject}）。exports フォルダーで最終版を確認してください。`
+        : '書き出しが完了しました。exports フォルダーで最終版を確認してください。';
+    default:
+      return subject
+        ? `${subject} が更新されました。内容を確認し、次の一手を進めてください。`
+        : `更新がありました（${event.type}）。内容を確認し、次の一手を進めてください。`;
+  }
+}
+
+function sanitize(value) {
+  const trimmed = typeof value === 'string' ? value.replace(/[\r\n]+/g, ' ').trim() : '';
+  return trimmed || undefined;
+}
+
+function readJsonSafe(filePath) {
+  try {
+    return JSON.parse(readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function readStdin() {
+  return new Promise((resolve) => {
+    if (process.stdin.isTTY) {
+      resolve('');
+      return;
+    }
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.on('error', () => resolve(data));
+  });
+}
+
+main()
+  .catch(() => {
+    // HOOK SAFETY: 何が起きてもセッションを壊さない。
+  })
+  .finally(() => {
+    process.exitCode = 0;
+  });

package/vendor/templates/project-default/.opencode/skills/analyze-footage.yml

@@ -0,0 +1,16 @@
+name: analyze-footage
+description: 動画素材 1 本から 720p プロキシ、ローカル既定の文字起こし（Mac は macOS SpeechAnalyzer / 共通は whisper.cpp・クラウドは承認制）、視認済みキーフレーム、編集イベント、人物関連トラックを作り、analysis.json v0 にまとめるスキル。新しい撮影素材を取り込むとき、素材単体の編集前分析を頼まれたとき、または edit-plan の前処理として素材ごとの分析が必要なときに使う。
+triggers:
+  - 素材を分析して
+  - analyze footage
+  - 動画を分析
+  - プロキシ作成
+  - 文字起こし
+tools:
+  - bash
+  - read
+  - write
+  - edit
+  - grep
+  - glob
+skillPath: ../../skills/analyze-footage/SKILL.md

package/vendor/templates/project-default/.opencode/skills/create-project.yml

@@ -0,0 +1,15 @@
+name: create-project
+description: AKARI Video の新規プロジェクトを headless で作成する。`templates/project-default/` を再帰コピーし、雛形バージョンを記録し、安全な場合のみ git 初期化して、作成結果レポート HTML を生成する。アプリ起動は不要。新しい動画プロジェクトを作るとき、または既存フォルダを AKARI Video プロジェクトとして補完するときに使う。
+triggers:
+  - 新しいプロジェクトを作りたい
+  - create project
+  - プロジェクト作成
+  - 動画プロジェクト
+tools:
+  - bash
+  - read
+  - write
+  - edit
+  - grep
+  - glob
+skillPath: ../../skills/create-project/SKILL.md

package/vendor/templates/project-default/.opencode/skills/edit-plan.yml

@@ -0,0 +1,15 @@
+name: edit-plan
+description: analyze-project が作る分析レポート（interpretation.json + analysis-report.html）を一次証拠として読み、方針・素材計画・実行をチャットの明示承認で確定したうえで edit.json v0 とオーバーレイ HTML へ落とすスキル。複数素材の編集計画、素材ゼロからの生成計画（質問対話 → plan.json の仮枠タイムライン確定）、分析結果からカットや BGM・SFX・B ロールを決める依頼で使う。
+triggers:
+  - 編集方針を立てて
+  - edit plan
+  - 編集計画
+  - カット構成
+tools:
+  - bash
+  - read
+  - write
+  - edit
+  - grep
+  - glob
+skillPath: ../../skills/edit-plan/SKILL.md

package/vendor/templates/project-default/AGENTS.md

@@ -28,7 +28,7 @@
 - `/harvest-asset` … 素材の収集
 - `/bake-3d` … 3D 素材の焼き込み
 
-Codex 等のハーネスでは `.agents/skills/` / `.codex/skills/`（`.claude/skills/` への symlink）から
+Codex / Cursor 等のハーネスでは `.agents/skills/` / `.cursor/skills/` / `.codex/skills/`（`.claude/skills/` への symlink）から
 同じスキルが自動発見される。
 
 スキルを自動で読まない作業環境では、次のプロジェクト内相対パスから手順を直接読む。

package/vendor/templates/project-default/CLAUDE.md

@@ -21,7 +21,7 @@
 
 編集スキルは `.claude/skills/` に入っています。`/analyze-footage`、`/edit-plan`、
 `/overlay-authoring`、`/setup-library`、`/harvest-asset`、`/bake-3d` の素の名前で使えます。
-Codex など他の AI エージェント用の入り口が `.agents/skills/` と `.codex/skills/` にあります
+Codex や Cursor など他の AI エージェント用の入り口が `.agents/skills/`、`.cursor/skills/`、`.codex/skills/` にあります
 （中身は `.claude/skills/` へのリンクです）。
 詳しい進め方と、スキル文書を直接読む場合の場所は `AGENTS.md` を参照してください。
 

package/vendor/templates/project-default/akari.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# AKARI Video — メインエントリーポイント
+set -euo pipefail
+
+MUTED='\033[0;2m'; RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[38;5;214m'; BOLD='\033[1m'; NC='\033[0m'
+info() { echo -e "${GREEN}$1${NC}"; }
+warn() { echo -e "${YELLOW}$1${NC}"; }
+err()  { echo -e "${RED}$1${NC}"; }
+
+# ─── Resolve script location (works via PATH/symlink) ───
+SCRIPT_PATH="$(readlink -f "$0" 2>/dev/null || realpath "$0" 2>/dev/null || echo "$0")"
+
+# ─── Find monorepo root ───
+find_monorepo() {
+  local dir; dir="$(cd "$(dirname "$1")" && pwd)"
+  while [[ "$dir" != "/" ]]; do
+    if [[ -f "$dir/packages/akari-launcher/bin/akari.mjs" ]]; then echo "$dir"; return 0; fi
+    dir="$(dirname "$dir")"
+  done
+  if [[ -n "${AKARI_MONOREPO:-}" ]] && [[ -f "$AKARI_MONOREPO/packages/akari-launcher/bin/akari.mjs" ]]; then
+    echo "$AKARI_MONOREPO"; return 0
+  fi
+  return 1
+}
+MONOREPO="$(find_monorepo "$SCRIPT_PATH")" || { err "Cannot find AKARI Video monorepo. Set AKARI_MONOREPO or run from within the repo."; exit 1; }
+
+# ─── Preview server launcher ───
+cmd_preview() {
+  local PROJECT="${AKARI_PROJECT:-.}"
+  local PORT="${AKARI_PORT:-4567}"
+  local OPEN_BROWSER=false
+  local ARGS=("$@")
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      -h|--help|-\?)
+        echo "Usage: akari.sh --preview [options] [project-path] [port]"
+        echo ""
+        echo "Options:"
+        echo "  -p, --port <port>    Port number (default: 4567, env: AKARI_PORT)"
+        echo "  -o, --open           Open browser automatically"
+        echo ""
+        echo "Port can also be given as a bare number (the last positional arg)."
+        echo "If the project dir has no edit.json, it is auto-created."
+        echo ""
+        echo "Examples:"
+        echo "  akari.sh --preview                  # current dir, port 4567"
+        echo "  akari.sh --preview 3000             # current dir, port 3000"
+        echo "  akari.sh --preview ~/my-video 3000"
+        return 0 ;;
+      -p|--port) PORT="$2"; shift 2 ;;
+      -o|--open) OPEN_BROWSER=true; shift ;;
+      *)
+        if [[ "$1" =~ ^[0-9]+$ ]]; then PORT="$1"
+        elif [[ "$PROJECT" == "." ]] || [[ "$PROJECT" == "$AKARI_PROJECT" ]]; then PROJECT="$1"
+        else err "Multiple project paths specified"; return 1; fi
+        shift ;;
+    esac
+  done
+
+  mkdir -p "$PROJECT" 2>/dev/null || true
+  PROJECT="$(cd "$PROJECT" 2>/dev/null && pwd)" || { err "Project directory not found: $PROJECT"; return 1; }
+
+  if [[ ! -f "$PROJECT/edit.json" ]]; then
+    info "Project not initialized. Scaffolding from template..."
+    cp -r "$MONOREPO/templates/project-default/"* "$PROJECT/" 2>/dev/null || true
+    cp "$MONOREPO/templates/project-default/.gitignore" "$PROJECT/" 2>/dev/null || true
+    cp -r "$MONOREPO/templates/project-default/".* "$PROJECT/" 2>/dev/null || true
+    touch "$PROJECT/assets/.gitkeep" "$PROJECT/exports/.gitkeep" "$PROJECT/planning/.gitkeep" 2>/dev/null || true
+    mkdir -p "$PROJECT/.akari/cache" "$PROJECT/.akari/diffs" "$PROJECT/.akari/events" "$PROJECT/.akari/reports" "$PROJECT/.akari/sidecars" "$PROJECT/.akari/work" 2>/dev/null || true
+    echo '{"version":1,"status":"draft"}' > "$PROJECT/.akari/intake.json" 2>/dev/null || true
+    echo "{}" > "$PROJECT/edit.json" 2>/dev/null || true
+    info "  Created: $PROJECT"
+  fi
+
+  info "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  info "  AKARI Video Preview Server"
+  info "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo -e "  ${BOLD}Project:${NC} $PROJECT"
+  echo -e "  ${BOLD}URL:${NC}     http://localhost:$PORT"
+  echo ""
+  echo -e "  ${MUTED}Ctrl+C で停止${NC}"
+  echo ""
+
+  node "$MONOREPO/packages/preview-server/src/server.mjs" "$PROJECT" --port "$PORT" &
+  PID=$!
+  trap "kill $PID 2>/dev/null; exit" INT TERM
+
+  if [[ "$OPEN_BROWSER" == "true" ]]; then
+    sleep 1
+    case "$(uname -s)" in Darwin*) open "http://localhost:$PORT" ;; Linux*) xdg-open "http://localhost:$PORT" 2>/dev/null || true ;; esac
+  fi
+  wait $PID
+}
+
+# ─── Main ───
+if [[ $# -eq 0 ]]; then
+  # デフォルトは Claude Code（launcher の自動検出に任せる）
+  # --opencode を付けたい場合は明示的に指定
+  exec node "$MONOREPO/packages/akari-launcher/bin/akari.mjs"
+fi
+
+case "$1" in
+  -h|--help|-\?)
+    SCRIPT_NAME="$(basename "$0")"
+    echo "AKARI Video — AI-powered video editor"
+    echo ""
+    echo "Usage: $SCRIPT_NAME [command] [options...]"
+    echo ""
+    echo "Commands:"
+    echo "  (no args)             Launch AI agent (Claude Code優先)"
+    echo "  --preview, -pv        Start preview server"
+    echo "  update                Check for updates"
+    echo "  --opencode            Use opencode instead of Claude Code"
+    echo "  --claude, --claudecode  Launch Claude Code explicitly"
+    echo "  -y, --yes             Auto-confirm (skip permissions; opencode:--auto / Claude:--permission-mode acceptEdits)"
+    echo "  -h, --help, -?        Show this help"
+    echo ""
+    echo "Typical workflow:"
+    echo "  1. mkdir ~/my-first-video && cd ~/my-first-video"
+    echo "  2. $SCRIPT_NAME                        # AI agent (project auto-created)"
+    echo "  3. $SCRIPT_NAME --preview               # Preview server (別の端末で)"
+    echo ""
+    echo "Examples:"
+    echo "  $SCRIPT_NAME                           # Claude Code起動"
+    echo "  $SCRIPT_NAME -y                        # Claude Code + auto-confirm"
+    echo "  $SCRIPT_NAME --opencode -y             # opencode + auto-confirm"
+    echo "  $SCRIPT_NAME --preview                 # Preview (current dir)"
+    echo "  $SCRIPT_NAME --preview ~/my-project 3000"
+    echo "  $SCRIPT_NAME update"
+    exit 0 ;;
+  --preview|-pv) shift; cmd_preview "$@" ;;
+  update) exec node "$MONOREPO/packages/akari-launcher/bin/akari.mjs" "update" ;;
+  --opencode) shift; exec node "$MONOREPO/packages/akari-launcher/bin/akari.mjs" "--opencode" "$@" ;;
+  --claude|--claudecode) shift; exec node "$MONOREPO/packages/akari-launcher/bin/akari.mjs" "--claude" "$@" ;;
+  -y|--yes) shift; exec node "$MONOREPO/packages/akari-launcher/bin/akari.mjs" "--yes" "$@" ;;
+  *) exec node "$MONOREPO/packages/akari-launcher/bin/akari.mjs" "$@" ;;
+esac