xcodebuild-axi 0.1.0

package/dist/src/commands/test.js

@@ -0,0 +1,317 @@
+import { AxiError, mapXcodebuildError } from "../errors.js";
+import { BUILD_FLAG_HELP, resolveBuildContext, runAction, SHARED_BUILD_FLAGS, SHARED_BUILD_VALUE_FLAGS, } from "../action.js";
+import { readBuildResults, readTestSummary, toDiagnostics, describeDevice, } from "../xcresult.js";
+import { readCoverage, percent } from "../xccov.js";
+import { diagnosticsBlock, transcriptTail } from "../report.js";
+import { duration, renderFields, renderHelp, renderList, renderOutput, tildePath, truncate, } from "../toon.js";
+import { getFlag, getIntFlag, getListFlag, hasFlag, rejectUnknownFlags, } from "../args.js";
+export const TEST_HELP = `usage: xcodebuild-axi test [flags]
+Runs a scheme's tests and reports the counts plus only the failures.
+flags[66]:
+${BUILD_FLAG_HELP}
+  --test-plan <name>     test plan to run
+  --only <id>            run only this test/class/target; repeatable or comma-separated
+  --skip <id>            skip this test/class/target; repeatable or comma-separated
+  --coverage             collect code coverage and report the overall percentage
+  --without-building     test already-built products (test-without-building)
+  --xctestrun <path>     test from an .xctestrun file instead of a scheme
+  --parallel <n>         exact number of parallel test runners
+  --no-parallel          disable parallel testing
+  --iterations <n>       run the tests this many times
+  --retry                retry failures, up to --iterations (default 3)
+  --until-failure        repeat until something fails, up to --iterations (default 100)
+  --language <iso639>    run in this language
+  --region <iso3166>     run in this region
+  --diagnostics          collect verbose diagnostics on failure
+  --perf-diagnostics     collect performance traces and memgraphs for performance tests
+  --relaunch             relaunch the process between repetitions
+  --only-configuration <name>  run only this test configuration; repeatable
+  --skip-configuration <name>  skip this test configuration; repeatable
+  --max-workers <n>      cap on parallel test runners
+  --max-sim-destinations <n>   cap on simulator destinations tested concurrently
+  --max-device-destinations <n>  cap on device destinations tested concurrently
+  --default-test-timeout <secs>  default per-test allowance when timeouts are on
+  --test-products <path>  where to find the built test products
+  --test-timeout <secs>  per-test execution allowance (default: 300, 0 disables)
+  --max-failures <n>     failures to list before summarizing the rest (default: 20)
+exit:
+  0 all tests passed, 1 a test or the build failed, 2 usage error
+examples:
+  xcodebuild-axi test
+  xcodebuild-axi test --scheme MyApp --device "iPhone 17 Pro"
+  xcodebuild-axi test --scheme MyApp --only MyAppTests/CheckoutTests
+  xcodebuild-axi test --scheme MyApp --coverage
+`;
+const FLAGS = [
+    ...SHARED_BUILD_FLAGS,
+    "--test-plan",
+    "--only",
+    "--skip",
+    "--coverage",
+    "--without-building",
+    "--xctestrun",
+    "--parallel",
+    "--no-parallel",
+    "--iterations",
+    "--retry",
+    "--until-failure",
+    "--language",
+    "--region",
+    "--diagnostics",
+    "--perf-diagnostics",
+    "--relaunch",
+    "--only-configuration",
+    "--skip-configuration",
+    "--max-workers",
+    "--max-sim-destinations",
+    "--max-device-destinations",
+    "--default-test-timeout",
+    "--test-products",
+    "--test-timeout",
+    "--max-failures",
+];
+const VALUE_FLAGS = [
+    ...SHARED_BUILD_VALUE_FLAGS,
+    "--test-plan",
+    "--only",
+    "--skip",
+    "--xctestrun",
+    "--parallel",
+    "--iterations",
+    "--language",
+    "--region",
+    "--only-configuration",
+    "--skip-configuration",
+    "--max-workers",
+    "--max-sim-destinations",
+    "--max-device-destinations",
+    "--default-test-timeout",
+    "--test-products",
+    "--test-timeout",
+    "--max-failures",
+];
+export async function testCommand(args) {
+    rejectUnknownFlags(args, "test", FLAGS, VALUE_FLAGS);
+    if (hasFlag(args, "--retry") && hasFlag(args, "--until-failure")) {
+        // xcodebuild rejects this combination itself, but only after building.
+        throw new AxiError("--retry and --until-failure cannot be used together", "VALIDATION_ERROR", [
+            "--retry stops at the first success, --until-failure stops at the first failure",
+        ]);
+    }
+    const withoutBuilding = hasFlag(args, "--without-building") ||
+        getFlag(args, "--xctestrun") !== undefined;
+    const context = await resolveBuildContext({ args, command: "test" });
+    const coverage = hasFlag(args, "--coverage");
+    const run = await runAction({
+        context,
+        command: "test",
+        actions: [withoutBuilding ? "test-without-building" : "test"],
+        extraArgs: testArgs(args, coverage),
+    });
+    const summary = await readTestSummary(run.resultPath).catch(() => undefined);
+    // No test summary on a nonzero exit means the tests never ran — the build
+    // under them failed, or xcodebuild refused the invocation. Report that as a
+    // build failure rather than "0 tests", which reads like a passing run.
+    if (!summary || summary.totalTestCount === undefined) {
+        return renderTestsNeverRan(context, run);
+    }
+    return renderTestSummary({
+        context,
+        summary,
+        run,
+        maxFailures: getIntFlag(args, "--max-failures") ?? 20,
+        full: context.full,
+        coverage,
+    });
+}
+function testArgs(args, coverage) {
+    const testPlan = getFlag(args, "--test-plan");
+    const xctestrun = getFlag(args, "--xctestrun");
+    const timeout = getIntFlag(args, "--test-timeout") ?? 300;
+    const iterations = getIntFlag(args, "--iterations");
+    const parallel = getIntFlag(args, "--parallel");
+    const language = getFlag(args, "--language");
+    const region = getFlag(args, "--region");
+    const maxWorkers = getIntFlag(args, "--max-workers");
+    const maxSimDestinations = getIntFlag(args, "--max-sim-destinations");
+    const maxDeviceDestinations = getIntFlag(args, "--max-device-destinations");
+    const defaultTimeout = getIntFlag(args, "--default-test-timeout");
+    const testProducts = getFlag(args, "--test-products");
+    return [
+        ...(xctestrun ? ["-xctestrun", xctestrun] : []),
+        ...(testPlan ? ["-testPlan", testPlan] : []),
+        ...getListFlag(args, "--only").flatMap((id) => ["-only-testing", id]),
+        ...getListFlag(args, "--skip").flatMap((id) => ["-skip-testing", id]),
+        ...(coverage ? ["-enableCodeCoverage", "YES"] : []),
+        ...(parallel !== undefined
+            ? [
+                "-parallel-testing-enabled",
+                "YES",
+                "-parallel-testing-worker-count",
+                String(parallel),
+            ]
+            : []),
+        ...(hasFlag(args, "--no-parallel")
+            ? ["-parallel-testing-enabled", "NO"]
+            : []),
+        ...(iterations !== undefined
+            ? ["-test-iterations", String(iterations)]
+            : []),
+        ...(hasFlag(args, "--retry") ? ["-retry-tests-on-failure"] : []),
+        ...(hasFlag(args, "--until-failure") ? ["-run-tests-until-failure"] : []),
+        ...(language ? ["-testLanguage", language] : []),
+        ...(region ? ["-testRegion", region] : []),
+        ...(hasFlag(args, "--diagnostics")
+            ? ["-collect-test-diagnostics", "on-failure"]
+            : []),
+        ...(hasFlag(args, "--perf-diagnostics")
+            ? ["-enablePerformanceTestsDiagnostics", "YES"]
+            : []),
+        ...(hasFlag(args, "--relaunch")
+            ? ["-test-repetition-relaunch-enabled", "YES"]
+            : []),
+        ...getListFlag(args, "--only-configuration").flatMap((name) => [
+            "-only-test-configuration",
+            name,
+        ]),
+        ...getListFlag(args, "--skip-configuration").flatMap((name) => [
+            "-skip-test-configuration",
+            name,
+        ]),
+        ...(maxWorkers !== undefined
+            ? ["-maximum-parallel-testing-workers", String(maxWorkers)]
+            : []),
+        ...(maxSimDestinations !== undefined
+            ? [
+                "-maximum-concurrent-test-simulator-destinations",
+                String(maxSimDestinations),
+            ]
+            : []),
+        ...(maxDeviceDestinations !== undefined
+            ? [
+                "-maximum-concurrent-test-device-destinations",
+                String(maxDeviceDestinations),
+            ]
+            : []),
+        ...(defaultTimeout !== undefined
+            ? ["-default-test-execution-time-allowance", String(defaultTimeout)]
+            : []),
+        ...(testProducts ? ["-testProductsPath", testProducts] : []),
+        // A wedged test otherwise runs until the caller's own timeout kills it,
+        // with nothing in the output saying which one hung.
+        ...(timeout > 0
+            ? [
+                "-test-timeouts-enabled",
+                "YES",
+                "-maximum-test-execution-time-allowance",
+                String(timeout),
+            ]
+            : []),
+    ];
+}
+async function renderTestsNeverRan(context, run) {
+    const results = await readBuildResults(run.resultPath).catch(() => undefined);
+    const errors = toDiagnostics(results?.errors);
+    if (errors.length === 0) {
+        const mapped = mapXcodebuildError(run.tail);
+        if (mapped) {
+            throw new AxiError(mapped.message, mapped.code, [
+                ...mapped.suggestions,
+                `full transcript: ${tildePath(run.logPath)}`,
+            ]);
+        }
+    }
+    const blocks = [
+        renderFields({
+            test: "failed",
+            reason: "the build failed, so no test ran",
+            scheme: context.scheme,
+            ...(context.destination ? { destination: context.destination } : {}),
+            duration: duration(run.seconds),
+        }),
+    ];
+    const errorBlock = diagnosticsBlock("errors", errors, context.maxErrors);
+    if (errorBlock.block) {
+        blocks.push(errorBlock.block);
+    }
+    else {
+        const tail = transcriptTail(run.tail);
+        if (tail)
+            blocks.push(tail);
+    }
+    blocks.push(renderFields({
+        log: tildePath(run.logPath),
+        result: tildePath(run.resultPath),
+    }));
+    process.exitCode = 1;
+    return renderOutput(blocks);
+}
+async function renderTestSummary(options) {
+    const { summary, run, context } = options;
+    const failed = summary.failedTests ?? 0;
+    const passed = summary.passedTests ?? 0;
+    const skipped = summary.skippedTests ?? 0;
+    const succeeded = run.exitCode === 0 && failed === 0;
+    // Report the destination the run actually landed on, not the one requested:
+    // a name-based specifier can resolve to a different runtime than expected,
+    // and a pass on the wrong OS is a pass the agent should not trust.
+    const device = summary.devicesAndConfigurations?.[0]?.device;
+    const landed = device
+        ? describeDevice(device)
+        : (context.destination ?? "unknown");
+    const coverageReport = options.coverage
+        ? await readCoverage(run.resultPath).catch(() => undefined)
+        : undefined;
+    const blocks = [
+        renderFields({
+            test: succeeded ? "passed" : "failed",
+            scheme: context.scheme,
+            destination: landed,
+            // Slash-separated, not comma-separated: TOON quotes any scalar
+            // containing a comma, and the quotes cost more than the commas saved.
+            tests: `${passed} passed / ${failed} failed / ${skipped} skipped`,
+            duration: duration(run.seconds),
+            ...(coverageReport
+                ? { coverage: percent(coverageReport.lineCoverage) }
+                : {}),
+        }),
+    ];
+    const failures = summary.testFailures ?? [];
+    if (failures.length > 0) {
+        const shown = failures.slice(0, options.maxFailures).map((failure) => ({
+            test: failure.testIdentifierString ?? failure.testName ?? "unknown",
+            target: failure.targetName ?? "",
+            message: options.full
+                ? (failure.failureText ?? "").replace(/\s+/g, " ").trim()
+                : truncate((failure.failureText ?? "").replace(/\s+/g, " ").trim(), 300)
+                    .text,
+        }));
+        blocks.push(renderList(failures.length > shown.length
+            ? `failures (${shown.length} of ${failures.length})`
+            : "failures", shown));
+    }
+    const runtimeWarnings = summary.runtimeWarnings ?? [];
+    if (runtimeWarnings.length > 0) {
+        blocks.push(renderFields({ runtime_warnings: runtimeWarnings.length }));
+    }
+    blocks.push(renderFields({
+        log: tildePath(run.logPath),
+        result: tildePath(run.resultPath),
+    }));
+    const hints = [];
+    if (failures.length > 0) {
+        const first = failures[0]?.testIdentifierString;
+        if (first) {
+            hints.push(`Run \`xcodebuild-axi test --only ${first}\` to re-run just this failure`);
+        }
+        hints.push(`Run \`xcodebuild-axi result ${tildePath(run.resultPath)} --failures --full\` for untruncated failure text`);
+    }
+    if (coverageReport) {
+        hints.push(`Run \`xcodebuild-axi coverage ${tildePath(run.resultPath)} --below 50\` for the files that need tests`);
+    }
+    blocks.push(renderHelp(hints));
+    if (!succeeded)
+        process.exitCode = 1;
+    return renderOutput(blocks);
+}
+//# sourceMappingURL=test.js.map

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

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

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

