{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://getzero.dev/contracts/zero.public_decision_artifacts.v1.schema.json",
  "title": "ZERO Public Recurring Decision Artifacts",
  "type": "object",
  "required": [
    "schema_version",
    "kind",
    "status",
    "generated_at",
    "canonical_url",
    "public",
    "artifact_horizon",
    "coverage",
    "shelves",
    "links",
    "privacy_boundary",
    "score_gate",
    "blockers"
  ],
  "properties": {
    "schema_version": { "const": "zero.public_decision_artifacts.v1" },
    "kind": { "const": "public_recurring_decision_artifacts" },
    "status": { "enum": ["decision_artifacts_ready", "decision_artifacts_degraded"] },
    "generated_at": { "type": "string", "format": "date-time" },
    "canonical_url": { "const": "https://getzero.dev/api/replays/decision-artifacts" },
    "public": { "const": true },
    "artifact_horizon": {
      "type": "object",
      "required": ["scanned_replays", "retained_artifacts", "min_required_artifacts", "min_required_shelves"],
      "properties": {
        "scanned_replays": { "type": "integer", "minimum": 0 },
        "retained_artifacts": { "type": "integer", "minimum": 0 },
        "min_required_artifacts": { "type": "integer", "minimum": 1 },
        "min_required_shelves": { "type": "integer", "minimum": 1 }
      },
      "additionalProperties": false
    },
    "coverage": {
      "type": "object",
      "required": [
        "replay_count",
        "shelf_count",
        "ready_shelf_count",
        "receipt_card_count",
        "graph_context_count",
        "outcome_family_count",
        "refusal_shelf_ready",
        "followthrough_shelf_ready",
        "same_policy_shelf_ready",
        "public_surface_count"
      ],
      "properties": {
        "replay_count": { "type": "integer", "minimum": 0 },
        "shelf_count": { "type": "integer", "minimum": 0 },
        "ready_shelf_count": { "type": "integer", "minimum": 0 },
        "receipt_card_count": { "type": "integer", "minimum": 0 },
        "graph_context_count": { "type": "integer", "minimum": 0 },
        "outcome_family_count": { "type": "integer", "minimum": 0 },
        "refusal_shelf_ready": { "type": "boolean" },
        "followthrough_shelf_ready": { "type": "boolean" },
        "same_policy_shelf_ready": { "type": "boolean" },
        "public_surface_count": { "type": "integer", "minimum": 0 }
      },
      "additionalProperties": false
    },
    "shelves": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "shelf_id",
          "label",
          "family_type",
          "status",
          "artifact_count",
          "cadence",
          "replay_ids",
          "receipt_card_urls",
          "graph_context_urls",
          "replay_index_url",
          "public_surface_urls",
          "summary"
        ],
        "properties": {
          "shelf_id": { "type": "string", "minLength": 1 },
          "label": { "type": "string", "minLength": 1 },
          "family_type": { "enum": ["refusal_cluster", "followthrough", "same_policy", "recent_decisions"] },
          "status": { "enum": ["ready", "degraded"] },
          "artifact_count": { "type": "integer", "minimum": 0 },
          "cadence": {
            "type": "object",
            "required": ["period", "newest_at", "oldest_at", "recurring"],
            "properties": {
              "period": { "const": "rolling_public_window" },
              "newest_at": { "type": ["string", "null"], "format": "date-time" },
              "oldest_at": { "type": ["string", "null"], "format": "date-time" },
              "recurring": { "type": "boolean" }
            },
            "additionalProperties": false
          },
          "replay_ids": { "type": "array", "items": { "type": "string", "minLength": 1 } },
          "receipt_card_urls": { "type": "array", "items": { "type": "string", "format": "uri" } },
          "graph_context_urls": { "type": "array", "items": { "type": "string", "format": "uri" } },
          "replay_index_url": { "type": "string", "format": "uri" },
          "public_surface_urls": { "type": "array", "items": { "type": "string", "format": "uri" } },
          "summary": { "type": "string", "minLength": 1 }
        },
        "additionalProperties": false
      }
    },
    "links": {
      "type": "object",
      "required": ["replay_index", "entrypoints", "decision_graph", "receipt_card_example", "export", "schema"],
      "properties": {
        "replay_index": { "type": "string", "format": "uri" },
        "entrypoints": { "type": "string", "format": "uri" },
        "decision_graph": { "type": "string", "format": "uri" },
        "receipt_card_example": { "type": "string", "format": "uri" },
        "export": { "type": "string", "format": "uri" },
        "schema": { "const": "https://getzero.dev/contracts/zero.public_decision_artifacts.v1.schema.json" }
      },
      "additionalProperties": false
    },
    "privacy_boundary": {
      "type": "object",
      "required": [
        "public_only",
        "private_trace_payloads_public",
        "private_keys_public",
        "operator_ids_public",
        "prompt_bodies_public",
        "tool_payloads_public",
        "performance_metrics_public"
      ],
      "properties": {
        "public_only": { "const": true },
        "private_trace_payloads_public": { "const": false },
        "private_keys_public": { "const": false },
        "operator_ids_public": { "const": false },
        "prompt_bodies_public": { "const": false },
        "tool_payloads_public": { "const": false },
        "performance_metrics_public": { "const": false }
      },
      "additionalProperties": false
    },
    "score_gate": {
      "type": "object",
      "required": ["can_promote_public_score", "reason", "previous_blocker", "next_blocker"],
      "properties": {
        "can_promote_public_score": { "type": "boolean" },
        "reason": { "type": "string", "minLength": 1 },
        "previous_blocker": { "const": "recurring_public_decision_artifacts_missing" },
        "next_blocker": { "const": "public_decision_artifact_cadence_missing" }
      },
      "additionalProperties": false
    },
    "blockers": { "type": "array", "items": { "type": "string", "minLength": 1 } }
  },
  "additionalProperties": false
}