chronos-ruby 1.2.0.pre.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c13c2858edcb41d4b2a0bfc83049349ee13a5a9ecee873798750b4bf9f1da48c
-  data.tar.gz: a21babcc28ce763e7d867f35064735d661214724c1ed9d256e8d174a1a04c5dc
+  metadata.gz: 77021c8f603c5908e1e31bb85824a1dcadb6b73917492f51e617128a81170157
+  data.tar.gz: af6c9e930a0c6ea86154c9cfb89b60e2dd6920d934d2afca611a2d129496fa3e
 SHA512:
-  metadata.gz: 81ab0672785236e1ffaeecf0fbb5ae3187f319be349a06f724eee50dd0d20963afb74a84485267e8ea5e3a7dd37dacef15ab456783fee622bef901110b98344a
-  data.tar.gz: 835ee551ddcec646a44376dcdfc09748e12c0fa360fee62365455e6776503a0597baed504a33276059853e652f5a90458ad7ae43bb582f7647303af9940a5d1f
+  metadata.gz: f2b69c2ef1d1acaaf1e6ded9182e2daeb78549b71ae48e06b0e982fe79d41655f6c4d5c44a0736f683cdb476a90558d5df2561e2f090013e235d4a3ccc1eeddd
+  data.tar.gz: 4989786700879e83e42fb70b9bdfec2e025271d0f97edf294d75e1c2138f40fb1e80e8a7477cadb4cd634fa3fb1c2e80295b7b47858444fad4903df2e831d918

data/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes are documented here. The project follows Semantic Versioning
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-08-12
+
+### Added
+
+- automatic Sidekiq client and server middleware installation when Sidekiq is available in a Rails application;
+- Rails application namespace discovery as the default service name when `CHRONOS_SERVICE_NAME` is absent;
+- environment-driven defaults for the most frequently customized Rails, transport, privacy, and APM settings in the generated initializer.
+
+### Changed
+
+- promoted the Ruby 2.7–3.4 transitional line from `1.2.0.pre.2` to the stable `1.2.0` release;
+- simplified the generated Rails initializer while retaining safe SDK defaults and explicit application overrides;
+- kept the official Chronos endpoint internal instead of exposing `config.host` in generated initializers;
+- Sidekiq telemetry now activates through the ordinary Rails integration without requiring `chronos/sidekiq` explicitly.
+
+### Fixed
+
+- configuration snapshots no longer freeze the Rails-owned logger, preventing `FrozenError` during later Rails 8 and dotenv logger initialization;
+- Rails logger lookup and optional Sidekiq installation remain contained so integration failures cannot abort application boot.
+
+### Security
+
+- boolean environment overrides accept only explicit true/false forms and fall back to documented safe defaults;
+- existing bounded payload, sanitization, trace validation, and optional OpenTelemetry behavior remain unchanged under protocol v1.
+
+## [1.2.0.pre.2] - 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, including when applications omit `config.host`;
+- generated initializers no longer read `CHRONOS_HOST`, while explicit `config.host` assignments remain supported.
+
 ## [1.2.0.pre.1] - 2026-08-11
 
 ### Added

data/README.md

@@ -1,6 +1,6 @@
 # Chronos Ruby
 
-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.
+Chronos Ruby 1.2.0 é o agente para enviar exceções, métricas e telemetria limitada de aplicações Ruby e Rails ao Chronos. Esta é a linha estável atual para Ruby 2.7–3.4, compatível com o protocolo v1.
 
 ## 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 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.
+A versão estável 1.2.0 atende 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, integração automática com Sidekiq em Rails e coexistência com um SDK OpenTelemetry já configurado. Combinações ainda classificadas como `Best effort` devem ser validadas pela aplicação antes da adoção em produção; 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,14 +33,14 @@ 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.0"
+gem "chronos-ruby", "~> 1.2.0"
 ```
 
-Em runtimes antigos, use Bundler compatível:
+Use Bundler 2 em um runtime suportado:
 
 ```bash
