disk-space-saviour 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.19.0
+
+### Minor Changes
+
+- fcaba94: Clean application downloads that are fetched again on demand: Chrome bundle
+  clones left by exited browsers, superseded Chrome on-device models, Google
+  Updater installers, Chrome extension archives, ChatGPT Atlas and Codex app
+  caches, Electron and electron-builder archives, the Bun transpiler cache,
+  Docker Desktop and Warp staged updates, Zed language servers, tree-sitter
+  toolchains, Codex plugin staging, the Clang module cache, VS Code webview
+  cache storage and processed Crashpad reports.
+
 ## 0.18.0
 
 ### Minor Changes

package/README.md

@@ -109,7 +109,13 @@ Opera GX, Vivaldi, Arc, Yandex Browser, Naver Whale, 360, QQ Browser, Firefox,
 LibreWolf, Waterfox, Zen and Floorp, IDE caches (JetBrains, VS Code, Cursor,
 Windsurf, Qoder), AI agent caches and logs, the Discord cache, macOS app
 updates staged by Sparkle and Squirrel, package manager archives, trash, crash
-reports, core dumps and journald logs. Telegram pure caches, Safari/WebKit,
+reports, core dumps and journald logs. Application downloads are covered too:
+Chrome bundle clones left by exited browsers, superseded Chrome on-device
+models, Google Updater installers, ChatGPT Atlas and Codex app caches,
+Electron and electron-builder archives, the Bun transpiler cache, Docker
+Desktop and Warp staged updates (kept while the app runs), Zed language
+servers, tree-sitter toolchains, Codex plugin staging, the Clang module cache
+and processed Crashpad reports. Telegram pure caches, Safari/WebKit,
 Chromium code/GPU/Dawn/service-worker caches and marker-validated Electron
 caches are included. Telegram databases, browser profiles and Playwright MCP
 profiles are preserved. macOS access failures explain when Full Disk Access

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "disk-space-saviour",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Safely reclaims disk space: caches and build outputs of 20+ ecosystems, forgotten projects, and Docker (running, stopped and nested containers), with an emergency mode",
   "type": "module",
   "main": "src/index.js",

package/src/rules/apps.js

@@ -167,9 +167,13 @@ export function expandChromiumCaches(rules) {
             CACHE_LEAVES.map((leaf) => `${p}/${leaf}`)
           ),
           ...roots.flatMap((p) =>
-            ['GrShaderCache', 'ShaderCache', 'component_crx_cache'].map(
-              (leaf) => `${p}/${leaf}`
-            )
+            [
+              'GrShaderCache',
+              'ShaderCache',
+              'GraphiteDawnCache',
+              'component_crx_cache',
+              'extensions_crx_cache',
+            ].map((leaf) => `${p}/${leaf}`)
           ),
         ]),
       ],

package/src/rules/downloads.js

