Function forceStopDaemon

src/cli/daemon-control.ts:89–122

(socketPath: string)

 * Uses registry ownership metadata to stop the process before unregistering daemon files.
 */
export async function forceStopDaemon(socketPath: string): Promise<void> {
  const entry = findDaemonRegistryEntryBySocketPath(socketPath);
  if (!entry) {
    throw new Error(
      `Cannot force-stop daemon at ${socketPath}: daemon registry metadata is missing`,
    );
  }

  const lock = acquireDaemonRegistryMutationLock(entry.workspaceKey);
  if (!lock) {
    throw new Error(`Unable to acquire daemon registry lock for ${entry.workspaceKey}`);
  }

  let termSent: boolean;
  try {
    validateCurrentRegistryEntry(entry, readDaemonRegistryEntry(entry.workspaceKey), socketPath);
    termSent = signalDaemonPid(entry.pid, 'SIGTERM');
  } finally {
    lock.release();
  }
  if (termSent && !(await waitForPidExit(entry.pid, FORCE_STOP_SIGNAL_TIMEOUT_MS))) {
    const killSent = signalDaemonPid(entry.pid, 'SIGKILL');
    if (killSent && !(await waitForPidExit(entry.pid, FORCE_STOP_SIGNAL_TIMEOUT_MS))) {
      throw new Error(`Daemon PID ${entry.pid} did not exit after SIGKILL`);
    }
  }

  cleanupWorkspaceDaemonFiles(entry.workspaceKey, {
    pid: entry.pid,
    socketPath,
    instanceId: entry.instanceId,
    allowLiveOwner: true,
  });
}

export interface StartDaemonBackgroundOptions {
  socketPath: string;