{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://shd.build/schemas/game-data-capture/isac-handoff-v1.json",
  "title": "Authenticated ISAC draft handoff v1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version",
    "handoff_id",
    "created_at",
    "source_archive",
    "trust_boundary",
    "source_artifacts",
    "evidence_values",
    "records"
  ],
  "properties": {
    "schema_version": { "const": 1 },
    "handoff_id": { "$ref": "#/$defs/id" },
    "created_at": { "$ref": "#/$defs/timestamp" },
    "source_archive": {
      "type": "object",
      "additionalProperties": false,
      "required": ["archive_id", "manifest_sha256", "schema_version"],
      "properties": {
        "archive_id": { "$ref": "#/$defs/id" },
        "manifest_sha256": { "$ref": "#/$defs/sha256" },
        "schema_version": { "const": 1 }
      }
    },
    "trust_boundary": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "intended_destination",
        "mutation_authority",
        "requires_authenticated_action",
        "preserves_moderation",
        "creates_audit_events"
      ],
      "properties": {
        "intended_destination": { "const": "authenticated_isac_intake" },
        "mutation_authority": { "const": "none" },
        "requires_authenticated_action": { "const": true },
        "preserves_moderation": { "const": true },
        "creates_audit_events": { "const": false }
      }
    },
    "source_artifacts": {
      "type": "array",
      "maxItems": 10000,
      "items": { "$ref": "#/$defs/sourceArtifact" }
    },
    "evidence_values": {
      "type": "array",
      "maxItems": 100000,
      "items": { "$ref": "#/$defs/evidenceValue" }
    },
    "records": {
      "type": "array",
      "maxItems": 20000,
      "items": { "$ref": "#/$defs/handoffRecord" }
    }
  },
  "$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 },
    "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",
        "weapon_mod",
        "gear_mod"
      ]
    },
    "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" }
          }
        }
      ]
    },
    "sourceArtifact": {
      "type": "object",
      "additionalProperties": false,
      "required": ["artifact_id", "sha256", "media_type", "byte_size"],
      "properties": {
        "artifact_id": { "$ref": "#/$defs/id" },
        "sha256": { "$ref": "#/$defs/sha256" },
        "media_type": { "enum": ["image/png", "image/webp", "image/avif"] },
        "byte_size": { "type": "integer", "minimum": 1, "maximum": 67108864 }
      }
    },
    "evidenceSection": {
      "type": "object",
      "additionalProperties": false,
      "required": ["status", "evidence_refs", "note"],
      "properties": {
        "status": {
          "enum": ["evidenced", "unresolved", "unsupported", "not_applicable"]
        },
        "evidence_refs": {
          "type": "array",
          "maxItems": 1000,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/id" }
        },
        "note": { "type": ["string", "null"], "maxLength": 4000 }
      }
    },
    "handoffRecord": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "handoff_record_id",
        "record_type",
        "intent",
        "target_id",
        "review_state",
        "source_candidate_ids",
        "observed_instance_ids",
        "fields",
        "relationships",
        "mechanics"
      ],
      "properties": {
        "handoff_record_id": { "$ref": "#/$defs/id" },
        "record_type": { "$ref": "#/$defs/recordType" },
        "intent": { "enum": ["create_draft", "update_draft", "abstain"] },
        "target_id": {
          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/id" }]
        },
        "review_state": { "enum": ["approved", "abstained"] },
        "source_candidate_ids": {
          "type": "array",
          "minItems": 1,
          "maxItems": 100,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/id" }
        },
        "observed_instance_ids": {
          "type": "array",
          "minItems": 1,
          "maxItems": 100,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/id" }
        },
        "fields": {
          "type": "array",
          "maxItems": 1000,
          "items": { "$ref": "#/$defs/fieldClaim" }
        },
        "relationships": { "$ref": "#/$defs/evidenceSection" },
        "mechanics": { "$ref": "#/$defs/evidenceSection" }
      },
      "oneOf": [
        {
          "properties": {
            "intent": { "const": "create_draft" },
            "target_id": { "const": null },
            "review_state": { "const": "approved" }
          }
        },
        {
          "properties": {
            "intent": { "const": "update_draft" },
            "target_id": { "$ref": "#/$defs/id" },
            "review_state": { "const": "approved" }
          }
        },
        {
          "properties": {
            "intent": { "const": "abstain" },
            "target_id": { "const": null },
            "review_state": { "const": "abstained" },
            "fields": { "maxItems": 0 }
          }
        }
      ]
    }
  }
}