akari-video 0.1.12 → 0.1.14

package/bin/akari.mjs

@@ -11,14 +11,19 @@ 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';
+import { maybeApplyPendingUpdateOnLaunch, resolveInstalledVersionInfo } from '../src/update-check.mjs';
+import { describeCliHelp, describeInstalledVersions } from '../src/messages.mjs';
 
 // `akari --version` / `-v`: インストール済みの版を表示するだけの最小コマンド
 // （タスク契約 2026-08-11-update-u4-cli-self-update の受け入れ条件 —
 // `akari update` / `--rollback` 後にインストール先の版を観測する手段として必要）。
 async function printVersion() {
-  console.log(`v${readOwnVersion()}`);
+  const versionInfo = resolveInstalledVersionInfo({ env: process.env });
+  // 1 行目は update / rollback の既存機械観測契約として CLI 版だけを維持する。
+  console.log(`v${versionInfo.cliVersion}`);
+  for (const line of describeInstalledVersions(versionInfo)) {
+    console.log(line);
+  }
   return { exitCode: 0 };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -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 { describeForceReinstall, describeInstalledVersions, describeIntake, claudeMissingGuidance, opencodeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
 import { resolveEffectiveProjectRoot } from './first-run.mjs';
 import { maybeShowAssetIntroNotice } from './sounds-setup.mjs';
 import {
@@ -16,7 +16,9 @@ import {
   readCacheSync,
   readOwnVersion,
   recordDismissalSync,
+  refreshUpdateFeed,
   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/`）へ戻す。
- * ネットワークに触れるのは自己更新の DL 区間のみ — フィード自体は既存キャッシュ由来
- * （最新情報は `akari` 起動時のバックグラウンド fetch で更新される）。
+ * （既存挙動を維持）。`--force` は同じ版の本体も再導入し、`--rollback` は直前 1 世代
+ * （`~/.akari/app-previous/`）へ戻す。
+ * 通常時にネットワークへ触れるのは自己更新の DL 区間のみ。`--force` だけはキャッシュが
+ * 未取得なら、復旧経路を塞がないためフィードの同期取得を 1 回試す。
  */
 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);
+  let 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,26 +213,41 @@ 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 };
   }
 
+  if (forceRequested && !cache?.feed) {
+    await (options.refreshUpdateFeed ?? refreshUpdateFeed)({ env, fetchImpl: options.fetchImpl });
+    cache = readCacheSync(cachePath);
+  }
+
   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 = versionInfo.managedApp === true;
+  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(describeForceReinstall(versionInfo, feed.product));
+  }
+
   return (options.applySelfUpdate ?? applySelfUpdate)({
     env,
     feed,
@@ -234,3 +256,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,83 @@ 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.installRefNeedsRepair) {
+    const installRefPath = info.installRefPath ?? '~/.akari/app/.akari-install-ref';
+    return [
+      `CLI バージョン: v${info.cliVersion}`,
+      `本体版を判定できません（\`${installRefPath}\` が壊れています）。`,
+      '修復するには `akari update --force` を実行してください。'
+    ];
+  }
+  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;
+}
+
+export function describeForceReinstall(versionOrInfo, targetVersion) {
+  const info = normalizeVersionInfo(versionOrInfo);
+  return info.installRefNeedsRepair
+    ? `--force: 版を判定できない本体 → v${targetVersion} を入れ直します。`
+    : `--force: 本体 v${info.currentVersion} → v${targetVersion} を入れ直します。`;
+}
+
+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) {
+  const relation = versionRelationLabel(info);
+  const guidance = relation === '本体が古い'
+    ? '`akari update` で本体を更新してください。'
+    : '`npm i -g akari-video@latest` で CLI を更新してください。';
+  return `⚠ CLI v${info.cliVersion} / 本体 v${info.appVersion} → ${relation}。${guidance}`;
 }
 
 /**
@@ -107,8 +172,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 +187,12 @@ export function describeUpdateCommand({ currentVersion, cache, dismissed }) {
     lines.push(`リリースノート: ${feed.notes_url}`);
   }
 
-  if (compareVersions(feed.product, currentVersion) <= 0) {
+  if (info.installRefNeedsRepair) {
+    lines.push('本体版を判定できないため、更新判定を行いません。');
+    return lines;
+  }
+
+  if (compareVersions(feed.product, info.currentVersion) <= 0) {
     lines.push('お使いのバージョンは最新です。');
     return lines;
   }
@@ -222,7 +293,7 @@ export function describeCliHelp() {
     '  (引数なし)              プロジェクトを開いて AI エージェントを起動（未作成なら自動作成）',
     '  store connect          アカウント連携（無料の素材パックと購入済み素材が使えるようになる）',
     '  sounds                 公式音源ライブラリを一括ダウンロード（無料）',
-    '  update                 更新を確認する',
+    '  update [--force]       更新を確認する（--force で本体を入れ直す）',
     '  status                 接続状態を確認する',
     '  migrate [dir]          古い edit.json を退避バックアップ付きで v2 へ変換',
     '',

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/update-check.mjs

@@ -55,12 +55,63 @@ 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;
 }
 
+/** install-ref を「有効・未記録・破損」の 3 状態で読む内部表現。 */
+function readInstalledAppVersionInfo(env = process.env) {
+  const path = resolveInstallRefPath(env);
+  try {
+    const raw = readFileSync(path, 'utf8').trim();
+    const match = raw.match(/^v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/);
+    return match
+      ? { status: 'valid', version: match[1], path }
+      : { status: 'invalid', version: null, path };
+  } catch (error) {
+    return {
+      status: error?.code === 'ENOENT' ? 'missing' : 'invalid',
+      version: null,
+      path
+    };
+  }
+}
+
+/**
+ * 実際に render-cut / edit-lint を実行する本体の導入版。
+ * install.sh / self-update.mjs が書く `vX.Y.Z` を読む。互換 API として版または null を返し、
+ * 未記録と破損の区別は `resolveInstalledVersionInfo()` が保持する。
+ */
+export function readInstalledAppVersion(env = process.env) {
+  return readInstalledAppVersionInfo(env).version;
+}
+
+/** 更新判定に使う版と、CLI / 本体のずれを一度に解決する。 */
+export function resolveInstalledVersionInfo({ env = process.env, cliVersion = readOwnVersion() } = {}) {
+  const installRef = readInstalledAppVersionInfo(env);
+  const installedAppVersion = installRef.version;
+  const currentVersion = installedAppVersion ?? cliVersion;
+  return {
+    cliVersion,
+    appVersion: installedAppVersion,
+    currentVersion,
+    source: installRef.status === 'valid'
+      ? 'install-ref'
+      : installRef.status === 'invalid' ? 'invalid-install-ref' : 'cli-fallback',
+    installRefStatus: installRef.status,
+    installRefPath: installRef.path,
+    installRefNeedsRepair: installRef.status === 'invalid',
+    managedApp: installRef.status !== 'missing',
+    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 +155,35 @@ function writeCacheSync(cachePath, cache) {
 /**
  * キャッシュと現在版から、新版通知を出すべきかを判定する（同期・純粋関数・I/O なし）。
  */
-export function evaluateUpdateStatus({ currentVersion, cache }) {
+export function evaluateUpdateStatus({ currentVersion, cache, cliVersion = currentVersion, appVersion = null, source = 'cli-fallback', installRefStatus, installRefPath, installRefNeedsRepair, managedApp, mismatch = false }) {
+  const versionDetails = {
+    currentVersion,
+    cliVersion,
+    appVersion,
+    source,
+    installRefStatus,
+    installRefPath,
+    installRefNeedsRepair,
+    managedApp,
+    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 +194,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 +224,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,26 +234,19 @@ 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）。
   return stageSelfUpdate({ env, feed, log: () => {}, fetchImpl, timeoutMs, extract });
 }
 
-/**
- * バックグラウンド fetch 本体。fetch 失敗・非 200・JSON パース失敗・スキーマ不明は
- * すべて沈黙して return する（何も throw しない）。`dismissed` は既存キャッシュから
- * 引き継ぐ（fetch のたびに既読状態が消えないように）。
- *
- * フィード取得・キャッシュ反映が成功した後、契約 §11 のバックグラウンド staging も
- * 同じ沈黙原則のもとで試みる（`maybeStageInBackground`）。成功したときだけ
- * キャッシュへ `staged`（版・sha256・staged_at）を追記する。
- */
-export async function runBackgroundFetch({ env = process.env, fetchImpl = globalThis.fetch, launcherRoot } = {}) {
+/** フィードを 1 回取得し、正常なら既読状態を保ったままキャッシュへ反映する。 */
+export async function refreshUpdateFeed({ env = process.env, fetchImpl = globalThis.fetch } = {}) {
   const feedUrl = resolveFeedUrl(env);
   const cachePath = resolveCachePath(env);
   try {
@@ -202,15 +263,34 @@ export async function runBackgroundFetch({ env = process.env, fetchImpl = global
     }
     const feed = await response.json();
     if (!isValidFeedShape(feed)) {
-      return;
+      return null;
     }
     const existing = readCacheSync(cachePath);
-    writeCacheSync(cachePath, {
+    const next = {
       schema: CACHE_SCHEMA,
       fetched_at: new Date().toISOString(),
       feed,
       dismissed: existing?.dismissed ?? {}
-    });
+    };
+    writeCacheSync(cachePath, next);
+    return next;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * バックグラウンド fetch 本体。フィード取得失敗は沈黙し、成功後は契約 §11 の staging を
+ * 同じ沈黙原則で試す。成功したときだけキャッシュへ `staged` を追記する。
+ */
+export async function runBackgroundFetch({ env = process.env, fetchImpl = globalThis.fetch, launcherRoot } = {}) {
+  const cachePath = resolveCachePath(env);
+  try {
+    const refreshed = await refreshUpdateFeed({ env, fetchImpl });
+    const feed = refreshed?.feed;
+    if (!feed) {
+      return;
+    }
 
     const staged = await maybeStageInBackground({ env, feed, fetchImpl, launcherRoot });
     if (staged?.ok) {

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

@@ -40,6 +40,7 @@
     "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",
+    "docs/contract-2026-08-23-stroke-persistence.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",

package/vendor/docs/contract-2026-07-17-data-contract-versioning.md

@@ -91,3 +91,9 @@ edit.json の `version` は変わらないし、edit.json が `version: 1` に
 - 本体から外した後のエラー文言は次で固定する。
 
   > このプロジェクトは古い形式です。`npx akari-migrate@<版> <dir>` で変換してから開いてください。
+
+### 6.1 音声トラック化（2026-08-21・凍結前の最後の追加）
+
+task `2026-08-20-v2-audio-tracks` に限り、「機能追加禁止・バグ修正のみ」の明示承認済み・1 回限りの例外として、v0/v1 の `audio.sfx[]`・`audio.narration[]`・`audio.bgm` を v2 の audio lane `tracks[].items[]` へ移す変換を追加した。出力側の `at` / `duration` は整数フレームへ確定し、素材側の `in` / `out` と fade / `bgm.in` は秒のまま保持する。実尺が旧形式だけでは決まらない音声は `duration: 0` センチネルとし、この変換器では ffprobe しない。トップレベル `audio` は `master` が宣言されている場合だけ残す。
+
+これは凍結前に許可された最後の機能追加である。今後この変換器へさらに変換能力を足さず、§6 の期限どおり本体から分離・削除する。

package/vendor/docs/contract-2026-07-25-r6-audio-tracks-and-trim.md

@@ -66,7 +66,7 @@
 
 ## 5. §2 追記 — sfx フェード（audio-clip-fades, 2026-08-18・オーナー裁定「クリップ主義」T2）
 
-BGM をクリップ化する裁定（内部リポ `tasks/2026-08-18-bgm-clip-placement-ruling`）に伴い、
+BGM をクリップ化する裁定（内部リポ `akari-video-internal` の該当タスク）に伴い、
 「音楽をクリップ（audio.sfx[]）として置いても BGM ベッドと同じフェード表現ができる」を
 満たすため、`sfxItem` に optional の `fade_in` / `fade_out`（秒・0 以上）を追加のみ拡張する
 （`version` 不変・`contract-2026-07-17-data-contract-versioning.md` の原則に従う）。

package/vendor/docs/contract-2026-08-23-stroke-persistence.md

@@ -0,0 +1,75 @@
+---
+lifecycle: implemented
+created: 2026-08-23
+updated: 2026-08-23
+---
+
+# 注釈ストローク永続表示契約
+
+- 日付: 2026-08-23
+- 状態: **実装済み**
+- 前提: `contract-2026-08-11-review-session-ui-events.md`、
+  `contract-2026-07-20-review-json-v1-annotation-model.md`
+- スコープ: Theia shell の出力プレビュー、review session の `strokes.json` 読み出し、
+  compile-review-session と address-review の追跡導線
+
+## 1. セッション中の表示
+
+- pen / rect は従来どおり正規化座標（プレビューフレーム左上を `(0, 0)`、右下を `(1, 1)`）で
+  記録する。表示時に現在の content rect へ写像し直すため、ウィンドウのリサイズと出力比率の
+  変更で座標は変わらない。
+- pointerup 後は従来のグロー・きらめき・600 ms フェードをそのまま再生し、その後段の静的
+  ビットマップへ同じ正規化図形を残す。新しい録音セッションの開始時に前セッションの表示を
+  クリアし、録音終了では消さない。
+- 描線 canvas は非描画モードで `pointer-events: none` とする。ペンまたは四角モードのドラッグ中
+  だけ既存どおり入力面になる。
+- 注釈パネルの「描線を表示」チェックは既定 ON。OFF は残留描線と明示的に再表示した描線を隠し、
+  データを削除しない。ON に戻すと保持した正規化座標から即時再描画する。
+
+## 2. 既存セッションの読み出しと再表示
+
+`readReviewSessionStrokes({projectRootUri, sessionId})` は
+`review/sessions/<sessionId>/strokes.json` を読み、次を返す。
+
+```jsonc
+{
+  "sessionId": "s-0001",
+  "strokes": [/* pen / rect。frame と recTStart/recTEnd を保持 */],
+  "warnings": []
+}
+```
+
+- `strokes.json` 欠落は `strokes: []` として正常終了する。
+- 配列ルート、または `version: 1` でない `{strokes:[]}` は旧形式として寛容に読む。
+- JSON 破損、未知要素、値域外要素は描線単位で除外して warning に残す。セッション一覧と他の
+  描線を巻き込んで失敗させない。
+- 注釈パネルの各録音済みセッションにある「描線」から再表示できる。表示メッセージには
+  `target.tab`（edit URI）と先頭ストロークの `target.recT` を添え、`frame.sourceT/cutIndex` で
+  プレビューを同じフレームへシークする。
+
+## 3. compile 後の原本参照
+
+review.json の data `version` は 0 のまま据え置く。compile-review-session はペアになった pen / rect
+へ、既存フィールドを変えず次の任意フィールドを追加する。
+
+```jsonc
+"strokeRefs": [{
+  "sessionId": "s-0001",
+  "strokeId": "st-0001",
+  "sessionRef": "s-0001/st-0001"
+}]
+```
+
+- `strokeRefs` は `null`、省略、または 1 件以上の配列。欠落は従来データとして正常である。
+- pen は従来どおり最大 100 点の `strokes[].points` も埋め込み、`strokeRefs` から無加工の原本へ
+  戻れる。rect は従来どおり `targetKind:"region"` + `region.box` を埋め込み、同じ `strokeRefs`
+  から `strokes.json` 内の rect 原本へ戻れる。
+- address-review の一覧は `strokeRefs` を
+  `review/sessions/<sessionId>/strokes.json#<strokeId>` として表示する。
+
+## 4. 互換性
+
+- 追加フィールドのみを使い、既存フィールドの削除・意味変更・data version bump は行わない。
+- 読み手は未知フィールドを保持し、任意フィールドの欠落を旧データとして扱い、既知より大きい
+  data version を推測変換しない。
+- `packages/preview-server` は本契約の対象外であり、WebUI の表示挙動は変更しない。