stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
9ca2de05dff9c7db11eb49df6d4e47bbfe7a99f6
git.stella-ops.org/docs/features/checked/concelier/concelier-lnm-linkset-cache-with-telemetry.md
master 9ca2de05df more features checks. setup improvements
2026-02-13 02:04:55 +02:00

2.6 KiB
Raw Blame History

Concelier LNM Linkset Cache with Telemetry

Module

Concelier

Status

VERIFIED

Description

PostgreSQL-backed deterministic cache for Link-Not-Merge advisory linksets with telemetry instrumentation, OpenAPI spec, and deprecation headers. While "Link-Not-Merge Advisory Architecture" is in the known list, this specific linkset caching with persistence and telemetry is a distinct implementation detail.

Implementation Details

  • Modules: src/Concelier/__Libraries/StellaOps.Concelier.Core/Linksets/, src/Concelier/__Libraries/StellaOps.Concelier.Persistence/, src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/
  • Key Classes:
    • LinksetCorrelationService (src/Concelier/__Libraries/StellaOps.Concelier.Core/Linksets/LinksetCorrelationService.cs) - main service for linkset correlation and caching
    • LinksetCorrelationV2 (src/Concelier/__Libraries/StellaOps.Concelier.Core/Linksets/LinksetCorrelationV2.cs) - V2 algorithm for linkset correlation
    • LinksetCorrelation (src/Concelier/__Libraries/StellaOps.Concelier.Core/Linksets/LinksetCorrelation.cs) - V1 linkset correlation logic
    • ValkeyAdvisoryCacheService (src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/ValkeyAdvisoryCacheService.cs) - Valkey-backed caching layer
    • AdvisoryCacheKeys (src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/AdvisoryCacheKeys.cs) - deterministic cache key generation
  • Interfaces: ILinksetCorrelationService, IAdvisoryCacheService
  • Source: Sprint 0112 (batch_14/file_13.md)

E2E Test Plan

  • Request a linkset for a known CVE and verify the correlation result is returned
  • Verify caching: request the same linkset twice and confirm the second call is served from cache
  • Verify telemetry: confirm cache hit/miss metrics are emitted via OpenTelemetry
  • Verify determinism: identical linkset inputs produce identical cache keys via AdvisoryCacheKeys
  • Verify V2 algorithm: use LinksetCorrelationV2 and verify improved correlation accuracy over V1

Verification

  • Run ID: run-001
  • Date: 2026-02-13
  • Result: PASS - Core.Tests 452/454 (2 pre-existing), Cache.Valkey.Tests 88/97 (9 perf skipped). 47 targeted tests across LinksetCorrelationV2Tests (25), AdvisoryCacheKeysTests (20), AdvisoryLinksetDeterminismTests (2) verify V2 correlation algorithm (alias connectivity, IDF package coverage, positive-only reference scores, typed conflict severity, patch lineage, version compatibility, integrated scoring, determinism), deterministic cache key generation (PURL/CVE normalization, truncation, extraction), and linkset idempotency.