claude-telegram-bridge — 백그라운드 task-notification 턴의 보고가 텔레그램에 미러 안 됨

날짜: 2026-06-26 (KST)
노드: 🏭 맥미니 (claude-telegram-bridge, @ssamssae_claw_bot)
증상: 텔레그램에서 시킨 긴 작업(코덱스↔클로드 3왕복 토론) 중, 라운드2/라운드3/최종결론 보고가 아니키 폰에 안 도착. 아니키가 받은 마지막 메시지는 “라운드2 진행 중…잠깐만요”(백그라운드 폴링 시작 직전).

진단 (실측)

~/.claude/state/claude-telegram-bridge-macmini.outbox.json 의 sent_message_ids 타임스탬프를 보면 토론 구간 약 3시간(ts 1782447630 → 1782458995) 동안 outbox 전송이 거의 없음. 그 사이 터미널엔 라운드2/3/결론 텍스트를 여러 번 emit 했는데 실제 발송 0.
claude-telegram-bridge-egress.json: 세션별 claimed_turn_nonce 로 발송을 관리. 텔레그램 origin 턴은 nonce 를 claim 하지만, 백그라운드 명령 완료(<task-notification>)로 재진입한 턴은 텔레그램 origin 이 아니라 nonce 를 claim 안 함 → 그 턴의 Stop 텍스트가 미러 대상에서 빠짐.

근본 원인

긴 폴링을 run_in_background 로 돌리면, 완료 시 <task-notification> 으로 턴이 재진입한다. 이 턴은 텔레그램 user 메시지가 트리거가 아니라 내부 이벤트 트리거라, 브릿지가 “이 턴의 최종 텍스트를 어느 텔레그램 메시지의 답으로 보낼지” 매핑을 못 해 미러를 건너뛴다. 결과적으로 사용자-facing 보고가 터미널에만 남고 폰엔 안 감.

임시 복구 (2026-06-26 적용)

누락된 토론 결론을 Bot API sendMessage 직접 발송(봇 토큰 + chat_id <CHAT_ID>)으로 재전송 → ok:true 확인.

재발방지

행동 룰(즉시): 텔레그램-origin 작업 중에는 긴 대기/폴링을 run_in_background 로 돌려 task-notification 턴에 보고를 의존하지 말 것. 폴링은 foreground 의 bounded 턴으로 짧게 끊고, 백그라운드를 썼으면 핵심 보고는 텔레그램-origin 턴에서 다시 내거나 Bot API sendMessage 직접 발송으로 확정.
직접발송 fallback: 비-텔레그램-origin 턴에서 꼭 내보내야 할 보고는 mac-report 처럼 Bot API sendMessage 직접 경로 사용(미러 의존 X). 첫 줄에 [직접발송] 태그.
인프라(후속 task): 브릿지가 active 텔레그램 세션 내에서는 task-notification 등 비-origin Stop 이벤트의 최종 텍스트도 미러하도록(마지막 활성 chat 으로) 개선 검토. 단 이중송신/오발송 가드 필요.

교훈

“터미널에 보고 emit” ≠ “폰에 도착”. 브릿지 미러는 텔레그램-origin 턴 기준이라, 백그라운드/내부 트리거 턴은 사각.
긴 작업일수록 중간보고를 직접발송으로 확정하는 게 안전.