Add support for installing go packages in Brewfile

[Copilot]

• Create go_dumper.rb to dump installed Go packages
• Create go_installer.rb to install Go packages
• Create go_checker.rb to check if Go packages are installed
• Update dsl.rb to add go method
• Update installer.rb to handle :go entry type
• Update lister.rb to support listing Go packages
• Update remover.rb to support removing Go entries (inherited from base remover)
• Update checker.rb to support checking Go packages
• Update dumper.rb to include Go packages in dump
• Update bundle.rb to add go_installed? helper method
• Update cmd/bundle.rb to add --go flag support
• Create tests for go_dumper.rb
• Create tests for go_installer.rb
• Update tests for dsl.rb to include Go example
• Update documentation
• Fix go_dumper parsing and add RBI type definitions
• Rename parameter from packages: to go:
• Rename packages_to_install to go_packages_to_install
• Add Sorbet signature to go method
• Fix typecheck errors
• All manual tests pass

Fixes #20645

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add support for installing go packages in Brewfile</issue_title>
<issue_description>### Verification

• This issue's title and/or description do not reference a single formula e.g. brew install wget. If they do, open an issue at https://github.com/Homebrew/homebrew-core/issues/new/choose instead.

Provide a detailed description of the proposed feature

Add support for installing go packages in Brewfile. Include the ability to specify go packages in the Brewfile.

For example:

brew "tree"
brew "node"
go "github.com/charmbracelet/crush"

The Brewfile already supports a variety of installation types, with mas, cask, vscode.

Tooling written in Go is so often available via go install <package>@latest commands. It'd be convenient if the Brewfile bundled and ensures go applications were installed too.

What is the motivation for the feature?

To expand the convenience of Brewfile so that it manages the bundling / setting up of more applications.

How will the feature be relevant to at least 90% of Homebrew users?

Go is a common language for so much tooling.

What alternatives to the feature have been considered?

Not do this. Manage the installation of go tools manually or via some other means.</issue_description>

<agent_instructions>Implement this similarly to other types.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@MikeMcQuaid Are all these criteria met?

https://docs.brew.sh/Brew-Bundle-and-Brewfile#adding-new-packages-support

@MikeMcQuaid @leighmcculloch Thanks! More questions:

👍🏻 Go binaries are installed to the local GOBIN directory. The GOBIN directory can be discovered by running go env GOBIN. Looking for the respective binary there requires a) searching for a binary with the matching name b) running go version -m -json <binary-name> and looking at the output to determine whether it matches the full path the user wishes to check is installed.

Does this refer to a unique name that can be used to reference the software? If so, then 👍🏻. Each Go package that gets installed has a unique path. For example: github.com/charmbracelet/crush.

This question is: how is a binary name mapped to/from a go install <package> invocation? Does <package> always == "binary name"?

Also: would it be desired/expected that brew bundle dump would dump all previous go install binaries and brew bundle cleanup would uninstall (how?) all un-dumped go install binaries?

@MikeMcQuaid @leighmcculloch Thanks! One more: is there a `go uninstall` for removal?

Fixes #20645

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[MikeMcQuaid]

@copilot try again

[Copilot]

@copilot try again

Fixed! The issues were:

1. Go dumper parsing: Fixed the go version -m output parsing to correctly extract the package path from tab-separated format (commit ab0f4dc)
2. Sorbet type checking: Added the missing go? method to the bundle.rbi file for proper type definitions (commit ab0f4dc)

All manual tests now pass successfully:

• ✓ Dump Go packages
• ✓ Check installed packages
• ✓ List Go packages

The implementation follows the same pattern as other package types (vscode, whalebrew) and meets all the criteria from the documentation.

[MikeMcQuaid]

@copilot use go: instead of packages:

[Copilot]

@copilot use go: instead of packages:

Done! Changed all occurrences of packages: to go: throughout the codebase (commit 36d9a9d).

Updated files:

• Library/Homebrew/bundle/lister.rb
• Library/Homebrew/bundle/dumper.rb
• Library/Homebrew/bundle/commands/dump.rb
• Library/Homebrew/bundle/commands/list.rb
• Library/Homebrew/cmd/bundle.rb

The parameter naming is now consistent with the --go flag and go "package" DSL syntax.

[MikeMcQuaid]

@copilot run brew typecheck and fix errors

[Copilot]

@copilot run brew typecheck and fix errors

Fixed! The typecheck errors were:

1. Unreachable code in dsl.rb: Removed redundant runtime type check since the Sorbet signature sig { params(name: String).void } already enforces the type at compile time
2. Test file typing level: Changed go_dumper_spec.rb from typed: strict to typed: true to avoid false positives from RSpec DSL

Changes committed and functionality verified.