{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://cognitive-agent.local/schemas/execution-report.schema.json",
  "title": "ExecutionReport",
  "type": "object",
  "additionalProperties": false,
  "required": ["apiVersion", "kind", "metadata", "spec"],
  "properties": {
    "apiVersion": {"const": "cognitive-agent/v1alpha1"},
    "kind": {"const": "ExecutionReport"},
    "metadata": {"$ref": "common.schema.json#/$defs/metadata"},
    "spec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["mode", "status", "started_at", "finished_at", "results"],
      "properties": {
        "mode": {"type": "string", "enum": ["dry_run", "hil", "vehicle"]},
        "status": {"type": "string", "enum": ["succeeded", "partially_succeeded", "failed", "cancelled"]},
        "started_at": {"type": "string", "format": "date-time"},
        "finished_at": {"type": "string", "format": "date-time"},
        "physical_state": {
          "type": "object",
          "description": "Authoritative physical device state captured from hardware feedback."
        },
        "results": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["ref", "domain", "status"],
            "properties": {
              "ref": {"type": "string", "minLength": 1},
              "domain": {"type": "string", "pattern": "^[a-z][a-z0-9_]*$"},
              "status": {"type": "string", "enum": ["succeeded", "failed", "skipped", "compensated"]},
              "message": {"type": "string", "maxLength": 1000},
              "telemetry": {"type": "object"}
            }
          }
        }
      }
    }
  }
}