JSPM

@bonginkan/maria

1.7.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 386
  • Score
    100M100P100Q106553F
  • License MIT

MARIA Platform v1.7.0 "Algorithm Education Revolution" - Revolutionary AI Development Platform with 120+ Professional Engineering Modes, Algorithm Education Platform, Real-time Visual Progress, Complete Software Development Lifecycle, and Interactive CS Curriculum

Package Exports

  • @bonginkan/maria
  • @bonginkan/maria/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@bonginkan/maria) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

๐Ÿค– MARIA Platform v1.7.0 "Algorithm Education Revolution"

TypeScript Node.js npm Downloads License Quality Cognitive Modes

๐ŸŽ‰ MARIA Platform v1.7.0 "Algorithm Education Revolution" - Interactive AI Development CLI with Complete CS Curriculum, 36+ Slash Commands, 50 Cognitive AI Modes, and Educational Development Platform featuring the world's first Internal Mode System!

๐ŸŒŸ What's New in v1.7.0 "Algorithm Education Revolution"

๐Ÿš€ Autonomous Coding Agent

  • World's First Fully Autonomous Professional Engineering AI
  • Complete software solutions from high-level requirements
  • Visual progress tracking with real-time feedback
  • Self-evolution learning engine
  • 120+ professional engineering modes

๐Ÿ“š Algorithm Education Platform

  • Interactive QuickSort implementation with visualization
  • Performance analysis and benchmarking tools
  • Memory profiling and optimization
  • Computer science curriculum integration
  • Educational sorting algorithms collection

๐Ÿง  Internal Mode System - Cognitive Adaptation Engine

  • 50 Cognitive Modes: Revolutionary thinking states across 9 categories (Reasoning, Creative, Analytical, etc.)
  • Real-time Recognition: <200ms automatic mode switching based on context and intent
  • Adaptive Learning: AI learns your patterns and personalizes cognitive approaches
  • Visual Indicators: Beautiful โœฝ symbols showing current cognitive state
"Fix this bug" โ†’ โœฝ ๐Ÿ› Debuggingโ€ฆ
"Give me ideas" โ†’ โœฝ ๐Ÿ’ก Brainstormingโ€ฆ
"Optimize this" โ†’ โœฝ โšก Optimizingโ€ฆ

๐ŸŽฏ Key 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 Japanese, English, Chinese, Korean, Vietnamese
  • Intent Recognition: "ใ‚ณใƒผใƒ‰ใ‚’ๆ›ธใ„ใฆ" โ†’ /code automatic execution (95%+ accuracy)
  • Contextual Understanding: Smart parameter extraction from natural conversation
  • Learning Engine: Adapts to user patterns for personalized experience

๐Ÿ—๏ธ Autonomous Development Ecosystem (/vibe, /paper, /agentic)

  • 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

๐ŸŽจ Multimodal Content Generation

  • 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

๐Ÿง  Advanced Intelligence Systems

  • 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

๐Ÿข Enterprise-Grade Infrastructure

  • 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

๐Ÿ” Enterprise Code Quality Analysis Platform (Phase 6 - COMPLETE!)

Industry-First Comprehensive Analysis Suite with AI-Powered Insights

๐Ÿ› Bug Detection System (/bug)

  • 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

๐Ÿ”ง Advanced Lint Analysis (/lint)

  • 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

๐Ÿ›ก๏ธ 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

# Install globally via npm
npm install -g @bonginkan/maria

# Verify installation
maria --version
# Output: MARIA Platform v1.6.4 "Algorithm Education Revolution"

# 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
maria

# Natural language interaction (no commands needed!)
You: "ใ‚ณใƒผใƒ‰ใ‚’ๆ›ธใ„ใฆ"          # โ†’ Automatically triggers /code
You: "create a React app"    # โ†’ Intelligent routing to /code

# NEW: Code Quality Analysis Commands
> /lint check               # Comprehensive code quality analysis
> /typecheck analyze         # TypeScript type safety (87% coverage)
> /security-review scan      # OWASP compliance check (89/100 score)
> /bug fix "null pointer"    # AI-powered bug fix suggestions
You: "analyze this bug"      # โ†’ Auto-switches to /bug mode
You: "็ ”็ฉถ่ซ–ๆ–‡ใ‚’ๅฎŸ่ฃ…ใ—ใฆ"      # โ†’ Triggers /paper for paper-to-code

# Traditional slash commands (34+ available)
/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

# Using yarn
yarn global add @bonginkan/maria

# Using pnpm
pnpm add -g @bonginkan/maria

๐ŸŽฏ Usage Examples

Basic Interactive Mode

# Start MARIA interactive CLI
maria

# Available commands in interactive mode:
> /help                          # Show all commands
> /agent execute "create API"    # Autonomous coding agent
> /agent demo                   # Demo autonomous capabilities
> /code "hello world function"  # AI code generation
> /status                       # System status
> /exit                         # Exit

Algorithm Education Commands

# 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

36+ Interactive Slash Commands

# All commands are slash commands within interactive mode
maria
> /help                          # Show all 36+ commands
> /model                         # AI model selection
> /sort quicksort               # Algorithm education
> /code "function"              # AI code generation
> /bug analyze                  # Bug detection
> /lint check                   # Code quality
> /status                       # System status
> /mode internal                # 50 cognitive AI modes
> /exit                         # Exit MARIA

๐ŸŽจ 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

  • 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

๐Ÿ”ง Development Tools

  • 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

๐ŸŒ Supported Platforms

  • Node.js: 18.0.0 - 22.x
  • Operating Systems: macOS, Linux, Windows
  • Terminals: All major terminal applications
  • Shells: bash, zsh, fish, PowerShell

๐Ÿ“š 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

  • 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:

# 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

๐Ÿค Contributing

We welcome contributions to MARIA! Please check our contribution guidelines.

Development Setup

# Clone the repository
git clone https://github.com/bonginkan/maria.git
cd maria

# Install dependencies
npm install

# Build the project
npm run build

# Run locally
./bin/maria

๐Ÿ“„ License

MIT License - see LICENSE for details.

๐ŸŽฏ What Makes MARIA Special

Revolutionary AI Development

  • 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

Cutting-Edge Technology

  • 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:

  • 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

Experience the Algorithm Education Revolution with MARIA Platform v1.6.4

๐Ÿš€ Start your journey: npm install -g @bonginkan/maria && maria

release/v1.6.0