{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "rstack.dev/validator-contract/v1alpha1",
  "title": "RStack validator contract (validation.json)",
  "description": "The contract sdlc_validate (or an external validator) writes at .rstack/runs/<run_id>/tasks/<task_id>/validation.json. Derived from validateValidatorContract in src/core/harness/contracts.js and the sdlc_validate writer in src/integrations/pi/rstack-sdlc.ts. Tolerant reader: unknown fields are allowed.",
  "type": "object",
  "required": [
    "task_id",
    "validator",
    "status",
    "checks",
    "issues",
    "retry_recommendation"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task this validation belongs to. Must equal the validated task id (validator_task_id_matches)."
    },
    "validator": {
      "type": "string",
      "description": "Validator identity, e.g. 'rstack-pi-extension' or a validator-registry profile name."
    },
    "status": {
      "type": "string",
      "enum": [
        "PASS",
        "FAIL"
      ],
      "description": "VALIDATOR_STATUSES \u2014 validators only PASS or FAIL."
    },
    "checks": {
      "type": "array",
      "description": "Every check evaluated, PASS and FAIL alike.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "PASS | FAIL | WARN \u2014 WARN is used by advisory checks (e.g. review_independence under a warn policy)."
          },
          "evidence": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "issues": {
      "type": "array",
      "description": "The FAIL subset of checks.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "severity": {
            "type": "string",
            "enum": [
              "CRITICAL",
              "HIGH",
              "MEDIUM",
              "LOW"
            ],
            "description": "#561 optional issue severity; when present, retry_recommendation must meet SEVERITY_RETRY_FLOOR (contracts.js)."
          }
        }
      }
    },
    "retry_recommendation": {
      "type": "string",
      "enum": [
        "none",
        "retry_builder",
        "ask_user",
        "block"
      ],
      "description": "RETRY_RECOMMENDATIONS \u2014 drives the deterministic retry policy (src/core/harness/retry-policy.js)."
    },
    "harness": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional reviewer identity (#72)."
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional reviewer model identity (#72)."
    },
    "validator_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional validator taxonomy: architecture | code | test | security | compliance | generic (validatorTypeForStage)."
    },
    "validator_profile": {
      "type": "object",
      "description": "The validator-registry profile that owned this validation (stage_id, validator, model_hint, required_checks).",
      "properties": {
        "stage_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "validator": {
          "type": "string"
        },
        "model_hint": {
          "type": "string"
        },
        "required_checks": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true
    },
    "independence": {
      "type": "object",
      "description": "Review-independence verdict (#72) embedded by sdlc_validate.",
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}