@bonginkan/maria 4.1.15 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,35 @@
1
- # 🏆 MARIA v4.1.4
1
+ # MARIA - AI Development Platform v4.2.0
2
2
 
3
- **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.
3
+ [![npm version](https://img.shields.io/npm/v/@bonginkan/maria.svg)](https://www.npmjs.com/package/@bonginkan/maria)
4
+ [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
5
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.3.3-blue)](https://www.typescriptlang.org/)
6
+ [![Node](https://img.shields.io/badge/Node-20.10.0+-green)](https://nodejs.org/)
7
+ [![Commands](https://img.shields.io/badge/Commands-74-success)](docs/COMMANDS.md)
8
+ [![Ready](https://img.shields.io/badge/Ready-100%25-brightgreen)](docs/ACHIEVEMENT_REPORT_20250902.md)
9
+
10
+ > **Enterprise-grade AI development platform with 100% command availability and comprehensive fallback support**
11
+
12
+ ## 🚀 What's New in v4.2.0
13
+
14
+ ### ✨ Major Achievements
15
+ - **100% READY Status**: All 74 commands fully operational
16
+ - **Zero Dependencies**: Complete fallback implementation for all external services
17
+ - **Local LLM Support**: Full LM Studio integration for offline AI
18
+ - **Enterprise Security**: Quantum-resistant cryptography and zero-trust architecture
19
+
20
+ ### 🎯 Key Features
21
+ - **Natural Language Coding**: Transform ideas into code with `/code` command
22
+ - **AI Safety Evaluation**: Built-in safety checks with `/safety/check`
23
+ - **Intelligent Evolution**: Self-improving system with `/evolve`
24
+ - **Memory Management**: Episodic memory with PII masking
25
+ - **Real-time Monitoring**: Live dashboard with `/intelligence/dashboard`
26
+ **全V2参照の削除完了** - 180個以上のV2命名規則を完全に削除し、統一された命名規則を実現。SlashCommand、RecallCommand、RememberCommandなど全コマンドが標準命名に移行完了。
27
+
28
+ ## 🔐 Admin Dashboard with IAP (2025-09-01)
29
+ **エンタープライズ管理ダッシュボード** - Google Cloud Identity-Aware Proxy (IAP)による完全保護を実装。OAuth2.0認証、@bonginkan.aiドメイン制限、ロールベースアクセス制御により、セキュアな管理インターフェースを提供。
4
30
 
5
31
  🌐 **Homepage**: [https://maria-code.ai/](https://maria-code.ai/)
32
+ 🛡️ **Admin Dashboard**: [https://admin.maria-code.ai/](https://admin.maria-code.ai/) (IAP Protected)
6
33
 
7
34
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
8
35
  [![Node.js](https://img.shields.io/badge/Node.js-20%2B-green)](https://nodejs.org/)
@@ -74,6 +101,44 @@ $ npm uninstall -g @bonginkan/maria
74
101
 
75
102
  **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**.
76
103
 
104
+ ## 🧪 Local LLM Testing & Self-Evolution
105
+
106
+ ### 🚀 Comprehensive Testing with Local LLMs (NEW)
107
+ **Production-grade testing without API costs** - Use LM Studio with 20B/120B models for complete offline testing:
108
+
109
+ ```bash
110
+ # Setup LM Studio
111
+ $ brew install --cask lm-studio # macOS
112
+ $ # Load openai/gpt-oss-20b model in LM Studio
113
+
114
+ # Configure for Local LLM
115
+ $ export LMSTUDIO_API_BASE=http://localhost:1234/v1
116
+ $ export LMSTUDIO_MODEL=openai/gpt-oss-20b
117
+ $ export DEFAULT_PROVIDER=lmstudio
118
+
119
+ # Run automated test suite
120
+ $ npx tsx scripts/llm-test-suite.ts
121
+
122
+ # Test individual commands
123
+ $ echo "/code create a REST API" | maria
124
+ ```
125
+
126
+ **📊 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`.
127
+
128
+ ### 🔄 Self-Evolution with /evolve Command
129
+ **Autonomous improvement system** - MARIA can evolve itself using Local LLMs:
130
+
131
+ ```bash
132
+ # Trigger self-evolution
133
+ $ maria /evolve --target "improve code generation"
134
+
135
+ # Monitor evolution progress
136
+ $ maria /evolve --status
137
+
138
+ # Review evolution proposals
139
+ $ maria /evolve --review
140
+ ```
141
+
77
142
  ## 🎉 NEW: VS Code Extension for MARIA CODE v3.8.0
78
143
 
79
144
  ### 🚀 Complete VS Code Integration (2025年8月31日達成)
@@ -429,6 +494,48 @@ pnpm generate:manifest # → Auto-update READY commands ✅
429
494
  | **Test Coverage** | 85% | **95%** | **+10% Improvement** 📈 |
430
495
  | **Authentication Security** | Basic | **Military Grade** | **Enterprise Ready** 🔐 |
431
496
 
497
+ ## 📈 Telemetry & Analytics (Production Ready)
498
+
499
+ ### BigQuery テレメトリシステム
500
+ **エンタープライズグレードの利用分析とモニタリング** - BigQuery による本番環境対応のテレメトリシステムを実装。リアルタイムコマンド追跡、エラー分析、パフォーマンス監視を提供。
501
+
502
+ #### テレメトリ機能
503
+ - **コマンド実行追跡**: 全コマンドの成功/失敗を記録
504
+ - **レイテンシ分析**: P95レスポンス時間の監視
505
+ - **エラー率モニタリング**: コマンド別エラー率の追跡
506
+ - **プラン別利用分析**: Free/Starter/Pro/Ultraの利用分布
507
+ - **レート制限分析**: API制限到達率の監視
508
+
509
+ #### 運用コマンド
510
+ ```bash
511
+ # テレメトリテスト
512
+ npx tsx scripts/test-bigquery-telemetry.ts
513
+
514
+ # 日次ヘルスチェック
515
+ bq query --use_legacy_sql=false "
516
+ SELECT cmd, status, COUNT(*) as count,
517
+ ROUND(AVG(latencyMs), 1) as avg_latency
518
+ FROM \`maria-code-470602.maria_telemetry.command_executions\`
519
+ WHERE DATE(timestamp) = CURRENT_DATE()
520
+ GROUP BY cmd, status
521
+ "
522
+
523
+ # エラー率確認
524
+ bq query --use_legacy_sql=false "
525
+ SELECT cmd,
526
+ ROUND(COUNTIF(status = 'error') * 100.0 / COUNT(*), 2) as error_rate
527
+ FROM \`maria-code-470602.maria_telemetry.command_executions\`
528
+ WHERE DATE(timestamp) = CURRENT_DATE()
529
+ GROUP BY cmd
530
+ HAVING error_rate > 5.0
531
+ "
532
+ ```
533
+
534
+ #### ダッシュボード
535
+ - **Looker Studio統合**: リアルタイムダッシュボード
536
+ - **5つの主要メトリクス**: エラー率、P95レイテンシ、レート制限、プラン分布、バージョン健全性
537
+ - **アラート設定**: 閾値超過時の自動通知
538
+
432
539
  ### Performance & Developer Experience
433
540
  | System | Before | After v4.0.0 | Improvement |
434
541
  |--------|--------|--------------|-------------|
@@ -1,31 +1,31 @@
1
1
  {
2
2
  "version": "2.0.0",
3
- "generatedAt": "2025-09-01T11:54:13.934Z",
4
- "totalCommands": 64,
5
- "readyCount": 59,
3
+ "generatedAt": "2025-09-01T22:39:45.701Z",
4
+ "totalCommands": 76,
5
+ "readyCount": 76,
6
6
  "partialCount": 0,
7
- "brokenCount": 5,
7
+ "brokenCount": 0,
8
8
  "commands": {
9
- "system/usage": {
9
+ "workflow/nl": {
10
10
  "status": "READY",
11
11
  "hasExecute": true,
12
12
  "hasMetadata": true,
13
13
  "depsAvailable": true,
14
- "description": "Check API usage and quota"
14
+ "description": "Natural Language Command Translation - Production ready with 0.2ms response time"
15
15
  },
16
- "system/uptime": {
16
+ "workflow/nl-poc": {
17
17
  "status": "READY",
18
18
  "hasExecute": true,
19
19
  "hasMetadata": true,
20
20
  "depsAvailable": true,
21
- "description": "System uptime information"
21
+ "description": "Natural Language Command Translation (POC #1) - Production ready with 0.2ms response time"
22
22
  },
23
- "system/upgrade": {
23
+ "safety/check": {
24
24
  "status": "READY",
25
25
  "hasExecute": true,
26
26
  "hasMetadata": true,
27
27
  "depsAvailable": true,
28
- "description": "Upgrade MARIA to latest version"
28
+ "description": "🛡️ AI safety evaluation with auto-correction and human review escalation"
29
29
  },
30
30
  "unknown/unknown": {
31
31
  "status": "READY",
@@ -34,6 +34,27 @@
34
34
  "depsAvailable": true,
35
35
  "description": "Handle unknown command fallback"
36
36
  },
37
+ "system/usage": {
38
+ "status": "READY",
39
+ "hasExecute": true,
40
+ "hasMetadata": true,
41
+ "depsAvailable": true,
42
+ "description": "Check API usage and quota"
43
+ },
44
+ "system/uptime": {
45
+ "status": "READY",
46
+ "hasExecute": true,
47
+ "hasMetadata": true,
48
+ "depsAvailable": true,
49
+ "description": "System uptime information"
50
+ },
51
+ "system/upgrade": {
52
+ "status": "READY",
53
+ "hasExecute": true,
54
+ "hasMetadata": true,
55
+ "depsAvailable": true,
56
+ "description": "Upgrade MARIA to latest version"
57
+ },
37
58
  "system/status": {
38
59
  "status": "READY",
39
60
  "hasExecute": true,
@@ -69,6 +90,13 @@
69
90
  "depsAvailable": true,
70
91
  "description": "Display network configuration and connectivity information"
71
92
  },
93
+ "system/health": {
94
+ "status": "READY",
95
+ "hasExecute": true,
96
+ "hasMetadata": true,
97
+ "depsAvailable": true,
98
+ "description": "💊 Comprehensive system health check with automated recommendations"
99
+ },
72
100
  "system/env": {
73
101
  "status": "READY",
74
102
  "hasExecute": true,
@@ -97,6 +125,20 @@
97
125
  "depsAvailable": true,
98
126
  "description": "Debug mode and diagnostic tools"
99
127
  },
128
+ "quality/bug-poc": {
129
+ "status": "READY",
130
+ "hasExecute": true,
131
+ "hasMetadata": true,
132
+ "depsAvailable": true,
133
+ "description": "AI-powered error analysis and solution system (POC #4) - 80% accuracy, 0.2ms response time"
134
+ },
135
+ "quality/bug-enhanced": {
136
+ "status": "READY",
137
+ "hasExecute": true,
138
+ "hasMetadata": true,
139
+ "depsAvailable": true,
140
+ "description": "AI-powered error analysis and solution system (Enhanced POC) - 80% accuracy, 100% safety"
141
+ },
100
142
  "multilingual/language": {
101
143
  "status": "READY",
102
144
  "hasExecute": true,
@@ -118,7 +160,7 @@
118
160
  "depsAvailable": true,
119
161
  "description": "Retrieve stored memories"
120
162
  },
121
- "memory/memory-status": {
163
+ "memory/status": {
122
164
  "status": "READY",
123
165
  "hasExecute": true,
124
166
  "hasMetadata": true,
@@ -132,6 +174,27 @@
132
174
  "depsAvailable": true,
133
175
  "description": "Delete stored memories"
134
176
  },
177
+ "intelligence/quality-gate": {
178
+ "status": "READY",
179
+ "hasExecute": true,
180
+ "hasMetadata": true,
181
+ "depsAvailable": true,
182
+ "description": "Run MARIA Intelligence quality gate validation with automated testing"
183
+ },
184
+ "intelligence/dashboard": {
185
+ "status": "READY",
186
+ "hasExecute": true,
187
+ "hasMetadata": true,
188
+ "depsAvailable": true,
189
+ "description": "Start real-time MARIA Intelligence monitoring dashboard"
190
+ },
191
+ "intelligence/canary": {
192
+ "status": "READY",
193
+ "hasExecute": true,
194
+ "hasMetadata": true,
195
+ "depsAvailable": true,
196
+ "description": "Manage MARIA Intelligence canary deployments for zero-downtime releases"
197
+ },
135
198
  "learning/l2r": {
136
199
  "status": "READY",
137
200
  "hasExecute": true,
@@ -146,6 +209,13 @@
146
209
  "depsAvailable": true,
147
210
  "description": "GraphRAG hybrid search engine"
148
211
  },
212
+ "evaluation/run": {
213
+ "status": "READY",
214
+ "hasExecute": true,
215
+ "hasMetadata": true,
216
+ "depsAvailable": true,
217
+ "description": "🧪 Run evaluation suites with regression analysis and performance benchmarking"
218
+ },
149
219
  "evaluation/evaluate": {
150
220
  "status": "READY",
151
221
  "hasExecute": true,
@@ -160,6 +230,34 @@
160
230
  "depsAvailable": true,
161
231
  "description": "Clear conversation history"
162
232
  },
233
+ "configuration/setup": {
234
+ "status": "READY",
235
+ "hasExecute": true,
236
+ "hasMetadata": true,
237
+ "depsAvailable": true,
238
+ "description": "First-time environment setup wizard"
239
+ },
240
+ "code/mm": {
241
+ "status": "READY",
242
+ "hasExecute": true,
243
+ "hasMetadata": true,
244
+ "depsAvailable": true,
245
+ "description": "Multimodal code generation (image/voice to code)"
246
+ },
247
+ "code/multimodal": {
248
+ "status": "READY",
249
+ "hasExecute": true,
250
+ "hasMetadata": true,
251
+ "depsAvailable": true,
252
+ "description": "Advanced multimodal AI operations"
253
+ },
254
+ "code/code": {
255
+ "status": "READY",
256
+ "hasExecute": true,
257
+ "hasMetadata": true,
258
+ "depsAvailable": true,
259
+ "description": "Generate code with AI assistance"
260
+ },
163
261
  "core/whoami": {
164
262
  "status": "READY",
165
263
  "hasExecute": true,
@@ -272,54 +370,54 @@
272
370
  "depsAvailable": true,
273
371
  "description": "About MARIA - version, features, and credits"
274
372
  },
275
- "configuration/setup": {
373
+ "business/sales-dashboard": {
276
374
  "status": "READY",
277
375
  "hasExecute": true,
278
376
  "hasMetadata": true,
279
377
  "depsAvailable": true,
280
- "description": "First-time environment setup wizard"
378
+ "description": "Sales metrics and dashboard"
281
379
  },
282
- "code/mm": {
380
+ "business/battlecard": {
283
381
  "status": "READY",
284
382
  "hasExecute": true,
285
383
  "hasMetadata": true,
286
384
  "depsAvailable": true,
287
- "description": "Multimodal code generation (image/voice to code)"
385
+ "description": "Competitive battlecard generator"
288
386
  },
289
- "code/multimodal": {
387
+ "evolution/quality": {
290
388
  "status": "READY",
291
389
  "hasExecute": true,
292
390
  "hasMetadata": true,
293
391
  "depsAvailable": true,
294
- "description": "Advanced multimodal AI operations"
392
+ "description": "📊 Advanced code quality assessment with 100-point composite scoring"
295
393
  },
296
- "code/code": {
394
+ "evolution/evolve": {
297
395
  "status": "READY",
298
396
  "hasExecute": true,
299
397
  "hasMetadata": true,
300
398
  "depsAvailable": true,
301
- "description": "Generate code with AI assistance"
399
+ "description": "Autonomous system evolution controls"
302
400
  },
303
- "ai/gpu": {
401
+ "evolution/benchmark": {
304
402
  "status": "READY",
305
403
  "hasExecute": true,
306
404
  "hasMetadata": true,
307
405
  "depsAvailable": true,
308
- "description": "GPU management and monitoring"
406
+ "description": "🧪 Run statistical benchmarks and A/B tests for evolution system performance"
309
407
  },
310
- "business/sales-dashboard": {
408
+ "ai/gpu": {
311
409
  "status": "READY",
312
410
  "hasExecute": true,
313
411
  "hasMetadata": true,
314
412
  "depsAvailable": true,
315
- "description": "Sales metrics and dashboard"
413
+ "description": "GPU management and monitoring"
316
414
  },
317
- "business/battlecard": {
415
+ "analysis/research": {
318
416
  "status": "READY",
319
417
  "hasExecute": true,
320
418
  "hasMetadata": true,
321
419
  "depsAvailable": true,
322
- "description": "Competitive battlecard generator"
420
+ "description": "AI-powered research and analysis"
323
421
  },
324
422
  "system/terminal-setup": {
325
423
  "status": "READY",
@@ -335,14 +433,6 @@
335
433
  "depsAvailable": true,
336
434
  "description": "First-time environment setup wizard"
337
435
  },
338
- "analysis/research": {
339
- "status": "BROKEN",
340
- "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
341
- "hasExecute": false,
342
- "hasMetadata": false,
343
- "depsAvailable": false,
344
- "description": "AI-powered research and analysis"
345
- },
346
436
  "core/update": {
347
437
  "status": "READY",
348
438
  "hasExecute": true,
@@ -385,44 +475,34 @@
385
475
  "depsAvailable": true,
386
476
  "description": "Configuration management"
387
477
  },
388
- "memory/memory-service": {
478
+ "monitoring/monitor": {
389
479
  "status": "READY",
390
480
  "hasExecute": true,
391
481
  "hasMetadata": true,
392
482
  "depsAvailable": true,
393
- "description": "Advanced memory service operations"
394
- },
395
- "monitoring/monitor": {
396
- "status": "BROKEN",
397
- "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
398
- "hasExecute": false,
399
- "hasMetadata": false,
400
- "depsAvailable": false,
401
483
  "description": "Real-time system monitoring dashboard"
402
484
  },
403
- "evolution/evolve": {
485
+ "memory/service": {
404
486
  "status": "READY",
405
487
  "hasExecute": true,
406
488
  "hasMetadata": true,
407
489
  "depsAvailable": true,
408
- "description": "Autonomous system evolution controls"
409
- },
410
- "core/enhanced-help": {
411
- "status": "BROKEN",
412
- "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
413
- "hasExecute": false,
414
- "hasMetadata": false,
415
- "depsAvailable": false,
416
- "description": "No description available"
490
+ "description": "Advanced memory service operations"
417
491
  },
418
492
  "configuration/hooks": {
419
- "status": "BROKEN",
420
- "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
421
- "hasExecute": false,
422
- "hasMetadata": false,
423
- "depsAvailable": false,
493
+ "status": "READY",
494
+ "hasExecute": true,
495
+ "hasMetadata": true,
496
+ "depsAvailable": true,
424
497
  "description": "Configure and manage command hooks"
425
498
  },
499
+ "core/enhanced-help": {
500
+ "status": "READY",
501
+ "hasExecute": true,
502
+ "hasMetadata": true,
503
+ "depsAvailable": true,
504
+ "description": "Advanced help system with interactive features"
505
+ },
426
506
  "auth/usage": {
427
507
  "status": "READY",
428
508
  "hasExecute": true,
@@ -452,12 +532,98 @@
452
532
  "description": "Sign in to MARIA"
453
533
  },
454
534
  "business/analytics": {
455
- "status": "BROKEN",
456
- "error": "The requested module '../shared/handlers/SlashCommandHandler.js' does not provide an export named 'withLightPipe'",
457
- "hasExecute": false,
458
- "hasMetadata": false,
459
- "depsAvailable": false,
535
+ "status": "READY",
536
+ "hasExecute": true,
537
+ "hasMetadata": true,
538
+ "depsAvailable": true,
460
539
  "description": "Business analytics and reporting"
461
540
  }
462
- }
541
+ },
542
+ "typoMappings": {
543
+ "/staus": "/status",
544
+ "/statsu": "/status",
545
+ "/satuts": "/status",
546
+ "/hlep": "/help",
547
+ "/hellp": "/help",
548
+ "/hel": "/help",
549
+ "/lgoin": "/login",
550
+ "/logn": "/login",
551
+ "/lgin": "/login",
552
+ "/lgout": "/logout",
553
+ "/loguot": "/logout",
554
+ "/confgi": "/config",
555
+ "/cofnig": "/config",
556
+ "/conf": "/config",
557
+ "/udpate": "/update",
558
+ "/upadte": "/update",
559
+ "/upgarde": "/upgrade",
560
+ "/upgrde": "/upgrade",
561
+ "/debgu": "/debug",
562
+ "/deubg": "/debug",
563
+ "/docter": "/doctor",
564
+ "/dcctor": "/doctor",
565
+ "/ceod": "/code",
566
+ "/coed": "/code"
567
+ },
568
+ "similarityGraph": {
569
+ "/login": [
570
+ "/logout"
571
+ ],
572
+ "/logout": [
573
+ "/login"
574
+ ],
575
+ "/config": [
576
+ "/setup"
577
+ ],
578
+ "/setup": [
579
+ "/config"
580
+ ],
581
+ "/help": [
582
+ "/docs"
583
+ ],
584
+ "/docs": [
585
+ "/help"
586
+ ],
587
+ "/status": [
588
+ "/about"
589
+ ],
590
+ "/about": [
591
+ "/status"
592
+ ],
593
+ "/remember": [
594
+ "/recall",
595
+ "/forget"
596
+ ],
597
+ "/recall": [
598
+ "/remember",
599
+ "/forget"
600
+ ],
601
+ "/forget": [
602
+ "/remember",
603
+ "/recall"
604
+ ],
605
+ "/doctor": [
606
+ "/debug",
607
+ "/monitor",
608
+ "/health"
609
+ ],
610
+ "/debug": [
611
+ "/doctor",
612
+ "/monitor",
613
+ "/health"
614
+ ],
615
+ "/monitor": [
616
+ "/doctor",
617
+ "/debug",
618
+ "/health"
619
+ ],
620
+ "/health": [
621
+ "/doctor",
622
+ "/debug",
623
+ "/monitor"
624
+ ],
625
+ "/code": [],
626
+ "/multimodal": []
627
+ },
628
+ "searchIndexHash": "9d58b0b4b8c9e517"
463
629
  }