gentle-pi 1.2.0 → 2.0.0

package/contracts/review-integration/v1/schemas/authority-repair-assessment.schema.json

@@ -0,0 +1,247 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v1/schemas/authority-repair-assessment.schema.json",
+  "title": "Gentle AI classified authority repair assessment",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "status",
+    "counts",
+    "supported_operations",
+    "authorization_schema"
+  ],
+  "properties": {
+    "schema": {
+      "const": "gentle-ai.review-authority-repair-assessment/v1"
+    },
+    "status": {
+      "enum": [
+        "eligible",
+        "unsupported",
+        "ambiguous",
+        "conflicting",
+        "truncated"
+      ]
+    },
+    "class": {
+      "const": "legacy_v1_historical_alias"
+    },
+    "cause": {
+      "const": "unsupported_historical_v1_operation_alias"
+    },
+    "disposition": {
+      "const": "quarantine-approved-historical-alias"
+    },
+    "repository_binding": {
+      "$ref": "#/$defs/sha256"
+    },
+    "candidate": {
+      "$ref": "#/$defs/candidate"
+    },
+    "counts": {
+      "$ref": "#/$defs/counts"
+    },
+    "supported_operations": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "prefixItems": [
+        {
+          "const": "review/complete-fix"
+        },
+        {
+          "const": "review/validate-fix"
+        }
+      ],
+      "items": false
+    },
+    "authorization_schema": {
+      "const": "gentle-ai.review-repair-authorization/v1"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "status": {
+            "const": "eligible"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "then": {
+        "required": [
+          "class",
+          "cause",
+          "disposition",
+          "repository_binding",
+          "candidate"
+        ],
+        "properties": {
+          "counts": {
+            "allOf": [
+              {
+                "$ref": "#/$defs/counts"
+              },
+              {
+                "properties": {
+                  "eligible_candidates": {
+                    "const": 1
+                  },
+                  "unsupported_lineages": {
+                    "const": 0
+                  },
+                  "conflicts": {
+                    "const": 0
+                  }
+                }
+              }
+            ]
+          }
+        }
+      },
+      "else": {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "class"
+              ]
+            },
+            {
+              "required": [
+                "cause"
+              ]
+            },
+            {
+              "required": [
+                "disposition"
+              ]
+            },
+            {
+              "required": [
+                "repository_binding"
+              ]
+            },
+            {
+              "required": [
+                "candidate"
+              ]
+            }
+          ]
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "lineage_id",
+        "revision",
+        "chain_identity",
+        "event_count",
+        "alias_event_count",
+        "operations"
+      ],
+      "properties": {
+        "lineage_id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "revision": {
+          "$ref": "#/$defs/sha256"
+        },
+        "chain_identity": {
+          "$ref": "#/$defs/sha256"
+        },
+        "event_count": {
+          "type": "integer",
+          "minimum": 2,
+          "maximum": 1024
+        },
+        "alias_event_count": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1024
+        },
+        "operations": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 2,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "review/complete-fix",
+              "review/validate-fix"
+            ]
+          }
+        }
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "lineages",
+        "compact_lineages",
+        "legacy_lineages",
+        "events",
+        "bytes",
+        "eligible_candidates",
+        "unsupported_lineages",
+        "conflicts"
+      ],
+      "properties": {
+        "lineages": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 256
+        },
+        "compact_lineages": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 256
+        },
+        "legacy_lineages": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 256
+        },
+        "events": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1024
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 8388608
+        },
+        "eligible_candidates": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 256
+        },
+        "unsupported_lineages": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1024
+        },
+        "conflicts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1024
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,249 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v1/schemas/capabilities-v1.2.schema.json",
+  "title": "Gentle AI review integration capabilities protocol 1.2",
+  "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.2"
+    },
+    "contract": {
+      "const": "gentle-ai.review-integration/v1"
+    },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["major", "minor"],
+      "properties": {
+        "major": {"const": 1},
+        "minor": {"const": 2}
+      }
+    },
+    "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": 6,
+      "maxItems": 6,
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "review.bind_sdd",
+          "review.capabilities",
+          "review.finalize",
+          "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": 14,
+      "maxItems": 14,
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "gentle-ai.review-authority-status/v1",
+          "gentle-ai.review-gate-request/v1",
+          "gentle-ai.review-integration.capabilities/v1.2",
+          "gentle-ai.review-integration.failure/v1",
+          "gentle-ai.review-integration.operation/v1",
+          "gentle-ai.review-integration.projection/v1",
+          "gentle-ai.review-integration.start/v1",
+          "gentle-ai.review-integration.status/v1",
+          "gentle-ai.review-receipt/v1",
+          "gentle-ai.review-receipt/v2",
+          "gentle-ai.review-result-artifact/v1",
+          "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": 10,
+          "maxItems": 10,
+          "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",
+            "compact_v2_authority",
+            "exact_receipt_replay",
+            "exact_gate_receipt_discovery",
+            "five_delivery_gates",
+            "immutable_snapshot",
+            "legacy_v1_target_scoped_read_only",
+            "native_frozen_candidate_context",
+            "native_low_risk_verification",
+            "opaque_repository_context",
+            "provider_targeted_validation_request",
+            "repository_independent_capabilities",
+            "restart_safe_projection",
+            "risk_reasons",
+            "sdd_receipt_binding",
+            "scope_change_diagnostics",
+            "native_next_transition",
+            "target_scoped_status",
+            "uniform_failure_envelope"
+          ]
+        },
+        "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}}
+      }
+    }
+  }
+}