jobtick 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fbf13c9887fe65ec082ad5a3515ec3d2767330318e9fbeafca2731f6ea7e1f3
-  data.tar.gz: 7c1624eaa666bdec4318d087f7d4bd264f6abbe03091ad9746d88a001f2e1bf2
+  metadata.gz: 7db7f99928881432d43b819fb1ffa2772e6a690f659b0a54ac543bbbbed8e9db
+  data.tar.gz: 8c67224a9ae754c411914958e3e9f8a3255bf9af5b09f2d2d2bd11ddffbf72f6
 SHA512:
-  metadata.gz: 7b1b71c36e97bd70144c69118d7af1af461424529fc92bfa7926bc2289fcecd65e92ad7ac49652dcd413244e4258dbdf9087424dd44ee5b392909fb4be771f8d
-  data.tar.gz: 7f32abaf56da135c05d76dd5f1b77043d29bf6f99c919059b138367a1e21abd06460eaa5496f42655026e23f17f740b044e6c46f249849cf27fde2f9c46deea5
+  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/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.3"
+  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/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.3
+  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