2026 원격 Mac 프론트 빌드 피하기:
esbuild·SWC 네이티브, optionalDependencies, 재설치 결정 행렬

체크 포인트: process.versions.modules·arm64. esbuild·SWC는 optional 슬라이스 하나만 틀려도 로드 실패. Node 격리는 다중 프로젝트 Node 격리·import maps ESM와 함께 두면 좋습니다.

CI 동시성 검수 체크리스트

1. postinstall 비중이 크면 npm maxsockets 또는 pnpm child-concurrency를 낮춤.
2. 행렬 다리 없이 가변 pnpm-store를 여러 잡이 공유하지 않기(잡별 suffix).
3. Vite·Next 전에 require('esbuild')·require('@swc/core') 프리플라이트.
4. 실패 시 npm/pnpm 디버그 로그를 아티팩트로 남김.
5. Bun·Deno 혼합 런타임은 Bun·Node·Deno 캐시 미러와 캐시 키를 분리.

아래는 CI와 동일해야 할 원격 Mac 셸에서 그대로 복붙할 수 있는 최소 런북입니다.

uname -m
node -p "[process.platform, process.arch, process.versions.modules, process.version].join(' ')"
which node
npm -v 2>/dev/null || true
pnpm -v 2>/dev/null || true

rm -rf node_modules
# npm:
npm ci
# 또는 pnpm:
pnpm install --frozen-lockfile

node -e "require('esbuild'); console.log('esbuild ok')"
node -e "require('@swc/core'); console.log('swc ok')"

규칙: 프로브가 터지면 앱 코드보다 먼저 설치 트리를 의심합니다. 네이티브 설치와 lockfile 검증은 같은 잡에서 수행하는 편이 안전합니다.

node_modules는 OS·아키텍처·Node major·시스템 libc 계열 간 이식이 되지 않습니다. 캐시 키에는 최소 lockfile 해시 + arch + Node 전체 semver + (가능하면) 이미지 digest를 넣으세요.

• 접두사 예: darwin-arm64-node20- — lockfile 해시만으로는 부족합니다.
• Xcode/CLT 메이저 전환 시 수동 salt를 올려 온 libc 바이너리가 복원되지 않게 합니다.
• 위 차원 중 하나라도 바뀌면 node_modules 전체 삭제가 가장 싸게 먹히는 경우가 많습니다.
• lockfile diff에서 플랫폼별 optional 항목이 사라지지 않았는지 리뷰합니다.

발견법: 복원이 비정상적으로 빠른데 네이티브 테스트만 실패하면, 캐시가 독인지 의심하고 프로브를 의무화하세요.