Struct LearningCache 

pub struct LearningCache { /* private fields */ }

On-disk learning cache.

Keys are JSON-serialized CacheKey strings because JSON object keys must be strings.

Implementations

impl LearningCache

pub fn open_default() -> Result<Self, LearningCacheError>

Open the default cache at ~/.wafrift/learning_cache.json.

Errors

Returns an error if the home directory cannot be determined.

pub fn open(path: impl AsRef<Path>) -> Result<Self, LearningCacheError>

Open or create a cache at a specific path.

A corrupted cache file (kill-9 mid-save, disk corruption, partial flush) is moved aside to <path>.corrupt-<epoch> and a fresh empty cache is returned. Crashing the whole strategy engine on one bad JSON file would lose all subsequent learning — better to surface the corruption via tracing::warn and keep going.

Errors

Returns an error only if the file exists, looks fine, and the underlying I/O still fails (permission denied, etc.).

pub fn get(&self, key: &CacheKey) -> Option<&CacheEntry>

Look up a cached pipeline.

pub fn record_success(&mut self, key: CacheKey, pipeline: EvasionPipeline)

Record a successful bypass.

pub fn record_failure(&mut self, key: CacheKey, pipeline: EvasionPipeline)

Record a failed attempt.

pub fn save(&self) -> Result<(), LearningCacheError>

Persist the cache to disk atomically.

Writes to a sibling <path>.tmp.<pid>.<epoch> file, fsyncs it, then renames over the target path. A kill-9 between write and rename leaves the previous good cache file untouched instead of producing the half-written JSON that was poisoning subsequent open calls.

Errors

Returns an error if the file cannot be written or renamed.

pub fn keys(&self) -> Vec<CacheKey>

All cached keys.

Trait Implementations

impl Clone for LearningCache

fn clone(&self) -> LearningCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LearningCache

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

Formats the value using the given formatter.

impl Default for LearningCache

fn default() -> LearningCache

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LearningCache

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LearningCache

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

where __S: Serializer,

Serialize this value into the given Serde serializer.