chronos-ruby 1.2.0.pre.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28ccfc363bc7f73eb18a10d36e0457d8697ffe52dae4f939fa81a4cbe6938609
-  data.tar.gz: ac5d64237250a9d9d1e26da86649698dd09eda1afb7a115fb87eb2edf6d3183b
+  metadata.gz: 77021c8f603c5908e1e31bb85824a1dcadb6b73917492f51e617128a81170157
+  data.tar.gz: af6c9e930a0c6ea86154c9cfb89b60e2dd6920d934d2afca611a2d129496fa3e
 SHA512:
-  metadata.gz: 58987b0079af3abcd99ee06f6c2739833719d95ae29ef7764997f37c01745f269521453d610a7bfd7b9081c26593590c469d58d52a502ab752668d1d1d2d4e19
-  data.tar.gz: ba3277ee0bbc7fd67186e605505659ae2db7a1add6cad35c08bcf30669b1e7140f5c004ad9ace8154d2a25a72af9d6938aacf2ac04ea0da4dd9924700b0c2df8
+  metadata.gz: f2b69c2ef1d1acaaf1e6ded9182e2daeb78549b71ae48e06b0e982fe79d41655f6c4d5c44a0736f683cdb476a90558d5df2561e2f090013e235d4a3ccc1eeddd
+  data.tar.gz: 4989786700879e83e42fb70b9bdfec2e025271d0f97edf294d75e1c2138f40fb1e80e8a7477cadb4cd634fa3fb1c2e80295b7b47858444fad4903df2e831d918

data/CHANGELOG.md

@@ -4,6 +4,31 @@ 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

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.2 continua 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:
@@ -205,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
@@ -305,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.2 is the current 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.2 is the current candidate of the transitional line for R
 
 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/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/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.2".freeze
+  VERSION = "1.2.0".freeze
 end

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

@@ -1,185 +1,61 @@
 require "chronos/rails"
 
-# This initializer lists every public Chronos option so the application's
-# monitoring behavior is explicit and can be reviewed in one place.
+# 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|
   # Identification and authentication
-
-  # Identifies the project that will receive monitoring events.
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
-  # Authenticates event delivery. Keep this value in a secret manager.
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  # Defines the Chronos Monitor endpoint used to deliver events.
-  config.host = "https://chronosmonitor.com.br"
-  # Labels events with the current Rails environment.
-  config.environment = Rails.env.to_s
-  # Identifies the deployed application version in events and releases.
+  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"]
-  # Distinguishes this application from other monitored services.
-  config.service_name = ENV["CHRONOS_SERVICE_NAME"]
-  # Records the source revision, such as a Git commit SHA.
   config.revision = ENV["CHRONOS_REVISION"]
-  # Associates events with a specific deployment.
-  config.deploy_id = ENV["CHRONOS_DEPLOY_ID"]
-  # Identifies the infrastructure region where the application is running.
-  config.region = ENV["CHRONOS_REGION"]
-  # Identifies the process, container, or host that produced an event.
-  config.instance_id = ENV["CHRONOS_INSTANCE_ID"]
-  # Removes the application root from file paths reported to Chronos.
-  config.root_directory = Rails.root.to_s
-  # Sends internal Chronos diagnostics through the Rails logger.
-  config.logger = Rails.logger if Rails.respond_to?(:logger)
-
-  # Transport and delivery
-
-  # Limits how long an established request may wait for the Chronos server.
-  config.timeout = 5
-  # Limits how long Chronos may wait while opening a network connection.
-  config.open_timeout = 2
-  # Sets the maximum number of events waiting in the in-memory queue.
-  config.queue_size = 100
-  # Sets the number of background workers that deliver queued events.
-  config.workers = 1
-  # Enables or disables all Chronos event collection and delivery.
-  config.enabled = true
-  # Controls whether captured exceptions are sent to Chronos.
-  config.error_notifications = true
-  # Prevents delivery from the listed application environments.
-  config.ignored_environments = []
-  # Routes outbound requests through a proxy URL when one is required.
-  config.proxy = nil
-  # Verifies the TLS certificate presented by the Chronos endpoint.
-  config.ssl_verify = true
-  # Identifies this SDK in outbound HTTP requests.
-  config.user_agent = "chronos-ruby/#{Chronos::VERSION}"
-  # Rejects serialized events larger than this number of bytes.
-  config.max_payload_size = 1_048_576
-  # Compresses request payloads with gzip when enabled.
-  config.gzip = false
-
-  # Privacy and filtering
-
-  # Removes values whose keys commonly contain credentials or private data.
-  config.blocklist_keys = Chronos::Configuration::DEFAULT_BLOCKLIST_KEYS.dup
-  # Keeps only the listed keys when this list is not empty.
-  config.allowlist_keys = []
-  # Applies custom callables that can transform or discard events.
-  config.filters = []
-  # Replaces values for these keys with stable hashes instead of raw data.
-  config.hash_keys = []
-  # Removes the final segment of captured IP addresses.
-  config.anonymize_ip = true
-  # Discards events that match any configured ignore rule.
-  config.ignore_rules = []
-  # Limits the number of ignore rules evaluated for each event.
-  config.max_ignore_rules = 20
-
-  # Reliability and remote configuration
 
