@invarn/cibuild 1.7.0 → 1.9.0

package/dist/src/yaml/steps/xcode-destination.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for the shared "auto destination" resolver.
+ *
+ * The resolver consumes the JSON `xcrun simctl list devices available --json`
+ * would produce on a macOS runner, and returns the canonical
+ * `platform=iOS Simulator,OS=<v>,name=<name>` string to feed to xcodebuild.
+ */
+export {};
+//# sourceMappingURL=xcode-destination.test.d.ts.map

package/dist/src/yaml/steps/xcode-destination.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xcode-destination.test.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/xcode-destination.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/src/yaml/steps/xcode-destination.test.js

@@ -0,0 +1,227 @@
+/**
+ * Tests for the shared "auto destination" resolver.
+ *
+ * The resolver consumes the JSON `xcrun simctl list devices available --json`
+ * would produce on a macOS runner, and returns the canonical
+ * `platform=iOS Simulator,OS=<v>,name=<name>` string to feed to xcodebuild.
+ */
+import { describe, test, expect } from '@jest/globals';
+import { AutoDestinationError, resolveAutoDestinationFromSimctlJson, resolveDestinationInput, } from './xcode-destination.js';
+import { XcodeBuildStepExecutor, XcodeTestStepExecutor, XcodeBuildForTestStepExecutor, XcodeTestWithoutBuildingStepExecutor, XcodeBuildForSimulatorStepExecutor, } from './xcode.js';
+import { testConfig } from './test-config.js';
+describe('resolveAutoDestinationFromSimctlJson', () => {
+    test('picks the newest iPhone in the highest iOS runtime', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    {
+                        name: 'iPhone 16',
+                        isAvailable: true,
+                        state: 'Shutdown',
+                        udid: 'AAA',
+                    },
+                ],
+            },
+        };
+        const resolved = resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl));
+        expect(resolved).toBe('platform=iOS Simulator,OS=18.0,name=iPhone 16');
+    });
+    test('higher iOS runtime wins (iOS 18.0 beats iOS 17.5), even if older runtime has newer model', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-17-5': [
+                    // Pretend iPhone 16 also shows up here — runtime version should still win.
+                    { name: 'iPhone 16', isAvailable: true, udid: 'old' },
+                ],
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    { name: 'iPhone 15', isAvailable: true, udid: 'new' },
+                ],
+            },
+        };
+        const resolved = resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl));
+        expect(resolved).toBe('platform=iOS Simulator,OS=18.0,name=iPhone 15');
+    });
+    test('Pro Max wins over Pro and plain at same model number', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    { name: 'iPhone 16', isAvailable: true, udid: '1' },
+                    { name: 'iPhone 16 Pro', isAvailable: true, udid: '2' },
+                    { name: 'iPhone 16 Pro Max', isAvailable: true, udid: '3' },
+                ],
+            },
+        };
+        const resolved = resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl));
+        expect(resolved).toBe('platform=iOS Simulator,OS=18.0,name=iPhone 16 Pro Max');
+    });
+    test('Pro wins over plain when Pro Max is missing', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    { name: 'iPhone 16', isAvailable: true, udid: '1' },
+                    { name: 'iPhone 16 Pro', isAvailable: true, udid: '2' },
+                ],
+            },
+        };
+        const resolved = resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl));
+        expect(resolved).toBe('platform=iOS Simulator,OS=18.0,name=iPhone 16 Pro');
+    });
+    test('higher iPhone model number wins (iPhone 16 beats iPhone 15)', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    { name: 'iPhone 15', isAvailable: true, udid: '1' },
+                    { name: 'iPhone 16', isAvailable: true, udid: '2' },
+                    { name: 'iPhone 14', isAvailable: true, udid: '3' },
+                    { name: 'iPhone SE (3rd generation)', isAvailable: true, udid: '4' },
+                ],
+            },
+        };
+        const resolved = resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl));
+        expect(resolved).toBe('platform=iOS Simulator,OS=18.0,name=iPhone 16');
+    });
+    test('throws documented error when no iPhone simulator runtime is installed', () => {
+        const simctl = { devices: {} };
+        expect(() => resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl))).toThrow(AutoDestinationError);
+        expect(() => resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl))).toThrow(/no iPhone simulator runtimes are installed/);
+    });
+    test('throws documented error when iOS runtime has no iPhone devices (e.g. only iPads)', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    { name: 'iPad Pro (11-inch)', isAvailable: true, udid: '1' },
+                ],
+            },
+        };
+        expect(() => resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl))).toThrow(/no iPhone simulator runtimes are installed/);
+    });
+    test('throws documented error on unparseable JSON', () => {
+        expect(() => resolveAutoDestinationFromSimctlJson('not-json')).toThrow(/xcrun simctl returned no usable output/);
+    });
+    test('resolveDestinationInput passes literal destinations through verbatim', () => {
+        const literal = 'platform=iOS Simulator,name=iPhone 14,OS=17.5';
+        expect(resolveDestinationInput(literal)).toBe(literal);
+    });
+    test('resolveDestinationInput delegates to injected resolver only when value === "auto"', () => {
+        const fakeResolver = () => 'platform=iOS Simulator,OS=99.9,name=iPhone Fixture';
+        expect(resolveDestinationInput('auto', fakeResolver)).toBe('platform=iOS Simulator,OS=99.9,name=iPhone Fixture');
+        // Pass-through still wins when value is anything else, even if a resolver is provided.
+        expect(resolveDestinationInput('generic/platform=iOS', fakeResolver)).toBe('generic/platform=iOS');
+    });
+    test('ignores unavailable iPhones', () => {
+        const simctl = {
+            devices: {
+                'com.apple.CoreSimulator.SimRuntime.iOS-18-0': [
+                    { name: 'iPhone 16', isAvailable: false, udid: '1' },
+                    { name: 'iPhone 15', isAvailable: true, udid: '2' },
+                ],
+            },
+        };
+        const resolved = resolveAutoDestinationFromSimctlJson(JSON.stringify(simctl));
+        expect(resolved).toBe('platform=iOS Simulator,OS=18.0,name=iPhone 15');
+    });
+});
+/**
+ * Each affected executor must (a) embed a literal destination unchanged and
+ * (b) add an `xcrun` validation requirement only when destination === "auto".
+ *
+ * The "auto" execute() path is not exercised here — it shells out to xcrun.
+ * The pure parser tests above cover its correctness; the manual smoke test in
+ * the spike's "done criteria" covers the end-to-end shell-out.
+ */
+describe('xcode-* executors — destination input wiring', () => {
+    const xcrunReq = (reqs) => reqs.find((r) => r.category === 'command' && r.name === 'xcrun');
+    describe('XcodeBuildStepExecutor', () => {
+        test('literal destination is embedded in the script unchanged', async () => {
+            const executor = new XcodeBuildStepExecutor();
+            const result = await executor.execute({
+                project_path: 'MyApp.xcodeproj',
+                scheme: 'MyApp',
+                destination: 'platform=iOS Simulator,name=iPhone 99,OS=99.0',
+            }, {}, testConfig);
+            expect(result.script).toContain('platform=iOS Simulator,name=iPhone 99,OS=99.0');
+        });
+        test('validation requires xcrun only when destination === "auto"', () => {
+            const executor = new XcodeBuildStepExecutor();
+            const autoReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp', destination: 'auto' }, {}, testConfig);
+            expect(xcrunReq(autoReqs)).toBeDefined();
+            const literalReqs = executor.getValidationRequirements({
+                project_path: 'MyApp.xcodeproj',
+                scheme: 'MyApp',
+                destination: 'platform=iOS Simulator,name=iPhone 16,OS=18.0',
+            }, {}, testConfig);
+            expect(xcrunReq(literalReqs)).toBeUndefined();
+            const defaultReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp' }, {}, testConfig);
+            expect(xcrunReq(defaultReqs)).toBeUndefined();
+        });
+    });
+    describe('XcodeTestStepExecutor', () => {
+        test('literal destination is embedded in the script unchanged', async () => {
+            const executor = new XcodeTestStepExecutor();
+            const result = await executor.execute({
+                project_path: 'MyApp.xcodeproj',
+                scheme: 'MyApp',
+                destination: 'platform=iOS Simulator,name=iPhone 99,OS=99.0',
+            }, {}, testConfig);
+            expect(result.script).toContain('platform=iOS Simulator,name=iPhone 99,OS=99.0');
+        });
+        test('validation requires xcrun only when destination === "auto"', () => {
+            const executor = new XcodeTestStepExecutor();
+            const autoReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp', destination: 'auto' }, {}, testConfig);
+            expect(xcrunReq(autoReqs)).toBeDefined();
+            const literalReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp' }, {}, testConfig);
+            expect(xcrunReq(literalReqs)).toBeUndefined();
+        });
+    });
+    describe('XcodeBuildForTestStepExecutor', () => {
+        test('literal destination is embedded in the script unchanged', async () => {
+            const executor = new XcodeBuildForTestStepExecutor();
+            const result = await executor.execute({
+                project_path: 'MyApp.xcodeproj',
+                scheme: 'MyApp',
+                destination: 'generic/platform=iOS Simulator',
+            }, {}, testConfig);
+            expect(result.script).toContain('generic/platform=iOS Simulator');
+        });
+        test('validation requires xcrun only when destination === "auto"', () => {
+            const executor = new XcodeBuildForTestStepExecutor();
+            const autoReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp', destination: 'auto' }, {}, testConfig);
+            expect(xcrunReq(autoReqs)).toBeDefined();
+            const literalReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp' }, {}, testConfig);
+            expect(xcrunReq(literalReqs)).toBeUndefined();
+        });
+    });
+    describe('XcodeTestWithoutBuildingStepExecutor', () => {
+        test('literal destination is embedded in the script unchanged', async () => {
+            const executor = new XcodeTestWithoutBuildingStepExecutor();
+            const result = await executor.execute({ destination: 'platform=iOS Simulator,name=iPhone 99,OS=99.0' }, {}, testConfig);
+            expect(result.script).toContain('platform=iOS Simulator,name=iPhone 99,OS=99.0');
+        });
+        test('validation requires xcrun only when destination === "auto"', () => {
+            const executor = new XcodeTestWithoutBuildingStepExecutor();
+            const autoReqs = executor.getValidationRequirements({ destination: 'auto' }, {}, testConfig);
+            expect(xcrunReq(autoReqs)).toBeDefined();
+            const literalReqs = executor.getValidationRequirements({}, {}, testConfig);
+            expect(xcrunReq(literalReqs)).toBeUndefined();
+        });
+    });
+    describe('XcodeBuildForSimulatorStepExecutor', () => {
+        test('literal destination is embedded in the script unchanged', async () => {
+            const executor = new XcodeBuildForSimulatorStepExecutor();
+            const result = await executor.execute({
+                project_path: 'MyApp.xcodeproj',
+                scheme: 'MyApp',
+                destination: 'generic/platform=watchOS Simulator',
+            }, {}, testConfig);
+            expect(result.script).toContain('generic/platform=watchOS Simulator');
+        });
+        test('validation requires xcrun only when destination === "auto"', () => {
+            const executor = new XcodeBuildForSimulatorStepExecutor();
+            const autoReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp', destination: 'auto' }, {}, testConfig);
+            expect(xcrunReq(autoReqs)).toBeDefined();
+            const literalReqs = executor.getValidationRequirements({ project_path: 'MyApp.xcodeproj', scheme: 'MyApp' }, {}, testConfig);
+            expect(xcrunReq(literalReqs)).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=xcode-destination.test.js.map

package/dist/src/yaml/steps/xcode.d.ts

@@ -180,7 +180,7 @@ export interface XcodeTestWithoutBuildingInputs {
  * Runs pre-compiled tests from an .xctestrun file.
  */
 export declare class XcodeTestWithoutBuildingStepExecutor extends BaseStepExecutor {
-    getValidationRequirements(_inputs: XcodeTestWithoutBuildingInputs, _env: Record<string, string>, _config: CIConfig): ValidationRequirement[];
+    getValidationRequirements(inputs: XcodeTestWithoutBuildingInputs, _env: Record<string, string>, _config: CIConfig): ValidationRequirement[];
     getOutputs(): StepOutput[];
     execute(inputs: XcodeTestWithoutBuildingInputs, _env: Record<string, string>, _config: CIConfig): Promise<StepDef>;
 }

package/dist/src/yaml/steps/xcode.d.ts.map

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

package/dist/src/yaml/steps/xcode.js

@@ -3,6 +3,7 @@
  */
 import { existsSync } from 'node:fs';
 import { BaseStepExecutor } from './base.js';
+import { resolveDestinationInput } from './xcode-destination.js';
 /**
  * Xcodebuild step executor
  * Builds iOS/macOS projects using xcodebuild
@@ -19,6 +20,9 @@ export class XcodeBuildStepExecutor extends BaseStepExecutor {
         if (inputs.project_path && !existsSync(inputs.project_path)) {
             requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
         }
+        if (inputs.destination === 'auto') {
+            requirements.push(this.requireCommand('xcrun', 'xcrun is required to resolve destination: auto via xcrun simctl', 'Install Xcode and run: xcode-select --install'));
+        }
         return requirements;
     }
     async execute(inputs, env, config) {
@@ -33,8 +37,9 @@ export class XcodeBuildStepExecutor extends BaseStepExecutor {
         const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
         // Get configuration - defaults to Release
         const configuration = this.getInput(inputs, 'configuration', 'Release');
-        // Get destination - defaults to generic/platform=iOS
-        const destination = this.getInput(inputs, 'destination', 'generic/platform=iOS');
+        // Get destination - defaults to generic/platform=iOS.
+        // `auto` triggers runtime resolution via `xcrun simctl`.
+        const destination = resolveDestinationInput(this.getInput(inputs, 'destination', 'generic/platform=iOS'));
         // Get output directory - defaults to build
         const outputDir = this.getInput(inputs, 'output_dir', 'build');
         // Get clean build flag
@@ -119,6 +124,9 @@ export class XcodeTestStepExecutor extends BaseStepExecutor {
         if (inputs.project_path && !existsSync(inputs.project_path)) {
             requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
         }
+        if (inputs.destination === 'auto') {
+            requirements.push(this.requireCommand('xcrun', 'xcrun is required to resolve destination: auto via xcrun simctl', 'Install Xcode and run: xcode-select --install'));
+        }
         return requirements;
     }
     async execute(inputs, env, config) {
@@ -131,8 +139,9 @@ export class XcodeTestStepExecutor extends BaseStepExecutor {
         }
         // Get scheme - required
         const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
-        // Get destination - defaults to platform=iOS Simulator
-        const destination = this.getInput(inputs, 'destination', 'platform=iOS Simulator,name=iPhone 14,OS=latest');
+        // Get destination - defaults to platform=iOS Simulator.
+        // `auto` triggers runtime resolution via `xcrun simctl`.
+        const destination = resolveDestinationInput(this.getInput(inputs, 'destination', 'platform=iOS Simulator,name=iPhone 14,OS=latest'));
         // Get test plan - optional
         const testPlan = this.getInput(inputs, 'test_plan', '');
         // Get code coverage flag
@@ -740,6 +749,9 @@ export class XcodeBuildForTestStepExecutor extends BaseStepExecutor {
         if (inputs.project_path && !existsSync(inputs.project_path)) {
             requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
         }
+        if (inputs.destination === 'auto') {
+            requirements.push(this.requireCommand('xcrun', 'xcrun is required to resolve destination: auto via xcrun simctl', 'Install Xcode and run: xcode-select --install'));
+        }
         return requirements;
     }
     getOutputs() {
@@ -753,7 +765,8 @@ export class XcodeBuildForTestStepExecutor extends BaseStepExecutor {
         const projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
         const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
         const configuration = this.getInput(inputs, 'configuration', 'Debug');
-        const destination = this.getInput(inputs, 'destination', 'generic/platform=iOS Simulator');
+        // `auto` triggers runtime resolution via `xcrun simctl`.
+        const destination = resolveDestinationInput(this.getInput(inputs, 'destination', 'generic/platform=iOS Simulator'));
         const testPlan = this.getInput(inputs, 'test_plan', '');
         const xcconfigContent = this.getInput(inputs, 'xcconfig_content', '');
         const xcodebuildOptions = this.getInput(inputs, 'xcodebuild_options', '');
@@ -828,10 +841,14 @@ export class XcodeBuildForTestStepExecutor extends BaseStepExecutor {
  * Runs pre-compiled tests from an .xctestrun file.
  */
 export class XcodeTestWithoutBuildingStepExecutor extends BaseStepExecutor {
-    getValidationRequirements(_inputs, _env, _config) {
-        return [
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [
             this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required', 'Install Xcode, then run: xcode-select --install'),
         ];
+        if (inputs.destination === 'auto') {
+            requirements.push(this.requireCommand('xcrun', 'xcrun is required to resolve destination: auto via xcrun simctl', 'Install Xcode and run: xcode-select --install'));
+        }
+        return requirements;
     }
     getOutputs() {
         return [
@@ -841,7 +858,8 @@ export class XcodeTestWithoutBuildingStepExecutor extends BaseStepExecutor {
     async execute(inputs, _env, _config) {
         const stepName = 'xcode-test-without-building';
         const xctestrun = this.getInput(inputs, 'xctestrun', '$CIBUILD_XCTESTRUN_FILE_PATH');
-        const destination = this.getInput(inputs, 'destination', 'platform=iOS Simulator,name=iPhone 15,OS=latest');
+        // `auto` triggers runtime resolution via `xcrun simctl`.
+        const destination = resolveDestinationInput(this.getInput(inputs, 'destination', 'platform=iOS Simulator,name=iPhone 15,OS=latest'));
         const onlyTesting = this.getInput(inputs, 'only_testing', '');
         const skipTesting = this.getInput(inputs, 'skip_testing', '');
         const repetitionMode = this.getInput(inputs, 'test_repetition_mode', 'none');
@@ -920,6 +938,9 @@ export class XcodeBuildForSimulatorStepExecutor extends BaseStepExecutor {
         if (inputs.project_path && !existsSync(inputs.project_path)) {
             requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
         }
+        if (inputs.destination === 'auto') {
+            requirements.push(this.requireCommand('xcrun', 'xcrun is required to resolve destination: auto via xcrun simctl', 'Install Xcode and run: xcode-select --install'));
+        }
         return requirements;
     }
     getOutputs() {
@@ -932,7 +953,8 @@ export class XcodeBuildForSimulatorStepExecutor extends BaseStepExecutor {
         const projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
         const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
         const configuration = this.getInput(inputs, 'configuration', '');
-        const destination = this.getInput(inputs, 'destination', 'generic/platform=iOS Simulator');
+        // `auto` triggers runtime resolution via `xcrun simctl`.
+        const destination = resolveDestinationInput(this.getInput(inputs, 'destination', 'generic/platform=iOS Simulator'));
         const performClean = this.getInput(inputs, 'perform_clean_action', 'no');
         const xcconfigContent = this.getInput(inputs, 'xcconfig_content', 'CODE_SIGNING_ALLOWED=NO');
         const xcodebuildOptions = this.getInput(inputs, 'xcodebuild_options', '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invarn/cibuild",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "CI Build CLI — local pipeline orchestration and validation",
   "type": "module",
   "main": "dist/cli.cjs",