@mnemosyne_os/forge 1.2.4 → 1.2.5

package/dist/lib/canvas/canvas.js

@@ -0,0 +1,92 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// MnemoCanvas — Orchestrator
+// Handles template discovery, scaffolding, and project initialization
+// ─────────────────────────────────────────────────────────────────────────────
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CANVAS_TEMPLATES = void 0;
+exports.scaffold = scaffold;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const renderer_js_1 = require("./renderer.js");
+const files_js_1 = require("./templates/cli/files.js");
+// ── Template registry ─────────────────────────────────────────────────────
+exports.CANVAS_TEMPLATES = [
+    {
+        id: 'cli',
+        name: 'Node.js CLI',
+        description: 'A full CLI project — Commander.js + Chalk + Inquirer + TypeScript',
+        stack: 'Commander · Chalk · Inquirer · TypeScript',
+        icon: '◈',
+        files: files_js_1.CLI_TEMPLATE,
+    },
+    {
+        id: 'api',
+        name: 'REST API',
+        description: 'Fastify API with Zod validation — production-ready (coming soon)',
+        stack: 'Fastify · Zod · TypeScript',
+        icon: '◆',
+        files: [], // Phase 2
+    },
+    {
+        id: 'react-module',
+        name: 'React Module',
+        description: 'Mnemosyne-compliant React 18 module (coming soon)',
+        stack: 'React 18 · Tailwind · Framer Motion',
+        icon: '◇',
+        files: [], // Phase 2
+    },
+    {
+        id: 'agent-service',
+        name: 'Agent Service',
+        description: 'Background AI agent service (coming soon)',
+        stack: 'Node.js · TypeScript · Agent structure',
+        icon: '✦',
+        files: [], // Phase 2
+    },
+];
+// ── Write a single file ───────────────────────────────────────────────────
+function writeFile(rootDir, file, vars, log) {
+    const dest = path_1.default.join(rootDir, file.path);
+    const dir = path_1.default.dirname(dest);
+    fs_1.default.mkdirSync(dir, { recursive: true });
+    const rendered = (0, renderer_js_1.render)(file.content, vars);
+    fs_1.default.writeFileSync(dest, rendered, 'utf8');
+    log(file.path);
+}
+// ── Main scaffold function ────────────────────────────────────────────────
+function scaffold(opts, onFile) {
+    const template = exports.CANVAS_TEMPLATES.find(t => t.id === opts.template);
+    if (!template)
+        throw new Error(`Unknown template: ${opts.template}`);
+    if (template.files.length === 0)
+        throw new Error(`Template "${opts.template}" is not yet available.`);
+    const slug = (0, renderer_js_1.toSlug)(opts.projectName);
+    const rootDir = opts.targetDir ?? path_1.default.join(process.cwd(), slug);
+    const vars = (0, renderer_js_1.buildVars)(opts.projectName, opts.workspace, opts.author, opts.email);
+    const filesCreated = [];
+    const errors = [];
+    // Refuse to overwrite non-empty existing directory
+    if (fs_1.default.existsSync(rootDir)) {
+        const contents = fs_1.default.readdirSync(rootDir);
+        if (contents.length > 0) {
+            throw new Error(`Directory "${rootDir}" already exists and is not empty.`);
+        }
+    }
+    fs_1.default.mkdirSync(rootDir, { recursive: true });
+    for (const file of template.files) {
+        try {
+            writeFile(rootDir, file, vars, (f) => {
+                filesCreated.push(f);
+                onFile?.(f);
+            });
+        }
+        catch (err) {
+            errors.push(`${file.path}: ${err.message}`);
+        }
+    }
+    return { rootDir, filesCreated, errors };
+}

package/dist/lib/canvas/renderer.js