@@ -0,0 +1,175 @@
+import { CACHE_LEAVES } from './apps.js';
+
+/**
+ * Files an application downloads or stages for itself and fetches again on
+ * demand: staged updates, language servers, toolchain archives, app bundle
+ * clones and caches outside the usual cache folders. Installed applications
+ * and the data they read are never matched.
+ */
+const openaiProfiles = [
+  '~/Library/Caches/com.openai.atlas/browser-data/host/*',
+  '~/Library/Caches/Codex/*',
+];
+const zedRoots = ['~/Library/Application Support/Zed', '~/.local/share/zed'];
+
+export const DOWNLOAD_RULES = [
+  {
+    id: 'chromium-code-sign-clones',
+    ecosystem: 'browsers',
+    scope: 'tmp',
+    description:
+      'Chromium app bundle clones left by exited browsers (an update makes them full copies)',
+    // Chrome clones its bundle into the per-user `X` directory next to
+    // `$TMPDIR` at launch and removes the clone when it exits. A running
+    // browser maps the executables of its clone, so the open-file check
+    // keeps every clone in use: a browser name would block orphans forever.
+    paths: ['{TMP}/../X/*.code_sign_clone/code_sign_clone.*'],
+    directoryOnly: true,
+    minAge: 'stale',
+    busy: [],
+  },
+  {
+    id: 'chrome-on-device-models',
+    ecosystem: 'browsers',
+    description: 'superseded Chrome on-device AI model versions',
+    paths: [
+      '~/Library/Application Support/Google/Chrome/OptGuideOnDeviceModel/*',
+      '~/.config/google-chrome/OptGuideOnDeviceModel/*',
+      '{LOCALAPPDATA}/Google/Chrome/User Data/OptGuideOnDeviceModel/*',
+    ],
+    versionPattern: /^(?<version>\d+(?:\.\d+){1,3})$/,
+    minAge: 'stale',
+    busy: [],
+  },
+  {
+    id: 'google-updater-downloads',
+    ecosystem: 'system',
+    description: 'Google Updater downloaded installers',
+    paths: [
+      '~/Library/Application Support/Google/GoogleUpdater/crx_cache',
+      '{LOCALAPPDATA}/Google/GoogleUpdater/crx_cache',
+    ],
+    minAge: 'stale',
+    busy: ['GoogleUpdater'],
+  },
+  {
+    id: 'openai-app-caches',
+    ecosystem: 'apps',
+    description: 'ChatGPT Atlas and Codex app browser caches',
+    paths: openaiProfiles.flatMap((profile) =>
+      CACHE_LEAVES.map((leaf) => `${profile}/${leaf}`)
+    ),
+    busy: ['ChatGPT Atlas', 'Codex'],
+  },
+  {
+    id: 'electron-downloads',
+    ecosystem: 'javascript',
+    description: 'Electron and electron-builder downloaded archives',
+    paths: [
+      '~/Library/Caches/electron',
+      '~/Library/Caches/electron-builder',
+      '~/.cache/electron',
+      '~/.cache/electron-builder',
+      '{LOCALAPPDATA}/electron/Cache',
+      '{LOCALAPPDATA}/electron-builder/Cache',
+    ],
+    minAge: 'stale',
+    busy: ['electron-builder', 'electron-forge'],
+  },
+  {
+    id: 'bun-transpiler-cache',
+    ecosystem: 'javascript',
+    description: 'Bun runtime transpiler cache',
+    // Bun validates every entry against its source and transpiles again on
+    // a miss, so only open files hold the cache back.
+    paths: ['~/Library/Caches/bun/@t@', '~/.cache/bun/@t@'],
+    busy: [],
+  },
+  {
+    id: 'docker-desktop-update-downloads',
+    ecosystem: 'apps',
+    description: 'Docker Desktop updates downloaded but not installed',
+    paths: ['~/Library/Application Support/com.docker.install/in_progress'],
+    minAge: 'stale',
+    busy: ['Docker Desktop', 'com.docker.backend', 'Docker'],
+  },
+  {
+    id: 'docker-desktop-update-images',
+    ecosystem: 'apps',
+    scope: 'tmp',
+    description: 'Docker Desktop update disk images',
+    paths: ['{TMP}/DockerDesktopUpdates/*'],
+    minAge: 'stale',
+    busy: ['Docker Desktop', 'com.docker.backend', 'Docker'],
+  },
+  {
+    id: 'warp-staged-updates',
+    ecosystem: 'apps',
+    description: 'Warp updates staged for the next restart',
+    paths: ['~/Library/Application Support/dev.warp.Warp-*/autoupdate/*'],
+    minAge: 'stale',
+    // Warp applies the staged bundle when it quits, so it stays while Warp
+    // runs. The process names are those of the Stable and Preview builds.
+    busy: ['stable', 'preview', 'Warp'],
+  },
+  {
+    id: 'zed-downloads',
+    ecosystem: 'ide',
+    description: 'Zed downloaded Node.js, language servers and Copilot',
+    paths: zedRoots.flatMap((root) =>
+      ['node', 'languages', 'copilot'].map((leaf) => `${root}/${leaf}`)
+    ),
+    busy: ['zed', 'Zed', 'zed-editor'],
+  },
+  {
+    id: 'tree-sitter-downloads',
+    ecosystem: 'c-cpp',
+    description: 'tree-sitter CLI downloaded WASI SDK, Binaryen and parsers',
+    paths: ['~/.cache/tree-sitter', '~/Library/Caches/tree-sitter'],
+    busy: ['tree-sitter'],
+  },
+  {
+    id: 'codex-plugin-staging',
+    ecosystem: 'agents',
+    description: 'abandoned Codex plugin and marketplace install staging',
+    paths: [
+      '~/.codex/plugins/..plugin-appserver.staging-*',
+      '~/.codex/plugins/.marketplace-plugin-source-staging/*',
+      '~/.codex/plugins/.remote-plugin-install-staging/*',
+      '~/.codex/.tmp/marketplaces/.staging/*',
+    ],
+    // The Codex daemon runs for days; an install in progress writes to its
+    // staging directory, which the activity window and open files catch.
+    minAge: 'stale',
+  },
+  {
+    id: 'clang-module-cache',
+    ecosystem: 'c-cpp',
+    description: 'Clang and Swift implicit module cache',
+    scope: 'tmp',
+    paths: [
+      '{TMP}/../C/clang/ModuleCache',
+      '{TMP}/../C/org.llvm.clang*/ModuleCache',
+    ],
+    // A build in another directory still reads the cache, which the
+    // activity window and open files catch.
+    minAge: 'stale',
+    busy: ['clang', 'clang++', 'swift-frontend', 'swiftc', 'xcodebuild'],
+  },
+  {
+    id: 'crashpad-reports',
+    ecosystem: 'system',
+    description: 'Chromium and Electron app crash reports already processed',
+    tier: 'moderate',
+    aggregate: true,
+    paths: [
+      '~/Library/Application Support/*/Crashpad/completed/*',
+      ...['Google', 'Yandex', 'BraveSoftware'].map(
+        (vendor) =>
+          `~/Library/Application Support/${vendor}/*/Crashpad/completed/*`
+      ),
+      '~/.config/*/Crashpad/completed/*',
+    ],
+    minAge: 'stale',
+  },
+];

