ruby_raider 3.11.0 → 3.12.1

data/spec/integration/end_to_end_spec.rb

@@ -265,11 +265,30 @@ describe 'End-to-End Project Generation and Execution' do
     FileUtils.rm_f(File.join(project, 'features/step_definitions/reporter_failure_steps.rb'))
   end
 
+  # Runs the project's own RuboCop with the gems its bundle resolved (newer than this gem's dev bundle).
+  # It runs from a copy outside this repo, as a user's project would: inside it RuboCop would also read
+  # this repo's .rubocop.yml, gemspec and .ruby-version.
+  def expect_project_rubocop_clean(project)
+    skip 'Bundle install failed' unless bundle_install(project)
+
+    Dir.mktmpdir('raider_rubocop') do |tmp|
+      copy = File.join(tmp, project)
+      FileUtils.cp_r(project, copy)
+      puts run_in_project(copy, 'bundle exec rubocop -V', timeout: 60)[:stdout]
+      result = run_in_project(copy, 'bundle exec rubocop --cache false', timeout: 180)
+      expect(result[:exit_code]).to eq(0), "STDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+    end
+  end
+
   # Test Web Frameworks (these can run without external services)
   context 'Web Automation Frameworks' do
     describe 'Selenium + RSpec' do
       include_examples 'executable rspec project', 'rspec_selenium'
 
+      it 'passes its own RuboCop with its bundled gems', :slow do
+        expect_project_rubocop_clean('rspec_selenium')
+      end
+
       it 'saves the login once and reuses it', :aggregate_failures, :slow do
         skip 'Bundle install failed' unless bundle_install('rspec_selenium')
 
@@ -300,6 +319,10 @@ describe 'End-to-End Project Generation and Execution' do
 
     describe 'Selenium + Cucumber' do
       include_examples 'executable cucumber project', 'cucumber_selenium'
+
+      it 'passes its own RuboCop with its bundled gems', :slow do
+        expect_project_rubocop_clean('cucumber_selenium')
+      end
     end
 
     describe 'Watir + Cucumber' do
@@ -398,6 +421,40 @@ describe 'End-to-End Project Generation and Execution' do
     end
   end
 
+  # An empty skeleton (examples: false) still passes its run, so its CI is green until tests are added
+  def generate_skeleton_project(framework)
+    name = "skeleton_e2e_#{framework}_selenium"
+    unless LazyProjectGenerator::GENERATED.include?(name)
+      generate_framework(framework:, automation: 'selenium', name:, examples: false)
+      LazyProjectGenerator::GENERATED.add(name)
+    end
+    name
+  end
+
+  context 'Empty skeleton projects (examples: false)' do
+    it 'runs bundle exec rspec on a selenium rspec skeleton with 0 examples', :aggregate_failures do
+      project = generate_skeleton_project('rspec')
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      ['rspec', 'rspec spec/'].each do |command|
+        result = run_in_project(project, "bundle exec #{command}", timeout: 120)
+        expect(result[:exit_code]).to eq(0), "#{command}\nSTDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+        expect(result[:stdout]).to include('0 examples, 0 failures')
+      end
+    end
+
+    it 'runs bundle exec cucumber on a selenium cucumber skeleton with 0 scenarios', :aggregate_failures do
+      project = generate_skeleton_project('cucumber')
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      ['cucumber', 'cucumber features'].each do |command|
+        result = run_in_project(project, "bundle exec #{command}", timeout: 120)
+        expect(result[:exit_code]).to eq(0), "#{command}\nSTDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+        expect(result[:stdout]).to include('0 scenarios')
+      end
+    end
+  end
+
   # Failure video replay against real browsers. Needs an ffmpeg with libvpx (RAIDER_FFMPEG_PATH), because the
   # RaiderHQ ffmpeg release has no checksums yet. Skipped when it, or the browser, is missing. Firefox can be
   # pointed at a specific binary with FIREFOX_BINARY.
