akari-video 0.1.49 → 0.1.50

package/package.json

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

@@ -0,0 +1,20 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+
+import { resolveLauncherAssets } from "./repo-assets.mjs";
+
+export async function runCaptionsCommand(argv, options = {}) {
+  const logError = options.error ?? options.logError ?? ((line) => console.error(line));
+  const assets = options.assets ?? resolveLauncherAssets();
+  if (!assets.captionsScript || !existsSync(assets.captionsScript)) {
+    logError("akari captions の実行スクリプトが見つかりません。AKARI Video を再インストールしてください。");
+    return { exitCode: 1 };
+  }
+
+  const spawn = options.spawn ?? spawnSync;
+  const result = spawn(process.execPath, [assets.captionsScript, ...argv], {
+    stdio: "inherit",
+    cwd: options.cwd ?? process.cwd(),
+  });
+  return { exitCode: typeof result.status === "number" ? result.status : 1 };
+}

package/src/cli.mjs

@@ -22,6 +22,7 @@ import {
   triggerBackgroundRefresh
 } from './update-check.mjs';
 import { applySelfUpdate, isRunningFromAppDir, rollbackSelfUpdate } from './self-update.mjs';
+import { runCaptionsCommand } from './captions-command.mjs';
 import { runCaptureCommand } from './capture-command.mjs';
 import { runMediaCommand } from './media-command.mjs';
 import { runWordBookCommand } from './word-book-command.mjs';
@@ -43,6 +44,7 @@ export async function run(args, options = {}) {
     error(`akari ${retiredBrowserCommand} は廃止されました（Chrome は不要になりました）`);
     return { exitCode: 1 };
   }
+  if (args[0] === 'captions') return runCaptionsCommand(args.slice(1), options);
   if (args[0] === 'capture') return runCaptureCommand(args.slice(1), options);
   if (args[0] === 'media') return runMediaCommand(args.slice(1), options);
   if (args[0] === 'word-book') return runWordBookCommand(args.slice(1), options);

package/src/repo-assets.mjs

@@ -33,6 +33,7 @@ const AUDIO_FETCH_SCRIPT_RELATIVE = path.join('packages', 'audio-library-setup',
 const ASSET_RESOLVER_CLI_RELATIVE = path.join('packages', 'asset-resolver', 'bin', 'akari-assets.mjs');
 const BEATMAP_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'beatmap.mjs');
 const PROBE_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'probe-frame.mjs');
+const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'captions.mjs');
 const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
 const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
 const EYE_BAR_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'eye-bar.mjs');
@@ -69,6 +70,7 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
     assetResolverCliPath: existsSync(assetResolverCliPath) ? assetResolverCliPath : null,
     beatmapScript: existsSync(beatmapScript) ? beatmapScript : null,
     probeFrameScript: existsSync(probeFrameScript) ? probeFrameScript : null,
+    captionsScript: existsSync(path.join(repoRoot, CAPTIONS_SCRIPT_RELATIVE)) ? path.join(repoRoot, CAPTIONS_SCRIPT_RELATIVE) : null,
     captureScript: existsSync(path.join(repoRoot, CAPTURE_SCRIPT_RELATIVE)) ? path.join(repoRoot, CAPTURE_SCRIPT_RELATIVE) : null,
     renderWhenIdleScript: existsSync(renderWhenIdleScript) ? renderWhenIdleScript : null,
     eyeBarScript: existsSync(eyeBarScript) ? eyeBarScript : null,
