legion-settings 1.3.4 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f66aca7decaa9e60f84abf3d4b2538f42a90978289916f535395991161bb8e24
-  data.tar.gz: 41c5f1bac7ec1e12d0034ad872816405588d880542efbe7c420ec958697f1991
+  metadata.gz: 220738db670fe9bbda99acc5d64d903de88268afdc83bb0ef6c482f550b7b769
+  data.tar.gz: b46f3ff6ed58a9a7a0269230814ea2a9204953970c93877747c5d28c23410c8b
 SHA512:
-  metadata.gz: 967b78c6ca4e9e2bee7a2ac1e53c6198a0b0606985e16fca8734c061be6b5b5b4f30e7ed882c387af00554f3323e9008269e036eaec09e9b7ee12d1e1c8ad349
-  data.tar.gz: 2451834575d97a57f1f11c41556f48cf581358624c793d8ac011158b174df2072988d1135af0b9fc3656d1fd608734ab155a2f5b7419d71f77a613e5d8677994
+  metadata.gz: 2e8a71bf3705c3f2a809b454c1bc676f7ab1f7c2e3c2dd1b3d6b317f5126ba84bde201b75a1f65e5111d31f1b67408e173eef8da3683d4d19ee48af83c69bdc0
+  data.tar.gz: a537874627f4d55ee13bb3ec4cbce0e869337a15c0f6c1bfd012a16f081c79f8bb7a56f39d7431c7eb6c1e6e525cda8a98155f534bfac32177a135b1aa96e7cd

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Legion::Settings Changelog
 
+## [1.3.5] - 2026-03-19
+
+### Added
+- DNS-based bootstrap discovery: auto-detect corporate config from `legion-bootstrap.<search-domain>`
+- `Settings[:dns]` populated with FQDN, default domain, search domains, and nameservers
+- `DnsBootstrap` class with DNS resolution, HTTPS fetch, local caching, and background refresh
+- First boot blocks on fetch; subsequent boots use cache with async refresh
+- Opt-out via `LEGION_DNS_BOOTSTRAP=false` environment variable
+
 ## [1.3.4] - 2026-03-18
 
 ### Fixed

data/CLAUDE.md

@@ -8,6 +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.4
 **License**: Apache-2.0
 
 ## Architecture

data/README.md

@@ -2,6 +2,8 @@
 
 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.4
