claude-mem 3.0.4 → 3.1.2

package/.mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "claude-mem": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-memory"
-      ]
-    }
-  }
-}

package/dist/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+// <Block> 1.1 ====================================
+// CLI Dependencies and Imports Setup
+// Natural pattern: Import what you need before using it
 import { Command } from 'commander';
 import { PACKAGE_NAME, PACKAGE_VERSION, PACKAGE_DESCRIPTION } from './config.js';
 // Import command handlers
@@ -8,11 +11,20 @@ import { uninstall } from './commands/uninstall.js';
 import { status } from './commands/status.js';
 import { logs } from './commands/logs.js';
 import { loadContext } from './commands/load-context.js';
+import { migrate } from './commands/migrate.js';
 const program = new Command();
+// </Block> =======================================
+// <Block> 1.2 ====================================
+// Program Configuration
+// Natural pattern: Configure program metadata first
 program
     .name(PACKAGE_NAME)
     .description(PACKAGE_DESCRIPTION)
     .version(PACKAGE_VERSION);
+// </Block> =======================================
+// <Block> 1.3 ====================================
+// Compress Command Definition
+// Natural pattern: Define command with its options and handler
 // Compress command
 program
     .command('compress [transcript]')
@@ -21,6 +33,10 @@ program
     .option('--dry-run', 'Show what would be compressed without doing it')
     .option('-v, --verbose', 'Show detailed output')
     .action(compress);
+// </Block> =======================================
+// <Block> 1.4 ====================================
+// Install Command Definition
+// Natural pattern: Define command with its options and handler
 // Install command
 program
     .command('install')
@@ -29,6 +45,10 @@ program
     .option('--project', 'Install for current project only')
     .option('--force', 'Force installation even if already installed')
     .action(install);
+// </Block> =======================================
+// <Block> 1.5 ====================================
+// Uninstall Command Definition
+// Natural pattern: Define command with its options and handler
 // Uninstall command
 program
     .command('uninstall')
@@ -37,11 +57,19 @@ program
     .option('--project', 'Remove from project settings')
     .option('--all', 'Remove from both global and project settings')
     .action(uninstall);
+// </Block> =======================================
+// <Block> 1.6 ====================================
+// Status Command Definition
+// Natural pattern: Define command with its handler
 // Status command
 program
     .command('status')
     .description('Check installation status of Claude Memory System')
     .action(status);
+// </Block> =======================================
+// <Block> 1.7 ====================================
+// Logs Command Definition
+// Natural pattern: Define command with its options and handler
 // Logs command
 program
     .command('logs')
@@ -51,6 +79,10 @@ program
     .option('--tail [n]', 'Show last n lines', '50')
     .option('--follow', 'Follow log output')
     .action(logs);
+// </Block> =======================================
+// <Block> 1.8 ====================================
+// Load-Context Command Definition
+// Natural pattern: Define command with its options and handler
 // Load-context command
 program
     .command('load-context')
@@ -60,5 +92,21 @@ program
     .option('--raw', 'Output raw JSON instead of formatted text')
     .option('--format <type>', 'Output format: json, session-start, or default')
     .action(loadContext);
+// </Block> =======================================
+// <Block> 1.9 ====================================
+// Migrate Command Definition
+// Natural pattern: Define command with its options and handler
+// Migrate command
+program
+    .command('migrate')
+    .description('Migrate index to Weaviate format and extract entities')
+    .option('--dry-run', 'Show migration preview without performing it')
+    .option('--force', 'Force migration even if data exists')
+    .action(migrate);
+// </Block> =======================================
+// <Block> 1.10 ===================================
+// CLI Execution
+// Natural pattern: After defining all commands, parse and execute
 // Parse arguments and execute
 program.parse();
+// </Block> =======================================

package/dist/commands/compress.js

