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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.5.0-beta.2",
+  "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,6 +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,7 +48,10 @@ updated: 2026-10-15
 | 確認シート | `<project>/.akari/reports/playbook-sheet.html`（読み取り専用・派生） | `akari new --from` |
 
 - 一覧の解決順は **チャンネル → 手元** の 2 択だけ（`create-project` の雛形解決と同じ規律。他の経路を作らない）
-- `preview/` は任意。`cover.png` か `sample.mp4` を 1 つまで。無ければ画面は文字だけで出す
+- 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` 整数）
 
 ## 2. 形 — playbook.json
@@ -94,6 +97,8 @@ updated: 2026-10-15
 - 必須: `version`（0 固定。原則 1）・`kind`（`"akari-playbook"`）・`id`・`name`・`playbookVersion`・`depth`・
   `category`・`steps[]`・`settings`・`license`・`provenance`。`tags` / `requires` / `placeholders` / `parts` は
   省略可（depth 1 では `placeholders` と `parts` を持たない）
+- 任意: `preview`（`{ "cover"?: string, "frames"?: string[] }`。パスは上の規則）・`example`（`true` なら見本として配る例。画面に「例」の印を出す）
+- 任意: `beats`（`{ id, at, duration, title, note?, placeholder? }[]`・秒。作り方の内訳。始めたとき空のキャンバスと台本の予定の行になる。script-lines-v0 §5）
 - `category` は 1 つだけ。語彙は閉じる: `film` / `short-drama` / `mv` / `explainer` / `product` / `vlog` / `cm` /
   `education` / `clip` / `logo`。足すときは本表に追記してから
 - `tags` の 8 軸は開いた語彙（自由に足せる）。軸の名前だけ固定: `form` / `length` / `technique` / `tools` /
@@ -118,6 +123,7 @@ updated: 2026-10-15
 ## 流れ                     ← steps を番号つきで。確認点は「☑ ここで確認」と明記
 ## 設定値                   ← settings を表で（キー / 値 / 意味）
 ## 必要な素材（仮枠）        ← placeholders を表で（役割 / 種類 / 尺の目安 / 見本）
+## 内訳                     ← beats を表で（時刻 / 見出し / メモ / 仮枠）
 ## 使った部品               ← parts を表で（種類 / 名前 / 入手先 / ライセンス）
 ## 要る道具                 ← requires（CLI の版・道具・スキル）。無いときの代案を 1 行
 ## ライセンス               ← license と、外部由来を仮枠にした旨
@@ -125,6 +131,7 @@ updated: 2026-10-15
 ```
 
 章の追加は末尾のみ（additive-only）。章の名前は上の表記で固定し、読み手はこの見出しで章を引く。
+例外として「内訳」の 1 章だけは「必要な素材（仮枠）」の直後に置く。
 
 ## 4. 記録する — プロジェクト → 作り方（`record-playbook` スキル）
 

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-15-script-lines-v0.md

