legionio 1.7.20 → 1.7.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba8e945b1c999e0c815583388817c35bc019134994745682a774afb6e645db1f
-  data.tar.gz: d21bf7aea3328dda51f7139ed36632b31f16e5c57bef938a9eb2f9f000c2c21e
+  metadata.gz: 8e469923d32f8ead43a892e473c93737139885622f40683a63aa0a757a0c282d
+  data.tar.gz: 2e88c8468007f617c075178410da534337931e37a3c50fb11a67fa3801807689
 SHA512:
-  metadata.gz: c5ef0de86e4ea0a8e92fc7433af4e36bb8b7088737142abcfa5edcaad3769ede8acf0205e2b8478e80cc4376052e6cb3ef3df384b2cf2c39abdc8205fd965a68
-  data.tar.gz: 389cf7d22ac2db9e44489c4118cbef323d0d92d9242b4ec0e8a4c7ed141425497249a6832b2cf1bbecdc9e6666d65251978fac36f299175195d2eefa8fb6e190
+  metadata.gz: 4d7cd5a0513e26ca92bf5b909ac924a7041bbe2b74602d6a552357d155f9101c0d81b75c6d4db0c06b9748b08fd174363ad7d26ffa021f82001923d428ecd5ec
+  data.tar.gz: 252dc15217cf3d320fa9f96703967d9c9320f2d3e26d18d91c992a8819dbf34ced50eca926ddcba0a3c2be1a74619d3f6106d20ca9f09919ba6c32901b8d5197

data/CHANGELOG.md

@@ -1,6 +1,28 @@
 # Legion Changelog
 
-## [Unreleased]
+## [1.7.24] - 2026-04-06
+
+### Fixed
+- `Routes::Events` SSE stream: qualify `stream_queue` call with `Routes::Events.` to fix NoMethodError on Legion::API instance
+
+### Added
+- `Identity::Process.source` accessor — exposes provider source in identity hash (Wire Format Phase 3)
+- `source:` key in `Identity::Process.identity_hash`, `bind!`, `bind_fallback!`, and `EMPTY_STATE`
+
+## [1.7.22] - 2026-04-06
+### Added
+- Elastic APM integration for Sinatra API via `elastic-apm` gem
+- Full APM config under `api.elastic_apm` settings: server_url, api_key, secret_token, api_buffer_size, api_request_size, api_request_time, capture_body, capture_headers, capture_env, disable_send, enabled, environment, hostname, ignore_url_patterns, pool_size, service_name, service_node_name, service_version, sample_rate
+- `setup_apm` / `shutdown_apm` lifecycle in Service (boot, shutdown, reload)
+- `ElasticAPM::Middleware` wired into API when available
+- Health/ready endpoints excluded from APM tracing by default
+
+## [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

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/api/events.rb

@@ -90,7 +90,7 @@ module Legion
               end
 
               stream do |out|
-                stream_queue(out: out, queue: queue, listener: listener)
+                Routes::Events.stream_queue(out: out, queue: queue, listener: listener)
               end
             end
 

data/lib/legion/api/middleware/request_logger.rb

@@ -10,19 +10,45 @@ module Legion
 
         def call(env)
           method_path = "#{env['REQUEST_METHOD']} #{env['PATH_INFO']}"
-          Legion::Logging.info "[api][request-start] #{method_path}"
+          client_info = build_client_info(env)
+          Legion::Logging.info "[api][request-start] #{method_path} #{client_info}"
           start = ::Process.clock_gettime(::Process::CLOCK_MONOTONIC)
           status, headers, body = @app.call(env)
           duration = ((::Process.clock_gettime(::Process::CLOCK_MONOTONIC) - start) * 1000).round(2)
 
           level = duration > 5000 ? :warn : :info
-          Legion::Logging.send(level, "[api] #{method_path} #{status} #{duration}ms")
+          Legion::Logging.send(level, "[api] #{method_path} #{status} #{duration}ms #{client_info}")
           [status, headers, body]
         rescue StandardError => e
           duration = ((::Process.clock_gettime(::Process::CLOCK_MONOTONIC) - start) * 1000).round(2)
-          Legion::Logging.error "[api] #{method_path} 500 #{duration}ms - #{e.message}"
+          Legion::Logging.error "[api] #{method_path} 500 #{duration}ms #{client_info} - #{e.message}"
           raise
         end
+
+        private
+
+        def build_client_info(env)
+          ip = env['HTTP_X_FORWARDED_FOR'] || env['REMOTE_ADDR'] || '-'
+          ua = env['HTTP_USER_AGENT'] || '-'
+          origin = env['HTTP_ORIGIN'] || '-'
+          referer = env['HTTP_REFERER'] || '-'
+          auth = env['HTTP_AUTHORIZATION'] ? 'Bearer(present)' : 'none'
+          content_type = env['CONTENT_TYPE'] || '-'
+          content_length = env['CONTENT_LENGTH'] || '-'
+          query = env['QUERY_STRING'] && env['QUERY_STRING'].empty? ? nil : env['QUERY_STRING']
+
+          parts = [
+            "ip=#{ip}",
+            "ua=#{ua}",
+            "origin=#{origin}",
+            "referer=#{referer}",
+            "auth=#{auth}",
+            "content_type=#{content_type}",
+            "content_length=#{content_length}"
+          ]
+          parts << "query=#{query}" if query
+          parts.join(' ')
+        end
       end
     end
   end

data/lib/legion/identity/process.rb

@@ -11,6 +11,7 @@ module Legion
         id:             nil,
         canonical_name: nil,
         kind:           nil,
+        source:         nil,
         persistent:     false,
         groups:         [].freeze,
         metadata:       {}.freeze
@@ -53,11 +54,16 @@ module Legion
           @state.get[:persistent] == true
         end
 
+        def source
+          @state.get[:source]
+        end
+
         def identity_hash
           {
             id:             id,
             canonical_name: canonical_name,
             kind:           kind,
+            source:         source,
             mode:           mode,
             queue_prefix:   queue_prefix,
             resolved:       resolved?,
@@ -69,10 +75,12 @@ module Legion
 
         def bind!(provider, identity_hash)
           @provider = provider
+          provider_source = provider.respond_to?(:provider_name) ? provider.provider_name : nil
           @state.set({
                        id:             identity_hash[:id],
                        canonical_name: identity_hash[:canonical_name],
                        kind:           identity_hash[:kind],
+                       source:         identity_hash.key?(:source) ? identity_hash[:source] : provider_source,
                        persistent:     identity_hash.fetch(:persistent, true),
                        groups:         Array(identity_hash[:groups]).compact.freeze,
                        metadata:       identity_hash[:metadata].is_a?(Hash) ? identity_hash[:metadata].dup.freeze : {}.freeze
@@ -86,6 +94,7 @@ module Legion
                        id:             nil,
                        canonical_name: user,
                        kind:           :human,
+                       source:         :system,
                        persistent:     false,
                        groups:         [].freeze,
                        metadata:       {}.freeze

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.24'
 end

metadata

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