akari-video 0.1.74 → 0.1.76

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.74",
+  "version": "0.1.76",
   "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/vendor/.akari-capability-sources.json

@@ -74,6 +74,8 @@
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
     "packages/akari-tools/README.md",
+    "packages/akari-vibe/package.json",
+    "packages/akari-vibe/README.md",
     "packages/analysis-report/package.json",
     "packages/analysis-report/README.md",
     "packages/asset-resolver/package.json",

package/vendor/docs/contract-2026-07-13-asset-library.md

@@ -423,3 +423,37 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 **人が選んでコピーするか / コードが id で引くか**で置き場を決める。前者は `assets/` か `catalog/`、
 後者は `presets/`。後者をここへ足すときは、解決するコードのパスと 1:1 で対応させ、その参照箇所を
 表の INDEX.md に明記する。
+
+
+## 手持ち素材の登録（2026-09-22）
+
+`akari-assets add --plan / --apply` は利用者の生ファイルを置き場へ複製する。
+出どころは meta.json の既存 tags に記録し、スキーマは増やさない。
+
+| 機械用タグ | 意味 |
+| --- | --- |
+| `origin:own` / `origin:site` | ローカル取り込み / サイトからの取り込み |
+| `site:<id>` | サイト識別子 |
+| `folder:<名前>` | 取り込み元として渡されたフォルダ名 |
+| `license:subscription` | サブスクリプション由来 |
+| `pack:<id>` | 素材セット。置き場直下の packs.json は catalog/packs.json と同型 |
+
+一覧ではこれらを `machineTags` に分け、表示・検索用の `tags` に残さない。
+出どころはカタログ掲載（lab）、明示 origin タグ（site / own）、AKARI 配布元の source.url（lab）、
+その他の source.url あり（site）、それ以外（own）の順で決める。
+AKARI 配布元は URL を解析し、ホスト github.com かつパスの最初のセグメントが AkariLabs、
+またはホスト akari-oss.app とそのサブドメインで判定する。壊れた URL は site とする。
+素材ディレクトリの `CREDIT.txt` はクレジット文面 1 行。文面がある場合は
+`license.attribution_required: true`、source がある場合はその attribution_required も true にする。
+
+取り込みの既定は `license.scope: "private-owned"`、`spdx: "LicenseRef-user-owned"`、
+`ai_training_allowed: false`、`price: 0`。利用者の手持ち素材として保管するための値であり、
+素材そのものの著作権帰属・商用可否・再配布権を認定するものではない。
+サイト由来は source ブロックに配布ページと元の利用条件を残す。
+
+ローカル取り込みは全カテゴリに preview.png を置く。音は ffmpeg の波形、映像は先頭フレームを使い、
+ffmpeg 不在・失敗時は Node 組み込みの zlib で生成した決定的なプレースホルダ PNG にする。
+PNG の画像は元画像を複製し、その他の画像・font・scene3d はプレースホルダを使う。
+still は画像を相対参照する fragment.html、scene3d はモデルを参照する data-akari-3d-scene 宣言の
+fragment.html を生成する。これらを含む素材全体が validate-asset の exit 0 を通った場合だけ登録し、
+非 0 の場合は failures に記録して素材を残さない。title は元ファイル名から拡張子を除いたものにする。

package/vendor/docs/contract-2026-08-30-edit-json-v2-object-tree-v0.md

@@ -91,7 +91,7 @@ updated: 2026-08-30
 - 字幕は**専用の段ではなくグループ**。HTML 袋と同じ形（袋 = captions.json・子 = 行）。畳める・前後へ動かせる・別グループの中に入れられる・行を「出す」は部品と同じ操作。段は全部無名になる（§2）
 - 子（行）の時間は captions.json の**ソース秒**のまま（既存契約）。写しの `at` / `duration` は読み込み層がタイムライン写像で導出する（edit.json に焼かない）
 - **行の分離**: `{ "id": "cap-42", "at": 1210, "duration": 48, "transform": { "y": -120 }, "source": { "kind": "caption", "path": "captions.json", "id": "c-0042" } }`。文字・スタイルは captions.json の行が正本のまま、位置と時間だけ木の側で上書きする
-- **テロップに変換**: `source: { "kind": "telop", "preset": "…", "params": { "text": "…" }, "from": "captions.json#c-0042" }`。以後は独立したテロップ（`from` は来歴。元の行は `exclude`）
+- **テロップに変換**: `source: { "kind": "telop", "preset": "…", "params": { "text": "…" }, "from": "captions.json#c-0042" }`。以後は独立したテロップ（`from` は来歴。元の行は `exclude`） **追記**: 「テロップに変換」は GUI の操作としては 2026-09-21 に撤去。`kind:"telop"` の器と `baked` の再生は後方互換で残す。
 - 同時刻に 2 行あるときの表示（副行）は描画側の規則であってデータではない。編集ミスの重なりは lint warning
 - **旧形 `tracks[].content: { from: "captions.json" }` は読める（tolerant reader）が deprecated**。読み込み層は袋グループと同じ内部表現に落とす。書き手（shell / スキル）は袋グループ形を出し、`akari migrate` が旧形を袋グループ形に正規化する。lint は旧形に warning `v2.captions-content-deprecated`
 
