lex-node 0.3.4 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1ec7edd1a4b098a60538b0832c7b53f97149a26e805a6a391a724f070f1bfdb
-  data.tar.gz: 4ecb9b8cd149e2472e78031558b2bf476b0cf44d18e8af31a97e867a0cff7219
+  metadata.gz: dc51c7fec2b526f23237c3c8da1c8457f7b10250ad7606a3d519049675025cc5
+  data.tar.gz: a0f8d664fdd16a3d16d64a948e3dfe2e8c27935251f1be5ffeef3bac21042220
 SHA512:
-  metadata.gz: c1d8fa3687ff0498a7722f1a2905e660d88dba42f8eed4cfefc06ece9779d74f6cbe3490164c624909658d85a3187c289c6e721d68f9a7a49b3d0792cd02b9b1
-  data.tar.gz: 7c880bcd2c21b10212ff8202fb63b7f6dbd339a17a0373c9c9b6c85e02af4c6b21127f4e0fb504c1599e384169dc49e139051af7bc28bfb097d4995bcd131d20
+  metadata.gz: fd71f5b8d3152d625af005aef5add980d90548d6299bf7f6afd93b69585941b69c37b29ecc882d9325a0075d0fc60b744c9080305e2375350714f3a8cfcb52ba
+  data.tar.gz: c127f5a0b891e70df65b4639588a628596c8207ec31a21529bee8f39117c4cbf36b4d202d27b2619224e815035291bd8c8b81015f1a369071ff1041a8339d770

data/.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# Auto-generated from team-config.yml
+# Team: extensions
+#
+# To apply: scripts/apply-codeowners.sh lex-node
+
+* @LegionIO/maintainers
+* @LegionIO/extensions

data/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - "type:dependencies"
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - "type:dependencies"

data/.github/workflows/ci.yml

@@ -10,8 +10,8 @@ jobs:
   ci:
     uses: LegionIO/.github/.github/workflows/ci.yml@main
 
-  lint:
-    uses: LegionIO/.github/.github/workflows/lint-patterns.yml@main
+  excluded-files:
+    uses: LegionIO/.github/.github/workflows/excluded-files.yml@main
 
   security:
     uses: LegionIO/.github/.github/workflows/security-scan.yml@main
@@ -27,8 +27,8 @@ jobs:
     uses: LegionIO/.github/.github/workflows/stale.yml@main
 
   release:
-    needs: [ci, lint]
+    needs: [ci, excluded-files]
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     uses: LegionIO/.github/.github/workflows/release.yml@main
     secrets:
-      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.rubocop.yml

@@ -1,50 +1,2 @@
-AllCops:
-  TargetRubyVersion: 3.4
-  NewCops: enable
-  SuggestExtensions: false
-
-Layout/LineLength:
-  Max: 160
-
-Layout/SpaceAroundEqualsInParameterDefault:
-  EnforcedStyle: space
-
-Layout/HashAlignment:
-  EnforcedHashRocketStyle: table
-  EnforcedColonStyle: table
-
-Metrics/MethodLength:
-  Max: 50
-
-Metrics/ClassLength:
-  Max: 1500
-
-Metrics/ModuleLength:
-  Max: 1500
-
-Metrics/BlockLength:
-  Max: 40
-  Exclude:
-    - 'spec/**/*'
-
-Metrics/AbcSize:
-  Max: 60
-
-Metrics/CyclomaticComplexity:
-  Max: 15
-
-Metrics/PerceivedComplexity:
-  Max: 17
-
-Style/Documentation:
-  Enabled: false
-
-Style/SymbolArray:
-  Enabled: true
-
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always
-
-Naming/FileName:
-  Enabled: false
+inherit_gem:
+  rubocop-legion: config/lex.yml

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # 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
+- update to rubocop-legion 0.1.7, resolve all offenses
+
 ## [Unreleased]
 
 ### Added

data/CLAUDE.md

@@ -10,7 +10,7 @@ Core Legion Extension responsible for node identity within a LegionIO cluster. H
 
 **GitHub**: https://github.com/LegionIO/lex-node
 **License**: MIT
-**Version**: 0.3.2
+**Version**: 0.3.4
 
 ## Architecture
 
@@ -57,7 +57,9 @@ Legion::Extensions::Node
         ├── 001_nodes_table          # Core nodes table
         ├── 002_node_history_table   # Node activity history
         ├── 003_legion_version_colume # Legion version column (note: typo in filename)
-        └── 004_node_extensions      # Installed extensions per node
+        ├── 004_node_extensions      # Installed extensions per node
+        ├── 005_add_slow_query_indexes # Composite index on (status, active, updated)
+        └── 006_add_nodes_created_index # Indexes on created, updated, composite (status, active, created)
 ```
 
 ## Key Files

data/Gemfile

@@ -8,5 +8,6 @@ group :test do
   gem 'rspec'
   gem 'rspec_junit_formatter'
   gem 'rubocop'
+  gem 'rubocop-legion', '~> 0.1', require: false
   gem 'simplecov'
 end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Node
       module Actor
-        class Beat < Legion::Extensions::Actors::Every
+        class Beat < Legion::Extensions::Actors::Every # rubocop:disable Legion/Extension/EveryActorRequiresTime
           def runner_function
             'beat'
           end

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/helpers/rabbitmq.rb

@@ -20,7 +20,7 @@ module Legion
               shovel_links:   fetch_shovel_links(http, settings)
             }
           rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, SocketError, Net::OpenTimeout, Net::ReadTimeout => e
-            log_warn("RabbitMQ management API unreachable: #{e.message}")
+            log.warn("RabbitMQ management API unreachable: #{e.message}")
             { node_count: unreachable, quorum_leaders: unreachable, shovel_links: unreachable }
           end
 
@@ -66,7 +66,7 @@ module Legion
                         (running == total ? 'ok' : 'warn')
                       end
             { status: status, total: total, running: running }
-          rescue StandardError
+          rescue StandardError => _e
             { status: 'ok', total: 0, running: 0 }
           end
 
@@ -89,7 +89,7 @@ module Legion
             return nil unless response.code.start_with?('2')
 
             ::JSON.parse(response.body)
-          rescue StandardError
+          rescue StandardError => _e
             nil
           end
 
@@ -115,11 +115,7 @@ module Legion
           end
 
           def log_warn(msg)
-            if defined?(Legion::Logging)
-              Legion::Logging.warn { msg }
-            elsif defined?(Legion::Transport) && Legion::Transport.respond_to?(:logger)
-              Legion::Transport.logger.warn(msg)
-            end
+            log.warn(msg)
           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/beat.rb

@@ -63,7 +63,7 @@ module Legion
               else
                 File.read("/proc/#{::Process.pid}/statm").split[1].to_i * (4096.0 / 1_048_576)
               end
-            rescue StandardError
+            rescue StandardError => _e
               0.0
             end
 
@@ -89,7 +89,7 @@ module Legion
               return [] unless defined?(Legion::DigitalWorker)
 
               Legion::DigitalWorker.active_local_ids
-            rescue StandardError
+            rescue StandardError => _e
               []
             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.4'
+      VERSION = '0.3.6'
     end
   end
 end

data/lib/legion/extensions/node.rb

@@ -6,7 +6,7 @@ require 'legion/extensions/node/helpers/rabbitmq'
 module Legion
   module Extensions
     module Node
-      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core
+      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core, false
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-node
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.6
 platform: ruby
 authors:
 - Esity
@@ -129,6 +129,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/CODEOWNERS"
+- ".github/dependabot.yml"
 - ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
@@ -143,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
@@ -158,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
@@ -167,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