Files
clean-architecture-frontend…/scripts
DongHyeonka c6e4252802 feat(scripts): 검증 진입점 scripts/verify.sh가 단계를 desktop으로 옮겨 돈다
desktop에서 게이트를 돌리는 법이 문서와 세션마다 다른 손 절차였다
(checkout 바꾸기·되돌리기, CI env 넣기, runner 스크립트 복사). 같은 빈틈이
되풀이됐고, 공유 checkout의 브랜치를 바꾼 채 두는 위험이 있었다.

scripts/verify.sh <단계>는 claude-harness template/scripts/verify.sh의
운반부를 쓰고 단계를 채운다.
- 단계: config/ci/gates.json의 stage id(merge·release·production·field·
  documentation)는 그 gateIds 전부를 ci:gate로, gate <ID>…, parts <ID>(그
  게이트의 명령을 하나씩 끝까지, FE-GATE-013 진단용), script <이름>…,
  docs·hooks(노트북). stage는 실패가 있어도 끝까지 돌고 게이트마다 rc와
  초를 남긴다.
- desktop: 지금 트리를 기준 커밋에 대한 패치로 보내 공유 checkout에서 새
  worktree를 만들고, 트리 해시를 맞춘 뒤 commit-tree로 깨끗한 HEAD를 만든다.
  CI=true pnpm install --frozen-lockfile --offline 뒤 flock 잠금 아래 CI
  env(CI, VITE_COMMIT_SHA, VITE_BUILD_ID, RELEASE_ID, CI_RUNNER_IMAGE)로
  돌리고, /tmp/claude-gates/<이름>/에 summary·로그·게이트 산출물·
  status-after를 남긴 뒤 worktree를 지운다. push하지 않는다.
- 잘못된 단계·게이트는 desktop에 보내기 전에 노트북에서 거절한다.

버린 대안: 공유 checkout의 브랜치를 잠금 안에서 바꾸고 되돌리기(지금 손
절차). 다른 세션의 checkout을 건드리고, 끝나지 않으면 바뀐 채 남는다.

위험·한계: 새 worktree의 오프라인 설치는 desktop pnpm store에 의존한다.
없으면 온라인 설치로 넘어간다. CI workflow가 아직 이 스크립트를 부르지
않는다(CI 재편 몫).

검증: python3 -m unittest scripts/tests/test_verify.py 통과(stage마다
계약의 gateIds, parts의 명령, 잘못된 인자는 원격 호출 0, 가짜 ssh로
패치 → 같은 트리 해시 → 로그 → worktree 정리, 없는 원격 repo는 rc=4).
desktop에서 실제 운반을 한 번 돌려 트리 해시 일치와 worktree 정리를 봤다.

Refs: design-docs harness/01-harness-design.md 6절
2026-11-08 17:27:39 +09:00
..