ruby_raider 3.0.0 → 3.1.0

data/lib/generators/cucumber/templates/partials/capybara_env.tt

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-require 'rspec'
-require 'tmpdir'
-require_relative '../../helpers/allure_helper'
-require_relative '../../helpers/capybara_helper'
-require_relative '../../helpers/video_helper'
-require_relative '../../helpers/debug_helper'
-
-CapybaraHelper.configure
-
-Before do
-  viewport = YAML.load_file('config/config.yml')['viewport']
-  if viewport
-    Capybara.current_session.driver.browser.manage.window.resize_to(viewport['width'], viewport['height'])
-  else
-    Capybara.current_session.driver.browser.manage.window.maximize
-  end
-  @video_recorder = VideoHelper.recorder_for(Capybara.current_session.driver)
-  @video_recorder&.start(self.class.to_s)
-  DebugHelper.enable_network_logging(Capybara.current_session.driver)
-  @debug_action_logger = DebugHelper.action_logger_for(self.class.to_s)
-end
-
-After do |scenario|
-  if scenario.failed?
-    DebugHelper.capture_failure_diagnostics(Capybara.current_session.driver, scenario.name, exception: scenario.exception)
-    DebugHelper.capture_network_logs(DebugHelper.resolve_selenium_driver(Capybara.current_session.driver), DebugHelper.sanitize(scenario.name))
-  end
-  @debug_action_logger&.close
-  video_file = @video_recorder&.stop
-  AllureHelper.add_video(scenario.name, video_file)
-  Dir.mktmpdir do |temp_folder|
-    screenshot = Capybara.page.save_screenshot("#{temp_folder}/#{scenario.name}.png")
-    AllureHelper.add_screenshot(scenario.name, screenshot)
-  end
-  Capybara.reset_sessions!
-end

data/lib/generators/cucumber/templates/partials/capybara_world.tt

@@ -1,6 +0,0 @@
-require 'capybara/dsl'
-require_relative '../../helpers/capybara_helper'
-require_relative '../../models/user_factory'
-
-CapybaraHelper.configure
-World(Capybara::DSL)

data/lib/generators/cucumber/templates/performance_feature.tt

@@ -1,5 +0,0 @@
-Feature: Performance Audit
-
-Scenario: Page meets performance threshold
-    Given I audit the home page performance
-    Then the performance score should be above the threshold

data/lib/generators/cucumber/templates/performance_steps.tt

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../helpers/performance_helper'
-
-include PerformanceHelper
-
-Given('I audit the home page performance') do
-  @result = assert_performance_above('https://raider-test-site.onrender.com/', threshold: 0.7)
-end
-
-Then('the performance score should be above the threshold') do
-  expect(@result[:status]).not_to eq(:error),
-    "Lighthouse error: #{@result[:message]}"
-
-  expect(@result[:passed]).to be(true),
-    "Performance below threshold (#{@result[:threshold]}): #{@result[:scores]}"
-end

data/lib/generators/cucumber/templates/visual_feature.tt

@@ -1,5 +0,0 @@
-Feature: Visual Regression
-
-Scenario: Login page matches baseline
-    Given I'm on the login page
-    Then the page should match the visual baseline "login_page"

data/lib/generators/cucumber/templates/visual_steps.tt

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../helpers/visual_helper'
-require_relative '../../page_objects/pages/login'
-
-include VisualHelper
-
-Given("I'm on the login page") do
-  @login_page = <% if capybara? %>Login.new<% elsif watir? %>Login.new(browser)<% else %>Login.new(driver)<% end %>
-  @login_page.<% if capybara? %>visit_page<% else %>visit<% end %>
-end
-
-Then('the page should match the visual baseline {string}') do |baseline_name|
-  screenshot_path = <% if capybara? %>page.save_screenshot("tmp/visual_#{baseline_name}.png")<% elsif watir? %>browser.screenshot.save("tmp/visual_#{baseline_name}.png")<% else %>driver.save_screenshot("tmp/visual_#{baseline_name}.png")<% end %>
-  result = compare_screenshot(baseline_name, screenshot_path)
-
-  expect(result[:status]).not_to eq(:mismatch),
-    "Visual diff: #{(result[:diff].to_f * 100).round(2)}% difference. See: #{result[:diff_path]}"
-end

data/lib/generators/infrastructure/gitlab_generator.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../generator'
-
-class GitlabGenerator < Generator
-  def generate_gitlab_file
-    return unless web?
-
-    template('gitlab.tt', "#{name}/gitlab-ci.yml")
-  end
-end

