bddgenx 2.4.7 → 2.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94b275818990d76f36659c7be2a611232c1dfa90d812ac0e70dbfa6ae9c6e3e9
-  data.tar.gz: 5219e00c5048c07aee0ad93617a8a140e5725610ea532fe06fea798c097fe5b7
+  metadata.gz: adf58e7c99b89027c56542f9b2dbff2cc71c336ca164eb6a2bc65308546beef3
+  data.tar.gz: 2093d4ac9a62eea83e87eb7faff89a43196f0a4585f885e515c967e52e0688b8
 SHA512:
-  metadata.gz: 59b7b3e17525393b9cf63e6ef4b9a71ad3e2a49c69c35967180883d920ab0160400ba3ce42fe8dd5a1571c9246264dccc388faa5bcbae7808c6385dc79133ad5
-  data.tar.gz: 8dc211ad3e323a958fdb2e0b273fb5054d5f432d7be98677fbe1bf41eea2923284d763e0fe73181cc1740dfe2c5c9cfc88fa76d4fe299569f5af9e4decf0d5cc
+  metadata.gz: 10e4ffafcb2230a6a88cd3556ab995dfe936c36925c86027fee92d0e8f74f7e7b75c4bf6ea0415ec5a083dd5c63f9043750b350dcfa04176b3740c1123e67fa8
+  data.tar.gz: 3791efeb6c7a684e666bd73cfa03d21d2f8cc0825e6791655aa639f51901395c0595170661ff06b331e801ee2a158ec5193182ce4e6030712133c0c10c0b1176

data/VERSION

@@ -1 +1 @@
-2.4.7
+2.4.9

data/lib/bddgenx/configuration.rb

@@ -1,34 +1,92 @@
-# lib/bddgenx/configuration.rb
+# encoding: utf-8
+#
+# Este arquivo define a classe de configuração global da gem BDDGenX.
+#
+# A classe `Bddgenx::Configuration` permite configurar o modo de operação da ferramenta
+# (ex: estático ou com IA) e define as variáveis de ambiente que armazenam as chaves de API
+# para serviços externos como OpenAI (ChatGPT), Google Gemini e Microsoft Copilot.
+
 module Bddgenx
+  # Classe de configuração principal da gem BDDGenX.
+  # Permite definir o modo de geração BDD e os nomes das variáveis de ambiente
+  # que armazenam as chaves de API para integração com serviços de IA.
   class Configuration
-    # :static, :chatgpt ou :gemini
+    # Modo de execução da gem.
+    # Pode ser:
+    # - :static   → geração local
+    # - :chatgpt  → uso da IA do ChatGPT (OpenAI)
+    # - :gemini   → uso da IA Gemini (Google)
+    # - :copilot  → uso do Microsoft Copilot
+    #
+    # @return [Symbol]
     attr_accessor :mode
 
-    # Nomes das ENV vars para as chaves
-    attr_accessor :openai_api_key_env, :gemini_api_key_env
+    # Nome da variável de ambiente que contém a chave da API da OpenAI
+    # @return [String]
+    attr_accessor :openai_api_key_env
+
+    # Nome da variável de ambiente que contém a chave da API do Google Gemini
+    # @return [String]
+    attr_accessor :gemini_api_key_env
+
+    # Nome da variável de ambiente que contém a chave da API do Microsoft Copilot
+    # @return [String]
+    attr_accessor :microsoft_copilot_api_env
 
+    ##
+    # Inicializa a configuração com valores padrão:
+    # - modo: :static
+    # - ENV keys: 'OPENAI_API_KEY', 'GEMINI_API_KEY', 'MICROSOFT_COPILOT_API_KEY'
     def initialize
       @mode = :static
       @openai_api_key_env = 'OPENAI_API_KEY'
       @gemini_api_key_env = 'GEMINI_API_KEY'
+      @microsoft_copilot_api_env = 'MICROSOFT_COPILOT_API_KEY'
     end
 
-    # Retorna a chave real, carregada do ENV
+    ##
+    # Retorna a chave da API do OpenAI, lida diretamente da ENV.
+    #
+    # @return [String, nil] Chave de API ou nil se não definida
     def openai_api_key
       ENV[@openai_api_key_env]
     end
 
+    ##
+    # Retorna a chave da API do Gemini, lida diretamente da ENV.
+    #
+    # @return [String, nil] Chave de API ou nil se não definida
     def gemini_api_key
       ENV[@gemini_api_key_env]
     end
+
+    ##
+    # Retorna a chave da API do Microsoft Copilot, lida diretamente da ENV.
+    #
+    # @return [String, nil] Chave de API ou nil se não definida
+    def microsoft_copilot_api_key
+      ENV[@microsoft_copilot_api_env]
+    end
   end
 
-  # Singleton de configuração
+  ##
+  # Retorna uma instância singleton da configuração da gem.
+  #
+  # @return [Configuration]
   def self.configuration
     @configuration ||= Configuration.new
   end
 
-  # DSL para configurar
+  ##
+  # Permite configurar a gem usando um bloco DSL.
+  #
+  # Exemplo:
+  #   Bddgenx.configure do |config|
+  #     config.mode = :gemini
+  #     config.gemini_api_key_env = 'MY_GEMINI_KEY'
+  #   end
+  #
+  # @yieldparam config [Configuration] instância de configuração atual
   def self.configure
     yield(configuration)
   end

data/lib/bddgenx/generators/runner.rb

@@ -1,36 +1,49 @@
 # lib/bddgenx/cli.rb
 # encoding: utf-8
 #
