ci: developer workflow tests and fix workspace build order

The prepare script now builds packages in dependency order:
1. utils/esbuild (no deps)
2. common/trace-commands, gh-inputs, pretty-errors (pretty-errors needs trace-commands)
3. utils packages
4. Action packages in dependency order (setup-program first, then dependents)

This fixes "Cannot find module" errors on fresh clones where npm was
running workspace prepare scripts in parallel without respecting
dependencies.

Added dev-workflow CI job that tests npm install/build/test on all
platforms, blocking the main build matrix if it fails.

Author: alandefreitas

.github/workflows/ci.yml

@@ -21,7 +21,60 @@ env:
   DEFAULT_BUILD_VARIANT: debug,release
 
 jobs:
+  # ===========================================================================
+  # Developer workflow tests
+  # Ensures contributors can clone, install, build, and test locally
+  # ===========================================================================
+  dev-workflow:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    name: Dev Workflow (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies and build
+        run: npm install
+
+      - name: Run tests
+        run: npm test
+
+      - name: Check dist bundles
+        if: matrix.os == 'ubuntu-latest' && github.event_name == 'pull_request'
+        run: |
+          # Get files changed in this PR
+          git fetch origin ${{ github.base_ref }} --depth=1
+          changed_files=$(git diff --name-only origin/${{ github.base_ref }}...HEAD)
+
+          # Check for source and dist changes
+          source_changed=$(echo "$changed_files" | grep -E '\.ts$' || true)
+          dist_changed=$(echo "$changed_files" | grep -E '/dist/' || true)
+
+          if [ -n "$source_changed" ] && [ -z "$dist_changed" ]; then
+            echo "::warning::Source files changed but no dist/ files were updated. Run 'npm run build' and commit the updated dist/ files."
+            echo "Changed source files:"
+            echo "$source_changed"
+          else
+            echo "Dist bundle check passed"
+          fi
+
+  # ===========================================================================
+  # Action integration tests
+  # Tests the actions in practice with various C++ compilers and platforms
+  # ===========================================================================
   cpp-matrix:
+    needs: dev-workflow
     runs-on: ubuntu-latest
     name: Generate Test Matrix
     outputs:

b2-workflow/dist/index.js

@@ -5,10 +5,9 @@
   "main": "lib/index.js",
   "scripts": {
     "build": "tsc -p .config/tsconfig.json",
-    "prepare": "npm run build && node ../utils/esbuild/dist/index.js .",
     "typecheck": "tsc -p .config/tsconfig.json --noEmit",
     "test": "jest --config ../jest.config.js --selectProjects b2-workflow",
-    "all": "npm run prepare && npm run test"
+    "all": "npm run build && node ../utils/esbuild/dist/index.js ."
   },
   "keywords": [],
   "author": "",

b2-workflow/dist/index.js.map

@@ -5,10 +5,9 @@
   "main": "lib/index.js",
   "scripts": {
     "build": "tsc -p .config/tsconfig.json",
-    "prepare": "npm run build && node ../utils/esbuild/dist/index.js .",
     "typecheck": "tsc -p .config/tsconfig.json --noEmit",
     "test": "jest --config ../jest.config.js --selectProjects boost-clone",
-    "all": "npm run prepare && npm run test"
+    "all": "npm run build && node ../utils/esbuild/dist/index.js ."
   },
   "keywords": [],
   "author": "",