{
  "contract_version": "gab_221_contract_v1",
  "gab_id": "GAB-221",
  "canonical_name": "SmartSelectContentMatch",
  "module_owner": "EdTechSmartSelect",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "title",
    "selected_item",
    "candidates",
    "primary_cta"
  ],
  "optional_fields": [
    "content_match_id",
    "summary",
    "match_type",
    "reason",
    "match_type_enum",
    "secondary_cta",
    "skip_cta"
  ],
  "field_types": {
    "title": "string",
    "summary": "string",
    "match_type": "enum['objective','weakness','exam','theme','previous_activity','teacher_assigned']",
    "selected_item": "object{label:string, slug?:string, format?:string, estimated_duration?:string, difficulty?:string}",
    "reason": "string",
    "candidates": "array<{label:string, format?:string, status:'winner'|'eliminated', skip_reason?:string}>",
    "match_type_enum": "array<string> — liste des valeurs enum à afficher (informatif)",
    "primary_cta": "object{label:string, action:string}",
    "secondary_cta": "object{label:string, action:string}",
    "skip_cta": "object{label:string, action:string}"
  },
  "constraints": [
    "candidates doit contenir exactement 1 item avec status='winner'.",
    "match_type est un enum strict à 6 valeurs : objective, weakness, exam, theme, previous_activity, teacher_assigned.",
    "primary_cta : bouton structurel (HTML), libellé venant du JSON.",
    "selected_item.format doit correspondre aux classes CSS mod-chip disponibles : visual, exercise, memory, audio, interactive, story, game, mixed_session.",
    "reason : texte en langage élève, jamais de raw data exposée."
  ],
  "blocked_conditions": [
    "title absent",
    "selected_item absent ou selected_item.label vide",
    "candidates absents ou tableau vide",
    "primary_cta absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "aria_labels_ctas"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, 0 erreur" },
    { "case": "champ requis manquant (ex: title)", "expected": "BLOCKED listant le champ" },
    { "case": "candidates vide", "expected": "BLOCKED candidates absents" },
    { "case": "instance externe injectée via ENGINE.init(ext)", "expected": "le rendu change sans modifier le HTML" },
    { "case": "responsive 375/768/1024", "expected": "aucun débordement horizontal" },
    { "case": "clic enum_chip", "expected": "chip actif change, panel note mis à jour" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-221",
    "note": "Ce schema VALIDE l'instance. Le contrat pédagogique complet (input_contract/validation_logic/feedback_scoring_logic) vit dans le CORE-GAB officiel, pas ici (évite la duplication)."
  }
}