honeybadger 6.4.0 → 6.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d68528495f6a108b6f425a6c19f48fdbc6cb6e70aae0db958b03f77e24df7da4
-  data.tar.gz: b2e1a816492b63b86f9be7d179c943e7dddfe9e724c5b04ffdfcf4dd057c0833
+  metadata.gz: 39ebd5e4fe5914237990936efd9e995f4fa33d2aea18bba59fab9884d7ca0e09
+  data.tar.gz: 22c9428b20da4cc7ce86173bee426231e24a05827b3f1403de46e65111453acc
 SHA512:
-  metadata.gz: a6f188b0a3be2f3dc9f77f28c18503afac2d1805a59c62a23ee9ac7ad2dad919bbfbdd5d35dc8153dfff63fc279ced4da497bc30074b013e7cba19830fde74ea
-  data.tar.gz: 92359a65d182ac76af10ad10ca7e09132d9fb2750feaa4a12d73627d1cedd889c4acb83ed43aec3f54f9dd97ce45e84675d6f66a0764f9f7e4efffbdacd61901
+  metadata.gz: 5a92e33d946d42a7b4f0dd0b7a0cc2af6e4ea144cd3353aa0b2a42ffa4d942a6884b1d01a22506896135dbdce83a4ac9a48a211aab8b7e2abe2a78a2f282e0bd
+  data.tar.gz: 9e3ce8579499dbe5af256f04e1b1a7cca51f51c83a60d34205999dbb682feb849bf77014f399612b46b8e12b1a37b484b9e79ed1042d1404c7982fe033c91e5c

data/AGENTS.md

