{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://gentle-ai.dev/contracts/review-integration/v1/schemas/capabilities-v1.4.schema.json",
  "title": "Gentle AI review integration capabilities protocol 1.4",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema",
    "contract",
    "protocol",
    "package",
    "build",
    "executable",
    "operations",
    "gates",
    "projections",
    "schemas",
    "features",
    "compatibility"
  ],
  "properties": {
    "schema": {
      "const": "gentle-ai.review-integration.capabilities/v1.4"
    },
    "contract": {
      "const": "gentle-ai.review-integration/v1"
    },
    "protocol": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "major",
        "minor"
      ],
      "properties": {
        "major": {
          "const": 1
        },
        "minor": {
          "const": 4
        }
      }
    },
    "package": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "version",
        "release_channel"
      ],
      "properties": {
        "name": {
          "const": "gentle-ai"
        },
        "version": {
          "type": "string",
          "minLength": 1
        },
        "release_channel": {
          "enum": [
            "development",
            "prerelease",
            "stable"
          ]
        }
      }
    },
    "build": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "go_version",
        "module_version",
        "vcs",
        "vcs_revision",
        "vcs_time",
        "vcs_modified"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/sha256"
        },
        "go_version": {
          "type": "string",
          "minLength": 1
        },
        "module_version": {
          "type": "string"
        },
        "vcs": {
          "type": "string"
        },
        "vcs_revision": {
          "type": "string"
        },
        "vcs_time": {
          "type": "string"
        },
        "vcs_modified": {
          "enum": [
            "true",
            "false",
            "unknown"
          ]
        }
      }
    },
    "executable": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "sha256",
        "evidence",
        "verification"
      ],
      "properties": {
        "sha256": {
          "$ref": "#/$defs/sha256"
        },
        "evidence": {
          "const": "self-reported"
        },
        "verification": {
          "const": "compare-with-published-manifest"
        }
      }
    },
    "operations": {
      "type": "array",
      "minItems": 8,
      "maxItems": 8,
      "uniqueItems": true,
      "items": {
        "enum": [
          "review.bind_sdd",
          "review.capabilities",
          "review.finalize",
          "review.repair",
          "review.retry_final_verification",
          "review.start",
          "review.status",
          "review.validate"
        ]
      }
    },
    "gates": {
      "type": "array",
      "minItems": 5,
      "maxItems": 5,
      "uniqueItems": true,
      "items": {
        "enum": [
          "post-apply",
          "pre-commit",
          "pre-push",
          "pre-pr",
          "release"
        ]
      }
    },
    "projections": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "uniqueItems": true,
      "items": {
        "enum": [
          "staged",
          "workspace"
        ]
      }
    },
    "schemas": {
      "type": "array",
      "minItems": 20,
      "maxItems": 20,
      "uniqueItems": true,
      "items": {
        "enum": [
          "gentle-ai.review-admitted-result/v1",
          "gentle-ai.review-artifact-subject/v1",
          "gentle-ai.review-authority-repair-assessment/v1",
          "gentle-ai.review-authority-status/v1",
          "gentle-ai.review-gate-request/v1",
          "gentle-ai.review-integration.capabilities/v1.4",
          "gentle-ai.review-integration.failure/v1",
          "gentle-ai.review-final-verification-incident/v1",
          "gentle-ai.review-integration.operation/v1",
          "gentle-ai.review-integration.projection/v1",
          "gentle-ai.review-integration.repair/v1",
          "gentle-ai.review-integration.start/v2",
          "gentle-ai.review-integration.status/v2",
          "gentle-ai.review-receipt/v1",
          "gentle-ai.review-receipt/v2",
          "gentle-ai.review-result-artifact/v2",
          "gentle-ai.review-targeted-validation-request/v1",
          "https://gentle-ai.dev/schema/review/refuter/v1",
          "https://gentle-ai.dev/schema/review/reviewer/v1",
          "https://gentle-ai.dev/schema/review/validator/v1"
        ]
      }
    },
    "features": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "mandatory",
        "optional"
      ],
      "properties": {
        "mandatory": {
          "type": "array",
          "minItems": 10,
          "maxItems": 10,
          "items": {
            "$ref": "#/$defs/feature"
          }
        },
        "optional": {
          "type": "array",
          "minItems": 15,
          "maxItems": 15,
          "items": {
            "$ref": "#/$defs/feature"
          }
        }
      }
    },
    "bootstrap": {
      "$ref": "#/$defs/bootstrap"
    },
    "compatibility": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "minimum_protocol_major",
        "maximum_protocol_major",
        "additive_minor_policy",
        "unknown_mandatory",
        "unknown_optional",
        "modes",
        "legacy_window"
      ],
      "properties": {
        "minimum_protocol_major": {
          "const": 1
        },
        "maximum_protocol_major": {
          "const": 1
        },
        "additive_minor_policy": {
          "const": "optional-fields-only"
        },
        "unknown_mandatory": {
          "const": "reject"
        },
        "unknown_optional": {
          "const": "ignore"
        },
        "modes": {
          "type": "array",
          "prefixItems": [
            {
              "const": "compact-v2"
            },
            {
              "const": "legacy-v1"
            }
          ],
          "items": false
        },
        "legacy_window": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "mode",
            "state",
            "read_only",
            "deprecation_started",
            "removal",
            "minimum_compatibility_releases"
          ],
          "properties": {
            "mode": {
              "const": "legacy-v1"
            },
            "state": {
              "enum": [
                "pre-fence",
                "active",
                "deprecated",
                "expired"
              ]
            },
            "read_only": {
              "type": "boolean"
            },
            "deprecation_started": {
              "type": "boolean"
            },
            "removal": {
              "type": "string",
              "minLength": 1
            },
            "minimum_compatibility_releases": {
              "type": "integer",
              "minimum": 1
            }
          }
        }
      }
    }
  },
  "$defs": {
    "sha256": {
      "type": "string",
      "pattern": "^sha256:[0-9a-f]{64}$"
    },
    "feature": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "supported",
        "requires"
      ],
      "properties": {
        "name": {
          "enum": [
            "base_ref_workspace_overlay",
            "bounded_process_waits",
            "classified_authority_repair",
            "compact_v2_authority",
            "exact_gate_receipt_discovery",
            "exact_receipt_replay",
            "five_delivery_gates",
            "immutable_snapshot",
            "legacy_v1_target_scoped_read_only",
            "native_frozen_candidate_context",
            "native_low_risk_verification",
            "native_next_transition",
            "one_shot_final_verification_retry",
            "opaque_repository_context",
            "provider_artifact_admission",
            "provider_targeted_validation_request",
            "recovered_correction_evidence",
            "repository_independent_capabilities",
            "restart_safe_projection",
            "risk_reasons",
            "scope_change_diagnostics",
            "sdd_receipt_binding",
            "target_scoped_status",
            "uniform_failure_envelope",
            "validating_result_reopen"
          ]
        },
        "supported": {
          "type": "boolean"
        },
        "requires": {
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "bootstrap": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "command",
        "target_selector_variants",
        "required_feature",
        "unsupported_outcome",
        "parent_only"
      ],
      "properties": {
        "command": {
          "const": "gentle-ai review status --cwd <repo> --contract gentle-ai.review-integration/v1 --next-transition"
        },
        "target_selector_variants": {
          "type": "array",
          "minItems": 4,
          "maxItems": 4,
          "items": {
            "$ref": "#/$defs/target_selector"
          }
        },
        "required_feature": {
          "const": "native_next_transition"
        },
        "unsupported_outcome": {
          "const": "unsupported-capability"
        },
        "parent_only": {
          "const": true
        }
      }
    },
    "target_selector": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "target_type",
        "arguments"
      ],
      "properties": {
        "target_type": {
          "enum": [
            "staged",
            "base_ref",
            "workspace_overlay_base_ref",
            "workspace_overlay_base_tree"
          ]
        },
        "arguments": {
          "type": "array",
          "minItems": 2,
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    }
  }
}
