akari-video 1.3.0-beta.6 → 1.3.0-beta.7

package/package.json

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

@@ -40,6 +40,9 @@ export const VENDOR_SOURCES = [
   'packages/akari-tools/bin/tools.mjs',
   'packages/akari-tools/src/common/main-module.mjs',
   'packages/akari-tools/src/media/common.mjs',
+  // bin/tools.mjs の install / status whisper が引く（akari tools install whisper）。
+  'packages/akari-tools/src/media/whisper-model.mjs',
+  'packages/akari-tools/src/media/whisper-model-candidates.mjs',
   'packages/akari-tools/src/i18n.mjs',
   'packages/akari-tools/package.json',
   'packages/akari-voice/src',

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

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

package/vendor/packages/akari-tools/bin/tools.mjs

@@ -6,6 +6,10 @@ import { homedir } from 'node:os';
 import { dirname, isAbsolute, join, posix, resolve } from 'node:path';
 import { gunzipSync } from 'node:zlib';
 import { isMainModule } from '../src/common/main-module.mjs';
+import { whisperModelCandidates, isWhisperModelExcluded } from '../src/media/whisper-model-candidates.mjs';
+import { WHISPER_MODEL, installWhisperModel } from '../src/media/whisper-model.mjs';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 
 const modelPins = [
     { file: 'wespeaker_en_voxceleb_resnet34_LM.onnx', url: 'https://github.com/k2-fsa/sherpa-onnx/releases/download/speaker-recongition-models/wespeaker_en_voxceleb_resnet34_LM.onnx', sha256: 'e9848563da86f263117134dfd7ad63c92355b37de492b55e325400c9d9c39012', bytes: 26530550, license: 'CC-BY-4.0' },
@@ -275,13 +279,14 @@ export async function installVoiceEngine({ voiceHome = resolveVoiceHome(), platf
 }
 
 export async function runToolsCli(argv, { env = process.env, homeDir = homedir(), stdout = process.stdout, stderr = process.stderr,
-    fetchImpl = fetch, statfs = fs.statfs, platform = process.platform, arch = process.arch, pins = VOICE_ENGINE_PINS } = {}) {
-    const usage = toolsText('tools.voice.cli.usage');
+    fetchImpl = fetch, statfs = fs.statfs, platform = process.platform, arch = process.arch, pins = VOICE_ENGINE_PINS, whisperModel = WHISPER_MODEL } = {}) {
+    const usage = toolsText('tools.whisper.cli.usage');
     if (argv.includes('--help')) { stdout.write(`${usage}\n`); return 0; }
     const [verb, subject, ...rest] = argv;
-    if (!['install', 'status'].includes(verb) || subject !== 'voice' || rest.some(value => value !== '--json')) {
+    if (!['install', 'status'].includes(verb) || !['voice', 'whisper'].includes(subject) || rest.some(value => value !== '--json')) {
         stderr.write(`${usage}\n`); return 2;
     }
+    if (subject === 'whisper') return runWhisperCli(verb, rest.includes('--json'), { env, homeDir, stdout, stderr, fetchImpl, whisperModel });
     const voiceHome = resolveVoiceHome({ env, homeDir });
     const json = rest.includes('--json');
     if (verb === 'status') {
@@ -299,6 +304,24 @@ export async function runToolsCli(argv, { env = process.env, homeDir = homedir()
     return ok ? 0 : 1;
 }
 
+async function runWhisperCli(verb, json, { env, homeDir, stdout, stderr, fetchImpl, whisperModel }) {
+    if (verb === 'status') {
+        const model = whisperModelCandidates({ env, homeDir, repoRoot: resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..'), bin: '' })
+            .find(candidate => existsSync(candidate) && !isWhisperModelExcluded(candidate));
+        stdout.write(`${json ? JSON.stringify({ state: model ? 'ready' : 'missing', model: model ?? null }) : model ? toolsText('tools.whisper.cli.statusReady', { path: model }) : toolsText('tools.whisper.cli.statusMissing')}\n`);
+        return model ? 0 : 1;
+    }
+    let lastStep = -1;
+    const result = await installWhisperModel({ homeDir, fetchImpl, model: whisperModel, onProgress: ({ downloadedBytes, totalBytes }) => {
+        if (!totalBytes) return;
+        const step = Math.min(10, Math.floor(downloadedBytes / totalBytes * 10));
+        if (step > lastStep) { lastStep = step; stderr.write(`${toolsText('tools.whisper.cli.downloading')} ${step * 10}%\n`); }
+    } });
+    const ok = result.outcome === 'installed' || result.outcome === 'unchanged';
+    stdout.write(`${json ? JSON.stringify({ ok, outcome: result.outcome, message: result.message, path: result.path }) : result.message}\n`);
+    return ok ? 0 : 1;
+}
+
 if (isMainModule(import.meta.url)) {
     runToolsCli(process.argv.slice(2)).then(code => { process.exitCode = code; }, error => { console.error(error); process.exitCode = 1; });
 }

package/vendor/packages/akari-tools/src/media/whisper-model-candidates.mjs

@@ -0,0 +1,41 @@
+import { existsSync, readdirSync } from "node:fs";
+import path from "node:path";
+
+/** Ordered search locations shared by the CLI and shell. The override is a file. */
+export function whisperModelLocations({ env, homeDir, repoRoot, bin }) {
+  return [
+    { path: env.WHISPER_CPP_MODEL, recursive: false },
+    { path: path.join(homeDir, ".akari", "tools", "models"), recursive: true },
+    { path: path.join(repoRoot, "models"), recursive: true },
+    { path: path.join(repoRoot, "whisper.cpp", "models"), recursive: true },
+    { path: path.join(homeDir, ".cache", "whisper.cpp"), recursive: true },
+    { path: path.join(homeDir, "Library", "Caches", "whisper.cpp"), recursive: true },
+    { path: path.resolve(path.dirname(bin), "..", "share", "whisper-cpp"), recursive: true },
+    { path: "/opt/homebrew/share/whisper-cpp", recursive: true },
+    { path: "/usr/local/share/whisper-cpp", recursive: true },
+    { path: path.join(homeDir, "Library", "Application Support", "com.prakashjoshipax.VoiceInk", "WhisperModels"), recursive: true },
+  ].filter(location => Boolean(location.path));
+}
+
+export function isWhisperModelFilename(candidate) {
+  return /^ggml-.*\.bin$/i.test(path.basename(candidate));
+}
+
+export function isWhisperModelExcluded(candidate, lang = "auto") {
+  return path.basename(candidate).startsWith("for-tests-") || (lang !== "en" && path.basename(candidate).includes(".en."));
+}
+
+function findModels(root) {
+  if (!existsSync(root)) return [];
+  try {
+    return readdirSync(root, { recursive: true })
+      .map(entry => path.join(root, String(entry)))
+      .filter(isWhisperModelFilename);
+  } catch {
+    return [];
+  }
+}
+
+export function whisperModelCandidates(options) {
+  return whisperModelLocations(options).flatMap(location => location.recursive ? findModels(location.path) : [location.path]);
+}

package/vendor/packages/akari-tools/src/media/whisper-model.mjs

@@ -0,0 +1,82 @@
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream, existsSync, statSync } from "node:fs";
+import { mkdir, rename, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+// アプリの backend（esbuild の cjs 出力）にも束ねられるので、top-level await を含む ../i18n.mjs ではなく
+// bin/tools.mjs と同じ i18n の本体から引く。
+import { t as toolsText } from "../../../i18n/index.mjs";
+
+/**
+ * 認識モデルの既定（アプリの初回セットアップ / 設定 → 道具 と同じもの）。
+ * アプリ側 (tool-install.ts) もここを参照するので、URL と sha256 の正本はこの 1 か所。
+ * HF の `resolve/main` はブランチ追従だが、内容が変われば sha256 不一致で失敗するので版固定と同じ効果になる。
+ */
+export const WHISPER_MODEL = {
+  file: "ggml-large-v3-turbo-q5_0.bin",
+  url: "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin",
+  sha256: "394221709cd5ad1f40c46e6031ca61bce88931e6e088c188294c6d5a55ffa7e2",
+};
+
+/** `~/.akari/tools/models`（whisper-model-candidates.mjs の探索対象と一致させる）。 */
+export function whisperModelsDir(homeDir = os.homedir()) {
+  return path.join(homeDir, ".akari", "tools", "models");
+}
+
+async function sha256OfFile(file) {
+  const hash = createHash("sha256");
+  for await (const chunk of createReadStream(file)) hash.update(chunk);
+  return hash.digest("hex");
+}
+
+/**
+ * モデルを tmp に落として sha256 を検証してから rename する。置き済みで sha256 が合えば何もしない。
+ * model / fetchImpl / homeDir は差し替え可能（テストは小さい偽ファイルで回す）。
+ */
+export async function installWhisperModel({ homeDir = os.homedir(), fetchImpl = fetch, model = WHISPER_MODEL, onProgress } = {}) {
+  const directory = whisperModelsDir(homeDir);
+  const destination = path.join(directory, model.file);
+  if (existsSync(destination) && statSync(destination).isFile() && await sha256OfFile(destination) === model.sha256) {
+    return { outcome: "unchanged", message: toolsText("tools.whisper.cli.alreadyReady", { path: destination }), path: destination };
+  }
+  await mkdir(directory, { recursive: true });
+  const temporary = `${destination}.tmp-${process.pid}`;
+  try {
+    const response = await fetchImpl(model.url, { redirect: "follow" });
+    if (!response.ok) throw new Error(`HTTP ${response.status}`);
+    const total = Number(response.headers?.get?.("content-length")) || undefined;
+    const hash = createHash("sha256");
+    const output = createWriteStream(temporary);
+    let downloaded = 0;
+    const write = (chunk) => new Promise((resolve, reject) => output.write(chunk, (error) => error ? reject(error) : resolve()));
+    const take = async (chunk) => {
+      hash.update(chunk);
+      await write(chunk);
+      downloaded += chunk.length;
+      onProgress?.({ downloadedBytes: downloaded, totalBytes: total });
+    };
+    try {
+      if (response.body?.getReader) {
+        const reader = response.body.getReader();
+        for (;;) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          await take(value);
+        }
+      } else {
+        await take(Buffer.from(await response.arrayBuffer()));
+      }
+    } finally {
+      await new Promise((resolve) => output.end(resolve));
+    }
+    if (hash.digest("hex") !== model.sha256) {
+      return { outcome: "failed", message: toolsText("tools.whisper.cli.verifyFailed"), path: destination };
+    }
+    await rename(temporary, destination);
+    return { outcome: "installed", message: toolsText("tools.whisper.cli.installed", { path: destination }), path: destination };
+  } catch (error) {
+    return { outcome: "failed", message: toolsText("tools.whisper.cli.downloadFailed", { error: error instanceof Error ? error.message : String(error) }), path: destination };
+  } finally {
+    await rm(temporary, { force: true });
+  }
+}

package/vendor/packages/i18n/locales/en/partner.json

@@ -75,6 +75,8 @@
   "partner.partnerPanel.extensionUpdater.extensionNotInstalledStatus": "Extension is not installed",
   "partner.partnerPanel.extensionUpdater.extensionUpdateAvailableText": "An extension update is available",
   "partner.partnerPanel.extensionUpdater.extensionUpDateText": "Extension is up to date",
+  "partner.partnerPanel.cliUpdate.availableText": "A new version of {value1} is available: {value2} (current {value3})",
+  "partner.partnerPanel.cliUpdate.openSettingsAction": "Update in Settings",
   "partner.partnerPanel.extensionUpdater.laterLabel": "Later",
   "partner.partnerPanel.extensionUpdater.newVersionAvailableText": "A new version of {value1} is available: {value2}",
   "partner.partnerPanel.extensionUpdater.reloadAction": "Reload Now",
@@ -212,6 +214,7 @@
   "partner.partnerSetup.bootstrap.fetchingCodexReleaseInformationText": "Fetching Codex release information: {value1}",
   "partner.partnerSetup.bootstrap.foundExistingClaudeText": "Found existing claude: {value1}",
   "partner.partnerSetup.bootstrap.foundExistingCodexText": "Found existing codex: {value1}",
+  "partner.partnerSetup.bootstrap.managedCodexPackageIncompleteText": "The codex package installed by AKARI is incomplete; reinstalling: {value1}",
   "partner.partnerSetup.bootstrap.foundExistingStatus": "Found existing {value1}: {value2}",
   "partner.partnerSetup.bootstrap.foundExistingVersionStatus": "Found existing {value1} {value2}: {value3}",
   "partner.partnerSetup.bootstrap.foundLabel": "Found {value1} {value2}: {value3}",

package/vendor/packages/i18n/locales/en/surfaces.json

@@ -465,6 +465,17 @@
   "surfaces.settings.partnerChecking.label": "Checking…",
   "surfaces.settings.partnerInstalled.status": "Installed",
   "surfaces.settings.partnerNotInstalled.status": "Not installed",
+  "surfaces.settings.partnerNow.label": "Now {version}",
+  "surfaces.settings.partnerLatest.label": "Latest {version}",
+  "surfaces.settings.partnerUpdate.button": "Update",
+  "surfaces.settings.partnerUpdating.status": "Updating…",
+  "surfaces.settings.partnerSelfUpdating.label": "Updates itself automatically",
+  "surfaces.settings.partnerExternalUpdate.message": "A newer version is available. This copy was installed outside AKARI (Homebrew, npm, etc.), so update it the same way you installed it.",
+  "surfaces.settings.partnerUpdated.message": "Updated ({version})",
+  "surfaces.settings.partnerUpdateFailed.message": "Could not update: {reason}",
+  "surfaces.settings.partnerUpdateUnsupported.message": "AKARI cannot update this CLI.",
+  "surfaces.settings.partnerUpdateRunning.message": "An update is already running.",
+  "surfaces.settings.partnerUpdateBusy.message": "It is in use and cannot be replaced. Close the partner panel and try again.",
   "surfaces.settings.partnerInsert.label": "Installation",
   "surfaces.settings.partnerStart.label": "Start",
   "surfaces.settings.partnerClaudeCodeExtension.label": "Claude Code extension",
@@ -1688,6 +1699,10 @@
   "surfaces.onboarding.coachExportStandard.title": "Keep Standard selected, then Export",
   "surfaces.onboarding.coachChangeImageQualitySaveDestination.description": "<p>Change quality and destination here if needed.</p>",
   "surfaces.onboarding.coachExporting.title": "Exporting…",
+  "surfaces.onboarding.coachExportFailed.title": "Export failed",
+  "surfaces.onboarding.coachExportFailed.description": "<p>Check the settings and try exporting again, or skip this step for now.</p>",
+  "surfaces.onboarding.coachExportRetry.label": "Try exporting again",
+  "surfaces.onboarding.coachExportSkip.label": "Skip export and continue",
   "surfaces.onboarding.coachProgressDisplayedBottomRightOkayContinueWorking.description": "<p>Progress appears in the bottom right. You can keep working.</p>",
   "surfaces.onboarding.coachExportComplete.title": "Export complete",
   "surfaces.onboarding.coachCreatedFilesListedCompletedAlsoExportAsking.description": "<p>Exported files appear under “Completed.”</p><p>You can also ask partner to export; it shows the result and asks for confirmation first.</p>",
@@ -1714,6 +1729,7 @@
   "surfaces.onboarding.coachMarkupBack.label": "<button class=\"ao-back\" data-ao=\"back\">← Back</button>",
   "surfaces.onboarding.prepareDownloadSampleAssetCheckInternetConnection.message": "Could not download the sample asset. Check your internet connection.",
   "surfaces.onboarding.prepareSampleAssetCheckDestinationFreeSpace.message": "Could not prepare the sample asset. Check the destination and free space.",
+  "surfaces.onboarding.preparePartnerStopFailed.message": "Could not stop the active partner, so the project was not switched. Stop the partner's work and try again.",
   "surfaces.onboarding.pressAssetSeeContents.title": "Select an Asset to preview it",
   "surfaces.onboarding.tryClickingIncludedVideo.description": "<p>Select the imported video.</p>",
   "surfaces.onboarding.clickCaptionFixSpot.title": "Select a Caption to edit it in place",
@@ -2224,5 +2240,9 @@
   "surfaces.tools.voice.name.label": "Speaker separation (voice engine)",
   "surfaces.tools.voice.provider.label": "k2-fsa (sherpa-onnx)",
   "surfaces.tools.voice.purpose.message": "Separates speakers in footage and suggests who spoke. Voices are processed only on this computer.",
-  "surfaces.tools.voice.size.label": "About 160 MB"
+  "surfaces.tools.voice.size.label": "About 160 MB",
+  "surfaces.projects.contextMenuOpenProject.action": "Open project",
+  "surfaces.projects.contextMenuCopyPath.action": "Copy path",
+  "surfaces.projects.pathCopied.message": "Copied the project path.",
+  "surfaces.projects.couldNotCopyPath.message": "Could not copy the path."
 }

package/vendor/packages/i18n/locales/en/tools.json

@@ -241,5 +241,22 @@
   "tools.voice.engine.error.sampleOutsideChannel": "Voice samples outside the channel cannot be used",
   "tools.voice.engine.error.setupRequired": "Speaker separation needs setup (run akari tools install voice or use Create Captions in the app).",
   "tools.voice.engine.error.sidecarMissing": "Voice sidecar file is missing",
-  "tools.voice.engine.notice.countFallback": "Could not separate into {requested} speakers; using the automatically detected {used} speakers."
+  "tools.voice.engine.notice.countFallback": "Could not separate into {requested} speakers; using the automatically detected {used} speakers.",
+  "tools.transcribe.error.whisperFallback.speechFailed": "SpeechAnalyzer could not transcribe this file, and the whisper.cpp fallback is unavailable.",
+  "tools.transcribe.error.whisperFallback.localeUnsupported": "SpeechAnalyzer does not support {lang}, and the whisper.cpp fallback is unavailable.",
+  "tools.transcribe.error.whisperFallback.noModel": "No whisper.cpp ggml model was found.\nSearched:\n{locations}\nFix (any one):\n  - akari tools install whisper  (downloads the model into ~/.akari/tools/models/)\n  - Install it from Settings -> Tools -> Whisper\n  - Put a ggml-*.bin in ~/.akari/tools/models/, or point the WHISPER_CPP_MODEL environment variable at the file",
+  "tools.transcribe.error.whisperFallback.noBin": "whisper-cli was not found. You need the one bundled with the app, or one installed with brew install whisper-cpp (also installable from Settings -> Tools -> Whisper). Get the model with akari tools install whisper.",
+  "tools.transcribe.error.whisperFallback.reason": "SpeechAnalyzer error: {reason}",
+  "tools.media.help.in": "  --in <time>              start of the range to transcribe (seconds or mm:ss)",
+  "tools.media.help.out": "  --out <time>             end of the range to transcribe (seconds or mm:ss)",
+  "tools.media.help.backend": "  --backend <speech-analyzer|whisper-cpp|cloud:<id>>  pick the engine (default: auto)",
+  "tools.media.help.lang": "  --lang <code>            language code, e.g. ja, en (default: auto)",
+  "tools.whisper.cli.alreadyReady": "The Whisper model is already installed: {path}",
+  "tools.whisper.cli.installed": "Downloaded the Whisper model: {path}",
+  "tools.whisper.cli.verifyFailed": "The model failed verification (the download may be corrupted). Please try again.",
+  "tools.whisper.cli.downloadFailed": "Could not download the model ({error}). Please try again.",
+  "tools.whisper.cli.downloading": "Downloading the model",
+  "tools.whisper.cli.statusReady": "ready: {path}",
+  "tools.whisper.cli.statusMissing": "missing: no ggml model found. Run akari tools install whisper",
+  "tools.whisper.cli.usage": "Usage: akari tools install voice|whisper [--json] / akari tools status voice|whisper [--json]"
 }

package/vendor/packages/i18n/locales/ja/partner.json

@@ -75,6 +75,8 @@
   "partner.partnerPanel.extensionUpdater.extensionNotInstalledStatus": "拡張は未インストールです",
   "partner.partnerPanel.extensionUpdater.extensionUpdateAvailableText": "拡張の更新があります",
   "partner.partnerPanel.extensionUpdater.extensionUpDateText": "拡張は最新です",
+  "partner.partnerPanel.cliUpdate.availableText": "{value1} の新しい版 {value2} があります（今は {value3}）",
+  "partner.partnerPanel.cliUpdate.openSettingsAction": "設定でアップデート",
   "partner.partnerPanel.extensionUpdater.laterLabel": "後で",
   "partner.partnerPanel.extensionUpdater.newVersionAvailableText": "{value1} の新しい版 {value2} があります",
   "partner.partnerPanel.extensionUpdater.reloadAction": "今すぐ再読み込み",
@@ -212,6 +214,7 @@
   "partner.partnerSetup.bootstrap.fetchingCodexReleaseInformationText": "Codex リリース情報を取得しています: {value1}",
   "partner.partnerSetup.bootstrap.foundExistingClaudeText": "既存の claude を検出: {value1}",
   "partner.partnerSetup.bootstrap.foundExistingCodexText": "既存の codex を検出: {value1}",
+  "partner.partnerSetup.bootstrap.managedCodexPackageIncompleteText": "AKARI が入れた codex のパッケージが欠けているため入れ直します: {value1}",
   "partner.partnerSetup.bootstrap.foundExistingStatus": "既存の {value1} を検出: {value2}",
   "partner.partnerSetup.bootstrap.foundExistingVersionStatus": "既存の {value1} {value2} を検出: {value3}",
   "partner.partnerSetup.bootstrap.foundLabel": "{value1} {value2} を検出: {value3}",

package/vendor/packages/i18n/locales/ja/surfaces.json

@@ -465,6 +465,17 @@
   "surfaces.settings.partnerChecking.label": "調べています",
   "surfaces.settings.partnerInstalled.status": "インストール済み",
   "surfaces.settings.partnerNotInstalled.status": "未インストール",
+  "surfaces.settings.partnerNow.label": "今 {version}",
+  "surfaces.settings.partnerLatest.label": "最新 {version}",
+  "surfaces.settings.partnerUpdate.button": "アップデート",
+  "surfaces.settings.partnerUpdating.status": "アップデート中…",
+  "surfaces.settings.partnerSelfUpdating.label": "自動で更新されます",
+  "surfaces.settings.partnerExternalUpdate.message": "最新版があります。このコピーは AKARI の外（Homebrew・npm など）で入れられたものなので、入れた方法で更新してください。",
+  "surfaces.settings.partnerUpdated.message": "アップデートしました（{version}）",
+  "surfaces.settings.partnerUpdateFailed.message": "アップデートできませんでした: {reason}",
+  "surfaces.settings.partnerUpdateUnsupported.message": "この CLI は AKARI からはアップデートできません。",
+  "surfaces.settings.partnerUpdateRunning.message": "すでにアップデート中です。",
+  "surfaces.settings.partnerUpdateBusy.message": "使用中のため置き換えられません。パートナーのパネルを閉じてから、もう一度お試しください。",
   "surfaces.settings.partnerInsert.label": "入れ方",
   "surfaces.settings.partnerStart.label": "起動",
   "surfaces.settings.partnerClaudeCodeExtension.label": "Claude Code 拡張",
@@ -1688,6 +1699,10 @@
   "surfaces.onboarding.coachExportStandard.title": "標準のまま「書き出す」",
   "surfaces.onboarding.coachChangeImageQualitySaveDestination.description": "<p>画質や保存先は、ここで変えられます。</p>",
   "surfaces.onboarding.coachExporting.title": "書き出しています",
+  "surfaces.onboarding.coachExportFailed.title": "書き出せませんでした",
+  "surfaces.onboarding.coachExportFailed.description": "<p>設定を確かめて、もう一度書き出せます。ここでは飛ばして先へ進むこともできます。</p>",
+  "surfaces.onboarding.coachExportRetry.label": "もう一度書き出す",
+  "surfaces.onboarding.coachExportSkip.label": "書き出しを飛ばして先へ",
   "surfaces.onboarding.coachProgressDisplayedBottomRightOkayContinueWorking.description": "<p>進み具合は右下に出ます。そのまま作業を続けても大丈夫です。</p>",
   "surfaces.onboarding.coachExportComplete.title": "書き出せました",
   "surfaces.onboarding.coachCreatedFilesListedCompletedAlsoExportAsking.description": "<p>できたファイルは「できたもの」に並びます。</p><p>AI パートナーに「書き出して」と頼んでも書き出せます（中身を見せて、確認してから実行します）。</p>",
@@ -1714,6 +1729,7 @@
   "surfaces.onboarding.coachMarkupBack.label": "<button class=\"ao-back\" data-ao=\"back\">← 戻る</button>",
   "surfaces.onboarding.prepareDownloadSampleAssetCheckInternetConnection.message": "サンプル素材を取得できませんでした。インターネット接続を確認してください。",
   "surfaces.onboarding.prepareSampleAssetCheckDestinationFreeSpace.message": "サンプル素材の準備に失敗しました。保存先と空き容量を確認してください。",
+  "surfaces.onboarding.preparePartnerStopFailed.message": "作業中のパートナーを止められなかったので、切り替えていません。パートナーの作業を止めてから、もう一度お試しください。",
   "surfaces.onboarding.pressAssetSeeContents.title": "素材を押すと、中身が見られます",
   "surfaces.onboarding.tryClickingIncludedVideo.description": "<p>入った動画を押してみてください。</p>",
   "surfaces.onboarding.clickCaptionFixSpot.title": "字幕を押すと、その場で直せます",
@@ -2224,5 +2240,9 @@
   "surfaces.tools.voice.name.label": "話者を分ける（声のエンジン）",
   "surfaces.tools.voice.provider.label": "k2-fsa（sherpa-onnx）",
   "surfaces.tools.voice.purpose.message": "素材の話者を分けて、誰の声かを提案するのに使います。声はこのパソコンの中だけで処理します。",
-  "surfaces.tools.voice.size.label": "約 160MB"
+  "surfaces.tools.voice.size.label": "約 160MB",
+  "surfaces.projects.contextMenuOpenProject.action": "プロジェクトを開く",
+  "surfaces.projects.contextMenuCopyPath.action": "パスをコピー",
+  "surfaces.projects.pathCopied.message": "プロジェクトのパスをコピーしました。",
+  "surfaces.projects.couldNotCopyPath.message": "パスをコピーできませんでした。"
 }

package/vendor/packages/i18n/locales/ja/tools.json

@@ -241,5 +241,22 @@
   "tools.voice.engine.error.sampleOutsideChannel": "チャンネル外の見本は使えません",
   "tools.voice.engine.error.setupRequired": "話者を分けるには準備が要ります（akari tools install voice か、アプリの『字幕を作る』から）",
   "tools.voice.engine.error.sidecarMissing": "声の側ファイルがありません",
-  "tools.voice.engine.notice.countFallback": "指定の {requested} 人に分けられなかったので、自動で分けた結果（{used} 人）を使います"
+  "tools.voice.engine.notice.countFallback": "指定の {requested} 人に分けられなかったので、自動で分けた結果（{used} 人）を使います",
+  "tools.transcribe.error.whisperFallback.speechFailed": "SpeechAnalyzer で文字起こしできず、代わりの whisper.cpp も使えません。",
+  "tools.transcribe.error.whisperFallback.localeUnsupported": "SpeechAnalyzer は言語 {lang} に対応しておらず、代わりの whisper.cpp も使えません。",
+  "tools.transcribe.error.whisperFallback.noModel": "whisper.cpp の ggml モデルが見つかりません。\n探した場所:\n{locations}\n対処（どれか 1 つ）:\n  - akari tools install whisper （モデルを ~/.akari/tools/models/ に取得）\n  - 設定 → 道具 → Whisper からインストール\n  - ggml-*.bin を ~/.akari/tools/models/ に置く、または環境変数 WHISPER_CPP_MODEL にファイルを指定",
+  "tools.transcribe.error.whisperFallback.noBin": "whisper-cli が見つかりません。アプリ同梱のもの、または brew install whisper-cpp で入れたものが必要です（設定 → 道具 → Whisper からも入れられます）。モデルは akari tools install whisper で取得できます。",
+  "tools.transcribe.error.whisperFallback.reason": "SpeechAnalyzer のエラー: {reason}",
+  "tools.media.help.in": "  --in <time>              文字起こしの開始位置（秒 または mm:ss）",
+  "tools.media.help.out": "  --out <time>             文字起こしの終了位置（秒 または mm:ss）",
+  "tools.media.help.backend": "  --backend <speech-analyzer|whisper-cpp|cloud:<id>>  文字起こしエンジンを指定（既定は自動）",
+  "tools.media.help.lang": "  --lang <code>            言語コード（例: ja, en。既定は自動）",
+  "tools.whisper.cli.alreadyReady": "Whisper の認識モデルは取得済みです: {path}",
+  "tools.whisper.cli.installed": "Whisper の認識モデルを取得しました: {path}",
+  "tools.whisper.cli.verifyFailed": "認識モデルの検証に失敗しました（データが壊れている可能性があります）。もう一度お試しください。",
+  "tools.whisper.cli.downloadFailed": "認識モデルの取得に失敗しました（{error}）。もう一度お試しください。",
+  "tools.whisper.cli.downloading": "認識モデルを取得中",
+  "tools.whisper.cli.statusReady": "ready: {path}",
+  "tools.whisper.cli.statusMissing": "missing: ggml モデルが見つかりません。akari tools install whisper で取得できます",
+  "tools.whisper.cli.usage": "使い方: akari tools install voice|whisper [--json] / akari tools status voice|whisper [--json]"
 }

package/vendor/packages/render-cut/src/i18n.mjs

@@ -4,8 +4,15 @@ const normalizeLanguage = core?.normalizeLanguage ?? ((value) => typeof value ==
 const getLanguage = core?.getLanguage ?? (() => normalizeLanguage(process.env.AKARI_LANG ?? Intl.DateTimeFormat().resolvedOptions().locale));
 
 function catalog(language) {
-  try { return JSON.parse(readFileSync(new URL(`../../i18n/locales/${language}/render.json`, import.meta.url), 'utf8')); }
-  catch { return {}; }
+  let base = {};
+  let local = {};
+  try { base = JSON.parse(readFileSync(new URL(`../../i18n/locales/${language}/render.json`, import.meta.url), 'utf8')); }
+  catch {}
+  try {
+    local = JSON.parse(readFileSync(new URL(`./locales/${language}.json`, import.meta.url), 'utf8'));
+  }
+  catch {}
+  return { ...base, ...local };
 }
 
 const catalogs = { ja: catalog('ja'), en: catalog('en') };

package/vendor/skills/address-review/SKILL.md

@@ -22,7 +22,7 @@ Canonical source: private internal contracts (`akari-video-internal`): review-an
    Include only when their IDs are explicitly specified through `--ids`. `[要確認]` is a question for the owner,
    not something the agent may independently interpret and process.
 4. **Pass edit-lint after implementing edit.json changes, before respond**: Caption instructions follow the
-   caption contract ([Captions and cut editing](../../docs/notes-2026-07-14-captions-and-cut-editing.md), Japanese:
+   caption contract ([Captions and cut editing](https://github.com/AkariLabs/akari-video/blob/main/docs/notes-2026-07-14-captions-and-cut-editing.md), Japanese:
    gap principle, actual speech intervals, minimum 1.0s). Run `respond` only after
    `node packages/edit-lint/bin/edit-lint.mjs <project> --media` PASS; never mark addressed before PASS.
 5. **The agent judges interpretation/implementation; bin handles only mechanical listing/state transitions.**
@@ -42,7 +42,7 @@ Canonical source: private internal contracts (`akari-video-internal`): review-an
    `strokes` (with sessionRef). `--all-open` automatically skips `[要確認]` annotations (machine confirmation marker)
    and includes skipped IDs/count in output.
 
-Do not Read all of `edit.json` / `captions.json`; grep by ID and read matching lines only ([Reading edit.json](../../docs/guides/edit-json-access.md)).
+Do not Read all of `edit.json` / `captions.json`; grep by ID and read matching lines only ([Reading edit.json](https://github.com/AkariLabs/akari-video/blob/main/docs/guides/edit-json-access.md)).
 Write through relevant-line Edit or edit-store's script API.
 
 2. Read each ticket's `text` instructions (including source seconds/target) and decide the response.

package/vendor/skills/analyze-footage/SKILL.md

@@ -7,11 +7,11 @@ description: Analyze one footage file in pull-driven levels L0–L3 and record o
 
 > **Language**: Respond in the user's language — conversation, questions, approval prompts, and the reports and records you write (including decision-log rows) follow the language the user writes in.
 
-Read lang/<content-language>.md for language-specific rules (content language: --lang → intake.json "language" → transcript language → ja; see docs/contract-2026-10-11-content-language.md). If that file does not exist, read lang/en.md.
+Read lang/<content-language>.md for language-specific rules (content language: --lang → intake.json "language" → transcript language → ja; see https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-10-11-content-language.md). If that file does not exist, read lang/en.md.
 
 ## Analysis levels
 
-The authoritative source for terminology, inputs, outputs, and ledger updates is [`akari media` Observation Command Contract v0 §3 / §4](../../docs/contract-2026-08-29-media-inspect-cli-v0.md). Use `akari media` to observe the source. This skill interprets and scores evidence, then records only observed results.
+The authoritative source for terminology, inputs, outputs, and ledger updates is [`akari media` Observation Command Contract v0 §3 / §4](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-08-29-media-inspect-cli-v0.md). Use `akari media` to observe the source. This skill interprets and scores evidence, then records only observed results.
 
 | Level | One-line summary |
 |---|---|
@@ -26,17 +26,17 @@ The authoritative source for terminology, inputs, outputs, and ledger updates is
 
 - Analyze one footage file per run, recording every time in seconds from the uncut source.
 - Never modify the source. Keep outputs at the canonical destination in [workflow.md](workflow.md) to prevent collisions between files with the same name.
-- Invoke `akari media <sub> <target> [options]` under the [`akari media` contract §1 / §2](../../docs/contract-2026-08-29-media-inspect-cli-v0.md). Parse stdout as JSON or JSON Lines; do not call a media backend directly from this workflow.
+- Invoke `akari media <sub> <target> [options]` under the [`akari media` contract §1 / §2](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-08-29-media-inspect-cli-v0.md). Parse stdout as JSON or JSON Lines; do not call a media backend directly from this workflow.
 - Create a 720p proxy only if visual review at L2 or above needs it. At L0 and L1, pass the original file to `probe`, `waveform`, and `transcribe` without making a proxy.
 - Follow contract §2.5 for transcription backend selection. A cloud connection must be registered in `.akari/connections.json` with doctor status `ok`, explicitly selected, and approved by a person through a decision card. Never upload audio by default. Access keys only through `credentials.env` and never print their values in chat, artifacts, or logs.
 - Obtain word timing through `akari media transcribe`, which snaps word starts to speech after silence. Do not use word times from a direct whisper-cli call: its default `offsets` are estimates and place words before speech when initial or inter-sentence silence is present (#92 observed a first word at zero despite two seconds of silence). With flash attention enabled by default, `-dtw <preset>` is silently ineffective unless used with `-nfa` and read from `tokens[].t_dtw`.
 - If no backend is available or no speech is present, do not invent words. Leave `transcript: []` and report why.
 - Write `note` after actually viewing the images used in L2. Do not write findings on unseen images.
 - Create only `filler | trouble | chapter | highlight | hook` events. Record a hook only for a window chosen for scoring, and score all five axes there with integers from 1 to 5.
-- Add no fields outside [analysis.schema.json](../../packages/schemas/analysis.schema.json). Finalize only JSON that passes structural and semantic checks. `keyframes: []` and `events: []` are valid both when L2 was not observed and when nothing qualified; distinguish the cases by the type and range of `observations[]`.
+- Add no fields outside [analysis.schema.json](https://github.com/AkariLabs/akari-video/blob/main/packages/schemas/analysis.schema.json). Finalize only JSON that passes structural and semantic checks. `keyframes: []` and `events: []` are valid both when L2 was not observed and when nothing qualified; distinguish the cases by the type and range of `observations[]`.
 - Do not generate L3 for every file. Generate only the person-track types and intervals needed for the chosen effect. By default, `tracks.person_matte: null`; omit optional person-track keys until generated.
 - Use OpenMontage for structural reference only; do not copy AGPL text or code.
-- Follow the "existing contract sidecars" layer of the [project-structure-v0 contract](../../docs/contract-2026-07-25-project-structure-v0.md) for `.akari/sidecars/` output paths.
+- Follow the "existing contract sidecars" layer of the [project-structure-v0 contract](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-07-25-project-structure-v0.md) for `.akari/sidecars/` output paths.
 
 Pass --lang for the work's content language on transcription calls. The default SpeechAnalyzer backend uses that language when its locale is supported.
 

package/vendor/skills/analyze-footage/analysis-json.md

@@ -8,7 +8,7 @@
 
 ## Principles
 
-Use [packages/schemas/analysis.schema.json](../../packages/schemas/analysis.schema.json) as the sole structural definition. Unknown fields are prohibited at the top level and within objects. Do not add working notes, confidence scores, degraded-result reasons, or generator metadata as extra fields.
+Use [packages/schemas/analysis.schema.json](https://github.com/AkariLabs/akari-video/blob/main/packages/schemas/analysis.schema.json) as the sole structural definition. Unknown fields are prohibited at the top level and within objects. Do not add working notes, confidence scores, degraded-result reasons, or generator metadata as extra fields.
 
 ## Minimum valid form
 
@@ -118,12 +118,12 @@ Track shape:
 }
 ```
 
-Set `person_matte` only after generation and verification; otherwise use `null`. Matte generation is optional and `null` is the default; see [person-matte.md](person-matte.md). A generated matte requires `path` and `fps`; `quality`, `generated_at`, and `tool` are optional. Resolve its relative path from the directory containing `analysis.json`, using `/` as the separator. The [person-matte data contract](../../docs/contract-2026-07-23-analysis-person-matte.md) is authoritative.
+Set `person_matte` only after generation and verification; otherwise use `null`. Matte generation is optional and `null` is the default; see [person-matte.md](person-matte.md). A generated matte requires `path` and `fps`; `quality`, `generated_at`, and `tool` are optional. Resolve its relative path from the directory containing `analysis.json`, using `/` as the separator. The [person-matte data contract](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-07-23-analysis-person-matte.md) is authoritative.
 
 The legacy single-path string (`"mattes/person-alpha.mov"`) may be read as shorthand for `{ "path": ... }`, but must not be written in new data. Each face's speaker ID must exist in `tracks.speakers[].id`.
 `tracks.speakers` also receives `{ id, spans }` from speaker intervals when `--diarize` is selected. Do not store embeddings here either.
 
-Unlike person_matte, `tracks.face_landmarks` and `tracks.hand_pose` are optional keys: omit them entirely when not generated instead of writing `null`. The agent does not assemble these tracks here. `vision-tracks.mjs`, described in [vision-tracks.md](vision-tracks.md), reads and updates the finalized analysis.json directly. Follow the [vision-track data contract](../../docs/contract-2026-08-11-analysis-vision-tracks-v0.md).
+Unlike person_matte, `tracks.face_landmarks` and `tracks.hand_pose` are optional keys: omit them entirely when not generated instead of writing `null`. The agent does not assemble these tracks here. `vision-tracks.mjs`, described in [vision-tracks.md](vision-tracks.md), reads and updates the finalized analysis.json directly. Follow the [vision-track data contract](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-08-11-analysis-vision-tracks-v0.md).
 
 ## Semantic constraints beyond the schema
 

package/vendor/skills/analyze-footage/bin/speechanalyzer-helper.swift

@@ -79,11 +79,28 @@ struct SpeechAnalyzerHelper {
             let statusBefore = await AssetInventory.status(forModules: modules)
             let installStart = ContinuousClock.now
             if statusBefore != .installed {
-                guard let request = try await AssetInventory.assetInstallationRequest(supporting: modules) else {
-                    throw NSError(domain: "SpeechAnalyzerHelper", code: 5,
-                                  userInfo: [NSLocalizedDescriptionKey: "Speech model installation request unavailable"])
+                if let request = try await AssetInventory.assetInstallationRequest(supporting: modules) {
+                    try await request.downloadAndInstall()
+                } else {
+                    // 要求が nil のときは「入れる必要がない（導入済み）」「この OS にモデルが無い」
+                    // 「他で導入中」の区別がつかないため、状態を取り直して理由を分ける。
+                    let statusRetry = await AssetInventory.status(forModules: modules)
+                    let localeId = supportedLocale.identifier
+                    switch statusRetry {
+                    case .installed:
+                        break
+                    case .unsupported:
+                        // 文言の先頭は JS 側の whisper フォールバック判定（Unsupported SpeechTranscriber locale）と揃える
+                        throw NSError(domain: "SpeechAnalyzerHelper", code: 6,
+                                      userInfo: [NSLocalizedDescriptionKey: "Unsupported SpeechTranscriber locale: \(localeId) (this macOS does not provide a SpeechAnalyzer model for \(localeId); asset status: unsupported, before: \(statusName(statusBefore)))"])
+                    case .downloading:
+                        throw NSError(domain: "SpeechAnalyzerHelper", code: 7,
+                                      userInfo: [NSLocalizedDescriptionKey: "The speech model for \(localeId) is still downloading; try again later (asset status: downloading, before: \(statusName(statusBefore)))"])
+                    default:
+                        throw NSError(domain: "SpeechAnalyzerHelper", code: 5,
+                                      userInfo: [NSLocalizedDescriptionKey: "Speech model installation request unavailable for \(localeId) (asset status: \(statusName(statusRetry)), before: \(statusName(statusBefore)))"])
+                    }
                 }
-                try await request.downloadAndInstall()
             }
             let installDuration = ContinuousClock.now - installStart
             let installationSeconds = Double(installDuration.components.seconds)

package/vendor/skills/analyze-footage/events-and-hooks.md

@@ -20,7 +20,7 @@ Some transcription backends normalize away fillers. Prefer a backend transcript
 
 ## Identify highlights: important statements
 
-This section follows the [M5 contract addendum (2026-07-14)](../../docs/contract-2026-07-13-m5-analysis-report.md). A hook supports a short opening or excerpt; a highlight captures an important statement useful to broader editorial decisions. The same interval may be both when it serves both purposes.
+This section follows the [M5 contract addendum (2026-07-14)](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-07-13-m5-analysis-report.md). A hook supports a short opening or excerpt; a highlight captures an important statement useful to broader editorial decisions. The same interval may be both when it serves both purposes.
 
 - Write `quote` **faithfully to the actual transcript**. Do not summarize, paraphrase, or invent words. Formatting is limited to adding punctuation.
 - In `reason`, explain why the statement matters and name the evidence category, such as "states a release date (decision)" or "quantifies an implementation result (number/result)."
@@ -67,11 +67,11 @@ These are **unvalidated starting thresholds**, not official platform success cri
 
 Rank candidates by total score; break ties using `hook`, then `self_contained`, then `density`. This ranking rule also requires validation and is not an absolute measure of quality.
 
-The scale comes from the [M5 analysis.json v0 contract](../../docs/contract-2026-07-13-m5-analysis-report.md).
+The scale comes from the [M5 analysis.json v0 contract](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-07-13-m5-analysis-report.md).
 
 ## Supply evidence for highlight extraction
 
-Later work in [edit-plan's beats.md](../edit-plan/beats.md) derives highlight markers in `edit.json` `beats[]` from the `hook`, `chapter`, and `highlight` events and hook scores recorded here; see the [data contract](../../docs/contract-2026-07-22-edit-json-v1-beats.md). Keep the extraction method above and meet these two additional quality conditions:
+Later work in [edit-plan's beats.md](../edit-plan/beats.md) derives highlight markers in `edit.json` `beats[]` from the `hook`, `chapter`, and `highlight` events and hook scores recorded here; see the [data contract](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-07-22-edit-json-v1-beats.md). Keep the extraction method above and meet these two additional quality conditions:
 
 - **Do not emit an unscored highlight.** If `importance` is absent, later stages cannot determine its strength and will use a default. When a statement is important enough to guide an edit, assign an integer from 1 to 5; omit candidates too weak to assess.
 - **Use source seconds for event time.** The event's `t` and any interval `start` / `end` refer to the uncut source. Beat markers persist source-time anchors, so mixing in timeline seconds creates errors later stages cannot detect.

package/vendor/skills/analyze-footage/keyframes-and-review.md

@@ -4,7 +4,7 @@
 
 ## Principles
 
-Read this file only when L2 is explicitly requested. Use `akari media filmstrip|grab` to generate candidates, then inspect the actual images before recording findings. The [`akari media` contract §1.1 / §2.2 / §2.3](../../docs/contract-2026-08-29-media-inspect-cli-v0.md) governs commands and image limits.
+Read this file only when L2 is explicitly requested. Use `akari media filmstrip|grab` to generate candidates, then inspect the actual images before recording findings. The [`akari media` contract §1.1 / §2.2 / §2.3](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-08-29-media-inspect-cli-v0.md) governs commands and image limits.
 
 ## 1. Scan the source coarsely
 

package/vendor/skills/analyze-footage/media-and-transcript.md

@@ -2,7 +2,7 @@
 
 ## Authoritative contract
 
-The [`akari media` inspection contract v0 §1–§4](../../docs/contract-2026-08-29-media-inspect-cli-v0.md) governs invocation, stdout, output artifacts, ledger updates, and analysis levels. In brief: **observe through `akari media`, make judgments in this skill, and append results to the project's analysis.json**.
+The [`akari media` inspection contract v0 §1–§4](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-08-29-media-inspect-cli-v0.md) governs invocation, stdout, output artifacts, ledger updates, and analysis levels. In brief: **observe through `akari media`, make judgments in this skill, and append results to the project's analysis.json**.
 
 ## L0: probe
 
@@ -43,7 +43,7 @@ akari media transcribe "$SOURCE" --in 120 --out 180 --lang ja
 
 Pass --lang for the work's content language on every transcription call. SpeechAnalyzer receives a matching locale when supported; otherwise the local backend may fall back to whisper.cpp. The command above is a Japanese-language example. Read the relevant language pack for transcription and filler guidance.
 
-The [`akari media` contract §2.5](../../docs/contract-2026-08-29-media-inspect-cli-v0.md) defines the three-layer backend choice, caching, `segments[]` format, no-speech result, and error handling. This skill does not discover backend executables or models or convert input audio itself.
+The [`akari media` contract §2.5](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-08-29-media-inspect-cli-v0.md) defines the three-layer backend choice, caching, `segments[]` format, no-speech result, and error handling. This skill does not discover backend executables or models or convert input audio itself.
 
 ### Separate speakers (only when requested or multiple voices are likely)
 
@@ -60,7 +60,7 @@ akari speakers set "$SOURCE" A --person channel/p-123
 akari speakers list "$SOURCE"
 ```
 
-With `--identify`, compare only against consented (`self` or `subject`) voice samples for channel people. The result is a suggestion; a person decides the name. Confirm even a `strong` match before writing it with `akari speakers set`. Show `maybe` as a candidate for review and leave `none` unnamed. If the voice engine is missing and the command exits 2, do not guess speakers. Stop and guide the user to `akari tools install voice` or preparation in the app's caption creation flow. Follow the [speaker separation contract](../../docs/contract-2026-10-11-speaker-split-v0.md) for flags, output, and destinations.
+With `--identify`, compare only against consented (`self` or `subject`) voice samples for channel people. The result is a suggestion; a person decides the name. Confirm even a `strong` match before writing it with `akari speakers set`. Show `maybe` as a candidate for review and leave `none` unnamed. If the voice engine is missing and the command exits 2, do not guess speakers. Stop and guide the user to `akari tools install voice` or preparation in the app's caption creation flow. Follow the [speaker separation contract](https://github.com/AkariLabs/akari-video/blob/main/docs/contract-2026-10-11-speaker-split-v0.md) for flags, output, and destinations.
 
 
 ### Cloud use requires approval