---
task_id: task-1932
type: plan
scope: task
created: 2026-04-17
updated: 2026-04-17
status: completed
---

# 계획서: task-1932

**task**: task-1932
**목표**: 카카오톡 정제 실시간 프로세스 모니터링 + Kill 기능 구현
**승인**: 제이회장님
**근거**: 프로세스 좀비 상태 오판 문제 + 서버 터미널 없이 Kill 불가 문제 해결

---

## 목표

1. 좀비 프로세스 감지 시 status를 "failed"로 변경 (현재 "cancelled")
2. 응답에 pid 필드 추가
3. `/api/wiki/refine/kill` 전용 엔드포인트 추가 (안전장치 포함)
4. 프론트엔드 폴링 주기 running=3초로 변경 (현재 2초)
5. UI에 PID 번호 표시 + 빨간색 "⏹ 중지" 버튼 + failed 상태 UI

## 범위

### 포함
- 백엔드: routes_get.py (status 응답 개선), routes_post.py (kill 엔드포인트), server.py (라우트 등록)
- 프론트엔드: InsuWikiView.js (폴링 주기, kill 버튼, PID 표시, failed UI)

### 제외 (다음 페이즈 이후)
- 정제 결과 리뷰 기능 변경 없음
- 정제 이력/resume 로직 변경 없음

## 위임 계획

- 백엔드 (kill 엔드포인트 + status 개선): **토르(sonnet)** — routes_post.py, routes_get.py 수정
- 프론트엔드 (폴링 + UI): **프레이야(sonnet)** — InsuWikiView.js 수정
- 라우트 등록: **토르(sonnet)** — server.py 수정

## 검증 기준

- kill 엔드포인트: `curl -X POST localhost:9822/api/wiki/refine/kill` → 400 (running 아닐 때)
- status 응답: `curl localhost:9822/api/wiki/refine/status` → pid, pidAlive 필드 존재
- 좀비 감지: status "running" + PID dead → "failed"로 자동 전환
- 폴링 주기: InsuWikiView.js에서 running=3000ms 확인