+
 ## Installation
 
 ```bash

data/lib/legion/settings/dns_bootstrap.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'json'
+require 'net/http'
+require 'resolv'
+require 'uri'
+
+module Legion
+  module Settings
+    class DnsBootstrap
+      CACHE_FILENAME = '_dns_bootstrap.json'
+      HOSTNAME_PREFIX = 'legion-bootstrap'
+      URL_PATH = '/legion/bootstrap.json'
+      HTTP_TIMEOUT = 10
+
+      attr_reader :default_domain, :hostname, :url, :cache_path
+
+      def initialize(default_domain:, cache_dir: nil)
+        @default_domain = default_domain
+        @hostname = "#{HOSTNAME_PREFIX}.#{default_domain}"
+        @url = "https://#{@hostname}#{URL_PATH}"
+        dir = cache_dir || File.expand_path('~/.legionio/settings')
+        @cache_path = File.join(dir, CACHE_FILENAME)
+      end
+
+      def resolve?
+        Resolv.getaddress(@hostname)
+        true
+      rescue Resolv::ResolvError, Resolv::ResolvTimeout
+        false
+      end
+
+      def fetch
+        return nil unless resolve?
+
+        uri = URI.parse(@url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        http.open_timeout = HTTP_TIMEOUT
+        http.read_timeout = HTTP_TIMEOUT
+        response = http.request(Net::HTTP::Get.new(uri))
+        return nil unless response.is_a?(Net::HTTPSuccess)
+
+        ::JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError
+        nil
+      end
+
+      def write_cache(config)
+        FileUtils.mkdir_p(File.dirname(@cache_path))
+        payload = config.merge(
+          _dns_bootstrap_meta: {
+            fetched_at: Time.now.utc.iso8601,
+            hostname:   @hostname,
+            url:        @url
+          }
+        )
+        tmp = "#{@cache_path}.tmp"
+        File.write(tmp, ::JSON.pretty_generate(payload))
+        File.rename(tmp, @cache_path)
+      end
+
+      def read_cache
+        return nil unless File.exist?(@cache_path)
+
+        raw = ::JSON.parse(File.read(@cache_path), symbolize_names: true)
+        raw.delete(:_dns_bootstrap_meta)
+        raw
+      rescue ::JSON::ParserError
+        FileUtils.rm_f(@cache_path)
+        nil
+      end
+
+      def cache_exists?
+        File.exist?(@cache_path)
+      end
+    end
+  end
+end

data/lib/legion/settings/loader.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+require 'resolv'
 require 'socket'
 require 'legion/settings/os'
+require_relative 'dns_bootstrap'
 
 module Legion
   module Settings
@@ -19,6 +21,17 @@ module Legion
         @loaded_files = []
       end
 
+      def dns_defaults
+        resolv_config = read_resolv_config
+        {
+          fqdn:           detect_fqdn,
+          default_domain: resolv_config[:search_domains]&.first,
+          search_domains: resolv_config[:search_domains] || [],
+          nameservers:    resolv_config[:nameservers] || [],
+          bootstrap:      { enabled: true }
+        }
+      end
+
       def client_defaults
         {
           hostname: system_hostname,
@@ -71,7 +84,8 @@ module Legion
           },
           transport:                  { connected: false },
           data:                       { connected: false },
-          role:                       { profile: nil, extensions: [] }
+          role:                       { profile: nil, extensions: [] },
+          dns:                        dns_defaults
         }
       end
 
@@ -116,6 +130,27 @@ module Legion
         load_api_env
       end
 
+      def load_dns_bootstrap(cache_dir: nil)
+        return if ENV['LEGION_DNS_BOOTSTRAP'] == 'false'
+
+        domain = @settings.dig(:dns, :default_domain)
+        return unless domain
+        return unless @settings.dig(:dns, :bootstrap, :enabled)
+
+        dir = cache_dir || File.expand_path('~/.legionio/settings')
+        bootstrap = DnsBootstrap.new(default_domain: domain, cache_dir: dir)
+
+        config = if bootstrap.cache_exists?
+                   load_dns_from_cache(bootstrap)
+                 else
+                   load_dns_first_boot(bootstrap)
+                 end
+
+        return unless config
+
+        merge_dns_config(config, bootstrap)
+      end
+
       def load_module_settings(config)
         @settings = deep_merge(config, @settings)
       end
@@ -184,6 +219,39 @@ module Legion
 
       private
 
+      def load_dns_from_cache(bootstrap)
+        config = bootstrap.read_cache
+        start_dns_background_refresh(bootstrap) if config
+        config
+      end
+
+      def load_dns_first_boot(bootstrap)
+        Legion::Logging.debug("DNS bootstrap: first boot, fetching from #{bootstrap.url}")
+        config = bootstrap.fetch
+        bootstrap.write_cache(config) if config
+        config
+      end
+
+      def merge_dns_config(config, bootstrap)
+        @settings = deep_merge(config, @settings)
+        @settings[:dns] ||= {}
+        @settings[:dns][:corp_bootstrap] = {
+          discovered: true,
+          hostname:   bootstrap.hostname,
+          url:        bootstrap.url
+        }
+        @indifferent_access = false
+      end
+
+      def start_dns_background_refresh(bootstrap)
+        Thread.new do
+          fresh = bootstrap.fetch
+          bootstrap.write_cache(fresh) if fresh
+        rescue StandardError
+          # Background refresh is best-effort
+        end
+      end
+
       def setting_category(category)
         @settings[category].map do |name, details|
           details.merge(name: name.to_s)
@@ -301,6 +369,25 @@ module Legion
         Legion::Logging.error(message)
         raise(Error, message)
       end
+
+      def read_resolv_config
+        config = Resolv::DNS::Config.default_config_hash
+        {
+          search_domains: config[:search]&.map(&:to_s)&.uniq,
+          nameservers:    config[:nameserver]&.map(&:to_s)&.uniq
+        }
+      rescue StandardError
+        { search_domains: [], nameservers: [] }
+      end
+
+      def detect_fqdn
+        fqdn = Addrinfo.getaddrinfo(Socket.gethostname, nil).first&.canonname
+        return nil if fqdn.nil?
+
+        fqdn.include?('.') ? fqdn : nil
+      rescue StandardError
+        nil
+      end
     end
   end
 end

data/lib/legion/settings/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Settings
-    VERSION = '1.3.4'
+    VERSION = '1.3.5'
   end
 end

data/lib/legion/settings.rb

@@ -17,6 +17,7 @@ module Legion
       def load(options = {})
         @loader = Legion::Settings::Loader.new
         @loader.load_env
+        @loader.load_dns_bootstrap
         @loader.load_file(options[:config_file]) if options[:config_file]
         @loader.load_directory(options[:config_dir]) if options[:config_dir]
         options[:config_dirs]&.each do |directory|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-settings
 version: !ruby/object:Gem::Version
-  version: 1.3.4
+  version: 1.3.5
 platform: ruby
 authors:
 - Esity
@@ -46,6 +46,7 @@ files:
 - docs/plans/2026-03-17-config-error-filename-implementation.md
 - legion-settings.gemspec
 - lib/legion/settings.rb
+- lib/legion/settings/dns_bootstrap.rb
 - lib/legion/settings/loader.rb
 - lib/legion/settings/os.rb
 - lib/legion/settings/resolver.rb