docs: document semantic_cache_max_candidates recall tradeoff

In semantic response caching (PR #2029), max_candidates=10 limits recall. Users should understand this tradeoff. Document in config help, CLAUDE.md, and debug logs.