feat: config 파일을 CLI 설정 소스로 활용

[serithemage]

Summary

이슈 #19에서 요청한 config 명령 마무리:

• 누락 키(parser, llm.enabled, llm.provider, llm.model, llm.base_url, llm.timeout)을 hwp2md config set에서 처리
• convert 커맨드가 설정 파일을 실제로 읽어서 동작에 반영하도록 wire-up
• 우선순위 통일: CLI 플래그 > 환경 변수 > 설정 파일 > 코드 기본값

Why

기존에는 config show/init/set/path가 동작은 했지만, convert 명령은 환경변수만 보고 설정 파일을 무시했습니다. 이슈 #19의 핵심은 설정 파일을 신뢰 가능한 소스로 만드는 것입니다.

Changes

internal/config/config.go

• Config에 Parser string 필드와 LLM LLMConfig 그룹(Enabled/Provider/Model/BaseURL/Timeout) 추가
• 기존 default_provider, providers.*, format.*은 호환성 유지(YAML 태그에 omitempty)

internal/cli/config.go

• config set에 새 키 처리 추가, 각각 검증 적용:
  • parser — native/upstage만 허용
  • llm.enabled — strconv.ParseBool
  • llm.provider — 5종(openai/anthropic/gemini/upstage/ollama)
  • llm.model — 비어있지 않은 문자열
  • llm.base_url — url.Parse + scheme/host 검증
  • llm.timeout — time.ParseDuration + 양수 검사
• Long help/예시 갱신

internal/cli/convert.go

• loadAppConfig() — 설정 파일 로드, 실패 시 DefaultConfig() 폴백 (플래그/환경변수가 우선이라 안전)
• resolveString(flag, env, cfg, default) — 우선순위 헬퍼, 공백은 빈 값 취급
• parser, llm.enabled, llm.provider, llm.model, llm.base_url 5개 항목에 적용
• formatWithLLM이 *config.Config를 인자로 받도록 시그니처 확장

Tests

• internal/config/config_test.go — TestConfig_LLMRoundTrip (YAML 저장/복원)
• internal/cli/cli_test.go:
  • TestResolveString — flag/env/config/default 우선순위 6 케이스
  • TestRunConfigSet_NewKeys — 새 키 8개 × 성공/검증 실패 합 14 케이스 (HOME 격리 사용)

Docs

• CLAUDE.md — 우선순위 명시, config 키 표 추가

의도적 미포함

llm.timeout config 값을 실제 LLM 호출에 반영하는 wire-up은 PR #26 (fix/24-configurable-llm-timeout)에 의존합니다. #26 머지 후 follow-up 1줄 변경으로 결합 예정 — 본 PR에 포함하면 시그니처 충돌이 생겨 분리했습니다. 본 PR로도 config set llm.timeout 5m은 정상 저장/검증되며, #26이 머지되는 순간 설정 파일 값까지 자동 반영됩니다.

Test plan

• make fmt — no diff
• make lint — clean
• go test ./... — 전체 통과 (e2e 포함)
• hwp2md config init && config set parser/llm.* && config show round-trip 수동 확인
• 검증 실패 메시지 4종(parser bogus, llm.timeout abc, llm.base_url localhost:11434, llm.enabled yesno) 한국어 출력 확인
• 설정 파일이 없을 때 convert가 정상 동작(폴백) 확인

Closes #19
관련: #26 (timeout wire-up follow-up)

🤖 Generated with Claude Code