sof-cycle 0.1.13 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0eb9458907426d68d8fc05c159a9bb782819b2ec821baf2ec24109b45c6794ff
-  data.tar.gz: e4c0b55074d59aad3f4e562e579759d8d85413b1fd93c93c873b79bdbff1c629
+  metadata.gz: 4bf300b22d76c7736f524022360c052b1546fa573ca39e851d4ce2a2ec2de4b7
+  data.tar.gz: 30f5a7972655d52acd3a547f59482c32d6c8fbdf22711f9f23eca27e695053cf
 SHA512:
-  metadata.gz: c799aed72bf8973a8b6438cab7d2635f2563575fcf3d16eac4b4bf38df409953000d78afc8b691ed4b5e4eb40b39a7969858e79d9ee844697ce113e1f0170ae5
-  data.tar.gz: c99b76559985729d0ea59ee3ff5be523500965578c450c85a90c24fd2d958ebd6eb4ff4ad550d101e8178423f2f39d02ffe79a47a28f716e34865c4028ce83a5
+  metadata.gz: 63208d5574eaf86293c0a39214155f7a645b74d51b2dd23bfd03ae83b9dcbd032d145ffd909a8b3a675caef7485f6abe14d5b4bbfcbaafac3c383e29193fa8a7
+  data.tar.gz: e4caecf602ea58c7b0cec5a27b1efe36e23b65d0cf191b9c71eb7415e75a01c05079d4783c75d69e02d1ed31da76ef2765a15bc93ee84d43b39c8f03d615a17d

data/.tool-versions

@@ -1 +1 @@
-ruby 3.4.3
+ruby 4.0.2

data/CHANGELOG.md

@@ -5,6 +5,8 @@ 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.14] - 2026-04-27
+
 ## [0.1.13] - 2026-03-20
 
 ### Added
@@ -18,9 +20,3 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 
 - EndOf cycle `final_date` was off by one period — `V1E12M` now correctly expires at the end of the 12th month, not the 11th
-
-## [0.1.12] - 2025-09-05
-
-### Added
-
-- Missing code coverage and updated EndOf to properly handle dormant cycles.

data/lib/sof/cycle/version.rb

@@ -2,6 +2,6 @@
 
 module SOF
   class Cycle
-    VERSION = "0.1.13"
+    VERSION = "0.1.14"
   end
 end

data/lib/sof/cycle.rb

@@ -6,6 +6,7 @@ require_relative "parser"
 module SOF
   class Cycle
     extend ::Forwardable
+
     class InvalidInput < StandardError; end
 
     class InvalidPeriod < InvalidInput; end
@@ -223,7 +224,7 @@ module SOF
     delegate [:kind, :recurring?, :volume_only?, :valid_periods] => "self.class"
     delegate [:period_count, :duration] => :time_span
     delegate [:calendar?, :dormant?, :end_of?, :interval?, :lookback?,
-      :volume_only?, :within?] => :kind_inquiry
+      :lookback_end_of?, :volume_only?, :within?] => :kind_inquiry
 
     def kind_inquiry = ActiveSupport::StringInquirer.new(kind.to_s)
 

data/lib/sof/cycles/lookback_end_of.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module SOF
+  module Cycles
+    class LookbackEndOf < Cycle
+      @volume_only = false
+      @notation_id = "LE"
+      @kind = :lookback_end_of
+      @valid_periods = %w[D W M Q Y]
+
+      def self.recurring? = true
+
+      def self.description
+        "Lookback End of Period - occurrences within a prior time period, expiring at the end of the calendar period"
+      end
+
+      def self.examples
+        ["V1LE24M - once in the prior 24 months (expires end of month)", "V2LE3W - twice in the prior 3 weeks (expires end of week)"]
+      end
+
+      def to_s = "#{volume}x in the prior #{period_count} #{humanized_period} (end of period)"
+
+      def expiration_of(completion_dates, anchor: Date.current)
+        oldest = completion_dates.max_by(volume) { it }.min
+        return unless satisfied_by?(completion_dates, anchor:)
+
+        final_date(oldest)
+      end
+
+      def final_date(anchor)
+        return if anchor.nil?
+
+        time_span.end_date_of_period(time_span.end_date(anchor.to_date))
+      end
+      alias_method :window_end, :final_date
+
+      def start_date(anchor)
+        time_span.begin_date_of_period(time_span.begin_date(anchor.to_date))
+      end
+      alias_method :window_start, :start_date
+    end
+  end
+end

data/lib/sof/parser.rb

@@ -12,9 +12,10 @@ module SOF
   # This is an internal implementation of Cycle behavior.
   class Parser
     extend Forwardable
+
     PARTS_REGEX = /
       ^(?<vol>V(?<volume>\d*))? # optional volume
-      (?<set>(?<kind>L|C|W|E|I) # kind
+      (?<set>(?<kind>LE|L|C|W|E|I) # kind
       (?<period_count>\d+) # period count
       (?<period_key>D|W|M|Q|Y)?)? # period_key
       (?<from>F(?<from_date>\d{4}-\d{2}-\d{2}))?$ # optional from

data/lib/sof/time_span.rb

@@ -5,6 +5,7 @@ module SOF
   # This is an internal implementation of Cycle behavior.
   class TimeSpan
     extend Forwardable
+
     # TimeSpan objects map Cycle notations to behaviors for their periods
     #
     # For example:
@@ -58,6 +59,7 @@ module SOF
     # quarter, etc.
     class DatePeriod
       extend Forwardable
+
       class << self
         def for(count, period_notation)
           @cached_periods ||= {}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sof-cycle
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.1.14
 platform: ruby
 authors:
 - Jim Gay
@@ -43,7 +43,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".claude/settings.local.json"
 - ".rspec"
 - ".simplecov"
 - ".tool-versions"
@@ -69,6 +68,7 @@ files:
 - lib/sof/cycles/end_of.rb
 - lib/sof/cycles/interval.rb
 - lib/sof/cycles/lookback.rb
+- lib/sof/cycles/lookback_end_of.rb
 - lib/sof/cycles/volume_only.rb
 - lib/sof/cycles/within.rb
 - lib/sof/parser.rb
@@ -92,7 +92,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Parse and interact with SOF cycle notation.
 test_files: []

data/.claude/settings.local.json

@@ -1,17 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(find:*)",
-      "Bash(ls:*)",
-      "Bash(mkdir:*)",
-      "Bash(touch:*)",
-      "Bash(rm:*)",
-      "Bash(bundle exec rspec:*)",
-      "Bash(bundle exec rake:*)",
-      "Bash(bundle exec standardrb:*)",
-      "Bash(git checkout:*)",
-      "Bash(bundle exec ruby:*)"
-    ],
-    "deny": []
-  }
-}