@llm-translate/cli 1.0.0-next.1

package/docs/ko/cli/file.md

@@ -0,0 +1,213 @@
+# llm-translate file
+
+::: info 번역
+모든 비영어 문서는 Claude Sonnet 4를 사용하여 자동으로 번역됩니다.
+:::
+
+단일 파일을 번역합니다.
+
+## 개요
+
+```bash
+llm-translate file <input> [output] [options]
+```
+
+## 인수
+
+| 인수 | 설명 |
+|----------|-------------|
+|`<input>`| 입력 파일 경로 (필수) |
+|`[output]`| 출력 파일 경로 (선택사항, 기본값은 stdout) |
+
+## 옵션
+
+### 번역 옵션
+
+| 옵션 | 기본값 | 설명 |
+|--------|---------|-------------|
+|`--source-lang `,`-s`| 필수 | 소스 언어 코드 |
+|`--target-lang `,`-t`| 필수 | 대상 언어 코드 |
+|`--glossary `,`-g`| 없음 | 용어집 파일 경로 |
+
+### 품질 옵션
+
+| 옵션 | 기본값 | 설명 |
+|--------|---------|-------------|
+|`--quality`| 85 | 품질 임계값 (0-100) |
+|`--max-iterations`| 4 | 최대 개선 반복 횟수 |
+|`--strict-quality`| false | 임계값 미달 시 실패 |
+|`--strict-glossary`| false | 용어집 용어 미적용 시 실패 |
+
+### 제공자 옵션
+
+| 옵션 | 기본값 | 설명 |
+|--------|---------|-------------|
+|`--provider `,`-p`| claude | 제공자 이름 |
+|`--model `,`-m`| 다양함 | 모델 식별자 |
+
+### 출력 옵션
+
+| 옵션 | 기본값 | 설명 |
+|--------|---------|-------------|
+|`--output `,`-o`| auto | 출력 파일 경로 |
+|`--format `,`-f`| auto | 출력 형식 강제 지정 (md\|html\|txt) |
+|`--dry-run`| false | 수행될 작업 표시 |
+|`--json`| false | 결과를 JSON으로 출력 |
+|`--verbose `,`-v`| false | 상세 로깅 활성화 |
+|`--quiet `,`-q`| false | 오류가 아닌 출력 억제 |
+
+### 고급 옵션
+
+| 옵션 | 기본값 | 설명 |
+|--------|---------|-------------|
+|`--no-cache`| false | 번역 캐시 비활성화 |
+|`--chunk-size`| 1024 | 청크당 최대 토큰 수 |
+|`--context`| 없음 | 번역을 위한 추가 컨텍스트 |
+
+## 예제
+
+### 기본 사용법
+
+```bash
+# Translate to Korean
+llm-translate file README.md -o README.ko.md -s en -t ko
+
+# With explicit output path
+llm-translate file README.md --output README.ko.md --source-lang en --target-lang ko
+
+# Specify source and target languages
+llm-translate file doc.md -o doc.ja.md --source-lang en --target-lang ja
+```
+
+### 용어집 사용
+
+```bash
+# Use glossary for consistent terminology
+llm-translate file api-docs.md -o api-docs.ko.md \
+  -s en -t ko \
+  --glossary glossary.json
+```
+
+### 품질 관리
+
+```bash
+# Higher quality threshold
+llm-translate file important.md -o important.ko.md \
+  -s en -t ko \
+  --quality 95 \
+  --max-iterations 6
+
+# Strict mode (fail if not met)
+llm-translate file legal.md -o legal.ko.md \
+  --source-lang en \
+  --target-lang ko \
+  --quality 95 \
+  --strict-quality
+```
+
+### 제공자 선택
+
+```bash
+# Use Claude Sonnet
+llm-translate file doc.md -o doc.ko.md \
+  -s en -t ko \
+  --provider claude \
+  --model claude-sonnet-4-5-20250929
+
+# Use OpenAI
+llm-translate file doc.md -o doc.ko.md \
+  -s en -t ko \
+  --provider openai \
+  --model gpt-4o
+```
+
+### stdin에서 입력
+
+```bash
+# Pipe content (uses stdin mode when no TTY)
+cat doc.md | llm-translate -s en -t ko > doc.ko.md
+
+# Use with other tools
+curl https://example.com/doc.md | llm-translate -s en -t ko
+```
+
+## 출력 형식
+
+### 일반 모드
+
+```
+✓ Translated README.md → README.ko.md
+  Quality: 92/85 (threshold met)
+  Duration: 3.2s
+```
+
+### 상세 모드
+
+```bash
+llm-translate file doc.md -o doc.ko.md --target ko --verbose
+```
+
+```
+ℹ Loading configuration...
+ℹ Provider: claude (claude-haiku-4-5-20251001)
+ℹ Parsing document...
+ℹ Chunks: 5
+ℹ Starting translation...
+
+[Chunk 1/5] Starting initial translation...
+[Chunk 1/5] Quality: 78/85
+[Chunk 1/5] Generating improvements...
+[Chunk 1/5] Quality: 91/85 ✓
+
+[Chunk 2/5] Starting initial translation...
+[Chunk 2/5] Quality: 88/85 ✓
+...
+
+✓ Translation complete
+  Quality: 89/85 (threshold met)
+  Iterations: avg 1.8
+  Tokens: 5,234 input / 6,456 output
+  Cache: 3,200 read / 800 written
+  Duration: 8.4s
+```
+
+## 언어 코드
+
+일반적인 언어 코드:
+
+| 코드 | 언어 |
+|------|----------|
+|`en`| 영어 |
+|`ko`| 한국어 |
+|`ja`| 일본어 |
+|`zh`| 중국어 (간체) |
+|`zh-TW`| 중국어 (번체) |
+|`es`| 스페인어 |
+|`fr`| 프랑스어 |
+|`de`| 독일어 |
+
+## 오류 처리
+
+### 파일을 찾을 수 없음
+
+```bash
+$ llm-translate file missing.md -s en -t ko
+Error: Could not read file 'missing.md'
+Exit code: 3
+```
+
+### 품질 기준 미달 (엄격 모드)
+
+```bash
+$ llm-translate file doc.md -o doc.ko.md -s en -t ko --quality 99 --strict-quality
+Error: Quality threshold not met: 94/99
+Exit code: 4
+```
+
+### API 오류
+
+```bash
+$ llm-translate file doc.md --target ko
+Error: Provider error: Rate limit exceeded
+Exit code: 5
+```

