feat: implement URL replacements for enterprise networks

This commit implements comprehensive URL replacement functionality for enterprise
environments, along with shell integration, environment management improvements,
and enhanced test reliability.

**URL Replacement Features:**
- Global URL replacement configuration in ~/.mvx/config.json5
- Support for simple string replacements (github.com -> nexus.internal)
- Support for regex replacements with capture groups
- CLI commands for managing URL replacements
- Automatic integration with all tool downloads
- First-match-wins processing for predictable behavior
- Comprehensive validation for regex patterns

**New CLI Commands:**
- mvx config show - Display current global configuration
- mvx config set-url-replacement <pattern> <replacement>
- mvx config remove-url-replacement <pattern>
- mvx config clear-url-replacements
- mvx config edit - Open config file in editor

**Shell Integration Features:**
- mvx shell command for executing commands in mvx environment
- Shell activation support for automatic environment setup
- Cross-platform shell hooks and activation scripts
- mvx activate/deactivate commands for shell integration
- mvx env command for environment variable management

**Environment Management Improvements:**
- Safe environment variable management with EnvironmentManager
- Intelligent PATH handling with deduplication
- Change detection to reduce verbose logging noise
- Track original environment variable values
- Only log actual environment changes, not passthrough values

**Test Reliability Improvements:**
- Fix Java executable detection to prevent bin/bin/java path errors
- Add proper working directory restoration in test cleanup
- Skip 'bin' directories when searching for nested Java installations
- Add comprehensive Java installation debug test for CI troubleshooting
- Improved test isolation to prevent cross-test contamination

**Technical Implementation:**
- Added pkg/config/global.go for global configuration management
- Added pkg/tools/url_replacements.go for URL replacement logic
- Added pkg/tools/environment.go for safe environment variable management
- Added pkg/util/log.go for centralized logging utilities
- Enhanced EnvironmentManager with change detection capabilities
- Integrated URL replacements into pkg/tools/download.go
- Added comprehensive test suites and documentation

**Files Added/Modified:**
- cmd/config.go - CLI commands for configuration management
- cmd/shell.go - Shell command implementation
- cmd/activate.go - Shell activation support
- cmd/deactivate.go - Shell deactivation support
- cmd/env.go - Environment variable management
- cmd/root.go - Register new commands
- pkg/config/global.go - Global configuration management
- pkg/tools/url_replacements.go - URL replacement logic
- pkg/tools/environment.go - Environment variable management
- pkg/tools/download.go - Integration with URL replacements
- pkg/tools/manager.go - Enhanced tool management
- pkg/util/log.go - Centralized logging utilities
- website/content/url-replacements.md - Documentation
- test/integration_test.go - Enhanced integration tests
- test/java_debug_test.go - CI debugging capabilities

This implementation uses global-only configuration for security and simplicity,
avoiding the complexity of project-level overrides while providing enterprise
users with the flexibility they need for internal mirrors and proxies.

Closes #40

Author: gnodet

.github/workflows/ci.yml

@@ -53,6 +53,38 @@ jobs:
           # Test that wrapper works with current version
           ./mvx version
 
+      - name: Check for website changes
+        uses: dorny/paths-filter@v3
+        id: website-changes
+        with:
+          filters: |
+            website:
+              - 'website/**'
+
+      - name: Set up JDK 21 for website
+        if: steps.website-changes.outputs.website == 'true'
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: maven
+
+      - name: Check website build
+        if: steps.website-changes.outputs.website == 'true'
+        run: |
+          OWNER=$(echo "$GITHUB_REPOSITORY" | cut -d '/' -f 1)
+          REPO=$(echo "$GITHUB_REPOSITORY" | cut -d '/' -f 2)
+          SITE_URL="https://${OWNER}.github.io"
+          SITE_PATH="/${REPO}/"
+          echo "SITE_URL=$SITE_URL" >> $GITHUB_ENV
+          echo "SITE_PATH=$SITE_PATH" >> $GITHUB_ENV
+          echo "GITHUB_REPOSITORY=$GITHUB_REPOSITORY SITE_DIR=$SITE_DIR SITE_URL=$SITE_URL SITE_PATH=$SITE_PATH"
+          # Build website to catch template syntax errors
+          cd website
+          QUARKUS_ROQ_GENERATOR_BATCH=true mvn clean package quarkus:run -DskipTests --no-transfer-progress \
+              -Dquarkus.http.root-path=$SITE_PATH \
+              -Dsite.url=$SITE_URL
+
       - name: Upload build artifacts
         uses: actions/upload-artifact@v4
         with:

