akari-video 1.1.1 → 1.2.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.1.1",
+  "version": "1.2.0-beta.2",
   "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/clean-manifest.mjs

@@ -200,6 +200,7 @@ async function classifyAkari(akari, context) {
       for (const candidate of child.children) addDisposable(candidate, rule('.akari/render-tmp/*'), context);
     } else if (child.name === 'cache' && child.kind === 'directory') {
       for (const candidate of child.children) addDisposable(candidate, rule('.akari/cache/**'), context);
+    } else if (child.name === 'tasks.json.lock' && child.kind === 'directory') { addDisposable(child, manifest('.akari/tasks.json.lock', 'disposable', '書き込み中の一時ロック', 'AKARI Video'), context);
     } else if (child.name === 'diffs' && child.kind === 'directory') {
       for (const candidate of child.children) addDisposable(candidate, rule('.akari/diffs/*'), context);
     } else if (child.name === 'work' && child.kind === 'directory') {

package/src/doctor-command.mjs

@@ -60,9 +60,14 @@ export function formatDoctorReport(report) {
     '',
     `判定: ${report.verdict}`,
   ];
-  if (report.next_steps.length > 0) {
+  const steps = [...report.next_steps];
+  if (report.cli.node?.runtime === 'electron' && report.cli.node.exec_path && report.render_cut.path) {
+    const quote = (value) => `"${value.replaceAll('"', '\\"')}"`;
+    steps.push(`Node が PATH に無い場合の書き出し: ELECTRON_RUN_AS_NODE=1 ${quote(report.cli.node.exec_path)} ${quote(report.render_cut.path)} <project-root>`);
+  }
+  if (steps.length > 0) {
     lines.push('次の手順:');
-    lines.push(...report.next_steps.map((step) => `  - ${step}`));
+    lines.push(...steps.map((step) => `  - ${step}`));
   }
   return lines.join('\n');
 }

package/src/migrate-command.mjs

@@ -64,11 +64,14 @@ export async function runMigrateCommand(args, options = {}) {
   }
   if (parsed.json) {
     log(JSON.stringify({
-      ok: true, dryRun: parsed.dryRun, version: proposal.version,
+      ok: true, dryRun: parsed.dryRun, version: proposal.emptyProject ? null : proposal.version,
+      ...(proposal.emptyProject ? { emptyProject: true } : {}),
       filePath: proposal.filePath, backupPath: proposal.backupPath, changes: proposal.changes
     }));
   } else {
-    log(`変換対象: ${proposal.filePath} (version ${proposal.version}${proposal.version === 2 ? ' 正規化' : ' -> 2'})`);
+    log(proposal.emptyProject
+      ? `初期化対象: ${proposal.filePath} (空の edit.json -> version 2)`
+      : `変換対象: ${proposal.filePath} (version ${proposal.version}${proposal.version === 2 ? ' 正規化' : ' -> 2'})`);
     for (const change of proposal.changes) log(`- ${change.path}: ${change.note}`);
     log(`変換前の退避先: ${proposal.backupPath}`);
   }
@@ -92,7 +95,9 @@ export async function runMigrateCommand(args, options = {}) {
   }
   await migrate.applyMigration(proposal);
   if (!parsed.json) {
-    log(proposal.version === 2
+    log(proposal.emptyProject
+      ? `空の edit.json を初期化しました。元ファイル: ${proposal.backupPath}`
+      : proposal.version === 2
       ? `version 2 を正規化しました。元ファイル: ${proposal.backupPath}`
       : `version 2 へ変換しました。元ファイル: ${proposal.backupPath}`);
   }

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

@@ -83,6 +83,10 @@
     "docs/contract-2026-10-02-textstyle-v1-rich.md",
     "docs/contract-2026-10-04-asset-tier-v1.md",
     "docs/contract-2026-10-06-timeline-ripple-v0.md",
+    "docs/contract-2026-10-07-material-ranges-v0.md",
+    "docs/contract-2026-10-07-tasks-v0.md",
+    "packages/akari-ear/package.json",
+    "packages/akari-ear/README.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -109,6 +113,8 @@
     "packages/frame-engine/package.json",
     "packages/frame-engine/README.ja.md",
     "packages/frame-engine/README.md",
+    "packages/frame-scene/package.json",
+    "packages/frame-scene/README.md",
     "packages/generate/package.json",
     "packages/generate/README.md",
     "packages/gpu-export/package.json",

package/vendor/docs/contract-2026-07-13-asset-library.md

@@ -373,7 +373,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 
 | v1 category | 形の定義 | 判定 | 旧 category |
 |---|---|---|---|
-| `overlay` | 時間を持つ HTML 断片 | `fragment.html` + `data-start` / `data-duration` を持ち `overlays[]` から合成 | `telop` / `motion` |
+| `overlay` | 時間を持つ HTML 断片 | `fragment.html` を `overlays[]` から合成。断片ルートに時刻を置かず、素材本来の長さは `data-akari-natural-duration`（秒）に記録 | `telop` / `motion` |
 | `still` | 時間を持たない HTML シート | `fragment.html`。決定的スクショで画像に焼く | `thumbnail` |
 | `scene3d` | 3D モデル + 表示断片、またはベイクレシピ | `fragment.html` + glTF、または `scene.py` | `3d` |
 | `audio` | 音声トラックに載るバイナリ | `edit.json` の `audio.bgm` / `sfx` が参照 | `audio`（変更なし） |

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

@@ -40,6 +40,7 @@ updated: 2026-09-06
 |---|---|---|
 | 人間の一次素材 | `assets/`（下位分類自由） | 人間・取り込み UI |
 | 企画・プラン | `planning/` | スキル + 人間承認 |
+| 仮枠のシーン JSON（AI が書く・人が微調整。仮枠の meta の `frame.content.scene` が指す） | `planning/frames/` | スキル・仮枠の編集 |
 | エージェント中間物・ad-hoc 検証スクリプトと結果 | `.akari/work/` | スキル・エージェント |
 | 検証証跡・レポート（キーフレーム視認 PNG・render-report 等） | `.akari/reports/` | スキル |
 | 絵コンテ（タイムラインの印刷・初回だけ・AI は後から読まない） | `.akari/reports/storyboard/` | スキル |
@@ -47,6 +48,8 @@ updated: 2026-09-06
 | 納品物 | `exports/` | `render-cut` |
 | 契約サイドカー（既存） | `.akari/`（`sidecars/` `diffs/` `events/` 等） | 既存のまま |
 
+`planning/frames/<stem>.scene.json` は仮枠（生成 v0 契約）の中身を記述する正本で、変更履歴に入る（`planning/**`）。仮枠の絵（png）と meta は従来どおり `assets/generated/`。
+
 `.akari/` 直下にはこの表にない契約サイドカーファイルも存在する（`intake.json`・
 `workflow.json`・`connections.json`・`lint.json`・`render.json` 等）。これらは各自の
 契約文書が正本であり、本契約は「置き場所の層」を追加で確定させるだけで、個々のファイル形は

package/vendor/docs/contract-2026-08-30-edit-json-v2-object-tree-v0.md

@@ -31,7 +31,7 @@ updated: 2026-08-30
 
 ## 1. データ模型（`version: 2` のまま追加のみ）
 
-**新しいサブスキーマはここに列挙した以外増やさない。** 部品も字幕行もグループも「普通のアイテム」で、共通フィールド（`id` / `at` / `duration` / `transform` / `opacity` / `blend` / `crop` / `perspective` / `keyframes`）をそのまま使う。
+**新しいサブスキーマはここに列挙した以外増やさない。** HTML source の `elements` は要素ごとの inline style 上書きである。部品も字幕行もグループも「普通のアイテム」で、共通フィールド（`id` / `at` / `duration` / `transform` / `opacity` / `blend` / `crop` / `perspective` / `keyframes`）をそのまま使う。
 
 ### 1.1 再帰 — アイテムは `items[]` を持てる
 
@@ -81,7 +81,7 @@ updated: 2026-08-30
 - **見える子 = 袋の名札から写す（projection）**。edit.json には書かない。上の例で `s01.html` に部品 A / B / C があれば、A は写し（触っていない・既定の時間 = 袋と同じ）、B は明示（触ったので `items[]` に居る）、C は `exclude`（袋の中では表示しない = 別の場所へ「出した」か、消した）
 - **触った子だけ明示アイテムになる**。明示アイテムは袋の子として `items[]` に置くか、木の別の場所に置く（= 分離 §3.1）。どちらでも袋側は `source.exclude` に id を持つ
 - **袋の中では並びを変えない・ばらさない**（HTML の DOM 順 / captions.json の行順が正）。変えたい部品は出す
-- 名札の無い断片は「袋ごと 1 アイテム」（`part` 無し・`items` 無し）。既存の overlays はこれ（**回帰なし**）
+- 名札の無い断片は「袋ごと 1 アイテム」（`part` 無し・`items` 無し）。このアイテムも `source.elements` による要素の上書きを持てる。既存の overlays はこれ（**回帰なし**）
 - 名札の読み取り（HTML の走査）は**描画・プレビュー側の仕事**（§4）。edit.json の読み込み層は袋を「子を持ち得るアイテム」として扱うだけ
 
 ### 1.4 部品アイテム `source: { kind: "html", path, part }`
@@ -90,6 +90,14 @@ updated: 2026-08-30
 - `vars` / `params`（既存のツマミ経路）は部品アイテムでも使える。`style` / `text` は「設計済みのツマミが無い所を直す」ための逃げ道で、これで HTML を書き換えずに見た目の自由度を持つ
 - 部品アイテムの `at` / `duration` / `transform` / `opacity` / `keyframes` は共通フィールド。**部品専用のサブスキーマは無い**
 
+### 1.4a 要素の上書き `source.elements`
+
+- HTML source は任意の `elements: { "<番地>": { "style": { "<css-prop>": "<value>" } } }` を持てる。CSS 値は検証しない。番地の値に許すキーは `style` だけ。空の `elements` と空の `style` は保存時に畳んで消す。
+- 番地は `#id[0]` または `.class[2]` の形。書式は `^[#.][^\s\[\]]+\[(0|[1-9]\d*)\]$`。id 属性の完全一致、または class 属性の空白区切りトークンの一致を、断片ソースの文書順に 0 から数える。CSS セレクタとして解釈しない。コメントと script/style の中身、`<script>` / `<style>` 要素そのもの（番地で指せない）、マウント後に増える要素は数えない。
+- 開始タグを親子とも文書順に数え、重複 id も出現番号で区別する。属性名は大小文字を区別せず、class の区切りはタブ・改行を含む空白とする（`tokenizeHtml` と同じ）。
+- 解決できない番地は描画で読み飛ばし、lint の `v2.element-ref` warning にする。素材 HTML は編集しない。
+- 袋の `elements` は各子へ継承する。同じ番地の同じ CSS プロパティは子の値が勝つ。部品ルートに `source.style` もあるときは `elements` の後に `style` を追記し、部品の値が勝つ。
+
 ### 1.5 字幕 = 袋グループ（専用トラックの廃止）
 
 ```jsonc
@@ -198,6 +206,7 @@ updated: 2026-08-30
 ## 4. 描画 — クローンマスク
 
 - **部品アイテム 1 つにつき断片全体を 1 回マウント**し、当該 `part` 以外の名札付き要素を `visibility: hidden` にする（`display: none` ではない — レイアウトと CSS の継承を壊さない）。各マウントが自分の時計（アイテム相対時間）・変形・z を持つ
+- `source.elements` は要素を複製せず、同じマウント内の開始タグへ inline style を追記する。部品の複製がある場合は各複製へマスクより先に同じ上書きを適用する。`elements` が無い既存アイテムのレコードは変えない。
 - 袋グループの写しの子（触っていない部品）は、時間・位置が袋と揃っている限り**1 マウントにまとめる**（エンジン側の最適化。データは不変）。`exclude` の部品は `visibility: hidden`
 - `source.style` は部品ルート要素の inline style として適用、`source.text` は部品ルートの textContent を差し替える（子要素を持つ部品に `text` を指定したら lint warning・描画は最初のテキストノードだけ差し替え）
 - 部品内の CSS / GSAP アニメ（L3）は部品アイテムの時計で seek する（既存の HTML seek 規約のまま）
@@ -297,6 +306,7 @@ await p.save();                         // 正規直列化 → lint ゲート
 | `v2.track-no-overlap` | error | 同一段の items が時間で重ならない（既存 → 明文化）|
 | `v2.group-bake-blocked` | error | `keyframes` / `motion` / `animator` を持つグループを ungroup しようとした（edit-store の操作時）|
 | `v2.part-ref` | warning | `source.part` / `source.exclude` の id が袋に存在するか（**文字列レベル**: HTML は `data-akari-part="…"` の grep、captions は行 id）|
+| `v2.element-ref` | warning | `source.elements` の番地が `source.path` の HTML ソース内で解決できるか |
 | `v2.captions-content-deprecated` | warning | 旧形 `tracks[].content` を使っている |
 | `v2.caption-overlap` | warning | 分離した字幕行と袋の写しが同時刻に重なる |
 | `v2.keyframes-ref` | error | `keyframes: { path, count }` の袋が無い / `count` が実数と違う |
@@ -334,3 +344,7 @@ await p.save();                         // 正規直列化 → lint ゲート
 - 観察・手術の CLI コマンド（作らない。§5.2-5）
 - 種類ごとに違うグループ（sequence / scene 等）— 「段」と「グループ」の 2 つだけ
 - 文字ごとのキーフレーム（姉妹契約 §8）
+
+## 音声片のカット端
+
+edit.json v2 の audio lane にある分離済み speech item は、カットで素材端が失われたとき、任意の `cut_edge: { "in": 秒, "out": 秒, "at": 整数フレーム }` を持てる。`in` と `out` はこの音声片自身の元の素材端であり、頭がまたぎで削られた場合だけ `in` が現在の `source.in` と異なり、尻がまたぎで削られた場合だけ `out` が現在の `source.out` と異なる。両端が現在の素材端と等しくなれば欄を消す。`at` は「頭を `cut_edge.in` まで戻したときの開始フレーム」で、現在の `at - round((source.in - cut_edge.in) / 1 フレームぶんの素材秒)` から求める派生値である。カットで音声片を割ったときはそれぞれの片の端だけを保持し、結合時は左片の `in` と右片の `out` を採る。`in` と `out` は 0 以上の有限数で `in < out`、`at` は整数。先行カットのリップルを反映した途中状態では `cut_edge.at` が負になることもある。再生範囲の `source.in/out` と現在位置の `at` はそのまま正本とする。`provenance` はナレーションの生成元専用で、この用途には使わない。欄のない既存 item の意味は変わらない。

package/vendor/docs/contract-2026-08-30-motion-and-keyframes-v0.md

@@ -26,7 +26,7 @@ updated: 2026-09-06
 | **L2 アニメーター** | 文字 / 単語 / 行 / 文節ごとのずらし（範囲セレクタ + 量）| アイテムの `animator[]`（パラメータ数個）+ offset のキーフレームは袋 | offset のダイヤだけ（数個）。文字ごとの行は出ない | テロップ・字幕の演出 |
 | **L3 コード** | 断片内の CSS / GSAP アニメ | HTML の中（逃げ道）| 帯だけ（中は不透明）| AI / 上級者 |
 
-- **粒度 = 名札の粒度**。部品の中の一部だけ別に動かしたいなら、名札を細かく付けて（文節を部品にして）出す → L1 が効く。エディタ側に第 3 の粒度は作らない
+- **時間と動きの粒度 = 名札の粒度**。部品の中の一部だけ別の時間で動かしたいなら、名札を細かく付けて（文節を部品にして）出す → L1 が効く。位置・回転・箱の上書きは名札なしの要素にも掛けられる（`source.elements`、2026-10-07 オーナー裁定）。それ以上の第 3 の粒度は作らない
 - **文字ごとのキーフレームはデータとして持たない**（100 文字 × 5 プロパティ × 3 点 = 1,500 個 / 文字を直すと全部ずれる / AI が扱えない）。文字単位の動きは L2 で表す
 
 ## 1. L0 プリセット `motion`

package/vendor/docs/contract-2026-10-07-material-ranges-v0.md

@@ -0,0 +1,13 @@
+# Material ranges v0
+
+The project stores non-destructive source selections in `.akari/material-ranges.json`:
+
+```json
+{ "version": 1, "ranges": { "assets/example.mp4": { "in": 2.5, "out": 8 } } }
+```
+
+Keys are project-relative media paths. `in` and `out` are seconds in the original media; `out` is greater than `in`. Removing a selection deletes its key. A missing or malformed file means no selections. Updates preserve unrelated top-level keys and other material entries and replace the file by writing a temporary file and renaming it.
+
+The selected list strip exposes two handles. Its minimum width is the larger of one second and 24 pixels expressed in source seconds, capped by the media duration. Dragging one handle keeps the other fixed. Double-clicking the strip or pressing × clears the selection. Changes are saved after 150 ms.
+
+Material drag payloads and `akari.timeline.addMaterialAtPlayhead` requests may carry `in` and `out`. Drag placement uses the payload; playhead placement reads the saved range. Video and audio placement cap `out` at the media duration and use the full source when no valid range is present. `akari.materials.range.get` and `.set` expose the stored range to other views; changes emit `akari.materials.range.changed` with `{ relativePath, range }` on `window`. Range setters may include `source`; the event preserves it so a view can ignore echoes of its own changes.

package/vendor/docs/contract-2026-10-07-tasks-v0.md

@@ -0,0 +1,74 @@
+# tasks.json v0 — 依頼タスクの運用情報
+
+## 位置づけ
+
+`.akari/tasks.json` は、AI への依頼の運用情報を持つプロジェクトのサイドカーである。状態、優先度、送信先、戻すための履歴、および注釈以外の依頼を保存する。注釈の本文は `review.json` が正本である。
+
+## 置き場
+
+プロジェクトの `.akari/tasks.json` に置く。ルート直下には置かない。これはプロジェクト構造契約の「契約サイドカー」に当たる。ファイルは履歴に残す。`.akari/cache/outbox/` の依頼文は再生成できる一時ファイルであり、送信後の記録は tasks.json に残す。
+
+## 形
+
+top の必須フィールドは `version: 0` と `tasks` 配列である。各タスクの必須フィールドは `id`、`source`、`state`、`createdAt` のみ。`id` は `t-0001` のような連番で、既存の最大番号の次を使う。
+
+| フィールド | 型・値 | 用途 |
+|---|---|---|
+| `source` | `annotation` / `lint` / `proposal` / `export` | タスクの出どころ |
+| `state` | `unsent` / `sent` / `review` / `done` | 進行状態 |
+| `via`, `priority`, `rank` | 文字列、`high` / `normal` / `low`、数値または null | 入口と並び |
+| `outcome` | null または `edited` / `declined` / `failed` / `dismissed` | 結果 |
+| `title`, `body`, `target` | 文字列、文字列、文字列または null | 表示とアンカーのない指示 |
+| `anchor`, `ref` | object または null | 素材時刻と元データへの参照 |
+| `attachments` | `{kind, path, external?}` の配列 | 添付ファイル |
+| `gate`, `needsConfirm` | `auto-ok` / `ask`、真偽値 | 実行前の扱い |
+| `undo` | `{reversible, historyId?, before?, after?, undoneAt?}` | 戻すための記録 |
+| `batchId`, `sentAt`, `sentTo` | 文字列、文字列または null、`{agent, form, route}` | 送信記録 |
+| `response` | null または `{summary, action, respondedAt}` | 応答。`action` は `edited` / `declined` |
+| `createdBy`, `updatedAt`, `orphaned` | `human` / `app` / `ai`、文字列、真偽値 | 作成者と追跡 |
+| `kind`, `targetDetail`, `evidence` | 文字列、object、object | 取り込み時の分類・対象・根拠 |
+| `confidence`, `question`, `risk`, `route` | 文字列 | 確信度、質問、外部送出の危険、担当 |
+| `dependsOn`, `origin`, `mergedFrom` | id 配列、object、id 配列 | 依存、出所、統合元 |
+
+`anchor` は `{sourceT, sourceRange}`、`ref` は `{kind, id|key|path|rule}`。`targetDetail` は `refs[]`, `outputT`, `src`, `sourceT`, `cutIndex`, `region`（0〜1 の `[x,y,w,h]`）を持てる。`evidence` は `memo`, `speech`（`[開始秒, 終了秒]`）, `quote`, `ink[]`、`origin` は `kind`, `memo`, `job`, `ref` を持てる。`risk: outbound` は `gate: ask` とし、自動実行しない。未知の任意列挙値は警告として扱う。
+
+```json
+{
+  "version": 0,
+  "tasks": [
+    {
+      "id": "t-0001",
+      "source": "annotation",
+      "state": "unsent",
+      "createdAt": "2026-10-07T08:10:00.000Z",
+      "ref": { "kind": "annotation", "id": "a-0003" },
+      "priority": "normal",
+      "gate": "ask"
+    }
+  ]
+}
+```
+
+## 状態と遷移
+
+`unsent → sent → review → done` が基本形。リントの再検査で指摘が消えたときのみ `sent → done` とできる。人による再依頼・復元は `review → unsent`。人の無視は任意の状態から `done` とし、`outcome: dismissed` を記録する。AI は `done` に進めない。
+
+## 注釈との関係
+
+`ref.kind: annotation` の本文、対象、時刻、ペンの線は `review.json` を正本とする。tasks.json は運用情報を重ねる。注釈の `open` は `unsent`、`addressed` は `review`、`resolved` は `done` に写す。`open` でも送信記録が `sent` なら `sent` を保つ。その他の食い違いは `review.json` を優先する。参照先の注釈が消えたタスクは `orphaned: true` として残す。`review.json` の形は変更しない。
+
+## 読み手の規約
+
+ファイルが無ければ空の `version: 0` として読む。未知フィールドを保持し、未知の `source` / `state` は表示だけして変更しない。必須フィールドの欠落は警告に残し、タスクを捨てない。JSON が壊れたファイルは上書きしない。`version > 0` は「新しい形式です。スキル / アプリを更新してください」として拒否する。
+
+## 書き手の規約
+
+`.akari/tasks.json.lock` ディレクトリを確保し、ロック内でファイル全文を読み直す。60 秒を超えた古いロックは回収する。`tasks.json.tmp` に 2 スペース整形・末尾改行で書き、rename で原子的に置き換える。注釈の参照があるタスクの本文は書き写さない。状態の変更ごとに個別の git commit は作らない。
+
+## 検証
+
+`node packages/schemas/bin/validate-tasks.mjs <tasks.json>` を実行する。形式と意味のエラーは終了コード 1、警告のみなら 0、引数の誤りは 2。id の重複と `risk: outbound` + `gate: auto-ok` はエラーである。
+
+## 互換
+
+古いアプリやスキルは `review.json` をそのまま使える。tasks.json が無いプロジェクトでも注釈から仮想タスクを作る。「送った」注釈 id の既存保存は初回に取り込める。`.akari/tasks.json` は保持対象、ロックと `.akari/cache/outbox/` は一時データとして扱う。

package/vendor/packages/akari-ear/README.md

@@ -0,0 +1,9 @@
+# AKARI バイブの耳
+
+耳はマイクを開き、音声を文字にして辞書を適用する共有部品です。判断サービスの資格や鍵に依存せず、マイクの持ち主を 1 つにします。
+
+段階 A では、試し聞きとメモ、区画の「いま」が耳を使います。Jev は従来どおり自分のマイクを使い、同時利用は禁止します。Jev 動作中は耳を使用中として扱います。
+
+段階 B では、Jev の聞き取りも耳へ統一します。発話と音量を係の `/say` と `/level` へ渡し、マイクの持ち主を耳に一本化します。
+
+現時点は骨組みのみで、実装は今後行います。

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

@@ -0,0 +1,11 @@
+{
+  "name": "@akari-video/akari-ear",
+  "version": "0.0.0",
+  "private": true,
+  "description": "AKARI バイブの耳（マイク → 文字起こし → 辞書）の共有部品。依存ゼロ。",
+  "type": "module",
+  "main": "src/index.mjs",
+  "scripts": {
+    "test": "node --test \"test/*.test.mjs\""
+  }
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.1.1",
+  "version": "1.2.0-beta.2",
   "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. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/akari-vibe/README.md

@@ -1,7 +1,7 @@
 # AKARI バイブ
 
-このディレクトリは内部リポジトリの正本から自動生成する配布物です。直接編集しないでください。
-変更は内部へ戻し、検査を通して書き出し直します。版はシェルと一緒に管理します。
+このディレクトリは公開リポジトリが正本です。変更は通常のプルリクエスト・コミットで行います。
+版はシェルと一緒に管理します。
 判断は `https://akari.video/api/vibe` のサービスで行い、その実装は同梱しません。
 
 ## 起動

package/vendor/packages/asset-resolver/src/catalog.mjs

@@ -2,7 +2,7 @@
 // ~/.akari/catalog-cache.json へ自動キャッシュ（オフライン時のフォールバック）。
 // ローカルパス指定（開発・テスト）はファイルをそのまま読む。
 
-import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { readFile, mkdir, writeFile, stat } from 'node:fs/promises';
 import { catalogCachePath, resolveAkariHome, resolveCatalogSource } from './env.mjs';
 import { join } from 'node:path';
 import { loadInstalledItems, mergeInstalledItems } from './installed.mjs';
@@ -16,9 +16,26 @@ function normalizeCatalog(catalog) {
   return catalog;
 }
 
+// The local catalog is large; keep the parsed value until the file changes.
+const parsedCatalogs = new Map();
+async function readLocalCatalog(file, visible = false) {
+  const info = await stat(file);
+  const cached = parsedCatalogs.get(file);
+  if (cached && cached.mtimeMs === info.mtimeMs && cached.ctimeMs === info.ctimeMs
+      && cached.size === info.size) {
+    if (visible && !cached.public) cached.public = publicCatalog(cached.catalog);
+    return visible ? cached.public : cached.catalog;
+  }
+  const catalog = normalizeCatalog(JSON.parse(await readFile(file, 'utf8')));
+  const entry = { mtimeMs: info.mtimeMs, ctimeMs: info.ctimeMs, size: info.size, catalog,
+    ...(visible ? { public: publicCatalog(catalog) } : {}) };
+  parsedCatalogs.set(file, entry);
+  return visible ? entry.public : catalog;
+}
+
 export async function readCatalogCache(env = process.env) {
   try {
-    return publicCatalog(normalizeCatalog(JSON.parse(await readFile(catalogCachePath(env), 'utf8'))));
+    return await readLocalCatalog(catalogCachePath(env), true);
   } catch {
     return null;
   }
@@ -53,6 +70,7 @@ export async function cacheCatalog(env = process.env, catalog) {
   const home = resolveAkariHome(env);
   await mkdir(home, { recursive: true });
   await writeFile(catalogCachePath(env), `${JSON.stringify(publicCatalog(normalizeCatalog(catalog)), null, 2)}\n`);
+  parsedCatalogs.delete(catalogCachePath(env));
 }
 
 /**
@@ -70,8 +88,7 @@ export async function loadCatalog({ env = process.env, fetchImpl = fetch, includ
   }
 
   if (source.kind === 'file') {
-    const raw = await readFile(source.value, 'utf8');
-    catalog = normalizeCatalog(JSON.parse(raw));
+    catalog = await readLocalCatalog(source.value);
   } else {
     try {
       const { response: res, controller } = await fetchTimed(source.value, { fetchImpl, timeouts, label: 'カタログ' });

package/vendor/packages/asset-resolver/src/project-references.mjs

@@ -157,8 +157,13 @@ export async function readProjectReferences(projectDir) {
 
 export async function recordProjectReference(projectDir, reference) {
   assertReference(reference);
+  const alreadyRecorded = references => references.some(entry =>
+    entry.id === reference.id && entry.category === reference.category);
+  const current = await readProjectReferences(projectDir);
+  if (alreadyRecorded(current)) return current;
   return withReferencesLock(projectDir, async () => {
     const references = await readProjectReferences(projectDir);
+    if (alreadyRecorded(references)) return references;
     references.push({ id: reference.id, category: reference.category });
     const normalized = normalizeReferences(references);
     await writeProjectReferences(projectDir, normalized);

package/vendor/packages/asset-resolver/src/resolve.mjs

@@ -12,7 +12,7 @@ import { resolveAssetLibraryRoots } from '../../creator-root/src/index.mjs';
 
 import { spawn } from 'node:child_process';
 import { constants } from 'node:fs';
-import { cp, mkdir, mkdtemp, readFile, rename, rm, realpath, stat, writeFile } from 'node:fs/promises';
+import { cp, lstat, mkdir, mkdtemp, readFile, readdir, rename, rm, realpath, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { format } from 'node:util';
@@ -94,6 +94,52 @@ async function validateAsset(assetDir) {
 
 export { AssetResolverError };
 
+// overlay-runtime は resolver の依存にしない。断片ルートの変換規則は両方を同じテストで固定する。
+export function withoutFragmentRootTiming(source, { preserveNaturalDuration = false } = {}) {
+  let cursor = 0;
+  while (cursor < source.length) {
+    const start = source.indexOf('<', cursor);
+    if (start < 0) break;
+    if (source.startsWith('<!--', start)) {
+      const end = source.indexOf('-->', start + 4);
+      if (end < 0) throw new Error('HTML コメントが閉じていません');
+      cursor = end + 3;
+      continue;
+    }
+    const tag = /^<([A-Za-z][\w:-]*)(?:"[^"]*"|'[^']*'|[^'">])*>/u.exec(source.slice(start));
+    if (!tag) { cursor = start + 1; continue; }
+    if (/^(?:style|script)$/iu.test(tag[1])) {
+      const closing = new RegExp(`</${tag[1]}\\s*>`, 'iu').exec(source.slice(start + tag[0].length));
+      if (!closing) throw new Error('HTML の前置要素が閉じていません');
+      cursor = start + tag[0].length + closing.index + closing[0].length;
+      continue;
+    }
+    if (/^link$/iu.test(tag[1])) { cursor = start + tag[0].length; continue; }
+    const nameEnd = tag[1].length + 1;
+    const attributes = tag[0].slice(nameEnd, -1);
+    const tokens = /([^\s=/>]+)(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+))?/gu;
+    const removals = [];
+    let duration = null;
+    let hasNaturalDuration = false;
+    for (const token of attributes.matchAll(tokens)) {
+      if (preserveNaturalDuration && /^data-akari-natural-duration$/iu.test(token[1])) hasNaturalDuration = true;
+      if (!/^data-(?:start|duration)$/iu.test(token[1])) continue;
+      if (preserveNaturalDuration && /^data-duration$/iu.test(token[1])) {
+        const value = token[0].match(/=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/u)?.slice(1).find(part => part !== undefined);
+        if (value !== undefined && Number.isFinite(Number(value)) && Number(value) > 0) duration = value;
+      }
+      let from = token.index;
+      while (from > 0 && /\s/u.test(attributes[from - 1])) from--;
+      removals.push([from, token.index + token[0].length]);
+    }
+    let changed = attributes;
+    for (const [from, to] of removals.reverse()) changed = changed.slice(0, from) + changed.slice(to);
+    if (preserveNaturalDuration && !hasNaturalDuration && duration !== null) changed += ` data-akari-natural-duration="${duration}"`;
+    return source.slice(0, start + nameEnd) + changed + source.slice(start + tag[0].length - 1);
+  }
+  throw new Error('HTML 断片のルート要素がありません');
+}
+
 /** category/id を優先し、bare id はカタログ内で一意な場合だけ解決する。 */
 export function findCatalogItem(catalog, ref) {
   if (typeof ref === 'string' && ref.includes('/')) {
@@ -132,6 +178,12 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
       child.on('close', code => resolveResult(code === 0));
     });
     if (cloned) {
+      try {
+        await normalizeCopiedFragments(dest, category);
+      } catch (error) {
+        await rm(dest, { recursive: true, force: true });
+        throw error;
+      }
       return dest;
     }
     // クロスボリューム等で -c が失敗したケース。部分的に書かれた dest を掃除してから
@@ -142,9 +194,41 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
   // COPYFILE_FICLONE（_FORCE ではない）: 対応 FS（APFS 等）では CoW クローンで実体化コピーを
   // 省略し、非対応環境では黙って通常コピーへフォールバックする（失敗しない）。
   await cp(realSourceDir, dest, { recursive: true, mode: constants.COPYFILE_FICLONE });
+  try {
+    await normalizeCopiedFragments(dest, category);
+  } catch (error) {
+    await rm(dest, { recursive: true, force: true });
+    throw error;
+  }
   return dest;
 }
 
+async function normalizeCopiedFragments(dest, category) {
+  if (category !== 'overlay' && category !== 'scene3d') return;
+  const files = ['fragment.html'];
+  const variants = path.join(dest, 'variants');
+  const variantInfo = await lstat(variants).catch(error => {
+    if (error.code === 'ENOENT') return null;
+    throw error;
+  });
+  if (variantInfo && !variantInfo.isDirectory()) throw new Error('variants が通常のディレクトリではありません');
+  for (const entry of variantInfo ? await readdir(variants) : []) {
+    if (entry.endsWith('.html')) files.push(path.join('variants', entry));
+  }
+  for (const file of files) {
+    const target = path.join(dest, file);
+    const info = await lstat(target).catch(error => {
+      if (error.code === 'ENOENT') return null;
+      throw error;
+    });
+    if (info === null) continue;
+    if (!info.isFile()) throw new Error(`断片ファイルが通常のファイルではありません: ${file}`);
+    const source = await readFile(target, 'utf8');
+    const cleaned = withoutFragmentRootTiming(source, { preserveNaturalDuration: true });
+    if (cleaned !== source) await writeFile(target, cleaned);
+  }
+}
+
 async function moveIntoLibrary(tempDir, destDir) {
   await mkdir(path.dirname(destDir), { recursive: true });
   if (await stat(destDir).then(() => true, error => { if (error.code === 'ENOENT') return false; throw error; })) {
@@ -282,6 +366,24 @@ export async function resolve(
   { env = process.env, fetchImpl = fetch, project = null, force = false, reference = false, timeouts } = {},
 ) {
   const home = resolveAssetLibraryRoots(env).write;
+  // A qualified reference already names the local directory. Avoid parsing the
+  // large catalog on the common placement path; uncached and bare IDs still use it.
+  const localRef = typeof ref === 'string' ? ref.split('/') : [];
+  const qualified = localRef.length === 2 && localRef.every(part => part.length > 0
+    && part !== '.' && part !== '..' && !/[\\\0]/.test(part));
+  if (!force && qualified) {
+    const cachedDir = await cachedAssetDirAsync(env, localRef[0], localRef[1]);
+    if (cachedDir) {
+      const result = { id: localRef[1], category: localRef[0], dir: cachedDir, cached: true };
+      if (project && reference) {
+        await recordProjectReference(project, { id: localRef[1], category: localRef[0] });
+        result.referenced = true;
+      } else if (project) {
+        result.projectDir = await copyIntoProject(cachedDir, project, localRef[0], localRef[1]);
+      }
+      return result;
+    }
+  }
   const catalog = await loadCatalogForResolveAsync(ref, { env, fetchImpl, timeouts });
   const item = findCatalogItem(catalog, ref);
 

package/vendor/packages/asset-resolver/src/state.mjs

@@ -82,7 +82,7 @@ export async function composeState({ env = process.env, fetchImpl = fetch, inten
     localItems.delete(key);
     // Preserve remote download descriptors/preview keys for existing consumers.
     // Local-only assets use the actual directory listing assembled above.
-    return local ? { ...item, ...local, tier: item.tier ?? assetTier(item), files: item.files ?? local.files, preview: item.preview ?? local.preview,
+    return local ? { ...item, ...local, tier: item.tier ?? assetTier(item), files: item.files ?? local.files, preview: local.libraryDir && local.preview ? local.preview : item.preview ?? local.preview,
       ...(item.source === 'installed' ? { source: item.source } : {}) } : item;
   });
   const localOnlyKeys = new Set(localItems.keys());

package/vendor/packages/asset-resolver/test/catalog-and-state.test.mjs

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, utimesSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import test from 'node:test';
 import { cacheCatalog, loadCatalog, readCatalogCache } from '../src/catalog.mjs';
@@ -13,6 +13,18 @@ test('loadCatalog はローカルパス指定のカタログを読める', async
   assert.equal(loaded.items.length, catalog.items.length);
 });
 
+test('ローカルカタログは mtime が同じ間は解析結果を再利用し、更新後に読み直す', async () => {
+  const { env, catalog, catalogPath } = setupFixtureEnv();
+  const first = await loadCatalog({ env, includeInstalled: false });
+  assert.equal(await loadCatalog({ env, includeInstalled: false }), first);
+  writeFileSync(catalogPath, JSON.stringify({ ...catalog, items: [...catalog.items, { id: 'new', category: 'still' }] }));
+  const updated = new Date(Date.now() + 5000);
+  utimesSync(catalogPath, updated, updated);
+  const next = await loadCatalog({ env, includeInstalled: false });
+  assert.notEqual(next, first);
+  assert.equal(next.items.at(-1).id, 'new');
+});
+
 test('catalog cache drops files for locked and Pro items before writing and on old-cache reads', async () => {
   const { env, home, catalog } = setupFixtureEnv();
   catalog.items[0].tier = 'free';
@@ -88,6 +100,19 @@ test('composeState: ローカルに実体があるものは cached になる', a
   assert.equal(free.state, 'cached');
 });
 
+test('composeState: cached preview uses local filename over catalog key', async () => {
+  const { env, home, catalog, catalogPath } = setupFixtureEnv();
+  catalog.items[0].preview = 'still/mini-still/v1/preview.png';
+  writeFileSync(catalogPath, JSON.stringify(catalog));
+  const dir = path.join(home, 'assets', 'still', 'mini-still');
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(path.join(dir, 'preview.png'), 'local preview');
+  const item = (await composeState({ env })).items.find(entry => entry.id === 'mini-still');
+  assert.equal(item.state, 'cached');
+  assert.equal(item.preview, 'preview.png');
+  assert.equal(item.libraryDir, dir);
+});
+
 test('composeState: legacy local-only metadata without tier displays free while catalog stays fail-closed', async () => {
   const { env, home, catalog, catalogPath } = setupFixtureEnv();
   const dir = path.join(home, 'assets', 'audio', 'old-local');

package/vendor/packages/asset-resolver/test/fixtures/fragment-root-timing.json

@@ -0,0 +1,35 @@
+{
+  "version": 1,
+  "cases": [
+    {
+      "name": "comment and child timing",
+      "source": "<!-- data-duration=\"90\" -->\n<div data-start=\"0\" data-duration=\"8\"><span data-duration=\"2\">text</span></div>",
+      "plain": "<!-- data-duration=\"90\" -->\n<div><span data-duration=\"2\">text</span></div>",
+      "preserved": "<!-- data-duration=\"90\" -->\n<div data-akari-natural-duration=\"8\"><span data-duration=\"2\">text</span></div>"
+    },
+    {
+      "name": "leading style and existing natural duration",
+      "source": "<style>.x{color:red}</style><div data-start=0 data-duration=6 data-akari-natural-duration=\"9\">text</div>",
+      "plain": "<style>.x{color:red}</style><div data-akari-natural-duration=\"9\">text</div>",
+      "preserved": "<style>.x{color:red}</style><div data-akari-natural-duration=\"9\">text</div>"
+    },
+    {
+      "name": "duration before class",
+      "source": "<div data-start=\"0\" data-duration=\"4\" class=\"x\">text</div>",
+      "plain": "<div class=\"x\">text</div>",
+      "preserved": "<div class=\"x\" data-akari-natural-duration=\"4\">text</div>"
+    },
+    {
+      "name": "start only with child duration",
+      "source": "<div data-start=\"3\"><span data-duration=\"2\">text</span></div>",
+      "plain": "<div><span data-duration=\"2\">text</span></div>",
+      "preserved": "<div><span data-duration=\"2\">text</span></div>"
+    },
+    {
+      "name": "single quoted duration",
+      "source": "<div data-duration='2.5' data-start='0'>text</div>",
+      "plain": "<div>text</div>",
+      "preserved": "<div data-akari-natural-duration=\"2.5\">text</div>"
+    }
+  ]
+}