legion-settings 1.3.9 → 1.3.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0fcaa25c5784c19c1c6af9e6b566eccd3a955ae8701a09e20b9c628b7bfa2fd
-  data.tar.gz: d2c376b14cae93615e734267a29336e689327078195dd604ed7bf3c3c8e981b0
+  metadata.gz: aa9a361cc8abaac426787e16814ad39859d0fd7d0690f0ca0025a3aeb626fd80
+  data.tar.gz: 33f4085cb92a849f779a0dd867436bedcb4a3970ba430f9739c3d4014db314ec
 SHA512:
-  metadata.gz: 143dab0104ef8757c0768832f6cba3494e0d32fadf7deb213d69e06bc89c8de12b7203db3448fef5181e022c671fc23cf6876fdf9e4a36f4e55dc2ce24ae81fc
-  data.tar.gz: '0879c1aff38d66f3decedc96f0f8b0efdb38939a62a5ed71de2085c614f4e8e1da61740bfb03ad1c7cc88d4e92eca8ea4fa8493447adef07fdf2d213749c2751'
+  metadata.gz: f838ac6025e9a63d736e879df9956960ee4b6638c09811a046ac5698769215ae2f97085da3e2a49054588869e8c7565649c49026ce9cb0538a066369c5872776
+  data.tar.gz: 768f206060c3b23f78097222d919d14d613991f04ba1bc1efdb07faeb480bbdb7f85200ed90d60158b18b71b79a953a77b1c0c46060a7a33857fc06addc90f34

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Legion::Settings Changelog
 
+## [1.3.11] - 2026-03-22
+
+### Added
+- `loader.rb`: debug logging on `load_directory` (file count), `load_module_settings`, and `load_module_default` (module name)
+- `loader.rb`: warn logging in `start_dns_background_refresh`, `read_resolv_config`, and `detect_fqdn` rescue blocks
+- `settings.rb`: info logging on successful load (file count), validate! success, and debug on resolve_secrets! completion
+- `settings.rb`: warn logging before raising `ValidationError` in production mode
+- `dns_bootstrap.rb`: warn on HTTP fetch failure, debug on cache hit, warn when corrupt cache is deleted
+- `agent_loader.rb`: warn on file parse failure, debug on agent loaded
+
+## [1.3.10] - 2026-03-22
+
+### Added
+- `extensions.parallel_pool_size` setting (default: 24) to control thread pool size for parallel extension loading
+
 ## [1.3.9] - 2026-03-21
 
 ### Added

data/CLAUDE.md

@@ -8,7 +8,7 @@
 Hash-like configuration store for the LegionIO framework. Loads settings from JSON files, directories, and environment variables. Provides a unified `Legion::Settings[:key]` accessor used by all other Legion gems. Includes schema-based validation with type inference, enum constraints, and cross-module checks.
 
 **GitHub**: https://github.com/LegionIO/legion-settings
-**Version**: 1.3.5
+**Version**: 1.3.9
 **License**: Apache-2.0
 
 ## Architecture

data/CODEOWNERS

@@ -1 +1,30 @@
+# Default owner — all files
 * @Esity
+
+# Core library code
+# lib/ @Esity @future-core-team
+
+# Loader (file/env/directory loading, deep merge)
+# lib/legion/settings/loader.rb @Esity @future-core-team
+
+# Schema validation
+# lib/legion/settings/schema.rb @Esity @future-core-team
+# lib/legion/settings/validation_error.rb @Esity @future-core-team
+
+# Secret resolver (vault://, env://, lease://)
+# lib/legion/settings/resolver.rb @Esity @future-security-team
+
+# DNS bootstrap
+# lib/legion/settings/dns_bootstrap.rb @Esity @future-infra-team
+
+# Agent loader (role-based profile filtering)
+# lib/legion/settings/agent_loader.rb @Esity @future-core-team
+
+# Specs
+# spec/ @Esity @future-contributors
+
+# Documentation
+# *.md @Esity @future-docs-team
+
+# CI/CD
+# .github/ @Esity

