feat: support .bicepparam parameter files for Bicep deployments

[bgdnext64]

Detect .bicepparam extension on --parametersFilePath and automatically compile to ARM JSON format using 'bicep build-params' before deployment. Both .json and .bicepparam formats are now supported.

• Add .bicepparam detection and compilation in bicepCmd.go
• Add storage-account-simple-params.bicepparam sample file
• Add TestBicepWithBicepparamFile e2e test
• Update known-issues doc (no longer unsupported)
• Add .bicepparam example to quickstart and flags docs

Closes #12

[Copilot]

Pull request overview

Adds first-class support for Bicep-native .bicepparam parameter files in the MPF Bicep workflow by compiling them to ARM JSON parameters via bicep build-params when provided through --parametersFilePath, and updates samples/docs/tests accordingly (closes #12).

Changes:

• Detect .bicepparam in cmd/bicepCmd.go and compile to .parameters.json before running the deployment authorization checker.
• Add a .bicepparam sample and an e2e test exercising bicep build-params + deployment with the compiled parameters.
• Update documentation to reflect .bicepparam support and provide quickstart/flags examples.

Reviewed changes

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

Show a summary per file

File	Description
cmd/bicepCmd.go	Adds .bicepparam detection and invokes bicep build-params to generate ARM JSON parameters prior to deployment.
e2eTests/e2eBicep_test.go	Adds a new e2e test using a .bicepparam file (compiled to JSON) with a simple storage account Bicep sample.
samples/bicep/storage-account-simple-params.bicepparam	Adds a Bicep-native parameters file sample referencing the storage account template.
docs/known-issues-and-workarounds.MD	Updates known-issues to reflect that .bicepparam is now supported.
docs/installation-and-quickstart.md	Adds quickstart examples showing .bicepparam usage (currently has formatting/command issues).
docs/commandline-flags-and-env-variables.md	Updates flag documentation to note .json and .bicepparam are supported.
go.mod	Bumps the Go toolchain version referenced by the module.

[maniSbindra]

Review findings not yet raised by the automated review.

[maniSbindra]

Hi, a few changes in addition to the automated review requested. Thanks, Mani

[bgdnext64]

Quick update on testing: I ran the new TestBicepWithBicepparamFile e2e against my test tenant end-to-end, not just locally as a build/vet. Created a fresh service principal with no role assignments (so MPF managed them dynamically), pointed it at samples/bicep/storage-account-simple-params.bicepparam, and let it go through the full discovery loop.

Result: PASS in about 120 seconds. The auto-compile path via the new bicepUtils.CompileBicepParamsToTempFile helper worked, the temp .parameters.json was cleaned up, and the storage-account deployment converged on exactly 4 permissions (Microsoft.Resources/deployments/{read,write} and Microsoft.Storage/storageAccounts/{read,write}), which is what the assertion now requires. Resource group, custom role, and the temp SP were all cleaned up afterwards.

Also worth flagging: the failing CI checks here look like the same upstream go-task/setup-task "unable to get latest version" issue we hit on #254 — it dies inside the action's own setup before any of our code runs, the workflow files are unchanged, and the same workflow was green on main last week. Happy to open a small PR pinning go-task/setup-task to a specific version (e.g. 3.50.0) instead of 3.x if that would help unblock things repo-wide.

[maniSbindra]

lgtm