julewire-core 1.0.0 → 1.1.0

data/lib/julewire/core/records/public_projection.rb

@@ -29,7 +29,7 @@ module Julewire
         end
 
         def each
-          return enum_for(:each) unless block_given?
+          return enum_for unless block_given?
 
           @record.each do |key, value|
             next if INTERNAL_KEYS.include?(key)
@@ -41,7 +41,7 @@ module Julewire
         private
 
         def output_value(key, value)
-          return self.class.public_execution(value) if key == :execution && value.is_a?(Hash)
+          return self.class.public_execution(value) if key == :execution
 
           value
         end

data/lib/julewire/core/records/raw_input.rb

@@ -26,7 +26,7 @@ module Julewire
           def value(input, key, default: nil)
             return default unless hash_input?(input)
             return input[key] if input.key?(key)
-            return input[key.to_s] if input.key?(key.to_s)
+            return input.fetch(key.to_s) if input.key?(key.to_s)
 
             default
           end

data/lib/julewire/core/records/record.rb

@@ -19,22 +19,24 @@ module Julewire
 
         class << self
           def from_normalized_hash(record, lineage: nil)
-            if record.is_a?(Hash)
-              lineage ||= Execution::Lineage.from_execution_hash(record[:execution])
-              record = record.merge(execution: Execution::Lineage.clean_lazy_relationship_hash(record[:execution]))
-            end
             validate_normalized_hash!(record)
+            execution = record.fetch(:execution)
+            lineage ||= Execution::Lineage.from_execution_hash(execution)
+            record = record.merge(
+              execution: Execution::Lineage.clean_normalized_lazy_relationship_hash(execution)
+            )
             new(snapshot_hash(record), lineage: lineage)
           end
 
           def from_owned_hash(record, lineage: nil, trust_frozen: false)
-            if record.is_a?(Hash)
-              lineage ||= Execution::Lineage.from_execution_hash(record.fetch(:execution))
-              execution = Execution::Lineage.clean_lazy_relationship_hash(record.fetch(:execution))
-              record = record.frozen? ? record.merge(execution: execution) : replace_execution(record, execution)
-            end
-            validate_normalized_hash!(record)
-            new(Serialization::DeepFreeze.call(record, trust_frozen: trust_frozen), lineage: lineage)
+            validate_normalized_hash_structure!(record)
+            lineage ||= Execution::Lineage.from_execution_hash(record.fetch(:execution))
+            execution = Execution::Lineage.clean_normalized_lazy_relationship_hash(record.fetch(:execution))
+            record = record.frozen? ? record.merge(execution: execution) : replace_execution(record, execution)
+            new(
+              Serialization::DeepFreeze.call(record, trust_frozen: trust_frozen, validate_symbol_keys: true),
+              lineage: lineage
+            )
           end
 
           def validate_normalized!(record)
@@ -55,11 +57,22 @@ module Julewire
             record
           end
 
-          def validate_hash!(record)
-            raise TypeError, "record must be a normalized Hash" unless record.is_a?(Hash)
+          def validate_normalized_hash_structure!(record)
+            validate_record_hash!(record)
+            validate_structure!(record)
+          end
 
+          def validate_hash!(record)
+            validate_record_hash!(record)
             validate_symbol_keys!(record)
+            validate_structure!(record)
+          end
 
+          def validate_record_hash!(record)
+            raise TypeError, "record must be a normalized Hash" unless record.is_a?(Hash)
+          end
+
+          def validate_structure!(record)
             validate_required_keys!(record)
             validate_known_keys!(record)
 
@@ -70,9 +83,7 @@ module Julewire
           end
 
           def validate_symbol_keys!(record)
-            record.each_key do |key|
-              raise TypeError, "record must not use string keys" if key.is_a?(String)
-            end
+            Serialization::DeepFreeze.validate_symbol_keys(record)
           end
 
           def validate_required_keys!(record)
