rails-informant 0.5.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef3e66d24feee02958d2d57db85411ec1e19db17fa0cc440936c3f2072016d7c
-  data.tar.gz: a43101bb80bffbad9d1a940d06e2a2d35bc5a8853a2978d5ada0dfdcbd87063d
+  metadata.gz: df864c72b8d47ff6e08332fe9df58a1540a19dba41c0c1c66a90bb0257572f5a
+  data.tar.gz: cd0d0f7f000e32edb7c9e8afc945407370718aded879322c74fd346304660a3c
 SHA512:
-  metadata.gz: 626124766b399453b846fb37ea492a9cc971206dafcbe5019e050b8adde854f20a55944c84f8906d03c5a55255530480c7599dd3aaf143ac37bc4aca743ae83a
-  data.tar.gz: 8fb18f7ab56d4044601224d6c7c20ffcc77944517738d2a7fded15470fc3a18bb83ae963b6784305145519166d54f887b39e84f34c7ff3b5e2623581fd85096c
+  metadata.gz: 80629c20d8551b7c07528c49a6eac833065e743b9e75fbbdceab58eddc06dd7792d7a648ff63cda66d81e39d9a0d82bc14abd38abf5adfe001774ddd9810b1a6
+  data.tar.gz: ca790a7b34a26af218c14798228fc2c005649d9e11da611680871e52d082dec192e755398f90cebc9e2a0ae4ca0c9ff82b7b923b0deb997ea34b448a79c78270

data/README.md

@@ -87,6 +87,7 @@ Every option can be set via an environment variable. The initializer takes prece
 |--------|---------|---------|-------------|
 | `api_token` | `INFORMANT_API_TOKEN` | `nil` | Authentication token for API/MCP access |
 | `capture_errors` | `INFORMANT_CAPTURE_ERRORS` | `true` | Enable/disable error capture |
+| `capture_runner_errors` | `INFORMANT_CAPTURE_RUNNER_ERRORS` | `true` | Capture errors raised under `rails runner` |
 | `capture_user_email` | _(none)_ | `false` | Capture email from detected user (PII -- opt-in) |
 | `ignored_exceptions` | `INFORMANT_IGNORED_EXCEPTIONS` | `[]` | Exception classes to skip (walks cause chain) |
 | `ignored_paths` | `INFORMANT_IGNORED_PATHS` | `[]` | Request paths to skip (exact or segment match) |
@@ -126,6 +127,19 @@ is recorded and no notifications are sent. You see exceptions live at the prompt
 recording and alerting on them would only be noise. This is always on and not configurable.
 Errors from web requests, background jobs, and rake tasks are captured as normal.
 
+### Rails Runner
+
+`rails runner` is captured by default, because it is how many apps run cron and scheduled
+tasks -- exactly the errors you want to hear about. If your app instead uses it by hand, for
+one-off production data corrections, the operator already sees the exception on their own
+terminal and recording it only pages the team:
+
+```ruby
+config.capture_runner_errors = false
+```
+
+That applies only to `rails runner`; requests, jobs and rake tasks are captured either way.
+
 ### Silenced Blocks
 
 ```ruby
@@ -192,6 +206,22 @@ export INFORMANT_STAGING_URL=https://staging.myapp.com
 export INFORMANT_STAGING_TOKEN=<token>
 ```
 
+### Keeping it in sync
+
+The generator's output (`.claude/`, `.mcp.json`) is committed to your app, so a gem update leaves those files untouched. After `bundle update rails-informant`, re-run the generator and commit the result to pick up template changes:
+
+```sh
+bin/rails generate rails_informant:skill
+```
+
+Re-running migrates any prior hook registration in place, so there are no duplicates. The gem also flags drift when the committed files fall behind the installed version — via a warning on dev boot, an in-session Claude Code nudge, and an on-demand check:
+
+```sh
+bin/rails informant:doctor   # reports current / stale / not installed; exits nonzero when stale
+```
+
+Apps that use the gem only for error capture (no Claude Code integration) are never affected.
+
 ### Tools
 
 | Tool | Description |

data/lib/rails_informant/configuration.rb

@@ -1,6 +1,7 @@
 module RailsInformant
   class Configuration
     attr_accessor :capture_errors,
+                  :capture_runner_errors,
                   :capture_user_email,
                   :api_token,
                   :ignored_exceptions,
@@ -17,6 +18,7 @@ module RailsInformant
       @api_token = ENV["INFORMANT_API_TOKEN"]
       @app_name = ENV["INFORMANT_APP_NAME"]
       @capture_errors = ENV.fetch("INFORMANT_CAPTURE_ERRORS", "true") != "false"
+      @capture_runner_errors = ENV.fetch("INFORMANT_CAPTURE_RUNNER_ERRORS", "true") != "false"
       @capture_user_email = false
       @custom_notifiers = []
       @ignored_exceptions = ENV["INFORMANT_IGNORED_EXCEPTIONS"]&.split(",")&.map(&:strip) || []

data/lib/rails_informant/error_recorder.rb

@@ -15,6 +15,10 @@ module RailsInformant
         # Never capture from an interactive console — the operator sees errors
         # live, so recording and alerting on them is noise.
         return if RailsInformant.console_mode?
+        # `rails runner` is the same shape when an operator drives it by hand, but it also
+        # backs cron and scheduled tasks, where those errors are the whole point. Apps that
+        # only use it interactively opt out; capturing stays the default.
+        return if RailsInformant.runner_mode? && !RailsInformant.config.capture_runner_errors
         return unless RailsInformant.initialized?
         return if self_caused_error?(error)
 

data/lib/rails_informant.rb

@@ -139,6 +139,11 @@ module RailsInformant
       defined?(Rails::Console)
     end
 
+    # `rails runner` loads this command class; a server, worker or rake process never does.
+    def runner_mode?
+      defined?(Rails::Command::RunnerCommand)
+    end
+
     def server_mode?
       defined?(Rails::Server)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-informant
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.2
 platform: ruby
 authors:
 - Daniel López Prat
@@ -198,7 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Self-hosted error monitoring for Rails with MCP server for agentic workflows
 test_files: []