{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://huggingface.co/rootcastleengineering/sofia/raw/main/schemas/feature-vector.schema.json",
  "title": "SofiaFeatureVector",
  "description": "Schema for Sofia Engine ordered, named, unit-bearing feature vectors (Schema v3.0).",
  "type": "object",
  "properties": {
    "schema_version": {
      "type": "string",
      "enum": ["3.0"]
    },
    "extractor_id": {
      "type": "string"
    },
    "extractor_version": {
      "type": "string"
    },
    "source_channel": {
      "type": "string"
    },
    "sample_rate": {
      "type": "number",
      "minimum": 0
    },
    "quality": {
      "type": "string",
      "enum": ["GOOD", "DEGRADED", "UNCERTAIN", "INVALID", "STALE", "SATURATED"]
    },
    "names": {
      "type": "array",
      "items": { "type": "string" }
    },
    "values": {
      "type": "array",
      "items": { "type": "number" }
    },
    "uncertainties": {
      "type": "array",
      "items": { "type": "number", "minimum": 0 }
    },
    "features": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "value": { "type": "number" },
          "unit": { "type": "string" },
          "uncertainty": { "type": "number", "minimum": 0 },
          "quality": { "type": "string" },
          "algorithm": { "type": "string" },
          "algorithm_version": { "type": "string" }
        },
        "required": ["name", "value", "unit"]
      }
    },
    "metadata": {
      "type": "object"
    }
  },
  "required": ["schema_version", "extractor_id", "extractor_version", "names", "values"]
}