akari-video 1.5.0-beta.3 → 1.5.0-beta.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.5.0-beta.3",
+  "version": "1.5.0-beta.4",
   "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

@@ -257,6 +257,42 @@ export function linkKitSkills(kitDir, manifest, home, options = {}) {
   return { linked, blockers, warnings };
 }
 
+export function linkKitPlaybooks(kitDir, manifest, home, options = {}) {
+  const linked = [];
+  const warnings = [];
+  for (const entry of manifest.playbooks ?? []) {
+    if (typeof entry?.dir !== 'string' || !/^playbooks\/[a-z0-9][a-z0-9-]*$/u.test(entry.dir)) {
+      throw new Error(cliText('cli.kits.error.pathOutside', { path: String(entry?.dir) }));
+    }
+    const id = path.posix.basename(entry.dir);
+    const source = safeKitPath(kitDir, entry.dir);
+    const realKit = realpathSync(kitDir);
+    const realSource = realpathSync(source);
+    if (!realSource.startsWith(`${realKit}${path.sep}`) || !statSync(realSource).isDirectory()) {
+      throw new Error(cliText('cli.kits.error.pathOutside', { path: entry.dir }));
+    }
+    const destination = path.join(home, 'playbooks', id);
+    try {
+      const stat = lstatSync(destination);
+      let owned = false;
+      if (stat.isSymbolicLink()) {
+        try { owned = realpathSync(destination) === realSource; } catch { /* Broken links are not owned. */ }
+      }
+      if (!owned) {
+        warnings.push(cliText('cli.kits.warning.directoryKept', { path: destination }));
+        continue;
+      }
+    } catch (error) {
+      if (error?.code !== 'ENOENT') throw error;
+    }
+    const result = replaceSymlink(source, destination, options);
+    if (result.status === 'linked') linked.push(id);
+    else warnings.push(cliText(result.status === 'permission-denied'
+      ? 'cli.kits.warning.symlinkFailed' : 'cli.kits.warning.directoryKept', { path: destination }));
+  }
+  return { linked, warnings };
+}
+
 export function readKitsLedger(home) {
   const ledgerPath = path.join(home, 'kits', 'installed.json');
   if (!existsSync(ledgerPath)) return { schema: KITS_SCHEMA, kits: [] };
@@ -269,6 +305,12 @@ export function readKitsLedger(home) {
 
 export function writeKitsLedger(home, entry) {
   const ledger = readKitsLedger(home);
+  const previous = ledger.kits.find((kit) => kit.id === entry.id);
+  for (const id of previous?.playbooks ?? []) {
+    if (!(entry.playbooks ?? []).includes(id)) {
+      removeOwnedSymlink(path.join(home, 'playbooks', id), previous.kitDir);
+    }
+  }
   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 });
@@ -283,6 +325,7 @@ export function removeKit(home, productId, env = process.env) {
   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 id of entry.playbooks ?? []) removeOwnedSymlink(path.join(home, 'playbooks', id), entry.kitDir);
   for (const asset of entry.assets ?? []) {
     for (const root of resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).read) removeOwnedSymlink(path.join(root, asset.category, asset.id), entry.kitDir);
   }
@@ -299,7 +342,14 @@ 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);
+    const root = path.resolve(kitDir);
+    let owned = target === root || target.startsWith(`${root}${path.sep}`);
+    try {
+      const realTarget = realpathSync(linkPath);
+      const realRoot = realpathSync(kitDir);
+      owned ||= realTarget === realRoot || realTarget.startsWith(`${realRoot}${path.sep}`);
+    } catch { /* Lexical ownership still handles a removed kit directory. */ }
+    if (owned) rmSync(linkPath);
   } catch (error) {
     if (error?.code !== 'ENOENT') throw error;
   }

package/src/store-command.mjs

