rubocop 1.79.2 → 1.88.0

data/config/default.yml

@@ -3,20 +3,16 @@
 AllCops:
   RubyInterpreters:
     - ruby
-    - macruby
     - rake
     - jruby
-    - rbx
   # Include common Ruby source files.
   Include:
     - '**/*.rb'
     - '**/*.arb'
     - '**/*.axlsx'
     - '**/*.builder'
-    - '**/*.fcgi'
     - '**/*.gemfile'
     - '**/*.gemspec'
-    - '**/*.god'
     - '**/*.jb'
     - '**/*.jbuilder'
     - '**/*.mspec'
@@ -25,15 +21,12 @@ AllCops:
     - '**/*.podspec'
     - '**/*.rabl'
     - '**/*.rake'
-    - '**/*.rbuild'
     - '**/*.rbw'
-    - '**/*.rbx'
     - '**/*.ru'
     - '**/*.ruby'
     - '**/*.schema'
     - '**/*.spec'
     - '**/*.thor'
-    - '**/*.watchr'
     - '**/.irbrc'
     - '**/.pryrc'
     - '**/.simplecov'
@@ -43,7 +36,6 @@ AllCops:
     - '**/Brewfile'
     - '**/Buildfile'
     - '**/Capfile'
-    - '**/Cheffile'
     - '**/Dangerfile'
     - '**/Deliverfile'
     - '**/Fastfile'
@@ -60,7 +52,6 @@ AllCops:
     - '**/Snapfile'
     - '**/Steepfile'
     - '**/Thorfile'
-    - '**/Vagabondfile'
     - '**/Vagrantfile'
   Exclude:
     - 'node_modules/**/*'
@@ -113,11 +104,17 @@ AllCops:
   # When `NewCops` is `disable`, pending cops are disabled in bulk. Can be overridden by
   # the `--disable-pending-cops` command-line option.
   NewCops: pending
+  # When `true`, RuboCop builds a project index (a project-wide map of declarations and references)
+  # once per run and makes it available to cops that opt in.
+  # The project index is implemented by the optional `rubydex` gem; when `rubydex` is not installed,
+  # a warning is shown and the flag has no effect.
+  # The default `false` preserves RuboCop's traditional file-local analysis.
+  UseProjectIndex: false
   # Enables the result cache if `true`. Can be overridden by the `--cache` command
   # line option.
   UseCache: true
   # Threshold for how many files can be stored in the result cache before some
-  # of the files are automatically removed.
+  # of the files are automatically removed. Set to false to disable cache pruning.
   MaxFilesInCache: 20000
   # The cache will be stored in "rubocop_cache" under this directory. If
   # CacheRootDirectory is ~ (nil), which it is by default, the root will be
@@ -203,12 +200,12 @@ Bundler/GemComment:
   Description: 'Add a comment describing each gem.'
   Enabled: false
   VersionAdded: '0.59'
-  VersionChanged: '0.85'
+  VersionChanged: '1.88'
   Include:
     - '**/*.gemfile'
     - '**/Gemfile'
     - '**/gems.rb'
-  IgnoredGems: []
+  AllowedGems: []
   OnlyFor: []
 
 Bundler/GemFilename:
@@ -275,7 +272,7 @@ Gemspec/AddRuntimeDependency:
   Description: 'Prefer `add_dependency` over `add_runtime_dependency`.'
   StyleGuide: '#add_dependency_vs_add_runtime_dependency'
   References:
-    - https://github.com/rubygems/rubygems/issues/7799#issuecomment-2192720316
+    - https://github.com/ruby/rubygems/issues/7799#issuecomment-2192720316
   Enabled: pending
   VersionAdded: '1.65'
   Include:
@@ -375,7 +372,7 @@ Gemspec/RubyVersionGlobalsUsage:
   Include:
     - '**/*.gemspec'
 
-#################### Layout ###########################
+#################### Layout ################################
 
 Layout/AccessModifierIndentation:
   Description: Checks indentation of private/protected visibility modifiers.
@@ -493,7 +490,7 @@ Layout/BlockEndNewline:
   VersionAdded: '0.49'
 
 Layout/CaseIndentation:
-  Description: 'Indentation of when in a case/(when|in)/[else/]end.'
+  Description: 'Checks how the `when` and `in` clauses of a `case` expression are indented.'
   StyleGuide: '#indent-when-to-case'
   Enabled: true
   VersionAdded: '0.49'
@@ -538,15 +535,22 @@ Layout/ClosingParenthesisIndentation:
   Description: 'Checks the indentation of hanging closing parentheses.'
   Enabled: true
   VersionAdded: '0.49'
+  VersionChanged: '1.86'
+  # By default the indentation width from `Layout/IndentationWidth` is used,
+  # but it can be overridden by setting this parameter.
+  IndentationWidth: ~
 
 Layout/CommentIndentation:
-  Description: 'Indentation of comments.'
+  Description: 'Checks the indentation of comments.'
   Enabled: true
+  VersionAdded: '0.49'
+  VersionChanged: '1.86'
   # When true, allows comments to have extra indentation if that aligns them
   # with a comment on the preceding line.
   AllowForAlignment: false
-  VersionAdded: '0.49'
-  VersionChanged: '1.24'
+  # By default the indentation width from `Layout/IndentationWidth` is used,
+  # but it can be overridden by setting this parameter.
+  IndentationWidth: ~
 
 Layout/ConditionPosition:
   Description: >-
