# 고도화 Phase 1: 로깅 시스템 구축

## 배경
2/28 고도화 미팅 계획(memory/meetings/2026-02-28-개발팀-긴급-미팅-고도화-계획.md) Phase 1의 Task 1.2.
현재 운영 체계 점수 8/10 → 로깅 통합으로 추가 강화.

## 참조
- 고도화 스펙: /home/jay/workspace/memory/specs/dev-environment-spec.md
- 현재 Audit Trail: /home/jay/workspace/memory/logs/audit-trail.jsonl (PostToolUse hook 기반)
- 현재 로그 디렉토리: /home/jay/workspace/memory/logs/

## 구현 내용

### A. Python logging 모듈 통합
워크스페이스의 주요 Python 파일에 표준 logging 적용.

/home/jay/workspace/utils/logger.py 생성:
1. 공통 로거 설정 함수 (get_logger)
2. 로그 레벨: DEBUG, INFO, WARNING, ERROR
3. 로그 포맷: [시각] [레벨] [모듈명] 메시지
4. 콘솔 + 파일 핸들러 동시 출력
5. 로그 파일 경로: /home/jay/workspace/memory/logs/app.log
6. 로그 로테이션: RotatingFileHandler (10MB, 최대 5개 백업)

### B. 주요 모듈에 로깅 적용
다음 파일에 logger.py 연동:
1. /home/jay/workspace/dispatch.py
   - 위임 시작/완료 INFO 로깅
   - 에러 발생 시 ERROR 로깅
   - 환경변수 누락 시 WARNING 로깅
2. /home/jay/workspace/memory/task-timer.py
   - start/end/log 이벤트 INFO 로깅
   - 파일 읽기/쓰기 실패 시 ERROR 로깅

### C. 에러 추적 기능
/home/jay/workspace/utils/error_tracker.py 생성:
1. 에러 발생 시 자동으로 /home/jay/workspace/memory/logs/errors.jsonl에 기록
2. JSONL 형식: {"ts": "...", "module": "...", "error_type": "...", "message": "...", "traceback": "..."}
3. 최근 에러 조회 기능: python3 error_tracker.py --recent 10

### D. 테스트
1. logger.py가 app.log에 정상 기록하는지 확인
2. dispatch.py 실행 시 로그가 남는지 확인 (--help 실행)
3. 의도적 에러 발생 → errors.jsonl에 기록되는지 확인
4. 로그 로테이션 동작 확인 (파일 크기 제한)

## 주의사항
- 기존 dispatch.py, task-timer.py의 기능을 깨뜨리지 말 것
- print() 출력은 유지 (JSON 인터페이스). 로깅은 추가 레이어.
- source /home/jay/workspace/.env.keys 후 테스트할 것

## 완료 기준
- app.log에 로그 정상 기록
- errors.jsonl에 에러 추적 기록
- 기존 기능 정상 동작 (dispatch.py --help, task-timer.py --help)

## 보고서
/home/jay/workspace/memory/reports/ 에 저장.