lim 0.13.2 → 0.14.1

package/dist/lib/progress.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressReporter = void 0;
+const core_1 = require("@oclif/core");
+/**
+ * Spinner + checkmark progress reporting on stderr, shared across commands so
+ * they all look the same (e.g. `lim run`, `lim xcode rbe`). Renders a live
+ * spinner with an optional tail of streamed log lines on a TTY, and prints a
+ * green ✔ / red ✖ line on completion. All output is suppressed when the owning
+ * command is in --json/--quiet mode (via the injected `suppressed` predicate),
+ * and falls back to no-op animation when stderr is not a TTY.
+ */
+const SPINNER_FRAMES = process.platform === 'win32' ? ['-', '\\', '|', '/'] : ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const SUCCESS_ICON = process.platform === 'win32' ? '√' : '✔';
+const FAILURE_ICON = process.platform === 'win32' ? '×' : '✖';
+const DEFAULT_TAIL_LINES = 10;
+class ProgressReporter {
+    constructor(suppressed, opts = {}) {
+        this.suppressed = suppressed;
+        this.tailLines = opts.tailLines ?? DEFAULT_TAIL_LINES;
+    }
+    /** Print a standalone green ✔ line (no spinner). */
+    success(message) {
+        if (this.suppressed()) {
+            return;
+        }
+        process.stderr.write(`${core_1.ux.colorize('green', SUCCESS_ICON)} ${message}\n`);
+    }
+    /** Run `fn` under a spinner, resolving to a ✔ (or ✖ on throw). */
+    async withProgress(message, fn, successMessage) {
+        this.start(message);
+        try {
+            const result = await fn();
+            this.stop('success', successMessage);
+            return result;
+        }
+        catch (err) {
+            this.stop('failure');
+            throw err;
+        }
+    }
+    start(message) {
+        if (this.suppressed()) {
+            return;
+        }
+        this.progress = { frame: 0, logLines: [], message, renderedRows: 0 };
+        if (process.stderr.isTTY) {
+            this.progress.timer = setInterval(() => this.render(), process.platform === 'win32' ? 500 : 100);
+            this.progress.timer.unref();
+            this.render();
+        }
+    }
+    stop(result = 'success', message) {
+        if (this.suppressed() || !this.progress) {
+            return;
+        }
+        const progress = this.progress;
+        if (progress.timer) {
+            clearInterval(progress.timer);
+        }
+        this.progress = undefined;
+        this.clear(progress);
+        const icon = result === 'success' ? core_1.ux.colorize('green', SUCCESS_ICON) : core_1.ux.colorize('red', FAILURE_ICON);
+        process.stderr.write(`${icon} ${message ?? progress.message}\n`);
+    }
+    appendLog(chunk) {
+        if (this.suppressed() || !this.progress) {
+            return;
+        }
+        const lines = String(chunk)
+            .replace(/\r/g, '\n')
+            .split('\n')
+            .map((line) => line.trimEnd())
+            .filter((line) => line.length > 0);
+        if (lines.length === 0) {
+            return;
+        }
+        this.progress.logLines.push(...lines);
+        this.progress.logLines = this.progress.logLines.slice(-this.tailLines);
+        this.render();
+    }
+    render() {
+        if (!this.progress || !process.stderr.isTTY) {
+            return;
+        }
+        const frame = SPINNER_FRAMES[this.progress.frame % SPINNER_FRAMES.length];
+        this.progress.frame += 1;
+        const lines = [
+            progressLine(`${core_1.ux.colorize('magenta', frame)} ${this.progress.message}`),
+            ...this.progress.logLines.map((line) => core_1.ux.colorize('dim', `  ${truncateTerminalLine(line, 2)}`)),
+        ];
+        this.clear(this.progress);
+        this.progress.renderedRows = lines.length;
+        process.stderr.write(lines.join('\n'));
+    }
+    clear(progress) {
+        if (!process.stderr.isTTY) {
+            return;
+        }
+        process.stderr.clearLine(0);
+        process.stderr.cursorTo(0);
+        for (let i = 1; i < progress.renderedRows; i += 1) {
+            process.stderr.moveCursor(0, -1);
+            process.stderr.clearLine(0);
+            process.stderr.cursorTo(0);
+        }
+    }
+}
+exports.ProgressReporter = ProgressReporter;
+function progressLine(line) {
+    const width = process.stderr.columns;
+    if (!width || line.length < width - 1) {
+        return line;
+    }
+    return `${line.slice(0, Math.max(0, width - 4))}...`;
+}
+function truncateTerminalLine(line, indent = 0) {
+    const width = process.stderr.columns;
+    const max = width ? width - indent - 1 : undefined;
+    if (!max || line.length < max) {
+        return line;
+    }
+    return `${line.slice(0, Math.max(0, max - 3))}...`;
+}
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"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"}

