@bonginkan/maria 4.2.17 → 4.2.18

package/README.md

@@ -1,4 +1,4 @@
-# MARIA - AI Development Platform v4.2.17
+# MARIA - AI Development Platform v4.2.18
 
 [![npm version](https://img.shields.io/npm/v/@bonginkan/maria.svg)](https://www.npmjs.com/package/@bonginkan/maria)
 [![License](https://img.shields.io/badge/license-Multi--tier-blue.svg)](LICENSE)
@@ -10,7 +10,7 @@
 
 > **Enterprise-grade AI development platform with 100% command availability and comprehensive fallback support**
 
-## 🚀 What's New in v4.2.17 (September 3, 2025)
+## 🚀 What's New in v4.2.18 (September 3, 2025)
 
 ### 🏗️ Build Status - All Systems Operational ✅
 - **CLI NPM Package**: ESM + CJS builds successful (2.02MB/1.16MB)
@@ -29,17 +29,10 @@
 - **Real-time Dashboard**: Live usage monitoring with WebSocket integration
 - **Firebase Functions**: Serverless backend with auto-scaling
 - **Enhanced Telemetry**: BigQuery analytics with Firestore sync
-
-### 🎯 Week 2 Enterprise Features
-- **Safety Evaluation** (`/safety/check`): PII detection, malicious content filtering
-- **Test Suite Execution** (`/evaluation/run`): Comprehensive testing with regression analysis
-- **Health Monitoring** (`/system/health`): System metrics, trend analysis, predictive alerts
-- **Performance Monitoring**: Real-time latency tracking and optimization
-- **Security Compliance**: RBAC, audit logging, quantum-resistant crypto
-**全V2参照の削除完了** - 180個以上のV2命名規則を完全に削除し、統一された命名規則を実現。SlashCommand、RecallCommand、RememberCommandなど全コマンドが標準命名に移行完了。
+**Complete removal of all V2 references** - Fully removed 180+ V2 naming conventions, achieving a unified naming scheme. All commands, including SlashCommand, RecallCommand, and RememberCommand, have migrated to the standard naming.
 
 ## 🔐 Admin Dashboard with IAP (2025-09-01)
-**エンタープライズ管理ダッシュボード** - Google Cloud Identity-Aware Proxy (IAP)による完全保護を実装。OAuth2.0認証、@bonginkan.aiドメイン制限、ロールベースアクセス制御により、セキュアな管理インターフェースを提供。
+**Enterprise admin dashboard** - Implemented full protection via Google Cloud Identity-Aware Proxy (IAP). Provides a secure admin interface with OAuth2.0 authentication, @bonginkan.ai domain restriction, and role-based access control.
 
 🌐 **Homepage**: [https://maria-code.ai/](https://maria-code.ai/)
 🛡️ **Admin Dashboard**: [https://admin.maria-code.ai/](https://admin.maria-code.ai/) (IAP Protected)
@@ -203,10 +196,10 @@ $ maria /evolve --review
 
 ## 🎉 NEW: VS Code Extension for MARIA CODE v3.8.0
 
-### 🚀 Complete VS Code Integration (2025年8月31日達成)
+### 🚀 Complete VS Code Integration (Achieved August 31, 2025)
 **Production-Ready VS Code Extension with Full AI Capabilities**
 
-#### ✨ VS Code拡張機能の主要機能
+#### ✨ Key Features of the VS Code Extension
 - **🤖 Natural Language Code Generation**: Generate, modify, and fix code with AI
 - **🎨 AI Image Generation**: Create images directly in VS Code (Imagen 4.0)
 - **🎬 AI Video Generation**: Generate videos up to 60 seconds (Veo 2.0)
@@ -234,7 +227,7 @@ $ maria /evolve --review
 - **Week 3**: REST API fallback system ✅
 - **Week 4**: Marketplace publishing & production deployment ✅
 
-**[詳細な日本語導入マニュアル](#vs-code拡張機能導入マニュアル)**
+**[Detailed Setup Guide](#vs-code-extension-setup-guide)**
 
 ## ⭐ **NEW: v4.1.4 Revolutionary Features**
 
@@ -288,7 +281,7 @@ $ maria /evolve --review
 # Multilingual code generation
 /multilingual translate --from=python --to=typescript
 /language set japanese         # Set interface language
-/code 日本語でReactコンポーネントを作成 # Japanese natural language
+/code create a React component (example of Japanese prompt) # Japanese natural language
 /code créer une API REST       # French natural language
 ```
 
@@ -558,22 +551,22 @@ pnpm generate:manifest # → Auto-update READY commands ✅
 
 ## 📈 Telemetry & Analytics (Production Ready)
 
-### BigQuery テレメトリシステム
-**エンタープライズグレードの利用分析とモニタリング** - BigQuery による本番環境対応のテレメトリシステムを実装。リアルタイムコマンド追跡、エラー分析、パフォーマンス監視を提供。
+### BigQuery Telemetry System
+**Enterprise-grade usage analytics and monitoring** - Production-ready telemetry system using BigQuery. Provides real-time command tracking, error analysis, and performance monitoring.
 
-#### テレメトリ機能
-- **コマンド実行追跡**: 全コマンドの成功/失敗を記録
-- **レイテンシ分析**: P95レスポンス時間の監視
-- **エラー率モニタリング**: コマンド別エラー率の追跡
-- **プラン別利用分析**: Free/Starter/Pro/Ultraの利用分布
-- **レート制限分析**: API制限到達率の監視
+#### Telemetry Features
+- **Command Execution Tracking**: Record success/failure for all commands
+- **Latency Analysis**: Monitor P95 response times
+- **Error Rate Monitoring**: Track error rates per command
+- **Plan Usage Analysis**: Distribution across Free/Starter/Pro/Ultra plans
+- **Rate Limit Analysis**: Monitor API limit reach rate
 
-#### 運用コマンド
+#### Operations Commands
 ```bash
-# テレメトリテスト
+# Telemetry test
 npx tsx scripts/test-bigquery-telemetry.ts
 
-# 日次ヘルスチェック
+# Daily health check
 bq query --use_legacy_sql=false "
   SELECT cmd, status, COUNT(*) as count, 
     ROUND(AVG(latencyMs), 1) as avg_latency
@@ -582,7 +575,7 @@ bq query --use_legacy_sql=false "
   GROUP BY cmd, status
 "
 
-# エラー率確認
+# Check error rate
 bq query --use_legacy_sql=false "
   SELECT cmd, 
     ROUND(COUNTIF(status = 'error') * 100.0 / COUNT(*), 2) as error_rate
@@ -593,42 +586,42 @@ bq query --use_legacy_sql=false "
 "
 ```
 
-#### ダッシュボード
-- **Looker Studio統合**: リアルタイムダッシュボード
-- **5つの主要メトリクス**: エラー率、P95レイテンシ、レート制限、プラン分布、バージョン健全性
-- **アラート設定**: 閾値超過時の自動通知
+#### Dashboard
+- **Looker Studio Integration**: Real-time dashboard
+- **Five Key Metrics**: Error rate, P95 latency, rate limits, plan distribution, version health
+- **Alerting**: Automatic notifications when thresholds are exceeded
 
 ## 🔐 Secret Manager Integration (Production Ready)
 
 ### Google Cloud Secret Manager
-**エンタープライズグレードのシークレット管理** - APIキーとセンシティブデータの安全な保管と管理を実現。環境変数の代わりにSecret Managerを使用することでセキュリティを大幅に向上。
+**Enterprise-grade secret management** - Secure storage and management of API keys and sensitive data. Using Secret Manager instead of environment variables significantly improves security.
 
-#### 管理対象シークレット
-- **groq-api-key**: Groq AI APIキー (Fast Inference)
-- **openai-api-key**: OpenAI APIキー
-- **anthropic-api-key**: Anthropic Claude APIキー
-- **google-ai-api-key**: Google AI APIキー
+#### Managed Secrets
+- **groq-api-key**: Groq AI API key (Fast Inference)
+- **openai-api-key**: OpenAI API key
+- **anthropic-api-key**: Anthropic Claude API key
+- **google-ai-api-key**: Google AI API key
 
-#### Secret Manager利用方法
+#### How to Use Secret Manager
 ```bash
-# シークレット一覧確認
+# List secrets
 gcloud secrets list
 
-# シークレット作成
+# Create a secret
 echo -n "YOUR_API_KEY" | gcloud secrets create SECRET_NAME --data-file=-
 
-# シークレットアクセス
+# Access a secret
 gcloud secrets versions access latest --secret="SECRET_NAME"
 
-# IAM権限付与（サービスアカウント用）
+# Grant IAM permissions (for service accounts)
 gcloud secrets add-iam-policy-binding SECRET_NAME \
   --member="serviceAccount:SERVICE_ACCOUNT@PROJECT.iam.gserviceaccount.com" \
   --role="roles/secretmanager.secretAccessor"
 ```
 
-#### コード実装
+#### Code Implementation
 ```typescript
-// Secret Manager自動統合
+// Secret Manager automatic integration
 // src/providers/manager.ts
 const secretManager = new SecretManagerIntegration({
   projectId: 'maria-code-470602',
@@ -640,16 +633,16 @@ const secretManager = new SecretManagerIntegration({
   }
 });
 
-// 自動フォールバック
-// 1. Secret Manager → 2. 環境変数 → 3. デフォルト値
+// Automatic fallback
+// 1. Secret Manager → 2. Environment variables → 3. Default values
 ```
 
-#### セキュリティメリット
-- **中央管理**: すべてのAPIキーをCloud Consoleで一元管理
-- **アクセス制御**: IAMによる細かい権限管理
-- **監査ログ**: 全アクセス履歴の自動記録
-- **ローテーション**: APIキーの簡単な更新
-- **暗号化**: 保存時・転送時の自動暗号化
+#### Security Benefits
+- **Centralized Management**: Manage all API keys centrally in Cloud Console
+- **Access Control**: Fine-grained permissions via IAM
+- **Audit Logs**: Automatic recording of all access history
+- **Rotation**: Easy API key rotation
+- **Encryption**: Automatic encryption at rest and in transit
 
 ### Performance & Developer Experience
 | System | Before | After v4.0.0 | Improvement |
@@ -735,10 +728,10 @@ await secureWorkflow.executeWithAuth(workflowDefinition, securityContext);
 ### Quick Installation
 ```bash
 # Install globally (recommended)
-npm install -g @bonginkan/maria@4.2.17
+npm install -g @bonginkan/maria@4.2.18
 
 # Verify installation
-maria --version  # Should show v4.2.17
+maria --version  # Should show v4.2.18
 
 # Initialize with authentication
 maria /login     # Setup OAuth2.0 + PKCE authentication
@@ -846,7 +839,7 @@ gcloud run deploy --set-secrets="GOOGLE_CLIENT_ID=google-client-id:latest,..."
 | **OAuth client ID mismatch** | Inconsistent values across systems | Run `./scripts/oauth-verification.sh` to identify issues |
 
 #### Production Deployment Success
-**Real deployment results** (2025年9月1日):
+**Real deployment results** (September 1, 2025):
 - **maria-landing-page**: ✅ Running - https://maria-code.ai
 - **auth-server**: ✅ Running - OAuth2.0 + PKCE authentication functional  
 - **discord-bot**: ✅ Running - Full Discord API integration active
@@ -939,7 +932,7 @@ MARIA CODE is distributed under a comprehensive licensing system designed for in
 
 *MARIA v4.1.4 represents the pinnacle of multimodal AI development platform evolution - combining revolutionary voice-to-code capabilities, advanced memory systems, and comprehensive command ecosystems with enterprise-grade security and performance. This release establishes MARIA as the definitive choice for developers and Fortune 500 enterprises seeking intelligent, multimodal development experiences with GraphRAG intelligence, multilingual support, and zero-anxiety coding workflows.*
 
-**Transform your development experience today**: `npm install -g @bonginkan/maria@4.2.17`
+**Transform your development experience today**: `npm install -g @bonginkan/maria@4.2.18`
 
 🌐 **Official Website**: [https://maria-code.ai](https://maria-code.ai)  
 💬 **Community**: [https://discord.gg/SMSmSGcEQy](https://discord.gg/SMSmSGcEQy)  
@@ -948,291 +941,257 @@ MARIA CODE is distributed under a comprehensive licensing system designed for in
 
 ---
 
-## 📚 VS Code拡張機能導入マニュアル
-
-### 🎯 MARIA CODE VS Code拡張機能 - 完全ガイド
-
-#### 📦 インストール方法
-
-##### 方法1: VS Codeマーケットプレイスから（推奨）
-```bash
-1. VS Codeを開く
-2. 拡張機能サイドバーを開く (Ctrl+Shift+X / Cmd+Shift+X)
-3. "MARIA CODE Assistant" を検索
-4. 「インストール」をクリック
-```
+## 📚 VS Code Extension Setup Guide
 
-##### 方法2: VSIXファイルから手動インストール
-```bash
-1. 最新のVSIXファイルをダウンロード
-   https://github.com/bonginkan/maria/releases
+### 🎯 MARIA CODE VS Code Extension - Complete Guide
 
-2. VS Codeでコマンドパレットを開く
-   Ctrl+Shift+P (Mac: Cmd+Shift+P)
+#### 📦 Installation Methods
 
-3. "Extensions: Install from VSIX" を入力
+##### Method 1: From VS Code Marketplace (Recommended)
+1. Open VS Code
+2. Open the Extensions sidebar (Ctrl+Shift+X / Cmd+Shift+X)
+3. Search for "MARIA CODE Assistant"
+4. Click "Install"
 
-4. ダウンロードしたVSIXファイルを選択
-```
+##### Method 2: Manual installation from VSIX
+1. Download the latest VSIX file
+    https://github.com/bonginkan/maria/releases
+2. Open the Command Palette in VS Code
+    Ctrl+Shift+P (Mac: Cmd+Shift+P)
+3. Type "Extensions: Install from VSIX"
+4. Select the downloaded VSIX file
 
-#### 🔐 認証設定
+#### 🔐 Authentication Settings
 
-##### オプション1: CLIモード（全機能利用可能）
+##### Option 1: CLI Mode (Full feature access)
 ```bash
-# MARIA CLIをインストール
+# Install MARIA CLI
 npm install -g @bonginkan/maria
 
-# MARIAにログイン
+# Log in to MARIA
 maria /login
 
-# 認証状態を確認
+# Check authentication status
 maria auth status
 ```
 
-##### オプション2: REST APIモード（CLIなしで利用可能）
-```bash
-1. コマンドパレットを開く (Ctrl+Shift+P)
-2. "MARIA: Login to MARIA" を実行
-3. ブラウザで認証を完了
-```
+##### Option 2: REST API Mode (usable without CLI)
+1. Open the Command Palette (Ctrl+Shift+P)
+2. Run "MARIA: Login to MARIA"
+3. Complete authentication in the browser
 
-#### ⚡ 基本的な使い方
+#### ⚡ Basic Usage
 
-##### コード生成
-```bash
-# ショートカット: Ctrl+Alt+M (Mac: Cmd+Alt+M)
-# 自然言語でコードを生成
-例: "ユーザー認証機能を実装して"
-```
+##### Code Generation
+# Shortcut: Ctrl+Alt+M (Mac: Cmd+Alt+M)
+# Generate code in natural language
+Example: "Implement user authentication"
 
-##### 画像生成
-```bash
-# ショートカット: Ctrl+Alt+I (Mac: Cmd+Alt+I)
-# AIで画像を生成
-例: "モダンなダッシュボードのUIデザイン"
-```
-
-##### ビデオ生成
-```bash
-# ショートカット: Ctrl+Alt+V (Mac: Cmd+Alt+V)
-# AIでビデオを生成
-例: "コードが書かれていくアニメーション"
-```
-
-#### ⚙️ 設定カスタマイズ
-
-VS Code設定（Ctrl+,）で「maria」を検索：
-
-| 設定項目 | デフォルト値 | 説明 |
-|---------|------------|------|
-| `maria.useCLI` | `true` | CLIを優先使用 |
-| `maria.apiUrl` | 自動設定 | REST APIエンドポイント |
-| `maria.autoSave` | `true` | 生成コンテンツを自動保存 |
-| `maria.showProgress` | `true` | 進捗通知を表示 |
-
-#### 🎨 画像生成設定
-
-| 設定項目 | デフォルト | オプション |
-|---------|----------|-----------|
+##### Image Generation
+# Shortcut: Ctrl+Alt+I (Mac: Cmd+Alt+I)
+# Generate images with AI
+Example: "Modern dashboard UI design"
+
+##### Video Generation
+# Shortcut: Ctrl+Alt+V (Mac: Cmd+Alt+V)
+# Generate videos with AI
+Example: "Animation of code being written"
+
+#### ⚙️ Settings Customization
+In VS Code Settings (Ctrl+,), search for "maria":
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `maria.useCLI` | `true` | Prefer using CLI |
+| `maria.apiUrl` | Auto-detected | REST API endpoint |
+| `maria.autoSave` | `true` | Automatically save generated content |
+| `maria.showProgress` | `true` | Show progress notifications |
+
+#### 🎨 Image Generation Settings
+| Setting | Default | Options |
+|---------|---------|---------|
 | `maria.imageDefaults.size` | `1024x1024` | 256x256, 512x512, 1024x1024, 1792x1024, 1024x1792 |
 | `maria.imageDefaults.quality` | `standard` | standard, hd |
 | `maria.imageDefaults.style` | `vivid` | vivid, natural |
 
-#### 🎬 ビデオ生成設定
-
-| 設定項目 | デフォルト | オプション |
-|---------|----------|-----------|
+#### 🎬 Video Generation Settings
+| Setting | Default | Options |
+|---------|---------|---------|
 | `maria.videoDefaults.resolution` | `1080p` | 720p, 1080p, 4k |
 | `maria.videoDefaults.fps` | `30` | 24, 30, 60 |
 
-#### 🔧 トラブルシューティング
-
-##### よくある問題と解決方法
-
-**🚨 "MARIA CLIが見つかりません"**
+#### 🔧 Troubleshooting
+##### Common issues and solutions
+**🚨 "MARIA CLI not found"**
 ```bash
-# CLIをインストール
+# Install the CLI
 npm install -g @bonginkan/maria
 
-# または設定でCLIモードを無効化
+# Or disable CLI mode in settings
 "maria.useCLI": false
 ```
 
-**🔐 "認証に失敗しました"**
+**🔐 "Authentication failed"**
 ```bash
-# ターミナルで再ログイン
+# Re-login in the terminal
 maria /login
 
-# またはコマンドパレットから
+# Or from the Command Palette
 "MARIA: Login to MARIA"
 ```
 
-**⚡ "生成が遅い"**
-- CLI/APIモードを切り替えてみる
-- インターネット接続を確認
-- より簡単なプロンプトを試す
-
-**📊 "レート制限を超えました"**
-- クォータのリセットを待つ（ステータスバーに表示）
-- プランをアップグレード: https://maria-code.ai/pricing
-
-#### 📋 コマンドリファレンス
-
-##### コマンドパレット（Ctrl+Shift+P）
-- `MARIA: Generate Code` - コード生成
-- `MARIA: Generate Image` - 画像生成
-- `MARIA: Generate Video` - ビデオ生成
-- `MARIA: Login to MARIA` - 認証
-- `MARIA: Show Status` - ステータス表示
-- `MARIA: Open Settings` - 設定を開く
-
-##### キーボードショートカット
-- `Ctrl+Alt+M` - コード生成
-- `Ctrl+Alt+I` - 画像生成
-- `Ctrl+Alt+V` - ビデオ生成
-
-##### コンテキストメニュー
-- エディタで右クリック → "MARIA: Generate Code"
-- エクスプローラーで右クリック → "MARIA: Generate Code"
-
-#### 🎯 活用例
-
-##### コードレビューと改善
-```
-1. エディタでコードを選択
-2. Ctrl+Alt+M を押す
-3. "このコードをレビューして改善提案をして" と入力
-4. 提案された変更を適用
-```
-
-##### ドキュメント生成
-```
-1. 関数の近くにカーソルを置く
-2. Ctrl+Alt+M を押す
-3. "この関数のJSDocコメントを生成" と入力
-4. 生成されたドキュメントをカスタマイズ
-```
-
-##### バグ修正
-```
-1. ターミナルからエラーメッセージをコピー
-2. Ctrl+Alt+M を押す
-3. "このエラーを修正: [エラーメッセージ]" と入力
-4. 提案された解決策を確認
-```
-
-#### 💡 上級テクニック
-
-##### カスタムワークフロー
-複数の生成を組み合わせて効率化：
-1. ベースコード構造を生成
-2. 対応するテストを生成
-3. ドキュメント用の画像を作成
-4. デモビデオを生成
-
-##### Gitとの統合
+**⚡ "Generation is slow"**
+- Try switching between CLI/API modes
+- Check your internet connection
+- Try a simpler prompt
+
+**📊 "Rate limit exceeded"**
+- Wait for the quota to reset (shown in the status bar)
+- Upgrade your plan: https://maria-code.ai/pricing
+
+#### 📋 Command Reference
+##### Command Palette (Ctrl+Shift+P)
+- `MARIA: Generate Code` - Generate code
+- `MARIA: Generate Image` - Generate image
+- `MARIA: Generate Video` - Generate video
+- `MARIA: Login to MARIA` - Authenticate
+- `MARIA: Show Status` - Show status
+- `MARIA: Open Settings` - Open settings
+##### Keyboard Shortcuts
+- `Ctrl+Alt+M` - Generate code
+- `Ctrl+Alt+I` - Generate image
+- `Ctrl+Alt+V` - Generate video
+##### Context Menu
+- Right-click in the editor → "MARIA: Generate Code"
+- Right-click in the explorer → "MARIA: Generate Code"
+
+#### 🎯 Usage Examples
+##### Code Review and Improvements
+1. Select code in the editor
+2. Press Ctrl+Alt+M
+3. Enter "Review this code and suggest improvements"
+4. Apply the suggested changes
+
+##### Documentation Generation
+1. Place the cursor near the function
+2. Press Ctrl+Alt+M
+3. Enter "Generate JSDoc comments for this function"
+4. Customize the generated documentation
+
+##### Bug Fixing
+1. Copy the error message from the terminal
+2. Press Ctrl+Alt+M
+3. Enter "Fix this error: [error message]"
+4. Review the proposed solution
+
+#### 💡 Advanced Techniques
+##### Custom Workflows
+Combine multiple generations for efficiency:
+1. Generate the base code structure
+2. Generate corresponding tests
+3. Create images for documentation
+4. Generate a demo video
+
+##### Git Integration
 ```bash
-# 実験用のブランチを作成
+# Create an experimental branch
 git checkout -b feature/ai-generated
 
-# MARIAで初期実装を生成
-# 生成されたコードを改良・テスト
-# 完成したらコミット
+# Generate initial implementation with MARIA
+# Refine and test the generated code
+# Commit when complete
 
 git add .
 git commit -m "feat: AI-generated feature implementation"
 ```
 
-#### 🤝 サポート
-
-- **ドキュメント**: https://maria-code.ai/docs
+#### 🤝 Support
+- **Documentation**: https://maria-code.ai/docs
 - **Discord**: https://discord.gg/SMSmSGcEQy
-- **Issue報告**: https://github.com/bonginkan/maria/issues
-- **機能リクエスト**: https://github.com/bonginkan/maria/discussions
+- **Issue Reports**: https://github.com/bonginkan/maria/issues
+- **Feature Requests**: https://github.com/bonginkan/maria/discussions
 
 ---
 
-## 📦 VS Code拡張機能配布マニュアル
+## 📦 VS Code Extension Distribution Guide
 
-### 🚀 配布準備
+### 🚀 Preparation for Distribution
 
-#### 1. ビルドとパッケージング
+#### 1. Build and Packaging
 ```bash
 cd vscode-maria
 
-# 依存関係のインストール
+# Install dependencies
 npm ci
 
-# TypeScriptのコンパイル
+# Compile TypeScript
 npm run compile
 
-# VSIXパッケージの作成
+# Create VSIX package
 npm run vsce:package
 
-# 作成されたVSIXファイル
-ls *.vsix
+# Generated VSIX file
 # → maria-code-assistant-3.8.0.vsix
 ```
 
-#### 2. 品質チェック
+#### 2. Quality Checks
 ```bash
-# ESLintチェック
+# ESLint check
 npm run lint
 
-# TypeScriptチェック
+# TypeScript check
 npm run compile
 
-# テスト実行
+# Run tests
 npm test
 
-# セキュリティ監査
+# Security audit
 npm audit
 ```
 
-#### 3. パッケージの検証
+#### 3. Validate the Package
 ```bash
-# VSIXの内容確認
+# Inspect VSIX contents
 npx vsce ls *.vsix
 
-# ファイルサイズ確認（5MB以下推奨）
+# Check file size (<=5MB recommended)
 ls -lh *.vsix
 ```
 
-### 📤 配布方法
+### 📤 Distribution Methods
 
-#### オプション1: VS Codeマーケットプレイス公開
+#### Option 1: Publish to VS Code Marketplace
 ```bash
-# パブリッシャーアカウントの設定
+# Configure publisher account
 npx vsce login bonginkan
 
-# マーケットプレイスに公開
+# Publish to Marketplace
 npm run vsce:publish
 
-# または特定バージョンを公開
+# Or publish a specific version
 npx vsce publish --packagePath maria-code-assistant-3.8.0.vsix
 ```
 
-#### オプション2: GitHub Releases経由
+#### Option 2: Via GitHub Releases
 ```bash
-# GitHubにリリースを作成
+# Create a GitHub release
 1. https://github.com/bonginkan/maria/releases/new
-2. タグ: v3.8.0-vscode
-3. VSIXファイルをアップロード
-4. リリースノートを記載
+2. Tag: v3.8.0-vscode
+3. Upload the VSIX file
+4. Add release notes
 ```
 
-#### オプション3: 社内配布
+#### Option 3: Internal Distribution
 ```bash
-# VSIXファイルを直接配布
-1. VSIXファイルを共有フォルダに配置
-2. インストール手順書を添付
-3. 以下のコマンドでインストール：
+# Distribute the VSIX file directly
+1. Place the VSIX file in a shared folder
+2. Include installation instructions
+3. Install with the command below:
    code --install-extension maria-code-assistant-3.8.0.vsix
 ```
 
-### 🔄 自動配布パイプライン
+### 🔄 Automated Distribution Pipeline
 
-#### GitHub Actions設定
+#### GitHub Actions Configuration
 ```yaml
 # .github/workflows/release-vscode.yml
 name: Release VS Code Extension
@@ -1254,39 +1213,39 @@ jobs:
           VSCE_PAT: ${{ secrets.VSCE_PAT }}
 ```
 
-### 📊 配布後の管理
+### 📊 Post-Distribution Management
 
-#### バージョン管理
-- **Patch** (3.8.x): バグ修正、セキュリティ更新
-- **Minor** (3.x.0): 新機能、改善
-- **Major** (x.0.0): 破壊的変更
+#### Versioning
+- **Patch** (3.8.x): Bug fixes, security updates
+- **Minor** (3.x.0): New features, improvements
+- **Major** (x.0.0): Breaking changes
 
-#### 更新通知
+#### Update Notifications
 ```bash
-# package.jsonでバージョンを更新
+# Update the version in package.json
 "version": "3.8.1"
 
-# CHANGELOGを更新
-# 再パッケージング
+# Update CHANGELOG
+# Re-package
 npm run vsce:package
 
-# 新バージョンを公開
+# Publish the new version
 npm run vsce:publish
 ```
 
-### 🎯 配布成功指標
+### 🎯 Distribution Success Metrics
 
-#### 初週目標
-- **ダウンロード数**: 100+ インストール
-- **評価**: 4.0+ 星
-- **レビュー**: 5+ ポジティブレビュー
-- **問題**: 3未満のクリティカルバグ
+#### First-week targets
+- **Downloads**: 100+ installs
+- **Rating**: 4.0+ stars
+- **Reviews**: 5+ positive reviews
+- **Critical Issues**: Fewer than 3
 
-#### 初月目標
-- **ダウンロード数**: 1,000+ インストール
-- **アクティブユーザー**: 500+ 月間アクティブ
-- **評価**: 4.2+ 星を維持
-- **コミュニティ**: Discord参加者増加
+#### First-month targets
+- **Downloads**: 1,000+ installs
+- **Active Users**: 500+ MAU
+- **Rating**: Maintain 4.2+ stars
+- **Community**: Increase Discord participants
 
 ---
 
@@ -1301,7 +1260,7 @@ npm run vsce:publish
 ## 🧠 **NEW: MARIA Intelligence Model Selector (IMS) v2.0** 
 **Enterprise AI Model Routing with Intelligent Decision Making**
 
-### 🎯 **Phase 2 Complete: API統合 + SSE適応制御** (2025年09月01日達成)
+### 🎯 **Phase 2 Complete: API Integration + SSE Adaptive Control** (Achieved September 1, 2025)
 **Production-Ready Intelligent Model Selection System with Advanced Enterprise Features**
 
 #### ✨ **Core IMS Features**
@@ -1501,7 +1460,7 @@ With Phase 2 complete, MARIA IMS now provides:
 - **🔍 Complete Observability**: Health monitoring, performance analytics
 - **🚫 Fault Tolerance**: Multi-layer fallbacks with graceful degradation
 
-**Phase 3 Roadmap**: 決定再現テスト + 高度監査システム
-**Phase 4 Vision**: 量子セキュリティ + 分散デプロイメント
+**Phase 3 Roadmap**: Decision reproduction testing + advanced audit system
+**Phase 4 Vision**: Quantum security + distributed deployment
 
 The MARIA Intelligence Model Selector v2.0 establishes the new standard for enterprise AI model routing, combining intelligent decision-making with military-grade reliability and Fortune 500 deployment readiness.