{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://draftwright.dev/schema/draftwright-step-inspection-v4.schema.json",
  "title": "Draftwright STEP inspection v4",
  "description": "Bounded same-run evidence with report-local source-face and rejected-candidate relationships. It is not recognition recall, and report-local IDs are not persistent topology identity.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema",
    "schema_version",
    "source",
    "producer",
    "run",
    "faces",
    "found",
    "missed"
  ],
  "properties": {
    "schema": {
      "const": "draftwright-step-inspection"
    },
    "schema_version": {
      "const": 4
    },
    "source": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "sha256"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        }
      }
    },
    "producer": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "draftwright",
        "quiddity"
      ],
      "properties": {
        "draftwright": {
          "type": "string",
          "minLength": 1
        },
        "quiddity": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "run": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "pmi_mode"
      ],
      "properties": {
        "pmi_mode": {
          "enum": [
            "off",
            "report",
            "annotate"
          ]
        }
      }
    },
    "found": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/found_feature"
      }
    },
    "missed": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "unclaimed_faces",
        "face_count",
        "rejected_candidates"
      ],
      "properties": {
        "unclaimed_faces": {
          "description": "Faces unassociated with accepted occurrences; not a missed-feature or recall count.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/face"
          }
        },
        "face_count": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "total",
            "claimed",
            "unclaimed"
          ],
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 0
            },
            "claimed": {
              "type": "integer",
              "minimum": 0
            },
            "unclaimed": {
              "type": "integer",
              "minimum": 0
            }
          }
        },
        "rejected_candidates": {
          "$ref": "#/$defs/candidate_lifecycle"
        }
      }
    },
    "faces": {
      "description": "Every source face with a deterministic report-local ID. IDs are valid only in this document.",
      "type": "array",
      "minItems": 1,
      "items": {
        "$ref": "#/$defs/face"
      }
    }
  },
  "$defs": {
    "point": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "number"
      }
    },
    "face": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "surface",
        "area",
        "position",
        "bbox"
      ],
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^face:[1-9][0-9]*$"
        },
        "surface": {
          "type": "string",
          "minLength": 1
        },
        "area": {
          "type": "number",
          "minimum": 0
        },
        "position": {
          "$ref": "#/$defs/point"
        },
        "bbox": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "min",
            "max"
          ],
          "properties": {
            "min": {
              "$ref": "#/$defs/point"
            },
            "max": {
              "$ref": "#/$defs/point"
            }
          }
        }
      }
    },
    "candidate_lifecycle": {
      "description": "Aggregate detector decisions plus the closed public graph rooted at rejected candidates. This is diagnostic evidence, not precision, recall, or proof that an unnamed face was never examined.",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "available",
        "coverage",
        "scope",
        "recognition_recall",
        "families",
        "diagnostics",
        "candidates"
      ],
      "properties": {
        "available": {
          "const": true
        },
        "coverage": {
          "const": "bounded"
        },
        "scope": {
          "const": "detector-candidate-lifecycle"
        },
        "recognition_recall": {
          "const": "not-assessed"
        },
        "families": {
          "type": "array",
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/family_lifecycle"
          }
        },
        "diagnostics": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/diagnostic"
          }
        },
        "candidates": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/candidate"
          }
        }
      }
    },
    "family_lifecycle": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "family",
        "evaluation",
        "proposed",
        "accepted",
        "rejected",
        "dispositions"
      ],
      "properties": {
        "family": {
          "enum": [
            "countersinks",
            "holes",
            "double_d_bores",
            "bosses",
            "polygonal_bosses",
            "polygonal_stock",
            "channels",
            "slots",
            "rectangular_blind_slots",
            "round_bottom_blind_slots",
            "grooves",
            "flats",
            "pockets",
            "prismatic_pockets",
            "edge_open_circular_pockets",
            "edge_open_prismatic_recesses",
            "section_recesses",
            "pads",
            "repeating_radial_profiles",
            "turned_steps",
            "step_levels",
            "risers",
            "chamfers",
            "angled_steps",
            "paired_ramp_steps",
            "gusset_ribs",
            "through_steps",
            "circular_blind_steps",
            "passages",
            "oriented_slots",
            "blends",
            "fillets",
            "plates",
            "circular_face_patterns",
            "freeform_surfaces",
            "interior_voids",
            "oblique_through_steps",
            "oriented_chamfers",
            "sheet_metal_bodies",
            "thin_wall_bodies"
          ]
        },
        "evaluation": {
          "enum": [
            "evaluated",
            "not-applicable"
          ]
        },
        "proposed": {
          "type": "integer",
          "minimum": 0
        },
        "accepted": {
          "type": "integer",
          "minimum": 0
        },
        "rejected": {
          "type": "integer",
          "minimum": 0
        },
        "dispositions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/disposition"
          }
        }
      }
    },
    "disposition": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "reason",
        "outcome",
        "occurrences",
        "related_occurrences"
      ],
      "properties": {
        "reason": {
          "enum": [
            "default.accepted",
            "recess.prismatic_superseded_by_pocket",
            "recess.pocket_superseded_by_rectangular_blind_slot",
            "recess.pocket_superseded_by_edge_open_circular_pocket",
            "recess.pocket_superseded_by_passage",
            "recess.pocket_superseded_by_prismatic",
            "recess.slot_superseded_by_pocket",
            "recess.slot_superseded_by_prismatic",
            "recess.slot_superseded_by_passage",
            "recess.passage_superseded_by_slot",
            "recess.passage_superseded_by_oriented_slot",
            "bevel.chamfer_superseded_by_angled_step",
            "blend.fillet_superseded_by_circular_blind_step",
            "blend.chain_superseded_by_fillet",
            "bore.hole_superseded_by_double_d_bore",
            "turned.boss_superseded_by_step",
            "wall.plate_superseded_by_body",
            "wall.boss_superseded_by_body",
            "wall.riser_superseded_by_body",
            "turned.step_groove_compatible",
            "turned.groove_step_compatible"
          ]
        },
        "outcome": {
          "enum": [
            "accepted",
            "rejected"
          ]
        },
        "occurrences": {
          "type": "integer",
          "minimum": 0
        },
        "related_occurrences": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "diagnostic": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code",
        "status",
        "family",
        "axis",
        "at",
        "raw_outer_edges",
        "effective_outer_sides"
      ],
      "properties": {
        "code": {
          "enum": [
            "unsupported.subdivided_angled_step_terminal"
          ]
        },
        "status": {
          "enum": [
            "unsupported"
          ]
        },
        "family": {
          "$ref": "#/$defs/family_lifecycle/properties/family"
        },
        "axis": {
          "enum": [
            "x",
            "y",
            "z"
          ]
        },
        "at": {
          "$ref": "#/$defs/point"
        },
        "raw_outer_edges": {
          "type": "integer",
          "minimum": 0
        },
        "effective_outer_sides": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "found_feature": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "family",
        "defining_face_ids",
        "constituent_face_ids",
        "feature",
        "feature_type",
        "feature_schema_version",
        "draftwright"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1
        },
        "family": {
          "type": "string",
          "minLength": 1
        },
        "defining_face_ids": {
          "$ref": "#/$defs/face_ids"
        },
        "constituent_face_ids": {
          "$ref": "#/$defs/face_ids"
        },
        "feature": {
          "type": "object"
        },
        "feature_type": {
          "type": "string",
          "minLength": 1
        },
        "feature_schema_version": {
          "type": "integer",
          "minimum": 1
        },
        "draftwright": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "acted_on",
            "disposition",
            "reason",
            "owners"
          ],
          "properties": {
            "acted_on": {
              "type": "boolean"
            },
            "disposition": {
              "enum": [
                "represented",
                "absorbed",
                "unsupported",
                "deferred",
                "evidence_only",
                "unexpectedly_missing"
              ]
            },
            "reason": {
              "type": "string",
              "minLength": 1
            },
            "owners": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            }
          }
        }
      }
    },
    "face_ids": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^face:[1-9][0-9]*$"
      }
    },
    "candidate_ids": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^candidate:[1-9][0-9]*$"
      }
    },
    "candidate": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "source",
        "family",
        "outcome",
        "reason",
        "defining_face_ids",
        "constituent_face_ids",
        "related_candidate_ids"
      ],
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^candidate:[1-9][0-9]*$"
        },
        "source": {
          "enum": [
            "rejected-roster",
            "related"
          ]
        },
        "family": {
          "type": "string",
          "minLength": 1
        },
        "outcome": {
          "enum": [
            "accepted",
            "rejected"
          ]
        },
        "reason": {
          "$ref": "#/$defs/disposition/properties/reason"
        },
        "defining_face_ids": {
          "$ref": "#/$defs/face_ids"
        },
        "constituent_face_ids": {
          "$ref": "#/$defs/face_ids"
        },
        "related_candidate_ids": {
          "$ref": "#/$defs/candidate_ids"
        }
      }
    }
  }
}