fluid-core/schemas/event.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://fluid.dev/schemas/event.schema.json",
  "title": "FLUID audit event",
  "description": "Append-only record of a material lifecycle transition. FLUID evolution is itself a system behavior that must remain reconstructable (FluidHypothesisRevisionSchema.md section 15).",
  "type": "object",
  "properties": {
    "fluid_event": {
      "type": "object",
      "properties": {
        "schema_version": {
          "$ref": "common.schema.json#/$defs/schemaVersion"
        },
        "id": {
          "$ref": "common.schema.json#/$defs/eventId"
        },
        "occurred_at": {
          "$ref": "common.schema.json#/$defs/timestamp"
        },
        "entity_type": {
          "enum": [
            "pressure",
            "hypothesis",
            "revision",
            "experiment",
            "feedback",
            "backend_requirement",
            "intent",
            "decision",
            "routing_policy"
          ]
        },
        "entity_id": {
          "type": "string",
          "minLength": 1
        },
        "event_type": {
          "type": "string",
          "minLength": 1
        },
        "actor": {
          "$ref": "common.schema.json#/$defs/actor"
        },
        "inputs": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Identifiers of the records this transition drew on."
        },
        "reason": {
          "type": "string"
        },
        "evidence_refs": {
          "type": "array",
          "items": {
            "$ref": "common.schema.json#/$defs/evidenceRef"
          }
        }
      },
      "required": [
        "schema_version",
        "id",
        "occurred_at",
        "entity_type",
        "entity_id",
        "event_type",
        "actor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "fluid_event"
  ],
  "additionalProperties": false
}