{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://yycore.ai/schemas/corpus-evidence/declaration-v1.schema.json",
  "title": "YY Corpus Evidence declaration document v1",
  "description": "Structural contract for explicit human declarations accepted by YY Corpus Evidence. Canonical declaration identifiers and semantic duplicate detection are additionally enforced by the parser.",
  "type": "object",
  "required": [
    "schema_version",
    "declarations"
  ],
  "properties": {
    "schema_version": {
      "const": "yy-corpus-evidence/declaration/v1"
    },
    "declarations": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/declaration"
      }
    }
  },
  "additionalProperties": false,
  "$defs": {
    "non_empty_string": {
      "type": "string",
      "pattern": "\\S"
    },
    "relative_path_input": {
      "type": "string",
      "minLength": 1,
      "pattern": "^(?![A-Za-z]:)(?![/\\\\])(?![\\s\\S]*[/\\\\](?![\\s\\S]))(?![\\s\\S]*[/\\\\]{2})(?!(?:\\.|\\.\\.)(?:[/\\\\]|(?![\\s\\S])))(?![\\s\\S]*(?:[/\\\\]\\.|[/\\\\]\\.\\.)(?:[/\\\\]|(?![\\s\\S])))[\\s\\S]+"
    },
    "declaration": {
      "type": "object",
      "required": [
        "scope",
        "statement",
        "basis",
        "declared_by",
        "declared_on"
      ],
      "properties": {
        "declaration_id": {
          "type": "string",
          "pattern": "^declaration_v1_[0-9a-f]{32}$"
        },
        "scope": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "exact"
              ],
              "properties": {
                "exact": {
                  "$ref": "#/$defs/relative_path_input"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "required": [
                "prefix"
              ],
              "properties": {
                "prefix": {
                  "anyOf": [
                    {
                      "const": ""
                    },
                    {
                      "$ref": "#/$defs/relative_path_input"
                    }
                  ]
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "statement": {
          "type": "object",
          "required": [
            "kind",
            "value"
          ],
          "properties": {
            "kind": {
              "enum": [
                "origin",
                "license-expression",
                "permission",
                "restriction",
                "sensitivity"
              ]
            },
            "value": {
              "$ref": "#/$defs/non_empty_string"
            }
          },
          "additionalProperties": false
        },
        "basis": {
          "enum": [
            "documented",
            "contractual",
            "first-party",
            "unverified"
          ]
        },
        "declared_by": {
          "$ref": "#/$defs/non_empty_string"
        },
        "declared_on": {
          "type": "string",
          "format": "date"
        },
        "evidence_files": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/relative_path_input"
          }
        },
        "source_url": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
  }
}