{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://claridoc.local/schemas/review.schema.json",
  "title": "ClariDoc model review response",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "score",
    "dimension_scores",
    "issues",
    "strengths",
    "questions"
  ],
  "properties": {
    "score": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "dimension_scores": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "reader_goal_alignment",
        "information_architecture",
        "logical_flow",
        "cognitive_load",
        "evidence_traceability",
        "example_verifiability",
        "scannability",
        "operational_safety",
        "completeness_and_limits"
      ],
      "properties": {
        "reader_goal_alignment": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "information_architecture": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "logical_flow": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "cognitive_load": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "evidence_traceability": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "example_verifiability": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "scannability": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "operational_safety": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "completeness_and_limits": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        }
      }
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "section",
          "problem",
          "why_it_matters",
          "fix",
          "severity"
        ],
        "properties": {
          "section": {
            "type": "string"
          },
          "problem": {
            "type": "string",
            "minLength": 1
          },
          "why_it_matters": {
            "type": "string",
            "minLength": 1
          },
          "fix": {
            "type": "string",
            "minLength": 1
          },
          "severity": {
            "type": "string",
            "enum": [
              "blocker",
              "error",
              "warning",
              "info"
            ]
          }
        }
      }
    },
    "strengths": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "questions": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    }
  }
}