chronos-ruby 1.1.0 → 1.2.0.pre.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0127def72275a2d4c08314040c04e34a9606fed13982d84b06c465dee7be4cf6
-  data.tar.gz: 99f272314517e6a525223ce86964b70fcdfce717eb0e434b9c77e275031913b7
+  metadata.gz: c13c2858edcb41d4b2a0bfc83049349ee13a5a9ecee873798750b4bf9f1da48c
+  data.tar.gz: a21babcc28ce763e7d867f35064735d661214724c1ed9d256e8d174a1a04c5dc
 SHA512:
-  metadata.gz: 93b37af1a5b51284a6c6de1c19e12de18ac23b04bfa4a04f33b7fce5cb611ec6f940d4ec2508c8a2b8d72f91e9a2a9a812a3b48d72f60dfefd642fb7cf3fe138
-  data.tar.gz: 4c653acb6d7aa90d534a7d496568fca64fb9ba9bce9039c6ca68fad71c1b5aef3f4e5de541a3f3d0f6064f08653359bcc2afc30e3a2d82c910942f0c1e103d4a
+  metadata.gz: 81ab0672785236e1ffaeecf0fbb5ae3187f319be349a06f724eee50dd0d20963afb74a84485267e8ea5e3a7dd37dacef15ab456783fee622bef901110b98344a
+  data.tar.gz: 835ee551ddcec646a44376dcdfc09748e12c0fa360fee62365455e6776503a0597baed504a33276059853e652f5a90458ad7ae43bb582f7647303af9940a5d1f

data/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes are documented here. The project follows Semantic Versioning
 
 ## [Unreleased]
 
+## [1.2.0.pre.1] - 2026-08-11
+
+### Added
+
+- fiber-aware execution context with a thread-local fallback;
+- Sidekiq 7 and Rails 7 error reporter integration using public extension APIs;
+- Action Cable notification spans and a dependency-free Faraday middleware;
+- optional W3C `traceparent` propagation and an OpenTelemetry bridge that consumes the active span without installing an SDK or exporter.
+
+### Changed
+
+- the transitional runtime range is Ruby 2.7 through 3.4 and the default context strategy is `:fiber_local`;
+- Active Job and Sidekiq envelopes may propagate allowlisted span ID and trace flags in addition to trace/request IDs.
+
+### Security
+
+- W3C identifiers are syntax-validated, all-zero IDs are rejected, and Rails error reporter context is reduced to bounded allowlisted metadata.
+
 ## [1.1.0] - 2026-08-05
 
 ### Added

data/README.md

@@ -24,7 +24,7 @@ A gem não varre variáveis de ambiente, sistema de arquivos ou lockfiles e não
 
 ## Versões Ruby e Rails suportadas
 
-A versão 1.1.0 suporta Ruby puro e Rack em Ruby 2.2.10, 2.3.8, 2.4.10, 2.5.9 e 2.6.10. As combinações Rails validadas são Rails 4.2 com Ruby 2.2.10/2.3.8 e Rails 5.2 com Ruby 2.5.9/2.6.10. Sidekiq 4.2.10 com Ruby 2.2.10 e Sidekiq 5.2.10 com Ruby 2.5.9 também possuem gates dedicados. Ruby 2.7/Rails 6 não é declarado nesta release porque ainda não possui aplicação e matriz completas.
+A versão candidata 1.2.0.pre.1 inicia a linha transitional para Ruby 2.7–3.4, Rails 7.x e Sidekiq 7. Ela adiciona contexto por Fiber, Rails Error Reporter, Action Cable, Faraday, Trace Context W3C opcional e coexistência com um SDK OpenTelemetry já configurado. Use-a explicitamente em staging enquanto a matriz transitional é validada; as linhas legadas permanecem disponíveis em releases anteriores.
 
 Rubies e frameworks antigos estão fora do suporte de segurança de seus mantenedores. A Chronos oferece compatibilidade técnica, não manutenção de segurança do runtime. Veja [Compatibilidade](docs/compatibility.md).
 
@@ -204,14 +204,16 @@ Por padrão, SQL bruto e binds não são lidos pelo pipeline de análise. A insp
 
 ## Sidekiq e Active Job
 
-A versão `0.6.0.pre.1` introduziu middleware Sidekiq 4/5; a API estável mantém o require explícito:
+A integração mantém o require explícito e suporta a API pública de middleware do Sidekiq 7:
+
+O suporte histórico começou em `0.6.0.pre.1`; aplicações em Sidekiq 4/5 devem permanecer numa release legada compatível.
 
 ```ruby
 gem "sidekiq", "~> 5.0"
 gem "chronos-ruby", "~> 1.1.0", :require => "chronos/sidekiq"
 ```
 
-O envelope de contexto não altera argumentos públicos e contém somente IDs limitados de trace/request. Active Job usa um campo serializado com namespace (`chronos_context`) e hooks públicos. Erros aninhados são deduplicados e reerguidos. Veja [Sidekiq legado](docs/modules/sidekiq-legacy.md), [Active Job](docs/modules/active-job.md) e [Jobs](docs/modules/job-monitoring.md).
+O envelope de contexto não altera argumentos públicos e contém somente IDs limitados de trace/span/request e flags. Active Job usa um campo serializado com namespace (`chronos_context`) e hooks públicos. Erros aninhados são deduplicados e reerguidos. Veja [Sidekiq legado](docs/modules/sidekiq-legacy.md), [Active Job](docs/modules/active-job.md) e [Jobs](docs/modules/job-monitoring.md).
 
 ## Deploy tracking
 
