akari-video 1.4.1 → 1.5.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.4.1",
+  "version": "1.5.0-beta.2",
   "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/cli.mjs

@@ -29,6 +29,7 @@ import { runMediaCommand } from './media-command.mjs';
 import { runSpeakersCommand } from './speakers-command.mjs';
 import { runToolsCommand } from './tools-command.mjs';
 import { runWordBookCommand } from './word-book-command.mjs';
+import { runConnectCommand } from './connect-command.mjs';
 import { resolveRuntimePaths } from './runtime-diagnostics.mjs';
 import { cliText } from './i18n.mjs';
 
@@ -41,6 +42,7 @@ export const runSubcommands = {
   speakers: runSpeakersCommand,
   tools: runToolsCommand,
   'word-book': runWordBookCommand,
+  connect: runConnectCommand,
 };
 
 /**

package/src/connect/connectors.json

@@ -0,0 +1,80 @@
+[
+  {
+    "id": "akari-video",
+    "group": "tools",
+    "name": "AKARI Video",
+    "description": "動画を企画・編集する",
+    "icon": "A",
+    "kind": "built-in",
+    "try": "動画を作って"
+  },
+  {
+    "id": "3d-recipes",
+    "group": "tools",
+    "name": "3D レシピ",
+    "description": "Blender で 3D 素材を作る",
+    "icon": "3D",
+    "kind": "blender-recipe",
+    "try": "ロゴを 3D にして"
+  },
+  {
+    "id": "fal",
+    "group": "generate",
+    "name": "fal",
+    "description": "画像・映像・読み上げを作る",
+    "icon": "f",
+    "kind": "key",
+    "env": "FAL_KEY",
+    "setupUrl": "https://fal.ai/dashboard/keys",
+    "try": "商品を白背景で撮った写真を 4 枚",
+    "maker": "fal"
+  },
+  {
+    "id": "fish-audio",
+    "group": "generate",
+    "name": "Fish Audio",
+    "description": "原稿を読み上げる",
+    "icon": "F",
+    "kind": "key",
+    "env": "FISH_AUDIO_API_KEY",
+    "setupUrl": "https://fish.audio/app/api-keys/",
+    "try": "この原稿を読み上げて",
+    "maker": "fish"
+  },
+  {
+    "id": "google-ai",
+    "group": "generate",
+    "name": "Google AI",
+    "description": "原稿の読み上げ・声の写しを作る",
+    "icon": "G",
+    "kind": "key",
+    "env": "GEMINI_API_KEY",
+    "setupUrl": "https://aistudio.google.com/apikey",
+    "try": "この原稿を読み上げて",
+    "maker": "google"
+  },
+  {
+    "id": "elevenlabs",
+    "group": "generate",
+    "name": "ElevenLabs",
+    "description": "音声を文字起こしする",
+    "icon": "E",
+    "kind": "key",
+    "env": "ELEVENLABS_API_KEY",
+    "setupUrl": "https://elevenlabs.io/app/settings/api-keys",
+    "try": "この音声を文字起こしして",
+    "maker": "elevenlabs"
+  },
+  {
+    "id": "groq",
+    "group": "generate",
+    "name": "Groq",
+    "description": "音声を文字起こしする",
+    "icon": "G",
+    "kind": "key",
+    "env": "GROQ_API_KEY",
+    "setupUrl": "https://console.groq.com/keys",
+    "try": "この音声を文字起こしして",
+    "maker": "groq"
+  }
+]

package/src/connect-command.mjs

@@ -0,0 +1,211 @@
+import { cliText as t } from './i18n.mjs';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { constants as osConstants } from 'node:os';
+import { StringDecoder } from 'node:string_decoder';
+import { fileURLToPath } from 'node:url';
+
+const catalog = JSON.parse(fs.readFileSync(fileURLToPath(new URL('./connect/connectors.json', import.meta.url)), 'utf8'));
+
+const generation = catalog.filter(row => row.group === 'generate').map(row => row.id);
+const usage = () => t('cli.connectCommand.ui.usageText');
+const groupLabel = group => t(group === 'tools' ? 'cli.connectCommand.group.toolsLabel' : 'cli.connectCommand.group.generateLabel');
+const statusLabel = status => t({
+  ready: 'cli.connectCommand.ui.availableLabel', planned: 'cli.connectCommand.ui.comingSoonLabel',
+  'needs-key': 'cli.connectCommand.ui.keyRequiredLabel', 'needs-blender': 'cli.connectCommand.ui.requiresBlenderLabel'
+}[status]);
+
+export function connectPaths(env = process.env, home = os.homedir()) {
+  return {
+    settings: path.join(env.AKARI_HOME || path.join(home, '.akari'), 'connectors.json'),
+    primary: env.AKARI_CREDENTIALS_FILE || path.join(env.AKARI_HOME || path.join(home, '.akari'), 'credentials.env'),
+    legacy: env.AKARI_CREDENTIALS_FILE ? null : path.join(home, '.config', 'akari-video', 'credentials.env')
+  };
+}
+function readSettings(file) {
+  try {
+    const data = JSON.parse(fs.readFileSync(file, 'utf8'));
+    return {
+      enabled: typeof data.enabled === 'object' && data.enabled ? data.enabled : {},
+      generationOrder: Array.isArray(data.generationOrder) ? data.generationOrder.filter(id => generation.includes(id)) : [],
+      fallbackOnFailure: data.fallbackOnFailure === true
+    };
+  } catch (error) {
+    if (error.code === 'ENOENT') return { enabled: {}, generationOrder: [], fallbackOnFailure: false };
+    throw new Error(t('cli.connectCommand.ui.couldNotReadConnectionSettingsError'));
+  }
+}
+function readCredentialFile(file) {
+  const values = new Map();
+  if (!file) return values;
+  let content;
+  try {
+    const stat = fs.lstatSync(file);
+    if (!stat.isFile()) throw new Error();
+    content = fs.readFileSync(file, 'utf8');
+  } catch (error) {
+    if (error.code === 'ENOENT') return values;
+    throw new Error(t('cli.connectCommand.ui.couldNotReadCredentialsFileError'));
+  }
+  for (const raw of content.split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line || line.startsWith('#')) continue;
+    const index = line.indexOf('=');
+    const name = line.slice(0, index).trim();
+    if (index < 1 || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) continue;
+    let value = line.slice(index + 1).trim();
+    if (value.length >= 2 && (/^".*"$/.test(value) || /^'.*'$/.test(value))) value = value.slice(1, -1);
+    values.set(name, value);
+  }
+  return values;
+}
+function credentialValues(paths, env) {
+  const values = new Map();
+  for (const [name, value] of readCredentialFile(paths.legacy)) if (value.trim()) values.set(name, { value, source: 'credentials.env' });
+  for (const [name, value] of readCredentialFile(paths.primary)) if (value.trim()) values.set(name, { value, source: 'credentials.env' });
+  for (const entry of catalog) if (entry.env && typeof env[entry.env] === 'string' && env[entry.env].trim()) {
+    values.set(entry.env, { value: env[entry.env], source: 'env' });
+  }
+  return values;
+}
+function dirNames(root) {
+  try { return fs.readdirSync(root, { withFileTypes: true }).filter(entry => entry.isDirectory()).map(entry => entry.name); }
+  catch { return []; }
+}
+export function detectApp(id, roots, platform = process.platform) {
+  if (id !== 'blender') return false;
+  const pattern = platform === 'win32' ? /^(?:Blender Foundation|Blender(?: \d+)?)$/i : /^Blender(?: \d+(?:\.\d+)*)?\.app$/i;
+  return roots.some(root => dirNames(root).some(name => pattern.test(name)));
+}
+function detectBlenderCommand(env, platform) {
+  const executable = platform === 'win32' ? 'blender.exe' : 'blender';
+  const candidates = [env.BLENDER, ...(env.PATH || '').split(platform === 'win32' ? ';' : ':').map(directory => path.join(directory, executable))];
+  return candidates.some(candidate => {
+    if (!candidate) return false;
+    try { fs.accessSync(candidate, fs.constants.X_OK); return fs.statSync(candidate).isFile(); } catch { return false; }
+  });
+}
+export function listConnectors({ env = process.env, home = os.homedir(), platform = process.platform, roots } = {}) {
+  const paths = connectPaths(env, home);
+  const settings = readSettings(paths.settings);
+  const credentials = credentialValues(paths, env);
+  const scanRoots = roots || (platform === 'win32' ? [env.ProgramFiles, env['ProgramFiles(x86)']].filter(Boolean) : ['/Applications', path.join(home, 'Applications')]);
+  const order = [...new Set(settings.generationOrder), ...generation.filter(id => !settings.generationOrder.includes(id))];
+  const rows = catalog.map(entry => {
+    const detected = entry.kind === 'blender-recipe' ? detectApp('blender', scanRoots, platform) || (!roots && detectBlenderCommand(env, platform)) : false;
+    const credential = entry.env ? credentials.get(entry.env) : undefined;
+    const hasKey = !!credential;
+    const status = entry.kind === 'built-in' ? 'ready' : entry.kind === 'planned' ? 'planned' :
+      entry.kind === 'key' ? hasKey ? 'ready' : 'needs-key' :
+      entry.kind === 'blender-recipe' ? detected ? 'ready' : 'needs-blender' : 'planned';
+    return { id: entry.id, group: entry.group, name: entry.name, status, enabled: entry.kind === 'built-in' || settings.enabled[entry.id] !== false,
+      detected, credential: entry.env ? hasKey : null, credentialSource: credential?.source ?? null };
+  });
+  rows.sort((a, b) => a.group === 'generate' && b.group === 'generate' ? order.indexOf(a.id) - order.indexOf(b.id) : 0);
+  return { rows, generationOrder: order, fallbackOnFailure: settings.fallbackOnFailure };
+}
+
+export function createSecretRedactor(secret, emit) {
+  const decoder = new StringDecoder('utf8');
+  let pending = '';
+  const write = text => { if (text) emit(text); };
+  const longestPrefixSuffix = () => {
+    for (let length = Math.min(secret.length - 1, pending.length); length > 0; length--) {
+      if (secret.startsWith(pending.slice(-length))) return length;
+    }
+    return 0;
+  };
+  const drain = final => {
+    while (pending) {
+      const found = pending.indexOf(secret);
+      if (found >= 0) {
+        write(pending.slice(0, found));
+        write('[REDACTED]');
+        pending = pending.slice(found + secret.length);
+        continue;
+      }
+      const held = longestPrefixSuffix();
+      write(pending.slice(0, pending.length - held));
+      if (final && held) write('[REDACTED]');
+      pending = final ? '' : pending.slice(pending.length - held);
+      return;
+    }
+  };
+  return {
+    write(chunk) { pending += decoder.write(chunk); drain(false); },
+    end() { pending += decoder.end(); drain(true); }
+  };
+}
+
+async function forwardStream(stream, secret, emit) {
+  if (!stream) return;
+  const redactor = createSecretRedactor(secret, emit);
+  for await (const chunk of stream) redactor.write(chunk);
+  redactor.end();
+}
+
+export async function runConnectCommand(args, options = {}) {
+  const log = options.log || (line => process.stdout.write(`${line}\n`));
+  const error = options.error || (line => process.stderr.write(`${line}\n`));
+  const stdoutWrite = options.stdoutWrite || (chunk => process.stdout.write(chunk));
+  const stderrWrite = options.stderrWrite || (chunk => process.stderr.write(chunk));
+  const env = options.env || process.env;
+  const home = options.home || os.homedir();
+  if (args[0] === 'list' && (args.length === 1 || args.length === 2 && args[1] === '--json')) {
+    const data = listConnectors({ env, home, roots: options.roots, platform: options.platform });
+    if (args[1] === '--json') log(JSON.stringify({ ...data, rows: data.rows.map(row => ({
+      ...row, group: groupLabel(row.group), status: statusLabel(row.status)
+    })) }));
+    else {
+      let group = '';
+      for (const row of data.rows) {
+        if (row.group !== group) { group = row.group; log(groupLabel(group)); }
+        log(`  ${row.name}: ${statusLabel(row.status)}${row.enabled ? '' : t('cli.connectCommand.ui.disabledLabel')}`);
+      }
+    }
+    return { exitCode: 0 };
+  }
+  if (args[0] === 'exec' && args.length >= 4 && args[2] === '--') {
+    const entry = catalog.find(row => row.id === args[1]);
+    if (!entry?.env) { error(t('cli.connectCommand.ui.connectionCannotRunAPIKeyError')); return { exitCode: 2 }; }
+    const settings = readSettings(connectPaths(env, home).settings);
+    if (settings.enabled[entry.id] === false) { error(t('cli.connectCommand.ui.connectionDisabledMessage')); return { exitCode: 2 }; }
+    const credential = credentialValues(connectPaths(env, home), env).get(entry.env);
+    if (!credential) { error(t('cli.connectCommand.ui.noKeyHasBeenSetMessage')); return { exitCode: 2 }; }
+    const secret = credential.value;
+    const childEnv = { ...env };
+    for (const connector of catalog) if (connector.env) delete childEnv[connector.env];
+    // 旧カタログの鍵も子プロセスへ漏らさない。
+    delete childEnv.HF_KEY;
+    delete childEnv.RUNWAYML_API_SECRET;
+    childEnv[entry.env] = secret;
+    let child;
+    try {
+      child = (options.spawn || spawn)(args[3], args.slice(4), {
+        shell: false, env: childEnv, stdio: ['inherit', 'pipe', 'pipe']
+      });
+    } catch {
+      error(t('cli.connectCommand.ui.couldNotStartChildProcessError'));
+      return { exitCode: 1 };
+    }
+    let launchFailed = false;
+    const closed = new Promise(resolve => {
+      child.once('error', () => { launchFailed = true; });
+      child.once('close', (code, signal) => {
+        const signalCode = signal ? osConstants.signals[signal] : undefined;
+        resolve(typeof code === 'number' ? code : typeof signalCode === 'number' ? 128 + signalCode : 1);
+      });
+    });
+    const [exitCode] = await Promise.all([
+      closed,
+      forwardStream(child.stdout, secret, stdoutWrite),
+      forwardStream(child.stderr, secret, stderrWrite)
+    ]);
+    if (launchFailed) error(t('cli.connectCommand.ui.couldNotStartChildProcessError'));
+    return { exitCode };
+  }
+  error(usage());
+  return { exitCode: 2 };
+}

package/src/new-command.mjs

@@ -1,9 +1,11 @@
 import fs from 'node:fs/promises';
+import os from 'node:os';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
 
 import { resolveLauncherAssets } from './repo-assets.mjs';
 import { cliText } from './i18n.mjs';
+import { findExecutable } from './path-lookup.mjs';
 
 const usage = (lang) => cliText('cli.new.help.usage', {}, lang);
 const languageTagPattern = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
@@ -11,6 +13,7 @@ const languageTagPattern = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
 function parseArguments(args) {
     let target;
     let template;
+    let from;
     let lang;
 
     for (let index = 0; index < args.length; index += 1) {
@@ -22,6 +25,13 @@ function parseArguments(args) {
             }
             template = value;
             index += 1;
+        } else if (argument === '--from') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new Error(`${usage()}\n${cliText('cli.new.error.fromMissing', {})}`);
+            }
+            from = value;
+            index += 1;
         } else if (argument === '--lang') {
             const value = args[index + 1];
             if (!value || !languageTagPattern.test(value)) {
@@ -41,7 +51,7 @@ function parseArguments(args) {
     if (target === undefined) {
         throw new Error(usage());
     }
-    return { target, template, lang };
+    return { target, template, from, lang };
 }
 
 async function directoryHasFile(directory, relativeFile) {
@@ -53,6 +63,28 @@ async function directoryHasFile(directory, relativeFile) {
     }
 }
 
+async function resolvePlaybookDir(from, { cwd, targetDir, assets, env = process.env }) {
+    const explicit = path.resolve(cwd, from);
+    if (await directoryHasFile(explicit, 'playbook.json')) return explicit;
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(from)) return null;
+    if (assets.creatorRootModulePath) {
+        const { resolveCreatorRoot } = await import(pathToFileURL(assets.creatorRootModulePath).href);
+        const root = await resolveCreatorRoot({ cwd, env });
+        if (root?.error) throw root.error;
+        const relative = root && path.relative(root.rootDir, targetDir);
+        const segments = relative?.split(path.sep) ?? [];
+        const fromTarget = segments[0] === 'channels' ? segments[1] : null;
+        const channel = fromTarget && root?.manifest?.channels?.includes(fromTarget)
+            ? fromTarget : root?.manifest?.channels?.[0];
+        if (root && channel) {
+            const candidate = path.join(root.rootDir, 'channels', channel, 'playbooks', from);
+            if (await directoryHasFile(candidate, 'playbook.json')) return candidate;
+        }
+    }
+    const local = path.join(env.AKARI_HOME || path.join(os.homedir(), '.akari'), 'playbooks', from);
+    return await directoryHasFile(local, 'playbook.json') ? local : null;
+}
+
 export async function runNewCommand(args, options = {}) {
     const text = (key, params) => cliText(key, params);
     const log = options.log ?? ((line) => console.log(line));
@@ -62,6 +94,7 @@ export async function runNewCommand(args, options = {}) {
 
     if (args.includes('--help') || args.includes('-h')) {
         log(usage());
+        log(text('cli.new.help.fromUsage'));
         return { exitCode: 0 };
     }
 
@@ -73,9 +106,18 @@ export async function runNewCommand(args, options = {}) {
         return { exitCode: 1 };
     }
 
-    const { target, template, lang } = parsed;
+    const { target, template, from, lang } = parsed;
     const targetDir = path.resolve(cwd, target);
     const templateDir = template ? path.resolve(cwd, template) : assets.templateDir;
+    let playbookDir;
+    if (from) {
+        try { playbookDir = await resolvePlaybookDir(from, { cwd, targetDir, assets, env: options.env }); }
+        catch (error) { logError(error.message); return { exitCode: 1 }; }
+        if (!playbookDir) {
+            logError(text('cli.new.error.fromNotFound', { from }));
+            return { exitCode: 1 };
+        }
+    }
 
     if (!templateDir) {
         logError(text('cli.new.error.templateUnavailable'));
@@ -107,9 +149,21 @@ export async function runNewCommand(args, options = {}) {
 
     try {
         const createProject = options.createProject ?? await defaultCreateProject(assets.scaffoldModulePath);
-        const result = await createProject(targetDir, templateDir, hasSkills
+        const scaffoldOptions = hasSkills
             ? { skillsSourceDir, schemasSourceDir: hasSchemas ? schemasSourceDir : undefined }
-            : {});
+            : {};
+        let applied;
+        if (playbookDir) {
+            const scaffold = options.scaffold ?? await import(pathToFileURL(assets.scaffoldModulePath).href);
+            const env = options.env ?? process.env;
+            scaffoldOptions.beforeCommit = async (destination) => {
+                applied = await scaffold.applyPlaybook({ projectDir: destination, playbookDir,
+                    hasTool: (name) => Boolean(findExecutable(name, env.PATH ?? process.env.PATH ?? '', process.platform,
+                        env.PATHEXT ?? process.env.PATHEXT)) });
+                return applied;
+            };
+        }
+        const result = await createProject(targetDir, templateDir, scaffoldOptions);
         if (lang) {
             const intakePath = path.join(targetDir, '.akari', 'intake.json');
             const intake = JSON.parse(await fs.readFile(intakePath, 'utf8'));
@@ -123,7 +177,12 @@ export async function runNewCommand(args, options = {}) {
         log(text('cli.new.result.skills', { status: hasSkills ? text('cli.new.label.included', { path: skillsSourceDir }) : text('cli.new.label.skipped') }));
         log(`git: ${result.git.action}`);
         log(text('cli.new.result.report', { path: result.reportPath }));
-        return { exitCode: 0, result };
+        if (applied) {
+            log(text('cli.new.result.fromApplied', { path: applied.playbookJsonPath }));
+            log(text('cli.new.result.sheet', { path: applied.sheetPath }));
+            for (const tool of applied.missingTools) log(text('cli.new.warning.toolMissing', { tool }));
+        }
+        return { exitCode: 0, result, applied };
     } catch (error) {
         logError(error instanceof Error ? error.message : String(error));
         return { exitCode: 1 };

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

@@ -90,6 +90,7 @@
     "docs/contract-2026-10-11-speaker-split-v0.md",
     "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",
     "packages/akari-ear/package.json",
     "packages/akari-ear/README.md",
     "packages/akari-launcher/package.json",
@@ -180,6 +181,7 @@
     "skills/compile-review-session/dev-fixtures/issue-79/README.md",
     "skills/compile-review-session/dev-fixtures/README.md",
     "skills/compile-review-session/SKILL.md",
+    "skills/connect/SKILL.md",
     "skills/create-project/SKILL.md",
     "skills/critique-cut/SKILL.md",
     "skills/critique-cut/workflow.md",
@@ -236,6 +238,7 @@
     "skills/overlay-authoring/text-behind-person.md",
     "skills/overlay-authoring/thumbnail.md",
     "skills/overlay-authoring/world.md",
+    "skills/record-playbook/SKILL.md",
     "skills/render-cut/SKILL.md",
     "skills/research-plan/competitor.md",
     "skills/research-plan/ideate.md",

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

@@ -4,6 +4,13 @@
   "title": "カメラシャッター SFX",
   "description": "一眼レフ実機（Canon T2i）のシャッター音。写真の切り替えや決定的瞬間の演出に使える短尺 SFX。尺 0.3秒",
   "when_to_use": "写真ギャラリー/スライドショーのカット送り、Before/After 比較、決定的瞬間を強調する演出",
+  "i18n": {
+    "en": {
+      "title": "Camera Shutter SFX",
+      "description": "The shutter of a real Canon T2i DSLR. A short 0.3-second effect for switching photos or marking a decisive moment.",
+      "when_to_use": "For advancing photos in galleries or slideshows, before/after comparisons, and emphasizing decisive moments."
+    }
+  },
   "tags": ["sfx", "camera", "shutter", "photo", "snap"],
   "knobs": [],
   "ai_usage": "音量調整・複数回の重ね掛けは自由。映像のタイミングに合わせたトリムも可。ピッチ・速度を大きく変えると素材の質感が崩れるため軽微な調整に留める",

package/vendor/catalog/audio/candidates-legacy.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "setup-audio-library 候補リストのデータ SSOT。skills/setup-audio-library と packages/audio-library-setup/bin/generate-candidates-html.mjs がこのファイルを読む。根拠: research/2026-07-22-free-sfx-bgm-sources.md（内部リポ）。リンクは必ずダウンロードページ URL（音声ファイル直 URL は禁止 — 効果音ラボ/甘茶/H-MIX GALLERY 等の直リンク禁止規約対応）。",
+  "$comment": "setup-audio-library 候補リストのデータ SSOT。skills/setup-audio-library と packages/audio-library-setup/bin/generate-candidates-html.mjs がこのファイルを読む。リンクは必ずダウンロードページ URL（音声ファイル直 URL は禁止 — 効果音ラボ/甘茶/H-MIX GALLERY 等の直リンク禁止規約対応）。",
   "version": 1,
   "generated_at": "2026-07-22",
   "source_research": "internal: research/2026-07-22-free-sfx-bgm-sources.md",

package/vendor/catalog/audio/corporate-upbeat-bgm/meta.json

@@ -4,6 +4,13 @@
   "title": "コーポレート・アップビート BGM",
   "description": "ミニマルなビート主体の明るいコーポレート BGM。テック企業のプロモーションや製品デモに合う清潔感のあるトラック。尺 2分05秒",
   "when_to_use": "SaaS/アプリ紹介、製品デモ、会社紹介動画のオープニング〜本編 BGM として",
+  "i18n": {
+    "en": {
+      "title": "Upbeat Corporate BGM",
+      "description": "Bright corporate background music built around a minimal beat. A clean track suited to tech-company promotions and product demos. Duration: 2 minutes 05 seconds.",
+      "when_to_use": "For opening and main-section music in SaaS or app introductions, product demos, and company-profile videos."
+    }
+  },
   "tags": ["bgm", "corporate", "upbeat", "tech", "background-music"],
   "knobs": [],
   "ai_usage": "書き出し尺に合わせたトリミング・フェードイン/アウト・ループでの尺調整は自由に行ってよい。ナレーションやセリフが乗る区間は自動でダッキング（音量を下げる）してよい。曲の構成やテンポそのものを崩す大幅なピッチ/速度変更は避ける",

package/vendor/catalog/audio/cozy-lofi-bgm/meta.json

@@ -4,6 +4,13 @@
   "title": "コージー Lo-fi チル BGM",
   "description": "Pixabay Editor's Choice 選出のローファイ・チルビート。落ち着いた質感で Vlog や作業風景、夜のシーンに合う。尺 2分27秒",
   "when_to_use": "Vlog、作業・勉強シーン、就寝前コンテンツなど落ち着いたトーンの BGM が欲しいシーン",
+  "i18n": {
+    "en": {
+      "title": "Cozy Lo-fi Chill BGM",
+      "description": "A lo-fi chill beat selected as a Pixabay Editor's Choice. Its mellow texture suits vlogs, work scenes, and nighttime footage. Duration: 2 minutes 27 seconds.",
+      "when_to_use": "For vlogs, work or study scenes, and bedtime content needing calm background music."
+    }
+  },
   "tags": ["bgm", "lofi", "chill", "cozy", "background-music"],
   "knobs": [],
   "ai_usage": "書き出し尺に合わせたトリミング・フェードイン/アウト・ループでの尺調整は自由に行ってよい。ナレーションやセリフが乗る区間は自動でダッキング（音量を下げる）してよい。曲の構成やテンポそのものを崩す大幅なピッチ/速度変更は避ける",

package/vendor/catalog/audio/dova-syndrome-cheerleaders-bgm/meta.json

@@ -4,6 +4,13 @@
   "title": "DOVA-SYNDROME Cheerleaders（BGM）",
   "description": "明るく楽しい雰囲気のアップテンポBGM。DOVA-SYNDROME公式YouTubeチャンネルでもプレビュー公開されている楽曲。（収録数: 1点）",
   "when_to_use": "明るい/楽しい雰囲気を出したい場面のBGM、応援・盛り上げ系のシーンに",
+  "i18n": {
+    "en": {
+      "title": "DOVA-SYNDROME Cheerleaders (BGM)",
+      "description": "Up-tempo background music with a bright, fun mood. A preview is also published on DOVA-SYNDROME's official YouTube channel. Includes 1 item.",
+      "when_to_use": "For cheerful background music, encouragement, and high-energy scenes."
+    }
+  },
   "tags": [
     "bgm",
     "upbeat",

package/vendor/catalog/audio/dova-syndrome-hatena-mark-se/meta.json

@@ -4,6 +4,13 @@
   "title": "DOVA-SYNDROME はてなマーク効果音",
   "description": "フレクサトーン音を加工した「ぽよ〜ん」とした質問符（？）ポップアップ効果音。キャラクターが困惑・疑問を示す場面向け。（収録数: 1点）",
   "when_to_use": "キャラクターの頭上に「？」が浮かぶ疑問・困惑の一瞬を表現したいとき",
+  "i18n": {
+    "en": {
+      "title": "DOVA-SYNDROME Question Mark SFX",
+      "description": "A springy question-mark popup effect made from a processed flexatone sound, for characters showing puzzlement or uncertainty. Includes 1 item.",
+      "when_to_use": "For the instant a question mark appears over a character's head to express doubt or confusion."
+    }
+  },
   "tags": [
     "sfx",
     "reaction",

package/vendor/catalog/audio/dova-syndrome-user-manual/meta.json

@@ -4,6 +4,13 @@
   "title": "DOVA-SYNDROME 定番BGM（2:23 AM / Morning）",
   "description": "Vlog・解説の敷きに使える定番の落ち着き/ポップ系 BGM 2 点。（収録数: 2点）",
   "when_to_use": "Vlog の出だし・締め・ガジェット/IT 系の敷き（2_23_AM）、外出・ポジティブな場面（Morning）",
+  "i18n": {
+    "en": {
+      "title": "DOVA-SYNDROME Standard BGM (2:23 AM / Morning)",
+      "description": "Two standard calm and pop background tracks for vlogs and explainers. Includes 2 items.",
+      "when_to_use": "For vlog openings and endings or gadget and IT backgrounds (2_23_AM), and outings or upbeat scenes (Morning)."
+    }
+  },
   "tags": [
     "bgm",
     "calm",

package/vendor/catalog/audio/freesound-inspectorj-pencil-writing/meta.json

@@ -4,6 +4,13 @@
   "title": "Freesound 鉛筆で書く音（InspectorJ）",
   "description": "鉛筆で紙に書く音を至近距離でマイクが追従して収録したリアルな筆記音（尺12.7秒）。H1 Zoomレコーダーで2016年11月1日に収録。（収録数: 1点）",
   "when_to_use": "手書き/筆記シーンの実写的な筆記音、ノート/手紙を書く描写のリアリズムを足したいとき",
+  "i18n": {
+    "en": {
+      "title": "Freesound Pencil Writing (InspectorJ)",
+      "description": "Realistic close-miked pencil writing on paper, with the microphone following the pencil. Duration: 12.7 seconds. Recorded on a Zoom H1 on November 1, 2016. Includes 1 item.",
+      "when_to_use": "For realistic writing sounds in live-action handwriting scenes and added detail when someone writes in a notebook or letter."
+    }
+  },
   "tags": [
     "sfx",
     "writing",

package/vendor/catalog/audio/impact-sfx-pack/meta.json

@@ -4,6 +4,13 @@
   "title": "インパクト SFX パック",
   "description": "衝突・打撃・フォーリー系の効果音 130 点セット。テロップの強調出現やカット切り替え、アクセントを付けたい瞬間に使える短尺の衝撃音が中心",
   "when_to_use": "強調テロップの出現・カット切り替え・ビートに合わせたアクセント演出など、映像に「ドン」「ガツン」といった衝撃感を足したいシーン",
+  "i18n": {
+    "en": {
+      "title": "Impact SFX Pack",
+      "description": "A set of 130 collision, hit, and Foley sound effects, mostly short impacts for emphasized caption entrances, cut changes, and moments needing an accent.",
+      "when_to_use": "For emphasized caption entrances, cut changes, and beat-aligned accents that need a thump or sharp impact."
+    }
+  },
   "tags": ["sfx", "impact", "foley", "transition", "accent"],
   "knobs": [],
   "ai_usage": "取得後は音源をそのまま edit.json のカット点・強調ポイントに合わせて配置する用途を想定。音源そのもの（波形）は改変しない。音量調整はクリップ側のパラメータで行う",

package/vendor/catalog/audio/maoudamashii-bgm-neorock/meta.json

@@ -4,6 +4,13 @@
   "title": "魔王魂 ネオロック（Burn_Place / Speed_King / Desert_journey）",
   "description": "対決・闘志の演出に使える激しめロック BGM 3 点。（収録数: 3点）",
   "when_to_use": "相手と戦う・闘志を燃やす・速いテンポで畳み掛ける場面",
+  "i18n": {
+    "en": {
+      "title": "Maoudamashii Neo Rock (Burn_Place / Speed_King / Desert_journey)",
+      "description": "Three intense rock background tracks for confrontation and fighting spirit. Includes 3 items.",
+      "when_to_use": "For fighting an opponent, building resolve, or driving through a fast-paced sequence."
+    }
+  },
   "tags": [
     "bgm",
     "rock",

package/vendor/catalog/audio/maoudamashii-bgm-piano/meta.json

@@ -2,8 +2,15 @@
   "id": "maoudamashii-bgm-piano",
   "category": "audio",
   "title": "魔王魂 ピアノ（静寂の世界へ / 見渡す街へ）",
-  "description": "静けさ・ゆったりした時間の流れを出すピアノ BGM 2 点。（収録数: 2点） 【audio-standard】部分参加 1/2 音（対象はローカル index.jsonl の standard フラグ / 正本は内部リポ sfx-curation.json）",
+  "description": "静けさ・ゆったりした時間の流れを出すピアノ BGM 2 点。（収録数: 2点） 【audio-standard】部分参加 1/2 音（対象はローカル index.jsonl の standard フラグ）",
   "when_to_use": "静寂・喪失・ぼんやりした時間（静寂の世界へ）、美しい景色をゆったり見せる場面（見渡す街へ）",
+  "i18n": {
+    "en": {
+      "title": "Maoudamashii Piano (Seijaku no Sekai e / Miwatasu Machi e)",
+      "description": "Two piano background tracks for quiet and unhurried time. Includes 2 items. Under audio-standard, 1 of 2 sounds participates; the local index.jsonl standard flag identifies the item.",
+      "when_to_use": "For silence, loss, or drifting time (Seijaku no Sekai e), and for lingering over beautiful scenery (Miwatasu Machi e)."
+    }
+  },
   "tags": [
     "bgm",
     "piano",