chronos-ruby 1.1.3 → 1.2.0.pre.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 348e3ca2ba28d8d97f80281bf0ffb545b013dfac248d7f14527f5d955513d7a2
-  data.tar.gz: 44e7047ef9d47aac49f5a22e416447aa82efd3944a93eabd61eb36fa74d3fb2b
+  metadata.gz: c13c2858edcb41d4b2a0bfc83049349ee13a5a9ecee873798750b4bf9f1da48c
+  data.tar.gz: a21babcc28ce763e7d867f35064735d661214724c1ed9d256e8d174a1a04c5dc
 SHA512:
-  metadata.gz: 2b4b15808ff7363b470d0c4348fc0a338f4c2ea3eb4112db5b5d6e9c1437315ea57f7ac70f84e7618ea2f120e9210425c31041b328cdc9940c2ebc8593f4a2f3
-  data.tar.gz: 92a4bdf9041d68747c5c139061f9000f9526ac26ba9b1b913d73fb1413dd4492764bbb700067e7ffdec7610ebf4e16d671b49792c05e2e694664ca97b72b6e99
+  metadata.gz: 81ab0672785236e1ffaeecf0fbb5ae3187f319be349a06f724eee50dd0d20963afb74a84485267e8ea5e3a7dd37dacef15ab456783fee622bef901110b98344a
+  data.tar.gz: 835ee551ddcec646a44376dcdfc09748e12c0fa360fee62365455e6776503a0597baed504a33276059853e652f5a90458ad7ae43bb582f7647303af9940a5d1f

data/CHANGELOG.md

@@ -4,40 +4,23 @@ All notable changes are documented here. The project follows Semantic Versioning
 
 ## [Unreleased]
 
-## [1.1.3] - 2026-08-13
+## [1.2.0.pre.1] - 2026-08-11
 
-### Changed
-
-- expanded the gem summary and description to clarify its exception, metrics, and telemetry monitoring purpose;
-- highlighted https://chronosmonitor.com.br as the official Chronos Monitor platform for receiving and visualizing observability data;
-- synchronized stable legacy release references and installation examples with version `1.1.3`.
+### Added
 
-## [1.1.2] - 2026-08-13
+- 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 generated Rails initializer now exposes only common application-facing options with safe environment overrides;
-- the official Chronos endpoint remains an internal default and is no longer assigned in generated initializers;
-- Rails derives the service name from the application namespace when `CHRONOS_SERVICE_NAME` is absent;
-- Rails applications automatically install the optional Sidekiq 4/5 client and server middleware when Sidekiq is available.
-
-### Fixed
-
-- configuration snapshots no longer freeze the Rails-owned logger, preventing later logger extensions from raising `FrozenError`;
-- logger lookup and optional Sidekiq installation failures are contained so they cannot abort Rails boot.
+- 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
 
-- `CHRONOS_SSL_VERIFY` remains enabled by default and unknown Boolean values retain the secure default;
-- generated Boolean overrides accept only explicit `1/0`, `true/false`, `yes/no`, and `on/off` forms.
-
-## [1.1.1] - 2026-08-11
-
-### Changed
-
-- the Rails install generator now writes every public configuration option with explanatory English comments;
-- the official `https://chronosmonitor.com.br` endpoint is now the default host when applications omit `config.host`;
-- generated initializers no longer read `CHRONOS_HOST`, while explicit `config.host` assignments remain supported.
+- 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
 

data/README.md

@@ -1,6 +1,6 @@
 # Chronos Ruby
 
-Chronos Ruby 1.1.3 é o agente independente de framework para enviar exceções e telemetria limitada de aplicações Ruby ao Chronos. Esta é a linha estável legado, compatível com o protocolo v1 e voltada a Ruby 2.2.10–2.6.
+Chronos Ruby 1.1.0 é o agente independente de framework para enviar exceções e telemetria limitada de aplicações Ruby ao Chronos. Esta é a linha estável legado, compatível com o protocolo v1 e voltada a Ruby 2.2.10–2.6.
 
 ## O que a gem coleta
 
@@ -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.3 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).
 
@@ -33,7 +33,7 @@ Rubies e frameworks antigos estão fora do suporte de segurança de seus mantene
 Obrigatório: adicione a versão estável ao `Gemfile`.
 
 ```ruby
-gem "chronos-ruby", "~> 1.1.3"
+gem "chronos-ruby", "~> 1.1.0"
 ```
 
 Em runtimes antigos, use Bundler compatível:
@@ -46,7 +46,7 @@ bundle _1.17.3_ install
 Sem Bundler:
 
 ```bash
-gem install chronos-ruby -v 1.1.3
+gem install chronos-ruby -v 1.1.0
 ```
 
 ## Instalação em Rails
