brainzlab 0.1.12 → 0.1.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85a5cf3a64e256a569be39f7caa1ec6268755616ac6037db51f1543ee74dd50c
-  data.tar.gz: '09c531bb0793d26db1f62faf41f9ead294130a7036f6e5f6ab270fd8c6c46040'
+  metadata.gz: ac1922e302a243a61b38d955da04782ae4e66c11908bea728a39b6ad3c68634e
+  data.tar.gz: 748d7f686bf204d0e0ef9322fb445dd75b62c13404472758631e976cc135c295
 SHA512:
-  metadata.gz: 28c2f10fc4457d4f2f34c5bcf4d63c14a062d4fcd8437b13cbcebc1a062976361b2014f5567e0fff82682a054fa83363f7e955a23d3d59ae285a9f06500c79e6
-  data.tar.gz: 5d130bf7242d57c3149803649262995daf298483c406002ab99e01495efb14df7a6874b8eb485daa90c79da8903ad37f6516ba0ca7e2c8930ff069a1b536a206
+  metadata.gz: ee4bdba72d0fed3db7489bf0335de8dd4b8139a941eb381b4a35a3425ca0fa7755f3702869ac93405a5cd0e9def39174ced81eb559c3de99b6970e353c99f977
+  data.tar.gz: 8aec3a840b93948c73ad1e1e518182b316b4a8a29c20c8b5a6819a88c5f12e647d9c576dc865e04991ac0ea4976e2536d21751b1291ebbaf5594713a9317b2b7

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.13] - 2026-02-24
+
+### Fixed
+
+- **Rails LogFormatter** - Fix `TypeError: wrong element type Hash at 0 (expected array)` in `format_params_toml`
+  - `hash_like?` incorrectly matched Arrays (they respond to `to_h` and `each`), causing `Array#to_h` to fail when params contained arrays of hashes
+
 ## [0.1.1] - 2025-12-23
 
 ### Fixed

data/lib/brainzlab/configuration.rb

@@ -10,7 +10,8 @@ module BrainzLab
     # mode has a custom setter with validation
     attr_reader :mode
 
-    attr_accessor :secret_key,
+    attr_accessor :enabled,
+                  :secret_key,
                   :environment,
                   :service,
                   :host,
@@ -169,6 +170,9 @@ module BrainzLab
     }.freeze
 
     def initialize
+      # SDK enabled flag — set BRAINZLAB_SDK_ENABLED=false to completely disable
+      @enabled = ENV.fetch('BRAINZLAB_SDK_ENABLED', 'true') != 'false'
+
       # Authentication
       @secret_key = ENV.fetch('BRAINZLAB_SECRET_KEY', nil)
 
@@ -422,7 +426,11 @@ module BrainzLab
     end
 
     def valid?
-      !@secret_key.nil? && !@secret_key.empty?
+      @enabled && !@secret_key.nil? && !@secret_key.empty?
+    end
+
+    def enabled?
+      @enabled == true
     end
 
     def reflex_valid?
@@ -537,8 +545,24 @@ module BrainzLab
       @debug == true
     end
 
+    # Returns hostnames of all configured SDK service URLs
+    # Used by Net::HTTP instrumentation to skip tracking SDK's own HTTP calls
+    def sdk_service_hosts
+      @sdk_service_hosts ||= begin
+        urls = [
+          @recall_url, @reflex_url, @pulse_url, @flux_url,
+          @signal_url, @vault_url, @vision_url, @cortex_url,
+          @beacon_url, @nerve_url, @dendrite_url, @sentinel_url,
+          @synapse_url
+        ].compact
+
+        urls.filter_map { |url| URI.parse(url).host rescue nil }.uniq
+      end
+    end
+
     # Check if recall is effectively enabled (considering self-tracking)
     def recall_effectively_enabled?
+      return false unless @enabled
       return false unless @recall_enabled
       return true unless @disable_self_tracking
 
@@ -549,6 +573,7 @@ module BrainzLab
 
     # Check if reflex is effectively enabled (considering self-tracking)
     def reflex_effectively_enabled?
+      return false unless @enabled
       return false unless @reflex_enabled
       return true unless @disable_self_tracking
 
