rubocop-rbs_inline 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f1bf0f9d17e73042a1c33ae69ffe0cf079bedb1423119b36a524d085cfe6f6a
-  data.tar.gz: '0797210c998bb891bcd07b68f3d4cc9e779cf775ea051e6529c8b052ed58642a'
+  metadata.gz: e4bebfc6eae9ec29990f1dafdf2fc773737b2cf001c450702b138b1d9ab81dec
+  data.tar.gz: f9ebb04f3712f5f02cd6b7388ea74b056fdce19027be61ed6b651cf1b5915ca8
 SHA512:
-  metadata.gz: bb484322f4605db7c86dddf047de1ad1dbe477faf11b7d736edaa544132b87c1b7c0481cd13a6154662a0e318daeaf4880102882288cf02b84ba88eb8d3372f5
-  data.tar.gz: 141d659c28c9c9b2bef362b7f5b57bccf68aaec436b553e19785d97d162a0293c94d0d79ad7d29b7300f0b2583cce353c3152503ec965ab521eeff6fe3bb1127
+  metadata.gz: 46b9e51e95573630afbe686500cdf154a2cdf2d76bd19f441552fe76267682fb586118f96e7b0c5316352b49fc6e5ddc3b080fd1dc8b6711d31e382694ad767d
+  data.tar.gz: 9bd7d22ee40b4d009b1c2f2f86d855a37ee32349c12afffdebbda6cf5edf54bf9c474f67bdfb170987ea512c0934deb48d709f1afbc49acef88f968ebff4297a

data/.claude/hooks/self-review.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+#
+# PreToolUse hook: review code before `git commit`.
+#
+# Fires before a Bash `git commit` command and blocks the first commit attempt
+# for a given change-set, asking Claude to review the code before committing.
+# The review uses the `self-review` skill when available, and falls back to the
+# bundled `code-review` skill otherwise — so the hook works even in projects
+# that don't ship the custom self-review skill.
+#
+# A per-change-set marker (keyed by a hash of the diff, stored under .git/)
+# prevents an infinite block loop: once a change-set has been surfaced for
+# review, the matching commit is allowed through. If the review leads to fixes,
+# the diff changes, so the new state is reviewed once more before it commits.
+#
+
+set -euo pipefail
+
+# Read JSON input from stdin
+input=$(cat)
+
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+command=$(echo "$input" | jq -r '.tool_input.command // empty')
+
+# Only gate the Bash tool running a git commit.
+if [[ "$tool_name" != "Bash" ]]; then
+  exit 0
+fi
+# Match `git commit`, or `git -C <path> commit`.
+commit_re='git[[:space:]]+(-C[[:space:]]+[^[:space:]]+[[:space:]]+)?commit'
+if [[ ! "$command" =~ $commit_re ]]; then
+  exit 0
+fi
+
+# If the command targets a specific repo via `git -C <path>`, operate there too.
+work_dir="."
+if [[ "$command" =~ git[[:space:]]+-C[[:space:]]+([^[:space:]]+) ]]; then
+  work_dir="${BASH_REMATCH[1]}"
+fi
+
+# Not a git repo → nothing to do.
+git_dir=$(git -C "$work_dir" rev-parse --absolute-git-dir 2>/dev/null || true)
+if [[ -z "$git_dir" ]]; then
+  exit 0
+fi
+
+# Hash what will be committed. `git status --porcelain` is included so a commit
+# that only adds untracked files isn't mistaken for empty; `git diff HEAD` adds
+# tracked content. On the first commit there is no HEAD, so use the working state.
+if git -C "$work_dir" rev-parse --verify HEAD >/dev/null 2>&1; then
+  changeset=$(git -C "$work_dir" status --porcelain; git -C "$work_dir" diff HEAD)
+else
+  changeset=$(git -C "$work_dir" status --porcelain; git -C "$work_dir" diff; git -C "$work_dir" diff --cached)
+fi
+
+# Nothing to review (e.g. a message-only `--amend`) → let it proceed.
+if [[ -z "$changeset" ]]; then
+  exit 0
+fi
+
+hash=$(printf '%s' "$changeset" | git hash-object --stdin)
+state_file="$git_dir/self-review-reviewed"
+
+# Already surfaced for review → allow the commit.
+if [[ -f "$state_file" ]] && grep -qxF "$hash" "$state_file"; then
+  exit 0
+fi
+
+# Record this change-set and block once to force a review first.
+echo "$hash" >> "$state_file"
+
+review_prompt='SELF-REVIEW REQUIRED before committing. Review the changes that are
+about to be committed BEFORE running git commit again:
+
+- If the `self-review` skill is available, invoke it (Skill tool, skill "self-review").
+- Otherwise, run the bundled `/code-review` skill on the working diff.
+
+If the review finds issues, fix them and review again. Once it is clean, run the same
+git commit command again to proceed — it will be allowed through.'
+
+jq -n --arg reason "$review_prompt" '{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": $reason
+  }
+}'
+
+exit 0

