{
 "$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
        }
       }
      }
     },
     "answers_deferred": {
      "type": [
       "string",
       "null"
      ],
      "maxLength": 36,
      "description": "the uid of a deferred proposal this row answers: a deferred question is re-proposed only by a pass that has read its note (K11.4)"
     }
    }
   }
  }
 }
}