package/docs/ko/cli/glossary.md

@@ -0,0 +1,273 @@
+# llm-translate glossary
+
+::: info 번역
+모든 비영어 문서는 Claude Sonnet 4를 사용하여 자동으로 번역됩니다.
+:::
+
+일관된 용어 사용을 위한 용어집 파일을 관리합니다.
+
+## 개요
+
+```bash
+llm-translate glossary <subcommand> [options]
+```
+
+## 하위 명령어
+
+### list
+
+용어집의 모든 용어를 나열합니다.
+
+```bash
+llm-translate glossary list --glossary glossary.json
+```
+
+옵션:
+| 옵션 | 설명 |
+|--------|-------------|
+|`--glossary `,`-g`| 용어집 파일 경로 (필수) |
+|`--target `,`-t`| 대상 언어로 필터링 |
+|`--format `| 출력 형식:` table `,` json`|
+
+예시:
+
+```bash
+# List all terms
+llm-translate glossary list -g glossary.json
+
+# Filter by target language
+llm-translate glossary list -g glossary.json --target ko
+
+# JSON output
+llm-translate glossary list -g glossary.json --format json
+```
+
+출력:
+```
+Glossary: glossary.json (15 terms)
+
+Source          | Korean (ko)      | Japanese (ja)    | Flags
+----------------|------------------|------------------|-------
+component       | 컴포넌트         | コンポーネント    |
+prop            | 프롭             | プロップ          |
+state           | 상태             | ステート          |
+TypeScript      | -                | -                | DNT
+API             | -                | -                | DNT, CS
+
+DNT = Do Not Translate, CS = Case Sensitive
+```
+
+### validate
+
+용어집 파일 구조와 내용을 검증합니다.
+
+```bash
+llm-translate glossary validate --glossary glossary.json
+```
+
+옵션:
+| 옵션 | 설명 |
+|--------|-------------|
+|`--glossary `,`-g`| 용어집 파일 경로 (필수) |
+|`--strict`| 경고 시 실패 |
+
+예시:
+
+```bash
+# Basic validation
+llm-translate glossary validate -g glossary.json
+
+# Strict mode
+llm-translate glossary validate -g glossary.json --strict
+```
+
+출력:
+```
+Validating glossary.json...
+
+✓ Valid JSON structure
+✓ Required fields present
+✓ 15 terms found
+
+Warnings:
+  - Term "component" has no context
+  - Term "hook" missing Japanese translation
+
+✓ Validation passed (2 warnings)
+```
+
+### add
+
+용어집에 새 용어를 추가합니다.
+
+```bash
+llm-translate glossary add <source> [options]
+```
+
+옵션:
+| 옵션 | 설명 |
+|--------|-------------|
+|`--glossary `,`-g`| 용어집 파일 경로 (필수) |
+|`--target `| 대상 번역 (형식:` lang=value`) |
+|`--context`| 용어의 맥락 |
+|`--dnt`| "번역하지 않음"으로 표시 |
+|`--case-sensitive`| 대소문자 구분으로 표시 |
+
+예시:
+
+```bash
+# Add with translations
+llm-translate glossary add "container" \
+  -g glossary.json \
+  --target ko="컨테이너" \
+  --target ja="コンテナ"
+
+# Add do-not-translate term
+llm-translate glossary add "Kubernetes" \
+  -g glossary.json \
+  --dnt
+
+# Add with context
+llm-translate glossary add "instance" \
+  -g glossary.json \
+  --target ko="인스턴스" \
+  --context "Cloud computing instance"
+```
+
+### remove
+
+용어집에서 용어를 제거합니다.
+
+```bash
+llm-translate glossary remove <source> --glossary glossary.json
+```
+
+예시:
+
+```bash
+llm-translate glossary remove "deprecated-term" -g glossary.json
+```
+
+### update
+
+기존 용어를 업데이트합니다.
+
+```bash
+llm-translate glossary update <source> [options]
+```
+
+옵션:
+| 옵션 | 설명 |
+|--------|-------------|
+|`--glossary `,`-g`| 용어집 파일 경로 (필수) |
+|`--target`| 대상 번역 업데이트 |
+|`--context`| 맥락 업데이트 |
+|`--dnt`| 번역하지 않음 설정/해제 |
+
+예시:
+
+```bash
+# Update translation
+llm-translate glossary update "component" \
+  -g glossary.json \
+  --target ko="컴포넌트 요소"
+
+# Add context
+llm-translate glossary update "state" \
+  -g glossary.json \
+  --context "React component state"
+```
+
+### stats
+
+용어집 통계를 표시합니다.
+
+```bash
+llm-translate glossary stats --glossary glossary.json
+```
+
+출력:
+```
+Glossary Statistics: glossary.json
+
+Terms: 15
+  - With translations: 12
+  - Do not translate: 3
+
+Languages:
+  - Korean (ko): 12 terms
+  - Japanese (ja): 10 terms
+  - Chinese (zh): 8 terms
+
+Token estimate: ~450 tokens
+```
+
+### merge
+
+여러 용어집을 병합합니다.
+
+```bash
+llm-translate glossary merge \
+  --input glossary-a.json \
+  --input glossary-b.json \
+  --output merged.json
+```
+
+옵션:
+| 옵션 | 설명 |
+|--------|-------------|
+|`--input `,`-i`| 입력 용어집 파일들 (다중) |
+|`--output `,`-o`| 병합된 용어집 출력 |
+|`--strategy `| 충돌 해결:` first `,` last `,` error`|
+
+### export
+
+용어집을 다른 형식으로 내보냅니다.
+
+```bash
+llm-translate glossary export --glossary glossary.json --format csv
+```
+
+옵션:
+| 옵션 | 설명 |
+|--------|-------------|
+|`--format `| 내보내기 형식:` csv `,` tsv `,` xlsx`|
+|`--output `,`-o`| 출력 파일 경로 |
+
+## 모범 사례
+
+### 대규모 용어집 구성
+
+```bash
+# Split by domain
+glossaries/
+├── common.json      # Shared terms
+├── frontend.json    # UI terminology
+├── backend.json     # Server terminology
+└── devops.json      # Infrastructure terms
+
+# Merge for use
+llm-translate glossary merge \
+  -i glossaries/common.json \
+  -i glossaries/frontend.json \
+  -o project-glossary.json
+```
+
+### 버전 관리
+
+용어집을 버전 관리에 포함시킵니다:
+
+```bash
+git add glossary.json
+git commit -m "Add project glossary"
+```
+
+### 정기적인 유지보수
+
+```bash
+# Validate before commits
+llm-translate glossary validate -g glossary.json --strict
+
+# Review stats periodically
+llm-translate glossary stats -g glossary.json
+```

