async-service-supervisor 0.10.1 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a442d07a68cfadfaf0a5a1e15e5ec7b0936580c74e6cc49b30997816b0e62b2
-  data.tar.gz: d275c9154c1e9cd9a8c37bee158b1121ebdbb0d78e4b86b2bead32f32d55e1f1
+  metadata.gz: 4c3d5a7d855b76ef324f1f7b30e7a4dc45155150b84bd1f9725511de1c0e689f
+  data.tar.gz: 7baf1593e4ddcfde54579aa00586fe2b5eff4fe3a6ed81da89a37d4da4831f3b
 SHA512:
-  metadata.gz: b47eb23e854c83816211f4385a6c88a8ace3b5e71512469a73c63968a2569c1288bb2cc68a6e0c2f0e874405477906d12839eefc07d83123fa5c6cf48e3c904e
-  data.tar.gz: f1831a15940111dce4550208f6d0047e21bd6fff32015f98c1aee44c650ea41fcf540707e509b84e7146ff2f3e18a08503c787699311fc0dd36a2a0806fadc7d
+  metadata.gz: 7c5ce6b4f95785d1fe6c90e704217f5d15a04cd7a8b5cd73ca8071a7359639bc0e2637bced931a5632bb6151b022cc3ce5bdf59e264c31dfe5ebc2705c8fb586
+  data.tar.gz: 9efb2ce0bd7214756f52bc333590b44d2c634296cf9dbd5ec328b8d6d5b8c3188f6b245719e2c925a335cf2016b9c33e0d10b2cb8b9ad020e1ee7108433cbce2

data/context/migration.md

@@ -309,3 +309,9 @@ The new approach provides:
 - Simpler ID management.
 - Better controller-based API.
 - More explicit worker lifecycle management.
+
+### Connection State Handling
+
+State has moved from `connection.state` to `supervisor_controller.state`. Monitors receive `supervisor_controller` objects instead of `connection` objects, and access state via `supervisor_controller.state[:name]` instead of `connection.state[:name]`.
+
+By default, the `Supervised` module automatically includes the service name in state via `supervisor_worker_state`. Override `supervisor_worker_state` in your service environment to customize the state.

data/lib/async/service/supervisor/supervised.rb

@@ -24,10 +24,16 @@ module Async
 					::IO::Endpoint.unix(supervisor_ipc_path)
 				end
 				
+				# The state to associate with the supervised worker.
+				# @returns [Hash]
+				def supervisor_worker_state
+					{name: self.name}
+				end
+				
 				# The supervised worker for the current process.
 				# @returns [Worker] The worker client.
 				def supervisor_worker
-					Worker.new(process_id: Process.pid, endpoint: supervisor_endpoint)
+					Worker.new(process_id: Process.pid, endpoint: supervisor_endpoint, state: self.supervisor_worker_state)
 				end
 				
 				# Create a supervised worker for the given instance.

data/lib/async/service/supervisor/supervisor_controller.rb

@@ -19,6 +19,7 @@ module Async
 					@id = nil
 					@process_id = nil
 					@worker = nil
+					@state = {}
 				end
 				
 				# @attribute [Server] The server instance.
@@ -36,6 +37,9 @@ module Async
 				# @attribute [Proxy] The proxy to the worker controller.
 				attr :worker
 				
+				# @attribute [Hash] State associated with this worker connection (e.g., service name).
+				attr_accessor :state
+				
 				# Register a worker connection with the supervisor.
 				#
 				# Allocates a unique sequential ID, stores the worker controller proxy,
@@ -43,13 +47,15 @@ module Async
 				#
 				# @parameter worker [Proxy] The proxy to the worker controller.
 				# @parameter process_id [Integer] The process ID of the worker.
+				# @parameter state [Hash] Optional state to associate with this worker (e.g., service name).
 				# @returns [Integer] The connection ID assigned to the worker.
-				def register(worker, process_id:)
+				def register(worker, process_id:, state: {})
 					raise RuntimeError, "Already registered" if @id
 					
 					@id = @server.next_id
 					@process_id = process_id
 					@worker = worker
+					@state.merge!(state)
 					
 					@server.add(self)
 					

data/lib/async/service/supervisor/version.rb

@@ -9,7 +9,7 @@ module Async
 	module Service
 		# @namespace
 		module Supervisor
-			VERSION = "0.10.1"
+			VERSION = "0.11.0"
 		end
 	end
 end

data/lib/async/service/supervisor/worker.rb

@@ -25,11 +25,13 @@ module Async
 				#
 				# @parameter process_id [Integer] The process ID to register with the supervisor.
 				# @parameter endpoint [IO::Endpoint] The supervisor endpoint to connect to.
-				def initialize(process_id: Process.pid, endpoint: Supervisor.endpoint)
+				# @parameter state [Hash] Optional state to associate with this worker (e.g., service name).
+				def initialize(process_id: Process.pid, endpoint: Supervisor.endpoint, state: {})
 					super(endpoint: endpoint)
 					
 					@id = nil
 					@process_id = process_id
+					@state = state
 				end
 				
 				# @attribute [Integer] The ID assigned by the supervisor.
@@ -38,6 +40,9 @@ module Async
 				# @attribute [Integer] The process ID of the worker.
 				attr :process_id
 				
+				# @attribute [Hash] State associated with this worker (e.g., service name).
+				attr_accessor :state
+				
 				protected def connected!(connection)
 					super
 					
@@ -49,10 +54,9 @@ module Async
 					# The supervisor allocates a unique ID and returns it
 					# This is a synchronous RPC call that will complete before returning
 					supervisor = connection[:supervisor]
-					@id = supervisor.register(worker_proxy, process_id: @process_id)
+					@id = supervisor.register(worker_proxy, process_id: @process_id, state: @state)
 				end
 			end
 		end
 	end
 end
-

data/readme.md

@@ -28,6 +28,12 @@ Please see the [project documentation](https://socketry.github.io/async-service-
 
 Please see the [project releases](https://socketry.github.io/async-service-supervisor/releases/index) for all releases.
 
+### v0.11.0
+
+  - Add `state` attribute to `SupervisorController` to store per-worker metadata (e.g., service name).
+  - Add `state` parameter to `Worker#initialize` to allow workers to provide state during registration.
+  - State is now accessible via `supervisor_controller.state` instead of `connection.state` (as it was in `Async::Container::Supervisor`).
+
 ### v0.10.0
 
   - Serialize `register`/`remove` and `check!` operations in `MemoryMonitor` to prevent race conditions.
@@ -71,10 +77,6 @@ Please see the [project releases](https://socketry.github.io/async-service-super
 
   - Add `async:container:supervisor:reload` command to restart the container (blue/green deployment).
 
-### v0.1.0
-
-  - Initial implementation.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,11 @@
 # Releases
 
+## v0.11.0
+
+  - Add `state` attribute to `SupervisorController` to store per-worker metadata (e.g., service name).
+  - Add `state` parameter to `Worker#initialize` to allow workers to provide state during registration.
+  - State is now accessible via `supervisor_controller.state` instead of `connection.state` (as it was in `Async::Container::Supervisor`).
+
 ## v0.10.0
 
   - Serialize `register`/`remove` and `check!` operations in `MemoryMonitor` to prevent race conditions.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-service-supervisor
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.11.0
 platform: ruby
 authors:
 - Samuel Williams