diskdiet 0.0.0-stage → 0.6.2

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# diskdiet
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+See where your developer disk space went, and get it back safely.
+
+```sh
+npx diskdiet            # what's using space, and what can go (changes nothing)
+npx diskdiet clean      # free what's older than 30 days, after showing the list
+```
+
+diskdiet measures the caches developer tools leave behind (npm, Yarn, pnpm, Bun, pip,
+uv, Cargo, Go, Gradle, Maven, Playwright, Cypress, Xcode, Docker) and the
+`node_modules` and `target` folders of projects you haven't touched, then removes only
+what you haven't used lately.
+
+This package downloads the diskdiet binary for your OS and CPU from the
+[GitHub release](https://github.com/roystondwork-dev/diskdiet/releases) on first use,
+checks it against the checksums published with the package, and caches it.
+
+For AI assistants: `claude mcp add diskdiet -- npx -y diskdiet mcp`.
+
+Full documentation, the desktop app and other ways to install:
+<https://github.com/roystondwork-dev/diskdiet>
+
+MIT © 2026 Royston D and diskdiet contributors

package/bin/diskdiet.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// Runs diskdiet with the given arguments: `npx diskdiet 3000`.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const { ensureBinary } = require("../lib/install.js");
+const { version } = require("../package.json");
+const checksums = require("../checksums.json");
+
+ensureBinary({ version, checksums }).then(
+  (bin) => {
+    const r = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+    if (r.error) {
+      console.error(`diskdiet: couldn't run diskdiet: ${r.error.message}`);
+      process.exit(3);
+    }
+    if (r.signal) {
+      process.kill(process.pid, r.signal); // e.g. Ctrl-C: exit the way diskdiet did
+    }
+    process.exit(r.status ?? 1);
+  },
+  (err) => {
+    console.error(`diskdiet: ${err.message}`);
+    process.exit(3);
+  },
+);

package/checksums.json

@@ -0,0 +1,8 @@
+{
+  "diskdiet_0.6.2_darwin_amd64.tar.gz": "867d507756bff28361393f982cb73576e996df047a82f2cb16960bc8887d32f9",
+  "diskdiet_0.6.2_darwin_arm64.tar.gz": "6a695ae8817b3ba92fd452a54daa4d2697893fd170a6d45e8f33c35ccf5b6a72",
+  "diskdiet_0.6.2_linux_amd64.tar.gz": "7f39ff28aaf11f528f90d83f2849cf1c13c440435a456470736c5707f2707abe",
+  "diskdiet_0.6.2_linux_arm64.tar.gz": "bf7da5811f0b44183d241c6a28b929ea4bf077b038339dc5c193c26c93c07a70",
+  "diskdiet_0.6.2_windows_amd64.zip": "04836688cc671321968ab3ee95a8679fdc799853fcbefd4e1c989487408ccda4",
+  "diskdiet_0.6.2_windows_arm64.zip": "7da5e92324b150022a5ad53939b79df7c81ae1d0784f8a01459017e6408372c9"
+}

package/lib/install.js

@@ -0,0 +1,113 @@
+// Finds diskdiet for this OS and CPU, downloading it from the GitHub release
+// on first use. The archive is checked against the checksums published with
+// this package (checksums.json, from the release's signed checksums.txt)
+// before anything is extracted, then cached per version.
+"use strict";
+
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { execFileSync } = require("node:child_process");
+
+const REPO = "roystondwork-dev/diskdiet";
+
+/** The release archive for a platform, e.g. diskdiet_0.9.0_darwin_arm64.tar.gz. */
+function archiveName(version, platform, arch) {
+  const goos = { darwin: "darwin", linux: "linux", win32: "windows" }[platform];
+  const goarch = { x64: "amd64", arm64: "arm64" }[arch];
+  if (!goos || !goarch) {
+    throw new Error(`diskdiet isn't available for ${platform}/${arch} (macOS, Linux and Windows on x64 or arm64 are)`);
+  }
+  return `diskdiet_${version}_${goos}_${goarch}.${goos === "windows" ? "zip" : "tar.gz"}`;
+}
+
+/** Where downloaded binaries are kept: DISKDIET_NPM_CACHE, else the OS's cache directory. */
+function cacheDir(env = process.env, platform = process.platform, home = os.homedir()) {
+  if (env.DISKDIET_NPM_CACHE) {
+    return env.DISKDIET_NPM_CACHE;
+  }
+  if (platform === "win32") {
+    return path.join(env.LOCALAPPDATA || path.join(home, "AppData", "Local"), "diskdiet-npm");
+  }
+  if (platform === "darwin") {
+    return path.join(home, "Library", "Caches", "diskdiet-npm");
+  }
+  return path.join(env.XDG_CACHE_HOME || path.join(home, ".cache"), "diskdiet-npm");
+}
+
+function sha256(file) {
+  return crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex");
+}
+
+/**
+ * Extracts one file from a release archive. On Windows, the system's bsdtar
+ * (Windows 10+) reads the .zip; the tar on PATH may be Git Bash's GNU tar,
+ * which can't, so it isn't used. PowerShell is the fallback.
+ */
+function extract(archive, dir, file, platform = process.platform, env = process.env, run = execFileSync) {
+  if (platform !== "win32") {
+    run("tar", ["-xf", archive, "-C", dir, file], { stdio: "ignore" });
+    return;
+  }
+  const tar = path.join(env.SystemRoot || "C:\\Windows", "System32", "tar.exe");
+  if (fs.existsSync(tar)) {
+    run(tar, ["-xf", archive, "-C", dir, file], { stdio: "ignore" });
+    return;
+  }
+  const q = (s) => "'" + s.replace(/'/g, "''") + "'";
+  run("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", `Expand-Archive -LiteralPath ${q(archive)} -DestinationPath ${q(dir)} -Force`], {
+    stdio: "ignore",
+  });
+}
+
+/**
+ * Returns the path of the diskdiet binary, downloading it if needed.
+ * fetchFn and log are injectable for tests.
+ */
+async function ensureBinary({
+  version,
+  checksums,
+  platform = process.platform,
+  arch = process.arch,
+  dir = cacheDir(),
+  fetchFn = fetch,
+  baseUrl = `https://github.com/${REPO}/releases/download/v${version}`,
+  log = (m) => process.stderr.write(m + "\n"),
+}) {
+  const exe = platform === "win32" ? "diskdiet.exe" : "diskdiet";
+  const target = path.join(dir, version, exe);
+  if (fs.existsSync(target)) {
+    return target;
+  }
+  const name = archiveName(version, platform, arch);
+  const want = checksums[name];
+  if (!want) {
+    throw new Error(`no checksum for ${name}; reinstall diskdiet`);
+  }
+  log(`diskdiet: downloading diskdiet ${version} (${name})...`);
+  const res = await fetchFn(`${baseUrl}/${name}`);
+  if (!res.ok) {
+    throw new Error(`download failed: HTTP ${res.status} for ${baseUrl}/${name}`);
+  }
+  fs.mkdirSync(dir, { recursive: true });
+  const work = fs.mkdtempSync(path.join(dir, ".tmp-"));
+  try {
+    const archive = path.join(work, name);
+    fs.writeFileSync(archive, Buffer.from(await res.arrayBuffer()));
+    const got = sha256(archive);
+    if (got !== want) {
+      throw new Error(`checksum mismatch for ${name} (expected ${want}, got ${got}); not using it`);
+    }
+    extract(archive, work, exe, platform);
+    fs.chmodSync(path.join(work, exe), 0o755);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    // Atomic, so a concurrent run never sees a half-written binary.
+    fs.renameSync(path.join(work, exe), target);
+  } finally {
+    fs.rmSync(work, { recursive: true, force: true });
+  }
+  return target;
+}
+
+module.exports = { archiveName, cacheDir, ensureBinary, extract, sha256 };

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "diskdiet",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.6.2",
+  "description": "See where your developer disk space went and get it back safely: npm, Yarn, pnpm, Bun, pip, uv, Cargo, Go, Gradle, Maven, Playwright, Cypress, Xcode and Docker caches, plus forgotten node_modules and target folders.",
+  "mcpName": "io.github.roystondwork-dev/diskdiet",
+  "keywords": [
+    "disk-space",
+    "cache",
+    "clean",
+    "npm-cache",
+    "node-modules",
+    "npkill",
+    "pnpm",
+    "yarn",
+    "docker",
+    "cargo",
+    "gradle",
+    "free-space",
+    "cleanup",
+    "cli",
+    "mcp"
+  ],
+  "homepage": "https://github.com/roystondwork-dev/diskdiet",
+  "bugs": "https://github.com/roystondwork-dev/diskdiet/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/roystondwork-dev/diskdiet.git",
+    "directory": "packaging/npm"
+  },
+  "license": "MIT",
+  "author": "Royston D",
+  "bin": {
+    "diskdiet": "bin/diskdiet.js"
+  },
+  "main": "lib/install.js",
+  "files": [
+    "bin",
+    "lib",
+    "checksums.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  }
+}