windowsweep 1.0.1 → 1.2.0

package/modules/pkg_managers.ps1

@@ -1,69 +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)
-  )
-}
-
-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
+}

package/modules/projects.ps1

@@ -1,143 +1,160 @@
-# projects.ps1 - section 17: stale build artefacts in projects nobody has touched for N+ days. Interactive only.
-
-$Script:WS_ARTEFACT_DIRS = @('node_modules', 'dist', 'build', 'out', '.next', '.nuxt', '.turbo', '.vite', '.svelte-kit', '.astro', '.parcel-cache', 'target', 'vendor', 'coverage', '.nyc_output', '__pycache__', '.pytest_cache', '.dart_tool', '.angular')
-$Script:WS_PROJECT_MARKERS = @('package.json', 'pubspec.yaml', 'composer.json', 'Cargo.toml', 'go.mod', 'build.gradle', 'build.gradle.kts', 'pom.xml', 'pyproject.toml', 'requirements.txt', 'angular.json', 'next.config.js', 'next.config.mjs', 'nuxt.config.ts', 'vite.config.ts', 'vite.config.js')
-$Script:WS_NEVER_ENTER = @('.git', 'AppData', 'node_modules', '$RECYCLE.BIN', 'System Volume Information', '.gradle', '.m2', '.nuget', '.cargo', '.vscode', '.idea')
-
-function Get-ProjectScanRoots {
-  $ws = $Script:WS
-  $U = $Script:P.U
-  $roots = @()
-  if ($ws.ScanRoots.Count -gt 0) {
-    foreach ($r in $ws.ScanRoots) {
-      $f = Get-FullPath $r
-      if (-not $f -or -not (Test-DirPresent $f)) { Write-Warn "scan root not found: $r"; continue }
-      if ($f -match '^[A-Za-z]:\\?$' -or $f.Equals($U, [StringComparison]::OrdinalIgnoreCase)) { Write-Warn "refusing to scan a whole drive or your profile root: $f (name a projects folder)"; continue }
-      $roots += $f
-    }
-    return $roots
-  }
-  $names = @('source\repos', 'source', 'repos', 'Projects', 'projects', 'code', 'Code', 'dev', 'Dev', 'Development', 'work', 'Work', 'git', 'GitHub', 'Documents\GitHub', 'Documents\Projects', 'Documents\code', 'Documents\dev', 'Documents\repos')
-  foreach ($n in $names) { $p = Join-Path $U $n; if (Test-DirPresent $p) { $roots += (Get-FullPath $p) } }
-  foreach ($d in [IO.DriveInfo]::GetDrives()) {
-    if (-not $d.IsReady -or $d.DriveType -ne [IO.DriveType]::Fixed) { continue }
-    foreach ($n in @('work', 'code', 'projects', 'repos', 'dev', 'src', 'git', 'Projects', 'Code', 'Work')) {
-      $p = Join-Path $d.Name $n
-      if ((Test-DirPresent $p) -and ($roots -notcontains (Get-FullPath $p))) { $roots += (Get-FullPath $p) }
-    }
-  }
-  return @($roots | Select-Object -Unique)
-}
-
-function Get-Targets17 {
-  $roots = @(Get-ProjectScanRoots)
-  $t = @()
-  foreach ($r in $roots) { $t += (New-Target 17 'Project scan root' $r -Kind cmd -Note ($Script:WS_ARTEFACT_DIRS -join ', ')) }
-  if ($t.Count -eq 0) { $t += (New-Target 17 'Project scan root' '(none detected - pass --scan-roots "D:\work;E:\code")' -Kind cmd) }
-  return $t
-}
-
-function Test-ProjectMarker {
-  param([string] $Dir, [string] $ArtefactName)
-  $entries = Get-ChildEntries $Dir
-  $names = @($entries | ForEach-Object { $_.Name })
-  if ($ArtefactName -in 'bin', 'obj') { return [bool]($names | Where-Object { $_ -like '*.csproj' -or $_ -like '*.sln' -or $_ -like '*.fsproj' }) }
-  foreach ($m in $Script:WS_PROJECT_MARKERS) { if ($names -contains $m) { return $true } }
-  return ($names -contains '.git')
-}
-
-function Get-ProjectActivityDays {
-  <# .SYNOPSIS Days since any SOURCE file in the project changed (artefact dirs and .git excluded). #>
-  param([string] $ProjectDir)
-  $newest = [datetime]::MinValue
-  $stack = New-Object System.Collections.Generic.Stack[string]
-  $stack.Push($ProjectDir)
-  $seen = 0
-  while ($stack.Count -gt 0 -and $seen -lt 200000) {
-    $dir = $stack.Pop()
-    foreach ($e in (Get-ChildEntries $dir)) {
-      $seen++
-      if (Test-ReparsePoint $e) { continue }
-      if ($e -is [IO.DirectoryInfo]) {
-        if ($Script:WS_ARTEFACT_DIRS -contains $e.Name -or $Script:WS_NEVER_ENTER -contains $e.Name) { continue }
-        $stack.Push((Remove-LongPrefix $e.FullName)); continue
-      }
-      $t = Get-NewestTimestampUtc $e
-      if ($t -gt $newest) { $newest = $t }
-    }
-  }
-  if ($newest -eq [datetime]::MinValue) { return (Get-IdleDays $ProjectDir) }
-  return [int][math]::Floor(([datetime]::UtcNow - $newest).TotalDays)
-}
-
-function Find-StaleArtefacts {
-  <# .SYNOPSIS Artefact folders (node_modules, dist, ...) whose project has been idle for N+ days. #>
-  param([string[]] $Roots, [int] $Days, [int] $MaxDepth = 6)
-  $ws = $Script:WS
-  $found = New-Object System.Collections.Generic.List[object]
-  $projectAge = @{}
-  foreach ($root in $Roots) {
-    $stack = New-Object System.Collections.Generic.Stack[object]
-    $stack.Push(@($root, 0))
-    while ($stack.Count -gt 0) {
-      $item = $stack.Pop()
-      $dir = [string]$item[0]; $depth = [int]$item[1]
-      foreach ($e in (Get-ChildEntries $dir)) {
-        if (-not ($e -is [IO.DirectoryInfo]) -or (Test-ReparsePoint $e)) { continue }
-        $full = Remove-LongPrefix $e.FullName
-        $skip = $false
-        foreach ($x in $ws.ExcludePaths) { if ($x -and (Test-PathWithin -Path $full -Within $x)) { $skip = $true; break } }
-        if ($skip) { continue }
-        if ($Script:WS_ARTEFACT_DIRS -contains $e.Name -or ($e.Name -in 'bin', 'obj')) {
-          if (-not (Test-ProjectMarker -Dir $dir -ArtefactName $e.Name)) { continue }
-          if (-not $projectAge.ContainsKey($dir)) { $projectAge[$dir] = Get-ProjectActivityDays $dir }
-          $age = $projectAge[$dir]
-          if ($age -ge $Days) { $found.Add([pscustomobject]@{ Path = $full; Project = $dir; Age = $age; Bytes = [long](Get-DirectoryBytes $full); Root = $root }) }
-          continue
-        }
-        if ($Script:WS_NEVER_ENTER -contains $e.Name -or $e.Name.StartsWith('.')) { continue }
-        if ($depth -lt $MaxDepth) { $stack.Push(@($full, $depth + 1)) }
-      }
-    }
-  }
-  return @($found | Sort-Object Bytes -Descending)
-}
-
-function Invoke-Section17 {
-  $ws = $Script:WS
-  Write-SectionIntro @(
-    'node_modules, dist, .next, target, vendor and friends are rebuilt by the next install or build. Only projects',
-    "whose SOURCE files nobody touched for $($ws.Days)+ days are listed, and nothing goes without your selection.",
-    'Toolchain folders (.gradle, .nuget, .cargo, AppData) and .git are never entered.'
-  )
-  $roots = @(Get-ProjectScanRoots)
-  if ($roots.Count -eq 0) { Write-Warn 'no project roots found. Pass --scan-roots "D:\work;E:\code" (semicolon-separated) or save scanRoots in config.json.'; return }
-  Write-Info ("scanning: " + ($roots -join '  '))
-  $found = @(Find-StaleArtefacts -Roots $roots -Days $ws.Days)
-  if ($found.Count -eq 0) { Write-Info "no build artefacts in projects idle $($ws.Days)+ days"; return }
-  $reportLines = @("stale build artefacts - projects idle $($ws.Days)+ days - $(Get-Date -Format 'yyyy-MM-dd HH:mm')", '')
-  Write-UiLine ("  {0,3}  {1,10} {2,6}  {3}" -f '#', 'SIZE', 'IDLE', 'ARTEFACT') 'White'
-  $i = 1; $total = [long]0
-  foreach ($f in $found) {
-    Write-UiLine ("  {0,3}  {1,10} {2,5}d  {3}" -f $i, (Format-Bytes $f.Bytes), $f.Age, $f.Path) 'Gray'
-    $reportLines += ("{0,10} {1,5}d  {2}" -f (Format-Bytes $f.Bytes), $f.Age, $f.Path)
-    $total += $f.Bytes; $i++
-    if ($i -gt 200) { Write-Warn 'list truncated to 200 entries'; break }
-  }
-  Write-Info ("total: " + (Format-Bytes $total))
-  if (-not $ws.NoReport) {
-    $out = Join-Path $ws.ReportsDir ('stale-builds-' + $ws.Stamp + '.txt')
-    try { [IO.File]::WriteAllLines($out, $reportLines); Write-Note "list saved: $out" } catch { $null = $_ }
-  }
-  $picks = @(Read-MultiSelect -Total ([math]::Min($found.Count, 200)) -NoAutoYes)
-  if ($picks.Count -eq 0) { Write-Info 'nothing selected'; return }
-  if (-not $ws.DryRun) {
-    # Project artefacts never auto-confirm: --yes does not apply, and the walkthrough's step answer is not a selection.
-    if (-not (Confirm-Ui -Prompt "Remove $($picks.Count) artefact folder(s)? (rebuild with the project's install/build command)" -Default 'n' -NoAutoYes)) { Write-Info 'skipped'; return }
-  }
-  foreach ($k in $picks) {
-    $f = $found[$k - 1]
-    $r = Remove-PathSafe -Path $f.Path -Within $f.Root -Label (Split-Path -Leaf $f.Path)
-    if ($r.Removed -and -not $ws.DryRun) { Write-Ok ("removed " + (Format-Bytes $r.Bytes) + "  $($f.Path)") }
-  }
-}
+# projects.ps1 - section 17: stale build artefacts in projects nobody has touched for N+ days. Interactive only.
+
+$Script:WS_ARTEFACT_DIRS = @('node_modules', 'dist', 'build', 'out', '.next', '.nuxt', '.turbo', '.vite', '.svelte-kit', '.astro', '.parcel-cache', 'target', 'vendor', 'coverage', '.nyc_output', '__pycache__', '.pytest_cache', '.dart_tool', '.angular', '.nx', '.mypy_cache', '.ruff_cache', '.tox', '.eggs', '.output', '.serverless')
+# Never here: .venv / venv (nobody expects an environment to vanish) and .terraform (provider binaries + lock state).
+# A name in this table is an artefact ONLY when the same folder carries one of the listed markers: a bare
+# .cache belongs to whoever made it, but beside a Gatsby or Parcel config it is a build cache.
+$Script:WS_ARTEFACT_DIRS_MARKED = @{ '.cache' = @('gatsby-config.js', 'gatsby-config.ts', 'gatsby-config.mjs', '.parcelrc', 'parcel.config.js') }
+$Script:WS_PROJECT_MARKERS = @('package.json', 'pubspec.yaml', 'composer.json', 'Cargo.toml', 'go.mod', 'build.gradle', 'build.gradle.kts', 'pom.xml', 'pyproject.toml', 'requirements.txt', 'angular.json', 'next.config.js', 'next.config.mjs', 'nuxt.config.ts', 'vite.config.ts', 'vite.config.js')
+$Script:WS_NEVER_ENTER = @('.git', 'AppData', 'node_modules', '$RECYCLE.BIN', 'System Volume Information', '.gradle', '.m2', '.nuget', '.cargo', '.vscode', '.idea')
+
+function Get-ProjectScanRoots {
+  $ws = $Script:WS
+  $U = $Script:P.U
+  $roots = @()
+  if ($ws.ScanRoots.Count -gt 0) {
+    foreach ($r in $ws.ScanRoots) {
+      $f = Get-FullPath $r
+      if (-not $f -or -not (Test-DirPresent $f)) { Write-Warn "scan root not found: $r"; continue }
+      if ($f -match '^[A-Za-z]:\\?$' -or $f.Equals($U, [StringComparison]::OrdinalIgnoreCase)) { Write-Warn "refusing to scan a whole drive or your profile root: $f (name a projects folder)"; continue }
+      $roots += $f
+    }
+    return $roots
+  }
+  $names = @('source\repos', 'source', 'repos', 'Projects', 'projects', 'code', 'Code', 'dev', 'Dev', 'Development', 'work', 'Work', 'git', 'GitHub', 'Documents\GitHub', 'Documents\Projects', 'Documents\code', 'Documents\dev', 'Documents\repos')
+  foreach ($n in $names) { $p = Join-Path $U $n; if (Test-DirPresent $p) { $roots += (Get-FullPath $p) } }
+  foreach ($d in [IO.DriveInfo]::GetDrives()) {
+    if (-not $d.IsReady -or $d.DriveType -ne [IO.DriveType]::Fixed) { continue }
+    foreach ($n in @('work', 'code', 'projects', 'repos', 'dev', 'src', 'git', 'Projects', 'Code', 'Work')) {
+      $p = Join-Path $d.Name $n
+      if ((Test-DirPresent $p) -and ($roots -notcontains (Get-FullPath $p))) { $roots += (Get-FullPath $p) }
+    }
+  }
+  return @($roots | Select-Object -Unique)
+}
+
+function Get-Targets17 {
+  $roots = @(Get-ProjectScanRoots)
+  $t = @()
+  foreach ($r in $roots) { $t += (New-Target 17 'Project scan root' $r -Kind cmd -Note ($Script:WS_ARTEFACT_DIRS -join ', ')) }
+  if ($t.Count -eq 0) { $t += (New-Target 17 'Project scan root' '(none detected - pass --scan-roots "D:\work;E:\code")' -Kind cmd) }
+  return $t
+}
+
+function Test-MarkedArtefactDir {
+  <# .SYNOPSIS True when Name is a marker-gated artefact folder AND Dir carries one of its markers. #>
+  param([string] $Dir, [string] $Name)
+  if (-not $Script:WS_ARTEFACT_DIRS_MARKED.ContainsKey($Name)) { return $false }
+  $names = @(Get-ChildEntries $Dir | ForEach-Object { $_.Name })
+  foreach ($m in $Script:WS_ARTEFACT_DIRS_MARKED[$Name]) { if ($names -contains $m) { return $true } }
+  return $false
+}
+
+function Test-ProjectMarker {
+  param([string] $Dir, [string] $ArtefactName)
+  $entries = Get-ChildEntries $Dir
+  $names = @($entries | ForEach-Object { $_.Name })
+  if ($ArtefactName -in 'bin', 'obj') { return [bool]($names | Where-Object { $_ -like '*.csproj' -or $_ -like '*.sln' -or $_ -like '*.fsproj' }) }
+  foreach ($m in $Script:WS_PROJECT_MARKERS) { if ($names -contains $m) { return $true } }
+  return ($names -contains '.git')
+}
+
+function Get-ProjectActivityDays {
+  <# .SYNOPSIS Days since any SOURCE file in the project changed (artefact dirs and .git excluded). #>
+  param([string] $ProjectDir)
+  $newest = [datetime]::MinValue
+  $stack = New-Object System.Collections.Generic.Stack[string]
+  $stack.Push($ProjectDir)
+  $seen = 0
+  while ($stack.Count -gt 0 -and $seen -lt 200000) {
+    $dir = $stack.Pop()
+    foreach ($e in (Get-ChildEntries $dir)) {
+      $seen++
+      if (Test-ReparsePoint $e) { continue }
+      if ($e -is [IO.DirectoryInfo]) {
+        if ($Script:WS_ARTEFACT_DIRS -contains $e.Name -or $Script:WS_NEVER_ENTER -contains $e.Name -or (Test-MarkedArtefactDir -Dir $dir -Name $e.Name)) { continue }
+        $stack.Push((Remove-LongPrefix $e.FullName)); continue
+      }
+      $t = Get-NewestTimestampUtc $e
+      if ($t -gt $newest) { $newest = $t }
+    }
+  }
+  if ($newest -eq [datetime]::MinValue) { return (Get-IdleDays $ProjectDir) }
+  return [int][math]::Floor(([datetime]::UtcNow - $newest).TotalDays)
+}
+
+function Find-StaleArtefacts {
+  <# .SYNOPSIS Artefact folders (node_modules, dist, ...) whose project has been idle for N+ days. #>
+  param([string[]] $Roots, [int] $Days, [int] $MaxDepth = 6)
+  $ws = $Script:WS
+  $found = New-Object System.Collections.Generic.List[object]
+  $projectAge = @{}
+  foreach ($root in $Roots) {
+    $stack = New-Object System.Collections.Generic.Stack[object]
+    $stack.Push(@($root, 0))
+    while ($stack.Count -gt 0) {
+      $item = $stack.Pop()
+      $dir = [string]$item[0]; $depth = [int]$item[1]
+      foreach ($e in (Get-ChildEntries $dir)) {
+        if (-not ($e -is [IO.DirectoryInfo]) -or (Test-ReparsePoint $e)) { continue }
+        $full = Remove-LongPrefix $e.FullName
+        $skip = $false
+        foreach ($x in $ws.ExcludePaths) { if ($x -and (Test-PathWithin -Path $full -Within $x)) { $skip = $true; break } }
+        if ($skip) { continue }
+        if ($Script:WS_ARTEFACT_DIRS -contains $e.Name -or ($e.Name -in 'bin', 'obj') -or (Test-MarkedArtefactDir -Dir $dir -Name $e.Name)) {
+          if (-not (Test-ProjectMarker -Dir $dir -ArtefactName $e.Name)) { continue }
+          if (-not $projectAge.ContainsKey($dir)) { $projectAge[$dir] = Get-ProjectActivityDays $dir }
+          $age = $projectAge[$dir]
+          if ($age -ge $Days) { $found.Add([pscustomobject]@{ Path = $full; Project = $dir; Age = $age; Bytes = [long](Get-DirectoryBytes $full); Root = $root }) }
+          continue
+        }
+        if ($Script:WS_NEVER_ENTER -contains $e.Name -or $e.Name.StartsWith('.')) { continue }
+        if ($depth -lt $MaxDepth) { $stack.Push(@($full, $depth + 1)) }
+      }
+    }
+  }
+  return @($found | Sort-Object Bytes -Descending)
+}
+
+function Invoke-Section17 {
+  $ws = $Script:WS
+  Write-SectionIntro @(
+    'node_modules, dist, .next, target, vendor and friends are rebuilt by the next install or build. Only projects',
+    "whose SOURCE files nobody touched for $($ws.Days)+ days are listed, and nothing goes without your selection.",
+    'Toolchain folders (.gradle, .nuget, .cargo, AppData) and .git are never entered.'
+  )
+  $roots = @(Get-ProjectScanRoots)
+  if ($roots.Count -eq 0) { Write-Warn 'no project roots found. Pass --scan-roots "D:\work;E:\code" (semicolon-separated) or save scanRoots in config.json.'; return }
+  Write-Info ("scanning: " + ($roots -join '  '))
+  $found = @(Find-StaleArtefacts -Roots $roots -Days $ws.Days)
+  if ($found.Count -eq 0) { Write-Info "no build artefacts in projects idle $($ws.Days)+ days"; return }
+  $reportLines = @("stale build artefacts - projects idle $($ws.Days)+ days - $(Get-Date -Format 'yyyy-MM-dd HH:mm')", '')
+  # One offered list drives the table, the JSON candidates and the selection indexes: they cannot disagree.
+  $offered = @($found | Select-Object -First 200)
+  if ($found.Count -gt $offered.Count) { Write-Warn 'list truncated to 200 entries' }
+  Write-UiLine ("  {0,3}  {1,10} {2,6}  {3}" -f '#', 'SIZE', 'IDLE', 'ARTEFACT') 'White'
+  $i = 1; $total = [long]0
+  foreach ($f in $offered) {
+    Write-UiLine ("  {0,3}  {1,10} {2,5}d  {3}" -f $i, (Format-Bytes $f.Bytes), $f.Age, $f.Path) 'Gray'
+    $reportLines += ("{0,10} {1,5}d  {2}" -f (Format-Bytes $f.Bytes), $f.Age, $f.Path)
+    Add-JsonCandidate -Section 17 -Index $i -Path $f.Path -Bytes $f.Bytes -IdleDays $f.Age -Project $f.Project
+    $total += $f.Bytes; $i++
+  }
+  Write-Info ("total: " + (Format-Bytes $total))
+  if (-not $ws.NoReport) {
+    $out = Join-Path $ws.ReportsDir ('stale-builds-' + $ws.Stamp + '.txt')
+    try { [IO.File]::WriteAllLines($out, $reportLines); Write-Note "list saved: $out" } catch { $null = $_ }
+  }
+  $picks = @(Read-MultiSelect -Total $offered.Count -NoAutoYes -Candidates @($offered | ForEach-Object { $_.Path }))
+  if ($picks.Count -eq 0) { Write-Info 'nothing selected'; return }
+  if (-not $ws.DryRun) {
+    # Project artefacts never auto-confirm: --yes does not apply, and the walkthrough's step answer is not a selection.
+    # An explicit --select / --select-file choice does answer it - that is a person choosing, in advance.
+    if (-not (Confirm-Ui -Prompt "Remove $($picks.Count) artefact folder(s)? (rebuild with the project's install/build command)" -Default 'n' -NoAutoYes -ScriptedOk)) { Write-Info 'skipped'; return }
+  }
+  foreach ($k in $picks) {
+    $f = $offered[$k - 1]
+    $r = Remove-PathSafe -Path $f.Path -Within $f.Root -Label (Split-Path -Leaf $f.Path)
+    if ($r.Removed -and -not $ws.DryRun) { Write-Ok ("removed " + (Format-Bytes $r.Bytes) + "  $($f.Path)") }
+  }
+}