맥미니 tmux liveness false-negative — healthy 노드를 votes+위임에서 제외

일시: 2026-05-30 ~09:30~10:00 KST
노드: 🍎 본진 (진단 주체) / 🏭 맥미니 (피해 노드)
증상: mesh-vote + codex-mesh-vote 양 vote 와 자동화 하드닝 노드 위임에서 본진이 맥미니를 “세션 꺼짐”으로 판정해 제외. 실제로는 맥미니 claude·codex tmux 세션 다 살아있고 codex REPL idle 상태였음.

근본 원인

본진이 노드 생존확인을 ssh 맥미니노드 'tmux has-session -t codex' / tmux ls 처럼 bare tmux 로 수행. 비대화형 ssh 는 ~/.zshrc/~/.zprofile 을 안 읽어 macOS(M1)의 /opt/homebrew/bin 이 PATH 에 없음 → tmux: command not found → command-not-found 를 “세션 없음” 으로 오판.

Linux 노드(🪟🖥💻)는 tmux 가 /usr/bin/tmux (비대화형에도 PATH) 라 우연히 동작 → macOS 노드만 함정.
choso API 기반 노드감지(work-steal-scan IDLE 목록)는 맥미니 정상 인식 → 버그는 tmux liveness 체크 패턴 한정.
풀패스 /opt/homebrew/bin/tmux ls 로 재확인하니 claude·codex 세션 다 보임.

기존 메모리 feedback_noninteractive_ssh_skips_bashrc (2026-05-20, WSL cc 오진) 의 교훈을 liveness 체크에 적용 안 한 본진 실수. 아니키 msg28344 “맥미니 세션 안 껴져있어 뭐지” → msg28345 “아까도 못잡더만 착각했어, 조치 필요”.

영향

양 vote(mesh-vote SID 1780101187 / codex-mesh-vote SID 1780100816) 가 4노드로 진행 (맥미니 제외). 결과 영향 없음 — 정족수(≥3) 충족 + 수렴 강해 맥미니 1표가 결론 안 바꿈. 재투표 불요.
자동화 하드닝 위임도 4노드 기준으로 분배 (실제 작업은 🪟+🖥 2노드라 맥미니 제외가 분배엔 무영향).

조치

메모리 feedback_node_liveness_full_tmux_path 박음 — liveness 체크는 macOS 풀패스 tmux 분기 / 또는 bash -ic.
자동화 하드닝 다음 라운드 항목으로 등록: mesh-vote·codex-mesh-vote·loop-fleet·codex-loop-fleet 전제조건 liveness 체크 예시를 노드 OS 별 tmux 풀패스로 분기 (tasks.md T-260530-04).

교훈

healthy 노드를 침묵으로 제외하기 전 풀패스 재확인 1회. command-not-found ≠ 세션 부재.

재발 이력

2026-06-07 ~10:46 KST: 본진이 advisor 와이어링 위임 대상 픽 중 ssh 맥미니노드 'tmux has-session -t claude' 로 맥미니를 “세션 부재”로 또 오판 → 솔로로 전환(빌드 자체는 무사고, synced repo). 맥미니 mac-report 실측(“claude 세션 Jun 6 18:52 생성, 활성”)이 정정. 비대화형 ssh PATH=/opt/homebrew/opt/openjdk@17/.../bin:/usr/bin:/bin:/usr/sbin:/sbin (homebrew 경로 없음) 실측 확인 — 같은 함정 3번째(2026-05-22·05-30·06-07). 기존 예방(메모리 룰 = “풀패스로 기억해서 쓰기”)이 사람-기억 의존이라 또 깨짐 → 코드 forcing function 으로 승격. 아니키 msg34241 “왜 꺼져있다 판단했는지 보고” + msg34244 “이슈박고 재발방지 아키텍처 만들어”.

예방 (강화 — 2026-06-07, 코드 forcing function)

막을 코드/훅: ~/claude-automations/scripts/node-session-check.sh (commit 7da11a2)
- 노드 세션 상태를 3-상태 로 반환: RUNNING(exit0) / ABSENT(exit1) / UNREACHABLE(exit3). tmux 바이너리 부재·ssh 실패는 ABSENT 가 아니라 UNREACHABLE — false-negative 를 구조적으로 차단(호출측이 UNREACHABLE 받으면 “꺼짐” 단정 금지).
- 내부에서 PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:$PATH 강제 prepend → macOS(homebrew)·Linux 둘 다 tmux not-found 차단. $PATH 보존.
- 회귀 테스트 scripts/tests/test_node_session_check.sh ALL PASS (ssh실패=UNREACHABLE / 미존재세션=ABSENT 분리 검증).
- 사용법: node-session-check.sh <ssh-alias|local> <session>. 노드 생존확인 시 bare tmux ... || 패턴 대신 이 헬퍼 경유가 표준.
메모리 feedback_node_liveness_full_tmux_path(2026-05-30) 는 룰 레벨 유지하되, 본 헬퍼가 “기억” 의존을 코드로 대체.