Struct ChallengeMemoryEntry 

pub struct ChallengeMemoryEntry {
    pub key: EngineKey,
    pub last_observed_url: Option<String>,
    pub last_outcome: ChallengeOutcome,
    pub observation_count: u32,
    pub recorded_at_unix_secs: u64,
}

One entry in the challenge memory.

An entry represents the last observed outcome for a single EngineKey, along with a count of how many times the runner has recorded an outcome for that key (capped at u32::MAX for monotonic counters) and the last URL the runner saw the outcome on (kept as a secondary debugging index only — the primary key is the engine, not the URL). The TTL is owned by the LRU+TTL store backing the ChallengeMemory — once the LRU entry expires, the whole entry is dropped and the runner falls back to the unadjusted risk score.

Example

use stygian_charon::challenge_feedback::{ChallengeMemoryEntry, ChallengeOutcome, EngineKey};
use stygian_charon::types::TargetClass;
use stygian_charon::vendor_classifier::VendorId;

let entry = ChallengeMemoryEntry {
    key: EngineKey {
        engine: VendorId::Cloudflare,
        version: None,
        target_class: TargetClass::ContentSite,
        tls_profile: None,
    },
    last_observed_url: Some("https://example.com/path".to_string()),
    last_outcome: ChallengeOutcome::HardChallenge,
    observation_count: 1,
    recorded_at_unix_secs: 1_700_000_000,
};
assert_eq!(entry.risk_delta(), ChallengeOutcome::HardChallenge.risk_delta());

Fields

key: EngineKey

Primary identity of this entry — the engine, target class, version, and TLS profile the entry was recorded under.

last_observed_url: Option<String>

Optional last URL the outcome was observed on. Kept for debugging (“where did we last see this engine?”) — it is NOT a primary key. Two different URLs on the same engine share the same memory entry.

last_outcome: ChallengeOutcome

Most recently recorded outcome for this key.

observation_count: u32

Number of outcomes the runner has recorded for this key (saturating on overflow).

recorded_at_unix_secs: u64

Unix epoch seconds when the entry was last updated.

Implementations

impl ChallengeMemoryEntry

pub const fn risk_delta(&self) -> f64

Risk-score contribution this entry would add to the next policy. Delegates to ChallengeOutcome::risk_delta and is therefore bounded by MAX_RISK_DELTA.

pub const fn target_class(&self) -> TargetClass

Convenience accessor for the entry’s target class. Mirrors EngineKey::target_class so callers do not have to reach through entry.key.target_class.

pub const fn engine(&self) -> VendorId

Convenience accessor for the entry’s engine. Mirrors EngineKey::engine so callers do not have to reach through entry.key.engine.

Trait Implementations

impl Clone for ChallengeMemoryEntry

fn clone(&self) -> ChallengeMemoryEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChallengeMemoryEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChallengeMemoryEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ChallengeMemoryEntry

impl PartialEq for ChallengeMemoryEntry

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

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 ChallengeMemoryEntry