akari-video 0.1.77 → 0.1.79

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.77",
+  "version": "0.1.79",
   "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

@@ -12,20 +12,36 @@ const VOICEVOX_RUN_ENV = "VOICEVOX_RUN";
 const VOICEVOX_STARTUP_TIMEOUT_MS = 60_000;
 const FAL_TTS_URL = "https://fal.run/fal-ai/qwen-3-tts/text-to-speech/1.7b";
 const FAL_USD_PER_1000_CHARS = 0.09;
+const GEMINI_TTS_URL = "https://fal.run/fal-ai/gemini-tts";
+const GEMINI_USD_PER_1000_CHARS = 0.05;
+const GEMINI_VOICES = Object.entries({
+  Leda: "Youthful", Achernar: "Soft", Achird: "Friendly", Algenib: "Gravelly",
+  Algieba: "Smooth", Alnilam: "Firm", Aoede: "Breezy", Autonoe: "Bright",
+  Callirrhoe: "Easy-going", Charon: "Informative", Despina: "Smooth",
+  Enceladus: "Breathy", Erinome: "Clear", Fenrir: "Excitable", Gacrux: "Mature",
+  Iapetus: "Clear", Kore: "Firm", Laomedeia: "Upbeat", Orus: "Firm",
+  Pulcherrima: "Forward", Puck: "Upbeat", Rasalgethi: "Informative",
+  Sadachbia: "Lively", Sadaltager: "Knowledgeable", Schedar: "Even",
+  Sulafat: "Warm", Umbriel: "Easy-going", Vindemiatrix: "Gentle",
+  Zephyr: "Bright", Zubenelgenubi: "Casual",
+}).map(([id, description]) => ({ id, label: `${id}（${description}）`, ...(id === "Leda" ? { default: true } : {}) }));
 
 const usage = [
   "使い方:",
   "  akari narration generate \\",
-  "    --project <projectDir> --engine <voicevox|fal-qwen3> \\",
-  "    --reading-file <読み原稿.txt> [--script-file <表示原稿.txt>] \\",
-  "    --t <タイムライン秒> [--gain-db 0] [--id n-0001] \\",
-  "    [--speaker 3] [--profile owner-ja] [--dry-run] [--yes] [--apply]",
+  "    --project <projectDir> --engine <voicevox|gemini-tts|fal-qwen3> \\",
+  "    (--reading-file <読み原稿.txt> | --text <原稿>) [--script-file <表示原稿.txt>] \\",
+  "    [--t <タイムライン秒>] [--gain-db 0] [--id n-0001] \\",
+  "    [--speaker 3] [--voice Leda] [--style <text>] [--speed 1] \\",
+  "    [--profile owner-ja] [--caption-ref c-0001] [--dry-run] [--yes] [--apply] [--json]",
 ].join("\n");
 const commandUsage = [
   "使い方: akari narration <subcommand> [options]",
   "",
   "サブコマンド:",
   "  generate  原稿からナレーション音声を生成する",
+  "  engines   エンジン一覧を表示する",
+  "  voices    声一覧を表示する",
   "",
   usage,
 ].join("\n");
