@bonginkan/maria 3.0.7 → 3.0.9

package/README.md

@@ -1,668 +1,332 @@
-# 🚀 MARIA v3.0.7
+# 🚀 MARIA v3.0.9
 
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
-[![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)
-[![License](https://img.shields.io/badge/License-SEE%20LICENSE-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)
-
-> **Stable & Reliable** - AI-powered development platform with 50+ working commands, all core features fixed and production-ready.
-
-## 🖥️ **MARIA CODE CLI Interface**
-
-![MARIA CLI Startup](./images/CLI_visual.png)
-
-_MARIA's beautiful startup interface with automatic AI service initialization and local LLM detection_
-
-## 🎯 What is MARIA?
-
-MARIA is an enterprise-ready AI development assistant that brings the power of multiple AI providers (OpenAI, Anthropic, Google, Groq, Ollama, etc.) directly to your terminal with 50+ slash commands for every development task.
+**Minimal API, Maximum Power** - Enterprise-ready AI development platform with 3 core services, beautiful CLI experience, and dynamic configuration.
 
-## 🌟 Key Features - Multi-Language Intelligence System & AI Development
-
-### 🌐 **Multi-Language UI System (v3.0.7) - NEW!**
-
-- **5-Language Support**: Complete UI localization in English, Japanese (日本語), Chinese (中文), Korean (한국어), Vietnamese (Tiếng Việt)
-- **Enhanced Navigation**: Universal arrow key support (↑↓) across all interfaces with real-time selection updates
-- **Clean Startup Experience**: Professional ASCII branding with eliminated debug output and consolidated startup flow
-- **Consistent Design**: Unicode box drawing characters with 44-character width for all UI components
-- **Cultural Adaptation**: Localized date formats, numbering conventions, and proper CJK character handling
-
-### 🛡️ **HSR (ホウレンソウ) Intelligence System (v2.2.0)**
-
-- **Human-Centered AI**: Revolutionary human-first architecture with guaranteed human authority
-- **Always-Stoppable Operations**: <10ms ESC response guarantee with natural language interruption support
-- **Real-time Monitoring**: Complete monitoring platform with 6 new slash commands
-- **ULTRATHINK Integration**: Human-supervised AI analysis with branch-by-branch control
-- **Enterprise Dashboard**: Multi-format visualization (ASCII, HTML, JSON) with production WebSocket server
-
-### 🤖 **Linux Command Intelligence System (v2.1.7)**
+[![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.0.9)](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)
 
-- **Phase 1 - Intelligence Layer**: Real-time context analysis and command intent recognition (14 intent types)
-- **Phase 2 - Autonomous Execution**: Smart command executor with 5-level risk assessment and safety validation
-- **Phase 3 - Advanced Operations**: Infrastructure management, file system intelligence, container integration
-- **Phase 4 - Learning & Adaptation**: Machine learning engine, workflow automation, anomaly detection
-- **100% Integration Tested**: All 4 phases validated on macOS with complete system compatibility
+## ⚡ 3-Minute Quickstart
 
-### 🧠 **Revolutionary Dual-Layer Memory System (Enhanced v2.1.7)**
+### 🎯 What is MARIA v3.0.9?
 
-- **System 1 (Fast/Intuitive)**: Instant pattern recognition with Linux command awareness
-- **System 2 (Deliberate/Analytical)**: Deep reasoning with system administration context
-- **Intelligence Integration**: Memory system now learns from Linux command patterns
-- **Autonomous Learning**: Adapts to your system administration and coding patterns
-- **Enhanced Performance**: 60% faster startup with intelligent command caching
+MARIA v3.0.9 revolutionizes AI development with **3 powerful services**, **beautiful CLI experience**, and **rock-solid stability**:
 
-### 🏠 **Complete Local LLM Integration**
+- 🧠 **IntelligentRouterService** - Smart command routing and analysis
+- 🧩 **DualMemoryEngine** - System 1 & System 2 cognitive memory
+- 📁 **FileSystemService** - Safe, atomic file operations
 
-- **Automatic Detection & Setup**: Auto-configures Ollama, vLLM, LM Studio
-- **Privacy-First Development**: All processing runs locally on your machine
-- **Zero Cloud Dependencies**: Work offline with full AI capabilities
-- **Multi-Model Support**: Seamlessly switch between 20+ local models
-- **One-Command Setup**: `maria setup-ollama` / `maria setup-vllm` for instant configuration
+### 🆕 What's New in v3.0.9
 
-### 🤖 **Enterprise AI Development + System Administration**
+#### Critical Fixes
+- ✅ **Fixed `/help` Command** - Completely resolved all help command issues
+- ✅ **Variable Consistency** - Fixed all variable name mismatches 
+- ✅ **Error Messages** - Clearer, more helpful error output
+- ✅ **Build Warnings** - Eliminated all build warnings
 
-- **Autonomous Linux Administration**: Complete system management with intelligent command execution
-- **Safety-First Operations**: Pre-execution validation with automatic backup and rollback capabilities
-- **Learning System Administration**: AI learns your server management patterns and optimizes workflows
-- **Memory-Enhanced Commands**: All core commands learn from usage with Linux command intelligence
-- **Autonomous Coding Agent**: Complete project development from requirements
-- **Multi-Provider Support**: OpenAI, Anthropic, Google, Groq + Local LLMs
-- **Interactive Commands**: 50+ slash commands including system administration tools
-- **Professional Engineering Modes**: 50+ specialized AI cognitive states for development and ops
+#### Improvements
+- 📝 Better help text formatting without underscore prefixes
+- 🐛 Enhanced error handling with proper stack traces
+- 📦 Cleaner build output
+- 🎯 More reliable command execution
 
-### 🚀 **Instant Setup & Usage**
+### 📦 Installation
 
 ```bash
+# Global installation (recommended)
 npm install -g @bonginkan/maria
-maria setup-ollama          # Auto-install local AI
-maria                        # Start interactive development + Linux intelligence
-```
-
-**Linux Command Intelligence Capabilities (NEW in v2.1.7):**
-
-- ✅ **Autonomous Linux Administration**: Smart command execution with risk assessment
-- ✅ **Safety Validation**: Pre-execution checks with automatic backup creation
-- ✅ **Learning Engine**: AI learns your system administration patterns
-- ✅ **Workflow Automation**: Complex task orchestration with cron scheduling
-- ✅ **Anomaly Detection**: Real-time system monitoring and security analysis
-- ✅ **100% Integration Tested**: Complete validation across all 4 intelligence phases
-
-**Core Development Capabilities:**
-
-- ✅ **Local AI Models**: Complete offline development environment
-- ✅ **Code Generation**: AI-powered development assistance with system context
-- ✅ **Quality Analysis**: Real-time code review and optimization
-- ✅ **Multi-Language**: Support for all major programming languages
-- ✅ **Enterprise Ready**: Professional development workflows with system administration
-
-### 🤖 Linux Command Intelligence System
-
-#### **Phase 1: Intelligence Layer** 
-- **Context Analysis Engine**: Real-time system state monitoring with user intent recognition
-- **Command Knowledge Base**: Comprehensive Linux command database with risk classification
-- **Intent Recognition**: 14 command intent types (FILE_OPERATION, SERVICE_CONTROL, PERFORMANCE_OPTIMIZATION, etc.)
-- **Risk Assessment**: 5-level classification system (SAFE → CRITICAL) for command safety
-
-#### **Phase 2: Autonomous Execution Framework**
-- **Smart Command Executor**: Context-aware command processing with intelligent parameter suggestion
-- **Safety Validator**: Pre-execution validation with automatic backup creation and rollback planning
-- **Progress Tracking**: Real-time execution monitoring with detailed progress reports
-- **Dry-run Mode**: Safe command testing without actual system changes
-
-#### **Phase 3: Advanced Operations Integration**  
-- **Infrastructure Management**: Service orchestration and process monitoring capabilities
-- **File System Intelligence**: Smart file operations with metadata analysis and security checks
-- **Network Analysis**: Comprehensive networking diagnostics and troubleshooting
-- **Container Integration**: Docker/Podman support for containerized environment management
-
-#### **Phase 4: Learning & Adaptation System**
-- **Machine Learning Engine**: User behavior analysis and command sequence optimization
-- **Workflow Automation**: Complex multi-step operations with cron scheduling and error handling
-- **Anomaly Detection**: Real-time security and performance monitoring with intelligent alerting
-- **Adaptive Intelligence**: Self-improving system that learns from user patterns and optimizes workflows
-
-### 🎯 Development Features
-
-- **Interactive Learning**: Hands-on algorithm education with visualization
-- **Performance Analysis**: Real-time performance metrics and optimization
-- **Professional Engineering**: Industry-standard development practices
-- **Visual Progress**: Beautiful CLI interface with progress tracking
-- **Autonomous Execution**: Complete task automation from requirements
-
-### 🤖 Intelligent Router - Natural Language Command System
-
-- **🌍 5-Language Support**: Native understanding in **English, Japanese, Chinese, Korean, Vietnamese**
-- **Intent Recognition**: "write code" → `/code` automatic execution (95%+ accuracy)
-- **Contextual Understanding**: Smart parameter extraction from natural conversation
-- **Learning Engine**: Adapts to user patterns for personalized experience
-
-**Multi-Language Examples:**
 
-```bash
-English:    "write code"          → /code
-Japanese:   "コードを書いて"        → /code
-Chinese:    "写代码"              → /code
-Korean:     "코드를 작성해"        → /code
-Vietnamese: "viết code"           → /code
+# Or with pnpm
+pnpm add -g @bonginkan/maria
 ```
 
-### 💻 **AI-Powered Coding Assistant**
+### 🚀 Quick Start
 
-**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
-```
+# Launch beautiful interactive mode
+maria
 
-**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
+# Run API demonstration
+maria --demo
 
-### 🏠 **Complete Local LLM Integration**
+# Test intelligent routing
+maria route "create a React component with TypeScript"
 
-**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
+# Show help
+maria --help
 ```
 
-**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
+## 🎨 Beautiful CLI Experience
 
-### 🧠 **Advanced Intelligence for Researchers**
+When you run `maria`, you'll see:
 
-**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
 ```
-
-**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
-
-### 🎨 **Creative Tools & Documentation**
-
-**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
+╔══════════════════════════════════════════════════════════╗
+║  ███╗   ███╗ █████╗ ██████╗ ██╗ █████╗                  ║
+║  ████╗ ████║██╔══██╗██╔══██╗██║██╔══██╗                 ║
+║  ██╔████╔██║███████║██████╔╝██║███████║                 ║
+║  ██║╚██╔╝██║██╔══██║██╔══██╗██║██╔══██║                 ║
+║  ██║ ╚═╝ ██║██║  ██║██║  ██║██║██║  ██║                 ║
+║  ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝                 ║
+║        AI-Powered Development Platform                   ║
+║         (c) 2025 Bonginkan Inc.                          ║
+╚══════════════════════════════════════════════════════════╝
+
+MARIA CODE v3.0.9 — Ready
+/help for commands | Providers: 8/8 OK
+
+Available AI Providers:
+☁️  Cloud AI: OpenAI, Anthropic, Google, Groq, xAI
+💻 Local AI: Ollama, LM Studio, vLLM
 ```
 
-**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
-
-### 💡 **Why Engineers & Researchers Choose MARIA**
-
-```bash
-# Natural language commands for development & system administration:
-"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"
-"Check system performance and optimize"
-"Create automated backup workflow"
-"Analyze disk usage and clean up files"
-"Monitor services and restart if needed"
-```
+## 💻 Programmatic API
 
-**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"*
+### Core Services Example
 
-## Quick Start
+```typescript
+import { 
+  IntelligentRouterService, 
+  DualMemoryEngine, 
+  FileSystemService 
+} from '@bonginkan/maria';
+
+// 🧠 Intelligent Routing
+const router = new IntelligentRouterService({
+  confidenceThreshold: 0.85,
+  enableLearning: true,
+  enableConfirmation: false
+});
 
-### Installation
+const result = await router.route('optimize my database queries');
+console.log('Route:', result.command);
+console.log('Confidence:', result.confidence);
+
+// 🧩 Dual Memory System
+const memory = new DualMemoryEngine({
+  system1: { maxKnowledgeNodes: 1000, accessDecayRate: 0.01 },
+  system2: { maxReasoningTraces: 100, qualityThreshold: 0.7 },
+  coordinator: { 
+    syncInterval: 1000, 
+    conflictResolutionStrategy: 'balanced',
+    learningRate: 0.1
+  }
+});
 
-```bash
-# Install globally via npm
-npm install -g @bonginkan/maria
+await memory.store('project_context', {
+  language: 'typescript',
+  framework: 'react',
+  patterns: ['hooks', 'components']
+});
 
-# Verify installation
-maria --version
-# Output: MARIA Platform v2.2.1 "Multi-Language Intelligence Edition"
+const insights = await memory.query('best practices for React hooks');
 
-# Setup local AI models (optional)
-maria setup-ollama    # Install and configure Ollama
-maria setup-vllm      # Install and configure vLLM
+// 📁 Safe File Operations
+const fs = new FileSystemService({
+  enableBackup: true,
+  enableSafeMode: true
+});
 
-# Start interactive mode with Linux Command Intelligence
-maria
-# Linux Command Intelligence System initializes automatically
-# All system administration commands now benefit from AI intelligence
+await fs.writeFile('/path/to/file.ts', content);
+await fs.copy('/src', '/backup');
 ```
 
-### 🖥️ **Live CLI Session Example**
+## 🏗️ Architecture
 
-![MARIA CLI Startup](./images/CLI_visual.png)
+### Minimal API Philosophy
 
-**Terminal Output:**
-
-```bash
-🚀 Initializing AI Services...
+MARIA v3.0.0 follows **Minimal API, Maximum Power**:
 
-Local AI Services:
-LM Studio    [●●●●●●●●●●●●●●●●●●●] 0% ⚙️ Checking availability...
-Ollama       [●●●●●●●●●●●●●●●●●●●] 0% ⚙️ Checking availability...
-vLLM         [●●●●●●●●●●●●●●●●●●●] 0% ⚙️ Checking availability...
-
-🚀 Initializing AI Services...
-
-> _
 ```
-
-**💻 Core Development Commands (Essential for Engineers):**
-
-```bash
-/code <prompt>    # AI-powered code generation with memory learning
-/test <prompt>    # Generate comprehensive test suites
-/bug              # Intelligent bug detection & auto-fix
-/review           # Professional code review & optimization
-/paper <query>    # Transform research papers into working code
+┌─────────────────────────────────────────┐
+│           MARIA v3.0.0                  │
+├─────────────────────────────────────────┤
+│ 🧠 IntelligentRouterService             │
+│   ├── Smart command routing             │
+│   ├── Context-aware analysis            │
+│   └── Learning capabilities             │
+├─────────────────────────────────────────┤
+│ 🧩 DualMemoryEngine                     │
+│   ├── System 1: Fast, intuitive        │
+│   ├── System 2: Deliberate, analytical │
+│   └── Cross-session learning            │
+├─────────────────────────────────────────┤
+│ 📁 FileSystemService                    │
+│   ├── Atomic operations                 │
+│   ├── Backup management                 │
+│   └── Safety validation                 │
+└─────────────────────────────────────────┘
 ```
 
-**🏠 Local AI Integration (Privacy-First Development):**
+### Key Features
 
-```bash
-/model            # Interactive model selector (↑/↓ arrows)
-/status           # Check all AI service availability
-maria setup-ollama    # Auto-configure Ollama (CLI command)
-maria setup-vllm      # Auto-configure vLLM (CLI command)
-```
+| Feature | Description | Status |
+|---------|-------------|--------|
+| **Beautiful CLI** | Professional startup with AI provider selection | ✅ |
+| **Dynamic Version** | Auto-sourced from package.json | ✅ |
+| **3 Core Services** | Essential AI development capabilities | ✅ |
+| **Type Safety** | 100% TypeScript with strict mode | ✅ |
+| **Zero Config** | Works out of the box | ✅ |
+| **8 AI Providers** | OpenAI, Anthropic, Google, Groq, xAI, Ollama, LM Studio, vLLM | ✅ |
 
-**🧠 Advanced Intelligence Features (For Researchers):**
-
-```bash
-/mode             # Access 50+ cognitive modes (✽ Thinking, ✽ Analyzing...)
-/memory           # Dual-layer memory system status & management
-/agents           # Deploy specialized AI research assistants
-/mcp              # Model Context Protocol integration
-/chain <commands> # Command chaining for complex workflows
-```
+## 🚀 Performance
 
-**🌍 Natural Language Support (5 Languages):**
+### Metrics
+- **Startup Time**: < 1000ms cold start
+- **Memory Usage**: < 256MB heap maximum  
+- **Bundle Size**: 192KB (optimized)
+- **API Response**: < 100ms for core operations
 
+### Benchmarks
 ```bash
-English:  "write code"       # → /code
-Japanese: "コードを書いて"     # → /code
-Chinese:  "写代码"           # → /code
-Korean:   "코드를 작성해"     # → /code
-Vietnamese: "viết code"      # → /code
+# Run performance benchmarks
+pnpm perf:bench
 ```
 
-**🎨 Creative & Productivity Tools:**
+## 🛠️ Development
 
-```bash
-/image <prompt>   # AI image generation for presentations
-/video <prompt>   # Create demo videos & documentation
-/avatar           # Interactive ASCII avatar companion
-/template         # Code template management
-/alias            # Custom command aliases
-```
-
-### Alternative Installation Methods
+### Requirements
+- Node.js 20.10.0+
+- pnpm v10.10.0 (recommended)
+- TypeScript 5.0+
 
+### Build Commands
 ```bash
-# Using yarn
-yarn global add @bonginkan/maria
-
-# Using pnpm
-pnpm add -g @bonginkan/maria
-```
+# Install dependencies
+pnpm install
 
-## 🎯 Usage Examples
+# Build the project
+pnpm build
 
-### Basic Interactive Mode
+# Run tests
+pnpm test
 
-```bash
-# Start MARIA interactive CLI (default command)
-maria
+# Type checking
+pnpm type-check
 
-# One-shot commands (non-interactive)
-maria ask "How do I implement OAuth?"
-maria code "React component for login"
-maria vision image.png "Describe this diagram"
-
-# Available slash commands in interactive mode:
-> /help                          # Show all 40+ commands
-> /code "hello world function"   # AI code generation with memory
-> /model                         # Interactive model selector
-> /memory                        # Dual-layer memory system
-> /status                        # System & AI service status
-> /agents                        # Multi-agent orchestration
-> /exit                          # Exit interactive mode
+# Lint code
+pnpm lint
 ```
 
-### Algorithm Education Commands
+### Command Registry
+MARIA v3.0.0 includes a revolutionary command registry with:
+- **68+ Commands**: Full enterprise command suite
+- **Type Safety**: Runtime validation with TypeScript support  
+- **Fuzzy Search**: Smart typo tolerance (`/hlp` → `/help`)
+- **Auto-Generation**: Automated type generation
+- **7 Categories**: From core commands to AI coding agent
 
 ```bash
-# Start MARIA and use algorithm education slash commands
-maria
-> /sort quicksort --visualize     # Interactive sorting visualization
-> /learn algorithms               # Complete CS curriculum
-> /benchmark sorting              # Performance analysis
-> /algorithm complexity           # Big O notation tutorials
-> /code "merge sort implementation" # AI-generated algorithms
-```
-
-### 40+ Interactive Slash Commands
+# Generate command types
+pnpm gen:cmd-types
 
-```bash
-# All commands are slash commands within interactive mode
-maria
-> /help                          # Show all 40+ commands
-> /model                         # Interactive AI model selection
-> /code "function"               # AI code generation with memory
-> /test "unit tests"             # Generate comprehensive tests
-> /memory                        # Dual-layer memory system
-> /agents                        # Multi-agent orchestration
-> /paper "ML optimization"       # Research paper to code
-> /status                        # System & AI service status
-> /exit                          # Exit MARIA
+# Test registry integrity  
+pnpm test:registry
 ```
 
-## 🎨 Key Features
-
-### 🤖 Autonomous Coding Agent
-
-- **Complete SOW Generation**: Automatic Statement of Work creation
-- **Visual Mode Display**: Real-time progress with beautiful UI
-- **Active Reporting**: Progress tracking and status updates
-- **Self-Evolution**: Learning engine that improves over time
-- **120+ Engineering Modes**: Professional development patterns
-
-### 📊 Algorithm Education Platform
+## 📱 AI Provider Support
 
-- **Interactive QuickSort**: Step-by-step algorithm visualization
-- **Performance Benchmarking**: Compare algorithm efficiency
-- **Memory Profiling**: Analyze memory usage patterns
-- **Educational Tools**: Computer science curriculum support
-- **Sorting Algorithms**: Complete collection with analysis
+### Cloud Providers
+- **OpenAI** - GPT models with vision and reasoning
+- **Anthropic** - Claude models with advanced reasoning
+- **Google** - Gemini models with multimodal capabilities
+- **Groq** - Ultra-fast inference
+- **xAI** - Grok models with real-time data
 
-### 🔧 Development Tools
+### Local Providers  
+- **Ollama** - Local LLM runner
+- **LM Studio** - Local model management
+- **vLLM** - High-performance inference server
 
-- **AI Code Generation**: Multi-language code creation
-- **Intelligent Assistance**: Context-aware development help
-- **Project Analysis**: Codebase understanding and insights
-- **Quality Assurance**: Automated testing and validation
-- **Version Control**: Git integration and workflow support
+## 🌍 Multi-Language Support
 
-## 🌍 Supported Platforms
-
-- **Node.js**: 18.0.0 - 22.x
-- **Primary OS Support**: macOS, Linux (optimized)
-- **Secondary OS Support**: Windows 
-- **Terminals**: All major terminal applications
-- **Shells**: bash, zsh (recommended), fish, PowerShell
+MARIA supports development in multiple languages:
+- 🇺🇸 **English** - Primary language
+- 🇯🇵 **Japanese** - 日本語サポート
+- 🇨🇳 **Chinese** - 中文支持  
+- 🇰🇷 **Korean** - 한국어 지원
+- 🇻🇳 **Vietnamese** - Hỗ trợ tiếng Việt
 
 ## 📚 Documentation
 
-### Command Reference
-
-- **Interactive Mode**: `maria` (starts directly)
-- **All Commands**: `/help` within interactive mode
-- **Algorithm Education**: `/sort`, `/learn`, `/algorithm` commands
-- **AI Development**: `/code`, `/bug`, `/lint`, `/model` commands
-- **System Status**: `/status` command
-
-### Examples and Tutorials
+### API Documentation
+- **IntelligentRouterService**: [API Reference](docs/api/router.md)
+- **DualMemoryEngine**: [API Reference](docs/api/memory.md)
+- **FileSystemService**: [API Reference](docs/api/filesystem.md)
 
-- **Getting Started**: Run `maria` and type `/help`
-- **Algorithm Learning**: Use `/sort quicksort --visualize` for interactive tutorials
-- **Development Workflow**: AI-assisted coding with `/code` commands
-- **Performance Analysis**: Built-in benchmarking with `/benchmark` commands
-
-## 🔧 Configuration
-
-MARIA works out of the box with no configuration required. For advanced features:
-
-```bash
-# Start interactive mode (default)
-maria
-
-# Check system status
-> /status
-
-# Configure AI providers
-> /model  # Select from 22+ AI models (GPT, Claude, Gemini, Local LLMs)
-
-# Algorithm education
-> /sort quicksort --visualize  # Interactive learning
-```
+### Guides
+- **Quick Start**: [Getting Started Guide](docs/quickstart.md)
+- **CLI Usage**: [Command Line Interface](docs/cli.md)
+- **Configuration**: [Configuration Guide](docs/config.md)
 
 ## 🤝 Contributing
 
-We welcome contributions to MARIA! Please check our [contribution guidelines](https://github.com/bonginkan/maria/blob/main/CONTRIBUTING.md).
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
 
 ### Development Setup
-
 ```bash
-# Clone the repository
+# Clone repository
 git clone https://github.com/bonginkan/maria.git
 cd maria
 
 # Install dependencies
-npm install
+pnpm install
 
-# Build the project
-npm run build
+# Run development build
+pnpm dev
 
-# Run locally
-./bin/maria
+# Run tests
+pnpm test
+
+# Submit pull request
 ```
 
 ## 📄 License
 
-**Dual-License Model**: Personal Use (Free) / Enterprise (Paid)
-
-- **Personal Use**: Free for individuals, students, and startups (<10 employees, <$1M ARR)
-- **Enterprise**: Commercial license required for larger organizations
-- **Contact**: enterprise@bonginkan.ai for enterprise licensing
+**Dual License Model:**
+- **Personal Use**: MIT License - Free for individual developers
+- **Enterprise Use**: Commercial License - Contact for enterprise pricing
 
-See [LICENSE](https://github.com/bonginkan/maria/blob/main/LICENSE) for complete terms.
+See [LICENSE](LICENSE) for full details.
 
 ## 🔗 Links
 
-- **NPM Package**: [npmjs.com/package/@bonginkan/maria](https://www.npmjs.com/package/@bonginkan/maria)
-- **GitHub Repository**: [github.com/bonginkan/maria](https://github.com/bonginkan/maria)
-- **Documentation**: Available via `maria --help`
-- **Support**: [GitHub Issues](https://github.com/bonginkan/maria/issues)
-
-## 🎯 What Makes MARIA Special
+- **NPM Package**: https://www.npmjs.com/package/@bonginkan/maria
+- **GitHub Repository**: https://github.com/bonginkan/maria
+- **Documentation**: https://docs.maria-ai.dev
+- **Support**: https://github.com/bonginkan/maria/issues
 
-### Revolutionary AI Development
+## 🎉 What's New in v3.0.0
 
-- **First Autonomous AI**: Complete software development from requirements
-- **Visual Progress**: Beautiful CLI with real-time feedback
-- **Educational Focus**: Algorithm learning with interactive visualization
-- **Professional Quality**: Industry-standard engineering practices
+### ✨ 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
 
-### Cutting-Edge Technology
+### 🚨 Breaking Changes from v2.x
+- **API Simplification**: Many internal services no longer exposed
+- **New CLI Interface**: Updated startup and provider selection flow
+- **Configuration Changes**: Streamlined config format
 
-- **Advanced AI Integration**: Multiple AI model support
-- **Intelligent Automation**: Self-learning and adaptation
-- **Modern CLI Experience**: Beautiful, responsive interface
-- **Cross-Platform**: Works everywhere Node.js runs
-
-### Perfect for:
-
-<<<<<<< HEAD
-session.addStep({ id: 'upload', name: 'Upload to Cloud API' });
-session.startStep('upload');
-session.updateProgress('upload', 75, 'Uploading image...');
-session.completeStep('upload');
-```
-
-### **Multi-Provider Vision AI**
-```typescript
-// Intelligent provider selection with fallback
-const visionAnalyzer = new VisionAnalyzer({
-  preferredProvider: 'auto', // Gemini → GPT-4o-mini → Local OCR
-  enableLocalFallback: true,
-  networkTimeout: 10000
-});
-```
-
-## 🔧 **Configuration**
-
-### **Environment Setup**
+### 🔄 Migration Guide
 ```bash
-# Create .env.local file
-OPENAI_API_KEY=sk-...
-ANTHROPIC_API_KEY=sk-ant-...
-GOOGLE_API_KEY=...
-GROQ_API_KEY=gsk_...
-
-# Local LLM Configuration (auto-detected)
-OLLAMA_BASE_URL=http://localhost:11434
-VLLM_BASE_URL=http://localhost:8000
-LMSTUDIO_BASE_URL=http://localhost:1234
-```
+# Update to v3.0.0
+npm update @bonginkan/maria
 
-### **Advanced Configuration**
-```javascript
-// .maria/config.json
-{
-  "cliNative": {
-    "enableAudit": true,
-    "enableSafety": true,
-    "parallelExecution": true,
-    "dryRunByDefault": false
-  },
-  "visionAI": {
-    "preferredProvider": "gemini-2.0-flash",
-    "enableLocalFallback": true,
-    "networkTimeout": 10000
-  },
-  "progressReporting": {
-    "showAnimations": true,
-    "compactMode": false,
-    "showTimestamps": true
-  }
-}
-```
+# Update imports
+// Before (v2.x)
+import { ComplexService, InternalAPI } from '@bonginkan/maria';
 
-## 📊 **Technical Specifications**
-
-### **Performance Metrics**
-- **Build Performance**: Up to 3x faster with intelligent caching
-- **Test Optimization**: 50-80% reduction in execution time  
-- **Memory Operations**: <50ms response time
-- **Service Discovery**: Sub-50ms service lookup
-- **API Gateway**: 10,000+ RPS with load balancing
-
-### **Architecture**
-- **Components**: 100+ TypeScript modules
-- **Commands**: 50+ professional CLI commands
-- **Cognitive Modes**: 58+ specialized AI states
-- **Vision Providers**: 3 providers (Gemini, OpenAI, local OCR)
-- **Memory System**: Event sourcing with SQLite persistence
-
-### **Enterprise Features**
-- **Security**: End-to-end authentication and authorization
-- **Scalability**: Auto-scaling based on metrics and thresholds
-- **Reliability**: Circuit breakers and automatic recovery
-- **Observability**: Full-stack monitoring with distributed tracing
-- **Compliance**: Audit logging and security scanning
-
-## 🛡️ **Safety & Security**
-
-- **Dry-Run Mode**: Preview all changes before execution
-- **Automatic Backups**: Before any destructive operation
-- **Rollback Capability**: Complete undo functionality
-- **Protected Paths**: Prevents system-critical modifications
-- **Risk Assessment**: Automatic danger level evaluation
-
-## 🎓 **Learning Resources**
-
-### **Documentation**
-- [CLI Command Reference](https://maria.ai/docs/cli-commands)
-- [Vision AI Integration](https://maria.ai/docs/vision-ai)
-- [Microservices Guide](https://maria.ai/docs/microservices)
-- [Memory System](https://maria.ai/docs/memory-system)
-
-### **Examples & Tutorials**
-- [Getting Started Tutorial](https://maria.ai/tutorials/getting-started)
-- [Image Processing Workflow](https://maria.ai/tutorials/image-processing)
-- [Microservices Deployment](https://maria.ai/tutorials/microservices)
-- [CLI Native Development](https://maria.ai/tutorials/cli-native)
-
-## 🏆 **Why Choose MARIA v2.1.9?**
-
-✅ **Complete Local Development** - Full AI capabilities offline  
-✅ **Professional UX** - Enterprise-grade interface with rich feedback  
-✅ **Advanced Vision AI** - Multi-provider image processing with fallback  
-✅ **CLI Native Workflow** - Complete development without leaving terminal  
-✅ **Microservices Ready** - Enterprise architecture out of the box  
-✅ **Ultra Memory System** - Learns from every interaction  
-✅ **Privacy-First** - Your code stays on your machine  
-✅ **Production Ready** - 100% tested with comprehensive safety systems  
-
-## 🚦 **System Requirements**
-
-- **Node.js**: 18.0.0 or higher
-- **Memory**: 4GB RAM minimum (8GB recommended)
-- **Storage**: 2GB free space
-- **Platform**: Windows, macOS, Linux
-- **Optional**: Docker for microservices features
-
-## 💬 **Community & Support**
-
-- **GitHub**: [bonginkan/maria](https://github.com/bonginkan/maria)
-- **Issues**: [Report bugs & request features](https://github.com/bonginkan/maria/issues)
-- **Discord**: [MARIA Community](https://discord.gg/maria)
-- **Email**: support@maria.ai
-
-## 🐛 What's Fixed in v3.0.7
-
-- ✅ All undefined variable errors in core services
-- ✅ `/clear` command execution errors
-- ✅ `/model` command variable references  
-- ✅ `/version` command display
-- ✅ Help command showing accurate counts
-- ✅ Hidden broken commands from help display
-- ✅ Dynamic command counting in `/help`
-
-## 📄 **License**
-
-Dual-License (Commercial & Open Source) - See [LICENSE](./LICENSE) for details.
-=======
-- **Students**: Learn algorithms with interactive visualization
-- **Developers**: Accelerate development with AI assistance
-- **Teams**: Collaborative development with autonomous agents
-- **Educators**: Teach computer science with hands-on tools
->>>>>>> origin/main
+// After (v3.0.0) 
+import { IntelligentRouterService, DualMemoryEngine } from '@bonginkan/maria';
+```
 
 ---
 
-**Experience the Multi-Language Intelligence Revolution with MARIA Platform v2.2.1**
-
-🚀 Start your journey: `npm install -g @bonginkan/maria && maria`
+**Experience the power of minimal design. Experience MARIA v3.0.0.**
 
-**グローバル対応 (Global Support)**: Supporting international development teams with native language interfaces 🌏👥🔄
+*© 2025 Bonginkan Inc. - AI-Powered Development Platform*