legionio 1.7.20 → 1.7.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba8e945b1c999e0c815583388817c35bc019134994745682a774afb6e645db1f
-  data.tar.gz: d21bf7aea3328dda51f7139ed36632b31f16e5c57bef938a9eb2f9f000c2c21e
+  metadata.gz: f1c44047319bdcf02eb061d73517101f695f380d976cb65ad9e2a0d2afb824b2
+  data.tar.gz: e756182d3fdfea35882961412f7d3093884d7477954c3b67d2037039ad310189
 SHA512:
-  metadata.gz: c5ef0de86e4ea0a8e92fc7433af4e36bb8b7088737142abcfa5edcaad3769ede8acf0205e2b8478e80cc4376052e6cb3ef3df384b2cf2c39abdc8205fd965a68
-  data.tar.gz: 389cf7d22ac2db9e44489c4118cbef323d0d92d9242b4ec0e8a4c7ed141425497249a6832b2cf1bbecdc9e6666d65251978fac36f299175195d2eefa8fb6e190
+  metadata.gz: 1178b2efaadc7801e37a68fd556add983eede7acd3f01dd1c744b029c8e048dc7ac681db0b578fc545419ca8d4f447cc518d3f7d5c2b351323350c1ae9ea908c
+  data.tar.gz: c9f34008bef206a7108cbc4013213342c4bc25fa6396884fec1e471b3b6d46d7110027214a0829c05a0d59d59c348fad8726d089c03ffbb1b40ce5f7d9de10a7

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [1.7.21] - 2026-04-06
+### Fixed
+- Optional components (rbac, llm, apollo, gaia) no longer block readiness when not installed
+- Split `Readiness::COMPONENTS` into `REQUIRED_COMPONENTS` and `OPTIONAL_COMPONENTS`
+- Added `Readiness.mark_skipped` for components that are absent or disabled
+- Reload path now correctly marks optional components as skipped when not loaded
+
 ## [1.7.20] - 2026-04-06
 ### Added
 - `Legion::Mode` module with `LEGACY_MAP`, ENV/Settings fallback chain, `agent?`/`worker?`/`infra?`/`lite?` predicates

data/CLAUDE.md

@@ -9,7 +9,7 @@ The primary gem for the LegionIO framework. An extensible async job engine for s
 
 **GitHub**: https://github.com/LegionIO/LegionIO
 **Gem**: `legionio`
-**Version**: 1.7.18
+**Version**: 1.7.21
 **License**: Apache-2.0
 **Docker**: `legionio/legion`
 **Ruby**: >= 3.4

data/README.md

@@ -8,13 +8,13 @@ Schedule tasks, chain services into dependency graphs, run them concurrently via
          ╭──────────────────────────────────────╮
          │           L E G I O N I O            │
          │                                      │
-         │   280+ extensions  ·  58 MCP tools   │
+         │   280+ extensions  ·  60 MCP tools   │
          │   AI chat CLI  ·  REST API  ·  HA    │
          │   cognitive architecture  ·  Vault    │
          ╰──────────────────────────────────────╯
 ```
 
-**Ruby >= 3.4** | **v1.6.20** | **Apache-2.0** | [@Esity](https://github.com/Esity)
+**Ruby >= 3.4** | **v1.7.21** | **Apache-2.0** | [@Esity](https://github.com/Esity)
 
 ---
 
@@ -33,7 +33,7 @@ When A completes, B runs. B triggers C, D, and E in parallel. Conditions gate ex
 But that's just the foundation. LegionIO is also:
 
 - **An AI coding assistant** — interactive chat with tools, code review, commit messages, PR generation, and multi-agent workflows
-- **An MCP server** — 58 tools that let any AI agent run tasks, manage extensions, and query your infrastructure
+- **An MCP server** — 60 tools that let any AI agent run tasks, manage extensions, and query your infrastructure
 - **A cognitive computing platform** — 242 brain-modeled extensions across 18 cognitive domains
 - **A digital worker platform** — AI-as-labor with governance, risk tiers, and cost tracking
 
@@ -359,7 +359,7 @@ legion mcp http           # streamable HTTP on localhost:9393
 legion mcp http --port 8080 --host 0.0.0.0
 ```
 
