{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://cainstudio.online/spec/sovereign/decision/1.0.0",
  "title": "CAIN Sovereign decision and execution permit v1",
  "description": "What CAIN returns. Extends trust-decision 1.0.0 (platform-gateway/spec/trust-decision.schema.json): verdict->decision, denied_by/reason->reason_codes, evidence->evidence_refs. Rules: (1) decision is ALLOW only if every mandatory predicate passed; any UNKNOWN, timeout, exception, missing input or unreachable dependency yields INDETERMINATE or DENY, never ALLOW. (2) solver.status SAT never implies ALLOW: an invariant holds when its counterexample query is UNSAT. (3) A permit is valid only for the exact action_digest, tenant, agent, audience and policy_version it names; changing any protected parameter requires a new decision. (4) A permit is single-use: its first atomic consumption makes it CONSUMED; later uses are refused. (5) Policy change, credential revocation or expiry before consumption makes the permit EXPIRED/REVOKED. (6) Conflicting terminal outcomes for one request_id are refused and recorded. STATUS: ARCHITECTURALLY_SPECIFIED; the live paths emit their own formats (MCPToolCallEvaluation, hosted pipeline records) and map onto this in Evolution 2.",
  "type": "object",
  "additionalProperties": false,
  "required": ["protocol_version", "decision_id", "request_id", "decision", "reason_codes", "binding", "decided_at", "decider"],
  "properties": {
    "protocol_version": {"const": "cain.sovereign.decision/1"},
    "decision_id": {"type": "string", "minLength": 16},
    "request_id": {"type": "string", "minLength": 16},
    "decision": {"enum": ["ALLOW", "DENY", "PENDING", "EXPIRED", "REVOKED", "CANCELLED", "INDETERMINATE"]},
    "reason_codes": {"type": "array", "minItems": 1, "items": {"type": "string"}},
    "binding": {
      "type": "object", "additionalProperties": false,
      "required": ["action_digest", "tenant_id", "agent_id", "audience", "policy_version", "request_epoch"],
      "properties": {
        "action_digest": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
        "tenant_id": {"type": "string"}, "agent_id": {"type": "string"}, "audience": {"type": "string"},
        "policy_version": {"type": "string"}, "request_epoch": {"type": "integer"},
        "capability_scope": {"type": "array", "items": {"type": "string"}}
      }
    },
    "approval": {
      "type": "object", "required": ["required", "state"],
      "properties": {
        "required": {"type": "boolean"},
        "state": {"enum": ["NOT_REQUIRED", "PENDING", "APPROVED", "REJECTED", "EXPIRED"]},
        "approver_ref": {"type": "string"},
        "verified_by": {"type": "string", "description": "The approval service that verified it; must be a configured trust anchor."}
      }
    },
    "solver": {
      "type": "object", "required": ["status"],
      "properties": {
        "engine": {"type": "string"}, "engine_version": {"type": "string"}, "model_version": {"type": "string"},
        "status": {"enum": ["PROVED", "REFUTED", "UNKNOWN", "TIMEOUT", "ERROR", "NOT_REQUIRED"]},
        "formula_digest": {"type": "string"},
        "assumptions": {"type": "array", "items": {"type": "string"}}
      }
    },
    "permit": {
      "type": "object", "additionalProperties": false,
      "required": ["permit_id", "nonce", "expires_at", "single_use", "state", "signature", "signer_pub"],
      "properties": {
        "permit_id": {"type": "string"}, "nonce": {"type": "string", "minLength": 16},
        "expires_at": {"type": "number"}, "single_use": {"const": true},
        "state": {"enum": ["ISSUED", "CONSUMED", "EXPIRED", "REVOKED", "CANCELLED"]},
        "signature": {"type": "string"}, "signer_pub": {"type": "string"}
      }
    },
    "evidence_refs": {"type": "array", "items": {"type": "string"}},
    "decided_at": {"type": "number"},
    "decider": {"type": "string", "description": "Identity of the deciding component; never the requesting agent."}
  },
  "allOf": [
    {"if": {"properties": {"decision": {"const": "ALLOW"}}},
     "then": {"required": ["permit"],
              "properties": {"solver": {"properties": {"status": {"enum": ["PROVED", "NOT_REQUIRED"]}}},
                             "approval": {"properties": {"state": {"enum": ["NOT_REQUIRED", "APPROVED"]}}}}}},
    {"if": {"properties": {"decision": {"not": {"const": "ALLOW"}}}},
     "then": {"not": {"required": ["permit"]}}}
  ]
}
