#2193: add alternatives and dependencies to auto-completion entries

[Hiepiscus]

This PR fixes #2193

This PR extends the auto-completion model with support for alternatives and dependencies between CompletionEntry objects.

Implemented changes:

• Extended CompletionEntry with alternative relationships.
  • Alternatives remain separate completion entries because they are different commands.
  • The relationship is symmetric, so adding one entry as an alternative links both entries.
  • Once one alternative or one of its synonyms has already been provided, the other entry is no longer suggested.
• Extended CompletionEntry with dependency groups.
  • Dependencies use OR logic within one group.
  • Multiple dependency groups use AND logic.
  • A completion entry is only suggested when every configured dependency group is satisfied.
  • Candidates and their synonyms are both considered when checking whether a dependency is satisfied.
• Addd convenience methods to AutoCompletionRegistry.
  • addAlternative(String, String) connects two previously registered completion entries.
  • addDependency(String, List<String>) registers an OR-dependency group for a previously registered entry.
  • Both methods fail with an IllegalStateException if a referenced candidate has not been registered with add(String).
• Changed Maven completion.
  • exec:java and exec:exec are registered as alternatives.
  • -Dexec.mainClass= depends on exec:java.
  • -Dexec.args= depends on either exec:java or exec:exec.
• Changed CompleteTest:
  • Add tests for alternative candidates and dependency completion filtering.

---

Testing instructions

1. Run build-local-dev.sh
2. In the console type ide mvn exec:exec and use the auto completion with <tab><tab>
3. Verify that the output should not contain exec:java
4. Type ide mvn -D and use <tab><tab>
5. Verify that -Dexec.mainClass= or -Dexec.args= is not in the output
6. Type ide mvn exec:java -D and use `
7. Verify that the output should contain -Dexec.mainClass= or -Dexec.args=
8. Type ide mvn exec:exec -D and use <tab><tab>
9. Verify that the output should contain -Dexec.args= and does not contain -Dexec.mainClass=.

---

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 and not feature/921 fixed setup.bat). If no issue ID exists, title only.
• PR top-level comment summaries 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 labelled
  with internal
• You have not changed any dependency in pom.xml files or otherwise if runtime dependencies changed, you have updated our LICENSE.asciidoc
• You have formulated clear instructions on how to test your contribution under "Testing instructions"

[coveralls]

Coverage Report for CI Build 33607517526

Coverage increased (+0.02%) to 73.63%

Details

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

Uncovered Changes

No uncovered changes found.

Coverage Regressions

7 previously-covered lines in 3 files lost coverage.

File	Lines Losing Coverage	Coverage
com/devonfw/tools/ide/completion/AutoCompletionRegistry.java	4	82.0%
com/devonfw/tools/ide/completion/CompletionEntry.java	2	89.89%
com/devonfw/tools/ide/version/VersionSegment.java	1	90.03%

---

Coverage Stats

Relevant Lines:	18419
Covered Lines:	14181
Line Coverage:	76.99%
Relevant Branches:	8176
Covered Branches:	5401
Branch Coverage:	66.06%
Branches in Coverage %:	Yes
Coverage Strength:	3.28 hits per line

---

💛 - Coveralls

[samuelkos17]

Great work on adding alternatives and dependencies to the auto-completion entries! I've followed your testing instructions and everything worked fine. On Step 9 you wrote that the output should only contain -Dexec.args= but I guess you meant it should contain -Dexec.args= but not -Dexec.mainClass=. If that's true then everything worked as intended and you can move it to In Review 😄. Also you might have to change the Changelog entry to the next release but i couldn't flag it since this branch isn't up-to-date with main.

[Hiepiscus]

On Step 9 you wrote that the output should only contain -Dexec.args= but I guess you meant it should contain -Dexec.args= but not -Dexec.mainClass=

@samuelkos17 Thanks for the review! You are correct. I meant that the output should contain -Dexec.args= but not -Dexec.mainClass=. I have updated the test instructions accordingly.