@farmslot/adapter-rn 0.15.0 → 0.16.0

package/dist/source-freshness.js

@@ -0,0 +1,98 @@
+// Fingerprint of the app source a running bundle was built from. In a git
+// checkout it is HEAD plus the diff and untracked files under the source paths;
+// outside git it hashes the paths themselves. Env files always count. The
+// project supplies both lists.
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { checkFingerprintBaseline, recordFingerprintBaseline, } from './fingerprint-baseline.js';
+export function sourceFingerprint(projectRoot, inputs) {
+    const hash = createHash('sha256');
+    const head = gitHead(projectRoot);
+    if (head === null) {
+        hash.update('non-git\0');
+        for (const relative of inputs.paths) {
+            hashPath(hash, projectRoot, relative);
+        }
+    }
+    else {
+        hash.update(head);
+        hash.update(git(projectRoot, ['diff', '--no-ext-diff', '--binary', 'HEAD', '--', ...inputs.paths]));
+        const untracked = git(projectRoot, [
+            'ls-files',
+            '--others',
+            '--exclude-standard',
+            '-z',
+            '--',
+            ...inputs.paths,
+        ])
+            .toString('utf8')
+            .split('\0')
+            .filter(Boolean)
+            .sort();
+        for (const relative of untracked) {
+            hash.update(`untracked\0${relative}\0`);
+            hash.update(fs.readFileSync(path.join(projectRoot, relative)));
+            hash.update('\0');
+        }
+    }
+    for (const relative of inputs.envFiles) {
+        const absolute = path.join(projectRoot, relative);
+        hash.update(`env\0${relative}\0`);
+        hash.update(fs.existsSync(absolute) ? fs.readFileSync(absolute) : '<absent>');
+        hash.update('\0');
+    }
+    return hash.digest('hex');
+}
+export function sourceCheck(projectRoot, inputs, markerPath) {
+    return checkFingerprintBaseline(markerPath, sourceFingerprint(projectRoot, inputs));
+}
+export function recordSourceBaseline(projectRoot, inputs, markerPath, expectedFingerprint) {
+    return recordFingerprintBaseline(markerPath, expectedFingerprint, () => sourceFingerprint(projectRoot, inputs));
+}
+function git(cwd, args) {
+    return execFileSync('git', args, {
+        cwd,
+        encoding: 'buffer',
+        maxBuffer: 128 * 1024 * 1024,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+}
+// null when the project is not a git checkout (or git is unavailable): the
+// fingerprint then hashes the source paths directly.
+function gitHead(cwd) {
+    try {
+        return git(cwd, ['rev-parse', 'HEAD']);
+    }
+    catch (error) {
+        const status = error.status;
+        const code = error.code;
+        if (typeof status === 'number' || code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+function hashPath(hash, root, relative) {
+    const absolute = path.join(root, relative);
+    if (!fs.existsSync(absolute)) {
+        hash.update(`absent\0${relative}\0`);
+        return;
+    }
+    const stat = fs.lstatSync(absolute);
+    if (stat.isDirectory()) {
+        hash.update(`directory\0${relative}\0`);
+        for (const child of fs.readdirSync(absolute).sort()) {
+            hashPath(hash, root, path.join(relative, child));
+        }
+        return;
+    }
+    if (stat.isSymbolicLink()) {
+        hash.update(`symlink\0${relative}\0${fs.readlinkSync(absolute)}\0`);
+        return;
+    }
+    hash.update(`file\0${relative}\0`);
+    hash.update(fs.readFileSync(absolute));
+    hash.update('\0');
+}
+//# sourceMappingURL=source-freshness.js.map

package/dist/source-freshness.js.map

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

package/dist/tool-paths.d.ts

@@ -0,0 +1,13 @@
+export type MobileTool = 'adb' | 'idb';
+export interface MobileToolPaths {
+    adb: string | null;
+    idb: string | null;
+}
+export declare function mobileToolRecovery(tool: MobileTool): string;
+export declare function mobileToolEnvName(tool: MobileTool): string;
+export declare function resolveMobileToolPath(tool: MobileTool, { required }?: {
+    required?: boolean;
+}): string | null;
+export declare function resolveAndExportMobileToolPaths(platform?: string): MobileToolPaths;
+export declare function clearMobileToolPathCache(): void;
+//# sourceMappingURL=tool-paths.d.ts.map

package/dist/tool-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-paths.d.ts","sourceRoot":"","sources":["../src/tool-paths.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAcD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAG3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAG1D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,EAAE,QAAgB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,MAAM,GAAG,IAAI,CAmBf;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAWlF;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/tool-paths.js

@@ -0,0 +1,125 @@
+// Locate executable adb and idb clients, cache their paths, and export them to
+// child processes through RECIPE_RN_ADB_PATH / RECIPE_RN_IDB_PATH.
+import { accessSync, constants as fsConstants, readdirSync, realpathSync, statSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const TOOL_ENV = {
+    adb: 'RECIPE_RN_ADB_PATH',
+    idb: 'RECIPE_RN_IDB_PATH',
+};
+const TOOL_RECOVERY = {
+    adb: 'brew install android-platform-tools',
+    idb: 'brew install idb-companion pipx python@3.13 && pipx install fb-idb --python python3.13',
+};
+const resolvedPaths = new Map();
+export function mobileToolRecovery(tool) {
+    assertTool(tool);
+    return TOOL_RECOVERY[tool];
+}
+export function mobileToolEnvName(tool) {
+    assertTool(tool);
+    return TOOL_ENV[tool];
+}
+export function resolveMobileToolPath(tool, { required = false } = {}) {
+    assertTool(tool);
+    const cached = resolvedPaths.get(tool);
+    if (cached && executablePath(cached))
+        return cached;
+    for (const candidate of candidatesFor(tool)) {
+        const resolved = executablePath(candidate);
+        if (!resolved)
+            continue;
+        resolvedPaths.set(tool, resolved);
+        process.env[TOOL_ENV[tool]] = resolved;
+        return resolved;
+    }
+    resolvedPaths.delete(tool);
+    if (!required)
+        return null;
+    const label = tool === 'adb' ? 'Android SDK Platform-Tools (adb)' : 'Facebook idb client';
+    throw new Error(`${label} is required but no executable was found.\n  Next: ${TOOL_RECOVERY[tool]}`);
+}
+export function resolveAndExportMobileToolPaths(platform) {
+    if (platform === 'android') {
+        return { adb: resolveMobileToolPath('adb', { required: true }), idb: null };
+    }
+    if (platform === 'ios') {
+        return { adb: null, idb: resolveMobileToolPath('idb') };
+    }
+    return {
+        adb: resolveMobileToolPath('adb'),
+        idb: resolveMobileToolPath('idb'),
+    };
+}
+export function clearMobileToolPathCache() {
+    resolvedPaths.clear();
+}
+function candidatesFor(tool) {
+    const override = process.env[TOOL_ENV[tool]];
+    const pathCandidates = String(process.env.PATH ?? '')
+        .split(path.delimiter)
+        .filter(Boolean)
+        .map((directory) => path.join(directory, tool));
+    const candidates = override ? [override] : [];
+    candidates.push(...pathCandidates);
+    if (tool === 'adb') {
+        for (const root of [
+            process.env.ANDROID_HOME,
+            process.env.ANDROID_SDK_ROOT,
+            path.join(os.homedir(), 'Library/Android/sdk'),
+            path.join(os.homedir(), 'Android/Sdk'),
+        ]) {
+            if (root)
+                candidates.push(path.join(root, 'platform-tools', 'adb'));
+        }
+    }
+    else {
+        if (process.env.IDB_PATH)
+            candidates.push(process.env.IDB_PATH);
+        candidates.push('/opt/homebrew/bin/idb', '/usr/local/bin/idb', path.join(os.homedir(), '.local/bin/idb'));
+        candidates.push(...pythonUserCandidates());
+    }
+    return [...new Set(candidates.map((candidate) => path.resolve(candidate)))];
+}
+// Filesystem errors that only mean "this candidate is not there or not usable".
+const UNUSABLE_CANDIDATE_CODES = new Set(['ENOENT', 'ENOTDIR', 'EACCES', 'EPERM', 'ELOOP']);
+function isUnusableCandidate(error) {
+    return UNUSABLE_CANDIDATE_CODES.has(String(error?.code));
+}
+function pythonUserCandidates() {
+    const root = path.join(os.homedir(), 'Library/Python');
+    try {
+        return readdirSync(root, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => path.join(root, entry.name, 'bin/idb'));
+    }
+    catch (error) {
+        // No readable ~/Library/Python (Linux, or no pip --user installs): no candidates here.
+        if (isUnusableCandidate(error))
+            return [];
+        throw error;
+    }
+}
+// A candidate that does not exist, dangles, or is not executable is simply not a
+// match; the caller tries the next one.
+function executablePath(candidate) {
+    try {
+        const resolved = realpathSync(candidate);
+        const stat = statSync(resolved);
+        if (!stat.isFile())
+            return null;
+        accessSync(resolved, fsConstants.X_OK);
+        return path.resolve(resolved);
+    }
+    catch (error) {
+        if (isUnusableCandidate(error))
+            return null;
+        throw error;
+    }
+}
+function assertTool(tool) {
+    if (tool !== 'adb' && tool !== 'idb') {
+        throw new Error(`Unsupported mobile device tool: ${String(tool)}.`);
+    }
+}
+//# sourceMappingURL=tool-paths.js.map

package/dist/tool-paths.js.map

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

package/dist/video-recorder.d.ts

@@ -0,0 +1,7 @@
+import { type VideoRecorder } from '@farmslot/recipe-runner';
+export declare const ANDROID_RECORDING_TARGET_PREFIX = "android-device:";
+export declare const IOS_SIMULATOR_RECORDING_TARGET_PREFIX = "ios-simulator:";
+export declare function androidScreenrecordArgs(remotePath: string): string[];
+export declare function createAndroidVideoRecorder(serial: string): VideoRecorder;
+export declare function createIosSimulatorVideoRecorder(simulator: string): VideoRecorder;
+//# sourceMappingURL=video-recorder.d.ts.map

package/dist/video-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-recorder.d.ts","sourceRoot":"","sources":["../src/video-recorder.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,aAAa,EAGnB,MAAM,yBAAyB,CAAC;AAGjC,eAAO,MAAM,+BAA+B,oBAAoB,CAAC;AACjE,eAAO,MAAM,qCAAqC,mBAAmB,CAAC;AAMtE,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAOxE;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAOhF"}

package/dist/video-recorder.js

@@ -0,0 +1,250 @@
+import { spawn, spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { optionalVideoTiming, } from '@farmslot/recipe-runner';
+// Recording target ids: `android-device:<serial>` and `ios-simulator:<udid>`.
+export const ANDROID_RECORDING_TARGET_PREFIX = 'android-device:';
+export const IOS_SIMULATOR_RECORDING_TARGET_PREFIX = 'ios-simulator:';
+const RECORDING_START_TIMEOUT_MS = 5_000;
+const RECORDING_STOP_TIMEOUT_MS = 10_000;
+const RECORDING_TIME_LIMIT_SECONDS = 0;
+export function androidScreenrecordArgs(remotePath) {
+    return [
+        'shell',
+        'screenrecord',
+        '--time-limit',
+        String(RECORDING_TIME_LIMIT_SECONDS),
+        remotePath,
+    ];
+}
+export function createAndroidVideoRecorder(serial) {
+    return {
+        name: 'adb-screenrecord',
+        platform: 'android',
+        doctor: async () => doctorAndroidRecorder(serial),
+        start: (request) => startAndroidRecording(serial, request),
+    };
+}
+export function createIosSimulatorVideoRecorder(simulator) {
+    return {
+        name: 'simctl-recordVideo',
+        platform: 'ios',
+        doctor: async () => doctorIosSimulatorRecorder(simulator),
+        start: (request) => startIosSimulatorRecording(simulator, request),
+    };
+}
+function doctorIosSimulatorRecorder(simulator) {
+    const state = runSimctl(['getenv', simulator, 'SIMULATOR_UDID']);
+    if (state.status !== 0 || !state.stdout.trim()) {
+        return {
+            ok: false,
+            code: 'ios_simulator_unavailable',
+            message: `iOS simulator ${simulator} is not booted: ${commandFailure(state)}`,
+            suggestedFix: `Boot ${simulator} and run xcrun simctl getenv ${simulator} SIMULATOR_UDID.`,
+        };
+    }
+    return {
+        ok: true,
+        code: 'ok',
+        message: `iOS simulator recording is ready on ${simulator}.`,
+    };
+}
+async function startIosSimulatorRecording(simulator, request) {
+    const targetSimulator = iosTargetSimulator(request);
+    if (targetSimulator !== simulator) {
+        throw new Error(`iOS recording target ${targetSimulator ?? '<missing>'} does not match selected simulator ${simulator}.`);
+    }
+    fs.mkdirSync(path.dirname(request.outputPath), { recursive: true });
+    const child = spawn('xcrun', ['simctl', 'io', simulator, 'recordVideo', '--codec=h264', '--force', request.outputPath], { stdio: ['ignore', 'pipe', 'pipe'] });
+    const output = [];
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    child.stdout?.on('data', (chunk) => output.push(String(chunk)));
+    child.stderr?.on('data', (chunk) => output.push(String(chunk)));
+    await waitForIosRecordingStart(child, output);
+    let stopped = false;
+    return {
+        async stop() {
+            if (stopped) {
+                throw new Error(`iOS simulator recording on ${simulator} was already stopped.`);
+            }
+            stopped = true;
+            child.kill('SIGINT');
+            await waitForChildExit(child, RECORDING_STOP_TIMEOUT_MS, 'iOS simulator recordVideo');
+            const recorded = fs.statSync(request.outputPath);
+            if (!recorded.isFile() || recorded.size <= 0) {
+                throw new Error(`iOS simulator recording output is empty: ${request.outputPath}`);
+            }
+            return {
+                recorder: {
+                    name: 'simctl-recordVideo',
+                    platform: 'ios',
+                    target: { selector: 'simulator', value: simulator },
+                },
+            };
+        },
+    };
+}
+function doctorAndroidRecorder(serial) {
+    const state = runAdb(serial, ['get-state']);
+    if (state.status !== 0 || state.stdout.trim() !== 'device') {
+        return {
+            ok: false,
+            code: 'android_device_unavailable',
+            message: `Android device ${serial} is not ready: ${commandFailure(state)}`,
+            suggestedFix: `Run adb -s ${serial} get-state and reconnect or unlock the device.`,
+        };
+    }
+    const screenrecord = runAdb(serial, ['shell', 'screenrecord', '--help']);
+    if (screenrecord.status !== 0) {
+        return {
+            ok: false,
+            code: 'android_screenrecord_unavailable',
+            message: `Android screenrecord is unavailable on ${serial}: ${commandFailure(screenrecord)}`,
+            suggestedFix: `Run adb -s ${serial} shell screenrecord --help.`,
+        };
+    }
+    return {
+        ok: true,
+        code: 'ok',
+        message: `Android screen recording is ready on ${serial}.`,
+    };
+}
+async function startAndroidRecording(serial, request) {
+    const targetSerial = androidTargetSerial(request);
+    if (targetSerial !== serial) {
+        throw new Error(`Android recording target ${targetSerial ?? '<missing>'} does not match selected device ${serial}.`);
+    }
+    const existingPid = screenrecordPid(serial);
+    if (existingPid) {
+        throw new Error(`Android screenrecord is already running on ${serial} (pid ${existingPid}). Stop that recording before retrying.`);
+    }
+    const remotePath = `/sdcard/Download/recipe-video-${Date.now()}-${process.pid}.mp4`;
+    const startedAtUnixMs = Date.now();
+    const child = spawn('adb', ['-s', serial, ...androidScreenrecordArgs(remotePath)], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    const stderr = [];
+    child.stderr?.setEncoding('utf8');
+    child.stderr?.on('data', (chunk) => stderr.push(String(chunk)));
+    child.stdout?.resume();
+    const recorderPid = await waitForScreenrecordStart(serial, child, stderr);
+    let stopped = false;
+    return {
+        async stop() {
+            if (stopped) {
+                throw new Error(`Android screen recording on ${serial} was already stopped.`);
+            }
+            stopped = true;
+            try {
+                stopRemoteScreenrecord(serial, recorderPid);
+                await waitForChildExit(child, RECORDING_STOP_TIMEOUT_MS, 'Android screenrecord');
+                const stoppedAtUnixMs = Date.now();
+                fs.mkdirSync(path.dirname(request.outputPath), { recursive: true });
+                const pull = runAdb(serial, ['pull', remotePath, request.outputPath]);
+                if (pull.status !== 0) {
+                    throw new Error(`Could not pull Android recording from ${serial}: ${commandFailure(pull)}`);
+                }
+                const output = fs.statSync(request.outputPath);
+                if (!output.isFile() || output.size <= 0) {
+                    throw new Error(`Android recording output is empty: ${request.outputPath}`);
+                }
+                return {
+                    ...(await optionalVideoTiming(request.outputPath, { startedAtUnixMs, stoppedAtUnixMs })),
+                    recorder: {
+                        name: 'adb-screenrecord',
+                        platform: 'android',
+                        target: { selector: 'adb-serial', value: serial },
+                    },
+                };
+            }
+            finally {
+                runAdb(serial, ['shell', 'rm', '-f', remotePath]);
+            }
+        },
+    };
+}
+function androidTargetSerial(request) {
+    if (request.target.kind === 'android-device')
+        return request.target.serial;
+    if (request.target.kind !== 'window-id')
+        return undefined;
+    if (!request.target.windowId.startsWith(ANDROID_RECORDING_TARGET_PREFIX))
+        return undefined;
+    return request.target.windowId.slice(ANDROID_RECORDING_TARGET_PREFIX.length) || undefined;
+}
+async function waitForScreenrecordStart(serial, child, stderr) {
+    const deadline = Date.now() + RECORDING_START_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        if (child.exitCode !== null) {
+            throw new Error(`Android screenrecord exited before capture started (exit ${child.exitCode}): ${stderr.join('').trim() || 'no recorder output'}`);
+        }
+        const pid = screenrecordPid(serial);
+        if (pid)
+            return pid;
+        await sleep(100);
+    }
+    child.kill('SIGTERM');
+    throw new Error(`Android screenrecord did not start on ${serial} within ${RECORDING_START_TIMEOUT_MS}ms.`);
+}
+function stopRemoteScreenrecord(serial, pid) {
+    const stop = runAdb(serial, ['shell', 'kill', '-2', pid]);
+    if (stop.status !== 0 && screenrecordPid(serial) === pid) {
+        throw new Error(`Could not stop Android screenrecord pid ${pid}: ${commandFailure(stop)}`);
+    }
+}
+async function waitForChildExit(child, timeoutMs, recorderName) {
+    if (child.exitCode !== null)
+        return;
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            child.kill('SIGTERM');
+            reject(new Error(`${recorderName} did not stop within ${timeoutMs}ms.`));
+        }, timeoutMs);
+        child.once('exit', () => {
+            clearTimeout(timeout);
+            resolve();
+        });
+    });
+}
+async function waitForIosRecordingStart(child, output) {
+    const deadline = Date.now() + RECORDING_START_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        if (child.exitCode !== null) {
+            throw new Error(`iOS simulator recordVideo exited before capture started (exit ${child.exitCode}): ${output.join('').trim() || 'no recorder output'}`);
+        }
+        if (output.join('').includes('Recording started'))
+            return;
+        await sleep(100);
+    }
+    if (child.exitCode === null)
+        return;
+    throw new Error(`iOS simulator recordVideo did not start within ${RECORDING_START_TIMEOUT_MS}ms.`);
+}
+function iosTargetSimulator(request) {
+    if (request.target.kind !== 'window-id')
+        return undefined;
+    if (!request.target.windowId.startsWith(IOS_SIMULATOR_RECORDING_TARGET_PREFIX)) {
+        return undefined;
+    }
+    return request.target.windowId.slice(IOS_SIMULATOR_RECORDING_TARGET_PREFIX.length) || undefined;
+}
+function screenrecordPid(serial) {
+    const result = runAdb(serial, ['shell', 'pidof', 'screenrecord']);
+    if (result.status !== 0)
+        return undefined;
+    return result.stdout.trim().split(/\s+/u).find(Boolean);
+}
+function runAdb(serial, args) {
+    return spawnSync('adb', ['-s', serial, ...args], { encoding: 'utf8' });
+}
+function runSimctl(args) {
+    return spawnSync('xcrun', ['simctl', ...args], { encoding: 'utf8' });
+}
+function commandFailure(result) {
+    return result.stderr.trim() || result.stdout.trim() || `exit ${result.status ?? 'unknown'}`;
+}
+function sleep(durationMs) {
+    return new Promise((resolve) => setTimeout(resolve, durationMs));
+}
+//# sourceMappingURL=video-recorder.js.map

package/dist/video-recorder.js.map

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

package/metro/coalesce-metro-log.cjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+'use strict';
+
+const readline = require('node:readline');
+
+const progressPattern = /^\s*(?:iOS|Android).*?(\d{1,3}(?:\.\d+)?)%/u;
+let lastPercent = null;
+let lastProgressAt = 0;
+
+const lines = readline.createInterface({
+  input: process.stdin,
+  crlfDelay: Infinity,
+  terminal: false,
+});
+lines.on('line', (line) => {
+  const progress = progressPattern.exec(line);
+  if (!progress) {
+    process.stdout.write(`${line}\n`);
+    return;
+  }
+  const percent = Math.floor(Number(progress[1]));
+  const now = Date.now();
+  if (percent !== lastPercent || now - lastProgressAt >= 15_000) {
+    process.stdout.write(`${line} [metro-progress ${new Date(now).toISOString()}]\n`);
+    lastPercent = percent;
+    lastProgressAt = now;
+  }
+});

package/metro/launch-metro.cjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+function parseArgs(argv) {
+  const values = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '-h' || arg === '--help') {
+      values.help = true;
+      continue;
+    }
+    if (arg === '--clear') {
+      values.clear = true;
+      continue;
+    }
+    if (!arg.startsWith('--') || index + 1 >= argv.length)
+      throw new Error(`invalid argument: ${arg}`);
+    values[arg.slice(2)] = argv[++index];
+  }
+  return values;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    console.log(
+      'Usage: launch-metro.cjs --target <path> --port <port> --log <path> --pid-file <path> --build-env <path> --runner <path> [--workers <n>] [--clear]',
+    );
+    return;
+  }
+  for (const required of ['target', 'port', 'log', 'pid-file', 'build-env', 'runner']) {
+    if (!args[required]) throw new Error(`--${required} is required`);
+  }
+  const target = path.resolve(args.target);
+  const log = path.resolve(args.log);
+  const pidFile = path.resolve(args['pid-file']);
+  const runner = path.resolve(args.runner);
+  fs.mkdirSync(path.dirname(log), { recursive: true });
+  fs.mkdirSync(path.dirname(pidFile), { recursive: true });
+  const runnerStat = fs.lstatSync(runner);
+  if (!runnerStat.isFile()) throw new Error('--runner must be a regular file');
+  fs.accessSync(runner, fs.constants.X_OK);
+  const env = { ...process.env };
+  env.BASH_ENV = args['build-env'];
+  if (args.workers) env.METRO_MAX_WORKERS = String(args.workers);
+  const child = spawn(runner, [], {
+    cwd: target,
+    detached: true,
+    env,
+    stdio: 'ignore',
+  });
+  await new Promise((resolve, reject) => {
+    child.once('spawn', resolve);
+    child.once('error', reject);
+  });
+  fs.writeFileSync(pidFile, `${String(child.pid)}\n`);
+  fs.writeFileSync(
+    path.join(path.dirname(pidFile), 'metro-launch.json'),
+    `${JSON.stringify(
+      {
+        schemaVersion: 1,
+        pid: child.pid,
+        pgid: child.pid,
+        startedAt: new Date().toISOString(),
+        target,
+        port: Number(args.port),
+        clear: Boolean(args.clear),
+        command: runner,
+      },
+      null,
+      2,
+    )}\n`,
+  );
+  child.unref();
+}
+
+main().catch((error) => {
+  console.error(`launch-metro: ${error.message}`);
+  process.exit(1);
+});