nextgen 0.1.0

data/lib/nextgen/commands/create.rb

@@ -0,0 +1,312 @@
+require "active_support/core_ext/string/inflections"
+require "fileutils"
+require "forwardable"
+require "shellwords"
+require "open3"
+require "tmpdir"
+require "tty-prompt"
+require "nextgen/ext/prompt/list"
+require "nextgen/ext/prompt/multilist"
+
+module Nextgen
+  class Commands::Create # rubocop:disable Metrics/ClassLength
+    extend Forwardable
+
+    def self.run(app_path, options)
+      new(app_path, options).run
+    end
+
+    def initialize(app_path, _options)
+      @app_path = File.expand_path(app_path)
+      @app_name = File.basename(@app_path).gsub(/\W/, "_").squeeze("_").camelize
+      @rails_opts = RailsOptions.new
+    end
+
+    def run # rubocop:disable Metrics/MethodLength, Metrics/PerceivedComplexity
+      say <<~BANNER
+        Welcome to nextgen, the interactive Rails app generator!
+
+        You are about to create a Rails app named "#{app_name}" in the following directory:
+
+          #{app_path}
+
+        You'll be asked ~10 questions about database, test framework, and other options.
+        The standard Rails "omakase" experience will be selected by default.
+
+      BANNER
+
+      continue_if "Ready to start?"
+
+      ask_rails_version
+      ask_database
+      ask_full_stack_or_api
+      ask_frontend_management unless rails_opts.api?
+      ask_css unless rails_opts.api? || rails_opts.skip_asset_pipeline?
+      ask_javascript unless rails_opts.api? || rails_opts.skip_asset_pipeline?
+      ask_rails_frameworks
+      ask_test_framework
+      ask_system_testing if rails_opts.frontend? && rails_opts.test_framework?
+      ask_optional_enhancements
+
+      say <<~SUMMARY
+
+        OK! Your Rails app is ready to be created.
+        The following options will be passed to `rails new`:
+
+          #{rails_new_args.join("\n  ")}
+
+        The following nextgen enhancements will also be applied in individual git commits via `rails app:template`:
+
+          #{selected_generators.join(", ").scan(/\S.{0,75}(?:,|$)/).join("\n  ")}
+
+      SUMMARY
+
+      if node?
+        say <<~NODE
+          Based on the options you selected, your app will require Node and Yarn. For reference, you are using these versions:
+
+            Node: #{capture_version("node")}
+            Yarn: #{capture_version("yarn")}
+
+        NODE
+      end
+
+      continue_if "Continue?"
+
+      create_initial_commit_message
+      copy_package_json if node?
+      Nextgen::Rails.run "new", *rails_new_args
+      Dir.chdir(app_path) do
+        Nextgen::Rails.run "app:template", "LOCATION=#{write_generators_script}"
+      end
+
+      say <<~DONE.gsub(/^/, "  ")
+
+
+        #{set_color("Done!", :green)}
+
+        A Rails #{rails_version} app was generated in #{set_color(app_path, :cyan)}.
+        Run #{set_color("bin/setup", :yellow)} in that directory to get started.
+
+
+      DONE
+    end
+
+    private
+
+    attr_accessor :app_path, :app_name, :rails_opts, :generators
+
+    def_delegators :shell, :say, :set_color
+
+    def continue_if(question)
+      if prompt.yes?(question)
+        say
+      else
+        say "Canceled", :red
+        exit
+      end
+    end
+
+    def copy_package_json
+      FileUtils.mkdir_p(app_path)
+      FileUtils.cp(
+        Nextgen.template_path.join("package.json"),
+        File.join(app_path, "package.json")
+      )
+    end
+
+    def rails_version
+      rails_opts.edge? ? "edge (#{Rails.edge_branch} branch)" : Rails.version
+    end
+
+    def ask_rails_version
+      selected = prompt.select(
+        "What version of Rails will you use?",
+        Rails.version => :current,
+        "edge (#{Rails.edge_branch} branch)" => :edge
+      )
+      rails_opts.edge! if selected == :edge
+    end
+
+    def ask_database
+      common_databases = {
+        "SQLite3 (default)" => "sqlite3",
+        "PostgreSQL (recommended)" => "postgresql",
+        "MySQL" => "mysql"
+      }
+      all_databases = common_databases.merge(
+        %w[MySQL Oracle SQLServer JDBCMySQL JDBCSQLite3 JDBCPostgreSQL JDBC].to_h do |name|
+          [name, name.downcase]
+        end,
+        "None (disable Active Record)" => nil
+      )
+      rails_opts.database =
+        prompt.select("Which database?", common_databases.merge("More options..." => false)) ||
+        prompt.select("Which database?", all_databases)
+    end
+
+    def ask_full_stack_or_api
+      api = prompt.select(
+        "What style of Rails app do you need?",
+        "Standard, full-stack Rails (default)" => false,
+        "API only" => true
+      )
+      rails_opts.api! if api
+    end
+
+    def ask_frontend_management
+      frontend = prompt.select(
+        "How will you manage frontend assets?",
+        "Sprockets (default)" => "sprockets",
+        "Propshaft" => "propshaft",
+        "Vite" => :vite
+      )
+      if frontend == :vite
+        rails_opts.asset_pipeline = nil
+        rails_opts.javascript = "vite"
+      else
+        rails_opts.asset_pipeline = frontend
+      end
+    end
+
+    def ask_css
+      rails_opts.css = prompt.select(
+        "Which CSS framework will you use with the asset pipeline?",
+        "None (default)" => nil,
+        "Bootstrap" => "bootstrap",
+        "Bulma" => "bulma",
+        "PostCSS" => "postcss",
+        "Sass" => "sass",
+        "Tailwind" => "tailwind"
+      )
+    end
+
+    def ask_javascript
+      rails_opts.javascript = prompt.select(
+        "Which JavaScript bundler will you use with the asset pipeline?",
+        "Importmap (default)" => "importmap",
+        "ESBuild" => "esbuild",
+        "Rollup" => "rollup",
+        "Webpack" => "webpack",
+        "None" => nil
+      )
+    end
+
+    def ask_rails_frameworks
+      frameworks = {
+        "JBuilder" => "jbuilder",
+        "Action Mailer" => "action_mailer",
+        "Active Job" => "active_job",
+        "Action Cable" => "action_cable"
+      }
+
+      unless rails_opts.api? || rails_opts.skip_javascript?
+        frameworks = {"Hotwire" => "hotwire"}.merge(frameworks)
+      end
+
+      unless rails_opts.skip_active_record?
+        frameworks.merge!(
+          "Active Storage" => "active_storage",
+          "Action Text" => "action_text",
+          "Action Mailbox" => "action_mailbox"
+        )
+      end
+
+      answers = prompt.multi_select(
+        "Which optional Rails frameworks do you need?",
+        frameworks,
+        default: frameworks.keys.reverse
+      )
+
+      (frameworks.values - answers).each { rails_opts.skip_optional_framework!(_1) }
+    end
+
+    def ask_test_framework
+      rails_opts.test_framework = prompt.select(
+        "Which test framework will you use?",
+        "Minitest (default)" => "minitest",
+        "RSpec" => "rspec",
+        "None" => nil
+      )
+    end
+
+    def ask_system_testing
+      system_testing = prompt.select(
+        "Include system testing (capybara)?",
+        "Yes (default)" => true,
+        "No" => false
+      )
+      rails_opts.skip_system_test! unless system_testing
+    end
+
+    def ask_optional_enhancements
+      @generators = Generators.compatible_with(rails_opts: rails_opts)
+
+      answers = prompt.multi_select(
+        "Which optional enhancements would you like to add?",
+        generators.optional.sort_by { |label, _| label.downcase }.to_h
+      )
+      generators.activate(*answers)
+    end
+
+    def create_initial_commit_message
+      path = File.join(app_path, "tmp", "initial_nextgen_commit")
+      FileUtils.mkdir_p(File.dirname(path))
+      File.write(path, <<~COMMIT)
+        Init project with `rails new` (#{Nextgen::Rails.version})
+
+        Nextgen generated this project with the following `rails new` options:
+
+        ```
+        #{rails_opts.to_args.join("\n")}
+        ```
+      COMMIT
+    end
+
+    def rails_new_args
+      [app_path, "--no-rc", *rails_opts.to_args].tap do |args|
+        # Work around a Rails bug where --edge causes --no-rc to get ignored.
+        # Specifying --rc= with a non-existent file has the same effect as --no-rc.
+        @rc_token ||= SecureRandom.hex(8)
+        args << "--rc=#{@rc_token}" if rails_opts.edge?
+      end
+    end
+
+    def node?
+      generators.node_active?
+    end
+
+    def capture_version(command)
+      out, _err, status = Open3.capture3(command, "--version")
+      version = status.success? && out[/\d[.\d]+\d/]
+
+      version || "<unknown>"
+    end
+
+    def selected_generators
+      optional = generators.optional.invert
+      selected = generators.all_active.filter_map { |name| optional[name] }
+
+      selected.any? ? selected.sort_by(&:downcase) : ["<None>"]
+    end
+
+    def write_generators_script
+      new_tempfile_path.tap do |location|
+        File.write(location, generators.to_ruby_script)
+      end
+    end
+
+    def new_tempfile_path
+      token = SecureRandom.hex(8)
+      File.join(Dir.tmpdir, "nextgen_create_#{token}.rb")
+    end
+
+    def prompt
+      @prompt ||= TTY::Prompt.new
+    end
+
+    def shell
+      @shell ||= Thor::Base.shell.new
+    end
+  end
+end

data/lib/nextgen/ext/prompt/list.rb

@@ -0,0 +1,13 @@
+require "tty-prompt"
+require "tty-screen"
+
+module Nextgen::Ext
+  module Prompt::List
+    def initialize(...)
+      super
+      @per_page ||= [TTY::Prompt::Paginator::DEFAULT_PAGE_SIZE, TTY::Screen.height.to_i - 3].max
+    end
+  end
+end
+
+TTY::Prompt::List.prepend(Nextgen::Ext::Prompt::List)

data/lib/nextgen/ext/prompt/multilist.rb

@@ -0,0 +1,16 @@
+require "tty-prompt"
+
+module Nextgen::Ext
+  module Prompt::Multilist
+    private
+
+    def selected_names
+      return "" unless @done
+      return super if @selected.size < 3
+
+      @selected.first.name + " + #{@selected.size - 1} more"
+    end
+  end
+end
+
+TTY::Prompt::MultiList.prepend(Nextgen::Ext::Prompt::Multilist)

data/lib/nextgen/generators/action_mailer.rb

@@ -0,0 +1,26 @@
+say_git "Configure Action Mailer for testing"
+copy_test_support_file "mailer.rb"
+if minitest?
+  empty_directory_with_keep_file "test/mailers"
+elsif rspec?
+  empty_directory_with_keep_file "spec/mailers"
+end
+
+say_git "Ensure absolute URLs can be used in all environments"
+insert_into_file "config/environments/development.rb", <<-RUBY, after: "raise_delivery_errors = false\n"
+  config.action_mailer.default_url_options = {host: "localhost:3000"}
+  config.action_mailer.asset_host = "http://localhost:3000"
+RUBY
+
+insert_into_file "config/environments/test.rb", <<-RUBY, after: "config.action_mailer.delivery_method = :test\n"
+  config.action_mailer.default_url_options = {host: "localhost:3000"}
+  config.action_mailer.asset_host = "http://localhost:3000"
+RUBY
+
+insert_into_file "config/environments/production.rb", <<-RUBY, after: /config\.action_mailer\.raise_deliv.*\n/
+  config.action_mailer.default_url_options = {
+    host: ENV.fetch("RAILS_HOSTNAME", "app.example.com"),
+    protocol: "https"
+  }
+  config.action_mailer.asset_host = "https://\#{ENV.fetch("RAILS_HOSTNAME", "app.example.com")}"
+RUBY

data/lib/nextgen/generators/annotate.rb

@@ -0,0 +1,2 @@
+install_gem "annotate", group: :development
+copy_file "lib/tasks/auto_annotate_models.rake"

data/lib/nextgen/generators/base.rb

@@ -0,0 +1,60 @@
+say_git "Add improved bin/setup script"
+copy_file "bin/setup", mode: :preserve, force: true
+
+say_git "Specify 2-space indent and other general editor settings"
+copy_file ".editorconfig"
+copy_file ".prettierrc.cjs"
+
+say_git "Generate documentation"
+postgres = File.read("Gemfile").match?(/^\s*gem ['"]pg['"]/)
+template "README.md.tt", force: true, context: binding
+copy_file "DEPLOYMENT.md"
+
+say_git "Create a Procfile"
+template "Procfile.tt"
+
+say_git "Set up default rake task"
+test_task = "test:all" if minitest?
+append_to_file "Rakefile", <<~RUBY
+
+  Rake::Task[:default].prerequisites.clear if Rake::Task.task_defined?(:default)
+
+  desc "Run all checks"
+  task default: %w[#{test_task}] do
+    Thor::Base.shell.new.say_status :OK, "All checks passed!"
+  end
+RUBY
+
+if File.exist?("test/application_system_test_case.rb")
+  say_git "Configure system tests"
+  copy_file "test/application_system_test_case.rb", force: true
+end
+
+if File.exist?(".ruby-version") && File.read(".ruby-version").match?(/\A\d+\.\d+.\d+.\s*\z/m)
+  say_git "DRY up Gemfile and .ruby-version file"
+  replacement = 'ruby Pathname.new(__dir__).join(".ruby-version").read.strip'
+  gsub_file "Gemfile", /^ruby "\d.*"$/, replacement
+end
+
+if File.exist?("app/views/layouts/application.html.erb")
+  say_git "Improve title and meta information for HTML layout"
+  gsub_file "app/views/layouts/application.html.erb", "<html>", '<html lang="en">'
+  gsub_file "app/views/layouts/application.html.erb", %r{^\s*<title>.*</title>}, <<~ERB.gsub(/^/, "    ").rstrip
+    <title><%= content_for?(:title) ? strip_tags(yield(:title)) : #{app_const_base.titleize.inspect} %></title>
+    <meta name="apple-mobile-web-app-title" content="#{app_const_base.titleize}">
+  ERB
+end
+
+say_git "Disable legacy javascript and stylesheet generators"
+copy_file "config/initializers/generators.rb"
+
+say_git "Allow force_ssl to be controlled via env var"
+uncomment_lines "config/environments/production.rb", "config.force_ssl = true"
+gsub_file "config/environments/production.rb",
+  "config.force_ssl = true",
+  'config.force_ssl = ENV["RAILS_DISABLE_SSL"].blank?'
+
+if File.exist?("config/database.yml")
+  say_git "Create initial schema.rb"
+  rails_command "db:prepare"
+end

data/lib/nextgen/generators/basic_auth.rb

@@ -0,0 +1,5 @@
+document_deploy_var "BASIC_AUTH_PASSWORD"
+document_deploy_var "BASIC_AUTH_USERNAME",
+  "If this and `BASIC_AUTH_PASSWORD` are present, visitors must use these credentials to access the app"
+copy_file "app/controllers/concerns/basic_auth.rb"
+inject_into_class "app/controllers/application_controller.rb", "ApplicationController", "  include BasicAuth\n"

data/lib/nextgen/generators/brakeman.rb

@@ -0,0 +1,2 @@
+install_gem "brakeman", group: :development, require: false
+binstub "brakeman"

data/lib/nextgen/generators/bundler_audit.rb

@@ -0,0 +1,2 @@
+install_gem "bundler-audit", group: :development, require: false
+binstub "bundler-audit"

data/lib/nextgen/generators/capybara_lockstep.rb

@@ -0,0 +1,4 @@
+install_gem "capybara-lockstep", group: :test
+inject_into_file "app/views/layouts/application.html.erb",
+  "\n    <%= capybara_lockstep if defined?(Capybara::Lockstep) %>",
+  after: /<head\b.*$/

data/lib/nextgen/generators/clean_gemfile.rb

@@ -0,0 +1 @@
+Nextgen::TidyGemfile.clean!

data/lib/nextgen/generators/dotenv.rb

@@ -0,0 +1,3 @@
+install_gem "dotenv-rails", group: %i[development test]
+copy_file ".env.sample"
+gitignore "/.env*", "!/.env.sample"

data/lib/nextgen/generators/erb_lint.rb

@@ -0,0 +1,11 @@
+say_git "Install erb_lint"
+install_gem "erb_lint", group: :development, require: false
+binstub "erb_lint"
+template ".erb-lint.yml.tt"
+
+say_git "Add erblint to default rake task"
+copy_file "lib/tasks/erblint.rake"
+add_lint_task "erblint"
+
+say_git "Auto-correct any existing issues"
+run "bin/erblint --lint-all -a", capture: true

data/lib/nextgen/generators/eslint.rb

@@ -0,0 +1,24 @@
+say_git "Install eslint"
+add_yarn_packages(
+  "eslint",
+  "eslint-config-prettier",
+  "eslint-plugin-prettier",
+  "prettier",
+  "npm-run-all",
+  "@types/eslint",
+  dev: true
+)
+add_package_json_scripts(
+  "lint:js": "eslint 'app/{components,frontend,javascript}/**/*.{js,jsx,ts,tsx}'",
+  "fix:js": "npm run -- lint:js --fix",
+  lint: "npm-run-all lint:**",
+  fix: "npm-run-all fix:**"
+)
+copy_file ".eslintrc.cjs"
+
+say_git "Add eslint to default rake task"
+copy_file "lib/tasks/eslint.rake"
+add_lint_task "eslint"
+
+say_git "Auto-correct any existing issues"
+run "yarn fix:js", capture: true

data/lib/nextgen/generators/factory_bot_rails.rb

@@ -0,0 +1,16 @@
+say_git "Install factory_bot_rails"
+install_gem "factory_bot_rails", group: %i[development test]
+
+say_git "Include factory_bot methods in tests"
+copy_test_support_file "factory_bot.rb"
+
+say_git "Replace fixtures with factories in generators"
+if minitest?
+  inject_into_file "config/initializers/generators.rb", <<~RUBY, after: "Rails.application.config.generators do |g|\n"
+    g.test_framework :test_unit, fixture: false, fixture_replacement: :factory_bot
+  RUBY
+end
+inject_into_file "config/initializers/generators.rb", <<~RUBY, after: "Rails.application.config.generators do |g|\n"
+  # Generate "users_factory.rb" instead of "users.rb"
+  g.factory_bot suffix: "factory"
+RUBY

data/lib/nextgen/generators/git_safe.rb

@@ -0,0 +1,4 @@
+if Dir.exist?(".git")
+  say_git "Mark project as trusted so bin/ can be added to PATH"
+  empty_directory ".git/safe"
+end

data/lib/nextgen/generators/github_actions.rb

@@ -0,0 +1,2 @@
+gems = File.exist?("Gemfile") ? File.read("Gemfile").scan(/^\s*gem ["'](.+?)["']/).flatten : []
+template ".github/workflows/ci.yml.tt", context: binding

data/lib/nextgen/generators/good_migrations.rb

@@ -0,0 +1 @@
+install_gem "good_migrations"

data/lib/nextgen/generators/home_controller.rb

@@ -0,0 +1,3 @@
+copy_file "app/controllers/home_controller.rb"
+template "app/views/home/index.html.erb.tt"
+route 'root "home#index"'

data/lib/nextgen/generators/initial_git_commit.rb

@@ -0,0 +1,5 @@
+commit_msg = "tmp/initial_nextgen_commit"
+return unless git_working? && File.exist?(commit_msg)
+
+gitignore "node_modules/" if Dir.exist?("node_modules")
+git_commit_all(File.read(commit_msg))

data/lib/nextgen/generators/initial_migrations.rb

@@ -0,0 +1,11 @@
+migration_tasks = %w[
+  action_mailbox:install:migrations
+  action_text:install:migrations
+  active_storage:install
+]
+all_tasks = rails_command("-T", capture: true).scan(/^\S+\s+(\S+)/).flatten
+tasks_to_run = migration_tasks & all_tasks
+return unless tasks_to_run.any?
+
+tasks_to_run.each { |task| rails_command(task) }
+rails_command "db:migrate"

data/lib/nextgen/generators/letter_opener.rb

@@ -0,0 +1,8 @@
+say_git "Install letter_opener"
+install_gem "letter_opener", group: :development
+
+say_git "Configure Action Mailer to use letter_opener"
+insert_into_file "config/environments/development.rb", <<-RUBY, after: "raise_delivery_errors = false\n"
+
+  config.action_mailer.delivery_method = :letter_opener
+RUBY

data/lib/nextgen/generators/node.rb

@@ -0,0 +1,5 @@
+say_git "Add Node and Yarn prerequisites"
+copy_file "package.json" unless File.exist?("package.json")
+inject_into_file "README.md", "\n- Node 18 (LTS) or newer\n- Yarn 1.x (classic)", after: /^- Ruby.*$/
+inject_into_file "README.md", "\nbrew install node\nbrew install yarn", after: /^brew install rbenv.*$/
+gitignore "node_modules/"

data/lib/nextgen/generators/open_browser_on_start.rb

@@ -0,0 +1,12 @@
+say_git "Install launchy"
+install_gem "launchy", group: %i[development test]
+
+say_git "Configure puma to open browser on startup"
+copy_file "lib/puma/plugin/open.rb"
+append_to_file "config/puma.rb", <<~RUBY
+
+  # Automatically open the browser when in development
+  require_relative "../lib/puma/plugin/open"
+  plugin :open
+RUBY
+prevent_autoload_lib "puma/plugin"

data/lib/nextgen/generators/overcommit.rb

@@ -0,0 +1 @@
+template ".overcommit.yml"

data/lib/nextgen/generators/pgcli_rails.rb

@@ -0,0 +1 @@
+install_gem "pgcli-rails", group: :development

data/lib/nextgen/generators/rack_canonical_host.rb

@@ -0,0 +1,8 @@
+say_git "Install rack-canonical-host"
+install_gem "rack-canonical-host"
+
+say_git "Use RAILS_HOSTNAME env var"
+document_deploy_var "RAILS_HOSTNAME", "Redirect all requests to the specified canonical hostname"
+insert_into_file "config.ru",
+  %(use Rack::CanonicalHost, ENV.fetch("RAILS_HOSTNAME", nil) if ENV["RAILS_HOSTNAME"].present?\n),
+  before: /^run Rails.application/

data/lib/nextgen/generators/rack_mini_profiler.rb

@@ -0,0 +1,2 @@
+install_gem "rack-mini-profiler", group: :development
+copy_file "config/initializers/rack_mini_profiler.rb" if File.read("Gemfile").match?(/^\s*gem ['"]turbo-rails['"]/)

data/lib/nextgen/generators/rspec_rails.rb

@@ -0,0 +1,19 @@
+say_git "Install the rspec-rails gem"
+install_gem "rspec-rails", group: %i[development test]
+
+say_git "Run the rspec installer"
+generate "rspec:install"
+gitignore "/spec/examples.txt"
+binstub "rspec-core"
+
+say_git "Disable auto-generation of routing and view specs"
+inject_into_file "config/initializers/generators.rb", <<~RUBY, after: "g.stylesheets false\n"
+  g.routing_specs false
+  g.view_specs false
+RUBY
+
+say_git "Add spec to default rake task"
+inject_into_file "Rakefile", "spec", after: /task default: %w\[/
+
+say_git "Enable auto-loading of the spec/support directory"
+uncomment_lines("spec/rails_helper.rb", /Dir\[Rails.root.join/)

data/lib/nextgen/generators/rspec_system_testing.rb

@@ -0,0 +1,5 @@
+install_gems "capybara", "selenium-webdriver", group: :test
+copy_test_support_file "system.rb"
+
+copy_file "lib/templates/rspec/system/system_spec.rb"
+prevent_autoload_lib "templates"

data/lib/nextgen/generators/rubocop.rb

@@ -0,0 +1,32 @@
+say_git "Install rubocop gems"
+gemfile = File.read("Gemfile")
+plugins = []
+plugins << "capybara" if gemfile.match?(/^\s*gem ['"]capybara['"]/)
+plugins << "factory_bot" if gemfile.match?(/^\s*gem ['"]factory_bot/)
+plugins << "minitest" if minitest?
+plugins << "performance"
+plugins << "rails"
+install_gems "rubocop", *plugins.map { "rubocop-#{_1}" }, group: :development, require: false
+binstub "rubocop"
+
+say_git "Generate .rubocop.yml"
+template ".rubocop.yml", context: binding
+
+if File.exist?(".erb-lint.yml")
+  say_git "Regenerate .erb-lint.yml with rubocop support"
+  template ".erb-lint.yml", force: true
+end
+
+say_git "Add rubocop to default rake task"
+copy_file "lib/tasks/rubocop.rake"
+add_lint_task "rubocop", fix: "rubocop:autocorrect_all"
+inject_into_file "README.md", <<~MARKDOWN, after: /rake fix\n```\n/
+
+  > [!WARNING]
+  > A small number of Rubocop's auto-corrections are considered "unsafe" and may
+  > occasionally produce incorrect results. After running `fix`, you should
+  > review the changes and make sure the code still works as intended.
+MARKDOWN
+
+say_git "Auto-correct any existing issues"
+run "bin/rubocop -A --fail-level F", capture: true