{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://structupath.ai/schemas/pi-steel/estimate-package-1.0.0.json",
  "title": "pi-steel canonical estimate package",
  "type": "object",
  "required": [
    "schema_version",
    "project",
    "unit_system",
    "items",
    "stock",
    "commercial_basis",
    "review",
    "lineage"
  ],
  "properties": {
    "schema_version": { "const": "1.0.0" },
    "project": { "$ref": "#/$defs/project" },
    "unit_system": { "const": "imperial" },
    "items": {
      "type": "array",
      "items": { "$ref": "#/$defs/item" }
    },
    "stock": {
      "type": "array",
      "items": { "$ref": "#/$defs/stock" }
    },
    "commercial_basis": { "$ref": "#/$defs/commercialBasis" },
    "assumptions": {
      "type": "array",
      "items": { "$ref": "#/$defs/assumption" },
      "default": []
    },
    "review": { "$ref": "#/$defs/review" },
    "lineage": { "$ref": "#/$defs/lineage" }
  },
  "additionalProperties": false,
  "$defs": {
    "project": {
      "type": "object",
      "required": ["project_id", "revision"],
      "properties": {
        "project_id": { "type": "string", "minLength": 1 },
        "name": { "type": "string" },
        "estimator": { "type": "string", "minLength": 1 },
        "estimate_as_of": { "type": "string", "format": "date" },
        "revision": {
          "type": "object",
          "required": ["revision_id"],
          "properties": {
            "revision_id": { "type": "string", "minLength": 1 },
            "source_document": { "type": "string" },
            "issued_date": { "type": "string", "format": "date" }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    },
    "evidence": {
      "type": "object",
      "required": ["source", "locator"],
      "properties": {
        "source": { "type": "string", "minLength": 1 },
        "locator": { "type": "string", "minLength": 1 },
        "sheet": { "type": "string", "minLength": 1 },
        "detail": { "type": "string", "minLength": 1 },
        "source_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
      },
      "additionalProperties": false
    },
    "hole": {
      "oneOf": [
        {
          "type": "object",
          "required": ["kind", "diameter", "x", "y"],
          "properties": {
            "kind": { "const": "round" },
            "diameter": { "type": "number", "exclusiveMinimum": 0 },
            "x": { "type": "number" },
            "y": { "type": "number" }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": ["kind", "width", "height", "x", "y"],
          "properties": {
            "kind": { "const": "rect" },
            "width": { "type": "number", "exclusiveMinimum": 0 },
            "height": { "type": "number", "exclusiveMinimum": 0 },
            "x": { "type": "number" },
            "y": { "type": "number" }
          },
          "additionalProperties": false
        }
      ]
    },
    "geometry": {
      "type": "object",
      "required": ["shape", "width", "height", "thickness"],
      "properties": {
        "shape": { "type": "string" },
        "width": { "type": "number", "exclusiveMinimum": 0 },
        "height": { "type": "number", "exclusiveMinimum": 0 },
        "thickness": { "type": "number", "exclusiveMinimum": 0 },
        "area": { "type": "number", "exclusiveMinimum": 0 },
        "holes": {
          "type": "array",
          "items": { "$ref": "#/$defs/hole" },
          "default": []
        },
        "rotatable": { "type": "boolean", "default": true }
      },
      "additionalProperties": false
    },
    "itemBase": {
      "type": "object",
      "required": ["intent", "source_id", "item_id", "quantity"],
      "properties": {
        "intent": {
          "enum": [
            "fabricated_part",
            "purchased_stock",
            "hardware",
            "allowance",
            "exclusion",
            "by_others"
          ]
        },
        "source_id": { "type": "string", "minLength": 1 },
        "item_id": { "type": "string", "minLength": 1 },
        "quantity": { "type": "integer", "minimum": 1 },
        "quantity_basis": { "$ref": "#/$defs/quantityBasis" },
        "mark": { "type": "string" },
        "description": { "type": "string" },
        "source_evidence": {
          "type": "array",
          "items": { "$ref": "#/$defs/evidence" }
        }
      }
    },
    "fabricatedPart": {
      "allOf": [
        { "$ref": "#/$defs/itemBase" },
        {
          "type": "object",
          "required": ["intent"],
          "properties": {
            "intent": { "const": "fabricated_part" },
            "material": { "type": "string" },
            "grade": { "type": "string" },
            "geometry": { "$ref": "#/$defs/geometry" },
            "designation": { "type": "string" },
            "length_ft": { "type": "number", "exclusiveMinimum": 0 },
            "unit_weight_plf": { "type": "number", "exclusiveMinimum": 0 },
            "total_weight_lbs": { "type": "number", "exclusiveMinimum": 0 },
            "connections": { "type": "string" },
            "notes": { "type": "string" },
            "identity_warning": { "type": "boolean" }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "purchased": {
      "allOf": [
        { "$ref": "#/$defs/itemBase" },
        {
          "type": "object",
          "required": ["intent"],
          "properties": {
            "intent": { "enum": ["purchased_stock", "hardware"] },
            "material": { "type": "string" },
            "grade": { "type": "string" },
            "specification": { "type": "string" },
            "dimensions": { "$ref": "#/$defs/purchaseDimensions" }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "allowance": {
      "allOf": [
        { "$ref": "#/$defs/itemBase" },
        {
          "type": "object",
          "required": ["intent", "allowance_basis"],
          "properties": {
            "intent": { "const": "allowance" },
            "allowance_basis": {
              "type": "object",
              "required": ["kind", "value", "applies_to"],
              "properties": {
                "kind": { "enum": ["percent", "fixed_weight"] },
                "value": { "type": "number", "exclusiveMinimum": 0 },
                "applies_to": { "type": "string", "minLength": 1 },
                "source": { "type": "string", "minLength": 1 },
                "effective_date": { "type": "string", "format": "date" },
                "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }
              },
              "additionalProperties": false
            }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "nonSupply": {
      "allOf": [
        { "$ref": "#/$defs/itemBase" },
        {
          "type": "object",
          "required": ["intent", "reason"],
          "properties": {
            "intent": { "enum": ["exclusion", "by_others"] },
            "reason": { "type": "string", "minLength": 1 }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "item": {
      "oneOf": [
        { "$ref": "#/$defs/fabricatedPart" },
        { "$ref": "#/$defs/purchased" },
        { "$ref": "#/$defs/allowance" },
        { "$ref": "#/$defs/nonSupply" }
      ]
    },
    "stock": {
      "type": "object",
      "required": [
        "stock_kind",
        "material",
        "grade",
        "width",
        "height",
        "thickness",
        "quantity"
      ],
      "properties": {
        "stock_kind": { "enum": ["on_hand", "purchasable"] },
        "inventory_id": { "type": "string", "minLength": 1 },
        "material": { "type": "string", "minLength": 1 },
        "grade": { "type": "string", "minLength": 1 },
        "width": { "type": "number", "exclusiveMinimum": 0 },
        "height": { "type": "number", "exclusiveMinimum": 0 },
        "thickness": { "type": "number", "exclusiveMinimum": 0 },
        "quantity": { "type": "integer", "minimum": 1 },
        "status": { "enum": ["available", "reserved", "unavailable"] },
        "measured_at": { "type": "string", "format": "date" },
        "source": { "type": "string" },
        "reviewer_confirmation": {
          "type": "object",
          "required": ["actor", "timestamp", "estimate_hash"],
          "properties": {
            "actor": { "type": "string", "minLength": 1 },
            "timestamp": { "type": "string", "format": "date-time" },
            "estimate_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    },
    "commercialBasis": {
      "type": "object",
      "required": ["currency", "costs"],
      "properties": {
        "currency": { "type": "string", "pattern": "^[A-Z]{3}$" },
        "costs": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "cost_id",
              "amount",
              "currency",
              "unit_basis",
              "effective_date",
              "source"
            ],
            "properties": {
              "cost_id": { "type": "string", "minLength": 1 },
              "amount": { "type": "number", "exclusiveMinimum": 0 },
              "currency": { "type": "string", "pattern": "^[A-Z]{3}$" },
              "unit_basis": { "type": "string", "minLength": 1 },
              "effective_date": { "type": "string", "format": "date" },
              "source": { "type": "string", "minLength": 1 },
              "synthetic": { "type": "boolean" }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "quantityBasis": {
      "type": "object",
      "required": ["method"],
      "properties": {
        "method": { "type": "string", "minLength": 1 },
        "description": { "type": "string", "minLength": 1 },
        "source_evidence": {
          "type": "array",
          "items": { "$ref": "#/$defs/evidence" }
        }
      },
      "additionalProperties": false
    },
    "purchaseDimensions": {
      "type": "object",
      "properties": {
        "category": { "type": "string", "minLength": 1 },
        "size": { "type": "string", "minLength": 1 },
        "purchase_weight_lbs": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "stock_length": { "type": "number", "exclusiveMinimum": 0 },
        "thickness": { "type": "number", "exclusiveMinimum": 0 },
        "width": { "type": "number", "exclusiveMinimum": 0 },
        "height": { "type": "number", "exclusiveMinimum": 0 },
        "replaces_item_ids": {
          "type": "array",
          "items": { "type": "string", "minLength": 1 },
          "uniqueItems": true
        },
        "inventory_id": { "type": "string", "minLength": 1 },
        "stock_id": { "type": "string", "minLength": 1 }
      },
      "additionalProperties": false
    },
    "assumption": {
      "type": "object",
      "required": ["assumption_id", "text", "status"],
      "properties": {
        "assumption_id": { "type": "string", "minLength": 1 },
        "text": { "type": "string", "minLength": 1 },
        "status": { "enum": ["unresolved", "confirmed", "rejected"] },
        "source_evidence": {
          "type": "array",
          "items": { "$ref": "#/$defs/evidence" }
        }
      },
      "additionalProperties": false
    },
    "finding": {
      "type": "object",
      "required": [
        "finding_id",
        "code",
        "severity",
        "path",
        "message",
        "relevant_hash"
      ],
      "properties": {
        "finding_id": { "type": "string", "minLength": 1 },
        "code": { "type": "string", "minLength": 1 },
        "severity": { "enum": ["blocker", "warning", "info"] },
        "path": { "type": "string", "minLength": 1 },
        "message": { "type": "string", "minLength": 1 },
        "relevant_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
      },
      "additionalProperties": false
    },
    "review": {
      "type": "object",
      "required": ["status", "findings", "acknowledgements"],
      "properties": {
        "status": {
          "enum": ["draft", "review_required", "validated", "invalid"]
        },
        "findings": {
          "type": "array",
          "items": { "$ref": "#/$defs/finding" }
        },
        "acknowledgements": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "finding_id",
              "actor",
              "timestamp",
              "disposition",
              "input_hash"
            ],
            "properties": {
              "finding_id": { "type": "string", "minLength": 1 },
              "actor": { "type": "string", "minLength": 1 },
              "timestamp": { "type": "string", "format": "date-time" },
              "disposition": {
                "enum": ["accepted", "rejected", "deferred"]
              },
              "input_hash": {
                "type": "string",
                "pattern": "^[0-9a-f]{64}$"
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "lineage": {
      "type": "object",
      "required": ["source_type", "source_hash", "configuration_hash"],
      "properties": {
        "source_type": { "type": "string", "minLength": 1 },
        "source_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
        "configuration_hash": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "generated_at": { "type": "string", "format": "date-time" }
      },
      "additionalProperties": false
    }
  }
}