Co-authored-by: Sam Ford <1584702+samford@users.noreply.github.com>
Co-authored-by: Dustin Rodrigues <dust.rod@gmail.com>

See #8709

Co-authored-by: Sam Ford <1584702+samford@users.noreply.github.com>
Co-authored-by: Thierry Moisan <thierry.moisan@gmail.com>
Co-authored-by: Dawid Dziurla <dawidd0811@gmail.com>
Co-authored-by: Maxim Belkin <maxim.belkin@gmail.com>
Co-authored-by: Issy Long <me@issyl0.co.uk>
Co-authored-by: Mike McQuaid <mike@mikemcquaid.com>
Co-authored-by: Seeker <meaningseeking@protonmail.com>

This PR adds a new `brew typecheck` developer command which checks for
typechecking errors in the current code with Sorbet.

These were all made `--formulae` and `--casks` for consistency but that
doesn't behave as expected because they have special behaviours in
`args`. Instead, use the singular form everywhere.

This was deprecated and removed a while ago.

* Move main completion cache handling to `brew update`.
* Enable completion caching by default.

Sorts flags also.

* brew completion in ZSH currently doesn't complete local formula files for most commands.
* Updating the completion script to complete formula files as well as known formulas in places that it would makes sense to do so.
* This includesFixes to __brew_formula_or_ruby_files
  * Remove redundant call to uncached brew search
  * Add missing ""

The brew file contains an incorrect completion for brew cask cleanup, which will yield an error as cleanup is deprecated from brew cask.