windowsweep 1.0.1 → 1.2.0

package/modules/app_caches.ps1

@@ -1,58 +1,58 @@
-# app_caches.ps1 - section 8: desktop-app caches (Electron / Chromium-based apps) and superseded Squirrel versions.
-
-function Get-Targets08 {
-  $P = $Script:P
-  return @(
-    (New-Target 8 'Discord' "$($P.A)\discord" -Kind electron -Guard @('Discord'))
-    (New-Target 8 'Discord Canary' "$($P.A)\discordcanary" -Kind electron -Guard @('DiscordCanary'))
-    (New-Target 8 'Discord PTB' "$($P.A)\discordptb" -Kind electron -Guard @('DiscordPTB'))
-    (New-Target 8 'Slack' "$($P.A)\Slack" -Kind electron -Guard @('slack'))
-    (New-Target 8 'Slack (Store)' "$($P.L)\Packages\*slack*\LocalCache\Roaming\Slack" -Kind electron -Guard @('slack'))
-    (New-Target 8 'Microsoft Teams (classic)' "$($P.A)\Microsoft\Teams" -Kind electron -Guard @('Teams'))
-    (New-Target 8 'Microsoft Teams (new)' "$($P.L)\Packages\MSTeams_*\LocalCache\Microsoft\MSTeams\EBWebView\*" -Kind chromium -Guard @('ms-teams'))
-    (New-Target 8 'Zoom logs' "$($P.A)\Zoom\logs" -Mode clear-old -Days 30 -Guard @('Zoom'))
-    (New-Target 8 'Spotify streaming cache' "$($P.L)\Spotify\Storage" -Mode clear -Guard @('Spotify'))
-    (New-Target 8 'Spotify (Store) streaming cache' "$($P.L)\Packages\SpotifyAB.SpotifyMusic_*\LocalCache\Spotify\Storage" -Kind glob -Mode clear -Guard @('Spotify'))
-    (New-Target 8 'Postman' "$($P.A)\Postman" -Kind electron -Guard @('Postman'))
-    (New-Target 8 'Figma' "$($P.A)\Figma" -Kind electron -Guard @('Figma'))
-    (New-Target 8 'Notion' "$($P.A)\Notion" -Kind electron -Guard @('Notion'))
-    (New-Target 8 'Signal' "$($P.A)\Signal" -Kind electron -Guard @('Signal'))
-    (New-Target 8 'Skype' "$($P.A)\Microsoft\Skype for Desktop" -Kind electron -Guard @('Skype'))
-    (New-Target 8 'GitHub Desktop' "$($P.A)\GitHub Desktop" -Kind electron -Guard @('GitHubDesktop'))
-    (New-Target 8 'Obsidian' "$($P.A)\obsidian" -Kind electron -Guard @('Obsidian'))
-    (New-Target 8 'Claude desktop app' "$($P.A)\Claude" -Kind electron -Guard @('Claude'))
-    (New-Target 8 'Linear' "$($P.A)\Linear" -Kind electron -Guard @('Linear'))
-    (New-Target 8 'Granola' "$($P.A)\Granola" -Kind electron -Guard @('Granola'))
-    (New-Target 8 'Insomnia' "$($P.A)\Insomnia" -Kind electron -Guard @('Insomnia'))
-    (New-Target 8 'Steam web cache' "$($P.L)\Steam\htmlcache" -Mode clear -Guard @('steam'))
-    (New-Target 8 'Epic Games Launcher web cache' "$($P.L)\EpicGamesLauncher\Saved\webcache*" -Kind glob -Mode clear -Guard @('EpicGamesLauncher'))
-    (New-Target 8 'Epic Games Launcher logs' "$($P.L)\EpicGamesLauncher\Saved\Logs" -Mode clear-old -Days 30)
-    (New-Target 8 'Adobe media cache files' "$($P.A)\Adobe\Common\Media Cache Files" -Mode prune -Guard @('Adobe Premiere Pro', 'AfterFX', 'Adobe Audition') -Note 'Premiere / After Effects rebuild them on open')
-    (New-Target 8 'Adobe media cache database' "$($P.A)\Adobe\Common\Media Cache" -Mode prune -Guard @('Adobe Premiere Pro', 'AfterFX', 'Adobe Audition'))
-    (New-Target 8 'OBS Studio logs' "$($P.A)\obs-studio\logs" -Mode clear-old -Days 30)
-    (New-Target 8 'OBS Studio crash reports' "$($P.A)\obs-studio\crashes" -Mode clear-old -Days 30)
-    (New-Target 8 'Squirrel installer temp' "$($P.L)\SquirrelTemp" -Mode clear)
-    (New-Target 8 'Electron updater downloads' "$($P.L)\@*-updater" -Kind glob -Mode clear-old -Days 7 -Note 'pending update installers older than a week')
-    (New-Target 8 'Discord superseded versions' "$($P.L)\Discord" -Kind cmd -Guard @('Discord') -Note 'app-x.y.z folders other than the newest')
-    (New-Target 8 'Postman superseded versions' "$($P.L)\Postman" -Kind cmd -Guard @('Postman'))
-    (New-Target 8 'Figma superseded versions' "$($P.L)\Figma" -Kind cmd -Guard @('Figma'))
-    (New-Target 8 'GitHub Desktop superseded versions' "$($P.L)\GitHubDesktop" -Kind cmd -Guard @('GitHubDesktop'))
-    (New-Target 8 'Slack superseded versions' "$($P.L)\slack" -Kind cmd -Guard @('slack'))
-  )
-}
-
-function Invoke-Section08 {
-  Write-SectionIntro @(
-    'Chat, design and API apps are browsers in disguise: their Cache, Code Cache and GPU caches rebuild on the next',
-    'start, and installers that keep old app-x.y.z versions beside the current one waste space. Accounts, chat',
-    'databases and settings are never touched; a running app is skipped.'
-  )
-  $targets = Get-Targets08
-  $null = Show-TargetSizes @($targets | Where-Object { $_.Kind -ne 'cmd' })
-  if (-not (Confirm-Section 'Clean desktop-app caches now?')) { Write-Info 'skipped'; return }
-  $null = Invoke-TargetList @($targets | Where-Object { $_.Kind -ne 'cmd' })
-  foreach ($t in @($targets | Where-Object { $_.Kind -eq 'cmd' })) {
-    if (-not (Test-DirPresent $t.Path)) { continue }
-    $null = Remove-SupersededVersions -Root $t.Path -Guard $t.Guard -Label $t.Label
-  }
-}
+# app_caches.ps1 - section 8: desktop-app caches (Electron / Chromium-based apps) and superseded Squirrel versions.
+
+function Get-Targets08 {
+  $P = $Script:P
+  return @(
+    (New-Target 8 'Discord' "$($P.A)\discord" -Kind electron -Guard @('Discord'))
+    (New-Target 8 'Discord Canary' "$($P.A)\discordcanary" -Kind electron -Guard @('DiscordCanary'))
+    (New-Target 8 'Discord PTB' "$($P.A)\discordptb" -Kind electron -Guard @('DiscordPTB'))
+    (New-Target 8 'Slack' "$($P.A)\Slack" -Kind electron -Guard @('slack'))
+    (New-Target 8 'Slack (Store)' "$($P.L)\Packages\*slack*\LocalCache\Roaming\Slack" -Kind electron -Guard @('slack'))
+    (New-Target 8 'Microsoft Teams (classic)' "$($P.A)\Microsoft\Teams" -Kind electron -Guard @('Teams'))
+    (New-Target 8 'Microsoft Teams (new)' "$($P.L)\Packages\MSTeams_*\LocalCache\Microsoft\MSTeams\EBWebView\*" -Kind chromium -Guard @('ms-teams'))
+    (New-Target 8 'Zoom logs' "$($P.A)\Zoom\logs" -Mode clear-old -Days 30 -Guard @('Zoom'))
+    (New-Target 8 'Spotify streaming cache' "$($P.L)\Spotify\Storage" -Mode clear -Guard @('Spotify'))
+    (New-Target 8 'Spotify (Store) streaming cache' "$($P.L)\Packages\SpotifyAB.SpotifyMusic_*\LocalCache\Spotify\Storage" -Kind glob -Mode clear -Guard @('Spotify'))
+    (New-Target 8 'Postman' "$($P.A)\Postman" -Kind electron -Guard @('Postman'))
+    (New-Target 8 'Figma' "$($P.A)\Figma" -Kind electron -Guard @('Figma'))
+    (New-Target 8 'Notion' "$($P.A)\Notion" -Kind electron -Guard @('Notion'))
+    (New-Target 8 'Signal' "$($P.A)\Signal" -Kind electron -Guard @('Signal'))
+    (New-Target 8 'Skype' "$($P.A)\Microsoft\Skype for Desktop" -Kind electron -Guard @('Skype'))
+    (New-Target 8 'GitHub Desktop' "$($P.A)\GitHub Desktop" -Kind electron -Guard @('GitHubDesktop'))
+    (New-Target 8 'Obsidian' "$($P.A)\obsidian" -Kind electron -Guard @('Obsidian'))
+    (New-Target 8 'Claude desktop app' "$($P.A)\Claude" -Kind electron -Guard @('Claude'))
+    (New-Target 8 'Linear' "$($P.A)\Linear" -Kind electron -Guard @('Linear'))
+    (New-Target 8 'Granola' "$($P.A)\Granola" -Kind electron -Guard @('Granola'))
+    (New-Target 8 'Insomnia' "$($P.A)\Insomnia" -Kind electron -Guard @('Insomnia'))
+    (New-Target 8 'Steam web cache' "$($P.L)\Steam\htmlcache" -Mode clear -Guard @('steam'))
+    (New-Target 8 'Epic Games Launcher web cache' "$($P.L)\EpicGamesLauncher\Saved\webcache*" -Kind glob -Mode clear -Guard @('EpicGamesLauncher'))
+    (New-Target 8 'Epic Games Launcher logs' "$($P.L)\EpicGamesLauncher\Saved\Logs" -Mode clear-old -Days 30)
+    (New-Target 8 'Adobe media cache files' "$($P.A)\Adobe\Common\Media Cache Files" -Mode prune -Guard @('Adobe Premiere Pro', 'AfterFX', 'Adobe Audition') -Note 'Premiere / After Effects rebuild them on open')
+    (New-Target 8 'Adobe media cache database' "$($P.A)\Adobe\Common\Media Cache" -Mode prune -Guard @('Adobe Premiere Pro', 'AfterFX', 'Adobe Audition'))
+    (New-Target 8 'OBS Studio logs' "$($P.A)\obs-studio\logs" -Mode clear-old -Days 30)
+    (New-Target 8 'OBS Studio crash reports' "$($P.A)\obs-studio\crashes" -Mode clear-old -Days 30)
+    (New-Target 8 'Squirrel installer temp' "$($P.L)\SquirrelTemp" -Mode clear)
+    (New-Target 8 'Electron updater downloads' "$($P.L)\@*-updater" -Kind glob -Mode clear-old -Days 7 -Note 'pending update installers older than a week')
+    (New-Target 8 'Discord superseded versions' "$($P.L)\Discord" -Kind cmd -Guard @('Discord') -Note 'app-x.y.z folders other than the newest')
+    (New-Target 8 'Postman superseded versions' "$($P.L)\Postman" -Kind cmd -Guard @('Postman'))
+    (New-Target 8 'Figma superseded versions' "$($P.L)\Figma" -Kind cmd -Guard @('Figma'))
+    (New-Target 8 'GitHub Desktop superseded versions' "$($P.L)\GitHubDesktop" -Kind cmd -Guard @('GitHubDesktop'))
+    (New-Target 8 'Slack superseded versions' "$($P.L)\slack" -Kind cmd -Guard @('slack'))
+  )
+}
+
+function Invoke-Section08 {
+  Write-SectionIntro @(
+    'Chat, design and API apps are browsers in disguise: their Cache, Code Cache and GPU caches rebuild on the next',
+    'start, and installers that keep old app-x.y.z versions beside the current one waste space. Accounts, chat',
+    'databases and settings are never touched; a running app is skipped.'
+  )
+  $targets = Get-Targets08
+  $null = Show-TargetSizes @($targets | Where-Object { $_.Kind -ne 'cmd' })
+  if (-not (Confirm-Section 'Clean desktop-app caches now?')) { Write-Info 'skipped'; return }
+  $null = Invoke-TargetList @($targets | Where-Object { $_.Kind -ne 'cmd' })
+  foreach ($t in @($targets | Where-Object { $_.Kind -eq 'cmd' })) {
+    if (-not (Test-DirPresent $t.Path)) { continue }
+    $null = Remove-SupersededVersions -Root $t.Path -Guard $t.Guard -Label $t.Label
+  }
+}