@@ -683,38 +740,26 @@ describe 'End-to-End Project Generation and Execution' do
 
   # Verify template system performance (caching working)
   context 'Template System Performance' do
-    it 'benefits from template caching on second generation' do
+    it 'compiles each partial once and reuses it on the second generation' do
       require_relative '../../lib/generators/generator'
 
-      # Clear cache
       Generator.clear_template_cache
+      compiled = []
+      allow_any_instance_of(TemplateRenderer::PartialCache).to(
+        receive(:compile_template).and_wrap_original { |original, *args| compiled << args.first && original.call(*args) }
+      )
 
-      # First generation (cache miss)
-      start_time = Time.now
-      settings1 = create_settings(framework: 'rspec', automation: 'selenium')
-      settings1[:name] = 'test_cache_1'
-      generate_framework(settings1)
-      first_duration = Time.now - start_time
-
-      # Second generation (cache hit)
-      start_time = Time.now
-      settings2 = create_settings(framework: 'rspec', automation: 'selenium')
-      settings2[:name] = 'test_cache_2'
-      generate_framework(settings2)
-      second_duration = Time.now - start_time
-
-      # Second generation should be faster (or similar if I/O dominates)
-      # At minimum, cache should not slow things down
-      expect(second_duration).to be <= (first_duration * 1.2)
-
-      # Cleanup
-      FileUtils.rm_rf('test_cache_1')
-      FileUtils.rm_rf('test_cache_2')
-
-      # Verify cache has entries
-      stats = Generator.template_cache_stats
-      expect(stats[:size]).to be > 0
-      puts "\n📊 Template cache: #{stats[:size]} entries, ~#{stats[:memory_estimate] / 1024}KB"
+      %w[test_cache_1 test_cache_2].map do |name|
+        before = compiled.size
+        generate_framework(create_settings(framework: 'rspec', automation: 'selenium').merge(name:))
+        compiled.size - before
+      end => [first, second]
+
+      expect(first).to be_positive
+      expect(second).to eq(0)
+      expect(Generator.template_cache_stats[:size]).to be_positive
+    ensure
+      FileUtils.rm_rf(%w[test_cache_1 test_cache_2])
     end
   end
 end

data/spec/integration/frozen_string_literal_matcher.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'rspec/expectations'
+
+# Ruby only reads the magic comment in the comment block before the first line of code. Ruby would
+# accept it indented, but the generated project's RuboCop (Layout/CommentIndentation) would not.
+RSpec::Matchers.define :have_frozen_string_literal do
+  match do |content|
+    leading_comments = content.lines.take_while { |line| line.strip.empty? || line.start_with?('#') }
+    leading_comments.any? { |line| line.chomp == '# frozen_string_literal: true' }
+  end
+  failure_message { 'expected an unindented frozen_string_literal magic comment before the first line of code' }
+end

data/spec/integration/generators/automation_generator_spec.rb

@@ -71,4 +71,54 @@ describe AutomationGenerator do
   context 'with cucumber and appium cross platform' do
     include_examples 'creates mobile automation framework', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
   end
