akari-video 0.1.36 → 0.1.38

package/README.md

@@ -45,9 +45,11 @@ DL・sha256 検証・適用まで実行。それ以外（npm グローバル / g
 `akari narration generate ...`（VOICEVOX / fal-qwen3 ナレーション生成）/
 `akari internal beat-sync-<beatmap|probe-frame|render-when-idle> ...`（beat-sync-edit 内部実行物）/
 `akari sounds [--variant wav] [--force]`（公式音源の一括ダウンロード。プロンプトなし・headless 可）/
-`akari store <connect|status|download|disconnect>`（AKARI Store 連携。マイページで発行した
+`akari store <connect|status|install|download|disconnect>`（AKARI Store 連携。マイページで発行した
 接続トークンを `~/.akari/store-credentials.json`（0600）に保存し、購入済み一覧の確認と
-配布物の取得ができる。`src/store-command.mjs`）/
+配布物の取得ができる。`install <productId> [--from <zip>]` は購入パックを展開し、`PACK.json` の
+収載素材を `~/.akari/assets/installed.json` へ登録する。`--from` は開発・オフライン導入時に手元の
+zip を使う。`src/store-command.mjs`）/
 `akari assets <list|fetch|sync|...>`（素材カタログの一覧・取得・同期。
 `packages/asset-resolver` の CLI への薄い委譲で、カタログ合成・entitlements 判定・
 sha256 検証・fail-closed は resolver 側の責務のまま。`src/assets-command.mjs`）/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "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/history-policy.mjs

