#2131: improve auto completion for ide upgrade mode

[vivu001]

This PR fixes #2131

Implemented changes:

• Added enum-based auto-completion support for CLI parameters using EnumProperty
• Implemented value suggestions for --mode in UpgradeCommandlet
• Enabled prefix-based filtering for parameter values (e.g. --mode=s)
• Ensured completion output follows IDEasy token-based behavior (--key=value)
• Added user-facing documentation for parameter value completion in CLI docs

---

Testing instructions

1. Checkout the feature branch.
2. Run the following script to build the native image: ./build-local-dev.sh.
3. Start a new terminal session
   Ensure the newly built executable is picked up (restart shell if needed).
4. Verify auto-completion suggestions: open a bash terminal, then run:

• Case 1:

ide upgrade --mode=[Tab][Tab]

Expected output:
--mode=snapshot --mode=stable --mode=unstable

The suggested values correspond to all predefined values of the UpgradeMode enum.

• Case 2: Verify prefix filtering

ide upgrade --mode=s[Tab][Tab]

Expected output:
--mode=snapshot --mode=stable

• Case 3: Verify direct completion

ide upgrade --mode=st[Tab]

Expected output: the command is automatically completed with the matched value.
ide upgrade --mode=stable

---

Checklist for this PR

Make sure everything is checked before merging this PR. For further info please also see
our DoD.

• When running mvn clean test locally all tests pass and build is successful
• PR title is of the form #«issue-id»: «brief summary» (e.g. #921: fixed setup.bat). If no issue ID exists, title only.
• PR top-level comment summarizes what has been done and contains link to addressed issue(s)
• PR and issue(s) have suitable labels
• Issue is set to In Progress and assigned to you or there is no issue (might happen for very small PRs)
• You followed all coding conventions
• You have added the issue implemented by your PR in CHANGELOG.adoc unless issue is labeled
  with internal
• You have formulated clear instructions on how to test your contribution under "Testing instructions"

[coveralls]

Coverage Report for CI Build 29497379560

Coverage increased (+0.001%) to 72.507%

Details

• Coverage increased (+0.001%) from the base build.
• Patch coverage: No coverable lines changed in this PR.
• 2 coverage regressions across 2 files.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

2 previously-covered lines in 2 files lost coverage.

File	Lines Losing Coverage	Coverage
com/devonfw/tools/ide/tool/ide/IdeToolCommandlet.java	1	78.33%
com/devonfw/tools/ide/version/VersionSegment.java	1	90.55%

---

Coverage Stats

Relevant Lines:	16804
Covered Lines:	12703
Line Coverage:	75.6%
Relevant Branches:	7500
Covered Branches:	4919
Branch Coverage:	65.59%
Branches in Coverage %:	Yes
Coverage Strength:	3.2 hits per line

---

💛 - Coveralls

[oanding-blrng]

I was able to test the implemented auto-completion and can confirm that the described behaviour. After the suggestions this PR can move forward.

Example from my terminal after execution of `./build-local-dev.sh`.

[oanding-blrng]

As someone reading this for the first time, I would assume, that argument values are supported everywhere within ide .... If this is in fact true, it's fine.

In case, there are still places, auto-completion for argument values are not implemented yet, this could cause confusion or bug reports and should be changed.

[vivu001]

Agreed 😃. I’ll refine the wording slightly so it’s less likely to be misinterpreted.

[oanding-blrng]

Please also change the title of this PR to follow the rules of DoD:

PR title is of the form #«issue-id»: «brief summary» (e.g. #921: fixed setup.bat). If no issue ID exists, title only.