@@ -1,3 +1,4 @@
+import { createHash } from 'node:crypto';
 import { spawnSync } from 'node:child_process';
 import {
   copyFileSync, cpSync, existsSync, mkdirSync, mkdtempSync,
@@ -32,6 +33,7 @@ import {
   enableHint,
   ensureKitsMarketplace,
   linkKitAssets,
+  linkKitPlaybooks,
   linkKitSkills,
   readKitManifest,
   readKitsLedger,
@@ -347,11 +349,75 @@ export async function runStoreCommand(args, options = {}) {
 
   if (sub === 'download') {
     const productId = args[1];
-    if (!productId || productId.startsWith('--')) {
+    if (!isSafePathSegment(productId) || productId.startsWith('--')) {
       log(cliText('cli.store.help.downloadUsage'));
       return { exitCode: 1 };
     }
     const creds = readCredentials(env);
+    const publicBase = (options.baseUrl ?? creds?.url ?? DEFAULT_STORE_BASE_URL).replace(/\/$/, '');
+    let freeProduct;
+    try {
+      const listing = await fetchImpl(`${publicBase}/products`);
+      if (listing.ok) {
+        const data = await readJsonResponse(listing);
+        freeProduct = data?.products?.find(item => item.id === productId && item.tier === 'free'
+          && Number.isInteger(item.current_version) && item.current_version >= 1);
+      }
+    } catch { /* Paid download remains available when the public catalog is offline. */ }
+    if (!freeProduct) {
+      // Lab の無料の作り方（playbook）は商品データベースに載らず、無料 R2 の公開カタログ（/assets/catalog.json）にだけ載る。
+      // その行の files[0].key を /assets/<key> から取り、sha256 を照合して保存する。
+      try {
+        const catalogResponse = await fetchImpl(new URL('/assets/catalog.json', publicBase).href);
+        if (catalogResponse.ok) {
+          const catalog = await readJsonResponse(catalogResponse);
+          const row = catalog?.items?.find(item => item?.id === productId && item?.category === 'playbook' && item?.tier === 'free'
+            && Number.isInteger(item?.version) && item.version >= 1 && typeof item?.files?.[0]?.key === 'string');
+          const key = row?.files?.[0]?.key;
+          if (row && /^[a-z0-9][a-z0-9/._-]*\.zip$/.test(key) && !key.includes('..')) {
+            const response = await fetchImpl(new URL(`/assets/${key}`, publicBase).href);
+            if (!response.ok) {
+              log(cliText('cli.store.download.httpFailed', { status: response.status }));
+              return { exitCode: 1 };
+            }
+            const bytes = Buffer.from(await response.arrayBuffer());
+            const expected = row.files[0].sha256;
+            if (typeof expected === 'string' && createHash('sha256').update(bytes).digest('hex') !== expected) {
+              log(cliText('cli.store.download.failed', { message: 'sha256 mismatch' }));
+              return { exitCode: 1 };
+            }
+            const destDir = parseFlag(args, '--dest') ?? process.cwd();
+            mkdirSync(destDir, { recursive: true });
+            const filePath = path.join(destDir, `${productId}-v${row.version}.zip`);
+            writeFileSync(filePath, bytes);
+            log(cliText('cli.store.download.saved', { path: filePath }));
+            return { exitCode: 0, filePath };
+          }
+        }
+      } catch { /* 公開カタログが取れなければ従来の経路へ */ }
+    }
+    if (freeProduct) {
+      const version = freeProduct.current_version;
+      const assetUrl = new URL(`/assets/products/${productId}/v${version}/${productId}-v${version}.zip`, publicBase);
+      try {
+        const response = await fetchImpl(assetUrl.href);
+        if (response.ok) {
+          const destDir = parseFlag(args, '--dest') ?? process.cwd();
+          mkdirSync(destDir, { recursive: true });
+          const filePath = path.join(destDir, `${productId}-v${version}.zip`);
+          writeFileSync(filePath, Buffer.from(await response.arrayBuffer()));
+          log(cliText('cli.store.download.saved', { path: filePath }));
+          return { exitCode: 0, filePath };
+        }
+        if (response.status !== 404 || !creds) {
+          log(cliText('cli.store.download.httpFailed', { status: response.status }));
+          return { exitCode: 1 };
+        }
+      } catch (error) {
+        log(cliText('cli.store.download.failed', { message: error instanceof Error ? error.message : String(error) }));
+        return { exitCode: 1 };
+      }
+    }
     if (!creds) {
       log(cliText('cli.store.status.disconnectedGuide'));
       return { exitCode: 1 };
@@ -410,8 +476,8 @@ export async function runStoreCommand(args, options = {}) {
       log(cliText('cli.store.help.installUsage'));
       return { exitCode: 1 };
     }
-    const hasFrom = args.includes('--from');
-    const fromZip = parseFlag(args, '--from');
+    const hasFrom = args.includes('--from') || args.includes('--from-file');
+    const fromZip = parseFlag(args, '--from-file') ?? parseFlag(args, '--from');
     if (hasFrom && !fromZip) {
       log(cliText('cli.store.help.installUsage'));
       return { exitCode: 1 };
@@ -549,7 +615,7 @@ export async function runStoreCommand(args, options = {}) {
           return { exitCode: 1 };
         }
 
-        const hadInstalledKit = readKitsLedger(home).kits.length > 0;
+        const hadSkillKit = readKitsLedger(home).kits.some(kit => Array.isArray(kit.skills) && kit.skills.length > 0);
         const assetLinks = linkKitAssets(kitDir, manifest, home, {
           env,
           assets: options.assets,
@@ -562,6 +628,8 @@ export async function runStoreCommand(args, options = {}) {
           for (const blocker of skillLinks.blockers) log(cliText('cli.store.install.blocked', { blocker }));
           return { exitCode: 1 };
         }
+        const playbookLinks = linkKitPlaybooks(kitDir, manifest, home, { platform: options.platform });
+        for (const warning of playbookLinks.warnings) log(cliText('cli.store.install.warning', { warning }));
         registerKitAssets(home, manifest, kitDir, assetLinks.items, env);
         writeKitsLedger(home, {
           id: manifest.id,
@@ -569,10 +637,11 @@ export async function runStoreCommand(args, options = {}) {
           installedAt: new Date().toISOString(),
           kitDir,
           skills: skillLinks.linked,
+          playbooks: playbookLinks.linked,
           assets: assetLinks.linked
         });
         ensureKitsMarketplace(home);
-        if (!hadInstalledKit) log(enableHint());
+        if (skillLinks.linked.length > 0 && !hadSkillKit) log(enableHint());
       }
       const packPath = findFile(destDir, 'PACK.json');
       if (packPath) {

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

@@ -91,7 +91,10 @@
     "docs/contract-2026-10-11-ui-i18n.md",
     "docs/contract-2026-10-12-caption-look-v1.md",
     "docs/contract-2026-10-15-playbook-v0.md",
+    "docs/contract-2026-10-15-project-manifest-v0.md",
     "docs/contract-2026-10-15-script-lines-v0.md",
+    "docs/contract-2026-10-16-automation-gates-v0.md",
+    "docs/contract-2026-10-16-recipes-and-connectors-v0.md",
     "packages/akari-ear/package.json",
     "packages/akari-ear/README.md",
     "packages/akari-launcher/package.json",

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

@@ -8,6 +8,7 @@
 ~/.akari/assets/store/<productId>/
 ├── manifest.json
 ├── skills/<skill-name>/SKILL.md
+├── playbooks/<id>/{playbook.json, playbook.md, preview/}
 ├── templates/<name>.json
 ├── assets/<category>/<id>/{meta.json, …}
 ├── docs/*.md
@@ -35,6 +36,7 @@
     "products": ["akari-pop-motion-set"]
   },
   "skills": [{ "dir": "skills/design-world", "name": "design-world" }],
+  "playbooks": [{ "dir": "playbooks/world-intro" }],
   "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": "ワールド編（抜粋）" }],
@@ -44,6 +46,7 @@
 ```
 
 必須フィールドは `schemaVersion`、`id`、`kind`、`name`、`version`、`requires.cli`、`license`。`kind` は v0 では `kit` のみ。`validate-kit-manifest.mjs` はスキル実体、素材メタデータ、テンプレート用途語彙を含めて検査する。
+任意の `playbooks[]` は `playbooks/<id>` を指し、各ディレクトリに playbook-v0 形式の `playbook.json` と `playbook.md`、任意の `preview/` を置く。
 
 ## 3. 展開
 
@@ -53,8 +56,9 @@
 2. `assets[]` を `~/.akari/assets/<category>/<id>` へ相対 symlink で公開する。各素材はリンク前に `validate-asset.mjs` で検査する。
    素材の実体ファイルと checksum は `~/.akari/assets/installed.json` にも登録し、素材 id から解決できるようにする。
 3. `skills[]` を `~/.akari/kits/plugin/skills/<name>` へ相対 symlink で公開する。
-4. `~/.akari/kits/installed.json` に id、version、導入日時、展開先、スキル、素材を記録する。
-5. `templates[]` は移動せず、CLI が各展開先の manifest を列挙して読む。
+4. `playbooks[]` を `~/.akari/playbooks/<id>` へ相対 symlink で公開する。同じ id が手元に実体であれば上書きせず警告して飛ばす。
+5. `~/.akari/kits/installed.json` に id、version、導入日時、展開先、スキル、素材、公開した作り方を記録する。uninstall では記録した作り方の symlink も外す。
+6. `templates[]` は移動せず、CLI が各展開先の manifest を列挙して読む。
 
 manifest が無い商品は従来の素材商品として扱う。検査器や runtime registry が npm 配布物に同梱されておらず照合できない場合は、その検査だけを警告付きでスキップする。`akari store uninstall <productId>` は台帳に記録した symlink と台帳エントリを外し、再導入用の展開ディレクトリは残す。
 

package/vendor/docs/contract-2026-10-15-playbook-v0.md

@@ -48,6 +48,8 @@ updated: 2026-10-15
 | 確認シート | `<project>/.akari/reports/playbook-sheet.html`（読み取り専用・派生） | `akari new --from` |
 
 - 一覧の解決順は **チャンネル → 手元** の 2 択だけ（`create-project` の雛形解決と同じ規律。他の経路を作らない）
+- Lab で入れた作り方は手元の棚に symlink で入る。解決順は 2 択のまま、画面の入手先は `~/.akari/kits/installed.json` の `playbooks` に載っていれば Lab と表示する。
+- Lab の無料の作り方は商品データベースに載せない。無料 R2 の公開カタログ（`/assets/catalog.json`）の `category: playbook` の行の `files[0].key` を `/assets/<key>` から取り、`sha256` を照合してから入れる（`akari store install <id>`）
 - `preview/` は任意（下の項）
 - `preview` のパスはすべて **playbook.json からの相対**。棚（手元・チャンネル）では `preview/cover.png`（任意）と `preview/frames/01.png`〜`05.png`（重要な場面のコマ 3〜5 枚・長辺 640px 以下・作り方の画面比）を置く。表紙が無ければ `frames` の 1 枚目を表紙にする。動画（sample.mp4）は持たない（重いため）。プロジェクトの中では `planning/playbook-preview/frames/` に置く
 - `<id>` は英小文字・数字・ハイフン。同じ `id` は版で区別する（`version` 整数）

package/vendor/docs/contract-2026-10-15-project-manifest-v0.md

@@ -0,0 +1,186 @@
+---
+lifecycle: accepted
+created: 2026-10-15
+updated: 2026-10-16
+---
+
+# project-manifest-v0（プロジェクトの依存グラフ）契約
+
+- 日付: 2026-10-15
+- 状態: **accepted**（2026-10-16。同日の裁定で「作品」の器を廃し、プロジェクトで閉じる形に改訂。開けた問い 2 つは §8 の既定で確定）
+- 前提: `contract-2026-07-17-data-contract-versioning.md`（版管理三原則。本契約は初版から適用する）/
+  `contract-2026-09-02-asset-reference-model.md`（プロジェクトの参照台帳 `.akari/asset-references.json`）/
+  `contract-2026-09-24-style-v0.md`（スタイルの利用台帳 `.akari/style-usage.json`）/
+  `contract-2026-10-10-channel-people-design-v0.md`（チャンネルの人物 `people.json`・デザイン素材）/
+  `contract-2026-07-25-project-structure-v0.md`（プロジェクト内の置き場所）/
+  `contract-2026-09-13-world-map-v0.md`（ワールドマップ `planning/world-map.json`。世界観がプロジェクトの中に置かれる先例）
+- 発端: 1 本の動画を超えるもの（複数のシーン・ワールド・人物・外の道具の出力を束ねるもの）を
+  扱うとき、「何が何を使っているか」だけを 1 枚で持ちたい。edit.json は 1 本の並びの正本であり、
+  シーンをまたぐ広がりは持たない。参照台帳と利用台帳は素材・スタイルに限られ、シーン・ワールド・
+  人物・道具の出力を表せない。**単位は増やさない**: 器は従来どおりプロジェクト 1 つで、
+  シーンはその中に 1 段だけ入れ子にする（「作品」という別の器は作らない）
+- スコープ: プロジェクト単位の依存グラフ `manifest.json` の**置き場・形・語彙・解決規則・派生物**と、
+  シーンを持つプロジェクトの最小の構成（§1）。既存の edit.json / 参照台帳 / 利用台帳は変えない（§5）。
+  **相関図や構成の木の UI 実装、Lab への公開形式、外の道具との自動連携、既存プロジェクトの一括移行、
+  アプリが入れ子の edit.json を開く実装は非スコープ**（§7）
+
+## 0. 位置づけ — 持つのは「関係」だけ
+
+manifest は「このプロジェクトに、何が、どの版で関わっているか」の目録である。実体（動画・3D・
+Blender のファイル）は持たず、編集の中身（カットの位置・字幕）も持たない。
+
+| 正本 | 持つもの |
+|---|---|
+| `edit.json` | 1 本（1 シーン）の中の並び（カット・素材の使用範囲・字幕の時刻） |
+| `.akari/manifest.json`（本契約） | プロジェクトに関わるものの一覧（nodes）と、誰が誰を使うかの線（edges） |
+| `.akari/asset-references.json` | 参照する素材の `{category, id}`（従来どおり） |
+| `.akari/style-usage.json` | 当てたスタイルの `style_uid` と `revision`（従来どおり） |
+
+manifest から派生するもの（読み取り専用。正本に書き戻さない）:
+相関図（HTML・inline SVG）/ 構成の木（プロジェクト → シーン → カット）/ 取り込む前の確認シート
+（件数・入手先・要る道具・大きさ）/ 壊れ検査（§4）/ 作り方（playbook）の「使った部品」の章。
+
+## 1. 置き場 — プロジェクトで閉じる
+
+```text
+<project>/                      ← 器はこれ 1 つ（従来どおり）
+├─ edit.json  captions.json     ← 1 本のプロジェクトはここに（従来どおり・変更なし）
+├─ planning/  assets/  .akari/  ← project-structure-v0 のまま
+├─ scenes/                      ← シーンを持つプロジェクトだけ。入れ子はこの 1 段だけ
+│  ├─ scene-01/  edit.json  captions.json  assets/  .akari/   ← 中身は 1 本のプロジェクトと同じ構成
+│  ├─ scene-02/  …
+│  └─ scene-03/  …  assets/scene3d/<id>/{scene.py, params}   ← 道具のレシピ（手で開く道具だけ tools/）
+├─ world/<id>/world.json        ← 世界観（置き場・小物・色。中身は別契約・未起票）
+├─ people.json                  ← このプロジェクトの人物。無ければチャンネルの people.json
+└─ .akari/manifest.json         ← 本契約。プロジェクトの外を指さない
+```
+
+- manifest は `<project>/.akari/manifest.json` の 1 箇所。**プロジェクトの外（他のプロジェクト・
+  チャンネルの別フォルダ）を `where` で指さない**。プロジェクトをまたいで共有したいもの
+  （世界・人物・スタイル・キット）はライブラリかチャンネル経由の参照（`source`）で持ち、
+  実体はプロジェクトに取り込むか、ライブラリで解決する
+- `scenes/<scene>/` の中は 1 本のプロジェクトと同じ構成で、`edit.json` を持つ。
+  **`scenes/` の下にさらに `shots/` `layers/` のような層を作らない**（入れ子は 1 段まで）
+- **シーンを開く**: アプリはシーンのフォルダ `scenes/<scene>/` をそのまま作業フォルダとして開く（中身が 1 本の
+  プロジェクトと同じ構成なので、edit.json・captions.json・assets/ の解決は 1 本のときと同じ）。
+  containment の根は**シーンのフォルダ**のまま（1 本のプロジェクトと同じ。`..` で外へ出る参照は従来どおり拒否）。
+  プロジェクト共通の `assets/` の素材をシーンで使うときは、そのシーンの `assets/` へ**ハードリンクで取り込む**
+  （同じボリュームでなければ複写）。manifest には `scene:<id>` → `asset:<category>/<id>` の線を 1 本足し、
+  どのシーンが共通の素材を使っているかは manifest で見る（`../../assets/` での直接参照は v0 では作らない）。
+  シーンのフォルダかどうかは「親の親に `.akari/` があり、親の名前が `scenes`」で判定する
+- 1 本のプロジェクトは `scenes/` を持たず、従来どおりルートの `edit.json` で動く。
+  manifest は無くてもよい（§5）
+- 外の道具は 2 種に分ける。**エージェントが回せる道具**（Blender の bpy・生成 AI の API・ffmpeg）は
+  レシピが正本で、出力は再生成できるキャッシュ（`contract-2026-07-14-3d-bake-recipe.md`。
+  レシピは `assets/scene3d/<id>/`、出力は通常の素材）。**人が手で開く道具**だけ
+  `<project または scene>/tools/<tool>/` に入力の覚え書き・出力ファイル（またはそのリンク）・記録を
+  置いて往復する。どちらも道具の作業フォルダ本体は置かない
+- `assets/` は平らに置く。AI がフォルダを切らない。意味づけ・分析は `analysis.json` と `meta.json` の側に持ち、
+  画面の分類はそこから派生で描く
+
+## 2. 形
+
+```json
+{
+  "version": 0,
+  "kind": "akari-project-manifest",
+  "project": { "id": "hoshi-no-oji", "name": "星の王子さま", "revision": 3 },
+  "nodes": [
+    { "id": "world:desert",      "kind": "world",       "rev": 2, "where": "world/desert" },
+    { "id": "person:prince",     "kind": "person",      "rev": 5, "where": "people.json#p-prince" },
+    { "id": "scene:01",          "kind": "scene",       "rev": 1, "where": "scenes/scene-01" },
+    { "id": "asset:still/rose",  "kind": "asset",       "rev": 1, "source": "lab", "category": "still" },
+    { "id": "style:caption-a",   "kind": "style",       "rev": 2, "uid": "st_01HZ…" },
+    { "id": "tool:blender/s01",  "kind": "tool-output", "rev": 1, "tool": "Blender 4.2",
+      "where": "scenes/scene-01/assets/generated/<id>.mp4" }
+  ],
+  "edges": [
+    { "from": "scene:01", "uses": "world:desert" },
+    { "from": "scene:01", "uses": "person:prince" },
+    { "from": "scene:01", "uses": "tool:blender/s01" },
+    { "from": "tool:blender/s01", "uses": "person:prince", "note": "レンダーに使ったモデル" }
+  ]
+}
+```
+
+- `version`: 整数。初版は 0（原則 1）。`kind` は固定文字列 `"akari-project-manifest"`
+- `project`: 任意。`id` は英小文字・数字・ハイフン。`revision` はプロジェクトの版（整数・増えるだけ）
+- `nodes[]`: 必須。各要素は `id`・`kind`・`rev` が必須。`where` は**プロジェクトルートからの相対パス**
+  （`..` を含めない。`people.json#<id>` のようなフラグメント指定を許す）。
+  `source` は `builtin` / `lab` / `own` / `site` / `ai` / `channel`（入手先。参照台帳の
+  `sourceKind` と同じ語彙 + `ai` + `channel`）。`tool` は道具の名前と版の自由文。`tool-output` は任意で `recipe`（作ったレシピの `<id>@<版>`）・
+  `connector`（呼んだ接続〈サービス・ソフトウェア〉の名前と版）・`inputs_sha256`（入力のハッシュ）を持てる（再現と壊れ検査用）
+- `edges[]`: 必須（空でもよい）。`from` と `uses` は nodes の `id`。`note` は任意。
+  同じ `{from, uses}` の重複は持たない。自己参照と循環は持たない（§4 で検査）
+- 並び: nodes は `kind` → `id`、edges は `from` → `uses` の安定ソート。書き込みは
+  tmp + rename の原子的更新。読み手は tolerant reader（未知フィールドは保持、欠損は既定値）
+
+## 3. 語彙（kind と id の接頭辞）
+
+| kind | id の形 | 指すもの | 版の正本 |
+|---|---|---|---|
+| `project` | `project:<id>` | プロジェクトそのもの（親を指すときだけ使う） | manifest の `project.revision` |
+| `scene` | `scene:<id>` | `scenes/<id>/`（中は 1 本のプロジェクトと同じ構成） | そのシーンの `edit.json` の更新 |
+| `world` | `world:<id>` | 世界観（場所・小物・色の束。`world/<id>/`） | `world.json` の revision（別契約・未起票） |
+| `person` | `person:<id>` | `people.json` の 1 件（人・アバター・団体）。プロジェクトに無ければチャンネル | `people.json` の `edited` |
+| `asset` | `asset:<category>/<id>` | 素材（参照台帳と同じ `{category, id}`） | `.meta.json` の版 |
+| `style` | `style:<id>` | スタイル（`style_uid` と `revision`） | `style.json` の revision |
+| `kit` | `kit:<channel>` | チャンネルのキット（将来） | kit の revision |
+| `playbook` | `playbook:<id>` | 作り方（将来） | playbook の version |
+| `tool-output` | `tool:<tool>/<id>` | 外の道具が出したファイル（レシピから焼いたものは provenance を持つ） | レシピ由来は provenance の版、手作業は `rev` を手で上げる |
+| `doc` | `doc:<name>` | 台本・ストーリーボード・企画書など読む文書 | ファイルの mtime |
+
+新しい kind は**この表に追記してから**使う。未知の kind を読んだ読み手は捨てず保持し、
+相関図では「その他」として描く（原則 3）。
+
+## 4. 解決と検査
+
+- 解決: `where` はプロジェクトルートからの相対で解決する。`person` と `kit` だけは、プロジェクトに
+  無ければチャンネル（`channels/<channel>/`）で再解決してよい（`source: channel`）。`asset` は
+  参照台帳と同じ順（プロジェクト実体 → 共有ライブラリ）で解決する。どの経路でも字句・realpath の
+  containment を満たさないパスは fail-closed で拒否する
+- 検査（`akari project check` を想定。exit 非 0 は要修正）:
+  1. `edges` の `from` / `uses` が nodes に無い → 欠落
+  2. `where` の実体が無い → 未取得（`asset` で `source: lab` なら「未取得」、それ以外は「欠落」）
+  3. 参照先の版が node の `rev` より新しい → 古い（情報。自動では直さない）
+  4. 自己参照・循環 → 壊れ
+  5. `source: site` または `own` で外部の実体を含む node が、公開用の写し（§6）に残っている → 公開不可
+- 検査結果は `.akari/reports/manifest-check.json` に書き、HTML の派生と画面の帯はそこから描く
+
+## 5. 既存ファイルとの関係（追加のみ・移行なし）
+
+- `.akari/asset-references.json` と `.akari/style-usage.json` は**そのまま**。manifest の
+  `asset` / `style` の nodes は、この 2 つから機械的に生成できる（`akari project sync`。
+  シーンを持つプロジェクトでは各 `scenes/<id>/.akari/` の台帳を束ねる）。
+  手で足した nodes（world・person・tool-output・doc）は sync で消さない
+- `edit.json` は変えない。`scene` の node から `scenes/<id>/edit.json` を開けばカットの並びが見える
+- 1 本のプロジェクトでは manifest を作らなくてもよい（無ければ 2 つの台帳だけで従来どおり動く）
+
+## 6. 公開用の写し
+
+作り方やプロジェクトを手元の外へ出すときは、manifest の**公開用の写し**を別に作る。写しでは
+`where` を落として `id`・`kind`・`rev`・`source` だけを残し、`source: own` / `site` の
+node は仮枠（`placeholder: true`）に置き換える。写しの形は本契約と同じ（`version: 0`）。
+どの node を仮枠にするかの規則と、見本の扱いは作り方（playbook）側の契約で定める（未起票）。
+
+## 7. 非スコープ
+
+- 相関図・構成の木の画面（派生の描き方は別途）
+- アプリが `scenes/<id>/edit.json` を開く実装（現状はルートの `edit.json` のみ）
+- Lab での公開形式・取り込みの UI
+- 外の道具（Blender 等）との自動連携・起動
+- 既存プロジェクトへの manifest の一括生成
+- `world` の中身の契約（`world.json`）と `kit` / `playbook` の契約
+
+## 8. 裁定済みと開けた問い
+
+- 裁定（2026-10-15）: 器はプロジェクト 1 つ。「作品」という別の器は作らず、シーンは `scenes/` に
+  1 段だけ入れ子にする。manifest はプロジェクトの外を指さない
+- 確定（2026-10-16。次の既定を採用）:
+  1. `person` の版は v0 では `people.json` の `edited`（ISO 時刻）を整数に写さず、node に `edited` を
+     そのまま持たせて比べる（`rev` は sync が `edited` の変化ごとに 1 上げる）。専用の revision は足さない
+  2. `tool-output` の `rev` は手で上げてよいが、node に任意の `sha256` を持たせ、sync は実体のハッシュが
+     変わったら `rev` を 1 上げる（手作業の上げ忘れを拾う）
+- CLI: `akari project sync`（台帳 → nodes の生成・手で足した nodes は保持）/ `akari project check`
+  （§4 の検査 → `.akari/reports/manifest-check.json`・exit 非 0 は要修正）/ `akari project scene add <id>`
+  （`scenes/<id>/` を 1 本のプロジェクトと同じ雛形で作り、manifest に `scene` の node を足す）

package/vendor/docs/contract-2026-10-16-automation-gates-v0.md

@@ -0,0 +1,87 @@
+---
+lifecycle: accepted
+created: 2026-10-16
+updated: 2026-10-16
+---
+
+# automation-gates-v0（自動化の門と「やったこと」）契約
+
+- 日付: 2026-10-16
+- 状態: **accepted**
+- 前提: `skills/edit-plan/autonomy.md`（おまかせ度 3 つと止まる条件 3 つ）/ `.akari/intake.json` の `autonomy`
+  （`full-auto` そのまま / `checkpoint` 提案つき・既定 / `collaborative` 一緒に作る）/
+  `contract-2026-08-12-chat-approval-v0.md`（チャットは配管・閉じた語彙の承認）/
+  `contract-2026-07-25-project-structure-v0.md`（`.akari/events/` = 作業の節目の記録。追記のみ）/
+  `contract-2026-09-13-generation-v0.md` §8（費用承認）
+- 発端: エージェントに任せて見ていないあいだも作業を止めたくない。一方で、戻せないことは人が決めたい。
+  線を「見ているか」ではなく **「戻せるか」** で引き直し、止まる場所（門）を 1 つの表にまとめる。
+  止まらずに進んだことは、あとで一覧から見て戻せるようにする
+- スコープ: 門の語彙と判定 / 門の依頼と返事の出来事 / エージェントの「やったこと」の出来事 / やったこと一覧と戻し方。
+  **新しいおまかせ度は作らない**（既存の 3 つを使う）
+
+## 1. 原則 — 戻せることは止めない、戻せないことだけ止める
+
+- プロジェクトの中で閉じていて戻せる変更（edit.json・captions.json・planning/・生成した素材の追加）は、
+  見ていなくても**そのまま書いてよい**。書いたら §3 の `agent-action` を 1 件残す。アプリはそれを節目として git に撮るので、
+  あとで一覧から戻せる
+- 戻せないこと・外に出ること・お金と権利に触ることは **門**（§2）で止まり、人の返事を待つ
+- おまかせ度は「門以外でどれだけ確認を挟むか」だけを変える。門は**どのおまかせ度でも止まる**
+
+| おまかせ度 | 門 | 門以外の確認 |
+|---|---|---|
+| `full-auto` そのまま | 止まる | 挟まない（進めて後で見る） |
+| `checkpoint` 提案つき（既定） | 止まる | 書き出しの前に 1 回 + 作り方が宣言した確認点 |
+| `collaborative` 一緒に作る | 止まる | 方針・素材・実行の要所ごと（edit-plan の承認手順） |
+
+## 2. 門の語彙（閉じた表）
+
+| `gate` | 何のとき | 戻せない理由 |
+|---|---|---|
+| `publish` | 公開・投稿（YouTube 等へのアップロード、共有リンクの発行） | 外に出る |
+| `lab-submit` | Lab・ストアへの提出 | 外に出る |
+| `paid` | 有償の生成・購入（費用承認と同じ。見積を添える） | お金 |
+| `external-send` | 素材や文書を外部のサービスへ送る（生成 API に人物の写真を送る等） | 外に出る |
+| `delete-original` | 元素材（`assets/` の取り込んだ実体）の削除・上書き | 戻せない |
+| `license` | ライセンスの疑義（出どころ不明・商用不可の疑い・規約に触れる道具の使用） | 権利 |
+| `playbook-checkpoint` | 作り方（`playbook.json` の steps の `checkpoint`）が宣言した確認点 | 作った人が止めたい所 |
+| `human-asked` | 人が「確認して」と頼んだ所 | 人の指定 |
+
+- 表に無いものは門にしない（書き出しは上書きしない限り戻せるので門ではない）。新しい門は**この表に追記してから**使う
+- lint の FAIL が直せないときは門ではなく報告（autonomy.md §4 の 3 のまま）
+
+## 3. 出来事（`.akari/events/` に 1 件 1 ファイル・追記のみ）
+
+ファイル名は `<ISO 時刻の数字>-<id>.json`。既存の出来事（`report-generated` 等）と同じ置き場・同じ規律（既存の記録は変更しない）。
+
+```json
+{ "version": 1, "id": "act-01J…", "type": "agent-action", "occurredAt": "2026-10-16T01:23:45+09:00",
+  "actor": "partner", "summary": "無音を 12 か所カット", "files": ["edit.json"], "skill": "silence-cut" }
+```
+
+| `type` | 書く人 | 必須の項目 | アプリの振る舞い |
+|---|---|---|---|
+| `agent-action` | エージェント | `actor`（`partner` 中の相棒 / `external` 外のエージェント / `unattended` 無人）・`summary`（1 行）・`files` | 節目として git に撮る（コミットの本文に summary） |
+| `gate-requested` | エージェント | `gate`（§2）・`summary`・`detail`（任意。見積・送り先・対象ファイル）・`requestId` | 門の帯を出す（承認 / やめる） |
+| `gate-resolved` | アプリ（人の操作）か人 | `requestId`・`decision`（`approved` / `declined`）・`by`（`human`） | 帯を消す。エージェントはこれを読んで進むかやめる |
+
+- エージェントは `gate-requested` を書いたら、その `requestId` の `gate-resolved` が来るまで、その門の向こうの操作をしない
+  （門と関係の無い戻せる作業は続けてよい）
+- `gate-resolved` を書けるのは人の操作だけ（アプリの帯のボタン・チャットの承認の語彙）。エージェントは書かない
+- 読み手は tolerant reader（未知の type は無視・未知のフィールドは保持）
+
+## 4. やったこと一覧と戻し方
+
+- 一覧はプロジェクトの節目（git のコミット）を新しい順に並べたもの。行 = 時刻・誰が（あなた / 相棒 / 外のエージェント / 無人）・
+  1 行の要約・変わったファイル数。`agent-action` から撮った節目は summary と actor を出す
+- 行の操作: **変更を見る**（既存の差分表示）/ **ここまで戻す**（その節目の直前の状態にファイルを戻し、それを新しい節目として撮る。
+  履歴は消さない = 戻したこと自体も戻せる）
+- 入口: プロジェクトのホームの「履歴」と、門の帯の「やったこと」。プロジェクトが git を持たないときは一覧を出さず理由を 1 行
+- 素材の実体（`assets/` の取り込んだファイル）と書き出し（`exports/`）は履歴に入らない（`history-policy.mjs`）。
+  戻すのは編集データと文書だけで、元素材は戻らない（だから削除・上書きは門）
+
+## 5. 非スコープ
+
+- 通知（OS の通知・メール）。v0 はアプリを開いたときの帯と一覧だけ
+- 門の承認をチャット以外の外部（スマホ等）から返す経路
+- おまかせ度の新設・名前の変更
+- `publish` / `lab-submit` の実体（アップロード機能そのもの）。v0 は門の語彙と帯だけを用意する

package/vendor/docs/contract-2026-10-16-recipes-and-connectors-v0.md

@@ -0,0 +1,82 @@
+---
+lifecycle: draft
+created: 2026-10-16
+updated: 2026-10-16
+---
+
+# recipes-and-connectors-v0（レシピと接続の 2 層）契約
+
+- 日付: 2026-10-16
+- 状態: **ドラフト・語の裁定待ち**（§6。形と層の分け方は確定方向、「レシピ」の語の割り当てが未裁定）
+- 前提: `contract-2026-07-14-3d-bake-recipe.md`（道具のレシピ = 正本、焼いた出力 = 再生成できるキャッシュ）/
+  `contract-2026-09-13-extension-kit-v0.md`（キットの manifest。v0 の `kind` は `kit` のみ）/
+  `packages/schemas/connections.schema.json`（接続の台帳。`kind`: genai / image / video / tts / music / sns / analytics / notify）/
+  `packages/schemas/gen-models.json`（生成モデルの台帳）/ `contract-2026-10-15-playbook-v0.md`（作り方）/
+  `contract-2026-10-15-project-manifest-v0.md`（tool-output の `recipe` / `connector`）/
+  `contract-2026-10-16-automation-gates-v0.md`（`paid` / `external-send` / `license` の門）
+- 発端: 外の道具・サービス（生成 AI・音楽生成・3D・TTS）が増えると、「何をしたいか」と「どのサービスで叩くか」が
+  1 つの手順に混ざり、サービスを差し替えるたびに手順が壊れる。公式の API が無いサービスは自前のアダプタが要り、
+  それはプラグイン的な部品になる
+- スコープ: 層の分け方・能力（capability）の語彙・接続の宣言・アダプタの配り方・manifest への記録。
+  **個々のアダプタの実装・非公式な叩き方の同梱・MCP サーバーは扱わない**（§5）
+
+## 1. 3 つの層
+
+| 層 | 単位 | 例 | 持つもの | 正本 |
+|---|---|---|---|---|
+| 作り方（Playbook） | 動画 1 本の流れ | 15 秒 CM | 工程と確認点。工程からレシピを呼ぶ | `playbook.json` |
+| **レシピ** | **シチュエーション（やりたいこと）** | BGM を 30 秒作る・商品を 3D で回す・口パクを付ける | 入力・ツマミ・出力の形・確認点・**要る能力** | `recipe` の宣言（§3） |
+| **接続** | **サービス・ソフトウェア** | fal・ElevenLabs・Blender・（音楽生成のサービス） | 認証・叩き方（公式 API / 自前アダプタ / ローカル実行）・料金・規約・**持つ能力** | `connections.json` の 1 件 + アダプタ |
+
+- レシピはサービスの名前を書かない。**能力**だけを書く（`needs: ["music-generation"]`）。どの接続で叩くかは、
+  その時に使える接続（認証済み・規約の確認済み）から選ぶ。差し替えてもレシピと作り方は変わらない
+- 3D ベイクのレシピ（`assets/scene3d/<id>/scene.py`）は「レシピ = 3D で回す」と「接続 = Blender（ローカル実行）」が
+  一体になった形として読む。分けるのは 2 つ目の 3D の道具が要ったとき
+
+## 2. 能力の語彙（閉じた表・追記して増やす）
+
+| capability | 中身 | 既存の対応 |
+|---|---|---|
+| `image-generation` | 画像を作る | connections `image` / gen-models `kind: image` |
+| `video-generation` | 動画を作る（i2v・t2v） | connections `video` / gen-models `kind: video` |
+| `music-generation` | 曲を作る | connections `music` |
+| `speech-synthesis` | 読み上げ | connections `tts` |
+| `3d-render` | 3D を焼く | 3D ベイクレシピ（Blender headless） |
+| `transcription` | 文字起こし | 既存の transcribe 系 |
+| `publish` | 投稿する | connections `sns`（門 `publish`） |
+
+## 3. 宣言の形（最小）
+
+レシピ:
+```json
+{ "version": 0, "kind": "akari-recipe", "id": "bgm-30s", "name": "BGM を 30 秒作る",
+  "needs": ["music-generation"], "inputs": { "mood": "string", "durationSec": 30 },
+  "outputs": [{ "kind": "audio", "role": "bgm" }], "checkpoint": "聞いて選ぶ", "gates": ["paid", "external-send"] }
+```
+接続（`connections.json` の既存の 1 件に足す項目）:
+```json
+{ "id": "example-music", "kind": "music", "provides": ["music-generation"],
+  "adapter": { "type": "official-api" }, "terms": { "checked": "2026-10-16", "commercialUse": "allowed" } }
+```
+- `adapter.type`: `official-api`（公式 API）/ `local`（手元で実行する道具）/ `custom`（自前のアダプタ）
+- `custom` のアダプタは拡張キットで配る（キットの `kind` に `tool` を足す。キット契約の改訂が要る）
+- `terms.checked` が無い接続は `license` の門で止まる
+
+## 4. 記録
+
+レシピを回して出たファイルは、プロジェクトの manifest に `tool-output` として載せる:
+`recipe: "<id>@<version>"`・`connector: "<接続の id>"`・`inputs_sha256`。同じレシピと入力で作り直せること、
+接続を差し替えたら何が変わったかが追えること。
+
+## 5. 非スコープと規律
+
+- 公式の API が無いサービスを非公式に叩くアダプタは**同梱しない**。配る場合は個別に審査する（相手の規約に触れうる）
+- 有償・外部送信は門（`paid` / `external-send`）。どのおまかせ度でも止まる
+- MCP サーバーは作らない（2 種類目のエージェントか外部アプリが要ったとき）。外から叩く口はファイル契約と `akari` の副コマンド
+- 個々のアダプタの実装・レシピの GUI
+
+## 6. 開けた問い（オーナー裁定待ち）
+
+1. **語**: 「レシピ」は既に `contract-2026-07-25-recipe-v0.md`（好みの凍結 `recipe.json`。ドラフト・スキル 2 本が参照）と
+   3D ベイクのレシピで使われている。シチュエーションの層を「レシピ」と呼ぶなら、好みの凍結の側を「好み」などへ改名するか
+2. 置き場: レシピの宣言を キット（`recipes/<id>/recipe.json`）と手元（`~/.akari/…`）のどこに置くか（1 の語が決まってから）

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.5.0-beta.3",
+  "version": "1.5.0-beta.4",
   "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/i18n/locales/en/report-project.json

@@ -9,6 +9,8 @@
   "report-project.files.empty.text": "None",
   "report-project.skills.version.heading": "Template version",
   "report-project.skills.version.missing": "Not recorded",
+  "report-project.playbook.inactive.heading": "Settings (planning guidance only)",
+  "report-project.playbook.inactive.status": "Not yet applied (planning guidance)",
   "report-project.git.result.heading": "Git initialization result",
   "report-project.git.action.label": "Performed",
   "report-project.git.action.done": "Yes",

package/vendor/packages/i18n/locales/en/surfaces.json

@@ -2292,7 +2292,11 @@
   "surfaces.home.playbookSource.all.label": "All",
   "surfaces.home.playbookSource.local.label": "Mine",
   "surfaces.home.playbookSource.channel.label": "Channel",
+  "surfaces.home.playbookSource.lab.label": "Lab",
   "surfaces.home.playbookEmpty.message": "No Playbooks yet. Record one from a finished project with record-playbook.",
+  "surfaces.home.playbookLabEmpty.message": "No Playbooks installed from Lab yet.",
+  "surfaces.home.playbookLabCatalog.link": "Browse Lab Playbooks",
+  "surfaces.home.playbookLabInstall.message": "Install one with akari store install <id>.",
   "surfaces.home.playbookSelectHint.message": "Select a Playbook to see its review sheet.",
   "surfaces.home.playbookRead.button": "Read contents",
   "surfaces.home.playbookApply.button": "Import and start",

package/vendor/packages/i18n/locales/ja/report-project.json

@@ -9,6 +9,8 @@
   "report-project.files.empty.text": "なし",
   "report-project.skills.version.heading": "雛形バージョン",
   "report-project.skills.version.missing": "記録なし",
+  "report-project.playbook.inactive.heading": "設定値（まだ効かない・作業の目安）",
+  "report-project.playbook.inactive.status": "まだ効かない（作業の目安）",
   "report-project.git.result.heading": "git 初期化の結果",
   "report-project.git.action.label": "実施",
   "report-project.git.action.done": "実施",

package/vendor/packages/i18n/locales/ja/surfaces.json

@@ -2292,7 +2292,11 @@
   "surfaces.home.playbookSource.all.label": "すべて",
   "surfaces.home.playbookSource.local.label": "自分の",
   "surfaces.home.playbookSource.channel.label": "チャンネル",
+  "surfaces.home.playbookSource.lab.label": "Lab",
   "surfaces.home.playbookEmpty.message": "作り方はまだありません。終わったプロジェクトから record-playbook で記録できます",
+  "surfaces.home.playbookLabEmpty.message": "Lab から入れた作り方はまだありません。",
+  "surfaces.home.playbookLabCatalog.link": "Lab の作り方を見る",
+  "surfaces.home.playbookLabInstall.message": "akari store install <id> で入れられます。",
   "surfaces.home.playbookSelectHint.message": "作り方を選ぶと確認シートが出ます。",
   "surfaces.home.playbookRead.button": "中身を読む",
   "surfaces.home.playbookApply.button": "取り込んで始める",

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

@@ -546,13 +546,20 @@ ${REPORT_STYLE}
         <dt${attr('git.eligibility.label')}>${q('git.eligibility.label')}</dt><dd>${escapeHtml(report.git.eligibility)}</dd>
         <dt${attr('git.reason.label')}>${q('git.reason.label')}</dt><dd>${escapeHtml(gitReason)}</dd>
       </dl>
-    </section>${report.missingTools?.length ? `\n    <section><h2>無い道具</h2>${renderList(report.missingTools, '')}</section>` : ''}
+    </section>${report.missingTools?.length ? `\n    <section><h2>無い道具</h2>${renderList(report.missingTools, '')}</section>` : ''}${renderInactiveSettingsSection(report.beforeCommit?.inactiveSettings, lang)}
   </main>
 ${dictionary}</body>
 </html>
 `;
 }
 
+function renderInactiveSettingsSection(inactiveSettings, lang) {
+    if (!inactiveSettings?.length) return '';
+    const q = key => reportText('report-project', `report-project.${key}`, lang);
+    const attr = key => lang === 'en' ? ` data-i18n="report-project.${key}"` : '';
+    return `\n    <section data-akari-playbook-inactive><h2${attr('playbook.inactive.heading')}>${q('playbook.inactive.heading')}</h2>${renderList(inactiveSettings.map(key => `${key}: ${q('playbook.inactive.status')}`), q('files.empty.text'))}</section>`;
+}
+
 function renderPlaybookSheetHtml(playbook, missingTools) {
     const row = (name, value) => `<dt>${escapeHtml(name)}</dt><dd>${value}</dd>`;
     const list = (items) => items.length ? `<ul>${items.map(item => `<li>${escapeHtml(item)}</li>`).join('')}</ul>` : '<p>なし</p>';
@@ -560,7 +567,8 @@ function renderPlaybookSheetHtml(playbook, missingTools) {
     const placeholders = (playbook.placeholders ?? []).map(item => `${item.role} / ${item.kind} / 見本 ${item.sample ? `あり (${item.sample.category}/${item.sample.id})` : 'なし'}`);
     const beats = (playbook.beats ?? []).map(beat => `${beat.at}–${beat.at + beat.duration} 秒 / ${beat.title}${beat.note ? ` / ${beat.note}` : ''}`);
     const parts = (playbook.parts ?? []).map(item => `${item.kind}: ${item.id} / ${item.source} / ${item.license} / Pro ${item.tier === 'pro' ? '要' : item.tier === 'free' ? '不要' : '不明'}`);
-    const settings = Object.entries(playbook.settings).map(([key, value]) => `${key}: ${JSON.stringify(value)}`);
+    const inactiveSettings = inactivePlaybookSettings(playbook.settings);
+    const settings = Object.entries(playbook.settings).map(([key, value]) => `${key}: ${JSON.stringify(value)}${inactiveSettings.some(inactive => inactive === key || inactive.startsWith(`${key}.`)) ? '（まだ効かない・作業の目安）' : ''}`);
     const provenance = playbook.provenance;
     const applied = provenance.appliedFrom;
     const origin = `${provenance.fromProject} / ${provenance.recordedAt} / AKARI ${provenance.akariVersion}`
@@ -692,7 +700,16 @@ async function toolExists(name) {
     return false;
 }
 
-function applySettings(edit, settings) {
+function inactivePlaybookSettings(settings) {
+    return [
+        ...(settings.captions?.styleUid ? ['captions.styleUid'] : []),
+        ...(settings.captions?.position ? ['captions.position'] : []),
+        ...(settings.transitions?.default ? ['transitions.default'] : []),
+        ...(settings.audio?.roles ? ['audio.roles'] : [])
+    ];
+}
+
+function applySettings(edit, intake, settings) {
     const aspect = settings.aspect;
     if (typeof aspect === 'string' && /^\d+:\d+$/.test(aspect)) {
         const [widthRatio, heightRatio] = aspect.split(':').map(Number);
@@ -703,17 +720,14 @@ function applySettings(edit, settings) {
         }
     }
     if (Number.isInteger(settings.fps) && settings.fps > 0) edit.output.fps = settings.fps;
-    if (Number.isFinite(settings.targetDurationSec)) edit.output.target_duration_sec = settings.targetDurationSec;
-    if (settings.captions?.styleUid) edit.output.caption_style_uid = settings.captions.styleUid;
-    if (settings.captions?.position) edit.output.caption_position = settings.captions.position;
-    if (settings.transitions?.default) edit.output.default_transition = settings.transitions.default;
-    if (settings.audio?.roles) {
-        edit.audio ??= {};
-        edit.audio.role_gains_db = { ...settings.audio.roles };
+    if (Number.isFinite(settings.targetDurationSec) && settings.targetDurationSec > 0) {
+        intake.target ??= {};
+        intake.target.duration_s = settings.targetDurationSec;
+        intake.target.keep_length = false;
     }
 }
 
-function addPlaceholders(edit, placeholders, beats) {
+function addPlaceholders(edit, placeholders, beats, targetDurationSec) {
     const fps = edit.output.fps;
     const hasBeats = Array.isArray(beats) && beats.length > 0;
     const track = { id: 'playbook-placeholders', name: '仮枠（映像）', lane: 'visual', items: [] };
@@ -721,8 +735,11 @@ function addPlaceholders(edit, placeholders, beats) {
     let at = 0;
     if (hasBeats) {
         for (const beat of [...beats].sort((a, b) => a.at - b.at || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))) {
-            const start = Math.round(beat.at * fps);
-            const duration = Math.max(1, Math.round(beat.duration * fps));
+            // 始まりと終わりをそれぞれコマに丸めて差を取る（別々に丸めると小数の秒で 1 コマ重なる）。
+            // 前の内訳と重なる書き方でも、同じ段で重ならないよう前の終わりから始める
+            const start = Math.max(at, Math.round(beat.at * fps));
+            const end = Math.round((beat.at + beat.duration) * fps);
+            const duration = Math.max(1, end - start);
             track.items.push({
                 id: `playbook-${beat.id}`, at: start, duration, name: beat.title,
                 source: { kind: 'group', canvas: { origin: 'plan', durationMode: 'fixed', intent: beat.note || beat.title,
@@ -750,7 +767,7 @@ function addPlaceholders(edit, placeholders, beats) {
     if (track.items.length) edit.tracks.push(track);
     for (const placeholder of placeholders) {
         if (placeholder.kind !== 'audio') continue;
-        const duration = at || Math.max(1, Math.round((placeholder.durationHintSec ?? edit.output.target_duration_sec ?? 5) * fps));
+        const duration = at || Math.max(1, Math.round((placeholder.durationHintSec ?? targetDurationSec ?? 5) * fps));
         audioTrack.items.push({
             id: `playbook-${placeholder.id}`, at: 0, duration,
             name: placeholder.sample
@@ -809,19 +826,26 @@ export async function applyPlaybook({ projectDir, playbookDir, now = new Date(),
     }
     const planning = path.join(destination, 'planning');
     const editPath = path.join(destination, 'edit.json');
+    const intakePath = path.join(destination, '.akari', 'intake.json');
     const edit = JSON.parse(await fs.readFile(editPath, 'utf8'));
+    const intake = JSON.parse(await fs.readFile(intakePath, 'utf8'));
     if (edit.version !== 2) throw new Error('作り方の適用には edit.json v2 が必要です');
     const playbookJsonPath = path.join(planning, 'playbook.json');
     const playbookMdPath = path.join(planning, 'playbook.md');
     const sheetPath = path.join(destination, '.akari', 'reports', 'playbook-sheet.html');
+    const creationReportPath = path.join(destination, '.akari', 'reports', 'create-project-report.html');
+    const existingCreationReport = await fs.readFile(creationReportPath, 'utf8').catch(error => {
+        if (error.code === 'ENOENT') return null;
+        throw error;
+    });
     for (const file of [playbookJsonPath, playbookMdPath, sheetPath]) {
         try { await fs.access(file); throw new Error(`既存ファイルは上書きしません: ${file}`); }
         catch (error) { if (error.code !== 'ENOENT') throw error; }
     }
     playbook.provenance.appliedFrom = { path: source, playbookVersion: playbook.playbookVersion, appliedAt: now.toISOString() };
-    applySettings(edit, playbook.settings);
+    applySettings(edit, intake, playbook.settings);
     const activeBeats = playbook.beats?.length ? playbook.beats : undefined;
-    const placeholdersAdded = addPlaceholders(edit, playbook.placeholders ?? [], activeBeats);
+    const placeholdersAdded = addPlaceholders(edit, playbook.placeholders ?? [], activeBeats, playbook.settings.targetDurationSec);
     const scriptPath = path.join(planning, 'script.json');
     const existingScript = activeBeats ? await fs.readFile(scriptPath, 'utf8').then(JSON.parse).catch(error => {
         if (error.code === 'ENOENT') return null;
@@ -835,7 +859,17 @@ export async function applyPlaybook({ projectDir, playbookDir, now = new Date(),
     await fs.writeFile(playbookMdPath, markdown, { flag: 'wx' });
     await writeJsonAtomic(playbookJsonPath, playbook);
     await writeJsonAtomic(editPath, edit);
+    await writeJsonAtomic(intakePath, intake);
     if (script) await writeJsonAtomic(scriptPath, script);
     await fs.writeFile(sheetPath, renderReportHtml(null, { playbook, missingTools }), { flag: 'wx' });
-    return { playbookJsonPath, playbookMdPath, sheetPath, placeholdersAdded, missingTools };
+    const inactiveSettings = inactivePlaybookSettings(playbook.settings);
+    if (existingCreationReport && inactiveSettings.length > 0
+        && !existingCreationReport.includes('data-akari-playbook-inactive')
+        && existingCreationReport.includes('</main>')) {
+        const lang = reportLanguage(/<html lang="([^"]+)"/.exec(existingCreationReport)?.[1]);
+        const section = renderInactiveSettingsSection(inactiveSettings, lang);
+        await fs.writeFile(creationReportPath, existingCreationReport.replace('</main>', `${section}\n  </main>`), 'utf8');
+    }
+    return { playbookJsonPath, playbookMdPath, sheetPath, placeholdersAdded, missingTools,
+        inactiveSettings };
 }

package/vendor/packages/schemas/bin/validate-kit-manifest.mjs

@@ -49,6 +49,7 @@ validateManifest(manifest);
 validateRequiredFiles();
 validateRuntimes(manifest);
 validateSkills(manifest);
+validatePlaybooks(manifest);
 validateTemplates(manifest);
 validateAssets(manifest);
 validateDocs(manifest);
@@ -89,7 +90,7 @@ function validateManifest(value) {
   }
 
   const required = ["schemaVersion", "id", "kind", "name", "version", "requires", "license"];
-  const optional = ["skills", "templates", "assets", "docs", "provenance"];
+  const optional = ["skills", "templates", "assets", "docs", "playbooks", "provenance"];
   requireFields(value, required, "manifest");
   rejectUnknownFields(value, [...required, ...optional], "manifest");
 
@@ -108,6 +109,11 @@ function validateManifest(value) {
     validateNonEmptyString(entry.dir, `${label}.dir`);
     validateNonEmptyString(entry.name, `${label}.name`);
   });
+  validateObjectArray(value.playbooks, "playbooks", ["dir"], (entry, label) => {
+    if (typeof entry.dir !== "string" || !/^playbooks\/[a-z0-9][a-z0-9-]*$/u.test(entry.dir)) {
+      fail(`${label}.dir は playbooks/<id> である必要があります`);
+    }
+  });
   validateObjectArray(value.templates, "templates", ["path", "for", "label"], (entry, label) => {
     validateNonEmptyString(entry.path, `${label}.path`);
     if (entry.for !== "world-map") fail(`${label}.for は world-map である必要があります`);
@@ -270,6 +276,44 @@ function validateTemplates(value) {
   }
 }
 
+function validatePlaybooks(value) {
+  if (!Array.isArray(value?.playbooks)) return;
+  const validator = path.join(ownDir, '..', 'validate-playbook.mjs');
+  const seen = new Set();
+  for (const [index, entry] of value.playbooks.entries()) {
+    if (!isPlainObject(entry) || typeof entry.dir !== 'string'
+      || !/^playbooks\/[a-z0-9][a-z0-9-]*$/u.test(entry.dir)) continue;
+    const id = path.posix.basename(entry.dir);
+    if (seen.has(id)) { fail(`playbooks[${index}].dir が重複しています: ${id}`); continue; }
+    seen.add(id);
+    const dir = path.resolve(kitDir, entry.dir);
+    if (!isDirectory(dir) || !isInside(kitRealDir, fs.realpathSync(dir))) {
+      fail(`playbooks[${index}].dir が見つからないか kit-dir の外を指します: ${entry.dir}`);
+      continue;
+    }
+    const json = path.join(dir, 'playbook.json');
+    const markdown = path.join(dir, 'playbook.md');
+    if (!isRegularFile(json) || !isRegularFile(markdown)
+      || !isInside(kitRealDir, fs.realpathSync(json))
+      || !isInside(kitRealDir, fs.realpathSync(markdown))) {
+      fail(`playbooks[${index}] に playbook.json と playbook.md が必要です: ${entry.dir}`);
+      continue;
+    }
+    try {
+      if (JSON.parse(fs.readFileSync(json, 'utf8')).id !== id) {
+        fail(`playbooks[${index}] の id がフォルダ名と一致しません: ${id}`);
+      }
+    } catch (error) {
+      fail(`playbooks[${index}] の playbook.json を読めません: ${messageOf(error)}`);
+      continue;
+    }
+    const result = spawnSync(process.execPath, [validator, json, markdown], { encoding: 'utf8' });
+    if (result.status !== 0) {
+      fail(`playbooks[${index}] が validate-playbook に失敗しました: ${(result.stderr || result.error?.message || '').trim()}`);
+    }
+  }
+}
+
 function validateAssets(value) {
   if (!Array.isArray(value?.assets)) return;
   const validatorPath = path.join(ownDir, "validate-asset.mjs");

package/vendor/packages/schemas/kit-manifest.schema.json

@@ -53,6 +53,17 @@
         }
       }
     },
+    "playbooks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["dir"],
+        "properties": {
+          "dir": { "type": "string", "pattern": "^playbooks/[a-z0-9][a-z0-9-]*$" }
+        }
+      }
+    },
     "templates": {
       "type": "array",
       "items": {

package/vendor/packages/schemas/test/kit-playbooks.test.mjs

@@ -0,0 +1,44 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { cpSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Ajv2020 from 'ajv/dist/2020.js';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const sample = path.resolve(root, '../project-scaffold/test/fixtures/playbook-sample');
+const schema = JSON.parse(readFileSync(path.join(root, 'kit-manifest.schema.json'), 'utf8'));
+const validate = new Ajv2020({ strict: false }).compile(schema);
+
+test('kit playbooks validate contents, matching id, and safe directory', () => {
+  const temp = mkdtempSync(path.join(tmpdir(), 'akari-kit-playbook-'));
+  const id = 'test-playbook';
+  const dir = path.join(temp, 'playbooks', id);
+  const manifest = { schemaVersion: 1, id: 'test-kit', kind: 'kit', name: 'Test', version: 1,
+    requires: { cli: '>=1.4.0' }, license: 'CC0-1.0', playbooks: [{ dir: `playbooks/${id}` }] };
+  const run = () => spawnSync(process.execPath, [path.join(root, 'bin', 'validate-kit-manifest.mjs'), temp], { encoding: 'utf8' });
+  try {
+    mkdirSync(dir, { recursive: true });
+    cpSync(path.join(sample, 'playbook.md'), path.join(dir, 'playbook.md'));
+    const playbook = JSON.parse(readFileSync(path.join(sample, 'playbook.json'), 'utf8'));
+    playbook.id = id;
+    const save = () => writeFileSync(path.join(dir, 'playbook.json'), JSON.stringify(playbook));
+    const saveManifest = () => writeFileSync(path.join(temp, 'manifest.json'), JSON.stringify(manifest));
+    save(); saveManifest();
+    writeFileSync(path.join(temp, 'README.md'), '# Test\n');
+    writeFileSync(path.join(temp, 'LICENSE.md'), '# CC0\n');
+    assert.equal(validate(manifest), true, JSON.stringify(validate.errors));
+    assert.equal(run().status, 0, run().stderr);
+    playbook.id = 'different'; save();
+    assert.match(run().stderr, /id がフォルダ名と一致しません/);
+    playbook.id = id; playbook.kind = 'wrong'; save();
+    assert.match(run().stderr, /validate-playbook に失敗/);
+    manifest.playbooks[0].dir = '../outside'; saveManifest();
+    assert.equal(validate(manifest), false);
+    assert.match(run().stderr, /playbooks\[0\]\.dir/);
+  } finally {
+    rmSync(temp, { recursive: true, force: true });
+  }
+});

package/vendor/skills/record-playbook/SKILL.md

@@ -18,7 +18,7 @@ description: Record a finished AKARI Video project's workflow as planning/playbo
 ## Procedure
 
 1. Inspect `decisions.json`, the documents in `planning/`, and report types in `.akari/reports/` for the steps and human checkpoints. If the steps cannot be recovered, use four defaults: place media, confirm script, refine cut, export. Mark uncertain `what` text `要確認`.
-2. Extract starting values from `edit.json`: aspect, fps, target duration, caption style, default transition, and audio roles. Record settings as values to start the next project, not as a copy of every cut.
+2. Extract aspect and fps from `edit.json`, and target duration from `.akari/intake.json` (`target.duration_s`), falling back to the used timeline length when no target is set. Caption style/position, default transition, and audio roles currently have no project-level default consumed when new work is created. Preserve those planning values from an existing `planning/playbook.json` when recording an applied playbook; otherwise infer transition from used cuts and audio roles from item gains where possible. Record settings as values to start the next project, not as a copy of every cut.
 3. Examine `edit.json` sources and available `analysis.json` tags or speaker observations to name placeholder roles. Use `.akari/asset-references.json` and `.akari/style-usage.json` to identify reusable parts and licenses. Keep only `builtin`, `lab`, and `ai` parts. Check used skills and recipe `requires` for required tools and skills. Derive `beats` from plan lines in `planning/script.json` when present; otherwise use chapter headings in captions or `planning/plan.md` together with visual cut boundaries. Write the `## 内訳` table in `playbook.md`.
 4. Run `node skills/record-playbook/bin/record-playbook.mjs <project-root> --name <name> --category <category> [--license <license>]` from a repository checkout, or use `.claude/skills/record-playbook/bin/record-playbook.mjs` from a scaffolded project. The helper writes deterministic structure and `要確認` defaults. If a video exists in `exports/`, it uses `ffmpeg` and `ffprobe` from PATH to extract 3–5 representative PNG frames into `planning/playbook-preview/frames/` and records relative paths in `preview.frames`. `AKARI_FFMPEG` and `AKARI_FFPROBE` can override those commands. If no export or tool is available, or extraction fails, the helper warns and the outcome section says to record again after export. It clears old PNG frames before each extraction. You may review and replace frame choices while keeping 3–5 frames, the playbook aspect ratio, and a maximum long edge of 640 px. Refine the step wording and role names in both files where evidence supports better names; preserve role grouping and validate after editing with `node packages/schemas/validate-playbook.mjs <project-root>/planning/playbook.json` when the repository checkout is available.
 5. Show the playbook and preview frames to the person, then run `node skills/record-playbook/bin/record-playbook.mjs <project-root> --install` if they want the reviewed files copied to their local shelf at `~/.akari/playbooks/<id>/`. This standalone install does not record again, so reviewed frame choices survive. The helper changes preview paths to `preview/frames/0N.png` in the shelf copy and replaces an existing copy only when `playbookVersion` is higher.

package/vendor/skills/record-playbook/bin/record-playbook.mjs

@@ -147,22 +147,22 @@ function defaultSteps(decisions) {
   ];
 }
 
-function settingsFromEdit(edit) {
+function settingsFromEdit(edit, intake, priorSettings = {}) {
   const width = edit.output?.width;
   const height = edit.output?.height;
   const aspect = width && height ? (width < height ? '9:16' : width === height ? '1:1' : '16:9') : '16:9';
   const fps = Number.isInteger(edit.output?.fps) ? edit.output.fps : 30;
   const seconds = asArray(edit.tracks).flatMap(track => asArray(track.items).map(item => ((item.at ?? 0) + (item.duration ?? 0)) / fps));
-  const gains = { ...(edit.audio?.role_gains_db ?? {}) };
+  const gains = { ...(priorSettings.audio?.roles ?? {}) };
   for (const track of asArray(edit.tracks)) for (const item of asArray(track.items)) {
     if (item.role && Number.isFinite(item.gain_db) && gains[item.role] === undefined) gains[item.role] = item.gain_db;
   }
   const transition = asArray(edit.tracks).flatMap(track => asArray(track.items))
     .map(item => item.source?.transition_out?.kind ?? item.source?.transition_out?.type).find(Boolean);
-  return { aspect, fps, targetDurationSec: Math.ceil(Math.max(0, ...seconds)),
-    ...(edit.output?.caption_style_uid ? { captions: { styleUid: edit.output.caption_style_uid,
-      ...(edit.output.caption_position ? { position: edit.output.caption_position } : {}) } } : {}),
-    transitions: { default: edit.output?.default_transition ?? transition ?? 'cut' },
+  return { aspect, fps, targetDurationSec: Number.isFinite(intake.target?.duration_s) && intake.target.duration_s > 0
+    ? intake.target.duration_s : Math.ceil(Math.max(0, ...seconds)),
+    ...(priorSettings.captions ? { captions: priorSettings.captions } : {}),
+    transitions: { default: priorSettings.transitions?.default ?? transition ?? 'cut' },
     ...(Object.keys(gains).length ? { audio: { roles: gains } } : {}) };
 }
 
@@ -393,6 +393,7 @@ export async function recordPlaybook(projectRoot, { name, category, license = 'C
   if (!name || !categories.has(category)) throw new Error('name と category（定義済み語彙）が必要です');
   const project = path.resolve(projectRoot);
   const edit = await readOptional(path.join(project, 'edit.json'));
+  const intake = await readOptional(path.join(project, '.akari', 'intake.json'));
   const analysis = await readOptional(path.join(project, 'analysis.json'));
   const references = await readOptional(path.join(project, '.akari', 'asset-references.json'));
   const styles = await readOptional(path.join(project, '.akari', 'style-usage.json'));
@@ -417,7 +418,7 @@ export async function recordPlaybook(projectRoot, { name, category, license = 'C
     playbookVersion: (prior?.playbookVersion ?? 0) + 1, depth: 2, category,
     tags: { form: [], length: [], technique: [], tools: [], style: [], industry: [], materials: [], scale: [] },
     requires: { cli: `>=${packageJson.version ?? '0.0.0'}`, tools, skills },
-    steps, settings: settingsFromEdit(edit),
+    steps, settings: settingsFromEdit(edit, intake, prior?.settings),
     placeholders: collectPlaceholders(edit, analysis, references), parts: await collectParts(project, references, styles),
     license, provenance: { fromProject: path.basename(project), recordedAt: now.toISOString(),
       akariVersion: packageJson.version ?? '0.0.0', recordedBy: 'record-playbook' }