gentle-pi 1.2.0 → 2.0.0

package/contracts/review-integration/v2/fixtures/capabilities.fixture.json

@@ -0,0 +1,111 @@
+{
+  "schema": "gentle-ai.review-integration.capabilities/v2",
+  "contract": "gentle-ai.review-integration/v2",
+  "protocol": {"major": 2, "minor": 0},
+  "package": {"name": "gentle-ai", "version": "2.1.7-test", "release_channel": "prerelease"},
+  "build": {
+    "id": "sha256:444a9f0608eb22c4697fd2092f3afcfab040c0918343e7e04087730fd33fd5e1",
+    "go_version": "go1.25.10",
+    "module_version": "v2.1.7",
+    "vcs": "git",
+    "vcs_revision": "0123456789abcdef0123456789abcdef01234567",
+    "vcs_time": "2026-07-15T18:00:00Z",
+    "vcs_modified": "false"
+  },
+  "executable": {
+    "sha256": "sha256:dcc846103b16d365eaeeb9d7f289c23fc4f2897f23def1cb3fe7f05557b64705",
+    "evidence": "self-reported",
+    "verification": "compare-with-published-manifest"
+  },
+  "operations": [
+    "review.bind_sdd", "review.capabilities", "review.finalize", "review.repair",
+    "review.retry_final_verification", "review.start", "review.status", "review.validate"
+  ],
+  "gates": ["post-apply", "pre-commit", "pre-push", "pre-pr", "release"],
+  "projections": ["staged", "workspace"],
+  "schemas": [
+    "gentle-ai.review-admitted-result/v2",
+    "gentle-ai.review-artifact-subject/v2",
+    "gentle-ai.review-authority-repair-assessment/v1",
+    "gentle-ai.review-authority-status/v1",
+    "gentle-ai.review-gate-request/v1",
+    "gentle-ai.review-integration.capabilities/v2",
+    "gentle-ai.review-integration.failure/v2",
+    "gentle-ai.review-final-verification-incident/v1",
+    "gentle-ai.review-integration.operation/v2",
+    "gentle-ai.review-integration.projection/v1",
+    "gentle-ai.review-integration.repair/v2",
+    "gentle-ai.review-integration.start/v3",
+    "gentle-ai.review-integration.status/v3",
+    "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",
+    "gentle-ai.review-integration.consent/v2"
+  ],
+  "features": {
+    "mandatory": [
+      {"name": "compact_v2_authority", "supported": true, "requires": []},
+      {"name": "exact_receipt_replay", "supported": true, "requires": ["compact_v2_authority"]},
+      {"name": "five_delivery_gates", "supported": true, "requires": ["compact_v2_authority"]},
+      {"name": "immutable_snapshot", "supported": true, "requires": []},
+      {"name": "legacy_v1_target_scoped_read_only", "supported": true, "requires": ["target_scoped_status"]},
+      {"name": "repository_independent_capabilities", "supported": true, "requires": []},
+      {"name": "restart_safe_projection", "supported": true, "requires": ["target_scoped_status"]},
+      {"name": "sdd_receipt_binding", "supported": true, "requires": ["compact_v2_authority"]},
+      {"name": "target_scoped_status", "supported": true, "requires": ["repository_independent_capabilities"]},
+      {"name": "uniform_failure_envelope", "supported": true, "requires": ["repository_independent_capabilities"]}
+    ],
+    "optional": [
+      {"name": "base_ref_workspace_overlay", "supported": true, "requires": ["immutable_snapshot", "restart_safe_projection"]},
+      {"name": "bounded_process_waits", "supported": true, "requires": ["uniform_failure_envelope"]},
+      {"name": "classified_authority_repair", "supported": true, "requires": ["native_next_transition", "uniform_failure_envelope"]},
+      {"name": "exact_gate_receipt_discovery", "supported": true, "requires": ["five_delivery_gates"]},
+      {"name": "native_frozen_candidate_context", "supported": true, "requires": ["immutable_snapshot"]},
+      {"name": "native_low_risk_verification", "supported": true, "requires": ["compact_v2_authority"]},
+      {"name": "native_next_transition", "supported": true, "requires": ["target_scoped_status"]},
+      {"name": "one_shot_final_verification_retry", "supported": true, "requires": ["compact_v2_authority", "exact_receipt_replay", "native_next_transition"]},
+      {"name": "opaque_repository_context", "supported": true, "requires": ["compact_v2_authority", "native_next_transition"]},
+      {"name": "outcome_bound_verification_evidence", "supported": true, "requires": ["compact_v2_authority", "native_next_transition"]},
+      {"name": "provider_artifact_admission", "supported": true, "requires": ["compact_v2_authority", "native_frozen_candidate_context", "opaque_repository_context"]},
+      {"name": "provider_targeted_validation_request", "supported": true, "requires": ["compact_v2_authority", "native_next_transition"]},
+      {"name": "recovered_correction_evidence", "supported": true, "requires": ["compact_v2_authority", "provider_targeted_validation_request"]},
+      {"name": "risk_reasons", "supported": true, "requires": ["repository_independent_capabilities"]},
+      {"name": "scope_change_diagnostics", "supported": true, "requires": ["uniform_failure_envelope"]},
+      {"name": "validating_result_reopen", "supported": true, "requires": ["compact_v2_authority", "provider_artifact_admission"]},
+      {"name": "provider_bound_native_git_context", "supported": true, "requires": ["native_frozen_candidate_context", "opaque_repository_context", "provider_artifact_admission"]}
+    ]
+  },
+  "bootstrap": {
+    "command": "gentle-ai review status --cwd \u003crepo\u003e --contract gentle-ai.review-integration/v2 --next-transition",
+    "target_selector_variants": [
+      {"target_type": "staged", "arguments": ["--projection", "staged"]},
+      {"target_type": "base_ref", "arguments": ["--base-ref", "\u003cref\u003e"]},
+      {"target_type": "workspace_overlay_base_ref", "arguments": ["--workspace-overlay", "--base-ref", "\u003cref\u003e"]},
+      {"target_type": "workspace_overlay_base_tree", "arguments": ["--workspace-overlay", "--base-tree", "\u003ctree\u003e"]}
+    ],
+    "required_feature": "native_next_transition",
+    "unsupported_outcome": "unsupported-capability",
+    "parent_only": true
+  },
+  "compatibility": {
+    "minimum_protocol_major": 2,
+    "maximum_protocol_major": 2,
+    "additive_minor_policy": "optional-fields-only",
+    "unknown_mandatory": "reject",
+    "unknown_optional": "ignore",
+    "modes": ["compact-v2", "legacy-v1"],
+    "legacy_window": {
+      "mode": "legacy-v1",
+      "state": "active",
+      "read_only": true,
+      "deprecation_started": true,
+      "removal": "not-scheduled",
+      "minimum_compatibility_releases": 1
+    }
+  }
+}

