@invarn/cibuild 2.8.7 → 2.8.9

package/dist/src/yaml/steps/cocoapods-locked-bundler.test.js

@@ -55,6 +55,9 @@ const run = async (opts) => {
     if (opts.lock !== undefined)
         writeFileSync(join(project, 'Gemfile.lock'), opts.lock);
     writeFileSync(join(project, 'Gemfile'), opts.gemfile ?? "gem 'cocoapods'\n");
+    if (opts.rubyVersionFile !== undefined) {
+        writeFileSync(join(project, '.ruby-version'), opts.rubyVersionFile);
+    }
     const installed = (opts.installed ?? []).join(' ');
     executable(join(bin, 'gem'), `echo "gem $*" >> '${log}'
 if [ "$1" = "list" ]; then
@@ -67,11 +70,24 @@ fi`);
     executable(join(bin, 'bundle'), `echo "bundle $* (GEM_HOME=$GEM_HOME)" >> '${log}'`);
     executable(join(bin, 'pod'), `echo "pod $*" >> '${log}'`);
     executable(join(bin, 'ruby'), `echo "ruby $*" >> '${log}'; printf '2.6.10'`);
-    if (opts.brewRuby) {
+    if (opts.brewRuby || opts.ruby33) {
+        const brewVersion = opts.brewRubyVersion ?? '3.4.1';
         const keg = join(root, 'homebrew-ruby');
-        mkdirSync(join(keg, 'bin'), { recursive: true });
-        executable(join(keg, 'bin', 'ruby'), `echo "brew-ruby $*" >> '${log}'; printf '3.4.1'`);
-        executable(join(bin, 'brew'), `if [ "$*" = "--prefix --installed ruby" ]; then echo '${keg}'; exit 0; fi; exit 1`);
+        const keg33 = join(root, 'homebrew-ruby@3.3');
+        if (opts.brewRuby) {
+            mkdirSync(join(keg, 'bin'), { recursive: true });
+            executable(join(keg, 'bin', 'ruby'), `echo "brew-ruby $*" >> '${log}'; printf '${brewVersion}'`);
+        }
+        if (opts.ruby33) {
+            mkdirSync(join(keg33, 'bin'), { recursive: true });
+            executable(join(keg33, 'bin', 'ruby'), `echo "ruby33 $*" >> '${log}'; printf '3.3.10'`);
+        }
+        executable(join(bin, 'brew'), [
+            `if [ "$*" = "--prefix --installed ruby" ]; then ${opts.brewRuby ? `echo '${keg}'; exit 0` : 'exit 1'}; fi`,
+            `if [ "$*" = "list --versions ruby" ]; then ${opts.brewRuby ? `echo 'ruby ${brewVersion}'; exit 0` : 'exit 1'}; fi`,
+            `if [ "$*" = "--prefix --installed ruby@3.3" ]; then ${opts.ruby33 ? `echo '${keg33}'; exit 0` : 'exit 1'}; fi`,
+            'exit 1',
+        ].join('\n'));
     }
     const script = (await new CocoapodsInstallStepExecutor().execute({ source_root_path: project }, {}, testConfig)).script;
     const scriptPath = join(root, 'step.sh');
@@ -134,12 +150,133 @@ describe('cocoapods-install runs the bundler Gemfile.lock names', () => {
         expect(output).toContain('BUNDLED WITH');
         expect(output).toMatch(/EXIT [1-9]/);
     });
-    // Homebrew's ruby is keg-only, so a guest whose CocoaPods and fastlane came
-    // from Homebrew has it installed and still resolves `ruby` to the system 2.6.
-    test('prefers an installed Homebrew Ruby over system Ruby', async () => {
-        const { calls } = await run({ lock: LOCK_WITH_BUNDLER, brewRuby: true });
-        expect(calls.some((c) => c.startsWith('brew-ruby'))).toBe(true);
-        expect(calls.some((c) => c.startsWith('ruby '))).toBe(false);
+});
+// Issue 08 preferred Homebrew's Ruby whenever it was installed. On the mac
+// image that is Ruby 4, and an old lockfile's gems do not load there: rake
+// 13.0.6 requires `ostruct`, which stopped being a default gem in Ruby 4.0,
+// so a native-extension build died inside rake. The lockfile decides instead:
+// its `RUBY VERSION`, then `.ruby-version`, and system Ruby when neither names
+// one. Homebrew's Ruby only when the named Ruby is 3 or newer.
+describe('cocoapods-install runs the Ruby the project names', () => {
+    const usedBrew = (calls) => calls.some((c) => c.startsWith('brew-ruby'));
+    const usedSystem = (calls) => calls.some((c) => c.startsWith('ruby '));
+    const lockWithRuby = (v) => LOCK_WITH_BUNDLER.replace('BUNDLED WITH', `RUBY VERSION\n   ruby ${v}\n\nBUNDLED WITH`);
+    test('a lock that names no Ruby runs system Ruby, with the locked bundler', async () => {
+        const { calls, output, gemHome } = await run({ lock: LOCK_WITH_BUNDLER, brewRuby: true });
+        expect(usedSystem(calls)).toBe(true);
+        expect(usedBrew(calls)).toBe(false);
+        expect(calls).toContain('gem install bundler -v 2.3.21 --no-document');
+        expect(calls.find((c) => c.startsWith('bundle _2.3.21_ install'))).toContain(`GEM_HOME=${gemHome}`);
+        expect(output).toMatch(/^Ruby: .*\(2\.6\.10\), GEM_HOME: .* — system: lockfile names no Ruby, and no Ruby 3\.3 is installed$/m);
+    });
+    test('a lock whose RUBY VERSION is 3 or newer runs Homebrew Ruby', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('3.3.4p94'), brewRuby: true });
+        expect(usedBrew(calls)).toBe(true);
+        expect(usedSystem(calls)).toBe(false);
+        expect(output).toMatch(/^Ruby: .*homebrew-ruby\/bin\/ruby \(3\.4\.1\), .* — from Gemfile\.lock RUBY VERSION 3\.3\.4$/m);
+    });
+    test('a lock whose RUBY VERSION is 2.x runs system Ruby', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('2.7.2p137'), brewRuby: true });
+        expect(usedBrew(calls)).toBe(false);
+        expect(output).toContain('— from Gemfile.lock RUBY VERSION 2.7.2');
+    });
+    test('the lock outranks .ruby-version', async () => {
+        const { calls, output } = await run({
+            lock: lockWithRuby('3.3.4p94'),
+            rubyVersionFile: '2.7.6\n',
+            brewRuby: true,
+        });
+        expect(usedBrew(calls)).toBe(true);
+        expect(output).toContain('— from Gemfile.lock RUBY VERSION 3.3.4');
+    });
+    test('.ruby-version of 3 or newer runs Homebrew Ruby when the lock names none', async () => {
+        const { calls, output } = await run({ lock: LOCK_WITH_BUNDLER, rubyVersionFile: 'ruby-3.2.2\n', brewRuby: true });
+        expect(usedBrew(calls)).toBe(true);
+        expect(output).toContain('— from .ruby-version 3.2.2');
+    });
+    test('.ruby-version of 2.7 runs system Ruby, and says so', async () => {
+        const { calls, output } = await run({ lock: LOCK_WITH_BUNDLER, rubyVersionFile: '2.7.6\n', brewRuby: true });
+        expect(usedBrew(calls)).toBe(false);
+        expect(usedSystem(calls)).toBe(true);
+        expect(output).toContain('— from .ruby-version 2.7.6');
+    });
+    test('a .ruby-version that names no version is ignored', async () => {
+        const { calls, output } = await run({ lock: LOCK_WITH_BUNDLER, rubyVersionFile: 'system\n', brewRuby: true });
+        expect(usedBrew(calls)).toBe(false);
+        expect(output).toContain('— system: lockfile names no Ruby');
+    });
+    test('Ruby 3 named, no Homebrew Ruby installed: system Ruby, and says so', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('3.3.4p94') });
+        expect(usedSystem(calls)).toBe(true);
+        expect(output).toContain('— from Gemfile.lock RUBY VERSION 3.3.4, but no Homebrew Ruby is installed');
+    });
+    test('a project without cocoapods in its Gemfile never picks a Ruby', async () => {
+        const { calls } = await run({ gemfile: "gem 'fastlane'\n", rubyVersionFile: '3.3.0\n', brewRuby: true });
+        expect(calls).toContain('pod install');
+        expect(usedBrew(calls)).toBe(false);
+        expect(usedSystem(calls)).toBe(false);
+    });
+});
+// With the lock naming no Ruby, the step chose system Ruby 2.6 as above, and the build still died:
+// the Xcode 26.4 SDK's Ruby 2.6 headers have no `ruby/config.h`, so no native extension (json, ffi)
+// compiles. Homebrew's Ruby is 4, where the lock's rake 13.0.6 cannot load. So a Ruby 3.3 runs when
+// the lock names no Ruby or one below 3; a named 3.x runs 3.3 unless Homebrew's matches it better; a
+// named 4.x runs Homebrew's. A machine without 3.3 behaves as before.
+describe('cocoapods-install runs Ruby 3.3 where system Ruby cannot build native gems', () => {
+    const used33 = (calls) => calls.some((c) => c.startsWith('ruby33'));
+    const usedBrew = (calls) => calls.some((c) => c.startsWith('brew-ruby'));
+    const usedSystem = (calls) => calls.some((c) => c.startsWith('ruby '));
+    const lockWithRuby = (v) => LOCK_WITH_BUNDLER.replace('BUNDLED WITH', `RUBY VERSION\n   ruby ${v}\n\nBUNDLED WITH`);
+    const image = { brewRuby: true, brewRubyVersion: '4.0.2', ruby33: true };
+    test('a lock that names no Ruby runs 3.3, with the locked bundler', async () => {
+        const { calls, output, gemHome } = await run({ lock: LOCK_WITH_BUNDLER, ...image });
+        expect(used33(calls)).toBe(true);
+        expect(usedSystem(calls)).toBe(false);
+        expect(usedBrew(calls)).toBe(false);
+        expect(calls).toContain('gem install bundler -v 2.3.21 --no-document');
+        expect(calls.find((c) => c.startsWith('bundle _2.3.21_ install'))).toContain(`GEM_HOME=${gemHome}`);
+        expect(output).toMatch(/^Ruby: .*homebrew-ruby@3\.3\/bin\/ruby \(3\.3\.10\), GEM_HOME: .* — Ruby 3\.3: lockfile names no Ruby, and system Ruby 2\.6 cannot build native gems$/m);
+    });
+    test('a lock whose RUBY VERSION is 2.x runs 3.3', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('2.7.2p137'), ...image });
+        expect(used33(calls)).toBe(true);
+        expect(output).toContain('— from Gemfile.lock RUBY VERSION 2.7.2, run on Ruby 3.3: system Ruby 2.6 cannot build native gems');
+    });
+    test('a 2.x .ruby-version runs 3.3', async () => {
+        const { calls } = await run({ lock: LOCK_WITH_BUNDLER, rubyVersionFile: '2.7.6\n', ...image });
+        expect(used33(calls)).toBe(true);
+    });
+    test('a named 3.x that Homebrew does not match runs 3.3', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('3.2.2'), ...image });
+        expect(used33(calls)).toBe(true);
+        expect(usedBrew(calls)).toBe(false);
+        expect(output).toContain('— from Gemfile.lock RUBY VERSION 3.2.2, run on Ruby 3.3');
+    });
+    test('a named 3.3 runs 3.3 and needs no aside', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('3.3.4p94'), ...image });
+        expect(used33(calls)).toBe(true);
+        expect(output).toMatch(/— from Gemfile\.lock RUBY VERSION 3\.3\.4$/m);
+    });
+    test('a named 3.x that Homebrew matches runs Homebrew Ruby', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('3.4.1'), brewRuby: true, brewRubyVersion: '3.4.7', ruby33: true });
+        expect(usedBrew(calls)).toBe(true);
+        expect(used33(calls)).toBe(false);
+        expect(output).toMatch(/— from Gemfile\.lock RUBY VERSION 3\.4\.1$/m);
+    });
+    test('a named 4.x runs Homebrew Ruby', async () => {
+        const { calls } = await run({ lock: lockWithRuby('4.0.1'), ...image });
+        expect(usedBrew(calls)).toBe(true);
+        expect(used33(calls)).toBe(false);
+    });
+    test('without 3.3, a lock that names no Ruby runs system Ruby, and says 3.3 is missing', async () => {
+        const { calls, output } = await run({ lock: LOCK_WITH_BUNDLER, brewRuby: true, brewRubyVersion: '4.0.2' });
+        expect(usedSystem(calls)).toBe(true);
+        expect(output).toContain('— system: lockfile names no Ruby, and no Ruby 3.3 is installed');
+    });
+    test('without 3.3, a 2.x lock runs system Ruby, and says 3.3 is missing', async () => {
+        const { calls, output } = await run({ lock: lockWithRuby('2.7.2p137'), brewRuby: true });
+        expect(usedSystem(calls)).toBe(true);
+        expect(output).toContain('— from Gemfile.lock RUBY VERSION 2.7.2, and no Ruby 3.3 is installed');
     });
 });
 //# sourceMappingURL=cocoapods-locked-bundler.test.js.map

