Function executeForceUpdate

src/forceUpdate.js:739–762

(forceUpdate)

// which resolves to the package containing this file regardless of
// install layout (global npm / local node_modules / dev clone).
function executeForceUpdate(forceUpdate) {
  // Concurrency guard: if a prior invocation is still in flight, refuse and
  // return the BUSY sentinel. The in-flight caller owns the outcome (state
  // file write, process.exit(78) on success); a second concurrent attempt
  // would (a) race the atomic-rename state-file writes and clobber the first
  // attempt's telemetry row, and (b) potentially double-exit. See
  // FORCE_UPDATE_BUSY docstring above for context.
  if (_inFlight) {
    console.log('[ForceUpdate] BUSY: another invocation already in flight, skipping');
    return FORCE_UPDATE_BUSY;
  }
  _inFlight = true;
  try {
    return _executeForceUpdateInner(forceUpdate);
  } finally {
    // Always release the mutex, even on throw. Callers may rely on retrying
    // after a failure (e.g. heartbeat cooldown), so the flag MUST NOT remain
    // set after the function returns/throws. Note: on a successful upgrade,
    // _executeForceUpdateInner returns true and the caller invokes
    // process.exit(78); the finally still runs before exit -- which is fine,
    // there is nothing else to coordinate with at that point.
    _inFlight = false;
  }
}

function _executeForceUpdateInner(forceUpdate) {
  const INSTALL_ROOT = getEvolverInstallRoot();