launchd 자동 /clear 트리거 abort 반복 — busy-loop 시 fire 마다 timeout

발생 일자: 2026-05-11 00:52 KST
해결 일자: 2026-05-16 08:37 KST (trigger.sh v2.6 / rescue.sh v2.3 / SKILL.md v2.1 영구 fix — polling 우회 + 1-touch 모드, 예방 5번 참고). 2026-05-11 00:57 의 “자연 idle 1회 발화” 는 구조적 fix 아님.
심각도: medium
재발 가능성: low (2026-05-16 v2.6 patch 후. 이전: high)
영향 범위: Mac 본진 launchd com.daejongkang.session-clear-watcher → ~/.claude/hooks/session-clear-trigger.sh (v2.2 → v2.6), 자동 /clear 파이프라인

증상

새 텔레그램 메시지가 연속 도착하는 동안 자동 /clear 트리거가 fire 마다 20초 idle 폴링 중 “esc to interrupt” 못 사라져 timeout abort. v2.2 fix 로 마커 파일은 abort 시 유지되지만, 결국 자연 idle 도래까지 5+회 abort 누적. 강대종 입장에서는 “/clear 가 한참 안 됨” 으로 보임.

로그(/tmp/session-clear-trigger.log):

[00:52:07] fired, marker=exists
[00:52:19] rescue: marker still exists after 15s, idle-check start
[00:52:28] timeout waiting for idle, abort
[00:52:41] rescue: timeout, abort
[00:54:00] fired, marker=exists
[00:54:20] timeout waiting for idle, abort
... (5+회 abort 반복) ...
[00:57:31] fired, marker=exists
[00:57:33] pane=%2 mode=0 ready(❯), sending /clear
[00:57:34] done

원인

v2.2 트리거가 tmux pane 캡처 결과에서 “esc to interrupt” 부재를 idle 시그널로 사용 (for i in $(seq 1 20); do sleep 1; ...). 텔레그램 메시지 도착 → 새 turn 시작 → busy 마커(“esc to interrupt”) 갱신. 메시지 간격이 20초 이내면 idle window 영원히 안 옴 → abort. rescue 스크립트도 같은 idle-check 로직 사용해 동시 abort.

v2.1 → v2.2 fix 는 “abort 시 마커 파일 보존”만 해결한 것 (이전엔 마커가 polling 전 rm 돼서 영원히 못 발화). 즉 “발화 못 함” 자체는 v2.2 에서도 그대로 남음. 결과적으로 자연 idle 갭이 생길 때까지 노이즈 abort 가 누적되며, 강대종이 그 사이 “안 됨” 으로 인지하게 됨.

조치

2026-05-11 00:57 KST: 자연 idle 도래로 v2.2 트리거가 /clear 1회 발화 성공. 즉시 코드 수정 없음 — 강대종이 직접 /clear 입력 또는 외부 tmux send-keys -t claude:0 -l '/clear' && tmux send-keys -t claude:0 Enter 우회 안내됨.

예방 (Forcing function 우선)

trigger v2.3 — retry counter + 텔레그램 알림: abort 시 /tmp/do-session-clear.retry 카운터 증가. 5회 누적 abort 시 텔레그램 1통 알림 (“자동 /clear N분째 fire 못 함. 직접 입력 또는 외부 tmux send-keys 필요”). 알림 본문에 외부 강제 명령(tmux send-keys -t claude:0 -l '/clear' && tmux send-keys -t claude:0 Enter) 한 줄 박아 long-press copy 즉시 우회 가능. 마커는 v2.2 그대로 유지. 발화 성공 시 카운터 리셋.
알림은 사람 의지 의존 최소화 — 강대종이 모르고 30분 대기하는 사고 차단(이번 건의 핵심).
(옵션) ~/.claude/automations/scripts/force-clear.sh 추가 — idle 무시 강제 send-keys. 텔레그램 봇 트리거 “/force-clear” 호출 시 발화. 강대종 명시 호출 = 본인 책임이라 입력 중 박혀도 허용.
(2026-05-13 강화) 자동 fallback 갈아타기 — 4 조건 명시:
- (a) 동일 marker/job 에서 abort 3회 누적 시 marker 재시도 금지. 4번째 fire 부터는 marker 경로 차단.
- (b) 차단과 동시에 v0.8 fallback 즉시 발동:
```
nohup bash -c "sleep 3 && \
  $TBIN send-keys -t $PANE -X cancel 2>/dev/null; \
  $TBIN send-keys -t $PANE C-u 2>/dev/null; \
  sleep 0.2; \
  $TBIN send-keys -t $PANE -l '/clear' 2>/dev/null; \
  sleep 0.3; \
  $TBIN send-keys -t $PANE Enter 2>/dev/null" \
  >/dev/null 2>&1 &
disown
```
  3초 detached delay 가 챗봇 turn 종료를 흡수 → marker polling 의 “esc to interrupt” 함정 회피.
