akari-video 0.1.40 → 0.1.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "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/self-update.mjs

@@ -8,7 +8,7 @@ import { resolveAkariHome } from './update-check.mjs';
 
 /**
  * `akari update` の実適用（update-and-versioning 契約（内部リポ）§11）:
- * フィードの `components.app`（install.sh が入れるフル構成ソース tarball）を
+ * フィードの `components.app`（install.sh と共通のソース tarball、既定は CLI + プレビュー）を
  * DL → sha256 検証 → `~/.akari/staging/<version>/` へ展開 →（検証完了までスワップ開始しない）
  * → `~/.akari/app` と rename ベースで入れ替え → 旧版は `~/.akari/app-previous/` に 1 世代保持。
  *
@@ -106,8 +106,22 @@ function extractTarGz({ tarPath, destDir }) {
   }
 }
 
-/** install.sh `update_install()` と同じ意味論: 適用後に npm install で node_modules を整合させる。 */
+/** 展開先だけを CLI 用に絞る。明示的なシェル opt-in 時は配布元の設定を保持する。 */
+export function applyCliOnlyWorkspaces({ cwd }) {
+  if (process.env.AKARI_INSTALL_SHELL === '1') return;
+  const packagePath = join(cwd, 'package.json');
+  const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+  pkg.workspaces = ['packages/*'];
+  writeFileSync(packagePath, JSON.stringify(pkg, null, 2) + '\n');
+}
+
+/** install.sh と同じ意味論: スワップ後に CLI 用 workspaces を適用して npm install する。 */
 function defaultRunNpmInstall({ cwd }) {
+  try {
+    applyCliOnlyWorkspaces({ cwd });
+  } catch (error) {
+    return { ok: false, message: error.message };
+  }
   const result = spawnSync('npm', ['install', '--no-audit', '--no-fund', '--loglevel=error'], { cwd, stdio: 'pipe' });
   if (result.error) {
     return { ok: false, message: result.error.message };

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

@@ -61,6 +61,9 @@
     "docs/contract-2026-09-02-shape-item-v0.md",
     "docs/contract-2026-09-02-transcript-unrecognized-spans-v0.md",
     "docs/contract-2026-09-02-word-book-v0.md",
+    "docs/contract-2026-09-03-clip-adjust-v0.md",
+    "docs/contract-2026-09-03-preview-playback-rate-v1.md",
+    "docs/contract-2026-09-05-clip-adjust-v1.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
@@ -71,8 +74,6 @@
     "packages/asset-resolver/README.md",
     "packages/audio-library-setup/package.json",
     "packages/audio-library-setup/README.md",
-    "packages/bake-layer/package.json",
-    "packages/bake-layer/README.md",
     "packages/chat-bridge/package.json",
     "packages/creator-root/package.json",
     "packages/decision-cards/package.json",
@@ -108,9 +109,6 @@
     "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",
-    "packages/template-render/README.md",
     "packages/word-book/package.json",
     "skills/address-review/SKILL.md",
     "skills/analyze-footage/analysis-json.md",

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

@@ -78,7 +78,7 @@ assets/                     ← 当面はローカルディレクトリ。コミ
   値へ付く単位だけを書き、**無単位の倍率・比率（短辺比など）では `unit` を省略する**。
   意味は `label` に書く（例「木枠の太さ（短辺比。0 で枠なし）」）。この規律により、
   ツールが `--var board-width=940` を `940px` へ、比率のツマミは数値のまま渡せる
-  （`packages/template-render`）。ここを混ぜると `width: 940` という無効な CSS が生まれ、
+  （HTML 素材のパラメータ展開）。ここを混ぜると `width: 940` という無効な CSS が生まれ、
   **絵は変わるが「効いた」のではなく「壊れた」**という誤検知が検査側にも起きる
 - `knobs.type` の語彙: `text` / `color` / `slider` / `dropdown` / `checkbox` / `media`
   （.mogrt と同じ心的モデル。世界中のモーションデザイナーが既に知っている語彙）
@@ -400,8 +400,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 
 現在の収録:
 
-- `presets/telop/` — ATF テロップテンプレート 36 件。`packages/bake-layer` が
-  `--preset <id>` から `presets/telop/<id>/template.json` を解決する
+- ATF テロップの参照表と描画器は退役。HTML 素材版は Lab で取得する。既存の baked は再生互換を維持する。
 - `presets/luts/` — 3D LUT 2 件（自前生成）。`packages/render-cut/src/plan.mjs` が
   `edit.json` の `output.look.lut`（区切り文字を含まない名前）から
   `presets/luts/<id>/<id>.cube` を解決する

package/vendor/docs/contract-2026-07-22-render-basics.md

@@ -27,6 +27,8 @@
 
 - 除外（次段送り）: ブレンドモード・PinP・プリレンダ合成レール（レイヤー機構が前提のため）
 
+現況（2026-09-05）: ffmpeg `lut3d` 経路は撤去済み。`output.look` は frame-engine の最終パス（WebGL2 LUT）で gpu / osr の 2 出口が適用し、per-clip の色補正は `docs/contract-2026-09-03-clip-adjust-v0.md` §4 の順（item adjust → 合成 → look）で同じエンジンが適用する。
+
 ## 2. 横断要件
 
 1. schema は**追記のみ**（既存 edit.json が全て無変更で valid のまま）。validate-edit /

package/vendor/docs/contract-2026-09-03-clip-adjust-v0.md

@@ -0,0 +1,167 @@
+> v1（curves / wheels / hue）で拡張。正本は [contract-2026-09-05-clip-adjust-v1.md](contract-2026-09-05-clip-adjust-v1.md)。
+# edit.json v2 clip adjust v0 契約
+
+- 日付: 2026-09-03
+- lifecycle: accepted
+- 位置づけ: v2 visual item 共通の per-clip カラー補正語彙と、その段階導入契約
+
+## 0. 位置づけ
+
+`adjust` は、1 個の visual item に基本補正と 3D LUT を適用する任意フィールドである。値の保存、
+検証、プレビュー、GPU / OSR 書き出しが同じ語彙と同じ演算順を使う。v0 は基本補正 10 項目と
+単一 LUT に限定し、カーブやホイールを混ぜない。
+
+本契約の導入は段階的に行う。M1 では schema、edit-store、validator、lint、能力台帳へ席を作る。
+エンジン消費が入るまでは、正しく保存できる値であっても GPU / OSR の能力台帳では `ignored`、
+`runtime_warning: true` とし、edit-lint は `engine.unsupported-field` error を返す。未実装を黙って
+描画したように扱わない。
+
+## 1. 席
+
+席は `edit.json` version 2 の visual lane にある `tracks[].items[].adjust` である。現行 schema の
+本契約対象の visual item（media / html / telop / filter / group / captions / caption）に共通し、audio lane
+の item には置かない。
+
+```jsonc
+{
+  "version": 2,
+  "tracks": [{
+    "id": "visual",
+    "lane": "visual",
+    "items": [{
+      "id": "clip-1",
+      "at": 0,
+      "duration": 90,
+      "adjust": {
+        "basic": { "exposure": 0.35, "temperature": -0.1, "saturation": 0.15 },
+        "lut": { "lut": "cinematic-warm", "intensity": 0.8 },
+        "sections": { "basic": true, "lut": true }
+      },
+      "source": { "kind": "media", "src": "main", "in": 0, "out": 3 }
+    }]
+  }]
+}
+```
+
+version 0 / 1 の `cuts[]` と `layers[]` には `adjust` の席を追加しない。
+
+## 2. 語彙
+
+`adjust` は追加キーを許さない object で、全フィールドが任意である。
+
+| field | 型 | 範囲・既定 |
+|---|---|---|
+| `basic` | object | 追加キー不可。各値の省略は `0`（中立） |
+| `lut` | `null` または object | `null` / 省略は LUT 無し |
+| `sections` | object | `basic?` / `lut?` の boolean だけを持つ疎辞書 |
+
+`basic` の 10 項目は次のとおりである。
+
+| field | 範囲 | 単位・中立 |
+|---|---:|---|
+| `exposure` | `-3..3` | EV、`0` |
+| `contrast` | `-1..1` | `0` |
+| `highlights` | `-1..1` | `0` |
+| `shadows` | `-1..1` | `0` |
+| `blacks` | `-1..1` | `0` |
+| `whites` | `-1..1` | `0` |
+| `temperature` | `-1..1` | `0` |
+| `tint` | `-1..1` | `0` |
+| `vibrance` | `-1..1` | `0` |
+| `saturation` | `-1..1` | `0` |
+
+`lut` object は追加キー不可で、空でない文字列 `lut` を必須とし、任意の `intensity` は `0..1`、
+省略時 `1` とする。
+
+## 3. 基本補正の数値契約
+
+演算は video-space、すなわち gamma 符号化 sRGB 値のまま行う。scene-linear へ変換しない。
+入力チャンネルを `c = (r, g, b)`、`clamp01(x) = min(1, max(0, x))`、Rec.709 luma を
+`Y(c) = 0.2126r + 0.7152g + 0.0722b` とする。`smoothstep(a,b,x)` は
+`t = clamp01((x-a)/(b-a))`、`t²(3-2t)` である。
+
+演算順は固定で、次の順に進める。
+
+1. exposure: `c *= 2^exposure`。
+2. white balance: `r *= 1 + temperature*0.18`、`b *= 1 - temperature*0.18`、
+   `g *= 1 - tint*0.12` とし、各チャンネルを `clamp01` する。
+3. tone zones: highlights → shadows → whites → blacks の順に処理する。各有効ステップの直前に
+   現在の `c` から luma を再計算し、処理後は各チャンネルを `clamp01` する。
+   - highlights: `c *= 1 + highlights*smoothstep(0.5,0.9,Y(c))`
+   - shadows: `c *= 1 + shadows*(1-smoothstep(0.1,0.5,Y(c)))`
+   - whites: `c += whites*smoothstep(0.7,1.0,Y(c))*0.3`
+   - blacks: `c += blacks*(1-smoothstep(0.0,0.3,Y(c)))*0.3`
+4. contrast: 各チャンネルを `(c-0.5)*(1+contrast)+0.5` とし、`clamp01` する。pivot は `0.5`。
+5. saturation: 現在の Rec.709 luma を使い、各チャンネルを
+   `Y(c) + (c-Y(c))*(1+saturation)` として `clamp01` する。
+6. vibrance: 現在値の `max` と `min` から
+   `S = max > 1e-6 ? (max-min)/max : 0`、`amount = vibrance*(1-S)` を求め、各チャンネルを
+   `Y(c) + (c-Y(c))*(1+amount)` として `clamp01` する。
+7. 外部 LUT: `lut` が有効なら trilinear sampler で `c` を置換し、`intensity` で identity 入力と
+   LUT 出力を線形混合する。
+
+定数の正本値は `REC709 = (0.2126, 0.7152, 0.0722)`、`TEMP_COEF = 0.18`、
+`TINT_COEF = 0.12`、`CONTRAST_PIVOT = 0.5` である。基本補正を LUT に bake する消費者は
+`LUT_3D_SIZE 33`、R fastest → G → B、各成分小数 6 桁とし、適用時は trilinear 補間する。
+
+## 4. 解決順とバイパス
+
+処理順は次で固定する。
+
+1. item の `adjust.basic`
+2. 同じ item の `adjust.lut`
+3. timeline 上の item 合成
+4. `output.look`（全体へ掛けるグローバル LUT）
+
+`adjust.lut.lut` の参照解決は `output.look.lut` と同じである。値にスラッシュが無ければ
+`presets/luts/<id>/<id>.cube`、スラッシュがあればプロジェクトルート相対パスとして解決する。
+パス区切りは Windows と POSIX の双方を扱う。
+
+`sections` は疎辞書であり、`sections.basic === false` のときだけ基本補正全体を、
+`sections.lut === false` のときだけ item LUT をバイパスする。キー省略は有効を意味する。
+**OFF はプレビューと書き出しの両方で必ずバイパスする。** 一方だけで OFF を無視したり、
+プレビューと書き出しで結果をずらしたりしてはならない。
+
+## 5. 消費側の約束
+
+最終消費者は GPU export と OSR export の 2 出口である。両者は同じ `adjust` 値、33³ bake、
+LUT 参照解決、適用順、sections バイパスを使い、受領情報にも item adjust の適用状況を残す。
+
+プレビューには frame-engine WebGL2 レールと DOM fallback レールがある。WebGL2 は item / quad 単位の
+LUT として適用し、DOM fallback は表現可能な基本補正を CSS 近似し、表現できない項目や LUT を
+黙って同等と称さない。どちらのレールでも `sections.* === false` を先に評価する。frame-engine active
+時は DOM fallback と二重適用しない。
+
+M1 時点では edit-store が `adjust` を内部 item declaration へ損失なく射影するところまでであり、
+GPU / OSR / frame-engine / DOM preview は未消費である。能力台帳は全 visual item 用途について
+`gpu: ignored`、`osr: ignored`、`runtime_warning: true` とし、frame-engine の未知キー警告へ到達させる。
+消費実装を導入する便でのみ、実測と同時に `consumed` へ反転する。
+
+## 6. lint 分担
+
+- JSON Schema は閉じた object、型、数値範囲、必須の `lut` 文字列、visual/audio の席を検査する。
+- `validate-edit.mjs` は依存を増やさず、同じ構造制約を手書きで検査する。
+- edit-store の v2 reader は未知キーを拒否し、型と範囲を検査して内部 declaration へ射影する。
+- edit-lint は依存ゼロを守るため同じ構造検証を意図的に重複実装する。構造が正しい場合も、M1 の
+  能力台帳に従い `--engine gpu|osr|auto` で `engine.unsupported-field` error を出す。
+
+構造エラーと未消費エラーを混同しない。構造が不正な文書は engine 能力判定へ進めない。
+
+## 7. 書き込み側・パネル側の約束
+
+書き込み側は version 2 の visual item だけを編集対象にする。version 0 / 1 を平坦な近似語彙へ
+書き換えない。`basic` が全て `0` または省略、`lut` が `null` または省略で、`sections` 以外に
+効果が無い identity 状態は `adjust` field 自体を削除する。schema は読み込み互換のため identity
+object を拒否しないが、正規の保存形は field 省略である。
+
+パネルで section を OFF にしても値は保持してよい。再度 ON にしたとき同じ値へ戻せる一方、消費側は
+OFF 中の値を必ず無視する。UI が値を表示・更新できることと、エンジンが消費済みであることは別であり、
+未消費の間は lint error と runtime warning を隠さない。
+
+## 8. 非スコープ
+
+- version 0 / 1 の `cuts[]` / `layers[]` への席追加
+- RGB curves、color wheels / CDL、hue curves、effects（M2 の語彙）
+- vignette（空間処理であり basic/LUT bake の対象外）
+- 本便での compositor、page-builder、preview、inspector、preset カタログの実装
+- 複数 LUT の `luts[]`、adjust layer の `layers[]` など v0 を越える構造

package/vendor/docs/contract-2026-09-03-preview-playback-rate-v1.md

@@ -0,0 +1,52 @@
+---
+lifecycle: accepted
+created: 2026-09-03
+updated: 2026-09-03
+---
+
+# プレビュー再生速度・ピッチ保持契約 v1
+
+## 1. UI と状態
+
+プレビューのトランスポート右側は pen → rate → zoom → fullscreen の順とする。rate ボタンは
+アイコンではなく現在値を `0.5×` の形式で表示し、ポップアップから
+`0.5 / 0.75 / 1 / 1.25 / 1.5 / 2 / 3` の 7 値を選ぶ。値域は 0.5 以上 3 以下である。
+スライダーとキーボードショートカットは設けない。
+
+速度の正本は webview の `previewRate` とする。変更値は host の当該 preview widget にだけ保持し、
+インスペクター編集による incremental 更新と webview 再構築を跨いで復元する。ディスク、Theia
+preferences、edit.json には保存せず、widget を閉じた後の新しいプレビューは 1× から始める。
+raw 素材プレビューにも同じ UI と速度を適用する。
+
+## 2. `rate` の意味
+
+`previewRate` は「出力タイムライン秒 / 実時間秒」である。`playbackTick.rate` とレビューセッションの
+`reviewTransport` に記録する `type: "rate"` の `value` は、どちらもこの値を送る。legacy の cut に
+宣言された `segment.speed` は素材秒と出力秒の写像であり、レビューの rate イベントには送らない。
+従来の segment speed 変更イベントは廃止する。
+
+frame-engine の時計は経過実時間へ `previewRate` を掛ける。legacy の動画要素は
+`segment.speed × previewRate` で再生し、gap と静止画は壁時計へ `previewRate` を掛ける。
+freeze の実時間ホールドは宣言秒を `previewRate` で割る。速度変更時は現在位置に錨を打ち直し、
+再生ヘッドを飛ばさない。
+
+## 3. 音声とピッチ保持
+
+frame-engine 経路では全音源を `PreviewAudioSupply` の master gain に集め、音源の予定時刻と
+AudioContext 時計を `previewRate` で進める。legacy 経路でも previewAudio の BGM・SFX・ナレーションを
+同じ倍率で再予定する。legacy の動画要素（台詞を含む）は `preservesPitch = true` を明示する。
+
+1× は master gain から destination への直結である。1× 以外は共通の
+`preview-audio-worklet.js` と `akari-pitch-shift` processor を使い、速度 r で再生した全音声へ
+ratio `1 / r` のピッチ補正を掛ける。worklet の準備前は速度だけを先に反映し、準備完了後に経路へ
+差し込む。読み込み失敗または AudioWorklet 非対応時も再生を止めず、警告を 1 行出して素の速度へ
+フォールバックする。
+
+frame-engine の `debug()` は `rate`、`pitchPreserved`、`stretcher` を返す。`stretcher` は
+`"worklet" | "none"`、`pitchPreserved` は 1× または worklet が実際の経路に入った場合だけ true とする。
+`attachAnalyser()` は master bus 出口へ AnalyserNode を一つだけ接続し、検収用の tap として返す。
+
+## 4. 非目標
+
+本機能はプレビュー専用である。書き出しの速度・音声処理には影響せず、edit.json の内容も変えない。
+速度の preferences 永続化、キーボードショートカット、速度スライダーは本契約の対象外とする。

package/vendor/docs/contract-2026-09-05-clip-adjust-v1.md

@@ -0,0 +1,102 @@
+---
+lifecycle: accepted
+date: 2026-09-05
+---
+
+# edit.json v2 clip adjust v1 契約
+
+## 0. 位置づけ
+
+v0 の基本補正と LUT に curves / wheels / hue を追加する。旧 src/lib/color-grade.ts の数式を正本値として移植する。
+
+## 1. 席
+
+version 2 visual item の tracks[].items[].adjust。media / html / telop / filter / group / captions / caption の 7 定義共通。audio と shape、version 0 / 1 の cuts[] / layers[] には追加しない。
+
+## 2. 語彙仕様 v1
+
+`$defs.adjustV1`（v0 の `basic` / `lut` / `sections` は不変。以下を追加。すべて任意・additionalProperties false）:
+
+- `curves`: object `{ master?, r?, g?, b? }`。各値は `[{ in: number 0..1, out: number 0..1 }]`（minItems 2・maxItems 16・
+  各点 additionalProperties false・in / out とも required）。**`in` は狭義単調増加**（schema では表現できないので
+  validate-edit / edit-store / edit-lint で検査）。チャンネル identity = ちょうど 2 点 `[{0,0},{1,1}]`（許容 1e-5）。
+- `wheels`: object `{ lift?, gamma?, gain?, offset? }`。各値は object `{ r?, g?, b? }`（number）。範囲:
+  lift ±0.25 / gamma ±0.5 / gain ±0.5 / offset ±0.1。省略 = 0（中立）。
+- `hue`: object `{ hue?, sat?, luma? }`。各値は `[{ hue: number 0..1, value: number 0..1 }]`（minItems 1・maxItems 16・
+  additionalProperties false・両方 required）。**`hue` は狭義単調増加**。中立 value = 0.5。チャンネル identity =
+  省略または全点 `|value-0.5| ≤ 1e-4`。
+- `sections`: `basic` / `lut` に加えて `curves` / `wheels` / `hue`（boolean・false のときだけバイパス）。
+- **演算順（固定）**: ① basic（v0 §3 の 1〜6）→ ② lut（trilinear・intensity 混合）→ ③ wheels → ④ curves → ⑤ hue。
+  - ③ wheels: チャンネルごとに `c = v*(1-lift)+lift` → `c = pow(max(0,c), 1/(1+gamma))` → `c *= 1+gain` → `c = clamp01(c+offset)`
+    （lift / gamma / gain / offset は当該チャンネルの値・省略 0）。
+  - ④ curves: 区分線形。点列を in 昇順に評価し、`x ≤ 最初の in` は最初の out、`x ≥ 最後の in` は最後の out、
+    それ以外は挟む 2 点で線形補間、各評価を clamp01。**master を 3 ch に適用してから r / g / b を各 ch に適用**。
+  - ⑤ hue: RGB→HSV（`d = max-min`、`d > 1e-4` のときだけ h を計算（`cmax===r: ((g-b)/d+6)%6`・`cmax===g: (b-r)/d+2`・
+    else `(r-g)/d+4`・÷6）、`s = cmax > 1e-4 ? d/cmax : 0`、`v = cmax`）→ `shift = (sample(hue, h)-0.5)*2`・
+    `h' = (h+shift+1) % 1`・`s' = clamp01(s * sample(sat, h)*2)`・`v' = clamp01(v * sample(luma, h)*2)` → HSV→RGB
+    （sector = floor(h'*6) の 6 分割・`c = s'v'`・`x = c(1-|((h'*6) mod 2)-1|)`・`m = v'-c`・各 clamp01）。
+    `sample(ch, h)` = 点列を hue 昇順で評価、0 点なら 0.5、1 点ならその value、範囲外は端点、間は線形。
+    **h の参照は 3 ch とも変換前の h**（旧実装どおり）。
+- identity 判定（書き込み側の規範）: basic 全 0・lut 無し・wheels 全 0・curves 全 ch identity・hue 全 ch identity なら
+  `adjust` field 自体を除去（v0 §7 と同じ）。
+- v1（cuts[] / layers[] 文書）には席を作らない（v0 と同じ）。
+- ルックプリセット（D13）は語彙ではない: `presets/looks/index.jsonl`（`{id, kind:"look", name, description, when_to_use}`）+
+  `presets/looks/<id>.json` = `{ "id": "<id>", "adjust": { "basic": {…}, "wheels": {…} } }`。`adjust` の中身は `$defs.adjustV1` に
+  適合すること（schema テストで担保）。
+
+基本補正は exposure ±3 EV、contrast / highlights / shadows / blacks / whites / temperature / tint / vibrance / saturation は ±1。全て任意、既定 0。lut は null または {lut: 空でない文字列, intensity?: 0..1}、intensity 既定 1。各 object は追加キー不可。
+
+## 3. 基本補正の数値契約
+
+演算は video-space、すなわち gamma 符号化 sRGB 値のまま行う。scene-linear へ変換しない。
+入力チャンネルを `c = (r, g, b)`、`clamp01(x) = min(1, max(0, x))`、Rec.709 luma を
+`Y(c) = 0.2126r + 0.7152g + 0.0722b` とする。`smoothstep(a,b,x)` は
+`t = clamp01((x-a)/(b-a))`、`t²(3-2t)` である。
+
+演算順は固定で、次の順に進める。
+
+1. exposure: `c *= 2^exposure`。
+2. white balance: `r *= 1 + temperature*0.18`、`b *= 1 - temperature*0.18`、
+   `g *= 1 - tint*0.12` とし、各チャンネルを `clamp01` する。
+3. tone zones: highlights → shadows → whites → blacks の順に処理する。各有効ステップの直前に
+   現在の `c` から luma を再計算し、処理後は各チャンネルを `clamp01` する。
+   - highlights: `c *= 1 + highlights*smoothstep(0.5,0.9,Y(c))`
+   - shadows: `c *= 1 + shadows*(1-smoothstep(0.1,0.5,Y(c)))`
+   - whites: `c += whites*smoothstep(0.7,1.0,Y(c))*0.3`
+   - blacks: `c += blacks*(1-smoothstep(0.0,0.3,Y(c)))*0.3`
+4. contrast: 各チャンネルを `(c-0.5)*(1+contrast)+0.5` とし、`clamp01` する。pivot は `0.5`。
+5. saturation: 現在の Rec.709 luma を使い、各チャンネルを
+   `Y(c) + (c-Y(c))*(1+saturation)` として `clamp01` する。
+6. vibrance: 現在値の `max` と `min` から
+   `S = max > 1e-6 ? (max-min)/max : 0`、`amount = vibrance*(1-S)` を求め、各チャンネルを
+   `Y(c) + (c-Y(c))*(1+amount)` として `clamp01` する。
+7. 外部 LUT: `lut` が有効なら trilinear sampler で `c` を置換し、`intensity` で identity 入力と
+   LUT 出力を線形混合する。
+
+定数の正本値は `REC709 = (0.2126, 0.7152, 0.0722)`、`TEMP_COEF = 0.18`、
+`TINT_COEF = 0.12`、`CONTRAST_PIVOT = 0.5` である。基本補正を LUT に bake する消費者は
+`LUT_3D_SIZE 33`、R fastest → G → B、各成分小数 6 桁とし、適用時は trilinear 補間する。
+
+## 4. 解決順とバイパス
+
+basic → lut → wheels → curves → hue → item 合成 → output.look。LUT はスラッシュなしなら presets/luts/<id>/<id>.cube、ありならプロジェクト相対（Windows / POSIX の区切り対応）。sections は false のときだけ該当段をバイパスする。OFF はプレビューと書き出しの両方でバイパスし、保存値は保持してよい。
+
+33³、R fastest → G → B、各成分 toFixed(6) の後 Float32 に格納、適用時 trilinear。正規化は範囲 clamp、点列昇順ソート、省略既定の補完。検証器は不正な点列を修復せず拒否する。補間 span < 1e-9 では左点を使用。curves identity は旧実装どおり各差の絶対値 < 1e-5、hue identity は ≤ 1e-4。basic の演算上 identity 許容は 1e-6。
+
+注: hue value=1.0 は式 (value-0.5)*2 により +360°（一周）、+180° は value=0.75。旧実装の式を優先する。
+
+## 5. 消費側の約束
+
+M2-1 時点で新 3 セクションはエンジン未消費（bake 関数は用意・plan 未配線）。2/4 便で配線。GPU / OSR と frame-engine preview は同じ全段 bake とバイパスを使う。DOM fallback は新 3 セクションを CSS 近似できないため適用せず、色調整は近似表示の指標を出す。frame-engine active 時は二重適用しない。台帳は adjust の path 単位であり本便では行を増やさない。
+
+## 6. lint 分担
+
+Schema は閉じた構造・型・範囲・点数・必須キーを検査。validate-edit / edit-store / edit-lint はさらに in / hue の狭義単調増加を検査する。依存ゼロの検証器は意図的重複。edit-lint は adjust.curves.* / adjust.wheels.* / adjust.hue.* の check id と正確な path を返す。
+
+## 7. 書き込み側・パネル側の約束
+
+全段 identity なら adjust 自体を除去する。読み取り側は identity object を許す。セクション OFF は保存値を失わず戻せる。isItemAdjustIdentity は OFF を考慮する実効判定であり、書き込み側が OFF の値を削除する指示ではない。ルック適用は basic / wheels を丸ごと置換し、lut / curves / hue は保持する。
+
+## 8. 非スコープ
+
+effects / vignette / スプリット比較、plan / compositor / page-builder / preview / inspector の配線、LUT ライブラリ。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "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/audio-library-setup/shared/bgm-suggest.mjs