@@ -835,6 +839,7 @@ Layout/FirstArrayElementLineBreak:
                  multi-line array.
   Enabled: false
   VersionAdded: '0.49'
+  AllowImplicitArrayLiterals: false
   AllowMultilineFinalElement: false
 
 Layout/FirstHashElementIndentation:
@@ -907,9 +912,9 @@ Layout/HashAlignment:
     Align the elements of a hash literal if they span more than
     one line.
   Enabled: true
-  AllowMultipleStyles: true
   VersionAdded: '0.49'
   VersionChanged: '1.16'
+  AllowMultipleStyles: true
   # Alignment of entries using hash rocket as separator. Valid values are:
   #
   # key - left alignment of keys
@@ -984,8 +989,8 @@ Layout/HeredocArgumentClosingParenthesis:
   Description: >-
                  Checks for the placement of the closing parenthesis in a
                  method call that passes a HEREDOC string as an argument.
-  Enabled: false
   StyleGuide: '#heredoc-argument-closing-parentheses'
+  Enabled: false
   VersionAdded: '0.68'
 
 Layout/HeredocIndentation:
@@ -1037,6 +1042,15 @@ Layout/IndentationWidth:
   VersionAdded: '0.49'
   # Number of spaces for each indentation level.
   Width: 2
+  # Block body indentation for method chain blocks.
+  # The value `start_of_line` means that block bodies are indented
+  # relative to the start of the line where the block starts.
+  # The value `relative_to_receiver` means that block bodies are indented
+  # relative to the method call position in the chain.
+  EnforcedStyleAlignWith: start_of_line
+  SupportedStylesAlignWith:
+    - start_of_line
+    - relative_to_receiver
   AllowedPatterns: []
 
 Layout/InitialIndentation:
@@ -1102,7 +1116,7 @@ Layout/LineLength:
   StyleGuide: '#max-line-length'
   Enabled: true
   VersionAdded: '0.25'
-  VersionChanged: '1.69'
+  VersionChanged: '1.82'
   Max: 120
   AllowHeredoc: true
   # To make it possible to copy or click on URIs in the code, we allow lines
@@ -1112,9 +1126,12 @@ Layout/LineLength:
   URISchemes:
     - http
     - https
-  # The IgnoreCopDirectives option causes the LineLength rule to ignore cop
+  # The AllowRBSInlineAnnotation option makes LineLength allow RBS::Inline annotations
+  # such as `#: (?date: Date) -> Foo` when calculating line length.
+  AllowRBSInlineAnnotation: false
+  # The AllowCopDirectives option causes the LineLength rule to ignore cop
   # directives like '# rubocop: enable ...' when calculating a line's length.
-  IgnoreCopDirectives: true
+  AllowCopDirectives: true
   # The AllowedPatterns option is a list of !ruby/regexp and/or string
   # elements. Strings will be converted to Regexp objects. A line that matches
   # any regular expression listed in this option will be ignored by LineLength.
@@ -1409,6 +1426,7 @@ Layout/SpaceBeforeBlockBraces:
                  before it.
   Enabled: true
   VersionAdded: '0.49'
+  VersionChanged: '0.52'
   EnforcedStyle: space
   SupportedStyles:
     - space
@@ -1417,7 +1435,6 @@ Layout/SpaceBeforeBlockBraces:
   SupportedStylesForEmptyBraces:
     - space
     - no_space
-  VersionChanged: '0.52'
 
 Layout/SpaceBeforeBrackets:
   Description: 'Checks for receiver with a space before the opening brackets.'
@@ -1692,6 +1709,7 @@ Lint/ConstantReassignment:
   Description: 'Checks for constant reassignments.'
   Enabled: pending
   VersionAdded: '1.70'
+  VersionChanged: '1.87'
 
 Lint/ConstantResolution:
   Description: 'Checks that constants are fully qualified with `::`.'
@@ -1707,6 +1725,11 @@ Lint/CopDirectiveSyntax:
   Enabled: pending
   VersionAdded: '1.72'
 
+Lint/DataDefineOverride:
+  Description: 'Disallow overriding the `Data` built-in methods via `Data.define`.'
+  Enabled: pending
+  VersionAdded: '1.85'
+
 Lint/Debugger:
   Description: 'Checks for debugger calls.'
   Enabled: true
@@ -1904,9 +1927,9 @@ Lint/EmptyConditionalBody:
   Description: 'Checks for the presence of `if`, `elsif` and `unless` branches without a body.'
   Enabled: true
   AutoCorrect: contextual
-  AllowComments: true
   VersionAdded: '0.89'
   VersionChanged: '1.73'
+  AllowComments: true
 
 Lint/EmptyEnsure:
   Description: 'Checks for empty ensure block.'
@@ -1942,9 +1965,9 @@ Lint/EmptyInterpolation:
 Lint/EmptyWhen:
   Description: 'Checks for `when` branches with empty bodies.'
   Enabled: true
-  AllowComments: true
   VersionAdded: '0.45'
   VersionChanged: '0.83'
+  AllowComments: true
 
 Lint/EnsureReturn:
   Description: 'Do not use return in an ensure block.'
@@ -1978,7 +2001,7 @@ Lint/FloatOutOfRange:
   VersionAdded: '0.36'
 
 Lint/FormatParameterMismatch:
