xcodebuild-axi 0.1.0

package/dist/src/commands/settings.js

@@ -0,0 +1,191 @@
+import { AxiError } from "../errors.js";
+import { requireProject } from "../context.js";
+import { requireScheme } from "../scheme.js";
+import { runMetadata } from "../xcodebuild.js";
+import { renderFields, renderHelp, renderList, renderOutput } from "../toon.js";
+import { getFlag, getListFlag, hasFlag, rejectUnknownFlags } from "../args.js";
+export const SETTINGS_HELP = `usage: xcodebuild-axi settings [flags]
+Reads resolved build settings. Asking for the keys you want turns a 40 KB dump
+into a few lines.
+flags[7]:
+  --scheme <name>         scheme to resolve against (required only when the project has more than one)
+  --key <NAME>            setting to read; repeatable or comma-separated
+  --configuration <name>  build configuration to resolve against
+  --all                   dump every setting (large — hundreds of keys)
+  --for-index             the per-source-file settings an indexer sees
+  --file <path>           with --for-index: the one source file to report on
+  --full                  with --for-index --file: list the long argument arrays
+note:
+  --for-index answers a different question from the rest of this command: it
+  reports the compiler invocation the indexer builds per source file. The raw
+  payload measured 216 KB on a 12-scheme workspace, so without --file it
+  reports only which targets have index settings and how many files each has.
+examples:
+  xcodebuild-axi settings --key PRODUCT_BUNDLE_IDENTIFIER,MARKETING_VERSION
+  xcodebuild-axi settings --scheme MyApp --key SWIFT_VERSION
+  xcodebuild-axi settings --scheme MyApp --for-index --file MyApp/AppFeature.swift
+`;
+const FLAGS = [
+    "--scheme",
+    "--key",
+    "--configuration",
+    "--all",
+    "--for-index",
+    "--file",
+    "--full",
+];
+const VALUE_FLAGS = ["--scheme", "--key", "--configuration", "--file"];
+export async function settingsCommand(args) {
+    rejectUnknownFlags(args, "settings", FLAGS, VALUE_FLAGS);
+    const keys = getListFlag(args, "--key");
+    const all = hasFlag(args, "--all");
+    const forIndex = hasFlag(args, "--for-index");
+    if (keys.length === 0 && !all && !forIndex) {
+        throw new AxiError("settings needs --key or --all", "VALIDATION_ERROR", [
+            "xcodebuild-axi settings --key PRODUCT_BUNDLE_IDENTIFIER",
+            "xcodebuild-axi settings --all  # every setting, hundreds of lines",
+        ]);
+    }
+    const project = requireProject();
+    const scheme = await requireScheme(project, getFlag(args, "--scheme"), "settings");
+    const configuration = getFlag(args, "--configuration");
+    const { stdout } = await runMetadata([
+        ...project.flags,
+        "-scheme",
+        scheme,
+        ...(configuration ? ["-configuration", configuration] : []),
+        forIndex ? "-showBuildSettingsForIndex" : "-showBuildSettings",
+        "-json",
+    ]);
+    if (forIndex) {
+        return reportIndexSettings(stdout, scheme, getFlag(args, "--file"), hasFlag(args, "--full"));
+    }
+    const settings = parseSettings(stdout);
+    if (all) {
+        return renderOutput([
+            renderFields({ scheme, settings: Object.keys(settings).length }),
+            renderFields({ ...settings }),
+        ]);
+    }
+    const found = {};
+    const missing = [];
+    for (const key of keys) {
+        const value = settings[key];
+        if (value === undefined)
+            missing.push(key);
+        else
+            found[key] = value;
+    }
+    const blocks = [renderFields({ scheme })];
+    if (Object.keys(found).length > 0) {
+        blocks.push(renderFields({ settings: found }));
+    }
+    if (missing.length > 0) {
+        // A key that does not exist is an answer, not an error — say so plainly
+        // rather than returning an empty block the agent has to re-query to trust.
+        blocks.push(renderFields({ unset: missing.join(",") }));
+        blocks.push(renderHelp([
+            `Run \`xcodebuild-axi settings --scheme ${scheme} --all\` to see every key this scheme resolves`,
+        ]));
+    }
+    return renderOutput(blocks);
+}
+/**
+ * `-showBuildSettingsForIndex` is the one query in this family whose full
+ * output is never worth printing: it repeats the entire Swift driver command
+ * line for every source file in the scheme. Report the shape, or one file.
+ */
+function reportIndexSettings(stdout, scheme, file, full) {
+    const start = stdout.indexOf("{");
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout.slice(start < 0 ? 0 : start));
+    }
+    catch {
+        parsed = {};
+    }
+    const targets = Object.entries(parsed);
+    if (targets.length === 0) {
+        return renderOutput([
+            renderFields({
+                scheme,
+                index_settings: "none — the scheme builds no indexable sources",
+            }),
+        ]);
+    }
+    if (file === undefined) {
+        return renderOutput([
+            renderFields({ scheme }),
+            renderList("targets", targets.map(([target, files]) => ({
+                target,
+                files: Object.keys(files).length,
+            }))),
+            renderHelp([
+                "Add `--file <path>` to see the compiler settings for one source file",
+            ]),
+        ]);
+    }
+    const match = findFile(targets, file);
+    if (!match) {
+        // The path is the caller's, so echo what was searched rather than making
+        // them guess whether the file or the scheme was wrong.
+        throw new AxiError(`No index settings for '${file}' in scheme ${scheme}`, "NOT_FOUND", [
+            `the scheme indexes ${plural(targets.reduce((sum, [, files]) => sum + Object.keys(files).length, 0), "file")} across ${plural(targets.length, "target")}`,
+            `Run \`xcodebuild-axi settings --scheme ${scheme} --for-index\` to see the targets`,
+        ]);
+    }
+    const [target, path, settings] = match;
+    // swiftASTCommandArguments alone is several hundred entries of compiler flags.
+    const rendered = Object.fromEntries(Object.entries(settings).map(([key, value]) => [
+        key,
+        Array.isArray(value) && !full
+            ? `${plural(value.length, "entry", "entries")} — pass --full to list them`
+            : value,
+    ]));
+    return renderOutput([
+        renderFields({ scheme, target, file: relativeToCwd(path) }),
+        renderFields(rendered),
+    ]);
+}
+/** Match on suffix, so a repo-relative path works as well as an absolute one. */
+function findFile(targets, file) {
+    const needle = file.replace(/^\.\//, "");
+    for (const [target, files] of targets) {
+        for (const [path, settings] of Object.entries(files)) {
+            if (path === file || path.endsWith(`/${needle}`)) {
+                return [target, path, settings];
+            }
+        }
+    }
+    return undefined;
+}
+function plural(count, one, many = `${one}s`) {
+    return `${count} ${count === 1 ? one : many}`;
+}
+function relativeToCwd(path) {
+    const cwd = `${process.cwd()}/`;
+    return path.startsWith(cwd) ? path.slice(cwd.length) : path;
+}
+/**
+ * `-showBuildSettings -json` emits an array of one object per target, each
+ * with a `buildSettings` map. Later targets win on collision, which matches
+ * the order xcodebuild itself resolves them in.
+ */
+function parseSettings(stdout) {
+    const start = stdout.indexOf("[");
+    if (start === -1)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout.slice(start));
+    }
+    catch {
+        return {};
+    }
+    const merged = {};
+    for (const entry of parsed) {
+        Object.assign(merged, entry.buildSettings ?? {});
+    }
+    return merged;
+}
+//# sourceMappingURL=settings.js.map