data/lib/generators/infrastructure/templates/gitlab.tt

@@ -1,46 +0,0 @@
-stages:
-  - setup
-  - test
-  - report
-
-variables:
-  RUBY_VERSION: "<%= ruby_version %>.0"
-  HEADLESS: "true"
-
-setup_ruby:
-  stage: setup
-  image: ruby:${RUBY_VERSION}
-  script:
-    - bundle install --jobs $(nproc) --retry 3
-  cache:
-    paths:
-      - vendor/bundle
-
-run_tests:
-  stage: test
-  image: ruby:${RUBY_VERSION}
-  before_script:
-    - apt-get update -qq && apt-get install -y -qq chromium chromium-driver
-    - mkdir -p allure-results
-  script:
-    - <%- if framework == 'cucumber' -%>bundle exec cucumber features --format pretty<%- elsif minitest? -%>bundle exec ruby -Itest test/test_login_page.rb<%- else -%>bundle exec rspec spec --format documentation<%- end %>
-  artifacts:
-    paths:
-      - allure-results/
-    when: always
-
-pages:
-  stage: report
-  image: alpine/git
-  dependencies:
-    - run_tests
-  script:
-    - apk add --no-cache curl unzip
-    - curl -o allure.zip -L https://github.com/allure-framework/allure2/releases/latest/download/allure-commandline.zip
-    - unzip allure.zip -d /tmp/
-    - /tmp/allure-*/bin/allure generate allure-results --clean -o public
-  artifacts:
-    paths:
-      - public
-  only:
-    - main

data/lib/generators/minitest/minitest_generator.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../generator'
-
-class MinitestGenerator < Generator
-  def generate_login_test
-    return unless web?
-
-    template('test.tt', "#{name}/test/test_login_page.rb")
-  end
-
-  def generate_pdp_test
-    return unless mobile?
-
-    template('test.tt', "#{name}/test/test_pdp_page.rb")
-  end
-
-  def generate_visual_test
-    return unless visual_addon? && web?
-
-    template('visual_test.tt', "#{name}/test/test_visual.rb")
-  end
-
-  def generate_accessibility_test
-    return unless axe_addon? && web?
-
-    template('accessibility_test.tt', "#{name}/test/test_accessibility.rb")
-  end
-
-  def generate_performance_test
-    return unless lighthouse_addon? && web?
-
-    template('performance_test.tt', "#{name}/test/test_performance.rb")
-  end
-end

data/lib/generators/minitest/templates/accessibility_test.tt

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../helpers/test_helper'
-
-class TestAccessibility < Minitest::Test
-  def setup
-    super
-    <% if capybara? -%>
-visit '/'
-    <% elsif watir? -%>
-browser.goto 'https://raider-test-site.onrender.com/'
-    <% else -%>
-driver.get 'https://raider-test-site.onrender.com/'
-    <% end -%>
-  end
-
-  def test_no_accessibility_violations_on_page
-    <% if capybara? -%>
-assert_axe_clean page
-    <% elsif watir? -%>
-assert_axe_clean browser.driver
-    <% else -%>
-assert_axe_clean driver
-    <% end -%>
-  end
-end

data/lib/generators/minitest/templates/performance_test.tt

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../helpers/test_helper'
-require_relative '../helpers/performance_helper'
-
-class TestPerformance < Minitest::Test
-  include PerformanceHelper
-
-  def test_meets_performance_threshold
-    result = assert_performance_above('https://raider-test-site.onrender.com/', threshold: 0.7)
-
-    refute_equal :error, result[:status],
-      "Lighthouse error: #{result[:message]}"
-
-    assert result[:passed],
-      "Performance below threshold (#{result[:threshold]}): #{result[:scores]}"
-  end
-end

data/lib/generators/minitest/templates/test.tt

