windowsweep 1.0.0

package/lib/scan.ps1

@@ -0,0 +1,94 @@
+# scan.ps1 - read-only scanners: the target table, --list-targets and the pre-scan.
+# Every module contributes its targets through a Get-TargetsNN function; nothing here deletes.
+
+function New-Target {
+  <# .SYNOPSIS Describe one path the tool can touch and how it is treated.
+     Kind: dir | file | glob (expands to dirs) | fileglob (expands to files) | cmd (informational)
+     Mode: prune (files idle >= Days) | clear (everything inside) | clear-old (entries idle >= Days) |
+           units (each child is a version/unit; idle gate, -KeepNewest per group) | file (remove the file)
+     Dev:  $true = a developer cache: pruned by the idle gate in developer mode, cleared otherwise.
+     Guard: process names; the target is skipped while any of them runs. #>
+  param([int] $Section, [string] $Label, [string] $Path, [string] $Kind = 'dir', [string] $Mode = 'prune',
+    [int] $Days = 0, [bool] $Dev = $false, [string[]] $Guard = @(), [bool] $KeepNewest = $false,
+    [scriptblock] $GroupBy = $null, [string[]] $ExcludeNames = @(), [string] $Note = '')
+  return [pscustomobject]@{ Section = $Section; Label = $Label; Path = $Path; Kind = $Kind; Mode = $Mode; Days = $Days
+    Dev = $Dev; Guard = $Guard; KeepNewest = $KeepNewest; GroupBy = $GroupBy; ExcludeNames = $ExcludeNames; Note = $Note }
+}
+
+function Get-AllTargets {
+  <# .SYNOPSIS Collect every declared target from the loaded modules (Get-Targets00 .. Get-Targets21). #>
+  $all = @()
+  for ($i = 0; $i -le 21; $i++) {
+    $fn = 'Get-Targets{0:00}' -f $i
+    if (Get-Command $fn -ErrorAction SilentlyContinue) { $all += @(& $fn) }
+  }
+  return $all
+}
+
+function Resolve-TargetPaths {
+  <# .SYNOPSIS Expand a glob target into concrete existing paths; a plain path returns itself when present. #>
+  param([pscustomobject] $Target)
+  if ($Target.Kind -eq 'cmd') { return @() }
+  if ($Target.Kind -in 'chromium', 'firefox', 'electron', 'editor') { return @(Get-TargetCachePaths $Target) }
+  if ($Target.Kind -eq 'glob') {
+    try { return @(Get-Item -Path $Target.Path -Force -ErrorAction SilentlyContinue | Where-Object { $_ -is [IO.DirectoryInfo] } | ForEach-Object { $_.FullName }) } catch { return @() }
+  }
+  if ($Target.Kind -eq 'fileglob') {
+    try { return @(Get-Item -Path $Target.Path -Force -ErrorAction SilentlyContinue | Where-Object { $_ -is [IO.FileInfo] } | ForEach-Object { $_.FullName }) } catch { return @() }
+  }
+  if (Test-PathPresent $Target.Path) { return @((Get-FullPath $Target.Path)) }
+  return @()
+}
+
+function Show-ScanTable {
+  <# .SYNOPSIS Read-only table of every target with its current size. Returns total bytes found. #>
+  param([int[]] $Sections = @())
+  $total = [long]0
+  $targets = @(Get-AllTargets)
+  if ($Sections.Count -gt 0) { $targets = @($targets | Where-Object { $Sections -contains $_.Section }) }
+  $bySection = $targets | Group-Object Section | Sort-Object { [int]$_.Name }
+  foreach ($g in $bySection) {
+    $sec = Get-Section ([int]$g.Name)
+    Write-Section ("[{0:00}] {1}" -f $sec.Id, $sec.Title)
+    Write-UiLine ("  {0,-46} {1,10}  {2}" -f 'ITEM', 'SIZE', 'PATH') 'White'
+    $secTotal = [long]0
+    foreach ($t in $g.Group) {
+      if ($t.Kind -eq 'cmd') { Write-UiLine ("  {0,-46} {1,10}  {2}" -f $t.Label, '(cmd)', $t.Path) 'DarkGray'; continue }
+      $paths = @(Resolve-TargetPaths $t)
+      if ($paths.Count -eq 0) { Write-UiLine ("  {0,-46} {1,10}  {2}" -f $t.Label, 'absent', $t.Path) 'DarkGray'; continue }
+      $bytes = [long]0
+      foreach ($p in $paths) { $bytes += Get-DirectoryBytes $p }
+      $secTotal += $bytes
+      $shown = $t.Path
+      if ($paths.Count -gt 1) { $shown = "$($t.Path)  ($($paths.Count) matches)" }
+      Write-UiLine ("  {0,-46} {1,10}  {2}" -f $t.Label, (Format-Bytes $bytes), $shown) 'Gray'
+    }
+    Write-UiLine ("  {0,-46} {1,10}" -f 'section total on disk', (Format-Bytes $secTotal)) 'Cyan'
+    $total += $secTotal
+  }
+  Write-UiLine '' 'Gray'
+  Write-Info ("Currently on disk across all listed targets: " + (Format-Bytes $total))
+  Write-Note 'These are sizes on disk, not what a run would delete: the idle gate keeps recently used files, and running apps are skipped.'
+  return $total
+}
+
+function Show-TargetList {
+  <# .SYNOPSIS --list-targets: every path the tool can touch, plus the protected lists. #>
+  Write-Box 'Cleanup targets' 'Every path this tool can touch, grouped by section (read-only)'
+  $targets = @(Get-AllTargets)
+  foreach ($g in ($targets | Group-Object Section | Sort-Object { [int]$_.Name })) {
+    $sec = Get-Section ([int]$g.Name)
+    Write-Section ("[{0:00}] {1}" -f $sec.Id, $sec.Title)
+    foreach ($t in $g.Group) {
+      $note = ''
+      if ($t.Note) { $note = "  - $($t.Note)" }
+      Write-UiLine ("  {0,-44} {1}{2}" -f $t.Label, $t.Path, $note) 'Gray'
+    }
+  }
+  Write-Section 'PROTECTED - never deleted, no flag bypasses this'
+  foreach ($s in $Script:WS_PROTECT.Subtrees) { Write-UiLine "  $($Script:WS.Glyph.bullet) $s" 'DarkGray' }
+  Write-UiLine "  $($Script:WS.Glyph.bullet) every drive root, Windows, System32, Program Files, ProgramData, the user profile root and AppData roots" 'DarkGray'
+  Write-UiLine "  $($Script:WS.Glyph.bullet) browser profile data (Local Storage, IndexedDB, cookies, history, bookmarks, extensions, PWA CacheStorage)" 'DarkGray'
+  Write-UiLine "  $($Script:WS.Glyph.bullet) editor user data (settings, globalStorage, local History); UWP LocalState; toolchains (nvm, npm globals, corepack, ...)" 'DarkGray'
+  Write-UiLine "  $($Script:WS.Glyph.bullet) NTUSER.DAT, UsrClass.dat, hiberfil/pagefile/swapfile (only powercfg touches hiberfil), Prefetch, Windows\Installer, WinSxS (DISM only)" 'DarkGray'
+}