+
+  describe 'without example tests' do
+    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+      context "with #{framework} and #{automation}" do
+        let(:name) { ensure_project(framework:, automation:, examples: false) }
+
+        it 'creates no example pages' do
+          expect(Dir.glob("#{name}/page_objects/pages/*.rb")).to be_empty
+        end
+
+        it 'keeps the pages folder with a .keep' do
+          expect(File).to exist("#{name}/page_objects/pages/.keep")
+        end
+
+        it 'creates the abstract page' do
+          expect(File).to exist("#{name}/page_objects/abstract/page.rb")
+        end
+
+        it 'gives the abstract page no header component' do
+          expect(File.read("#{name}/page_objects/abstract/page.rb")).not_to include('Header')
+        end
+
+        it 'creates no models' do
+          expect(File).not_to exist("#{name}/models")
+        end
+      end
+    end
+
+    context 'with a web project' do
+      let(:name) { ensure_project(framework: 'rspec', automation: 'selenium', examples: false) }
+
+      it 'creates the abstract component' do
+        expect(File).to exist("#{name}/page_objects/abstract/component.rb")
+      end
+
+      it 'keeps the components folder with a .keep and no example component' do
+        expect(Dir.children("#{name}/page_objects/components")).to eq(['.keep'])
+      end
+    end
+
+    context 'with watir' do
+      it 'still creates the examples, because the Watir templates are frozen' do
+        InvokeGenerators.generate_framework(framework: 'rspec', automation: 'watir', name: 'skeleton_watir',
+                                            examples: false)
+        expect(File).to exist('skeleton_watir/page_objects/pages/login.rb')
+      ensure
+        FileUtils.rm_rf('skeleton_watir')
+      end
+    end
+  end
 end

data/spec/integration/generators/common_generator_spec.rb

@@ -107,4 +107,24 @@ describe CommonGenerator do
     include_examples 'creates a config file', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates a gitignore file', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
   end
+
+  describe 'without example tests' do
+    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+      context "with #{framework} and #{automation}" do
+        let(:name) { ensure_project(framework:, automation:, examples: false) }
+        let(:ci_file) { automation == 'selenium' ? 'test_pipeline.yml' : 'appium_pipeline.yml' }
+
+        it 'creates the README, Gemfile, Rakefile and CI file' do
+          %W[Readme.md Gemfile Rakefile .github/workflows/#{ci_file}].each do |file|
+            expect(File).to exist("#{name}/#{file}")
+          end
+        end
+
+        it 'creates the settings' do
+          settings = automation == 'ios' ? 'config/capabilities.yml' : 'config/config.yml'
+          expect(File).to exist("#{name}/#{settings}")
+        end
+      end
+    end
+  end
 end

data/spec/integration/generators/config_features_spec.rb

@@ -35,9 +35,9 @@ describe 'Config features for generated projects' do
       expect(config['driver_options']).to be_nil
     end
 
-    it 'generates driver_helper with timeout from config' do
+    it 'generates driver_helper without an implicit wait' do
       helper = File.read('config_selenium_test/helpers/driver_helper.rb')
-      expect(helper).to include("config.fetch('timeout', 10)")
+      expect(helper).not_to include('implicit_wait')
     end
 
     it 'generates spec_helper with viewport-aware window setup' do

data/spec/integration/generators/cucumber_generator_spec.rb

@@ -61,4 +61,40 @@ describe CucumberGenerator do
     include_examples 'creates cucumber files', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}", 'login'
     include_examples 'creates factories for web projects', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}", 'login'
   end
+
+  describe 'without example tests' do
+    %w[selenium ios cross_platform].each do |automation|
+      context "with cucumber and #{automation}" do
+        let(:name) { ensure_project(framework: 'cucumber', automation:, examples: false) }
+
+        it 'creates no feature files' do
+          expect(Dir.glob("#{name}/features/**/*.feature")).to be_empty
+        end
+
+        it 'keeps an empty step_definitions folder' do
+          expect(Dir.children("#{name}/features/step_definitions")).to eq(['.keep'])
+        end
+
+        it 'creates the support files' do
+          expect(Dir.children("#{name}/features/support")).to contain_exactly('env.rb', 'world.rb')
+        end
+
+        it 'creates the cucumber.yml file' do
+          expect(File).to exist("#{name}/cucumber.yml")
+        end
+
+        it 'creates no user factory' do
+          expect(File).not_to exist("#{name}/models/user_factory.rb")
+        end
+      end
+    end
+
+    it 'creates no accessibility example' do
+      InvokeGenerators.generate_framework(framework: 'cucumber', automation: 'selenium', name: 'skeleton_axe_cucumber',
+                                          examples: false, accessibility: true)
+      expect(Dir.glob('skeleton_axe_cucumber/features/**/accessibility*')).to be_empty
+    ensure
+      FileUtils.rm_rf('skeleton_axe_cucumber')
+    end
+  end
 end

