@bonginkan/maria 1.8.12 → 2.0.0

package/README.md

@@ -4,14 +4,16 @@
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org/)
 [![npm](https://img.shields.io/npm/v/@bonginkan/maria?label=npm%20package)](https://www.npmjs.com/package/@bonginkan/maria)
 [![Downloads](https://img.shields.io/npm/dt/@bonginkan/maria)](https://www.npmjs.com/package/@bonginkan/maria)
+[![Tests](https://img.shields.io/badge/Tests-100%25%20Passed-brightgreen)](./test/TEST_RESULTS_v1.8.6.md)
 [![License](https://img.shields.io/badge/License-Dual--License-blue)](https://github.com/bonginkan/maria/blob/main/LICENSE)
 [![Quality](https://img.shields.io/badge/Code%20Quality-100%25-brightgreen)](https://github.com/bonginkan/maria)
 [![Cognitive Modes](https://img.shields.io/badge/Cognitive%20Modes-50-purple)](https://github.com/bonginkan/maria)
 [![Memory System](https://img.shields.io/badge/Memory%20System-Dual--Layer-orange)](https://github.com/bonginkan/maria)
+[![Commands](https://img.shields.io/badge/Commands-40%20Verified-success)](./test/verify-commands.js)
 
-> 🎉 **MARIA Platform v1.8.6** - Enterprise AI Development CLI with **100% Tested & Verified Commands**, **Revolutionary Dual-Layer Memory System**, **Context-Aware Intelligence**, **Complete Local LLM Integration** (Ollama, vLLM, LM Studio), **Personalized Learning**, 40+ Interactive Commands, and **Privacy-First Development** Environment!
+> 🎉 **MARIA Platform v1.8.6** - Enterprise AI Development CLI with **100% Tested Commands**, **Revolutionary Dual-Layer Memory System**, **Complete Local LLM Integration** (Ollama, vLLM, LM Studio), **Context-Aware Intelligence**, 40+ Interactive Commands, and **Personalized Learning** Capabilities!
 
-## 🖥️ **MARIA CODE CLI Interface**
+## 🖥️ **Beautiful CLI Interface**
 
 ![MARIA CLI Startup](./images/CLI_visual.png)
 
@@ -19,10 +21,10 @@ _MARIA's beautiful startup interface with automatic AI service initialization an
 
 ## 🌟 Key Features - Local AI & Privacy-First Development
 
-### 🧠 **NEW: Revolutionary Dual-Layer Memory System (v1.8.5)**
+### 🧠 **NEW: Revolutionary Dual-Layer Memory System**
 
 - **System 1 (Fast/Intuitive)**: Instant pattern recognition and cache-based responses
-- **System 2 (Deliberate/Analytical)**: Deep reasoning traces and decision trees
+- **System 2 (Deliberate/Analytical)**: Deep reasoning traces and decision trees  
 - **Context-Aware Intelligence**: Every command learns from your patterns
 - **Personalized Experience**: Adapts to your coding style and preferences
 - **60% Faster Startup**: Lazy loading with <50ms memory operations
@@ -85,109 +87,125 @@ Korean:     "코드를 작성해"        → /code
 Vietnamese: "viết code"           → /code
 ```
 
-### 💻 **AI-Powered Coding Assistant**
+### 🏗️ Autonomous Development Ecosystem (/vibe, /paper, /agentic)
 
-**Professional development with intelligent AI assistance:**
-```bash
-/code     # Generate any code instantly with AI
-/review   # Professional code review & optimization
-/bug      # Intelligent bug detection & auto-fix
-/lint     # Code quality analysis & auto-correction
-/test     # Generate comprehensive test suites
-```
+- **Paper-to-Code Transformation**: Research papers → production implementations using DeepCode architecture
+- **SOW-Driven Development**: Complete software solutions from high-level requirements
+- **Multi-Agent Orchestration**: 8+ specialized agents for complex task coordination
+- **Agent Builder**: Automated AGENT.md generation and custom AI agent creation
 
-**Real Results for Engineers:**
-- Generates production-ready code in seconds
-- Detects 40+ bug patterns with AI analysis
-- Automatically fixes ESLint and TypeScript issues
-- Creates test cases that actually pass
-- Professional code reviews with improvement suggestions
+### 🎨 Multimodal Content Generation
 
-### 🏠 **Complete Local LLM Integration**
+- **Advanced Media Creation**: AI-powered image, video, and presentation generation
+- **Google Workspace Integration**: Direct export to Google Docs and Slides
+- **ASCII Avatar Interface**: Interactive visual dialogue system
+- **Voice Integration**: Multimodal communication capabilities
 
-**Privacy-first development with local AI models:**
-```bash
-/setup    # One-command setup for Ollama, vLLM, LM Studio
-/model    # Switch between cloud & local models instantly
-/status   # Monitor local AI service health
-```
+### 🧠 Advanced Intelligence Systems
 
-**Privacy & Performance Benefits:**
-- Your code never leaves your machine
-- Works 100% offline with local models
-- Supports 20+ local LLM models
-- Auto-detects and configures local AI services
-- No API keys required for local models
+- **50 Internal Modes**: Real-time cognitive state adaptation (✽ Thinking…, ✽ Debugging…, etc.)
+- **Cross-Session Learning**: Knowledge transfer and skill progression tracking
+- **Predictive Analytics**: ML-powered user intent prediction and workflow optimization
+- **Context Preservation**: Deep semantic compression with knowledge graph construction
 
-### 🧠 **Advanced Intelligence for Researchers**
+### 🏢 Enterprise-Grade Infrastructure
 
-**Sophisticated AI features for research & complex projects:**
-```bash
-/mode     # Access 50+ cognitive modes (✽ Thinking, ✽ Analyzing...)
-/memory   # Intelligent context preservation across sessions
-/agents   # Deploy specialized AI research assistants
-/paper    # Transform research papers into working code
-```
+- **Zero-Error Policy**: Automated quality enforcement with 0 warnings/errors
+- **CodeRAG System**: Semantic code search with graph-based dependency analysis
+- **MCP Protocol Integration**: Standardized tool communication across platforms
+- **Real-time Collaboration**: Team workspaces with live collaboration sessions
 
-**Research-Grade Features:**
-- 50+ internal cognitive modes for different thinking patterns
-- Cross-session learning and knowledge retention
-- Multi-agent orchestration for complex tasks
-- Paper-to-code transformation for research implementation
+### 🔍 Enterprise Code Quality Analysis Platform (Phase 6 - COMPLETE!)
 
-### 🎨 **Creative Tools & Documentation**
+**Industry-First Comprehensive Analysis Suite with AI-Powered Insights**
 
-**Bonus features for presentations and documentation:**
-```bash
-/image    # AI image generation for presentations & documentation
-/video    # Create demo videos & tutorials
-/avatar   # Interactive ASCII avatar companion
-/voice    # Voice-based coding conversations
-```
+#### 🐛 Bug Detection System (`/bug`)
 
-**Creative Benefits:**
-- Generate diagrams and visuals for technical documentation
-- Create demo videos for project presentations
-- Interactive avatar for engaging user experiences
-- Voice conversations for hands-free coding
+- **40+ Pattern Recognition**: Memory leaks, race conditions, type safety violations, performance bottlenecks
+- **AI-Powered Fix Suggestions**: Intelligent resolution with confidence scoring
+- **Real-time Processing**: <200ms analysis response time
+- **Security Analysis**: XSS, SQL injection, CSRF vulnerability detection
 
-### 💡 **Why Engineers & Researchers Choose MARIA**
+#### 🔧 Advanced Lint Analysis (`/lint`)
 
-```bash
-# Natural language commands for complex tasks:
-"Create a React component for user authentication"
-"Fix this TypeScript error in my API"  
-"Generate comprehensive tests for my algorithm"
-"Set up Ollama with local LLM models"
-"Switch to thinking mode for complex debugging"
-```
+- **ESLint Integration**: 10+ comprehensive code quality checks
+- **Auto-Fix Engine**: Intelligent resolution of fixable issues
+- **Quality Metrics**: 94/100 baseline standard with detailed reporting
+- **Custom Rules**: Extensible rule system for enterprise standards
 
-**Real developer feedback:**
-- *"MARIA saved me 6 hours on my last research project"* 
-- *"Local LLM support means my proprietary code stays secure"*
-- *"The cognitive modes help me think through complex algorithms"*
-- *"Best AI coding assistant for serious development work"*
+#### 🛡️ TypeScript Type Safety (`/typecheck`)
+
+- **Compiler Integration**: Complete TypeScript compiler integration
+- **Coverage Tracking**: 87% baseline with improvement monitoring
+- **Strict Mode Analysis**: Complete compliance checking
+- **Type Assertion Detection**: Dangerous `any`/`unknown` usage identification
+
+#### 🔐 Security Vulnerability Assessment (`/security-review`)
+
+- **OWASP Compliance**: Complete OWASP Top 10 coverage (8/10 baseline)
+- **Security Score**: 89/100 enterprise standard
+- **CWE Classification**: Common Weakness Enumeration integration
+- **Dependency Audit**: npm audit integration with 127+ package validation
+
+**📊 Performance Metrics**: 4/4 commands (100% implementation), 16 sub-commands, zero-error policy enforced
+
+### 🤝 Human-in-the-Loop Approval System (Phase 8 - IMPLEMENTING!)
+
+- **Theme-Level Approval**: Strategic confirmation at architecture/implementation/security levels
+- **Quick Decision Shortcuts**: Shift+Tab, Ctrl+Y/N/T/R for instant workflow approval
+- **Progressive Trust Building**: 5-stage evolution from novice to autonomous operation
+- **Risk-Aware Processing**: AI identifies optimal approval points automatically
+- **Learning Partnership**: Adapts to user patterns while maximizing safety and efficiency
 
 ## Quick Start
 
 ### Installation
 
 ```bash
-# Install globally via npm
-npm install -g @bonginkan/maria
+# 🚀 Latest Version (Recommended) - Memory System Enabled
+npm install -g @bonginkan/maria@latest
+
+# 🔄 Update Existing Installation
+npm update -g @bonginkan/maria
+
+# 🎯 Alpha Version (Latest Features)
+npm install -g @bonginkan/maria@alpha
+
+# 📌 Specific Version (Production Use)
+npm install -g @bonginkan/maria@2.0.0
 
-# Verify installation
+# ✅ Verify Installation
 maria --version
-# Output: MARIA Platform v1.8.2 "Algorithm Education Revolution"
+# Output: MARIA Platform v2.0.0 "Memory Intelligence Edition"
 
-# Setup local AI models (optional)
+# 🧠 Setup Local AI Models (Optional)
 maria setup-ollama    # Install and configure Ollama
 maria setup-vllm      # Install and configure vLLM
 
-# Start interactive mode with natural language
+# 🚀 Start Interactive Mode
 maria
 ```
 
+#### Package Information
+
+- **NPM Package**: [@bonginkan/maria](https://www.npmjs.com/package/@bonginkan/maria)
+- **Latest Version**: 1.8.3 (Updated: August 22, 2025)
+- **Total Downloads**: 500+ (and growing!)
+- **Organization**: [bonginkan](https://www.npmjs.com/org/bonginkan)
+
+#### Alternative Installation Methods
+
+```bash
+# Using yarn
+yarn global add @bonginkan/maria@latest
+
+# Using pnpm  
+pnpm add -g @bonginkan/maria@latest
+
+# Check all available versions
+npm view @bonginkan/maria versions --json
+```
+
 ### 🖥️ **Live CLI Session Example**
 
 ![MARIA CLI Startup](./images/CLI_visual.png)
@@ -207,50 +225,57 @@ vLLM         [●●●●●●●●●●●●●●●●●●●] 0% ⚙
 > _
 ```
 
-**💻 Core Coding Commands (Essential for Engineers):**
+**Natural language interaction (no commands needed!):**
 
 ```bash
-/code     # AI-powered code generation & assistance
-/review   # Professional code review & optimization  
-/bug      # Intelligent bug detection & auto-fix
-/lint     # Code quality analysis & auto-correction
-/test     # Generate comprehensive test suites
+You: "write code for me"     # → Automatically triggers /code
+You: "create a React app"    # → Intelligent routing to /code
+You: "analyze this bug"      # → Auto-switches to /bug mode
+You: "implement research"    # → Triggers /paper for paper-to-code
 ```
 
-**🏠 Local LLM Integration (Privacy-First Development):**
+**🌍 Multi-Language Support (5 Languages):**
 
 ```bash
-/model    # Switch between cloud & local models
-/setup    # Auto-configure Ollama, vLLM, LM Studio
-/status   # Check local AI service availability
+English:  "write code"       # → /code
+Japanese: "コードを書いて"     # → /code
+Chinese:  "写代码"           # → /code
+Korean:   "코드를 작성해"     # → /code
+Vietnamese: "viết code"      # → /code
 ```
 
-**🧠 Advanced Intelligence Features (For Researchers):**
+**🧠 NEW: Memory-Enhanced Commands (v1.8.5):**
 
 ```bash
-/mode     # Access 50+ cognitive modes (✽ Thinking, ✽ Analyzing...)
-/memory   # Intelligent context preservation across sessions
-/agents   # Deploy specialized AI research assistants
-/paper    # Transform research papers into working code
+> /memory status            # View dual-layer memory statistics
+> /memory preferences       # Display learned coding preferences
+> /memory context          # Show current project context
+> /code "create API"       # Uses your patterns & preferences
+> /bug analyze             # Recalls previous bug fixes
+> /lint check             # Applies your style preferences
 ```
 
-**🌍 Natural Language Support (5 Languages):**
+**Advanced Code Quality Analysis Commands:**
 
 ```bash
-English:  "write code"       # → /code
-Japanese: "コードを書いて"     # → /code
-Chinese:  "写代码"           # → /code
-Korean:   "코드를 작성해"     # → /code
-Vietnamese: "viết code"      # → /code
+> /lint check               # Now with memory - learns your style
+> /typecheck analyze         # Tracks type coverage over time
+> /security-review scan      # Remembers vulnerability patterns
+> /bug fix "null pointer"    # Suggests fixes from past resolutions
 ```
 
-**🎨 Creative Tools (Bonus Features):**
+**Traditional slash commands (34+ available):**
 
 ```bash
-/image    # AI image generation for presentations
-/video    # Create demo videos & documentation
-/avatar   # Interactive ASCII avatar companion
-/voice    # Voice-based coding conversations
+/code     # AI-powered code generation
+/paper    # Research paper → code transformation
+/vibe     # Autonomous development from requirements
+/agentic  # Custom AI agent builder
+/bug      # Comprehensive bug analysis & auto-fix
+/image    # AI image generation
+/video    # AI video generation with Google export
+/model    # Switch between cloud and local models
+/help     # Full command reference
 ```
 
 ### Alternative Installation Methods
@@ -337,10 +362,9 @@ maria
 ## 🌍 Supported Platforms
 
 - **Node.js**: 18.0.0 - 22.x
-- **Primary OS Support**: macOS, Linux (optimized)
-- **Secondary OS Support**: Windows 
+- **Operating Systems**: macOS, Linux, Windows
 - **Terminals**: All major terminal applications
-- **Shells**: bash, zsh (recommended), fish, PowerShell
+- **Shells**: bash, zsh, fish, PowerShell
 
 ## 📚 Documentation
 
@@ -436,6 +460,8 @@ MIT License - see [LICENSE](https://github.com/bonginkan/maria/blob/main/LICENSE
 
 **Experience the Algorithm Education Revolution with MARIA Platform v1.6.4**
 
-🚀 Start your journey: `npm install -g @bonginkan/maria && maria`
+🚀 Start your journey: `npm install -g @bonginkan/maria@latest && maria`
+
+📦 **Package**: [npmjs.com/package/@bonginkan/maria](https://www.npmjs.com/package/@bonginkan/maria) | 🏢 **Organization**: [npmjs.com/org/bonginkan](https://www.npmjs.com/org/bonginkan)
 
 > > > > > > > release/v1.6.0