feat: remove build info from metrics

# Why

When yarn moved to version 4, they removed the `--silent` flag. Because of this change, any use of yarn to call scripts and get output will also get yarn debugging garbage, and there is no way to suppress it.

The release scripts are mostly ok with this, except for calling the `next-version` script. The output of this script has to be clean for it to be used as input for `lerna version`.

# How

Replaced the yarn call with a direct invocation of the node Typescript source, bypassing yarn.

# Test Plan

Since the `trigger-release.yml` workflow supports a dry run mode, it's safe to modify it to check out a test branch and run the workflow many times to debug the issue.

Once this change is merged, a dry run invocation of the workflow should succeed even if no version string is passed in.

.eslintignore

@@ -1,7 +1,14 @@
 **/build/**
+**/dist/**
+**/coverage/**
+**/fixtures/**
 !packages/eas-cli/src/commands/build/**
 !packages/eas-cli/src/build/**
 
 packages/eas-cli/src/graphql/generated.ts
+packages/eas-cli/schema/**
+packages/eas-cli/graphql.schema.json
+packages/build-tools/schema.graphql
 
 node_modules
+ts-declarations

.eslintrc.js

@@ -1,50 +0,0 @@
-module.exports = {
-  root: true,
-  extends: ['universe/node'],
-  plugins: ['async-protect', 'node'],
-  rules: {
-    'no-console': 'warn',
-    'no-constant-condition': ['warn', { checkLoops: false }],
-    'sort-imports': [
-      'warn',
-      {
-        ignoreDeclarationSort: true,
-      },
-    ],
-    curly: 'warn',
-    'import/no-cycle': 'error',
-    'import/no-extraneous-dependencies': [
-      'error',
-      { devDependencies: ['**/__tests__/**/*', '**/__mocks__/**/*'] },
-    ],
-    'import/no-relative-packages': 'error',
-    'no-restricted-imports': [
-      'error',
-      {
-        paths: [
-          {
-            name: 'lodash',
-            message: "Don't use lodash, it's heavy!",
-          },
-        ],
-      },
-    ],
-    'no-underscore-dangle': ['error', { allow: ['__typename'] }],
-    '@typescript-eslint/explicit-function-return-type': [
-      'warn',
-      {
-        allowExpressions: true,
-      },
-    ],
-    'async-protect/async-suffix': 'error',
-    'node/no-sync': 'error',
-  },
-  overrides: [
-    {
-      files: ['**/__tests__/**/*.ts', '**/__mocks__/**/*.ts'],
-      rules: {
-        'async-protect/async-suffix': 'off',
-      },
-    },
-  ],
-};

.gitattributes

@@ -1 +1,5 @@
+* text eol=lf
+*.png binary
+*.jpg binary
+
 **/yarn.lock linguist-generated

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -37,7 +37,7 @@ body:
       required: true
     attributes:
       label: Environment
-      description: Run `npx expo-env-info` and `expo doctor`, and paste the output here.
+      description: Run `npx expo-env-info` and `npx expo-doctor`, and paste the output here.
   - type: textarea
     validations:
       required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Expo Developers Discord
+    url: https://chat.expo.dev/
+    about: Join other developers in discussions regarding Expo and EAS.

.github/PULL_REQUEST_TEMPLATE

@@ -1,8 +1,5 @@
-<!-- Thanks for contributing to _EAS CLI_! Before you submit your pull request, please make sure to check the following boxes by putting an x in the [ ] (don't: [x ], [ x], do: [x]) -->
-
-# Checklist
-
-- [ ] I've added an entry to [CHANGELOG.md](https://github.com/expo/eas-cli/blob/main/CHANGELOG.md#main) if necessary. You can comment this pull request with `/changelog-entry [breaking-change|new-feature|bug-fix|chore] [message]` and CHANGELOG.md will be updated automatically.
+<!-- If this PR requires a changelog entry, add it by commenting the PR with the command `/changelog-entry [breaking-change|new-feature|bug-fix|chore] [message]`. -->
+<!-- You can skip the changelog check by labeling the PR with "no changelog". -->
 
 # Why
 

.github/actions/setup-mise/action.yml

@@ -0,0 +1,11 @@
+name: setup-mise
+description: Install tools via mise
+
+runs:
+  using: "composite"
+  steps:
+    - uses: jdx/mise-action@146a28175021df8ca24f8ee1828cc2a60f980bd5 # v3.5.1
+      with:
+        install: true
+        cache: true
+        experimental: true

.github/codemention.yml

@@ -0,0 +1,30 @@
+commentConfiguration:
+  preamble: 'Subscribed to pull request'
+  epilogue: 'Generated by [CodeMention](https://github.com/expo/expo/actions/workflows/codemention.yaml)'
+rules:
+  - patterns: ['**/*']
+    mentions: ['douglowder']
+  - patterns: ['packages/eas-cli/src/update/**']
+    mentions: ['wschurman', 'quinlanj']
+  - patterns: ['packages/eas-cli/src/commands/update/**']
+    mentions: ['wschurman', 'quinlanj']
+  - patterns: ['packages/eas-cli/src/channel/**']
+    mentions: ['wschurman', 'quinlanj']
+  - patterns: ['packages/eas-cli/src/commands/channel/**']
+    mentions: ['wschurman', 'quinlanj']
+  - patterns: ['packages/eas-cli/schema/**']
+    mentions: ['bycedric']
+  - patterns: ['packages/eas-cli/src/metadata/**']
+    mentions: ['bycedric']
+  - patterns: ['packages/eas-cli/src/commands/metadata/**']
+    mentions: ['bycedric']
+  - patterns: ['packages/eas-cli/src/worker/**']
+    mentions: ['kitten', 'kadikraman']
+  - patterns: ['packages/eas-cli/src/commands/deploy/**']
+    mentions: ['kitten', 'kadikraman']
+  - patterns: ['packages/eas-cli/src/commands/build/**']
+    mentions: ['sjchmiela']
+  - patterns: ['packages/eas-cli/src/build/**']
+    mentions: ['sjchmiela']
+  - patterns: ['packages/eas-cli/src/commands/workflow/**']
+    mentions: ['sjchmiela']

.github/fixtures/eas-workflow-build-android.yml

@@ -0,0 +1,17 @@
+name: build-android
+on:
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    name: Build Android
+    type: build
+    runs_on: linux-large
+    params:
+      platform: android
+      profile: system-test
+  custom_job:
+    name: Custom Job
+    steps:
+      - name: Echo
+        run: echo "This is a custom job step"

.github/internal-actions/notify-slack-on-fail-or-recover/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "printWidth": 100,
+  "singleQuote": true
+}

.github/internal-actions/notify-slack-on-fail-or-recover/action.yml

@@ -0,0 +1,53 @@
+name: notify-slack-on-fail-or-recover
+
+inputs:
+  channel:
+    required: true
+    type: string
+  slack_webhook:
+    required: true
+    type: string
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Get previous workflow run status
+      uses: actions/github-script@v6
+      id: run-status
+      with:
+        script: |
+          const script = require('.github/internal-actions/notify-slack-on-fail-or-recover/main.js');
+          return await script({github, context, core});
+
+    - name: Commit subject
+      shell: bash
+      run: |
+        subject="$(git show --format=%s --quiet | sed 's/"/\\"/g')"
+        echo "${{ fromJSON(steps.run-status.outputs.result).previous }}"
+        echo "SUBJECT=$subject" >> "$GITHUB_ENV"
+
+    - name: Send Slack Success Notification
+      if: fromJSON(steps.run-status.outputs.result).previous == 'failure' && fromJSON(steps.run-status.outputs.result).current == 'success'
+      uses: rtCamp/action-slack-notify@v2
+      env:
+        SLACK_CHANNEL: ${{ inputs.channel }}
+        SLACK_COLOR: good
+        SLACK_ICON: https://github.com/expo-bot.png?size=48
+        SLACK_TITLE: 'Fixed, was failing'
+        SLACK_MESSAGE: ${{ env.SUBJECT }}
+        SLACK_USERNAME: 'EAS CLI CI'
+        SLACK_WEBHOOK: ${{ inputs.slack_webhook }}
+        SLACK_FOOTER: ''
+
+    - name: Send Slack Failure Notification
+      if: fromJSON(steps.run-status.outputs.result).current == 'failure'
+      uses: rtCamp/action-slack-notify@v2
+      env:
+        SLACK_CHANNEL: ${{ inputs.channel }}
+        SLACK_COLOR: danger
+        SLACK_ICON: https://github.com/expo-bot.png?size=48
+        SLACK_TITLE: 'Failed'
+        SLACK_MESSAGE: ${{ env.SUBJECT }}
+        SLACK_USERNAME: 'EAS CLI CI'
+        SLACK_WEBHOOK: ${{ inputs.slack_webhook }}
+        SLACK_FOOTER: ''

.github/internal-actions/notify-slack-on-fail-or-recover/main.js

@@ -0,0 +1,155 @@
+function updateOctokitInstance(github) {
+  updateGithubRestActions(github);
+  addConvenienceMethods(github);
+}
+
+function addConvenienceMethods(github) {
+  Object.assign(github, {
+    // checks if a run is a failure from the perspective of sending Slack
+    // notifications. Works for both runs and run attempts, which should be the
+    // same object shapes.
+    // When a run has not been completed, it fetches the jobs for the workflow
+    // to check if the job is "failing" instead of "failed".
+    async isFailedRun(run) {
+      console.log(`checking run: ${run.id}`);
+      console.log(`status: ${run.status}`);
+      console.log(`conclusion: ${run.conclusion}`);
+      console.log(`run_attempt: ${run.run_attempt}`);
+
+      if (run.status === 'completed') {
+        console.log('completed -- checking conclusion');
+        return run.conclusion === 'failure' || run.conclusion === 'timed_out';
+      }
+
+      const owner = run.repository.owner.login;
+      const repo = run.repository.name;
+      const jobsResp = await github.rest.actions.listJobsForWorkflowRun({
+        owner,
+        repo,
+        run_id: run.id,
+      });
+
+      console.log('checking jobs');
+      const jobs = jobsResp.data;
+      for (const job of jobs.jobs) {
+        if (job.conclusion === 'failure' || job.conclusion === 'timed_out') {
+          console.log('job failed');
+          return true;
+        } else if (job.status === 'completed') {
+          continue;
+        }
+
+        for (const step of job.steps) {
+          if (step.conclusion === 'failure') {
+            console.log('job step failed');
+            return true;
+          }
+        }
+      }
+
+      return false;
+    },
+  });
+}
+
+// github-script's Octokit/REST plugins are out of date, so we have to
+// add our own custom endpoint method
+// see https://octokit.github.io/rest.js/v18#custom-endpoint-methods for
+// documentation
+function updateGithubRestActions(github) {
+  Object.assign(github.rest.actions, {
+    getWorkflowRunAttempt: github.request.defaults({
+      method: 'GET',
+      url: '/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}',
+      params: {
+        owner: {
+          required: true,
+          type: 'string',
+        },
+        repo: {
+          required: true,
+          type: 'string',
+        },
+        run_id: {
+          required: true,
+          type: 'number',
+        },
+        attempt_number: {
+          required: true,
+          type: 'number',
+        },
+      },
+    }),
+  });
+}
+
+// Returns  { current: 'failure' } | { current: 'success', previous: 'success' | 'failure' } to indicate the failure status
+// of the current and previous runs
+module.exports = async ({ github }) => {
+  const { GITHUB_REPOSITORY, GITHUB_RUN_ID, GITHUB_REF_NAME } = process.env;
+  const [owner, repo] = GITHUB_REPOSITORY.split('/');
+  updateOctokitInstance(github);
+
+  const workflowRunResp = await github.rest.actions.getWorkflowRun({
+    owner,
+    repo,
+    run_id: GITHUB_RUN_ID,
+  });
+
+  const currentRun = workflowRunResp.data;
+  const listWorkflowRunsResp = await github.rest.actions.listWorkflowRuns({
+    owner,
+    repo,
+    workflow_id: currentRun.workflow_id,
+    branch: GITHUB_REF_NAME,
+  });
+  const { workflow_runs } = listWorkflowRunsResp.data;
+
+  if (workflow_runs.length === 1 && workflow_runs[0].run_attempt === 1) {
+    return false;
+  }
+
+  const previousRuns = workflow_runs.filter(
+    (run) => run.status === 'completed' && run.conclusion !== 'cancelled'
+  );
+
+  if (await github.isFailedRun(currentRun)) {
+    return { current: 'failure', previous: null };
+  }
+
+  if (currentRun.run_attempt === 1 && previousRuns.length > 0) {
+    return {
+      current: 'success',
+      previous: (await github.isFailedRun(previousRuns[0])) ? 'failure' : 'success',
+    };
+  }
+
+  for (let i = currentRun.run_attempt - 1; i > 0; i--) {
+    const previousAttemptResp = await github.rest.actions.getWorkflowRunAttempt({
+      owner,
+      repo,
+      run_id: currentRun.id,
+      attempt_number: i,
+    });
+    const previousAttempt = previousAttemptResp.data;
+    if (
+      previousAttempt.conclusion === 'success' ||
+      previousAttempt.conclusion === 'failure' ||
+      previousAttempt.conclusion === 'timed_out'
+    ) {
+      return {
+        current: 'success',
+        previous: (await github.isFailedRun(previousAttempt)) ? 'failure' : 'success',
+      };
+    }
+  }
+
+  if (previousRuns.length > 0) {
+    return {
+      current: 'success',
+      previous: (await github.isFailedRun(previousRuns[0])) ? 'failure' : 'success',
+    };
+  }
+
+  return { current: 'success', previous: 'success' };
+};

.github/internal-actions/notify-slack-on-fail-or-recover/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "notify-slack-on-fail-or-recover",
+  "version": "1.0.0",
+  "description": "A GitHub Action to notify Expo Slack of build failures and recovery.",
+  "main": "main.js",
+  "author": "Expo",
+  "license": "UNLICENSED",
+  "private": true,
+  "devDependencies": {
+    "prettier": "^2.5.1"
+  }
+}

.github/internal-actions/notify-slack-on-fail-or-recover/yarn.lock

@@ -0,0 +1,8 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+
+[email protected]:
+  version "2.5.1"
+  resolved "https://registry.yarnpkg.com/prettier/-/prettier-2.5.1.tgz#fff75fa9d519c54cf0fce328c1017d94546bc56a"
+  integrity sha512-vBZcPRUR5MZJwoyi3ZoyQlc1rXeEck8KgeC9AwwOn+exuxLxq5toTRDTSaVrXHxelDMHy9zlicw8u66yxoSUFg==

.github/internal-actions/setup-gcloud/action.yml

@@ -0,0 +1,16 @@
+name: setup-gcloud
+
+runs:
+  using: "composite"
+  steps:
+    - name: Auth gcloud
+      uses: google-github-actions/auth@v2
+      with:
+        workload_identity_provider: 'projects/321830142373/locations/global/workloadIdentityPools/github/providers/expo'
+        project_id: exponentjs
+
+    - name: Setup gcloud
+      uses: google-github-actions/setup-gcloud@e427ad8a34f8676edf47cf7d7925499adf3eb74f # v2
+      with:
+        version: 548.0.0
+        project_id: exponentjs

.github/workflows/build-and-deploy-worker.yml

@@ -0,0 +1,205 @@
+name: build-and-deploy-worker
+# Assumes main branch always specifies an environment (staging/production).
+# If environment is empty: PR testing build (no upload, no deploy)
+# If environment is set: Build (unless cached on main), upload, and deploy
+
+on:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: '"staging", "production" or empty'
+        type: string
+        required: true
+  workflow_call:
+    inputs:
+      environment:
+        description: '"staging", "production" or empty'
+        type: string
+        required: true
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - uses: ./.github/actions/setup-mise
+
+      - uses: ./.github/internal-actions/setup-gcloud
+
+      - name: Check if worker already exists
+        id: check_worker_exists
+        # Check if tarballs for this SHA already exist
+        # If they do, we can skip building regardless of branch
+        if: inputs.environment != ''
+        run: |
+          for platform in android ios; do
+            GCP_TARBALL="worker-$platform-sha1-$GITHUB_SHA.tar.gz"
+
+            if ! gsutil stat gs://eas-build-worker-tarballs/$GCP_TARBALL; then
+              echo "worker_exists=false" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+          done
+
+          echo "worker_exists=true" >> "$GITHUB_OUTPUT"
+
+      - name: Start EAS Workflow to build worker tarballs
+        id: eas_workflow
+        # Build if: PR testing (no env), or deploying but tarballs don't exist
+        if: inputs.environment == '' || steps.check_worker_exists.outputs.worker_exists == 'false'
+        working-directory: packages/worker
+        env:
+          EXPO_TOKEN: ${{ secrets.EXPO_DEV_EXPO_GITHUB_ROBOT_ACCESS_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          # Only upload artifacts from EAS if GHA will upload them to GCS
+          # This avoids unnecessary artifact uploads for PR builds
+          SHOULD_UPLOAD_ARTIFACT="${{ inputs.environment != '' && steps.check_worker_exists.outputs.worker_exists == 'false' }}"
+
+          # Run workflow and capture output (includes run ID)
+          WORKFLOW_OUTPUT=$(npx -y eas-cli@latest workflow:run build-worker.yml \
+            --ref ${{ github.sha }} \
+            --input upload_artifact=$SHOULD_UPLOAD_ARTIFACT \
+            --non-interactive \
+            --no-wait \
+            --json)
+
+          WORKFLOW_RUN_ID=$(echo "$WORKFLOW_OUTPUT" | jq -r '.id')
+          if [ -z "$WORKFLOW_RUN_ID" ] || [ "$WORKFLOW_RUN_ID" = "null" ]; then
+            echo "Error: Could not determine workflow run ID"
+            echo "Workflow output:"
+            echo "$WORKFLOW_OUTPUT" | jq .
+            exit 1
+          fi
+
+          echo "workflow_run_id=$WORKFLOW_RUN_ID" >> "$GITHUB_OUTPUT"
+
+      - name: Wait for EAS workflow and capture artifacts
+        id: eas_artifacts
+        if: inputs.environment == '' || steps.check_worker_exists.outputs.worker_exists == 'false'
+        working-directory: packages/worker
+        env:
+          EXPO_TOKEN: ${{ secrets.EXPO_DEV_EXPO_GITHUB_ROBOT_ACCESS_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          WORKFLOW_RUN_ID="${{ steps.eas_workflow.outputs.workflow_run_id }}"
+          if [ -z "$WORKFLOW_RUN_ID" ]; then
+            echo "Error: Missing workflow run ID"
+            exit 1
+          fi
+
+          SHOULD_UPLOAD_ARTIFACT="${{ inputs.environment != '' && steps.check_worker_exists.outputs.worker_exists == 'false' }}"
+
+          while true; do
+            VIEW_OUTPUT=$(npx -y eas-cli@latest workflow:view "$WORKFLOW_RUN_ID" \
+              --non-interactive \
+              --json)
+            STATUS=$(echo "$VIEW_OUTPUT" | jq -r '.status')
+
+            case "$STATUS" in
+              SUCCESS)
+                break
+                ;;
+              FAILURE)
+                echo "EAS workflow failed."
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+              CANCELED)
+                echo "EAS workflow canceled."
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+              ACTION_REQUIRED)
+                echo "EAS workflow requires action."
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+              NEW|IN_PROGRESS)
+                sleep 7
+                ;;
+              *)
+                echo "Unexpected workflow status: $STATUS"
+                echo "$VIEW_OUTPUT" | jq .
+                exit 1
+                ;;
+            esac
+          done
+
+          # Skip artifact extraction if we didn't request uploads
+          if [ "$SHOULD_UPLOAD_ARTIFACT" == "false" ]; then
+            echo "Skipping artifact download - upload was disabled for this run"
+            exit 0
+          fi
+
+          # Extract artifact download URLs from workflow output
+          # Artifacts are in jobs[].artifacts[] for custom jobs
+          DOWNLOAD_IOS_URL=$(echo "$VIEW_OUTPUT" | jq -r '
+            .jobs[]
+            | .artifacts[]?
+            | select(.name == "worker-ios-tarball")
+            | .downloadUrl
+          ' | head -1)
+
+          DOWNLOAD_ANDROID_URL=$(echo "$VIEW_OUTPUT" | jq -r '
+            .jobs[]
+            | .artifacts[]?
+            | select(.name == "worker-android-tarball")
+            | .downloadUrl
+          ' | head -1)
+
+          if [ -z "$DOWNLOAD_IOS_URL" ] || [ "$DOWNLOAD_IOS_URL" = "null" ]; then
+            echo "Error: Could not find iOS artifact download URL"
+            echo "$VIEW_OUTPUT" | jq .
+            exit 1
+          fi
+
+          if [ -z "$DOWNLOAD_ANDROID_URL" ] || [ "$DOWNLOAD_ANDROID_URL" = "null" ]; then
+            echo "Error: Could not find Android artifact download URL"
+            echo "$VIEW_OUTPUT" | jq .
+            exit 1
+          fi
+
+          # Mask the download URLs
+          echo "::add-mask::$DOWNLOAD_IOS_URL"
+          echo "::add-mask::$DOWNLOAD_ANDROID_URL"
+          echo "download_ios_url=$DOWNLOAD_IOS_URL" >> "$GITHUB_OUTPUT"
+          echo "download_android_url=$DOWNLOAD_ANDROID_URL" >> "$GITHUB_OUTPUT"
+
+      - name: Cancel EAS workflow on GitHub cancellation
+        if: cancelled()
+        working-directory: packages/worker
+        env:
+          EXPO_TOKEN: ${{ secrets.EXPO_DEV_EXPO_GITHUB_ROBOT_ACCESS_TOKEN }}
+        run: |
+          set -euo pipefail
+
+          WORKFLOW_RUN_ID="${{ steps.eas_workflow.outputs.workflow_run_id }}"
+          if [ -n "$WORKFLOW_RUN_ID" ]; then
+            npx -y eas-cli@latest workflow:cancel "$WORKFLOW_RUN_ID" --non-interactive
+          fi
+
+      - name: Upload worker tarballs to GCP
+        # Upload when deploying if we built something new
+        # Don't upload PR builds (no environment) or when using cached tarballs
+        if: inputs.environment != '' && steps.check_worker_exists.outputs.worker_exists == 'false'
+        run: |
+          IOS_GCP_TARBALL="worker-ios-sha1-$GITHUB_SHA.tar.gz"
+          ANDROID_GCP_TARBALL="worker-android-sha1-$GITHUB_SHA.tar.gz"
+          curl -L "${{ steps.eas_artifacts.outputs.download_ios_url }}" | gsutil cp - gs://eas-build-worker-tarballs/$IOS_GCP_TARBALL
+          curl -L "${{ steps.eas_artifacts.outputs.download_android_url }}" | gsutil cp - gs://eas-build-worker-tarballs/$ANDROID_GCP_TARBALL
+
+      - name: Promote worker to ${{ inputs.environment }}
+        if: inputs.environment != ''
+        run: |
+          for platform in android ios; do
+            GCP_TARBALL="worker-$platform-sha1-$GITHUB_SHA.tar.gz"
+            WORKER_STAGING_TARBALL="worker-$platform-${{ inputs.environment }}.tar.gz"
+
+            gsutil cp gs://eas-build-worker-tarballs/$GCP_TARBALL gs://eas-build-worker-tarballs/$WORKER_STAGING_TARBALL
+          done

.github/workflows/changelog.yml

@@ -1,46 +1,40 @@
-on:
-  issue_comment:
-    types: [created]
+name: CHANGELOG.md PR check
 
-name: Changelog
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - labeled
+      - unlabeled
+
+concurrency:
+  group: changelog-${{ github.ref }}
+  cancel-in-progress: true
 
 jobs:
-  pr-commented:
+  pr-changelog-entry:
+    name: Check CHANGELOG.md updated
     runs-on: ubuntu-latest
-    if: ${{ github.event.issue.pull_request && github.event.issue.user.login == github.event.comment.user.login && startsWith(github.event.comment.body, '/changelog-entry ') }}
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - name: Check if CHANGELOG.md was updated
+        id: changelog-updated
+        uses: tj-actions/changed-files@b1ba699b304f2083b602164e06a89b868c84f076
         with:
-          node-version: 18
-      - name: Checkout Pull Request
-        run: hub pr checkout ${{ github.event.issue.number }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: Install dependencies
-        working-directory: ./scripts
-        run: yarn install --frozen-lockfile --check-files
-      - name: Add changelog entry
-        working-directory: ./scripts
-        run: |
-          PARAMS=${PR_COMMENT_BODY#/changelog-entry }
-          if [[ ! "$PARAMS" =~ " " ]]; then
-            echo "Invalid /changelog-entry command"
-            exit 1
-          fi
-          CATEGORY=$( cut -d ' ' -f 1 <<< "$PARAMS" | sed -e 's/^[[:space:]]*//' )
-          MESSAGE=$( cut -d ' ' -f 2- <<< "$PARAMS" | sed -e 's/^[[:space:]]*//' )
-          yarn changelog-entry "$CATEGORY" "$MESSAGE"
-        env:
-          GITHUB_PR_AUTHOR: ${{ github.event.issue.user.login }}
-          GITHUB_PR_NUMBER: ${{ github.event.issue.number }}
-          PR_COMMENT_BODY: ${{ github.event.comment.body }}
-      - name: Commit and push
-        run: |
-          # use the last commit author name and email
-          git config --global user.name "$(git --no-pager log --format=format:'%an' -n 1)"
-          git config --global user.email "$(git --no-pager log --format=format:'%ae' -n 1)"
-
-          git add CHANGELOG.md
-          git commit -m "update CHANGELOG.md"
-          git push
+          files: CHANGELOG.md
+      - name: Fail if CHANGELOG.md was not updated and the "no changelog" label is absent
+        if: steps.changelog-updated.outputs.any_changed == 'false' && !contains(github.event.pull_request.labels.*.name, 'no changelog')
+        uses: actions/github-script@v6
+        with:
+          script: |
+            core.setFailed('Please add a changelog entry!')
+      - uses: mshick/[email protected]
+        if: always()
+        with:
+          message-id: changelog-entry-check
+          refresh-message-position: true
+          message: ${{ contains(github.event.pull_request.labels.*.name, 'no changelog') && '⏩ The changelog entry check has been skipped since the "no changelog" label is present.' || '✅ Thank you for adding the changelog entry!' }}
+          message-failure: |
+            ❌ It looks like a changelog entry is missing for this PR. Add it manually to CHANGELOG.md.
+            ⏩ If this PR doesn't require a changelog entry, such as if it's an internal change that doesn't affect the user experience, you can add the "no changelog" label to the PR.

.github/workflows/codemention.yml

@@ -0,0 +1,14 @@
+name: codemention
+on:
+  pull_request_target:
+    types: [opened, synchronize, ready_for_review]
+jobs:
+  codemention:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: tobyhs/[email protected]
+        with:
+          githubToken: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/install.yml

@@ -1,20 +0,0 @@
-name: Installer tests
-on:
-  push:
-    branches: [main]
-  pull_request:
-    types: [opened, synchronize]
-
-jobs:
-  test:
-    name: Run the installer
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest]
-    steps:
-      - uses: actions/checkout@v2
-      - run: bash bin/install.sh
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - run: eas --version

.github/workflows/issue-triage.yml

@@ -0,0 +1,146 @@
+name: Issue Triage
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  needs-repro:
+    runs-on: ubuntu-20.04
+    if: "${{ contains(github.event.label.name, 'incomplete issue: missing or invalid repro') }}"
+    steps:
+      - uses: actions/github-script@v3
+        with:
+          github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
+          script: |
+            github.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `Hi there! It looks like your issue requires a minimal reproducible example, but it is invalid or absent. Please prepare such an example and share it in a new issue.
+
+              **The best way to get attention to your issue is to provide a clean and easy way for a developer to reproduce the issue on their own machine.** Please do not provide your entire project, or a project with more code than is necessary to reproduce the issue.
+
+              A side benefit of going through the process of narrowing down the minimal amount of code needed to reproduce the issue is that you may get lucky and discover that the bug is due to a mistake in your application code that you can quickly fix on your own.
+
+              ### Resources
+
+              - ["How to create a Minimal, Reproducible Example"](https://stackoverflow.com/help/minimal-reproducible-example)
+              - ["How to narrow down the source of an error"](https://expo.fyi/manual-debugging)
+
+              ### Common concerns
+
+              #### "I've only been able to reproduce it in private, proprietary code"
+
+              You may not have spent enough time narrowing down the root cause of the issue. Try out the techniques discussed in this [manual debugging guide](https://expo.fyi/manual-debugging) to learn how to isolate the problem from the rest of your codebase.
+
+              #### "I didn't have time to create one"
+
+              That's understandable, it can take some time to prepare. We ask that you hold off on filing an issue until you are able to fully complete the required fields in the issue template.
+
+              #### "You can reproduce it by yourself by creating a project and following these steps"
+
+              This is useful knowledge, but it's still valuable to have the resulting project that is produced from running the steps, where you have verified you can reproduce the issue.
+            `})
+            github.issues.update({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'closed'
+            })
+
+  needs-info:
+    runs-on: ubuntu-20.04
+    if: "${{ contains(github.event.label.name, 'incomplete issue: missing info') }}"
+    steps:
+      - uses: actions/github-script@v3
+        with:
+          github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
+          script: |
+            github.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `Hello! There isn't enough information provided in your issue description for us to be able to help you. The best way to get help is to provide information to enable other developers to understand the issue and reproduce it on their own machines.
+
+              Please create a new issue and fill out the entire issue template to the best of your ability. Refer to the following resources for more information on how to create a good issue report.
+
+              ### Resources
+
+              - ["How do I ask a good question?"](https://stackoverflow.com/help/how-to-ask)
+              - ["How to create a Minimal, Reproducible Example"](https://stackoverflow.com/help/minimal-reproducible-example)
+              - ["How to narrow down the source of an error"](https://expo.fyi/manual-debugging)
+            `})
+            github.issues.update({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'closed'
+            })
+
+  issue-accepted:
+    runs-on: ubuntu-20.04
+    if: github.event.label.name == 'issue accepted'
+    steps:
+      - uses: actions/github-script@v3
+        with:
+          github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
+          script: |
+            github.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `Thank you for filing this issue!
+              This comment acknowledges we believe this may be a bug and there’s enough information to investigate it.
+              However, we can’t promise any sort of timeline for resolution. We prioritize issues based on severity, breadth of impact, and alignment with our roadmap. If you’d like to help move it more quickly, you can continue to investigate it more deeply and/or you can open a pull request that fixes the cause.
+            `})
+
+  question:
+    runs-on: ubuntu-20.04
+    if: "${{ contains(github.event.label.name, 'invalid issue: question') }}"
+    steps:
+      - uses: actions/github-script@v3
+        with:
+          github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
+          script: |
+            github.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `Hello! Our GitHub issues are reserved for bug reports.
+
+              If you have a question about Expo or related tools, please post on our forums at https://forums.expo.dev/ or join our Discord at https://chat.expo.dev/.
+
+              ### Resources
+
+              - ["How do I ask a good question?"](https://stackoverflow.com/help/how-to-ask)
+              - ["Join the community"](https://docs.expo.dev/next-steps/community/)
+            `})
+            github.issues.update({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'closed'
+            })
+
+  feature-request:
+    runs-on: ubuntu-20.04
+    if: "${{ contains(github.event.label.name, 'invalid issue: feature request') }}"
+    steps:
+      - uses: actions/github-script@v3
+        with:
+          github-token: ${{ secrets.EXPO_BOT_GITHUB_TOKEN }}
+          script: |
+            github.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `Hello! Our GitHub issues are reserved for bug reports.
+
+              If you would like to request a feature, please post to https://expo.canny.io/feature-requests.
+            `})
+            github.issues.update({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'closed'
+            })

.github/workflows/move-eas-build-tag.yml

@@ -0,0 +1,64 @@
+on:
+  workflow_dispatch:
+    inputs:
+      staging_only:
+        type: boolean
+        required: true
+        default: false
+        description: "Only move the latest-eas-build-staging tag, not the latest-eas-build tag"
+      version:
+        type: string
+        required: true
+        description: "Version number to move the tag to"
+      dry_run:
+        type: boolean
+        required: true
+        default: true
+        description: "Run the workflow in dry run mode, without making any NPM changes"
+
+name: Move NPM tags used by EAS builds and workflows
+
+jobs:
+  move-tag:
+    name: Move NPM tags used by EAS builds and workflows
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_TOKEN: ${{ secrets.EXPO_BOT_PAT }}
+      NPM_ACCESS_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
+      INPUT_VERSION: ${{ github.event.inputs.version }}
+      INPUT_DRY_RUN: ${{ github.event.inputs.dry_run }}
+      INPUT_STAGING_ONLY: ${{ github.event.inputs.staging_only }}
+    steps:
+      - uses: actions/setup-node@v2
+        with:
+          registry-url: "https://registry.npmjs.org/"
+          scope: "expo"
+          node-version: 22
+      - name: Resolve version (fails if the version does not exist)
+        run: |
+          set -o pipefail
+          npm pack --dry-run eas-cli@$INPUT_VERSION
+      - name: Add latest-eas-build-staging tag
+        run: |
+          cmd="npm dist-tag add eas-cli@$INPUT_VERSION latest-eas-build-staging"
+          if [[ "$INPUT_DRY_RUN" == "true" ]]; then
+            echo "Running in dry run mode, skipping version check"
+            echo "cmd = $cmd"
+            exit 0
+          fi
+          echo //registry.npmjs.org/:_authToken=$NPM_ACCESS_TOKEN > ~/.npmrc
+          $cmd
+      - name: Add latest-eas-build tag
+        run: |
+          cmd="npm dist-tag add eas-cli@$INPUT_VERSION latest-eas-build"
+          if [[ "$INPUT_DRY_RUN" == "true" ]]; then
+            echo "Running in dry run mode, skipping version check"
+            echo "cmd = $cmd"
+            exit 0
+          fi
+          if [[ "$INPUT_STAGING_ONLY" == "true" ]]; then
+            echo "Only moving the staging tag, skipping the production tag"
+            exit 0
+          fi
+          echo //registry.npmjs.org/:_authToken=$NPM_ACCESS_TOKEN > ~/.npmrc
+          $cmd

