Function launchOpenerCommand

src/commands/workset.ts:132–181

(
  command: LaunchCommand,
  options: LaunchOptions = {}
)

 * the child's real exit facts (the 128+n contract).
 */
export function launchOpenerCommand(
  command: LaunchCommand,
  options: LaunchOptions = {}
): Promise<LaunchResult> {
  const spawnFn = options.spawnFn ?? defaultSpawn();

  return new Promise((resolve, reject) => {
    const launchFailure = (error: unknown): StoreError =>
      new StoreError(
        `Could not launch ${command.label}: ${asErrorMessage(error)}`,
        'workset_launch_failed',
        {
          target: 'workset.tool',
          fix: `Check that '${command.executable}' runs from this terminal, or pass --tool with another installed tool.`,
        }
      );

    let child: ReturnType<typeof spawnFn>;
    try {
      child = spawnFn(command.executable, command.args, {
        cwd: command.cwd,
        stdio: 'inherit',
        shell: false,
      });
    } catch (error) {
      // Some spawn failures throw synchronously (platform-dependent);
      // they are the same launch failure.
      reject(launchFailure(error));
      return;
    }

    const ignoreSignal = (): void => undefined;
    process.on('SIGINT', ignoreSignal);
    process.on('SIGTERM', ignoreSignal);
    const cleanup = (): void => {
      process.removeListener('SIGINT', ignoreSignal);
      process.removeListener('SIGTERM', ignoreSignal);
    };

    child.on('error', (error) => {
      cleanup();
      reject(launchFailure(error));
    });

    child.on('close', (code, signal) => {
      cleanup();
      resolve({ code, signal });
    });
  });
}

/** 130 for SIGINT, 143 for SIGTERM - the shell's 128+n convention. */
export function exitCodeForLaunch(result: LaunchResult): number {