supervisor_machines 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcf2434ae701ae257e80d7203631c5a771fe2f918fb30ccc654e7cfb8a4bdedd
-  data.tar.gz: e49e4fb0b7b99f34a0e81ac06e68bc3b22244253a34877410130568a4303bd9d
+  metadata.gz: 4bf7a41206e6cbcfee1fe15b9aa43d51bc97736624c453ae1cb52b8d80c401e9
+  data.tar.gz: ac38ec2c1d4e7ce698131772c65ff29947872bbce60d6cb00e26d90a29d0c094
 SHA512:
-  metadata.gz: aba61a49c4e301984d91c9bd9e6c85da75672038ded38bb7a9d3ed26b661a1d16bf5a2befe4b5d58fdb47c1f5119e8050672feb1b2c1ba6504d800198a226260
-  data.tar.gz: 2cfeba21ac509d76ae75018c8c8811f0d52a3f9462c234b26b1d451f7afcd35b45dcdc7a99bd21afe8f6e8b3880753f655929fc3cab8462dde9789fd7d97a679
+  metadata.gz: d45aef2c0fe1ddc6d452acf4f31dcda2346114ab49b8649ceb16c7dacaa215eba9e14d9dc5e4a85e196da27b4ba1717c7a38b122bc788c721dcf0b0e50979784
+  data.tar.gz: 30f63a1c9052a7bd623dea553a6d6d1d51b491cd032dfae7631d1d99296c3f248d0338348c31fe2881c1e2cbc889f4d6044ca12098488fe28dca030d386d10df

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.1.2](https://github.com/seuros/supervisor_machines/compare/supervisor_machines/v0.1.1...supervisor_machines/v0.1.2) (2026-11-01)
+
+
+### Features
+
+* back off granted restarts by recent restart count ([e7532e8](https://github.com/seuros/supervisor_machines/commit/e7532e8e98e43171c8d76f176161fdea50403a27))
+
+
+### Bug Fixes
+
+* a republished platform gem is skipped, not fatal ([39160e7](https://github.com/seuros/supervisor_machines/commit/39160e7e295d58500d846fb56d190eff6e803151))
+
 ## [0.1.1](https://github.com/seuros/supervisor_machines/compare/supervisor_machines-v0.1.0...supervisor_machines/v0.1.1) (2026-11-01)
 
 

data/Cargo.lock

@@ -252,11 +252,11 @@ checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
 
 [[package]]
 name = "supervisor-machines"
-version = "0.2.0"
+version = "0.3.0"
 
 [[package]]
 name = "supervisor_machines_native"
-version = "0.1.1"
+version = "0.1.2"
 dependencies = [
  "magnus",
  "supervisor-machines",

data/ext/supervisor_machines_native/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "supervisor-machines"
-version = "0.2.0"
+version = "0.3.0"
 edition.workspace = true
 rust-version.workspace = true
 authors = ["Abdelkader Boudih <oss@seuros.com>"]

data/ext/supervisor_machines_native/core/src/supervisor.rs

@@ -97,6 +97,58 @@ impl<const CHILDREN: usize, const HISTORY: usize> Supervisor<CHILDREN, HISTORY>
         counted
     }
 
+    /// How long to hold off the restart just granted: `base_ns` doubled once
+    /// per restart already inside the window, capped at `ceiling_ns`.
+    ///
+    /// Neither OTP nor [`stopped`](Self::stopped) imposes a delay, so a
+    /// supervisor that restarts the moment a child dies spends its whole
+    /// intensity budget in the time it takes to fail that many times. For a
+    /// child that dies while being constructed that is well under a
+    /// millisecond, and the window the intensity was written for never gets to
+    /// mean anything. Waiting this long between the decision and the restart
+    /// spreads the budget back over that window.
+    ///
+    /// The count decays as the window slides, so a child that settles returns
+    /// to `base_ns` on its own. Jitter is the caller's to add.
+    ///
+    /// ```
+    /// use supervisor_machines::{Exit, Intensity, Policy, Strategy, Supervisor};
+    ///
+    /// const MS: u64 = 1_000_000;
+    ///
+    /// let mut tree: Supervisor<1, 8> = Supervisor::new(
+    ///     Strategy::OneForOne,
+    ///     Intensity::new(5, 60_000 * MS),
+    /// );
+    ///
+    /// // The first restart waits the base, each further one twice as long.
+    /// tree.stopped(0, Policy::Permanent, Exit::Abnormal, 0);
+    /// assert_eq!(tree.restart_delay_ns(100 * MS, 10_000 * MS, 0), 100 * MS);
+    ///
+    /// tree.stopped(0, Policy::Permanent, Exit::Abnormal, MS);
+    /// assert_eq!(tree.restart_delay_ns(100 * MS, 10_000 * MS, MS), 200 * MS);
+    ///
+    /// // Once the window has slid past them the delay is back to the base.
+    /// assert_eq!(
+    ///     tree.restart_delay_ns(100 * MS, 10_000 * MS, 120_000 * MS),
+    ///     100 * MS,
+    /// );
+    /// ```
+    #[must_use]
+    pub const fn restart_delay_ns(&self, base_ns: u64, ceiling_ns: u64, now_ns: u64) -> u64 {
+        let mut delay = base_ns;
+        let mut doublings = self.recent_restarts(now_ns).saturating_sub(1);
+        while doublings > 0 && delay < ceiling_ns {
+            delay = delay.saturating_mul(2);
+            doublings -= 1;
+        }
+        if delay > ceiling_ns {
+            ceiling_ns
+        } else {
+            delay
+        }
+    }
+
     /// The children a failure at `index` takes with it under this strategy.
     #[must_use]
     pub const fn span(&self, index: usize) -> Span {

data/ext/supervisor_machines_native/ffi/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "supervisor_machines_native"
-version = "0.1.1"
+version = "0.1.2"
 edition.workspace = true
 rust-version.workspace = true
 authors = ["Abdelkader Boudih <oss@seuros.com>"]

data/ext/supervisor_machines_native/ffi/src/decider.rs

@@ -30,6 +30,7 @@ trait Decide: Send {
     fn strategy(&self) -> Strategy;
     fn terminated(&self) -> bool;
     fn recent_restarts(&self, now_ns: u64) -> u32;
+    fn restart_delay_ns(&self, base_ns: u64, ceiling_ns: u64, now_ns: u64) -> u64;
     fn stopped(&mut self, index: usize, policy: Policy, exit: Exit, now_ns: u64) -> Decision;
 }
 
@@ -54,6 +55,10 @@ impl<const CHILDREN: usize> Decide for Shape<CHILDREN> {
         self.0.recent_restarts(now_ns)
     }
 
+    fn restart_delay_ns(&self, base_ns: u64, ceiling_ns: u64, now_ns: u64) -> u64 {
+        self.0.restart_delay_ns(base_ns, ceiling_ns, now_ns)
+    }
+
     fn stopped(&mut self, index: usize, policy: Policy, exit: Exit, now_ns: u64) -> Decision {
         self.0.stopped(index, policy, exit, now_ns)
     }
@@ -164,6 +169,23 @@ impl Wrapper {
         self.0.borrow().recent_restarts(now_ns)
     }
 
+    /// How long to hold off a granted restart, backing off per restart already
+    /// inside the window.
+    fn restart_delay_ns(rb_self: &Self, args: &[Value]) -> Result<u64, Error> {
+        let args = scan_args::<(), (), (), (), RHash, ()>(args)?;
+        let (Whole(base_ns), Whole(ceiling_ns), Whole(now_ns)) =
+            get_kwargs::<_, (Whole<u64>, Whole<u64>, Whole<u64>), (), ()>(
+                args.keywords,
+                &["base_ns", "ceiling_ns", "now_ns"],
+                &[],
+            )?
+            .required;
+        Ok(rb_self
+            .0
+            .borrow()
+            .restart_delay_ns(base_ns, ceiling_ns, now_ns))
+    }
+
     fn inspect(ruby: &Ruby, rb_self: &Self) -> String {
         format!(
             "#<SupervisorMachines::Decider strategy={} children={} terminated={}>",
@@ -185,6 +207,7 @@ pub fn define(ruby: &Ruby, module: RModule) -> Result<(), Error> {
     class.define_method("strategy", method!(Wrapper::strategy, 0))?;
     class.define_method("terminated?", method!(Wrapper::terminated, 0))?;
     class.define_method("recent_restarts", method!(Wrapper::recent_restarts, 1))?;
+    class.define_method("restart_delay_ns", method!(Wrapper::restart_delay_ns, -1))?;
     class.define_method("inspect", method!(Wrapper::inspect, 0))?;
     Ok(())
 }

data/lib/supervisor_machines/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SupervisorMachines
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: supervisor_machines
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Abdelkader Boudih