@@ -559,6 +584,7 @@ module BrainzLab
 
     # Check if pulse is effectively enabled (considering self-tracking)
     def pulse_effectively_enabled?
+      return false unless @enabled
       return false unless @pulse_enabled
       return true unless @disable_self_tracking
 
@@ -569,6 +595,7 @@ module BrainzLab
 
     # Check if flux is effectively enabled (considering self-tracking)
     def flux_effectively_enabled?
+      return false unless @enabled
       return false unless @flux_enabled
       return true unless @disable_self_tracking
 
@@ -579,6 +606,7 @@ module BrainzLab
 
     # Check if signal is effectively enabled (considering self-tracking)
     def signal_effectively_enabled?
+      return false unless @enabled
       return false unless @signal_enabled
       return true unless @disable_self_tracking
 

data/lib/brainzlab/devtools/middleware/asset_server.rb

@@ -18,6 +18,7 @@ module BrainzLab
 
         def call(env)
           return @app.call(env) unless DevTools.enabled?
+          return @app.call(env) if env['REQUEST_METHOD'] == 'OPTIONS'
 
           path = env['PATH_INFO']
           asset_prefix = DevTools.asset_path

data/lib/brainzlab/devtools/middleware/debug_panel.rb

@@ -38,6 +38,7 @@ module BrainzLab
           return false unless DevTools.debug_panel_enabled?
           return false unless DevTools.allowed_environment?
           return false unless DevTools.allowed_ip?(extract_ip(env))
+          return false if env['REQUEST_METHOD'] == 'OPTIONS'
           return false if asset_request?(env['PATH_INFO'])
           return false if devtools_asset_request?(env['PATH_INFO'])
           return false if turbo_stream_request?(env)

data/lib/brainzlab/devtools/middleware/error_page.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'json'
+
 module BrainzLab
   module DevTools
     module Middleware
@@ -10,29 +12,33 @@ module BrainzLab
         end
 
         def call(env)
+          return @app.call(env) if env['REQUEST_METHOD'] == 'OPTIONS'
           return @app.call(env) unless should_handle?(env)
 
           begin
             status, headers, body = @app.call(env)
 
             # Check if this is an error response that we should intercept
-            if status >= 400 && html_response?(headers) && !json_request?(env)
+            if status >= 400 && html_response?(headers) && !json_request?(env) && !api_path?(env)
               # Check if this looks like Rails' default error page
               body_content = collect_body(body)
               if body_content.include?('Action Controller: Exception caught') || body_content.include?('background: #C00')
                 # Extract exception info from the page
                 exception_info = extract_exception_from_html(body_content)
                 if exception_info
-                  data = collect_debug_data_from_info(env, exception_info)
-                  return render_error_page_from_info(exception_info, data)
+                  data = collect_debug_data_from_info(env, exception_info, status)
+                  return render_error_page_from_info(exception_info, data, status)
                 end
               end
             end
 
             [status, headers, body]
           rescue Exception => e
-            # Don't intercept if request wants JSON
-            return raise_exception(e) if json_request?(env)
+            # For JSON/API requests, return a proper JSON error response
+            if json_request?(env) || api_path?(env)
+              capture_to_reflex(e)
+              return json_error_response(e)
+            end
 
             # Still capture to Reflex if available
             capture_to_reflex(e)
@@ -87,7 +93,7 @@ module BrainzLab
              .gsub(' ', ' ')
         end
 
-        def collect_debug_data_from_info(env, info)
+        def collect_debug_data_from_info(env, info, status = 500)
           context = defined?(BrainzLab::Context) ? BrainzLab::Context.current : nil
           collector_data = Data::Collector.get_request_data
 
@@ -113,7 +119,7 @@ module BrainzLab
           }
         end
 
-        def render_error_page_from_info(info, data)
+        def render_error_page_from_info(info, data, status = 500)
           # Create a simple exception-like object
           exception = StandardError.new(info[:message])
           exception.define_singleton_method(:class) do