-  Description: 'The number of parameters to format/sprint must match the fields.'
+  Description: 'Checks for a mismatch between the format fields and the arguments to `format`/`sprintf`/`%`.'
   Enabled: true
   VersionAdded: '0.33'
 
@@ -1998,14 +2021,14 @@ Lint/HeredocMethodCallPosition:
   Description: >-
                  Checks for the ordering of a method call where
                  the receiver of the call is a HEREDOC.
-  Enabled: false
   StyleGuide: '#heredoc-method-calls'
+  Enabled: false
   VersionAdded: '0.68'
 
 Lint/IdentityComparison:
   Description: 'Prefer `equal?` over `==` when comparing `object_id`.'
-  Enabled: true
   StyleGuide: '#identity-comparison'
+  Enabled: true
   VersionAdded: '0.91'
 
 Lint/ImplicitStringConcatenation:
@@ -2091,6 +2114,7 @@ Lint/MissingCopEnableDirective:
   Description: 'Checks for a `# rubocop:enable` after `# rubocop:disable`.'
   Enabled: true
   VersionAdded: '0.52'
+  VersionChanged: '1.88'
   # Maximum number of consecutive lines the cop can be disabled for.
   # 0 allows only single-line disables
   # 1 would mean the maximum allowed is the following:
@@ -2098,16 +2122,16 @@ Lint/MissingCopEnableDirective:
   #   a = 1
   #   # rubocop:enable SomeCop
   # .inf for any size
-  MaximumRangeSize: .inf
+  MaxRangeSize: .inf
 
 Lint/MissingSuper:
   Description: >-
                   Checks for the presence of constructors and lifecycle callbacks
                   without calls to `super`.
   Enabled: true
-  AllowedParentClasses: []
   VersionAdded: '0.89'
   VersionChanged: '1.4'
+  AllowedParentClasses: []
 
 Lint/MixedCaseRange:
   Description: 'Checks for mixed-case character ranges since they include likely unintended characters.'
@@ -2173,11 +2197,11 @@ Lint/NumberConversion:
   Description: 'Checks unsafe usage of number conversion methods.'
   Enabled: false
   VersionAdded: '0.53'
-  VersionChanged: '1.1'
+  VersionChanged: '1.88'
   SafeAutoCorrect: false
   AllowedMethods: []
   AllowedPatterns: []
-  IgnoredClasses:
+  AllowedClasses:
     - Time
     - DateTime
 
@@ -2327,13 +2351,16 @@ Lint/RedundantWithIndex:
 Lint/RedundantWithObject:
   Description: 'Checks for redundant `with_object`.'
   Enabled: true
+  SafeAutoCorrect: false
   VersionAdded: '0.51'
+  VersionChanged: '1.88'
 
 Lint/RefinementImportMethods:
   Description: 'Use `Refinement#import_methods` when using `include` or `prepend` in `refine` block.'
   Enabled: pending
   SafeAutoCorrect: false
   VersionAdded: '1.27'
+  VersionChanged: '1.88'
 
 Lint/RegexpAsCondition:
   Description: >-
@@ -2396,8 +2423,9 @@ Lint/SafeNavigationConsistency:
                  consistent and appropriate safe navigation, without excess or deficiency,
                  is used for all method calls on the same object.
   Enabled: true
+  SafeAutoCorrect: false
   VersionAdded: '0.55'
-  VersionChanged: '0.77'
+  VersionChanged: '1.85'
   AllowedMethods:
     - present?
     - blank?
@@ -2464,10 +2492,10 @@ Lint/SuppressedException:
   Description: "Don't suppress exceptions."
   StyleGuide: '#dont-hide-exceptions'
   Enabled: true
-  AllowComments: true
-  AllowNil: true
   VersionAdded: '0.9'
   VersionChanged: '1.12'
+  AllowComments: true
+  AllowNil: true
 
 Lint/SuppressedExceptionInNumberConversion:
   Description: 'Checks for cases where exceptions unrelated to the numeric constructors may be unintentionally swallowed.'
@@ -2560,7 +2588,7 @@ Lint/UnmodifiedReduceAccumulator:
   VersionChanged: '1.5'
 
 Lint/UnreachableCode:
-  Description: 'Unreachable code.'
+  Description: 'Checks for unreachable code.'
   Enabled: true
   VersionAdded: '0.9'
 
@@ -2574,6 +2602,11 @@ Lint/UnreachableLoop:
     # eg. `exactly(2).times`
     - !ruby/regexp /(exactly|at_least|at_most)\(\d+\)\.times/
 
+Lint/UnreachablePatternBranch:
+  Description: 'Checks for unreachable `in` pattern branches after an unconditional catch-all pattern.'
+  Enabled: pending
+  VersionAdded: '1.85'
+
 Lint/UnusedBlockArgument:
   Description: 'Checks for unused block arguments.'
   StyleGuide: '#underscore-unused-vars'
@@ -2669,7 +2702,10 @@ Lint/UselessNumericOperation:
 Lint/UselessOr:
   Description: 'Checks for useless OR expressions.'
   Enabled: pending
+  SafeAutoCorrect: false
+  AutoCorrect: contextual
   VersionAdded: '1.76'
+  VersionChanged: '1.82'
 
 Lint/UselessRescue:
   Description: 'Checks for useless `rescue`s.'
