Function isRunnerRunningCurrentlyInstalledHappyVersion

cli/src/runner/controlClient.ts:163–235

()

 * @returns true if versions match, false if versions differ or no runner running
 */
export async function isRunnerRunningCurrentlyInstalledHappyVersion(): Promise<boolean> {
  logger.debug('[RUNNER CONTROL] Checking if runner is running same version');
  const runningRunner = await checkIfRunnerRunningAndCleanupStaleState();
  if (!runningRunner) {
    logger.debug('[RUNNER CONTROL] No runner running, returning false');
    return false;
  }

  const state = await readRunnerState();
  if (!state) {
    logger.debug('[RUNNER CONTROL] No runner state found, returning false');
    return false;
  }

  const settings = await readSettings();
  const currentApiUrl = process.env.HAPI_API_URL
    || settings.apiUrl
    || settings.serverUrl
    || configuration.apiUrl;
  const currentCliApiToken = process.env.CLI_API_TOKEN
    || settings.cliApiToken
    || configuration.cliApiToken;
  const currentMachineId = settings.machineId;
  
  try {
    // When HAPI_DISABLE_VERSION_HANDOFF=1 is set on the live runner (operator
    // owns supervision via systemd/tmux/custom rebuild pipelines), a fresh CLI invocation must NOT
    // treat the running runner as stale just because source mtimes shifted.
    // Otherwise `hapi runner start` would kill the live runner mid-rebuild.
    //
    // Per Codex review #814 [Major]: the env var is commonly only set on the
    // supervising service (systemd unit file), NOT on the operator's
    // interactive shell. To honour the running runner's opt-out from any
    // caller, OR the live env-var check with the persisted-at-start snapshot
    // in state.startedWithVersionHandoffDisabled.
    if (
      process.env.HAPI_DISABLE_VERSION_HANDOFF === '1'
      || state.startedWithVersionHandoffDisabled === true
    ) {
      logger.debug('[RUNNER CONTROL] Version handoff disabled (env or persisted state), skipping mtime/version drift check');
    } else {
      const currentCliMtimeMs = getInstalledCliMtimeMs();
      if (typeof currentCliMtimeMs === 'number' && typeof state.startedWithCliMtimeMs === 'number') {
        logger.debug(`[RUNNER CONTROL] Current CLI mtime: ${currentCliMtimeMs}, Runner started with mtime: ${state.startedWithCliMtimeMs}`);
        if (currentCliMtimeMs !== state.startedWithCliMtimeMs) {
          return false;
        }
      } else {
        const currentCliVersion = packageJson.version;
        logger.debug(`[RUNNER CONTROL] Current CLI version: ${currentCliVersion}, Runner started with version: ${state.startedWithCliVersion}`);
        if (currentCliVersion !== state.startedWithCliVersion) {
          return false;
        }
      }
    }

    const currentIdentityMatches = isRunnerStateCompatibleWithIdentity(state, {
      apiUrl: currentApiUrl,