package/modules/browsers.ps1

@@ -1,33 +1,33 @@
-# browsers.ps1 - section 7: browser caches for every profile. Profile data is never touched.
-
-function Get-Targets07 {
-  $P = $Script:P
-  return @(
-    (New-Target 7 'Google Chrome' "$($P.L)\Google\Chrome\User Data" -Kind chromium -Guard @('chrome') -Note 'cache folders of every profile')
-    (New-Target 7 'Google Chrome Beta' "$($P.L)\Google\Chrome Beta\User Data" -Kind chromium -Guard @('chrome'))
-    (New-Target 7 'Google Chrome Dev' "$($P.L)\Google\Chrome Dev\User Data" -Kind chromium -Guard @('chrome'))
-    (New-Target 7 'Google Chrome Canary' "$($P.L)\Google\Chrome SxS\User Data" -Kind chromium -Guard @('chrome'))
-    (New-Target 7 'Microsoft Edge' "$($P.L)\Microsoft\Edge\User Data" -Kind chromium -Guard @('msedge'))
-    (New-Target 7 'Brave' "$($P.L)\BraveSoftware\Brave-Browser\User Data" -Kind chromium -Guard @('brave'))
-    (New-Target 7 'Vivaldi' "$($P.L)\Vivaldi\User Data" -Kind chromium -Guard @('vivaldi'))
-    (New-Target 7 'Opera' "$($P.A)\Opera Software\Opera Stable" -Kind chromium -Guard @('opera'))
-    (New-Target 7 'Opera GX' "$($P.A)\Opera Software\Opera GX Stable" -Kind chromium -Guard @('opera'))
-    (New-Target 7 'Chromium' "$($P.L)\Chromium\User Data" -Kind chromium -Guard @('chrome', 'chromium'))
-    (New-Target 7 'Arc' "$($P.L)\Packages\TheBrowserCompany.Arc_*\LocalCache\Local\Arc\User Data" -Kind chromium -Guard @('Arc'))
-    (New-Target 7 'Firefox' "$($P.L)\Mozilla\Firefox\Profiles" -Kind firefox -Guard @('firefox') -Note 'cache2, startupCache, thumbnails, jumpListCache')
-    (New-Target 7 'LibreWolf' "$($P.L)\LibreWolf\Profiles" -Kind firefox -Guard @('librewolf'))
-    (New-Target 7 'Waterfox' "$($P.L)\Waterfox\Profiles" -Kind firefox -Guard @('waterfox'))
-  )
-}
-
-function Invoke-Section07 {
-  Write-SectionIntro @(
-    'Browser caches rebuild as you browse; the first page loads afterwards are a little slower. Cookies, logins,',
-    'history, bookmarks, extensions, Local Storage, IndexedDB and PWA CacheStorage are never touched.',
-    'A browser that is open right now is skipped - close it and run this section again.'
-  )
-  $targets = Get-Targets07
-  $null = Show-TargetSizes $targets
-  if (-not (Confirm-Section 'Clear browser caches now?')) { Write-Info 'skipped'; return }
-  $null = Invoke-TargetList $targets
-}
+# browsers.ps1 - section 7: browser caches for every profile. Profile data is never touched.
+
+function Get-Targets07 {
+  $P = $Script:P
+  return @(
+    (New-Target 7 'Google Chrome' "$($P.L)\Google\Chrome\User Data" -Kind chromium -Guard @('chrome') -Note 'cache folders of every profile')
+    (New-Target 7 'Google Chrome Beta' "$($P.L)\Google\Chrome Beta\User Data" -Kind chromium -Guard @('chrome'))
+    (New-Target 7 'Google Chrome Dev' "$($P.L)\Google\Chrome Dev\User Data" -Kind chromium -Guard @('chrome'))
+    (New-Target 7 'Google Chrome Canary' "$($P.L)\Google\Chrome SxS\User Data" -Kind chromium -Guard @('chrome'))
+    (New-Target 7 'Microsoft Edge' "$($P.L)\Microsoft\Edge\User Data" -Kind chromium -Guard @('msedge'))
+    (New-Target 7 'Brave' "$($P.L)\BraveSoftware\Brave-Browser\User Data" -Kind chromium -Guard @('brave'))
+    (New-Target 7 'Vivaldi' "$($P.L)\Vivaldi\User Data" -Kind chromium -Guard @('vivaldi'))
+    (New-Target 7 'Opera' "$($P.A)\Opera Software\Opera Stable" -Kind chromium -Guard @('opera'))
+    (New-Target 7 'Opera GX' "$($P.A)\Opera Software\Opera GX Stable" -Kind chromium -Guard @('opera'))
+    (New-Target 7 'Chromium' "$($P.L)\Chromium\User Data" -Kind chromium -Guard @('chrome', 'chromium'))
+    (New-Target 7 'Arc' "$($P.L)\Packages\TheBrowserCompany.Arc_*\LocalCache\Local\Arc\User Data" -Kind chromium -Guard @('Arc'))
+    (New-Target 7 'Firefox' "$($P.L)\Mozilla\Firefox\Profiles" -Kind firefox -Guard @('firefox') -Note 'cache2, startupCache, thumbnails, jumpListCache')
+    (New-Target 7 'LibreWolf' "$($P.L)\LibreWolf\Profiles" -Kind firefox -Guard @('librewolf'))
+    (New-Target 7 'Waterfox' "$($P.L)\Waterfox\Profiles" -Kind firefox -Guard @('waterfox'))
+  )
+}
+
+function Invoke-Section07 {
+  Write-SectionIntro @(
+    'Browser caches rebuild as you browse; the first page loads afterwards are a little slower. Cookies, logins,',
+    'history, bookmarks, extensions, Local Storage, IndexedDB and PWA CacheStorage are never touched.',
+    'A browser that is open right now is skipped - close it and run this section again.'
+  )
+  $targets = Get-Targets07
+  $null = Show-TargetSizes $targets
+  if (-not (Confirm-Section 'Clear browser caches now?')) { Write-Info 'skipped'; return }
+  $null = Invoke-TargetList $targets
+}

