universal-memory-mcp 0.2.2 → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 slicenferqin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -55,6 +55,10 @@ Use specific keywords for better results (e.g., "TypeScript preferences", "datab
                             type: 'string',
                             description: 'Filter by project name',
                         },
+                        client: {
+                            type: 'string',
+                            description: 'Filter by client name (e.g., claude-code, opencode, trae)',
+                        },
                         limit: {
                             type: 'number',
                             description: 'Max results to return, default 10',
@@ -92,6 +96,10 @@ This builds memory over time, allowing recall of past discussions in future sess
                             type: 'string',
                             description: 'Project name if in a project context',
                         },
+                        client: {
+                            type: 'string',
+                            description: 'Client name (e.g., claude-code, opencode, trae)',
+                        },
                         session_id: {
                             type: 'string',
                             description: 'Session ID for grouping related conversations',
@@ -142,12 +150,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         switch (name) {
             case 'memory_search': {
-                const { query, time_range, project, limit } = args;
+                const { query, time_range, project, client, limit } = args;
                 const results = await memoryManager.search(query, {
                     timeRange: time_range
                         ? [new Date(time_range[0]), new Date(time_range[1])]
                         : undefined,
                     project,
+                    client,
                     limit,
                 });
                 if (results.length === 0) {
@@ -177,9 +186,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'memory_record': {
-                const { user_message, ai_response, project, session_id } = args;
+                const { user_message, ai_response, project, client, session_id } = args;
                 const conversation = await memoryManager.recordConversation(user_message, ai_response, {
                     project,
+                    client,
                     sessionId: session_id,
                 });
                 return {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/record.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=record.d.ts.map

package/dist/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":""}

package/dist/record.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { createMemoryManager } from 'universal-memory-core';
+function getArgValue(args, name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    const value = args[idx + 1];
+    if (!value || value.startsWith('--'))
+        return undefined;
+    return value;
+}
+function hasFlag(args, name) {
+    return args.includes(name);
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function usage() {
+    return [
+        'Usage:',
+        '  universal-memory-record --user <text> --ai <text> [--project <name>] [--client <name>] [--session-id <id>] [--cwd <path>]',
+        '  universal-memory-record --json',
+        '',
+        'JSON mode reads stdin with fields:',
+        '  { "user_message": "...", "ai_response": "...", "project": "...", "client": "...", "session_id": "...", "working_directory": "...", "storage_path": "..." }',
+        '',
+        'Storage path resolution priority:',
+        '  --storage-path / JSON.storage_path > env.MEMORY_PATH > default (~/.ai_memory)',
+    ].join('\n');
+}
+function normalizeInput(argv) {
+    if (hasFlag(argv, '--json')) {
+        return {};
+    }
+    const user_message = getArgValue(argv, '--user');
+    const ai_response = getArgValue(argv, '--ai');
+    const project = getArgValue(argv, '--project');
+    const client = getArgValue(argv, '--client');
+    const session_id = getArgValue(argv, '--session-id');
+    const working_directory = getArgValue(argv, '--cwd');
+    const storage_path = getArgValue(argv, '--storage-path');
+    return {
+        user_message,
+        ai_response,
+        project,
+        client,
+        session_id,
+        working_directory,
+        storage_path,
+    };
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (hasFlag(argv, '--help') || hasFlag(argv, '-h')) {
+        process.stdout.write(`${usage()}\n`);
+        process.exit(0);
+    }
+    let input = normalizeInput(argv);
+    if (hasFlag(argv, '--json')) {
+        const raw = await readStdin();
+        if (!raw.trim()) {
+            process.stderr.write('Error: --json provided but stdin is empty\n');
+            process.stderr.write(`${usage()}\n`);
+            process.exit(1);
+        }
+        input = JSON.parse(raw);
+    }
+    const userMessage = input.user_message;
+    const aiResponse = input.ai_response;
+    if (!userMessage || !aiResponse) {
+        process.stderr.write('Error: missing required fields user_message/ai_response (or --user/--ai)\n');
+        process.stderr.write(`${usage()}\n`);
+        process.exit(1);
+    }
+    const storagePath = input.storage_path || process.env.MEMORY_PATH || undefined;
+    const memoryManager = createMemoryManager(storagePath ? { storagePath } : undefined);
+    const conversation = await memoryManager.recordConversation(userMessage, aiResponse, {
+        project: input.project,
+        client: input.client,
+        sessionId: input.session_id,
+        workingDirectory: input.working_directory,
+    });
+    process.stdout.write(`${conversation.id}\n`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Fatal error: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=record.js.map

package/dist/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "universal-memory-mcp",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "MCP Server for persistent AI memory across sessions",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "universal-memory-mcp": "./dist/index.js"
+    "universal-memory-mcp": "./dist/index.js",
+    "universal-memory-record": "./dist/record.js"
   },
   "exports": {
     ".": {
@@ -24,7 +25,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "universal-memory-core": "^0.1.3"
+    "universal-memory-core": "^0.1.4"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",

package/scripts/postinstall.js

@@ -12,8 +12,10 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 
-const CLAUDE_SETTINGS_PATH = path.join(os.homedir(), '.claude', 'settings.json');
-const CLAUDE_SKILLS_PATH = path.join(os.homedir(), '.claude', 'skills');
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const CLAUDE_SETTINGS_PATH = path.join(CLAUDE_DIR, 'settings.json');
+const CLAUDE_SKILLS_PATH = path.join(CLAUDE_DIR, 'skills');
+const CLAUDE_HOOKS_PATH = path.join(CLAUDE_DIR, 'hooks');
 
 // MCP server configuration
 const MCP_CONFIG = {
@@ -155,6 +157,21 @@ memory_update_long_term({
 - Use project name when in project context
 `;
 
+/**
+ * Check if Claude Code is installed
+ */
+function checkClaudeCodeInstalled() {
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    console.log('\n⚠️  Claude Code not detected!\n');
+    console.log('Please install Claude Code first:');
+    console.log('  https://code.claude.com/\n');
+    console.log('After installing Claude Code, run:');
+    console.log('  npm install -g universal-memory-mcp\n');
+    return false;
+  }
+  return true;
+}
+
 /**
  * Read JSON file safely
  */
@@ -253,6 +270,92 @@ function installSkill() {
   return true;
 }
 
+/**
+ * Install Stop hook script
+ */
+function installStopHook() {
+  console.log('\n🪝 Installing Stop hook...');
+
+  const hookScriptPath = path.join(CLAUDE_HOOKS_PATH, 'universal-memory-stop-hook.mjs');
+
+  // Create hooks directory if not exists
+  if (!fs.existsSync(CLAUDE_HOOKS_PATH)) {
+    fs.mkdirSync(CLAUDE_HOOKS_PATH, { recursive: true });
+    console.log('  Created hooks directory');
+  }
+
+  // Get source script path (in the same directory as this postinstall script)
+  const sourceScript = new URL('universal-memory-stop-hook.mjs', import.meta.url).pathname;
+
+  // Check if hook already exists
+  if (fs.existsSync(hookScriptPath)) {
+    const existingContent = fs.readFileSync(hookScriptPath, 'utf-8');
+    const newContent = fs.readFileSync(sourceScript, 'utf-8');
+
+    if (existingContent === newContent) {
+      console.log('  Stop hook already installed (same version)');
+      return false;
+    }
+
+    // Backup existing hook
+    const backupPath = `${hookScriptPath}.backup.${Date.now()}`;
+    fs.copyFileSync(hookScriptPath, backupPath);
+    console.log(`  Backed up existing hook to: ${backupPath}`);
+  }
+
+  fs.copyFileSync(sourceScript, hookScriptPath);
+  fs.chmodSync(hookScriptPath, 0o755); // Make executable
+  console.log('  Stop hook installed successfully');
+  return true;
+}
+
+/**
+ * Configure Stop hook in Claude settings
+ */
+function configureStopHook() {
+  console.log('\n⚙️  Configuring Stop hook...');
+
+  let settings = readJsonFile(CLAUDE_SETTINGS_PATH) || {};
+
+  // Initialize hooks if not exists
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  // Initialize Stop hook array if not exists
+  if (!settings.hooks.Stop) {
+    settings.hooks.Stop = [];
+  }
+
+  // Check if our hook is already configured
+  const hookScriptPath = path.join(os.homedir(), '.claude', 'hooks', 'universal-memory-stop-hook.mjs');
+  const hookCommand = `node ${hookScriptPath}`;
+  const alreadyConfigured = settings.hooks.Stop.some(entry =>
+    entry.hooks?.some(hook =>
+      hook.type === 'command' && hook.command.includes('universal-memory-stop-hook')
+    )
+  );
+
+  if (alreadyConfigured) {
+    console.log('  Stop hook already configured');
+    return false;
+  }
+
+  // Add Stop hook configuration
+  settings.hooks.Stop.push({
+    hooks: [
+      {
+        type: 'command',
+        command: hookCommand
+      }
+    ]
+  });
+
+  writeJsonFile(CLAUDE_SETTINGS_PATH, settings);
+  console.log('  Stop hook configured successfully');
+  return true;
+}
+
 /**
  * Main installation
  */
@@ -261,26 +364,39 @@ function main() {
   console.log('║         Universal Memory MCP - Setup                       ║');
   console.log('╚════════════════════════════════════════════════════════════╝');
 
+  // Check Claude Code installation
+  if (!checkClaudeCodeInstalled()) {
+    process.exit(0);
+  }
+
   let needsRestart = false;
 
   try {
-    // Configure MCP server
+    // 1. Configure MCP server
     const mcpConfigured = configureMcpServer();
     if (mcpConfigured) needsRestart = true;
 
-    // Install skill
+    // 2. Install skill
     const skillInstalled = installSkill();
     if (skillInstalled) needsRestart = true;
 
+    // 3. Install Stop hook script
+    const hookInstalled = installStopHook();
+    if (hookInstalled) needsRestart = true;
+
+    // 4. Configure Stop hook
+    const hookConfigured = configureStopHook();
+    if (hookConfigured) needsRestart = true;
+
     // Summary
     console.log('\n' + '═'.repeat(60));
 
     if (needsRestart) {
       console.log('\n✅ Setup complete!\n');
-      console.log('⚠️  IMPORTANT: Please restart Claude Code to enable the MCP server.\n');
+      console.log('⚠️  IMPORTANT: Please restart Claude Code to enable all features.\n');
       console.log('After restart, Claude will automatically:');
       console.log('  • Search past conversations when you reference them');
-      console.log('  • Record important conversations for future recall');
+      console.log('  • Record EVERY conversation automatically (via Stop hook)');
       console.log('  • Remember your preferences and decisions\n');
     } else {
       console.log('\n✅ Already configured! No changes needed.\n');
@@ -289,6 +405,7 @@ function main() {
     console.log('📁 Configuration locations:');
     console.log(`   MCP config: ${CLAUDE_SETTINGS_PATH}`);
     console.log(`   Skill: ${path.join(CLAUDE_SKILLS_PATH, 'memory-assistant', 'SKILL.md')}`);
+    console.log(`   Stop hook: ${path.join(CLAUDE_HOOKS_PATH, 'universal-memory-stop-hook.mjs')}`);
     console.log(`   Memory storage: ${path.join(os.homedir(), '.ai_memory')}\n`);
 
   } catch (error) {

package/scripts/universal-memory-stop-hook.mjs

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+// Enable debug logging via environment variable
+const DEBUG = process.env.UNIVERSAL_MEMORY_DEBUG === '1';
+
+function debugLog(message) {
+  if (DEBUG) {
+    fs.appendFileSync('/tmp/universal-memory-stop-hook.log', `[${new Date().toISOString()}] ${message}\n`);
+  }
+}
+
+function readStdinSync() {
+  return fs.readFileSync(0, 'utf8');
+}
+
+function isNonEmptyString(value) {
+  return typeof value === 'string' && value.trim().length > 0;
+}
+
+function contentToText(content) {
+  if (typeof content === 'string') return content;
+  if (Array.isArray(content)) {
+    return content
+      .map((item) => {
+        if (typeof item === 'string') return item;
+        if (item && typeof item === 'object' && typeof item.text === 'string') return item.text;
+        if (item && typeof item === 'object' && typeof item.content === 'string') return item.content;
+        return '';
+      })
+      .filter(Boolean)
+      .join('\n');
+  }
+  if (content && typeof content === 'object') {
+    if (typeof content.text === 'string') return content.text;
+    if (typeof content.content === 'string') return content.content;
+  }
+  return '';
+}
+
+function extractMessages(transcriptJson) {
+  if (!transcriptJson || typeof transcriptJson !== 'object') return [];
+
+  if (Array.isArray(transcriptJson.messages)) return transcriptJson.messages;
+  if (Array.isArray(transcriptJson.turns)) return transcriptJson.turns;
+  if (Array.isArray(transcriptJson.events)) return transcriptJson.events;
+  if (Array.isArray(transcriptJson.transcript)) return transcriptJson.transcript;
+
+  if (transcriptJson.conversation && Array.isArray(transcriptJson.conversation.messages)) {
+    return transcriptJson.conversation.messages;
+  }
+
+  return [];
+}
+
+function extractLastExchange(messages) {
+  const normalized = messages
+    .map((m) => {
+      if (!m || typeof m !== 'object') return null;
+      const role = m.role || m.author || m.type;
+      const content = m.content ?? m.text ?? m.message ?? m.data?.content;
+      return {
+        role: typeof role === 'string' ? role : '',
+        text: contentToText(content),
+      };
+    })
+    .filter(Boolean)
+    .filter((m) => isNonEmptyString(m.role) && isNonEmptyString(m.text));
+
+  const roleNorm = (r) => String(r).toLowerCase();
+  const lastUserIdx = (() => {
+    for (let i = normalized.length - 1; i >= 0; i--) {
+      if (roleNorm(normalized[i].role) === 'user') return i;
+    }
+    return -1;
+  })();
+
+  const lastAssistantIdxAfterUser = (() => {
+    if (lastUserIdx === -1) return -1;
+    for (let i = lastUserIdx + 1; i < normalized.length; i++) {
+      if (roleNorm(normalized[i].role) === 'assistant') return i;
+    }
+    return -1;
+  })();
+
+  const lastAssistantIdx = (() => {
+    for (let i = normalized.length - 1; i >= 0; i--) {
+      if (roleNorm(normalized[i].role) === 'assistant') return i;
+    }
+    return -1;
+  })();
+
+  const userText = lastUserIdx !== -1 ? normalized[lastUserIdx].text : '';
+  const aiText =
+    lastAssistantIdxAfterUser !== -1
+      ? normalized[lastAssistantIdxAfterUser].text
+      : lastAssistantIdx !== -1
+        ? normalized[lastAssistantIdx].text
+        : '';
+
+  return { userText, aiText };
+}
+
+function truncate(text, maxChars) {
+  if (!isNonEmptyString(text)) return '';
+  if (text.length <= maxChars) return text;
+  return text.slice(0, maxChars) + `\n\n[truncated to ${maxChars} chars]`;
+}
+
+function findUp(startDir, relativeTarget) {
+  let dir = startDir;
+  for (;;) {
+    const candidate = path.join(dir, relativeTarget);
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+function runRecordCommand(payload, cwd) {
+  const input = JSON.stringify(payload);
+
+  const direct = spawnSync('universal-memory-record', ['--json'], {
+    input,
+    encoding: 'utf8',
+    cwd,
+    stdio: ['pipe', 'pipe', 'pipe'],
+  });
+  if (direct.status === 0) return { ok: true, id: direct.stdout.trim() };
+
+  const npx = spawnSync(
+    'npx',
+    ['-y', '--package', 'universal-memory-mcp', 'universal-memory-record', '--json'],
+    {
+      input,
+      encoding: 'utf8',
+      cwd,
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }
+  );
+  if (npx.status === 0) return { ok: true, id: npx.stdout.trim() };
+
+  const distPath = findUp(cwd, path.join('packages', 'mcp-server', 'dist', 'record.js'));
+  if (!distPath) {
+    return {
+      ok: false,
+      error: 'universal-memory-record not found (PATH/npx) and dist/record.js not found',
+    };
+  }
+
+  const fallback = spawnSync('node', [distPath, '--json'], {
+    input,
+    encoding: 'utf8',
+    cwd,
+    stdio: ['pipe', 'pipe', 'pipe'],
+  });
+  if (fallback.status === 0) return { ok: true, id: fallback.stdout.trim() };
+  return { ok: false, error: fallback.stderr || fallback.stdout || 'record command failed' };
+}
+
+function detectProjectName(cwd) {
+  try {
+    const gitDir = findUp(cwd, '.git');
+    if (gitDir) return path.basename(path.dirname(gitDir));
+  } catch {
+    return undefined;
+  }
+  return undefined;
+}
+
+function main() {
+  debugLog('Stop hook triggered');
+
+  const raw = readStdinSync();
+  if (!raw.trim()) {
+    debugLog('No stdin input, exiting');
+    process.exit(0);
+  }
+
+  debugLog(`Received input: ${raw.substring(0, 200)}...`);
+
+  let hookInput;
+  try {
+    hookInput = JSON.parse(raw);
+  } catch (err) {
+    debugLog(`Failed to parse input JSON: ${err.message}`);
+    process.exit(0);
+  }
+
+  const cwd = hookInput.cwd || process.cwd();
+  const transcriptPath = hookInput.transcript_path || hookInput.transcriptPath;
+  const sessionId = hookInput.session_id || hookInput.sessionId;
+
+  debugLog(`transcript_path: ${transcriptPath}`);
+
+  if (!isNonEmptyString(transcriptPath)) {
+    debugLog('No transcript_path, exiting');
+    process.exit(0);
+  }
+
+  let messages;
+  try {
+    const transcriptContent = fs.readFileSync(transcriptPath, 'utf8');
+
+    // Parse JSONL format (one JSON object per line)
+    const lines = transcriptContent.trim().split('\n').filter(line => line.trim());
+    const entries = lines.map(line => JSON.parse(line));
+
+    debugLog(`Successfully read ${entries.length} transcript entries`);
+
+    // Extract messages from JSONL entries
+    messages = entries
+      .filter(entry => entry.type === 'user' || entry.type === 'assistant')
+      .map(entry => ({
+        role: entry.type === 'user' ? 'user' : 'assistant',
+        content: entry.message?.content || entry.content
+      }));
+
+    debugLog(`Extracted ${messages.length} messages from JSONL`);
+  } catch (err) {
+    debugLog(`Failed to read transcript: ${err.message}`);
+    process.exit(0);
+  }
+
+  const { userText, aiText } = extractLastExchange(messages);
+  debugLog(`userText length: ${userText.length}, aiText length: ${aiText.length}`);
+
+  if (!isNonEmptyString(userText) || !isNonEmptyString(aiText)) {
+    debugLog('Empty user or AI text, exiting');
+    process.exit(0);
+  }
+
+  // Determine client - default to 'claude-code' if not provided
+  const client = isNonEmptyString(hookInput.client) ? hookInput.client : 'claude-code';
+
+  const payload = {
+    user_message: truncate(userText, 8000),
+    ai_response: truncate(aiText, 20000),
+    project: detectProjectName(cwd),
+    client: client,
+    session_id: isNonEmptyString(sessionId) ? sessionId : undefined,
+    working_directory: cwd,
+  };
+
+  debugLog(`Payload: client=${client}, project=${payload.project}, session_id=${payload.session_id}`);
+
+  const res = runRecordCommand(payload, cwd);
+  if (!res.ok) {
+    const errorMsg = `universal-memory stop hook warning: ${res.error}\n`;
+    process.stderr.write(errorMsg);
+    debugLog(`Error: ${res.error}`);
+  } else {
+    debugLog(`Successfully saved memory: ${res.id}`);
+  }
+}
+
+main();