@@ -129,7 +129,7 @@ updated: 2026-08-30
 - **1 トラック = 常に 1 行。** 葉のアイテム（子を持たないもの）は帯の中のチップであって、ヘッダ列の行ではない。ヘッダ列の行になるのは (a) 子を持つ純グループ (b) 展開中の純グループの子 だけ
 - **袋の子へ届く経路は 2 つ**: (a) 帯のチップを直接クリックして選ぶ (b) ダブルクリックでフォーカスモードに入る（§7 の「中に入る」）。袋を段の上で展開する操作は**無い**
 - 畳んだ帯に子の位置を刻みで示すのは従来どおり（どこに何があるかは帯で分かる）
-- 「出す」（§3.1）・「テロップに変換」（§1.5）は**帯のチップに対する操作**として従来どおり使える（行が無くても届く）
+- 「出す」（§3.1）・「テロップに変換」（§1.5）は**帯のチップに対する操作**として従来どおり使える（行が無くても届く） **追記**: 「テロップに変換」は GUI の操作としては 2026-09-21 に撤去。`kind:"telop"` の器と `baked` の再生は後方互換で残す。
 
 **根拠**: 袋は「データがそうなっている入れ物」で、人間が作ったものでも、ばらせるものでもない。それを UI で「グループ」と呼ぶと「ではばらせるのか」「展開する必要があるのか」という**答えのない問い**が立つ。実案件（SFX 30・字幕 30 行）で葉まで行にした結果ヘッダ列が 71 行に膨らみ、この混同が破綻として顕在化した。
 
@@ -158,7 +158,7 @@ updated: 2026-08-30
 
 ## 3. 操作の意味論（データ変換として定義。UI のコマンド・キー割り当ては別契約）
 
-操作は **出す / まとめる / ばらす** の 3 つ + 切り出し・テロップに変換。**「戻す」は無い**（⌘Z のみ。再グループ化は「まとめる」で足りる）。
+操作は **出す / まとめる / ばらす** の 3 つ + 切り出し・テロップに変換。**「戻す」は無い**（⌘Z のみ。再グループ化は「まとめる」で足りる）。 **追記**: 「テロップに変換」は GUI の操作としては 2026-09-21 に撤去。`kind:"telop"` の器と `baked` の再生は後方互換で残す。
 
 ### 3.1 出す（detach）
 
@@ -181,6 +181,8 @@ updated: 2026-08-30
 
 ### 3.4 切り出し（§1.6）/ テロップに変換（§1.5）
 
+> 追記: 「テロップに変換」は GUI の操作としては 2026-09-21 に撤去。`kind:"telop"` の器と `baked` の再生は後方互換で残す。以下は撤去前の意味論の記録。
+
 - どちらも一方通行。元ファイルは不変・来歴（`derivedFrom` / `from`）を残す
 
 ## 4. 描画 — クローンマスク
@@ -309,7 +311,7 @@ await p.save();                         // 正規直列化 → lint ゲート
 | A3 | `object-tree-render` | クローンマスク（§4）を 3 出口（preview / osr / gpu）に・名札の走査・`style` / `text` | A1 |
 | A4 | `object-tree-write-and-migrate` | shell / preview-server / スキルの書き込みを A2 の API へ・`content` → 袋グループの migrate・1 レコード 1 行での保存 | A2, A3 |
 | D | タイムライン木行 | 折りたたみ / D&D 再親化 / ⌘G ⌘⇧G / 段の自動生成・消滅（UI 契約） | A2 |
-| F | 字幕 = 袋グループ（UI） | 専用段の廃止・畳んだ帯の刻み表示・行を出す / テロップに変換 | D, A3 |
+| F | 字幕 = 袋グループ（UI） | 専用段の廃止・畳んだ帯の刻み表示・行を出す / テロップに変換。**追記**: 「テロップに変換」は GUI の操作としては 2026-09-21 に撤去。`kind:"telop"` の器と `baked` の再生は後方互換で残す | D, A3 |
 | H | フォーカスモード | 姉妹契約 §7 | D + 姉妹契約 |
 | I | SKILL.md 読み方規約 | §5.2 を edit-plan / address-review / analyze-project へ | A2 |
 

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

@@ -12,7 +12,10 @@
 5. 絵コンテはタイムラインの印刷（9/6 §5）。生成の入力にしない
 6. plan.json の仮枠役（`confidence` / `fill`）は退役。`plan-comments.json` の `pass: "scaffold"` の対象は `slot` から **clip id** へ
 7. **空の枠**（2026-09-21）: 仮枠ツール（F）で空いているところに描いた枠は、prompt 未記入の**文字カード png** を素材に持つ media item（絵のないクリップを文字カード png で表す規則の延長）。0.5 秒刻み・端に吸着・隣に食い込まない・0.5 秒未満にしない。専用トラックは作らない（どのトラックにも置ける）
+   実装: 選択 V / 分割 C / 仮枠 F（従来の A / B も有効）。仮枠はスナップ OFF でも近い可視端・再生ヘッドを 0.5 秒格子より優先し、`assets/generated/frame-<時刻>-<一意接尾辞>.png` と隣の `.meta.json` に保存する。
 8. **すき間から作る枠**（2026-09-21）: すき間をクリック →「あいだを生成」で、すき間の位置と長さの枠を置く。前のクリップの最後のコマ・次のクリップの最初のコマを抽出して両端（②③）に入れる。動画からの抽出は 1 コマを `assets/captures/` へ書き出す（§10）
