{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://workspai.dev/schemas/workspace-intelligence/blocker-resolution.v1.json",
  "title": "Workspai Blocker Resolution Hint",
  "type": "object",
  "required": ["schemaVersion", "blockerId", "resolutionClass", "blockerSignature", "fixHints"],
  "properties": {
    "schemaVersion": {
      "const": "rapidkit-blocker-resolution-v1"
    },
    "blockerId": {
      "type": "string",
      "minLength": 1
    },
    "sourceCommand": {
      "type": "string"
    },
    "sourceArtifact": {
      "type": "string"
    },
    "resolutionClass": {
      "enum": [
        "artifact-missing",
        "command-failed-repeat",
        "config-fixable",
        "semantic-attention",
        "unresolvable-without-human"
      ]
    },
    "blockerSignature": {
      "type": "string",
      "minLength": 8
    },
    "commandRetryHint": {
      "type": "string"
    },
    "fixHints": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["actionKind", "detail"],
        "properties": {
          "actionKind": {
            "enum": ["edit-file", "run-once", "commit-files", "refresh-baseline"]
          },
          "targetPath": { "type": "string" },
          "detail": { "type": "string" },
          "studioActionId": {
            "enum": ["fix-lens", "verify-gates", "run-analyze", "doctor-fix"]
          }
        },
        "additionalProperties": false
      }
    },
    "verifyCommand": { "type": "string" },
    "verifyArtifact": { "type": "string" }
  },
  "additionalProperties": false
}