package/modules/build_tools.ps1

@@ -1,35 +1,35 @@
-# build_tools.ps1 - section 2: build-tool caches (Gradle, Maven, Android, Unity, JetBrains).
-
-function Get-Targets02 {
-  $P = $Script:P
-  return @(
-    (New-Target 2 'Gradle caches' "$($P.U)\.gradle\caches" -Mode prune -Dev $true -Note 'Gradle re-downloads what a build needs')
-    (New-Target 2 'Gradle wrapper distributions' "$($P.U)\.gradle\wrapper\dists" -Mode units -Dev $true -KeepNewest $true -Note 'the newest distribution is always kept')
-    (New-Target 2 'Gradle daemon logs' "$($P.U)\.gradle\daemon" -Mode prune -Days 7)
-    (New-Target 2 'Gradle temp' "$($P.U)\.gradle\.tmp" -Mode clear)
-    (New-Target 2 'Maven local repository' "$($P.U)\.m2\repository" -Mode prune -Dev $true -Note 'restored by the next mvn build')
-    (New-Target 2 'Android SDK manager cache' "$($P.U)\.android\cache" -Mode clear)
-    (New-Target 2 'Android build cache' "$($P.U)\.android\build-cache" -Mode prune -Dev $true)
-    (New-Target 2 'Android SDK temp' "$($P.L)\Android\Sdk\.temp" -Mode clear)
-    (New-Target 2 'Android SDK download leftovers' "$($P.L)\Android\Sdk\.downloadIntermediates" -Mode clear)
-    (New-Target 2 'Unity cache' "$($P.L)\Unity\cache" -Mode prune -Dev $true)
-    (New-Target 2 'JetBrains IDE caches (idle IDE versions)' "$($P.L)\JetBrains" -Mode units -Dev $true -ExcludeNames @('Toolbox') -Note 'a whole IDE version idle N+ days; the Toolbox itself is protected')
-    (New-Target 2 '.NET telemetry storage' "$($P.U)\.dotnet\TelemetryStorageService" -Mode clear)
-  )
-}
-
-function Invoke-Section02 {
-  Write-SectionIntro @(
-    'Build caches are re-created by the next build. In developer mode only idle files go, so a project you',
-    'compiled last week keeps its warm cache. JetBrains caches are removed per IDE version, only when that whole',
-    'version has been idle for the window (an IDE you no longer run).'
-  ) -Dev $true
-  $targets = Get-Targets02
-  $null = Show-TargetSizes $targets
-  if (-not (Confirm-Section 'Prune build-tool caches now?')) { Write-Info 'skipped'; return }
-  if ((Test-CommandPresent 'gradle') -and -not $Script:WS.DryRun) {
-    $null = Invoke-External -FilePath 'gradle' -ArgumentList @('--stop') -Quiet -Label 'gradle --stop'
-    Write-Note 'stopped idle Gradle daemons so their caches are not locked'
-  }
-  $null = Invoke-TargetList $targets
-}
+# build_tools.ps1 - section 2: build-tool caches (Gradle, Maven, Android, Unity, JetBrains).
+
+function Get-Targets02 {
+  $P = $Script:P
+  return @(
+    (New-Target 2 'Gradle caches' "$($P.U)\.gradle\caches" -Mode prune -Dev $true -Note 'Gradle re-downloads what a build needs')
+    (New-Target 2 'Gradle wrapper distributions' "$($P.U)\.gradle\wrapper\dists" -Mode units -Dev $true -KeepNewest $true -Note 'the newest distribution is always kept')
+    (New-Target 2 'Gradle daemon logs' "$($P.U)\.gradle\daemon" -Mode prune -Days 7)
+    (New-Target 2 'Gradle temp' "$($P.U)\.gradle\.tmp" -Mode clear)
+    (New-Target 2 'Maven local repository' "$($P.U)\.m2\repository" -Mode prune -Dev $true -Note 'restored by the next mvn build')
+    (New-Target 2 'Android SDK manager cache' "$($P.U)\.android\cache" -Mode clear)
+    (New-Target 2 'Android build cache' "$($P.U)\.android\build-cache" -Mode prune -Dev $true)
+    (New-Target 2 'Android SDK temp' "$($P.L)\Android\Sdk\.temp" -Mode clear)
+    (New-Target 2 'Android SDK download leftovers' "$($P.L)\Android\Sdk\.downloadIntermediates" -Mode clear)
+    (New-Target 2 'Unity cache' "$($P.L)\Unity\cache" -Mode prune -Dev $true)
+    (New-Target 2 'JetBrains IDE caches (idle IDE versions)' "$($P.L)\JetBrains" -Mode units -Dev $true -ExcludeNames @('Toolbox') -Note 'a whole IDE version idle N+ days; the Toolbox itself is protected')
+    (New-Target 2 '.NET telemetry storage' "$($P.U)\.dotnet\TelemetryStorageService" -Mode clear)
+  )
+}
+
+function Invoke-Section02 {
+  Write-SectionIntro @(
+    'Build caches are re-created by the next build. In developer mode only idle files go, so a project you',
+    'compiled last week keeps its warm cache. JetBrains caches are removed per IDE version, only when that whole',
+    'version has been idle for the window (an IDE you no longer run).'
+  ) -Dev $true
+  $targets = Get-Targets02
+  $null = Show-TargetSizes $targets
+  if (-not (Confirm-Section 'Prune build-tool caches now?')) { Write-Info 'skipped'; return }
+  if ((Test-CommandPresent 'gradle') -and -not $Script:WS.DryRun) {
+    $null = Invoke-External -FilePath 'gradle' -ArgumentList @('--stop') -Quiet -Label 'gradle --stop'
+    Write-Note 'stopped idle Gradle daemons so their caches are not locked'
+  }
+  $null = Invoke-TargetList $targets
+}

