xcodebuild-axi 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -4,6 +4,155 @@ Notable changes to `xcodebuild-axi`. Versions follow
 [semver](https://semver.org/); the format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.1.11] - 2026-09-21
+
+### Added
+
+- **`result --export <what>` gets files out of a bundle**: `attachments`,
+  `diagnostics`, `metrics`, or `evaluations`. A UI test's screenshots, the
+  diagnostics report `test --diagnostics` collects, and the CSVs behind a
+  performance measurement were all in the bundle and reachable only by shelling
+  out to `xcresulttool`.
+
+  It writes under `~/Library/Caches/xcodebuild-axi/exports/` by default, or
+  wherever `--to` says — never into the working tree, so asking what is in a CI
+  artifact cannot dirty the checkout it sits in. `--test`, `--filter '*.png'`
+  and `--failures` narrow what comes out, and each is **refused** where it does
+  not apply rather than ignored: a diagnostics report covers the whole run, so
+  `--test` beside it would answer a different question than the one asked.
+
+  The report is what landed and where, with each exported file tied back to the
+  test that produced it — a screenshot's filename is a UUID, and the manifest
+  is the only thing that makes it findable. `xcresulttool` narrates an
+  attachment export with one "Skipped export for <test>: no matching
+  attachments" per test, which is dropped.
+
+- **`result --against <baseline.xcresult>`** answers the question CI actually
+  asks — not "did this run fail" but "did it fail in a way the last one did
+  not". It reports the counts on both sides and their direction
+  (`failures: 0 → 1 (+1 -0)`), then the tests that newly fail, the ones that
+  now pass, the ones added and removed, and any new warning. A failure the
+  baseline did not have is listed first, because it is the only part of a
+  comparison that stops a merge.
+
+  Two bundles with nothing in common — a build against a test run — get an
+  explicit answer saying so. `xcresulttool` prints a bare `null` there, which
+  is otherwise indistinguishable from a clean comparison.
+
+- **`result <a> <b> [...] --merge`** combines the bundles of a sharded test run
+  into one, which is the only way that run gets a single verdict. The merged
+  bundle is read back and reported from, rather than described from its
+  inputs. It lands under `~/Library/Caches` unless `--to` says otherwise, and a
+  `--to` that already exists is refused rather than written over — the bundle
+  under our own cache directory is ours to clear, one the caller named is not.
+
+  With these two, **`xcresulttool` coverage is 81% of its leaves** and every
+  remaining one is deprecated by Xcode or superseded here.
+
+- **`coverage` sees everything `xccov` sees.** Five leaves, and the command's
+  path argument now also takes an `.xccovreport` or an `.xccovarchive`:
+
+  - `--functions <file>` is per-function coverage, which is where an uncovered
+    branch finally gets a name. A file at 60% says a test is missing; it does
+    not say which one.
+  - `--lines <file>` is how many times each line ran, read out of the archive
+    rather than the report. Consecutive lines that never ran collapse into one
+    range — a 400-line file was 400 rows to find the eight that matter.
+  - `--against <path>` answers "did coverage drop" from two bundles this tool
+    wrote, reporting which way it moved overall and then per file, worst
+    first.
+  - `--merge` combines the coverage of a sharded run. `xccov merge` takes
+    report/archive **pairs** rather than result bundles, so each bundle is
+    unpacked with `xcresulttool export coverage` first — that two-step is the
+    reason merging coverage across shards is something people give up on.
+
+  With them, **`xccov` coverage is 100%** and companion coverage overall is
+  43.7%.
+
+### Fixed
+
+- `xccov`'s refusals are no longer wrapped in NSError. A bad path came back as
+  `Error: Error Domain=XCCovErrorDomain Code=0 "Failed to load result bundle"
+UserInfo={NSLocalizedDescription=Failed to load result bundle,
+NSUnderlyingError=0x… {…}}` — 400 characters around a five-word answer that
+  was already in there.
+
+## [0.1.10] - 2026-09-21
+
+### Added
+
+- **`result` reads the rest of what is in an `.xcresult`.** Seven modes, each
+  its own question, none of which had an answer short of shelling out to
+  `xcresulttool` and parsing JSON:
+
+  - `--tests` lists every test the run recorded, failures first, with the
+    identifier `--only` and `--activities --test` take.
+  - `--activities --test <id>` prints the step-by-step trail of one test,
+    indented by depth — what a UI test actually did before it failed.
+  - `--insights` reports Xcode's own diagnosis of the run.
+  - `--metrics` reports the performance measurements an `XCTMetric` test took,
+    which `test --perf-diagnostics` collects and nothing could read back.
+  - `--log [build|action|console]` reports the stored log as the timed tree it
+    is: the slowest sections of a build, ranked, without rebuilding it.
+  - `--available` says what the bundle holds — test results, coverage,
+    diagnostics, which logs — so a read that would fail can be skipped rather
+    than attempted.
+  - `--metadata` reports the bundle's own format version, storage backend and
+    compression.
+
+  That takes `xcresulttool` coverage from 19% to 52.4% of its leaves, and the
+  companion tools as a whole from 18.3% to 28.2%.
+
+- **The export options plist is fully covered.** `export` gained a flag for
+  each of the twelve keys that had none, so nothing about a distribution
+  requires authoring XML any more:
+
+  `--profile <id>=<name>`, `--certificate`, `--installer-certificate`,
+  `--distribution-bundle-id`, `--keep-swift-symbols`, `--internal-only`,
+  `--app-store-info`, `--icloud-env`, `--thinning`, `--manifest <key>=<url>`,
+  `--odr-base-url`, `--no-embed-odr`.
+
+  The ones that change whether a release works at all: `--profile` and
+  `--certificate` are manual signing, which until now could be _asked for_
+  with `--signing-style manual` and not completed — so the flag existed and
+  the export it produced could not be signed as intended. `--internal-only`
+  marks a TestFlight build as not for external distribution, which is what a
+  PR build wants. `--manifest` is over-the-web distribution, and it is refused
+  unless all three of its URLs are present, because a partial manifest exports
+  without an error and produces a link that cannot install.
+
+  Two spellings are handled rather than passed on: Xcode writes its named
+  thinning options with angle brackets (`<none>`), and the Xcode 26 method
+  names (`app-store`, `ad-hoc`, `development`) still work and are reported as
+  the current name they mean.
+
+- `info --sdk <name>` reports one SDK in full — path, platform path, platform,
+  and both versions. That was `xcodebuild -version -sdk <name> <infoitem>`,
+  which answers one field per invocation and only if you already know the
+  field names. A build script that needs the SDK path, or an agent asked which
+  build of the SDK it compiled against, had to shell out for it.
+
+  With it, **every leaf of xcodebuild's own surface that this tool wraps is
+  covered**: 160 of 161, and the one left is `installsrc`, which is declined
+  on purpose and says so.
+
+### Changed
+
+- The flags that shape the generated options plist are now **refused**
+  alongside `--options` rather than silently ignored. `--upload` already was;
+  `--team`, `--signing-style` and the ten new ones were not, so a release could
+  pass `--team` beside a hand-written plist and get a build signed by whatever
+  the plist said.
+
+### Fixed
+
+- `xcresulttool`'s own explanation of a failed read is now the error message.
+  It writes `Error: …` on stderr and exits non-zero; the reason was thrown away
+  and replaced with a guess ("the bundle may be from an incompatible Xcode
+  version"), so `--log console` on a bundle with no console log was reported as
+  a version problem rather than as the absent log it is. The guess is only
+  offered now when `xcresulttool` gave no reason of its own.
+
 ## [0.1.9] - 2026-09-21
 
 ### Added
@@ -294,7 +443,9 @@ First release.
 - 100% of the 117 options `xcodebuild -help` lists are covered, declared in
   `src/surface.ts` and checked against the installed Xcode in CI.
 
-[unreleased]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.9...HEAD
+[unreleased]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.11...HEAD
+[0.1.11]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.10...v0.1.11
+[0.1.10]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.9...v0.1.10
 [0.1.9]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/alexrrouse/xcodebuild-axi/compare/v0.1.6...v0.1.7

package/README.md

@@ -4,7 +4,7 @@
   <a href="https://www.npmjs.com/package/xcodebuild-axi"><img alt="npm" src="https://img.shields.io/npm/v/xcodebuild-axi?style=flat-square" /></a>
   <a href="https://axi.md/"><img alt="AXI" src="https://img.shields.io/badge/AXI-compliant-blue?style=flat-square" /></a>
   <img alt="Platform" src="https://img.shields.io/badge/platform-macOS-lightgrey?style=flat-square" />
-  <!-- coverage-badge:start --><img alt="xcodebuild coverage" src="https://img.shields.io/badge/xcodebuild_coverage-91.3%25-brightgreen?style=flat-square" /><!-- coverage-badge:end -->
+  <!-- coverage-badge:start --><img alt="xcodebuild coverage" src="https://img.shields.io/badge/xcodebuild_coverage-99.4%25-brightgreen?style=flat-square" /><!-- coverage-badge:end -->
   <img alt="License" src="https://img.shields.io/badge/license-MIT-green?style=flat-square" />
 </p>
 
@@ -171,7 +171,7 @@ Every command takes `--help`.
 
 <!-- coverage:start -->
 
-**Coverage: 91.3% of the 161 leaves `xcodebuild` documents** — every option, build action, export options key, `-create-xcframework` argument, and the second forms that only a usage line mentions.
+**Coverage: 99.4% of the 161 leaves `xcodebuild` documents** — every option, build action, export options key, `-create-xcframework` argument, and the second forms that only a usage line mentions.
 
 A leaf is one switch you could type. Counting options alone says 100% (117/117), which was true and hid every gap below: an option is one thing, and `-exportOptionsPlist` alone opens eighteen more.
 
@@ -179,10 +179,10 @@ A leaf is one switch you could type. Counting options alone says 100% (117/117),
 | ------------------------------------------------------ | ------- | --------------- |
 | `xcodebuild -help` options                             | 117     | 117 (100%)      |
 | build actions                                          | 10      | 9 (90%)         |
-| second forms (`-version <infoitem>`, `-license check`) | 8       | 7 (87.5%)       |
-| `-exportOptionsPlist` keys                             | 18      | 6 (33.3%)       |
+| second forms (`-version <infoitem>`, `-license check`) | 8       | 8 (100%)        |
+| `-exportOptionsPlist` keys                             | 18      | 18 (100%)       |
 | `-create-xcframework` options                          | 8       | 8 (100%)        |
-| **total**                                              | **161** | **147 (91.3%)** |
+| **total**                                              | **161** | **160 (99.4%)** |
 
 **Reach: 100%** of the 328 command-and-option pairs. The same options, counted once per command xcodebuild accepts them on — because `-target` exposed on `build` and missing from `settings` is not covered for anyone asking `settings`. 0 pairs are open.
 
@@ -204,65 +204,33 @@ The one action left out is `installsrc` — it copies sources into `SRCROOT` as
 
 ### Companion tools
 
-`xcresulttool`, `xccov` and `simctl` are not xcodebuild, so they are not in the number above — but this tool wraps all three, and an agent that has to shell out to one directly has dropped back down. **18.3% of 71 leaves**, counted the same way:
+`xcresulttool`, `xccov` and `simctl` are not xcodebuild, so they are not in the number above — but this tool wraps all three, and an agent that has to shell out to one directly has dropped back down. **43.7% of 71 leaves**, counted the same way:
 
 | Tool           | Leaves | Covered   |
 | -------------- | ------ | --------- |
-| `xcresulttool` | 21     | 4 (19%)   |
-| `xccov`        | 9      | 4 (44.4%) |
+| `xcresulttool` | 21     | 17 (81%)  |
+| `xccov`        | 9      | 9 (100%)  |
 | `simctl`       | 41     | 5 (12.2%) |
 
 ### Still open
 
-45 leaves are known gaps rather than decisions — each one a reason someone would still reach for the raw tool:
-
-| Leaf                                                        | Unreachable from | What that costs                                                                                         |
-| ----------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------- |
-| `-version -sdk <name> <infoitem>`                           | `info`           | `info --sdks` lists canonical names; an SDK's Path or ProductBuildVersion cannot be asked for           |
-| `<buildsetting>=<value>`                                    | `build`          | an override can be resolved but not built with, so `--setting` answers a question it cannot then act on |
-| `provisioningProfiles` (export options)                     | `export`         | manual signing can be asked for but not completed — the profile per executable has no flag              |
-| `signingCertificate` (export options)                       | `export`         | manual signing cannot name the certificate to sign with                                                 |
-| `installerSigningCertificate` (export options)              | `export`         | a macOS installer package cannot name its signing certificate                                           |
-| `thinning` (export options)                                 | `export`         | non-App Store exports cannot be thinned for a device variant                                            |
-| `stripSwiftSymbols` (export options)                        | `export`         | Swift symbols are always stripped, with no way to keep them                                             |
-| `testFlightInternalTestingOnly` (export options)            | `export`         | a build cannot be marked internal-only, which is what a PR build wants                                  |
-| `distributionBundleIdentifier` (export options)             | `export`         | an archive with several apps cannot pick which one to export                                            |
-| `generateAppStoreInformation` (export options)              | `export`         | App Store information cannot be generated for an upload                                                 |
-| `iCloudContainerEnvironment` (export options)               | `export`         | a CloudKit app cannot choose the Development or Production container                                    |
-| `manifest` (export options)                                 | `export`         | an over-the-web distribution manifest cannot be written                                                 |
-| `embedOnDemandResourcesAssetPacksInBundle` (export options) | `export`         | on-demand resource asset packs cannot be embedded for testing                                           |
-| `onDemandResourcesAssetPacksBaseURL` (export options)       | `export`         | on-demand resource asset packs cannot be pointed at a host                                              |
-| `xcresulttool get test-results tests`                       | `result`         | the full test tree of a finished run cannot be listed                                                   |
-| `xcresulttool get test-results activities`                  | `result`         | the step-by-step activity trail of a failing test cannot be read                                        |
-| `xcresulttool get test-results insights`                    | `result`         | Xcode's own diagnosis of a run is left on the floor                                                     |
-| `xcresulttool get test-results metrics`                     | `result`         | `test --perf-diagnostics` collects performance metrics nothing can read back                            |
-| `xcresulttool get log`                                      | `result`         | the build log inside the bundle is reachable only as the raw transcript file                            |
-| `xcresulttool get content-availability`                     | `result`         | whether a bundle even has coverage or test results is found out by failing to read it                   |
-| `xcresulttool export diagnostics`                           | `result`         | `test --diagnostics` collects a diagnostics report that cannot be extracted                             |
-| `xcresulttool export attachments`                           | `result`         | UI test screenshots and attachments cannot be got out of the bundle                                     |
-| `xcresulttool export metrics`                               | `result`         | performance measurements cannot be exported as CSV                                                      |
-| `xcresulttool export evaluations`                           | `result`         | evaluation attachments cannot be exported                                                               |
-| `xcresulttool compare`                                      | `result`         | two runs cannot be diffed, which is the question CI asks most                                           |
-| `xcresulttool merge`                                        | `result`         | the bundles of a sharded test run cannot be combined                                                    |
-| `xcresulttool metadata`                                     | `result`         | a bundle's own metadata cannot be read                                                                  |
-| `xccov view --report --functions-for-file`                  | `coverage`       | coverage stops at the file, so the uncovered function has no name                                       |
-| `xccov view --archive`                                      | `coverage`       | a standalone .xccovarchive cannot be read, only a result bundle                                         |
-| `xccov view --file`                                         | `coverage`       | the per-line coverage of one file cannot be printed                                                     |
-| `xccov diff`                                                | `coverage`       | 'did coverage drop' cannot be answered from two bundles this tool wrote                                 |
-| `xccov merge`                                               | `coverage`       | the coverage of a sharded run cannot be combined                                                        |
-| `simctl install`                                            | `sim`            | a built .app cannot be put on the simulator it was built for                                            |
-| `simctl launch`                                             | `sim`            | the app a build just produced cannot be run                                                             |
-| `simctl terminate`                                          | `?`              | a running app cannot be stopped                                                                         |
-| `simctl uninstall`                                          | `?`              | an installed app cannot be removed                                                                      |
-| `simctl listapps`                                           | `sim`            | what is installed on a simulator cannot be listed                                                       |
-| `simctl create`                                             | `?`              | a missing device cannot be created                                                                      |
-| `simctl delete`                                             | `sim`            | stale devices cannot be reclaimed, and they cost gigabytes                                              |
-| `simctl io`                                                 | `sim`            | a screenshot of a failing UI cannot be taken                                                            |
-| `simctl openurl`                                            | `sim`            | a deep link cannot be opened, which is how deep links are tested                                        |
-| `simctl privacy`                                            | `sim`            | a permission prompt cannot be granted ahead of a UI test                                                |
-| `simctl push`                                               | `sim`            | a push notification cannot be simulated                                                                 |
-| `simctl status_bar`                                         | `sim`            | the status bar cannot be pinned, which screenshot tests need                                            |
-| `simctl ui`                                                 | `sim`            | dark mode and content size cannot be set for a test run                                                 |
+13 leaves are known gaps rather than decisions — each one a reason someone would still reach for the raw tool:
+
+| Leaf                | Unreachable from | What that costs                                                  |
+| ------------------- | ---------------- | ---------------------------------------------------------------- |
+| `simctl install`    | `sim`            | a built .app cannot be put on the simulator it was built for     |
+| `simctl launch`     | `sim`            | the app a build just produced cannot be run                      |
+| `simctl terminate`  | `?`              | a running app cannot be stopped                                  |
+| `simctl uninstall`  | `?`              | an installed app cannot be removed                               |
+| `simctl listapps`   | `sim`            | what is installed on a simulator cannot be listed                |
+| `simctl create`     | `?`              | a missing device cannot be created                               |
+| `simctl delete`     | `sim`            | stale devices cannot be reclaimed, and they cost gigabytes       |
+| `simctl io`         | `sim`            | a screenshot of a failing UI cannot be taken                     |
+| `simctl openurl`    | `sim`            | a deep link cannot be opened, which is how deep links are tested |
+| `simctl privacy`    | `sim`            | a permission prompt cannot be granted ahead of a UI test         |
+| `simctl push`       | `sim`            | a push notification cannot be simulated                          |
+| `simctl status_bar` | `sim`            | the status bar cannot be pinned, which screenshot tests need     |
+| `simctl ui`         | `sim`            | dark mode and content size cannot be set for a test run          |
 
 The denominator is read from `xcodebuild -help` rather than hand-maintained, and this table is written against **Xcode 27.0** — the option list moves between releases. `npm run coverage:check` fails on that Xcode if an option here is unclassified or has been dropped, and reports the difference without failing on any other.
 

package/dist/src/archive.d.ts

@@ -19,17 +19,46 @@ export declare function readArchiveInfo(archivePath: string): Promise<ArchiveInf
 /** The `method` values Xcode 27 accepts in an export options plist. */
 export declare const EXPORT_METHODS: readonly ["app-store-connect", "release-testing", "enterprise", "debugging", "developer-id", "mac-application", "validation"];
 /**
- * Build a minimal export options plist.
+ * The names Xcode 26 and earlier used, which every existing pipeline and every
+ * answer written before Xcode 27 still says. xcodebuild itself still accepts
+ * them, so refusing them here would be this tool being stricter than the thing
+ * it wraps.
+ */
+export declare const EXPORT_METHOD_ALIASES: Record<string, string>;
+/**
+ * Every key `-exportOptionsPlist` accepts, and what it is for.
  *
- * `-exportArchive` requires one, and authoring XML by hand is exactly the kind
- * of unguessable side quest an agent fails at. Given a method (and optionally
- * a team), the plist is derivable, so derive it.
+ * The plist is the whole configuration surface of `-exportArchive`. A key with
+ * no flag in front of it is a key that sends the agent back to authoring XML,
+ * which is the side quest this file exists to remove.
  */
-export declare function exportOptionsPlist(options: {
+export interface ExportOptions {
     method: string;
     destination?: string;
     teamID?: string;
     signingStyle?: string;
+    signingCertificate?: string;
+    installerSigningCertificate?: string;
+    /** Bundle identifier -> profile name or UUID, for manual signing. */
+    provisioningProfiles?: Record<string, string>;
+    distributionBundleIdentifier?: string;
     uploadSymbols?: boolean;
+    stripSwiftSymbols?: boolean;
     manageAppVersionAndBuildNumber?: boolean;
-}): string;
+    testFlightInternalTestingOnly?: boolean;
+    generateAppStoreInformation?: boolean;
+    iCloudContainerEnvironment?: string;
+    thinning?: string;
+    /** appURL, displayImageURL and fullSizeImageURL, for web distribution. */
+    manifest?: Record<string, string>;
+    embedOnDemandResourcesAssetPacksInBundle?: boolean;
+    onDemandResourcesAssetPacksBaseURL?: string;
+}
+/**
+ * Build an export options plist.
+ *
+ * `-exportArchive` requires one, and authoring XML by hand is exactly the kind
+ * of unguessable side quest an agent fails at. Given a method (and whatever
+ * else was asked for), the plist is derivable, so derive it.
+ */
+export declare function exportOptionsPlist(options: ExportOptions): string;

package/dist/src/archive.js

@@ -46,31 +46,52 @@ export const EXPORT_METHODS = [
     "validation",
 ];
 /**
- * Build a minimal export options plist.
+ * The names Xcode 26 and earlier used, which every existing pipeline and every
+ * answer written before Xcode 27 still says. xcodebuild itself still accepts
+ * them, so refusing them here would be this tool being stricter than the thing
+ * it wraps.
+ */
+export const EXPORT_METHOD_ALIASES = {
+    "app-store": "app-store-connect",
+    "ad-hoc": "release-testing",
+    development: "debugging",
+};
+/**
+ * The order keys are written in. Xcode does not care, but a generated file a
+ * human may end up reading should group signing with signing.
+ */
+const EXPORT_OPTION_ORDER = [
+    "method",
+    "destination",
+    "teamID",
+    "signingStyle",
+    "signingCertificate",
+    "installerSigningCertificate",
+    "provisioningProfiles",
+    "distributionBundleIdentifier",
+    "uploadSymbols",
+    "stripSwiftSymbols",
+    "manageAppVersionAndBuildNumber",
+    "testFlightInternalTestingOnly",
+    "generateAppStoreInformation",
+    "iCloudContainerEnvironment",
+    "thinning",
+    "manifest",
+    "embedOnDemandResourcesAssetPacksInBundle",
+    "onDemandResourcesAssetPacksBaseURL",
+];
+/**
+ * Build an export options plist.
  *
  * `-exportArchive` requires one, and authoring XML by hand is exactly the kind
- * of unguessable side quest an agent fails at. Given a method (and optionally
- * a team), the plist is derivable, so derive it.
+ * of unguessable side quest an agent fails at. Given a method (and whatever
+ * else was asked for), the plist is derivable, so derive it.
  */
 export function exportOptionsPlist(options) {
-    const entries = [
-        `  <key>method</key>\n  <string>${options.method}</string>`,
-    ];
-    if (options.destination) {
-        entries.push(`  <key>destination</key>\n  <string>${options.destination}</string>`);
-    }
-    if (options.teamID) {
-        entries.push(`  <key>teamID</key>\n  <string>${options.teamID}</string>`);
-    }
-    if (options.signingStyle) {
-        entries.push(`  <key>signingStyle</key>\n  <string>${options.signingStyle}</string>`);
-    }
-    if (options.uploadSymbols !== undefined) {
-        entries.push(`  <key>uploadSymbols</key>\n  <${options.uploadSymbols}/>`);
-    }
-    if (options.manageAppVersionAndBuildNumber !== undefined) {
-        entries.push(`  <key>manageAppVersionAndBuildNumber</key>\n  <${options.manageAppVersionAndBuildNumber}/>`);
-    }
+    const entries = EXPORT_OPTION_ORDER.flatMap((key) => {
+        const value = options[key];
+        return value === undefined ? [] : [`  <key>${key}</key>\n${render(value)}`];
+    });
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -80,4 +101,25 @@ ${entries.join("\n")}
 </plist>
 `;
 }
+function render(value) {
+    if (typeof value === "boolean")
+        return `  <${value}/>`;
+    if (typeof value === "string")
+        return `  <string>${escapeXml(value)}</string>`;
+    const inner = Object.entries(value)
+        .map(([key, entry]) => `    <key>${escapeXml(key)}</key>\n    <string>${escapeXml(entry)}</string>`)
+        .join("\n");
+    return `  <dict>\n${inner}\n  </dict>`;
+}
+/**
+ * A manifest URL with a query string carries `&`, and an unescaped one makes
+ * the plist unparseable -- which xcodebuild reports as a failed export rather
+ * than as a bad file.
+ */
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
 //# sourceMappingURL=archive.js.map

package/dist/src/archive.js.map

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

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

@@ -1,3 +1,14 @@
-export declare const COVERAGE_HELP = "usage: xcodebuild-axi coverage <path.xcresult> [flags]\nReads code coverage out of a result bundle \u2014 one percentage per target, not the\nthousands of per-file lines xccov prints by default.\nflags[4]:\n  --files            list per-file coverage as well as per-target\n  --target <name>    only this target\n  --below <percent>  only files under this coverage, e.g. --below 50\n  --max <n>          rows to list before summarizing the rest (default: 25)\nnote:\n  Coverage has to have been collected. Run the tests with\n  `xcodebuild-axi test --coverage` if the bundle has none.\nexamples:\n  xcodebuild-axi coverage ~/Library/Caches/xcodebuild-axi/MyApps-1a2b3c4d/MyApp-test.xcresult\n  xcodebuild-axi coverage build/MyApp.xcresult --files --below 50\n";
-export declare const COVERAGE_FLAGS: readonly ["--files", "--target", "--below", "--max"];
+import { type CoverageLine } from "../xccov.js";
+export declare const COVERAGE_HELP = "usage: xcodebuild-axi coverage <path> [flags]\nReads code coverage out of a result bundle \u2014 one percentage per target, not the\nthousands of per-file lines xccov prints by default. The path can also be an\n.xccovreport or .xccovarchive.\nflags[9]:\n  --files            list per-file coverage as well as per-target\n  --target <name>    only this target\n  --below <percent>  only files under this coverage, e.g. --below 50\n  --functions <file> per-function coverage for one file, so an uncovered\n                     branch has a name\n  --lines <file>     how many times each line of one file ran\n  --against <path>   compare coverage with an earlier run: what moved, and\n                     which files went with it\n  --merge            combine the coverage of two or more runs into one report\n  --to <path>        where --merge writes (default: under ~/Library/Caches)\n  --max <n>          rows to list before summarizing the rest (default: 25)\nnote:\n  Coverage has to have been collected. Run the tests with\n  `xcodebuild-axi test --coverage` if the bundle has none.\n\n  --lines reads the archive rather than the report: the report knows what\n  percentage of a file ran, the archive knows how many times each line did.\nexamples:\n  xcodebuild-axi coverage ~/Library/Caches/xcodebuild-axi/MyApps-1a2b3c4d/MyApp-test.xcresult\n  xcodebuild-axi coverage build/MyApp.xcresult --files --below 50\n  xcodebuild-axi coverage build/MyApp.xcresult --functions Checkout.swift\n  xcodebuild-axi coverage build/MyApp.xcresult --against build/baseline.xcresult\n";
+export declare const COVERAGE_FLAGS: readonly ["--files", "--target", "--below", "--functions", "--lines", "--against", "--merge", "--to", "--max"];
 export declare function coverageCommand(args: string[]): Promise<string>;
+/** Consecutive lines that never ran, as ranges rather than one row each. */
+export declare function uncoveredRanges(lines: CoverageLine[]): Array<Record<string, unknown>>;
+/**
+ * Which way coverage moved, in words.
+ *
+ * Words rather than a signed percentage because TOON quotes any scalar that
+ * starts with `-`, and `"-2.1%"` costs more in quotes than `down 2.1%` costs
+ * in letters.
+ */
+export declare function movement(delta: number): string;