rubocop-rspec-unused-let 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 414fa557bcae2f0ff55ef645b3f2732631290679b6bf8c43a16319b2cbc51646
+  data.tar.gz: f80247431cea5dbaa5cd8e287e40c3993aaf92abe2b0763ebbc3ba20ac14a2fa
+SHA512:
+  metadata.gz: ccd5ca374b3e88c38203482a60ffefa15c2b8a35977ffa24d0ee9a912276cfac888177c3ee6c5b0c2da2b32cb0d89fc119689dd5f3268191d51e9d36da36bc2a
+  data.tar.gz: 605e20480cab1372b718d8796c5a2d736f27221e2e6e589f64c59201c85cda1496e2b560d0924224a34aef8ed0979710097e87505a12fb262f7ad6880ceb310d

data/.claude/hooks/claude-code-web-session-start.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -eu
+
+if [ "${CLAUDE_CODE_REMOTE:-}" = "true" ]; then
+  eval "$(rbenv init - bash)"
+
+  # Set the latest installed Ruby version as the global default
+  rbenv global `rbenv versions --bare | sort -rV | head -1`
+
+  echo 'eval "$(rbenv init - bash)"' >> "$CLAUDE_ENV_FILE"
+  echo 'export RUBYOPT="-rcgi"' >> "$CLAUDE_ENV_FILE"
+  RUBYOPT="-rcgi" bundle install
+  bundle exec rbs collection install --frozen
+fi

data/.claude/hooks/pre-commit-check.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# Hook input is JSON from stdin
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name')
+command=$(echo "$input" | jq -r '.tool_input.command // ""')
+
+# Only run for git commit commands
+if [[ "$tool_name" != "Bash" ]] || [[ ! "$command" =~ git[[:space:]]+(commit|cherry-pick|merge|rebase) ]]; then
+    exit 0
+fi
+
+cd "$CLAUDE_PROJECT_DIR" || exit 1
+
+if [ "${CLAUDE_CODE_REMOTE:-}" = "true" ]; then
+  eval "$(rbenv init - bash)"
+fi
+
+echo "Running pre-commit checks..." >&2
+
+# Generate RBS and run all checks
+if ! bundle exec rbs-inline --opt-out --output=sig/ lib/ >&2; then
+    echo "Error: RBS generation failed" >&2
+    exit 2
+fi
+
+if ! bundle exec rake >&2; then
+    echo "Error: rake checks failed" >&2
+    exit 2
+fi
+
+echo "All checks passed!" >&2
+exit 0

