2026 OpenClaw 프론트 실전:
원격 Mac에서 package.json scripts 변경 감지·배포 전 diff 보고서
대상: 프론트 엔지니어링·릴리즈 담당. OpenClaw, 원격 Mac, package.json, 배포 전 검사, diff 보고서. scripts만 바뀌어 파이프라인이 깨지는 일을 막으려면 git 범위·스냅샷·보고서·알림을 묶어 재현하세요. 연관 글: Lighthouse·링크·a11y, 배포 전 스모크, npm/pnpm audit. 블로그·도움말.
01 환경과 권한
배포할 브랜치와 같은 깨끗한 트리에서 실행하세요. 원격 Mac/CI는 저장소 읽기, git, artifacts/preflight/ 쓰기가 sudo 없이 되어야 합니다.
버전 고정: 프로덕션과 동일한 node·npm|pnpm|yarn(Corepack이면 보고서에 버전 명시). 여기가 어긋나면 scripts 불변에도 동작만 달라집니다.
OpenClaw: 읽기 전용 repo + 알림 업로드만. 토큰은 CI env로, diff 보고서에 비밀 금지. 모노레포는 배포 참여 package.json마다 스냅샷 반복. pnpm·Turborepo로 캐시·레지스트리 정합.
02 변경 감지 트리거
scripts는 릴리즈용 API로 취급하세요. build 이름 변경, release 래퍼 추가, test:e2e 플래그 수정만으로도 하류 자동화가 깨질 수 있습니다.
git diff 범위(체크리스트):
- ☐
HEADvsorigin/main, 이전 태그, 또는 릴리즈 브랜치의git merge-base중 무엇을 썼는지 보고서 제목에 명시합니다. - ☐ 루트
package.json과 빌드·배포에 참여하는packages/*/package.json(또는 팀 규칙의 glob)을 모두 포함합니다. - ☐ 의존성 변경만 잦다면
git diff <범위> -- package.json packages/처럼 경로를 좁혀 리뷰 노이즈를 줄일 수 있습니다.
스냅샷: scripts만 추출·키 정렬·JSON 저장. 예: scripts.<pkg>.<sha>.json, 베이스라인 scripts.<pkg>.baseline.json. node -e "…JSON.stringify(p.scripts||{}, null, 2)…" 후 정규화.
트리거: 해당 package.json이 바뀐 PR, main 야간, 태그 직전. OpenClaw로 머지 후 원격 Mac에서 재실행.
03 보고서 필드 규격
런마다 마크다운 또는 JSON 하나를 표준 삼으세요. 아래 보고서 템플릿을 그대로 써도 됩니다.
# Scripts preflight — <저장소> @ <short_sha> 범위: <from_ref>..<to_ref> | Node <version> | <npm|pnpm|yarn> <version> ## 요약 - 영향 패키지: … - 추가·삭제·수정된 스크립트 수: … - 리스크 등급: 낮음 / 중간 / 높음 (아래 표 기준) ## 패키지별 델타 ### root | script | 변경 | 추정 영향 | | build | 플래그 … | CI 산출물 경로 | | … | … | … | ## 필수 후속 조치 - [ ] 스모크 / E2E 매트릭스 재실행 - [ ] 런북·배포 문서 갱신 - [ ] deploy 훅 변경 시 SRE 공지 ## 산출물 - 스냅샷 JSON 경로·URL - 원시 unified diff 첨부
알림(체크리스트): Slack·Teams·기타 협업 채널 또는 일반 웹훅에 비교 범위, 변경된 스크립트 개수, 최고 리스크 라벨 세 줄 요약과 전체 보고서 링크를 붙입니다. OpenClaw 태스크에는 아티팩트 경로를 넣어 에이전트가 원격 Mac에서 파일을 열고 후속 수정 초안을 덧붙이게 합니다.
04 CI 연동
무거운 빌드/E2E 앞에 가벼운 잡: JSON 파싱 실패 시 즉시 실패, 보고서 아티팩트, 보호 스크립트 변경 시 changelog·허용 목록 없으면 exit≠0.
설치·락파일 검증 후 스모크 전에 넣으면 scripts 표류를 먼저 잡습니다. Apple Silicon은 CI=true·아키텍처 로그로 arm64 가정도 추적.
05 실패 사례·트러블슈팅
파싱 오류: 후행 쉼표·중복 키 → Node 예외. 수정 후 재실행, 필요 시 npm pkg get scripts.
가짜 무diff: 잘못된 패키지 경로 비교, 또는 sh vs zsh 해석 차이 — CI 셸을 보고서에 기록.
머지: 동시 리네임은 한 사이클 build:legacy 별칭 권장. E2E 연동은 로그 분석 글 참고.
| 증상 | 가능 원인 | 조치 |
|---|---|---|
| diff는 비었는데 배포만 실패 | 환경 변수·락파일만 달라짐 | Node·PM 버전 로그; 락파일 구간 diff |
| 매주 시끄러운 diff | 정렬 없는 스크립트·생성 필드 | 키 정렬·scripts 외 필드 제외 |
| 산출물 쓰기 permission denied | 샌드박스 러너 | $CI_PROJECT_DIR/artifacts 또는 tmp 업로드 |
06 검수 체크리스트
릴리즈를 그린이라고 부르기 전에 아래를 확인하세요. 나머지 OpenClaw 기반 웹 배포 전 검사와 같은 높이로 맞춥니다.
- ☐ 보고서 헤더의 git diff 범위가 실제 승격 커밋과 일치
- ☐ 빌드·테스트·배포에 쓰는 패키지마다 scripts 스냅샷 존재(원격 Mac 경로 포함)
- ☐ diff 보고서가 CI 아티팩트 또는 안정 URL로 보관됨
- ☐ 담당 채널에 요약+링크 알림 발송
- ☐ 보호 스크립트 정책 위반 시 비정상 종료로 차단
- ☐ 스모크·Lighthouse·audit 등 하류 게이트가 표준 순서대로 예약됨
scripts는 릴리즈 계약입니다. 좁은 git diff·스냅샷·diff 보고서로 OpenClaw와 사람이 배포 전 같은 근거를 보게 하면, 무거운 배포 전 검사 전에 변경이 이력으로 고정됩니다.