data/.claude/settings.json

@@ -1,4 +1,7 @@
 {
+  "permissions": {
+    "allow": ["RemoteTrigger"]
+  },
   "hooks": {
     "SessionStart": [
       {
@@ -19,6 +22,11 @@
           {
             "type": "command",
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-commit-check.sh"
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/self-review.sh",
+            "timeout": 10000
           }
         ]
       }

data/.rubocop.yml

@@ -56,16 +56,22 @@ RSpec/NamedSubject:
 RSpec/NestedGroups:
   Max: 5
 
+# Mixin specs mirror `lib/.../rbs_inline/mixin/`, but the modules keep the
+# `RuboCop::Cop::Style::RbsInline` namespace, so the path never matches the constant.
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - "spec/rubocop/cop/style/rbs_inline/mixin/**/*_spec.rb"
+
 # RbsInline
+Style/RbsInline:
+  Mode: opt_out
+
 Style/RbsInline/MissingTypeAnnotation:
   EnforcedStyle: doc_style_and_return_annotation
 
 Style/RbsInline/RedundantTypeAnnotation:
   EnforcedStyle: doc_style_and_return_annotation
 
-Style/RbsInline/RequireRbsInlineComment:
-  EnforcedStyle: never
-
 # Style
 Style/AccessorGrouping:
   Enabled: false

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.8.0 (2026-07-26)
+
+### Enhancements
+
+- **Style/RbsInline**: Added a shared `Mode` setting (`opt_in` / `opt_out`) at the department level to filter which files each cop checks based on the `# rbs_inline: enabled` / `disabled` magic comment.
+- **Style/RbsInline/RequireRbsInlineComment**: Added the `AllowMissingComment` option, which lets projects use rbs-inline on only some of their files while keeping the opt-in filter for the rest.
+
+### Bug Fixes
+
+- **Style/RbsInline/DataClassCommentAlignment**, **Style/RbsInline/StructClassCommentAlignment**: Fixed the expected annotation column being derived from arguments that cannot carry an annotation (a splat, or for `Struct.new` a leading struct name or `keyword_init:`), which reported false positives on already aligned code and made autocorrect over-pad the annotations.
+- **Style/RbsInline/MissingDataClassAnnotation**, **Style/RbsInline/MissingStructClassAnnotation**: Fixed autocorrect padding the inserted annotations to the width of an argument that cannot carry one (a splat, or for `Struct.new` a leading struct name or `keyword_init:`).
+- **Style/RbsInline/UnmatchedAnnotations**: Fixed a crash on method definitions taking a destructuring argument (ex. `def foo((a, b))`). The crash also aborted the inspection of the method definition, causing false positives on its valid annotations.
+- **Style/RbsInline/RequireRbsInlineComment**: Fixed a crash (`IndexError`) on a file whose leading comment block ends without a trailing newline. The offense is now reported and the magic comment is inserted on its own line.
+- **Style/RbsInline/RedundantTypeAnnotation**: Fixed `--auto-gen-config` generating an `EnforcedStyle` that does not resolve the offenses (including the unsupported `return_type_annotation`, which made RuboCop fail to start on the generated `.rubocop_todo.yml`). No style can make redundant annotations offense-free, so the offending files are now excluded instead.
+
+### Deprecations
+
+- **Style/RbsInline/RequireRbsInlineComment**: `EnforcedStyle` is deprecated in favor of the department-level `Mode`. Migrate `always` → `Style/RbsInline: Mode: opt_in`, `never` → `Style/RbsInline: Mode: opt_out`. Will be removed in the next major version.
+
 ## 1.7.0 (2026-07-20)
 
 ### New Features

data/CLAUDE.md

@@ -23,7 +23,7 @@ bundle exec rake rubocop:autocorrect_all   # all autocorrect
 bundle exec rake steep                     # runs steep check
 bundle exec rake rbs:validate              # validates RBS signatures
 
-# Default rake task (runs specs, rubocop, and type check)
+# Default rake task (rubocop, specs, steep, rbs:validate)
 bundle exec rake
 
 # Generate a new cop
@@ -34,32 +34,27 @@ bundle exec rake 'new_cop[Style/RbsInline/CopName]'
 
 ### Cop Structure
 
-All cops live under `RuboCop::Cop::Style::RbsInline` namespace in `lib/rubocop/cop/style/rbs_inline/`. Each cop validates a different aspect of RBS::Inline annotations:
+Cops live in `lib/rubocop/cop/style/rbs_inline/`, one per file; the shared modules they mix in live in `lib/rubocop/cop/style/rbs_inline/mixin/`. Both are under the `RuboCop::Cop::Style::RbsInline` namespace — only the directory separates them, as in `rubocop`'s `cop/mixin/`. `config/default.yml` lists every cop and its options; read it instead of a list kept here.
 
-- **InvalidComment** - Validates `#:` and `# @rbs` comment syntax
-- **InvalidTypes** - Validates RBS type syntax in annotations
-- **KeywordSeparator** - Ensures keywords like `module-self` aren't followed by `:`
-- **ParametersSeparator** - Ensures parameter annotations use `:` separator
-- **RedundantArgumentType** - Detects redundant argument type specs (configurable style)
-- **RedundantReturnType** - Detects redundant return type specs (3 style options)
-- **UnmatchedAnnotations** - Ensures annotation parameters match actual method parameters
+Conventions:
 
-### Shared CommentParser Module
-
-`comment_parser.rb` is a module mixed into cops that need to parse RBS::Inline annotations. It uses `RBS::Inline::AnnotationParser` and Prism to parse comments, and provides helpers for finding leading annotations, inline comments, and return annotations relative to method definitions.
+- Every cop `prepend`s `FileFilter` except `RequireRbsInlineComment`.
+- `Data.define` and `Struct.new` cops come in pairs sharing a base module. Behavior belongs in the module; only the node matcher and `MSG` in the cop.
 
 ### Plugin System
 
-The gem integrates with RuboCop via LintRoller (`lib/rubocop/rbs_inline/plugin.rb`). Default cop configuration is in `config/default.yml`.
+The gem integrates with RuboCop via LintRoller (`lib/rubocop/rbs_inline/plugin.rb`), which points RuboCop at `config/default.yml`.
 
 ### Type Signatures
 
-RBS type signatures for all source files are maintained in `sig/` directory. The project uses Steep for static type checking, configured via `Steepfile`.
+`sig/rubocop/` is generated from `lib/` by the hooks in `.claude/hooks/`. Never write anything there. `sig/gems/` is hand-written stubs for third-party gems and is *not* regenerated — do not delete it when refreshing signatures.
 
 ### Testing Pattern
 
 Tests use RuboCop's RSpec support helpers (`expect_offense` / `expect_no_offenses`). Test files mirror the cop file structure under `spec/rubocop/cop/style/rbs_inline/`.
 
+`:config` specs build a bare `RuboCop::Config`, so `config/default.yml` and RuboCop's department-to-cop defaults are not merged in. A spec that sets a value at the department level proves nothing about how it resolves in a real run.
+
 ## Code Style Notes
 
 - `Layout/LeadingCommentSpace` and `Style/CommentedKeyword` are disabled because RBS::Inline `#:` comments violate these rules by design.

data/README.md

@@ -27,6 +27,23 @@ plugins:
 
 rubocop-rbs_inline provides the following cops to validate [RBS::Inline](https://github.com/soutaro/rbs-inline) annotations:
 
+### Style/RbsInline (shared configuration)
+
+The `Style/RbsInline` department has a shared `Mode` setting that gates whether each `Style/RbsInline/*` cop reports offenses on a given file:
+
+- `Mode: opt_in` — cops only check files that carry `# rbs_inline: enabled`. Files with `# rbs_inline: disabled` or no magic comment are skipped. Matches RBS::Inline's opt-in mode.
+- `Mode: opt_out` — cops check every file except those with `# rbs_inline: disabled`. Matches RBS::Inline's opt-out mode.
+- unset — cops check every file (legacy behavior; the default will change to `opt_in` in the next major release).
+
+Declare it once at the department level in your `.rubocop.yml`:
+
+```yaml
+Style/RbsInline:
+  Mode: opt_in
+```
+
+Unknown `Mode` values (e.g. `Mode: opt-in`) emit a warning and disable filtering for the run.
+
 ### Style/RbsInline/DataClassCommentAlignment
 
 Checks that `#:` inline type annotations in a multiline `Data.define` call are aligned to the same column. The expected column is determined by the longest attribute name (plus its trailing comma). Folded `Data.define` calls (where multiple attributes share a line) are excluded.
@@ -238,7 +255,11 @@ Enforces that method definitions and `attr_*` declarations have RBS inline type
   - `all`: Checks all methods regardless of visibility
   - `public`: Only checks public methods and `attr_*` declarations
 
-Methods annotated with `# @rbs skip` are always excluded.
+Always excluded, regardless of `EnforcedStyle`:
+
+- Methods annotated with `# @rbs skip` or `# @rbs override`.
+- Parameters whose name starts with `_`.
+- The `...` forward-all parameter.
 
 **Examples (EnforcedStyle: doc_style):**
 ```ruby
@@ -466,13 +487,26 @@ end
 
 ### Style/RbsInline/RequireRbsInlineComment
 
-Enforces presence or absence of `# rbs_inline:` magic comment for consistency.
+Enforces the presence or absence of the `# rbs_inline:` magic comment, based on the shared [`Mode`](#stylerbsinline-shared-configuration) setting:
+
+- Under `Mode: opt_in`, files must carry `# rbs_inline: enabled` (or `# rbs_inline: disabled`).
+- Under `Mode: opt_out`, files must not carry `# rbs_inline: enabled`.
+
+**Configuration:**
+
+- `AllowMissingComment` (default: `false`) — under `Mode: opt_in`, set to `true` to skip enforcement of the magic comment on individual files. Useful when only part of the project uses rbs-inline: the shared `Mode: opt_in` filter still applies to every other cop (they only report on files that opt in), but this cop stops requiring the magic comment on files that intentionally do not use rbs-inline.
+
+```yaml
+Style/RbsInline:
+  Mode: opt_in
+
+Style/RbsInline/RequireRbsInlineComment:
+  AllowMissingComment: true
+```
 
-**Configuration:** `EnforcedStyle` (default: `always`)
-- `always`: Requires `# rbs_inline: enabled` or `# rbs_inline: disabled`
-- `never`: Forbids `# rbs_inline: enabled` (allows `# rbs_inline: disabled`)
+The legacy `EnforcedStyle` parameter (`always` / `never`) is deprecated in favor of `Mode`; it will be removed in the next major release.
 
-**Examples (EnforcedStyle: always):**
+**Examples (Mode: opt_in):**
 ```ruby
 # bad
 class Foo
@@ -484,6 +518,18 @@ class Foo
 end
 ```
 
+**Examples (Mode: opt_in, AllowMissingComment: true):**
+```ruby
+# good - the magic comment is not enforced per file
+class Foo
+end
+
+# good
+# rbs_inline: enabled
+class Foo
+end
+```
+
 ### Style/RbsInline/StructClassCommentAlignment
 
 Checks that `#:` inline type annotations in a multiline `Struct.new` call are aligned to the same column. The expected column is determined by the longest attribute name (plus its trailing comma). Folded `Struct.new` calls (where multiple attributes share a line) are excluded.
@@ -613,6 +659,8 @@ Style/RbsInline/MissingTypeAnnotation:
   Visibility: public
 ```
 
+To restrict every cop to files that carry `# rbs_inline: enabled`, see [Style/RbsInline (shared configuration)](#stylerbsinline-shared-configuration).
+
 See [config/default.yml](config/default.yml) for all available configuration options.
 
 ## Development

data/config/default.yml

@@ -5,6 +5,7 @@ Style/RbsInline:
   Exclude:
     - 'spec/**/*'
     - 'test/**/*'
+  Mode: ~
 
 Style/RbsInline/DataClassCommentAlignment:
   Description: "Checks that `#:` inline type annotations in `Data.define` blocks are aligned."
@@ -94,10 +95,8 @@ Style/RbsInline/RequireRbsInlineComment:
   Description: "Checks the presence or absence of `# rbs_inline: enabled` magic comment."
   Enabled: true
   VersionAdded: "1.5.0"
-  EnforcedStyle: always
-  SupportedStyles:
-    - always
-    - never
+  AllowMissingComment: false
+  EnforcedStyle: ~
 
 Style/RbsInline/StructClassCommentAlignment:
   Description: "Checks that `#:` inline type annotations in `Struct.new` blocks are aligned."

data/lib/rubocop/cop/rbs_inline_cops.rb

@@ -1,11 +1,19 @@
 # frozen_string_literal: true
 
-require_relative "style/rbs_inline/ast_utils"
-require_relative "style/rbs_inline/source_code_helper"
-require_relative "style/rbs_inline/comment_parser"
-require_relative "style/rbs_inline/data_struct_helper"
-require_relative "style/rbs_inline/missing_class_annotation"
-require_relative "style/rbs_inline/class_comment_alignment"
+# Mixins first, in dependency order. Cops follow, alphabetically: `rake new_cop` sorts a
+# generated require only against the others in the same directory, so the two blocks have
+# to stay apart for it to land in the right place.
+require_relative "style/rbs_inline/mixin/annotation_keywords"
+require_relative "style/rbs_inline/mixin/ast_utils"
+require_relative "style/rbs_inline/mixin/source_code_helper"
+require_relative "style/rbs_inline/mixin/comment_parser"
+require_relative "style/rbs_inline/mixin/data_struct_helper"
+require_relative "style/rbs_inline/mixin/missing_class_annotation"
+require_relative "style/rbs_inline/mixin/class_comment_alignment"
+require_relative "style/rbs_inline/mixin/data_class_matcher"
+require_relative "style/rbs_inline/mixin/file_filter"
+require_relative "style/rbs_inline/mixin/struct_class_matcher"
+
 require_relative "style/rbs_inline/data_class_comment_alignment"
 require_relative "style/rbs_inline/data_define_with_block"
 require_relative "style/rbs_inline/embedded_rbs_spacing"
@@ -14,6 +22,7 @@ require_relative "style/rbs_inline/invalid_types"
 require_relative "style/rbs_inline/keyword_separator"
 require_relative "style/rbs_inline/method_comment_spacing"
 require_relative "style/rbs_inline/missing_data_class_annotation"
+require_relative "style/rbs_inline/missing_struct_class_annotation"
 require_relative "style/rbs_inline/missing_type_annotation"
 require_relative "style/rbs_inline/parameters_separator"
 require_relative "style/rbs_inline/redundant_annotation_with_skip"
@@ -22,7 +31,6 @@ require_relative "style/rbs_inline/redundant_type_annotation"
 require_relative "style/rbs_inline/require_rbs_inline_comment"
 require_relative "style/rbs_inline/struct_class_comment_alignment"
 require_relative "style/rbs_inline/struct_new_with_block"
-require_relative "style/rbs_inline/missing_struct_class_annotation"
 require_relative "style/rbs_inline/unmatched_annotations"
 require_relative "style/rbs_inline/untyped_instance_variable"
 require_relative "style/rbs_inline/variable_comment_spacing"

data/lib/rubocop/cop/style/rbs_inline/data_class_comment_alignment.rb

@@ -26,7 +26,9 @@ module RuboCop
         #   )
         #
         class DataClassCommentAlignment < Base
+          prepend FileFilter
           include ClassCommentAlignment
+          include DataClassMatcher
           extend AutoCorrector
 
           MSG = "Misaligned inline type annotation for Data attribute."
@@ -37,15 +39,6 @@ module RuboCop
 
             check_comment_alignment(node)
           end
-
-          private
-
-          # @rbs node: RuboCop::AST::SendNode
-          def struct_like_class?(node) #: bool
-            return false unless node.method_name == :define
-
-            (r = node.receiver).is_a?(RuboCop::AST::ConstNode) && r.short_name == :Data
-          end
         end
       end
     end

data/lib/rubocop/cop/style/rbs_inline/data_define_with_block.rb

@@ -28,6 +28,9 @@ module RuboCop
         #   end
         #
         class DataDefineWithBlock < Base
+          prepend FileFilter
+          include DataClassMatcher
+
           MSG = "Do not use `Data.define` with a block. RBS::Inline does not parse block contents, " \
                 "so methods defined in the block will not be recognized. " \
                 "Use a separate class definition instead."
@@ -41,15 +44,6 @@ module RuboCop
 
             add_offense(node)
           end
-
-          private
-
-          # @rbs node: RuboCop::AST::SendNode
-          def struct_like_class?(node) #: bool
-            return false unless node.method_name == :define
-
-            (r = node.receiver).is_a?(RuboCop::AST::ConstNode) && r.short_name == :Data
-          end
         end
       end
     end

data/lib/rubocop/cop/style/rbs_inline/embedded_rbs_spacing.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "source_code_helper"
-require_relative "comment_parser"
+require_relative "mixin/source_code_helper"
+require_relative "mixin/comment_parser"
 
 module RuboCop
   module Cop
@@ -26,6 +26,7 @@ module RuboCop
         #   end
         #
         class EmbeddedRbsSpacing < Base
+          prepend FileFilter
           extend AutoCorrector
           include SourceCodeHelper
           include CommentParser

data/lib/rubocop/cop/style/rbs_inline/invalid_comment.rb

@@ -20,12 +20,12 @@ module RuboCop
         #   # @rbs param: String
         #
         class InvalidComment < Base
+          prepend FileFilter
           extend AutoCorrector
+          include AnnotationKeywords
 
           MSG = "Invalid RBS annotation comment found."
 
-          # refs: https://github.com/soutaro/rbs-inline/blob/main/lib/rbs/inline/annotation_parser/tokenizer.rb
-          RBS_INLINE_KEYWORDS = %w[inherits override use module-self generic skip module class].freeze #: Array[String]
           RBS_INLINE_KEYWORD_PATTERN = RBS_INLINE_KEYWORDS.join("|") #: String
 
           SIGNATURE_PATTERN = '\(.*\)\s*(\??\s*{.*?}\s*)?->\s*.*'

data/lib/rubocop/cop/style/rbs_inline/invalid_types.rb

@@ -21,6 +21,7 @@ module RuboCop
         #   def method(arg); end
         #
         class InvalidTypes < Base
+          prepend FileFilter
           include CommentParser
           include RangeHelp
           include SourceCodeHelper

data/lib/rubocop/cop/style/rbs_inline/keyword_separator.rb

@@ -15,14 +15,14 @@ module RuboCop
         #   # @rbs module-self String
         #
         class KeywordSeparator < Base
+          prepend FileFilter
           extend AutoCorrector
+          include AnnotationKeywords
           include CommentParser
           include RangeHelp
 
           MSG = "Do not use `:` after the keyword."
 
-          # refs: https://github.com/soutaro/rbs-inline/blob/main/lib/rbs/inline/annotation_parser/tokenizer.rb
-          RBS_INLINE_KEYWORDS = %w[inherits override use module-self generic skip module class].freeze #: Array[String]
           # `override` and `skip` are standalone markers that take no arguments.
           # Even before a method definition they may not be followed by `:` alone,
           # because `# @rbs override:` (no type) is not a valid parameter annotation.

data/lib/rubocop/cop/style/rbs_inline/method_comment_spacing.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "source_code_helper"
-require_relative "comment_parser"
+require_relative "mixin/source_code_helper"
+require_relative "mixin/comment_parser"
 
 module RuboCop
   module Cop
@@ -56,6 +56,7 @@ module RuboCop
         #   end
         #
         class MethodCommentSpacing < Base
+          prepend FileFilter
           extend AutoCorrector
           include RangeHelp
           include SourceCodeHelper

data/lib/rubocop/cop/style/rbs_inline/missing_data_class_annotation.rb

@@ -21,7 +21,9 @@ module RuboCop
         #   )
         #
         class MissingDataClassAnnotation < Base
+          prepend FileFilter
           include MissingClassAnnotation
+          include DataClassMatcher
           extend AutoCorrector
 
           MSG = "Missing inline type annotation for Data attribute (e.g., `#: Type`)."
@@ -32,15 +34,6 @@ module RuboCop
 
             check_missing_annotations(node)
           end
-
-          private
-
-          # @rbs node: RuboCop::AST::SendNode
-          def struct_like_class?(node) #: bool
-            return false unless node.method_name == :define
-
-            (r = node.receiver).is_a?(RuboCop::AST::ConstNode) && r.short_name == :Data
-          end
         end
       end
     end

data/lib/rubocop/cop/style/rbs_inline/missing_struct_class_annotation.rb

@@ -22,7 +22,9 @@ module RuboCop
         #   )
         #
         class MissingStructClassAnnotation < Base
+          prepend FileFilter
           include MissingClassAnnotation
+          include StructClassMatcher
           extend AutoCorrector
 
           MSG = "Missing inline type annotation for Struct attribute (e.g., `#: Type`)."
@@ -33,22 +35,6 @@ module RuboCop
 
             check_missing_annotations(node)
           end
-
-          private
-
-          # @rbs node: RuboCop::AST::SendNode
-          def struct_like_class?(node) #: bool
-            return false unless node.method_name == :new
-
-            (r = node.receiver).is_a?(RuboCop::AST::ConstNode) && r.short_name == :Struct
-          end
-
-          # `Struct.new` treats a leading string argument as the struct name, so only
-          # symbol arguments are attributes.
-          # @rbs arg: RuboCop::AST::Node
-          def attr_argument?(arg) #: bool
-            arg.sym_type?
-          end
         end
       end
     end

data/lib/rubocop/cop/style/rbs_inline/missing_type_annotation.rb

@@ -22,7 +22,8 @@ module RuboCop
         # - `all`: Checks all methods regardless of visibility (default)
         # - `public`: Only checks public methods and `attr_*` declarations
         #
-        # Methods annotated with `# @rbs skip` are always excluded from inspection.
+        # Methods annotated with `# @rbs skip` or `# @rbs override`, parameters with a leading
+        # `_`, and the `...` parameter are always excluded.
         #
         # @example EnforcedStyle: doc_style
         #   # bad
@@ -116,6 +117,7 @@ module RuboCop
         #   attr_reader :name #: String
         #
         class MissingTypeAnnotation < Base # rubocop:disable Metrics/ClassLength
+          prepend FileFilter
           include ASTUtils
           include CommentParser
           include ConfigurableEnforcedStyle
@@ -347,21 +349,6 @@ module RuboCop
             add_offense(node, message: ATTRIBUTE_METHOD_MESSAGE)
           end
 
-          # Returns the last line of the method parameter list (the closing ) line, or the def line if no parens).
-          # @rbs node: RuboCop::AST::DefNode
-          def method_parameter_list_end_line(node) #: Integer
-            args_node = args_node_for(node)
-            end_line(args_node, default: node.location.line)
-          end
-
-          # @rbs node: RuboCop::AST::DefNode
-          def args_node_for(node) #: RuboCop::AST::Node
-            case node.type
-            when :defs then node.children[2]
-            else node.children[1]
-            end
-          end
-
           # @rbs node: RuboCop::AST::DefNode
           def method_has_arguments?(node) #: bool
             args_node_for(node).children.any?

data/lib/rubocop/cop/style/rbs_inline/mixin/annotation_keywords.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Style
+      module RbsInline
+        # Provides the list of keywords that may follow `# @rbs` in an annotation comment.
+        #
+        # refs: https://github.com/soutaro/rbs-inline/blob/main/lib/rbs/inline/annotation_parser/tokenizer.rb
+        module AnnotationKeywords
+          RBS_INLINE_KEYWORDS = %w[inherits override use module-self generic skip module class].freeze #: Array[String]
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/style/rbs_inline/{ast_utils.rb → mixin/ast_utils.rb}

@@ -12,6 +12,22 @@ module RuboCop
             location.end&.line || default
           end
 
+          # Returns the arguments node of a method definition.
+          # @rbs node: RuboCop::AST::DefNode
+          def args_node_for(node) #: RuboCop::AST::Node
+            case node.type
+            when :def  then node.children[1]
+            when :defs then node.children[2]
+            else raise
+            end
+          end
+
+          # Returns the last line of the method parameter list (the closing ) line, or the def line if no parens).
+          # @rbs node: RuboCop::AST::DefNode
+          def method_parameter_list_end_line(node) #: Integer
+            end_line(args_node_for(node), default: node.location.line)
+          end
+
           # @rbs node: RuboCop::AST::Node
           def name_location(node) #: untyped
             location = node.location #: untyped