docs: document compact retry behavior

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>