@alex900530/claude-persistent-memory 1.0.0

package/bin/setup.js

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+/**
+ * Setup script for claude-persistent-memory
+ *
+ * Two modes:
+ *   --postinstall  Non-interactive (run by npm postinstall)
+ *   (no flag)      Interactive (run by npx claude-persistent-memory)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+// ── Path constants ──────────────────────────────────────────────────────────
+const isPostinstall = process.argv.includes('--postinstall');
+const PROJECT_ROOT = process.env.INIT_CWD || process.cwd();
+const PKG_DIR = path.resolve(__dirname, '..');
+const NODE_BIN = process.execPath;
+
+const CONFIG_FILE = path.join(PROJECT_ROOT, '.claude-memory.config.js');
+const MCP_FILE = path.join(PROJECT_ROOT, '.mcp.json');
+const CLAUDE_DIR = path.join(PROJECT_ROOT, '.claude');
+const SETTINGS_FILE = path.join(CLAUDE_DIR, 'settings.json');
+const DATA_DIR = path.join(PROJECT_ROOT, '.claude-memory');
+const GITIGNORE_FILE = path.join(PROJECT_ROOT, '.gitignore');
+
+const PREFIX = '\x1b[36m[claude-memory]\x1b[0m';
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function log(msg) { console.log(`${PREFIX} ${msg}`); }
+function warn(msg) { console.log(`${PREFIX} \x1b[33m${msg}\x1b[0m`); }
+function ok(msg) { console.log(`${PREFIX} \x1b[32m${msg}\x1b[0m`); }
+
+function readJSON(filePath) {
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return null; }
+}
+
+function writeJSON(filePath, data) {
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+
+function ask(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => rl.question(`${PREFIX} ${question}`, ans => { rl.close(); resolve(ans.trim()); }));
+}
+
+// ── [1/5] Config ────────────────────────────────────────────────────────────
+async function setupConfig() {
+  log('[1/5] Setting up .claude-memory.config.js ...');
+
+  if (fs.existsSync(CONFIG_FILE)) {
+    if (isPostinstall) {
+      log('  Config already exists, skipping.');
+      return;
+    }
+    const ans = await ask('  .claude-memory.config.js already exists. Overwrite? (y/N) ');
+    if (ans.toLowerCase() !== 'y') { log('  Skipped.'); return; }
+  }
+
+  let endpoint = process.env.AZURE_OPENAI_ENDPOINT || '';
+  let apiKey = process.env.AZURE_OPENAI_KEY || '';
+  let deployment = process.env.AZURE_OPENAI_DEPLOYMENT || 'gpt-4.1';
+
+  if (!endpoint && !isPostinstall) {
+    log('  Azure OpenAI credentials not found in environment.');
+    log('  You can set them now or leave blank to configure later.');
+    endpoint = await ask('  AZURE_OPENAI_ENDPOINT: ');
+    apiKey = await ask('  AZURE_OPENAI_KEY: ');
+    const dep = await ask('  AZURE_OPENAI_DEPLOYMENT (default: gpt-4.1): ');
+    if (dep) deployment = dep;
+  }
+
+  // Escape backslashes and quotes for safe embedding in JS string
+  const esc = s => s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+
+  const content = `// Auto-generated by claude-persistent-memory setup
+const base = require('${esc(path.join(PKG_DIR, 'config.default').replace(/\\/g, '/'))}');
+const path = require('path');
+
+module.exports = {
+  ...base,
+  dataDir: path.resolve(__dirname, '.claude-memory'),
+  logDir: path.resolve(__dirname, '.claude-memory', 'logs'),
+  azure: {
+    ...base.azure,
+    endpoint: process.env.AZURE_OPENAI_ENDPOINT || '${esc(endpoint)}',
+    apiKey: process.env.AZURE_OPENAI_KEY || '${esc(apiKey)}',
+    deployment: process.env.AZURE_OPENAI_DEPLOYMENT || '${esc(deployment)}',
+  },
+};
+`;
+  fs.writeFileSync(CONFIG_FILE, content);
+
+  if (!endpoint) {
+    warn('  Config created with empty Azure credentials.');
+    warn('  Run "npx claude-persistent-memory" to configure, or set env vars:');
+    warn('    export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com"');
+    warn('    export AZURE_OPENAI_KEY="your-api-key"');
+  } else {
+    ok('  Config created.');
+  }
+}
+
+// ── [2/5] MCP ───────────────────────────────────────────────────────────────
+function setupMCP() {
+  log('[2/5] Setting up .mcp.json ...');
+
+  const existing = readJSON(MCP_FILE) || {};
+  if (!existing.mcpServers) existing.mcpServers = {};
+
+  existing.mcpServers.memory = {
+    type: 'stdio',
+    command: NODE_BIN,
+    args: [path.join(PKG_DIR, 'services', 'memory-mcp-server.js')],
+    env: { MEMORY_CONFIG: CONFIG_FILE },
+  };
+
+  writeJSON(MCP_FILE, existing);
+  ok('  .mcp.json configured.');
+}
+
+// ── [3/5] Hooks ─────────────────────────────────────────────────────────────
+function setupHooks() {
+  log('[3/5] Setting up .claude/settings.json hooks ...');
+
+  if (!fs.existsSync(CLAUDE_DIR)) fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+
+  const existing = readJSON(SETTINGS_FILE) || {};
+  if (!existing.hooks) existing.hooks = {};
+
+  const envPrefix = `MEMORY_CONFIG=${CONFIG_FILE}`;
+
+  const hookDefs = [
+    { event: 'UserPromptSubmit', file: 'user-prompt-hook.js' },
+    { event: 'PreToolUse', file: 'pre-tool-memory-hook.js' },
+    { event: 'PostToolUse', file: 'post-tool-memory-hook.js' },
+    { event: 'PreCompact', file: 'pre-compact-hook.js' },
+    { event: 'SessionEnd', file: 'session-end-hook.js' },
+  ];
+
+  for (const { event, file } of hookDefs) {
+    const command = `${envPrefix} ${NODE_BIN} ${path.join(PKG_DIR, 'hooks', file)}`;
+
+    if (!existing.hooks[event]) existing.hooks[event] = [];
+    const hooks = existing.hooks[event];
+
+    // Find existing hook by script filename
+    const idx = hooks.findIndex(h => h.command && h.command.includes(file));
+    const entry = { type: 'command', command };
+
+    if (idx >= 0) {
+      hooks[idx] = entry;
+    } else {
+      hooks.push(entry);
+    }
+  }
+
+  writeJSON(SETTINGS_FILE, existing);
+  ok('  Hooks configured (5 hooks).');
+}
+
+// ── [4/5] .gitignore ────────────────────────────────────────────────────────
+function setupGitignore() {
+  log('[4/5] Updating .gitignore ...');
+
+  const entries = ['.claude-memory/', '.claude-memory.config.js', '.claude/', '.mcp.json'];
+  let content = '';
+  try { content = fs.readFileSync(GITIGNORE_FILE, 'utf8'); } catch {}
+
+  const added = [];
+  for (const entry of entries) {
+    // Check if already present (exact line match)
+    if (!content.split('\n').some(line => line.trim() === entry)) {
+      added.push(entry);
+    }
+  }
+
+  if (added.length > 0) {
+    const suffix = content.endsWith('\n') || content === '' ? '' : '\n';
+    const block = `${suffix}# claude-persistent-memory\n${added.join('\n')}\n`;
+    fs.appendFileSync(GITIGNORE_FILE, block);
+    ok(`  Added ${added.length} entries.`);
+  } else {
+    log('  Already up to date.');
+  }
+}
+
+// ── [5/5] Services ──────────────────────────────────────────────────────────
+function setupServices() {
+  log('[5/5] Setting up background services ...');
+
+  // Check if Azure credentials are configured
+  let hasCredentials = false;
+  try {
+    const cfg = require(CONFIG_FILE);
+    hasCredentials = !!(cfg.azure && cfg.azure.endpoint && cfg.azure.apiKey);
+  } catch {}
+
+  if (!hasCredentials && isPostinstall) {
+    warn('  Skipping service startup (no Azure credentials).');
+    warn('  Run "npx claude-persistent-memory" after configuring credentials.');
+    printSummary();
+    return;
+  }
+
+  // Ensure data directory exists
+  if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
+  const logsDir = path.join(DATA_DIR, 'logs');
+  if (!fs.existsSync(logsDir)) fs.mkdirSync(logsDir, { recursive: true });
+
+  const platform = process.platform;
+
+  if (platform === 'darwin') {
+    setupLaunchd();
+  } else if (platform === 'linux') {
+    setupSystemd();
+  } else {
+    warn('  Unsupported platform for automatic service setup.');
+    log('  Start services manually:');
+    log(`    MEMORY_CONFIG=${CONFIG_FILE} ${NODE_BIN} ${path.join(PKG_DIR, 'services', 'embedding-server.js')}`);
+    log(`    MEMORY_CONFIG=${CONFIG_FILE} ${NODE_BIN} ${path.join(PKG_DIR, 'services', 'llm-server.js')}`);
+    printSummary();
+    return;
+  }
+
+  // Wait and verify
+  verifyServices();
+}
+
+function setupLaunchd() {
+  const agentsDir = path.join(process.env.HOME, 'Library', 'LaunchAgents');
+  if (!fs.existsSync(agentsDir)) fs.mkdirSync(agentsDir, { recursive: true });
+
+  const services = [
+    { label: 'com.claude-memory.embedding-server', script: 'embedding-server.js' },
+    { label: 'com.claude-memory.llm-server', script: 'llm-server.js' },
+  ];
+
+  for (const { label, script } of services) {
+    const plistPath = path.join(agentsDir, `${label}.plist`);
+    const logPath = path.join(DATA_DIR, 'logs', `${script.replace('.js', '')}.log`);
+
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${label}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${NODE_BIN}</string>
+    <string>${path.join(PKG_DIR, 'services', script)}</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${PROJECT_ROOT}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>MEMORY_CONFIG</key>
+    <string>${CONFIG_FILE}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>ThrottleInterval</key>
+  <integer>10</integer>
+  <key>StandardOutPath</key>
+  <string>${logPath}</string>
+  <key>StandardErrorPath</key>
+  <string>${logPath}</string>
+</dict>
+</plist>
+`;
+    fs.writeFileSync(plistPath, plist);
+
+    // Unload if already loaded, then load
+    try {
+      require('child_process').execSync(`launchctl unload ${plistPath} 2>/dev/null`, { stdio: 'ignore' });
+    } catch {}
+    try {
+      require('child_process').execSync(`launchctl load ${plistPath}`, { stdio: 'pipe' });
+      ok(`  Loaded ${label}`);
+    } catch (e) {
+      warn(`  Failed to load ${label}: ${e.message}`);
+    }
+  }
+}
+
+function setupSystemd() {
+  const unitDir = path.join(process.env.HOME, '.config', 'systemd', 'user');
+  if (!fs.existsSync(unitDir)) fs.mkdirSync(unitDir, { recursive: true });
+
+  const services = [
+    { name: 'claude-memory-embedding', script: 'embedding-server.js' },
+    { name: 'claude-memory-llm', script: 'llm-server.js' },
+  ];
+
+  for (const { name, script } of services) {
+    const unitPath = path.join(unitDir, `${name}.service`);
+    const unit = `[Unit]
+Description=Claude Memory ${script}
+
+[Service]
+ExecStart=${NODE_BIN} ${path.join(PKG_DIR, 'services', script)}
+WorkingDirectory=${PROJECT_ROOT}
+Environment=MEMORY_CONFIG=${CONFIG_FILE}
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+`;
+    fs.writeFileSync(unitPath, unit);
+    try {
+      require('child_process').execSync(`systemctl --user daemon-reload`, { stdio: 'pipe' });
+      require('child_process').execSync(`systemctl --user enable --now ${name}`, { stdio: 'pipe' });
+      ok(`  Enabled ${name}`);
+    } catch (e) {
+      warn(`  Failed to enable ${name}: ${e.message}`);
+    }
+  }
+}
+
+function verifyServices() {
+  log('  Waiting for services to start ...');
+  const net = require('net');
+
+  const ports = [23811, 23812];
+  const names = ['embedding-server', 'llm-server'];
+  let attempts = 0;
+  const maxAttempts = 6; // 6 * 500ms = 3s
+
+  function check() {
+    attempts++;
+    let allOk = true;
+    let checked = 0;
+
+    ports.forEach((port, i) => {
+      const sock = new net.Socket();
+      sock.setTimeout(400);
+      sock.on('connect', () => {
+        sock.destroy();
+        checked++;
+        if (checked === ports.length && allOk) {
+          ok('  All services running.');
+          printSummary();
+        }
+      });
+      sock.on('error', () => {
+        sock.destroy();
+        allOk = false;
+        checked++;
+        if (checked === ports.length) {
+          if (attempts < maxAttempts) {
+            setTimeout(check, 500);
+          } else {
+            warn(`  Some services not responding. Check logs in .claude-memory/logs/`);
+            printSummary();
+          }
+        }
+      });
+      sock.on('timeout', () => {
+        sock.destroy();
+        allOk = false;
+        checked++;
+        if (checked === ports.length) {
+          if (attempts < maxAttempts) {
+            setTimeout(check, 500);
+          } else {
+            warn(`  Some services not responding. Check logs in .claude-memory/logs/`);
+            printSummary();
+          }
+        }
+      });
+      sock.connect(port, '127.0.0.1');
+    });
+  }
+
+  check();
+}
+
+// ── Summary ─────────────────────────────────────────────────────────────────
+function printSummary() {
+  console.log('');
+  ok('╔══════════════════════════════════════════════════╗');
+  ok('║   claude-persistent-memory installed!            ║');
+  ok('╚══════════════════════════════════════════════════╝');
+  console.log('');
+  log(`Config:   ${CONFIG_FILE}`);
+  log(`Data:     ${DATA_DIR}`);
+  log(`MCP:      ${MCP_FILE}`);
+  log(`Hooks:    ${SETTINGS_FILE}`);
+  console.log('');
+  log('Open Claude Code in this project directory to start using memory.');
+  console.log('');
+}
+
+// ── Main ────────────────────────────────────────────────────────────────────
+async function main() {
+  console.log('');
+  log(`Setting up claude-persistent-memory in:`);
+  log(`  ${PROJECT_ROOT}`);
+  console.log('');
+
+  await setupConfig();
+  setupMCP();
+  setupHooks();
+  setupGitignore();
+  setupServices();
+}
+
+main().catch(err => {
+  console.error(`${PREFIX} Error: ${err.message}`);
+  process.exit(1);
+});

package/bin/uninstall.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * Uninstall script for claude-persistent-memory
+ * Removes services, MCP config, and hooks. Does NOT delete .claude-memory/ data.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_ROOT = process.env.INIT_CWD || process.cwd();
+const CONFIG_FILE = path.join(PROJECT_ROOT, '.claude-memory.config.js');
+const MCP_FILE = path.join(PROJECT_ROOT, '.mcp.json');
+const SETTINGS_FILE = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+
+const PREFIX = '\x1b[36m[claude-memory]\x1b[0m';
+function log(msg) { console.log(`${PREFIX} ${msg}`); }
+function ok(msg) { console.log(`${PREFIX} \x1b[32m${msg}\x1b[0m`); }
+function warn(msg) { console.log(`${PREFIX} \x1b[33m${msg}\x1b[0m`); }
+
+// ── [1/4] Remove launchd / systemd services ─────────────────────────────────
+function removeServices() {
+  log('[1/4] Removing background services ...');
+
+  if (process.platform === 'darwin') {
+    const agentsDir = path.join(process.env.HOME, 'Library', 'LaunchAgents');
+    const labels = ['com.claude-memory.embedding-server', 'com.claude-memory.llm-server'];
+    for (const label of labels) {
+      const plist = path.join(agentsDir, `${label}.plist`);
+      if (fs.existsSync(plist)) {
+        try { require('child_process').execSync(`launchctl unload ${plist}`, { stdio: 'ignore' }); } catch {}
+        fs.unlinkSync(plist);
+        ok(`  Removed ${label}`);
+      }
+    }
+  } else if (process.platform === 'linux') {
+    const names = ['claude-memory-embedding', 'claude-memory-llm'];
+    const unitDir = path.join(process.env.HOME, '.config', 'systemd', 'user');
+    for (const name of names) {
+      try { require('child_process').execSync(`systemctl --user disable --now ${name}`, { stdio: 'ignore' }); } catch {}
+      const unit = path.join(unitDir, `${name}.service`);
+      if (fs.existsSync(unit)) { fs.unlinkSync(unit); ok(`  Removed ${name}`); }
+    }
+    try { require('child_process').execSync(`systemctl --user daemon-reload`, { stdio: 'ignore' }); } catch {}
+  }
+}
+
+// ── [2/4] Remove MCP entry ──────────────────────────────────────────────────
+function removeMCP() {
+  log('[2/4] Cleaning .mcp.json ...');
+  try {
+    const data = JSON.parse(fs.readFileSync(MCP_FILE, 'utf8'));
+    if (data.mcpServers && data.mcpServers.memory) {
+      delete data.mcpServers.memory;
+      if (Object.keys(data.mcpServers).length === 0) {
+        fs.unlinkSync(MCP_FILE);
+        ok('  Removed .mcp.json (was empty).');
+      } else {
+        fs.writeFileSync(MCP_FILE, JSON.stringify(data, null, 2) + '\n');
+        ok('  Removed memory entry from .mcp.json.');
+      }
+    }
+  } catch {
+    log('  .mcp.json not found, skipping.');
+  }
+}
+
+// ── [3/4] Remove hooks ──────────────────────────────────────────────────────
+function removeHooks() {
+  log('[3/4] Cleaning .claude/settings.json hooks ...');
+  try {
+    const data = JSON.parse(fs.readFileSync(SETTINGS_FILE, 'utf8'));
+    if (!data.hooks) { log('  No hooks found.'); return; }
+
+    const hookFiles = [
+      'user-prompt-hook.js', 'pre-tool-memory-hook.js', 'post-tool-memory-hook.js',
+      'pre-compact-hook.js', 'session-end-hook.js',
+    ];
+
+    let removed = 0;
+    for (const event of Object.keys(data.hooks)) {
+      const before = data.hooks[event].length;
+      data.hooks[event] = data.hooks[event].filter(
+        h => !hookFiles.some(f => h.command && h.command.includes(f))
+      );
+      removed += before - data.hooks[event].length;
+      if (data.hooks[event].length === 0) delete data.hooks[event];
+    }
+    if (Object.keys(data.hooks).length === 0) delete data.hooks;
+
+    fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + '\n');
+    ok(`  Removed ${removed} hooks.`);
+  } catch {
+    log('  settings.json not found, skipping.');
+  }
+}
+
+// ── [4/4] Remove config ─────────────────────────────────────────────────────
+function removeConfig() {
+  log('[4/4] Removing config ...');
+  if (fs.existsSync(CONFIG_FILE)) {
+    fs.unlinkSync(CONFIG_FILE);
+    ok('  Removed .claude-memory.config.js');
+  }
+}
+
+// ── Main ────────────────────────────────────────────────────────────────────
+console.log('');
+log('Uninstalling claude-persistent-memory ...');
+console.log('');
+
+removeServices();
+removeMCP();
+removeHooks();
+removeConfig();
+
+console.log('');
+warn('Data directory .claude-memory/ was NOT deleted.');
+warn('Remove it manually if you no longer need the memory database:');
+warn(`  rm -rf ${path.join(PROJECT_ROOT, '.claude-memory')}`);
+console.log('');
+ok('Uninstall complete.');
+console.log('');

package/config.default.js

@@ -0,0 +1,49 @@
+const path = require('path');
+
+module.exports = {
+  // TCP ports
+  embeddingPort: 23811,
+  llmPort: 23812,
+
+  // Data directories (relative to project root)
+  dataDir: path.resolve(__dirname, 'data'),
+  logDir: path.resolve(__dirname, 'data', 'logs'),
+  pidDir: '/tmp',
+
+  // Azure OpenAI (configure via environment variables)
+  azure: {
+    endpoint: process.env.AZURE_OPENAI_ENDPOINT || '',
+    apiKey: process.env.AZURE_OPENAI_KEY || '',
+    deployment: process.env.AZURE_OPENAI_DEPLOYMENT || 'gpt-4.1',
+    apiVersion: '2024-12-01-preview',
+  },
+
+  // Embedding model
+  embedding: {
+    model: 'Xenova/bge-m3',
+    dimensions: 1024,
+  },
+
+  // Search parameters
+  search: {
+    maxResults: 3,
+    minSimilarity: 0.6,
+  },
+
+  // Clustering parameters
+  cluster: {
+    similarityThreshold: 0.70,
+    maturityCount: 5,
+    maturityConfidence: 0.65,
+  },
+
+  // Timeouts (ms)
+  timeout: {
+    hookPreTool: 300,
+    hookPostTool: 300,
+    hookUserPrompt: 1500,
+    embeddingSearch: 1000,
+    embeddingClient: 800,
+    llmDefault: 5000,
+  },
+};

package/config.js

@@ -0,0 +1,7 @@
+// Config loader — resolves config path from MEMORY_CONFIG env var or falls back to defaults
+const configPath = process.env.MEMORY_CONFIG;
+if (configPath && require('fs').existsSync(configPath)) {
+  module.exports = require(configPath);
+} else {
+  module.exports = require('./config.default');
+}