gentle-pi 2.1.2 → 2.2.0

package/tests/fixtures/devbinary/capabilities-v2.2.captured.json

@@ -0,0 +1,340 @@
+{
+  "schema": "gentle-ai.review-integration.capabilities/v2.2",
+  "contract": "gentle-ai.review-integration/v2",
+  "protocol": {
+    "major": 2,
+    "minor": 2
+  },
+  "package": {
+    "name": "gentle-ai",
+    "version": "2.4.0-rc.8+fix.verify-attestation-recovery",
+    "release_channel": "prerelease"
+  },
+  "build": {
+    "id": "sha256:4db874cd6a31fc1bc0deb2b94c22ad4668e878ffc5c0bc9acc2c81bcbe03e054",
+    "go_version": "go1.26.5",
+    "module_version": "(devel)",
+    "vcs": "git",
+    "vcs_revision": "",
+    "vcs_time": "",
+    "vcs_modified": "true"
+  },
+  "executable": {
+    "sha256": "sha256:ffc91d8fa79c869aba9aa3d1ec80edebb5b1744e5a06fef75d4c8b73c0e46bc1",
+    "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.2",
+    "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/v5",
+    "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/v3"
+  ],
+  "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"
+        ]
+      },
+      {
+        "name": "provider_submission_descriptors",
+        "supported": true,
+        "requires": [
+          "native_next_transition",
+          "opaque_repository_context",
+          "provider_targeted_validation_request"
+        ]
+      }
+    ]
+  },
+  "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/tests/fixtures/devbinary/consent-v3.captured.json

@@ -0,0 +1,37 @@
+{
+  "schema": "gentle-ai.review-integration.consent/v3",
+  "contract": "gentle-ai.review-integration/v2",
+  "operation": "review.start",
+  "action": "consent_required",
+  "agent": "claude-code",
+  "blocking": true,
+  "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+  "projection": "workspace",
+  "risk_level": "high",
+  "changed_files": 2,
+  "changed_lines": 12,
+  "headline": "Gentle AI can review this change before you call it done.",
+  "reason": "this change gets a deeper review because it touches code that starts other processes in internal/runner/runner.go.",
+  "value": "Reviewing takes a bit longer, and it makes the result substantially safer.",
+  "risk_evidence": [
+    "code that starts other processes in internal/runner/runner.go"
+  ],
+  "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 /tmp/claude-1000/-home-gentleman-work-gentle-ai/7629c2de-8b8b-4005-b117-ab45c0869f70/scratchpad/consentcap/repo --target sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988 --projection workspace --consent granted"
+    },
+    {
+      "answer": "declined",
+      "label": "Not now, just this once",
+      "effect": "Skips the review for this exact candidate only; no review lineage or receipt is created, and ordinary delivery is unmanaged by candidate choice. The next candidate is asked again. This is not the kill switch.",
+      "invocation": "gentle-ai review start --contract gentle-ai.review-integration/v2 --cwd /tmp/claude-1000/-home-gentleman-work-gentle-ai/7629c2de-8b8b-4005-b117-ab45c0869f70/scratchpad/consentcap/repo --target sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988 --projection workspace --consent declined"
+    }
+  ],
+  "off_path": {
+    "note": "To turn reviews off for good, run 'gentle-ai review mode disable'.",
+    "command": "gentle-ai review mode disable"
+  }
+}

package/tests/fixtures/devbinary/failure-v2-capture-evidence.captured.json

@@ -0,0 +1,16 @@
+{
+  "schema": "gentle-ai.review-integration.failure/v2",
+  "contract": "gentle-ai.review-integration/v2",
+  "operation": "review.capture-evidence",
+  "phase": "preflight",
+  "code": "verification_evidence_binding_mismatch",
+  "message": "The verification evidence binding does not match the current validating or correction authority; re-derive the exact next transition before retrying.",
+  "mutation_outcome": "not_started",
+  "authority_applicability": "not_evaluated",
+  "retry_safe": true,
+  "replayability": "not_replayable",
+  "lineage_id": "review-ceeb2b862bd39709",
+  "required_inputs": [],
+  "next_action": "review.status",
+  "cause": "verification evidence binding does not match the current validating or correction authority"
+}