@@ -319,7 +321,7 @@ Execute suíte e lint no runtime atual:
 bundle _1.17.3_ exec rake
 ```
 
-A matriz CI cobre Ruby 2.2.10–2.6.10, aplicações Rails 4.2/5.2 e Sidekiq 4/5. O workflow de release repete toda a matriz, documentação, benchmark comparativo e carga antes de publicar.
+A matriz CI cobre a linha transitional e os checks de pacote/documentação; workflows legados preservam evidência das releases anteriores.
 
 ## Contribuição
 

data/docs/adr/ADR-010-opentelemetry-interoperability.md

@@ -2,7 +2,7 @@
 
 ## Status
 
-Adiado; limite aceito para 1.0 legado.
+Aceito para 1.2.
 
 ## Contexto
 
@@ -10,7 +10,7 @@ O Chronos precisa correlacionar trace/request sem duplicar SDKs ou impor depend
 
 ## Decisão
 
-Manter IDs de correlação e portas independentes do fornecedor na 1.0. Não depender de OpenTelemetry nem instalar instrumentação global na linha legado. Uma ponte opcional será projetada na linha transitional/modern e deverá traduzir somente campos permitidos.
+Manter IDs de correlação e portas independentes do fornecedor. Na 1.2, a ponte opcional consulta somente o span atual de um SDK já carregado, traduz `trace_id`, `span_id` e flags, e nunca instala SDK, instrumentação ou exporter. IDs Chronos explícitos têm precedência; a presença de OTel deve ser usada pelas integrações para evitar spans paralelos equivalentes.
 
 ## Alternativas
 
@@ -22,4 +22,4 @@ O protocolo v1 permanece estável e aplicações legadas não recebem novas depe
 
 ## Consequências negativas
 
-Não há propagação automática com ecossistemas OpenTelemetry na 1.0; integrações futuras exigirão contrato e matriz próprios.
+A ponte não exporta spans OTel completos nem controla exporters; consumidores que precisam desses dados continuam responsáveis pela configuração do SDK.

data/docs/compatibility.md

@@ -1,39 +1,33 @@
 # Compatibility
 
-Chronos Ruby 1.1 is the current stable legacy line. Technical compatibility does not make an end-of-life Ruby, Rails, Rack, or Sidekiq release secure. The planned Ruby 2.7/Rails 6 transitional matrix remains deferred until it has dedicated CI and a real application gate.
+Chronos Ruby 1.2.0.pre.1 is the first candidate of the transitional line for Rails 7 and Sidekiq 7. Combinations remain `Best effort` until their dedicated CI and real-application gates pass. Technical compatibility does not make an end-of-life Ruby, Rails, Rack, or Sidekiq release secure. Versions 1.0 and 1.1 remain the frozen legacy line.
 
 ## Core and Rack
 
 | Ruby | Status | Evidence |
 |---|---|---|
-| 2.2.10 | Supported | Full unit, integration, contract, Rack, concurrency, fork, transport, privacy, and lint gate |
-| 2.3.8 | Supported | Same dedicated Docker gate |
-| 2.4.10 | Supported | Same dedicated Docker gate |
-| 2.5.9 | Supported | Same dedicated Docker gate |
-| 2.6.10 | Supported | Same dedicated Docker gate |
-| 2.7 and newer | Unsupported in 1.x legacy | Belongs to the transitional or modern lines |
+| 2.7–3.2 | Best effort | Transitional matrix introduced in this candidate; promotion requires green CI evidence |
+| 3.3–3.4 | Best effort | Core checks run in modern CI; Rails 8-specific behavior belongs to 2.x |
+| Earlier than 2.7 | Unsupported in 1.2 | Use an appropriate frozen legacy release |
 
 ## Rails
 
 | Ruby | Rails | Status | Evidence |
 |---|---|---|---|
-| 2.2.10 | 4.2 | Supported | Real application boot, successful/error request, SQL, view, cache, Active Job, mailer, fake endpoint, flush, and shutdown |
-| 2.3.8 | 4.2 | Supported | Same dedicated application gate |
-| 2.5.9 | 5.2 | Supported | Same dedicated application gate |
-| 2.6.10 | 5.2 | Supported | Same dedicated application gate |
-| Other Ruby/Rails pairs | — | Unsupported | No complete release gate; feature detection alone is not a support claim |
+| 2.7–3.2 | 7.0–7.1 | Best effort | Real Rails applications and the complete integration gate are pending |
+| 3.1–3.4 | 7.2 | Best effort | Feature and package checks; use a validated application combination before production rollout |
+| Rails 4–6 | — | Unsupported in 1.2 | Use a matching earlier Chronos release |
 
 ## Sidekiq
 
 | Ruby | Sidekiq | Status | Evidence |
 |---|---|---|---|
-| 2.2.10 | 4.2.10 | Supported | Real-gem client/server middleware smoke with context, success/failure, and deduplication |
-| 2.5.9 | 5.2.10 | Supported | Same dedicated application gate |
-| Other Ruby/Sidekiq pairs | — | Unsupported | No complete release gate |
+| 2.7–3.4 | 7.x | Best effort | Real Sidekiq 7 smoke applications are pending |
+| Sidekiq 4–6 | — | Unsupported in 1.2 | Use a matching earlier Chronos release |
 
 Active Job uses the public `serialize`, `deserialize`, and `perform_now` extension points with a bounded namespaced field. Support follows the validated Rails pairs above. Adapters that bypass these hooks require their own evidence.
 
-The release workflow repeats every supported pair before publishing. Historical 1.0 evidence remains in [Version 1.0 readiness](release-1.0-readiness.md); the 1.1 candidate is recorded in [Version 1.1 readiness](release-1.1-readiness.md).
+Historical evidence remains in [Version 1.0 readiness](release-1.0-readiness.md) and [Version 1.1 readiness](release-1.1-readiness.md).
 
 Status meanings:
 

data/docs/configuration.md

@@ -47,7 +47,7 @@
 | `sampling_rate` | Optional | `1.0` | Local upper bound for event sampling |
 | `enabled_event_types` | Optional | exception, request, query, job, cache, external_http, dependencies, deploy, metric_batch | Local allowlist for supported event envelopes |
 | `max_remote_send_interval` | Optional | `60.0` | Local upper bound for remotely requested send spacing |
-| `context_store` | Optional | `:thread_local` | `:thread_local` or an object implementing `get`, `set`, `clear`, and `with_context` |
+| `context_store` | Optional | `:fiber_local` | `:fiber_local`, `:thread_local`, or an object implementing `get`, `set`, `clear`, and `with_context` |
 | `breadcrumb_capacity` | Optional | `20` | Positive count of newest breadcrumbs retained per execution |
 | `breadcrumb_max_bytes` | Optional | `2048` | Maximum bytes per normalized breadcrumb; minimum `128` |
 | `rails_enabled` | Optional | `true` | Enables automatic Rails middleware and subscribers |
@@ -75,6 +75,8 @@
 | `apm_transaction_max_connections` | Optional | `100` | Maximum concurrently tracked transaction connections; range 1–500 |
 | `external_http_enabled` | Optional | `false` | Allows explicit per-instance outbound `Net::HTTP` instrumentation |
 | `external_http_trace_headers` | Optional | `true` | Propagates Chronos trace/request headers on instrumented requests |
+| `w3c_trace_context` | Optional | `false` | Injects a validated W3C `traceparent` header when trace and span IDs exist |
+| `opentelemetry_bridge` | Optional | `true` | Consumes the current OpenTelemetry span when an SDK is already active; installs nothing |
 | `cache_key_mode` | Optional | `:none` | `:none` omits keys; `:sha256` emits a project-scoped key hash |
 | `dependency_reporting` | Optional | `true` | Emits one bounded dependency event per configured agent |
 | `dependency_max_items` | Optional | `100` | Loaded gem entries retained in the inventory; range 1–200 |
@@ -100,7 +102,7 @@ Chronos.configure do |config|
   config.max_retries = 3
   config.backlog_size = 100
   config.circuit_failure_threshold = 5
-  config.context_store = :thread_local
+  config.context_store = :fiber_local
   config.breadcrumb_capacity = 20
   config.rails_capture_in_test = false
   config.rails_capture_in_console = false
@@ -125,6 +127,8 @@ Chronos.configure do |config|
   config.apm_transaction_max_connections = 100
   config.external_http_enabled = false
   config.external_http_trace_headers = true
+  config.w3c_trace_context = false
+  config.opentelemetry_bridge = true
   config.cache_key_mode = :none
   config.dependency_reporting = true
   config.dependency_max_items = 100

data/docs/modules/context.md

@@ -6,7 +6,7 @@ O contexto relaciona uma exceção ou métrica ao request/job atual sem criar de
 
 ## Fluxo e classes
 
-`Chronos::Ports::ContextStore` define `get`, `set`, `clear` e `with_context`. Na linha legado, `Chronos::Adapters::ThreadLocalContextStore` isola o valor por thread. A fachada combina o contexto explícito com o escopo atual; o serializer sanitiza e limita tudo antes da fila. Rack limpa o escopo em `ensure`, enquanto Sidekiq e Active Job propagam apenas `trace_id` e `request_id`.
+`Chronos::Ports::ContextStore` define `get`, `set`, `clear` e `with_context`. Na linha 1.2, `Chronos::Adapters::FiberLocalContextStore` usa storage do Fiber quando disponível e volta com segurança ao adapter thread-local. A fachada combina o contexto explícito com o escopo atual; o serializer sanitiza e limita tudo antes da fila. Rack limpa o escopo em `ensure`, enquanto Sidekiq e Active Job propagam somente `trace_id`, `span_id`, `trace_flags` e `request_id`.
 
 ## Extensão, riscos e exemplo
 

data/docs/modules/external-http.md

@@ -10,6 +10,7 @@ Chronos.configure do |config|
   # connection settings omitted
   config.external_http_enabled = true
   config.external_http_trace_headers = true
+  config.w3c_trace_context = true
 end
 
 http = Net::HTTP.new("payments.example.com", 443)
@@ -18,10 +19,10 @@ Chronos.instrument_net_http(http)
 response = http.request(Net::HTTP::Get.new("/health"))
 ```
 
