akari-video 1.3.0 → 1.4.0

package/package.json

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

@@ -1,5 +1,6 @@
 import { spawnSync } from 'node:child_process';
-import { dirname, resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 
 import { resolveLauncherAssets } from './repo-assets.mjs';
@@ -7,13 +8,12 @@ import { cliText } from './i18n.mjs';
 import { assetsResolverUnavailableError } from './messages.mjs';
 
 /**
- * `akari assets <list|fetch|sync|...>` — `packages/asset-resolver` の CLI
- * （`bin/akari-assets.mjs`）への薄い委譲（タスク契約 2026-08-09-agent-assets-discovery）。
+ * `akari assets <list|fetch|sync|...>` は `packages/asset-resolver` の CLI
+ * （`bin/akari-assets.mjs`）へ委譲する。`audio` は音源補助スクリプトへ振り分ける。
  *
  * カタログ合成・entitlements 判定・取得・sha256 検証・validate-asset・fail-closed の実ロジックは
- * すべて resolver 側の責務のまま変更しない。認証（`~/.akari/store-credentials.json`）も
- * resolver がそのまま読む。ここでは引数をそのまま子プロセスへ転送し、resolver 側の usage /
- * エラー文言 / exit code をそのまま利用者に返すだけ。
+ * resolver 側の責務のまま変更しない。認証情報も
+ * resolver がそのまま読む。通常の引数はそのまま子プロセスへ転送する。
  *
  * 規約は他の launcher 委譲コマンド（`akari sounds` = sounds-setup.mjs）と同じ:
  *   - 同梱の実体解決は `resolveLauncherAssets()`（モノレポ checkout → npm 配布時の vendor/）
@@ -32,6 +32,44 @@ export async function runAssetsCommand(args, options = {}) {
   const env = options.env ?? process.env;
   const assets = options.assets ?? resolveLauncherAssets();
 
+  if (args[0] === 'audio') {
+    const sub = args[1];
+    const usage = cliText('cli.assets.audio.usage');
+    const log = options.log ?? ((line) => console.log(line));
+    if (!sub || sub === '--help' || sub === '-h') { log(usage); return { exitCode: 0 }; }
+    const scripts = { candidates: 'generate-candidates-html.mjs', drop: 'register-drop-folder.mjs', gallery: 'gallery-helper.mjs' };
+    if (!Object.hasOwn(scripts, sub)) {
+      logError(cliText('cli.assets.audio.unknownSubcommand', { value: sub }));
+      log(usage);
+      return { exitCode: 1 };
+    }
+    const script = assets?.audioFetchScriptPath && join(dirname(assets.audioFetchScriptPath), scripts[sub]);
+    if (!script || !existsSync(script)) {
+      logError(cliText('cli.assets.audio.scriptMissing'));
+      return { exitCode: 1 };
+    }
+    const cliPath = assets?.assetResolverCliPath;
+    if (!cliPath && !options.audioSetupDefaults) {
+      logError(assetsResolverUnavailableError());
+      return { exitCode: 1 };
+    }
+    const resolveDefaults = options.audioSetupDefaults
+      ?? (await import(pathToFileURL(resolve(dirname(cliPath), '../src/bundled-catalog.mjs')).href)).audioSetupDefaults;
+    const { root, candidatesPath, catalogDir, candidatesHtmlPath } = resolveDefaults(env);
+    if (!root) { logError(cliText('cli.assets.audio.catalogMissing')); return { exitCode: 1 }; }
+    const supplied = args.slice(2);
+    const extra = [];
+    function addDefault(flag, value) { if (!supplied.includes(flag)) extra.push(flag, value); }
+    if (sub !== 'gallery') {
+      addDefault('--candidates', candidatesPath);
+      addDefault('--catalog-dir', catalogDir);
+    }
+    if (sub === 'candidates') addDefault('--out', candidatesHtmlPath);
+    const spawn = options.spawnAudioCli ?? defaultSpawnAssetsCli;
+    const result = spawn(script, [...supplied, ...extra], env);
+    return { exitCode: typeof result.status === 'number' ? result.status : 1 };
+  }
+
   // These catalog pack IDs are reference entries; their tracks are distributed by the
   // first-party Sounds fetcher, while the resolver catalog contains only individual IDs.
   if (args[0] === 'fetch' && /^akari-sounds-[a-z0-9-]+$/u.test(args[1] ?? '')) {

package/src/messages.mjs

@@ -335,7 +335,7 @@ export function describeCliHelp() {
     cliText('cli.help.header.usage'),
     '',
     cliText('cli.help.commands.heading'),
-    ...['launch', 'store', 'sounds', 'doctor', 'speakers', 'toolsVoice', 'update', 'status', 'migrate', 'generate', 'storyboard', 'clean'].map((name) => cliText(`cli.help.commands.${name}`)),
+    ...['launch', 'store', 'sounds', 'doctor', 'speakers', 'toolsVoice', 'update', 'status', 'migrate', 'migrateLook', 'generate', 'storyboard', 'clean'].map((name) => cliText(`cli.help.commands.${name}`)),
     '',
     cliText('cli.help.developer.heading'),
     ...['opencode', 'claude', 'yes', 'version', 'new', 'init', 'other', 'help'].map((name) => cliText(`cli.help.developer.${name}`)),

package/src/vendor-sources.mjs

@@ -5,6 +5,45 @@
 // `export const` + `VENDOR_SOURCES = [` の形とベタ書き文字列のまま保つこと。変数展開・spread・
 // 他ファイルからの合成を入れると、安全に検査できないためゲートが fail-closed で落ちる。
 export const VENDOR_SOURCES = [
+  // catalog/audio 全体を含めると再配布できないライセンスの項目も入る。
+  // 参照用の音源は個別に列挙し、新規追加時は配布テストで列挙漏れを検出する。
+  'catalog/INDEX.md',
+  'catalog/packs.json',
+  'catalog/sites',
+  'catalog/font',
+  'catalog/scene3d',
+  'catalog/broll',
+  'catalog/browser',
+  'catalog/avatars',
+  'catalog/audio/candidates.json',
+  'catalog/audio/candidates.html',
+  'catalog/audio/candidates-legacy.json',
+  'catalog/audio/camera-shutter',
+  'catalog/audio/corporate-upbeat-bgm',
+  'catalog/audio/cozy-lofi-bgm',
+  'catalog/audio/dova-syndrome-cheerleaders-bgm',
+  'catalog/audio/dova-syndrome-hatena-mark-se',
+  'catalog/audio/dova-syndrome-user-manual',
+  'catalog/audio/freesound-inspectorj-pencil-writing',
+  'catalog/audio/impact-sfx-pack',
+  'catalog/audio/maoudamashii-bgm-neorock',
+  'catalog/audio/maoudamashii-bgm-piano',
+  'catalog/audio/maoudamashii-object-sound-15',
+  'catalog/audio/maoudamashii-se-magic-category',
+  'catalog/audio/maoudamashii-se-onepoint-category',
+  'catalog/audio/maoudamashii-se-system-category',
+  'catalog/audio/musmus-hageshii-atsui-upper',
+  'catalog/audio/musmus-onomatope-sfx-pack',
+  'catalog/audio/musmus-yuttari-honobono',
+  'catalog/audio/otologic-motion-pop-sfx-pack',
+  'catalog/audio/otologic-sfx-selection',
+  'catalog/audio/pocket-se-fail-pack',
+  'catalog/audio/soundeffect-lab-ambient-life-pack',
+  'catalog/audio/soundeffect-lab-anime-direction-pack',
+  'catalog/audio/soundeffect-lab-scene-transition',
+  'catalog/audio/soundeffect-lab-ui-signal-pack',
+  'catalog/audio/ui-click-sfx-pack',
+  'catalog/audio/whoosh-transition',
   'skills',
   'templates/project-default',
   'presets/luts',

package/vendor/catalog/INDEX.md

@@ -0,0 +1,39 @@
+# AKARI Video 素材カタログ
+
+このディレクトリは、`assets/` と同じ meta.json v0 契約を使う「取得先の索引」です。
+バイナリそのものはホストせず、各エントリの meta.json に `source`（取得先 URL・取得方法・
+ライセンス表記）と `remote: true` を持たせて、取得はユーザー自身の環境に委ねます。
+詳細な契約は [`docs/contract-2026-07-13-asset-library.md`](../docs/contract-2026-07-13-asset-library.md)
+の「カタログと取得スキル」§を参照してください。
+
+利用者のプロジェクトには、この `catalog/` フォルダはありません。
+エージェントや CLI からは `akari assets catalog` で場所を、`akari assets list --source site` で外部項目の一覧を確認します。
+1 件の取得先は `akari assets show <category/id>`、取り込んだ素材の検証は `akari assets validate <dir>` を使います。
+
+## 入庫基準
+
+`assets/` と同じく「生成コストが高い、または生成不能なものだけ」を入れます。加えて、
+取得元の再配布ライセンスがバイナリ同梱を許さないもの（フォント等）は、この
+カタログ（`remote: true`）側で扱います。
+
+## カテゴリ
+
+計 64 件収録。
+
+カテゴリは `assets/` と同じく**配布物の形**で切ります（2026-07-29 変更）。主題は tags です。
+
+- [scene3d](./scene3d/INDEX.md) — 製品モックアップなど、再生成が難しい 3D モデル・HDRI の取得先。3 件収録。
+- **overlay** — 映像に重ねる時間つき HTML 断片の取得先。整備中。0 件収録。
+- [audio](./audio/INDEX.md) — BGM・ジングルは AKARI Sounds が既定。効果音は外部の無料の参照ライブラリが中心。定番は `pack:audio-standard` タグで示し、パック台帳は [packs.json](./packs.json) を参照。29 件収録。
+- [broll](./broll/INDEX.md) — 主映像を補足する実写映像素材の取得先。1 件収録。
+- [font](./font/INDEX.md) — 特定の書体そのもの（グリフ）は生成不能なため、取得先の索引として扱う。31 件収録。
+- [avatars](./avatars/INDEX.md) — 性格・話し口調を核に 2D/3D/実写/音声を rendition として持つキャラクター登録。`rights.subject` が `original` / `third_party` のもののみ入庫可（実在人物は個人スコープへ）。**本カテゴリだけは meta.json v0 ではなく avatar registry v0（`packages/schemas/avatar.schema.json`）で検証する**別契約です（`docs/contract-2026-07-26-avatar-registry-v0.md`）。0 件収録。
+
+## ここに無いもの（2026-07-29 移設）
+
+テロップテンプレート（36 件）と LUT（2 件）は [presets/](../presets/INDEX.md) へ移しました。
+どちらも実体を持ち、人が選んでコピーするのではなく**コードが id でファイルを引く参照表**であり、
+「実体を持たない取得先の索引」というこのディレクトリの契約に合わなかったためです。
+
+- テロップ → ATF 描画は退役。HTML 素材版を Lab で取得してください。
+- LUT → [presets/luts/](../presets/luts/INDEX.md)（`edit.json` の `output.look.lut`）

package/vendor/catalog/audio/camera-shutter/meta.json

@@ -0,0 +1,31 @@
+{
+  "id": "camera-shutter",
+  "category": "audio",
+  "title": "カメラシャッター SFX",
+  "description": "一眼レフ実機（Canon T2i）のシャッター音。写真の切り替えや決定的瞬間の演出に使える短尺 SFX。尺 0.3秒",
+  "when_to_use": "写真ギャラリー/スライドショーのカット送り、Before/After 比較、決定的瞬間を強調する演出",
+  "tags": ["sfx", "camera", "shutter", "photo", "snap"],
+  "knobs": [],
+  "ai_usage": "音量調整・複数回の重ね掛けは自由。映像のタイミングに合わせたトリムも可。ピッチ・速度を大きく変えると素材の質感が崩れるため軽微な調整に留める",
+  "requires": [],
+  "provenance": {
+    "origin": "AKARI Video 素材カタログ収録（Freesound / roachpowder）/ 2026-07-14",
+    "generator": null
+  },
+  "author": "ryoma",
+  "license": {
+    "spdx": "CC0-1.0",
+    "scope": "commercial-ok",
+    "attribution_required": false,
+    "ai_training_allowed": true
+  },
+  "tier": "free",
+  "price": null,
+  "remote": true,
+  "source": {
+    "url": "https://freesound.org/people/roachpowder/sounds/170229/",
+    "acquisition": "login",
+    "license_at_source": "CC0 1.0",
+    "attribution_required": false
+  }
+}