-gem install bundler -v 1.17.3
-bundle _1.17.3_ install
+gem install bundler -v "~> 2.4"
+bundle install
 ```
 
 Sem Bundler:
@@ -67,7 +67,8 @@ 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`, `project_key` e `host` HTTPS. Recomendado: definir ambiente e serviço explicitamente.
+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.
 
 ```ruby
 require "chronos"
@@ -75,7 +76,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.host = "https://chronosmonitor.com.br"
   config.environment = ENV["APP_ENV"] || "production"
   config.service_name = "billing"
   config.app_version = ENV["APP_VERSION"]
@@ -204,15 +205,18 @@ Por padrão, SQL bruto e binds não são lidos pelo pipeline de análise. A insp
 
 ## Sidekiq e Active Job
 
-A integração mantém o require explícito e suporta a API pública de middleware do Sidekiq 7:
+A integração Rails detecta o Sidekiq e instala automaticamente os middlewares de cliente e servidor. O carregamento
+explícito continua disponível para aplicações sem Rails 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"
+gem "chronos-ruby", "~> 1.1.0"
 ```
 
+Em uma aplicação Ruby sem Rails, use `require "chronos/sidekiq"`.
+
 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
@@ -304,21 +308,20 @@ Migre por etapas e mantenha os dois agentes juntos somente durante a validação
 
 ## Desenvolvimento local
 
-Instale Bundler 1.17.3 e as dependências:
+Instale as dependências:
 
 ```bash
-gem install bundler -v 1.17.3
 bin/setup
 ```
 
-Use `bin/console` para inspeção e `bundle _1.17.3_ exec rake install` para instalar a fonte localmente. A arquitetura hexagonal está descrita em [Arquitetura](docs/architecture.md).
+Use `bin/console` para inspeção e `bundle exec rake install` para instalar a fonte localmente. A arquitetura hexagonal está descrita em [Arquitetura](docs/architecture.md).
 
 ## Testes
 
 Execute suíte e lint no runtime atual:
 
 ```bash
-bundle _1.17.3_ exec rake
+bundle exec rake
 ```
 
 A matriz CI cobre a linha transitional e os checks de pacote/documentação; workflows legados preservam evidência das releases anteriores.

data/docs/compatibility.md

@@ -1,6 +1,6 @@
 # Compatibility
 
-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.
+Chronos Ruby 1.2.0 is the current stable release of the transitional line for modern Ruby, Rails, and Sidekiq applications. Individual combinations remain `Best effort` until their dedicated CI and real-application gates pass; a stable package version does not by itself promote an unverified combination to `Supported`. 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
 
@@ -27,7 +27,7 @@ Chronos Ruby 1.2.0.pre.1 is the first candidate of the transitional line for Rai
 
 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.
 
