supervisor_machines 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bcf2434ae701ae257e80d7203631c5a771fe2f918fb30ccc654e7cfb8a4bdedd
+  data.tar.gz: e49e4fb0b7b99f34a0e81ac06e68bc3b22244253a34877410130568a4303bd9d
+SHA512:
+  metadata.gz: aba61a49c4e301984d91c9bd9e6c85da75672038ded38bb7a9d3ed26b661a1d16bf5a2befe4b5d58fdb47c1f5119e8050672feb1b2c1ba6504d800198a226260
+  data.tar.gz: 2cfeba21ac509d76ae75018c8c8811f0d52a3f9462c234b26b1d451f7afcd35b45dcdc7a99bd21afe8f6e8b3880753f655929fc3cab8462dde9789fd7d97a679

data/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## [0.1.1](https://github.com/seuros/supervisor_machines/compare/supervisor_machines-v0.1.0...supervisor_machines/v0.1.1) (2026-11-01)
+
+
+### Features
+
+* OTP-style supervision decisions ([013b054](https://github.com/seuros/supervisor_machines/commit/013b0543abb42eff100032c286642e9c26f5a907))
+* pass a rubygems OTP through the environment ([d6b00e6](https://github.com/seuros/supervisor_machines/commit/d6b00e6f10606b4d8584d4f58999a184d2f749df))
+* supervise threads over the decision core ([c423f63](https://github.com/seuros/supervisor_machines/commit/c423f63ceef340edfaef7eb2774eb353046b7556))
+
+
+### Bug Fixes
+
+* a source install can build, and a failed gem push fails the release ([5907461](https://github.com/seuros/supervisor_machines/commit/5907461674b3fc53bcbc6c077b39d6b61d959eaf))
+* a started tree takes on no more children, and an unstarted one has no restarts ([49baae8](https://github.com/seuros/supervisor_machines/commit/49baae849adedfea8fc96ab18c8989e77e57edf7))
+* a stop no longer waits out the restart backoff ([5de0f95](https://github.com/seuros/supervisor_machines/commit/5de0f95db1f15ceb2a4eb8fb8114d7ee48a5da8b))
+* a stopped tree does not keep announcing its shutdown ([44f9e78](https://github.com/seuros/supervisor_machines/commit/44f9e78f8c5279be42fb29b10ef40ef8778b099b))
+* an in-family floor, not a pessimistic pin ([7113e08](https://github.com/seuros/supervisor_machines/commit/7113e087b649320fe1d0b1dba1c2dabb268be175))
+* bound the child index ([3761aab](https://github.com/seuros/supervisor_machines/commit/3761aab987111b4570aeaefc171175552d0c7948))
+* call starters and the backoff outside the supervisor's lock ([b656111](https://github.com/seuros/supervisor_machines/commit/b656111a32fe5623a44b1dd7f665d708839b17b5))
+* close six supervision lifecycle holes ([50d330f](https://github.com/seuros/supervisor_machines/commit/50d330f8bac893b75b8616b284bd0e1e1b006e99))
+* collect the built gems whatever depth the download puts them at ([961776d](https://github.com/seuros/supervisor_machines/commit/961776db5edbee33b2fbe87494e6c6ac7ee0d3f7))
+* give the tree lifecycle states so a failed start leaves nothing running ([dc7deba](https://github.com/seuros/supervisor_machines/commit/dc7debaff42f2440c80c6f43f057660c0a5c79a0))
+* refuse a fractional restart intensity instead of tightening it quietly ([ea34650](https://github.com/seuros/supervisor_machines/commit/ea34650c0480f12e824ec488daa911daeda30ccf))
+* ship the core's test files so the packaged crate builds ([4af208e](https://github.com/seuros/supervisor_machines/commit/4af208efd80a9e48275aedfe8e2137155acd59a0))
+* the release tag carries the gem name, and the gate uses the aggregate output ([49982d6](https://github.com/seuros/supervisor_machines/commit/49982d60eed580789d6d52502c0f275576139df3))
+* the tree reads the clock before taking its own lock ([6dd61ef](https://github.com/seuros/supervisor_machines/commit/6dd61efced111ae04b01ffdd7dfb4b559b0fd26e))

data/Cargo.lock

@@ -0,0 +1,286 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "bindgen"
+version = "0.72.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
+dependencies = [
+ "bitflags",
+ "cexpr",
+ "clang-sys",
+ "itertools",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "rustc-hash",
+ "shlex",
+ "syn",
+]
+
+[[package]]
+name = "bitflags"
+version = "2.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
+
+[[package]]
+name = "cexpr"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
+dependencies = [
+ "nom",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
+
+[[package]]
+name = "clang-sys"
+version = "1.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "157a8ba7b480713b56f4c09fd13fc3e0a22a5dfab8097ba61cbc5feef950788a"
+dependencies = [
+ "glob",
+ "libc",
+ "libloading",
+]
+
+[[package]]
+name = "either"
+version = "1.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0e9c71c2167ca323c882b99918929403426e2373ea17242ff5653e0d5e1058be"
+
+[[package]]
+name = "glob"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e4eba85ea1d0a966a983acd07deee566e67395d2d96b6fb39e62b5a833f1eb0b"
+
+[[package]]
+name = "itertools"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
+dependencies = [
+ "either",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20870f649af7073d53e38067b2a84312175d56ea15217e1b15bc83506ec50afb"
+
+[[package]]
+name = "libc"
+version = "0.2.191"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
+
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if",
+ "windows-link",
+]
+
+[[package]]
+name = "magnus"
+version = "0.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40ef424404d166cbb71c8b8d19c9c589c748c4547c1afa1928c5504299f6c713"
+dependencies = [
+ "magnus-macros",
+ "rb-sys",
+ "rb-sys-env",
+ "seq-macro",
+]
+
+[[package]]
+name = "magnus-macros"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9dafde2eeb66f090e0f326112323eb8324b12cb32b5d1210e541d3df6b0ce77e"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rb-sys"
+version = "0.9.130"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02faf625bb10ba893e3ae620f19c9fb1b5f8fcae0fe4eb86bb3f2230fad75edb"
+dependencies = [
+ "rb-sys-build",
+]
+
+[[package]]
+name = "rb-sys-build"
+version = "0.9.130"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05be6f9c86fe5482808162826f6c047d093b3670582296c770de1d94f8066694"
+dependencies = [
+ "bindgen",
+ "lazy_static",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "shell-words",
+ "syn",
+]
+
+[[package]]
+name = "rb-sys-env"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cca7ad6a7e21e72151d56fe2495a259b5670e204c3adac41ee7ef676ea08117a"
+
+[[package]]
+name = "regex"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f020237b6c8eed93db2e2cb53c00c60a8e1bc73da7d073199a1180401450218d"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "seq-macro"
+version = "0.3.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bc711410fbe7399f390ca1c3b60ad0f53f80e95c5eb935e52268a0e2cd49acc"
+
+[[package]]
+name = "shell-words"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc6fe69c597f9c37bfeeeeeb33da3530379845f10be461a66d16d03eca2ded77"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "supervisor-machines"
+version = "0.2.0"
+
+[[package]]
+name = "supervisor_machines_native"
+version = "0.1.1"
+dependencies = [
+ "magnus",
+ "supervisor-machines",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

data/Cargo.toml

@@ -0,0 +1,24 @@
+[workspace]
+members = ["ext/supervisor_machines_native/core", "ext/supervisor_machines_native/ffi"]
+resolver = "3"
+
+[workspace.package]
+edition = "2024"
+rust-version = "1.99"
+
+[workspace.dependencies]
+supervisor-machines = { path = "ext/supervisor_machines_native/core" }
+
+[workspace.lints.rust]
+unsafe_code = "forbid"
+unused_must_use = "warn"
+
+[workspace.lints.clippy]
+all = { level = "warn", priority = -1 }
+pedantic = { level = "warn", priority = -1 }
+nursery = { level = "warn", priority = -1 }
+expect_used = "deny"
+unwrap_used = "deny"
+uninlined_format_args = "deny"
+needless_borrow = "deny"
+redundant_clone = "deny"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Abdelkader Boudih
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,140 @@
+# SupervisorMachines 🔁
+
+> **OTP-style supervision trees over Ruby threads.** The command vessel that
+> notices a station has gone quiet and decides who returns to duty.
+
+A child died. Which children restart, and has that happened too often to keep
+trying? Those answers come from the `no_std` [supervisor-machines][core] crate.
+Everything the core refuses to touch, spawning, joining, killing, ordered
+shutdown, is this gem. **AMS Armstrong** is the bridge around that decision.
+
+---
+
+## 🚀 Launch Sequence
+
+```bash
+# Add to your ship's Gemfile
+gem 'supervisor_machines'
+```
+
+Requires **Ruby 4.0+** and a Rust toolchain, or a platform gem: the core is a
+native extension, not an option.
+
+---
+
+## 🎯 Mission Brief
+
+```ruby
+SM = SupervisorMachines
+
+tree = SM::Supervisor.new(strategy: :one_for_all, restarts: 3, window: 60.0)
+tree.supervise(:cache)  { Thread.new { cache.run } }
+tree.supervise(:warmup, policy: :transient) { Thread.new { warm_the_cache } }
+tree.start
+
+tree.children    # => [:cache, :warmup]
+tree.restarts    # => 0
+tree.terminated? # => false
+
+tree.stop(grace: 5.0)
+```
+
+A starter block returns the `Thread` that runs the child, and is called again
+for every restart. A child that stops is noticed, handed to the core, and
+whatever the core decides is carried out.
+
+---
+
+## 🔄 Lifecycle
+
+A tree registers children, runs them, and ends either stopped or failed. Both
+endings are final: `start` raises `SupervisorMachines::Error` for a tree that
+is already running, has been stopped, or gave up. There is one generation of
+children per tree, and starting a second one is a bug, not a refresh.
+`supervise` is refused the same way once `start` has fixed the shape of the
+tree: a tree past registering cannot take on a child.
+
+A `start` that cannot finish, because a starter raises, takes the children it
+already brought up back down in reverse start order, leaves the tree failed,
+and raises what the starter raised. Nothing is left running and nothing is left
+unsupervised. `stop` then raises `Escalated`, like any other tree that gave up,
+every time it is called, and a tree that was never started has nothing to take
+down.
+
+---
+
+## 🎛️ Strategies
+
+`:one_for_one` restarts only what died. `:one_for_all` restarts every child,
+for a set that only works together. `:rest_for_one` restarts the child and
+everything started after it, for a chain where later children depend on earlier
+ones.
+
+One restart is recorded per failure handled, not per child brought back, so the
+strategy does not change how fast the restart intensity is spent. That is OTP's
+accounting.
+
+---
+
+## 📋 Standing Orders
+
+A child's policy is its standing order. `:permanent` always comes back, even
+from a clean exit. `:transient` comes back
+only from a bad one, because a clean exit means it finished. `:temporary` never
+comes back, and never spends the restart budget.
+
+```ruby
+tree.supervise(:migration, policy: :temporary) { Thread.new { migrate } }
+```
+
+---
+
+## 🔥 Restart Intensity
+
+`restarts` within `window` seconds is all the thrashing a tree will do. Past
+it, the tree stops its remaining children in reverse start order and raises
+`SupervisorMachines::Escalated`, and the supervisor's own supervisor now owns
+the problem. That decision is sticky: `terminated?` stays true and every later
+`stop` raises again.
+
+---
+
+## 🚫 Rules of Engagement
+
+- The delay between a restart decision and the respawn comes from
+  [chrono_machines][chrono]. Pass your own `backoff:` to change the curve.
+- The shutdown budget comes from [deadline_machines][deadline]: `stop(grace:)`
+  bounds the whole ordered teardown, and a child that outstays it is left
+  behind rather than waited on forever.
+- Restart intensity, strategy spans and policy decisions come from the core
+  crate. None of it is reimplemented here.
+
+---
+
+## 📐 Shape
+
+The core carries its child count in its type, so a tree is dispatched to one of
+`SupervisorMachines::Decider::SUPPORTED_CHILDREN` monomorphised shapes: 1
+through 16, and 32. Any other count raises `ArgumentError` from `#start`.
+
+Threads are the only supervised unit.
+
+---
+
+## 📡 Credits
+
+**AMS Armstrong**, NCC-3186, *Armstrong*-class command vessel.
+
+Named for Joe Armstrong's OTP supervision trees, which settled that the way to
+keep a system up is to let a part of it die and have something above it decide
+what comes back.
+
+---
+
+## License
+
+MIT.
+
+[core]: ext/supervisor_machines_native/core/README.md
+[chrono]: https://github.com/seuros/chrono_machines
+[deadline]: https://github.com/seuros/deadline_machines

data/ext/supervisor_machines_native/core/Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+name = "supervisor-machines"
+version = "0.2.0"
+edition.workspace = true
+rust-version.workspace = true
+authors = ["Abdelkader Boudih <oss@seuros.com>"]
+license = "MIT"
+description = "OTP-style supervision decisions: restart strategies, restart intensity and escalation - no_std with zero dependencies"
+repository = "https://github.com/seuros/supervisor_machines"
+keywords = ["supervisor", "supervision-tree", "otp", "restart", "no-std"]
+categories = ["no-std", "concurrency"]
+readme = "README.md"
+
+[lib]
+name = "supervisor_machines"
+crate-type = ["lib"]
+
+[features]
+default = ["std"]
+std = ["alloc"]
+alloc = []
+
+[lints]
+workspace = true

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

@@ -0,0 +1,128 @@
+#![cfg_attr(not(feature = "std"), no_std)]
+
+//! Supervision decisions, in the OTP sense.
+//!
+//! Which children restart after one dies, and whether that has happened too
+//! often to keep trying. The caller owns the threads, fibers or processes.
+
+/// Compiles and runs the README's examples as doctests.
+#[cfg(doctest)]
+#[doc = include_str!("../README.md")]
+struct ReadmeDoctests;
+
+pub mod supervisor;
+
+pub use supervisor::Supervisor;
+
+/// Which siblings a failure takes down with it.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum Strategy {
+    /// Restart only the child that died.
+    OneForOne,
+    /// Restart every child.
+    OneForAll,
+    /// Restart the child that died and everything started after it.
+    RestForOne,
+}
+
+/// When a child is worth restarting.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum Policy {
+    /// Always bring it back, even after a clean exit.
+    Permanent,
+    /// Bring it back only if it died badly. A clean exit means it was done.
+    Transient,
+    /// Never bring it back.
+    Temporary,
+}
+
+/// How a child's run ended.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum Exit {
+    /// It finished its work.
+    Normal,
+    /// It raised, was killed, or vanished.
+    Abnormal,
+}
+
+/// What the supervisor should do about a child that stopped.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum Decision {
+    /// Leave it stopped. Nothing restarts.
+    Ignore,
+    /// Restart this inclusive range of children, in index order.
+    Restart(Span),
+    /// Restarting is not working. The supervisor must terminate its remaining
+    /// children and let its own supervisor deal with it.
+    Escalate,
+}
+
+/// An inclusive range of child indices.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub struct Span {
+    /// Lowest index, restarted first.
+    pub first: usize,
+    /// Highest index, restarted last.
+    pub last: usize,
+}
+
+impl Span {
+    #[must_use]
+    pub const fn single(index: usize) -> Self {
+        Self {
+            first: index,
+            last: index,
+        }
+    }
+
+    /// Children in the span. Always at least one.
+    #[must_use]
+    pub const fn len(&self) -> usize {
+        self.last - self.first + 1
+    }
+
+    /// Never true. A span always covers the child that died.
+    #[must_use]
+    pub const fn is_empty(&self) -> bool {
+        false
+    }
+
+    #[must_use]
+    pub const fn contains(&self, index: usize) -> bool {
+        self.first <= index && index <= self.last
+    }
+}
+
+/// How many restarts within how long before a supervisor gives up.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub struct Intensity {
+    /// Restarts tolerated inside the window.
+    pub restarts: u32,
+    /// Length of the window, in nanoseconds.
+    pub window_ns: u64,
+}
+
+/// Restarts OTP tolerates by default before escalating.
+pub const DEFAULT_RESTARTS: u32 = 1;
+
+/// The window OTP measures those restarts over, five seconds.
+pub const DEFAULT_WINDOW_NS: u64 = 5_000_000_000;
+
+impl Intensity {
+    #[must_use]
+    pub const fn new(restarts: u32, window_ns: u64) -> Self {
+        Self {
+            restarts,
+            window_ns,
+        }
+    }
+}
+
+impl Default for Intensity {
+    fn default() -> Self {
+        Self::new(DEFAULT_RESTARTS, DEFAULT_WINDOW_NS)
+    }
+}
+
+#[cfg(test)]
+mod tests;