lex-node 0.3.5 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7ac92f5ed3cc4292a84de4981df2552a8b26c530ef8e0a8bbd496a6358d6145
-  data.tar.gz: 6e1e6f020a74ff9f8850e8d1949e4d1e55a2dfdf874a1eb1be41749318f7eb70
+  metadata.gz: dc51c7fec2b526f23237c3c8da1c8457f7b10250ad7606a3d519049675025cc5
+  data.tar.gz: a0f8d664fdd16a3d16d64a948e3dfe2e8c27935251f1be5ffeef3bac21042220
 SHA512:
-  metadata.gz: 9e7c9b1ad53d742abe5c44e4c49d4ea42ac142f4e55716b1cbb27ec3b61e7a7cc1f686fca6533be8f7b48c0d150cc1bf11b922f36dfbf3df2b02de2bc57b9638
-  data.tar.gz: 4c63293aca829c8f862de742eb73b47c84486a361f813a34cb7aba2012027734fcdfbb96731dfd04ad1e4694660654c47f552398ef5cdf23644bab5516890212
+  metadata.gz: fd71f5b8d3152d625af005aef5add980d90548d6299bf7f6afd93b69585941b69c37b29ecc882d9325a0075d0fc60b744c9080305e2375350714f3a8cfcb52ba
+  data.tar.gz: c127f5a0b891e70df65b4639588a628596c8207ec31a21529bee8f39117c4cbf36b4d202d27b2619224e815035291bd8c8b81015f1a369071ff1041a8339d770

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.3.6] - 2026-03-31
+
+### Added
+- `legion.cluster.control` topic exchange for cluster-wide broadcast (durable, topic type)
+- Per-node auto-delete queue `legion.cluster.control.<name>` bound to the exchange on boot
+- `ClusterSettings` message: publishes settings changes with configurable routing key to the cluster control exchange
+- `ClusterKillswitch` message: publishes emergency extension block via routing key `settings.extensions.blocked`
+- `ClusterControl` subscription actor: subscribes to the per-node cluster control queue, routes to existing runners by routing key
+- `Runners::Node#broadcast_settings(settings:, routing_key: 'settings', restart: false)`: sends settings to all nodes via the cluster control exchange
+- `Runners::Node#killswitch(extension:)`: blocks an extension cluster-wide with immediate reload
+- 51 new specs covering all new components (162 total, 0 failures)
+
 ## [0.3.5] - 2026-03-30
 
 ### Changed

data/lib/legion/extensions/node/actors/cluster_control.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Node
+      module Actor
+        class ClusterControl < Legion::Extensions::Actors::Subscription
+          def runner_class
+            Legion::Extensions::Node::Runners::Node
+          end
+
+          def queue_class
+            Legion::Extensions::Node::Transport::Queues::ClusterControl
+          end
+
+          def disabled?
+            false
+          end
+
+          def use_runner?
+            true
+          end
+
+          def check_subtask?
+            false
+          end
+
+          def generate_task?
+            false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/node/runners/node.rb

@@ -120,6 +120,30 @@ module Legion
                                                                          public_key: public_key)
           end
 
+          def broadcast_settings(settings:, routing_key: 'settings', restart: false, **_opts)
+            log.debug "broadcast_settings: routing_key=#{routing_key} keys=#{settings.keys.join(', ')}"
+            Legion::Extensions::Node::Transport::Messages::ClusterSettings.new(
+              settings:    settings,
+              routing_key: routing_key,
+              restart:     restart
+            ).publish
+            {}
+          rescue StandardError => e
+            log.error "broadcast_settings failed: #{e.message}"
+            {}
+          end
+
+          def killswitch(extension:, **_opts)
+            log.debug "killswitch: blocking extension #{extension} cluster-wide"
+            Legion::Extensions::Node::Transport::Messages::ClusterKillswitch.new(
+              extension: extension.to_s.delete_prefix('lex-')
+            ).publish
+            {}
+          rescue StandardError => e
+            log.error "killswitch failed: #{e.message}"
+            {}
+          end
+
           private
 
           def publish_update_result(action:, status:, detail: nil, error: nil)

