Skip to main content

ExecutorPolicy

Struct ExecutorPolicy 

Source
pub struct ExecutorPolicy {
    pub retry: RetryPolicyParameters,
    pub timeout: TimeoutPolicyParameters,
    pub concurrency: ConcurrencyPolicyParameters,
}
Expand description

The executor policy contract (R0.8 wave 4): one versioned bundle of the parameters the executor’s mechanical decision points agree to decide with.

An ExecutorPolicy is what a PolicyVersion names: the registry (server side) stores immutable policy bodies under content-derived versions, runs bind the active version at admission, and every DecisionEvent records which version decided. Because the version is derived from the content (derive_policy_version), two registries that agree on a version string agree on the exact parameters — promotion and rollback move versions, never mutate bodies.

v1 wires versions into admission binding and decision evidence; R0.10 wave 3 adds the application loop: the retry classifier and the timeout decision point read the bound version’s parameters through crate::durable::resolve_retry_parameters and crate::durable::resolve_timeout_bound_ms, with the static floor’s constants as the read path when the version names no override (or names an invalid one — invalid parameters fail closed to the floor). The static floor (ExecutorPolicy::static_v0) is the behavior every pre-learning run already had: the retry constants of crate::durable::classify_retry, no timeout bound, no concurrency limit.

Fields§

§retry: RetryPolicyParameters

Retry parameters — the family v1 actually emits decisions for.

§timeout: TimeoutPolicyParameters

Timeout parameters (shape pinned; unconsumed in v1).

§concurrency: ConcurrencyPolicyParameters

Concurrency parameters (shape pinned; unconsumed in v1).

Implementations§

Source§

impl ExecutorPolicy

Source

pub fn static_v0() -> Self

The static floor: the fixed behavior of every run before the policy plane landed, named by PolicyVersion::STATIC_V0.

The retry parameters mirror the crate::durable backoff constants and the server’s default attempt budget (DEFAULT_MAX_ATTEMPTS = 3); the timeout and concurrency families are uncapped, matching the executor’s behavior when no policy is in force.

Source

pub fn is_static_floor(&self) -> bool

true when this policy is exactly the static floor — the read path every decision point falls back to. Compared by value, not by version name: a registered body identical to the floor is the floor’s behavior, whatever string names it.

Source

pub fn validate(&self) -> Result<()>

The whole bundle’s contract: every family’s parameters validate. Decision points call this (or the per-family equivalents) before reading parameters into a decision — an invalid bundle steers nothing; the floor decides instead.

Source

pub fn with_family_parameters( &self, family: DecisionFamily, parameters: Value, ) -> Result<Self>

This policy with one family’s parameters replaced by parameters (parsed as that family’s parameter type).

This is how a promoted policy candidate — whose content is a family plus a free-form parameter value — becomes a concrete ExecutorPolicy: the candidate’s parameters are parsed against the family’s contract and checked against the family’s declared envelope (R0.10 wave 3), then overlaid onto the policy that was active (the floor when nothing was promoted yet). Out-of-envelope parameters are rejected — a malformed candidate can never become an active policy. Families without a parameter contract (DecisionFamily::WorkerPlacement, DecisionFamily::CheckpointPlacement) are rejected: those families are shadow-only, and a shadow family’s parameters cannot activate.

Trait Implementations§

Source§

impl Clone for ExecutorPolicy

Source§

fn clone(&self) -> ExecutorPolicy

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ExecutorPolicy

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for ExecutorPolicy

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for ExecutorPolicy

Source§

impl PartialEq for ExecutorPolicy

Source§

fn eq(&self, other: &ExecutorPolicy) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for ExecutorPolicy

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for ExecutorPolicy

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more