schemas/model.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://huggingface.co/rootcastleengineering/sofia/raw/main/schemas/model.schema.json",
  "title": "SofiaModelManifest",
  "description": "Schema for Sofia Engine model artifacts, checkpoints, and parameter archives.",
  "type": "object",
  "properties": {
    "schema": {
      "type": "string",
      "enum": ["sofia.model-manifest.v1"]
    },
    "name": {
      "type": "string"
    },
    "publisher": {
      "type": "string"
    },
    "license": {
      "type": "string"
    },
    "source_repository": {
      "type": "string",
      "format": "uri"
    },
    "artifact_type": {
      "type": "string",
      "enum": ["scientific-edge-runtime", "neural-checkpoint", "linear-model"]
    },
    "version": {
      "type": "string"
    },
    "checkpoint": {
      "type": ["string", "null"]
    },
    "feature_schema": {
      "type": ["string", "null"]
    },
    "parameters_sha256": {
      "type": ["string", "null"],
      "pattern": "^[a-fA-F0-9]{64}$"
    },
    "training": {
      "type": "object",
      "properties": {
        "trained": { "type": "boolean" },
        "dataset": { "type": ["string", "null"] },
        "metrics": { "type": ["object", "null"] },
        "note": { "type": "string" }
      },
      "required": ["trained"]
    },
    "provenance": {
      "type": "object",
      "properties": {
        "git_commit": { "type": ["string", "null"] },
        "release": { "type": ["string", "null"] },
        "timestamp_utc": { "type": ["string", "null"] }
      }
    }
  },
  "required": ["schema", "name", "publisher", "license", "source_repository", "artifact_type", "version", "training"]
}