solid_queue_guard 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 437b060eb21ee49c674d1f5ddbb34471209bbecd11eef1a99a562249f134b1f1
-  data.tar.gz: 0fb8e3a58e206ee4a0b78a4c815efb7397c1d5d55e153360d7655eee21ff81fa
+  metadata.gz: 0f68d16b641aa34f7cf2cda0731e1f279d4078466271f25bdac801d812a1c050
+  data.tar.gz: d9765f83f9e100ec1508603cc6e6c461ca5835a925d32ef30b993d122eafb6ce
 SHA512:
-  metadata.gz: 9fd08d490a2dff9d8e4915ed2742a660433c781a3244c321097715aac51c73729c91b5ad2cbcc90200c53c336c6a5f7cd80feb3eaebd426e025426700b5f1db5
-  data.tar.gz: da19ef71cf30e339ac2576a1749064f4ae904491bc0a67fdd61a9593feea6f2a48a051d13f260d6d0f739a43ed5aaddc5b5ef51e2183f98a58b36dbfdb3888bd
+  metadata.gz: 24f148012d857a399cb27ceab0ca17ed9b09e4215610e82aa96d9bbb2fa9b84b05b85e63723ffbe7edd57d65cb8c3ed81305ee0e2650ffb798aeffd55bbc1c11
+  data.tar.gz: bcd5ab443291828fbf19100ded2010d54d5d57cf764390623ca5e67d4291fb80c1fca37e5498ada656dfc95e184d8484e0a17e4763a0052f634a186980961bff

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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).
 
+## [1.4.0] - 2026-08-03
+
+### Changed
+
+- `recurring_stale` derives per-task thresholds from each task's schedule period
+  (`next_time - previous_time`, multiplied by `2` by default). Frequent crons alert sooner;
+  daily/weekly crons no longer force a single global window that hides shorter schedules.
+- `config.checks.recurring_stale = { threshold: ... }` is now a **fallback** when the schedule
+  period cannot be derived (not a global override for every task).
+- Optional `thresholds: { task_key: duration }` and `multiplier:` overrides for fine-tuning.
+
 ## [1.3.1] - 2026-07-31
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    solid_queue_guard (1.3.1)
+    solid_queue_guard (1.4.0)
       actionpack (>= 7.1, < 9.0)
       activejob (>= 7.1, < 9.0)
       activerecord (>= 7.1, < 9.0)

data/lib/solid_queue_guard/checks/runtime/recurring_stale_check.rb

@@ -4,15 +4,14 @@ module SolidQueueGuard
   module Checks
     module Runtime
       class RecurringStaleCheck < Base
+        DEFAULT_MULTIPLIER = 2
+
         def call
           with_queue_database do
             tasks = SolidQueue::RecurringTask.static
             return pass(check_id, 'No recurring tasks configured') if tasks.none?
 
-            stale_tasks = tasks.select do |task|
-              last_run = SolidQueue::RecurringExecution.where(task_key: task.key).maximum(:run_at)
-              last_run.nil? || last_run < expected_staleness.ago
-            end
+            stale_tasks = tasks.select { |task| stale?(task) }
 
             if stale_tasks.any?
               warn(
@@ -28,7 +27,48 @@ module SolidQueueGuard
 
         private
 
-        def expected_staleness
+        def stale?(task)
+          last_run = SolidQueue::RecurringExecution.where(task_key: task.key).maximum(:run_at)
+          last_run.nil? || last_run < expected_staleness_for(task).ago
+        end
+
+        def expected_staleness_for(task)
+          override = per_task_threshold(task.key)
+          return override if override
+
+          period = schedule_period_for(task)
+          return period * multiplier if period
+
+          fallback_threshold
+        end
+
+        def per_task_threshold(task_key)
+          thresholds = config.check_setting(:recurring_stale, :thresholds, nil)
+          return unless thresholds
+
+          thresholds[task_key.to_sym] || thresholds[task_key.to_s]
+        end
+
+        def schedule_period_for(task)
+          return unless task.respond_to?(:previous_time) && task.respond_to?(:next_time)
+
+          previous = task.previous_time
+          nxt = task.next_time
+          return unless previous && nxt
+
+          seconds = nxt - previous
+          return unless seconds.positive?
+
+          seconds.seconds
+        rescue StandardError
+          nil
+        end
+
+        def multiplier
+          config.check_setting(:recurring_stale, :multiplier, DEFAULT_MULTIPLIER)
+        end
+
+        def fallback_threshold
           config.check_setting(:recurring_stale, :threshold, config.stale_process_threshold * 2)
         end
       end

data/lib/solid_queue_guard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolidQueueGuard
-  VERSION = '1.3.1'
+  VERSION = '1.4.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_queue_guard
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Rafael Pissardo