Release v2.0.22: Conflict Impact Analysis, package count, and optional impact analysis

- Added Conflict Impact Analysis (optional with --show-impact flag)
- Added --save-impact flag to save impact analysis to composer-update-impact.txt
- Added outdated packages count display
- Improved progress indicators for verification types
- Impact analysis now optional by default (less verbose)
- 14 fully supported use cases (previously 13)
- Code coverage: 99.58% lines, 90.91% methods
- All tests passing (140 tests, 689 assertions)
- Complete translations in all 31 supported languages
- Updated documentation (CHANGELOG, UPGRADING, USAGE)
- composer-update-impact.txt automatically added to .gitignore

Author: HecFranco

.gitignore

@@ -32,3 +32,5 @@ coverage.xml
 .env.local
 .env.*.local
 
+# Impact analysis output
+composer-update-impact.txt

README.md

@@ -62,7 +62,7 @@ The script uses a lightweight architecture for better maintainability:
   - Displaying formatted output from PHP
   - Extracting and executing commands for `--run` flag
 
-- **`process-updates.php`** (in vendor): Contains all the complex logic (~710 lines) including:
+- **`process-updates.php`** (in vendor): Contains all the complex logic (~643 lines) including:
   - Package processing and filtering
   - Framework detection and version constraints
   - Release information fetching
@@ -178,12 +178,12 @@ All documentation is available in the [`docs/`](docs/) directory:
 ### Project Documentation
 - **[CHANGELOG.md](docs/CHANGELOG.md)** - Version history and all notable changes
 - **[UPGRADING.md](docs/UPGRADING.md)** - Upgrade instructions and migration notes
+- **[Testing Documentation](docs/TESTING.md)** - Comprehensive testing guide including tests for new features
+- **[Implementation Roadmap](docs/IMPLEMENTATION_ROADMAP.md)** - Action plan for implementing not-yet-supported features, ordered by complexity and feasibility
 - **[Development Guide](docs/DEVELOPMENT.md)** - Development setup, testing, and CI/CD
 - **[CONTRIBUTING.md](docs/CONTRIBUTING.md)** - Guidelines for contributing to the project
 - **[BRANCHING.md](docs/BRANCHING.md)** - Branching strategy and workflow
 - **[I18N_STRATEGY.md](docs/I18N_STRATEGY.md)** - Internationalization (i18n) implementation strategy
-- **[LANGUAGES_PROPOSAL.md](docs/LANGUAGES_PROPOSAL.md)** - Additional languages proposal for future implementation
-- **[VERIFICATION.md](docs/VERIFICATION.md)** - Verification and testing documentation
 
 ## Contributing
 

bin/generate-composer-require.sh

@@ -126,13 +126,15 @@ EOF
 }
 
 # Parse arguments
-RUN_FLAG=""; SHOW_RELEASE_DETAIL=false; SHOW_RELEASE_INFO=false; VERBOSE=false; DEBUG=false
+RUN_FLAG=""; SHOW_RELEASE_DETAIL=false; SHOW_RELEASE_INFO=false; SHOW_IMPACT_ANALYSIS=false; SAVE_IMPACT_TO_FILE=false; VERBOSE=false; DEBUG=false
 for arg in "$@"; do
     case "$arg" in
         -h|--help) show_help; exit 0 ;;
         --run) RUN_FLAG="--run" ;;
         --release-info|--releases) SHOW_RELEASE_INFO=true ;;
         --release-detail|--release-full|--detail) SHOW_RELEASE_INFO=true; SHOW_RELEASE_DETAIL=true ;;
+        --show-impact|--impact) SHOW_IMPACT_ANALYSIS=true ;;
+        --save-impact) SAVE_IMPACT_TO_FILE=true; SHOW_IMPACT_ANALYSIS=true ;;
         -v|--verbose) VERBOSE=true ;;
         --debug) DEBUG=true; VERBOSE=true ;;
         --no-release-info|--skip-releases|--no-releases) SHOW_RELEASE_INFO=false ;;
@@ -222,10 +224,12 @@ rm -f /tmp/composer-outdated-$$.json
 [ "$DEBUG" = "true" ] && echo "🔍 $(get_msg debug_prefix)$(get_msg debug_passing_to_php)" >&2
 [ "$DEBUG" = "true" ] && echo "   - CONFIG_FILE: ${CONFIG_FILE:-none}" >&2
 [ "$DEBUG" = "true" ] && echo "   - SHOW_RELEASE_INFO: $SHOW_RELEASE_INFO" >&2
