Struct EffectGate 

pub struct EffectGate { /* private fields */ }

The single admission authority for one control surface. Cheap to share behind an Arc; admit is safe to call concurrently.

Implementations

impl EffectGate

pub fn new(hook: impl AdmissionHook + 'static) -> Self

pub fn from_arc(hook: Arc<dyn AdmissionHook>) -> Self

pub fn allow_all() -> Self

Gate with AllowAll: still validates, settles and emits events.

pub fn with_events(self, sink: EventSink) -> Self

pub fn with_journal_capacity(self, capacity: usize) -> Self

Bound on retained settlements (oldest dropped first). 0 keeps none.

pub fn settlements(&self) -> Vec<Settlement>

Snapshot of retained settlements, oldest first.

pub fn admit<T>( &self, request: EffectRequest, cancel: &CancelToken, execute: impl FnOnce(&CancelToken) -> Result<T, ExecError>, ) -> Effect<T>

Run request through validate → approval → execute → settle.

execute is invoked at most once, and only when validation and the hook both admit the request and cancel is not yet set. Every path settles exactly once (recorded and returned) and emits lifecycle events. Executor panics are contained and settled as Failed.

Trait Implementations

impl Debug for EffectGate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EffectGate

fn default() -> Self

Returns the “default value” for a type.