package/docs/ko/cli/index.md

@@ -0,0 +1,111 @@
+# CLI 참조
+
+::: info 번역
+모든 비영어 문서는 Claude Sonnet 4를 사용하여 자동으로 번역됩니다.
+:::
+
+llm-translate는 문서 번역을 위한 명령줄 인터페이스를 제공합니다.
+
+## 설치
+
+```bash
+npm install -g @llm-translate/cli
+```
+
+## 전역 옵션
+
+이 옵션들은 모든 명령에서 사용할 수 있습니다:
+
+| 옵션 | 설명 |
+|--------|-------------|
+|`--help `,`-h`| 도움말 표시 |
+|`--version `,`-V`| 버전 표시 |
+|`--verbose `,`-v`| 상세 출력 활성화 |
+|`--quiet `,`-q`| 필수가 아닌 출력 억제 |
+|`--config`| 설정 파일 경로 |
+
+## 명령
+
+### [file](./file)
+
+단일 파일을 번역합니다.
+
+```bash
+llm-translate file <input> [output] [options]
+```
+
+### [dir](./dir)
+
+디렉토리의 모든 파일을 번역합니다.
+
+```bash
+llm-translate dir <input> <output> [options]
+```
+
+### [init](./init)
+
+설정 파일을 초기화합니다.
+
+```bash
+llm-translate init [options]
+```
+
+### [glossary](./glossary)
+
+용어집 파일을 관리합니다.
+
+```bash
+llm-translate glossary <subcommand> [options]
+```
+
+## 빠른 예제
+
+```bash
+# Translate a file to Korean
+llm-translate file README.md -o README.ko.md -s en -t ko
+
+# Translate with glossary
+llm-translate file docs/guide.md -o docs/guide.ja.md \
+  -s en -t ja --glossary glossary.json
+
+# Batch translate a directory
+llm-translate dir ./docs ./docs-ko -s en -t ko
+
+# Initialize config
+llm-translate init --provider claude
+
+# Validate glossary
+llm-translate glossary validate glossary.json
+```
+
+## 종료 코드
+
+| 코드 | 설명 |
+|------|-------------|
+| 0 | 성공 |
+| 1 | 일반 오류 |
+| 2 | 잘못된 인수 |
+| 3 | 파일을 찾을 수 없음 |
+| 4 | 품질 임계값 미달 (엄격 모드) |
+| 5 | 제공자/API 오류 |
+| 6 | 용어집 검증 실패 |
+
+## 환경 변수
+
+```bash
+# API Keys
+ANTHROPIC_API_KEY=sk-ant-xxxxx
+OPENAI_API_KEY=sk-xxxxx
+OLLAMA_BASE_URL=http://localhost:11434
+```
+
+## 설정 우선순위
+
+설정은 다음 순서로 적용됩니다 (나중 설정이 이전 설정을 덮어씁니다):
+
+1. 내장 기본값
+2. 설정 파일 (`.translaterc.json`)
+3. 환경 변수
+4. CLI 인수
+
+자세한 내용은 [설정](../guide/configuration)을 참조하세요.