chronos-ruby 0.4.0.pre.1 → 0.6.0.pre.1

data/lib/chronos/rails/railtie.rb

@@ -0,0 +1,21 @@
+module Chronos
+  module Rails
+    # Hooks Chronos installation into the public Rails initializer lifecycle.
+    #
+    # @responsibility Install integrations after application configuration initializers load.
+    # @motivation Ensure generated Chronos configuration exists before hooks are activated.
+    # @limits It performs no autoloading and does not use private Rails initialization APIs.
+    # @collaborators Rails::Railtie and Chronos::Rails::Installer.
+    # @thread_safety Rails invokes the initializer during serialized application boot.
+    # @compatibility Rails 4.2 through Rails 5.2; no Zeitwerk requirement.
+    # @example
+    #   require "chronos/rails"
+    # @errors Installer contains optional integration failures and allows Rails to boot.
+    # @performance Adds only one initializer and one-time installation work.
+    class Railtie < ::Rails::Railtie
+      initializer "chronos.install", :after => :load_config_initializers do |application|
+        Chronos::Rails::Installer.new.install(application)
+      end
+    end
+  end
+end

data/lib/chronos/rails.rb

@@ -0,0 +1,16 @@
+require "chronos"
+require "chronos/rails/notifications_subscriber"
+require "chronos/rails/installer"
+
+require "chronos/rails/railtie" if defined?(::Rails::Railtie)
+
+module Chronos
+  # Legacy Rails integration loaded explicitly after Rails is available.
+  #
+  # @responsibility Namespace Railtie, installer, and notification subscribers.
+  # @motivation Keep Rails and ActiveSupport out of the framework-independent core.
+  # @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
+end

data/lib/chronos/sidekiq.rb

@@ -0,0 +1,12 @@
+require "chronos"
+
+sidekiq_available = begin
+  require "sidekiq"
+  true
+rescue LoadError
+  false
+end
+
+require "chronos/integrations/sidekiq"
+
+Chronos::Integrations::Sidekiq.install if sidekiq_available && defined?(::Sidekiq)

data/lib/chronos/version.rb

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

data/lib/chronos.rb

@@ -15,6 +15,7 @@ require "chronos/core/sensitive_value_filter"
 require "chronos/core/sanitizer"
 require "chronos/core/safe_serializer"
 require "chronos/core/payload_serializer"
+require "chronos/core/telemetry_event"
 require "chronos/ports/transport"
 require "chronos/ports/context_store"
 require "chronos/internal/safe_logger"
@@ -29,6 +30,7 @@ require "chronos/application/circuit_breaker"
 require "chronos/application/remote_configuration"
 require "chronos/application/delivery_pipeline"
 require "chronos/application/capture_exception"
+require "chronos/application/capture_telemetry"
 require "chronos/agent"
 require "chronos/integrations"
 require "chronos/integrations/rack"
@@ -38,7 +40,7 @@ require "chronos/integrations/rack/middleware"
 #
 # @responsibility Configure the agent and expose its small lifecycle API.
 # @motivation Give applications a stable entry point while internals evolve.
-# @limits Version 0.4 captures Rack failures but does not install middleware automatically.
+# @limits Rails integration remains optional and must be loaded through chronos/rails.
 # @collaborators Configuration and Agent.
 # @thread_safety Agent replacement and lookup are protected by a mutex.
 # @compatibility Ruby 2.2.10 through Ruby 2.6.
@@ -95,6 +97,35 @@ module Chronos
       false
     end
 
+    def record_event(event_type, payload = {}, context = {})
+      agent = current_agent
+      agent ? agent.record_event(event_type, payload, context) : false
+    rescue StandardError
+      false
+    end
+
+    # Returns only trace/request identifiers for optional process-boundary adapters.
+    def propagation_context
+      agent = current_agent
+      agent ? agent.propagation_context : {}
+    rescue StandardError
+      {}
+    end
+
+    def notify_once(exception, context = {})
+      agent = current_agent
+      agent ? agent.notify_once(exception, context) : false
+    rescue StandardError
+      false
+    end
+
+    def rails_integration_options(environment = nil, console = false)
+      agent = current_agent
+      agent ? agent.rails_integration_options(environment, console) : {:enabled => false}
+    rescue StandardError
+      {:enabled => false}
+    end
+
     def configured?
       !current_agent.nil?
     end
@@ -124,3 +155,5 @@ module Chronos
     end
   end
 end
+
+require "chronos/rails" if defined?(::Rails::Railtie)

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

