{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/antfly/json-schema/antfly-entity-consumer-progress-page-schema.json",
  "title": "EntityConsumerProgressPage",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/antfly-resolver-curation-api-openapi.yml#/components/schemas/EntityConsumerProgressPage",
  "type": "object",
  "required": [
    "entity_table",
    "key",
    "catalog_revision",
    "complete",
    "results"
  ],
  "properties": {
    "entity_table": {
      "type": "string"
    },
    "key": {
      "type": "string"
    },
    "catalog_revision": {
      "type": "integer",
      "format": "uint64"
    },
    "complete": {
      "type": "boolean",
      "description": "True when enumeration has no further pages; it does not certify replay completion."
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "results": {
      "type": "array",
      "maxItems": 256,
      "items": {
        "type": "object",
        "required": [
          "source_table",
          "resolver",
          "key_template",
          "revision",
          "applied",
          "progress"
        ],
        "properties": {
          "source_table": {
            "type": "string"
          },
          "resolver": {
            "type": "string"
          },
          "key_template": {
            "type": "string"
          },
          "revision": {
            "type": "integer",
            "format": "uint64"
          },
          "applied": {
            "type": "boolean"
          },
          "progress": {
            "$ref": "#/$defs/ResolverReplayProgress"
          }
        }
      }
    }
  },
  "$defs": {
    "ResolverGroupProgress": {
      "type": "object",
      "required": [
        "group_id",
        "available",
        "fresh",
        "curation_revision",
        "config_generation",
        "effective_generation",
        "backfill_pending",
        "resolution",
        "promotion"
      ],
      "properties": {
        "group_id": {
          "type": "integer",
          "format": "uint64"
        },
        "available": {
          "type": "boolean"
        },
        "fresh": {
          "type": "boolean"
        },
        "curation_revision": {
          "type": "integer",
          "format": "uint64"
        },
        "config_generation": {
          "type": "integer",
          "format": "uint64"
        },
        "effective_generation": {
          "type": "integer",
          "format": "uint64"
        },
        "backfill_pending": {
          "type": "boolean"
        },
        "resolution": {
          "$ref": "#/$defs/ResolverReplayStage"
        },
        "promotion": {
          "$ref": "#/$defs/ResolverReplayStage"
        }
      }
    },
    "ResolverReplayProgress": {
      "type": "object",
      "required": [
        "applied",
        "shards"
      ],
      "properties": {
        "applied": {
          "type": "boolean"
        },
        "shards": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ResolverGroupProgress"
          }
        },
        "observation_error": {
          "type": "string",
          "description": "Progress observation failure after acceptance; the metadata commit remains valid and applied is false."
        }
      }
    },
    "ResolverReplayStage": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean"
        },
        "target_sequence": {
          "type": "integer",
          "format": "uint64"
        },
        "applied_sequence": {
          "type": "integer",
          "format": "uint64"
        },
        "catch_up_required": {
          "type": "boolean"
        },
        "blocked": {
          "type": "boolean"
        },
        "blocked_reason": {
          "type": "string"
        },
        "error_count": {
          "type": "integer",
          "format": "uint64"
        }
      }
    }
  }
}