package/contracts/review-integration/v2/fixtures/consent.fixture.json

@@ -0,0 +1,36 @@
+{
+  "schema": "gentle-ai.review-integration.consent/v2",
+  "contract": "gentle-ai.review-integration/v2",
+  "operation": "review.start",
+  "action": "consent_required",
+  "blocking": true,
+  "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+  "projection": "workspace",
+  "risk_level": "high",
+  "changed_files": 1,
+  "changed_lines": 1,
+  "headline": "Gentle AI can review this change before you call it done.",
+  "reason": "this change gets a deeper review because it touches shell scripting in scripts/deploy.sh.",
+  "value": "Reviewing takes a bit longer, and it makes the result substantially safer.",
+  "risk_evidence": [
+    "shell scripting in scripts/deploy.sh"
+  ],
+  "choices": [
+    {
+      "answer": "granted",
+      "label": "Run the review now",
+      "effect": "Reviews this exact frozen candidate now; nothing is granted for later candidates, so each later medium- or high-risk candidate asks again.",
+      "invocation": "gentle-ai review start --contract gentle-ai.review-integration/v2 --cwd /repo --target sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5 --projection workspace --lineage review-consent-fixture --consent granted"
+    },
+    {
+      "answer": "declined",
+      "label": "Not now, just this once",
+      "effect": "Skips the review for this candidate only; nothing is persisted and the next candidate is asked again. This is not the kill switch.",
+      "invocation": "gentle-ai review start --contract gentle-ai.review-integration/v2 --cwd /repo --target sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5 --projection workspace --lineage review-consent-fixture --consent declined"
+    }
+  ],
+  "off_path": {
+    "note": "To turn reviews off for good, run 'gentle-ai review mode disable'.",
+    "command": "gentle-ai review mode disable"
+  }
+}

