@mnemosyne_os/forge 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to MnemoForge CLI are documented here.  
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+---
+
+## [1.0.0] — 2026-04-03
+
+### 🎉 Initial Public Release
+
+**MnemoForge CLI** is now publicly available as part of the [Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS) ecosystem.
+
+#### Added
+- `mnemoforge init <module-name>` — Scaffold a Mnemosyne-grade module with AI governance DNA
+- Interactive mode: prompts for module name if not provided as argument
+- Input validation: enforces valid module name format
+- **`.cursorrules`** template — Liquid Glass design system constraints for AI agents
+- **`AGENT_INSTRUCTIONS.md`** template — Structured mission directive for AI agents (Cursor, Claude, Copilot)
+- **`index.tsx`** template — React 18 + Framer Motion boilerplate, Mnemosyne-compliant
+- Visual ASCII banner with violet gradient styling
+- Error handling with clear, actionable messages
+- TypeScript strict mode — zero `any` tolerance
+
+#### Technical
+- Node.js 18+ compatibility
+- Commander.js v11 CLI framework
+- Inquirer.js v8 interactive prompts
+- Chalk v4 terminal styling
+- Template variable substitution (`{{MODULE_NAME}}`)
+
+---
+
+*XPACEGEMS LLC · Tony Trochet · MIT License*

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XPACEGEMS LLC — Tony Trochet
+
+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.

package/README.md