@@ -54,7 +54,7 @@ gem install chronos-ruby -v 1.1.3
 Obrigatório: carregue a integração Rails explicitamente para manter Rails/ActiveSupport fora de aplicações Ruby puras.
 
 ```ruby
-gem "chronos-ruby", "~> 1.1.3", :require => "chronos/rails"
+gem "chronos-ruby", "~> 1.1.0", :require => "chronos/rails"
 ```
 
 Gere o initializer:
@@ -67,8 +67,7 @@ A Versão 0.5 introduziu Railtie, middleware e subscribers idempotentes por APIs
 
 ## Configuração mínima
 
-Obrigatório quando o agente está habilitado: `project_id` e `project_key`. O `host` usa
-`https://chronosmonitor.com.br` por padrão. Recomendado: definir ambiente e serviço explicitamente.
+Obrigatório quando o agente está habilitado: `project_id`, `project_key` e `host` HTTPS. Recomendado: definir ambiente e serviço explicitamente.
 
 ```ruby
 require "chronos"
@@ -76,6 +75,7 @@ require "chronos"
 Chronos.configure do |config|
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
+  config.host = "https://chronos.example.com"
   config.environment = ENV["APP_ENV"] || "production"
   config.service_name = "billing"
   config.app_version = ENV["APP_VERSION"]
@@ -204,16 +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. Em Rails, a versão 1.1.3 detecta Sidekiq e instala automaticamente os middlewares de cliente e servidor:
+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.3", :require => "chronos/rails"
+gem "chronos-ruby", "~> 1.1.0", :require => "chronos/sidekiq"
 ```
 
-Aplicações Ruby sem Rails continuam usando `require "chronos/sidekiq"` explicitamente.
-
-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
 
@@ -263,6 +263,7 @@ A gem não varre o ambiente. Leia somente variáveis escolhidas pela aplicação
 Chronos.configure do |config|
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
+  config.host = ENV["CHRONOS_HOST"]
   config.environment = ENV["APP_ENV"] || "production"
   config.enabled = ENV["CHRONOS_ENABLED"] != "false"
   config.queue_size = 100
