RubyGems - ruby_raider - Versions diffs - 2.0.0 → 3.0.0 - Mend

ruby_raider 2.0.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (224) hide show

checksums.yaml +4 -4
data/.github/workflows/e2e_tests.yml +58 -0
data/.github/workflows/steep.yml +21 -0
data/.gitignore +1 -1
data/.reek.yml +46 -4
data/.ruby-version +1 -1
data/README.md +138 -77
data/Steepfile +22 -0
data/assets/ruby_raider_logo.svg +51 -0
data/lib/adopter/adopt_menu.rb +11 -15
data/lib/adopter/converters/base_converter.rb +1 -2
data/lib/adopter/converters/identity_converter.rb +3 -6
data/lib/adopter/migration_plan.rb +0 -1
data/lib/adopter/plan_builder.rb +2 -5
data/lib/adopter/project_analyzer.rb +1 -5
data/lib/adopter/project_detector.rb +3 -5
data/lib/commands/adopt_commands.rb +0 -1
data/lib/commands/plugin_commands.rb +0 -2
data/lib/commands/scaffolding_commands.rb +220 -37
data/lib/commands/utility_commands.rb +82 -2
data/lib/generators/automation/automation_generator.rb +0 -7
data/lib/generators/automation/templates/partials/element.tt +1 -1
data/lib/generators/automation/templates/partials/initialize_selector.tt +0 -7
data/lib/generators/automation/templates/partials/url_methods.tt +0 -1
data/lib/generators/common_generator.rb +12 -0
data/lib/generators/cucumber/cucumber_generator.rb +36 -0
data/lib/generators/cucumber/templates/accessibility_feature.tt +5 -0
data/lib/generators/cucumber/templates/accessibility_steps.tt +21 -0
data/lib/generators/cucumber/templates/cucumber.tt +8 -1
data/lib/generators/cucumber/templates/feature.tt +0 -4
data/lib/generators/cucumber/templates/partials/appium_env.tt +5 -0
data/lib/generators/cucumber/templates/partials/capybara_env.tt +19 -1
data/lib/generators/cucumber/templates/partials/driver_world.tt +1 -4
data/lib/generators/cucumber/templates/partials/selenium_env.tt +22 -35
data/lib/generators/cucumber/templates/partials/watir_env.tt +20 -1
data/lib/generators/cucumber/templates/partials/web_steps.tt +6 -12
data/lib/generators/cucumber/templates/performance_feature.tt +5 -0
data/lib/generators/cucumber/templates/performance_steps.tt +17 -0
data/lib/generators/cucumber/templates/visual_feature.tt +5 -0
data/lib/generators/cucumber/templates/visual_steps.tt +19 -0
data/lib/generators/generator.rb +38 -7
data/lib/generators/helper_generator.rb +24 -7
data/lib/generators/infrastructure/templates/github.tt +1 -1
data/lib/generators/infrastructure/templates/github_appium.tt +2 -2
data/lib/generators/infrastructure/templates/gitlab.tt +1 -1
data/lib/generators/invoke_generators.rb +42 -9
data/lib/generators/menu_generator.rb +120 -11
data/lib/generators/minitest/minitest_generator.rb +16 -4
data/lib/generators/minitest/templates/accessibility_test.tt +26 -0
data/lib/generators/minitest/templates/performance_test.tt +18 -0
data/lib/generators/minitest/templates/test.tt +5 -34
data/lib/generators/minitest/templates/visual_test.tt +23 -0
data/lib/generators/rspec/rspec_generator.rb +16 -4
data/lib/generators/rspec/templates/accessibility_spec.tt +25 -0
data/lib/generators/rspec/templates/performance_spec.tt +18 -0
data/lib/generators/rspec/templates/spec.tt +5 -35
data/lib/generators/rspec/templates/visual_spec.tt +20 -0
data/lib/generators/template_renderer/partial_cache.rb +11 -1
data/lib/generators/template_renderer/partial_resolver.rb +17 -10
data/lib/generators/template_renderer.rb +17 -1
data/lib/generators/templates/common/gemfile.tt +21 -6
data/lib/generators/templates/common/git_ignore.tt +6 -1
data/lib/generators/templates/common/partials/mobile_config.tt +5 -1
data/lib/generators/templates/common/partials/web_config.tt +16 -7
data/lib/generators/templates/common/rakefile.tt +36 -0
data/lib/generators/templates/common/read_me.tt +41 -91
data/lib/generators/templates/common/rspec.tt +3 -0
data/lib/generators/templates/common/ruby_version.tt +1 -0
data/lib/generators/templates/helpers/allure_helper.tt +11 -0
data/lib/generators/templates/helpers/browser_helper.tt +12 -2
data/lib/generators/templates/helpers/capybara_helper.tt +5 -1
data/lib/generators/templates/helpers/debug_helper.tt +190 -0
data/lib/generators/templates/helpers/driver_helper.tt +2 -10
data/lib/generators/templates/helpers/partials/appium_driver.tt +0 -2
data/lib/generators/templates/helpers/partials/debug_diagnostics.tt +7 -0
data/lib/generators/templates/helpers/partials/debug_start.tt +7 -0
data/lib/generators/templates/helpers/partials/driver_and_options.tt +1 -3
data/lib/generators/templates/helpers/partials/selenium_driver.tt +8 -7
data/lib/generators/templates/helpers/partials/video_start.tt +9 -0
data/lib/generators/templates/helpers/partials/video_stop.tt +4 -0
data/lib/generators/templates/helpers/performance_helper.tt +57 -0
data/lib/generators/templates/helpers/spec_helper.tt +57 -8
data/lib/generators/templates/helpers/test_helper.tt +69 -1
data/lib/generators/templates/helpers/video_helper.tt +270 -0
data/lib/generators/templates/helpers/visual_helper.tt +39 -46
data/lib/llm/client.rb +79 -0
data/lib/llm/config.rb +57 -0
data/lib/llm/prompts.rb +84 -0
data/lib/llm/provider.rb +27 -0
data/lib/llm/providers/anthropic_provider.rb +43 -0
data/lib/llm/providers/ollama_provider.rb +56 -0
data/lib/llm/providers/openai_provider.rb +42 -0
data/lib/llm/response_parser.rb +67 -0
data/lib/plugin/plugin.rb +22 -20
data/lib/plugin/plugin_exposer.rb +16 -38
data/lib/ruby_raider.rb +47 -12
data/lib/scaffolding/crud_generator.rb +94 -0
data/lib/scaffolding/dry_run_presenter.rb +16 -0
data/lib/scaffolding/name_normalizer.rb +63 -0
data/lib/scaffolding/page_introspector.rb +45 -0
data/lib/scaffolding/project_detector.rb +72 -0
data/lib/scaffolding/scaffold_menu.rb +103 -0
data/lib/scaffolding/scaffolding.rb +158 -11
data/lib/scaffolding/templates/component.tt +30 -0
data/lib/scaffolding/templates/feature.tt +4 -4
data/lib/scaffolding/templates/helper.tt +15 -1
data/lib/scaffolding/templates/page_from_url.tt +75 -0
data/lib/scaffolding/templates/page_object.tt +50 -1
data/lib/scaffolding/templates/spec.tt +33 -2
data/lib/scaffolding/templates/spec_from_page.tt +31 -0
data/lib/scaffolding/templates/spec_from_url.tt +46 -0
data/lib/scaffolding/templates/steps.tt +17 -5
data/lib/scaffolding/url_analyzer.rb +179 -0
data/lib/utilities/desktop_downloader.rb +177 -0
data/lib/utilities/logo.rb +83 -0
data/lib/utilities/utilities.rb +53 -20
data/lib/version +1 -1
data/ruby_raider.gemspec +1 -0
data/sig/adopter/adopt_menu.rbs +25 -0
data/sig/adopter/converters/base_converter.rbs +23 -0
data/sig/adopter/converters/identity_converter.rbs +16 -0
data/sig/adopter/migration_plan.rbs +34 -0
data/sig/adopter/migrator.rbs +21 -0
data/sig/adopter/plan_builder.rbs +38 -0
data/sig/adopter/project_analyzer.rbs +39 -0
data/sig/adopter/project_detector.rbs +26 -0
data/sig/commands/adopt_commands.rbs +8 -0
data/sig/commands/loaded_commands.rbs +5 -0
data/sig/commands/plugin_commands.rbs +9 -0
data/sig/commands/scaffolding_commands.rbs +28 -0
data/sig/commands/utility_commands.rbs +21 -0
data/sig/generators/automation/automation_generator.rbs +20 -0
data/sig/generators/common_generator.rbs +12 -0
data/sig/generators/cucumber/cucumber_generator.rbs +16 -0
data/sig/generators/generator.rbs +40 -0
data/sig/generators/helper_generator.rbs +18 -0
data/sig/generators/infrastructure/github_generator.rbs +5 -0
data/sig/generators/infrastructure/gitlab_generator.rbs +4 -0
data/sig/generators/invoke_generators.rbs +10 -0
data/sig/generators/menu_generator.rbs +29 -0
data/sig/generators/minitest/minitest_generator.rbs +8 -0
data/sig/generators/rspec/rspec_generator.rbs +8 -0
data/sig/generators/template_renderer/partial_cache.rbs +20 -0
data/sig/generators/template_renderer/partial_resolver.rbs +20 -0
data/sig/generators/template_renderer/template_error.rbs +19 -0
data/sig/generators/template_renderer.rbs +10 -0
data/sig/llm/client.rbs +15 -0
data/sig/llm/config.rbs +20 -0
data/sig/llm/prompts.rbs +8 -0
data/sig/llm/provider.rbs +12 -0
data/sig/llm/providers/anthropic_provider.rbs +16 -0
data/sig/llm/providers/ollama_provider.rbs +18 -0
data/sig/llm/providers/openai_provider.rbs +16 -0
data/sig/llm/response_parser.rbs +13 -0
data/sig/plugin/plugin.rbs +24 -0
data/sig/plugin/plugin_exposer.rbs +20 -0
data/sig/ruby_raider.rbs +15 -0
data/sig/scaffolding/crud_generator.rbs +16 -0
data/sig/scaffolding/dry_run_presenter.rbs +4 -0
data/sig/scaffolding/name_normalizer.rbs +17 -0
data/sig/scaffolding/page_introspector.rbs +14 -0
data/sig/scaffolding/project_detector.rbs +14 -0
data/sig/scaffolding/scaffold_menu.rbs +18 -0
data/sig/scaffolding/scaffolding.rbs +55 -0
data/sig/scaffolding/url_analyzer.rbs +28 -0
data/sig/utilities/desktop_downloader.rbs +23 -0
data/sig/utilities/logger.rbs +13 -0
data/sig/utilities/logo.rbs +16 -0
data/sig/utilities/utilities.rbs +30 -0
data/sig/vendor/thor.rbs +34 -0
data/sig/vendor/tty_prompt.rbs +15 -0
data/spec/adopter/adopt_menu_spec.rb +12 -12
data/spec/adopter/migration_plan_spec.rb +1 -1
data/spec/adopter/migrator_spec.rb +2 -2
data/spec/adopter/project_detector_spec.rb +1 -1
data/spec/commands/raider_commands_spec.rb +129 -0
data/spec/generators/generator_spec.rb +23 -0
data/spec/integration/commands/scaffolding_commands_spec.rb +1 -1
data/spec/integration/commands/utility_commands_spec.rb +23 -3
data/spec/integration/content/ci_content_spec.rb +119 -0
data/spec/integration/content/common_content_spec.rb +288 -0
data/spec/integration/content/config_content_spec.rb +175 -0
data/spec/integration/content/content_helper.rb +32 -0
data/spec/integration/content/gemfile_content_spec.rb +209 -0
data/spec/integration/content/helper_content_spec.rb +485 -0
data/spec/integration/content/page_content_spec.rb +259 -0
data/spec/integration/content/reporter_content_spec.rb +236 -0
data/spec/integration/content/skip_flags_content_spec.rb +206 -0
data/spec/integration/content/syntax_validation_spec.rb +30 -0
data/spec/integration/content/test_content_spec.rb +266 -0
data/spec/integration/end_to_end_features_spec.rb +690 -0
data/spec/integration/end_to_end_spec.rb +52 -16
data/spec/integration/generators/automation_generator_spec.rb +0 -12
data/spec/integration/generators/axe_addon_spec.rb +150 -0
data/spec/integration/generators/common_generator_spec.rb +12 -13
data/spec/integration/generators/config_features_spec.rb +155 -0
data/spec/integration/generators/debug_helper_spec.rb +68 -0
data/spec/integration/generators/helpers_generator_spec.rb +0 -12
data/spec/integration/generators/lighthouse_addon_spec.rb +132 -0
data/spec/integration/generators/minitest_generator_spec.rb +0 -6
data/spec/integration/generators/reporter_spec.rb +159 -0
data/spec/integration/generators/skip_flags_spec.rb +134 -0
data/spec/integration/generators/visual_addon_spec.rb +148 -0
data/spec/integration/settings_helper.rb +0 -3
data/spec/integration/spec_helper.rb +30 -13
data/spec/llm/client_spec.rb +79 -0
data/spec/llm/config_spec.rb +92 -0
data/spec/llm/prompts_spec.rb +49 -0
data/spec/llm/response_parser_spec.rb +92 -0
data/spec/menus/adopter_adopt_menu_spec.rb +97 -0
data/spec/menus/menu_generator_spec.rb +263 -0
data/spec/scaffolding/name_normalizer_spec.rb +113 -0
data/spec/scaffolding/page_introspector_spec.rb +82 -0
data/spec/scaffolding/scaffold_project_detector_spec.rb +104 -0
data/spec/scaffolding/scaffolding_features_spec.rb +311 -0
data/spec/scaffolding/url_analyzer_spec.rb +110 -0
data/spec/system/adopt_matrix_spec.rb +537 -0
data/spec/system/adopt_spec.rb +225 -0
data/spec/system/support/system_test_helper.rb +0 -2
data/spec/utilities/desktop_downloader_spec.rb +92 -0
metadata +150 -5
data/lib/generators/automation/templates/visual_options.tt +0 -16
data/lib/generators/templates/helpers/partials/axe_driver.tt +0 -10
data/lib/generators/templates/helpers/visual_spec_helper.tt +0 -35

