@bonginkan/maria 4.1.15 → 4.2.1

package/README.md

@@ -1,8 +1,36 @@
-# 🏆 MARIA v4.1.4
+# MARIA - AI Development Platform v4.2.0
 
-**Complete Multimodal AI Integration & Enterprise Platform** - Revolutionary multimodal AI development platform with voice-to-code, image-to-code capabilities, and world's first TypeScript AST-powered code generation. Features 73 production-ready slash commands (68% READY status), OAuth2.0 + PKCE authentication, military-grade security, and enterprise-grade streaming performance. Delivers next-generation development experience with advanced memory systems, GraphRAG intelligence, and Fortune 500 deployment certification.
+[![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-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3.3-blue)](https://www.typescriptlang.org/)
+[![Node](https://img.shields.io/badge/Node-20.10.0+-green)](https://nodejs.org/)
+[![Commands](https://img.shields.io/badge/Commands-76-success)](docs/COMMANDS.md)
+[![Ready](https://img.shields.io/badge/Ready-100%25-brightgreen)](docs/ACHIEVEMENT_REPORT_20250902.md)
+
+> **Enterprise-grade AI development platform with 100% command availability and comprehensive fallback support**
+
+## 🚀 What's New in v4.2.0 (September 2, 2025)
+
+### ✨ Major Achievements
+- **100% READY Status**: All 76 commands fully operational (Week 2 Enterprise Systems)
+- **UIR System**: Universal Intelligence Router with enterprise governance
+- **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など全コマンドが標準命名に移行完了。
+
+## 🔐 Admin Dashboard with IAP (2025-09-01)
+**エンタープライズ管理ダッシュボード** - Google Cloud Identity-Aware Proxy (IAP)による完全保護を実装。OAuth2.0認証、@bonginkan.aiドメイン制限、ロールベースアクセス制御により、セキュアな管理インターフェースを提供。
 
 🌐 **Homepage**: [https://maria-code.ai/](https://maria-code.ai/)
+🛡️ **Admin Dashboard**: [https://admin.maria-code.ai/](https://admin.maria-code.ai/) (IAP Protected)
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-20%2B-green)](https://nodejs.org/)
@@ -74,6 +102,44 @@ $ npm uninstall -g @bonginkan/maria
 
 **Transform coding from syntax to intent** - Simply articulate your requirements in natural language and witness MARIA intelligently generate, refine, and optimize your code with enterprise-grade precision and **guaranteed zero errors**.
 
+## 🧪 Local LLM Testing & Self-Evolution
+
+### 🚀 Comprehensive Testing with Local LLMs (NEW)
+**Production-grade testing without API costs** - Use LM Studio with 20B/120B models for complete offline testing:
+
+```bash
+# Setup LM Studio
+$ brew install --cask lm-studio  # macOS
+$ # Load openai/gpt-oss-20b model in LM Studio
+
+# Configure for Local LLM
+$ export LMSTUDIO_API_BASE=http://localhost:1234/v1
+$ export LMSTUDIO_MODEL=openai/gpt-oss-20b
+$ export DEFAULT_PROVIDER=lmstudio
+
+# Run automated test suite
+$ npx tsx scripts/llm-test-suite.ts
+
+# Test individual commands
+$ echo "/code create a REST API" | maria
+```
+
+**📊 Verified Results**: 55.6% test pass rate with Local LLM, 100% success on code generation tasks. Full documentation at `docs/BEST_PRACTICE/TESTING_BY_LOCAL_LLM.md`.
+
+### 🔄 Self-Evolution with /evolve Command
+**Autonomous improvement system** - MARIA can evolve itself using Local LLMs:
+
+```bash
+# Trigger self-evolution
+$ maria /evolve --target "improve code generation"
+
+# Monitor evolution progress
+$ maria /evolve --status
+
+# Review evolution proposals
+$ maria /evolve --review
+```
+
 ## 🎉 NEW: VS Code Extension for MARIA CODE v3.8.0
 
 ### 🚀 Complete VS Code Integration (2025年8月31日達成)
@@ -429,6 +495,101 @@ pnpm generate:manifest # → Auto-update READY commands ✅
 | **Test Coverage** | 85% | **95%** | **+10% Improvement** 📈 |
 | **Authentication Security** | Basic | **Military Grade** | **Enterprise Ready** 🔐 |
 
+## 📈 Telemetry & Analytics (Production Ready)
+
+### BigQuery テレメトリシステム
+**エンタープライズグレードの利用分析とモニタリング** - BigQuery による本番環境対応のテレメトリシステムを実装。リアルタイムコマンド追跡、エラー分析、パフォーマンス監視を提供。
+
+#### テレメトリ機能
+- **コマンド実行追跡**: 全コマンドの成功/失敗を記録
+- **レイテンシ分析**: P95レスポンス時間の監視
+- **エラー率モニタリング**: コマンド別エラー率の追跡
+- **プラン別利用分析**: Free/Starter/Pro/Ultraの利用分布
+- **レート制限分析**: API制限到達率の監視
+
+#### 運用コマンド
+```bash
+# テレメトリテスト
+npx tsx scripts/test-bigquery-telemetry.ts
+
+# 日次ヘルスチェック
+bq query --use_legacy_sql=false "
+  SELECT cmd, status, COUNT(*) as count, 
+    ROUND(AVG(latencyMs), 1) as avg_latency
+  FROM \`maria-code-470602.maria_telemetry.command_executions\`
+  WHERE DATE(timestamp) = CURRENT_DATE()
+  GROUP BY cmd, status
+"
+
+# エラー率確認
+bq query --use_legacy_sql=false "
+  SELECT cmd, 
+    ROUND(COUNTIF(status = 'error') * 100.0 / COUNT(*), 2) as error_rate
+  FROM \`maria-code-470602.maria_telemetry.command_executions\`
+  WHERE DATE(timestamp) = CURRENT_DATE()
+  GROUP BY cmd
+  HAVING error_rate > 5.0
+"
+```
+
+#### ダッシュボード
+- **Looker Studio統合**: リアルタイムダッシュボード
+- **5つの主要メトリクス**: エラー率、P95レイテンシ、レート制限、プラン分布、バージョン健全性
+- **アラート設定**: 閾値超過時の自動通知
+
+## 🔐 Secret Manager Integration (Production Ready)
+
+### Google Cloud Secret Manager
+**エンタープライズグレードのシークレット管理** - APIキーとセンシティブデータの安全な保管と管理を実現。環境変数の代わりにSecret Managerを使用することでセキュリティを大幅に向上。
+
+#### 管理対象シークレット
+- **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キー
+
+#### Secret Manager利用方法
+```bash
+# シークレット一覧確認
+gcloud secrets list
+
+# シークレット作成
+echo -n "YOUR_API_KEY" | gcloud secrets create SECRET_NAME --data-file=-
+
+# シークレットアクセス
+gcloud secrets versions access latest --secret="SECRET_NAME"
+
+# IAM権限付与（サービスアカウント用）
+gcloud secrets add-iam-policy-binding SECRET_NAME \
+  --member="serviceAccount:SERVICE_ACCOUNT@PROJECT.iam.gserviceaccount.com" \
+  --role="roles/secretmanager.secretAccessor"
+```
+
+#### コード実装
+```typescript
+// Secret Manager自動統合
+// src/providers/manager.ts
+const secretManager = new SecretManagerIntegration({
+  projectId: 'maria-code-470602',
+  secrets: {
+    groq: 'groq-api-key',
+    openAI: 'openai-api-key',
+    anthropic: 'anthropic-api-key',
+    googleAI: 'google-ai-api-key'
+  }
+});
+
+// 自動フォールバック
+// 1. Secret Manager → 2. 環境変数 → 3. デフォルト値
+```
+
+#### セキュリティメリット
+- **中央管理**: すべてのAPIキーをCloud Consoleで一元管理
+- **アクセス制御**: IAMによる細かい権限管理
+- **監査ログ**: 全アクセス履歴の自動記録
+- **ローテーション**: APIキーの簡単な更新
+- **暗号化**: 保存時・転送時の自動暗号化
+
 ### Performance & Developer Experience
 | System | Before | After v4.0.0 | Improvement |
 |--------|--------|--------------|-------------|

package/dist/READY.manifest.json

@@ -1,31 +1,31 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2025-09-01T11:54:13.934Z",
-  "totalCommands": 64,
-  "readyCount": 59,
+  "generatedAt": "2025-09-01T22:39:45.701Z",
+  "totalCommands": 76,
+  "readyCount": 76,
   "partialCount": 0,
-  "brokenCount": 5,
+  "brokenCount": 0,
   "commands": {
-    "system/usage": {
+    "workflow/nl": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Check API usage and quota"
+      "description": "Natural Language Command Translation - Production ready with 0.2ms response time"
     },
-    "system/uptime": {
+    "workflow/nl-poc": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "System uptime information"
+      "description": "Natural Language Command Translation (POC #1) - Production ready with 0.2ms response time"
     },
-    "system/upgrade": {
+    "safety/check": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Upgrade MARIA to latest version"
+      "description": "🛡️ AI safety evaluation with auto-correction and human review escalation"
     },
     "unknown/unknown": {
       "status": "READY",
@@ -34,6 +34,27 @@
       "depsAvailable": true,
       "description": "Handle unknown command fallback"
     },
+    "system/usage": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Check API usage and quota"
+    },
+    "system/uptime": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "System uptime information"
+    },
+    "system/upgrade": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Upgrade MARIA to latest version"
+    },
     "system/status": {
       "status": "READY",
       "hasExecute": true,
@@ -69,6 +90,13 @@
       "depsAvailable": true,
       "description": "Display network configuration and connectivity information"
     },
+    "system/health": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "💊 Comprehensive system health check with automated recommendations"
+    },
     "system/env": {
       "status": "READY",
       "hasExecute": true,
@@ -97,6 +125,20 @@
       "depsAvailable": true,
       "description": "Debug mode and diagnostic tools"
     },
+    "quality/bug-poc": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "AI-powered error analysis and solution system (POC #4) - 80% accuracy, 0.2ms response time"
+    },
+    "quality/bug-enhanced": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "AI-powered error analysis and solution system (Enhanced POC) - 80% accuracy, 100% safety"
+    },
     "multilingual/language": {
       "status": "READY",
       "hasExecute": true,
@@ -118,7 +160,7 @@
       "depsAvailable": true,
       "description": "Retrieve stored memories"
     },
-    "memory/memory-status": {
+    "memory/status": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
@@ -132,6 +174,27 @@
       "depsAvailable": true,
       "description": "Delete stored memories"
     },
+    "intelligence/quality-gate": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Run MARIA Intelligence quality gate validation with automated testing"
+    },
+    "intelligence/dashboard": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Start real-time MARIA Intelligence monitoring dashboard"
+    },
+    "intelligence/canary": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Manage MARIA Intelligence canary deployments for zero-downtime releases"
+    },
     "learning/l2r": {
       "status": "READY",
       "hasExecute": true,
@@ -146,6 +209,13 @@
       "depsAvailable": true,
       "description": "GraphRAG hybrid search engine"
     },