package/modules/crash_trap.ps1

@@ -1,89 +1,89 @@
-# crash_trap.ps1 - on an unexpected error, bundle the log + latest report + a manifest into a local zip.
-# Nothing is ever sent anywhere; the user decides whether to attach it to a bug report.
-
-function Initialize-CrashTrap {
-  $Script:WS.CrashArmed = $true
-}
-
-function Get-FeedbackDir {
-  $d = $Script:WS.FeedbackDir
-  if (-not (Test-Path -LiteralPath $d)) { New-Item -ItemType Directory -Force -Path $d | Out-Null }
-  return $d
-}
-
-function Get-LatestReportPath {
-  $dir = $Script:WS.ReportsDir
-  if (-not (Test-Path -LiteralPath $dir)) { return $null }
-  $f = Get-ChildItem -LiteralPath $dir -Filter 'report-*.json' -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1
-  if ($f) { return $f.FullName }
-  return $null
-}
-
-function New-SystemManifest {
-  <# .SYNOPSIS Non-sensitive environment facts for a bug report. #>
-  param([string] $Kind, [string] $Extra = '')
-  $ws = $Script:WS
-  $lines = @(
-    "$Script:WS_NAME v$(Get-ToolVersion) - $Kind"
-    "Generated:   $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss zzz')"
-    ''
-    '=== System info ==='
-    "OS:          $($ws.OsCaption) ($([Environment]::OSVersion.Version))"
-    "PowerShell:  $($PSVersionTable.PSVersion) ($($PSVersionTable.PSEdition))"
-    "Elevated:    $($ws.IsAdmin)"
-    "Launcher:    $($ws.Launcher)  npx: $($ws.Npx)"
-    "Mode:        $($ws.Mode)  dry-run: $($ws.DryRun)  developer: $($ws.Developer)"
-    "Node:        $(try { (& node --version 2>$null) } catch { 'not installed' })"
-  )
-  if ($Extra) { $lines += ''; $lines += $Extra }
-  $lines += ''
-  $lines += '=== Privacy note ==='
-  $lines += 'This bundle was generated locally and was NOT sent anywhere. Review every file before sharing;'
-  $lines += 'logs and reports contain paths from your machine and a snapshot of cache sizes.'
-  $lines += "Report bugs at: $Script:WS_ISSUES  (or email $Script:WS_EMAIL)"
-  return $lines
-}
-
-function New-BundleZip {
-  <# .SYNOPSIS Zip the current log, the latest report and a manifest. Returns the zip path or $null. #>
-  param([string] $Prefix, [string[]] $Manifest)
-  $ws = $Script:WS
-  $stamp = Get-Date -Format 'yyyy-MM-dd_HHmmss'
-  $tmp = Join-Path $env:TEMP ("$Script:WS_NAME-bundle-" + [guid]::NewGuid().ToString('N'))
-  New-Item -ItemType Directory -Force -Path $tmp | Out-Null
-  try {
-    [IO.File]::WriteAllLines((Join-Path $tmp 'MANIFEST.txt'), $Manifest)
-    if ($ws.LogFile -and (Test-Path -LiteralPath $ws.LogFile)) { Copy-Item -LiteralPath $ws.LogFile -Destination $tmp -ErrorAction SilentlyContinue }
-    $rep = Get-LatestReportPath
-    if ($rep) { Copy-Item -LiteralPath $rep -Destination $tmp -ErrorAction SilentlyContinue }
-    $out = Join-Path (Get-FeedbackDir) ("$Prefix-$stamp.zip")
-    Compress-Archive -Path (Join-Path $tmp '*') -DestinationPath $out -Force -ErrorAction Stop
-    return $out
-  } catch {
-    Write-Warn "could not create bundle: $($_.Exception.Message)"
-    return $null
-  } finally {
-    try { Remove-Item -LiteralPath $tmp -Recurse -Force -ErrorAction SilentlyContinue } catch { $null = $_ }
-  }
-}
-
-function Invoke-CrashBundle {
-  <# .SYNOPSIS Called by the entry script when Invoke-Main throws. #>
-  param([System.Management.Automation.ErrorRecord] $ErrorRecord)
-  $ws = $Script:WS
-  $msg = $ErrorRecord.Exception.Message
-  $where = $ErrorRecord.InvocationInfo.PositionMessage
-  Write-LogLine "CRASH: $msg"
-  Write-LogLine $ErrorRecord.ScriptStackTrace
-  $extra = @("=== Error ===", $msg, $where, '', '=== Stack ===', $ErrorRecord.ScriptStackTrace) -join "`r`n"
-  $zip = New-BundleZip -Prefix 'crash' -Manifest (New-SystemManifest -Kind 'CRASH REPORT' -Extra $extra)
-  Write-UiLine '' 'Gray'
-  Write-Err "$Script:WS_NAME exited unexpectedly: $msg"
-  Write-Note $where
-  if ($zip) {
-    Write-Info "crash bundle: $zip"
-    Write-Note 'Review it (it contains paths from your machine), then attach it to an issue:'
-    Write-Note "$Script:WS_ISSUES   or run: windowsweep --report-issue"
-  }
-  Write-Note 'Nothing was sent. windowsweep makes no network calls.'
-}
+# crash_trap.ps1 - on an unexpected error, bundle the log + latest report + a manifest into a local zip.
+# Nothing is ever sent anywhere; the user decides whether to attach it to a bug report.
+
+function Initialize-CrashTrap {
+  $Script:WS.CrashArmed = $true
+}
+
+function Get-FeedbackDir {
+  $d = $Script:WS.FeedbackDir
+  if (-not (Test-Path -LiteralPath $d)) { New-Item -ItemType Directory -Force -Path $d | Out-Null }
+  return $d
+}
+
+function Get-LatestReportPath {
+  $dir = $Script:WS.ReportsDir
+  if (-not (Test-Path -LiteralPath $dir)) { return $null }
+  $f = Get-ChildItem -LiteralPath $dir -Filter 'report-*.json' -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1
+  if ($f) { return $f.FullName }
+  return $null
+}
+
+function New-SystemManifest {
+  <# .SYNOPSIS Non-sensitive environment facts for a bug report. #>
+  param([string] $Kind, [string] $Extra = '')
+  $ws = $Script:WS
+  $lines = @(
+    "$Script:WS_NAME v$(Get-ToolVersion) - $Kind"
+    "Generated:   $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss zzz')"
+    ''
+    '=== System info ==='
+    "OS:          $($ws.OsCaption) ($([Environment]::OSVersion.Version))"
+    "PowerShell:  $($PSVersionTable.PSVersion) ($($PSVersionTable.PSEdition))"
+    "Elevated:    $($ws.IsAdmin)"
+    "Launcher:    $($ws.Launcher)  npx: $($ws.Npx)"
+    "Mode:        $($ws.Mode)  dry-run: $($ws.DryRun)  developer: $($ws.Developer)"
+    "Node:        $(try { (& node --version 2>$null) } catch { 'not installed' })"
+  )
+  if ($Extra) { $lines += ''; $lines += $Extra }
+  $lines += ''
+  $lines += '=== Privacy note ==='
+  $lines += 'This bundle was generated locally and was NOT sent anywhere. Review every file before sharing;'
+  $lines += 'logs and reports contain paths from your machine and a snapshot of cache sizes.'
+  $lines += "Report bugs at: $Script:WS_ISSUES  (or email $Script:WS_EMAIL)"
+  return $lines
+}
+
+function New-BundleZip {
+  <# .SYNOPSIS Zip the current log, the latest report and a manifest. Returns the zip path or $null. #>
+  param([string] $Prefix, [string[]] $Manifest)
+  $ws = $Script:WS
+  $stamp = Get-Date -Format 'yyyy-MM-dd_HHmmss'
+  $tmp = Join-Path $env:TEMP ("$Script:WS_NAME-bundle-" + [guid]::NewGuid().ToString('N'))
+  New-Item -ItemType Directory -Force -Path $tmp | Out-Null
+  try {
+    [IO.File]::WriteAllLines((Join-Path $tmp 'MANIFEST.txt'), $Manifest)
+    if ($ws.LogFile -and (Test-Path -LiteralPath $ws.LogFile)) { Copy-Item -LiteralPath $ws.LogFile -Destination $tmp -ErrorAction SilentlyContinue }
+    $rep = Get-LatestReportPath
+    if ($rep) { Copy-Item -LiteralPath $rep -Destination $tmp -ErrorAction SilentlyContinue }
+    $out = Join-Path (Get-FeedbackDir) ("$Prefix-$stamp.zip")
+    Compress-Archive -Path (Join-Path $tmp '*') -DestinationPath $out -Force -ErrorAction Stop
+    return $out
+  } catch {
+    Write-Warn "could not create bundle: $($_.Exception.Message)"
+    return $null
+  } finally {
+    try { Remove-Item -LiteralPath $tmp -Recurse -Force -ErrorAction SilentlyContinue } catch { $null = $_ }
+  }
+}
+
+function Invoke-CrashBundle {
+  <# .SYNOPSIS Called by the entry script when Invoke-Main throws. #>
+  param([System.Management.Automation.ErrorRecord] $ErrorRecord)
+  $ws = $Script:WS
+  $msg = $ErrorRecord.Exception.Message
+  $where = $ErrorRecord.InvocationInfo.PositionMessage
+  Write-LogLine "CRASH: $msg"
+  Write-LogLine $ErrorRecord.ScriptStackTrace
+  $extra = @("=== Error ===", $msg, $where, '', '=== Stack ===', $ErrorRecord.ScriptStackTrace) -join "`r`n"
+  $zip = New-BundleZip -Prefix 'crash' -Manifest (New-SystemManifest -Kind 'CRASH REPORT' -Extra $extra)
+  Write-UiLine '' 'Gray'
+  Write-Err "$Script:WS_NAME exited unexpectedly: $msg"
+  Write-Note $where
+  if ($zip) {
+    Write-Info "crash bundle: $zip"
+    Write-Note 'Review it (it contains paths from your machine), then attach it to an issue:'
+    Write-Note "$Script:WS_ISSUES   or run: windowsweep --report-issue"
+  }
+  Write-Note 'Nothing was sent. windowsweep makes no network calls.'
+}

