haoku.app

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "A multiple-choice question { prompt, options: [string], answer: 1-based position or the option text, explanation?, citation?, topic? }.",
        "properties": {
          "prompt": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 2
          },
          "answer": {
            "description": "1-based position of the right option, or its text."
          },
          "explanation": {
            "type": "string",
            "description": "Shown after answering."
          },
          "citation": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string",
                "description": "A source by id (from list_sources) or by file name."
              },
              "page": {
                "type": "integer",
                "minimum": 1,
                "description": "Page number as printed, starting at 1. Text sources are a single page."
              },
              "quote": {
                "type": "string",
                "description": "A passage of the source, quoted from read_source or search_sources. Spacing, line breaks and hyphenation do not matter."
              },
              "occurrence": {
                "type": "integer",
                "minimum": 1,
                "description": "Which occurrence when the quote repeats on the page. Defaults to 1."
              }
            },
            "required": [
              "source"
            ],
            "description": "The passage the question checks; shown as \"source →\" while practising."
          },
          "topic": {
            "type": "string",
            "description": "A short label to group questions (usually a section title)."
          }
        },
        "required": [
          "prompt",
          "options",
          "answer"
        ]
      },
      "minItems": 1
    }
  },
  "required": [
    "items"
  ]
}