@mnemosyne_os/forge 1.0.0 โ 1.2.2
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/CHANGELOG.md +34 -34
- package/LICENSE +21 -21
- package/README.md +230 -230
- package/dist/cli.js +667 -76
- package/dist/lib/chronicle.js +105 -0
- package/dist/lib/init-flow.js +139 -0
- package/dist/lib/providers.js +46 -0
- package/dist/lib/sources/antigravity.js +142 -0
- package/dist/lib/sources/index.js +172 -0
- package/dist/lib/vault.js +118 -0
- package/package.json +14 -2
- package/dist/templates/index.template.js +0 -36
- package/src/cli.ts +0 -121
- package/src/templates/.cursorrules +0 -55
- package/src/templates/AGENT_INSTRUCTIONS.md +0 -60
- package/src/templates/index.template.tsx +0 -34
- package/tsconfig.json +0 -15
package/CHANGELOG.md
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
All notable changes to MnemoForge CLI are documented here.
|
|
4
|
-
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
|
|
5
|
-
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## [1.0.0] โ 2026-04-03
|
|
9
|
-
|
|
10
|
-
### ๐ Initial Public Release
|
|
11
|
-
|
|
12
|
-
**MnemoForge CLI** is now publicly available as part of the [Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS) ecosystem.
|
|
13
|
-
|
|
14
|
-
#### Added
|
|
15
|
-
- `mnemoforge init <module-name>` โ Scaffold a Mnemosyne-grade module with AI governance DNA
|
|
16
|
-
- Interactive mode: prompts for module name if not provided as argument
|
|
17
|
-
- Input validation: enforces valid module name format
|
|
18
|
-
- **`.cursorrules`** template โ Liquid Glass design system constraints for AI agents
|
|
19
|
-
- **`AGENT_INSTRUCTIONS.md`** template โ Structured mission directive for AI agents (Cursor, Claude, Copilot)
|
|
20
|
-
- **`index.tsx`** template โ React 18 + Framer Motion boilerplate, Mnemosyne-compliant
|
|
21
|
-
- Visual ASCII banner with violet gradient styling
|
|
22
|
-
- Error handling with clear, actionable messages
|
|
23
|
-
- TypeScript strict mode โ zero `any` tolerance
|
|
24
|
-
|
|
25
|
-
#### Technical
|
|
26
|
-
- Node.js 18+ compatibility
|
|
27
|
-
- Commander.js v11 CLI framework
|
|
28
|
-
- Inquirer.js v8 interactive prompts
|
|
29
|
-
- Chalk v4 terminal styling
|
|
30
|
-
- Template variable substitution (`{{MODULE_NAME}}`)
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
*XPACEGEMS LLC ยท Tony Trochet ยท MIT License*
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to MnemoForge CLI are documented here.
|
|
4
|
+
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## [1.0.0] โ 2026-04-03
|
|
9
|
+
|
|
10
|
+
### ๐ Initial Public Release
|
|
11
|
+
|
|
12
|
+
**MnemoForge CLI** is now publicly available as part of the [Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS) ecosystem.
|
|
13
|
+
|
|
14
|
+
#### Added
|
|
15
|
+
- `mnemoforge init <module-name>` โ Scaffold a Mnemosyne-grade module with AI governance DNA
|
|
16
|
+
- Interactive mode: prompts for module name if not provided as argument
|
|
17
|
+
- Input validation: enforces valid module name format
|
|
18
|
+
- **`.cursorrules`** template โ Liquid Glass design system constraints for AI agents
|
|
19
|
+
- **`AGENT_INSTRUCTIONS.md`** template โ Structured mission directive for AI agents (Cursor, Claude, Copilot)
|
|
20
|
+
- **`index.tsx`** template โ React 18 + Framer Motion boilerplate, Mnemosyne-compliant
|
|
21
|
+
- Visual ASCII banner with violet gradient styling
|
|
22
|
+
- Error handling with clear, actionable messages
|
|
23
|
+
- TypeScript strict mode โ zero `any` tolerance
|
|
24
|
+
|
|
25
|
+
#### Technical
|
|
26
|
+
- Node.js 18+ compatibility
|
|
27
|
+
- Commander.js v11 CLI framework
|
|
28
|
+
- Inquirer.js v8 interactive prompts
|
|
29
|
+
- Chalk v4 terminal styling
|
|
30
|
+
- Template variable substitution (`{{MODULE_NAME}}`)
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
*XPACEGEMS LLC ยท Tony Trochet ยท MIT License*
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 XPACEGEMS LLC โ Tony Trochet
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 XPACEGEMS LLC โ Tony Trochet
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,230 +1,230 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
```
|
|
4
|
-
โโโโ โโโโโโโโ โโโโโโโโโโโโโโโ โโโโ โโโโโโโ โโโโโโโโ โโโโโโโ โโโโโโโ โโโโโโโ โโโโโโโโ
|
|
5
|
-
โโโโโ โโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโ
|
|
6
|
-
โโโโโโโโโโโโโโโโโ โโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโ โโโ โโโโโโโโโโโโโโ โโโโโโโโโโ
|
|
7
|
-
โโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโ โโโ โโโโโโโโโโโโโโ โโโโโโโโโ
|
|
8
|
-
โโโ โโโ โโโโโโ โโโโโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ
|
|
9
|
-
โโโ โโโโโโ โโโโโโโโโโโโโโโโ โโโ โโโโโโโ โโโ โโโโโโโ โโโ โโโ โโโโโโโ โโโโโโโโ
|
|
10
|
-
```
|
|
11
|
-
|
|
12
|
-
**MnemoForge CLI** โ The Inception Engine of the Mnemosyne Neural OS
|
|
13
|
-
|
|
14
|
-
[](https://github.com/yaka0007/Mnemosyne-Neural-OS)
|
|
15
|
-
[](./LICENSE)
|
|
16
|
-
[](https://www.typescriptlang.org/)
|
|
17
|
-
[](https://nodejs.org/)
|
|
18
|
-
[](https://github.com/yaka0007/Mnemosyne-Neural-OS)
|
|
19
|
-
|
|
20
|
-
</div>
|
|
21
|
-
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
## What is MnemoForge?
|
|
25
|
-
|
|
26
|
-
**MnemoForge** is the official module scaffolding CLI for the [Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS) ecosystem.
|
|
27
|
-
|
|
28
|
-
It acts as an **AI inception engine**: a single command scaffolds a complete, production-ready module skeleton that automatically injects **AI governance rules** into the project โ forcing any connected AI agent (Cursor, Claude, GitHub Copilot, etc.) to respect Mnemosyne's architectural and aesthetic standards without needing to re-explain them.
|
|
29
|
-
|
|
30
|
-
> **"Don't just scaffold code. Scaffold intelligence."**
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
## Why Does This Matter?
|
|
35
|
-
|
|
36
|
-
Modern AI-assisted development has a critical problem: every time you start a new module, you re-explain your design system to the AI. It forgets. It drifts. It produces inconsistent code.
|
|
37
|
-
|
|
38
|
-
MnemoForge solves this at the **project inception level**:
|
|
39
|
-
|
|
40
|
-
| Without MnemoForge | With MnemoForge |
|
|
41
|
-
|---|---|
|
|
42
|
-
| Re-explain design rules every session | Rules baked in at project creation |
|
|
43
|
-
| AI drifts from your design system | AI is constrained by `.cursorrules` DNA |
|
|
44
|
-
| Inconsistent component quality | Every module is Liquid Glass-compliant |
|
|
45
|
-
| Manual boilerplate for each module | One command: `mnemoforge init` |
|
|
46
|
-
| No multi-agent coordination | MnemoSync-aware from day one |
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
## Quick Start
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
# Install globally via npm
|
|
54
|
-
npm install -g @mnemosyne/forge
|
|
55
|
-
|
|
56
|
-
# Or run directly without installing
|
|
57
|
-
npx @mnemosyne/forge init my-new-module
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
# Initialize a new Mnemosyne-grade module
|
|
62
|
-
mnemoforge init QuantumVaultUI
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
That's it. In seconds, you get a complete module scaffold with:
|
|
66
|
-
- ๐งฌ **`.cursorrules`** โ AI governance DNA (Liquid Glass design system constraints)
|
|
67
|
-
- ๐ **`AGENT_INSTRUCTIONS.md`** โ Mission directive for any AI agent
|
|
68
|
-
- โ๏ธ **`index.tsx`** โ Mnemosyne-compliant React boilerplate
|
|
69
|
-
- ๐ฎ All constants pre-set to the Mnemosyne ecosystem standards
|
|
70
|
-
|
|
71
|
-
### Interactive Mode
|
|
72
|
-
|
|
73
|
-
If you omit the module name, MnemoForge enters interactive mode:
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
mnemoforge init
|
|
77
|
-
|
|
78
|
-
? What is the name of your new Mnemosyne module? (e.g., NexusGraph) โบ _
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
---
|
|
82
|
-
|
|
83
|
-
## What Gets Generated
|
|
84
|
-
|
|
85
|
-
```
|
|
86
|
-
my-new-module/
|
|
87
|
-
โโโ .cursorrules # AI governance: Liquid Glass design enforcer
|
|
88
|
-
โโโ AGENT_INSTRUCTIONS.md # Context directive for AI agents
|
|
89
|
-
โโโ index.tsx # React entry point (Mnemosyne-compliant)
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
### The `.cursorrules` DNA File
|
|
93
|
-
|
|
94
|
-
The core of MnemoForge is the AI governance file injected into every project. It enforces:
|
|
95
|
-
|
|
96
|
-
- **Liquid Glass design system** โ translucent surfaces, backdrop blur, micro-animations
|
|
97
|
-
- **Tailwind CSS only** โ no inline styles unless strictly necessary
|
|
98
|
-
- **Framer Motion** for all transitions (`<motion.div layout>`)
|
|
99
|
-
- **Zustand** state management (no Redux)
|
|
100
|
-
- **Strict TypeScript** โ zero `any` tolerance
|
|
101
|
-
- **lucide-react** icon system
|
|
102
|
-
- **No placeholders** โ complete, deployable code as output
|
|
103
|
-
|
|
104
|
-
### The `AGENT_INSTRUCTIONS.md` Mission Directive
|
|
105
|
-
|
|
106
|
-
A structured briefing document for any autonomous AI agent. Works with:
|
|
107
|
-
- Cursor AI (native `.cursorrules` + instructions)
|
|
108
|
-
- Claude via API / Projects
|
|
109
|
-
- GitHub Copilot Workspace
|
|
110
|
-
- Any OpenAI-compatible agent
|
|
111
|
-
|
|
112
|
-
---
|
|
113
|
-
|
|
114
|
-
## Part of the Mnemosyne Ecosystem
|
|
115
|
-
|
|
116
|
-
MnemoForge is the **scaffolding layer** of a larger sovereign AI operating system:
|
|
117
|
-
|
|
118
|
-
```
|
|
119
|
-
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
120
|
-
โ MNEMOSYNE NEURAL OS โ
|
|
121
|
-
โ โ
|
|
122
|
-
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
123
|
-
โ โ MnemoForge โโโโโถโ Mnemosyne Desktop โ โ
|
|
124
|
-
โ โ CLI (this) โ โ (Electron + React) โ โ
|
|
125
|
-
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
126
|
-
โ โ โ โ
|
|
127
|
-
โ โผ โผ โ
|
|
128
|
-
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
129
|
-
โ โ Module DNA โ โ Resonance Engine โ โ
|
|
130
|
-
โ โ (.cursor โ โ (Cognitive RAG + โ โ
|
|
131
|
-
โ โ rules) โ โ FGAC + MnemoSync) โ โ
|
|
132
|
-
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
133
|
-
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
The parent system features:
|
|
137
|
-
- **1,126 automated tests** โ 100% pass rate across 88 test suites
|
|
138
|
-
- **220,000+ lines of TypeScript** (strict mode, zero errors)
|
|
139
|
-
- **Multi-agent AI orchestration** with real-time coordination
|
|
140
|
-
- **Local-first encrypted vault** with FGAC access control
|
|
141
|
-
- **CI/CD pipeline** โ typecheck โ lint โ i18n โ tests (always green)
|
|
142
|
-
|
|
143
|
-
---
|
|
144
|
-
|
|
145
|
-
## Roadmap
|
|
146
|
-
|
|
147
|
-
- [x] `mnemoforge init` โ module scaffolding with AI DNA injection
|
|
148
|
-
- [ ] `mnemoforge add <component>` โ add pre-built Liquid Glass components
|
|
149
|
-
- [ ] `mnemoforge publish` โ publish module to the Mnemosyne Plugin Marketplace
|
|
150
|
-
- [ ] `mnemoforge doctor` โ diagnose AI governance drift in existing projects
|
|
151
|
-
- [ ] Multi-template support (API service, background agent, data pipeline)
|
|
152
|
-
|
|
153
|
-
---
|
|
154
|
-
|
|
155
|
-
## Development
|
|
156
|
-
|
|
157
|
-
```bash
|
|
158
|
-
# Clone the Mnemosyne Neural OS repo
|
|
159
|
-
git clone https://github.com/yaka0007/Mnemosyne-Neural-OS.git
|
|
160
|
-
|
|
161
|
-
# Navigate to the CLI package
|
|
162
|
-
cd Mnemosyne-Neural-OS/cli
|
|
163
|
-
|
|
164
|
-
# Install dependencies
|
|
165
|
-
npm install
|
|
166
|
-
|
|
167
|
-
# Build
|
|
168
|
-
npm run build
|
|
169
|
-
|
|
170
|
-
# Link globally for local testing
|
|
171
|
-
npm link
|
|
172
|
-
|
|
173
|
-
# Test
|
|
174
|
-
mnemoforge init test-module
|
|
175
|
-
```
|
|
176
|
-
|
|
177
|
-
### Extending the Templates
|
|
178
|
-
|
|
179
|
-
All generated files come from `src/templates/`. To customize the AI governance DNA for your own fork:
|
|
180
|
-
|
|
181
|
-
```bash
|
|
182
|
-
# Edit the AI rules
|
|
183
|
-
vim src/templates/.cursorrules
|
|
184
|
-
|
|
185
|
-
# Rebuild
|
|
186
|
-
npm run build
|
|
187
|
-
|
|
188
|
-
# All future `mnemoforge init` calls use your new rules
|
|
189
|
-
mnemoforge init my-custom-module
|
|
190
|
-
```
|
|
191
|
-
|
|
192
|
-
---
|
|
193
|
-
|
|
194
|
-
## Tech Stack
|
|
195
|
-
|
|
196
|
-
| Layer | Technology |
|
|
197
|
-
|---|---|
|
|
198
|
-
| Runtime | Node.js 22+ |
|
|
199
|
-
| Language | TypeScript 5 (strict mode) |
|
|
200
|
-
| CLI Framework | Commander.js v11 |
|
|
201
|
-
| Prompts | Inquirer.js v8 |
|
|
202
|
-
| Output Styling | Chalk v4 |
|
|
203
|
-
| Generated UI | React 18 + Framer Motion + Tailwind CSS |
|
|
204
|
-
|
|
205
|
-
---
|
|
206
|
-
|
|
207
|
-
## License
|
|
208
|
-
|
|
209
|
-
MIT ยฉ 2026 [XPACEGEMS LLC](https://xpacegems.com) โ Tony Trochet
|
|
210
|
-
|
|
211
|
-
---
|
|
212
|
-
|
|
213
|
-
## About
|
|
214
|
-
|
|
215
|
-
**XPACEGEMS LLC** โ Independent AI Software Lab
|
|
216
|
-
Miami, FL 33122, USA
|
|
217
|
-
Founder & Lead Architect: [Tony Trochet](https://www.linkedin.com/in/tony-t-19544650/)
|
|
218
|
-
|
|
219
|
-
Built as part of **Mnemosyne Neural OS** โ a production-grade sovereign AI operating system.
|
|
220
|
-
Powered by **Claude (Anthropic)** ยท **Antigravity (Google DeepMind)** ยท **Cursor**
|
|
221
|
-
|
|
222
|
-
> *"The model may not know who it is. The soul does."*
|
|
223
|
-
|
|
224
|
-
---
|
|
225
|
-
|
|
226
|
-
<div align="center">
|
|
227
|
-
|
|
228
|
-
**[โญ Star Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS)** ยท **[๐ Full Documentation](https://github.com/yaka0007/Mnemosyne-Neural-OS/tree/main/doc)** ยท **[๐ Report Issues](https://github.com/yaka0007/Mnemosyne-Neural-OS/issues)**
|
|
229
|
-
|
|
230
|
-
</div>
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
```
|
|
4
|
+
โโโโ โโโโโโโโ โโโโโโโโโโโโโโโ โโโโ โโโโโโโ โโโโโโโโ โโโโโโโ โโโโโโโ โโโโโโโ โโโโโโโโ
|
|
5
|
+
โโโโโ โโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโ
|
|
6
|
+
โโโโโโโโโโโโโโโโโ โโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโ โโโ โโโโโโโโโโโโโโ โโโโโโโโโโ
|
|
7
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโ โโโ โโโโโโโโโโโโโโ โโโโโโโโโ
|
|
8
|
+
โโโ โโโ โโโโโโ โโโโโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ
|
|
9
|
+
โโโ โโโโโโ โโโโโโโโโโโโโโโโ โโโ โโโโโโโ โโโ โโโโโโโ โโโ โโโ โโโโโโโ โโโโโโโโ
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
**MnemoForge CLI** โ The Inception Engine of the Mnemosyne Neural OS
|
|
13
|
+
|
|
14
|
+
[](https://github.com/yaka0007/Mnemosyne-Neural-OS)
|
|
15
|
+
[](./LICENSE)
|
|
16
|
+
[](https://www.typescriptlang.org/)
|
|
17
|
+
[](https://nodejs.org/)
|
|
18
|
+
[](https://github.com/yaka0007/Mnemosyne-Neural-OS)
|
|
19
|
+
|
|
20
|
+
</div>
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## What is MnemoForge?
|
|
25
|
+
|
|
26
|
+
**MnemoForge** is the official module scaffolding CLI for the [Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS) ecosystem.
|
|
27
|
+
|
|
28
|
+
It acts as an **AI inception engine**: a single command scaffolds a complete, production-ready module skeleton that automatically injects **AI governance rules** into the project โ forcing any connected AI agent (Cursor, Claude, GitHub Copilot, etc.) to respect Mnemosyne's architectural and aesthetic standards without needing to re-explain them.
|
|
29
|
+
|
|
30
|
+
> **"Don't just scaffold code. Scaffold intelligence."**
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Why Does This Matter?
|
|
35
|
+
|
|
36
|
+
Modern AI-assisted development has a critical problem: every time you start a new module, you re-explain your design system to the AI. It forgets. It drifts. It produces inconsistent code.
|
|
37
|
+
|
|
38
|
+
MnemoForge solves this at the **project inception level**:
|
|
39
|
+
|
|
40
|
+
| Without MnemoForge | With MnemoForge |
|
|
41
|
+
|---|---|
|
|
42
|
+
| Re-explain design rules every session | Rules baked in at project creation |
|
|
43
|
+
| AI drifts from your design system | AI is constrained by `.cursorrules` DNA |
|
|
44
|
+
| Inconsistent component quality | Every module is Liquid Glass-compliant |
|
|
45
|
+
| Manual boilerplate for each module | One command: `mnemoforge init` |
|
|
46
|
+
| No multi-agent coordination | MnemoSync-aware from day one |
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Quick Start
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
# Install globally via npm
|
|
54
|
+
npm install -g @mnemosyne/forge
|
|
55
|
+
|
|
56
|
+
# Or run directly without installing
|
|
57
|
+
npx @mnemosyne/forge init my-new-module
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# Initialize a new Mnemosyne-grade module
|
|
62
|
+
mnemoforge init QuantumVaultUI
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
That's it. In seconds, you get a complete module scaffold with:
|
|
66
|
+
- ๐งฌ **`.cursorrules`** โ AI governance DNA (Liquid Glass design system constraints)
|
|
67
|
+
- ๐ **`AGENT_INSTRUCTIONS.md`** โ Mission directive for any AI agent
|
|
68
|
+
- โ๏ธ **`index.tsx`** โ Mnemosyne-compliant React boilerplate
|
|
69
|
+
- ๐ฎ All constants pre-set to the Mnemosyne ecosystem standards
|
|
70
|
+
|
|
71
|
+
### Interactive Mode
|
|
72
|
+
|
|
73
|
+
If you omit the module name, MnemoForge enters interactive mode:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
mnemoforge init
|
|
77
|
+
|
|
78
|
+
? What is the name of your new Mnemosyne module? (e.g., NexusGraph) โบ _
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## What Gets Generated
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
my-new-module/
|
|
87
|
+
โโโ .cursorrules # AI governance: Liquid Glass design enforcer
|
|
88
|
+
โโโ AGENT_INSTRUCTIONS.md # Context directive for AI agents
|
|
89
|
+
โโโ index.tsx # React entry point (Mnemosyne-compliant)
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### The `.cursorrules` DNA File
|
|
93
|
+
|
|
94
|
+
The core of MnemoForge is the AI governance file injected into every project. It enforces:
|
|
95
|
+
|
|
96
|
+
- **Liquid Glass design system** โ translucent surfaces, backdrop blur, micro-animations
|
|
97
|
+
- **Tailwind CSS only** โ no inline styles unless strictly necessary
|
|
98
|
+
- **Framer Motion** for all transitions (`<motion.div layout>`)
|
|
99
|
+
- **Zustand** state management (no Redux)
|
|
100
|
+
- **Strict TypeScript** โ zero `any` tolerance
|
|
101
|
+
- **lucide-react** icon system
|
|
102
|
+
- **No placeholders** โ complete, deployable code as output
|
|
103
|
+
|
|
104
|
+
### The `AGENT_INSTRUCTIONS.md` Mission Directive
|
|
105
|
+
|
|
106
|
+
A structured briefing document for any autonomous AI agent. Works with:
|
|
107
|
+
- Cursor AI (native `.cursorrules` + instructions)
|
|
108
|
+
- Claude via API / Projects
|
|
109
|
+
- GitHub Copilot Workspace
|
|
110
|
+
- Any OpenAI-compatible agent
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## Part of the Mnemosyne Ecosystem
|
|
115
|
+
|
|
116
|
+
MnemoForge is the **scaffolding layer** of a larger sovereign AI operating system:
|
|
117
|
+
|
|
118
|
+
```
|
|
119
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
120
|
+
โ MNEMOSYNE NEURAL OS โ
|
|
121
|
+
โ โ
|
|
122
|
+
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
123
|
+
โ โ MnemoForge โโโโโถโ Mnemosyne Desktop โ โ
|
|
124
|
+
โ โ CLI (this) โ โ (Electron + React) โ โ
|
|
125
|
+
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
126
|
+
โ โ โ โ
|
|
127
|
+
โ โผ โผ โ
|
|
128
|
+
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
129
|
+
โ โ Module DNA โ โ Resonance Engine โ โ
|
|
130
|
+
โ โ (.cursor โ โ (Cognitive RAG + โ โ
|
|
131
|
+
โ โ rules) โ โ FGAC + MnemoSync) โ โ
|
|
132
|
+
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโ โ
|
|
133
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
The parent system features:
|
|
137
|
+
- **1,126 automated tests** โ 100% pass rate across 88 test suites
|
|
138
|
+
- **220,000+ lines of TypeScript** (strict mode, zero errors)
|
|
139
|
+
- **Multi-agent AI orchestration** with real-time coordination
|
|
140
|
+
- **Local-first encrypted vault** with FGAC access control
|
|
141
|
+
- **CI/CD pipeline** โ typecheck โ lint โ i18n โ tests (always green)
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## Roadmap
|
|
146
|
+
|
|
147
|
+
- [x] `mnemoforge init` โ module scaffolding with AI DNA injection
|
|
148
|
+
- [ ] `mnemoforge add <component>` โ add pre-built Liquid Glass components
|
|
149
|
+
- [ ] `mnemoforge publish` โ publish module to the Mnemosyne Plugin Marketplace
|
|
150
|
+
- [ ] `mnemoforge doctor` โ diagnose AI governance drift in existing projects
|
|
151
|
+
- [ ] Multi-template support (API service, background agent, data pipeline)
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## Development
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
# Clone the Mnemosyne Neural OS repo
|
|
159
|
+
git clone https://github.com/yaka0007/Mnemosyne-Neural-OS.git
|
|
160
|
+
|
|
161
|
+
# Navigate to the CLI package
|
|
162
|
+
cd Mnemosyne-Neural-OS/cli
|
|
163
|
+
|
|
164
|
+
# Install dependencies
|
|
165
|
+
npm install
|
|
166
|
+
|
|
167
|
+
# Build
|
|
168
|
+
npm run build
|
|
169
|
+
|
|
170
|
+
# Link globally for local testing
|
|
171
|
+
npm link
|
|
172
|
+
|
|
173
|
+
# Test
|
|
174
|
+
mnemoforge init test-module
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### Extending the Templates
|
|
178
|
+
|
|
179
|
+
All generated files come from `src/templates/`. To customize the AI governance DNA for your own fork:
|
|
180
|
+
|
|
181
|
+
```bash
|
|
182
|
+
# Edit the AI rules
|
|
183
|
+
vim src/templates/.cursorrules
|
|
184
|
+
|
|
185
|
+
# Rebuild
|
|
186
|
+
npm run build
|
|
187
|
+
|
|
188
|
+
# All future `mnemoforge init` calls use your new rules
|
|
189
|
+
mnemoforge init my-custom-module
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Tech Stack
|
|
195
|
+
|
|
196
|
+
| Layer | Technology |
|
|
197
|
+
|---|---|
|
|
198
|
+
| Runtime | Node.js 22+ |
|
|
199
|
+
| Language | TypeScript 5 (strict mode) |
|
|
200
|
+
| CLI Framework | Commander.js v11 |
|
|
201
|
+
| Prompts | Inquirer.js v8 |
|
|
202
|
+
| Output Styling | Chalk v4 |
|
|
203
|
+
| Generated UI | React 18 + Framer Motion + Tailwind CSS |
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
## License
|
|
208
|
+
|
|
209
|
+
MIT ยฉ 2026 [XPACEGEMS LLC](https://xpacegems.com) โ Tony Trochet
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## About
|
|
214
|
+
|
|
215
|
+
**XPACEGEMS LLC** โ Independent AI Software Lab
|
|
216
|
+
Miami, FL 33122, USA
|
|
217
|
+
Founder & Lead Architect: [Tony Trochet](https://www.linkedin.com/in/tony-t-19544650/)
|
|
218
|
+
|
|
219
|
+
Built as part of **Mnemosyne Neural OS** โ a production-grade sovereign AI operating system.
|
|
220
|
+
Powered by **Claude (Anthropic)** ยท **Antigravity (Google DeepMind)** ยท **Cursor**
|
|
221
|
+
|
|
222
|
+
> *"The model may not know who it is. The soul does."*
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
<div align="center">
|
|
227
|
+
|
|
228
|
+
**[โญ Star Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS)** ยท **[๐ Full Documentation](https://github.com/yaka0007/Mnemosyne-Neural-OS/tree/main/doc)** ยท **[๐ Report Issues](https://github.com/yaka0007/Mnemosyne-Neural-OS/issues)**
|
|
229
|
+
|
|
230
|
+
</div>
|