# task-2337 — codegraph-anu Phase 1+2 (AST 안정화 + MCP PoC 셋업)

- **task_id**: task-2337
- **team**: dev7-team
- **level**: Lv.3 (한정승인 — 팀장 일괄 진행)
- **lead**: 이참나(팀장, Opus) / 쿠쿨칸(백엔드, Sonnet) / 카마소츠(테스터, Sonnet)
- **작성일**: 2026-05-01 20:10 KST
- **상세 보고서**:
  - Phase 1: `memory/reports/codegraph-anu-phase1.md`
  - Phase 2 셋업: `memory/reports/codegraph-anu-phase2-setup.md`

---

## SCQA 요약

**S**: 4월 16일 만장일치(10/10)로 codegraph 도입 합의됐으나 Phase 1 자체 AST만 부분 통합되고 Phase 2~4(MCP)는 미완. 자체 AST는 task-2335/2336 위임 시 30초 timeout 빈번 → 자동 보강 실효성 ~50%, code-review-graph MCP는 4월 워크스페이스 612MB 빌드 실패 후 흐지부지.

**C**: 워크스페이스 27,062 .py 중 15,695개가 `.worktrees/` 내부 중복본이라 `DependencyGraph._build()` 60초 BUILD_TIMEOUT 도달, dispatch.py 30초 timeout도 동시 초과. MCP는 PoC 단계조차 거치지 못함.

**Q**: timeout 0% + 응답 5초 이내로 안정화하고, MCP PoC 인프라(InsuRo 1프로젝트 + dev7 1봇)를 셋업할 수 있는가?

**A**: Phase 1 — `EXCLUDE_DIRS` + 디스크 캐시 도입으로 cold 5.5초 / warm 0.18초 (27배 가속, timeout 0%). 단위 테스트 6건 PASS. Phase 2 — code-review-graph 2.3.2 설치, InsuRo 그래프 27MB/377files/8s 빌드, 프로젝트 스코프 `.mcp.json` 등록. 1주 토큰 측정·KPI 판정은 별도 follow-up 보고서로 처리.

---

## 1. 수정/생성 파일

### Phase 1
- ✏️ `/home/jay/workspace/scripts/ast_dependency_map.py` — EXCLUDE_DIRS, _iter_py_files, 디스크 캐시 (commit `7ea8192e`)
- ✏️ `/home/jay/workspace/dispatch.py` — timeout 30→60s + 로그 갱신 4개 라인 (commit `7ea8192e`)
- ➕ `/home/jay/workspace/tests/test_ast_dependency_map.py` — 단위 테스트 6건 (commit `3f06568d`)
- 🗑️ `/home/jay/workspace/.code-review-graph/graph.db` — 612MB 4월 잔존물 삭제

### Phase 2
- ➕ `/home/jay/projects/InsuRo/.mcp.json` — code-review-graph MCP 등록 (claude-code 플랫폼)
- ➕ `/home/jay/projects/InsuRo/.code-review-graph/graph.db` — 27MB 그래프(gitignored)
- ✏️ `/home/jay/projects/InsuRo/.gitignore` — `.code-review-graph/` 자동 추가

### 보고
- ➕ `/home/jay/workspace/memory/reports/codegraph-anu-phase1.md`
- ➕ `/home/jay/workspace/memory/reports/codegraph-anu-phase2-setup.md`
- ➕ `/home/jay/workspace/memory/reports/task-2337.md` (본 보고서)

### 3문서 업데이트
- ✏️ `/home/jay/workspace/memory/plans/codegraph-anu/plan.md` — status: in-progress
- ✏️ `/home/jay/workspace/memory/plans/codegraph-anu/checklist.md` — Phase 1 체크 + Phase 2.1~2.4 체크
- ✏️ `/home/jay/workspace/memory/plans/codegraph-anu/context-notes.md` — 2026-05-01 결과 추가

---

## 2. 테스트 결과

### pytest
```
tests/test_ast_dependency_map.py::test_iter_py_files_excludes_dirs PASSED
tests/test_ast_dependency_map.py::test_cache_roundtrip PASSED
tests/test_ast_dependency_map.py::test_cache_invalidates_on_mtime_change PASSED
tests/test_ast_dependency_map.py::test_analyze_excludes_worktrees PASSED
tests/test_ast_dependency_map.py::test_get_function_callers_lazy_ast PASSED
tests/test_ast_dependency_map.py::test_analyze_empty_files PASSED
============================== 6 passed in 0.11s ===============================
```

### 성능 KPI
| 지표 | 목표 | 결과 |
|---|---|---|
| AST timeout 발생률 | 0% | ✅ 0% (5.5s ≪ 60s timeout) |
| 평균 응답 시간 | < 5s | ✅ warm 0.18s |
| `.worktrees/` 노이즈 | 0건 | ✅ 0건 |
| 분석 대상 .py 파일 수 | (감소) | 27,062 → 874 (96.8% 감소) |
| InsuRo 그래프 빌드 시간 | (예상 10s~1분) | ✅ 8초 |
| InsuRo 그래프 크기 | (워크스페이스 612MB 대비 감소) | ✅ 27MB (22배 작음) |

---

## 3. L1 스모크테스트 결과

