xcodebuild-axi 0.1.7 → 0.1.9

package/dist/src/commands/xcframework.js

@@ -2,54 +2,141 @@ import { existsSync } from "node:fs";
 import { AxiError } from "../errors.js";
 import { runMetadata, stripPreamble } from "../xcodebuild.js";
 import { renderFields, renderHelp, renderOutput, tildePath } from "../toon.js";
-import { getListFlag, getFlag, rejectUnknownFlags } from "../args.js";
+import { getFlag, hasFlag, orderedFlags, rejectUnknownFlags } from "../args.js";
 export const XCFRAMEWORK_HELP = `usage: xcodebuild-axi xcframework --output <path.xcframework> [flags]
 Bundles prebuilt frameworks or libraries into one .xcframework.
-flags[4]:
-  --output <path>     the .xcframework to write (required)
-  --framework <path>  a built .framework to include; repeatable
-  --library <path>    a built static or dynamic library to include; repeatable
-  --headers <path>    headers for the library that precedes it; repeatable
+flags[7]:
+  --output <path>         the .xcframework to write (required)
+  --framework <path>      a built .framework to include; repeatable
+  --library <path>        a built static or dynamic library to include; repeatable
+  --headers <path>        headers for the library that precedes it; repeatable
+  --archive <path>        take the next --framework or --library out of this .xcarchive
+  --debug-symbols <path>  dSYMs or bcsymbolmaps for the slice that precedes it; repeatable
+  --allow-internal-distribution  mark the result as not for public distribution
 note:
-  --headers applies to the --library it follows, which is how xcodebuild pairs
-  them. Give them in matching order.
+  Order is meaning here, because it is meaning to xcodebuild: --headers and
+  --debug-symbols attach to the --framework or --library they follow, and
+  --archive applies to the one that follows it. After --archive, name the
+  framework or library rather than giving a path to it.
+  Ship dSYMs with anything a crash report has to be read from — an
+  .xcframework built without --debug-symbols cannot be symbolicated.
 examples:
   xcodebuild-axi xcframework --output Out.xcframework --framework A.framework --framework B.framework
   xcodebuild-axi xcframework --output Out.xcframework --library libA.a --headers include
+  xcodebuild-axi xcframework --output MyLib.xcframework \\
+    --archive ios.xcarchive --framework MyLib.framework --debug-symbols ios.xcarchive/dSYMs \\
+    --archive sim.xcarchive --framework MyLib.framework --debug-symbols sim.xcarchive/dSYMs
 `;
