Unclear docs/recommendations for running as root (or not)

[zbentley]

If my Puppet code has

class {"homebrew":
     user => "myuser",
     github_token => "whatnot"
}
package { "ack": provider => brew }

And I run that code as myuser, via sudo bolt apply, the package install fails with:

Package[ack]: change from 'absent' to 'present' failed: Could not install package: Execution of '/opt/homebrew/bin/brew install ack' returned 1:

However, if I drop the sudo, the install proceeds appropriately.

README indicates that running puppet as root and brew as a user is good/desirable/common, but it seems like it's unsupported.

I'm using master (53a5631) since other code does not look for/use Homebrew binaries from the right place.

I'm on MacOS12.5 on an ARM/M1 mac, with a fresh install of Macos (no upgrade in place), and Homebrew installed via their site's curl oneliner, not installed via Puppet/this module.