akari-video 0.1.12 → 0.1.13

package/package.json

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

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,7 +269,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,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/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/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.12",
+  "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 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Run them from a full AKARI Video app installation (normally ~/.akari/app) or a monorepo checkout.]",
   "type": "module",
   "files": [