+    "evaluation/run": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "🧪 Run evaluation suites with regression analysis and performance benchmarking"
+    },
     "evaluation/evaluate": {
       "status": "READY",
       "hasExecute": true,
@@ -160,6 +230,34 @@
       "depsAvailable": true,
       "description": "Clear conversation history"
     },
+    "configuration/setup": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "First-time environment setup wizard"
+    },
+    "code/mm": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Multimodal code generation (image/voice to code)"
+    },
+    "code/multimodal": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Advanced multimodal AI operations"
+    },
+    "code/code": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Generate code with AI assistance"
+    },
     "core/whoami": {
       "status": "READY",
       "hasExecute": true,
@@ -272,54 +370,54 @@
       "depsAvailable": true,
       "description": "About MARIA - version, features, and credits"
     },
-    "configuration/setup": {
+    "business/sales-dashboard": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "First-time environment setup wizard"
+      "description": "Sales metrics and dashboard"
     },
-    "code/mm": {
+    "business/battlecard": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Multimodal code generation (image/voice to code)"
+      "description": "Competitive battlecard generator"
     },
-    "code/multimodal": {
+    "evolution/quality": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Advanced multimodal AI operations"
+      "description": "📊 Advanced code quality assessment with 100-point composite scoring"
     },
-    "code/code": {
+    "evolution/evolve": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Generate code with AI assistance"
+      "description": "Autonomous system evolution controls"
     },
