akari-video 0.1.21 → 0.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "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/migrate-command.mjs

@@ -22,15 +22,24 @@ export async function runMigrateCommand(args, options = {}) {
   }
   const projectRoot = parsed.projectRoot;
   const editPath = path.join(projectRoot, 'edit.json');
+  const captionsPath = path.join(projectRoot, 'captions.json');
+  const readText = options.readFile ?? readFile;
   let text;
   try {
-    text = await (options.readFile ?? readFile)(editPath, 'utf8');
+    text = await readText(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 });
+  let captionsRoot;
+  try {
+    captionsRoot = JSON.parse(await readText(captionsPath, 'utf8'));
+  } catch {
+    // captions.json の不在・読み取り失敗・壊れた JSON は cue なしとして移行を続ける。
+  }
+  const hasCaptions = migrate.captionsHaveRenderableCues(captionsRoot);
+  const proposal = migrate.planMigration(projectRoot, editPath, text, { hasCaptions, now: options.now });
   if (proposal.ok === false) {
     if (parsed.json) {
       log(JSON.stringify({ ok: false, error: 'このプロジェクトは変換できません', blockers: proposal.blockers }));

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

@@ -60,6 +60,9 @@
     "packages/edit-lint/package.json",
     "packages/edit-store/package.json",
     "packages/export-nle/package.json",
+    "packages/frame-engine/package.json",
+    "packages/frame-engine/README.ja.md",
+    "packages/frame-engine/README.md",
     "packages/intake-form/package.json",
     "packages/intake-form/README.md",
     "packages/matte-rvm/package.json",

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

@@ -1,3 +1,9 @@
+---
+lifecycle: draft
+created: 2026-07-25
+updated: 2026-08-26
+---
+
 # project-structure-v0（生成物の置き場所）契約
 
 - 日付: 2026-07-25
@@ -60,6 +66,17 @@
   3 ファイル以外の生成物は、性質に応じて §1 の層へ振り分ける（具体例は §4）
 - 新しいトップレベル契約ファイルを追加する場合（将来の話）は、本契約の改訂を通す
 
+#### 2026-08-26 追記: ルート直下の判断記録・分析レポート
+
+- `decision-log.md` は analyze-project と edit-plan が共同追記する判断履歴の単一 SSOT であり、
+  プロジェクトルート直下の正当な契約ファイルとする（根拠:
+  `skills/edit-plan/report-guide.md` の `decision_log` 節）
+- `analysis-report.html` は analyze-project が生成し edit-plan が読む正式な分析レポートであり、
+  プロジェクトルート直下の正当な契約ファイルとする（根拠:
+  `skills/edit-plan/workflow.md` §1）
+- この追記は上記 2 ファイルを §2-1 の許可リストへ追加するものであり、その他のファイルに
+  ルート直下配置を許可しない
+
 ### 2-2. 削除安全の定義
 
 `.akari/work/` と `.akari/cache/` は**再生成可能・削除安全**と定義する。

package/vendor/docs/contract-2026-08-02-preview-parity.md

@@ -581,3 +581,42 @@ ffmpeg の `perspective` フィルタの制約（式に時刻変数を持たな
 段階計画・差分マップの正本: 内部リポ `planning/notes-2026-08-01-webui-shell-convergence.md`。
 Phase 2 以降（共有カーネル抽出: edit-store / ペン / タイムライン写像 / overlay-runtime 一本化）は
 本契約への適合を保ったまま実装を共通化する。
+
+### 4.1 `packages/preview-engine` の処遇 — **凍結**（2026-08-27 裁定・実行済み）
+
+WebCodecs ベースの `packages/preview-engine` は、Web UI からも shell からも import されない
+死蔵コードだった（`packages/preview-server` が `public/preview-engine.bundle.js` へバンドル・
+配信していたが、`index.html` / `app.js` に読み込み口が無い）。本契約の 3 面
+（render-cut / Web UI / shell）のどれにも属さない 4 つ目の実装であり、パリティの対象外である
+ことを明記したうえで**凍結**する。
+
+- **実行済み**: preview-server の `build` から esbuild 行を削除・追跡されていた
+  `public/preview-engine.bundle.js` を削除・`test/server.spec.mjs` の配信スモークを削除。
+  以後 `npm run build` の成果物に preview-engine 由来のファイルは含まれない
+- **削除はしない**: 合成エンジンを 1 個へ統一する「エンジン v2」路線（WebCodecs +
+  GPU コンポジタ）の土台候補として資産価値を実査済みであり、再利用 / 新規の裁定は
+  エンジン v2 のゲート（Phase 0 スパイクの実測と併せて裁定）に委ねる。
+  詳細と復活手順は `packages/preview-engine/README.md` 冒頭の凍結ノートを正とする
+- **凍結中の規律**: 本パッケージへ追随改修を新たに入れない。スキーマや語彙が増えても
+  preview-engine 側の追随は不要（誰も実行しないため、追随は保守錯覚にしかならない）
+
+### 4.2 ducking（BGM の narration ダッキング）の実装本数と正本
+
+§2.5 が定める「narration 再生区間で BGM -12dB」は、**プレビュー側に 3 実装ある**:
+
+| 面 | 実装 | 位置づけ |
+|---|---|---|
+| Web UI | `packages/preview-server/public/app.js`（`hasNarration` / `duckDb`） | 稼働中 |
+| shell | `apps/shell/extensions/akari-preview/src/browser/akari-preview-open-handler.ts`（`duckGainDbAt`） | 稼働中 |
+| preview-engine | `packages/preview-engine/src/duckingGain.ts`（純関数 + `node --test`） | **凍結（§4.1）** |
+
+- **現時点で 3 者は数値的に同値**（2026-08-27 実測: 0〜10s を 10ms 刻み × `ducking` on/off の
+  2,002 点で不一致 0）。したがって本契約 §2.5 への適合は 3 面とも保たれている
+- **-12dB 固定は正（render-cut）とは挙動の違う近似である**。render-cut は
+  `sidechaincompress=threshold=0.063:ratio=8:attack=5:release=300` で、減衰量は narration の
+  実レベルに依存し attack 5ms / release 300ms の時間応答を持つ。プレビュー 3 実装は
+  「区間内なら常に -12dB・立ち上がり/戻りは瞬時」であり、**§2.4 系と同じ宣言済みの近似**として扱う
+- **正本の一本化は未了**（稼働中 2 実装の書き換えを伴うため別タスク）。一本化先は共有カーネル
+  `packages/edit-store`（`computeDuckIntervals` / `computeBgmDuckGainDb` 相当を昇格し、
+  shell は直接 import・Web UI は `edit-kernel.bundle.js` 経由で消費）。それまでは
+  **どれか 1 面の -12dB や区間規則を単独で変えないこと**（3 面同時に変えるか、一本化を先に済ませる）

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

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

package/vendor/packages/analysis-report/package.json

@@ -2,16 +2,12 @@
   "name": "@akari-video/analysis-report",
   "version": "0.0.0",
   "private": true,
-  "description": "analysis.json（事実層）+ interpretation.json（解釈層）から読み取り専用の分析レポート HTML を生成する依存ゼロの CLI。テンプレート（template.html）は不変で、生成物はテンプレへ schema 準拠 JSON を <script type=\"application/json\"> ブロックとして埋め込むだけ。 [akari-video npm vendor: render-analysis-report.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.]",
+  "description": "analysis.json（事実層）+ interpretation.json（解釈層）から読み取り専用の分析レポート HTML を生成する依存ゼロの CLI。テンプレート（template.html）は不変で、生成物はテンプレへ schema 準拠 JSON を <script type=\"application/json\"> ブロックとして埋め込むだけ。",
   "type": "module",
+  "bin": {
+    "render-analysis-report": "render-analysis-report.mjs"
+  },
   "scripts": {
     "test": "node --test \"test/*.test.mjs\""
-  },
-  "akariVideoVendor": {
-    "execution": "reference-only",
-    "omittedBin": {
-      "render-analysis-report": "render-analysis-report.mjs"
-    },
-    "guidance": "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."
   }
 }