package/contracts/review-integration/v2/fixtures/start.fixture.json

@@ -0,0 +1,93 @@
+{
+  "schema": "gentle-ai.review-integration.start/v3",
+  "contract": "gentle-ai.review-integration/v2",
+  "operation": "review.start",
+  "action": "created",
+  "lenses_required": true,
+  "lineage_id": "review-start-fixture",
+  "state": "reviewing",
+  "risk_level": "high",
+  "selected_lenses": [
+    "review-risk",
+    "review-resilience",
+    "review-readability",
+    "review-reliability"
+  ],
+  "projection": "workspace",
+  "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+  "candidate_tree": "556e838994d4e5669ffafda7b72226598bc38297",
+  "changed_files": 1,
+  "changed_lines": 1,
+  "correction_budget": 1,
+  "risk_reasons": [
+    {"code": "shell_source", "signal": "shell_process", "path": "scripts/deploy.sh"}
+  ],
+  "artifact_subjects": [
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:2ec775b2a519da488fd76212470e9e42160179e394cfae2819f1f8ac3c7842e0",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+      "candidate_tree": "556e838994d4e5669ffafda7b72226598bc38297",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-risk",
+      "selected_order": 0
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:1800117ac48276e0039e3791287aed7af08ee65112476f9f0cbe5d11ca1044fe",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+      "candidate_tree": "556e838994d4e5669ffafda7b72226598bc38297",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-resilience",
+      "selected_order": 1
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:b426bc54f5f4f3ea446a84b7957e14492c803e8748f07425cd2e0652b485d7a5",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+      "candidate_tree": "556e838994d4e5669ffafda7b72226598bc38297",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-readability",
+      "selected_order": 2
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:1b43f90a9391e996e28d478c0aef85b1fd26229c1ccb2ef8bc56b418ab0b4a7f",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+      "candidate_tree": "556e838994d4e5669ffafda7b72226598bc38297",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-reliability",
+      "selected_order": 3
+    }
+  ],
+  "changed_path_manifest": [
+    {
+      "path": "scripts/deploy.sh",
+      "status": "A",
+      "old_mode": "000000",
+      "new_mode": "100644",
+      "deleted": false,
+      "type_changed": false,
+      "mode_only": false,
+      "intended_untracked": true
+    }
+  ],
+  "repository_context": {
+    "capability": "review.opaque_repository_context",
+    "handle": "rctx1_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+    "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5"
+  }
+}

package/contracts/review-integration/v2/fixtures/status.fixture.json

