v1.21.3 — Agent installer failsafe retry and diagnostics

If company defaults weren't loaded during startup, agent installer
now automatically retries loading them before showing the error.
Diagnostic output (ModuleRoot, CompanyDefaults, ToolName, BaseURL)
shown if still misconfigured to aid troubleshooting.

Author: TheAbider

Changelog.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## v1.21.3
+
+- **Bug Fix:** Agent installer failsafe — if company defaults weren't loaded during startup, automatically retry loading when agent installer is accessed. Shows diagnostic info if still misconfigured.
+- 64 modules, 2291 tests
+
 ## v1.21.2
 
 - **Bug Fix:** Company defaults loading — first-run wizard no longer saves built-in defaults that overwrite company values on reload; company defaults files (*.defaults.json) are now properly detected and prompted even when defaults.json already exists (56-OperationsMenu).

Header.ps1

@@ -30,7 +30,7 @@
     7h3 4b1d3r
 
 .VERSION
-    1.21.2
+    1.21.3
 
 .LAST UPDATED
     03/09/2026

Modules/00-Initialization.ps1

@@ -134,7 +134,7 @@ if (-not $script:ModuleRoot) { $script:ModuleRoot = $PSScriptRoot }
 if (-not $script:ModuleRoot -and $script:ScriptPath) {
     $script:ModuleRoot = [System.IO.Path]::GetDirectoryName($script:ScriptPath)
 }
-$script:ScriptVersion = "1.21.2"
+$script:ScriptVersion = "1.21.3"
 $script:ScriptStartTime = Get-Date
 
 # OS version detection (for feature compatibility)

Modules/57-AgentInstaller.ps1

@@ -577,6 +577,32 @@ function Install-Agent {
 
     # --- Section: Pre-check - Feature Configuration ---
     if (-not (Test-AgentInstallerConfigured)) {
+        # Safety net: if company defaults exist but weren't loaded, retry now
+        if (-not $script:CompanyDefaultsPath) {
+            $retryFiles = @(Get-CompanyDefaultsFiles)
+            if ($retryFiles.Count -gt 0) {
+                # Company defaults file exists but wasn't loaded — force reload
+                if ($retryFiles.Count -eq 1) {
+                    $script:CompanyDefaultsName = $retryFiles[0].Name
+                    $script:CompanyDefaultsPath = $retryFiles[0].Path
+                } else {
+                    $picked = Show-CompanyDefaultsPicker
+                    if ($null -ne $picked -and $picked -ne "__skip__") {
+                        $script:CompanyDefaultsName = $picked.Name
+                        $script:CompanyDefaultsPath = $picked.Path
+                    }
+                }
+                if ($script:CompanyDefaultsPath) {
+                    Import-Defaults
+                    if (Test-AgentInstallerConfigured) {
+                        # Retry succeeded — continue to agent installer
+                        Install-Agent @PSBoundParameters
+                        return
+                    }
+                }
+            }
+        }
+
         Clear-Host
         Write-OutputColor "" -color "Info"
         Write-OutputColor "  ╔════════════════════════════════════════════════════════════════════════╗" -color "Info"
@@ -592,6 +618,12 @@ function Install-Agent {
             Write-OutputColor "  in defaults.json or company defaults to enable this feature." -color "Warning"
         }
         Write-OutputColor "" -color "Info"
+        # Diagnostic info to help troubleshoot
+        Write-OutputColor "  Debug: ModuleRoot = $script:ModuleRoot" -color "Debug"
+        Write-OutputColor "  Debug: CompanyDefaults = $script:CompanyDefaultsPath" -color "Debug"
+        Write-OutputColor "  Debug: ToolName = $script:AgentInstaller.ToolName" -color "Debug"
+        Write-OutputColor "  Debug: BaseURL = $script:FileServer.BaseURL" -color "Debug"
+        Write-OutputColor "" -color "Info"
         Write-PressEnter
         return
     }

RackStack.ps1

@@ -13,7 +13,7 @@
     Environment-specific settings are configured via defaults.json.
 
 .VERSION
-    1.21.2
+    1.21.3
 
 .NOTES
     - Requires Windows Server 2012 R2 or later (or Windows 10/11 for testing)

Tests/Run-Tests.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Automated Test Runner for RackStack v1.21.2
+    Automated Test Runner for RackStack v1.21.3
 
 .DESCRIPTION
     Comprehensive non-interactive test suite covering: