Struct CoherenceDriftReport 

pub struct CoherenceDriftReport {
    pub top: ContextObservation,
    pub iframe: ContextObservation,
    pub worker: ContextObservation,
    pub drifts: Vec<DriftDiagnostic>,
    pub freshness: Option<FreshnessReport>,
}

Aggregate coherence drift report covering top-level, iframe, and (best-effort) worker contexts.

Skipped contexts never panic — they are emitted as ContextObservation::Skipped markers so callers can attribute missing coverage to the runtime, not a probe failure.

Example

use stygian_browser::coherence::{
    CoherenceDriftReport, ContextObservation, ContextKind, IdentitySurface,
};

let s = IdentitySurface {
    user_agent: Some("Mozilla/5.0 ...".to_string()),
    platform: Some("MacIntel".to_string()),
    languages: Some("en-US".to_string()),
    ..IdentitySurface::default()
};
let report = CoherenceDriftReport {
    top: ContextObservation::observed(s.clone()),
    iframe: ContextObservation::observed(s.clone()),
    worker: ContextObservation::skipped("Worker unsupported"),
    drifts: Vec::new(),
    freshness: None,
};
assert!(report.is_coherent());
assert!(!report.has_hard_drift());
assert_eq!(report.observed_context_count(), 2);

Fields

top: ContextObservation

Top-level document observation.

iframe: ContextObservation

Same-origin iframe observation.

worker: ContextObservation

Dedicated/shared worker observation (best-effort, may be Skipped).

drifts: Vec<DriftDiagnostic>

Drift diagnostics comparing all available context pairs.

freshness: Option<FreshnessReport>

Optional freshness report attached when the probe was supplied with a crate::freshness::FreshnessContract.

Implementations

impl CoherenceDriftReport

pub const fn is_coherent(&self) -> bool

true when no drift diagnostics were emitted (i.e. all observed contexts are coherent). Skipped contexts are not counted as drift.

pub fn has_hard_drift(&self) -> bool

true when at least one DriftSeverity::Hard drift is present. Callers should treat this as a stealth regression.

pub fn observed_context_count(&self) -> usize

Number of contexts that were actually observed (not skipped).

pub fn skipped_context_count(&self) -> usize

Number of contexts skipped.

pub fn hard_drifts(&self) -> impl Iterator<Item = &DriftDiagnostic>

Iterate over all DriftSeverity::Hard diagnostics.

pub fn known_limitations(&self) -> impl Iterator<Item = &DriftDiagnostic>

Iterate over all DriftSeverity::KnownLimitation diagnostics.

Trait Implementations

impl Clone for CoherenceDriftReport

fn clone(&self) -> CoherenceDriftReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CoherenceDriftReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CoherenceDriftReport

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CoherenceDriftReport

impl PartialEq for CoherenceDriftReport

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CoherenceDriftReport

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CoherenceDriftReport