@@ -0,0 +1,113 @@
+{
+  "schema": "gentle-ai.review-integration.status/v3",
+  "contract": "gentle-ai.review-integration/v2",
+  "operation": "review.status",
+  "applicability": "current_target",
+  "authority": {
+    "version": "compact-v2",
+    "lineage_id": "review-status-fixture",
+    "state": "reviewing",
+    "generation": 1,
+    "revision": "sha256:81cdad8f3182d4919147d3c4fe8f614814068e5ef68417e3dcbd5e326dd3e390"
+  },
+  "receipt": {"status": "expected_missing"},
+  "action": "finalize",
+  "replayability": "not_replayable",
+  "frozen": {"tier": "medium", "original_changed_lines": 2, "correction_budget": 1},
+  "target_identity": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6",
+  "projection": {
+    "schema": "gentle-ai.review-integration.projection/v1",
+    "kind": "current-changes",
+    "projection": "workspace",
+    "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+    "initial_review_tree": "1c3325617279b38743f073302ba190fc421b5a09",
+    "current_candidate_tree": "1c3325617279b38743f073302ba190fc421b5a09",
+    "paths_digest": "sha256:b93fca961a97d240c2b7023e98772f49ebd2995eda7db07043270b57bed75d71",
+    "paths": ["tracked.txt"],
+    "intended_untracked": [],
+    "intended_untracked_proof": "sha256:b97229718d4c7fe50a8892eb474ae5aa6491697bccb400e3e31dbaca4894d2f3",
+    "initial_snapshot_identity": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6",
+    "current_snapshot_identity": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6"
+  },
+  "repair": {
+    "schema": "gentle-ai.review-authority-repair-assessment/v1",
+    "status": "unsupported",
+    "counts": {
+      "lineages": 0,
+      "compact_lineages": 0,
+      "legacy_lineages": 0,
+      "events": 0,
+      "bytes": 0,
+      "eligible_candidates": 0,
+      "unsupported_lineages": 0,
+      "conflicts": 0
+    },
+    "supported_operations": ["review/complete-fix", "review/validate-fix"],
+    "authorization_schema": "gentle-ai.review-repair-authorization/v1"
+  },
+  "candidates": [],
+  "next_transition": {
+    "kind": "collect",
+    "reason_code": "reviewer_results_required",
+    "collect": {
+      "inputs": [
+        {
+          "name": "reviewer_result",
+          "schema": "https://gentle-ai.dev/schema/review/reviewer/v1",
+          "capture_operation": "review.capture-result",
+          "arguments": [
+            {"name": "lineage", "value": "review-status-fixture", "token": "--lineage=review-status-fixture"},
+            {
+              "name": "expected-revision",
+              "value": "sha256:81cdad8f3182d4919147d3c4fe8f614814068e5ef68417e3dcbd5e326dd3e390",
+              "token": "--expected-revision=sha256:81cdad8f3182d4919147d3c4fe8f614814068e5ef68417e3dcbd5e326dd3e390"
+            },
+            {
+              "name": "target",
+              "value": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6",
+              "token": "--target=sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6"
+            },
+            {
+              "name": "repository-context",
+              "value": "rctx1_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+              "token": "--repository-context=rctx1_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+            },
+            {"name": "lens", "value": "review-reliability", "token": "--lens=review-reliability"},
+            {"name": "order", "value": "0", "token": "--order=0"},
+            {
+              "name": "subject-hash",
+              "value": "sha256:34c226ef1586f0c77b30311320d4d2529819097fbb073ee31634f4d87a19da6a",
+              "token": "--subject-hash=sha256:34c226ef1586f0c77b30311320d4d2529819097fbb073ee31634f4d87a19da6a"
+            }
+          ],
+          "artifact_subject": {
+            "schema": "gentle-ai.review-artifact-subject/v2",
+            "subject_hash": "sha256:34c226ef1586f0c77b30311320d4d2529819097fbb073ee31634f4d87a19da6a",
+            "lineage_id": "review-status-fixture",
+            "authority_revision": "sha256:81cdad8f3182d4919147d3c4fe8f614814068e5ef68417e3dcbd5e326dd3e390",
+            "target_identity": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6",
+            "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+            "candidate_tree": "1c3325617279b38743f073302ba190fc421b5a09",
+            "changed_path_manifest_sha256": "sha256:64d028ff676fb4ef10f2d4a3488d568854b364b4cc4399578b5932d144d2347b",
+            "lens": "review-reliability",
+            "selected_order": 0
+          },
+          "base_tree": "3e21a205dd9b55021aeae87965092623807e455f",
+          "candidate_tree": "1c3325617279b38743f073302ba190fc421b5a09",
+          "changed_path_manifest": [
+            {
+              "path": "tracked.txt",
+              "status": "M",
+              "old_mode": "100644",
+              "new_mode": "100644",
+              "deleted": false,
+              "type_changed": false,
+              "mode_only": false,
+              "intended_untracked": false
+            }
+          ]
+        }
+      ]
+    }
+  }
+}

