akari-video 0.1.11 → 0.1.13

package/bin/akari.mjs

@@ -10,6 +10,7 @@ import { runAcceptCommand } from '../src/accept-command.mjs';
 import { runCapabilityCommand } from '../src/capability-command.mjs';
 import { runStoreCommand } from '../src/store-command.mjs';
 import { runAssetsCommand } from '../src/assets-command.mjs';
+import { runMigrateCommand } from '../src/migrate-command.mjs';
 import { maybeApplyPendingUpdateOnLaunch, readOwnVersion } from '../src/update-check.mjs';
 import { describeCliHelp } from '../src/messages.mjs';
 
@@ -67,6 +68,7 @@ const invoke = (argv[0] === '--version' || argv[0] === '-v') ? printVersion()
   : argv[0] === 'capability' ? runCapabilityCommand(argv.slice(1))
   : argv[0] === 'store' ? runStoreCommand(argv.slice(1))
   : argv[0] === 'assets' ? runAssetsCommand(argv.slice(1))
+  : argv[0] === 'migrate' ? runMigrateCommand(argv.slice(1))
   : run(argv);
 
 const result = await invoke.catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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": {
@@ -37,6 +37,6 @@
   "scripts": {
     "prepack": "node scripts/prepack.mjs",
     "postpack": "node scripts/prepack.mjs clean",
-    "test": "node --test test/*.mjs"
+    "test": "node --test --test-concurrency=1 test/*.mjs"
   }
 }

package/src/cli.mjs

@@ -6,7 +6,7 @@ import { resolveLauncherAssets } from './repo-assets.mjs';
 import { detectProjectState } from './project-state.mjs';
 import { findClaudeExecutable, findOpencodeExecutable } from './path-lookup.mjs';
 import { loadTaskLabels } from './task-labels.mjs';