data/spec/integration/generators/helpers_generator_spec.rb

@@ -32,6 +32,18 @@ describe HelpersGenerator do
     it 'creates a browser helper file' do
       expect(File).to exist("#{name}/helpers/browser_helper.rb")
     end
+
+    it 'does not create the wait helper or the element wrapper' do
+      expect(File).not_to exist("#{name}/helpers/wait_helper.rb")
+      expect(File).not_to exist("#{name}/helpers/raider_element.rb")
+    end
+  end
+
+  shared_examples 'creates the wait helper' do |name|
+    it 'creates the wait helper and the element wrapper' do
+      expect(File).to exist("#{name}/helpers/wait_helper.rb")
+      expect(File).to exist("#{name}/helpers/raider_element.rb")
+    end
   end
 
   shared_examples 'creates rspec helpers' do |name|
@@ -56,6 +68,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates a session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
   end
 
@@ -70,6 +83,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates a session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
   end
 
@@ -84,6 +98,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
     include_examples 'skips the session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::ANDROID}"
   end
 
@@ -91,6 +106,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
     include_examples 'skips the session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::IOS}"
   end
 
@@ -98,6 +114,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
     include_examples 'skips the session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::ANDROID}"
   end
 
@@ -105,6 +122,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
     include_examples 'skips the session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::IOS}"
   end
 
@@ -112,6 +130,7 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'skips the session state helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates rspec helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cross platform helpers', "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}"
   end
@@ -120,7 +139,26 @@ describe HelpersGenerator do
     include_examples 'creates common helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'skips the session state helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates selenium helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
+    include_examples 'creates the wait helper', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cross platform helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
   end
+
+  describe 'without example tests' do
+    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+      context "with #{framework} and #{automation}" do
+        let(:name) { ensure_project(framework:, automation:, examples: false) }
+
+        it 'creates the wait helper and RaiderElement' do
+          expect(File).to exist("#{name}/helpers/wait_helper.rb")
+          expect(File).to exist("#{name}/helpers/raider_element.rb")
+        end
+      end
+    end
+
+    it 'keeps the session state for web' do
+      name = ensure_project(framework: 'rspec', automation: 'selenium', examples: false)
+      expect(File).to exist("#{name}/helpers/session_state.rb")
+    end
+  end
 end

data/spec/integration/generators/invoke_generators_spec.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'fileutils'
+require 'tmpdir'
 require 'open3'
 require_relative '../spec_helper'
 
@@ -49,4 +50,133 @@ describe InvokeGenerators do
       expect(File).not_to exist('case_bad_ci')
     end
   end