package/tests/fixtures/devbinary/result-artifact-v2-path.captured.json

@@ -0,0 +1,12 @@
+{
+  "schema": "gentle-ai.review-result-artifact/v2",
+  "capability": "review.native_result_artifact",
+  "path": "/tmp/claude-1000/-home-gentleman-work-gentle-ai/7629c2de-8b8b-4005-b117-ab45c0869f70/scratchpad/rart-capture/.git/gentle-ai/review-transactions/v2/review-ceeb2b862bd39709/reviewer-results/00-review-reliability.json",
+  "sha256": "sha256:c8b2d0ce70f22ff924447fe591dab4b4008e0b6cd7d4ac884439eaf6e47bd26e",
+  "lineage_id": "review-ceeb2b862bd39709",
+  "target_identity": "sha256:ceeb2b862bd39709a0c1d2642ba89711127de7e859d6c008bf1add73e4dc783e",
+  "lens": "review-reliability",
+  "selected_order": 0,
+  "subject_hash": "sha256:6952f7ea0b589d882201943449b3f4ab9505551ad306460ee7bebc6b4671ae1e",
+  "admission_decision": "completed"
+}

package/tests/fixtures/devbinary/result-artifact-v2.captured.json

@@ -0,0 +1,12 @@
+{
+  "schema": "gentle-ai.review-result-artifact/v2",
+  "capability": "review.native_result_artifact",
+  "reference": "rart1_ade967893b51f2e280f5393f154fe9e232b6cb8c22fd60b2ba65b301e8e23d47",
+  "sha256": "sha256:c8b2d0ce70f22ff924447fe591dab4b4008e0b6cd7d4ac884439eaf6e47bd26e",
+  "lineage_id": "review-ceeb2b862bd39709",
+  "target_identity": "sha256:ceeb2b862bd39709a0c1d2642ba89711127de7e859d6c008bf1add73e4dc783e",
+  "lens": "review-reliability",
+  "selected_order": 0,
+  "subject_hash": "sha256:6952f7ea0b589d882201943449b3f4ab9505551ad306460ee7bebc6b4671ae1e",
+  "admission_decision": "completed"
+}

package/tests/fixtures/devbinary/start-v3-consent-declined.captured.json

@@ -0,0 +1,19 @@
+{
+  "operation": "review/start",
+  "action": "declined",
+  "lenses_required": false,
+  "lineage_id": "",
+  "state": "",
+  "risk_level": "high",
+  "selected_lenses": [],
+  "lens_bindings": [],
+  "projection": "workspace",
+  "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+  "changed_files": 2,
+  "changed_lines": 12,
+  "correction_budget": 0,
+  "risk_evidence": [
+    "code that starts other processes in internal/runner/runner.go"
+  ],
+  "consent": "declined_this_candidate"
+}

package/tests/fixtures/devbinary/start-v3-consent-granted.captured.json

