Struct RouterDecision 

pub struct RouterDecision {
    pub kind: InterstitialKind,
    pub severity: InterstitialSeverity,
    pub route: InterstitialRoute,
    pub reason: String,
    pub evidence: PageSignatureEvidence,
    pub classified_at_unix_ms: u64,
}

Result of routing a PageSignature.

The decision carries:

• kind — the structural classification from InterstitialClassifier.
• severity — dedicated observability field distinguishing retryable / requires-solve / terminal tiers. Observability tooling should branch on this field rather than the kind enum when the question is “is the run terminal vs retryable”.
• route — the dedicated acquisition route per kind.
• reason — short human-readable rationale.
• evidence — the per-signature matches that drove the decision.
• classified_at_unix_ms — wall-clock timestamp the decision was produced.

Fields

kind: InterstitialKind

Structural classification.

severity: InterstitialSeverity

Dedicated operational severity tier. Distinguishes Queue (retryable) from HardBlock (terminal) for observability tooling.

route: InterstitialRoute

Dedicated acquisition route.

reason: String

Compact human-readable rationale.

evidence: PageSignatureEvidence

Per-signature evidence that drove the decision.

classified_at_unix_ms: u64

Wall-clock timestamp the decision was produced.

Implementations

impl RouterDecision

pub fn new( kind: InterstitialKind, route: InterstitialRoute, reason: impl Into<String>, evidence: PageSignatureEvidence, ) -> Self

Build a decision with the supplied fields and the current wall-clock timestamp.

pub const fn with_timestamp(self, unix_ms: u64) -> Self

Build a decision with an explicit classified_at_unix_ms (useful for tests and deterministic replay).

pub const fn kind(&self) -> InterstitialKind

Structural classification kind.

pub const fn severity(&self) -> InterstitialSeverity

Operational severity tier (dedicated observability field).

pub const fn route(&self) -> &InterstitialRoute

Dedicated acquisition route.

pub const fn evidence(&self) -> &PageSignatureEvidence

Per-signature evidence.

pub fn reason(&self) -> &str

Compact human-readable rationale.

pub const fn is_classified(&self) -> bool

true when the decision is for a classified interstitial (kind != transient). Used by the runner to decide whether to short-circuit.

pub const fn is_terminal(&self) -> bool

true when the severity is InterstitialSeverity::Terminal.

pub const fn requires_solve(&self) -> bool

true when the severity is InterstitialSeverity::RequiresSolve.

pub const fn is_retryable(&self) -> bool

true when the severity is InterstitialSeverity::Retryable.

pub fn log(&self)

Emit a structured tracing event for the decision. Always emits at info for classified decisions and at debug for transient ones so a single tracing-subscriber filter can be used to suppress the noisy transient path while keeping the classified path visible.

Trait Implementations

impl Clone for RouterDecision

fn clone(&self) -> RouterDecision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RouterDecision

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RouterDecision

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RouterDecision

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

Formats the value using the given formatter.

impl PartialEq for RouterDecision

fn eq(&self, other: &RouterDecision) -> 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 RouterDecision

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RouterDecision

impl StructuralPartialEq for RouterDecision