data/spec/scaffolding/url_analyzer_spec.rb ADDED Viewed

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+require_relative '../../lib/scaffolding/url_analyzer'
+RSpec.describe UrlAnalyzer do
+  subject(:analyzer) { described_class.new('https://example.com/login') }
+  let(:sample_html) do
+    <<~HTML
+      <html>
+        <body>
+          <form>
+            <input type="text" id="username" name="username" />
+            <input type="password" id="password" name="password" />
+            <input type="hidden" name="csrf" value="token123" />
+            <select id="role" name="role"><option>Admin</option></select>
+            <textarea id="bio" name="bio"></textarea>
+            <button id="login-btn">Log In</button>
+            <input type="submit" id="submit-btn" value="Submit" />
+            <a href="/forgot">Forgot Password</a>
+          </form>
+        </body>
+      </html>
+    HTML
+  end
+  before do
+    stub_request = instance_double(Net::HTTPSuccess, body: sample_html)
+    allow(Net::HTTP).to receive(:get_response).and_return(stub_request)
+  end
+  describe '#analyze' do
+    before { analyzer.analyze }
+    it 'parses input elements (excluding hidden)' do
+      inputs = analyzer.elements.select { |e| e[:type] == :input }
+      expect(inputs.length).to eq(2)
+      names = inputs.map { |e| e[:name] }
+      expect(names).to include('username', 'password')
+    end
+    it 'parses select elements' do
+      selects = analyzer.elements.select { |e| e[:type] == :select }
+      expect(selects.length).to eq(1)
+      expect(selects.first[:name]).to eq('role')
+    end
+    it 'parses textarea elements' do
+      textareas = analyzer.elements.select { |e| e[:type] == :textarea }
+      expect(textareas.length).to eq(1)
+    end
+    it 'parses button elements' do
+      buttons = analyzer.elements.select { |e| e[:type] == :button }
+      expect(buttons.length).to eq(1)
+      expect(buttons.first[:text]).to eq('Log In')
+    end
+    it 'parses submit inputs' do
+      submits = analyzer.elements.select { |e| e[:type] == :submit }
+      expect(submits.length).to eq(1)
+    end
+    it 'parses link elements' do
+      links = analyzer.elements.select { |e| e[:type] == :link }
+      expect(links.length).to eq(1)
+      expect(links.first[:name]).to eq('forgot_password')
+    end
+    it 'prefers id locators' do
+      username = analyzer.elements.find { |e| e[:name] == 'username' }
+      expect(username[:locator]).to eq(type: :id, value: 'username')
+    end
+  end
+  describe '#page_name' do
+    it 'derives name from URL path' do
+      expect(analyzer.page_name).to eq('login')
+    end
+    it 'uses name override when provided' do
+      custom = described_class.new('https://example.com/login', name_override: 'auth')
+      expect(custom.page_name).to eq('auth')
+    end
+    it 'defaults to home for root URL' do
+      root = described_class.new('https://example.com/')
+      expect(root.page_name).to eq('home')
+    end
+  end
+  describe '#to_h' do
+    it 'returns structured hash' do
+      analyzer.analyze
+      result = analyzer.to_h
+      expect(result).to include(:page_name, :url, :url_path, :elements)
+      expect(result[:url_path]).to eq('/login')
+    end
+  end
+  describe 'AI mode' do
+    let(:ai_analyzer) { described_class.new('https://example.com/login', ai: true) }
+    it 'falls back to regex parsing when LLM is unavailable' do
+      allow_any_instance_of(described_class).to receive(:analyze_with_llm).and_return(nil)
+      ai_analyzer.analyze
+      expect(ai_analyzer.elements).not_to be_empty
+    end
+  end
+end

