{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "XIC Telemetry Event",
  "description": "Telemetry event from XIC symbolic pipeline execution, compatible with FedMart ingestion",
  "type": "object",
  "properties": {
    "event_type": {
      "type": "string",
      "description": "Type of telemetry event (e.g., 'symbolic_pipeline_run', 'guardrail_triggered')",
      "enum": ["symbolic_pipeline_run", "guardrail_triggered", "control_flow_decision", "resonance_update"]
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of event"
    },
    "run_id": {
      "type": "string",
      "description": "Unique identifier for this pipeline execution"
    },
    "program": {
      "type": "string",
      "description": "XIC program name or path"
    },
    "chain_label": {
      "type": ["string", "null"],
      "description": "Current CHAIN label if in a named chain"
    },
    "glyph_ids": {
      "type": "array",
      "items": {"type": "string"},
      "description": "List of glyph IDs in this resonance computation"
    },
    "glyph_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of glyphs processed"
    },
    "global_resonance_score": {
      "type": "number",
      "minimum": 0.0,
      "maximum": 1.0,
      "description": "Overall resonance score [0.0, 1.0]"
    },
    "steps_executed": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of SymbolicStep entries in pipeline execution"
    },
    "guardrails_triggered": {
      "type": "array",
      "items": {"type": "string"},
      "description": "List of guardrail messages triggered during execution"
    },
    "resonance_map_summary": {
      "type": "object",
      "description": "Summary of resonance metrics",
      "properties": {
        "top_glyphs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "glyph_id": {"type": "string"},
              "weight": {"type": "number", "minimum": 0.0, "maximum": 1.0}
            },
            "required": ["glyph_id", "weight"]
          },
          "description": "Top 5 glyphs by weight"
        },
        "average_resonance": {
          "type": "number",
          "minimum": 0.0,
          "maximum": 1.0,
          "description": "Average resonance across all glyphs"
        }
      }
    },
    "raw_payload": {
      "type": "object",
      "description": "Full execution result for detailed analysis"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true,
      "description": "Optional additional metadata"
    }
  },
  "required": [
    "event_type",
    "timestamp",
    "run_id",
    "glyph_count",
    "global_resonance_score",
    "steps_executed",
    "guardrails_triggered"
  ]
}