akari-video 0.1.0

package/vendor/packages/schemas/recipe.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:recipe:v0",
+  "title": "AKARI Video recipe.json v0",
+  "description": "承認済みプロジェクトの確認された選好の断面を名前付きレシピとして凍結する個人層ファイル。~/.akari/recipes/<name>.json に置く（プロジェクト内には置かない）。確認済みの値だけを記録し（推測・既定値採用は記録しない）、次のプロジェクトでは出所付きの推奨として提示する（今回の依頼を上書きせず、必須質問をスキップさせない）。詳細は docs/contract-2026-07-25-recipe-v0.md 参照。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["version", "name", "frozen_at", "source_project", "workflow", "confirmed", "provenance"],
+  "properties": {
+    "version": { "const": 0 },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "$comment": "kebab-case。呼び出し名（『<名前>でもう一本』『前回と同じで』の対象）。~/.akari/recipes/<name>.json のファイル名と一致させる。"
+    },
+    "frozen_at": {
+      "type": "string",
+      "format": "date-time",
+      "$comment": "凍結（freeze 実行）時刻。"
+    },
+    "source_project": {
+      "$ref": "#/$defs/nonEmptyString",
+      "$comment": "プロジェクト名 + 日付の自由記述（例 acme-product-launch-2026-07-20）。パスを書かない — プロジェクトの移動・削除で壊れる参照を持たない。"
+    },
+    "workflow": {
+      "enum": ["edit", "research"],
+      "$comment": "どの工程の選好か。edit = skills/edit-plan、research = skills/research-plan。"
+    },
+    "confirmed": { "$ref": "#/$defs/confirmed" },
+    "provenance": { "$ref": "#/$defs/provenance" }
+  },
+  "$defs": {
+    "nonEmptyString": { "type": "string", "minLength": 1, "pattern": "\\S" },
+    "confirmed": {
+      "type": "object",
+      "additionalProperties": true,
+      "minProperties": 1,
+      "$comment": "確認済み選好のみ。全フィールド任意・null 不可（確認されていない項目はキー自体を書かない）。空 object は不可 — 何も確認していないなら freeze する理由がない。",
+      "properties": {
+        "aspect": {
+          "enum": ["16:9", "9:16", "1:1"],
+          "$comment": "既存カタログタグの慣用値（例 catalog/3d/vintage-camera/meta.json の tags[]）をそのまま採用。新しい語彙を作らない。"
+        },
+        "target_duration_band": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "厳密な尺そのものではなく帯（例 '30-60s'）。素材が変われば正確な秒数は転用できないため帯で記録する。"
+        },
+        "caption_style_ref": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "字幕スタイルの参照名（カタログの telop プリセット名、または字幕方針を指す自由記述）。"
+        },
+        "bgm_profile": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "BGM の選好を指す自由記述（ジャンル・ムード・カタログ候補名等）。"
+        },
+        "overlay_kinds": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/nonEmptyString" },
+          "minItems": 1,
+          "uniqueItems": true,
+          "$comment": "skills/overlay-authoring/*.md の kind 名（telop/3d/table/motion/text-behind-person/thumbnail 等）を目安にするが、enum 強制はしない（overlay-authoring の追加に追従できるように）。"
+        },
+        "narration": { "$ref": "#/$defs/narration" }
+      }
+    },
+    "narration": {
+      "type": "object",
+      "additionalProperties": true,
+      "minProperties": 1,
+      "$comment": "engine・voice はともに任意・null 不可。確認された方だけを書く。",
+      "properties": {
+        "engine": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "edit.schema.json の narrationProvenance.provider/engine と同じ自由記述語彙（voicevox/fal/elevenlabs/human 等）。enum 強制はしない。"
+        },
+        "voice": { "$ref": "#/$defs/nonEmptyString" }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": true,
+      "minProperties": 1,
+      "$comment": "confirmed に実在するキーと過不足なく 1 対 1 対応する（JSON Schema 単体では兄弟オブジェクトのキー集合比較を表せないため validate-recipe.mjs で検証する）。",
+      "properties": {
+        "aspect": { "$ref": "#/$defs/provenanceEntry" },
+        "target_duration_band": { "$ref": "#/$defs/provenanceEntry" },
+        "caption_style_ref": { "$ref": "#/$defs/provenanceEntry" },
+        "bgm_profile": { "$ref": "#/$defs/provenanceEntry" },
+        "overlay_kinds": { "$ref": "#/$defs/provenanceEntry" },
+        "narration": { "$ref": "#/$defs/provenanceEntry" }
+      }
+    },
+    "provenanceEntry": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["confirmed_by", "at"],
+      "properties": {
+        "confirmed_by": {
+          "enum": ["intake", "structure-confirm", "edit-approval", "render-approval"],
+          "$comment": "確認されたチェックポイント。契約 §4 の対応表。"
+        },
+        "at": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

package/vendor/packages/schemas/research-plan.schema.json

@@ -0,0 +1,230 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:research-plan:v0",
+  "title": "AKARI Video research-plan.json v0",
+  "description": "企画・調査工程（00）の SSOT。選定ネタ・ターゲット/競合調査・構成案・絵コンテのショットカード・撮影用ショットリストの機械可読正本。research-plan スキルの成果物。packages/schemas/plan.schema.json（仮枠タイムライン・アニマティクス）とは別物 — plan.json は撮影後/生成後の仮組みタイムライン、research-plan.json は撮影前の企画そのもの。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["version", "topic", "target", "structure", "shot_list", "sources", "feedback"],
+  "properties": {
+    "version": { "const": 0 },
+    "topic": { "$ref": "#/$defs/topic" },
+    "target": { "$ref": "#/$defs/target" },
+    "structure": { "$ref": "#/$defs/structure" },
+    "shot_list": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/shotListEntry" },
+      "$comment": "撮影・収録の実務リスト。企画段階の絵コンテ（structure.shots）とは別物 — shots が「何を撮るか」、shot_list が「どう撮るか・何を確認するか」。"
+    },
+    "sources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/source" },
+      "$comment": "外部調査の由来記録（URL・取得日時・無償/有償の別）。トレンド調査の根拠もここに集約する（専用の trends フィールドは持たない — 知見は topic.candidates[].rationale / target.competitors[].gap の根拠として溶け込ませ、出典だけをここに残す）。"
+    },
+    "feedback": {
+      "$ref": "#/$defs/feedback",
+      "$comment": "80 配信後分析からの還流用の予約フィールド（契約の非スコープ。v0 は実装しない）。"
+    }
+  },
+  "$defs": {
+    "nonEmptyString": { "type": "string", "minLength": 1, "pattern": "\\S" },
+    "nullableNonEmptyString": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nonEmptyString" }]
+    },
+    "positiveSeconds": { "type": "number", "exclusiveMinimum": 0 },
+    "nullablePositiveSeconds": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/positiveSeconds" }]
+    },
+    "stringArray": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/nonEmptyString" }
+    },
+    "topic": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["candidates", "selected", "decided_at"],
+      "properties": {
+        "candidates": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/candidate" },
+          "$comment": "配列順 = ランキング順（最有力を先頭に置く）。rank フィールドは持たず順序だけで表現する（plan.schema.json の slots と同型）。"
+        },
+        "selected": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "candidates[].id への参照。未決定は null。"
+        },
+        "decided_at": {
+          "oneOf": [{ "type": "null" }, { "type": "string", "format": "date-time" }],
+          "$comment": "selected が非 null のときだけ非 null（decision-cards の topic-select カード確定時刻）。"
+        }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "category", "monetization_potential", "rationale"],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "title": { "$ref": "#/$defs/nonEmptyString" },
+        "category": {
+          "enum": ["hub", "hero", "help"],
+          "$comment": "Hub/Hero/Help 分類。定期性(Hub)/バズ狙い(Hero)/検索流入(Help) の型。"
+        },
+        "monetization_potential": { "enum": ["high", "medium", "low"] },
+        "rationale": { "$ref": "#/$defs/nonEmptyString" }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["audience", "competitors", "japan_sns"],
+      "properties": {
+        "audience": { "$ref": "#/$defs/nullableNonEmptyString" },
+        "competitors": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/competitor" }
+        },
+        "japan_sns": { "$ref": "#/$defs/japanSns" }
+      }
+    },
+    "competitor": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["name", "url", "notes", "gap"],
+      "properties": {
+        "name": { "$ref": "#/$defs/nonEmptyString" },
+        "url": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "format": "uri", "pattern": "^https?://" }
+          ]
+        },
+        "notes": { "oneOf": [{ "type": "null" }, { "type": "string" }] },
+        "gap": {
+          "oneOf": [{ "type": "null" }, { "type": "string" }],
+          "$comment": "4 並列ギャップ分析（コンテンツテーマ/フォーマット・尺/投稿頻度/訴求軸）の所見。軸ごとの厳密な enum は持たず自由記述にする。"
+        }
+      }
+    },
+    "japanSns": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["platforms", "notes"],
+      "properties": {
+        "platforms": { "$ref": "#/$defs/stringArray" },
+        "notes": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "必須調査軸（ハードルール）。無償手段で確認できない場合も、その旨と理由を書く（省略・空文字は不可）。"
+        }
+      }
+    },
+    "structure": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["chapters", "shots", "opening_hook", "confirmed", "confirmed_at"],
+      "properties": {
+        "chapters": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/chapter" },
+          "$comment": "配列順 = 構成案タイムライン順。"
+        },
+        "shots": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/shot" },
+          "$comment": "絵コンテのショットカード。"
+        },
+        "opening_hook": { "$ref": "#/$defs/nullableNonEmptyString" },
+        "confirmed": { "type": "boolean" },
+        "confirmed_at": {
+          "oneOf": [{ "type": "null" }, { "type": "string", "format": "date-time" }],
+          "$comment": "confirmed が true のときだけ非 null（decision-cards の structure-confirm カード確定時刻）。AI の判断だけで confirmed を true にしない。"
+        }
+      }
+    },
+    "chapter": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "duration_estimate_seconds", "notes"],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "title": { "$ref": "#/$defs/nonEmptyString" },
+        "duration_estimate_seconds": { "$ref": "#/$defs/nullablePositiveSeconds" },
+        "notes": { "oneOf": [{ "type": "null" }, { "type": "string" }] }
+      }
+    },
+    "shot": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "id",
+        "chapter_id",
+        "shot_type",
+        "description",
+        "duration_estimate_seconds",
+        "image_path"
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "chapter_id": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "chapters[].id への参照。null = 未割当。"
+        },
+        "shot_type": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "wide / medium / close-up 等の自由記述。表現の幅を残すため厳密な enum にしない。"
+        },
+        "description": { "$ref": "#/$defs/nonEmptyString" },
+        "duration_estimate_seconds": { "$ref": "#/$defs/nullablePositiveSeconds" },
+        "image_path": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "任意の概念画像（絵コンテ）。生成する場合は edit-plan の承認・provenance 規律に従う。research-plan.json 所在ディレクトリ基準の相対パス。"
+        }
+      }
+    },
+    "shotListEntry": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "ref_shot_id", "location", "equipment", "checklist", "status"],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "ref_shot_id": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "structure.shots[].id への参照。null = 未割当。"
+        },
+        "location": { "$ref": "#/$defs/nullableNonEmptyString" },
+        "equipment": { "$ref": "#/$defs/stringArray" },
+        "checklist": { "$ref": "#/$defs/stringArray" },
+        "status": { "enum": ["planned", "ok", "ng"] }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "url", "retrieved_at", "cost", "note"],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "url": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "オフライン観察等 URL の無い出典は null 可。その場合 note に出所を書く。"
+        },
+        "retrieved_at": {
+          "oneOf": [{ "type": "null" }, { "type": "string", "format": "date-time" }]
+        },
+        "cost": { "enum": ["free", "paid"] },
+        "note": { "oneOf": [{ "type": "null" }, { "type": "string" }] }
+      }
+    },
+    "feedback": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["reserved", "note"],
+      "properties": {
+        "reserved": {
+          "const": true,
+          "$comment": "80 配信後分析からの還流用の予約フィールド。v0 は実装しない（常に true）。"
+        },
+        "note": { "oneOf": [{ "type": "null" }, { "type": "string" }] }
+      }
+    }
+  }
+}