-    "ai/gpu": {
+    "evolution/benchmark": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "GPU management and monitoring"
+      "description": "🧪 Run statistical benchmarks and A/B tests for evolution system performance"
     },
-    "business/sales-dashboard": {
+    "ai/gpu": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Sales metrics and dashboard"
+      "description": "GPU management and monitoring"
     },
-    "business/battlecard": {
+    "analysis/research": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Competitive battlecard generator"
+      "description": "AI-powered research and analysis"
     },
     "system/terminal-setup": {
       "status": "READY",
@@ -335,14 +433,6 @@
       "depsAvailable": true,
       "description": "First-time environment setup wizard"
     },
-    "analysis/research": {
-      "status": "BROKEN",
-      "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
-      "hasExecute": false,
-      "hasMetadata": false,
-      "depsAvailable": false,
-      "description": "AI-powered research and analysis"
-    },
     "core/update": {
       "status": "READY",
       "hasExecute": true,
@@ -385,44 +475,34 @@
       "depsAvailable": true,
       "description": "Configuration management"
     },
-    "memory/memory-service": {
+    "monitoring/monitor": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Advanced memory service operations"
-    },
-    "monitoring/monitor": {
-      "status": "BROKEN",
-      "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
-      "hasExecute": false,
-      "hasMetadata": false,
-      "depsAvailable": false,
       "description": "Real-time system monitoring dashboard"
     },
