lex-node 0.3.1 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8bce7f974591cba97508bd1d4a9033315f4207050da3996f082438267c1de9c
-  data.tar.gz: 3af059ccb67edb50d52c749adbd8014cd29c9d75af4fa3b85c84c678a453301b
+  metadata.gz: fb28b6c1ef5c870a1498dee8b03b6490babb8933f1f50782f06f774fbcbeca83
+  data.tar.gz: 154f3a22cfef52b5d2b5a23af3b7f207dc76b81930774846e22097a4c0b7a0d8
 SHA512:
-  metadata.gz: 5dd82b1f0b200c50a7d4b3cedc639e73ad47b27335a8405182b6f2c1a9f6372930c51d1b3c52bcd0403198593d6b22679e989e83f944e75b28a59d86a19ce339
-  data.tar.gz: 5a3c3d9ffdccca307b9e8981b73f18021eabdfb2ee44167231b75290d7c8dd33fd2474e08db6ccb377eede6fb634e5274de5c558fe77aa914a9818a96c88ebc9
+  metadata.gz: 1977037030ef413f64fdc1b5ba330190bb588bff2e46cb8746297bd64e05f26740ae8c6e6829282f9a24f449fa43a5b4c0a939ac3a495231f00a885baf00163a
+  data.tar.gz: 9d3524a4ab76589fdc35fde36ad51294d61116ed86dc3fbe2f735d2d906a2b806ec029a8841f83a629cf81f16450d06cd5dc801b4a1a9f8fa923a7a8302d08fb

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.3.3] - 2026-03-22
+
+### Changed
+- Add legion-cache, legion-crypt, legion-data, legion-json, legion-logging, legion-settings, legion-transport as runtime dependencies
+- Update spec_helper with real sub-gem helper stubs (Legion::Logging::Helper, Legion::Settings::Helper, Legion::Cache::Helper, Legion::Crypt::Helper, Legion::Data::Helper, Legion::JSON::Helper, Legion::Transport::Helper)
+- Update specs to stub Legion::Crypt methods explicitly now that the real gem is loaded in tests
+- Update beat actor spec to stub `settings` at instance level for beat_interval lookup
+
+## [0.3.2] - 2026-03-21
+
+### Added
+- `Helpers::Rabbitmq` module: queries RabbitMQ Management API for cluster health metrics (node count, quorum queue leaders, shovel link status)
+- Beat heartbeat message now includes `rabbitmq_cluster` section with node count, quorum leaders, and shovel links
+- 15 new specs covering all Rabbitmq helper methods (111 total, 0 failures)
+
 ## [0.3.1] - 2026-03-19
 
 ### Fixed

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.0
+**Version**: 0.3.2
 
 ## Architecture
 
@@ -50,6 +50,8 @@ Legion::Extensions::Node
 │       ├── RequestVaultToken     # Request Vault token from peer
 │       ├── PushVaultToken        # Distribute encrypted Vault token
 │       └── UpdateResult          # Operation result (update_gem / update_settings outcomes)
+├── Helpers/
+│   └── Rabbitmq          # RabbitMQ Management API cluster health (node count, quorum leaders, shovel links)
 └── DataTest/
     └── Migrations/
         ├── 001_nodes_table          # Core nodes table
@@ -67,7 +69,8 @@ Legion::Extensions::Node
 | `lib/legion/extensions/node/runners/crypt.rb` | RSA keypair and cluster secret exchange |
 | `lib/legion/extensions/node/runners/node.rb` | Dynamic config distribution, update_settings, update_gem, public key relay |
 | `lib/legion/extensions/node/runners/vault.rb` | Vault token request/receive/push lifecycle |
-| `lib/legion/extensions/node/transport/messages/beat.rb` | Heartbeat message (routing_key: 'status', TTL 5s) with resource metrics, hosted worker IDs, and Legion version |
+| `lib/legion/extensions/node/helpers/rabbitmq.rb` | RabbitMQ Management API cluster health helper (node count, quorum leaders, shovel links) |
+| `lib/legion/extensions/node/transport/messages/beat.rb` | Heartbeat message (routing_key: 'status', TTL 5s) with resource metrics, hosted worker IDs, RabbitMQ cluster health, and Legion version |
 | `lib/legion/extensions/node/transport/messages/update_result.rb` | Operation result message for update_gem/update_settings |
 | `lib/legion/extensions/node/transport/messages/` | All node-to-node message types |
 | `lib/legion/extensions/node/transport/queues/node.rb` | Per-node queue (exclusive, auto-delete, classic type) |

data/README.md