@@ -2697,7 +2733,7 @@ Lint/UselessTimes:
   VersionChanged: '1.61'
 
 Lint/Void:
-  Description: 'Possible use of operator/literal/variable in void context.'
+  Description: 'Checks for operators, literals, lambdas, and procs used in void context.'
   Enabled: true
   AutoCorrect: contextual
   VersionAdded: '0.9'
@@ -2707,9 +2743,7 @@ Lint/Void:
 #################### Metrics ###############################
 
 Metrics/AbcSize:
-  Description: >-
-                 A calculated magnitude based on number of assignments,
-                 branches, and conditions.
+  Description: 'Checks that the ABC size of methods is not higher than the configured maximum.'
   References:
     - https://wiki.c2.com/?AbcMetric
     - https://en.wikipedia.org/wiki/ABC_Software_Metric
@@ -2762,13 +2796,12 @@ Metrics/CollectionLiteralLength:
   Description: 'Checks for `Array` or `Hash` literals with many entries.'
   Enabled: pending
   VersionAdded: '1.47'
-  LengthThreshold: 250
+  VersionChanged: '1.88'
+  Max: 250
 
 # Avoid complex methods.
 Metrics/CyclomaticComplexity:
-  Description: >-
-                 A complexity metric that is strongly correlated to the number
-                 of test cases needed to validate a method.
+  Description: 'Checks that the cyclomatic complexity of methods is not higher than the configured maximum.'
   Enabled: true
   VersionAdded: '0.25'
   VersionChanged: '0.81'
@@ -2808,9 +2841,7 @@ Metrics/ParameterLists:
   MaxOptionalParameters: 3
 
 Metrics/PerceivedComplexity:
-  Description: >-
-                 A complexity metric geared towards measuring complexity for a
-                 human reader.
+  Description: 'Checks that the perceived complexity of methods is not higher than the configured maximum.'
   Enabled: true
   VersionAdded: '0.25'
   VersionChanged: '0.81'
@@ -2818,16 +2849,14 @@ Metrics/PerceivedComplexity:
   AllowedPatterns: []
   Max: 8
 
-################## Migration #############################
+#################### Migration #############################
 
 Migration/DepartmentName:
-  Description: >-
-                 Check that cop names in rubocop:disable (etc) comments are
-                 given with department name.
+  Description: 'Checks that cop names in `rubocop:disable` (etc.) comments are given with a department name.'
   Enabled: true
   VersionAdded: '0.75'
 
-#################### Naming ##############################
+#################### Naming ################################
 
 Naming/AccessorMethodName:
   Description: Checks the naming of accessor methods for get_/set_.
@@ -2844,7 +2873,7 @@ Naming/AsciiIdentifiers:
   AsciiConstants: true
 
 Naming/BinaryOperatorParameterName:
-  Description: 'When defining binary operators, name the argument other.'
+  Description: 'Checks that the sole parameter of binary operator methods is named `other`.'
   StyleGuide: '#other-arg'
   Enabled: true
   VersionAdded: '0.50'
@@ -3014,7 +3043,10 @@ Naming/InclusiveLanguage:
         - block
     slave:
       WholeWord: true
-      Suggestions: ['replica', 'secondary', 'follower']
+      Suggestions:
+        - replica
+        - secondary
+        - follower
 
 Naming/MemoizedInstanceVariableName:
   Description: >-
@@ -3097,10 +3129,11 @@ Naming/PredicateMethod:
   AllowBangMethods: false
   # Methods that are known to not return a boolean value, despite ending in `?`.
   WaywardPredicates:
+    - infinite?
     - nonzero?
 
 Naming/PredicatePrefix:
-  Description: 'Predicate method names should not be prefixed and end with a `?`.'
+  Description: 'Checks that predicate method names end with a question mark and do not start with a forbidden prefix.'
   StyleGuide: '#bool-methods-qmark'
   Enabled: true
   VersionAdded: '0.50'
@@ -3182,14 +3215,14 @@ Naming/VariableNumber:
 #################### Security ##############################
 
 Security/CompoundHash:
-  Description: 'When overwriting Object#hash to combine values, prefer delegating to Array#hash over writing a custom implementation.'
+  Description: 'Checks for `hash` implementations that combine values manually instead of delegating to `Array#hash`.'
   Enabled: pending
   Safe: false
   VersionAdded: '1.28'
   VersionChanged: '1.51'
 
 Security/Eval:
-  Description: 'The use of eval represents a serious security risk.'
+  Description: 'Checks for the use of `Kernel#eval` and `Binding#eval` with dynamic arguments.'
   Enabled: true
   VersionAdded: '0.47'
 
@@ -3207,6 +3240,7 @@ Security/JSONLoad:
                  security issues. See reference for more information.
   References:
     - 'https://ruby-doc.org/stdlib-2.7.0/libdoc/json/rdoc/JSON.html#method-i-load'
+    - 'https://bugs.ruby-lang.org/issues/19528'
   Enabled: true
   VersionAdded: '0.43'
   VersionChanged: '1.22'
@@ -3224,7 +3258,7 @@ Security/MarshalLoad:
   VersionAdded: '0.47'
 
 Security/Open:
-  Description: 'The use of `Kernel#open` and `URI.open` represent a serious security risk.'
+  Description: 'Checks for the use of `Kernel#open` and `URI.open` with dynamic data.'
   Enabled: true
   VersionAdded: '0.53'
   VersionChanged: '1.0'
