sof-cycle 0.1.16 → 0.1.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 231dc1ad6fc3d374cd70a0684f1d67206ccc7bec0335d1510b03f219a1a8fc5d
-  data.tar.gz: f0d524a077e23d84544833cae34d8d0695817bc10f092ffc84c560371edaffa9
+  metadata.gz: 735c721cc8acf74603c4bea6a29c9e5149f68fa94455dd6ea15a48ecebb6602a
+  data.tar.gz: 5061cac902fee01a91d225f7ac85774a3b16269ece1a576c317a9a5f78ec4204
 SHA512:
-  metadata.gz: 54c7a1a4f2a1960050e282ce5209c327f3b6c16b18ed9c5c1696564f7a99b30dbfbded433bf9a60a1f8ebf4ddac6d1d98b44d42413327fb7b5caf9152e6267d1
-  data.tar.gz: 4cf103728536a77b00dadfea353f616882d095468ca5c3c02e6d838736d4ecdb0e0fb7f67da980632443eb9270ba2d4714b20e44bddd8b38189c7242af02ab6b
+  metadata.gz: 85940a5323238358158ec9dc9a9a45218563aab918471fcc6c1bcc0322ae67a070ef743cdf6cc5210adda942be61606c951c8ce12ffb85f51105f6d9f9c34d3a
+  data.tar.gz: 8e564766036e7e95321c3c86cbc57a65d3e316dfa1cb00e76007884525b3afc4defb4bb8ce0cc95e004031af4c56b892da99b7f62c01a31911c9e722d60ad001

data/CHANGELOG.md

@@ -5,10 +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.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
 
-## [0.1.15] - 2026-07-27
+## [0.1.17] - 2026-10-20
+
+### 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

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

@@ -0,0 +1 @@
+a2fb7da5b2f320e581a7473ce5e534841d7b6daff56f2bdc3023d439ea4566df96c87edd4cf116348f4cac4a16db140b1edb5b45098cee73bcd63d7cb566baf5

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.16"
+    VERSION = "0.1.18"
   end
 end

data/lib/sof/cycle.rb

@@ -310,10 +310,12 @@ module SOF
     # consuming app.
     #
     # Dates on or before the current anchor are ignored: a back-dated act
-    # must not drag a forward-running window backwards. Every other kind
-    # returns itself — a lookback window already slides, a calendar window is
-    # pinned to the calendar, a one-shot window does not repeat, and an
-    # un-anchored one has no window to move until it is activated.
+    # must not drag a forward-running window backwards. The window re-anchors
+    # on the date that meets its volume; later dates count toward the new
+    # window. Every other kind returns itself — a lookback window already
+    # slides, a calendar window is pinned to the calendar, a one-shot window
+    # does not repeat, and an un-anchored one has no window to move until it
+    # is activated.
     #
     # @param dates [Array<Date, Time, nil>] the acts that satisfy this cycle
     # @return [Cycle] the reset cycle, or self when nothing resets it
@@ -344,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?
     #
@@ -397,10 +418,19 @@ module SOF
 
     private
 
-    # The latest date that moves this cycle's window forward, or nil.
     def reset_date(dates)
-      anchored_on = from_date.to_date
-      Array(dates).filter_map { it&.to_date }.select { it > anchored_on }.max
+      anchor = from_date.to_date
+      reset = nil
+      counted = 0
+      Array(dates).filter_map { it&.to_date }.sort.each do |date|
+        next unless date > anchor
+        counted += 1
+        next if counted < volume
+
+        anchor = reset = date
+        counted = 0
+      end
+      reset
     end
   end
 end

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.16
+  version: 0.1.18
 platform: ruby
 authors:
 - Jim Gay
@@ -58,6 +58,8 @@ files:
 - checksums/sof-cycle-0.1.13.gem.sha512
 - 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