Add context key support for strict model aliases and enhance logging

.gitignore

@@ -47,3 +47,6 @@ $RECYCLE.BIN/
 
 .idea
 *.backup
+
+# Log files (dev / runtime temp logs)
+*.log

README.md

@@ -767,7 +767,9 @@ Each step has a Back option (`0`/Escape in native, `[[Back]]` in Spectre); the
 Spectre wizard wraps each prompt in `Invoke-LLMWizardStep` and logs the
 full exception trace to `~/.local-llm/wizard-errors.log` if anything throws,
 so a Spectre live-display refresh can't scroll the trace off screen. Inspect
-with `llmlogerr [-Lines 80]`; reset with `llmlogerrclear`.
+with `llmlogerr [-Lines 80]`; reset with `llmlogerrclear`. The launch debug
+trace (vision, proxy, llama-server, Claude launches) is recorded in
+`~/.local-llm/launch.log` and tailable with `llmlog [-Lines 80]`.
 
 After a model is selected, the Spectre wizard waits briefly before drawing the
 next prompt and retries one fast-empty transition. Tune that guard with
@@ -809,6 +811,7 @@ setups, so they stay.
 - **Stale aliases after editing a parser** → `init -Stale` rebuilds only the
   aliases whose Modelfile content hash drifted.
 - **Spectre wizard crashed or stalls** → `llmlogerr` for the full trace; use
+  `llmlog` for launch/debug details (vision, proxy, llama-server, Claude);
   `llmc` for the native picker or set `$env:LOCAL_LLM_NO_SPECTRE=1` to disable
   Spectre everywhere. If the next prompt appears too slowly after selecting a
   model, raise `$env:LOCAL_LLM_SPECTRE_PROMPT_COOLDOWN_MS`.

local-llm/lib/00-settings.ps1

@@ -258,6 +258,8 @@ $script:ClaudeEnvNames = @(
     "MAX_THINKING_TOKENS",
     "CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING",
     "CLAUDE_CODE_MAX_OUTPUT_TOKENS",
+    "CLAUDE_CODE_MAX_CONTEXT_TOKENS",
+    "CLAUDE_CODE_AUTO_COMPACT_WINDOW",
     "CLAUDE_CODE_ATTRIBUTION_HEADER",
     "DISABLE_PROMPT_CACHING"
 )

local-llm/lib/10-helpers.ps1