data/README.md

@@ -2,7 +2,7 @@
 
 Configuration management module for the [LegionIO](https://github.com/LegionIO/LegionIO) framework. Loads settings from JSON files, directories, and environment variables. Provides a unified `Legion::Settings[:key]` accessor used by all other Legion gems.
 
-**Version**: 1.3.5
+**Version**: 1.3.9
 
 ## Installation
 

data/lib/legion/settings/agent_loader.rb

@@ -17,6 +17,7 @@ module Legion
             definition = load_file(path)
             next unless definition && valid?(definition)
 
+            log_debug("Agent loaded: #{definition[:name]} (#{path})")
             definition.merge(_source_path: path, _source_mtime: File.mtime(path))
           end
         end
@@ -27,7 +28,8 @@ module Legion
           when '.yaml', '.yml' then YAML.safe_load(content, symbolize_names: true)
           when '.json'         then ::JSON.parse(content, symbolize_names: true)
           end
-        rescue StandardError
+        rescue StandardError => e
+          log_warn("Failed to parse agent file #{path}: #{e.message}")
           nil
         end
 
@@ -39,6 +41,16 @@ module Legion
 
           true
         end
+
+        private
+
+        def log_debug(message)
+          Legion::Logging.debug(message) if defined?(Legion::Logging)
+        end
+
+        def log_warn(message)
+          defined?(Legion::Logging) ? Legion::Logging.warn(message) : warn(message)
+        end
       end
     end
   end

data/lib/legion/settings/dns_bootstrap.rb

@@ -43,7 +43,8 @@ module Legion
         return nil unless response.is_a?(Net::HTTPSuccess)
 
         ::JSON.parse(response.body, symbolize_names: true)
-      rescue StandardError
+      rescue StandardError => e
+        log_warn("DNS bootstrap fetch failed for #{@url}: #{e.message}")
         nil
       end
 
@@ -65,9 +66,11 @@ module Legion
         return nil unless File.exist?(@cache_path)
 
         raw = ::JSON.parse(File.read(@cache_path), symbolize_names: true)
+        log_debug("DNS bootstrap cache hit: #{@cache_path}")
         raw.delete(:_dns_bootstrap_meta)
         raw
       rescue ::JSON::ParserError
+        log_warn("DNS bootstrap cache corrupt, deleting: #{@cache_path}")
         FileUtils.rm_f(@cache_path)
         nil
       end
@@ -75,6 +78,16 @@ module Legion
       def cache_exists?
         File.exist?(@cache_path)
       end
+
+      private
+
+      def log_debug(message)
+        Legion::Logging.debug(message) if defined?(Legion::Logging)
+      end
+
+      def log_warn(message)
+        defined?(Legion::Logging) ? Legion::Logging.warn(message) : warn(message)
+      end
     end
   end
 end

data/lib/legion/settings/loader.rb

@@ -52,23 +52,24 @@ module Legion
           },
           cache:                      { enabled: true, connected: false, driver: 'dalli' },
           extensions:                 {
-            core:              %w[
+            core:               %w[
               lex-node lex-tasker lex-scheduler lex-health lex-ping
               lex-telemetry lex-metering lex-log lex-audit
               lex-conditioner lex-transformer lex-exec lex-lex lex-codegen
             ],
-            ai:                %w[lex-claude lex-openai lex-gemini],
-            gaia:              %w[lex-tick lex-mesh lex-apollo lex-cortex],
-            categories:        {
+            ai:                 %w[lex-claude lex-openai lex-gemini],
+            gaia:               %w[lex-tick lex-mesh lex-apollo lex-cortex],
+            categories:         {
               core:    { type: :list, tier: 1 },
               ai:      { type: :list, tier: 2 },
               gaia:    { type: :list, tier: 3 },
               agentic: { type: :prefix, tier: 4 }
             },
-            blocked:           [],
-            reserved_prefixes: %w[core ai agentic gaia],
-            reserved_words:    %w[transport cache crypt data settings json logging llm rbac legion],
-            agentic:           { allowed: nil, blocked: [] }
+            blocked:            [],
+            reserved_prefixes:  %w[core ai agentic gaia],
+            reserved_words:     %w[transport cache crypt data settings json logging llm rbac legion],
+            agentic:            { allowed: nil, blocked: [] },
+            parallel_pool_size: 24
           },
           reload:                     false,
           reloading:                  false,
@@ -156,10 +157,14 @@ module Legion
       end
 
       def load_module_settings(config)
+        mod_name = config.keys.first
+        log_debug("Loading module settings: #{mod_name}")
         @settings = deep_merge(config, @settings)
       end
 
       def load_module_default(config)
+        mod_name = config.keys.first
+        log_debug("Loading module defaults: #{mod_name}")
         merged = deep_merge(@settings, config)
         deep_diff(@settings, merged) unless @loaded_files.empty?
         @settings = merged
@@ -188,9 +193,9 @@ module Legion
       def load_directory(directory)
         path = directory.gsub(/\\(?=\S)/, '/')
         if File.readable?(path) && File.executable?(path)
-          Dir.glob(File.join(path, '**{,/*/**}/*.json')).uniq.each do |file|
-            load_file(file)
-          end
+          files = Dir.glob(File.join(path, '**{,/*/**}/*.json')).uniq
+          files.each { |file| load_file(file) }
+          log_debug("Loaded directory #{path}: #{files.size} files")
         else
           load_error('insufficient permissions for loading', directory: directory)
         end
@@ -251,8 +256,8 @@ module Legion
         Thread.new do
           fresh = bootstrap.fetch
           bootstrap.write_cache(fresh) if fresh
-        rescue StandardError
-          # Background refresh is best-effort
+        rescue StandardError => e
+          log_warn("DNS background refresh failed: #{e.message}")
         end
       end
 
@@ -399,7 +404,8 @@ module Legion
           search_domains: config[:search]&.map(&:to_s)&.uniq,
           nameservers:    config[:nameserver]&.map(&:to_s)&.uniq
         }
-      rescue StandardError
+      rescue StandardError => e
+        log_warn("Failed to read resolv config: #{e.message}")
         { search_domains: [], nameservers: [] }
       end
 
@@ -408,7 +414,8 @@ module Legion
         return nil if fqdn.nil?
 
         fqdn.include?('.') ? fqdn : nil
-      rescue StandardError
+      rescue StandardError => e
+        log_warn("Failed to detect FQDN: #{e.message}")
         nil
       end
     end

data/lib/legion/settings/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Settings
-    VERSION = '1.3.9'
+    VERSION = '1.3.11'
   end
 end

data/lib/legion/settings.rb

@@ -23,6 +23,7 @@ module Legion
         options[:config_dirs]&.each do |directory|
           @loader.load_directory(directory)
         end
+        logger.info("Settings loaded from #{@loader.loaded_files.size} files")
         @loader
       end
 
@@ -88,9 +89,15 @@ module Legion
         revalidate_all_modules
         run_cross_validations
         detect_unknown_keys
-        return if errors.empty?
+        if errors.empty?
+          logger.info('Settings validation passed')
+          return
+        end
 
-        raise ValidationError, errors unless dev_mode?
+        unless dev_mode?
+          logger.warn("Settings validation failed with #{errors.size} error(s)")
+          raise ValidationError, errors
+        end
 
         warn_validation_errors(errors)
       end
@@ -99,6 +106,7 @@ module Legion
         @loader = load if @loader.nil?
         require 'legion/settings/resolver'
         Resolver.resolve_secrets!(@loader.to_hash)
+        logger.debug('Secret resolution complete')
       end
 
       def schema

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-settings
 version: !ruby/object:Gem::Version
-  version: 1.3.9
+  version: 1.3.11
 platform: ruby
 authors:
 - Esity