---
prevention_deferred: null
summary: "메시지 연속 도착 시 launchd 자동 /clear 트리거가 fire 마다 abort 누적되어 한참 안 되던 busy-loop 사고"
---

# 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 우선)
1. **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 그대로 유지. 발화 성공 시 카운터 리셋.
2. 알림은 사람 의지 의존 최소화 — 강대종이 모르고 30분 대기하는 사고 차단(이번 건의 핵심).
3. (옵션) `~/.claude/automations/scripts/force-clear.sh` 추가 — idle 무시 강제 send-keys. 텔레그램 봇 트리거 "/force-clear" 호출 시 발화. 강대종 명시 호출 = 본인 책임이라 입력 중 박혀도 허용.
4. **(2026-05-13 강화) 자동 fallback 갈아타기 — 4 조건 명시**:
   - **(a)** 동일 marker/job 에서 abort 3회 누적 시 marker 재시도 **금지**. 4번째 fire 부터는 marker 경로 차단.
   - **(b)** 차단과 동시에 v0.8 fallback **즉시 발동**:
     ```bash
     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.
5. **(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)으로 강화.

## 관련 링크
- 트리거 코드: `~/.claude/hooks/session-clear-trigger.sh` (v2.2 → v2.6, 2026-05-16)
- 레스큐 코드: `~/.claude/hooks/session-clear-rescue.sh` (v2.2 → v2.3, 2026-05-16)
- launchd plist: `~/Library/LaunchAgents/com.daejongkang.session-clear-watcher.plist`
- 스킬: `~/claude-skills/session-clear/SKILL.md` (v2.0 → v2.1 1-touch, 2026-05-16)
- 로그: `/tmp/session-clear-trigger.log` (00:52~00:57 abort 5+회)
- 인접 이슈: `2026-05-09-clear-queued-during-processing.md` (다른 건 — 응답 처리 중 슬래시 큐잉, 정상 동작)
- 이전 fix 시퀀스: v2.1 → v2.2 (rm marker polling 후로 이동) → v2.5 (retry≥3 fallback) → v2.6 (polling 우회 + 항상 fallback, 영구 fix)
- 커밋: ssamssae/claude-skills 05ecc42, be7018f, 99c5684 (SKILL.md v2.1)
- 메모리: `feedback_session_clear_marker_busy_loop.md` (v2.6 1-touch 모드로 갱신)
- 텔레그램 메시지: 17519 (강대종 피드백) · 17520 (진단) · 17521 (진행 ack) · 17522 (완료 보고) · 17524-17527 (이슈 박제 컨펌)