@@ -89,10 +89,12 @@ function Download-HuggingFaceFile {
                 "uvx-hf" {
                     $oldPythonUtf8 = $env:PYTHONUTF8
                     $oldPythonIoEncoding = $env:PYTHONIOENCODING
+                    $oldHfSsl = $env:HF_HUB_DISABLE_SSL_VERIFICATION
 
                     try {
                         $env:PYTHONUTF8 = "1"
                         $env:PYTHONIOENCODING = "utf-8"
+                        $env:HF_HUB_DISABLE_SSL_VERIFICATION = "1"
 
                         & uvx hf download $Repo $normalizedFileName --local-dir $DestinationFolder | Out-Host
 
@@ -119,6 +121,13 @@ function Download-HuggingFaceFile {
                         else {
                             Remove-Item Env:PYTHONIOENCODING -ErrorAction SilentlyContinue
                         }
+
+                        if ($null -ne $oldHfSsl) {
+                            $env:HF_HUB_DISABLE_SSL_VERIFICATION = $oldHfSsl
+                        }
+                        else {
+                            Remove-Item Env:HF_HUB_DISABLE_SSL_VERIFICATION -ErrorAction SilentlyContinue
+                        }
                     }
                 }
 
@@ -144,6 +153,7 @@ function Download-HuggingFaceFile {
                         $request.Method = "GET"
                         $request.AllowAutoRedirect = $true
                         $request.UserAgent = "LocalLLMProfile/1.0"
+                        $request.ServerCertificateValidationCallback = { $true }
 
                         if ($existingBytes -gt 0) {
                             $request.AddRange($existingBytes)

local-llm/lib/20-models.ps1

@@ -300,9 +300,17 @@ function Get-ModelStrictEnabled {
 }
 
 function Get-ModelStrictAliasName {
-    param([Parameter(Mandatory = $true)][System.Collections.IDictionary]$Def)
+    param(
+        [Parameter(Mandatory = $true)][System.Collections.IDictionary]$Def,
+        [AllowEmptyString()][string]$ContextKey = ''
+    )
 
-    return "$($Def.Root)-strict"
+    if ([string]::IsNullOrWhiteSpace($ContextKey)) {
+        return "$($Def.Root)-strict"
+    }
+
+    $baseAliasName = Get-ModelAliasName -Def $Def -ContextKey $ContextKey
+    return "$baseAliasName-strict"
 }
 
 function Get-ModelStrictBaseContextKey {
@@ -346,3 +354,238 @@ function Get-ModelGgufPath {
 
     return $ggufPath
 }
+
+function Get-ModelVisionModulePath {
+    # Resolves the full path to the mmproj.gguf (multimodal vision module) for a model.
+    # Downloads on demand if not already present locally. Returns $null when no
+    # VisionModule is configured or the file does not exist.
+    param(
+        [Parameter(Mandatory = $true)][string]$Key,
+        [Parameter(Mandatory = $true)][System.Collections.IDictionary]$Def,
+        [ValidateSet('ollama', 'llamacpp')][string]$Backend = 'ollama'
+    )
+
+    $mmprojFile = $null
+    $autoDetected = $false
+
+    if ($Def.ContainsKey('VisionModule') -and -not [string]::IsNullOrWhiteSpace($Def.VisionModule)) {
+        $mmprojFile = [string]$Def.VisionModule
+        Write-LaunchLog "VisionModule configured: $mmprojFile" 'VISION'
+    } else {
+        # Auto-detect: scan for mmproj*.gguf in the model folder
+        $folder = Get-ModelFolder -Key $Key -Def $Def -Backend $Backend
+        Write-LaunchLog "No VisionModule configured — scanning for mmproj*.gguf in $folder" 'VISION'
+        $localMmproj = Get-ChildItem -Path $folder -Filter 'mmproj*.gguf' -File | Select-Object -First 1
+        if ($localMmproj) {
+            $mmprojFile = $localMmproj.Name
+            $autoDetected = $true
+            Write-LaunchLog "Auto-detected mmproj: $($localMmproj.Name)" 'VISION'
+        } else {
+            # Also check Ollama root for llama.cpp backend
+            if ($Backend -eq 'llamacpp') {
+                $ollamaFolder = Join-Path $script:Cfg.OllamaCommunityRoot $Def.Root
+                Write-LaunchLog "Scanning Ollama root for mmproj*.gguf: $ollamaFolder" 'VISION'
+                $localMmproj = Get-ChildItem -Path $ollamaFolder -Filter 'mmproj*.gguf' -File | Select-Object -First 1
+                if ($localMmproj) {
+                    $mmprojFile = $localMmproj.Name
+                    $autoDetected = $true
+                    Write-LaunchLog "Auto-detected mmproj in Ollama root: $($localMmproj.Name)" 'VISION'
+                }
+            }
+        }
+        if (-not $mmprojFile) {
+            if ($Def.ContainsKey('Repo') -and -not [string]::IsNullOrWhiteSpace($Def.Repo)) {
+                Write-LaunchLog "No local mmproj found, querying HF: $($Def.Repo)" 'VISION'
+                $hfFiles = Get-HuggingFaceMmprojFiles -Repo $Def.Repo
+                if ($null -eq $hfFiles) {
+                    Write-LaunchLog "HF query failed (network/SSL) — skipping HF fallback for $Key" 'WARN'
+                } elseif ($hfFiles.Count -gt 0) {
+                    $mmprojFile = @($hfFiles.Keys)[0]
+                    Write-LaunchLog "Found mmproj on HF: $mmprojFile" 'VISION'
+                }
+            }
+            if (-not $mmprojFile) {
+                Write-LaunchLog "No mmproj found locally or on HF for $Key" 'WARN'
+                return $null
+            }
+        }
+    }
+
+    $folder = Get-ModelFolder -Key $Key -Def $Def -Backend $Backend
+
+    # For llama.cpp, try to hardlink from Ollama root first.
+    if ($Backend -eq 'llamacpp') {
+        $llamaPath = Resolve-HuggingFaceLocalPath -DestinationFolder $folder -FileName $mmprojFile
+        if (Test-Path $llamaPath) {
+            Write-LaunchLog "Found existing mmproj in llama.cpp folder: $llamaPath" 'VISION'
+            return $llamaPath
+        }
+
+        $ollamaFolder = Join-Path $script:Cfg.OllamaCommunityRoot $Def.Root
+        $ollamaPath = Resolve-HuggingFaceLocalPath -DestinationFolder $ollamaFolder -FileName $mmprojFile
+        if (Test-Path $ollamaPath) {
+            Write-LaunchLog "Found mmproj in Ollama root, linking to llama.cpp: $ollamaPath -> $llamaPath" 'VISION'
+            try {
+                New-Item -ItemType HardLink -Path $llamaPath -Target $ollamaPath -ErrorAction Stop | Out-Null
+                Write-Host "Hardlinked existing mmproj: $llamaPath -> $ollamaPath" -ForegroundColor DarkGreen
+                return $llamaPath
+            } catch {
+                try {
+                    Copy-Item -LiteralPath $ollamaPath -Destination $llamaPath -ErrorAction Stop | Out-Null
+                    Write-Host "Copied existing mmproj (cross-volume): $llamaPath" -ForegroundColor DarkGreen
+                    return $llamaPath
+                } catch {
+                    Write-Warning "Could not reuse Ollama mmproj at $ollamaPath : $($_.Exception.Message)"
+                }
+            }
+        } else {
+            Write-LaunchLog "mmproj not in Ollama root, will download to $folder" 'VISION'
+        }
+    }
+
+    if ($autoDetected) {
+        Write-LaunchLog "Reusing auto-detected mmproj: $mmprojFile" 'VISION'
+        $localPath = Resolve-HuggingFaceLocalPath -DestinationFolder $folder -FileName $mmprojFile
+        if (Test-Path $localPath) {
+            return $localPath
+        }
+    }
+
+    Write-LaunchLog "Downloading mmproj from HF repo: $($Def.Repo), file: $mmprojFile" 'VISION'
+    $mmprojPath = Download-HuggingFaceFile -Repo $Def.Repo -FileName $mmprojFile -DestinationFolder $folder
+
+    if ($mmprojPath -is [array]) {
+        $mmprojPath = $mmprojPath[-1]
+    }
+
+    if (-not ($mmprojPath -is [string])) {
+        throw "Expected mmproj path to be a string."
+    }
+
+    Write-LaunchLog "Resolved mmproj path: $mmprojPath" 'VISION'
+    return $mmprojPath
+}
+
+function Test-ModelVisionModuleAvailable {
+    # Checks whether the mmproj.gguf for a model exists locally, and if not,
+    # whether it is available on HuggingFace. Returns a hashtable with:
+    #   Local        : $true/$false  (file exists in the model folder or Ollama root)
+    #   AvailableOnHF: $true/$false  (mmproj file listed on the HF repo)
+    #   Filename     : ''            (the mmproj filename, when known)
+    param(
+        [Parameter(Mandatory = $true)][string]$Key,
+        [Parameter(Mandatory = $true)][System.Collections.IDictionary]$Def,
+        [ValidateSet('ollama', 'llamacpp')][string]$Backend = 'ollama'
+    )
+
+    $result = @{
+        Local           = $false
+        AvailableOnHF   = $false
+        Filename        = ''
+    }
+
+    # Determine which mmproj filename to look for. If VisionModule is configured, use that;
+    # otherwise scan HF for any available mmproj files.
+    $mmprojFile = if ($Def.ContainsKey('VisionModule') -and -not [string]::IsNullOrWhiteSpace($def.VisionModule)) {
+        Write-LaunchLog "[vision/test] VisionModule configured: $($def.VisionModule)"  'VISION'
+        [string]$Def.VisionModule
+    } else {
+        Write-LaunchLog "[vision/test] No VisionModule configured, will auto-detect"  'VISION'
+        ''
+    }
+
+    if ($mmprojFile) {
+        $result.Filename = $mmprojFile
+    }
+    $folder = Get-ModelFolder -Key $Key -Def $Def -Backend $Backend
+    Write-LaunchLog "[vision/test] Checking local mmproj for $Key (backend=$Backend, folder=$folder)"  'VISION'
+
+    # Check llama.cpp folder first.
+    if ($Backend -eq 'llamacpp') {
+        if ($mmprojFile) {
+            $llamaPath = Resolve-HuggingFaceLocalPath -DestinationFolder $folder -FileName $mmprojFile
+            Write-LaunchLog "[vision/test]  llama.cpp: checking $($llamaPath) ..."  'VISION'
+            if (Test-Path $llamaPath) {
+                Write-LaunchLog "[vision/test]  Found in llama.cpp folder"  'VISION'
+                $result.Local = $true
+                return $result
+            }
+        } else {
+            # No VisionModule configured — scan for any mmproj files locally
+            $localMmproj = Get-ChildItem -Path $folder -Filter 'mmproj*.gguf' -File | Select-Object -First 1
+            if ($localMmproj) {
+                Write-LaunchLog "[vision/test]  Auto-detected $($localMmproj.Name) in llama.cpp folder"  'VISION'
+                $result.Local = $true
+                $result.Filename = $localMmproj.Name
+                return $result
+            }
+        }
+
+        # Also check Ollama root as fallback.
+        $ollamaFolder = Join-Path $script:Cfg.OllamaCommunityRoot $Def.Root
+        if ($mmprojFile) {
+            $ollamaPath = Resolve-HuggingFaceLocalPath -DestinationFolder $ollamaFolder -FileName $mmprojFile
+            Write-LaunchLog "[vision/test]  Ollama root: checking $($ollamaPath) ..."  'VISION'
+            if (Test-Path $ollamaPath) {
+                Write-LaunchLog "[vision/test]  Found in Ollama root"
+                $result.Local = $true
+                return $result
+            }
+        } else {
+            $localMmproj = Get-ChildItem -Path $ollamaFolder -Filter 'mmproj*.gguf' -File | Select-Object -First 1
+            if ($localMmproj) {
+                Write-LaunchLog "[vision/test]  Auto-detected $($localMmproj.Name) in Ollama root"  'VISION'
+                $result.Local = $true
+                $result.Filename = $localMmproj.Name
+                return $result
+            }
+        }
+    }
+
+    # Check Ollama root for ollama backend.
+    if ($Backend -eq 'ollama') {
+        $ollamaFolder = Join-Path $script:Cfg.OllamaCommunityRoot $Def.Root
+        if ($mmprojFile) {
+            $ollamaPath = Resolve-HuggingFaceLocalPath -DestinationFolder $ollamaFolder -FileName $mmprojFile
+            Write-LaunchLog "[vision/test]  Ollama: checking $($ollamaPath) ..."  'VISION'
+            if (Test-Path $ollamaPath) {
+                Write-LaunchLog "[vision/test]  Found in Ollama folder"  'VISION'
+                $result.Local = $true
+                return $result
+            }
+        } else {
+            $localMmproj = Get-ChildItem -Path $ollamaFolder -Filter 'mmproj*.gguf' -File | Select-Object -First 1
+            if ($localMmproj) {
+                Write-LaunchLog "[vision/test]  Auto-detected $($localMmproj.Name) in Ollama root"  'VISION'
+                $result.Local = $true
+                $result.Filename = $localMmproj.Name
+                return $result
+            }
+        }
+    }
+
+    Write-LaunchLog "[vision/test] No local mmproj found for $Key, checking HuggingFace..."  'VISION'
+
+    # Not local — check HF for availability.
+    if ($Def.ContainsKey('Repo') -and -not [string]::IsNullOrWhiteSpace($Def.Repo)) {
+        $mmprojFiles = Get-HuggingFaceMmprojFiles -Repo $Def.Repo
+        if ($null -eq $mmprojFiles) {
+            Write-LaunchLog "[vision/test] HF check skipped for $Key (network/SSL error)" 'WARN'
+        } elseif ($mmprojFiles.Count -gt 0) {
+            Write-LaunchLog "[vision/test] HF has $($mmprojFiles.Count) mmproj file(s): $($mmprojFiles.Keys -join ', ')"  'VISION'
+            $result.AvailableOnHF = $true
+            # If no specific VisionModule configured, pick the first available mmproj
+            if (-not $mmprojFile) {
+                $mmprojFile = @($mmprojFiles.Keys)[0]
+                $result.Filename = $mmprojFile
+            } elseif ($mmprojFiles.ContainsKey($mmprojFile)) {
+                $result.AvailableOnHF = $true
+            }
+        } else {
+            Write-LaunchLog "[vision/test] No mmproj files on HF for $($Def.Repo)"  'VISION'
+        }
+    }
+
+    Write-LaunchLog "[vision/test] Result for ${Key}: Local=$($result.Local), HF=$($result.AvailableOnHF), File='$($result.Filename)'"  'VISION'
+    return $result
+}

local-llm/lib/35-backend.ps1

@@ -54,6 +54,7 @@ function Invoke-Backend {
         [switch]$Unshackled,
         [switch]$Codex,
         [switch]$Strict,
+        [switch]$UseVision,
         [switch]$AutoBest,
         [ValidateSet('auto','pure','balanced','short','long')][string]$AutoBestProfile = 'auto',
         [string[]]$ExtraArgs,
@@ -92,7 +93,7 @@ function Invoke-Backend {
         'launch-claude' {
             switch ($Backend) {
                 'ollama' {
-                    Invoke-ModelShortcut -Key $Key -ContextKey $ContextKey -UseQ8:$UseQ8 -Unshackled:$Unshackled -Codex:$Codex -Strict:$Strict -ExtraUnshackledArgs $ExtraUnshackledArgs -DryRun:$DryRun
+                    Invoke-ModelShortcut -Key $Key -ContextKey $ContextKey -UseQ8:$UseQ8 -Unshackled:$Unshackled -Codex:$Codex -Strict:$Strict -UseVision:$UseVision -ExtraUnshackledArgs $ExtraUnshackledArgs -DryRun:$DryRun
                 }
                 'llamacpp' {
                     $mode = Resolve-LlamaCppMode -Mode $LlamaCppMode
@@ -106,6 +107,7 @@ function Invoke-Backend {
                         -Unshackled:$Unshackled `
                         -Codex:$Codex `
                         -Strict:$Strict `
+                        -UseVision:$UseVision `
                         -AutoBest:$AutoBest `
                         -AutoBestProfile $AutoBestProfile `
                         -ExtraArgs $ExtraArgs `

local-llm/lib/40-parsers.ps1

@@ -65,8 +65,8 @@ function Get-ParserLines {
 # and only OVERRIDES sampling parameters and SYSTEM. Add new model families to
 # Get-ParserLines without touching this — strict keeps working.
 #
-# num_ctx is intentionally omitted: it's set per-alias by the caller, mirroring
-# the base model's default-context value (Get-ModelStrictBaseContextKey).
+# num_ctx is intentionally omitted: it's set per-alias by the caller, matching
+# the selected base context.
 function Get-StrictModelfileLines {
     $lines = New-Object System.Collections.Generic.List[string]