gentle-pi 1.2.0 → 2.1.0

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

@@ -0,0 +1,110 @@
+{
+  "schema": "gentle-ai.review-integration.status/v2",
+  "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"
+  },
+  "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": [
+    "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.reconcile-authority-batch",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.recover",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.repair",
+        "reason_code": "forbidden_ambiguous_authority"
+      },
+      {
+        "action": "review.retry_final_verification",
+        "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-v2-corrupted.fixture.json

@@ -0,0 +1,107 @@
+{
+  "schema": "gentle-ai.review-integration.status/v2",
+  "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"
+  },
+  "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": [],
+  "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.reconcile-authority-batch",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.recover",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.repair",
+        "reason_code": "forbidden_corrupted_authority"
+      },
+      {
+        "action": "review.retry_final_verification",
+        "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-v2-final-verification-retry.fixture.json

@@ -0,0 +1,192 @@
+{
+  "schema": "gentle-ai.review-integration.status/v2",
+  "contract": "gentle-ai.review-integration/v1",
+  "operation": "review.status",
+  "applicability": "current_target",
+  "authority": {
+    "version": "compact-v2",
+    "lineage_id": "review-final-verification-retry-fixture",
+    "state": "escalated",
+    "generation": 2,
+    "revision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "receipt": {
+    "status": "present",
+    "identity": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+  },
+  "action": "retry_final_verification",
+  "replayability": "manual_action_required",
+  "frozen": {
+    "tier": "medium",
+    "original_changed_lines": 2,
+    "correction_budget": 1
+  },
+  "target_identity": "sha256:e6faad1cb9ceb2db170e0ec9ea5394b44c3991dff6cbd02fb6787539715968f6",
+  "authority_target_identity": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+  "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": [],
+  "eligibility": {
+    "allowed_actions": [
+      {
+        "action": "review.retry_final_verification",
+        "reason_code": "eligible_final_verification_retry",
+        "required_inputs": [
+          "predecessor_lineage",
+          "expected_predecessor_revision",
+          "successor_lineage",
+          "incident",
+          "actor",
+          "reason",
+          "maintainer_authorization"
+        ],
+        "disposition": "final_verification_retry",
+        "binding": {
+          "lineage_id": "review-final-verification-retry-fixture",
+          "revision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "target_identity": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+        }
+      }
+    ],
+    "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.reconcile-authority-batch",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.recover",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.repair",
+        "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"
+      }
+    ]
+  },
+  "next_transition": {
+    "kind": "collect",
+    "reason_code": "final_verification_retry_authorization_required",
+    "collect": {
+      "inputs": [
+        {
+          "name": "final_verification_retry_authorization",
+          "schema": "gentle-ai.review-final-verification-retry-authorization/v1",
+          "capture_operation": "external.authorize_final_verification_retry",
+          "arguments": [
+            {
+              "name": "predecessor-lineage",
+              "value": "review-final-verification-retry-fixture"
+            },
+            {
+              "name": "expected-predecessor-revision",
+              "value": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+            },
+            {
+              "name": "validating-revision",
+              "value": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+            },
+            {
+              "name": "target",
+              "value": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+            },
+            {
+              "name": "failed-evidence-hash",
+              "value": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
+            },
+            {
+              "name": "failed-evidence-record-digest",
+              "value": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+            },
+            {
+              "name": "finalize-request-digest",
+              "value": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
+            },
+            {
+              "name": "incident-schema",
+              "value": "gentle-ai.review-final-verification-incident/v1"
+            },
+            {
+              "name": "incident-class",
+              "value": "procedural_tooling_failure"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "action_disposition": "final_verification_retry",
+  "final_verification_retry": {
+    "incident_schema": "gentle-ai.review-final-verification-incident/v1",
+    "incident_class": "procedural_tooling_failure",
+    "validating_revision": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "target_identity": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+    "failed_evidence_hash": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+    "failed_evidence_record_digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "finalize_request_digest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
+  }
+}

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

@@ -0,0 +1,130 @@
+{
+  "schema": "gentle-ai.review-integration.status/v2",
+  "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"
+  },
+  "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": [],
+  "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.reconcile-authority-batch",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.repair",
+        "reason_code": "forbidden_not_selected_by_native_status"
+      },
+      {
+        "action": "review.retry_final_verification",
+        "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"
+      }
+    ]
+  }
+}