# task-1776.1 완료 보고서

## SCQA

**S**: 와치독(session-watchdog.sh)이 systemd timer로 2분마다 실행되며, STALLED 판정된 봇 세션을 자동 재위임하고 있다. 현재 69개 테스트 케이스가 전체 통과 중이며, 백오프/유예기간/에스컬레이션 로직이 안정적으로 동작한다.

**C**: STALLED 판정 시 원인 분석 없이 즉시 재위임하여, 반복 실패의 근본 원인을 추적할 수 없었다. 또한 `kill PID`만 수행하고 cokacdir 봇에 `/stop` 명령을 보내지 않아, 봇이 좀비 상태로 남아 새 세션과 충돌하는 문제가 있었다.

**Q**: 사망 원인 기록 + `/stop` 명령 추가로 재위임 프로세스의 안정성과 추적성을 확보할 수 있는가?

**A**: 3가지 개선을 적용하여 해결. (1) STALLED 판정 직후 사망 원인을 5가지 유형으로 분류하여 `watchdog-deaths.jsonl`에 JSONL 기록. (2) 재위임 전 cokacdir `--message "/stop"` 명령으로 봇 세션 종료 + 3초 대기. (3) 정리 순서를 `/stop → kill → cron-remove → timer-end`로 재배치. 69/69 테스트 전체 통과.

## 수정 내역

### 1. get_bot_username() 함수 추가
- team_id를 cokacdir key로 변환 후, `bot_settings_sync.json`에서 봇 username을 동적 조회

### 2. 사망 원인 분석 (STALLED 판정 직후)
- 5가지 원인 분류: `process_gone`, `no_schedule_id`, `heartbeat_stale_{N}s`, `context_limit`, `usage_limit`, `error_crash`, `unknown`
- JSONL 포맷: `{"task_id", "team", "reason", "timestamp", "heartbeat_age_s"}`
- 저장 위치: `memory/logs/watchdog-deaths.jsonl`

### 3. /stop 명령 + 정리 순서 변경
- 기존: cokacdir 스케줄 제거 → kill PID → task-timer end
- 변경: /stop 전송(+sleep 3) → kill PID → cokacdir 스케줄 제거 → task-timer end

## 산출물 파일 목록

- `/home/jay/workspace/scripts/session-watchdog.sh`
- `/home/jay/workspace/scripts/tests/test_session_watchdog.sh`

## 테스트 결과

bash 테스트 스위트: 69/69 통과 (0건 실패)
- 기존 TC1-TC14, BONUS: 전체 통과 (회귀 없음)
- 신규 TC15: get_bot_username 함수 검증 (4건 통과)
- 신규 TC16: JSONL 형식 검증 (6건 통과)
- 신규 TC17: /stop 명령 코드 존재 검증 (4건 통과)
- 신규 TC18: 정리 순서 검증 — /stop(288) → kill(300) → cron-remove(308) → timer-end(313) (4건 통과)

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **`get_cokacdir_key()` set -u 크래시 위험** — `${!var}` → `${!var:-}` 변경
   - `.env.keys`에 `COKACDIR_KEY_DEV3` 미정의 시, `set -u` 옵션으로 스크립트가 즉시 종료되는 잠재 버그
   - 수정: `session-watchdog.sh:34` — `${!var}` → `${!var:-}` (빈 문자열 반환)

### 범위 외 미해결 (1건)
1. **`.env.keys`에 COKACDIR_KEY_DEV3 미정의** — 범위 외 사유: 보안 키 파일 수정은 인프라/보안팀 소관. dev3-team의 와치독 /stop 및 cron-remove가 정상 동작하려면 해당 키 추가 필요.

## 모델 사용 기록

- 루(Lugh) / session-watchdog.sh 구현 / sonnet / -
- 모리건(Morrigan) / test_session_watchdog.sh 테스트 추가 / sonnet / -

## 세션 통계
- 총 도구 호출: 12회

### 수정 파일 목록
- /home/jay/workspace/scripts/tests/test_session_watchdog.sh: 6회 (Edit)
- /home/jay/workspace/scripts/session-watchdog.sh: 4회 (Edit)
- /home/jay/workspace/memory/reports/task-1776.1.md: 1회 (Write)
- /home/jay/workspace/memory/tasks/task-1776.1.md: 1회 (dispatch)

### 도구 사용 현황
- Edit: 10회
- Write: 1회
- dispatch: 1회