+   実装: 同じ映像トラックで前後にクリップがある 0.5 秒以上の空きだけをすき間とする。前は `source.out − 1/output.fps`（in 以上）、次は `source.in` の合成前のコマを使い、静止画は元パスを使う。
+   抽出 PNG は `assets/captures/frame-<素材名>-<秒>-<素材・更新時刻等のハッシュ>.png` に保存し、同じ素材・同じ時刻は再利用する。
 9. 枠は**生成前から尺と場所を持ち、生成物は同じ item に入る**（4 の延長）。メディアパネルは経由しない（タイムライン正本）
 
 ## 2. 9 スロット（生成入力の正規形）
@@ -96,8 +99,10 @@ mp4 がまだ無い「動画予定」は、**仮枠の素材の meta**（静止
 1. **読み手の判定**: `next.kind === "video"` かつ `next.status === "planned"` = 「動画予定」。`next` が無い静止画 = 「画像のまま」= 完成品。文字カード（meta 自体が `planned`）で `next` が無いか prompt が空 = 「空の枠」
 2. `next.inputs` は §2 の 9 スロットの下書き。`first_frame` は**そのクリップの絵とは限らない**（前のクリップの最後のコマ・キャプチャ・空 = プロンプトだけ）
 3. **`inputs.frames_or_refs`** = `"frames"` / `"references"`（`next` の下書きだけが持つ欄。§2 ⑦ の `mode` = 元動画のモードとは別物）。最初 / 最後と参照が排他のとき（`frames_and_refs_exclusive: true` の行、または同じ family の i2v 行と ref 行の切替）、**下書きは両側を保持し、送るのは `frames_or_refs` の側だけ**。切り替えで中身を消さない。バリデータはこの欄を見て反対側を送信 body から外し、生成物 meta の `inputs` にはこの欄を書かない（送った側だけが残る）
+   右パネルは同じ family のフレーム行 / 参照行を「最初 / 最後｜参照」で切り替え、model ID も相方に替える。参照は種類別の札・カウンタ付きグリッドで、素材パネルから複数選択する。
 4. **送るとき**: CLI は `next`（または `--inputs`）を読み、従来どおり**生成物の隣**に video meta（`generating`）を書く。このとき **`placeholder: { path, sha256, item_id }`** = その item が今指している素材（静止画 / 文字カード）を必ず書く。item への逆引きは `placeholder` が正、`inputs.first_frame.path` は 9/13 時点の meta のための後方互換。`next` は消さない（「同じ入力でもう一度」の元）
 5. **状態の優先**: `placeholder` で結線された生成物 meta が `generating` / stale / `failed` ならそれを描く。無ければ `next` の `planned` を描く。`done` で差し替わった後は mp4 の meta が直接当たる（§7）
+   done で差し替わった後の作り直し（本番の画質・同じ入力でもう一度）の下書きは、mp4 の meta の `next` に持つ。元の静止画の `next` は変えない。
 6. `next` の更新は undo に入れない（§3 規則 3 と同じ）。右パネルの編集は即保存
 7. 移行: `.akari/generation/<itemId>.inputs.json` があり `next` が無いときだけ読み、次の保存で `next` へ移す。新規の書き込みはしない
 8. ビート表（`akari generate still --spec`）はビートごとに動画予定（最初だけ / 最初→最後）を指定でき、指定があれば CLI が `next` を書く。指定が無ければ「画像のまま」
