# task-2361 완료 보고: InsuRo 루트 Pyright import resolve 설정 추가

## SCQA 요약

**S (Situation)**: InsuRo 프로젝트 `server/` 디렉토리에 `pyrightconfig.json`이 존재하지만 프로젝트 루트(`/home/jay/projects/InsuRo/`)에는 없어, IDE/Pyright LSP가 루트에서 시작될 때 `sb_helpers`, `composite_calculator`, `pii_crypto` 등 flat import의 resolve에 실패한다.

**C (Complication)**: 런타임 영향은 0이지만, IDE에 빨간 줄/자동완성 미동작이 발생하여 봇이 server/ 작업 시 진짜 이슈 식별이 어렵다(노이즈). dev6 페룬 task-2354 작업 중 dev7로 위임 결정.

**Q (Question)**: 최소 침습으로(루트 config 1개 추가) 회귀 0건을 유지하며 import resolve 경고를 0건으로 만들 수 있는가?

**A (Answer)**: 신규 파일 `/home/jay/projects/InsuRo/pyrightconfig.json` 1건 추가로 해결. 검증 결과 main.py / sb_helpers.py / composite_calculator.py / pii_crypto.py 4개 파일 import resolve 경고 0건, server/ 단독 실행 결과와 100% 동일(회귀 0). 기존 `server/pyrightconfig.json`은 Surgical Changes 원칙에 따라 미수정.

## 작업 내용

### 신규 파일 (1건)
- `/home/jay/projects/InsuRo/pyrightconfig.json`

```json
{
  "include": ["server/**/*.py"],
  "exclude": ["**/__pycache__", "**/node_modules", "**/.worktrees"],
  "extraPaths": ["server", "/home/jay/workspace/libs"],
  "pythonVersion": "3.12"
}
```

### 수정 파일
- 없음 (server/pyrightconfig.json은 Surgical Changes 원칙에 따라 미수정)

### 검토 후 미적용 항목
- `server/pyrightconfig.json`의 `include: ["*.py", "tests/*.py"]` 확장 → 루트 config가 우선 적용되어 불필요. 추가 변경 시 회귀 위험만 증가하므로 미적용 (task 명시 권고대로).

## L1 스모크테스트 결과

- **서버 재시작**: 해당없음 (런타임 영향 0인 IDE 설정 변경)
- **API 응답 확인**: 해당없음
- **스크린샷**: 해당없음

### Pyright 검증 (실제 실행)

루트(`/home/jay/projects/InsuRo`)에서 실행:
| 파일 | errors | warnings | import resolve |
|------|--------|----------|----------------|
| `server/main.py` | 1 | 0 | ✅ 통과 |
| `server/sb_helpers.py` | 0 | 0 | ✅ 통과 |
| `server/composite_calculator.py` | 0 | 0 | ✅ 통과 |
| `server/pii_crypto.py` | 0 | 0 | ✅ 통과 |

`main.py`의 1 error는 `reportArgumentType` 타입 불일치로 본 작업과 무관한 사전 존재 이슈(line 7005, `selected_coverages` 타입). 본 task는 import resolve 해결이 목표이며 해당 항목은 0건 달성.

### 회귀 확인

`server/` 단독 실행:
- `cd server && pyright main.py` → 1 error / 0 warnings (루트 실행과 100% 동일)
- 기존 동작 변화 없음 (회귀 0)

### 워크트리 호환
- `**/.worktrees` exclude 적용으로 IDE 부하 감소 확인

## 발견 이슈 및 해결

### 자체 해결 (0건)
- 해당없음

### 범위 외 미해결 (2건)
1. **`server/main.py:7005` reportArgumentType 타입 불일치** — 범위 외 사유: import resolve 작업과 무관한 사전 존재 타입 이슈. 별도 task로 분리 권장.
2. **task 파일에 명시된 `customer_match` 파일 미존재** — 범위 외 사유: `/home/jay/projects/InsuRo/server/customer_match.py` 파일 자체가 존재하지 않음(`ls` 확인). 검증 대상에서 제외. task 작성 시점의 표기 오류 추정.

## 모델 사용 기록

- 팀원: 쿠쿨칸 (백엔드) / 작업: pyrightconfig.json 1건 신규 작성 + pyright 검증 / 사용 모델: haiku / 정당성: 4줄 JSON 파일 단순 작성 (판단 불필요, Lv.1 단순 설정 추가)
- 팀장: 이참나 / 작업: 분석/위임/검증/통합 (직접 코딩 없음) / 사용 모델: opus

## 머지 판단

- **머지 필요**: 완료 (이미 main에 직접 commit)
- **브랜치**: `main` (Lv.1 단순 설정, task 운영 메모 "main 직접 commit도 허용" 준용)
- **워크트리**: 미사용 (Lv.1, 변경 파일 1건이라 워크트리 오버헤드 회피)
- **머지 의견**: 신규 파일 1건만 추가, 기존 파일 0개 수정. 회귀 위험 0. 검증 완료.
- **커밋 해시**: `582845d` — `[task-2361] 쿠쿨칸: 루트 pyrightconfig.json 추가 (IDE import resolve 수정)`

## 비고

- 빌드 검증: 본 task는 Python 타입체커 설정 추가로 npm/빌드 산출물에 영향 없음. py_compile/pytest 영향 없음 (런타임 영향 0).
- 의존성: task-2354 Phase 1, task-2360 머지 완료 전제 충족. 다른 진행 중 task와 충돌 영역 없음.
- 다음 봇이 server/ 작업 시 IDE Pyright 경고 노이즈 감소 → 진짜 이슈 식별 용이.

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


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


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