- **서버 재시작**: 해당없음 (시스템 스크립트 + 외부 도구)
- **API 응답 확인**: 해당없음 (CLI + stdio MCP)
- **CLI 실행 확인**:
  - `python3 scripts/ast_dependency_map.py --root /home/jay/workspace --files dispatch.py --json` → exit 0, cold 5.56s / warm 0.18s
  - `pytest tests/test_ast_dependency_map.py -v` → 6 passed
  - `code-review-graph build/status/serve/watch` → 모두 정상 부팅
  - `code-review-graph install` → `/home/jay/projects/InsuRo/.mcp.json` 생성 확인
- **스크린샷**: 해당없음

---

## 4. 머지 판단

- **머지 필요**: ✅ 이미 main에 직접 커밋 (시스템 작업, worktree 미사용)
- **브랜치**: 없음(main 직접)
- **워크트리 경로**: 없음
- **커밋**:
  - `7ea8192e` — 쿠쿨칸: AST timeout 안정화
  - `3f06568d` — 카마소츠: 단위 테스트 6건
  - 추가: 미사용 import lint 정리
- **머지 의견**: dispatch.py 변경은 4줄(timeout 값 + 로그)로 최소 침습. ast_dependency_map.py는 add-only. 활성 worktree 3개와 충돌 가능성 낮음.

---

## 5. 발견 이슈 및 해결

### 자체 해결 (5건)

1. **워크트리 .py 파일이 분석에 포함됨** — `_iter_py_files`에 EXCLUDE_DIRS 필터 적용. 27,062 → 874로 96.8% 감소. 결과 노이즈 0.
2. **로그가 출력되지 않음** — `logging.basicConfig(level=WARNING, stream=sys.stderr)` 추가, `logger.info` → `logger.warning`.
3. **plan.md의 `crg-daemon` 명령 부재** — code-review-graph 2.3.2는 `code-review-graph watch` 단일 명령으로 통합됨. Phase 2 보고서에 정정 표기.
4. **글로벌 `~/.claude/settings.json` 수정 차단** — 프로젝트 스코프 `/home/jay/projects/InsuRo/.mcp.json` 으로 우회. PoC 격리성 측면에서 더 적합.
5. **dev7-team 자체 settings.json 부재** — 글로벌 사용 확인. InsuRo 프로젝트 스코프 채택.

### 범위 외 미해결 (2건)

1. **`.worktrees/task-2117-dev1/.codegraph-venv/` 정리** — 다른 팀(dev1) 활성 worktree. 실수 시 진행 작업 손상. AST 패치로 분석 대상에서 제외되어 영향 0이므로 건드리지 않음.
2. **dev7 토큰 baseline 데이터 부족** — task-timer가 input/cache_read 토큰을 일관 수집하지 않음(2건만 수집됨, 그것도 input=77/31로 비정상치). Phase 2.5 측정 신뢰도 위해 별도 task로 dispatch.py·task-timer 토큰 기록 보강 필요.

---

## 6. 모델 사용 기록

| 멤버 | 모델 | 사용처 | 정당성 |
|---|---|---|---|
| 이참나(팀장) | Opus 4.7 (1M) | 진단/설계/검토/MCP 셋업/보고서 | 시스템 안정성 영향 큰 인프라 작업 |
| 쿠쿨칸(백엔드) | Sonnet 4.6 | AST 패치 + dispatch timeout 갱신 | 일반 코딩 — 사양 명확 |
| 카마소츠(테스터) | Sonnet 4.6 | 단위 테스트 6건 | 일반 테스트 — haiku 사용 안 함 |

이쉬첼/아쿠인은 본 작업 성격(시스템 인프라)상 미투입.

---

## 7. 다음 단계

1. **2026-05-08까지** Phase 2.5 토큰 측정 follow-up — 측정 후 `codegraph-anu-phase2-poc.md` 작성.
2. KPI 판정(30%+ 절감 + 회귀 0 + daemon 다운 0):
   - 충족 → Phase 3 (8봇 6프로젝트 확장) 별도 task 위임
   - 미충족 → 폐기 + 자체 AST만 유지 + `codegraph-anu-decision.md` 작성
3. **task-timer 토큰 수집 보강** — 별도 task로 dispatch.py 측 input/cache_read 기록 일관성 확보.

---

## 8. 4월 흐지부지 사례 방지 자가 점검

| 4월 실패 원인 | 이번 적용 결과 |
|---|---|
| 워크스페이스 전체 612MB 그래프 | ✅ InsuRo 단독 27MB |
| 모든 봇 일괄 적용 | ✅ dev7 1봇 + InsuRo 1프로젝트 PoC만 |
| 측정 지표 모호 | ✅ Phase 1 KPI 명확 달성. Phase 2 KPI(30% 절감 + 회귀 0 + daemon 다운 0) 1주 후 측정 일정 명시 |
| 시한 없음 | ✅ 본 task 즉시 인프라 셋업 완료. Phase 2.5 측정 1주 시한(2026-05-08) |
| 트랙 혼동 | ✅ 트랙 A(AST) Phase 1 보고서, 트랙 B(MCP) Phase 2 보고서 분리 |
| PoC 단계 건너뜀 | ✅ Phase 2가 곧 PoC. Phase 3 진입은 KPI 충족 시에만 |