@@ -126,7 +132,7 @@ module BrainzLab
           html = @renderer.render(exception, data)
 
           [
-            500,
+            status,
             {
               'Content-Type' => 'text/html; charset=utf-8',
               'Content-Length' => html.bytesize.to_s,
@@ -169,6 +175,48 @@ module BrainzLab
             env['HTTP_X_REQUESTED_WITH'] == 'XMLHttpRequest'
         end
 
+        def api_path?(env)
+          path = env['PATH_INFO'] || ''
+          path.start_with?('/api/')
+        end
+
+        def exception_to_status(exception)
+          case exception.class.name
+          when 'ActionController::RoutingError', 'AbstractController::ActionNotFound'
+            404
+          when 'ActionController::MethodNotAllowed'
+            405
+          when 'ActionController::BadRequest', 'ActionDispatch::Http::Parameters::ParseError'
+            400
+          when 'ActionController::UnknownFormat'
+            406
+          else
+            500
+          end
+        end
+
+        def json_error_response(exception)
+          status_code = exception_to_status(exception)
+          message = case status_code
+                    when 400 then 'Bad request'
+                    when 404 then 'Not found'
+                    when 405 then 'Method not allowed'
+                    when 406 then 'Not acceptable'
+                    else 'Internal server error'
+                    end
+
+          body = JSON.generate({ error: message })
+          [
+            status_code,
+            {
+              'Content-Type' => 'application/json; charset=utf-8',
+              'Content-Length' => body.bytesize.to_s,
+              'X-Content-Type-Options' => 'nosniff'
+            },
+            [body]
+          ]
+        end
+
         def capture_to_reflex(exception)
           return unless defined?(BrainzLab::Reflex)
 

data/lib/brainzlab/flux/buffer.rb

@@ -76,7 +76,7 @@ module BrainzLab
 
         @client.send_batch(events: events, metrics: metrics)
       rescue StandardError => e
-        BrainzLab.debug("[Flux] Batch send failed: #{e.message}")
+        BrainzLab.debug_log("[Flux] Batch send failed: #{e.message}")
       end
 
       def start_flush_thread
@@ -86,7 +86,7 @@ module BrainzLab
             begin
               flush! if size.positive?
             rescue StandardError => e
-              BrainzLab.debug("[Flux] Flush thread error: #{e.message}")
+              BrainzLab.debug_log("[Flux] Flush thread error: #{e.message}")
             end
           end
         end

data/lib/brainzlab/flux/client.rb

@@ -48,11 +48,11 @@ module BrainzLab
 
         response = http.request(request)
 
-        BrainzLab.debug("[Flux] Request failed: #{response.code} - #{response.body}") unless response.is_a?(Net::HTTPSuccess)
+        BrainzLab.debug_log("[Flux] Request failed: #{response.code} - #{response.body}") unless response.is_a?(Net::HTTPSuccess)
 
         response
       rescue StandardError => e
-        BrainzLab.debug("[Flux] Request error: #{e.message}")
+        BrainzLab.debug_log("[Flux] Request error: #{e.message}")
         nil
       end
 

data/lib/brainzlab/instrumentation/active_support_cache.rb

@@ -43,8 +43,10 @@ module BrainzLab
         # ============================================
         def install_cache_read_subscriber!
           ActiveSupport::Notifications.subscribe('cache_read.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_read(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_read(event)
+            end
           end
         end
 
@@ -76,8 +78,10 @@ module BrainzLab
         # ============================================
         def install_cache_read_multi_subscriber!
           ActiveSupport::Notifications.subscribe('cache_read_multi.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_read_multi(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_read_multi(event)
+            end
           end
         end
 
@@ -122,8 +126,10 @@ module BrainzLab
         # ============================================
         def install_cache_write_subscriber!
           ActiveSupport::Notifications.subscribe('cache_write.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_write(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_write(event)
+            end
           end
         end
 
@@ -150,8 +156,10 @@ module BrainzLab
         # ============================================
         def install_cache_write_multi_subscriber!
           ActiveSupport::Notifications.subscribe('cache_write_multi.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_write_multi(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_write_multi(event)
+            end
           end
         end
 
@@ -186,8 +194,10 @@ module BrainzLab
         # ============================================
         def install_cache_delete_subscriber!
           ActiveSupport::Notifications.subscribe('cache_delete.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_delete(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_delete(event)
+            end
           end
         end
 
@@ -211,8 +221,10 @@ module BrainzLab
         # ============================================
         def install_cache_exist_subscriber!
           ActiveSupport::Notifications.subscribe('cache_exist?.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_exist(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_exist(event)
+            end
           end
         end
 
@@ -236,8 +248,10 @@ module BrainzLab
         # ============================================
         def install_cache_fetch_hit_subscriber!
           ActiveSupport::Notifications.subscribe('cache_fetch_hit.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_fetch_hit(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_fetch_hit(event)
+            end
           end
         end
 
@@ -264,8 +278,10 @@ module BrainzLab
         # ============================================
         def install_cache_generate_subscriber!
           ActiveSupport::Notifications.subscribe('cache_generate.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_generate(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_generate(event)
+            end
           end
         end
 
@@ -312,8 +328,10 @@ module BrainzLab
         # ============================================
         def install_cache_increment_subscriber!
           ActiveSupport::Notifications.subscribe('cache_increment.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_increment(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_increment(event)
+            end
           end
         end
 
@@ -349,8 +367,10 @@ module BrainzLab
         # ============================================
         def install_cache_decrement_subscriber!
           ActiveSupport::Notifications.subscribe('cache_decrement.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_decrement(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_decrement(event)
+            end
           end
         end
 
@@ -386,8 +406,10 @@ module BrainzLab
         # ============================================
         def install_cache_delete_multi_subscriber!
           ActiveSupport::Notifications.subscribe('cache_delete_multi.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_delete_multi(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_delete_multi(event)
+            end
           end
         end
 
@@ -422,8 +444,10 @@ module BrainzLab
         # ============================================
         def install_cache_delete_matched_subscriber!
           ActiveSupport::Notifications.subscribe('cache_delete_matched.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_delete_matched(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_delete_matched(event)
+            end
           end
         end
 
@@ -466,8 +490,10 @@ module BrainzLab
         # ============================================
         def install_cache_cleanup_subscriber!
           ActiveSupport::Notifications.subscribe('cache_cleanup.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_cleanup(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_cleanup(event)
+            end
           end
         end
 
@@ -502,8 +528,10 @@ module BrainzLab
         # ============================================
         def install_cache_prune_subscriber!
           ActiveSupport::Notifications.subscribe('cache_prune.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_cache_prune(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_cache_prune(event)
+            end
           end
         end
 
@@ -552,8 +580,10 @@ module BrainzLab
         # ============================================
         def install_message_serializer_fallback_subscriber!
           ActiveSupport::Notifications.subscribe('message_serializer_fallback.active_support') do |*args|
-            event = ActiveSupport::Notifications::Event.new(*args)
-            handle_message_serializer_fallback(event)
+            BrainzLab.with_instrumentation_guard do
+              event = ActiveSupport::Notifications::Event.new(*args)
+              handle_message_serializer_fallback(event)
+            end
           end
         end
 

data/lib/brainzlab/instrumentation/net_http.rb

@@ -63,6 +63,9 @@ module BrainzLab
 
         def should_track?
           return false unless BrainzLab.configuration.instrument_http
+          # Skip tracking SDK's own HTTP calls to its service endpoints
+          # to prevent recursive cascading (SDK HTTP → track → Recall.debug → buffer → flush → SDK HTTP → ...)
+          return false if BrainzLab.configuration.sdk_service_hosts.include?(address)
 
           ignore_hosts = BrainzLab.configuration.http_ignore_hosts || []
           !ignore_hosts.include?(address)
@@ -82,22 +85,24 @@ module BrainzLab
           duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - started_at) * 1000).round(2)
           level = error || (status && status >= 400) ? :error : :info
 
-          # Add breadcrumb for Reflex
-          if BrainzLab.configuration.reflex_enabled
-            BrainzLab::Reflex.add_breadcrumb(
-              "#{method} #{url}",
-              category: 'http',
-              level: level,
-              data: { method: method, url: url, status_code: status, duration_ms: duration_ms, error: error }.compact
-            )
-          end
-
-          # Log to Recall at debug level (avoid noise)
-          if BrainzLab.configuration.recall_enabled
-            BrainzLab::Recall.debug(
-              "HTTP #{method} #{url} -> #{status || 'ERROR'}",
-              method: method, url: url, status_code: status, duration_ms: duration_ms, error: error
-            )
+          BrainzLab.with_instrumentation_guard do
+            # Add breadcrumb for Reflex (in-memory, safe)
+            if BrainzLab.configuration.reflex_enabled
+              BrainzLab::Reflex.add_breadcrumb(
+                "#{method} #{url}",
+                category: 'http',
+                level: level,
+                data: { method: method, url: url, status_code: status, duration_ms: duration_ms, error: error }.compact
+              )
+            end
+
+            # Log to Recall at debug level (skipped if already instrumenting)
+            if BrainzLab.configuration.recall_enabled
+              BrainzLab::Recall.debug(
+                "HTTP #{method} #{url} -> #{status || 'ERROR'}",
+                method: method, url: url, status_code: status, duration_ms: duration_ms, error: error
+              )
+            end
           end
         rescue StandardError => e
           # Don't let instrumentation errors crash the app

data/lib/brainzlab/instrumentation.rb

@@ -6,6 +6,12 @@ module BrainzLab
       def install!
         config = BrainzLab.configuration
 
+        # Skip all instrumentation if SDK is disabled
+        unless config.enabled?
+          BrainzLab.debug_log('[Instrumentation] SDK disabled via BRAINZLAB_SDK_ENABLED=false, skipping all instrumentation')
+          return
+        end
+
         # Skip Rails-specific instrumentation if brainzlab-rails gem is handling it
         # This prevents double-tracking of events
         if config.rails_instrumentation_handled_externally

data/lib/brainzlab/pulse.rb

@@ -82,7 +82,13 @@ module BrainzLab
         ensure_provisioned!
         return unless BrainzLab.configuration.pulse_valid?
 
-        client.send_metric(payload)
+        if BrainzLab.instrumenting?
+          # During instrumentation, send in background thread to avoid
+          # blocking the host app with synchronous HTTP
+          Thread.new { client.send_metric(payload) }
+        else
+          client.send_metric(payload)
+        end
       end
 
       # Convenience methods for metrics

data/lib/brainzlab/rails/log_formatter.rb

@@ -641,7 +641,7 @@ module BrainzLab
       end
 
       def hash_like?(obj)
-        obj.is_a?(Hash) || (obj.respond_to?(:to_h) && obj.respond_to?(:each))
+        obj.is_a?(Hash) || (!obj.is_a?(Array) && obj.respond_to?(:to_h) && obj.respond_to?(:each))
       end
 
       def format_params_toml(params, prefix = '', depth = 0)

data/lib/brainzlab/rails/railtie.rb

@@ -55,6 +55,12 @@ module BrainzLab
       end
 
       config.after_initialize do
+        # Skip all SDK initialization if disabled
+        unless BrainzLab.configuration.enabled?
+          BrainzLab.debug_log('[Railtie] SDK disabled via BRAINZLAB_SDK_ENABLED=false, skipping initialization')
+          next
+        end
+
         # Set up custom log formatter
         BrainzLab::Rails::Railtie.setup_log_formatter if BrainzLab.configuration.log_formatter_enabled
 
@@ -114,8 +120,13 @@ module BrainzLab
         end
 
         def silence_rails_logging
-          # Create a null logger that discards all output
-          null_logger = Logger.new(File::NULL)
+          # Create a null logger that discards all output.
+          # Use ActiveSupport::Logger (not a plain ::Logger) so the logger
+          # retains LoggerSilence#silence — SolidQueue's poller calls
+          # `ActiveRecord::Base.logger.silence { ... }` every cycle, and a
+          # plain Logger lacks `silence` (NoMethodError → workers crash-loop).
+          logger_class = defined?(ActiveSupport::Logger) ? ActiveSupport::Logger : Logger
+          null_logger = logger_class.new(File::NULL)
           null_logger.level = Logger::FATAL
 
           # Silence ActiveRecord SQL logging
@@ -217,7 +228,11 @@ module BrainzLab
         context.request_method = request.request_method
         context.request_path = request.path
         context.request_url = request.url
-        context.request_params = filter_params(request.params.to_h)
+        context.request_params = begin
+          filter_params(request.params.to_h)
+        rescue ActionDispatch::Http::Parameters::ParseError
+          {}
+        end
         context.request_headers = extract_headers(env)
 
         # Add breadcrumb for request start

data/lib/brainzlab/recall/buffer.rb

@@ -19,7 +19,9 @@ module BrainzLab
 
       def push(log_entry)
         @buffer.push(log_entry)
-        flush if @buffer.size >= @config.recall_buffer_size
+        # Skip synchronous flush during instrumentation to avoid blocking the host app.
+        # The background flush thread will send these entries within recall_flush_interval seconds.
+        flush if @buffer.size >= @config.recall_buffer_size && !BrainzLab.instrumenting?
       end
 
       def flush

data/lib/brainzlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrainzLab
-  VERSION = '0.1.12'
+  VERSION = '0.1.20'
 end

data/lib/brainzlab.rb

@@ -35,7 +35,32 @@ require_relative 'brainzlab/utilities'
 require_relative 'brainzlab/development'
 
 module BrainzLab
+  # Thread-local re-entrancy guard for instrumentation.
+  # When true, SDK operations that would make HTTP calls are skipped
+  # to prevent recursive instrumentation from blocking the host app.
+  INSTRUMENTING_KEY = :brainzlab_instrumenting
+
   class << self
+    # Returns true when inside an instrumentation handler.
+    # Used by Recall.log, Pulse.record_metric, etc. to skip HTTP calls
+    # that would block the host app during notification callbacks.
+    def instrumenting?
+      Thread.current[INSTRUMENTING_KEY] == true
+    end
+
+    # Executes a block within the instrumentation guard.
+    # Prevents recursive/cascading SDK HTTP calls from instrumentation handlers.
+    def with_instrumentation_guard
+      return if Thread.current[INSTRUMENTING_KEY]
+
+      Thread.current[INSTRUMENTING_KEY] = true
+      begin
+        yield
+      ensure
+        Thread.current[INSTRUMENTING_KEY] = nil
+      end
+    end
+
     def configure
       yield(configuration) if block_given?
       configuration

data/lib/fluyenta-ruby.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'brainzlab'

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: brainzlab
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.20
 platform: ruby
 authors:
-- Brainz Lab
+- BrainzLab
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -93,11 +93,11 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: Official Ruby SDK for BrainzLab observability platform. Includes Recall
-  (structured logging), Reflex (error tracking), and Pulse (APM with distributed tracing).
-  Auto-instruments Rails, Sidekiq, GraphQL, Redis, and more.
+description: Ruby SDK for the BrainzLab observability platform. Includes Recall (structured
+  logging), Reflex (error tracking), and Pulse (APM with distributed tracing). Auto-instruments
+  Rails, Sidekiq, GraphQL, Redis, and more.
 email:
-- support@brainzlab.ai
+- rubygems@brainz.llc
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -219,6 +219,7 @@ files:
 - lib/brainzlab/vision.rb
 - lib/brainzlab/vision/client.rb
 - lib/brainzlab/vision/provisioner.rb
+- lib/fluyenta-ruby.rb
 - lib/generators/brainzlab/install/install_generator.rb
 - lib/generators/brainzlab/install/templates/brainzlab.rb.tt
 homepage: https://brainzlab.ai
@@ -226,11 +227,11 @@ licenses:
 - Nonstandard
 metadata:
   homepage_uri: https://brainzlab.ai
-  source_code_uri: https://github.com/brainz-lab/brainzlab-ruby
-  changelog_uri: https://github.com/brainz-lab/brainzlab-ruby/blob/main/CHANGELOG.md
+  source_code_uri: https://github.com/brainz-llc/brainzlab-ruby
+  changelog_uri: https://github.com/brainz-llc/brainzlab-ruby/blob/main/CHANGELOG.md
   documentation_uri: https://docs.brainzlab.ai/sdk/ruby
   rubygems_mfa_required: 'true'
-  github_repo: ssh://github.com/brainz-lab/brainzlab-ruby
+  github_repo: ssh://github.com/brainz-llc/brainzlab-ruby
 rdoc_options: []
 require_paths:
 - lib
@@ -247,6 +248,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Ruby SDK for BrainzLab - Recall logging, Reflex error tracking, and Pulse
-  APM
+summary: Ruby SDK for BrainzLab observability
 test_files: []