akari-video 0.1.0

package/vendor/packages/schemas/asset-meta.schema.json

@@ -0,0 +1,225 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:asset-meta:v0",
+  "title": "AKARI Video Asset Metadata v0",
+  "description": "AKARI Video 素材ライブラリの meta.json 契約 v0。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "category",
+    "title",
+    "description",
+    "when_to_use",
+    "tags",
+    "knobs",
+    "ai_usage",
+    "requires",
+    "provenance",
+    "author",
+    "license",
+    "price"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "category": {
+      "type": "string",
+      "enum": ["3d", "motion", "telop", "audio", "broll", "font", "thumbnail"]
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S"
+    },
+    "when_to_use": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S"
+    },
+    "tags": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "\\S"
+      }
+    },
+    "knobs": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/knob"
+      }
+    },
+    "ai_usage": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S"
+    },
+    "requires": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "\\S"
+      }
+    },
+    "provenance": {
+      "$ref": "#/$defs/provenance"
+    },
+    "author": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S"
+    },
+    "license": {
+      "$ref": "#/$defs/license"
+    },
+    "price": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "number", "minimum": 0 }
+      ]
+    },
+    "matched_by": {
+      "$comment": "drop-folder タイトル正規化照合の来歴フィールド（2026-07-22 導入）。将来の照合経路追加時は enum を拡張する。",
+      "enum": ["title-normalized"]
+    },
+    "remote": {
+      "type": "boolean",
+      "description": "true の場合、このエントリはカタログ上のみに存在し実体ファイルを持たない。source ブロックが実体の代わりになる（2026-07-14 追記・任意フィールド）。"
+    },
+    "source": {
+      "$ref": "#/$defs/source"
+    }
+  },
+  "$defs": {
+    "knob": {
+      "type": "object",
+      "description": "型固有の追加属性は将来の契約で定義する。v0 では既知属性だけを型検証する。バインド先は cssVar（オーバーレイ素材）か param（3D ベイクレシピ、2026-07-14 追記）のどちらか一方を必須とする。",
+      "required": ["type", "group"],
+      "oneOf": [
+        { "required": ["cssVar"], "not": { "required": ["param"] } },
+        { "required": ["param"], "not": { "required": ["cssVar"] } }
+      ],
+      "properties": {
+        "cssVar": {
+          "type": "string",
+          "pattern": "^--[A-Za-z_][A-Za-z0-9_-]*$"
+        },
+        "param": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["text", "color", "slider", "dropdown", "checkbox", "media"]
+        },
+        "group": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S"
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S"
+        },
+        "min": {
+          "type": "number"
+        },
+        "max": {
+          "type": "number"
+        },
+        "unit": {
+          "type": "string"
+        }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["origin", "generator"],
+      "properties": {
+        "origin": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S"
+        },
+        "generator": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1, "pattern": "\\S" }
+          ]
+        }
+      }
+    },
+    "license": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "spdx",
+        "scope",
+        "attribution_required",
+        "ai_training_allowed"
+      ],
+      "properties": {
+        "spdx": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S"
+        },
+        "scope": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S"
+        },
+        "attribution_required": {
+          "type": "boolean"
+        },
+        "ai_training_allowed": {
+          "type": "boolean"
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "description": "カタログ（remote: true）エントリの取得元情報。2026-07-14 追記・任意フィールド。",
+      "additionalProperties": false,
+      "required": ["url", "acquisition", "license_at_source", "attribution_required"],
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https?://"
+        },
+        "acquisition": {
+          "type": "string",
+          "enum": ["direct", "login", "purchase"]
+        },
+        "license_at_source": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S"
+        },
+        "attribution_required": {
+          "type": "boolean"
+        },
+        "preview_url": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https?://"
+        }
+      }
+    }
+  }
+}