@@ -129,6 +134,7 @@ mp4 がまだ無い「動画予定」は、**仮枠の素材の meta**（静止
 }
 ```
 
+- 参照の順序記法は行ごとの `tag`（接頭辞）+ `tag_joiner`（省略時は空文字）+ 1 始まりの番号。Seedance は `@Image` + 空文字 → `@Image1`、H3 は `Image` + 空白 → `Image 1`。動画・音声も同様。`tag` の末尾に空白は入れない
 - `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`
@@ -148,6 +154,8 @@ mp4 がまだ無い「動画予定」は、**仮枠の素材の meta**（静止
 
 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 直アダプタが出来るまで入れない。
 
+動画の登録済みアダプタ（2026-09-22）は `fal:h3-i2v`・`fal:h3-ref`・`fal:kling-v3-standard-i2v`・`fal:kling-v3-pro-i2v`・`fal:seedance-2.0-i2v`・`fal:seedance-2.0-ref`・`fal:veo-3.1-flf` の 7 行。カタログ収載だけでは送信できない。H3 reference は OpenAPI に従い `Image 1` / `Video 1` / `Audio 1` で参照を名指しする。`first_frame` / `last_frame` は拒否する。
+
 ### 4-4. 鮮度とドリフト
 
 - `as_of` 必須。UI の費用表示に日付を添える
@@ -160,6 +168,8 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 
 各アダプタは 9 スロット × 出力ノブの**全セル**に「引数名 + 書式」か「拒否」を持つ。テストは全セルを網羅する。
 
+対応一覧は §4-3 の 6 行。Seedance 2.0 reference は画像・動画・音声参照を写し、`first_frame` / `last_frame` / `seed` は拒否する。参照用の OpenAPI 根拠は `packages/generate/test/fixtures/openapi/`（2026-09-22 取得・URL と SHA-256 は同 README）に保存する。H3 reference は記法の不一致が解消するまで登録しない。
+
 ### 5-2. 尺の書式（スパイク実測）
 
 | モデル | 送る形 |
@@ -171,9 +181,10 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 
 ### 5-3. 参照の渡し方
 
-- 画像は data URI で送ってよい（5.2 MB で 24 秒）。**20 MB 超は fal storage へ先にアップロード**（後日）
-- 順序タグ（@Image1 …）はアダプタが配列順から生成して prompt に付ける。名前 + 役割（PixVerse）は要素の `name` / `role` から
-- 参照音声は `range_s` で切り出してから送る（クリップ範囲だけ）
+- Seedance 2.0 reference と H3 reference の画像・動画・音声は配列順のまま data URI で送る。**20 MB 超は送らず error**（fal storage へのアップロードは後日）。OpenAPI の上限は画像 9・動画 3・音声 3、全種合計 12 ファイル。Seedance の音声参照には画像か動画が 1 本以上必要。H3 は 2026-09-22 取得の OpenAPI に従い音声単独も可
+- 引数名は Seedance が `image_urls` / `video_urls` / `audio_urls`、H3 が `reference_image_urls` / `reference_video_urls` / `reference_audio_urls`。OpenAPI の正本は `packages/schemas/fixtures/gen-models/openapi/`。generate のテストも相対 URL でこの正本を直接読む。`packages/generate/test/fixtures/openapi/` は取得記録の README のみ（取得日・出典・変換方法を記録）
+- 順序タグはカタログ行の `tag` + `tag_joiner`（省略時は空文字）+ 配列順の番号（1 始まり）。prompt の `@画像N` / `@動画N` / `@音声N` を、Seedance では `@ImageN` / `@VideoN` / `@AudioN`、H3 では `Image N` / `Video N` / `Audio N` へ置換する。該当種別の本数を超える番号や 0 以下・非整数は送らず error。provider 記法の直書きは `@` 付きだけ番号を検査する。H3 の素の英語は検査・置換せず、通常文の `Image 1 of 3` や `Image 3` を誤って拒否しない。名指しが無ければ prompt に何も足さない。名前 + 役割（PixVerse）は要素の `name` / `role` から
+- 参照音声は `range_s` があれば media-bin の ffmpeg で切り出してから送る（クリップ範囲だけ）。指定が無ければ元の音声をそのまま送る。切り出しの一時ファイルは成功・失敗ともに削除する
 
 ## 6. 状態と見え方
 
@@ -233,6 +244,7 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 | 費用承認 | 有償生成の実行前ゲート |
 | 判子 | 書き出しの 1 回（9/6） |
 | 事実帯 | モデル選択の 1 行（価格・尺・入力・音声・較正）。レーダーの代わり |
+| 下書き → 本番の画質 | `price.by_resolution` に異なる単価が 2 つ以上ある video 行だけ対応。下書きは最安解像度。チェック ON は `next.output.resolution` を最安にして解像度を固定、OFF は直前の選択（無ければカタログ順の既定）へ戻し、見積を再計算する。生成物の `output.resolution` が最安なら下書きと判定し、カタログ・meta に判定用の欄は追加しない。done の `placeholder` を辿った元静止画が存在し `next` を保持している場合だけ「本番の画質にする…」を表示。解像度の初期値は下書き前の選択かカタログの既定で、価格順の 2 番目は使わない。より高い画質を選択 → 見積 → 既存の費用承認 → 同じ `next.inputs`（対応モデルで meta に seed があれば再使用）で生成する。既存の `writeGenerationDraft` で現在の mp4 meta の既存 `next` 欄へ送信下書きを保存し、CLI の `--item` 経路を再利用する。元静止画の `next` は消さず、同じ item の素材だけを §7 に従って差し替え、映像・色の設定を保持する。placeholder が過去の mp4 を指す場合も元静止画まで辿る。表示文言は「同じ入力でもう一度、高い画質で生成します（絵は変わることがあります）」。 |
 
 ## 10. コマ保存（キャプチャ）（2026-09-21）
 

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.74",
+  "version": "0.1.76",
   "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/akari-vibe/README.md

@@ -0,0 +1,62 @@
+# AKARI バイブ
+
+このディレクトリは内部リポジトリの正本から自動生成する配布物です。直接編集しないでください。
+変更は内部へ戻し、検査を通して書き出し直します。版はシェルと一緒に管理します。
+判断は `https://akari.video/api/vibe` のサービスで行い、その実装は同梱しません。
+
+## 起動
+
+シェルの backend が `node bin/akari-vibe.mjs --serve` を子プロセスとして起動します。
+Electron では `process.execPath` と `ELECTRON_RUN_AS_NODE=1` を使います。
+シェルが32バイトの乱数を作り、標準入力の最初の行に
+`{"token":"<64桁の16進文字列>"}` と改行を渡します。合言葉を引数や環境変数へ置かないでください。
+標準入力は接続中開いたままにします。閉じると係は1秒以内に終了します。
+
+待受けは `127.0.0.1:0`。標準出力の最初の行は
+`{"type":"listening","port":<整数>,"protocol":0}` です。
+シェルは Bearer 認証で `/companion/manifest?nonce=<32桁>` を取得し、
+合言葉を鍵とした nonce の HMAC-SHA256 を照合します。
+manifest の `panelPath` が返す `?k=` を枠の通信に付けます。合言葉と panelPath はログに残しません。
+`companion.json` は書かず、HUD の待受けも開きません。記録も既定では書きません。
+同時に動く係は1つとし、シェルがウィンドウの切替・終了時に停止を管理します。
+
+## 資源と設定
+
+公開モノレポ、アプリの Resources とも `packages/akari-vibe` と
+`packages/edit-store/lib` を並べ、根に `presets` を配置します。
+聞き取りのビルド済みヘルパーは `native/bin/akari-vibe-stt` に置きます。
+対応外 OS やヘルパー未同梱でも係は起動し、聞き取りが使えないことを枠に表示します。
+
+| 環境変数 | 用途 |
+| --- | --- |
+| `AKARI_PUBLIC_REPO` | 公開資源の根。通常は相対配置から見つけます |
+| `AKARI_EDIT_STORE_LIB` | edit-store の index.js の明示指定。相対配置より優先します |
+| `AKARI_HOME` | Lab 接続情報の親。既定は `~/.akari` |
+| `AKARI_VOICE_JUDGE_TOKEN` | Lab 接続の鍵を明示指定 |
+| `OPENROUTER_API_KEY` | 利用者の鍵を明示指定 |
+| `AKARI_CREDENTIALS_FILE` | 利用者の鍵を読む env ファイル |
+| `AKARI_VOICE_JUDGE_URL` | 判断 API の接続先。製品の既定は上記サービス |
+| `AKARI_VOICE_JUDGE_TRUST_HOST` | `1` のときだけ別の HTTPS ホストへの鍵の送信を明示許可 |
+| `AKARI_VIBE_STT_BIN` | 聞き取りヘルパーの明示指定 |
+| `AKARI_VIBE_LOG_DIR` | 明示した場合のみ記録する場所 |
+| `AKARI_VIBE_DEV` | `1` の場合は開発用の口とヘルパーのローカルビルドを有効化 |
+| `AKARI_LIBRARY_SOURCE` / `AKARI_CATALOG_JSON` | 素材台帳の方式とファイル |
+
+Lab 接続の鍵は `AKARI_VOICE_JUDGE_TOKEN`、次に `AKARI_HOME/store-credentials.json`
+（未指定なら `~/.akari/store-credentials.json`）の token を使います。
+利用者の OpenRouter の鍵は `OPENROUTER_API_KEY` → `AKARI_CREDENTIALS_FILE` →
+`~/.config/akari-video/credentials.env` → 旧 `~/.config/akari/openrouter.env` の順に探します。
+ファイルは呼び出すたびに読み直します。登録後の再起動は不要です。
+
+通常、保存済みの両方の鍵を送る相手は HTTPS の `akari.video` だけです。
+Lab 接続の鍵を Authorization、利用者の鍵を `x-akari-provider-key` に載せ、
+サービスの `/judge` へ送ります。係からモデル提供先へ直接送ることはありません。
+リダイレクトは拒否します。別ホストへの送信は上表の明示許可がある場合だけです。
+ローカル接続先には保存済みの鍵を送らず、明示した Lab token のみ送ります。
+戻り値と通信エラーから鍵を除去し、状態確認では登録の有無だけを返します。
+
+## テスト
+
+依存のインストールは不要です。公開のモノレポ配置で
+`node --test test/*.test.mjs` を実行します。
+判断 API は呼びません。鍵の試験は fetch の差し替え、起動の試験は一時ホームと OS が選ぶポートを使います。

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