-The event contains a bounded lowercase host, uppercase method, response status, monotonic duration, timeout flag, connection-error flag, and error class. A request made inside a Chronos context receives `X-Chronos-Trace-ID` and `X-Chronos-Request-ID` unless the application already set those headers. Disable propagation with `external_http_trace_headers = false`.
+The event contains a bounded lowercase host, uppercase method, response status, monotonic duration, timeout flag, connection-error flag, and error class. A request made inside a Chronos context receives `X-Chronos-Trace-ID` and `X-Chronos-Request-ID` unless the application already set those headers. With `w3c_trace_context = true`, Net::HTTP and `Chronos::Integrations::FaradayMiddleware` also preserve an existing header or inject a validated `traceparent`. Disable all propagation with `external_http_trace_headers = false`.
 
 The wrapper never reads or records the path, query string, Authorization, other request headers, request body, response headers/body, or exception message. The native streaming block is forwarded and the identical HTTP exception is re-raised. Telemetry failures are contained.
 
-Successful and failed calls become bounded `external_http` APM groups keyed only by host and method. A call carrying a trace ID contributes its duration to the enclosing request's `external_http` breakdown. Faraday, HTTP.rb, Excon, and RestClient are outside this release.
+Successful and failed calls become bounded `external_http` APM groups keyed only by host and method. A call carrying a trace ID contributes its duration to the enclosing request's `external_http` breakdown. Faraday is supported through explicit middleware installation; HTTP.rb, Excon, and RestClient remain outside this release.
 
 Installation is idempotent per object. A `false` result means collection is disabled, the object is incompatible or already instrumented, or installation was contained after an internal error.

