gentle-pi 1.0.6 → 1.2.0

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

@@ -0,0 +1,186 @@
+{
+  "schema": "gentle-ai.review-integration.capabilities/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "protocol": {
+    "major": 1,
+    "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.start",
+    "review.status",
+    "review.validate"
+  ],
+  "gates": [
+    "post-apply",
+    "pre-commit",
+    "pre-push",
+    "pre-pr",
+    "release"
+  ],
+  "projections": [
+    "staged",
+    "workspace"
+  ],
+  "schemas": [
+    "gentle-ai.review-authority-status/v1",
+    "gentle-ai.review-gate-request/v1",
+    "gentle-ai.review-integration.capabilities/v1",
+    "gentle-ai.review-integration.failure/v1",
+    "gentle-ai.review-integration.operation/v1",
+    "gentle-ai.review-integration.projection/v1",
+    "gentle-ai.review-integration.start/v1",
+    "gentle-ai.review-integration.status/v1",
+    "gentle-ai.review-receipt/v1",
+    "gentle-ai.review-receipt/v2",
+    "gentle-ai.review-result-artifact/v1",
+    "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": "bounded_process_waits",
+        "supported": true,
+        "requires": [
+          "uniform_failure_envelope"
+        ]
+      },
+      {
+        "name": "exact_gate_receipt_discovery",
+        "supported": true,
+        "requires": [
+          "five_delivery_gates"
+        ]
+      },
+      {
+        "name": "native_low_risk_verification",
+        "supported": true,
+        "requires": [
+          "compact_v2_authority"
+        ]
+      },
+      {
+        "name": "risk_reasons",
+        "supported": true,
+        "requires": [
+          "repository_independent_capabilities"
+        ]
+      },
+      {
+        "name": "scope_change_diagnostics",
+        "supported": true,
+        "requires": [
+          "uniform_failure_envelope"
+        ]
+      }
+    ]
+  },
+  "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/failure.fixture.json