@@ -3240,7 +3274,7 @@ Security/YAMLLoad:
   VersionAdded: '0.47'
   SafeAutoCorrect: false
 
-#################### Style ###############################
+#################### Style #################################
 
 Style/AccessModifierDeclarations:
   Description: 'Checks style of how access modifiers are used.'
@@ -3280,7 +3314,7 @@ Style/Alias:
 
 Style/AmbiguousEndlessMethodDefinition:
   Description: 'Checks for endless methods inside operators of lower precedence.'
-  StyleGuide: '#ambiguous-endless-method-defintions'
+  StyleGuide: '#ambiguous-endless-method-definitions'
   Enabled: pending
   VersionAdded: '1.68'
 
@@ -3302,6 +3336,8 @@ Style/ArgumentsForwarding:
   Description: 'Use arguments forwarding.'
   StyleGuide: '#arguments-forwarding'
   Enabled: pending
+  VersionAdded: '1.1'
+  VersionChanged: '1.58'
   AllowOnlyRestArgument: true
   UseAnonymousForwarding: true
   RedundantRestArgumentNames:
@@ -3315,8 +3351,6 @@ Style/ArgumentsForwarding:
     - blk
     - block
     - proc
-  VersionAdded: '1.1'
-  VersionChanged: '1.58'
 
 Style/ArrayCoercion:
   Description: >-
@@ -3341,6 +3375,12 @@ Style/ArrayIntersect:
   Safe: false
   VersionAdded: '1.40'
 
+Style/ArrayIntersectWithSingleElement:
+  Description: 'Use `include?(element)` instead of `intersect?([element])`.'
+  Enabled: 'pending'
+  Safe: false
+  VersionAdded: '1.81'
+
 Style/ArrayJoin:
   Description: 'Use Array#join instead of Array#*.'
   StyleGuide: '#array-join'
@@ -3518,9 +3558,11 @@ Style/BlockDelimiters:
   BracesRequiredMethods: []
 
 Style/CaseEquality:
-  Description: 'Avoid explicit use of the case equality operator(===).'
+  Description: 'Avoid explicit use of the case equality operator (`===`).'
   StyleGuide: '#no-case-equality'
   Enabled: true
+  References:
+    - 'https://docs.rubocop.org/rubocop-performance/cops_performance.html#performanceregexpmatch'
   VersionAdded: '0.9'
   VersionChanged: '0.89'
   # If `AllowOnConstant` option is enabled, the cop will ignore violations when the receiver of
@@ -3659,7 +3701,7 @@ Style/CollectionCompact:
 
 # Align with the style guide.
 Style/CollectionMethods:
-  Description: 'Preferred collection methods.'
+  Description: 'Enforces the use of consistent method names from the `Enumerable` module.'
   StyleGuide: '#map-find-select-reduce-include-size'
   Enabled: false
   VersionAdded: '0.9'
@@ -3761,11 +3803,11 @@ Style/CommentedKeyword:
 
 Style/ComparableBetween:
   Description: 'Enforces the use of `Comparable#between?` instead of logical comparison.'
+  StyleGuide: '#ranges-or-between'
   Enabled: pending
   Safe: false
   VersionAdded: '1.74'
   VersionChanged: '1.75'
-  StyleGuide: '#ranges-or-between'
 
 Style/ComparableClamp:
   Description: 'Enforces the use of `Comparable#clamp` instead of comparison by minimum and maximum.'
@@ -3952,6 +3994,18 @@ Style/EmptyCaseCondition:
   Enabled: true
   VersionAdded: '0.40'
 
+Style/EmptyClassDefinition:
+  Description: 'Enforces consistent style for empty class definitions.'
+  Enabled: pending
+  VersionAdded: '1.84'
+  VersionChanged: '1.86'
+  EnforcedStyle: class_keyword
+  SupportedStyles:
+    - class_keyword
+    - class_new
+    - class_definition # Deprecated.
+  AllowedParentClasses: []
+
 Style/EmptyElse:
   Description: 'Avoid empty else-clauses.'
   Enabled: true
@@ -4074,7 +4128,7 @@ Style/ExplicitBlockArgument:
   VersionChanged: '1.8'
 
 Style/ExponentialNotation:
-  Description: 'When using exponential notation, favor a mantissa between 1 (inclusive) and 10 (exclusive).'
+  Description: 'Enforces consistency in the use of exponential (scientific) notation.'
   StyleGuide: '#exponential-notation'
   Enabled: true
   VersionAdded: '0.82'
@@ -4091,8 +4145,9 @@ Style/FetchEnvVar:
     - https://rubystyle.guide/#hash-fetch-defaults
   Enabled: pending
   VersionAdded: '1.28'
+  VersionChanged: '1.88'
   # Environment variables to be excluded from the inspection.
-  AllowedVars: []
+  AllowedVariables: []
   # When `true`, autocorrects `ENV["key"]` to `ENV.fetch("key", nil)`.
   # When `false`, autocorrects `ENV["key"]` to `ENV.fetch("key")`.
   DefaultToNil: true
@@ -4110,6 +4165,12 @@ Style/FileNull:
   SafeAutoCorrect: false
   VersionAdded: '1.69'
 