data/lib/chronos/adapters/fiber_local_context_store.rb

@@ -0,0 +1,57 @@
+module Chronos
+  module Adapters
+    # Stores execution context on the current Fiber when Ruby exposes Fiber storage.
+    #
+    # @responsibility Isolate context between concurrent fibers and restore nested scopes.
+    # @motivation Rails 7 applications increasingly multiplex work on one thread.
+    # @limits Fiber storage is not propagated automatically to newly-created fibers.
+    # @collaborators ContextStore port and Agent composition root.
+    # @thread_safety Each fiber owns its value and may be used from concurrent threads.
+    # @compatibility Ruby 3.2+ Fiber storage; falls back to thread-local storage otherwise.
+    # @example
+    #   store.with_context(:request_id => "r1") { store.get }
+    # @errors Previous context is restored even when the block raises.
+    # @performance Constant-time storage operations with a bounded hash merge.
+    class FiberLocalContextStore
+      def initialize(fallback = ThreadLocalContextStore.new)
+        @key = "chronos_context_#{object_id}".to_sym
+        @fallback = fallback
+      end
+
+      def get
+        supported? ? (Fiber[@key] || {}) : @fallback.get
+      end
+
+      def set(context)
+        raise ArgumentError, "context must be a Hash" unless context.is_a?(Hash)
+
+        supported? ? Fiber[@key] = context : @fallback.set(context)
+      end
+
+      def clear
+        supported? ? Fiber[@key] = nil : @fallback.clear
+        nil
+      end
+
+      def with_context(context)
+        previous = get
+        set(previous.merge(valid_context(context)))
+        yield
+      ensure
+        previous && !previous.empty? ? set(previous) : clear
+      end
+
+      private
+
+      def supported?
+        Fiber.respond_to?(:[]) && Fiber.respond_to?(:[]=)
+      end
+
+      def valid_context(context)
+        raise ArgumentError, "context must be a Hash" unless context.is_a?(Hash)
+
+        context
+      end
+    end
+  end
+end

data/lib/chronos/agent.rb

@@ -148,7 +148,8 @@ module Chronos
     end
 
     def external_http_integration_options
-      {:enabled => @config.external_http_enabled, :trace_headers => @config.external_http_trace_headers}
+      {:enabled => @config.external_http_enabled, :trace_headers => @config.external_http_trace_headers,
+       :w3c_trace_context => @config.w3c_trace_context}
     end
 
     def cache_integration_options
@@ -165,6 +166,10 @@ module Chronos
         "request_id" => nested["request_id"] || nested[:request_id] ||
                         request["request_id"] || request[:request_id]
       }
+      if @config.opentelemetry_bridge
+        otel = Integrations::OpenTelemetry.current_context
+        values = otel.merge(values.delete_if { |_key, value| value.to_s.empty? })
+      end
       values.delete_if { |_key, value| value.to_s.empty? }
     rescue StandardError
       {}
@@ -237,6 +242,7 @@ module Chronos
 
     def build_context_store(strategy)
       return Adapters::ThreadLocalContextStore.new if strategy == :thread_local
+      return Adapters::FiberLocalContextStore.new if strategy == :fiber_local
 
       strategy
     end

