jobtick 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dff65ac46c3a2ce39e670a9b940726f11e7f72ab5695812031417097fbf6e2d6
-  data.tar.gz: bb6044dd0c4c43c9e956de1eec4a5f2032ba6787aebfb9f1ddae8267ff79c35a
+  metadata.gz: 7db7f99928881432d43b819fb1ffa2772e6a690f659b0a54ac543bbbbed8e9db
+  data.tar.gz: 8c67224a9ae754c411914958e3e9f8a3255bf9af5b09f2d2d2bd11ddffbf72f6
 SHA512:
-  metadata.gz: 80ac95fe4fa508de3656ed0cc187657e9e3c2be0f68a76451dc4e1b0633a51b81e4f86ec0665163278daeb12d64e374f0496f6a1c1c7596aac673519cdc6fc87
-  data.tar.gz: c0ce19f6cc1b5cf3f7bad98a38448bf012dafb09dd74fade6934b797ab94f05f82971d5e49cad5a3067f862b29d3cb65f373d8b139468d5912cbc7f7cdb15271
+  metadata.gz: 316eab73c6b4ef66752f86515113cf1f881e059c678045b47b63fc04a0dd67265753cd4c9a607db64e47b7629f71b2e107e7b0d62d959f3a1905326af42e5969
+  data.tar.gz: 65725c57b8f2b1f6f97f3b93b799d3a2e57f5f4fae15cb8f0232f7259d3ee9285a37f60fa0b3bf2212b6f5faef77c565863e4158fe9109c49d712e7ecaa29115

data/CHANGELOG.md

@@ -1,4 +1,20 @@
-## [Unreleased]
+## [0.1.4] - 2026-05-05
+
+- Add `prune` configuration option — when enabled, monitors absent from the latest sync payload are permanently deleted, keeping the dashboard in sync with your schedule config
+- Remove stale `.gem` build artifact from repository
+
+## [0.1.3] - 2026-05-05
+
+- Add `JobTick::WheneverSetup.install!(self)` — one-line setup that overrides Whenever's built-in `runner`, `rake`, and `command` job types to send heartbeat pings automatically, with no per-job changes required
+- Extract shared `Parsers.slugify` helper, remove redundant `.to_s` calls, unify guard style
+
+## [0.1.2] - 2026-04-30
+
+- Add automatic ping instrumentation for Solid Queue (via `ActiveJob::Base` `around_perform` hook) and Sidekiq (via server middleware)
+
+## [0.1.1] - 2026-04-28
+
+- Send `app_name` on monitor sync
 
 ## [0.1.0] - 2026-04-27
 

data/README.md

@@ -1,5 +1,6 @@
 # JobTick
 