@@ -0,0 +1,17 @@
+{
+  "name": "@akari-video/akari-vibe",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "description": "@akari-video/akari-vibe [akari-video npm vendor: bin/akari-vibe.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.]",
+  "akariVideoVendor": {
+    "execution": "reference-only",
+    "omittedBin": {
+      "akari-vibe": "bin/akari-vibe.mjs"
+    },
+    "guidance": "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."
+  }
+}

package/vendor/packages/asset-resolver/README.md

@@ -19,7 +19,9 @@
 ## CLI
 
 ```sh
-akari-assets list [--category <c>] [--json]          # 合成カタログ一覧（取得状態バッジ込み）
+akari-assets list [--category <c>] [--source <lab|site|own>] [--json]          # 合成カタログ一覧（取得状態バッジ込み）
+akari-assets add <path...> --plan [--json]            # ファイル・フォルダの取り込み計画
+akari-assets add --apply <plan.json> [--json]         # 確認済み計画を複製して登録
 akari-assets fetch <id> [--project <dir>] [--force]   # 素材を解決してローカルへ登録
 akari-assets migrate [--dry-run]                      # 旧置き場を再移行（dry-run は変更しない）
 akari-assets sync                                      # カタログを取得してローカルにキャッシュ
@@ -120,9 +122,9 @@ checksums 不一致は、いずれも `AssetResolverError`（`code: 'download_fa
 
 `AKARI_ASSETS_CATALOG` がリモート URL のとき、`loadCatalog` は取得成功のたびに
 `~/.akari/catalog-cache.json` へ自動キャッシュする。オフライン時（fetch 失敗）はこのキャッシュへ
-フォールバックする。キャッシュも無い場合は「取得できていない」ことを明示するエラーで止まる
-（黙って空のカタログを返したりしない）。ただし `installed.json` に導入済み素材がある場合は、
-キャッシュが無くてもその素材だけを `list` / `fetch` できる。`akari-assets sync` はオンライン環境で
+フォールバックする。キャッシュも無い場合、`list` は警告を stderr に出し、置き場の素材と `installed.json` の導入済み素材を返す。
+`AKARI_ASSETS_CATALOG` に指定したローカルファイルが読めない場合も同様。
+`fetch` / `sync` の取得エラーの扱いは従来どおり。`akari-assets sync` はオンライン環境で
 明示的にキャッシュを温めておくためのコマンド。
 
 ## テスト
