xcodebuild-axi 0.1.0

package/dist/src/report.d.ts

@@ -0,0 +1,20 @@
+import type { Diagnostic } from "./xcresult.js";
+/**
+ * Render a capped list of diagnostics.
+ *
+ * Errors cascade: one bad protocol conformance can produce sixty lines that
+ * all name the same root cause, and printing all sixty is exactly the flood
+ * this tool exists to stop. The cap keeps the first N — which is where the
+ * cause almost always is — and says how many it withheld (AXI principles 3
+ * and 4), so the count is never silently wrong.
+ */
+export declare function diagnosticsBlock(label: string, diagnostics: Diagnostic[], limit: number, messageLimit?: number): {
+    block: string;
+    hidden: number;
+};
+/**
+ * The last lines of a transcript, for a failure the result bundle cannot
+ * explain — a wedged simulator, a signal, a timeout. Showing nothing here
+ * would be the quiet wrapper hiding the very failure it exists to surface.
+ */
+export declare function transcriptTail(tail: string, lines?: number): string;

package/dist/src/report.js

@@ -0,0 +1,39 @@
+import { renderList, truncate } from "./toon.js";
+/**
+ * Render a capped list of diagnostics.
+ *
+ * Errors cascade: one bad protocol conformance can produce sixty lines that
+ * all name the same root cause, and printing all sixty is exactly the flood
+ * this tool exists to stop. The cap keeps the first N — which is where the
+ * cause almost always is — and says how many it withheld (AXI principles 3
+ * and 4), so the count is never silently wrong.
+ */
+export function diagnosticsBlock(label, diagnostics, limit, messageLimit = 300) {
+    if (diagnostics.length === 0)
+        return { block: "", hidden: 0 };
+    const shown = diagnostics.slice(0, limit).map((diagnostic) => ({
+        file: diagnostic.file,
+        line: diagnostic.line,
+        col: diagnostic.col,
+        type: diagnostic.type,
+        message: truncate(diagnostic.message, messageLimit).text,
+    }));
+    const hidden = diagnostics.length - shown.length;
+    const heading = hidden > 0 ? `${label} (${shown.length} of ${diagnostics.length})` : label;
+    return { block: renderList(heading, shown), hidden };
+}
+/**
+ * The last lines of a transcript, for a failure the result bundle cannot
+ * explain — a wedged simulator, a signal, a timeout. Showing nothing here
+ * would be the quiet wrapper hiding the very failure it exists to surface.
+ */
+export function transcriptTail(tail, lines = 15) {
+    const kept = tail
+        .split("\n")
+        .filter((line) => line.trim().length > 0)
+        .slice(-lines);
+    if (kept.length === 0)
+        return "";
+    return `tail[${kept.length}]:\n${kept.map((line) => `  ${line}`).join("\n")}`;
+}
+//# sourceMappingURL=report.js.map

package/dist/src/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/report.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,WAAyB,EACzB,KAAa,EACb,YAAY,GAAG,GAAG;IAElB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAE9D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI;KACzD,CAAC,CAAC,CAAC;IAEJ,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACjD,MAAM,OAAO,GACX,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,KAAK,CAAC,MAAM,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IAE7E,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;IACrD,MAAM,IAAI,GAAG,IAAI;SACd,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACxC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,QAAQ,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/src/scheme.d.ts

@@ -0,0 +1,22 @@
+import type { ProjectContext } from "./context.js";
+export interface SchemeInfo {
+    name: string;
+    schemes: string[];
+    targets: string[];
+    configurations: string[];
+}
+/**
+ * `-list -json`, which unlike the plain form emits no package-graph preamble
+ * and no prose. Still worth going through `runMetadata` so a missing Xcode is
+ * reported as a structured error rather than an ENOENT stack.
+ */
+export declare function listSchemes(project: ProjectContext): Promise<SchemeInfo>;
+/**
+ * Resolve the scheme to act on.
+ *
+ * With one scheme there is nothing to ask about, so we use it — a required
+ * flag whose value can only be one thing is a wasted round trip. With several,
+ * refusing is right, but the refusal carries the list so the next call is
+ * correct rather than another lookup (AXI principle 6).
+ */
+export declare function requireScheme(project: ProjectContext, requested: string | undefined, command: string): Promise<string>;

package/dist/src/scheme.js

