generative-learning.vercel.app

{
  "type": "object",
  "properties": {
    "lesson": {
      "type": "number",
      "description": "Catalog number from create-lesson."
    },
    "type": {
      "type": "string",
      "enum": [
        "step",
        "riddle"
      ],
      "description": "step = teaching beat (title, why, what). riddle = chess puzzle/חידה: question + correct squares, then wait for a click."
    },
    "title": {
      "type": "string",
      "description": "Beat heading, not the lesson title. For a riddle, a short name."
    },
    "why": {
      "type": "string",
      "description": "Teaching steps: situation and goal before the move. Omit for riddles."
    },
    "what": {
      "type": "string",
      "description": "Teaching steps: concrete move(s) in long algebraic notation such as e2-e4, Ng1-f3. Omit for riddles."
    },
    "paragraphs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional extra detail for teaching steps. Do not spoil a riddle here."
    },
    "moves": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional from:to for Play buttons on teaching steps, e.g. [\"e2:e4\", \"e7:e5\"]."
    },
    "question": {
      "type": "string",
      "description": "Required for type riddle. Puzzle prompt shown to the student. Task only, no spoiler. Squares MUST be English algebraic: files a–h and ranks 1–8 (e4, f7, h5). Never transliterate squares. Words may be any language. Moves MUST use long algebraic notation (LAN) so hover can draw the arrow from the exact piece: e2-e4, e7-e5, Ng1-f3, Nb8-c6, Bf1-c4. Captures: e4xd5, Bf1xc4. Never write short SAN for a move (not 1.e4, not e5, not Nf3, not Bc4, not Qh5). That only highlights the destination, as if the piece is unknown. Bare squares (e4, f7) name a location, not a move. Castling may stay O-O / O-O-O."
    },
    "correct": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Required for type riddle. Acceptable squares such as [\"e5\", \"e4\"]."
    },
    "hint": {
      "type": "string",
      "description": "Optional private nudge for type riddle, used only after they tap Give me a hint in chat. Never put this in question. Not shown on the chess page. Squares MUST be English algebraic: files a–h and ranks 1–8 (e4, f7, h5). Never transliterate squares. Words may be any language. Moves MUST use long algebraic notation (LAN) so hover can draw the arrow from the exact piece: e2-e4, e7-e5, Ng1-f3, Nb8-c6, Bf1-c4. Captures: e4xd5, Bf1xc4. Never write short SAN for a move (not 1.e4, not e5, not Nf3, not Bc4, not Qh5). That only highlights the destination, as if the piece is unknown. Bare squares (e4, f7) name a location, not a move. Castling may stay O-O / O-O-O."
    },
    "quizType": {
      "type": "string",
      "enum": [
        "click-square",
        "click-piece",
        "choose-move"
      ],
      "description": "How the student answers a riddle. Default click-square."
    },
    "fen": {
      "type": "string",
      "description": "Optional board FEN for this beat. For a riddle whose pieces are not the Goal position, pass the puzzle FEN here (set-position is frozen while a catalog lesson is on screen). Catalog only; does not move the live board. Default is the position after the previous teaching step."
    }
  },
  "required": [
    "lesson"
  ]
}