{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://standards.rootblocks.com/schemas/cache/cache-runtime-policy.v1.schema.json",
  "title": "RootBlocks Cache Runtime Policy v1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schemaVersion",
    "policyId",
    "version",
    "defaultEnforcementMode",
    "states",
    "refreshBeforeOperations",
    "offlinePolicy",
    "atomicUpdate",
    "composition",
    "recovery"
  ],
  "properties": {
    "schemaVersion": {
      "const": "rootblocks.cache-runtime-policy/v1"
    },
    "policyId": {
      "$ref": "#/$defs/id"
    },
    "version": {
      "$ref": "#/$defs/semver"
    },
    "defaultEnforcementMode": {
      "enum": ["advisory", "enforced"]
    },
    "states": {
      "type": "array",
      "minItems": 6,
      "items": {
        "$ref": "#/$defs/stateDefinition"
      },
      "allOf": [
        { "contains": { "properties": { "state": { "const": "current" } }, "required": ["state"] } },
        { "contains": { "properties": { "state": { "const": "stale-warning" } }, "required": ["state"] } },
        { "contains": { "properties": { "state": { "const": "stale-critical" } }, "required": ["state"] } },
        { "contains": { "properties": { "state": { "const": "invalid" } }, "required": ["state"] } },
        { "contains": { "properties": { "state": { "const": "quarantined" } }, "required": ["state"] } },
        { "contains": { "properties": { "state": { "const": "refreshing" } }, "required": ["state"] } }
      ]
    },
    "refreshBeforeOperations": {
      "type": "array",
      "minItems": 8,
      "items": {
        "$ref": "#/$defs/operation"
      },
      "uniqueItems": true,
      "allOf": [
        { "contains": { "const": "generate" } },
        { "contains": { "const": "validate" } },
        { "contains": { "const": "compile" } },
        { "contains": { "const": "run" } },
        { "contains": { "const": "debug" } },
        { "contains": { "const": "package" } },
        { "contains": { "const": "sign" } },
        { "contains": { "const": "release" } }
      ]
    },
    "offlinePolicy": {
      "type": "object",
      "additionalProperties": false,
      "required": ["allowedStates", "expiredAction", "maxOfflineHours"],
      "properties": {
        "allowedStates": {
          "type": "array",
          "minItems": 1,
          "items": {
            "enum": ["current", "stale-warning"]
          },
          "uniqueItems": true
        },
        "expiredAction": {
          "enum": ["block-operation", "require-refresh"]
        },
        "maxOfflineHours": {
          "type": "integer",
          "minimum": 1,
          "maximum": 720
        }
      }
    },
    "atomicUpdate": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "downloadToTemp",
        "verifyTempBundle",
        "lockBeforeReplace",
        "atomicReplace",
        "preserveLastValid",
        "writeMetadataAfterReplace"
      ],
      "properties": {
        "downloadToTemp": { "const": true },
        "verifyTempBundle": { "const": true },
        "lockBeforeReplace": { "const": true },
        "atomicReplace": { "const": true },
        "preserveLastValid": { "const": true },
        "writeMetadataAfterReplace": { "const": true }
      }
    },
    "composition": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "globalRequired",
        "componentsOnlyExternalExtensions",
        "separateExternalComponentStores",
        "allowedExternalScopes",
        "blockedExternalAssetKinds",
        "buildPackMetadataRequired",
        "packageArtifactMetadataRequired"
      ],
      "properties": {
        "globalRequired": { "const": true },
        "componentsOnlyExternalExtensions": { "const": true },
        "separateExternalComponentStores": { "const": true },
        "allowedExternalScopes": {
          "type": "array",
          "minItems": 1,
          "items": {
            "enum": ["organization", "project", "personal"]
          },
          "uniqueItems": true
        },
        "blockedExternalAssetKinds": {
          "type": "array",
          "minItems": 1,
          "items": {
            "enum": [
              "schema",
              "rule",
              "template",
              "golden",
              "policy",
              "documentation",
              "semantic-engine",
              "architecture-profile",
              "recipe",
              "compatibility",
              "bundle",
              "registry"
            ]
          },
          "uniqueItems": true
        },
        "buildPackMetadataRequired": { "const": true },
        "packageArtifactMetadataRequired": { "const": true }
      }
    },
    "recovery": {
      "type": "object",
      "additionalProperties": false,
      "required": ["tamperAction", "invalidStates", "restoreLastValidWhenAvailable"],
      "properties": {
        "tamperAction": {
          "const": "quarantine-current"
        },
        "invalidStates": {
          "type": "array",
          "minItems": 2,
          "items": {
            "enum": ["invalid", "quarantined"]
          },
          "uniqueItems": true
        },
        "restoreLastValidWhenAvailable": {
          "const": true
        }
      }
    }
  },
  "$defs": {
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9.-]{2,127}$"
    },
    "semver": {
      "type": "string",
      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(-[A-Za-z0-9.-]+)?(\\+[A-Za-z0-9.-]+)?$"
    },
    "operation": {
      "enum": ["generate", "validate", "compile", "run", "debug", "package", "sign", "release"]
    },
    "stateDefinition": {
      "type": "object",
      "additionalProperties": false,
      "required": ["state", "usable", "blocksCriticalOperations", "quarantine", "refreshInProgress"],
      "properties": {
        "state": {
          "enum": ["current", "stale-warning", "stale-critical", "invalid", "quarantined", "refreshing"]
        },
        "usable": {
          "type": "boolean"
        },
        "blocksCriticalOperations": {
          "type": "boolean"
        },
        "quarantine": {
          "type": "boolean"
        },
        "refreshInProgress": {
          "type": "boolean"
        }
      }
    }
  }
}