legionio 1.5.3 → 1.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f271018748afb1f0673160c77fb130306881d834350f863459b0dd4bf9e50ca
-  data.tar.gz: 30735d835cdf55297b2c3e930bf5208aa57f8e93b2ebecce34759922f1717778
+  metadata.gz: '0418444aa216ec13ed88dfb05f28df8928ffbfbfabcee2b1680fad3fcc0f6d11'
+  data.tar.gz: a377af093161703e150a689102bc9a8e460409b36ba27cf60d05d66932f8fb9f
 SHA512:
-  metadata.gz: 350a4f591d15e80fbeec13d00cecc6dc5517fc217ecf403fb33fea6b4288a8c54d6c120ef944d2ce28780dd02be02b79e22d7c534a84f9c6fd23e861a3189514
-  data.tar.gz: 06c021bdaa31ab1d1533893288c095385dd170b5910c42f843144f705faf0fdb45615ae98a7936de628b7599fac7ece3f9af3c96de2b63d96887554508912ad8
+  metadata.gz: 026fc5fe5f7340f0a26bfac07738a95f8af2ae2fdb66877a105fcd3ddc0ac7cc5fec71f541dfcfa4fd8a59d39df2f90eace55a8f7f66be9dd63ef99f37f585ee
+  data.tar.gz: 21a74bee63dcb4dcba2c945b5ed7791b5d8158780454290cf207dc5af7aa84985503d77db1ec70b0233e69251e2441a449dcb22416ef792ff7d40bee2ecdab77

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Legion Changelog
 
+## [1.5.4] - 2026-03-24
+
+### Added
+- `Cluster::Leader` wired into `Service` boot behind `cluster.leader_election` feature flag (default: off)
+- `Actors::Singleton` upgraded to dual-backend (Redis + PG advisory locks via `Cluster::Lock`)
+- `Singleton` gating controlled by `cluster.singleton_enabled` feature flag (default: off — every node runs, no behavior change)
+- `Cluster::Lock.extend_lock` method (Redis: Lua TTL extend; PG: always true; none: false)
+- `Singleton` mixin added to lex-health watchdog and lex-metering cleanup/cost_optimizer actors
+
+### Changed
+- `@cluster_leader.stop` called on `Service#shutdown` (before extensions shutdown)
+
 ## [1.5.3] - 2026-03-24
 
 ### Added

data/lib/legion/cluster/lock.rb

@@ -56,6 +56,17 @@ module Legion
         end
       end
 
+      def extend_lock(name:, token: nil, ttl: 30)
+        case backend
+        when :redis
+          extend_lock_redis(name: name, token: token, ttl: ttl)
+        when :postgres
+          true
+        else
+          false
+        end
+      end
+
       def with_lock(name:, ttl: 30, timeout: 5)
         acquired = acquire(name: name, ttl: ttl, timeout: timeout)
         return unless acquired
@@ -124,6 +135,27 @@ module Legion
         false
       end
 
+      def extend_lock_redis(name:, token:, ttl:)
+        tok = token || fetch_token(name)
+        return false unless tok
+
+        client = Legion::Cache::Redis.client
+        key = redis_key(name)
+        lua = <<~LUA
+          if redis.call('GET', KEYS[1]) == ARGV[1] then
+            redis.call('PEXPIRE', KEYS[1], ARGV[2])
+            return 1
+          else
+            return 0
+          end
+        LUA
+        result = client.call('EVAL', lua, 1, key, tok, (ttl * 1000).to_s)
+        result == 1
+      rescue StandardError => e
+        Legion::Logging.debug "Lock#extend_lock_redis failed for name=#{name}: #{e.message}" if defined?(Legion::Logging)
+        false
+      end
+
       def release_postgres(name:)
         key = lock_key(name)
         db = Legion::Data.connection

data/lib/legion/extensions/actors/singleton.rb

@@ -24,24 +24,50 @@ module Legion
 
           private
 
