{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://docs.stella-ops.org/events/scanner.report.ready@1.json",
  "title": "Scanner Report Ready Event",
  "description": "Emitted when a scan report is generated and ready for download",
  "type": "object",
  "required": ["eventId", "kind", "version", "tenant", "ts", "payload"],
  "properties": {
    "eventId": {
      "type": "string",
      "format": "uuid",
      "description": "Unique event identifier"
    },
    "kind": {
      "const": "scanner.report.ready",
      "description": "Event kind"
    },
    "version": {
      "const": "1",
      "description": "Schema version"
    },
    "tenant": {
      "type": "string",
      "description": "Tenant identifier"
    },
    "ts": {
      "type": "string",
      "format": "date-time",
      "description": "Event timestamp in ISO 8601 format"
    },
    "actor": {
      "type": "string",
      "description": "Service or user that triggered the event"
    },
    "payload": {
      "type": "object",
      "required": ["reportId", "scanId", "imageDigest", "imageName"],
      "properties": {
        "reportId": {
          "type": "string",
          "description": "Unique report identifier"
        },
        "scanId": {
          "type": "string",
          "description": "Related scan identifier"
        },
        "imageDigest": {
          "type": "string",
          "description": "Image digest (sha256)"
        },
        "imageName": {
          "type": "string",
          "description": "Full image name with tag"
        },
        "format": {
          "type": "string",
          "enum": ["cyclonedx", "spdx", "sarif"],
          "description": "Report format"
        },
        "size": {
          "type": "integer",
          "description": "Report size in bytes"
        },
        "links": {
          "type": "object",
          "properties": {
            "report": { "type": "string", "format": "uri" },
            "download": { "type": "string", "format": "uri" }
          }
        }
      }
    },
    "attributes": {
      "type": "object",
      "additionalProperties": { "type": "string" }
    }
  }
}