ac-framework 1.8.0 → 1.9.1

package/bin/postinstall.js

@@ -29,6 +29,10 @@ console.log('      acfm memory search       Search memories');
 console.log('      acfm memory save         Save memory manually');
 console.log('      acfm memory stats        View memory statistics');
 console.log();
+console.log('    MCP (Model Context Protocol) Servers');
+console.log('      acfm memory install-mcps   Install MCP servers for AI assistants');
+console.log('      acfm memory uninstall-mcps Uninstall MCP servers from AI assistants');
+console.log();
 console.log('    Tip: Add --json to any command for machine-readable output.');
 console.log();
 
@@ -44,3 +48,12 @@ if (isWin) {
   console.log('    4. Restart your terminal');
   console.log();
 }
+
+// Auto-detect and install MCPs for supported assistants
+try {
+  const { detectAndInstallMCPs } = require('../src/services/mcp-installer');
+  detectAndInstallMCPs();
+} catch (error) {
+  // Silently fail if MCP installer is not available yet
+  // This allows the framework to work without MCP dependencies during early development
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-framework",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "Agentic Coding Framework - Multi-assistant configuration system with OpenSpec workflows",
   "main": "src/index.js",
   "exports": {
@@ -42,6 +42,7 @@
   },
   "homepage": "https://github.com/b4san/AC-framework#readme",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "better-sqlite3": "^11.8.1",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
@@ -49,7 +50,8 @@
     "inquirer": "^12.3.2",
     "js-yaml": "^4.1.1",
     "nanospinner": "^1.2.2",
-    "tar": "^7.5.7"
+    "tar": "^7.5.7",
+    "zod": "^4.3.6"
   },
   "type": "module",
   "engines": {

package/src/commands/init.js

@@ -14,6 +14,9 @@
 import chalk from 'chalk';
 import gradient from 'gradient-string';
 import inquirer from 'inquirer';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { DESCRIPTIONS, ASSISTANT_ICONS, BUNDLED } from '../config/constants.js';
 import { IDE_MD_MAP, AVAILABLE_MD_FILES, MD_DESCRIPTIONS } from '../config/ide-mapping.js';
 import { formatFolderName, sleep } from '../utils/helpers.js';
@@ -40,6 +43,102 @@ import {
 
 const acGradient = gradient(['#6C5CE7', '#00CEC9', '#0984E3']);
 
+// ── Persistent Memory Setup ───────────────────────────────────────
+
+/**
+ * First-time persistent memory setup.
+ * Only shown when ~/.acfm/memory.db does not yet exist.
+ *
+ * The memory store is named "NexusVault" — a unique, memorable name
+ * for the embedded knowledge base that persists context across sessions.
+ */
+async function setupPersistentMemory() {
+  const memoryDbPath = join(homedir(), '.acfm', 'memory.db');
+  const alreadyExists = existsSync(memoryDbPath);
+
+  console.log();
+  await animatedSeparator(60);
+  console.log();
+
+  const vaultBadge = chalk.hex('#2D3436').bgHex('#6C5CE7').bold(' NexusVault ');
+  console.log(`  ${vaultBadge} ${chalk.hex('#B2BEC3').bold('Persistent Memory System')}`);
+  console.log();
+  console.log(
+    chalk.hex('#636E72')(
+      '  NexusVault is an embedded SQLite knowledge base that lives at\n' +
+      `  ${chalk.hex('#DFE6E9')('~/.acfm/memory.db')} on your machine.\n\n` +
+      '  When enabled, your AI assistants will automatically:\n' +
+      `    ${chalk.hex('#00CEC9')('◆')} Remember architectural decisions, bugfixes & patterns\n` +
+      `    ${chalk.hex('#00CEC9')('◆')} Recall relevant context when you start a new task\n` +
+      `    ${chalk.hex('#00CEC9')('◆')} Connect to assistants via MCP (Model Context Protocol)\n\n` +
+      '  Your data never leaves your machine — fully offline & private.'
+    )
+  );
+  console.log();
+
+  const { enableMemory } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'enableMemory',
+    message: chalk.hex('#B2BEC3')('Enable NexusVault persistent memory?'),
+    default: true,
+  }]);
+
+  if (!enableMemory) {
+    console.log();
+    console.log(chalk.hex('#636E72')('  Skipped. You can enable it later with: acfm memory init'));
+    console.log();
+    return;
+  }
+
+  console.log();
+  console.log(chalk.hex('#B2BEC3')(alreadyExists ? '  Reconnecting NexusVault...' : '  Initializing NexusVault...'));
+
+  // Init the SQLite database (idempotent — skips if already exists)
+  const { initDatabase, isDatabaseInitialized } = await import('../memory/database.js');
+  if (!isDatabaseInitialized()) {
+    initDatabase();
+  }
+  console.log(
+    chalk.hex('#00CEC9')('  ◆ ') +
+    chalk.hex('#DFE6E9')(
+      alreadyExists
+        ? 'NexusVault database found at ~/.acfm/memory.db'
+        : 'NexusVault database created at ~/.acfm/memory.db'
+    )
+  );
+
+  // Install MCP server into detected assistants
+  console.log();
+  console.log(chalk.hex('#B2BEC3')('  Connecting NexusVault to your AI assistants via MCP...'));
+  console.log();
+
+  const { detectAndInstallMCPs, ASSISTANTS, isAssistantInstalled } = await import('../services/mcp-installer.js');
+  const { installed, success } = detectAndInstallMCPs();
+
+  if (installed === 0) {
+    console.log(chalk.hex('#636E72')('  No AI assistants detected yet.'));
+    console.log(chalk.hex('#636E72')('  Run ' + chalk.hex('#DFE6E9')('acfm memory install-mcps') + ' after installing an assistant.'));
+  } else {
+    for (const assistant of ASSISTANTS) {
+      if (isAssistantInstalled(assistant)) {
+        console.log(
+          chalk.hex('#00CEC9')('  ◆ ') +
+          chalk.hex('#DFE6E9').bold(assistant.name) +
+          chalk.hex('#636E72')(` · MCP config → ${assistant.configPath}`)
+        );
+      }
+    }
+    console.log();
+    const successBadge = chalk.hex('#2D3436').bgHex('#00CEC9').bold(` ${success}/${installed} `);
+    console.log(`  ${successBadge} ${chalk.hex('#B2BEC3')('assistants connected to NexusVault')}`);
+  }
+
+  console.log();
+  console.log(chalk.hex('#6C5CE7').bold('  NexusVault is active.'));
+  console.log(chalk.hex('#636E72')('  Use acfm memory --help to manage your knowledge base.'));
+  console.log();
+}
+
 // ── Helpers ──────────────────────────────────────────────────────
 
 function buildChoices(folders) {
@@ -187,7 +286,7 @@ export async function initCommand(options = {}) {
 
   // Dynamic step counting: +1 step when downloading from GitHub
   const stepOffset = useLatest ? 1 : 0;
-  const totalSteps = 4 + stepOffset;
+  const totalSteps = 5 + stepOffset;
 
   // Framework source: bundled by default, overridden by --latest
   let frameworkPath = FRAMEWORK_PATH;
@@ -423,6 +522,7 @@ export async function initCommand(options = {}) {
     // ── Final result ──────────────────────────────────────────────
     if (errors.length === 0) {
       await celebrateSuccess(installed, targetDir);
+      await setupPersistentMemory();
     } else {
       await showFailureSummary(installed, errors);
     }

package/src/commands/memory.js

@@ -706,61 +706,122 @@ export function memoryCommand() {
 
   // ─── acfm memory session ───────────────────────────────────────────────────
   const sessionCmd = new Command('session')
-    .description('Gestión de sesiones de memoria');
+  .description('Gestión de sesiones de memoria');
   
   sessionCmd
-    .command('start')
-    .description('Inicia nueva sesión')
-    .option('-p, --project <path>', 'Proyecto', process.cwd())
-    .option('-c, --change <name>', 'Change')
-    .option('--json', 'Output as JSON')
-    .action((opts) => {
-      try {
-        ensureInitialized();
-        
-        const sessionId = startSession(opts.project, opts.change);
-        
-        output({ sessionId, project: opts.project, change: opts.change }, opts.json);
-        
-        if (!opts.json) {
-          console.log(chalk.green('✓ Session started'));
-          console.log(chalk.dim(`  ID: ${sessionId}`));
-        }
-      } catch (err) {
-        output({ error: err.message }, opts.json);
-        if (!opts.json) console.error(chalk.red(`Error: ${err.message}`));
-        process.exit(1);
+  .command('start')
+  .description('Inicia nueva sesión')
+  .option('-p, --project <path>', 'Proyecto', process.cwd())
+  .option('-c, --change <name>', 'Change')
+  .option('--json', 'Output as JSON')
+  .action((opts) => {
+    try {
+      ensureInitialized();
+      
+      const sessionId = startSession(opts.project, opts.change);
+      
+      output({ sessionId, project: opts.project, change: opts.change }, opts.json);
+      
+      if (!opts.json) {
+        console.log(chalk.green('✓ Session started'));
+        console.log(chalk.dim(`  ID: ${sessionId}`));
       }
-    });
+    } catch (err) {
+      output({ error: err.message }, opts.json);
+      if (!opts.json) console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
   
   sessionCmd
-    .command('end <sessionId>')
-    .description('Finaliza sesión')
-    .option('-s, --summary <text>', 'Resumen de la sesión')
-    .option('--json', 'Output as JSON')
-    .action((sessionId, opts) => {
-      try {
-        ensureInitialized();
-        
-        endSession(sessionId, opts.summary);
-        
-        output({ ended: true, sessionId }, opts.json);
-        
-        if (!opts.json) {
-          console.log(chalk.green('✓ Session ended'));
-          if (opts.summary) {
-            console.log(chalk.dim('Summary saved as memory'));
-          }
+  .command('end <sessionId>')
+  .description('Finaliza sesión')
+  .option('-s, --summary <text>', 'Resumen de la sesión')
+  .option('--json', 'Output as JSON')
+  .action((sessionId, opts) => {
+    try {
+      ensureInitialized();
+      
+      endSession(sessionId, opts.summary);
+      
+      output({ ended: true, sessionId }, opts.json);
+      
+      if (!opts.json) {
+        console.log(chalk.green('✓ Session ended'));
+        if (opts.summary) {
+          console.log(chalk.dim('Summary saved as memory'));
         }
-      } catch (err) {
-        output({ error: err.message }, opts.json);
-        if (!opts.json) console.error(chalk.red(`Error: ${err.message}`));
-        process.exit(1);
       }
-    });
+    } catch (err) {
+      output({ error: err.message }, opts.json);
+      if (!opts.json) console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
   
   memory.addCommand(sessionCmd);
-
+  
+  // ─── acfm memory install-mcps ───────────────────────────────────────────────
+  memory
+  .command('install-mcps')
+  .description('Instala servidores MCP para asistentes de IA detectados')
+  .option('--all', 'Instalar para todos (sin requerir detección)', false)
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    try {
+      const { detectAndInstallMCPs, installAllMCPs, ASSISTANTS, isAssistantInstalled } = await import('../services/mcp-installer.js');
+      
+      const result = opts.all ? installAllMCPs() : detectAndInstallMCPs();
+      
+      output({ total: result.total ?? result.installed, success: result.success }, opts.json);
+      
+      if (!opts.json) {
+        if (!opts.all) {
+          if (result.installed === 0) {
+            console.log(chalk.yellow('No AI assistants detected.'));
+            console.log(chalk.dim('Use --all to install for all supported assistants.'));
+            return;
+          }
+          for (const assistant of ASSISTANTS) {
+            if (isAssistantInstalled(assistant)) {
+              console.log(
+                chalk.cyan('◆ ') + chalk.bold(assistant.name) +
+                chalk.dim(` → ${assistant.configPath}`)
+              );
+            }
+          }
+        }
+        console.log(chalk.green(`\n✓ MCP servers installed (${result.success}/${result.total ?? result.installed})`));
+      }
+    } catch (err) {
+      output({ error: err.message }, opts.json);
+      if (!opts.json) console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+  
+  // ─── acfm memory uninstall-mcps ───────────────────────────────────────────
+  memory
+  .command('uninstall-mcps')
+  .description('Desinstala servidores MCP de asistentes de IA')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    try {
+      const { uninstallAllMCPs } = await import('../services/mcp-installer.js');
+      const result = uninstallAllMCPs();
+      
+      output({ success: result.success }, opts.json);
+      
+      if (!opts.json) {
+        console.log(chalk.green(`✓ MCP servers uninstalled (${result.success})`));
+      }
+    } catch (err) {
+      output({ error: err.message }, opts.json);
+      if (!opts.json) console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+  
   return memory;
 }