@@ -126,7 +137,8 @@ module Julewire
           def snapshot_hash(record)
             Serialization::ValueCopy.call(
               record,
-              freeze_values: true
+              freeze_values: true,
+              preserve_truncation_metadata: true
             )
           end
         end
@@ -149,7 +161,7 @@ module Julewire
 
         def each(&) = @data.each(&)
 
-        def to_h = Fields::FieldSet.deep_dup(@data)
+        def to_h = Fields::FieldSet.deep_dup_owned(@data)
 
         # @api internal
         def serializable_data = @data

data/lib/julewire/core/records/severity.rb

@@ -12,29 +12,21 @@ module Julewire
 
         class << self
           def normalize(value)
-            return value if RANKS.key?(value)
-
-            severity = severity_symbol(value)
-            return severity if RANKS.key?(severity)
-
-            raise ArgumentError, "unsupported severity: #{value.inspect}"
-          end
-
-          def severity_symbol(value)
             case value
             when Symbol
-              value.downcase
+              return value if RANKS.key?(value)
             when String
-              STRING_VALUES[value.downcase]
+              severity = STRING_VALUES[value.downcase]
+              return severity unless severity.nil?
             when Integer
-              LOGGER_INTEGER_VALUES[value]
+              severity = LOGGER_INTEGER_VALUES[value]
+              return severity unless severity.nil?
             end
+
+            raise ArgumentError, "unsupported severity: #{value.inspect}"
           end
 
           def rank(value)
-            rank = RANKS[value]
-            return rank unless rank.nil?
-
             RANKS.fetch(normalize(value))
           end
         end

data/lib/julewire/core/runtime.rb

@@ -17,7 +17,7 @@ module Julewire
         runtime_callback_failures
         runtime_failures
       ].freeze
-      CloseTransition = Data.define(:state, :close_pipeline, :timeout)
+      CloseTransition = Data.define(:state, :timeout)
       PipelineReplacement = Data.define(
         :old_pipeline,
         :close_timeout,
@@ -29,15 +29,12 @@ module Julewire
 
       def initialize
         @configure_mutex = Mutex.new
-        @configure_generation = Concurrent::AtomicFixnum.new(0)
-        @state_mutex = Mutex.new
-        @post_close_emit_count = Concurrent::AtomicFixnum.new(0)
+        @configure_generation = Concurrent::AtomicFixnum.new
+        @post_close_emit_count = Concurrent::AtomicFixnum.new
         @runtime_health = build_runtime_health
         @integration_health = Diagnostics::IntegrationHealthStore.new
         @invalid_severity_reporter = Diagnostics::InvalidSeverityReporter.counter
-        @state_ref = Concurrent::AtomicReference.new(
-          RuntimeState.default(invalid_severity_reporter: @invalid_severity_reporter)
-        )
+        @state_ref = Concurrent::AtomicReference.new(RuntimeState.default)
         @execution_boundary = build_execution_boundary
       end
 
@@ -66,11 +63,11 @@ module Julewire
 
       def start_execution(...) = @execution_boundary.start_execution(...)
 
-      def emit(record = Core::UNSET, **fields, &)
+      def emit(record = UNSET, **fields, &)
         emit_with_level_check(record, true, fields, &)
       end
 
-      def emit_without_level(record = Core::UNSET, **fields, &)
+      def emit_without_level(record = UNSET, **fields, &)
         emit_with_level_check(record, false, fields, &)
       end
 
@@ -80,22 +77,13 @@ module Julewire
         end
       end
 
-      def emit_envelope(input:, context:, scope:, carry: {}, attributes: {}, neutral: {}, enforce_level: true)
+      def emit_envelope(input:, context:, scope:, carry:, attributes:, neutral:, enforce_level: true, owned: false)
         reject_runtime_call_during_configure!(:emit_envelope)
         state = runtime_state
         return record_post_close_emit(state) if state.pipeline_closed
 
         begin
-          record = Records::Draft.build(
-            input,
-            context: envelope_hash(context),
-            attributes: envelope_hash(attributes),
-            neutral: envelope_hash(neutral),
-            carry: envelope_hash(carry),
-            scope: scope,
-            error_backtrace_lines: state.configuration.error_backtrace_lines,
-            invalid_severity_reporter: @invalid_severity_reporter
-          ).to_record
+          record = envelope_draft(input, context, attributes, neutral, carry, scope, state, owned: owned).to_record
           state.pipeline.emit_record(record, enforce_level: enforce_level)
         rescue StandardError => e
           notify_failure(e, state, action: :emit_envelope)
@@ -110,6 +98,7 @@ module Julewire
 
         begin
           input = scope.owned_summary_record_input
+          Serialization::DeepFreeze.validate_symbol_keys(input)
           state.pipeline.emit_isolated_input(input)
         rescue StandardError => e
           notify_failure(e, state, action: :emit_summary_record)
@@ -135,20 +124,18 @@ module Julewire
         config
       end
 
-      def flush(timeout: Core::UNSET)
+      def flush(timeout: UNSET)
         call_validated_lifecycle(:flush, timeout)
       end
 
-      def close(timeout: Core::UNSET)
+      def close(timeout: UNSET)
         close_state_resources(close_state(timeout))
       end
 
       def reset!
         increment_runtime_count(:reset_attempts)
         reset_result = reject_runtime_call_during_configure!(:reset!) do
-          @configure_mutex.synchronize do
-            @state_mutex.synchronize { reset_under_lock }
-          end
+          @configure_mutex.synchronize { reset_under_lock }
         end
         deadline = Scheduling::Deadline.for(reset_result.close_timeout)
         return unless reset_result.close_pipeline
@@ -161,6 +148,8 @@ module Julewire
         )
       end
 