@@ -0,0 +1,40 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// MnemoCanvas — Template Renderer
+// Simple variable interpolation engine — zero dependencies
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.render = render;
+exports.toSlug = toSlug;
+exports.toPascal = toPascal;
+exports.buildVars = buildVars;
+// ── Renderer ──────────────────────────────────────────────────────────────
+function render(template, vars) {
+    return Object.entries(vars).reduce((out, [key, val]) => {
+        return out.replaceAll(`{{${key}}}`, val);
+    }, template);
+}
+function toSlug(name) {
+    return name
+        .replace(/([A-Z])/g, (m, i) => (i > 0 ? '-' : '') + m)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function toPascal(slug) {
+    return slug.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+}
+function buildVars(projectName, workspace, author = 'XPACEGEMS', email = '') {
+    const slug = toSlug(projectName);
+    return {
+        PROJECT_NAME: projectName,
+        PROJECT_SLUG: slug,
+        PROJECT_PASCAL: toPascal(slug),
+        WORKSPACE: workspace,
+        DATE: new Date().toISOString().slice(0, 10),
+        AUTHOR: author,
+        AUTHOR_EMAIL: email,
+        MNEMOFORGE_VERSION: '1.2.4',
+    };
+}

package/dist/lib/canvas/templates/cli/files.js

@@ -0,0 +1,288 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// MnemoCanvas — CLI Template
+// Generates a full Node.js CLI project wired to the Mnemosyne ecosystem
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_TEMPLATE = void 0;
+exports.CLI_TEMPLATE = [
+    // ── package.json ─────────────────────────────────────────────────────────
+    {
+        path: 'package.json',
+        content: `{
+  "name": "{{PROJECT_SLUG}}",
+  "version": "0.1.0",
+  "description": "{{PROJECT_NAME}} — Built with MnemoForge · Mnemosyne Neural OS",
+  "type": "module",
+  "bin": {
+    "{{PROJECT_SLUG}}": "./dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["cli", "mnemosyne", "{{PROJECT_SLUG}}"],
+  "author": "{{AUTHOR}} <{{AUTHOR_EMAIL}}>",
+  "license": "MIT",
+  "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"
+  }
+}
+`,
+    },
+    // ── tsconfig.json ─────────────────────────────────────────────────────────
+    {
+        path: 'tsconfig.json',
+        content: `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+`,
+    },
+    // ── .gitignore ────────────────────────────────────────────────────────────
+    {
+        path: '.gitignore',
+        content: `node_modules/
+dist/
+*.log
+.DS_Store
+Thumbs.db
+`,
+    },
+    // ── .cursorrules ──────────────────────────────────────────────────────────
+    {
+        path: '.cursorrules',
+        content: `# {{PROJECT_NAME}} — AI Governance Rules
+# Generated by MnemoForge v{{MNEMOFORGE_VERSION}} on {{DATE}}
+# Workspace: {{WORKSPACE}}
+
+## Identity
+You are working on **{{PROJECT_NAME}}**, a CLI tool built within the Mnemosyne Neural OS ecosystem.
+
+## Language & Stack
+- TypeScript 5 (strict mode) — zero \`any\` tolerance
+- Node.js 18+ (ESM modules)
+- Commander.js for command structure
+- Chalk for terminal colors
+- Inquirer.js for interactive prompts
+
+## Code Standards
+- All functions must have explicit return types
+- Use \`chalk.hex()\` for colors — never plain chalk colors
+- Error handling: always use \`process.exit(1)\` on fatal errors
+- Console output: always prefix with 2 spaces for alignment
+
+## Chronicle & Memory
+- Before starting a session, run: \`mnemoforge workspace show\`
+- After key decisions, write a chronicle in \`handbook/chronicles/\`
+- Archive chronicles with: \`mnemoforge chronicle archive --file <path>\`
+
+## Mnemosyne Neural OS
+This project is part of the Mnemosyne ecosystem.
+Repository: https://github.com/yaka0007/Mnemosyne-Neural-OS
+`,
+    },
+    // ── AGENT_INSTRUCTIONS.md ─────────────────────────────────────────────────
+    {
+        path: 'AGENT_INSTRUCTIONS.md',
+        content: `# {{PROJECT_NAME}} — Agent Mission Directive
+*Generated by MnemoForge v{{MNEMOFORGE_VERSION}} · {{DATE}}*
+
+## Context
+You are an AI agent (Cursor, Claude, Copilot, or similar) working on **{{PROJECT_NAME}}**.
+This is a CLI tool built within the **{{WORKSPACE}}** workspace of the Mnemosyne Neural OS ecosystem.
+
+## Before You Start
+1. Run \`mnemoforge workspace show\` to read the project safety rules
+2. Read the latest chronicle: \`mnemoforge chronicle open\`
+3. Check the vault: \`mnemoforge chronicle list\`
+
+## Your Mission
+Build and maintain {{PROJECT_NAME}} according to Mnemosyne standards:
+- TypeScript strict, no \`any\`
+- Clean terminal UX with chalk color palette
+- Write a chronicle after each significant session
+
+## After You Finish
+Archive your session chronicle:
+\`\`\`bash
+mnemoforge chronicle archive --file handbook/chronicles/CHRONICLE-YYYY-MM-DD-session.md
+\`\`\`
+
+*"The model may not know who it is. The soul does."*
+`,
+    },
+    // ── WORKSPACE.json ────────────────────────────────────────────────────────
+    {
+        path: 'WORKSPACE.json',
+        content: `{
+  "workspace": "{{WORKSPACE}}",
+  "project": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "created": "{{DATE}}",
+  "last_updated": "{{DATE}}",
+  "updated_by": "MnemoForge canvas",
+  "npm": {
+    "rules": [
+      "Always bump version before npm publish",
+      "Run pnpm run build before publish",
+      "Never publish with node_modules in package"
+    ]
+  },
+  "architecture": {
+    "rules": [
+      "TypeScript strict — zero any",
+      "Commander.js for all command structure",
+      "Chalk hex colors only — no plain chalk colors",
+      "All errors use process.exit(1)"
+    ]
+  },
+  "neural_coding": {
+    "principles": [
+      "Read workspace rules before starting any session",
+      "Write a chronicle after each significant decision",
+      "The agent understands context — no mechanical re-explanations"
+    ]
+  }
+}
+`,
+    },
+    // ── src/cli.ts ────────────────────────────────────────────────────────────
+    {
+        path: 'src/cli.ts',
+        content: `#!/usr/bin/env node
+// {{PROJECT_NAME}} CLI
+// Generated by MnemoForge v{{MNEMOFORGE_VERSION}} · {{DATE}}
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+// ── Color palette ─────────────────────────────────────────────────────────
+const V  = chalk.hex('#8B5CF6');
+const V2 = chalk.hex('#A78BFA');
+const DIM = chalk.gray;
+
+// ── Program ───────────────────────────────────────────────────────────────
+const program = new Command()
+  .name('{{PROJECT_SLUG}}')
+  .description('{{PROJECT_NAME}} — Built with MnemoForge · Mnemosyne Neural OS')
+  .version('0.1.0', '-v, --version')
+  .action(() => {
+    console.log(V.bold('\\n  ⬡  {{PROJECT_NAME}}\\n'));
+    console.log(DIM('  A Mnemosyne-grade CLI.'));
+    console.log(DIM('  Run ') + chalk.white('{{PROJECT_SLUG}} --help') + DIM(' to see commands.\\n'));
+  });
+
+// ── Example command ───────────────────────────────────────────────────────
+program
+  .command('hello')
+  .description('Say hello')
+  .action(() => {
+    console.log(V2.bold('\\n  ⬡  {{PROJECT_NAME}}\\n'));
+    console.log(chalk.white('  Hello from {{PROJECT_NAME}}! 👋\\n'));
+  });
+
+program.parse(process.argv);
+`,
+    },
+    // ── handbook/chronicles/.gitkeep ─────────────────────────────────────────
+    {
+        path: 'handbook/chronicles/.gitkeep',
+        content: '',
+    },
+    // ── ROADMAP.md ────────────────────────────────────────────────────────────
+    {
+        path: 'ROADMAP.md',
+        content: `# {{PROJECT_NAME}} — Roadmap
+*Generated by MnemoForge v{{MNEMOFORGE_VERSION}} · {{DATE}}*
+*Workspace: {{WORKSPACE}}*
+
+---
+
+## Context
+
+**{{PROJECT_NAME}}** is a CLI tool built within the {{WORKSPACE}} ecosystem.
+This file is the **source of truth for any agent** working on this project.
+Read it before starting any session.
+
+## Current State
+
+- Version: 0.1.0
+- Stack: Node.js · TypeScript · Commander.js · Chalk · Inquirer
+- Chronicles vault: \`handbook/chronicles/\`
+
+## Before You Start (Agent Checklist)
+
+1. Read this file
+2. Run \`mnemoforge workspace show\` for safety rules
+3. Run \`mnemoforge chronicle list\` to see recent decisions
+
+---
+
+## Phase 0 — Foundation *(current)*
+
+- [x] Project scaffolded with MnemoForge canvas
+- [ ] Core command structure in \`src/cli.ts\`
+- [ ] First release published
+
+## Phase 1 — Core Features
+
+> Define your features here
+
+- [ ] Feature A
+- [ ] Feature B
+
+## Phase 2 — Polish
+
+> Testing, documentation, UX
+
+- [ ] Unit tests
+- [ ] README documentation
+- [ ] First public release
+
+---
+
+## Key Decisions
+
+> Log important architectural decisions here as you go.
+> Example: "2026-04-05 — Chose Commander.js over yargs for simpler API"
+
+| Date | Decision | Rationale |
+|------|----------|-----------|
+| {{DATE}} | Project created with MnemoForge canvas | Standard Mnemosyne CLI template |
+
+---
+
+## Agent Notes
+
+*Add notes for your AI agent here — context, constraints, things to remember.*
+
+- This project follows Mnemosyne Neural OS coding standards
+- Write a chronicle after significant work sessions
+`,
+    },
+];

package/dist/lib/chronicle-parser.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseChronicle = parseChronicle;
+exports.getChronicleType = getChronicleType;
+// ─────────────────────────────────────────────────────────────────────────────
+// MnemoChronicle — Markdown Parser
+// Extracts metadata (title, type, date, tags, excerpt) from chronicle files
+// ─────────────────────────────────────────────────────────────────────────────
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function parseChronicle(filename, dir) {
+    const filePath = path_1.default.join(dir, filename);
+    const rawSlug = filename.replace(/^CHRONICLE-\d{4}-\d{2}-\d{2}-/, '').replace(/\.md$/, '').replace(/-/g, ' ');
+    let title = rawSlug.charAt(0).toUpperCase() + rawSlug.slice(1);
+    let type = 'session';
+    const tags = [];
+    let excerpt = '';
+    const dateMatch = filename.match(/CHRONICLE-(\d{4}-\d{2}-\d{2})/);
+    let date = dateMatch ? dateMatch[1] : '';
+    try {
+        const raw = fs_1.default.readFileSync(filePath, 'utf8');
+        const resonanceIdx = raw.indexOf('<!--resonance');
+        const content = resonanceIdx !== -1 ? raw.slice(0, resonanceIdx) : raw;
+        const lines = content.split('\n');
+        let inFrontmatter = false, frontmatterDone = false, dividerCount = 0;
+        const bodyLines = [];
+        for (const line of lines.slice(0, 40)) {
+            const l = line.trim();
+            if (l === '---' && !frontmatterDone) {
+                dividerCount++;
+                if (dividerCount === 1) {
+                    inFrontmatter = true;
+                    continue;
+                }
+                if (dividerCount === 2) {
+                    inFrontmatter = false;
+                    frontmatterDone = true;
+                    continue;
+                }
+            }
+            if (inFrontmatter) {
+                if (l.startsWith('title:'))
+                    title = l.replace('title:', '').trim().replace(/^['"]|['"]$/g, '');
+                if (l.startsWith('type:'))
+                    type = l.replace('type:', '').trim();
+                if (l.startsWith('date:') && l.match(/\d{4}-\d{2}-\d{2}/))
+                    date = l.match(/\d{4}-\d{2}-\d{2}/)[0];
+                continue;
+            }
+            if (l.startsWith('# ')) {
+                title = l.slice(2).trim();
+                continue;
+            }
+            if (l.startsWith('**Type**:')) {
+                type = l.replace('**Type**:', '').trim().toLowerCase();
+                continue;
+            }
+            if (l.startsWith('**Date**:')) {
+                const d = l.replace('**Date**:', '').trim();
+                if (d.match(/\d{4}-\d{2}-\d{2}/))
+                    date = d.match(/\d{4}-\d{2}-\d{2}/)[0];
+                continue;
+            }
+            if (l.match(/^\*\*\w/))
+                continue;
+            if (l === '---')
+                continue;
+            if (l.length > 8 && frontmatterDone && !l.startsWith('#') && !l.match(/^[\w_]+:\s*/))
+                bodyLines.push(l);
+        }
+        const firstMeaningful = bodyLines.find(l => l.length > 10);
+        if (firstMeaningful)
+            excerpt = firstMeaningful.slice(0, 92) + (firstMeaningful.length > 92 ? '…' : '');
+    }
+    catch { /* use slug defaults */ }
+    return { title, type, tags, excerpt, date };
+}
+function getChronicleType(filename, dir) {
+    try {
+        const raw = fs_1.default.readFileSync(path_1.default.join(dir, filename), 'utf8').slice(0, 800);
+        const m = raw.match(/\*\*Type\*\*:\s*(\w+)/i) || raw.match(/^type:\s*(\w+)/im);
+        return m ? m[1].toLowerCase() : 'session';
+    }
+    catch {
+        return 'session';
+    }
+}

package/dist/lib/chronicle-render.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderChronicle = renderChronicle;
+// ─────────────────────────────────────────────────────────────────────────────
+// MnemoChronicle — Terminal Renderer
+// Renders Markdown chronicle files as colored terminal output
+// ─────────────────────────────────────────────────────────────────────────────
+const fs_1 = __importDefault(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+function renderChronicle(filePath) {
+    const raw = fs_1.default.readFileSync(filePath, 'utf8');
+    const resonanceIdx = raw.indexOf('<!--resonance');
+    const content = resonanceIdx !== -1 ? raw.slice(0, resonanceIdx) : raw;
+    console.log('\n' + chalk_1.default.hex('#312E81')('  ' + '─'.repeat(72)));
+    console.log(chalk_1.default.gray(`  ${filePath}`));
+    console.log(chalk_1.default.hex('#312E81')('  ' + '─'.repeat(72)) + '\n');
+    let dividerCount = 0;
+    for (const line of content.split('\n')) {
+        const l = line.trim();
+        if (l.startsWith('# ')) {
+            console.log('\n  ' + chalk_1.default.hex('#8B5CF6').bold(l.slice(2)));
+            continue;
+        }
+        if (l.startsWith('## ')) {
+            console.log('\n  ' + chalk_1.default.hex('#A78BFA').bold('  ' + l.slice(3)));
+            continue;
+        }
+        if (l.startsWith('### ')) {
+            console.log('  ' + chalk_1.default.hex('#C084FC')('    ' + l.slice(4)));
+            continue;
+        }
+        if (l === '---') {
+            dividerCount++;
+            if (dividerCount <= 2)
+                console.log(chalk_1.default.hex('#312E81')('  ' + '─'.repeat(60)));
+            continue;
+        }
+        if (l.match(/^\*\*[\w\s]+\*\*:/)) {
+            const p = l.match(/^\*\*([\w\s]+)\*\*:\s*(.*)/) ?? [];
+            if (p.length >= 3)
+                console.log('  ' + chalk_1.default.hex('#64748B')(`  ${p[1].padEnd(14)} `) + chalk_1.default.hex('#94A3B8')(p[2]));
+            continue;
+        }
+        if (l.startsWith('> ')) {
+            console.log('  ' + chalk_1.default.hex('#7C3AED')('  │ ') + chalk_1.default.hex('#DDD6FE').italic(l.slice(2)));
+            continue;
+        }
+        if (l.startsWith('- ') || l.startsWith('* ')) {
+            console.log('  ' + chalk_1.default.hex('#6B7280')('    • ') + chalk_1.default.white(l.slice(2)));
+            continue;
+        }
+        if (l.match(/^\d+\. /)) {
+            console.log('  ' + chalk_1.default.hex('#6B7280')('    ') + chalk_1.default.white(l));
+            continue;
+        }
+        if (l.startsWith('```')) {
+            console.log('  ' + chalk_1.default.hex('#312E81')('    ' + '·'.repeat(50)));
+            continue;
+        }
+        if (l.match(/^#\w/) && !l.startsWith('# ')) {
+            console.log('\n  ' + (l.match(/#\w+/g) ?? []).map((t) => chalk_1.default.hex('#7C3AED')(t)).join('  '));
+            continue;
+        }
+        if (l.length > 0) {
+            console.log('  ' + chalk_1.default.hex('#E2E8F0')('  ' + l));
+        }
+        else {
+            console.log();
+        }
+    }
+    console.log('\n' + chalk_1.default.hex('#312E81')('  ' + '─'.repeat(72)));
+    console.log(chalk_1.default.gray(`\n  Open in editor → `) + chalk_1.default.white(`code "${filePath}"`) + '\n');
+}

package/dist/lib/ui.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASCII = void 0;
+exports.showWelcome = showWelcome;
+// ─────────────────────────────────────────────────────────────────────────────
+// MnemoForge — Welcome Dashboard (shared UI)
+// ─────────────────────────────────────────────────────────────────────────────
+const chalk_1 = __importDefault(require("chalk"));
+const vault_js_1 = require("./vault.js");
+const V = chalk_1.default.hex('#8B5CF6');
+const V2 = chalk_1.default.hex('#A78BFA');
+const V3 = chalk_1.default.hex('#C4B5FD');
+const V4 = chalk_1.default.hex('#DDD6FE');
+const DIM = chalk_1.default.gray;
+exports.ASCII = [
+    V('███╗   ███╗███╗   ██╗███████╗███╗   ███╗ ██████╗ '),
+    V('████╗ ████║████╗  ██║██╔════╝████╗ ████║██╔═══██╗'),
+    V2('██╔████╔██║██╔██╗ ██║█████╗  ██╔████╔██║██║   ██║'),
+    V3('██║╚██╔╝██║██║╚██╗██║██╔══╝  ██║╚██╔╝██║██║   ██║'),
+    V4('██║ ╚═╝ ██║██║ ╚████║███████╗██║ ╚═╝ ██║╚██████╔╝'),
+    chalk_1.default.hex('#EDE9FE')('╚═╝     ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝     ╚═╝ ╚═════╝ '),
+].join('\n');
+function showWelcome() {
+    const config = (0, vault_js_1.loadVaultConfig)();
+    const w = '═'.repeat(52);
+    const pad = (s, n) => s + ' '.repeat(Math.max(0, n - s.length));
+    console.log();
+    console.log(exports.ASCII);
+    console.log();
+    console.log(V('  ╔' + w + '╗'));
+    console.log(V('  ║') + chalk_1.default.hex('#F5F3FF').bold('    M N E M O S Y N E   O S   —   N E U R A L   O S ') + V('  ║'));
+    console.log(V('  ║') + DIM('    MnemoForge CLI  v1.2.4  ·  XPACEGEMS LLC         ') + V('  ║'));
+    console.log(V('  ╠' + w + '╣'));
+    if (config) {
+        const profiles = config.registeredModels ?? [];
+        const activeChron = (0, vault_js_1.listChronicles)(config).length;
+        const activeStyle = config.defaultChronicleStyle ?? 'session';
+        const activeName = config.ide + ' / ' + config.provider;
+        console.log(V('  ║') + DIM('    ⚡ RESONANCE PROFILES                             ') + V('  ║'));
+        console.log(V('  ║') + '    ' + chalk_1.default.green('★') + ' ' + chalk_1.default.white(pad(activeName, 32)) + DIM(pad(activeStyle, 12)) + DIM(activeChron + ' chron.') + ' ' + chalk_1.default.green('[✓]') + ' ' + V('  ║'));
+        if (profiles.length > 0) {
+            console.log(V('  ║') + '    ' + DIM('─'.repeat(48)) + V('  ║'));
+            profiles.forEach((p, i) => {
+                const pName = p.ide + ' / ' + p.provider;
+                const pStyle = p.defaultChronicleStyle ?? 'session';
+                console.log(V('  ║') + '    ' + DIM('○') + ' ' + DIM(pad(pName, 32)) + DIM(pad(pStyle, 12)) + DIM('[' + (i + 1) + '] switch') + '  ' + V('  ║'));
+            });
+        }
+    }
+    else {
+        console.log(V('  ║') + chalk_1.default.yellow('    ⚠  No vault configured.') + ' Run: ' + chalk_1.default.white('mnemoforge chronicle init') + '          ' + V('  ║'));
+    }
+    console.log(V('  ╠' + w + '╣'));
+    console.log(V('  ║') + DIM('    COMMANDS                                          ') + V('  ║'));
+    console.log(V('  ║') + '    ' + V2('chronicle init    ') + DIM('─ add / reconfigure a profile     ') + V('  ║'));
+    console.log(V('  ║') + '    ' + V2('chronicle switch  ') + DIM('─ change active profile           ') + V('  ║'));
+    console.log(V('  ║') + '    ' + V2('chronicle commit  ') + DIM('─ write a new chronicle           ') + V('  ║'));
+    console.log(V('  ║') + '    ' + V2('chronicle list    ') + DIM('─ explore vault                   ') + V('  ║'));
+    console.log(V('  ║') + '    ' + V2('canvas            ') + DIM('─ scaffold a new project          ') + V('  ║'));
+    console.log(V('  ╠' + w + '╣'));
+    console.log(V('  ║') + DIM('    "Memory is the architecture of intelligence."     ') + V('  ║'));
+    console.log(V('  ╚' + w + '╝'));
+    console.log();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemosyne_os/forge",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "MnemoForge CLI — The AI Inception Engine for the Mnemosyne Neural OS ecosystem. Scaffold sovereign, AI-governed modules in one command.",
   "files": [
     "dist/",