-# Este arquivo define a classe Runner (CLI) da gem bddgenx,
-# responsável por orquestrar todo o fluxo de geração BDD:
-# leitura e validação de histórias, geração de features, steps,
-# exportação de PDFs e controle de modo (static / IA).
+# Este arquivo define a classe Runner (CLI) da gem BDDGenX.
+#
+# A Runner é responsável por orquestrar todo o fluxo de geração BDD:
+# - Leitura e validação de histórias (arquivos `.txt`)
+# - Geração de arquivos `.feature` e steps
+# - Integração com IA (ChatGPT, Gemini, Copilot)
+# - Exportação para PDF
+# - Rastreabilidade via CSV
+#
+# Esta classe é o ponto de entrada da gem em execução via terminal (CLI).
+# O comportamento é configurado com variáveis de ambiente como:
+# - BDDGENX_MODE (static, chatgpt, gemini, copilot)
+# - BDDGENX_LANG (pt, en)
 
 require_relative '../../bddgenx'
 
 module Bddgenx
-  # Classe principal de execução da gem.
-  # Atua como ponto de entrada (CLI) para processar arquivos de entrada
-  # e gerar todos os artefatos BDD relacionados.
+  # Classe principal de execução da gem BDDGenX.
+  # Controla o fluxo de leitura de histórias, geração de artefatos BDD
+  # e exportação de relatórios. Suporta execução via terminal.
   class Runner
 
     ##
-    # Retorna a lista de arquivos de entrada.
-    # Se houver argumentos em ARGV, utiliza-os como nomes de arquivos `.txt`.
-    # Caso contrário, chama prompt interativo.
+    # Retorna a lista de arquivos `.txt` a processar.
+    #
+    # - Se ARGV contiver argumentos, usa esses nomes como arquivos `.txt`
+    # - Caso contrário, entra em modo interativo para seleção manual
     #
-    # @param input_dir [String] Caminho do diretório de entrada
-    # @return [Array<String>] Lista de arquivos `.txt` a processar
+    # @param input_dir [String] Caminho do diretório com arquivos `.txt`
+    # @return [Array<String>] Lista de caminhos de arquivos `.txt`
     def self.choose_files(input_dir)
       ARGV.any? ? selecionar_arquivos_txt(input_dir) : choose_input(input_dir)
     end
 
     ##
-    # Processa argumentos ARGV e converte em caminhos válidos de arquivos `.txt`.
-    # Adiciona extensão `.txt` se ausente e remove arquivos inexistentes.
+    # Processa os argumentos da linha de comando (ARGV) e gera caminhos
+    # completos para arquivos `.txt` no diretório informado.
     #
-    # @param input_dir [String] Diretório onde estão os arquivos
-    # @return [Array<String>] Caminhos válidos para arquivos de entrada
+    # - Se a extensão `.txt` estiver ausente, ela é adicionada.
+    # - Arquivos inexistentes são ignorados com aviso.
+    #
+    # @param input_dir [String] Diretório base onde estão os arquivos `.txt`
+    # @return [Array<String>] Lista de arquivos válidos encontrados
     def self.selecionar_arquivos_txt(input_dir)
       ARGV.map do |arg|
         nome = arg.end_with?('.txt') ? arg : "#{arg}.txt"
@@ -44,15 +57,18 @@ module Bddgenx
     end
 
     ##
-    # Interface interativa para o usuário selecionar arquivos `.txt` a processar.
-    # Exibe uma lista dos arquivos disponíveis e solicita um número ao usuário.
+    # Modo interativo para o usuário escolher o arquivo `.txt` a ser processado.
+    #
+    # Exibe uma lista numerada com os arquivos disponíveis no diretório.
+    # O usuário pode selecionar um específico ou pressionar ENTER para todos.
     #
-    # @param input_dir [String] Diretório de entrada
-    # @return [Array<String>] Lista com o arquivo escolhido ou todos
+    # @param input_dir [String] Caminho do diretório com arquivos `.txt`
+    # @return [Array<String>] Arquivo selecionado ou todos disponíveis
     def self.choose_input(input_dir)
       files = Dir.glob(File.join(input_dir, '*.txt'))
       if files.empty?
-        warn "❌ Não há arquivos .txt no diretório #{input_dir}"; exit 1
+        warn "❌ Não há arquivos .txt no diretório #{input_dir}"
+        exit 1
       end
 
       puts "Selecione o arquivo de história para processar:"
@@ -63,20 +79,24 @@ module Bddgenx
       return files if choice.empty?
       idx = choice.to_i - 1
       unless idx.between?(0, files.size - 1)
-        warn "❌ Escolha inválida."; exit 1
+        warn "❌ Escolha inválida."
+        exit 1
       end
       [files[idx]]
     end
 
     ##
-    # Executa o fluxo completo de geração BDD:
-    # - Define o modo (static / IA)
-    # - Coleta arquivos de entrada
-    # - Valida as histórias
-    # - Gera arquivos `.feature` e `steps`
-    # - Exporta PDFs e faz backup de versões antigas
+    # Executa o fluxo principal de geração dos artefatos BDD.
+    #
+    # Etapas executadas:
+    # - Detecta o modo de execução via ENV['BDDGENX_MODE'] (static/chatgpt/gemini/copilot)
+    # - Carrega e valida histórias de usuário
+    # - Gera arquivos `.feature` e seus respectivos steps
+    # - Executa geração via IA (quando aplicável)
+    # - Exporta arquivos em PDF
+    # - Gera rastreabilidade via CSV
     #
-    # O modo de execução é lido da variável de ambiente `BDDGENX_MODE`.
+    # Exibe no final um resumo das operações executadas.
     #
     # @return [void]
     def self.execute
