Add environment report export

config/feature.json

@@ -179,6 +179,15 @@
     "function": "Invoke-WPFFixesWinget",
     "link": "https://winutil.christitus.com/code-reference/features/fixes/winget"
   },
+  "WPFExportEnvironmentReport": {
+    "Content": "Export Environment Report",
+    "category": "Diagnostics",
+    "panel": "1",
+    "Type": "Button",
+    "ButtonWidth": "300",
+    "function": "Invoke-WPFExportEnvironmentReport",
+    "link": "https://winutil.christitus.com/code-reference/features/diagnostics/exportenvironmentreport"
+  },
   "WPFPanelComputer": {
     "Content": "Computer Management",
     "category": "Legacy Windows Panels",

docs/src/content/docs/guides/features.mdx

@@ -39,6 +39,12 @@ Use these when you have a specific issue to correct, not as a routine cleanup st
 * System Corruption Scan
 * WinGet Reinstall
 
+## Diagnostics
+
+Use **Export Environment Report** to save a read-only JSON report for troubleshooting. It contains only Windows edition, version, build, architecture, CPU model, logical processor count, total memory, PowerShell edition and version, the installed/version state of Git, Java, Node.js, Python, and Docker, and whether Hyper-V, WSL, and Windows Sandbox are enabled.
+
+The report does not include computer or user names, paths, IP or MAC addresses, serial numbers, installed-app inventories, services, registry data, secrets, or logs. WinUtil does not upload the report.
+
 ## Legacy Windows Panels
 
 Open old-school Windows panels directly from WinUtil. Available panels include:

functions/private/Get-WinUtilEnvironmentReport.ps1

@@ -0,0 +1,103 @@
+function Get-WinUtilEnvironmentReport {
+    <#
+    .SYNOPSIS
+        Collects the allowlisted data used by the WinUtil environment report.
+    #>
+
+    $windows = [ordered]@{
+        edition      = $null
+        version      = $null
+        buildNumber  = $null
+        architecture = $null
+    }
+    $hardware = [ordered]@{
+        cpuModel              = $null
+        logicalProcessorCount = $null
+        totalMemoryGB         = $null
+    }
+
+    try {
+        $operatingSystem = Get-CimInstance -ClassName Win32_OperatingSystem -ErrorAction Stop
+        $windows.edition = $operatingSystem.Caption
+        $windows.version = $operatingSystem.Version
+        $windows.buildNumber = $operatingSystem.BuildNumber
+        $windows.architecture = $operatingSystem.OSArchitecture
+
+        if ($null -ne $operatingSystem.TotalVisibleMemorySize) {
+            $hardware.totalMemoryGB = [math]::Round(([double]$operatingSystem.TotalVisibleMemorySize / 1MB), 2)
+        }
+    } catch {
+    }
+
+    try {
+        $processors = @(Get-CimInstance -ClassName Win32_Processor -ErrorAction Stop)
+        if ($processors.Count -gt 0) {
+            $hardware.cpuModel = $processors[0].Name
+            $hardware.logicalProcessorCount = [int](($processors | Measure-Object -Property NumberOfLogicalProcessors -Sum).Sum)
+        }
+    } catch {
+    }
+
+    $developerTools = [ordered]@{}
+    $toolDefinitions = [ordered]@{
+        git = @("git", "--version")
+        java = @("java", "-version")
+        nodejs = @("node", "--version")
+        python = @("python", "--version")
+        docker = @("docker", "--version")
+    }
+
+    foreach ($toolName in $toolDefinitions.Keys) {
+        $toolReport = [ordered]@{
+            installed = $false
+            version   = $null
+        }
+
+        try {
+            $command = Get-Command -Name $toolDefinitions[$toolName][0] -CommandType Application -ErrorAction Stop |
+                Select-Object -First 1
+            if ($null -ne $command) {
+                $toolReport.installed = $true
+                $output = @(& $command.Source $toolDefinitions[$toolName][1] 2>&1 | ForEach-Object { $_.ToString().Trim() }) -join "`n"
+                $versionMatch = [regex]::Match($output, '\d+(?:\.\d+)+(?:[-+._A-Za-z0-9]+)?')
+                if ($versionMatch.Success) {
+                    $toolReport.version = $versionMatch.Value
+                }
+            }
+        } catch {
+        }
+
+        $developerTools[$toolName] = [pscustomobject]$toolReport
+    }
+
+    $windowsFeatures = [ordered]@{}
+    $featureDefinitions = [ordered]@{
+        hyperV = "Microsoft-Hyper-V-All"
+        wsl = "Microsoft-Windows-Subsystem-Linux"
+        windowsSandbox = "Containers-DisposableClientVM"
+    }
+
+    foreach ($featureName in $featureDefinitions.Keys) {
+        $featureReport = [ordered]@{ enabled = $false }
+        try {
+            $feature = Get-WindowsOptionalFeature -Online -FeatureName $featureDefinitions[$featureName] -ErrorAction Stop
+            $featureReport.enabled = $feature.State -eq "Enabled"
+        } catch {
+        }
+
+        $windowsFeatures[$featureName] = [pscustomobject]$featureReport
+    }
+
+    return [pscustomobject][ordered]@{
+        schemaVersion   = "1.0"
+        generatedAtUtc  = [DateTime]::UtcNow.ToString("o")
+        windows         = [pscustomobject]$windows
+        hardware        = [pscustomobject]$hardware
+        powershell      = [pscustomobject][ordered]@{
+            edition = $PSVersionTable.PSEdition
+            version = $PSVersionTable.PSVersion.ToString()
+        }
+        developerTools  = [pscustomobject]$developerTools
+        windowsFeatures = [pscustomobject]$windowsFeatures
+    }
+}

functions/public/Invoke-WPFExportEnvironmentReport.ps1

@@ -0,0 +1,39 @@
+function Invoke-WPFExportEnvironmentReport {
+    <#
+    .SYNOPSIS
+        Exports an allowlisted, read-only environment report as JSON.
+    #>
+
+    try {
+        Add-Type -AssemblyName System.Windows.Forms
+        $dialog = [System.Windows.Forms.SaveFileDialog]::new()
+        $dialog.Title = "Export Environment Report"
+        $dialog.Filter = "JSON files (*.json)|*.json"
+        $dialog.FileName = "WinUtilEnvironmentReport_$(Get-Date -Format 'yyyyMMdd').json"
+        $dialog.InitialDirectory = [Environment]::GetFolderPath("Desktop")
+
+        if ($dialog.ShowDialog() -ne [System.Windows.Forms.DialogResult]::OK) {
+            return
+        }
+
+        $report = Get-WinUtilEnvironmentReport
+        $json = $report | ConvertTo-Json -Depth 6
+        [System.IO.File]::WriteAllText($dialog.FileName, $json, [System.Text.UTF8Encoding]::new($false))
+
+        Write-WinUtilLog -Component "EnvironmentReport" -Message "Environment report exported."
+        [System.Windows.MessageBox]::Show(
+            "The environment report was exported successfully.",
+            "Environment Report",
+            "OK",
+            "Information"
+        ) | Out-Null
+    } catch {
+        Write-WinUtilLog -Component "EnvironmentReport" -Level "ERROR" -Message "Environment report export failed: $($_.Exception.Message)"
+        [System.Windows.MessageBox]::Show(
+            "The environment report could not be exported. $($_.Exception.Message)",
+            "Environment Report",
+            "OK",
+            "Error"
+        ) | Out-Null
+    }
+}

pester/environment-report.Tests.ps1

@@ -0,0 +1,68 @@
+#===========================================================================
+# Tests - Environment Report
+#===========================================================================
+
+BeforeAll {
+    . (Join-Path (Resolve-Path (Join-Path $PSScriptRoot "..")) "functions\private\Get-WinUtilEnvironmentReport.ps1")
+}
+
+Describe "Get-WinUtilEnvironmentReport" {
+    BeforeEach {
+        Mock Get-Command { $null } -ParameterFilter { $CommandType -eq "Application" }
+        Mock Get-CimInstance {
+            switch ($ClassName) {
+                "Win32_OperatingSystem" {
+                    return [pscustomobject]@{
+                        Caption = "Windows 11 Pro"
+                        Version = "10.0.26100"
+                        BuildNumber = "26100"
+                        OSArchitecture = "64-bit"
+                        TotalVisibleMemorySize = 16777216
+                    }
+                }
+                "Win32_Processor" {
+                    return [pscustomobject]@{
+                        Name = "Example CPU"
+                        NumberOfLogicalProcessors = 8
+                    }
+                }
+            }
+        }
+        Mock Get-WindowsOptionalFeature {
+            return [pscustomobject]@{ State = "Enabled" }
+        }
+    }
+
+    It "returns the versioned allowlisted report schema" {
+        $report = Get-WinUtilEnvironmentReport
+
+        $report.schemaVersion | Should -Be "1.0"
+        $report.generatedAtUtc | Should -Match '^\d{4}-\d{2}-\d{2}T'
+        $report.windows.edition | Should -Be "Windows 11 Pro"
+        $report.hardware.cpuModel | Should -Be "Example CPU"
+        $report.hardware.logicalProcessorCount | Should -Be 8
+        $report.hardware.totalMemoryGB | Should -Be 16
+        $report.powershell.PSObject.Properties.Name | Should -Be @("edition", "version")
+        $report.developerTools.PSObject.Properties.Name | Should -Be @("git", "java", "nodejs", "python", "docker")
+        $report.windowsFeatures.PSObject.Properties.Name | Should -Be @("hyperV", "wsl", "windowsSandbox")
+        $report.windowsFeatures.hyperV.enabled | Should -BeTrue
+    }
+
+    It "contains no fields outside the approved report schema" {
+        $report = Get-WinUtilEnvironmentReport | ConvertTo-Json -Depth 6
+
+        $report | Should -Not -Match 'ComputerName|UserName|UserProfile|IPAddress|MacAddress|SerialNumber|ProductKey|Environment'
+    }
+
+    It "keeps missing developer tools and unavailable features non-terminating" {
+        Mock Get-WindowsOptionalFeature { throw "Feature unavailable" }
+
+        $report = Get-WinUtilEnvironmentReport
+
+        $report.developerTools.git.installed | Should -BeFalse
+        $report.developerTools.git.version | Should -BeNullOrEmpty
+        $report.windowsFeatures.hyperV.enabled | Should -BeFalse
+        $report.windowsFeatures.wsl.enabled | Should -BeFalse
+        $report.windowsFeatures.windowsSandbox.enabled | Should -BeFalse
+    }
+}

tools/devdocs-generator.ps1

@@ -271,6 +271,7 @@ $documentedCategories = @(
     "Performance Plans",
     "Features",
     "Fixes",
+    "Diagnostics",
     "Legacy Windows Panels",
     "Powershell Profile Powershell 7+ Only",
     "Remote Access"
@@ -279,6 +280,7 @@ $documentedCategories = @(
 # Categories where Button entries embed a PS function instead of raw JSON
 $functionEmbedCategories = @(
     "Fixes",
+    "Diagnostics",
     "Powershell Profile Powershell 7+ Only",
     "Remote Access"
 )