Attempting to do CI to run unit tests on all PRs.

.github/actions/simctl-pick-a-tricorder/README.md

@@ -0,0 +1,61 @@
+# Simctl Pick A Tricorder
+
+Local composite action for choosing an installed simulator device from `xcrun simctl list devices --json`.
+
+## Inputs
+
+- `device_types`
+  - Ordered, comma-separated list of device types to return simulators for.
+  - Supported values: `iphone`, `ipad`, `macos`, `watch`, `vision`
+- `selection_mode`
+  - `random-compatible`
+  - `random-latest-compatible`
+  - `model-type`
+  - `latest-model`
+- `model_preferences`
+  - Semicolon-separated mappings such as `iphone=Pro Max;ipad=Pro;watch=Ultra`
+- `iphoneos_version`, `ipados_version`, `macos_version`, `watchos_version`, `visionos_version`
+  - A specific version like `18`, `18.2`, `15.0`
+  - Or `latest`
+
+`device_types` is required. The action returns exactly one simulator destination per requested device type, in the same order the device types were specified. If any requested device type cannot be satisfied, the action fails.
+
+## Outputs
+
+- `simulator_jsons`
+- `destination_ids`
+
+`simulator_jsons` returns one object per found simulator with:
+- `udid`
+- `name`
+- `os`
+- `modelType`
+- `safe_name`
+
+## Example
+
+```yaml
+- name: Pick simulator
+  id: simulator
+  uses: ./.github/actions/simctl-pick-a-tricorder
+  with:
+    device_types: iphone,ipad
+    iphoneos_version: latest
+    ipados_version: latest
+    selection_mode: random-latest-compatible
+
+- name: Run tests
+  id: tests
+  uses: ./.github/actions/xcode-test-the-tricorders
+  with:
+    scheme: libPhoneNumber
+    xcode_container: libPhoneNumber.xcodeproj
+    destination_ids: ${{ steps.simulator.outputs.destination_ids }}
+    simulator_jsons: ${{ steps.simulator.outputs.simulator_jsons }}
+
+- name: Upload unit test results
+  uses: actions/upload-artifact@v6
+  with:
+    name: project-unit-tests-libPhoneNumber
+    path: ${{ steps.tests.outputs.result_bundle_directory }}
+```

.github/actions/simctl-pick-a-tricorder/action.yml

@@ -0,0 +1,61 @@
+name: Simctl Pick A Tricorder
+description: Select a compatible Apple simulator device from the installed simctl inventory.
+
+inputs:
+  device_types:
+    description: "Ordered, comma-separated list of device types to consider. Supported values: iphone, ipad, macos, watch, vision."
+    required: true
+  selection_mode:
+    description: "One of random-compatible, random-latest-compatible, model-type, latest-model."
+    required: false
+    default: random-compatible
+  model_preferences:
+    description: 'Semicolon-separated device type mappings such as "iphone=Pro Max;ipad=Pro;watch=Ultra;vision=Pro".'
+    required: false
+    default: ""
+  iphoneos_version:
+    description: "Specific iOS version for iPhone devices, or latest."
+    required: false
+    default: latest
+  ipados_version:
+    description: "Specific iOS version for iPad devices, or latest."
+    required: false
+    default: latest
+  macos_version:
+    description: "Specific macOS version for macOS simulator devices, or latest."
+    required: false
+    default: latest
+  watchos_version:
+    description: "Specific watchOS version for watch devices, or latest."
+    required: false
+    default: latest
+  visionos_version:
+    description: "Specific visionOS version for Vision devices, or latest."
+    required: false
+    default: latest
+
+outputs:
+  simulator_jsons:
+    description: "The selected simulators as a JSON array of objects with udid, name, os, and modelType."
+    value: ${{ steps.pick.outputs.simulator_jsons }}
+  destination_ids:
+    description: "The selected simulator UDIDs as a newline-separated list."
+    value: ${{ steps.pick.outputs.destination_ids }}
+
+runs:
+  using: composite
+  steps:
+    - name: Pick simulator
+      id: pick
+      shell: bash
+      run: |
+        set -eo pipefail
+        python3 "${{ github.action_path }}/pick_simulator.py" \
+          --device-types "${{ inputs.device_types }}" \
+          --selection-mode "${{ inputs.selection_mode }}" \
+          --model-preferences "${{ inputs.model_preferences }}" \
+          --iphoneos-version "${{ inputs.iphoneos_version }}" \
+          --ipados-version "${{ inputs.ipados_version }}" \
+          --macos-version "${{ inputs.macos_version }}" \
+          --watchos-version "${{ inputs.watchos_version }}" \
+          --visionos-version "${{ inputs.visionos_version }}"