Add Homebrew formula

[cboone]

This replaces #44. This time it's built on #48, so as not to confuse Copilot unnecessarily. Once that PR is merged or closed, I'll clean this one up.

This time I had to temporarily downgrade the version in Cargo.toml so that it matches the names of the released binaries. Once you release updates, I can pull that commit out.

My notes from last time:

Thanks for scrut! It's fantastic.

I saw your note in the docs about Homebrew installation coming soon, so I made a simple formula (and updated the docs). I have no idea if this is actually how you intend to handle the installation (is there a better repo for the formula?), but thought I'd send it along in case it works for you.

I'm happy to make any helpful changes, just let me know. Specifically, if it's helpful to have a script or task or something to update the formula when you push a new release, I can add that. Just give me an idea of how to proceed.

[Copilot]

Pull request overview

This PR adds Homebrew installation support for Scrut, including shell completion generation functionality. The changes enable users to install Scrut via Homebrew with automatic completion setup for Bash, Fish, PowerShell, and Zsh.

Changes:

• Added Homebrew formula with platform-specific binary installation for macOS and Linux
• Implemented shell completion generation using the _SCRUT_COMPLETE environment variable
• Updated documentation with Homebrew installation instructions and shell completion usage guide

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
Formula/scrut.rb	New Homebrew formula that downloads pre-built binaries and generates shell completions during installation
src/bin/main.rs	Added completion generation logic triggered by _SCRUT_COMPLETE environment variable
website/docs/getting-started/installation.md	Updated installation docs with Homebrew instructions and shell completion guide
selftest/commands/completions.md	Added tests for shell completion functionality across Bash, Zsh, and Fish
Cargo.toml	Added clap_complete dependency and temporarily downgraded version to match released binaries

---

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

[cboone]

Updated to appease Copilot.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 5 changed files in this pull request and generated 1 comment.

---

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

[Copilot]

Pull request overview

Copilot reviewed 4 out of 5 changed files in this pull request and generated 1 comment.

---

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

[Copilot]

Pull request overview

Copilot reviewed 4 out of 5 changed files in this pull request and generated 1 comment.

---

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

[Copilot]

The test assertion should include the 'v' prefix to match the actual version output format. According to the installation documentation (line 81 of installation.md), the version command outputs "scrut v0.X.Y" format, not "scrut 0.X.Y". The assertion should be changed to match "scrut v" followed by the version.

Suggested change

	assert_match "scrut #{version}", shell_output("#{bin}/scrut --version")
	assert_match "scrut v#{version}", shell_output("#{bin}/scrut --version")

[cboone]

In this case the docs are wrong, not the test.

[ukautz]

Your test is correct, the copilot is wrong.

[ukautz]

$ cargo build --release
# ...

$ target/release/scrut --version
scrut 0.4.3

[ukautz]

@cboone Thanks for this again! I really, really want Homebrew support as well, so more than happy you did that.

Two things:

• I just upgraded the Scrut version to 0.4.3. This cannot be done via PR on GH only, it needs to come from our internal generation or I'll end up in sync conflicts. If you add / modify dependencies we will bump the version when merging the PR (or shortly after).
• The hashes (sha256 "b05b..."): Right now they are hard coded. Ideally I want that file to be automatically created and committed, but afaik that would require a two-repository-setup (then using an action like this). For now: Can you add a script or extend the Makefile, to create the file?

[AndreasBackx]

If only we had proper stacked diffs! Thank you for your changes!

[cboone]

• I just upgraded the Scrut version to 0.4.3. This cannot be done via PR on GH only, it needs to come from our internal generation or I'll end up in sync conflicts. If you add / modify dependencies we will bump the version when merging the PR (or shortly after).
• The hashes (sha256 "b05b..."): Right now they are hard coded. Ideally I want that file to be automatically created and committed, but afaik that would require a two-repository-setup (then using an action like this). For now: Can you add a script or extend the Makefile, to create the file?

Absolutely! Will do.

[cboone]

Sorry, totally dropped the ball here! I'll get it sorted today.