viql.upgo.ai

{
  "properties": {
    "checks": {
      "items": {
        "properties": {
          "basis": {
            "description": "The ledger evidence this check was decided on (cited presence or cited absence).",
            "items": {
              "properties": {
                "finding": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "code": {
            "description": "Stable machine code for this check's outcome.",
            "type": "string"
          },
          "dimension": {
            "description": "What was checked: asset, insurance, airport_permit, capacity, availability.",
            "type": "string"
          },
          "reason": {
            "description": "Human-readable reason.",
            "type": "string"
          },
          "status": {
            "enum": [
              "pass",
              "fail",
              "unknown",
              "not_evaluated"
            ],
            "type": "string"
          }
        },
        "required": [
          "dimension",
          "status",
          "code",
          "reason",
          "basis"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "eligible": {
      "description": "Never a bare boolean in practice — every verdict decomposes into checks[].",
      "type": "boolean"
    },
    "primitive": {
      "const": "viql.vehicle.eligibility",
      "type": "string"
    },
    "provenance": {
      "properties": {
        "ledger": {
          "type": "string"
        },
        "ledger_sha256": {
          "description": "Pins the exact compliance-ledger state that produced the verdict.",
          "type": "string"
        },
        "read_model": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "reasons": {
      "description": "Stable machine codes for every failed check, e.g. not_permitted_at_airport, insufficient_capacity, asset_unavailable, insurance_not_in_force, permit_expired.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "schema": {
      "const": "vehicle-eligibility/v1",
      "type": "string"
    },
    "trip": {
      "properties": {
        "airport": {
          "type": [
            "string",
            "null"
          ]
        },
        "passengers": {
          "type": "integer"
        },
        "same_day": {
          "type": "boolean"
        },
        "trip_date": {
          "format": "date",
          "type": "string"
        }
      },
      "type": "object"
    },
    "vehicle": {
      "properties": {
        "name": {
          "type": "string"
        },
        "operated_by": {
          "type": "string"
        },
        "seats": {
          "type": "integer"
        },
        "type": {
          "type": "string"
        },
        "vin": {
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "primitive",
    "schema",
    "eligible",
    "reasons",
    "vehicle",
    "trip",
    "checks",
    "provenance"
  ],
  "type": "object"
}