package/modules/disk_usage.ps1

@@ -1,49 +1,49 @@
-# disk_usage.ps1 - section 21: read-only disk usage report (largest entries, disk images, drives).
-
-function Get-Targets21 { return @() }
-
-function Show-LargestEntries {
-  <# .SYNOPSIS Size every top-level entry of a folder and print the largest N. Returns the rows. #>
-  param([string] $Root, [int] $Top = 20, [string] $Title = '')
-  if (-not (Test-DirPresent $Root)) { return @() }
-  if (-not $Title) { $Title = $Root }
-  Write-Section "Largest entries in $Title"
-  Write-Note 'measuring...'
-  $rows = @()
-  foreach ($e in (Get-ChildEntries $Root)) {
-    $full = Remove-LongPrefix $e.FullName
-    $bytes = [long]0
-    if (Test-ReparsePoint $e) { continue }
-    if ($e -is [IO.DirectoryInfo]) { $bytes = Get-DirectoryBytes $full } else { $bytes = [long]$e.Length }
-    $rows += [pscustomobject]@{ Path = $full; Bytes = $bytes }
-  }
-  $rows = @($rows | Sort-Object Bytes -Descending | Select-Object -First $Top)
-  foreach ($r in $rows) {
-    $why = Get-ProtectionReason $r.Path
-    $tag = ''
-    if ($why) { $tag = '  [protected]' }
-    Write-UiLine ("  {0,10}  {1}{2}" -f (Format-Bytes $r.Bytes), $r.Path, $tag) 'Gray'
-  }
-  return $rows
-}
-
-function Invoke-Section21 {
-  $ws = $Script:WS
-  $P = $Script:P
-  Write-SectionIntro @('Where the space went. Read-only; entries marked [protected] are ones this tool will never delete.')
-  $lines = @("windowsweep disk usage report - $(Get-Date -Format 'yyyy-MM-dd HH:mm')", '')
-  Show-DriveTable
-  foreach ($d in (Get-DriveSnapshot)) { $lines += ("{0}  size {1}  free {2}" -f $d.drive, (Format-Bytes $d.size_bytes), (Format-Bytes $d.free_bytes)) }
-  $h = Get-HiberfilInfo
-  if ($h.Bytes -gt 0) { Write-Kv 'hiberfil.sys:' (Format-Bytes $h.Bytes); $lines += "hiberfil.sys $(Format-Bytes $h.Bytes)" }
-  foreach ($img in (Get-DiskImageFiles)) { Write-Kv 'disk image:' ("{0}  {1}" -f (Format-Bytes $img.Length), $img.FullName); $lines += "vhdx $(Format-Bytes $img.Length) $($img.FullName)" }
-  foreach ($pair in @(@($P.U, 'your profile'), @($P.L, 'AppData\Local'), @($P.A, 'AppData\Roaming'), @("$($P.SD)\", "drive $($P.SD)"))) {
-    $rows = Show-LargestEntries -Root $pair[0] -Top 20 -Title $pair[1]
-    $lines += ''; $lines += "== $($pair[1]) =="
-    foreach ($r in $rows) { $lines += ("{0,10}  {1}" -f (Format-Bytes $r.Bytes), $r.Path) }
-  }
-  if (-not $ws.NoReport) {
-    $out = Join-Path $ws.ReportsDir ('disk-usage-' + $ws.Stamp + '.txt')
-    try { [IO.File]::WriteAllLines($out, $lines); Write-Info "report written: $out" } catch { Write-Warn "could not write $out" }
-  }
-}
+# disk_usage.ps1 - section 21: read-only disk usage report (largest entries, disk images, drives).
+
+function Get-Targets21 { return @() }
+
+function Show-LargestEntries {
+  <# .SYNOPSIS Size every top-level entry of a folder and print the largest N. Returns the rows. #>
+  param([string] $Root, [int] $Top = 20, [string] $Title = '')
+  if (-not (Test-DirPresent $Root)) { return @() }
+  if (-not $Title) { $Title = $Root }
+  Write-Section "Largest entries in $Title"
+  Write-Note 'measuring...'
+  $rows = @()
+  foreach ($e in (Get-ChildEntries $Root)) {
+    $full = Remove-LongPrefix $e.FullName
+    $bytes = [long]0
+    if (Test-ReparsePoint $e) { continue }
+    if ($e -is [IO.DirectoryInfo]) { $bytes = Get-DirectoryBytes $full } else { $bytes = [long]$e.Length }
+    $rows += [pscustomobject]@{ Path = $full; Bytes = $bytes }
+  }
+  $rows = @($rows | Sort-Object Bytes -Descending | Select-Object -First $Top)
+  foreach ($r in $rows) {
+    $why = Get-ProtectionReason $r.Path
+    $tag = ''
+    if ($why) { $tag = '  [protected]' }
+    Write-UiLine ("  {0,10}  {1}{2}" -f (Format-Bytes $r.Bytes), $r.Path, $tag) 'Gray'
+  }
+  return $rows
+}
+
+function Invoke-Section21 {
+  $ws = $Script:WS
+  $P = $Script:P
+  Write-SectionIntro @('Where the space went. Read-only; entries marked [protected] are ones this tool will never delete.')
+  $lines = @("windowsweep disk usage report - $(Get-Date -Format 'yyyy-MM-dd HH:mm')", '')
+  Show-DriveTable
+  foreach ($d in (Get-DriveSnapshot)) { $lines += ("{0}  size {1}  free {2}" -f $d.drive, (Format-Bytes $d.size_bytes), (Format-Bytes $d.free_bytes)) }
+  $h = Get-HiberfilInfo
+  if ($h.Bytes -gt 0) { Write-Kv 'hiberfil.sys:' (Format-Bytes $h.Bytes); $lines += "hiberfil.sys $(Format-Bytes $h.Bytes)" }
+  foreach ($img in (Get-DiskImageFiles)) { Write-Kv 'disk image:' ("{0}  {1}" -f (Format-Bytes $img.Length), $img.FullName); $lines += "vhdx $(Format-Bytes $img.Length) $($img.FullName)" }
+  foreach ($pair in @(@($P.U, 'your profile'), @($P.L, 'AppData\Local'), @($P.A, 'AppData\Roaming'), @("$($P.SD)\", "drive $($P.SD)"))) {
+    $rows = Show-LargestEntries -Root $pair[0] -Top 20 -Title $pair[1]
+    $lines += ''; $lines += "== $($pair[1]) =="
+    foreach ($r in $rows) { $lines += ("{0,10}  {1}" -f (Format-Bytes $r.Bytes), $r.Path) }
+  }
+  if (-not $ws.NoReport) {
+    $out = Join-Path $ws.ReportsDir ('disk-usage-' + $ws.Stamp + '.txt')
+    try { [IO.File]::WriteAllLines($out, $lines); Write-Info "report written: $out" } catch { Write-Warn "could not write $out" }
+  }
+}