+[ "$DEBUG" = "true" ] && echo "   - SHOW_IMPACT_ANALYSIS: $SHOW_IMPACT_ANALYSIS" >&2
+[ "$DEBUG" = "true" ] && echo "   - SAVE_IMPACT_TO_FILE: $SAVE_IMPACT_TO_FILE" >&2
 [ "$DEBUG" = "true" ] && echo "   - DEBUG: $DEBUG" >&2
 [ "$DEBUG" = "true" ] && echo "   - PROCESSOR_PHP: $PROCESSOR_PHP" >&2
 
-(OUTDATED_JSON="$OUTDATED_JSON" COMPOSER_BIN="$COMPOSER_BIN" PHP_BIN="$PHP_BIN" CONFIG_FILE="$CONFIG_FILE" SHOW_RELEASE_INFO="$SHOW_RELEASE_INFO" DEBUG="$DEBUG" VERBOSE="$VERBOSE" "$PHP_BIN" -d date.timezone=UTC "$PROCESSOR_PHP" 2>&1 | grep -v '^Warning:' || true) > /tmp/composer-process-$$.out &
+(OUTDATED_JSON="$OUTDATED_JSON" COMPOSER_BIN="$COMPOSER_BIN" PHP_BIN="$PHP_BIN" CONFIG_FILE="$CONFIG_FILE" SHOW_RELEASE_INFO="$SHOW_RELEASE_INFO" SHOW_IMPACT_ANALYSIS="$SHOW_IMPACT_ANALYSIS" SAVE_IMPACT_TO_FILE="$SAVE_IMPACT_TO_FILE" DEBUG="$DEBUG" VERBOSE="$VERBOSE" "$PHP_BIN" -d date.timezone=UTC "$PROCESSOR_PHP" 2>&1 | grep -v '^Warning:' || true) > /tmp/composer-process-$$.out &
 PROCESS_PID=$!
 
 if [ "${DEBUG:-false}" = "true" ]; then

bin/generate-composer-require.yaml

@@ -17,6 +17,14 @@
 # Default: true
 check-dependencies: true
 
+# Note: The following features are automatically enabled when check-dependencies is true:
+# - Abandoned Package Detection: Automatically detects and warns about abandoned packages
+#   when they are filtered due to conflicts. Shows replacement package if available.
+# - Fallback Version Suggestions: When a package update conflicts with dependencies,
+#   the tool automatically searches for compatible older versions that satisfy all
+#   conflicting constraints and shows them as "Alternative solutions".
+# These features require no configuration and work automatically.
+
 # List of packages to ignore during update
 # Ignored packages will still be displayed in the output with their available versions,
 # but won't be included in the composer require commands.

bin/i18n/ar.php

@@ -31,6 +31,13 @@
     'packages_passed_check' => 'الحزم التي اجتازت فحص التبعيات:',
     'none' => '(لا شيء)',
     'conflicts_with' => 'يتعارض مع:',
+    'package_abandoned' => 'الحزمة مهجورة',
+    'replaced_by' => 'استبدلت بـ: %s',
+    'alternative_solutions' => 'حلول بديلة:',
+    'compatible_with_conflicts' => 'متوافق مع التبعيات المتعارضة',
+    'alternative_packages' => 'الحزم البديلة:',
+    'recommended_replacement' => 'استبدال موصى به',
+    'similar_functionality' => 'وظائف مماثلة',
 
     // Debug messages
     'debug_show_release_info' => 'showReleaseInfo = %s',
@@ -52,5 +59,16 @@
     'release_info' => 'معلومات الإصدار',
     'release_changelog' => 'سجل التغييرات',
     'release_view_on_github' => 'عرض على GitHub',
+    
+    // Progress messages
+    'checking_dependency_conflicts' => '⏳ التحقق من تعارضات التبعيات...',
+    'checking_abandoned_packages' => '⏳ التحقق من الحزم المهجورة...',
+    'searching_fallback_versions' => '⏳ البحث عن إصدارات احتياطية...',
+    'searching_alternative_packages' => '⏳ البحث عن حزم بديلة...',
+    'checking_maintainer_info' => '⏳ التحقق من معلومات المطور...',
+    
+    // Impact analysis
+    'impact_analysis' => 'تحليل التأثير: تحديث {package} إلى {version} سيؤثر على:',
+    'found_outdated_packages' => 'تم العثور على %d حزمة قديمة',
 ];
 

bin/i18n/bg.php