.github/workflows/release.yml

@@ -1,7 +1,7 @@
 on:
   push:
     tags:
-      - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
+      - "v*" # Push events to matching v*, i.e. v1.0, v20.15.10
 
 name: Release workflow
 
@@ -9,6 +9,8 @@ jobs:
   release:
     name: Create a release
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     outputs:
       upload_url: ${{ steps.create_release.outputs.upload_url }}
     steps:
@@ -18,154 +20,58 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           tag_name: ${{ github.ref }}
+          release_name: ${{ github.ref }}
           draft: true
-  build-linux:
-    name: Build for Linux
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 18
-      - run: yarn install --frozen-lockfile --check-files
-      - run: yarn build
-      - name: Build tarballs
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-        run: |
-          yarn pretarball-ci
-          yarn oclif pack:tarballs --no-xz --targets linux-x64,linux-arm
-      - id: x64
-        run: echo "::set-output name=filename::$(ls eas-*-x64.tar.gz)"
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - id: arm
-        run: echo "::set-output name=filename::$(ls eas-*-arm.tar.gz)"
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - name: Upload linux-x64 tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.x64.outputs.filename }}
-          asset_name: ${{ steps.x64.outputs.filename }}
-          asset_content_type: application/gzip
-      - name: Upload linux-arm tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.arm.outputs.filename }}
-          asset_name: ${{ steps.arm.outputs.filename }}
-          asset_content_type: application/gzip
-  build-mac:
-    name: Build for macOS
-    # Use macOS to get the correct platform specific dependencies
-    runs-on: macos-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 18
-      - run: yarn install --frozen-lockfile --check-files
-      - run: yarn build
-      - name: Build tarballs
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-        run: |
-          yarn pretarball-ci
-          yarn oclif pack:tarballs --no-xz --targets darwin-x64
-      - id: x64
-        run: echo "::set-output name=filename::$(ls eas-*-x64.tar.gz)"
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist
-      - name: Upload darwin-x64 tarball
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/${{ steps.x64.outputs.filename }}
-          asset_name: ${{ steps.x64.outputs.filename }}
-          asset_content_type: application/gzip
-  build-windows:
-    name: Build for Windows
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 18
-      - run: yarn install --frozen-lockfile --check-files
-      - run: sudo apt-get install nsis
-      - run: yarn build
-      - run: |
-          yarn pretarball-ci
-          yarn oclif pack:win
-        working-directory: ${{ github.workspace }}/packages/eas-cli
-      - id: x64
-        run: echo "::set-output name=filename::$(ls eas-*-x64.exe)"
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist/win32
-      - id: x86
-        run: echo "::set-output name=filename::$(ls eas-*-x86.exe)"
-        working-directory: ${{ github.workspace }}/packages/eas-cli/dist/win32
-      - name: Upload x64 installer
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/win32/${{ steps.x64.outputs.filename }}
-          asset_name: ${{ steps.x64.outputs.filename }}
-          asset_content_type: application/gzip
-      - name: Upload x86 installer
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: packages/eas-cli/dist/win32/${{ steps.x86.outputs.filename }}
-          asset_name: ${{ steps.x86.outputs.filename }}
-          asset_content_type: application/gzip
   publish-to-npm:
     name: Publish to npm
     runs-on: ubuntu-latest
-    needs: [build-linux, build-mac, build-windows]
+    needs: release
+    permissions:
+      id-token: write
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          registry-url: 'https://registry.npmjs.org/'
-          scope: 'expo'
-          node-version: 18
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup-mise
       - name: Install dependencies
-        run: yarn install --frozen-lockfile --check-files
+        run: yarn install --immutable
       - name: Build
         run: yarn build
       - name: Publish packages to npm
-        run: yarn lerna publish from-package --yes --no-verify-access
+        run: yarn run -T lerna publish from-package --yes --no-verify-access
+      - name: Add latest-eas-build-staging tag
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
+        run: |
+          VERSION=$(cat lerna.json | jq -r .version)
+          echo //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN > ~/.npmrc
+          npm dist-tag add eas-cli@$VERSION latest-eas-build-staging
+      - name: Add latest-eas-build tag
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
+        run: |
+          VERSION=$(cat lerna.json | jq -r .version)
+          echo //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN > ~/.npmrc
+          npm dist-tag add eas-cli@$VERSION latest-eas-build
   release-changelog:
     name: Update changelog and publish release
     runs-on: ubuntu-latest
     needs: publish-to-npm
+    permissions:
+      contents: write
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
         with:
-          node-version: 18
+          token: ${{ secrets.EXPO_BOT_PAT }}
+      - uses: ./.github/actions/setup-mise
       - name: Install dependencies
         working-directory: ./scripts
-        run: yarn install --frozen-lockfile --check-files
+        run: yarn install --immutable
       - name: Resolve version
         run: echo "EAS_CLI_VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
       - name: Update changelog
         working-directory: ./scripts
-        run: yarn --silent release-changelog $EAS_CLI_VERSION > /tmp/current-changelog
+        run: yarn release-changelog $EAS_CLI_VERSION > /tmp/current-changelog
       - name: Publish release
-        run: hub release edit v$EAS_CLI_VERSION --draft=false -F /tmp/current-changelog
+        run: gh release edit v$EAS_CLI_VERSION --draft=false -F /tmp/current-changelog
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Commit and push
@@ -175,7 +81,7 @@ jobs:
           git config --global user.email "[email protected]"
           git config --global user.name "Expo CI"
           git add CHANGELOG.md
-          git commit -m "update CHANGELOG.md"
+          git commit --allow-empty -m "update CHANGELOG.md"
           git push
       - name: Prepare changelog for Slack
         run: |
@@ -189,9 +95,9 @@ jobs:
         env:
           SLACK_CHANNEL: eas-cli
           SLACK_COLOR: ${{ job.status }}
-          SLACK_ICON: https://github.com/expo-ci.png?size=48
-          SLACK_TITLE: 'Released eas-cli@${{ env.EAS_CLI_VERSION }}'
+          SLACK_ICON: https://github.com/expo-bot.png?size=48
+          SLACK_TITLE: "Released eas-cli@${{ env.EAS_CLI_VERSION }}"
           SLACK_MESSAGE: ${{ env.SLACK_CHANGELOG }}
-          SLACK_USERNAME: 'Expo CI'
+          SLACK_USERNAME: "EAS CLI CI"
           SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
-          SLACK_FOOTER: ''
+          SLACK_FOOTER: ""

.github/workflows/size.yml

@@ -1,20 +0,0 @@
-name: Size
-on:
-  pull_request:
-    types: [synchronize, opened]
-jobs:
-  compare:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 18
-      - uses: preactjs/compressed-size-action@v2
-        with:
-          build-script: 'build:tarballs:linux'
-          repo-token: '${{ secrets.GITHUB_TOKEN }}'
-          pattern: './packages/eas-cli/dist/*.tar.gz'
-          compression: 'none'
-          strip-hash: "v\\d+.\\d+.\\d+-\\w+-"
-          clean-script: 'clean'

.github/workflows/test-graphql.yml

@@ -0,0 +1,25 @@
+name: Ensure GraphQL schema and generated code is up-to-date
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '0 8 * * *' # 8:00 AM UTC time every day
+
+concurrency:
+  group: test-graphql-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Ensure GraphQL schema and generated code is up-to-date
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup tools
+        uses: ./.github/actions/setup-mise
+      - run: yarn install --immutable
+      - run: yarn verify-graphql-code
+        working-directory: packages/eas-cli

.github/workflows/test-scripts.yml

@@ -0,0 +1,28 @@
+name: Test scripts
+
+defaults:
+  run:
+    working-directory: scripts
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'scripts/**'
+  pull_request:
+    paths:
+      - 'scripts/**'
+
+concurrency:
+  group: test-scripts-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup tools
+        uses: ./.github/actions/setup-mise
+      - run: yarn install --immutable
+      - run: yarn typecheck

.github/workflows/test.yml

@@ -1,35 +1,87 @@
 name: Run tests
+
 on:
   push:
     branches: [main]
   pull_request:
     types: [opened, synchronize]
 
+concurrency:
+  group: test-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   test:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: ['14', '16', '18']
+        node: ['20', '22', '24']
         include:
-          - node: '18'
+          - node: '20'
             coverage: true
     name: Test with Node ${{ matrix.node }}
     steps:
       - uses: actions/checkout@v2
-      - name: Setup node
-        uses: actions/setup-node@v2
-        with:
-          node-version: ${{ matrix.node }}
-      - run: yarn install --frozen-lockfile --check-files
+      - name: Setup tools
+        uses: ./.github/actions/setup-mise
+        env:
+          MISE_NODE_VERSION: ${{ matrix.node }}
+      - name: Install dependencies
+        run: yarn install --immutable
+        env:
+          YARN_ENABLE_HARDENED_MODE: ${{ matrix.coverage == true && '1' || '0' }}
       - run: yarn typecheck
-      - run: yarn test
-        if: ${{ !matrix.coverage }}
-      - run: yarn test --coverage
+      - run: |
+          git config --global user.email "[email protected]"
+          git config --global user.name "Test"
+      - name: Fetch base commit for PR diffing
+        if: ${{ github.event_name == 'pull_request' }}
+        # Lerna needs the base commit to compute affected packages.
+        run: git fetch --no-tags --depth=1 origin ${{ github.event.pull_request.base.sha }}
+      - name: Run tests (affected)
+        # PRs: only run tests for changed packages + dependents.
+        if: ${{ !matrix.coverage && github.event_name == 'pull_request' }}
+        run: yarn run -T lerna run test --since ${{ github.event.pull_request.base.sha }} --include-dependents
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+      - name: Run tests (all)
+        # Pushes to main: run all package tests.
+        if: ${{ !matrix.coverage && github.event_name == 'push' }}
+        run: yarn run -T lerna run test
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+      - name: Run tests (coverage)
+        # Coverage on PRs and main; per-package reports are uploaded to Codecov.
         if: ${{ matrix.coverage }}
-      - run: yarn lint --max-warnings=0
-      - run: shellcheck bin/*.sh
+        run: yarn run -T lerna run test -- --coverage
+        env:
+          # Oclif seems to cause OOM errors when testing with coverage enabled.
+          # Remove this whenever we solved those OOM errors.
+          NODE_OPTIONS: --max-old-space-size=8192
+      - run: yarn lint
+      - run: yarn fmt:check
+      - name: Install scripts dependencies
+        if: ${{ matrix.coverage }}
+        run: yarn install --immutable
+        working-directory: ./scripts
+        env:
+          YARN_ENABLE_HARDENED_MODE: ${{ matrix.coverage == true && '1' || '0' }}
       - uses: codecov/codecov-action@v1
         if: ${{ matrix.coverage }}
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
+      - if: ${{ matrix.coverage }}
+        run: yarn lint-changelog
+
+  notify-slack:
+    runs-on: ubuntu-latest
+    needs: [test]
+    name: Notify Slack
+    if: ${{ github.ref == 'refs/heads/main' && always() }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Notify Slack
+        uses: ./.github/internal-actions/notify-slack-on-fail-or-recover
+        with:
+          channel: eas-cli
+          slack_webhook: ${{ secrets.SLACK_WEBHOOK }}

.github/workflows/trigger-release.yml

@@ -0,0 +1,46 @@
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        type: string
+        required: false
+        description: 'Version number for the release'
+      dry_run:
+        type: boolean
+        required: true
+        default: true
+        description: 'Run the release in dry run mode, without pushing any changes'
+
+name: Manually trigger a release
+
+jobs:
+  release:
+    name: Trigger a release
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_TOKEN: ${{ secrets.EXPO_BOT_PAT }}
+      INPUT_VERSION: ${{ github.event.inputs.version }}
+      INPUT_DRY_RUN: ${{ github.event.inputs.dry_run }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+          token: ${{ secrets.EXPO_BOT_PAT }}
+      - uses: ./.github/actions/setup-mise
+      - run: |
+          # Lerna will not detect changes correctly without having all tags
+          git fetch --depth=1 origin +refs/tags/*:refs/tags/*
+          # Checkout the main branch
+          git checkout main
+          git config --global user.email "[email protected]"
+          git config --global user.name "Expo CI"
+          yarn install --immutable
+          yarn build
+          if [[ "$INPUT_VERSION" == "" ]]; then
+            echo "Releasing with default version"
+            yarn release
+          else
+            echo "Releasing with version $INPUT_VERSION"
+            yarn release $INPUT_VERSION
+          fi

.github/workflows/worker-system-tests.yml

@@ -0,0 +1,160 @@
+name: system-tests
+
+on:
+  workflow_dispatch: {}
+  workflow_call: {}
+
+jobs:
+  system-tests:
+    runs-on: ubuntu-latest
+    env:
+      EXPO_TOKEN: ${{ secrets.STAGING_EXPO_DEV_EXPO_SERVICES_GITHUB_ROBOT_ACCESS_TOKEN }}
+      EXPO_STAGING: "1"
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - uses: ./.github/actions/setup-mise
+
+      - name: Create test app
+        run: npx -y create-expo-app@latest ${{ runner.temp }}/test-app --template tabs
+
+      - name: Link to EAS project
+        working-directory: ${{ runner.temp }}/test-app
+        run: npx -y eas-cli@latest init --id 6ae8028d-4e6d-4912-8eb2-87d4e6122880 --force --non-interactive
+
+      - name: Add bundle identifiers to app.json
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          jq '.expo.ios.bundleIdentifier = "dev.expo.workersystemtests" | .expo.android.package = "dev.expo.workersystemtests"' app.json > app.json.tmp
+          mv app.json.tmp app.json
+
+      - name: Configure EAS Build
+        working-directory: ${{ runner.temp }}/test-app
+        run: npx -y eas-cli@latest build:configure --platform all
+
+      - name: Add system-test profile to eas.json
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          jq '.build["system-test"] = { "ios": { "simulator": true }, "android": { "withoutCredentials": true } }' eas.json > eas.json.tmp
+          mv eas.json.tmp eas.json
+
+      - name: Setup EAS workflow
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          mkdir -p .eas/workflows
+          cp ${{ github.workspace }}/.github/fixtures/eas-workflow-build-android.yml .eas/workflows/build-android.yml
+
+      - name: Run iOS build and Android workflow concurrently
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          set -euo pipefail
+
+          BUILD_JSON=$(npx -y eas-cli@latest build --platform ios --profile system-test --non-interactive --no-wait --json)
+          BUILD_ID=$(echo "$BUILD_JSON" | jq -r 'if type=="array" then .[0].id // .[0].build.id // .[0].buildId else .id // .build.id // .buildId end // empty')
+          if [ -z "$BUILD_ID" ]; then
+            echo "Error: could not determine build ID"
+            echo "$BUILD_JSON" | jq .
+            exit 1
+          fi
+          echo "BUILD_ID=$BUILD_ID" >> "$GITHUB_ENV"
+          echo "Resolved BUILD_ID=$BUILD_ID"
+
+          WORKFLOW_JSON=$(npx -y eas-cli@latest workflow:run build-android.yml --non-interactive --no-wait --json)
+          WORKFLOW_RUN_ID=$(echo "$WORKFLOW_JSON" | jq -r '.id // .workflowRun.id // .workflowRunId // empty')
+          if [ -z "$WORKFLOW_RUN_ID" ]; then
+            echo "Error: could not determine workflow run ID"
+            echo "$WORKFLOW_JSON" | jq .
+            exit 1
+          fi
+          echo "WORKFLOW_RUN_ID=$WORKFLOW_RUN_ID" >> "$GITHUB_ENV"
+          echo "Resolved WORKFLOW_RUN_ID=$WORKFLOW_RUN_ID"
+
+          is_terminal_build_status() {
+            case "$1" in
+              FINISHED|ERRORED|CANCELED) return 0 ;;
+              *) return 1 ;;
+            esac
+          }
+
+          is_terminal_workflow_status() {
+            case "$1" in
+              SUCCESS|FAILURE|CANCELED|ACTION_REQUIRED) return 0 ;;
+              *) return 1 ;;
+            esac
+          }
+
+          BUILD_STATUS=""
+          WORKFLOW_STATUS=""
+          TIMEOUT_SECONDS=1800
+          START_TIME=$(date +%s)
+
+          while true; do
+            ELAPSED=$(( $(date +%s) - START_TIME ))
+            if [ "$ELAPSED" -ge "$TIMEOUT_SECONDS" ]; then
+              echo "Timeout: polling exceeded 30 minutes"
+              exit 1
+            fi
+
+            BUILD_STATUS=$(npx -y eas-cli@latest build:view "$BUILD_ID" --json | jq -r '.status // empty')
+            WORKFLOW_STATUS=$(npx -y eas-cli@latest workflow:view "$WORKFLOW_RUN_ID" --non-interactive --json | jq -r '.status // empty')
+
+            echo "iOS build status: $BUILD_STATUS"
+            echo "Android workflow status: $WORKFLOW_STATUS"
+
+            if is_terminal_build_status "$BUILD_STATUS" && is_terminal_workflow_status "$WORKFLOW_STATUS"; then
+              break
+            fi
+
+            sleep 7
+          done
+
+          EXIT_CODE=0
+
+          if [ "$BUILD_STATUS" != "FINISHED" ]; then
+            echo "Build did not finish successfully: $BUILD_STATUS"
+            EXIT_CODE=1
+          fi
+
+          if [ "$WORKFLOW_STATUS" != "SUCCESS" ]; then
+            echo "Workflow did not finish successfully: $WORKFLOW_STATUS"
+            EXIT_CODE=1
+          fi
+
+          exit "$EXIT_CODE"
+
+      - name: Cancel EAS runs on workflow cancellation
+        if: always() && (cancelled() || failure())
+        working-directory: ${{ runner.temp }}/test-app
+        run: |
+          set -euo pipefail
+
+          if [ -n "${BUILD_ID:-}" ]; then
+            echo "Canceling EAS build: $BUILD_ID"
+            BUILD_CANCEL_OUTPUT=$(npx -y eas-cli@latest build:cancel "$BUILD_ID" --non-interactive 2>&1 || true)
+            if [ -n "$BUILD_CANCEL_OUTPUT" ]; then
+              echo "$BUILD_CANCEL_OUTPUT"
+            else
+              echo "build:cancel produced no output"
+            fi
+            BUILD_STATUS=$(npx -y eas-cli@latest build:view "$BUILD_ID" --json 2>/dev/null | jq -r '.status // empty' || true)
+            if [ -n "$BUILD_STATUS" ]; then
+              echo "Post-cancel build status: $BUILD_STATUS"
+            else
+              echo "Post-cancel build status unavailable"
+            fi
+          fi
+          if [ -n "${WORKFLOW_RUN_ID:-}" ]; then
+            echo "Canceling EAS workflow run: $WORKFLOW_RUN_ID"
+            WORKFLOW_CANCEL_OUTPUT=$(npx -y eas-cli@latest workflow:cancel "$WORKFLOW_RUN_ID" --non-interactive 2>&1 || true)
+            if [ -n "$WORKFLOW_CANCEL_OUTPUT" ]; then
+              echo "$WORKFLOW_CANCEL_OUTPUT"
+            else
+              echo "workflow:cancel produced no output"
+            fi
+            WORKFLOW_STATUS=$(npx -y eas-cli@latest workflow:view "$WORKFLOW_RUN_ID" --non-interactive --json 2>/dev/null | jq -r '.status // empty' || true)
+            if [ -n "$WORKFLOW_STATUS" ]; then
+              echo "Post-cancel workflow status: $WORKFLOW_STATUS"
+            else
+              echo "Post-cancel workflow status unavailable"
+            fi
+          fi

.github/workflows/worker.yml

@@ -0,0 +1,80 @@
+name: worker
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "packages/worker/**"
+      - "packages/build-tools/**"
+      - "packages/eas-build-job/**"
+      - "packages/steps/**"
+      - "packages/logger/**"
+      - "packages/downloader/**"
+      - "packages/template-file/**"
+      - "packages/turtle-spawn/**"
+      - .github/workflows/worker.yml
+      - .github/workflows/build-and-deploy-worker.yml
+      - yarn.lock
+
+concurrency:
+  group: worker-${{ github.ref }}-${{ github.event_name }}
+  cancel-in-progress: true
+
+jobs:
+  worker-checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - uses: ./.github/actions/setup-mise
+
+      - run: yarn install --immutable
+
+      - run: yarn typecheck
+
+      - name: Run unit tests
+        working-directory: packages/worker
+        run: yarn test:unit
+
+      - name: Run integration tests
+        working-directory: packages/worker
+        run: yarn test:integration
+
+  worker-build:
+    needs:
+      - worker-checks
+    uses: ./.github/workflows/build-and-deploy-worker.yml
+    secrets: inherit
+    with:
+      environment: ${{ github.ref == 'refs/heads/main' && 'staging' || '' }}
+
+  system-tests-staging:
+    if: github.ref == 'refs/heads/main' && !failure() && !cancelled()
+    needs:
+      - worker-build
+      - worker-checks
+    uses: ./.github/workflows/worker-system-tests.yml
+    secrets: inherit
+
+  deploy-worker-production:
+    if: github.ref == 'refs/heads/main' && !failure() && !cancelled()
+    needs:
+      - system-tests-staging
+    uses: ./.github/workflows/build-and-deploy-worker.yml
+    secrets: inherit
+    with:
+      environment: production
+
+  notify-slack:
+    runs-on: ubuntu-latest
+    needs:
+      - deploy-worker-production
+    if: github.ref == 'refs/heads/main' && always() && !cancelled()
+    steps:
+      - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4
+
+      - name: Notify Slack
+        uses: ./.github/internal-actions/notify-slack-on-fail-or-recover
+        with:
+          channel: turtle-bots
+          slack_webhook: ${{ secrets.SLACK_EAS_WORKFLOWS_WEBHOOK }}

.gitignore

@@ -2,17 +2,25 @@
 packages/*/build
 packages/eas-cli/dist
 packages/eas-cli/tmp
+scripts/build
+dist
+
+# TypeScript
+**/*.tsbuildinfo
 
 # Code editors
 .idea
 .history
 .vscode
+*.swp
+*.swo
 
 # macOS
 .DS_Store
 
 # Node
 node_modules
+**/.yarn/install-state.gz
 *-debug.log
 *-error.log
 

.oxfmtrc.json

@@ -0,0 +1,21 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "bracketSameLine": true,
+  "trailingComma": "es5",
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "ignorePatterns": [
+    ".github",
+    "lerna.json",
+    "**/build/**",
+    "**/dist/**",
+    "**/coverage/**",
+    "**/fixtures/**",
+    "packages/eas-cli/README.md",
+    "packages/eas-cli/schema/**",
+    "packages/eas-cli/graphql.schema.json",
+    "packages/build-tools/schema.graphql"
+  ]
+}

.oxlintrc.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "categories": {
+    "correctness": "off",
+    "suspicious": "off",
+    "pedantic": "off",
+    "perf": "off",
+    "restriction": "off",
+    "style": "off",
+    "nursery": "off"
+  },
+  "ignorePatterns": [
+    "**/build/**",
+    "**/dist/**",
+    "**/coverage/**",
+    "**/fixtures/**",
+    "**/__fixtures__/**",
+    ".github/**",
+    "packages/eas-cli/schema/**",
+    "packages/eas-cli/graphql.schema.json",
+    "packages/build-tools/schema.graphql"
+  ],
+  "plugins": ["import", "node", "typescript"],
+  "jsPlugins": [
+    {
+      "name": "async-protect",
+      "specifier": "eslint-plugin-async-protect"
+    }
+  ],
+  "rules": {
+    "no-console": "warn",
+    "no-constant-condition": [
+      "warn",
+      {
+        "checkLoops": false
+      }
+    ],
+    "sort-imports": [
+      "warn",
+      {
+        "ignoreDeclarationSort": true
+      }
+    ],
+    "curly": "warn",
+    "default": "off",
+    "named": "off",
+    "namespace": "off",
+    "no-cycle": "error",
+    "no-restricted-imports": [
+      "error",
+      {
+        "paths": [
+          {
+            "name": "lodash",
+            "message": "Don't use lodash, it's heavy!"
+          }
+        ]
+      }
+    ],
+    "no-underscore-dangle": [
+      "error",
+      {
+        "allow": ["__typename"]
+      }
+    ],
+    "async-protect/async-suffix": "error",
+    "node/no-sync": "error"
+  },
+  "overrides": [
+    {
+      "files": ["**/__tests__/**/*.ts", "**/__mocks__/**/*.ts"],
+      "rules": {
+        "async-protect/async-suffix": "off"
+      }
+    }
+  ]
+}

.prettierrc

@@ -1,8 +0,0 @@
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "singleQuote": true,
-  "bracketSameLine": true,
-  "trailingComma": "es5",
-  "arrowParens": "avoid"
-}

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+  "search.exclude": {
+    "**/node_modules": true,
+    "**/bower_components": true,
+    "**/*.code-search": true,
+    "**/src/**/build/**": false,
+    "**/src/build/**": false,
+  }
+}

.yarnrc

@@ -1 +0,0 @@
-save-prefix ""

.yarnrc.yml

@@ -0,0 +1,2 @@
+defaultSemverRangePrefix: ''
+nodeLinker: node-modules

AGENTS.md

@@ -0,0 +1,5 @@
+# AGENTS.md
+
+When working with this repository follow instructions from CLAUDE.md.
+
+- [./CLAUDE.md](./CLAUDE.md)

CLAUDE.md

@@ -0,0 +1,353 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Monorepo Structure
+
+This is a **Lerna-based monorepo** containing the EAS CLI and all supporting build libraries.
+
+### CLI & Configuration Packages
+
+1. **[packages/eas-cli](./packages/eas-cli/CLAUDE.md)** - The main CLI tool (published as `eas-cli`)
+   - 95+ commands organized by domain (build, submit, update, channel, credentials, etc.)
+   - Built on oclif (Open CLI Framework)
+   - Entry point: `packages/eas-cli/bin/run`
+
+2. **[packages/eas-json](./packages/eas-json/CLAUDE.md)** - EAS configuration parser (published as `@expo/eas-json`)
+   - Validates `eas.json` configuration files using Joi schemas
+   - Manages build, submit, and deploy profiles
+   - Supports JSON5 via golden-fleece
+
+3. **[packages/eas-build-cache-provider](./packages/eas-build-cache-provider/CLAUDE.md)** - Build cache plugin (published as `eas-build-cache-provider`)
+   - Optimizes build caching for Expo CLI
+
+### Build Execution Packages
+
+4. **[packages/eas-build-job](./packages/eas-build-job)** - Build job definitions (published as `@expo/eas-build-job`)
+   - Defines all data structures for build operations (Job, BuildPhase, BuildMode, Platform, Workflow)
+   - Provides type definitions and validation schemas (Zod, Joi)
+   - Contains BuildPhase enum that defines the traditional build pipeline stages
+   - Key exports: `Job`, `BuildPhase`, `BuildMode`, `BuildTrigger`, `Workflow`, `ArchiveSource`
+   - **Foundation that all other build packages depend on**
+
+5. **[packages/build-tools](./packages/build-tools)** - Build execution engine (published as `@expo/build-tools`)
+   - Orchestrates all build operations through `BuildContext<T extends Job>`
+   - Contains platform-specific builders: `androidBuilder()`, `iosBuilder()`, `runCustomBuildAsync()`
+   - Manages build phases, artifact uploading, caching, credentials
+   - Provides functions for custom builds
+   - Integrates with GraphQL API
+
+6. **[packages/steps](./packages/steps)** - Custom build workflow engine (published as `@expo/steps`)
+   - Framework for defining and executing custom build steps
+   - Key abstractions:
+     - `BuildWorkflow`: Orchestrates sequential step execution
+     - `BuildStep`: Individual executable unit with inputs/outputs
+     - `BuildStepGlobalContext`: Manages shared state and interpolation
+     - `BuildStepContext`: Per-step execution context
+   - Supports conditional execution with `if` expressions (using jsep)
+   - Template interpolation: `${{ steps.step-id.outputs.outputName }}`
+   - Parses build configs from YAML/JSON
+
+7. **[packages/local-build-plugin](./packages/local-build-plugin)** - Local build execution (published as `eas-cli-local-build-plugin`)
+   - Allows running EAS builds locally on developer machines
+   - Entry point: `packages/local-build-plugin/src/main.ts`
+   - Sets `EAS_BUILD_RUNNER=local-build-plugin` environment variable
+   - Reuses all build-tools logic for consistency with cloud builds
+
+8. **[packages/worker](./packages/worker/CLAUDE.md)** - Turtle Worker service (private, not published)
+   - Runs on EAS build VMs/pods
+   - WebSocket server for communication with Turtle Launcher
+   - Wraps `@expo/build-tools` to execute actual React Native builds
+
+### Supporting Packages
+
+9. **[packages/logger](./packages/logger)** - Bunyan-based structured logging (published as `@expo/logger`)
+   - Used by all build packages
+
+10. **[packages/downloader](./packages/downloader)** - HTTP file downloading with retry logic (published as `@expo/downloader`)
+
+11. **[packages/turtle-spawn](./packages/turtle-spawn)** - Child process spawning with error handling (published as `@expo/turtle-spawn`)
+
+12. **[packages/template-file](./packages/template-file)** - Lodash-based template string interpolation (published as `@expo/template-file`)
+
+13. **[packages/create-eas-build-function](./packages/create-eas-build-function)** - CLI scaffolding tool for custom build functions (published as `create-eas-build-function`)
+
+14. **[packages/expo-cocoapods-proxy](./packages/expo-cocoapods-proxy)** - Ruby gem for CocoaPods proxy (published as `expo-cocoapods-proxy` gem)
+
+> **Note**: Some packages have their own CLAUDE.md with package-specific guidance. Click the links above to view them.
+
+## Common Development Commands
+
+### Setup
+
+```bash
+yarn install        # Install all dependencies
+yarn build          # Build all packages in the monorepo
+```
+
+### Development
+
+```bash
+yarn start          # Watch mode with parallel builds across all packages
+yarn watch          # Alias for start
+
+# Development with relaxed TypeScript rules (allows unused variables)
+yarn start-allow-unused
+```
+
+### Testing
+
+```bash
+yarn run -T lerna run test               # Run all tests across packages
+yarn run -T lerna run test -- --watch    # Watch mode across packages (heavier)
+#
+# If you use `yarn test`, remember to pass args through two separators:
+# yarn test -- -- --watch
+
+# Run tests for a specific package
+cd packages/eas-cli && yarn test
+cd packages/eas-json && yarn test
+cd packages/worker && yarn test
+cd packages/build-tools && yarn test
+cd packages/steps && yarn test
+```
+
+### Type Checking & Linting
+
+```bash
+yarn typecheck      # TypeScript type check all packages
+yarn lint           # Oxlint across all packages
+yarn fmt:check      # Oxfmt format check
+```
+
+### Running EAS CLI Locally
+
+```bash
+# From repository root:
+yarn eas <command>  # Run via root package script
+
+# Or use the binary directly:
+packages/eas-cli/bin/run <command>
+
+# Recommended: Create an alias for development
+alias easd="$(pwd)/packages/eas-cli/bin/run"
+easd build --help
+```
+
+### Local Build Testing
+
+Set up environment variables for testing local builds:
+
+```bash
+export EAS_LOCAL_BUILD_PLUGIN_PATH=$HOME/expo/eas-cli/bin/eas-cli-local-build-plugin
+export EAS_LOCAL_BUILD_WORKINGDIR=$HOME/expo/eas-build-workingdir
+export EAS_LOCAL_BUILD_SKIP_CLEANUP=1
+export EAS_LOCAL_BUILD_ARTIFACTS_DIR=$HOME/expo/eas-build-workingdir/results
+
+# Then run build with --local flag in eas-cli
+eas build --local
+```
+
+## Build System
+
+Each package has independent TypeScript compilation:
+
+- `eas-cli`: `src/` → `build/`
+- `eas-json`: `src/` → `build/`
+- `eas-build-cache-provider`: `src/` → `build/`
+- `worker`: `src/` → `dist/`
+- `build-tools`: `src/` → `dist/`
+- `eas-build-job`: `src/` → `dist/`
+- `steps`: `src/` → `dist/` (CommonJS only)
+- `local-build-plugin`: `src/` → `dist/`
+- Other packages: `src/` → `dist/`
+
+TypeScript configs:
+
+- `tsconfig.json` - Base configuration (extends @tsconfig/node20)
+- `tsconfig.build.json` - Production builds
+- `tsconfig.allowUnused.json` - Development with relaxed rules
+
+## Key Architectural Patterns
+
+### Build Phases
+
+Most traditional build operations are wrapped in phases for tracking:
+
+```typescript
+await ctx.runBuildPhase(BuildPhase.INSTALL_DEPENDENCIES, async () => {
+  // Phase logic here
+});
+```
+
+Phases can be marked as skipped, warning, or failed for granular reporting.
+
+### Context Objects
+
+- **BuildContext** (`build-tools`): For traditional builds, wraps Job, manages phases/artifacts/caching
+- **CustomBuildContext** (`build-tools`): Implements `ExternalBuildContextProvider`, bridges BuildContext to steps framework, used in custom builds and generic jobs
+- **BuildStepGlobalContext** (`steps`): Manages step outputs, interpolation, shared state
+- **BuildStepContext** (`steps`): Per-step context with working directory and logger
+
+### Custom Build Steps
+
+Steps are defined with:
+
+- `id`: Unique identifier
+- `name`: Display name
+- `run`: Command or function reference
+- `if`: Optional condition (`${{ always() }}`, `${{ success() }}`, etc.)
+- `inputs`: Key-value inputs to the step
+- `outputs`: Named outputs accessible to later steps
+
+Built-in step functions are in `packages/build-tools/src/steps/functions/`
+
+### Conditional Execution
+
+Uses jsep for expression evaluation:
+
+```yaml
+if: ${{ steps.previous_step.outputs.success == 'true' && env.ENVIRONMENT == 'production' }}
+```
+
+### Artifact Management
+
+Artifacts tracked as `ArtifactToUpload`:
+
+- Managed artifacts (APK, IPA, AAB) with specific handling
+- Generic artifacts for any file
+- Upload via `ctx.uploadArtifact()` or `upload-artifact` step
+
+## Package Interdependencies
+
+```
+eas-cli → @expo/eas-json
+       → @expo/build-tools → @expo/eas-build-job
+                           → @expo/steps → @expo/eas-build-job
+                           → @expo/logger
+                           → @expo/turtle-spawn
+                           → @expo/downloader
+                           → @expo/template-file
+
+local-build-plugin → @expo/build-tools → @expo/eas-build-job
+                   → @expo/turtle-spawn
+
+worker → @expo/build-tools
+```
+
+Most packages depend on `@expo/eas-build-job` as the source of truth for types.
+
+## Testing Architecture
+
+- **Framework**: Jest with per-package configuration
+- **Shared base config**: `jest/jest.shared.config.ts`
+- **Test locations**: `__tests__/` directories alongside source files
+- **Mocking**:
+  - File system: `memfs`
+  - HTTP: `nock`
+  - Utilities: `ts-mockito`, `mockdate`
+
+Run a single test file:
+
+```bash
+cd packages/eas-cli && yarn test <path-to-test-file>
+# Example:
+cd packages/eas-cli && yarn test src/project/__tests__/projectUtils-test.ts
+```
+
+## Common Development Scenarios
+
+### Adding a Built-in Step Function
+
+1. Create file in `packages/build-tools/src/steps/functions/yourFunction.ts`
+2. Export `createYourFunctionBuildFunction()` following existing patterns
+3. Add to `getEasFunctions()` in `packages/build-tools/src/steps/functions/easFunctions.ts`
+4. Function receives `BuildStepContext` and input/output maps
+
+### Adding Error Detection
+
+1. Add pattern detection in `packages/build-tools/src/buildErrors/detectError.ts`
+2. Implement resolver for better error messages
+3. Helps users understand and fix build failures
+
+### Working with Platform-Specific Builders
+
+- **Android builder** (`packages/build-tools/src/builders/android.ts`): Gradle-based, handles APK/AAB generation, also see `functionGroups/build.ts`
+- **iOS builder** (`packages/build-tools/src/builders/ios.ts`): Fastlane/Xcode-based, handles IPA generation, also see `functionGroups/build.ts`
+- Both use `runBuilderWithHooksAsync()` which runs build result hooks (on-success, on-error, on-complete) from package.json
+
+### Introducing Breaking Changes to Job API (@expo/eas-build-job)
+
+If you want to introduce breaking changes to the `@expo/eas-build-job` package, contact one of the CODEOWNERS to coordinate changes with EAS build servers and GraphQL API. Describe what changes you want to make and why. After everything is deployed to production, you can introduce a PR that relies on the new implementation.
+
+## Environment Variables
+
+```bash
+# API Configuration
+export EXPO_STAGING=1   # Use staging API (https://staging-api.expo.dev)
+export EXPO_LOCAL=1     # Use local API (http://127.0.0.1:3000)
+
+# Development
+export EAS_NO_VCS=1     # Disable version control checks
+export EXPO_DEBUG=1     # Enable debug logging
+```
+
+## Code Style & Conventions
+
+### Validation
+
+All changes should be validated with TypeScript and the linter before committing:
+
+```bash
+yarn typecheck      # Validate TypeScript types
+yarn lint           # Run Oxlint
+yarn fmt:check      # Run Oxfmt format check
+```
+
+### Logging
+
+Use the `Log` module from `@expo/logger`:
+
+```typescript
+import { Log } from '@expo/logger';
+
+Log.log('Info message');
+Log.warn('Warning message');
+Log.error('Error message');
+```
+
+### Pull Request conventions
+
+When creating pull requests, make sure to adhere to [PULL_REQUEST_TEMPLATE](./.github/PULL_REQUEST_TEMPLATE).
+
+### Commit Messages
+
+- When possible, prepend commit messages with `[PACKAGE-BEING-CHANGED]`, e.g. `[steps] Add new step function`
+- Do not use prefixes like `chore:` and `feat:`
+- Commit messages should be concise. Only complex changes should be longer than one line
+- Commit changes in logical groups
+
+## Release Process
+
+1. Update `CHANGELOG.md` in the appropriate package
+2. Version bump is automated based on changelog:
+   - Breaking changes → MAJOR
+   - New features → MINOR
+   - Otherwise → PATCH
+3. GitHub Actions workflow handles release automation
+4. Notifications sent to Slack #eas-cli channel
+
+## Licensing
+
+This repository contains packages under different licenses:
+
+- **MIT License**: `eas-cli`, `@expo/eas-json`, `@expo/eas-build-job`, `eas-build-cache-provider`
+- **BUSL-1.1 (Business Source License)**: `@expo/build-tools`, `@expo/steps`, `@expo/logger`, `@expo/downloader`, `@expo/turtle-spawn`, `@expo/template-file`, `eas-cli-local-build-plugin`
+
+See `LICENSE` (MIT) and `LICENSE-BUSL` (BUSL-1.1) for details.
+
+## Important Notes
+
+- **Node Version**: Requires Node.js (managed via Mise)
+- **Package Manager**: Uses Yarn 4.12.0
+- **Compilation Target**: CommonJS with Node resolution

