windowsweep 1.0.1 → 1.2.0

package/modules/walkthrough.ps1

@@ -1,79 +1,80 @@
-# walkthrough.ps1 - the default interactive mode: every category, one step at a time, with a running total.
-
-function Show-Welcome {
-  $ws = $Script:WS
-  Write-Banner
-  Write-Box "$Script:WS_NAME" $Script:WS_TAGLINE
-  Show-DriveTable
-  Write-UiLine '' 'Gray'
-  Write-Plain '  This walkthrough visits every cleanup category. At each step:'
-  Write-Plain '    a  run it (default)     s  skip it     q  stop the walkthrough'
-  if ($ws.DryRun) { Write-UiLine '  DRY-RUN: every step only reports what it would remove.' 'Magenta' }
-  $dev = 'off'
-  if ($ws.Developer) { $dev = 'on' }
-  Write-Note "developer mode: $dev   idle window: $($ws.Days) days   temp window: $($ws.TempDays) days"
-  Write-Note "logs and reports: $($ws.Home)"
-  Write-Note "by $Script:WS_AUTHOR - $Script:WS_WEB"
-  Wait-Enter
-}
-
-function Invoke-Walkthrough {
-  $ws = $Script:WS
-  if (-not $ws.Interactive) {
-    Write-Err 'The walkthrough needs an interactive console. For unattended runs use:  windowsweep --all --yes   (or --scan / --dry-run to look first)'
-    $ws.ExitCode = $Script:WS_EXIT_USAGE
-    return
-  }
-  Show-Welcome
-  Write-Box 'Pre-scan' 'Read-only - what each section can reach right now'
-  if (Get-Command Invoke-Section00 -ErrorAction SilentlyContinue) { Invoke-Section00 }
-  $null = Show-ScanTable
-  Wait-Enter
-
-  $steps = @($Script:WS_WALKTHROUGH)
-  if ($ws.IsAdmin) { $steps += $Script:WS_WALKTHROUGH_ADMIN }
-  $total = $steps.Count + 2
-  $n = 0
-  $quit = $false
-  foreach ($id in $steps) {
-    $n++
-    $sec = Get-Section $id
-    Write-Step -N $n -Total $total -Title $sec.Title
-    $choice = Read-Choice -Prompt '  action: a run   s skip   q quit  > ' -Default 'a'
-    if ($choice -eq 'q') { Write-Warn 'walkthrough stopped'; Add-ReportStep -Section $id -Title $sec.Title -Status 'skipped' -Note 'quit'; $quit = $true; break }
-    if ($choice -eq 's') { Write-Info 'skipped'; Add-ReportStep -Section $id -Title $sec.Title -Status 'skipped'; continue }
-    $ws.SectionPreConfirmed = $true
-    try { Invoke-SectionById -Id $id } finally { $ws.SectionPreConfirmed = $false }
-  }
-  if (-not $quit -and -not $ws.IsAdmin) {
-    $n++
-    Write-Step -N $n -Total $total -Title 'System-level cleanup (needs Administrator)'
-    Write-Plain '  Sections 12 (Windows Update cache), 13 (Disk Cleanup engine) and 14 (component store) need an elevated'
-    Write-Plain '  console. Run them afterwards with:'
-    Write-Plain '      windowsweep --profile system --yes --elevate'
-    Write-Plain '  and, if you want the hibernation file gone too (section 15):'
-    Write-Plain '      windowsweep --only 12,13,14,15 --hiberfil off --yes --i-understand-deep --elevate'
-    $ws.Hints += 'Admin sections:  windowsweep --profile system --yes --elevate'
-    Wait-Enter
-  }
-  if (-not $quit) {
-    $n++
-    Write-Step -N $n -Total $total -Title 'Disk usage report'
-    Invoke-SectionById -Id 21
-  }
-  Show-SessionSummary
-  Show-NextSteps
-}
-
-function Show-NextSteps {
-  $ws = $Script:WS
-  $tips = @()
-  if (-not (Get-ScheduledTask -TaskName $Script:WS_TASK_NAME -ErrorAction SilentlyContinue)) { $tips += 'Schedule the safe batch weekly:   windowsweep --install-task' }
-  $tips += 'Browse or export past reports:    windowsweep --reports'
-  if ($ws.DryRun) { $tips += 'This was a dry-run. Run the same command without --dry-run to reclaim the space.' }
-  if ($tips.Count -gt 0) {
-    Write-UiLine '' 'Gray'
-    Write-Info 'next steps:'
-    foreach ($t in $tips) { Write-Note $t }
-  }
-}
+# walkthrough.ps1 - the default interactive mode: every category, one step at a time, with a running total.
+
+function Show-Welcome {
+  $ws = $Script:WS
+  Write-Banner
+  Write-Box "$Script:WS_NAME" $Script:WS_TAGLINE
+  Show-DriveTable
+  Write-UiLine '' 'Gray'
+  Write-Plain "  This walkthrough visits $($Script:WS_WALKTHROUGH.Count) sections, one at a time. At each step:"
+  Write-Plain '    a  run it (default)     s  skip it     q  stop the walkthrough'
+  if ($ws.DryRun) { Write-UiLine '  DRY-RUN: every step only reports what it would remove.' 'Magenta' }
+  $dev = 'off'
+  if ($ws.Developer) { $dev = 'on' }
+  Write-Note "developer mode: $dev   idle window: $($ws.Days) days   temp window: $($ws.TempDays) days"
+  Write-Note "logs and reports: $($ws.Home)"
+  Write-Note "by $Script:WS_AUTHOR - $Script:WS_WEB"
+  Wait-Enter
+}
+
+function Invoke-Walkthrough {
+  $ws = $Script:WS
+  if (-not $ws.Interactive) {
+    Write-Err 'The walkthrough needs an interactive console. For unattended runs use:  windowsweep --all --yes   (or --scan / --dry-run to look first)'
+    $ws.ExitCode = $Script:WS_EXIT_USAGE
+    return
+  }
+  Show-Welcome
+  Write-Box 'Pre-scan' 'Deletes nothing - what each section can reach right now'
+  if (Get-Command Invoke-Section00 -ErrorAction SilentlyContinue) { Invoke-Section00 }
+  $null = Show-ScanTable
+  Wait-Enter
+
+  $steps = @($Script:WS_WALKTHROUGH)
+  if ($ws.IsAdmin) { $steps += $Script:WS_WALKTHROUGH_ADMIN }
+  $total = $steps.Count + 2
+  $n = 0
+  $quit = $false
+  foreach ($id in $steps) {
+    $n++
+    $sec = Get-Section $id
+    Write-Step -N $n -Total $total -Title $sec.Title
+    $choice = Read-Choice -Prompt '  action: a run   s skip   q quit  > ' -Default 'a'
+    if ($choice -eq 'q') { Write-Warn 'walkthrough stopped'; Add-ReportStep -Section $id -Title $sec.Title -Status 'skipped' -Note 'quit'; $quit = $true; break }
+    if ($choice -eq 's') { Write-Info 'skipped'; Add-ReportStep -Section $id -Title $sec.Title -Status 'skipped'; continue }
+    $ws.SectionPreConfirmed = $true
+    try { Invoke-SectionById -Id $id } finally { $ws.SectionPreConfirmed = $false }
+  }
+  if (-not $quit -and -not $ws.IsAdmin) {
+    $n++
+    Write-Step -N $n -Total $total -Title 'System-level cleanup (needs Administrator)'
+    Write-Plain '  This walkthrough runs 12 (Windows Update cache), 13 (Disk Cleanup engine) and 14 (component'
+    Write-Plain '  store) when the console is elevated. Six sections need an elevated console in all - 15, 16 and'
+    Write-Plain '  20 need --i-understand-deep as well. Run the three afterwards with:'
+    Write-Plain '      windowsweep --profile system --yes --elevate'
+    Write-Plain '  and, to remove the hibernation file too (section 15):'
+    Write-Plain '      windowsweep --only 12,13,14,15 --hiberfil off --yes --i-understand-deep --elevate'
+    $ws.Hints += 'Admin sections:  windowsweep --profile system --yes --elevate'
+    Wait-Enter
+  }
+  if (-not $quit) {
+    $n++
+    Write-Step -N $n -Total $total -Title 'Disk usage report'
+    Invoke-SectionById -Id 21
+  }
+  Show-SessionSummary
+  Show-NextSteps
+}
+
+function Show-NextSteps {
+  $ws = $Script:WS
+  $tips = @()
+  if (-not (Get-ScheduledTask -TaskName $Script:WS_TASK_NAME -ErrorAction SilentlyContinue)) { $tips += 'Schedule the safe batch weekly:   windowsweep --install-task' }
+  $tips += 'Browse or export past reports:    windowsweep --reports'
+  if ($ws.DryRun) { $tips += 'This was a dry-run. Run the same command without --dry-run to reclaim the space.' }
+  if ($tips.Count -gt 0) {
+    Write-UiLine '' 'Gray'
+    Write-Info 'next steps:'
+    foreach ($t in $tips) { Write-Note $t }
+  }
+}

