@mnemosyne_os/forge 1.0.0 → 1.2.2

package/dist/lib/vault.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_RESONANCE_DIR = exports.DEFAULT_VAULT = void 0;
+exports.resolveChronicleDir = resolveChronicleDir;
+exports.loadVaultConfig = loadVaultConfig;
+exports.saveVaultConfig = saveVaultConfig;
+exports.listChronicles = listChronicles;
+exports.loadCustomModels = loadCustomModels;
+exports.saveCustomModels = saveCustomModels;
+exports.importFromModelCard = importFromModelCard;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+// ─────────────────────────────────────────────
+// Vault — MnemoVault path resolution
+// Structure: MnemoVault/<Workspace>/<ResonanceProject>/<IDE>/<Provider>/
+//
+// Workspace        = the ecosystem / org (e.g. 'Mnemosyne-OS')
+// ResonanceProject = a feature / component (e.g. 'CLI', 'Dashboard')
+// IDE              = the AI assistant (e.g. 'Antigravity', 'Cursor')
+// Provider         = the model company (e.g. 'Anthropic', 'GoogleDeepMind')
+// ─────────────────────────────────────────────
+exports.DEFAULT_VAULT = path_1.default.join(os_1.default.homedir(), 'Documents', 'MnemoVault');
+exports.CLI_RESONANCE_DIR = '.cli_resonance';
+/**
+ * Resolve the chronicle output directory.
+ * New structure: <vault>/<Workspace>/<ResonanceProject>/<IDE>/<Provider>/
+ * Legacy fallback (no workspace/project): <vault>/.cli_resonance/<IDE>/<Provider>/
+ */
+function resolveChronicleDir(config) {
+    let dir;
+    if (config.workspace && config.resonanceProject) {
+        // Full Resonance Project structure
+        dir = path_1.default.join(config.vaultPath, config.workspace, config.resonanceProject, config.ide, config.provider);
+    }
+    else {
+        // Legacy: .cli_resonance/IDE/Provider
+        dir = path_1.default.join(config.vaultPath, exports.CLI_RESONANCE_DIR, config.ide, config.provider);
+    }
+    fs_1.default.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Load config from .mnemo-config.json in the .cli_resonance/ root.
+ * Returns null if not initialized.
+ */
+function loadVaultConfig() {
+    const configPath = path_1.default.join(exports.DEFAULT_VAULT, exports.CLI_RESONANCE_DIR, '.mnemo-config.json');
+    if (!fs_1.default.existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save config to .mnemo-config.json.
+ */
+function saveVaultConfig(config) {
+    const dir = path_1.default.join(config.vaultPath, exports.CLI_RESONANCE_DIR);
+    fs_1.default.mkdirSync(dir, { recursive: true });
+    const configPath = path_1.default.join(dir, '.mnemo-config.json');
+    fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf8');
+}
+/**
+ * List all chronicles for the current IDE/Provider.
+ */
+function listChronicles(config) {
+    const dir = resolveChronicleDir(config);
+    if (!fs_1.default.existsSync(dir))
+        return [];
+    return fs_1.default.readdirSync(dir)
+        .filter(f => f.endsWith('.md'))
+        .sort()
+        .reverse(); // most recent first
+}
+const DEFAULT_MODELS_PATH = (vaultPath) => path_1.default.join(vaultPath, exports.CLI_RESONANCE_DIR, 'models.json');
+function loadCustomModels(vaultPath = exports.DEFAULT_VAULT) {
+    const p = DEFAULT_MODELS_PATH(vaultPath);
+    if (!fs_1.default.existsSync(p))
+        return [];
+    try {
+        return JSON.parse(fs_1.default.readFileSync(p, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+}
+function saveCustomModels(models, vaultPath = exports.DEFAULT_VAULT) {
+    const dir = path_1.default.join(vaultPath, exports.CLI_RESONANCE_DIR);
+    fs_1.default.mkdirSync(dir, { recursive: true });
+    fs_1.default.writeFileSync(DEFAULT_MODELS_PATH(vaultPath), JSON.stringify(models, null, 2), 'utf8');
+}
+/**
+ * Import a model from a UniversalModelCard-compatible JSON.
+ * Extracts: model_info.model_id, model_info.provider, model_info.name
+ */
+function importFromModelCard(cardPath) {
+    try {
+        const raw = JSON.parse(fs_1.default.readFileSync(cardPath, 'utf8'));
+        // UniversalModelCard v1.0.0 — extract key fields
+        const info = raw?.model_info ?? raw;
+        const modelId = info?.model_id ?? info?.id ?? null;
+        const provider = info?.provider ?? info?.organization ?? info?.developer ?? null;
+        const displayName = info?.name ?? info?.display_name ?? modelId;
+        if (!modelId || !provider)
+            return null;
+        return { modelId, provider, displayName };
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "@mnemosyne_os/forge",
-  "version": "1.0.0",
+  "version": "1.2.2",
   "description": "MnemoForge CLI — The AI Inception Engine for the Mnemosyne Neural OS ecosystem. Scaffold sovereign, AI-governed modules in one command.",
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
   "main": "dist/cli.js",
   "bin": {
     "mnemoforge": "./dist/cli.js"
@@ -12,6 +18,10 @@
     "dev": "tsc -w",
     "prepublishOnly": "npm run build"
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "keywords": [
     "mnemosyne",
     "cli",
@@ -25,7 +35,9 @@
     "cursor",
     "sovereign-ai",
     "code-generator",
-    "boilerplate"
+    "boilerplate",
+    "chronicle",
+    "neural-coding"
   ],
   "author": {
     "name": "Tony Trochet",

package/dist/templates/index.template.js

@@ -1,36 +0,0 @@
-"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/src/cli.ts

@@ -1,121 +0,0 @@
-#!/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

@@ -1,55 +0,0 @@
-# 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

@@ -1,60 +0,0 @@
-# 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

@@ -1,34 +0,0 @@
-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

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