Resolve unknown recovery outcomes from evidence

2026-08-03 05:00:08 +02:00
parent 5bfbe9a887
commit 7e59a7f2b3
3 changed files with 117 additions and 0 deletions
@@ -219,6 +219,69 @@ class DurableRecoveryOperation:
            session.commit()
        self.closed = True

+    def resolve_unknown(
+        self,
+        *,
+        effect_occurred: bool,
+        evidence: dict[str, Any],
+        summary: str,
+    ) -> None:
+        """Resolve an externally verified operation with an unknown outcome.
+
+        A confirmed provider effect is a verified success. A confirmed absence
+        of the effect is recorded as forward recovery: the declared invariant
+        is restored and the original effect may be attempted again under a new
+        idempotency key.
+        """
+
+        with self.session_factory() as session:
+            operation, claim = self._locked_and_renewed(session)
+            if operation.status != RecoveryStatus.OUTCOME_UNKNOWN.value:
+                raise RecoveryOperationStateConflict(operation.id, operation.status)
+            if effect_occurred:
+                transition_recovery_operation(
+                    session,
+                    operation,
+                    status=RecoveryStatus.SUCCEEDED,
+                    kind="unknown-outcome-verified-success",
+                    summary=summary,
+                    evidence=evidence,
+                    lease_claim=claim,
+                )
+            else:
+                operation = transition_recovery_operation(
+                    session,
+                    operation,
+                    status=RecoveryStatus.RECOVERY_REQUIRED,
+                    kind="unknown-outcome-recovery-required",
+                    summary=summary,
+                    evidence=evidence,
+                    failure_summary="The external effect was verified absent",
+                    lease_claim=claim,
+                )
+                operation = transition_recovery_operation(
+                    session,
+                    operation,
+                    status=RecoveryStatus.RECOVERING,
+                    kind="unknown-outcome-recovery-started",
+                    summary="Recording the verified absence of the external effect",
+                    evidence={"effect_occurred": False},
+                    lease_claim=claim,
+                )
+                transition_recovery_operation(
+                    session,
+                    operation,
+                    status=RecoveryStatus.RECOVERED,
+                    kind="unknown-outcome-verified-absent",
+                    summary=summary,
+                    evidence=evidence,
+                    lease_claim=claim,
+                )
+            self._verify_chain(session)
+            release_lease(session, claim)
+            session.commit()
+        self.closed = True
+
    def release_unresolved(self) -> None:
        """Release authority after a process-local exception.