supervisor_machines 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcf2434ae701ae257e80d7203631c5a771fe2f918fb30ccc654e7cfb8a4bdedd
-  data.tar.gz: e49e4fb0b7b99f34a0e81ac06e68bc3b22244253a34877410130568a4303bd9d
+  metadata.gz: f36d17f94d2e12b476ab45bf7bf3d4e0f2ff0b7f936866fe110802dec8d7cb74
+  data.tar.gz: 9514f57779388f9574596178e9812b71873ae8a40630c91a98c821bad3f03347
 SHA512:
-  metadata.gz: aba61a49c4e301984d91c9bd9e6c85da75672038ded38bb7a9d3ed26b661a1d16bf5a2befe4b5d58fdb47c1f5119e8050672feb1b2c1ba6504d800198a226260
-  data.tar.gz: 2cfeba21ac509d76ae75018c8c8811f0d52a3f9462c234b26b1d451f7afcd35b45dcdc7a99bd21afe8f6e8b3880753f655929fc3cab8462dde9789fd7d97a679
+  metadata.gz: 3aeac1b644cc8ea8e9ec41748b44c9e541a8be0ac5287b73e6047aa598d146542a8e6a3312d96e07af93ab05bb5be483dcbe5110910897912578b77d248514d3
+  data.tar.gz: 4d8fd693df515ced5543be1a6e15a5b12ea1162deb27f9d71996aaf8cef1a805d93162b130fa88254dc771a6596b5c7f962dfa4cd682815dccdf532e4533480e

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.1.3](https://github.com/seuros/supervisor_machines/compare/supervisor_machines/v0.1.2...supervisor_machines/v0.1.3) (2026-11-01)
+
+
+### Bug Fixes
+
+* enable the rb-sys compiled fallback so new Rubies can build ([ef51e18](https://github.com/seuros/supervisor_machines/commit/ef51e18b3fe96522ce56ace91d93055e33996e78))
+* raise the chrono_machines floor to 0.12.1 ([20b6538](https://github.com/seuros/supervisor_machines/commit/20b6538967c3e6bde705c8822d3a53ad6a07a1f6))
+
+## [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,13 +252,14 @@ 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",
+ "rb-sys",
  "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>"]
@@ -17,3 +17,15 @@ workspace = true
 [dependencies]
 supervisor-machines = { workspace = true, features = ["std"] }
 magnus = { version = ">= 0.9.3", default-features = false, features = ["io"] }
+# Nothing here calls rb-sys directly: this is the compiled fallback that
+# implements the stable API for a Ruby rb-sys has no pre-generated bindings
+# for, such as a preview. magnus asks for "stable-api" without it, and
+# default-features = false drops the default that would have supplied it, so
+# removing this line breaks the build on every future Ruby.
+# Nothing here calls rb-sys directly: this is the compiled fallback that
+# implements the stable API for a Ruby rb-sys ships no pre-generated bindings
+# for, such as a preview. magnus asks for "stable-api" without it, and its
+# default-features = false drops the default that would have supplied it, so
+# dropping this line breaks the build on every Ruby newer than rb-sys.
+rb-sys = { version = ">= 0.9.130", default-features = false, features = ["stable-api-compiled-fallback"] }
+

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.3'
 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.3
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: 0.12.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: 0.12.1
 - !ruby/object:Gem::Dependency
   name: deadline_machines
   requirement: !ruby/object:Gem::Requirement