data/.claude/hooks/protect-sig-files.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# .claude/hooks/protect-sig-files.sh
+#
+# Prevents direct editing of auto-generated RBS type definition files.
+# Type definitions in */sig/ directories are managed by PostToolUse hooks.
+
+TOOL_NAME="$CLAUDE_TOOL_NAME"
+FILE_PATH="$CLAUDE_TOOL_PARAM_file_path"
+COMMAND="$CLAUDE_TOOL_PARAM_command"
+
+# Block Write/Edit operations on sig/ files
+if [[ "$TOOL_NAME" == "Write" || "$TOOL_NAME" == "Edit" ]]; then
+    if [[ "$FILE_PATH" == */sig/* ]]; then
+        echo "❌ ERROR: Direct editing of sig/ files is not allowed."
+        echo "📝 Type definitions are auto-generated by PostToolUse hook."
+        echo "💡 Modify inline RBS annotations in .rb files instead."
+        exit 1
+    fi
+fi
+
+# Block manual rbs-inline execution
+if [[ "$TOOL_NAME" == "Bash" ]]; then
+    if [[ "$COMMAND" =~ rbs-inline ]]; then
+        echo "❌ ERROR: Manual rbs-inline execution is not allowed."
+        echo "🔄 Type definitions are auto-generated by hooks."
+        exit 1
+    fi
+fi
+
+exit 0

data/.claude/hooks/rbs-inline.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+
+# Hook input is JSON from stdin
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name')
+
+cd "$CLAUDE_PROJECT_DIR" || exit 1
+
+if [ "${CLAUDE_CODE_REMOTE:-}" = "true" ]; then
+  eval "$(rbenv init - bash)"
+fi
+
+# Handle Edit or Write tools
+if [[ "$tool_name" == "Edit" || "$tool_name" == "Write" ]]; then
+    file_path=$(echo "$input" | jq -r '.tool_input.file_path // ""')
+
+    if [[ ! "$file_path" =~ \.rb$ ]]; then
+        exit 0
+    fi
+
+    if [[ ! "$file_path" =~ /lib/ ]]; then
+        exit 0
+    fi
+
+    echo "Running rbs-inline for $file_path..." >&2
+
+    if ! bundle exec rbs-inline --opt-out --output=sig/ "$file_path" >&2; then
+        echo "Warning: RBS generation failed for $file_path" >&2
+        exit 0
+    fi
+
+    echo "RBS generation completed." >&2
+    exit 0
+fi
+
+# Handle Bash tool for mv command
+if [[ "$tool_name" == "Bash" ]]; then
+    command=$(echo "$input" | jq -r '.tool_input.command // ""')
+
+    # Check if this is a mv command
+    if [[ ! "$command" =~ ^[[:space:]]*(mv|git\ mv)[[:space:]] ]]; then
+        exit 0
+    fi
+
+    # Extract source and destination paths from mv command
+    paths=$(echo "$command" | sed -E 's/^[[:space:]]*(git[[:space:]]+)?mv[[:space:]]+//')
+
+    source_path=$(echo "$paths" | awk '{print $1}')
+    dest_path=$(echo "$paths" | awk '{print $2}')
+
+    # Check if source was a .rb file in lib/
+    if [[ ! "$source_path" =~ \.rb$ ]] || [[ ! "$source_path" =~ lib/ ]]; then
+        exit 0
+    fi
+
+    echo "Detected mv of Ruby file in lib/: $source_path -> $dest_path" >&2
+
+    # Calculate the corresponding .rbs file path for the source
+    source_rbs=$(echo "$source_path" | sed -E 's|^(.*/)?lib/|sig/|; s|\.rb$|.rbs|')
+
+    # Remove the old .rbs file if it exists
+    if [[ -f "$source_rbs" ]]; then
+        echo "Removing old RBS file: $source_rbs" >&2
+        rm -f "$source_rbs"
+    fi
+
+    # Determine the new .rb file path
+    if [[ -d "$dest_path" ]]; then
+        dest_file="$dest_path/$(basename "$source_path")"
+    else
+        dest_file="$dest_path"
+    fi
+
+    # Check if the destination is in lib/
+    if [[ ! "$dest_file" =~ lib/ ]]; then
+        echo "Destination is not in lib/, skipping RBS generation" >&2
+        exit 0
+    fi
+
+    # Generate RBS for the new file
+    if [[ -f "$dest_file" ]]; then
+        echo "Running rbs-inline for $dest_file..." >&2
+
+        if ! bundle exec rbs-inline --opt-out --output=sig/ "$dest_file" >&2; then
+            echo "Warning: RBS generation failed for $dest_file" >&2
+            exit 0
+        fi
+
+        echo "RBS generation completed." >&2
+    fi
+
+    exit 0
+fi
+
+exit 0

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

@@ -0,0 +1,68 @@
+#!/bin/bash
+#
+# PostToolUse hook for self-review after git push
+#
+# This script triggers a self-review process after git push operations.
+# The output is fed back to Claude via JSON, prompting it to perform
+# a code review.
+#
+# NOTE: PostToolUse hooks with exit code 0 only show plain text stdout
+# in verbose mode. To ensure Claude receives the message, we output JSON
+# with "decision": "block" and "reason", which Claude Code delivers as
+# a system-reminder.
+#
+
+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 run for Bash tool
+if [[ "$tool_name" != "Bash" ]]; then
+  exit 0
+fi
+
+# Check if it's a git push command
+if [[ ! "$command" =~ git[[:space:]]+push ]]; then
+  exit 0
+fi
+
+# Check if push was successful (field may not exist; default to 0)
+exit_code=$(echo "$input" | jq -r '.tool_response.exit_code // 0')
+
+if [[ "$exit_code" != "0" ]]; then
+  # Push failed, no need for review
+  exit 0
+fi
+
+# Output self-review prompt as JSON so Claude receives it
+review_prompt='SELF-REVIEW REQUIRED: A git push has been completed. Please use the Task tool with subagent_type Explore to perform a self-review of the changes. Use this prompt for the Explore subagent:
+
+First, read CLAUDE.md to understand the project rules and conventions.
+Then review the recent git push. Run `git log origin/main..HEAD --stat` and
+`git diff origin/main...HEAD` to examine all changes from the branch point.
+Check for:
+1. Correctness: requirements met, logic errors, edge cases
+2. Code Quality: naming, readability, follows project conventions
+3. Testing: test coverage for new functionality
+4. Security: vulnerabilities, input validation
+5. Commit Quality: each commit should be a meaningful unit of work.
+   If there are minor fix commits (typos, forgotten changes, careless mistakes),
+   suggest squashing them into the relevant commit before merging.
+
+Report findings and suggest fixes if needed.
+After the subagent review, if issues are found, create follow-up commits to address them.
+
+If working in a git worktree (i.e., the working directory is under .claude/worktrees/),
+use `git -C <worktree-path>` for all git commands instead of `cd <path> && git`.
+Also avoid chaining commands with `&&` where possible — run each command separately.'
+
+jq -n --arg reason "$review_prompt" '{
+  "decision": "block",
+  "reason": $reason
+}'
+
+exit 0