package/vendor/packages/schemas/review.schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:review:v1",
+  "title": "AKARI Video review.json v1 annotation model",
+  "description": "QA ループの注釈サイドカー。edit.json と同じディレクトリに置く。時間アンカーは (src, source 秒) で永続化し、timeline 秒は永続化しない（contract-2026-07-18 §3/§4）。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["version", "annotations"],
+  "properties": {
+    "version": { "const": 0 },
+    "annotations": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/annotation" }
+    }
+  },
+  "$defs": {
+    "nonEmptyString": { "type": "string", "minLength": 1, "pattern": "\\S" },
+    "sourceSeconds": { "type": "number", "minimum": 0 },
+    "normalized01": { "type": "number", "minimum": 0, "maximum": 1 },
+    "box": {
+      "type": "array",
+      "prefixItems": [
+        { "$ref": "#/$defs/normalized01" },
+        { "$ref": "#/$defs/normalized01" },
+        { "$ref": "#/$defs/normalized01" },
+        { "$ref": "#/$defs/normalized01" }
+      ],
+      "minItems": 4,
+      "maxItems": 4,
+      "$comment": "[x, y, w, h] 正規化座標。source フレーム基準（出力フレームではない）。意味制約 x+w<=1 かつ y+h<=1 は validate-review.mjs で検証する（analysis.schema.json の faceBox / edit.json crop.box と同一形式）。"
+    },
+    "strokePoint": {
+      "type": "array",
+      "prefixItems": [
+        { "$ref": "#/$defs/normalized01" },
+        { "$ref": "#/$defs/normalized01" }
+      ],
+      "minItems": 2,
+      "maxItems": 2
+    },
+    "strokePoints": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/strokePoint" },
+      "minItems": 2,
+      "$comment": "フリーハンド 1 ストロークの間引き済みポリライン（〜100 点程度。review セッション契約 §4.2）。"
+    },
+    "strokeFrame": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["sourceT"],
+      "properties": {
+        "sourceT": { "$ref": "#/$defs/sourceSeconds" },
+        "cutIndex": { "oneOf": [{ "type": "null" }, { "type": "integer", "minimum": 0 }] }
+      },
+      "$comment": "描き始めフレーム（アンカー）。content-rect（動画面）のみ持つ。"
+    },
+    "stroke": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["tool", "space", "frame", "points", "sessionRef"],
+          "properties": {
+            "tool": { "const": "pen" },
+            "space": { "const": "content-rect" },
+            "frame": { "$ref": "#/$defs/strokeFrame" },
+            "points": { "$ref": "#/$defs/strokePoints" },
+            "sessionRef": { "$ref": "#/$defs/nonEmptyString" }
+          },
+          "$comment": "動画面（review セッション S3・§4.2）。frame + sessionRef は必須（録音セッション由来のみ）。"
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["tool", "space", "points"],
+          "not": { "required": ["frame"] },
+          "properties": {
+            "tool": { "const": "pen" },
+            "space": { "const": "image-rect" },
+            "points": { "$ref": "#/$defs/strokePoints" },
+            "sessionRef": { "$ref": "#/$defs/nonEmptyString" }
+          },
+          "$comment": "画像面（contract-2026-07-26-doc-image-annotations §3）。frame は動画フレームアンカーが存在しないため省略必須。sessionRef は録音セッション由来でない単発注釈では省略できる。"
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["tool", "space", "points"],
+          "not": { "required": ["frame"] },
+          "properties": {
+            "tool": { "const": "pen" },
+            "space": { "const": "canvas-rect" },
+            "points": { "$ref": "#/$defs/strokePoints" },
+            "canvasRef": { "$ref": "#/$defs/nonEmptyString" }
+          },
+          "$comment": "キャンバス面（contract-2026-07-26-canvas-surface §1/§4）。image-rect と同型だが出所参照フィールド名が canvasRef（c-0001/st-0003 形式）。frame は動画フレームアンカーが存在しないため省略必須。canvasRef は任意。"
+        }
+      ],
+      "$comment": "review セッション契約 §4.2 の annotation 着地型（tool:pen 固定・space で判別）。"
+    },
+    "refItem": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["src"],
+          "not": { "required": ["path"] },
+          "properties": { "src": { "$ref": "#/$defs/nonEmptyString" } }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["path"],
+          "not": { "required": ["src"] },
+          "properties": { "path": { "$ref": "#/$defs/nonEmptyString" } }
+        }
+      ],
+      "$comment": "src = edit.json v1 sources[].id 参照。path = プロジェクト相対パス（copy-don't-link 後の実体）。1 エントリにつき排他。"
+    },
+    "response": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["summary", "action", "respondedAt"],
+      "properties": {
+        "summary": { "type": "string" },
+        "action": { "enum": ["edited", "declined"] },
+        "respondedAt": { "type": "string" }
+      }
+    },
+    "annotation": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "createdAt", "sourceT", "text", "input", "status"],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "createdAt": { "type": "string" },
+        "src": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nonEmptyString" }],
+          "$comment": "edit.json v1 の sources[].id 参照。省略/null = 単一ソース互換。参照整合は edit-lint が検証する。"
+        },
+        "sourceT": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/sourceSeconds" }],
+          "$comment": "source 秒（cuts[].in/out と同一座標系）。timeline 秒ではない。null は target が doc:<path>#<block-id> / image:<path> のときのみ許容する（contract-2026-07-26-doc-image-annotations §2）。動画面の注釈（target が overlay: / cut: / null）は従来どおり必須 — validate-review.mjs / createAnnotation が実体を検証する。"
+        },
+        "sourceRange": {
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "array",
+              "prefixItems": [
+                { "$ref": "#/$defs/sourceSeconds" },
+                { "$ref": "#/$defs/sourceSeconds" }
+              ],
+              "minItems": 2,
+              "maxItems": 2
+            }
+          ],
+          "$comment": "[start, end) source 秒。start < end は validate-review.mjs で検証する。"
+        },
+        "timelineT": {
+          "oneOf": [{ "type": "null" }, { "type": "number" }],
+          "deprecated": true,
+          "$comment": "非推奨（contract-2026-07-18 §3 違反の旧フィールド）。新規書き込みは常に null。timeline 位置は表示のたびに cuts[] から射影する。"
+        },
+        "target": {
+          "oneOf": [{ "type": "null" }, { "type": "string" }],
+          "$comment": "targetKind とは別物。null / overlay:<id> / cut:<index> に加え、contract-2026-07-26-doc-image-annotations §1 で doc:<プロジェクト相対パス>#<block-id>（分析レポート等のブロック注釈）と image:<プロジェクト相対パス>（画像アセットへの注釈）を、contract-2026-07-26-canvas-surface §4 で canvas:<c-NNNN>（キャンバス面への注釈）を追加する。doc: / image: / canvas: のときに限り sourceT は null を許容する（§2 および同契約 §4）。"
+        },
+        "targetKind": {
+          "oneOf": [
+            { "type": "null" },
+            { "enum": ["instant", "range", "region", "asset", "insert"] }
+          ],
+          "$comment": "対象 5 型の判別子。null/省略 = 旧レコード（sourceRange の有無で instant/range を解釈）。型ごとの期待フィールド（range→sourceRange、region→region|strokes、asset→refs、insert→insertPosition）は助言レベル（validate-review.mjs / edit-lint の warning）。"
+        },
+        "region": {
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "additionalProperties": true,
+              "required": ["box"],
+              "properties": { "box": { "$ref": "#/$defs/box" } }
+            }
+          ]
+        },
+        "strokes": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "array", "items": { "$ref": "#/$defs/stroke" }, "minItems": 1 }
+          ],
+          "$comment": "review セッション契約 §4.2 で確定した着地型（tool/space/points 等を持つオブジェクト配列）。region.box と両方非 null の場合は region.box が勝つ（warning）。"
+        },
+        "refs": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "array", "items": { "$ref": "#/$defs/refItem" }, "minItems": 1 }
+          ]
+        },
+        "insertPosition": {
+          "oneOf": [{ "type": "null" }, { "enum": ["before", "after"] }],
+          "$comment": "targetKind insert 用。アンカー (src, sourceT) に対応する timeline 位置の前/後に挿入する。"
+        },
+        "intent": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nonEmptyString" }],
+          "$comment": "自由文字列。推奨語彙は契約文書（enum 強制しない）。"
+        },
+        "text": { "type": "string" },
+        "input": {
+          "enum": ["typed", "voice", "session"],
+          "$comment": "review セッション契約 §6 で追加された着地元。ライダー r1（2026-07-26-canvas-surface 起票時点で回収）: この enum と apps/shell reader は当初 session 未許可のままだったため実データ（skills/address-review/dev-fixtures/fixture-project/review.json）が validator エラーになっていた。"
+        },
+        "audio": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nonEmptyString" }]
+        },
+        "poses": {
+          "type": "null",
+          "$comment": "予約のまま（実演キャプチャ。本契約のスコープ外）。"
+        },
+        "status": { "enum": ["open", "addressed", "resolved"] },
+        "response": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/response" }]
+        }
+      }
+    }
+  }
+}