+      def reset_facade! = RuntimeRegistry.reset(primary: self)
+
       def after_fork!
         reject_runtime_call_during_configure!(:after_fork!)
         RuntimeRegistry.reset_after_fork(primary: self)
@@ -169,7 +158,6 @@ module Julewire
       def reset_after_fork_runtime!
         reset_after_fork_state!
         runtime_state.pipeline.after_fork!
-        self
       end
 
       def record_integration_failure(integration, error, **metadata)
@@ -200,6 +188,33 @@ module Julewire
 
       private
 
+      def envelope_draft(input, context, attributes, neutral, carry, scope, state, owned:)
+        if owned
+          Records::Draft.build_pipeline_owned(
+            input,
+            context: envelope_hash(context, owned: true),
+            attributes: envelope_hash(attributes, owned: true),
+            neutral: envelope_hash(neutral, owned: true),
+            carry: envelope_hash(carry, owned: true),
+            scope: scope,
+            error_backtrace_lines: state.configuration.error_backtrace_lines,
+            input_owned: true,
+            invalid_severity_reporter: @invalid_severity_reporter
+          )
+        else
+          Records::Draft.build(
+            input,
+            context: envelope_hash(context, owned: false),
+            attributes: envelope_hash(attributes, owned: false),
+            neutral: envelope_hash(neutral, owned: false),
+            carry: envelope_hash(carry, owned: false),
+            scope: scope,
+            error_backtrace_lines: state.configuration.error_backtrace_lines,
+            invalid_severity_reporter: @invalid_severity_reporter
+          )
+        end
+      end
+
       def before_execution_boundary_call!(action)
         reject_runtime_call_during_configure!(action)
       end
@@ -225,11 +240,7 @@ module Julewire
       end
 
       def install_and_replace_pipeline(state, next_configuration, next_pipeline)