@@ -0,0 +1,67 @@
+---
+lifecycle: accepted
+created: 2026-10-15
+updated: 2026-10-15
+---
+
+# script-lines-v0（台本の「予定」と「メモ」の行）契約
+
+- 日付: 2026-10-15
+- 状態: **v0 受理（2026-10-15 オーナー GO）**
+- 前提: `contract-2026-07-25-project-structure-v0.md`（`planning/` は企画・プランの層）/ `contract-2026-09-24-caption-runs-v0.md`（字幕は `captions.json`）/
+  `contract-2026-10-15-playbook-v0.md`（作り方。本契約の「予定」は作り方の内訳 `beats` から作られる）/ `contract-2026-09-25-canvas-v0.md`（空のキャンバス = 区間を持つ仮枠）
+- 発端: 台本パネルは字幕の行しか持たず、「ここに何を入れる予定か」「気づいたメモ」を時刻つきで残せない。作り方の内訳（何秒に何を）も、台本とタイムラインに出す場所が無い
+- スコープ: 予定とメモの行の **置き場・形・台本パネルとタイムラインでの見せ方・作り方からの生成**
+- 非スコープ: 字幕（`captions.json`）の形の変更 / 予定の行から自動でカットを作ること / 複数人の同時編集
+
+## 0. 位置づけ
+
+台本の行は 3 種類。**字幕**（`captions.json`。今のまま）・**予定**（ここに何を入れるつもりか）・**メモ**（気づき・指示）。
+予定とメモは `planning/script.json` に持ち、台本パネルは 3 種を時刻順に 1 本の列で見せる。字幕は今までどおり `captions.json` が正本で、本契約は触らない。
+
+## 1. 置き場
+
+- `<project>/planning/script.json`（無ければ予定もメモも無い。台本パネルは字幕だけで今までどおり動く）
+- シーンを持つプロジェクト（project-manifest v0）では `scenes/<scene>/planning/script.json`。台本パネルは開いているシーンの 1 本を読む
+
+## 2. 形
+
+```json
+{
+  "version": 0,
+  "kind": "akari-script",
+  "lines": [
+    { "id": "p-hook",  "kind": "plan", "at": 0,  "duration": 3,  "text": "つかみ: 結論を先に言う", "placeholder": "talking-head", "beat": "hook" },
+    { "id": "p-body",  "kind": "plan", "at": 3,  "duration": 40, "text": "本題: 3 つのポイント", "placeholder": "screen", "done": false },
+    { "id": "m-01",    "kind": "memo", "at": 12.5, "text": "ここで図解を差し込む" }
+  ]
+}
+```
+
+- `version`: 整数 0（原則 1）。`kind`: 固定 `"akari-script"`
+- `lines[]`: 必須（空でよい）。各行は `id`（ファイル内で一意）・`kind`（`plan` / `memo`）・`at`（秒・0 以上）・`text`（1〜500 文字）が必須
+- 任意: `duration`（秒・0 より大。予定の区間）/ `placeholder`（作り方の仮枠の `id`）/ `beat`（作り方の内訳の `id`）/ `done`（予定が済んだか）/ `author`（`user` / `ai` / `playbook`）
+- 並び: `at` → `id` の安定ソートで保存。書き込みは tmp + rename。読み手は tolerant（未知フィールドは保持、壊れた行は捨てて残りを読む）
+- スキーマ: `packages/schemas/script.schema.json`（closed object・additive-only）と `validate-script.mjs`
+
+## 3. 台本パネル（右ドックの「台本」）
+
+- 字幕・予定・メモを `at` の順に 1 本の列で出す。行の頭に種類の印（字幕 / 予定 / メモ）。予定は `duration` があれば区間（`0:00–0:03`）を出し、`done` はチェックで切り替える
+- 「＋ メモ」で今の再生位置にメモを足す（`author: user`）。予定・メモの文字はその場で直せる。削除はメニューから
+- 行を押すとその時刻へ移動（字幕の行と同じ）。字幕の既存の操作（字幕を作る・カットを整える・QC）は変えない
+- 表示の切り替え: 「予定とメモを出す」のオン / オフ（既定オン）。オフなら今までの字幕だけの台本
+
+## 4. タイムライン
+
+- タイムラインの最上段に「台本」の段を 1 本足し、予定を区間の帯、メモを点の印で出す（`script.json` が無ければ段を出さない）。押すとその時刻へ移動。ここでは編集しない（直すのは台本パネル）
+
+## 5. 作り方からの生成
+
+- 作り方（playbook.json）の任意項目 `beats[]`（`{ id, at, duration, title, note?, placeholder? }`・秒）を、`applyPlaybook` が
+  予定の行（`kind: plan`・`text` = `title`（`note` があれば「title: note」）・`author: playbook`）として `planning/script.json` に書く。
+  同時に、内訳 1 つ = 空のキャンバス 1 つ（名前 = title・`canvas.intent` = note か title）にして仮枠の段に並べる（`beats` が無いときは従来どおり仮枠ごとに 1 つ）
+- `record-playbook` は、終わったプロジェクトの `planning/script.json` の予定の行（あれば）と章・見出しから `beats` を起こす
+
+## 6. 開けた問い
+
+1. 予定の行を「済」にしたら、対応する空のキャンバスを畳むか（v0 は何もしない）