omq 0.17.0 → 0.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5d4d1943efe37da6ad5493f80591b9578467e0c470fd4e2a577968580609cd
-  data.tar.gz: 8476b90cc637629874c94388cd91ae7a6f3ce3aaac410af1aa77c3fbd6470412
+  metadata.gz: d74a6fe050e6b3a4130110d02b786b96dfe5c56f4ddd7436412440b1767e4341
+  data.tar.gz: 94549607bd5378704e6c053f7d49d872c87379acd6cd7c1b960340dad7f9ed70
 SHA512:
-  metadata.gz: 67b62142c8786b9594efdf5f62f0aef8b5329498a04faafec760305cb73d3de354b6f4dd7f5db3e416f4e69e683b1c60ad7920a879fb72c7942d602af2088715
-  data.tar.gz: 2731913ad5262a1d0038af1887b3c2bb167df719b650dd99d3d59812573180adb0e528eeaafba021823f12d7e8a38dbad92b8df07a9d6bac98a4534b71ae3cfc
+  metadata.gz: 8c405863b11243bdc0eee221c7183fa4052748e3c12cc204b57c577dfe98e86541b196be4cbb07ac9f024a35dea78c7a765f0e37109d12e5a5898fc50b521039
+  data.tar.gz: cf39178da5ec5250b18822e7de437b910679985e01c96c61e4d50389fdf3318403d1ccc2024516940a13c13b44ad0fe8adda83770cfcb2da678f486c6e1f4a23

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.17.1 — 2026-04-10
+
+### Changed
+
+- **Reconnect sleeps are wall-clock quantized.** `Engine::Reconnect`
+  now sleeps until the next `delay`-sized grid tick instead of `delay`
+  from now (same math as `Async::Loop.quantized`). Multiple clients
+  reconnecting with the same interval wake up at the same instant,
+  collapsing staggered retries into aligned waves — easier to reason
+  about for observability and cache-warmup, and a server coming back
+  up sees one batch of accepts instead of a smear. Wall-clock (not
+  monotonic) on purpose: the grid has to line up across processes.
+  Anti-jitter by design. Exponential backoff still works: each
+  iteration quantizes to its own (growing) interval's grid, and
+  clients at the same backoff stage still align with each other.
+
 ## 0.17.0 — 2026-04-10
 
 ### Changed

data/lib/omq/engine/reconnect.rb

@@ -42,7 +42,7 @@ module OMQ
         @engine.tasks << parent_task.async(transient: true, annotation: "reconnect #{@endpoint}") do
           loop do
             break if @engine.closed?
-            sleep delay if delay > 0
+            sleep quantized_wait(delay) if delay > 0
             break if @engine.closed?
             begin
               @engine.transport_for(@endpoint).connect(@endpoint, @engine)
@@ -60,6 +60,25 @@ module OMQ
 
       private
 
+      # Wall-clock quantized sleep: wait until the next +delay+-sized
+      # grid tick. Multiple clients reconnecting with the same interval
+      # wake up at the same instant, collapsing staggered retries into
+      # aligned waves. Same math as +Async::Loop.quantized+.
+      #
+      # Wall-clock (not monotonic) on purpose: the grid has to line up
+      # across processes, and monotonic clocks don't share an origin.
+      # Anti-jitter by design — if you want spread, don't call this.
+      #
+      # @param delay [Numeric] grid interval in seconds
+      # @param now [Float] wall-clock time in seconds (injectable for tests)
+      # @return [Float] seconds to sleep, always in (0, delay]
+      #
+      def quantized_wait(delay, now = Time.now.to_f)
+        wait = delay - (now % delay)
+        wait.positive? ? wait : delay
+      end
+
+
       def init_delay(delay)
         ri = @options.reconnect_interval
         if ri.is_a?(Range)

data/lib/omq/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OMQ
-  VERSION = "0.17.0"
+  VERSION = "0.17.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omq
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.17.1
 platform: ruby
 authors:
 - Patrik Wenger