{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "openmontage/artifacts/source_media_review",
  "title": "Source Media Review",
  "description": "Structured review of user-supplied media files. Created before the first planning stage when user media exists. Ensures the agent inspects actual media content instead of planning around assumptions.",
  "type": "object",
  "required": ["version", "files", "summary", "planning_implications"],
  "properties": {
    "version": { "type": "string", "const": "1.0" },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["path", "media_type", "reviewed"],
        "properties": {
          "path": { "type": "string" },
          "media_type": {
            "type": "string",
            "enum": ["video", "audio", "image"]
          },
          "reviewed": {
            "type": "boolean",
            "const": true,
            "description": "Must be true — the file was actually inspected, not assumed"
          },
          "technical_probe": {
            "type": "object",
            "description": "Raw ffprobe or metadata output for this file",
            "properties": {
              "duration_seconds": { "type": "number" },
              "resolution": { "type": "string" },
              "fps": { "type": "number" },
              "codec": { "type": "string" },
              "audio_codec": { "type": "string" },
              "sample_rate": { "type": "integer" },
              "channels": { "type": "integer" },
              "file_size_bytes": { "type": "integer" },
              "bitrate_kbps": { "type": "number" }
            }
          },
          "content_summary": {
            "type": "string",
            "description": "What the file actually contains — described from observation, not assumption"
          },
          "transcript_summary": {
            "type": "string",
            "description": "Summary of spoken content, if audio/video with speech"
          },
          "representative_frames": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Paths to sampled frames (video/image only)"
          },
          "quality_risks": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Quality issues that affect planning (low resolution, poor audio, shaky footage, etc.)"
          },
          "usable_for": {
            "type": "array",
            "items": { "type": "string" },
            "description": "What this file can be used for in the production (hero footage, b-roll, background audio, etc.)"
          }
        },
        "additionalProperties": false
      },
      "minItems": 1
    },
    "summary": {
      "type": "string",
      "description": "What the supplied media actually contains and what it does not. Be specific — 'contains 45s of interview footage, no b-roll, mono audio at 44.1kHz' not 'user provided footage'"
    },
    "planning_implications": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Concrete constraints or opportunities that must affect proposal/script/scene planning. Each item should be actionable.",
      "minItems": 1
    },
    "metadata": { "type": "object" }
  },
  "additionalProperties": false
}