@@ -105,6 +107,7 @@ export function resolveLauncherAssets({
     probeFrameScript: candidate.probeFrameScript ?? vendor.probeFrameScript,
     // 既存の部分資産 fixture に capture marker が無いため、未解決時だけキー自体を省く。
     ...(candidate.captureScript ?? vendor.captureScript ? { captureScript: candidate.captureScript ?? vendor.captureScript } : {}),
+    ...(candidate.captionsScript ?? vendor.captionsScript ? { captionsScript: candidate.captionsScript ?? vendor.captionsScript } : {}),
     renderWhenIdleScript: candidate.renderWhenIdleScript ?? vendor.renderWhenIdleScript,
     eyeBarScript: candidate.eyeBarScript ?? vendor.eyeBarScript,
     mediaScript: candidate.mediaScript ?? vendor.mediaScript,

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

@@ -148,6 +148,7 @@
     "skills/declare-audio/what-to-declare.md",
     "skills/edit-lint/SKILL.md",
     "skills/edit-plan/approvals-and-generation.md",
+    "skills/edit-plan/autonomy.md",
     "skills/edit-plan/avatar-resolution.md",
     "skills/edit-plan/beat-sync.md",
     "skills/edit-plan/beats.md",

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

@@ -1,7 +1,7 @@
 ---
 lifecycle: draft
 created: 2026-07-25
-updated: 2026-08-26
+updated: 2026-09-06
 ---
 
 # project-structure-v0（生成物の置き場所）契約
@@ -42,6 +42,7 @@ updated: 2026-08-26
 | 企画・プラン | `planning/` | スキル + 人間承認 |
 | エージェント中間物・ad-hoc 検証スクリプトと結果 | `.akari/work/` | スキル・エージェント |
 | 検証証跡・レポート（キーフレーム視認 PNG・render-report 等） | `.akari/reports/` | スキル |
+| 絵コンテ（タイムラインの印刷・初回だけ・AI は後から読まない） | `.akari/reports/storyboard/` | スキル |
 | キャッシュ（サムネ・プロキシ等の再生成可能物） | `.akari/cache/` | アプリ・スキル |
 | 納品物 | `exports/` | `render-cut` |
 | 契約サイドカー（既存） | `.akari/`（`sidecars/` `diffs/` `events/` 等） | 既存のまま |
@@ -242,3 +243,10 @@ updated: 2026-08-26
 - 自分がルートである git リポジトリのときだけ動く。親リポジトリの中に置かれたプロジェクトは、
   こちらが管理していないリポジトリの追跡対象を黙って変えないため対象外とする（§3 の
   「強制的にファイルを移動・削除するスクリプトは作らない」と同じ抑制）
+
+### 2026-09-06 追記: 絵コンテの置き場（判子は一回 契約 §5.2 / §14-4）
+
+絵コンテは `edit.json` / `captions.json` から描くタイムラインの派生ビューで、
+置き場は `.akari/reports/storyboard/`（レポート層 = 削除安全）とする。
+初回だけ描き更新しない・入力側に置かない・AI は後から読まない。直すときはタイムラインを
+直して描き直す。

package/vendor/docs/contract-2026-08-18-v1-render-parity.md

@@ -67,6 +67,7 @@ cut = needsGapAwareCutTimeline(edit.cuts)
 - **多段合成の意味論**: `computeVideoRuns`（`cut-timeline.mjs`）の winner-take-all スイッチ。
   ある瞬間に最も高い `track` 番号のカットが**画面全体を占有**する（同時アルファ合成ではない）
   — v0 が既定順で行っているのと全く同じモデルで、新しいリッチな合成モデルではない
+  上段の静止画は単位元 `transform` でも下段と時間的に交差する（cross-track）場合、natural size と alpha の観点から全画面不透明を証明できないため、投影時に `layers` へ退避する。
 - **音声はカット単位（ラン単位ではない）**: 各カットの `[in,out)` がそれぞれの `at` 位置で
   再生され、`amix` で重ね合わさる。画面はどちらか一方しか映らなくても、音声は両方鳴る
   （v0 の `buildGapAwareCutCommand` の音声ループをそのまま踏襲）

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

@@ -1,7 +1,7 @@
 ---
 lifecycle: accepted
 created: 2026-08-30
-updated: 2026-08-30
+updated: 2026-09-06
 ---
 
 # 動きとキーフレーム契約 v0 — 4 段階（プリセット / キーフレーム / アニメーター / コード）と `motion/` 袋
@@ -132,7 +132,7 @@ media item（cuts）での適用先 = frame-engine base 経路（2026-09-01・is
 | キー | 型 | 意味 |
 |---|---|---|
 | `id` | string | アニメーターの id（キーフレームから参照）|
-| `basis` | `chars` / `words` / `lines` / `segments` | 範囲の単位（`segments` = 文節。既存のテロップ文節分割を使う）|
+| `basis` | `chars` / `words` / `lines` / `segments` | 範囲の単位（`segments` = 文節。v1 の words フォールバックは §4.4）|
 | `shape` | `ramp` / `triangle` / `round` / `smooth` / `square` / `ramp-down` | 範囲の中の影響度カーブ（0..1）|
 | `start` / `end` | number 0..1 | 範囲（単位数に対する比）|
 | `offset` | number | 範囲の平行移動（−1..1）。**動かすのはこれ**（§4.3）|
@@ -144,13 +144,61 @@ media item（cuts）での適用先 = frame-engine base 経路（2026-09-01・is
 - 対象は `telop` / `caption`（分離した行）/ `group` の中のテキスト系アイテム。HTML 部品は L3 か `vars`
 - 既存モーション文法との対応: `--anim-stagger` ≈ `offset` をキーフレームで動かす / `--anim-distance` ≈ `amount.y` / `--anim-easing` ≈ `ease`。既存 CSS 変数はそのまま生きる（L0）。アニメーターは native アイテムの L2
 
+**司令塔裁定（2026-09-06）— 単位の位置・影響度・量を確定する**:
+
+- 単位数を `count`、0 始まりの単位順序を `u` として、**`pos(u) = (u + 0.5) / count`**（各単位の中央）を割り当てる。`randomize.seed` があるときは**整数ハッシュによる決定論シャッフル**で単位の順序を振ってから pos を割り当てる。`Math.random` / `fract(sin())` は使わない
+- `s = start + offset`、`e = end + offset` とし、影響度は **`w = shape(pos, s, e)`**。`s ≥ e` なら全 shape で `w = 0`。それ以外は次表（`clamp01(v) = max(0, min(1, v))`）
+
+| `shape` | 影響度 `w` の式 |
+|---|---|
+| `ramp` | `ramp = clamp01((pos−s)/(e−s))` |
+| `ramp-down` | `1 − ramp` |
+| `triangle` | `1 − \|2·ramp − 1\|`（中央 1 の三角）|
+| `round` | `sin(π·ramp)` |
+| `smooth` | `ramp²(3−2·ramp)` |
+| `square` | `s ≤ pos < e` で 1、それ以外は 0 |
+
+- 影響度に `ease` を掛けて **`k = ease(w)`** とする。`ease` は §2.1-(b) の語彙、既定は `linear`。各量への寄与は `amount × k`（scale の適用倍率は次表）
+
+| `amount` のキー | 単位・適用量 |
+|---|---|
+| `x` / `y` / `letterSpacing` / `blur` | 出力 px。1920 幅を基準とし、`amount × k × output.width / 1920` に比率換算する（`adjust.fx` と同じ規約）|
+| `rotate` | 度。`amount.rotate × k`。gpu では tile 中心回転 |
+| `scale` | 倍率の**増分**。適用倍率 = `1 + amount.scale × k` |
+| `opacity` | 加算量（宣言値 −1..1）。寄与 = `amount.opacity × k` |
+
 ### 4.2 合成
 
 - 同じプロパティに複数のアニメーターが効くときは §4.1 の加算規則。アニメーターと L1 キーフレームは**独立に合成**（L1 = アイテム全体、L2 = 単位ごとのずれ）
+- **司令塔裁定（2026-09-06）**: `x` / `y` / `rotate` / `letterSpacing` / `blur` は各寄与の加算、`scale` は各適用倍率の乗算。`opacity` は **Σ の後で** `clamp01(1 + Σ(amount.opacity × k))` とし、アニメーターごとにはクランプしない。単位ごとの状態を、アイテム全体の keyframes / motion の状態と独立に合成する（不透明度・倍率は乗算）
 
 ### 4.3 offset のキーフレーム
 
 - 「どの順で」は `offset` を時間で動かして表す。点は L1 と同じ配列（inline or 袋）に `"animator": { "a1": { "offset": -0.25 } }` … `{ "offset": 1 }` として打つ（典型 2 点）。**文字ごとの点は存在しない**
+- **司令塔裁定（2026-09-06）**: `offset` に加えて `start` / `end` も同じキーフレーム点で動かせる。点が無ければ宣言値で静的。`t` はアイテム相対の整数フレーム、補間は §2.1（線形 / easing / hold）に従う
+
+### 4.4 v1 の実装状態と制約（2026-09-06）
+
+- **gpu に加え、OSR whole-page 出口の DOM 字幕とシェルの出力プレビュー（webview の `#caption-plate`）で実装済み**。いずれも frame-engine の同じ評価器 `captionAnimatorStateAt` を使う。Web UI（preview-server の旧経路）とインスペクター UI は本便の対象外
+- 対象は **captions.json 由来の字幕**。袋 item（`source.kind: "captions"`）の宣言は全 cue、cue item（`source.kind: "caption"`）の宣言はその cue に適用する。§4.1 の telop / group 内テキストのうち caption unit と同じ経路を通らないものは本便の対象外
+- `basis` は `chars`（書記素）/ `words` / `lines` を実装。**`segments` は v1 では words と同じ扱い**とし、edit-lint は `animator.segments-fallback` warning を出す。文節単位は別便
+- **DOM 出口の適用器**は `packages/frame-engine/src/timeline/caption-animator-dom.ts` の `applyCaptionAnimatorDom(root, declaration)`。`declaration` は `animators` / `keyframes` / `cueLocalSeconds` / `cueDurationSec` / `fps` / `outputWidth` を受け取り、任意の `keyframeOffsetSeconds` で袋 item の開始を基準とするキーフレーム時刻を保つ
+- 適用器は root（cue の要素）内の単位要素を列挙する。`chars` は `.akari-caption__char`、`words` は `.akari-caption__tok`（無ければ単語 span）、`lines` は `.akari-caption__line`（行要素の無い `.akari-caption__reveal-group` も行として扱う）。`segments` は words にフォールバックして一度だけ runtime warning を出し、対象の単位要素が無ければ warning を出してその basis を無視する
+- `captionAnimatorStateAt` の評価結果を単位要素の **inline style** に書く。`transform` は `translate(x px, y px) scale(s) rotate(r deg)`、`opacity` は §4.2 のクランプ後の値を既存 opacity に乗算し、`letterSpacing` / `blur` は `letter-spacing` / `filter: blur()` に反映する。span は inline style の `display: inline-block` で transform を有効にする。副作用は inline style に限り、class / DOM 構造は変えない。**animator が無ければ DOM を一切変えない（バイト不変）**
+- OSR は page-builder が cue ごとの animator / keyframes を埋め込み、page-runtime が各フレームの capture 前に適用する。シェルは summary に宣言を供給し、`chars` 宣言時だけ書記素 span を生成して、マスタークロックの tick / seek で同じ適用器を呼ぶ（frame-engine 経路 / DOM `<video>` 経路共通）
+- `letterSpacing` は tile 幾何を変えるため **gpu 出口では無視**する。非ゼロの宣言に runtime warning `animator.letterSpacing-ignored` を出す
+- `blur` も **gpu 出口では無視**する。現行の GPU sprite tile 描画は `filter: blur()` に対応していないため、非ゼロの宣言に runtime warning `animator.blur-ignored` を出す。評価器での量の計算は §4.1〜4.2 の規則どおり
+- **DOM 出口（OSR whole-page / シェルプレビュー）では `letterSpacing` / `blur` とも inline style でそのまま効く**。この 2 量を無視する gpu とは見た目が異なりうる。gpu との一致は「文字が現れる順序と概ねの位置」とし、tile と DOM の描画の細部（アンチエイリアス等）までの一致は求めない
+- 決定論: **同じ出口・同じ入力は同じ画素**（固定 seed・整数演算）。DOM 適用も同じフレームなら同じ DOM となる。animator 無しの出力は**バイト不変**を保つ
+
+edit-lint の規則（gpu runtime の量の無視 warning とは別）:
+
+| 規則名 | severity | 判定 |
+|---|---|---|
+| `animator.non-text-target` | warning | media / filter item に animator を宣言した（描画では無視）|
+| `animator.unknown-ref` | error | キーフレーム点の `animator[id]` がその item の宣言に無い |
+| `animator.duplicate-id` | error | 同じ item の animator id が重複した |
+| `animator.segments-fallback` | warning | `basis: "segments"` を words として扱う |
 
 ## 5. 「キーフレームに展開」（L0 / L2 → L1・一方通行）
 

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

@@ -1,117 +1,129 @@
----
-lifecycle: accepted
-date: 2026-09-05
----
-
-# edit.json v2 clip adjust v1 契約
-
-## 0. 位置づけ
-
-v0 の基本補正と LUT に curves / wheels / hue と画素処理の fx を追加する。
-
-## 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`。
-- `fx`: 配列（maxItems 8）。各要素は `id` 必須・additionalProperties false。同じ id は 1 回まで。
-  配列順が適用順。空配列は書き込み側で除去し、読み取り側は未指定と同じに扱う。
-- `sections`: `basic` / `lut` に加えて `curves` / `wheels` / `hue` / `fx`（boolean・false のときだけバイパス）。
-- **演算順（固定）**: ① basic（v0 §3 の 1〜6）→ ② lut（trilinear・intensity 混合）→ ③ wheels → ④ curves → ⑤ hue → ⑥ fx。
-  - ③ 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・fx 無しなら
-  `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 は追加キー不可。
-
-`fx` のパラメータはすべて任意。括弧内は既定値。
-
-| id | パラメータ・範囲（既定値） | 意味 |
-|---|---|---|
-| `vignette` | `amount` −1..1（0.5）、`midpoint` 0..1（0.5）、`roundness` −1..1（0）、`feather` 0..1（0.5） | crop 適用後のローカル 0..1 箱で周辺減光。負の amount は明るくする。roundness は矩形寄り（−1）から縦横比を補正した円（1）へ補間。midpoint は開始位置、feather は遷移幅（0 は段差） |
-| `blur` | `px` 0..50（8） | 半径は出力 px、`px × outputSize.x / 1920`。5×5 固定 25 タップの箱ぼかしで 1 パス近似。出力座標から source texel へ換算し、crop 内に clamp |
-| `grain` | `amount` 0..1（0.3）、`size` 0.5..4（1） | 出力 px 単位の粒。出力フレーム番号と `floor(outputPixel / size)` を整数 hash に渡す決定論ノイズ。RGB 共通に ±amount×0.15 を加算して輝度を変える。sin による hash は使わない |
-| `sharpen` | `amount` 0..1（0.5） | source texel の 3×3 平均との差を `rgb + amount × (rgb − average)` で加算し clamp |
-
-旧 `cuts[].fx` は読み取り互換の語彙であり、`adjust.fx` と無関係。エンジンは従来どおり無視する。
-
-## 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 → ⑥ fx（配列順・mask / opacity / blend の前）→ item 合成 → output.look。①〜⑤の LUT を適用する `applyAdjust` の直後に fx を評価する。空間処理は LUT に bake せず、cut A/B と layer の shader 内で行う。後続効果の近傍サンプルにも先行効果を適用する。追加 FBO は使わず、fx 無し・空配列・sections.fx=false は RGB を変更せず返す。
-
-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. 非スコープ
-
-スプリット比較、エフェクト UI、CSS 近似、render-cut（ffmpeg 経路）、第 2 群の効果（グロー / 明瞭度 / かすみ除去 / ノイズ除去 / モーションブラー）、旧 cuts[].fx の実装、LUT ライブラリ。
+---
+lifecycle: accepted
+date: 2026-09-05
+---
+
+# edit.json v2 clip adjust v1 契約
+
+## 0. 位置づけ
+
+v0 の基本補正と LUT に curves / wheels / hue と画素処理の fx を追加する。
+
+## 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`。
+- `fx`: 配列（maxItems 8）。各要素は `id` 必須・additionalProperties false。同じ id は 1 回まで。
+  配列順が適用順。空配列は書き込み側で除去し、読み取り側は未指定と同じに扱う。
+- `sections`: `basic` / `lut` に加えて `curves` / `wheels` / `hue` / `fx`（boolean・false のときだけバイパス）。
+- **演算順（固定）**: ① basic（v0 §3 の 1〜6）→ ② lut（trilinear・intensity 混合）→ ③ wheels → ④ curves → ⑤ hue → ⑥ fx。
+  - ③ 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・fx 無しなら
+  `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 は追加キー不可。
+
+`fx` のパラメータはすべて任意。括弧内は既定値。
+
+| id | パラメータ・範囲（既定値） | 意味 |
+|---|---|---|
+| `vignette` | `amount` −1..1（0.5）、`midpoint` 0..1（0.5）、`roundness` −1..1（0）、`feather` 0..1（0.5） | crop 適用後のローカル 0..1 箱で周辺減光。負の amount は明るくする。roundness は矩形寄り（−1）から縦横比を補正した円（1）へ補間。midpoint は開始位置、feather は遷移幅（0 は段差） |
+| `blur` | `px` 0..50（8） | 半径は出力 px、`px × outputSize.x / 1920` を作業テクセルへ換算。分離ガウス H → V の 2 パス（σ = 換算半径 / 2、各パス最大 33 タップ）。大半径は viewport を 1/2^k に縮小し、次パスで双一次拡大。サンプルは crop 内に clamp |
+| `grain` | `amount` 0..1（0.3）、`size` 0.5..4（1） | 作業空間の画素と出力フレーム番号を使う決定論ノイズ。`floor(workPixel / size)` とフレーム番号を整数 hash に渡す。RGB 共通に ±amount×0.15 を加算して輝度を変える。sin による hash は使わない |
+| `sharpen` | `amount` 0..1（0.5） | 作業テクセルの 3×3 平均との差を `rgb + amount × (rgb − average)` で加算し clamp |
+| `glow` | `intensity` 0..1（0.5）、`radius` 0..100 px（20）、`threshold` 0..1（0.7）、`warmth` −1..1（0） | 高輝度部のにじみ。Rec.709 luma が threshold 以上の bright-pass → ガウス H → V → 加算合成の 4 パス。warmth は加算色を暖色 / 寒色へ寄せる |
+| `clarity` | `amount` −1..1（0.3）、`radius` 1..50 px（10） | ガウス H → V → 合成の 3 パス。`rgb + amount × (rgb − gauss(rgb, radius))`。負で柔らかくする |
+| `dehaze` | `amount` −1..1（0.3） | 3×3 dark channel の min で透過率を推定し復元する 1 パス。大気光は白、透過率の下限は 0.1。負は霞を足す |
+| `denoise` | `amount` 0..1（0.3） | 5×5 bilateral の 1 パス。値域 σ = amount × 0.25、空間 σ = 2 作業テクセル |
+| `motion_blur` | `px` 0..100（10）、`angle` −180..180 度（0） | 角度に沿う 17 タップ、全長 px の方向ぼかし（1 パス）。0 度は水平、正角は crop ローカルの下方向へ回転 |
+
+第 2 群の radius / px も blur と同じ出力 px 規約（output.width / 1920）で換算する。
+ゼロ強度は identity（glow は intensity、motion_blur は px、他は amount）。radius や threshold は強度判定に使わない。
+
+旧 `cuts[].fx` は読み取り互換の語彙であり、`adjust.fx` と無関係。エンジンは従来どおり無視する。
+
+## 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 → ⑥ fx（配列順・mask / opacity / blend の前）→ item 合成 → output.look。fx が有効な cut A/B の各側と layer は、crop 窓を作業解像度へ描く prep パスで①〜⑤の `applyAdjust` を適用し、共有する 2 本の ping-pong FBO で効果パスを配列順に実行する。作業寸法は crop のテクセル寸法を出力寸法で上限 clamp し、FBO は最大出力寸法で確保・再利用する。
+
+パス数は vignette / grain / sharpen 各 1、blur 2、glow 4、clarity 3、dehaze / denoise / motion_blur 各 1。glow / clarity の合成元には、その効果へ入る直前の画像を再利用テクスチャへ退避する（FBO は増やさない）。後続効果は先行効果の結果を近傍サンプルする。最終結果を元ソースの代わりに合成側で読み、adjust を二重適用しない。mask / opacity / blend はパス列の後で従来どおり適用する。
+
+空間処理は LUT に bake しない。fx 無し・空配列・全効果ゼロ強度・sections.fx=false は prep を実行せず従来の直接経路を使い、fx 無しの出力はバイト不変。
+
+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 近似できないため適用せず、色調整は近似表示の指標を出し、fx のうち blur だけは CSS `filter: blur()` で近似し、それ以外の fx は適用せず近似表示の指標で開示する。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. 非スコープ
+
+スプリット比較、エフェクト UI、CSS 近似（blur を除く）、render-cut（ffmpeg 経路）、旧 cuts[].fx の実装、LUT ライブラリ。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "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/creator-root/src/index.mjs

@@ -218,10 +218,34 @@ const AKARI_MD_STUB = [
     '',
     'この作業場（CreatorRoot）の規約・好みを書く場所です。',
     'AKARI Video のエージェントは動画を作る前に、まずこのファイルを読みます。',
+    '効く順番: 一言の指示 > その動画の進め方（intake） > この akari.md > 製品の既定。',
     '',
-    '## 好み',
+    '## やり方の既定',
     '',
-    '（まだ何も書かれていません）',
+    '- 何も言わなければ「提案つき」（頼まれたことに加えて良さそうな物をプレビューに入れて見せます。要らなければ消してください。判子は書き出しの 1 回）',
+    '- 「そのまま」と言ったら、言った通りに入れて見ずに書き出します。止まるのは「確認して」と言ったときだけ',
+    '- 絵コンテは、映像が無い・位置関係や動きを先に決めたい・全体像を先に見たい、のどれかのときだけ作ります',
+    '',
+    '## 調達の好み（何も言わなければこう解釈する）',
+    '',
+    '| 仕事 | 既定 | 補足 |',
+    '|---|---|---|',
+    '| B ロール | （未記入） | |',
+    '| 図解・テロップ | （未記入） | |',
+    '| ナレーション | （未記入） | |',
+    '| BGM・効果音 | （未記入） | |',
+    '| 文字起こし | （未記入） | |',
+    '| 人物の実写 | （未記入） | |',
+    '',
+    '- 表に無い仕事に初めて当たったら、エージェントは 1 問だけ聞いて、答えをこの表に 1 行足すことを申し出ます。二度目は聞きません',
+    '',
+    '## 見た目の既定',
+    '',
+    '（画角・字幕の位置と書体・テロップの口調・書き出しサイズなど。未記入なら製品の既定）',
+    '',
+    '## 聞かれて答えたこと（エージェントが追記する）',
+    '',
+    '（まだありません）',
     ''
 ].join('\n');
 

package/vendor/packages/creator-root/test/create-creator-root.test.mjs

@@ -37,6 +37,12 @@ test('createCreatorRoot: 契約 §3 の正準構造を生成する', async () =>
 
         const akariMd = await readFile(join(target, 'akari.md'), 'utf8');
         assert.match(akariMd, /好み/);
+        assert.match(akariMd, /^## やり方の既定$/m);
+        assert.match(akariMd, /^## 調達の好み（何も言わなければこう解釈する）$/m);
+        assert.match(akariMd, /^## 見た目の既定$/m);
+        assert.match(akariMd, /^## 聞かれて答えたこと（エージェントが追記する）$/m);
+        assert.ok(akariMd.includes('効く順番: 一言の指示 > その動画の進め方（intake） > この akari.md > 製品の既定。'));
+        assert.ok(akariMd.includes('- 表に無い仕事に初めて当たったら、エージェントは 1 問だけ聞いて、答えをこの表に 1 行足すことを申し出ます。二度目は聞きません'));
         assert.match(await readFile(join(target, 'CLAUDE.md'), 'utf8'), /akari\.md/);
         assert.match(await readFile(join(target, 'AGENTS.md'), 'utf8'), /akari\.md/);