@@ -90,7 +110,7 @@ module Bddgenx
         exit 1
       end
 
-      # Contadores de geração
+      # Contadores
       total = features = steps = ignored = 0
       skipped_steps = []
       generated_pdfs = []
@@ -103,23 +123,22 @@ module Bddgenx
         historia = Parser.ler_historia(arquivo)
         idioma = Utils.obter_idioma_do_arquivo(arquivo) || historia[:idioma]
         historia[:idioma] = idioma
+
         unless Validator.validar(historia)
           ignored += 1
           puts "❌ #{I18n.t('messages.invalid_story')}: #{arquivo}"
           next
         end
 
-        # Geração via IA (ChatGPT, Gemini)
-        if %w[gemini chatgpt].include?(modo)
+        # IA: geração de cenários com Gemini, ChatGPT ou Copilot
+        if %w[gemini chatgpt copilot].include?(modo)
           puts I18n.t('messages.start_ia', modo: modo.capitalize)
-          idioma = Utils.obter_idioma_do_arquivo(arquivo) || historia[:idioma]
 
           feature_text = Support::Loader.run(I18n.t('messages.ia_waiting'), :default) do
             case modo
-            when 'gemini'
-              IA::GeminiCliente.gerar_cenarios(historia, idioma)
-            when 'chatgpt'
-              IA::ChatGptCliente.gerar_cenarios(historia, idioma)
+            when 'gemini' then IA::GeminiCliente.gerar_cenarios(historia, idioma)
+            when 'chatgpt' then IA::ChatGptCliente.gerar_cenarios(historia, idioma)
+            when 'copilot' then IA::MicrosoftCopilotCliente.gerar_cenarios(historia, idioma)
             end
           end
 
@@ -139,7 +158,9 @@ module Bddgenx
           end
         end
 
+        # Salva versão antiga se existir
         Backup.salvar_versao_antiga(feature_path)
+
         features += 1 if Generator.salvar_feature(feature_path, feature_content)
 
         if StepsGenerator.gerar_passos(feature_path)
@@ -150,6 +171,8 @@ module Bddgenx
 
         FileUtils.mkdir_p('reports')
         result = PDFExporter.exportar_todos(only_new: true)
+        Tracer.adicionar_entrada(historia, feature_path)
+
         generated_pdfs.concat(result[:generated])
         skipped_pdfs.concat(result[:skipped])
       end

data/lib/bddgenx/ia/microsoft_copilot_cliente.rb