-import { describeIntake, claudeMissingGuidance, opencodeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
+import { describeInstalledVersions, describeIntake, claudeMissingGuidance, opencodeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
 import { resolveEffectiveProjectRoot } from './first-run.mjs';
 import { maybeShowAssetIntroNotice } from './sounds-setup.mjs';
 import {
@@ -14,9 +14,11 @@ import {
   compareVersions,
   isValidFeedShape,
   readCacheSync,
+  readInstalledAppVersion,
   readOwnVersion,
   recordDismissalSync,
   resolveCachePath,
+  resolveInstalledVersionInfo,
   triggerBackgroundRefresh
 } from './update-check.mjs';
 import { applySelfUpdate, isRunningFromAppDir, rollbackSelfUpdate } from './self-update.mjs';
@@ -41,7 +43,8 @@ export async function run(args, options = {}) {
   const spawnOpencode = options.spawnOpencode ?? defaultSpawnOpencode;
   const env = options.env ?? process.env;
   const platform = options.platform ?? process.platform;
-  const currentVersion = options.currentVersion ?? readOwnVersion();
+  const versionInfo = resolveCommandVersionInfo(options, env);
+  const currentVersion = versionInfo.currentVersion;
   const now = options.now ?? new Date();
 
   // --opencode / --claude / --claudecode / --yes / --here フラグを解析
@@ -92,13 +95,13 @@ export async function run(args, options = {}) {
     } catch (error) {
       log(`接続確認でエラーが発生しました（続行します）: ${error instanceof Error ? error.message : String(error)}`);
     }
-    log(describeVersionStatus(currentVersion, readCacheSync(resolveCachePath(env))));
+    log(describeVersionStatus(versionInfo, readCacheSync(resolveCachePath(env))));
   }
 
   // 新版通知（契約 §4-1）: キャッシュの読み比較のみ・ネットワークには一切触れない
   // （起動をブロックしない）。fetch は detached な子プロセスへ切り離し、
   // 結果は次回セッションで効く。
-  const updateNotice = formatUpdateNotice((options.checkUpdate ?? checkForUpdateSync)({ currentVersion, env }));
+  const updateNotice = formatUpdateNotice((options.checkUpdate ?? checkForUpdateSync)({ currentVersion, versionInfo, env }));
   if (updateNotice) {
     log(updateNotice);
   }
@@ -178,22 +181,26 @@ function defaultSpawnOpencode(opencodePath, args, projectRoot) {
 /**
  * `akari update`: 新版があり、かつ自己更新の対象（app 経由実行 + フィードに
  * `components.app` がある）なら DL → sha256 検証 → 適用まで実行する（契約 §11。
+ * `app/.akari-install-ref` がある管理インストールは、npm 側 CLI から実行した場合も対象。
  * 「update は明示操作」なので U2 の沈黙原則は適用せず、失敗は必ず表示する）。
  * 対象外（npm グローバル / git checkout・旧フィード）のときは従来どおり
  * **案内するだけ**（自動実行はしない — 契約 §4-1）に縮退する。`--dismiss` は
  * 自己更新を試みず、キャッシュに載っている最新版の通知を今後出さないよう記録するだけ
- * （既存挙動を維持）。`--rollback` は直前 1 世代（`~/.akari/app-previous/`）へ戻す。
+ * （既存挙動を維持）。`--force` は同じ版の本体も再導入し、`--rollback` は直前 1 世代
+ * （`~/.akari/app-previous/`）へ戻す。
  * ネットワークに触れるのは自己更新の DL 区間のみ — フィード自体は既存キャッシュ由来
  * （最新情報は `akari` 起動時のバックグラウンド fetch で更新される）。
  */
 export async function runUpdateCommand(args, options = {}) {
   const log = options.log ?? ((line) => console.log(line));
   const env = options.env ?? process.env;
-  const currentVersion = options.currentVersion ?? readOwnVersion();
+  const versionInfo = resolveCommandVersionInfo(options, env);
+  const currentVersion = versionInfo.currentVersion;
   const cachePath = resolveCachePath(env);
   const cache = readCacheSync(cachePath);
   const dismissRequested = args.includes('--dismiss');
   const rollbackRequested = args.includes('--rollback');
+  const forceRequested = args.includes('--force');
 
   if (rollbackRequested) {
     return (options.rollbackSelfUpdate ?? rollbackSelfUpdate)({ env, log });
@@ -206,7 +213,7 @@ export async function runUpdateCommand(args, options = {}) {
       dismissed = true;
     }
     const finalCache = dismissed ? readCacheSync(cachePath) : cache;
-    for (const line of describeUpdateCommand({ currentVersion, cache: finalCache, dismissed })) {
+    for (const line of describeUpdateCommand({ currentVersion, versionInfo, cache: finalCache, dismissed })) {
       log(line);
     }
     return { exitCode: 0 };
@@ -214,18 +221,28 @@ export async function runUpdateCommand(args, options = {}) {
 
   const feed = cache?.feed;
   const updateAvailable = isValidFeedShape(feed) && compareVersions(feed.product, currentVersion) > 0;
-  const selfUpdateEligible = updateAvailable
+  const reinstallRequested = forceRequested && isValidFeedShape(feed) && compareVersions(feed.product, currentVersion) >= 0;
+  const hasManagedApp = !!readInstalledAppVersion(env);
+  const selfUpdateEligible = (updateAvailable || reinstallRequested)
     && !!feed.components?.app?.url
     && !!feed.components?.app?.sha256
-    && (options.isRunningFromAppDir ?? isRunningFromAppDir)({ env, launcherRoot: options.launcherRoot });
+    && (hasManagedApp || (options.isRunningFromAppDir ?? isRunningFromAppDir)({ env, launcherRoot: options.launcherRoot }));
 
   if (!selfUpdateEligible) {
-    for (const line of describeUpdateCommand({ currentVersion, cache, dismissed: false })) {
+    for (const line of describeUpdateCommand({ currentVersion, versionInfo, cache, dismissed: false })) {
       log(line);
     }
     return { exitCode: 0 };
   }
 
+  for (const line of describeInstalledVersions(versionInfo)) {
+    log(line);
+  }
+  log(`最新バージョン: v${feed.product}`);
+  if (forceRequested) {
+    log(`--force: 本体 v${currentVersion} を入れ直します。`);
+  }
+
   return (options.applySelfUpdate ?? applySelfUpdate)({
     env,
     feed,
@@ -234,3 +251,19 @@ export async function runUpdateCommand(args, options = {}) {
     runNpmInstall: options.runNpmInstall
   });
 }
+
+function resolveCommandVersionInfo(options, env) {
+  // 既存テスト/埋め込み利用の currentVersion 注入は CLI 版注入としても扱う。
+  const cliVersion = options.cliVersion ?? options.currentVersion ?? readOwnVersion();
+  if (options.currentVersion !== undefined) {
+    const appVersion = options.appVersion ?? null;
+    return {
+      cliVersion,
+      appVersion,
+      currentVersion: options.currentVersion,
+      source: appVersion ? 'install-ref' : 'cli-fallback',
+      mismatch: appVersion !== null && compareVersions(cliVersion, appVersion) !== 0
+    };
+  }
+  return resolveInstalledVersionInfo({ env, cliVersion });
+}

package/src/messages.mjs

@@ -59,18 +59,64 @@ export function opencodeMissingGuidance() {
  */
 export function formatUpdateNotice(status) {
   if (!status?.available) {
+    if (status?.mismatch) {
+      return formatVersionMismatch(status);
+    }
     return null;
   }
-  return `⬆ AKARI Video v${status.latestVersion}${channelSuffix(status.channel)}があります（現在 v${status.currentVersion}）→ 詳細: akari update`;
+  const current = status.mismatch
+    ? `CLI v${status.cliVersion} / 本体 v${status.appVersion} → ${versionRelationLabel(status)}`
+    : `現在 v${status.currentVersion}`;
+  return `⬆ AKARI Video v${status.latestVersion}${channelSuffix(status.channel)}があります（${current}）→ 詳細: akari update`;
 }
 
 /** `akari doctor` 系出力に足す 1 行（現在版 + フィード取得状態）。 */
-export function describeVersionStatus(currentVersion, cache) {
+export function describeVersionStatus(versionOrInfo, cache) {
+  if (typeof versionOrInfo === 'string') {
+    if (!cache?.feed) {
+      return `バージョン: v${versionOrInfo}（更新フィード: 未取得）`;
+    }
+    const fetchedAt = typeof cache.fetched_at === 'string' ? cache.fetched_at : '不明';
+    return `バージョン: v${versionOrInfo}（更新フィード: 取得済み・${fetchedAt} 時点）`;
+  }
+  const info = normalizeVersionInfo(versionOrInfo);
+  const installed = describeInstalledVersions(info).join(' / ');
   if (!cache?.feed) {
-    return `バージョン: v${currentVersion}（更新フィード: 未取得）`;
+    return `${installed}（更新フィード: 未取得）`;
   }
   const fetchedAt = typeof cache.fetched_at === 'string' ? cache.fetched_at : '不明';
-  return `バージョン: v${currentVersion}（更新フィード: 取得済み・${fetchedAt} 時点）`;
+  return `${installed}（更新フィード: 取得済み・${fetchedAt} 時点）`;
+}
+
+export function describeInstalledVersions(versionOrInfo) {
+  const info = normalizeVersionInfo(versionOrInfo);
+  if (!info.appVersion) {
+    return [
+      `現在のバージョン: v${info.currentVersion}`,
+      `CLI バージョン: v${info.cliVersion}`,
+      `本体バージョン: 未記録（更新判定は CLI v${info.currentVersion} へフォールバック）`
+    ];
+  }
+  const lines = [`CLI バージョン: v${info.cliVersion}`, `本体バージョン: v${info.appVersion}（更新判定の基準）`];
+  if (info.mismatch) {
+    lines.push(`版のずれ: CLI v${info.cliVersion} / 本体 v${info.appVersion} → ${versionRelationLabel(info)}`);
+  }
+  return lines;
+}
+
+function normalizeVersionInfo(value) {
+  if (typeof value === 'string') {
+    return { cliVersion: value, appVersion: null, currentVersion: value, mismatch: false };
+  }
+  return value;
+}
+
+function versionRelationLabel(info) {
+  return compareVersions(info.appVersion, info.cliVersion) < 0 ? '本体が古い' : 'CLI と本体の版が不一致';
+}
+
+function formatVersionMismatch(info) {
+  return `⚠ CLI v${info.cliVersion} / 本体 v${info.appVersion} → ${versionRelationLabel(info)}。\`akari update\` で本体を更新してください。`;
 }
 
 /**
@@ -107,8 +153,9 @@ export function creatorRootPromptText(defaultPath) {
  * `akari update` の出力本文（複数行）。フィード未取得・最新・新版ありで案内が変わる。
  * `dismissed` は今回の実行で dismiss 記録を書いたかどうか（表示文言の切り替えのみに使う）。
  */
-export function describeUpdateCommand({ currentVersion, cache, dismissed }) {
-  const lines = [`現在のバージョン: v${currentVersion}`];
+export function describeUpdateCommand({ currentVersion, versionInfo, cache, dismissed }) {
+  const info = versionInfo ?? normalizeVersionInfo(currentVersion);
+  const lines = versionInfo ? describeInstalledVersions(info) : [`現在のバージョン: v${currentVersion}`];
   const feed = cache?.feed;
   if (!feed) {
     lines.push('最新情報をまだ取得できていません（オフライン、または初回起動直後の可能性があります）。');
@@ -121,7 +168,7 @@ export function describeUpdateCommand({ currentVersion, cache, dismissed }) {
     lines.push(`リリースノート: ${feed.notes_url}`);
   }
 
-  if (compareVersions(feed.product, currentVersion) <= 0) {
+  if (compareVersions(feed.product, info.currentVersion) <= 0) {
     lines.push('お使いのバージョンは最新です。');
     return lines;
   }
@@ -222,8 +269,9 @@ export function describeCliHelp() {
     '  (引数なし)              プロジェクトを開いて AI エージェントを起動（未作成なら自動作成）',
     '  store connect          アカウント連携（無料の素材パックと購入済み素材が使えるようになる）',
     '  sounds                 公式音源ライブラリを一括ダウンロード（無料）',
-    '  update                 更新を確認する',
+    '  update [--force]       更新を確認する（--force で本体を入れ直す）',
     '  status                 接続状態を確認する',
+    '  migrate [dir]          古い edit.json を退避バックアップ付きで v2 へ変換',
     '',
     '開発者向け:',
     '  --opencode              Claude Code の代わりに opencode を起動する',

package/src/migrate-command.mjs

@@ -0,0 +1,127 @@
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+
+const require = createRequire(import.meta.url);
+
+export async function runMigrateCommand(args, options = {}) {
+  const log = options.log ?? ((line) => console.log(line));
+  const error = options.error ?? ((line) => console.error(line));
+  const cwd = options.cwd ?? process.cwd();
+  const parsed = parseArguments(args, cwd);
+  if (!parsed.ok) {
+    error(parsed.message);
+    return { exitCode: 2 };
+  }
+  if (parsed.help) {
+    for (const line of migrateHelp()) log(line);
+    return { exitCode: 0 };
+  }
+  const projectRoot = parsed.projectRoot;
+  const editPath = path.join(projectRoot, 'edit.json');
+  let text;
+  try {
+    text = await (options.readFile ?? readFile)(editPath, 'utf8');
+  } catch (cause) {
+    error(`edit.json を読めません: ${editPath} (${messageOf(cause)})`);
+    return { exitCode: 2 };
+  }
+  const migrate = options.migrate ?? loadMigrateModule(options.assets ?? resolveLauncherAssets());
+  const proposal = migrate.planMigration(projectRoot, editPath, text, { now: options.now });
+  if (proposal.ok === false) {
+    if (parsed.json) {
+      log(JSON.stringify({ ok: false, error: 'このプロジェクトは変換できません', blockers: proposal.blockers }));
+    } else {
+      error('このプロジェクトは変換できません。');
+      for (const blocker of proposal.blockers) error(`- ${blocker}`);
+    }
+    return { exitCode: 2 };
+  }
+  if (parsed.json) {
+    log(JSON.stringify({
+      ok: true, dryRun: parsed.dryRun, version: proposal.version,
+      filePath: proposal.filePath, backupPath: proposal.backupPath, changes: proposal.changes
+    }));
+  } else {
+    log(`変換対象: ${proposal.filePath} (version ${proposal.version} -> 2)`);
+    for (const change of proposal.changes) log(`- ${change.path}: ${change.note}`);
+    log(`変換前の退避先: ${proposal.backupPath}`);
+  }
+  if (parsed.dryRun) {
+    if (!parsed.json) log('--dry-run のため、ファイルは変更しません。');
+    return { exitCode: 0, proposal };
+  }
+  if (!parsed.yes) {
+    const isTTY = options.isTTY ?? (process.stdin.isTTY && process.stdout.isTTY);
+    if (!isTTY) {
+      error('非 TTY では明示承認が必要です。内容を確認し、--yes を付けて再実行してください。');
+      return { exitCode: 2, proposal };
+    }
+    const accepted = options.confirm
+      ? await options.confirm()
+      : await promptForConfirmation();
+    if (!accepted) {
+      if (!parsed.json) log('変換しませんでした。edit.json は変更されていません。');
+      return { exitCode: 0, proposal };
+    }
+  }
+  await migrate.applyMigration(proposal);
+  if (!parsed.json) log(`version 2 へ変換しました。元ファイル: ${proposal.backupPath}`);
+  return { exitCode: 0, proposal };
+}
+
+function loadMigrateModule(assets) {
+  const modulePath = path.join(assets.repoRoot, 'packages', 'edit-store', 'lib', 'migrate', 'index.js');
+  try {
+    return require(modulePath);
+  } catch (cause) {
+    throw new Error(`変換器を読み込めません: ${modulePath} (${messageOf(cause)})`);
+  }
+}
+
+function parseArguments(args, cwd) {
+  const flags = new Set(args.filter(value => value.startsWith('-')));
+  const unknown = [...flags].filter(value => !['--yes', '-y', '--dry-run', '--json', '--help', '-h'].includes(value));
+  if (unknown.length > 0) return { ok: false, message: `未知のオプションです: ${unknown.join(', ')}` };
+  const positional = args.filter(value => !value.startsWith('-'));
+  if (positional.length > 1) return { ok: false, message: '引数のプロジェクトディレクトリは 1 つだけ指定できます。' };
+  return {
+    ok: true,
+    help: flags.has('--help') || flags.has('-h'),
+    yes: flags.has('--yes') || flags.has('-y'),
+    dryRun: flags.has('--dry-run'),
+    json: flags.has('--json'),
+    projectRoot: path.resolve(cwd, positional[0] ?? '.')
+  };
+}
+
+async function promptForConfirmation() {
+  const readline = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await readline.question('上記の内容で version 2 へ変換しますか? [y/N] ');
+    return /^(?:y|yes)$/iu.test(answer.trim());
+  } finally {
+    readline.close();
+  }
+}
+
+export function migrateHelp() {
+  return [
+    '使い方: akari migrate [dir] [--yes] [--dry-run] [--json]',
+    '',
+    'v0/v1 の edit.json を v2 へ片道変換します。',
+    '既定は変更内容を表示して y/n で確認し、変換前の全文を .akari/backup/ へ退避します。',
+    '',
+    '  --yes, -y   表示後の確認を省略',
+    '  --dry-run   提案の表示だけで書き込まない',
+    '  --json      機械可読な JSON を出力',
+    '  --help, -h  このヘルプを表示'
+  ];
+}
+
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}

package/src/self-update.mjs

@@ -378,6 +378,10 @@ export function rollbackSelfUpdate({ env = process.env, log = () => {} } = {}) {
   }
 
   const version = readVersionAt(appDir);
+  if (version) {
+    // install-ref が無い古い app-previous へ戻した場合も、以後の更新判定を本体版基準に保つ。
+    writeFileSync(join(appDir, '.akari-install-ref'), `v${version}\n`, 'utf8');
+  }
   log(version ? `v${version} へロールバックしました` : 'ロールバックしました');
   return { exitCode: 0, rolledBack: true, version };
 }

package/src/status-command.mjs

@@ -8,6 +8,8 @@ import {
   serializeWorkspaceStatus,
   formatWorkspaceStatusSummary,
 } from "./status-core/status.mjs";
+import { describeVersionStatus } from "./messages.mjs";
+import { readCacheSync, readOwnVersion, resolveCachePath, resolveInstalledVersionInfo } from "./update-check.mjs";
 
 export async function runStatusCommand(argv, options = {}) {
   const log = options.log ?? ((line) => process.stdout.write(line));
@@ -19,18 +21,24 @@ export async function runStatusCommand(argv, options = {}) {
     error(cause instanceof Error ? cause.message : String(cause));
     return { exitCode: 2 };
   }
+  const env = options.env ?? process.env;
+  const versionInfo = options.versionInfo ?? resolveInstalledVersionInfo({
+    env,
+    cliVersion: options.cliVersion ?? readOwnVersion(),
+  });
+  const versionLine = describeVersionStatus(versionInfo, readCacheSync(resolveCachePath(env)));
   if (detectStatusScope(parsed.projectRoot) === "workspace") {
     const workspace = resolveWorkspaceStatus(parsed.projectRoot);
     // fail-safe: a broken root.json falls through to the unchanged project-scope path below.
     if (workspace) {
-      log(parsed.json ? serializeWorkspaceStatus(workspace) : `${formatWorkspaceStatusSummary(workspace)}\n`);
+      log(parsed.json ? serializeWorkspaceStatus(workspace) : `${versionLine}\n${formatWorkspaceStatusSummary(workspace)}\n`);
       return { exitCode: 0, workspace };
     }
   }
   const status = parsed.full
     ? await resolveFullProjectStatus(parsed.projectRoot)
     : resolveProjectStatus(parsed.projectRoot, { mode: "fast" });
-  log(parsed.json ? serializeStatus(status) : `${formatStatusOutput(status)}\n`);
+  log(parsed.json ? serializeStatus(status) : `${versionLine}\n${formatStatusOutput(status)}\n`);
   return { exitCode: status.state_health === "inconclusive" ? 1 : 0, status };
 }
 

package/src/status-core/status.mjs

@@ -7,6 +7,7 @@ import { resolveProjectDisplayName } from "./display-name.mjs";
 import { inspectFullIntegrity } from "./integrity.mjs";
 import { validateAndCountReview } from "./review.mjs";
 
+
 export {
   detectStatusScope,
   resolveWorkspaceStatus,
@@ -218,30 +219,38 @@ function validatePlan(value, problems) {
 
 function validateEdit(value, problems) {
   if (!value) return;
-  if (value.version !== 0 && value.version !== 1) {
+  if (value.version !== 2) {
     problems.push(`edit.json has unsupported version ${String(value.version)}`);
     return;
   }
-  if (!isRecord(value.output) || !Array.isArray(value.overlays)) problems.push("edit.json has an invalid output/overlays shape");
-  if (value.version === 0) {
-    if (!isNonEmptyString(value.source?.path) || Object.hasOwn(value, "sources")) problems.push("edit.json v0 source shape is invalid");
-  } else {
-    if (!Array.isArray(value.sources) || Object.hasOwn(value, "source") || !Array.isArray(value.cuts)) {
-      problems.push("edit.json v1 sources/cuts shape is invalid");
+  if (!isRecord(value.output) || !Array.isArray(value.sources) || !Array.isArray(value.tracks)) {
+    problems.push("edit.json v2 has an invalid output/sources/tracks shape");
+    return;
+  }
+  const sourceIds = new Set();
+  for (const source of value.sources) {
+    if (!isNonEmptyString(source?.id) || !isNonEmptyString(source?.path) || sourceIds.has(source.id)) {
+      problems.push("edit.json v2 sources are invalid or duplicated");
       return;
     }
-    const ids = new Set();
-    for (const source of value.sources) {
-      if (!isNonEmptyString(source?.id) || !isNonEmptyString(source?.path) || ids.has(source.id)) {
-        problems.push("edit.json v1 sources are invalid or duplicated");
-        break;
-      }
-      ids.add(source.id);
+    sourceIds.add(source.id);
+  }
+  const trackIds = new Set();
+  for (const track of value.tracks) {
+    const hasItems = Array.isArray(track?.items);
+    const hasContent = isRecord(track?.content);
+    if (!isNonEmptyString(track?.id) || trackIds.has(track.id)
+      || (track?.lane !== "visual" && track?.lane !== "audio") || hasItems === hasContent) {
+      problems.push("edit.json v2 tracks are invalid or duplicated");
+      return;
     }
-    for (const cut of value.cuts) {
-      if (!isRecord(cut) || !ids.has(cut.src)) {
-        problems.push(`edit.json cut references unknown source ${String(cut?.src)}`);
-        break;
+    trackIds.add(track.id);
+    if (!hasItems) continue;
+    for (const item of track.items) {
+      if (!isRecord(item) || !isRecord(item.source)
+        || (item.source.kind === "media" && !sourceIds.has(item.source.src))) {
+        problems.push(`edit.json v2 item references unknown source ${String(item?.source?.src)}`);
+        return;
       }
     }
   }
@@ -270,14 +279,14 @@ function resolveMaterialState({ projectRoot, edit, interpretation, problems, war
   let fixed = false;
   if (edit) {
     fixed = true;
-    if (edit.version === 0 && isNonEmptyString(edit.source?.path)) {
-      sources = [resolveProjectPath(projectRoot, edit.source.path, "edit source", problems)];
-    } else if (edit.version === 1 && Array.isArray(edit.sources) && Array.isArray(edit.cuts)) {
-      const usedIds = new Set(edit.cuts.map((cut) => cut?.src));
-      sources = edit.sources
-        .filter((source) => usedIds.has(source.id))
-        .map((source) => resolveProjectPath(projectRoot, source.path, `edit source ${source.id}`, problems));
-    }
+    const mainVisualTrack = Array.isArray(edit.tracks)
+      ? edit.tracks.find(track => track?.lane === "visual" && Array.isArray(track.items)) : null;
+    const usedIds = new Set((mainVisualTrack?.items ?? [])
+      .filter(item => item?.source?.kind === "media")
+      .map(item => item.source.src));
+    sources = (Array.isArray(edit.sources) ? edit.sources : [])
+      .filter(source => usedIds.has(source?.id) && isNonEmptyString(source?.path))
+      .map(source => resolveProjectPath(projectRoot, source.path, `edit source ${source.id}`, problems));
   } else if (interpretation && Array.isArray(interpretation.inputs?.analyses)) {
     fixed = true;
     for (const [index, entry] of interpretation.inputs.analyses.entries()) {

package/src/update-check.mjs

@@ -55,12 +55,43 @@ export function resolveCachePath(env = process.env) {
   return join(resolveAkariHome(env), 'update-check.json');
 }
 
+export function resolveInstallRefPath(env = process.env) {
+  return join(resolveAkariHome(env), 'app', '.akari-install-ref');
+}
+
 /** launcher 自身の package.json version（D3 裁定により現状はプロダクト版と一致）。 */
 export function readOwnVersion() {
   const raw = readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8');
   return JSON.parse(raw).version;
 }
 
+/**
+ * 実際に render-cut / edit-lint を実行する本体の導入版。
+ * install.sh / self-update.mjs が書く `vX.Y.Z` を読み、無い・壊れている場合は null。
+ */
+export function readInstalledAppVersion(env = process.env) {
+  try {
+    const raw = readFileSync(resolveInstallRefPath(env), 'utf8').trim();
+    const match = raw.match(/^v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/);
+    return match?.[1] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+/** 更新判定に使う版と、CLI / 本体のずれを一度に解決する。 */
+export function resolveInstalledVersionInfo({ env = process.env, cliVersion = readOwnVersion() } = {}) {
+  const installedAppVersion = readInstalledAppVersion(env);
+  const currentVersion = installedAppVersion ?? cliVersion;
+  return {
+    cliVersion,
+    appVersion: installedAppVersion,
+    currentVersion,
+    source: installedAppVersion ? 'install-ref' : 'cli-fallback',
+    mismatch: installedAppVersion !== null && compareVersions(cliVersion, installedAppVersion) !== 0
+  };
+}
+
 /** "major.minor.patch" の先頭 3 要素だけを数値比較する（prerelease 考慮不要 — 契約 D4: stable のみ）。 */
 export function compareVersions(a, b) {
   const pa = parseVersionTriplet(a);
@@ -104,23 +135,25 @@ function writeCacheSync(cachePath, cache) {
 /**
  * キャッシュと現在版から、新版通知を出すべきかを判定する（同期・純粋関数・I/O なし）。
  */
-export function evaluateUpdateStatus({ currentVersion, cache }) {
+export function evaluateUpdateStatus({ currentVersion, cache, cliVersion = currentVersion, appVersion = null, source = 'cli-fallback', mismatch = false }) {
+  const versionDetails = { currentVersion, cliVersion, appVersion, source, mismatch };
   const feed = cache?.feed;
   if (!isValidFeedShape(feed)) {
-    return { available: false };
+    return { available: false, ...versionDetails };
   }
   const latest = feed.product;
   if (compareVersions(latest, currentVersion) <= 0) {
-    return { available: false };
+    return { available: false, latestVersion: latest, ...versionDetails };
   }
   const dismissedAt = cache?.dismissed?.[latest];
-  if (dismissedAt) {
-    return { available: false, dismissed: true, latestVersion: latest };
+  // CLI と本体の取り残しは release 通知の dismiss より強い。黙って古い本体を使わせない。
+  if (dismissedAt && !mismatch) {
+    return { available: false, dismissed: true, latestVersion: latest, ...versionDetails };
   }
   return {
     available: true,
     latestVersion: latest,
-    currentVersion,
+    ...versionDetails,
     channel: typeof feed.channel === 'string' ? feed.channel : undefined,
     notesUrl: typeof feed.notes_url === 'string' ? feed.notes_url : undefined,
     cli: feed.components?.cli
@@ -131,9 +164,13 @@ export function evaluateUpdateStatus({ currentVersion, cache }) {
  * `akari` 起動時の同期チェック。ファイルの読み比較のみ（ネットワーク I/O 無し）。
  * fetch 関数への参照すら持たない — 「起動をブロックしない」を構造で保証する。
  */
-export function checkForUpdateSync({ currentVersion, env = process.env } = {}) {
+export function checkForUpdateSync({ currentVersion, versionInfo, env = process.env } = {}) {
   const cache = readCacheSync(resolveCachePath(env));
-  return evaluateUpdateStatus({ currentVersion, cache });
+  const versions = versionInfo
+    ?? (currentVersion === undefined
+      ? resolveInstalledVersionInfo({ env })
+      : { cliVersion: currentVersion, appVersion: null, currentVersion, source: 'cli-fallback', mismatch: false });
+  return evaluateUpdateStatus({ ...versions, currentVersion: currentVersion ?? versions.currentVersion, cache });
 }
 
 /** 「この版の通知を今後出さない」を記録する（同期・ローカル I/O のみ）。 */
@@ -157,6 +194,7 @@ export function recordDismissalSync({ version, env = process.env, now = new Date
  *
  * `launcherRoot` はテスト用の注入口（`isRunningFromAppDir` へそのまま渡す。
  * `runUpdateCommand` の `options.launcherRoot` と同じ流儀）。
+ * app 外から動く npm CLI でも install-ref があれば管理本体を staging 対象にする。
  */
 export async function maybeStageInBackground({ env = process.env, feed, fetchImpl = globalThis.fetch, timeoutMs, extract, launcherRoot } = {}) {
   if (env.AKARI_NO_AUTO_UPDATE === '1') {
@@ -166,10 +204,11 @@ export async function maybeStageInBackground({ env = process.env, feed, fetchImp
   if (!appComponent?.url || !appComponent?.sha256) {
     return null;
   }
-  if (compareVersions(feed.product, readOwnVersion()) <= 0) {
+  if (compareVersions(feed.product, resolveInstalledVersionInfo({ env }).currentVersion) <= 0) {
     return null;
   }
-  if (!isRunningFromAppDir({ env, launcherRoot })) {
+  // npm 側 CLI と本体が分離していても、install-ref があれば管理対象の本体を更新できる。
+  if (!isRunningFromAppDir({ env, launcherRoot }) && !readInstalledAppVersion(env)) {
     return null;
   }
   // 沈黙原則（U2 を継承）: staging の失敗メッセージはどこにも表示しない（log は no-op）。

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

@@ -39,6 +39,7 @@
     "docs/contract-2026-08-12-still-image-cut-source-v0.md",
     "docs/contract-2026-08-13-avatar-drive-v0.md",
     "docs/contract-2026-08-14-avatar-vrm-v0.md",
+    "docs/contract-2026-08-18-v1-render-parity.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",