rails-quality-assurance 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4fbc6fbabe01efd826fc05c8a532acc86d0a27b3daa02011637636c8a2cc82b4
+  data.tar.gz: 8b5b8f23af17448d99ed7eff051e39d2df7167c5250ad3a1c7ed84faaf167167
+SHA512:
+  metadata.gz: caa5a305daad24a7341a93fd599f07e3fcc1a29b7f1f48a49278601e6a7dda3ab8cfece9eb19ad24c932b23f731a51f8c9d1c7e8807aedf6b83a11e9c45bff34
+  data.tar.gz: 6eeaf4ad31f53038d9cb23b3d2ec1746fbbc24f01bdce1b315869236f523cba13c4f6d54cb82e67a7d9a4cc7f50a701deb968cc47681aea384a933f911d8dc2d

data/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-09-14
+
+### Added
+
+- Initial release of the Rails Quality Assurance kit.
+- Shared RuboCop configuration for plugins: `rubocop-performance`, `rubocop-rspec`,
+  `rubocop-rspec_rails`, `rubocop-capybara`, `rubocop-factory_bot`,
+  `rubocop-rubycw`, `rubocop-migration`, `rubocop-rails`.
+- `inherit_mode.merge: [Exclude]` so consuming projects add their own
+  exclusions without dropping the shared ones.
+- Reek base configuration with Rails-appropriate defaults.
+- Biome and Stylelint configurations for frontend linting.
+- Single-require test setup via `rails_quality_assurance/all`: SimpleCov
+  100% line & branch coverage with LCOV output, RSpec core defaults, and
+  Playwright/Capybara system test driver with parallel worker port
+  allocation and failure HTML dumps.
+- Rake tasks for quality checks (`qa:lint`, `qa:frontend`, `spec:parallel`).
+- `rails_quality_assurance:ci` generator installing `bin/ci` and
+  `config/ci.rb` for host-level CI execution.
+- Release workflow using RubyGems trusted publishing (OIDC).

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mauricio Zaffari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,125 @@
+# Rails Quality Assurance
+
+Opinionated quality assurance kit for Ruby on Rails applications.
+
+`rails-quality-assurance` provides an out-of-the-box, comprehensive quality control setup designed to work with zero-configuration defaults. It integrates the standard quality control suite used across Develoz Rails applications.
+
+## What's Included
+
+### 1. Style & Linting
+
+- **RuboCop**: Pre-configured `rubocop.yml` targeting Ruby 4.0 with all standard plugins loaded (`rubocop-rails`, `rubocop-rspec`, `rubocop-rspec_rails`, `rubocop-performance`, `rubocop-capybara`, `rubocop-factory_bot`, `rubocop-rubycw`, `rubocop-migration`).
+- **Reek**: Code smell detection with sensible Rails defaults (`config/reek.yml`).
+- **Flay**: Structural code duplication analysis.
+- **Biome**: Pre-configured `config/biome.json` for fast JavaScript/TypeScript/JSON linting and formatting.
+- **Stylelint**: Pre-configured `config/.stylelintrc.json` with Tailwind CSS support.
+
+### 2. Security
+
+- **Brakeman**: Static analysis security vulnerability scanner.
+- **Bundler Audit**: Vulnerability scanner for gem dependencies.
+
+### 3. Testing & Coverage
+
+- **RSpec**: Shared helpers and configuration.
+- **Playwright + Capybara**: Remote Chromium headless driver support with auto port assignment for parallel workers and HTML error state dumps on failure (`require 'rails_quality_assurance/playwright'`).
+- **Parallel Tests**: `rake spec:parallel` task with automated system test isolation.
+- **SimpleCov**: 100% line and branch coverage threshold enforcement, LCOV reporting, and parallel process reporting (`require 'rails_quality_assurance/simplecov'`).
+
+### 4. Continuous Integration Harness
+
+- **`RailsQualityAssurance::CI`**: Built-in pipeline runner modeled after Rails CI harnesses.
+- **CLI / Executable**: Run with `bundle exec rails-qa` or define your pipeline in `config/ci.rb`.
+
+---
+
+## Installation
+
+Add to your `Gemfile`:
+
+```ruby
+group :development, :test do
+  gem 'rails-quality-assurance', require: false
+end
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+---
+
+## Zero-Config Usage
+
+### 1. RuboCop
+
+In your `.rubocop.yml`:
+
+```yaml
+inherit_gem:
+  rails-quality-assurance: rubocop.yml
+
+# Only your application-specific overrides are needed here
+```
+
+### 2. Single Require for Testing & Coverage (spec/spec_helper.rb)
+
+Add a single line at the very top of `spec/spec_helper.rb`:
+
+```ruby
+require 'rails_quality_assurance/all'
+```
+
+That single require sets up:
+
+1. **SimpleCov**: Starts immediately before application code loads, enforcing 100% line & branch coverage thresholds, parallel process aggregation, and LCOV output.
+2. **RSpec**: Configures mock verification of partial doubles, expectations, and metadata inheritance.
+3. **Playwright + Capybara System Tests**: Registers the `:remote_playwright` headless driver, defaults system specs to `:rack_test`, escalates to Playwright for `js: true`, dynamically allocates ports for `parallel_tests` workers, and dumps HTML failure snapshots into `tmp/capybara`.
+
+*(If you prefer to load them individually, `require 'rails_quality_assurance/simplecov'` and `require 'rails_quality_assurance/playwright'` remain available.)*
+
+### 3. Continuous Integration: `bin/ci`
+
+Run the generator to install `bin/ci` and `config/ci.rb`:
+
+```bash
+bin/rails generate rails_quality_assurance:ci
+```
+
+This generates `bin/ci` (executable) and `config/ci.rb` following Develoz standards (matching Pitwall and Develoz B2B).
+
+Run CI anytime on the host:
+
+```bash
+bin/ci
+```
+Or in Docker-based setups:
+```bash
+bin/run bin/ci
+```
+
+### 4. Rake Tasks (Optional)
+
+The gem also provides tasks if you prefer `rake`:
+
+```bash
+bin/rails qa:lint          # Runs RuboCop, Reek, Flay, Brakeman, bundler-audit
+bin/rails qa:frontend      # Runs Biome and Stylelint
+bin/rails spec:parallel    # Runs RSpec in parallel with system specs isolated
+```
+
+---
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+## License
+
+Released under the [MIT License](https://opensource.org/license/mit/).

data/config/biome.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.2/schema.json",
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedImports": "warn",
+        "noUnusedVariables": "warn"
+      },
+      "suspicious": {
+        "useIterableCallbackReturn": "off",
+        "noAssignInExpressions": "off",
+        "noDocumentCookie": "off"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "asNeeded"
+    }
+  },
+  "json": {
+    "formatter": {
+      "indentWidth": 2
+    }
+  },
+  "files": {
+    "includes": [
+      "app/javascript/**/*.js",
+      "app/javascript/**/*.ts",
+      "app/javascript/**/*.jsx",
+      "app/javascript/**/*.tsx"
+    ]
+  }
+}

data/config/reek.yml

@@ -0,0 +1,33 @@
+---
+# Base Reek smell detectors for Rails applications
+exclude_paths:
+  - app/assets
+  - config
+  - db
+  - lib/tasks
+  - vendor
+  - spec
+  - node_modules
+
+detectors:
+  IrresponsibleModule:
+    enabled: false
+  UtilityFunction:
+    enabled: false
+  ControlParameter:
+    enabled: false
+  BooleanParameter:
+    enabled: false
+  FeatureEnvy:
+    enabled: false
+  TooManyStatements:
+    max_statements: 15
+  TooManyMethods:
+    max_methods: 25
+  UncommunicativeVariableName:
+    accept:
+      - e
+      - id
+      - f
+      - i
+      - n

data/lib/generators/rails_quality_assurance/ci/ci_generator.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'rails/generators/base'
+
+module RailsQualityAssurance
+  module Generators
+    # Generates bin/ci and config/ci.rb for host-level CI execution
+    class CiGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Installs bin/ci and config/ci.rb for Rails Continuous Integration'
+
+      def copy_ci_files
+        template 'bin_ci.erb', 'bin/ci'
+        chmod 'bin/ci', 0o755
+        template 'config_ci.rb.erb', 'config/ci.rb'
+      end
+    end
+  end
+end

data/lib/generators/rails_quality_assurance/ci/templates/bin_ci.erb

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../config/boot'
+require 'rails_quality_assurance/ci_runner'
+
+CI = ActiveSupport::ContinuousIntegration
+require_relative '../config/ci'

data/lib/generators/rails_quality_assurance/ci/templates/config_ci.rb.erb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Run using bin/ci
+CI.run do
+  step 'Setup', 'bin/setup --skip-server'
+
+  step 'Style: Ruby', 'bin/rubocop'
+  step 'Style: Reek', 'bundle exec rake qa:reek'
+  step 'Style: Flay', 'bundle exec rake qa:flay'
+
+  step 'Security: Gem audit', 'bundle exec rake qa:audit'
+  step 'Security: Brakeman', 'bin/brakeman --quiet --no-pager --exit-on-warn --exit-on-error'
+
+  step 'Frontend: Biome', 'npm run biome' if File.exist?('biome.json')
+  step 'Frontend: Stylelint', 'npm run stylelint' if File.exist?('.stylelintrc.json')
+
+  step 'Tests: RSpec (parallel)', 'bin/rails spec:parallel'
+
+  # Coverage gate: enforced by SimpleCov in spec/spec_helper.rb (100% line + branch)
+end

data/lib/rails_quality_assurance/all.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# 1. Start SimpleCov immediately before any app code is loaded
+require 'rails_quality_assurance/simplecov'
+
+# 2. Configure RSpec core settings if RSpec is present
+require 'rails_quality_assurance/rspec'
+
+# 3. Configure Capybara + Playwright system test driver
+require 'rails_quality_assurance/playwright'

data/lib/rails_quality_assurance/ci.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'English'
+
+module RailsQualityAssurance
+  # Continuous Integration test and lint execution harness
+  class CI
+    # Represents a single verification step in the pipeline
+    class Step
+      attr_reader :name, :command
+
+      def initialize(name, command)
+        @name = name
+        @command = command
+      end
+
+      def run
+        banner("Running: #{name}")
+
+        system(command)
+        exit_code = $CHILD_STATUS&.exitstatus || 1
+
+        if exit_code.zero?
+          puts "✓ #{name} passed"
+        else
+          puts "✗ #{name} failed (exit code: #{exit_code})"
+          Kernel.exit(exit_code)
+        end
+      end
+    end
+
+    def self.run(&)
+      runner = new
+      runner.instance_eval(&) if block_given?
+      runner.execute
+    end
+
+    def initialize
+      @steps = []
+    end
+
+    def step(name, command = nil, &block)
+      @steps << [name, command || block]
+    end
+
+    def execute
+      banner('Rails Quality Assurance Pipeline')
+
+      @steps.each do |name, action|
+        if action.is_a?(Proc)
+          banner("Running: #{name}")
+          action.call
+        else
+          Step.new(name, action).run
+        end
+      end
+
+      banner('✓ All Quality Assurance checks passed')
+    end
+
+    private
+
+    def banner(text)
+      separator = '=' * 60
+      puts "\n#{separator}"
+      puts text
+      puts separator
+    end
+  end
+end

data/lib/rails_quality_assurance/ci_runner.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/ci'
+
+# Emulate ActiveSupport::ContinuousIntegration interface if needed
+unless defined?(ActiveSupport::ContinuousIntegration)
+  module ActiveSupport
+    module ContinuousIntegration
+      def self.run(&)
+        RailsQualityAssurance::CI.run(&)
+      end
+    end
+  end
+end

data/lib/rails_quality_assurance/playwright/helper.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module RailsQualityAssurance
+  module PlaywrightHelper
+    def self.configure!
+      require 'capybara'
+      require 'capybara-playwright-driver'
+
+      playwright_url = ENV.fetch('PLAYWRIGHT_URL', nil)
+      capybara_port = ENV.fetch('CAPYBARA_SERVER_PORT', 3001)
+
+      register_capybara_driver(playwright_url)
+      configure_rspec(playwright_url, capybara_port) if defined?(RSpec)
+    end
+
+    def self.register_capybara_driver(playwright_url)
+      Capybara.register_driver :remote_playwright do |app|
+        options = {
+          browser_type: :chromium,
+          headless: true,
+          args: ['--disable-dev-shm-usage'],
+          viewport: { width: 1400, height: 1400 },
+          screen: { width: 1400, height: 1400 }
+        }
+
+        if playwright_url.present?
+          options[:browser_server_endpoint_url] = playwright_url
+        elsif local_playwright_cli
+          options[:playwright_cli_executable_path] = local_playwright_cli.to_s
+        end
+
+        Capybara::Playwright::Driver.new(app, **options)
+      end
+    end
+
+    def self.local_playwright_cli
+      return nil unless defined?(Rails)
+
+      cli_path = Rails.root.join('node_modules/.bin/playwright-core')
+      cli_path.executable? ? cli_path : nil
+    end
+
+    def self.configure_rspec(playwright_url, capybara_port)
+      RSpec.configure do |config|
+        setup_system_hooks(config, playwright_url, capybara_port)
+        setup_failure_dump(config)
+      end
+    end
+
+    def self.setup_system_hooks(config, playwright_url, capybara_port)
+      config.before(type: :system) do
+        Capybara.default_max_wait_time = 10
+        driven_by :rack_test
+      end
+
+      config.before(type: :system, js: true) do
+        PlaywrightHelper.apply_js_system_driver(playwright_url, capybara_port)
+      end
+    end
+
+    def self.apply_js_system_driver(playwright_url, capybara_port)
+      if playwright_url.present?
+        Capybara.server_host = '0.0.0.0'
+        base_port = capybara_port.to_i
+        test_env_number = (ENV.fetch('TEST_ENV_NUMBER', nil) || '0').to_i
+        Capybara.server_port = base_port + test_env_number
+
+        hostname = Socket.gethostname
+        Capybara.app_host = "http://#{hostname}:#{Capybara.server_port}"
+      else
+        Capybara.server_port = nil
+        Capybara.app_host = nil
+      end
+
+      Capybara.current_driver = :remote_playwright
+    end
+
+    def self.setup_failure_dump(config)
+      config.after(type: :system) do |example|
+        next unless example.exception
+        next unless defined?(Rails)
+
+        session = Capybara.current_session
+        next unless session.current_url.to_s.start_with?('http')
+
+        save_dir = Rails.root.join('tmp/capybara')
+        FileUtils.mkdir_p(save_dir)
+        slug = example.full_description.parameterize.first(120)
+        path = save_dir.join("failure-#{slug}-#{Process.pid}.html")
+        File.write(path, session.html)
+      rescue StandardError
+        # Never fail the suite on diagnostic errors
+      end
+    end
+  end
+end

data/lib/rails_quality_assurance/playwright.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/playwright/helper'
+RailsQualityAssurance::PlaywrightHelper.configure!

data/lib/rails_quality_assurance/railtie.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module RailsQualityAssurance
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load File.expand_path('../tasks/quality_assurance.rake', __dir__)
+    end
+  end
+end

data/lib/rails_quality_assurance/rspec/helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/simplecov/helper'
+require 'rails_quality_assurance/playwright/helper'
+
+module RailsQualityAssurance
+  module RSpecHelper
+    def self.configure!
+      return unless defined?(RSpec)
+
+      RSpec.configure do |config|
+        configure_expectations(config)
+        configure_mocks(config)
+        config.shared_context_metadata_behavior = :apply_to_host_groups
+        config.order = :random
+      end
+    end
+
+    def self.configure_expectations(config)
+      config.expect_with :rspec do |expectations|
+        expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+      end
+    end
+
+    def self.configure_mocks(config)
+      config.mock_with :rspec do |mocks|
+        mocks.verify_partial_doubles = true
+      end
+    end
+  end
+end

data/lib/rails_quality_assurance/rspec.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/rspec/helper'
+RailsQualityAssurance::RSpecHelper.configure!

data/lib/rails_quality_assurance/simplecov/helper.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module RailsQualityAssurance
+  module SimpleCovHelper
+    def self.configure!
+      return if ENV['NO_COVERAGE']
+      return if filtered_run? && !ENV['COVERAGE']
+
+      require 'simplecov'
+      require 'simplecov-lcov'
+
+      configure_lcov_formatter
+      SimpleCov.formatters = SimpleCov::Formatter::MultiFormatter.new([
+                                                                        SimpleCov::Formatter::HTMLFormatter,
+                                                                        SimpleCov::Formatter::LcovFormatter
+                                                                      ])
+      start_coverage
+    end
+
+    def self.filtered_run?
+      return false unless defined?(RSpec)
+
+      rspec_config = RSpec.configuration
+      rspec_config.files_to_run.one? ||
+        rspec_config.only_failures? ||
+        (rspec_config.inclusion_filter.rules&.size&.> 0)
+    end
+
+    def self.configure_lcov_formatter
+      SimpleCov::Formatter::LcovFormatter.config do |formatter|
+        formatter.report_with_single_file = true
+        formatter.single_report_path = 'public/coverage/lcov.info'
+      end
+    end
+
+    def self.start_coverage
+      SimpleCov.start 'rails' do
+        ENV['SIMPLECOV_INLINE_ASSETS'] = 'true'
+        coverage_dir 'public/coverage'
+        enable_coverage :branch
+
+        command_name "rspec#{ENV.fetch('TEST_ENV_NUMBER', nil)}"
+
+        add_filter '/spec/'
+        add_filter '/config/'
+        add_filter '/vendor/'
+
+        SimpleCov.minimum_coverage line: 100, branch: 100
+      end
+    end
+  end
+end

data/lib/rails_quality_assurance/simplecov.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/simplecov/helper'
+RailsQualityAssurance::SimpleCovHelper.configure!

data/lib/rails_quality_assurance/test_helper.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/all'

data/lib/rails_quality_assurance/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RailsQualityAssurance
+  VERSION = '1.0.0'
+end

data/lib/rails_quality_assurance.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/version'
+require 'rails_quality_assurance/ci'
+
+module RailsQualityAssurance
+  class Error < StandardError; end
+
+  def self.root
+    File.expand_path('..', __dir__)
+  end
+
+  def self.rubocop_config_path
+    File.join(root, 'rubocop.yml')
+  end
+
+  def self.reek_config_path
+    File.join(root, 'config/reek.yml')
+  end
+
+  def self.biome_config_path
+    File.join(root, 'config/biome.json')
+  end
+
+  def self.stylelint_config_path
+    File.join(root, 'config/.stylelintrc.json')
+  end
+end
+
+require 'rails_quality_assurance/railtie' if defined?(Rails::Railtie)

data/lib/tasks/quality_assurance.rake

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance'
+
+namespace :qa do
+  desc 'Run all quality assurance checks (RuboCop, Reek, Flay, Brakeman, bundler-audit)'
+  task lint: %w[qa:rubocop qa:reek qa:flay qa:brakeman qa:audit]
+
+  desc 'Run RuboCop'
+  task rubocop: :environment do
+    sh 'bundle exec rubocop'
+  end
+
+  desc 'Run Reek code smell detection'
+  task reek: :environment do
+    config = File.exist?('.reek.yml') ? '' : "-c #{RailsQualityAssurance.reek_config_path}"
+    sh "bundle exec reek #{config} app lib"
+  end
+
+  desc 'Run Flay structural code duplication analysis'
+  task flay: :environment do
+    mass = ENV.fetch('FLAY_MASS', '300')
+    output = `bundle exec flay --mass #{mass} app lib`
+    puts output
+    abort 'Flay detected structural duplication' unless output.include?('Total score (lower is better) = 0')
+  end
+
+  desc 'Run Brakeman static security analysis'
+  task brakeman: :environment do
+    sh 'bundle exec brakeman --quiet --no-pager --exit-on-warn --exit-on-error'
+  end
+
+  desc 'Run Bundler Audit for vulnerable gems'
+  task audit: :environment do
+    sh 'bundle exec bundle audit check --update'
+  end
+
+  namespace :lint do
+    desc 'Run BiomeJS on JS/TS/JSON'
+    task biome: :environment do
+      config = File.exist?('biome.json') ? '' : "--config-path #{RailsQualityAssurance.biome_config_path}"
+      sh "npx @biomejs/biome check #{config}"
+    end
+
+    desc 'Run Stylelint on CSS'
+    task stylelint: :environment do
+      config = File.exist?('.stylelintrc.json') ? '' : "--config #{RailsQualityAssurance.stylelint_config_path}"
+      sh "npx stylelint #{config} \"**/*.css\""
+    end
+  end
+
+  desc 'Run frontend linters (Biome + Stylelint)'
+  task frontend: %w[qa:lint:biome qa:lint:stylelint]
+
+  desc 'Run all CI checks'
+  task ci: %w[qa:lint qa:frontend spec:parallel]
+end
+
+namespace :lint do
+  desc 'Alias for qa:lint'
+  task all: 'qa:lint'
+
+  desc 'Run BiomeJS linter'
+  task biome: 'qa:lint:biome'
+
+  desc 'Run Stylelint on CSS'
+  task stylelint: 'qa:lint:stylelint'
+end
+
+task lint: 'qa:lint'
+
+namespace :spec do
+  desc 'Run specs in parallel with system specs isolated'
+  task parallel: :environment do
+    ENV['PARALLEL_TEST_FIRST_IS_1'] ||= 'true'
+    parallel_tasks = ENV.fetch('PARALLEL_TEST_PROCESSORS', 3).to_s
+    isolate_tasks = ENV.fetch('ISOLATE_SPEC_TASKS', 1).to_s
+    test_options = ENV.fetch('PARALLEL_SPEC_OPTIONS', nil)
+    raise ArgumentError, 'PARALLEL_TEST_PROCESSORS must be a positive integer' if parallel_tasks.to_i <= 0
+
+    options = "--isolate --single spec/system/ --isolate-n #{isolate_tasks}"
+    options << " --test-options=\"#{test_options}\"" if test_options
+    Rake::Task['parallel:create'].invoke(parallel_tasks)
+    Rake::Task['parallel:load_schema'].invoke(parallel_tasks)
+    Rake::Task['parallel:spec'].invoke(parallel_tasks, nil, nil, options)
+  end
+end

