@bonginkan/maria 1.6.2 → 1.6.4

package/SETUP.md

@@ -0,0 +1,236 @@
+# 🚀 MARIA Platform Setup Guide
+
+Complete setup instructions for MARIA Platform v1.6.4 "Algorithm Education Revolution"
+
+## 📋 System Requirements
+
+### Minimum Requirements
+- **Node.js**: 18.0.0 or higher (up to 22.x)
+- **npm**: 8.0.0 or higher
+- **Operating System**: macOS, Linux, Windows
+- **Terminal**: Any modern terminal application
+- **Memory**: 512MB available RAM
+- **Storage**: 100MB disk space
+
+### Recommended Setup
+- **Node.js**: 20.x LTS
+- **Terminal**: iTerm2 (macOS), Windows Terminal, or VS Code integrated terminal
+- **Shell**: bash, zsh, fish, or PowerShell
+- **Memory**: 1GB+ available RAM for optimal performance
+
+## 🛠️ Installation Methods
+
+### Method 1: NPM Global Installation (Recommended)
+
+```bash
+# Install globally via npm
+npm install -g @bonginkan/maria
+
+# Verify installation
+maria --version
+# Expected output: MARIA Platform v1.6.4 "Algorithm Education Revolution"
+
+# Test interactive mode
+maria
+# Should start interactive CLI with welcome message
+```
+
+### Method 2: Alternative Package Managers
+
+```bash
+# Using Yarn
+yarn global add @bonginkan/maria
+
+# Using pnpm
+pnpm add -g @bonginkan/maria
+
+# Using npx (temporary usage)
+npx @bonginkan/maria
+```
+
+### Method 3: Local Project Installation
+
+```bash
+# Install in project
+npm install @bonginkan/maria
+
+# Run locally
+npx maria
+
+# Or add to package.json scripts
+{
+  "scripts": {
+    "ai": "maria"
+  }
+}
+```
+
+## ⚡ Quick Start Guide
+
+### 1. First Launch
+```bash
+# Start MARIA interactive mode
+maria
+
+# You should see:
+# 🤖 MARIA Platform v1.6.4 "Algorithm Education Revolution"
+# Interactive AI Development CLI with Complete CS Curriculum
+```
+
+### 2. Basic Commands
+```bash
+# Within interactive mode, try these commands:
+> /help                          # Show all 36+ commands
+> /status                        # Check system status
+> /model                         # Configure AI providers
+> /sort quicksort --visualize    # Try algorithm education
+> /code "hello world function"   # AI code generation
+> /exit                          # Exit MARIA
+```
+
+### 3. Algorithm Education
+```bash
+# Start learning algorithms
+> /sort quicksort               # Interactive quicksort tutorial
+> /learn algorithms             # Complete CS curriculum
+> /benchmark sorting            # Performance analysis
+> /algorithm complexity         # Big O notation guide
+```
+
+## 🔧 Configuration
+
+### AI Model Setup (Optional)
+
+MARIA works out of the box with default models, but you can configure additional AI providers:
+
+```bash
+# Start MARIA and configure models
+maria
+> /model
+
+# Available options:
+# - OpenAI GPT models (API key required)
+# - Anthropic Claude (API key required) 
+# - Google Gemini (API key required)
+# - Local LLMs (LM Studio, Ollama)
+# - Groq models (API key required)
+```
+
+### Environment Variables (Optional)
+
+Create a `.env` file in your project or set system environment variables:
+
+```bash
+# AI Provider API Keys (optional)
+OPENAI_API_KEY=sk-your-key-here
+ANTHROPIC_API_KEY=sk-ant-your-key-here
+GOOGLE_AI_API_KEY=your-google-key-here
+GROQ_API_KEY=gsk-your-groq-key-here
+
+# Local AI Models (optional)
+LMSTUDIO_API_URL=http://localhost:1234
+OLLAMA_API_URL=http://localhost:11434
+```
+
+## 🎓 Learning Path
+
+### For Students & Beginners
+1. Start with basic installation: `npm install -g @bonginkan/maria`
+2. Launch interactive mode: `maria`
+3. Try algorithm education: `/sort quicksort --visualize`
+4. Explore help system: `/help`
+5. Learn coding basics: `/code "simple function"`
+
+### For Developers
+1. Install MARIA: `npm install -g @bonginkan/maria`
+2. Configure preferred AI model: `/model`
+3. Try development commands: `/code`, `/bug`, `/lint`
+4. Explore advanced features: `/status`, `/mode internal`
+5. Integrate with workflow: Use MARIA for coding assistance
+
+### For Educators
+1. Install for classroom use: `npm install -g @bonginkan/maria`
+2. Explore algorithm curriculum: `/learn algorithms`
+3. Use visualization tools: `/sort --visualize`
+4. Create lesson plans with `/help` command reference
+5. Demonstrate CS concepts with interactive examples
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+#### Permission Errors
+```bash
+# If you get permission errors on macOS/Linux:
+sudo npm install -g @bonginkan/maria
+
+# Or use npm prefix:
+npm config set prefix ~/.npm-global
+export PATH=~/.npm-global/bin:$PATH
+npm install -g @bonginkan/maria
+```
+
+#### Node.js Version Issues
+```bash
+# Check Node.js version
+node --version
+
+# If version is too old, update Node.js:
+# Visit https://nodejs.org/ for latest LTS version
+```
+
+#### Command Not Found
+```bash
+# Check if MARIA is in PATH
+which maria
+
+# If not found, try:
+npm list -g @bonginkan/maria
+
+# Reinstall if necessary:
+npm uninstall -g @bonginkan/maria
+npm install -g @bonginkan/maria
+```
+
+#### Interactive Mode Issues
+```bash
+# If interactive mode doesn't start:
+maria --help
+
+# Check for terminal compatibility:
+echo $TERM
+
+# Try different terminal or shell
+```
+
+### Getting Help
+
+1. **Built-in Help**: Use `/help` within MARIA
+2. **Version Check**: Run `maria --version`
+3. **System Status**: Use `/status` command
+4. **GitHub Issues**: [Report issues](https://github.com/bonginkan/maria/issues)
+5. **NPM Package**: [View on npmjs.com](https://www.npmjs.com/package/@bonginkan/maria)
+
+## 📚 Next Steps
+
+After successful setup:
+
+1. **Explore Commands**: Try all 36+ slash commands with `/help`
+2. **Algorithm Learning**: Deep dive into CS curriculum with `/learn`
+3. **AI Development**: Use AI assistance for coding projects
+4. **Performance Analysis**: Benchmark algorithms with built-in tools
+5. **Advanced Features**: Explore 50 cognitive AI modes with `/mode internal`
+
+## 🌟 Pro Tips
+
+- **Quick Access**: Create shell alias: `alias ai="maria"`
+- **Project Integration**: Add MARIA to project's package.json
+- **Learning Schedule**: Dedicate 15 minutes daily to algorithm education
+- **Experiment**: Try different AI models to find your preference
+- **Share**: Introduce MARIA to your team for collaborative development
+
+---
+
+**Welcome to the Algorithm Education Revolution! 🎓✨**
+
+Start your journey: `maria` and type `/help` to explore all possibilities.

package/dist/cli.d.ts

@@ -3,7 +3,7 @@ import { Command } from 'commander';
 
 /**
  * MARIA CLI - Command Line Interface
- * OSS Version with interactive slash command architecture
+ * OSS Version with core functionality
  */
 
 interface CLIOptions {

package/dist/cli.js

@@ -38,55 +38,32 @@ var import_commander = require("commander");
 var import_chalk = __toESM(require("chalk"));
 function createCLI() {
   const program = new import_commander.Command();
-  program.name("maria").description("MARIA - AI-Powered Development Platform v1.6.2").version("1.6.2");
-  program.action(() => {
-    startInteractiveMode();
-  });
-  program.command("chat").description("Start interactive chat mode (same as running maria)").action(() => {
-    startInteractiveMode();
+  program.name("maria").description("MARIA - AI-Powered Development Platform").version("1.0.7");
+  program.command("chat").description("Start interactive chat mode").action(() => {
+    console.log(import_chalk.default.blue("\u{1F916} MARIA AI-Powered Development Platform v1.0.7"));
+    console.log(import_chalk.default.gray("Enterprise-Grade CLI with Advanced Intelligence"));
+    console.log(import_chalk.default.yellow("\n\u{1F4A1} This is the OSS distribution of MARIA."));
+    console.log(import_chalk.default.yellow("   Full features available at: https://maria-code.vercel.app"));
+    console.log(import_chalk.default.cyan("\n\u2728 Key Features:"));
+    console.log(import_chalk.default.cyan("   \u2022 22+ AI Models (GPT, Claude, Gemini, Local LLMs)"));
+    console.log(import_chalk.default.cyan("   \u2022 Advanced Code Quality Systems"));
+    console.log(import_chalk.default.cyan("   \u2022 Intelligent Dependency Management"));
+    console.log(import_chalk.default.cyan("   \u2022 AI-Driven Project Analysis"));
+    console.log(import_chalk.default.cyan("   \u2022 Automated Refactoring Engine"));
+    console.log(import_chalk.default.cyan("   \u2022 Phase 5: Enterprise-Grade Infrastructure"));
   });
   program.command("version").description("Show version information").action(() => {
-    console.log(import_chalk.default.bold("MARIA CLI v1.6.2"));
+    console.log(import_chalk.default.bold("MARIA CLI v1.0.7"));
     console.log(import_chalk.default.gray("AI-Powered Development Platform"));
     console.log(import_chalk.default.gray("\xA9 2025 Bonginkan Inc."));
   });
   program.command("status").description("Show system status").action(() => {
-    console.log(import_chalk.default.green("\u2705 MARIA OSS Distribution v1.6.2"));
-    console.log(import_chalk.default.blue("\u{1F4E6} Revolutionary AI Development Platform"));
+    console.log(import_chalk.default.green("\u2705 MARIA OSS Distribution"));
+    console.log(import_chalk.default.blue("\u{1F4E6} Version: 1.0.7"));
     console.log(import_chalk.default.yellow("\u{1F517} Full Platform: https://maria-code.vercel.app"));
-    console.log(import_chalk.default.cyan("\n\u{1F3AF} NPM Package: https://www.npmjs.com/package/@bonginkan/maria"));
   });
   return program;
 }
-function startInteractiveMode() {
-  console.log(import_chalk.default.blue("\u{1F916} MARIA AI-Powered Development Platform v1.6.2"));
-  console.log(import_chalk.default.gray("Revolutionary Algorithm Education & Autonomous Coding Platform"));
-  console.log(import_chalk.default.yellow("\n\u{1F4A1} This is the OSS distribution of MARIA."));
-  console.log(import_chalk.default.yellow("   Full features available in the complete platform."));
-  console.log(import_chalk.default.cyan("\n\u2728 v1.6.2 Key Features:"));
-  console.log(import_chalk.default.cyan("   \u2022 Algorithm Education Platform (Quicksort, Merge Sort, Heap Sort)"));
-  console.log(import_chalk.default.cyan("   \u2022 Interactive Visualizations & Performance Analysis"));
-  console.log(import_chalk.default.cyan("   \u2022 36+ Slash Commands (/help, /sort, /learn, /benchmark)"));
-  console.log(import_chalk.default.cyan("   \u2022 22+ AI Models (GPT, Claude, Gemini, Local LLMs)"));
-  console.log(import_chalk.default.cyan("   \u2022 Enterprise Code Quality Analysis"));
-  console.log(import_chalk.default.cyan("   \u2022 50 Cognitive Modes with Real-time Adaptation"));
-  console.log(import_chalk.default.cyan("   \u2022 Vector Search & Document Processing"));
-  console.log(import_chalk.default.cyan("   \u2022 Multi-Agent Orchestration System"));
-  console.log(import_chalk.default.magenta("\n\u{1F393} New Algorithm Education Commands:"));
-  console.log(import_chalk.default.magenta("   /sort quicksort --visualize    # Interactive sorting demonstrations"));
-  console.log(import_chalk.default.magenta("   /learn algorithms              # Complete CS curriculum"));
-  console.log(import_chalk.default.magenta("   /benchmark --all               # Performance analysis"));
-  console.log(import_chalk.default.magenta("   /visualize merge --step        # Step-by-step learning"));
-  console.log(import_chalk.default.green("\n\u{1F4DA} Interactive Slash Commands:"));
-  console.log(import_chalk.default.green("   /help                          # See all 36+ commands"));
-  console.log(import_chalk.default.green("   /model                         # AI model selection"));
-  console.log(import_chalk.default.green("   /mode internal list            # 50 cognitive modes"));
-  console.log(import_chalk.default.green("   /bug, /lint, /typecheck        # Code quality analysis"));
-  console.log(import_chalk.default.green("   /coderag, /document            # Advanced AI features"));
-  console.log(import_chalk.default.green("   /exit                          # Exit interactive mode"));
-  console.log(import_chalk.default.blue('\n\u{1F680} To start: Simply run "maria" and use slash commands!'));
-  console.log(import_chalk.default.gray("\u{1F4A1} Example: maria \u2192 /help \u2192 /sort quicksort --visualize"));
-}
 if (require.main === module) {
   const cli = createCLI();
   cli.parse();

package/dist/index.js

@@ -40,55 +40,32 @@ var import_commander = require("commander");
 var import_chalk = __toESM(require("chalk"));
 function createCLI() {
   const program = new import_commander.Command();
-  program.name("maria").description("MARIA - AI-Powered Development Platform v1.6.2").version("1.6.2");
-  program.action(() => {
-    startInteractiveMode();
-  });
-  program.command("chat").description("Start interactive chat mode (same as running maria)").action(() => {
-    startInteractiveMode();
+  program.name("maria").description("MARIA - AI-Powered Development Platform").version("1.0.7");
+  program.command("chat").description("Start interactive chat mode").action(() => {
+    console.log(import_chalk.default.blue("\u{1F916} MARIA AI-Powered Development Platform v1.0.7"));
+    console.log(import_chalk.default.gray("Enterprise-Grade CLI with Advanced Intelligence"));
+    console.log(import_chalk.default.yellow("\n\u{1F4A1} This is the OSS distribution of MARIA."));
+    console.log(import_chalk.default.yellow("   Full features available at: https://maria-code.vercel.app"));
+    console.log(import_chalk.default.cyan("\n\u2728 Key Features:"));
+    console.log(import_chalk.default.cyan("   \u2022 22+ AI Models (GPT, Claude, Gemini, Local LLMs)"));
+    console.log(import_chalk.default.cyan("   \u2022 Advanced Code Quality Systems"));
+    console.log(import_chalk.default.cyan("   \u2022 Intelligent Dependency Management"));
+    console.log(import_chalk.default.cyan("   \u2022 AI-Driven Project Analysis"));
+    console.log(import_chalk.default.cyan("   \u2022 Automated Refactoring Engine"));
+    console.log(import_chalk.default.cyan("   \u2022 Phase 5: Enterprise-Grade Infrastructure"));
   });
   program.command("version").description("Show version information").action(() => {
-    console.log(import_chalk.default.bold("MARIA CLI v1.6.2"));
+    console.log(import_chalk.default.bold("MARIA CLI v1.0.7"));
     console.log(import_chalk.default.gray("AI-Powered Development Platform"));
     console.log(import_chalk.default.gray("\xA9 2025 Bonginkan Inc."));
   });
   program.command("status").description("Show system status").action(() => {
-    console.log(import_chalk.default.green("\u2705 MARIA OSS Distribution v1.6.2"));
-    console.log(import_chalk.default.blue("\u{1F4E6} Revolutionary AI Development Platform"));
+    console.log(import_chalk.default.green("\u2705 MARIA OSS Distribution"));
+    console.log(import_chalk.default.blue("\u{1F4E6} Version: 1.0.7"));
     console.log(import_chalk.default.yellow("\u{1F517} Full Platform: https://maria-code.vercel.app"));
-    console.log(import_chalk.default.cyan("\n\u{1F3AF} NPM Package: https://www.npmjs.com/package/@bonginkan/maria"));
   });
   return program;
 }
-function startInteractiveMode() {
-  console.log(import_chalk.default.blue("\u{1F916} MARIA AI-Powered Development Platform v1.6.2"));
-  console.log(import_chalk.default.gray("Revolutionary Algorithm Education & Autonomous Coding Platform"));
-  console.log(import_chalk.default.yellow("\n\u{1F4A1} This is the OSS distribution of MARIA."));
-  console.log(import_chalk.default.yellow("   Full features available in the complete platform."));
-  console.log(import_chalk.default.cyan("\n\u2728 v1.6.2 Key Features:"));
-  console.log(import_chalk.default.cyan("   \u2022 Algorithm Education Platform (Quicksort, Merge Sort, Heap Sort)"));
-  console.log(import_chalk.default.cyan("   \u2022 Interactive Visualizations & Performance Analysis"));
-  console.log(import_chalk.default.cyan("   \u2022 36+ Slash Commands (/help, /sort, /learn, /benchmark)"));
-  console.log(import_chalk.default.cyan("   \u2022 22+ AI Models (GPT, Claude, Gemini, Local LLMs)"));
-  console.log(import_chalk.default.cyan("   \u2022 Enterprise Code Quality Analysis"));
-  console.log(import_chalk.default.cyan("   \u2022 50 Cognitive Modes with Real-time Adaptation"));
-  console.log(import_chalk.default.cyan("   \u2022 Vector Search & Document Processing"));
-  console.log(import_chalk.default.cyan("   \u2022 Multi-Agent Orchestration System"));
-  console.log(import_chalk.default.magenta("\n\u{1F393} New Algorithm Education Commands:"));
-  console.log(import_chalk.default.magenta("   /sort quicksort --visualize    # Interactive sorting demonstrations"));
-  console.log(import_chalk.default.magenta("   /learn algorithms              # Complete CS curriculum"));
-  console.log(import_chalk.default.magenta("   /benchmark --all               # Performance analysis"));
-  console.log(import_chalk.default.magenta("   /visualize merge --step        # Step-by-step learning"));
-  console.log(import_chalk.default.green("\n\u{1F4DA} Interactive Slash Commands:"));
-  console.log(import_chalk.default.green("   /help                          # See all 36+ commands"));
-  console.log(import_chalk.default.green("   /model                         # AI model selection"));
-  console.log(import_chalk.default.green("   /mode internal list            # 50 cognitive modes"));
-  console.log(import_chalk.default.green("   /bug, /lint, /typecheck        # Code quality analysis"));
-  console.log(import_chalk.default.green("   /coderag, /document            # Advanced AI features"));
-  console.log(import_chalk.default.green("   /exit                          # Exit interactive mode"));
-  console.log(import_chalk.default.blue('\n\u{1F680} To start: Simply run "maria" and use slash commands!'));
-  console.log(import_chalk.default.gray("\u{1F4A1} Example: maria \u2192 /help \u2192 /sort quicksort --visualize"));
-}
 if (require.main === module) {
   const cli = createCLI();
   cli.parse();

package/package.json

@@ -1,46 +1,37 @@
 {
   "name": "@bonginkan/maria",
-  "version": "1.6.2",
-  "description": "Revolutionary AI Development Platform v1.6.2 - Interactive Slash Command Architecture with Algorithm Education, 36+ Commands, 50 Cognitive Modes, Vector Search, and Complete CS Curriculum (OSS Distribution)",
+  "version": "1.6.4",
+  "description": "MARIA Platform v1.6.4 \"Algorithm Education Revolution\" - Interactive AI Development CLI with Complete CS Curriculum, 36+ Slash Commands, 50 Cognitive AI Modes, and Educational Development Platform",
   "keywords": [
     "ai",
     "cli",
     "assistant",
-    "interactive-commands",
-    "slash-commands",
-    "algorithm-education",
-    "sorting-algorithms",
-    "quicksort",
-    "computer-science",
-    "educational-platform",
-    "cognitive-modes",
-    "ai-development",
-    "code-quality",
-    "typescript",
-    "vector-search",
-    "document-processing",
-    "performance-analysis",
-    "visualization",
-    "interactive-learning",
-    "benchmarking",
-    "developer-tools",
-    "ai-cli",
-    "command-line",
     "gpt",
     "claude",
     "gemini",
     "local-llm",
     "lm-studio",
     "ollama",
-    "enterprise-ai",
-    "coderag",
-    "multi-agent-system",
+    "developer-tools",
+    "code-assistant",
+    "ai-cli",
+    "command-line",
+    "typescript",
     "autonomous-agent",
-    "real-time-feedback",
-    "educational-tools",
-    "cs-curriculum",
-    "programming-education",
-    "algorithm-visualization"
+    "algorithm-education",
+    "sorting-algorithms",
+    "quicksort",
+    "visualization",
+    "performance-analysis",
+    "educational-platform",
+    "computer-science",
+    "benchmarking",
+    "memory-profiling",
+    "interactive-learning",
+    "professional-engineering",
+    "autonomous-coding",
+    "visual-progress",
+    "real-time-feedback"
   ],
   "author": "Bonginkan Inc.",
   "license": "MIT",
@@ -62,6 +53,9 @@
     "dist",
     "bin",
     "README.md",
+    "SETUP.md",
+    "GETTING_STARTED.md", 
+    "COMMANDS.md",
     "LICENSE"
   ],
   "type": "commonjs",
@@ -86,14 +80,57 @@
     "release:beta": "pnpm publish --tag beta"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.20.0",
+    "@google/generative-ai": "^0.1.0",
+    "@langchain/core": "^0.1.0",
+    "@sindresorhus/slugify": "^2.2.1",
     "chalk": "^5.3.0",
-    "commander": "^12.0.0"
+    "cli-progress": "^3.12.0",
+    "commander": "^12.0.0",
+    "console-table-printer": "^2.14.6",
+    "dotenv": "^16.4.1",
+    "figlet": "^1.7.0",
+    "fs-extra": "^11.2.0",
+    "gpt-3-encoder": "^1.1.4",
+    "groq-sdk": "^0.3.0",
+    "ink": "^4.4.1",
+    "ink-select-input": "^5.0.0",
+    "ink-spinner": "^4.0.3",
+    "ink-text-input": "^5.0.1",
+    "inquirer": "^12.0.0",
+    "jsonwebtoken": "^9.0.2",
+    "node-fetch": "^3.3.2",
+    "openai": "^4.28.0",
+    "ora": "^8.0.1",
+    "p-limit": "^5.0.0",
+    "prompts": "^2.4.2",
+    "react": "^18.2.0",
+    "strip-ansi": "^7.1.0",
+    "uuid": "^9.0.1",
+    "winston": "^3.11.0",
+    "ws": "^8.16.0",
+    "zod": "^3.22.4"
   },
   "devDependencies": {
+    "@types/cli-progress": "^3.11.5",
+    "@types/figlet": "^1.5.8",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/jsonwebtoken": "^9.0.5",
     "@types/node": "^20.11.0",
-    "lint-staged": "^16.1.5",
+    "@types/react": "^18.2.48",
+    "@types/uuid": "^9.0.8",
+    "@types/ws": "^8.5.10",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitest/coverage-v8": "^1.2.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "prettier": "^3.2.4",
     "tsup": "^8.0.1",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
   },
   "publishConfig": {
     "access": "public",

package/bin/maria.d.ts

@@ -1 +0,0 @@
-export {};