@farmslot/recipe-cli 0.7.0 → 0.9.0

package/dist/harness/commands/execution-template.js

@@ -0,0 +1,27 @@
+// execution-template — the host's entrypoint for the shared checklist catalog
+// (@farmslot/agent-runtime).
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { harnessHost } from '../host.js';
+const require = createRequire(import.meta.url);
+export async function handleExecutionTemplate(argv) {
+    const host = harnessHost().name;
+    let entrypoint;
+    try {
+        entrypoint = require.resolve('@farmslot/agent-runtime/scripts/execution-template-cli.mjs');
+    }
+    catch (error) {
+        console.error(`${host} execution-template: installed @farmslot/agent-runtime does not expose the catalog command: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+    const result = spawnSync(process.execPath, [entrypoint, ...argv], {
+        env: process.env,
+        stdio: 'inherit',
+    });
+    if (result.error) {
+        console.error(`${host} execution-template: ${result.error.message}`);
+        return 1;
+    }
+    return result.status ?? 1;
+}
+//# sourceMappingURL=execution-template.js.map

package/dist/harness/commands/execution-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-template.js","sourceRoot":"","sources":["../../../src/harness/commands/execution-template.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6BAA6B;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAc;IAC1D,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC;IAChC,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,4DAA4D,CAAC,CAAC;IAC7F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,GAAG,IAAI,+FACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE;QAChE,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,wBAAwB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/harness/commands/launch.js

@@ -80,6 +80,9 @@ async function handleLaunchLocked(argv, stream) {
         return launchUsage(jsonOutput, stream, undetectedAdapterMessage(target), adapterDetectNext());
     }
     stream.phase('resolve', { target, adapter, platform: platformTarget ?? null });
+    // A heartbeat for every adapter; one that reports its own stages speaks
+    // instead. The command's `complete` ends it.
+    stream.stage('launch', { index: 1, total: 1 });
     return harnessAdapter(adapter).launch({
         adapter,
         target,

package/dist/harness/commands/launch.js.map

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

package/dist/harness/commands/prepare.d.ts

@@ -0,0 +1,35 @@
+import { type RunnerProvenanceOptions } from '../doctor-report.js';
+/** A step the host runs after launch (its fixture setup, say). */
+export interface PrepareStep {
+    id: string;
+    command: string;
+    hint?: string;
+    argv(context: {
+        device: readonly string[];
+        forwarded: readonly string[];
+        targetArgs: readonly string[];
+    }): string[];
+}
+export interface PrepareCommandOptions {
+    usage: string;
+    steps?: readonly PrepareStep[];
+    launchHint?: string;
+    deviceTarget?: {
+        option: string;
+        flag: string;
+        choices: readonly string[];
+    };
+    clearMetroOnly?: string;
+    forward?: {
+        option: string;
+        flag: string;
+        validate?(value: string): void;
+    };
+    provenance?: RunnerProvenanceOptions;
+}
+export interface StatusDevice {
+    platform?: string;
+    selected?: boolean;
+}
+export declare function handlePrepare(argv: string[], commandOptions: PrepareCommandOptions): Promise<number>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/harness/commands/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/harness/commands/prepare.ts"],"names":[],"mappings":"AAeA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAUrF,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;KAC/B,GAAG,MAAM,EAAE,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IAEpC,KAAK,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAE/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAE5E,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QAEb,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAUD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAuYD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,cAAc,EAAE,qBAAqB,GACpC,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/harness/commands/prepare.js

@@ -0,0 +1,570 @@
+// prepare — run the readiness chain for a checkout and record the outcome as
+// the protocol readiness record. One file, one verdict: callers read
+// sandbox.json instead of re-deriving readiness from scattered step output.
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { READINESS_RECORD } from '@farmslot/protocol';
+import { OperationOutputTail } from '@farmslot/recipe-runner/runtime/operation';
+import { detectAdapter, harnessAdapter, harnessAdapters } from '../adapters.js';
+import { acquireCheckoutLock, trackCheckoutChild } from '../checkout-lock.js';
+import { color, stripAnsi } from '../cli-color.js';
+import { recordCommandStage } from '../command-journal.js';
+import { runnerProvenance } from '../doctor-report.js';
+import { harnessHost, hostEnvName } from '../host.js';
+import { optionFlag, optionString, parseArgs, targetPath, usageError } from '../parse-args.js';
+import { harnessExecutable, PREPARE_PROGRESS_ARTIFACT, recipeRuntimeDir } from '../paths.js';
+import { adapterReadiness } from '../readiness.js';
+import { EXIT } from '../shared.js';
+import { createStageReporter, STAGE_LINE } from '../stage-progress.js';
+import { formatDuration } from './status-watch.js';
+const REPORT_DIR = 'prepare';
+const SKIPPED_AFTER_FAILURE = 'previous step failed';
+// A step's stage name says what it runs when that is more than its id.
+const STAGE_NAME = { doctor: 'doctor --fix', launch: 'launch --verify' };
+// Longer than any stage line: past it the pending text (`\r` progress, say)
+// goes to the bounded tail rather than growing until a newline.
+const PARTIAL_LINE_LIMIT = 8 * 1024;
+function reportPathFor(id) {
+    return path.join(REPORT_DIR, `${id}.json`);
+}
+// A step's verdict comes from its exit code and its own JSON report, never from
+// scraped console text: banners, warnings, and update notices are not state.
+function reportedError(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout ?? '');
+    }
+    catch {
+        // Not every command reports a structured error; the exit code still stands.
+        return undefined;
+    }
+    const message = parsed?.error?.message;
+    return typeof message === 'string' && message ? message : undefined;
+}
+function skippedStep(id, command, reason) {
+    return { id, command, status: 'skipped', exitCode: 0, reason, durationMs: 0 };
+}
+const STEP_MARK = {
+    pending: '·',
+    running: '…',
+    pass: '✓',
+    fail: '✗',
+    skipped: '–',
+};
+const STEP_STYLE = {
+    pending: 'dim',
+    running: 'accent',
+    pass: 'ok',
+    fail: 'err',
+    skipped: 'dim',
+};
+// Steps long enough that silence reads as a hang. The note is on the row from
+// the moment the list is drawn, not from when the step starts: the point is to
+// set the expectation before the wait, not to explain it once someone is already
+// wondering. Fast steps carry nothing, so a note always means "this one is slow".
+// (The host supplies them: PrepareCommandOptions.launchHint and each step's hint.)
+// The chain the platform will actually run, known before the first step so the
+// whole list can be shown from the start rather than revealed one line at a time.
+function stepChain(headless, steps) {
+    return headless
+        ? ['doctor', 'status', 'verify']
+        : ['doctor', 'status', 'launch', ...steps.map((step) => step.id), 'verify'];
+}
+// What the last prepare of this checkout spent on each step. It is the only
+// honest estimate the harness has, and the one a reader wants while waiting.
+function lastRunDurations(recordPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(recordPath, 'utf8'));
+    }
+    catch {
+        // No previous record, or not a JSON document: there is simply no estimate
+        // to offer, and the hints stand on their static text alone.
+        return {};
+    }
+    const steps = parsed?.steps;
+    if (!Array.isArray(steps))
+        return {};
+    const durations = {};
+    for (const step of steps) {
+        if (typeof step?.id === 'string' &&
+            typeof step.durationMs === 'number' &&
+            step.durationMs > 0) {
+            durations[step.id] = step.durationMs;
+        }
+    }
+    return durations;
+}
+function stepHints(chain, lastRun, staticHints) {
+    const hints = {};
+    for (const id of chain) {
+        const previous = lastRun[id];
+        const parts = [];
+        if (staticHints[id])
+            parts.push(staticHints[id]);
+        if (previous !== undefined)
+            parts.push(`last run ${formatDuration(previous)}`);
+        if (parts.length > 0)
+            hints[id] = parts.join(', ');
+    }
+    return hints;
+}
+function stepRowLine(row, width) {
+    const out = (style, text) => color(style, text, { stream: process.stdout });
+    const running = row.state === 'pending' || row.state === 'running';
+    const elapsed = row.state === 'running' && row.startedAt !== undefined
+        ? ` ${out('dim', formatDuration(Date.now() - row.startedAt))}`
+        : '';
+    // While a step is ahead of or under way, the parenthesis explains the wait;
+    // once it is over, the same slot carries what it actually took.
+    const note = running
+        ? (row.detail ?? row.hint)
+        : row.durationMs
+            ? formatDuration(row.durationMs)
+            : undefined;
+    const mark = out(STEP_STYLE[row.state], STEP_MARK[row.state]);
+    return (`${mark} ${out(running ? 'bold' : 'dim', row.id.padEnd(width))}: ${out(STEP_STYLE[row.state], row.state)}` +
+        `${elapsed}${row.reason ? ` — ${row.reason}` : ''}${note ? ` ${out('dim', `(${note})`)}` : ''}`);
+}
+// The whole chain as one block: pending steps up front so the wait is bounded,
+// the running one counting up, the finished ones carrying their duration. On a
+// terminal the block is rewritten in place; piped, it is a plain log.
+function createStepView(chain, hints) {
+    const rows = new Map(chain.map((id) => [id, { id, state: 'pending', hint: hints[id] }]));
+    const width = Math.max(...chain.map((id) => id.length));
+    const tty = Boolean(process.stdout.isTTY);
+    // A row wider than the terminal wraps onto a second physical line, and the
+    // redraw counts logical lines — one wrapped hint and every later repaint lands
+    // in the wrong place. Piped output has no width to respect.
+    const block = () => {
+        // Only a width we actually know truncates anything. A pty can report 0 (or
+        // nothing at all) when no one is looking at it, and trimming to that blanks
+        // the whole block instead of fitting it.
+        const terminalColumns = process.stdout.columns;
+        const columns = tty && typeof terminalColumns === 'number' && terminalColumns > 0
+            ? terminalColumns
+            : Number.POSITIVE_INFINITY;
+        return [...rows.values()].map((row) => {
+            const line = stepRowLine(row, width);
+            // Slicing a styled string can cut an escape in half, so an over-wide row
+            // gives up its colour rather than its shape.
+            return stripAnsi(line).length <= columns ? line : stripAnsi(line).slice(0, columns);
+        });
+    };
+    let painted = 0;
+    let lastFrame = '';
+    let ended = false;
+    let timer;
+    const repaint = () => {
+        const lines = block();
+        const frame = lines.join('\n');
+        // Nothing moved since the last paint; repainting would only cost flicker.
+        if (frame === lastFrame)
+            return;
+        lastFrame = frame;
+        const up = painted > 0 ? `\x1b[${painted}A` : '';
+        painted = lines.length;
+        process.stdout.write(`${up}${lines.map((line) => `\x1b[2K${line}`).join('\n')}\n`);
+    };
+    const writeBlock = () => {
+        process.stdout.write(`${block().join('\n')}\n`);
+    };
+    return {
+        begin() {
+            if (tty)
+                repaint();
+            else
+                writeBlock();
+        },
+        start(id, startedAt) {
+            const row = rows.get(id);
+            if (!row)
+                return;
+            row.state = 'running';
+            row.startedAt = startedAt;
+            if (!tty)
+                return;
+            repaint();
+            // Ticked four times a second, not once: a busy moment in the event loop
+            // then costs a late repaint rather than a whole missed second, and the
+            // clock on screen never sits further behind the wall than a quarter of a
+            // second. repaint writes nothing when the rendered second has not changed.
+            //
+            // The timer is deliberately NOT unref'd. An unref'd timer does not hold
+            // the loop awake, so through a step that stays quiet for minutes — verify
+            // waiting on its probe — the loop sleeps and the clock on screen stops
+            // while the wall clock does not. end() always clears it, so a ref'd timer
+            // cannot outlive the run.
+            timer = setInterval(repaint, 250);
+        },
+        finish(step) {
+            clearInterval(timer);
+            timer = undefined;
+            const row = rows.get(step.id);
+            // Core records launch and fixtures as skipped without ever listing them:
+            // its chain is doctor, status, verify, and the record keeps the rest.
+            if (!row)
+                return;
+            row.state = step.status;
+            row.startedAt = undefined;
+            row.reason = step.reason;
+            row.durationMs = step.durationMs;
+            if (tty)
+                repaint();
+            else
+                process.stdout.write(`${stepRowLine(row, width)}\n`);
+        },
+        // Shown on the next tick of the live view.
+        detail(id, text) {
+            const row = rows.get(id);
+            if (row)
+                row.detail = text;
+        },
+        // Idempotent: the caller ends the view where the final block belongs in the
+        // output, and a `finally` ends it again on the paths that never got there.
+        // The ticker holds the event loop awake, so this must run either way.
+        end() {
+            if (ended)
+                return;
+            ended = true;
+            clearInterval(timer);
+            timer = undefined;
+            // The terminal already holds the finished block; piped output gets it once.
+            if (!tty)
+                writeBlock();
+        },
+    };
+}
+// Capture a step's streams the way spawnSync did — stdout for the report file,
+// stderr held back for the failure path — while leaving the event loop free so
+// the running line can tick during a step that takes minutes. The child's own
+// stage lines also go to onStageLine as they arrive.
+function spawnStep(executable, args, target, onStageLine) {
+    return new Promise((resolve) => {
+        const child = spawn(executable, [...args], {
+            cwd: target,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            // The update nudge is an interactive courtesy; it has no place in the
+            // stream a recorded readiness step captures.
+            env: { ...process.env, [hostEnvName('NO_UPDATE_CHECK')]: '1' },
+        });
+        if (child.pid)
+            trackCheckoutChild(target, child.pid);
+        let stdout = '';
+        const stderr = new OperationOutputTail();
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        let partial = '';
+        child.stderr?.on('data', (chunk) => {
+            const lines = `${partial}${chunk}`.split('\n');
+            partial = lines.pop() ?? '';
+            for (const line of lines) {
+                if (onStageLine && STAGE_LINE.test(line))
+                    onStageLine(line);
+                // Kept in the tail too: a child's last `failed` stage line may be the cause.
+                stderr.append(`${line}\n`);
+            }
+            // After the whole lines, so the tail keeps the order they came in.
+            if (partial.length > PARTIAL_LINE_LIMIT) {
+                stderr.append(partial);
+                partial = '';
+            }
+        });
+        child.on('error', (error) => resolve({ error, status: null, stdout, stderr: stderr.toString() }));
+        child.on('close', (status) => {
+            stderr.append(partial);
+            resolve({ status, stdout, stderr: stderr.toString() });
+        });
+    });
+}
+// Each step is the harness re-entering itself, so a task-local install prepares
+// the checkout with the same executable that will later run the proof.
+async function runStep(executable, target, artifactsDir, id, args, { json, onSpawn, onStageLine, }) {
+    const command = [executable, ...args].join(' ');
+    // One timestamp, taken at the spawn: the elapsed a reader watches tick and the
+    // durationMs the record keeps are then the same measurement, not two.
+    const startedAt = Date.now();
+    onSpawn?.(startedAt);
+    const result = await spawnStep(executable, args, target, onStageLine);
+    const durationMs = Date.now() - startedAt;
+    if (result.error) {
+        return { id, command, status: 'fail', exitCode: 1, reason: result.error.message, durationMs };
+    }
+    const report = reportPathFor(id);
+    const file = path.join(artifactsDir, report);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, result.stdout);
+    const exitCode = result.status ?? 1;
+    if (exitCode === 0) {
+        return { id, command, status: 'pass', exitCode, reportPath: report, durationMs };
+    }
+    // The failing step's own diagnostics carry the recovery a human must act on;
+    // --json keeps stdout a single document and leaves them in the report file.
+    if (!json && result.stderr)
+        process.stderr.write(result.stderr);
+    return {
+        id,
+        command,
+        status: 'fail',
+        exitCode,
+        reportPath: report,
+        reason: reportedError(result.stdout) ?? `exited ${exitCode}`,
+        durationMs,
+    };
+}
+function readDevices(artifactsDir) {
+    const file = path.join(artifactsDir, reportPathFor('status'));
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        // A status report that is absent or not a JSON document simply carries no
+        // device list; the caller then reports the target as ambiguous.
+        return [];
+    }
+    const devices = parsed?.devices;
+    return Array.isArray(devices) ? devices : [];
+}
+function ambiguousTarget(json, error) {
+    const { code, message, userAction } = error;
+    if (json) {
+        console.log(JSON.stringify({
+            schemaVersion: 1,
+            command: 'prepare',
+            status: 'fail',
+            exitCode: EXIT.runtime,
+            error: { code, message, userAction },
+        }, null, 2));
+    }
+    else {
+        console.error(`✗ ${harnessHost().name} prepare: ${message}`);
+        console.error(`  Next: ${userAction}`);
+    }
+    return EXIT.runtime;
+}
+function resolvePlatform(requested, target, usage) {
+    const platform = requested ?? detectAdapter(target);
+    const surface = platform && harnessAdapters().has(platform) ? harnessAdapter(platform) : undefined;
+    const prepare = surface ? adapterReadiness(surface).prepare : undefined;
+    if (surface && prepare)
+        return { surface, prepare };
+    throw usageError(`could not detect the platform of ${target}\n  Next: ${usage}`);
+}
+export async function handlePrepare(argv, commandOptions) {
+    const { options } = parseArgs(argv);
+    const target = targetPath(options);
+    if (!fs.existsSync(target))
+        return handlePrepareLocked(argv, commandOptions);
+    const lock = acquireCheckoutLock(target, 'prepare');
+    if ('message' in lock) {
+        if (optionFlag(options, 'json'))
+            console.log(JSON.stringify({
+                status: 'fail',
+                error: { code: 'SANDBOX_BUSY', message: lock.message },
+                exitCode: EXIT.runtime,
+            }));
+        else
+            console.error(`${lock.message} Next: inspect the owning operation with ${harnessHost().name} status --watch`);
+        return EXIT.runtime;
+    }
+    try {
+        return await handlePrepareLocked(argv, commandOptions);
+    }
+    finally {
+        lock.release();
+    }
+}
+async function handlePrepareLocked(argv, commandOptions) {
+    const { options } = parseArgs(argv);
+    const json = optionFlag(options, 'json');
+    const target = targetPath(options);
+    const usage = commandOptions.usage;
+    const { surface, prepare } = resolvePlatform(optionString(options, 'platform'), target, usage);
+    const platform = surface.id;
+    const hostSteps = commandOptions.steps ?? [];
+    const artifactsDir = path.resolve(optionString(options, 'artifactsDir') ?? path.join(target, recipeRuntimeDir()));
+    const executable = harnessExecutable();
+    const targetArgs = ['--target', target];
+    // doctor teaches "--clear-metro if the failure persists", so the sanctioned
+    // prepare path has to be able to carry it. It stays an explicit operator
+    // decision: nothing here ever clears the transform cache on its own.
+    const clearMetro = optionFlag(options, 'clearMetro');
+    if (clearMetro && !prepare.clearMetro) {
+        throw usageError(`--clear-metro is ${commandOptions.clearMetroOnly ?? 'not supported here'}; this checkout is ${platform}\n  Next: ${usage}`);
+    }
+    // Forwarded verbatim to launch and to the host steps, which own its grammar;
+    // the step record keeps the full command, so sandbox.json shows the value.
+    const forward = commandOptions.forward;
+    const forwardValue = forward ? optionString(options, forward.option) : undefined;
+    if (forward && forwardValue !== undefined) {
+        if (surface.headless) {
+            throw usageError(`${forward.flag} needs an app runtime; this checkout is ${platform}\n  Next: ${usage}`);
+        }
+        forward.validate?.(forwardValue);
+    }
+    const forwarded = forward && forwardValue !== undefined ? [forward.flag, forwardValue] : [];
+    const deviceTarget = commandOptions.deviceTarget;
+    let devicePlatform = deviceTarget ? optionString(options, deviceTarget.option) : undefined;
+    if (deviceTarget &&
+        devicePlatform !== undefined &&
+        !deviceTarget.choices.includes(devicePlatform)) {
+        throw usageError(`${deviceTarget.flag} must be ${deviceTarget.choices.join(' or ')}; received '${devicePlatform}'\n  Next: ${usage}`);
+    }
+    const recordPath = path.join(artifactsDir, READINESS_RECORD);
+    const progressPath = path.join(artifactsDir, PREPARE_PROGRESS_ARTIFACT);
+    // --json owns stdout as a single document, so it gets no step block.
+    const chain = stepChain(surface.headless, hostSteps);
+    const staticHints = {
+        ...(commandOptions.launchHint ? { launch: commandOptions.launchHint } : {}),
+        ...Object.fromEntries(hostSteps.flatMap((step) => (step.hint ? [[step.id, step.hint]] : []))),
+    };
+    const view = json
+        ? undefined
+        : createStepView(chain, stepHints(chain, lastRunDurations(recordPath), staticHints));
+    view?.begin();
+    // Stage lines on stderr, unless the live view repaints the same terminal
+    // stderr goes to: there the running row carries the step's latest stage line.
+    const stages = json || !process.stdout.isTTY || !process.stderr.isTTY ? createStageReporter() : undefined;
+    const steps = [];
+    let activeStep;
+    const startedAt = new Date().toISOString();
+    const writeProgress = () => {
+        fs.mkdirSync(path.dirname(progressPath), { recursive: true });
+        const temporaryPath = `${progressPath}.${process.pid}.tmp`;
+        fs.writeFileSync(temporaryPath, `${JSON.stringify({
+            schemaVersion: 1,
+            startedAt,
+            updatedAt: new Date().toISOString(),
+            total: chain.length,
+            steps: steps
+                .filter(({ id }) => chain.includes(id))
+                .map(({ id, status, durationMs }) => ({ id, status, durationMs })),
+            ...(activeStep ? { active: activeStep } : {}),
+        })}\n`);
+        fs.renameSync(temporaryPath, progressPath);
+    };
+    const failed = () => steps.some((step) => step.status === 'fail');
+    const addStep = (step) => {
+        steps.push(step);
+        activeStep = undefined;
+        writeProgress();
+        view?.finish(step);
+        return step;
+    };
+    const run = async (id, args) => {
+        if (failed()) {
+            return addStep(skippedStep(id, [executable, ...args].join(' '), SKIPPED_AFTER_FAILURE));
+        }
+        let stage;
+        const step = await runStep(executable, target, artifactsDir, id, args, {
+            json,
+            onSpawn: (stepStartedAt) => {
+                recordCommandStage(id);
+                activeStep = { id, startedAt: new Date(stepStartedAt).toISOString() };
+                writeProgress();
+                view?.start(id, stepStartedAt);
+                stage = stages?.stage(STAGE_NAME[id] ?? id, {
+                    index: chain.indexOf(id) + 1,
+                    total: chain.length,
+                });
+            },
+            onStageLine: (line) => {
+                stage?.forward(line);
+                view?.detail(id, line);
+            },
+        });
+        if (step.status === 'pass')
+            stage?.done();
+        else
+            stage?.failed(step.reason);
+        return addStep(step);
+    };
+    const heartbeat = setInterval(() => {
+        if (activeStep)
+            writeProgress();
+    }, 10_000);
+    // The ticker holds the event loop awake so it cannot miss a second, which
+    // makes ending the view mandatory on every way out of the chain — the early
+    // return below, or a step that throws on an unwritable report path.
+    try {
+        await run('doctor', ['doctor', '--fix', '--json', '--adapter', platform, ...targetArgs]);
+        await run('status', ['status', '--json', ...targetArgs]);
+        const devicePlatformFor = prepare.devicePlatform;
+        if (devicePlatformFor && !devicePlatform && !failed()) {
+            devicePlatform = devicePlatformFor(target, readDevices(artifactsDir));
+            if (!devicePlatform) {
+                return ambiguousTarget(json, prepare.ambiguousTarget?.() ?? {
+                    code: 'PREPARE_DEVICE_TARGET_AMBIGUOUS',
+                    message: 'could not infer the device target from the connected devices',
+                    userAction: `choose the device target, then rerun this command: ${usage}`,
+                });
+            }
+        }
+        if (surface.headless) {
+            // A headless platform reads its files directly and verify is its only
+            // readiness gate.
+            const reason = `${platform} is headless: no app surface to launch or seed`;
+            addStep(skippedStep('launch', `${executable} launch`, reason));
+            for (const step of hostSteps)
+                addStep(skippedStep(step.id, `${executable} ${step.command}`, reason));
+        }
+        else {
+            // devicePlatform is set unless an earlier step already failed, in which
+            // case these steps are recorded as skipped and the device target is
+            // unknowable. A platform without devices records the option but launches none.
+            const device = devicePlatformFor && devicePlatform ? [devicePlatform] : [];
+            await run('launch', [
+                'launch',
+                ...device,
+                ...(clearMetro ? ['--clear-metro'] : []),
+                ...forwarded,
+                '--verify',
+                '--json',
+                ...targetArgs,
+            ]);
+            for (const step of hostSteps)
+                await run(step.id, step.argv({ device, forwarded, targetArgs }));
+        }
+        await run('verify', ['verify', '--json', '--adapter', platform, ...targetArgs]);
+    }
+    finally {
+        clearInterval(heartbeat);
+        stages?.close('failed', 'prepare stopped');
+        view?.end();
+    }
+    const provenance = runnerProvenance(surface.actions.manifestPath(), commandOptions.provenance);
+    const record = {
+        schemaVersion: 1,
+        harness: {
+            name: provenance.packageName,
+            version: provenance.version,
+            source: `${provenance.installKind}/${provenance.packageSource}`,
+            executable: provenance.executablePath,
+        },
+        platform,
+        // The protocol's mobilePlatform is ios or android; another device target is
+        // not recorded.
+        ...(devicePlatform && (devicePlatform === 'ios' || devicePlatform === 'android')
+            ? { mobilePlatform: devicePlatform }
+            : {}),
+        steps,
+        ready: steps.every((step) => step.status !== 'fail'),
+        recordedAt: new Date().toISOString(),
+    };
+    fs.mkdirSync(artifactsDir, { recursive: true });
+    fs.writeFileSync(recordPath, `${JSON.stringify(record, null, 2)}\n`);
+    fs.rmSync(progressPath, { force: true });
+    if (json) {
+        console.log(JSON.stringify(record, null, 2));
+    }
+    else {
+        console.log(`readiness record: ${recordPath}`);
+    }
+    return record.ready ? EXIT.ok : EXIT.runtime;
+}
+//# sourceMappingURL=prepare.js.map