e11y 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d7e79dcbcbd63a42a108fff3b2c29f4cea6f07e8e2632145d4cff39f85514ac
-  data.tar.gz: b53a0b131efaad3accb9ab20b75c5dcf973274422d384432a3b3562437750e4b
+  metadata.gz: 4cf2b7d2a17ee4e2474c6a286fe16e1c6dc3f3f6c62c687c21e6e19ff2326cff
+  data.tar.gz: cf70471e2647774b1ca4fa34c54cb731eed9adee5a6fb4e3b45203030a0c2843
 SHA512:
-  metadata.gz: 4576c625410acc475dbd5782fa546b29adcc6a815c319d86eae9a9b8e0a700c49a099197db7fdccf3c3ea43f594c24bdd90ccdc689cad82e9a8da11d18d50999
-  data.tar.gz: f569447a2c1b532cc39246d163fe245b61f63ec9ee618a2c9cf428936f3eead760549d6774de9b8a5afc09d12a0df7439ad53bf0f41993a7c518af566ebbdc1d
+  metadata.gz: f06a9a21e21cf3c287a0e5b271d15bbd1d8d453bf1168e9a1ef5a37eb3f1390f627b14801a02c668e6ae063ba12bcaf5854ba76ce4288ec4050b2a2e6eea18f1
+  data.tar.gz: c862108b20fc6c9da7ec1672baeb037dbbc4ac10fa06d713c8306c0ca1fd58c2e4bafec2b7a935fee2afc6bf7a1bd6741fb3a386b87edd024fa3c91e521c017d

data/CHANGELOG.md

@@ -19,6 +19,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Security
 
+## [1.1.0] - 2026-03-23
+
+### Added
+
+- Sidekiq and Active Job: propagate **`user_id`** into **`e11y_baggage`** (and restore **`E11y::Current.user_id`** when the job runs). Key **`user_id`** is included in default baggage allowlist.
+
+### Changed
+
+### Fixed
+
+- **Rails Railtie:** `config.enabled` is defaulted with `!Rails.env.test?` **only when still `nil`**, so an explicit `true`/`false` from `E11y.configure` in `config/application.rb` (or any code that runs before `before_initialize`) is no longer overwritten.
+
+### Deprecated
+
+### Removed
+
+- **`E11y.track`** — removed. Call **`YourEvent.track(...)`** on the event class only.
+
+### Security
+
 ## [1.0.0] - 2026-03-20
 
 ### BREAKING: Configuration — Flat config API
@@ -64,8 +84,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Monorepo release tooling: `rake release:build_gems` and `rake release:gem_push` build/publish **e11y** and **e11y-devtools**; optional `release:rubygems:push_core` / `push_devtools`; GitHub Release workflow attaches both `.gem` files.
+
 ### Changed
 
+- **e11y-devtools** 0.1.1 — depends on **e11y** `~> 1.0` (`CORE_VERSION`); README Gemfile example updated.
+
 ### Fixed
 
 ### Deprecated

data/README.md

