chore: 품질 개선 (에러 메시지, 로깅, 진행 상황)

[serithemage]

개요

사용자 경험 향상을 위한 품질 개선

작업 범위

에러 메시지 개선

• 사용자 친화적인 에러 메시지
• 문제 해결 힌트 제공
• 에러 코드 체계화

로깅 추가

• slog 기반 구조화된 로깅
• 로그 레벨 지원 (debug, info, warn, error)
• --verbose / -v 플래그 추가
• 디버그 모드에서 상세 정보 출력

진행 상황 표시

• 긴 문서 변환 시 진행률 표시
• 대용량 파일 처리 시 피드백
• LLM 호출 중 대기 표시

예시

```bash

상세 로그 출력

hwp2md convert document.hwp -v

에러 시 힌트 제공

Error: ANTHROPIC_API_KEY not set
Hint: Set the API key with 'export ANTHROPIC_API_KEY=your-key'
or use --provider ollama for local LLM
```

관련 이슈

• Phase 5: 배포 및 안정화 #15 (Phase 5: 배포 및 안정화)에서 분리