# task-1515.1 완료 보고서

## SCQA

**S**: BlogAuto 네이버 블로그 자동 발행 시스템이 운영 중이며, 발행 시 수동으로 NID_AUT/NID_SES 쿠키를 갱신해야 한다. 쿠키 만료 시 발행이 실패하고 수동 개입이 필요한 상황이다.

**C**: 네이버 쿠키는 주기적으로 만료되며, 만료 시점에 자동 발행 스케줄이 실패한다. 수동 로그인 + 쿠키 복사 과정이 반복적이고, 자동화 탐지를 우회하기 위한 사람 같은 입력 패턴이 필요하다.

**Q**: Playwright 기반으로 사람처럼 로그인하고 쿠키를 자동 갱신하여, 발행 전 투명하게 세션을 유지할 수 있는가?

**A**: `publisher/naver_login.py` 모듈을 구현하여 해결. 글자당 150~350ms 랜덤 딜레이 + 5~10% 오타/백스페이스 패턴으로 자동화 탐지를 우회하고, Chrome 프로필 세션 유지 + 쿠키 자동 추출 + .env.keys 및 session JSON 자동 업데이트를 구현했다. `NaverBlogPublisher.publish()` 호출 전 `_ensure_session()`으로 투명하게 통합 완료. pytest 29건 전체 통과.

## 작업 내용

### 신규 파일
- `publisher/naver_login.py` — 네이버 자동 로그인 + 쿠키 갱신 모듈 (471줄)
  - `human_type()`: 사람 타이핑 시뮬레이션 (150~350ms/글자, 5~10% 오타 + 백스페이스 정정)
  - `check_cookie_valid()`: httpx로 mylog 접속하여 쿠키 유효성 확인
  - `do_login()`: Playwright persistent context로 네이버 로그인 + 쿠키 추출
  - `update_env_keys()`: .env.keys 파일 NID_AUT/NID_SES 업데이트 (기존 키 보존)
  - `update_session_json()`: naver-session.json 쿠키 업데이트 (기존 포맷 유지)
  - `auto_login()`: 쿠키 체크 → 만료 시 자동 로그인 → 파일 업데이트 통합
  - CLI: `python3 -m publisher.naver_login [check|login|auto]`

- `tests/test_naver_login.py` — 단위 테스트 (16건)
  - TestHumanType (3건): 글자별 타이핑, 딜레이 범위, 오타+백스페이스
  - TestCheckCookieValid (3건): 유효/만료/네트워크 에러
  - TestUpdateEnvKeys (3건): 신규 생성/교체/기존 키 보존
  - TestUpdateSessionJson (2건): 기존 업데이트/신규 생성
  - TestDoLogin (2건): 로그인 플로우/이미 로그인 상태
  - TestAutoLogin (3건): 유효 쿠키 스킵/만료 시 로그인/실패 시 False

### 수정 파일
- `publisher/naver_blog.py` — 쿠키 자동 갱신 통합
  - `_ensure_session()` 메서드 추가 (lazy import로 Playwright 미설치 환경 호환)
  - `publish()` 메서드에 `self._ensure_session()` 호출 추가 (기존 인터페이스 변경 없음)
  - `save_draft()`는 내부적으로 `publish()` 호출하므로 자동 적용

## 산출물 파일

- `/home/jay/projects/BlogAuto/publisher/naver_login.py`
- `/home/jay/projects/BlogAuto/publisher/naver_blog.py`
- `/home/jay/projects/BlogAuto/tests/test_naver_login.py`

## 테스트 결과

- `tests/test_naver_login.py`: 16/16 PASSED (0.09s)
- `tests/test_naver_blog.py`: 13/13 PASSED (기존 테스트 회귀 없음)
- 전체 스위트: 75 passed, 3 failed (실패 3건은 기존 `test_tistory.py` — 본 작업 범위 외)

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **서브에이전트 Playwright lazy import 테스트 불가** — `_import_sync_playwright()` 헬퍼 함수 도입으로 patch 가능하게 구조 변경 (`naver_login.py:44`)
2. **서브에이전트 테스트 mock 불일치 다수** — random.sample 미설정, _load_credentials 미mock, auto_login positional/keyword 인자 불일치, mock_context.pages 미설정 등 6건 통합 수정 (`test_naver_login.py` 전면 재작성)
3. **pyright 미사용 import `re`/unreachable code** — `import re` 제거, `existing: Any` 타입 어노테이션 변경 (`naver_login.py:13,378`)

### 범위 외 미해결 (1건)
1. **test_tistory.py 기존 실패 3건** — 범위 외 사유: TistoryRateLimit/TistoryInitBlog 기존 테스트 이슈, 본 작업과 무관

## 모델 사용 기록

- 루(Lugh) / naver_login.py 핵심 모듈 구현 / sonnet
- 모리건(Morrigan) / test_naver_login.py 테스트 작성 / sonnet
- 루(Lugh) / naver_blog.py 쿠키 갱신 통합 / sonnet
- 다그다(팀장) / 코드 리뷰 + 통합 수정 + 보고서 / opus (직접 개입: 서브에이전트 코드 6건 mock 불일치 수정)