rails-informant 0.5.1 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef3e66d24feee02958d2d57db85411ec1e19db17fa0cc440936c3f2072016d7c
-  data.tar.gz: a43101bb80bffbad9d1a940d06e2a2d35bc5a8853a2978d5ada0dfdcbd87063d
+  metadata.gz: 87e632d9075cba7b12f2a9d4f37654dbf5c38503d4d037916f70956db5831da6
+  data.tar.gz: a004d0304531b5f591b1c7cf55cf57c188edb1fa0969ab3c1b86dd340f9a1c69
 SHA512:
-  metadata.gz: 626124766b399453b846fb37ea492a9cc971206dafcbe5019e050b8adde854f20a55944c84f8906d03c5a55255530480c7599dd3aaf143ac37bc4aca743ae83a
-  data.tar.gz: 8fb18f7ab56d4044601224d6c7c20ffcc77944517738d2a7fded15470fc3a18bb83ae963b6784305145519166d54f887b39e84f34c7ff3b5e2623581fd85096c
+  metadata.gz: 938408a0098cc497a2498bd6ac34ff70b1b69740d81647f5a32b997c227d5e2bee260d6f7d7737d26ae92dff5aeb17ba70c78fc530d4b146732b3f0bd251c137
+  data.tar.gz: 2e8a5894b1c1c9f3e4129c813c3717d78c2ecf0c31a338bbf15843044684123d614f465ebf1fe389bf0d433b6ae453d83c4fb1927e8a46f594c790f1270c035b

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/claude_integration_content.rb

@@ -15,8 +15,16 @@ module RailsInformant
     MCP_PATH = ".mcp.json"
 
     # The command string a settings.json hook entry uses to invoke the script.
-    # Match-by-path detection keys on this value across every event key.
-    HOOK_COMMAND = HOOK_SCRIPT_PATH
+    # Absolute via Claude Code's $CLAUDE_PROJECT_DIR because the hook's cwd is
+    # not guaranteed to be the app root: a bare relative path fails on every
+    # prompt with "No such file or directory". Quoted as written — the expansion
+    # can contain spaces.
+    HOOK_COMMAND = %("$CLAUDE_PROJECT_DIR"/#{HOOK_SCRIPT_PATH})
+
+    # Every command form informant has ever written. Match-by-path detection
+    # keys on this list across every event key, so a re-run migrates an install
+    # registered by an older gem instead of appending a second entry beside it.
+    HOOK_COMMANDS = [ HOOK_COMMAND, HOOK_SCRIPT_PATH ].freeze
 
     # The event key the current gem registers the hook under.
     HOOK_EVENT = "UserPromptSubmit"
@@ -70,7 +78,7 @@ module RailsInformant
     # registrations) and detection (to extract the informant fragment).
     def informant_hook_entry?(entry)
       entry.is_a?(Hash) && Array(entry["hooks"]).any? do |hook|
-        hook.is_a?(Hash) && hook["command"] == HOOK_COMMAND
+        hook.is_a?(Hash) && HOOK_COMMANDS.include?(hook["command"])
       end
     end
   end

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.3
 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: []