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

# 계획서: task-1904

**task**: task-1904
**목표**: 인슈위키 정제 파이프라인에 체크포인트 정리 기능 추가
**승인**: 아누 (dispatch)
**근거**: 정제 완료 후 체크포인트 파일이 잔존하면 다음 정제 시 의도치 않은 복원이 발생

---

## 목표

`extract_knowledge_v2()` 정상 완료 시 체크포인트 파일(`checkpoint_threads.json`, `checkpoint_refined_threads.json`)을 자동 삭제하여 다음 정제가 깨끗한 상태에서 시작되도록 한다.

## 범위

### 포함
- `_cleanup_checkpoints()` 헬퍼 함수 추가
- LLM 경로 정제 완료 시 체크포인트 정리 호출
- 규칙 기반 경로 정제 완료 시 체크포인트 정리 호출
- 체크포인트 정리 단위 테스트 4건 추가

### 제외 (다음 페이즈 이후)
- 환경변수를 통한 체크포인트 보존 옵션 (현재 불필요)
- 정제 중간 실패 시 체크포인트 자동 정리 (실패 시 보존이 올바른 동작)

## 위임 계획

- 구현: **불칸(백엔드)** — `_cleanup_checkpoints` 함수 추가 + 호출부 2곳 삽입
- 테스트: **아르고스(테스터)** — 단위 테스트 4건 추가

## 검증 기준

- `grep -c "_cleanup_checkpoints" knowledge_extractor_v2.py` → 3건 (정의 1 + 호출 2)
- `pytest test_knowledge_extractor_v2.py` → 52건 전체 통과
- `pyright knowledge_extractor_v2.py` → 0 errors