data/lib/chronos/configuration/apm_validation.rb

@@ -110,6 +110,8 @@ module Chronos
         errors = []
         errors << "external_http_enabled must be true or false" unless boolean?(external_http_enabled)
         errors << "external_http_trace_headers must be true or false" unless boolean?(external_http_trace_headers)
+        errors << "w3c_trace_context must be true or false" unless boolean?(w3c_trace_context)
+        errors << "opentelemetry_bridge must be true or false" unless boolean?(opentelemetry_bridge)
         errors << "cache_key_mode must be :none or :sha256" unless [:none, :sha256].include?(cache_key_mode)
         errors << "dependency_reporting must be true or false" unless boolean?(dependency_reporting)
         unless dependency_max_items.is_a?(Integer) && dependency_max_items >= 1 && dependency_max_items <= 200

data/lib/chronos/configuration/validation.rb

@@ -67,8 +67,8 @@ module Chronos
 
       def context_errors
         errors = []
-        unless context_store == :thread_local || compatible_context_store?
-          errors << "context_store must be :thread_local or implement get, set, clear, and with_context"
+        unless [:thread_local, :fiber_local].include?(context_store) || compatible_context_store?
+          errors << "context_store must be :thread_local, :fiber_local, or implement get, set, clear, and with_context"
         end
         errors << "breadcrumb_capacity must be a positive integer" unless positive_integer?(breadcrumb_capacity)
         unless breadcrumb_max_bytes.is_a?(Integer) && breadcrumb_max_bytes >= 128

data/lib/chronos/configuration.rb

@@ -54,6 +54,7 @@ module Chronos
       :apm_query_inspection_min_duration_ms, :apm_query_inspection_max_queries,
       :apm_transaction_tracking_enabled, :apm_transaction_max_connections,
       :external_http_enabled, :external_http_trace_headers,
+      :w3c_trace_context, :opentelemetry_bridge,
       :cache_key_mode, :dependency_reporting, :dependency_max_items
     ].freeze
 
@@ -123,7 +124,7 @@ module Chronos
       @user_agent = "chronos-ruby/#{Chronos::VERSION}"
       @max_payload_size = 1_048_576
       @gzip = false
-      @context_store = :thread_local
+      @context_store = :fiber_local
       @breadcrumb_capacity = 20
       @breadcrumb_max_bytes = 2048
     end
@@ -167,6 +168,8 @@ module Chronos
     def initialize_observability_defaults
       @external_http_enabled = false
       @external_http_trace_headers = true
+      @w3c_trace_context = false
+      @opentelemetry_bridge = true
       @cache_key_mode = :none
       @dependency_reporting = true
       @dependency_max_items = 100

data/lib/chronos/core/trace_context.rb

@@ -0,0 +1,38 @@
+module Chronos
+  module Core
+    # Parses and formats the W3C Trace Context headers without an OpenTelemetry dependency.
+    module TraceContext
+      TRACEPARENT = /\A([\da-f]{2})-([\da-f]{32})-([\da-f]{16})-([\da-f]{2})\z/.freeze
+
+      module_function
+
+      def parse(value)
+        match = TRACEPARENT.match(value.to_s.downcase)
+        return {} unless match && match[1] == "00"
+        return {} if match[2] == ("0" * 32) || match[3] == ("0" * 16)
+
+        {"trace_id" => match[2], "span_id" => match[3], "trace_flags" => match[4]}
+      rescue StandardError
+        {}
+      end
+
+      def format(context)
+        trace_id = value(context, "trace_id")
+        span_id = value(context, "span_id")
+        flags = value(context, "trace_flags")
+        return nil unless trace_id =~ /\A[\da-f]{32}\z/ && span_id =~ /\A[\da-f]{16}\z/
+        return nil if trace_id == ("0" * 32) || span_id == ("0" * 16)
+
+        "00-#{trace_id}-#{span_id}-#{flags =~ /\A[\da-f]{2}\z/ ? flags : '01'}"
+      rescue StandardError
+        nil
+      end
+
+      def value(context, key)
+        return "" unless context.is_a?(Hash)
+
+        (context[key] || context[key.to_sym]).to_s.downcase
+      end
+    end
+  end
+end

data/lib/chronos/integrations/active_job.rb

@@ -40,7 +40,7 @@ module Chronos
         def envelope(notifier)
           source = notifier.respond_to?(:propagation_context) ? notifier.propagation_context : {}
           source = {} unless source.is_a?(Hash)
-          context = %w(trace_id request_id).each_with_object({}) do |key, result|
+          context = %w(trace_id span_id trace_flags request_id).each_with_object({}) do |key, result|
             value = source[key] || source[key.to_sym]
             result[key] = bounded(value) unless value.to_s.empty?
           end
@@ -57,7 +57,7 @@ module Chronos
           source = value["context"] || value[:context]
           return {} unless source.is_a?(Hash)
 
-          %w(trace_id request_id).each_with_object({}) do |key, result|
+          %w(trace_id span_id trace_flags request_id).each_with_object({}) do |key, result|
             candidate = source[key] || source[key.to_sym]
             result[key] = bounded(candidate) unless candidate.to_s.empty?
           end