@@ -170,3 +172,114 @@ root（絶対パス）、state（pending / migrating / done / declined）、deci
 途中失敗は migrating のまま再開可能。done 後に旧 CLI が追加した素材は `akari-assets migrate` で寄せる。
 作業場なしは何もしない。OneDrive / Dropbox / iCloud Drive / Google Drive 配下は pending に留め、
 結果に同期先と総容量を返す。ドロップフォルダと reviews はマシン状態として元の場所に残す。
+
+
+## カタログ外の素材と出どころ
+
+`list --json` は素材配列を返す。リモートカタログにない `<category>/<id>` も含め、
+新しい置き場を優先し、従来の置き場も読む。カタログ側に同じ key がある場合は 1 件にまとめる。
+ローカルの表示情報は meta.json、`files: [{name, bytes}]` は実ディレクトリから得る。
+壊れた meta.json も id を title にした item として残し、`warnings[]` に理由を付ける。
+
+追加フィールド:
+
+| フィールド | 意味 |
+| --- | --- |
+| `sourceKind` | カタログ収載・ストア導入は `lab`。それ以外は `origin:site` / `origin:own`、AKARI 配布元の `source.url`（lab）、その他の `source.url`（site）、既定 own の順 |
+| `tags` / `machineTags` | 人向けタグ / `origin:*`・`site:*`・`folder:*`・`pack:*`・`license:subscription` |
+| `folder` / `site` / `subscription` | 機械用タグの値（無ければ null / null / false） |
+| `creditText` | CREDIT.txt の先頭 1 行。無ければ null |
+| `libraryDir` / `addedAt` | ローカル素材の絶対パス / ディレクトリ birthtime（無効なら mtime）の ISO 時刻 |
+| `preview` / `mediaFile` | ローカル素材では `preview.png` / 直下で一意な主メディアのファイル名。無ければ null |
+
+AKARI 配布元は URL を解析し、ホスト `github.com` かつパスの最初のセグメントが `AkariLabs`、
+またはホスト `akari-oss.app` とそのサブドメインで判定する。壊れた URL は `site` とする。
+
+主メディアはシェルと同じ一意解決の規則で、複数テイクから勝手に選ばない。
+still の `preview.png` は主メディア候補から除く。音・映像・画像に加え、取り込み対象の
+AIFF・SVG・フォント・glTF も判定する（シェルでの配置可否とは別）。
+`composeState()` は一覧に加え取得エラー等の `warnings[]` を返す。
+
+## ローカル取り込みの JSON 契約
+
+```sh
+akari-assets add /path/to/track.wav /path/to/folder --plan --json > plan.json
+# plan.json の items[].kind / selected と任意の credit / pack を編集
+akari-assets add --apply plan.json --json
+```
+
+plan は置き場に書き込まない。隠しファイル・Thumbs.db・シンボリックリンクを除いて再帰し、
+5,000 ファイルで打ち切った場合は `truncated: true` と `warnings[]` を返す。
+
+```jsonc
+{
+  "schema": "akari-assets-add-plan/v0",
+  "items": [{
+    "path": "/absolute/path/track.wav", "name": "track.wav", "bytes": 2000000,
+    "category": "audio", "kind": "sfx", "durationSec": 14,
+    "durationSource": "ffprobe", "ambiguous": true, "proposedId": "track",
+    "mtimeMs": 1790000000000, "folder": "Tracks"
+  }],
+  "duplicates": [], "rejected": [], "truncated": false, "limit": 5000, "warnings": []
+}
+```
+
+- 音: 10 秒未満 = `kind: "sfx"`、30 秒以上 = `"bgm"`、間は `ambiguous: true` + 既定 `"sfx"`。
+  利用者の選択は `items[].kind` を `"bgm"` に変えて反映する。`ambiguous` は判定時の情報として残せる。
+- ffprobe 不在だけはサイズで推定する（1,200,000 bytes 未満 = sfx、4,000,000 bytes 超 = bgm、間は ambiguous）。
+  `durationSec: null` / `durationSource: "size"`。ffprobe が動いてエラーを返した音は rejected。
+- 画像 = still、映像 = broll、フォント = font、GLB/glTF = scene3d。これらの kind は category と同じ、
+  durationSec / durationSource は null。cube は presets 管轄のため rejected。0 バイト・対応外形式も理由つきで rejected。
+- `duplicates[]` は元ファイル情報 + `status: "duplicate"` + 既存の `category` / `id` / `libraryDir`。
+  同じバイト数の既存ペイロードがある場合だけ、取り込み元とその候補の sha256 を計算・比較する。
+  候補がなければ先頭 512 bytes の読み取り確認のみ行い、hash は計算しない。計算した場合だけ `sha256` を plan に含める。`rejected[]` は元ファイル情報 + `reason`。
+- `folder` は渡されたフォルダ名。単独ファイルには付けない。`selected: false` の item は apply で除外する。
+- `credit` は plan 全体または item に指定でき、改行を空白にして CREDIT.txt へ保存する。
+- `pack: {id, title}` は plan 全体で任意指定。全追加素材に pack タグを付け、ライブラリ直下の
+  `packs.json` に `akari-catalog-packs/v0` の行を追加する。混在セットの category は最初に登録した素材のもの。
+- サイト取り込みは plan または item に `origin: "site"`, `site`, `sourceUrl`, `licenseAtSource`,
+  `subscription` を指定する。source の acquisition は subscription=true なら login、ほかは direct。
+  `sourceUrl` と `licenseAtSource` は必須。既定の own には source を作らない。
+
+apply の結果は `{added: [{category,id,libraryDir,warnings?}], duplicates, rejected, failures}`。
+failures は `{path?, reason}`。1 件でも失敗した CLI は exit 1 と結果 JSON を返すが、残りの素材は続ける。
+id は proposedId を使い、衝突時だけ `-2` 以降を足す。元ファイルのサイズ・mtime を再確認し（plan に sha256 があればそれも照合）、
+apply 時に計算した hash と複製後の hash を比較して、
+同じディスクの一時ディレクトリへ CoW 複製 → 検証 → rename する。コピー元は消さない。
+失敗した素材の一時ファイルと配置済みファイルは削除する。並行 apply は `.add-lock` で排他し、
+実行中なら failures を返す（強制終了で残った lock は、実行がないことを確認して除去する）。
+
+### プレビュー・表示用ファイルと厳密な検証
+
+apply は全カテゴリで `preview.png` を置く。音は register-drop-folder と同じ関数で波形を生成し、
+映像は ffmpeg で先頭フレームをサムネイルにする。ffmpeg 不在・実行失敗時は、Node 組み込みの
+zlib で作る決定的なプレースホルダ PNG に置き換え、`added[].warnings` にその旨を返す。
+PNG の still は元画像を複製して preview にする。font / scene3d / PNG 以外の still もプレースホルダを使う。
+
+still には実体画像を相対参照する最小の `fragment.html`、scene3d には canvas と
+`data-akari-3d-scene` の model 宣言を持つ最小の `fragment.html` を生成する。
+生成した素材を既存 `validate-asset.mjs` に渡し、exit 0 の場合だけ登録する。
+非 0 の診断を警告として許容する例外は設けず、`failures[]` に記録して素材を残さない。
+
+### apply が作る meta.json の既定値
+
+| 必須項目 | 既定値 |
+| --- | --- |
+| id | ファイル名由来の proposedId（非 ASCII は短いハッシュ、衝突時は接尾辞） |
+| category | 拡張子で決めた audio / still / broll / font / scene3d |
+| title | 元ファイル名（拡張子を除く。例: mid.wav → mid） |
+| description | 利用者がローカルから取り込んだ素材 |
+| when_to_use | 利用者のプロジェクトでこの素材を使うとき |
+| tags | origin:own。必要時に folder:* / sfx / pack:*。site 由来は origin:site / site:* / license:subscription |
+| knobs | [] |
+| ai_usage | 利用者の利用条件の範囲で使用する。再配布・AI 学習には使用しない。 |
+| requires | [] |
+| provenance | {origin: "利用者がローカルから取り込み", generator: null} |
+| author | user |
+| license | {spdx: "LicenseRef-user-owned", scope: "private-owned", attribution_required: false, ai_training_allowed: false}（credit 指定時だけ attribution_required=true） |
+| price | 0 |
+
+`planAdd` の `probe(path, {env})` 注入口は秒数か null（不在）を返し、壊れた音なら throw する。
+追加テストはこの注入口を使うため、ffprobe / ffmpeg は不要。
+
+`planAdd` の `hashFile(path)` 注入口は、同サイズ候補がない場合に呼ばれないことを検証するために使える。