package/dist/lib/rbe-session.d.ts

@@ -0,0 +1,72 @@
+import type { RbeStatus, XcodeClient } from '@limrun/api';
+/**
+ * Deterministic, side-effect-light helpers behind `lim xcode rbe`, extracted
+ * from the command so they can be unit-tested without the oclif lifecycle.
+ */
+export type Sleep = (ms: number) => Promise<void>;
+export declare const defaultSleep: Sleep;
+export declare function isTransientError(err: unknown): boolean;
+/**
+ * Retries `fn` on transient gateway errors. Non-transient errors propagate
+ * immediately. After exhausting `attempts`, throws the last error.
+ */
+export declare function retryTransient<T>(fn: () => Promise<T>, opts?: {
+    sleep?: Sleep;
+    log?: (msg: string) => void;
+    attempts?: number;
+}): Promise<T>;
+/**
+ * Polls `getRbe` until the stack is `running` (with a usable frontend port and
+ * Xcode version), starting from the `initial` status returned by `startRbe`.
+ * Each poll is wrapped in retryTransient so a transient blip mid-startup does
+ * not abort. Throws when the stack ends in `failed`, stays `starting` past
+ * `maxAttempts`, or reports `running` without the fields the caller needs.
+ */
+export declare function waitForRbeRunning(client: Pick<XcodeClient, 'getRbe'>, initial: RbeStatus, opts?: {
+    sleep?: Sleep;
+    maxAttempts?: number;
+}): Promise<Required<Pick<RbeStatus, 'frontendPort' | 'xcodeVersion'>> & RbeStatus>;
+/**
+ * Builds the argv for the detached child that holds the tunnel: re-invokes this
+ * same CLI as `xcode rbe --serve --id <id> --port <port> [--api-key <key>]`.
+ * `scriptPath` is the CLI entry (process.argv[1]).
+ */
+export declare function buildServeChildArgs(opts: {
+    scriptPath: string;
+    id: string;
+    port: number;
+    apiKey?: string;
+}): string[];
+/**
+ * A running background tunnel's coordinates, persisted to `.limrun/rbe.pid` so
+ * `lim xcode rbe --stop` can find and stop it (adb prints the PID and forgets
+ * it; we keep just enough to offer a discoverable stop). Lives under `.limrun/`,
+ * which is self-gitignored.
+ */
+export type RbePidInfo = {
+    pid: number;
+    instanceId: string;
+    port: number;
+    /** iOS simulator created by `--ios`, torn down on --stop. Absent otherwise. */
+    simInstanceId?: string;
+};
+export declare function rbePidFilePath(workspaceRoot: string): string;
+export declare function writeRbePidFile(workspaceRoot: string, info: RbePidInfo): void;
+export declare function readRbePidFile(workspaceRoot: string): RbePidInfo | null;
+export declare function clearRbePidFile(workspaceRoot: string): void;
+/** Whether `pid` is a live process (treats EPERM — owned by another user — as alive). */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Resolves when `port` on `host` is bindable; rejects with a friendly message
+ * when it is already in use, or with the raw error otherwise. Frees the port
+ * immediately (the probe listener is closed before resolving).
+ */
+export declare function assertLocalPortFree(port: number, host?: string): Promise<void>;
+/**
+ * Resolves true if a TCP connection to `host:port` is accepted (something is
+ * listening), false otherwise (connection refused, error, or no answer within
+ * `timeoutMs`). The timeout only bites when a connect neither completes nor is
+ * refused (a dropped SYN); on loopback a closed port refuses instantly.
+ */
+export declare function probePortOpen(port: number, host?: string, timeoutMs?: number): Promise<boolean>;
+//# sourceMappingURL=rbe-session.d.ts.map

