debugbundle 2.0.0 → 2.1.0

data/lib/debugbundle/remote_config.rb

@@ -10,6 +10,7 @@ module DebugBundle
       :capture_request_events,
       :capture_breadcrumbs,
       :capture_probe_events,
+      :capture_diagnostic_context,
       :immediate_client_error_statuses,
       :immediate_client_error_path_rules,
       keyword_init: true
@@ -72,6 +73,7 @@ module DebugBundle
         capture_request_events: 'failures_only',
         capture_breadcrumbs: 'local_only',
         capture_probe_events: 'buffer_only',
+        capture_diagnostic_context: false,
         immediate_client_error_statuses: [],
         immediate_client_error_path_rules: []
       )
@@ -84,6 +86,7 @@ module DebugBundle
         capture_request_events: 'failures_only',
         capture_breadcrumbs: 'exception_only',
         capture_probe_events: 'buffer_only',
+        capture_diagnostic_context: true,
         immediate_client_error_statuses: [],
         immediate_client_error_path_rules: []
       )
@@ -125,6 +128,8 @@ module DebugBundle
           payload['capture_request_events'] || payload[:capture_request_events] || 'failures_only',
         capture_breadcrumbs: payload['capture_breadcrumbs'] || payload[:capture_breadcrumbs] || 'exception_only',
         capture_probe_events: payload['capture_probe_events'] || payload[:capture_probe_events] || 'buffer_only',
+        capture_diagnostic_context: (payload['preset'] || payload[:preset]) != 'minimal' &&
+          payload['capture_diagnostic_context'] != false && payload[:capture_diagnostic_context] != false,
         immediate_client_error_statuses: Array(
           payload['immediate_client_error_statuses'] || payload[:immediate_client_error_statuses]
         ).grep(Integer),

data/lib/debugbundle/sidekiq/server_middleware.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'debugbundle/framework_operation'
+
 module DebugBundle
   module Sidekiq
     class ServerMiddleware
@@ -9,25 +11,27 @@ module DebugBundle
       end
 
       def call(_worker, job, queue)
