Content Production Pipeline

{
  "id": "item-4nf3a-m1-001",
  "type": "MULTIPLE_CHOICE",

  // === CONTENT ===
  "stem": "What is 2/8 + 3/8?",
  "content": {
    "choices": [
      { "id": "a", "text": "5/16", "isCorrect": false },
      { "id": "b", "text": "5/8", "isCorrect": true },
      { "id": "c", "text": "6/8", "isCorrect": false },
      { "id": "d", "text": "5", "isCorrect": false }
    ],
    "explanation": "When adding fractions with the same denominator,
      add the numerators and keep the denominator: 2/8 + 3/8 = 5/8",
    "misconceptions": {
      "a": "Added both numerators AND denominators",
      "c": "Multiplied instead of adding",
      "d": "Added numerators but forgot the denominator"
    }
  },

  // === DIFFICULTY METADATA ===
  "difficulty": 0.45,           // 0-1 scale (IRT-style)
  "discrimination": 1.2,        // 0-2 scale (how well it separates learners)
  "dokLevel": 2,                // Depth of Knowledge (1-4)
  "sequencePosition": "medium1", // Position in 7-item sequence

  // === GRADE & READABILITY ===
  "gradeLevel": "4",
  "readingLevel": 3.2,          // Flesch-Kincaid grade level
  "vocabularyTier": 1,          // 1=basic, 2=academic, 3=domain-specific

  // === SKILL & STANDARDS ===
  "skillId": "czi-skill-4nf3a-add-like-denom",
  "standards": [
    { "code": "CCSS.Math.4.NF.B.3a", "jurisdiction": "CCSS" },
    { "code": "TEKS.4.3E", "jurisdiction": "Texas" }
  ],

  // === SCAFFOLDING ===
  "hints": [
    { "text": "Look at the denominators. Are they the same?", "cost": 5 },
    { "text": "When denominators match, just add the top numbers.", "cost": 10 },
    { "text": "2 + 3 = 5, so the answer is 5/8.", "cost": 20 }
  ],

  // === VISUAL AIDS ===
  "visualAids": [
    {
      "widget": "fraction-bar",
      "purpose": "Show 2/8 and 3/8 as shaded portions",
      "config": {
        "numerator": 2,
        "denominator": 8,
        "showWhole": true
      }
    }
  ],

  // === GENERATION METADATA ===
  "generatedBy": "gemini-3-flash",
  "generatedAt": "2026-01-13T10:30:00Z",
  "promptVersion": "v2.3",
  "tokensUsed": { "input": 1250, "output": 680 },
  "cost": 0.0012,

  // === EVALUATION METADATA ===
  "evaluationScore": 2.6,
  "evaluationDetails": {
    "factualAccuracy": 3,
    "gradeAppropriateness": 3,
    "pedagogicalSoundness": 2,
    "jsonValidity": 3,
    "completeness": 2
  },
  "evaluationFeedback": "Good item. Consider adding a visual aid.",
  "secondaryEvaluation": {
    "model": "gpt-4o",
    "score": 2.7,
    "agreement": true
  },

  // === REVIEW STATUS ===
  "status": "IN_REVIEW",
  "reviewedBy": null,
  "reviewedAt": null,
  "reviewNotes": []
}