@bonginkan/maria 2.1.7 → 2.1.9

package/COMMANDS.md

@@ -0,0 +1,177 @@
+# 📋 MARIA Platform Command Reference
+
+Complete reference for all 36+ interactive slash commands in MARIA Platform v1.6.4
+
+## 🚀 How to Use Commands
+
+All commands in MARIA are **slash commands** used within interactive mode:
+
+```bash
+# Start MARIA interactive mode
+maria
+
+# Use slash commands within MARIA
+> /command_name [options]
+```
+
+## 🎓 Algorithm Education Commands
+
+### Sorting Algorithms
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/sort quicksort` | Interactive quicksort tutorial | `--visualize`, `--benchmark` | `/sort quicksort --visualize` |
+| `/sort mergesort` | Interactive merge sort tutorial | `--visualize`, `--benchmark` | `/sort mergesort --benchmark` |
+| `/sort heapsort` | Interactive heap sort tutorial | `--visualize`, `--benchmark` | `/sort heapsort` |
+| `/sort bubblesort` | Interactive bubble sort tutorial | `--visualize` | `/sort bubblesort --visualize` |
+| `/sort insertionsort` | Interactive insertion sort tutorial | `--visualize` | `/sort insertionsort` |
+
+### Learning & Analysis
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/learn algorithms` | Complete CS curriculum | `--topic [name]` | `/learn algorithms --topic sorting` |
+| `/algorithm complexity` | Big O notation tutorials | `--algorithm [name]` | `/algorithm complexity --algorithm quicksort` |
+| `/benchmark sorting` | Performance analysis | `--size [n]`, `--iterations [n]` | `/benchmark sorting --size 10000` |
+| `/analyze performance` | Memory and time analysis | `--algorithm [name]` | `/analyze performance --algorithm mergesort` |
+
+## 🤖 AI Development Commands
+
+### Code Generation
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/code "description"` | AI code generation | `--language [lang]`, `--style [style]` | `/code "REST API" --language python` |
+| `/generate function` | Generate specific functions | `--type [type]`, `--complexity [level]` | `/generate function --type sorting` |
+| `/implement algorithm` | Implement algorithms | `--language [lang]`, `--optimize` | `/implement algorithm --language typescript` |
+| `/refactor code` | Refactor existing code | `--style [style]`, `--optimize` | `/refactor code --optimize` |
+
+### Code Quality & Analysis
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/bug analyze` | Bug detection and fixes | `--file [path]`, `--severity [level]` | `/bug analyze --file src/app.js` |
+| `/lint check` | Code quality analysis | `--fix`, `--rules [ruleset]` | `/lint check --fix` |
+| `/security review` | Security vulnerability scan | `--level [level]` | `/security review --level strict` |
+| `/performance profile` | Performance profiling | `--type [type]` | `/performance profile --type memory` |
+
+## 🧠 AI Model & Mode Commands
+
+### Model Management
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/model` | AI model selection | `--provider [name]`, `--list` | `/model --provider openai` |
+| `/model list` | Show available models | `--provider [name]` | `/model list --provider anthropic` |
+| `/model switch` | Switch AI model | `--to [model_name]` | `/model switch --to gpt-4` |
+| `/model config` | Configure model settings | `--temperature [n]`, `--max-tokens [n]` | `/model config --temperature 0.7` |
+
+### Cognitive Modes
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/mode internal` | Access 50 cognitive AI modes | `--list`, `--mode [name]` | `/mode internal --mode debugging` |
+| `/mode list` | List all cognitive modes | `--category [type]` | `/mode list --category creative` |
+| `/mode switch` | Switch cognitive mode | `--to [mode_name]` | `/mode switch --to optimizing` |
+| `/thinking mode` | Enter thinking mode | `--depth [level]` | `/thinking mode --depth deep` |
+
+## 🔧 System & Utility Commands
+
+### System Management
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/status` | System status and health | `--detailed`, `--services` | `/status --detailed` |
+| `/config` | Configuration management | `--set [key=value]`, `--get [key]` | `/config --set theme=dark` |
+| `/update` | Check for updates | `--install`, `--check` | `/update --check` |
+| `/reset` | Reset MARIA settings | `--confirm`, `--keep-models` | `/reset --keep-models` |
+
+### Help & Information  
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/help` | Show all commands | `--category [name]`, `--search [term]` | `/help --category algorithm` |
+| `/docs` | Access documentation | `--topic [name]`, `--search [term]` | `/docs --topic quicksort` |
+| `/examples` | Show command examples | `--command [name]` | `/examples --command sort` |
+| `/tutorial` | Interactive tutorials | `--topic [name]`, `--level [level]` | `/tutorial --topic algorithms` |
+
+### Session Management
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/history` | Command history | `--search [term]`, `--clear` | `/history --search sort` |
+| `/save session` | Save current session | `--name [name]` | `/save session --name my_work` |
+| `/load session` | Load saved session | `--name [name]`, `--list` | `/load session --name my_work` |
+| `/clear` | Clear screen | `--history`, `--all` | `/clear --history` |
+| `/exit` | Exit MARIA | `--save`, `--force` | `/exit --save` |
+
+## 🚀 Advanced Features
+
+### Multi-Agent Commands
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/agent create` | Create autonomous agent | `--task [description]` | `/agent create --task "build API"` |
+| `/agent list` | List active agents | `--status [status]` | `/agent list --status active` |
+| `/agent stop` | Stop agent execution | `--id [agent_id]` | `/agent stop --id agent_123` |
+| `/orchestrate` | Multi-agent coordination | `--agents [list]` | `/orchestrate --agents "dev,test,deploy"` |
+
+### Integration Commands
+| Command | Description | Options | Example |
+|---------|-------------|---------|---------|
+| `/git integrate` | Git integration | `--status`, `--commit [message]` | `/git integrate --status` |
+| `/project analyze` | Project analysis | `--deep`, `--report` | `/project analyze --deep` |
+| `/export results` | Export session results | `--format [type]`, `--file [path]` | `/export results --format json` |
+
+## 💡 Usage Tips
+
+### Command Shortcuts
+- Use **Tab completion** for command names and options
+- **Up/Down arrows** to navigate command history
+- **Ctrl+C** to cancel current operation
+- **Ctrl+L** to clear screen (same as `/clear`)
+
+### Option Patterns
+- `--help` works with any command for detailed help
+- `--verbose` or `-v` for detailed output
+- `--quiet` or `-q` for minimal output
+- `--dry-run` to preview actions without executing
+
+### Combining Commands
+```bash
+# Chain operations
+> /sort quicksort --visualize && /benchmark sorting
+
+# Use command output
+> /model list --provider openai | /config --set preferred-model
+
+# Save and reuse
+> /save session --name algo_learning
+> /tutorial --topic sorting && /save session --name algo_complete
+```
+
+## 🔍 Command Categories
+
+### 🎓 Education (8 commands)
+`/sort`, `/learn`, `/algorithm`, `/benchmark`, `/analyze`, `/tutorial`, `/examples`, `/docs`
+
+### 🤖 AI Development (10 commands)  
+`/code`, `/generate`, `/implement`, `/refactor`, `/model`, `/mode`, `/thinking`, `/bug`, `/lint`, `/security`
+
+### 🔧 System (8 commands)
+`/status`, `/config`, `/update`, `/reset`, `/help`, `/history`, `/clear`, `/exit`
+
+### 🚀 Advanced (6 commands)
+`/agent`, `/orchestrate`, `/git`, `/project`, `/export`, `/performance`
+
+### 💾 Session (4 commands)
+`/save`, `/load`, `/history`, `/clear`
+
+## 🆘 Getting Help
+
+```bash
+# General help
+> /help
+
+# Help for specific command
+> /sort --help
+> /model --help
+
+# Search help
+> /help --search "algorithm"
+
+# Show examples
+> /examples --command code
+```
+
+**Total Commands: 36+ interactive slash commands for complete AI-powered development and algorithm education experience!**

