Function launchMacApp

src/utils/macos-steps.ts:16–47

(
  appPath: string,
  executor: CommandExecutor,
  opts?: { args?: string[] },
)

 * Launch a macOS app and return bundle ID and process ID if available.
 */
export async function launchMacApp(
  appPath: string,
  executor: CommandExecutor,
  opts?: { args?: string[] },
): Promise<MacLaunchResult> {
  log('info', `Launching macOS app: ${appPath}`);
  const command = buildOpenAppCommand(appPath, { args: opts?.args });

  const result = await executor(command, 'Launch macOS App', false);
  if (!result.success) {
    return { success: false, error: result.error ?? 'Failed to launch app' };
  }

  let bundleId: string | undefined;
  try {
    const plistResult = await executor(
      ['defaults', 'read', `${appPath}/Contents/Info`, 'CFBundleIdentifier'],
      'Extract Bundle ID',
      false,
    );
    if (plistResult.success && plistResult.output) {
      bundleId = plistResult.output.trim();
    }
  } catch {
    // non-fatal
  }

  const appName = path.basename(appPath, '.app');
  const processId = await resolveProcessId(appName, executor);

  return { success: true, bundleId, processId };
}

const MAC_PID_TIMEOUT_MS = 2000;
const MAC_PID_INTERVAL_MS = 100;