-        replaced_pipeline = @state_mutex.synchronize do
-          raise Error, "Julewire.configure state changed before install completed" unless runtime_state.equal?(state)
-
-          replace_pipeline(next_configuration, next_pipeline)
-        end
+        replaced_pipeline = replace_pipeline(next_configuration, next_pipeline, state: state)
         PipelineReplacement.new(
           replaced_pipeline,
           state.configuration.pipeline_close_timeout,
@@ -251,11 +262,14 @@ module Julewire
         Fiber[CONFIGURE_GUARD_KEY] = previous
       end
 
-      def replace_pipeline(configuration, pipeline)
-        state = runtime_state
+      def replace_pipeline(configuration, pipeline, state:)
+        next_state = state.next_generation(configuration: configuration, pipeline: pipeline)
+        unless @state_ref.compare_and_set(state, next_state)
+          raise Error, "Julewire.configure state changed before install completed"
+        end
+
         @post_close_emit_count.value = 0
-        @runtime_health.clear_degradation
-        @state_ref.set(state.next_generation(configuration: configuration, pipeline: pipeline))
+        @runtime_health.record_success
         state.pipeline
       end
 
@@ -274,7 +288,7 @@ module Julewire
       end
 
       def normalize_lifecycle_timeout(timeout, state)
-        timeout.equal?(Core::UNSET) ? state.configuration.pipeline_close_timeout : timeout
+        timeout.equal?(UNSET) ? state.configuration.pipeline_close_timeout : timeout
       end
 
       def validate_lifecycle_timeout!(timeout, name:)
@@ -282,7 +296,7 @@ module Julewire
       end
 
       def close_state_resources(transition)
-        return true unless transition.close_pipeline
+        return true unless transition
 
         deadline = Scheduling::Deadline.for(transition.timeout)
         call_pipeline_lifecycle_on(
@@ -295,17 +309,22 @@ module Julewire
 
       def close_state(timeout)
         reject_runtime_call_during_configure!(:close)
-        @state_mutex.synchronize do
-          state = runtime_state
-          timeout = normalize_lifecycle_timeout(timeout, state)
-          validate_lifecycle_timeout!(timeout, name: :timeout)
-          increment_runtime_count(:close_attempts)
-          close_pipeline = !state.pipeline_closed
-          return CloseTransition.new(state, false, timeout) unless close_pipeline
-
-          @state_ref.set(state.closed)
-          CloseTransition.new(state, close_pipeline, timeout)
+        state = runtime_state
+        resolved_timeout = normalize_lifecycle_timeout(timeout, state)
+        validate_lifecycle_timeout!(resolved_timeout, name: :timeout)
+        increment_runtime_count(:close_attempts)
+        transition = nil
+
+        @state_ref.update do |current_state|
+          transition = unless current_state.pipeline_closed
+                         CloseTransition.new(
+                           current_state,
+                           normalize_lifecycle_timeout(timeout, current_state)
+                         )
+                       end
+          current_state.closed
         end
+        transition
       end
 
       def call_pipeline_lifecycle_on(pipeline, method_name, timeout:, state:)
@@ -341,8 +360,8 @@ module Julewire
         end
       end
 
-      def envelope_hash(value)
-        value.is_a?(Hash) ? value : {}
+      def envelope_hash(value, owned:)
+        value if owned || value.is_a?(Hash)
       end
 
       def record_post_close_emit(state)
@@ -370,48 +389,48 @@ module Julewire
       end
 
       def pipeline_degraded?(pipeline_health)
-        return true if pipeline_health[:status] && pipeline_health[:status] != :ok
+        return true if degraded_health?(pipeline_health)
 
         pipeline_health.fetch(:destinations).values.any? do |destination_health|
-          destination_health[:status] && destination_health[:status] != :ok
+          degraded_health?(destination_health)
         end
       end
 
       def integrations_degraded?(integrations)
         integrations.values.any? do |integration_health|
-          integration_health[:status] && integration_health[:status] != :ok
+          degraded_health?(integration_health)
         end
       end
 
+      def degraded_health?(health)
+        status = health[:status]
+        status && !status.equal?(:ok)
+      end
+
       def clear_runtime_degradation_if_unchanged(marker)
         @runtime_health.clear_degradation_if_unchanged(marker)
       end
 
       def summary_finalizer_failure
-        @summary_finalizer_failure ||= ->(error) { handle_summary_finalizer_failure(error) }
+        @summary_finalizer_failure ||= ->(error, **metadata) { handle_summary_finalizer_failure(error, **metadata) }
       end
 
       def reset_after_fork_state!
-        state = runtime_state
-        @configure_mutex = Mutex.new
-        @configure_generation = Concurrent::AtomicFixnum.new(0)
-        @state_mutex = Mutex.new
-        @post_close_emit_count = Concurrent::AtomicFixnum.new(0)
+        @post_close_emit_count.value = 0
         @runtime_health = build_runtime_health
-        @integration_health.after_fork!
-        @invalid_severity_reporter.reset_after_fork!
-        @state_ref = Concurrent::AtomicReference.new(state)
-        nil
+        @integration_health.reset!
+        @invalid_severity_reporter.reset!
       end
 
       def reset_under_lock
         state = runtime_state
         configuration = Configuration.new.snapshot
         @invalid_severity_reporter.reset!
-        next_pipeline = configuration.build_pipeline(invalid_severity_reporter: @invalid_severity_reporter)
-        replace_pipeline(configuration, next_pipeline)
-        ContextStore.reset_current!
+        next_pipeline = configuration.build_pipeline
+        next_state = state.next_generation(configuration: configuration, pipeline: next_pipeline)
+        state = @state_ref.get_and_set(next_state)
         @post_close_emit_count.value = 0
+        ContextStore.reset_current!
         @runtime_health.clear_failures!
         @integration_health.reset!
         Diagnostics::ProcessIntegrationHealth.reset!
@@ -429,12 +448,12 @@ module Julewire
           raise Error, "Julewire.#{method_name} cannot be called from inside Julewire.configure"
         end
 
-        block_given? ? yield : nil
+        yield if block_given?
       end
 
       def configure_guard_active?
         token = Fiber[CONFIGURE_GUARD_KEY]
-        token.is_a?(Array) && token.fetch(0) == object_id && token.fetch(1) == @configure_generation.value
+        token.instance_of?(Array) && token.fetch(0) == object_id && token.fetch(1) == @configure_generation.value
       end
 
       def increment_lifecycle_attempt(method_name)
@@ -457,9 +476,8 @@ module Julewire
         @runtime_health.record_failure(error, callback: state.configuration.on_failure, **metadata)
       end
 
-      def handle_summary_finalizer_failure(error)
+      def handle_summary_finalizer_failure(error, **metadata)
         state = runtime_state
-        metadata = { phase: :summary_finalizer }
         @runtime_health.record_failure(error, callback: state.configuration.on_failure, **metadata)
       end
 
@@ -484,8 +502,6 @@ module Julewire
       end
 
       def notify_lifecycle_warning(warning)
-        return unless warning
-
         result = Diagnostics::CallbackNotifier.call(warning.fetch(:on_failure), warning.fetch(:error),
                                                     warning.fetch(:metadata))
         @runtime_health.record_callback_failure(result) if Diagnostics::CallbackNotifier.failure?(result)
@@ -494,7 +510,6 @@ module Julewire
       def build_runtime_health
         Diagnostics::Health.new(
           counter_keys: RUNTIME_COUNTER_KEYS,
-          callback_metadata: {},
           callback_failure_counter: :runtime_callback_failures,
           failure_counter: :runtime_failures
         )

data/lib/julewire/core/runtime_registry.rb

@@ -1,13 +1,15 @@
 # frozen_string_literal: true
 
+require "concurrent/atomic/atomic_reference"
+
 module Julewire
   module Core
     module RuntimeRegistry
       DEFAULT_NAME = :default
-      private_constant :DEFAULT_NAME
+      EMPTY_RUNTIMES = {}.freeze
+      private_constant :DEFAULT_NAME, :EMPTY_RUNTIMES
 
-      @mutex = Mutex.new
-      @runtimes = {}
+      @runtimes = Concurrent::AtomicReference.new(EMPTY_RUNTIMES)
 
       class << self
         def fetch(name, current: RuntimeLocator.current)
@@ -18,29 +20,32 @@ module Julewire
             raise Error, "named Julewire runtimes are not available from the current runtime"
           end
 
-          @mutex.synchronize { @runtimes[name] ||= Runtime.new }
+          @runtimes.update do |runtimes|
+            if runtimes.key?(name)
+              runtimes
+            else
+              runtimes.merge(name => Runtime.new)
+            end
+          end.fetch(name)
         end
 
-        def clear!
-          @mutex.synchronize { @runtimes.clear }
+        def reset(primary:)
+          runtimes = @runtimes.get_and_set(EMPTY_RUNTIMES).values
+
+          primary.reset!
+          runtimes.each(&:reset!)
           nil
         end
 
         def reset_after_fork(primary:)
-          # Post-fork execution is single-threaded; do not touch inherited locks
-          # before rebuilding them.
-          runtimes = ([primary] + @runtimes.values).uniq
-          @mutex = Mutex.new
+          runtimes = [primary] + @runtimes.get.values
 
-          LocalStorage.after_fork!
           ContextStore.reset_current!
           Scheduling::SharedScheduler.after_fork!
-          Diagnostics::ProcessIntegrationHealth.after_fork!
-          Integration::ForkHooks.after_fork!
-          Diagnostics::InvalidSeverityReporter.reset_after_fork!
+          Diagnostics::ProcessIntegrationHealth.reset!
+          Diagnostics::InvalidSeverityReporter.reset!
           runtimes.each(&:reset_after_fork_runtime!)
           Integration::ForkHooks.run
-          nil
         end
       end
     end

data/lib/julewire/core/runtime_state.rb

@@ -7,11 +7,13 @@ module Julewire
       :pipeline,
       :pipeline_closed,
       :pipeline_generation
-    ) do
+    )
+
+    class RuntimeState
       class << self