package/lib/ui.ps1

@@ -0,0 +1,232 @@
+# ui.ps1 - console output, glyphs, colours and prompts. ASCII only; glyphs come from [char] codes.
+# Every human-readable line goes through Write-UiLine so it is also logged and, in --json mode,
+# routed to stderr (stdout then carries only the JSON summary).
+
+function Initialize-Ui {
+  <# .SYNOPSIS Decide colour + glyph set from flags, environment and redirection state. #>
+  $ws = $Script:WS
+  $outRedirected = [Console]::IsOutputRedirected
+  $inRedirected = [Console]::IsInputRedirected
+  $noColorEnv = (-not [string]::IsNullOrEmpty($env:NO_COLOR)) -or ($env:WINDOWSWEEP_NO_COLOR -eq '1')
+  $ws.Color = (-not $ws.NoColor) -and (-not $noColorEnv) -and (-not $outRedirected) -and (-not $ws.JsonMode)
+  $ws.Interactive = (-not $inRedirected) -and (-not $ws.JsonMode)
+  $useUnicode = (-not $ws.Ascii) -and (-not $outRedirected) -and ($env:WINDOWSWEEP_ASCII -ne '1')
+  if ($useUnicode) {
+    $ws.Glyph = @{
+      ok = [string][char]0x2713; err = [string][char]0x2717; info = [string][char]0x2139; warn = '!'
+      bullet = [string][char]0x00B7; arrow = [string][char]0x2192; hline = [string][char]0x2500
+      dline = [string][char]0x2550; tl = [string][char]0x2554; tr = [string][char]0x2557
+      bl = [string][char]0x255A; br = [string][char]0x255D; vbar = [string][char]0x2551
+    }
+    try {
+      $ws.PrevOutputEncoding = [Console]::OutputEncoding
+      [Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+    } catch { $ws.PrevOutputEncoding = $null }
+  } else {
+    $ws.Glyph = @{ ok = '+'; err = 'x'; info = 'i'; warn = '!'; bullet = '*'; arrow = '->'; hline = '-'; dline = '='; tl = '+'; tr = '+'; bl = '+'; br = '+'; vbar = '|' }
+  }
+}
+
+function Restore-Ui {
+  <# .SYNOPSIS Put the console encoding back the way we found it. #>
+  $ws = $Script:WS
+  if ($ws.PrevOutputEncoding) { try { [Console]::OutputEncoding = $ws.PrevOutputEncoding } catch { $null = $_ } }
+}
+
+function Write-UiLine {
+  <# .SYNOPSIS Print one line (coloured when allowed) and append it to the log. #>
+  param([string] $Text = '', [string] $Color = 'Gray', [switch] $NoLog, [switch] $NoNewline)
+  $ws = $Script:WS
+  if (-not $NoLog) { Write-Log $Text }
+  if ($ws.Mute) { return }
+  if ($ws.JsonMode) { [Console]::Error.WriteLine($Text); return }
+  if ($ws.Color) {
+    if ($NoNewline) { Write-Host $Text -ForegroundColor $Color -NoNewline } else { Write-Host $Text -ForegroundColor $Color }
+  } else {
+    if ($NoNewline) { Write-Host $Text -NoNewline } else { Write-Host $Text }
+  }
+}
+
+function Write-Info {
+  param([string] $Text)
+  if ($Script:WS.Quiet) { Write-Log "INFO $Text"; return }
+  Write-UiLine ("$($Script:WS.Glyph.info) $Text") 'Cyan'
+}
+
+function Write-Ok {
+  param([string] $Text)
+  Write-UiLine ("$($Script:WS.Glyph.ok) $Text") 'Green'
+}
+
+function Write-Warn {
+  param([string] $Text)
+  Write-UiLine ("$($Script:WS.Glyph.warn) $Text") 'Yellow'
+}
+
+function Write-Err {
+  param([string] $Text)
+  Write-UiLine ("$($Script:WS.Glyph.err) $Text") 'Red'
+}
+
+function Write-Note {
+  param([string] $Text)
+  if ($Script:WS.Quiet) { Write-Log "NOTE $Text"; return }
+  Write-UiLine ("    $Text") 'DarkGray'
+}
+
+function Write-Plain {
+  param([string] $Text)
+  Write-UiLine $Text 'Gray'
+}
+
+function Write-DryRun {
+  param([string] $Text)
+  Write-UiLine ("    [dry-run] $Text") 'Magenta'
+}
+
+function Write-Section {
+  <# .SYNOPSIS A dashed section heading. #>
+  param([string] $Title)
+  $h = $Script:WS.Glyph.hline
+  Write-UiLine '' 'Gray'
+  Write-UiLine ("$h$h $Title $h$h") 'Blue'
+}
+
+function Write-Separator {
+  Write-UiLine ([string]::new([char]($Script:WS.Glyph.hline), 78)) 'DarkGray'
+}
+
+function Write-Box {
+  <# .SYNOPSIS Double-lined title box with an optional dim subtitle. #>
+  param([string] $Title, [string] $Subtitle = '')
+  $line = [string]::new([char]($Script:WS.Glyph.dline), 78)
+  Write-UiLine '' 'Gray'
+  Write-UiLine $line 'Blue'
+  Write-UiLine ("   $Title") 'Blue'
+  if ($Subtitle) { Write-UiLine ("   $Subtitle") 'DarkGray' }
+  Write-UiLine $line 'Blue'
+}
+
+function Write-Step {
+  <# .SYNOPSIS Walkthrough step header: [ STEP n/N ]  Title #>
+  param([int] $N, [int] $Total, [string] $Title)
+  Write-UiLine '' 'Gray'
+  Write-Separator
+  Write-UiLine ("  [ STEP $N/$Total ]  $Title") 'Cyan'
+  Write-Separator
+}
+
+function Write-Kv {
+  param([string] $Key, [string] $Value)
+  Write-UiLine ("  {0,-24} {1}" -f $Key, $Value) 'Gray'
+}
+
+function Write-Banner {
+  $g = $Script:WS.Glyph
+  $inner = "   $Script:WS_NAME v$(Get-ToolVersion) - safe, developer-aware Windows cleanup   "
+  $bar = [string]::new([char]($g.dline), $inner.Length)
+  Write-UiLine ("$($g.tl)$bar$($g.tr)") 'Blue'
+  Write-UiLine ("$($g.vbar)$inner$($g.vbar)") 'Blue'
+  Write-UiLine ("$($g.bl)$bar$($g.br)") 'Blue'
+}
+
+function Format-Bytes {
+  <# .SYNOPSIS Human-readable size (B, KB, MB, GB, TB). #>
+  param([double] $Bytes)
+  if ($Bytes -lt 0) { $Bytes = 0 }
+  $units = @('B', 'KB', 'MB', 'GB', 'TB')
+  $i = 0
+  while ($Bytes -ge 1024 -and $i -lt ($units.Length - 1)) { $Bytes = $Bytes / 1024; $i++ }
+  if ($i -eq 0) { return ("{0:N0} {1}" -f $Bytes, $units[$i]) }
+  return ("{0:N1} {1}" -f $Bytes, $units[$i])
+}
+
+function Format-Duration {
+  param([double] $Seconds)
+  $m = [math]::Floor($Seconds / 60); $s = [math]::Floor($Seconds % 60)
+  return ("{0}m {1:00}s" -f $m, $s)
+}
+
+function Read-Line {
+  <# .SYNOPSIS Read one line from the console, or $null when not interactive / at EOF. #>
+  param([string] $Prompt = '')
+  if (-not $Script:WS.Interactive) { return $null }
+  if ($Prompt) { Write-UiLine $Prompt 'White' -NoNewline -NoLog }
+  try { $line = [Console]::In.ReadLine() } catch { return $null }
+  if ($null -eq $line) { return $null }
+  Write-Log ("> $line")
+  return $line
+}
+
+function Confirm-Ui {
+  <# .SYNOPSIS y/N prompt. --yes auto-confirms (unless -NoAutoYes); non-interactive runs answer no. #>
+  param([string] $Prompt = 'Proceed?', [string] $Default = 'n', [switch] $NoAutoYes)
+  $ws = $Script:WS
+  if ($ws.Yes -and -not $NoAutoYes) { Write-UiLine ("    [auto-yes] $Prompt") 'DarkGray'; return $true }
+  if (-not $ws.Interactive) {
+    Write-Note "non-interactive session: '$Prompt' answered no (pass --yes to confirm in batch)"
+    return $false
+  }
+  $hint = '[y/N]'
+  if ($Default -eq 'y') { $hint = '[Y/n]' }
+  $reply = Read-Line ("? $Prompt $hint ")
+  if ($null -eq $reply) { return $false }
+  $reply = $reply.Trim()
+  if ($reply -eq '') { $reply = $Default }
+  return ($reply -match '^(y|yes)$')
+}
+
+function Confirm-Typed {
+  <# .SYNOPSIS Critical confirmation: the user must type the literal word. Never auto-answered. #>
+  param([string] $Prompt, [string] $Word = 'yes')
+  if (-not $Script:WS.Interactive) { Write-Note "non-interactive session: '$Prompt' requires a typed '$Word'; skipped"; return $false }
+  Write-Warn $Prompt
+  $reply = Read-Line ("  Type '$Word' to proceed: ")
+  if ($null -eq $reply) { return $false }
+  return ($reply.Trim() -eq $Word)
+}
+
+function Read-MultiSelect {
+  <# .SYNOPSIS Parse "1,3,5-7" / all / none into a sorted unique list of 1-based indexes. #>
+  param([int] $Total)
+  if ($Total -le 0) { return @() }
+  if ($Script:WS.Yes) { return @(1..$Total) }
+  Write-UiLine "  Selection: 1,3,5-10 | all | none (Enter = none)" 'DarkGray' -NoLog
+  $reply = Read-Line ("  Select items (1..$Total): ")
+  return (ConvertTo-IndexList -Text $reply -Total $Total)
+}
+
+function ConvertTo-IndexList {
+  <# .SYNOPSIS Pure parser behind Read-MultiSelect (kept separate so the self-test can exercise it). #>
+  param([string] $Text, [int] $Total)
+  if ([string]::IsNullOrWhiteSpace($Text)) { return @() }
+  $t = $Text.Trim().ToLowerInvariant()
+  if ($t -in @('n', 'none')) { return @() }
+  if ($t -in @('a', 'all')) { return @(1..$Total) }
+  $set = New-Object System.Collections.Generic.SortedSet[int]
+  foreach ($part in ($t -split ',')) {
+    $part = $part.Trim()
+    if ($part -match '^(\d+)-(\d+)$') {
+      $a = [int]$Matches[1]; $b = [int]$Matches[2]
+      if ($a -gt $b) { $tmp = $a; $a = $b; $b = $tmp }
+      for ($i = $a; $i -le $b; $i++) { if ($i -ge 1 -and $i -le $Total) { $null = $set.Add($i) } }
+    } elseif ($part -match '^\d+$') {
+      $i = [int]$part
+      if ($i -ge 1 -and $i -le $Total) { $null = $set.Add($i) }
+    }
+  }
+  return @($set)
+}
+
+function Read-Choice {
+  <# .SYNOPSIS One-key choice; returns the lower-cased key or the default. #>
+  param([string] $Prompt, [string] $Default = '')
+  $reply = Read-Line $Prompt
+  if ($null -eq $reply -or $reply.Trim() -eq '') { return $Default }
+  return $reply.Trim().ToLowerInvariant()
+}
+
+function Wait-Enter {
+  if (-not $Script:WS.Interactive) { return }
+  $null = Read-Line "  - press Enter to continue - "
+}

package/modules/android_avd.ps1

@@ -0,0 +1,36 @@
+# android_avd.ps1 - section 4: Android emulators (AVDs). Slow to recreate, so per-AVD idle gate and never in --all.
+
+function Get-Targets04 {
+  return @((New-Target 4 'Android AVDs (each .avd + .ini pair)' "$($Script:P.U)\.android\avd" -Mode units -Dev $true -Note "an AVD goes only when nothing inside it changed for $($Script:WS.Days)+ days"))
+}
+
+function Invoke-Section04 {
+  $ws = $Script:WS
+  $root = Join-Path $Script:P.U '.android\avd'
+  Write-SectionIntro @(
+    'An emulator image is 5-15 GB and takes minutes to recreate. Each AVD is one unit: it is removed only when',
+    "every file inside it has been idle for $($ws.Days)+ days (booting an emulator updates its files)."
+  ) -Dev $true
+  if (-not (Test-DirPresent $root)) { Write-Info 'no AVDs found'; return }
+  if (Test-ProcessRunning @('qemu-system-x86_64', 'emulator', 'emulator64-crash-service')) { Write-Warn 'an Android emulator is running - section skipped'; return }
+  $avds = @()
+  foreach ($e in (Get-ChildEntries $root)) {
+    if (-not ($e -is [IO.DirectoryInfo]) -or $e.Name -notlike '*.avd') { continue }
+    $full = Remove-LongPrefix $e.FullName
+    $avds += [pscustomobject]@{ Name = $e.Name; Path = $full; Ini = (Join-Path $root ($e.Name -replace '\.avd$', '.ini')); Idle = (Get-IdleDays $full); Bytes = (Get-DirectoryBytes $full) }
+  }
+  if ($avds.Count -eq 0) { Write-Info 'no AVDs found'; return }
+  Write-UiLine ("  {0,-36} {1,10} {2,8}" -f 'AVD', 'SIZE', 'IDLE') 'White'
+  foreach ($a in $avds) { Write-UiLine ("  {0,-36} {1,10} {2,7}d" -f $a.Name, (Format-Bytes $a.Bytes), $a.Idle) 'Gray' }
+  $avds = @($avds)
+  $stale = @($avds | Where-Object { $_.Idle -ge $ws.Days -or $ws.PurgeAll })
+  if ($stale.Count -eq 0) { Write-Info "every AVD was used within the last $($ws.Days) days - nothing to prune"; return }
+  if (-not (Confirm-Section "Remove $($stale.Count) idle AVD(s)?" 'n')) { Write-Info 'skipped'; return }
+  foreach ($a in $stale) {
+    $r = Remove-PathSafe -Path $a.Path -Within $root -Label $a.Name
+    if ($r.Removed) {
+      if (Test-PathPresent $a.Ini) { $null = Remove-PathSafe -Path $a.Ini -Within $root -Label "$($a.Name) ini" }
+      if (-not $ws.DryRun) { Write-Ok ("removed AVD $($a.Name) ($($a.Idle)d idle, " + (Format-Bytes $r.Bytes) + ')') }
+    }
+  }
+}

package/modules/app_caches.ps1

@@ -0,0 +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
+  }
+}

package/modules/browsers.ps1

@@ -0,0 +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
+}

package/modules/build_tools.ps1

@@ -0,0 +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
+}

package/modules/crash_trap.ps1

@@ -0,0 +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-Log "CRASH: $msg"
+  Write-Log $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

@@ -0,0 +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" }
+  }
+}