@llm-translate/cli 1.0.0-next.1

package/docs/ja/cli/dir.md

@@ -0,0 +1,243 @@
+# llm-translate dir
+
+::: info 翻訳について
+英語以外のドキュメントはすべてClaude Sonnet 4を使用して自動翻訳されています。
+:::
+
+ディレクトリ内のすべてのファイルを翻訳します。
+
+## 概要
+
+```bash
+llm-translate dir <input> <output> [options]
+```
+
+## 引数
+
+| 引数 | 説明 |
+|----------|-------------|
+|`<input>`| 入力ディレクトリパス（必須） |
+|`<output>`| 出力ディレクトリパス（必須） |
+
+## オプション
+
+### 言語オプション
+
+| オプション | デフォルト | 説明 |
+|--------|---------|-------------|
+|`-s, --source-lang <lang>`| 設定のデフォルト | ソース言語コード |
+|`-t, --target-lang <lang>`| 必須 | ターゲット言語コード |
+
+### 翻訳オプション
+
+| オプション | デフォルト | 説明 |
+|--------|---------|-------------|
+|`-g, --glossary <path>`| なし | 用語集ファイルのパス |
+|`-p, --provider <name>`|` claude`| LLMプロバイダー (claude\|openai\|ollama) |
+|`-m, --model <name>`| プロバイダーのデフォルト | モデル名 |
+|`--context <text>`| なし | 翻訳のための追加コンテキスト |
+
+### 品質オプション
+
+| オプション | デフォルト | 説明 |
+|--------|---------|-------------|
+|`--quality <0-100>`| 85 | 品質しきい値 |
+|`--max-iterations <n>`| 4 | 最大改良反復回数 |
+
+### ファイル選択
+
+| オプション | デフォルト | 説明 |
+|--------|---------|-------------|
+|`--include <patterns>`|`*.md,*.markdown`| 含めるファイルパターン（カンマ区切り） |
+|`--exclude <patterns>`| なし | 除外するファイルパターン（カンマ区切り） |
+
+### 処理オプション
+
+| オプション | デフォルト | 説明 |
+|--------|---------|-------------|
+|`--parallel <n>`| 3 | 並列ファイル処理 |
+|`--chunk-size <tokens>`| 1024 | チャンクあたりの最大トークン数 |
+|`--no-cache`| false | 翻訳キャッシュを無効化 |
+
+### 出力オプション
+
+| オプション | デフォルト | 説明 |
+|--------|---------|-------------|
+|`-f, --format <fmt>`| auto | 出力フォーマットを強制 (md\|html\|txt) |
+|`--dry-run`| false | 翻訳される内容を表示 |
+|`--json`| false | 結果をJSONで出力 |
+|`-v, --verbose`| false | 詳細ログを有効化 |
+|`-q, --quiet`| false | エラー以外の出力を抑制 |
+
+## 例
+
+### 基本的な使用方法
+
+```bash
+# Translate all markdown files
+llm-translate dir ./docs ./docs-ko -s en -t ko
+
+# With glossary
+llm-translate dir ./docs ./docs-ko -s en -t ko -g glossary.json
+```
+
+### ファイル選択
+
+```bash
+# Custom include pattern
+llm-translate dir ./docs ./docs-ko -s en -t ko --include "**/*.md"
+
+# Multiple patterns
+llm-translate dir ./docs ./docs-ko -s en -t ko --include "*.md,*.markdown,*.mdx"
+
+# Exclude certain directories
+llm-translate dir ./docs ./docs-ko -s en -t ko \
+  --exclude "node_modules/**,dist/**,drafts/**"
+```
+
+### 並列処理
+
+```bash
+# Process 5 files in parallel
+llm-translate dir ./docs ./docs-ko -s en -t ko --parallel 5
+
+# Sequential processing (for rate-limited APIs)
+llm-translate dir ./docs ./docs-ko -s en -t ko --parallel 1
+```
+
+### 品質設定
+
+```bash
+# High quality for important docs
+llm-translate dir ./docs ./docs-ko -s en -t ko --quality 95 --max-iterations 6
+
+# Faster processing with lower threshold
+llm-translate dir ./docs ./docs-ko -s en -t ko --quality 70 --max-iterations 2
+```
+
+### プレビューモード
+
+```bash
+# Show what would be translated
+llm-translate dir ./docs ./docs-ko -s en -t ko --dry-run
+```
+
+出力:
+```
+Dry run mode - no translation will be performed
+
+Files to translate:
+  getting-started.md → docs-ko/getting-started.md
+  guide/setup.md → docs-ko/guide/setup.md
+  api/reference.md → docs-ko/api/reference.md
+
+Total: 3 file(s)
+```
+
+## 出力構造
+
+ディレクトリ構造はデフォルトで保持されます：
+
+```
+Input:                     Output:
+docs/                      docs-ko/
+├── getting-started.md     ├── getting-started.md
+├── guide/                 ├── guide/
+│   ├── setup.md           │   ├── setup.md
+│   └── advanced.md        │   └── advanced.md
+└── api/                   └── api/
+    └── reference.md           └── reference.md
+```
+
+## 進捗レポート
+
+### 通常モード
+
+```
+ℹ Found 5 file(s) to translate
+ℹ Input: ./docs
+ℹ Output: ./docs-ko
+ℹ Target language: ko
+ℹ Parallel processing: 3 file(s) at a time
+[1/5] getting-started.md ✓
+[2/5] guide/setup.md ✓
+[3/5] guide/advanced.md ✓
+[4/5] api/reference.md ✓
+[5/5] api/types.md ✓
+
+────────────────────────────────────────────────────────
+  Translation Summary
+────────────────────────────────────────────────────────
+  Files:      5 succeeded, 0 failed
+  Duration:   45.2s
+  Tokens:     12,450 input / 8,320 output
+  Cache:      5,200 read / 2,100 write
+────────────────────────────────────────────────────────
+```
+
+### JSON出力
+
+```bash
+llm-translate dir ./docs ./docs-ko -t ko --json
+```
+
+```json
+{
+  "success": true,
+  "totalFiles": 5,
+  "successCount": 5,
+  "failCount": 0,
+  "totalDuration": 45234,
+  "tokensUsed": {
+    "input": 12450,
+    "output": 8320,
+    "cacheRead": 5200,
+    "cacheWrite": 2100
+  },
+  "files": [...]
+}
+```
+
+## ベストプラクティス
+
+### 1. まずプレビューを実行
+
+```bash
+llm-translate dir ./docs ./docs-ko -s en -t ko --dry-run
+```
+
+### 2. 適切な並列度を使用
+
+- レート制限のあるAPI:`--parallel 1-2`
+- 高い制限:`--parallel 5-10`
+- ローカル (Ollama):`--parallel 1`(モデル制限あり)
+
+### 3. 大規模プロジェクトの処理
+
+```bash
+# Split by subdirectory for better control
+llm-translate dir ./docs/guide ./docs-ko/guide -s en -t ko
+llm-translate dir ./docs/api ./docs-ko/api -s en -t ko
+```
+
+### 4. キャッシングの活用
+
+キャッシュにより変更されていないコンテンツをスキップできます：
+
+```bash
+# First run: translates all
+llm-translate dir ./docs ./docs-ko -s en -t ko
+
+# Second run: uses cache for unchanged content
+llm-translate dir ./docs ./docs-ko -s en -t ko
+```
+
+### 5. コンテンツタイプ別の品質設定
+
+```bash
+# High quality for user-facing docs
+llm-translate dir ./docs/public ./docs-ko/public -s en -t ko --quality 95
+
+# Standard quality for internal docs
+llm-translate dir ./docs/internal ./docs-ko/internal -s en -t ko --quality 80
+```

package/docs/ja/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/ja/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
+```