+Style/FileOpen:
+  Description: 'Checks for `File.open` without a block, which can leak file descriptors.'
+  Enabled: pending
+  Safe: false
+  VersionAdded: '1.85'
+
 Style/FileRead:
   Description: 'Favor `File.(bin)read` convenience methods.'
   StyleGuide: '#file-read'
@@ -4171,6 +4232,8 @@ Style/FormatString:
 Style/FormatStringToken:
   Description: 'Use a consistent style for format string tokens.'
   Enabled: true
+  VersionAdded: '0.49'
+  VersionChanged: '1.74'
   EnforcedStyle: annotated
   SupportedStyles:
     # Prefer tokens which contain a sprintf like type annotation like
@@ -4189,8 +4252,6 @@ Style/FormatStringToken:
   #     only register offenses for strings given to `printf`, `sprintf`,
   #     format` and `%` methods. Other strings are not considered.
   Mode: aggressive
-  VersionAdded: '0.49'
-  VersionChanged: '1.74'
   AllowedMethods: []
   AllowedPatterns: []
 
@@ -4303,6 +4364,16 @@ Style/HashLikeCase:
   # to trigger this cop
   MinBranchesCount: 3
 
+Style/HashLookupMethod:
+  Description: 'Enforces the use of either `Hash#[]` or `Hash#fetch` for hash lookup.'
+  Enabled: false
+  Safe: false
+  VersionAdded: '1.84'
+  EnforcedStyle: brackets
+  SupportedStyles:
+    - brackets
+    - fetch
+
 Style/HashSlice:
   Description: >-
                  Checks for usages of `Hash#reject`, `Hash#select`, and `Hash#filter` methods
@@ -4374,9 +4445,9 @@ Style/IdenticalConditionalBranches:
 Style/IfInsideElse:
   Description: 'Finds if nodes inside else, which can be converted to elsif.'
   Enabled: true
-  AllowIfModifier: false
   VersionAdded: '0.36'
   VersionChanged: '1.3'
+  AllowIfModifier: false
 
 Style/IfUnlessModifier:
   Description: >-
@@ -4400,6 +4471,7 @@ Style/IfWithBooleanLiteralBranches:
   VersionAdded: '1.9'
   SafeAutoCorrect: false
   AllowedMethods:
+    - infinite?
     - nonzero?
 
 Style/IfWithSemicolon:
@@ -4506,14 +4578,14 @@ Style/ItAssignment:
 Style/ItBlockParameter:
   Description: 'Checks for blocks with one argument where `it` block parameter can be used.'
   Enabled: pending
+  VersionAdded: '1.75'
+  VersionChanged: '1.76'
   EnforcedStyle: allow_single_line
   SupportedStyles:
     - allow_single_line
     - only_numbered_parameters
     - always
     - disallow
-  VersionAdded: '1.75'
-  VersionChanged: '1.76'
 
 Style/KeywordArgumentsMerging:
   Description: >-
@@ -4546,8 +4618,9 @@ Style/LambdaCall:
   Description: 'Use lambda.call(...) instead of lambda.(...).'
   StyleGuide: '#proc-call'
   Enabled: true
+  AutoCorrect: contextual
   VersionAdded: '0.13'
-  VersionChanged: '0.14'
+  VersionChanged: '1.81'
   EnforcedStyle: call
   SupportedStyles:
     - call
@@ -4595,6 +4668,12 @@ Style/MapIntoArray:
   VersionChanged: '1.67'
   Safe: false
 
+Style/MapJoin:
+  Description: 'Checks for redundant `map(&:to_s)` before `join`.'
+  Enabled: pending
+  Safe: false
+  VersionAdded: '1.85'
+
 Style/MapToHash:
   Description: 'Prefer `to_h` with a block over `map.to_h`.'
   Enabled: pending
@@ -4617,6 +4696,7 @@ Style/MethodCallWithArgsParentheses:
   AllowedMethods: []
   AllowedPatterns: []
   IncludedMacros: []
+  IncludedMacroPatterns: []
   AllowParenthesesInMultilineCall: false
   AllowParenthesesInChaining: false
   AllowParenthesesInCamelCaseMethod: false
@@ -4630,10 +4710,10 @@ Style/MethodCallWithoutArgsParentheses:
   Description: 'Do not use parentheses for method calls with no arguments.'
   StyleGuide: '#method-invocation-parens'
   Enabled: true
-  AllowedMethods: []
-  AllowedPatterns: []
   VersionAdded: '0.47'
   VersionChanged: '0.55'
+  AllowedMethods: []
+  AllowedPatterns: []
 
 Style/MethodCalledOnDoEndBlock:
   Description: 'Avoid chaining a method call on a do...end block.'
@@ -4727,6 +4807,11 @@ Style/ModuleFunction:
   Autocorrect: false
   SafeAutoCorrect: false
 
+Style/ModuleMemberExistenceCheck:
+  Description: 'Checks for usage of `Module` methods returning arrays that can be replaced with equivalent predicates.'
+  Enabled: pending
+  VersionAdded: '1.82'
+
 Style/MultilineBlockChain:
   Description: 'Avoid multi-line chains of blocks.'
   StyleGuide: '#single-line-blocks'
@@ -4734,7 +4819,7 @@ Style/MultilineBlockChain:
   VersionAdded: '0.13'
 
 Style/MultilineIfModifier:
-  Description: 'Only use if/unless modifiers on single line statements.'
+  Description: 'Checks for uses of `if`/`unless` modifiers with multiline bodies.'
   StyleGuide: '#no-multiline-if-modifiers'
   Enabled: true
   VersionAdded: '0.45'