package/vendor/packages/schemas/avatar-rendition.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:avatar-rendition:v0",
+  "title": "AKARI Video avatar rendition.json v0",
+  "description": "アバターの表現形態（rendition）1 つ分の能力宣言 + アセット索引。avatars/<id>/renditions/<rendition-id>/rendition.json に置く（段階読み出し契約の L2）。宣言のない能力・アセットは存在しないものとして扱う（捏造ゼロ）。詳細は docs/contract-2026-07-26-avatar-registry-v0.md 参照。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["version", "id", "kind", "capabilities", "assets"],
+  "properties": {
+    "version": { "const": 0 },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "$comment": "renditions/<id>/ ディレクトリ名と一致させる（例: 2d-bustup, 2d-fullbody）。"
+    },
+    "kind": { "enum": ["2d", "3d", "photo"] },
+    "capabilities": { "$ref": "#/$defs/capabilities" },
+    "assets": { "$ref": "#/$defs/assets" }
+  },
+  "$defs": {
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["lipsync", "expressions", "framing"],
+      "properties": {
+        "lipsync": { "type": "boolean" },
+        "expressions": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "pattern": "\\S" }
+        },
+        "framing": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "pattern": "\\S" }
+        }
+      },
+      "$comment": "avatar.json の renditions[].capabilities（要約）と同じ形。この rendition.json 側が詳細アセット索引を持つ正典。"
+    },
+    "assets": {
+      "type": "object",
+      "additionalProperties": true,
+      "minProperties": 1,
+      "properties": {
+        "expressions": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/assetFilename" },
+          "$comment": "表情名 → rendition ディレクトリ相対のファイル名。capabilities.expressions の要素をキーにする（例: {'neutral':'master-neutral-closed.png'}）。"
+        },
+        "lipsync": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/assetFilename" },
+          "$comment": "口パク状態名（neutral-closed/neutral-half/neutral-open 等）→ rendition ディレクトリ相対のファイル名。"
+        }
+      },
+      "$comment": "validate-avatar.mjs ルール(e) がここに列挙された全ファイル名を rendition ディレクトリ配下の実ファイルへ解決できるか検証する（欠落は全数列挙で fail）。"
+    },
+    "assetFilename": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S",
+      "$comment": "rendition.json と同じディレクトリからの相対パス（サブディレクトリ可）。絶対パス・親ディレクトリ参照は運用上避ける。"
+    }
+  }
+}

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