@@ -10,7 +10,7 @@
 
 [Quick Start](#quick-start) • [How it works](#the-e11y-solution) • [Docs](#documentation)
 
-> v0.2.0 · Actively developed · Production feedback welcome → [open an issue](https://github.com/arturseletskiy/e11y/issues)
+> v1.0.0 · Actively developed · Production feedback welcome → [open an issue](https://github.com/arturseletskiy/e11y/issues)
 
 </div>
 
@@ -93,8 +93,11 @@ end
 
 # 3. Track it
 OrderPaidEvent.track(order_id: "123", amount: 99.99, currency: "USD")
+
 ```
 
+**Public API:** define events as subclasses of `E11y::Event::Base` and call **`.track(...)`** on the event class (for example `OrderPaidEvent.track(...)`). That is the only supported tracking entry point in application code.
+
 → [Full Quick Start guide (5 min)](#quick-start)
 
 ---
@@ -221,11 +224,19 @@ gem "e11y"
 E11y.configure do |config|
   config.adapters[:logs] = E11y::Adapters::Loki.new(url: ENV["LOKI_URL"])
   config.adapters[:errors_tracker] = E11y::Adapters::Sentry.new(dsn: ENV["SENTRY_DSN"])
-end
 
-# Auto-instruments Rails (optional):
-config.rails_instrumentation_enabled = true
-# → HTTP requests, ActiveRecord, ActiveJob, Cache events
+  # ActiveSupport::Notifications → E11y (HTTP, DB, cache, job lifecycle, etc.)
+  config.rails_instrumentation_enabled = true
+
+  # Optional: Sidekiq client/server middleware (buffer + job events) — enable if you use Sidekiq
+  config.sidekiq_enabled = true
+
+  # Optional: ActiveJob callbacks (buffer + context) — enable if you use Active Job
+  config.active_job_enabled = true
+
+  # Optional: wrap Rails.logger and emit E11y::Events::Rails::Log::* — opt-in
+  # config.logger_bridge_enabled = true
+end
 ```
 
 **vs. Traditional Observability:**
@@ -322,8 +333,17 @@ E11y.configure do |config|
     dsn: ENV["SENTRY_DSN"]
   )
   
-  # Optional: Auto-instrument Rails
+  # ActiveSupport::Notifications → E11y (see docs/RAILS_INTEGRATION.md)
   config.rails_instrumentation_enabled = true
+
+  # Optional: Sidekiq / ActiveJob (ephemeral buffer + instrumentation at job boundaries)
+  config.sidekiq_enabled = true    # set if you use Sidekiq
+  config.active_job_enabled = true # set if you use Active Job (in addition or instead)
+
+  # Optional: send Rails.logger lines into E11y as structured events
+  # config.logger_bridge_enabled = true
+  # config.logger_bridge_track_severities = [:warn, :error, :fatal] # nil = all severities
+  # config.logger_bridge_ignore_patterns = [%r{\A\[ActiveJob\]}]
 end
 ```
 
@@ -532,6 +552,18 @@ p99 latency <70µs (`:always`), <10µs (`:sampled`), <50µs (`:never`). Full ben
 
 ---
 
+## Upgrading
+
+Breaking renames and migration steps are listed in [CHANGELOG.md](CHANGELOG.md). Common ones:
+
+- **`RequestScopedBuffer` → `E11y::Buffers::EphemeralBuffer`** — use `initialize!`, `flush_on_error`, and `discard` at request/job boundaries (middleware and instruments already do this).
+- **Sidekiq / Active Job** — enable with `config.sidekiq_enabled` and `config.active_job_enabled`; see [docs/RAILS_INTEGRATION.md](docs/RAILS_INTEGRATION.md).
+- **Logger bridge** — `config.logger_bridge_enabled` plus optional `logger_bridge_track_severities` and `logger_bridge_ignore_patterns` (same file).
+
+Known tradeoffs and unfinished pieces: [docs/LIMITATIONS.md](docs/LIMITATIONS.md).
+
+---
+
 ## Documentation
 
 | Topic | Doc |

data/RELEASE.md

@@ -68,7 +68,7 @@ git commit -m "Bump version to 0.2.0"
 
 ### Step 1: Prepare Release
 
-Run tests, build gem, create tag:
+Run tests, build both gems, create tag:
 
 ```bash
 rake release:prep
@@ -77,8 +77,14 @@ rake release:prep
 This will:
 - ✅ Check git status (fails if uncommitted changes)
 - ✅ Run full test suite
-- ✅ Build gem file
-- ✅ Create annotated git tag
+- ✅ Build **e11y** and **e11y-devtools** `.gem` files (devtools is built under `gems/e11y-devtools/`)
+- ✅ Create annotated git tag `v<e11y-version>` (tag follows the core gem only)
+
+Build gems without tests (e.g. after a failed spec run you already trust):
+
+```bash
+rake release:build_gems
+```
 
 Or manually:
 
@@ -86,8 +92,9 @@ Or manually:
 # Run all tests
 bundle exec rspec
 
-# Build gem
+# Build gems
 gem build e11y.gemspec
+(cd gems/e11y-devtools && gem build e11y-devtools.gemspec)
 
 # Create and push tag
 git tag -a v0.2.0 -m "Release v0.2.0"
@@ -114,10 +121,16 @@ rake release:gem_push
 ```
 
 This will:
-- ✅ Verify gem file exists
-- ✅ Prompt for confirmation
-- ✅ Push gem to RubyGems (requires MFA)
-- ✅ Show verification URL
+- ✅ Verify both `.gem` files exist (e11y in repo root, e11y-devtools under `gems/e11y-devtools/`)
+- ✅ Prompt once for confirmation
+- ✅ Push **e11y** first, then **e11y-devtools** (each `gem push` may ask for MFA)
+
+Push only one gem if needed:
+
+```bash
+rake release:rubygems:push_core      # e11y only
+rake release:rubygems:push_devtools  # e11y-devtools only
+```
 
 Or manually:
 
@@ -133,8 +146,9 @@ Or manually:
 # Sign in to RubyGems (one-time setup)
 gem signin
 
-# Push the gem (requires MFA)
+# Push the gems (requires MFA; e11y first — devtools depends on it)
 gem push e11y-0.1.0.gem
+gem push gems/e11y-devtools/e11y-devtools-0.1.0.gem
 ```
 
 Expected output:

data/Rakefile

@@ -9,7 +9,8 @@
 #   rake release:full      # Complete release workflow (prep + git_push + gem_push)
 #   rake release:prep      # Run tests, build gem, create tag
 #   rake release:git_push  # Push to GitHub
-#   rake release:gem_push  # Publish to RubyGems
+#   rake release:gem_push  # Publish e11y + e11y-devtools to RubyGems
+#   rake release:build_gems # Build both .gem packages (no tests)
 #   rake spec:all          # Run all test suites
 #   rake spec:unit         # Run unit tests only (fast)
 #   rake spec:integration  # Run integration tests
@@ -26,6 +27,9 @@ def e11y_devtools_specs_available?
   File.directory?(File.join(__dir__, "gems/e11y-devtools/spec"))
 end
 
+# Built with: (cd gems/e11y-devtools && gem build …) — .gem stays in this directory
+E11Y_DEVTOOLS_GEM_DIR = File.expand_path("gems/e11y-devtools", __dir__).freeze
+
 RSpec::Core::RakeTask.new(:spec)
 
 RuboCop::RakeTask.new
@@ -277,6 +281,31 @@ namespace :release do
     puts "#{'=' * 80}\n"
   end
 
+  desc "Build e11y and e11y-devtools .gem files (no tests; devtools built in its directory)"
+  task :build_gems do
+    require_relative "lib/e11y/version"
+    require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+
+    puts "\n[build] e11y v#{E11y::VERSION}..."
+    unless system("gem build e11y.gemspec")
+      puts "❌ Error: Failed to build e11y gem"
+      exit 1
+    end
+
+    puts "\n[build] e11y-devtools v#{E11y::Devtools::VERSION}..."
+    Dir.chdir(E11Y_DEVTOOLS_GEM_DIR) do
+      unless system("gem build e11y-devtools.gemspec")
+        puts "❌ Error: Failed to build e11y-devtools gem"
+        exit 1
+      end
+    end
+
+    devtools_artifact = File.join(E11Y_DEVTOOLS_GEM_DIR, "e11y-devtools-#{E11y::Devtools::VERSION}.gem")
+    puts "\n✅ Built:"
+    puts "   - e11y-#{E11y::VERSION}.gem"
+    puts "   - #{devtools_artifact}"
+  end
+
   desc "Prepare release: run tests, build gem, create git tag (safe)"
   task :prep do
     require_relative "lib/e11y/version"
@@ -302,13 +331,11 @@ namespace :release do
     end
     puts "✅ All tests passed"
 
-    # Step 3: Build gem
-    puts "\n[3/5] Building gem..."
-    unless system("gem build e11y.gemspec")
-      puts "❌ Error: Failed to build gem"
-      exit 1
-    end
-    puts "✅ Gem built: e11y-#{version}.gem"
+    # Step 3: Build gems (e11y + e11y-devtools)
+    puts "\n[3/5] Building gems..."
+    Rake::Task["release:build_gems"].invoke
+    require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+    puts "✅ Gems built: e11y-#{version}.gem + e11y-devtools-#{E11y::Devtools::VERSION}.gem"
 
     # Step 4: Create git tag
     puts "\n[4/5] Creating git tag..."
@@ -336,28 +363,108 @@ namespace :release do
     puts "     git push origin main"
     puts "     git push origin #{tag_name}"
     puts "  3. Publish to RubyGems:"
-    puts "     rake release:publish"
+    puts "     rake release:gem_push"
     puts "\n"
   end
 
-  desc "Publish gem to RubyGems.org (requires authentication, safe)"
+  namespace :rubygems do
+    desc "Publish e11y gem only"
+    task :push_core do
+      require_relative "lib/e11y/version"
+      gem_file = "e11y-#{E11y::VERSION}.gem"
+
+      puts "\n#{'=' * 80}"
+      puts "📤 Publishing e11y v#{E11y::VERSION} to RubyGems.org"
+      puts "#{'=' * 80}\n"
+
+      unless File.exist?(gem_file)
+        puts "❌ Error: Gem file not found: #{gem_file}"
+        puts "Run 'rake release:build_gems' or 'rake release:prep' first"
+        exit 1
+      end
+
+      puts "This will publish #{gem_file}"
+      puts "You may be prompted for RubyGems credentials and MFA."
+      puts "\nContinue? (y/N)"
+
+      response = $stdin.gets.chomp.downcase
+      unless %w[y yes].include?(response)
+        puts "❌ Publication cancelled"
+        exit 0
+      end
+
+      unless system("gem push #{gem_file}")
+        puts "\n❌ Error: Failed to publish e11y"
+        exit 1
+      end
+
+      puts "\n✅ Published e11y v#{E11y::VERSION}"
+      puts "Verify: https://rubygems.org/gems/e11y/versions/#{E11y::VERSION}"
+    end
+
+    desc "Publish e11y-devtools gem only"
+    task :push_devtools do
+      require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+      version = E11y::Devtools::VERSION
+      gem_file = File.join(E11Y_DEVTOOLS_GEM_DIR, "e11y-devtools-#{version}.gem")
+
+      puts "\n#{'=' * 80}"
+      puts "📤 Publishing e11y-devtools v#{version} to RubyGems.org"
+      puts "#{'=' * 80}\n"
+
+      unless File.exist?(gem_file)
+        puts "❌ Error: Gem file not found: #{gem_file}"
+        puts "Run 'rake release:build_gems' or 'rake release:prep' first"
+        exit 1
+      end
+
+      puts "This will publish #{gem_file}"
+      puts "You may be prompted for RubyGems credentials and MFA."
+      puts "\nContinue? (y/N)"
+
+      response = $stdin.gets.chomp.downcase
+      unless %w[y yes].include?(response)
+        puts "❌ Publication cancelled"
+        exit 0
+      end
+
+      unless system("gem push #{gem_file}")
+        puts "\n❌ Error: Failed to publish e11y-devtools"
+        exit 1
+      end
+
+      puts "\n✅ Published e11y-devtools v#{version}"
+      puts "Verify: https://rubygems.org/gems/e11y-devtools/versions/#{version}"
+    end
+  end
+
+  desc "Publish e11y then e11y-devtools to RubyGems.org (requires authentication, MFA)"
   task :gem_push do
     require_relative "lib/e11y/version"
-    version = E11y::VERSION
-    gem_file = "e11y-#{version}.gem"
+    require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+
+    core_gem = "e11y-#{E11y::VERSION}.gem"
+    devtools_gem = File.join(E11Y_DEVTOOLS_GEM_DIR, "e11y-devtools-#{E11y::Devtools::VERSION}.gem")
 
     puts "\n#{'=' * 80}"
-    puts "📤 Publishing e11y v#{version} to RubyGems.org"
+    puts "📤 Publishing to RubyGems.org"
     puts "#{'=' * 80}\n"
 
-    unless File.exist?(gem_file)
-      puts "❌ Error: Gem file not found: #{gem_file}"
-      puts "Run 'rake release:prep' first"
+    unless File.exist?(core_gem)
+      puts "❌ Error: Gem file not found: #{core_gem}"
+      puts "Run 'rake release:build_gems' or 'rake release:prep' first"
+      exit 1
+    end
+    unless File.exist?(devtools_gem)
+      puts "❌ Error: Gem file not found: #{devtools_gem}"
+      puts "Run 'rake release:build_gems' or 'rake release:prep' first"
       exit 1
     end
 
-    puts "This will publish #{gem_file} to RubyGems.org"
-    puts "You will be prompted for your RubyGems credentials and MFA code."
+    puts "This will publish (e11y first, then e11y-devtools):"
+    puts "  1. #{core_gem}"
+    puts "  2. #{devtools_gem}"
+    puts "\nYou may be prompted for RubyGems credentials and MFA for each push."
     puts "\nContinue? (y/N)"
 
     response = $stdin.gets.chomp.downcase
@@ -366,17 +473,19 @@ namespace :release do
       exit 0
     end
 
-    unless system("gem push #{gem_file}")
-      puts "\n❌ Error: Failed to publish gem"
-      puts "Make sure you have:"
-      puts "  1. RubyGems account (https://rubygems.org/sign_up)"
-      puts "  2. Signed in: gem signin"
-      puts "  3. MFA enabled on your account"
+    unless system("gem push #{core_gem}")
+      puts "\n❌ Error: Failed to publish e11y"
+      exit 1
+    end
+
+    unless system("gem push #{devtools_gem}")
+      puts "\n❌ Error: Failed to publish e11y-devtools (e11y may already be on RubyGems)"
       exit 1
     end
 
-    puts "\n✅ Successfully published e11y v#{version} to RubyGems.org!"
-    puts "\nVerify: https://rubygems.org/gems/e11y/versions/#{version}"
+    puts "\n✅ Successfully published both gems!"
+    puts "  e11y:         https://rubygems.org/gems/e11y/versions/#{E11y::VERSION}"
+    puts "  e11y-devtools: https://rubygems.org/gems/e11y-devtools/versions/#{E11y::Devtools::VERSION}"
   end
 
   desc "Push git changes and tag to GitHub (safe)"
@@ -442,19 +551,23 @@ namespace :release do
     puts "=" * 80
     puts "\nPost-release tasks:"
     puts "  1. Create GitHub release: https://github.com/arturseletskiy/e11y/releases/new"
-    puts "  2. Verify on RubyGems: https://rubygems.org/gems/e11y"
+    puts "  2. Verify on RubyGems: https://rubygems.org/gems/e11y and /gems/e11y-devtools"
     puts "  3. Update README badges"
     puts "  4. Announce on social media"
     puts "\n"
   end
 
-  desc "Clean up built gems"
+  desc "Clean up built gem files (repo root + gems/e11y-devtools)"
   task :clean do
     puts "🧹 Cleaning up gem files..."
     FileList["*.gem"].each do |gem_file|
       File.delete(gem_file)
       puts "  Deleted: #{gem_file}"
     end
+    FileList[File.join(E11Y_DEVTOOLS_GEM_DIR, "*.gem")].each do |gem_file|
+      File.delete(gem_file)
+      puts "  Deleted: #{gem_file}"
+    end
     puts "✅ Clean complete"
   end
 end

data/docs/QUICK-START.md

@@ -860,7 +860,7 @@ E11y.config.adapters[:logs].healthy?
 | OTelLogs payload attributes | All payload attributes now included in OTel log records |
 | `config.slo_tracking = true` | Boolean coercion now accepted |
 | `retention` / `retention_period` | Both work as aliases on event class |
-| `config.slo do` | SLO configuration block DSL |
+| `add_slo_controller` / `add_slo_job` | Helpers on `E11y::Configuration` (stored config; see UC-004) |
 | `config.rate_limiting do` | Rate limiting block DSL |
 | `config.cardinality_protection do` | Cardinality DSL block |
 | `config.register_adapter` | Alias for `config.adapters[name] =` |
@@ -878,7 +878,7 @@ The following features are **documented in ADRs** but not yet implemented:
 |---------|--------|
 | `rails g e11y:grafana_dashboard` | ADR-003 |
 | `rails g e11y:prometheus_alerts` | ADR-003 |
-| `config.slo do controller ... job ... end` — per-controller SLO config | ADR-003 |
+| Wire `add_slo_controller` / `add_slo_job` into HTTP/job `Tracker` dimensions | UC-004, ADR-003 |
 | Per-event rate limiting (`rate_limit` DSL on event class) | UC-011 |
 | Tiered storage (archival) | UC-019 — filter by `retention_until` |
 | Cost Tracking / Budget Enforcement | ADR-009, UC-015 |

data/docs/RAILS_INTEGRATION.md

@@ -2,28 +2,78 @@
 
 > Back to [README](../README.md#documentation)
 
-E11y integrates with Rails via Railtie.
+E11y integrates with Rails via `E11y::Railtie` (`lib/e11y/railtie.rb`). After `bundle install`, requiring the gem in a Rails app loads the Railtie automatically.
 
-## Auto-Instrumented Components
+## Request middleware
 
-E11y includes event definitions for common Rails components:
+`E11y::Middleware::Request` is inserted into the Rack stack (before `Rails::Rack::Logger` when present). It sets trace and request context on `E11y::Current`, optionally starts the **ephemeral (request-scoped) buffer** for debug events, and adds `X-E11y-Trace-Id` / `X-E11y-Span-Id` response headers.
 
-| Component | Event Classes | Location |
-|-----------|--------------|----------|
-| **HTTP Requests** | Request, StartProcessing, Redirect, SendFile | `lib/e11y/events/rails/http/` |
-| **ActiveRecord** | Query | `lib/e11y/events/rails/database/` |
-| **ActiveJob** | Enqueued, Started, Completed, Failed, Scheduled | `lib/e11y/events/rails/job/` |
-| **Cache** | Read, Write, Delete | `lib/e11y/events/rails/cache/` |
-| **View** | Render | `lib/e11y/events/rails/view/` |
+## Rails instrumentation (`ActiveSupport::Notifications`)
 
-Enable instrumentation in your configuration as needed.
+When **`config.rails_instrumentation_enabled = true`**, E11y subscribes to Rails instrumentation and maps notifications to typed events (see `lib/e11y/instruments/rails_instrumentation.rb`).
 
-## Sidekiq Integration
+| Area | Event classes (under `E11y::Events::Rails::`) |
+|------|-----------------------------------------------|
+| HTTP | `Http::Request`, `Http::StartProcessing`, `Http::Redirect`, `Http::SendFile` |
+| Database | `Database::Query` |
+| Active Job (notification names) | `Job::Enqueued`, `Job::Scheduled`, `Job::Started`, `Job::Completed`, `Job::Failed` |
+| Cache | `Cache::Read`, `Cache::Write`, `Cache::Delete` |
+| Views | `View::Render` |
 
-E11y includes Sidekiq instrumentation support. Configure in your initializer:
+This is **independent** of the Sidekiq and Active Job toggles below: instrumentation listens to Rails; the job toggles add **extra** process integration (buffer lifecycle, middleware, callbacks).
+
+## Sidekiq
+
+Enable **only if** you use Sidekiq:
+
+```ruby
+E11y.configure do |config|
+  config.sidekiq_enabled = true
+end
+```
+
+The Railtie registers client and server middleware (`E11y::Instruments::Sidekiq`) so jobs participate in the same **ephemeral buffer** semantics as HTTP requests when `config.ephemeral_buffer_enabled` is true.
+
+On enqueue, **`E11y::Current.user_id`** (when set, e.g. from request middleware) is merged into **`e11y_baggage`** together with any allowed `Current.baggage` keys. The worker restores **`E11y::Current.baggage`** and **`E11y::Current.user_id`** from that hash. Key **`user_id`** is in the default baggage allowlist (`E11y::BAGGAGE_PROTECTION_DEFAULT_ALLOWED_KEYS`).
+
+## Active Job
+
+Enable when you want callbacks and buffer handling on **`ActiveJob::Base`** (and **`ApplicationJob`** when that constant is already defined at hook time):
+
+```ruby
+E11y.configure do |config|
+  config.active_job_enabled = true
+end
+```
+
+You can use **both** `rails_instrumentation_enabled` and `active_job_enabled`; they complement each other. If you only enqueue via Sidekiq without Active Job, you may rely on `sidekiq_enabled` alone.
+
+The **`before_enqueue`** callback applies the same **`e11y_baggage`** merge as Sidekiq (including **`user_id`** from `E11y::Current`).
+
+## Rails.logger bridge
+
+Optional wrapper that still delegates to the original logger but also emits **`E11y::Events::Rails::Log::*`** events (`lib/e11y/events/rails/log.rb`):
 
 ```ruby
 E11y.configure do |config|
-  config.rails_instrumentation_enabled = true
+  config.logger_bridge_enabled = true
+  # Optional: only these severities (Symbol or String); nil / empty = all
+  config.logger_bridge_track_severities = %i[warn error fatal]
+  # Optional: skip noisy lines (String substrings or Regexp)
+  config.logger_bridge_ignore_patterns = [%r{health}]
 end
 ```
+
+Filtering uses **`logger_bridge_track_severities`** and **`logger_bridge_ignore_patterns`** only.
+
+## Configuration reference
+
+| Flag | Purpose |
+|------|---------|
+| `rails_instrumentation_enabled` | Map `ActiveSupport::Notifications` to E11y events |
+| `sidekiq_enabled` | Sidekiq client/server middleware |
+| `active_job_enabled` | `ActiveJob::Base` / `ApplicationJob` callbacks |
+| `logger_bridge_enabled` | Wrap `Rails.logger` with `E11y::Logger::Bridge` |
+| `ephemeral_buffer_enabled` | Request/job-scoped debug buffer (see README) |
+
+Further detail: [ADR-008: Rails integration](architecture/ADR-008-rails-integration.md), [Quick Start](QUICK-START.md).

data/docs/architecture/ADR-001-architecture.md

@@ -2351,7 +2351,7 @@ end
 **Middleware checks opt-out flag before processing:**
 
 ```ruby
-# E11y::Middleware::PIIFiltering
+# E11y::Middleware::PIIFilter
 def call(event_data)
   event_class = event_data[:event_class]