💡 Summary

$OPAPath parameter in Invoke-SCuBA was changed to accommodate for the upcoming case of installing ScubaGear from PSGallery.
The default path was changed to Join-Path -Path $env:USERPROFILE -ChildPath ".scubagear\Tools. A folder to be created under the user's home folder.

This issue is to add back in the original path Join-Path -Path $PSScriptRoot -ChildPath "..\..\.." as a fallback path in case the above path does not exist due to mkdir failure or the user is using the zip packaged release.

Another thing that needs to be updated is the documentation in the README for OPA default path and the docstring above Invoke-SCuBA

Motivation and context

The original intent for the default $OPAPath was so that a user could set up ScubaGear and start running with minimal installation troubleshooting. This issue is to reinforce that with documentation and additional fallbacks in case something goes awry.

Implementation notes

• Add the original Join-Path -Path $PSScriptRoot -ChildPath "..\..\.." as a fallback default path to $OPAPath in Invoke-SCuBA.
• Update documentation in the README specifically Download the Required OPA Executable and $OPAPath under Parameter Definitions
• Update the $OPAPath docstring above Invoke-SCuBA to document the new path changes.

Acceptance criteria

• A PR with the implementation notes above are made and merged into main.