refactor(cow): structured Verdict poll seam + LegacyRevertAdapter (Wave 1, ADR-0013)

crates/shepherd-sdk-test/tests/mock_venue.rs

@@ -7,7 +7,7 @@ use alloy_primitives::{Address, B256, U256, address, hex, keccak256};
 use cowprotocol::{BuyTokenDestination, GPv2OrderData, OrderKind, SellTokenSource};
 use nexum_sdk::host::{Fault, LocalStoreHost as _, RateLimit};
 use nexum_sdk::keeper::{ConditionalSource, Journal, Tick, WatchRef, WatchSet, watch_key};
-use shepherd_sdk::cow::{CowApiError, CowHost, OrderRejection, PollOutcome, order_uid_hex, run};
+use shepherd_sdk::cow::{CowApiError, CowHost, OrderRejection, Verdict, order_uid_hex, run};
 use shepherd_sdk_test::{MockHost, MockVenue};
 
 const SEPOLIA: u64 = 11_155_111;
@@ -19,11 +19,11 @@ struct FnSource<F>(F);
 
 impl<H, F> ConditionalSource<H> for FnSource<F>
 where
-    F: Fn(&H, WatchRef<'_>, &[u8], &Tick) -> PollOutcome,
+    F: Fn(&H, WatchRef<'_>, &[u8], &Tick) -> Verdict,
 {
-    type Outcome = PollOutcome;
+    type Outcome = Verdict;
 
-    fn poll(&self, host: &H, watch: WatchRef<'_>, params: &[u8], tick: &Tick) -> PollOutcome {
+    fn poll(&self, host: &H, watch: WatchRef<'_>, params: &[u8], tick: &Tick) -> Verdict {
         (self.0)(host, watch, params, tick)
     }
 }
@@ -32,7 +32,7 @@ where
 /// construction site so inference never guesses a too-narrow lifetime.
 fn src<F>(f: F) -> FnSource<F>
 where
-    F: Fn(&VenueHost, WatchRef<'_>, &[u8], &Tick) -> PollOutcome,
+    F: Fn(&VenueHost, WatchRef<'_>, &[u8], &Tick) -> Verdict,
 {
     FnSource(f)
 }
@@ -77,16 +77,17 @@ fn submittable_order() -> GPv2OrderData {
     }
 }
 
-fn ready_outcome(order: &GPv2OrderData) -> PollOutcome {
-    PollOutcome::Ready {
+fn ready_outcome(order: &GPv2OrderData) -> Verdict {
+    Verdict::Post {
         order: Box::new(order.clone()),
         signature: hex!("c0ffeec0ffeec0ffee").to_vec().into(),
+        next_poll_timestamp: 0,
     }
 }
 
 fn ready_source(
     order: &GPv2OrderData,
-) -> FnSource<impl Fn(&VenueHost, WatchRef<'_>, &[u8], &Tick) -> PollOutcome> {
+) -> FnSource<impl Fn(&VenueHost, WatchRef<'_>, &[u8], &Tick) -> Verdict> {
     let order = order.clone();
     src(move |_, _, _, _| ready_outcome(&order))
 }

crates/shepherd-sdk/README.md

@@ -23,7 +23,7 @@ use shepherd_sdk::cow::{gpv2_to_order_data, classify_api_error, RetryAction};
 | `prelude` | One-liner `use ::*` for cowprotocol order / signing / orderbook surface (alloy primitives come from `nexum_sdk::prelude`). |
 | `cow` | `CowApiHost` trait for `shepherd:cow/cow-api` + the `CowHost` bound over the core `nexum_sdk::host::Host`. |
 | `cow::order` | `gpv2_to_order_data` - `GPv2OrderData` -> typed `OrderData`. |
-| `cow::composable` | `sol! IConditionalOrder` errors + `PollOutcome` + `decode_revert` + `decode_revert_hex`. |
+| `cow::composable` | `sol! IConditionalOrder` errors + `Verdict` + `LegacyRevertAdapter`. |
 | `cow::error` | `CowApiError` (mirror of `cow-api-error`: `Fault` / `Http` / `Rejected`) + `RetryAction` enum + `classify_api_error` over an `OrderRejection`. |
 | `wit_bindgen_macro` | `bind_cow_host_via_wit_bindgen!` - the generic `WitBindgenHost` adapter plus the `CowApiHost` impl. |
 
@@ -62,7 +62,7 @@ crates/shepherd-sdk/
 │   ├── cow/
 │   │   ├── mod.rs           CowApiHost + CowHost
 │   │   ├── order.rs         gpv2_to_order_data
-│   │   ├── composable.rs    IConditionalOrder + PollOutcome + decode_revert(_hex)
+│   │   ├── composable.rs    IConditionalOrder + Verdict + LegacyRevertAdapter
 │   │   └── error.rs         RetryAction + classify_api_error
 │   └── wit_bindgen_macro.rs bind_cow_host_via_wit_bindgen!
 └── README.md                you are here