package/vendor/packages/asset-resolver/bin/akari-assets.mjs

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
-// akari-assets — 素材 resolver v0 の CLI（list / fetch / bundle / sync / browse）。
+// akari-assets — 素材 resolver v0 の CLI（list / add / fetch / bundle / migrate / sync / browse）。
 //
-//   akari-assets list [--category <c>] [--json]
+//   akari-assets list [--category <c>] [--source <lab|site|own>] [--json]
+//   akari-assets add <path...> --plan [--json]
+//   akari-assets add --apply <plan.json> [--json]
 //   akari-assets fetch <id> [--project <dir>] [--reference] [--force]
 //   akari-assets bundle --project <dir> [--dry-run]
 //   akari-assets sync
 //   akari-assets browse [--port <n>]
 
+import { readFile } from 'node:fs/promises';
+import { planAdd, applyAdd } from '../src/add.mjs';
 import { migrateAssetLibrary } from '../../creator-root/src/index.mjs';
 import { startBrowseServer } from '../src/browse-server.mjs';
 import { bundleProjectReferences } from '../src/bundle.mjs';
@@ -19,6 +23,41 @@ function flagValue(args, name) {
   return i >= 0 && i + 1 < args.length ? args[i + 1] : null;
 }
 
+// Validate the entire command before any handler can read or mutate user data.
+function validateArgs(sub, args) {
+  const specs = {
+    list: { values: ['--category', '--source'], flags: ['--json'], max: 0 },
+    add: { values: ['--apply'], flags: ['--plan', '--json'], max: Infinity },
+    fetch: { values: ['--project'], flags: ['--reference', '--force'], min: 1, max: 1 },
+    bundle: { values: ['--project'], flags: ['--dry-run'], max: 0 },
+    migrate: { values: [], flags: ['--dry-run'], max: 0 },
+    sync: { values: [], flags: [], max: 0 },
+    browse: { values: ['--port'], flags: [], max: 0 },
+  };
+  const spec = specs[sub];
+  if (!spec) throw new Error(`不明なコマンド: ${sub}`);
+  const seen = new Set();
+  const positional = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith('-')) { positional.push(arg); continue; }
+    if (!spec.values.includes(arg) && !spec.flags.includes(arg)) throw new Error(`不明なオプション: ${arg}`);
+    if (seen.has(arg)) throw new Error(`重複したオプション: ${arg}`);
+    seen.add(arg);
+    if (spec.values.includes(arg) && (!args[++i] || args[i].startsWith('-'))) throw new Error(`${arg} には値が必要です`);
+  }
+  if (positional.length < (spec.min ?? 0) || positional.length > spec.max) throw new Error('引数の数が正しくありません');
+  if (sub === 'add' && (seen.has('--plan') === seen.has('--apply')
+    || (seen.has('--apply') ? positional.length !== 0 : positional.length === 0))) {
+    throw new Error('add は <path...> --plan または --apply <plan.json> を指定してください');
+  }
+  if (sub === 'bundle' && !seen.has('--project')) throw new Error('--project <dir> が必要です');
+  if (sub === 'fetch') {
+    if (args[0] !== positional[0]) throw new Error('fetch の先頭には素材 ID を指定してください');
+    if (seen.has('--reference') && !seen.has('--project')) throw new Error('--reference には --project <dir> が必要です');
+  }
+}
+
 const STATE_BADGE = { cached: '✓', locked: '¥', available: '☁' };
 
 function badgeOf(item) {
@@ -30,8 +69,11 @@ function badgeOf(item) {
 async function cmdList(args, env) {
   const category = flagValue(args, '--category');
   const asJson = args.includes('--json');
-  const { libraryRoots, items } = await composeState({ env });
-  const filtered = category ? items.filter((item) => item.category === category) : items;
+  const source = flagValue(args, '--source');
+  if (args.includes('--source') && !['lab', 'site', 'own'].includes(source)) throw new Error('--source は lab / site / own で指定してください');
+  const { libraryRoots, items, warnings } = await composeState({ env });
+  for (const warning of warnings) console.error(`警告: ${warning}`);
+  const filtered = items.filter(item => (!category || item.category === category) && (!source || item.sourceKind === source));
 
   if (asJson) {
     console.log(JSON.stringify(filtered, null, 2));
@@ -40,8 +82,23 @@ async function cmdList(args, env) {
 
   console.log(`使える素材 ${filtered.length} 件（ライブラリ: ${libraryRoots.write}）`);
   for (const item of filtered) {
-    console.log(`  ${badgeOf(item)}  ${item.id}\t[${item.category}]\t${item.title}`);
+    console.log(`  ${badgeOf(item)}  ${item.id}\t${item.sourceKind}\t[${item.category}]\t${item.title}`);
+  }
+}
+
+async function cmdAdd(args, env) {
+  const apply = flagValue(args, '--apply');
+  if (args.includes('--plan') === args.includes('--apply')) throw new Error('add は --plan または --apply <plan.json> のどちらかを指定してください');
+  let result;
+  if (args.includes('--apply')) {
+    if (!apply || args.some((arg, index) => !['--apply', '--json'].includes(arg) && index !== args.indexOf('--apply') + 1)) throw new Error('使い方: akari-assets add --apply <plan.json> [--json]');
+    result = await applyAdd(JSON.parse(await readFile(apply, 'utf8')), { env });
+    if (result.failures.length) process.exitCode = 1;
+  } else {
+    if (args.some(arg => arg.startsWith('--') && !['--plan', '--json'].includes(arg))) throw new Error('使い方: akari-assets add <path...> --plan [--json]');
+    result = await planAdd(args.filter(arg => !['--plan', '--json'].includes(arg)), { env });
   }
+  console.log(JSON.stringify(result, null, 2));
 }
 
 async function cmdFetch(args, env) {
@@ -120,9 +177,12 @@ async function cmdBrowse(args, env) {
 }
 
 function printUsage() {
-  console.log(`使い方: akari-assets <list|fetch|bundle|migrate|sync|browse> [options]
+  console.log(`使い方: akari-assets <list|add|fetch|bundle|migrate|sync|browse> [options]
 
-  list [--category <c>] [--json]          合成カタログ一覧（取得状態バッジ込み）
+  list [--category <c>] [--source <lab|site|own>] [--json]
+                                          出どころ・取得状態つき素材一覧
+  add <path...> --plan [--json]           ローカル素材の取り込み計画（書き込みなし）
+  add --apply <plan.json> [--json]        計画で選択した素材を複製して登録
   fetch <id> [--project <dir>] [--reference] [--force]
                                           素材を解決して登録（--reference はコピーせず参照を記帳）
   bundle --project <dir> [--dry-run]      参照素材をプロジェクトへ実体化（素材をまとめる）
@@ -142,6 +202,18 @@ async function main() {
   const [sub, ...rest] = process.argv.slice(2);
   const env = process.env;
 
+  if (!sub || process.argv.slice(2).some(arg => arg === '--help' || arg === '-h')) {
+    printUsage();
+    return;
+  }
+  try { validateArgs(sub, rest); }
+  catch (error) {
+    console.error(error.message);
+    printUsage();
+    process.exitCode = 2;
+    return;
+  }
+
   if (sub === 'migrate') {
     const result = await migrateAssetLibrary({ env, dryRun: rest.includes('--dry-run') });
     console.log(JSON.stringify(result, null, 2));
@@ -149,6 +221,7 @@ async function main() {
     return;
   }
   if (sub === 'list') return cmdList(rest, env);
+  if (sub === 'add') return cmdAdd(rest, env);
   if (sub === 'fetch') return cmdFetch(rest, env);
   if (sub === 'bundle') return cmdBundle(rest, env);
   if (sub === 'sync') return cmdSync(rest, env);