Struct ObservationPolicy 

#[non_exhaustive]
pub struct ObservationPolicy {
    pub origins: OriginFilter,
    pub provenance: Provenance,
}

How a UsageLearner turns a trace stream into observations.

Default reproduces today’s behavior exactly, field for field — pinned by the_default_policy_reproduces_todays_pairing_exactly. Build from it with the with_* setters:

use ratel_ai_core::{ObservationPolicy, Origin, OriginFilter, Provenance};

// A baseline capture: only observed queries teach, and everything learned
// is marked as seeded.
let seeding = ObservationPolicy::default()
    .with_origins(OriginFilter::Exactly(Origin::Baseline))
    .with_provenance(Provenance::Seeded);

assert_eq!(seeding.provenance, Provenance::Seeded);
assert_eq!(ObservationPolicy::default().origins, OriginFilter::Any);

The struct is #[non_exhaustive], which is what makes a future field additive rather than breaking — and is also why the setters exist rather than struct-literal syntax: a #[non_exhaustive] struct cannot be built with a struct expression outside its defining crate at all, ..Default included. Fields stay public for reading.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

origins: OriginFilter

Which searches open an observation window.

provenance: Provenance

Whether what is learned is marked as seeded.

Implementations

impl ObservationPolicy

pub fn with_origins(self, origins: OriginFilter) -> Self

Set which searches open an observation window.

pub fn with_provenance(self, provenance: Provenance) -> Self

Set whether what is learned is marked as seeded.

Trait Implementations

impl Clone for ObservationPolicy

fn clone(&self) -> ObservationPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ObservationPolicy

impl Debug for ObservationPolicy

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

Formats the value using the given formatter.

impl Default for ObservationPolicy

fn default() -> ObservationPolicy

Returns the “default value” for a type.

impl Eq for ObservationPolicy

impl PartialEq for ObservationPolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ObservationPolicy