{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:hif:schema:inspection-report:1.0",
  "title": "HIF inspection report",
  "description": "Portable evidence report produced by a HIF-compatible inspection adapter.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schemaVersion",
    "engineVersion",
    "id",
    "generatedAt",
    "mode",
    "target",
    "findings",
    "passedRuleIds",
    "metrics",
    "coverage",
    "warnings"
  ],
  "properties": {
    "schemaVersion": {
      "const": "1.0"
    },
    "engineVersion": {
      "type": "string",
      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$"
    },
    "id": {
      "type": "string",
      "minLength": 8
    },
    "generatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "mode": {
      "enum": ["url", "image"]
    },
    "target": {
      "type": "string",
      "minLength": 1
    },
    "finalUrl": {
      "type": "string",
      "format": "uri"
    },
    "findings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/finding"
      }
    },
    "passedRuleIds": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "$ref": "#/$defs/ruleId"
      }
    },
    "metrics": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/metric"
      }
    },
    "coverage": {
      "$ref": "#/$defs/coverage"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$defs": {
    "ruleId": {
      "type": "string",
      "pattern": "^HIF-(?:WEB|IMG|MAN)-[0-9]{3}$"
    },
    "finding": {
      "type": "object",
      "additionalProperties": false,
      "required": ["ruleId", "status", "rule"],
      "properties": {
        "ruleId": {
          "$ref": "#/$defs/ruleId"
        },
        "status": {
          "enum": ["fail", "warning", "review"]
        },
        "severity": {
          "enum": ["critical", "high", "medium", "low"]
        },
        "evidence": {
          "type": "string"
        },
        "value": {
          "type": ["string", "number", "boolean", "null"]
        },
        "rule": {
          "$ref": "#/$defs/rule"
        }
      }
    },
    "rule": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "category",
        "defaultSeverity",
        "evidenceLevel",
        "title",
        "rationale",
        "remediation",
        "references"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/ruleId"
        },
        "category": {
          "enum": [
            "accessibility",
            "content",
            "interaction",
            "responsive",
            "visual",
            "performance",
            "semantics",
            "trust",
            "internationalisation",
            "legal"
          ]
        },
        "defaultSeverity": {
          "enum": ["critical", "high", "medium", "low"]
        },
        "evidenceLevel": {
          "enum": ["measured", "detected", "inferred", "manual"]
        },
        "title": {
          "$ref": "#/$defs/localisedText"
        },
        "rationale": {
          "$ref": "#/$defs/localisedText"
        },
        "remediation": {
          "$ref": "#/$defs/localisedText"
        },
        "references": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "string"
          }
        }
      }
    },
    "localisedText": {
      "type": "object",
      "additionalProperties": false,
      "required": ["en", "ru"],
      "properties": {
        "en": {
          "type": "string",
          "minLength": 1
        },
        "ru": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "metric": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "label", "value"],
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
        },
        "label": {
          "type": "string",
          "minLength": 1
        },
        "value": {
          "type": ["string", "number"]
        },
        "unit": {
          "type": "string"
        }
      }
    },
    "coverage": {
      "type": "object",
      "additionalProperties": false,
      "required": ["detected", "measured", "inferred", "manual", "limitations"],
      "properties": {
        "detected": {
          "type": "integer",
          "minimum": 0
        },
        "measured": {
          "type": "integer",
          "minimum": 0
        },
        "inferred": {
          "type": "integer",
          "minimum": 0
        },
        "manual": {
          "type": "integer",
          "minimum": 0
        },
        "limitations": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "string"
          }
        }
      }
    }
  }
}
