@llm-translate/cli 1.0.0-next.1

package/docs/cli/init.md

@@ -0,0 +1,158 @@
+# llm-translate init
+
+::: info Translations
+All non-English documentation is automatically translated using Claude Sonnet 4.
+:::
+
+Initialize configuration file for your project.
+
+## Synopsis
+
+```bash
+llm-translate init [options]
+```
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--provider`, `-p` | claude | Default provider |
+| `--model`, `-m` | varies | Default model |
+| `--quality` | 85 | Default quality threshold |
+| `--glossary` | none | Create glossary template |
+| `--force`, `-f` | false | Overwrite existing config |
+
+## Examples
+
+### Basic Initialization
+
+```bash
+llm-translate init
+```
+
+Creates `.translaterc.json`:
+
+```json
+{
+  "provider": {
+    "name": "claude",
+    "model": "claude-haiku-4-5-20251001"
+  },
+  "translation": {
+    "qualityThreshold": 85,
+    "maxIterations": 4
+  },
+  "paths": {}
+}
+```
+
+### With Provider
+
+```bash
+llm-translate init --provider openai --model gpt-4o
+```
+
+### With Glossary Template
+
+```bash
+llm-translate init --glossary
+```
+
+Also creates `glossary.json`:
+
+```json
+{
+  "sourceLanguage": "en",
+  "version": "1.0.0",
+  "terms": [
+    {
+      "source": "example",
+      "targets": {
+        "ko": "예시"
+      },
+      "context": "Replace with your terms"
+    }
+  ]
+}
+```
+
+### Custom Quality
+
+```bash
+llm-translate init --quality 95
+```
+
+## Interactive Mode
+
+Without options, init runs interactively:
+
+```
+$ llm-translate init
+
+llm-translate Configuration Setup
+
+? Select provider: (Use arrow keys)
+❯ claude
+  openai
+  ollama
+
+? Select model: (Use arrow keys)
+❯ claude-haiku-4-5-20251001 (fast, cost-effective)
+  claude-sonnet-4-5-20250929 (balanced)
+  claude-opus-4-5-20251101 (highest quality)
+
+? Quality threshold: (85)
+? Create glossary template? (y/N)
+
+✓ Created .translaterc.json
+```
+
+## Output Files
+
+### .translaterc.json
+
+```json
+{
+  "$schema": "https://llm-translate.dev/schema.json",
+  "provider": {
+    "name": "claude",
+    "model": "claude-haiku-4-5-20251001"
+  },
+  "translation": {
+    "qualityThreshold": 85,
+    "maxIterations": 4,
+    "preserveFormatting": true
+  },
+  "chunking": {
+    "maxTokens": 1024,
+    "overlapTokens": 150
+  },
+  "paths": {
+    "glossary": "./glossary.json",
+    "cache": "./.translate-cache"
+  }
+}
+```
+
+### glossary.json (with --glossary)
+
+```json
+{
+  "$schema": "https://llm-translate.dev/glossary-schema.json",
+  "sourceLanguage": "en",
+  "version": "1.0.0",
+  "description": "Project glossary",
+  "terms": []
+}
+```
+
+## Overwriting Existing Config
+
+```bash
+# Will fail if config exists
+llm-translate init
+# Error: .translaterc.json already exists. Use --force to overwrite.
+
+# Force overwrite
+llm-translate init --force
+```

package/docs/cli/serve.md

@@ -0,0 +1,211 @@
+# serve
+
+Start the translation API server for containerized deployment.
+
+## Usage
+
+```bash
+llm-translate serve [options]
+```
+
+## Description
+
+The `serve` command starts an HTTP server that exposes the translation engine as a REST API. This is ideal for:
+
+- Containerized deployments (Docker, Kubernetes)
+- Microservice architectures
+- Building translation services
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-p, --port <number>` | Server port | `3000` (or `TRANSLATE_PORT` env) |
+| `-H, --host <string>` | Host to bind | `0.0.0.0` |
+| `--no-auth` | Disable API key authentication | `false` |
+| `--cors` | Enable CORS for browser clients | `false` |
+| `--json` | Use JSON logging format (for containers) | `false` |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `TRANSLATE_PORT` | Server port (overridden by `--port`) |
+| `TRANSLATE_API_KEY` | API key for authentication |
+| `ANTHROPIC_API_KEY` | Claude API key |
+| `OPENAI_API_KEY` | OpenAI API key |
+| `OLLAMA_BASE_URL` | Ollama server URL |
+
+## API Endpoints
+
+### POST /translate
+
+Main translation endpoint.
+
+**Request Headers:**
+```
+Content-Type: application/json
+X-API-Key: your-api-key
+```
+
+Or use Bearer token:
+```
+Authorization: Bearer your-api-key
+```
+
+**Request Body:**
+```json
+{
+  "content": "Hello, world!",
+  "sourceLang": "en",
+  "targetLang": "ko",
+  "format": "text",
+  "mode": "balanced",
+  "glossary": [
+    { "source": "API", "target": "API", "doNotTranslate": true }
+  ]
+}
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `content` | string | Yes | Text to translate |
+| `sourceLang` | string | Yes | Source language code |
+| `targetLang` | string | Yes | Target language code |
+| `format` | string | No | `markdown`, `html`, or `text` (default) |
+| `mode` | string | No | `fast`, `balanced` (default), or `quality` |
+| `glossary` | array | No | Inline glossary terms |
+| `provider` | string | No | `claude`, `openai`, or `ollama` |
+| `model` | string | No | Model name |
+| `qualityThreshold` | number | No | Quality threshold (0-100) |
+| `maxIterations` | number | No | Max refinement iterations (1-10) |
+| `context` | string | No | Additional context for translation |
+
+**Response:**
+```json
+{
+  "translated": "안녕하세요, 세계!",
+  "quality": 92,
+  "iterations": 2,
+  "tokensUsed": {
+    "input": 156,
+    "output": 48
+  },
+  "duration": 2341,
+  "provider": "claude",
+  "model": "claude-sonnet-4-20250514"
+}
+```
+
+### GET /health
+
+Health check endpoint for container orchestration.
+
+**Response:**
+```json
+{
+  "status": "healthy",
+  "version": "0.1.0",
+  "uptime": 3600,
+  "providers": [
+    { "name": "claude", "available": true },
+    { "name": "openai", "available": false },
+    { "name": "ollama", "available": true }
+  ]
+}
+```
+
+### GET /health/live
+
+Simple liveness probe.
+
+```json
+{ "status": "ok" }
+```
+
+### GET /health/ready
+
+Readiness probe. Returns 503 if no providers are configured.
+
+```json
+{ "status": "ready" }
+```
+
+## HTTP Status Codes
+
+| Code | Description |
+|------|-------------|
+| 200 | Success |
+| 400 | Bad request (validation error) |
+| 401 | Unauthorized (missing/invalid API key) |
+| 404 | Not found |
+| 422 | Unprocessable entity (quality threshold not met) |
+| 429 | Too many requests (provider rate limited) |
+| 500 | Internal server error |
+| 502 | Bad gateway (provider error) |
+| 503 | Service unavailable (no providers available) |
+
+## Examples
+
+### Start server with defaults
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-xxxxx
+llm-translate serve
+```
+
+### Start with custom port and CORS
+
+```bash
+llm-translate serve --port 8080 --cors
+```
+
+### Start with JSON logging (for Docker)
+
+```bash
+llm-translate serve --json
+```
+
+### Start without authentication (internal use only)
+
+```bash
+llm-translate serve --no-auth
+```
+
+### Translate using curl
+
+```bash
+curl -X POST http://localhost:3000/translate \
+  -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
+  -d '{
+    "content": "Hello, world!",
+    "sourceLang": "en",
+    "targetLang": "ko"
+  }'
+```
+
+## Docker Deployment
+
+See [Docker Deployment Guide](../guide/docker) for detailed instructions.
+
+Quick start:
+
+```bash
+# Build image
+docker build -t llm-translate .
+
+# Run container
+docker run -d \
+  -p 3000:3000 \
+  -e ANTHROPIC_API_KEY=sk-ant-xxxxx \
+  -e TRANSLATE_API_KEY=your-api-key \
+  llm-translate
+```
+
+## Security Considerations
+
+1. **Always use authentication in production** - Set `TRANSLATE_API_KEY`
+2. **Use HTTPS** - Deploy behind a reverse proxy with TLS
+3. **Rate limiting** - Consider adding rate limiting at the proxy level
+4. **Network isolation** - Run in private networks when possible

