gentle-pi 1.2.0 → 2.0.0

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

@@ -0,0 +1,432 @@
+{
+  "$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
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v1/schemas/capabilities-v1.5.schema.json",
+  "title": "Gentle AI review integration capabilities protocol 1.5",
+  "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.5"
+    },
+    "contract": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/contract"
+    },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["major", "minor"],
+      "properties": {
+        "major": {"const": 1},
+        "minor": {"const": 5}
+      }
+    },
+    "package": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/package"
+    },
+    "build": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/build"
+    },
+    "executable": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/executable"
+    },
+    "operations": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/operations"
+    },
+    "gates": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/gates"
+    },
+    "projections": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/projections"
+    },
+    "schemas": {
+      "type": "array",
+      "minItems": 21,
+      "maxItems": 21,
+      "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.5",
+          "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",
+          "gentle-ai.review-verification-evidence/v2",
+          "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": {
+          "$ref": "capabilities-v1.4.schema.json#/properties/features/properties/mandatory"
+        },
+        "optional": {
+          "type": "array",
+          "minItems": 16,
+          "maxItems": 16,
+          "items": {"$ref": "#/$defs/feature"}
+        }
+      }
+    },
+    "bootstrap": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/bootstrap"
+    },
+    "compatibility": {
+      "$ref": "capabilities-v1.4.schema.json#/properties/compatibility"
+    }
+  },
+  "$defs": {
+    "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",
+            "outcome_bound_verification_evidence",
+            "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}
+        }
+      }
+    }
+  }
+}

package/contracts/review-integration/v1/schemas/consent.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v1/schemas/consent.schema.json",
+  "title": "Gentle AI negotiated review consent question",
+  "description": "The typed per-candidate blocking consent question a negotiated START answers with instead of proceeding, emitted only when the caller declared --consent relay. It carries why input is required, the complete choice set, and the exact runnable follow-up invocations scoped to the one frozen candidate. A decline is scoped to that candidate and is deliberately not the kill switch; the permanent disable stays a documented off path outside the choice set.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "contract",
+    "operation",
+    "action",
+    "blocking",
+    "target_identity",
+    "projection",
+    "risk_level",
+    "changed_files",
+    "changed_lines",
+    "headline",
+    "reason",
+    "value",
+    "risk_evidence",
+    "choices",
+    "off_path"
+  ],
+  "properties": {
+    "schema": {"const": "gentle-ai.review-integration.consent/v1"},
+    "contract": {"const": "gentle-ai.review-integration/v1"},
+    "operation": {"const": "review.start"},
+    "action": {"const": "consent_required"},
+    "blocking": {"const": true},
+    "target_identity": {"$ref": "#/$defs/sha256"},
+    "projection": {"enum": ["workspace", "staged"]},
+    "risk_level": {"enum": ["medium", "high"]},
+    "changed_files": {"type": "integer", "minimum": 0},
+    "changed_lines": {"type": "integer", "minimum": 0},
+    "headline": {"type": "string", "minLength": 1},
+    "reason": {"type": "string", "minLength": 1},
+    "value": {"type": "string", "minLength": 1},
+    "risk_evidence": {
+      "type": "array",
+      "items": {"type": "string", "minLength": 1}
+    },
+    "choices": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "prefixItems": [
+        {"$ref": "#/$defs/choice_granted"},
+        {"$ref": "#/$defs/choice_declined"}
+      ],
+      "items": false
+    },
+    "off_path": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["note", "command"],
+      "properties": {
+        "note": {"type": "string", "minLength": 1},
+        "command": {"const": "gentle-ai review mode disable"}
+      }
+    }
+  },
+  "$defs": {
+    "sha256": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
+    "choice": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["answer", "label", "effect", "invocation"],
+      "properties": {
+        "answer": {"enum": ["granted", "declined"]},
+        "label": {"type": "string", "minLength": 1},
+        "effect": {"type": "string", "minLength": 1},
+        "invocation": {"type": "string", "pattern": "^gentle-ai review start .* --consent (granted|declined)$"}
+      }
+    },
+    "choice_granted": {
+      "allOf": [{"$ref": "#/$defs/choice"}],
+      "properties": {"answer": {"const": "granted"}}
+    },
+    "choice_declined": {
+      "allOf": [{"$ref": "#/$defs/choice"}],
+      "properties": {"answer": {"const": "declined"}}
+    }
+  }
+}