windowsweep 1.1.0 → 1.3.0

package/modules/personal.ps1

@@ -1,126 +1,126 @@
-# personal.ps1 - sections 18 and 19: personal files in Downloads. Interactive only; the Recycle Bin is the destination.
-
-$Script:WS_PARTIAL_PATTERNS = @('*.crdownload', '*.part', '*.partial', '*.fdmdownload', '*.opdownload', '*.!ut', '*.aria2', '*.download', '*.bc!', '*.tmp')
-
-function Get-PersonalRoots {
-  $roots = @()
-  $d = Join-Path $Script:P.U 'Downloads'
-  if (Test-DirPresent $d) { $roots += (Get-FullPath $d) }
-  return $roots
-}
-
-function Get-Targets18 {
-  $t = @()
-  foreach ($r in (Get-PersonalRoots)) { $t += (New-Target 18 'Partial / orphan downloads' $r -Kind cmd -Note ($Script:WS_PARTIAL_PATTERNS -join ' ')) }
-  return $t
-}
-
-function Get-Targets19 {
-  $t = @()
-  foreach ($r in (Get-PersonalRoots)) { $t += (New-Target 19 "Files >= $($Script:WS.LargeFileMb) MB idle $($Script:WS.Days)+ days" $r -Kind cmd -Note 'moved to the Recycle Bin after you pick them') }
-  return $t
-}
-
-function Get-FilesUnder {
-  <# .SYNOPSIS Files under Root up to MaxDepth, never following links, never entering protected folders. #>
-  param([string] $Root, [int] $MaxDepth = 4)
-  $out = New-Object System.Collections.Generic.List[object]
-  $stack = New-Object System.Collections.Generic.Stack[object]
-  $stack.Push(@($Root, 0))
-  while ($stack.Count -gt 0) {
-    $item = $stack.Pop()
-    foreach ($e in (Get-ChildEntries ([string]$item[0]))) {
-      if (Test-ReparsePoint $e) { continue }
-      if ($e -is [IO.DirectoryInfo]) { if ([int]$item[1] -lt $MaxDepth) { $stack.Push(@((Remove-LongPrefix $e.FullName), [int]$item[1] + 1)) }; continue }
-      $out.Add($e)
-    }
-  }
-  return $out
-}
-
-function Get-PartialDownloads {
-  $list = @()
-  foreach ($root in (Get-PersonalRoots)) {
-    foreach ($f in (Get-FilesUnder -Root $root -MaxDepth 4)) {
-      foreach ($pat in $Script:WS_PARTIAL_PATTERNS) {
-        if ($f.Name -like $pat) { $list += [pscustomobject]@{ Path = (Remove-LongPrefix $f.FullName); Bytes = [long]$f.Length; Idle = [int][math]::Floor(([datetime]::UtcNow - (Get-NewestTimestampUtc $f)).TotalDays); Root = $root }; break }
-      }
-    }
-  }
-  return @($list | Sort-Object Bytes -Descending)
-}
-
-function Get-LargeStaleFiles {
-  $ws = $Script:WS
-  $min = [long]$ws.LargeFileMb * 1MB
-  $list = @()
-  foreach ($root in (Get-PersonalRoots)) {
-    foreach ($f in (Get-FilesUnder -Root $root -MaxDepth 4)) {
-      if ([long]$f.Length -lt $min) { continue }
-      $idle = [int][math]::Floor(([datetime]::UtcNow - (Get-NewestTimestampUtc $f)).TotalDays)
-      if ($idle -lt $ws.Days) { continue }
-      $list += [pscustomobject]@{ Path = (Remove-LongPrefix $f.FullName); Bytes = [long]$f.Length; Idle = $idle; Root = $root }
-    }
-  }
-  return @($list | Sort-Object Bytes -Descending | Select-Object -First 100)
-}
-
-function Show-FileTable {
-  param([object[]] $Rows)
-  Write-UiLine ("  {0,3}  {1,10} {2,6}  {3}" -f '#', 'SIZE', 'IDLE', 'FILE') 'White'
-  $i = 1
-  foreach ($r in $Rows) { Write-UiLine ("  {0,3}  {1,10} {2,5}d  {3}" -f $i, (Format-Bytes $r.Bytes), $r.Idle, $r.Path) 'Gray'; $i++ }
-}
-
-function Invoke-PersonalPicker {
-  param([object[]] $Rows, [string] $Prompt, [int] $Section = 0)
-  $ws = $Script:WS
-  $Rows = @($Rows)
-  if ($Rows.Count -eq 0) { Write-Info 'none found'; return }
-  Show-FileTable $Rows
-  $total = [long]0
-  $i = 1
-  foreach ($r in $Rows) { $total += $r.Bytes; Add-JsonCandidate -Section $Section -Index $i -Path $r.Path -Bytes $r.Bytes -IdleDays $r.Idle; $i++ }
-  Write-Info ("total: " + (Format-Bytes $total))
-  $dest = 'the Recycle Bin'
-  if ($ws.Permanent) { $dest = 'PERMANENT deletion (--permanent)' }
-  Write-Note "selected files go to $dest"
-  $picks = @(Read-MultiSelect -Total $Rows.Count -NoAutoYes -Candidates @($Rows | ForEach-Object { $_.Path }))
-  if ($picks.Count -eq 0) { Write-Info 'nothing selected'; return }
-  if (-not $ws.DryRun) {
-    # Personal files never auto-confirm: --yes does not apply here. An explicit --select / --select-file
-    # choice does, because it is a person naming these exact files in advance.
-    if (-not (Confirm-Ui -Prompt "$Prompt ($($picks.Count) file(s))?" -Default 'n' -NoAutoYes -ScriptedOk)) { Write-Info 'skipped'; return }
-  }
-  foreach ($k in $picks) { $null = Send-ToRecycleBin -Path $Rows[$k - 1].Path -Within $Rows[$k - 1].Root }
-}
-
-function Invoke-Section18 {
-  Write-SectionIntro @(
-    'Half-finished downloads left behind by browsers and download managers (.crdownload, .part, .tmp, ...).',
-    'You pick what goes; it lands in the Recycle Bin. Desktop and cloud-synced folders are never scanned.'
-  )
-  if (@(Get-PersonalRoots).Count -eq 0) { Write-Info 'no Downloads folder found'; return }
-  Invoke-PersonalPicker -Rows @(Get-PartialDownloads) -Prompt 'Move the selected partial downloads to the Recycle Bin' -Section 18
-}
-
-function Invoke-Section19 {
-  $ws = $Script:WS
-  Write-SectionIntro @(
-    "Files of $($ws.LargeFileMb) MB or more in Downloads that nothing has touched for $($ws.Days)+ days: old installers, ISOs,",
-    'archives you already extracted. You pick what goes; it lands in the Recycle Bin.'
-  )
-  if (@(Get-PersonalRoots).Count -eq 0) { Write-Info 'no Downloads folder found'; return }
-  Invoke-PersonalPicker -Rows @(Get-LargeStaleFiles) -Prompt 'Move the selected files to the Recycle Bin' -Section 19
-}
-
-function Show-PersonalScan {
-  <# .SYNOPSIS Read-only listing used by --scan. #>
-  Write-Box 'Personal files (read-only)' 'Sections 18 and 19 are interactive only - nothing here is deleted'
-  Write-Section 'Partial / orphan downloads'
-  $p = @(Get-PartialDownloads)
-  if ($p.Count -eq 0) { Write-Info 'none found' } else { Show-FileTable @($p | Select-Object -First 30) }
-  Write-Section "Files >= $($Script:WS.LargeFileMb) MB idle $($Script:WS.Days)+ days in Downloads"
-  $l = @(Get-LargeStaleFiles)
-  if ($l.Count -eq 0) { Write-Info 'none found' } else { Show-FileTable @($l | Select-Object -First 30) }
-}
+# personal.ps1 - sections 18 and 19: personal files in Downloads. Interactive only; the Recycle Bin is the destination.
+
+$Script:WS_PARTIAL_PATTERNS = @('*.crdownload', '*.part', '*.partial', '*.fdmdownload', '*.opdownload', '*.!ut', '*.aria2', '*.download', '*.bc!', '*.tmp')
+
+function Get-PersonalRoots {
+  $roots = @()
+  $d = Join-Path $Script:P.U 'Downloads'
+  if (Test-DirPresent $d) { $roots += (Get-FullPath $d) }
+  return $roots
+}
+
+function Get-Targets18 {
+  $t = @()
+  foreach ($r in (Get-PersonalRoots)) { $t += (New-Target 18 'Partial / orphan downloads' $r -Kind cmd -Note ($Script:WS_PARTIAL_PATTERNS -join ' ')) }
+  return $t
+}
+
+function Get-Targets19 {
+  $t = @()
+  foreach ($r in (Get-PersonalRoots)) { $t += (New-Target 19 "Files >= $($Script:WS.LargeFileMb) MB idle $($Script:WS.Days)+ days" $r -Kind cmd -Note 'moved to the Recycle Bin after you pick them') }
+  return $t
+}
+
+function Get-FilesUnder {
+  <# .SYNOPSIS Files under Root up to MaxDepth, never following links, never entering protected folders. #>
+  param([string] $Root, [int] $MaxDepth = 4)
+  $out = New-Object System.Collections.Generic.List[object]
+  $stack = New-Object System.Collections.Generic.Stack[object]
+  $stack.Push(@($Root, 0))
+  while ($stack.Count -gt 0) {
+    $item = $stack.Pop()
+    foreach ($e in (Get-ChildEntries ([string]$item[0]))) {
+      if (Test-ReparsePoint $e) { continue }
+      if ($e -is [IO.DirectoryInfo]) { if ([int]$item[1] -lt $MaxDepth) { $stack.Push(@((Remove-LongPrefix $e.FullName), [int]$item[1] + 1)) }; continue }
+      $out.Add($e)
+    }
+  }
+  return $out
+}
+
+function Get-PartialDownloads {
+  $list = @()
+  foreach ($root in (Get-PersonalRoots)) {
+    foreach ($f in (Get-FilesUnder -Root $root -MaxDepth 4)) {
+      foreach ($pat in $Script:WS_PARTIAL_PATTERNS) {
+        if ($f.Name -like $pat) { $list += [pscustomobject]@{ Path = (Remove-LongPrefix $f.FullName); Bytes = [long]$f.Length; Idle = [int][math]::Floor(([datetime]::UtcNow - (Get-NewestTimestampUtc $f)).TotalDays); Root = $root }; break }
+      }
+    }
+  }
+  return @($list | Sort-Object Bytes -Descending)
+}
+
+function Get-LargeStaleFiles {
+  $ws = $Script:WS
+  $min = [long]$ws.LargeFileMb * 1MB
+  $list = @()
+  foreach ($root in (Get-PersonalRoots)) {
+    foreach ($f in (Get-FilesUnder -Root $root -MaxDepth 4)) {
+      if ([long]$f.Length -lt $min) { continue }
+      $idle = [int][math]::Floor(([datetime]::UtcNow - (Get-NewestTimestampUtc $f)).TotalDays)
+      if ($idle -lt $ws.Days) { continue }
+      $list += [pscustomobject]@{ Path = (Remove-LongPrefix $f.FullName); Bytes = [long]$f.Length; Idle = $idle; Root = $root }
+    }
+  }
+  return @($list | Sort-Object Bytes -Descending | Select-Object -First 100)
+}
+
+function Show-FileTable {
+  param([object[]] $Rows)
+  Write-UiLine ("  {0,3}  {1,10} {2,6}  {3}" -f '#', 'SIZE', 'IDLE', 'FILE') 'White'
+  $i = 1
+  foreach ($r in $Rows) { Write-UiLine ("  {0,3}  {1,10} {2,5}d  {3}" -f $i, (Format-Bytes $r.Bytes), $r.Idle, $r.Path) 'Gray'; $i++ }
+}
+
+function Invoke-PersonalPicker {
+  param([object[]] $Rows, [string] $Prompt, [int] $Section = 0)
+  $ws = $Script:WS
+  $Rows = @($Rows)
+  if ($Rows.Count -eq 0) { Write-Info 'none found'; return }
+  Show-FileTable $Rows
+  $total = [long]0
+  $i = 1
+  foreach ($r in $Rows) { $total += $r.Bytes; Add-JsonCandidate -Section $Section -Index $i -Path $r.Path -Bytes $r.Bytes -IdleDays $r.Idle; $i++ }
+  Write-Info ("total: " + (Format-Bytes $total))
+  $dest = 'the Recycle Bin'
+  if ($ws.Permanent) { $dest = 'PERMANENT deletion (--permanent)' }
+  Write-Note "selected files go to $dest"
+  $picks = @(Read-MultiSelect -Total $Rows.Count -NoAutoYes -Candidates @($Rows | ForEach-Object { $_.Path }))
+  if ($picks.Count -eq 0) { Write-Info 'nothing selected'; return }
+  if (-not $ws.DryRun) {
+    # Personal files never auto-confirm: --yes does not apply here. An explicit --select / --select-file
+    # choice does, because it is a person naming these exact files in advance.
+    if (-not (Confirm-Ui -Prompt "$Prompt ($($picks.Count) file(s))?" -Default 'n' -NoAutoYes -ScriptedOk)) { Write-Info 'skipped'; return }
+  }
+  foreach ($k in $picks) { $null = Send-ToRecycleBin -Path $Rows[$k - 1].Path -Within $Rows[$k - 1].Root }
+}
+
+function Invoke-Section18 {
+  Write-SectionIntro @(
+    'Half-finished downloads left behind by browsers and download managers (.crdownload, .part, .tmp, ...).',
+    'You pick what goes; it lands in the Recycle Bin. Desktop and cloud-synced folders are never scanned.'
+  )
+  if (@(Get-PersonalRoots).Count -eq 0) { Write-Info 'no Downloads folder found'; return }
+  Invoke-PersonalPicker -Rows @(Get-PartialDownloads) -Prompt 'Move the selected partial downloads to the Recycle Bin' -Section 18
+}
+
+function Invoke-Section19 {
+  $ws = $Script:WS
+  Write-SectionIntro @(
+    "Files of $($ws.LargeFileMb) MB or more in Downloads that nothing has touched for $($ws.Days)+ days: old installers, ISOs,",
+    'archives you already extracted. You pick what goes; it lands in the Recycle Bin.'
+  )
+  if (@(Get-PersonalRoots).Count -eq 0) { Write-Info 'no Downloads folder found'; return }
+  Invoke-PersonalPicker -Rows @(Get-LargeStaleFiles) -Prompt 'Move the selected files to the Recycle Bin' -Section 19
+}
+
+function Show-PersonalScan {
+  <# .SYNOPSIS Read-only listing used by --scan. #>
+  Write-Box 'Personal files (read-only)' 'Sections 18 and 19 are interactive only - nothing here is deleted'
+  Write-Section 'Partial / orphan downloads'
+  $p = @(Get-PartialDownloads)
+  if ($p.Count -eq 0) { Write-Info 'none found' } else { Show-FileTable @($p | Select-Object -First 30) }
+  Write-Section "Files >= $($Script:WS.LargeFileMb) MB idle $($Script:WS.Days)+ days in Downloads"
+  $l = @(Get-LargeStaleFiles)
+  if ($l.Count -eq 0) { Write-Info 'none found' } else { Show-FileTable @($l | Select-Object -First 30) }
+}