CODEOWNERS

@@ -1,12 +0,0 @@
-* @dsokal @wkozyra95
-
-packages/eas-cli/src/build @dsokal @wkozyra95
-packages/eas-cli/src/commands/build @dsokal @wkozyra95
-
-packages/eas-cli/src/submit @barthap @dsokal
-packages/eas-cli/src/commands/submit.ts @barthap @dsokal
-
-packages/eas-cli/src/metadata @bycedric
-packages/eas-cli/src/commands/metadata @bycedric
-
-packages/eas-json @dsokal @wkozyra95

CONTRIBUTING.md

@@ -1,4 +1,76 @@
-## Releasing a new version
+# Development
 
-1. Run `yarn release` in the repository root folder.
-2. That's it! GitHub Actions is going to take care of the rest. Watch the #eas-cli Slack channel for a successful release notification.
+## Getting Started
+
+If this is your first time running `eas-cli` locally, make sure you install and build the packages. In the project root, run:
+
+```sh
+yarn install
+yarn build
+```
+
+From there, set up an alias for the EAS CLI so you can try it in projects all around your computer. The project is compiled on the fly so you don't need to run a build (watch) command.
+
+> The only exception is if there have been changes in `packages/eas-json`. In that case, you'll have to run `yarn build` in the root.
+
+Open your `.zshrc` or other config file and add:
+
+```sh
+alias easd="/PATH/TO/eas-cli/bin/run"
+```
+
+Then use it with `easd` like `easd build`.
+
+If you're making changes to `packages/eas-json` or prefer/need to work with production code, start the build command in watch mode with:
+
+```sh
+yarn start
+```
+
+If it is easier for you to work with the code locally with compiler options set to:
+
+```json
+...
+"compilerOptions": {
+    ...
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    ...
+}
+...
+```
+
+you can consider using:
+
+```sh
+yarn start-allow-unused
+```
+
+## Format
+
+- Be sure to update the [`CHANGELOG.md`](./CHANGELOG.md) with changes for every PR. There is a changelog bot that can generate the proper entry for you. The instructions on how to use it are in the PR description placeholder.
+- End `async` functions with `Async` like `runAsync`. This is just how we format functions at Expo.
+- Utilize the unified `Log` module instead of `console.log`.
+
+## Using local and staging API
+
+For development against local API:
+
+- Set up the API server as described at https://github.com/expo/universe/tree/main/server/www.
+- Set the `EXPO_LOCAL=1` env variable either on every command run (e.g. `EXPO_LOCAL=1 easd ...`) or more permamently with `export EXPO_LOCAL=1` (works in a current shell session).
+
+For development against staging API:
+
+- Set the `EXPO_STAGING=1` env variable either on every command run (e.g. `EXPO_STAGING=1 easd ...`) or more permamently with `export EXPO_STAGING=1` (works in a current shell session).
+
+## Working on local builds (`eas build --local`)
+
+See [`CLAUDE.md`](./CLAUDE.md) for how to set up your environment when making changes to [`eas-cli-local-build-plugin`](./packages/local-build-plugin) and/or [`build-tools`](./packages/build-tools).
+
+## Testing
+
+From the repository root, run `yarn run -T lerna run test`. For a single package, run `yarn test` in that package directory.
+
+## Releasing
+
+See [RELEASING.md](./RELEASING.md).

LICENSE-BUSL

@@ -0,0 +1,100 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             650 Industries, Inc.
+Licensed Work:        EAS Build
+                      The Licensed Work is (c) 2021 650 Industries, Inc.
+Additional Use Grant: You may make use of the Licensed Work, provided that you do
+                      not use the Licensed Work for commercial offerings such as
+                      a CI/CD service or application build service that allows
+                      third parties (other than your employees and contractors)
+                      to access the functionality of and directly benefit from the
+                      functionality of the Licensed Work.
+
+Change Date:          2028-04-01
+
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Software,
+please visit: https://expo.dev/pricing/
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

LICENSE-eas-build-job

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

RELEASING.md

@@ -0,0 +1,14 @@
+# Releasing EAS CLI
+
+1. Invoke the GitHub workflow ["Manually trigger a release"](https://github.com/expo/eas-cli/actions/workflows/trigger-release.yml). The next version is chosen automatically based on the changelog entries. If you want to use different version, pass the version string as an input to the workflow, in semver format, e.g. "1.2.3"
+2. That's it! GitHub Actions is going to take care of the rest. Watch the #eas-cli Slack channel for a successful release notification.
+
+## Choosing the next version
+
+As stated above, the next EAS CLI version is chosen automatically based on the existing changelog entries under the unreleased section in **CHANGELOG.md**.
+
+The algorithm works as follows:
+
+- If there are any entries in the "🛠 Breaking changes" section, bump the MAJOR version.
+- Otherwise, if there are any entries in the "🎉 New features", bump the MINOR version.
+- Otherwise, bump the PATCH version.

SECURITY.md

@@ -0,0 +1,5 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+Instead of opening a GitHub issue for security vulnerabilities, send an email to our secure inbox: secure@expo.io.

bin/eas-cli-local-build-plugin

@@ -0,0 +1 @@
+../packages/local-build-plugin/bin/run

bin/install.sh

@@ -1,130 +0,0 @@
-#!/bin/bash
-
-# This script downloads the latest release version of EAS CLI from GitHub and
-# installs it in /usr/local/bin
-
-{
-  # All code is inside a block to ensure the script executes only when
-  # downloaded completely.
-
-  set -euo pipefail
-
-  prefix="${EAS_PREFIX:-/usr/local}"
-  temp_dir="$(mktemp -d)"
-
-  if  [ -t 1 ] && [ -z "${NO_COLOR:-}" ]
-  then
-    # Use colors when stdout is a terminal and NO_COLOR isn't set.
-    text_bold=$'\033[1m'
-    text_normal=$'\033[22m'
-    text_red=$'\033[31m'
-    text_default_color=$'\033[39m'
-  else
-    # Disable colors
-    text_bold=""
-    text_normal=""
-    text_red=""
-    text_default_color=""
-  fi
-
-  abort() {
-    echo -e "$text_bold$text_red$1$text_normal$text_default_color"
-    exit 1
-  }
-
-  install() {
-    needs_sudo=""
-    # Make sure path exists and can be written to by the current user.
-    if ! mkdir -p "$prefix/lib" || [[ ! -w "$prefix/lib" ]]
-    then
-      needs_sudo=true
-    fi
-    if ! mkdir -p "$prefix/bin" || [[ ! -w "$prefix/bin" ]]
-    then
-      needs_sudo=true
-    fi
-    if ! rm -rf "$prefix/lib/eas"
-    then
-      needs_sudo=true
-    fi
-    # Run commands with sudo if necessary.
-    if [ -n "$needs_sudo" ]
-    then
-      if [ "$EUID" -ne 0 ]
-      then
-        echo "Installing requires superuser access."
-        echo "The sudo command will prompt for your password."
-      fi
-      sudo rm -rf "$prefix/lib/eas"
-      sudo mv "$temp_dir/eas" "$prefix/lib/eas"
-      sudo ln -fs "$prefix/lib/eas/bin/eas" "$prefix/bin/eas"
-    else
-      mv "$temp_dir/eas" "$prefix/lib/eas"
-      ln -fs "$prefix/lib/eas/bin/eas" "$prefix/bin/eas"
-    fi
-  }
-
-  if [[ ! ":$PATH:" == *":$prefix/bin:"* ]]; then
-    abort "Your path is missing $prefix/bin, you need to add this to \$PATH use this installer."
-  fi
-
-  hardware="$(uname -m)"
-  case "$hardware" in
-    x86_64)
-      arch="x64"
-      ;;
-    arm*)
-      arch="arm"
-      ;;
-    *)
-      abort "Unsupported CPU architecture $hardware."
-      ;;
-  esac
-
-  case "$(uname -s)" in
-    Darwin*)
-      platform="darwin"
-      if [[ "$arch" != "x64" ]]; then
-        abort "Unsupported CPU architecture $hardware on macOS."
-      fi
-      ;;
-    Linux*)
-      platform="linux"
-      ;;
-    *)
-      abort "This installer is supported only on macOS, Linux, and Windows Subsystem for Linux."
-      ;;
-  esac
-  url=$(hub release -L 1 | xargs hub release show --show-downloads | grep "${platform}-${arch}.tar.gz")
-  echo "Installing EAS CLI from $url"
-
-  mkdir -p "$temp_dir"
-  cd "$temp_dir"
-
-  echo
-  echo "Downloading..."
-  if [ "$(command -v curl)" ]
-  then
-    curl --location --progress-bar "$url" | tar xz
-  else
-    wget -O- "$url" | tar xz
-  fi
-
-  # Move the installation over and link the executable (may require sudo)
-  install
-
-  # Test the bundled node binary and if it doesn't work remove it (fall back to
-  # node installed in path).
-  "$prefix/lib/eas/bin/node" -v > /dev/null || {
-    rm "$prefix/lib/eas/bin/node"
-  }
-
-  # Test the CLI
-  executable=$(command -v eas) || abort "Could not run eas after installation."
-  echo
-  echo -e "EAS CLI is installed to ${executable}"
-  eas --version
-
-  echo
-  echo -e "Type ${text_bold}eas --help${text_normal} to get started."
-}

jest.config.js

@@ -1,7 +0,0 @@
-module.exports = {
-  projects: [
-    require('./packages/eas-cli/jest.config.js'),
-    require('./packages/eas-json/jest.config.js'),
-  ],
-  testPathIgnorePatterns: ['.*'],
-};

jest/jest.config.js

@@ -1,7 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  testRegex: '/__tests__/.*(test|spec)\\.[jt]sx?$',
-  watchPlugins: ['jest-watch-typeahead/filename', 'jest-watch-typeahead/testname'],
-  collectCoverageFrom: ['<rootDir>/src/**/*.{ts,tsx,js,jsx}'],
-};

jest/jest.shared.config.ts

@@ -0,0 +1,8 @@
+import type { Config } from '@jest/types';
+
+const config: Config.InitialOptions = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+};
+
+export default config;

lerna.json

@@ -1,5 +1,5 @@
 {
   "npmClient": "yarn",
-  "useWorkspaces": true,
-  "version": "0.54.0"
-}
+  "version": "18.0.4",
+  "$schema": "node_modules/lerna/schemas/lerna-schema.json"
+}

mise.toml

@@ -0,0 +1,6 @@
+[env]
+_.path = "./tools/bin"
+MISE_NODE_COREPACK = "true"
+
+[tools]
+node = "20.19.4"

package.json

@@ -1,38 +1,37 @@
 {
+  "name": "eas-cli-root",
   "private": true,
   "workspaces": [
     "packages/*"
   ],
   "scripts": {
     "build": "lerna run build",
-    "build:tarballs:linux": "yarn build-for-size-check",
-    "build-for-size-check": "yarn build && yarn workspace eas-cli pretarball-ci && CLI_SIZE_CHECK=1 yarn workspace eas-cli oclif pack:tarballs --no-xz --targets linux-x64",
     "typecheck": "lerna run typecheck",
-    "start": "lerna run watch --parallel",
+    "start": "lerna run watch --stream --parallel",
+    "start-allow-unused": "lerna run watch-allow-unused --stream --parallel",
     "watch": "yarn start",
     "eas": "packages/eas-cli/bin/run",
-    "lint": "eslint .",
-    "release": "./scripts/bin/run update-local-plugin && lerna version --exact",
-    "test": "jest",
+    "lint": "oxlint --type-aware --import-plugin --tsconfig ./tsconfig.oxlint.json .",
+    "fmt": "oxfmt .",
+    "fmt:check": "oxfmt --check .",
+    "lint-changelog": "./scripts/bin/run lint-changelog",
+    "release": "lerna run rebuild --concurrency 1 && ./scripts/bin/run release",
+    "test": "lerna run test",
     "clean": "lerna run clean && rm -rf node_modules coverage"
   },
   "devDependencies": {
-    "@types/jest": "27.5.0",
-    "@types/node": "17.0.32",
-    "eslint": "8.15.0",
-    "eslint-config-universe": "11.0.0",
-    "eslint-plugin-async-protect": "1.1.0",
-    "eslint-plugin-node": "11.1.0",
-    "jest": "28.1.0",
-    "jest-watch-typeahead": "1.1.0",
-    "lerna": "4.0.0",
-    "oclif": "3.0.1",
-    "prettier": "2.6.2",
-    "ts-jest": "28.0.2",
-    "typescript": "4.6.4"
+    "@types/jest": "29.5.11",
+    "@types/node": "20.14.8",
+    "eslint-plugin-async-protect": "3.1.0",
+    "jest": "29.7.0",
+    "jest-watch-typeahead": "2.2.2",
+    "lerna": "9.0.3",
+    "oclif": "^3.9.0",
+    "oxfmt": "0.28.0",
+    "oxlint": "1.43.0",
+    "oxlint-tsgolint": "0.11.1",
+    "ts-jest": "29.1.1",
+    "typescript": "5.5.4"
   },
-  "volta": {
-    "node": "18.2.0",
-    "yarn": "1.22.18"
-  }
+  "packageManager": "[email protected]"
 }

packages/build-tools/.gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+
+.secrets*
+!.secrets.example
+!.secrets.test
+
+src/graphql-env.d.ts
+schema.graphql

packages/build-tools/.oxlintrc.json

@@ -0,0 +1,17 @@
+{
+  "extends": ["../../.oxlintrc.json"],
+  "jsPlugins": [
+    {
+      "name": "async-protect",
+      "specifier": "eslint-plugin-async-protect"
+    }
+  ],
+  "rules": {
+    "async-protect/async-suffix": "off",
+    "no-underscore-dangle": "off",
+    "node/no-sync": "off",
+    "no-console": "off",
+    "no-void": "off",
+    "no-restricted-imports": "off"
+  }
+}

packages/build-tools/README.md

@@ -0,0 +1,7 @@
+# @expo/build-tools
+
+`@expo/build-tools` is the core library for the EAS Build service. It implements the build process for React Native projects and for managed Expo applications.
+
+## Repository
+
+https://github.com/expo/eas-cli/tree/main/packages/build-tools

packages/build-tools/bin/set-env

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+set -eo pipefail
+
+NAME=$1
+VALUE=$2
+
+if [[ -z "$__EAS_BUILD_ENVS_DIR" ]]; then
+  echo "Set __EAS_BUILD_ENVS_DIR"
+  exit 1
+fi
+
+if [[ -z "$NAME" || -z "$VALUE" ]]; then
+  echo "Usage: set-env NAME VALUE"
+  exit 2
+fi
+
+if [[ "$NAME" == *"="* ]]; then
+  echo "Environment name can't include ="
+  exit 1
+fi
+
+echo -n $VALUE > $__EAS_BUILD_ENVS_DIR/$NAME

packages/build-tools/jest/integration-config.ts

@@ -0,0 +1,13 @@
+import type { Config } from '@jest/types';
+
+import baseConfig from '../../../jest/jest.shared.config';
+
+const config: Config.InitialOptions = {
+  ...baseConfig,
+  rootDir: '../src',
+  testMatch: ['**/__integration-tests__/*.test.ts'],
+  clearMocks: true,
+  setupFilesAfterEnv: ['<rootDir>/../jest/setup-tests.ts'],
+};
+
+export default config;

packages/build-tools/jest/setup-tests.ts

@@ -0,0 +1,20 @@
+import { fs, vol } from 'memfs';
+import os from 'node:os';
+
+if (process.env.NODE_ENV !== 'test') {
+  throw new Error("NODE_ENV environment variable must be set to 'test'.");
+}
+
+// Always mock:
+jest.mock('fs');
+jest.mock('node:fs', () => fs);
+jest.mock('fs/promises');
+jest.mock('node:fs/promises', () => fs.promises);
+jest.mock('node-fetch');
+
+beforeEach(() => {
+  vol.reset();
+  vol.fromNestedJSON({
+    [os.tmpdir()]: {},
+  });
+});

packages/build-tools/jest/unit-config.ts

@@ -0,0 +1,16 @@
+import type { Config } from '@jest/types';
+
+import baseConfig from '../../../jest/jest.shared.config';
+
+const config: Config.InitialOptions = {
+  ...baseConfig,
+  rootDir: '../src',
+  testMatch: [
+    '**/__tests__/*.test.ts',
+    ...(process.platform === 'darwin' ? ['**/__tests__/*.test.ios.ts'] : []),
+  ],
+  clearMocks: true,
+  setupFilesAfterEnv: ['<rootDir>/../jest/setup-tests.ts'],
+};
+
+export default config;

packages/build-tools/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@expo/build-tools",
+  "version": "18.0.2",
+  "bugs": "https://github.com/expo/eas-cli/issues",
+  "license": "BUSL-1.1",
+  "author": "Expo <[email protected]>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/expo/eas-cli.git",
+    "directory": "packages/build-tools"
+  },
+  "files": [
+    "dist",
+    "resources",
+    "templates",
+    "bin"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "start": "yarn watch",
+    "prewatch": "yarn gql",
+    "watch": "tsc --watch --preserveWatchOutput",
+    "prebuild": "yarn gql",
+    "build": "tsc",
+    "typecheck": "tsc",
+    "prepack": "rm -rf dist *.tsbuildinfo && yarn gql && tsc -p tsconfig.build.json",
+    "jest-unit": "jest --config jest/unit-config.ts",
+    "jest-integration": "jest --config jest/integration-config.ts",
+    "jest-unit-watch": "jest --config jest/unit-config.ts --watch",
+    "jest-integration-watch": "jest --config jest/integration-config.ts --watch",
+    "clean": "rm -rf node_modules dist coverage *.tsbuildinfo",
+    "gql": "gql.tada generate-schema ${API_SERVER_URL:-https://api.expo.dev}/graphql --output ./schema.graphql && gql.tada generate-output",
+    "gql:local": "API_SERVER_URL=http://api.expo.test yarn gql",
+    "test": "yarn jest-unit"
+  },
+  "dependencies": {
+    "@expo/config": "10.0.6",
+    "@expo/config-plugins": "9.0.12",
+    "@expo/downloader": "18.0.1",
+    "@expo/eas-build-job": "18.0.2",
+    "@expo/env": "^0.4.0",
+    "@expo/logger": "18.0.1",
+    "@expo/package-manager": "1.9.10",
+    "@expo/plist": "^0.2.0",
+    "@expo/results": "^1.0.0",
+    "@expo/spawn-async": "1.7.2",
+    "@expo/steps": "18.0.2",
+    "@expo/template-file": "18.0.1",
+    "@expo/turtle-spawn": "18.0.1",
+    "@expo/xcpretty": "^4.3.1",
+    "@google-cloud/storage": "^7.11.2",
+    "@urql/core": "^6.0.1",
+    "bplist-parser": "0.3.2",
+    "fast-glob": "^3.3.2",
+    "fs-extra": "^11.2.0",
+    "gql.tada": "^1.8.13",
+    "joi": "^17.13.1",
+    "jose": "5.10.0",
+    "lodash": "^4.17.21",
+    "node-fetch": "^2.7.0",
+    "node-forge": "^1.3.1",
+    "node-stream-zip": "1.15.0",
+    "nullthrows": "^1.1.1",
+    "plist": "^3.1.0",
+    "promise-limit": "^2.7.0",
+    "promise-retry": "^2.0.1",
+    "resolve-from": "^5.0.0",
+    "retry": "^0.13.1",
+    "semver": "^7.6.2",
+    "tar": "7.5.7",
+    "uuid": "9.0.1",
+    "yaml": "^2.8.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@expo/repack-app": "~0.2.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.5.12",
+    "@types/lodash": "^4.17.4",
+    "@types/node": "20.14.2",
+    "@types/node-fetch": "^2.6.11",
+    "@types/node-forge": "^1.3.11",
+    "@types/plist": "^3.0.5",
+    "@types/promise-retry": "^1.1.6",
+    "@types/retry": "^0.12.5",
+    "@types/semver": "^7.5.8",
+    "@types/uuid": "^9.0.8",
+    "bunyan": "^1.8.15",
+    "jest": "^29.7.0",
+    "memfs": "^4.17.1",
+    "nock": "13.4.0",
+    "ts-jest": "^29.1.4",
+    "ts-mockito": "^2.6.1",
+    "tslib": "^2.6.3",
+    "typescript": "^5.5.4",
+    "uuid": "^9.0.1"
+  }
+}

packages/build-tools/src/__mocks__/@expo/logger.ts

@@ -0,0 +1,21 @@
+import bunyan from 'bunyan';
+
+export function createLogger(): bunyan {
+  const logger = {
+    info: () => {},
+    debug: () => {},
+    error: () => {},
+    warn: () => {},
+    child: _fields => logger,
+  } as bunyan;
+  return logger;
+}
+
+export enum LoggerLevel {
+  TRACE = 'trace',
+  DEBUG = 'debug',
+  INFO = 'info',
+  WARN = 'warn',
+  ERROR = 'error',
+  FATAL = 'fatal',
+}

packages/build-tools/src/__mocks__/fs.ts

@@ -0,0 +1,21 @@
+import { fs } from 'memfs';
+
+const fsRealpath = fs.realpath;
+(fsRealpath as any).native = fsRealpath;
+
+const fsRm = (
+  path: string,
+  options: object,
+  callback: (err: NodeJS.ErrnoException | null) => void
+): void => {
+  fs.promises
+    .rm(path, options)
+    .then(() => {
+      callback(null);
+    })
+    .catch(err => {
+      callback(err);
+    });
+};
+
+module.exports = { ...fs, realpath: fsRealpath, rm: fsRm };

packages/build-tools/src/__mocks__/fs/promises.ts

@@ -0,0 +1,10 @@
+import { fs } from 'memfs';
+
+const fsRealpath = fs.realpath;
+(fsRealpath as any).native = fsRealpath;
+
+const fsRm = (path: string, options: object): Promise<void> => {
+  return fs.promises.rm(path, options);
+};
+
+module.exports = { ...fs.promises, realpath: fsRealpath, rm: fsRm };

packages/build-tools/src/__tests__/context.test.ts

@@ -0,0 +1,119 @@
+import { BuildTrigger, Job, Metadata } from '@expo/eas-build-job';
+import { randomUUID } from 'crypto';
+import { vol } from 'memfs';
+
+import { createMockLogger } from './utils/logger';
+import { BuildContext } from '../context';
+
+jest.mock('fs');
+jest.mock('fs-extra');
+
+describe('BuildContext', () => {
+  it('should merge secrets', async () => {
+    const robotAccessToken = randomUUID();
+    await vol.promises.mkdir('/workingdir/eas-environment-secrets/', { recursive: true });
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [
+            {
+              name: 'TEST_SECRET',
+              value: 'test-secret-value',
+            },
+          ],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+
+    ctx.updateJobInformation({} as Job, {} as Metadata);
+
+    expect(ctx.job.secrets).toEqual({
+      robotAccessToken,
+      environmentSecrets: [
+        {
+          name: 'TEST_SECRET',
+          value: 'test-secret-value',
+        },
+      ],
+    });
+
+    const newRobotAccessToken = randomUUID();
+    ctx.updateJobInformation(
+      {
+        secrets: {
+          robotAccessToken: newRobotAccessToken,
+          environmentSecrets: [
+            {
+              name: 'TEST_SECRET',
+              value: 'new-test-secret-value',
+            },
+            {
+              name: 'TEST_SECRET_2',
+              value: 'test-secret-value-2',
+            },
+          ],
+        },
+      } as Job,
+      {} as Metadata
+    );
+
+    expect(ctx.job.secrets).toEqual({
+      robotAccessToken: newRobotAccessToken,
+      environmentSecrets: [
+        { name: 'TEST_SECRET', value: 'test-secret-value' },
+        { name: 'TEST_SECRET', value: 'new-test-secret-value' },
+        { name: 'TEST_SECRET_2', value: 'test-secret-value-2' },
+      ],
+    });
+  });
+
+  it('should not lose workflowInterpolationContext', async () => {
+    const robotAccessToken = randomUUID();
+    await vol.promises.mkdir('/workingdir/eas-environment-secrets/', { recursive: true });
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [
+            {
+              name: 'TEST_SECRET',
+              value: 'test-secret-value',
+            },
+          ],
+        },
+        workflowInterpolationContext: {
+          foo: 'bar',
+        } as any,
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+
+    ctx.updateJobInformation({} as Job, {} as Metadata);
+
+    expect(ctx.job.workflowInterpolationContext).toEqual({
+      foo: 'bar',
+    });
+  });
+});

packages/build-tools/src/__tests__/customBuildContext.test.ts

@@ -0,0 +1,37 @@
+import { BuildTrigger, Ios, Metadata } from '@expo/eas-build-job';
+
+import { createTestIosJob } from './utils/job';
+import { createMockLogger } from './utils/logger';
+import { BuildContext } from '../context';
+import { CustomBuildContext } from '../customBuildContext';
+
+describe(CustomBuildContext, () => {
+  it('should not lose workflowInterpolationContext', () => {
+    const contextUploadArtifact = jest.fn();
+    const ctx = new BuildContext(
+      createTestIosJob({
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        workflowInterpolationContext: {
+          foo: 'bar',
+        } as unknown as Ios.Job['workflowInterpolationContext'],
+      }),
+      {
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        logger: createMockLogger(),
+        uploadArtifact: contextUploadArtifact,
+        workingdir: '',
+      }
+    );
+    const customContext = new CustomBuildContext(ctx);
+    expect(customContext.job.workflowInterpolationContext).toStrictEqual({
+      foo: 'bar',
+    });
+    customContext.updateJobInformation({} as Ios.Job, {} as Metadata);
+    expect(customContext.job.workflowInterpolationContext).toStrictEqual({
+      foo: 'bar',
+    });
+  });
+});

packages/build-tools/src/__tests__/utils/context.ts

