Release v2.0.23: YAML configuration for command-line options and Wildcard Dependency Checking

New Features:
- Command-line options configuration in YAML: Set default values for all command-line options in generate-composer-require.yaml
  - Available options: show-release-info, show-release-detail, show-impact-analysis, save-impact-to-file, verbose, debug
  - Command-line arguments always override YAML configuration
  - Benefits: Consistent defaults for team members, no need to remember long flags
- Wildcard Dependency Checking: Extended dependency conflict detection to support wildcard constraints (^, ~, *)
  - Previously, dependency checking was skipped for packages with wildcard constraints
  - Now properly validates wildcard constraints against dependent package requirements
  - Improves conflict detection accuracy for framework constraints and version ranges

Improvements:
- Updated UPDATE_CASES.md: 15 fully supported cases (previously 14)
- Updated IMPLEMENTATION_ROADMAP.md: Priority 7 (Wildcard Dependency Checking) completed
- Updated CONFIGURATION.md: Added section for command-line options configuration
- Updated README.md: Added examples and documentation for YAML configuration
- Updated UPGRADING.md: Added migration notes for new features

Quality:
- All tests passing (140 tests, 689 assertions)
- Code syntax verified (bash and PHP)
- All classes loadable and functional
- Code formatting corrected (PHP-CS-Fixer)

See CHANGELOG.md for complete details.

Author: HecFranco

README.md

@@ -23,10 +23,12 @@ Generates `composer require` commands from outdated dependencies. Works with any
 - ✅ Compares versions to avoid unnecessary updates
 - ✅ **Dependency compatibility checking**: Automatically detects and prevents dependency conflicts before suggesting updates
 - ✅ **Transitive dependency suggestions**: When conflicts are detected, automatically suggests updating required transitive dependencies with ready-to-use commands
+- ✅ **Conflict Impact Analysis**: Analyzes which packages would be affected by updating conflicting packages (optional with `--show-impact` flag)
+- ✅ **Save impact analysis**: Save impact analysis to file with `--save-impact` flag
 - ✅ Can execute commands directly with `--run` flag
 - ✅ Automatic installation via Composer plugin
 - ✅ **Release information and changelogs**: Shows GitHub release links and changelog previews for outdated packages
-- ✅ **Progress indicators**: Animated spinner shows activity during long-running operations
+- ✅ **Progress indicators**: Shows loading messages during long-running operations (dependency checking, fallback search, etc.)
 - ✅ **Help option**: Built-in `--help` flag for comprehensive usage information
 - ✅ **Verbose and Debug modes**: `-v, --verbose` and `--debug` options for troubleshooting and detailed information
 - ✅ **Multiple file extensions**: Supports both `.yaml` and `.yml` extensions for configuration files
@@ -86,6 +88,24 @@ The script automatically detects `process-updates.php` in `vendor/nowo-tech/comp
 # Execute commands directly
 ./generate-composer-require.sh --run
 
+# Show release information
+./generate-composer-require.sh --release-info
+
+# Show full changelogs
+./generate-composer-require.sh --release-detail
+
+# Show impact analysis for conflicting packages
+./generate-composer-require.sh --show-impact
+
+# Save impact analysis to file
+./generate-composer-require.sh --save-impact
+
+# Verbose output
+./generate-composer-require.sh --verbose
+
+# Debug mode
+./generate-composer-require.sh --debug
+
 # Show help
 ./generate-composer-require.sh --help
 ```
@@ -104,20 +124,23 @@ Example output:
 > **Note:** By default, release information is **not shown** (no API calls are made). Use `--release-info` or `--release-detail` to enable it.
 
 **Available options:**
-- `--run` - Execute suggested commands
-- `--release-info` - Show release summary
-- `--release-detail` - Show full changelog
-- `-v, --verbose` - Show detailed information
-- `--debug` - Show debug information
-- `-h, --help` - Show help
+- `--run` - Execute suggested commands automatically
+- `--release-info` - Show release information (summary with links)
+- `--release-detail` - Show full release changelog for each package (implies `--release-info`)
+- `--no-release-info` - Skip release information section (default behavior)
+- `--show-impact, --impact` - Show impact analysis for conflicting packages (disabled by default)
+- `--save-impact` - Save impact analysis to `composer-update-impact.txt` file (implies `--show-impact`)
+- `-v, --verbose` - Show verbose output (configuration files, packages, etc.)
+- `--debug` - Show debug information (very detailed, includes file paths, parsing, etc.)
+- `-h, --help` - Show help message
 
 For detailed usage information, see [Usage Guide](docs/USAGE.md).
 
 ## Configuration
 
 The script searches for configuration files in the current directory (where `composer.json` is located). It supports both `.yaml` and `.yml` extensions, with `.yaml` taking priority.
 