@@ -0,0 +1,133 @@
+module Bddgenx
+  module IA
+    ##
+    # Cliente para interação com a API Microsoft Copilot para geração
+    # de conteúdo, aqui usado para criar cenários BDD no formato Gherkin.
+    #
+    class MicrosoftCopilotCliente
+      MICROSOFT_COPILOT_API_URL = ENV['MICROSOFT_COPILOT_API_URL']
+
+      ##
+      # Gera cenários BDD baseados em uma história, solicitando à API Microsoft Copilot
+      # o retorno no formato Gherkin com palavras-chave no idioma desejado.
+      #
+      # @param historia [String] Texto base da história para gerar os cenários.
+      # @param idioma [String] Código do idioma, 'pt' por padrão.
+      # @return [String, nil] Cenários no formato Gherkin, ou nil em caso de erro.
+      #
+      def self.gerar_cenarios(historia, idioma = 'pt')
+        api_key = Bddgenx.configuration.microsoft_copilot_api_key  # para Copilot
+
+        # Define as palavras-chave para os cenários BDD
+        keywords_pt = {
+          feature: "Funcionalidade",
+          scenario: "Cenário",
+          scenario_outline: "Esquema do Cenário",
+          examples: "Exemplos",
+          given: "Dado",
+          when: "Quando",
+          then: "Então",
+          and: "E"
+        }
+
+        keywords_en = {
+          feature: "Feature",
+          scenario: "Scenario",
+          scenario_outline: "Scenario Outline",
+          examples: "Examples",
+          given: "Given",
+          when: "When",
+          then: "Then",
+          and: "And"
+        }
+
+        # Escolhe o conjunto de palavras-chave conforme o idioma
+        keywords = idioma == 'en' ? keywords_en : keywords_pt
+
+        # Prompt base que instrui a IA a gerar cenários Gherkin no idioma indicado
+        prompt_base = <<~PROMPT
+                    Gere cenários BDD no formato Gherkin, utilizando as palavras-chave estruturais no idioma "#{idioma}":
+                      Feature: #{keywords[:feature]}
+                      Scenario: #{keywords[:scenario]}
+                      Scenario Outline: #{keywords[:scenario_outline]}
+                      Examples: #{keywords[:examples]}
+                      Given: #{keywords[:given]}
+                      When: #{keywords[:when]}
+                      Then: #{keywords[:then]}
+                      And: #{keywords[:and]}
+                  
+                    Instruções:
+                    - Todos os textos dos passos devem ser escritos em **português**.
+                    - Use as palavras-chave Gherkin no idioma especificado ("#{idioma}").
+                    - Gere **vários cenários**, incluindo positivos e negativos.
+                    - Use `Scenario Outline` e `Examples` sempre que houver valores variáveis.
+                    - Mantenha os parâmetros como `<email>`, `<senha>` e outros entre colchetes angulares, exatamente como aparecem.
+                    - Se a história fornecer contexto (ex: `[CONTEXT]` ou "Dado que..."), utilize-o como base para os cenários.
+                    - Se não houver contexto explícito, **crie um coerente** baseado na história.
+                    - A primeira linha do resultado deve conter obrigatoriamente `# language: #{idioma}`.
+                    - Evite passos vagos ou genéricos. Use ações claras e específicas.
+                    - Gere apenas o conteúdo da feature, sem explicações adicionais.
+                    
+                    História fornecida:
+                    #{historia}
+                  PROMPT
+
+        # Verifica se a chave de API foi configurada corretamente
+        unless api_key
+          warn "❌ API Key do Microsoft Copilot não encontrada no .env (MICROSOFT_COPILOT_API_KEY)"
+          return nil
+        end
+
+        # Define o endpoint da API Microsoft Copilot
+        uri = URI("#{MICROSOFT_COPILOT_API_URL}?key=#{api_key}")
+
+        # Estrutura do corpo da requisição para a API Microsoft Copilot
+        request_body = {
+          contents: [
+            {
+              model: "o4-mini",
+              role: "user",
+              parts: [{ text: prompt_base }]
+            }
+          ]
+        }
+
+        # Executa requisição POST para a API Microsoft Copilot
+        response = Net::HTTP.post(uri, request_body.to_json, { "Content-Type" => "application/json" })
+
+        # Verifica se a resposta foi bem-sucedida
+        if response.is_a?(Net::HTTPSuccess)
+          json = JSON.parse(response.body)
+
+          unless json["choices"]&.is_a?(Array) && json["choices"].any?
+            warn "❌ Resposta da IA sem candidatos válidos:"
+            warn JSON.pretty_generate(json)
+            return nil
+          end
+
+          # Recupera o conteúdo gerado pela IA
+          texto_ia = json["choices"].first.dig("message", "content")
+
+          if texto_ia
+            # Limpeza e sanitização do texto para manter padrão Gherkin
+            texto_limpo = Utils.limpar(texto_ia)
+            Utils.remover_steps_duplicados(texto_ia, idioma)
+
+            # Ajuste da diretiva de idioma na saída gerada
+            texto_limpo.sub!(/^# language: .*/, "# language: #{idioma}")
+            texto_limpo.prepend("# language: #{idioma}\n") unless texto_limpo.start_with?("# language:")
+
+            return texto_limpo
+          else
+            warn I18n.t('errors.ia_no_content')
+            warn JSON.pretty_generate(json)
+            return nil
+          end
+        else
+          warn I18n.t('errors.microsoft_copilot_error', code: response.code, body: response.body)
+          return nil
+        end
+      end
+    end
+  end
+end

data/lib/bddgenx/locales/en.yml

@@ -28,6 +28,7 @@ en:
     ia_no_content: "❌ No content returned from AI"
     gemini_error: "❌ Error calling Gemini: %{code} - %{body}"
     chatgpt_key_missing: "❌ ChatGPT API key not found in .env (OPENAI_API_KEY)"
+    microsoft_copilot_error: "Erro"
     openai_quota: "❌ OpenAI API quota exceeded."
     openai_check_usage: "🔗 Check your usage: https://platform.openai.com/account/usage"
     feature_not_found: "⚠️ Feature not found: %{feature}"

data/lib/bddgenx/locales/pt.yml

@@ -29,6 +29,7 @@ pt:
     gemini_error: "❌ Erro ao chamar Gemini: %{code} - %{body}"
     chatgpt_key_missing: "❌ API Key do ChatGPT não encontrada no .env (OPENAI_API_KEY)"
     openai_quota: "❌ Limite de uso da API OpenAI excedido."
+    microsoft_copilot_error: "Erro"
     openai_check_usage: "🔗 Verifique sua conta: https://platform.openai.com/account/usage"
     feature_not_found: "⚠️ Feature não encontrada: %{feature}"
     pdf_generation_failed: "❌ Erro ao gerar PDF de %{file}: %{error}"

data/lib/bddgenx/reports/tracer.rb

@@ -1,70 +1,141 @@
-# lib/bddgenx/tracer.rb
 # encoding: utf-8
 #
-# Este arquivo define a classe Tracer, responsável por gerar e manter
-# informações de rastreabilidade de cenários e passos em um arquivo CSV.
-# Útil para auditoria e análise de cobertura de cenários gerados.
+# Este arquivo define a classe `Tracer`, responsável por gerar arquivos de rastreabilidade
+# (CSV) a partir das features geradas automaticamente pela gem BDDGenX.
+#
+# Para cada feature processada, o `Tracer` extrai os cenários da própria feature `.feature`
+# e associa cada passo definido na história original com o bloco Gherkin correspondente.
+# O objetivo é fornecer visibilidade e rastreabilidade completa entre requisitos e testes.
+
+require 'csv'
+require 'fileutils'
+
 module Bddgenx
-  # Classe para adicionar registros de rastreabilidade a um relatório CSV.
+  # Classe responsável por rastrear os artefatos gerados pela gem
+  # e exportá-los em arquivos CSV, um por funcionalidade.
+  #
+  # Para cada grupo de passos (do `.txt`), associa os dados com o
+  # cenário equivalente gerado no arquivo `.feature`.
   class Tracer
-    # Adiciona entradas de rastreabilidade para cada passo de cada grupo
-    # da história em um arquivo CSV localizado em 'reports/output/rastreabilidade.csv'.
+    ##
+    # Adiciona entradas de rastreabilidade a um CSV baseado na feature gerada.
+    #
+    # - Cada funcionalidade recebe um arquivo CSV próprio, salvo em:
+    #   `reports/output/funcionalidade_<nome>.csv`
+    #
+    # - A coluna "BDD" contém o cenário completo extraído diretamente do `.feature`,
+    #   preservando a sintaxe original do Gherkin (cenário, steps, tags).
     #
     # @param historia [Hash]
-    #   Objeto de história contendo :quero (título da funcionalidade) e :grupos,
-    #   onde cada grupo possui :tipo, :tag, e :passos (Array<String>)
-    # @param nome_arquivo_feature [String]
-    #   Nome do arquivo .feature de onde os passos foram gerados
+    #   Hash representando a história extraída do `.txt`, contendo:
+    #   - :quero  → nome da funcionalidade
+    #   - :grupos → lista de blocos com :tipo, :tag e :passos
+    #
+    # @param feature_path [String]
+    #   Caminho do arquivo `.feature` já gerado no sistema
+    #
     # @return [void]
-    def self.adicionar_entrada(historia, nome_arquivo_feature)
-      # Garante existência do diretório de saída
+    def self.adicionar_entrada(historia, feature_path)
       FileUtils.mkdir_p('reports/output')
-      arquivo_csv = 'reports/output/rastreabilidade.csv'
 
-      # Cabeçalho padrão do CSV: identifica colunas
-      cabecalho = ['Funcionalidade', 'Tipo', 'Tag', 'Cenário', 'Passo', 'Origem']
+      nome_funcionalidade = historia[:quero].gsub(/^Quero\s*/, '').strip
+      nome_funcionalidade_sanitizado = nome_funcionalidade.downcase.gsub(/[^a-z0-9]+/, '_')
+      arquivo_csv = "reports/output/funcionalidade_#{nome_funcionalidade_sanitizado}.csv"
 
+      cabecalho = ['Funcionalidade', 'Tipo', 'Tag', 'Cenário', 'Passo', 'Origem', 'BDD']
       linhas = []
 
-      # Itera sobre grupos de passos para compor linhas de rastreabilidade
+      # Leitura real da feature gerada
+      blocos_gherkin = extrair_cenarios_gherkin(feature_path)
+
       historia[:grupos].each_with_index do |grupo, idx|
         tipo  = grupo[:tipo]
-        tag   = grupo[:tag]
+        tag   = grupo[:tag] || '-'
         passos = grupo[:passos] || []
-
-        nome_funcionalidade = historia[:quero].gsub(/^Quero\s*/, '').strip
         nome_cenario = "Cenário #{idx + 1}"
 
+        # Bloco Gherkin real do cenário gerado
+        gherkin_bloco = blocos_gherkin[idx] || ''
+
         passos.each do |passo|
           linhas << [
             nome_funcionalidade,
             tipo,
-            tag || '-',
+            tag,
             nome_cenario,
             passo,
-            File.basename(nome_arquivo_feature)
+            File.basename(feature_path),
+            gherkin_bloco
           ]
         end
       end
 
-      # Escreve ou anexa as linhas geradas ao CSV
       escrever_csv(arquivo_csv, cabecalho, linhas)
     end
 
-    # Escreve ou anexa registros em um arquivo CSV, criando cabeçalho se necessário.
+    ##
+    # Escreve ou anexa dados em um arquivo CSV.
+    # - Cria o cabeçalho caso seja a primeira escrita.
+    # - Evita duplicações com base na combinação "Passo + Origem".
+    #
+    # @param caminho [String] Caminho completo do arquivo CSV a ser salvo
+    # @param cabecalho [Array<String>] Títulos das colunas do CSV
+    # @param novas_linhas [Array<Array>] Linhas de conteúdo a serem gravadas
     #
-    # @param caminho [String] Caminho completo para o arquivo CSV de rastreabilidade
-    # @param cabecalho [Array<String>] Array de títulos das colunas a serem escritos
-    # @param linhas [Array<Array<String>>] Dados a serem gravados no CSV (cada sub-array é uma linha)
     # @return [void]
-    def self.escrever_csv(caminho, cabecalho, linhas)
-      # Verifica se é um novo arquivo para incluir o cabeçalho
+    def self.escrever_csv(caminho, cabecalho, novas_linhas)
       novo_arquivo = !File.exist?(caminho)
 
+      existentes = []
+      if File.exist?(caminho)
+        existentes = CSV.read(caminho, col_sep: ';', headers: true).map do |row|
+          [row['Passo'], row['Origem']]
+        end
+      end
+
       CSV.open(caminho, 'a+', col_sep: ';', force_quotes: true) do |csv|
         csv << cabecalho if novo_arquivo
-        linhas.each { |linha| csv << linha }
+
+        novas_linhas.each do |linha|
+          passo, origem = linha[4], linha[5]
+          next if existentes.include?([passo, origem])
+          csv << linha
+        end
       end
     end
+
+    ##
+    # Extrai todos os cenários completos do arquivo `.feature` gerado,
+    # preservando a estrutura Gherkin original (cenários, tags, steps).
+    #
+    # Um novo bloco é iniciado quando uma das palavras-chave de título
+    # de cenário é encontrada.
+    #
+    # @param feature_path [String] Caminho completo do arquivo `.feature`
+    # @return [Array<String>] Lista de blocos Gherkin, um por cenário
+    def self.extrair_cenarios_gherkin(feature_path)
+      return [] unless File.exist?(feature_path)
+
+      content = File.read(feature_path)
+      linhas = content.lines
+
+      blocos = []
+      bloco_atual = []
+      capturando = false
+
+      linhas.each_with_index do |linha, i|
+        if linha.strip =~ /^(Scenario|Scenario Outline|Cenário|Esquema do Cenário):/i
+          # Novo cenário → salva anterior
+          blocos << bloco_atual.join if bloco_atual.any?
+          bloco_atual = [linha]
+          capturando = true
+        elsif capturando
+          bloco_atual << linha
+        end
+      end
+
+      blocos << bloco_atual.join if bloco_atual.any?
+      blocos
+    end
   end
 end

data/lib/bddgenx/support/properties_loader.rb

@@ -0,0 +1,108 @@
+# lib/bddgenx/properties_loader.rb
+#
+# Módulo `Bddgenx::PropertiesLoader` é responsável por carregar e processar os arquivos de configuração
+# `.properties` que contêm variáveis de ambiente, além de também carregar as variáveis do arquivo `.env`.
+# Este módulo lida com a substituição de placeholders nas propriedades, garantindo que as variáveis de ambiente
+# sejam corretamente carregadas e definidas para uso no sistema.
+#
+# O fluxo de trabalho é o seguinte:
+# 1. Carregar variáveis de ambiente a partir do arquivo `.env`.
+# 2. Localizar e ler arquivos `.properties` presentes no diretório raiz do projeto.
+# 3. Substituir placeholders no conteúdo dos arquivos `.properties` com variáveis de ambiente.
+# 4. Mesclar as propriedades carregadas e definir as variáveis de ambiente no Ruby.
+#
+# Este módulo permite a configuração flexível de variáveis de ambiente, com suporte tanto para arquivos `.env`
+# quanto para arquivos `.properties`.
+
+module Bddgenx
+  class PropertiesLoader
+    # Carregar as variáveis do arquivo .env
+    #
+    # Este método utiliza a gem `dotenv` para carregar variáveis de ambiente a partir de um arquivo `.env`.
+    # Ele carrega as variáveis do arquivo `.env` para o ambiente de execução, onde elas ficam disponíveis via
+    # `ENV['VAR_NAME']` em qualquer parte do código.
+    def self.load_env_variables
+      Dotenv.load  # Carrega as variáveis do .env automaticamente
+    end
+
+    # Função para substituir variáveis no conteúdo do arquivo .properties
+    #
+    # Este método recebe o conteúdo de um arquivo `.properties` e substitui os placeholders no formato `{{VAR_NAME}}`
+    # pelas variáveis de ambiente correspondentes, se definidas. Caso a variável de ambiente não esteja definida,
+    # o placeholder original é mantido no conteúdo.
+    #
+    # @param content [String] O conteúdo do arquivo `.properties` a ser processado.
+    # @return [String] O conteúdo com os placeholders substituídos pelas variáveis de ambiente.
+    def self.replace_placeholders(content)
+      content.gsub!(/\{\{(\w+)\}\}/) do |match|
+        ENV[$1] || match  # Substitui pela variável de ambiente ou mantém o placeholder
+      end
+      content
+    end
+
+    # Função para garantir que o arquivo seja lido com a codificação correta
+    #
+    # Este método lê um arquivo especificado com codificação UTF-8. Caso o arquivo contenha caracteres inválidos,
+    # eles são substituídos por um caractere de substituição, garantindo que o conteúdo seja lido corretamente.
+    #
+    # @param file [String] O caminho do arquivo a ser lido.
+    # @return [String] O conteúdo do arquivo lido, com caracteres inválidos substituídos, se necessário.
+    def self.read_file_with_correct_encoding(file)
+      # Lê o arquivo com codificação UTF-8 e ignora caracteres inválidos
+      content = File.read(file, encoding: 'UTF-8')
+      content.encode('UTF-8', invalid: :replace, undef: :replace, replace: '?')
+    end
+
+    # Carregar e substituir propriedades de arquivos .properties
+    #
+    # Este método localiza todos os arquivos `.properties` no diretório raiz do projeto,
+    # lê seu conteúdo, substitui os placeholders pelas variáveis de ambiente, carrega as propriedades
+    # e mescla essas propriedades em um único hash.
+    #
+    # Após carregar as propriedades, ele também define as variáveis de ambiente no Ruby (via `ENV`)
+    # usando as propriedades carregadas, mas não sobrescreve as variáveis de ambiente já definidas.
+    #
+    # @return [Hash] O hash contendo as propriedades carregadas e mescladas dos arquivos `.properties`.
+    def self.load_properties
+      # Carregar variáveis do .env primeiro
+      load_env_variables
+
+      # Localizar arquivos .properties na raiz do projeto
+      properties_files = Dir.glob(File.expand_path('../*.properties', __dir__))
+
+      properties = {}
+
+      properties_files.each do |file|
+        # Forçar a leitura do arquivo com codificação UTF-8 e lidar com caracteres inválidos
+        content = read_file_with_correct_encoding(file)
+
+        # Substituir os placeholders antes de carregar as propriedades
+        content = replace_placeholders(content)
+
+        # Carregar as propriedades do arquivo
+        file_properties = JavaProperties::Properties.load(StringIO.new(content))
+
+        # Mesclar as propriedades carregadas no hash
+        properties.merge!(file_properties.to_h)
+      end
+
+      # Agora, define as variáveis de ambiente a partir das propriedades carregadas
+      set_environment_variables(properties)
+
+      properties
+    end
+
+    # Função para definir variáveis de ambiente a partir das propriedades carregadas
+    #
+    # Este método percorre as propriedades carregadas e as define como variáveis de ambiente (`ENV`) no Ruby.
+    # Se a variável de ambiente já estiver definida (por exemplo, pelo `.env`), ela não será sobrescrita.
+    #
+    # @param properties [Hash] O hash contendo as propriedades carregadas dos arquivos `.properties`.
+    def self.set_environment_variables(properties)
+      properties.each do |key, value|
+        # Se a variável de ambiente já estiver definida, não sobrescreve
+        ENV[key.upcase] ||= value
+      end
+    end
+  end
+end

data/lib/env.rb

@@ -1,10 +1,14 @@
-# lib/bddgenx/env.rb
 # encoding: utf-8
 #
-# Responsável por carregar todas as dependências da gem bddgenx.
-# Inclui bibliotecas padrão, gems externas e arquivos internos
-# essenciais para o funcionamento da geração BDD, com suporte a I18n,
-# IA (ChatGPT, Gemini), geração de PDF, validações e estrutura de projeto.
+# Este arquivo é responsável por carregar todas as dependências da gem `bddgenx`.
+#
+# Ele inclui:
+# - Gems padrão do Ruby (ex: JSON, net/http, fileutils)
+# - Gems externas (ex: Prawn, Faraday, Dotenv)
+# - Módulos internos do projeto `bddgenx`
+#
+# Também define o idioma ativo da gem (via I18n), configura variáveis de ambiente
+# e carrega clientes de IA, geradores, validadores, exportadores e estruturas de projeto.
 
 # --------------------------------------
 # 📦 Gems padrão da linguagem Ruby
@@ -14,98 +18,107 @@ require 'json'           # Manipulação de dados JSON
 require 'net/http'       # Requisições HTTP nativas
 require 'uri'            # Manipulação de URLs
 require 'fileutils'      # Operações com arquivos e diretórios
-require 'open3'          # Execução de comandos externos com captura de saída
-require 'bigdecimal'     # Cálculos matemáticos de alta precisão
-require 'i18n'           # Internacionalização (traduções dinâmicas)
+require 'open3'          # Execução de comandos externos
+require 'bigdecimal'     # Cálculos com alta precisão
+require 'i18n'           # Internacionalização
+require 'csv'            # Manipulação de arquivos CSV
+require 'yard'           # Documentação automática
 
 # --------------------------------------
 # 📚 Gems externas
 # --------------------------------------
 
-require 'prawn'          # Geração de documentos PDF
-require 'prawn/table'    # Suporte a tabelas no Prawn
+require 'prawn'          # Geração de PDFs
+require 'prawn/table'    # Tabelas em PDF
 require 'prawn-svg'      # Suporte a SVG no PDF
-require 'faraday'        # Cliente HTTP para integração com APIs (ex: Gemini)
-require 'dotenv'         # Carrega variáveis de ambiente do arquivo `.env`
-require 'unicode'        # Manipulação e normalização de caracteres Unicode
+require 'faraday'        # Cliente HTTP
+require 'dotenv'         # Carrega variáveis de .env
+require 'unicode'        # Manipulação de caracteres unicode
+require 'java_properties'# Leitura de arquivos .properties
+require 'stringio'       # IO virtual em memória
+require 'tempfile'       # Arquivos temporários
 
 # --------------------------------------
 # 🌍 Configuração de idioma (I18n)
 # --------------------------------------
 
-Dotenv.load  # Carrega variáveis como BDDGENX_LANG e APIs
+Dotenv.load  # Carrega as variáveis do `.env`
 
-# Define o caminho de arquivos de tradução YAML
+# Carrega os arquivos de tradução do diretório `locales/`
 locales_path = File.expand_path('bddgenx/locales/*.yml', __dir__)
 I18n.load_path += Dir[locales_path]
 
-# Define o idioma ativo somente se estiver presente e válido
-idioma_env = ENV['BDDGENX_LANG']
-if idioma_env && !idioma_env.strip.empty?
-  I18n.locale = idioma_env.strip.to_sym
-else
-  I18n.locale = :pt
-end
-
+# Define o idioma ativo com base em ENV['BDDGENX_LANG'], padrão: :pt
+I18n.locale = ENV['BDDGENX_LANG']&.strip&.to_sym || :pt
 
 # --------------------------------------
-# 🔧 Bundler (para projetos com Gemfile)
+# 🔧 Bundler (para carregar dependências do Gemfile)
 # --------------------------------------
 
-# Carrega as dependências listadas no Gemfile (se houver)
 require 'bundler/setup' if File.exist?(File.expand_path('../../Gemfile', __FILE__))
 
 # --------------------------------------
-# 🧩 Módulos utilitários da gem
+# 🧩 Módulos utilitários internos
 # --------------------------------------
 
-require_relative 'bddgenx/support/validator'                 # Valida estrutura de entrada
-require_relative 'bddgenx/support/font_loader'               # Carrega fontes do PDF
-
-require_relative 'bddgenx/utils/gherkin_cleaner_helper'           # Sanitização de Gherkin gerado
-require_relative 'bddgenx/utils/remover_steps_duplicados_helper'  # Remove passos duplicados
+require_relative 'bddgenx/support/validator'
+require_relative 'bddgenx/support/font_loader'
+require_relative 'bddgenx/utils/gherkin_cleaner_helper'
+require_relative 'bddgenx/utils/remover_steps_duplicados_helper'
 require_relative 'bddgenx/utils/language_helper'
 
 # --------------------------------------
-# 🤖 Clientes de IA (ChatGPT, Gemini)
+# 🤖 Clientes de IA (OpenAI, Gemini, Copilot)
 # --------------------------------------
 
-require_relative 'bddgenx/ia/gemini_cliente'   # Integração com Google Gemini
-require_relative 'bddgenx/ia/chatgtp_cliente'  # Integração com OpenAI (ChatGPT)
+require_relative 'bddgenx/ia/gemini_cliente'
+require_relative 'bddgenx/ia/chatgtp_cliente'
+require_relative 'bddgenx/ia/microsoft_copilot_cliente'
 
 # --------------------------------------
-# 🛠 Geradores (features, steps e execução)
+# 🛠 Geradores e Orquestrador
 # --------------------------------------
 
-require_relative 'bddgenx/generators/generator'        # Geração do conteúdo `.feature`
-require_relative 'bddgenx/generators/steps_generator'  # Geração de arquivos `*_steps.rb`
-require_relative 'bddgenx/generators/runner'           # Orquestrador da execução CLI
+require_relative 'bddgenx/generators/generator'
+require_relative 'bddgenx/generators/steps_generator'
+require_relative 'bddgenx/generators/runner'
 
 # --------------------------------------
-# 📄 Parser e metadados
+# 📄 Parser e Metadados
 # --------------------------------------
 
-require_relative 'parser'               # Interpreta arquivos `.txt` de entrada
-require_relative 'bddgenx/version'      # Lê versão do arquivo `VERSION`
+require_relative 'parser'
+require_relative 'bddgenx/version'
 
 # --------------------------------------
-# 📤 Relatórios e exportação
+# 📤 Relatórios e Exportação
 # --------------------------------------
 
-require_relative 'bddgenx/reports/pdf_exporter'  # Exporta features para PDF
-require_relative 'bddgenx/reports/backup'        # Gera backups de arquivos
-require_relative 'bddgenx/reports/tracer'        # Rastreabilidade de geração
+require_relative 'bddgenx/reports/pdf_exporter'
+require_relative 'bddgenx/reports/backup'
+require_relative 'bddgenx/reports/tracer'
 
 # --------------------------------------
-# ⚙️ Configuração da gem e loaders auxiliares
+# ⚙️ Configuração e Setup
 # --------------------------------------
 
-require_relative 'bddgenx/configuration'  # Variáveis de configuração (modo, APIs, etc.)
-require_relative 'bddgenx/setup'          # Inicializa estrutura do projeto (input/, features/, etc.)
-require_relative 'bddgenx/support/loader' # Exibe loaders/spinners no terminal
+require_relative 'bddgenx/configuration'
+require_relative 'bddgenx/setup'
+require_relative 'bddgenx/support/loader'
+require_relative 'bddgenx/support/properties_loader'
 
 # --------------------------------------
-# 🔁 Define modo de execução (ambiente de dev por padrão)
+# 🔁 Carregamento de propriedades como variáveis de ambiente
 # --------------------------------------
 
-ENV['BDDGENX_ENV'] = 'development'
+properties = Bddgenx::PropertiesLoader.load_properties
+
+# Mapeamento de variáveis .properties → ENV
+ENV['CHATGPT_API_URL'] ||= properties['openai.api.url']
+ENV['OPENAI_API_KEY'] ||= properties['openai.api.key']
+ENV['GEMINI_API_URL']  ||= properties['gemini.api.url']
+ENV['GEMINI_API_KEY']  ||= properties['gemini.api.key']
+ENV['MICROSOFT_COPILOT_API_URL'] ||= properties['copilot.api.url']
+ENV['MICROSOFT_COPILOT_API_KEY'] ||= properties['copilot.api.key']
+ENV['BDDGENX_MODE'] ||= properties['mode']
+ENV['BDDGENX_LANG'] ||= properties['lang']

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bddgenx
 version: !ruby/object:Gem::Version
-  version: 2.4.7
+  version: 2.4.9
 platform: ruby
 authors:
 - David Nascimento
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-18 00:00:00.000000000 Z
+date: 2025-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prawn
@@ -118,7 +118,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
-- Rakefile
 - VERSION
 - bin/bddgenx
 - lib/bddgenx.rb
@@ -132,6 +131,7 @@ files:
 - lib/bddgenx/generators/steps_generator.rb
 - lib/bddgenx/ia/chatgtp_cliente.rb
 - lib/bddgenx/ia/gemini_cliente.rb
+- lib/bddgenx/ia/microsoft_copilot_cliente.rb
 - lib/bddgenx/locales/en.yml
 - lib/bddgenx/locales/pt.yml
 - lib/bddgenx/reports/backup.rb
@@ -140,6 +140,7 @@ files:
 - lib/bddgenx/setup.rb
 - lib/bddgenx/support/font_loader.rb
 - lib/bddgenx/support/loader.rb
+- lib/bddgenx/support/properties_loader.rb
 - lib/bddgenx/support/validator.rb
 - lib/bddgenx/utils/gherkin_cleaner_helper.rb
 - lib/bddgenx/utils/language_helper.rb

data/Rakefile

@@ -1,36 +0,0 @@
-require 'bddgenx'
-require 'rake'
-
-namespace :bddgenx do
-  desc 'Executa geração interativa: escolha entre static, chatgpt, gemini ou deepseek'
-  task :generate do
-    puts "=== Qual modo deseja usar para gerar os cenários? ==="
-    puts "1. static (sem IA)"
-    puts "2. chatgpt (via OpenAI)"
-    puts "3. gemini (via Google)"
-    print "Digite o número (1-3): "
-
-    escolha = STDIN.gets.chomp.to_i
-
-    modo = case escolha
-           when 1 then :static
-           when 2 then :chatgpt
-           when 3 then :gemini
-           else
-             puts "❌ Opção inválida. Saindo."; exit 1
-           end
-
-    Bddgenx.configure do |config|
-      config.mode = modo
-      config.openai_api_key_env = 'OPENAI_API_KEY'
-      config.gemini_api_key_env = 'GEMINI_API_KEY'
-    end
-
-    # ⚠️ Limpa o ARGV antes de executar para evitar que [static] seja interpretado como nome de arquivo
-    ARGV.clear
-
-    ENV['BDDGENX_MODE'] = modo.to_s
-    puts "\n⚙️  Modo selecionado: #{modo}\n\n"
-    Bddgenx::Runner.execute
-  end
-end