@@ -0,0 +1,109 @@
+{
+  "schema": "gentle-ai.review-integration.start/v3",
+  "contract": "gentle-ai.review-integration/v2",
+  "operation": "review.start",
+  "action": "created",
+  "lenses_required": true,
+  "lineage_id": "review-377c60e10b852cfc",
+  "state": "reviewing",
+  "risk_level": "high",
+  "selected_lenses": [
+    "review-risk",
+    "review-resilience",
+    "review-readability",
+    "review-reliability"
+  ],
+  "projection": "workspace",
+  "base_tree": "6f76421f34880aec8e73618ca7ce69b2f894cb47",
+  "candidate_tree": "b6d3cea0ddd081a71e83120d003953872754a617",
+  "changed_files": 2,
+  "changed_lines": 12,
+  "correction_budget": 6,
+  "risk_reasons": [
+    {
+      "code": "process_boundary",
+      "signal": "shell_process",
+      "path": "internal/runner/runner.go"
+    }
+  ],
+  "artifact_subjects": [
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:83a75b97a02e17dca2a466f2a247466751d3d610ed5b18ea45cc6b258dbc4a31",
+      "lineage_id": "review-377c60e10b852cfc",
+      "authority_revision": "sha256:fe7f383e1b3b0854f8974c94b60597b59a4384c8c6f30c04779d13c6ec32fb66",
+      "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+      "base_tree": "6f76421f34880aec8e73618ca7ce69b2f894cb47",
+      "candidate_tree": "b6d3cea0ddd081a71e83120d003953872754a617",
+      "changed_path_manifest_sha256": "sha256:487bf2f5df250d6f9d76a28fded97bfad6aec57c62f92e2b997bfd9bf25e7a53",
+      "lens": "review-risk",
+      "selected_order": 0
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:5abb925fdd448ca0add3f1ce95e84c9f4742e0c1241bade2bde0b3205f3879d8",
+      "lineage_id": "review-377c60e10b852cfc",
+      "authority_revision": "sha256:fe7f383e1b3b0854f8974c94b60597b59a4384c8c6f30c04779d13c6ec32fb66",
+      "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+      "base_tree": "6f76421f34880aec8e73618ca7ce69b2f894cb47",
+      "candidate_tree": "b6d3cea0ddd081a71e83120d003953872754a617",
+      "changed_path_manifest_sha256": "sha256:487bf2f5df250d6f9d76a28fded97bfad6aec57c62f92e2b997bfd9bf25e7a53",
+      "lens": "review-resilience",
+      "selected_order": 1
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:cbf59cec5a008893a97b46248c214f4c007ac1b9a18052bfd4f478eaf560e04c",
+      "lineage_id": "review-377c60e10b852cfc",
+      "authority_revision": "sha256:fe7f383e1b3b0854f8974c94b60597b59a4384c8c6f30c04779d13c6ec32fb66",
+      "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+      "base_tree": "6f76421f34880aec8e73618ca7ce69b2f894cb47",
+      "candidate_tree": "b6d3cea0ddd081a71e83120d003953872754a617",
+      "changed_path_manifest_sha256": "sha256:487bf2f5df250d6f9d76a28fded97bfad6aec57c62f92e2b997bfd9bf25e7a53",
+      "lens": "review-readability",
+      "selected_order": 2
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v2",
+      "subject_hash": "sha256:4a3d37cc911e1b39b03acb15df07be6e3cb041a6c2d493dd4aa9e7446f4b7dfa",
+      "lineage_id": "review-377c60e10b852cfc",
+      "authority_revision": "sha256:fe7f383e1b3b0854f8974c94b60597b59a4384c8c6f30c04779d13c6ec32fb66",
+      "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+      "base_tree": "6f76421f34880aec8e73618ca7ce69b2f894cb47",
+      "candidate_tree": "b6d3cea0ddd081a71e83120d003953872754a617",
+      "changed_path_manifest_sha256": "sha256:487bf2f5df250d6f9d76a28fded97bfad6aec57c62f92e2b997bfd9bf25e7a53",
+      "lens": "review-reliability",
+      "selected_order": 3
+    }
+  ],
+  "changed_path_manifest": [
+    {
+      "path": "internal/runner/runner.go",
+      "status": "M",
+      "old_mode": "100644",
+      "new_mode": "100644",
+      "deleted": false,
+      "type_changed": false,
+      "mode_only": false,
+      "intended_untracked": false
+    },
+    {
+      "path": "internal/runner/runner_test.go",
+      "status": "M",
+      "old_mode": "100644",
+      "new_mode": "100644",
+      "deleted": false,
+      "type_changed": false,
+      "mode_only": false,
+      "intended_untracked": false
+    }
+  ],
+  "repository_context": {
+    "capability": "review.opaque_repository_context",
+    "handle": "rctx1_5ce64550b975f58fae189cf4ae1da04aea489928f386dc9f17b45f12d26de8e8",
+    "revision": "sha256:fe7f383e1b3b0854f8974c94b60597b59a4384c8c6f30c04779d13c6ec32fb66",
+    "target_identity": "sha256:377c60e10b852cfcbcca6cd101e6ee7def9621a24a9f4b361d32137a3b0b3988",
+    "event_id": "sha256:48ac0c2d153f410d4292a24e6dfa20ae16599cb6c3d5416bb87fa7f515007b71",
+    "outcome": "applied"
+  }
+}