-Edit `generate-composer-require.yaml` to configure which packages to ignore or force include during updates:
+Edit `generate-composer-require.yaml` to configure which packages to ignore or force include during updates, and set default values for command-line options:
 
 ```yaml
 # Composer Update Helper Configuration
@@ -138,6 +161,15 @@ check-dependencies: true
 # ⚠️  WARNING: i18n feature is currently in DEVELOPMENT MODE
 #language: es
 
+# Command-line options defaults (can be overridden via command-line arguments)
+# Set your preferred defaults here, then override them when needed via command-line flags
+show-release-info: false          # Show release information by default
+show-release-detail: false        # Show full changelog by default
+show-impact-analysis: false       # Show impact analysis by default
+save-impact-to-file: false       # Save impact analysis to file by default
+verbose: false                    # Verbose output by default
+debug: false                     # Debug mode by default
+
 # 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.
@@ -156,6 +188,8 @@ include:
   - another/package
 ```
 
+> 💡 **Tip**: Command-line arguments always override YAML configuration. For example, if you set `show-release-info: true` in YAML but run `./generate-composer-require.sh --no-release-info`, the release info will be disabled for that run.
+
 For detailed configuration options including language settings, dependency checking, and backward compatibility, see [Configuration Guide](docs/CONFIGURATION.md).
 
 For framework support details, see [Framework Support](docs/FRAMEWORKS.md).

bin/generate-composer-require.sh

@@ -125,8 +125,82 @@ EOF
     fi
 }
 
-# Parse arguments
-RUN_FLAG=""; SHOW_RELEASE_DETAIL=false; SHOW_RELEASE_INFO=false; SHOW_IMPACT_ANALYSIS=false; SAVE_IMPACT_TO_FILE=false; VERBOSE=false; DEBUG=false
+# Helper function to read YAML config value using PHP (if available)
+read_yaml_config_value() {
+    local yaml_file="$1"
+    local key="$2"
+    local default="$3"
+
+    if [ ! -f "$yaml_file" ]; then
+        echo "$default"
+        return
+    fi
+
+    # Try to use PHP if available (more reliable)
+    if command -v php >/dev/null 2>&1; then
+        local php_code="
+        \$content = @file_get_contents('$yaml_file');
+        if (!\$content) { echo '$default'; exit; }
+        \$lines = explode(\"\\n\", \$content);
+        foreach (\$lines as \$line) {
+            \$line = trim(\$line);
+            if (empty(\$line) || strpos(\$line, '#') === 0) continue;
+            if (preg_match('/^' . preg_quote('$key', '/') . ':\\\\s*(.+)\$/', \$line, \$matches)) {
+                \$value = trim(\$matches[1]);
+                if (strtolower(\$value) === 'true') { echo 'true'; exit; }
+                if (strtolower(\$value) === 'false') { echo 'false'; exit; }
+                echo \$value; exit;
+            }
+        }
+        echo '$default';
+        "
+        php -r "$php_code" 2>/dev/null || echo "$default"
+    else
+        # Fallback: simple grep (less reliable)
+        local value=$(grep -E "^${key}:" "$yaml_file" 2>/dev/null | head -1 | sed 's/^[^:]*:[[:space:]]*//' | tr -d '\n')
+        if [ -n "$value" ]; then
+            echo "$value"
+        else
+            echo "$default"
+        fi
+    fi
+}
+
+# Detect config file early (before parsing arguments) to read defaults
+config_info=$(detect_config_file)
+CONFIG_FILE=$(echo "$config_info" | cut -d'|' -f1)
+CONFIG_FILE_DISPLAY=$(echo "$config_info" | cut -d'|' -f2)
+CONFIG_FILE_SUFFIX=$(echo "$config_info" | cut -d'|' -f3)
+
+# Read default values from YAML config (if config file exists)
+if [ -n "$CONFIG_FILE" ] && [ -f "$CONFIG_FILE" ]; then
+    # Read boolean config values (default to false)
+    YAML_SHOW_RELEASE_INFO=$(read_yaml_config_value "$CONFIG_FILE" "show-release-info" "false")
+    YAML_SHOW_RELEASE_DETAIL=$(read_yaml_config_value "$CONFIG_FILE" "show-release-detail" "false")
+    YAML_SHOW_IMPACT_ANALYSIS=$(read_yaml_config_value "$CONFIG_FILE" "show-impact-analysis" "false")
+    YAML_SAVE_IMPACT_TO_FILE=$(read_yaml_config_value "$CONFIG_FILE" "save-impact-to-file" "false")
+    YAML_VERBOSE=$(read_yaml_config_value "$CONFIG_FILE" "verbose" "false")
+    YAML_DEBUG=$(read_yaml_config_value "$CONFIG_FILE" "debug" "false")
+else
+    # No config file, use defaults
+    YAML_SHOW_RELEASE_INFO="false"
+    YAML_SHOW_RELEASE_DETAIL="false"
+    YAML_SHOW_IMPACT_ANALYSIS="false"
+    YAML_SAVE_IMPACT_TO_FILE="false"
+    YAML_VERBOSE="false"
+    YAML_DEBUG="false"
+fi
+
+# Convert YAML values to boolean (normalize true/false strings)
+[ "$YAML_SHOW_RELEASE_INFO" = "true" ] && SHOW_RELEASE_INFO=true || SHOW_RELEASE_INFO=false
+[ "$YAML_SHOW_RELEASE_DETAIL" = "true" ] && SHOW_RELEASE_DETAIL=true || SHOW_RELEASE_DETAIL=false
+[ "$YAML_SHOW_IMPACT_ANALYSIS" = "true" ] && SHOW_IMPACT_ANALYSIS=true || SHOW_IMPACT_ANALYSIS=false
+[ "$YAML_SAVE_IMPACT_TO_FILE" = "true" ] && SAVE_IMPACT_TO_FILE=true || SAVE_IMPACT_TO_FILE=false
+[ "$YAML_VERBOSE" = "true" ] && VERBOSE=true || VERBOSE=false
+[ "$YAML_DEBUG" = "true" ] && DEBUG=true || DEBUG=false
+
+# Parse arguments (command line arguments override YAML defaults)
+RUN_FLAG=""
 for arg in "$@"; do
     case "$arg" in
         -h|--help) show_help; exit 0 ;;