@@ -1,64 +0,0 @@
-<%- if selenium_based? || watir? || capybara? -%>
-# frozen_string_literal: true
-
-require_relative '../helpers/test_helper'
-require_relative '../models/model_factory'
-require_relative '../page_objects/pages/account'
-require_relative '../page_objects/pages/login'
-
-# Uncomment for interactive debugging:
-# require 'debug'    # Ruby's built-in debugger (binding.break)
-# require 'pry'      # Pry debugger (binding.pry)
-
-<%- if selenium_based? || watir? || capybara? -%>
-class TestLogin < Minitest::Test
-  def setup
-    @user = ModelFactory.for('users')['registered user']
-    @login_page = <% if capybara? -%>Login.new<% elsif watir? -%>Login.new(browser)<% else -%>Login.new(driver)<% end %>
-    @account_page = <% if capybara? -%>Account.new<% elsif watir? -%>Account.new(browser)<% else -%>Account.new(driver)<% end %>
-  end
-
-  def teardown
-    <%= partial('quit_driver', strip: true) %>
-  end
-
-  def test_login_with_right_credentials
-    # binding.break  # Uncomment to pause here and inspect state
-    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
-    @login_page.login(@user['username'], @user['password'])
-    @account_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
-    assert_equal "Welcome back #{@user['name']}", @account_page.header.customer_name
-  end
-
-  def test_login_with_wrong_credentials
-    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
-    @login_page.login(@user['username'], 'wrongPassword')
-    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
-    assert_equal 'Login or register', @account_page.header.customer_name
-  end
-end
-<%- end -%>
-<%- else -%>
-<% if cross_platform? -%>
-require_relative '../helpers/appium_helper'
-<%- end -%>
-require_relative '../helpers/test_helper'
-require_relative '../page_objects/pages/home'
-require_relative '../page_objects/pages/pdp'
-
-class TestPdp < Minitest::Test
-  def setup
-    @home_page = Home.new(driver)
-    @pdp_page = Pdp.new(driver)
-  end
-
-  def teardown
-    driver.quit_driver
-  end
-
-  def test_shows_add_to_cart_button
-    @home_page.go_to_product_detail
-    assert_equal 'Add to Cart', @pdp_page.add_to_cart_text
-  end
-end
-<%- end -%>

data/lib/generators/minitest/templates/visual_test.tt

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../helpers/test_helper'
-require_relative '../helpers/visual_helper'
-require_relative '../page_objects/pages/login'
-
-class TestVisualRegression < Minitest::Test
-  include VisualHelper
-
-  def setup
-    super
-    @login_page = <% if capybara? -%>Login.new<% elsif watir? -%>Login.new(browser)<% else -%>Login.new(driver)<% end %>
-  end
-
-  def test_login_page_matches_baseline
-    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
-    screenshot_path = <% if capybara? -%>page.save_screenshot('tmp/visual_login.png')<% elsif watir? -%>browser.screenshot.save('tmp/visual_login.png')<% else -%>driver.save_screenshot('tmp/visual_login.png')<% end %>
-    result = compare_screenshot('login_page', screenshot_path)
-
-    refute_equal :mismatch, result[:status],
-      "Visual diff: #{(result[:diff].to_f * 100).round(2)}% difference. See: #{result[:diff_path]}"
-  end
-end

data/lib/generators/rspec/templates/performance_spec.tt

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../helpers/spec_helper'
-require_relative '../helpers/performance_helper'
-
-describe 'Performance Audit' do
-  include PerformanceHelper
-
-  it 'meets performance threshold' do
-    result = assert_performance_above('https://raider-test-site.onrender.com/', threshold: 0.7)
-
-    expect(result[:status]).not_to eq(:error),
-      "Lighthouse error: #{result[:message]}"
-
-    expect(result[:passed]).to be(true),
-      "Performance below threshold (#{result[:threshold]}): #{result[:scores]}"
-  end
-end

data/lib/generators/rspec/templates/visual_spec.tt

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../helpers/spec_helper'
-require_relative '../helpers/visual_helper'
-require_relative '../page_objects/pages/login'
-
-describe 'Visual Regression' do
-  include VisualHelper
-
-  let(:login_page) { <% if capybara? -%>Login.new<% elsif watir? -%>Login.new(browser)<% else -%>Login.new(driver)<% end -%> }
-
-  it 'login page matches baseline' do
-    login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
-    screenshot_path = <% if capybara? -%>page.save_screenshot('tmp/visual_login.png')<% elsif watir? -%>browser.screenshot.save('tmp/visual_login.png')<% else -%>driver.save_screenshot('tmp/visual_login.png')<% end %>
-    result = compare_screenshot('login_page', screenshot_path)
-
-    expect(result[:status]).not_to eq(:mismatch),
-      "Visual diff: #{(result[:diff].to_f * 100).round(2)}% difference. See: #{result[:diff_path]}"
-  end
-end