-  # Sets the number of delivery retries after a recoverable failure.
-  config.max_retries = 3
-  # Sets the initial delay, in seconds, for exponential retry backoff.
-  config.retry_base_interval = 0.5
-  # Caps the retry delay, in seconds.
-  config.retry_max_interval = 30
-  # Randomizes retry delays to prevent synchronized retry traffic.
-  config.retry_jitter = 0.25
-  # Keeps this many failed events in memory for later delivery attempts.
-  config.backlog_size = 100
-  # Opens the circuit breaker after this many consecutive failures.
-  config.circuit_failure_threshold = 5
-  # Waits this many seconds before testing an open circuit again.
-  config.circuit_reset_timeout = 30
-  # Allows the server to supply bounded runtime configuration updates.
-  config.remote_configuration = true
-  # Limits the size of an accepted remote configuration response, in bytes.
-  config.remote_config_max_bytes = 4_096
-  # Captures this fraction of eligible events, from 0.0 to 1.0.
-  config.sampling_rate = 1.0
-  # Restricts remote collection to these event categories.
-  config.enabled_event_types = %w(
-    exception request query job cache external_http dependencies deploy metric_batch
-  )
-  # Caps the server-requested interval between deliveries, in seconds.
-  config.max_remote_send_interval = 60
-
-  # Execution context and breadcrumbs
-
-  # Isolates trace and request context between concurrent fibers.
-  config.context_store = :fiber_local
-  # Keeps this many recent breadcrumbs per execution context.
-  config.breadcrumb_capacity = 20
-  # Limits the serialized size of each breadcrumb, in bytes.
-  config.breadcrumb_max_bytes = 2_048
-
-  # Rails integration
-
-  # Installs Rails request, job, cache, SQL, and error integrations.
-  config.rails_enabled = true
-  # Captures events from Rails console sessions when enabled.
-  config.rails_capture_in_console = false
-  # Captures events while the Rails test environment is running when enabled.
-  config.rails_capture_in_test = false
-  # Includes the request User-Agent in request metadata when enabled.
-  config.rails_capture_user_agent = false
+  # 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
-
-  # Enables transaction, span, query, and aggregate performance monitoring.
-  config.apm_enabled = true
-  # Limits the number of metric groups retained between flushes.
-  config.apm_max_groups = 200
-  # Flushes APM aggregates after this many observations.
-  config.apm_flush_count = 100
-  # Sends at most this many APM items in one request.
-  config.apm_batch_size = 50
-  # Limits the SQL queries recorded for a single request or transaction.
-  config.apm_max_queries_per_request = 100
-  # Marks SQL queries slower than this duration, in milliseconds.
-  config.apm_slow_query_threshold_ms = 500
-  # Marks transactions longer than this duration, in milliseconds.
-  config.apm_long_transaction_threshold_ms = 1_000
-  # Reports repeated equivalent queries after this count is reached.
-  config.apm_n_plus_one_threshold = 5
-  # Defines the duration buckets, in milliseconds, used by APM histograms.
-  config.apm_histogram_buckets = [5, 10, 25, 50, 100, 250, 500, 1_000, 2_500, 5_000]
-  # Retains active trace state for this many seconds.
-  config.apm_trace_ttl_seconds = 60
-  # Normalizes SQL and records bounded query analysis metadata.
-  config.apm_query_analysis_enabled = true
-  # Limits the number of analyzed queries retained per transaction.
-  config.apm_query_analysis_max_queries = 100
-  # Enables database-specific query inspection for slow queries.
-  config.apm_query_inspection_enabled = false
-  # Collects database query statistics when inspection supports them.
-  config.apm_query_statistics_enabled = false
-  # Collects query execution plans when inspection supports them.
-  config.apm_query_plan_enabled = false
-  # Inspects only queries at least this slow, in milliseconds.
-  config.apm_query_inspection_min_duration_ms = 500
-  # Limits the inspected queries retained per transaction.
-  config.apm_query_inspection_max_queries = 20
-  # Tracks database transaction lifecycles and durations.
-  config.apm_transaction_tracking_enabled = true
-  # Limits the database connections tracked for transaction state.
-  config.apm_transaction_max_connections = 100
-
-  # Distributed tracing and integrations
-
-  # Instruments supported outbound HTTP clients when enabled.
-  config.external_http_enabled = false
-  # Propagates Chronos trace headers on instrumented outbound requests.
-  config.external_http_trace_headers = true
-  # Extracts and injects the standard W3C traceparent header when enabled.
-  config.w3c_trace_context = false
-  # Reuses an active OpenTelemetry span without configuring its SDK.
-  config.opentelemetry_bridge = true
-  # Controls cache key reporting; :none avoids collecting cache key material.
-  config.cache_key_mode = :none
-  # Reports a bounded inventory of application dependencies.
-  config.dependency_reporting = true
-  # Limits the number of dependencies included in an inventory event.
-  config.dependency_max_items = 100
+  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)
+
+  # 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
 
 # Installation is idempotent, regardless of when the Railtie was evaluated.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chronos-ruby
 version: !ruby/object:Gem::Version
-  version: 1.2.0.pre.2
+  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: