Class LldbCliBackend

src/utils/debugger/backends/lldb-cli-backend.ts:12–251

const COMMAND_SENTINEL_REGEX = new RegExp(`(^|\\r?\\n)${COMMAND_SENTINEL}(\\r?\\n)`);

class LldbCliBackend implements DebuggerBackend {
  readonly kind = 'lldb-cli' as const;

  private readonly spawner: InteractiveSpawner;
  private readonly prompt = LLDB_PROMPT;
  private readonly process: InteractiveProcess;
  private buffer = '';
  private pending: {
    resolve: (output: string) => void;
    reject: (error: Error) => void;
    timeout: NodeJS.Timeout;
  } | null = null;
  private queue: Promise<unknown> = Promise.resolve();
  private ready: Promise<void>;
  private disposed = false;

  constructor(spawner: InteractiveSpawner) {
    this.spawner = spawner;
    const lldbCommand = [
      'xcrun',
      'lldb',
      '--no-lldbinit',
      '-o',
      `settings set prompt "${this.prompt}"`,
    ];

    this.process = this.spawner(lldbCommand);

    this.process.process.stdout?.on('data', (data: Buffer) => this.handleData(data));
    this.process.process.stderr?.on('data', (data: Buffer) => this.handleData(data));
    this.process.process.on('exit', (code, signal) => {
      const detail = signal ? `signal ${signal}` : `code ${code ?? 'unknown'}`;
      this.failPending(new Error(`LLDB process exited (${detail})`));
    });

    this.ready = this.initialize();
  }

  private async initialize(): Promise<void> {
    // Prime the prompt by running a sentinel command we can parse reliably.
    this.process.write(`script print("${COMMAND_SENTINEL}")\n`);
    await this.waitForSentinel(DEFAULT_STARTUP_TIMEOUT_MS);
  }

  async waitUntilReady(): Promise<void> {
    await this.ready;
  }

  async attach(opts: { pid: number; simulatorId: string; waitFor?: boolean }): Promise<void> {
    const command = opts.waitFor
      ? `process attach --pid ${opts.pid} --waitfor`
      : `process attach --pid ${opts.pid}`;
    const output = await this.runCommand(command);
    assertNoLldbError('attach', output);
  }

  async detach(): Promise<void> {
    const output = await this.runCommand('process detach');