julewire-active_job 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a82446be20c0ec6d8ac39b204411837b4759cb57f94ddb9b2138173d16b5fc3d
-  data.tar.gz: 949f9196d2e54d90248b66bce79f34d20bd4be6fbae26667febe548527829cd1
+  metadata.gz: 994a99590e4edc3673032beb690309bf1dd80b9008bd3ada44c7ee75468ad799
+  data.tar.gz: 96330738837417e0a150b60b9212ccfd1055264b45f7e5e6d3e51e7b379194be
 SHA512:
-  metadata.gz: f0acd8d095c2b529f8bb865b3757bafa62a97e7997e5009d8a8960bd2b8c96e4ffbb2c3e7eb6345318f2150b0113f28e4236212571c0251eab74a89075dad694
-  data.tar.gz: fcf079813dfde620139088138f2705db70ad6a0ab62aa8f2655b977a3b9ccbcd04c27790d9582aabc6928f211fc2d182dfb488261d99d3e006fa5164571d70d1
+  metadata.gz: ba90a55b73280d51badf2b3ac32a27277cc6175537215cd050324785046eee0bf0a983b0d5c4e05a40cbbe6b2aa86754d213de639caa3b0913fdef07029050fd
+  data.tar.gz: 2b8ccba07a60b83bb30d5615fb653a672c72ce36e663ac1bb4dd79bf8a5c68f1b83784ce388d740fac1d7d9e8fcd9b7159fc303f580cb31f33c0297fad218d79

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## Unreleased
 
+## 1.1.0 - 2026-07-20
+
+- Restore propagated context through owned carrier envelopes and keep job
+  status summaries on Active Job's normal `StandardError` path.
+- Require Julewire 1.1.0 internal gems.
+
+## 1.0.1 - 2026-06-25
+
+- Default propagation carrier byte limits to 64 KiB and record health when
+  oversized or malformed job carriers are ignored on restore.
+- Require julewire 1.0.1 internal gems.
+
 ## 1.0.0 - 2026-06-21
 
 - Initial release: ActiveJob execution summaries, structured events,

data/docs/configuration.md

@@ -17,7 +17,7 @@ apps pass a `Configuration` instance to `install!`.
 
 | Option | Default | Purpose |
 | --- | --- | --- |
-| `carrier_max_bytes` | `nil` | Omit oversized carriers from serialized jobs. |
+| `carrier_max_bytes` | `65_536` | Omit oversized carriers from serialized jobs. |
 | `silence_log_subscriber` | `true` | Detach Active Job default text subscriber output. |
 
 Example:

data/docs/propagation.md

@@ -7,11 +7,15 @@ job execution scope starts.
 That lets upstream context flow into the job without emitting propagation-only
 data by default.
 
-Set `carrier_max_bytes` to omit oversized carriers from serialized job payloads.
-When omitted, the job still runs normally; it starts without upstream Julewire
-context.
+`carrier_max_bytes` defaults to `65_536`. Oversized carriers are omitted from
+serialized job payloads and ignored on restore. The job still runs normally; it
+starts without upstream Julewire context.
 
 Generic job metadata such as class, id, queue, priority, execution count,
 timestamps, and status is emitted in the record's `neutral` section as `job.*`
 formatter-coordination fields. Full Active Job metadata, including framework-
 specific status and exception fields, is emitted under `attributes.active_job`.
+
+Status classification follows Active Job's normal `StandardError` path. Fatal
+Ruby exceptions such as `SystemExit` or `NoMemoryError` are not converted into
+job status metadata; they keep Ruby's process-level semantics.

data/julewire-active_job.gemspec

@@ -35,7 +35,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activejob", ">= 8.1"
-  spec.add_dependency "julewire-core", ">= 1.0"
-  spec.add_dependency "julewire-rails_support", ">= 1.0"
+  spec.add_dependency "julewire-core", ">= 1.1.0"
+  spec.add_dependency "julewire-rails_support", ">= 1.1.0"
   spec.add_dependency "zeitwerk", ">= 2.8.1"
 end

data/lib/julewire/active_job/configuration.rb

@@ -13,7 +13,8 @@ module Julewire
       setting :silence_log_subscriber, default: true, predicate: true
       setting :propagation, default: true, predicate: true
       setting :carrier_key, default: Julewire::Core::Propagation::Carrier::DEFAULT_KEY