@@ -0,0 +1,140 @@
+/**
+ * 変更履歴に何を入れるかの単一の宣言。
+ *
+ * `clean-manifest.mjs` が「ディスク上で消してよいか」を宣言するのに対し、本モジュールは
+ * 「変更履歴に入れるか」を宣言する。この 2 つは別の軸である（納品した mp4 はディスクでは
+ * 保持だが、履歴には入れない）。
+ *
+ * ここが単一の出所である理由: 同じ拡張子の知識が
+ *   - プロジェクトの `.gitignore` 雛形（節目ごとの自動スナップショットが何を積むか）
+ *   - `isInternalOrBinaryPath()`（「変更を見る」が何を差分表示しないか）
+ * の 2 か所に分かれて存在し、後者だけが育っていたため、書き出した動画が履歴に積まれ続けて
+ * `.git` が 4.2 GB に達した（issue #48）。以後はどちらも本モジュールから導出する。
+ *
+ * 置き場が akari-launcher/src なのは、`apps/shell` の akari-project 拡張が既に
+ * `akari-video/src/*.mjs` を直接 import しており（依存追加もロックファイル更新も要らない）、
+ * npm 配布 tarball では `src/` がそのまま同梱されるため。`packages/project-scaffold` からは
+ * 相対パスで参照する（prepack が本ファイルを vendor ミラーにも焼くので、モノレポと配布物の
+ * どちらでも同じ相対パスで解決できる）。
+ */
+
+/**
+ * 書き出し・レンダリング・キャッシュが作る映像／音声／画像の拡張子。
+ * 原本（`assets/`）はディレクトリ単位で別に除外するので、ここは「作り直せる生成物」だけを見る。
+ */
+export const GENERATED_MEDIA_EXTENSIONS = Object.freeze([
+    '.mp4',
+    '.mov',
+    '.m4v',
+    '.webm',
+    '.mkv',
+    '.avi',
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.bmp',
+    '.wav',
+    '.mp3'
+]);
+
+const GENERATED_MEDIA_EXTENSION_SET = new Set(GENERATED_MEDIA_EXTENSIONS);
+
+/** アプリが管理する囲みの開始行。利用者が書き足した行は囲みの外に残す。 */
+export const HISTORY_BLOCK_BEGIN = '# >>> AKARI Video: 変更履歴に入れないもの（この囲みの中はアプリが更新します）>>>';
+/** アプリが管理する囲みの終了行。 */
+export const HISTORY_BLOCK_END = '# <<< AKARI Video: ここまで <<<';
+
+const HISTORY_BLOCK_BODY = [
+    '# 元の映像と音声はディスクに残したまま、変更履歴には入れません。',
+    'assets/**',
+    '!assets/.gitkeep',
+    '',
+    '# 書き出した映像・音声・画像は edit.json と assets/ から作り直せます。',
+    '# ディスクには残ります。変更履歴に入れないだけです。',
+    ...GENERATED_MEDIA_EXTENSIONS.map(extension => `*${extension}`),
+    '',
+    '# 書き出しの一時作業領域・キャッシュ・「変更を見る」の一時ファイル。',
+    '.akari/render-tmp/**',
+    '.akari/cache/**',
+    '.akari/diffs/**',
+    '!.akari/diffs/.gitkeep',
+    '',
+    '# 素材の分析結果は作り直すのに手間がかかるので、変更履歴に残します。',
+    '!.akari/sidecars/**',
+    '',
+    '# パソコンが作る一時ファイル。',
+    '.DS_Store',
+    'Thumbs.db'
+];
+
+/** アプリが管理する囲みそのもの（前後の空行は含まない）。 */
+export const HISTORY_BLOCK = [HISTORY_BLOCK_BEGIN, ...HISTORY_BLOCK_BODY, HISTORY_BLOCK_END].join('\n');
+
+/** 新規プロジェクトへ書く `.gitignore` の全文。 */
+export const PROJECT_GITIGNORE = `${HISTORY_BLOCK}\n`;
+
+/**
+ * 囲みを導入する前の世代の `.gitignore` 全文。利用者が一切触っていなければ全文を差し替える。
+ * 一致しなければ「利用者が書き換えた」と見なし、囲みを末尾へ足すだけにする。
+ */
+export const LEGACY_PROJECT_GITIGNORES = Object.freeze([
+    [
+        '# Source video and audio are intentionally kept outside the project history.',
+        'assets/**',
+        '!assets/.gitkeep',
+        '',
+        '# Temporary files used by the friendly "変更を見る" view.',
+        '.akari/diffs/**',
+        '!.akari/diffs/.gitkeep',
+        '',
+        '# Local operating-system files.',
+        '.DS_Store',
+        'Thumbs.db',
+        ''
+    ].join('\n')
+]);
+
+/**
+ * 作り直せる映像／音声／画像か。パス区切りは `/` でも `\` でもよい。
+ * 拡張子だけを見るので、置き場所の規則（sidecars は履歴に残す等）は呼び出し側が足す。
+ */
+export function hasGeneratedMediaExtension(file) {
+    const value = String(file ?? '');
+    const separator = Math.max(value.lastIndexOf('/'), value.lastIndexOf('\\'));
+    const dot = value.lastIndexOf('.');
+    if (dot <= separator + 1) {
+        return false;
+    }
+    return GENERATED_MEDIA_EXTENSION_SET.has(value.slice(dot).toLowerCase());
+}
+
+/**
+ * 既存の `.gitignore` 本文へ現行の囲みを反映した本文を返す。ファイルが無い場合は undefined を渡す。
+ *
+ * - 囲みがある → 囲みの中だけを差し替える（外に書き足した行はそのまま）
+ * - ファイルが無い・空・旧世代の全文と完全一致 → 全文を差し替える
+ * - それ以外（利用者が書き換えている） → 末尾へ囲みを足す（既存の行は消さない）
+ */
+export function applyHistoryPolicy(currentText) {
+    if (currentText === undefined || currentText === null || String(currentText).trim() === '') {
+        return { text: PROJECT_GITIGNORE, changed: true, mode: 'created' };
+    }
+    const text = String(currentText);
+    const begin = text.indexOf(HISTORY_BLOCK_BEGIN);
+    if (begin !== -1) {
+        const endStart = text.indexOf(HISTORY_BLOCK_END, begin);
+        if (endStart !== -1) {
+            const next = text.slice(0, begin) + HISTORY_BLOCK + text.slice(endStart + HISTORY_BLOCK_END.length);
+            return next === text
+                ? { text, changed: false, mode: 'unchanged' }
+                : { text: next, changed: true, mode: 'updated-block' };
+        }
+    }
+    if (LEGACY_PROJECT_GITIGNORES.includes(text)) {
+        return { text: PROJECT_GITIGNORE, changed: true, mode: 'replaced' };
+    }
+    const separator = text.endsWith('\n') ? '\n' : '\n\n';
+    return { text: `${text}${separator}${HISTORY_BLOCK}\n`, changed: true, mode: 'appended' };
+}

