[Caideyipi]

Description

Replicated WAL entries can arrive after a subscription prefetch worker becomes idle without advancing the local WAL search index or entering the realtime queue. Repeated polls can then stay empty until another event wakes the worker.

Wake a bound idle prefetch worker after an empty poll, with a per-queue 100 ms limit enforced by a monotonic-clock CAS. Preserve the initialization, seek, close, and executor-binding guards. Add regression tests for late remote-entry delivery and acknowledgement with zero local WAL gap, and for suppression immediately before the wakeup interval and grant at its boundary.

Validation

At commit 3a343faaff65424068f357819ecfe97c8a41ca9d:

• Clean reactor run of ConsensusPrefetchingQueueSeekTest: 11 tests passed.
• Clean local reactor run of both newly added tests: 2 tests passed; all 28 modules succeeded, with 482/482 Maven goals executed and no build-cache restores.
• Spotless and git diff --check passed.

The full test suite and distributed integration tests have not been run on this commit.

---

This PR has:

• been self-reviewed, including concurrent read and write paths.
• added comments explaining why the idle worker needs another wakeup.
• added unit tests for late remote WAL delivery and the wakeup interval boundary.

---

Key changed/added classes

• ConsensusPrefetchingQueue
• ConsensusPrefetchingQueueSeekTest

[sonarqubecloud]

Quality Gate passed

Issues
25 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.8% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

❌ Patch coverage is 0% with 11 lines in your changes missing coverage. Please review.
✅ Project coverage is 48.79%. Comparing base (36c35f6) to head (3a343fa).
⚠️ Report is 2 commits behind head on master.

Files with missing lines	Patch %	Lines
...on/broker/consensus/ConsensusPrefetchingQueue.java	0.00%	11 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master   #19194      +/-   ##
============================================
- Coverage     48.80%   48.79%   -0.01%     
  Complexity      674      674              
============================================
  Files          5574     5574              
  Lines        412836   412845       +9     
  Branches      54448    54452       +4     
============================================
- Hits         201480   201458      -22     
- Misses       211356   211387      +31     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.