data/lib/generators/templates/helpers/capybara_helper.tt

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require 'capybara'
-require 'capybara/dsl'
-require 'selenium-webdriver'
-require 'yaml'
-
-module CapybaraHelper
-  def self.configure
-    config = YAML.load_file('config/config.yml')
-
-    Capybara.configure do |capybara_config|
-      capybara_config.default_driver = :selenium
-      capybara_config.javascript_driver = :selenium
-      capybara_config.app_host = config['url']
-      capybara_config.default_max_wait_time = config.fetch('timeout', 10)
-      capybara_config.run_server = false
-    end
-
-    Capybara.register_driver :selenium do |app|
-      browser = config['browser'].to_sym
-      args = config['browser_arguments'][config['browser']] || []
-      args += ['--headless'] if ENV['HEADLESS'] && !args.include?('--headless')
-      options = Selenium::WebDriver::Chrome::Options.new(args:)
-      debug_cfg = config['debug'] || {}
-      if debug_cfg.fetch('enabled', false) || ENV['DEBUG']&.downcase == 'true'
-        options.add_option('goog:loggingPrefs', { browser: 'ALL', performance: 'ALL' })
-      end
-      Capybara::Selenium::Driver.new(app, browser:, options:)
-    end
-  end
-end

data/lib/generators/templates/helpers/performance_helper.tt

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'open3'
-require 'json'
-require 'fileutils'
-require 'yaml'
-
-module PerformanceHelper
-  REPORTS_DIR = 'lighthouse_reports'
-
-  def run_lighthouse_audit(url, categories: %w[performance accessibility best-practices seo])
-    FileUtils.mkdir_p(REPORTS_DIR)
-
-    report_path = File.join(REPORTS_DIR, "report_#{Time.now.to_i}.json")
-    category_flags = categories.map { |c| "--only-categories=#{c}" }.join(' ')
-
-    config_timeout = if File.exist?('config/config.yml')
-                        YAML.load_file('config/config.yml').fetch('timeout', 10)
-                      else
-                        10
-                      end
-    max_wait = config_timeout * 1000
-
-    command = "lighthouse #{url} --output=json --output-path=#{report_path} " \
-              "--chrome-flags=\"--headless --no-sandbox\" #{category_flags} " \
-              "--max-wait-for-load=#{max_wait} --quiet"
-
-    stdout, stderr, status = Open3.capture3(command)
-
-    unless status.success?
-      return { status: :error, message: "Lighthouse failed: #{stderr.strip.empty? ? stdout : stderr}" }
-    end
-
-    report = JSON.parse(File.read(report_path))
-    scores = extract_scores(report)
-
-    { status: :success, scores:, report_path: }
-  end
-
-  def assert_performance_above(url, threshold: 0.8, categories: %w[performance])
-    result = run_lighthouse_audit(url, categories:)
-    return result if result[:status] == :error
-
-    passed = result[:scores].all? { |_category, score| score >= threshold }
-
-    { status: passed ? :pass : :fail, scores: result[:scores], passed:, threshold:,
-      report_path: result[:report_path] }
-  end
-
-  private
-
-  def extract_scores(report)
-    report.fetch('categories', {}).each_with_object({}) do |(key, data), scores|
-      scores[key] = data['score']
-    end
-  end
-end

data/lib/generators/templates/helpers/visual_helper.tt

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-require 'chunky_png'
-require 'fileutils'
-
-module VisualHelper
-  BASELINE_DIR = 'visual_baselines'
-  DIFF_DIR = 'visual_diffs'
-
-  def compare_screenshot(name, screenshot_path, threshold: 0.01)
-    FileUtils.mkdir_p(BASELINE_DIR)
-    FileUtils.mkdir_p(DIFF_DIR)
-
-    baseline_path = File.join(BASELINE_DIR, "#{name}.png")
-
-    unless File.exist?(baseline_path)
-      FileUtils.cp(screenshot_path, baseline_path)
-      return { status: :baseline_created, path: baseline_path }
-    end
-
-    baseline = ChunkyPNG::Image.from_file(baseline_path)
-    current = ChunkyPNG::Image.from_file(screenshot_path)
-
-    diff_pixels = 0
-    total_pixels = baseline.width * baseline.height
-
-    diff_image = ChunkyPNG::Image.new(baseline.width, baseline.height)
-
-    baseline.height.times do |y|
-      baseline.width.times do |x|
-        if pixel_match?(baseline[x, y], current[x, y])
-          diff_image[x, y] = ChunkyPNG::Color.rgba(0, 0, 0, 50)
-        else
-          diff_pixels += 1
-          diff_image[x, y] = ChunkyPNG::Color.rgb(255, 0, 0)
-        end
-      end
-    end
-
-    diff_percentage = diff_pixels.to_f / total_pixels
-
-    if diff_percentage > threshold
-      diff_path = File.join(DIFF_DIR, "#{name}_diff.png")
-      diff_image.save(diff_path)
-      { status: :mismatch, diff: diff_percentage, diff_path: }
-    else
-      { status: :match, diff: diff_percentage }
-    end
-  end
-
-  private
-
-  def pixel_match?(pixel1, pixel2)
-    r1, g1, b1 = ChunkyPNG::Color.r(pixel1), ChunkyPNG::Color.g(pixel1), ChunkyPNG::Color.b(pixel1)
-    r2, g2, b2 = ChunkyPNG::Color.r(pixel2), ChunkyPNG::Color.g(pixel2), ChunkyPNG::Color.b(pixel2)
-    (r1 - r2).abs <= 5 && (g1 - g2).abs <= 5 && (b1 - b2).abs <= 5
-  end
-end