+[![Gem Version](https://badge.fury.io/rb/jobtick.svg)](https://rubygems.org/gems/jobtick)
 [![Ruby](https://github.com/clearstack-labs/jobtick/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/clearstack-labs/jobtick/actions/workflows/main.yml)
 
 **Rails job monitoring for Whenever, Solid Queue, and Sidekiq.**
@@ -57,6 +58,19 @@ That's it. On next deploy, JobTick reads your schedule config, registers a monit
 
 No changes to individual job files. No manual monitor creation. No names to keep in sync.
 
+### Removing stale monitors automatically
+
+By default, monitors are only added — nothing is removed when you delete a job from your schedule. To have each deploy also clean up monitors that are no longer in your config, enable pruning:
+
+```ruby
+JobTick.configure do |config|
+  config.api_key = ENV['JOBTICK_API_KEY']
+  config.prune   = true   # remove monitors absent from the latest sync
+end
+```
+
+With `prune` enabled, a deploy acts as the single source of truth: any monitor whose key is not present in the current payload is permanently deleted. You can also remove individual monitors manually from the JobTick dashboard at any time.
+
 ---
 
 ## What gets monitored
@@ -97,25 +111,34 @@ JobTick installs a server middleware that wraps every job execution. For native
 
 ### Whenever (`config/schedule.rb`)
 
-Whenever schedules jobs as cron shell commands, so there is no Ruby hook point to instrument automatically. One setup step is required: run the generator and update your `config/schedule.rb` to use the `jobtick_runner` and `jobtick_rake` job types instead of the built-in `runner` and `rake`:
+Whenever schedules jobs as cron shell commands, so there is no Ruby hook point to instrument automatically. Add one line to `config/schedule.rb`:
 
-```
-bundle exec rake jobtick:whenever:setup
+```ruby
+JobTick::WheneverSetup.install!(self)
 ```
 
-This prints the two `job_type` definitions to add to the top of your schedule file, then use them in place of the standard types:
+This overrides the built-in `runner`, `rake`, and `command` job types to wrap every execution with `curl` pings. Your existing schedule entries need no changes:
 
 ```ruby
+JobTick::WheneverSetup.install!(self)
+
 every 1.day, at: '2:00 am' do
-  jobtick_runner 'InvoiceJob.perform_later', monitor_key: 'whenever.invoice_job'
+  runner 'InvoiceJob.perform_later'
 end
 
 every :hour do
-  jobtick_rake 'reports:sync', monitor_key: 'whenever.reports_sync'
+  rake 'reports:sync'
 end
 ```
 
-The job types wrap execution with `curl` pings to the JobTick API, so no changes to individual job classes are needed.
+After adding the line, run `whenever --update-crontab` as normal and all jobs will start sending heartbeats.
+
+If jobtick is not already loaded via your Rails environment, require it first:
+
+```ruby
+require 'jobtick/whenever_setup'
+JobTick::WheneverSetup.install!(self)
+```
 
 ---
 
@@ -123,7 +146,7 @@ The job types wrap execution with `curl` pings to the JobTick API, so no changes
 
 **Silent failure detection** — alerts when a job stops running entirely, not just when it raises an exception. The failure mode your error monitor misses.
 
-**Auto-sync on deploy** — add a job to your schedule, it appears in your dashboard at next deploy. Remove a job, its monitor is automatically retired.
+**Auto-sync on deploy** — add a job to your schedule, it appears in your dashboard at next deploy. Enable `config.prune = true` to automatically retire monitors when jobs are removed from your schedule.
 
 **Run history** — see every execution: start time, duration, exit status. Spot when a job starts getting slower before it becomes a problem.
 
@@ -137,17 +160,16 @@ The job types wrap execution with `curl` pings to the JobTick API, so no changes
 
 - Ruby >= 3.3
 - Rails >= 7.0
-- One or more of: Whenever, Solid Queue, Sidekiq
-
----
+- One or more of:
 
-## Status
+| Adapter | Supported versions |
+|---|---|
+| Solid Queue | >= 0.1 |
+| Sidekiq | >= 6 |
+| sidekiq-cron | >= 1.0 |
+| Whenever | >= 0.10 |
 
-> **JobTick is currently in development.**
-> Sign up for early access at [jobtick.app](https://jobtick.app).
-> Launching June 2026.
-
-If you want to follow along or give early feedback, open an issue or watch the repo.
+---
 
 ---
 

data/lib/jobtick/client.rb

@@ -19,12 +19,13 @@ module JobTick
       post("/ping/#{monitor_key}", payload)
     end
 
-    def register(monitors, app_name: nil)
+    def register(monitors, app_name: nil, prune: false)
       return unless JobTick.config.enabled
       return if JobTick.config.api_key.nil?
 
       payload = { monitors: monitors }
       payload[:app_name] = app_name if app_name && !app_name.empty?
+      payload[:prune]    = true if prune
       post("/monitors/sync", payload)
     end
 

data/lib/jobtick/configuration.rb

@@ -2,12 +2,13 @@
 
 module JobTick
   class Configuration
-    attr_accessor :api_key, :endpoint, :environment, :enabled
+    attr_accessor :api_key, :endpoint, :environment, :enabled, :prune
 
     def initialize
       @endpoint    = "https://api.jobtick.app/v1"
       @environment = ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "production"
       @enabled     = @environment == "production"
+      @prune       = false
     end
   end
 end

data/lib/jobtick/hooks/active_job.rb

@@ -6,11 +6,9 @@ module JobTick
       def self.included(base)
         base.around_perform do |job, block|
           key = JobTick.monitor_key_for(job.class.name)
-          if key
-            JobTick::Monitor.run(key) { block.call }
-          else
-            block.call
-          end
+          next block.call unless key
+
+          JobTick::Monitor.run(key) { block.call }
         end
       end
     end

data/lib/jobtick/middleware/sidekiq.rb

@@ -3,14 +3,14 @@
 module JobTick
   module Middleware
     class Sidekiq
-      def call(_worker, job, _queue)
+      def call(_worker, job, _queue, &)
         # Active Job wrappers are handled by the around_perform hook
         return yield if job["wrapped"]
 
         key = JobTick.monitor_key_for(job["class"])
         return yield unless key
 
-        JobTick::Monitor.run(key) { yield }
+        JobTick::Monitor.run(key, &)
       end
 
       def self.install

data/lib/jobtick/parsers/sidekiq.rb

@@ -2,6 +2,10 @@
 
 module JobTick
   module Parsers
+    def self.slugify(str)
+      str.downcase.gsub(/[^a-z0-9]+/, "_").gsub(/\A_+|_+\z/, "")
+    end
+
     class Sidekiq
       def self.parse
         return [] unless defined?(::Sidekiq)
@@ -16,7 +20,7 @@ module JobTick
 
       def self.parse_cron_jobs
         ::Sidekiq::Cron::Job.all.map do |job|
-          { key: "sidekiq.#{slugify(job.name)}", schedule: job.cron, source: "sidekiq", task: job.klass }
+          { key: "sidekiq.#{Parsers.slugify(job.name)}", schedule: job.cron, source: "sidekiq", task: job.klass }
         end
       end
       private_class_method :parse_cron_jobs
@@ -24,17 +28,12 @@ module JobTick
       def self.parse_periodic_jobs
         periodic = sidekiq_periodic_config
         (periodic || []).map do |klass, opts|
-          { key: "sidekiq.#{slugify(klass.to_s)}", schedule: opts[:cron] || opts[:every].to_s,
+          { key: "sidekiq.#{Parsers.slugify(klass.to_s)}", schedule: opts[:cron] || opts[:every].to_s,
             source: "sidekiq", task: klass.to_s }
         end
       end
       private_class_method :parse_periodic_jobs
 
-      def self.slugify(str)
-        str.downcase.gsub(/[^a-z0-9]+/, "_").gsub(/\A_+|_+\z/, "")
-      end
-      private_class_method :slugify
-
       def self.sidekiq_periodic_config
         if ::Sidekiq.respond_to?(:default_configuration)
           ::Sidekiq.default_configuration[:periodic]

data/lib/jobtick/parsers/whenever.rb

@@ -26,9 +26,7 @@ module JobTick
       end
 
       def self.job_key(job)
-        task = job[:task].to_s.strip
-        slug = task.downcase.gsub(/[^a-z0-9]+/, "_").gsub(/\A_+|_+\z/, "")
-        "whenever.#{slug}"
+        "whenever.#{Parsers.slugify(job[:task].to_s.strip)}"
       end
       private_class_method :job_key
     end

data/lib/jobtick/registry.rb

@@ -16,7 +16,9 @@ module JobTick
       return [] if monitors.empty?
 
       app_name = Rails.application.class.module_parent_name if defined?(Rails)
-      JobTick.client.register(monitors, app_name: app_name)
+      options  = { app_name: app_name }
+      options[:prune] = true if JobTick.config.prune
+      JobTick.client.register(monitors, **options)
       monitors
     end
   end

data/lib/jobtick/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JobTick
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/jobtick/whenever_setup.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "jobtick"
+
+module JobTick
+  # Overrides Whenever's built-in job types to wrap execution with jobtick pings.
+  #
+  # Usage — add one line to config/schedule.rb:
+  #
+  #   JobTick::WheneverSetup.install!(self)
+  #
+  # This replaces the :runner, :rake, and :command job types so that every
+  # scheduled job automatically sends started/completed/failed heartbeats without
+  # any per-job configuration.
+  module WheneverSetup
+    def self.install!(schedule)
+      endpoint = JobTick.config.endpoint
+
+      schedule.job_type :runner,  wrap(endpoint, "cd :path && bundle exec rails runner ':task' :output")
+      schedule.job_type :rake,    wrap(endpoint, "cd :path && bundle exec rake :task :output")
+      schedule.job_type :command, wrap(endpoint, "cd :path && :task :output")
+    end
+
+    def self.wrap(endpoint, inner_cmd)
+      # Shell equivalent of Parsers.slugify: downcase, collapse non-alnum runs to _, strip leading/trailing _.
+      sed = "sed 's/[^a-z0-9][^a-z0-9]*/_/g' | sed 's/^_*//;s/_*$//'"
+      slug = "$(printf '%s' ':task' | tr '[:upper:]' '[:lower:]' | #{sed})"
+      key_assign = %(JOBTICK_KEY="whenever.#{slug}")
+
+      "#{key_assign} ; " \
+        "curl -sf \"#{endpoint}/ping/$JOBTICK_KEY/started\" ; " \
+        "#{inner_cmd} && " \
+        "curl -sf \"#{endpoint}/ping/$JOBTICK_KEY/completed\" || " \
+        "curl -sf \"#{endpoint}/ping/$JOBTICK_KEY/failed\""
+    end
+    private_class_method :wrap
+  end
+end

data/lib/jobtick.rb

@@ -37,12 +37,10 @@ module JobTick
       @monitor_map ||= {}
     end
 
-    def monitor_map=(map)
-      @monitor_map = map
-    end
+    attr_writer :monitor_map
 
     def monitor_key_for(class_name)
-      monitor_map[class_name.to_s]
+      monitor_map[class_name]
     end
 
     def reset!

data/lib/tasks/jobtick.rake

@@ -9,26 +9,20 @@ namespace :jobtick do
   end
 
   namespace :whenever do
-    desc "Print Whenever job_type wrappers to add to config/schedule.rb for heartbeat injection"
+    desc "Print the line to add to config/schedule.rb to enable JobTick heartbeat injection"
     task :setup do
-      endpoint = JobTick.config.endpoint
       puts <<~RUBY
-        # Add to config/schedule.rb to enable JobTick heartbeat injection for Whenever jobs:
+        # Add to config/schedule.rb to enable JobTick heartbeat injection for all Whenever jobs:
 
-        job_type :jobtick_runner, %(curl -sf "#{endpoint}/ping/:monitor_key/started" ; ) \\
-                                  %(bundle exec rails runner ':task' :output && ) \\
-                                  %(curl -sf "#{endpoint}/ping/:monitor_key/completed" || ) \\
-                                  %(curl -sf "#{endpoint}/ping/:monitor_key/failed")
+        JobTick::WheneverSetup.install!(self)
 
-        job_type :jobtick_rake,   %(curl -sf "#{endpoint}/ping/:monitor_key/started" ; ) \\
-                                  %(bundle exec rake :task :output && ) \\
-                                  %(curl -sf "#{endpoint}/ping/:monitor_key/completed" || ) \\
-                                  %(curl -sf "#{endpoint}/ping/:monitor_key/failed")
-
-        # Then use jobtick_runner / jobtick_rake instead of runner / rake, e.g.:
-        # every 1.hour do
-        #   jobtick_runner "InvoiceJob.perform_later", monitor_key: "invoice_job"
-        # end
+        # This overrides the built-in runner, rake, and command job types so that
+        # every scheduled job automatically sends started/completed/failed heartbeats.
+        # No per-job changes are required.
+        #
+        # If jobtick is not already loaded via your Rails environment, add:
+        #   require "jobtick/whenever_setup"
+        # before the install! call.
       RUBY
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jobtick
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Clearstack Labs
@@ -35,7 +35,6 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- jobtick-0.0.1.gem
 - lib/jobtick.rb
 - lib/jobtick/client.rb
 - lib/jobtick/configuration.rb
@@ -48,6 +47,7 @@ files:
 - lib/jobtick/railtie.rb
 - lib/jobtick/registry.rb
 - lib/jobtick/version.rb
+- lib/jobtick/whenever_setup.rb
 - lib/tasks/jobtick.rake
 - sig/jobtick.rbs
 homepage: https://jobtick.app