{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://shd.build/schemas/game-data-capture/evidence-archive-manifest-v1.json",
  "title": "Game data capture evidence archive manifest v1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version", "archive_id", "created_at", "generator", "artifacts", "captures",
    "screens", "jobs", "extractions", "groups", "reviews", "exports", "errors",
    "evidence_values", "observed_instances", "canonical_candidates"
  ],
  "properties": {
    "schema_version": {"const": 1},
    "archive_id": {"$ref": "#/$defs/id"},
    "created_at": {"$ref": "#/$defs/timestamp"},
    "generator": {
      "type": "object",
      "additionalProperties": false,
      "required": ["name", "version", "policy_version"],
      "properties": {
        "name": {"type": "string", "minLength": 1, "maxLength": 100},
        "version": {"type": "string", "minLength": 1, "maxLength": 50},
        "policy_version": {"type": "string", "minLength": 1, "maxLength": 50}
      }
    },
    "artifacts": {"type": "array", "maxItems": 10000, "items": {"$ref": "#/$defs/artifact"}},
    "captures": {"type": "array", "maxItems": 10000, "items": {"$ref": "#/$defs/capture"}},
    "screens": {"type": "array", "maxItems": 10000, "items": {"$ref": "#/$defs/screen"}},
    "jobs": {"type": "array", "maxItems": 20000, "items": {"$ref": "#/$defs/job"}},
    "extractions": {"type": "array", "maxItems": 20000, "items": {"$ref": "#/$defs/extraction"}},
    "groups": {"type": "array", "maxItems": 10000, "items": {"$ref": "#/$defs/group"}},
    "reviews": {"type": "array", "maxItems": 10000, "items": {"$ref": "#/$defs/review"}},
    "exports": {"type": "array", "maxItems": 1000, "items": {"$ref": "#/$defs/export"}},
    "errors": {"type": "array", "maxItems": 20000, "items": {"$ref": "#/$defs/error"}},
    "evidence_values": {"type": "array", "maxItems": 100000, "items": {"$ref": "#/$defs/evidenceValue"}},
    "observed_instances": {"type": "array", "maxItems": 20000, "items": {"$ref": "#/$defs/observedInstance"}},
    "canonical_candidates": {"type": "array", "maxItems": 20000, "items": {"$ref": "#/$defs/canonicalCandidate"}}
  },
  "$defs": {
    "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"},
    "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
    "timestamp": {"type": "string", "format": "date-time", "maxLength": 40},
    "family": {"enum": ["weapon", "gear", "skill_chip", "os_protocol", "specialization", "unknown"]},
    "recordType": {"enum": [
      "weapon", "weapon_talent", "weapon_augmentation_profile", "gear", "brand_set",
      "gear_talent", "gear_augmentation_profile", "skill_chip_set", "skill_chip_set_bonus",
      "skill_chip_roll_pool", "skill_chip_talent", "os_protocol", "os_protocol_secondary_profile",
      "os_protocol_talent", "specialization", "specialization_focus", "specialization_ability",
      "specialization_tree_node", "specialization_tree_rank"
    ]},
    "missingReason": {"enum": [
      "not_visible", "occluded", "unreadable", "not_present_on_screen", "unsupported",
      "ambiguous", "extraction_failed", "not_applicable", "redacted"
    ]},
    "jsonValue": {
      "oneOf": [
        {"type": "null"}, {"type": "boolean"}, {"type": "number"},
        {"type": "string", "maxLength": 8192},
        {"type": "array", "maxItems": 500, "items": {"$ref": "#/$defs/jsonValue"}},
        {"type": "object", "maxProperties": 500, "additionalProperties": {"$ref": "#/$defs/jsonValue"}}
      ]
    },
    "sourceEngine": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "engine_id", "engine_version"],
      "properties": {
        "kind": {"enum": ["local_ocr", "openai_vision", "classifier", "manual", "video_decoder"]},
        "engine_id": {"type": "string", "minLength": 1, "maxLength": 100},
        "engine_version": {"type": "string", "minLength": 1, "maxLength": 100}
      }
    },
    "region": {
      "oneOf": [
        {
          "type": "object", "additionalProperties": false,
          "required": ["coordinate_space", "x", "y", "width", "height"],
          "properties": {
            "coordinate_space": {"const": "normalized"},
            "x": {"type": "number", "minimum": 0, "maximum": 1},
            "y": {"type": "number", "minimum": 0, "maximum": 1},
            "width": {"type": "number", "exclusiveMinimum": 0, "maximum": 1},
            "height": {"type": "number", "exclusiveMinimum": 0, "maximum": 1}
          }
        },
        {
          "type": "object", "additionalProperties": false,
          "required": ["coordinate_space", "x", "y", "width", "height"],
          "properties": {
            "coordinate_space": {"const": "pixels"},
            "x": {"type": "integer", "minimum": 0, "maximum": 100000},
            "y": {"type": "integer", "minimum": 0, "maximum": 100000},
            "width": {"type": "integer", "minimum": 1, "maximum": 100000},
            "height": {"type": "integer", "minimum": 1, "maximum": 100000}
          }
        }
      ]
    },
    "valueState": {
      "type": "object",
      "additionalProperties": false,
      "required": ["raw_text", "normalized_value", "missing_reason"],
      "properties": {
        "raw_text": {"type": ["string", "null"], "maxLength": 8192},
        "normalized_value": {"$ref": "#/$defs/jsonValue"},
        "missing_reason": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/missingReason"}]}
      },
      "oneOf": [
        {"properties": {"normalized_value": {"type": "null"}, "missing_reason": {"$ref": "#/$defs/missingReason"}}},
        {"properties": {"normalized_value": {"not": {"type": "null"}}, "missing_reason": {"type": "null"}}}
      ]
    },
    "correction": {
      "type": "object", "additionalProperties": false,
      "required": ["correction_id", "corrected_at", "actor", "reason", "before", "after"],
      "properties": {
        "correction_id": {"$ref": "#/$defs/id"},
        "corrected_at": {"$ref": "#/$defs/timestamp"},
        "actor": {"enum": ["local_user", "system_reprocess"]},
        "reason": {"type": "string", "minLength": 1, "maxLength": 1000},
        "before": {"$ref": "#/$defs/valueState"},
        "after": {"$ref": "#/$defs/valueState"}
      }
    },
    "evidenceValue": {
      "type": "object", "additionalProperties": false,
      "required": [
        "evidence_id", "field_path", "raw_text", "normalized_value", "missing_reason",
        "confidence", "source_engine", "image_artifact_id", "image_sha256", "region", "correction_history"
      ],
      "properties": {
        "evidence_id": {"$ref": "#/$defs/id"},
        "field_path": {"type": "string", "pattern": "^[A-Za-z0-9_.-]{1,256}$"},
        "raw_text": {"type": ["string", "null"], "maxLength": 8192},
        "normalized_value": {"$ref": "#/$defs/jsonValue"},
        "missing_reason": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/missingReason"}]},
        "confidence": {"type": "number", "minimum": 0, "maximum": 1},
        "source_engine": {"$ref": "#/$defs/sourceEngine"},
        "image_artifact_id": {"$ref": "#/$defs/id"},
        "image_sha256": {"$ref": "#/$defs/sha256"},
        "region": {"$ref": "#/$defs/region"},
        "correction_history": {"type": "array", "maxItems": 100, "items": {"$ref": "#/$defs/correction"}}
      },
      "oneOf": [
        {"properties": {"normalized_value": {"type": "null"}, "missing_reason": {"$ref": "#/$defs/missingReason"}}},
        {"properties": {"normalized_value": {"not": {"type": "null"}}, "missing_reason": {"type": "null"}}}
      ]
    },
    "fieldClaim": {
      "type": "object", "additionalProperties": false,
      "required": ["path", "value", "missing_reason", "evidence_refs", "uncertainty_note"],
      "properties": {
        "path": {"type": "string", "pattern": "^[A-Za-z0-9_.-]{1,256}$"},
        "value": {"$ref": "#/$defs/jsonValue"},
        "missing_reason": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/missingReason"}]},
        "evidence_refs": {"type": "array", "minItems": 1, "maxItems": 100, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
        "uncertainty_note": {"type": ["string", "null"], "maxLength": 2000}
      },
      "oneOf": [
        {"properties": {"value": {"type": "null"}, "missing_reason": {"$ref": "#/$defs/missingReason"}}},
        {"properties": {"value": {"not": {"type": "null"}}, "missing_reason": {"type": "null"}}}
      ]
    },
    "classification": {
      "type": "object", "additionalProperties": false,
      "required": ["family", "view", "gear_slot", "record_types", "confidence", "abstention_reason"],
      "properties": {
        "family": {"$ref": "#/$defs/family"}, "view": {"type": "string"},
        "gear_slot": {"type": ["string", "null"]},
        "record_types": {"type": "array", "uniqueItems": true, "maxItems": 8, "items": {"$ref": "#/$defs/recordType"}},
        "confidence": {"type": "number", "minimum": 0, "maximum": 1},
        "abstention_reason": {"type": ["string", "null"]}
      },
      "oneOf": [
        {"properties": {"family": {"const": "weapon"}, "view": {"enum": ["detail", "blueprint", "crafting", "stat_range", "talent_grid", "augmentation"]}, "gear_slot": {"const": null}, "record_types": {"minItems": 1, "items": {"enum": ["weapon", "weapon_talent", "weapon_augmentation_profile"]}}, "abstention_reason": {"const": null}}},
        {"properties": {"family": {"const": "gear"}, "view": {"enum": ["detail", "blueprint", "talent", "augmentation"]}, "gear_slot": {"enum": ["Mask", "Gloves", "Backpack", "Body Armor", "Holster", "Knee Pads"]}, "record_types": {"minItems": 1, "items": {"enum": ["gear", "brand_set", "gear_talent", "gear_augmentation_profile"]}}, "abstention_reason": {"const": null}}},
        {"properties": {"family": {"const": "skill_chip"}, "view": {"enum": ["detail", "set_bonus", "talent"]}, "gear_slot": {"const": null}, "record_types": {"minItems": 1, "items": {"enum": ["skill_chip_set", "skill_chip_set_bonus", "skill_chip_roll_pool", "skill_chip_talent"]}}, "abstention_reason": {"const": null}}},
        {"properties": {"family": {"const": "os_protocol"}, "view": {"enum": ["detail", "secondary_profile", "talent"]}, "gear_slot": {"const": null}, "record_types": {"minItems": 1, "items": {"enum": ["os_protocol", "os_protocol_secondary_profile", "os_protocol_talent"]}}, "abstention_reason": {"const": null}}},
        {"properties": {"family": {"const": "specialization"}, "view": {"enum": ["overview", "details", "ability", "focus_details", "focus_tree", "rank_details"]}, "gear_slot": {"const": null}, "record_types": {"minItems": 1, "items": {"enum": ["specialization", "specialization_focus", "specialization_ability", "specialization_tree_node", "specialization_tree_rank"]}}, "abstention_reason": {"const": null}}},
        {"properties": {"family": {"const": "unknown"}, "view": {"const": "unknown"}, "gear_slot": {"const": null}, "record_types": {"maxItems": 0}, "abstention_reason": {"enum": ["low_confidence", "ambiguous_family", "ambiguous_view", "unsupported_family", "unsupported_view", "insufficient_visual_evidence", "occluded", "corrupt_image", "resource_limit", "cancelled"]}}}
      ]
    },
    "artifact": {
      "type": "object", "additionalProperties": false,
      "required": ["artifact_id", "sha256", "media_type", "byte_size", "sensitivity", "parent_artifact_id", "video_timestamp_ms"],
      "properties": {
        "artifact_id": {"$ref": "#/$defs/id"}, "sha256": {"$ref": "#/$defs/sha256"},
        "media_type": {"enum": ["image/png", "image/webp", "image/avif", "video/mp4", "video/webm", "video/x-matroska"]},
        "byte_size": {"type": "integer", "minimum": 1},
        "sensitivity": {"const": "private"},
        "parent_artifact_id": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/id"}]},
        "video_timestamp_ms": {"type": ["integer", "null"], "minimum": 0, "maximum": 86400000}
      },
      "oneOf": [
        {
          "properties": {
            "media_type": {"enum": ["image/png", "image/webp", "image/avif"]},
            "byte_size": {"maximum": 67108864}
          }
        },
        {
          "properties": {
            "media_type": {"enum": ["video/mp4", "video/webm", "video/x-matroska"]},
            "byte_size": {"maximum": 17179869184}
          }
        }
      ]
    },
    "capture": {
      "type": "object", "additionalProperties": false,
      "required": ["capture_id", "artifact_id", "state", "received_at", "failure_reason"],
      "properties": {
        "capture_id": {"$ref": "#/$defs/id"}, "artifact_id": {"$ref": "#/$defs/id"},
        "state": {"enum": ["received", "spooling", "stored", "deduplicated", "queued", "failed", "cancelled"]},
        "received_at": {"$ref": "#/$defs/timestamp"},
        "failure_reason": {"type": ["string", "null"], "maxLength": 2000}
      }
    },
    "screen": {
      "type": "object", "additionalProperties": false,
      "required": ["screen_id", "artifact_id", "classified_at", "classification"],
      "properties": {
        "screen_id": {"$ref": "#/$defs/id"}, "artifact_id": {"$ref": "#/$defs/id"},
        "classified_at": {"$ref": "#/$defs/timestamp"}, "classification": {"$ref": "#/$defs/classification"}
      }
    },
    "job": {
      "type": "object", "additionalProperties": false,
      "required": ["job_id", "kind", "state", "attempt", "max_attempts", "last_error_id"],
      "properties": {
        "job_id": {"$ref": "#/$defs/id"},
        "kind": {"enum": ["classify", "ocr", "vision_fallback", "frame_extract", "export"]},
        "state": {"enum": ["queued", "running", "retry_wait", "succeeded", "failed", "cancelled"]},
        "attempt": {"type": "integer", "minimum": 0, "maximum": 20},
        "max_attempts": {"type": "integer", "minimum": 1, "maximum": 20},
        "last_error_id": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/id"}]}
      }
    },
    "extraction": {
      "type": "object", "additionalProperties": false,
      "required": ["extraction_id", "screen_id", "state", "evidence_refs", "abstention_reason"],
      "properties": {
        "extraction_id": {"$ref": "#/$defs/id"}, "screen_id": {"$ref": "#/$defs/id"},
        "state": {"enum": ["pending", "local_processing", "fallback_pending", "fallback_processing", "candidate_ready", "abstained", "failed", "cancelled"]},
        "evidence_refs": {"type": "array", "maxItems": 1000, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
        "abstention_reason": {"type": ["string", "null"], "maxLength": 100}
      }
    },
    "group": {
      "type": "object", "additionalProperties": false,
      "required": ["group_id", "state", "screen_ids", "supersedes_group_ids"],
      "properties": {
        "group_id": {"$ref": "#/$defs/id"},
        "state": {"enum": ["ungrouped", "proposed", "grouped", "split", "superseded", "rejected", "cancelled"]},
        "screen_ids": {"type": "array", "minItems": 1, "maxItems": 100, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
        "supersedes_group_ids": {"type": "array", "maxItems": 100, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}}
      }
    },
    "review": {
      "type": "object", "additionalProperties": false,
      "required": ["review_id", "candidate_id", "state", "updated_at", "note"],
      "properties": {
        "review_id": {"$ref": "#/$defs/id"}, "candidate_id": {"$ref": "#/$defs/id"},
        "state": {"enum": ["pending", "in_review", "changes_requested", "approved", "rejected", "cancelled"]},
        "updated_at": {"$ref": "#/$defs/timestamp"}, "note": {"type": ["string", "null"], "maxLength": 4000}
      }
    },
    "export": {
      "type": "object", "additionalProperties": false,
      "required": ["export_id", "state", "artifact_id", "failure_reason"],
      "properties": {
        "export_id": {"$ref": "#/$defs/id"},
        "state": {"enum": ["not_requested", "queued", "building", "ready", "failed", "cancelled", "expired"]},
        "artifact_id": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/id"}]},
        "failure_reason": {"type": ["string", "null"], "maxLength": 2000}
      }
    },
    "error": {
      "type": "object", "additionalProperties": false,
      "required": ["error_id", "state", "code", "message", "retry_after"],
      "properties": {
        "error_id": {"$ref": "#/$defs/id"},
        "state": {"enum": ["open", "retryable", "retrying", "recovered", "terminal", "dismissed"]},
        "code": {"enum": ["cancelled", "resource_limit", "timeout", "invalid_input", "engine_failure", "storage_failure", "network_failure", "schema_rejected", "unsupported", "ambiguous"]},
        "message": {"type": "string", "minLength": 1, "maxLength": 2000},
        "retry_after": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/timestamp"}]}
      }
    },
    "observedContext": {
      "type": "object", "additionalProperties": false,
      "required": ["level", "quality", "tier", "upgrade_state"],
      "properties": {
        "level": {"$ref": "#/$defs/fieldClaim"}, "quality": {"$ref": "#/$defs/fieldClaim"},
        "tier": {"$ref": "#/$defs/fieldClaim"}, "upgrade_state": {"$ref": "#/$defs/fieldClaim"}
      }
    },
    "observedInstance": {
      "type": "object", "additionalProperties": false,
      "required": ["instance_id", "family", "source_screen_ids", "observed_context", "fields"],
      "properties": {
        "instance_id": {"$ref": "#/$defs/id"}, "family": {"$ref": "#/$defs/family"},
        "source_screen_ids": {"type": "array", "minItems": 1, "maxItems": 100, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
        "observed_context": {"$ref": "#/$defs/observedContext"},
        "fields": {"type": "array", "maxItems": 1000, "items": {"$ref": "#/$defs/fieldClaim"}}
      }
    },
    "canonicalCandidate": {
      "type": "object", "additionalProperties": false,
      "required": ["candidate_id", "record_type", "source_instance_ids", "evidence_refs", "fields", "completeness", "relationship_status", "mechanic_status"],
      "properties": {
        "candidate_id": {"$ref": "#/$defs/id"}, "record_type": {"$ref": "#/$defs/recordType"},
        "source_instance_ids": {"type": "array", "minItems": 1, "maxItems": 100, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
        "evidence_refs": {"type": "array", "minItems": 1, "maxItems": 1000, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
        "fields": {"type": "array", "maxItems": 1000, "items": {"$ref": "#/$defs/fieldClaim"}},
        "completeness": {"enum": ["complete", "incomplete", "unsupported"]},
        "relationship_status": {"enum": ["evidenced", "unresolved", "unsupported", "not_applicable"]},
        "mechanic_status": {"enum": ["evidenced", "unresolved", "unsupported", "not_applicable"]}
      }
    }
  }
}