- (c) fallback 발동 시 본 이슈 “재발 이력” 에 자동 한 줄 append: YYYY-MM-DD HH:MM KST: marker N회 abort → fallback 발동 (session=<sid> retry=<n>). trigger v2.3 retry counter 와 같은 파일(/tmp/do-session-clear.retry) 재활용해서 식별.
- (d) 챗봇 행동 룰: session-clear 스킬 실행 시 marker touch 와 Telegram reply 를 같은 turn 에서 묶지 말 것. 권장 흐름:
  1. Telegram reply (후속안 박은 결과 보고) → turn 종료
  2. 다음 turn 에서 marker touch 1줄만 — turn 직후 즉시 idle 진입 보장 SKILL.md 에 이 분리 절차를 명시. 단일 turn 안에서 묶으면 launchd watcher 가 같은 turn 의 “esc to interrupt” 잔존 구간에 걸려 무조건 abort.
(2026-05-16 영구 fix) trigger.sh v2.6 / rescue.sh v2.3 / SKILL.md v2.1 — polling 우회 + 1-touch 모드:
- trigger.sh v2.6 (~/.claude/hooks/session-clear-trigger.sh): 20초 idle 폴링 루프 전체 제거. marker 감지 즉시 nohup bash -c "sleep 3 && send-keys -X cancel; C-u; /clear; Enter" & disown 백그라운드 발사. 3초 detached delay 가 같은 turn 의 “esc to interrupt” 잔존 구간 통째 흡수 → polling 함정 root cause 영구 차단. retry 카운터 path obsolete.
- rescue.sh v2.3 (~/.claude/hooks/session-clear-rescue.sh): trigger.sh 와 동일 패턴. sleep 15 유지 (Stop hook 이 먼저 처리할 시간 양보).
- SKILL.md v2.1: “marker touch + reply 같은 turn 금지” 룰 폐기. 절차 3 = reply + typing daemon kill + touch /tmp/do-session-clear 같은 turn 진행 (1-touch 모드). 강대종이 두 번 트리거 안 해도 됨.
- 패치 노하우 (핵심): polling 으로 chatbot idle 기다리지 말고 nohup ... & disown 으로 부모(트리거 스크립트) 죽고 자식이 별도 PID 로 살아남는 패턴. 부모가 turn 종료 시점에 chatbot 의 PTY 점유 함정에 안 걸리려면 자식이 별도 세션 그룹에서 sleep 후 깨어나 send-keys 해야 함. 3초는 chatbot turn 종료(stop hook 처리 끝, esc to interrupt 사라짐)까지의 안전 마진.
- 코드 변경: claude-skills commits 05ecc42 · be7018f · 99c5684 (SKILL.md). hooks scripts 는 ~/.claude/hooks/ 에 직접 갱신 (별도 repo 아님). 백업: /tmp/session-clear-{trigger,rescue}.sh.bak-20260516-0837.
- 메모리: [[feedback_session_clear_marker_busy_loop]] v2.6 1-touch 모드로 갱신 (2026-05-16).

재발 이력

2026-05-13 21:06 KST: marker 4회 abort (20:52:54 retry=1, 20:53:05 retry=2, 21:05:01 retry=3, 21:05:12 retry=4) → 챗봇 수동 v0.8 fallback (nohup sleep 3 && send-keys) 발동 → 21:06:11 /clear 성공. root cause 동일(marker touch + Telegram reply 같은 turn 묶음 → “esc to interrupt” 20s polling 안에 안 풀림). 강대종 16314 메시지(“지금방금 성공함 세션클리어 2번 실패하고 3번째 성공한 이유 분석”) 후 박음. 본 재발 후 예방 섹션 4번 항목(자동 fallback 갈아타기 + turn 분리)으로 강화.
2026-05-15 23:34 KST: 강대종 “왜 두 번 클리어 해야 되지 첫번째에는 왜 안 되는거야” 피드백 (텔레그램 17519). root cause = SKILL.md v1.x 가 “marker touch + Telegram reply 같은 turn 묶음 금지” 룰을 강제 → 1차 트리거는 후속안 저장만 / 2차 트리거에서 marker touch + /clear 발사 설계. v0.8 fallback 은 retry≥3 누적해야 발동돼 실제로는 도달 X. 2026-05-16 영구 fix 박음 (예방 5번): trigger.sh v2.6 / rescue.sh v2.3 가 polling 자체 우회 + 항상 nohup 3s detached send-keys 발사 + SKILL.md v2.1 1-touch 모드. claude-skills commits 05ecc42 · be7018f · 99c5684. 본 재발 후 예방 섹션 5번 항목(영구 fix)으로 강화.