@@ -0,0 +1,100 @@
+import { bunyan } from '@expo/logger';
+import {
+  BuildRuntimePlatform,
+  BuildStepContext,
+  BuildStepEnv,
+  BuildStepGlobalContext,
+  ExternalBuildContextProvider,
+} from '@expo/steps';
+import os from 'os';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+
+import { createMockLogger } from './logger';
+
+export class MockContextProvider implements ExternalBuildContextProvider {
+  private _env: BuildStepEnv = {};
+
+  constructor(
+    public readonly logger: bunyan,
+    public readonly runtimePlatform: BuildRuntimePlatform,
+    public readonly projectSourceDirectory: string,
+    public readonly projectTargetDirectory: string,
+    public readonly defaultWorkingDirectory: string,
+    public readonly buildLogsDirectory: string,
+    public readonly staticContextContent: Record<string, any> = {}
+  ) {}
+  public get env(): BuildStepEnv {
+    return this._env;
+  }
+  public staticContext(): any {
+    return { ...this.staticContextContent };
+  }
+  public updateEnv(env: BuildStepEnv): void {
+    this._env = env;
+  }
+}
+
+interface BuildContextParams {
+  buildId?: string;
+  logger?: bunyan;
+  skipCleanup?: boolean;
+  runtimePlatform?: BuildRuntimePlatform;
+  projectSourceDirectory?: string;
+  projectTargetDirectory?: string;
+  relativeWorkingDirectory?: string;
+  staticContextContent?: Record<string, any>;
+}
+
+export function createStepContextMock({
+  buildId,
+  logger,
+  skipCleanup,
+  runtimePlatform,
+  projectSourceDirectory,
+  projectTargetDirectory,
+  relativeWorkingDirectory,
+  staticContextContent,
+}: BuildContextParams = {}): BuildStepContext {
+  const globalCtx = createGlobalContextMock({
+    buildId,
+    logger,
+    skipCleanup,
+    runtimePlatform,
+    projectSourceDirectory,
+    projectTargetDirectory,
+    relativeWorkingDirectory,
+    staticContextContent,
+  });
+  return new BuildStepContext(globalCtx, {
+    logger: logger ?? createMockLogger(),
+    relativeWorkingDirectory,
+  });
+}
+
+export function createGlobalContextMock({
+  logger,
+  skipCleanup,
+  runtimePlatform,
+  projectSourceDirectory,
+  projectTargetDirectory,
+  relativeWorkingDirectory,
+  staticContextContent,
+}: BuildContextParams = {}): BuildStepGlobalContext {
+  const resolvedProjectTargetDirectory =
+    projectTargetDirectory ?? path.join(os.tmpdir(), 'eas-build', uuidv4());
+  return new BuildStepGlobalContext(
+    new MockContextProvider(
+      logger ?? createMockLogger(),
+      runtimePlatform ?? BuildRuntimePlatform.LINUX,
+      projectSourceDirectory ?? '/non/existent/dir',
+      resolvedProjectTargetDirectory,
+      relativeWorkingDirectory
+        ? path.resolve(resolvedProjectTargetDirectory, relativeWorkingDirectory)
+        : resolvedProjectTargetDirectory,
+      '/non/existent/dir',
+      staticContextContent ?? {}
+    ),
+    skipCleanup ?? false
+  );
+}

packages/build-tools/src/__tests__/utils/job.ts

@@ -0,0 +1,94 @@
+import {
+  Android,
+  ArchiveSourceType,
+  BuildMode,
+  BuildTrigger,
+  Ios,
+  Platform,
+  Workflow,
+} from '@expo/eas-build-job';
+import { randomUUID } from 'crypto';
+
+const androidCredentials: Android.BuildSecrets['buildCredentials'] = {
+  keystore: {
+    dataBase64: 'MjEzNwo=',
+    keystorePassword: 'pass1',
+    keyAlias: 'alias',
+    keyPassword: 'pass2',
+  },
+};
+
+const iosCredentials: Ios.BuildCredentials = {
+  testapp: {
+    provisioningProfileBase64: '',
+    distributionCertificate: {
+      dataBase64: '',
+      password: '',
+    },
+  },
+};
+
+export function createTestAndroidJob({
+  buildCredentials = androidCredentials,
+}: {
+  buildCredentials?: Android.BuildSecrets['buildCredentials'];
+} = {}): Android.Job {
+  return {
+    mode: BuildMode.BUILD,
+    platform: Platform.ANDROID,
+    triggeredBy: BuildTrigger.EAS_CLI,
+    type: Workflow.GENERIC,
+    projectArchive: {
+      type: ArchiveSourceType.URL,
+      url: 'https://turtle-v2-test-fixtures.s3.us-east-2.amazonaws.com/project.tar.gz',
+    },
+    projectRootDirectory: '.',
+    applicationArchivePath: './android/app/build/outputs/apk/release/*.apk',
+    cache: {
+      clear: false,
+      disabled: false,
+      paths: [],
+    },
+    secrets: {
+      buildCredentials,
+    },
+    appId: randomUUID(),
+    initiatingUserId: randomUUID(),
+  };
+}
+
+export function createTestIosJob({
+  buildCredentials = iosCredentials,
+  triggeredBy = BuildTrigger.EAS_CLI,
+  workflowInterpolationContext,
+}: {
+  buildCredentials?: Ios.BuildCredentials;
+  triggeredBy?: Ios.Job['triggeredBy'];
+  workflowInterpolationContext?: Ios.Job['workflowInterpolationContext'];
+} = {}): Ios.Job {
+  return {
+    mode: BuildMode.BUILD,
+    platform: Platform.IOS,
+    triggeredBy,
+    type: Workflow.GENERIC,
+    projectArchive: {
+      type: ArchiveSourceType.URL,
+      url: 'https://turtle-v2-test-fixtures.s3.us-east-2.amazonaws.com/project.tar.gz',
+    },
+    scheme: 'turtlebareproj',
+    buildConfiguration: 'Release',
+    applicationArchivePath: './ios/build/*.ipa',
+    projectRootDirectory: '.',
+    cache: {
+      clear: false,
+      disabled: false,
+      paths: [],
+    },
+    secrets: {
+      buildCredentials,
+    },
+    appId: randomUUID(),
+    initiatingUserId: randomUUID(),
+    workflowInterpolationContext,
+  };
+}

packages/build-tools/src/__tests__/utils/logger.ts

@@ -0,0 +1,12 @@
+import { bunyan } from '@expo/logger';
+
+export function createMockLogger({ logToConsole = false } = {}): bunyan {
+  const logger = {
+    info: jest.fn(logToConsole ? console.info : () => {}),
+    debug: jest.fn(logToConsole ? console.debug : () => {}),
+    error: jest.fn(logToConsole ? console.error : () => {}),
+    warn: jest.fn(logToConsole ? console.warn : () => {}),
+    child: jest.fn().mockImplementation(() => createMockLogger({ logToConsole })),
+  } as unknown as bunyan;
+  return logger;
+}

packages/build-tools/src/android/__tests__/expoUpdates.test.ts

@@ -0,0 +1,147 @@
+import { AndroidConfig } from '@expo/config-plugins';
+import { vol } from 'memfs';
+import path from 'path';
+
+import {
+  AndroidMetadataName,
+  androidGetNativelyDefinedChannelAsync,
+  androidGetNativelyDefinedRuntimeVersionAsync,
+  androidSetChannelNativelyAsync,
+  androidSetRuntimeVersionNativelyAsync,
+} from '../expoUpdates';
+
+jest.mock('fs');
+const originalFs = jest.requireActual('fs');
+
+const channel = 'easupdatechannel';
+const manifestPath = '/app/android/app/src/main/AndroidManifest.xml';
+
+afterEach(() => {
+  vol.reset();
+});
+
+describe(androidSetChannelNativelyAsync, () => {
+  it('sets the channel', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/NoMetadataAndroidManifest.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: { updates: { channel } },
+      logger: { info: () => {} },
+    };
+
+    await androidSetChannelNativelyAsync(ctx as any);
+
+    const newAndroidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+    const newValue = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+      newAndroidManifest,
+      AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY
+    );
+    expect(newValue).toBeDefined();
+    expect(JSON.parse(newValue!)).toEqual({ 'expo-channel-name': channel });
+  });
+});
+
+describe(androidGetNativelyDefinedChannelAsync, () => {
+  it('gets the channel', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/AndroidManifestWithChannel.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      logger: { info: () => {} },
+    };
+
+    await expect(androidGetNativelyDefinedChannelAsync(ctx as any)).resolves.toBe('staging-123');
+  });
+});
+
+describe(androidGetNativelyDefinedRuntimeVersionAsync, () => {
+  it('gets the native runtime version', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/AndroidManifestWithRuntimeVersion.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: {},
+      logger: { info: () => {} },
+    };
+
+    const nativelyDefinedRuntimeVersion = await androidGetNativelyDefinedRuntimeVersionAsync(
+      ctx as any
+    );
+    expect(nativelyDefinedRuntimeVersion).toBe('exampleruntimeversion');
+  });
+});
+
+describe(androidSetRuntimeVersionNativelyAsync, () => {
+  it('sets the runtime version when nothing is set natively', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/NoMetadataAndroidManifest.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: {},
+      logger: { info: () => {} },
+    };
+
+    await androidSetRuntimeVersionNativelyAsync(ctx as any, '1.2.3');
+
+    const newAndroidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+    const newValue = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+      newAndroidManifest,
+      AndroidMetadataName.RUNTIME_VERSION
+    );
+    expect(newValue).toBe('1.2.3');
+  });
+  it('updates the runtime version when value is already set natively', async () => {
+    vol.fromJSON(
+      {
+        'android/app/src/main/AndroidManifest.xml': originalFs.readFileSync(
+          path.join(__dirname, 'fixtures/AndroidManifestWithRuntimeVersion.xml'),
+          'utf-8'
+        ),
+      },
+      '/app'
+    );
+    const ctx = {
+      getReactNativeProjectDirectory: () => '/app',
+      job: {},
+      logger: { info: () => {} },
+    };
+
+    await androidSetRuntimeVersionNativelyAsync(ctx as any, '1.2.3');
+
+    const newAndroidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+    const newValue = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+      newAndroidManifest,
+      AndroidMetadataName.RUNTIME_VERSION
+    );
+    expect(newValue).toBe('1.2.3');
+  });
+});

packages/build-tools/src/android/__tests__/fixtures/AndroidManifestWithChannel.xml

@@ -0,0 +1,14 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.expo.mycoolapp">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity" android:launchMode="singleTask" android:label="@string/app_name" android:configChanges="keyboard|keyboardHidden|orientation|screenSize" android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RELEASE_CHANNEL" android:value="default"/>
+        <meta-data android:name="expo.modules.updates.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY"  android:value="{&quot;expo-channel-name&quot;:&quot;staging-123&quot;}"/>
+    </application>
+</manifest>

packages/build-tools/src/android/__tests__/fixtures/AndroidManifestWithClassicReleaseChannel.xml

@@ -0,0 +1,13 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.expo.mycoolapp">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity" android:launchMode="singleTask" android:label="@string/app_name" android:configChanges="keyboard|keyboardHidden|orientation|screenSize" android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RELEASE_CHANNEL" android:value="example_channel"/>
+    </application>
+</manifest>

packages/build-tools/src/android/__tests__/fixtures/AndroidManifestWithRuntimeVersion.xml

@@ -0,0 +1,14 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.expo.mycoolapp">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity" android:launchMode="singleTask" android:label="@string/app_name" android:configChanges="keyboard|keyboardHidden|orientation|screenSize" android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RELEASE_CHANNEL" android:value="default"/>
+        <meta-data android:name="expo.modules.updates.EXPO_RUNTIME_VERSION" android:value="exampleruntimeversion"/>
+    </application>
+</manifest>

packages/build-tools/src/android/__tests__/fixtures/NoMetadataAndroidManifest.xml

@@ -0,0 +1,27 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="com.expo.mycoolapp">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+      android:name=".MainApplication"
+      android:label="@string/app_name"
+      android:icon="@mipmap/ic_launcher"
+      android:roundIcon="@mipmap/ic_launcher_round"
+      android:allowBackup="true"
+      android:theme="@style/AppTheme">
+      <activity
+        android:name=".MainActivity"
+        android:launchMode="singleTask"
+        android:label="@string/app_name"
+        android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
+        android:windowSoftInputMode="adjustResize">
+        <intent-filter>
+            <action android:name="android.intent.action.MAIN" />
+            <category android:name="android.intent.category.LAUNCHER" />
+        </intent-filter>
+      </activity>
+      <activity android:name="com.facebook.react.devsupport.DevSettingsActivity" />
+    </application>
+
+</manifest>

packages/build-tools/src/android/credentials.ts

@@ -0,0 +1,40 @@
+import { Android } from '@expo/eas-build-job';
+import fs from 'fs-extra';
+import nullthrows from 'nullthrows';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+
+import { BuildContext } from '../context';
+
+async function restoreCredentials(ctx: BuildContext<Android.Job>): Promise<void> {
+  const { buildCredentials } = nullthrows(
+    ctx.job.secrets,
+    'Secrets must be defined for non-custom builds'
+  );
+  if (!buildCredentials) {
+    // TODO: sentry (should be detected earlier)
+    throw new Error('secrets are missing in the job object');
+  }
+  ctx.logger.info("Writing secrets to the project's directory");
+  const keystorePath = path.join(ctx.buildDirectory, `keystore-${uuidv4()}`);
+  await fs.writeFile(
+    keystorePath,
+    new Uint8Array(Buffer.from(buildCredentials.keystore.dataBase64, 'base64'))
+  );
+  const credentialsJson = {
+    android: {
+      keystore: {
+        keystorePath,
+        keystorePassword: buildCredentials.keystore.keystorePassword,
+        keyAlias: buildCredentials.keystore.keyAlias,
+        keyPassword: buildCredentials.keystore.keyPassword,
+      },
+    },
+  };
+  await fs.writeFile(
+    path.join(ctx.buildDirectory, 'credentials.json'),
+    JSON.stringify(credentialsJson)
+  );
+}
+
+export { restoreCredentials };

packages/build-tools/src/android/expoUpdates.ts

@@ -0,0 +1,106 @@
+import { AndroidConfig } from '@expo/config-plugins';
+import { BuildJob, Job } from '@expo/eas-build-job';
+import assert from 'assert';
+import fs from 'fs-extra';
+
+import { BuildContext } from '../context';
+
+export enum AndroidMetadataName {
+  UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY = 'expo.modules.updates.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY',
+  RUNTIME_VERSION = 'expo.modules.updates.EXPO_RUNTIME_VERSION',
+}
+
+export async function androidSetRuntimeVersionNativelyAsync(
+  ctx: BuildContext<Job>,
+  runtimeVersion: string
+): Promise<void> {
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+
+  if (!(await fs.pathExists(manifestPath))) {
+    throw new Error(`Couldn't find Android manifest at ${manifestPath}`);
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  const mainApp = AndroidConfig.Manifest.getMainApplicationOrThrow(androidManifest);
+  AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+    mainApp,
+    AndroidMetadataName.RUNTIME_VERSION,
+    runtimeVersion,
+    'value'
+  );
+  await AndroidConfig.Manifest.writeAndroidManifestAsync(manifestPath, androidManifest);
+}
+
+export async function androidSetChannelNativelyAsync(ctx: BuildContext<BuildJob>): Promise<void> {
+  assert(ctx.job.updates?.channel, 'updates.channel must be defined');
+
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+
+  if (!(await fs.pathExists(manifestPath))) {
+    throw new Error(`Couldn't find Android manifest at ${manifestPath}`);
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  const mainApp = AndroidConfig.Manifest.getMainApplicationOrThrow(androidManifest);
+  const stringifiedUpdatesRequestHeaders = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+    androidManifest,
+    AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY
+  );
+  AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+    mainApp,
+    AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY,
+    JSON.stringify({
+      ...JSON.parse(stringifiedUpdatesRequestHeaders ?? '{}'),
+      'expo-channel-name': ctx.job.updates.channel,
+    }),
+    'value'
+  );
+  await AndroidConfig.Manifest.writeAndroidManifestAsync(manifestPath, androidManifest);
+}
+
+export async function androidGetNativelyDefinedChannelAsync(
+  ctx: BuildContext<Job>
+): Promise<string | null> {
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+
+  if (!(await fs.pathExists(manifestPath))) {
+    return null;
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  const stringifiedUpdatesRequestHeaders = AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+    androidManifest,
+    AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY
+  );
+  try {
+    const updatesRequestHeaders = JSON.parse(stringifiedUpdatesRequestHeaders ?? '{}');
+    return updatesRequestHeaders['expo-channel-name'] ?? null;
+  } catch (err: any) {
+    throw new Error(
+      `Failed to parse ${AndroidMetadataName.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY} from AndroidManifest.xml: ${err.message}`
+    );
+  }
+}
+
+export async function androidGetNativelyDefinedRuntimeVersionAsync(
+  ctx: BuildContext<Job>
+): Promise<string | null> {
+  const manifestPath = await AndroidConfig.Paths.getAndroidManifestAsync(
+    ctx.getReactNativeProjectDirectory()
+  );
+  if (!(await fs.pathExists(manifestPath))) {
+    return null;
+  }
+
+  const androidManifest = await AndroidConfig.Manifest.readAndroidManifestAsync(manifestPath);
+  return AndroidConfig.Manifest.getMainApplicationMetaDataValue(
+    androidManifest,
+    AndroidMetadataName.RUNTIME_VERSION
+  );
+}

packages/build-tools/src/android/gradle.ts

@@ -0,0 +1,118 @@
+import { Android, Env, Job, Platform } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import spawn, { SpawnPromise, SpawnResult } from '@expo/turtle-spawn';
+import assert from 'assert';
+import fs from 'fs-extra';
+import path from 'path';
+
+import { BuildContext } from '../context';
+import { getParentAndDescendantProcessPidsAsync } from '../utils/processes';
+
+export async function ensureLFLineEndingsInGradlewScript<TJob extends Job>(
+  ctx: BuildContext<TJob>
+): Promise<void> {
+  const gradlewPath = path.join(ctx.getReactNativeProjectDirectory(), 'android', 'gradlew');
+  const gradlewContent = await fs.readFile(gradlewPath, 'utf8');
+  if (gradlewContent.includes('\r')) {
+    ctx.logger.info('Replacing CRLF line endings with LF in gradlew script');
+    await fs.writeFile(gradlewPath, gradlewContent.replace(/\r\n/g, '\n'), 'utf8');
+  }
+}
+
+export async function runGradleCommand(
+  ctx: BuildContext<Job>,
+  {
+    logger,
+    gradleCommand,
+    androidDir,
+    extraEnv,
+  }: { logger: bunyan; gradleCommand: string; androidDir: string; extraEnv?: Env }
+): Promise<void> {
+  logger.info(`Running 'gradlew ${gradleCommand}' in ${androidDir}`);
+  await fs.chmod(path.join(androidDir, 'gradlew'), 0o755);
+  const verboseFlag = ctx.env['EAS_VERBOSE'] === '1' ? '--info' : '';
+
+  const spawnPromise = spawn('bash', ['-c', `./gradlew ${gradleCommand} ${verboseFlag}`], {
+    cwd: androidDir,
+    logger,
+    lineTransformer: (line?: string) => {
+      if (!line || /^\.+$/.exec(line)) {
+        return null;
+      } else {
+        return line;
+      }
+    },
+    env: { ...ctx.env, ...extraEnv, ...resolveVersionOverridesEnvs(ctx) },
+  });
+  if (ctx.env.EAS_BUILD_RUNNER === 'eas-build' && process.platform === 'linux') {
+    adjustOOMScore(spawnPromise, logger);
+  }
+
+  await spawnPromise;
+}
+
+/**
+ * OOM Killer sometimes kills worker server while build is exceeding memory limits.
+ * `oom_score_adj` is a value between -1000 and 1000 and it defaults to 0.
+ * It defines which process is more likely to get killed (higher value more likely).
+ *
+ * This function sets oom_score_adj for Gradle process and all its child processes.
+ */
+function adjustOOMScore(spawnPromise: SpawnPromise<SpawnResult>, logger: bunyan): void {
+  setTimeout(
+    async () => {
+      try {
+        assert(spawnPromise.child.pid);
+        const pids = await getParentAndDescendantProcessPidsAsync(spawnPromise.child.pid);
+        await Promise.all(
+          pids.map(async (pid: number) => {
+            // Value 800 is just a guess here. It's probably higher than most other
+            // process. I didn't want to set it any higher, because I'm not sure if OOM Killer
+            // can start killing processes when there is still enough memory left.
+            const oomScoreOverride = 800;
+            await fs.writeFile(`/proc/${pid}/oom_score_adj`, `${oomScoreOverride}\n`);
+          })
+        );
+      } catch (err: any) {
+        logger.debug({ err, stderr: err?.stderr }, 'Failed to override oom_score_adj');
+      }
+    },
+    // Wait 20 seconds to make sure all child processes are started
+    20000
+  );
+}
+
+// Version envs should be set at the beginning of the build, but when building
+// from github those values are resolved later.
+function resolveVersionOverridesEnvs(ctx: BuildContext<Job>): Env {
+  const extraEnvs: Env = {};
+  if (
+    ctx.job.platform === Platform.ANDROID &&
+    ctx.job.version?.versionCode &&
+    !ctx.env.EAS_BUILD_ANDROID_VERSION_CODE
+  ) {
+    extraEnvs.EAS_BUILD_ANDROID_VERSION_CODE = ctx.job.version.versionCode;
+  }
+  if (
+    ctx.job.platform === Platform.ANDROID &&
+    ctx.job.version?.versionName &&
+    !ctx.env.EAS_BUILD_ANDROID_VERSION_NAME
+  ) {
+    extraEnvs.EAS_BUILD_ANDROID_VERSION_NAME = ctx.job.version.versionName;
+  }
+  return extraEnvs;
+}
+
+export function resolveGradleCommand(job: Android.Job): string {
+  if (job.gradleCommand) {
+    return job.gradleCommand;
+  } else if (job.developmentClient) {
+    return ':app:assembleDebug';
+  } else if (!job.buildType) {
+    return ':app:bundleRelease';
+  } else if (job.buildType === Android.BuildType.APK) {
+    return ':app:assembleRelease';
+  } else {
+    return ':app:bundleRelease';
+  }
+}

packages/build-tools/src/android/gradleConfig.ts

@@ -0,0 +1,57 @@
+import { AndroidConfig } from '@expo/config-plugins';
+import { Android } from '@expo/eas-build-job';
+import fs from 'fs-extra';
+import path from 'path';
+
+import { BuildContext } from '../context';
+import { EasBuildGradle } from '../templates/EasBuildGradle';
+const APPLY_EAS_BUILD_GRADLE_LINE = 'apply from: "./eas-build.gradle"';
+
+export async function configureBuildGradle(ctx: BuildContext<Android.Job>): Promise<void> {
+  ctx.logger.info('Injecting signing config into build.gradle');
+  if (await fs.pathExists(getEasBuildGradlePath(ctx.getReactNativeProjectDirectory()))) {
+    ctx.markBuildPhaseHasWarnings();
+    ctx.logger.warn('eas-build.gradle script is deprecated, please remove it from your project.');
+  }
+  await deleteEasBuildGradle(ctx.getReactNativeProjectDirectory());
+  await createEasBuildGradle(ctx.getReactNativeProjectDirectory());
+  await addApplyToBuildGradle(ctx.getReactNativeProjectDirectory());
+}
+
+async function deleteEasBuildGradle(projectRoot: string): Promise<void> {
+  const easBuildGradlePath = getEasBuildGradlePath(projectRoot);
+  await fs.remove(easBuildGradlePath);
+}
+
+function getEasBuildGradlePath(projectRoot: string): string {
+  return path.join(projectRoot, 'android/app/eas-build.gradle');
+}
+
+async function createEasBuildGradle(projectRoot: string): Promise<void> {
+  const easBuildGradlePath = getEasBuildGradlePath(projectRoot);
+  await fs.writeFile(easBuildGradlePath, EasBuildGradle);
+}
+
+async function addApplyToBuildGradle(projectRoot: string): Promise<void> {
+  const buildGradlePath = AndroidConfig.Paths.getAppBuildGradleFilePath(projectRoot);
+  const buildGradleContents = await fs.readFile(path.join(buildGradlePath), 'utf8');
+
+  if (hasLine(buildGradleContents, APPLY_EAS_BUILD_GRADLE_LINE)) {
+    return;
+  }
+
+  await fs.writeFile(
+    buildGradlePath,
+    `${buildGradleContents.trim()}\n${APPLY_EAS_BUILD_GRADLE_LINE}\n`
+  );
+}
+
+function hasLine(haystack: string, needle: string): boolean {
+  return (
+    haystack
+      .replace(/\r\n/g, '\n')
+      .split('\n')
+      // Check for both single and double quotes
+      .some(line => line === needle || line === needle.replace(/"/g, "'"))
+  );
+}

packages/build-tools/src/buildErrors/__tests__/detectError.test.ts

@@ -0,0 +1,293 @@
+import { BuildMode, BuildPhase, Job, Platform, errors } from '@expo/eas-build-job';
+import { vol } from 'memfs';
+import path from 'path';
+
+import { resolveBuildPhaseErrorAsync } from '../detectError';
+
+jest.mock('fs');
+const originalFs = jest.requireActual('fs');
+
+afterEach(() => {
+  vol.reset();
+});
+
+describe(resolveBuildPhaseErrorAsync, () => {
+  it('detects log for corrupted npm package', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        '[stderr] WARN tarball tarball data for @typescript-eslint/[email protected] (sha512-cozo/GbwixVR0sgfHItz3t1yXu521yn71Wj6PlYCFA3WPhy51CUPkifFKfBis91bDclGmAY45hhaAXVjdn4new==) seems to be corrupted. Trying again.',
+      ],
+      {
+        job: { platform: Platform.ANDROID } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('NPM_CORRUPTED_PACKAGE');
+    expect(err.userFacingErrorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+  });
+
+  it('detects log for invalid bundler and reports it to user', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        "/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/dependency.rb:313:in `to_specs': Could not find 'bundler' (2.2.3) required by your /Users/expo/project/build/ios/Gemfile.lock. (Gem::MissingSpecVersionError)",
+      ],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_UNSUPPORTED_BUNDLER_VERSION_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_UNSUPPORTED_BUNDLER_VERSION_ERROR');
+  });
+
+  it('does not detect errors if they show up in different build phase', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        "/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/dependency.rb:313:in `to_specs': Could not find 'bundler' (2.2.3) required by your /Users/expo/project/build/ios/Gemfile.lock. (Gem::MissingSpecVersionError)",
+      ],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES, // it should be in RUN_FASTLANE
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+    expect(err.userFacingErrorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+  });
+
+  it('detects npm cache error if cache is enabled', async () => {
+    const mockEnv = {
+      EAS_BUILD_NPM_CACHE_URL: 'https://dominik.sokal.pl/npm/cache',
+    };
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`Blah blah Error ... ${mockEnv.EAS_BUILD_NPM_CACHE_URL}`],
+      {
+        job: { platform: Platform.ANDROID } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES,
+        env: mockEnv,
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('NPM_CACHE_ERROR');
+    expect(err.userFacingErrorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+  });
+
+  it('does not detect npm cache error if cache is disabled', async () => {
+    const mockEnv = {
+      EAS_BUILD_NPM_CACHE_URL: 'https://dominik.sokal.pl/npm/cache',
+    };
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`Blah blah Error ... ${mockEnv.EAS_BUILD_NPM_CACHE_URL}`],
+      {
+        job: { platform: Platform.ANDROID } as Job,
+        phase: BuildPhase.INSTALL_DEPENDENCIES,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+    expect(err.userFacingErrorCode).toBe(errors.ErrorCode.UNKNOWN_ERROR);
+  });
+
+  it('detects xcode line error', async () => {
+    vol.fromJSON({
+      '/path/to/xcodelogs.log': originalFs.readFileSync(
+        path.resolve('./src/buildErrors/__tests__/fixtures/xcode.log'),
+        'utf-8'
+      ),
+    });
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [''],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/path/to/'
+    );
+    expect(err.errorCode).toBe('XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR');
+    expect(err.userFacingErrorCode).toBe('XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR');
+  });
+
+  it('detects minimum deployment target error correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        'CocoaPods could not find compatible versions for pod "react-native-google-maps":16  In Podfile:17    react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)18Specs satisfying the `react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)` dependency were found, but they required a higher minimum deployment target.19Error: Compatible versions of some pods could not be resolved.',
+      ],
+      {
+        job: { platform: Platform.IOS } as Job,
+        phase: BuildPhase.INSTALL_PODS,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_HIGHER_MINIMUM_DEPLOYMENT_TARGET_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_HIGHER_MINIMUM_DEPLOYMENT_TARGET_ERROR');
+  });
+
+  it('detects provisioning profile mismatch error correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [
+        `No provisioning profile for application: '_floatsignTemp/Payload/EcoBatteryPREVIEW.app' with bundle identifier 'com.ecobattery.ecobattery-preview'`,
+      ],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.RESIGN } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_RESIGN_PROVISIONING_PROFILE_MISMATCH_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_RESIGN_PROVISIONING_PROFILE_MISMATCH_ERROR');
+  });
+
+  it('detects generic "Run Fastlane" error for resign correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`other error`],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.RESIGN } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_FASTLANE_RESIGN_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_UNKNOWN_FASTLANE_RESIGN_ERROR');
+  });
+
+  it('detects build error in "Run Fastlane" phase correctly', async () => {
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`some build error`],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/fake/path'
+    );
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_FASTLANE_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_UNKNOWN_FASTLANE_ERROR');
+  });
+
+  it('detects provisioning profile mismatch error correctly', async () => {
+    const xcodeLogs = `Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Objects-normal/arm64/82b82416624d2658e5098eb0a28c15c5-common-args.resp
+-target arm64-apple-ios15.0-simulator '-std=gnu++14' '-stdlib=libc++' -fmodules '-fmodules-cache-path=/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/ModuleCache.noindex' '-fmodule-name=yoga' -fpascal-strings -Os -fno-common '-DPOD_CONFIGURATION_RELEASE=1' '-DCOCOAPODS=1' -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator18.1.sdk -g -iquote /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-generated-files.hmap -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-own-target-headers.hmap -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-all-non-framework-target-headers.hmap -ivfsoverlay /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Pods-8699adb1dd336b26511df848a716bd42-VFS-iphonesimulator/all-product-headers.yaml -iquote /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/Yoga-project-headers.hmap -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/Yoga/include -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Private -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Private/Yoga -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Public -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods/Headers/Public/Yoga -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/DerivedSources-normal/arm64 -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/DerivedSources/arm64 -I/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Intermediates.noindex/Pods.build/Release-iphonesimulator/Yoga.build/DerivedSources -F/Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/Yoga
+MkDir /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-menu/EXDevMenu.bundle (in target 'expo-dev-menu-EXDevMenu' from project 'Pods')
+    cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods
+    /bin/mkdir -p /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-menu/EXDevMenu.bundle
+
+MkDir /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle (in target 'expo-dev-launcher-EXDevLauncher' from project 'Pods')
+    cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods
+    /bin/mkdir -p /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle
+
+ProcessXCFramework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/ProgrammaticAccessLibrary.framework ios simulator
+    cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios
+    builtin-process-xcframework --xcframework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework --platform ios --environment simulator --target-path /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator
+/Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework:1:1: error: The signature of “ProgrammaticAccessLibrary.xcframework” cannot be verified.
+    note: A sealed resource is missing or invalid
+    note: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework: a sealed resource is missing or invalid
+file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64_x86_64-simulator/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+error: Some other error
+log
+log
+log
+error: The last one
+log
+note`;
+
+    vol.fromJSON({
+      '/path/to/xcode.log': xcodeLogs,
+    });
+
+    const fakeError = new Error();
+    const err = await resolveBuildPhaseErrorAsync(
+      fakeError,
+      [`some logs`],
+      {
+        job: { platform: Platform.IOS, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_FASTLANE,
+        env: {},
+      },
+      '/path/to'
+    );
+    expect(err.errorCode).toBe('XCODE_BUILD_ERROR');
+    expect(err.userFacingErrorCode).toBe('XCODE_BUILD_ERROR');
+    expect(err.userFacingMessage)
+      .toBe(`The "Run fastlane" step failed because of an error in the Xcode build process. We automatically detected following errors in your Xcode build logs:
+- The signature of “ProgrammaticAccessLibrary.xcframework” cannot be verified.
+- Some other error
+- The last one
+Refer to "Xcode Logs" below for additional, more detailed logs.`);
+  });
+
+  it('detects MAVEN_CACHE_ERROR correctly', async () => {
+    const err = await resolveBuildPhaseErrorAsync(
+      new Error(),
+      [`https://szymon.pl/maven/cache`],
+      {
+        job: { platform: Platform.ANDROID, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_GRADLEW,
+        env: {
+          EAS_BUILD_MAVEN_CACHE_URL: 'https://szymon.pl/maven/cache',
+        },
+      },
+      '/fake/path'
+    );
+
+    expect(err.errorCode).toBe('MAVEN_CACHE_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_UNKNOWN_GRADLE_ERROR');
+    expect(err.userFacingMessage).toBe(
+      `Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.`
+    );
+  });
+
+  it('does not throw MAVEN_CACHE_ERROR if "Could not find BlurView-version-2.0.3.jar" log is present', async () => {
+    const err = await resolveBuildPhaseErrorAsync(
+      new Error(),
+      [`Could not find BlurView-version-2.0.3.jar sth sthelse https://szymon.pl/maven/cache`],
+      {
+        job: { platform: Platform.ANDROID, mode: BuildMode.BUILD } as Job,
+        phase: BuildPhase.RUN_GRADLEW,
+        env: {
+          EAS_BUILD_MAVEN_CACHE_URL: 'https://szymon.pl/maven/cache',
+        },
+      },
+      '/fake/path'
+    );
+
+    expect(err.errorCode).toBe('EAS_BUILD_UNKNOWN_GRADLE_ERROR');
+    expect(err.userFacingErrorCode).toBe('EAS_BUILD_UNKNOWN_GRADLE_ERROR');
+    expect(err.userFacingMessage).toBe(
+      `Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.`
+    );
+  });
+});

packages/build-tools/src/buildErrors/__tests__/fixtures/xcode.log

@@ -0,0 +1 @@
+/Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "EXConstants-EXConstants" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'EXConstants-EXConstants' from project 'Pods')

packages/build-tools/src/buildErrors/buildErrorHandlers.ts