@@ -0,0 +1,8 @@
+export declare const TESTPLANS_HELP = "usage: xcodebuild-axi testplans [flags]\nLists the test plans a scheme is configured with.\nflags[1]:\n  --scheme <name>  scheme to inspect (required only when the project has more than one)\nexamples:\n  xcodebuild-axi testplans\n  xcodebuild-axi testplans --scheme MyApp\n";
+export declare function testplansCommand(args: string[]): Promise<string>;
+/**
+ * `-showTestPlans` prints a prose heading and then one indented plan per line.
+ * The first plan is the scheme's default, which xcodebuild does not mark, so
+ * neither do we rather than guess.
+ */
+export declare function parseTestPlans(output: string): string[];

package/dist/src/commands/testplans.js

@@ -0,0 +1,75 @@
+import { requireProject } from "../context.js";
+import { requireScheme } from "../scheme.js";
+import { runMetadata, stripPreamble } from "../xcodebuild.js";
+import { renderFields, renderHelp, renderOutput } from "../toon.js";
+import { getFlag, rejectUnknownFlags } from "../args.js";
+export const TESTPLANS_HELP = `usage: xcodebuild-axi testplans [flags]
+Lists the test plans a scheme is configured with.
+flags[1]:
+  --scheme <name>  scheme to inspect (required only when the project has more than one)
+examples:
+  xcodebuild-axi testplans
+  xcodebuild-axi testplans --scheme MyApp
+`;
+export async function testplansCommand(args) {
+    rejectUnknownFlags(args, "testplans", ["--scheme"], ["--scheme"]);
+    const project = requireProject();
+    const scheme = await requireScheme(project, getFlag(args, "--scheme"), "testplans");
+    const { stdout, stderr } = await runMetadata([
+        ...project.flags,
+        "-scheme",
+        scheme,
+        "-showTestPlans",
+    ]);
+    const output = stripPreamble(`${stdout}\n${stderr}`);
+    // A scheme without test plans is a normal, common configuration — not a
+    // failure. Say so in the scheme's own words so the agent stops looking.
+    if (/not configured to use test plans/i.test(output)) {
+        return renderOutput([
+            renderFields({
+                scheme,
+                testplans: "none — this scheme does not use test plans",
+            }),
+            renderHelp([
+                `Run \`xcodebuild-axi test --scheme ${scheme}\` to run its tests directly`,
+            ]),
+        ]);
+    }
+    const plans = parseTestPlans(output);
+    if (plans.length === 0) {
+        return renderOutput([
+            renderFields({ scheme, testplans: "0 test plans found" }),
+        ]);
+    }
+    return renderOutput([
+        renderFields({ scheme, testplans: plans }),
+        renderHelp([
+            `Run \`xcodebuild-axi test --scheme ${scheme} --test-plan <name>\` to run one`,
+        ]),
+    ]);
+}
+/**
+ * `-showTestPlans` prints a prose heading and then one indented plan per line.
+ * The first plan is the scheme's default, which xcodebuild does not mark, so
+ * neither do we rather than guess.
+ */
+export function parseTestPlans(output) {
+    const plans = [];
+    let inList = false;
+    for (const line of output.split("\n")) {
+        if (/Test plans? associated with the ".*" scheme:/i.test(line)) {
+            inList = true;
+            continue;
+        }
+        if (!inList)
+            continue;
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        if (!/^\s/.test(line))
+            break;
+        plans.push(trimmed);
+    }
+    return plans;
+}
+//# sourceMappingURL=testplans.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testplans.js","sourceRoot":"","sources":["../../../src/commands/testplans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;CAO7B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,OAAO,EACP,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,EACzB,WAAW,CACZ,CAAC;IAEF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC;QAC3C,GAAG,OAAO,CAAC,KAAK;QAChB,SAAS;QACT,MAAM;QACN,gBAAgB;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;IAErD,wEAAwE;IACxE,wEAAwE;IACxE,IAAI,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,YAAY,CAAC;YAClB,YAAY,CAAC;gBACX,MAAM;gBACN,SAAS,EAAE,4CAA4C;aACxD,CAAC;YACF,UAAU,CAAC;gBACT,sCAAsC,MAAM,8BAA8B;aAC3E,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;YAClB,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC1C,UAAU,CAAC;YACT,sCAAsC,MAAM,kCAAkC;SAC/E,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,+CAA+C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,13 @@
+export declare const TESTS_HELP = "usage: xcodebuild-axi tests [flags]\nLists the tests a scheme would run, without running them. Grouped by suite,\nbecause a thousand identifiers is not an answer.\nflags[45]:\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 enumerate\n  --filter <text>     only suites or tests whose identifier contains this\n  --list              print every test identifier instead of per-suite counts\n  --max <n>           rows to list before summarizing the rest (default: 40)\nnote:\n  Enumerating compiles the test bundle, so the first run is as slow as a build.\n  It is still far cheaper than running the tests to find out what they are.\nexamples:\n  xcodebuild-axi tests --scheme MyApp\n  xcodebuild-axi tests --scheme MyApp --filter AppFeature --list\n";
+export declare function testsCommand(args: string[]): Promise<string>;
+/**
+ * Collapse `Target/Suite/testName()` identifiers into one row per suite.
+ *
+ * A scheme with a thousand tests produces a thousand unreadable rows; the
+ * shape an agent needs to pick what to run is the suite and how big it is
+ * (AXI principle 2).
+ */
+export declare function groupBySuite(identifiers: string[]): {
+    suite: string;
+    tests: number;
+}[];

