akari-video 0.1.66 → 0.1.67

package/bin/akari.mjs

@@ -13,6 +13,7 @@ import { runAssetsCommand } from '../src/assets-command.mjs';
 import { runMigrateCommand } from '../src/migrate-command.mjs';
 import { runCleanCommand } from '../src/clean-command.mjs';
 import { runDoctorCommand } from '../src/doctor-command.mjs';
+import { runGenerateCommand } from '../src/generate-command.mjs';
 import { resolveRuntimePaths } from '../src/runtime-diagnostics.mjs';
 import { maybeApplyPendingUpdateOnLaunch, resolveInstalledVersionInfo } from '../src/update-check.mjs';
 import { describeCliHelp, describeInstalledVersions } from '../src/messages.mjs';
@@ -80,6 +81,7 @@ const invoke = (argv[0] === '--version' || argv[0] === '-v') ? printVersion()
   : argv[0] === 'assets' ? runAssetsCommand(argv.slice(1))
   : argv[0] === 'migrate' ? runMigrateCommand(argv.slice(1))
   : argv[0] === 'clean' ? runCleanCommand(argv.slice(1))
+  : argv[0] === 'generate' ? runGenerateCommand(argv.slice(1))
   : run(argv);
 
 const result = await invoke.catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.66",
+  "version": "0.1.67",
   "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/doctor-command.mjs