@@ -0,0 +1,47 @@
+{
+  "schema": "gentle-ai.review-integration.failure/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.validate",
+  "phase": "preflight",
+  "code": "gate_scope_changed",
+  "message": "The review delivery gate denied the current target.",
+  "mutation_outcome": "not_started",
+  "authority_applicability": "current_target",
+  "retry_safe": false,
+  "replayability": "manual_action_required",
+  "lineage_id": "review-failure-fixture",
+  "required_inputs": [
+    "predecessor_lineage_id",
+    "expected_predecessor_revision",
+    "successor_lineage_id",
+    "disposition",
+    "reason",
+    "actor"
+  ],
+  "next_action": "explicit-maintainer-action",
+  "context": {
+    "scope_change": {
+      "expected": {
+        "candidate_tree": "2222222222222222222222222222222222222222",
+        "paths_digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+      },
+      "actual": {
+        "candidate_tree": "3333333333333333333333333333333333333333",
+        "paths_digest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+      },
+      "differing_path_count": 1,
+      "differing_paths_digest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
+      "predecessor_lineage_id": "review-failure-fixture",
+      "predecessor_revision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "recovery_operation": "review.recover",
+      "recovery_required_inputs": [
+        "predecessor_lineage_id",
+        "expected_predecessor_revision",
+        "successor_lineage_id",
+        "disposition",
+        "reason",
+        "actor"
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,61 @@
+{
+  "schema": "gentle-ai.review-integration.operation/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.finalize",
+  "result": {
+    "operation": "review/finalize",
+    "lineage_id": "review-operation-fixture",
+    "state": "approved",
+    "action": "validate delivery with gentle-ai review validate --gate <gate>",
+    "store_revision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "eligibility": {
+      "allowed_actions": [
+        {
+          "action": "stop",
+          "reason_code": "forbidden_finalize_requires_target_status",
+          "required_inputs": [
+            "target_scoped_status"
+          ]
+        }
+      ],
+      "forbidden_actions": [
+        {
+          "action": "review.abandon",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.finalize",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.invalidate",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.quarantine-legacy",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.reclaim",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.reconcile-authority",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.recover",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.start",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        },
+        {
+          "action": "review.validate",
+          "reason_code": "forbidden_finalize_requires_target_status"
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,27 @@
+{
+  "schema": "gentle-ai.review-integration.start/v1",
+  "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"
+    }
+  ]
+}

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

@@ -0,0 +1,79 @@
+{
+  "schema": "gentle-ai.review-integration.status/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.status",
+  "applicability": "ambiguous",
+  "receipt": {
+    "status": "not_applicable"
+  },
+  "action": "select_lineage",
+  "replayability": "status_required",
+  "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"
+  },
+  "candidates": [
+    "review-a",
+    "review-b"
+  ],
+  "eligibility": {
+    "allowed_actions": [
+      {
+        "action": "stop",
+        "reason_code": "forbidden_manual_intervention_required",
+        "required_inputs": []
+      }
+    ],
+    "forbidden_actions": [
+      {
+        "action": "review.abandon",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.finalize",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.invalidate",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.quarantine-legacy",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.reclaim",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.reconcile-authority",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.recover",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.start",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.validate",
+        "reason_code": "forbidden_ambiguous_authority"
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,76 @@
+{
+  "schema": "gentle-ai.review-integration.status/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.status",
+  "applicability": "corrupted",
+  "receipt": {
+    "status": "not_applicable"
+  },
+  "action": "repair_authority",
+  "replayability": "manual_action_required",
+  "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"
+  },
+  "candidates": [],
+  "eligibility": {
+    "allowed_actions": [
+      {
+        "action": "stop",
+        "reason_code": "forbidden_manual_intervention_required",
+        "required_inputs": []
+      }
+    ],
+    "forbidden_actions": [
+      {
+        "action": "review.abandon",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.finalize",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.invalidate",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.quarantine-legacy",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.reclaim",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.reconcile-authority",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.recover",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.start",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.validate",
+        "reason_code": "forbidden_corrupted_authority"
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,99 @@
+{
+  "schema": "gentle-ai.review-integration.status/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.status",
+  "applicability": "current_target",
+  "authority": {
+    "version": "compact-v2",
+    "lineage_id": "review-status-recover-fixture",
+    "state": "correction_required",
+    "generation": 3,
+    "revision": "sha256:81cdad8f3182d4919147d3c4fe8f614814068e5ef68417e3dcbd5e326dd3e390"
+  },
+  "receipt": {
+    "status": "expected_missing"
+  },
+  "action": "recover",
+  "action_disposition": "scope_changed",
+  "replayability": "manual_action_required",
+  "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"
+  },
+  "candidates": [],
+  "eligibility": {
+    "allowed_actions": [
+      {
+        "action": "review.recover",
+        "reason_code": "eligible_recovery",
+        "required_inputs": [
+          "predecessor_lineage",
+          "expected_predecessor_revision",
+          "successor_lineage",
+          "disposition",
+          "reason",
+          "actor",
+          "maintainer_authorization"
+        ],
+        "disposition": "scope_changed",
+        "binding": {
+          "lineage_id": "review-status-recover-fixture",
+          "revision": "sha256:81cdad8f3182d4919147d3c4fe8f614814068e5ef68417e3dcbd5e326dd3e390",
+          "target_identity": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6"
+        }
+      }
+    ],
+    "forbidden_actions": [
+      {
+        "action": "review.abandon",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.finalize",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.invalidate",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.quarantine-legacy",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.reclaim",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.reconcile-authority",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.start",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.validate",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,72 @@
+{
+  "schema": "gentle-ai.review-integration.status/v1",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.status",
+  "applicability": "unrelated",
+  "receipt": {
+    "status": "not_applicable"
+  },
+  "action": "start",
+  "replayability": "not_replayable",
+  "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"
+  },
+  "candidates": [],
+  "eligibility": {
+    "allowed_actions": [
+      {
+        "action": "review.start",
+        "reason_code": "eligible_current_target",
+        "required_inputs": []
+      }
+    ],
+    "forbidden_actions": [
+      {
+        "action": "review.abandon",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.finalize",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.invalidate",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.quarantine-legacy",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.reclaim",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.reconcile-authority",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.recover",
+        "reason_code": "forbidden_unrelated_target"
+      },
+      {
+        "action": "review.validate",
+        "reason_code": "forbidden_unrelated_target"
+      }
+    ]
+  }
+}