package/modules/windows_user.ps1

@@ -1,112 +1,118 @@
-# windows_user.ps1 - section 9 (Windows user caches), section 10 (user temp), section 11 (Recycle Bin).
-
-function Get-Targets09 {
-  $P = $Script:P
-  return @(
-    (New-Target 9 'Internet cache (INetCache)' "$($P.L)\Microsoft\Windows\INetCache" -Mode clear -Note 'IE / legacy WebView cache')
-    (New-Target 9 'Windows Error Reporting (user)' "$($P.L)\Microsoft\Windows\WER" -Mode clear)
-    (New-Target 9 'Crash dumps' "$($P.L)\CrashDumps" -Mode clear-old -Days 7)
-    (New-Target 9 'DirectX shader cache' "$($P.L)\D3DSCache" -Mode clear)
-    (New-Target 9 'NVIDIA DirectX shader cache' "$($P.L)\NVIDIA\DXCache" -Mode clear)
-    (New-Target 9 'NVIDIA OpenGL shader cache' "$($P.L)\NVIDIA\GLCache" -Mode clear)
-    (New-Target 9 'NVIDIA NV_Cache' "$($P.L)\NVIDIA Corporation\NV_Cache" -Mode clear)
-    (New-Target 9 'AMD DirectX shader cache' "$($P.L)\AMD\DxCache" -Mode clear)
-    (New-Target 9 'AMD OpenGL shader cache' "$($P.L)\AMD\GLCache" -Mode clear)
-    (New-Target 9 'Intel shader cache' "$($P.L)\Intel\ShaderCache" -Mode clear)
-    (New-Target 9 'Remote Desktop bitmap cache' "$($P.L)\Microsoft\Terminal Server Client\Cache" -Mode clear)
-    (New-Target 9 'OneDrive logs' "$($P.L)\Microsoft\OneDrive\logs" -Mode clear-old -Days 7)
-    (New-Target 9 'OneDrive setup logs' "$($P.L)\Microsoft\OneDrive\setup\logs" -Mode clear-old -Days 7)
-    (New-Target 9 'Store apps TempState' "$($P.L)\Packages\*\TempState" -Kind glob -Mode clear)
-    (New-Target 9 'Store apps AC\Temp' "$($P.L)\Packages\*\AC\Temp" -Kind glob -Mode clear)
-    (New-Target 9 'Store apps AC\INetCache' "$($P.L)\Packages\*\AC\INetCache" -Kind glob -Mode clear)
-    (New-Target 9 'Themes cached files' "$($P.L)\Microsoft\Windows\Themes\CachedFiles" -Mode clear)
-    (New-Target 9 'PowerShell startup profile data' "$($P.L)\Microsoft\Windows\PowerShell\StartupProfileData-*" -Kind fileglob -Mode file)
-    (New-Target 9 'CLR usage logs' "$($P.L)\Microsoft\CLR_v4.0\UsageLogs" -Mode clear)
-    (New-Target 9 'CLR usage logs (32-bit)' "$($P.L)\Microsoft\CLR_v4.0_32\UsageLogs" -Mode clear)
-    (New-Target 9 'Explorer thumbcache leftovers' "$($P.L)\Microsoft\Windows\Explorer\ThumbCacheToDelete" -Mode clear)
-    (New-Target 9 'Explorer iconcache leftovers' "$($P.L)\Microsoft\Windows\Explorer\IconCacheToDelete" -Mode clear)
-    (New-Target 9 'Explorer startup logs' "$($P.L)\Microsoft\Windows\Explorer\ExplorerStartupLog*.etl" -Kind fileglob -Mode file)
-    (New-Target 9 'Windows schema cache' "$($P.L)\Microsoft\Windows\SchCache" -Mode clear)
-    (New-Target 9 'Delivery Optimization (per user)' "$($P.L)\Microsoft\Windows\DeliveryOptimization\Cache" -Mode clear)
-    (New-Target 9 'Certificate URL cache' "$($P.LL)\Microsoft\CryptnetUrlCache" -Mode clear)
-    (New-Target 9 'Diagnostics results' "$($P.L)\Diagnostics" -Mode clear-old -Days 30)
-    (New-Target 9 'DNS resolver cache' 'ipconfig /flushdns' -Kind cmd)
-  )
-}
-
-function Invoke-Section09 {
-  Write-SectionIntro @(
-    'Caches Windows and its drivers rebuild silently: shader caches, error-report queues, crash dumps, Store-app',
-    'temp folders, Remote Desktop bitmaps. Files an app is holding open are skipped. The Explorer thumbnail and',
-    'icon databases themselves belong to Disk Cleanup (section 13, admin), which rebuilds them cleanly.'
-  )
-  $targets = Get-Targets09
-  $null = Show-TargetSizes $targets
-  if (-not (Confirm-Section 'Clear Windows user caches now?')) { Write-Info 'skipped'; return }
-  $null = Invoke-TargetList $targets
-  $r = Invoke-External -FilePath 'ipconfig.exe' -ArgumentList @('/flushdns') -Destructive -Quiet -Label 'ipconfig /flushdns'
-  if ($r.Ran -and $r.ExitCode -eq 0) { Write-Ok 'DNS resolver cache flushed' }
-}
-
-# ---------------------------------------------------------------------------------------------
-# Section 10 - user temp
-# ---------------------------------------------------------------------------------------------
-
-function Get-TempRoots {
-  $P = $Script:P
-  $roots = @()
-  foreach ($r in @($P.TEMP, $P.TMP, (Join-Path $P.L 'Temp'), (Join-Path $P.LL 'Temp'))) {
-    if ($r -and (Test-DirPresent $r)) { $f = Get-FullPath $r; if ($roots -notcontains $f) { $roots += $f } }
-  }
-  return $roots
-}
-
-function Get-Targets10 {
-  $t = @()
-  foreach ($r in (Get-TempRoots)) { $t += (New-Target 10 'User temp' $r -Mode prune -Days $Script:WS.TempDays -Note "files idle $($Script:WS.TempDays)+ days; open files are skipped") }
-  return $t
-}
-
-function Invoke-Section10 {
-  $ws = $Script:WS
-  Write-SectionIntro @(
-    "Temporary files idle for $($ws.TempDays)+ days. Files a running program still has open are skipped, so an",
-    'installer or build that is in progress right now is safe. Lower the window with --temp-days 1 for a harder sweep.'
-  )
-  $targets = @(Get-Targets10)
-  if ($targets.Count -eq 0) { Write-Info 'no temp folders found'; return }
-  $null = Show-TargetSizes $targets
-  if (-not (Confirm-Section "Remove temp files idle $($ws.TempDays)+ days?")) { Write-Info 'skipped'; return }
-  $null = Invoke-TargetList $targets
-}
-
-# ---------------------------------------------------------------------------------------------
-# Section 11 - Recycle Bin
-# ---------------------------------------------------------------------------------------------
-
-function Get-Targets11 { return @((New-Target 11 'Recycle Bin (all drives)' 'Clear-RecycleBin' -Kind cmd -Note 'PERMANENT - everything in the bin is gone')) }
-
-function Get-RecycleBinStats {
-  $items = 0; $bytes = [long]0
-  try {
-    $shell = New-Object -ComObject Shell.Application
-    $bin = $shell.NameSpace(0xA)
-    foreach ($i in $bin.Items()) { $items++; try { $bytes += [long]$i.Size } catch { $null = $_ } }
-  } catch { $null = $_ }
-  return [pscustomobject]@{ Items = $items; Bytes = $bytes }
-}
-
-function Invoke-Section11 {
-  $ws = $Script:WS
-  Write-SectionIntro @('Emptying the Recycle Bin is permanent: nothing in it can be restored afterwards.')
-  $s = Get-RecycleBinStats
-  Write-Kv 'Recycle Bin:' ("{0} item(s), {1}" -f $s.Items, (Format-Bytes $s.Bytes))
-  if ($s.Items -eq 0) { Write-Info 'already empty'; return }
-  if ($ws.DryRun) { Write-DryRun ("would empty the Recycle Bin (" + (Format-Bytes $s.Bytes) + ')'); Add-Freed $s.Bytes; return }
-  if (-not (Confirm-Ui -Prompt "Permanently delete all $($s.Items) item(s) in the Recycle Bin?" -Default 'n')) { Write-Info 'skipped'; return }
-  try {
-    Clear-RecycleBin -Force -ErrorAction Stop
-    Add-Freed $s.Bytes
-    Write-Ok ("Recycle Bin emptied (" + (Format-Bytes $s.Bytes) + ')')
-  } catch { Write-Err "could not empty the Recycle Bin: $($_.Exception.Message)" }
-}
+# windows_user.ps1 - section 9 (Windows user caches), section 10 (user temp), section 11 (Recycle Bin).
+
+function Get-Targets09 {
+  $P = $Script:P
+  return @(
+    (New-Target 9 'Internet cache (INetCache)' "$($P.L)\Microsoft\Windows\INetCache" -Mode clear -Note 'IE / legacy WebView cache')
+    (New-Target 9 'Windows Error Reporting (user)' "$($P.L)\Microsoft\Windows\WER" -Mode clear)
+    (New-Target 9 'Crash dumps' "$($P.L)\CrashDumps" -Mode clear-old -Days 7)
+    (New-Target 9 'DirectX shader cache' "$($P.L)\D3DSCache" -Mode clear)
+    (New-Target 9 'NVIDIA DirectX shader cache' "$($P.L)\NVIDIA\DXCache" -Mode clear)
+    (New-Target 9 'NVIDIA OpenGL shader cache' "$($P.L)\NVIDIA\GLCache" -Mode clear)
+    (New-Target 9 'NVIDIA NV_Cache' "$($P.L)\NVIDIA Corporation\NV_Cache" -Mode clear)
+    (New-Target 9 'AMD DirectX shader cache' "$($P.L)\AMD\DxCache" -Mode clear)
+    (New-Target 9 'AMD OpenGL shader cache' "$($P.L)\AMD\GLCache" -Mode clear)
+    (New-Target 9 'Intel shader cache' "$($P.L)\Intel\ShaderCache" -Mode clear)
+    (New-Target 9 'Remote Desktop bitmap cache' "$($P.L)\Microsoft\Terminal Server Client\Cache" -Mode clear)
+    (New-Target 9 'OneDrive logs' "$($P.L)\Microsoft\OneDrive\logs" -Mode clear-old -Days 7)
+    (New-Target 9 'OneDrive setup logs' "$($P.L)\Microsoft\OneDrive\setup\logs" -Mode clear-old -Days 7)
+    (New-Target 9 'Store apps TempState' "$($P.L)\Packages\*\TempState" -Kind glob -Mode clear)
+    (New-Target 9 'Store apps AC\Temp' "$($P.L)\Packages\*\AC\Temp" -Kind glob -Mode clear)
+    (New-Target 9 'Store apps AC\INetCache' "$($P.L)\Packages\*\AC\INetCache" -Kind glob -Mode clear)
+    (New-Target 9 'Themes cached files' "$($P.L)\Microsoft\Windows\Themes\CachedFiles" -Mode clear)
+    (New-Target 9 'PowerShell startup profile data' "$($P.L)\Microsoft\Windows\PowerShell\StartupProfileData-*" -Kind fileglob -Mode file)
+    (New-Target 9 'CLR usage logs' "$($P.L)\Microsoft\CLR_v4.0\UsageLogs" -Mode clear)
+    (New-Target 9 'CLR usage logs (32-bit)' "$($P.L)\Microsoft\CLR_v4.0_32\UsageLogs" -Mode clear)
+    (New-Target 9 'Explorer thumbcache leftovers' "$($P.L)\Microsoft\Windows\Explorer\ThumbCacheToDelete" -Mode clear)
+    (New-Target 9 'Explorer iconcache leftovers' "$($P.L)\Microsoft\Windows\Explorer\IconCacheToDelete" -Mode clear)
+    (New-Target 9 'Explorer startup logs' "$($P.L)\Microsoft\Windows\Explorer\ExplorerStartupLog*.etl" -Kind fileglob -Mode file)
+    (New-Target 9 'Windows schema cache' "$($P.L)\Microsoft\Windows\SchCache" -Mode clear)
+    (New-Target 9 'Delivery Optimization (per user)' "$($P.L)\Microsoft\Windows\DeliveryOptimization\Cache" -Mode clear)
+    (New-Target 9 'Certificate URL cache' "$($P.LL)\Microsoft\CryptnetUrlCache" -Mode clear)
+    (New-Target 9 'Diagnostics results' "$($P.L)\Diagnostics" -Mode clear-old -Days 30)
+    (New-Target 9 'DNS resolver cache' 'ipconfig /flushdns' -Kind cmd)
+    (New-Target 9 'Microsoft Store download cache' 'wsreset.exe' -Kind cmd -Note 'printed as a next step, never run for you: wsreset has no silent mode and always opens the Store')
+  )
+}
+
+function Invoke-Section09 {
+  Write-SectionIntro @(
+    'Caches Windows and its drivers rebuild silently: shader caches, error-report queues, crash dumps, Store-app',
+    'temp folders, Remote Desktop bitmaps. Files an app is holding open are skipped. The Explorer thumbnail and',
+    'icon databases themselves belong to Disk Cleanup (section 13, admin), which rebuilds them cleanly.'
+  )
+  $targets = Get-Targets09
+  $null = Show-TargetSizes $targets
+  if (-not (Confirm-Section 'Clear Windows user caches now?')) { Write-Info 'skipped'; return }
+  $null = Invoke-TargetList $targets
+  $r = Invoke-External -FilePath 'ipconfig.exe' -ArgumentList @('/flushdns') -Destructive -Quiet -Label 'ipconfig /flushdns'
+  if ($r.Ran -and $r.ExitCode -eq 0) { Write-Ok 'DNS resolver cache flushed' }
+  # wsreset is the only lever for the Store download cache, and it has no silent switch: every build opens
+  # the Store window when it finishes. A cleanup run must not pop a window, so it is offered, never executed.
+  if (Test-PathPresent (Join-Path $Script:P.SR 'System32\wsreset.exe')) {
+    $Script:WS.Hints += 'Microsoft Store cache: run  wsreset.exe  yourself when you want it cleared (it opens the Store when it finishes)'
+  }
+}
+
+# ---------------------------------------------------------------------------------------------
+# Section 10 - user temp
+# ---------------------------------------------------------------------------------------------
+
+function Get-TempRoots {
+  $P = $Script:P
+  $roots = @()
+  foreach ($r in @($P.TEMP, $P.TMP, (Join-Path $P.L 'Temp'), (Join-Path $P.LL 'Temp'))) {
+    if ($r -and (Test-DirPresent $r)) { $f = Get-FullPath $r; if ($roots -notcontains $f) { $roots += $f } }
+  }
+  return $roots
+}
+
+function Get-Targets10 {
+  $t = @()
+  foreach ($r in (Get-TempRoots)) { $t += (New-Target 10 'User temp' $r -Mode prune -Days $Script:WS.TempDays -Note "files idle $($Script:WS.TempDays)+ days; open files are skipped") }
+  return $t
+}
+
+function Invoke-Section10 {
+  $ws = $Script:WS
+  Write-SectionIntro @(
+    "Temporary files idle for $($ws.TempDays)+ days. Files a running program still has open are skipped, so an",
+    'installer or build that is in progress right now is safe. Lower the window with --temp-days 1 for a harder sweep.'
+  )
+  $targets = @(Get-Targets10)
+  if ($targets.Count -eq 0) { Write-Info 'no temp folders found'; return }
+  $null = Show-TargetSizes $targets
+  if (-not (Confirm-Section "Remove temp files idle $($ws.TempDays)+ days?")) { Write-Info 'skipped'; return }
+  $null = Invoke-TargetList $targets
+}
+
+# ---------------------------------------------------------------------------------------------
+# Section 11 - Recycle Bin
+# ---------------------------------------------------------------------------------------------
+
+function Get-Targets11 { return @((New-Target 11 'Recycle Bin (all drives)' 'Clear-RecycleBin' -Kind cmd -Note 'PERMANENT - everything in the bin is gone')) }
+
+function Get-RecycleBinStats {
+  $items = 0; $bytes = [long]0
+  try {
+    $shell = New-Object -ComObject Shell.Application
+    $bin = $shell.NameSpace(0xA)
+    foreach ($i in $bin.Items()) { $items++; try { $bytes += [long]$i.Size } catch { $null = $_ } }
+  } catch { $null = $_ }
+  return [pscustomobject]@{ Items = $items; Bytes = $bytes }
+}
+
+function Invoke-Section11 {
+  $ws = $Script:WS
+  Write-SectionIntro @('Emptying the Recycle Bin is permanent: nothing in it can be restored afterwards.')
+  $s = Get-RecycleBinStats
+  Write-Kv 'Recycle Bin:' ("{0} item(s), {1}" -f $s.Items, (Format-Bytes $s.Bytes))
+  if ($s.Items -eq 0) { Write-Info 'already empty'; return }
+  if ($ws.DryRun) { Write-DryRun ("would empty the Recycle Bin (" + (Format-Bytes $s.Bytes) + ')'); Add-Freed $s.Bytes; return }
+  if (-not (Confirm-Ui -Prompt "Permanently delete all $($s.Items) item(s) in the Recycle Bin?" -Default 'n')) { Write-Info 'skipped'; return }
+  try {
+    Clear-RecycleBin -Force -ErrorAction Stop
+    Add-Freed $s.Bytes
+    Write-Ok ("Recycle Bin emptied (" + (Format-Bytes $s.Bytes) + ')')
+  } catch { Write-Err "could not empty the Recycle Bin: $($_.Exception.Message)" }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "windowsweep",
-  "version": "1.0.1",
-  "description": "Safe-by-default Windows cleanup CLI - developer-aware, dry-run first, zero install via npx.",
+  "version": "1.2.0",
+  "description": "Developer-aware Windows cleanup CLI: dry-run first, personal folders refused, zero install via npx.",
   "bin": {
     "windowsweep": "bin/windowsweep.js"
   },
@@ -24,7 +24,8 @@
     "LICENSE",
     "CHANGELOG.md",
     "SECURITY.md",
-    "VERSION"
+    "VERSION",
+    "AI-INTEGRATION-GUIDE.md"
   ],
   "engines": {
     "node": ">=14"