more audit work

src/__Libraries/StellaOps.ReachGraph.Cache/AGENTS.md

@@ -0,0 +1,24 @@
+# ReachGraph Cache Library Charter
+
+## Mission
+- Provide a Valkey/Redis cache layer for reachability graphs and slices.
+
+## Responsibilities
+- Avoid keyspace scans; use paging/SCAN for invalidation across cluster endpoints.
+- Honor cancellation and timeouts where possible for cache operations.
+- Keep cache serialization deterministic and size-bounded.
+
+## Required Reading
+- docs/modules/reach-graph/architecture.md
+- docs/modules/platform/architecture-overview.md
+
+## Working Directory & Scope
+- Primary: src/__Libraries/StellaOps.ReachGraph.Cache
+
+## Testing Expectations
+- Unit tests for cache get/set, compression, and invalidation.
+- Tests for cancellation/timeout behavior and multi-endpoint invalidation.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and ASCII-only in comments and logs.

src/__Libraries/StellaOps.ReachGraph.Cache/TASKS.md

@@ -0,0 +1,10 @@
+# ReachGraph Cache Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/permament/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0103-M | DONE | Revalidated 2026-01-08; maintainability audit for ReachGraph.Cache. |
+| AUDIT-0103-T | DONE | Revalidated 2026-01-08; test coverage audit for ReachGraph.Cache. |
+| AUDIT-0103-A | TODO | Pending approval (revalidated 2026-01-08). |