-Historical evidence remains in [Version 1.0 readiness](release-1.0-readiness.md) and [Version 1.1 readiness](release-1.1-readiness.md).
+Release evidence is recorded in [Version 1.2 readiness](release-1.2-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` | Yes when enabled | `nil` | Absolute Chronos HTTP endpoint; HTTPS is required by default |
+| `host` | Optional | `https://chronosmonitor.com.br` | 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 |

data/docs/release-1.2-readiness.md

@@ -0,0 +1,33 @@
+# Version 1.2 release readiness
+
+Version `1.2.0` promotes the transitional Ruby 2.7–3.4 line to a stable package. It includes Rails 7 integration, Sidekiq 7 middleware, fiber-aware context, optional W3C Trace Context, Rails Error Reporter, Action Cable, Faraday, and coexistence with an application-managed OpenTelemetry SDK. The wire protocol remains `schema_version: "1.0"`.
+
+## Release gates
+
+The `v1.2.0` tag must match `Chronos::VERSION`. The release workflow blocks publishing until all of these jobs succeed:
+
+- the full RSpec and RuboCop suite on Ruby 2.7, 3.0, 3.1, 3.2, 3.3, and 3.4;
+- documentation and contract verification through `script/verify_docs`;
+- bounded query-analysis and comparative benchmarks;
+- the 500-event fake-endpoint delivery and privacy gate;
+- a second full suite run on the publishing runtime;
+- gem build, SHA-256 checksum, SPDX SBOM generation, and RubyGems Trusted Publishing.
+
+Local release preparation must additionally verify syntax, package contents, version consistency, and a clean generated initializer. Publication is performed only by the protected GitHub Actions environment; do not run `gem push` manually.
+
+## Compatibility claims
+
+A stable gem version and a supported framework/runtime pair are separate claims. Only combinations with complete CI and real-application evidence may be marked `Supported` in [compatibility](compatibility.md). Other intended combinations remain `Best effort` and should be validated in staging before production adoption.
+
+Legacy Ruby 2.2–2.6, Rails 4/5, and Sidekiq 4/5 applications must remain on a compatible 1.0/1.1 release. Version 1.2 requires Ruby `>= 2.7` and `< 3.5`.
+
+## Publishing
+
+After the final commit and all branch checks are green:
+
+```bash
+git tag v1.2.0
+git push origin v1.2.0
+```
+
+After Trusted Publishing completes, verify a clean install and run `chronos:verify_integration` against a non-production project before announcing the release as latest.

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 It cannot be edited after creation.
+  # @limits Snapshot values cannot be edited; the host application's logger remains externally owned.
   # @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)
+        deep_freeze(value) unless attribute == :logger
         instance_variable_set("@#{attribute}", value)
       end
       freeze

data/lib/chronos/configuration.rb

@@ -23,6 +23,7 @@ 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
@@ -106,7 +107,7 @@ module Chronos
     def initialize_core_defaults
       @project_id = nil
       @project_key = nil
-      @host = nil
+      @host = DEFAULT_HOST
       @environment = "production"
       @app_version = nil
       @service_name = nil

data/lib/chronos/rails/installer.rb

@@ -34,6 +34,7 @@ module Chronos
 
           install_middleware(application, options)
           install_active_job
+          install_sidekiq
           install_error_reporter
           @subscriber.install
           self.class.applications[application.object_id] = true
@@ -66,6 +67,24 @@ module Chronos
         Chronos::Integrations::ActiveJob.install(::ActiveJob::Base, @notifier)
       end
 
+      def install_sidekiq
+        library = sidekiq_library
+        return false unless library
+
+        Chronos::Integrations::Sidekiq.install(library, @notifier)
+      rescue StandardError
+        false
+      end
+
+      def sidekiq_library
+        return ::Sidekiq if defined?(::Sidekiq)
+
+        require "sidekiq"
+        ::Sidekiq if defined?(::Sidekiq)
+      rescue LoadError
+        nil
+      end
+
       def install_error_reporter
         return false unless defined?(::Rails) && ::Rails.respond_to?(:error)
 

data/lib/chronos/rails.rb

@@ -3,6 +3,7 @@ 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/integrations/sidekiq"
 require "chronos/rails/installer"
 
 require "chronos/rails/railtie" if defined?(::Rails::Railtie)
@@ -15,5 +16,16 @@ module Chronos
   # @limits Version 0.5 targets public APIs present in Rails 4.2 and 5.2.
   # @thread_safety Installation and subscriptions are protected against duplication.
   # @compatibility Rails 4.2 through Rails 5.2 with their supported legacy Rubies.
-  module Rails; end
+  module Rails
+    class << self
+      # Returns the namespace that owns the Rails application class.
+      def application_name(application = ::Rails.application)
+        class_name = application.class.name.to_s
+        name = class_name.sub(/::Application\z/, "")
+        name.empty? || name == class_name ? nil : name
+      rescue StandardError
+        nil
+      end
+    end
+  end
 end

data/lib/chronos/version.rb

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

data/lib/generators/chronos/install/templates/chronos.rb

@@ -1,20 +1,62 @@
 require "chronos/rails"
 
+# Common Chronos settings. Every environment variable is optional unless your
+# Chronos project requires it; omitted values fall back to safe SDK defaults.
+env_boolean = lambda do |name, default|
+  value = ENV[name]
+  normalized = value.to_s.downcase
+  next true if %w(1 true yes on).include?(normalized)
+  next false if %w(0 false no off).include?(normalized)
+
+  default
+end
+
 Chronos.configure do |config|
-  # Chronos reads only the environment variables explicitly selected here.
+  # Identification and authentication
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  config.host = ENV["CHRONOS_HOST"]
-  config.environment = Rails.env.to_s
-  config.service_name = ENV["CHRONOS_SERVICE_NAME"]
+  config.environment = ENV.fetch("CHRONOS_ENVIRONMENT", Rails.env.to_s)
+  config.service_name = ENV["CHRONOS_SERVICE_NAME"] || Chronos::Rails.application_name
   config.app_version = ENV["CHRONOS_APP_VERSION"]
-  config.logger = Rails.logger if Rails.respond_to?(:logger)
+  config.revision = ENV["CHRONOS_REVISION"]
+
+  # General behavior and transport
+  config.enabled = env_boolean.call("CHRONOS_ENABLED", true)
+  config.error_notifications = env_boolean.call("CHRONOS_ERROR_NOTIFICATIONS", true)
+  config.ssl_verify = env_boolean.call("CHRONOS_SSL_VERIFY", true)
+  config.timeout = ENV.fetch("CHRONOS_TIMEOUT", "5").to_f
+  config.open_timeout = ENV.fetch("CHRONOS_OPEN_TIMEOUT", "2").to_f
+  config.queue_size = ENV.fetch("CHRONOS_QUEUE_SIZE", "100").to_i
+  config.workers = ENV.fetch("CHRONOS_WORKERS", "1").to_i
+  config.sampling_rate = ENV.fetch("CHRONOS_SAMPLING_RATE", "1.0").to_f
+  config.ignored_environments = ENV.fetch("CHRONOS_IGNORED_ENVIRONMENTS", "")
+                                   .split(",").map(&:strip).reject(&:empty?)
+
+  # Rails integration and privacy
+  config.root_directory = Rails.root.to_s
+  config.rails_enabled = env_boolean.call("CHRONOS_RAILS_ENABLED", true)
+  config.rails_capture_in_console = env_boolean.call("CHRONOS_RAILS_CAPTURE_IN_CONSOLE", false)
+  config.rails_capture_in_test = env_boolean.call("CHRONOS_RAILS_CAPTURE_IN_TEST", false)
+  config.anonymize_ip = env_boolean.call("CHRONOS_ANONYMIZE_IP", true)
+
+  # Application performance monitoring
+  config.apm_enabled = env_boolean.call("CHRONOS_APM_ENABLED", true)
+  config.apm_slow_query_threshold_ms = ENV.fetch(
+    "CHRONOS_APM_SLOW_QUERY_THRESHOLD_MS", "500"
+  ).to_f
+  config.apm_long_transaction_threshold_ms = ENV.fetch(
+    "CHRONOS_APM_LONG_TRANSACTION_THRESHOLD_MS", "1000"
+  ).to_f
+  config.apm_n_plus_one_threshold = ENV.fetch("CHRONOS_APM_N_PLUS_ONE_THRESHOLD", "5").to_i
+  config.external_http_enabled = env_boolean.call("CHRONOS_EXTERNAL_HTTP_ENABLED", false)
 
-  # Safe legacy defaults: test and console integrations remain disabled.
-  config.rails_capture_in_test = false
-  config.rails_capture_in_console = false
-  config.rails_capture_user_agent = false
+  # Chronos keeps the shared Rails logger mutable and contains logger failures.
+  begin
+    config.logger = Rails.logger if Rails.respond_to?(:logger)
+  rescue StandardError
+    # Chronos safely continues without an application logger.
+  end
 end
 
-# Safe when the Railtie already ran or will run later; installation is idempotent.
+# Installation is idempotent, regardless of when the Railtie was evaluated.
 Chronos::Rails::Installer.new.install(Rails.application)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chronos-ruby
 version: !ruby/object:Gem::Version
-  version: 1.2.0.pre.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Antonio Jefferson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -164,6 +164,7 @@ files:
 - docs/protocol-v1.md
 - docs/release-1.0-readiness.md
 - docs/release-1.1-readiness.md
+- docs/release-1.2-readiness.md
 - docs/security-review.md
 - docs/semver.md
 - docs/troubleshooting.md
@@ -267,9 +268,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '3.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.4.22
 signing_key: