{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Document Authoring Input",
  "description": "Input schema for the document-authoring skill: create or revise one content block in a document folio.",
  "type": "object",
  "required": [
    "document",
    "chapter",
    "section",
    "kind",
    "label"
  ],
  "properties": {
    "document": {
      "type": "string",
      "description": "Document slug under content/."
    },
    "chapter": {
      "type": "string",
      "description": "Chapter directory name within the document."
    },
    "section": {
      "type": "string",
      "description": "Label or title of the section whose blocks[] will name this block."
    },
    "kind": {
      "type": "string",
      "enum": [
        "prose",
        "example",
        "remark",
        "algorithm",
        "simulator",
        "equation",
        "diagram",
        "table"
      ],
      "description": "Block kind. Restricted to the document profile: the seven math kinds (definition, theorem, lemma, proposition, corollary, conjecture, proof) are the paper profile and are rejected by content_profile_check."
    },
    "label": {
      "type": "string",
      "description": "Stable identifier, e.g. rec:cold-chain-audit. Becomes the block's HTML anchor; must survive renumbering."
    },
    "title": {
      "type": "string",
      "description": "Short display title."
    },
    "uses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Labels of the blocks a reader must already have read. Direct neighbours only, never the transitive closure. Editorial judgement — never derived."
    },
    "body": {
      "type": "string",
      "description": "GitHub-flavoured Markdown for the block's .md file."
    }
  },
  "$id": "https://litlfred.github.io/folio-assistant/folio-assistant-core/schema/skills/document-authoring/input.schema.json"
}