package/docs/glossary.json

@@ -0,0 +1,235 @@
+{
+  "$schema": "../schemas/glossary.schema.json",
+  "metadata": {
+    "name": "llm-translate-docs",
+    "sourceLang": "en",
+    "targetLangs": ["ko", "ja", "zh"],
+    "version": "1.0.0",
+    "domain": "technical-documentation"
+  },
+  "terms": [
+    {
+      "source": "Chunking",
+      "targets": {},
+      "doNotTranslate": true,
+      "caseSensitive": false,
+      "context": "Document splitting strategy for translation"
+    },
+    {
+      "source": "Self-Refine",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Iterative quality improvement algorithm"
+    },
+    {
+      "source": "llm-translate",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Product name"
+    },
+    {
+      "source": "API",
+      "targets": {},
+      "doNotTranslate": true,
+      "caseSensitive": true
+    },
+    {
+      "source": "CLI",
+      "targets": {},
+      "doNotTranslate": true,
+      "caseSensitive": true
+    },
+    {
+      "source": "LLM",
+      "targets": {},
+      "doNotTranslate": true,
+      "caseSensitive": true
+    },
+    {
+      "source": "Claude",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "OpenAI",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "Ollama",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "Haiku",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Claude model tier"
+    },
+    {
+      "source": "Sonnet",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Claude model tier"
+    },
+    {
+      "source": "Opus",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Claude model tier"
+    },
+    {
+      "source": "GPT-4o",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "GPT-4o-mini",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "prompt caching",
+      "targets": {
+        "ko": "프롬프트 캐싱",
+        "ja": "プロンプトキャッシング",
+        "zh": "提示缓存"
+      },
+      "context": "Feature to cache repeated prompt content for cost reduction"
+    },
+    {
+      "source": "glossary",
+      "targets": {
+        "ko": "용어집",
+        "ja": "用語集",
+        "zh": "术语表"
+      },
+      "context": "Term dictionary for consistent translation"
+    },
+    {
+      "source": "llm-translate file",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "CLI command for single file translation"
+    },
+    {
+      "source": "llm-translate dir",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "CLI command for directory batch translation"
+    },
+    {
+      "source": "llm-translate init",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "CLI command for initialization"
+    },
+    {
+      "source": "llm-translate glossary",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "CLI command for glossary management"
+    },
+    {
+      "source": "quality threshold",
+      "targets": {
+        "ko": "품질 임계값",
+        "ja": "品質しきい値",
+        "zh": "质量阈值"
+      },
+      "context": "Minimum quality score required for translation"
+    },
+    {
+      "source": "token",
+      "targets": {
+        "ko": "토큰",
+        "ja": "トークン",
+        "zh": "令牌"
+      },
+      "context": "LLM text processing unit"
+    },
+    {
+      "source": "chunk",
+      "targets": {
+        "ko": "청크",
+        "ja": "チャンク",
+        "zh": "分块"
+      },
+      "context": "Document segment for translation"
+    },
+    {
+      "source": "provider",
+      "targets": {
+        "ko": "제공자",
+        "ja": "プロバイダー",
+        "zh": "提供商"
+      },
+      "context": "LLM service provider (Claude, OpenAI, etc.)"
+    },
+    {
+      "source": "Markdown",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "AST",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Abstract Syntax Tree"
+    },
+    {
+      "source": "JSON",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "TypeScript",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "Node.js",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "npm",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "stdin",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "stdout",
+      "targets": {},
+      "doNotTranslate": true
+    },
+    {
+      "source": "VitePress",
+      "targets": {},
+      "doNotTranslate": true,
+      "context": "Static site generator"
+    },
+    {
+      "source": "sidebar",
+      "targets": {
+        "ko": "사이드바",
+        "ja": "サイドバー",
+        "zh": "侧边栏"
+      },
+      "context": "Navigation panel on the side"
+    },
+    {
+      "source": "locale",
+      "targets": {
+        "ko": "로케일",
+        "ja": "ロケール",
+        "zh": "语言环境"
+      },
+      "context": "Language/region setting"
+    }
+  ]
+}