README.md

@@ -27,6 +27,10 @@ Imagine cloning any project and running:
 # Or use tools directly with natural syntax
 ./mvx mvn -V clean install    # Maven with version flag
 ./mvx --verbose mvn -X test   # mvx verbose + Maven debug
+
+# Execute shell commands in mvx environment
+./mvx shell 'echo $JAVA_HOME'  # Show Java home with mvx tools
+./mvx shell 'java -version'    # Run Java with mvx environment
 ```
 
 No more "works on my machine" - every developer gets the exact same environment.
@@ -54,6 +58,7 @@ mvx provides seamless Maven integration with transparent argument passing:
 - **🔄 Transparent wrapper**: mvx acts like `mvnw` but with enhanced tool management
 - **⚡ No learning curve**: Existing Maven knowledge applies directly
 - **🛡️ Backward compatible**: Existing scripts continue to work
+- **🏢 Enterprise ready**: URL replacements for corporate networks and mirrors
 
 ## 📦 mvx Bootstrap
 
@@ -199,6 +204,37 @@ cd mvx
 ./mvx test
 ```
 
+## 🔄 Shell Activation
+
+For a seamless development experience, enable shell activation to automatically set up your environment when entering project directories:
+
+**Bash** - Add to `~/.bashrc`:
+```bash
+eval "$(mvx activate bash)"
+```
+
+**Zsh** - Add to `~/.zshrc`:
+```bash
+eval "$(mvx activate zsh)"
+```
+
+**Fish** - Add to `~/.config/fish/config.fish`:
+```bash
+mvx activate fish | source
+```
+
+With shell activation enabled, tools become available automatically:
+
+```bash
+cd my-project
+# mvx: activating environment in /Users/you/my-project
+
+java -version  # Uses mvx-managed Java
+mvn -version   # Uses mvx-managed Maven
+```
+
+**Learn more**: See the [Shell Activation Guide](https://gnodet.github.io/mvx/shell-activation/) for detailed documentation.
+
 ## 🎯 Shell Completion
 
 mvx supports shell completion for commands and arguments across multiple shells (bash, zsh, fish, powershell):
@@ -354,6 +390,7 @@ The bootstrap scripts (`mvx` and `mvx.cmd`) are **shell/batch scripts** (not bin
 - [x] `mvx build` - Execute configured build commands
 - [x] `mvx test` - Execute configured test commands
 - [x] `mvx run` - Execute custom commands from configuration
+- [x] `mvx shell` - Execute shell commands in mvx environment
 - [x] `mvx tools` - Tool management and discovery
 - [x] `mvx info` - Detailed command information
 
@@ -397,6 +434,12 @@ The bootstrap scripts (`mvx` and `mvx.cmd`) are **shell/batch scripts** (not bin
 - [x] **Intelligent interpreter selection** - Automatic selection based on script complexity
 - [x] **Cross-platform compatibility** - Commands work consistently across operating systems
 
+#### Enterprise & Network Support
+
+- [x] **URL replacements** - Redirect downloads through corporate proxies, mirrors, or alternative sources
+- [x] **Global configuration** - System-wide settings for enterprise environments
+- [x] **Regex-based URL transformations** - Advanced URL rewriting for complex enterprise setups
+
 ### 🚧 Planned Features
 
 #### Extended Tool Support

cmd/activate.go

@@ -0,0 +1,148 @@
+package cmd
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/gnodet/mvx/pkg/shell"
+	"github.com/spf13/cobra"
+)
+
+// activateCmd represents the activate command
+var activateCmd = &cobra.Command{
+	Use:   "activate [shell]",
+	Short: "Generate shell integration code for automatic environment activation",
+	Long: `Generate shell integration code that automatically activates mvx when entering
+directories with .mvx configuration.
+
+This command outputs shell-specific code that should be evaluated in your shell's
+configuration file (e.g., ~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish).
+
+When activated, mvx will:
+  - Detect when you enter a directory with .mvx configuration
+  - Automatically update PATH with mvx-managed tools
+  - Set up environment variables from your configuration
+  - Cache the environment to avoid repeated setup
+
+Supported shells:
+  - bash
+  - zsh
+  - fish
+  - powershell
+
+Examples:
+  # Bash - add to ~/.bashrc
+  eval "$(mvx activate bash)"
+
+  # Zsh - add to ~/.zshrc
+  eval "$(mvx activate zsh)"
+
+  # Fish - add to ~/.config/fish/config.fish
+  mvx activate fish | source
+
+  # PowerShell - add to $PROFILE
+  Invoke-Expression (mvx activate powershell | Out-String)
+
+After adding to your shell configuration, restart your shell or source the file:
+  source ~/.bashrc    # bash
+  source ~/.zshrc     # zsh
+  source ~/.config/fish/config.fish  # fish
+
+Configuration:
+  MVX_VERBOSE=true        # Enable verbose output to see what mvx is doing`,
+
+	Args: cobra.ExactArgs(1),
+	Run: func(cmd *cobra.Command, args []string) {
+		shellType := args[0]
+
+		// Validate shell type
+		validShells := []string{"bash", "zsh", "fish", "powershell"}
+		isValid := false
+		for _, s := range validShells {
+			if s == shellType {
+				isValid = true
+				break
+			}
+		}
+
+		if !isValid {
+			printError("Unsupported shell: %s", shellType)
+			printError("Supported shells: bash, zsh, fish, powershell")
+			os.Exit(1)
+		}
+
+		// Get the path to the mvx binary
+		mvxPath, err := getMvxBinaryPath()
+		if err != nil {
+			printError("Failed to determine mvx binary path: %v", err)
+			os.Exit(1)
+		}
+
+		// Generate shell hook
+		hook, err := shell.GenerateHook(shellType, mvxPath)
+		if err != nil {
+			printError("Failed to generate shell hook: %v", err)
+			os.Exit(1)
+		}
+
+		// Output the hook (this will be evaluated by the shell)
+		fmt.Print(hook)
+	},
+}
+
+// deactivateCmd represents the deactivate command
+var deactivateCmd = &cobra.Command{
+	Use:   "deactivate",
+	Short: "Deactivate mvx shell integration",
+	Long: `Deactivate mvx shell integration for the current shell session.
+
+This command is automatically available after running 'mvx activate' and
+removes mvx-managed tools from PATH and unsets mvx environment variables.
+
+Note: This only affects the current shell session. To permanently disable
+mvx activation, remove the 'eval "$(mvx activate ...)"' line from your
+shell configuration file.
+
+Examples:
+  mvx deactivate    # Remove mvx from current session`,
+
+	Run: func(cmd *cobra.Command, args []string) {
+		// This command is primarily handled by the shell hook itself
+		// When called directly, we just provide information
+		printInfo("To deactivate mvx in your current shell session:")
+		printInfo("")
+		printInfo("  Bash/Zsh:")
+		printInfo("    Run: mvx_deactivate")
+		printInfo("")
+		printInfo("  Fish:")
+		printInfo("    Run: mvx_deactivate")
+		printInfo("")
+		printInfo("  PowerShell:")
+		printInfo("    Run: mvx-deactivate")
+		printInfo("")
+		printInfo("To permanently disable mvx activation, remove the activation")
+		printInfo("line from your shell configuration file:")
+		printInfo("  - Bash: ~/.bashrc")
+		printInfo("  - Zsh: ~/.zshrc")
+		printInfo("  - Fish: ~/.config/fish/config.fish")
+		printInfo("  - PowerShell: $PROFILE")
+	},
+}
+
+// getMvxBinaryPath returns the path to the mvx binary
+func getMvxBinaryPath() (string, error) {
+	// Try to get the path from the current executable
+	exePath, err := os.Executable()
+	if err != nil {
+		return "", fmt.Errorf("failed to get executable path: %w", err)
+	}
+
+	// Resolve symlinks
+	exePath, err = filepath.EvalSymlinks(exePath)
+	if err != nil {
+		return "", fmt.Errorf("failed to resolve symlinks: %w", err)
+	}
+
+	return exePath, nil
+}