@@ -4797,7 +4882,7 @@ Style/MutableConstant:
   Description: 'Do not assign mutable objects to constants.'
   Enabled: true
   VersionAdded: '0.34'
-  VersionChanged: '1.8'
+  VersionChanged: '1.88'
   SafeAutoCorrect: false
   EnforcedStyle: literals
   SupportedStyles:
@@ -4809,6 +4894,9 @@ Style/MutableConstant:
     # no harm in freezing an already frozen object.
     - literals
     - strict
+  # When `true`, recursively check and freeze mutable literals nested inside
+  # arrays and hashes (e.g. `[{a: []}]` becomes `[{a: [].freeze}.freeze].freeze`).
+  Recursive: false
 
 Style/NegatedIf:
   Description: >-
@@ -4854,6 +4942,14 @@ Style/NegatedWhile:
   Enabled: true
   VersionAdded: '0.20'
 
+Style/NegativeArrayIndex:
+  Description: >-
+    Use negative array indices instead of calculating array length minus a value.
+    Also handles range patterns with length calculations. Recognizes preserving methods
+    and their combinations, allowing safe replacement when the receiver matches.
+  Enabled: pending
+  VersionAdded: '1.84'
+
 Style/NestedFileDirname:
   Description: 'Checks for nested `File.dirname`.'
   Enabled: pending
@@ -5029,15 +5125,25 @@ Style/ObjectThen:
     - then
     - yield_self
 
+Style/OneClassPerFile:
+  Description: 'Checks that each source file defines at most one top-level class or module.'
+  Enabled: pending
+  VersionAdded: '1.85'
+  VersionChanged: '1.86'
+  AllowedClasses: []
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+
 Style/OneLineConditional:
   Description: >-
                  Favor the ternary operator (?:) or multi-line constructs over
                  single-line if/then/else/end constructs.
   StyleGuide: '#ternary-operator'
   Enabled: true
-  AlwaysCorrectToMultiline: false
   VersionAdded: '0.9'
   VersionChanged: '0.90'
+  AlwaysCorrectToMultiline: false
 
 Style/OpenStructUse:
   Description: >-
@@ -5117,11 +5223,20 @@ Style/ParenthesesAroundCondition:
   AllowSafeAssignment: true
   AllowInMultilineConditions: false
 
+Style/PartitionInsteadOfDoubleSelect:
+  Description: >-
+                Checks for consecutive `select`/`filter`/`find_all` and `reject` calls
+                on the same receiver with the same block body.
+  Enabled: pending
+  Safe: false
+  VersionAdded: '1.85'
+
 Style/PercentLiteralDelimiters:
   Description: 'Use `%`-literal delimiters consistently.'
   StyleGuide: '#percent-literal-braces'
   Enabled: true
   VersionAdded: '0.19'
+  VersionChanged: '0.48'
   # Specify the default preferred delimiter for all types with the 'default' key
   # Override individual delimiters (even with default specified) by specifying
   # an individual key
@@ -5132,7 +5247,6 @@ Style/PercentLiteralDelimiters:
     '%r': '{}'
     '%w': '[]'
     '%W': '[]'
-  VersionChanged: '0.48'
 
 Style/PercentQLiterals:
   Description: 'Checks if uses of %Q/%q match the configured preference.'
@@ -5149,6 +5263,12 @@ Style/PerlBackrefs:
   Enabled: true
   VersionAdded: '0.13'
 
+Style/PredicateWithKind:
+  Description: 'Prefer `any?(Klass)` to `any? { |x| x.is_a?(Klass) }`.'
+  Enabled: pending
+  SafeAutoCorrect: false
+  VersionAdded: '1.85'
+
 Style/PreferredHashMethods:
   Description: 'Checks use of `has_key?` and `has_value?` Hash methods.'
   StyleGuide: '#hash-key'
@@ -5199,6 +5319,12 @@ Style/RandomWithOffset:
   Enabled: true
   VersionAdded: '0.52'
 
+Style/ReduceToHash:
+  Description: 'Use `to_h { ... }` instead of `each_with_object`, `inject`, or `reduce` to build a hash.'
+  Enabled: pending
+  Safe: false
+  VersionAdded: '1.85'
+
 Style/RedundantArgument:
   Description: 'Checks for a redundant argument passed to certain methods.'
   Enabled: pending
@@ -5214,6 +5340,8 @@ Style/RedundantArgument:
     exit: true
     # Kernel.#exit!
     exit!: false
+    # String#to_i
+    to_i: 10
     # String#split
     split: ' '
     # String#chomp
@@ -5255,6 +5383,7 @@ Style/RedundantCondition:
   VersionAdded: '0.76'
   VersionChanged: '1.73'
   AllowedMethods:
+    - infinite?
     - nonzero?
 
 Style/RedundantConditional:
@@ -5344,9 +5473,9 @@ Style/RedundantInitialize:
   Enabled: pending
   AutoCorrect: contextual
   Safe: false
-  AllowComments: true
   VersionAdded: '1.27'
   VersionChanged: '1.61'
+  AllowComments: true
 
 Style/RedundantInterpolation:
   Description: 'Checks for strings that are just an interpolated expression.'
@@ -5365,6 +5494,11 @@ Style/RedundantLineContinuation:
   Enabled: pending
   VersionAdded: '1.49'
 
