{
  "lexicon": 1,
  "id": "org.latha.strata.reasoning",
  "description": "Provenance for a Strata claim — why we believe something, what method produced it, and what it justifies.",
  "defs": {
    "main": {
      "type": "record",
      "description": "A reasoning record that provides provenance for a claim in Strata. Links a question or claim to the method that produced it, the evidence supporting it, and the claim it justifies. Forms the backbone of the Strata provenance graph.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["question", "method", "justifies", "confidence", "createdAt"],
        "properties": {
          "question": {
            "type": "string",
            "maxGraphemes": 500,
            "description": "The question or claim being justified."
          },
          "method": {
            "type": "string",
            "knownValues": [
              "org.latha.strata.defs#web-search",
              "org.latha.strata.defs#human-input",
              "org.latha.strata.defs#inference",
              "org.latha.strata.defs#carry-lookup"
            ],
            "description": "How the claim was produced. Open set — future methods can be added without schema changes."
          },
          "justifies": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI of the claim this reasoning supports (e.g. 'at://did:plc:.../org.latha.strata.citation/3tx...')."
          },
          "confidence": {
            "type": "string",
            "enum": [
              "org.latha.strata.defs#high",
              "org.latha.strata.defs#medium",
              "org.latha.strata.defs#low"
            ],
            "description": "Confidence level in the reasoning."
          },
          "evidence": {
            "type": "string",
            "maxGraphemes": 3000,
            "description": "Supporting evidence, reasoning chain, or explanation of why this method supports the claim."
          },
          "sourceUrl": {
            "type": "string",
            "format": "uri",
            "description": "URL of the source if the reasoning came from a web search."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When this reasoning was recorded in Strata."
          }
        }
      }
    }
  }
}