akari-video 0.1.0

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

@@ -0,0 +1,419 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:interpretation:v0",
+  "title": "AKARI Video interpretation.json v0",
+  "description": "複数素材（プロジェクト単位）を横断する解釈層。事実層（各素材の analysis.json、無改修・不変）を並べて読み直す 2 パス目の出力で、プロジェクトあたり 1 ファイル。全ての optional フィールドは、値を持たないとき『キー自体を省略する』ことで表現する。null は使用しない（本 schema は nullable な型を一切定義しない）。",
+  "$comment": "解釈の全主張には根拠（transcript 区間の引用 / keyframe note 参照）を必須とする（捏造ゼロ・出所追跡）。この規律は arc[] と flags[] の evidence 必須というかたちで表れる。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "inputs",
+    "assets",
+    "arc",
+    "open_questions"
+  ],
+  "properties": {
+    "version": {
+      "const": 0
+    },
+    "inputs": {
+      "$ref": "#/$defs/inputs"
+    },
+    "assets": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/asset"
+      }
+    },
+    "arc": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/arcEntry"
+      },
+      "description": "構成案（編集順のタイムライン）。各エントリは根拠必須で、素材の再視聴なしに transcript / keyframe note から直接引ける主張だけを書く。"
+    },
+    "open_questions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/openQuestion"
+      },
+      "description": "取材台帳。空配列は正常系であり『取材の必要なし（構成案が事実の捏造なしに一本通った）』を意味する。走査自体は 2 パス目の契約義務であり、未走査状態はこの schema では表現しない — 空配列は常に『検討した上で 0 件』である。"
+    }
+  },
+  "$defs": {
+    "seconds": {
+      "type": "number",
+      "minimum": 0
+    },
+    "inputs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "analyses"
+      ],
+      "properties": {
+        "analyses": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/analysisRef"
+          },
+          "description": "参照する事実層（素材ごとの analysis.json）。1 件以上必須。"
+        },
+        "context": {
+          "$ref": "#/$defs/context",
+          "description": "2 パス目に与えた文脈の来歴（provenance）。省略可 — 2 パス目に analyses 以外の文脈を一切与えなかった場合はキー自体を省略する。"
+        }
+      }
+    },
+    "analysisRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref",
+        "path",
+        "source"
+      ],
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "description": "参照する素材の assets[].ref への外部キー。assets[].ref と 1:1 対応する（過不足・重複なし）。renderer の --analysis <ref>=<path> 結合キーとしても使う。"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "参照する analysis.json へのパス。相対パスは interpretation.json の所在ディレクトリを基準に解決する。"
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "description": "素材の由来・生成条件の要約（analyze-footage 実行条件・素材の性質など）。"
+        }
+      },
+      "$comment": "2026-07-22 A3.2 multiasset-dogfood の実証（--analysis の位置対応づけを入れ替えても無警告で assets[].ref と analysis.json の中身が入れ替わる silent data corruption を再現）を受けて ref を必須化（司令塔裁定）。validate-interpretation.mjs が assets[].ref との 1:1 対応（過不足・重複なし）を検証する。"
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "past_projects",
+        "interview"
+      ],
+      "properties": {
+        "intake": {
+          "type": "object",
+          "additionalProperties": true,
+          "$comment": "intake.json 要約。内部構造は intake.schema.json 側の管轄であり本 v0 では自由形式とする（存在しないプロジェクトでは省略。null にしない）。",
+          "description": "intake.json の要約。省略可。"
+        },
+        "past_projects": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/pastProjectRef"
+          },
+          "description": "過去 PJ・他社形式テンプレ参照の記録。無ければ空配列（省略はしない — 与えた文脈の全記録という context の性質上、キーはあるが空、で『参照なし』を表す）。"
+        },
+        "interview": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/interviewPair"
+          },
+          "description": "取材の Q&A。open_questions[].status が answered に昇格したときの反映先。無ければ空配列。"
+        },
+        "notes": {
+          "type": "string",
+          "minLength": 1,
+          "description": "上記に当てはまらない自由記述の補足。省略可。"
+        }
+      }
+    },
+    "pastProjectRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref",
+        "notes"
+      ],
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "notes": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "interviewPair": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "q",
+        "a"
+      ],
+      "properties": {
+        "q": {
+          "type": "string",
+          "minLength": 1
+        },
+        "a": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "asset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref",
+        "role",
+        "summary",
+        "relations",
+        "flags"
+      ],
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "description": "素材参照 ID。プロジェクト内で一意。"
+        },
+        "role": {
+          "type": "string",
+          "minLength": 1,
+          "description": "この素材が物語上で果たす役割を表す短いタグ（自由記述。enum にしない）。"
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sections": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/section"
+          },
+          "$comment": "単素材では arc と準同型になる。複数素材 fieldtest で要再裁定（2026-07-22 A3）。",
+          "description": "素材内の章単位の役割分析。省略可（採用するかは A2 以降の複数素材 fieldtest で再判断する）。"
+        },
+        "relations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/relation"
+          },
+          "description": "他素材との関係（設計主眼は複数素材ケース）。単素材プロジェクトでは常に空配列になる自明ケースとして扱う。維持する（省略しない）。空配列可。"
+        },
+        "flags": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/flag"
+          },
+          "description": "浮き・トラブル等の検出結果。空配列の意味論は『走査した上で該当なし』であり、未走査状態ではない（走査は 2 パス目の契約義務）。維持する（省略しない）。空配列可。"
+        }
+      }
+    },
+    "section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "start",
+        "end",
+        "title",
+        "role",
+        "evidence"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "role": {
+          "type": "string",
+          "minLength": 1,
+          "description": "章単位の分類タグ（自由記述）。asset.role が素材全体を 1 個で表すのに対し、こちらは章ごとに分類する。"
+        },
+        "evidence": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "$comment": "意味制約として end > start とする。Draft 2020-12 標準では兄弟プロパティ間を比較できないため、この条件は検証手順（CLI）で確認する。"
+    },
+    "relation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "kind",
+        "evidence"
+      ],
+      "properties": {
+        "target": {
+          "type": "string",
+          "minLength": 1,
+          "description": "関係先の assets[].ref。自素材への自己参照は不可。"
+        },
+        "kind": {
+          "type": "string",
+          "minLength": 1,
+          "description": "関係の種類（例: b_roll_of / complements / supersedes / duplicate_of）。自由記述（enum にしない）。"
+        },
+        "evidence": {
+          "type": "string",
+          "minLength": 1
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "$comment": "relations[] の item 形状は複数素材 fieldtest 未実施につき仮設計（2026-07-22 A1）。単素材 dogfood では検証不能だった（schema-observations.md §2）。乖離が見つかれば複数素材 fieldtest 後に改訂する。"
+    },
+    "flag": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "evidence"
+      ],
+      "properties": {
+        "type": {
+          "enum": [
+            "orphan",
+            "unclear",
+            "trouble_overlap"
+          ],
+          "$comment": "追記のみ進化の原則で将来拡張する（既存値は変更・削除しない）。"
+        },
+        "evidence": {
+          "type": "string",
+          "minLength": 1
+        },
+        "start": {
+          "$ref": "#/$defs/seconds",
+          "description": "区間を持たない flag を許すため省略可。"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds",
+          "description": "区間を持たない flag を許すため省略可。"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "$comment": "意味制約として、start と end は両方省略か両方指定のいずれかとし、両方指定時は end > start とする。この条件は検証手順（CLI）で確認する。"
+    },
+    "arcEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "order",
+        "title",
+        "refs",
+        "purpose",
+        "evidence"
+      ],
+      "properties": {
+        "order": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "構成順。arc 内で一意。"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "refs": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/arcRef"
+          },
+          "description": "このエントリが参照する素材区間。1 件以上必須。"
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        },
+        "evidence": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "arcRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "asset"
+      ],
+      "properties": {
+        "asset": {
+          "type": "string",
+          "minLength": 1,
+          "description": "assets[].ref への参照。"
+        },
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        }
+      }
+    },
+    "openQuestion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "question",
+        "fills",
+        "status"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "open_questions 内で一意。"
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fills": {
+          "type": "string",
+          "minLength": 1,
+          "description": "この質問が埋める情報ギャップ（何のために聞くか）。"
+        },
+        "status": {
+          "enum": [
+            "open",
+            "answered"
+          ]
+        },
+        "answer": {
+          "type": "string",
+          "minLength": 1,
+          "description": "status が answered のとき必須。open のときは省略する（null にしない）。"
+        }
+      },
+      "$comment": "意味制約として、status が answered のとき answer は必須、open のとき省略する。この条件は検証手順（CLI）で確認する。"
+    }
+  }
+}