@@ -320,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. Version 1.1.3 evidence is recorded in [Version 1.1.3 readiness](release-1.1.3-readiness.md); historical evidence remains in [Version 1.1.2 readiness](release-1.1.2-readiness.md), [Version 1.0 readiness](release-1.0-readiness.md), and [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

@@ -6,7 +6,7 @@
 |---|---:|---|---|
 | `project_id` | Yes when enabled | `nil` | Public project identifier included in the envelope |
 | `project_key` | Yes when enabled | `nil` | Secret authentication key sent only as an HTTP header |
-| `host` | Optional | `https://chronosmonitor.com.br` | Absolute Chronos HTTP endpoint; HTTPS is required by default |
+| `host` | Yes when enabled | `nil` | Absolute Chronos HTTP endpoint; HTTPS is required by default |
 | `environment` | Recommended | `production` | Application environment |
 | `app_version` | Optional | `nil` | Application release/version identifier |
 | `service_name` | Recommended | `nil` | Logical service name |
@@ -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/docs/modules/rails-legacy.md

@@ -16,7 +16,7 @@ Run:
 rails generate chronos:install
 ```
 
-The generator creates `config/initializers/chronos.rb`. The concise template reads only explicitly named `CHRONOS_*` variables, uses documented safe defaults, derives the service name from the Rails application namespace, adopts `Rails.logger` without freezing it, and disables automatic integration in test and console by default. It invokes the idempotent installer as a fallback for applications that disabled Bundler auto-require, so the Railtie and initializer paths cannot create duplicate hooks. When Sidekiq is available, the installer also activates its existing optional client and server middleware. It never scans all environment variables or modifies routes and application classes.
+The generator creates `config/initializers/chronos.rb`. The template reads only explicitly named `CHRONOS_*` variables, uses `Rails.env`, adopts `Rails.logger` when available, and disables automatic integration in test and console by default. It invokes the idempotent installer as a fallback for applications that disabled Bundler auto-require, so the Railtie and initializer paths cannot create duplicate hooks. It never scans all environment variables or modifies routes and application classes.
 
 ## Captured integrations
 
@@ -57,4 +57,4 @@ The repository contains independent applications under `examples/rails-4.2` and
 
 ## Limits
 
-Version 0.7 aggregates controller, SQL, and job timings into bounded APM batches. SQL literals and binds remain excluded while a bounded normalized query and fingerprint are produced. Sidekiq remains an optional dependency but is installed automatically when present in Rails. Version `0.9.0.pre.2` provides bounded Active Job trace/request propagation through a namespaced serialized field; adapters that replace the standard Active Job serialization/execution hooks require separate compatibility evidence.
+Version 0.7 aggregates controller, SQL, and job timings into bounded APM batches. SQL literals and binds remain excluded while a bounded normalized query and fingerprint are produced. Sidekiq support remains a separate optional integration. Version `0.9.0.pre.2` provides bounded Active Job trace/request propagation through a namespaced serialized field; adapters that replace the standard Active Job serialization/execution hooks require separate compatibility evidence.

data/docs/modules/sidekiq-legacy.md

@@ -1,13 +1,13 @@
 # Sidekiq 4/5 legacy integration
 
-Version `0.6.0.pre.1` starts the legacy jobs line with optional Sidekiq 4 and 5 client and server middleware. Version `1.1.3` installs it automatically when Sidekiq is available in a Rails application:
+Version `0.6.0.pre.1` starts the legacy jobs line with optional Sidekiq 4 and 5 client and server middleware. Load it after declaring Sidekiq:
 
 ```ruby
 gem "sidekiq", "~> 5.0"
-gem "chronos-ruby", "~> 1.1.3", :require => "chronos/rails"
+gem "chronos-ruby", "~> 1.1.0", :require => "chronos/sidekiq"
 ```
 
-Plain Ruby applications continue to use `require "chronos/sidekiq"` explicitly. Both entry points install middleware through the public `configure_client` and `configure_server` APIs. They do nothing when Sidekiq is unavailable, and the framework-independent core never requires Sidekiq. Installation adds no Chronos thread or Redis/database connection per job; delivery continues through the agent's existing fixed worker pool.
+`chronos/sidekiq` installs middleware through the public `configure_client` and `configure_server` APIs. It does nothing when Sidekiq is unavailable, and the core gem never requires Sidekiq. Installation adds no Chronos thread or Redis/database connection per job; delivery continues through the agent's existing fixed worker pool.
 
 The client middleware adds a top-level `chronos` metadata object to the Sidekiq envelope. It never changes the public `args` array. Only `trace_id` and `request_id` propagate, with schema version and enqueue time. The server scopes that context for the worker, measures duration and calculable queue latency, and emits one `job` event.
 

data/docs/troubleshooting.md

@@ -56,7 +56,7 @@ Require `chronos/capistrano` after the Capistrano/Rake task DSL is loaded. The i
 
 ## Sidekiq telemetry is missing
 
-In Rails, require `chronos/rails` and configure Chronos before jobs run; version 1.1.3 detects Sidekiq and installs its public client/server middleware automatically. In plain Ruby, require `chronos/sidekiq` explicitly after Sidekiq is available. Sidekiq remains optional in both cases. A job already enqueued before client middleware installation may lack propagated trace context, but server timing and failure capture can still run.
+Require `chronos/sidekiq` after Sidekiq is available and configure Chronos before jobs run. The entry point uses Sidekiq's public client/server middleware configuration and remains optional. Requiring only `chronos` or `chronos/rails` does not load Sidekiq. A job already enqueued before client middleware installation may lack propagated trace context, but server timing and failure capture can still run.
 
 ## A failed Sidekiq job appears twice
 

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/snapshot.rb

@@ -3,7 +3,7 @@ module Chronos
   #
   # @responsibility Expose validated settings without mutable containers.
   # @motivation Keep capture behavior stable while multiple threads run.
-  # @limits Snapshot values cannot be edited; the host application's logger remains externally owned.
+  # @limits It cannot be edited after creation.
   # @collaborators Configuration and runtime services.
   # @thread_safety Safe to share between threads after construction.
   # @compatibility Ruby 2.2.10 through Ruby 2.6.
@@ -17,7 +17,7 @@ module Chronos
     def initialize(values)
       Configuration::ATTRIBUTES.each do |attribute|
         value = values[attribute]
-        deep_freeze(value) unless attribute == :logger
+        deep_freeze(value)
         instance_variable_set("@#{attribute}", value)
       end
       freeze

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

@@ -23,7 +23,6 @@ module Chronos
   class Configuration
     include Internal::ConfigurationValidation
     include Internal::ApmConfigurationValidation
-    DEFAULT_HOST = "https://chronosmonitor.com.br".freeze
     DEFAULT_BLOCKLIST_KEYS = %w(
       password password_confirmation passwd secret api_key apikey authorization
       token access_token refresh_token private_key client_secret cookie set-cookie
@@ -55,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
 
@@ -106,7 +106,7 @@ module Chronos
     def initialize_core_defaults
       @project_id = nil
       @project_key = nil
-      @host = DEFAULT_HOST
+      @host = nil
       @environment = "production"
       @app_version = nil
       @service_name = nil
@@ -124,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
@@ -168,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