package/dist/lib/rbe-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbe-session.d.ts","sourceRoot":"","sources":["../../src/lib/rbe-session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAClD,eAAO,MAAM,YAAY,EAAE,KAAiE,CAAC;AAc7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGtD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3E,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EACnC,OAAO,EAAE,SAAS,EAClB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC,CAYjF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,EAAE,CAoBX;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAE7E;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAUvE;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAezF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,EAAE,SAAS,SAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAajG"}

package/dist/lib/rbe-session.js

@@ -0,0 +1,188 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultSleep = void 0;
+exports.isTransientError = isTransientError;
+exports.retryTransient = retryTransient;
+exports.waitForRbeRunning = waitForRbeRunning;
+exports.buildServeChildArgs = buildServeChildArgs;
+exports.rbePidFilePath = rbePidFilePath;
+exports.writeRbePidFile = writeRbePidFile;
+exports.readRbePidFile = readRbePidFile;
+exports.clearRbePidFile = clearRbePidFile;
+exports.isProcessAlive = isProcessAlive;
+exports.assertLocalPortFree = assertLocalPortFree;
+exports.probePortOpen = probePortOpen;
+const fs_1 = __importDefault(require("fs"));
+const net_1 = __importDefault(require("net"));
+const path_1 = __importDefault(require("path"));
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+exports.defaultSleep = defaultSleep;
+/**
+ * Matches the transient gateway / dropped-connection errors that occur right
+ * after an instance is created, when its proxy path is not fully serving yet.
+ *
+ * The HTTP part anchors on the exact `failed: <code>` shape `directInstanceHttpError`
+ * produces (`${operation} failed: ${status}...`), so a bare 502/503/504 buried in
+ * a response body or an instance id does NOT count as transient. Fetch-thrown
+ * network errors carry their own names and are matched directly. A 404 never
+ * reaches here — `readRbeResponse` maps it to RbeUnsupportedError first.
+ */
+const TRANSIENT = /failed: (?:502|503|504)\b|\bEOF\b|ECONNRESET|ECONNREFUSED|socket hang up|fetch failed/i;
+function isTransientError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return TRANSIENT.test(message);
+}
+/**
+ * Retries `fn` on transient gateway errors. Non-transient errors propagate
+ * immediately. After exhausting `attempts`, throws the last error.
+ */
+async function retryTransient(fn, opts = {}) {
+    const sleep = opts.sleep ?? exports.defaultSleep;
+    const attempts = opts.attempts ?? 5;
+    let lastErr;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (!isTransientError(err)) {
+                throw err;
+            }
+            lastErr = err;
+            if (attempt < attempts) {
+                const message = err instanceof Error ? err.message : String(err);
+                opts.log?.(`Instance not serving yet (${message.trim()}); retrying...`);
+                await sleep(2000 * attempt);
+            }
+        }
+    }
+    throw lastErr;
+}
+/**
+ * Polls `getRbe` until the stack is `running` (with a usable frontend port and
+ * Xcode version), starting from the `initial` status returned by `startRbe`.
+ * Each poll is wrapped in retryTransient so a transient blip mid-startup does
+ * not abort. Throws when the stack ends in `failed`, stays `starting` past
+ * `maxAttempts`, or reports `running` without the fields the caller needs.
+ */
+async function waitForRbeRunning(client, initial, opts = {}) {
+    const sleep = opts.sleep ?? exports.defaultSleep;
+    const maxAttempts = opts.maxAttempts ?? 15;
+    let status = initial;
+    for (let attempt = 0; status.state === 'starting' && attempt < maxAttempts; attempt++) {
+        await sleep(2000);
+        status = await retryTransient(() => client.getRbe(), { sleep });
+    }
+    if (status.state !== 'running' || !status.frontendPort || !status.xcodeVersion) {
+        throw new Error(`Remote-execution stack failed to start: ${status.error ?? `state is ${status.state}`}`);
+    }
+    return status;
+}
+/**
+ * Builds the argv for the detached child that holds the tunnel: re-invokes this
+ * same CLI as `xcode rbe --serve --id <id> --port <port> [--api-key <key>]`.
+ * `scriptPath` is the CLI entry (process.argv[1]).
+ */
+function buildServeChildArgs(opts) {
+    // --no-create: the child must never own instance creation. The parent already
+    // resolved/created the instance and started RBE on it; if that instance has
+    // vanished by the time the child resolves it, the child should fail cleanly
+    // rather than spin up a stray instance the parent never started a stack on.
+    const args = [
+        opts.scriptPath,
+        'xcode',
+        'rbe',
+        '--serve',
+        '--no-create',
+        '--id',
+        opts.id,
+        '--port',
+        String(opts.port),
+    ];
+    if (opts.apiKey) {
+        args.push('--api-key', opts.apiKey);
+    }
+    return args;
+}
+function rbePidFilePath(workspaceRoot) {
+    return path_1.default.join(workspaceRoot, '.limrun', 'rbe.pid');
+}
+function writeRbePidFile(workspaceRoot, info) {
+    fs_1.default.writeFileSync(rbePidFilePath(workspaceRoot), JSON.stringify(info));
+}
+function readRbePidFile(workspaceRoot) {
+    try {
+        const parsed = JSON.parse(fs_1.default.readFileSync(rbePidFilePath(workspaceRoot), 'utf8'));
+        if (parsed && typeof parsed.pid === 'number') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function clearRbePidFile(workspaceRoot) {
+    try {
+        fs_1.default.unlinkSync(rbePidFilePath(workspaceRoot));
+    }
+    catch {
+        // already gone
+    }
+}
+/** Whether `pid` is a live process (treats EPERM — owned by another user — as alive). */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+/**
+ * Resolves when `port` on `host` is bindable; rejects with a friendly message
+ * when it is already in use, or with the raw error otherwise. Frees the port
+ * immediately (the probe listener is closed before resolving).
+ */
+async function assertLocalPortFree(port, host = '127.0.0.1') {
+    await new Promise((resolve, reject) => {
+        const probe = net_1.default.createServer();
+        probe.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new Error(`Local port ${port} is already in use. Pass --port to choose another.`));
+            }
+            else {
+                reject(err);
+            }
+        });
+        probe.once('listening', () => {
+            probe.close(() => resolve());
+        });
+        probe.listen(port, host);
+    });
+}
+/**
+ * Resolves true if a TCP connection to `host:port` is accepted (something is
+ * listening), false otherwise (connection refused, error, or no answer within
+ * `timeoutMs`). The timeout only bites when a connect neither completes nor is
+ * refused (a dropped SYN); on loopback a closed port refuses instantly.
+ */
+function probePortOpen(port, host = '127.0.0.1', timeoutMs = 500) {
+    return new Promise((resolve) => {
+        const socket = new net_1.default.Socket();
+        const done = (open) => {
+            socket.destroy();
+            resolve(open);
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once('connect', () => done(true));
+        socket.once('timeout', () => done(false));
+        socket.once('error', () => done(false));
+        socket.connect(port, host);
+    });
+}
+//# sourceMappingURL=rbe-session.js.map

package/dist/lib/rbe-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbe-session.js","sourceRoot":"","sources":["../../src/lib/rbe-session.ts"],"names":[],"mappings":"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"}

package/dist/lib/rbe-workspace.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Generates the .limrun/ workspace companion for `lim xcode rbe`: a Bazel
+ * package pinning the remote fleet's Xcode version and an rc fragment with the
+ * remote-execution flags under the `limrun` config. The caller learns the
+ * fleet's version key from the instance's RBE status, so the generated config
+ * always matches the fleet without any user action; rerunning the command
+ * after a fleet Xcode upgrade regenerates the pin.
+ */
+export declare const LIMRUN_DIR = ".limrun";
+export declare const TRY_IMPORT_LINE = "try-import %workspace%/.limrun/bazelrc";
+/**
+ * Finds the Bazel workspace root by walking up from `startDir` to the first
+ * ancestor containing a MODULE.bazel / WORKSPACE / WORKSPACE.bazel, mirroring
+ * how Bazel itself locates the workspace when run from a subdirectory. Returns
+ * null when no workspace is found up to the filesystem root. The generated
+ * `.limrun/` and the `try-import` must live at this root, since `%workspace%`
+ * in bazelrc resolves here regardless of the directory the build is run from.
+ */
+export declare function findBazelWorkspaceRoot(startDir: string): string | null;
+/**
+ * Best-effort guess of a single buildable app target to show in the printed
+ * build command, so it reads `//App` instead of a `//your:target` placeholder.
+ * Scans the workspace's BUILD files (buildifier-formatted) for apple
+ * `*_application` rules — no bazel invocation — and returns the label in short
+ * form (`//pkg` when the target name matches the package's last segment).
+ * Returns null when there are zero or multiple candidates (ambiguous → caller
+ * keeps the placeholder).
+ */
+export declare function inferBuildTarget(workspaceRoot: string): string | null;
+/**
+ * Reads the workspace's pinned Bazel major version from `.bazelversion`, or
+ * null when the file is absent or its first line has no leading integer.
+ *
+ * Used to decide whether the generated BUILD must `load` the Xcode rules from
+ * apple_support: in Bazel 9 they are no longer native globals and must be
+ * loaded, while in Bazel 8 they ARE native globals and the apple_support rule
+ * impls `fail()` on the unmigrated Bazel, so loading them there breaks
+ * analysis. The generator runs in the workspace on the client, so the file is
+ * the authoritative signal for the Bazel that bazelisk will launch.
+ */
+export declare function detectBazelMajorVersion(workspaceDir: string): number | null;
+/**
+ * Whether to treat the workspace as Bazel 9+ for RBE config: true when the
+ * detected major version is >= 9, OR unknown (no `.bazelversion` means bazelisk
+ * runs the latest release, which is 9+). This single predicate decides both
+ * emitting the apple_support Xcode-rule loads and surfacing the SHA256 digest
+ * hint, so the two stay in lockstep.
+ */
+export declare function isBazel9OrLater(bazelMajor: number | null): boolean;
+/**
+ * Renders the generated Bazel package pinning the Xcode version to the fleet's.
+ *
+ * remoteVersionKey is the fleet's `xcodebuild -version` in major.minor.patch.build
+ * form (e.g. 26.4.0.17E192).
+ *
+ * Uses Bazel's remote/local `xcode_config` split with BOTH sets pointing at the
+ * SAME fleet pin (rather than a single `default=/versions=` bucket, which
+ * resolves with availability UNKNOWN and leaves Apple/Swift actions eligible for
+ * local execution). With local == remote, `--xcode_version` resolves as
+ * "mutually available" (BOTH), which declares up front that this build uses only
+ * the fleet's Xcode AND keeps apple_support from emitting its remote-only
+ * "...specified, but it is not available locally..." DEBUG notice (that notice
+ * fires only when the pinned version is in `remote_versions` but not
+ * `local_versions`).
+ *
+ * We intentionally do NOT name the client's own local Xcode: under
+ * `--config=limrun` every action runs remotely (`--spawn_strategy=remote` +
+ * `--noremote_local_fallback`), so a local DEVELOPER_DIR is never resolved.
+ * Declaring a distinct local version would only reintroduce that DEBUG notice on
+ * a client whose Xcode differs from the fleet's. (The fleet pin is used, not
+ * Bazel's `@local_config_xcode//:host_available_xcodes`: that repo is not
+ * visible from the main module under bzlmod and is never generated off-darwin.)
+ *
+ * When `emitLoads` is true (Bazel 9+), the Xcode rules are loaded from
+ * apple_support; on Bazel 8 they are native globals and MUST NOT be loaded
+ * (the apple_support rule impls fail on the unmigrated Bazel).
+ */
+export declare function renderXcodeConfigBuild(remoteVersionKey: string, emitLoads: boolean): string;
+/**
+ * Renders the rc fragment with the remote-execution flags under
+ * --config=limrun.
+ *
+ * - `--xcode_version` pins the fleet's version: without it, a mac client
+ *   lacking that exact version has no mutual version and silently falls back
+ *   to its LOCAL default, shipping the wrong version to the remote worker via
+ *   XCODE_VERSION_OVERRIDE (the worker then rejects it).
+ * - `--strategy=SwiftCompile=remote` / `--strategy=Genrule=remote` override
+ *   mnemonic-specific strategies a workspace may pin (rules_swift defaults
+ *   SwiftCompile to a local persistent `worker`; repos often pin Genrule to
+ *   `standalone`). Those run locally and break RBE: a local Swift worker can't
+ *   run on a Linux client at all, and on a mac it would demand the fleet's
+ *   Xcode locally. --spawn_strategy=remote does not override per-mnemonic
+ *   pins, so these explicit overrides are required.
+ * - PATH includes /usr/sbin:/sbin so genrules that probe `sysctl` (e.g.
+ *   `hw.logicalcpu` for `make -j`) resolve it on the worker.
+ * - `--remote_download_outputs=minimal` keeps build outputs (the .ipa) in the
+ *   instance's CAS instead of downloading them to the client. `lim xcode rbe
+ *   install` then installs the artifact on the attached simulator server-side
+ *   (fast diff-sync), so the bytes never round-trip — pointless on a Linux
+ *   client, and the artifact is produced in the instance anyway. Scoped to
+ *   --config=limrun, so a plain `bazel build` still materializes outputs.
+ * - `--build_event_json_file` writes the Build Event Protocol to .limrun/bep.json;
+ *   `lim xcode rbe install` reads the built target's .ipa CAS digest from it. The
+ *   path is ABSOLUTE on purpose: Bazel expands `%workspace%` only in
+ *   import/try-import, NOT in flag values (it would be taken literally and create
+ *   a junk `%workspace%/` dir), and a relative path resolves against bazel's cwd
+ *   rather than the workspace root.
+ * - `--extra_execution_platforms` is emitted ONLY for non-mac clients: a Linux
+ *   host has no auto-detected darwin execution platform, so the Apple/Swift
+ *   toolchain (exec_compatible_with macos) needs one registered to route
+ *   actions to the mac RBE pool. On a mac it is HARMFUL: it makes bazel run
+ *   exec-config actions on the local host instead of the remote worker, which
+ *   then demand a local Xcode.
+ */
+export declare function renderLimrunBazelrc(port: number, versionKey: string, isMacClient: boolean, bepPath: string): string;
+/**
+ * Idempotently ensures the workspace .bazelrc try-imports the generated
+ * fragment. Creates .bazelrc when missing. Returns true when the file changed.
+ */
+export declare function ensureTryImport(workspaceDir: string): boolean;
+export type RbeWorkspaceFiles = {
+    buildFile: string;
+    bazelrcFragment: string;
+    bazelrcUpdated: boolean;
+};
+/**
+ * Writes .limrun/{BUILD,bazelrc,.gitignore} into the workspace and wires the
+ * try-import. The .gitignore containing "*" makes the directory self-ignoring
+ * so nothing else in the user's repo needs to change.
+ */
+export declare function writeRbeWorkspaceFiles(workspaceDir: string, xcodeVersionKey: string, port: number, isMacClient?: boolean, bazelMajor?: number | null): RbeWorkspaceFiles;
+//# sourceMappingURL=rbe-workspace.d.ts.map

package/dist/lib/rbe-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbe-workspace.d.ts","sourceRoot":"","sources":["../../src/lib/rbe-workspace.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAO,MAAM,eAAe,2CAA2C,CAAC;AAKxE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBrE;AAqCD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAElE;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAmC3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAiB7D;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,OAAuC,EACpD,UAAU,GAAE,MAAM,GAAG,IAA4C,GAChE,iBAAiB,CAkBnB"}