{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.t-1-t.com/T-GPT/data/pilot-v0.8-annotation-schema.json",
  "title": "T^GPT Pilot v0.8 Annotation Record",
  "type": "object",
  "required": ["record_id", "task_id", "blinded_output_id", "annotator_id", "blind_version", "codebook_version", "semantic_cluster_decision", "adjudication_required"],
  "properties": {
    "record_id": {"type":"string"},
    "task_id": {"type":"string"},
    "blinded_output_id": {"type":"string"},
    "annotator_id": {"type":"string", "description":"pseudonymous annotator identifier; project author must not be the primary reference annotator"},
    "annotator_role": {"enum":["primary_A","primary_B","adjudicator","audit"]},
    "blind_version": {"type":"string"},
    "codebook_version": {"type":"string"},
    "condition_visible_to_annotator": {"const": false},
    "model_visible_to_annotator": {"const": false},
    "t_theory_visible_to_annotator": {"const": false},
    "auto_cluster_id": {"type":["string","null"]},
    "semantic_cluster_decision": {
      "type":"object",
      "required":["cluster_id","decision"],
      "properties": {
        "cluster_id":{"type":"string"},
        "decision":{"enum":["confirm","merge_with_other","split","reject_as_nonsemantic_noise","uncertain"]},
        "merge_target":{"type":["string","null"]},
        "notes":{"type":"string","maxLength":1200}
      }
    },
    "gold_class_match": {
      "type":"array",
      "items":{"type":"string"},
      "description":"only used for preregistered positive controls; empty for open-ended tasks"
    },
    "relevance": {"enum":["relevant","irrelevant","uncertain","not_applicable"]},
    "factuality": {"enum":["supported","unsupported","mixed","not_applicable","uncertain"]},
    "r_meta_class": {
      "enum":["same_opposition_reappeared","opposition_displaced","hierarchy_replaced_opposition","enumeration_replaced_opposition","structural_pluralization","indeterminacy_maintained","no_relevant_recurrence","not_applicable","uncertain"]
    },
    "elicitation_signal": {"enum":["none_detected","possible_mirroring","probable_mirroring","not_applicable","uncertain"]},
    "confidence": {"type":"number","minimum":0,"maximum":1},
    "adjudication_required": {"type":"boolean"},
    "adjudicator_id": {"type":["string","null"]},
    "adjudicated_value": {"type":["string","null"]},
    "timestamp_utc": {"type":"string","format":"date-time"}
  },
  "additionalProperties": false,
  "blinding_policy": {
    "conditions_randomized_before_annotation": true,
    "condition_labels_removed": true,
    "model_identity_removed": true,
    "T_vocabulary_forbidden_from_annotation_instructions": true,
    "minimum_independent_annotators_per_record": 2,
    "agreement_metric": "Krippendorff_alpha_or_preregistered_equivalent",
    "disagreement_policy": "third-party adjudication after independent coding"
  }
}