@@ -40,6 +56,7 @@ class PublicError extends Error {
 function printJson(value, log = (line) => console.log(line)) {
   log(JSON.stringify(value, null, 2));
 }
+function printCompactJson(value, log) { log(JSON.stringify(value)); }
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -56,8 +73,9 @@ function isFiniteNumber(value) {
 const VALUE_OPTIONS = new Set([
   "--project", "--engine", "--reading-file", "--script-file",
   "--t", "--gain-db", "--id", "--speaker", "--profile",
+  "--voice", "--style", "--speed", "--text", "--caption-ref",
 ]);
-const FLAG_OPTIONS = new Set(["--dry-run", "--yes", "--apply"]);
+const FLAG_OPTIONS = new Set(["--dry-run", "--yes", "--apply", "--json"]);
 
 function parseArguments(argv) {
   if (argv[0] !== "generate") {
@@ -73,6 +91,7 @@ function parseArguments(argv) {
     id: null,
     speaker: "3",
     profile: null,
+    voice: "Leda", style: null, speed: null, text: null, captionRef: null, json: false,
     dryRun: false,
     yes: false,
     apply: false,
@@ -95,6 +114,11 @@ function parseArguments(argv) {
         case "--id": options.id = value; break;
         case "--speaker": options.speaker = value; break;
         case "--profile": options.profile = value; break;
+        case "--voice": options.voice = value; break;
+        case "--style": options.style = value; break;
+        case "--speed": options.speed = Number(value); break;
+        case "--text": options.text = value; break;
+        case "--caption-ref": options.captionRef = value; break;
         default: break;
       }
     } else if (argument === "--dry-run") {
@@ -103,16 +127,28 @@ function parseArguments(argv) {
       options.yes = true;
     } else if (argument === "--apply") {
       options.apply = true;
+    } else if (argument === "--json") {
+      options.json = true;
     } else {
       throw new PublicError(`不明な引数です: ${argument}\n${usage}`, 2);
     }
   }
 
   if (!options.project) throw new PublicError("--project が必要です");
-  if (options.engine !== "voicevox" && options.engine !== "fal-qwen3") {
-    throw new PublicError("--engine には voicevox または fal-qwen3 を指定してください");
+  if (!["voicevox", "gemini-tts", "fal-qwen3"].includes(options.engine)) {
+    throw new PublicError("--engine には voicevox、gemini-tts または fal-qwen3 を指定してください", 2);
   }
-  if (!options.readingFile) throw new PublicError("--reading-file が必要です");
+  if (!options.readingFile && !options.text) throw new PublicError("--reading-file または --text が必要です");
+  if (options.engine === "gemini-tts" && !GEMINI_VOICES.some(({ id }) => id === options.voice)) {
+    throw new PublicError(`--voice に使える声: ${GEMINI_VOICES.map(({ id }) => id).join(", ")}`, 2);
+  }
+  if (options.speed !== null && (!isFiniteNumber(options.speed) || options.speed < 0.5 || options.speed > 2)) {
+    throw new PublicError("--speed は 0.5 から 2.0 の範囲で指定してください", 2);
+  }
+  if (options.captionRef !== null && !/^c-\d{4}$/.test(options.captionRef)) {
+    throw new PublicError("--caption-ref は c- に続く 4 桁の数字で指定してください", 2);
+  }
+  if (options.t === null && !options.apply) options.t = 0;
   if (!isFiniteNumber(options.t) || options.t < 0) {
     throw new PublicError("--t には 0 以上の有限数を指定してください");
   }
@@ -154,6 +190,9 @@ function computeNextId(projectDir) {
         .map((item) => item?.id)
         .filter((id) => typeof id === "string" && /^n-\d{4}$/.test(id));
     }
+    for (const track of edit?.tracks ?? []) for (const item of track?.items ?? []) {
+      if (typeof item?.id === "string" && /^n-\d{4}$/.test(item.id)) ids.push(item.id);
+    }
   } catch {
     // edit.json が無い、または narration 配列が無い場合は n-0001 から開始する。
   }
@@ -258,6 +297,33 @@ function buildFalPayload(readingText, meta) {
 function estimateFalCostUsd(readingText) {
   return Number(((readingText.length / 1000) * FAL_USD_PER_1000_CHARS).toFixed(6));
 }
+function estimateGeminiTtsCostUsd(chars) {
+  return Number(((chars / 1000) * GEMINI_USD_PER_1000_CHARS).toFixed(6));
+}
+
+async function synthesizeGeminiTts(readingText, { voice, model, style, falKey }) {
+  const payload = {
+    prompt: readingText, voice, model,
+    output_format: "mp3", language_code: "Japanese (Japan)",
+    ...(style ? { style_instructions: style } : {}),
+  };
+  let response;
+  try {
+    response = await fetch(GEMINI_TTS_URL, {
+      method: "POST",
+      headers: { Authorization: `Key ${falKey}`, "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+    });
+  } catch {
+    throw new PublicError("fal API へのネットワーク接続に失敗しました");
+  }
+  if (!response.ok) throw new PublicError(`fal API が HTTP ${response.status} を返しました`);
+  const audioUrl = (await response.json())?.audio?.url;
+  if (typeof audioUrl !== "string" || !audioUrl) throw new PublicError("fal API の応答に audio.url がありません");
+  const audioResponse = await fetch(audioUrl);
+  if (!audioResponse.ok) throw new PublicError(`生成音声の取得に失敗しました（HTTP ${audioResponse.status}）`);
+  return Buffer.from(await audioResponse.arrayBuffer());
+}
 
 async function synthesizeFal(readingText, meta, falKey) {
   const payload = buildFalPayload(readingText, meta);
@@ -368,18 +434,20 @@ async function resolveVoicevoxSpeakerName(speakerId) {
   const speakers = await response.json();
   for (const speaker of Array.isArray(speakers) ? speakers : []) {
     const styles = Array.isArray(speaker?.styles) ? speaker.styles : [];
-    if (styles.some((style) => style.id === speakerId)) return String(speaker.name);
+    const style = styles.find((candidate) => candidate.id === speakerId);
+    if (style) return `${speaker.name} ${style.name}`;
   }
   return "unknown";
 }
 
-async function synthesizeVoicevox(readingText, speakerId) {
+async function synthesizeVoicevox(readingText, speakerId, speed) {
   const queryUrl = `${VOICEVOX_BASE_URL}/audio_query?speaker=${speakerId}&text=${encodeURIComponent(readingText)}`;
   const queryResponse = await fetch(queryUrl, { method: "POST" });
   if (!queryResponse.ok) {
     throw new PublicError(`VOICEVOX /audio_query が HTTP ${queryResponse.status} を返しました`);
   }
   const query = await queryResponse.json();
+  if (speed !== null) query.speedScale = speed;
 
   const synthesisUrl = `${VOICEVOX_BASE_URL}/synthesis?speaker=${speakerId}`;
   const synthesisResponse = await fetch(synthesisUrl, {
@@ -438,10 +506,70 @@ function maskKey(secret) {
   return secret ? "***configured***" : "***unconfigured***";
 }
 
+async function listEngines() {
+  let voicevox;
+  if (await isVoicevoxUp()) {
+    voicevox = { state: "available", label: "VOICEVOX を使用できます" };
+  } 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/" } };
+  }
+  const configured = Boolean(readCredentials().get("FAL_KEY"));
+  const falAvailability = configured
+    ? { state: "available", label: "fal を使用できます" }
+    : { state: "unconfigured", label: "fal の鍵を登録" };
+  const profilesDir = path.join(os.homedir(), ".config", "akari-video", "voice-profiles");
+  const hasProfiles = fs.existsSync(profilesDir) && fs.readdirSync(profilesDir, { withFileTypes: true }).some((entry) => entry.isDirectory());
+  return { version: 1, engines: [
+    { id: "voicevox", label: "VOICEVOX", place: "local", price: { usd_per_1000_chars: 0, verified: true }, availability: voicevox, credit_required: true, supports: { speed: true, style: false } },
+    { id: "gemini-tts", label: "Gemini 2.5 Flash TTS", place: "cloud", provider: "fal", price: { usd_per_1000_chars: GEMINI_USD_PER_1000_CHARS, verified: false, as_of: "2026-09-22" }, availability: falAvailability, default_voice: "Leda", credit_required: false, supports: { speed: false, style: true } },
+    { id: "irodori", label: "彩（Irodori-TTS）", place: "local", availability: { state: "unsupported", label: "近日" } },
+    { id: "fal-qwen3", label: "fal Qwen3-TTS", place: "cloud", provider: "fal", price: { usd_per_1000_chars: FAL_USD_PER_1000_CHARS, verified: false }, availability: !configured ? falAvailability : hasProfiles ? { state: "available", label: "声プロファイルを使用できます" } : { state: "needs", label: "声プロファイルを作成" }, credit_required: false, supports: { speed: false, style: false } },
+  ] };
+}
+
+async function listVoices(engine) {
+  if (engine === "gemini-tts") return GEMINI_VOICES;
+  if (engine === "voicevox") {
+    const handle = await ensureVoicevoxEngine();
+    try {
+      const response = await fetch(`${VOICEVOX_BASE_URL}/speakers`);
+      if (!response.ok) throw new PublicError(`VOICEVOX /speakers が HTTP ${response.status} を返しました`, 3);
+      const speakers = await response.json();
+      return speakers.flatMap((speaker) => (speaker.styles ?? []).map((style) => ({
+        id: String(style.id), label: `${speaker.name} ${style.name}`, group: speaker.name,
+      })));
+    } finally {
+      if (handle.startedByUs) await stopVoicevoxEngine(handle.child);
+    }
+  }
+  if (engine === "fal-qwen3") {
+    const profilesDir = path.join(os.homedir(), ".config", "akari-video", "voice-profiles");
+    return fs.existsSync(profilesDir) ? fs.readdirSync(profilesDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory()).map((entry) => ({ id: entry.name, label: entry.name })) : [];
+  }
+  throw new PublicError(`声一覧に対応していないエンジンです: ${engine}`, 2);
+}
+
+function parseListArguments(args) {
+  let engine = null;
+  for (let index = 1; index < args.length; index += 1) {
+    if (args[index] === "--json") continue;
+    if (args[index] === "--engine" && args[index + 1]) { engine = args[++index]; continue; }
+    throw new PublicError(`不明な引数です: ${args[index]}`, 2);
+  }
+  if (args[0] === "voices" && !engine) throw new PublicError("voices には --engine が必要です", 2);
+  return engine;
+}
+
 async function runDryRun(options, readingText, io) {
   const outputPath = relativeOutputPath(options.id ?? computeNextId(options.project), options.engine);
+  const emit = options.json ? printCompactJson : printJson;
   if (options.engine === "voicevox") {
-    printJson({
+    emit({
       dry_run: true,
       engine: "voicevox",
       output_path: outputPath,
@@ -459,11 +587,20 @@ async function runDryRun(options, readingText, io) {
     return;
   }
 
+  if (options.engine === "gemini-tts") {
+    emit({
+      dry_run: true, engine: options.engine, output_path: outputPath,
+      estimated_cost_usd: estimateGeminiTtsCostUsd(readingText.length),
+      request: { endpoint: GEMINI_TTS_URL, headers: { Authorization: `Key ${maskKey(readCredentials().get("FAL_KEY"))}` },
+        body: { prompt: readingText, voice: options.voice, model: "gemini-2.5-flash-tts", output_format: "mp3", language_code: "Japanese (Japan)", ...(options.style ? { style_instructions: options.style } : {}) } },
+    }, io.log);
+    return;
+  }
   const falKey = resolveFalKey();
   const meta = readProfileMeta(options.profile);
   const payload = buildFalPayload(readingText, meta);
   const estimatedCostUsd = estimateFalCostUsd(readingText);
-  printJson({
+  emit({
     dry_run: true,
     engine: "fal-qwen3",
     output_path: outputPath,
@@ -476,11 +613,30 @@ async function runDryRun(options, readingText, io) {
   }, io.log);
 }
 
+function durationForAudio(buffer, outputPath, engine, warnings) {
+  if (engine === "voicevox") {
+    if (buffer.length >= 44 && buffer.toString("ascii", 0, 4) === "RIFF") {
+      const bytesPerSecond = buffer.readUInt32LE(28);
+      const dataOffset = buffer.indexOf("data", 36, "ascii");
+      if (bytesPerSecond > 0 && dataOffset >= 0 && dataOffset + 8 <= buffer.length) {
+        return Number((buffer.readUInt32LE(dataOffset + 4) / bytesPerSecond).toFixed(3));
+      }
+    }
+  } else {
+    const result = spawnSync("ffprobe", ["-v", "error", "-show_entries", "format=duration", "-of", "default=noprint_wrappers=1:nokey=1", outputPath], { encoding: "utf8" });
+    const seconds = Number(result.stdout?.trim());
+    if (result.status === 0 && Number.isFinite(seconds) && seconds >= 0) return Number(seconds.toFixed(3));
+  }
+  warnings.push("音声の実尺を取得できませんでした");
+  return null;
+}
+
 // --- generate 本体 ---
 
 async function runGenerate(options, io) {
-  const readingText = readTextFile(options.readingFile, "読み原稿");
-  const scriptText = options.scriptFile ? readTextFile(options.scriptFile, "表示原稿") : null;
+  const readingText = options.readingFile ? readTextFile(options.readingFile, "読み原稿") : options.text.trim();
+  const scriptText = options.scriptFile ? readTextFile(options.scriptFile, "表示原稿") : options.text;
+  if (!readingText) throw new PublicError("読み原稿が空です", 2);
 
   if (options.dryRun) {
     await runDryRun(options, readingText, io);
@@ -493,6 +649,13 @@ async function runGenerate(options, io) {
 
   let audioBuffer;
   let provenance;
+  let costUsd = 0;
+  const warnings = [];
+  if (options.speed !== null && options.engine !== "voicevox") {
+    const warning = `${options.engine} は --speed に対応していないため無視しました`;
+    warnings.push(warning);
+    io.logError(warning);
+  }
 
   if (options.engine === "voicevox") {
     const speakerId = Number(options.speaker);
@@ -501,7 +664,7 @@ async function runGenerate(options, io) {
     }
     const engineHandle = await ensureVoicevoxEngine();
     try {
-      audioBuffer = await synthesizeVoicevox(readingText, speakerId);
+      audioBuffer = await synthesizeVoicevox(readingText, speakerId, options.speed);
       const [version, speakerName] = await Promise.all([
         getVoicevoxVersion(),
         resolveVoicevoxSpeakerName(speakerId),
@@ -517,31 +680,34 @@ async function runGenerate(options, io) {
       if (engineHandle.startedByUs) await stopVoicevoxEngine(engineHandle.child);
     }
   } else {
-    const falKey = resolveFalKey();
-    const meta = readProfileMeta(options.profile);
-    const estimatedCostUsd = estimateFalCostUsd(readingText);
-    io.logError(`fal-qwen3 推定費用: 約 $${estimatedCostUsd}（${readingText.length} 文字 × $${FAL_USD_PER_1000_CHARS}/1000字）`);
+    const estimatedCostUsd = options.engine === "gemini-tts"
+      ? estimateGeminiTtsCostUsd(readingText.length) : estimateFalCostUsd(readingText);
+    costUsd = estimatedCostUsd;
+    io.logError(`${options.engine} 推定費用: 約 $${estimatedCostUsd}（${readingText.length} 文字）`);
     if (!options.yes) {
-      printJson({
-        sent: false,
-        engine: "fal-qwen3",
-        estimated_cost_usd: estimatedCostUsd,
-        reason: "費用承認（--yes）がありません。実リクエストは送信していません。",
-      }, io.log);
+      if (options.json) printCompactJson({ version: 1, status: "needs_approval", estimate_usd: estimatedCostUsd, chars: readingText.length,
+        ...(options.speed !== null ? { speed_applied: false, warnings } : {}) }, io.log);
+      else printJson({ sent: false, engine: options.engine, estimated_cost_usd: estimatedCostUsd,
+        reason: "費用承認（--yes）がありません。実リクエストは送信していません。" }, io.log);
       return 2;
     }
+    const falKey = resolveFalKey();
     // --yes が明示された場合のみ、ここで初めて課金の発生する fal API を呼び出す。
-    audioBuffer = await synthesizeFal(readingText, meta, falKey);
-    provenance = {
-      provider: "fal",
-      engine: "qwen-3-tts-1.7b",
-      voice: `profile:${options.profile}`,
-      generated_at: new Date().toISOString(),
-    };
+    if (options.engine === "gemini-tts") {
+      audioBuffer = await synthesizeGeminiTts(readingText, { voice: options.voice, model: "gemini-2.5-flash-tts", style: options.style, falKey });
+      provenance = { provider: "fal", engine: "gemini-2.5-flash-tts", voice: `gemini:${options.voice}`,
+        generated_at: new Date().toISOString(), price_verified: false };
+    } else {
+      const meta = readProfileMeta(options.profile);
+      audioBuffer = await synthesizeFal(readingText, meta, falKey);
+      provenance = { provider: "fal", engine: "qwen-3-tts-1.7b", voice: `profile:${options.profile}`,
+        generated_at: new Date().toISOString() };
+    }
   }
 
   fs.mkdirSync(path.dirname(outputPath), { recursive: true });
   fs.writeFileSync(outputPath, audioBuffer);
+  const duration = durationForAudio(audioBuffer, outputPath, options.engine, warnings);
 
   const entry = {
     id,
@@ -550,12 +716,17 @@ async function runGenerate(options, io) {
     gain_db: options.gainDb,
     ...(scriptText ? { script: scriptText } : {}),
     reading: readingText,
+    ...(options.captionRef ? { caption_ref: options.captionRef } : {}),
     provenance,
   };
 
   if (options.apply) applyToEditJson(options.project, entry, io);
 
-  printJson(entry, io.log);
+  if (options.json) printCompactJson({ version: 1, status: "ok", id, path: relativePath,
+    duration_s: duration, engine: options.engine, voice: provenance.voice, cost_usd: costUsd,
+    applied: options.apply, caption_ref: options.captionRef, provenance, warnings,
+    ...(options.speed !== null ? { speed_applied: options.engine === "voicevox" } : {}) }, io.log);
+  else printJson(entry, io.log);
   return 0;
 }
 
@@ -573,6 +744,18 @@ export async function runNarrationCommand(args, commandOptions = {}) {
     io.log(usage);
     return { exitCode: 0 };
   }
+  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);
+      return { exitCode: 0 };
+    } catch (error) {
+      const message = error instanceof PublicError ? error.message : "声一覧を取得できませんでした";
+      io.logError(message);
+      printCompactJson({ error: message }, io.log);
+      return { exitCode: args[0] === "voices" ? 3 : 2 };
+    }
+  }
 
   let parsedOptions;
   try {
@@ -583,7 +766,8 @@ export async function runNarrationCommand(args, commandOptions = {}) {
     const exitCode = error instanceof PublicError ? error.exitCode : 1;
     const message = error instanceof PublicError ? error.message : `内部処理に失敗しました: ${error?.message ?? error}`;
     io.logError(message);
-    printJson({ error: message }, io.log);
+    if (args.includes("--json")) printCompactJson({ error: message }, io.log);
+    else printJson({ error: message }, io.log);
     return { exitCode };
   }
 }

package/vendor/docs/contract-2026-07-18-edit-json-v1-sources.md

@@ -83,6 +83,7 @@ source 秒アンカー規則の対象外である。
   `sourceT` または `sourceRange` と組にして source 座標を表す
 - `src` の省略は単一ソース互換を意味する
 - 字幕の重なり（`captions.overlap`）と並び順（`captions.order`）の判定は `src` ごとに行う
+- `time_domain: "output"` の行（置いた文字）は重なり・並び順の検査対象外（2026-09-22 裁定。置き物なので同時に何個あってもよい）
 
 analysis サイドカーは素材単位のままとし、構造は変更しない。参照時に `src` から source path を
 解決する。

package/vendor/docs/contract-2026-07-20-edit-json-v1-narration.md

@@ -192,3 +192,8 @@ narration 音声ファイルの実尺解析（ffprobe 等）を要する別契
 - ducking のサイドチェイン入力を narration トラックへ切り替える実装（プレビュー/書き出し双方）
 - narration の実尺を考慮した区間重複検出（§6）
 - `audio.narration[].provenance.provider` の enum 強制（現状は文書上の例示のみ）
+
+## 追記 2026-09-22: `caption_ref`
+
+ナレーションには、生成元の字幕 ID を表す任意の `caption_ref`（`c-` と 4 桁の数字）を追加できる。
+字幕は別ファイルなので参照先の存在確認は行わない。追加のみの進化であり、edit.json の `version` は変更しない。

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

@@ -58,6 +58,15 @@ cut 境界の選択は宣言順ではなく解決済みタイムラインと z-o
 
 ### 2.2 framing、transform、opacity、freeze、keyframes
 
+> **2026-09-22 — 非等方スケール v1**: `transform.scaleX` / `scaleY` は独立した正数。
+> 有効値は `(scaleX ?? scale ?? 1, scaleY ?? scale ?? 1)`。負値・0 は不可。
+> `source.kind === 'group'` は軸別指定を持てず、親は常に等比とする。
+> 等比親との合成は子の各有効値に親の `scale` を掛け、逆変換は同じ値で割る。
+> 書き込み時に両軸の有効値が等しければ `scale` に畳む。既存の `scale` だけの宣言は変更しない。
+> keyframes は端点を各軸の有効値へ解決してから補間する（`scale` と `scaleX` の混在も可）。
+> overlay の CSS は `translate(...) scale(sx, sy) rotate(...)`、素材は crop の幅・高さへ
+> 各軸を掛けて回転する。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
+
 - `framing.crop` は fit 済みフレームを窓抜きして出力寸法へ再拡大する。
 - `framing.keyframes`、transform keyframes は cut 内の出力秒で評価し、hold / linear / ease-in-out の
   指定補間を使う。

package/vendor/docs/contract-2026-08-03-caption-display-encoding-qc-v1.md

@@ -40,6 +40,7 @@ style/emphasis conflicts; non-NFC or trimmed text; invalid manual fragments; unr
 overlap; and reference/output aspect mismatch. A resolved production render stores
 `.akari/reports/caption-layout/<payload-sha256>.json`, including Node/ICU provenance and the boundary
 projection digest, and its immutable render receipt references the file and summary.
+Captions with `time_domain: "output"` (placed text) are exempt from overlap and order checks; any number may share the same time (2026-09-22 decision). Source-domain captions retain their per-source checks.
 
 Under `display_policy`, an omitted `captions[].style` remains valid. The known word-display styles
 `karaoke`, `pop`, `reveal`, and `reveal-word` remain `STYLE_CONFLICT` errors, while any other value is

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

@@ -17,6 +17,15 @@ updated: 2026-08-30
 
 ## 1. 意味論
 
+> **2026-09-22 — 非等方スケール v1**: `transform.scaleX` / `scaleY` は独立した正数。
+> 有効値は `(scaleX ?? scale ?? 1, scaleY ?? scale ?? 1)`。負値・0 は不可。
+> `source.kind === 'group'` は軸別指定を持てず、親は常に等比とする。
+> 等比親との合成は子の各有効値に親の `scale` を掛け、逆変換は同じ値で割る。
+> 書き込み時に両軸の有効値が等しければ `scale` に畳む。既存の `scale` だけの宣言は変更しない。
+> keyframes は端点を各軸の有効値へ解決してから補間する（`scale` と `scaleX` の混在も可）。
+> overlay の CSS は `translate(...) scale(sx, sy) rotate(...)`、素材は crop の幅・高さへ
+> 各軸を掛けて回転する。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
+
 - `keyframes[]` はレイヤー / アイテムの `transform` / `crop` / `perspective` を時間で動かす共通機構
 - `t` は**ローカル時間**: v1 `layers[].keyframes[].t` はレイヤー内秒（`layerItem.t` を 0 とする。`cuts[].framing.keyframes[].t` と同じ規約）、
   v2 `items[].keyframes[].t` は**アイテム内の整数フレーム**（`item.at` を 0 とする）

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

@@ -63,6 +63,15 @@ updated: 2026-09-06
 
 ### 2.1 形（1 つだけ: 点形）
 
+> **2026-09-22 — 非等方スケール v1**: `transform.scaleX` / `scaleY` は独立した正数。
+> 有効値は `(scaleX ?? scale ?? 1, scaleY ?? scale ?? 1)`。負値・0 は不可。
+> `source.kind === 'group'` は軸別指定を持てず、親は常に等比とする。
+> 等比親との合成は子の各有効値に親の `scale` を掛け、逆変換は同じ値で割る。
+> 書き込み時に両軸の有効値が等しければ `scale` に畳む。既存の `scale` だけの宣言は変更しない。
+> keyframes は端点を各軸の有効値へ解決してから補間する（`scale` と `scaleX` の混在も可）。
+> overlay の CSS は `translate(...) scale(sx, sy) rotate(...)`、素材は crop の幅・高さへ
+> 各軸を掛けて回転する。四隅 resize は両軸へ同じ倍率を掛け、縦横比を維持する。
+
 既存 `keyframeV2`（点ごとに任意プロパティ・`t` はアイテム相対の整数フレーム）を**唯一の形**として保ち、次を足す:
 
 ```jsonc

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

@@ -42,6 +42,8 @@
 
 置き場: 生成物は `assets/generated/<file>`、サイドカーは `assets/generated/<file>.meta.json`。実写や既存素材から生成するときも、**生成物の隣**に置く（元素材の隣ではない）。
 
+meta の無い静止画は、最初に下書きを書くときにシェルが `kind: still, status: done`（取り込み画像）の meta を新設する。動画・音声・html には新設しない。
+
 ```json
 {
   "version": 1,

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.77",
+  "version": "0.1.79",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/creator-root/src/index.mjs

@@ -684,7 +684,8 @@ export function readLibraryLocation(env = process.env, { platform = process.plat
     try {
         const value = JSON.parse(readFileSync(path.join(resolveAkariHome(env, { platform }), 'library-location.json'), 'utf8'));
         if (value?.version !== LIBRARY_LOCATION_VERSION || typeof value.root !== 'string'
-            || !path.isAbsolute(value.root) || !LIBRARY_STATES.has(value.state)) return null;
+            || !path.isAbsolute(value.root) || !LIBRARY_STATES.has(value.state)
+            || (value.previousRoot !== undefined && (typeof value.previousRoot !== 'string' || !path.isAbsolute(value.previousRoot)))) return null;
         return value;
     } catch { return null; }
 }
@@ -693,9 +694,11 @@ export function resolveAssetLibraryRoots(env = process.env, { platform = process
     const legacy = path.resolve(resolveAkariHome(env, { platform }), 'assets');
     const location = readLibraryLocation(env, { platform });
     const write = env.AKARI_LIBRARY_ROOT ? path.resolve(env.AKARI_LIBRARY_ROOT)
-        : location && ['migrating', 'done'].includes(location.state) ? path.resolve(location.root) : legacy;
+        : location && ['migrating', 'done'].includes(location.state) ? path.resolve(location.root)
+        : location?.previousRoot ? path.resolve(location.previousRoot) : legacy;
     const seen = new Set();
-    const read = [write, legacy].filter(root => {
+    const read = [write, location?.previousRoot, legacy].filter(root => {
+        if (!root) return false;
         let actual;
         try { actual = realpathSync(root); } catch { actual = root; }
         if (seen.has(actual)) return false;
@@ -703,11 +706,13 @@ export function resolveAssetLibraryRoots(env = process.env, { platform = process
         return true;
     });
     return { write, read,
-        source: env.AKARI_LIBRARY_ROOT ? 'env' : location && ['migrating', 'done'].includes(location.state) ? 'location' : 'legacy' };
+        source: env.AKARI_LIBRARY_ROOT ? 'env' : location && (['migrating', 'done'].includes(location.state) || location.previousRoot)
+            ? 'location' : 'legacy' };
 }
 
 export async function writeLibraryLocation(value, env = process.env, { platform = process.platform } = {}) {
-    if (!path.isAbsolute(value.root) || !LIBRARY_STATES.has(value.state)) throw new Error('Invalid library location');
+    if (!path.isAbsolute(value.root) || !LIBRARY_STATES.has(value.state)
+        || (value.previousRoot !== undefined && !path.isAbsolute(value.previousRoot))) throw new Error('Invalid library location');
     await atomicWriteJson(path.join(resolveAkariHome(env, { platform }), 'library-location.json'),
         { ...value, version: LIBRARY_LOCATION_VERSION });
 }
@@ -868,14 +873,15 @@ async function repairLibraryLinks(legacy, root, home, preserved = new Set()) {
 
 /** Explicit migrate rechecks late writes by old CLI versions; startup only resumes undecided work. */
 export async function migrateAssetLibrary({ env = process.env, platform = process.platform,
-    dryRun = false, automatic = false, notify, fsOps = {} } = {}) {
+    dryRun = false, automatic = false, notify, fsOps = {}, sourceRoot, targetRoot, allowCloud = false, onProgress } = {}) {
     const home = path.resolve(resolveAkariHome(env, { platform }));
-    const legacy = path.join(home, 'assets');
     let location = readLibraryLocation(env, { platform });
+    const legacy = sourceRoot ? path.resolve(sourceRoot) : location?.previousRoot && ['migrating', 'pending'].includes(location.state)
+        ? path.resolve(location.previousRoot) : path.join(home, 'assets');
     const result = { state: location?.state ?? null, root: null, moved: 0, bytes: 0, totalBytes: 0,
         skipped: [], failures: [], cloud: null, notified: false };
-    if (location?.state === 'declined') return result;
-    let root = env.AKARI_LIBRARY_ROOT ? path.resolve(env.AKARI_LIBRARY_ROOT) : location?.root;
+    if (location?.state === 'declined' && !targetRoot) return result;
+    let root = targetRoot ? path.resolve(targetRoot) : env.AKARI_LIBRARY_ROOT ? path.resolve(env.AKARI_LIBRARY_ROOT) : location?.root;
     if (!location?.root) {
         const creator = env.AKARI_CREATOR_ROOT || await tryMachinePointer(env, platform);
         if (!creator || !(await tryReadRootManifest(creator)).ok) return result;
@@ -915,11 +921,12 @@ export async function migrateAssetLibrary({ env = process.env, platform = proces
     if (!release) return { ...result, busy: true };
     try {
         location = readLibraryLocation(env, { platform });
-        if (location?.state === 'declined') return { ...result, state: 'declined' };
+        if (location?.state === 'declined' && !targetRoot) return { ...result, state: 'declined' };
         location = { ...location, version: LIBRARY_LOCATION_VERSION, root,
+            ...(sourceRoot ? { previousRoot: path.resolve(sourceRoot) } : {}),
             decidedAt: location?.decidedAt ?? new Date().toISOString() };
         const save = () => writeLibraryLocation(location, env, { platform });
-        if (result.cloud) {
+        if (result.cloud && !allowCloud) {
             location.state = 'pending'; await save(); return { ...result, state: 'pending' };
         }
         if (!(automatic && location.state === 'done')) {
@@ -972,6 +979,7 @@ export async function migrateAssetLibrary({ env = process.env, platform = proces
             for (const name of (await fs.readdir(legacy).catch(error => { if (error.code === 'ENOENT') return []; throw error; })).sort()) {
                 try { await moveEntry(path.join(legacy, name), path.join(root, name)); }
                 catch (error) { result.failures.push({ path: name, message: error.message }); }
+                onProgress?.({ moved: result.moved, bytes: result.bytes, totalBytes: result.totalBytes });
             }
             try { await repairLibraryLinks(legacy, root, home, preserved); }
             catch (error) { result.failures.push({ path: root, message: error.message }); }
@@ -996,8 +1004,9 @@ export async function migrateAssetLibrary({ env = process.env, platform = proces
                     result.failures.push({ path: path.relative(legacy, alias.source), message: error.message });
                 }
             }
-            location.state = result.failures.length ? 'migrating' : 'done';
+            location.state = result.failures.length || result.skipped.length ? 'migrating' : 'done';
             if (location.state === 'done') location.migratedAt ??= new Date().toISOString();
+            if (location.state === 'done') delete location.previousRoot;
             await save();
         }
         if (location.state === 'done' && !location.notifiedAt && notify) {
@@ -1010,3 +1019,14 @@ export async function migrateAssetLibrary({ env = process.env, platform = proces
         return { ...result, state: readLibraryLocation(env, { platform })?.state ?? result.state };
     } finally { await release(); }
 }
+
+/** Place changes reuse the same locked, verified migration as first launch. */
+export async function changeAssetLibraryLocation(root, { env = process.env, platform = process.platform, onProgress } = {}) {
+    if (!path.isAbsolute(root)) throw new Error('Invalid library location');
+    if (env.AKARI_LIBRARY_ROOT && path.resolve(env.AKARI_LIBRARY_ROOT) !== path.resolve(root)) {
+        throw new Error('環境変数で素材の置き場が固定されています');
+    }
+    const current = resolveAssetLibraryRoots(env, { platform }).write;
+    if (path.resolve(current) === path.resolve(root)) return { state: 'done', root, moved: 0, bytes: 0, failures: [] };
+    return migrateAssetLibrary({ env, platform, sourceRoot: current, targetRoot: root, onProgress });
+}