{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://stellaops.dev/schemas/excititor/vex_raw.schema.json",
  "title": "Excititor VEX Raw Document",
  "$comment": "Note (2025-12): The gridFsObjectId field is legacy. Since Sprint 4400, all large content is stored in PostgreSQL with RustFS. This field exists only for backward compatibility with migrated data.",
  "type": "object",
  "additionalProperties": true,
  "required": ["_id", "providerId", "format", "sourceUri", "retrievedAt", "digest"],
  "properties": {
    "_id": {
      "type": "string",
      "description": "Content-addressed digest; equals `digest`."
    },
    "providerId": { "type": "string", "minLength": 1 },
    "format": { "type": "string", "enum": ["csaf", "cyclonedx", "openvex"] },
    "sourceUri": { "type": "string", "minLength": 1 },
    "retrievedAt": { "type": "string", "format": "date-time" },
    "digest": { "type": "string", "minLength": 32 },
    "content": {
      "oneOf": [
        { "type": "string", "contentEncoding": "base64" },
        { "type": "string" }
      ],
      "description": "Inline payload if below size threshold; may be empty when stored in RustFS (legacy: GridFS prior to Sprint 4400)."
    },
    "gridFsObjectId": {
      "anyOf": [
        { "type": "string" },
        { "type": "null" }
      ]
    },
    "metadata": {
      "type": "object",
      "additionalProperties": { "type": "string" }
    }
  }
}