data/spec/system/adopt_matrix_spec.rb ADDED Viewed

@@ -0,0 +1,537 @@
+# frozen_string_literal: true
+require 'fileutils'
+require 'yaml'
+require_relative '../../lib/adopter/adopt_menu'
+describe 'Adopt matrix: all target combinations' do
+  source_dir = 'tmp_adopt_matrix_source'
+  before(:all) do # rubocop:disable RSpec/BeforeAfterAll
+    FileUtils.mkdir_p("#{source_dir}/pages")
+    FileUtils.mkdir_p("#{source_dir}/spec")
+    FileUtils.mkdir_p("#{source_dir}/features/step_definitions")
+    File.write("#{source_dir}/Gemfile", <<~GEMFILE)
+      gem 'rspec'
+      gem 'selenium-webdriver'
+      gem 'faker'
+      gem 'dotenv'
+    GEMFILE
+    File.write("#{source_dir}/pages/login_page.rb", <<~RUBY)
+      class LoginPage < BasePage
+        def login(user, pass)
+          driver.find_element(id: 'user').send_keys user
+          driver.find_element(id: 'pass').send_keys pass
+          driver.find_element(id: 'submit').click
+        end
+      end
+    RUBY
+    File.write("#{source_dir}/pages/dashboard_page.rb", <<~RUBY)
+      class DashboardPage < BasePage
+        def welcome_message
+          driver.find_element(css: '.welcome').text
+        end
+      end
+    RUBY
+    File.write("#{source_dir}/spec/login_spec.rb", <<~RUBY)
+      describe 'Login' do
+        it 'can log in' do
+          page = LoginPage.new(driver)
+          page.login('admin', 'secret')
+          expect(page).to be_truthy
+        end
+      end
+    RUBY
+    File.write("#{source_dir}/spec/dashboard_spec.rb", <<~RUBY)
+      describe 'Dashboard' do
+        it 'shows welcome' do
+          expect(true).to eq true
+        end
+      end
+    RUBY
+    File.write("#{source_dir}/features/login.feature", <<~GHERKIN)
+      Feature: Login
+        Scenario: Valid login
+          Given I am on the login page
+          When I log in with valid credentials
+          Then I see the dashboard
+    GHERKIN
+    File.write("#{source_dir}/features/step_definitions/login_steps.rb", <<~RUBY)
+      Given('I am on the login page') do
+        @page = LoginPage.new(driver)
+      end
+      When('I log in with valid credentials') do
+        @page.login('admin', 'secret')
+      end
+      Then('I see the dashboard') do
+        expect(true).to eq true
+      end
+    RUBY
+    # Generate all 9 combinations
+    Adopter::AdoptMenu::WEB_AUTOMATIONS.each do |automation|
+      Adopter::AdoptMenu::TEST_FRAMEWORKS.each do |framework|
+        output = "tmp_adopt_matrix_#{automation}_#{framework}"
+        Adopter::AdoptMenu.adopt(
+          source_path: source_dir,
+          output_path: output,
+          target_automation: automation,
+          target_framework: framework
+        )
+      end
+    end
+  end
+  after(:all) do # rubocop:disable RSpec/BeforeAfterAll
+    FileUtils.rm_rf(source_dir)
+    Adopter::AdoptMenu::WEB_AUTOMATIONS.each do |automation|
+      Adopter::AdoptMenu::TEST_FRAMEWORKS.each do |framework|
+        FileUtils.rm_rf("tmp_adopt_matrix_#{automation}_#{framework}")
+      end
+    end
+  end
+  # --- Shared examples ---
+  shared_examples 'valid adopted project structure' do |output_dir|
+    it 'creates Gemfile' do
+      expect(File).to exist("#{output_dir}/Gemfile")
+    end
+    it 'creates Rakefile' do
+      expect(File).to exist("#{output_dir}/Rakefile")
+    end
+    it 'creates Readme.md' do
+      expect(File).to exist("#{output_dir}/Readme.md")
+    end
+    it 'creates .rubocop.yml' do
+      expect(File).to exist("#{output_dir}/.rubocop.yml")
+    end
+    it 'creates config/config.yml' do
+      expect(File).to exist("#{output_dir}/config/config.yml")
+    end
+    it 'creates page_objects directory' do
+      expect(File).to exist("#{output_dir}/page_objects/pages")
+    end
+    it 'creates abstract page' do
+      expect(File).to exist("#{output_dir}/page_objects/abstract/page.rb")
+    end
+  end
+  shared_examples 'converted pages' do |output_dir|
+    it 'converts login page into raider path' do
+      expect(File).to exist("#{output_dir}/page_objects/pages/login.rb")
+    end
+    it 'converts dashboard page into raider path' do
+      expect(File).to exist("#{output_dir}/page_objects/pages/dashboard.rb")
+    end
+    it 'adds frozen_string_literal to login page' do
+      page = File.read("#{output_dir}/page_objects/pages/login.rb")
+      expect(page).to include('# frozen_string_literal: true')
+    end
+    it 'updates login page base class to Page' do
+      page = File.read("#{output_dir}/page_objects/pages/login.rb")
+      expect(page).to include('class LoginPage < Page')
+    end
+    it 'updates dashboard page base class to Page' do
+      page = File.read("#{output_dir}/page_objects/pages/dashboard.rb")
+      expect(page).to include('class DashboardPage < Page')
+    end
+  end
+  shared_examples 'merged gems' do |output_dir|
+    it 'includes custom gems from source' do
+      gemfile = File.read("#{output_dir}/Gemfile")
+      expect(gemfile).to include("gem 'faker'")
+      expect(gemfile).to include("gem 'dotenv'")
+    end
+    it 'does not duplicate framework gems' do
+      gemfile = File.read("#{output_dir}/Gemfile")
+      occurrences = gemfile.scan("gem 'rspec'").length + gemfile.scan("gem 'selenium-webdriver'").length
+      expect(occurrences).to be <= 2
+    end
+  end
+  shared_examples 'allure helper' do |output_dir|
+    it 'creates allure_helper.rb' do
+      expect(File).to exist("#{output_dir}/helpers/allure_helper.rb")
+    end
+    it 'allure_helper defines AllureHelper module' do
+      content = File.read("#{output_dir}/helpers/allure_helper.rb")
+      expect(content).to include('module AllureHelper')
+    end
+  end
+  # --- Automation-specific helpers ---
+  shared_examples 'selenium helpers' do |output_dir|
+    it 'creates driver_helper.rb' do
+      expect(File).to exist("#{output_dir}/helpers/driver_helper.rb")
+    end
+    it 'driver_helper defines DriverHelper module' do
+      content = File.read("#{output_dir}/helpers/driver_helper.rb")
+      expect(content).to include('module DriverHelper')
+    end
+    it 'driver_helper requires selenium-webdriver' do
+      content = File.read("#{output_dir}/helpers/driver_helper.rb")
+      expect(content).to include("require 'selenium-webdriver'")
+    end
+    it 'does not create browser_helper.rb' do
+      expect(File).not_to exist("#{output_dir}/helpers/browser_helper.rb")
+    end
+    it 'does not create capybara_helper.rb' do
+      expect(File).not_to exist("#{output_dir}/helpers/capybara_helper.rb")
+    end
+  end
+  shared_examples 'watir helpers' do |output_dir|
+    it 'creates browser_helper.rb' do
+      expect(File).to exist("#{output_dir}/helpers/browser_helper.rb")
+    end
+    it 'browser_helper defines BrowserHelper module' do
+      content = File.read("#{output_dir}/helpers/browser_helper.rb")
+      expect(content).to include('module BrowserHelper')
+    end
+    it 'browser_helper requires watir' do
+      content = File.read("#{output_dir}/helpers/browser_helper.rb")
+      expect(content).to include("require 'watir'")
+    end
+    it 'does not create driver_helper.rb' do
+      expect(File).not_to exist("#{output_dir}/helpers/driver_helper.rb")
+    end
+    it 'does not create capybara_helper.rb' do
+      expect(File).not_to exist("#{output_dir}/helpers/capybara_helper.rb")
+    end
+  end
+  shared_examples 'capybara helpers' do |output_dir|
+    it 'creates capybara_helper.rb' do
+      expect(File).to exist("#{output_dir}/helpers/capybara_helper.rb")
+    end
+    it 'capybara_helper defines CapybaraHelper module' do
+      content = File.read("#{output_dir}/helpers/capybara_helper.rb")
+      expect(content).to include('module CapybaraHelper')
+    end
+    it 'capybara_helper requires capybara' do
+      content = File.read("#{output_dir}/helpers/capybara_helper.rb")
+      expect(content).to include("require 'capybara'")
+    end
+    it 'does not create driver_helper.rb' do
+      expect(File).not_to exist("#{output_dir}/helpers/driver_helper.rb")
+    end
+    it 'does not create browser_helper.rb' do
+      expect(File).not_to exist("#{output_dir}/helpers/browser_helper.rb")
+    end
+  end
+  # --- Framework-specific structure ---
+  shared_examples 'rspec structure' do |output_dir|
+    it 'creates spec directory' do
+      expect(File).to exist("#{output_dir}/spec")
+    end
+    it 'creates spec_helper.rb' do
+      expect(File).to exist("#{output_dir}/helpers/spec_helper.rb")
+    end
+    it 'spec_helper defines SpecHelper module' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include('module SpecHelper')
+    end
+    it 'converts source tests into spec directory' do
+      expect(File).to exist("#{output_dir}/spec/login_spec.rb")
+    end
+    it 'converts dashboard test into spec directory' do
+      expect(File).to exist("#{output_dir}/spec/dashboard_spec.rb")
+    end
+    it 'does not create test directory' do
+      expect(Dir).not_to exist("#{output_dir}/test")
+    end
+    it 'does not create features directory with step definitions' do
+      expect(File).not_to exist("#{output_dir}/features/step_definitions/login_steps.rb")
+    end
+  end
+  shared_examples 'cucumber structure' do |output_dir|
+    it 'creates features directory' do
+      expect(File).to exist("#{output_dir}/features")
+    end
+    it 'creates features/support/env.rb' do
+      expect(File).to exist("#{output_dir}/features/support/env.rb")
+    end
+    it 'creates cucumber.yml' do
+      expect(File).to exist("#{output_dir}/cucumber.yml")
+    end
+    it 'copies feature files' do
+      expect(File).to exist("#{output_dir}/features/login.feature")
+    end
+    it 'feature files contain Gherkin keywords' do
+      content = File.read("#{output_dir}/features/login.feature")
+      expect(content).to include('Feature:')
+      expect(content).to include('Scenario:')
+    end
+    it 'copies step definitions' do
+      expect(File).to exist("#{output_dir}/features/step_definitions/login_steps.rb")
+    end
+    it 'does not create spec directory with converted tests' do
+      expect(File).not_to exist("#{output_dir}/spec/login_spec.rb")
+    end
+    it 'does not create test directory' do
+      expect(Dir).not_to exist("#{output_dir}/test")
+    end
+  end
+  shared_examples 'minitest structure' do |output_dir|
+    it 'creates test directory' do
+      expect(File).to exist("#{output_dir}/test")
+    end
+    it 'creates test_helper.rb' do
+      expect(File).to exist("#{output_dir}/helpers/test_helper.rb")
+    end
+    it 'test_helper defines TestHelper module' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include('module TestHelper')
+    end
+    it 'test_helper requires minitest/autorun' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include("require 'minitest/autorun'")
+    end
+    it 'converts source tests into test directory' do
+      expect(File).to exist("#{output_dir}/test/test_login.rb")
+    end
+    it 'does not create spec directory with converted tests' do
+      expect(File).not_to exist("#{output_dir}/spec/login_spec.rb")
+    end
+    it 'does not create features directory with step definitions' do
+      expect(File).not_to exist("#{output_dir}/features/step_definitions/login_steps.rb")
+    end
+  end
+  # --- Automation-framework helper wiring ---
+  shared_examples 'rspec wired to selenium' do |output_dir|
+    it 'spec_helper includes DriverHelper' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include('DriverHelper')
+    end
+    it 'spec_helper requires driver_helper' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include("require_relative 'driver_helper'")
+    end
+  end
+  shared_examples 'rspec wired to watir' do |output_dir|
+    it 'spec_helper includes BrowserHelper' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include('BrowserHelper')
+    end
+    it 'spec_helper requires browser_helper' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include("require_relative 'browser_helper'")
+    end
+  end
+  shared_examples 'rspec wired to capybara' do |output_dir|
+    it 'spec_helper includes Capybara::DSL' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include('Capybara::DSL')
+    end
+    it 'spec_helper requires capybara_helper' do
+      content = File.read("#{output_dir}/helpers/spec_helper.rb")
+      expect(content).to include("require_relative 'capybara_helper'")
+    end
+  end
+  shared_examples 'minitest wired to selenium' do |output_dir|
+    it 'test_helper includes DriverHelper' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include('DriverHelper')
+    end
+    it 'test_helper requires driver_helper' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include("require_relative 'driver_helper'")
+    end
+  end
+  shared_examples 'minitest wired to watir' do |output_dir|
+    it 'test_helper includes BrowserHelper' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include('BrowserHelper')
+    end
+    it 'test_helper requires browser_helper' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include("require_relative 'browser_helper'")
+    end
+  end
+  shared_examples 'minitest wired to capybara' do |output_dir|
+    it 'test_helper includes Capybara::DSL' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include('Capybara::DSL')
+    end
+    it 'test_helper requires capybara_helper' do
+      content = File.read("#{output_dir}/helpers/test_helper.rb")
+      expect(content).to include("require_relative 'capybara_helper'")
+    end
+  end
+  # === The 9 combinations (3 automations x 3 frameworks) ===
+  # --- Selenium ---
+  context 'selenium + rspec' do
+    output = 'tmp_adopt_matrix_selenium_rspec'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'selenium helpers', output
+    it_behaves_like 'rspec structure', output
+    it_behaves_like 'rspec wired to selenium', output
+  end
+  context 'selenium + cucumber' do
+    output = 'tmp_adopt_matrix_selenium_cucumber'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'selenium helpers', output
+    it_behaves_like 'cucumber structure', output
+  end
+  context 'selenium + minitest' do
+    output = 'tmp_adopt_matrix_selenium_minitest'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'selenium helpers', output
+    it_behaves_like 'minitest structure', output
+    it_behaves_like 'minitest wired to selenium', output
+  end
+  # --- Capybara ---
+  context 'capybara + rspec' do
+    output = 'tmp_adopt_matrix_capybara_rspec'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'capybara helpers', output
+    it_behaves_like 'rspec structure', output
+    it_behaves_like 'rspec wired to capybara', output
+  end
+  context 'capybara + cucumber' do
+    output = 'tmp_adopt_matrix_capybara_cucumber'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'capybara helpers', output
+    it_behaves_like 'cucumber structure', output
+  end
+  context 'capybara + minitest' do
+    output = 'tmp_adopt_matrix_capybara_minitest'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'capybara helpers', output
+    it_behaves_like 'minitest structure', output
+    it_behaves_like 'minitest wired to capybara', output
+  end
+  # --- Watir ---
+  context 'watir + rspec' do
+    output = 'tmp_adopt_matrix_watir_rspec'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'watir helpers', output
+    it_behaves_like 'rspec structure', output
+    it_behaves_like 'rspec wired to watir', output
+  end
+  context 'watir + cucumber' do
+    output = 'tmp_adopt_matrix_watir_cucumber'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'watir helpers', output
+    it_behaves_like 'cucumber structure', output
+  end
+  context 'watir + minitest' do
+    output = 'tmp_adopt_matrix_watir_minitest'
+    it_behaves_like 'valid adopted project structure', output
+    it_behaves_like 'converted pages', output
+    it_behaves_like 'merged gems', output
+    it_behaves_like 'allure helper', output
+    it_behaves_like 'watir helpers', output
+    it_behaves_like 'minitest structure', output
+    it_behaves_like 'minitest wired to watir', output
+  end
+end