sof-cycle 0.1.17 → 0.1.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 578b47e1063361f57d1d3eee18543b7dc16665ccbc0e5c6f7684405699a406ff
-  data.tar.gz: 365a22eff32c6908fcfbdbe14f6d0494c77c70c8471b9af13e0e76ce32945bf5
+  metadata.gz: 0c55fcf5568b377afa4873ddd3adf5d2631bd0f05f87a80d003efacafa6ecc6c
+  data.tar.gz: e8cf4dd826a396d47b40107decb70a957435f3d4754b15379ba89c14c0864004
 SHA512:
-  metadata.gz: 944184b46dc341d087db96a0173ad72de8a8524fd8984c34efd3e7b53853fefd68d0f0814cedf5818cb74492e3c69556bc90174227a3bf1001a867db7d60de37
-  data.tar.gz: 49f3369f577e9369ca19f3f6f3b0f37fb9ec558a9aac48e5af6ec4429e85d1561c27591b039b3263cf3531f62185829a0a03a10fe5bb565ed4f36e29206c4f10
+  metadata.gz: 4600b3a56d63b1c9177072e96f45292ab8f536827dabac963b29dc896e41c2b2cdee52ce8edc5578a8a3675a3d8c09d8d1bc52cbb0e5f9e39540d76f47adb56a
+  data.tar.gz: a4089a2360039fb791b06d463abda71fe82fb01d381acf7b6caa83c83381a78359c8841fed7e11d9b3321e20e847834a94bf3e0621f4ee46146467db3cfe541d

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.19] - 2026-10-26
 
 ### Changed
 
-- `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` anchors a dormant cycle on the date that meets its volume rather than the latest, so later dates count toward the next window
 
-## [0.1.16] - 2026-10-08
+## [0.1.18] - 2026-10-22
 
 ### Added
 
-- `Cycle#activated_by(date)` returns the cycle anchored on that date, or itself when already active
+- `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

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

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

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

@@ -0,0 +1 @@
+f523d1ba6aebd4f1255f259f102f28c2a733ac16086fd2d30a49353bb34b6dc314010872a17487fcee1478facbcff25910bd2a0bf356ffb4ebfc7b7f952694a2

data/lib/sof/cycle/version.rb

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

data/lib/sof/cycle.rb

@@ -346,6 +346,26 @@ 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 date that meets its volume, then `reset_by` moves
+    # it by the dates past that anchor.
+    #
+    # @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 }.sort
+      return reset_by(days) unless from_date.nil?
+      return self if days.size < volume
+
+      activated_by(days[volume - 1]).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.19
 platform: ruby
 authors:
 - Jim Gay
@@ -59,6 +59,8 @@ 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.18.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