dev/dev-cli/scripts/preinstall.js

#!/usr/bin/env node
// Windows-friendly preinstall: proactively free file locks from prior installs
// so npm/yarn/pnpm can stage the new package. No-ops on non-Windows.

import { platform } from "os";
import { execSync } from "child_process";
import { existsSync, readdirSync, rmSync, readFileSync, statSync } from "fs";
import path from "path";
import { fileURLToPath } from "url";

function isWSL() {
  if (platform() !== "linux") return false;
  try {
    const rel = readFileSync("/proc/version", "utf8").toLowerCase();
    return rel.includes("microsoft") || !!process.env.WSL_DISTRO_NAME;
  } catch {
    return false;
  }
}

const isWin = platform() === "win32";
const wsl = isWSL();
const isWinLike = isWin || wsl;

// Scope: only run for global installs, unless explicitly forced. Allow opt-out.
const isGlobal = process.env.npm_config_global === "true";
const force = process.env.DEV_FORCE_PREINSTALL === "1";
const skip = process.env.DEV_SKIP_PREINSTALL === "1";
if (!isWinLike || skip || (!isGlobal && !force)) process.exit(0);

function tryExec(cmd, opts = {}) {
  try {
    execSync(cmd, {
      stdio: ["ignore", "ignore", "ignore"],
      shell: true,
      ...opts,
    });
  } catch {
    /* ignore */
  }
}

// 1) Stop our native binary if it is holding locks. Avoid killing unrelated tools.
// Only available on native Windows; skip entirely on WSL to avoid noise.
if (isWin) {
  tryExec("taskkill /IM dev-x86_64-pc-windows-msvc.exe /F");
}

// 2) Remove stale staging dirs from previous failed installs under the global
//    @hanzo scope, which npm will reuse (e.g., .dev-XXXXX). Remove only
//    old entries and never the current staging or live package.
try {
  let scopeDir = "";
  try {
    const root = execSync("npm root -g", {
      stdio: ["ignore", "pipe", "ignore"],
      shell: true,
    })
      .toString()
      .trim();
    scopeDir = path.join(root, "@hanzo");
  } catch {
    // Fall back to guessing from this script location: <staging>\..\..\
    const here = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
    scopeDir = path.resolve(here, "..");
  }
  if (existsSync(scopeDir)) {
    const now = Date.now();
    const maxAgeMs = 2 * 60 * 60 * 1000; // 2 hours
    const currentDir = path.resolve(
      path.dirname(fileURLToPath(import.meta.url)),
      "..",
    );
    for (const name of readdirSync(scopeDir)) {
      if (!name.startsWith(".dev-")) continue;
      const p = path.join(scopeDir, name);
      if (path.resolve(p) === currentDir) continue; // never remove our current dir
      try {
        const st = statSync(p);
        const age = now - st.mtimeMs;
        if (age > maxAgeMs) rmSync(p, { recursive: true, force: true });
      } catch {
        /* ignore */
      }
    }
  }
} catch {
  /* ignore */
}

process.exit(0);