본진 자동 sync 무동작 3중 결함 — flock 부재 + origin-trigger 부재 + broadcast 작업브랜치 실패

발생 일자: 2026-06-04 ~01:19 KST (PR #80 본진 squash 머지 직후 미전파로 표면화)
발견 일자: 2026-06-04 ~01:39 KST (아니키 “동기화 싱크기능 안잡힌다” surface)
해결 일자: 2026-06-04 ~01:50 KST (3중 결함 수정 + 5노드 라이브 검증 PASS, origin/main f195f69)
심각도: high (본진 자동 sync hook 4개가 macOS 에서 통째로 무동작 — 장기간 미발견 가능성)
재발 가능성: (수정 전) certain — macOS 본진에서 매 발동마다 재현

증상

PR #80(40% 하드클리어 누수 백스톱) 본진 squash 머지 후 5노드 HEAD 실측 — 머지가 본진에만 적용, 4노드 전부 미수신:

🍎 본진 1e9eece (main) ✓ / 🪟 라이덴 1dafa2b(작업브랜치) ✗ / 🏭 맥미니 c04296f(1 behind) ✗ / 🖥 데스크탑 48dcb27(작업브랜치) ✗ / 💻 노트북 9be3fd1(2 behind) ✗

원인 — 3중 결함이 겹침

① (최근본) flock 부재로 본진 sync hook 4개가 2번째 줄에서 즉시 종료

stop-sync-automations / posttooluse-sync-automations / stop-sync-skills / posttooluse-sync-skills 4개 hook 모두 상단에:

exec 9>/tmp/.claude-...-sync.lock
flock -n 9 || exit 0

flock 은 Linux(util-linux) 전용 — macOS 엔 기본 미설치. macOS 본진에서 flock → “command not found”(exit 127) → || exit 0 발동 → hook 이 락 잡기도 전에 즉시 종료. 즉 본진의 자동 sync hook 4개가 통째로 한 번도 제대로 안 돌았음. 로그 한 줄도 안 남고 종료(라이브로 flock: command not found 확인). 노드(Linux)는 flock 있어 정상 → 사고가 “본진만” 새는 것처럼 보였음.

② origin-trigger 부재 — 4노드 broadcast 가 본진 local 변화(behind/ahead)에만 의존

(flock 을 고쳐도) 기존 broadcast 게이트는 본진 local 이 pull/push 로 변할 때만 발동. 본진이 gh pr merge 후 수동 git pull 로 local 을 먼저 최신화하면 behind=0/ahead=0 → broadcast skip. origin/main(=전파해야 할 source)이 움직였는데 본진 local 부산물 기준이라 새는 갭.

③ broadcast 의 `merge --ff-only origin/main` 이 작업 브랜치 노드에서 실패

broadcast 가 노드에서 git merge --ff-only origin/main 을 현재 체크아웃 브랜치 HEAD 에 적용 → 라이덴/데스크탑처럼 작업 브랜치(prefix) 체크아웃 + dirty 면 diverge/dirty 로 실패(라이브 로그 Diverging branches can't be fast-forwarded / local changes would be overwritten). main ref 만 갱신해야 하는데 현재 브랜치를 건드리려다 실패.

조치 (모두 적용 + 라이브 검증)

flock → command -v flock 가드 (4개 hook) — flock 있을 때만 락(Linux 기존동작 불변), 없으면 진행(macOS 복원).
origin-trigger (stop-sync-automations) — ~/.claude/state/last-synced-automations-sha 에 마지막 전파 origin/main sha 기록, 매 본진 Stop 시 비교해 움직였으면 강제 broadcast(본진 <mac-host>* 한정 — 노드까지 주체면 mesh SSH 폭증). 의도적 안전장치라 DO NOT REMOVE 마커 + 본 이슈 참조 주석 포함. 격리 4/4 PASS.
broadcast 작업브랜치 안전화 — 노드에서 현재 브랜치가 main 이면 merge --ff-only, 아니면 fetch origin main:main 으로 local main ref 만 ff(작업 브랜치·working tree 보존).

라이브 검증: 본진에서 hook 실행 → 로그 origin/main moved (...), forcing 4-node broadcast → 5노드 전부 f195f69 일치(라이덴·데스크탑은 작업 브랜치 보존한 채 main ref 갱신).

잔여 (후속)

라이덴·데스크탑은 작업 브랜치 체크아웃이라 main ref 는 동기화됐지만 그 노드 working tree 의 hook 파일 자체는 작업 브랜치 버전. 새 hook working tree 반영은 그 2노드가 main 복귀/rebase 시. 단 노드(Linux)는 flock 있어 옛 hook 도 동작하고, 전파 주체는 본진이라 기능상 영향 없음.

교훈

Linux 전제 스크립트(flock 등 util-linux)를 macOS 본진에 깔면 silent fail 한다. || exit 0 같은 방어가 “명령 부재”까지 삼켜서 무동작이 정상처럼 보임. 이식성 명령은 command -v 가드 필수.
전파 트리거는 “전파해야 할 사실의 source(origin/main)” 기준이어야지 “전파 주체의 local 부산물(behind/ahead)” 기준이면 source 가 다른 경로로 갱신될 때 샌다.
5노드 mesh 에서 노드는 작업 브랜치에 자주 머물므로, 전파는 항상 “현재 브랜치 무관 main ref ff” 여야 한다.
자동 동기화는 “돌았다고 가정” 하지 말고 실제 로그·5노드 sha 일치로 검증해야 한다(이 사고도 장기 무동작이었을 가능성).