-      setting :carrier_max_bytes, validate: byte_limit
+      setting :carrier_max_bytes, default: Julewire::Core::Propagation::Carrier::DEFAULT_MAX_BYTES,
+                                  validate: byte_limit
       setting :serialized_carrier_key, default: DEFAULT_SERIALIZED_CARRIER_KEY
       setting :source, default: "active_job"
       setting :summary_event, default: "job.completed"

data/lib/julewire/active_job/installer.rb

@@ -9,17 +9,13 @@ module Julewire
         def install!(base: nil, event_reporter: nil, configuration: Configuration.new)
           return unless configuration.enabled?
 
-          Julewire::ActiveJob.config = configuration
+          ActiveJob.config = configuration
           base ||= active_job_base
           raise Error, "ActiveJob::Base is not available" unless base
 
           install_serialization(base, configuration)
           install_execution_callback(base, configuration)
-          if configuration.structured_events?
-            Subscribers::Event.install!(configuration, event_reporter: event_reporter)
-          else
-            Subscribers::Event.reset!
-          end
+          Subscribers::Event.install!(configuration, event_reporter: event_reporter)
           LogSubscriberSilencer.silence! if configuration.silence_log_subscriber?
           base
         end
@@ -33,24 +29,15 @@ module Julewire
 
         def install_serialization(base, configuration)
           install_serialization_configuration(base, configuration)
-          return if base < JobSerialization
 
           base.prepend(JobSerialization)
         end
 
         def install_serialization_configuration(base, configuration)
-          if base.respond_to?(:class_attribute)
-            unless base.respond_to?(JobSerialization::CONFIGURATION_METHOD)
-              base.class_attribute(
-                JobSerialization::CONFIGURATION_METHOD,
-                instance_accessor: false,
-                instance_predicate: false
-              )
-            end
-            base.public_send("#{JobSerialization::CONFIGURATION_METHOD}=", configuration)
-          else
-            base.instance_variable_set(JobSerialization::CONFIGURATION_IVAR, configuration)
+          if base.singleton_methods(false).include?(JobSerialization::CONFIGURATION_METHOD)
+            base.singleton_class.remove_method(JobSerialization::CONFIGURATION_METHOD)
           end
+          base.define_singleton_method(JobSerialization::CONFIGURATION_METHOD) { configuration }
         end
 
         def install_execution_callback(base, configuration)
@@ -59,7 +46,7 @@ module Julewire
           installed = EXECUTION_INSTALL.fetch(base)
           if installed
             installed.configuration = configuration
-            return installed
+            return
           end
 
           callback = ExecutionCallback.new(configuration)
@@ -79,7 +66,7 @@ module Julewire
         attr_writer :configuration
 
         def call(job, &)
-          Julewire::ActiveJob::JobExecution.call(job, configuration: @configuration, &)
+          JobExecution.call(job, configuration: @configuration, &)
         end
       end
       private_constant :ExecutionCallback

data/lib/julewire/active_job/job_execution.rb

@@ -6,45 +6,62 @@ module Julewire
   module ActiveJob
     module JobExecution
       class << self
-        def call(job, configuration: Configuration.new, &)
+        def call(job, configuration:, &)
           carrier = carrier_for(job)
           return perform_job(job, configuration, &) unless configuration.propagation?
 
-          Julewire::Core::Propagation::Carrier.restore(carrier, key: configuration.carrier_key) do
+          result = Core::Propagation::Carrier.extract_result(
+            carrier,
+            key: configuration.carrier_key,
+            max_bytes: configuration.carrier_max_bytes
+          )
+          record_carrier_restore_failure(result)
+
+          Core::Propagation.restore(result.envelope, owned: true) do
             perform_job(job, configuration, &)
           end
         end
 
         private
 
+        def record_carrier_restore_failure(result)
+          return unless result.failure?
+
+          IntegrationHealth.record_failure(
+            result.error,
+            action: :carrier_restore,
+            component: :job_execution,
+            status: result.status,
+            reason: result.reason
+          )
+        end
+
         def perform_job(job, configuration, &)
           fields = job_fields(job)
-          Core::Integration::Facade.with_execution(**execution_options(job, configuration, fields)) do
+          Core::Integration::Facade.with_execution(**execution_options(configuration, fields)) do
             install_context(fields)
             perform_with_summary(&)
           end
         end
 
         def carrier_for(job)