package/dist/src/commands/tests.js

@@ -0,0 +1,154 @@
+import { readFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { AxiError, mapXcodebuildError } from "../errors.js";
+import { BUILD_FLAG_HELP, resolveBuildContext, runAction, runLabel, SHARED_BUILD_FLAGS, SHARED_BUILD_VALUE_FLAGS, } from "../action.js";
+import { artifactDir } from "../xcodebuild.js";
+import { duration, renderFields, renderHelp, renderList, renderOutput, tildePath, } from "../toon.js";
+import { getFlag, getIntFlag, hasFlag, rejectUnknownFlags } from "../args.js";
+export const TESTS_HELP = `usage: xcodebuild-axi tests [flags]
+Lists the tests a scheme would run, without running them. Grouped by suite,
+because a thousand identifiers is not an answer.
+flags[45]:
+${BUILD_FLAG_HELP}
+  --test-plan <name>  test plan to enumerate
+  --filter <text>     only suites or tests whose identifier contains this
+  --list              print every test identifier instead of per-suite counts
+  --max <n>           rows to list before summarizing the rest (default: 40)
+note:
+  Enumerating compiles the test bundle, so the first run is as slow as a build.
+  It is still far cheaper than running the tests to find out what they are.
+examples:
+  xcodebuild-axi tests --scheme MyApp
+  xcodebuild-axi tests --scheme MyApp --filter AppFeature --list
+`;
+const FLAGS = [
+    ...SHARED_BUILD_FLAGS,
+    "--test-plan",
+    "--filter",
+    "--list",
+    "--max",
+];
+const VALUE_FLAGS = [
+    ...SHARED_BUILD_VALUE_FLAGS,
+    "--test-plan",
+    "--filter",
+    "--max",
+];
+export async function testsCommand(args) {
+    rejectUnknownFlags(args, "tests", FLAGS, VALUE_FLAGS);
+    const context = await resolveBuildContext({ args, command: "tests" });
+    const outputPath = join(artifactDir(context.project), `${runLabel(context, "tests")}.json`);
+    const testPlan = getFlag(args, "--test-plan");
+    // xcodebuild appends to an existing enumeration file rather than replacing
+    // it, so a stale one from a previous scheme would silently pad the list.
+    rmSync(outputPath, { force: true });
+    const run = await runAction({
+        context,
+        command: "tests",
+        // -enumerate-tests only takes effect alongside the `test` action; without
+        // it xcodebuild builds for testing and writes no enumeration at all.
+        actions: ["test"],
+        extraArgs: [
+            ...(testPlan ? ["-testPlan", testPlan] : []),
+            "-enumerate-tests",
+            "-test-enumeration-format",
+            "json",
+            "-test-enumeration-style",
+            "flat",
+            "-test-enumeration-output-path",
+            outputPath,
+        ],
+    });
+    const parsed = readEnumeration(outputPath);
+    if (!parsed) {
+        const mapped = mapXcodebuildError(run.tail);
+        throw new AxiError(mapped?.message ?? "xcodebuild enumerated no tests", mapped?.code ?? "UNKNOWN", [
+            ...(mapped?.suggestions ?? []),
+            `full transcript: ${tildePath(run.logPath)}`,
+        ]);
+    }
+    const filter = getFlag(args, "--filter")?.toLowerCase();
+    const max = getIntFlag(args, "--max") ?? 40;
+    const all = (parsed.values ?? []).flatMap((value) => value.enabledTests ?? []);
+    const disabled = (parsed.values ?? []).flatMap((value) => value.disabledTests ?? []);
+    let identifiers = all
+        .map((test) => test.identifier)
+        .filter((identifier) => identifier !== undefined);
+    if (filter) {
+        identifiers = identifiers.filter((identifier) => identifier.toLowerCase().includes(filter));
+    }
+    if (identifiers.length === 0) {
+        return renderOutput([
+            renderFields({
+                tests: filter
+                    ? `0 tests match '${getFlag(args, "--filter")}' in scheme ${context.scheme}`
+                    : `0 tests in scheme ${context.scheme}`,
+            }),
+            renderHelp([
+                "Run `xcodebuild-axi tests` without --filter to see every suite",
+            ]),
+        ]);
+    }
+    const blocks = [
+        renderFields({
+            scheme: context.scheme,
+            tests: identifiers.length,
+            ...(disabled.length > 0 ? { disabled: disabled.length } : {}),
+            duration: duration(run.seconds),
+        }),
+    ];
+    if (hasFlag(args, "--list")) {
+        const shown = identifiers
+            .slice(0, max)
+            .map((identifier) => ({ test: identifier }));
+        blocks.push(renderList(identifiers.length > shown.length
+            ? `test_list (${shown.length} of ${identifiers.length})`
+            : "test_list", shown));
+        if (identifiers.length > shown.length) {
+            blocks.push(renderHelp([
+                `Run \`xcodebuild-axi tests --list --max ${identifiers.length}\` for all of them`,
+            ]));
+        }
+    }
+    else {
+        const suites = groupBySuite(identifiers);
+        const shown = suites.slice(0, max);
+        blocks.push(renderList(suites.length > shown.length
+            ? `suites (${shown.length} of ${suites.length})`
+            : "suites", shown));
+        blocks.push(renderHelp([
+            "Run `xcodebuild-axi tests --list` to see individual test identifiers",
+            `Run \`xcodebuild-axi test --scheme ${context.scheme} --only <suite>\` to run one suite`,
+        ]));
+    }
+    return renderOutput(blocks);
+}
+/**
+ * Collapse `Target/Suite/testName()` identifiers into one row per suite.
+ *
+ * A scheme with a thousand tests produces a thousand unreadable rows; the
+ * shape an agent needs to pick what to run is the suite and how big it is
+ * (AXI principle 2).
+ */
+export function groupBySuite(identifiers) {
+    const counts = new Map();
+    for (const identifier of identifiers) {
+        const parts = identifier.split("/");
+        // Drop the test method, keeping target and suite. A two-part identifier
+        // is already suite-level, so it stands for itself.
+        const suite = parts.length > 2 ? parts.slice(0, -1).join("/") : identifier;
+        counts.set(suite, (counts.get(suite) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .map(([suite, tests]) => ({ suite, tests }))
+        .sort((a, b) => b.tests - a.tests || a.suite.localeCompare(b.suite));
+}
+function readEnumeration(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=tests.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const XCFRAMEWORK_HELP = "usage: xcodebuild-axi xcframework --output <path.xcframework> [flags]\nBundles prebuilt frameworks or libraries into one .xcframework.\nflags[4]:\n  --output <path>     the .xcframework to write (required)\n  --framework <path>  a built .framework to include; repeatable\n  --library <path>    a built static or dynamic library to include; repeatable\n  --headers <path>    headers for the library that precedes it; repeatable\nnote:\n  --headers applies to the --library it follows, which is how xcodebuild pairs\n  them. Give them in matching order.\nexamples:\n  xcodebuild-axi xcframework --output Out.xcframework --framework A.framework --framework B.framework\n  xcodebuild-axi xcframework --output Out.xcframework --library libA.a --headers include\n";
+export declare function xcframeworkCommand(args: string[]): Promise<string>;