package/vendor/packages/schemas/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@akari-video/schemas",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "validate-asset": "bin/validate-asset.mjs",
+    "validate-intake": "bin/validate-intake.mjs",
+    "validate-plan": "bin/validate-plan.mjs",
+    "validate-review": "bin/validate-review.mjs"
+  },
+  "scripts": {
+    "test": "node --test \"test/*.mjs\""
+  },
+  "devDependencies": {
+    "ajv": "^8.17.1"
+  }
+}

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

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:plan-comments:v0",
+  "title": "AKARI Video plan-comments.json v0",
+  "description": "承認可能プラン層への構造化差し戻しコメント。提出のたび <plan-dir>/plan-comments.json を 1 ファイル上書き作成し、読み手スキルは承認チェックポイントでチャット解釈より先に本ファイルを読み、名指し対象だけ改訂してから削除する（回またぎ残存禁止）。詳細は docs/contract-2026-07-25-plan-comments-v0.md 参照。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["version", "pass", "submitted_at", "comments"],
+  "properties": {
+    "version": { "const": 0 },
+    "pass": {
+      "enum": ["structure", "scaffold", "final"],
+      "$comment": "structure = research-plan structure-confirm（対象 shot）/ scaffold = plan.json slot 向け承認（対象 slot）/ final = edit.json cut 向け承認（対象 cut）。契約 §4 の対応表。"
+    },
+    "submitted_at": {
+      "type": "string",
+      "format": "date-time",
+      "$comment": "提出時刻（ISO 8601）。"
+    },
+    "comments": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/comment" },
+      "$comment": "配列順に意味はない（対象名指しの集合）。空配列 = 提出したが個別指摘なし。"
+    }
+  },
+  "$defs": {
+    "nonEmptyString": { "type": "string", "minLength": 1, "pattern": "\\S" },
+    "comment": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["target_kind", "target_id", "title", "text"],
+      "properties": {
+        "target_kind": {
+          "enum": ["shot", "slot", "cut"],
+          "$comment": "shot = research-plan.json structure.shots[] / slot = plan.json slots[] / cut = edit.json cuts[] の対象種別。"
+        },
+        "target_id": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "shot / cut は対象配列のインデックスを文字列化したもの（例 \"2\"。cuts[] は永続 id を持たないため）。slot は plan.json の slots[].id をそのまま使う。"
+        },
+        "title": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "提出時点の対象名コピー（並べ替え検知用の目視補助。参照解決には使わない — 正典は target_id）。"
+        },
+        "text": {
+          "$ref": "#/$defs/nonEmptyString",
+          "$comment": "人間の指摘の逐語。要約・言い換えをしない。"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:akari-video:schema:plan:v0",
+  "title": "AKARI Video plan.json v0",
+  "description": "仮枠タイムライン（アニマティクス）の元データ。確定度つきスロット列 + 構造制約。編集判断レポート（contract-2026-07-13-m5）とタイムライン表示は本データの 2 つのレンダリング。packages/render-cut/src/plan.mjs（非永続の ffmpeg コマンド計画）とは別物。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["version"],
+  "properties": {
+    "version": { "const": 0 },
+    "slots": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/slot" },
+      "$comment": "タイムラインは slots を配列順にギャップなく連結して導出する（start は永続化しない。edit.json v1 の cuts[] 連結規則と同型）。"
+    },
+    "constraints": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/constraint" }
+    }
+  },
+  "$defs": {
+    "nonEmptyString": { "type": "string", "minLength": 1, "pattern": "\\S" },
+    "positiveSeconds": { "type": "number", "exclusiveMinimum": 0 },
+    "nullableNonEmptyString": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nonEmptyString" }]
+    },
+    "slot": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "id",
+        "label",
+        "script",
+        "target_duration_seconds",
+        "confidence",
+        "fill",
+        "media",
+        "provenance"
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "label": { "$ref": "#/$defs/nonEmptyString" },
+        "script": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "テレプロンプター台本 兼 TTS 仮ナレーション原稿。null = 台本なしのビート。"
+        },
+        "target_duration_seconds": { "$ref": "#/$defs/positiveSeconds" },
+        "confidence": {
+          "enum": ["proposed", "locked", "filled"],
+          "$comment": "proposed = AI 仮説（ゴースト表示）/ locked = 人間確定（未充填でも正当）/ filled = 実素材が入った状態。遷移規約は契約 §3。"
+        },
+        "fill": { "$ref": "#/$defs/fill" },
+        "media": { "$ref": "#/$defs/media" },
+        "provenance": { "$ref": "#/$defs/provenance" }
+      }
+    },
+    "fill": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["method"],
+      "properties": {
+        "method": {
+          "oneOf": [{ "type": "null" }, { "enum": ["generate", "record", "import"] }],
+          "$comment": "null = 充填手段未決。record の takes[] / device 等は v1+ 予約（テレプロンプターは slot.script を直接読む）。"
+        },
+        "prompt": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "method generate 用。生成前は AI の仮説、実行時に実際に使った prompt へ更新してよい。"
+        },
+        "asset_path": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "method import 用。copy-don't-link 後のプロジェクト相対パス（plan.json 所在ディレクトリ基準）。"
+        }
+      }
+    },
+    "media": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["image_path", "audio_path", "text_card"],
+      "properties": {
+        "image_path": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "静止画スタンドイン（仮枠）または確定素材の絵。plan.json 所在ディレクトリ基準。"
+        },
+        "audio_path": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "TTS 仮ナレーション音声。plan.json 所在ディレクトリ基準。"
+        },
+        "text_card": {
+          "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }],
+          "$comment": "写真を持たないタイポグラフィのみのビート用テキスト。"
+        }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["tool", "created_at", "note"],
+      "properties": {
+        "tool": { "$ref": "#/$defs/nullableNonEmptyString" },
+        "created_at": {
+          "oneOf": [{ "type": "null" }, { "type": "string", "format": "date-time" }]
+        },
+        "note": { "oneOf": [{ "type": "null" }, { "type": "string" }] }
+      }
+    },
+    "constraint": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "kind", "applies_to", "value", "note"],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "kind": {
+          "enum": ["duration_max", "duration_exact", "note"],
+          "$comment": "duration_max = ハード上限（超過はエラー）/ duration_exact = 目標尺（乖離は警告）/ note = 非構造の locked 指示（「ここに効果音」等）。"
+        },
+        "applies_to": {
+          "$ref": "#/$defs/nullableNonEmptyString",
+          "$comment": "slot id または null（null = プロジェクト全体。「尺 30 秒のケツ」は applies_to: null の duration_*）。"
+        },
+        "value": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/positiveSeconds" }],
+          "$comment": "duration_* では必須（秒）。note では null。"
+        },
+        "note": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }] }
+      }
+    }
+  }
+}