Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

6.5 KB
Raw Blame
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved.
<#
    Source scan of setup.ps1's "install blocked" reporting: llama.cpp exit 3 must not name
    a process, and a Node kept on exit 0 must relay the installer's repair lines.
#>

BeforeAll {
    $candidates = @(
        $env:SETUP_PS1_PATH,
        (Join-Path $PSScriptRoot '..\..\studio\setup.ps1')
    ) | Where-Object { $_ }
    $script:SetupPs1 = $candidates | Where-Object { Test-Path -LiteralPath $_ } | Select-Object -First 1
    if (-not $script:SetupPs1) { throw "Could not locate studio/setup.ps1 (set SETUP_PS1_PATH)." }
    $script:SetupText = Get-Content -Raw -LiteralPath $script:SetupPs1
    $script:NodeInstaller = Get-Content -Raw -LiteralPath (Join-Path (Split-Path -Parent $script:SetupPs1) 'install_node_prebuilt.py')

    # Inline installer flow, not functions, so slice from the marker to its closing brace.
    function Get-BlockSource {
        param(
            [Parameter(Mandatory)][string]$Path,
            [Parameter(Mandatory)][string]$Marker,
            [Parameter(Mandatory)][string]$ClosePattern
        )
        $lines = @(Get-Content -LiteralPath $Path)
        $start = -1
        for ($i = 0; $i -lt $lines.Count; $i++) {
            if ($lines[$i] -match [regex]::Escape($Marker)) { $start = $i; break }
        }
        if ($start -lt 0) { return $null }
        $indent = ($lines[$start] -replace '\S.*$', '').Length
        for ($j = $start + 1; $j -lt $lines.Count; $j++) {
            $depth = ($lines[$j] -replace '\S.*$', '').Length
            if ($lines[$j] -match $ClosePattern -and $depth -le $indent) {
                return ($lines[$start..($j - 1)] -join "`n")
            }
        }
        return $null
    }

    $script:LlamaBusy = Get-BlockSource -Path $script:SetupPs1 `
        -Marker '$prebuiltExit -eq 3' -ClosePattern '^\s*\}\s*(elseif|else)\b'
    $script:WhisperBusy = Get-BlockSource -Path $script:SetupPs1 `
        -Marker '$whisperExit -eq 3' -ClosePattern '^\s*\}\s*(elseif|else)\b'
    $script:LocalLinkBusy = Get-BlockSource -Path $script:SetupPs1 `
        -Marker '(Get-PathState -Path $LlamaCppDir) -ne "Absent"' -ClosePattern '^\s*\}\s*$'
    # Anchored on the exit-code chain: the mirror retry between them closes first.
    $script:NodeExit = Get-BlockSource -Path $script:SetupPs1 `
        -Marker '$nodeExit -eq 3' -ClosePattern '^\s*\}\s*$'
}

Describe 'no llama.cpp blocked-install message names a cause setup cannot determine' {
    It 'the process headline appears nowhere in setup.ps1' {
        $script:SetupText | Should -Not -Match 'install blocked by active llama\.cpp process'
    }

    It 'the process failure message appears nowhere in setup.ps1' {
        $script:SetupText | Should -Not -Match 'blocked by an active llama\.cpp process'
    }

    It 'every blocked-install site offers ACL repair' {
        ([regex]::Matches($script:SetupText, 'repair the ACLs')).Count |
            Should -BeGreaterOrEqual 2
    }
}

Describe 'the prebuilt exit-3 branch' {
    It 'is present in setup.ps1' {
        $script:LlamaBusy | Should -Not -BeNullOrEmpty
    }

    It 'offers ACL repair alongside closing other users' {
        $script:LlamaBusy | Should -Match 'repair the ACLs'
    }

    It 'only names ACL repair when the helper emitted recovery guidance' {
        $script:LlamaBusy | Should -Match '\$prebuiltOutput -match [''"]takeown /F[''"]'
    }

    It 'keeps a close-users-only fallback without recovery guidance' {
        $script:LlamaBusy | Should -Match '(?s)else\s*\{.+Close Unsloth or other llama\.cpp users and retry'
    }

    It 'still terminates with exit code 3' {
        $script:LlamaBusy | Should -Match 'Exit-SetupFailure .+ 3'
    }

    It 'still prints the installer output carrying the takeown/icacls commands' {
        $script:LlamaBusy | Should -Match 'Write-LlamaFailureLog -Output \$prebuiltOutput'
    }

    It 'still reports that the previous install was restored' {
        $script:LlamaBusy | Should -Match 'Existing install was restored'
    }

    It 'still tells the user to close other llama.cpp users' {
        $script:LlamaBusy | Should -Match 'Close Unsloth or other llama\.cpp users'
    }
}

Describe 'the local-directory link path mirrors it, as its comment claims' {
    It 'is present in setup.ps1' {
        $script:LocalLinkBusy | Should -Not -BeNullOrEmpty
    }

    It 'offers ACL repair on the install directory' {
        $script:LocalLinkBusy | Should -Match 'repair the ACLs on \$LlamaCppDir'
    }

    It 'still terminates with exit code 3' {
        $script:LocalLinkBusy | Should -Match 'Exit-SetupFailure .+ 3'
    }

    It 'still tells the user to close other llama.cpp users' {
        $script:LocalLinkBusy | Should -Match 'Close Unsloth or other llama\.cpp users'
    }
}

Describe 'the whisper.cpp exit-3 branch remains the cause-neutral precedent' {
    It 'is present in setup.ps1' {
        $script:WhisperBusy | Should -Not -BeNullOrEmpty
    }

    It 'names no process and no scanner' {
        $script:WhisperBusy | Should -Not -Match '(?i)process|scanner'
    }
}

Describe 'a Node the installer kept because it could not be replaced' {
    BeforeAll {
        $script:NodeKept = $null
        if ($script:NodeExit) {
            $at = $script:NodeExit.IndexOf('keeping existing isolated Node')
            if ($at -ge 0) { $script:NodeKept = $script:NodeExit.Substring($at) }
        }
    }

    It 'the Node exit handling is present in setup.ps1' {
        $script:NodeExit | Should -Not -BeNullOrEmpty
    }

    It 'matches the line the Node installer logs when it keeps an install' {
        $script:NodeInstaller | Should -Match 'keeping existing isolated Node'
        $script:NodeExit | Should -Match '\$nodeOut -match [''"]keeping existing isolated Node[''"]'
    }

    It 'is reached only after both failure arms, so only on exit 0' {
        $failure = $script:NodeExit.IndexOf('$nodeExit -ne 0')
        $failure | Should -BeGreaterOrEqual 0
        $script:NodeExit.IndexOf('keeping existing isolated Node') | Should -BeGreaterThan $failure
    }

    It 'warns and carries on rather than failing setup' {
        $script:NodeKept | Should -Match 'step "node" "update not applied, existing isolated Node kept" "Yellow"'
        $script:NodeKept | Should -Not -Match 'Exit-SetupFailure'
    }

    It 'relays the installer output only when it carries the takeown/icacls lines' {
        $script:NodeKept | Should -Match '(?s)\$nodeOut -match [''"]takeown /F[''"]\)\s*\{\s*Write-StudioLine \$nodeOut'
    }
}