+          def singleton_enabled?
+            return false unless defined?(Legion::Settings)
+
+            cluster = Legion::Settings[:cluster]
+            cluster.is_a?(Hash) && cluster[:singleton_enabled] == true
+          rescue StandardError
+            false
+          end
+
           def skip_or_run(&)
-            return super unless defined?(Legion::Lock)
+            return super unless singleton_enabled?
+            return super unless defined?(Legion::Lock) || defined?(Legion::Cluster::Lock)
 
             role = singleton_role
-            ttl_ms = singleton_ttl * 1000
+            ttl_secs = singleton_ttl
 
-            unless @leader_token
-              @leader_token = Legion::Lock.acquire("leader:#{role}", ttl: ttl_ms)
+            if @leader_token.nil?
+              @leader_token = acquire_singleton_lock(role, ttl_secs)
               return unless @leader_token
+            else
+              extended = extend_singleton_lock(role, @leader_token, ttl_secs)
+              unless extended
+                @leader_token = acquire_singleton_lock(role, ttl_secs)
+                return unless @leader_token
+              end
             end
 
-            extended = Legion::Lock.extend_lock("leader:#{role}", @leader_token, ttl: ttl_ms)
-            unless extended
-              @leader_token = Legion::Lock.acquire("leader:#{role}", ttl: ttl_ms)
-              return unless @leader_token
+            super
+          end
+
+          def acquire_singleton_lock(role, ttl_secs)
+            if defined?(Legion::Cluster::Lock)
+              Legion::Cluster::Lock.acquire(name: "leader:#{role}", ttl: ttl_secs)
+            else
+              Legion::Lock.acquire("leader:#{role}", ttl: ttl_secs * 1000)
             end
+          end
 
-            super
+          def extend_singleton_lock(role, token, ttl_secs)
+            if defined?(Legion::Cluster::Lock)
+              Legion::Cluster::Lock.extend_lock(name: "leader:#{role}", token: token, ttl: ttl_secs)
+            else
+              Legion::Lock.extend_lock("leader:#{role}", token, ttl: ttl_secs * 1000)
+            end
           end
         end
       end

data/lib/legion/service.rb

@@ -60,6 +60,7 @@ module Legion
       end
 
       setup_rbac if data
+      setup_cluster if data
 
       if llm
         setup_llm
@@ -147,6 +148,20 @@ module Legion
       Legion::Logging.warn "Legion::Rbac failed to load: #{e.message}"
     end
 
+    def setup_cluster
+      cluster_settings = Legion::Settings[:cluster]
+      return unless cluster_settings.is_a?(Hash) && cluster_settings[:leader_election] == true
+
+      require 'legion/cluster'
+      return unless defined?(Legion::Cluster::Leader)
+
+      @cluster_leader = Legion::Cluster::Leader.new
+      @cluster_leader.start
+      Legion::Logging.info('Cluster leader election started')
+    rescue StandardError => e
+      Legion::Logging.warn("Cluster leader setup failed: #{e.message}")
+    end
+
     def setup_settings
       require 'legion/settings'
       directories = Legion::Settings::Loader.default_directories
@@ -375,6 +390,11 @@ module Legion
         Legion::Readiness.mark_not_ready(:gaia)
       end
 
+      if @cluster_leader
+        @cluster_leader.stop
+        @cluster_leader = nil
+      end
+
       Legion::Extensions.shutdown
       Legion::Readiness.mark_not_ready(:extensions)
 

data/lib/legion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Legion
-  VERSION = '1.5.3'
+  VERSION = '1.5.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.5.3
+  version: 1.5.4
 platform: ruby
 authors:
 - Esity
@@ -396,6 +396,7 @@ files:
 - exe/legion
 - exe/legionio
 - legionio.gemspec
+- legionio_local.db
 - lib/legion.rb
 - lib/legion/alerts.rb
 - lib/legion/api.rb