stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
cf5b72974f923126944f4dcd47e85864ebb31a3b
git.stella-ops.org/docs/features/unchecked/concelier/valkey-advisory-cache-service.md

1.7 KiB
Raw Blame History

Valkey Advisory Cache Service

Module

Concelier

Status

IMPLEMENTED

Description

Valkey (Redis-compatible) caching layer for canonical advisories with TTL policies based on interest score, PURL index lookups, hot set ranking, and p99 < 20ms read target. Includes cache warmup, metrics, and fallback mode.

Implementation Details

  • Modules: src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/
  • Key Classes:
    • ValkeyAdvisoryCacheService (src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/ValkeyAdvisoryCacheService.cs) - Valkey-backed cache with TTL policies, PURL index, and hot set ranking
    • AdvisoryCacheKeys (src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/AdvisoryCacheKeys.cs) - deterministic cache key generation for advisory lookups
    • CachingCanonicalAdvisoryService (src/Concelier/__Libraries/StellaOps.Concelier.Core/Canonical/CachingCanonicalAdvisoryService.cs) - caching decorator wrapping the canonical advisory service
  • Interfaces: IAdvisoryCacheService
  • Source: SPRINT_8200_0013_0001_GW_valkey_advisory_cache.md

E2E Test Plan

  • Store a canonical advisory in Valkey and retrieve it, verifying p99 read latency is < 20ms
  • Verify TTL policy: high-interest advisories have longer TTLs than low-interest ones
  • Verify PURL index lookup: query by PURL and verify matching advisories are returned from cache
  • Verify hot set ranking: frequently accessed advisories are promoted in the hot set
  • Verify cache warmup: on startup, verify high-interest advisories are pre-loaded into cache
  • Verify fallback mode: disable Valkey and confirm the service falls back to direct PostgreSQL queries