akari-video 1.2.0-beta.1 → 1.2.0-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.2.0-beta.1",
+  "version": "1.2.0-beta.3",
   "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/vendor/.akari-capability-sources.json

@@ -83,6 +83,8 @@
     "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",

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` が実数と違う |

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-09-02-audio-clip-fx-v1.md

@@ -29,8 +29,8 @@ lint warning として無視する。legacy と v2 の投影は上表の値を
 lowcut は同一の 2 次 highpass を 2 段カスケードし、24 dB/oct の減衰特性で L1 ゲート
 （1 oct 下で 15 dB 以上の減衰）を満たすための裁定逸脱とする。
 
-denoise は `fft` なら `afftdn=nr=<12+strength*76>:nf=-30`、`nlm` なら
-`anlmdn=s=<0.00001+strength*0.0002>` とする。rubberband は `speed != 1` または
+denoise は `fft` なら `afftdn=nr=<6+strength*18>:nf=-50:tn=1`、`nlm` なら
+`anlmdn=s=<10^(-5+4*strength)>` とする。rubberband は `speed != 1` または
 `pitch_semitones != 0` のときだけ作る。全キーが既定なら入力もフィルタも追加せず、従来の
 filtergraph をバイト単位で維持する。
 
@@ -54,3 +54,21 @@ mtime・in/out・pad・recipe に加え、`atrim` を含む完全なフィルタ
 receipt の `provenance.audio.clip_fx` は `processed_items` と `filters` の件数を持つ。
 プレビューと書き出しで意図的に残す近似は、サイドカー FLAC の再圧縮とデコーダ／サンプル境界の
 差だけとする。
+
+## 2026-10-08 改訂 — ノイズ除去の対応式
+
+- `fft`: 旧 `afftdn=nr=<12+strength*76>:nf=-30` から、ノイズ床を追従する
+  `afftdn=nr=<6+strength*18>:nf=-50:tn=1` へ変更した。旧式の固定ノイズ床は声の
+  4〜8 kHz を 14〜18 dB、8〜16 kHz を 37〜50 dB 削ってこもらせていた。新式の声の
+  4〜8 kHz の減少は実測 0.7〜1.7 dB。騒がしい録音の 8〜16 kHz は `nr=12` で最大
+  5.9 dB、`nr=24` で最大 15.9 dB 減るため、`nr` の上限を 24 に抑える。
+- `nlm`: 旧 `anlmdn=s=<0.00001+strength*0.0002>` から、強さを広く使える対数式
+  `anlmdn=s=<10^(-5+4*strength)>`（`s` は 0.00001〜0.1）へ変更した。実測では声の
+  各帯域の変化は 0.4 dB 以内、弱い声の 8〜16 kHz の減少も 2.1 dB 以内。無音部の
+  ノイズは strength 0.5・SNR 38 dB で 21〜54 dB、strength 0.75・SNR 26 dB で
+  10〜36 dB、strength 1・SNR 19 dB で 5〜20 dB 減少した。処理時間は `fft` の約
+  10 倍だが、実時間の約 12 倍速で処理できた。
+- 宣言済みの denoise を持つプロジェクトは、プレビューと書き出しの音が変わる。`fft` は
+  こもりが消え、効きは控えめになる。`nlm` は同じ strength で効きが強くなる。
+  サイドカーの cache key にはフィルタ文字列が入るため、自動で作り直される。
+  おすすめは `nlm`・`0.75`。

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-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.2.0-beta.1",
+  "version": "1.2.0-beta.3",
   "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/edit-lint/src/engine-capabilities.json

@@ -103,6 +103,7 @@
     { "path": "tracks[].items[].source.part", "applies_to": ["overlays"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/overlay-runtime/src/parts.mjs applyPartMask/expandBagOverlays" },
     { "path": "tracks[].items[].source.style", "applies_to": ["overlays"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/overlay-runtime/src/parts.mjs applyPartMask/serializeInlineStyle" },
     { "path": "tracks[].items[].source.text", "applies_to": ["overlays"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/overlay-runtime/src/parts.mjs applyPartMask" },
+    { "path": "tracks[].items[].source.elements", "applies_to": ["overlays"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/overlay-runtime/src/parts.mjs applyElementOverrides" },
     { "path": "tracks[].items[].source.exclude", "applies_to": ["overlays"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/overlay-runtime/src/parts.mjs projectBagChildren/expandBagOverlays" },
     { "path": "tracks[].items[].source.exclude", "applies_to": ["captions"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/edit-store/src/tree-ops.ts collectExcludedCaptionIds/filterCaptionRootByExcludedIds; both page-builder loadAndBuild functions" },
     { "path": "tracks[].items[].source.derivedFrom", "applies_to": ["overlays"], "gpu": "other-subsystem", "osr": "other-subsystem", "consumer": "overlay authoring provenance", "evidence": "packages/edit-store/src/internal-model.ts buildV2VisualItem stores derivedFrom on InternalHtmlSource; packages/overlay-runtime/src/parts.mjs does not use it for pixels" },

package/vendor/packages/edit-lint/src/lint/edit-v2.mjs

@@ -5,6 +5,7 @@ import { EPSILON, addFinding, effectiveSourceOut, formatNumber, isFiniteNumber,
 import { isStillImageSourcePath, resolveItemAnchors, toAnchorCaptions } from "./external.mjs";
 import { validateAudioClipFxDeclaration, validateAudioDuckKeys, validateAudioEnvelopeDeclaration } from "./audio.mjs";
 import { validateAdjust, validateChromaKey, validateLook } from "./look-adjust.mjs";
+import { resolveElementAddresses } from "../../../overlay-runtime/src/parts.mjs";
 
 const MOTION_IN_OUT_PRESETS = new Set(["fade", "slide-up", "slide-down", "slide-left", "slide-right", "scale", "wipe", "pop", "zoom", "twirl"]);
 
@@ -723,6 +724,22 @@ export async function validateV2ObjectTreeFiles(edit, findings, paths) {
   for (const { item, path: itemPath } of entries) {
     if (!isRecord(item.source)) continue;
     const source = item.source;
+    if (source.kind === "html" && isRecord(source.elements) && Object.keys(source.elements).length > 0) {
+      let html = "";
+      try {
+        html = await readFile(resolve(paths.projectRoot, source.path), "utf8");
+      } catch {
+        // The existing overlay file check reports a missing fragment.
+      }
+      for (const address of resolveElementAddresses(html, Object.keys(source.elements)).missing) {
+        addFinding(findings, {
+          severity: "warning",
+          check: "v2.element-ref",
+          message: `HTML element address was not found at source level: ${address}`,
+          path: `${itemPath}.source.elements[${JSON.stringify(address)}]`,
+        });
+      }
+    }
     if (source.kind === "html" && (isNonEmptyString(source.part) || Array.isArray(source.exclude))) {
       let html = "";
       try {

package/vendor/packages/edit-store/lib/canonical.js

@@ -164,8 +164,18 @@ function inlineField(key, value, item) {
     if (item && key === 'transform' && isRecord(value) && (value.scaleX !== undefined || value.scaleY !== undefined)) {
         return inlineObject({ ...(0, transform_1.normalizeTransform)(value) }, ['x', 'y', 'scale', 'scaleX', 'scaleY', 'rotate']);
     }
-    if (item && key === 'source' && isRecord(value))
-        return inlineObject(value, ['kind', 'canvas']);
+    if (item && key === 'source' && isRecord(value)) {
+        const source = { ...value };
+        if (source.kind === 'html' && isRecord(source.elements)) {
+            const elements = Object.fromEntries(Object.entries(source.elements)
+                .filter(([, entry]) => isRecord(entry) && isRecord(entry.style) && Object.keys(entry.style).length > 0));
+            if (Object.keys(elements).length)
+                source.elements = elements;
+            else
+                delete source.elements;
+        }
+        return inlineObject(source, ['kind', 'canvas']);
+    }
     if (item && key === 'keyframes' && Array.isArray(value)) {
         return `[${value.map(point => inlineOrdered(point, edit_v2_keys_1.KEYFRAME_V2_KEYS)).join(', ')}]`;
     }

package/vendor/packages/edit-store/lib/edit-v2-item-write.d.ts

@@ -33,6 +33,11 @@ export type PreviewItemWriteCommand = ({
                 y: number;
             };
         }[];
+        element?: {
+            ref: string;
+            tag: string;
+            style: Record<string, string | null>;
+        };
     };
 } | {
     kind: 'layer';

package/vendor/packages/edit-store/lib/edit-v2-item-write.js

@@ -51,7 +51,7 @@ function resolvePreviewItemWriteBatch(editText, commands) {
     }
     let candidateText = editText;
     for (const command of commands) {
-        if (command.kind === 'overlay' && 'html' in command.patch) {
+        if (command.kind === 'overlay' && ('html' in command.patch || 'element' in command.patch)) {
             throw new Error('バッチでは外部 HTML 本文を書き込めません');
         }
         const resolved = resolvePreviewItemWrite(candidateText, command);
@@ -142,6 +142,40 @@ function resolveV2Write(parsed, command) {
         }
     };
     if (command.kind === 'overlay') {
+        if (command.patch.element) {
+            const { ref, tag, style } = command.patch.element;
+            if (item.source.kind !== 'html' || item.source.part) {
+                throw new Error(`要素の書き戻し対象ではありません: ${itemId}`);
+            }
+            if (['transform', 'html', 'text', 'duplicate', 'params', 'vars', 'xyKeyframes']
+                .some(key => key in command.patch)
+                || !/^[#.][^\s\[\]]+\[(0|[1-9]\d*)\]$/u.test(ref)
+                || !/^[a-z][a-z0-9-]*$/u.test(tag)
+                || !isRecord(style) || Object.keys(style).length === 0) {
+                throw new Error('要素の書き戻し指定が不正です');
+            }
+            const source = item.source;
+            const elements = { ...source.elements };
+            const current = { ...elements[ref]?.style };
+            for (const [key, value] of Object.entries(style)) {
+                if (!/^[a-z][a-z0-9-]*$/u.test(key) || (value !== null && typeof value !== 'string')) {
+                    throw new Error('要素の style が不正です');
+                }
+                if (value === null || value === '')
+                    delete current[key];
+                else
+                    current[key] = value;
+            }
+            if (Object.keys(current).length)
+                elements[ref] = { style: current };
+            else
+                delete elements[ref];
+            if (Object.keys(elements).length)
+                source.elements = elements;
+            else
+                delete source.elements;
+            return { candidateText: stringifyEdit(edit) };
+        }
         if ('text' in command.patch) {
             if (typeof command.patch.text !== 'string') {
                 throw new Error('部品の text は文字列である必要があります');

package/vendor/packages/edit-store/lib/edit-v2.d.ts

@@ -118,6 +118,9 @@ export interface HtmlSourceV2 {
     part?: string;
     style?: Record<string, string>;
     text?: string;
+    elements?: Record<string, {
+        style: Record<string, string>;
+    }>;
     exclude?: string[];
     derivedFrom?: string;
     vars?: Record<string, unknown>;

package/vendor/packages/edit-store/lib/edit-v2.js

@@ -491,7 +491,7 @@ function validateItemSource(value, path, sourceIds) {
                 throw invalid(`${path}.mute`, 'boolean である必要があります');
             return;
         case 'html':
-            requireExactKeys(value, new Set(['kind', 'path', 'part', 'style', 'text', 'exclude', 'derivedFrom', 'vars', 'params']), path);
+            requireExactKeys(value, new Set(['kind', 'path', 'part', 'style', 'text', 'elements', 'exclude', 'derivedFrom', 'vars', 'params']), path);
             requireText(value.path, `${path}.path`);
             for (const key of ['part', 'derivedFrom'])
                 if (hasOwn(value, key))
@@ -500,6 +500,18 @@ function validateItemSource(value, path, sourceIds) {
                 throw invalid(`${path}.text`, '文字列である必要があります');
             if (hasOwn(value, 'style'))
                 validateStringMap(value.style, `${path}.style`);
+            if (hasOwn(value, 'elements')) {
+                requireRecord(value.elements, `${path}.elements`);
+                for (const [address, override] of Object.entries(value.elements)) {
+                    if (!/^[#.][^\s\[\]]+\[(0|[1-9]\d*)\]$/.test(address))
+                        throw invalid(`${path}.elements.${address}`, '要素の番地が不正です');
+                    requireRecord(override, `${path}.elements.${address}`);
+                    requireExactKeys(override, new Set(['style']), `${path}.elements.${address}`);
+                    if (!hasOwn(override, 'style'))
+                        throw invalid(`${path}.elements.${address}.style`, 'style が必要です');
+                    validateStringMap(override.style, `${path}.elements.${address}.style`);
+                }
+            }
             if (hasOwn(value, 'exclude'))
                 validateStringList(value.exclude, `${path}.exclude`);
             if (hasOwn(value, 'vars'))

package/vendor/packages/edit-store/lib/generated/edit-v2-keys.d.ts

@@ -1,5 +1,5 @@
 export declare const ITEM_V2_KEYS: readonly ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "mask", "maskFeather", "regions", "erase", "flip", "frame", "source", "audio", "role", "link", "cut_edge", "mute", "gain_db", "denoise", "lowcut_hz", "fade_in", "fade_out", "fade_in_shape", "fade_out_shape", "ducking", "duck_db", "duck_attack", "duck_release", "script", "reading", "caption_ref", "provenance"];
-export declare const ITEM_SOURCE_V2_KEYS: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key", "pitch_semitones", "formant", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params", "shape", "preset", "baked", "from", "filter", "canvas", "id"];
+export declare const ITEM_SOURCE_V2_KEYS: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key", "pitch_semitones", "formant", "path", "part", "style", "text", "elements", "exclude", "derivedFrom", "vars", "params", "shape", "preset", "baked", "from", "filter", "canvas", "id"];
 export declare const KEYFRAME_V2_KEYS: readonly ["t", "transform", "crop", "perspective", "opacity", "gain_db", "animator", "easing"];
 export declare const MOTION_V0_KEYS: readonly ["in", "out", "loop"];
 export declare const ANIMATOR_V0_KEYS: readonly ["id", "basis", "shape", "start", "end", "offset", "randomize", "amount", "ease"];
@@ -19,7 +19,7 @@ export declare const ITEM_V2_KEYS_BY_DEFINITION: {
 export declare const ITEM_SOURCE_V2_KEYS_BY_DEFINITION: {
     readonly itemSourceMediaV2: readonly ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key"];
     readonly itemSourceAudioMediaV2: readonly ["kind", "src", "in", "out", "speed", "pitch_semitones", "formant"];
-    readonly itemSourceHtmlV2: readonly ["kind", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params"];
+    readonly itemSourceHtmlV2: readonly ["kind", "path", "part", "style", "text", "elements", "exclude", "derivedFrom", "vars", "params"];
     readonly itemSourceShapeV2: readonly ["kind", "shape", "params"];
     readonly itemSourceTelopV2: readonly ["kind", "preset", "params", "baked", "from"];
     readonly itemSourceFilterV2: readonly ["kind", "filter"];

package/vendor/packages/edit-store/lib/generated/edit-v2-keys.js

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ITEM_SOURCE_V2_KEYS_BY_DEFINITION = exports.ITEM_V2_KEYS_BY_DEFINITION = exports.SOURCE_KIND_V2 = exports.MOTION_FILE_V0_KEYS = exports.ANIMATOR_V0_KEYS = exports.MOTION_V0_KEYS = exports.KEYFRAME_V2_KEYS = exports.ITEM_SOURCE_V2_KEYS = exports.ITEM_V2_KEYS = void 0;
 exports.ITEM_V2_KEYS = ["id", "name", "hidden", "locked", "at", "duration", "anchor", "transform", "opacity", "blend", "crop", "adjust", "perspective", "motion", "animator", "keyframes", "items", "mask", "maskFeather", "regions", "erase", "flip", "frame", "source", "audio", "role", "link", "cut_edge", "mute", "gain_db", "denoise", "lowcut_hz", "fade_in", "fade_out", "fade_in_shape", "fade_out_shape", "ducking", "duck_db", "duck_attack", "duck_release", "script", "reading", "caption_ref", "provenance"];
-exports.ITEM_SOURCE_V2_KEYS = ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key", "pitch_semitones", "formant", "path", "part", "style", "text", "exclude", "derivedFrom", "vars", "params", "shape", "preset", "baked", "from", "filter", "canvas", "id"];
+exports.ITEM_SOURCE_V2_KEYS = ["kind", "src", "in", "out", "framing", "transition_out", "freeze", "fx", "speed", "gain_db", "mute", "chroma_key", "pitch_semitones", "formant", "path", "part", "style", "text", "elements", "exclude", "derivedFrom", "vars", "params", "shape", "preset", "baked", "from", "filter", "canvas", "id"];
 exports.KEYFRAME_V2_KEYS = ["t", "transform", "crop", "perspective", "opacity", "gain_db", "animator", "easing"];
 exports.MOTION_V0_KEYS = ["in", "out", "loop"];
 exports.ANIMATOR_V0_KEYS = ["id", "basis", "shape", "start", "end", "offset", "randomize", "amount", "ease"];
@@ -236,6 +236,7 @@ exports.ITEM_SOURCE_V2_KEYS_BY_DEFINITION = {
         "part",
         "style",
         "text",
+        "elements",
         "exclude",
         "derivedFrom",
         "vars",

package/vendor/packages/edit-store/lib/internal-model.d.ts

@@ -28,6 +28,9 @@ export interface InternalHtmlSource {
     part?: string;
     style?: Record<string, string>;
     text?: string;
+    elements?: Record<string, {
+        style: Record<string, string>;
+    }>;
     exclude?: string[];
     derivedFrom?: string;
 }

package/vendor/packages/edit-store/lib/internal-model.js

@@ -806,6 +806,7 @@ function buildV2VisualItem(item, fps, ref, pathOf, chromaKeyOf, legacyIndexCount
                         ...(item.source.part !== undefined ? { part: item.source.part } : {}),
                         ...(item.source.style !== undefined ? { style: item.source.style } : {}),
                         ...(item.source.text !== undefined ? { text: item.source.text } : {}),
+                        ...(item.source.elements !== undefined ? { elements: item.source.elements } : {}),
                         ...(item.source.exclude !== undefined ? { exclude: item.source.exclude } : {}),
                         ...(item.source.derivedFrom !== undefined ? { derivedFrom: item.source.derivedFrom } : {})
                     },

package/vendor/packages/edit-store/lib/tasks-store.d.ts

@@ -0,0 +1,36 @@
+export interface TaskRecord {
+    id: string;
+    source: string;
+    state: string;
+    createdAt: string;
+    [key: string]: unknown;
+}
+export interface TasksDocument {
+    version: number;
+    tasks: TaskRecord[];
+    [key: string]: unknown;
+}
+export type TasksReadResult = {
+    ok: true;
+    exists: boolean;
+    doc: TasksDocument;
+    version: number;
+    tasks: TaskRecord[];
+    warnings: string[];
+} | {
+    ok: false;
+    reason: 'broken' | 'newer';
+    version?: number;
+    warnings: string[];
+};
+export declare function readTasksFile(filePath: string): Promise<TasksReadResult>;
+export declare function writeTasksFile(filePath: string, doc: TasksDocument): Promise<void>;
+export declare function withTasksLock<T>(filePath: string, operation: () => Promise<T>): Promise<T>;
+export declare function nextTaskId(tasks: readonly Partial<TaskRecord>[]): string;
+export declare function applyTaskPatch(task: TaskRecord, patch: Record<string, unknown>, actor: 'human' | 'app' | 'agent'): TaskRecord;
+export declare function deriveTasks(reviewJsonText: string | null | undefined, overlayDoc: TasksDocument): {
+    tasks: TaskRecord[];
+    warnings: string[];
+};
+export declare function toOverlayEntry(derivedTask: TaskRecord, existingTasks?: readonly TaskRecord[]): TaskRecord;
+export declare function importSentAnnotationIds(overlay: TasksDocument, ids: readonly string[]): TasksDocument;