gentle-pi 1.2.0 → 2.1.0

package/contracts/review-integration/v1/fixtures/capabilities-v1.5.fixture.json

@@ -0,0 +1,321 @@
+{
+  "schema": "gentle-ai.review-integration.capabilities/v1.5",
+  "contract": "gentle-ai.review-integration/v1",
+  "protocol": {
+    "major": 1,
+    "minor": 5
+  },
+  "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/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": {
+    "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"
+        ]
+      }
+    ]
+  },
+  "bootstrap": {
+    "command": "gentle-ai review status --cwd \u003crepo\u003e --contract gentle-ai.review-integration/v1 --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": 1,
+    "maximum_protocol_major": 1,
+    "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/v1/fixtures/consent.fixture.json

@@ -0,0 +1,36 @@
+{
+  "schema": "gentle-ai.review-integration.consent/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "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/v1 --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/v1 --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/v1/fixtures/final-verification-incident.fixture.json

@@ -0,0 +1 @@
+{"schema":"gentle-ai.review-final-verification-incident/v1","class":"procedural_tooling_failure","lineage_id":"review-final-verification-example","terminal_revision":"sha256:1111111111111111111111111111111111111111111111111111111111111111","validating_revision":"sha256:2222222222222222222222222222222222222222222222222222222222222222","target_identity":"sha256:3333333333333333333333333333333333333333333333333333333333333333","failed_evidence_hash":"sha256:4444444444444444444444444444444444444444444444444444444444444444","finalize_request_digest":"sha256:5555555555555555555555555555555555555555555555555555555555555555"}

package/contracts/review-integration/v1/fixtures/operation.fixture.json

@@ -43,6 +43,10 @@
           "action": "review.reconcile-authority",
           "reason_code": "forbidden_finalize_requires_target_status"
         },
+        {
+          "action": "review.reconcile-authority-batch",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
         {
           "action": "review.recover",
           "reason_code": "forbidden_finalize_requires_target_status"

package/contracts/review-integration/v1/fixtures/repair-preflight.fixture.json

@@ -0,0 +1,54 @@
+{
+  "schema": "gentle-ai.review-integration.repair/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.repair",
+  "mode": "preflight",
+  "assessment": {
+    "schema": "gentle-ai.review-authority-repair-assessment/v1",
+    "status": "eligible",
+    "class": "legacy_v1_historical_alias",
+    "cause": "unsupported_historical_v1_operation_alias",
+    "disposition": "quarantine-approved-historical-alias",
+    "repository_binding": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "candidate": {
+      "lineage_id": "historical-alias",
+      "revision": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+      "chain_identity": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+      "event_count": 6,
+      "alias_event_count": 2,
+      "operations": [
+        "review/complete-fix",
+        "review/validate-fix"
+      ]
+    },
+    "counts": {
+      "lineages": 1,
+      "compact_lineages": 0,
+      "legacy_lineages": 1,
+      "events": 6,
+      "bytes": 4096,
+      "eligible_candidates": 1,
+      "unsupported_lineages": 0,
+      "conflicts": 0
+    },
+    "supported_operations": [
+      "review/complete-fix",
+      "review/validate-fix"
+    ],
+    "authorization_schema": "gentle-ai.review-repair-authorization/v1"
+  },
+  "provider_inputs": {
+    "class": "legacy_v1_historical_alias",
+    "lineage_id": "historical-alias",
+    "expected_revision": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "cause": "unsupported_historical_v1_operation_alias",
+    "disposition": "quarantine-approved-historical-alias",
+    "repository_binding": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "authorization_schema": "gentle-ai.review-repair-authorization/v1"
+  },
+  "required_inputs": [
+    "actor",
+    "reason",
+    "maintainer_authorization"
+  ]
+}

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

@@ -0,0 +1,97 @@
+{
+  "schema": "gentle-ai.review-integration.start/v2",
+  "contract": "gentle-ai.review-integration/v1",
+  "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",
+  "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/v1",
+      "subject_hash": "sha256:38a55988f6b3ae6f520690d52fd29255f425a4048b0f8694de3a80c5daf265cd",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "candidate_diff_sha256": "sha256:c18ffcaf6f41a8cd5f3399a10355eb8de3e5eb561cb65cb551ea93bdf4df921b",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-risk",
+      "selected_order": 0
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v1",
+      "subject_hash": "sha256:06d86f981a8c0b16c2179696d467c8157580214ad72c952adee423fe596d2c21",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "candidate_diff_sha256": "sha256:c18ffcaf6f41a8cd5f3399a10355eb8de3e5eb561cb65cb551ea93bdf4df921b",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-resilience",
+      "selected_order": 1
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v1",
+      "subject_hash": "sha256:beacbf1eed52620ef7686087f8944cbc2304d71abf13281267efe9e4de20fb1e",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "candidate_diff_sha256": "sha256:c18ffcaf6f41a8cd5f3399a10355eb8de3e5eb561cb65cb551ea93bdf4df921b",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-readability",
+      "selected_order": 2
+    },
+    {
+      "schema": "gentle-ai.review-artifact-subject/v1",
+      "subject_hash": "sha256:61a10b133e3f7a8ccad1d0f1d58989df75d2330ad530690137de625bfd10eec8",
+      "lineage_id": "review-start-fixture",
+      "authority_revision": "sha256:3411d049f39e891b50adfc76473199b473927d10245a227a3bc967eae0caf68c",
+      "target_identity": "sha256:136dc6556e3bac8c2e7f7af7cc5ec361f449e383a997638128729059fefa06a5",
+      "candidate_diff_sha256": "sha256:c18ffcaf6f41a8cd5f3399a10355eb8de3e5eb561cb65cb551ea93bdf4df921b",
+      "changed_path_manifest_sha256": "sha256:049219ea30e21c409608ea8527e65bcc6774d764363031a6cf0cb05e35c734ef",
+      "lens": "review-reliability",
+      "selected_order": 3
+    }
+  ],
+  "candidate_diff": {
+    "encoding": "base64",
+    "data": "ZGlmZiAtLWdpdCBhL3NjcmlwdHMvZGVwbG95LnNoIGIvc2NyaXB0cy9kZXBsb3kuc2gKbmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMC4uMjhiM2FjMTI4ZmJiZWFmZmY0OWEzMjYxMDVmOGVhYzg1YzZjNzdhMQotLS0gL2Rldi9udWxsCisrKyBiL3NjcmlwdHMvZGVwbG95LnNoCkBAIC0wLDAgKzEgQEAKK2VjaG8gZGVwbG95Cg==",
+    "sha256": "sha256:c18ffcaf6f41a8cd5f3399a10355eb8de3e5eb561cb65cb551ea93bdf4df921b",
+    "byte_size": 226
+  },
+  "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/v1/fixtures/start.fixture.json

@@ -23,5 +23,29 @@
       "signal": "shell_process",
       "path": "scripts/deploy.sh"
     }
-  ]
+  ],
+  "candidate_diff": {
+    "encoding": "base64",
+    "data": "ZGlmZiAtLWdpdCBhL3NjcmlwdHMvZGVwbG95LnNoIGIvc2NyaXB0cy9kZXBsb3kuc2gKbmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMC4uMjhiM2FjMTI4ZmJiZWFmZmY0OWEzMjYxMDVmOGVhYzg1YzZjNzdhMQotLS0gL2Rldi9udWxsCisrKyBiL3NjcmlwdHMvZGVwbG95LnNoCkBAIC0wLDAgKzEgQEAKK2VjaG8gZGVwbG95Cg==",
+    "sha256": "sha256:c18ffcaf6f41a8cd5f3399a10355eb8de3e5eb561cb65cb551ea93bdf4df921b",
+    "byte_size": 226
+  },
+  "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/v1/fixtures/status-ambiguous.fixture.json