-    "evolution/evolve": {
+    "memory/service": {
       "status": "READY",
       "hasExecute": true,
       "hasMetadata": true,
       "depsAvailable": true,
-      "description": "Autonomous system evolution controls"
-    },
-    "core/enhanced-help": {
-      "status": "BROKEN",
-      "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
-      "hasExecute": false,
-      "hasMetadata": false,
-      "depsAvailable": false,
-      "description": "No description available"
+      "description": "Advanced memory service operations"
     },
     "configuration/hooks": {
-      "status": "BROKEN",
-      "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
-      "hasExecute": false,
-      "hasMetadata": false,
-      "depsAvailable": false,
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
       "description": "Configure and manage command hooks"
     },
+    "core/enhanced-help": {
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
+      "description": "Advanced help system with interactive features"
+    },
     "auth/usage": {
       "status": "READY",
       "hasExecute": true,
@@ -452,12 +532,98 @@
       "description": "Sign in to MARIA"
     },
     "business/analytics": {
-      "status": "BROKEN",
-      "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
-      "hasExecute": false,
-      "hasMetadata": false,
-      "depsAvailable": false,
+      "status": "READY",
+      "hasExecute": true,
+      "hasMetadata": true,
+      "depsAvailable": true,
       "description": "Business analytics and reporting"
     }
-  }
+  },
+  "typoMappings": {
+    "/staus": "/status",
+    "/statsu": "/status",
+    "/satuts": "/status",
+    "/hlep": "/help",
+    "/hellp": "/help",
+    "/hel": "/help",
+    "/lgoin": "/login",
+    "/logn": "/login",
+    "/lgin": "/login",
+    "/lgout": "/logout",
+    "/loguot": "/logout",
+    "/confgi": "/config",
+    "/cofnig": "/config",
+    "/conf": "/config",
+    "/udpate": "/update",
+    "/upadte": "/update",
+    "/upgarde": "/upgrade",
+    "/upgrde": "/upgrade",
+    "/debgu": "/debug",
+    "/deubg": "/debug",
+    "/docter": "/doctor",
+    "/dcctor": "/doctor",
+    "/ceod": "/code",
+    "/coed": "/code"
+  },
+  "similarityGraph": {
+    "/login": [
+      "/logout"
+    ],
+    "/logout": [
+      "/login"
+    ],
+    "/config": [
+      "/setup"
+    ],
+    "/setup": [
+      "/config"
+    ],
+    "/help": [
+      "/docs"
+    ],
+    "/docs": [
+      "/help"
+    ],
+    "/status": [
+      "/about"
+    ],
+    "/about": [
+      "/status"
+    ],
+    "/remember": [
+      "/recall",
+      "/forget"
+    ],
+    "/recall": [
+      "/remember",
+      "/forget"
+    ],
+    "/forget": [
+      "/remember",
+      "/recall"
+    ],
+    "/doctor": [
+      "/debug",
+      "/monitor",
+      "/health"
+    ],
+    "/debug": [
+      "/doctor",
+      "/monitor",
+      "/health"
+    ],
+    "/monitor": [
+      "/doctor",
+      "/debug",
+      "/health"
+    ],
+    "/health": [
+      "/doctor",
+      "/debug",
+      "/monitor"
+    ],
+    "/code": [],
+    "/multimodal": []
+  },
+  "searchIndexHash": "9d58b0b4b8c9e517"
 }