quickmathematics.github.io

{
  "type": "object",
  "properties": {
    "question_id": {
      "type": "string",
      "description": "The reviewed question ID.",
      "maxLength": 120
    },
    "feedback": {
      "type": "string",
      "description": "One concise diagnosis or Socratic prompt.",
      "maxLength": 1500
    },
    "mistake_tag": {
      "type": "string",
      "description": "A short misconception tag, or none.",
      "maxLength": 80
    },
    "next_step": {
      "type": "string",
      "description": "One concrete next action for the learner.",
      "maxLength": 300
    },
    "confidence": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "verdict": {
      "type": "string",
      "enum": [
        "pass",
        "partial",
        "needs_revision",
        "fail"
      ]
    },
    "obligation_results": {
      "type": "array",
      "maxItems": 12,
      "description": "For a proof, one status per obligation from inspect_student_work. Structured statuses determine the verdict.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Exact obligation ID.",
            "maxLength": 80
          },
          "status": {
            "type": "string",
            "enum": [
              "satisfied",
              "flawed",
              "missing",
              "not_applicable"
            ]
          },
          "note": {
            "type": "string",
            "description": "Evidence or revision note.",
            "maxLength": 500
          }
        },
        "required": [
          "id",
          "status"
        ],
        "additionalProperties": false
      }
    },
    "rubric_results": {
      "type": "array",
      "maxItems": 12,
      "description": "For a rubric, one awarded score per criterion from inspect_student_work. Structured scores determine the verdict.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Exact criterion ID.",
            "maxLength": 80
          },
          "awarded_points": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "note": {
            "type": "string",
            "description": "Evidence or revision note.",
            "maxLength": 500
          }
        },
        "required": [
          "id",
          "awarded_points"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "question_id",
    "feedback",
    "next_step"
  ],
  "additionalProperties": false
}