gentle-pi 1.2.0 → 2.1.0

package/contracts/review-integration/v1/schemas/capabilities-v1.3.schema.json

@@ -0,0 +1,429 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v1/schemas/capabilities-v1.3.schema.json",
+  "title": "Gentle AI review integration capabilities protocol 1.3",
+  "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.3"
+    },
+    "contract": {
+      "const": "gentle-ai.review-integration/v1"
+    },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "major",
+        "minor"
+      ],
+      "properties": {
+        "major": {
+          "const": 1
+        },
+        "minor": {
+          "const": 3
+        }
+      }
+    },
+    "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": 7,
+      "maxItems": 7,
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "review.bind_sdd",
+          "review.capabilities",
+          "review.finalize",
+          "review.repair",
+          "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": 19,
+      "maxItems": 19,
+      "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.3",
+          "gentle-ai.review-integration.failure/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": 14,
+          "maxItems": 14,
+          "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",
+            "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
+          }
+        }
+      }
+    }
+  }
+}