package/GETTING_STARTED.md

@@ -0,0 +1,183 @@
+# 🎯 Getting Started with MARIA Platform
+
+Welcome to MARIA Platform v1.6.4 "Algorithm Education Revolution"! This guide will help you get up and running in minutes.
+
+## 🚀 Quick Start (2 Minutes)
+
+### Step 1: Install MARIA
+```bash
+npm install -g @bonginkan/maria
+```
+
+### Step 2: Verify Installation
+```bash
+maria --version
+# Should output: MARIA Platform v1.6.4 "Algorithm Education Revolution"
+```
+
+### Step 3: Start Interactive Mode
+```bash
+maria
+```
+
+You should see the welcome screen with MARIA's beautiful ASCII logo and interactive prompt.
+
+### Step 4: Try Your First Commands
+```bash
+# Within MARIA interactive mode:
+> /help                          # See all available commands
+> /sort quicksort --visualize    # Try algorithm education
+> /code "hello world function"   # Generate code with AI
+> /status                        # Check system status
+> /exit                          # Exit when done
+```
+
+**Congratulations! 🎉 You're now ready to explore MARIA's full potential.**
+
+## 🎓 Learning Paths
+
+### For Computer Science Students
+
+**Goal**: Learn algorithms and data structures interactively
+
+```bash
+maria
+> /help                          # Overview of all commands
+> /sort quicksort               # Learn quicksort algorithm
+> /sort mergesort               # Learn merge sort
+> /learn algorithms             # Complete CS curriculum
+> /benchmark sorting            # Compare algorithm performance
+> /algorithm complexity         # Big O notation tutorials
+```
+
+**Daily Practice** (15 minutes):
+1. Start with one algorithm: `/sort [algorithm_name]`
+2. Study the implementation details
+3. Try performance analysis: `/benchmark [algorithm_name]`
+4. Practice with code generation: `/code "implement [algorithm]"`
+
+### For Software Developers
+
+**Goal**: AI-powered development assistance and code quality
+
+```bash
+maria
+> /model                        # Configure preferred AI model
+> /code "function description"  # Generate code with AI
+> /bug analyze                  # Bug detection and fixes
+> /lint check                   # Code quality analysis
+> /mode internal                # Experience 50 cognitive AI modes
+```
+
+**Development Workflow**:
+1. Start MARIA: `maria`
+2. Set preferred AI model: `/model`
+3. Use for coding tasks: `/code`, `/bug`, `/lint`
+4. Leverage AI modes for different tasks
+5. Learn algorithms for better coding: `/sort`, `/learn`
+
+### For Educators
+
+**Goal**: Teach computer science with interactive tools
+
+```bash
+maria
+> /learn algorithms             # Access full CS curriculum
+> /sort quicksort --visualize   # Interactive algorithm demos
+> /algorithm complexity         # Teach Big O notation
+> /benchmark sorting            # Show performance differences
+> /help                         # Command reference for lessons
+```
+
+**Classroom Integration**:
+1. Install MARIA on classroom computers
+2. Create lesson plans using algorithm commands
+3. Use visualization features for demonstrations
+4. Assign interactive algorithm practice
+5. Show real-world performance comparisons
+
+## 🔧 Essential Commands Reference
+
+### Algorithm Education
+| Command | Description | Example |
+|---------|-------------|---------|
+| `/sort [algorithm]` | Interactive algorithm tutorial | `/sort quicksort` |
+| `/learn algorithms` | Complete CS curriculum | `/learn algorithms` |
+| `/benchmark [type]` | Performance analysis | `/benchmark sorting` |
+| `/algorithm complexity` | Big O notation guide | `/algorithm complexity` |
+
+### AI Development
+| Command | Description | Example |
+|---------|-------------|---------|
+| `/code "description"` | AI code generation | `/code "REST API"` |
+| `/bug analyze` | Bug detection | `/bug analyze` |
+| `/lint check` | Code quality | `/lint check` |
+| `/model` | AI model selection | `/model` |
+
+### System & Help
+| Command | Description | Example |
+|---------|-------------|---------|
+| `/help` | Show all commands | `/help` |
+| `/status` | System status | `/status` |
+| `/mode internal` | Cognitive AI modes | `/mode internal` |
+| `/exit` | Exit MARIA | `/exit` |
+
+## 🎯 First Week Challenge
+
+### Day 1-2: Setup & Exploration
+- Install MARIA
+- Try all basic commands with `/help`
+- Explore algorithm education with `/sort quicksort`
+
+### Day 3-4: Algorithm Learning
+- Learn 3 sorting algorithms: quicksort, mergesort, heapsort
+- Compare their performance with `/benchmark`
+- Understand complexity with `/algorithm complexity`
+
+### Day 5-6: AI Development
+- Configure AI model with `/model`
+- Generate code with `/code` commands
+- Try bug analysis and code quality tools
+
+### Day 7: Advanced Features
+- Explore 50 cognitive AI modes with `/mode internal`
+- Try complex code generation tasks
+- Share your experience with the community
+
+## 💡 Pro Tips
+
+1. **Command Memory**: Use `/help` frequently until you memorize commands
+2. **Tab Completion**: Most terminals support tab completion for faster typing
+3. **Copy & Paste**: Copy generated code directly from MARIA output
+4. **Multiple Sessions**: You can run multiple MARIA instances simultaneously
+5. **Learning Notes**: Keep a notebook of algorithms you've learned
+
+## 🌟 What's Next?
+
+After mastering the basics:
+
+1. **Deep Algorithm Study**: Complete the full CS curriculum with `/learn`
+2. **AI Model Experimentation**: Try different AI models for various tasks
+3. **Performance Optimization**: Use benchmarking tools for your own code
+4. **Community Engagement**: Share your learning journey
+5. **Advanced Features**: Explore autonomous coding capabilities
+
+## 🆘 Need Help?
+
+- **Built-in Help**: `/help` command within MARIA
+- **System Check**: `/status` for diagnostics
+- **GitHub Issues**: [Report problems](https://github.com/bonginkan/maria/issues)
+- **NPM Package**: [View documentation](https://www.npmjs.com/package/@bonginkan/maria)
+
+## 🎉 Welcome to the Future
+
+You're now part of the Algorithm Education Revolution! MARIA Platform combines:
+
+- ✅ Interactive algorithm learning
+- ✅ AI-powered development assistance  
+- ✅ 50 cognitive AI modes
+- ✅ 36+ interactive commands
+- ✅ Real-time performance analysis
+- ✅ Complete CS curriculum
+
+**Start exploring and happy learning! 🚀📚✨**

package/LICENSE

@@ -1,3 +1,4 @@
+<<<<<<< HEAD
 MARIA Platform Dual-License Agreement
 
 Copyright (c) 2025 Bonginkan Inc. All rights reserved.
@@ -103,4 +104,27 @@ CONTACT INFORMATION:
 By using MARIA Platform, you acknowledge that you have read, understood, and 
 agree to be bound by the terms of this dual-license agreement.
 
-For the most current license terms, visit: https://docs.maria-platform.ai/license
+For the most current license terms, visit: https://docs.maria-platform.ai/license
+=======
+MIT License
+
+Copyright (c) 2025 Bonginkan Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+>>>>>>> 73f1a492c8b30ad4210f6a8d16116a915db9e914