data/lib/chronos/integrations/faraday.rb

@@ -0,0 +1,76 @@
+module Chronos
+  module Integrations
+    # Optional Faraday middleware for outbound timing and W3C propagation.
+    # @responsibility Instrument one explicit Faraday connection without global patches.
+    # @motivation Modern Rails applications commonly use Faraday for outbound HTTP.
+    # @limits It never reads paths, queries, headers other than trace fields, or bodies.
+    # @collaborators Faraday middleware stack, TraceContext, and Chronos facade.
+    # @thread_safety Calls retain request state in local variables.
+    # @compatibility Faraday 1.x and 2.x middleware contracts.
+    # @example builder.use Chronos::Integrations::FaradayMiddleware
+    # @errors Original client exceptions are recorded by class and re-raised.
+    # @performance Two clock reads and one bounded asynchronous event per request.
+    class FaradayMiddleware
+      def initialize(app, options = {})
+        @app = app
+        @notifier = options[:notifier] || Chronos
+        @clock = options[:clock] || proc { Process.clock_gettime(Process::CLOCK_MONOTONIC) }
+      end
+
+      def call(environment)
+        started_at = @clock.call
+        inject_headers(environment)
+        response = @app.call(environment)
+        if response.respond_to?(:on_complete)
+          response.on_complete { |completed| record(completed, started_at, nil) }
+        else
+          record(environment, started_at, nil)
+        end
+        response
+      rescue StandardError => error
+        record(environment, started_at, error) if started_at
+        raise
+      end
+
+      private
+
+      def inject_headers(environment)
+        options = integration_options
+        return unless options[:trace_headers] && environment.respond_to?(:request_headers)
+
+        context = @notifier.respond_to?(:propagation_context) ? @notifier.propagation_context : {}
+        headers = environment.request_headers
+        traceparent = Core::TraceContext.format(context) if options[:w3c_trace_context]
+        headers["traceparent"] ||= traceparent if traceparent
+        headers["X-Chronos-Trace-ID"] ||= context["trace_id"] if context["trace_id"]
+        headers["X-Chronos-Request-ID"] ||= context["request_id"] if context["request_id"]
+      rescue StandardError
+        nil
+      end
+
+      def record(environment, started_at, error)
+        url = environment.url if environment.respond_to?(:url)
+        payload = {
+          "host" => (url.host.to_s if url && url.respond_to?(:host)),
+          "method" => (environment.method.to_s.upcase if environment.respond_to?(:method)),
+          "status" => (environment.status.to_i if environment.respond_to?(:status) && environment.status),
+          "duration_ms" => ((@clock.call - started_at) * 1000.0).round(3),
+          "error_class" => (error.class.name.to_s if error)
+        }
+        payload.delete_if { |_key, value| value.nil? || value == "" }
+        @notifier.record_event("external_http", payload)
+      rescue StandardError
+        false
+      end
+
+      def integration_options
+        return {:enabled => true, :trace_headers => true, :w3c_trace_context => false} unless
+          @notifier.respond_to?(:external_http_integration_options)
+
+        @notifier.external_http_integration_options
+      rescue StandardError
+        {:enabled => false, :trace_headers => false, :w3c_trace_context => false}
+      end
+    end
+  end
+end

data/lib/chronos/integrations/net_http.rb

@@ -53,7 +53,8 @@ module Chronos
           {
             :notifier => notifier,
             :clock => options[:clock] || proc { monotonic_time },
-            :trace_headers => configured.fetch(:trace_headers, true)
+            :trace_headers => configured.fetch(:trace_headers, true),
+            :w3c_trace_context => configured.fetch(:w3c_trace_context, false)
           }
         end
 
@@ -106,6 +107,9 @@ module Chronos
                     end
           set_header(request, "X-Chronos-Trace-ID", context["trace_id"] || context[:trace_id])
           set_header(request, "X-Chronos-Request-ID", context["request_id"] || context[:request_id])
+          if options[:w3c_trace_context]
+            set_header(request, "traceparent", Core::TraceContext.format(context))
+          end
         rescue StandardError
           nil
         end

data/lib/chronos/integrations/opentelemetry.rb

@@ -0,0 +1,44 @@
+module Chronos
+  module Integrations
+    # Optional, dependency-free bridge to an already configured OpenTelemetry SDK.
+    module OpenTelemetry
+      module_function
+
+      def current_context
+        return {} unless defined?(::OpenTelemetry::Trace) && ::OpenTelemetry::Trace.respond_to?(:current_span)
+
+        span = ::OpenTelemetry::Trace.current_span
+        context = span.context if span && span.respond_to?(:context)
+        return {} unless context && (!context.respond_to?(:valid?) || context.valid?)
+
+        trace_id = hex_identifier(context, :hex_trace_id, :trace_id, 32)
+        span_id = hex_identifier(context, :hex_span_id, :span_id, 16)
+        return {} if trace_id.empty? || span_id.empty?
+
+        {"trace_id" => trace_id, "span_id" => span_id,
+         "trace_flags" => sampled?(context) ? "01" : "00", "source" => "opentelemetry"}
+      rescue StandardError
+        {}
+      end
+
+      def active?
+        !current_context.empty?
+      end
+
+      def hex_identifier(context, hex_method, numeric_method, width)
+        value = context.public_send(hex_method) if context.respond_to?(hex_method)
+        value ||= context.public_send(numeric_method).to_i.to_s(16) if context.respond_to?(numeric_method)
+        value.to_s.downcase.rjust(width, "0")[-width, width]
+      rescue StandardError
+        ""
+      end
+
+      def sampled?(context)
+        flags = context.trace_flags if context.respond_to?(:trace_flags)
+        flags.respond_to?(:sampled?) ? flags.sampled? : flags.to_i.odd?
+      rescue StandardError
+        false
+      end
+    end
+  end
+end