data/lib/llm/client.rb

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-
-require 'net/http'
-require_relative 'config'
-
-module Llm
-  # Facade for LLM completion with retry logic and graceful fallback.
-  # Returns nil on any failure — callers should always have a non-AI fallback.
-  module Client
-    MAX_RETRIES = 3
-    BASE_DELAY = 1
-
-    # Only retry on transient network errors, not configuration or API errors
-    RETRYABLE_ERRORS = [
-      Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNREFUSED,
-      Errno::ECONNRESET, Errno::ETIMEDOUT, SocketError
-    ].freeze
-
-    class << self
-      def complete(prompt, system_prompt: nil)
-        provider = build_provider
-        return nil unless provider
-
-        attempt = 0
-        begin
-          attempt += 1
-          provider.complete(prompt, system_prompt:)
-        rescue *RETRYABLE_ERRORS => e
-          if attempt < MAX_RETRIES
-            sleep(BASE_DELAY * (2**(attempt - 1)))
-            retry
-          end
-          warn "[Ruby Raider] LLM failed after #{MAX_RETRIES} attempts: #{e.message}"
-          nil
-        rescue StandardError => e
-          warn "[Ruby Raider] LLM error: #{e.message}"
-          nil
-        end
-      end
-
-      def available?
-        config = Config.new
-        return false unless config.configured?
-
-        provider = config.build_provider
-        provider&.available? || false
-      end
-
-      def status
-        config = Config.new
-        return { configured: false, provider: nil } unless config.configured?
-
-        provider = config.build_provider
-        {
-          configured: true,
-          provider: config.provider_name,
-          model: config.model,
-          available: provider&.available? || false
-        }
-      end
-
-      private
-
-      def build_provider
-        config = Config.new
-        unless config.configured?
-          warn '[Ruby Raider] No LLM configured. Use: raider u llm ollama'
-          return nil
-        end
-        provider = config.build_provider
-        unless provider&.available?
-          warn "[Ruby Raider] LLM provider '#{config.provider_name}' is not available"
-          return nil
-        end
-        provider
-      end
-    end
-  end
-end

data/lib/llm/config.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-module Llm
-  # Reads LLM configuration from env vars and config/config.yml
-  # Env vars take precedence over config file values.
-  class Config
-    PROVIDERS = %w[openai anthropic ollama].freeze
-
-    attr_reader :provider_name, :api_key, :model, :url
-
-    def initialize
-      @provider_name = env('RUBY_RAIDER_LLM_PROVIDER') || config_value('llm_provider')
-      @api_key = env('RUBY_RAIDER_LLM_API_KEY') || config_value('llm_api_key')
-      @model = env('RUBY_RAIDER_LLM_MODEL') || config_value('llm_model')
-      @url = env('RUBY_RAIDER_LLM_URL') || config_value('llm_url')
-    end
-
-    def configured?
-      return false unless @provider_name && PROVIDERS.include?(@provider_name)
-      return true if @provider_name == 'ollama'
-
-      !@api_key.nil? && !@api_key.empty?
-    end
-
-    def build_provider
-      return nil unless configured?
-
-      case @provider_name
-      when 'openai'
-        require_relative 'providers/openai_provider'
-        Providers::OpenaiProvider.new(api_key: @api_key, model: @model)
-      when 'anthropic'
-        require_relative 'providers/anthropic_provider'
-        Providers::AnthropicProvider.new(api_key: @api_key, model: @model)
-      when 'ollama'
-        require_relative 'providers/ollama_provider'
-        Providers::OllamaProvider.new(model: @model, url: @url)
-      end
-    end
-
-    private
-
-    def env(key)
-      value = ENV.fetch(key, nil)
-      value&.strip&.empty? ? nil : value&.strip
-    end
-
-    def config_value(key)
-      return nil unless File.exist?('config/config.yml')
-
-      data = YAML.load_file('config/config.yml')
-      data&.dig(key)
-    end
-  end
-end