#1602: Being offline can block ide startup

[maybeec]

Description

Fixes issue #1602: Being offline can block IDE startup when a tool update is available but not cached.

Changes

Core Fix

• AbstractToolRepository.java: Enhanced doDownload() to check if download is already cached before throwing CliOfflineException in offline mode
• LocalToolCommandlet.java:
  • Modified performToolInstallation() to return VersionIdentifier indicating which version was actually installed
  • Added proper offline fallback logic that returns existing installed version when download fails
  • Fixed installation path calculation to use actual installed version instead of requested version

Supporting Changes

• Python.java: Updated override to match new performToolInstallation() signature
• PackageManagerBasedLocalToolCommandlet.java: Updated override to match new signature

Tests

Added comprehensive test coverage in InstallCommandletTest.java:

• testInstallCommandletOfflineWithCachedDownload: Fresh install with cached download succeeds
• testInstallCommandletOfflineWithoutCachedDownload: Fresh install without cache fails appropriately
• testInstallCommandletOfflineUpdateWithoutCachedDownload: Update scenario keeps old version when new version not cached

Documentation

• Updated CHANGELOG.adoc with issue Being offline can block ide startup #1602 entry

Testing

All offline scenario tests pass successfully:

Tests run: 3, Failures: 0, Errors: 0, Skipped: 0

Checklist

• Code compiles successfully
• New tests added and passing
• Coding conventions followed (AssertJ for assertions, proper error handling)
• CHANGELOG.adoc updated
• Design reviewed and refactored to avoid duplication
• Commit message follows format: #1602: Being offline can block ide startup

Related Issue

Closes #1602

[coveralls]

Pull Request Test Coverage Report for Build 20815662835

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• 61 unchanged lines in 3 files lost coverage.
• Overall coverage increased (+0.04%) to 69.937%

---

Files with Coverage Reduction	New Missed Lines	%
com/devonfw/tools/ide/tool/python/Python.java	3	73.53%
com/devonfw/tools/ide/tool/repository/AbstractToolRepository.java	28	67.24%
com/devonfw/tools/ide/tool/LocalToolCommandlet.java	30	80.65%

Totals
Change from base Build 20815639483:	0.04%
Covered Lines:	10202
Relevant Lines:	14011

---

💛 - Coveralls