data/rubocop.yml

@@ -0,0 +1,143 @@
+# Develoz Ruby styling.
+#
+# Shared baseline for all Develoz projects. Application-specific tweaks
+# (file excludes, loosened metrics) belong in the project's own
+# .rubocop.yml, which inherits this file.
+#
+# Never remove this line.
+# This merges default exclusions which makes running rubocop much faster.
+inherit_mode:
+  merge:
+    - Exclude
+
+plugins:
+  - rubocop-performance
+  - rubocop-rspec
+  - rubocop-rspec_rails
+  - rubocop-capybara
+  - rubocop-factory_bot
+  - rubocop-rubycw
+  - rubocop-migration
+  - rubocop-rails
+
+AllCops:
+  TargetRubyVersion: 4.0
+  NewCops: enable
+  Exclude:
+    - "bin/*"
+    - "db/schema.rb"
+    - "db/migrate/**/*.rb"
+    - "vendor/**/*"
+    - "config/locales/**/*.yml"
+
+FactoryBot/ExcessiveCreateList:
+  MaxAmount: 15
+
+Layout/LineLength:
+  Max: 120
+  AllowedPatterns:
+    - !ruby/regexp /^ *# /
+
+Migration/AddIndexColumnsCount:
+  Enabled: true
+  MaxColumnsCount: 4
+
+Migration/AddIndexConcurrently:
+  Enabled: true
+
+Migration/AddIndexDuplicate:
+  Enabled: true
+
+Migration/Jsonb:
+  Enabled: true
+
+Naming/VariableNumber:
+  Enabled: false
+
+Rails/SkipsModelValidations:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/SafeNavigationChainLength:
+  Enabled: false
+
+Style/HashSyntax:
+  EnforcedShorthandSyntax: always
+
+Metrics/AbcSize:
+  Max: 35
+
+Metrics/ClassLength:
+  Max: 150
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/BlockLength:
+  Exclude:
+    - "config/**/*"
+    - "lib/tasks/**/*"
+
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+Metrics/PerceivedComplexity:
+  Max: 10
+
+# RSpec system tests naturally have multiple expectations
+RSpec/MultipleExpectations:
+  Max: 5
+  Exclude:
+    - "spec/system/**/*"
+    - "spec/views/**/*"
+    - "spec/helpers/**/*"
+
+# RSpec system tests can be longer
+RSpec/ExampleLength:
+  Max: 15
+  Exclude:
+    - "spec/system/**/*"
+    - "spec/views/**/*"
+    - "spec/helpers/**/*"
+
+# We might want to check texts in tests
+Rails/I18nLocaleTexts:
+  Exclude:
+    - "spec/**/*"
+
+# Allow more memoized helpers in specs for comprehensive testing
+RSpec/MultipleMemoizedHelpers:
+  Max: 10
+
+# Allow I18n.locale assignment in test setup blocks
+Rails/I18nLocaleAssignment:
+  Exclude:
+    - "spec/**/*"
+
+# Allow allow_any_instance_of
+RSpec/AnyInstance:
+  Enabled: false
+
+# Allow expect_any_instance_of
+RSpec/StubbedMock:
+  Enabled: false
+
+# Allow message chains
+RSpec/MessageChain:
+  Enabled: false
+
+RSpec/NestedGroups:
+  Max: 6
+
+# Allow let! setup in specs where roles/associations are needed
+RSpec/LetSetup:
+  Exclude:
+    - "spec/system/**/*"
+    - "spec/requests/**/*"
+    - "spec/controllers/**/*"
+
+# Capybara negation matcher warnings are false positives for have_no_*
+Capybara/NegationMatcherAfterVisit:
+  Enabled: false