@@ -31,6 +31,13 @@
     'packages_passed_check' => 'Пакети, които преминаха проверката на зависимости:',
     'none' => '(няма)',
     'conflicts_with' => 'конфликтира с:',
+    'package_abandoned' => 'Пакетът е изоставен',
+    'replaced_by' => 'заменен с: %s',
+    'alternative_solutions' => 'Алтернативни решения:',
+    'compatible_with_conflicts' => 'съвместим с конфликтни зависимости',
+    'alternative_packages' => 'Алтернативни пакети:',
+    'recommended_replacement' => 'препоръчана замяна',
+    'similar_functionality' => 'подобна функционалност',
 
     // Debug messages
     'debug_show_release_info' => 'showReleaseInfo = %s',
@@ -52,5 +59,16 @@
     'release_info' => 'Информация за изданието',
     'release_changelog' => 'Дневник на промените',
     'release_view_on_github' => 'Преглед в GitHub',
+    
+    // Progress messages
+    'checking_dependency_conflicts' => '⏳ Проверка на конфликти на зависимости...',
+    'checking_abandoned_packages' => '⏳ Проверка на изоставени пакети...',
+    'searching_fallback_versions' => '⏳ Търсене на резервни версии...',
+    'searching_alternative_packages' => '⏳ Търсене на алтернативни пакети...',
+    'checking_maintainer_info' => '⏳ Проверка на информация за поддръжка...',
+    
+    // Impact analysis
+    'impact_analysis' => 'Анализ на въздействието: Актуализирането на {package} до {version} ще засегне:',
+    'found_outdated_packages' => 'Намерени %d остарели пакета',
 ];
 

bin/i18n/cs.php

@@ -31,6 +31,13 @@
     'packages_passed_check' => 'Balíčky, které prošly kontrolou závislostí:',
     'none' => '(žádné)',
     'conflicts_with' => 'konfliktuje s:',
+    'package_abandoned' => 'Balíček je opuštěn',
+    'replaced_by' => 'nahrazen: %s',
+    'alternative_solutions' => 'Alternativní řešení:',
+    'compatible_with_conflicts' => 'kompatibilní s konfliktními závislostmi',
+    'alternative_packages' => 'Alternativní balíčky:',
+    'recommended_replacement' => 'doporučená náhrada',
+    'similar_functionality' => 'podobná funkcionalita',
 
     // Debug messages
     'debug_show_release_info' => 'showReleaseInfo = %s',
@@ -52,5 +59,16 @@
     'release_info' => 'Informace o verzi',
     'release_changelog' => 'Seznam změn',
     'release_view_on_github' => 'Zobrazit na GitHubu',
+    
+    // Progress messages
+    'checking_dependency_conflicts' => '⏳ Kontrola konfliktů závislostí...',
+    'checking_abandoned_packages' => '⏳ Kontrola opuštěných balíčků...',
+    'searching_fallback_versions' => '⏳ Vyhledávání záložních verzí...',
+    'searching_alternative_packages' => '⏳ Vyhledávání alternativních balíčků...',
+    'checking_maintainer_info' => '⏳ Kontrola informací o správci...',
+    
+    // Impact analysis
+    'impact_analysis' => 'Analýza dopadu: Aktualizace {package} na {version} by ovlivnila:',
+    'found_outdated_packages' => 'Nalezeno %d zastaralých balíčků',
 ];
 

bin/i18n/da.php

@@ -31,6 +31,13 @@
     'packages_passed_check' => 'Pakker, der bestod afhængighedstjekket:',
     'none' => '(ingen)',
     'conflicts_with' => 'konflikt med:',
+    'package_abandoned' => 'Pakken er forladt',
+    'replaced_by' => 'erstattet af: %s',
+    'alternative_solutions' => 'Alternative løsninger:',
+    'compatible_with_conflicts' => 'kompatibel med konflikterende afhængigheder',
+    'alternative_packages' => 'Alternative pakker:',
+    'recommended_replacement' => 'anbefalet erstatning',
+    'similar_functionality' => 'lignende funktionalitet',
 
     // Debug messages
     'debug_show_release_info' => 'showReleaseInfo = %s',
@@ -52,5 +59,16 @@
     'release_info' => 'Versionsinformation',
     'release_changelog' => 'Ændringslog',
     'release_view_on_github' => 'Se på GitHub',
