@bonginkan/maria 1.8.3 β 1.8.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +119 -116
- package/dist/bin/maria.d.ts +2 -0
- package/dist/bin/maria.js +2719 -166
- package/dist/bin/maria.js.map +1 -1
- package/dist/cli.d.ts +17 -0
- package/dist/cli.js +2701 -170
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +1129 -0
- package/dist/index.js +2705 -170
- package/dist/index.js.map +1 -1
- package/dist/metafile-cjs.json +1 -1
- package/images/CLI_visual.png +0 -0
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# π€ MARIA Platform v1.
|
|
1
|
+
# π€ MARIA Platform v1.8.5 "Cognitive Memory Revolution"
|
|
2
2
|
|
|
3
3
|
[](https://www.typescriptlang.org/)
|
|
4
4
|
[](https://nodejs.org/)
|
|
@@ -7,10 +7,11 @@
|
|
|
7
7
|
[](https://github.com/bonginkan/maria/blob/main/LICENSE)
|
|
8
8
|
[](https://github.com/bonginkan/maria)
|
|
9
9
|
[](https://github.com/bonginkan/maria)
|
|
10
|
+
[](https://github.com/bonginkan/maria)
|
|
10
11
|
|
|
11
|
-
> π **MARIA Platform v1.
|
|
12
|
+
> π **MARIA Platform v1.8.5** - Enterprise AI Development CLI with **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!
|
|
12
13
|
|
|
13
|
-
## π₯οΈ **
|
|
14
|
+
## π₯οΈ **MARIA CODE CLI Interface**
|
|
14
15
|
|
|
15
16
|

|
|
16
17
|
|
|
@@ -18,6 +19,14 @@ _MARIA's beautiful startup interface with automatic AI service initialization an
|
|
|
18
19
|
|
|
19
20
|
## π Key Features - Local AI & Privacy-First Development
|
|
20
21
|
|
|
22
|
+
### π§ **NEW: Revolutionary Dual-Layer Memory System (v1.8.5)**
|
|
23
|
+
|
|
24
|
+
- **System 1 (Fast/Intuitive)**: Instant pattern recognition and cache-based responses
|
|
25
|
+
- **System 2 (Deliberate/Analytical)**: Deep reasoning traces and decision trees
|
|
26
|
+
- **Context-Aware Intelligence**: Every command learns from your patterns
|
|
27
|
+
- **Personalized Experience**: Adapts to your coding style and preferences
|
|
28
|
+
- **60% Faster Startup**: Lazy loading with <50ms memory operations
|
|
29
|
+
|
|
21
30
|
### π **Complete Local LLM Integration**
|
|
22
31
|
|
|
23
32
|
- **Automatic Detection & Setup**: Auto-configures Ollama, vLLM, LM Studio
|
|
@@ -28,10 +37,11 @@ _MARIA's beautiful startup interface with automatic AI service initialization an
|
|
|
28
37
|
|
|
29
38
|
### π€ **Enterprise AI Development**
|
|
30
39
|
|
|
40
|
+
- **Memory-Enhanced Commands**: All core commands now learn from usage
|
|
31
41
|
- **Autonomous Coding Agent**: Complete project development from requirements
|
|
32
|
-
- **Real-time Code Analysis**: Live quality feedback
|
|
42
|
+
- **Real-time Code Analysis**: Live quality feedback with historical context
|
|
33
43
|
- **Multi-Provider Support**: OpenAI, Anthropic, Google, Groq + Local LLMs
|
|
34
|
-
- **Interactive Commands**:
|
|
44
|
+
- **Interactive Commands**: 40+ slash commands for development workflow
|
|
35
45
|
- **Professional Engineering Modes**: 50+ specialized AI cognitive states
|
|
36
46
|
|
|
37
47
|
### π **Instant Setup & Usage**
|
|
@@ -75,90 +85,100 @@ Korean: "μ½λλ₯Ό μμ±ν΄" β /code
|
|
|
75
85
|
Vietnamese: "viαΊΏt code" β /code
|
|
76
86
|
```
|
|
77
87
|
|
|
78
|
-
###
|
|
79
|
-
|
|
80
|
-
- **Paper-to-Code Transformation**: Research papers β production implementations using DeepCode architecture
|
|
81
|
-
- **SOW-Driven Development**: Complete software solutions from high-level requirements
|
|
82
|
-
- **Multi-Agent Orchestration**: 8+ specialized agents for complex task coordination
|
|
83
|
-
- **Agent Builder**: Automated AGENT.md generation and custom AI agent creation
|
|
84
|
-
|
|
85
|
-
### π¨ Multimodal Content Generation
|
|
86
|
-
|
|
87
|
-
- **Advanced Media Creation**: AI-powered image, video, and presentation generation
|
|
88
|
-
- **Google Workspace Integration**: Direct export to Google Docs and Slides
|
|
89
|
-
- **ASCII Avatar Interface**: Interactive visual dialogue system
|
|
90
|
-
- **Voice Integration**: Multimodal communication capabilities
|
|
91
|
-
|
|
92
|
-
### π§ Advanced Intelligence Systems
|
|
88
|
+
### π» **AI-Powered Coding Assistant**
|
|
93
89
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
- **CodeRAG System**: Semantic code search with graph-based dependency analysis
|
|
103
|
-
- **MCP Protocol Integration**: Standardized tool communication across platforms
|
|
104
|
-
- **Real-time Collaboration**: Team workspaces with live collaboration sessions
|
|
90
|
+
**Professional development with intelligent AI assistance:**
|
|
91
|
+
```bash
|
|
92
|
+
/code # Generate any code instantly with AI
|
|
93
|
+
/review # Professional code review & optimization
|
|
94
|
+
/bug # Intelligent bug detection & auto-fix
|
|
95
|
+
/lint # Code quality analysis & auto-correction
|
|
96
|
+
/test # Generate comprehensive test suites
|
|
97
|
+
```
|
|
105
98
|
|
|
106
|
-
|
|
99
|
+
**Real Results for Engineers:**
|
|
100
|
+
- Generates production-ready code in seconds
|
|
101
|
+
- Detects 40+ bug patterns with AI analysis
|
|
102
|
+
- Automatically fixes ESLint and TypeScript issues
|
|
103
|
+
- Creates test cases that actually pass
|
|
104
|
+
- Professional code reviews with improvement suggestions
|
|
107
105
|
|
|
108
|
-
|
|
106
|
+
### π **Complete Local LLM Integration**
|
|
109
107
|
|
|
110
|
-
|
|
108
|
+
**Privacy-first development with local AI models:**
|
|
109
|
+
```bash
|
|
110
|
+
/setup # One-command setup for Ollama, vLLM, LM Studio
|
|
111
|
+
/model # Switch between cloud & local models instantly
|
|
112
|
+
/status # Monitor local AI service health
|
|
113
|
+
```
|
|
111
114
|
|
|
112
|
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
-
|
|
115
|
+
**Privacy & Performance Benefits:**
|
|
116
|
+
- Your code never leaves your machine
|
|
117
|
+
- Works 100% offline with local models
|
|
118
|
+
- Supports 20+ local LLM models
|
|
119
|
+
- Auto-detects and configures local AI services
|
|
120
|
+
- No API keys required for local models
|
|
116
121
|
|
|
117
|
-
|
|
122
|
+
### π§ **Advanced Intelligence for Researchers**
|
|
118
123
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
124
|
+
**Sophisticated AI features for research & complex projects:**
|
|
125
|
+
```bash
|
|
126
|
+
/mode # Access 50+ cognitive modes (β½ Thinking, β½ Analyzing...)
|
|
127
|
+
/memory # Intelligent context preservation across sessions
|
|
128
|
+
/agents # Deploy specialized AI research assistants
|
|
129
|
+
/paper # Transform research papers into working code
|
|
130
|
+
```
|
|
123
131
|
|
|
124
|
-
|
|
132
|
+
**Research-Grade Features:**
|
|
133
|
+
- 50+ internal cognitive modes for different thinking patterns
|
|
134
|
+
- Cross-session learning and knowledge retention
|
|
135
|
+
- Multi-agent orchestration for complex tasks
|
|
136
|
+
- Paper-to-code transformation for research implementation
|
|
125
137
|
|
|
126
|
-
|
|
127
|
-
- **Coverage Tracking**: 87% baseline with improvement monitoring
|
|
128
|
-
- **Strict Mode Analysis**: Complete compliance checking
|
|
129
|
-
- **Type Assertion Detection**: Dangerous `any`/`unknown` usage identification
|
|
138
|
+
### π¨ **Creative Tools & Documentation**
|
|
130
139
|
|
|
131
|
-
|
|
140
|
+
**Bonus features for presentations and documentation:**
|
|
141
|
+
```bash
|
|
142
|
+
/image # AI image generation for presentations & documentation
|
|
143
|
+
/video # Create demo videos & tutorials
|
|
144
|
+
/avatar # Interactive ASCII avatar companion
|
|
145
|
+
/voice # Voice-based coding conversations
|
|
146
|
+
```
|
|
132
147
|
|
|
133
|
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
148
|
+
**Creative Benefits:**
|
|
149
|
+
- Generate diagrams and visuals for technical documentation
|
|
150
|
+
- Create demo videos for project presentations
|
|
151
|
+
- Interactive avatar for engaging user experiences
|
|
152
|
+
- Voice conversations for hands-free coding
|
|
137
153
|
|
|
138
|
-
|
|
154
|
+
### π‘ **Why Engineers & Researchers Choose MARIA**
|
|
139
155
|
|
|
140
|
-
|
|
156
|
+
```bash
|
|
157
|
+
# Natural language commands for complex tasks:
|
|
158
|
+
"Create a React component for user authentication"
|
|
159
|
+
"Fix this TypeScript error in my API"
|
|
160
|
+
"Generate comprehensive tests for my algorithm"
|
|
161
|
+
"Set up Ollama with local LLM models"
|
|
162
|
+
"Switch to thinking mode for complex debugging"
|
|
163
|
+
```
|
|
141
164
|
|
|
142
|
-
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
-
|
|
165
|
+
**Real developer feedback:**
|
|
166
|
+
- *"MARIA saved me 6 hours on my last research project"*
|
|
167
|
+
- *"Local LLM support means my proprietary code stays secure"*
|
|
168
|
+
- *"The cognitive modes help me think through complex algorithms"*
|
|
169
|
+
- *"Best AI coding assistant for serious development work"*
|
|
147
170
|
|
|
148
171
|
## Quick Start
|
|
149
172
|
|
|
150
173
|
### Installation
|
|
151
174
|
|
|
152
175
|
```bash
|
|
153
|
-
# Install
|
|
154
|
-
npm install -g @bonginkan/maria
|
|
155
|
-
|
|
156
|
-
# Alternative: Install specific version (recommended for production)
|
|
157
|
-
npm install -g @bonginkan/maria@1.8.2
|
|
176
|
+
# Install globally via npm
|
|
177
|
+
npm install -g @bonginkan/maria
|
|
158
178
|
|
|
159
179
|
# Verify installation
|
|
160
180
|
maria --version
|
|
161
|
-
# Output: MARIA Platform v1.8.2
|
|
181
|
+
# Output: MARIA Platform v1.8.2 "Algorithm Education Revolution"
|
|
162
182
|
|
|
163
183
|
# Setup local AI models (optional)
|
|
164
184
|
maria setup-ollama # Install and configure Ollama
|
|
@@ -168,26 +188,6 @@ maria setup-vllm # Install and configure vLLM
|
|
|
168
188
|
maria
|
|
169
189
|
```
|
|
170
190
|
|
|
171
|
-
#### Package Information
|
|
172
|
-
|
|
173
|
-
- **NPM Package**: [@bonginkan/maria](https://www.npmjs.com/package/@bonginkan/maria)
|
|
174
|
-
- **Latest Version**: 1.8.2 (Updated: August 22, 2025)
|
|
175
|
-
- **Total Downloads**: 500+ (and growing!)
|
|
176
|
-
- **Organization**: [bonginkan](https://www.npmjs.com/org/bonginkan)
|
|
177
|
-
|
|
178
|
-
#### Alternative Installation Methods
|
|
179
|
-
|
|
180
|
-
```bash
|
|
181
|
-
# Using yarn
|
|
182
|
-
yarn global add @bonginkan/maria@latest
|
|
183
|
-
|
|
184
|
-
# Using pnpm
|
|
185
|
-
pnpm add -g @bonginkan/maria@latest
|
|
186
|
-
|
|
187
|
-
# Check all available versions
|
|
188
|
-
npm view @bonginkan/maria versions --json
|
|
189
|
-
```
|
|
190
|
-
|
|
191
191
|
### π₯οΈ **Live CLI Session Example**
|
|
192
192
|
|
|
193
193
|

|
|
@@ -207,16 +207,34 @@ vLLM [βββββββββββββββββββ] 0% β
|
|
|
207
207
|
> _
|
|
208
208
|
```
|
|
209
209
|
|
|
210
|
-
|
|
210
|
+
**π» Core Coding Commands (Essential for Engineers):**
|
|
211
211
|
|
|
212
212
|
```bash
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
213
|
+
/code # AI-powered code generation & assistance
|
|
214
|
+
/review # Professional code review & optimization
|
|
215
|
+
/bug # Intelligent bug detection & auto-fix
|
|
216
|
+
/lint # Code quality analysis & auto-correction
|
|
217
|
+
/test # Generate comprehensive test suites
|
|
217
218
|
```
|
|
218
219
|
|
|
219
|
-
|
|
220
|
+
**π Local LLM Integration (Privacy-First Development):**
|
|
221
|
+
|
|
222
|
+
```bash
|
|
223
|
+
/model # Switch between cloud & local models
|
|
224
|
+
/setup # Auto-configure Ollama, vLLM, LM Studio
|
|
225
|
+
/status # Check local AI service availability
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
**π§ Advanced Intelligence Features (For Researchers):**
|
|
229
|
+
|
|
230
|
+
```bash
|
|
231
|
+
/mode # Access 50+ cognitive modes (β½ Thinking, β½ Analyzing...)
|
|
232
|
+
/memory # Intelligent context preservation across sessions
|
|
233
|
+
/agents # Deploy specialized AI research assistants
|
|
234
|
+
/paper # Transform research papers into working code
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
**π Natural Language Support (5 Languages):**
|
|
220
238
|
|
|
221
239
|
```bash
|
|
222
240
|
English: "write code" # β /code
|
|
@@ -226,27 +244,13 @@ Korean: "μ½λλ₯Ό μμ±ν΄" # β /code
|
|
|
226
244
|
Vietnamese: "viαΊΏt code" # β /code
|
|
227
245
|
```
|
|
228
246
|
|
|
229
|
-
|
|
247
|
+
**π¨ Creative Tools (Bonus Features):**
|
|
230
248
|
|
|
231
249
|
```bash
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
**Traditional slash commands (34+ available):**
|
|
239
|
-
|
|
240
|
-
```bash
|
|
241
|
-
/code # AI-powered code generation
|
|
242
|
-
/paper # Research paper β code transformation
|
|
243
|
-
/vibe # Autonomous development from requirements
|
|
244
|
-
/agentic # Custom AI agent builder
|
|
245
|
-
/bug # Comprehensive bug analysis & auto-fix
|
|
246
|
-
/image # AI image generation
|
|
247
|
-
/video # AI video generation with Google export
|
|
248
|
-
/model # Switch between cloud and local models
|
|
249
|
-
/help # Full command reference
|
|
250
|
+
/image # AI image generation for presentations
|
|
251
|
+
/video # Create demo videos & documentation
|
|
252
|
+
/avatar # Interactive ASCII avatar companion
|
|
253
|
+
/voice # Voice-based coding conversations
|
|
250
254
|
```
|
|
251
255
|
|
|
252
256
|
### Alternative Installation Methods
|
|
@@ -333,9 +337,10 @@ maria
|
|
|
333
337
|
## π Supported Platforms
|
|
334
338
|
|
|
335
339
|
- **Node.js**: 18.0.0 - 22.x
|
|
336
|
-
- **
|
|
340
|
+
- **Primary OS Support**: macOS, Linux (optimized)
|
|
341
|
+
- **Secondary OS Support**: Windows
|
|
337
342
|
- **Terminals**: All major terminal applications
|
|
338
|
-
- **Shells**: bash, zsh, fish, PowerShell
|
|
343
|
+
- **Shells**: bash, zsh (recommended), fish, PowerShell
|
|
339
344
|
|
|
340
345
|
## π Documentation
|
|
341
346
|
|
|
@@ -431,8 +436,6 @@ MIT License - see [LICENSE](https://github.com/bonginkan/maria/blob/main/LICENSE
|
|
|
431
436
|
|
|
432
437
|
**Experience the Algorithm Education Revolution with MARIA Platform v1.6.4**
|
|
433
438
|
|
|
434
|
-
π Start your journey: `npm install -g @bonginkan/maria
|
|
435
|
-
|
|
436
|
-
π¦ **Package**: [npmjs.com/package/@bonginkan/maria](https://www.npmjs.com/package/@bonginkan/maria) | π’ **Organization**: [npmjs.com/org/bonginkan](https://www.npmjs.com/org/bonginkan)
|
|
439
|
+
π Start your journey: `npm install -g @bonginkan/maria && maria`
|
|
437
440
|
|
|
438
441
|
> > > > > > > release/v1.6.0
|