legionio 1.4.58 → 1.4.59

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b941e35cffdc0cee05b505548896ec05866dc24c517f42ecc4d9a3f16a77c53f
-  data.tar.gz: f0e5f2a91dc3627a3124bd9cbe74fb02ed235fad0fee966b221e48acc935bee7
+  metadata.gz: bb8c466919694ff3ee71e207099e6cdbc7d93ec3a641c7213a9efa5f624fceec
+  data.tar.gz: 714ca199c88b04b1f6b84680dbffe2c6f5d953d09d6114d115878cc98a10e3fe
 SHA512:
-  metadata.gz: 67561fe5e20de1e404b63218fa971989d44767ff9df893ddc922598e94086e14b5134884c434264bb47449065018c8fe99dad88274c3ed629be0f98345ac0036
-  data.tar.gz: fcb1fbe1f834f856410ce41d319dabc115bbbccbd23562783d26cc0efc8672c09eae205a5e7c376533744008cd3675f8b2208b393ba2e0dbc6335d4cb8e27ed8
+  metadata.gz: '08cce649982a2b0fabb240cf1ce373bf8b98c7807d5608d4e05caea9f26458b56c98f7b62584950d15376112d3f6396dbd3bd5c91e2779ca61867e1debaab2c5'
+  data.tar.gz: a7d37673e26e87ef65a04100884720da7c762f5fbd8c15f116febd7dc02314df77e0f1243acd2c383bc3e55e4ac940f3ca70ae49e0dfa76ece907871f39e7892

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Legion Changelog
 
+## [1.4.59] - 2026-03-17
+
+### Added
+- `remote_invocable?` flag for LEX extensions: when `false`, the auto-generated Subscription actor is skipped (no RabbitMQ queue, no thread pool, no AMQP binding)
+- 5-level resolution order: per-runner settings, extension settings, runner class method, extension module method, default `true`
+- `@local_tasks` list tracks subscription actors skipped due to `remote_invocable? false` for introspection
+- `remote_invocable?` default method added to `Legion::Extensions::Core` and `Legion::Extensions::Actors::Base`
+- Fully backward compatible — all existing extensions unaffected
+
 ## [1.4.58] - 2026-03-17
 
 ### Added
@@ -35,6 +44,7 @@
 ### Changed
 - `build_default_exchange` now sets `exchange_name` on dynamically created exchange classes to return `amqp_prefix` (dot-joined segments with `legion.` prefix) instead of defaulting to the parent class behavior
 - `auto_create_exchange` now derives `exchange_name` from `amqp_prefix` + the exchange's own downcased class name, replacing the index-based `split('::')[5].downcase` extraction that broke for nested extension namespaces
+
 ### Fixed
 - `legion config scaffold` now writes to `~/.legionio/settings/` by default instead of `./settings/`
 - Removed Thor `default: './settings'` that shadowed the Ruby fallback in `ConfigScaffold.run`

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

@@ -43,6 +43,10 @@ module Legion
         def enabled?
           true
         end
+
+        def remote_invocable?
+          true
+        end
       end
     end
   end

data/lib/legion/extensions/core.rb

@@ -83,6 +83,10 @@ module Legion
         false
       end
 
+      def remote_invocable?
+        true
+      end
+
       def build_data
         auto_generate_data
         lex_class::Data.build

data/lib/legion/extensions.rb

@@ -16,12 +16,15 @@ module Legion
         @once_tasks = []
         @poll_tasks = []
         @subscription_tasks = []
+        @local_tasks = []
         @actors = []
 
         find_extensions
         load_extensions
       end
 
+      attr_reader :local_tasks
+
       def shutdown
         return nil if @loaded_extensions.nil?
 
@@ -192,23 +195,69 @@ module Legion
         elsif actor_class.ancestors.include? Legion::Extensions::Actors::Poll
           @poll_tasks.push(extension_hash)
         elsif actor_class.ancestors.include? Legion::Extensions::Actors::Subscription
-          extension_hash[:threadpool] = Concurrent::FixedThreadPool.new(size)
-          size.times do
-            extension_hash[:threadpool].post do
-              klass = actor_class.new
-              if klass.respond_to?(:async)
-                klass.async.subscribe
-              else
-                klass.subscribe
-              end
-            end
-          end
-          @subscription_tasks.push(extension_hash)
+          hook_subscription_actor(extension_hash, size, opts)
         else
           Legion::Logging.fatal 'did not match any actor classes'
         end
       end
 
+      private
+
+      def hook_subscription_actor(extension_hash, size, opts)
+        ext_name   = extension_hash[:extension_name]
+        extension  = extension_hash[:extension]
+        actor_class = extension_hash[:actor_class]
+
+        unless resolve_remote_invocable(ext_name, opts.merge(actor_class: actor_class, extension: extension))
+          Legion::Logging.debug { "#{ext_name}/#{extension_hash[:actor_name]} is not remote_invocable, skipping AMQP subscription" }
+          @local_tasks.push(extension_hash)
+          return
+        end
+
+        extension_hash[:threadpool] = Concurrent::FixedThreadPool.new(size)
+        size.times do
+          extension_hash[:threadpool].post do
+            klass = actor_class.new
+            if klass.respond_to?(:async)
+              klass.async.subscribe
+            else
+              klass.subscribe
+            end
+          end
+        end
+        @subscription_tasks.push(extension_hash)
+      end
+
+      def resolve_remote_invocable(extension_name, opts = {})
+        ext_key = extension_name.to_sym
+        ext_settings = Legion::Settings.dig(:extensions, ext_key)
+        runner_name = opts[:actor_name]&.to_sym
+
+        # 1. Per-runner settings override
+        runner_setting = ext_settings&.dig(:runners, runner_name, :remote_invocable)
+        return runner_setting unless runner_setting.nil?
+
+        # 2. Extension settings override
+        ext_setting = ext_settings&.dig(:remote_invocable)
+        return ext_setting unless ext_setting.nil?
+
+        # 3. Runner class method (only if defined directly on the runner, not inherited)
+        runner_class = opts[:runner_class]
+        if runner_class.respond_to?(:remote_invocable?)
+          owner = runner_class.method(:remote_invocable?).owner
+          return runner_class.remote_invocable? if owner == runner_class.singleton_class || !owner.singleton_class?
+        end
+
+        # 4. Extension module method
+        extension = opts[:extension]
+        return extension.remote_invocable? if extension.respond_to?(:remote_invocable?)
+
+        # 5. Default
+        true
+      end
+
+      public
+
       def gem_load(entry)
         gem_name     = entry[:gem_name]
         require_path = entry[:require_path]

data/lib/legion/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.58
+  version: 1.4.59
 platform: ruby
 authors:
 - Esity