-        def default(invalid_severity_reporter: Diagnostics::InvalidSeverityReporter.counter)
+        def default
           configuration = Configuration.new.snapshot
-          pipeline = configuration.build_pipeline(invalid_severity_reporter: invalid_severity_reporter)
+          pipeline = configuration.build_pipeline
 
           new(
             configuration: configuration,

data/lib/julewire/core/scheduling/shared_scheduler.rb

@@ -1,47 +1,53 @@
 # frozen_string_literal: true
 
+require "concurrent/executor/thread_pool_executor"
+require "concurrent/executor/timer_set"
+
 module Julewire
   module Core
     module Scheduling
       module SharedScheduler
         THREAD_NAME = "julewire-deadline-scheduler"
-
-        @mutex = Mutex.new
+        EXECUTOR_OPTIONS = { max_threads: 1, idletime: 0 }.freeze
+        private_constant :EXECUTOR_OPTIONS
 
         class << self
-          def schedule(timeout, &)
-            current = scheduler
-            current.schedule(timeout, &)
-          end
+          def schedule(timeout, &block)
+            raise ArgumentError, "block required" unless block
 
-          def cancel(token)
-            current = scheduler
-            current.cancel(token)
+            timeout = Float(timeout)
+            if timeout <= 0
+              yield
+              return
+            end
+
+            @scheduler.post(timeout) do
+              Thread.current.name = THREAD_NAME
+              yield
+            end
           end
 
-          def after_fork!
-            current = @scheduler
-            @mutex = Mutex.new
-            current&.after_fork!
+          def cancel(task)
+            task&.cancel
             nil
           end
 
-          # Private testing seam for isolating process-wide scheduler state.
-          def reset_for_test!
-            @mutex.synchronize { @scheduler = nil }
+          def after_fork!
+            previous = @scheduler
+            @scheduler = build_scheduler
+            previous.kill
             nil
           end
 
           private
 
-          private :reset_for_test!
-
-          def scheduler
-            @mutex.synchronize do
-              @scheduler ||= DeadlineScheduler.new(thread_name: THREAD_NAME)
-            end
+          def build_scheduler
+            executor = Concurrent::ThreadPoolExecutor.new(**EXECUTOR_OPTIONS)
+            Concurrent::TimerSet.new(executor: executor)
           end
         end
+
+        @scheduler = build_scheduler
       end
     end
   end