-**58 tools** in the `legion.*` namespace:
+**60 tools** in the `legion.*` namespace:
 
 | Category | Tools |
 |----------|-------|

data/lib/legion/readiness.rb

@@ -4,7 +4,9 @@ require 'concurrent'
 
 module Legion
   module Readiness
-    COMPONENTS = %i[settings crypt transport cache data rbac llm apollo gaia identity extensions api].freeze
+    REQUIRED_COMPONENTS = %i[settings crypt transport cache data extensions api].freeze
+    OPTIONAL_COMPONENTS = %i[rbac llm apollo gaia identity].freeze
+    COMPONENTS = (REQUIRED_COMPONENTS + OPTIONAL_COMPONENTS).freeze
     DRAIN_TIMEOUT = 5
 
     class << self
@@ -22,14 +24,19 @@ module Legion
         Legion::Logging.debug "[Readiness] #{component} is not ready" if defined?(Legion::Logging)
       end
 
+      def mark_skipped(component)
+        status[component.to_sym] = :skipped
+        Legion::Logging.debug "[Readiness] #{component} skipped (optional)" if defined?(Legion::Logging)
+      end
+
       def ready?(component = nil)
         if component
-          result = status[component.to_sym] == true
+          result = [true, :skipped].include?(status[component.to_sym])
           Legion::Logging.warn "[Readiness] #{component} is not ready" if !result && defined?(Legion::Logging)
           return result
         end
 
-        not_ready = COMPONENTS.reject { |c| status[c] == true }
+        not_ready = COMPONENTS.reject { |c| [true, :skipped].include?(status[c]) }
         not_ready.each { |c| Legion::Logging.warn "[Readiness] #{c} is not ready" } if !not_ready.empty? && defined?(Legion::Logging)
         not_ready.empty?
       end
@@ -50,7 +57,8 @@ module Legion
 
       def to_h
         COMPONENTS.to_h do |c|
-          [c, status[c] == true]
+          val = status[c]
+          [c, [true, :skipped].include?(val)]
         end
       end
     end

data/lib/legion/service.rb

@@ -102,7 +102,11 @@ module Legion
         end
       end
 
-      setup_rbac if data
+      if data
+        setup_rbac
+      else
+        Legion::Readiness.mark_skipped(:rbac)
+      end
       setup_cluster if data
 
       if llm
@@ -112,9 +116,13 @@ module Legion
         rescue LoadError => e
           handle_exception(e, level: :debug, operation: 'service.initialize.llm', availability: 'missing')
           log.info 'Legion::LLM gem is not installed'
+          Legion::Readiness.mark_skipped(:llm)
         rescue StandardError => e
           handle_exception(e, level: :warn, operation: 'service.initialize.llm')
+          Legion::Readiness.mark_skipped(:llm)
         end
+      else
+        Legion::Readiness.mark_skipped(:llm)
       end
 
       begin
@@ -123,8 +131,10 @@ module Legion
       rescue LoadError => e
         handle_exception(e, level: :debug, operation: 'service.initialize.apollo', availability: 'missing')
         log.info 'Legion::Apollo gem is not installed, starting without Apollo'
+        Legion::Readiness.mark_skipped(:apollo)
       rescue StandardError => e
         handle_exception(e, level: :warn, operation: 'service.initialize.apollo')
+        Legion::Readiness.mark_skipped(:apollo)
       end
 
       if gaia
@@ -134,9 +144,13 @@ module Legion
         rescue LoadError => e
           handle_exception(e, level: :debug, operation: 'service.initialize.gaia', availability: 'missing')
           log.info 'Legion::Gaia gem is not installed'
+          Legion::Readiness.mark_skipped(:gaia)
         rescue StandardError => e
           handle_exception(e, level: :warn, operation: 'service.initialize.gaia')
+          Legion::Readiness.mark_skipped(:gaia)
         end
+      else
+        Legion::Readiness.mark_skipped(:gaia)
       end
 
       setup_telemetry
@@ -178,6 +192,7 @@ module Legion
       require 'legion/api/default_settings'
       api_settings = Legion::Settings[:api]
       @api_enabled = api && api_settings[:enabled]
+      setup_apm if @api_enabled
       setup_api if @api_enabled
       setup_network_watchdog
       Legion::Settings[:client][:ready] = true