@@ -0,0 +1,66 @@
+import { AxiError } from "./errors.js";
+import { runMetadata } from "./xcodebuild.js";
+/**
+ * `-list -json`, which unlike the plain form emits no package-graph preamble
+ * and no prose. Still worth going through `runMetadata` so a missing Xcode is
+ * reported as a structured error rather than an ENOENT stack.
+ */
+export async function listSchemes(project) {
+    const { stdout, stderr, exitCode } = await runMetadata([
+        ...project.flags,
+        "-list",
+        "-json",
+    ]);
+    const start = stdout.indexOf("{");
+    if (start === -1) {
+        throw (mapListFailure(`${stdout}\n${stderr}`) ??
+            new AxiError(`xcodebuild could not read ${project.name} (exit ${exitCode})`, "NO_PROJECT"));
+    }
+    const parsed = JSON.parse(stdout.slice(start));
+    const container = parsed.workspace ?? parsed.project ?? {};
+    return {
+        name: container.name ?? project.name,
+        schemes: container.schemes ?? [],
+        targets: parsed.project?.targets ?? [],
+        configurations: parsed.project?.configurations ?? [],
+    };
+}
+function mapListFailure(output) {
+    if (/does not contain a scheme/.test(output))
+        return undefined;
+    const match = output.match(/xcodebuild: error: (.+)/);
+    return match?.[1] ? new AxiError(match[1].trim(), "NO_PROJECT") : undefined;
+}
+/**
+ * Resolve the scheme to act on.
+ *
+ * With one scheme there is nothing to ask about, so we use it — a required
+ * flag whose value can only be one thing is a wasted round trip. With several,
+ * refusing is right, but the refusal carries the list so the next call is
+ * correct rather than another lookup (AXI principle 6).
+ */
+export async function requireScheme(project, requested, command) {
+    const { schemes } = await listSchemes(project);
+    if (requested) {
+        if (schemes.length > 0 && !schemes.includes(requested)) {
+            const near = schemes.filter((s) => s.toLowerCase().includes(requested.toLowerCase()));
+            throw new AxiError(`No scheme named '${requested}' in ${project.name}`, "SCHEME_NOT_FOUND", near.length > 0
+                ? [`did you mean: ${near.join(", ")}`]
+                : [`schemes in ${project.name}: ${schemes.join(", ")}`]);
+        }
+        return requested;
+    }
+    const only = schemes[0];
+    if (schemes.length === 1 && only !== undefined)
+        return only;
+    if (schemes.length === 0) {
+        throw new AxiError(`${project.name} declares no shared schemes`, "SCHEME_NOT_FOUND", [
+            "Open the project in Xcode and mark a scheme as Shared, or pass `--scheme <name>`",
+        ]);
+    }
+    throw new AxiError(`${project.name} has ${schemes.length} schemes — pass --scheme`, "VALIDATION_ERROR", [
+        `xcodebuild-axi ${command} --scheme <name>`,
+        `schemes: ${schemes.join(", ")}`,
+    ]);
+}
+//# sourceMappingURL=scheme.js.map

package/dist/src/scheme.js.map

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

package/dist/src/simctl.d.ts

@@ -0,0 +1,33 @@
+export interface Simulator {
+    udid: string;
+    name: string;
+    state: string;
+    runtime: string;
+    isAvailable: boolean;
+}
+export declare function simctl(args: string[]): Promise<{
+    stdout: string;
+    exitCode: number;
+    stderr: string;
+}>;
+/**
+ * Every simulator, flattened out of simctl's runtime-keyed map.
+ *
+ * The raw JSON nests devices under runtime identifiers like
+ * `com.apple.CoreSimulator.SimRuntime.iOS-26-5` and carries six fields per
+ * device that nobody asked for — data paths, log paths, sizes. Four fields
+ * and a readable runtime name is the whole useful shape.
+ */
+export declare function listSimulators(options?: {
+    available?: boolean;
+}): Promise<Simulator[]>;
+/** `com.apple.CoreSimulator.SimRuntime.iOS-26-5` -> `iOS 26.5`. */
+export declare function prettyRuntime(runtimeId: string): string;
+/**
+ * Find one simulator by udid or name.
+ *
+ * Name matching prefers a booted device, because when a name resolves to
+ * several runtimes the booted one is almost always the one meant — and acting
+ * on the wrong copy of "iPhone 17 Pro" is a silent wrong answer.
+ */
+export declare function findSimulator(simulators: Simulator[], query: string): Simulator | undefined;

package/dist/src/simctl.js

