julewire-ractor 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d166b07720f0d37eb7b80d8bc7c3e5bcc3b00c83c14f2ce991e5931bbf0272b
-  data.tar.gz: 89bcff708f1fd8c0a22843ce4c74a8e49d99f39bed8f82f328d0115ba20216e9
+  metadata.gz: 3d42c3786d7b68451c4353ca8305bc41e5620b5003236ddc89c3707cf2727971
+  data.tar.gz: 0225ef575874b54b8bd457f82bf6531821dfe137228dc32de2888d360d1b154b
 SHA512:
-  metadata.gz: 91bd26a0399339393e0c075ae1752180ae058b449af0563b4a044073d62f5506b86dca06b6e649cc50c024a9a289bc0ca2142aea51a703fc349e45e196d0a893
-  data.tar.gz: 12dc746f9b15eeadc5c26f3566f83e042317632fee4fbed5281265a0f9ace8ce20ced5e1605d8a425158bcaf71de2b9ee985b8c8977766cbaf6101da128c486b
+  metadata.gz: 94b40f17f489ae6749d27f2ed459317eca174c35d7c952d9b7bd5b207ce6d26ac63220d0f8fb0cc56600eca80d48a69278b159d1d625455ff5703e6afffc5d28
+  data.tar.gz: 31a6e2729f9db688b42a61c3cdb859777ca70d625a1096bd259de32f8da8f793b75774207d0e3ac16e5efd874cdfb94f9ca461b43099fea657e6b2f4e3ad4d09

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## Unreleased
 
+## 1.0.1 - 2026-06-25
+
+- Reserve ractor destination queue slots before send and roll them back on
+  send failure.
+- Count impossible queue-slot over-release events for destination health
+  debugging.
+- Require julewire-core 1.0.1.
+
 ## 1.0.0 - 2026-06-21
 
 - Initial release: Ruby 4 ractor bridge, child-runtime forwarding, remote

data/docs/bridge.md

@@ -32,8 +32,9 @@ identity or class.
 The serialized envelope is a ractor concern. Core keeps only the narrow
 `emit_envelope` hook that accepts already-extracted input, context, carry, and
 a scope snapshot. Payload parsing and scope reconstruction stay in this gem.
-That hook is parent-runtime SPI; the child `RemoteRuntime` exposes the normal
-facade emit methods instead of a detached-envelope API.
+That hook is parent-runtime SPI; the bridge marks ractor wire data as owned, and
+the child `RemoteRuntime` exposes the normal facade emit methods instead of a
+detached-envelope API.
 
 ## Available in Child
 

data/julewire-ractor.gemspec

@@ -32,6 +32,6 @@ Gem::Specification.new do |spec|
   spec.executables = []
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "julewire-core", ">= 1.0"
+  spec.add_dependency "julewire-core", ">= 1.0.1"
   spec.add_dependency "zeitwerk", ">= 2.8.1"
 end

data/lib/julewire/ractor/bridge.rb

@@ -70,7 +70,7 @@ module Julewire
             Julewire::Core::RuntimeLocator.current = Julewire::Ractor::RemoteRuntime.new(
               port: bridge_port, emit_non_standard_exception_summaries: emit_non_standard_summaries
             )
-            Julewire::Core::Propagation.restore(captured_envelope) do
+            Julewire::Core::Propagation.restore(captured_envelope, owned: true) do
               callable.call(*call_args)
             end
           ensure
@@ -113,7 +113,7 @@ module Julewire
           payload = RemotePayload.hash_value(message, :payload)
           arguments = RemotePayload.extract(payload)
           arguments[:enforce_level] = false unless enforce_level
-          runtime.emit_envelope(**arguments)
+          runtime.emit_envelope(**arguments, owned: true)
         end
 
         def reply_to(message, response)

data/lib/julewire/ractor/destination.rb

@@ -12,6 +12,7 @@ module Julewire
         queued
         received
         send_error
+        slot_underflow_ignored
         worker_accepted
         worker_dropped
       ].freeze
@@ -58,15 +59,17 @@ module Julewire
       def emit(record)
         increment(:received)
         return drop(:closed_dropped, record) if closed?
-        return drop(:queue_full_dropped, record) if queue_full?
+        return drop(:queue_full_dropped, record) unless reserve_slot
 
-        @port.send({ command: :emit, record: record })
-        @in_flight.increment
-        increment(:queued)
+        begin
+          @port.send({ command: :emit, record: record })
+          increment(:queued)
+        rescue StandardError => e
+          release_slot
+          record_failure(e, phase: :ractor_send)
+          drop(:send_error, record)
+        end
         nil
-      rescue StandardError => e
-        record_failure(e, phase: :ractor_send)
-        drop(:send_error, record)
       end
 
       def flush(timeout: nil)
@@ -227,8 +230,16 @@ module Julewire
         PortLifecycle.close(timeout_port) if defined?(timeout_port) && timeout_port
       end
 
-      def queue_full?
-        @max_queue.positive? && @in_flight.value >= @max_queue
+      def reserve_slot
+        return true unless @max_queue.positive?
+
+        # MRI normally settles this in one pass under the GVL; the CAS loop keeps
+        # the reservation honest when multiple emitters race.
+        loop do
+          current = @in_flight.value
+          return false if current >= @max_queue
+          return true if @in_flight.compare_and_set(current, current + 1)
+        end
       end
 
       def closed? = @closed.get
@@ -269,8 +280,23 @@ module Julewire
         nil
       end
 
+      def release_slot
+        return unless @max_queue.positive?
+
+        loop do
+          current = @in_flight.value
+          if current <= 0
+            # Late or duplicate ACKs can arrive after teardown/reset; keep them visible
+            # without treating the ignored underflow as an operator-facing defect.
+            increment(:slot_underflow_ignored)
+            return
+          end
+          return if @in_flight.compare_and_set(current, current - 1)
+        end
+      end
+
       def decrement_in_flight
-        @in_flight.decrement if @in_flight.value.positive?
+        release_slot
       end
 
       def increment(key)

data/lib/julewire/ractor/remote_payload.rb

@@ -20,7 +20,10 @@ module Julewire
 
         def input_value(payload)
           value = Core::Integration::Values::Read.hash_value(payload, :input, default: MISSING)
-          value.equal?(MISSING) ? {} : value
+          return {} if value.equal?(MISSING)
+          return Core::Fields::FieldSet.deep_symbolize_owned_keys(value) if value.is_a?(Hash)
+
+          value
         end
 
         def scope_snapshot(scope_payload)
@@ -35,7 +38,7 @@ module Julewire
 
         def hash_value(hash, key)
           value = Core::Integration::Values::Read.hash_value(hash, key)
-          value.is_a?(Hash) ? Core::Fields::FieldSet.deep_symbolize_keys(value) : {}
+          value.is_a?(Hash) ? Core::Fields::FieldSet.deep_symbolize_owned_keys(value) : {}
         end
       end
     end

data/lib/julewire/ractor/remote_summary_record.rb

@@ -8,7 +8,7 @@ module Julewire
       end
 
       def owned_summary_record_input
-        @owned_summary_record_input ||= Core::Fields::FieldSet.deep_symbolize_keys(@record)
+        @owned_summary_record_input ||= Core::Fields::FieldSet.deep_symbolize_owned_keys(@record)
       end
     end
   end

data/lib/julewire/ractor/version.rb

@@ -2,6 +2,6 @@
 
 module Julewire
   module Ractor
-    VERSION = "1.0.0"
+    VERSION = "1.0.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: julewire-ractor
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Alexander Grebennik
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.0.1
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement