path: root/apps/installer/test/test_module_commands.bats

#!/usr/bin/env bats

# Tests for installer module commands (search/install/update/remove)
# Focused on installer:module install behavior using a mocked joiner

load '../../test-framework/bats_libs/acore-support'
load '../../test-framework/bats_libs/acore-assert'

setup() {
    acore_test_setup
    # Point to the installer src directory (not needed in this test)

    # Set installer/paths environment for the test
    export AC_PATH_APPS="$TEST_DIR/apps"
    export AC_PATH_ROOT="$TEST_DIR"
    export AC_PATH_DEPS="$TEST_DIR/deps"
    export AC_PATH_MODULES="$TEST_DIR/modules"
    export MODULES_LIST_FILE="$TEST_DIR/conf/modules.list"

    # Create stubbed deps: joiner.sh (sourced by includes) and semver
    mkdir -p "$TEST_DIR/deps/acore/joiner"
    cat > "$TEST_DIR/deps/acore/joiner/joiner.sh" << 'EOF'
#!/usr/bin/env bash
# Stub joiner functions used by installer
Joiner:add_repo() {
    # arguments: url name branch basedir
    echo "ADD $@" > "$TEST_DIR/joiner_called.txt"
    return 0
}
Joiner:upd_repo() {
    echo "UPD $@" > "$TEST_DIR/joiner_called.txt"
    return 0
}
Joiner:remove() {
    echo "REM $@" > "$TEST_DIR/joiner_called.txt"
    return 0
}
EOF
    chmod +x "$TEST_DIR/deps/acore/joiner/joiner.sh"

    mkdir -p "$TEST_DIR/deps/semver_bash"
    # Minimal semver stub
    cat > "$TEST_DIR/deps/semver_bash/semver.sh" << 'EOF'
#!/usr/bin/env bash
# semver stub
semver::satisfies() { return 0; }
EOF
    chmod +x "$TEST_DIR/deps/semver_bash/semver.sh"

    # Provide a minimal compiler includes file expected by installer
    mkdir -p "$TEST_DIR/apps/compiler/includes"
    touch "$TEST_DIR/apps/compiler/includes/includes.sh"

    # Provide minimal bash_shared includes to satisfy installer include
    mkdir -p "$TEST_DIR/apps/bash_shared"
    cat > "$TEST_DIR/apps/bash_shared/includes.sh" << 'EOF'
#!/usr/bin/env bash
# minimal stub
EOF

    # Copy the menu system needed by modules.sh
    cp "$AC_TEST_ROOT/apps/bash_shared/menu_system.sh" "$TEST_DIR/apps/bash_shared/"

    # Copy the real installer app into the test apps dir
    mkdir -p "$TEST_DIR/apps"
    cp -r "$(cd "$AC_TEST_ROOT/apps/installer" && pwd)" "$TEST_DIR/apps/installer"
}

teardown() {
    acore_test_teardown
}

@test "module install should call joiner and record entry in modules list" {
    cd "$TEST_DIR"

    # Source installer includes and call the install function directly to avoid menu interaction
    run bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_install example-module@main:abcd1234"

    # Check that joiner was called
    [ -f "$TEST_DIR/joiner_called.txt" ]
    grep -q "ADD" "$TEST_DIR/joiner_called.txt"

    # Check modules list was created and contains the repo_ref and branch
    [ -f "$TEST_DIR/conf/modules.list" ]
    grep -q "azerothcore/example-module main" "$TEST_DIR/conf/modules.list"
}

@test "module install with owner/name format should work" {
    cd "$TEST_DIR"

    # Test with owner/name format
    run bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_install myorg/mymodule"

    # Check that joiner was called with correct URL
    [ -f "$TEST_DIR/joiner_called.txt" ]
    grep -q "ADD https://github.com/myorg/mymodule mymodule" "$TEST_DIR/joiner_called.txt"

    # Check modules list contains the entry
    [ -f "$TEST_DIR/conf/modules.list" ]
    grep -q "myorg/mymodule" "$TEST_DIR/conf/modules.list"
}

@test "module remove should call joiner remove and update modules list" {
    cd "$TEST_DIR"

    # First install a module
    bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_install test-module"
    
    # Then remove it
    run bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_remove test-module"

    # Check that joiner remove was called
    [ -f "$TEST_DIR/joiner_called.txt" ]
    # With flat structure, basedir is empty; ensure name is present
    grep -q "REM test-module" "$TEST_DIR/joiner_called.txt"

    # Check modules list no longer contains the entry
    [ -f "$TEST_DIR/conf/modules.list" ]
    ! grep -q "azerothcore/test-module" "$TEST_DIR/conf/modules.list"
}

# Tests for intelligent module management (duplicate prevention and cross-format removal)

@test "inst_extract_owner_name should extract owner/name from various formats" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test simple name
    run inst_extract_owner_name "mod-transmog"
    [ "$output" = "azerothcore/mod-transmog" ]

    # Test owner/name format
    run inst_extract_owner_name "azerothcore/mod-transmog"
    [ "$output" = "azerothcore/mod-transmog" ]

    # Test HTTPS URL
    run inst_extract_owner_name "https://github.com/azerothcore/mod-transmog.git"
    [ "$output" = "azerothcore/mod-transmog" ]

    # Test SSH URL
    run inst_extract_owner_name "git@github.com:azerothcore/mod-transmog.git"
    [ "$output" = "azerothcore/mod-transmog" ]

    # Test GitLab URL
    run inst_extract_owner_name "https://gitlab.com/myorg/mymodule.git"
    [ "$output" = "myorg/mymodule" ]
}

@test "inst_extract_owner_name should handle URLs with ports correctly" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test HTTPS URL with port
    run inst_extract_owner_name "https://example.com:8080/user/repo.git"
    [ "$output" = "user/repo" ]

    # Test SSH URL with port  
    run inst_extract_owner_name "ssh://git@example.com:2222/owner/module"
    [ "$output" = "owner/module" ]

    # Test URL with port and custom directory (should ignore the directory part)
    run inst_extract_owner_name "https://gitlab.internal:9443/team/project.git:custom-dir"
    [ "$output" = "team/project" ]

    # Test complex URL with port (should extract owner/name correctly)
    run inst_extract_owner_name "https://git.company.com:8443/department/awesome-module.git"
    [ "$output" = "department/awesome-module" ]
}

@test "duplicate module entries should be prevented across different formats" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Add module via simple name
    inst_mod_list_upsert "mod-transmog" "master" "abc123"
    
    # Verify it's in the list
    grep -q "mod-transmog master abc123" "$TEST_DIR/conf/modules.list"
    
    # Add same module via owner/name format - should replace, not duplicate
    inst_mod_list_upsert "azerothcore/mod-transmog" "dev" "def456"
    
    # Should only have one entry (the new one)
    [ "$(grep -c "azerothcore/mod-transmog" "$TEST_DIR/conf/modules.list")" -eq 1 ]
    grep -q "azerothcore/mod-transmog dev def456" "$TEST_DIR/conf/modules.list"
    ! grep -q "mod-transmog master abc123" "$TEST_DIR/conf/modules.list"
}

@test "module installed via URL should be recognized when checking with different formats" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Install via HTTPS URL
    inst_mod_list_upsert "https://github.com/azerothcore/mod-transmog.git" "master" "abc123"
    
    # Should be detected as installed using simple name
    run inst_mod_is_installed "mod-transmog"
    [ "$status" -eq 0 ]
    
    # Should be detected as installed using owner/name
    run inst_mod_is_installed "azerothcore/mod-transmog"
    [ "$status" -eq 0 ]
    
    # Should be detected as installed using SSH URL
    run inst_mod_is_installed "git@github.com:azerothcore/mod-transmog.git"
    [ "$status" -eq 0 ]
    
    # Non-existent module should not be detected
    run inst_mod_is_installed "mod-nonexistent"
    [ "$status" -ne 0 ]
}

@test "module installed via URL with port should be recognized correctly" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Install via URL with port
    inst_mod_list_upsert "https://gitlab.internal:9443/myorg/my-module.git" "master" "abc123"
    
    # Should be detected as installed using normalized owner/name
    run inst_mod_is_installed "myorg/my-module"
    [ "$status" -eq 0 ]
    
    # Should be detected when checking with different URL format
    run inst_mod_is_installed "ssh://git@gitlab.internal:9443/myorg/my-module"
    [ "$status" -eq 0 ]
    
    # Should be detected when checking with custom directory syntax
    run inst_mod_is_installed "myorg/my-module:custom-dir"
    [ "$status" -eq 0 ]
    
    # Different module should not be detected
    run inst_mod_is_installed "myorg/different-module"
    [ "$status" -ne 0 ]
}

@test "cross-format module removal should work" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Install via SSH URL
    inst_mod_list_upsert "git@github.com:azerothcore/mod-transmog.git" "master" "abc123"
    
    # Verify it's installed
    grep -q "git@github.com:azerothcore/mod-transmog.git" "$TEST_DIR/conf/modules.list"
    
    # Remove using simple name
    inst_mod_list_remove "mod-transmog"
    
    # Should be completely removed
    ! grep -q "azerothcore/mod-transmog" "$TEST_DIR/conf/modules.list"
    ! grep -q "git@github.com:azerothcore/mod-transmog.git" "$TEST_DIR/conf/modules.list"
}

@test "module installation should prevent duplicates when already installed" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Install via simple name first
    inst_mod_list_upsert "mod-worldchat" "master" "abc123"
    
    # Try to install same module via URL - should detect it's already installed
    run inst_mod_is_installed "https://github.com/azerothcore/mod-worldchat.git"
    [ "$status" -eq 0 ]
    
    # Add via URL should replace the existing entry
    inst_mod_list_upsert "https://github.com/azerothcore/mod-worldchat.git" "dev" "def456"
    
    # Should only have one entry
    [ "$(grep -c "azerothcore/mod-worldchat" "$TEST_DIR/conf/modules.list")" -eq 1 ]
    grep -q "https://github.com/azerothcore/mod-worldchat.git dev def456" "$TEST_DIR/conf/modules.list"
}

@test "module update --all uses flat structure (no branch subfolders)" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Prepare modules.list with one entry and a matching local directory
    mkdir -p "$TEST_DIR/conf"
    echo "azerothcore/mod-transmog master abc123" > "$TEST_DIR/conf/modules.list"
    mkdir -p "$TEST_DIR/modules/mod-transmog"

    # Run update all
    run bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_update --all"

    # Verify Joiner:upd_repo received flat structure args (no basedir)
    [ -f "$TEST_DIR/joiner_called.txt" ]
    grep -q "UPD https://github.com/azerothcore/mod-transmog mod-transmog master" "$TEST_DIR/joiner_called.txt"
}

@test "module update specific uses flat structure with override branch" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Create local directory so update proceeds
    mkdir -p "$TEST_DIR/modules/mymodule"

    # Run update specifying owner/name and branch
    run bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_update myorg/mymodule@dev"

    # Should call joiner with name 'mymodule' and branch 'dev' (no basedir)
    [ -f "$TEST_DIR/joiner_called.txt" ]
    grep -q "UPD https://github.com/myorg/mymodule mymodule dev" "$TEST_DIR/joiner_called.txt"
}

@test "custom directory names should work with new syntax" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test parsing with custom directory name
    run inst_parse_module_spec "mod-transmog:my-custom-dir@develop:abc123"
    [ "$status" -eq 0 ]
    # Should output: repo_ref owner name branch commit url dirname
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "azerothcore/mod-transmog" ]
    [ "$owner" = "azerothcore" ]
    [ "$name" = "mod-transmog" ]
    [ "$branch" = "develop" ]
    [ "$commit" = "abc123" ]
    [ "$url" = "https://github.com/azerothcore/mod-transmog" ]
    [ "$dirname" = "my-custom-dir" ]
}

@test "directory conflict detection should work" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Create a fake existing directory
    mkdir -p "$TEST_DIR/modules/existing-dir"
    
    # Should detect conflict
    run inst_check_module_conflict "existing-dir" "mod-test"
    [ "$status" -eq 1 ]
    [[ "$output" =~ "Directory 'existing-dir' already exists" ]]
    [[ "$output" =~ "Use a different directory name: mod-test:my-custom-name" ]]
    
    # Should not detect conflict for non-existing directory
    run inst_check_module_conflict "non-existing-dir" "mod-test"
    [ "$status" -eq 0 ]
}

@test "module update should work with custom directories" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # First add module with custom directory to list
    inst_mod_list_upsert "azerothcore/mod-transmog:custom-dir" "master" "abc123"
    
    # Create fake module directory structure
    mkdir -p "$TEST_DIR/modules/custom-dir/.git"
    echo "ref: refs/heads/master" > "$TEST_DIR/modules/custom-dir/.git/HEAD"
    
    # Mock git commands in the fake module directory
    cat > "$TEST_DIR/modules/custom-dir/.git/config" << 'EOF'
[core]
    repositoryformatversion = 0
    filemode = true
    bare = false
[remote "origin"]
    url = https://github.com/azerothcore/mod-transmog
    fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
    remote = origin
    merge = refs/heads/master
EOF

    # Test update with custom directory should work
    # Note: This would require more complex mocking for full integration test
    # For now, just test the parsing recognizes the custom directory
    run inst_parse_module_spec "azerothcore/mod-transmog:custom-dir"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$dirname" = "custom-dir" ]
}

@test "URL formats should be properly normalized" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test various URL formats produce same owner/name
    run inst_extract_owner_name "https://github.com/azerothcore/mod-transmog"
    local url_format="$output"
    
    run inst_extract_owner_name "https://github.com/azerothcore/mod-transmog.git"
    local url_git_format="$output"
    
    run inst_extract_owner_name "git@github.com:azerothcore/mod-transmog.git"
    local ssh_format="$output"
    
    run inst_extract_owner_name "azerothcore/mod-transmog"
    local owner_name_format="$output"
    
    run inst_extract_owner_name "mod-transmog"
    local simple_format="$output"
    
    # All should normalize to the same owner/name
    [ "$url_format" = "azerothcore/mod-transmog" ]
    [ "$url_git_format" = "azerothcore/mod-transmog" ]
    [ "$ssh_format" = "azerothcore/mod-transmog" ]
    [ "$owner_name_format" = "azerothcore/mod-transmog" ]
    [ "$simple_format" = "azerothcore/mod-transmog" ]
}

# Tests for module exclusion functionality

@test "module exclusion should work with MODULES_EXCLUDE_LIST" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test exclusion with simple name
    export MODULES_EXCLUDE_LIST="mod-test-module"
    run inst_mod_is_excluded "mod-test-module"
    [ "$status" -eq 0 ]

    # Test exclusion with owner/name format  
    export MODULES_EXCLUDE_LIST="azerothcore/mod-test"
    run inst_mod_is_excluded "mod-test"
    [ "$status" -eq 0 ]

    # Test exclusion with space-separated list
    export MODULES_EXCLUDE_LIST="mod-one mod-two mod-three"
    run inst_mod_is_excluded "mod-two"
    [ "$status" -eq 0 ]

    # Test exclusion with newline-separated list
    export MODULES_EXCLUDE_LIST="
mod-alpha
mod-beta
mod-gamma
"
    run inst_mod_is_excluded "mod-beta"
    [ "$status" -eq 0 ]

    # Test exclusion with URL format
    export MODULES_EXCLUDE_LIST="https://github.com/azerothcore/mod-transmog.git"
    run inst_mod_is_excluded "mod-transmog"
    [ "$status" -eq 0 ]

    # Test non-excluded module
    export MODULES_EXCLUDE_LIST="mod-other"
    run inst_mod_is_excluded "mod-transmog"
    [ "$status" -eq 1 ]

    # Test empty exclusion list
    unset MODULES_EXCLUDE_LIST
    run inst_mod_is_excluded "mod-transmog"
    [ "$status" -eq 1 ]
}

@test "install --all should skip excluded modules" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Setup modules list with excluded module
    mkdir -p "$TEST_DIR/conf"
    cat > "$TEST_DIR/conf/modules.list" << 'EOF'
azerothcore/mod-transmog master abc123
azerothcore/mod-excluded master def456
EOF

    # Set exclusion list
    export MODULES_EXCLUDE_LIST="mod-excluded"

    # Mock the install process to capture output
    run bash -c "source '$TEST_DIR/apps/installer/includes/includes.sh' && inst_module_install --all 2>&1"

    # Should show that excluded module was skipped
    [[ "$output" == *"azerothcore/mod-excluded"* && "$output" == *"Excluded by MODULES_EXCLUDE_LIST"* && "$output" == *"skipping"* ]]
}

@test "exclusion should work with multiple formats in same list" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test multiple exclusion formats
    export MODULES_EXCLUDE_LIST="mod-test https://github.com/azerothcore/mod-transmog.git custom/mod-other"
    
    run inst_mod_is_excluded "mod-test"
    [ "$status" -eq 0 ]
    
    run inst_mod_is_excluded "azerothcore/mod-transmog"
    [ "$status" -eq 0 ]
    
    run inst_mod_is_excluded "custom/mod-other"
    [ "$status" -eq 0 ]
    
    run inst_mod_is_excluded "mod-allowed"
    [ "$status" -eq 1 ]
}

# Tests for color support functionality

@test "color functions should work correctly" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test that print functions exist and work
    run print_info "test message"
    [ "$status" -eq 0 ]
    
    run print_warn "test warning"
    [ "$status" -eq 0 ]
    
    run print_error "test error"
    [ "$status" -eq 0 ]
    
    run print_success "test success"
    [ "$status" -eq 0 ]
    
    run print_skip "test skip"
    [ "$status" -eq 0 ]
    
    run print_header "test header"
    [ "$status" -eq 0 ]
}

@test "color support should respect NO_COLOR environment variable" {
    cd "$TEST_DIR"
    
    # Test with NO_COLOR set
    export NO_COLOR=1
    source "$TEST_DIR/apps/installer/includes/includes.sh"
    
    # Colors should be empty when NO_COLOR is set
    [ -z "$C_RED" ]
    [ -z "$C_GREEN" ]
    [ -z "$C_RESET" ]
}

# Tests for interactive menu system

@test "module help should display comprehensive help" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    run inst_module_help
    [ "$status" -eq 0 ]
    
    # Should contain key sections
    [[ "$output" =~ "Module Manager Help" ]]
    [[ "$output" =~ "Usage:" ]]
    [[ "$output" =~ "Module Specification Syntax:" ]]
    [[ "$output" =~ "Examples:" ]]
}

@test "module list should show installed modules correctly" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Setup modules list
    mkdir -p "$TEST_DIR/conf"
    cat > "$TEST_DIR/conf/modules.list" << 'EOF'
azerothcore/mod-transmog master abc123
custom/mod-test develop def456
EOF

    run inst_module_list
    [ "$status" -eq 0 ]
    
    # Should show both modules
    [[ "$output" =~ "mod-transmog" ]]
    [[ "$output" =~ "custom/mod-test" ]]
    [[ "$output" =~ "master" ]]
    [[ "$output" =~ "develop" ]]
}

@test "module list should handle empty list gracefully" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Ensure empty modules list
    mkdir -p "$TEST_DIR/conf"
    touch "$TEST_DIR/conf/modules.list"

    run inst_module_list
    [ "$status" -eq 0 ]
    [[ "$output" =~ "No modules installed" ]]
}

# Tests for advanced parsing edge cases

@test "parsing should handle complex URL formats" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test GitLab URL with custom directory and branch
    run inst_parse_module_spec "https://gitlab.com/myorg/mymodule.git:custom-dir@develop:abc123"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "https://gitlab.com/myorg/mymodule.git" ]
    [ "$owner" = "myorg" ]
    [ "$name" = "mymodule" ]
    [ "$branch" = "develop" ]
    [ "$commit" = "abc123" ]
    [ "$dirname" = "custom-dir" ]
}

@test "parsing should handle URLs with ports correctly (fix for port/dirname confusion)" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test HTTPS URL with port - should NOT treat port as dirname
    run inst_parse_module_spec "https://example.com:8080/user/repo.git"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "https://example.com:8080/user/repo.git" ]
    [ "$owner" = "user" ]
    [ "$name" = "repo" ]
    [ "$branch" = "-" ]
    [ "$commit" = "-" ]
    [ "$url" = "https://example.com:8080/user/repo.git" ]
    [ "$dirname" = "repo" ]  # Should default to repo name, NOT port number
}

@test "parsing should handle URLs with ports and custom directory correctly" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test URL with port AND custom directory - should parse custom directory correctly
    run inst_parse_module_spec "https://example.com:8080/user/repo.git:custom-dir"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "https://example.com:8080/user/repo.git" ]
    [ "$owner" = "user" ]
    [ "$name" = "repo" ]
    [ "$branch" = "-" ]
    [ "$commit" = "-" ]
    [ "$url" = "https://example.com:8080/user/repo.git" ]
    [ "$dirname" = "custom-dir" ]  # Should be custom-dir, not port number
}