@@ -36,6 +36,11 @@ export function formatDoctorReport(report) {
     ['ffmpeg', report.ffmpeg.origin, report.ffmpeg.path ?? '見つかりません'],
     ['ffprobe', report.ffprobe.origin, report.ffprobe.path ?? '見つかりません'],
     ['gpu_export', report.gpu_export?.available ? 'ok' : 'unavailable', report.gpu_export?.reason ?? '診断情報がありません'],
+    ['fal_key', report.fal_key?.source ?? 'missing', report.fal_key?.source === 'env'
+      ? '環境変数 FAL_KEY'
+      : report.fal_key?.source === 'credentials.env'
+        ? report.fal_key.credentials_path
+        : '環境変数にも credentials.env にもありません'],
     ['path', report.path.on_path ? 'ok' : 'missing', report.path.cli_shim_dir],
   ];
   const widths = [

package/src/generate-command.mjs

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

package/src/messages.mjs

@@ -330,6 +330,7 @@ export function describeCliHelp() {
     '  update [--force]       更新を確認する（--force で install.sh 経路の本体を入れ直す）',
     '  status                 接続状態を確認する',
     '  migrate [dir]          古い edit.json を退避バックアップ付きで v2 へ変換',
+    '  generate               台本のビートから静止画クリップを生成',
     '  akari clean [dir]      使い捨ての中間ファイルを一覧・削除（既定は一覧のみ）',
     '',
     '開発者向け:',

package/src/repo-assets.mjs

@@ -39,6 +39,7 @@ const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'ca
 export const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
 const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
 const EYE_BAR_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'eye-bar.mjs');
+export const GENERATE_CLI_RELATIVE = path.join('packages', 'generate', 'src', 'cli', 'index.mjs');
 
 /**
  * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装・creator-root
@@ -60,6 +61,7 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const mediaScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'media.mjs');
   const decisionLogScript = path.join(repoRoot, DECISION_LOG_SCRIPT_RELATIVE);
   const wordBookScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'word-book.mjs');
+  const generateScript = path.join(repoRoot, GENERATE_CLI_RELATIVE);
 
   return {
     repoRoot,
@@ -79,7 +81,8 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
     eyeBarScript: existsSync(eyeBarScript) ? eyeBarScript : null,
     mediaScript: existsSync(mediaScript) ? mediaScript : null,
     ...(existsSync(decisionLogScript) ? { decisionLogScript } : {}),
-    ...(existsSync(wordBookScript) ? { wordBookScript } : {})
+    ...(existsSync(wordBookScript) ? { wordBookScript } : {}),
+    ...(existsSync(generateScript) ? { generateScript } : {})
   };
 }
 
@@ -115,6 +118,9 @@ export function resolveLauncherAssets({
     renderWhenIdleScript: candidate.renderWhenIdleScript ?? vendor.renderWhenIdleScript,
     eyeBarScript: candidate.eyeBarScript ?? vendor.eyeBarScript,
     mediaScript: candidate.mediaScript ?? vendor.mediaScript,
+    ...(candidate.generateScript ?? vendor.generateScript
+      ? { generateScript: candidate.generateScript ?? vendor.generateScript }
+      : {}),
     ...(candidate.decisionLogScript ?? vendor.decisionLogScript ? { decisionLogScript: candidate.decisionLogScript ?? vendor.decisionLogScript } : {}),
     ...(candidate.wordBookScript ?? vendor.wordBookScript
       ? { wordBookScript: candidate.wordBookScript ?? vendor.wordBookScript }

package/src/runtime-diagnostics.mjs

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import path, { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -132,6 +133,7 @@ export async function resolveDoctorReport(options = {}) {
   const runtime = resolveRuntimePaths(options);
   const mediaBin = await resolveMediaTools({ ...options, env, platform, pathEnv, pathExt });
   const gpuExport = await resolveGpuExportAvailability({ ...options, env, platform });
+  const falKey = resolveFalKeySource({ env, homeDirectory: options.homeDirectory });
   const akariHome = resolveAkariHome(env);
   const cliShimDir = join(akariHome, 'cli', 'bin');
   const report = {
@@ -148,6 +150,7 @@ export async function resolveDoctorReport(options = {}) {
     ffmpeg: mediaBin.ffmpeg,
     ffprobe: mediaBin.ffprobe,
     gpu_export: gpuExport,
+    fal_key: falKey,
     path: {
       cli_shim_dir: cliShimDir,
       on_path: pathContains(pathEnv, cliShimDir, platform),
@@ -158,6 +161,29 @@ export async function resolveDoctorReport(options = {}) {
   return report;
 }
 
+function resolveFalKeySource({ env, homeDirectory }) {
+  const credentialsPath = env.AKARI_CREDENTIALS_FILE
+    ?? join(homeDirectory ?? homedir(), '.config', 'akari-video', 'credentials.env');
+  if (typeof env.FAL_KEY === 'string' && env.FAL_KEY.trim().length > 0) {
+    return { source: 'env', credentials_path: credentialsPath };
+  }
+  try {
+    const source = readFileSync(credentialsPath, 'utf8');
+    for (const originalLine of source.split(/\r?\n/u)) {
+      const line = originalLine.trim();
+      if (!line || line.startsWith('#')) continue;
+      const separator = line.indexOf('=');
+      if (separator < 1 || line.slice(0, separator).trim() !== 'FAL_KEY') continue;
+      if (line.slice(separator + 1).trim().length > 0) {
+        return { source: 'credentials.env', credentials_path: credentialsPath };
+      }
+    }
+  } catch {
+    // credentials.env が無い・読めない場合も doctor 自体は継続する。
+  }
+  return { source: 'missing', credentials_path: credentialsPath };
+}
+
 export async function resolveGpuExportAvailability(options = {}) {
   const platform = options.platform ?? process.platform;
   try {
@@ -265,6 +291,9 @@ function doctorNextSteps(report) {
   if (!report.path.on_path && report.render_cut.origin !== 'monorepo') {
     steps.push('`~/.akari/cli/bin` を PATH に追加してください。');
   }
+  if (report.fal_key?.source === 'missing') {
+    steps.push('FAL_KEY がありません。環境変数 FAL_KEY か credentials.env に置くと fal の生成が使えます（無くても書き出しは動きます）。');
+  }
   return steps;
 }
 

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

@@ -67,6 +67,7 @@
     "docs/contract-2026-09-06-cut-audio-split-v0.md",
     "docs/contract-2026-09-06-vgpu-layer-v0.md",
     "docs/contract-2026-09-12-review-session-viewer.md",
+    "docs/contract-2026-09-13-generation-v0.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -165,6 +166,11 @@
     "skills/edit-plan/SKILL.md",
     "skills/edit-plan/workflow.md",
     "skills/export-nle/SKILL.md",
+    "skills/generate-media/chain.md",
+    "skills/generate-media/engines.md",
+    "skills/generate-media/SKILL.md",
+    "skills/generate-media/still.md",
+    "skills/generate-media/video.md",
     "skills/generate-narration/assets/reading-script-v1.md",
     "skills/generate-narration/avatar-voice.md",
     "skills/generate-narration/engines.md",

package/vendor/docs/contract-2026-07-20-plan-json-v0.md

@@ -1,5 +1,9 @@
 # plan.json v0（仮枠タイムライン）契約
 
+## 2026-09-13 追記 — 仮枠役の退役
+
+plan.json の仮枠役（`confidence` / `fill` / §6 の処理）は退役した。現在の仮枠は edit.json v2 のタイムライン上の静止画 media item + 素材の隣の `<path>.meta.json` である（[生成 v0 契約 §1](./contract-2026-09-13-generation-v0.md#1-継ぎ目仮枠とタイムライン)）。企画層（`research-plan.json` / `planning/`）は存続する。以下は旧契約と移行経緯を保持するため本文を残す。
+
 - 日付: 2026-07-20
 - 状態: 実装ラウンドの SSOT（データ形と検証のみ確定。仮枠コンパイラは §6 の規約先行・実装は次段）
 - 前提: 仮枠タイムラインの方向性メモ §3〜§5（本契約はこの節群を昇格したもの。
@@ -103,6 +107,8 @@ edit.json v1 の「cuts[] を配列順にギャップなく連結」（contract-
 
 ## 3. confidence 状態遷移
 
+（退役・2026-09-13 追記参照）
+
 `confidence` は**保存フィールド**であり、`media` の有無から導出しない（locked かつ未充填
 = 「空きスロットだが方向は確定」は正当な状態。ここが導出だと収録前ロックが表現できない）。
 
@@ -119,6 +125,8 @@ edit.json v1 の「cuts[] を配列順にギャップなく連結」（contract-
 
 ## 4. fill — スロットの充填手段
 
+（退役・2026-09-13 追記参照）
+
 空きスロットはプラン由来の `script` と `target_duration_seconds` を既に知っている。
 充填手段は 3 種 + 未決:
 
@@ -151,6 +159,8 @@ plan.json に書く。plan.json 自体は decision id を持たない（`decisio
 
 ## 6. プレビュー合成規約 — 普通の edit.json v1 へコンパイルする
 
+（退役・2026-09-13 追記参照）
+
 仮枠の再生（アニマティクス QA）は専用レンダラーを作らず、**通常の edit.json v1 への
 コンパイル**で実現する。プレビュー・edit-lint・render-cut が無改造でそのまま使えることが
 本規約の眼目であり、**edit.json に新しい語彙を 1 つも足さない**。
@@ -224,6 +234,8 @@ plan は企画データであり、検証・表示・下流工程の全体を巻
 
 ## 11. 次段（本契約のスコープ外）
 
+（退役・2026-09-13 追記参照）
+
 - 仮枠コンパイラ実装（§6 の規約に従う。画像生成/TTS の実行・ffmpeg ベイク・manifest 生成）
 - 質問対話 UI の充実（当面は decision-cards の既存機構で代替。skills/edit-plan/plan-json.md 参照）
 - タイムラインのゴースト描画（confidence 別表示。akari-annotations の strip 描画へ統合）

package/vendor/docs/contract-2026-07-25-plan-comments-v0.md

@@ -43,8 +43,8 @@
   "submitted_at": "2026-07-25T09:30:00.000Z",
   "comments": [
     {
-      "target_kind": "slot",          // "shot" | "slot" | "cut"
-      "target_id": "s-demo",          // shot/cut は配列インデックス文字列・slot は plan.json の slots[].id
+      "target_kind": "clip",          // "shot" | "clip" | "cut"。"slot" は退役
+      "target_id": "item-demo",       // scaffold の clip は edit.json v2 の item id
       "title": "操作デモ",             // 提出時点の対象名コピー（並べ替え検知用）
       "text": "画面収録の前に、書き出しボタンをクリックする瞬間まで映してほしい。"
     }
@@ -60,9 +60,9 @@
 | `pass` | enum | 要 | `structure` / `scaffold` / `final`（§4） |
 | `submitted_at` | string (ISO8601) | 要 | 提出時刻 |
 | `comments[]` | array | 要（空配列可） | 配列順に意味はない（対象名指しの集合） |
-| `comments[].target_kind` | enum | 要 | `shot` / `slot` / `cut` |
-| `comments[].target_id` | string | 要 | `shot`・`cut` は対象配列のインデックスを文字列化したもの（例 `"2"`）。`slot` は `plan.json` の `slots[].id` をそのまま使う（idごと持ち出せるため並べ替えに強い） |
-| `comments[].title` | string | 要 | 提出時点の対象名コピー（`shot` の `description` 冒頭 / `slot` の `label` / `cut` の `src` 等、読み手が実装時に選ぶ）。**並べ替え検知用の目視補助であり、参照解決には使わない**（参照解決は `target_id` のみで行う） |
+| `comments[].target_kind` | enum | 要 | `shot` / `clip` / `cut`。旧 `slot` は退役 |
+| `comments[].target_id` | string | 要 | `shot`・`cut` は対象配列のインデックスを文字列化したもの（例 `"2"`）。`clip` は edit.json v2 の item id |
+| `comments[].title` | string | 要 | 提出時点の対象名コピー（`shot` の `description` 冒頭 / `clip` の表示名 / `cut` の `src` 等、読み手が実装時に選ぶ）。**並べ替え検知用の目視補助であり、参照解決には使わない**（参照解決は `target_id` のみで行う） |
 | `comments[].text` | string | 要 | 指摘の逐語。要約・言い換えをしない |
 
 「要」= 値は空文字列を許さない（`comments[]` 自体は空配列を許す。提出はしたが個別指摘がない回はあり得るため）。
@@ -105,7 +105,7 @@
 | `pass` | 対象 `target_kind` | 読み手スキル | 対象データ |
 |---|---|---|---|
 | `structure` | `shot` | `skills/research-plan/storyboard.md`（`structure-confirm` 決定カードの差し戻し） | `research-plan.json` の `structure.chapters[]` / `structure.shots[]`（`shot` は `structure.shots[]` の配列インデックス） |
-| `scaffold` | `slot` | `skills/edit-plan/approvals-and-generation.md`（Checkpoint 2 素材計画の差し戻し） | `plan.json` の `slots[]`（`target_id` は `slots[].id`） |
+| `scaffold` | `clip` | `skills/edit-plan/approvals-and-generation.md`（Checkpoint 2 素材計画の差し戻し） | `edit.json` v2 の media item（`target_id` は item id）。旧 `slot` は退役 |
 | `final` | `cut` | `skills/edit-plan/approvals-and-generation.md`（Checkpoint 3 実行の差し戻し） | `edit.json` の `cuts[]`（`cut` は `cuts[]` の配列インデックス。`cuts[]` は永続 id を持たないため — `contract-2026-07-18-edit-json-v1-sources.md`） |
 
 3 つの組は 1 対 1 対応（`pass` が決まれば `target_kind` も決まる）。スキーマは
@@ -131,9 +131,8 @@
   現在の対象名と目視・機械比較することで「ズレ」を検知するための補助情報（正典は `target_id`）
 - **`shot`/`cut` がインデックス文字列である理由**: `research-plan.json` の `structure.shots[]` は
   id を持つが、GUI 側の実装を「今何番目のカードにコメントしたか」で完結させるため
-  インデックスに揃える。`slot` だけ `plan.json` の `slots[].id` を使うのは、
-  plan.json の slot が並べ替え時も id で安定して指せる設計（`contract-2026-07-20` §2）だから
-  ——同じ理由で cut は id を持たないため slot と同じ扱いにできない
+  インデックスに揃える。`scaffold` の `clip` は edit.json v2 の item id を使い、並べ替え後も
+  安定して対象を指す。旧 `slot` は plan.json の仮枠役とともに退役した
 - **`comments[]` を配列（連想配列でない）にした理由**: 同一対象への複数コメントを許す
   （1 対象 1 コメントに制限しない）
 - **状態を持たない理由**: `plan-comments.json` はイベント（差し戻し 1 回分）の記録であり、
@@ -147,8 +146,8 @@
 - **名指しされていない対象まで一緒に直す** — 誤り。名指し対象だけを改訂する（§3 の 3）
 - **`plan-comments.json` に `confidence` のような永続状態を持たせる** — 誤り。§0・§6。
   状態は plan.json 側の責務
-- **`slot` の `target_id` にインデックスを使う** — 誤り。`slot` は `plan.json` の `slots[].id`
-  を使う（`shot`/`cut` とは扱いが違う。§6）
+- **`scaffold` に `target_kind: "slot"` を使う** — 誤り。`slot` は退役済み。`target_kind: "clip"` と
+  edit.json v2 の item id を使う（§4・§6）
 - **提出のたび追記する（過去の `comments[]` を残したまま足す）** — 誤り。§2。1 回の提出 = 1 回の
   上書き作成。回収済みの指摘を残さない
 

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

@@ -0,0 +1,195 @@
+# 生成 v0 契約 — 仮枠クリップ・9 スロット・meta.json・能力カタログ・状態
+
+> 正本の写し（2026-09-13）・技術部分のみ。内部正本の §1〜§9 を公開向けに収録する。
+
+## 1. 継ぎ目（仮枠とタイムライン）
+
+1. 仮枠は **edit.json v2 の media item** で、`sources[].path` が静止画（png / jpg）か文字カード png を指す。cuts で尺を持つ（静止画クリップ契約 2026-08-12 のとおり）
+2. 生成の意図と状態は、その素材の隣の **`<path>.meta.json`** に持つ（§3）。edit.json には何も足さない
+3. meta と素材の結線は **素材の sha256** が正。path は手掛かり。移動・改名は path を更新、複製は同じ meta を共有してよい（sha256 が同じ）
+4. 「動画にする」は同じ item の `source.path` を mp4 に書き換える**差し替え**であり、item id・トラック・尺は変わらない（§7）
+5. 絵コンテはタイムラインの印刷（9/6 §5）。生成の入力にしない
+6. plan.json の仮枠役（`confidence` / `fill`）は退役。`plan-comments.json` の `pass: "scaffold"` の対象は `slot` から **clip id** へ
+
+## 2. 9 スロット（生成入力の正規形）
+
+すべてのモデルに対して、入力はこの 9 つのどれかに落とす。アダプタが provider の引数名に翻訳する（§5）。
+
+| # | スロット | 型 | 備考 |
+|---|---|---|---|
+| ① | `prompt` / `negative_prompt` | string / string?  | 動きの記法（⑧）は prompt に合成してから送る |
+| ② | `first_frame` | 参照要素? | 既定 = そのクリップの静止画。**任意**（H3 は最後だけでも生成できる） |
+| ③ | `last_frame` | 参照要素? | 対応は主要 7 家。非対応モデルで値があれば検証エラー |
+| ④ | `reference_images[]` | 参照要素[] | 上限はカタログ。`name` / `role` はモデルが要求するときだけ使う |
+| ⑤ | `reference_videos[]` | 参照要素[] | 本数と合計秒。**動きを真似る元**（貼り込まれない） |
+| ⑥ | `reference_audios[]` | 参照要素[] | 既定候補 = クリップ範囲のナレーション。Wan の BGM 添付はここに入れない |
+| ⑦ | `source_video` + `mode` | 参照要素? + `edit` / `extend` / `motion` / `frame-edit` | **続ける・直す元**。v1 は欄のみ |
+| ⑧ | `camera` | `{ notation: "bracket" / "trajectory" / "prose", value, from_annotation? }` | 注釈ペンからの翻訳先。notation はモデルに合わせてアダプタが選ぶ。**絵には焼かない** |
+| ⑨ | `seed` | integer? | 再現用の表示のみ。決定論は保証しない |
+| 出力ノブ | `duration_s` / `resolution` / `aspect` / `audio_out` | number / string? / string? / boolean? | 尺は cuts から。モデルの許容に丸め、丸めた事実を表示 |
+| 逃げ道 | `extra` | object | モデル固有の引数。**カタログ行の `extra_allowed[]` にある名前だけ**通す |
+
+参照要素 = `{ path, sha256, source_id?, name?, role?, range_s?: [in, out] }`。path はプロジェクト相対。
+
+## 3. meta.json v1（素材サイドカー）
+
+置き場: 生成物は `assets/generated/<file>`、サイドカーは `assets/generated/<file>.meta.json`。実写や既存素材から生成するときも、**生成物の隣**に置く（元素材の隣ではない）。
+
+```json
+{
+  "version": 1,
+  "kind": "video",                       // "still" | "video" | "frames"
+  "status": "done",                      // "planned" | "generating" | "done" | "failed"
+  "model": { "id": "fal:h3-i2v", "endpoint": "minimax/h3/image-to-video", "as_of": "2026-09-12" },
+  "inputs": {                            // §2 の 9 スロット。値の無いスロットは null / []
+    "prompt": "…", "negative_prompt": null,
+    "first_frame": { "path": "assets/stills/s03-leaving-desk.png", "sha256": "…", "source_id": "src-03a" },
+    "last_frame":  { "path": "assets/stills/s03-family-garden.png", "sha256": "…", "source_id": "src-03b" },
+    "reference_images": [], "reference_videos": [], "reference_audios": [],
+    "source_video": null,
+    "camera": { "notation": "bracket", "value": "[Tracking shot]", "from_annotation": null },
+    "seed": null, "extra": {}
+  },
+  "output": { "duration_s": 6, "resolution": "768P", "aspect": null, "audio_out": null },
+  "cost": { "estimate_usd": 0.36, "actual_usd": null, "unit": "usd_per_second", "source": "estimate" },
+  "job": { "provider": "fal", "request_id": "01a0…", "status_url": "…", "response_url": "…", "started_at": "2026-09-13T…", "stale_after_s": 900 },
+  "provenance": { "created_at": "…", "tool": "akari generate video", "key_source": "env:FAL_KEY" },
+  "result": { "path": "assets/generated/s03-leaving-to-garden.mp4", "sha256": "…", "bytes": 0, "duration_s_actual": 6.592,
+              "width": 1344, "height": 768, "fps": "24/1", "has_audio": true, "expanded_prompt": "…", "elapsed_s": 206 },
+  "history": [ { "at": "…", "status": "done", "reason": null } ]
+}
+```
+
+規則:
+
+1. **送る前に `job` を書く**（request_id・started_at）。落ちても再取得できる（`akari generate resume`）
+2. `status: generating` かつ `started_at` から `stale_after_s` 超 = **stale**。シェルは「応答なし・再取得」を出す。既定 900 秒
+3. 状態の遷移は undo に入れない。**差し替え（§7）だけ** edit-store の undo に 1 手として入る
+4. `history[]` は消さない。失敗も残す
+5. `kind: "still"` は `inputs.reference_images` に `--image=` の 1 枚（Codex）か複数枚（Nano Banana Pro）。`kind: "frames"` はパラパラ（別契約・§10）
+6. `result.expanded_prompt` は provider が書き換えた prompt。較正では **送った prompt ではなく expanded を評価対象**に添える
+
+## 4. 能力カタログ `gen-models.json`（公開リポ `packages/schemas/`）
+
+### 4-1. 形（1 行 = 1 エンドポイント）
+
+```json
+{
+  "id": "fal:h3-i2v", "kind": "video", "provider": "fal", "family": "MiniMax H3",
+  "endpoint": "minimax/h3/image-to-video",
+  "inputs": {
+    "first_frame": "optional", "last_frame": "optional",
+    "reference_images": { "max": 0 }, "reference_videos": { "max": 0 }, "reference_audios": { "max": 0 },
+    "source_video": [], "frames_and_refs_exclusive": false,
+    "negative_prompt": false, "camera": "bracket", "extra_allowed": ["prompt_expansion_mode"]
+  },
+  "duration": { "kind": "range", "min": 5, "max": 15, "step": 1, "default": 5, "format": { "type": "integer" } },
+  "resolutions": ["480P", "768P", "2K", "4K"], "aspects": null,
+  "audio_out": "always",
+  "seed": true,
+  "price": { "unit": "usd_per_second", "by_resolution": { "480P": 0.05, "768P": 0.06, "2K": 0.13, "4K": 0.16 }, "audio_multiplier": null },
+  "as_of": "2026-09-12",
+  "source_url": "https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=minimax/h3/image-to-video",
+  "price_url": "https://fal.ai/models/minimax/h3/image-to-video",
+  "verified": "documented",
+  "calibration": ["calibration/2026-08-23-camera-direction", "lab/2026-09-13-w0-spikes"]
+}
+```
+
+- `inputs.first_frame` / `last_frame` は `"required"` / `"optional"` / `"none"` の 3 値
+- `duration.format` は `{type: "integer"}` / `{type: "string"}` / `{type: "string", suffix: "s"}` / `{type: "string", auto: true}`
+- `audio_out` は `true`（切替可）/ `"always"`（欄なしで付く）/ `false`
+- `price` は **null 可**（B-1）。null の行は UI が「見積不可」と出し、明示確認で通す
+
+### 4-2. 7 規律（旧 Akari OS の欠陥の否定形。w1 の受け入れ条件）
+
+1. 能力は真偽と上限の欄で持つ。`capability` スラッグを作らない
+2. 写像表に無いスロットに値が来たら**送らずに失敗**（fail closed）
+3. バリデータ 1 本を CLI・シェル UI・エージェントで共用
+4. 全欄必須・`additionalProperties: false`
+5. `verified: "documented"` の行だけ収載。推定行は内部リポの下書き
+6. 主観点数を持たない。価格・尺・入力・音声・`calibration[]` だけ
+7. レーダーを作らない
+
+### 4-3. 初期収載 12 行
+
+Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 reference / Seedance 2.0 i2v / Seedance 2.0 reference / Seedance 2.5 i2v / H3 i2v / H3 reference / Wan 2.7 i2v / Grok Imagine i2v / Vidu Q3 i2v。画像: codex-image / nano-banana-pro edit。Sora は OpenAI 直アダプタが出来るまで入れない。
+
+### 4-4. 鮮度とドリフト
+
+- `as_of` 必須。UI の費用表示に日付を添える
+- 週次 CI: `source_url` の OpenAPI を取り、行の `inputs` / `duration` / `resolutions` と突き合わせる。差分があれば issue（価格は対象外。価格は `price_url` を人が見る）
+- OpenAPI が取れない provider の行は `as_of` から 90 日で WARN
+
+## 5. アダプタ契約（9 スロット → provider 引数）
+
+### 5-1. 写像表
+
+各アダプタは 9 スロット × 出力ノブの**全セル**に「引数名 + 書式」か「拒否」を持つ。テストは全セルを網羅する。
+
+### 5-2. 尺の書式（スパイク実測）
+
+| モデル | 送る形 |
+|---|---|
+| H3 | integer `6` |
+| Kling v3 | string `"6"` |
+| Seedance 2.0 | string `"6"`（`"auto"` 可） |
+| Veo 3.1 | string `"6s"`（4 / 6 / 8 のみ。丸め必須） |
+
+### 5-3. 参照の渡し方
+
+- 画像は data URI で送ってよい（5.2 MB で 24 秒）。**20 MB 超は fal storage へ先にアップロード**（後日）
+- 順序タグ（@Image1 …）はアダプタが配列順から生成して prompt に付ける。名前 + 役割（PixVerse）は要素の `name` / `role` から
+- 参照音声は `range_s` で切り出してから送る（クリップ範囲だけ）
+
+## 6. 状態と見え方
+
+| 状態 | タイムライン | プレビュー（編集中） | 書き出し |
+|---|---|---|---|
+| `planned`（文字カード） | 点線 + 「planned」 | 文字カード + 左上小札 | 文字カードのまま。lint WARN |
+| 静止画（meta なし or `done` の still） | 「静止画」バッジ | 静止画 + 左上小札「静止画（仮枠）」 | そのまま。小札なし |
+| `generating` | 黄の縞 + 進捗バー | 静止画の上にシマー + 下端の帯 | 静止画のまま |
+| stale | 縞 + 「応答なし・再取得」 | 帯に「応答なし」 | 静止画のまま |
+| `done`（動画） | 通常 + コマ帯 + 「生成」由来バッジ | 動画。表示なし | 通常 |
+| `failed` | 朱枠 + 「失敗」 | 静止画 + 朱の小札 | 静止画のまま |
+
+- プレビューに付くのは**左上の小札と下端の帯だけ**。承認・比較の UI はプレビューに置かない
+- **書き出し経路には小札・帯・点線が 0 px**。画素比較で担保（w3-b）
+
+## 7. 差し替え規則（done になったとき）
+
+### 7-1. 何を書き換えるか
+
+同じ item の `sources[].path` を mp4 に。item id・トラック・`at` は不変。静止画の path は `meta.inputs.first_frame` に残る（由来）。**1 手の undo**。
+
+### 7-2. 実尺のずれ
+
+| 実尺 | 規則 |
+|---|---|
+| 実尺 ≥ cuts | `out = cuts の長さ`（末尾を切る）。差分は meta に記録 |
+| 実尺 < cuts | `out = 実尺`、`freeze: { at_sec: 実尺, duration_sec: cuts − 実尺 }`（既存の `cutFreeze` 語彙。lint `media.source-range` を通り、タイムライン総尺は不変。**最終コマ停止**） |
+
+差分が 0.5 秒超なら lint が WARN（`generation.duration-mismatch`。lint 側の新規則は w2-b の別票候補）。
+
+### 7-3. 音声
+
+生成クリップの音声トラックは**既定 mute**（`item.mute: true`）。ナレーションと BGM が正。右パネルで解除できる。H3 のように欄なしで音が付くモデルでも同じ。
+
+## 8. 費用承認（有償生成のゲート）
+
+1. 語彙: 有償生成の承認は「**費用承認**」。「判子」は 9/6 契約どおり書き出しの 1 回にだけ使う
+2. 回数: 1 クリップずつが既定。複数を選んで**合計金額を出して 1 回**は可。「全部を自動で動画にする」は無い
+3. 見積: `price.by_resolution × duration_s × audio_multiplier`、as_of 付き。`actual_usd` が取れない provider は `estimate` を写して `cost.source: "estimate"`。見積不可（price null）は明示確認で通す
+4. 停止条件は autonomy §4 と同じ（有償 or 外部送信）。Codex 画像生成は無償扱い
+
+## 9. 用語（混同を防ぐ）
+
+| 語 | 意味 |
+|---|---|
+| 仮枠 | 尺と場所を持つ静止画クリップ。完成品でもある |
+| 参照動画 | 動きやカメラワークを**真似る元**。貼り込まれない |
+| 元動画 | **続ける・直す元**（extend / edit / motion / frame-edit） |
+| 費用承認 | 有償生成の実行前ゲート |
+| 判子 | 書き出しの 1 回（9/6） |
+| 事実帯 | モデル選択の 1 行（価格・尺・入力・音声・較正）。レーダーの代わり |
+

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.66",
+  "version": "0.1.67",
   "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/creator-root/src/index.mjs

@@ -202,6 +202,12 @@ export const DEFAULT_CONNECTIONS_REGISTRY = {
             }
         }
     ],
+    defaults: {
+        generate: {
+            still: 'codex:image',
+            video: 'fal:h3-i2v'
+        }
+    },
     policy: {
         currency: 'JPY',
         monthly_budget: null,

package/vendor/packages/decision-cards/README.md

@@ -10,6 +10,7 @@
 | `report-helper.mjs` | `127.0.0.1` のみにバインドするローカル HTTP ヘルパー。`report.html` の配信・`decisions.json` の read/write・commit を仲介する |
 | `report-template.html` | data 属性でカードを宣言する report.html の雛形。単選・真偽チェック・整数スライダ・配列型の複数選択に対応する。カード種別のハードコードなし。ヘルパー経由なら操作可能、`file://` 直開き等で fetch 失敗時は全操作ボタンが disabled になり案内文言を出す（安全劣化） |
 | `render-research-plan-report.mjs` | `research-plan.json` から固定 5 面の自己完結 HTML を生成する。絵コンテ面は画像 / 文字プレースホルダーのカード面と、主軸 + カットアウェイの読み取り専用 SVG 構造面を切り替えられる |
+| `render-storyboard-print.mjs` | `edit.json` / `captions.json` から尺バーと 1 item 1 コマの自己完結 HTML を生成し、印刷用の L1 通しマップを出力する |
 | `examples/report.html` + `examples/report.html.decisions.json` | 動作サンプル一式（既存 4 カード + `direction`）。AI 推奨を既定値に入れた `decisions.json` 雛形付き |
 | `test/direction-card.test.mjs` | ローカル Chrome を headless 起動して、演出カードの保存と既存 4 カードの非退行を実測するテスト |
 
@@ -66,6 +67,17 @@ node packages/decision-cards/report-helper.mjs planning/research-plan-report.htm
 
 画像は生成時に data URI へ埋め込むため、出力 HTML は外部依存を持たない。`image_path` が無い、または画像を読めないショットは `shot_type` + `description` のプレースホルダーへ安全に劣化する。旧形式に `sequence` / `cutaway_of` が無い場合も生成は成功し、構造面だけが「構造情報なし」になる。
 
+### edit.json から印刷用の絵コンテを作る
+
+```sh
+node packages/decision-cards/render-storyboard-print.mjs <projectDir>
+```
+
+既定では各映像 item の開始直後を `akari capture --full` で撮り、`.akari/reports/storyboard/` に
+`index.html`、`frames/`、`storyboard.json` を出力する。既存の capture 結果を使う場合は
+`--captures <dir>`、画像を撮らず灰色の仮枠にする場合は `--no-capture`、出力先を変える場合は
+`--out <dir>` を指定する。HTML の画像は data URI として埋め込まれる。
+
 ## edit-plan スキルからの参照方法
 
 公開リポの `.claude/skills/edit-plan/` は本パッケージを以下のように参照する想定:

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

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

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

@@ -10,24 +10,27 @@ exports.resolveGenerationState = resolveGenerationState;
 function sidecarPathFor(sourcePath) {
     return `${sourcePath}.meta.json`;
 }
-/** fs に触れず、サイドカー自身が表す状態だけを解決する。 */
+/**
+ * fs に触れず、サイドカー自身が表す状態だけを解決する。
+ * `job.stale_after_s` が未指定・不正な場合は既定 900 秒を使う。
+ */
 function resolveGenerationState(meta, now) {
     if (!meta)
         return 'none';
     if (meta.status === 'failed')
         return 'failed';
     if (meta.status === 'generating') {
-        const nowMs = timeValue(now);
+        const nowMs = now instanceof Date ? now.getTime() : typeof now === 'number' ? now : Date.parse(now);
         const startedMs = Date.parse(String(meta.job?.started_at ?? ''));
-        const staleAfterS = meta.job?.stale_after_s;
+        const declaredStaleAfterS = meta.job?.stale_after_s;
+        const staleAfterS = typeof declaredStaleAfterS === 'number'
+            && Number.isFinite(declaredStaleAfterS)
+            && declaredStaleAfterS >= 0
+            ? declaredStaleAfterS : 900;
         if (Number.isFinite(nowMs)
             && Number.isFinite(startedMs)
-            && typeof staleAfterS === 'number'
             && nowMs - startedMs > staleAfterS * 1000)
             return 'stale';
     }
     return meta.status;
 }
-function timeValue(value) {
-    return value instanceof Date ? value.getTime() : typeof value === 'number' ? value : Date.parse(value);
-}

package/vendor/packages/generate/README.md

@@ -10,3 +10,9 @@ const { ok, normalized, rounded, messages, cost } = validateInputs({ inputs, out
 
 Messages use `error`, `warn`, or `info` levels with stable codes such as `first_frame.required`, `duration.rounded`, and `price.unknown`.
 A model without recorded pricing remains valid and returns `cost.needs_explicit_confirm` instead of changing `ok` to false.
+
+`akari generate still <projectDir> --spec beats.json` はビートごとの静止画を Codex で生成します。
+`--parallel N` で並列数を指定でき、既定は 4 です。
+`--placeholder` は Codex を呼ばず、無料の文字カード PNG を置きます。
+`--dry-run` は edit.json や素材を書かず、配置予定だけを表示します。
+生成物と meta は `assets/generated/`、クリップは edit.json v2 の visual トラック末尾に入ります。

package/vendor/packages/generate/package.json

@@ -5,7 +5,11 @@
   "description": "生成入力（9 スロット + 出力ノブ）を能力カタログ行に対して検証・正規化・丸め・費用見積する依存ゼロの共有モジュール。UI / CLI / エージェントが同じ関数を使う。",
   "type": "module",
   "main": "src/index.mjs",
+  "exports": {
+    ".": "./src/index.mjs",
+    "./cli": "./src/cli/index.mjs"
+  },
   "scripts": {
-    "test": "node --test \"test/*.test.mjs\""
+    "test": "node --test \"test/**/*.test.mjs\""
   }
 }

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

@@ -6,6 +6,8 @@ Three.js + glTF シーンを決定的な時刻で描画し（`three-runtime.js`
 選択・ドラッグ移動・拡縮・テキスト編集を行い（`interaction.js`）、ズーム時の
 全体像インジケータを提供する（`minimap.js`）。
 
+`three-runtime` の `fog` / `background` は additive（無指定時は従来どおり、2026-09-13）。
+
 **出自**: legacy `akari-video-tauri/ui/` から選別インポート（Wave I-3、
 2026-07-15）。当初の JS 3 本（`overlay-runtime.js` / `interaction.js` / `minimap.js`）は
 機能的に無改変で移送。詳しい挙動仕様は `docs/notes-2026-07-14-viewer-ui-round.md`