package/vendor/packages/schemas/test/fixtures/asset/invalid-matched-by/audio/whoosh-transition/meta.json

@@ -0,0 +1,31 @@
+{
+  "id": "whoosh-transition",
+  "category": "audio",
+  "title": "ウッシュ・トランジション SFX",
+  "description": "竹の棒を振って収録された短く鋭いウッシュ音。20万件超のダウンロード実績を持つ定番のトランジション SFX。尺 0.43秒",
+  "when_to_use": "シーン転換、テロップ/画像のワイプ・スライドイン、カット切り替えのアクセントに",
+  "tags": ["sfx", "whoosh", "swoosh", "transition"],
+  "knobs": [],
+  "ai_usage": "音量調整・複数回の重ね掛けは自由。映像のタイミングに合わせたトリムも可。ピッチ・速度を大きく変えると素材の質感が崩れるため軽微な調整に留める",
+  "requires": [],
+  "provenance": {
+    "origin": "AKARI Video 素材カタログ収録（Freesound / qubodup）/ 2026-07-14",
+    "generator": null
+  },
+  "author": "ryoma",
+  "license": {
+    "spdx": "CC0-1.0",
+    "scope": "commercial-ok",
+    "attribution_required": false,
+    "ai_training_allowed": true
+  },
+  "price": null,
+  "matched_by": "guessed",
+  "remote": true,
+  "source": {
+    "url": "https://freesound.org/people/qubodup/sounds/60013/",
+    "acquisition": "login",
+    "license_at_source": "CC0 1.0",
+    "attribution_required": false
+  }
+}

