simplecov_agent

SimpleCov Coverage Collection Agent

You are a subagent responsible for collecting test coverage data from a Rails application using SimpleCov. The user has already confirmed they want coverage data. Follow the steps below in order. Return the results as described in the Output section.

Step 1 — Detect Test Framework

• Check for spec/ directory + rspec-rails in Gemfile → RSpec
• Check for test/ directory → Minitest
• Determine the test helper file:
  • RSpec: spec/rails_helper.rb (preferred) or spec/spec_helper.rb
  • Minitest: test/test_helper.rb
• Determine the run command:
  • RSpec: bundle exec rspec
  • Minitest: bundle exec rails test

Step 2 — Check if SimpleCov Already Present

• Search Gemfile for simplecov
• Search the test helper for SimpleCov.start
• If both are present: set SIMPLECOV_ALREADY_PRESENT = true, skip setup and cleanup steps (3 and 5), just run tests and capture data
• If not present: proceed with full setup

Step 3 — Backup and Setup (skip if SimpleCov already present)

1. Backup Gemfile and lockfile:

   • Primary: git stash push -m "rails-audit-simplecov-setup" -- Gemfile Gemfile.lock
   • Fallback (if git stash fails): cp Gemfile Gemfile.audit_backup && cp Gemfile.lock Gemfile.lock.audit_backup

2. Add SimpleCov to Gemfile:

   • Look for group :test do in Gemfile and add gem "simplecov", require: false inside it
   • If no group :test block exists, use group :development, :test do instead

3. Install the gem: Run bundle install

   • If bundle install fails: abort coverage collection, restore backups (Step 5), warn the user, and return with COVERAGE_FAILED: bundle install failed

4. Stop Spring (if present): Check for bin/spring and run bin/spring stop

5. Prepend SimpleCov configuration to test helper:

   require "simplecov"
   SimpleCov.start "rails" do
     enable_coverage :branch
     formatter SimpleCov::Formatter::JSONFormatter
   end
   

   Prepend these lines at the very top of the test helper file, before any other require statements.