@@ -0,0 +1,178 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:avatar:v0",
+  "title": "AKARI Video avatar.json v0",
+  "description": "アバター・レジストリの機械可読正典（1 アバター = 1 avatar.json）。アイデンティティ（性格・話し口調）を核とし、2D/3D/実写/音声はその人格の rendition（表現形態）として宣言する。段階読み出し契約の L1（AVATAR.md）と内容を同期させる。詳細は docs/contract-2026-07-26-avatar-registry-v0.md 参照。version は整数・追加のみ進化・寛容リーダーの三原則に従う（docs/contract-2026-07-17-data-contract-versioning.md）。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "version",
+    "id",
+    "display_name",
+    "variants",
+    "persona",
+    "voice",
+    "renditions",
+    "default_rendition",
+    "rights"
+  ],
+  "properties": {
+    "version": { "const": 0 },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "$comment": "kebab-case。avatars/<id>/ ディレクトリ名と一致させる。"
+    },
+    "display_name": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S"
+    },
+    "variants": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+      },
+      "$comment": "例 ['ryoma-casual']。別人格にはしない — 同一 id 配下のバリアントとして持つ（契約 §0-1）。"
+    },
+    "persona": { "$ref": "#/$defs/persona" },
+    "voice": { "$ref": "#/$defs/voiceRef" },
+    "renditions": {
+      "type": "array",
+      "minItems": 0,
+      "items": { "$ref": "#/$defs/renditionSummary" },
+      "$comment": "0 件 = voice-only アバター（声のみ登録。2D/3D/写真の rendition を持たない。例: VOICEVOX プリセット提案の受け入れ登録）を許容する（S2 改訂 2026-07-26。1→0 緩和は追加のみ進化・既存 1 件以上の文書は全て valid のまま）。0 件のとき default_rendition は null 以外にできない（validate-avatar.mjs が検証）。"
+    },
+    "default_rendition": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" }
+      ],
+      "$comment": "null = 挿入のたびに decision card で質問する（契約 §7）。スタイル記憶（系統 B）が承認を経て書き込む。"
+    },
+    "rights": { "$ref": "#/$defs/rights" }
+  },
+  "$defs": {
+    "persona": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "first_person",
+        "tone",
+        "speech_style",
+        "verbal_tics",
+        "energy",
+        "ng",
+        "default_role"
+      ],
+      "properties": {
+        "first_person": { "type": "string", "minLength": 1, "pattern": "\\S" },
+        "tone": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "$comment": "direction engine の tone 語彙（真面目/親しみ/高級感/勢い/かわいい/無機質/エモい/シネマ）を軸にした自由記述。複合可（例 '落ち着いた・親しみ'）。enum 強制はしない。"
+        },
+        "speech_style": { "type": "string", "minLength": 1, "pattern": "\\S" },
+        "verbal_tics": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "pattern": "\\S" }
+        },
+        "energy": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "$comment": "ドパ度（演出の派手さ）とは別軸。キャラ自身のテンション・熱量（0=クール・落ち着き、100=ハイテンション）。尺度のみ共用し意味論は混同しない（契約 §4）。"
+        },
+        "ng": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "pattern": "\\S" }
+        },
+        "default_role": {
+          "enum": ["explainer", "listener", "tsukkomi", "narrator", "guest"],
+          "$comment": "配役語彙 5 種（契約 §6-2）。追加のみ進化。"
+        }
+      }
+    },
+    "voiceRef": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["lane", "ref", "credit"],
+      "properties": {
+        "lane": {
+          "enum": ["voicevox", "fal-clone", "recorded"],
+          "$comment": "narration-tts 契約の 3 レーン語彙（voicevox=既製声 / fal-clone=自声クローン / recorded=録音そのまま）。ElevenLabs は凍結中のためレーンとして宣言しない。"
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "$comment": "speaker:3(ずんだもん/ノーマル) または profile:owner-ja のような参照名（narration-tts 契約 §3 と同型）。"
+        },
+        "credit": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1, "pattern": "\\S" }
+          ],
+          "$comment": "VOICEVOX 系（third_party）はクレジット表記義務がある場合ここに記録し、narration provenance へ転写される。"
+        }
+      }
+    },
+    "renditionSummary": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "kind", "capabilities"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+        "kind": { "enum": ["2d", "3d", "photo"] },
+        "capabilities": { "$ref": "#/$defs/capabilities" }
+      },
+      "$comment": "詳細（アセット索引）は renditions/<id>/rendition.json（avatar-rendition.schema.json）側の正典。ここは能力宣言の要約のみ。"
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["lipsync", "expressions", "framing"],
+      "properties": {
+        "lipsync": { "type": "boolean" },
+        "expressions": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "pattern": "\\S" }
+        },
+        "framing": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "pattern": "\\S" }
+        }
+      },
+      "$comment": "宣言のない能力は存在しないものとして扱う（捏造ゼロの規律・契約 §0-2）。"
+    },
+    "rights": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["subject", "consent", "credit_required", "distribution"],
+      "properties": {
+        "subject": {
+          "enum": ["person", "original", "third_party"],
+          "$comment": "person=実在人物 / original=自作キャラ / third_party=VOICEVOX 等（契約 §6-3）。"
+        },
+        "consent": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "$comment": "self | signed:<path> | terms:<url> のいずれかの形式。詳細な形式検査は validate-avatar.mjs が行う。"
+        },
+        "credit_required": { "type": "boolean" },
+        "distribution": {
+          "enum": ["private", "org", "sellable"],
+          "$comment": "subject=person のとき sellable は禁止（validate-avatar.mjs ルール b）。"
+        }
+      }
+    }
+  }
+}