@@ -0,0 +1,89 @@
+# AGENTS.md
+
+This file provides guidance for AI agents when working with code in this repository.
+
+## Project Overview
+
+Honeybadger Ruby gem — error tracking and observability for Ruby applications. Supports Rails, Sinatra, Hanami, and standalone Ruby. Requires Ruby >= 3.0.
+
+## Common Commands
+
+### Tests (RSpec)
+
+```bash
+bundle exec rake              # Run all tests (units + integrations + features)
+bundle exec rake spec:units   # Unit tests only
+bundle exec rake spec:features # Feature/CLI tests (Aruba-based, slower)
+bundle exec rake spec:integrations # Integration tests
+
+# Single test file
+bundle exec rspec spec/unit/honeybadger/agent_spec.rb
+
+# Single test by line number
+bundle exec rspec spec/unit/honeybadger/agent_spec.rb:42
+
+# Tests with a specific Appraisal gemfile (e.g., Rails 8)
+bundle exec appraisal rails8 rake spec:units
+```
+
+### Linting
+
+```bash
+bundle exec standardrb        # Check style (auto-fixes by default, see .standard.yml)
+bundle exec standardrb --no-fix # Check without fixing
+```
+
+### Appraisals (multi-framework testing)
+
+```bash
+bundle exec appraisal install # Install all appraisal gemfiles
+bundle exec appraisal list    # List available appraisals
+```
+
+Available appraisals: standalone, rack, rack-1, sinatra, hanami, rails6.1, rails7.0, rails7.1, rails7.2, rails8, rails (edge), sidekiq, sidekiq7, resque, delayed_job, binding_of_caller.
+
+## Architecture
+
+### Entry Points
+
+- `lib/honeybadger.rb` — Framework detection entrypoint. Detects Rails/Sinatra/Hanami and loads the appropriate initializer from `lib/honeybadger/init/`.
+- `lib/honeybadger/ruby.rb` — Core require that loads `Honeybadger::Singleton`.
+- `bin/honeybadger` — CLI (Thor-based, vendored in `vendor/cli/`).
+
+### Core Classes
+
+- **`Agent`** (`lib/honeybadger/agent.rb`) — Central orchestrator. Global singleton accessed via `Honeybadger.method_name` (delegated through `Singleton`). Manages configuration, context, plugins, and worker threads.
+- **`Config`** (`lib/honeybadger/config.rb`) — Layered configuration: Ruby DSL > environment variables (`HONEYBADGER_*`) > YAML > defaults. Sources in `lib/honeybadger/config/`.
+- **`Notice`** (`lib/honeybadger/notice.rb`) — Exception/error data structure with backtrace, context, sanitization, and JSON serialization.
+- **`Event`** (`lib/honeybadger/event.rb`) — Custom event/Insights payload. Acts like a Hash via delegation.
+- **`Plugin`** (`lib/honeybadger/plugin.rb`) — Plugin registration system with `requirement` and `execution` blocks. All plugins in `lib/honeybadger/plugins/`.
+
+### Plugin System
+
+Plugins register via `Honeybadger::Plugin.register('name')` with requirement blocks (checked at load time) and execution blocks (run when requirements are met). ~22 plugins for frameworks, job queues, HTTP clients, etc. See `lib/honeybadger/plugins/` for examples.
+
+### Backend Abstraction
+
+`lib/honeybadger/backend/` — `Server` (production HTTP), `Debug` (stdout), `Null` (no-op), `Test` (in-memory). Decouples delivery from collection.
+
+### Worker Threads
+
+- `Worker` — base async notice delivery
+- `EventsWorker` — async event/Insights processing
+- `MetricsWorker` — periodic metric collection (calls plugin `collect` blocks)
+
+### Rack Middleware
+
+`lib/honeybadger/rack/` — `ErrorNotifier` (catches exceptions), `UserFeedback`, `UserInformer`.
+
+### Breadcrumbs
+
+`lib/honeybadger/breadcrumbs/` — Ring buffer-based trail of events leading to an error. Integrates with ActiveSupport::Notifications.
+
+## Key Conventions
+
+- Public API classes/methods are marked with YARD `@api public`. Everything else is internal and may change without notice.
+- All commits follow [conventional commits](https://www.conventionalcommits.org/). Releases are automated via Release Please.
+- Tests are filtered by framework: specs tagged `framework: :rails` only run under a Rails appraisal gemfile. Same for `:sinatra`, `:rake`, `:ruby`.
+- `spec/spec_helper.rb` stubs `https://api.honeybadger.io/v1/notices` globally and sets up a null backend agent before each test.
+- Feature specs use Aruba (CLI testing framework) with 12s timeout (120s on JRuby).

data/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log
 
 
+## [6.4.1](https://github.com/honeybadger-io/honeybadger-ruby/compare/v6.4.0...v6.4.1) (2026-02-25)
+
+
+### Bug Fixes
+
+* defer ActiveJob callback registration via on_load hook ([#783](https://github.com/honeybadger-io/honeybadger-ruby/issues/783)) ([2003726](https://github.com/honeybadger-io/honeybadger-ruby/commit/2003726d28520e22ab078cc3f4170b0a81d31a6b)), closes [#782](https://github.com/honeybadger-io/honeybadger-ruby/issues/782)
+
 ## [6.4.0](https://github.com/honeybadger-io/honeybadger-ruby/compare/v6.3.1...v6.4.0) (2026-02-18)
 
 

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/lib/honeybadger/plugins/active_job.rb

@@ -53,7 +53,11 @@ module Honeybadger
         end
 
         execution do
-          ::ActiveJob::Base.set_callback(:perform, :around, prepend: true, &ActiveJob.method(:perform_around)) if Honeybadger.config[:"exceptions.enabled"]
+          if Honeybadger.config[:"exceptions.enabled"]
+            ::ActiveSupport.on_load(:active_job) do
+              ::ActiveJob::Base.set_callback(:perform, :around, prepend: true, &ActiveJob.method(:perform_around))
+            end
+          end
 
           if config.load_plugin_insights?(:active_job)
             ::ActiveSupport::Notifications.subscribe(/(enqueue_at|enqueue|enqueue_retry|enqueue_all|perform|retry_stopped|discard)\.active_job/, Honeybadger::ActiveJobSubscriber.new)

data/lib/honeybadger/version.rb

@@ -1,4 +1,4 @@
 module Honeybadger
   # The current String Honeybadger version.
-  VERSION = "6.4.0".freeze
+  VERSION = "6.4.1".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: honeybadger
 version: !ruby/object:Gem::Version
-  version: 6.4.0
+  version: 6.4.1
 platform: ruby
 authors:
 - Honeybadger Industries LLC
@@ -47,7 +47,9 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- AGENTS.md
 - CHANGELOG.md
+- CLAUDE.md
 - LICENSE
 - README.md
 - TROUBLESHOOTING.md