package/dist/src/yaml/steps/ios-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ios-deps.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ios-deps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAc,MAAM,wBAAwB,CAAC;AAMhF,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;IAChE,yBAAyB,CACvB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAUpB,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAoJpB;AAMD,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACxD,yBAAyB,CACvB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAUpB,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAyDpB"}
+{"version":3,"file":"ios-deps.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ios-deps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAc,MAAM,wBAAwB,CAAC;AAMhF,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;IAChE,yBAAyB,CACvB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAUpB,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CA+MpB;AAMD,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACxD,yBAAyB,CACvB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAUpB,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CAyDpB"}

package/dist/src/yaml/steps/ios-deps.js

@@ -83,9 +83,18 @@ export class CocoapodsInstallStepExecutor extends BaseStepExecutor {
         //
         // Three moves, each conditional, so a machine missing a piece keeps the
         // old behaviour rather than failing on it:
-        //   - prefer an installed Homebrew Ruby. It is keg-only, so it is not on
-        //     PATH even where it is installed (Homebrew's cocoapods and fastlane
-        //     formulae depend on it), and the system 2.6 wins by default;
+        //   - run a Ruby that fits the one the project names: Gemfile.lock's
+        //     `RUBY VERSION`, then `.ruby-version`. Homebrew's Ruby is 4 on the mac
+        //     image, and an old lockfile's gems do not load there — rake 13.0.6
+        //     requires `ostruct`, no longer a default gem — so "newest installed"
+        //     is the wrong default. System Ruby 2.6 is no answer either: the Xcode
+        //     26.4 SDK's Ruby 2.6 headers have no `ruby/config.h`, so no native
+        //     extension (json, ffi) compiles under it. So a Ruby named below 3, or
+        //     none, runs a Homebrew `ruby@3.3`; a named 3.x runs 3.3 unless
+        //     Homebrew's `ruby` has its major.minor; a named 4.x runs Homebrew's.
+        //     Both are keg-only, so neither is on PATH where it is installed. With
+        //     no 3.3 on the machine, below 3 stays on system Ruby and 3+ runs
+        //     Homebrew's, as before. The `Ruby:` line says which, and why;
         //   - point GEM_HOME at a writable directory outside the checkout, so both
         //     `gem install bundler` and `bundle install` can write without sudo,
         //     and put its bin directory first;
@@ -93,10 +102,60 @@ export class CocoapodsInstallStepExecutor extends BaseStepExecutor {
         //     `bundle _<version>_`, which is the form RubyGems accepts.
         commands.push('BUNDLE_CMD="bundle"');
         commands.push('if [ "$USE_BUNDLE_EXEC" = "true" ]; then');
+        commands.push('  WANTED_RUBY=""');
+        commands.push('  WANTED_FROM=""');
+        commands.push('  if [ -f "Gemfile.lock" ]; then');
+        commands.push('    WANTED_RUBY="$(awk \'/^RUBY VERSION/ { getline; sub(/^[[:space:]]*ruby[[:space:]]+/, ""); sub(/p[0-9]+.*$/, ""); gsub(/[[:space:]]/, ""); print; exit }\' Gemfile.lock)"');
+        commands.push('    [ -n "$WANTED_RUBY" ] && WANTED_FROM="Gemfile.lock RUBY VERSION"');
+        commands.push('  fi');
+        commands.push('  if [ -z "$WANTED_RUBY" ] && [ -f ".ruby-version" ]; then');
+        commands.push('    WANTED_RUBY="$(head -n 1 .ruby-version | tr -d \'[:space:]\')"');
+        commands.push('    WANTED_RUBY="${WANTED_RUBY#ruby-}"');
+        commands.push('    WANTED_FROM=".ruby-version"');
+        commands.push('  fi');
+        commands.push('  case "${WANTED_RUBY%%.*}" in');
+        commands.push('    \'\'|*[!0-9]*) WANTED_RUBY="" ;;');
+        commands.push('  esac');
+        commands.push('  # The Rubies this machine has: a Homebrew `ruby@3.3` keg, and Homebrew\'s');
+        commands.push('  # `ruby` with its major.minor. Both keg-only, so neither is on PATH.');
+        commands.push('  RUBY33=""');
+        commands.push('  BREW_RUBY=""');
+        commands.push('  BREW_RUBY_MM=""');
         commands.push('  if command -v brew &>/dev/null; then');
+        commands.push('    RUBY33="$(brew --prefix --installed ruby@3.3 2>/dev/null || true)"');
+        commands.push('    if [ -n "$RUBY33" ] && [ ! -x "$RUBY33/bin/ruby" ]; then RUBY33=""; fi');
         commands.push('    BREW_RUBY="$(brew --prefix --installed ruby 2>/dev/null || true)"');
         commands.push('    if [ -n "$BREW_RUBY" ] && [ -x "$BREW_RUBY/bin/ruby" ]; then');
+        commands.push('      BREW_RUBY_MM="$(brew list --versions ruby 2>/dev/null | awk \'{ split($2, v, "."); print v[1] "." v[2]; exit }\')"');
+        commands.push('    else');
+        commands.push('      BREW_RUBY=""');
+        commands.push('    fi');
+        commands.push('  fi');
+        commands.push('  WANTED_MAJOR="${WANTED_RUBY%%.*}"');
+        commands.push('  WANTED_MM="$(printf \'%s\' "$WANTED_RUBY" | awk -F. \'{ print $1 "." $2 }\')"');
+        commands.push('  if [ -z "$WANTED_RUBY" ] || [ "$WANTED_MAJOR" -lt 3 ]; then');
+        commands.push('    if [ -z "$WANTED_RUBY" ]; then');
+        commands.push('      if [ -n "$RUBY33" ]; then');
+        commands.push('        export PATH="$RUBY33/bin:$PATH"');
+        commands.push('        RUBY_REASON="Ruby 3.3: lockfile names no Ruby, and system Ruby 2.6 cannot build native gems"');
+        commands.push('      else');
+        commands.push('        RUBY_REASON="system: lockfile names no Ruby, and no Ruby 3.3 is installed"');
+        commands.push('      fi');
+        commands.push('    elif [ -n "$RUBY33" ]; then');
+        commands.push('      export PATH="$RUBY33/bin:$PATH"');
+        commands.push('      RUBY_REASON="from $WANTED_FROM $WANTED_RUBY, run on Ruby 3.3: system Ruby 2.6 cannot build native gems"');
+        commands.push('    else');
+        commands.push('      RUBY_REASON="from $WANTED_FROM $WANTED_RUBY, and no Ruby 3.3 is installed"');
+        commands.push('    fi');
+        commands.push('  else');
+        commands.push('    RUBY_REASON="from $WANTED_FROM $WANTED_RUBY"');
+        commands.push('    if [ "$WANTED_MAJOR" -eq 3 ] && [ -n "$RUBY33" ] && [ "$BREW_RUBY_MM" != "$WANTED_MM" ]; then');
+        commands.push('      export PATH="$RUBY33/bin:$PATH"');
+        commands.push('      [ "$WANTED_MM" != "3.3" ] && RUBY_REASON="$RUBY_REASON, run on Ruby 3.3"');
+        commands.push('    elif [ -n "$BREW_RUBY" ]; then');
         commands.push('      export PATH="$BREW_RUBY/bin:$PATH"');
+        commands.push('    else');
+        commands.push('      RUBY_REASON="$RUBY_REASON, but no Homebrew Ruby is installed"');
         commands.push('    fi');
         commands.push('  fi');
         commands.push('  if ! command -v bundle &>/dev/null && ! command -v gem &>/dev/null; then');
@@ -109,7 +168,7 @@ export class CocoapodsInstallStepExecutor extends BaseStepExecutor {
         commands.push('  mkdir -p "$GEM_HOME"');
         commands.push('  export PATH="$GEM_HOME/bin:$PATH"');
         commands.push('  RUBY_VERSION_USED="$(ruby -e \'print RUBY_VERSION\' 2>/dev/null || echo unknown)"');
-        commands.push('  echo "Ruby: $(command -v ruby || echo none) ($RUBY_VERSION_USED), GEM_HOME: $GEM_HOME"');
+        commands.push('  echo "Ruby: $(command -v ruby || echo none) ($RUBY_VERSION_USED), GEM_HOME: $GEM_HOME — $RUBY_REASON"');
         commands.push('  LOCKED_BUNDLER=""');
         commands.push('  if [ -f "Gemfile.lock" ]; then');
         commands.push('    LOCKED_BUNDLER="$(awk \'/^BUNDLED WITH/ { getline; gsub(/[[:space:]]/, ""); print; exit }\' Gemfile.lock)"');

package/package.json

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