[MNG-8765] Maven Upgrade Tool (#2407)

## Maven Upgrade Tool (mvnup)
- New `mvnup` command-line tool with check/apply workflow
- Automatic POM discovery and multi-module project support
- Model version upgrades from 4.0.0 to 4.1.0 with namespace updates
- Intelligent inference to remove redundant information in Maven 4.1.0+ models
- Comprehensive plugin compatibility upgrades for Maven 4

### Plugin Compatibility & Upgrades
- Automatic plugin version upgrades for Maven 4 compatibility:
  * `maven-exec-plugin` → 3.2.0+
  * `maven-enforcer-plugin` → 3.0.0+
  * `flatten-maven-plugin` → 1.2.7+
  * `maven-shade-plugin` → 3.5.0+
  * `maven-remote-resources-plugin` → 3.0.0+
- Parent POM plugin detection with proper XML formatting
- Plugin management section creation with correct element ordering
- Property-based version management support

### Maven 4 Compatibility Fixes
- Fix unsupported `combine.children` attributes (`override` → `merge`)
- Fix unsupported `combine.self` attributes (`append` → `merge`)
- Remove duplicate dependencies in `dependencyManagement` sections
- Remove duplicate plugins in `pluginManagement` sections
- Comment out repositories with unsupported expressions
- Fix incorrect `parent.relativePath` pointing to non-existent POMs
- Create `.mvn` directory when not upgrading to 4.1.0 to avoid warnings

### Intelligent Model Inference
- Parent element trimming when parent is in same project
- Managed dependency removal for project artifacts
- Redundant subprojects list removal when matching direct children
- GroupId/version inference from parent when using relativePath
- Dependency inference that reverses Maven's resolution logic

### Advanced XML Processing
- Intelligent indentation detection supporting 2/4 spaces and tabs
- Document-wide formatting consistency preservation
- Proper element ordering following Maven POM schema standards
- pluginManagement placement before plugins sections
- Comprehensive JDOM-based XML manipulation with formatting preservation

Author: gnodet

apache-maven/src/assembly/component.xml

@@ -87,6 +87,7 @@ under the License.
         <include>mvn</include>
         <include>mvnenc</include>
         <include>mvnsh</include>
+        <include>mvnup</include>
         <include>mvnDebug</include>
         <include>mvnencDebug</include>
         <!-- This is so that CI systems can periodically run the profiler -->

apache-maven/src/assembly/maven/bin/mvn

@@ -228,6 +228,9 @@ handle_args() {
       --shell)
         MAVEN_MAIN_CLASS="org.apache.maven.cling.MavenShellCling"
         ;;
+      --up)
+        MAVEN_MAIN_CLASS="org.apache.maven.cling.MavenUpCling"
+        ;;
       *)
         ;;
     esac

apache-maven/src/assembly/maven/bin/mvn.cmd

@@ -179,22 +179,22 @@ if not exist "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadJvmConfig
 set JVM_CONFIG_MAVEN_OPTS=
 for /F "usebackq tokens=* delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do (
     set "line=%%a"
