{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://local-frontier.dev/schemas/model-profile.schema.json",
  "title": "Local Frontier Model Profile",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "version",
    "schema_version",
    "status",
    "repo",
    "title",
    "model_family",
    "architecture",
    "serving",
    "evidence",
    "notes"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:[-][a-z0-9]+)*(?:--[a-z0-9]+(?:[-][a-z0-9]+)*)?$"
    },
    "version": {
      "type": "string",
      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
    },
    "schema_version": {
      "const": "1.0.0"
    },
    "status": {
      "enum": [
        "draft",
        "audited",
        "deprecated",
        "unsupported",
        "metadata_estimate"
      ]
    },
    "repo": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*/[A-Za-z0-9][A-Za-z0-9._-]*$"
    },
    "title": {
      "type": "string",
      "minLength": 1
    },
    "summary": {
      "type": "string"
    },
    "model_family": {
      "type": "string",
      "minLength": 1
    },
    "base_model_proof": {
      "type": "object",
      "additionalProperties": false,
      "required": ["base_model", "relation", "source", "config_compatible"],
      "properties": {
        "base_model": {
          "type": "string"
        },
        "relation": {
          "enum": ["base", "finetune", "quantized", "derived_package"]
        },
        "source": {
          "type": "string"
        },
        "config_compatible": {
          "type": "boolean"
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "architecture": {
      "type": "object",
      "additionalProperties": false,
      "required": ["max_context_tokens", "weight_adapter", "kv_adapter"],
      "properties": {
        "canonical_architecture_id": {
          "type": "string"
        },
        "max_context_tokens": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "weight_adapter": {
          "$ref": "#/$defs/weight_adapter"
        },
        "kv_adapter": {
          "$ref": "#/$defs/kv_adapter"
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "serving": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "weight_format",
        "weight_bytes_per_param",
        "kv_store_format",
        "kv_store_bytes_per_scalar",
        "kv_read_format",
        "kv_read_bytes_per_scalar"
      ],
      "properties": {
        "weight_format": {
          "enum": [
            "bf16",
            "fp16",
            "fp32",
            "fp8",
            "fp4_fp8_mixed",
            "nvfp4",
            "mxfp4",
            "mixed_bf16_f32",
            "mixed_bf16_f16_f32",
            "int8",
            "int4",
            "q4",
            "q2_mixed",
            "gguf_quantized",
            "mlx_quantized",
            "unknown"
          ]
        },
        "weight_bytes_per_param": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "kv_store_format": {
          "type": "string",
          "minLength": 1
        },
        "kv_store_bytes_per_scalar": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "kv_read_format": {
          "type": "string",
          "minLength": 1
        },
        "kv_read_bytes_per_scalar": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "runtime_format": {
          "type": "string"
        },
        "dequantization_notes": {
          "type": "string"
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "evidence": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["label", "url", "source_type", "supports"],
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1
          },
          "url": {
            "type": "string",
            "pattern": "^https://"
          },
          "source_type": {
            "enum": [
              "model_card",
              "config",
              "paper",
              "vendor_doc",
              "release_notes",
              "benchmark_report",
              "manual_review",
              "derived_calculation"
            ]
          },
          "supports": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "notes": {
            "type": "string"
          }
        }
      }
    },
    "review": {
      "type": "object",
      "additionalProperties": false,
      "required": ["reviewed_by", "reviewed_at", "notes"],
      "properties": {
        "reviewed_by": {
          "type": "string",
          "minLength": 1
        },
        "reviewed_at": {
          "type": "string",
          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "unsupported_reason": {
      "type": "string"
    },
    "estimate_warning": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "allOf": [
    {
      "if": {
        "properties": {
          "status": {
            "const": "audited"
          }
        }
      },
      "then": {
        "required": ["review"]
      }
    },
    {
      "if": {
        "properties": {
          "status": {
            "const": "unsupported"
          }
        }
      },
      "then": {
        "required": ["unsupported_reason"]
      }
    },
    {
      "if": {
        "properties": {
          "status": {
            "const": "metadata_estimate"
          }
        }
      },
      "then": {
        "required": ["estimate_warning"]
      }
    }
  ],
  "$defs": {
    "weight_adapter": {
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "total_params_b", "parameter_scope"],
          "properties": {
            "kind": {
              "const": "dense"
            },
            "total_params_b": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "parameter_scope": {
              "type": "string",
              "minLength": 1
            },
            "embedding_params_b": {
              "type": "number",
              "minimum": 0
            },
            "non_embedding_params_b": {
              "type": "number",
              "minimum": 0
            },
            "notes": {
              "type": "string"
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "resident_params_b",
            "swept_params_b",
            "resident_parameter_scope",
            "swept_parameter_scope"
          ],
          "properties": {
            "kind": {
              "const": "dense_resident_swept"
            },
            "resident_params_b": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "swept_params_b": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "auxiliary_resident_params_b": {
              "type": "number",
              "minimum": 0
            },
            "resident_weight_gb": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "swept_weight_gb": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "auxiliary_resident_weight_gb": {
              "type": "number",
              "minimum": 0
            },
            "resident_parameter_scope": {
              "type": "string",
              "minLength": 1
            },
            "swept_parameter_scope": {
              "type": "string",
              "minLength": 1
            },
            "auxiliary_scope": {
              "type": "string"
            },
            "notes": {
              "type": "string"
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "resident_weight_gb",
            "fixed_weight_gb",
            "routed_expert_weight_gb",
            "routed_experts",
            "routed_experts_per_token",
            "routing_model",
            "resident_parameter_scope",
            "traffic_scope"
          ],
          "properties": {
            "kind": {
              "const": "moe_distinct_experts_exact"
            },
            "resident_weight_gb": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "main_resident_weight_gb": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "auxiliary_resident_weight_gb": {
              "type": "number",
              "minimum": 0
            },
            "fixed_weight_gb": {
              "type": "number",
              "minimum": 0
            },
            "routed_expert_weight_gb": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "routed_experts": {
              "type": "integer",
              "minimum": 1
            },
            "routed_experts_per_token": {
              "type": "integer",
              "minimum": 1
            },
            "shared_experts_per_token": {
              "type": "number",
              "minimum": 0
            },
            "routing_model": {
              "const": "uniform_expected_distinct"
            },
            "resident_parameter_scope": {
              "type": "string",
              "minLength": 1
            },
            "traffic_scope": {
              "type": "string",
              "minLength": 1
            },
            "auxiliary_scope": {
              "type": "string"
            },
            "shared_expert_notes": {
              "type": "string"
            },
            "notes": {
              "type": "string"
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "total_params_b",
            "active_params_b",
            "parameter_scope",
            "routed_experts",
            "routed_experts_per_token",
            "routing_model"
          ],
          "properties": {
            "kind": {
              "const": "moe_distinct_experts"
            },
            "total_params_b": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "active_params_b": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "parameter_scope": {
              "type": "string",
              "minLength": 1
            },
            "routed_experts": {
              "type": "integer",
              "minimum": 1
            },
            "routed_experts_per_token": {
              "type": "integer",
              "minimum": 1
            },
            "shared_experts_per_token": {
              "type": "number",
              "minimum": 0
            },
            "routing_model": {
              "const": "uniform_expected_distinct"
            },
            "expert_param_b": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "fixed_param_b": {
              "type": "number",
              "minimum": 0
            },
            "shared_expert_notes": {
              "type": "string"
            },
            "nonuniform_expert_notes": {
              "type": "string"
            },
            "notes": {
              "type": "string"
            }
          }
        }
      ]
    },
    "kv_adapter": {
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "reason"],
          "properties": {
            "kind": {
              "const": "unknown"
            },
            "reason": {
              "type": "string",
              "minLength": 1
            },
            "notes": {
              "type": "string"
            }
          }
        },
        {
          "$ref": "#/$defs/full_context_kv"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "components"],
          "properties": {
            "kind": {
              "const": "layered_kv"
            },
            "components": {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/$defs/kv_component"
              }
            },
            "notes": {
              "type": "string"
            }
          }
        },
        {
          "$ref": "#/$defs/recurrent_state_kv"
        },
        {
          "$ref": "#/$defs/compressed_state_kv"
        }
      ]
    },
    "kv_component": {
      "oneOf": [
        {
          "$ref": "#/$defs/full_context_kv"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "layers",
            "kv_heads",
            "head_dim",
            "window_tokens"
          ],
          "properties": {
            "kind": {
              "const": "sliding_window"
            },
            "layers": {
              "type": "integer",
              "minimum": 1
            },
            "alloc_layers": {
              "type": "integer",
              "minimum": 0
            },
            "read_layers": {
              "type": "integer",
              "minimum": 0
            },
            "kv_heads": {
              "type": "integer",
              "minimum": 1
            },
            "head_dim": {
              "type": "integer",
              "minimum": 1
            },
            "window_tokens": {
              "type": "integer",
              "minimum": 1
            },
            "kv_scalar_multiplier": {
              "type": "number",
              "exclusiveMinimum": 0
            },
            "notes": {
              "type": "string"
            }
          }
        },
        {
          "$ref": "#/$defs/recurrent_state_kv"
        },
        {
          "$ref": "#/$defs/compressed_state_kv"
        }
      ]
    },
    "full_context_kv": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "layers", "kv_heads", "head_dim"],
      "properties": {
        "kind": {
          "const": "full_context"
        },
        "layers": {
          "type": "integer",
          "minimum": 1
        },
        "alloc_layers": {
          "type": "integer",
          "minimum": 0
        },
        "read_layers": {
          "type": "integer",
          "minimum": 0
        },
        "kv_heads": {
          "type": "integer",
          "minimum": 1
        },
        "head_dim": {
          "type": "integer",
          "minimum": 1
        },
        "kv_scalar_multiplier": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "recurrent_state_kv": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "alloc_gb_per_session",
        "read_gb_per_output_token",
        "state_formula"
      ],
      "properties": {
        "kind": {
          "const": "recurrent_state"
        },
        "alloc_gb_per_session": {
          "type": "number",
          "minimum": 0
        },
        "read_gb_per_output_token": {
          "type": "number",
          "minimum": 0
        },
        "state_formula": {
          "type": "string",
          "minLength": 1
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "compressed_state_kv": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "alloc_formula", "read_formula"],
      "properties": {
        "kind": {
          "const": "compressed_state"
        },
        "alloc_formula": {
          "$ref": "#/$defs/linear_context_ratio"
        },
        "read_formula": {
          "$ref": "#/$defs/linear_context_ratio"
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "linear_context_ratio": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "gb_per_1k_context_tokens"],
      "properties": {
        "kind": {
          "const": "linear_context_ratio"
        },
        "gb_per_1k_context_tokens": {
          "type": "number",
          "minimum": 0
        },
        "notes": {
          "type": "string"
        }
      }
    }
  }
}