{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://platoskallipolis.com/schemas/revalidation-client-discovery-state.v1.json",
  "title": "Plato's Kallipolis revalidation client discovery state contract",
  "type": "object",
  "additionalProperties": false,
  "required": ["schema", "state", "snapshotAt", "integrityManifest", "clients", "counts", "transitionPolicy", "boundaries", "privacy"],
  "properties": {
    "schema": { "const": "kallipolis.revalidation-client-discovery-state.v1" },
    "state": { "const": "verified-local-discovery-state-contract" },
    "snapshotAt": { "type": "string", "format": "date-time" },
    "integrityManifest": { "$ref": "#/$defs/integrityManifest" },
    "clients": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/client" } },
    "counts": { "$ref": "#/$defs/counts" },
    "transitionPolicy": { "$ref": "#/$defs/transitionPolicy" },
    "boundaries": { "$ref": "#/$defs/boundaries" },
    "privacy": { "$ref": "#/$defs/privacy" }
  },
  "$defs": {
    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
    "integrityManifest": {
      "type": "object",
      "additionalProperties": false,
      "required": ["path", "rawHash", "clientSetHash", "clients"],
      "properties": {
        "path": { "const": "ops/evidence/revalidation-client-integrity-manifest-2026-08-29.json" },
        "rawHash": { "$ref": "#/$defs/digest" },
        "clientSetHash": { "$ref": "#/$defs/digest" },
        "clients": { "type": "integer", "minimum": 1 }
      }
    },
    "verificationEvidence": {
      "type": "object",
      "additionalProperties": false,
      "required": ["publicDeploymentProof", "externalReadOnlyValidationProof", "stablePublicEndpointProof", "kpiReleaseApproval"],
      "properties": {
        "publicDeploymentProof": { "type": ["string", "null"] },
        "externalReadOnlyValidationProof": { "type": ["string", "null"] },
        "stablePublicEndpointProof": { "type": ["string", "null"] },
        "kpiReleaseApproval": { "type": ["string", "null"] }
      }
    },
    "client": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "publicPath", "resultSchema", "catalogResourceId", "catalogSchema", "discoveryState", "discoverySurfaces", "classification", "verificationEvidence"],
      "properties": {
        "id": { "type": "string", "minLength": 1 },
        "publicPath": { "type": "string", "pattern": "^/examples/revalidation/[a-z0-9-]+\\.mjs$" },
        "resultSchema": { "type": "string", "pattern": "^kallipolis\\.[a-z0-9.-]+\\.v1$" },
        "catalogResourceId": { "type": "string", "pattern": "^resource\\.integration-candidate\\." },
        "catalogSchema": { "type": "string", "pattern": "^kallipolis\\.[a-z0-9.-]+\\.v1$" },
        "discoveryState": { "const": "catalog-llms-sitemap-local-candidate" },
        "discoverySurfaces": { "const": ["source-tree", "catalog", "llms.txt", "sitemap"] },
        "classification": { "enum": ["prepared-local-candidate", "verified-integration"] },
        "verificationEvidence": { "$ref": "#/$defs/verificationEvidence" }
      },
      "allOf": [
        {
          "if": { "properties": { "classification": { "const": "prepared-local-candidate" } }, "required": ["classification"] },
          "then": {
            "properties": {
              "verificationEvidence": {
                "properties": {
                  "publicDeploymentProof": { "const": null },
                  "externalReadOnlyValidationProof": { "const": null },
                  "stablePublicEndpointProof": { "const": null },
                  "kpiReleaseApproval": { "const": null }
                }
              }
            }
          }
        },
        {
          "if": { "properties": { "classification": { "const": "verified-integration" } }, "required": ["classification"] },
          "then": {
            "properties": {
              "verificationEvidence": {
                "properties": {
                  "publicDeploymentProof": { "type": "string", "minLength": 1 },
                  "externalReadOnlyValidationProof": { "type": "string", "minLength": 1 },
                  "stablePublicEndpointProof": { "type": "string", "minLength": 1 },
                  "kpiReleaseApproval": { "type": "string", "minLength": 1 }
                }
              }
            }
          }
        }
      ]
    },
    "counts": {
      "type": "object",
      "additionalProperties": false,
      "required": ["clients", "preparedLocalCandidates", "verifiedExternalIntegrations"],
      "properties": {
        "clients": { "type": "integer", "minimum": 1 },
        "preparedLocalCandidates": { "type": "integer", "minimum": 0 },
        "verifiedExternalIntegrations": { "type": "integer", "minimum": 0 }
      }
    },
    "transitionPolicy": {
      "type": "object",
      "additionalProperties": false,
      "required": ["from", "to", "requires", "labelOnlyPromotionAllowed"],
      "properties": {
        "from": { "const": "prepared-local-candidate" },
        "to": { "const": "verified-integration" },
        "requires": { "const": ["public-deployment-proof", "external-read-only-validation-proof", "stable-public-endpoint-proof", "explicit-kpi-release-approval"] },
        "labelOnlyPromotionAllowed": { "const": false }
      }
    },
    "boundaries": {
      "type": "object",
      "additionalProperties": false,
      "required": ["publicDeploymentPerformed", "sitesVersion", "verifiedIntegrationExamples", "verifiedIntegrationKpiIncrease", "productionStateChanged", "organicUseClaimed", "walletWrites", "niulaiTransactions"],
      "properties": {
        "publicDeploymentPerformed": { "const": false },
        "sitesVersion": { "const": 19 },
        "verifiedIntegrationExamples": { "const": 50 },
        "verifiedIntegrationKpiIncrease": { "const": 0 },
        "productionStateChanged": { "const": false },
        "organicUseClaimed": { "const": false },
        "walletWrites": { "const": 0 },
        "niulaiTransactions": { "const": 0 }
      }
    },
    "privacy": {
      "type": "object",
      "additionalProperties": false,
      "required": ["credentialsStored", "identityOrActivityStored", "requestOrResponseBodiesStored", "walletDataStored"],
      "properties": {
        "credentialsStored": { "const": false },
        "identityOrActivityStored": { "const": false },
        "requestOrResponseBodiesStored": { "const": false },
        "walletDataStored": { "const": false }
      }
    }
  }
}