akari-video 0.1.79 → 0.1.80

package/package.json

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

@@ -41,6 +41,8 @@ const commandUsage = [
   "サブコマンド:",
   "  generate  原稿からナレーション音声を生成する",
   "  engines   エンジン一覧を表示する",
+  "  start     VOICEVOX エンジンを起動する",
+  "  stop      AKARI が起動した VOICEVOX エンジンを止める",
   "  voices    声一覧を表示する",
   "",
   usage,
@@ -358,12 +360,14 @@ async function synthesizeFal(readingText, meta, falKey) {
  * 純粋関数にして `platform` / `env` を注入でき、実プラットフォームに依存せずテストできる
  * ようにする（darwin 既定パスは不変。win32 既定パスの根拠は report.md 参照）。
  */
-export function resolveVoicevoxRunPath(platform = process.platform, env = process.env) {
+export function resolveVoicevoxRunPath(platform = process.platform, env = process.env, exists = fs.existsSync) {
   const override = env[VOICEVOX_RUN_ENV];
   if (override) return override;
 
   if (platform === "darwin") {
-    return "/Applications/VOICEVOX.app/Contents/Resources/vv-engine/run";
+    const candidates = ["/Applications/VOICEVOX.app/Contents/Resources/vv-engine/run",
+      path.join(env.HOME || os.homedir(), "Applications", "VOICEVOX.app", "Contents", "Resources", "vv-engine", "run")];
+    return candidates.find(candidate => exists(candidate)) || candidates[0];
   }
   if (platform === "win32") {
     // VOICEVOX 0.16+ の既定インストーラ配置先（root repo 未検証・GitHub issue で確認済み。
@@ -428,6 +432,108 @@ async function getVoicevoxVersion() {
   return String(await response.json()).trim();
 }
 
+function voicevoxPidPath(env = process.env, homeDir = os.homedir()) {
+  return path.join(env.AKARI_HOME || path.join(homeDir, ".akari"), "run", "voicevox.pid");
+}
+
+async function probeVoicevox(fetchImpl = fetch) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 1500);
+  try {
+    const response = await fetchImpl(`${VOICEVOX_BASE_URL}/version`, { signal: controller.signal });
+    return response.ok ? { running: true, version: String(await response.json()).trim() } : { running: false };
+  } catch { return { running: false }; }
+  finally { clearTimeout(timer); }
+}
+
+function defaultProcessAlive(pid) {
+  try { process.kill(pid, 0); return true; }
+  catch { return false; }
+}
+
+function defaultProcessCommand(pid) {
+  if (process.platform === "win32") return null;
+  const result = spawnSync("ps", ["-p", String(pid), "-o", "command="], {
+    encoding: "utf8", timeout: 3_000, maxBuffer: 64 * 1024,
+  });
+  return result.status === 0 ? result.stdout.trim() : null;
+}
+
+function managedVoicevoxPid(runtime = {}) {
+  const fileSystem = runtime.fsImpl || fs;
+  const env = runtime.env || process.env;
+  const pidPath = runtime.pidPath || voicevoxPidPath(env, runtime.homeDir);
+  let pid;
+  try {
+    pid = Number(fileSystem.readFileSync(pidPath, "utf8").trim());
+  } catch { return null; }
+  let runPath;
+  try {
+    runPath = resolveVoicevoxRunPath(runtime.platform || process.platform, env,
+      candidate => fileSystem.existsSync(candidate));
+  } catch { /* 実行ファイルを特定できなければ停止しない */ }
+  let command = null;
+  try {
+    if (Number.isSafeInteger(pid) && pid > 0 && (runtime.isProcessAlive || defaultProcessAlive)(pid)) {
+      command = (runtime.readProcessCommand || defaultProcessCommand)(pid);
+    }
+  } catch { /* 照合できない PID は stale として扱う */ }
+  const matches = runPath && typeof command === "string" &&
+    [runPath, `"${runPath}"`].some(executable => command === executable || command.startsWith(`${executable} `));
+  if (matches) return pid;
+  fileSystem.rmSync(pidPath, { force: true });
+  return null;
+}
+
+async function startVoicevox(runtime = {}) {
+  const fetchImpl = runtime.fetchImpl || fetch;
+  const fileSystem = runtime.fsImpl || fs;
+  const env = runtime.env || process.env;
+  const pidPath = runtime.pidPath || voicevoxPidPath(env, runtime.homeDir);
+  managedVoicevoxPid(runtime); // 前回の PID が stale なら、既に別経路で起動したアプリを守るため削除する。
+  const probe = await probeVoicevox(fetchImpl);
+  if (probe.running) return { status: "ok", already_running: true, version: probe.version };
+  const runPath = resolveVoicevoxRunPath(runtime.platform || process.platform, env, candidate => fileSystem.existsSync(candidate));
+  if (!fileSystem.existsSync(runPath)) throw new PublicError("VOICEVOX エンジンが見つかりません。公式サイトから導入してください。");
+  const child = (runtime.spawnImpl || spawn)(runPath, [], { detached: true, windowsHide: true, stdio: "ignore", env });
+  child.on?.('error', () => { /* pid が無い場合は直後に失敗として扱う */ });
+  if (!Number.isSafeInteger(child.pid) || child.pid <= 0) throw new PublicError("VOICEVOX を起動できませんでした。");
+  child.unref();
+  fileSystem.mkdirSync(path.dirname(pidPath), { recursive: true });
+  fileSystem.writeFileSync(pidPath, `${child.pid}\n`, { mode: 0o600 });
+  const now = runtime.now || Date.now;
+  const pause = runtime.sleep || sleep;
+  const deadline = now() + VOICEVOX_STARTUP_TIMEOUT_MS;
+  while (now() < deadline) {
+    const state = await probeVoicevox(fetchImpl);
+    if (state.running) return { status: "ok", already_running: false, version: state.version };
+    await pause(1000);
+  }
+  try { (runtime.killProcess || process.kill)(child.pid, "SIGTERM"); } catch { /* 終了済み */ }
+  fileSystem.rmSync(pidPath, { force: true });
+  throw new PublicError("VOICEVOX エンジンの起動が 60 秒でタイムアウトしました。");
+}
+
+async function stopManagedVoicevox(runtime = {}) {
+  const fileSystem = runtime.fsImpl || fs;
+  const pidPath = runtime.pidPath || voicevoxPidPath(runtime.env || process.env, runtime.homeDir);
+  const pid = managedVoicevoxPid(runtime);
+  if (!pid) return { status: "ok", stopped: false, managed: false };
+  try { (runtime.killProcess || process.kill)(pid, "SIGTERM"); }
+  catch (error) {
+    if (error?.code !== "ESRCH") throw error;
+    fileSystem.rmSync(pidPath, { force: true });
+    return { status: "ok", stopped: false, managed: false };
+  }
+  fileSystem.rmSync(pidPath, { force: true });
+  const pause = runtime.sleep || sleep;
+  for (let attempt = 0; attempt < 20; attempt++) {
+    if (!(await probeVoicevox(runtime.fetchImpl || fetch)).running) break;
+    await pause(250);
+  }
+  return { status: "ok", stopped: true, managed: true };
+}
+
 async function resolveVoicevoxSpeakerName(speakerId) {
   const response = await fetch(`${VOICEVOX_BASE_URL}/speakers`);
   if (!response.ok) throw new PublicError(`VOICEVOX /speakers が HTTP ${response.status} を返しました`);
@@ -506,16 +612,22 @@ function maskKey(secret) {
   return secret ? "***configured***" : "***unconfigured***";
 }
 
-async function listEngines() {
+async function listEngines(runtime = {}) {
   let voicevox;
-  if (await isVoicevoxUp()) {
-    voicevox = { state: "available", label: "VOICEVOX を使用できます" };
+  const state = await probeVoicevox(runtime.fetchImpl || fetch);
+  const fileSystem = runtime.fsImpl || fs;
+  let appFound = false;
+  try { appFound = fileSystem.existsSync(resolveVoicevoxRunPath(runtime.platform || process.platform, runtime.env || process.env,
+    candidate => fileSystem.existsSync(candidate))); } catch { /* 未対応 OS */ }
+  const ownedPid = managedVoicevoxPid(runtime);
+  const detail = { running: state.running, ...(state.version ? { version: state.version } : {}), app_found: appFound,
+    managed: state.running && Boolean(ownedPid) };
+  if (state.running) {
+    voicevox = { state: "available", label: "VOICEVOX を使用できます", detail };
   } else {
-    let installed = false;
-    try { installed = fs.existsSync(resolveVoicevoxRunPath()); } catch { /* 未対応 OS */ }
-    voicevox = installed
-      ? { state: "needs", label: "VOICEVOX を起動します（自動）" }
-      : { state: "unconfigured", label: "VOICEVOX をインストール", detail: { setup_url: "https://voicevox.hiroshiba.jp/" } };
+    voicevox = appFound
+      ? { state: "needs", label: "VOICEVOX を起動します（自動）", detail }
+      : { state: "unconfigured", label: "VOICEVOX をインストール", detail: { ...detail, setup_url: "https://voicevox.hiroshiba.jp/" } };
   }
   const configured = Boolean(readCredentials().get("FAL_KEY"));
   const falAvailability = configured
@@ -744,10 +856,23 @@ export async function runNarrationCommand(args, commandOptions = {}) {
     io.log(usage);
     return { exitCode: 0 };
   }
+  if (["start", "stop"].includes(args[0])) {
+    try {
+      if (args.length !== 4 || args[1] !== "--engine" || args[2] !== "voicevox" || args[3] !== "--json") {
+        throw new PublicError("start/stop には --engine voicevox --json が必要です", 2);
+      }
+      printCompactJson(args[0] === "start" ? await startVoicevox(commandOptions.engineRuntime) : await stopManagedVoicevox(commandOptions.engineRuntime), io.log);
+      return { exitCode: 0 };
+    } catch (error) {
+      const message = error instanceof PublicError ? error.message : `VOICEVOX を操作できませんでした: ${error?.message ?? error}`;
+      io.logError(message); printCompactJson({ error: message }, io.log);
+      return { exitCode: error instanceof PublicError ? error.exitCode : 1 };
+    }
+  }
   if (["engines", "voices"].includes(args[0])) {
     try {
       const engine = parseListArguments(args);
-      printCompactJson(args[0] === "engines" ? await listEngines() : { version: 1, engine, voices: await listVoices(engine) }, io.log);
+      printCompactJson(args[0] === "engines" ? await listEngines(commandOptions.engineRuntime) : { version: 1, engine, voices: await listVoices(engine) }, io.log);
       return { exitCode: 0 };
     } catch (error) {
       const message = error instanceof PublicError ? error.message : "声一覧を取得できませんでした";

package/vendor/docs/contract-2026-08-02-preview-parity.md

@@ -64,8 +64,8 @@ cut 境界の選択は宣言順ではなく解決済みタイムラインと z-o
 > 等比親との合成は子の各有効値に親の `scale` を掛け、逆変換は同じ値で割る。
 > 書き込み時に両軸の有効値が等しければ `scale` に畳む。既存の `scale` だけの宣言は変更しない。
 > keyframes は端点を各軸の有効値へ解決してから補間する（`scale` と `scaleX` の混在も可）。
-> overlay の CSS は `translate(...) scale(sx, sy) rotate(...)`、素材は crop の幅・高さへ
-> 各軸を掛けて回転する。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
+> overlay の CSS は `translate(...) rotate(...) scale(sx, sy)`。overlay も素材も
+> 各軸で伸ばしてから回転する（R·S）。素材は crop の幅・高さへ各軸を掛ける。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
 
 - `framing.crop` は fit 済みフレームを窓抜きして出力寸法へ再拡大する。
 - `framing.keyframes`、transform keyframes は cut 内の出力秒で評価し、hold / linear / ease-in-out の

package/vendor/docs/contract-2026-08-09-transform-keyframes-v0.md

@@ -23,8 +23,8 @@ updated: 2026-08-30
 > 等比親との合成は子の各有効値に親の `scale` を掛け、逆変換は同じ値で割る。
 > 書き込み時に両軸の有効値が等しければ `scale` に畳む。既存の `scale` だけの宣言は変更しない。
 > keyframes は端点を各軸の有効値へ解決してから補間する（`scale` と `scaleX` の混在も可）。
-> overlay の CSS は `translate(...) scale(sx, sy) rotate(...)`、素材は crop の幅・高さへ
-> 各軸を掛けて回転する。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
+> overlay の CSS は `translate(...) rotate(...) scale(sx, sy)`。overlay も素材も
+> 各軸で伸ばしてから回転する（R·S）。素材は crop の幅・高さへ各軸を掛ける。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
 
 - `keyframes[]` はレイヤー / アイテムの `transform` / `crop` / `perspective` を時間で動かす共通機構
 - `t` は**ローカル時間**: v1 `layers[].keyframes[].t` はレイヤー内秒（`layerItem.t` を 0 とする。`cuts[].framing.keyframes[].t` と同じ規約）、

package/vendor/docs/contract-2026-08-30-motion-and-keyframes-v0.md

@@ -69,8 +69,8 @@ updated: 2026-09-06
 > 等比親との合成は子の各有効値に親の `scale` を掛け、逆変換は同じ値で割る。
 > 書き込み時に両軸の有効値が等しければ `scale` に畳む。既存の `scale` だけの宣言は変更しない。
 > keyframes は端点を各軸の有効値へ解決してから補間する（`scale` と `scaleX` の混在も可）。
-> overlay の CSS は `translate(...) scale(sx, sy) rotate(...)`、素材は crop の幅・高さへ
-> 各軸を掛けて回転する。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
+> overlay の CSS は `translate(...) rotate(...) scale(sx, sy)`。overlay も素材も
+> 各軸で伸ばしてから回転する（R·S）。素材は crop の幅・高さへ各軸を掛ける。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
 
 既存 `keyframeV2`（点ごとに任意プロパティ・`t` はアイテム相対の整数フレーム）を**唯一の形**として保ち、次を足す:
 

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

@@ -235,6 +235,8 @@ Kling v3 standard i2v / Kling v3 pro i2v / Veo 3.1 first-last / Veo 3.1 referenc
 
 ## 9. 用語（混同を防ぐ）
 
+右パネルのタブ表示名は「AI」（id は `generation`）。入口は行為のタイル一覧で、選ぶと既存の生成フォームを専用パネルに表示する。
+
 | 語 | 意味 |
 |---|---|
 | 仮枠 | 尺と場所を持つ静止画クリップ。完成品でもある |

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.79",
+  "version": "0.1.80",
   "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/asset-resolver/bin/akari-assets.mjs

@@ -18,6 +18,7 @@ import { cacheCatalog, loadCatalog } from '../src/catalog.mjs';
 import { resolve as resolveAsset } from '../src/resolve.mjs';
 import { DEFAULT_CATALOG_URL, DEFAULT_STORE_API } from '../src/service-urls.mjs';
 import { composeState } from '../src/state.mjs';
+import { checkLibrary, projectCredits } from '../src/library-check.mjs';
 
 function flagValue(args, name) {
   const i = args.indexOf(name);
@@ -34,6 +35,8 @@ function validateArgs(sub, args) {
     migrate: { values: [], flags: ['--dry-run'], max: 0 },
     sync: { values: [], flags: [], max: 0 },
     browse: { values: ['--port'], flags: [], max: 0 },
+    check: { values: ['--project'], flags: ['--json'], max: 0 },
+    credits: { values: ['--project'], flags: [], max: 0 },
   };
   const spec = specs[sub];
   if (!spec) throw new Error(`不明なコマンド: ${sub}`);
@@ -53,6 +56,7 @@ function validateArgs(sub, args) {
     throw new Error('add は <path...> --plan または --apply <plan.json> を指定してください');
   }
   if (sub === 'bundle' && !seen.has('--project')) throw new Error('--project <dir> が必要です');
+  if (sub === 'credits' && !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> が必要です');
@@ -177,8 +181,22 @@ async function cmdBrowse(args, env) {
   // サーバプロセスを起動したまま維持する（declare-server.mjs 等と同じ流儀）
 }
 
+async function cmdCheck(args, env) {
+  const result = await checkLibrary({ env, project: flagValue(args, '--project') });
+  if (args.includes('--json')) console.log(JSON.stringify(result, null, 2));
+  else {
+    console.log(`問題なし ${result.ok} 件 / 注意 ${result.warnings.length} 件 / エラー ${result.errors.length} 件`);
+    for (const row of result.findings) console.log(`${row.level === 'error' ? 'エラー' : '注意'}: ${row.category}/${row.id}: ${row.message} (${row.dir})`);
+  }
+  if (result.errors.length) process.exitCode = 1;
+}
+
+async function cmdCredits(args, env) {
+  console.log((await projectCredits(flagValue(args, '--project'), env)).join('\n'));
+}
+
 function printUsage() {
-  console.log(`使い方: akari-assets <list|add|fetch|bundle|migrate|sync|browse> [options]
+  console.log(`使い方: akari-assets <list|add|fetch|bundle|migrate|sync|browse|check|credits> [options]
 
   list [--category <c>] [--source <lab|site|own>] [--json]
                                           出どころ・取得状態つき素材一覧
@@ -190,6 +208,8 @@ function printUsage() {
   migrate [--dry-run]                     ライブラリを作業場へ移行
   sync                                    カタログを取得してローカルにキャッシュ（オフライン用）
   browse [--port <n>]                     ローカル HTTP サーバでカタログを閲覧・投入（既定 8910）
+  check [--project <dir>] [--json]         ライブラリを読み取り専用で点検
+  credits --project <dir>                 プロジェクトのクレジット文面を一覧
 
 環境変数:
   AKARI_HOME             マシン設定の置き場（既定: ~/.akari）
@@ -227,6 +247,8 @@ async function main() {
   if (sub === 'bundle') return cmdBundle(rest, env);
   if (sub === 'sync') return cmdSync(rest, env);
   if (sub === 'browse') return cmdBrowse(rest, env);
+  if (sub === 'check') return cmdCheck(rest, env);
+  if (sub === 'credits') return cmdCredits(rest, env);
 
   printUsage();
   process.exitCode = sub && sub !== '--help' && sub !== '-h' ? 1 : 0;

package/vendor/packages/asset-resolver/src/library-check.mjs

@@ -0,0 +1,151 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { lstat, open, readFile, readdir, realpath, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveAssetLibraryRoots } from '../../creator-root/src/index.mjs';
+import { resolveFfprobe } from '../../media-bin/src/index.mjs';
+import { ASSET_CATEGORIES, primaryMediaFile } from './library.mjs';
+import { readProjectReferences } from './project-references.mjs';
+
+const validator = fileURLToPath(new URL('../../schemas/bin/validate-asset.mjs', import.meta.url));
+const conversion = /\.(aif|aiff|flac|ogg|webm|mkv|avi|gif|svg|woff|woff2|gltf)$/i;
+const issue = (level, category, id, dir, code, message) => ({ level, category, id, dir, code, message });
+
+async function directories(env) {
+  const seen = new Set();
+  const rows = [];
+  for (const root of resolveAssetLibraryRoots(env).read) {
+    for (const category of ASSET_CATEGORIES) {
+      let names = [];
+      try { names = await readdir(path.join(root, category)); } catch { continue; }
+      for (const id of names.sort()) {
+        if (id.startsWith('.') || id === '..' || seen.has(`${category}/${id}`)) continue;
+        const dir = path.join(root, category, id);
+        try { if (!(await lstat(dir)).isDirectory()) continue; } catch { continue; }
+        seen.add(`${category}/${id}`);
+        rows.push({ category, id, dir });
+      }
+    }
+  }
+  return rows;
+}
+
+function signatureOk(file, bytes) {
+  const ext = path.extname(file).toLowerCase();
+  if (ext === '.glb') return bytes.subarray(0, 4).toString() === 'glTF';
+  if (ext === '.gltf') return bytes.toString('utf8').trimStart().startsWith('{');
+  if (ext === '.ttf') return bytes.subarray(0, 4).toString('hex') === '00010000';
+  if (ext === '.otf') return bytes.subarray(0, 4).toString() === 'OTTO';
+  if (ext === '.woff') return bytes.subarray(0, 4).toString() === 'wOFF';
+  if (ext === '.woff2') return bytes.subarray(0, 4).toString() === 'wOF2';
+  return true;
+}
+
+export async function checkLibrary({ env = process.env, project } = {}) {
+  if (project && !(await stat(project)).isDirectory()) throw new Error('プロジェクトがフォルダではありません');
+  const findings = [];
+  const rows = await directories(env);
+  for (const { category, id, dir } of rows) {
+    const validated = spawnSync(process.execPath, [validator, dir], { encoding: 'utf8', timeout: 30000 });
+    if (validated.status !== 0 || validated.error) findings.push(issue('error', category, id, dir, 'meta',
+      `meta.json / 素材契約: ${(validated.stderr || validated.stdout || validated.error?.message || '検証失敗').trim()}`));
+    let meta;
+    try { meta = JSON.parse(await readFile(path.join(dir, 'meta.json'), 'utf8')); } catch { /* validator reports this */ }
+    let files;
+    try { files = (await readdir(dir)).map(name => ({ name })); }
+    catch (error) {
+      findings.push(issue('error', category, id, dir, 'unreadable-directory', `素材ディレクトリを読めません: ${error.message}`));
+      continue;
+    }
+    const media = primaryMediaFile(category, files);
+    if (['audio', 'broll', 'font'].includes(category) && !media) {
+      findings.push(issue('error', category, id, dir, 'media-missing', '主メディアが見つかりません'));
+    } else if (media) {
+      const file = path.join(dir, media);
+      try {
+        const handle = await open(file, 'r');
+        let bytes;
+        try {
+          bytes = Buffer.alloc(512);
+          const read = await handle.read(bytes, 0, bytes.length, 0);
+          if (!read.bytesRead) throw new Error('内容を読めません');
+        } finally { await handle.close(); }
+        if (!signatureOk(file, bytes)) throw new Error('署名または内容を読めません');
+        if (/\.gltf$/i.test(media)) JSON.parse(await readFile(file, 'utf8'));
+        if (/\.svg$/i.test(media) && !(await readFile(file, 'utf8')).includes('<svg')) throw new Error('SVG を読めません');
+        if (category === 'audio' || category === 'broll' || (category === 'still' && !/\.svg$/i.test(media))) {
+          const probe = resolveFfprobe({ env });
+          const tested = spawnSync(probe, ['-v', 'error', '-show_entries', 'stream=codec_name:format=duration', '-of', 'json', file], { encoding: 'utf8', timeout: 30000 });
+          const data = JSON.parse(tested.stdout);
+          if (tested.status !== 0 || !data.streams?.length
+            || ((category === 'audio' || category === 'broll') && !Number.isFinite(Number(data.format?.duration)))) throw new Error('ffprobe で読めません');
+        }
+      } catch (error) { findings.push(issue('error', category, id, dir, 'media-unreadable', `主メディアを読めません: ${error.message}`)); }
+      if (conversion.test(media)) findings.push(issue('warning', category, id, dir, 'conversion', '書き出し時に形式の変換が必要です'));
+    }
+    if (files.some(file => /\.cube$/i.test(file.name))) {
+      for (const file of files.filter(entry => /\.cube$/i.test(entry.name))) {
+        try {
+          const lines = (await readFile(path.join(dir, file.name), 'utf8')).split(/\r?\n/).map(line => line.trim()).filter(line => line && !line.startsWith('#'));
+          const size = Number(lines.find(line => line.startsWith('LUT_3D_SIZE '))?.split(/\s+/)[1]);
+          const triples = lines.filter(line => /^[+\-\d.]/.test(line));
+          if (!Number.isInteger(size) || size < 2 || triples.length !== size ** 3
+            || triples.some(line => line.split(/\s+/).length !== 3 || line.split(/\s+/).some(value => !Number.isFinite(Number(value))))) {
+            findings.push(issue('error', category, id, dir, 'cube', 'cube の行の形が不正です'));
+          }
+        } catch (error) { findings.push(issue('error', category, id, dir, 'cube', `cube を読めません: ${error.message}`)); }
+      }
+    }
+    if (meta?.license?.attribution_required && !files.some(file => file.name === 'CREDIT.txt')) {
+      findings.push(issue('warning', category, id, dir, 'credit-missing', 'クレジット必須ですが CREDIT.txt がありません'));
+    }
+    if (meta?.tags?.includes('license:subscription')) {
+      findings.push(issue('warning', category, id, dir, 'subscription', 'サブスク素材です。契約が続いているか確認してください'));
+    }
+  }
+  if (project) {
+    const known = new Set(rows.map(row => `${row.category}/${row.id}`));
+    for (const ref of await readProjectReferences(project)) {
+      if (!known.has(`${ref.category}/${ref.id}`)) findings.push(issue('error', ref.category, ref.id, project, 'reference-missing', '参照の台帳にありますが置き場に素材がありません'));
+    }
+  }
+  const affected = new Set(findings.filter(row => row.level === 'error').map(row => `${row.category}/${row.id}`));
+  const warned = new Set(findings.filter(row => row.level === 'warning').map(row => `${row.category}/${row.id}`));
+  return { ok: rows.filter(row => !affected.has(`${row.category}/${row.id}`) && !warned.has(`${row.category}/${row.id}`)).length,
+    warnings: findings.filter(row => row.level === 'warning'), errors: findings.filter(row => row.level === 'error'), findings };
+}
+
+export async function projectCredits(project, env = process.env) {
+  if (!(await stat(project)).isDirectory()) throw new Error('プロジェクトがフォルダではありません');
+  const references = await readProjectReferences(project);
+  const candidates = [...references];
+  for (const category of ASSET_CATEGORIES) {
+    let ids = [];
+    try { ids = await readdir(path.join(project, 'assets', category)); } catch { continue; }
+    for (const id of ids) candidates.push({ category, id });
+  }
+  const seenAssets = new Set();
+  const seenTexts = new Set();
+  const credits = [];
+  for (const { category, id } of candidates) {
+    const key = `${category}/${id}`;
+    if (seenAssets.has(key) || !ASSET_CATEGORIES.includes(category) || !id || /[\\/]/.test(id) || id === '..') continue;
+    seenAssets.add(key);
+    const roots = [path.join(project, 'assets'), ...resolveAssetLibraryRoots(env).read];
+    for (const root of roots) {
+      const dir = path.join(root, category, id);
+      if (!existsSync(dir)) continue;
+      try {
+        const actualRoot = await realpath(root), actual = await realpath(dir);
+        if (!actual.startsWith(`${actualRoot}${path.sep}`) || !(await lstat(dir)).isDirectory()) continue;
+        const meta = JSON.parse(await readFile(path.join(dir, 'meta.json'), 'utf8'));
+        if (!meta?.license?.attribution_required) break;
+        const credit = (await readFile(path.join(dir, 'CREDIT.txt'), 'utf8')).split(/\r?\n/)[0].trim();
+        if (credit && !seenTexts.has(credit)) { credits.push(credit); seenTexts.add(credit); }
+        break;
+      } catch { /* try another library root */ }
+    }
+  }
+  return credits;
+}

package/vendor/packages/asset-resolver/src/library-usage.mjs

@@ -0,0 +1,56 @@
+import { appendFile, mkdir, readFile, realpath, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveAkariHome } from './env.mjs';
+
+export function usagePath(env = process.env) {
+  return path.join(resolveAkariHome(env), 'library-usage.jsonl');
+}
+
+export async function appendLibraryUsage({ category, id, project }, env = process.env) {
+  if (![category, id].every(value => typeof value === 'string' && value && !/[\\/]/.test(value))) {
+    throw new TypeError('素材の種類・名前が不正です');
+  }
+  const entry = { at: new Date().toISOString(), category, id, project: await realpath(project) };
+  const target = usagePath(env);
+  await mkdir(path.dirname(target), { recursive: true });
+  await appendFile(target, `${JSON.stringify(entry)}\n`, 'utf8');
+  return entry;
+}
+
+export function aggregateLibraryUsage(lines, isProject = () => true) {
+  const result = {};
+  for (const line of typeof lines === 'string' ? lines.split(/\r?\n/) : lines) {
+    let row;
+    try { row = typeof line === 'string' ? JSON.parse(line) : line; } catch { continue; }
+    if (!row || typeof row !== 'object' || typeof row.category !== 'string' || !row.category
+      || /[\\/]/.test(row.category) || typeof row.id !== 'string' || !row.id || /[\\/]/.test(row.id)
+      || typeof row.project !== 'string'
+      || !path.isAbsolute(row.project) || typeof row.at !== 'string' || !Number.isFinite(Date.parse(row.at))
+      || !isProject(row.project)) continue;
+    const key = `${row.category}/${row.id}`;
+    const value = result[key] ??= { count: 0, lastUsedAt: '', projects: [] };
+    value.count++;
+    if (row.at > value.lastUsedAt) value.lastUsedAt = row.at;
+    if (!value.projects.includes(row.project)) value.projects.push(row.project);
+  }
+  for (const value of Object.values(result)) value.projects.sort();
+  return result;
+}
+
+export async function readLibraryUsage(env = process.env) {
+  let lines = '';
+  try { lines = await readFile(usagePath(env), 'utf8'); }
+  catch (error) { if (error.code !== 'ENOENT') throw error; }
+  const projects = new Set();
+  for (const line of lines.split(/\r?\n/)) {
+    try {
+      const project = JSON.parse(line)?.project;
+      if (typeof project === 'string' && path.isAbsolute(project)) projects.add(project);
+    } catch { /* invalid journal line */ }
+  }
+  const existing = new Set();
+  await Promise.all([...projects].map(async project => {
+    try { if ((await stat(project)).isDirectory()) existing.add(project); } catch { /* removed project */ }
+  }));
+  return aggregateLibraryUsage(lines, project => existing.has(project));
+}

package/vendor/packages/asset-resolver/test/cli-guards.test.mjs

@@ -42,19 +42,21 @@ const invalid = [
   ['add', '--apply', 'plan.json', '--typo'], ['add', '--apply', 'plan.json', 'extra'],
   ['add', '--apply'], ['add', '--apply', '--json'], ['add', '--apply', 'plan.json', '--plan'],
   ['add', 'file', '--plan', '-x'], ['list', 'extra'], ['sync', '--typo'], ['browse', 'extra'],
+  ['check', '--jsoon'], ['check', '--json', 'extra'], ['check', '--project'], ['check', '--json', '--json'],
+  ['credits'], ['credits', '--project'], ['credits', '--project', 'x', 'extra'], ['credits', '--jsoon'],
 ];
 for (const viaLauncher of [false, true]) {
   test(`${viaLauncher ? 'akari assets' : 'akari-assets'}: help and invalid arguments preserve every file and sha256`, async t => {
     const f = await fixture(t);
     const before = await manifest(f.temp);
     const cases = [
-      ...['list', 'add', 'fetch', 'bundle', 'migrate', 'sync', 'browse'].flatMap(sub =>
+      ...['list', 'add', 'fetch', 'bundle', 'migrate', 'sync', 'browse', 'check', 'credits'].flatMap(sub =>
         ['--help', '-h'].map(flag => [[sub, flag], 0])),
       ...invalid.map(args => [args, 2]),
     ];
     for (const [args, status] of cases) {
       const result = spawnSync(process.execPath, viaLauncher ? [launcher, 'assets', ...args] : [cli, ...args],
-        { env: f.env, encoding: 'utf8', timeout: 10000 });
+        { env: f.env, encoding: 'utf8', timeout: 30000 });
       assert.equal(result.status, status, `${args.join(' ')}: ${result.stderr}`);
       assert.match(result.stdout, /使い方: akari-assets/);
       assert.deepEqual(await manifest(f.temp), before, args.join(' '));
@@ -68,7 +70,7 @@ for (const viaLauncher of [false, true]) {
     const before = await manifest(f.temp);
     for (let run = 0; run < 2; run++) {
       const result = spawnSync(process.execPath, viaLauncher ? [launcher, 'assets', 'migrate'] : [cli, 'migrate'],
-        { env: f.env, encoding: 'utf8', timeout: 10000 });
+        { env: f.env, encoding: 'utf8', timeout: 30000 });
       assert.equal(result.status, 0, result.stderr);
       const data = JSON.parse(result.stdout);
       assert.match(data.skippedReason, /same location/);