sof-cycle 0.1.17 → 0.1.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 578b47e1063361f57d1d3eee18543b7dc16665ccbc0e5c6f7684405699a406ff
-  data.tar.gz: 365a22eff32c6908fcfbdbe14f6d0494c77c70c8471b9af13e0e76ce32945bf5
+  metadata.gz: 735c721cc8acf74603c4bea6a29c9e5149f68fa94455dd6ea15a48ecebb6602a
+  data.tar.gz: 5061cac902fee01a91d225f7ac85774a3b16269ece1a576c317a9a5f78ec4204
 SHA512:
-  metadata.gz: 944184b46dc341d087db96a0173ad72de8a8524fd8984c34efd3e7b53853fefd68d0f0814cedf5818cb74492e3c69556bc90174227a3bf1001a867db7d60de37
-  data.tar.gz: 49f3369f577e9369ca19f3f6f3b0f37fb9ec558a9aac48e5af6ec4429e85d1561c27591b039b3263cf3531f62185829a0a03a10fe5bb565ed4f36e29206c4f10
+  metadata.gz: 85940a5323238358158ec9dc9a9a45218563aab918471fcc6c1bcc0322ae67a070ef743cdf6cc5210adda942be61606c951c8ce12ffb85f51105f6d9f9c34d3a
+  data.tar.gz: 8e564766036e7e95321c3c86cbc57a65d3e316dfa1cb00e76007884525b3afc4defb4bb8ce0cc95e004031af4c56b892da99b7f62c01a31911c9e722d60ad001

data/CHANGELOG.md

@@ -5,14 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.17] - 2026-10-20
+## [0.1.18] - 2026-10-22
 
-### Changed
+### Added
 
-- `Cycle#reset_by` re-anchors the window on the date that meets the cycle's volume, and later dates count toward the new window
+- `Cycle#in_force_by(dates)` anchors a dormant End-of or Interval cycle on the latest date once the dates meet its volume, then resets it by them
 
-## [0.1.16] - 2026-10-08
+## [0.1.17] - 2026-10-20
 
-### Added
+### Changed
 
-- `Cycle#activated_by(date)` returns the cycle anchored on that date, or itself when already active
+- `Cycle#reset_by` re-anchors the window on the date that meets the cycle's volume, and later dates count toward the new window

data/checksums/sof-cycle-0.1.17.gem.sha512

@@ -0,0 +1 @@
+79734e3566bc1e21c2e6399531ec538e9207aa5e7426103cf126f36c2f020a04b618b83ceaf1ece2b12506c6d353e2c1f7e359e0bd3216ccf33e214b916b7f1d

data/lib/sof/cycle/version.rb

@@ -2,6 +2,6 @@
 
 module SOF
   class Cycle
-    VERSION = "0.1.17"
+    VERSION = "0.1.18"
   end
 end

data/lib/sof/cycle.rb

@@ -346,6 +346,25 @@ module SOF
       Cycle.for(activated_notation(date))
     end
 
+    # The cycle in force given the dates that satisfy it: a dormant E or I
+    # cycle anchors on the latest date once they meet its volume, then
+    # `reset_by` moves it.
+    #
+    # @param dates [Array<Date, Time, nil>] the acts that satisfy this cycle
+    # @return [Cycle] the cycle in force, or self when nothing brings it in
+    #
+    # @example
+    #   Cycle.for("V2E12M").in_force_by([Date.new(2026, 3, 20), Date.new(2026, 5, 2)])
+    #   # => Cycle.for("V2E12MF2026-05-02")
+    def in_force_by(dates)
+      return self unless recurring? && dormant_capable?
+
+      days = Array(dates).filter_map { it&.to_date }
+      return self if from_date.nil? && days.size < volume
+
+      activated_by(days.max).reset_by(days)
+    end
+
     # From the supplied anchor date, are there enough in-window completions to
     # satisfy the cycle?
     #

data/lib/sof/cycles/dormant.rb

@@ -26,6 +26,12 @@ module SOF
       # activated, not by the acts that satisfy it.
       def reset_by(...) = self
 
+      # Short of the volume it stays the wrapper, not the bare cycle.
+      def in_force_by(dates)
+        in_force = cycle.in_force_by(dates)
+        in_force.active? ? in_force : self
+      end
+
       def expiration_of(...) = nil
 
       def satisfied_by?(...) = false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sof-cycle
 version: !ruby/object:Gem::Version
-  version: 0.1.17
+  version: 0.1.18
 platform: ruby
 authors:
 - Jim Gay
@@ -59,6 +59,7 @@ files:
 - checksums/sof-cycle-0.1.14.gem.sha512
 - checksums/sof-cycle-0.1.15.gem.sha512
 - checksums/sof-cycle-0.1.16.gem.sha512
+- checksums/sof-cycle-0.1.17.gem.sha512
 - checksums/sof-cycle-0.1.2.gem.sha512
 - checksums/sof-cycle-0.1.3.gem.sha512
 - checksums/sof-cycle-0.1.4.gem.sha512