Skip to main content

JournalShadowSource

Struct JournalShadowSource 

Source
pub struct JournalShadowSource { /* private fields */ }
Expand description

One source run’s journal, indexed as the recorded world a shadow run serves refused effects from — the crate::effects::ShadowOutcomeSource over the Flight Recorder’s own evidence.

The index is per-tool, in sequence order: every recorded RunEventKind::ToolCall queues its request hash and recorded output under the tool’s name. Serving pops the front of the tool’s queue and only when the live request hashes to the same value — the hybrid rule applied to ordering: the shadow serves the recorded outcome of exactly the call the source made next under that tool, never a later one and never a different argument set. A call the recorded world never saw, or saw in a different order, is a divergence and answers None.

After the run, JournalShadowSource::unrequested names the tools whose recorded calls the shadow never made — divergence in the other direction, journaled into the shadow’s verdict.

Implementations§

Source§

impl JournalShadowSource

Source

pub fn new(snapshot: &JournalSnapshot) -> Self

Index a recorded run’s journal for shadow serving. Events whose payloads the snapshot cannot resolve (externalized artifact references) are skipped rather than guessed at: an unresolvable recorded call is one the shadow cannot serve, and serving it anyway would fabricate evidence.

Source

pub fn unrequested(&self) -> Vec<String>

The tools holding recorded calls no shadow requested, sorted. Called once the shadow’s run has ended — while it runs, a non-empty queue is simply the recorded future.

Trait Implementations§

Source§

impl Debug for JournalShadowSource

Source§

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

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

impl ShadowOutcomeSource for JournalShadowSource

Source§

fn serve(&self, kind: &str, recorded_request: &Value) -> Option<Value>

The recorded outcome of one refused call, when the source run recorded it. None is a divergence, not an error: the candidate attempted something the recorded world never saw.

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> 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, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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