package/src/rules/other.js

@@ -107,6 +107,9 @@ export const OTHER_RULES = [
       '~/Library/Application Support/Code/Cache',
       '~/Library/Application Support/Code/CachedData',
       '~/Library/Application Support/Code/CachedExtensionVSIXs',
+      '~/Library/Application Support/Code/WebStorage/*/CacheStorage',
+      '~/.config/Code/WebStorage/*/CacheStorage',
+      '{APPDATA}/Code/WebStorage/*/CacheStorage',
       '~/.vscode-server/data/CachedExtensionVSIXs',
       '~/.vscode-server/data/logs',
       '~/.cursor-server/data/CachedExtensionVSIXs',

package/src/scanners/global.js

@@ -2,7 +2,8 @@ import { scanItems } from '../env/scope.js';
 /**
  * Global per-user caches (ecosystem download and compilation caches, IDE and
  * browser caches), system package caches, and leftovers in temporary
- * directories. See ../rules/ecosystems.js and ../rules/other.js.
+ * directories. See ../rules/ecosystems.js, ../rules/other.js and
+ * ../rules/downloads.js.
  */
 
 import { CACHE_RULES } from '../rules/ecosystems.js';
@@ -14,6 +15,7 @@ import { expandGlobPaths, expandRulePath, isWithin } from '../paths.js';
 import { olderThan, scanTimeBusy, resolvePaths } from './common.js';
 import { configuredPattern } from '../env/cache-roots.js';
 import { TOOLCHAIN_CACHE_RULES } from '../rules/toolchains.js';
+import { DOWNLOAD_RULES } from '../rules/downloads.js';
 import { timed } from '../timings.js';
 
 export const GLOBAL_RULES = [
@@ -21,6 +23,7 @@ export const GLOBAL_RULES = [
   ...expandChromiumCaches(OTHER_RULES),
   ...APP_RULES,
   ...TOOLCHAIN_CACHE_RULES,
+  ...DOWNLOAD_RULES,
 ];
 
 function scopeBases(rule, homes, tmpDirs) {