ac-framework 1.7.0 → 1.9.0

package/framework/copilot-instructions.md

@@ -42,6 +42,45 @@ If you attempt to proceed without completing a required step, you MUST STOP and
 | Skill | Description | Primary Use | Required Before |
 |-------|-------------|-------------|-----------------|
 | `acfm-spec-workflow` | **START HERE - MANDATORY** - Understand the spec-driven workflow, directory structure (.acfm/ vs openspec/), and CLI commands. Essential before using any OpenSpec skills. | Foundation | **ANYTHING ELSE** |
+| `acfm-memory` | **AUTONOMOUS MEMORY SYSTEM** - Persistent learning system that automatically saves important decisions, patterns, bugfixes. Use to recall context from previous changes and maintain knowledge across sessions. | Knowledge persistence | **AFTER ANY SIGNIFICANT WORK** |
+
+### Memory System (Automatic)
+
+The AC Framework includes an **autonomous memory system** that learns from your work:
+
+**What gets saved automatically:**
+- Architectural decisions from proposals/designs
+- Bugfix patterns and solutions
+- Performance optimizations
+- Refactoring techniques
+- Security fixes
+- API patterns and conventions
+
+**How to use memory:**
+```bash
+# Recall relevant context before starting work
+acfm memory recall "implementing authentication"
+
+# Search for specific patterns
+acfm memory search "JWT token refresh"
+
+# Get full context for current project
+acfm memory recall
+
+# View statistics
+acfm memory stats
+```
+
+**When the agent saves memory (automatic):**
+1. After completing proposal.md (saves architectural decisions)
+2. After fixing bugs (solutions are stored)
+3. After refactoring (techniques are recorded)
+4. After optimizations (performance insights)
+5. After any significant decision with confidence > 0.7
+
+**The agent will inform you:** "💾 Memory saved: [brief description]" when auto-saving occurs.
+
+**Privacy:** Content between `<private>...</private>` tags is automatically redacted before saving.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-framework",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Agentic Coding Framework - Multi-assistant configuration system with OpenSpec workflows",
   "main": "src/index.js",
   "exports": {
@@ -42,13 +42,16 @@
   },
   "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",
     "gradient-string": "^3.0.0",
     "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/cli.js

@@ -7,6 +7,7 @@ import { fileURLToPath } from 'node:url';
 import { initCommand } from './commands/init.js';
 import { updateCommand } from './commands/update.js';
 import { specCommand } from './commands/spec.js';
+import { memoryCommand } from './commands/memory.js';
 import { showBanner } from './ui/banner.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -38,5 +39,6 @@ program
   });
 
 program.addCommand(specCommand());
+program.addCommand(memoryCommand());
 
 program.parse();

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,100 @@ 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');
+
+  // Only ask on first run
+  if (existsSync(memoryDbPath)) return;
+
+  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')('  Initializing NexusVault...'));
+
+  // Init the SQLite database
+  const { initDatabase, isDatabaseInitialized } = await import('../memory/database.js');
+  if (!isDatabaseInitialized()) {
+    initDatabase();
+  }
+  console.log(
+    chalk.hex('#00CEC9')('  ◆ ') +
+    chalk.hex('#DFE6E9')('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) {
@@ -423,6 +520,7 @@ export async function initCommand(options = {}) {
     // ── Final result ──────────────────────────────────────────────
     if (errors.length === 0) {
       await celebrateSuccess(installed, targetDir);
+      await setupPersistentMemory();
     } else {
       await showFailureSummary(installed, errors);
     }