@@ -1,59 +1,13 @@
-import { existsSync } from 'fs';
-import { dirname, basename } from 'path';
-import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+import { basename } from 'path';
 export async function compress(transcript, options = {}) {
-    if (!transcript) {
-        console.error('❌ Transcript file path is required');
-        process.exit(1);
-    }
-    if (!existsSync(transcript)) {
-        console.error(`❌ Transcript file not found: ${transcript}`);
-        process.exit(1);
-    }
     console.log(`🗜️  Compressing transcript: ${transcript}`);
-    if (options.dryRun) {
-        console.log('📋 Dry run mode - no files will be written');
-        return;
-    }
-    try {
-        // Import TranscriptCompressor dynamically to ensure it's available
-        const { TranscriptCompressor } = await import('../utils/TranscriptCompressor.js');
-        // Create compressor instance with debug mode based on verbose option
-        const compressor = new TranscriptCompressor({
-            debug: options.verbose || false
-        });
-        // Extract session ID from transcript filename if not provided
-        const sessionId = options.sessionId || basename(transcript, '.jsonl');
-        if (options.verbose) {
-            console.log(`📊 Starting compression with session ID: ${sessionId}`);
-        }
-        // Perform compression
-        const archivePath = await compressor.compress(transcript, sessionId);
-        console.log('✅ Compression completed successfully');
-        console.log(`📦 Archive created: ${archivePath}`);
-        if (options.output && options.output !== dirname(archivePath)) {
-            console.log(`📂 Output directory: ${options.output} (archive location may differ)`);
-        }
-    }
-    catch (error) {
-        const err = error;
-        console.error('❌ Compression failed:', err.message);
-        if (options.verbose) {
-            console.error('Stack trace:', err.stack);
-        }
-        // Provide helpful error messages for common issues
-        if (err.message.includes('Claude Code executable not found')) {
-            console.error('💡 Hint: Make sure Claude Code is installed and accessible in your PATH');
-            console.error('   Or set CLAUDE_CODE_PATH environment variable');
-        }
-        else if (err.message.includes('JWT_SECRET')) {
-            console.error('💡 Hint: Make sure JWT_SECRET is set in your MCP configuration');
-        }
-        else if (err.message.includes('No summaries extracted')) {
-            console.error('💡 Hint: The transcript may be too short or not contain analyzable content');
-        }
-        process.exit(1);
-    }
+    // Import and run compression
+    const { TranscriptCompressor } = await import('../utils/TranscriptCompressor.js');
+    const compressor = new TranscriptCompressor({
+        verbose: options.verbose || false
+    });
+    const sessionId = options.sessionId || basename(transcript || '', '.jsonl');
+    const archivePath = await compressor.compress(transcript || '', sessionId);
+    console.log('✅ Compression completed successfully');
+    console.log(`📦 Archive created: ${archivePath}`);
 }

package/dist/commands/install.js

@@ -1,10 +1,13 @@
-import { readFileSync, writeFileSync, existsSync, chmodSync, mkdirSync, copyFileSync, statSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, chmodSync, mkdirSync, copyFileSync, statSync, readdirSync } from 'fs';
 import { join, resolve, dirname } from 'path';
 import { homedir } from 'os';
+import { execSync } from 'child_process';
 import { fileURLToPath } from 'url';
 import { PACKAGE_NAME, MCP_SERVER_SCRIPT } from '../config.js';
 import { CLI_MESSAGES } from '../constants.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
+// <Block> 2.1 ====================================
+// Directory structure creation - natural setup flow
 function ensureDirectoryStructure() {
     const claudeMemDir = join(homedir(), '.claude-mem');
     const hooksDir = join(claudeMemDir, 'hooks');
@@ -17,12 +20,128 @@ function ensureDirectoryStructure() {
         }
     });
 }
