fix(robomp): promote deferred events on periodic sweep

Ran deferred-submission promotion on an independent timer in addition to the empty-queue path, so a sustained ordinary queue can no longer starve a rate-limited submitter after their rolling window frees. Added ROBOMP_DEFERRED_PROMOTION_SCAN_SECONDS to tune or disable the sweep.

Fixes #5882

python/robomp/src/config.py

@@ -129,6 +129,11 @@ class Settings(BaseSettings):
     rate_limit_default: int = Field(3, alias="ROBOMP_RATE_LIMIT_DEFAULT")
     rate_limit_contributor: int = Field(10, alias="ROBOMP_RATE_LIMIT_CONTRIBUTOR")
     rate_limit_unlimited_raw: str = Field("", alias="ROBOMP_RATE_LIMIT_UNLIMITED")
+    # How often the dispatcher sweeps deferred rate-limited events back into the
+    # queue as their submitters' rolling windows free up. The empty-queue path
+    # promotes immediately; this periodic sweep guarantees progress even while a
+    # sustained ordinary queue keeps `claim_next_event` returning work.
+    deferred_promotion_scan_seconds: float = Field(60.0, alias="ROBOMP_DEFERRED_PROMOTION_SCAN_SECONDS")
     # Logins (comma-separated, `@` prefix optional, case-insensitive) whose `@bot_login`
     # mentions are treated as authoritative directives. These accounts also
     # bypass rate limiting regardless of `author_association`.

python/robomp/src/queue.py

@@ -100,6 +100,11 @@ class WorkerPool:
         # restarted orchestrator doesn't burn CPU on a cold cache.
         if self.sandbox.natives_cache is not None and self.settings.natives_cache_gc_interval_seconds > 0:
             self._workers.append(asyncio.create_task(self._natives_cache_gc_loop(), name="robomp-natives-gc"))
+        # Periodic promotion of deferred rate-limited events. Runs independently
+        # of the empty-queue path so a sustained ordinary queue can't starve a
+        # submitter whose rolling window has since freed.
+        if self.settings.deferred_promotion_scan_seconds > 0:
+            self._workers.append(asyncio.create_task(self._deferred_promotion_loop(), name="robomp-deferred-promotion"))
 
     async def stop(self, *, drain_timeout: float = 25.0, kill_timeout: float = 5.0) -> None:
         """Halt the dispatcher, then drain (or kill) in-flight `_run_event` tasks.
@@ -186,6 +191,40 @@ class WorkerPool:
         except asyncio.CancelledError:
             raise
 
+    async def _deferred_promotion_loop(self) -> None:
+        """Sweep deferred rate-limited events back into the queue on a timer.
+
+        Sleeps the configured interval first, then re-admits any deferred event
+        whose submitter now has rolling-window capacity and wakes the dispatcher
+        so promoted rows are claimed promptly. Cancellation is the only exit;
+        any per-sweep failure is logged and the loop continues.
+        """
+        interval = self.settings.deferred_promotion_scan_seconds
+        log.info("deferred promotion loop online", extra={"interval": interval})
+        try:
+            while not self._stop.is_set():
+                try:
+                    await asyncio.wait_for(self._stop.wait(), timeout=interval)
+                    return  # stop was set during the wait
+                except TimeoutError:
+                    pass
+                try:
+                    promoted = await self._promote_deferred()
+                    if promoted:
+                        self.wake()
+                except Exception:
+                    log.exception("deferred promotion sweep raised")
+        except asyncio.CancelledError:
+            raise
+
+    async def _promote_deferred(self) -> int:
+        """Re-admit deferred events whose submitters regained window capacity."""
+        since = iso_seconds_ago(self.settings.rate_limit_window_seconds)
+        promoted = await asyncio.to_thread(self.db.promote_deferred_submissions, since=since)
+        if promoted:
+            log.info("deferred submissions promoted", extra={"count": promoted})
+        return promoted
+
     async def _dispatch_loop(self) -> None:
         log.info("dispatch loop online")
         try:
@@ -214,11 +253,8 @@ class WorkerPool:
             # Naive but fine for v1 (small queue).
             row = await asyncio.to_thread(self.db.claim_next_event)
             if row is None:
-                since = iso_seconds_ago(self.settings.rate_limit_window_seconds)
-                promoted = await asyncio.to_thread(self.db.promote_deferred_submissions, since=since)
-                if not promoted:
+                if not await self._promote_deferred():
                     return None
-                log.info("deferred submissions promoted", extra={"count": promoted})
                 row = await asyncio.to_thread(self.db.claim_next_event)
                 if row is None:
                     return None