package/dist/src/commands/settings.js.map

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

package/dist/src/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare const SETUP_HELP = "usage: xcodebuild-axi setup hooks [flags]\nInstalls session-start hooks so an agent sees this project's schemes and last\nrun before it does anything (AXI principle 7). Covers Claude Code, Codex, and\nOpenCode.\nflags[3]:\n  --project    install into this repository instead of your home directory\n  --status     report what is installed, writing nothing\n  --uninstall  remove the hooks this tool installed\nexamples:\n  xcodebuild-axi setup hooks\n  xcodebuild-axi setup hooks --project\n  xcodebuild-axi setup hooks --status\n";
+export declare function setupCommand(args: string[]): Promise<string>;

package/dist/src/commands/setup.js

@@ -0,0 +1,84 @@
+import { installSessionStartHooks, sessionStartHookStatus, uninstallSessionStartHooks, } from "axi-sdk-js";
+import { AxiError } from "../errors.js";
+import { renderFields, renderHelp, renderOutput } from "../toon.js";
+import { hasFlag, positionals, rejectUnknownFlags } from "../args.js";
+export const SETUP_HELP = `usage: xcodebuild-axi setup hooks [flags]
+Installs session-start hooks so an agent sees this project's schemes and last
+run before it does anything (AXI principle 7). Covers Claude Code, Codex, and
+OpenCode.
+flags[3]:
+  --project    install into this repository instead of your home directory
+  --status     report what is installed, writing nothing
+  --uninstall  remove the hooks this tool installed
+examples:
+  xcodebuild-axi setup hooks
+  xcodebuild-axi setup hooks --project
+  xcodebuild-axi setup hooks --status
+`;
+const FLAGS = ["--project", "--status", "--uninstall"];
+/**
+ * Passed explicitly rather than left to the SDK to infer.
+ *
+ * `inferHookOptions` reads the marker out of `process.argv[1]` and only
+ * matches a `dist/bin/<name>.js` path, so it works from the installed binary
+ * and throws everywhere else — `npm run dev -- setup hooks --status` failed
+ * with "unable to infer a hook marker from the current process". The installed
+ * binary infers this exact string, so stating it changes nothing there and
+ * makes `--status` and `--uninstall` work from a dev checkout too.
+ *
+ * Install is still correctly refused from a `.ts` entrypoint: the SDK's own
+ * policy rejects one, which is right — a hook wired to a tsx path would break
+ * as soon as the checkout moved.
+ */
+const MARKER = "xcodebuild-axi";
+export async function setupCommand(args) {
+    rejectUnknownFlags(args, "setup", FLAGS);
+    const [target] = positionals(args, []);
+    if (target !== "hooks") {
+        throw new AxiError(target === undefined
+            ? "setup needs a target"
+            : `Unknown setup target '${target}'`, "VALIDATION_ERROR", ["xcodebuild-axi setup hooks"]);
+    }
+    const scope = hasFlag(args, "--project")
+        ? "project"
+        : "user";
+    if (hasFlag(args, "--status")) {
+        const status = sessionStartHookStatus({ scope, marker: MARKER });
+        return renderOutput([
+            renderFields({
+                setup: "status",
+                scope,
+                claude: status.claude?.installed
+                    ? (status.claude.path ?? "installed")
+                    : "not installed",
+                codex: status.codex?.installed
+                    ? (status.codex.path ?? "installed")
+                    : "not installed",
+                opencode: status.opencode?.installed
+                    ? (status.opencode.path ?? "installed")
+                    : "not installed",
+            }),
+        ]);
+    }
+    if (hasFlag(args, "--uninstall")) {
+        await uninstallSessionStartHooks({ scope, marker: MARKER });
+        return renderOutput([renderFields({ setup: "hooks removed", scope })]);
+    }
+    await installSessionStartHooks({ scope, marker: MARKER });
+    const status = sessionStartHookStatus({ scope, marker: MARKER });
+    return renderOutput([
+        renderFields({
+            setup: "hooks installed or already up to date",
+            scope,
+            claude: status.claude?.path ?? "skipped",
+            codex: status.codex?.path ?? "skipped",
+            opencode: status.opencode?.path ?? "skipped",
+        }),
+        renderHelp([
+            "Start a new agent session to pick them up",
+            "Run `xcodebuild-axi setup hooks --status` to verify",
+            "Run `xcodebuild-axi setup hooks --uninstall` to remove them",
+        ]),
+    ]);
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/commands/setup.js.map

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

package/dist/src/commands/sim.d.ts

@@ -0,0 +1,2 @@
+export declare const SIM_HELP = "usage: xcodebuild-axi sim [list|boot|shutdown|erase] [name|udid] [flags]\nInspects and drives simulators. With no subcommand, lists the booted ones.\nsubcommands[4]:\n  list                 every available simulator\n  boot <name|udid>     boot one, or no-op if it is already booted\n  shutdown <name|udid> shut one down, or no-op if it already is; --all for every booted one\n  erase <name|udid>    erase one back to factory state; --all for every shut-down one\nflags[3]:\n  --runtime <name>     filter the list, e.g. \"iOS 26.5\"\n  --booted             list only booted simulators\n  --all                apply shutdown or erase to every eligible simulator\nexamples:\n  xcodebuild-axi sim\n  xcodebuild-axi sim list --runtime \"iOS 26.5\"\n  xcodebuild-axi sim boot \"iPhone 17 Pro\"\n  xcodebuild-axi sim shutdown --all\n";
+export declare function simCommand(args: string[]): Promise<string>;

package/dist/src/commands/sim.js

@@ -0,0 +1,187 @@
+import { AxiError } from "../errors.js";
+import { findSimulator, listSimulators, simctl, } from "../simctl.js";
+import { renderFields, renderHelp, renderList, renderOutput } from "../toon.js";
+import { getFlag, hasFlag, positionals, rejectUnknownFlags } from "../args.js";
+export const SIM_HELP = `usage: xcodebuild-axi sim [list|boot|shutdown|erase] [name|udid] [flags]
+Inspects and drives simulators. With no subcommand, lists the booted ones.
+subcommands[4]:
+  list                 every available simulator
+  boot <name|udid>     boot one, or no-op if it is already booted
+  shutdown <name|udid> shut one down, or no-op if it already is; --all for every booted one
+  erase <name|udid>    erase one back to factory state; --all for every shut-down one
+flags[3]:
+  --runtime <name>     filter the list, e.g. "iOS 26.5"
+  --booted             list only booted simulators
+  --all                apply shutdown or erase to every eligible simulator
+examples:
+  xcodebuild-axi sim
+  xcodebuild-axi sim list --runtime "iOS 26.5"
+  xcodebuild-axi sim boot "iPhone 17 Pro"
+  xcodebuild-axi sim shutdown --all
+`;
+const FLAGS = ["--runtime", "--booted", "--all"];
+export async function simCommand(args) {
+    rejectUnknownFlags(args, "sim", FLAGS, ["--runtime"]);
+    const [subcommand, target] = positionals(args, ["--runtime"]);
+    switch (subcommand ?? "booted") {
+        case "booted":
+            return listBooted();
+        case "list":
+            return listAll(args);
+        case "boot":
+            return boot(target);
+        case "shutdown":
+            return shutdown(args, target);
+        case "erase":
+            return erase(args, target);
+        default:
+            throw new AxiError(`Unknown sim subcommand '${subcommand}'`, "VALIDATION_ERROR", ["valid subcommands are list, boot, shutdown, erase"]);
+    }
+}
+function toRows(simulators) {
+    return simulators.map((simulator) => ({
+        name: simulator.name,
+        runtime: simulator.runtime,
+        state: simulator.state,
+        udid: simulator.udid,
+    }));
+}
+/** The no-subcommand view: what is running right now, which is the thing that costs money. */
+async function listBooted() {
+    const booted = (await listSimulators()).filter((simulator) => simulator.state === "booted");
+    if (booted.length === 0) {
+        return renderOutput([
+            renderFields({ booted: "0 simulators running" }),
+            renderHelp([
+                'Run `xcodebuild-axi sim boot "<name>"` to start one',
+                "Run `xcodebuild-axi sim list` to see what is available",
+            ]),
+        ]);
+    }
+    return renderOutput([
+        renderList("booted", toRows(booted)),
+        renderHelp(["Run `xcodebuild-axi sim shutdown --all` to stop them"]),
+    ]);
+}
+async function listAll(args) {
+    const runtime = getFlag(args, "--runtime")?.toLowerCase();
+    let simulators = await listSimulators();
+    if (runtime) {
+        simulators = simulators.filter((simulator) => simulator.runtime.toLowerCase().includes(runtime));
+    }
+    if (hasFlag(args, "--booted")) {
+        simulators = simulators.filter((simulator) => simulator.state === "booted");
+    }
+    if (simulators.length === 0) {
+        return renderOutput([
+            renderFields({
+                simulators: runtime
+                    ? `0 simulators match runtime '${runtime}'`
+                    : "0 simulators available",
+            }),
+            renderHelp(["Install a runtime in Xcode > Settings > Components"]),
+        ]);
+    }
+    const booted = simulators.filter((simulator) => simulator.state === "booted").length;
+    return renderOutput([
+        renderFields({ count: simulators.length, booted }),
+        renderList("simulators", toRows(simulators)),
+        renderHelp(['Run `xcodebuild-axi sim boot "<name>"` to start one']),
+    ]);
+}
+async function resolveTarget(target, verb) {
+    if (target === undefined) {
+        throw new AxiError(`sim ${verb} needs a simulator name or udid`, "VALIDATION_ERROR", [
+            `xcodebuild-axi sim ${verb} "iPhone 17 Pro"`,
+            "Run `xcodebuild-axi sim list` to see the names",
+        ]);
+    }
+    const simulators = await listSimulators();
+    const found = findSimulator(simulators, target);
+    if (!found) {
+        const names = [
+            ...new Set(simulators.map((simulator) => simulator.name)),
+        ].slice(0, 12);
+        throw new AxiError(`No simulator matching '${target}'`, "SIMULATOR_NOT_FOUND", [`available: ${names.join(", ")}`]);
+    }
+    return found;
+}
+// Mutations are idempotent: booting a booted simulator is the state the agent
+// asked for, so it is a no-op at exit 0, not an error (AXI principle 6).
+async function boot(target) {
+    const simulator = await resolveTarget(target, "boot");
+    if (simulator.state === "booted") {
+        return renderFields({
+            sim: `${simulator.name} already booted (no-op)`,
+            udid: simulator.udid,
+        });
+    }
+    const { exitCode, stderr } = await simctl(["boot", simulator.udid]);
+    if (exitCode !== 0 && !/current state: Booted/i.test(stderr)) {
+        throw new AxiError(`Could not boot ${simulator.name}`, "UNKNOWN", [
+            firstLine(stderr),
+        ]);
+    }
+    return renderOutput([
+        renderFields({
+            sim: `${simulator.name} booted`,
+            runtime: simulator.runtime,
+            udid: simulator.udid,
+        }),
+        renderHelp([
+            `Run \`xcodebuild-axi test --device "${simulator.name}"\` to test on it`,
+        ]),
+    ]);
+}
+async function shutdown(args, target) {
+    if (hasFlag(args, "--all")) {
+        const booted = (await listSimulators()).filter((simulator) => simulator.state === "booted");
+        if (booted.length === 0) {
+            return renderFields({ sim: "0 simulators were running (no-op)" });
+        }
+        await simctl(["shutdown", "all"]);
+        return renderFields({
+            sim: `${booted.length} shut down`,
+            names: booted.map((s) => s.name),
+        });
+    }
+    const simulator = await resolveTarget(target, "shutdown");
+    if (simulator.state !== "booted") {
+        return renderFields({ sim: `${simulator.name} already shut down (no-op)` });
+    }
+    const { exitCode, stderr } = await simctl(["shutdown", simulator.udid]);
+    if (exitCode !== 0 && !/current state: Shutdown/i.test(stderr)) {
+        throw new AxiError(`Could not shut down ${simulator.name}`, "UNKNOWN", [
+            firstLine(stderr),
+        ]);
+    }
+    return renderFields({ sim: `${simulator.name} shut down` });
+}
+async function erase(args, target) {
+    if (hasFlag(args, "--all")) {
+        const { exitCode, stderr } = await simctl(["erase", "all"]);
+        if (exitCode !== 0) {
+            throw new AxiError("Could not erase all simulators", "UNKNOWN", [
+                firstLine(stderr),
+            ]);
+        }
+        return renderFields({ sim: "all shut-down simulators erased" });
+    }
+    const simulator = await resolveTarget(target, "erase");
+    const { exitCode, stderr } = await simctl(["erase", simulator.udid]);
+    if (exitCode !== 0) {
+        // simctl refuses to erase a running device; that is a real precondition,
+        // so name the command that satisfies it.
+        if (/Unable to erase.*booted|current state: Booted/i.test(stderr)) {
+            throw new AxiError(`${simulator.name} is booted, so it cannot be erased`, "VALIDATION_ERROR", [`Run \`xcodebuild-axi sim shutdown "${simulator.name}"\` first`]);
+        }
+        throw new AxiError(`Could not erase ${simulator.name}`, "UNKNOWN", [
+            firstLine(stderr),
+        ]);
+    }
+    return renderFields({ sim: `${simulator.name} erased` });
+}
+function firstLine(text) {
+    return text.trim().split("\n")[0] ?? "";
+}
+//# sourceMappingURL=sim.js.map

package/dist/src/commands/sim.js.map

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

package/dist/src/commands/test.d.ts

@@ -0,0 +1,2 @@
+export declare const TEST_HELP = "usage: xcodebuild-axi test [flags]\nRuns a scheme's tests and reports the counts plus only the failures.\nflags[66]:\n  --scheme <name>         scheme to act on (required only when the project has more than one)\n  --target <name>         build a target instead of a scheme; repeatable (project only)\n  --all-targets           build every target in the project (project only)\n  --device <name>         simulator or device name, e.g. \"iPhone 17 Pro\" (default: newest simulator)\n  --destination <spec>    raw xcodebuild destination specifier, passed through untouched\n  --configuration <name>  build configuration (default: the scheme's own)\n  --sdk <name>            base SDK, e.g. iphonesimulator\n  --arch <arch>           architecture to build; repeatable or comma-separated\n  --toolchain <name>      toolchain identifier or name\n  --xcconfig <path>       apply build settings from this file as overrides\n  --derived-data <path>   derived data directory\n  --jobs <n>              maximum concurrent build operations\n  --setting KEY=VALUE     build setting override; repeatable or comma-separated\n  --sign                  allow code signing (off by default, so simulator builds need no team)\n  --allow-provisioning    let xcodebuild talk to the developer portal for profiles\n  --sanitizer <name>      address, thread, or undefined; repeatable or comma-separated\n  --timing                report per-command build timings\n  --destination-timeout <secs>  how long to wait for the destination device\n  --parallelize-targets   build independent targets in parallel\n  --hide-script-env       omit shell script environment variables from the log\n  --skip-unavailable-actions  skip scheme actions that cannot run instead of failing\n  --max-errors <n>        errors to list before summarizing the rest (default: 20)\n  --full                  list every warning instead of the first 10\n  --codesize <dir>        write a code size profile to this directory\n  --log-level <level>     quiet, normal, or verbose \u2014 how much lands in the log file\n  --bundle-version <n>    result bundle format version (default: xcodebuild's own)\n  --stream <path>         also write xcodebuild's live result stream here\n  --offline               resolve using only the versions already in Package.resolved\n  --cache <path>          clone remote packages into this directory\n  --package-cache <path>  shared package cache directory (across projects)\n  --no-auto-resolve       never resolve automatically; fail if Package.resolved is stale\n  --skip-package-updates  use the packages already cloned, without checking for updates\n  --no-package-cache      ignore the shared package repository cache\n  --skip-plugin-validation      trust build plugins without prompting\n  --skip-signature-validation   do not verify package signatures\n  --package-auth <kind>   keychain or netrc\n  --registry-url <url>    default package registry\n  --scm-to-registry <kind>      none, identity, or swift-package-registry\n  --fingerprint-policy <kind>   strict or warn\n  --signing-entity-policy <kind>  strict or warn\n  --scm-provider <kind>   system or xcode\n  --test-plan <name>     test plan to run\n  --only <id>            run only this test/class/target; repeatable or comma-separated\n  --skip <id>            skip this test/class/target; repeatable or comma-separated\n  --coverage             collect code coverage and report the overall percentage\n  --without-building     test already-built products (test-without-building)\n  --xctestrun <path>     test from an .xctestrun file instead of a scheme\n  --parallel <n>         exact number of parallel test runners\n  --no-parallel          disable parallel testing\n  --iterations <n>       run the tests this many times\n  --retry                retry failures, up to --iterations (default 3)\n  --until-failure        repeat until something fails, up to --iterations (default 100)\n  --language <iso639>    run in this language\n  --region <iso3166>     run in this region\n  --diagnostics          collect verbose diagnostics on failure\n  --perf-diagnostics     collect performance traces and memgraphs for performance tests\n  --relaunch             relaunch the process between repetitions\n  --only-configuration <name>  run only this test configuration; repeatable\n  --skip-configuration <name>  skip this test configuration; repeatable\n  --max-workers <n>      cap on parallel test runners\n  --max-sim-destinations <n>   cap on simulator destinations tested concurrently\n  --max-device-destinations <n>  cap on device destinations tested concurrently\n  --default-test-timeout <secs>  default per-test allowance when timeouts are on\n  --test-products <path>  where to find the built test products\n  --test-timeout <secs>  per-test execution allowance (default: 300, 0 disables)\n  --max-failures <n>     failures to list before summarizing the rest (default: 20)\nexit:\n  0 all tests passed, 1 a test or the build failed, 2 usage error\nexamples:\n  xcodebuild-axi test\n  xcodebuild-axi test --scheme MyApp --device \"iPhone 17 Pro\"\n  xcodebuild-axi test --scheme MyApp --only MyAppTests/CheckoutTests\n  xcodebuild-axi test --scheme MyApp --coverage\n";
+export declare function testCommand(args: string[]): Promise<string>;