0.1.2: rename env vars off EAS_BUILD_* (collision with EAS Build reserved namespace)

Root cause of EAS Workflow custom jobs failing silently after PREPARE_PROJECT:
the worker reads process.env.EAS_BUILD_ID to construct
/v2/turtle-job-runs/<id>/download-project-archive. Setting EAS_BUILD_ID
in the job's env: block (to forward the upstream build_id) clobbered the
worker's own job-run identifier, breaking the project-archive refresh
endpoint, falling back to ArchiveSourceType.NONE (empty project), killing
the run before PARSE_CUSTOM_WORKFLOW_CONFIG.

Reproduced isolated via bisection: same job structure, EAS_BUILD_ID in
env: fails; DCD_BUILD_ID in env: succeeds.

Fix: prefix all wrapper-defined env vars with DCD_ to avoid the
EAS_BUILD_* reserved namespace. Renames are non-backward-compatible
but only affect 0.1.0/0.1.1 users (none in production yet, @latest is
still 0.1.0 awaiting public release).

Author: finalerock44

README.md

@@ -16,6 +16,7 @@ jobs:
     needs: [build_android]
     runs_on: linux-medium
     steps:
+      - uses: eas/checkout
       - id: download
         uses: eas/download_build
         with:
@@ -27,6 +28,8 @@ jobs:
             --flows ./.maestro
 ```
 
+> **Don't** name your env-block keys `EAS_BUILD_ID` or anything starting with `EAS_BUILD_*` — that namespace is reserved by EAS Build workers, and clobbering `EAS_BUILD_ID` will cause your custom job to fail silently after `PREPARE_PROJECT` with no error message. Use the wrapper's `DCD_EAS_*` env-var contract instead (see [examples/](./examples/)).
+
 Before running, store your DeviceCloud API key as an EAS project secret named `DEVICE_CLOUD_API_KEY`:
 
 ```bash

dist/index.js

@@ -14,16 +14,17 @@ jobs:
     needs: [build_android]
     runs_on: linux-medium
     env:
-      EAS_BUILD_ID: ${{ needs.build_android.outputs.build_id }}
-      EAS_BUILD_PLATFORM: ${{ needs.build_android.outputs.platform }}
-      EAS_APP_VERSION: ${{ needs.build_android.outputs.app_version }}
-      EAS_GH_SHA: ${{ github.sha }}
-      EAS_GH_BRANCH: ${{ github.ref_name }}
+      DCD_EAS_BUILD_ID: ${{ needs.build_android.outputs.build_id }}
+      DCD_EAS_PLATFORM: ${{ needs.build_android.outputs.platform }}
+      DCD_EAS_APP_VERSION: ${{ needs.build_android.outputs.app_version }}
+      DCD_GH_SHA: ${{ github.sha }}
+      DCD_GH_BRANCH: ${{ github.ref_name }}
     outputs:
       console_url: ${{ steps.dcd.outputs.console_url }}
       status: ${{ steps.dcd.outputs.upload_status }}
       flow_results: ${{ steps.dcd.outputs.flow_results }}
     steps:
+      - uses: eas/checkout
       - id: download
         uses: eas/download_build
         with:

examples/android.yml

@@ -14,16 +14,17 @@ jobs:
     needs: [build_ios]
     runs_on: linux-medium
     env:
-      EAS_BUILD_ID: ${{ needs.build_ios.outputs.build_id }}
-      EAS_BUILD_PLATFORM: ${{ needs.build_ios.outputs.platform }}
-      EAS_APP_VERSION: ${{ needs.build_ios.outputs.app_version }}
-      EAS_GH_SHA: ${{ github.sha }}
-      EAS_GH_BRANCH: ${{ github.ref_name }}
+      DCD_EAS_BUILD_ID: ${{ needs.build_ios.outputs.build_id }}
+      DCD_EAS_PLATFORM: ${{ needs.build_ios.outputs.platform }}
+      DCD_EAS_APP_VERSION: ${{ needs.build_ios.outputs.app_version }}
+      DCD_GH_SHA: ${{ github.sha }}
+      DCD_GH_BRANCH: ${{ github.ref_name }}
     outputs:
       console_url: ${{ steps.dcd.outputs.console_url }}
       status: ${{ steps.dcd.outputs.upload_status }}
       flow_results: ${{ steps.dcd.outputs.flow_results }}
     steps:
+      - uses: eas/checkout
       - id: download
         uses: eas/download_build
         with:

examples/ios.yml

@@ -2,7 +2,7 @@
   "name": "@devicecloud.dev/eas-workflow",
   "description": "Run Maestro tests on devicecloud.dev from EAS Workflows",
   "author": "devicecloud.dev",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "main": "dist/index.js",
   "bin": {
     "eas-workflow": "dist/index.js"

package.json

@@ -6,17 +6,22 @@ export interface EasEnv {
   metadata: string[];
 }
 
+// IMPORTANT: env var names must NOT use the `EAS_BUILD_*` prefix.
+// EAS Build workers reserve that namespace for system env vars
+// (EAS_BUILD_ID, EAS_BUILD_PROJECT_ID, EAS_BUILD_WORKINGDIR, ...).
+// Collisions overwrite the worker's own job-run ID and break the
+// project-archive refresh, killing the run silently after PREPARE_PROJECT.
 const metadataMappings: Array<[envVar: string, metadataKey: string]> = [
-  ['EAS_BUILD_ID', 'eas_build_id'],
-  ['EAS_BUILD_PLATFORM', 'eas_platform'],
-  ['EAS_BUILD_PROFILE', 'eas_profile'],
-  ['EAS_APP_VERSION', 'eas_app_version'],
-  ['EAS_GH_SHA', 'gh_sha'],
-  ['EAS_GH_BRANCH', 'gh_branch'],
-  ['EAS_GH_PR_NUMBER', 'gh_pr_number'],
-  ['EAS_GH_PR_URL', 'gh_pr_url'],
-  ['EAS_GH_REPO', 'gh_repo'],
-  ['EAS_GH_RUN_ID', 'gh_run_id'],
+  ['DCD_EAS_BUILD_ID', 'eas_build_id'],
+  ['DCD_EAS_PLATFORM', 'eas_platform'],
+  ['DCD_EAS_PROFILE', 'eas_profile'],
+  ['DCD_EAS_APP_VERSION', 'eas_app_version'],
+  ['DCD_GH_SHA', 'gh_sha'],
+  ['DCD_GH_BRANCH', 'gh_branch'],
+  ['DCD_GH_PR_NUMBER', 'gh_pr_number'],
+  ['DCD_GH_PR_URL', 'gh_pr_url'],
+  ['DCD_GH_REPO', 'gh_repo'],
+  ['DCD_GH_RUN_ID', 'gh_run_id'],
 ];
 
 export function getEnv(): EasEnv {
@@ -39,7 +44,7 @@ export function getEnv(): EasEnv {
   return {
     apiKey,
     apiUrl: process.env.DEVICE_CLOUD_API_URL || undefined,
-    buildUrl: process.env.EAS_BUILD_URL || undefined,
+    buildUrl: process.env.DCD_EAS_BUILD_URL || undefined,
     useBeta: process.env.DCD_USE_BETA === 'true',
     metadata,
   };