chore(proguard): Soft-deprecate the proguard upload --uuid flag (#3177)

Using `--uuid` can cause unexpected behavior, if the same ProGuard mapping is uploaded with different UUIDs.

Therefore, we now recommend using `proguard uuid` to obtain the UUID of a mapping before upload, as this eliminates the need to manually set a UUID.

Stacked on #3176

Closes #3172
Closes [CLI-296](https://linear.app/getsentry/issue/CLI-296/proguard-upload-manually-specified-uuid-not-respected)

Author: szokeasaurusrex

src/commands/proguard/upload.rs

@@ -59,13 +59,15 @@ pub fn make_command(command: Command) -> Command {
                 .short('u')
                 .value_name("UUID")
                 .value_parser(Uuid::parse_str)
+                .hide(true)
                 .help(
-                    "Explicitly override the UUID of the mapping file with another one.{n}\
-                     This should be used with caution as it means that you can upload \
-                     multiple mapping files if you don't take care.  This however can \
-                     be useful if you have a build process in which you need to know \
-                     the UUID of the proguard file before it was created.  If you upload \
-                     a file with a forced UUID you can only upload a single proguard file.",
+                    "[DEPRECATED] Manually override the UUID for the uploaded mapping.\n\
+                    We no longer recommend using this option. \
+                    If you use this option, you must use it consistently, and you must \
+                    ensure the UUID is generated deterministically based on the ProGuard \
+                    mapping. \n\
+                    If you need to know the UUID before upload, we recommend using the \
+                    `proguard uuid` command.",
                 ),
         )
 }

tests/integration/_cases/proguard/proguard-upload-help.trycmd

@@ -26,12 +26,6 @@ Options:
                                  flag is currently implemented only for selected subcommands.
                                  [aliases: --silent]
       --require-one              Requires at least one file to upload or the command will error.
-  -u, --uuid <UUID>              Explicitly override the UUID of the mapping file with another one.
-                                 This should be used with caution as it means that you can upload
-                                 multiple mapping files if you don't take care.  This however can be
-                                 useful if you have a build process in which you need to know the
-                                 UUID of the proguard file before it was created.  If you upload a
-                                 file with a forced UUID you can only upload a single proguard file.
   -h, --help                     Print help
 
 ```

tests/integration/_cases/upload_proguard/upload_proguard-help.trycmd

@@ -26,12 +26,6 @@ Options:
                                  flag is currently implemented only for selected subcommands.
                                  [aliases: --silent]
       --require-one              Requires at least one file to upload or the command will error.
-  -u, --uuid <UUID>              Explicitly override the UUID of the mapping file with another one.
-                                 This should be used with caution as it means that you can upload
-                                 multiple mapping files if you don't take care.  This however can be
-                                 useful if you have a build process in which you need to know the
-                                 UUID of the proguard file before it was created.  If you upload a
-                                 file with a forced UUID you can only upload a single proguard file.
   -h, --help                     Print help
 
 ```