@@ -2,7 +2,7 @@
 
 Node identity and cluster management for [LegionIO](https://github.com/LegionIO/LegionIO). Handles heartbeat broadcasting, dynamic configuration distribution, cluster secret exchange, Vault token management, and RSA public key distribution between nodes.
 
-**Version**: 0.3.0
+**Version**: 0.3.2
 
 This is a core LEX installed by default with LegionIO.
 

data/lex-node.gemspec

@@ -27,4 +27,11 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'base64'
+  spec.add_dependency 'legion-cache',     '>= 1.3.11'
+  spec.add_dependency 'legion-crypt',     '>= 1.4.9'
+  spec.add_dependency 'legion-data',      '>= 1.4.17'
+  spec.add_dependency 'legion-json',      '>= 1.2.1'
+  spec.add_dependency 'legion-logging',   '>= 1.3.2'
+  spec.add_dependency 'legion-settings',  '>= 1.3.14'
+  spec.add_dependency 'legion-transport', '>= 1.3.9'
 end

data/lib/legion/extensions/node/helpers/rabbitmq.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module Legion
+  module Extensions
+    module Node
+      module Helpers
+        module Rabbitmq
+          module_function
+
+          def cluster_health(settings: nil)
+            settings ||= resolve_settings
+            http = build_http(settings)
+            {
+              node_count:     fetch_node_count(http, settings),
+              quorum_leaders: fetch_quorum_leaders(http, settings),
+              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}")
+            { node_count: unreachable, quorum_leaders: unreachable, shovel_links: unreachable }
+          end
+
+          def fetch_node_count(http, settings)
+            body = api_get(http, '/api/nodes', settings)
+            return unreachable unless body
+
+            running = body.count { |n| n['running'] }
+            total   = body.size
+            status  = if running == total
+                        'ok'
+                      else
+                        (running.positive? ? 'warn' : 'critical')
+                      end
+            { status: status, running: running, total: total }
+          end
+
+          def fetch_quorum_leaders(http, settings)
+            vhost = settings.dig(:connection, :vhost) || '/'
+            encoded_vhost = URI.encode_www_form_component(vhost)
+            body = api_get(http, "/api/queues/#{encoded_vhost}", settings)
+            return unreachable unless body
+
+            quorum_queues = body.select { |q| q['type'] == 'quorum' }
+            return { status: 'ok', quorum_queues: 0, leaders_on_this_node: 0 } if quorum_queues.empty?
+
+            node_name = resolve_node_name(http, settings)
+            leaders_here = quorum_queues.count { |q| q['leader'] == node_name }
+            { status: 'ok', quorum_queues: quorum_queues.size, leaders_on_this_node: leaders_here }
+          end
+
+          def fetch_shovel_links(http, settings)
+            vhost = settings.dig(:connection, :vhost) || '/'
+            encoded_vhost = URI.encode_www_form_component(vhost)
+            body = api_get(http, "/api/shovels/#{encoded_vhost}", settings)
+            return unreachable unless body
+
+            running = body.count { |s| s['state'] == 'running' }
+            total   = body.size
+            status  = if total.zero?
+                        'ok'
+                      else
+                        (running == total ? 'ok' : 'warn')
+                      end
+            { status: status, total: total, running: running }
+          rescue StandardError
+            { status: 'ok', total: 0, running: 0 }
+          end
+
+          def build_http(settings)
+            host = settings.dig(:connection, :host) || '127.0.0.1'
+            port = settings[:management_port] || 15_672
+            http = Net::HTTP.new(host, port)
+            http.open_timeout = 3
+            http.read_timeout = 5
+            http
+          end
+
+          def api_get(http, path, settings)
+            req = Net::HTTP::Get.new(path)
+            req.basic_auth(
+              settings.dig(:connection, :user) || 'guest',
+              settings.dig(:connection, :password) || 'guest'
+            )
+            response = http.request(req)
+            return nil unless response.code.start_with?('2')
+
+            ::JSON.parse(response.body)
+          rescue StandardError
+            nil
+          end
+
+          def resolve_node_name(http, settings)
+            body = api_get(http, '/api/whoami', settings)
+            return nil unless body
+
+            nodes = api_get(http, '/api/nodes', settings)
+            return nil unless nodes
+
+            nodes.first&.dig('name')
+          end
+
+          def resolve_settings
+            return Legion::Settings[:transport].to_h if defined?(Legion::Settings) && Legion::Settings.respond_to?(:[])
+
+            { connection:      { host: '127.0.0.1', user: 'guest', password: 'guest', vhost: '/' },
+              management_port: 15_672 }
+          end
+
+          def unreachable
+            { status: 'unknown', detail: 'management api unreachable' }
+          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
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -33,6 +33,7 @@ module Legion
               hash[:version] = Legion::VERSION if defined?(Legion::VERSION)
               hash[:metrics] = collect_metrics
               hash[:hosted_worker_ids] = collect_worker_ids
+              hash[:rabbitmq_cluster] = collect_rabbitmq_cluster
               hash
             end
 
@@ -76,6 +77,14 @@ module Legion
               (::Process.clock_gettime(::Process::CLOCK_MONOTONIC) - BOOT_TIME).round(0)
             end
 
+            def collect_rabbitmq_cluster
+              return { status: 'unknown', detail: 'helper not loaded' } unless defined?(Legion::Extensions::Node::Helpers::Rabbitmq)
+
+              Legion::Extensions::Node::Helpers::Rabbitmq.cluster_health
+            rescue StandardError => e
+              { status: 'unknown', detail: e.message }
+            end
+
             def collect_worker_ids
               return [] unless defined?(Legion::DigitalWorker)
 

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

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Node
-      VERSION = '0.3.1'
+      VERSION = '0.3.3'
     end
   end
 end

data/lib/legion/extensions/node.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/node/version'
+require 'legion/extensions/node/helpers/rabbitmq'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-node
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.3
 platform: ruby
 authors:
 - Esity
@@ -23,6 +23,104 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: legion-cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: legion-crypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+- !ruby/object:Gem::Dependency
+  name: legion-json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: legion-logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: legion-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
 description: This lex is responsible for sending heartbeats, allowing for dynamic
   config, cluster secret, etc
 email:
@@ -53,6 +151,7 @@ files:
 - lib/legion/extensions/node/data_test/migrations/002_node_history_table.rb
 - lib/legion/extensions/node/data_test/migrations/003_legion_version_colume.rb
 - lib/legion/extensions/node/data_test/migrations/004_node_extensions.rb
+- lib/legion/extensions/node/helpers/rabbitmq.rb
 - lib/legion/extensions/node/runners/beat.rb
 - lib/legion/extensions/node/runners/node.rb
 - lib/legion/extensions/node/runners/vault.rb