+    
+    // Progress messages
+    'checking_dependency_conflicts' => '⏳ Tjekker afhængighedskonflikter...',
+    'checking_abandoned_packages' => '⏳ Tjekker forladte pakker...',
+    'searching_fallback_versions' => '⏳ Søger efter fallback-versioner...',
+    'searching_alternative_packages' => '⏳ Søger efter alternative pakker...',
+    'checking_maintainer_info' => '⏳ Tjekker maintainer-information...',
+    
+    // Impact analysis
+    'impact_analysis' => 'Påvirkningsanalyse: Opdatering af {package} til {version} ville påvirke:',
+    'found_outdated_packages' => 'Fundet %d forældede pakker',
 ];
 

bin/i18n/de.php

@@ -31,6 +31,13 @@
     'packages_passed_check' => 'Pakete, die die Abhängigkeitsprüfung bestanden haben:',
     'none' => '(keine)',
     'conflicts_with' => 'Konflikt mit:',
+    'package_abandoned' => 'Paket ist eingestellt',
+    'replaced_by' => 'ersetzt durch: %s',
+    'alternative_solutions' => 'Alternative Lösungen:',
+    'compatible_with_conflicts' => 'kompatibel mit widersprüchlichen Abhängigkeiten',
+    'alternative_packages' => 'Alternative Pakete:',
+    'recommended_replacement' => 'empfohlene Ersetzung',
+    'similar_functionality' => 'ähnliche Funktionalität',
 
     // Debug messages
     'debug_show_release_info' => 'showReleaseInfo = %s',
@@ -52,5 +59,16 @@
     'release_info' => 'Versionsinformationen',
     'release_changelog' => 'Änderungsprotokoll',
     'release_view_on_github' => 'Auf GitHub anzeigen',
+    
+    // Progress messages
+    'checking_dependency_conflicts' => '⏳ Überprüfung von Abhängigkeitskonflikten...',
+    'checking_abandoned_packages' => '⏳ Überprüfung auf eingestellte Pakete...',
+    'searching_fallback_versions' => '⏳ Suche nach Fallback-Versionen...',
+    'searching_alternative_packages' => '⏳ Suche nach alternativen Paketen...',
+    'checking_maintainer_info' => '⏳ Überprüfung der Maintainer-Informationen...',
+    
+    // Impact analysis
+    'impact_analysis' => 'Auswirkungsanalyse: Aktualisierung von {package} auf {version} würde beeinflussen:',
+    'found_outdated_packages' => '%d veraltete Paket(e) gefunden',
 ];
 

bin/i18n/el.php

@@ -31,6 +31,13 @@
     'packages_passed_check' => 'Πακέτα που πέρασαν τον έλεγχο εξαρτήσεων:',
     'none' => '(κανένα)',
     'conflicts_with' => 'σύγκρουση με:',
+    'package_abandoned' => 'Το πακέτο έχει εγκαταλειφθεί',
+    'replaced_by' => 'αντικαταστάθηκε από: %s',
+    'alternative_solutions' => 'Εναλλακτικές λύσεις:',
+    'compatible_with_conflicts' => 'συμβατό με συγκρουόμενες εξαρτήσεις',
+    'alternative_packages' => 'Εναλλακτικά πακέτα:',
+    'recommended_replacement' => 'συνιστώμενη αντικατάσταση',
+    'similar_functionality' => 'παρόμοια λειτουργικότητα',
 
     // Debug messages
     'debug_show_release_info' => 'showReleaseInfo = %s',
@@ -52,5 +59,16 @@
     'release_info' => 'Πληροφορίες Έκδοσης',
     'release_changelog' => 'Αρχείο Αλλαγών',
     'release_view_on_github' => 'Προβολή στο GitHub',
+    
+    // Progress messages
+    'checking_dependency_conflicts' => '⏳ Έλεγχος συγκρούσεων εξαρτήσεων...',
+    'checking_abandoned_packages' => '⏳ Έλεγχος εγκαταλελειμμένων πακέτων...',
+    'searching_fallback_versions' => '⏳ Αναζήτηση εφεδρικών εκδόσεων...',
+    'searching_alternative_packages' => '⏳ Αναζήτηση εναλλακτικών πακέτων...',
+    'checking_maintainer_info' => '⏳ Έλεγχος πληροφοριών συντηρητή...',
+    
+    // Impact analysis
+    'impact_analysis' => 'Ανάλυση αντίκτυπου: Η ενημέρωση του {package} στην {version} θα επηρέαζε:',
+    'found_outdated_packages' => 'Βρέθηκαν %d ξεπερασμένα πακέτα',
 ];