benchmarks/benchmark-schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://huggingface.co/rootcastleengineering/sofia/raw/main/benchmarks/benchmark-schema.json",
  "title": "SofiaBenchmarkReport",
  "description": "Schema for Sofia Engine empirical benchmark execution reports.",
  "type": "object",
  "properties": {
    "timestamp_utc": { "type": "string", "format": "date-time" },
    "environment": {
      "type": "object",
      "properties": {
        "os": { "type": "string" },
        "machine": { "type": "string" },
        "processor": { "type": "string" },
        "python_version": { "type": "string" }
      },
      "required": ["os", "python_version"]
    },
    "benchmarks": {
      "type": "object",
      "properties": {
        "import_time_ms": { "type": "number" },
        "fft_psd_1024": { "$ref": "#/$defs/stat_record" },
        "fft_psd_4096": { "$ref": "#/$defs/stat_record" },
        "analytic_envelope_2048": { "$ref": "#/$defs/stat_record" },
        "feature_extraction_1024": { "$ref": "#/$defs/stat_record" },
        "electrical_symmetrical_components": { "$ref": "#/$defs/stat_record" }
      },
      "required": ["import_time_ms"]
    },
    "memory": {
      "type": "object",
      "properties": {
        "current_traced_kb": { "type": "number" },
        "peak_traced_kb": { "type": "number" }
      }
    }
  },
  "required": ["timestamp_utc", "environment", "benchmarks"],
  "$defs": {
    "stat_record": {
      "type": "object",
      "properties": {
        "n_iterations": { "type": "integer" },
        "mean_us": { "type": "number" },
        "p50_us": { "type": "number" },
        "p95_us": { "type": "number" },
        "p99_us": { "type": "number" },
        "min_us": { "type": "number" },
        "max_us": { "type": "number" }
      },
      "required": ["n_iterations", "mean_us", "p50_us"]
    }
  }
}