+Style/RedundantMinMaxBy:
+  Description: 'Identifies places where `max_by`/`min_by` can be replaced by `max`/`min`.'
+  Enabled: pending
+  VersionAdded: '1.85'
+
 Style/RedundantParentheses:
   Description: "Checks for parentheses that seem not to serve any purpose."
   Enabled: true
@@ -5442,6 +5576,13 @@ Style/RedundantStringEscape:
   Enabled: pending
   VersionAdded: '1.37'
 
+Style/RedundantStructKeywordInit:
+  Description: 'Checks for redundant `keyword_init` option for `Struct.new`.'
+  Enabled: false
+  SafeAutoCorrect: false
+  VersionAdded: '1.85'
+  VersionChanged: '1.86'
+
 Style/RegexpLiteral:
   Description: 'Use / or %r around regular expressions.'
   StyleGuide: '#percent-r'
@@ -5498,10 +5639,16 @@ Style/ReturnNilInPredicateMethodDefinition:
   StyleGuide: '#bool-methods-qmark'
   Enabled: pending
   SafeAutoCorrect: false
-  AllowedMethods: []
-  AllowedPatterns: []
   VersionAdded: '1.53'
   VersionChanged: '1.67'
+  AllowedMethods: []
+  AllowedPatterns: []
+
+Style/ReverseFind:
+  Description: 'Use `array.rfind` instead of `array.reverse.find`.'
+  Enabled: pending
+  Safe: false
+  VersionAdded: '1.84'
 
 Style/SafeNavigation:
   Description: >-
@@ -5542,8 +5689,20 @@ Style/Sample:
   Enabled: true
   VersionAdded: '0.30'
 
+Style/SelectByKind:
+  Description: 'Prefer grep/grep_v to select/reject/find/detect with a kind check.'
+  Enabled: pending
+  SafeAutoCorrect: false
+  VersionAdded: '1.85'
+
+Style/SelectByRange:
+  Description: 'Prefer grep/grep_v to select/reject/find/detect with a range check.'
+  Enabled: pending
+  SafeAutoCorrect: false
+  VersionAdded: '1.85'
+
 Style/SelectByRegexp:
-  Description: 'Prefer grep/grep_v to select/reject with a regexp match.'
+  Description: 'Prefer grep/grep_v to select/reject/find/detect with a regexp match.'
   Enabled: pending
   SafeAutoCorrect: false
   VersionAdded: '1.22'
@@ -5802,6 +5961,12 @@ Style/SymbolProc:
   AllowedPatterns: []
   AllowComments: false
 
+Style/TallyMethod:
+  Description: 'Prefer `Enumerable#tally` over manual counting patterns.'
+  Enabled: pending
+  Safe: false
+  VersionAdded: '1.85'
+
 Style/TernaryParentheses:
   Description: 'Checks for use of parentheses around ternary conditions.'
   Enabled: true
@@ -5826,12 +5991,12 @@ Style/TrailingBodyOnClass:
   VersionAdded: '0.53'
 
 Style/TrailingBodyOnMethodDefinition:
-  Description: 'Method body goes below definition.'
+  Description: 'Checks for trailing code after the method definition.'
   Enabled: true
   VersionAdded: '0.52'
 
 Style/TrailingBodyOnModule:
-  Description: 'Module body goes below module statement.'
+  Description: 'Checks for trailing code after the module definition.'
   Enabled: true
   VersionAdded: '0.53'
 
@@ -5844,10 +6009,14 @@ Style/TrailingCommaInArguments:
   # parenthesized method calls where each argument is on its own line.
   # If `consistent_comma`, the cop requires a comma after the last argument,
   # for all parenthesized method calls with arguments.
+  # If `diff_comma`, the cop requires a comma after the last argument, but only
+  # when that argument is followed by an immediate newline, even if
+  # there is an inline comment.
   EnforcedStyleForMultiline: no_comma
   SupportedStylesForMultiline:
     - comma
     - consistent_comma
+    - diff_comma
     - no_comma
 
 Style/TrailingCommaInArrayLiteral:
@@ -5900,10 +6069,10 @@ Style/TrailingUnderscoreVariable:
   Description: >-
                  Checks for the usage of unneeded trailing underscores at the
                  end of parallel variable assignment.
-  AllowNamedUnderscoreVariables: true
   Enabled: true
   VersionAdded: '0.31'
   VersionChanged: '0.35'
+  AllowNamedUnderscoreVariables: true
 
 # `TrivialAccessors` requires exact name matches and doesn't allow
 # predicated methods by default.
@@ -6036,6 +6205,9 @@ Style/YodaCondition:
   References:
     - 'https://en.wikipedia.org/wiki/Yoda_conditions'
   Enabled: true
+  Safe: false
+  VersionAdded: '0.49'
+  VersionChanged: '0.75'
   EnforcedStyle: forbid_for_all_comparison_operators
   SupportedStyles:
     # check all comparison operators
@@ -6046,9 +6218,6 @@ Style/YodaCondition:
     - require_for_all_comparison_operators
     # enforce yoda only for equality operators: `!=` and `==`
     - require_for_equality_operators_only
-  Safe: false
-  VersionAdded: '0.49'
-  VersionChanged: '0.75'
 
 Style/YodaExpression:
   Description: 'Forbid the use of yoda expressions.'