wuphf 0.216.1 → 0.217.0

package/bin/wuphf.js

@@ -27,7 +27,7 @@ const path = require("node:path");
 const os = require("node:os");
 const { spawn } = require("node:child_process");
 const { downloadBinary, packageVersion } = require("../scripts/download-binary");
-const { getLatestVersion, compareVersions } = require("../scripts/version-check");
+const { getLatestVersion, compareVersions, ensureCacheDir } = require("../scripts/version-check");
 
 const binaryName = process.platform === "win32" ? "wuphf.exe" : "wuphf";
 const installedBinary = path.join(__dirname, binaryName);
@@ -35,8 +35,9 @@ const installedBinary = path.join(__dirname, binaryName);
 function cachedBinaryPath(version) {
   // Windows requires the .exe suffix or CreateProcess refuses to launch.
   const suffix = process.platform === "win32" ? ".exe" : "";
+  const runtimeHome = process.env.WUPHF_RUNTIME_HOME?.trim() || os.homedir();
   return path.join(
-    os.homedir(),
+    runtimeHome,
     ".wuphf",
     "cache",
     "binaries",
@@ -70,6 +71,7 @@ async function ensureBinary() {
   const cachedPath = cachedBinaryPath(latestVersion);
   if (!fs.existsSync(cachedPath)) {
     try {
+      await ensureCacheDir();
       await downloadBinary({
         version: latestVersion,
         targetPath: cachedPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wuphf",
-  "version": "0.216.1",
+  "version": "0.217.0",
   "description": "Slack for AI employees with a shared brain. A collaborative office where AI employees run your work 24x7.",
   "bin": {
     "wuphf": "bin/wuphf.js"

package/scripts/version-check.js

@@ -24,6 +24,7 @@ const fs = require("node:fs");
 const fsp = require("node:fs/promises");
 const path = require("node:path");
 const os = require("node:os");
+const { execFile } = require("node:child_process");
 
 const REGISTRY_URL = "https://registry.npmjs.org/wuphf/latest";
 // Generous enough to survive a cold TLS handshake on a slow network but
@@ -31,17 +32,57 @@ const REGISTRY_URL = "https://registry.npmjs.org/wuphf/latest";
 // per user because the result is cached on disk.
 const FETCH_TIMEOUT_MS = 3000;
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const backupExcludedCacheDirs = new Set();
+let backupExclusionRunner = (target) =>
+  new Promise((resolve, reject) => {
+    execFile(
+      "/usr/bin/tmutil",
+      ["addexclusion", target],
+      { timeout: 2000 },
+      (err) => {
+        if (err) reject(err);
+        else resolve();
+      },
+    );
+  });
 
 function cacheDir() {
-  // Sits under ~/.wuphf so HOME-override dev environments (see
-  // docs/LOCAL-DEV-PROD-ISOLATION.md) get a separate cache from prod.
-  return path.join(os.homedir(), ".wuphf", "cache");
+  // Sits under the active WUPHF runtime home so workspace/dev overrides get
+  // separate caches from prod.
+  const runtimeHome = process.env.WUPHF_RUNTIME_HOME?.trim() || os.homedir();
+  return path.join(runtimeHome, ".wuphf", "cache");
 }
 
 function latestVersionCachePath() {
   return path.join(cacheDir(), "latest-version.json");
 }
 
+async function markCacheDirExcludedFromBackup(dir = cacheDir()) {
+  if (process.platform !== "darwin") return;
+  const candidates = new Set([dir]);
+  try {
+    candidates.add(await fsp.realpath(dir));
+  } catch {
+    // The cache write path is best-effort; backup metadata is too.
+  }
+  for (const candidate of candidates) {
+    if (backupExcludedCacheDirs.has(candidate)) continue;
+    backupExcludedCacheDirs.add(candidate);
+    try {
+      await backupExclusionRunner(candidate);
+    } catch {
+      backupExcludedCacheDirs.delete(candidate);
+    }
+  }
+}
+
+async function ensureCacheDir() {
+  const dir = cacheDir();
+  await fsp.mkdir(dir, { recursive: true, mode: 0o700 });
+  await markCacheDirExcludedFromBackup(dir);
+  return dir;
+}
+
 async function readCache() {
   try {
     const raw = await fsp.readFile(latestVersionCachePath(), "utf8");
@@ -59,7 +100,7 @@ async function readCache() {
 
 async function writeCache(version) {
   try {
-    await fsp.mkdir(cacheDir(), { recursive: true });
+    await ensureCacheDir();
     const target = latestVersionCachePath();
     const tmp = `${target}.tmp`;
     await fsp.writeFile(tmp, JSON.stringify({ version, checkedAt: Date.now() }));
@@ -119,9 +160,15 @@ module.exports = {
   getLatestVersion,
   compareVersions,
   cacheDir,
+  ensureCacheDir,
   latestVersionCachePath,
   // Exported for tests.
+  markCacheDirExcludedFromBackup,
   fetchLatestFromRegistry,
   readCache,
   writeCache,
+  setBackupExclusionRunnerForTest(runner) {
+    backupExcludedCacheDirs.clear();
+    backupExclusionRunner = runner;
+  },
 };