🤖 fix: eliminate debounce race conditions in ReviewPanel auto-refresh

[ammar-agent]

Extract refresh logic into a dedicated useReviewRefreshController hook that centralizes all refresh decision-making and eliminates race conditions.

Changes

• New useReviewRefreshController hook (~300 LoC) with:

  • Debounced tool completion handling (3s window)
  • Hidden tab detection (queue + flush on visibilitychange)
  • User interaction pausing (queue + flush on blur)
  • In-flight coalescing (single follow-up after fetch completes)
  • Scroll position preservation

• Simplified ReviewPanel:

  • Removed ~125 lines of inline refresh logic
  • Single integration point via the hook

Race condition fixes

Issue	Before	After
Stale closure capture	Timer captured filters.diffBase at schedule time	All state read from refs at execution time
Hidden tab	❌ Refresh dropped silently	✅ Queued, flush on visibilitychange
Refresh during origin fetch	❌ Dropped silently	✅ Single follow-up queued
Timer cleanup	Closure variable could go stale	Refs allow cleanup from any path

Regression risk: MEDIUM-LOW

Preserved behaviors:

• 3s debounce timing (same constant)
• Origin fetch logic (same shell injection protection)
• User interaction pausing (same isPanelFocused tracking)
• Scroll position preservation

New behaviors (improvements):

• Hidden-tab refreshes now queued instead of dropped
• In-flight requests coalesce to single follow-up instead of dropped

Manual smoke test checklist:

• Open ReviewPanel with origin/main base
• Run bash tool that modifies files → refresh ~3s after
• Trigger tool during refresh → one additional refresh after first completes
• Hide tab during tool, show tab → refresh fires on visible
• Focus panel, trigger tool, blur → refresh fires after blur

---

Generated with mux • Model: anthropic:claude-opus-4-5 • Thinking: high