+// </Block> =======================================
+function copyFileRecursively(src, dest) {
+    const stat = statSync(src);
+    if (stat.isDirectory()) {
+        if (!existsSync(dest)) {
+            mkdirSync(dest, { recursive: true });
+        }
+        const files = readdirSync(src);
+        files.forEach((file) => {
+            copyFileRecursively(join(src, file), join(dest, file));
+        });
+    }
+    else {
+        copyFileSync(src, dest);
+    }
+}
+function createMcpPackageJson(destDir) {
+    const packageJsonPath = join(destDir, 'package.json');
+    const mcpPackageJson = {
+        "name": "claude-mem-mcp-server",
+        "version": "1.0.0",
+        "description": "MCP server for claude-mem embedded Weaviate instance",
+        "type": "module",
+        "main": "mcp-server-cli.js",
+        "dependencies": {
+            "@anthropic-ai/claude-code": "^1.0.88",
+            "@modelcontextprotocol/sdk": "^0.5.0",
+            "commander": "^14.0.0",
+            "weaviate-ts-embedded": "^1.2.0"
+        },
+        "engines": {
+            "node": ">=18.0.0"
+        }
+    };
+    writeFileSync(packageJsonPath, JSON.stringify(mcpPackageJson, null, 2));
+    console.log('✅ Created package.json for MCP server');
+}
+function installMcpServerFiles() {
+    const claudeMemDir = join(homedir(), '.claude-mem');
+    // Find the dist directory with all compiled files
+    const possibleDistPaths = [
+        resolve(join(__dirname, '..', '..')), // Development mode - look in project root dist/
+        resolve(join(__dirname, '..')), // Development mode - already in dist/
+        resolve(join(dirname(process.execPath), '..', 'lib', 'node_modules', 'claude-mem')), // npm global install
+        resolve(join(dirname(process.execPath), '..', '..', 'lib', 'node_modules', 'claude-mem')), // npm global install (alternative path)
+    ];
+    let distPath = null;
+    for (const candidatePath of possibleDistPaths) {
+        const possibleDist = join(candidatePath, 'dist');
+        const mcpServerCliPath = join(possibleDist, MCP_SERVER_SCRIPT);
+        const mcpServerPath = join(possibleDist, 'mcp-server.js');
+        const constantsPath = join(possibleDist, 'constants.js');
+        const utilsPath = join(possibleDist, 'utils');
+        if (existsSync(mcpServerCliPath) && existsSync(mcpServerPath) && existsSync(constantsPath) && existsSync(utilsPath)) {
+            distPath = possibleDist;
+            break;
+        }
+    }
+    if (!distPath) {
+        console.log('⚠️  MCP server files not found in dist directory, MCP features will be unavailable');
+        return false;
+    }
+    console.log(`📁 Found MCP server files in: ${distPath}`);
+    // Copy all required MCP server files
+    const filesToCopy = [
+        MCP_SERVER_SCRIPT, // mcp-server-cli.js (entry point)
+        'mcp-server.js', // Main server logic
+        'constants.js', // Constants and messages
+        'config.js', // Configuration
+        'types.js', // Type definitions
+        'error-handler.js' // Error handling
+    ];
+    // Copy individual files
+    for (const file of filesToCopy) {
+        const srcPath = join(distPath, file);
+        const destPath = join(claudeMemDir, file);
+        if (existsSync(srcPath)) {
+            copyFileSync(srcPath, destPath);
+            if (file === MCP_SERVER_SCRIPT) {
+                chmodSync(destPath, 0o755); // Make CLI executable
+            }
+            console.log(`✅ Copied ${file}`);
+        }
+        else {
+            console.log(`⚠️  Missing required file: ${file}`);
+        }
+    }
+    // Copy utils directory recursively
+    const utilsSrc = join(distPath, 'utils');
+    const utilsDest = join(claudeMemDir, 'utils');
+    if (existsSync(utilsSrc)) {
+        copyFileRecursively(utilsSrc, utilsDest);
+        console.log('✅ Copied utils/ directory');
+    }
+    else {
+        console.log('⚠️  Missing required utils/ directory');
+        return false;
+    }
+    // Create package.json with dependencies
+    createMcpPackageJson(claudeMemDir);
+    // Install dependencies
+    try {
+        console.log('📦 Installing MCP server dependencies...');
+        execSync('npm install', {
+            cwd: claudeMemDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 120000 // 2 minute timeout
+        });
+        console.log('✅ Dependencies installed successfully');
+    }
+    catch (error) {
+        console.log(`⚠️  Failed to install dependencies: ${error.message}`);
+        console.log('   You may need to run "npm install" manually in ~/.claude-mem/');
+        return false;
+    }
+    return true;
+}
 function writeHookFiles() {
     const hooksDir = join(homedir(), '.claude-mem', 'hooks');
     const preCompactDest = join(hooksDir, 'pre-compact.js');
     const sessionStartDest = join(hooksDir, 'session-start.js');
     const sessionEndDest = join(hooksDir, 'session-end.js');
-    const mcpServerDest = join(homedir(), '.claude-mem', MCP_SERVER_SCRIPT);
     // Find hooks directory relative to the package location
     const possibleHooksPaths = [
         resolve(join(__dirname, '..', '..', 'hooks')), // Development mode
@@ -30,18 +149,9 @@ function writeHookFiles() {
         resolve(join(dirname(process.execPath), '..', 'lib', 'node_modules', 'claude-mem', 'hooks')), // npm global install
         resolve(join(dirname(process.execPath), '..', '..', 'lib', 'node_modules', 'claude-mem', 'hooks')), // npm global install (alternative path)
     ];
-    // Find MCP server script in dist directory
-    const possibleMcpServerPaths = [
-        resolve(join(__dirname, '..', '..', 'dist', MCP_SERVER_SCRIPT)), // Development mode - look in project dist/
-        resolve(join(__dirname, '..', MCP_SERVER_SCRIPT)), // Development mode - compiled to same dist/
-        resolve(join(dirname(process.execPath), '..', 'lib', 'node_modules', 'claude-mem', 'dist', MCP_SERVER_SCRIPT)), // npm global install
-        resolve(join(dirname(process.execPath), '..', '..', 'lib', 'node_modules', 'claude-mem', 'dist', MCP_SERVER_SCRIPT)), // npm global install (alternative path)
-        resolve(join(dirname(process.execPath), MCP_SERVER_SCRIPT)), // Standalone executable with script alongside
-    ];
     let preCompactSource = null;
     let sessionStartSource = null;
     let sessionEndSource = null;
-    let mcpServerSource = null;
     for (const hooksPath of possibleHooksPaths) {
         const preCompactCandidate = join(hooksPath, 'pre-compact.js');
         const sessionStartCandidate = join(hooksPath, 'session-start.js');
@@ -56,71 +166,37 @@ function writeHookFiles() {
             break;
         }
     }
-    // Find MCP server script
-    for (const mcpServerPath of possibleMcpServerPaths) {
-        if (existsSync(mcpServerPath)) {
-            mcpServerSource = mcpServerPath;
-            break;
-        }
+    // Proceed with whatever files we found
+    if (!preCompactSource || !sessionStartSource) {
+        console.log('⚠️  Some hook files not found, continuing with available files');
+        if (!preCompactSource)
+            console.log('  - pre-compact.js not found');
+        if (!sessionStartSource)
+            console.log('  - session-start.js not found');
     }
-    if (preCompactSource && sessionStartSource) {
+    // Install available files
+    if (preCompactSource) {
         copyFileSync(preCompactSource, preCompactDest);
-        copyFileSync(sessionStartSource, sessionStartDest);
-        // Copy session-end.js if it exists
-        if (sessionEndSource) {
-            copyFileSync(sessionEndSource, sessionEndDest);
-            chmodSync(sessionEndDest, 0o755);
-        }
         chmodSync(preCompactDest, 0o755);
+    }
+    if (sessionStartSource) {
+        copyFileSync(sessionStartSource, sessionStartDest);
         chmodSync(sessionStartDest, 0o755);
-        // Copy MCP server script
-        if (mcpServerSource) {
-            copyFileSync(mcpServerSource, mcpServerDest);
-            chmodSync(mcpServerDest, 0o755);
-            console.log('✅ MCP server script installed');
-        }
-        else {
-            console.error('❌ MCP server script not found');
-            console.error('Searched in:');
-            possibleMcpServerPaths.forEach(path => console.error(`  - ${path}`));
-            process.exit(1);
-        }
-        // Write a configuration file for hooks to know the package name
-        const hookConfigPath = join(hooksDir, 'config.json');
-        const hookConfig = {
-            packageName: PACKAGE_NAME,
-            cliCommand: PACKAGE_NAME, // The command to call (claude-mem)
-            backend: 'weaviate' // Always use embedded Weaviate
-        };
-        writeFileSync(hookConfigPath, JSON.stringify(hookConfig, null, 2));
-        console.log(CLI_MESSAGES.INSTALLATION.HOOKS_INSTALLED);
-        // Validate MCP server script installation
-        if (existsSync(mcpServerDest)) {
-            try {
-                // Test script has execute permissions by checking file stats
-                const stats = statSync(mcpServerDest);
-                if (stats.mode & parseInt('100', 8)) {
-                    console.log('✅ MCP server script validated');
-                }
-                else {
-                    console.warn('⚠️  MCP server script may not be executable');
-                }
-            }
-            catch (error) {
-                console.warn(`⚠️  MCP server script validation failed: ${error.message}`);
-            }
-        }
-        else {
-            console.error('❌ MCP server script validation failed - file not found');
-            process.exit(1);
-        }
     }
-    else {
-        console.error(CLI_MESSAGES.ERRORS.HOOKS_NOT_FOUND);
-        console.error('Searched in:');
-        possibleHooksPaths.forEach(path => console.error(`  - ${path}`));
-        process.exit(1);
+    // Copy session-end.js if it exists
+    if (sessionEndSource) {
+        copyFileSync(sessionEndSource, sessionEndDest);
+        chmodSync(sessionEndDest, 0o755);
     }
+    // Write a configuration file for hooks to know the package name
+    const hookConfigPath = join(hooksDir, 'config.json');
+    const hookConfig = {
+        packageName: PACKAGE_NAME,
+        cliCommand: PACKAGE_NAME, // The command to call (claude-mem)
+        backend: 'weaviate' // Always use embedded Weaviate
+    };
+    writeFileSync(hookConfigPath, JSON.stringify(hookConfig, null, 2));
+    console.log(CLI_MESSAGES.INSTALLATION.HOOKS_INSTALLED);
 }
 /**
  * 🔒 LOCKED by @docs-agent | Change to 🔑 to allow @docs-agent edits
@@ -211,6 +287,8 @@ export async function install(options = {}) {
             'user';
     // Configure MCP server with the appropriate scope
     configureMcpServer(settingsDir, scope);
+    // Install MCP server files to ~/.claude-mem/
+    const mcpServerInstalled = installMcpServerFiles();
     // Write hook files to ~/.claude-mem/hooks/
     writeHookFiles();
     // Point settings to the installed hooks
@@ -226,6 +304,7 @@ export async function install(options = {}) {
         }
         catch (error) {
             console.log(`⚠️  Creating new settings file (could not parse existing): ${error.message}`);
+            settings = {}; // Continue with fresh settings
         }
     }
     // Ensure settings directory exists
@@ -236,36 +315,24 @@ export async function install(options = {}) {
     if (!settings.hooks) {
         settings.hooks = {};
     }
-    // Check for existing hooks from this package
-    // Non-tool hooks structure: array of { hooks: [...] } (no matcher field)
-    const hasExistingPreCompact = settings.hooks.PreCompact?.some((config) => config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('pre-compact.js')));
-    const hasExistingSessionStart = settings.hooks.SessionStart?.some((config) => config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('session-start.js')));
-    const hasExistingSessionEnd = settings.hooks.SessionEnd?.some((config) => config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('session-end.js')));
-    if ((hasExistingPreCompact || hasExistingSessionStart || hasExistingSessionEnd) && !options.force) {
-        console.log(CLI_MESSAGES.INSTALLATION.ALREADY_INSTALLED);
-        console.log(CLI_MESSAGES.INSTALLATION.USE_FORCE);
-        return;
-    }
-    // Remove existing claude-mem hooks if forcing
-    if (options.force) {
-        // Non-tool hooks: filter out configs where hooks contain our commands
-        if (settings.hooks.PreCompact) {
-            settings.hooks.PreCompact = settings.hooks.PreCompact.filter((config) => !config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('pre-compact.js')));
-            if (settings.hooks.PreCompact.length === 0) {
-                delete settings.hooks.PreCompact;
-            }
+    // Remove existing claude-mem hooks to ensure clean installation/update
+    // Non-tool hooks: filter out configs where hooks contain our commands
+    if (settings.hooks.PreCompact) {
+        settings.hooks.PreCompact = settings.hooks.PreCompact.filter((config) => !config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('pre-compact.js')));
+        if (settings.hooks.PreCompact.length === 0) {
+            delete settings.hooks.PreCompact;
         }
-        if (settings.hooks.SessionStart) {
-            settings.hooks.SessionStart = settings.hooks.SessionStart.filter((config) => !config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('session-start.js')));
-            if (settings.hooks.SessionStart.length === 0) {
-                delete settings.hooks.SessionStart;
-            }
+    }
+    if (settings.hooks.SessionStart) {
+        settings.hooks.SessionStart = settings.hooks.SessionStart.filter((config) => !config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('session-start.js')));
+        if (settings.hooks.SessionStart.length === 0) {
+            delete settings.hooks.SessionStart;
         }
-        if (settings.hooks.SessionEnd) {
-            settings.hooks.SessionEnd = settings.hooks.SessionEnd.filter((config) => !config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('session-end.js')));
-            if (settings.hooks.SessionEnd.length === 0) {
-                delete settings.hooks.SessionEnd;
-            }
+    }
+    if (settings.hooks.SessionEnd) {
+        settings.hooks.SessionEnd = settings.hooks.SessionEnd.filter((config) => !config.hooks?.some((hook) => hook.command?.includes(PACKAGE_NAME) || hook.command?.includes('session-end.js')));
+        if (settings.hooks.SessionEnd.length === 0) {
+            delete settings.hooks.SessionEnd;
         }
     }
     /**
@@ -366,7 +433,7 @@ export async function install(options = {}) {
         });
     }
     catch (error) {
-        console.error(CLI_MESSAGES.ERRORS.SETTINGS_WRITE_FAILED(settingsPath, error.message));
-        process.exit(1);
+        console.log(CLI_MESSAGES.ERRORS.SETTINGS_WRITE_FAILED(settingsPath, error.message));
+        console.log('⚠️  Installation completed but settings file could not be written');
     }
 }