dangernoodle-io / breadboard / 28738026202

100%

push

github

feat: bb_cache age-out eviction (LAZY + SWEEP backstop, B1-592 A3) (#726)

- add pure bb_cache_evaluate_age() classifier (FRESH/STALE/EVICT), shared by
  both eviction paths and directly host-testable
- add per-key BB_CACHE_EVICT_AGE_OUT policy (owned-mode only) with
  stale_age_ms/evict_age_ms, validated at register time; zero-init preserves
  today's never-auto-free (PINNED) behavior
- LAZY eviction at every read call site (serialize_locked, get_serialized,
  get_raw, post_serialized); opt-in SWEEP backstop task (CONFIG_BB_CACHE_
  SWEEP_ENABLE) for keys that may go unread
- add bb_cache_is_stale() non-destructive staleness probe
- add injectable test clock (bb_cache_test_set_clock) for deterministic
  age-out tests, no real sleeps
- revise A2: move fire_on_remove out of bb_cache_reactive_delete() into a
  one-way bb_cache_set_evict_notify_fn() hook fired by bb_cache_delete()
  itself, so explicit deletes AND age-out evictions both fire on_remove
  through the same path

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2788 of 2788 branches covered (100.0%)

Branch coverage included in aggregate %.

123 of 123 new or added lines in 3 files covered. (100.0%)

4646 of 4646 relevant lines covered (100.0%)

10375.79 hits per line