legionio 1.4.68 → 1.4.70

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1521235e6e865bd6d74f41b93c57e159de23d9dee0f044486c8059a6af780ab0
-  data.tar.gz: 7bdb02eb37ca2f03b9c0b6f7f494ebbb394d69f53ff83dd4bb5c1e27cb37e85e
+  metadata.gz: 6f924192ddb882e9dd08fa0ada9088c4f9f468ef8d782df7a06888774ebe5b9d
+  data.tar.gz: f7eab58ceaf4f9119dad859f9b5d47945b57854a2e65e7f68484660da9c2f3a9
 SHA512:
-  metadata.gz: 78a7171285d6a6eebda11d87d2782a68b6edb0dbc1f0be6d6034c1b4c7e535a5ae2dc1feb34ecbcc5af64d767759c7af7c78c1c50ed8672a1f08dea738c6b23b
-  data.tar.gz: 0b7c0e4d1298e13815383df8667d2b14debf66675c981002847fa19a01d0be6afa4314d811ba7cde7285ee46ddf37e9985e8a86745aef2b4b122d2a7dc1e16ac
+  metadata.gz: 5b120a8843d8626da5508cfef24fa2791539c135d090a83a1519e9db99d3fb78aac7b52fde48b2c844435687114dada9b9622d73f6ab204607e73f422f2a9b90
+  data.tar.gz: 6965a20d9389f2b8e16be7e83fdac2835c6b18d47269bb9bf9f102588d03ed7df72b62cc119afeb1f7b0c29695efd0654e60af093bff4e00d3e2eefc76f76723

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Legion Changelog
 
+## [1.4.70] - 2026-03-19
+
+### Added
+- GAIA cognitive layer as a core boot phase: `setup_gaia` runs between LLM and telemetry in the startup sequence
+- Two-phase extension loading: all extensions are fully loaded (require + autobuild) before any actors are hooked (AMQP subscriptions, timers, etc.), preventing race conditions during boot
+- `gaia: true` parameter on `Service.new` to control GAIA initialization
+- GAIA graceful shutdown and reload support (shuts down before extensions, restarts after data)
+
+### Changed
+- Boot order is now deterministic: Logging -> Settings -> Crypt -> Transport -> Cache -> Data -> RBAC -> LLM -> GAIA -> Telemetry -> Extensions -> API
+- Extension actors are collected into `@pending_actors` during `load_extensions`, then started all at once via `hook_all_actors`
+
+## [1.4.69] - 2026-03-19
+
+### Fixed
+- Constant resolution bug in transport/subscription layers: `const_defined?` and `const_get` now pass `inherit: false` to prevent Ruby from finding top-level gem constants (`::Redis`, `::Vault`, `::Data`) through `Object` when checking dynamically created `Module.new` namespaces (`Transport::Exchanges`, `Transport::Queues`)
+- `Subscription#queue` now uses `queues.const_get(actor_const, false)` instead of `Kernel.const_get(queue_string)` to search only the Queues module's own constants
+- Added `llm-gateway` to `core_extension_names` so it is included under `:core` role profile
+- `build_extension_entry` now forces nesting for multi-segment gem names (e.g. `lex-llm-gateway`) to produce correct require paths regardless of call-site `nesting:` argument
+
 ## [1.4.68] - 2026-03-19
 
 ### Added

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

@@ -30,8 +30,8 @@ module Legion
         end
 
         def queue
-          create_queue unless queues.const_defined?(actor_const)
-          Kernel.const_get queue_string
+          create_queue unless queues.const_defined?(actor_const, false)
+          queues.const_get(actor_const, false)
         end
 
         def queue_string

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

@@ -33,13 +33,13 @@ module Legion
         end
 
         def build_default_exchange
-          return transport_class::Exchanges.const_get(lex_const) if transport_class::Exchanges.const_defined? lex_const
+          return transport_class::Exchanges.const_get(lex_const, false) if transport_class::Exchanges.const_defined?(lex_const, false)
 
           amqp = amqp_prefix
           transport_class::Exchanges.const_set(lex_const, Class.new(Legion::Transport::Exchange) do
             define_method(:exchange_name) { amqp }
           end)
-          @default_exchange = transport_class::Exchanges.const_get(lex_const)
+          @default_exchange = transport_class::Exchanges.const_get(lex_const, false)
         end
       end
     end

data/lib/legion/extensions/transport.rb

@@ -27,9 +27,9 @@ module Legion
       end
 
       def generate_base_modules
-        lex_class.const_set('Transport', Module.new) unless lex_class.const_defined?('Transport')
+        lex_class.const_set('Transport', Module.new) unless lex_class.const_defined?('Transport', false)
         %w[Queues Exchanges Messages Consumers].each do |thing|
-          next if transport_class.const_defined? thing
+          next if transport_class.const_defined?(thing, false)
 
           transport_class.const_set(thing, Module.new)
         end
@@ -68,7 +68,7 @@ module Legion
       end
 
       def auto_create_dlx_exchange
