git.stella-ops.org/src/__Libraries/StellaOps.Provcache.Valkey/AGENTS.md

Provcache Valkey Library Charter

Mission

• Provide Valkey/Redis-backed caching for Provcache with deterministic keying and TTL behavior.

Responsibilities

• Keep key prefixing and invalidation deterministic and bounded.
• Propagate cancellation where supported by the client library.
• Avoid full keyspace scans in production paths.

Required Reading

• docs/modules/prov-cache/architecture.md
• docs/modules/platform/architecture-overview.md

Working Directory & Scope

• Primary: src/__Libraries/StellaOps.Provcache.Valkey

Testing Expectations

• Add unit tests for cache hit/miss, TTL handling, and invalidation flows.
• Validate batch operations and pattern invalidation safeguards.

Working Agreement

• Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
• Keep outputs deterministic and ASCII-only in comments/logs.