{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://majesticcore.dev/schemas/incompatibility.schema.json",
  "title": "Incompatibility",
  "description": "Structured incompatibility payload when media cannot be direct-played",
  "type": "object",
  "required": ["type", "code", "detail"],
  "properties": {
    "type": {
      "type": "string",
      "enum": ["audio", "video", "container", "subtitle", "unknown"],
      "description": "Discriminant for incompatibility category"
    },
    "code": {
      "type": "string",
      "description": "Machine-readable error code"
    },
    "detail": {
      "type": "string",
      "description": "Human-readable description"
    },
    "hint": {
      "type": "string",
      "description": "Optional actionable guidance for the user"
    }
  },
  "additionalProperties": false
}