data/lib/chronos/integrations/rack/middleware.rb

@@ -62,7 +62,7 @@ module Chronos
         def request_capture_context(env)
           request = request_values(env)
           {
-            :context => {"request" => request, "trace_id" => trace_id(env)},
+            :context => trace_context(env).merge("request" => request),
             :parameters => parameters(env),
             :user => hash_value(env["chronos.user"])
           }
@@ -124,7 +124,13 @@ module Chronos
         end
 
         def trace_id(env)
-          env["chronos.trace_id"] || SecureRandom.uuid
+          trace_context(env)["trace_id"]
+        end
+
+        def trace_context(env)
+          parsed = Core::TraceContext.parse(env["HTTP_TRACEPARENT"])
+          parsed["trace_id"] = env["chronos.trace_id"] || SecureRandom.hex(16) if parsed.empty?
+          parsed
         end
 
         def response_size(headers)

data/lib/chronos/integrations/sidekiq.rb

@@ -110,7 +110,7 @@ module Chronos
           source = @notifier.propagation_context
           return {} unless source.is_a?(Hash)
 
-          %w(trace_id request_id).each_with_object({}) do |key, result|
+          %w(trace_id span_id trace_flags request_id).each_with_object({}) do |key, result|
             value = source[key] || source[key.to_sym]
             result[key] = value.to_s unless value.to_s.empty?
           end

data/lib/chronos/rails/error_reporter_subscriber.rb

@@ -0,0 +1,39 @@
+module Chronos
+  module Rails
+    # Sends exceptions observed by the Rails 7 error reporter to Chronos once.
+    # @responsibility Translate the public Rails reporter callback into one notice.
+    # @motivation Rails can report handled errors that never reach Rack middleware.
+    # @limits Only handled, severity, source, and one bounded component are retained.
+    # @collaborators ActiveSupport::ErrorReporter and Chronos facade.
+    # @thread_safety Instances contain only an immutable notifier reference.
+    # @compatibility Rails 7 public error reporter subscriber API.
+    # @example Rails.error.subscribe(ErrorReporterSubscriber.new)
+    # @errors Agent and context failures are contained and return false.
+    # @performance Allocates one small allowlisted metadata hash per report.
+    class ErrorReporterSubscriber
+      def initialize(notifier = Chronos)
+        @notifier = notifier
+      end
+
+      def report(error, handled:, severity:, context:, source: nil)
+        details = {
+          :context => {"rails_error_reporter" => {
+            "handled" => handled == true, "severity" => severity.to_s, "source" => source.to_s
+          }}
+        }
+        details[:context]["rails_error_reporter"]["component"] = component(context)
+        @notifier.notify_once(error, details)
+      rescue StandardError
+        false
+      end
+
+      private
+
+      def component(context)
+        return "" unless context.is_a?(Hash)
+
+        (context[:controller] || context["controller"] || context[:job] || context["job"]).to_s[0, 128]
+      end
+    end
+  end
+end

data/lib/chronos/rails/installer.rb

@@ -34,6 +34,7 @@ module Chronos
 
           install_middleware(application, options)
           install_active_job
+          install_error_reporter
           @subscriber.install
           self.class.applications[application.object_id] = true
         end
@@ -65,6 +66,18 @@ module Chronos
         Chronos::Integrations::ActiveJob.install(::ActiveJob::Base, @notifier)
       end
 
+      def install_error_reporter
+        return false unless defined?(::Rails) && ::Rails.respond_to?(:error)
+
+        reporter = ::Rails.error
+        return false unless reporter && reporter.respond_to?(:subscribe)
+
+        reporter.subscribe(ErrorReporterSubscriber.new(@notifier))
+        true
+      rescue StandardError
+        false
+      end
+
       def environment
         defined?(::Rails) && ::Rails.respond_to?(:env) ? ::Rails.env.to_s : nil
       end

data/lib/chronos/rails/notifications_subscriber.rb

@@ -17,6 +17,7 @@ module Chronos
         process_action.action_controller render_template.action_view sql.active_record
         deliver.action_mailer perform.active_job cache_read.active_support
         cache_write.active_support cache_fetch_hit.active_support
+        perform_action.action_cable transmit.action_cable broadcast.action_cable
       ).freeze
 
       @mutex = Mutex.new
@@ -105,6 +106,8 @@ module Chronos
         when "sql.active_record" then sql(payload, duration)
         when "deliver.action_mailer" then mailer(payload, duration)
         when "perform.active_job" then active_job(payload, duration)