@@ -62,6 +62,10 @@
         "action": "review.reconcile-authority",
         "reason_code": "forbidden_ambiguous_authority"
       },
+      {
+        "action": "review.reconcile-authority-batch",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
       {
         "action": "review.recover",
         "reason_code": "forbidden_ambiguous_authority"

package/contracts/review-integration/v1/fixtures/status-corrupted.fixture.json

@@ -59,6 +59,10 @@
         "action": "review.reconcile-authority",
         "reason_code": "forbidden_corrupted_authority"
       },
+      {
+        "action": "review.reconcile-authority-batch",
+        "reason_code": "forbidden_corrupted_authority"
+      },
       {
         "action": "review.recover",
         "reason_code": "forbidden_corrupted_authority"

package/contracts/review-integration/v1/fixtures/status-recover.fixture.json

@@ -86,6 +86,10 @@
         "action": "review.reconcile-authority",
         "reason_code": "forbidden_not_selected_by_native_status"
       },
+      {
+        "action": "review.reconcile-authority-batch",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
       {
         "action": "review.start",
         "reason_code": "forbidden_not_selected_by_native_status"

package/contracts/review-integration/v1/fixtures/status-unrelated.fixture.json

@@ -59,6 +59,10 @@
         "action": "review.reconcile-authority",
         "reason_code": "forbidden_unrelated_target"
       },
+      {
+        "action": "review.reconcile-authority-batch",
+        "reason_code": "forbidden_unrelated_target"
+      },
       {
         "action": "review.recover",
         "reason_code": "forbidden_unrelated_target"