{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "dfp/proposals-file/1",
  "title": "A proposals file: one brand, one pass (decisions-model spec 6.1; REVIEW-PROCESS.md section 6)",
  "type": "object",
  "required": ["pass", "brand", "proposals"],
  "additionalProperties": false,
  "properties": {
    "pass": {
      "type": "object",
      "required": ["name", "kind", "process_version", "rules_version", "generator"],
      "additionalProperties": false,
      "properties": {
        "name": {"type": "string", "minLength": 3, "maxLength": 120, "pattern": "^[a-z0-9][a-z0-9._:/-]*$"},
        "kind": {"type": "string", "enum": ["session", "rule", "arrival"]},
        "process_version": {"type": "string", "minLength": 1, "maxLength": 20},
        "rules_version": {"type": "string", "minLength": 1, "maxLength": 8},
        "generator": {"type": "string", "minLength": 1, "maxLength": 80},
        "note": {"type": ["string", "null"], "maxLength": 4000}
      }
    },
    "brand": {"type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9-]*$"},
    "proposals": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["entity", "field", "value", "reason", "evidence"],
        "additionalProperties": false,
        "properties": {
          "sheet_line_ref": {"type": ["string", "null"], "maxLength": 500, "pattern": "^line:"},
          "position": {"type": "integer", "minimum": 0},
          "entity": {
            "type": "object",
            "required": ["type", "key"],
            "additionalProperties": false,
            "properties": {
              "type": {"type": "string", "enum": ["brand", "product_line", "product_variant", "listing", "attribute_wording", "suggestion"]},
              "key": {"type": "string", "minLength": 3, "maxLength": 500, "pattern": "^(brand|line|variant|listing|wording|pair):"},
              "detail": {"type": ["object", "null"]}
            }
          },
          "field": {"type": "string", "maxLength": 80, "pattern": "^[a-z_]+(:[a-z0-9_-]{1,40}){0,2}$"},
          "value": {"type": ["string", "number", "boolean", "object", "array"]},
          "confidence": {"type": ["number", "null"], "minimum": 0, "maximum": 1},
          "reason": {"type": "string", "minLength": 1, "maxLength": 2000},
          "origin": {"type": "string", "maxLength": 80},
          "evidence": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "required": ["listing", "source", "span", "text"],
              "additionalProperties": false,
              "properties": {
                "listing": {"type": "string", "pattern": "^listing:[^/]+/[^/]+/.+$"},
                "source": {"type": "string", "pattern": "^(listed_name|listed_variant|listed_quantity_text|listed_category|listed_brand|option:[a-z0-9_-]{1,40})$"},
                "span": {"type": "array", "items": {"type": "integer", "minimum": 0}, "minItems": 2, "maxItems": 2},
                "text": {"type": "string", "minLength": 1}
              }
            }
          }
        }
      }
    }
  }
}