data/.claude/settings.json

@@ -0,0 +1,58 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-sig-files.sh",
+            "timeout": 5000
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/pre-commit-check.sh",
+            "timeout": 300000
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/claude-code-web-session-start.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/rbs-inline.sh",
+            "timeout": 60000
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/self-review.sh",
+            "timeout": 10000
+          }
+        ]
+      }
+    ]
+  }
+}

data/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+    "recommendations": [
+        "shopify.ruby-lsp",
+        "tk0miya.rbs-helper"
+    ]
+}

data/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "[ruby]": {
+    "editor.defaultFormatter": "Shopify.ruby-lsp"
+  },
+  "rbs-helper.rbs-inline-on-save": true,
+  "rbs-helper.rbs-inline-signature-directory": "sig/"
+}

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [1.0.0] - 2026-07-15
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"rubocop-rspec-unused-let" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["i.tkomiya@gmail.com"](mailto:"i.tkomiya@gmail.com").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Takeshi KOMIYA
+
+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,117 @@
+# rubocop-rspec-unused-let
+
+A [RuboCop](https://github.com/rubocop/rubocop) extension that detects
+unreferenced RSpec `let` definitions.
+
+It adds a single cop, `RSpec/UnusedLet`, which flags `let` (and optionally
+`let!`) definitions whose name is never referenced within their scope. The cop
+is deliberately conservative around `shared_examples` so that it avoids false
+positives that a naive implementation would produce.
+
+## Installation
+
+Add the gem to your `Gemfile`:
+
+```ruby
+gem "rubocop-rspec-unused-let", require: false
+```
+
+This gem builds on [rubocop-rspec](https://github.com/rubocop/rubocop-rspec),
+so make sure that is available too.
+
+## Usage
+
+Enable both plugins in your `.rubocop.yml`:
+
+```yaml
+plugins:
+  - rubocop-rspec
+  - rubocop-rspec-unused-let
+```
+
+## What it detects
+
+```ruby
+# bad
+RSpec.describe Foo do
+  let(:used)   { 1 }
+  let(:unused) { 2 } # never referenced
+
+  it { expect(used).to eq(1) }
+end
+
+# good
+RSpec.describe Foo do
+  let(:used) { 1 }
+
+  it { expect(used).to eq(1) }
+end
+```
+
+A `let` is considered *used* when its name appears as a bare method call
+anywhere in its scope — inside examples, hooks (`before`/`after`/`around`),
+`subject`, other `let` blocks, and nested example groups. Dynamic references
+such as `send(:name)` / `public_send("name")` are also treated as usages.
+
+## How it handles `shared_examples`
+
+Because RuboCop analyzes one file at a time, a `let` can be consumed by a shared
+example block defined in another file. To avoid false positives, the cop stays
+silent whenever it cannot see every possible reference:
+
+- `let` definitions **inside** a `shared_examples` / `shared_context` block are
+  ignored (their consumers are the including groups, which may be external).
+- When an example group's subtree contains a shared example inclusion
+  (`it_behaves_like`, `include_examples`, `include_context`, ...), the `let`
+  definitions **visible at that inclusion point** are ignored. Sibling subtrees
+  that do not include shared examples are still checked.
+
+```ruby
+RSpec.describe Foo do
+  let(:a) { 1 }              # skipped: visible at the inclusion below
+
+  context "with shared" do
+    let(:b) { 2 }            # skipped: same
+    it_behaves_like "something"
+  end
+
+  context "other" do
+    let(:c) { 3 }            # checked: the shared block cannot see `c`
+    it { expect(c).to eq(3) }
+  end
+end
+```
+
+## Configuration
+
+```yaml
+RSpec/UnusedLet:
+  # Whether to also check `let!`. On by default. Since `let!` is sometimes used
+  # purely for its side effects (e.g. `let!(:user) { create(:user) }`), set this
+  # to `false` to opt out.
+  CheckLetBang: true
+```
+
+## Known limitations
+
+- Analysis is limited to a single file; references reachable only across files
+  (e.g. through external shared examples) are intentionally not flagged.
+- `let` definitions in an override chain (redefined in a nested group, or
+  overriding an outer definition) are skipped, since the outer one may be
+  reached through `super`.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then run
+`rake spec` to run the tests and `rake rubocop` to lint the gem. `rake` runs
+both.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/tk0miya/rubocop-rspec-unused-let.
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :ci
+
+task ci: %i[rubocop spec steep rbs:validate]
+
+namespace :rbs do
+  desc "Install RBS signatures"
+  task :install do
+    sh "bundle exec rbs collection install --frozen"
+  end
+
+  desc "Generate RBS files"
+  task :generate do
+    sh "rbs-inline", "--opt-out", "--output=sig", "lib"
+  end
+
+  desc "Validate RBS files"
+  task validate: "rbs:install" do
+    sh "bundle exec rbs -Isig validate"
+  end
+end
+
+desc "Run steep type check"
+task steep: "rbs:install" do
+  sh "bundle exec steep check"
+end

data/Steepfile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# D = Steep::Diagnostic
+
+target :lib do
+  signature "sig"
+  check "lib"
+  implicitly_returns_nil!
+end

data/config/default.yml

@@ -0,0 +1,9 @@
+---
+RSpec/UnusedLet:
+  Description: Checks for `let` definitions that are never referenced.
+  Enabled: true
+  CheckLetBang: true
+  Include:
+    - "**/*_spec.rb"
+    - "**/spec/**/*"
+  VersionAdded: '1.0.0'

data/lib/rubocop/cop/rspec/unused_let.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module RSpec
+      # Checks for `let` definitions that are never referenced.
+      #
+      # A `let` (or `let!`) whose name is never used within its scope is dead
+      # code that makes specs harder to read. This cop flags such definitions.
+      #
+      # `let!` is checked as well by default. Since it is sometimes used purely
+      # for its side effects (e.g. `let!(:user) { create(:user) }`), you can opt
+      # out with `CheckLetBang: false`.
+      #
+      # To avoid false positives, the cop deliberately stays silent whenever it
+      # cannot see every possible reference:
+      #
+      # * `let` definitions inside a `shared_examples`/`shared_context` block are
+      #   ignored, because their consumers live in the (possibly external)
+      #   including example groups.
+      # * When an example group's subtree contains a shared example inclusion
+      #   (`it_behaves_like`, `include_examples`, `include_context`, ...), the
+      #   `let` definitions visible at that inclusion point are ignored, because
+      #   the (possibly external) shared block may reference them.
+      # * `let` definitions that participate in an override chain (redefined in a
+      #   nested group, or overriding an outer definition) are ignored, since the
+      #   outer definition may be reached through `super`.
+      #
+      # Dynamic references such as `send(:foo)` are treated as usages.
+      #
+      # @example
+      #   # bad
+      #   describe Foo do
+      #     let(:used) { 1 }
+      #     let(:unused) { 2 }
+      #
+      #     it { expect(used).to eq(1) }
+      #   end
+      #
+      #   # good
+      #   describe Foo do
+      #     let(:used) { 1 }
+      #
+      #     it { expect(used).to eq(1) }
+      #   end
+      #
+      # @example CheckLetBang: true (default)
+      #   # bad
+      #   describe Foo do
+      #     let!(:widget) { create(:widget) }
+      #
+      #     it { expect(Widget.count).to eq(1) }
+      #   end
+      #
+      # @example CheckLetBang: false
+      #   # good - `let!` is assumed to be used for its side effects
+      #   describe Foo do
+      #     let!(:widget) { create(:widget) }
+      #
+      #     it { expect(Widget.count).to eq(1) }
+      #   end
+      class UnusedLet < ::RuboCop::Cop::RSpec::Base
+        MSG = "`%<helper>s(:%<name>s)` is not referenced anywhere. " \
+              "Remove it or reference it in an example."
+
+        DYNAMIC_DISPATCH_METHODS = %i[
+          send public_send __send__ method respond_to?
+        ].freeze
+
+        # Signatures for the helpers defined dynamically by the node pattern
+        # macros below (rbs-inline cannot infer these).
+        #
+        # @rbs!
+        #   def example_group?: (RuboCop::AST::Node node) -> bool
+        #   def spec_group?: (RuboCop::AST::Node node) -> bool
+        #   def let_definition: (RuboCop::AST::Node node) -> [ Symbol, (Symbol | String) ]?
+        #   def method_called?: (RuboCop::AST::Node node, Symbol name) -> bool
+        #   def contains_inclusion?: (RuboCop::AST::Node node) -> bool
+
+        def_node_matcher :example_group?, <<~PATTERN
+          (block (send #rspec? #ExampleGroups.all ...) ...)
+        PATTERN
+
+        def_node_matcher :spec_group?, <<~PATTERN
+          (block (send #rspec? {#ExampleGroups.all #SharedGroups.all} ...) ...)
+        PATTERN
+
+        def_node_matcher :let_definition, <<~PATTERN
+          {
+            (block (send nil? ${:let :let!} ({sym str} $_) ...) ...)
+            (send nil? ${:let :let!} ({sym str} $_) block_pass)
+          }
+        PATTERN
+
+        def_node_search :method_called?, "(send nil? %)"
+
+        def_node_search :contains_inclusion?, "(send nil? #Includes.all ...)"
+
+        # @rbs node: RuboCop::AST::Node
+        def on_block(node) #: void
+          return unless example_group?(node)
+          # A shared example inclusion anywhere in this group's subtree can
+          # consume any `let` visible here, so we cannot judge them.
+          return if contains_inclusion?(node)
+
+          RuboCop::RSpec::ExampleGroup.new(node).lets.each do |let|
+            check_let(node, let)
+          end
+        end
+
+        private
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs let: RuboCop::AST::Node
+        def check_let(group, let) #: void
+          helper, name = let_definition(let)
+          return unless name
+          return if helper == :let! && !cop_config["CheckLetBang"]
+          return if override_chain?(group, name)
+          return if referenced?(group, name)
+
+          node = let #: untyped
+          send_node = node.block_type? ? node.send_node : node
+          add_offense(send_node, message: format(MSG, helper: helper, name: name))
+        end
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def referenced?(group, name) #: bool
+          method_called?(group, name.to_sym) ||
+            dynamically_referenced?(group, name)
+        end
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def dynamically_referenced?(group, name) #: bool
+          target = name.to_s
+          group.each_descendant(:send).any? do |send_node|
+            node = send_node #: untyped
+            next false unless DYNAMIC_DISPATCH_METHODS.include?(node.method_name)
+
+            arg = node.first_argument
+            arg&.type?(:sym, :str) && arg.value.to_s == target
+          end
+        end
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def override_chain?(group, name) #: bool
+          overrides_outer?(group, name) ||
+            redefined_in_descendant?(group, name)
+        end
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def overrides_outer?(group, name) #: bool
+          group.each_ancestor(:block).any? do |ancestor|
+            next false unless spec_group?(ancestor)
+
+            RuboCop::RSpec::ExampleGroup.new(ancestor).lets.any? do |let|
+              _, other = let_definition(let)
+              other == name
+            end
+          end
+        end
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def redefined_in_descendant?(group, name) #: bool
+          count = 0
+          group.each_descendant(:block, :send) do |descendant|
+            _, other = let_definition(descendant)
+            count += 1 if other == name
+            return true if count > 1
+          end
+          false
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/rspec/unused/let/plugin.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "lint_roller"
+
+module Rubocop
+  module Rspec
+    module Unused
+      module Let
+        # A RuboCop plugin (LintRoller) that registers this gem's cops and
+        # default configuration. Referenced from the gemspec via the
+        # `default_lint_roller_plugin` metadata, so users can enable it with:
+        #
+        #   plugins:
+        #     - rubocop-rspec
+        #     - rubocop-rspec-unused-let
+        class Plugin < LintRoller::Plugin
+          # @rbs override
+          def about
+            LintRoller::About.new(
+              name: "rubocop-rspec-unused-let",
+              version: VERSION,
+              homepage: "https://github.com/tk0miya/rubocop-rspec-unused-let",
+              description: "Detects unreferenced RSpec `let` definitions."
+            )
+          end
+
+          # @rbs override
+          def supported?(context)
+            context.engine == :rubocop
+          end
+
+          # @rbs override
+          def rules(_context)
+            LintRoller::Rules.new(
+              type: :path,
+              config_format: :rubocop,
+              value: CONFIG_DEFAULT
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/rspec/unused/let/version.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Rubocop
+  module Rspec
+    module Unused
+      module Let
+        VERSION = "1.0.0"
+      end
+    end
+  end
+end

data/lib/rubocop/rspec/unused/let.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+require "rubocop"
+require "rubocop-rspec"
+
+require_relative "let/version"
+
+module Rubocop
+  module Rspec
+    module Unused
+      module Let
+        class Error < StandardError; end
+
+        PROJECT_ROOT = Pathname.new(__dir__ || ".").join("../../../..").expand_path.freeze #: Pathname
+        CONFIG_DEFAULT = PROJECT_ROOT.join("config", "default.yml").freeze #: Pathname
+
+        private_constant :PROJECT_ROOT
+      end
+    end
+  end
+end
+
+require_relative "let/plugin"
+
+require_relative "../../cop/rspec/unused_let"

data/lib/rubocop-rspec-unused-let.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+# Entry point used when the gem is loaded via `require: rubocop-rspec-unused-let`
+# from a `.rubocop.yml`.
+require_relative "rubocop/rspec/unused/let"

data/rbs_collection.lock.yaml

@@ -0,0 +1,192 @@
+---
+path: ".gem_rbs_collection"
+gems:
+- name: ast
+  version: '2.4'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: concurrent-ruby
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: csv
+  version: '3.3'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: diff-lcs
+  version: '1.5'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: ffi
+  version: 1.17.4
+  source:
+    type: rubygems
+- name: fileutils
+  version: '0'
+  source:
+    type: stdlib
+- name: forwardable
+  version: '0'
+  source:
+    type: stdlib
+- name: json
+  version: '0'
+  source:
+    type: stdlib
+- name: language_server-protocol
+  version: 3.17.0.6
+  source:
+    type: rubygems
+- name: lint_roller
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: listen
+  version: '3.9'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: logger
+  version: '1.7'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: monitor
+  version: '0'
+  source:
+    type: stdlib
+- name: optparse
+  version: '0'
+  source:
+    type: stdlib
+- name: parallel
+  version: '1.20'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: parser
+  version: '3.2'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: prism
+  version: 1.9.0
+  source:
+    type: rubygems
+- name: rainbow
+  version: '3.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rake
+  version: '13.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: random-formatter
+  version: '0'
+  source:
+    type: stdlib
+- name: rbs
+  version: 4.0.3
+  source:
+    type: rubygems
+- name: rbs-inline
+  version: 0.14.0
+  source:
+    type: rubygems
+- name: rdoc
+  version: '0'
+  source:
+    type: stdlib
+- name: regexp_parser
+  version: '2.8'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rubocop
+  version: '1.57'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rubocop-ast
+  version: '1.46'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: ea56a88d1c0ac98e79f8ea5bb19a139da768ba10
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rubocop-numbered-params
+  version: 1.0.0
+  source:
+    type: rubygems
+- name: rubocop-rbs_inline
+  version: 1.6.0
+  source:
+    type: rubygems
+- name: securerandom
+  version: '0'
+  source:
+    type: stdlib
+- name: stringio
+  version: '0'
+  source:
+    type: stdlib
+- name: strscan
+  version: '0'
+  source:
+    type: stdlib
+- name: tsort
+  version: '0'
+  source:
+    type: stdlib
+- name: uri
+  version: '0'
+  source:
+    type: stdlib
+gemfile_lock_path: Gemfile.lock

data/rbs_collection.yaml

@@ -0,0 +1,14 @@
+# Download sources
+sources:
+  - type: git
+    name: ruby/gem_rbs_collection
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    revision: main
+    repo_dir: gems
+
+# You can specify local directories as sources also.
+# - type: local
+#   path: path/to/local/repository
+
+# A directory to install the downloaded RBS files.
+path: .gem_rbs_collection

data/sig/rubocop/cop/rspec/unused_let.rbs

@@ -0,0 +1,108 @@
+# Generated from lib/rubocop/cop/rspec/unused_let.rb with RBS::Inline
+
+module RuboCop
+  module Cop
+    module RSpec
+      # Checks for `let` definitions that are never referenced.
+      #
+      # A `let` (or `let!`) whose name is never used within its scope is dead
+      # code that makes specs harder to read. This cop flags such definitions.
+      #
+      # `let!` is checked as well by default. Since it is sometimes used purely
+      # for its side effects (e.g. `let!(:user) { create(:user) }`), you can opt
+      # out with `CheckLetBang: false`.
+      #
+      # To avoid false positives, the cop deliberately stays silent whenever it
+      # cannot see every possible reference:
+      #
+      # * `let` definitions inside a `shared_examples`/`shared_context` block are
+      #   ignored, because their consumers live in the (possibly external)
+      #   including example groups.
+      # * When an example group's subtree contains a shared example inclusion
+      #   (`it_behaves_like`, `include_examples`, `include_context`, ...), the
+      #   `let` definitions visible at that inclusion point are ignored, because
+      #   the (possibly external) shared block may reference them.
+      # * `let` definitions that participate in an override chain (redefined in a
+      #   nested group, or overriding an outer definition) are ignored, since the
+      #   outer definition may be reached through `super`.
+      #
+      # Dynamic references such as `send(:foo)` are treated as usages.
+      #
+      # @example
+      #   # bad
+      #   describe Foo do
+      #     let(:used) { 1 }
+      #     let(:unused) { 2 }
+      #
+      #     it { expect(used).to eq(1) }
+      #   end
+      #
+      #   # good
+      #   describe Foo do
+      #     let(:used) { 1 }
+      #
+      #     it { expect(used).to eq(1) }
+      #   end
+      #
+      # @example CheckLetBang: true (default)
+      #   # bad
+      #   describe Foo do
+      #     let!(:widget) { create(:widget) }
+      #
+      #     it { expect(Widget.count).to eq(1) }
+      #   end
+      #
+      # @example CheckLetBang: false
+      #   # good - `let!` is assumed to be used for its side effects
+      #   describe Foo do
+      #     let!(:widget) { create(:widget) }
+      #
+      #     it { expect(Widget.count).to eq(1) }
+      #   end
+      class UnusedLet < ::RuboCop::Cop::RSpec::Base
+        MSG: ::String
+
+        DYNAMIC_DISPATCH_METHODS: untyped
+
+        def example_group?: (RuboCop::AST::Node node) -> bool
+
+        def spec_group?: (RuboCop::AST::Node node) -> bool
+
+        def let_definition: (RuboCop::AST::Node node) -> [ Symbol, Symbol | String ]?
+
+        def method_called?: (RuboCop::AST::Node node, Symbol name) -> bool
+
+        def contains_inclusion?: (RuboCop::AST::Node node) -> bool
+
+        # @rbs node: RuboCop::AST::Node
+        def on_block: (RuboCop::AST::Node node) -> void
+
+        private
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs let: RuboCop::AST::Node
+        def check_let: (RuboCop::AST::Node group, RuboCop::AST::Node let) -> void
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def referenced?: (RuboCop::AST::Node group, Symbol | String name) -> bool
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def dynamically_referenced?: (RuboCop::AST::Node group, Symbol | String name) -> bool
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def override_chain?: (RuboCop::AST::Node group, Symbol | String name) -> bool
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def overrides_outer?: (RuboCop::AST::Node group, Symbol | String name) -> bool
+
+        # @rbs group: RuboCop::AST::Node
+        # @rbs name: Symbol | String
+        def redefined_in_descendant?: (RuboCop::AST::Node group, Symbol | String name) -> bool
+      end
+    end
+  end
+end

data/sig/rubocop/rspec/unused/let/plugin.rbs

@@ -0,0 +1,27 @@
+# Generated from lib/rubocop/rspec/unused/let/plugin.rb with RBS::Inline
+
+module Rubocop
+  module Rspec
+    module Unused
+      module Let
+        # A RuboCop plugin (LintRoller) that registers this gem's cops and
+        # default configuration. Referenced from the gemspec via the
+        # `default_lint_roller_plugin` metadata, so users can enable it with:
+        #
+        #   plugins:
+        #     - rubocop-rspec
+        #     - rubocop-rspec-unused-let
+        class Plugin < LintRoller::Plugin
+          # @rbs override
+          def about: ...
+
+          # @rbs override
+          def supported?: ...
+
+          # @rbs override
+          def rules: ...
+        end
+      end
+    end
+  end
+end

data/sig/rubocop/rspec/unused/let/version.rbs

@@ -0,0 +1,11 @@
+# Generated from lib/rubocop/rspec/unused/let/version.rb with RBS::Inline
+
+module Rubocop
+  module Rspec
+    module Unused
+      module Let
+        VERSION: ::String
+      end
+    end
+  end
+end

data/sig/rubocop/rspec/unused/let.rbs

@@ -0,0 +1,16 @@
+# Generated from lib/rubocop/rspec/unused/let.rb with RBS::Inline
+
+module Rubocop
+  module Rspec
+    module Unused
+      module Let
+        class Error < StandardError
+        end
+
+        PROJECT_ROOT: Pathname
+
+        CONFIG_DEFAULT: Pathname
+      end
+    end
+  end
+end

data/sig/rubocop-rspec-unused-let.rbs

@@ -0,0 +1,2 @@
+# Generated from lib/rubocop-rspec-unused-let.rb with RBS::Inline
+

data/sig/rubocop_rspec_stubs.rbs

@@ -0,0 +1,27 @@
+# Hand-written stubs for rubocop-rspec, which ships no RBS signatures and is
+# not available in the RBS collection. Only the surface used by this gem's cop
+# is declared.
+
+module RuboCop
+  module Cop
+    module RSpec
+      class Base
+        def cop_config: () -> Hash[String, untyped]
+
+        def add_offense: (untyped node, ?message: String) -> void
+
+        def self.def_node_matcher: (Symbol, String) -> void
+
+        def self.def_node_search: (Symbol, String) -> void
+      end
+    end
+  end
+
+  module RSpec
+    class ExampleGroup
+      def initialize: (RuboCop::AST::Node node) -> void
+
+      def lets: () -> Array[RuboCop::AST::Node]
+    end
+  end
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: rubocop-rspec-unused-let
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Takeshi KOMIYA
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lint_roller
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.72'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.72'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: rubocop-rspec-unused-let adds the RSpec/UnusedLet cop, which flags `let`
+  (and optionally `let!`) definitions that are never referenced within their scope,
+  while staying conservative around shared_examples to avoid false positives.
+email:
+- i.tkomiya@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".claude/hooks/claude-code-web-session-start.sh"
+- ".claude/hooks/pre-commit-check.sh"
+- ".claude/hooks/protect-sig-files.sh"
+- ".claude/hooks/rbs-inline.sh"
+- ".claude/hooks/self-review.sh"
+- ".claude/settings.json"
+- ".vscode/extensions.json"
+- ".vscode/settings.json"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- Steepfile
+- config/default.yml
+- lib/rubocop-rspec-unused-let.rb
+- lib/rubocop/cop/rspec/unused_let.rb
+- lib/rubocop/rspec/unused/let.rb
+- lib/rubocop/rspec/unused/let/plugin.rb
+- lib/rubocop/rspec/unused/let/version.rb
+- rbs_collection.lock.yaml
+- rbs_collection.yaml
+- sig/rubocop-rspec-unused-let.rbs
+- sig/rubocop/cop/rspec/unused_let.rbs
+- sig/rubocop/rspec/unused/let.rbs
+- sig/rubocop/rspec/unused/let/plugin.rbs
+- sig/rubocop/rspec/unused/let/version.rbs
+- sig/rubocop_rspec_stubs.rbs
+homepage: https://github.com/tk0miya/rubocop-rspec-unused-let
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/tk0miya/rubocop-rspec-unused-let
+  source_code_uri: https://github.com/tk0miya/rubocop-rspec-unused-let
+  changelog_uri: https://github.com/tk0miya/rubocop-rspec-unused-let/blob/main/CHANGELOG.md
+  default_lint_roller_plugin: Rubocop::Rspec::Unused::Let::Plugin
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: A RuboCop cop that detects unreferenced RSpec `let` definitions.
+test_files: []