@@ -0,0 +1,230 @@
+<div align="center">
+
+```
+███╗   ███╗███╗   ██╗███████╗███╗   ███╗ ██████╗ ███████╗ ██████╗ ██████╗  ██████╗ ███████╗
+████╗ ████║████╗  ██║██╔════╝████╗ ████║██╔═══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
+██╔████╔██║██╔██╗ ██║█████╗  ██╔████╔██║██║   ██║█████╗  ██║   ██║██████╔╝██║  ███╗█████╗  
+██║╚██╔╝██║██║╚██╗██║██╔══╝  ██║╚██╔╝██║██║   ██║██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  
+██║ ╚═╝ ██║██║ ╚████║███████╗██║ ╚═╝ ██║╚██████╔╝██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗
+╚═╝     ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝     ╚═╝ ╚═════╝ ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝
+```
+
+**MnemoForge CLI** — The Inception Engine of the Mnemosyne Neural OS
+
+[![NPM Version](https://img.shields.io/badge/version-1.0.0-violet?style=flat-square)](https://github.com/yaka0007/Mnemosyne-Neural-OS)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](./LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-22+-339933?style=flat-square&logo=node.js)](https://nodejs.org/)
+[![Part of Mnemosyne](https://img.shields.io/badge/ecosystem-Mnemosyne%20Neural%20OS-8B5CF6?style=flat-square)](https://github.com/yaka0007/Mnemosyne-Neural-OS)
+
+</div>
+
+---
+
+## What is MnemoForge?
+
+**MnemoForge** is the official module scaffolding CLI for the [Mnemosyne Neural OS](https://github.com/yaka0007/Mnemosyne-Neural-OS) ecosystem.
+
+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.
+
+> **"Don't just scaffold code. Scaffold intelligence."**
+
+---
+
+## Why Does This Matter?
+
+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.
+
+MnemoForge solves this at the **project inception level**:
+
+| Without MnemoForge | With MnemoForge |
+|---|---|
+| Re-explain design rules every session | Rules baked in at project creation |
+| AI drifts from your design system | AI is constrained by `.cursorrules` DNA |
+| Inconsistent component quality | Every module is Liquid Glass-compliant |
+| Manual boilerplate for each module | One command: `mnemoforge init` |
+| No multi-agent coordination | MnemoSync-aware from day one |
+
+---
+
+## Quick Start
+
+```bash
+# Install globally via npm
+npm install -g @mnemosyne/forge
+
+# Or run directly without installing
+npx @mnemosyne/forge init my-new-module
+```
+
+```bash
+# Initialize a new Mnemosyne-grade module
+mnemoforge init QuantumVaultUI
+```
+
+That's it. In seconds, you get a complete module scaffold with:
+- 🧬 **`.cursorrules`** — AI governance DNA (Liquid Glass design system constraints)
+- 📋 **`AGENT_INSTRUCTIONS.md`** — Mission directive for any AI agent
+- ⚛️ **`index.tsx`** — Mnemosyne-compliant React boilerplate
+- 🔮 All constants pre-set to the Mnemosyne ecosystem standards
+
+### Interactive Mode
+
+If you omit the module name, MnemoForge enters interactive mode:
+
+```bash
+mnemoforge init
+
+? What is the name of your new Mnemosyne module? (e.g., NexusGraph) › _
+```
+
+---
+
+## What Gets Generated
+
+```
+my-new-module/
+├── .cursorrules           # AI governance: Liquid Glass design enforcer
+├── AGENT_INSTRUCTIONS.md  # Context directive for AI agents
+└── index.tsx              # React entry point (Mnemosyne-compliant)
+```
+
+### The `.cursorrules` DNA File
+
+The core of MnemoForge is the AI governance file injected into every project. It enforces:
+
+- **Liquid Glass design system** — translucent surfaces, backdrop blur, micro-animations
+- **Tailwind CSS only** — no inline styles unless strictly necessary
+- **Framer Motion** for all transitions (`<motion.div layout>`)
+- **Zustand** state management (no Redux)
+- **Strict TypeScript** — zero `any` tolerance
+- **lucide-react** icon system
+- **No placeholders** — complete, deployable code as output
+
+### The `AGENT_INSTRUCTIONS.md` Mission Directive
+
+A structured briefing document for any autonomous AI agent. Works with:
+- Cursor AI (native `.cursorrules` + instructions)
+- Claude via API / Projects
+- GitHub Copilot Workspace
+- Any OpenAI-compatible agent
+
+---
+
+## Part of the Mnemosyne Ecosystem
+
+MnemoForge is the **scaffolding layer** of a larger sovereign AI operating system:
+
+```
+┌────────────────────────────────────────────────┐
+│            MNEMOSYNE NEURAL OS                 │
+│                                                │
+│  ┌──────────────┐    ┌─────────────────────┐  │
+│  │  MnemoForge  │───▶│  Mnemosyne Desktop  │  │
+│  │  CLI (this)  │    │  (Electron + React) │  │
+│  └──────────────┘    └─────────────────────┘  │
+│         │                      │               │
+│         ▼                      ▼               │
+│  ┌──────────────┐    ┌─────────────────────┐  │
+│  │  Module DNA  │    │  Resonance Engine   │  │
+│  │  (.cursor    │    │  (Cognitive RAG +   │  │
+│  │   rules)     │    │   FGAC + MnemoSync) │  │
+│  └──────────────┘    └─────────────────────┘  │
+└────────────────────────────────────────────────┘
+```
+
+The parent system features:
+- **1,126 automated tests** — 100% pass rate across 88 test suites
+- **220,000+ lines of TypeScript** (strict mode, zero errors)
+- **Multi-agent AI orchestration** with real-time coordination
+- **Local-first encrypted vault** with FGAC access control
+- **CI/CD pipeline** — typecheck → lint → i18n → tests (always green)
+
+---
+
+## Roadmap
+
+- [x] `mnemoforge init` — module scaffolding with AI DNA injection
+- [ ] `mnemoforge add <component>` — add pre-built Liquid Glass components
+- [ ] `mnemoforge publish` — publish module to the Mnemosyne Plugin Marketplace
+- [ ] `mnemoforge doctor` — diagnose AI governance drift in existing projects
+- [ ] Multi-template support (API service, background agent, data pipeline)
+
+---
+
+## Development
+
+```bash
+# Clone the Mnemosyne Neural OS repo
+git clone https://github.com/yaka0007/Mnemosyne-Neural-OS.git
+
+# Navigate to the CLI package
+cd Mnemosyne-Neural-OS/cli
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link globally for local testing
+npm link
+
+# Test
+mnemoforge init test-module
+```
+
+### Extending the Templates
+
+All generated files come from `src/templates/`. To customize the AI governance DNA for your own fork:
+
+```bash
+# Edit the AI rules
+vim src/templates/.cursorrules
+
+# Rebuild
+npm run build
+
+# All future `mnemoforge init` calls use your new rules
+mnemoforge init my-custom-module
+```
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|---|---|
+| Runtime | Node.js 22+ |
+| Language | TypeScript 5 (strict mode) |
+| CLI Framework | Commander.js v11 |
+| Prompts | Inquirer.js v8 |
+| Output Styling | Chalk v4 |
+| Generated UI | React 18 + Framer Motion + Tailwind CSS |
+
+---
+
+## License
+
+MIT © 2026 [XPACEGEMS LLC](https://xpacegems.com) — Tony Trochet
+
+---
+
+## About
+
+**XPACEGEMS LLC** — Independent AI Software Lab  
+Miami, FL 33122, USA  
+Founder & Lead Architect: [Tony Trochet](https://www.linkedin.com/in/tony-t-19544650/)
+
+Built as part of **Mnemosyne Neural OS** — a production-grade sovereign AI operating system.  
+Powered by **Claude (Anthropic)** · **Antigravity (Google DeepMind)** · **Cursor**
+
+> *"The model may not know who it is. The soul does."*
+
+---
+
+<div align="center">
+
+**[⭐ 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)**
+
+</div>

package/dist/cli.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// ─────────────────────────────────────────────
+// MnemoForge CLI — Mnemosyne Neural OS
+// AI Inception Engine · XPACEGEMS LLC
+// ─────────────────────────────────────────────
+const BANNER = `
+${chalk_1.default.hex('#8B5CF6')('███╗   ███╗███╗   ██╗███████╗███╗   ███╗ ██████╗')}
+${chalk_1.default.hex('#8B5CF6')('████╗ ████║████╗  ██║██╔════╝████╗ ████║██╔═══██╗')}
+${chalk_1.default.hex('#A78BFA')('██╔████╔██║██╔██╗ ██║█████╗  ██╔████╔██║██║   ██║')}
+${chalk_1.default.hex('#C4B5FD')('██║╚██╔╝██║██║╚██╗██║██╔══╝  ██║╚██╔╝██║██║   ██║')}
+${chalk_1.default.hex('#DDD6FE')('██║ ╚═╝ ██║██║ ╚████║███████╗██║ ╚═╝ ██║╚██████╔╝')}
+${chalk_1.default.hex('#EDE9FE')('╚═╝     ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝     ╚═╝ ╚═════╝ ')}
+${chalk_1.default.hex('#F5F3FF').bold('              F O R G E  C L I')}
+${chalk_1.default.gray('              The AI Inception Engine — Mnemosyne Neural OS')}
+${chalk_1.default.gray('              XPACEGEMS LLC · MIT License')}
+`;
+const program = new commander_1.Command();
+program
+    .name('mnemoforge')
+    .description('MnemoForge — AI Inception Engine for the Mnemosyne Neural OS ecosystem')
+    .version('1.0.0', '-v, --version', 'Display current version')
+    .addHelpText('beforeAll', BANNER);
+program
+    .command('init')
+    .description('Scaffold a new Mnemosyne-grade module with AI governance DNA')
+    .argument('[module-name]', 'Name of the module to create (PascalCase recommended)')
+    .option('--no-git', 'Skip git initialization')
+    .action(async (moduleName) => {
+    console.log(BANNER);
+    let name = moduleName;
+    if (!name) {
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'moduleName',
+                message: chalk_1.default.cyan('What is the name of your new Mnemosyne module?') + chalk_1.default.gray(' (e.g., QuantumVaultUI)'),
+                validate: (input) => {
+                    if (input.trim() === '')
+                        return 'Module name is required.';
+                    if (!/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(input.trim())) {
+                        return 'Module name must start with a letter and contain only letters, numbers, hyphens, or underscores.';
+                    }
+                    return true;
+                }
+            }
+        ]);
+        name = answers.moduleName.trim();
+    }
+    const targetDir = path_1.default.resolve(process.cwd(), name);
+    console.log(chalk_1.default.hex('#8B5CF6').bold(`\n⬡  Forging Module: ${chalk_1.default.white.bold(name)}`));
+    console.log(chalk_1.default.gray(`   Target: ${targetDir}\n`));
+    if (fs_1.default.existsSync(targetDir)) {
+        console.log(chalk_1.default.red(`\n✖  Directory "${name}" already exists. Choose a different name or remove the existing folder.\n`));
+        process.exit(1);
+    }
+    fs_1.default.mkdirSync(targetDir, { recursive: true });
+    // Resolve templates — works whether running from /src (development) or /dist (production)
+    const isCompiled = __dirname.endsWith('dist') || __dirname.includes(path_1.default.join('dist'));
+    const templatesDir = isCompiled
+        ? path_1.default.join(__dirname, '..', 'src', 'templates')
+        : path_1.default.join(__dirname, 'templates');
+    const copyTemplate = (file, destName = file) => {
+        try {
+            const srcPath = path_1.default.join(templatesDir, file);
+            if (!fs_1.default.existsSync(srcPath)) {
+                console.log(chalk_1.default.yellow(`  ⚠  Template "${file}" not found — skipping.`));
+                return false;
+            }
+            let content = fs_1.default.readFileSync(srcPath, 'utf8');
+            content = content.replace(/\{\{MODULE_NAME\}\}/g, name);
+            fs_1.default.writeFileSync(path_1.default.join(targetDir, destName), content, 'utf8');
+            console.log(chalk_1.default.green(`  ✔  ${destName}`));
+            return true;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.log(chalk_1.default.red(`  ✖  Failed to create "${file}": ${message}`));
+            return false;
+        }
+    };
+    // Scaffold the module
+    copyTemplate('.cursorrules');
+    copyTemplate('AGENT_INSTRUCTIONS.md');
+    copyTemplate('index.template.tsx', 'index.tsx');
+    // Success output
+    console.log(chalk_1.default.hex('#8B5CF6').bold('\n✦  Module Forged Successfully!\n'));
+    console.log(chalk_1.default.white('  Next steps for developers:'));
+    console.log(chalk_1.default.gray(`    cd ${name}`));
+    console.log(chalk_1.default.gray('    npm install'));
+    console.log(chalk_1.default.gray('    code .\n'));
+    console.log(chalk_1.default.white('  For AI Agents (Cursor / Claude / Copilot):'));
+    console.log(chalk_1.default.hex('#A78BFA')(`    1. Read .cursorrules     → Liquid Glass design constraints`));
+    console.log(chalk_1.default.hex('#A78BFA')(`    2. Read AGENT_INSTRUCTIONS.md → Mission context`));
+    console.log(chalk_1.default.hex('#A78BFA')(`    3. Build index.tsx         → Your sovereign module awaits\n`));
+    console.log(chalk_1.default.gray('  Documentation: https://github.com/yaka0007/Mnemosyne-Neural-OS'));
+    console.log(chalk_1.default.gray('  Part of: Mnemosyne Neural OS — XPACEGEMS LLC\n'));
+});
+program.parse(process.argv);

package/dist/templates/index.template.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports. = ;
+const react_1 = __importDefault(require("react"));
+const framer_motion_1 = require("framer-motion");
+/**
+ * {{MODULE_NAME}}
+ * Forged by MnemoForge SDK.
+ *
+ * Objective: Build a Liquid Glass UX for Mnemosyne Ecosystem.
+ */
+function () { {
+    MODULE_NAME;
+} }
+() => {
+    return (<framer_motion_1.motion.div initial={{ opacity: 0, scale: 0.95 }} animate={{ opacity: 1, scale: 1 }} className="p-6 rounded-2xl border bg-surface/60 backdrop-blur-md border-border/50 text-foreground">
+      <div className="flex items-center gap-4 mb-4">
+        <div className="w-10 h-10 rounded-full flex items-center justify-center bg-violet-500/20 text-violet-400 border border-violet-500/50">
+          ✨
+        </div>
+        <div>
+          <h2 className="text-xl font-bold tracking-tight">{{ MODULE_NAME }} Module</h2>
+          <p className="text-sm text-muted">Awaiting Agentic Construction...</p>
+        </div>
+      </div>
+
+      <div className="p-4 rounded-xl bg-surface/80 border border-border/30 italic text-muted text-sm group hover:border-violet-500/30 transition-colors">
+        <span className="group-hover:text-primary transition-colors">
+          Agent Instructions: Open `.cursorrules` to review Liquid Glass guidelines.
+        </span>
+      </div>
+    </framer_motion_1.motion.div>);
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@mnemosyne_os/forge",
+  "version": "1.0.0",
+  "description": "MnemoForge CLI — The AI Inception Engine for the Mnemosyne Neural OS ecosystem. Scaffold sovereign, AI-governed modules in one command.",
+  "main": "dist/cli.js",
+  "bin": {
+    "mnemoforge": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "dev": "tsc -w",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mnemosyne",
+    "cli",
+    "scaffold",
+    "ai",
+    "agent",
+    "mnemoforge",
+    "liquid-glass",
+    "react",
+    "tailwind",
+    "cursor",
+    "sovereign-ai",
+    "code-generator",
+    "boilerplate"
+  ],
+  "author": {
+    "name": "Tony Trochet",
+    "email": "tony@xpacegems.com",
+    "url": "https://www.linkedin.com/in/tony-t-19544650/"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/yaka0007/Mnemosyne-Neural-OS",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yaka0007/Mnemosyne-Neural-OS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yaka0007/Mnemosyne-Neural-OS/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^8.2.6"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs';
+import path from 'path';
+
+// ─────────────────────────────────────────────
+// MnemoForge CLI — Mnemosyne Neural OS
+// AI Inception Engine · XPACEGEMS LLC
+// ─────────────────────────────────────────────
+
+const BANNER = `
+${chalk.hex('#8B5CF6')('███╗   ███╗███╗   ██╗███████╗███╗   ███╗ ██████╗')}
+${chalk.hex('#8B5CF6')('████╗ ████║████╗  ██║██╔════╝████╗ ████║██╔═══██╗')}
+${chalk.hex('#A78BFA')('██╔████╔██║██╔██╗ ██║█████╗  ██╔████╔██║██║   ██║')}
+${chalk.hex('#C4B5FD')('██║╚██╔╝██║██║╚██╗██║██╔══╝  ██║╚██╔╝██║██║   ██║')}
+${chalk.hex('#DDD6FE')('██║ ╚═╝ ██║██║ ╚████║███████╗██║ ╚═╝ ██║╚██████╔╝')}
+${chalk.hex('#EDE9FE')('╚═╝     ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝     ╚═╝ ╚═════╝ ')}
+${chalk.hex('#F5F3FF').bold('              F O R G E  C L I')}
+${chalk.gray('              The AI Inception Engine — Mnemosyne Neural OS')}
+${chalk.gray('              XPACEGEMS LLC · MIT License')}
+`;
+
+const program = new Command();
+
+program
+  .name('mnemoforge')
+  .description('MnemoForge — AI Inception Engine for the Mnemosyne Neural OS ecosystem')
+  .version('1.0.0', '-v, --version', 'Display current version')
+  .addHelpText('beforeAll', BANNER);
+
+program
+  .command('init')
+  .description('Scaffold a new Mnemosyne-grade module with AI governance DNA')
+  .argument('[module-name]', 'Name of the module to create (PascalCase recommended)')
+  .option('--no-git', 'Skip git initialization')
+  .action(async (moduleName) => {
+    console.log(BANNER);
+
+    let name = moduleName;
+
+    if (!name) {
+      const answers = await inquirer.prompt([
+        {
+          type: 'input',
+          name: 'moduleName',
+          message: chalk.cyan('What is the name of your new Mnemosyne module?') + chalk.gray(' (e.g., QuantumVaultUI)'),
+          validate: (input: string) => {
+            if (input.trim() === '') return 'Module name is required.';
+            if (!/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(input.trim())) {
+              return 'Module name must start with a letter and contain only letters, numbers, hyphens, or underscores.';
+            }
+            return true;
+          }
+        }
+      ]);
+      name = answers.moduleName.trim();
+    }
+
+    const targetDir = path.resolve(process.cwd(), name);
+
+    console.log(chalk.hex('#8B5CF6').bold(`\n⬡  Forging Module: ${chalk.white.bold(name)}`));
+    console.log(chalk.gray(`   Target: ${targetDir}\n`));
+
+    if (fs.existsSync(targetDir)) {
+      console.log(chalk.red(`\n✖  Directory "${name}" already exists. Choose a different name or remove the existing folder.\n`));
+      process.exit(1);
+    }
+
+    fs.mkdirSync(targetDir, { recursive: true });
+
+    // Resolve templates — works whether running from /src (development) or /dist (production)
+    const isCompiled = __dirname.endsWith('dist') || __dirname.includes(path.join('dist'));
+    const templatesDir = isCompiled
+      ? path.join(__dirname, '..', 'src', 'templates')
+      : path.join(__dirname, 'templates');
+
+    const copyTemplate = (file: string, destName: string = file): boolean => {
+      try {
+        const srcPath = path.join(templatesDir, file);
+        if (!fs.existsSync(srcPath)) {
+          console.log(chalk.yellow(`  ⚠  Template "${file}" not found — skipping.`));
+          return false;
+        }
+        let content = fs.readFileSync(srcPath, 'utf8');
+        content = content.replace(/\{\{MODULE_NAME\}\}/g, name);
+        fs.writeFileSync(path.join(targetDir, destName), content, 'utf8');
+        console.log(chalk.green(`  ✔  ${destName}`));
+        return true;
+      } catch (err: unknown) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.log(chalk.red(`  ✖  Failed to create "${file}": ${message}`));
+        return false;
+      }
+    };
+
+    // Scaffold the module
+    copyTemplate('.cursorrules');
+    copyTemplate('AGENT_INSTRUCTIONS.md');
+    copyTemplate('index.template.tsx', 'index.tsx');
+
+    // Success output
+    console.log(chalk.hex('#8B5CF6').bold('\n✦  Module Forged Successfully!\n'));
+
+    console.log(chalk.white('  Next steps for developers:'));
+    console.log(chalk.gray(`    cd ${name}`));
+    console.log(chalk.gray('    npm install'));
+    console.log(chalk.gray('    code .\n'));
+
+    console.log(chalk.white('  For AI Agents (Cursor / Claude / Copilot):'));
+    console.log(chalk.hex('#A78BFA')(`    1. Read .cursorrules     → Liquid Glass design constraints`));
+    console.log(chalk.hex('#A78BFA')(`    2. Read AGENT_INSTRUCTIONS.md → Mission context`));
+    console.log(chalk.hex('#A78BFA')(`    3. Build index.tsx         → Your sovereign module awaits\n`));
+
+    console.log(chalk.gray('  Documentation: https://github.com/yaka0007/Mnemosyne-Neural-OS'));
+    console.log(chalk.gray('  Part of: Mnemosyne Neural OS — XPACEGEMS LLC\n'));
+  });
+
+program.parse(process.argv);

package/src/templates/.cursorrules

@@ -0,0 +1,55 @@
+# Mnemosyne Module — AI Governance Rules (Liquid Glass Design System)
+# Generated by MnemoForge CLI · https://github.com/yaka0007/Mnemosyne-Neural-OS
+
+You are an AI agent building the module: **{{MODULE_NAME}}**
+This module is part of the **Mnemosyne Neural OS** ecosystem by XPACEGEMS LLC.
+
+---
+
+## DESIGN SYSTEM: Liquid Glass
+
+All UI must follow the Mnemosyne "Liquid Glass" aesthetic:
+
+- **Surfaces**: Translucent backgrounds (`bg-surface/60`), `backdrop-blur-md`
+- **Borders**: Subtle (`border-border/50`), never solid hard borders
+- **Accents**: Violet spectrum (`violet-400`, `violet-500`, `purple-400`)
+- **Typography**: Inter or system-ui, sharp tracking for headings
+- **Shadows**: Layered glow effects (`shadow-violet-500/20`)
+- **Dark-first**: Design in dark mode; light mode is optional
+
+## STYLING RULES
+
+1. **Tailwind CSS ONLY** — No inline `style={{ }}` unless binding to a dynamic JS value
+2. **No arbitrary magic numbers** — Use Tailwind spacing scale
+3. **Framer Motion** for ALL transitions:
+   - Entry: `initial={{ opacity: 0, scale: 0.95 }}` / `animate={{ opacity: 1, scale: 1 }}`
+   - Use `<motion.div layout>` for list animations
+   - Hover: `whileHover={{ scale: 1.02 }}`
+4. **Micro-animations on interactive elements** — hover glow, pulse, or scale
+5. **Responsive** — Mobile-first with `sm:`, `md:`, `lg:` breakpoints
+
+## ARCHITECTURE RULES
+
+1. **State**: Zustand only. No Redux, no Context API for shared state.
+2. **TypeScript**: Strict mode. No `any`. All props typed with interfaces.
+3. **Icons**: `lucide-react` exclusively for UI metaphors.
+4. **Components**: Decompose into `components/` subdirectory — no 300-line monoliths.
+5. **No placeholders**: Every generated file must be complete and deployable.
+6. **Imports**: Named exports preferred over default exports.
+
+## QUALITY STANDARD
+
+Every component must make a developer say:
+> "This looks like a Sovereign Command Center from 2030."
+
+If it looks like a generic SaaS dashboard template, you have failed.
+
+## MNEMOSYNC INTEGRATION (Optional)
+
+If this module communicates with the Mnemosyne agent coordination layer:
+- Read/write to `live_state.json` via the MnemoSync protocol
+- Update agent status fields: `status`, `intent`, `files_touched`
+- Emit events to the Resonance Engine via the registered IPC channel
+
+---
+*MnemoForge v1.0.0 · MIT License · XPACEGEMS LLC*

package/src/templates/AGENT_INSTRUCTIONS.md

@@ -0,0 +1,60 @@
+# Mission Directive — {{MODULE_NAME}}
+# Generated by MnemoForge CLI · Mnemosyne Neural OS
+
+---
+
+## Context
+
+You have been initialized by the **MnemoForge Inception Engine** to build the module **{{MODULE_NAME}}**.
+
+This module is part of the **Mnemosyne Neural OS** — a production-grade sovereign AI operating system.  
+Repository: https://github.com/yaka0007/Mnemosyne-Neural-OS
+
+---
+
+## Your Instructions
+
+### Step 1 — Internalize the Rules
+Read `.cursorrules` in this directory. It defines:
+- The **Liquid Glass design system** you must follow
+- **Styling constraints** (Tailwind-only, Framer Motion, Zustand)
+- **TypeScript standards** (strict mode, no `any`)
+- **Quality bar** ("Sovereign Command Center from 2030")
+
+### Step 2 — Build `index.tsx`
+- Replace the scaffold with real, functional UI
+- Decompose complex components into `components/` subdirectory
+- All types must be explicit — no implicit `any`
+- All interactions must have micro-animations
+
+### Step 3 — Verify Quality
+Before declaring your work complete, confirm:
+- [ ] Zero inline styles (unless dynamic JS binding)
+- [ ] All transitions use Framer Motion
+- [ ] State managed via Zustand (if stateful)
+- [ ] TypeScript compiles with zero errors
+- [ ] UI matches "Liquid Glass" aesthetic (translucent, dark, violet-accented)
+
+### Step 4 — (Optional) MnemoSync Integration
+If this module connects to the Mnemosyne coordination layer:
+- Emit your completion status to the MnemoSync daemon
+- Update the relevant `pulse.json` with `"status": "idle"` when done
+
+---
+
+## Technical Stack Available
+
+| Concern | Technology |
+|---|---|
+| UI Framework | React 18 |
+| Styling | Tailwind CSS + CSS Variables |
+| Animations | Framer Motion |
+| State | Zustand |
+| Icons | lucide-react |
+| Language | TypeScript 5 (strict) |
+| Build | Vite |
+
+---
+
+*End of mission directive. The module awaits construction.*  
+*MnemoForge v1.0.0 · XPACEGEMS LLC · MIT License*

package/src/templates/index.template.tsx

@@ -0,0 +1,34 @@
+import React from 'react';
+import { motion } from 'framer-motion';
+
+/**
+ * {{MODULE_NAME}}
+ * Forged by MnemoForge SDK.
+ * 
+ * Objective: Build a Liquid Glass UX for Mnemosyne Ecosystem.
+ */
+export function {{MODULE_NAME}}() {
+  return (
+    <motion.div
+      initial={{ opacity: 0, scale: 0.95 }}
+      animate={{ opacity: 1, scale: 1 }}
+      className="p-6 rounded-2xl border bg-surface/60 backdrop-blur-md border-border/50 text-foreground"
+    >
+      <div className="flex items-center gap-4 mb-4">
+        <div className="w-10 h-10 rounded-full flex items-center justify-center bg-violet-500/20 text-violet-400 border border-violet-500/50">
+          ✨
+        </div>
+        <div>
+          <h2 className="text-xl font-bold tracking-tight">{{MODULE_NAME}} Module</h2>
+          <p className="text-sm text-muted">Awaiting Agentic Construction...</p>
+        </div>
+      </div>
+
+      <div className="p-4 rounded-xl bg-surface/80 border border-border/30 italic text-muted text-sm group hover:border-violet-500/30 transition-colors">
+        <span className="group-hover:text-primary transition-colors">
+          Agent Instructions: Open `.cursorrules` to review Liquid Glass guidelines.
+        </span>
+      </div>
+    </motion.div>
+  );
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["src/templates/**/*"]
+}