+        when "perform_action.action_cable", "transmit.action_cable", "broadcast.action_cable"
+          action_cable(name, payload, duration)
         else cache(name, payload, duration)
         end
       end
@@ -345,6 +348,15 @@ module Chronos
         @notifier.record_event("cache", data)
       end
 
+      def action_cable(name, payload, duration)
+        data = {
+          "kind" => "action_cable", "operation" => name.split(".").first,
+          "channel" => safe_class_name(value(payload, :channel)),
+          "action" => value(payload, :action).to_s[0, 128], "duration_ms" => duration
+        }
+        @notifier.record_event("request", data)
+      end
+
       def capture_controller_exception(payload)
         exception = value(payload, :exception_object)
         details = value(payload, :exception)

data/lib/chronos/rails.rb

@@ -1,6 +1,7 @@
 require "chronos"
 require "chronos/rails/active_record_query_inspector"
 require "chronos/rails/notifications_subscriber"
+require "chronos/rails/error_reporter_subscriber"
 require "chronos/integrations/active_job"
 require "chronos/rails/installer"
 

data/lib/chronos/version.rb

@@ -1,4 +1,4 @@
 module Chronos
-  # Current version of the legacy Chronos Ruby agent.
-  VERSION = "1.1.0".freeze
+  # Current version of the transitional Chronos Ruby agent.
+  VERSION = "1.2.0.pre.1".freeze
 end

data/lib/chronos.rb

@@ -16,6 +16,7 @@ require "chronos/core/sensitive_value_filter"
 require "chronos/core/sanitizer"
 require "chronos/core/safe_serializer"
 require "chronos/core/correlation_context"
+require "chronos/core/trace_context"
 require "chronos/core/deploy_normalizer"
 require "chronos/core/payload_serializer"
 require "chronos/core/telemetry_event"
@@ -32,6 +33,7 @@ require "chronos/internal/memory_backlog"
 require "chronos/internal/worker_pool"
 require "chronos/adapters/net_http_transport"
 require "chronos/adapters/thread_local_context_store"
+require "chronos/adapters/fiber_local_context_store"
 require "chronos/core/breadcrumb"
 require "chronos/application/retry_policy"
 require "chronos/application/circuit_breaker"
@@ -49,6 +51,8 @@ require "chronos/observability_facade"
 require "chronos/integrations"
 require "chronos/integrations/rack"
 require "chronos/integrations/rack/middleware"
+require "chronos/integrations/opentelemetry"
+require "chronos/integrations/faraday"
 
 # Framework-independent public facade for the Chronos Ruby agent.
 #

metadata

@@ -1,93 +1,91 @@
 --- !ruby/object:Gem::Specification
 name: chronos-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0.pre.1
 platform: ruby
 authors:
 - Antonio Jefferson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-05 00:00:00.000000000 Z
+date: 2026-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '12.3'
-    - - ">="
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 12.3.3
+        version: '14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '12.3'
-    - - ">="
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 12.3.3
+        version: '14'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.10'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.49.0
+        version: 1.57.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.49.0
-- !ruby/object:Gem::Dependency
-  name: parallel
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.19.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.19.2
-description: Base do cliente Chronos para excecoes, telemetria e observabilidade em
-  aplicacoes Ruby legadas.
+        version: 1.57.0
+description: Cliente Chronos para excecoes, telemetria e observabilidade em aplicacoes
+  Ruby e Rails.
 email:
 - antoniojeferson96@gmail.com
 executables: []
@@ -171,6 +169,7 @@ files:
 - docs/troubleshooting.md
 - lib/chronos.rb
 - lib/chronos/adapters.rb
+- lib/chronos/adapters/fiber_local_context_store.rb
 - lib/chronos/adapters/net_http_transport.rb
 - lib/chronos/adapters/thread_local_context_store.rb
 - lib/chronos/agent.rb
@@ -210,12 +209,15 @@ files:
 - lib/chronos/core/sql_normalizer.rb
 - lib/chronos/core/sql_query_analyzer.rb
 - lib/chronos/core/telemetry_event.rb
+- lib/chronos/core/trace_context.rb
 - lib/chronos/errors.rb
 - lib/chronos/integrations.rb
 - lib/chronos/integrations/active_job.rb
 - lib/chronos/integrations/capistrano.rb
+- lib/chronos/integrations/faraday.rb
 - lib/chronos/integrations/job_payload.rb
 - lib/chronos/integrations/net_http.rb
+- lib/chronos/integrations/opentelemetry.rb
 - lib/chronos/integrations/rack.rb
 - lib/chronos/integrations/rack/middleware.rb
 - lib/chronos/integrations/sidekiq.rb
@@ -232,6 +234,7 @@ files:
 - lib/chronos/ports/transport.rb
 - lib/chronos/rails.rb
 - lib/chronos/rails/active_record_query_inspector.rb
+- lib/chronos/rails/error_reporter_subscriber.rb
 - lib/chronos/rails/installer.rb
 - lib/chronos/rails/notifications_subscriber.rb
 - lib/chronos/rails/railtie.rb
@@ -258,15 +261,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.2.10
+      version: '2.7'
   - - "<"
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.4.22
 signing_key: