@bonginkan/maria 3.1.4 → 3.1.6

package/README.md

@@ -1,31 +1,15 @@
-# 🚀 MARIA v3.1.4
+# 📊 MARIA v3.1.6
 
-**Minimal API, Maximum Power** - Enterprise-ready AI development platform with 3 core services, beautiful CLI experience, and dynamic configuration.
+**Advanced Telemetry & Analytics** - Enterprise AI platform with ML-powered monitoring, predictive analytics, and real-time insights. Features 3 core services plus comprehensive telemetry system.
 
 🌐 **Homepage**: [https://bonginkan.ai/](https://bonginkan.ai/)
 
 [![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/)
-[![npm](https://img.shields.io/npm/v/@bonginkan/maria?label=npm%20v3.1.4)](https://www.npmjs.com/package/@bonginkan/maria)
+[![npm](https://img.shields.io/npm/v/@bonginkan/maria?label=npm%20v3.1.6)](https://www.npmjs.com/package/@bonginkan/maria)
 [![Bundle Size](https://img.shields.io/badge/Bundle-192KB-brightgreen)](https://github.com/bonginkan/maria)
 [![API Surface](https://img.shields.io/badge/Public%20API-3%20Services-blue)](https://github.com/bonginkan/maria)
 
-## 🚀 Quick Start
-
-```bash
-# Launch beautiful interactive mode
-maria
-
-# Run API demonstration
-maria --demo
-
-# Test intelligent routing
-maria route "create a React component with TypeScript"
-
-# Show help
-maria --help
-```
-
 ## 🎨 Beautiful CLI Experience
 
 When you run `maria`, you'll see:
@@ -42,7 +26,7 @@ When you run `maria`, you'll see:
 ║         (c) 2025 Bonginkan Inc.                          ║
 ╚══════════════════════════════════════════════════════════╝
 
-MARIA CODE v3.1.4 — Ready
+MARIA CODE v3.1.6 — Ready
 /help for commands | Providers: 8/8 OK
 
 Available AI Providers:
@@ -60,14 +44,32 @@ npm install -g @bonginkan/maria
 pnpm add -g @bonginkan/maria
 ```
 
+## 📊 Quick Start - Telemetry (New in v3.1.6)
+
+```bash
+# Start monitoring stack (optional)
+docker-compose -f docker-compose.monitoring.yml up -d
+
+# Access dashboards
+open http://localhost:3000  # Grafana (admin/admin)
+open http://localhost:9091  # Prometheus
+```
+
 ## 🎯 What is MARIA?
 
-MARIA revolutionizes AI development with **3 powerful services**, **beautiful CLI experience**, and **rock-solid stability**:
+MARIA revolutionizes AI development with **3 powerful services**, **advanced telemetry**, and **beautiful CLI experience**:
 
+### Core Services
 - 🧠 **IntelligentRouterService** - Smart command routing and analysis
 - 🧩 **DualMemoryEngine** - System 1 & System 2 cognitive memory
 - 📁 **FileSystemService** - Safe, atomic file operations
 
+### 🆕 Telemetry System (v3.1.6)
+- 📈 **Prometheus/Grafana Integration** - Real-time metrics & dashboards
+- 🤖 **ML Anomaly Detection** - Isolation Forest, Autoencoder, LSTM models
+- 📊 **Predictive Analytics** - ARIMA, Prophet, Transformer forecasting
+- 🎯 **Custom Metrics Framework** - Flexible metric collection & alerts
+
 ## 💻 Programmatic API
 
 ### Core Services Example
@@ -114,6 +116,36 @@ const fs = new FileSystemService({
   enableBackup: true,
   enableSafeMode: true
 });
+```
+
+### 🆕 Telemetry Example (v3.1.6)
+
+```typescript
+import { startTelemetry } from '@bonginkan/maria';
+
+// Initialize advanced telemetry
+const telemetry = await startTelemetry({
+  prometheusPort: 9090,
+  enableAnomalyDetection: true,
+  enablePredictiveAnalytics: true,
+  enableCustomMetrics: true,
+  alertWebhook: process.env.SLACK_WEBHOOK_URL
+});
+
+// Record telemetry
+await telemetry.recordTelemetry({
+  provider: 'openai',
+  intent: 'CODE_REQUEST',
+  latency: 342,
+  satisfaction: 0.95,
+  tokens: { input: 100, output: 200 }
+});
+
+// Get ML-powered insights
+const insights = await telemetry.generateInsights();
+console.log('Anomalies:', insights.anomalies);
+console.log('Forecasts:', insights.forecasts);
+console.log('Trends:', insights.trends);
 
 await fs.writeFile('/path/to/file.ts', content);
 await fs.copy('/src', '/backup');
@@ -284,14 +316,26 @@ See [LICENSE](LICENSE) for full details.
 - **Documentation**: https://docs.maria-ai.dev
 - **Support**: https://github.com/bonginkan/maria/issues
 
-## 🎉 What's New in v3.0.0
-
-### ✨ Revolutionary Changes
-- **Minimal API Surface**: Reduced from 50+ to 3 core services
-- **Beautiful CLI Experience**: Professional startup screen with provider selection
-- **Dynamic Configuration**: Self-updating version from package.json
-- **Zero-Config Philosophy**: Works perfectly out of the box
-- **Performance Optimized**: 192KB bundle, < 1s startup time
+## 🎉 What's New in v3.1.6
+
+### 📊 Advanced Telemetry System
+- **Prometheus/Grafana Integration**: Real-time metrics visualization
+- **ML Anomaly Detection**: 3 algorithms (Isolation Forest, Autoencoder, LSTM)
+- **Predictive Analytics**: 4 forecasting models (LSTM, ARIMA, Prophet, Transformer)
+- **Custom Metrics Framework**: Flexible metric types with alerts
+- **Docker Compose Setup**: One-command monitoring deployment
+
+### 📈 Monitoring Features
+- **9 Core Metrics**: Response times, error rates, token usage, satisfaction
+- **Pre-built Dashboards**: Beautiful Grafana visualizations
+- **Alert System**: Slack integration with severity levels
+- **Trend Analysis**: Direction, strength, and seasonality detection
+- **Export Formats**: JSON, Prometheus, CSV
+
+### ✨ Core Features (from v3.0.0)
+- **Minimal API Surface**: 3 core services + telemetry
+- **Beautiful CLI Experience**: Professional startup screen
+- **Performance Optimized**: 192KB bundle, < 1s startup
 
 ### 🚨 Breaking Changes from v2.x
 - **API Simplification**: Many internal services no longer exposed