{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Zettel References",
  "description": "Notes found in the Zettelkasten relevant to a given topic",
  "type": "object",
  "required": ["query_keywords", "references", "index_entry_points"],
  "properties": {
    "query_keywords": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Keywords used for searching"
    },
    "references": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["filename", "title", "folgezettel_address", "relevance", "key_quotes"],
        "properties": {
          "filename": {
            "type": "string",
            "pattern": "^[0-9a-f]{8}\\.md$",
            "description": "Hex-ID filename of the note"
          },
          "title": {
            "type": "string",
            "description": "Full title including Folgezettel address"
          },
          "folgezettel_address": {
            "type": "string",
            "description": "Folgezettel address (e.g., 3.1c2)"
          },
          "relevance": {
            "type": "string",
            "enum": ["high", "medium", "low"],
            "description": "Relevance to the search topic"
          },
          "key_quotes": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Notable passages from the note"
          },
          "section": {
            "type": "string",
            "description": "Top-level section the note belongs to"
          }
        }
      },
      "description": "Relevant notes found in the Zettelkasten"
    },
    "index_entry_points": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["keyword", "filename", "title"],
        "properties": {
          "keyword": { "type": "string" },
          "filename": { "type": "string" },
          "title": { "type": "string" }
        }
      },
      "description": "Entry points from the index note"
    },
    "total_notes_searched": {
      "type": "integer",
      "minimum": 0
    },
    "timestamp": {
      "type": "string",
      "format": "date-time"
    }
  }
}