docs(post-A.5 #53): Tier 1 cache — implementation plan (writing-plans)
17-task TDD-style plan for the Tier 1 entity-classification cache, sized
~5-7 days. Phases:
Phase 1 (Tasks 1-5): Cache foundation — extract GroupKey, build the
cache class with TryGet/Populate/InvalidateEntity/
InvalidateLandblock, and 11 pure-CPU tests.
Phase 2 (Tasks 6-10): Dispatcher integration — plumb landblockId
through the walk scratch, inject the cache,
wire ClassifyBatches collector + cache-miss
populate + cache-hit fast path. +2 integration
tests.
Phase 3 (Tasks 11-12): Invalidation hooks — wire InvalidateEntity from
RemoveLiveEntityByServerGuid + InvalidateLandblock
from GpuWorldState.RemoveEntitiesFromLandblock
via callback (W3b per spec §5.3).
Phase 4 (Task 13): DEBUG cross-check — assert membership predicate
+ DebugCrossCheck method + 2 unit tests via
TraceListener capture.
Phase 5 (Tasks 14-16): Verification — full suite + sentinel + visual
gate (user) + perf gate (user, ≤2.0 ms median).
Phase 6 (Task 17): Ship — ISSUES + CLAUDE.md + memory + final commit.
Plan resolves spec §11 open implementation choices: W3b for LB invalidation,
GroupKey at namespace internal, ResolveLandblockHint plumbed via walk
scratch, _populateScratch as a field.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2f8a574b92