package/contracts/review-integration/v2/schemas/admitted-result.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v2/schemas/admitted-result.schema.json",
+  "title": "Gentle AI provider-admitted native Git reviewer result v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "subject", "admission", "result"],
+  "properties": {
+    "schema": {"const": "gentle-ai.review-admitted-result/v2"},
+    "subject": {"$ref": "artifact-subject.schema.json"},
+    "admission": {"$ref": "../../v1/schemas/admitted-result.schema.json#/$defs/admission"},
+    "result": {"type": "object"}
+  }
+}

package/contracts/review-integration/v2/schemas/artifact-subject.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v2/schemas/artifact-subject.schema.json",
+  "title": "Gentle AI provider-owned native Git reviewer artifact subject v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "subject_hash",
+    "lineage_id",
+    "authority_revision",
+    "target_identity",
+    "base_tree",
+    "candidate_tree",
+    "changed_path_manifest_sha256",
+    "lens",
+    "selected_order"
+  ],
+  "properties": {
+    "schema": {"const": "gentle-ai.review-artifact-subject/v2"},
+    "subject_hash": {"$ref": "#/$defs/sha256"},
+    "lineage_id": {"type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"},
+    "authority_revision": {"$ref": "#/$defs/sha256"},
+    "target_identity": {"$ref": "#/$defs/sha256"},
+    "base_tree": {"$ref": "#/$defs/git_tree"},
+    "candidate_tree": {"$ref": "#/$defs/git_tree"},
+    "changed_path_manifest_sha256": {"$ref": "#/$defs/sha256"},
+    "lens": {"enum": ["review-risk", "review-resilience", "review-readability", "review-reliability"]},
+    "selected_order": {"type": "integer", "minimum": 0, "maximum": 3},
+    "correction_target_identity": {"$ref": "#/$defs/sha256"}
+  },
+  "$defs": {
+    "sha256": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
+    "git_tree": {"type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$"}
+  }
+}

package/contracts/review-integration/v2/schemas/capabilities.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v2/schemas/capabilities.schema.json",
+  "title": "Gentle AI review integration capabilities protocol 2.0",
+  "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/v2"},
+    "contract": {"const": "gentle-ai.review-integration/v2"},
+    "protocol": {
+      "type": "object", "additionalProperties": false, "required": ["major", "minor"],
+      "properties": {"major": {"const": 2}, "minor": {"const": 0}}
+    },
+    "package": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/package"},
+    "build": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/build"},
+    "executable": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/executable"},
+    "operations": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/operations"},
+    "gates": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/gates"},
+    "projections": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/projections"},
+    "schemas": {
+      "type": "array", "minItems": 22, "maxItems": 22, "uniqueItems": true,
+      "items": {
+        "enum": [
+          "gentle-ai.review-admitted-result/v2",
+          "gentle-ai.review-artifact-subject/v2",
+          "gentle-ai.review-authority-repair-assessment/v1",
+          "gentle-ai.review-authority-status/v1",
+          "gentle-ai.review-gate-request/v1",
+          "gentle-ai.review-integration.capabilities/v2",
+          "gentle-ai.review-integration.consent/v2",
+          "gentle-ai.review-integration.failure/v2",
+          "gentle-ai.review-final-verification-incident/v1",
+          "gentle-ai.review-integration.operation/v2",
+          "gentle-ai.review-integration.projection/v1",
+          "gentle-ai.review-integration.repair/v2",
+          "gentle-ai.review-integration.start/v3",
+          "gentle-ai.review-integration.status/v3",
+          "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": {"type": "array", "minItems": 10, "maxItems": 10, "items": {"$ref": "#/$defs/feature"}},
+        "optional": {"type": "array", "minItems": 17, "maxItems": 17, "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": 2},
+        "maximum_protocol_major": {"const": 2},
+        "additive_minor_policy": {"const": "optional-fields-only"},
+        "unknown_mandatory": {"const": "reject"},
+        "unknown_optional": {"const": "ignore"},
+        "modes": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/compatibility/properties/modes"},
+        "legacy_window": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/properties/compatibility/properties/legacy_window"}
+      }
+    }
+  },
+  "$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_bound_native_git_context", "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/v2 --next-transition"},
+        "target_selector_variants": {"$ref": "../../v1/schemas/capabilities-v1.4.schema.json#/$defs/bootstrap/properties/target_selector_variants"},
+        "required_feature": {"const": "native_next_transition"},
+        "unsupported_outcome": {"const": "unsupported-capability"},
+        "parent_only": {"const": true}
+      }
+    }
+  }
+}

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

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v2/schemas/consent.schema.json",
+  "title": "Gentle AI negotiated review v2 consent question",
+  "description": "The typed per-candidate blocking consent question emitted by negotiated v2 START when the caller declared --consent relay.",
+  "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/v2"},
+    "contract": {"const": "gentle-ai.review-integration/v2"},
+    "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 --contract gentle-ai\\.review-integration/v2 .* --consent (granted|declined)$"}
+      }
+    },
+    "choice_granted": {
+      "allOf": [{"$ref": "#/$defs/choice"}],
+      "properties": {"answer": {"const": "granted"}}
+    },
+    "choice_declined": {
+      "allOf": [{"$ref": "#/$defs/choice"}],
+      "properties": {"answer": {"const": "declined"}}
+    }
+  }
+}