-    
+
     rem Skip empty lines and full-line comments
     echo !line! | findstr /b /r /c:"[ ]*#" >nul
     if errorlevel 1 (
         rem Handle end-of-line comments by taking everything before #
         for /f "tokens=1* delims=#" %%i in ("!line!") do set "line=%%i"
-        
+
         rem Trim leading/trailing spaces while preserving spaces in quotes
         set "trimmed=!line!"
         for /f "tokens=* delims= " %%i in ("!trimmed!") do set "trimmed=%%i"
         for /l %%i in (1,1,100) do if "!trimmed:~-1!"==" " set "trimmed=!trimmed:~0,-1!"
-        
+
         rem Replace MAVEN_PROJECTBASEDIR placeholders
         set "trimmed=!trimmed:${MAVEN_PROJECTBASEDIR}=%MAVEN_PROJECTBASEDIR%!"
         set "trimmed=!trimmed:$MAVEN_PROJECTBASEDIR=%MAVEN_PROJECTBASEDIR%!"
-        
+
         if not "!trimmed!"=="" (
             if "!JVM_CONFIG_MAVEN_OPTS!"=="" (
                 set "JVM_CONFIG_MAVEN_OPTS=!trimmed!"
@@ -229,6 +229,8 @@ if "%~1"=="--debug" (
     set "MAVEN_MAIN_CLASS=org.apache.maven.cling.MavenEncCling"
 ) else if "%~1"=="--shell" (
       set "MAVEN_MAIN_CLASS=org.apache.maven.cling.MavenShellCling"
+) else if "%~1"=="--up" (
+      set "MAVEN_MAIN_CLASS=org.apache.maven.cling.MavenUpCling"
 )
 exit /b 0
 

apache-maven/src/assembly/maven/bin/mvnup

@@ -0,0 +1,30 @@
+#!/bin/sh
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# -----------------------------------------------------------------------------
+# Apache Maven Upgrade Script
+#
+# Environment Variable Prerequisites
+#
+#   JAVA_HOME           (Optional) Points to a Java installation.
+#   MAVEN_OPTS          (Optional) Java runtime options used when Maven is executed.
+#   MAVEN_SKIP_RC       (Optional) Flag to disable loading of mavenrc files.
+# -----------------------------------------------------------------------------
+
+"`dirname "$0"`/mvn" --up "$@"

apache-maven/src/assembly/maven/bin/mvnup.cmd

@@ -0,0 +1,37 @@
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    http://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+
+@REM -----------------------------------------------------------------------------
+@REM Apache Maven Upgrade Script
+@REM
+@REM Environment Variable Prerequisites
+@REM
+@REM   JAVA_HOME           (Optional) Points to a Java installation.
+@REM   MAVEN_OPTS          (Optional) Java runtime options used when Maven is executed.
+@REM   MAVEN_SKIP_RC       (Optional) Flag to disable loading of mavenrc files.
+@REM -----------------------------------------------------------------------------
+
+@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
+@echo off
+@REM set title of command window
+title %0
+@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on'
+@if "%MAVEN_BATCH_ECHO%"=="on" echo %MAVEN_BATCH_ECHO%
+
+@setlocal
+
+@call "%~dp0"mvn.cmd --up %*

apache-maven/src/main/appended-resources/META-INF/LICENSE.vm

@@ -39,21 +39,22 @@ subject to the terms and conditions of the following licenses:
 #*      *##set ( $spdx = 'EPL-1.0' )
 #*    *##elseif ( $license.name == "Eclipse Public License, Version 2.0" )
 #*      *##set ( $spdx = 'EPL-2.0' )
-#*    *##elseif ( $license.url.contains( "www.apache.org/licenses/LICENSE-2.0" ) )
+#*    *##elseif ( $license.url.contains( "www.apache.org/licenses/LICENSE-2.0" )
+                    || $license.url.contains( "https://raw.github.com/hunterhacker/jdom/master/LICENSE.txt" ) )
 #*      *##set ( $spdx = 'Apache-2.0' )
 #*    *##elseif ( $license.name == "BSD-2-Clause" || $license.name == "The BSD 2-Clause License"
-                    || $license.url.contains("www.opensource.org/licenses/bsd-license") )
+                    || $license.url.contains( "www.opensource.org/licenses/bsd-license" ) )
 #*      *##set ( $spdx = 'BSD-2-Clause' )
 #*    *##elseif ( $license.name == "BSD-3-Clause"
-                    || $license.url.contains("opensource.org/licenses/BSD-3-Clause") )
+                    || $license.url.contains( "opensource.org/licenses/BSD-3-Clause" ) )
 #*      *##set ( $spdx = 'BSD-3-Clause' )
 #*    *##elseif ( $license.name == "Public Domain" )
 #*      *##set ( $spdx = 'Public-Domain' )
 #*    *##elseif ( $license.name == "CDDL + GPLv2 with classpath exception" )
 #*      *##set ( $spdx = 'CDDL+GPLv2-with-classpath-exception' )
 #*    *##else
 #*      *### unrecognized license will require analysis to know obligations
-#*      *##set ( $spdx = 'unrecognized' )
+#*      *##set ( $spdx = $license )
 #*    *##end
 #*    *###
 #*    *### fix project urls that are wrong in pom

api/maven-api-cli/src/main/java/org/apache/maven/api/cli/ParserRequest.java

@@ -229,6 +229,30 @@ static Builder mvnsh(@Nonnull List<String> args, @Nonnull MessageBuilderFactory
         return builder(Tools.MVNSHELL_CMD, Tools.MVNSHELL_NAME, args, messageBuilderFactory);
     }
 