@@ -156,11 +230,8 @@ ${SCRIPT_DIR}/process-updates.php
 PROCESSOR_PHP=$(find_file_in_paths "$PROCESSOR_PATHS")
 [ -z "$PROCESSOR_PHP" ] && echo "❌  $(get_msg processor_not_found)" >&2 && echo "   $(get_msg please_install)" >&2 && exit 1
 
-# Detect config file (delegates to helper)
-config_info=$(detect_config_file)
-CONFIG_FILE=$(echo "$config_info" | cut -d'|' -f1)
-CONFIG_FILE_DISPLAY=$(echo "$config_info" | cut -d'|' -f2)
-CONFIG_FILE_SUFFIX=$(echo "$config_info" | cut -d'|' -f3)
+# Config file already detected above (before parsing arguments)
+# CONFIG_FILE, CONFIG_FILE_DISPLAY, CONFIG_FILE_SUFFIX are already set
 
 # Initialize language for translations after detecting config file
 if command -v t >/dev/null 2>&1 && command -v load_translations_sh >/dev/null 2>&1; then

bin/generate-composer-require.yaml

@@ -15,8 +15,51 @@
 # When disabled (false), the tool will suggest all available updates without checking
 # dependency compatibility (faster but may suggest incompatible updates).
 # Default: true
+# Can be overridden with command line arguments
 check-dependencies: true
 
+# Show release information by default
+# When enabled (true), shows release summary with links to GitHub releases and changelogs.
+# When disabled (false), no API calls are made for release information (faster execution).
+# Default: false
+# Can be overridden with --release-info, --release-detail, or --no-release-info
+show-release-info: false
+
+# Show full release changelog by default
+# When enabled (true), shows full changelog for each package (implies show-release-info).
+# When disabled (false), only shows release summary if show-release-info is enabled.
+# Default: false
+# Can be overridden with --release-detail or --no-release-info
+show-release-detail: false
+
+# Show impact analysis for conflicting packages by default
+# When enabled (true), shows which packages would be affected by updating conflicting packages.
+# When disabled (false), impact analysis is not shown (reduces output verbosity).
+# Default: false
+# Can be overridden with --show-impact, --impact, or --save-impact
+show-impact-analysis: false
+
+# Save impact analysis to file by default
+# When enabled (true), saves impact analysis to composer-update-impact.txt (implies show-impact-analysis).
+# When disabled (false), impact analysis is only shown in output if show-impact-analysis is enabled.
+# Default: false
+# Can be overridden with --save-impact
+save-impact-to-file: false
+
+# Verbose output by default
+# When enabled (true), shows detailed information including configuration files and packages.
+# When disabled (false), shows only essential information.
+# Default: false
+# Can be overridden with -v, --verbose, or --debug
+verbose: false
+
+# Debug mode by default
+# When enabled (true), shows very detailed debug information including file paths and parsing details.
+# When disabled (false), debug information is not shown.
+# Default: false
+# Can be overridden with --debug
+debug: false
+
 # 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.