{
  "schema_version": "1.0",
  "id": "reason-codes",
  "title": "Reason Codes",
  "summary": "Stable machine-readable explanations for verification outcomes.",
  "sections": {
    "schema_version": "1.0",
    "codes": [
      {
        "code": "SOURCE_DIRECTLY_SUPPORTS_CLAIM",
        "description": "The supplied source directly establishes the material factual claim.",
        "typical_verdicts": [
          "supported"
        ],
        "recommended_action": "safe_to_use_as_cited"
      },
      {
        "code": "SOURCE_PARTIALLY_SUPPORTS_CLAIM",
        "description": "The source establishes a material part but not the complete claim.",
        "typical_verdicts": [
          "partially_supported"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "SOURCE_DOES_NOT_CONTAIN_FACT",
        "description": "The supplied source does not contain the claimed fact.",
        "typical_verdicts": [
          "unsupported"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "SOURCE_CONTAINS_RELATED_BUT_INSUFFICIENT_FACT",
        "description": "The source is related but does not establish the material claim.",
        "typical_verdicts": [
          "unsupported"
        ],
        "recommended_action": "seek_additional_evidence"
      },
      {
        "code": "AUTHORITATIVE_SOURCE_CONFLICT",
        "description": "Authoritative evidence conflicts with the submitted claim.",
        "typical_verdicts": [
          "contradicted"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "NUMERIC_CONTRADICTION",
        "description": "A deterministic numerical comparison conflicts with the submitted claim.",
        "typical_verdicts": [
          "contradicted"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "DATE_MISMATCH",
        "description": "A material date differs from the claim or requested time context.",
        "typical_verdicts": [
          "outdated"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "TEMPORAL_OUTDATEDNESS",
        "description": "The evidence supports an earlier state but not the current requested context.",
        "typical_verdicts": [
          "outdated"
        ],
        "recommended_action": "source_outdated"
      },
      {
        "code": "SCOPE_OVERSTATEMENT",
        "description": "The claim is broader than the evidence supports.",
        "typical_verdicts": [
          "partially_supported"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "CAUSAL_INFERENCE_NOT_SUPPORTED",
        "description": "The evidence does not establish the claimed causal relationship.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "QUANTITY_OVERSTATEMENT",
        "description": "The claim states a materially larger quantity than the evidence.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "MATERIAL_QUALIFIER_MISSING",
        "description": "A qualifier necessary for accuracy is omitted.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "CITATION_MISMATCH",
        "description": "The citation does not match the asserted fact.",
        "typical_verdicts": [
          "unsupported"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "SOURCE_INACCESSIBLE",
        "description": "The supplied source could not be retrieved safely.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "seek_additional_evidence"
      },
      {
        "code": "SOURCE_AMBIGUOUS",
        "description": "The source wording is too ambiguous for the claimed interpretation.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "seek_additional_evidence"
      },
      {
        "code": "INSUFFICIENT_EVIDENCE",
        "description": "Available evidence is insufficient for a reliable determination.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "seek_additional_evidence"
      },
      {
        "code": "COMPOUND_CLAIM",
        "description": "The submission contains multiple material factual claims and must be split.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "DETERMINISTIC_CHECK_CONFLICT",
        "description": "A deterministic check conflicts with a non-deterministic interpretation.",
        "typical_verdicts": [
          "contradicted"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "MULTI_SOURCE_CONFLICT",
        "description": "Multiple sources materially disagree.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "MODEL_DISAGREEMENT_UNRESOLVED",
        "description": "Structured verifier disagreement could not be resolved from evidence.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      },
      {
        "code": "VERIFICATION_BUDGET_EXHAUSTED",
        "description": "The authorized verification budget ended before required assurance was achieved.",
        "typical_verdicts": [
          "unverifiable"
        ],
        "recommended_action": "revise_before_use"
      }
    ]
  },
  "version": "2026-08-v6",
  "effective_at": "2026-08-10T00:00:00Z",
  "content_hash": "sha256:464b2f5e0a8dc6f59e1b3fd42a83ba432e3d35a5818d4f1050b0986c33207dad"
}