contrast-agent 7.0.0 → 7.2.0

data/lib/contrast/agent/telemetry/base.rb

@@ -8,6 +8,7 @@ require 'contrast/agent/thread/worker_thread'
 require 'contrast/agent/telemetry/telemetry'
 require 'contrast/agent/telemetry/exception'
 require 'contrast/utils/job_servers_running'
+require 'contrast/agent/reporting/client/interface'
 
 module Contrast
   module Agent
@@ -46,6 +47,39 @@ module Contrast
             @enabled
           end
 
+          # In case of connection error, do not create the background thread or queue,
+          # as if the opt-out env var was set.
+          #
+          # @return [Boolean]
+          def ip_opt_out?
+            @_ip_opt_out ||= begin
+              test_conn = Contrast::Agent::Telemetry::Client.new.initialize_connection(URL)
+
+              if test_conn.nil? || Contrast::Utils::NetHttpBase.last_error
+                # log if error:
+                if defined?(Contrast) && defined?(Contrast::CONFIG) && defined?(Contrast::CONFIG)
+                  Contrast::CONFIG.proto_logger.warn('[Telemetry] connection error disabling...',
+                                                     error: Contrast::Utils::NetHttpBase.last_error)
+
+                end
+                # Disable telemetry:
+                @enabled = false
+                true
+              else
+                # Close the connection
+                test_conn.finish if test_conn.started?
+                false
+              end
+            end
+          rescue StandardError
+            @enabled = false
+            true
+          end
+
+          def disable!
+            @enabled = false
+          end
+
           private
 
           def telemetry_enabled?
@@ -56,26 +90,14 @@ module Contrast
 
             # In case of connection error, do not create the background thread or queue,
             # as if the opt-out env var was set
