v0.3.1-pre.007

crates/ksp-store-api/src/model/raw_retention.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-store-api/src/model/raw_retention.rs
-// version: 1
+// version: 2
 
 /// Logical availability state of one canonical RAW payload.
 ///
@@ -131,6 +131,11 @@ pub enum RawRetentionWriteOutcome {
     Applied,
     /// The entity was already at the requested target state.
     AlreadyAtTarget,
+    /// The current state matched neither the caller's expected state nor the requested target.
+    ///
+    /// This outcome makes a lost compare-and-transition race observable without
+    /// treating concurrent policy progress as malformed input.
+    ExpectedStateMismatch,
 }
 
 fn allowed_transition(expected: crate::RawRetentionState, target: crate::RawRetentionState) -> bool {