package/src/store-command.mjs

@@ -1,7 +1,7 @@
 import { spawnSync } from 'node:child_process';
 import {
   copyFileSync, cpSync, existsSync, mkdirSync, mkdtempSync,
-  readdirSync, rmSync, writeFileSync
+  readFileSync, readdirSync, renameSync, rmSync, writeFileSync
 } from 'node:fs';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
@@ -53,6 +53,173 @@ function findFile(dir, name) {
   return null;
 }
 
+const INSTALLED_ASSETS_SCHEMA = 'akari-installed-assets/v0';
+
+function readJsonFile(filePath) {
+  return JSON.parse(readFileSync(filePath, 'utf8'));
+}
+
+function titleFromMeta(assetRoot) {
+  try {
+    const meta = readJsonFile(path.join(assetRoot, 'meta.json'));
+    return typeof meta.title === 'string' && meta.title ? meta.title : null;
+  } catch {
+    return null;
+  }
+}
+
+function isSafePathSegment(value) {
+  return typeof value === 'string' && value.length > 0
+    && value !== '.' && value !== '..'
+    && !value.includes('/') && !value.includes('\\');
+}
+
+function pathWithin(root, ...parts) {
+  const absoluteRoot = path.resolve(root);
+  const candidate = path.resolve(absoluteRoot, ...parts);
+  if (candidate !== absoluteRoot && !candidate.startsWith(`${absoluteRoot}${path.sep}`)) {
+    throw new Error(`PACK.json の path がパック外を指しています: ${parts.join('/')}`);
+  }
+  return candidate;
+}
+
+function flattenPackContents(pack, packRoot) {
+  if (!Array.isArray(pack?.contents)) {
+    throw new Error('PACK.json に contents[] がありません');
+  }
+
+  const items = [];
+  for (const entry of pack.contents) {
+    const candidates = Array.isArray(entry?.assets)
+      ? entry.assets.map((asset) => ({ asset, parentTitle: entry.title }))
+      : [{ asset: entry, parentTitle: null }];
+    if (candidates.length === 0) {
+      throw new Error('PACK.json の contents[] に空の assets[] があります');
+    }
+
+    for (const { asset, parentTitle } of candidates) {
+      if (!asset || !isSafePathSegment(asset.id)
+        || typeof asset.path !== 'string' || !asset.path) {
+        throw new Error('PACK.json の contents[] に不正な id / path があります');
+      }
+      const assetRoot = pathWithin(packRoot, asset.path);
+      if (!Array.isArray(asset.files) || asset.files.length === 0) {
+        throw new Error(`PACK.json の item に files[] がありません: ${asset.id}`);
+      }
+      const files = asset.files.map((file) => {
+        if (!file || typeof file.path !== 'string' || !file.path
+          || !Number.isInteger(file.bytes) || file.bytes < 0
+          || typeof file.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(file.sha256)) {
+          throw new Error(`PACK.json の files[] が不正です: ${asset.id}`);
+        }
+        pathWithin(assetRoot, file.path);
+        return {
+          path: file.path,
+          bytes: file.bytes,
+          sha256: file.sha256
+        };
+      });
+      const version = asset.version ?? pack.version;
+      if (version === undefined || version === null) {
+        throw new Error(`PACK.json の item に version がありません: ${asset.id}`);
+      }
+      items.push({
+        id: asset.id,
+        title: (typeof asset.title === 'string' && asset.title)
+          || titleFromMeta(assetRoot)
+          || (typeof parentTitle === 'string' && parentTitle)
+          || asset.id,
+        path: asset.path,
+        version,
+        files
+      });
+    }
+  }
+  return items;
+}
+
+function registerInstalledPack(env, productId, packPath) {
+  const home = resolveAkariHome(env);
+  const indexPath = path.join(home, 'assets', 'installed.json');
+  const packRoot = path.dirname(packPath);
+  const pack = readJsonFile(packPath);
+  if ((typeof pack?.version !== 'string' && typeof pack?.version !== 'number')) {
+    throw new Error('PACK.json に version がありません');
+  }
+  let index = { schema: INSTALLED_ASSETS_SCHEMA, packs: {} };
+
+  if (existsSync(indexPath)) {
+    index = readJsonFile(indexPath);
+    if (index?.schema !== INSTALLED_ASSETS_SCHEMA
+      || !index.packs || typeof index.packs !== 'object' || Array.isArray(index.packs)) {
+      throw new Error(`導入済み素材索引の形式が想定と違います: ${indexPath}`);
+    }
+  }
+
+  const items = flattenPackContents(pack, packRoot);
+  index.packs[productId] = {
+    version: pack.version,
+    installedAt: new Date().toISOString(),
+    root: packRoot,
+    items
+  };
+  mkdirSync(path.dirname(indexPath), { recursive: true });
+  const tempPath = `${indexPath}.tmp-${process.pid}`;
+  writeFileSync(tempPath, `${JSON.stringify(index, null, 2)}\n`, { mode: 0o600 });
+  renameSync(tempPath, indexPath);
+  return items;
+}
+
+const KNOWN_BUNDLE_COMPONENTS = new Map([
+  ['multi-device-combo', ['phone-pro-titanium', 'laptop-slim-aluminum', 'app-icon-squircle']]
+]);
+
+async function readJsonResponse(res) {
+  try {
+    const data = await res.json();
+    return data && typeof data === 'object' ? data : null;
+  } catch {
+    return null;
+  }
+}
+
+function componentIds(value) {
+  if (!Array.isArray(value)) return [];
+  return value
+    .map((component) => typeof component === 'string'
+      ? component
+      : component?.id ?? component?.product_id)
+    .filter((id) => typeof id === 'string' && id.length > 0);
+}
+
+function bundleDetails(data, productId) {
+  const candidates = [data, data?.product, data?.status];
+  const products = Array.isArray(data?.products) ? data.products : [];
+  const matchingProduct = products.find((product) =>
+    product?.id === productId || product?.product_id === productId);
+  if (matchingProduct) candidates.push(matchingProduct);
+
+  const bundle = candidates.find((candidate) => candidate?.kind === 'bundle');
+  if (!bundle) return null;
+  return { components: componentIds(bundle.components ?? data?.components) };
+}
+
+async function resolveBundleDetails(fetchImpl, creds, productId, errorData) {
+  const knownComponents = KNOWN_BUNDLE_COMPONENTS.get(productId);
+  if (knownComponents) return { components: knownComponents };
+
+  const fromError = bundleDetails(errorData, productId);
+  if (fromError) return fromError;
+
+  try {
+    const productsRes = await fetchImpl(`${creds.url}/products`);
+    if (!productsRes.ok) return null;
+    return bundleDetails(await readJsonResponse(productsRes), productId);
+  } catch {
+    return null;
+  }
+}
+
 export async function runStoreCommand(args, options = {}) {
   const log = options.log ?? ((line) => console.log(line));
   const env = options.env ?? process.env;
@@ -149,6 +316,27 @@ export async function runStoreCommand(args, options = {}) {
       return { exitCode: 1 };
     }
     if (!res.ok) {
+      const data = await readJsonResponse(res);
+      if (res.status === 404) {
+        const bundle = await resolveBundleDetails(fetchImpl, creds, productId, data);
+        if (bundle) {
+          const componentList = bundle.components.length > 0
+            ? `: ${bundle.components.join(', ')}`
+            : '';
+          log(`セット商品は構成商品を個別に download してください${componentList}`);
+          return { exitCode: 1 };
+        }
+      }
+      if (res.status === 404 && data?.error === 'unknown_product') {
+        log(`${typeof data.message === 'string' ? data.message : '商品が見つかりません'}（${productId}）`);
+        return { exitCode: 1 };
+      }
+      if (res.status === 404 && data?.error === 'artifact_missing') {
+        log(typeof data.message === 'string'
+          ? data.message
+          : '配布物が未入稿です。サポートへご連絡ください');
+        return { exitCode: 1 };
+      }
       log(`ダウンロードに失敗しました（${res.status}）`);
       return { exitCode: 1 };
     }
@@ -164,13 +352,22 @@ export async function runStoreCommand(args, options = {}) {
 
   if (sub === 'install') {
     const productId = args[1];
-    if (!productId || productId.startsWith('--')) {
-      log('使い方: akari store install <productId>');
+    if (!isSafePathSegment(productId) || productId.startsWith('--')) {
+      log('使い方: akari store install <productId> [--from <zip>]');
+      return { exitCode: 1 };
+    }
+    const hasFrom = args.includes('--from');
+    const fromZip = parseFlag(args, '--from');
+    if (hasFrom && !fromZip) {
+      log('使い方: akari store install <productId> [--from <zip>]');
       return { exitCode: 1 };
     }
     const stage = mkdtempSync(path.join(tmpdir(), 'akari-store-install-'));
     try {
-      const dl = await runStoreCommand(['download', productId, '--dest', stage], options);
+      const dl = fromZip
+        ? { exitCode: existsSync(fromZip) ? 0 : 1, filePath: path.resolve(fromZip) }
+        : await runStoreCommand(['download', productId, '--dest', stage], options);
+      if (fromZip && dl.exitCode !== 0) log(`zip が見つかりません: ${fromZip}`);
       if (dl.exitCode !== 0) return { exitCode: 1 };
       const extractDir = path.join(stage, 'x');
       mkdirSync(extractDir, { recursive: true });
@@ -218,6 +415,12 @@ export async function runStoreCommand(args, options = {}) {
       const readme = findFile(destDir, 'README.md');
       log(`展開しました: ${destDir}`);
       if (readme) log(`導入手順: ${readme}`);
+      const packPath = findFile(destDir, 'PACK.json');
+      if (packPath) {
+        const items = registerInstalledPack(env, productId, packPath);
+        log(`akari assets list に ${items.length} 件を登録しました`);
+        if (items[0]) log(`次の一手: akari assets fetch ${items[0].id}`);
+      }
       return { exitCode: 0 };
     } finally {
       rmSync(stage, { recursive: true, force: true });
@@ -236,7 +439,7 @@ export async function runStoreCommand(args, options = {}) {
   log('使い方: akari store <connect|status|install|download|disconnect>');
   log('  connect                              ブラウザで承認して接続（既定。--token akst_... で手動 / --no-open でブラウザを開かない / --url <base>）');
   log('  status                               接続状態と購入済み一覧');
-  log('  install <productId>                  購入済み商品のダウンロード + 導入まで一括');
+  log('  install <productId> [--from <zip>]   購入済み商品の導入（--from は手元 zip / PACK.json 素材を installed 索引へ登録）');
   log('  download <productId> [--dest <dir>]  購入済み配布物の取得のみ');
   log('  disconnect                           接続解除');
   return { exitCode: sub ? 1 : 0 };

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

@@ -93,6 +93,7 @@
     "packages/intake-form/package.json",
     "packages/intake-form/README.md",
     "packages/matte-rvm/package.json",
+    "packages/matte-rvm/README.md",
     "packages/media-bin/package.json",
     "packages/media-bin/README.ja.md",
     "packages/media-bin/README.md",
@@ -104,6 +105,8 @@
     "packages/preview-server/package.json",
     "packages/project-scaffold/package.json",
     "packages/render-cut/package.json",
+    "packages/render-cut/README.ja.md",
+    "packages/render-cut/README.md",
     "packages/schemas/package.json",
     "packages/template-render/package.json",
     "packages/template-render/README.ja.md",

package/vendor/docs/contract-2026-07-25-project-structure-v0.md

@@ -202,3 +202,43 @@ updated: 2026-08-26
   }
 }
 ```
+
+## 10. 追記（2026-09-03）— 変更履歴に何を入れるか（`.gitignore` 雛形）
+
+§2-2 と §9 が扱うのは「ディスク上で消してよいか」である。本節が定めるのは**別の軸**、
+「変更履歴（節目ごとの自動スナップショット）に入れるか」である。納品した `exports/*.mp4` は
+ディスクでは保持だが履歴には入れない、というように 2 つの軸は独立に決まる。
+
+雛形の `.gitignore` が生成物を除外していなかったため、40 秒の動画 1 本のプロジェクトで
+`.git` が 4.2 GB に達した（6 プロジェクト合計で `.git` が全体の 70%・素材は 4%）。
+原因は「同じ拡張子の知識が 2 か所に分かれ、片方だけが育っていた」ことである。
+
+| 変更履歴に入れる | 入れない |
+|---|---|
+| `edit.json` / `captions.json` / `review.json` / `plan.json` | `assets/**`（原本） |
+| `planning/**` / `.akari/events/**` / `motion/**` | 生成された映像・音声・画像（下表の拡張子） |
+| `.akari/reports/**` の JSON・HTML（証跡の実体） | `.akari/render-tmp/**` / `.akari/cache/**` / `.akari/diffs/**` |
+| `.akari/sidecars/**`（映像を含めて全部） | |
+
+- 除外する拡張子: `.mp4` `.mov` `.m4v` `.webm` `.mkv` `.avi` `.png` `.jpg` `.jpeg` `.gif`
+  `.webp` `.bmp` `.wav` `.mp3`
+- 例外は 2 つだけである。`.akari/sidecars/**` は分析に手間がかかるため映像でも履歴に残す。
+  `.akari/reports/**` は拡張子で分かれ、png は外れ JSON・HTML は残る
+- 単一の出所は `packages/akari-launcher/src/history-policy.mjs`。`.gitignore` 雛形
+  （`templates/project-default/.gitignore` と `project-scaffold` の `PROJECT_GITIGNORE`）と、
+  「変更を見る」の除外判定（`isInternalOrBinaryPath()`）は**どちらもここから導出する**。
+  片方だけに拡張子を足すことは契約違反である
+
+### 移行
+
+アプリはプロジェクトを開いたとき、`.gitignore` を現行の内容へ揃え、新たに対象となった
+追跡済みファイルを `git rm --cached` で履歴から外し、1 本コミットする。
+
+- **ディスク上のファイルは消さない**（利用者の成果物であり、消してよいかは §9 の宣言表が別に判断する）
+- 履歴そのもの（過去のコミットが抱える blob）は書き換えない。これは利用者の明示操作の領域であり、
+  移行だけでは `.git` は縮まず横ばいになる
+- `.gitignore` のうちアプリが管理するのは `# >>> AKARI Video ... >>>` から `# <<< ... <<<` までの
+  囲みだけとする。囲みの外に利用者が書き足した行は消さない
+- 自分がルートである git リポジトリのときだけ動く。親リポジトリの中に置かれたプロジェクトは、
+  こちらが管理していないリポジトリの追跡対象を黙って変えないため対象外とする（§3 の
+  「強制的にファイルを移動・削除するスクリプトは作らない」と同じ抑制）