{
  "version": "2.5",
  "total_fields": 42,
  "previous_version_fields": 28,
  "new_fields_in_v2": 8,
  "description": "Expanded metadata schema incorporating Toye's AI error taxonomy recommendation - moves from training data toward AI benchmark",
  "fields": [
    {
      "name": "rank",
      "type": "string",
      "required": true,
      "description": "Exact CCC rank title",
      "example": "Cape Elder Prophetess",
      "category": "identity"
    },
    {
      "name": "rank_line",
      "type": "enum",
      "required": true,
      "description": "Which of the 5 rank lines — female-np (sisters, standard line), female-p (prophetess), male-nc (non-clergy leadership), male-p (prophet line), male-c (clergy). Prophet lines collapse into the normal ranking — see collapse_into.",
      "values": [
        "female-np",
        "female-p",
        "male-nc",
        "male-p",
        "male-c"
      ],
      "category": "identity",
      "example": "female-np"
    },
    {
      "name": "rank_order",
      "type": "integer",
      "required": true,
      "description": "Order in progression (1 = first rank of that line)",
      "example": 5,
      "category": "identity"
    },
    {
      "name": "gender",
      "type": "enum",
      "values": [
        "female",
        "male"
      ],
      "category": "identity"
    },
    {
      "name": "batch",
      "type": "string",
      "description": "Batch membership",
      "example": "batch_2",
      "category": "identity"
    },
    {
      "name": "garment_type",
      "type": "string",
      "description": "Base garment classification",
      "example": "Sutana with capelet",
      "category": "garment"
    },
    {
      "name": "garment_length",
      "type": "string",
      "description": "Length specification",
      "example": "Full-length, floor touching",
      "category": "garment"
    },
    {
      "name": "sleeve",
      "type": "string",
      "description": "Sleeve cut",
      "example": "Long sleeves, white",
      "category": "garment"
    },
    {
      "name": "collar",
      "type": "string",
      "description": "Collar style",
      "example": "Round neck, no collar",
      "category": "garment"
    },
    {
      "name": "sash_colour",
      "type": "string",
      "required": true,
      "description": "Sash / loin colour (rank-specific, exact)",
      "example": "Royal Blue",
      "category": "garment"
    },
    {
      "name": "sash_position",
      "type": "string",
      "required": true,
      "description": "How/where sash is arranged",
      "example": "Front waist, bow tied, tails with gold crosses",
      "category": "garment"
    },
    {
      "name": "cross_count_or_insignia",
      "type": "string",
      "required": true,
      "description": "Number and type of crosses/emblems",
      "example": "3 gold embroidered crosses (1 large + 2 small) on sash tails",
      "category": "garment"
    },
    {
      "name": "embroidery",
      "type": "string",
      "description": "Embroidery details",
      "example": "Gold thread, cross motif",
      "category": "garment"
    },
    {
      "name": "lace_trim",
      "type": "string",
      "description": "Lace specification",
      "example": "None - capelet is plain white",
      "category": "garment"
    },
    {
      "name": "head_covering",
      "type": "string",
      "description": "Head covering type",
      "example": "White pleated fan crown with circular halo",
      "category": "garment"
    },
    {
      "name": "robe_description",
      "type": "text",
      "required": true,
      "category": "garment",
      "written_by": "collector",
      "corrected_by": "reviewer",
      "description": "NEW V2.2: the robe description written in the field by the collector, in his own words, from the 7-point checklist (head covering, cape/top, sutana or cassock, loin or sash, crosses, strands or cross-bar, anything different). The reviewer corrects and confirms it before promotion; it feeds distinctive_features and, for an undocumented rank, it IS the record.",
      "example": "Head: white pleated crown with circular halo. Cape: square white capelet, no lace. Sutana: white, full length. Sash: royal blue, bow at front waist, two tails to mid-calf. Crosses: 3 gold, 1 large on the bow + 2 small on the tails. Strands: none. Different: none.",
      "related_fields": [
        "distinctive_features",
        "corrective_instruction",
        "garment_status"
      ]
    },
    {
      "name": "distinctive_features",
      "type": "text",
      "required": true,
      "description": "What uniquely identifies this rank's garment - expert description",
      "example": "Square white capelet shoulder covering is distinctive for Cape Elder Prophetess",
      "category": "garment"
    },
    {
      "name": "regional_variation",
      "type": "text",
      "description": "Known regional differences",
      "category": "garment"
    },
    {
      "name": "image_type",
      "type": "enum",
      "required": true,
      "description": "Type of image",
      "values": [
        "original_photograph",
        "bg_removed",
        "ai_render",
        "3d_render",
        "3d_model",
        "4view_grid",
        "standardized_front",
        "standardized_back",
        "standardized_left",
        "standardized_right",
        "detail"
      ],
      "category": "image"
    },
    {
      "name": "view",
      "type": "enum",
      "description": "Standardized view angle. The dataset standard is five views per rank — front, back, left, right, detail (4view_grid is a composite built later, not shot in the field). 50 ranks x 5 = 250 views.",
      "values": [
        "front",
        "back",
        "left",
        "right",
        "detail",
        "4view_grid"
      ],
      "category": "image"
    },
    {
      "name": "view_status",
      "type": "enum",
      "category": "image",
      "values": [
        "captured",
        "not_available"
      ],
      "description": "NEW V2.3: whether this view was actually shot. A view the collector could not shoot is recorded as not_available with a reason, so a missing side reads as a decision rather than a gap.",
      "example": "not_available"
    },
    {
      "name": "human_present",
      "type": "enum",
      "required": true,
      "description": "Whether a person appears",
      "values": [
        "yes",
        "no_mannequin",
        "no_render",
        "no_garment_only",
        "transparent_mannequin"
      ],
      "category": "image"
    },
    {
      "name": "bg_removed",
      "type": "boolean",
      "description": "Background removed",
      "category": "image"
    },
    {
      "name": "image_permission",
      "type": "string",
      "description": "Permission status",
      "category": "provenance"
    },
    {
      "name": "source_reference",
      "type": "string",
      "description": "Source of image",
      "category": "provenance"
    },
    {
      "name": "verification_status",
      "type": "enum",
      "required": true,
      "description": "How verified",
      "values": [
        "unverified",
        "photo_verified",
        "custodian",
        "official",
        "conflict",
        "master_template"
      ],
      "category": "provenance"
    },
    {
      "name": "verified_by",
      "type": "string",
      "description": "Verifier name/role",
      "example": "CCC custodian, Ondo South HQ",
      "category": "provenance"
    },
    {
      "name": "expert_notes",
      "type": "text",
      "description": "Domain expert free text",
      "category": "provenance"
    },
    {
      "name": "render_type",
      "type": "string",
      "description": "Render specification",
      "category": "image"
    },
    {
      "name": "dataset_version",
      "type": "string",
      "description": "Dataset version",
      "example": "2.0",
      "category": "system"
    },
    {
      "name": "ai_common_mistake",
      "type": "text",
      "required": true,
      "description": "OVERALL: What AI models get wrong about this rank - legacy field, keep for compatibility",
      "example": "AI generates generic white robe with no cape, wrong sash, no crosses",
      "category": "ai_error_taxonomy",
      "is_legacy": true
    },
    {
      "name": "ai_wrong_garment_type",
      "type": "text",
      "description": "NEW V2: AI confuses garment type with...",
      "example": "AI generates Catholic nun habit or generic choir robe instead of CCC sutana with capelet",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "ai_wrong_colour",
      "type": "text",
      "description": "NEW V2: Specific colour errors",
      "example": "AI uses light blue or navy instead of exact royal-blue #4169E1",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "ai_wrong_sash",
      "type": "text",
      "description": "NEW V2: Sash errors - colour, position, bow, tails",
      "example": "AI omits front bow, places sash on shoulder like Catholic stole, wrong tail length",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "ai_wrong_insignia",
      "type": "text",
      "description": "NEW V2: Cross count, insignia errors",
      "example": "AI generates 1 generic cross or 5+ crosses instead of exact 3 (1 large + 2 small) gold embroidered",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "ai_wrong_headwear",
      "type": "text",
      "description": "NEW V2: Head covering errors",
      "example": "AI generates uncovered head or Catholic veil instead of pleated fan crown with circular halo",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "ai_wrong_cut",
      "type": "text",
      "description": "NEW V2: Garment cut errors - length, sleeve, capelet",
      "example": "AI generates short dress or sleeveless, omits square capelet entirely",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "ai_wrong_component",
      "type": "text",
      "description": "NEW V2: Missing components",
      "example": "AI omits capelet, loin, or embroidery - generates plain white gown",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "corrective_instruction",
      "type": "text",
      "required": true,
      "description": "NEW V2: Exact instruction to correct AI - used for benchmark evaluation",
      "example": "Generate white full-length sutana with square white capelet covering shoulders, royal-blue satin sash tied at front waist with large bow and two tails, 3 gold embroidered crosses (1 large centered + 2 small) on sash tails, white pleated fan crown head covering with circular halo",
      "category": "ai_error_taxonomy",
      "is_new_v2": true
    },
    {
      "name": "garment_status",
      "type": "enum",
      "category": "provenance",
      "values": [
        "documented",
        "to_capture",
        "confirmed_by_custodian"
      ],
      "description": "Whether this rank's regalia is documented, still awaiting a first field capture, or confirmed by the custodian.",
      "example": "to_capture"
    },
    {
      "name": "view_note",
      "type": "text",
      "category": "image",
      "description": "Why a view could not be captured — e.g. 'garment worn, back not accessible'.",
      "example": "garment worn by a person — back not accessible"
    },
    {
      "name": "capture_group",
      "type": "string",
      "category": "system",
      "description": "Ties the views of one rank-visit together, so the reviewer sees a set rather than loose photos.",
      "example": "grp_20260925_abc123_xy"
    }
  ],
  "ai_benchmark_tests": [
    "Is there a cape/capelet?",
    "Is the sash colour correct?",
    "Is the sash position correct?",
    "Is the sash bow present and correctly tied?",
    "Are the crosses correct count?",
    "Are the crosses correct colour and placement?",
    "Is the head covering correct?",
    "Is the garment length correct?",
    "Is the garment type correct (not confused with other religious attire)?",
    "Are all components present (robe, sash, loin, embroidery, cross, lace trim, head covering)?"
  ],
  "master_template_spec": {
    "rank": "Cape Elder Prophetess",
    "pipeline": "RAW PHOTO → verified garment-only render → 5 standardized views → metadata → AI mistakes → verification → 3D component specification",
    "standardized_views": [
      "front",
      "back",
      "left",
      "right",
      "detail"
    ],
    "visual_standard": {
      "camera": "Fixed focal length 50mm, distance 2.5m, height 1.6m, tripod locked",
      "lighting": "Softbox 3-point, 5600K, 1:1.2 key-fill ratio, no harsh shadows",
      "background": "Neutral #F5F0E8 seamless, 10% vignette",
      "mannequin": "Transparent female form, size M, no head features, matte",
      "scale": "Garment occupies 80% frame height, centered, consistent across all ranks",
      "resolution": "2048x2560 minimum, PNG + JPG",
      "color_profile": "sRGB, color checker calibrated"
    },
    "component_separation_for_3d": [
      "robe / sutana",
      "sash",
      "loin",
      "embroidery",
      "cross",
      "lace_trim",
      "head_covering",
      "capelet"
    ]
  },
  "updated": "2026-09-25",
  "rank_line_note": "v2.5 — the custodian's standard ranks: 50 ranks across 5 lines = 250 views. The prophet ladders COLLAPSE into the normal ranking (female-p continues at Superior Elder Sister, male-p at Assistant Evangelist), so merge ranks are stored once. The apex is on board: Venerable Most Superior Evangelist, Supreme Evangelist and Pastor C.C.C. Worldwide close the clergy line (the Pastor RESTRICTED — never rendered without the church's authorisation). Onibode and Akawe share a robe and differ by the loin (robe_pairs).",
  "rank_totals": {
    "total_ranks": 50,
    "views_per_rank": 5,
    "total_views": 250,
    "lines": 5,
    "per_line": {
      "female-np": 8,
      "female-p": 4,
      "male-nc": 18,
      "male-p": 6,
      "male-c": 14
    }
  },
  "collapse_rule": {
    "why": "The prophet line is a calling, not a parallel career. Once the prophet ladder is complete the anointee continues in the ordinary ranking with everyone else.",
    "female": {
      "from": "female-p after lace-senior-prophetess",
      "into": "female-np from superior-elder-sister"
    },
    "male": {
      "from": "male-p after superior-wolider",
      "into": "male-c from assistant-evangelist"
    },
    "effect_on_the_dataset": "The merge ranks are stored ONCE (in female-np / male-c). The prophet batches hold only the ranks that are unique to the prophet calling, so no rank is counted twice."
  },
  "robe_pairs": [
    {
      "id": "onibode-akawe",
      "ranks": [
        "onibode",
        "akawe"
      ],
      "line_code": "male-nc",
      "same": "robe",
      "differs": "loin",
      "confirmed_by": "custodian",
      "rule": "Onibode and Akawe are two ranks that wear all but the same robe. The loin is the only visual difference, so the field capture must photograph and describe the loin, and nothing about these two may be inferred from the ordinary brother or elder-brother garment."
    }
  ],
  "views_per_rank": 5,
  "view_standard": {
    "views": [
      "front",
      "back",
      "left",
      "right",
      "detail"
    ],
    "rule": "Every rank is documented from all five sides. The collector shoots them in one visit; the reviewer sees coverage per rank and is warned before promoting a rank that is not fully shot.",
    "not_available": "A view that cannot be shot is recorded with a reason — never silently skipped.",
    "total_views": 250
  }
}