+
+  describe '.collect_flags' do
+    it 'adds no_examples when examples is false' do
+      expect(described_class.collect_flags(automation: 'selenium', examples: false)).to include('no_examples')
+    end
+
+    it 'keeps the examples by default' do
+      expect(described_class.collect_flags(automation: 'selenium')).not_to include('no_examples')
+    end
+
+    it 'keeps the examples for watir, whose templates are frozen' do
+      expect(described_class.collect_flags(automation: 'watir', examples: false)).not_to include('no_examples')
+    end
+  end
+
+  context 'with the Watir deprecation notice' do
+    let(:notice) do
+      'Watir is deprecated and will be removed in the next major version of ruby_raider; new projects should use Selenium.'
+    end
+
+    it 'prints it for watir' do
+      expect { described_class.generate_framework(framework: 'rspec', automation: 'watir', name: 'case_dep') }
+        .to output(/#{Regexp.escape(notice)}/).to_stdout
+    end
+
+    it 'does not print it for selenium' do
+      expect { described_class.generate_framework(framework: 'rspec', automation: 'selenium', name: 'case_nodep') }
+        .not_to output(/Watir is deprecated/).to_stdout
+    end
+
+    it 'still prints it for raider new with automation:watir' do
+      root = File.expand_path('../../..', __dir__)
+      out, status = Open3.capture2e('ruby', "#{root}/bin/raider", 'new', 'case_cli_watir', '-p',
+                                    'framework:rspec', 'automation:watir')
+      expect(status.success?).to be(true)
+      expect(out).to include(notice)
+      expect(File).to exist('case_cli_watir/.rspec')
+    end
+  end
+
+  context 'with examples false for watir' do
+    it 'says the examples are kept' do
+      expect { described_class.generate_framework(framework: 'rspec', automation: 'watir', name: 'case_watir', examples: false) }
+        .to output(/Watir projects always include the example tests/).to_stdout
+    end
+  end
+end
+
+describe 'Projects named like a generator option' do
+  after { FileUtils.rm_rf(%w[no_examples watir selenium]) }
+
+  it 'keeps the example tests in a project named no_examples' do
+    InvokeGenerators.generate_framework(automation: 'selenium', framework: 'rspec', name: 'no_examples')
+    expect(File).to exist('no_examples/spec/login_page_spec.rb')
+    expect(File).to exist('no_examples/page_objects/pages/login.rb')
+  end
+
+  it 'gives a Selenium project named watir the wait helper it wires in' do
+    InvokeGenerators.generate_framework(automation: 'selenium', framework: 'cucumber', name: 'watir')
+    expect(File).to exist('watir/helpers/wait_helper.rb')
+    expect(File.read('watir/features/support/env.rb')).not_to include('Watir')
+    expect(File.read('watir/page_objects/abstract/page.rb')).to include('include WaitHelper')
+  end
+
+  it 'keeps a Watir project named selenium on Watir' do
+    InvokeGenerators.generate_framework(automation: 'watir', framework: 'rspec', name: 'selenium')
+    expect(File).not_to exist('selenium/helpers/wait_helper.rb')
+    expect(File.read('selenium/page_objects/abstract/page.rb')).to include('browser.element')
+    expect(File.read('selenium/page_objects/abstract/page.rb')).not_to include('find_element')
+  end
+end
+
+describe 'Option-named projects generate what a neutral name generates' do
+  option_names = %w[ios android cucumber rspec cross_platform axe_addon selenium watir no_examples azure]
+  option_sets = [
+    { automation: 'selenium', framework: 'rspec' },
+    { automation: 'selenium', framework: 'cucumber', accessibility: true },
+    { automation: 'selenium', framework: 'rspec', examples: false, ci: 'azure' },
+    { automation: 'watir', framework: 'cucumber' },
+    { automation: 'ios', framework: 'rspec' },
+    { automation: 'android', framework: 'cucumber' },
+    { automation: 'cross_platform', framework: 'rspec' }
+  ].freeze
+
+  def quietly
+    result = nil
+    expect { result = yield }.to output.to_stdout
+    result
+  end
+
+  def snapshot(name, options)
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        InvokeGenerators.generate_framework(options.merge(name:))
+        Dir.glob("#{name}/**/*", File::FNM_DOTMATCH).select { |f| File.file?(f) }
+           .to_h { |f| [f.delete_prefix("#{name}/"), File.read(f)] }
+      end
+    end
+  end
+
+  option_sets.each do |options|
+    context "with #{options}" do
+      let(:neutral) { quietly { snapshot('demo', options) } }
+
+      option_names.each do |name|
+        it "generates the same files for a project named #{name}" do
+          actual = quietly { snapshot(name, options) }
+          expect(actual.keys.sort).to eq(neutral.keys.sort)
+          expect(actual).to eq(neutral)
+        end
+      end
+    end
+  end
+end
+
+describe 'raider new -p examples: validation' do
+  after { FileUtils.rm_rf(%w[bad_examples]) }
+
+  let(:root) { File.expand_path('../../..', __dir__) }
+
+  it 'rejects an unknown value, names the allowed values and generates nothing' do
+    Dir.mktmpdir do |dir|
+      _out, err, status = Open3.capture3('ruby', "#{root}/bin/raider", 'new', 'x', '-p',
+                                         'framework:rspec', 'automation:selenium', 'examples:no', chdir: dir)
+      expect(status.exitstatus).to eq(1)
+      expect(err).to include('Invalid examples "no". Allowed values: true, false')
+      expect(File).not_to exist(File.join(dir, 'x'))
+    end
+  end
 end

data/spec/integration/generators/rspec_generator_spec.rb

@@ -46,4 +46,24 @@ describe RspecGenerator do
     include_examples 'creates rspec files examples',
                      "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CROSS_PLATFORM}", 'pdp'
   end
+
+  describe 'without example tests' do
+    %w[selenium ios cross_platform].each do |automation|
+      context "with rspec and #{automation}" do
+        let(:name) { ensure_project(framework: 'rspec', automation:, examples: false) }
+
+        it 'creates an empty spec folder' do
+          expect(Dir.children("#{name}/spec")).to eq(['.keep'])
+        end
+      end
+    end
+
+    it 'creates no accessibility example' do
+      InvokeGenerators.generate_framework(framework: 'rspec', automation: 'selenium', name: 'skeleton_axe_rspec',
+                                          examples: false, accessibility: true)
+      expect(Dir.children('skeleton_axe_rspec/spec')).to eq(['.keep'])
+    ensure
+      FileUtils.rm_rf('skeleton_axe_rspec')
+    end
+  end
 end

data/spec/integration/helpers/session_state_spec.rb

@@ -2,6 +2,7 @@
 
 require 'erb'
 require 'json'
+require 'timeout'
 require 'selenium-webdriver'
 require 'time'
 require 'tmpdir'
@@ -409,6 +410,51 @@ describe 'SessionState' do
       expect(Time.iso8601(saved['saved_at'])).to be > before
     end
 
+    it 'lets concurrent callers restore a fresh login at the same time' do
+      write_state('cookies' => [saved_cookie('session')])
+      arrived = Queue.new
+      checked = Queue.new
+      threads = Array.new(2) do
+        Thread.new do
+          valid = lambda do
+            arrived << 1
+            Timeout.timeout(2) { sleep 0.01 until arrived.size == 2 }
+            checked << 1
+          end
+          SessionState.new(SessionStateSpec::FakeDriver.new(cookies:)).reuse(valid:) { raise 'logged in' }
+        end
+      end
+      threads.each(&:join)
+      expect(checked.size).to eq(2)
+    end
+
+    it 'restores a login another worker saved meanwhile, without a fallback warning' do
+      write_state('cookies' => [saved_cookie('session')])
+      checks = 0
+      valid = lambda do
+        checks += 1
+        write_state('cookies' => [saved_cookie('session')], 'saved_at' => Time.now.utc.iso8601) if checks == 1
+        checks > 1
+      end
+      logins = 0
+      expect { state.reuse(valid:) { logins += 1 } }.not_to output.to_stderr
+      expect([logins, checks]).to eq([0, 2])
+    end
+
+    it 'warns once when the second restore after a peer save is also invalid' do
+      write_state('cookies' => [saved_cookie('session')])
+      checks = 0
+      valid = lambda do
+        checks += 1
+        write_state('cookies' => [saved_cookie('session')], 'saved_at' => Time.now.utc.iso8601) if checks == 1
+        false
+      end
+      logins = 0
+      expect { state.reuse(valid:) { logins += 1 } }
+        .to output(/\A\[login_state\] login restored from \S+ is no longer valid, logging in again\n\z/).to_stderr
+      expect(logins).to eq(1)
+    end
+
     it 'serializes concurrent callers on the lock' do
       count = 0
       drivers = Array.new(2) { SessionStateSpec::FakeDriver.new(cookies:) }