chore: deprecate build version command in cli and docs before release (…

…#1762)

## Description

`build --version` command is not being used, we need to deprecate it
before the release so that we can remove it next release.

## Related Issue

Fixes #1724 
<!-- or -->
Relates to #

## Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [x] Other (security config, docs update, etc)

## Checklist before merging
- [x] Unit,
[Journey](https://github.com/defenseunicorns/pepr/tree/main/journey),
[E2E Tests](https://github.com/defenseunicorns/pepr-excellent-examples),
[docs](https://github.com/defenseunicorns/pepr/tree/main/docs),
[adr](https://github.com/defenseunicorns/pepr/tree/main/adr) added or
updated as needed
- [x] [Contributor Guide
Steps](https://docs.pepr.dev/main/contribute/#submitting-a-pull-request)
followed

Signed-off-by: Case Wylie <cmwylie19@defenseunicorns.com>
Co-authored-by: Sam Mayer <sam.mayer@defenseunicorns.com>

docs/030_user-guide/010_pepr-cli.md

@@ -99,7 +99,7 @@ Create a [zarf.yaml](https://zarf.dev) and K8s manifest for the current module.
 - `--rbac-mode [admin|scoped]` - Rbac Mode: admin, scoped (default: admin) (choices: "admin", "scoped", default: "admin")
 - `-i, --custom-image [custom-image]` - Specify a custom image (including version) for Admission and Watch Deployments. Example: 'docker.io/username/custom-pepr-controller:v1.0.0'
 - `--registry [GitHub, Iron Bank]` - Container registry: Choose container registry for deployment manifests.
-- `-v, --version <version>. Example: '0.27.3'` - The version of the Pepr image to use in the deployment manifests.
+- `-v, --version <version>. Example: '0.27.3'` - DEPRECATED: The version of the Pepr image to use in the deployment manifests.
 -  `--withPullSecret <imagePullSecret>` - Image Pull Secret: Use image pull secret for controller Deployment.
 - `-z, --zarf [manifest|chart]` - The Zarf package type to generate: manifest or chart (default: manifest).
 

src/cli/build.ts

@@ -95,7 +95,7 @@ export default function (program: RootCmd): void {
     .addOption(
       new Option(
         "-v, --version <version>",
-        "The version of the Pepr image to use in the deployment manifests. Example: '0.27.3'.",
+        "DEPRECATED: The version of the Pepr image to use in the deployment manifests. Example: '0.27.3'.",
       ).conflicts(["customImage", "registryInfo"]),
     )
     .option(
@@ -164,7 +164,7 @@ export default function (program: RootCmd): void {
         console.info(`✅ Module built successfully at ${path}`);
         return;
       }
-      // set the image version if provided
+      // set the image version if provided -- DEPRECATED
       if (opts.version) cfg.pepr.peprVersion = opts.version;
 
       // Generate a secret for the module