@test "parsing should handle SSH URLs with ports correctly" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test SSH URL with port
    run inst_parse_module_spec "ssh://git@example.com:2222/user/repo"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "ssh://git@example.com:2222/user/repo" ]
    [ "$owner" = "user" ]
    [ "$name" = "repo" ]
    [ "$dirname" = "repo" ]  # Should be repo name, not port number
}

@test "parsing should handle SSH URLs with ports and custom directory" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test SSH URL with port and custom directory
    run inst_parse_module_spec "ssh://git@example.com:2222/user/repo:my-custom-dir@develop"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "ssh://git@example.com:2222/user/repo" ]
    [ "$owner" = "user" ]
    [ "$name" = "repo" ]
    [ "$branch" = "develop" ]
    [ "$dirname" = "my-custom-dir" ]
}

@test "parsing should handle complex URLs with ports, custom dirs, and branches" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Test comprehensive URL with port, custom directory, branch, and commit
    run inst_parse_module_spec "https://gitlab.example.com:9443/myorg/myrepo.git:custom-name@feature-branch:abc123def"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "https://gitlab.example.com:9443/myorg/myrepo.git" ]
    [ "$owner" = "myorg" ]
    [ "$name" = "myrepo" ]
    [ "$branch" = "feature-branch" ]
    [ "$commit" = "abc123def" ]
    [ "$url" = "https://gitlab.example.com:9443/myorg/myrepo.git" ]
    [ "$dirname" = "custom-name" ]
}

@test "URL port parsing regression test - ensure ports are not confused with directory names" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # These are the problematic cases that the fix addresses
    local test_cases=(
        "https://example.com:8080/repo.git"
        "https://gitlab.internal:9443/group/project.git" 
        "ssh://git@server.com:2222/owner/repo"
        "https://git.company.com:8443/team/module.git"
    )

    for spec in "${test_cases[@]}"; do
        run inst_parse_module_spec "$spec"
        [ "$status" -eq 0 ]
        IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
        
        # Critical: dirname should NEVER be a port number
        [[ ! "$dirname" =~ ^[0-9]+$ ]] || {
            echo "FAIL: Port number '$dirname' incorrectly parsed as directory name for spec: $spec"
            return 1
        }
        
        # dirname should be the repository name by default
        local expected_name
        if [[ "$spec" =~ /([^/]+)(\.git)?$ ]]; then
            expected_name="${BASH_REMATCH[1]}"
            expected_name="${expected_name%.git}"
        fi
        [ "$dirname" = "$expected_name" ] || {
            echo "FAIL: Expected dirname '$expected_name' but got '$dirname' for spec: $spec"
            return 1
        }
    done
}

@test "parsing should handle URL with custom directory but no branch" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    run inst_parse_module_spec "https://github.com/owner/repo.git:my-dir"
    [ "$status" -eq 0 ]
    IFS=' ' read -r repo_ref owner name branch commit url dirname <<< "$output"
    [ "$repo_ref" = "https://github.com/owner/repo.git" ]
    [ "$dirname" = "my-dir" ]
    [ "$branch" = "-" ]
}

@test "modules list should maintain alphabetical order" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    # Add modules in random order
    inst_mod_list_upsert "zeta/mod-z" "master" "abc"
    inst_mod_list_upsert "alpha/mod-a" "master" "def"
    inst_mod_list_upsert "beta/mod-b" "master" "ghi"

    # Read the list and verify alphabetical order
    local entries=()
    while read -r repo_ref branch commit; do
        [[ -z "$repo_ref" ]] && continue
        entries+=("$repo_ref")
    done < <(inst_mod_list_read)

    # Should be in alphabetical order by owner/name
    [ "${entries[0]}" = "alpha/mod-a" ]
    [ "${entries[1]}" = "beta/mod-b" ]
    [ "${entries[2]}" = "zeta/mod-z" ]
}

@test "module dispatcher should handle unknown commands gracefully" {
    cd "$TEST_DIR"
    source "$TEST_DIR/apps/installer/includes/includes.sh"

    run inst_module "unknown-command"
    [ "$status" -eq 1 ]
    [[ "$output" =~ "Unknown module command" ]]
}