{
  "tool": "matric-nqf4.lang_reading_statistic",
  "name": "Reading statistic on a fixed text (CDU-GEN-NSC-400)",
  "answers": "Word count, sentence count and average word length of a supplied passage — a deterministic text measure, never a model-marked essay.",
  "degree": {
    "id": "competency:matric-nqf4",
    "code": "CDU-GEN-NSC-400",
    "name": "Senior Certificate (Amended) — exam-readiness programme (NQF 4 matric)",
    "version": "1.0.0"
  },
  "reference": "Umalusi/NSC subject catalogue, worked reference (offline reconstruction); a fixed-text statistic (languages row of §4)",
  "endpoint": "/faculty/matric-nqf4/lang_reading_statistic",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "text"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "text": {
        "type": "string",
        "description": "the passage (non-empty)"
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "words",
      "sentences",
      "averageWordLength"
    ],
    "properties": {
      "words": {
        "type": "number",
        "description": "word count"
      },
      "sentences": {
        "type": "number",
        "description": "sentence count"
      },
      "averageWordLength": {
        "type": "number",
        "description": "letters per word (2 d.p.)"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "text": "The sun rose over the valley. Every learner opened a book. Reading builds the mind."
  }
}