-          job.instance_variable_get(CARRIER_IVAR) || {}
+          job.instance_variable_get(CARRIER_IVAR)
         rescue StandardError
-          {}
+          nil
         end
 
-        def execution_options(job, configuration, fields)
-          options = {
+        def execution_options(configuration, fields)
+          {
             type: :job,
-            fields: { job_class: fields[:job_class] || job.class.name },
+            fields: { job_class: fields.fetch(:job_class) },
             attributes: attributes_for(fields),
             neutral: neutral_for(fields),
             inherit_attributes: false,
             summary_event: configuration.summary_event,
             summary_severity: configuration.summary_severity,
-            summary_source: configuration.source
+            summary_source: configuration.source,
+            id: fields[:job_id]
           }
-          job_id = fields[:job_id]
-          options[:id] = job_id if job_id
-          options
         end
 
         def install_context(fields)

data/lib/julewire/active_job/job_serialization.rb

@@ -3,7 +3,6 @@
 module Julewire
   module ActiveJob
     module JobSerialization
-      CONFIGURATION_IVAR = :@julewire_active_job_configuration
       CONFIGURATION_METHOD = :julewire_active_job_configuration
 
       def serialize
@@ -23,16 +22,12 @@ module Julewire
         configuration = julewire_active_job_configuration
         return unless configuration.propagation?
 
-        carrier = Julewire::Core::Propagation::Carrier.inject(
-          {},
-          key: configuration.carrier_key,
-          max_bytes: configuration.carrier_max_bytes
-        )
+        carrier = Core::Propagation::Carrier.inject(key: configuration.carrier_key,
+                                                    max_bytes: configuration.carrier_max_bytes)
         return unless carrier
 
-        value = carrier[configuration.carrier_key.to_s]
-        job_data[configuration.serialized_carrier_key] = value if value
-        IntegrationHealth.record_success(action: :carrier_inject, component: :job_serialization)
+        job_data[configuration.serialized_carrier_key] = carrier.fetch(configuration.carrier_key.to_s)
+        IntegrationHealth.record_success
       rescue StandardError => e
         IntegrationHealth.record_failure(e, action: :carrier_inject, component: :job_serialization)
       end
@@ -46,26 +41,16 @@ module Julewire
 
         value = job_data[configuration.serialized_carrier_key]
         instance_variable_set(CARRIER_IVAR, value ? { configuration.carrier_key => value } : {})
-        IntegrationHealth.record_success(action: :carrier_extract, component: :job_serialization)
+        IntegrationHealth.record_success
       rescue StandardError => e
         IntegrationHealth.record_failure(e, action: :carrier_extract, component: :job_serialization)
         instance_variable_set(CARRIER_IVAR, {})
       end
 
       def julewire_active_job_configuration
-        if self.class.respond_to?(CONFIGURATION_METHOD)
-          configuration = self.class.public_send(CONFIGURATION_METHOD)
-          return configuration if configuration
-        end
-
-        self.class.ancestors.each do |ancestor|
-          next unless ancestor.instance_variable_defined?(CONFIGURATION_IVAR)
-
-          return ancestor.instance_variable_get(CONFIGURATION_IVAR)
-        end
-        Julewire::ActiveJob.config
+        self.class.public_send(CONFIGURATION_METHOD)
       rescue StandardError
-        Julewire::ActiveJob.config
+        ActiveJob.config
       end
     end
   end

data/lib/julewire/active_job/log_subscriber_silencer.rb

@@ -6,17 +6,8 @@ module Julewire
       class << self
         def silence!
           Core::Integration::Lifecycle.require_optional("active_job/log_subscriber")
-          subscriber_class = active_job_log_subscriber
-          return unless subscriber_class
-
-          subscriber_class.detach_from(:active_job) if subscriber_class.respond_to?(:detach_from)
-          Julewire::RailsSupport::EventReporter.unsubscribe_log_subscriber(subscriber_class)
-        end
-
-        private
-
-        def active_job_log_subscriber
-          ::ActiveJob::LogSubscriber if defined?(::ActiveJob::LogSubscriber)
+          subscriber_class = ::ActiveJob::LogSubscriber if defined?(::ActiveJob::LogSubscriber)
+          Julewire::RailsSupport::LogSubscribers.detach(subscriber_class, :active_job)
         end
       end
     end

data/lib/julewire/active_job/railtie.rb

@@ -14,7 +14,7 @@ module Julewire
           return unless settings.enabled?
 
           ActiveSupport.on_load(:active_job) do
-            Julewire::ActiveJob.install!(base: self, configuration: settings)
+            ActiveJob.install!(base: self, configuration: settings)
           end
         end
       end

data/lib/julewire/active_job/subscribers/event.rb

@@ -21,11 +21,11 @@ module Julewire
             return reset! unless configuration.structured_events?
 
             Core::Integration::Lifecycle.require_optional(STRUCTURED_EVENT_FILE)
-            reporter = event_reporter || Julewire::RailsSupport::EventReporter.default
-            return unless Julewire::RailsSupport::EventReporter.subscribable?(reporter)
+            reporter = event_reporter || RailsSupport::EventReporter.default
+            return unless RailsSupport::EventReporter.subscribable?(reporter)
 
             install_subscriber(configuration, enabled: true) do |subscriber|
-              Julewire::RailsSupport::EventReporter.subscribe(reporter, subscriber) { subscriber.accept?(it) }
+              RailsSupport::EventReporter.subscribe(reporter, subscriber) { subscriber.accept?(it) }
             end
           end
         end
@@ -45,7 +45,7 @@ module Julewire
         def emit_event(event)
           name = event[:name].to_s
           record = record_for(event, name)
-          enrich_continuation_summary(name, record.dig(:attributes, :active_job) || {})
+          enrich_continuation_summary(name, record.fetch(:attributes).fetch(:active_job))
           Core::Integration::Facade.emit(record)
         end
 
@@ -60,13 +60,13 @@ module Julewire
         def base_record(event, name, payload)
           values = Core::Integration::Values::Shape
           record = {
-            severity: severity_for(name, payload),
             event: name,
             logger: "ActiveJob.event",
             context: values.hash_or_empty(event[:context]),
             attributes: attributes_for(event, payload),
             neutral: neutral_for(event, payload)
           }
+          values.append_field(record, :severity, severity_for(name, payload))
           values.append_field(record, :timestamp, values.timestamp(event[:timestamp]))
           values.append_field(record, :source, @configuration.source)
           record
@@ -81,22 +81,17 @@ module Julewire
 
         def neutral_for(event, payload)
           values = Core::Integration::Values::Shape
-          Core::Fields::FieldSet.merge!(
+          Core::Fields::FieldSet.merge(
             JobAttributes.call(payload),
             values.source_location_attributes(event[:source_location])
           )
         end
 
         def severity_for(name, payload)
-          return :error if ERROR_EVENTS.include?(name)
-          return :error if exception_payload?(payload)
-
-          :info
+          :error if ERROR_EVENTS.include?(name) || exception_payload?(payload)
         end
 
         def exception_payload?(payload)
-          return false unless payload.is_a?(Hash)
-
           payload.key?(:exception_class) ||
             payload.key?(:exception_message) ||
             payload.key?(:exception_backtrace)
@@ -111,8 +106,6 @@ module Julewire
         end
 
         def enrich_continuation_summary(name, payload)
-          return unless Core::Integration::Facade.summary_active?
-
           case name
           when "active_job.step_started"
             increment_summary(:continuation_steps_started)

data/lib/julewire/active_job/version.rb

@@ -2,6 +2,6 @@
 
 module Julewire
   module ActiveJob
-    VERSION = "1.0.0"
+    VERSION = "1.1.0"
   end
 end

data/lib/julewire/active_job.rb

@@ -23,10 +23,6 @@ module Julewire
       def perform(job, &)
         JobExecution.call(job, configuration: config, &)
       end
-
-      def load_railtie_if_rails!
-        Railtie if defined?(::Rails::Railtie)
-      end
     end
   end
 
@@ -34,5 +30,5 @@ module Julewire
   # Rails-only autoload, skipped when non-Rails processes eager load the gem.
   loader.do_not_eager_load("#{__dir__}/active_job/railtie.rb")
   loader.setup
-  Julewire::ActiveJob.load_railtie_if_rails!
+  Julewire::ActiveJob::Railtie if defined?(::Rails::Railtie)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: julewire-active_job
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Alexander Grebennik
@@ -29,28 +29,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: julewire-rails_support
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -116,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.14
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Active Job integration for Julewire structured logging.
 test_files: []