@@ -0,0 +1,25 @@
+require "rails/generators"
+
+module Chronos
+  module Generators
+    # Generates the explicit Chronos initializer for legacy Rails applications.
+    #
+    # @responsibility Copy one documented initializer into config/initializers.
+    # @motivation Keep credentials explicit and avoid automatic environment scanning.
+    # @limits It does not modify routes, application classes, or Gemfiles.
+    # @collaborators Rails::Generators::Base file-copy API.
+    # @thread_safety Generator instances are used serially by the Rails command.
+    # @compatibility Rails generator APIs available in Rails 4.2 through Rails 5.2.
+    # @example
+    #   rails generate chronos:install
+    # @errors Existing-file conflict handling is delegated to Rails generators.
+    # @performance Copies one small text file.
+    class InstallGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      def create_initializer
+        copy_file "chronos.rb", "config/initializers/chronos.rb"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+require "chronos/rails"
+
+Chronos.configure do |config|
+  # Chronos reads only the environment variables explicitly selected here.
+  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.app_version = ENV["CHRONOS_APP_VERSION"]
+  config.logger = Rails.logger if Rails.respond_to?(:logger)
+
+  # 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
+end
+
+# Safe when the Railtie already ran or will run later; installation is idempotent.
+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: 0.4.0.pre.1
+  version: 0.6.0.pre.1
 platform: ruby
 authors:
 - Antonio Jefferson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-20 00:00:00.000000000 Z
+date: 2026-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -88,6 +88,7 @@ files:
 - SECURITY.md
 - contracts/event-v1.schema.json
 - contracts/rack-context-v1.schema.json
+- contracts/sidekiq-job-v1.schema.json
 - docs/adr/ADR-001-core-and-integrations.md
 - docs/adr/ADR-002-version-lines.md
 - docs/adr/ADR-003-net-http-legacy-transport.md
@@ -96,6 +97,8 @@ files:
 - docs/adr/ADR-006-versioned-event-contract.md
 - docs/adr/ADR-011-bounded-resilience-and-remote-control.md
 - docs/adr/ADR-012-rack-context-isolation.md
+- docs/adr/ADR-013-legacy-rails-notifications.md
+- docs/adr/ADR-014-sidekiq-envelope-context.md
 - docs/architecture.md
 - docs/compatibility.md
 - docs/configuration.md
@@ -105,10 +108,13 @@ files:
 - docs/modules/configuration.md
 - docs/modules/notice-pipeline.md
 - docs/modules/rack-context.md
+- docs/modules/rails-legacy.md
 - docs/modules/remote-configuration.md
 - docs/modules/retry-backlog.md
 - docs/modules/sanitization.md
 - docs/modules/serialization.md
+- docs/modules/sidekiq-legacy.md
+- docs/modules/telemetry-events.md
 - docs/modules/transport.md
 - docs/performance.md
 - docs/privacy-lgpd.md
@@ -120,11 +126,14 @@ files:
 - lib/chronos/agent.rb
 - lib/chronos/application.rb
 - lib/chronos/application/capture_exception.rb
+- lib/chronos/application/capture_telemetry.rb
 - lib/chronos/application/circuit_breaker.rb
 - lib/chronos/application/delivery_pipeline.rb
 - lib/chronos/application/remote_configuration.rb
 - lib/chronos/application/retry_policy.rb
 - lib/chronos/configuration.rb
+- lib/chronos/configuration/snapshot.rb
+- lib/chronos/configuration/validation.rb
 - lib/chronos/core.rb
 - lib/chronos/core/backtrace_parser.rb
 - lib/chronos/core/breadcrumb.rb
@@ -136,10 +145,13 @@ files:
 - lib/chronos/core/safe_serializer.rb
 - lib/chronos/core/sanitizer.rb
 - lib/chronos/core/sensitive_value_filter.rb
+- lib/chronos/core/telemetry_event.rb
 - lib/chronos/errors.rb
 - lib/chronos/integrations.rb
+- lib/chronos/integrations/job_payload.rb
 - lib/chronos/integrations/rack.rb
 - lib/chronos/integrations/rack/middleware.rb
+- lib/chronos/integrations/sidekiq.rb
 - lib/chronos/internal.rb
 - lib/chronos/internal/bounded_queue.rb
 - lib/chronos/internal/memory_backlog.rb
@@ -148,9 +160,16 @@ files:
 - lib/chronos/ports.rb
 - lib/chronos/ports/context_store.rb
 - lib/chronos/ports/transport.rb
+- lib/chronos/rails.rb
+- lib/chronos/rails/installer.rb
+- lib/chronos/rails/notifications_subscriber.rb
+- lib/chronos/rails/railtie.rb
 - lib/chronos/ruby.rb
 - lib/chronos/ruby/version.rb
+- lib/chronos/sidekiq.rb
 - lib/chronos/version.rb
+- lib/generators/chronos/install/install_generator.rb
+- lib/generators/chronos/install/templates/chronos.rb
 homepage: https://github.com/antoniojefferson/chronos-ruby
 licenses:
 - MIT