@@ -1,8 +1,8 @@
 // BGM 自動提案（v0）— intake / 演出の tone 語彙 × AKARI Sounds のトラック系統の突き合わせ。
 //
 // 設計方針:
-// - tone 語彙は表現選定（skills/edit-plan/expression-selection.md / presets/telop の tone）と
-//   同じ 8 語に固定する。BGM だけ別の語彙を発明しない
+// - tone 語彙は表現選定（skills/edit-plan/expression-selection.md）と同じ 8 語に固定する。
+//   BGM だけ別の語彙を発明しない
 // - 対応表は「系統（トラック id の接頭辞）→ tone 重み」の宣言表。トラック個別の
 //   when_to_use（宣言パック = 有償レイヤ）には依存しない — 無料の catalog.json（tags / id）
 //   だけで動く

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

@@ -1086,6 +1086,9 @@ function validateEditV2(edit, findings) {
             });
           }
         }
+        if (Object.hasOwn(item, "adjust")) {
+          validateAdjust(item.adjust, findings, `${itemPath}.adjust`);
+        }
         if (Array.isArray(item.items)) visit(item.items, item, `${itemPath}.items`);
       }
     };
@@ -1421,6 +1424,14 @@ async function validateV2ObjectTreeFiles(edit, findings, paths) {
 
   const referencedMotion = new Set();
   for (const { item, path: itemPath } of entries) {
+    if (item.source?.kind === "telop" && item.source.baked === undefined) {
+      addFinding(findings, {
+        severity: "error",
+        check: "telop.retired",
+        message: "テロップ（ATF）の描画は退役しました。HTML 素材版のテロップに差し替えてください（Lab で配布）。すでに焼いた baked を持つ項目はそのまま再生できます。",
+        path: `${itemPath}.source`,
+      });
+    }
     if (isRecord(item.keyframes) && isNonEmptyString(item.keyframes.path)) {
       referencedMotion.add(item.keyframes.path);
       const filePath = resolve(paths.projectRoot, item.keyframes.path);
@@ -1551,6 +1562,105 @@ function validateLook(value, findings, path) {
   }
 }
 
+// docs/contract-2026-09-03-clip-adjust-v0.md。edit-lint は依存ゼロを保つため、schema と
+// validate-edit.mjs の閉じた adjust 語彙をここでも独立に検証する。
+function validateAdjust(value, findings, path) {
+  validateAdjustV1Sections(value, findings, path);
+  if (!isRecord(value)) {
+    addFinding(findings, {
+      severity: "error", check: "adjust.structure", message: "adjust must be an object", path,
+    });
+    return;
+  }
+  const reportUnknownKeys = (record, allowed, ownerPath) => {
+    for (const key of Object.keys(record)) {
+      if (allowed.has(key)) continue;
+      addFinding(findings, {
+        severity: "error",
+        check: "adjust.unknown-key",
+        message: `${key} is not defined by clip adjust v1`,
+        path: `${ownerPath}.${key}`,
+      });
+    }
+  };
+  reportUnknownKeys(value, new Set(["basic", "lut", "sections", "curves", "wheels", "hue"]), path);
+
+  if (Object.hasOwn(value, "basic")) {
+    const basicPath = `${path}.basic`;
+    if (!isRecord(value.basic)) {
+      addFinding(findings, {
+        severity: "error", check: "adjust.basic.structure", message: "basic must be an object", path: basicPath,
+      });
+    } else {
+      const basicKeys = new Set([
+        "exposure", "contrast", "highlights", "shadows", "blacks", "whites",
+        "temperature", "tint", "vibrance", "saturation",
+      ]);
+      reportUnknownKeys(value.basic, basicKeys, basicPath);
+      for (const key of basicKeys) {
+        if (!Object.hasOwn(value.basic, key)) continue;
+        const minimum = key === "exposure" ? -3 : -1;
+        const maximum = key === "exposure" ? 3 : 1;
+        if (!isFiniteNumber(value.basic[key]) || value.basic[key] < minimum || value.basic[key] > maximum) {
+          addFinding(findings, {
+            severity: "error",
+            check: `adjust.basic.${key}`,
+            message: `${key} must be a finite number within [${minimum}, ${maximum}]`,
+            path: `${basicPath}.${key}`,
+          });
+        }
+      }
+    }
+  }
+
+  if (Object.hasOwn(value, "lut") && value.lut !== null) {
+    const lutPath = `${path}.lut`;
+    if (!isRecord(value.lut)) {
+      addFinding(findings, {
+        severity: "error", check: "adjust.lut.structure", message: "lut must be null or an object", path: lutPath,
+      });
+    } else {
+      reportUnknownKeys(value.lut, new Set(["lut", "intensity"]), lutPath);
+      if (!isNonEmptyString(value.lut.lut)) {
+        addFinding(findings, {
+          severity: "error", check: "adjust.lut.lut", message: "lut must be a non-empty string", path: `${lutPath}.lut`,
+        });
+      }
+      if (Object.hasOwn(value.lut, "intensity")
+        && (!isFiniteNumber(value.lut.intensity) || value.lut.intensity < 0 || value.lut.intensity > 1)) {
+        addFinding(findings, {
+          severity: "error",
+          check: "adjust.lut.intensity",
+          message: "intensity must be a finite number within [0, 1]",
+          path: `${lutPath}.intensity`,
+        });
+      }
+    }
+  }
+
+  if (Object.hasOwn(value, "sections")) {
+    const sectionsPath = `${path}.sections`;
+    if (!isRecord(value.sections)) {
+      addFinding(findings, {
+        severity: "error", check: "adjust.sections.structure", message: "sections must be an object", path: sectionsPath,
+      });
+    } else {
+      const sectionKeys = new Set(["basic", "lut", "curves", "wheels", "hue"]);
+      reportUnknownKeys(value.sections, sectionKeys, sectionsPath);
+      for (const key of sectionKeys) {
+        if (Object.hasOwn(value.sections, key) && typeof value.sections[key] !== "boolean") {
+          addFinding(findings, {
+            severity: "error",
+            check: `adjust.sections.${key}`,
+            message: `${key} must be a boolean`,
+            path: `${sectionsPath}.${key}`,
+          });
+        }
+      }
+    }
+  }
+}
+
 function validateChromaKey(value, findings, path) {
   if (value === undefined || value === null) return;
   if (!isRecord(value)) {
@@ -6267,3 +6377,55 @@ function formatDb(value) {
 function messageOf(error) {
   return error instanceof Error ? error.message : String(error);
 }
+
+// Intentional dependency-free duplicate of the closed adjustV1 structure.
+function validateAdjustV1Sections(value, findings, path) {
+  if (!isRecord(value)) return;
+  const report = (section, check, at, message) => addFinding(findings, { severity: "error", check: "adjust." + section + "." + check, path: at, message });
+  const object = (v, keys, section, at) => {
+    if (!isRecord(v)) { report(section, 'structure', at, 'は object である必要があります'); return false; }
+    for (const key of Object.keys(v)) if (!keys.includes(key)) report(section, 'unknown-key', at + '.' + key, 'は未知のキーです');
+    return true;
+  };
+  const number = (v, min, max, section, at) => {
+    if (!isFiniteNumber(v) || v < min || v > max) report(section, 'range', at, 'は ' + min + ' から ' + max + ' の範囲の有限数である必要があります');
+  };
+  for (const section of ['curves', 'hue']) {
+    if (!Object.hasOwn(value, section)) continue;
+    const channels = value[section], at = path + '.' + section;
+    const axis = section === 'curves' ? 'in' : 'hue';
+    const output = section === 'curves' ? 'out' : 'value';
+    const minimum = section === 'curves' ? 2 : 1;
+    const keys = section === 'curves' ? ['master', 'r', 'g', 'b'] : ['hue', 'sat', 'luma'];
+    if (!object(channels, keys, section, at)) continue;
+    for (const channel of keys) {
+      if (!Object.hasOwn(channels, channel)) continue;
+      const points = channels[channel], channelPath = at + '.' + channel;
+      if (!Array.isArray(points) || points.length < minimum || points.length > 16) {
+        report(section, 'points', channelPath, 'は ' + minimum + ' から 16 点の配列である必要があります'); continue;
+      }
+      let previous = -Infinity;
+      for (const [index, point] of points.entries()) {
+        const pointPath = channelPath + '[' + index + ']';
+        if (!object(point, [axis, output], section, pointPath)) continue;
+        number(point[axis], 0, 1, section, pointPath + '.' + axis);
+        number(point[output], 0, 1, section, pointPath + '.' + output);
+        if (isFiniteNumber(point[axis])) {
+          if (point[axis] <= previous) report(section, 'order', pointPath + '.' + axis, 'は狭義単調増加である必要があります');
+          previous = point[axis];
+        }
+      }
+    }
+  }
+  if (Object.hasOwn(value, 'wheels')) {
+    const ranges = { lift: 0.25, gamma: 0.5, gain: 0.5, offset: 0.1 };
+    if (!object(value.wheels, Object.keys(ranges), 'wheels', path + '.wheels')) return;
+    for (const [wheel, range] of Object.entries(ranges)) {
+      if (!Object.hasOwn(value.wheels, wheel)) continue;
+      const channels = value.wheels[wheel], at = path + '.wheels.' + wheel;
+      if (!object(channels, ['r', 'g', 'b'], 'wheels', at)) continue;
+      for (const channel of ['r', 'g', 'b']) if (Object.hasOwn(channels, channel)) number(channels[channel], -range, range, 'wheels', at + '.' + channel);
+    }
+  }
+}
+

package/vendor/packages/edit-store/lib/adjust-css-approx.d.ts

@@ -0,0 +1,2 @@
+import type { AdjustBasicV0 } from './edit-v2';
+export declare function adjustBasicToCssApprox(basic: AdjustBasicV0): string;