commands: typed: strict

[cho-m]

• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same change?
• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your changes? Here's an example.
• Have you successfully run brew lgtm (style, typechecking and tests) with your changes locally?

---

Part of

• Use Sorbet typed: strict in all (non-package) files in Homebrew organisation #17297

[Copilot]

Pull request overview

This PR enables Sorbet's typed: strict mode for the commands-related modules by adding comprehensive type signatures and annotations throughout the codebase. This is part of a larger effort (#17297) to improve type safety across the Homebrew codebase.

Key Changes:

• Upgraded Library/Homebrew/commands.rb from typed: true to typed: strict with complete type signatures for all methods
• Added type annotations to constants using T.let() for proper type inference
• Added necessary type casts and safe navigation operators to satisfy strict type checking

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
Library/Homebrew/commands.rb	Main changes: upgraded to typed: strict, added method signatures, annotated constants with T.let(), converted .presence to .blank?, added explicit return nil, and converted .basename() to return String
Library/Homebrew/completions.rb	Added type casts for partitioned arrays to T::Array[Symbol], replaced .presence with .blank?, added .to_s for nilable command descriptions
Library/Homebrew/cli/parser.rb	Added .to_s conversion for HOMEBREW_DEV_CMD_PATH in string comparison, added nil check for arg before calling Commands.path()
Library/Homebrew/dev-cmd/prof.rb	Added T.must() assertion for args.named.first (safe due to min: 1 validation)
Library/Homebrew/dev-cmd/debugger.rb	Added T.must() assertion for args.named.first (safe due to min: 1 validation)
Library/Homebrew/brew.rb	Moved T.must(cmd) before conditional check (safe since help handling exits when cmd is nil)

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[MikeMcQuaid]

Looks good, thanks! One question.