OBLITERATUS/docs/checkpoints/schemas/adapter-capability-v1.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://obliteratus.dev/schemas/adapter-capability-v1.schema.json",
  "title": "OBLITERATUS Checkpoint Adapter Capability v1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_id",
    "schema_version",
    "adapter_id",
    "adapter_version",
    "contract_version",
    "supported_producer_versions",
    "tested_producer_versions",
    "required_extras",
    "formats",
    "model_families",
    "state_scopes",
    "topology_capabilities",
    "quantization_capabilities",
    "safe_inspection",
    "trusted_inspection",
    "conversion",
    "evidence"
  ],
  "properties": {
    "schema_id": {"const": "obliteratus.adapter-capability"},
    "schema_version": {"const": "1.0.0"},
    "adapter_id": {"$ref": "#/$defs/id"},
    "adapter_version": {"$ref": "#/$defs/version"},
    "contract_version": {"const": "1.0.0"},
    "supported_producer_versions": {
      "type": "array",
      "minItems": 1,
      "items": {"$ref": "#/$defs/versionBand"}
    },
    "tested_producer_versions": {
      "type": "array",
      "items": {"$ref": "#/$defs/testedVersion"}
    },
    "required_extras": {
      "type": "array",
      "uniqueItems": true,
      "items": {"$ref": "#/$defs/id"}
    },
    "formats": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "enum": [
          "hf_safetensors",
          "pytorch_dcp",
          "fsdp_state_dict",
          "megatron_torch_dist",
          "megatron_torch_dcp",
          "megatron_fsdp_dtensor",
          "deepspeed_zero",
          "deepspeed_universal",
          "peft_safetensors"
        ]
      }
    },
    "model_families": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {"$ref": "#/$defs/id"}
    },
    "state_scopes": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {"$ref": "#/$defs/id"}
    },
    "topology_capabilities": {
      "type": "object",
      "additionalProperties": false,
      "required": ["axes", "saved_to_canonical", "saved_to_changed_topology"],
      "properties": {
        "axes": {
          "type": "array",
          "uniqueItems": true,
          "items": {"enum": ["nodes", "world", "tp", "pp", "dp", "cp", "ep", "etp", "fsdp", "zero"]}
        },
        "saved_to_canonical": {"type": "boolean"},
        "saved_to_changed_topology": {"type": "boolean"}
      }
    },
    "quantization_capabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["format", "status", "evidence_refs"],
        "properties": {
          "format": {"$ref": "#/$defs/id"},
          "status": {"enum": ["supported", "refused", "deferred"]},
          "evidence_refs": {"type": "array", "items": {"$ref": "#/$defs/id"}}
        }
      }
    },
    "safe_inspection": {"type": "boolean"},
    "trusted_inspection": {"type": "boolean"},
    "conversion": {"type": "boolean"},
    "evidence": {
      "type": "array",
      "items": {"$ref": "#/$defs/evidence"}
    }
  },
  "$defs": {
    "id": {"type": "string", "minLength": 1, "maxLength": 512},
    "version": {"type": "string", "minLength": 1, "maxLength": 128},
    "versionBand": {
      "type": "object",
      "additionalProperties": false,
      "required": ["producer", "specifier", "rationale"],
      "properties": {
        "producer": {"$ref": "#/$defs/id"},
        "specifier": {"$ref": "#/$defs/version"},
        "rationale": {"type": "string", "minLength": 1, "maxLength": 2048}
      }
    },
    "testedVersion": {
      "type": "object",
      "additionalProperties": false,
      "required": ["producer", "version", "fixture_digest", "candidate_commit", "environment", "topology"],
      "properties": {
        "producer": {"$ref": "#/$defs/id"},
        "version": {"$ref": "#/$defs/version"},
        "fixture_digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
        "candidate_commit": {"type": "string", "pattern": "^[0-9a-f]{40}$"},
        "environment": {"$ref": "#/$defs/id"},
        "topology": {"$ref": "#/$defs/id"}
      }
    },
    "evidence": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "reference", "status"],
      "properties": {
        "kind": {"enum": ["primary_documentation", "upstream_source", "fixture", "test_result", "review"]},
        "reference": {"$ref": "#/$defs/id"},
        "status": {"enum": ["required", "present", "expired", "missing"]}
      }
    }
  }
}