appium_failure_helper 1.4.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b1148ccbdea9b7b8446bf489a8f325e6dd4255cbeeba75ed58469f21169a126
-  data.tar.gz: 646ef386ee881d2f9cccf4ca3e85f8a79bd3cd132221c537e6db3f07c719f91f
+  metadata.gz: 3ef5fd316590ddca6a0b9ccc21b06f947c3b439fb998668b2b965ae5f110702a
+  data.tar.gz: af17ce648f330a535cd5d0582fd4441f2cbcc881fd67626e8516a202655e747e
 SHA512:
-  metadata.gz: f345294b82fad66aa0b47e3455a85063caef1f292225f9954d5bd10a0370f29e9ba51c15d7caeed219c4e587b84f115e4e762e7b16f9408bacdc91dbce8aaf55
-  data.tar.gz: 505c2e690da3d723c5afb43a7afb1f219bca682e45e1c8c14068c98072c1331c90fecbe764312fe4ad3071d95df57106068b4feea5c4ca68c736b5fcbcd647dd
+  metadata.gz: bec158f942080f960031179836e9830ea7f3fd2cc48117d5b803d5156d0ed89ee27bf1377c10a36f7ec4be92aeea7c9eac60e2232c77e75a5c19fd390b9fb306
+  data.tar.gz: 66a21888247d7bb983556428f3aad65dfa8fd9b3f576d670bc736a4db1e520b9874b2b01628b9fc7f3ad94dd06363d2d0faacb78c6ad042d373eb60c75ffcd84

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/Appium_failure_helper.iml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="appium_lib (v10.6.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="appium_lib_core (v3.11.1, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="base64 (v0.3.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.6.8, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cgi (v0.5.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="childprocess (v3.0.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="date (v3.4.1, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="diff-lcs (v1.6.2, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="erb (v4.0.4, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="eventmachine (v1.2.7, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faye-websocket (v0.11.4, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ffi (v1.17.2, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="io-console (v0.8.1, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="irb (v1.15.2, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.18.10, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="pp (v0.6.2, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="prettyprint (v0.2.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="psych (v5.2.6, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="racc (v1.8.1, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.3.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rdoc (v6.14.2, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="reline (v0.6.2, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec (v3.13.1, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-core (v3.13.5, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-expectations (v3.13.5, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-mocks (v3.13.5, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-support (v3.13.6, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubyzip (v3.1.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="selenium-webdriver (v3.142.7, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="stringio (v3.1.7, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tomlrb (v1.3.0, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="websocket-driver (v0.7.7, ruby-3.1.7-p261) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="websocket-extensions (v0.1.5, ruby-3.1.7-p261) [gem]" level="application" />
+  </component>
+</module>

data/.idea/misc.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="ruby-3.1.7-p261" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/Appium_failure_helper.iml" filepath="$PROJECT_DIR$/.idea/Appium_failure_helper.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

data/lib/appium_failure_helper/analyzer.rb

@@ -2,12 +2,10 @@ module AppiumFailureHelper
   module Analyzer
     def self.triage_error(exception)
       case exception
-      when Selenium::WebDriver::Error::NoSuchElementError, 
-           Selenium::WebDriver::Error::TimeoutError,
-           Selenium::WebDriver::Error::UnknownCommandError
-        :locator_issue
-      when Selenium::WebDriver::Error::TimeoutError, 
-           Appium::Core::Wait::TimeoutError
+      when Selenium::WebDriver::Error::NoSuchElementError,
+        Selenium::WebDriver::Error::TimeoutError,
+        Selenium::WebDriver::Error::UnknownCommandError,
+        defined?(Appium::Core::Wait::TimeoutError) ? Appium::Core::Wait::TimeoutError : nil
         :locator_issue
       when Selenium::WebDriver::Error::ElementNotInteractableError
         :visibility_issue
@@ -30,69 +28,52 @@ module AppiumFailureHelper
     def self.extract_failure_details(exception)
       message = exception.message.to_s
       info = {}
-      patterns = [
-        /using "([^"]+)" with value "([^"]+)"/,
-        /element with locator ['"]?(#?\w+)['"]?/i,
-        /(?:could not be found|cannot find element) using (.+?)=['"]?([^'"]+)['"]?/i,
-        /no such element: Unable to locate element: {"method":"([^"]+)","selector":"([^"]+)"}/i,
-      ]
-      patterns.each do |pattern|
-        match = message.match(pattern)
-        if match
-          if match.captures.size == 2
-            info[:selector_type], info[:selector_value] = match.captures.map(&:strip)
-          else
-            info[:selector_value] = match.captures.first.strip
-            info[:selector_type] = 'logical_name'
-          end
-          return info
-        end
+      pattern = /using "([^"]+)" with value "([^"]+)"/
+      match = message.match(pattern)
+      if match
+        info[:selector_type], info[:selector_value] = match.captures
       end
       info
     end
-    
-    def self.find_de_para_match(failed_info, element_map)
-      failed_value = (failed_info || {})[:selector_value].to_s
-      return nil if failed_value.empty?
-      logical_name_key = failed_value.gsub(/^#/, '')
-      if element_map.key?(logical_name_key)
-        return { logical_name: logical_name_key, correct_locator: element_map[logical_name_key] }
-      end
-      cleaned_failed_locator = failed_value.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
-      element_map.each do |name, locator_info|
-        mapped_locator = (locator_info || {})['valor'].to_s
-        cleaned_mapped_locator = mapped_locator.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
-        distance = DidYouMean::Levenshtein.distance(cleaned_failed_locator, cleaned_mapped_locator)
-        max_len = [cleaned_failed_locator.length, cleaned_mapped_locator.length].max
-        next if max_len.zero?
-        similarity_score = 1.0 - (distance.to_f / max_len)
-        if similarity_score > 0.85
-          return { logical_name: name, correct_locator: locator_info }
+
+    def self.perform_advanced_analysis(failed_info, all_page_elements, platform)
+      return nil if failed_info.empty? || all_page_elements.empty?
+      expected_attrs = parse_locator(failed_info[:selector_type], failed_info[:selector_value], platform)
+      return nil if expected_attrs.empty?
+
+      id_key_to_check = (platform.to_s == 'ios') ? 'name' : 'resource-id'
+      candidates = all_page_elements.map do |element_on_screen|
+        score = 0
+        analysis = {}
+
+        if expected_attrs[id_key_to_check]
+          actual_id = element_on_screen[:attributes][id_key_to_check]
+          distance = DidYouMean::Levenshtein.distance(expected_attrs[id_key_to_check].to_s, actual_id.to_s)
+          max_len = [expected_attrs[id_key_to_check].to_s.length, actual_id.to_s.length].max
+          similarity = max_len.zero? ? 0 : 1.0 - (distance.to_f / max_len)
+          score += 100 * similarity
+          analysis[id_key_to_check.to_sym] = { similarity: similarity, expected: expected_attrs[id_key_to_check], actual: actual_id }
         end
-      end
-      nil
+
+        { score: score, name: element_on_screen[:name], attributes: element_on_screen[:attributes], analysis: analysis } if score > 75
+      end.compact
+
+      candidates.sort_by { |c| -c[:score] }.first
     end
 
-    def self.find_similar_elements(failed_info, all_page_suggestions)
-      failed_locator_value = (failed_info || {})[:selector_value]
-      failed_locator_type = (failed_info || {})[:selector_type]
-      return [] unless failed_locator_value && failed_locator_type
-      normalized_failed_type = failed_locator_type.to_s.downcase.include?('id') ? 'id' : failed_locator_type.to_s
-      cleaned_failed_locator = failed_locator_value.to_s.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
-      similarities = []
-      all_page_suggestions.each do |suggestion|
-        candidate_locator = (suggestion[:locators] || []).find { |loc| loc[:strategy] == normalized_failed_type }
-        next unless candidate_locator
-        cleaned_candidate_locator = candidate_locator[:locator].gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
-        distance = DidYouMean::Levenshtein.distance(cleaned_failed_locator, cleaned_candidate_locator)
-        max_len = [cleaned_failed_locator.length, cleaned_candidate_locator.length].max
-        next if max_len.zero?
-        similarity_score = 1.0 - (distance.to_f / max_len)
-        if similarity_score > 0.85
-          similarities << { name: suggestion[:name], locators: suggestion[:locators], score: similarity_score, attributes: suggestion[:attributes] }
-        end
+    private
+
+    def self.parse_locator(type, value, platform)
+      attrs = {}
+      if platform.to_s == 'ios'
+        attrs['name'] = value if type.to_s.include?('id')
+      else # Android
+        attrs['resource-id'] = value if type.to_s.include?('id')
+      end
+      if type.to_s == 'xpath'
+        value.scan(/@([\w\-]+)='([^']+)'/).each { |match| attrs[match[0]] = match[1] }
       end
-      similarities.sort_by { |s| -s[:score] }.first(5)
+      attrs
     end
   end
 end

data/lib/appium_failure_helper/element_repository.rb

@@ -1,6 +1,7 @@
 # lib/appium_failure_helper/element_repository.rb
 module AppiumFailureHelper
   module ElementRepository
+    ELEMENTS = {}
     def self.load_all
       config = AppiumFailureHelper.configuration
       base_path = config.elements_path
@@ -38,48 +39,26 @@ module AppiumFailureHelper
       map
     end
     
-    def self.load_all_from_yaml(base_path)
-      elements_map = {}
-      glob_path = File.join(base_path, '**', '*.yaml')
-      files_found = Dir.glob(glob_path)
-      files_found.each do |file|
-        next if file.include?('reports_failure')
+    def self.load_all_from_yaml(dir_path = 'features/elements')
+      Dir.glob("#{dir_path}/*.yaml").each do |file|
         begin
-          data = YAML.load_file(file)
-          if data.is_a?(Hash)
-            data.each do |k, v|
-              data[k] = normalize_element(v)
-            end
-            elements_map.merge!(data)
+          yaml_data = YAML.load_file(file)
+          yaml_data.each do |key, value|
+            ELEMENTS[key.to_sym] = normalize_element(value)
           end
         rescue => e
           Utils.logger.warn("Aviso: Erro ao carregar o arquivo YAML #{file}: #{e.message}")
         end
       end
-      elements_map
+      Utils.logger.info("Número de elementos carregados: #{ELEMENTS.size}")
+      ELEMENTS
     end
 
-    def self.normalize_yaml_hash_keys(obj)
-      case obj
-      when Hash
-        result = {}
-        obj.each do |k, v|
-          k_s = k.to_s
-          v_n = normalize_yaml_hash_keys(v)
-          # Se v_n é um Hash com chaves :value ou 'valor' -> faça unificação para 'value'
-          if v_n.is_a?(Hash)
-            if v_n.key?('valor') && !v_n.key?('value')
-              v_n['value'] = v_n.delete('valor')
-            end
-            # também converte :tipoBusca para 'tipoBusca' (string)
-          end
-          result[k_s] = v_n
-        end
-        result
-      when Array
-        obj.map { |el| normalize_yaml_hash_keys(el) }
-      else
-        obj
+    def self.normalize_element(element_hash)
+      # Ajuste para garantir keys simbólicas e paths padrão
+      element_hash.transform_keys(&:to_sym).tap do |h|
+        h[:selector_type] ||= h[:type] || 'unknown'
+        h[:selector_value] ||= h[:value] || 'unknown'
       end
     end
   end

data/lib/appium_failure_helper/handler.rb

@@ -14,74 +14,158 @@ module AppiumFailureHelper
     def call
       begin
         unless @driver && @driver.session_id
-          Utils.logger.error("Helper não executado: driver nulo ou sessão encerrada.")
           return
         end
 
         FileUtils.mkdir_p(@output_folder)
-        
 
         triage_result = Analyzer.triage_error(@exception)
-        
+        platform_value = @driver.capabilities[:platform_name] || @driver.capabilities['platformName']
+        platform = platform_value&.downcase || 'unknown'
+
         report_data = {
-          exception: @exception,
-          triage_result: triage_result,
-          timestamp: @timestamp,
-          platform: @driver.capabilities['platformName'] || @driver.capabilities[:platform_name] || 'unknown',
-          screenshot_base64: @driver.screenshot_as(:base64)
+          exception: @exception, triage_result: triage_result,
+          timestamp: @timestamp, platform: platform,
+          screenshot_base_64: @driver.screenshot_as(:base64)
         }
 
         if triage_result == :locator_issue
-          page_source = @driver.page_source rescue nil
+          page_source = @driver.page_source
           doc = Nokogiri::XML(page_source)
 
-          # Inicializa failed_info primeiro
           failed_info = Analyzer.extract_failure_details(@exception) || {}
-          failed_info = SourceCodeAnalyzer.extract_from_exception(@exception) || {} if failed_info.empty?
-          failed_info = { selector_type: 'unknown', selector_value: 'unknown' } if failed_info.empty?
-
-          # Monta o report_data
-          report_data[:page_source] = page_source
-          report_data[:failed_element] = failed_info
+          if failed_info.empty?
+            failed_info = SourceCodeAnalyzer.extract_from_exception(@exception) || {}
+          end
 
-          # Analisa elementos similares, alternative xpaths, de_para, code search etc
-          unless failed_info.empty?
-            page_analyzer = PageAnalyzer.new(page_source, report_data[:platform].to_s)
+          if failed_info.empty?
+            report_data[:triage_result] = :unidentified_locator_issue
+          else
+            page_analyzer = PageAnalyzer.new(page_source, platform)
             all_page_elements = page_analyzer.analyze || []
-            similar_elements = Analyzer.find_similar_elements(failed_info, all_page_elements) || []
+
+            best_candidate_analysis = Analyzer.perform_advanced_analysis(failed_info, all_page_elements, platform)
 
             alternative_xpaths = []
-            if !similar_elements.empty?
-              target_suggestion = similar_elements.first
-              if target_suggestion[:attributes] && (target_path = target_suggestion[:attributes][:path])
+            if best_candidate_analysis
+              if best_candidate_analysis[:attributes] && (target_path = best_candidate_analysis[:attributes][:path])
                 target_node = doc.at_xpath(target_path)
-                alternative_xpaths = XPathFactory.generate_for_node(target_node) if target_node
+                if target_node
+                  alternative_xpaths = XPathFactory.generate_for_node(target_node)
+                end
               end
             end
 
-            unified_element_map = ElementRepository.load_all
-            de_para_result = Analyzer.find_de_para_match(failed_info, unified_element_map)
-            code_search_results = CodeSearcher.find_similar_locators(failed_info) || []
-
-            report_data.merge!(
-              similar_elements: similar_elements,
-              alternative_xpaths: alternative_xpaths,
-              de_para_analysis: de_para_result,
-              code_search_results: code_search_results,
-              all_page_elements: all_page_elements
-            )
+            report_data.merge!({
+                                 page_source: page_source,
+                                 failed_element: failed_info,
+                                 best_candidate_analysis: best_candidate_analysis,
+                                 alternative_xpaths: alternative_xpaths,
+                                 all_page_elements: all_page_elements
+                               })
           end
+        end
 
-          # Gera o relatório
-          ReportGenerator.new(@output_folder, report_data).generate_all
-          Utils.logger.info("Relatórios gerados com sucesso em: #{@output_folder}")
+        ReportGenerator.new(@output_folder, report_data).generate_all
+        Utils.logger.info("Relatórios gerados com sucesso em: #{@output_folder}")
+      rescue => e
+        puts "--- ERRO FATAL NA GEM ---"
+        puts "CLASSE: #{e.class}, MENSAGEM: #{e.message}"
+        puts e.backtrace.join("\n")
+        puts "-------------------------"
+      end
+      report_data
+    end
 
-          report_data
-          return
+    private
+
+    def fetch_failed_element
+      msg = @exception&.message.to_s
+
+      if (m = msg.match(/using\s+["']?([^"']+)["']?\s+with\s+value\s+["']([^"']+)["']/i))
+        return { selector_type: m[1], selector_value: m[2] }
+      end
+
+      if (m = msg.match(/"method"\s*:\s*"([^"]+)"[\s,}].*"selector"\s*:\s*"([^"]+)"/i))
+        return { selector_type: m[1], selector_value: m[2] }
+      end
+
+      if (m = msg.match(/["']([^"']+)["']/))
+        maybe_value = m[1]
+        unified_map = ElementRepository.load_all rescue {}
+        found = find_in_element_repository_by_value(maybe_value, unified_map)
+        if found
+          return found
+        end
+
+        guessed_type = msg[/\b(xpath|id|accessibility id|css)\b/i] ? $&.downcase : nil
+        return { selector_type: guessed_type || 'unknown', selector_value: maybe_value }
+      end
+
+      begin
+        code_info = SourceCodeAnalyzer.extract_from_exception(@exception) rescue {}
+        unless code_info.nil? || code_info.empty?
+          return code_info
+        end
+      rescue => _; end
+
+      unified_map = ElementRepository.load_all rescue {}
+      unified_map.each do |k, v|
+        k_str = k.to_s.downcase
+        if msg.downcase.include?(k_str)
+          return normalize_repo_element(v)
+        end
+        vals = []
+        if v.is_a?(Hash)
+          vals << v['valor'] if v.key?('valor')
+          vals << v['value'] if v.key?('value')
+          vals << v[:valor] if v.key?(:valor)
+          vals << v[:value] if v.key?(:value)
+        end
+        vals.compact!
+        vals.each do |vv|
+          if vv.to_s.downcase == vv.to_s.downcase && msg.downcase.include?(vv.to_s.downcase)
+            return normalize_repo_element(v)
+          end
+        end
+      end
+
+      # final fallback
+      debug_log("fetch_failed_element: fallback unknown")
+      { selector_type: 'unknown', selector_value: 'unknown' }
+    end
+
+    def find_in_element_repository_by_value(value, map = {})
+      return nil if value.nil? || value.to_s.strip.empty?
+      normalized_value = value.to_s.downcase.strip
+      map.each do |k, v|
+        entry = v.is_a?(Hash) ? v : (v.respond_to?(:to_h) ? v.to_h : nil)
+        next unless entry
+        entry_val = entry['valor'] || entry['value'] || entry[:valor] || entry[:value] || entry['locator'] || entry[:locator]
+        next unless entry_val
+        return normalize_repo_element(entry) if entry_val.to_s.downcase.strip == normalized_value
+      end
+      nil
+    end
+
+    def normalize_repo_element(entry)
+      return nil unless entry.is_a?(Hash)
+      tipo = entry['tipoBusca'] || entry[:tipoBusca] || entry['type'] || entry[:type] || entry['search_type'] || entry[:search]
+      valor = entry['valor'] || entry[:value] || entry[:locator] || entry[:valor_final] || entry[:value_final]
+      return nil unless valor
+      { selector_type: (tipo || 'unknown'), selector_value: valor.to_s }
+    end
+
+    def generate_alternative_xpaths(similar_elements, doc)
+      alternative_xpaths = []
+      if !similar_elements.empty?
+        target_suggestion = similar_elements.first
+        if target_suggestion[:attributes] && (target_path = target_suggestion[:attributes][:path])
+          target_node = doc.at_xpath(target_path) rescue nil
+          alternative_xpaths = XPathFactory.generate_for_node(target_node) if target_node
         end
-      rescue => e
-        Utils.logger.error("Erro fatal na GEM de diagnóstico: #{e.message}\n#{e.backtrace.join("\n")}")
       end
+      alternative_xpaths
     end
   end
-end
+end

data/lib/appium_failure_helper/page_analyzer.rb

@@ -20,28 +20,20 @@ module AppiumFailureHelper
       @platform = platform
     end
 
-     def analyze
-      seen_elements = {}
+    def analyze
       all_elements_suggestions = []
       @doc.xpath('//*').each do |node|
-          next if ['hierarchy', 'AppiumAUT'].include?(node.name)
-          attrs = node.attributes.transform_values(&:value)
-          
-          unique_key = node.path
-          next if seen_elements[unique_key]
+        next if ['hierarchy', 'AppiumAUT'].include?(node.name)
 
-          name = suggest_name(node.name, attrs)
-          
-          locators = XPathFactory.generate_for_node(node)
-          
-         all_elements_suggestions << { 
-            name: name, 
-            locators: locators, 
-            attributes: attrs.merge(tag: node.name, path: node.path) 
-          }
-          seen_elements[unique_key] = true
+        attrs = node.attribute_nodes.to_h { |attr| [attr.name, attr.value] }
+
+        attrs['tag'] = node.name
+        name = suggest_name(node.name, attrs)
+        locators = XPathFactory.generate_for_node(node)
+
+        all_elements_suggestions << { name: name, locators: locators, attributes: attrs.merge(path: node.path) }
       end
-      all_elements_suggestions
+      all_elements_suggestions.uniq { |s| s[:attributes][:path] }
     end
 
     private

data/lib/appium_failure_helper/report_generator.rb

@@ -3,7 +3,7 @@ module AppiumFailureHelper
     def initialize(output_folder, report_data)
       @output_folder = output_folder
       @data = report_data
-      @page_source = report_data[:page_source] # Pega o page_source de dentro do hash
+      @page_source = report_data[:page_source]
     end
 
     def generate_all
@@ -18,7 +18,7 @@ module AppiumFailureHelper
       File.write("#{@output_folder}/page_source_#{@data[:timestamp]}.xml", @page_source)
     end
 
-     def generate_yaml_reports
+    def generate_yaml_reports
       analysis_report = {
         triage_result: @data[:triage_result],
         exception_class: @data[:exception].class.to_s,
@@ -27,86 +27,97 @@ module AppiumFailureHelper
         best_candidate_analysis: @data[:best_candidate_analysis]
       }
       File.open("#{@output_folder}/failure_analysis_#{@data[:timestamp]}.yaml", 'w') { |f| f.write(YAML.dump(analysis_report)) }
-      
+
       if @data[:all_page_elements]
         File.open("#{@output_folder}/all_elements_dump_#{@data[:timestamp]}.yaml", 'w') { |f| f.write(YAML.dump(@data[:all_page_elements])) }
       end
     end
 
     def generate_html_report
-      html_content = case @data[:triage_result]
-                     when :locator_issue
+      html_content = if @data[:triage_result] == :locator_issue && !(@data[:failed_element] || {}).empty?
                        build_full_report
                      else
                        build_simple_diagnosis_report(
                          title: "Diagnóstico Rápido de Falha",
-                         message: "A falha não foi causada por um seletor não encontrado ou a análise do seletor falhou. Verifique a mensagem de erro original e o stack trace para a causa raiz."
+                         message: "A análise profunda do seletor não foi executada ou falhou. Verifique a mensagem de erro original e o stack trace."
                        )
                      end
-      
       File.write("#{@output_folder}/report_#{@data[:timestamp]}.html", html_content)
     end
 
     def build_full_report
       failed_info = @data[:failed_element] || {}
-      similar_elements = @data[:similar_elements] || []
       all_suggestions = @data[:all_page_elements] || []
-      de_para_analysis = @data[:de_para_analysis]
-      code_search_results = @data[:code_search_results] || []
+      best_candidate = @data[:best_candidate_analysis]
       alternative_xpaths = @data[:alternative_xpaths] || []
       timestamp = @data[:timestamp]
       platform = @data[:platform]
-      screenshot_base64 = @data[:screenshot_base64]
+      screenshot_base64 = @data[:screenshot_base_64]
 
       locators_html = lambda do |locators|
-        (locators || []).map do |loc|
-          strategy_text = loc[:strategy].to_s.upcase.gsub('_', ' ')
-          "<li class='flex justify-between items-center bg-gray-50 p-2 rounded-md mb-1 text-xs font-mono'><span class='font-bold text-indigo-600'>#{CGI.escapeHTML(strategy_text)}:</span><span class='text-gray-700 ml-2 overflow-auto max-w-[70%]'>#{CGI.escapeHTML(loc[:locator])}</span></li>"
-        end.join
+        (locators || []).map { |loc| "<li class='flex justify-between items-center bg-gray-50 p-2 rounded-md mb-1 text-xs font-mono'><span class='font-bold text-indigo-600'>#{CGI.escapeHTML(loc[:strategy].to_s.upcase.gsub('_', ' '))}:</span><span class='text-gray-700 ml-2 overflow-auto max-w-[70%]'>#{CGI.escapeHTML(loc[:locator])}</span></li>" }.join
       end
 
       all_elements_html = lambda do |elements|
         (elements || []).map { |el| "<details class='border-b border-gray-200 py-3'><summary class='font-semibold text-sm text-gray-800 cursor-pointer'>#{CGI.escapeHTML(el[:name])}</summary><ul class='text-xs space-y-1 mt-2'>#{locators_html.call(el[:locators])}</ul></details>" }.join
       end
-      
-      failed_info_content = "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{CGI.escapeHTML(failed_info[:selector_type].to_s)}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-all'>#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</span></p>"
 
-      code_search_html = "" # (Sua lógica code_search_html)
-      failed_info_content = if failed_info && !failed_info.empty?
-         "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{CGI.escapeHTML(failed_info[:selector_type].to_s)}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-all'>#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</span></p>"
-      else
-        "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído.</p>"
-      end
+      failed_info_content = "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{CGI.escapeHTML(failed_info[:selector_type].to_s)}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-words'>#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</span></p>"
 
-      code_search_html = ""
-      unless code_search_results.empty?
-        suggestions_list = code_search_results.map do |match|
-          score_percent = (match[:score] * 100).round(1)
-          "<div class='border border-sky-200 bg-sky-50 p-3 rounded-lg mb-2'><p class='text-sm text-gray-600'>Encontrado em: <strong class='font-mono'>#{match[:file]}:#{match[:line_number]}</strong></p><pre class='bg-gray-800 text-white p-2 rounded mt-2 text-xs overflow-auto'><code>#{CGI.escapeHTML(match[:code])}</code></pre><p class='text-xs text-green-600 mt-1'>Similaridade: #{score_percent}%</p></div>"
-        end.join
-        code_search_html = "<div class='bg-white p-4 rounded-lg shadow-md'><h2 class='text-xl font-bold text-sky-700 mb-4'>Sugestões Encontradas no Código</h2>#{suggestions_list}</div>"
-      end
+      advanced_analysis_html = if best_candidate.nil?
+                                 "<p class='text-gray-500'>Nenhum candidato provável foi encontrado na tela atual para uma análise detalhada.</p>"
+                               else
+                                 analysis_details = (best_candidate[:analysis] || {}).map do |key, data|
+                                   status_color = 'bg-gray-400'
+                                   status_icon = '⚪'
+                                   status_text = "<b>#{key.capitalize}:</b><span class='ml-2 text-gray-700'>Não verificado</span>"
 
-      # --- LÓGICA RESTAURADA: ELEMENTO COM FALHA ---
-      failed_info_content = if failed_info && !failed_info.empty?
-         "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{CGI.escapeHTML(failed_info[:selector_type].to_s)}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-all'>#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</span></p>"
-      else
-        "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído.</p>"
-      end
+                                   if data[:match] == true || (data[:similarity] && data[:similarity] == 1.0)
+                                     status_color = 'bg-green-500'
+                                     status_icon = '✅'
+                                     status_text = "<b>#{key.capitalize}:</b><span class='ml-2 text-gray-700'>Correspondência Exata!</span>"
+                                   elsif data[:similarity] && data[:similarity] > 0.7
+                                     status_color = 'bg-yellow-500'
+                                     status_icon = '⚠️'
+                                     status_text = "<b>#{key.capitalize}:</b><span class='ml-2 text-gray-700'>Parecido (Encontrado: '#{CGI.escapeHTML(data[:actual])}')</span>"
+                                   else
+                                     status_color = 'bg-red-500'
+                                     status_icon = '❌'
+                                     status_text = "<b>#{key.capitalize}:</b><span class='ml-2 text-gray-700'>Diferente! Esperado: '#{CGI.escapeHTML(data[:expected].to_s)}'</span>"
+                                   end
+
+                                   "<li class='flex items-center text-sm'><span class='w-4 h-4 rounded-full #{status_color} mr-3 flex-shrink-0 flex items-center justify-center text-white text-xs'>#{status_icon}</span><div class='truncate'>#{status_text}</div></li>"
+                                 end.join
+
+                                 suggestion_text = "O `resource-id` pode ter mudado ou o `text` está diferente. Considere usar um seletor mais robusto baseado nos atributos que corresponderam."
+                                 if (best_candidate[:analysis][:id] || {})[:match] == true && (best_candidate[:analysis][:text] || {})[:similarity].to_f < 0.7
+                                   suggestion_text = "O `resource-id` corresponde, mas o texto é diferente. **Recomendamos fortemente usar o `resource-id` para este seletor.**"
+                                 end
 
-     repair_suggestions_content = if alternative_xpaths.empty?
-        "<p class='text-gray-500'>Nenhuma estratégia de localização alternativa pôde ser gerada.</p>"
-      else
-        pages = alternative_xpaths.each_slice(6).to_a
-        carousel_items = pages.map do |page_strategies|
-          strategy_list_html = page_strategies.map do |strategy|
-            reliability_color = case strategy[:reliability]
-                                when :alta then 'bg-green-100 text-green-800'
-                                when :media then 'bg-yellow-100 text-yellow-800'
-                                else 'bg-red-100 text-red-800'
-                                end
-            # CORREÇÃO: Adiciona o tipo de estratégia (ID, XPATH) ao lado do seletor
-            <<~STRATEGY_ITEM
+                                 <<~HTML
+                                  <div class='border border-sky-200 bg-sky-50 p-4 rounded-lg'>
+                                    <h4 class='font-bold text-sky-800 mb-3'>Candidato Mais Provável Encontrado: <span class='font-mono bg-sky-100 text-sky-900 rounded px-2 py-1 text-sm'>#{CGI.escapeHTML(best_candidate[:name])}</span></h4>
+                                    <ul class='space-y-2 mb-4'>#{analysis_details}</ul>
+                                    <div class='bg-sky-100 border-l-4 border-sky-500 text-sky-900 text-sm p-3 rounded-r-lg'>
+                                      <p><b>Sugestão:</b> #{suggestion_text}</p>
+                                    </div>
+                                  </div>
+                                HTML
+                               end
+
+      repair_strategies_content =  if alternative_xpaths.empty?
+                                     "<p class='text-gray-500'>Nenhuma estratégia de localização alternativa pôde ser gerada.</p>"
+                                   else
+                                     pages = alternative_xpaths.each_slice(6).to_a
+                                     carousel_items = pages.map do |page_strategies|
+                                       strategy_list_html = page_strategies.map do |strategy|
+                                         reliability_color = case strategy[:reliability]
+                                                             when :alta then 'bg-green-100 text-green-800'
+                                                             when :media then 'bg-yellow-100 text-yellow-800'
+                                                             else 'bg-red-100 text-red-800'
+                                                             end
+                                         # CORREÇÃO: Adiciona o tipo de estratégia (ID, XPATH) ao lado do seletor
+                                         <<~STRATEGY_ITEM
               <li class='border-b border-gray-200 py-3 last:border-b-0'>
                 <div class='flex justify-between items-center mb-1'>
                   <p class='font-semibold text-indigo-800 text-sm'>#{CGI.escapeHTML(strategy[:name])}</p>
@@ -118,11 +129,11 @@ module AppiumFailureHelper
                 </div>
               </li>
             STRATEGY_ITEM
-          end.join
-          "<div class='carousel-item w-full flex-shrink-0'><ul>#{strategy_list_html}</ul></div>"
-        end.join
+                                       end.join
+                                       "<div class='carousel-item w-full flex-shrink-0'><ul>#{strategy_list_html}</ul></div>"
+                                     end.join
 
-        <<~CAROUSEL
+                                     <<~CAROUSEL
           <div id="xpath-carousel" class="relative">
             <div class="overflow-hidden">
               <div class="carousel-track flex transition-transform duration-300 ease-in-out">
@@ -140,34 +151,7 @@ module AppiumFailureHelper
             </div>
           </div>
         CAROUSEL
-      end
-
-      similar_elements_content = if similar_elements.empty?
-        "<p class='text-gray-500'>Nenhuma alternativa semelhante foi encontrada na tela atual.</p>"
-      else
-        carousel_items = similar_elements.map do |el|
-          score_percent = (el[:score] * 100).round(1)
-          <<~ITEM
-            <div class="carousel-item w-full flex-shrink-0">
-              <div class='border border-indigo-100 p-4 rounded-lg bg-indigo-50'>
-                <p class='font-bold text-indigo-800 mb-2'>#{CGI.escapeHTML(el[:name])} <span class='text-xs font-normal text-green-600 bg-green-100 rounded-full px-2 py-1 ml-2'>Similaridade: #{score_percent}%</span></p>
-                <ul>#{locators_html.call(el[:locators])}</ul>
-              </div>
-            </div>
-          ITEM
-        end.join
-        <<~CAROUSEL
-          <div id="similar-elements-carousel" class="relative">
-            <div class="overflow-hidden rounded-lg bg-white"><div class="carousel-track flex transition-transform duration-300 ease-in-out">#{carousel_items}</div></div>
-            <div class="flex items-center justify-center space-x-4 mt-4">
-              <button class="carousel-prev-footer bg-gray-200 hover:bg-gray-300 text-gray-800 font-bold py-2 px-4 rounded-lg disabled:opacity-50"> &lt; Anterior </button>
-              <div class="carousel-counter text-center text-sm text-gray-600 font-medium"></div>
-              <button class="carousel-next-footer bg-gray-200 hover:bg-gray-300 text-gray-800 font-bold py-2 px-4 rounded-lg disabled:opacity-50"> Próximo &gt; </button>
-            </div>
-          </div>
-        CAROUSEL
-      end
-
+                                   end
       <<~HTML_REPORT
         <!DOCTYPE html>
         <html lang="pt-BR">
@@ -189,7 +173,6 @@ module AppiumFailureHelper
                   <h2 class="text-xl font-bold text-red-600 mb-4">Elemento com Falha</h2>
                   #{failed_info_content}
                 </div>
-                #{code_search_html}
                 <div class="bg-white p-4 rounded-lg shadow-md">
                   <h2 class="text-xl font-bold text-gray-800 mb-4">Screenshot da Falha</h2>
                   <img src="data:image/png;base64,#{screenshot_base64}" alt="Screenshot da Falha" class="w-full rounded-md shadow-lg border border-gray-200">
@@ -198,13 +181,14 @@ module AppiumFailureHelper
               <div class="lg:col-span-2">
                 <div class="bg-white rounded-lg shadow-md">
                   <div class="flex border-b border-gray-200">
-                    <button class="tab-button active px-4 py-3 text-sm" data-tab="strategies">Estratégias de Reparo (#{alternative_xpaths.size})</button>
+                    <button class="tab-button active px-4 py-3 text-sm" data-tab="analysis">Análise Avançada</button>
                     <button class="tab-button px-4 py-3 text-sm text-gray-600" data-tab="all">Dump Completo (#{all_suggestions.size})</button>
                   </div>
                   <div class="p-6">
-                    <div id="strategies" class="tab-content active">
-                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Estratégias de Localização Alternativas</h3>
-                      #{repair_suggestions_content}
+                    <div id="analysis" class="tab-content active">
+                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Diagnóstico por Atributos Ponderados</h3>
+                      #{advanced_analysis_html}
+                      #{repair_strategies_content}
                     </div>
                     <div id="all" class="tab-content">
                       <h3 class="text-lg font-semibold text-gray-700 mb-4">Dump de Todos os Elementos da Tela</h3>
@@ -215,7 +199,7 @@ module AppiumFailureHelper
               </div>
             </div>
           </div>
-           <script>
+          <script>
             document.addEventListener('DOMContentLoaded', () => {
               const tabs = document.querySelectorAll('.tab-button');
               tabs.forEach(tab => {
@@ -228,43 +212,56 @@ module AppiumFailureHelper
                   document.getElementById(target).classList.add('active');
                 });
               });
-
-              const carousel = document.getElementById('xpath-carousel');
-              if (carousel) {
-                const track = carousel.querySelector('.carousel-track');
-                const items = carousel.querySelectorAll('.carousel-item');
-                const prevButton = carousel.querySelector('.carousel-prev-footer');
-                const nextButton = carousel.querySelector('.carousel-next-footer');
-                const counter = carousel.querySelector('.carousel-counter');
-                const totalItems = items.length;
-                let currentIndex = 0;
-
-                function updateCarousel() {
-                  if (totalItems === 0) {
-                    if(counter) counter.textContent = "";
-                    return;
-                  };
-                  track.style.transform = `translateX(-${currentIndex * 100}%)`;
-                  if (counter) { counter.textContent = `Página ${currentIndex + 1} de ${totalItems}`; }
-                  if (prevButton) { prevButton.disabled = currentIndex === 0; }
-                  if (nextButton) { nextButton.disabled = currentIndex === totalItems - 1; }
-                }
-
-                if (nextButton) {
-                  nextButton.addEventListener('click', () => {
-                    if (currentIndex < totalItems - 1) { currentIndex++; updateCarousel(); }
-                  });
-                }
-
-                if (prevButton) {
-                  prevButton.addEventListener('click', () => {
-                    if (currentIndex > 0) { currentIndex--; updateCarousel(); }
-                  });
-                }
-                
-                if (totalItems > 0) { updateCarousel(); }
-              }
             });
+            document.addEventListener('DOMContentLoaded', () => {
+                          const tabs = document.querySelectorAll('.tab-button');
+                          tabs.forEach(tab => {
+                            tab.addEventListener('click', (e) => {
+                              e.preventDefault();
+                              const target = tab.getAttribute('data-tab');
+                              tabs.forEach(t => t.classList.remove('active'));
+                              document.querySelectorAll('.tab-content').forEach(c => c.classList.remove('active'));
+                              tab.classList.add('active');
+                              document.getElementById(target).classList.add('active');
+                            });
+                          });
+            
+                          const carousel = document.getElementById('xpath-carousel');
+                          if (carousel) {
+                            const track = carousel.querySelector('.carousel-track');
+                            const items = carousel.querySelectorAll('.carousel-item');
+                            const prevButton = carousel.querySelector('.carousel-prev-footer');
+                            const nextButton = carousel.querySelector('.carousel-next-footer');
+                            const counter = carousel.querySelector('.carousel-counter');
+                            const totalItems = items.length;
+                            let currentIndex = 0;
+            
+                            function updateCarousel() {
+                              if (totalItems === 0) {
+                                if(counter) counter.textContent = "";
+                                return;
+                              };
+                              track.style.transform = `translateX(-${currentIndex * 100}%)`;
+                              if (counter) { counter.textContent = `Página ${currentIndex + 1} de ${totalItems}`; }
+                              if (prevButton) { prevButton.disabled = currentIndex === 0; }
+                              if (nextButton) { nextButton.disabled = currentIndex === totalItems - 1; }
+                            }
+            
+                            if (nextButton) {
+                              nextButton.addEventListener('click', () => {
+                                if (currentIndex < totalItems - 1) { currentIndex++; updateCarousel(); }
+                              });
+                            }
+            
+                            if (prevButton) {
+                              prevButton.addEventListener('click', () => {
+                                if (currentIndex > 0) { currentIndex--; updateCarousel(); }
+                              });
+                            }
+                            
+                            if (totalItems > 0) { updateCarousel(); }
+                          }
+                        });
           </script>
         </body>
         </html>
@@ -273,6 +270,7 @@ module AppiumFailureHelper
 
     def build_simple_diagnosis_report(title:, message:)
       exception = @data[:exception]
+      screenshot = @data[:screenshot_base_64]
       error_message_html = CGI.escapeHTML(exception.message.to_s)
       backtrace_html = CGI.escapeHTML(exception.backtrace.join("\n"))
 
@@ -294,7 +292,7 @@ module AppiumFailureHelper
               <div class="md:col-span-1">
                 <div class="bg-white p-4 rounded-lg shadow-md">
                   <h2 class="text-xl font-bold text-gray-800 mb-4">Screenshot da Falha</h2>
-                  <img src="data:image/png;base64,#{@data[:screenshot_base64]}" alt="Screenshot da Falha" class="w-full rounded-md shadow-lg border border-gray-200">
+                  <img src="data:image/png;base64,#{screenshot}" alt="Screenshot da Falha" class="w-full rounded-md shadow-lg border border-gray-200">
                 </div>
               </div>
               <div class="md:col-span-2 space-y-6">

data/lib/appium_failure_helper/version.rb

@@ -1,3 +1,3 @@
 module AppiumFailureHelper
-  VERSION = "1.4.0"
+  VERSION = "1.5.1"
 end

data/release_gem.rb

@@ -60,6 +60,7 @@ def git_commit_and_tag(new_version)
   `git add .`
   `git commit -m "Bump version to #{new_version.join('.')}"` 
   `git tag v#{new_version.join('.')}`
+  `git push && git push --tags`
 end
 
 # Publicar a GEM

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_failure_helper
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.1
 platform: ruby
 authors:
 - David Nascimento
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-02 00:00:00.000000000 Z
+date: 2025-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -90,6 +90,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".idea/.gitignore"
+- ".idea/Appium_failure_helper.iml"
+- ".idea/misc.xml"
+- ".idea/modules.xml"
+- ".idea/vcs.xml"
 - ".rspec"
 - LICENSE.txt
 - README.md