@@ -0,0 +1,361 @@
+import { BuildPhase, Platform } from '@expo/eas-build-job';
+import escapeRegExp from 'lodash/escapeRegExp';
+
+import { ErrorContext, ErrorHandler } from './errors.types';
+
+export class TrackedBuildError extends Error {
+  constructor(
+    public errorCode: string,
+    public message: string
+  ) {
+    super(message);
+  }
+}
+
+export const buildErrorHandlers: ErrorHandler<TrackedBuildError>[] = [
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // example log:
+    // CDN: trunk URL couldn't be downloaded: https://cdn.jsdelivr.net/cocoa/Specs/2/a/e/MultiplatformBleAdapter/0.0.3/MultiplatformBleAdapter.podspec.json Response: 429 429: Too Many Requests
+    regexp: /CDN: trunk URL couldn't be downloaded.* Response: 429 429: Too Many Requests/,
+    createError: () =>
+      new TrackedBuildError('COCOAPODS_TO_MANY_REQUEST', 'cocoapods: too many requests'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // Host key verification failed.
+    // fatal: Could not read from remote repository.
+    regexp: /Host key verification failed\.\nfatal: Could not read from remote repository/,
+    createError: () => new TrackedBuildError('NPM_INSTALL_SSH_AUTHENTICATION', 'Missing ssh key.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // error [email protected]: The engine "node" is incompatible with this module. Expected version "14". Got "16.13.2"
+    // error Found incompatible module.
+    regexp: /The engine "node" is incompatible with this module\. Expected version/,
+    createError: () =>
+      new TrackedBuildError('NODE_ENGINE_INCOMPATIBLE', 'node: Incompatible engine field.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // error An unexpected error occurred: "https://registry.yarnpkg.com/@react-native/normalize-color/-/normalize-color-2.0.0.tgz: Request failed \"500 Internal Server Error\"".
+    // or
+    // error An unexpected error occurred: "https://registry.yarnpkg.com/request/-/request-2.88.2.tgz: Request failed \"503 Service Unavailable\"".
+    regexp: /An unexpected error occurred: "https:\/\/registry.yarnpkg.com\/.*Request failed \\"5/,
+    createError: () => new TrackedBuildError('YARN_REGISTRY_5XX_RESPONSE', 'yarn: 5xx response.'),
+  },
+  {
+    phase: BuildPhase.PREBUILD,
+    // Input is required, but Expo CLI is in non-interactive mode
+    // or
+    // CommandError: Input is required, but 'npx expo' is in non-interactive mode.
+    regexp: /Input is required, but .* is in non-interactive mode/,
+    createError: () =>
+      new TrackedBuildError(
+        'EXPO_CLI_INPUT_REQUIRED_ERROR',
+        `expo-cli: Input required in non-interactive mode.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.PREBUILD,
+    // [03:03:05] [ios.infoPlist]: withIosInfoPlistBaseMod: GoogleService-Info.plist is empty
+    regexp: /withIosInfoPlistBaseMod: GoogleService-Info\.plist is empty/,
+    createError: () =>
+      new TrackedBuildError(
+        'EXPO_CLI_EMPTY_GOOGLE_SERVICES_PLIST_ERROR',
+        `expo-cli: Empty GoogleService-Info.plist.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.PREBUILD,
+    // [01:52:04] [ios.xcodeproj]: withIosXcodeprojBaseMod: Path to GoogleService-Info.plist is not defined. Please specify the `expo.ios.googleServicesFile` field in app.json.
+    regexp: /withIosXcodeprojBaseMod: Path to GoogleService-Info\.plist is not defined/,
+    createError: () =>
+      new TrackedBuildError(
+        'EXPO_CLI_NOT_DEFINED_GOOGLE_SERVICES_PLIST_ERROR',
+        `expo-cli: Path to GoogleService-Info.plist is not defined.`
+      ),
+  },
+  {
+    phase: BuildPhase.PREBUILD,
+    // Error: [android.dangerous]: withAndroidDangerousBaseMod: ENOENT: no such file or directory, open './assets/adaptive-icon.png'
+    //     at Object.openSync (node:fs:585:3)
+    //     at readFileSync (node:fs:453:35)
+    //     at calculateHash (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:14:91)
+    //     at createCacheKey (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:19:18)
+    //     at Object.createCacheKeyWithDirectoryAsync (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:24:33)
+    //     at generateImageAsync (/home/expo/workingdir/build/node_modules/@expo/image-utils/build/Image.js:151:34)
+    //     at async generateIconAsync (/home/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withAndroidIcons.js:369:11)
+    //     at async /home/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withAndroidIcons.js:310:21
+    //     at async Promise.all (index 0)
+    //     at async generateMultiLayerImageAsync (/home/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withAndroidIcons.js:306:3)
+    //     or
+    // Error: [ios.dangerous]: withIosDangerousBaseMod: ENOENT: no such file or directory, open './assets/images/app_icon_staging.png'
+    //     at Object.openSync (fs.js:497:3)
+    //     at readFileSync (fs.js:393:35)
+    //     at calculateHash (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:14:91)
+    //     at createCacheKey (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:19:18)
+    //     at Object.createCacheKeyWithDirectoryAsync (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Cache.js:24:33)
+    //     at generateImageAsync (/Users/expo/workingdir/build/node_modules/@expo/image-utils/build/Image.js:151:34)
+    //     at async setIconsAsync (/Users/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withIosIcons.js:169:15)
+    //     at async /Users/expo/workingdir/build/node_modules/@expo/prebuild-config/build/plugins/icons/withIosIcons.js:71:5
+    //     at async action (/Users/expo/workingdir/build/node_modules/@expo/config-plugins/build/plugins/withMod.js:235:23)
+    //     at async interceptingMod (/Users/expo/workingdir/build/node_modules/@expo/config-plugins/build/plugins/withMod.js:126:21)
+    regexp:
+      /ENOENT: no such file or directory[\s\S]*prebuild-config\/build\/plugins\/icons\/with(Android|Ios)Icons\.js/,
+    createError: () => new TrackedBuildError('EXPO_CLI_MISSING_ICON', 'expo-cli: Missing icon.'),
+  },
+  {
+    phase: BuildPhase.PREBUILD,
+    // Cannot determine which native SDK version your project uses because the module `expo` is not installed. Please install it with `yarn add expo` and try again.
+    regexp:
+      /Cannot determine which native SDK version your project uses because the module `expo` is not installed/,
+    createError: () =>
+      new TrackedBuildError('EXPO_CLI_EXPO_PACKAGE_MISSING', 'expo-cli: "expo" package missing.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_PODS,
+    // The Swift pod `FirebaseCoreInternal` depends upon `GoogleUtilities`, which does not define modules. To opt into those targets generating module maps (which is necessary to import them from Swift when building as static
+    regexp: /The Swift pod .* depends upon .* which does not define modules/,
+    createError: () =>
+      new TrackedBuildError(
+        'SWIFT_POD_INCOMPATIBLE_DEPENDENCY',
+        'pod: Swift pod depends on a pod that does not define modules.'
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // Adding spec repo `24-repository-cocoapods-proxy` with CDN `http://10.254.24.7:8081/repository/cocoapods-proxy/`
+    // [!] No podspec exists at path `/Users/expo/.cocoapods/repos/24-repository-cocoapods-proxy/Specs/1/9/2/libwebp/1.2.0/libwebp.podspec.json`.
+    regexp: /Adding spec repo .* with CDN .*\n\s*\[!\] No podspec exists at path `(.*)`/,
+    // Some pods are hosted on git registries that are not supported e.g. chromium.googlesource.com
+    createError: (match: RegExpMatchArray) =>
+      new TrackedBuildError(
+        'COCOAPODS_CACHE_INCOMPATIBLE_REPO_ERROR',
+        `cocoapods: Missing podspec ${match[1]}.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // [!] Invalid `Podfile` file: 783: unexpected token at 'info Run CLI with --verbose flag for more details.
+    regexp:
+      /\[!\] Invalid `Podfile` file: .* unexpected token at 'info Run CLI with --verbose flag for more details./,
+    createError: () =>
+      new TrackedBuildError('NODE_ENV_PRODUCTION_DEFINED', 'npm: NODE_ENV=production was defined.'),
+  },
+  ...[BuildPhase.INSTALL_DEPENDENCIES, BuildPhase.PREBUILD].map(phase => ({
+    phase,
+    // example log:
+    // [stderr] WARN tarball tarball data for @typescript-eslint/[email protected] (sha512-cozo/GbwixVR0sgfHItz3t1yXu521yn71Wj6PlYCFA3WPhy51CUPkifFKfBis91bDclGmAY45hhaAXVjdn4new==) seems to be corrupted. Trying again.
+    regexp: /tarball tarball data for ([^ ]*) .* seems to be corrupted. Trying again/,
+    createError: (match: RegExpMatchArray) =>
+      new TrackedBuildError('NPM_CORRUPTED_PACKAGE', `npm: corrupted package ${match[1]}`),
+  })),
+  ...[BuildPhase.INSTALL_DEPENDENCIES, BuildPhase.PREBUILD].map(phase => ({
+    phase,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_NPM_CACHE_URL
+        ? new RegExp(escapeRegExp(env.EAS_BUILD_NPM_CACHE_URL))
+        : undefined,
+    createError: () => new TrackedBuildError('NPM_CACHE_ERROR', `npm: cache error`),
+  })),
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_COCOAPODS_CACHE_URL ? /Error installing/ : undefined,
+    createError: () =>
+      new TrackedBuildError(
+        'COCOAPODS_CACHE_INSTALLING_POD_ERROR',
+        `cocoapods: error installing a pod using internal cache instance`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_COCOAPODS_CACHE_URL ? /No podspec exists at path/ : undefined,
+    createError: () =>
+      new TrackedBuildError(
+        'COCOAPODS_CACHE_NO_PODSPEC_EXISTS_AT_PATH_ERROR',
+        `cocoapods: error fetching a podspec through internal cache instance`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_COCOAPODS_CACHE_URL
+        ? new RegExp(escapeRegExp(env.EAS_BUILD_COCOAPODS_CACHE_URL))
+        : undefined,
+    createError: () => new TrackedBuildError('COCOAPODS_CACHE_ERROR', `cocoapods: cache error`),
+  },
+  {
+    phase: BuildPhase.INSTALL_PODS,
+    // [!] Invalid `Podfile` file: uninitialized constant Pod::Podfile::FlipperConfiguration.
+    regexp: /\[!\] Invalid `Podfile` file/,
+    createError: () => new TrackedBuildError('INVALID_PODFILE', 'pod: Invalid Podfile file.'),
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // info There appears to be trouble with your network connection. Retrying...
+    regexp: /info There appears to be trouble with your network connection. Retrying/,
+    createError: () =>
+      new TrackedBuildError(
+        'YARN_INSTALL_TROUBLE_WITH_NETWORK_CONNECTION',
+        'yarn: There appears to be trouble with your network connection'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Android Gradle plugin requires Java 11 to run. You are currently using Java 1.8
+    regexp: /Android Gradle plugin requires Java .* to run. You are currently using Java/,
+    createError: () =>
+      new TrackedBuildError('INCOMPATIBLE_JAVA_VERSION', 'gradle: Incompatible java version.'),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // /home/expo/workingdir/build/android/app/src/main/AndroidManifest.xml:27:9-33:20 Error:
+    //  	android:exported needs to be explicitly specified for element <activity#androidx.test.core.app.InstrumentationActivityInvoker$EmptyActivity>. Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported` when the corresponding component has an intent filter defined. See https://developer.android.com/guide/topics/manifest/activity-element#exported for details.
+    regexp:
+      /Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported`/,
+    createError: () =>
+      new TrackedBuildError(
+        'REQUIRE_EXPLICIT_EXPORTED_ANDROID_12',
+        'Apps targeting Android 12 and higher are required to specify an explicit value for `android:exported`.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // > A failure occurred while executing com.android.build.gradle.internal.res.Aapt2CompileRunnable
+    //   > Android resource compilation failed
+    //     ERROR:/home/expo/workingdir/build/android/app/src/main/res/mipmap-mdpi/ic_launcher.png: AAPT: error: failed to read PNG signature: file does not start with PNG signature.
+    regexp: /AAPT: error: failed to read PNG signature: file does not start with PNG signature/,
+    createError: () =>
+      new TrackedBuildError('INVALID_PNG_SIGNATURE', 'gradle: Invalid PNG signature.'),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Execution failed for task ':app:processReleaseGoogleServices'.
+    // > Malformed root json
+    regexp: /Execution failed for task ':app:process.*GoogleServices'.*\s.*Malformed root json/,
+    createError: () =>
+      new TrackedBuildError(
+        'GRADLE_MALFORMED_GOOGLE_SERVICES_JSON',
+        'gradle: Malformed google-services.json.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Execution failed for task ':app:processDebugGoogleServices'.
+    // > Missing project_info object
+    regexp:
+      /Execution failed for task ':app:process.*GoogleServices'.*\s.*Missing project_info object/,
+    createError: () =>
+      new TrackedBuildError(
+        'GRADLE_MALFORMED_GOOGLE_SERVICES_JSON',
+        'gradle: Missing project_info object.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_GRADLEW,
+    platform: Platform.ANDROID,
+    // Execution failed for task ':app:bundleReleaseJsAndAssets'.
+    // > Process 'command 'node'' finished with non-zero exit value 1
+    regexp:
+      /Execution failed for task ':app:bundleReleaseJsAndAssets'.*\s.*Process 'command 'node'' finished with non-zero exit value/,
+    createError: () =>
+      new TrackedBuildError(
+        'GRADLE_BUILD_BUNDLER_ERROR',
+        "gradle: ':app:bundleReleaseJsAndAssets' failed."
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    //    > Could not resolve org.jetbrains.kotlin:kotlin-annotation-processing-gradle:1.5.10.
+    //      Required by:
+    //          project :expo-updates
+    //       > Could not resolve org.jetbrains.kotlin:kotlin-annotation-processing-gradle:1.5.10.
+    //          > Could not get resource 'https://lsdkfjsdlkjf.com/android/releases/org/jetbrains/kotlin/kotlin-annotation-processing-gradle/1.5.10/kotlin-annotation-processing-gradle-1.5.10.pom'.
+    //             > Could not HEAD 'https://slkdfjldskjfl.com/android/releases/org/jetbrains/kotlin/kotlin-annotation-processing-gradle/1.5.10/kotlin-annotation-processing-gradle-1.5.10.pom'.
+    //                > Connect to sdlkfjsdlkf.com:443 [slkdfjdslk.com/38.178.101.5] failed: connect timed out
+    regexp: /Could not get resource.*\n.*Could not HEAD 'https/,
+    createError: () =>
+      new TrackedBuildError('MAVEN_REGISTRY_CONNECTION_ERROR', `maven: registry connection error`),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    regexp: ({ env }: ErrorContext) =>
+      env.EAS_BUILD_MAVEN_CACHE_URL
+        ? // The BlurView 2.0.3 jar was removed from jitpack.io
+          // and it caused false positive MAVEN_CACHE_ERROR errors being reported.
+          new RegExp(
+            `^(?!.*Could not find BlurView-version-2\\.0\\.3\\.jar).*${escapeRegExp(
+              env.EAS_BUILD_MAVEN_CACHE_URL
+            )}`
+          )
+        : undefined,
+    createError: () => new TrackedBuildError('MAVEN_CACHE_ERROR', `maven: cache error`),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // error: exportArchive: exportOptionsPlist error for key "iCloudContainerEnvironment": expected one of {Development, Production}, but no value was provided
+    regexp: /exportArchive: exportOptionsPlist error for key "iCloudContainerEnvironment"/,
+    createError: () =>
+      new TrackedBuildError(
+        'MISSING_ICLOUD_CONTAINER_ENVIRONMENT',
+        'fastlane: Missing iCloudContainerEnvironment in exportOptionsPlist.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // The following build commands failed:
+    //	PhaseScriptExecution [CP-User]\ Generate\ app.manifest\ for\ expo-updates /Users/expo/Library/Developer/Xcode/DerivedData/Kenkohub-eqseedlxbgrzjqagscbclhbtstwh/Build/Intermediates.noindex/ArchiveIntermediates/Kenkohub/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/EXUpdates.build/Script-BB6B5FD28815C045A20B2E5E3FEEBD6E.sh (in target 'EXUpdates' from project 'Pods')
+    regexp:
+      /The following build commands failed.*\s.*\[CP-User\]\\ Generate\\ app\.manifest\\ for\\ expo-updates/,
+    createError: () =>
+      new TrackedBuildError(
+        'XCODE_BUILD_UPDATES_PHASE_SCRIPT',
+        'fastlane: Generating app.manifest for expo-updates failed.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // The following build commands failed:
+    // 	CompileC /Users/expo/Library/Developer/Xcode/DerivedData/Docent-amxxhphjfdtkpxecgidgzvwvnvtc/Build/Intermediates.noindex/ArchiveIntermediates/Docent/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/Flipper-Folly.build/Objects-normal/arm64/SSLErrors.o /Users/expo/workingdir/build/ios/Pods/Flipper-Folly/folly/io/async/ssl/SSLErrors.cpp normal arm64 c++ com.apple.compilers.llvm.clang.1_0.compiler (in target 'Flipper-Folly' from project 'Pods')
+    regexp: /in target 'Flipper-Folly' from project 'Pods'/,
+    createError: () =>
+      new TrackedBuildError(
+        'FLIPPER_FOLLY_COMPILE_ERROR',
+        'fastlane: Flipper-Folly compile error.'
+      ),
+  },
+  {
+    phase: BuildPhase.RUN_FASTLANE,
+    platform: Platform.IOS,
+    // The following build commands failed:
+    //	PhaseScriptExecution Bundle\ React\ Native\ code\ and\ images /Users/expo/Library/Developer/Xcode/DerivedData/cnaxwpahkhcjluhigkcwrturapmm/Build/Intermediates.noindex/ArchiveIntermediates/Test/IntermediateBuildFilesPath/Test.build/Release-iphoneos/Test.build/Script-00DD1BFF151E006B06BC.sh (in target 'Test' from project 'Test')
+    regexp:
+      /The following build commands failed.*\s.*PhaseScriptExecution Bundle\\ React\\ Native\\ code\\ and\\ images \/Users\/expo/,
+    createError: () =>
+      new TrackedBuildError(
+        'XCODE_BUILD_BUNDLER_ERROR',
+        'fastlane: Bundle React Native code and images failed.'
+      ),
+  },
+];

packages/build-tools/src/buildErrors/detectError.ts

@@ -0,0 +1,106 @@
+import { BuildPhase, errors } from '@expo/eas-build-job';
+import fs from 'fs-extra';
+
+import { buildErrorHandlers } from './buildErrorHandlers';
+import { ErrorContext, ErrorHandler, XCODE_BUILD_PHASE } from './errors.types';
+import { userErrorHandlers } from './userErrorHandlers';
+import { findXcodeBuildLogsPathAsync } from '../ios/xcodeBuildLogs';
+
+async function maybeReadXcodeBuildLogs(
+  phase: BuildPhase,
+  buildLogsDirectory: string
+): Promise<string | undefined> {
+  if (phase !== BuildPhase.RUN_FASTLANE) {
+    return;
+  }
+
+  try {
+    const xcodeBuildLogsPath = await findXcodeBuildLogsPathAsync(buildLogsDirectory);
+
+    if (!xcodeBuildLogsPath) {
+      return;
+    }
+
+    return await fs.readFile(xcodeBuildLogsPath, 'utf-8');
+  } catch {
+    return undefined;
+  }
+}
+
+function resolveError<TError extends Error>(
+  errorHandlers: ErrorHandler<TError>[],
+  logLines: string[],
+  errorContext: ErrorContext,
+  xcodeBuildLogs?: string
+): TError | undefined {
+  const { job, phase } = errorContext;
+  const { platform } = job;
+  const logs = logLines.join('\n');
+  const handlers = errorHandlers
+    .filter(handler => handler.platform === platform || !handler.platform)
+    .filter(
+      handler =>
+        (handler.phase === XCODE_BUILD_PHASE && phase === BuildPhase.RUN_FASTLANE) ||
+        handler.phase === phase ||
+        !handler.phase
+    )
+    .filter(handler => ('mode' in job && handler.mode === job.mode) || !handler.mode);
+
+  for (const handler of handlers) {
+    const regexp =
+      typeof handler.regexp === 'function' ? handler.regexp(errorContext) : handler.regexp;
+    if (!regexp) {
+      continue;
+    }
+    const match =
+      handler.phase === XCODE_BUILD_PHASE ? xcodeBuildLogs?.match(regexp) : logs.match(regexp);
+
+    if (match) {
+      return handler.createError(match, errorContext);
+    }
+  }
+  return undefined;
+}
+
+export async function resolveBuildPhaseErrorAsync(
+  error: any,
+  logLines: string[],
+  errorContext: ErrorContext,
+  buildLogsDirectory: string
+): Promise<errors.BuildError> {
+  const { phase } = errorContext;
+  if (error instanceof errors.BuildError) {
+    return error;
+  }
+  const xcodeBuildLogs = await maybeReadXcodeBuildLogs(phase, buildLogsDirectory);
+  const userFacingError =
+    error instanceof errors.UserFacingError
+      ? error
+      : (resolveError(userErrorHandlers, logLines, errorContext, xcodeBuildLogs) ??
+        new errors.UnknownError(errorContext.phase));
+  const buildError = resolveError(buildErrorHandlers, logLines, errorContext, xcodeBuildLogs);
+
+  const isUnknownUserError =
+    !userFacingError ||
+    (
+      [
+        errors.ErrorCode.UNKNOWN_ERROR,
+        errors.ErrorCode.UNKNOWN_GRADLE_ERROR,
+        errors.ErrorCode.UNKNOWN_FASTLANE_ERROR,
+      ] as string[]
+    ).includes(userFacingError.errorCode);
+  const message =
+    (isUnknownUserError ? buildError?.message : userFacingError.message) ?? userFacingError.message;
+  const errorCode =
+    (isUnknownUserError ? buildError?.errorCode : userFacingError.errorCode) ??
+    userFacingError.errorCode;
+
+  return new errors.BuildError(message, {
+    errorCode,
+    userFacingErrorCode: userFacingError.errorCode,
+    userFacingMessage: userFacingError.message,
+    docsUrl: userFacingError.docsUrl,
+    innerError: error,
+    buildPhase: phase,
+  });
+}

packages/build-tools/src/buildErrors/errors.types.ts

@@ -0,0 +1,17 @@
+import { BuildMode, BuildPhase, Env, Job, Platform } from '@expo/eas-build-job';
+
+export interface ErrorContext<TJob extends Job = Job> {
+  phase: BuildPhase;
+  job: TJob;
+  env: Env;
+}
+
+export const XCODE_BUILD_PHASE = 'XCODE_BUILD';
+
+export interface ErrorHandler<T extends Error> {
+  regexp: RegExp | ((ctx: ErrorContext) => RegExp | undefined);
+  platform?: Platform;
+  phase?: BuildPhase | typeof XCODE_BUILD_PHASE;
+  mode?: BuildMode;
+  createError: (matchResult: RegExpMatchArray, errCtx: ErrorContext) => T | undefined;
+}

packages/build-tools/src/buildErrors/userErrorHandlers.ts

@@ -0,0 +1,317 @@
+import { BuildMode, BuildPhase, Platform, Workflow, errors } from '@expo/eas-build-job';
+
+import { ErrorHandler, XCODE_BUILD_PHASE } from './errors.types';
+
+import UserFacingError = errors.UserFacingError;
+
+export const userErrorHandlers: ErrorHandler<UserFacingError>[] = [
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    regexp: /requires CocoaPods version/,
+    // example log:
+    // [!] `React` requires CocoaPods version `>= 1.10.1`, which is not satisfied by your current version, `1.10.0`.
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_UNSUPPORTED_COCOAPODS_VERSION_ERROR',
+        `Your project requires a newer version of CocoaPods. You can update it in the build profile in eas.json by either:
+- changing the current version under key "cocoapods"
+- switching to an image that supports that version under key "image"`,
+        { docsUrl: 'https://docs.expo.dev/build-reference/eas-json/' }
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    regexp: /Could not find 'bundler' (.*) required by your/,
+    // example log:
+    // /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/rubygems/dependency.rb:313:in `to_specs': Could not find 'bundler' (2.2.3) required by your /Users/expo/project/build/ios/Gemfile.lock. (Gem::MissingSpecVersionError)
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_UNSUPPORTED_BUNDLER_VERSION_ERROR',
+        `Your project requires a different version of the Ruby "bundler" program than the version installed in this EAS Build environment. You can specify which version of "bundler" to install by specifying the version under "build"→[buildProfileName]→"ios"→"bundler" in eas.json.`,
+        { docsUrl: 'https://docs.expo.dev/build-reference/eas-json/' }
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    // example log:
+    // > Failed to read key keyalias from store "/build/workingdir/build/generic/keystore-5787e6af-3002-4cb7-8a57-3e73d13313c2.jks": Invalid keystore format
+    regexp: /Invalid keystore format/,
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_INVALID_KEYSTORE_FORMAT_ERROR',
+        'The keystore used in this build is malformed or it has an unsupported type. Make sure you provided the correct file.'
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    // example log:
+    // > Failed to read key keyalias from store "/build/workingdir/build/generic/keystore-286069a8-4bb9-48a6-add9-acf6b58ea06d.jks": null
+    regexp: /Failed to read key[^\n]+from store/,
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_INVALID_KEYSTORE_ALIAS_ERROR',
+        'The alias specified for this keystore does not exist. Make sure you specified the correct value.'
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.PREBUILD,
+    // example log:
+    // [15:42:05] Error: Cannot copy google-services.json from /build/workingdir/build/managed/abc to /build/workingdir/build/managed/android/app/google-services.json
+    // or
+    // [11:17:29] [android.dangerous]: withAndroidDangerousBaseMod: Cannot copy google-services.json from /home/expo/workingdir/build/test/test-google-services.json to /home/expo/workingdir/build/android/app/google-services.json. Please make sure the source and destination paths exist.
+    // [11:17:29] Error: [android.dangerous]: withAndroidDangerousBaseMod: Cannot copy google-services.json from /home/expo/workingdir/build/test/test-google-services.json to /home/expo/workingdir/build/android/app/google-services.json. Please make sure the source and destination paths exist.
+    regexp: /Cannot copy google-services\.json/,
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_MISSING_GOOGLE_SERVICES_JSON_ERROR',
+        '"google-services.json" is missing, make sure that the file exists. Remember that EAS Build only uploads the files tracked by git. Use EAS environment variables to provide EAS Build with the file.',
+        { docsUrl: 'https://docs.expo.dev/eas/environment-variables/#file-environment-variables' }
+      ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    // Execution failed for task ':app:processReleaseGoogleServices'.
+    // > File google-services.json is missing. The Google Services Plugin cannot function without it.
+    //    Searched Location:
+    regexp:
+      /File google-services\.json is missing\. The Google Services Plugin cannot function without it/,
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_MISSING_GOOGLE_SERVICES_JSON_ERROR',
+        '"google-services.json" is missing, make sure that the file exists. Remember that EAS Build only uploads the files tracked by git. Use EAS environment variables to provide EAS Build with the file.',
+        { docsUrl: 'https://docs.expo.dev/eas/environment-variables/#file-environment-variables' }
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.PREBUILD,
+    // example log:
+    // [08:44:18] ENOENT: no such file or directory, copyfile '/Users/expo/workingdir/build/managed/abc' -> '/Users/expo/workingdir/build/managed/ios/testapp/GoogleService-Info.plist'
+    regexp: /ENOENT: no such file or directory, copyfile .*GoogleService-Info.plist/,
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_MISSING_GOOGLE_SERVICES_PLIST_ERROR',
+        '"GoogleService-Info.plist" is missing, make sure that the file exists. Remember that EAS Build only uploads the files tracked by git. Use EAS environment variables to provide EAS Build with the file.',
+        { docsUrl: 'https://docs.expo.dev/eas/environment-variables/#file-environment-variables' }
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // example log:
+    // [!] CocoaPods could not find compatible versions for pod "react-native-google-maps"
+    // In Podfile:
+    // react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)
+    // Specs satisfying the `react-native-google-maps (from `/Users/expo/workingdir/build/node_modules/react-native-maps`)` dependency were found, but they required a higher minimum deployment target.
+    // Error: Compatible versions of some pods could not be resolved.
+    regexp:
+      /Specs satisfying the `(.*)` dependency were found, but they required a higher minimum deployment target/,
+    createError: (_, { job }) => {
+      return new UserFacingError(
+        'EAS_BUILD_HIGHER_MINIMUM_DEPLOYMENT_TARGET_ERROR',
+        `Some pods require a higher minimum deployment target.
+${
+  'type' in job && job.type === Workflow.MANAGED
+    ? 'You can use the expo-build-properties config plugin (https://docs.expo.dev/versions/latest/sdk/build-properties/) to override the default native build properties and set a different minimum deployment target.'
+    : 'You need to manually update the minimum deployment target in your project to resolve this issue.'
+}
+`
+      );
+    },
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.INSTALL_PODS,
+    // example log:
+    // [!] CocoaPods could not find compatible versions for pod "Firebase/Core":
+    //   In snapshot (Podfile.lock):
+    //     Firebase/Core (= 6.14.0)
+    //   In Podfile:
+    //     EXFirebaseCore (from `../node_modules/expo-firebase-core/ios`) was resolved to 3.0.0, which depends on
+    //       Firebase/Core (= 7.7.0)
+    // You have either:
+    //  * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
+    //  * changed the constraints of dependency `Firebase/Core` inside your development pod `EXFirebaseCore`.
+    //    You should run `pod update Firebase/Core` to apply changes you've made.
+    regexp: /CocoaPods could not find compatible versions for pod /,
+    createError: () => {
+      return new UserFacingError(
+        'EAS_BUILD_INCOMPATIBLE_PODS_ERROR',
+        `Compatible versions of some pods could not be resolved.
+You are seeing this error because either:
+  - Some of the pods used in your project depend on different versions of the same pod. See logs for more information.
+  - If you are caching Podfile.lock using "cache" field in eas.json, then versions there might not match required values in Podspecs of some installed libraries. To fix this, you can re-run build command with "--clear-cache" option, or select "Clear cache and retry build" on the build page.
+`
+      );
+    },
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // example log:
+    // [stderr] npm ERR! Fix the upstream dependency conflict, or retry
+    // [stderr] npm ERR! this command with --force, or --legacy-peer-deps
+    // [stderr] npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
+    regexp:
+      /Fix the upstream dependency conflict, or retry.*\s.*this command with --force, or --legacy-peer-deps/,
+    createError: (matchResult: RegExpMatchArray) => {
+      if (matchResult.length >= 2) {
+        return new UserFacingError(
+          'EAS_BUILD_NPM_CONFLICTING_PEER_DEPENDENCIES',
+          `Some of your peer dependencies are not compatible. The recommended approach is to fix your dependencies by resolving any conflicts listed by "npm install". As a temporary workaround you can:
+- Add ".npmrc" file with "legacy-peer-deps=true" and commit that to your repo.
+- Delete package-lock.json and use yarn instead. It does not enforce peer dependencies.
+- Downgrade to older version of npm on EAS Build, by adding "npm install -g npm@version" in "eas-build-pre-install" script in package.json.`
+        );
+      }
+      return undefined;
+    },
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // example log:
+    // [stderr] error https://github.com/expo/react-native/archive/sdk-41.0.0.tar.gz: Integrity check failed for "react-native" (computed integrity doesn't match our records, got "sha512-3jHI2YufrJi7eIABRf/DN/I2yOkmIZ0vAyezTz+PAUJiEs4v//5LLojWEU+W53AZsnuaEMcl/4fVy4bd+OuUbA== sha1-o9QuQTXIkc8VozXPaZIullB9a40=")
+    regexp: /Integrity check failed for "(.*)" \(computed integrity doesn't match our records, got/,
+    createError: (matchResult: RegExpMatchArray) => {
+      if (matchResult.length >= 2) {
+        return new UserFacingError(
+          'EAS_BUILD_YARN_LOCK_CHECKSUM_ERROR',
+          `Checksum for package "${matchResult[1]}" does not match value in registry. To fix that:
+- run "yarn cache clean"
+- remove yarn.lock (or only the section for that package)
+- run "yarn install --force"`
+        );
+      }
+      return undefined;
+    },
+  },
+  {
+    phase: BuildPhase.INSTALL_DEPENDENCIES,
+    // example log:
+    // yarn install v1.22.17
+    // [1/4] Resolving packages...
+    // [2/4] Fetching packages...
+    // [1/4] Resolving packages...
+    // [2/4] Fetching packages...
+    // [stderr] error https://registry.yarnpkg.com/jest-util/-/jest-util-26.6.2.tgz: Extracting tar content of undefined failed, the file appears to be corrupt: "ENOENT: no such file or directory, chmod '/Users/expo/Library/Caches/Yarn/v6/npm-jest-util-26.6.2-907535dbe4d5a6cb4c47ac9b926f6af29576cbc1-integrity/node_modules/jest-util/build/pluralize.d.ts'"
+    regexp:
+      /\[1\/4\] Resolving packages...\s*\[2\/4\] Fetching packages...\s*\[1\/4\] Resolving packages...\s*\[2\/4\] Fetching packages.../,
+    createError: (matchResult: RegExpMatchArray) => {
+      if (matchResult) {
+        return new UserFacingError(
+          'EAS_BUILD_YARN_MULTIPLE_INSTANCES_ERROR',
+          `One of project dependencies is starting new install process while the main one is still in progress, which might result in corrupted packages. Most likely the reason for error is "prepare" script in git-referenced dependency of your project. Learn more: https://github.com/yarnpkg/yarn/issues/7212#issuecomment-493720324`
+        );
+      }
+      return undefined;
+    },
+  },
+  {
+    platform: Platform.IOS,
+    phase: XCODE_BUILD_PHASE,
+    // Prepare packages
+    // Computing target dependency graph and provisioning inputs
+    // Create build description
+    // Build description signature: 33a5c28977280822abe5e7bd7fe02529
+    // Build description path: /Users/expo/Library/Developer/Xcode/DerivedData/testapp-fazozgerxcvvfifkipojsjftgyih/Build/Intermediates.noindex/ArchiveIntermediates/testapp/IntermediateBuildFilesPath/XCBuildData/33a5c28977280822abe5e7bd7fe02529-desc.xcbuild
+    // note: Building targets in dependency order
+    // /Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "EXConstants-EXConstants" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'EXConstants-EXConstants' from project 'Pods')
+    // /Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "React-Core-AccessibilityResources" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'React-Core-AccessibilityResources' from project 'Pods')
+    // warning: Run script build phase '[CP-User] Generate app.manifest for expo-updates' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'EXUpdates' from project 'Pods')
+    // warning: Run script build phase 'Start Packager' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'testapp' from project 'testapp')
+    // warning: Run script build phase 'Bundle React Native code and images' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'testapp' from project 'testapp')
+    // warning: Run script build phase '[CP-User] Generate app.config for prebuilt Constants.manifest' will be run during every build because it does not specify any outputs. To address this warning, either add output dependencies to the script phase, or configure it to run in every build by unchecking "Based on dependency analysis" in the script phase. (in target 'EXConstants' from project 'Pods')
+    // /Users/expo/workingdir/build/managed/ios/Pods/Pods.xcodeproj: error: Signing for "EXUpdates-EXUpdates" requires a development team. Select a development team in the Signing & Capabilities editor. (in target 'EXUpdates-EXUpdates' from project 'Pods')
+    regexp: /error: Signing for "[a-zA-Z-0-9_]+" requires a development team/,
+    createError: (_, { job }) =>
+      'type' in job && job.type === Workflow.MANAGED
+        ? new UserFacingError(
+            'XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR',
+            `Starting from Xcode 14, resource bundles are signed by default, which requires setting the development team for each resource bundle target.
+To resolve this issue, downgrade to an older Xcode version using the "image" field in eas.json, or upgrade to SDK 46 or higher.`,
+            {
+              docsUrl:
+                'https://docs.expo.dev/build-reference/infrastructure/#ios-build-server-configurations',
+            }
+          )
+        : new UserFacingError(
+            'XCODE_RESOURCE_BUNDLE_CODE_SIGNING_ERROR',
+            `Starting from Xcode 14, resource bundles are signed by default, which requires setting the development team for each resource bundle target.
+To resolve this issue, downgrade to an older Xcode version using the "image" field in eas.json, or turn off signing resource bundles in your Podfile: https://expo.fyi/r/disable-bundle-resource-signing`,
+            {
+              docsUrl:
+                'https://docs.expo.dev/build-reference/infrastructure/#ios-build-server-configurations',
+            }
+          ),
+  },
+  {
+    platform: Platform.ANDROID,
+    phase: BuildPhase.RUN_GRADLEW,
+    regexp: /.*/,
+    createError: () =>
+      new UserFacingError(
+        errors.ErrorCode.UNKNOWN_GRADLE_ERROR,
+        'Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.'
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    mode: BuildMode.RESIGN,
+    regexp: /No provisioning profile for application: '(.+)' with bundle identifier '(.+)'/,
+    createError: () =>
+      new UserFacingError(
+        'EAS_BUILD_RESIGN_PROVISIONING_PROFILE_MISMATCH_ERROR',
+        `The bundle identifier in provisioning profile used to resign the app does not match the bundle identifier of the app selected to be resigned. See logs above for more information.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    mode: BuildMode.RESIGN,
+    regexp: /.*/,
+    createError: () =>
+      new UserFacingError(
+        errors.ErrorCode.UNKNOWN_FASTLANE_RESIGN_ERROR,
+        `The "Run fastlane" step failed with an unknown error.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: XCODE_BUILD_PHASE,
+    // MkDir /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle (in target 'expo-dev-launcher-EXDevLauncher' from project 'Pods')
+    // cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/Pods
+    // /bin/mkdir -p /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/expo-dev-launcher/EXDevLauncher.bundle
+    // ProcessXCFramework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator/ProgrammaticAccessLibrary.framework ios simulator
+    // cd /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios
+    // builtin-process-xcframework --xcframework /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework --platform ios --environment simulator --target-path /Users/expo/workingdir/build/packages/apps/NFLNetwork/ios/build/Build/Products/Release-iphonesimulator
+    // /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework:1:1: error: The signature of “ProgrammaticAccessLibrary.xcframework” cannot be verified.
+    // note: A sealed resource is missing or invalid
+    // note: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework: a sealed resource is missing or invalid
+    // file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64_x86_64-simulator/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+    // file modified: /Users/expo/workingdir/build/packages/video/ios/Vendor/dependency/ProgrammaticAccessLibrary.xcframework/ios-arm64/ProgrammaticAccessLibrary.framework/ProgrammaticAccessLibrary
+    regexp: /error: .+/g,
+    createError: matchResult =>
+      new UserFacingError(
+        'XCODE_BUILD_ERROR',
+        `The "Run fastlane" step failed because of an error in the Xcode build process. We automatically detected following errors in your Xcode build logs:\n${matchResult
+          .map(match => `- ${match.replace('error: ', '')}`)
+          .join('\n')}\nRefer to "Xcode Logs" below for additional, more detailed logs.`
+      ),
+  },
+  {
+    platform: Platform.IOS,
+    phase: BuildPhase.RUN_FASTLANE,
+    regexp: /.*/,
+    createError: () =>
+      new UserFacingError(
+        errors.ErrorCode.UNKNOWN_FASTLANE_ERROR,
+        `The "Run fastlane" step failed with an unknown error. Refer to "Xcode Logs" below for additional, more detailed logs.`
+      ),
+  },
+];

packages/build-tools/src/builders/__tests__/custom.test.ts

@@ -0,0 +1,77 @@
+import { BuildJob } from '@expo/eas-build-job';
+import { vol } from 'memfs';
+
+import { createTestIosJob } from '../../__tests__/utils/job';
+import { createMockLogger } from '../../__tests__/utils/logger';
+import { prepareProjectSourcesAsync } from '../../common/projectSources';
+import { BuildContext } from '../../context';
+import { findAndUploadXcodeBuildLogsAsync } from '../../ios/xcodeBuildLogs';
+import { runCustomBuildAsync } from '../custom';
+
+jest.mock('../../common/projectSources');
+jest.mock('../../ios/xcodeBuildLogs');
+
+const findAndUploadXcodeBuildLogsAsyncMock = jest.mocked(findAndUploadXcodeBuildLogsAsync);
+
+describe(runCustomBuildAsync, () => {
+  let ctx: BuildContext<BuildJob>;
+
+  beforeEach(() => {
+    const job = createTestIosJob();
+
+    jest.mocked(prepareProjectSourcesAsync).mockImplementation(async () => {
+      vol.mkdirSync('/workingdir/env', { recursive: true });
+      vol.mkdirSync('/workingdir/temporary-custom-build', { recursive: true });
+      vol.fromJSON(
+        {
+          'test.yaml': `
+          build:
+            steps:
+              - eas/checkout
+          `,
+        },
+        '/workingdir/temporary-custom-build'
+      );
+      return { handled: true };
+    });
+
+    ctx = new BuildContext(
+      {
+        ...job,
+        customBuildConfig: {
+          path: 'test.yaml',
+        },
+      },
+      {
+        workingdir: '/workingdir',
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        logger: createMockLogger(),
+        env: {
+          __API_SERVER_URL: 'http://api.expo.test',
+        },
+        uploadArtifact: jest.fn(),
+      }
+    );
+  });
+
+  it('calls findAndUploadXcodeBuildLogsAsync in an iOS job if its artifacts is empty', async () => {
+    await runCustomBuildAsync(ctx);
+    expect(findAndUploadXcodeBuildLogsAsyncMock).toHaveBeenCalled();
+  });
+
+  it('does not call findAndUploadXcodeBuildLogsAsync in an iOS job if artifacts is already present', async () => {
+    ctx.artifacts.XCODE_BUILD_LOGS = 'uploaded';
+    await runCustomBuildAsync(ctx);
+    expect(findAndUploadXcodeBuildLogsAsyncMock).not.toHaveBeenCalled();
+  });
+
+  it('retries checking out the project', async () => {
+    jest.mocked(prepareProjectSourcesAsync).mockImplementationOnce(async () => {
+      throw new Error('Failed to clone repository');
+    });
+
+    await runCustomBuildAsync(ctx);
+
+    expect(prepareProjectSourcesAsync).toHaveBeenCalledTimes(2);
+  });
+});

packages/build-tools/src/builders/android.ts

@@ -0,0 +1,192 @@
+import { Android, BuildMode, BuildPhase, Workflow } from '@expo/eas-build-job';
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { runBuilderWithHooksAsync } from './common';
+import { runCustomBuildAsync } from './custom';
+import { restoreCredentials } from '../android/credentials';
+import {
+  ensureLFLineEndingsInGradlewScript,
+  resolveGradleCommand,
+  runGradleCommand,
+} from '../android/gradle';
+import { configureBuildGradle } from '../android/gradleConfig';
+import { eagerBundleAsync, shouldUseEagerBundle } from '../common/eagerBundle';
+import { prebuildAsync } from '../common/prebuild';
+import { setupAsync } from '../common/setup';
+import { Artifacts, BuildContext, SkipNativeBuildError } from '../context';
+import { cacheStatsAsync, restoreCcacheAsync } from '../steps/functions/restoreBuildCache';
+import { saveCcacheAsync } from '../steps/functions/saveBuildCache';
+import { uploadApplicationArchive } from '../utils/artifacts';
+import {
+  configureExpoUpdatesIfInstalledAsync,
+  resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync,
+} from '../utils/expoUpdates';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+import { prepareExecutableAsync } from '../utils/prepareBuildExecutable';
+
+export default async function androidBuilder(ctx: BuildContext<Android.Job>): Promise<Artifacts> {
+  if (ctx.job.mode === BuildMode.BUILD) {
+    await prepareExecutableAsync(ctx);
+    return await runBuilderWithHooksAsync(ctx, buildAsync);
+  } else if (ctx.job.mode === BuildMode.RESIGN) {
+    throw new Error('Not implemented');
+  } else if (ctx.job.mode === BuildMode.CUSTOM || ctx.job.mode === BuildMode.REPACK) {
+    return await runCustomBuildAsync(ctx);
+  } else {
+    throw new Error('Not implemented');
+  }
+}
+
+async function buildAsync(ctx: BuildContext<Android.Job>): Promise<void> {
+  await setupAsync(ctx);
+  const evictUsedBefore = new Date();
+  const workingDirectory = ctx.getReactNativeProjectDirectory();
+  const hasNativeCode = ctx.job.type === Workflow.GENERIC;
+
+  if (hasNativeCode) {
+    await ctx.runBuildPhase(BuildPhase.FIX_GRADLEW, async () => {
+      await ensureLFLineEndingsInGradlewScript(ctx);
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.PREBUILD, async () => {
+    if (hasNativeCode) {
+      ctx.markBuildPhaseSkipped();
+      ctx.logger.info(
+        'Skipped running "expo prebuild" because the "android" directory already exists. Learn more about the build process: https://docs.expo.dev/build-reference/android-builds/'
+      );
+      return;
+    }
+    await prebuildAsync(ctx, {
+      logger: ctx.logger,
+      workingDir: ctx.getReactNativeProjectDirectory(),
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.RESTORE_CACHE, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds do not support restoring cache');
+      return;
+    }
+    await ctx.cacheManager?.restoreCache(ctx);
+    await restoreCcacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      platform: ctx.job.platform,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.POST_INSTALL_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.POST_INSTALL);
+  });
+
+  const resolvedExpoUpdatesRuntimeVersion = await ctx.runBuildPhase(
+    BuildPhase.CALCULATE_EXPO_UPDATES_RUNTIME_VERSION,
+    async () => {
+      return await resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync({
+        cwd: ctx.getReactNativeProjectDirectory(),
+        logger: ctx.logger,
+        appConfig: ctx.appConfig,
+        platform: ctx.job.platform,
+        workflow: ctx.job.type,
+        env: ctx.env,
+      });
+    }
+  );
+
+  if (
+    nullthrows(ctx.job.secrets, 'Secrets must be defined for non-custom builds').buildCredentials
+  ) {
+    await ctx.runBuildPhase(BuildPhase.PREPARE_CREDENTIALS, async () => {
+      await restoreCredentials(ctx);
+      await configureBuildGradle(ctx);
+    });
+  }
+  await ctx.runBuildPhase(BuildPhase.CONFIGURE_EXPO_UPDATES, async () => {
+    await configureExpoUpdatesIfInstalledAsync(ctx, {
+      resolvedRuntimeVersion: resolvedExpoUpdatesRuntimeVersion?.runtimeVersion ?? null,
+      resolvedFingerprintSources: resolvedExpoUpdatesRuntimeVersion?.fingerprintSources ?? null,
+    });
+  });
+
+  if (ctx.skipNativeBuild) {
+    throw new SkipNativeBuildError('Skipping Gradle build');
+  }
+
+  if (!ctx.env.EAS_BUILD_DISABLE_BUNDLE_JAVASCRIPT_STEP && shouldUseEagerBundle(ctx.metadata)) {
+    await ctx.runBuildPhase(BuildPhase.EAGER_BUNDLE, async () => {
+      await eagerBundleAsync({
+        platform: ctx.job.platform,
+        workingDir: ctx.getReactNativeProjectDirectory(),
+        logger: ctx.logger,
+        env: {
+          ...ctx.env,
+          ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+            ? {
+                EXPO_UPDATES_FINGERPRINT_OVERRIDE:
+                  resolvedExpoUpdatesRuntimeVersion?.runtimeVersion,
+                EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+              }
+            : null),
+        },
+        packageManager: ctx.packageManager,
+      });
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.RUN_GRADLEW, async () => {
+    const gradleCommand = resolveGradleCommand(ctx.job);
+    await runGradleCommand(ctx, {
+      logger: ctx.logger,
+      gradleCommand,
+      androidDir: path.join(ctx.getReactNativeProjectDirectory(), 'android'),
+      ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+        ? {
+            extraEnv: {
+              EXPO_UPDATES_FINGERPRINT_OVERRIDE: resolvedExpoUpdatesRuntimeVersion.runtimeVersion,
+              EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+            },
+          }
+        : null),
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.PRE_UPLOAD_ARTIFACTS_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.PRE_UPLOAD_ARTIFACTS);
+  });
+
+  await ctx.runBuildPhase(BuildPhase.UPLOAD_APPLICATION_ARCHIVE, async () => {
+    await uploadApplicationArchive(ctx, {
+      patternOrPath: ctx.job.applicationArchivePath ?? 'android/app/build/outputs/**/*.{apk,aab}',
+      rootDir: ctx.getReactNativeProjectDirectory(),
+      logger: ctx.logger,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.SAVE_CACHE, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds do not support saving cache.');
+      return;
+    }
+    await ctx.cacheManager?.saveCache(ctx);
+    await saveCcacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      platform: ctx.job.platform,
+      evictUsedBefore,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.CACHE_STATS, async () => {
+    await cacheStatsAsync({
+      logger: ctx.logger,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+}

packages/build-tools/src/builders/common.ts

@@ -0,0 +1,52 @@
+import { BuildJob, BuildPhase, Ios, Platform } from '@expo/eas-build-job';
+
+import { Artifacts, BuildContext } from '../context';
+import { findAndUploadXcodeBuildLogsAsync } from '../ios/xcodeBuildLogs';
+import { maybeFindAndUploadBuildArtifacts } from '../utils/artifacts';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+
+export async function runBuilderWithHooksAsync<T extends BuildJob>(
+  ctx: BuildContext<T>,
+  builderAsync: (ctx: BuildContext<T>) => Promise<void>
+): Promise<Artifacts> {
+  try {
+    let buildSuccess = true;
+    try {
+      await builderAsync(ctx);
+      await ctx.runBuildPhase(BuildPhase.ON_BUILD_SUCCESS_HOOK, async () => {
+        await runHookIfPresent(ctx, Hook.ON_BUILD_SUCCESS);
+      });
+    } catch (err: any) {
+      buildSuccess = false;
+      await ctx.runBuildPhase(BuildPhase.ON_BUILD_ERROR_HOOK, async () => {
+        await runHookIfPresent(ctx, Hook.ON_BUILD_ERROR);
+      });
+      throw err;
+    } finally {
+      await ctx.runBuildPhase(BuildPhase.ON_BUILD_COMPLETE_HOOK, async () => {
+        await runHookIfPresent(ctx, Hook.ON_BUILD_COMPLETE, {
+          extraEnvs: {
+            EAS_BUILD_STATUS: buildSuccess ? 'finished' : 'errored',
+          },
+        });
+      });
+
+      if (ctx.job.platform === Platform.IOS) {
+        await findAndUploadXcodeBuildLogsAsync(ctx as BuildContext<Ios.Job>, {
+          logger: ctx.logger,
+        });
+      }
+
+      await ctx.runBuildPhase(BuildPhase.UPLOAD_BUILD_ARTIFACTS, async () => {
+        await maybeFindAndUploadBuildArtifacts(ctx, {
+          logger: ctx.logger,
+        });
+      });
+    }
+  } catch (err: any) {
+    err.artifacts = ctx.artifacts;
+    throw err;
+  }
+
+  return ctx.artifacts;
+}

packages/build-tools/src/builders/custom.ts

@@ -0,0 +1,104 @@
+import { BuildJob, BuildPhase, BuildTrigger, Ios, Platform } from '@expo/eas-build-job';
+import { BuildConfigParser, BuildStepGlobalContext, StepsConfigParser, errors } from '@expo/steps';
+import assert from 'assert';
+import fs from 'fs/promises';
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { resolveEnvFromBuildProfileAsync } from '../common/easBuildInternal';
+import { prepareProjectSourcesAsync } from '../common/projectSources';
+import { Artifacts, BuildContext } from '../context';
+import { CustomBuildContext } from '../customBuildContext';
+import { findAndUploadXcodeBuildLogsAsync } from '../ios/xcodeBuildLogs';
+import { getEasFunctionGroups } from '../steps/easFunctionGroups';
+import { getEasFunctions } from '../steps/easFunctions';
+import { retryAsync } from '../utils/retry';
+
+export async function runCustomBuildAsync(ctx: BuildContext<BuildJob>): Promise<Artifacts> {
+  const customBuildCtx = new CustomBuildContext(ctx);
+
+  await ctx.runBuildPhase(BuildPhase.PREPARE_PROJECT, async () => {
+    await retryAsync(
+      async () => {
+        await fs.rm(customBuildCtx.projectSourceDirectory, { recursive: true, force: true });
+        await fs.mkdir(customBuildCtx.projectSourceDirectory, { recursive: true });
+
+        await prepareProjectSourcesAsync(ctx, customBuildCtx.projectSourceDirectory);
+      },
+      {
+        retryOptions: {
+          retries: 3,
+          retryIntervalMs: 1_000,
+        },
+      }
+    );
+  });
+
+  if (ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION) {
+    // We need to setup envs from eas.json
+    const env = await resolveEnvFromBuildProfileAsync(ctx, {
+      cwd: path.join(customBuildCtx.projectSourceDirectory, ctx.job.projectRootDirectory ?? '.'),
+    });
+    ctx.updateEnv(env);
+    customBuildCtx.updateEnv(ctx.env);
+  }
+
+  assert(
+    'steps' in ctx.job || 'customBuildConfig' in ctx.job,
+    'Steps or custom build config path are required in custom jobs'
+  );
+
+  const globalContext = new BuildStepGlobalContext(customBuildCtx, false);
+  const easFunctions = getEasFunctions(customBuildCtx);
+  const easFunctionGroups = getEasFunctionGroups(customBuildCtx);
+  const parser = ctx.job.steps
+    ? new StepsConfigParser(globalContext, {
+        externalFunctions: easFunctions,
+        externalFunctionGroups: easFunctionGroups,
+        steps: ctx.job.steps,
+      })
+    : new BuildConfigParser(globalContext, {
+        externalFunctions: easFunctions,
+        externalFunctionGroups: easFunctionGroups,
+        configPath: path.join(
+          ctx.getReactNativeProjectDirectory(customBuildCtx.projectSourceDirectory),
+          nullthrows(
+            ctx.job.customBuildConfig?.path,
+            'Steps or custom build config path are required in custom jobs'
+          )
+        ),
+      });
+  const workflow = await ctx.runBuildPhase(BuildPhase.PARSE_CUSTOM_WORKFLOW_CONFIG, async () => {
+    try {
+      return await parser.parseAsync();
+    } catch (parseError: any) {
+      ctx.logger.error('Failed to parse the custom build config file.');
+      if (parseError instanceof errors.BuildWorkflowError) {
+        for (const err of parseError.errors) {
+          ctx.logger.error({ err });
+        }
+      }
+      throw parseError;
+    }
+  });
+  try {
+    try {
+      await workflow.executeAsync();
+    } finally {
+      if (!ctx.artifacts.XCODE_BUILD_LOGS && ctx.job.platform === Platform.IOS) {
+        try {
+          await findAndUploadXcodeBuildLogsAsync(ctx as BuildContext<Ios.Job>, {
+            logger: ctx.logger,
+          });
+        } catch {
+          // do nothing, it's a non-breaking error.
+        }
+      }
+    }
+  } catch (err: any) {
+    err.artifacts = ctx.artifacts;
+    throw err;
+  }
+
+  return ctx.artifacts;
+}

packages/build-tools/src/builders/index.ts

@@ -0,0 +1,4 @@
+import androidBuilder from './android';
+import iosBuilder from './ios';
+
+export { androidBuilder, iosBuilder };

packages/build-tools/src/builders/ios.ts

@@ -0,0 +1,328 @@
+import { IOSConfig } from '@expo/config-plugins';
+import { BuildMode, BuildPhase, Ios, ManagedArtifactType, Workflow } from '@expo/eas-build-job';
+import plist from '@expo/plist';
+import fs from 'fs-extra';
+import nullthrows from 'nullthrows';
+
+import { runBuilderWithHooksAsync } from './common';
+import { runCustomBuildAsync } from './custom';
+import { eagerBundleAsync, shouldUseEagerBundle } from '../common/eagerBundle';
+import { prebuildAsync } from '../common/prebuild';
+import { setupAsync } from '../common/setup';
+import { Artifacts, BuildContext } from '../context';
+import { configureXcodeProject } from '../ios/configure';
+import CredentialsManager from '../ios/credentials/manager';
+import { runFastlaneGym, runFastlaneResign } from '../ios/fastlane';
+import { installPods } from '../ios/pod';
+import { downloadApplicationArchiveAsync } from '../ios/resign';
+import { resolveArtifactPath, resolveBuildConfiguration, resolveScheme } from '../ios/resolve';
+import { cacheStatsAsync, restoreCcacheAsync } from '../steps/functions/restoreBuildCache';
+import { saveCcacheAsync } from '../steps/functions/saveBuildCache';
+import { uploadApplicationArchive } from '../utils/artifacts';
+import {
+  configureExpoUpdatesIfInstalledAsync,
+  resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync,
+} from '../utils/expoUpdates';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+import { prepareExecutableAsync } from '../utils/prepareBuildExecutable';
+import { getParentAndDescendantProcessPidsAsync } from '../utils/processes';
+
+const INSTALL_PODS_WARN_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes
+const INSTALL_PODS_KILL_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+
+class InstallPodsTimeoutError extends Error {}
+
+export default async function iosBuilder(ctx: BuildContext<Ios.Job>): Promise<Artifacts> {
+  if (ctx.job.mode === BuildMode.BUILD) {
+    await prepareExecutableAsync(ctx);
+    return await runBuilderWithHooksAsync(ctx, buildAsync);
+  } else if (ctx.job.mode === BuildMode.RESIGN) {
+    return await resignAsync(ctx);
+  } else if (ctx.job.mode === BuildMode.CUSTOM || ctx.job.mode === BuildMode.REPACK) {
+    return await runCustomBuildAsync(ctx);
+  } else {
+    throw new Error('Not implemented');
+  }
+}
+
+async function buildAsync(ctx: BuildContext<Ios.Job>): Promise<void> {
+  await setupAsync(ctx);
+  const hasNativeCode = ctx.job.type === Workflow.GENERIC;
+  const evictUsedBefore = new Date();
+  const credentialsManager = new CredentialsManager(ctx);
+  const workingDirectory = ctx.getReactNativeProjectDirectory();
+  try {
+    const credentials = await ctx.runBuildPhase(BuildPhase.PREPARE_CREDENTIALS, async () => {
+      return await credentialsManager.prepare();
+    });
+
+    await ctx.runBuildPhase(BuildPhase.PREBUILD, async () => {
+      if (hasNativeCode) {
+        ctx.markBuildPhaseSkipped();
+        ctx.logger.info(
+          'Skipped running "expo prebuild" because the "ios" directory already exists. Learn more about the build process: https://docs.expo.dev/build-reference/ios-builds/'
+        );
+        return;
+      }
+      const extraEnvs: Record<string, string> = credentials?.teamId
+        ? { APPLE_TEAM_ID: credentials.teamId }
+        : {};
+      await prebuildAsync(ctx, {
+        logger: ctx.logger,
+        workingDir: ctx.getReactNativeProjectDirectory(),
+        options: { extraEnvs },
+      });
+    });
+
+    await ctx.runBuildPhase(BuildPhase.RESTORE_CACHE, async () => {
+      if (ctx.isLocal) {
+        ctx.logger.info('Local builds do not support restoring cache');
+        return;
+      }
+      await ctx.cacheManager?.restoreCache(ctx);
+      await restoreCcacheAsync({
+        logger: ctx.logger,
+        workingDirectory,
+        platform: ctx.job.platform,
+        env: ctx.env,
+        secrets: ctx.job.secrets,
+      });
+    });
+
+    await ctx.runBuildPhase(BuildPhase.INSTALL_PODS, async () => {
+      await runInstallPodsAsync(ctx);
+    });
+
+    await ctx.runBuildPhase(BuildPhase.POST_INSTALL_HOOK, async () => {
+      await runHookIfPresent(ctx, Hook.POST_INSTALL);
+    });
+
+    const resolvedExpoUpdatesRuntimeVersion = await ctx.runBuildPhase(
+      BuildPhase.CALCULATE_EXPO_UPDATES_RUNTIME_VERSION,
+      async () => {
+        return await resolveRuntimeVersionForExpoUpdatesIfConfiguredAsync({
+          cwd: ctx.getReactNativeProjectDirectory(),
+          logger: ctx.logger,
+          appConfig: ctx.appConfig,
+          platform: ctx.job.platform,
+          workflow: ctx.job.type,
+          env: ctx.env,
+        });
+      }
+    );
+
+    const buildConfiguration = resolveBuildConfiguration(ctx);
+    if (credentials) {
+      await ctx.runBuildPhase(BuildPhase.CONFIGURE_XCODE_PROJECT, async () => {
+        await configureXcodeProject(ctx, { credentials, buildConfiguration });
+      });
+    }
+
+    await ctx.runBuildPhase(BuildPhase.CONFIGURE_EXPO_UPDATES, async () => {
+      await configureExpoUpdatesIfInstalledAsync(ctx, {
+        resolvedRuntimeVersion: resolvedExpoUpdatesRuntimeVersion?.runtimeVersion ?? null,
+        resolvedFingerprintSources: resolvedExpoUpdatesRuntimeVersion?.fingerprintSources ?? null,
+      });
+    });
+
+    if (!ctx.env.EAS_BUILD_DISABLE_BUNDLE_JAVASCRIPT_STEP && shouldUseEagerBundle(ctx.metadata)) {
+      await ctx.runBuildPhase(BuildPhase.EAGER_BUNDLE, async () => {
+        await eagerBundleAsync({
+          platform: ctx.job.platform,
+          workingDir: ctx.getReactNativeProjectDirectory(),
+          logger: ctx.logger,
+          env: {
+            ...ctx.env,
+            ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+              ? {
+                  EXPO_UPDATES_FINGERPRINT_OVERRIDE:
+                    resolvedExpoUpdatesRuntimeVersion?.runtimeVersion,
+                  EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+                }
+              : null),
+          },
+          packageManager: ctx.packageManager,
+        });
+      });
+    }
+
+    await ctx.runBuildPhase(BuildPhase.RUN_FASTLANE, async () => {
+      const scheme = resolveScheme(ctx);
+      const entitlements = await readEntitlementsAsync(ctx, { scheme, buildConfiguration });
+      await runFastlaneGym(ctx, {
+        credentials,
+        scheme,
+        buildConfiguration,
+        entitlements,
+        ...(resolvedExpoUpdatesRuntimeVersion?.runtimeVersion
+          ? {
+              extraEnv: {
+                EXPO_UPDATES_FINGERPRINT_OVERRIDE:
+                  resolvedExpoUpdatesRuntimeVersion?.runtimeVersion,
+                EXPO_UPDATES_WORKFLOW_OVERRIDE: ctx.job.type,
+              },
+            }
+          : null),
+      });
+    });
+  } finally {
+    await ctx.runBuildPhase(BuildPhase.CLEAN_UP_CREDENTIALS, async () => {
+      await credentialsManager.cleanUp();
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.PRE_UPLOAD_ARTIFACTS_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.PRE_UPLOAD_ARTIFACTS);
+  });
+
+  await ctx.runBuildPhase(BuildPhase.UPLOAD_APPLICATION_ARCHIVE, async () => {
+    await uploadApplicationArchive(ctx, {
+      patternOrPath: resolveArtifactPath(ctx),
+      rootDir: ctx.getReactNativeProjectDirectory(),
+      logger: ctx.logger,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.SAVE_CACHE, async () => {
+    if (ctx.isLocal) {
+      ctx.logger.info('Local builds do not support saving cache.');
+      return;
+    }
+    await ctx.cacheManager?.saveCache(ctx);
+    await saveCcacheAsync({
+      logger: ctx.logger,
+      workingDirectory,
+      platform: ctx.job.platform,
+      evictUsedBefore,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.CACHE_STATS, async () => {
+    await cacheStatsAsync({
+      logger: ctx.logger,
+      env: ctx.env,
+      secrets: ctx.job.secrets,
+    });
+  });
+}
+
+async function readEntitlementsAsync(
+  ctx: BuildContext<Ios.Job>,
+  { scheme, buildConfiguration }: { scheme: string; buildConfiguration: string }
+): Promise<object | null> {
+  try {
+    const applicationTargetName =
+      await IOSConfig.BuildScheme.getApplicationTargetNameForSchemeAsync(
+        ctx.getReactNativeProjectDirectory(),
+        scheme
+      );
+    const entitlementsPath = IOSConfig.Entitlements.getEntitlementsPath(
+      ctx.getReactNativeProjectDirectory(),
+      {
+        buildConfiguration,
+        targetName: applicationTargetName,
+      }
+    );
+    if (!entitlementsPath) {
+      return null;
+    }
+    const entitlementsRaw = await fs.readFile(entitlementsPath, 'utf8');
+    return plist.parse(entitlementsRaw);
+  } catch (err) {
+    ctx.logger.warn({ err }, 'Failed to read entitlements');
+    ctx.markBuildPhaseHasWarnings();
+    return null;
+  }
+}
+
+async function resignAsync(ctx: BuildContext<Ios.Job>): Promise<Artifacts> {
+  const applicationArchivePath = await ctx.runBuildPhase(
+    BuildPhase.DOWNLOAD_APPLICATION_ARCHIVE,
+    async () => {
+      return await downloadApplicationArchiveAsync(ctx);
+    }
+  );
+
+  const credentialsManager = new CredentialsManager(ctx);
+  try {
+    const credentials = await ctx.runBuildPhase(BuildPhase.PREPARE_CREDENTIALS, async () => {
+      return await credentialsManager.prepare();
+    });
+
+    await ctx.runBuildPhase(BuildPhase.RUN_FASTLANE, async () => {
+      await runFastlaneResign(ctx, {
+        credentials: nullthrows(credentials),
+        ipaPath: applicationArchivePath,
+      });
+    });
+  } finally {
+    await ctx.runBuildPhase(BuildPhase.CLEAN_UP_CREDENTIALS, async () => {
+      await credentialsManager.cleanUp();
+    });
+  }
+
+  await ctx.runBuildPhase(BuildPhase.UPLOAD_APPLICATION_ARCHIVE, async () => {
+    ctx.logger.info(`Application archive: ${applicationArchivePath}`);
+    await ctx.uploadArtifact({
+      artifact: {
+        type: ManagedArtifactType.APPLICATION_ARCHIVE,
+        paths: [applicationArchivePath],
+      },
+      logger: ctx.logger,
+    });
+  });
+
+  return ctx.artifacts;
+}
+
+async function runInstallPodsAsync(ctx: BuildContext<Ios.Job>): Promise<void> {
+  let warnTimeout: NodeJS.Timeout | undefined;
+  let killTimeout: NodeJS.Timeout | undefined;
+  let timedOutToKill: boolean = false;
+  try {
+    const installPodsSpawnPromise = (
+      await installPods(ctx, {
+        infoCallbackFn: () => {
+          warnTimeout?.refresh();
+          killTimeout?.refresh();
+        },
+      })
+    ).spawnPromise;
+    warnTimeout = setTimeout(() => {
+      ctx.logger.warn(
+        '"Install pods" phase takes longer then expected and it did not produce any logs in the past 15 minutes'
+      );
+    }, INSTALL_PODS_WARN_TIMEOUT_MS);
+
+    killTimeout = setTimeout(async () => {
+      timedOutToKill = true;
+      ctx.logger.error(
+        '"Install pods" phase takes a very long time and it did not produce any logs in the past 30 minutes. Most likely an unexpected error happened which caused the process to hang and it will be terminated'
+      );
+      const ppid = nullthrows(installPodsSpawnPromise.child.pid);
+      const pids = await getParentAndDescendantProcessPidsAsync(ppid);
+      pids.forEach(pid => {
+        process.kill(pid);
+      });
+      ctx.reportError?.('"Install pods" phase takes a very long time', undefined, {
+        extras: { buildId: ctx.env.EAS_BUILD_ID },
+      });
+    }, INSTALL_PODS_KILL_TIMEOUT_MS);
+
+    await installPodsSpawnPromise;
+  } catch (err: any) {
+    if (timedOutToKill) {
+      throw new InstallPodsTimeoutError('"Install pods" phase was inactive for over 30 minutes');
+    }
+    throw err;
+  } finally {
+    if (warnTimeout) {
+      clearTimeout(warnTimeout);
+    }
+    if (killTimeout) {
+      clearTimeout(killTimeout);
+    }
+  }
+}

packages/build-tools/src/common/__tests__/projectSources.test.ts

@@ -0,0 +1,575 @@
+import {
+  ArchiveSourceType,
+  BuildMode,
+  BuildTrigger,
+  Job,
+  Platform,
+  Workflow,
+} from '@expo/eas-build-job';
+import { randomBytes, randomUUID } from 'crypto';
+import { vol } from 'memfs';
+import fetch, { Response } from 'node-fetch';
+import { setTimeout } from 'timers/promises';
+
+import { createMockLogger } from '../../__tests__/utils/logger';
+import { BuildContext } from '../../context';
+import { shallowCloneRepositoryAsync } from '../git';
+import { prepareProjectSourcesAsync } from '../projectSources';
+
+jest.mock('@expo/turtle-spawn');
+jest.mock('node-fetch');
+jest.mock('../git');
+jest.mock('@expo/downloader');
+jest.mock('@urql/core');
+
+describe('projectSources', () => {
+  it('should use the refreshed repository URL', async () => {
+    const robotAccessToken = randomUUID();
+    const buildId = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+
+    const gitCommitHash = randomBytes(20).toString('hex');
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash,
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_ID: buildId,
+          EAS_BUILD_RUNNER: 'eas-build',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+    const fetchMock = jest.mocked(fetch);
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: true,
+          json: async () => ({
+            data: {
+              gitRef: 'refs/heads/main',
+              gitCommitHash,
+              repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+              type: ArchiveSourceType.GIT,
+            },
+          }),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+  });
+
+  it('should fallback to the original repository URL if the refresh fails', async () => {
+    const robotAccessToken = randomUUID();
+    const buildId = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash: randomBytes(20).toString('hex'),
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_ID: buildId,
+          EAS_BUILD_RUNNER: 'eas-build',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+    const fetchMock = jest.mocked(fetch);
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: false,
+          text: async () => 'Failed to generate repository URL',
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: false,
+          json: async () => ({
+            // repositoryUrl is the right key
+            repository_url: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          }),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+
+    fetchMock.mockImplementation(
+      async () =>
+        ({
+          ok: false,
+          json: () => Promise.reject(new Error('Failed to generate repository URL')),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+
+    expect(shallowCloneRepositoryAsync).toHaveBeenCalledTimes(3);
+  }, 15_000);
+
+  it('should retry fetching the repository URL', async () => {
+    const robotAccessToken = randomUUID();
+    const buildId = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+
+    const gitCommitHash = randomBytes(20).toString('hex');
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash,
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_ID: buildId,
+          EAS_BUILD_RUNNER: 'eas-build',
+        },
+        workingdir: '/workingdir',
+        logger: createMockLogger(),
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+    const fetchMock = jest.mocked(fetch);
+    fetchMock.mockImplementationOnce(
+      async () =>
+        ({
+          ok: false,
+          text: async () => 'Failed to generate repository URL',
+        }) as Response
+    );
+    fetchMock.mockImplementationOnce(
+      async () =>
+        ({
+          ok: true,
+          json: async () => ({
+            data: {
+              repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+              gitRef: 'refs/heads/main',
+              gitCommitHash,
+              type: ArchiveSourceType.GIT,
+            },
+          }),
+        }) as Response
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+    expect(shallowCloneRepositoryAsync).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        archiveSource: {
+          ...ctx.job.projectArchive,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+        },
+      })
+    );
+  }, 15_000);
+
+  it(`should fallback to the original repository URL if we're missing some config`, async () => {
+    const robotAccessToken = randomUUID();
+    await vol.promises.mkdir('/workingdir/environment-secrets/', { recursive: true });
+    const logger = createMockLogger();
+
+    const ctx = new BuildContext(
+      {
+        triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+        type: Workflow.MANAGED,
+        mode: BuildMode.BUILD,
+        initiatingUserId: randomUUID(),
+        appId: randomUUID(),
+        projectArchive: {
+          type: ArchiveSourceType.GIT,
+          repositoryUrl: 'https://x-access-token:[email protected]/expo/eas-cli.git',
+          gitRef: 'refs/heads/main',
+          gitCommitHash: randomBytes(20).toString('hex'),
+        },
+        platform: Platform.IOS,
+        secrets: {
+          robotAccessToken,
+          environmentSecrets: [],
+        },
+      } as Job,
+      {
+        env: {
+          __API_SERVER_URL: 'https://api.expo.dev',
+          EXPO_TOKEN: robotAccessToken,
+          EAS_BUILD_RUNNER: 'eas-build',
+          // EAS_BUILD_ID: buildId,
+        },
+        workingdir: '/workingdir',
+        logger,
+        logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+        uploadArtifact: jest.fn(),
+      }
+    );
+
+    await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+
+    expect(logger.error).toHaveBeenCalledWith(
+      { err: expect.any(Error) },
+      'Failed to refresh project archive, falling back to the original one'
+    );
+  });
+
+  describe('uploadProjectMetadataAsFireAndForget', () => {
+    beforeEach(() => {
+      jest.clearAllMocks();
+    });
+
+    it('should upload project metadata for build job with URL archive type', async () => {
+      const robotAccessToken = randomUUID();
+      const buildId = randomUUID();
+      const bucketKey = `test-bucket-key-${randomUUID()}`;
+      await vol.promises.mkdir('/workingdir/build', { recursive: true });
+      await vol.promises.writeFile('/workingdir/build/package.json', '{}');
+      await vol.promises.writeFile('/workingdir/build/README.md', 'Hello, world!');
+
+      const mockGraphqlMutation = jest.fn();
+      mockGraphqlMutation
+        .mockReturnValueOnce({
+          toPromise: () =>
+            Promise.resolve({
+              data: {
+                uploadSession: {
+                  createUploadSession: {
+                    url: 'https://storage.example.com/upload',
+                    bucketKey,
+                    headers: { 'x-custom-header': 'value' },
+                  },
+                },
+              },
+            }),
+        })
+        .mockReturnValueOnce({
+          toPromise: () =>
+            Promise.resolve({
+              data: {
+                build: {
+                  updateBuildMetadata: {
+                    id: buildId,
+                  },
+                },
+              },
+            }),
+        });
+
+      const ctx = new BuildContext(
+        {
+          triggeredBy: BuildTrigger.EAS_CLI,
+          type: Workflow.MANAGED,
+          mode: BuildMode.BUILD,
+          initiatingUserId: randomUUID(),
+          appId: randomUUID(),
+          projectArchive: {
+            type: ArchiveSourceType.URL,
+            url: 'https://example.com/project.tar.gz',
+          },
+          platform: Platform.IOS,
+          secrets: {
+            robotAccessToken,
+            environmentSecrets: [],
+          },
+        } as Job,
+        {
+          env: {
+            __API_SERVER_URL: 'https://api.expo.dev',
+            EXPO_TOKEN: robotAccessToken,
+            EAS_BUILD_ID: buildId,
+            EAS_BUILD_RUNNER: 'eas-build',
+          },
+          workingdir: '/workingdir',
+          logger: createMockLogger(),
+          logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+          uploadArtifact: jest.fn(),
+        }
+      );
+
+      ctx.graphqlClient.mutation = mockGraphqlMutation as any;
+
+      const fetchMock = jest.mocked(fetch);
+      fetchMock.mockImplementation(async () => ({ ok: true }) as Response);
+
+      // Call prepareProjectSourcesAsync and don't await metadata upload
+      await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+
+      // Wait for the fire-and-forget async operation to complete
+      await setTimeout(1000);
+
+      // Verify the upload session was created
+      expect(mockGraphqlMutation).toHaveBeenNthCalledWith(
+        1,
+        expect.anything(),
+        expect.objectContaining({})
+      );
+
+      // Verify metadata was uploaded to storage
+      expect(fetchMock).toHaveBeenCalledWith(
+        'https://storage.example.com/upload',
+        expect.objectContaining({
+          method: 'PUT',
+          headers: { 'x-custom-header': 'value' },
+          body: '{"archiveContent":["project/README.md","project/package.json"]}',
+        })
+      );
+
+      // Verify build metadata was updated
+      expect(mockGraphqlMutation).toHaveBeenNthCalledWith(
+        2,
+        expect.anything(),
+        expect.objectContaining({
+          buildId,
+          projectMetadataFile: {
+            type: 'GCS',
+            bucketKey,
+          },
+        })
+      );
+    });
+
+    it('should not await the metadata upload (fire-and-forget)', async () => {
+      const robotAccessToken = randomUUID();
+      const buildId = randomUUID();
+      await vol.promises.mkdir('/workingdir/build', { recursive: true });
+      await vol.promises.writeFile('/workingdir/build/app.json', '{}');
+
+      let uploadCompleted = false;
+      const mockGraphqlMutation = jest.fn();
+      mockGraphqlMutation
+        .mockReturnValueOnce({
+          toPromise: async () => {
+            // Simulate a slow upload
+            await setTimeout(100);
+            uploadCompleted = true;
+            return {
+              data: {
+                uploadSession: {
+                  createUploadSession: {
+                    url: 'https://storage.example.com/upload',
+                    bucketKey: 'test-key',
+                    headers: {},
+                  },
+                },
+              },
+            };
+          },
+        })
+        .mockReturnValueOnce({
+          toPromise: () =>
+            Promise.resolve({
+              data: {
+                build: {
+                  updateBuildMetadata: {
+                    id: buildId,
+                  },
+                },
+              },
+            }),
+        });
+
+      const ctx = new BuildContext(
+        {
+          triggeredBy: BuildTrigger.EAS_CLI,
+          type: Workflow.MANAGED,
+          mode: BuildMode.BUILD,
+          initiatingUserId: randomUUID(),
+          appId: randomUUID(),
+          projectArchive: {
+            type: ArchiveSourceType.URL,
+            url: 'https://example.com/project.tar.gz',
+          },
+          platform: Platform.IOS,
+          secrets: {
+            robotAccessToken,
+            environmentSecrets: [],
+          },
+        } as Job,
+        {
+          env: {
+            __API_SERVER_URL: 'https://api.expo.dev',
+            EXPO_TOKEN: robotAccessToken,
+            EAS_BUILD_ID: buildId,
+            EAS_BUILD_RUNNER: 'eas-build',
+          },
+          workingdir: '/workingdir',
+          logger: createMockLogger(),
+          logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+          uploadArtifact: jest.fn(),
+        }
+      );
+
+      ctx.graphqlClient.mutation = mockGraphqlMutation as any;
+
+      const fetchMock = jest.mocked(fetch);
+      fetchMock.mockResolvedValue({ ok: true } as Response);
+
+      const startTime = Date.now();
+      await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+      const endTime = Date.now();
+
+      // prepareProjectSourcesAsync should complete quickly without waiting for upload
+      expect(endTime - startTime).toBeLessThan(50);
+      // Upload should not be completed yet
+      expect(uploadCompleted).toBe(false);
+
+      // Wait for the fire-and-forget operation to complete
+      await setTimeout(150);
+
+      // Now the upload should be completed
+      expect(uploadCompleted).toBe(true);
+    });
+
+    it('should handle upload errors gracefully without failing the build', async () => {
+      const robotAccessToken = randomUUID();
+      const buildId = randomUUID();
+      await vol.promises.mkdir('/workingdir/build', { recursive: true });
+      await vol.promises.writeFile('/workingdir/build/index.js', 'console.log("test");');
+
+      const mockGraphqlMutation = jest.fn();
+      mockGraphqlMutation.mockReturnValue({
+        toPromise: () => Promise.reject(new Error('Upload failed')),
+      });
+
+      const logger = createMockLogger();
+      const ctx = new BuildContext(
+        {
+          triggeredBy: BuildTrigger.GIT_BASED_INTEGRATION,
+          type: Workflow.MANAGED,
+          mode: BuildMode.BUILD,
+          initiatingUserId: randomUUID(),
+          appId: randomUUID(),
+          projectArchive: {
+            type: ArchiveSourceType.URL,
+            url: 'https://example.com/project.tar.gz',
+          },
+          platform: Platform.IOS,
+          secrets: {
+            robotAccessToken,
+            environmentSecrets: [],
+          },
+        } as Job,
+        {
+          env: {
+            __API_SERVER_URL: 'https://api.expo.dev',
+            EXPO_TOKEN: robotAccessToken,
+            EAS_BUILD_ID: buildId,
+            EAS_BUILD_RUNNER: 'eas-build',
+          },
+          workingdir: '/workingdir',
+          logger,
+          logBuffer: { getLogs: () => [], getPhaseLogs: () => [] },
+          uploadArtifact: jest.fn(),
+        }
+      );
+
+      ctx.graphqlClient.mutation = mockGraphqlMutation as any;
+
+      const fetchMock = jest.mocked(fetch);
+      fetchMock.mockResolvedValue({ ok: true } as Response);
+
+      // Should not throw even though upload will fail
+      await expect(prepareProjectSourcesAsync(ctx, ctx.buildDirectory)).resolves.not.toThrow();
+
+      // Wait for the fire-and-forget operation to complete
+      await setTimeout(100);
+
+      // Verify that a warning was logged
+      expect(logger.warn).toHaveBeenCalledWith(
+        expect.stringContaining('Failed to upload project metadata')
+      );
+    });
+  });
+});

packages/build-tools/src/common/eagerBundle.ts

@@ -0,0 +1,38 @@
+import { Metadata, Platform } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import semver from 'semver';
+
+import { PackageManager } from '../utils/packageManager';
+import { runExpoCliCommand } from '../utils/project';
+
+export async function eagerBundleAsync({
+  platform,
+  workingDir,
+  logger,
+  env,
+  packageManager,
+}: {
+  platform: Platform;
+  workingDir: string;
+  logger: bunyan;
+  env: Record<string, string | undefined>;
+  packageManager: PackageManager;
+}): Promise<void> {
+  await runExpoCliCommand({
+    args: ['export:embed', '--eager', '--platform', platform, '--dev', 'false'],
+    options: {
+      cwd: workingDir,
+      logger,
+      env,
+    },
+    packageManager,
+  });
+}
+
+export function shouldUseEagerBundle(metadata: Metadata | null | undefined): boolean {
+  return Boolean(
+    !metadata?.developmentClient &&
+    metadata?.sdkVersion &&
+    semver.satisfies(metadata?.sdkVersion, '>=52')
+  );
+}

packages/build-tools/src/common/easBuildInternal.ts

@@ -0,0 +1,189 @@
+import {
+  BuildJob,
+  EasCliNpmTags,
+  Env,
+  Metadata,
+  sanitizeBuildJob,
+  sanitizeMetadata,
+} from '@expo/eas-build-job';
+import { PipeMode, bunyan } from '@expo/logger';
+import { BuildStepEnv } from '@expo/steps';
+import spawn from '@expo/turtle-spawn';
+import assert from 'assert';
+import Joi from 'joi';
+import nullthrows from 'nullthrows';
+
+import { BuildContext } from '../context';
+import { isAtLeastNpm7Async } from '../utils/packageManager';
+
+const EasBuildInternalResultSchema = Joi.object<{ job: object; metadata: object }>({
+  job: Joi.object().unknown(),
+  metadata: Joi.object().unknown(),
+});
+
+export async function runEasBuildInternalAsync<TJob extends BuildJob>({
+  job,
+  logger,
+  env,
+  cwd,
+  projectRootOverride,
+}: {
+  job: TJob;
+  logger: bunyan;
+  env: BuildStepEnv;
+  cwd: string;
+  projectRootOverride?: string;
+}): Promise<{
+  newJob: TJob;
+  newMetadata: Metadata;
+}> {
+  const { cmd, args, extraEnv } = await resolveEasCommandPrefixAndEnvAsync();
+  const { buildProfile, githubTriggerOptions } = job;
+  assert(buildProfile, 'build profile is missing in a build from git-based integration.');
+
+  const autoSubmitArgs = [];
+  if (githubTriggerOptions?.submitProfile) {
+    autoSubmitArgs.push('--auto-submit-with-profile');
+    autoSubmitArgs.push(githubTriggerOptions.submitProfile);
+  } else if (githubTriggerOptions?.autoSubmit) {
+    autoSubmitArgs.push('--auto-submit');
+  }
+
+  const result = await spawn(
+    cmd,
+    [
+      ...args,
+      'build:internal',
+      '--platform',
+      job.platform,
+      '--profile',
+      buildProfile,
+      ...autoSubmitArgs,
+    ],
+    {
+      cwd,
+      env: {
+        ...env,
+        EXPO_TOKEN: nullthrows(job.secrets, 'Secrets must be defined for non-custom builds')
+          .robotAccessToken,
+        ...extraEnv,
+        EAS_PROJECT_ROOT: projectRootOverride,
+      },
+      logger,
+      // This prevents printing stdout with job secrets and credentials to logs.
+      mode: PipeMode.STDERR_ONLY_AS_STDOUT,
+    }
+  );
+
+  const stdout = result.stdout.toString();
+  const parsed = JSON.parse(stdout);
+  return validateEasBuildInternalResult({
+    result: parsed,
+    oldJob: job,
+  });
+}
+
+export async function resolveEnvFromBuildProfileAsync<TJob extends BuildJob>(
+  ctx: BuildContext<TJob>,
+  { cwd }: { cwd: string }
+): Promise<Env> {
+  const { cmd, args, extraEnv } = await resolveEasCommandPrefixAndEnvAsync();
+  const { buildProfile } = ctx.job;
+  assert(buildProfile, 'build profile is missing in a build from git-based integration.');
+  let spawnResult;
+  try {
+    spawnResult = await spawn(
+      cmd,
+      [
+        ...args,
+        'config',
+        '--platform',
+        ctx.job.platform,
+        '--profile',
+        buildProfile,
+        '--non-interactive',
+        '--json',
+        '--eas-json-only',
+      ],
+      {
+        cwd,
+        env: { ...ctx.env, ...extraEnv },
+      }
+    );
+  } catch (err: any) {
+    ctx.logger.error(`Failed to the read build profile ${buildProfile} from eas.json.`);
+    ctx.logger.error(err.stderr?.toString());
+    throw Error(`Failed to read the build profile ${buildProfile} from eas.json.`);
+  }
+  const stdout = spawnResult.stdout.toString();
+  const parsed = JSON.parse(stdout);
+  const env = validateEnvs(parsed.buildProfile);
+  return env;
+}
+
+async function resolveEasCommandPrefixAndEnvAsync(): Promise<{
+  cmd: string;
+  args: string[];
+  extraEnv: Env;
+}> {
+  const npxArgsPrefix = (await isAtLeastNpm7Async()) ? ['-y'] : [];
+  if (process.env.ENVIRONMENT === 'development') {
+    return {
+      cmd: 'npx',
+      args: [...npxArgsPrefix, `eas-cli@${EasCliNpmTags.STAGING}`],
+      extraEnv: {},
+    };
+  } else if (process.env.ENVIRONMENT === 'staging') {
+    return {
+      cmd: 'npx',
+      args: [...npxArgsPrefix, `eas-cli@${EasCliNpmTags.STAGING}`],
+      extraEnv: { EXPO_STAGING: '1' },
+    };
+  } else {
+    return {
+      cmd: 'npx',
+      args: [...npxArgsPrefix, `eas-cli@${EasCliNpmTags.PRODUCTION}`],
+      extraEnv: {},
+    };
+  }
+}
+
+function validateEasBuildInternalResult<TJob extends BuildJob>({
+  oldJob,
+  result,
+}: {
+  oldJob: TJob;
+  result: any;
+}): { newJob: TJob; newMetadata: Metadata } {
+  const { value, error } = EasBuildInternalResultSchema.validate(result, {
+    stripUnknown: true,
+    convert: true,
+    abortEarly: false,
+  });
+  if (error) {
+    throw error;
+  }
+  const newJob = sanitizeBuildJob({
+    ...value.job,
+    // We want to retain values that we have set on the job.
+    appId: oldJob.appId,
+    initiatingUserId: oldJob.initiatingUserId,
+  }) as TJob;
+  assert(newJob.platform === oldJob.platform, 'eas-cli returned a job for a wrong platform');
+  const newMetadata = sanitizeMetadata(value.metadata);
+  return { newJob, newMetadata };
+}
+
+function validateEnvs(result: any): Env {
+  const { value, error } = Joi.object({
+    env: Joi.object().pattern(Joi.string(), Joi.string()),
+  }).validate(result, {
+    stripUnknown: true,
+    convert: true,
+    abortEarly: false,
+  });
+  if (error) {
+    throw error;
+  }
+  return value?.env;
+}

packages/build-tools/src/common/fastlane.ts

@@ -0,0 +1,7 @@
+export const COMMON_FASTLANE_ENV = {
+  FASTLANE_DISABLE_COLORS: '1',
+  FASTLANE_SKIP_UPDATE_CHECK: '1',
+  SKIP_SLOW_FASTLANE_WARNING: 'true',
+  FASTLANE_HIDE_TIMESTAMP: 'true',
+  LC_ALL: 'en_US.UTF-8',
+};

packages/build-tools/src/common/git.ts

@@ -0,0 +1,98 @@
+import { ArchiveSource, ArchiveSourceType } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import spawn from '@expo/turtle-spawn';
+
+export async function shallowCloneRepositoryAsync({
+  logger,
+  archiveSource,
+  destinationDirectory,
+}: {
+  logger: bunyan;
+  archiveSource: ArchiveSource & { type: ArchiveSourceType.GIT };
+  destinationDirectory: string;
+}): Promise<void> {
+  const { repositoryUrl } = archiveSource;
+  try {
+    await spawn('git', ['init'], { cwd: destinationDirectory });
+    await spawn('git', ['remote', 'add', 'origin', repositoryUrl], { cwd: destinationDirectory });
+
+    const { gitRef, gitCommitHash } = archiveSource;
+
+    await spawn('git', ['fetch', 'origin', '--depth', '1', '--no-tags', gitCommitHash], {
+      cwd: destinationDirectory,
+    });
+
+    await spawn('git', ['checkout', gitCommitHash], { cwd: destinationDirectory });
+
+    // If we have a gitRef, we try to add it to the repo.
+    if (gitRef) {
+      const { name, type } = getStrippedBranchOrTagName(gitRef);
+      switch (type) {
+        // If the gitRef is for a tag, we add a lightweight tag to current commit.
+        case 'tag': {
+          await spawn('git', ['tag', name], { cwd: destinationDirectory });
+          break;
+        }
+        // gitRef for a branch may come as:
+        // - qualified ref (e.g. refs/heads/feature/add-icon), detected as "branch" for a push,
+        // - unqualified ref (e.g. feature/add-icon), detected as "other" for a pull request.
+        case 'branch':
+        case 'other': {
+          await spawn('git', ['checkout', '-b', name], { cwd: destinationDirectory });
+          break;
+        }
+      }
+    }
+  } catch (err: any) {
+    const sanitizedUrl = getSanitizedGitUrl(repositoryUrl);
+    if (sanitizedUrl) {
+      logger.error(`Failed to clone git repository: ${sanitizedUrl}.`);
+    } else {
+      logger.error('Failed to clone git repository.');
+    }
+    logger.error(err.stderr);
+    throw err;
+  }
+}
+
+function getSanitizedGitUrl(maybeGitUrl: string): string | null {
+  try {
+    const url = new URL(maybeGitUrl);
+    if (url.password) {
+      url.password = '*******';
+    }
+    return url.toString();
+  } catch {
+    return null;
+  }
+}
+
+function getStrippedBranchOrTagName(ref: string): {
+  name: string;
+  type: 'branch' | 'tag' | 'other';
+} {
+  const branchRegex = /(\/?refs)?\/?heads\/(.+)/;
+  const branchMatch = ref.match(branchRegex);
+
+  if (branchMatch) {
+    return {
+      name: branchMatch[2],
+      type: 'branch',
+    };
+  }
+
+  const tagRegex = /(\/?refs)?\/?tags\/(.+)/;
+  const tagMatch = ref.match(tagRegex);
+
+  if (tagMatch) {
+    return {
+      name: tagMatch[2],
+      type: 'tag',
+    };
+  }
+
+  return {
+    name: ref,
+    type: 'other',
+  };
+}

packages/build-tools/src/common/installDependencies.ts

@@ -0,0 +1,83 @@
+import { Job } from '@expo/eas-build-job';
+import spawn, { SpawnOptions, SpawnPromise, SpawnResult } from '@expo/turtle-spawn';
+import path from 'path';
+
+import { BuildContext } from '../context';
+import { PackageManager, findPackagerRootDir } from '../utils/packageManager';
+import { isUsingModernYarnVersion } from '../utils/project';
+
+export async function installDependenciesAsync({
+  packageManager,
+  env,
+  logger,
+  infoCallbackFn,
+  cwd,
+  useFrozenLockfile,
+}: {
+  packageManager: PackageManager;
+  env: Record<string, string | undefined>;
+  cwd: string;
+  logger: Exclude<SpawnOptions['logger'], undefined>;
+  infoCallbackFn?: SpawnOptions['infoCallbackFn'];
+  useFrozenLockfile: boolean;
+}): Promise<{ spawnPromise: SpawnPromise<SpawnResult> }> {
+  let args: string[];
+  switch (packageManager) {
+    case PackageManager.NPM: {
+      args = useFrozenLockfile ? ['ci', '--include=dev'] : ['install'];
+      break;
+    }
+    case PackageManager.PNPM: {
+      args = ['install', useFrozenLockfile ? '--frozen-lockfile' : '--no-frozen-lockfile'];
+      break;
+    }
+    case PackageManager.YARN: {
+      const isModernYarnVersion = await isUsingModernYarnVersion(cwd);
+      if (isModernYarnVersion) {
+        if (env['EAS_YARN_FOCUS_WORKSPACE']) {
+          args = ['workspaces', 'focus', env['EAS_YARN_FOCUS_WORKSPACE']];
+        } else {
+          args = [
+            'install',
+            '--inline-builds',
+            useFrozenLockfile ? '--immutable' : '--no-immutable',
+          ];
+        }
+      } else {
+        args = ['install', ...(useFrozenLockfile ? ['--frozen-lockfile'] : [])];
+      }
+      break;
+    }
+    case PackageManager.BUN:
+      args = ['install', ...(useFrozenLockfile ? ['--frozen-lockfile'] : [])];
+      break;
+    default:
+      throw new Error(`Unsupported package manager: ${packageManager}`);
+  }
+  if (env['EAS_VERBOSE'] === '1') {
+    args = [...args, '--verbose'];
+  }
+  logger.info(`Running "${packageManager} ${args.join(' ')}" in ${cwd} directory`);
+  return {
+    spawnPromise: spawn(packageManager, args, {
+      cwd,
+      logger,
+      infoCallbackFn,
+      env,
+    }),
+  };
+}
+
+export function resolvePackagerDir(ctx: BuildContext<Job>): string {
+  const packagerRunDir = findPackagerRootDir(ctx.getReactNativeProjectDirectory());
+  if (packagerRunDir !== ctx.getReactNativeProjectDirectory()) {
+    const relativeReactNativeProjectDirectory = path.relative(
+      ctx.buildDirectory,
+      ctx.getReactNativeProjectDirectory()
+    );
+    ctx.logger.info(
+      `We detected that '${relativeReactNativeProjectDirectory}' is a ${ctx.packageManager} workspace`
+    );
+  }
+  return packagerRunDir;
+}

packages/build-tools/src/common/prebuild.ts

@@ -0,0 +1,66 @@
+import { BuildJob } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import { SpawnOptions } from '@expo/turtle-spawn';
+
+import { installDependenciesAsync, resolvePackagerDir } from './installDependencies';
+import { BuildContext } from '../context';
+import { runExpoCliCommand } from '../utils/project';
+
+export interface PrebuildOptions {
+  extraEnvs?: Record<string, string>;
+}
+
+export async function prebuildAsync<TJob extends BuildJob>(
+  ctx: BuildContext<TJob>,
+  { logger, workingDir, options }: { logger: bunyan; workingDir: string; options?: PrebuildOptions }
+): Promise<void> {
+  const spawnOptions: SpawnOptions = {
+    cwd: workingDir,
+    logger,
+    env: {
+      EXPO_IMAGE_UTILS_NO_SHARP: '1',
+      ...options?.extraEnvs,
+      ...ctx.env,
+    },
+  };
+
+  const prebuildCommandArgs = getPrebuildCommandArgs(ctx);
+  await runExpoCliCommand({
+    args: prebuildCommandArgs,
+    options: spawnOptions,
+    packageManager: ctx.packageManager,
+  });
+  const installDependenciesSpawnPromise = (
+    await installDependenciesAsync({
+      packageManager: ctx.packageManager,
+      env: ctx.env,
+      logger,
+      cwd: resolvePackagerDir(ctx),
+      // prebuild sometimes modifies package.json, so we don't want to use frozen lockfile
+      useFrozenLockfile: false,
+    })
+  ).spawnPromise;
+  await installDependenciesSpawnPromise;
+}
+
+function getPrebuildCommandArgs<TJob extends BuildJob>(ctx: BuildContext<TJob>): string[] {
+  let prebuildCommand =
+    ctx.job.experimental?.prebuildCommand ?? `prebuild --no-install --platform ${ctx.job.platform}`;
+  if (!prebuildCommand.match(/(?:--platform| -p)/)) {
+    prebuildCommand = `${prebuildCommand} --platform ${ctx.job.platform}`;
+  }
+  const npxCommandPrefix = 'npx ';
+  const expoCommandPrefix = 'expo ';
+  const expoCliCommandPrefix = 'expo-cli ';
+  if (prebuildCommand.startsWith(npxCommandPrefix)) {
+    prebuildCommand = prebuildCommand.substring(npxCommandPrefix.length).trim();
+  }
+  if (prebuildCommand.startsWith(expoCommandPrefix)) {
+    prebuildCommand = prebuildCommand.substring(expoCommandPrefix.length).trim();
+  }
+  if (prebuildCommand.startsWith(expoCliCommandPrefix)) {
+    prebuildCommand = prebuildCommand.substring(expoCliCommandPrefix.length).trim();
+  }
+
+  return prebuildCommand.split(' ');
+}

packages/build-tools/src/common/projectSources.ts

@@ -0,0 +1,296 @@
+import downloadFile from '@expo/downloader';
+import { ArchiveSource, ArchiveSourceSchemaZ, ArchiveSourceType, Job } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import { asyncResult } from '@expo/results';
+import spawn from '@expo/turtle-spawn';
+import fs from 'fs/promises';
+import { graphql } from 'gql.tada';
+import fetch from 'node-fetch';
+import nullthrows from 'nullthrows';
+import path from 'path';
+import { z } from 'zod';
+
+import { shallowCloneRepositoryAsync } from './git';
+import { BuildContext } from '../context';
+import { turtleFetch } from '../utils/turtleFetch';
+
+export async function prepareProjectSourcesAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  destinationDirectory: string
+): // Return type required to make switch exhaustive.
+Promise<{ handled: boolean }> {
+  let projectArchive: ArchiveSource = ctx.job.projectArchive;
+  if (ctx.isLocal) {
+    console.warn('Local build, skipping project archive refresh');
+  } else {
+    const projectArchiveResult = await asyncResult(fetchProjectArchiveSourceAsync(ctx));
+
+    if (!projectArchiveResult.ok) {
+      ctx.logger.error(
+        { err: projectArchiveResult.reason },
+        'Failed to refresh project archive, falling back to the original one'
+      );
+    }
+
+    projectArchive = projectArchiveResult.value ?? ctx.job.projectArchive;
+  }
+
+  switch (projectArchive.type) {
+    case ArchiveSourceType.R2:
+    case ArchiveSourceType.GCS: {
+      throw new Error('Remote project sources should be resolved earlier to URL');
+    }
+
+    case ArchiveSourceType.PATH: {
+      await prepareProjectSourcesLocallyAsync(ctx, projectArchive.path, destinationDirectory); // used in eas build --local
+      return { handled: true };
+    }
+
+    case ArchiveSourceType.NONE: {
+      // May be used in no-sources jobs like submission jobs.
+      return { handled: true };
+    }
+
+    case ArchiveSourceType.URL: {
+      await downloadAndUnpackProjectFromTarGzAsync(ctx, projectArchive.url, destinationDirectory);
+
+      uploadProjectMetadataAsFireAndForget(ctx, { projectDirectory: destinationDirectory });
+
+      return { handled: true };
+    }
+
+    case ArchiveSourceType.GIT: {
+      await shallowCloneRepositoryAsync({
+        logger: ctx.logger,
+        archiveSource: projectArchive,
+        destinationDirectory,
+      });
+
+      uploadProjectMetadataAsFireAndForget(ctx, { projectDirectory: destinationDirectory });
+
+      return { handled: true };
+    }
+  }
+}
+
+export async function downloadAndUnpackProjectFromTarGzAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  projectArchiveUrl: string,
+  destinationDirectory: string
+): Promise<void> {
+  const projectTarball = path.join(ctx.workingdir, 'project.tar.gz');
+  try {
+    await downloadFile(projectArchiveUrl, projectTarball, { retry: 3 });
+  } catch (err: any) {
+    ctx.reportError?.('Failed to download project archive', err, {
+      extras: { buildId: ctx.env.EAS_BUILD_ID },
+    });
+    throw err;
+  }
+
+  await unpackTarGzAsync({
+    destination: destinationDirectory,
+    source: projectTarball,
+    logger: ctx.logger,
+  });
+}
+
+async function prepareProjectSourcesLocallyAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  projectArchivePath: string,
+  destinationDirectory: string
+): Promise<void> {
+  const projectTarball = path.join(ctx.workingdir, 'project.tar.gz');
+  await fs.copyFile(projectArchivePath, projectTarball);
+
+  await unpackTarGzAsync({
+    destination: destinationDirectory,
+    source: projectTarball,
+    logger: ctx.logger,
+  });
+}
+
+async function unpackTarGzAsync({
+  logger,
+  source,
+  destination,
+}: {
+  logger: bunyan;
+  source: string;
+  destination: string;
+}): Promise<void> {
+  await spawn('tar', ['-C', destination, '--strip-components', '1', '-zxf', source], {
+    logger,
+  });
+}
+
+function uploadProjectMetadataAsFireAndForget(
+  ctx: BuildContext<Job>,
+  { projectDirectory }: { projectDirectory: string }
+): void {
+  void (async () => {
+    const uploadResult = await asyncResult(uploadProjectMetadataAsync(ctx, { projectDirectory }));
+    if (!uploadResult.ok) {
+      ctx.logger.warn(`Failed to upload project metadata: ${uploadResult.reason}`);
+    }
+  })();
+}
+
+async function uploadProjectMetadataAsync(
+  ctx: BuildContext<Job>,
+  { projectDirectory }: { projectDirectory: string }
+): Promise<void> {
+  if (!ctx.job.platform) {
+    // Not a build job, skip.
+    return;
+  } else if (
+    ctx.job.projectArchive.type === ArchiveSourceType.GCS &&
+    ctx.job.projectArchive.metadataLocation
+  ) {
+    // Build already has project metadata, skip.
+    return;
+  }
+
+  const files: string[] = [];
+
+  const directoriesToScan: { dir: string; relativePath: string }[] = [
+    { dir: projectDirectory, relativePath: '' },
+  ];
+
+  while (directoriesToScan.length > 0) {
+    const { dir, relativePath } = directoriesToScan.shift()!;
+
+    if (relativePath === '.git') {
+      // Do not include whole `.git` directory in the archive, just that it exists.
+      files.push('.git/...');
+      continue;
+    }
+
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      const relativeFilePath = path.join(relativePath, entry.name);
+
+      if (entry.isDirectory()) {
+        directoriesToScan.push({ dir: fullPath, relativePath: relativeFilePath });
+      } else {
+        files.push(relativeFilePath);
+      }
+    }
+  }
+  const sortedFiles = files
+    .map(
+      // Prepend entries with "project/"
+      f => path.join('project', f)
+    )
+    .sort(); // Sort for consistent ordering
+
+  const result = await ctx.graphqlClient
+    .mutation(
+      graphql(`
+        mutation {
+          uploadSession {
+            createUploadSession(type: EAS_BUILD_GCS_PROJECT_METADATA)
+          }
+        }
+      `),
+      {}
+    )
+    .toPromise();
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  const uploadSession = result.data!.uploadSession.createUploadSession as {
+    url: string;
+    bucketKey: string;
+    headers: Record<string, string>;
+  };
+
+  await fetch(uploadSession.url, {
+    method: 'PUT',
+    body: JSON.stringify({ archiveContent: sortedFiles }),
+    headers: uploadSession.headers,
+  });
+
+  const updateMetadataResult = await ctx.graphqlClient
+    .mutation(
+      graphql(`
+        mutation UpdateTurtleBuildMetadataMutation(
+          $buildId: ID!
+          $projectMetadataFile: ProjectMetadataFileInput!
+        ) {
+          build {
+            updateBuildMetadata(
+              buildId: $buildId
+              metadata: { projectMetadataFile: $projectMetadataFile }
+            ) {
+              id
+            }
+          }
+        }
+      `),
+      {
+        buildId: ctx.env.EAS_BUILD_ID,
+        projectMetadataFile: {
+          type: 'GCS',
+          bucketKey: uploadSession.bucketKey,
+        },
+      }
+    )
+    .toPromise();
+
+  if (updateMetadataResult.error) {
+    throw updateMetadataResult.error;
+  }
+}
+
+async function fetchProjectArchiveSourceAsync(ctx: BuildContext<Job>): Promise<ArchiveSource> {
+  const taskId = nullthrows(ctx.env.EAS_BUILD_ID, 'EAS_BUILD_ID is not set');
+  const expoApiServerURL = nullthrows(ctx.env.__API_SERVER_URL, '__API_SERVER_URL is not set');
+  const robotAccessToken = nullthrows(
+    ctx.job.secrets?.robotAccessToken,
+    'robot access token is not set'
+  );
+
+  const response = await turtleFetch(
+    new URL(
+      ctx.job.platform
+        ? `/v2/turtle-builds/${taskId}/download-project-archive`
+        : `/v2/turtle-job-runs/${taskId}/download-project-archive`,
+      expoApiServerURL
+    ).toString(),
+    'POST',
+    {
+      headers: {
+        Authorization: `Bearer ${robotAccessToken}`,
+      },
+      timeout: 20000,
+      retries: 3,
+      logger: ctx.logger,
+    }
+  );
+
+  if (!response.ok) {
+    const textResult = await asyncResult(response.text());
+    throw new Error(`Unexpected response from server (${response.status}): ${textResult.value}`);
+  }
+
+  const jsonResult = await asyncResult(response.json());
+  if (!jsonResult.ok) {
+    throw new Error(
+      `Expected JSON response from server (${response.status}): ${jsonResult.reason}`
+    );
+  }
+
+  const dataResult = z.object({ data: ArchiveSourceSchemaZ }).safeParse(jsonResult.value);
+  if (!dataResult.success) {
+    throw new Error(
+      `Unexpected data from server (${response.status}): ${z.prettifyError(dataResult.error)}`
+    );
+  }
+
+  return dataResult.data.data;
+}

packages/build-tools/src/common/setup.ts

@@ -0,0 +1,292 @@
+import { ExpoConfig } from '@expo/config';
+import { BuildJob, BuildPhase, Ios, Job, Platform } from '@expo/eas-build-job';
+import { BuildTrigger } from '@expo/eas-build-job/dist/common';
+import { UserFacingError } from '@expo/eas-build-job/dist/errors';
+import spawn, { SpawnResult } from '@expo/turtle-spawn';
+import fs from 'fs-extra';
+import nullthrows from 'nullthrows';
+import path from 'path';
+
+import { resolveEnvFromBuildProfileAsync, runEasBuildInternalAsync } from './easBuildInternal';
+import { installDependenciesAsync, resolvePackagerDir } from './installDependencies';
+import { prepareProjectSourcesAsync } from './projectSources';
+import { BuildContext } from '../context';
+import { deleteXcodeEnvLocalIfExistsAsync } from '../ios/xcodeEnv';
+import { Hook, runHookIfPresent } from '../utils/hooks';
+import { setUpNpmrcAsync } from '../utils/npmrc';
+import {
+  getPackageVersionFromPackageJson,
+  isAtLeastNpm7Async,
+  shouldUseFrozenLockfile,
+} from '../utils/packageManager';
+import { getParentAndDescendantProcessPidsAsync } from '../utils/processes';
+import { readEasJsonContents, readPackageJson } from '../utils/project';
+import { retryAsync } from '../utils/retry';
+
+const MAX_EXPO_DOCTOR_TIMEOUT_MS = 30 * 1000;
+const INSTALL_DEPENDENCIES_WARN_TIMEOUT_MS = 15 * 60 * 1000;
+const INSTALL_DEPENDENCIES_KILL_TIMEOUT_MS = 30 * 60 * 1000;
+
+class DoctorTimeoutError extends Error {}
+class InstallDependenciesTimeoutError extends Error {}
+
+export async function setupAsync<TJob extends BuildJob>(ctx: BuildContext<TJob>): Promise<void> {
+  await ctx.runBuildPhase(BuildPhase.PREPARE_PROJECT, async () => {
+    await retryAsync(
+      async () => {
+        await fs.rm(ctx.buildDirectory, { recursive: true, force: true });
+        await fs.mkdir(ctx.buildDirectory, { recursive: true });
+
+        await prepareProjectSourcesAsync(ctx, ctx.buildDirectory);
+      },
+      {
+        retryOptions: {
+          retries: 3,
+          retryIntervalMs: 1_000,
+        },
+      }
+    );
+
+    await setUpNpmrcAsync(ctx, ctx.logger);
+    if (ctx.job.platform === Platform.IOS && ctx.env.EAS_BUILD_RUNNER === 'eas-build') {
+      await deleteXcodeEnvLocalIfExistsAsync(ctx as BuildContext<Ios.Job>);
+    }
+    if (ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION) {
+      // We need to setup envs from eas.json before
+      // eas-build-pre-install hook is called.
+      const env = await resolveEnvFromBuildProfileAsync(ctx, {
+        cwd: ctx.getReactNativeProjectDirectory(),
+      });
+      ctx.updateEnv(env);
+    }
+  });
+
+  await ctx.runBuildPhase(BuildPhase.PRE_INSTALL_HOOK, async () => {
+    await runHookIfPresent(ctx, Hook.PRE_INSTALL);
+  });
+
+  await ctx.runBuildPhase(BuildPhase.READ_EAS_JSON, async () => {
+    try {
+      const easJsonContents = readEasJsonContents(ctx.getReactNativeProjectDirectory());
+      ctx.logger.info('Using eas.json:');
+      ctx.logger.info(easJsonContents);
+    } catch (err) {
+      ctx.logger.error({ err }, `Failed to read eas.json.`);
+    }
+  });
+
+  const packageJson = await ctx.runBuildPhase(BuildPhase.READ_PACKAGE_JSON, async () => {
+    ctx.logger.info('Using package.json:');
+    const packageJson = readPackageJson(ctx.getReactNativeProjectDirectory());
+    ctx.logger.info(JSON.stringify(packageJson, null, 2));
+    return packageJson;
+  });
+
+  await ctx.runBuildPhase(BuildPhase.INSTALL_DEPENDENCIES, async () => {
+    const expoVersion =
+      ctx.metadata?.sdkVersion ??
+      getPackageVersionFromPackageJson({
+        packageJson,
+        packageName: 'expo',
+      });
+
+    const reactNativeVersion =
+      ctx.metadata?.reactNativeVersion ??
+      getPackageVersionFromPackageJson({
+        packageJson,
+        packageName: 'react-native',
+      });
+
+    await runInstallDependenciesAsync(ctx, {
+      useFrozenLockfile: shouldUseFrozenLockfile({
+        env: ctx.env,
+        sdkVersion: expoVersion,
+        reactNativeVersion,
+      }),
+    });
+  });
+
+  await ctx.runBuildPhase(BuildPhase.READ_APP_CONFIG, async () => {
+    const appConfig = ctx.appConfig;
+    ctx.logger.info('Using app configuration:');
+    ctx.logger.info(JSON.stringify(appConfig, null, 2));
+    await validateAppConfigAsync(ctx, appConfig);
+  });
+
+  if (ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION) {
+    await ctx.runBuildPhase(BuildPhase.EAS_BUILD_INTERNAL, async () => {
+      if (!ctx.appConfig.ios?.bundleIdentifier && ctx.job.platform === Platform.IOS) {
+        throw new Error(
+          'The "ios.bundleIdentifier" is required to be set in app config for builds triggered by GitHub integration. Learn more: https://docs.expo.dev/versions/latest/config/app/#bundleidentifier.'
+        );
+      }
+      if (!ctx.appConfig.android?.package && ctx.job.platform === Platform.ANDROID) {
+        throw new Error(
+          'The "android.package" is required to be set in app config for builds triggered by GitHub integration. Learn more: https://docs.expo.dev/versions/latest/config/app/#package.'
+        );
+      }
+      const { newJob, newMetadata } = await runEasBuildInternalAsync({
+        job: ctx.job,
+        env: ctx.env,
+        logger: ctx.logger,
+        cwd: ctx.getReactNativeProjectDirectory(),
+        projectRootOverride: ctx.env.EAS_NO_VCS ? ctx.buildDirectory : undefined,
+      });
+      ctx.updateJobInformation(newJob, newMetadata);
+    });
+  }
+
+  const hasExpoPackage = !!packageJson.dependencies?.expo;
+  if (!ctx.env.EAS_BUILD_DISABLE_EXPO_DOCTOR_STEP && hasExpoPackage) {
+    await ctx.runBuildPhase(BuildPhase.RUN_EXPO_DOCTOR, async () => {
+      try {
+        await runExpoDoctor(ctx);
+      } catch (err) {
+        if (err instanceof DoctorTimeoutError) {
+          ctx.logger.error(err.message);
+        } else {
+          ctx.logger.error({ err }, 'Command "expo doctor" failed.');
+        }
+        ctx.markBuildPhaseHasWarnings();
+      }
+    });
+  }
+}
+
+async function runExpoDoctor<TJob extends Job>(ctx: BuildContext<TJob>): Promise<SpawnResult> {
+  ctx.logger.info('Running "expo doctor"');
+  let timeout: NodeJS.Timeout | undefined;
+  let timedOut = false;
+  const isAtLeastNpm7 = await isAtLeastNpm7Async();
+  try {
+    const argsPrefix = isAtLeastNpm7 ? ['-y'] : [];
+    const promise = spawn('npx', [...argsPrefix, 'expo-doctor'], {
+      cwd: ctx.getReactNativeProjectDirectory(),
+      logger: ctx.logger,
+      env: ctx.env,
+    });
+    timeout = setTimeout(async () => {
+      timedOut = true;
+      const ppid = nullthrows(promise.child.pid);
+      const pids = await getParentAndDescendantProcessPidsAsync(ppid);
+      pids.forEach(pid => {
+        process.kill(pid);
+      });
+      ctx.reportError?.(`"expo doctor" timed out`, undefined, {
+        extras: { buildId: ctx.env.EAS_BUILD_ID },
+      });
+    }, MAX_EXPO_DOCTOR_TIMEOUT_MS);
+    return await promise;
+  } catch (err: any) {
+    if (timedOut) {
+      throw new DoctorTimeoutError('"expo doctor" timed out, skipping...');
+    }
+    throw err;
+  } finally {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+  }
+}
+
+async function runInstallDependenciesAsync<TJob extends Job>(
+  ctx: BuildContext<TJob>,
+  {
+    useFrozenLockfile,
+  }: {
+    useFrozenLockfile: boolean;
+  }
+): Promise<void> {
+  let warnTimeout: NodeJS.Timeout | undefined;
+  let killTimeout: NodeJS.Timeout | undefined;
+  let killTimedOut: boolean = false;
+  try {
+    const installDependenciesSpawnPromise = (
+      await installDependenciesAsync({
+        packageManager: ctx.packageManager,
+        env: ctx.env,
+        logger: ctx.logger,
+        infoCallbackFn: () => {
+          if (warnTimeout) {
+            warnTimeout.refresh();
+          }
+          if (killTimeout) {
+            killTimeout.refresh();
+          }
+        },
+        cwd: resolvePackagerDir(ctx),
+        useFrozenLockfile,
+      })
+    ).spawnPromise;
+
+    warnTimeout = setTimeout(() => {
+      ctx.logger.warn(
+        '"Install dependencies" phase takes longer then expected and it did not produce any logs in the past 15 minutes. Consider evaluating your package.json file for possible issues with dependencies'
+      );
+    }, INSTALL_DEPENDENCIES_WARN_TIMEOUT_MS);
+
+    killTimeout = setTimeout(async () => {
+      killTimedOut = true;
+      ctx.logger.error(
+        '"Install dependencies" phase takes a very long time and it did not produce any logs in the past 30 minutes. Most likely an unexpected error happened with your dependencies which caused the process to hang and it will be terminated'
+      );
+      const ppid = nullthrows(installDependenciesSpawnPromise.child.pid);
+      const pids = await getParentAndDescendantProcessPidsAsync(ppid);
+      pids.forEach(pid => {
+        process.kill(pid);
+      });
+      ctx.reportError?.('"Install dependencies" phase takes a very long time', undefined, {
+        extras: { buildId: ctx.env.EAS_BUILD_ID },
+      });
+    }, INSTALL_DEPENDENCIES_KILL_TIMEOUT_MS);
+
+    await installDependenciesSpawnPromise;
+  } catch (err: any) {
+    if (killTimedOut) {
+      throw new InstallDependenciesTimeoutError(
+        '"Install dependencies" phase was inactive for over 30 minutes. Please evaluate your package.json file'
+      );
+    }
+    throw err;
+  } finally {
+    if (warnTimeout) {
+      clearTimeout(warnTimeout);
+    }
+    if (killTimeout) {
+      clearTimeout(killTimeout);
+    }
+  }
+}
+
+async function validateAppConfigAsync(
+  ctx: BuildContext<Job>,
+  appConfig: ExpoConfig
+): Promise<void> {
+  if (
+    appConfig?.extra?.eas?.projectId &&
+    ctx.env.EAS_BUILD_PROJECT_ID &&
+    appConfig.extra.eas.projectId !== ctx.env.EAS_BUILD_PROJECT_ID
+  ) {
+    const isUsingDynamicConfig =
+      (await fs.pathExists(path.join(ctx.getReactNativeProjectDirectory(), 'app.config.ts'))) ||
+      (await fs.pathExists(path.join(ctx.getReactNativeProjectDirectory(), 'app.config.js')));
+    const isGitHubBuild = ctx.job.triggeredBy === BuildTrigger.GIT_BASED_INTEGRATION;
+    let extraMessage = '';
+    if (isGitHubBuild && isUsingDynamicConfig) {
+      extraMessage =
+        'Make sure you connected your GitHub repository to the correct Expo project and if you are using environment variables to switch between projects in app.config.js/app.config.ts remember to set those variables in eas.json too. ';
+    } else if (isGitHubBuild) {
+      extraMessage = 'Make sure you connected your GitHub repository to the correct Expo project. ';
+    } else if (isUsingDynamicConfig) {
+      extraMessage =
+        'If you are using environment variables to switch between projects in app.config.js/app.config.ts, make sure those variables are also set inside EAS Build. You can do that using "env" field in eas.json or EAS environment variables. ';
+    }
+    throw new UserFacingError(
+      'EAS_BUILD_PROJECT_ID_MISMATCH',
+      `The value of the "extra.eas.projectId" field (${appConfig.extra.eas.projectId}) in the app config does not match the current project id (${ctx.env.EAS_BUILD_PROJECT_ID}). ${extraMessage}Learn more: https://expo.fyi/eas-config-mismatch.`
+    );
+  } else if (ctx.env.EAS_BUILD_PROJECT_ID && !appConfig?.extra?.eas?.projectId) {
+    ctx.logger.error(`The "extra.eas.projectId" field is missing from your app config.`);
+    ctx.markBuildPhaseHasWarnings();
+  }
+}

packages/build-tools/src/context.ts

@@ -0,0 +1,410 @@
+import { ExpoConfig } from '@expo/config';
+import {
+  BuildPhase,
+  BuildPhaseResult,
+  BuildPhaseStats,
+  Env,
+  EnvironmentSecretType,
+  GenericArtifactType,
+  Job,
+  LogMarker,
+  ManagedArtifactType,
+  Metadata,
+  errors,
+  isGenericArtifact,
+} from '@expo/eas-build-job';
+import { BuildTrigger } from '@expo/eas-build-job/dist/common';
+import { bunyan } from '@expo/logger';
+import { Client, fetchExchange } from '@urql/core';
+import fs from 'fs-extra';
+import path from 'path';
+
+import { resolveBuildPhaseErrorAsync } from './buildErrors/detectError';
+import { readAppConfig } from './utils/appConfig';
+import { createTemporaryEnvironmentSecretFile } from './utils/environmentSecrets';
+import { PackageManager, resolvePackageManager } from './utils/packageManager';
+
+export type Artifacts = Partial<Record<ManagedArtifactType, string>>;
+
+export interface CacheManager {
+  saveCache(ctx: BuildContext<Job>): Promise<void>;
+  restoreCache(ctx: BuildContext<Job>): Promise<void>;
+}
+
+export interface LogBuffer {
+  getLogs(): string[];
+  getPhaseLogs(buildPhase: string): string[];
+}
+
+export type ArtifactToUpload =
+  | {
+      type: ManagedArtifactType;
+      paths: string[];
+    }
+  | {
+      type: GenericArtifactType;
+      name: string;
+      paths: string[];
+    };
+
+export interface BuildContextOptions {
+  workingdir: string;
+  logger: bunyan;
+  logBuffer: LogBuffer;
+  env: Env;
+  cacheManager?: CacheManager;
+  uploadArtifact: (spec: { artifact: ArtifactToUpload; logger: bunyan }) => Promise<
+    /** Workflow Artifact ID */
+    | { artifactId: string | null; filename?: never }
+    /** This remains from the time we relied on Launcher to rename the GCS object. */
+    | { artifactId?: never; filename: string | null }
+  >;
+  reportError?: (
+    msg: string,
+    err?: Error,
+    options?: { tags?: Record<string, string>; extras?: Record<string, string> }
+  ) => void;
+  reportBuildPhaseStats?: (stats: BuildPhaseStats) => void;
+  skipNativeBuild?: boolean;
+  metadata?: Metadata;
+}
+
+export class SkipNativeBuildError extends Error {}
+
+export class BuildContext<TJob extends Job = Job> {
+  public readonly workingdir: string;
+  public logger: bunyan;
+  public readonly logBuffer: LogBuffer;
+  public readonly cacheManager?: CacheManager;
+  public readonly reportError?: (
+    msg: string,
+    err?: Error,
+    options?: { tags?: Record<string, string>; extras?: Record<string, string> }
+  ) => void;
+  public readonly skipNativeBuild?: boolean;
+  public artifacts: Artifacts = {};
+
+  private readonly _isLocal: boolean;
+
+  private _env: Env;
+  private _job: TJob;
+  private _metadata?: Metadata;
+  private readonly defaultLogger: bunyan;
+  private readonly _uploadArtifact: BuildContextOptions['uploadArtifact'];
+  private buildPhase?: BuildPhase;
+  private buildPhaseSkipped = false;
+  private buildPhaseHasWarnings = false;
+  private _appConfig?: ExpoConfig;
+  private readonly reportBuildPhaseStats?: (stats: BuildPhaseStats) => void;
+  public readonly graphqlClient: Client;
+
+  constructor(job: TJob, options: BuildContextOptions) {
+    this.workingdir = options.workingdir;
+    this.defaultLogger = options.logger;
+    this.logger = this.defaultLogger;
+    this.logBuffer = options.logBuffer;
+    this.cacheManager = options.cacheManager;
+    this._uploadArtifact = options.uploadArtifact;
+    this.reportError = options.reportError;
+
+    this._job = job;
+    this._metadata = options.metadata;
+    this.skipNativeBuild = options.skipNativeBuild;
+    this.reportBuildPhaseStats = options.reportBuildPhaseStats;
+
+    const environmentSecrets = this.getEnvironmentSecrets(job);
+    this._env = {
+      ...options.env,
+      ...job?.builderEnvironment?.env,
+      ...environmentSecrets,
+      __EAS_BUILD_ENVS_DIR: this.buildEnvsDirectory,
+    };
+
+    this._env.PATH = this._env.PATH
+      ? [this.buildExecutablesDirectory, this._env.PATH].join(':')
+      : this.buildExecutablesDirectory;
+
+    this._isLocal = this._env.EAS_BUILD_RUNNER !== 'eas-build';
+
+    this.graphqlClient = new Client({
+      url: new URL('graphql', this.env.__API_SERVER_URL).toString(),
+      exchanges: [fetchExchange],
+      preferGetMethod: false,
+      fetchOptions: {
+        headers: {
+          Authorization: `Bearer ${job.secrets?.robotAccessToken}`,
+        },
+      },
+    });
+  }
+
+  public get job(): TJob {
+    return this._job;
+  }
+  public get metadata(): Metadata | undefined {
+    return this._metadata;
+  }
+  public get env(): Env {
+    return this._env;
+  }
+  public get buildDirectory(): string {
+    return path.join(this.workingdir, 'build');
+  }
+  public get buildLogsDirectory(): string {
+    return path.join(this.workingdir, 'logs');
+  }
+  public get isLocal(): boolean {
+    return this._isLocal;
+  }
+  /**
+   * Directory used to store executables used during regular (non-custom) builds.
+   */
+  public get buildExecutablesDirectory(): string {
+    return path.join(this.workingdir, 'bin');
+  }
+  /**
+   * Directory used to store env variables registered in the current build step.
+   * All values stored here will be available in the next build phase as env variables.
+   */
+  public get buildEnvsDirectory(): string {
+    return path.join(this.workingdir, 'env');
+  }
+  public get packageManager(): PackageManager {
+    return resolvePackageManager(this.getReactNativeProjectDirectory());
+  }
+  public get appConfig(): ExpoConfig {
+    if (!this._appConfig) {
+      this._appConfig = readAppConfig({
+        projectDir: this.getReactNativeProjectDirectory(),
+        env: this.env,
+        logger: this.logger,
+        sdkVersion: this.metadata?.sdkVersion,
+      }).exp;
+    }
+    return this._appConfig;
+  }
+
+  public async runBuildPhase<T>(
+    buildPhase: BuildPhase,
+    phase: () => Promise<T>,
+    {
+      doNotMarkStart = false,
+      doNotMarkEnd = false,
+    }: {
+      doNotMarkStart?: boolean;
+      doNotMarkEnd?: boolean;
+    } = {}
+  ): Promise<T> {
+    let startTimestamp = Date.now();
+    try {
+      this.setBuildPhase(buildPhase, { doNotMarkStart });
+      startTimestamp = Date.now();
+      const result = await phase();
+      const durationMs = Date.now() - startTimestamp;
+      const buildPhaseResult: BuildPhaseResult = this.buildPhaseSkipped
+        ? BuildPhaseResult.SKIPPED
+        : this.buildPhaseHasWarnings
+          ? BuildPhaseResult.WARNING
+          : BuildPhaseResult.SUCCESS;
+      await this.endCurrentBuildPhaseAsync({ result: buildPhaseResult, doNotMarkEnd, durationMs });
+      return result;
+    } catch (err: any) {
+      const durationMs = Date.now() - startTimestamp;
+      const resolvedError = await this.handleBuildPhaseErrorAsync(err, buildPhase);
+      await this.endCurrentBuildPhaseAsync({ result: BuildPhaseResult.FAIL, durationMs });
+      throw resolvedError;
+    }
+  }
+
+  public markBuildPhaseSkipped(): void {
+    this.buildPhaseSkipped = true;
+  }
+
+  public markBuildPhaseHasWarnings(): void {
+    this.buildPhaseHasWarnings = true;
+  }
+
+  public async uploadArtifact({
+    artifact,
+    logger,
+  }: {
+    artifact: ArtifactToUpload;
+    logger: bunyan;
+  }): Promise<{ artifactId: string | null }> {
+    const result = await this._uploadArtifact({ artifact, logger });
+    if (result.filename && !isGenericArtifact(artifact)) {
+      this.artifacts[artifact.type] = result.filename;
+    }
+    return { artifactId: result.artifactId ?? null };
+  }
+
+  public updateEnv(env: Env): void {
+    if (this._job.triggeredBy !== BuildTrigger.GIT_BASED_INTEGRATION) {
+      throw new Error(
+        'Updating environment variables is only allowed when build was triggered by a git-based integration.'
+      );
+    }
+    this._env = {
+      ...env,
+      ...this._env,
+      __EAS_BUILD_ENVS_DIR: this.buildEnvsDirectory,
+    };
+    this._env.PATH = this._env.PATH
+      ? [this.buildExecutablesDirectory, this._env.PATH].join(':')
+      : this.buildExecutablesDirectory;
+  }
+
+  public updateJobInformation(job: TJob, metadata: Metadata): void {
+    if (this._job.triggeredBy !== BuildTrigger.GIT_BASED_INTEGRATION) {
+      throw new Error(
+        'Updating job information is only allowed when build was triggered by a git-based integration.'
+      );
+    }
+    this._job = {
+      ...this._job,
+      ...job,
+      workflowInterpolationContext:
+        job.workflowInterpolationContext ?? this.job.workflowInterpolationContext,
+      triggeredBy: this._job.triggeredBy,
+      secrets: {
+        ...this.job.secrets,
+        ...job.secrets,
+        robotAccessToken: job.secrets?.robotAccessToken ?? this.job.secrets?.robotAccessToken,
+        environmentSecrets: [
+          // Latter secrets override former ones.
+          ...(this.job.secrets?.environmentSecrets ?? []),
+          ...(job.secrets?.environmentSecrets ?? []),
+        ],
+      },
+      ...(this._job.platform ? { expoBuildUrl: this._job.expoBuildUrl } : null),
+    };
+    this._metadata = metadata;
+  }
+
+  private async handleBuildPhaseErrorAsync(
+    err: any,
+    buildPhase: BuildPhase
+  ): Promise<errors.BuildError> {
+    const buildError = await resolveBuildPhaseErrorAsync(
+      err,
+      this.logBuffer.getPhaseLogs(buildPhase),
+      {
+        job: this.job,
+        phase: buildPhase,
+        env: this.env,
+      },
+      this.buildLogsDirectory
+    );
+    if (buildError.errorCode === errors.ErrorCode.UNKNOWN_ERROR) {
+      // leaving message empty, website will display err.stack which already includes err.message
+      this.logger.error({ err }, '');
+    } else {
+      this.logger.error(`Error: ${buildError.userFacingMessage}`);
+    }
+    return buildError;
+  }
+
+  public getReactNativeProjectDirectory(baseDirectory = this.buildDirectory): string {
+    if (!this.job.platform) {
+      return path.join(
+        baseDirectory,
+        // NOTE: We may want to add projectRootDirectory to generic jobs in the future.
+        this.job.builderEnvironment.env.__EXPO_RELATIVE_BASE_DIRECTORY || '.'
+      );
+    }
+
+    return path.join(baseDirectory, this.job.projectRootDirectory ?? '.');
+  }
+
+  private setBuildPhase(buildPhase: BuildPhase, { doNotMarkStart = false } = {}): void {
+    if (this.buildPhase) {
+      if (this.buildPhase === buildPhase) {
+        return;
+      } else {
+        this.logger.info(
+          { marker: LogMarker.END_PHASE, result: BuildPhaseResult.UNKNOWN },
+          `End phase: ${this.buildPhase}`
+        );
+        this.logger = this.defaultLogger;
+      }
+    }
+    this.buildPhase = buildPhase;
+    this.logger = this.defaultLogger.child({ phase: buildPhase });
+    if (!doNotMarkStart) {
+      this.logger.info({ marker: LogMarker.START_PHASE }, `Start phase: ${this.buildPhase}`);
+    }
+  }
+
+  private async endCurrentBuildPhaseAsync({
+    result,
+    doNotMarkEnd = false,
+    durationMs,
+  }: {
+    result: BuildPhaseResult;
+    doNotMarkEnd?: boolean;
+    durationMs: number;
+  }): Promise<void> {
+    if (!this.buildPhase) {
+      return;
+    }
+    await this.collectAndUpdateEnvVariablesAsync();
+
+    this.reportBuildPhaseStats?.({ buildPhase: this.buildPhase, result, durationMs });
+
+    if (!doNotMarkEnd) {
+      this.logger.info(
+        { marker: LogMarker.END_PHASE, result, durationMs },
+        `End phase: ${this.buildPhase}`
+      );
+    }
+    this.logger = this.defaultLogger;
+    this.buildPhase = undefined;
+    this.buildPhaseSkipped = false;
+    this.buildPhaseHasWarnings = false;
+  }
+
+  private async collectAndUpdateEnvVariablesAsync(): Promise<void> {
+    const filenames = await fs.readdir(this.buildEnvsDirectory);
+
+    const entries = await Promise.all(
+      filenames.map(async basename => {
+        const rawContents = await fs.readFile(
+          path.join(this.buildEnvsDirectory, basename),
+          'utf-8'
+        );
+        return [basename, rawContents];
+      })
+    );
+    await Promise.all(
+      filenames.map(async basename => {
+        await fs.remove(path.join(this.buildEnvsDirectory, basename));
+      })
+    );
+    this._env = {
+      ...this._env,
+      ...Object.fromEntries(entries),
+    };
+  }
+
+  private getEnvironmentSecrets(job: TJob): Record<string, string> {
+    if (!job?.secrets?.environmentSecrets) {
+      return {};
+    }
+
+    const environmentSecretsDirectory = path.join(this.workingdir, 'eas-environment-secrets');
+
+    const environmentSecrets: Record<string, string> = {};
+    for (const { name, type, value } of job.secrets.environmentSecrets) {
+      if (type === EnvironmentSecretType.STRING) {
+        environmentSecrets[name] = value;
+      } else {
+        environmentSecrets[name] = createTemporaryEnvironmentSecretFile({
+          secretsDir: environmentSecretsDirectory,
+          name,
+          contents_base64: value,
+        });
+      }
+    }
+    return environmentSecrets;
+  }
+}