data/lib/legion/extensions/node/transport/exchanges/cluster_control.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Node
+      module Transport
+        module Exchanges
+          class ClusterControl
+            EXCHANGE_NAME = 'legion.cluster.control'
+            EXCHANGE_TYPE = :topic
+            EXCHANGE_OPTIONS = { durable: true }.freeze
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/node/transport/messages/cluster_killswitch.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Node
+      module Transport
+        module Messages
+          class ClusterKillswitch < Legion::Transport::Message
+            ROUTING_KEY = 'settings.extensions.blocked'
+
+            def routing_key
+              ROUTING_KEY
+            end
+
+            def exchange
+              Legion::Extensions::Node::Transport::Exchanges::ClusterControl
+            end
+
+            def type
+              'task'
+            end
+
+            def encrypt?
+              false
+            end
+
+            def message
+              {
+                function: 'update_settings',
+                settings: { extensions: { blocked: [@options[:extension]] } },
+                restart:  true
+              }
+            end
+
+            def validate
+              raise 'extension must be a String' unless @options[:extension].is_a?(String)
+
+              @valid = true
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/node/transport/messages/cluster_settings.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Node
+      module Transport
+        module Messages
+          class ClusterSettings < Legion::Transport::Message
+            def routing_key
+              @options.fetch(:routing_key, 'settings')
+            end
+
+            def exchange
+              Legion::Extensions::Node::Transport::Exchanges::ClusterControl
+            end
+
+            def type
+              'task'
+            end
+
+            def encrypt?
+              false
+            end
+
+            def message
+              {
+                function: 'update_settings',
+                settings: @options[:settings],
+                restart:  @options.fetch(:restart, false)
+              }
+            end
+
+            def validate
+              raise 'settings must be a Hash' unless @options[:settings].is_a?(Hash)
+
+              @valid = true
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/node/transport/queues/cluster_control.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Node
+      module Transport
+        module Queues
+          class ClusterControl < Legion::Transport::Queue
+            def queue_name
+              "legion.cluster.control.#{Legion::Settings[:client][:name]}"
+            end
+
+            def queue_options
+              { durable: false, exclusive: false, auto_delete: true,
+                arguments: { 'x-queue-type': 'classic' } }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/node/transport.rb

@@ -13,6 +13,7 @@ module Legion
           array.push(from: 'node', to: 'node', routing_key: 'node.data.#') if Legion::Settings[:data]&.[](:connected) || false
           array.push(from: 'node', to: 'node', routing_key: 'node.cache.#') if Legion::Settings[:cache]&.[](:connected) || false
           array.push(from: 'node', to: 'node', routing_key: 'node.crypt.#')
+          array.push(from: 'cluster_control', to: 'cluster_control', routing_key: '#')
           array
         end
       end

data/lib/legion/extensions/node/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Node
-      VERSION = '0.3.5'
+      VERSION = '0.3.6'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-node
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors:
 - Esity
@@ -145,6 +145,7 @@ files:
 - lex-node.gemspec
 - lib/legion/extensions/node.rb
 - lib/legion/extensions/node/actors/beat.rb
+- lib/legion/extensions/node/actors/cluster_control.rb
 - lib/legion/extensions/node/actors/crypt.rb
 - lib/legion/extensions/node/actors/push_key.rb
 - lib/legion/extensions/node/actors/vault.rb
@@ -160,8 +161,11 @@ files:
 - lib/legion/extensions/node/runners/node.rb
 - lib/legion/extensions/node/runners/vault.rb
 - lib/legion/extensions/node/transport.rb
+- lib/legion/extensions/node/transport/exchanges/cluster_control.rb
 - lib/legion/extensions/node/transport/exchanges/node.rb
 - lib/legion/extensions/node/transport/messages/beat.rb
+- lib/legion/extensions/node/transport/messages/cluster_killswitch.rb
+- lib/legion/extensions/node/transport/messages/cluster_settings.rb
 - lib/legion/extensions/node/transport/messages/public_key.rb
 - lib/legion/extensions/node/transport/messages/push_cluster_secret.rb
 - lib/legion/extensions/node/transport/messages/push_vault_token.rb
@@ -169,6 +173,7 @@ files:
 - lib/legion/extensions/node/transport/messages/request_public_keys.rb
 - lib/legion/extensions/node/transport/messages/request_vault_token.rb
 - lib/legion/extensions/node/transport/messages/update_result.rb
+- lib/legion/extensions/node/transport/queues/cluster_control.rb
 - lib/legion/extensions/node/transport/queues/crypt.rb
 - lib/legion/extensions/node/transport/queues/health.rb
 - lib/legion/extensions/node/transport/queues/node.rb