package/contracts/review-integration/v2/schemas/failure.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gentle-ai.dev/contracts/review-integration/v2/schemas/failure.schema.json",
+  "title": "Gentle AI negotiated review v2 failure",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema", "contract", "operation", "phase", "code", "message", "mutation_outcome",
+    "authority_applicability", "retry_safe", "replayability", "required_inputs", "next_action"
+  ],
+  "properties": {
+    "schema": {"const": "gentle-ai.review-integration.failure/v2"},
+    "contract": {"const": "gentle-ai.review-integration/v2"},
+    "operation": {"$ref": "../../v1/schemas/failure.schema.json#/properties/operation"},
+    "phase": {"$ref": "../../v1/schemas/failure.schema.json#/properties/phase"},
+    "code": {"$ref": "../../v1/schemas/failure.schema.json#/properties/code"},
+    "message": {"$ref": "../../v1/schemas/failure.schema.json#/properties/message"},
+    "mutation_outcome": {"$ref": "../../v1/schemas/failure.schema.json#/properties/mutation_outcome"},
+    "authority_applicability": {"$ref": "../../v1/schemas/failure.schema.json#/properties/authority_applicability"},
+    "retry_safe": {"type": "boolean"},
+    "replayability": {"$ref": "../../v1/schemas/failure.schema.json#/properties/replayability"},
+    "lineage_id": {"$ref": "../../v1/schemas/failure.schema.json#/properties/lineage_id"},
+    "request_digest": {"$ref": "../../v1/schemas/failure.schema.json#/properties/request_digest"},
+    "progress_identity": {"$ref": "../../v1/schemas/failure.schema.json#/properties/progress_identity"},
+    "required_inputs": {"$ref": "../../v1/schemas/failure.schema.json#/properties/required_inputs"},
+    "next_action": {"$ref": "../../v1/schemas/failure.schema.json#/properties/next_action"},
+    "cause_category": {"$ref": "../../v1/schemas/failure.schema.json#/properties/cause_category"},
+    "cause": {"$ref": "../../v1/schemas/failure.schema.json#/properties/cause"},
+    "context": {"$ref": "../../v1/schemas/failure.schema.json#/properties/context"}
+  },
+  "allOf": [
+    {"$ref": "../../v1/schemas/failure.schema.json#/allOf/0"},
+    {"$ref": "../../v1/schemas/failure.schema.json#/allOf/1"}
+  ]
+}