metadata

@@ -0,0 +1,390 @@
+--- !ruby/object:Gem::Specification
+name: rails-quality-assurance
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Mauricio Zaffari
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.85.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.85.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.22.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.22.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-factory_bot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.28.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.28.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-migration
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.26.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.26.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.34.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.34.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.9.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.32.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.32.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rubycw
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: brakeman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: flay
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.3'
+- !ruby/object:Gem::Dependency
+  name: parallel_tests
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.40'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.40'
+- !ruby/object:Gem::Dependency
+  name: capybara-playwright-driver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: playwright-ruby-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.50.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.50.0
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: 'Unified QA kit for Rails apps: testing, linters, security audits, parallel
+  execution, and CI.'
+email:
+- mauricio@develoz.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- config/biome.json
+- config/reek.yml
+- lib/generators/rails_quality_assurance/ci/ci_generator.rb
+- lib/generators/rails_quality_assurance/ci/templates/bin_ci.erb
+- lib/generators/rails_quality_assurance/ci/templates/config_ci.rb.erb
+- lib/rails_quality_assurance.rb
+- lib/rails_quality_assurance/all.rb
+- lib/rails_quality_assurance/ci.rb
+- lib/rails_quality_assurance/ci_runner.rb
+- lib/rails_quality_assurance/playwright.rb
+- lib/rails_quality_assurance/playwright/helper.rb
+- lib/rails_quality_assurance/railtie.rb
+- lib/rails_quality_assurance/rspec.rb
+- lib/rails_quality_assurance/rspec/helper.rb
+- lib/rails_quality_assurance/simplecov.rb
+- lib/rails_quality_assurance/simplecov/helper.rb
+- lib/rails_quality_assurance/test_helper.rb
+- lib/rails_quality_assurance/version.rb
+- lib/tasks/quality_assurance.rake
+- rubocop.yml
+homepage: https://github.com/develoz-com/rails-quality-assurance
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/develoz-com/rails-quality-assurance
+  source_code_uri: https://github.com/develoz-com/rails-quality-assurance
+  changelog_uri: https://github.com/develoz-com/rails-quality-assurance/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: Opinionated quality assurance kit for Rails applications.
+test_files: []