@@ -232,8 +247,10 @@ module Legion
     rescue LoadError => e
       handle_exception(e, level: :debug, operation: 'service.setup_rbac', availability: 'missing')
       log.debug 'Legion::Rbac gem is not installed, starting without RBAC'
+      Legion::Readiness.mark_skipped(:rbac)
     rescue StandardError => e
       handle_exception(e, level: :warn, operation: 'service.setup_rbac')
+      Legion::Readiness.mark_skipped(:rbac)
     end
 
     def setup_cluster
@@ -309,6 +326,42 @@ module Legion
       )
     end
 
+    def setup_apm
+      apm_settings = Legion::Settings[:apm] || {}
+      return unless apm_settings[:enabled]
+
+      require 'elastic-apm'
+
+      config = {
+        service_name:            apm_settings[:service_name] || "legion-#{Legion::Settings[:client][:name]}",
+        server_url:              apm_settings[:server_url] || 'http://localhost:8200',
+        environment:             apm_settings[:environment] || Legion::Settings[:environment] || 'development',
+        secret_token:            apm_settings[:secret_token],
+        api_key:                 apm_settings[:api_key],
+        log_level:               apm_settings[:log_level]&.to_sym || Logger::WARN,
+        transaction_sample_rate: apm_settings[:sample_rate] || 1.0
+      }.compact
+
+      ElasticAPM.start(**config)
+      @apm_running = true
+      log.info "Elastic APM started: server=#{config[:server_url]} service=#{config[:service_name]}"
+    rescue LoadError => e
+      handle_exception(e, level: :debug, operation: 'service.setup_apm', availability: 'missing')
+      log.info 'elastic-apm gem is not installed, starting without APM'
+    rescue StandardError => e
+      handle_exception(e, level: :warn, operation: 'service.setup_apm')
+    end
+
+    def shutdown_apm
+      return unless @apm_running
+
+      ElasticAPM.stop if defined?(ElasticAPM) && ElasticAPM.running?
+      @apm_running = false
+      log.info 'Elastic APM stopped'
+    rescue StandardError => e
+      handle_exception(e, level: :warn, operation: 'service.shutdown_apm')
+    end
+
     def setup_api # rubocop:disable Metrics/MethodLength
       if @api_thread&.alive?
         log.warn 'API already running, skipping duplicate setup_api call'
@@ -667,6 +720,7 @@ module Legion
       shutdown_network_watchdog
       shutdown_audit_archiver
       shutdown_api
+      shutdown_apm
 
       Legion::Metrics.reset! if defined?(Legion::Metrics)
 
@@ -738,6 +792,7 @@ module Legion
 
       shutdown_network_watchdog
       shutdown_api
+      shutdown_apm
 
       if defined?(Legion::Gaia) && Legion::Gaia.respond_to?(:started?) && Legion::Gaia.started?
         shutdown_component('Gaia') { Legion::Gaia.shutdown }
@@ -786,11 +841,33 @@ module Legion
       setup_data
       Legion::Readiness.mark_ready(:data)
 
-      setup_rbac if defined?(Legion::Rbac)
-      setup_llm if defined?(Legion::LLM)
+      if defined?(Legion::Rbac)
+        setup_rbac
+      else
+        Legion::Readiness.mark_skipped(:rbac)
+      end
+
+      if defined?(Legion::LLM)
+        setup_llm
+      else
+        Legion::Readiness.mark_skipped(:llm)
+      end
 
-      setup_gaia if defined?(Legion::Gaia)
-      Legion::Readiness.mark_ready(:gaia)
+      if defined?(Legion::Apollo)
+        setup_apollo
+        Legion::Readiness.mark_ready(:apollo)
+      else
+        Legion::Readiness.mark_skipped(:apollo)
+      end
+
+      if defined?(Legion::Gaia)
+        setup_gaia
+        Legion::Readiness.mark_ready(:gaia)
+      else
+        Legion::Readiness.mark_skipped(:gaia)
+      end
+
+      Legion::Readiness.mark_ready(:identity)
 
       setup_supervision
       load_extensions
@@ -801,6 +878,7 @@ module Legion
       register_core_tools
 
       Legion::Crypt.cs
+      setup_apm if @api_enabled
       setup_api if @api_enabled
 
       if defined?(Legion::MCP)

data/lib/legion/version.rb

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

metadata

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