-        dlx = if transport_class::Exchanges.const_defined? 'Dlx'
+        dlx = if transport_class::Exchanges.const_defined?('Dlx', false)
                 transport_class::Exchanges::Dlx
               else
                 transport_class::Exchanges.const_set('Dlx', Class.new(default_exchange) do
@@ -86,7 +86,7 @@ module Legion
       end
 
       def auto_create_dlx_queue
-        return if transport_class::Queues.const_defined?('Dlx')
+        return if transport_class::Queues.const_defined?('Dlx', false)
 
         special_name = default_exchange.new.exchange_name
         dlx_queue = Legion::Transport::Queue.new "#{special_name}.dlx", auto_delete: false

data/lib/legion/extensions.rb

@@ -18,9 +18,11 @@ module Legion
         @subscription_tasks = []
         @local_tasks = []
         @actors = []
+        @pending_actors = []
 
         find_extensions
         load_extensions
+        hook_all_actors
       end
 
       attr_reader :local_tasks
@@ -124,14 +126,14 @@ module Legion
 
         if extension.respond_to?(:meta_actors) && extension.meta_actors.is_a?(Hash)
           extension.meta_actors.each_value do |actor|
-            extension.log.debug("hooking meta actor: #{actor}") if has_logger
-            hook_actor(**actor)
+            extension.log.debug("deferring meta actor: #{actor}") if has_logger
+            @pending_actors << actor
           end
         end
 
         extension.actors.each_value do |actor|
-          extension.log.debug("hooking literal actor: #{actor}") if has_logger
-          hook_actor(**actor)
+          extension.log.debug("deferring literal actor: #{actor}") if has_logger
+          @pending_actors << actor
         end
         extension.log.info "Loaded v#{extension::VERSION}"
         Legion::Events.emit('extension.loaded', name: ext_name, version: entry[:gem_name])
@@ -161,6 +163,14 @@ module Legion
         false
       end
 
+      def hook_all_actors
+        return if @pending_actors.nil? || @pending_actors.empty?
+
+        Legion::Logging.info "Hooking #{@pending_actors.size} deferred actors"
+        @pending_actors.each { |actor| hook_actor(**actor) }
+        @pending_actors = []
+      end
+
       def hook_actor(extension:, extension_name:, actor_class:, size: 1, **opts)
         size = if Legion::Settings[:extensions].key?(extension_name.to_sym) && Legion::Settings[:extensions][extension_name.to_sym].key?(:workers)
                  Legion::Settings[:extensions][extension_name.to_sym][:workers]
@@ -303,7 +313,7 @@ module Legion
       end
 
       def core_extension_names
-        %w[codegen conditioner exec health lex log metering node ping scheduler tasker task_pruner telemetry
+        %w[codegen conditioner exec health lex llm-gateway log metering node ping scheduler tasker task_pruner telemetry
            transformer].freeze
       end
 
@@ -450,6 +460,9 @@ module Legion
         segments = Helpers::Segments.derive_segments(gem_name)
         tier     = category == :default ? 5 : (categories.dig(category, :tier) || 5)
 
+        # Multi-segment gem names always need nesting for correct require paths
+        nesting = true if segments.length > 1
+
         if nesting
           const_path   = Helpers::Segments.derive_const_path(gem_name)
           require_path = Helpers::Segments.derive_require_path(gem_name)

data/lib/legion/readiness.rb

@@ -2,7 +2,7 @@
 
 module Legion
   module Readiness
-    COMPONENTS = %i[settings crypt transport cache data extensions api].freeze
+    COMPONENTS = %i[settings crypt transport cache data gaia extensions api].freeze
     DRAIN_TIMEOUT = 5
 
     class << self

data/lib/legion/service.rb

@@ -7,11 +7,12 @@ module Legion
     def modules
       base = [Legion::Crypt, Legion::Transport, Legion::Cache, Legion::Data, Legion::Supervision]
       base << Legion::LLM if defined?(Legion::LLM)
+      base << Legion::Gaia if defined?(Legion::Gaia)
       base.freeze
     end
 
     def initialize(transport: true, cache: true, data: true, supervision: true, extensions: true, # rubocop:disable Metrics/ParameterLists
-                   crypt: true, api: true, llm: true, log_level: 'info', http_port: nil)
+                   crypt: true, api: true, llm: true, gaia: true, log_level: 'info', http_port: nil)
       setup_logging(log_level: log_level)
       Legion::Logging.debug('Starting Legion::Service')
       setup_settings
@@ -51,6 +52,11 @@ module Legion
         Legion::Readiness.mark_ready(:llm)
       end
 
+      if gaia
+        setup_gaia
+        Legion::Readiness.mark_ready(:gaia)
+      end
+
       setup_telemetry
       setup_supervision if supervision
 
@@ -210,6 +216,16 @@ module Legion
       Legion::Logging.warn "Legion::LLM failed to load: #{e.message}"
     end
 
+    def setup_gaia
+      require 'legion/gaia'
+      Legion::Settings.merge_settings('gaia', Legion::Gaia::Settings.default)
+      Legion::Gaia.boot
+    rescue LoadError
+      Legion::Logging.info 'Legion::Gaia gem is not installed, starting without cognitive layer'
+    rescue StandardError => e
+      Legion::Logging.warn "Legion::Gaia failed to load: #{e.message}"
+    end
+
     def setup_transport
       require 'legion/transport'
       Legion::Settings.merge_settings('transport', Legion::Transport::Settings.default)
@@ -295,6 +311,11 @@ module Legion
 
       Legion::Metrics.reset! if defined?(Legion::Metrics)
 
+      if defined?(Legion::Gaia) && Legion::Gaia.started?
+        Legion::Gaia.shutdown
+        Legion::Readiness.mark_not_ready(:gaia)
+      end
+
       Legion::Extensions.shutdown
       Legion::Readiness.mark_not_ready(:extensions)
 
@@ -330,6 +351,11 @@ module Legion
 
       shutdown_api
 
+      if defined?(Legion::Gaia) && Legion::Gaia.started?
+        Legion::Gaia.shutdown
+        Legion::Readiness.mark_not_ready(:gaia)
+      end
+
       Legion::Extensions.shutdown
       Legion::Readiness.mark_not_ready(:extensions)
 
@@ -357,6 +383,9 @@ module Legion
       setup_data
       Legion::Readiness.mark_ready(:data)
 
+      setup_gaia
+      Legion::Readiness.mark_ready(:gaia)
+
       setup_supervision
 
       load_extensions

data/lib/legion/version.rb

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

metadata

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