@@ -0,0 +1,85 @@
+import { execFile } from "node:child_process";
+import { AxiError } from "./errors.js";
+/** `simctl` reads and mutations, wrapped so failures arrive structured. */
+const MAX_BUFFER_BYTES = 16 * 1024 * 1024;
+export function simctl(args) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        execFile("xcrun", ["simctl", ...args], { maxBuffer: MAX_BUFFER_BYTES, encoding: "utf-8" }, (error, stdout, stderr) => {
+            if (error && error.code === "ENOENT") {
+                rejectPromise(new AxiError("xcrun is not available — Xcode is not installed or selected", "XCODE_NOT_INSTALLED"));
+                return;
+            }
+            resolvePromise({
+                stdout,
+                stderr,
+                exitCode: typeof error?.code === "number" ? error.code : error ? 1 : 0,
+            });
+        });
+    });
+}
+/**
+ * Every simulator, flattened out of simctl's runtime-keyed map.
+ *
+ * The raw JSON nests devices under runtime identifiers like
+ * `com.apple.CoreSimulator.SimRuntime.iOS-26-5` and carries six fields per
+ * device that nobody asked for — data paths, log paths, sizes. Four fields
+ * and a readable runtime name is the whole useful shape.
+ */
+export async function listSimulators(options = {}) {
+    const args = ["list", "-j", "devices"];
+    if (options.available !== false)
+        args.push("available");
+    const { stdout } = await simctl(args);
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new AxiError("simctl returned output that could not be read", "UNKNOWN");
+    }
+    const out = [];
+    for (const [runtimeId, devices] of Object.entries(parsed.devices ?? {})) {
+        const runtime = prettyRuntime(runtimeId);
+        for (const device of devices) {
+            if (device.udid === undefined || device.name === undefined)
+                continue;
+            out.push({
+                udid: device.udid,
+                name: device.name,
+                state: (device.state ?? "unknown").toLowerCase(),
+                runtime,
+                isAvailable: device.isAvailable !== false,
+            });
+        }
+    }
+    return out;
+}
+/** `com.apple.CoreSimulator.SimRuntime.iOS-26-5` -> `iOS 26.5`. */
+export function prettyRuntime(runtimeId) {
+    const tail = runtimeId.split(".").pop() ?? runtimeId;
+    // The version part must actually look like one, so an identifier in some
+    // other shape comes back untouched rather than silently mangled.
+    const match = tail.match(/^([A-Za-z]+)-(\d+(?:-\d+)*)$/);
+    if (!match || match[1] === undefined || match[2] === undefined)
+        return tail;
+    return `${match[1]} ${match[2].replace(/-/g, ".")}`;
+}
+/**
+ * Find one simulator by udid or name.
+ *
+ * Name matching prefers a booted device, because when a name resolves to
+ * several runtimes the booted one is almost always the one meant — and acting
+ * on the wrong copy of "iPhone 17 Pro" is a silent wrong answer.
+ */
+export function findSimulator(simulators, query) {
+    const wanted = query.toLowerCase();
+    const byUdid = simulators.find((simulator) => simulator.udid.toLowerCase() === wanted);
+    if (byUdid)
+        return byUdid;
+    const named = simulators.filter((simulator) => simulator.name.toLowerCase() === wanted);
+    if (named.length > 0) {
+        return named.find((simulator) => simulator.state === "booted") ?? named[0];
+    }
+    return simulators.find((simulator) => simulator.name.toLowerCase().includes(wanted));
+}
+//# sourceMappingURL=simctl.js.map

package/dist/src/simctl.js.map

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

package/dist/src/surface.d.ts

@@ -0,0 +1,55 @@
+/**
+ * How much of `xcodebuild` this tool actually covers.
+ *
+ * Wrapping a CLI silently narrows it, and the narrowing is invisible until an
+ * agent needs the one flag that got left out. So the mapping is declared here
+ * rather than inferred: every option `xcodebuild -help` prints is classified,
+ * and `npm run coverage -- --check` fails if a new Xcode adds one this file
+ * has never heard of.
+ */
+/**
+ * The Xcode whose `xcodebuild -help` this map was written against.
+ *
+ * The option list is not stable across Xcode releases — 26 listed `-dry-run`
+ * and `-downloadAllPreviouslySelectedPlatforms`, 27 dropped both and added the
+ * `platforms` and codesize families. So a machine running a different Xcode
+ * will legitimately disagree with this file, and only a machine running this
+ * one can say the map is actually stale. `scripts/coverage.ts` fails on a
+ * mismatch here and merely reports one elsewhere.
+ */
+export declare const AUTHORED_AGAINST = "27.0";
+export type OptionCoverage = 
+/** Reachable through an xcodebuild-axi flag or command. */
+{
+    status: "exposed";
+    via: string;
+}
+/** The tool always sets it, so there is nothing for a caller to pass. */
+ | {
+    status: "always";
+    why: string;
+}
+/** Answered better by something xcodebuild-axi already does. */
+ | {
+    status: "superseded";
+    why: string;
+}
+/** Deliberately not wrapped, for the stated reason. */
+ | {
+    status: "n/a";
+    why: string;
+};
+export declare const OPTION_COVERAGE: Record<string, OptionCoverage>;
+/** The build actions, classified the same way. */
+export declare const ACTION_COVERAGE: Record<string, OptionCoverage>;
+export interface CoverageTally {
+    total: number;
+    exposed: number;
+    always: number;
+    superseded: number;
+    na: number;
+    /** Reachable, handled for you, or answered better — what the README quotes. */
+    covered: number;
+    percent: number;
+}
+export declare function tally(map: Record<string, OptionCoverage>): CoverageTally;