akari-video 0.1.8 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "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/capability-sources.mjs

@@ -2,7 +2,10 @@ import { execFileSync } from "node:child_process";
 import { existsSync, lstatSync, readFileSync, realpathSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 
-export function discoverCheckoutCapabilitySources(repoRoot, { trackedFiles = null } = {}) {
+export function discoverCheckoutCapabilitySources(repoRoot, {
+  trackedFiles = null,
+  includeBinTargets = true,
+} = {}) {
   const root = realpathSync(resolve(repoRoot));
   const tracked = trackedFiles ?? execFileSync("git", ["-C", root, "ls-files", "-z"], {
     maxBuffer: 64 * 1024 * 1024,
@@ -25,7 +28,7 @@ export function discoverCheckoutCapabilitySources(repoRoot, { trackedFiles = nul
         throw new Error(`${manifestPath} package.json#bin target is not tracked: ${canonical}`);
       }
       assertRegularContainedFile(root, canonical, `${manifestPath} package.json#bin`);
-      selected.add(canonical);
+      if (includeBinTargets) selected.add(canonical);
     }
   }
   const paths = [...selected].sort(compare);

package/src/status-command.mjs

@@ -30,10 +30,17 @@ export async function runStatusCommand(argv, options = {}) {
   const status = parsed.full
     ? await resolveFullProjectStatus(parsed.projectRoot)
     : resolveProjectStatus(parsed.projectRoot, { mode: "fast" });
-  log(parsed.json ? serializeStatus(status) : `${formatStatusSummary(status)}\n`);
+  log(parsed.json ? serializeStatus(status) : `${formatStatusOutput(status)}\n`);
   return { exitCode: status.state_health === "inconclusive" ? 1 : 0, status };
 }
 
+export function formatStatusOutput(status) {
+  const summary = formatStatusSummary(status);
+  if (status.state_health !== "inconclusive" || status.problems.length === 0) return summary;
+  const problems = status.problems.map((problem) => `  - ${problem}`).join("\n");
+  return `${summary}\nCould not determine:\n${problems}\nNext: run \`akari status --json\` for the full machine-readable report, or resolve the items above and re-run \`akari status\`.`;
+}
+
 export function parseStatusArguments(argv, cwd = process.cwd()) {
   let projectRoot = cwd;
   let pathSeen = false;

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

@@ -33,34 +33,30 @@
     "docs/contract-2026-08-05-fx-v0.md",
     "docs/contract-2026-08-11-analysis-vision-tracks-v0.md",
     "docs/contract-2026-08-11-review-session-ui-events.md",
-    "packages/akari-launcher/bin/akari.mjs",
+    "docs/contract-2026-08-12-chat-approval-v0.md",
+    "docs/contract-2026-08-12-color-range-normalization-v0.md",
+    "docs/contract-2026-08-12-region-filter-layer-v0.md",
+    "docs/contract-2026-08-12-still-image-cut-source-v0.md",
+    "docs/contract-2026-08-13-avatar-drive-v0.md",
+    "docs/contract-2026-08-14-avatar-vrm-v0.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",
     "packages/analysis-report/package.json",
     "packages/analysis-report/README.md",
-    "packages/analysis-report/render-analysis-report.mjs",
-    "packages/asset-resolver/bin/akari-assets.mjs",
     "packages/asset-resolver/package.json",
     "packages/asset-resolver/README.md",
-    "packages/audio-library-setup/bin/gallery-helper.mjs",
-    "packages/audio-library-setup/bin/generate-candidates-html.mjs",
-    "packages/audio-library-setup/bin/register-drop-folder.mjs",
     "packages/audio-library-setup/package.json",
     "packages/audio-library-setup/README.md",
-    "packages/bake-layer/bin/bake-layer.mjs",
     "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",
     "packages/decision-cards/README.md",
-    "packages/decision-cards/report-helper.mjs",
-    "packages/edit-lint/bin/edit-lint.mjs",
     "packages/edit-lint/package.json",
     "packages/edit-store/package.json",
-    "packages/export-nle/bin/export-nle.mjs",
     "packages/export-nle/package.json",
-    "packages/intake-form/intake-form-helper.mjs",
     "packages/intake-form/package.json",
     "packages/intake-form/README.md",
     "packages/media-bin/package.json",
@@ -70,22 +66,15 @@
     "packages/preview-engine/package.json",
     "packages/preview-engine/README.md",
     "packages/preview-server/package.json",
-    "packages/preview-server/src/server.mjs",
     "packages/project-scaffold/package.json",
-    "packages/render-cut/bin/akari-apply-textstyle.mjs",
-    "packages/render-cut/bin/render-cut.mjs",
     "packages/render-cut/package.json",
-    "packages/schemas/bin/validate-asset.mjs",
-    "packages/schemas/bin/validate-intake.mjs",
-    "packages/schemas/bin/validate-plan.mjs",
-    "packages/schemas/bin/validate-review.mjs",
     "packages/schemas/package.json",
-    "packages/template-render/bin/akari-template-render.mjs",
     "packages/template-render/package.json",
     "packages/template-render/README.ja.md",
     "packages/template-render/README.md",
     "skills/address-review/SKILL.md",
     "skills/analyze-footage/analysis-json.md",
+    "skills/analyze-footage/bin/face-expression/vendor/tasks-vision-0.10.17/README-AKARI.md",
     "skills/analyze-footage/events-and-hooks.md",
     "skills/analyze-footage/keyframes-and-review.md",
     "skills/analyze-footage/media-and-transcript.md",
@@ -158,6 +147,9 @@
     "skills/setup-audio-library/gallery.md",
     "skills/setup-audio-library/SKILL.md",
     "skills/setup-audio-library/store-unlock.md",
+    "skills/setup-chat-approval/setup-token.md",
+    "skills/setup-chat-approval/SKILL.md",
+    "skills/setup-chat-approval/smoke-test.md",
     "skills/setup-library/fetch-and-validate.md",
     "skills/setup-library/SKILL.md",
     "skills/setup-library/starter-pack.md",

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

@@ -539,6 +539,7 @@ ffmpeg の `perspective` フィルタの制約（式に時刻変数を持たな
 | `layers[].perspective`（2026-08-06 実装） | ✅（§2.4.4。実ブラウザ実測済み） | ✅（§2.4.4。tsc -b + ユニット + Web 同一計算式で担保） |
 | `cuts[].fx`（2026-08-07 実装・近似あり） | 🟡（§2.4.5。5 種対応、3 種は近似バッジ付き） | ❌（未実装） |
 | `layers[].keyframes`（2026-08-09 実装） | ✅（§2.4.7。transform/crop は連続補間。perspective は blend:"normal" のみ・書き出しの段階保持とサンプル点で一致） | ✅（§2.4.7。同左） |
+| `cuts[].static-image-source`（2026-08-12 実装。正本: `contract-2026-08-12-still-image-cut-source-v0.md`） | 🟡（`<img>`/`<video>` 出し分け + preview-engine ClipSession/Timeline の image 対応を実装。framing/freeze/transform は流用。実ブラウザでの対話的スクラブ・複数区間切替の実機検証は未実施） | ❌（スコープ外・未対応） |
 
 - `cuts[].framing`（静的クロップ / ズームキーフレーム）・`cuts[].freeze`（フリーズ）は
   `contract-2026-07-22-render-basics.md` #6/#7 としてレンダ（render-cut）に加え、

package/vendor/docs/contract-2026-08-02-setup-remote-v0.md

@@ -118,7 +118,19 @@ OK / 差し戻しを言う」だけ — その閲覧と素材の受け渡しを
 
 | 未達 | 状況 |
 |---|---|
-| HTTPS | **`tailscale serve` の TLS が未成立**。tailnet 側で HTTPS は有効（`CertDomains` に当該ドメインあり）だが Let's Encrypt の ACME 注文が `invalid` で失敗。上記の実測は tailnet 内の平文 HTTP で代替した（WireGuard 内側のため機密性は保たれるが、secure context を要する機能は使えない）。**平文 HTTP を既定にはしない** |
+| HTTPS | **`tailscale serve` の TLS が未成立**。上記の実測は tailnet 内の平文 HTTP で代替した（WireGuard 内側のため機密性は保たれるが、secure context を要する機能は使えない）。**平文 HTTP を既定にはしない** |
+
+**HTTPS 失敗の切り分け結果（2026-08-12）** — スキル側・serve 設定側の不備ではないと確定:
+
+- tailnet で HTTPS は有効（`tailscale status --json` の `CertDomains` に当該ドメインあり）
+- serve の設定自体は正常（同じ経路が平文 HTTP では 200 / 0.28 秒で応答する）
+- CAA は発行を許可している（`ts.net` に `issue "letsencrypt.org"`）
+- Let's Encrypt の注文が毎回 `status: invalid`（注文 ID は毎回新規 = レート制限ではなく検証失敗）
+- **`_acme-challenge.<host>.<tailnet>.ts.net` に使い捨て TXT が 5 件累積**していた。
+  DNS-01 の検証失敗と符合する（現行トークンが正しく公開されていない疑い）
+- → **tailnet 側（Tailscale の DNS / 制御プレーン）の問題**。再試行を重ねても TXT が増えるだけで
+  好転しないため、打ち切って次の一手に回す。候補: (a) マシン名を変更して
+  `_acme-challenge` の名前ごと作り直す（serve URL が変わる）(b) Tailscale サポートに問い合わせる
 
 ## 8. 改訂履歴
 

package/vendor/docs/contract-2026-08-11-analysis-vision-tracks-v0.md

@@ -1,10 +1,10 @@
 ---
 lifecycle: draft
 created: 2026-08-11
-updated: 2026-08-11
+updated: 2026-08-14
 ---
 
-# 分析トラック契約 v0 — Vision ランドマーク・トラック（face-landmarks / hand-pose）と keyframes 消費
+# 分析トラック契約 v0 — Vision ランドマーク・トラック（face-landmarks / hand-pose / body-pose-3d / face-expression）と keyframes 消費
 
 - 日付: 2026-08-11
 - 状態: **ドラフト**（v0 実装と同時に確定させる。実装で判明した齟齬は追記で解消）
@@ -13,8 +13,9 @@ updated: 2026-08-11
   - `contract-2026-07-23-analysis-person-matte.md`（Swift サイドカーの流儀・analysis.json の tracks 契約・検証責務の分担）
   - `contract-2026-07-25-project-structure-v0.md`（分析サイドカーの置き場 = `.akari/sidecars/`）
   - `contract-2026-08-02-preview-parity.md`（render/Web/shell 3 面パリティの原則）
-- スコープ: 動画から抽出する**ランドマーク・トラック**（顔・手）のデータ契約、生成サイドカーの
-  入出力、消費（`layers[].keyframes` への変換）の責務分担。**新しいレンダー機構は作らない**
+- スコープ: 動画から抽出する**ランドマーク・トラック**（顔・手・3D ボディポーズ）のデータ契約、生成サイドカーの
+  入出力、消費（`layers[].keyframes` への変換）の責務分担、および MediaPipe 由来の頭部姿勢・
+  表情トラック。**新しいレンダー機構は作らない**
 
 ## 0. 設計原則
 
@@ -34,7 +35,7 @@ updated: 2026-08-11
 
 ## 1. analysis.json への追加（additive）
 
-`tracks` に **optional キー** 2 つを追加する。`tracks.required`（speakers / faces /
+`tracks` に **optional キー** 3 つを追加する。`tracks.required`（speakers / faces /
 person_matte）には**入れない**（person_matte が必須なのは既存消費者の事情であり、新トラックは
 真に任意として追加する）。
 
@@ -48,18 +49,40 @@ person_matte）には**入れない**（person_matte が必須なのは既存消
     "tool": "vision-tracks.mjs v0",
     "generated_at": "2026-08-11T12:00:00Z"
   },
-  "hand_pose": { /* 同形 */ }
+  "hand_pose": { /* 同形 */ },
+  "body_pose_3d": {             // 任意。macOS 14+ の Vision 3D ボディポーズ
+    "path": "vision/body-pose-3d.json",
+    "sample_fps": 24,
+    "provider": "apple-vision",
+    "tool": "vision-tracks.mjs v0",
+    "generated_at": "2026-08-13T12:00:00Z"
+  }
+}
+```
+
+2026-08-14 additive: 同じ optional pointer 形で `face_expression` を追加する。既存 3 キーと同様に
+`tracks.required` には入れず、未生成はキー無しで表す。
+
+```jsonc
+"face_expression": {
+  "path": "vision/face-expression.json",
+  "sample_fps": 24,
+  "provider": "mediapipe-face-landmarker",
+  "tool": "face-expression.mjs v0",
+  "generated_at": "2026-08-14T12:00:00Z",
+  "features": ["head-pose-ypr-radians", "mediapipe-blendshapes-52"]
 }
 ```
 
 ## 2. トラックファイル形式（vision-tracks v0）
 
-`path` が指す JSON ファイル。1 ファイル 1 種類（face-landmarks と hand-pose は別ファイル）。
+`path` が指す JSON ファイル。1 ファイル 1 種類（face-landmarks / hand-pose /
+body-pose-3d / face-expression は別ファイル）。
 
 ```jsonc
 {
   "version": 0,
-  "kind": "face-landmarks",      // "face-landmarks" | "hand-pose"
+  "kind": "face-landmarks",      // "face-landmarks" | "hand-pose" | "body-pose-3d"
   "source": { "path": "../..(元動画への相対)", "duration": 12.5 },
   "sample_fps": 24,
   "provider": { "name": "apple-vision", "os": "macOS 15.5" },
@@ -70,8 +93,11 @@ person_matte）には**入れない**（person_matte が必須なのは既存消
 }
 ```
 
-- **座標系（最重要規約）**: すべて **0〜1 正規化・左上原点**（動画ピクセル系と同じ向き）。
+- **画像座標系（最重要規約）**: face-landmarks / hand-pose と body-pose-3d の
+  `projection` はすべて **0〜1 正規化・左上原点**（動画ピクセル系と同じ向き）。
   Vision framework は左下原点で返すため、**y 反転はサイドカーの責務**。消費側は変換しない
+- body-pose-3d の `position` だけは画像座標ではない。Vision が返すモデル座標
+  （root/hip 相対メートル）を変換せず保存する（§2.4）
 - `samples[].t` は元動画の秒（`in`/`out` と同じ時間軸）。サンプリングは `sample_fps` の等間隔
 - 生値主義: 平滑化・補間済みの値を入れない。信頼度（`conf`）を必ず併記する
 
@@ -126,6 +152,86 @@ person_matte）には**入れない**（person_matte が必須なのは既存消
   （§2.1 の必須 6 キーが揃わない detection を出力に混ぜない）。実測（1 名がほぼ映り続ける
   26.3 秒素材）ではこの除外は 0 件だった。
 
+### 2.4 body-pose-3d の detection（additive・2026-08-13）
+
+`VNDetectHumanBodyPose3DRequest` revision 1 が返す 17 関節を保存する。API は macOS 14+
+限定である。トラックは分析の生値であり、平滑化・間引き・低信頼度除外を行わない。
+
+```jsonc
+{
+  "conf": 0.86,
+  "joints": {
+    "root": {
+      "position": [0.0, 0.0, 0.0],       // root/hip 相対メートル
+      "projection": [0.51, 0.63],        // 0〜1 正規化・左上原点
+      "conf": 0.86
+    },
+    "right_hip": { /* 同形 */ },
+    "right_knee": { /* 同形 */ },
+    "right_ankle": { /* 同形 */ },
+    "left_hip": { /* 同形 */ },
+    "left_knee": { /* 同形 */ },
+    "left_ankle": { /* 同形 */ },
+    "spine": { /* 同形 */ },
+    "center_shoulder": { /* 同形 */ },
+    "center_head": { /* 同形 */ },
+    "top_head": { /* 同形 */ },
+    "left_shoulder": { /* 同形 */ },
+    "left_elbow": { /* 同形 */ },
+    "left_wrist": { /* 同形 */ },
+    "right_shoulder": { /* 同形 */ },
+    "right_elbow": { /* 同形 */ },
+    "right_wrist": { /* 同形 */ }
+  }
+}
+```
+
+- `position`: `VNHumanBodyRecognizedPoint3D.position` の平行移動成分 `[x,y,z]`。
+  Vision のモデル座標で root/hip 相対、単位はメートル。カメラ相対座標へ変換しない
+- `projection`: `VNHumanBodyPose3DObservation.pointInImage` が返す画像投影を y 反転し、
+  `[0,1]` へクランプした `[x,y]`
+- `conf`: Vision 3D API は関節別 confidence を公開しないため、apple-vision provider の v0 は
+  `VNHumanBodyPose3DObservation.confidence` を各関節へ複製する。これは関節別推定値ではなく、
+  観測全体 confidence の由来明示である。消費者の `min-confidence` はこの値を使う
+- 17 関節のいずれかを Vision から取得できない観測は detection ごと省略する。存在しない
+  関節を補間・捏造せず、`detections: []` のフレームは時刻 `t` とともに残す
+- pose-skeleton の v0 は各フレーム先頭の 1 人（`bodyIndex=0` 固定）のみを消費し、複数人には非対応
+
+### 2.5 face-expression の detection（additive・2026-08-14）
+
+MediaPipe Face Landmarker が返す `facialTransformationMatrixes` と 52 blendshape category を、
+平滑化・補間せず保存する。1 ファイル 1 kind の `kind` は `face-expression`、analysis pointer は
+`tracks.face_expression`、既定ファイル名は `vision/face-expression.json` とする。顔が検出されない
+frame も `{ "t": ..., "detections": [] }` として残す。
+
+```jsonc
+{
+  "head": {
+    "yaw": 0.12,
+    "pitch": -0.04,
+    "roll": 0.02
+  },
+  "blendshapes": {
+    "_neutral": 0.07,
+    "eyeBlinkLeft": 0.01,
+    "mouthSmileLeft": 0.64
+    // MediaPipe 固定 category 全 52 キー。各値は 0..1 の生 score
+  },
+  "conf": 0.64
+}
+```
+
+- `head` は 4x4 row-major 同次変換の上左 3x3 を行正規化し、
+  `R = Rz(roll) * Ry(yaw) * Rx(pitch)` で分解した**ラジアン**。右手系の解釈は +X=画像右、
+  +Y=画像下、+Z=canonical face 前方で、yaw 正=画面右向き、pitch 正=上向き、
+  roll 正=時計回り。gimbal lock は `roll=0` に固定する
+- `blendshapes` は `_neutral` を含む MediaPipe の固定 52 category。キーは表現の生 score で、
+  並びだけ byte 安定のため名前順へ正規化する。値の平滑化・クランプ・感情ラベル化はしない
+- MediaPipe Web API は内部の face-presence score を結果へ公開しない。`conf` は捏造した定数ではなく、
+  同じ detection に返った 52 生 score の最大値を signal confidence として決定論的に記録する。
+  face detection confidence そのものではないため、消費者は検出有無と blendshape 個別値を主に使う
+- v0 は `numFaces=1`。複数人追跡・人物同一性の連結はしない
+
 ## 3. サイドカー（生成側）
 
 person-matte と同じ分離: **Swift ヘルパーはフレーム変換だけ、コンテナ・時刻・組み立ては
@@ -135,25 +241,73 @@ person-matte と同じ分離: **Swift ヘルパーはフレーム変換だけ、
   - `vision-tracks-helper.swift` — stdin から raw BGRA フレーム列、stdout へ **JSON Lines
     （1 フレーム 1 行の検出結果）**。`swiftc -O` オンデマンドビルド・バイナリは `.gitignore`
   - `vision-tracks.mjs` — `ffmpeg`（デコード・fps/幅統一）→ helper → トラックファイル組み立て →
-    `analysis.json` の tracks へ追記（原子的置換）。`--kinds face,hand` / `--fps` / `--check`
-    （macOS / swiftc / ffmpeg の可用性確認）
+    `analysis.json` の tracks へ追記（原子的置換）。`--kinds face,hand,body-pose-3d` /
+    `--fps` / `--check`（macOS 14+ / swiftc / ffmpeg の可用性確認。macOS 14 未満は
+    capability 不足として理由付きで拒否）
 - 手順書: `skills/analyze-footage/vision-tracks.md`（person-matte.md と同格の任意工程）。
   `SKILL.md` の実行順・ハードルールに配線する
 - 起動主体はエージェント（スキル手順に従い bash で直接叩く）。CLI サブコマンドにはしない
   （判断を伴う工程はスキル、の境界裁定に従う）
 
+### 3.1 face-expression の headless Chromium 生成器（additive・2026-08-14）
+
+`skills/analyze-footage/bin/face-expression/face-expression.mjs` は face-expression 専用の独立生成器。
+既存 Swift helper は変更せず、ffmpeg で 24 fps（`--fps` 変更可）・幅 1280 以下の PNG 列へ
+デコードし、Chrome for Testing + `puppeteer-core` のページ内で CPU/WASM 版 Face Landmarker を
+順に実行する。Chrome の探索順・起動引数・ページ処理後の結果吸い上げは avatar-vrm の既存
+headless 経路を踏襲する。
+
+JS 版を選んだ理由は、`@mediapipe/tasks-vision` がブラウザ/WASM 専用である一方、製品には既に
+headless Chromium 経路があり、Python wheel や Swift helper という新しい実行系を増やさずに済むため。
+固定 Chrome・固定 WASM・CPU delegate・固定時刻入力により、同一環境では同じ行列分解と score 列を
+得られる。Python 版は arm64 wheel という別インストール面とバージョン解決を増やすため v0 では採らない。
+
+モデルはリポジトリへ置かず、初回だけ次を取得する。`AKARI_HOME` があればそれを優先し、既定は
+`~/.akari/models/mediapipe/face-landmarker/float16-1/face_landmarker.task`。既存ファイルも毎回
+SHA-256 検査し、不一致時は再取得で隠さず即エラーにする。新規取得は `.tmp-<pid>` へ書き、検証後に
+rename する。
+
+- URL: `https://storage.googleapis.com/mediapipe-models/face_landmarker/face_landmarker/float16/1/face_landmarker.task`
+- SHA-256: `64184e229b263107bc2b804c6625db1341ff2bb731874b0bcc2fe6544e0bc9ff`
+
+ブラウザ runtime はネットワーク変動を避けるため `@mediapipe/tasks-vision@0.10.17` の必要ファイルを
+無変換で vendor した。ライセンスは Apache-2.0。
+
+| artifact | SHA-256 |
+|---|---|
+| npm tarball | `d3dd0759295f1adcf5455f22aa652c58b8c1d537c0d14c8db7df78646011d523` |
+| `vision_bundle.mjs` | `1ada13431ea2a8ed7ea449e6c3595122d43fea2a8a4788056ed7da271469b402` |
+| `vision_wasm_internal.js` | `33a4125f825b343d2d9773951a73692f40bee368c9b591af8ff652fd501af90b` |
+| `vision_wasm_internal.wasm` | `c88cf472dd5cab0a3954b071e5f442102ded3701dcccc987a7a02ee8f54aae85` |
+| `vision_wasm_nosimd_internal.js` | `4e8d07dcf8cbb55b343cd76b7fc30d4303220f049d5529d6412f6f93296726a8` |
+| `vision_wasm_nosimd_internal.wasm` | `f840f69d7229f89dedaed39c7ac7a52f0964a7cec02d6cb1ac9eff891db86dc2` |
+| `LICENSE.txt` | `b070d77bfb2c52a1dd6996de0ce5f64c49a0ca55c889b163a963ddf5cb001ee2` |
+
+> 注: `LICENSE.txt` のみ npm tarball には含まれず（tarball 展開で実測確認済み）、Apache-2.0 の定型全文を手動で添えたもの（出所は `vendor/.../README-AKARI.md` 参照）。他の行は全て tarball 由来の実ファイル。
+
+tarball は `tar -xzf` 後、上記 bundle/WASM だけをコピーし、esbuild 等の再ビルドは行っていない。
+tarball 自体の npm integrity は
+`sha512-CZWV/q6TTe8ta61cZXjfnnHsfWIdFhms03M9T7Cnd5y2mdpylJM0rF1qRq+wsQVRMLz1OYPVEBU9ph2Bx8cxrg==`。
+
 ## 4. 消費（変換器）
 
-トラック → `edit.json` への反映は**決定論の変換器**が行う。v0 の消費者は 2 つ（別契約で
+トラック → `edit.json` への反映は**決定論の変換器**が行う。v0 の消費者は 3 つ（別契約で
 実装しても本契約の §2 形式だけを入力にする）:
 
 | 消費者 | 入力 | 出力 |
 |---|---|---|
 | eye-bar（目線黒帯） | face_landmarks（両瞳） | 黒帯レイヤー + `layers[].keyframes` の transform（x/y/rotate/scale） |
 | finger-frame（指フレーム） | hand_pose（両手の thumb_tip / index_tip = 4 点） | 対象レイヤーの `layers[].keyframes` の perspective（4 隅 corner-pin）+ 発動区間 |
+| pose-skeleton | body_pose_3d（17 関節の 2D `projection`） | アルファ付きスティックフィギュアを事前ベイクした `kind: "baked"` layer |
+
+`face_expression` のアバター駆動への結線は次の消費側契約に委ねる。本契約では生成 SSOT までとし、
+既存の「あいうえお」口パクや avatar-vrm / avatar-drive を変更しない。
 
 - 平滑化（移動平均・One Euro 等）・キーフレーム間引き・欠測補間は**変換器の責務**。
   パラメータは変換器の引数で決定論に
+- pose-skeleton は欠測と cut 境界で平滑化状態をリセットし、低 confidence 関節を含む骨を
+  非表示にする。欠測区間を hold せず、別 baked clip / layer へ分割する
+- pose-skeleton の v0 は `bodyIndex=0` 固定で各フレーム先頭の 1 人だけを対象とし、複数人には非対応
 - perspective keyframes の ffmpeg 側は既存の時間窓分割フォールバック
   （`expandLayerForPerspectiveKeyframes`）に乗る。新しいレンダー経路は作らない
 - `cuts[].fx` は**使わない**（全画面ポスト効果の器。空間追跡系はレイヤー機構が正）
@@ -163,10 +317,13 @@ person-matte と同じ分離: **Swift ヘルパーはフレーム変換だけ、
 - `packages/schemas/bin/` に新しいバリデータ CLI は**作らない**（person-matte 契約 §7 の分担を
   継続）。トラックファイルの JSON Schema は `skills/analyze-footage/references/
   vision-tracks.schema.json` に置き、スキル手順の jsonschema 検証が担う
-- `analysis.schema.json` への tracks 2 キー追加は additive のみ
+- `analysis.schema.json` への tracks 4 キー追加は additive のみ
 - **`packages/analysis-report/render-analysis-report.mjs` の軽量チェックを同時に更新する**
   （person_matte が残した「消費者の追随債務」を新トラックで繰り返さない）
 - verify は L0（該当 package / skill の `node --test`）。GUI を触らないため L1/L2 は対象外
+- face-expression は schema wiring、52 キー固定、同一行列の Euler 分解一致、モデル初回配置と
+  cached/downloaded 両方の SHA-256 不一致拒否を unit test する。実素材の検出率・CPU 時間・
+  実時間比は fieldtest 12 秒窓で別途記録し、値を捏造して本契約へ先書きしない
 
 ## 6. やらないこと（v0）
 

package/vendor/docs/contract-2026-08-11-review-session-ui-events.md

@@ -48,6 +48,7 @@
 | `timeline:cut:<n>` | タイムラインのカット（cuts[] index） | `timeline:cut:3` |
 | `timeline:overlay:<id>` | タイムラインのオーバーレイ | `timeline:overlay:o-0002` |
 | `asset:<path>` | 素材（プロジェクト相対 or カタログ id） | `asset:assets/broll/city.mp4` |
+| `asset:<category>/<id>` | 素材（カタログ由来カード。key = `<category>/<id>`） | `asset:still/br-typing-laptop` |
 
 - **登録機構**: 記録対象の要素は `data-akari-ui="<target-id>"` 属性で opt-in する。
   クリック解決は capture-phase のリスナー 1 本で行い、**最近傍の登録済み祖先**に丸める。
@@ -80,10 +81,21 @@
 - 回帰: 新イベント入りの events.jsonl を旧読み手（compile-review-session の手順）が
   処理してもエラーにならないこと
 
-## 6. 予約（次段の実装契約で確定）
-
-- review.json `annotations[].target` への **`ui:<element-id>`** 追加（選択ツール経由の
-  UI 要素注釈の着地形）。§2 と同一の id 空間を使う
-- 書き出し済み MP4 への注釈は新 target 種を作らず既存 `src` 機構で扱う方針（要検証:
-  プロジェクト外ファイルの src 正規化）
-- 音への注釈（`sourceRange` + トラック指定）の形
+## 6. 注釈の着地契約
+
+- review.json `annotations[].target` の **`ui:<element-id>`** は、選択ツール経由の UI 要素注釈に
+  使う。§2 と同一の id 空間を使い、たとえばオーバーレイは
+  `ui:timeline:overlay:<id>` に着地する
+- render-cut は検証に成功した書き出し成果物を、edit.json v1 の `sources[]` へ自動追記する。
+  `path` はプロジェクトルート相対、`proxy` は `null` とし、同じ `path` が既にあれば追記しない。
+  既存 id と衝突しない出力 stem 由来の id を使い、既存フィールドと整形は書き換えない。
+  edit.json を再読込・パースできない場合は警告だけを残し、書き出し成功を取り消さない。
+  v0 は schema 上 `sources` を持てないため自動追記せず、同様に警告する
+- `sources[].path` に一致する動画ファイルを raw preview で開き、そのタブがフォーカスされて
+  いる間の注釈は、`src = sources[].id` と raw preview の現在再生位置を source 秒とする
+  `sourceT` に着地する。コンポーザーは対象を `🎞 <source id>` チップで表示する。
+  一致しないファイルは従来どおり `src: null` の通常注釈とし、新しい target 種は作らない
+- 音の素材区間は新しい `audio:` target を作らず、`src = sources[].id` と半開区間
+  `sourceRange: [start, end)` を使う。BGM 等のオーバーレイ音は既存の `overlay:<id>` または
+  `ui:timeline:overlay:<id>` で扱う。音声ファイルは専用 audio preview で開かれるため、raw video
+  preview の現在位置接続とは別であり、区間選択 UI は本契約の対象外とする

package/vendor/docs/contract-2026-08-12-chat-approval-v0.md

@@ -0,0 +1,99 @@
+# chat-approval 契約 v0（チャット通知 + ボタン承認）
+
+- 日付: 2026-08-12
+- 状態: **v0 ドラフト・要オーナーレビュー**
+- 前提: `contract-2026-08-02-setup-remote-v0.md`（tailnet 限定の閲覧経路。レポート URL の供給元）、
+  `contract-2026-07-25-project-structure-v0.md`（承認レポートの実体）、
+  `packages/decision-cards/report-helper.mjs`（`decisions.json` の read / write / commit の唯一の実装）、
+  `skills/manage-connections`（接続レジストリと credentials の唯一の入口）
+- スコープ: 承認ゲート到達を**チャットへ通知**し、**ボタンのタップだけで**承認を返せるようにする
+- 非スコープ: チャットからの自由文指示、エージェントの起動・操作、素材のチャット搬送、
+  複数チャネル対応（v0 は Telegram 1 本）
+
+## 0. 位置づけ — 一言で言い切る
+
+**チャットは配管であって頭脳ではない。** 運ぶのは「できました」という通知・レポートへのリンク・
+画像・そして**列挙可能な承認の返事**だけ。編集の判断は従来どおり AKARI のパイプラインが持ち、
+承認の記録は `decisions.json` が持つ。チャット層は SSOT を一切持たない。
+
+## 1. 決定事項
+
+| 論点 | 決定 |
+|---|---|
+| 何を足すか | **通知と承認だけ**。エージェントをチャットから起動しない（別契約） |
+| 書き込み経路 | ブリッジは `decisions.json` を**自分で書かない**。report-helper の HTTP API（`POST /api/state` / `POST /api/commit`）を 127.0.0.1 経由で叩く。書き込みの原子性・検証・`0600`・二重確定の 409 は既存実装のまま効く |
+| 受信方式 | **long polling**（`getUpdates`）。公開エンドポイント・webhook・トンネルを作らない（受信口をインターネットに開けない） |
+| 入力語彙 | **閉じた語彙のみ**。`callback_data` が既定の集合に一致するものだけ処理し、自由文は処理しない |
+| チャネル | Telegram のみ（v0）。実装は `packages/chat-bridge/` に置き、後で LINE / Discord を足せる形にする |
+
+## 2. なぜ自由文を入れないか（この契約の中心）
+
+自由文をエージェントへ通すと、`planning`（非公開）の信頼境界契約が扱う prompt injection の
+窓口がそのまま開く。ボタンの `callback_data` は**発行側が定義した有限集合**であり、
+受信側は集合に無い値を捨てるだけでよい。v0 はこの性質を設計の土台にする。
+
+- 差し戻しは「確定しない + レポートを開くリンクを返す」で表現する。理由の自由記述はレポート側で行う
+- 自由文メッセージを受けたら、処理せず「レポートで操作してください」と定型文を返す
+
+## 3. 安全規律（ハードルール）
+
+1. **トークンを git 管理下・レポート・ログ・会話に出さない。** 置き場は
+   `~/.config/akari-video/credentials.env`（`600`）のみ。エージェントは値を読まず、KEY 名だけ案内する
+2. **チャット ID の許可リストを必須にする。** 登録済み chat ID 以外からの update は
+   一切処理せず破棄する（bot のユーザー名は誰でも到達できるため、これが無いと第三者が承認できる）
+3. **ブリッジはポートを listen しない。** 送信も受信も outbound の long polling のみ
+4. **`decisions.json` を直接書かない**（§1 の決定）。report-helper 経由のみ
+5. **update の重複処理をしない。** `update_id` で冪等化する（Telegram は再配信しうる）
+6. **送ってよいのはレポートの画像とテキストのみ。** 撮影素材の原本・secrets・パスの内部構造を送らない
+7. **疎通確認（実機への通知到達 + ボタンで `decisions.json` 更新）が取れるまで完了と言わない**
+
+## 4. 構成要素
+
+| 要素 | 置き場 | 役割 |
+|---|---|---|
+| ブリッジ本体 | `packages/chat-bridge/telegram.mjs` | 通知送信 + long polling + report-helper API 呼び出し |
+| セットアップスキル | `skills/setup-chat-approval/` | doctor → BotFather 案内（人間手番）→ chat ID 取得 → 疎通確認。`setup-remote` と同じ型 |
+| 接続登録 | `.akari/connections.json` | `manage-connections` の管轄（§5 の判断待ち） |
+
+### 送るメッセージの形
+
+```
+🎬 <プロジェクト名> — 承認をお願いします
+<要約 1〜2 行>
+[キーフレーム画像 数枚]
+
+[ レポートを開く (URL) ] [ おまかせで確定 ] [ あとで ]
+```
+
+- 「レポートを開く」は URL ボタン（tailnet 限定 URL。Telegram のサーバーからは到達できないため
+  リンクプレビューは出ない → `disable_web_page_preview` を付ける）
+- 「おまかせで確定」は全カード既定値のまま `POST /api/commit`（レポート側の `accept-all` と同義）
+- v1 の拡張余地: カードごとに選択肢ボタンを展開する（`data-option` は有限集合なので §2 と両立する）
+
+## 5. 判断待ち — `connections.json` の `kind` 拡張
+
+現行スキーマの `kind` は `genai / image / video / tts / music / sns / analytics` の閉じた enum で、
+**通知系の枠が無い**。`manage-connections` のハードルール 7（レジストリに無い接続を使わない）を
+守るには、いずれかを選ぶ必要がある:
+
+| 案 | 内容 | 評価 |
+|---|---|---|
+| **A. `notify` を enum に追加** | スキーマ + 検証 + 例 + `apps/shell` 側ミラーを更新 | **推奨**。通知は既存のどの kind とも性質が違う（発信ではなく往復）。将来の LINE / Discord も同じ枠に入る |
+| B. 既存の `sns` を流用 | 変更ゼロ | `sns` は「SNS へ投稿する」枠であり、承認の往復とは別物。意味が濁る |
+| C. レジストリに載せない | credentials.env だけで完結 | ハードルール 7 違反。採らない |
+
+## 6. 成果物と受け入れ基準
+
+- **L0**: スキル lint / スキーマ検証 / 既存テストが green
+- **L1**: 決定論の単体テスト — 許可外 chat ID の破棄・未知の `callback_data` の破棄・
+  `update_id` の冪等化・自由文の非処理・トークンが出力に混じらないこと
+- **L2**: 実機 — スマホへ通知が届き、ボタンのタップで `decisions.json` が更新される
+
+## 7. 将来（非スコープの明示）
+
+- カードごとの選択肢ボタン展開（v1）
+- 複数チャネル（LINE / Discord / Slack）
+- チャットからのエージェント起動・自由文指示（信頼境界の別契約が前提。常駐エージェント
+  = Hermes 等の検討もここに属する）
+- 承認待ちのエージェント側の再開機構（現状は人間が「続けて」と言う前提。ファイル待ちの
+  ポーリングを挟む設計は別途）

package/vendor/docs/contract-2026-08-12-color-range-normalization-v0.md

@@ -0,0 +1,59 @@
+# Color range normalization v0
+
+## 1. 背景と目的
+
+full-range（`color_range=pc` / `yuvj420p`）の入力をそのまま H.264 出力へ伝播させると、配信向けの limited range を期待する再生・検証環境で階調とメタデータが一致しない。本契約は Render の全エンコード工程を limited range（FFmpeg の `tv`）へ正規化し、最終成果物と中間生成物の一貫性を保証する。
+
+この不具合の起点と再現条件は [公開 issue #21](https://github.com/AkariLabs/akari-video/issues/21) を参照する。
+
+## 2. 最終出力の保証
+
+MP4 / H.264 の最終映像ストリームは次を満たさなければならない。
+
+- pixel format は `yuv420p`
+- `color_range` は `tv`（limited range）
+
+この組み合わせを AKARI Video の配信標準出力とする。
+
+## 3. 値変換とメタデータの不変条件
+
+色域レンジの正規化は、画素値の変換と映像ストリームへのメタデータのタグ付けを常に対で行う。
+
+- 各 video filter chain は出力直前に `scale=out_range=tv` 相当の値変換を行う。
+- 各 H.264 encode は `-color_range tv` 相当のメタデータを付ける。
+- full-range の画素値を残したまま `tv` タグだけを付けることを禁止する。
+- 値だけを limited range へ変換し、タグ付けを省略することも禁止する。
+
+入力がすでに tv range の場合、`scale=out_range=tv` はレンジ変換について no-op として扱う。
+
+## 4. 工程不変
+
+cut、tail padding、track stack、layers、overlay composite を含む各エンコード工程の出力フレームは常に tv range とする。これは最終成果物だけでなく、後続工程へ渡す中間生成物にも適用する。
+
+複数ソースの cut では、ソースごとの前処理チェーンで tv range へ正規化してから concat / transition へ入力する。これにより pc / tv range が混在したフレームを同じ concat へ直接渡さない。さらに、LUT や合成後の工程出力も終端で tv range に正規化する。
+
+映像を再エンコードしない audio-only mux と、alpha を運ぶ非 H.264 overlay 中間生成物は本契約の対象外とする。
+
+## 5. Probe と provenance
+
+入力ソースの `pix_fmt` と `color_range` を ffprobe の映像ストリームから取得し、既存の duration、audio 有無、width、height、fps と同じ provenance 情報として記録する。ffprobe が入力の `color_range` を報告しない場合は `null` として記録し、推測値で置き換えない。
+
+## 6. Verify 契約
+
+レンダープランの期待値へ `color_range: "tv"` を追加し、official verify は `verify.color-range` を報告する。
+
+- 実測 `color_range` が `pc` の場合は error とする。
+- 実測が `tv` の場合は pass とする。
+- ffprobe が `color_range` を報告しない場合は、H.264 の仕様既定（未指定は limited range）に従って tv とみなし pass とする。
+
+`verify.pixel-format` の期待値 `yuv420p` は維持し、`verify.color-range` と独立に判定する。
+
+## 7. 予約（今回のスコープ外）
+
+次の事項は別契約で扱い、本契約 v0 では実装しない。
+
+- BT.601 から BT.709 などの colorspace 変換
+- `-colorspace` / `-color_primaries` / `-color_trc` による colorspace メタデータの正規化
+- 10bit および HDR 入力の変換、tone mapping、出力形式
+
+本契約の `tv` 正規化は color range のみに限定され、上記の色域・伝達特性変換を暗黙に保証しない。