-const FLAGS = ["--output", "--framework", "--library", "--headers"];
+export const XCFRAMEWORK_FLAGS = [
+    "--output",
+    "--framework",
+    "--library",
+    "--headers",
+    "--archive",
+    "--debug-symbols",
+    "--allow-internal-distribution",
+];
+const VALUE_FLAGS = [
+    "--output",
+    "--framework",
+    "--library",
+    "--headers",
+    "--archive",
+    "--debug-symbols",
+];
+/** The flags that name a slice of the xcframework rather than describing one. */
+const SLICE_FLAGS = ["--framework", "--library"];
+const XCODEBUILD_FLAG = {
+    "--framework": "-framework",
+    "--library": "-library",
+    "--headers": "-headers",
+    "--archive": "-archive",
+    "--debug-symbols": "-debug-symbols",
+};
+/**
+ * Translate the command's flags into xcodebuild's, keeping their order.
+ *
+ * xcodebuild reads this argument list positionally — `-headers` belongs to the
+ * `-library` before it, `-debug-symbols` to the slice before that, `-archive`
+ * to the slice after it — so the translation is a walk rather than a regroup.
+ */
+export function planXcframework(args) {
+    const sequence = orderedFlags(args, Object.keys(XCODEBUILD_FLAG));
+    const plan = {
+        args: [],
+        frameworks: 0,
+        libraries: 0,
+        archives: 0,
+        missing: [],
+    };
+    let previous;
+    /** The archive the next slice comes out of, if one was just named. */
+    let pendingArchive;
+    for (const { flag, value } of sequence) {
+        if (flag === "--headers" && previous !== "--library") {
+            throw new AxiError("--headers describes the --library before it, and none precedes it", "VALIDATION_ERROR", [
+                "xcodebuild-axi xcframework --output Out.xcframework --library libA.a --headers include",
+            ]);
+        }
+        if (flag === "--debug-symbols" && !isSliceOrDescriptor(previous)) {
+            throw new AxiError("--debug-symbols describes the slice before it, and none precedes it", "VALIDATION_ERROR", [
+                "Put --debug-symbols after the --framework or --library it belongs to",
+            ]);
+        }
+        if (pendingArchive !== undefined && !SLICE_FLAGS.includes(flag)) {
+            throw new AxiError(`--archive '${pendingArchive}' is not followed by a --framework or --library`, "VALIDATION_ERROR", ["Name the framework or library to take out of the archive next"]);
+        }
+        if (flag === "--framework")
+            plan.frameworks += 1;
+        if (flag === "--library")
+            plan.libraries += 1;
+        if (flag === "--archive") {
+            plan.archives += 1;
+            pendingArchive = value;
+        }
+        else if (SLICE_FLAGS.includes(flag)) {
+            pendingArchive = undefined;
+        }
+        // Inside an archive a slice is named, not located, so only the paths that
+        // are really paths are checked for.
+        const isName = SLICE_FLAGS.includes(flag) && previous === "--archive";
+        if (!isName && !existsSync(value))
+            plan.missing.push(value);
+        plan.args.push(XCODEBUILD_FLAG[flag], value);
+        previous = flag;
+    }
+    if (pendingArchive !== undefined) {
+        throw new AxiError(`--archive '${pendingArchive}' is not followed by a --framework or --library`, "VALIDATION_ERROR", ["Name the framework or library to take out of the archive next"]);
+    }
+    return plan;
+}
+function isSliceOrDescriptor(flag) {
+    return flag !== undefined && flag !== "--archive";
+}
 export async function xcframeworkCommand(args) {
-    rejectUnknownFlags(args, "xcframework", FLAGS, FLAGS);
+    rejectUnknownFlags(args, "xcframework", XCFRAMEWORK_FLAGS, VALUE_FLAGS);
     const output = getFlag(args, "--output");
     if (output === undefined) {
         throw new AxiError("xcframework needs --output", "VALIDATION_ERROR", [
             "xcodebuild-axi xcframework --output Out.xcframework --framework A.framework",
         ]);
     }
-    const frameworks = getListFlag(args, "--framework");
-    const libraries = getListFlag(args, "--library");
-    const headers = getListFlag(args, "--headers");
-    if (frameworks.length === 0 && libraries.length === 0) {
+    const plan = planXcframework(args);
+    if (plan.frameworks === 0 && plan.libraries === 0) {
         throw new AxiError("xcframework needs at least one --framework or --library", "VALIDATION_ERROR", [
             "xcodebuild-axi xcframework --output Out.xcframework --framework A.framework",
         ]);
     }
-    const missing = [...frameworks, ...libraries].filter((path) => !existsSync(path));
-    if (missing.length > 0) {
+    if (plan.missing.length > 0) {
         // xcodebuild reports this one input at a time; naming them all at once
         // saves a round trip per missing path.
-        throw new AxiError(`Missing input: ${missing.join(", ")}`, "VALIDATION_ERROR", ["Build each slice first, then pass the built products here"]);
+        throw new AxiError(`Missing input — ${plan.missing.join(", ")}`, "VALIDATION_ERROR", ["Build each slice first, then pass the built products here"]);
     }
+    const internal = hasFlag(args, "--allow-internal-distribution");
     const { stdout, stderr, exitCode } = await runMetadata([
         "-create-xcframework",
-        ...frameworks.flatMap((path) => ["-framework", path]),
-        ...libraries.flatMap((path, index) => [
-            "-library",
-            path,
-            ...(headers[index] !== undefined
-                ? ["-headers", headers[index]]
-                : []),
-        ]),
+        ...plan.args,
+        ...(internal ? ["-allow-internal-distribution"] : []),
         "-output",
         output,
     ]);
@@ -60,8 +147,10 @@ export async function xcframeworkCommand(args) {
     return renderOutput([
         renderFields({
             xcframework: tildePath(output),
-            frameworks: frameworks.length,
-            libraries: libraries.length,
+            frameworks: plan.frameworks,
+            libraries: plan.libraries,
+            ...(plan.archives > 0 ? { archives: plan.archives } : {}),
+            ...(internal ? { distribution: "internal only" } : {}),
         }),
         renderHelp([
             "Add the .xcframework to a target's Frameworks build phase to use it",

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

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

package/dist/src/errors.js

@@ -33,6 +33,16 @@ const patterns = [
             "For a device build, pass `--sign` and set DEVELOPMENT_TEAM in the project",
         ],
     },
+    {
+        pattern: /Building a Swift package requires that a destination is provided/,
+        code: "DESTINATION_NOT_FOUND",
+        message: () => "A Swift package has no default destination, so xcodebuild needs one named",
+        suggestions: () => [
+            'Pass a simulator by name: `--device "iPhone 17 Pro"`',
+            "Or a whole specifier: `--destination 'platform=macOS'`",
+            "Run `xcodebuild-axi destinations` to see what this package supports",
+        ],
+    },
     {
         pattern: /xcodebuild: error: (.+)/,
         code: "UNKNOWN",

package/dist/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAexD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AAiBtC,MAAM,QAAQ,GAAmB;IAC/B;QACE,OAAO,EACL,6HAA6H;QAC/H,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB;QACnE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,qDAAqD,CAAC;KAC3E;IACD;QACE,OAAO,EACL,0EAA0E;QAC5E,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,6CAA6C;QAC5D,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,sFAAsF;YACtF,sDAAsD;SACvD;KACF;IACD;QACE,OAAO,EAAE,oCAAoC;QAC7C,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,GAAG,EAAE,CACZ,kFAAkF;QACpF,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,gEAAgE;SACjE;KACF;IACD;QACE,OAAO,EAAE,mDAAmD;QAC5D,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,oCAAoC;QACnE,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,8FAA8F;YAC9F,2EAA2E;SAC5E;KACF;IACD;QACE,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;KACpC;CACF,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,QAAQ,CACjB,0EAA0E,EAC1E,qBAAqB,EACrB,CAAC,yEAAyE,CAAC,CAC5E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAexD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AAiBtC,MAAM,QAAQ,GAAmB;IAC/B;QACE,OAAO,EACL,6HAA6H;QAC/H,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB;QACnE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,qDAAqD,CAAC;KAC3E;IACD;QACE,OAAO,EACL,0EAA0E;QAC5E,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,6CAA6C;QAC5D,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,sFAAsF;YACtF,sDAAsD;SACvD;KACF;IACD;QACE,OAAO,EAAE,oCAAoC;QAC7C,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,GAAG,EAAE,CACZ,kFAAkF;QACpF,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,gEAAgE;SACjE;KACF;IACD;QACE,OAAO,EAAE,mDAAmD;QAC5D,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,oCAAoC;QACnE,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,8FAA8F;YAC9F,2EAA2E;SAC5E;KACF;IACD;QACE,OAAO,EAAE,kEAAkE;QAC3E,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,GAAG,EAAE,CACZ,2EAA2E;QAC7E,WAAW,EAAE,GAAG,EAAE,CAAC;YACjB,sDAAsD;YACtD,wDAAwD;YACxD,qEAAqE;SACtE;KACF;IACD;QACE,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;KACpC;CACF,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,QAAQ,CACjB,0EAA0E,EAC1E,qBAAqB,EACrB,CAAC,yEAAyE,CAAC,CAC5E,CAAC;AACJ,CAAC"}

package/dist/src/report.d.ts

@@ -1,4 +1,4 @@
-import type { Diagnostic } from "./xcresult.js";
+import { type Diagnostic, type TestFailure } from "./xcresult.js";
 /**
  * Render a capped list of diagnostics.
  *
@@ -18,3 +18,24 @@ export declare function diagnosticsBlock(label: string, diagnostics: Diagnostic[
  * would be the quiet wrapper hiding the very failure it exists to surface.
  */
 export declare function transcriptTail(tail: string, lines?: number): string;
+export type FailureRow = {
+    test: string;
+    target: string;
+    file?: string;
+    line?: number | "";
+    message: string;
+};
+/**
+ * The failure table both `test` and `result` print.
+ *
+ * A failing test's message says what went wrong; the file and line say where,
+ * and they cost one `test-details` read each because the summary does not
+ * carry them. Only the rows actually shown are looked up — a run with four
+ * hundred failures should not spend four hundred subprocesses to print twenty
+ * lines — and a lookup that fails leaves the location blank rather than
+ * failing the report, since a bundle from another Xcode may not answer at all.
+ */
+export declare function failureRows(resultPath: string, failures: TestFailure[], options: {
+    max: number;
+    full: boolean;
+}): Promise<FailureRow[]>;

package/dist/src/report.js

@@ -1,3 +1,4 @@
+import { failureLocation, readTestDetails, } from "./xcresult.js";
 import { renderList, truncate } from "./toon.js";
 /**
  * Render a capped list of diagnostics.
@@ -36,4 +37,43 @@ export function transcriptTail(tail, lines = 15) {
         return "";
     return `tail[${kept.length}]:\n${kept.map((line) => `  ${line}`).join("\n")}`;
 }
+/**
+ * The failure table both `test` and `result` print.
+ *
+ * A failing test's message says what went wrong; the file and line say where,
+ * and they cost one `test-details` read each because the summary does not
+ * carry them. Only the rows actually shown are looked up — a run with four
+ * hundred failures should not spend four hundred subprocesses to print twenty
+ * lines — and a lookup that fails leaves the location blank rather than
+ * failing the report, since a bundle from another Xcode may not answer at all.
+ */
+export async function failureRows(resultPath, failures, options) {
+    const shown = failures.slice(0, options.max);
+    const locations = await Promise.all(shown.map(async (failure) => {
+        const identifier = failure.testIdentifierString;
+        if (!identifier)
+            return { file: "", line: "" };
+        return readTestDetails(resultPath, identifier)
+            .then(failureLocation)
+            .catch(() => ({ file: "", line: "" }));
+    }));
+    // Two empty columns on every row is worse than no columns: TOON prints the
+    // header either way, and a bundle written by another Xcode may answer none
+    // of these lookups.
+    const located = locations.some((location) => location.file.length > 0);
+    return shown.map((failure, index) => {
+        const message = (failure.failureText ?? "").replace(/\s+/g, " ").trim();
+        return {
+            test: failure.testIdentifierString ?? failure.testName ?? "unknown",
+            target: failure.targetName ?? "",
+            ...(located
+                ? {
+                    file: locations[index]?.file ?? "",
+                    line: locations[index]?.line ?? "",
+                }
+                : {}),
+            message: options.full ? message : truncate(message, 300).text,
+        };
+    });
+}
 //# sourceMappingURL=report.js.map

package/dist/src/report.js.map

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

package/dist/src/scheme.d.ts

@@ -20,3 +20,37 @@ export declare function listSchemes(project: ProjectContext): Promise<SchemeInfo
  * correct rather than another lookup (AXI principle 6).
  */
 export declare function requireScheme(project: ProjectContext, requested: string | undefined, command: string): Promise<string>;
+/** What a command was asked to act on: a scheme, some targets, or all of them. */
+export interface Subject {
+    /** How to name it in a report — the scheme, the targets, or "all targets". */
+    label: string;
+    /** `-scheme X`, `-target A -target B`, or `-alltargets`. */
+    flags: string[];
+    /**
+     * A filesystem-safe stem for artifacts. `label` is written for a reader and
+     * can hold spaces and commas; a log file named `all targets-clean.log`
+     * is a path every shell needs quoting for.
+     */
+    slug: string;
+    /**
+     * The same selection spelled as this tool's own flags, for a rerun hint.
+     * Not derivable from `label`: "all targets" is prose, and a hint that says
+     * `--target all targets` is a command that does not run.
+     */
+    rerun: string;
+    /** True when targets were named instead of a scheme. */
+    targetMode: boolean;
+}
+/**
+ * Resolve `--scheme` / `--target` / `--all-targets` into what to pass and what
+ * to call it.
+ *
+ * Shared because the rules are xcodebuild's rather than any one command's:
+ * targets need a project, they cannot be combined with a scheme, and a scheme
+ * is inferred when the project has only one.
+ */
+export declare function resolveSubject(project: ProjectContext, args: {
+    scheme?: string;
+    targets: string[];
+    allTargets: boolean;
+}, command: string): Promise<Subject>;

package/dist/src/scheme.js

@@ -63,4 +63,50 @@ export async function requireScheme(project, requested, command) {
         `schemes: ${schemes.join(", ")}`,
     ]);
 }
+/**
+ * Resolve `--scheme` / `--target` / `--all-targets` into what to pass and what
+ * to call it.
+ *
+ * Shared because the rules are xcodebuild's rather than any one command's:
+ * targets need a project, they cannot be combined with a scheme, and a scheme
+ * is inferred when the project has only one.
+ */
+export async function resolveSubject(project, args, command) {
+    const targetMode = args.targets.length > 0 || args.allTargets;
+    if (targetMode && project.kind === "workspace") {
+        // xcodebuild's own refusal here is "-target is not supported with
+        // -workspace", issued only after it has resolved the package graph.
+        throw new AxiError("--target and --all-targets work against a project, not a workspace", "VALIDATION_ERROR", [
+            "Pass `--scheme <name>` instead, or cd to the directory holding the .xcodeproj",
+        ]);
+    }
+    if (targetMode && args.scheme !== undefined) {
+        throw new AxiError("--scheme and --target select different things to build, so only one can be used", "VALIDATION_ERROR", ["Drop one — a scheme already names the targets it builds"]);
+    }
+    if (targetMode) {
+        return args.allTargets
+            ? {
+                label: "all targets",
+                slug: "all-targets",
+                flags: ["-alltargets"],
+                rerun: "--all-targets",
+                targetMode,
+            }
+            : {
+                label: args.targets.join(","),
+                slug: args.targets.join("-"),
+                flags: args.targets.flatMap((target) => ["-target", target]),
+                rerun: args.targets.map((target) => `--target ${target}`).join(" "),
+                targetMode,
+            };
+    }
+    const scheme = await requireScheme(project, args.scheme, command);
+    return {
+        label: scheme,
+        slug: scheme,
+        flags: ["-scheme", scheme],
+        rerun: `--scheme ${scheme}`,
+        targetMode,
+    };
+}
 //# sourceMappingURL=scheme.js.map

package/dist/src/scheme.js.map

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

package/dist/src/surface.d.ts

@@ -6,6 +6,20 @@
  * 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.
+ *
+ * "Covered" is asked along four axes, because for a long time it was only
+ * asked along the first and the misses all landed on the other three:
+ *
+ * 1. **Options** — does any command reach this option at all.
+ * 2. **Reach** — does every command xcodebuild accepts it on reach it. An
+ *    option exposed on `build` and missing from `settings` is not covered for
+ *    anyone asking `settings`, and nothing used to say so.
+ * 3. **Forms and sub-surfaces** — the options behind an option: the keys of
+ *    `-exportOptionsPlist`, the arguments of `-create-xcframework`, the second
+ *    modes that `-help` documents only inside a usage line.
+ * 4. **Companion tools** — `xcresulttool`, `xccov`, `simctl`. Not xcodebuild,
+ *    so not in its headline number, but this tool wraps them and an agent that
+ *    has to shell out to one directly has dropped back down.
  */
 /**
  * The Xcode whose `xcodebuild -help` this map was written against.
@@ -18,11 +32,29 @@
  * mismatch here and merely reports one elsewhere.
  */
 export declare const AUTHORED_AGAINST = "27.0";
+/** One command that reaches a thing, and the words that reach it. */
+export interface Exposure {
+    /** The `xcodebuild-axi` command. */
+    command: string;
+    /** How it is reached, e.g. `settings --for-index`. */
+    via: string;
+}
+/** A command that could reach a thing and does not. */
+export interface Gap {
+    command: string;
+    why: string;
+}
 export type OptionCoverage = 
 /** Reachable through an xcodebuild-axi flag or command. */
 {
     status: "exposed";
-    via: string;
+    on: readonly Exposure[];
+    /** The command set this option applies to, when it is more than `on`. */
+    surface?: SurfaceName;
+    /** Commands in that set it will never reach, and why not. */
+    declined?: readonly Gap[];
+    /** Commands in that set it should reach and does not, yet. */
+    missing?: readonly Gap[];
 }
 /** The tool always sets it, so there is nothing for a caller to pass. */
  | {
@@ -34,22 +66,123 @@ export type OptionCoverage =
     status: "superseded";
     why: string;
 }
+/**
+ * Not wrapped yet. A gap being paid down, not a boundary — `from` names the
+ * command that will grow it, so the open list reads as a work plan.
+ */
+ | {
+    status: "missing";
+    why: string;
+    from?: string;
+}
 /** Deliberately not wrapped, for the stated reason. */
  | {
     status: "n/a";
     why: string;
 };
+/**
+ * The commands an option can apply to, by kind.
+ *
+ * xcodebuild's own usage lines are the authority: `-target` and `-alltargets`
+ * sit on the same line as `-showBuildSettings`, so `settings` is expected to
+ * take them; `-showdestinations` appears only on the `-scheme` lines, so
+ * `destinations` is not expected to take a target.
+ */
+export declare const BUILD_FAMILY: readonly ["build", "test", "tests", "analyze", "archive"];
+export declare const SURFACES: {
+    /** Shapes compilation, so only the commands that compile something. */
+    readonly build: readonly ["build", "test", "tests", "analyze", "archive"];
+    /** Applies to any action word, `clean` included. */
+    readonly action: readonly ["build", "test", "tests", "analyze", "archive", "clean"];
+    /** Changes what the project resolves to, which `settings` reports on. */
+    readonly resolution: readonly ["build", "test", "tests", "analyze", "archive", "clean", "settings"];
+    /** Package resolution, which `packages` drives on its own. */
+    readonly package: readonly ["build", "test", "tests", "analyze", "archive", "packages"];
+    /** Selects a scheme to act on. */
+    readonly scheme: readonly ["build", "test", "tests", "analyze", "archive", "clean", "settings", "destinations", "testplans", "packages", "localize"];
+    /** Constrains which tests are run, and so which tests are enumerated. */
+    readonly testing: readonly ["test", "tests"];
+};
+export type SurfaceName = keyof typeof SURFACES;
+/** `"settings --for-index"` -> `{ command: "settings", via: "settings --for-index" }`. */
+export declare function at(via: string): Exposure;
+/** The gaps this file exists to make visible, phrased once and shared. */
 export declare const OPTION_COVERAGE: Record<string, OptionCoverage>;
 /** The build actions, classified the same way. */
 export declare const ACTION_COVERAGE: Record<string, OptionCoverage>;
+/**
+ * The second forms of an option, which `-help` documents only inside a usage
+ * line or a sentence. Nothing enumerates these, so they are the easiest kind
+ * of gap to ship: `-runFirstLaunch -checkForNewerComponents` is a flag on a
+ * flag, mentioned once, in prose.
+ */
+export declare const FORM_COVERAGE: Record<string, OptionCoverage>;
+/**
+ * `-exportOptionsPlist` keys.
+ *
+ * The plist is the whole configuration surface of `-exportArchive`, and
+ * authoring one by hand is exactly the side quest `--method` exists to remove
+ * — so a key with no flag is a key that sends the agent back to writing XML.
+ */
+export declare const EXPORT_OPTION_COVERAGE: Record<string, OptionCoverage>;
+/** `-create-xcframework`'s own options, which only its `-help` prints. */
+export declare const XCFRAMEWORK_COVERAGE: Record<string, OptionCoverage>;
+/**
+ * `xcresulttool`, which owns every answer about a run that already happened.
+ *
+ * The result bundle is this tool's source of truth (see AGENTS.md), so a leaf
+ * missing here is an answer the bundle holds and the tool cannot read out —
+ * `test --diagnostics` collecting a report nothing can open, for instance.
+ */
+export declare const XCRESULT_COVERAGE: Record<string, OptionCoverage>;
+/** `xccov`, which owns coverage. */
+export declare const XCCOV_COVERAGE: Record<string, OptionCoverage>;
+/**
+ * `simctl`, which owns simulators.
+ *
+ * `sim` exists to put a destination into the state a build or test run needs,
+ * and stops there. The rest is classified so the boundary is a decision on
+ * the record rather than an omission.
+ */
+export declare const SIMCTL_COVERAGE: Record<string, OptionCoverage>;
+/** Every non-xcodebuild surface this tool wraps, for one combined number. */
+export declare const COMPANION_SURFACES: Record<string, Record<string, OptionCoverage>>;
 export interface CoverageTally {
     total: number;
     exposed: number;
     always: number;
     superseded: number;
+    missing: 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;
+export declare function percent(part: number, whole: number): number;
+/** Every command an option applies to, whether or not it reaches it. */
+export declare function applicable(entry: OptionCoverage): string[];
+export interface ReachTally {
+    /** Command-and-option pairs that could exist. */
+    pairs: number;
+    reached: number;
+    declined: number;
+    missing: number;
+    percent: number;
+}
+/**
+ * Coverage counted per command rather than per option.
+ *
+ * The headline number asks whether an option is reachable at all; this one
+ * asks whether it is reachable from where you are standing, which is the
+ * question an agent that just got `unknown flag --target` was asking.
+ */
+export declare function reach(map: Record<string, OptionCoverage>): ReachTally;
+/** Every gap in a map, as `option` -> the commands that should reach it. */
+export declare function gaps(map: Record<string, OptionCoverage>): Array<{
+    option: string;
+    command: string;
+    why: string;
+}>;
+/** The README's one-line answer to "how do I reach this?". */
+export declare function describe(entry: OptionCoverage): string;