package/vendor/packages/schemas/test/fixtures/asset/valid-catalog/audio/whoosh-transition/meta.json

@@ -0,0 +1,31 @@
+{
+  "id": "whoosh-transition",
+  "category": "audio",
+  "title": "ウッシュ・トランジション SFX",
+  "description": "竹の棒を振って収録された短く鋭いウッシュ音。20万件超のダウンロード実績を持つ定番のトランジション SFX。尺 0.43秒",
+  "when_to_use": "シーン転換、テロップ/画像のワイプ・スライドイン、カット切り替えのアクセントに",
+  "tags": ["sfx", "whoosh", "swoosh", "transition"],
+  "knobs": [],
+  "ai_usage": "音量調整・複数回の重ね掛けは自由。映像のタイミングに合わせたトリムも可。ピッチ・速度を大きく変えると素材の質感が崩れるため軽微な調整に留める",
+  "requires": [],
+  "provenance": {
+    "origin": "AKARI Video 素材カタログ収録（Freesound / qubodup）/ 2026-07-14",
+    "generator": null
+  },
+  "author": "ryoma",
+  "license": {
+    "spdx": "CC0-1.0",
+    "scope": "commercial-ok",
+    "attribution_required": false,
+    "ai_training_allowed": true
+  },
+  "price": null,
+  "matched_by": "title-normalized",
+  "remote": true,
+  "source": {
+    "url": "https://freesound.org/people/qubodup/sounds/60013/",
+    "acquisition": "login",
+    "license_at_source": "CC0 1.0",
+    "attribution_required": false
+  }
+}