+    /**
+     * Creates a new Builder instance for constructing a Maven Upgrade Tool ParserRequest.
+     *
+     * @param args the command-line arguments
+     * @param messageBuilderFactory the factory for creating message builders
+     * @return a new Builder instance
+     */
+    @Nonnull
+    static Builder mvnup(@Nonnull String[] args, @Nonnull MessageBuilderFactory messageBuilderFactory) {
+        return mvnup(Arrays.asList(args), messageBuilderFactory);
+    }
+
+    /**
+     * Creates a new Builder instance for constructing a Maven Upgrade Tool ParserRequest.
+     *
+     * @param args the command-line arguments
+     * @param messageBuilderFactory the factory for creating message builders
+     * @return a new Builder instance
+     */
+    @Nonnull
+    static Builder mvnup(@Nonnull List<String> args, @Nonnull MessageBuilderFactory messageBuilderFactory) {
+        return builder(Tools.MVNUP_CMD, Tools.MVNUP_NAME, args, messageBuilderFactory);
+    }
+
     /**
      * Creates a new Builder instance for constructing a ParserRequest.
      *

api/maven-api-cli/src/main/java/org/apache/maven/api/cli/Tools.java

@@ -39,4 +39,7 @@ private Tools() {}
 
     public static final String MVNSHELL_CMD = "mvnsh";
     public static final String MVNSHELL_NAME = "Maven Shell Tool";
+
+    public static final String MVNUP_CMD = "mvnup";
+    public static final String MVNUP_NAME = "Maven Upgrade Tool";
 }

api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnup/UpgradeOptions.java

@@ -0,0 +1,123 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.maven.api.cli.mvnup;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.function.UnaryOperator;
+
+import org.apache.maven.api.annotations.Experimental;
+import org.apache.maven.api.annotations.Nonnull;
+import org.apache.maven.api.cli.Options;
+
+/**
+ * Defines the options specific to the Maven upgrade tool.
+ * This interface extends the general {@link Options} interface, adding upgrade-specific configuration options.
+ *
+ * @since 4.0.0
+ */
+@Experimental
+public interface UpgradeOptions extends Options {
+    /**
+     * Should the operation be forced (ie overwrite existing files, if any).
+     *
+     * @return an {@link Optional} containing the boolean value {@code true} if specified, or empty
+     */
+    Optional<Boolean> force();
+
+    /**
+     * Should imply "yes" to all questions.
+     *
+     * @return an {@link Optional} containing the boolean value {@code true} if specified, or empty
+     */
+    Optional<Boolean> yes();
+
+    /**
+     * Returns the list of upgrade goals to be executed.
+     * These goals can include operations like "check", "dependencies", "plugins", etc.
+     *
+     * @return an {@link Optional} containing the list of goals, or empty if not specified
+     */
+    @Nonnull
+    Optional<List<String>> goals();
+
+    /**
+     * Returns the target POM model version for upgrades.
+     * Supported values include "4.0.0" and "4.1.0".
+     *
+     * @return an {@link Optional} containing the model version, or empty if not specified
+     */
+    @Nonnull
+    Optional<String> modelVersion();
+
+    /**
+     * Returns the directory to use as starting point for POM discovery.
+     * If not specified, the current directory will be used.
+     *
+     * @return an {@link Optional} containing the directory path, or empty if not specified
+     */
+    @Nonnull
+    Optional<String> directory();
+
+    /**
+     * Should use inference when upgrading (remove redundant information).
+     *
+     * @return an {@link Optional} containing the boolean value {@code true} if specified, or empty
+     */
+    @Nonnull
+    Optional<Boolean> infer();
+
+    /**
+     * Should fix Maven 4 compatibility issues in POMs.
+     * This includes fixing unsupported combine attributes, duplicate dependencies,
+     * unsupported expressions, and other Maven 4 validation issues.
+     *
+     * @return an {@link Optional} containing the boolean value {@code true} if specified, or empty
+     */
+    @Nonnull
+    Optional<Boolean> model();
+
+    /**
+     * Should upgrade plugins known to fail with Maven 4 to their minimum compatible versions.
+     * This includes upgrading plugins like maven-exec-plugin, maven-enforcer-plugin,
+     * flatten-maven-plugin, and maven-shade-plugin to versions that work with Maven 4.
+     *
+     * @return an {@link Optional} containing the boolean value {@code true} if specified, or empty
+     */
+    @Nonnull
+    Optional<Boolean> plugins();
+
+    /**
+     * Should apply all upgrade options (equivalent to --model-version 4.1.0 --infer --model --plugins).
+     * This is a convenience option that combines model upgrade, inference, compatibility fixes, and plugin upgrades.
+     *
+     * @return an {@link Optional} containing the boolean value {@code true} if specified, or empty
+     */
+    @Nonnull
+    Optional<Boolean> all();
+
+    /**
+     * Returns a new instance of UpgradeOptions with values interpolated using the given properties.
+     *
+     * @param callback a callback to use for interpolation
+     * @return a new UpgradeOptions instance with interpolated values
+     */
+    @Nonnull
+    UpgradeOptions interpolate(UnaryOperator<String> callback);
+}

api/maven-api-cli/src/main/java/org/apache/maven/api/cli/mvnup/package-info.java

@@ -0,0 +1,38 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Provides the API for the Maven Upgrade tool ({@code mvnup}).
+ *
+ * <p>This package contains interfaces and classes for the Maven upgrade tool,
+ * which provides functionality for upgrading Maven projects and dependencies.</p>
+ *
+ * <p>Key features include:</p>
+ * <ul>
+ *   <li>Project upgrade capabilities</li>
+ *   <li>Dependency version management</li>
+ *   <li>Configuration migration</li>
+ *   <li>Interactive upgrade workflows</li>
+ * </ul>
+ *
+ * @see org.apache.maven.api.cli.Tools#MVNUP_CMD
+ * @see org.apache.maven.api.cli.Tools#MVNUP_NAME
+ * @since 4.0.0
+ */
+package org.apache.maven.api.cli.mvnup;