-            @_client = Contrast::Agent::Telemetry::Client.new
-            ip_opt_out_telemetry = @_client.initialize_connection(URL)
-            if ip_opt_out_telemetry.nil?
-              # TODO: RUBY-2033 we cannot log the error above debug level here b/c it results in
-              #   an infinite loop w/ telemetry
-              logger.debug("[Telemetry] Connection was not established properly!!! \n
-                          Telemetry reporting will be disabled!")
-              return false
-            end
+            return false if ip_opt_out?
 
             true
           end
         end
 
         def client
-          @_client ||= Contrast::Agent::Telemetry::Client.new
-        end
-
-        def connection
-          @_connection ||= client.initialize_connection(URL)
+          @_client ||= Contrast::Agent::Reporting::Telemetry::Interface.new
         end
 
         def attempt_to_start?
@@ -91,6 +113,7 @@ module Contrast
         end
 
         def start_thread!
+          return unless attempt_to_start?
           return if running?
 
           logger.debug('[Telemetry] Starting background telemetry thread.')
@@ -122,16 +145,24 @@ module Contrast
           Contrast::TELEMETRY_EXCEPTIONS&.clear
         end
 
-        def request_with_response event
-          client.handle_response(client.send_request(event, connection))
-        end
-
         private
 
         def queue
           @_queue ||= Queue.new
         end
 
+        # Starts sending Telemetry messages.
+        def process_event event
+          logger.debug('[Telemetry] This is the current processed event', event)
+          if (sleep_time = client.request_with_response(event))
+            return sleep(sleep_time)
+          end
+
+          logger.debug('[Telemetry] Retrying to process event', event)
+          retry_sleep_time = client.request_with_response(event)
+          sleep(retry_sleep_time) unless retry_sleep_time.nil?
+        end
+
         # It is recommended that implementations send a single payload of general metrics every 3 hours, starting from
         # implementation startup. This returns a thread configured to do so.
         #
@@ -139,25 +170,18 @@ module Contrast
         def create_thread
           Contrast::Agent::Thread.new do
             loop do
-              next unless client && connection
+              next unless client.connected?
+              break unless attempt_to_start?
 
               # Start pushing exceptions to queue for reporting.
-              Contrast::TELEMETRY_EXCEPTIONS.each_value { |value| queue << value }
-              Contrast::TELEMETRY_EXCEPTIONS.clear
+              Contrast::TELEMETRY_EXCEPTIONS&.each_value { |value| queue << value }
+              Contrast::TELEMETRY_EXCEPTIONS&.clear
               until queue.empty?
                 event = queue.pop
                 begin
-                  logger.debug('[Telemetry] This is the current processed event', event)
-                  if (sleep_time = request_with_response(event))
-                    sleep(sleep_time)
-                    logger.debug('[Telemetry] Retrying to process event', event)
-                    retry_sleep_time = request_with_response(event)
-                    sleep(retry_sleep_time) unless retry_sleep_time.nil?
-                  end
+                  process_event(event)
                 rescue StandardError => e
-                  # TODO: RUBY-2033 we cannot log the error above debug level here b/c it results in
-                  #   an infinite loop w/ telemetry
-                  logger.debug('[Telemetry] Could not send message to service from telemetry queue.', e)
+                  logger.error('[Telemetry] Could not send message to service from telemetry queue.', e)
                   stop!
                 end
               end

data/lib/contrast/agent/telemetry/client.rb

@@ -100,9 +100,7 @@ module Contrast
         def get_event_json event
           Array(event.to_controlled_hash).to_json
         rescue Exception => e # rubocop:disable Lint/RescueException
-          # TODO: RUBY-2033 we cannot log the error above debug level here b/c it results in
-          #   an infinite loop w/ telemetry
-          logger.debug('[Telemetry] Unable to convert TelemetryEvent to JSON string', e, hsh)
+          logger.error('[Telemetry] Unable to convert TelemetryEvent to JSON string', e, hsh)
           raise(e)
         end
       end

data/lib/contrast/agent/telemetry/exception/obfuscate.rb

@@ -0,0 +1,97 @@
+# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# frozen_string_literal: true
+
+require 'contrast/utils/duck_utils'
+require 'contrast/utils/object_share'
+
+module Contrast
+  module Agent
+    module Telemetry
+      module Exception
+        # Obfuscate sensitive user data before building exception.
+        module Obfuscate
+          CHARS = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'.cs__freeze
+          # This will generate different chars for each agent startup but will be constant
+          # for current run and will make identical obfuscation to be compared if given type
+          # is the same.
+          CYPHER = CHARS.chars.shuffle.join.cs__freeze
+          VERSION_MATCH = '[^0-9].-'
+
+          # List of known places after witch a user name might appear:
+          KNOWN_DIRS = %w[app application project projects git github users home user].cs__freeze
+
+          class << self
+            # Returns paths for known gems.
+            #
+            # @return [Array<Regexp>] known paths
+            def known_paths
+              @_known_paths ||= KNOWN_DIRS.map do |name|
+                to_regexp(name)
+              end
+            end
+
+            # Obfuscate a type and replace it with random characters.
+            #
+            # @param path [String] the StackFrame type to obfuscate
+            # @return [String] obfuscated type
+            def obfuscate_path path
+              return path if Contrast::Utils::DuckUtils.empty_duck?(path)
+
+              cypher(path)
+            end
+
+            private
+
+            # Transforms string to regexp
+            #
+            # @param string [String]
+            def to_regexp string
+              /#{ string }/
+            end
+
+            # Add cypher to path to make it obscure, but unique enough for
+            # comparisons. Mutates original or duplicate if frozen string.
+            #
+            # @param string [String] string to be transformed.
+            # @return [String]
+            def cypher string
+              cypher = string.cs__frozen? ? string.dup : string
+              dirs = cypher.split(Contrast::Utils::ObjectShare::SLASH)
+              return string unless dirs.cs__is_a?(Array)
+
+              dirs.each_with_index do |name, idx|
+                next if Contrast::Utils::DuckUtils.empty_duck?(name)
+                next unless match_known(known_paths,
+                                        name.tr(VERSION_MATCH, Contrast::Utils::ObjectShare::EMPTY_STRING).downcase)
+
+                obscure(name)
+                # obscure username (next dir in line)
+                obscure(dirs[idx + 1]) if dirs[idx + 1]
+              end
+              cypher = dirs.join(Contrast::Utils::ObjectShare::SLASH)
+              return cypher if cypher
+
+              Contrast::Utils::ObjectShare::EMPTY_STRING
+            rescue StandardError
+              Contrast::Utils::ObjectShare::EMPTY_STRING
+            end
+
+            # @param known [Array<Regexp>] Array of regexp to match against
+            # @param type [String] type to check
+            def match_known known, type
+              known.any? { |regexp| type =~ regexp }
+            end
+
+            # Replaces chars in name.
+            #
+            # @param [string] name
+            # @return [String, nil]
+            def obscure name
+              name.to_s.tr!(CHARS, CYPHER)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/contrast/agent/telemetry/exception.rb

@@ -17,3 +17,4 @@ require 'contrast/agent/telemetry/exception/stack_frame'
 require 'contrast/agent/telemetry/exception/message_exception'
 require 'contrast/agent/telemetry/exception/message'
 require 'contrast/agent/telemetry/exception/event'
+require 'contrast/agent/telemetry/exception/obfuscate'

data/lib/contrast/agent/telemetry/telemetry.rb

@@ -92,13 +92,6 @@ module Contrast
         #
         # @return [Boolean]
         def telemetry_exceptions_enabled?
-          opts_out_telemetry = return_value(:telemetry_opt_outs).to_s
-          return false if opts_out_telemetry.casecmp?('true') || opts_out_telemetry == '1'
-          # Double check if telemetry is enabled, this includes a check for Agent enable setting in the
-          # config. In case of disabled Agent the queue won't be created and the Telemetry would not
-          # be enabled. This check is here to prevent a loop of error creations that could no be added
-          # to a queue ( because the client cannot be initialized if the Agent is disabled or settings are
-          # missing).
           return false unless Contrast::Agent::Telemetry::Base.enabled?
 
           true

data/lib/contrast/agent/thread/thread_watcher.rb

@@ -6,7 +6,7 @@ require 'contrast/agent/reporting/report'
 require 'contrast/agent/reporting/reporting_workers/reporting_workers'
 require 'contrast/agent/telemetry/base'
 require 'contrast/agent/protect/input_analyzer/worth_watching_analyzer'
-require 'contrast/config/diagnostics'
+require 'contrast/config/diagnostics/monitor'
 require 'contrast/utils/job_servers_running'
 
 module Contrast
@@ -114,7 +114,7 @@ module Contrast
       def check_before_start
         return if Contrast::CONFIG.send(:validate)
 
-        @_diagnostics = Contrast::Agent::DiagnosticsConfig::Diagnostics.new(Contrast::AGENT.logger.path ||
+        @_diagnostics = Contrast::Config::Diagnostics::Monitor.new(Contrast::AGENT.logger.path ||
                                                                             Contrast::Components::Config::CONTRAST_LOG)
         @_diagnostics.config.populate_fail_connection
         @_diagnostics.write_to_file_logic(false, reset: false)

data/lib/contrast/agent/version.rb

@@ -3,6 +3,6 @@
 
 module Contrast
   module Agent
-    VERSION = '7.0.0'
+    VERSION = '7.2.0'
   end
 end

data/lib/contrast/components/agent.rb

@@ -137,7 +137,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           logger&.to_effective_config(effective_config)

data/lib/contrast/components/api.rb

@@ -127,7 +127,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           add_effective_config_values(effective_config, CONFIG_VALUES, CANON_NAME, CONTRAST)
           effective_proxy(effective_config)
@@ -137,7 +137,7 @@ module Contrast
 
         private
 
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def effective_proxy effective_config
           add_single_effective_value(effective_config, ENABLE, proxy_enable.to_s, PROXY_NAME, "#{ CONTRAST }.proxy")
           return unless proxy_url && proxy_enable

data/lib/contrast/components/app_context.rb

@@ -161,7 +161,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           Contrast::CONFIG.server.to_effective_config(effective_config)

data/lib/contrast/components/assess.rb

@@ -218,7 +218,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           sampling&.to_effective_config(effective_config)

data/lib/contrast/components/assess_rules.rb

@@ -34,7 +34,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           add_single_effective_value(effective_config, SPEC_KEY.to_s, disabled_rules, canon_name, NAME_PREFIX)
         end

data/lib/contrast/components/base.rb

@@ -1,7 +1,7 @@
 # Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
-require 'contrast/config/diagnostics_tools'
+require 'contrast/config/diagnostics/tools'
 require 'contrast/utils/object_share'
 
 module Contrast
@@ -9,7 +9,7 @@ module Contrast
     # All components should inherit from this,
     # whether Interfaces, InstanceMethods or ClassMethods.
     module ComponentBase
-      include Contrast::Agent::DiagnosticsConfig::DiagnosticsTools
+      include Contrast::Config::Diagnostics::Tools
 
       CONTRAST = 'contrast'
       ENABLE = 'enable'
@@ -84,7 +84,7 @@ module Contrast
       # Converts current configuration to effective config values class and appends them to
       # EffectiveConfig class.
       #
-      # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+      # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
       def to_effective_config effective_config
         add_effective_config_values(effective_config, config_values, canon_name, "#{ CONTRAST }.#{ canon_name }")
       end

data/lib/contrast/components/config/sources.rb

@@ -11,11 +11,15 @@ module Contrast
       # This component encapsulates storing the source for each entry in the config,
       # so that we can report on where the value was set from.
       class Sources
-        ENVIRONMENT = 'ENV'
-        CLI = 'CLI'
-        CONTRASTUI = 'ContrastUI'
-        DEFAULT = 'Default'
-        YAML = 'YAML'
+        ENVIRONMENT_VARIABLE = 'ENVIRONMENT_VARIABLE'
+        COMMAND_LINE = 'COMMAND_LINE'
+        CONTRAST_UI = 'CONTRAST_UI'
+        DEFAULT_VALUE = 'DEFAULT_VALUE'
+        APP_CONFIGURATION_FILE = 'USER_CONFIGURATION_FILE'
+        # Order matters for the Configurations files. This is read when Agent starts up and will always go
+        # through the YAML as priority.
+        # Do not change the order!
+        APP_CONFIGURATION_EXTENSIONS = %w[yaml yml].cs__freeze
 
         # @return [Hash]
         attr_reader :data
@@ -30,15 +34,15 @@ module Contrast
         # @param path [String] the canonical name for the config entry (such as api.proxy.enable)
         # @return [String] the source for the entry
         def get path
-          data.dig(*parts_for(path)) || DEFAULT
+          data.dig(*parts_for(path)) || DEFAULT_VALUE
         rescue TypeError
-          DEFAULT
+          DEFAULT_VALUE
         end
 
         # Assigns the config source for a specified config path.
         #
         # @param path [String] the canonical name for the config entry (such as api.proxy.enable)
-        # @param [String] the source for the entry
+        # @param source[String] the source for the entry
         # @return [String] the source type for the entry
         def set path, source
           assign_value(data, parts_for(path), source)
@@ -64,7 +68,7 @@ module Contrast
         # @param current_level [Hash] all, or some of, the config source information
         # @param parts [Array] the parts for canonical name of the config entry
         # @param source [String] the source to be set for the specified entry
-        # @return [Array] the path split on periods, and converted to symbols
+        # @return [String] the path split on periods, and converted to symbols
         def assign_value current_level, parts, source
           parts[0...-1].each do |segment|
             current_level[segment] ||= {}

data/lib/contrast/components/config.rb

@@ -4,7 +4,7 @@
 require 'contrast/utils/env_configuration_item'
 require 'ougai'
 require 'contrast/configuration'
-require 'contrast/config/diagnostics'
+require 'contrast/config/diagnostics/monitor'
 
 module Contrast
   module Components
@@ -249,7 +249,7 @@ module Contrast
           return unless current_level.nil? == false && current_level.cs__respond_to?(dot_path_array[-1])
 
           current_level.send("#{ dot_path_array[-1] }=", value)
-          sources.set(dot_path_array.join('.'), Contrast::Components::Config::Sources::ENVIRONMENT)
+          sources.set(dot_path_array.join('.'), Contrast::Components::Config::Sources::ENVIRONMENT_VARIABLE)
         end
       end
     end

data/lib/contrast/components/protect.rb

@@ -130,7 +130,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           protect_rules_to_effective_config(effective_config)
@@ -138,7 +138,7 @@ module Contrast
 
         private
 
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def protect_rules_to_effective_config effective_config
           return unless defend_rules
 

data/lib/contrast/components/sampling.rb

@@ -136,7 +136,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           confirm_sources
 
@@ -161,10 +161,11 @@ module Contrast
         # back to the default values.
         def confirm_sources
           if sampling_control[:enabled] == DEFAULT_SAMPLING_ENABLED
-            Contrast::CONFIG.sources.set('assess.sampling.enable', Contrast::Components::Config::Sources::DEFAULT)
+            Contrast::CONFIG.sources.set('assess.sampling.enable', Contrast::Components::Config::Sources::DEFAULT_VALUE)
           end
           if sampling_control[:window] == DEFAULT_SAMPLING_WINDOW_MS
-            Contrast::CONFIG.sources.set('assess.sampling.window_ms', Contrast::Components::Config::Sources::DEFAULT)
+            Contrast::CONFIG.sources.set('assess.sampling.window_ms',
+                                         Contrast::Components::Config::Sources::DEFAULT_VALUE)
           end
           {
               'baseline' => :baseline,
@@ -172,7 +173,8 @@ module Contrast
               'response_frequency' => :response_frequency
           }.each do |k, v|
             if sampling_control[v] == cs__class.cs__const_get("DEFAULT_SAMPLING_#{ v.upcase }")
-              Contrast::CONFIG.sources.set("assess.sampling.#{ k }", Contrast::Components::Config::Sources::DEFAULT)
+              Contrast::CONFIG.sources.set("assess.sampling.#{ k }",
+                                           Contrast::Components::Config::Sources::DEFAULT_VALUE)
             end
           end
         end

data/lib/contrast/components/settings.rb

@@ -5,6 +5,7 @@ require 'contrast/agent/excluder/excluder'
 require 'contrast/agent/reporting/settings/sensitive_data_masking'
 require 'contrast/components/config'
 require 'contrast/components/logger'
+require 'contrast/utils/duck_utils'
 
 module Contrast
   module Components
@@ -219,6 +220,14 @@ module Contrast
           exclusions.input_exclusions.each do |exclusion|
             matchers << Contrast::Agent::ExclusionMatcher.new(exclusion)
           end
+          # Do not populate the matchers unless we have any. There are certain checks in
+          # SourceMethod that will safe-guard return if there are no exclusions received.
+          # The matching operation is expensive, and the excluder calls are made for each
+          # source, and we do not want to check for exclusions if they are empty. This is
+          # probably redundant as all exclusions default to empty, but will save useless
+          # new object creation at very least.
+          return if Contrast::Utils::DuckUtils.empty_duck?(matchers)
+
           @excluder = Contrast::Agent::Excluder.new(matchers)
         end
 
@@ -283,7 +292,7 @@ module Contrast
           return unless level.cs__is_a?(Hash)
 
           level[parts[-1]] = value
-          Contrast::CONFIG.sources.set(parts.join('.'), Contrast::Components::Config::Sources::CONTRASTUI)
+          Contrast::CONFIG.sources.set(parts.join('.'), Contrast::Components::Config::Sources::CONTRAST_UI)
         end
       end
     end

data/lib/contrast/config/certification_configuration.rb

@@ -38,7 +38,7 @@ module Contrast
       # Converts current configuration to effective config values class and appends them to
       # EffectiveConfig class.
       #
-      # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+      # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
       def to_effective_config effective_config
         add_effective_config_values(effective_config, CONFIG_VALUES, CANON_NAME, CONTRAST)
       end

data/lib/contrast/config/configuration_files.rb

@@ -0,0 +1,47 @@
+# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# frozen_string_literal: true
+
+require 'contrast/utils/duck_utils'
+require 'contrast/utils/object_share'
+require 'contrast/components/config/sources'
+require 'contrast/config/diagnostics/tools'
+
+module Contrast
+  module Config
+    # This class will hold all the references for the configuration files. It will safe read values used to
+    # identify the source of configuration in Configuration Diagnostics reported to TS.
+    class ConfigurationFiles
+      # @return [String] path of the main configuration file.
+      attr_accessor :main_file
+
+      # @return [Array<Contrast::Config::LocalSourceValue>]
+      def source_files
+        @_source_files ||= []
+      end
+
+      # @param path [String]
+      # @param values [Hash]
+      def add_source_file path, values
+        source_files << Contrast::Config::LocalSourceValue.new(path, values)
+        @main_file = path if source_files.length == 1
+      end
+    end
+
+    # This class will hold all the info about the read file.
+    class LocalSourceValue
+      YML_EXT = '.yml'
+      YAML_EXT = '.yaml'
+      # @return [String]
+      attr_reader :path
+      # @return [Hash]
+      attr_reader :values
+
+      # @param path [String]
+      # @param values [Hash]
+      def initialize path = '', values = {}
+        @path = path unless Contrast::Utils::DuckUtils.empty_duck?(path)
+        @values = values
+      end
+    end
+  end
+end

data/lib/contrast/config/diagnostics/command_line.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# frozen_string_literal: true
+
+require 'contrast/config/diagnostics/effective_config_value'
+require 'contrast/config/diagnostics/tools'
+require 'contrast/utils/object_share'
+
+module Contrast
+  module Config
+    module Diagnostics
+      # Reads All ENV variables.
+      module CommandLine
+        class << self
+          def command_line_settings
+            cli = Contrast::Config::Diagnostics::Tools.flatten_settings(Contrast::CONFIG.sources.
+              for(Contrast::Components::Config::Sources::COMMAND_LINE))
+
+            Contrast::Config::Diagnostics::Tools.to_config_values(cli, source: true)
+          end
+        end
+      end
+    end
+  end
+end