package/modules/pkg_managers.ps1

@@ -1,73 +1,73 @@
-# pkg_managers.ps1 - section 1: package-manager caches. All regenerable; the idle gate keeps recent work fast.
-
-function Get-Targets01 {
-  $P = $Script:P
-  $npm = Get-NpmCacheDir
-  return @(
-    (New-Target 1 'npm cache (_cacache)' (Join-Path $npm '_cacache') -Mode prune -Dev $true -Note 'regenerated on the next npm install')
-    (New-Target 1 'npx package cache (_npx)' (Join-Path $npm '_npx') -Mode prune -Dev $true)
-    (New-Target 1 'npm logs' (Join-Path $npm '_logs') -Mode clear-old -Days 7)
-    (New-Target 1 'Yarn v1 cache' "$($P.L)\Yarn\Cache" -Mode prune -Dev $true -Note 'yarn classic offline mirror')
-    (New-Target 1 'Yarn Berry global cache' "$($P.L)\Yarn\Berry\cache" -Mode prune -Dev $true)
-    (New-Target 1 'pnpm content store' "$($P.L)\pnpm\store" -Mode prune -Dev $true -Note 'pnpm store prune is used instead when pnpm is installed')
-    (New-Target 1 'pnpm metadata cache' "$($P.L)\pnpm-cache" -Mode prune -Dev $true)
-    (New-Target 1 'bun install cache' "$($P.U)\.bun\install\cache" -Mode prune -Dev $true -Note 'global bun packages stay')
-    (New-Target 1 'deno deps cache' "$($P.L)\deno\deps" -Mode prune -Dev $true -Note 'installed deno scripts (~\.deno\bin) stay')
-    (New-Target 1 'deno gen cache' "$($P.L)\deno\gen" -Mode prune -Dev $true)
-    (New-Target 1 'deno npm cache' "$($P.L)\deno\npm" -Mode prune -Dev $true)
-    (New-Target 1 'deno remote cache' "$($P.L)\deno\remote" -Mode prune -Dev $true)
-    (New-Target 1 'pip cache' "$($P.L)\pip\cache" -Mode prune -Dev $true)
-    (New-Target 1 'uv cache' "$($P.L)\uv\cache" -Mode prune -Dev $true -Note 'uv cache prune runs first when uv is installed')
-    (New-Target 1 'poetry cache' "$($P.L)\pypoetry\Cache" -Mode prune -Dev $true)
-    (New-Target 1 'Composer cache (files)' "$($P.L)\Composer\files" -Mode prune -Dev $true)
-    (New-Target 1 'Composer cache (roaming)' "$($P.A)\Composer\cache" -Mode prune -Dev $true)
-    (New-Target 1 'NuGet http cache' "$($P.L)\NuGet\v3-cache" -Mode clear)
-    (New-Target 1 'NuGet plugins cache' "$($P.L)\NuGet\plugins-cache" -Mode clear)
-    (New-Target 1 'NuGet scratch' "$($P.L)\Temp\NuGetScratch" -Mode clear)
-    (New-Target 1 'NuGet global packages' "$($P.U)\.nuget\packages" -Mode prune -Dev $true -Note 'restored on the next dotnet restore')
-    (New-Target 1 'Cargo registry cache' "$($P.U)\.cargo\registry\cache" -Mode prune -Dev $true -Note 'installed cargo binaries (~\.cargo\bin) stay')
-    (New-Target 1 'Cargo registry sources' "$($P.U)\.cargo\registry\src" -Mode prune -Dev $true)
-    (New-Target 1 'Cargo git checkouts' "$($P.U)\.cargo\git\checkouts" -Mode prune -Dev $true)
-    (New-Target 1 'Go build cache' "$($P.L)\go-build" -Mode prune -Dev $true)
-    (New-Target 1 'Go module download cache' "$($P.U)\go\pkg\mod\cache\download" -Mode prune -Dev $true)
-    (New-Target 1 'Dart/Flutter pub cache' "$($P.L)\Pub\Cache" -Mode prune -Dev $true -Note 'redownloaded by flutter pub get')
-    (New-Target 1 'Dart/Flutter pub cache (legacy)' "$($P.A)\Pub\Cache" -Mode prune -Dev $true)
-    (New-Target 1 'Dart analysis server cache' "$($P.U)\.dartServer" -Mode prune -Dev $true)
-    (New-Target 1 'Electron download cache' "$($P.L)\electron\Cache" -Mode prune -Dev $true)
-    (New-Target 1 'electron-builder cache' "$($P.L)\electron-builder\Cache" -Mode prune -Dev $true)
-    (New-Target 1 'node-gyp headers cache' "$($P.L)\node-gyp\Cache" -Mode prune -Dev $true)
-    (New-Target 1 'Scoop installer cache' "$($P.U)\scoop\cache" -Mode prune -Dev $true)
-    # Hugging Face keeps revisions as snapshots\<rev> linking into blobs, so removing a whole snapshot orphans
-    # blobs: this prunes by the idle gate instead of keeping "the newest per model". AI agent state under
-    # ~\.cache (claude, codex, gemini, copilot) stays protected by lib/safety.ps1.
-    (New-Target 1 'Hugging Face model cache' "$($P.U)\.cache\huggingface\hub" -Mode prune -Dev $true -Note 'models are re-downloaded on next use; the idle gate keeps recent ones')
-  )
-}
-
-function Invoke-Section01 {
-  $ws = $Script:WS
-  Write-SectionIntro @(
-    'Package-manager caches only re-download what a future install needs. Globally installed packages,',
-    'toolchain managers (nvm, Volta, corepack, pnpm global, cargo bin, go bin) are protected and never touched.'
-  ) -Dev $true
-  $targets = Get-Targets01
-  $null = Show-TargetSizes $targets
-  if (-not (Confirm-Section 'Prune package-manager caches now?')) { Write-Info 'skipped'; return }
-  # Tool-native smart prunes first: they know which entries are still referenced.
-  if ((Test-CommandPresent 'pnpm') -and $ws.Developer -ne $false -and -not $ws.PurgeAll) {
-    Write-Info 'pnpm store prune - removes packages no project references'
-    $r = Invoke-External -FilePath 'pnpm' -ArgumentList @('store', 'prune') -Destructive -Quiet -Label 'pnpm store prune'
-    if ($r.Ran -and $r.ExitCode -eq 0) { Write-Ok 'pnpm store pruned' }
-    $targets = @($targets | Where-Object { $_.Label -ne 'pnpm content store' })
-  }
-  if ((Test-CommandPresent 'uv') -and $ws.Developer -ne $false -and -not $ws.PurgeAll) {
-    Write-Info 'uv cache prune - removes unreachable wheels and sources'
-    $r = Invoke-External -FilePath 'uv' -ArgumentList @('cache', 'prune') -Destructive -Quiet -Label 'uv cache prune'
-    if ($r.Ran -and $r.ExitCode -eq 0) { Write-Ok 'uv cache pruned' }
-  }
-  if ((Test-CommandPresent 'npm') -and $ws.PurgeAll) {
-    Write-Info 'npm cache clean --force'
-    $null = Invoke-External -FilePath 'npm' -ArgumentList @('cache', 'clean', '--force') -Destructive -Quiet -Label 'npm cache clean'
-  }
-  $null = Invoke-TargetList $targets
-}
+# pkg_managers.ps1 - section 1: package-manager caches. All regenerable; the idle gate keeps recent work fast.
+
+function Get-Targets01 {
+  $P = $Script:P
+  $npm = Get-NpmCacheDir
+  return @(
+    (New-Target 1 'npm cache (_cacache)' (Join-Path $npm '_cacache') -Mode prune -Dev $true -Note 'regenerated on the next npm install')
+    (New-Target 1 'npx package cache (_npx)' (Join-Path $npm '_npx') -Mode prune -Dev $true)
+    (New-Target 1 'npm logs' (Join-Path $npm '_logs') -Mode clear-old -Days 7)
+    (New-Target 1 'Yarn v1 cache' "$($P.L)\Yarn\Cache" -Mode prune -Dev $true -Note 'yarn classic offline mirror')
+    (New-Target 1 'Yarn Berry global cache' "$($P.L)\Yarn\Berry\cache" -Mode prune -Dev $true)
+    (New-Target 1 'pnpm content store' "$($P.L)\pnpm\store" -Mode prune -Dev $true -Note 'pnpm store prune is used instead when pnpm is installed')
+    (New-Target 1 'pnpm metadata cache' "$($P.L)\pnpm-cache" -Mode prune -Dev $true)
+    (New-Target 1 'bun install cache' "$($P.U)\.bun\install\cache" -Mode prune -Dev $true -Note 'global bun packages stay')
+    (New-Target 1 'deno deps cache' "$($P.L)\deno\deps" -Mode prune -Dev $true -Note 'installed deno scripts (~\.deno\bin) stay')
+    (New-Target 1 'deno gen cache' "$($P.L)\deno\gen" -Mode prune -Dev $true)
+    (New-Target 1 'deno npm cache' "$($P.L)\deno\npm" -Mode prune -Dev $true)
+    (New-Target 1 'deno remote cache' "$($P.L)\deno\remote" -Mode prune -Dev $true)
+    (New-Target 1 'pip cache' "$($P.L)\pip\cache" -Mode prune -Dev $true)
+    (New-Target 1 'uv cache' "$($P.L)\uv\cache" -Mode prune -Dev $true -Note 'uv cache prune runs first when uv is installed')
+    (New-Target 1 'poetry cache' "$($P.L)\pypoetry\Cache" -Mode prune -Dev $true)
+    (New-Target 1 'Composer cache (files)' "$($P.L)\Composer\files" -Mode prune -Dev $true)
+    (New-Target 1 'Composer cache (roaming)' "$($P.A)\Composer\cache" -Mode prune -Dev $true)
+    (New-Target 1 'NuGet http cache' "$($P.L)\NuGet\v3-cache" -Mode clear)
+    (New-Target 1 'NuGet plugins cache' "$($P.L)\NuGet\plugins-cache" -Mode clear)
+    (New-Target 1 'NuGet scratch' "$($P.L)\Temp\NuGetScratch" -Mode clear)
+    (New-Target 1 'NuGet global packages' "$($P.U)\.nuget\packages" -Mode prune -Dev $true -Note 'restored on the next dotnet restore')
+    (New-Target 1 'Cargo registry cache' "$($P.U)\.cargo\registry\cache" -Mode prune -Dev $true -Note 'installed cargo binaries (~\.cargo\bin) stay')
+    (New-Target 1 'Cargo registry sources' "$($P.U)\.cargo\registry\src" -Mode prune -Dev $true)
+    (New-Target 1 'Cargo git checkouts' "$($P.U)\.cargo\git\checkouts" -Mode prune -Dev $true)
+    (New-Target 1 'Go build cache' "$($P.L)\go-build" -Mode prune -Dev $true)
+    (New-Target 1 'Go module download cache' "$($P.U)\go\pkg\mod\cache\download" -Mode prune -Dev $true)
+    (New-Target 1 'Dart/Flutter pub cache' "$($P.L)\Pub\Cache" -Mode prune -Dev $true -Note 'redownloaded by flutter pub get')
+    (New-Target 1 'Dart/Flutter pub cache (legacy)' "$($P.A)\Pub\Cache" -Mode prune -Dev $true)
+    (New-Target 1 'Dart analysis server cache' "$($P.U)\.dartServer" -Mode prune -Dev $true)
+    (New-Target 1 'Electron download cache' "$($P.L)\electron\Cache" -Mode prune -Dev $true)
+    (New-Target 1 'electron-builder cache' "$($P.L)\electron-builder\Cache" -Mode prune -Dev $true)
+    (New-Target 1 'node-gyp headers cache' "$($P.L)\node-gyp\Cache" -Mode prune -Dev $true)
+    (New-Target 1 'Scoop installer cache' "$($P.U)\scoop\cache" -Mode prune -Dev $true)
+    # Hugging Face keeps revisions as snapshots\<rev> linking into blobs, so removing a whole snapshot orphans
+    # blobs: this prunes by the idle gate instead of keeping "the newest per model". AI agent state under
+    # ~\.cache (claude, codex, gemini, copilot) stays protected by lib/safety.ps1.
+    (New-Target 1 'Hugging Face model cache' "$($P.U)\.cache\huggingface\hub" -Mode prune -Dev $true -Note 'models are re-downloaded on next use; the idle gate keeps recent ones')
+  )
+}
+
+function Invoke-Section01 {
+  $ws = $Script:WS
+  Write-SectionIntro @(
+    'Package-manager caches only re-download what a future install needs. Globally installed packages,',
+    'toolchain managers (nvm, Volta, corepack, pnpm global, cargo bin, go bin) are protected and never touched.'
+  ) -Dev $true
+  $targets = Get-Targets01
+  $null = Show-TargetSizes $targets
+  if (-not (Confirm-Section 'Prune package-manager caches now?')) { Write-Info 'skipped'; return }
+  # Tool-native smart prunes first: they know which entries are still referenced.
+  if ((Test-CommandPresent 'pnpm') -and $ws.Developer -ne $false -and -not $ws.PurgeAll) {
+    Write-Info 'pnpm store prune - removes packages no project references'
+    $r = Invoke-External -FilePath 'pnpm' -ArgumentList @('store', 'prune') -Destructive -Quiet -Label 'pnpm store prune'
+    if ($r.Ran -and $r.ExitCode -eq 0) { Write-Ok 'pnpm store pruned' }
+    $targets = @($targets | Where-Object { $_.Label -ne 'pnpm content store' })
+  }
+  if ((Test-CommandPresent 'uv') -and $ws.Developer -ne $false -and -not $ws.PurgeAll) {
+    Write-Info 'uv cache prune - removes unreachable wheels and sources'
+    $r = Invoke-External -FilePath 'uv' -ArgumentList @('cache', 'prune') -Destructive -Quiet -Label 'uv cache prune'
+    if ($r.Ran -and $r.ExitCode -eq 0) { Write-Ok 'uv cache pruned' }
+  }
+  if ((Test-CommandPresent 'npm') -and $ws.PurgeAll) {
+    Write-Info 'npm cache clean --force'
+    $null = Invoke-External -FilePath 'npm' -ArgumentList @('cache', 'clean', '--force') -Destructive -Quiet -Label 'npm cache clean'
+  }
+  $null = Invoke-TargetList $targets
+}