-        yield
-      rescue StandardError => e
-        @client.capture_exception(
-          e,
-          context: {
-            queue: queue,
-            job: {
-              class: job['class'],
-              queue: job['queue'] || queue,
-              jid: job['jid'],
-              retry_count: job['retry_count'] || job['retry'],
-              args_summary: Array(job['args']).first(5).map { |value| value.class.name }
+        FrameworkOperation.run(@client, kind: 'job', correlation: { trace_id: job['trace_id'] }) do
+          yield
+        rescue StandardError => e
+          @client.capture_exception(
+            e,
+            context: {
+              queue: queue,
+              job: {
+                class: job['class'],
+                queue: job['queue'] || queue,
+                jid: job['jid'],
+                retry_count: job['retry_count'] || job['retry'],
+                args_summary: Array(job['args']).first(5).map { |value| value.class.name }
+              },
+              job_id: job['jid'],
+              trace_id: job['trace_id']
             },
-            job_id: job['jid'],
-            trace_id: job['trace_id']
-          },
-          handled: false
-        )
-        raise
+            handled: false
+          )
+          raise
+        end
       end
     end
   end

data/lib/debugbundle/telemetry_privacy.rb

@@ -29,7 +29,11 @@ module DebugBundle
       end
 
       work = { nodes: 0, bytes: 0, seen: {}.compare_by_identity,
-               fields: (FIELDS + additional_fields).map { |field| canonical(field) },
+               fields: if additional_fields.empty?
+                         CANONICAL_FIELDS
+                       else
+                         CANONICAL_FIELDS + additional_fields.map { |field| canonical(field) }
+                       end,
                extra: additional_fields,
                assignment_pattern: assignment_pattern(additional_fields) }
       result = visit(value, work, 0, true)
@@ -54,6 +58,10 @@ module DebugBundle
       value.downcase.gsub(/[^a-z0-9]/, '')
     end
 
+    # Mandatory terms are immutable policy. Reuse their normalised form while
+    # each projection still owns its counters, seen set and configured keys.
+    CANONICAL_FIELDS = FIELDS.map { |field| canonical(field).freeze }.freeze
+
     def assignment_pattern(additional_fields)
       return DEFAULT_ASSIGNMENT_PATTERN if additional_fields.empty?
 

data/lib/debugbundle/transport.rb

@@ -4,13 +4,15 @@ require 'json'
 require 'net/http'
 require 'securerandom'
 require 'uri'
+require 'time'
 require 'fileutils'
+require 'debugbundle/bounded_http_response'
 
 module DebugBundle
   module Transport
     RETRY_AFTER_CAP_SECONDS = 300
 
-    Result = Struct.new(:status_code, :retry_after_seconds, :body, keyword_init: true)
+    Result = Struct.new(:status_code, :retry_after_seconds, :body, :written_file_path, keyword_init: true)
 
     def self.sdk_config_endpoint(events_endpoint)
       uri = URI.parse(events_endpoint)
@@ -47,24 +49,35 @@ module DebugBundle
       end
 
       def call(request)
+        deadline = request.fetch(:deadline) { Process.clock_gettime(Process::CLOCK_MONOTONIC) + 5 }
+        remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        return Result.new(status_code: 500) unless remaining.positive?
+
+        body = JSON.generate(events: request.fetch(:events))
+        return Result.new(status_code: 413) if body.bytesize > 262_144
+
         http = Net::HTTP.new(@uri.host, @uri.port)
         http.use_ssl = @uri.scheme == 'https'
-        http.open_timeout = 5
-        http.read_timeout = 5
-
-        response = http.post(
-          @uri.request_uri,
-          JSON.generate(events: request.fetch(:events)),
-          {
-            'Authorization' => "Bearer #{request.fetch(:project_token)}",
-            'Content-Type' => 'application/json'
-          }
-        )
+        http.open_timeout = remaining
+        http.read_timeout = remaining
+
+        response, raw = BoundedHttpResponse.read(deadline: deadline) do |consume|
+          http.post(
+            @uri.request_uri,
+            body,
+            {
+              'Authorization' => "Bearer #{request.fetch(:project_token)}",
+              'Content-Type' => 'application/json',
+              'Accept-Encoding' => 'identity',
+              'X-DebugBundle-Evidence' => '1'
+            }, &consume
+          )
+        end
 
         Result.new(
           status_code: response.code.to_i,
           retry_after_seconds: parse_retry_after(response['Retry-After']),
-          body: parse_body(response.body)
+          body: parse_body(raw)
         )
       rescue StandardError
         Result.new(status_code: 500)
@@ -83,8 +96,11 @@ module DebugBundle
       def parse_retry_after(value)
         return nil if value.nil? || value.strip.empty?
 
-        seconds = Integer(Float(value))
-        seconds.clamp(0, RETRY_AFTER_CAP_SECONDS)
+        seconds = Float(value, exception: false)
+        seconds = Time.httpdate(value) - Time.now if seconds.nil?
+        return nil unless seconds.finite?
+
+        seconds.clamp(0, RETRY_AFTER_CAP_SECONDS).to_i
       rescue ArgumentError, TypeError
         nil
       end
@@ -104,15 +120,18 @@ module DebugBundle
         http.open_timeout = 5
         http.read_timeout = 5
 
-        request = Net::HTTP::Get.new(@uri.request_uri)
+        request = Net::HTTP::Get.new(@uri.request_uri, 'Accept-Encoding' => 'identity')
         request['Authorization'] = "Bearer #{@project_token}"
         request['Accept'] = 'application/json'
         request['X-DebugBundle-SDK'] = @sdk_name
         request['X-DebugBundle-SDK-Version'] = @sdk_version
         request['If-None-Match'] = etag if etag
+        request['X-DebugBundle-Evidence'] = '1'
 
-        response = http.request(request)
-        body = response.body.to_s.empty? ? {} : JSON.parse(response.body)
+        response, raw = BoundedHttpResponse.read do |consume|
+          http.request(request) { |reply| reply.read_body(&consume) }
+        end
+        body = raw.empty? ? {} : JSON.parse(raw)
         { status_code: response.code.to_i, etag: response['ETag'], body: body }
       rescue StandardError
         { status_code: 500, body: {} }
@@ -146,13 +165,24 @@ module DebugBundle
         File.rename(temp_path, final_path)
         File.chmod(FILE_MODE, final_path)
 
-        Result.new(status_code: 202)
+        Result.new(status_code: 202, written_file_path: final_path)
       rescue StandardError
         Result.new(status_code: 500)
       ensure
         File.delete(temp_path) if defined?(temp_path) && temp_path && File.exist?(temp_path)
       end
 
+      def mark_delivered(path)
+        ensure_secure_directory!(@directory)
+        return false unless File.dirname(File.expand_path(path)) == @directory && path.end_with?('.events.json')
+        return false unless File.file?(path) && !File.symlink?(path)
+
+        write_secure_file("#{path}.delivered", '')
+        true
+      rescue StandardError
+        false
+      end
+
       private
 
       def ensure_secure_directory!(directory)

data/lib/debugbundle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DebugBundle
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

data/lib/debugbundle.rb

@@ -22,7 +22,9 @@ require_relative 'debugbundle/rails' if defined?(Rails::Railtie)
 module DebugBundle
   class << self
     def init(**options)
-      self.client = Client.new(**options)
+      replacement = Client.new(**options)
+      @client.dispose if @client.is_a?(Client)
+      self.client = replacement
       client.capture_exceptions
       client
     end
@@ -41,6 +43,14 @@ module DebugBundle
       client.capture_error(error, context: context)
     end
 
+    def capture_recovery(observation = nil, context: nil, **options)
+      client.capture_recovery(observation, context: context, **options)
+    end
+
+    def with_operation_context(...)
+      client.with_operation_context(...)
+    end
+
     def capture_log(message, level: :warning, context: nil)
       client.capture_log(message, level: level, context: context)
     end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: debugbundle
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - DebugBundle
 bindir: exe
 cert_chain: []
-date: 2026-09-25 00:00:00.000000000 Z
+date: 2026-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -49,14 +49,30 @@ files:
 - lib/debugbundle.rb
 - lib/debugbundle/acknowledgement.rb
 - lib/debugbundle/before_send.rb
+- lib/debugbundle/bounded_http_response.rb
+- lib/debugbundle/canonical_event_schema.rb
 - lib/debugbundle/client.rb
 - lib/debugbundle/client_event_support.rb
+- lib/debugbundle/client_evidence_support.rb
+- lib/debugbundle/client_exception_support.rb
 - lib/debugbundle/client_process_support.rb
 - lib/debugbundle/client_queue_support.rb
 - lib/debugbundle/config.rb
 - lib/debugbundle/config_worker.rb
 - lib/debugbundle/delivery_worker.rb
+- lib/debugbundle/diagnostic_budget.rb
+- lib/debugbundle/event-envelope.schema.json
+- lib/debugbundle/event_batch.rb
+- lib/debugbundle/evidence_delivery.rb
+- lib/debugbundle/evidence_graph.rb
+- lib/debugbundle/evidence_json.rb
+- lib/debugbundle/evidence_resources.rb
+- lib/debugbundle/evidence_value.rb
+- lib/debugbundle/evidence_wire.rb
+- lib/debugbundle/exception_evidence.rb
+- lib/debugbundle/framework_operation.rb
 - lib/debugbundle/logging.rb
+- lib/debugbundle/operation_context.rb
 - lib/debugbundle/rack/middleware.rb
 - lib/debugbundle/rack/relay_middleware.rb
 - lib/debugbundle/rails.rb
@@ -64,6 +80,7 @@ files:
 - lib/debugbundle/rails/relay_endpoint.rb
 - lib/debugbundle/redaction.rb
 - lib/debugbundle/relay.rb
+- lib/debugbundle/relay/forwarder.rb
 - lib/debugbundle/relay/handler.rb
 - lib/debugbundle/remote_config.rb
 - lib/debugbundle/runtime.rb