claude-mem 3.0.5 → 3.1.6

package/dist/{cli.js → bin/cli.js}

@@ -3,14 +3,14 @@
 // 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 { PACKAGE_NAME, PACKAGE_VERSION, PACKAGE_DESCRIPTION } from '../shared/config.js';
 // Import command handlers
-import { compress } from './commands/compress.js';
-import { install } from './commands/install.js';
-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 { compress } from '../commands/compress.js';
+import { install } from '../commands/install.js';
+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';
 const program = new Command();
 // </Block> =======================================
 // <Block> 1.2 ====================================
@@ -40,8 +40,12 @@ program
 program
     .command('install')
     .description('Install Claude Code hooks for automatic compression')
-    .option('--global', 'Install globally (default)')
+    .option('--user', 'Install for current user (default)')
     .option('--project', 'Install for current project only')
+    .option('--local', 'Install to custom local directory')
+    .option('--path <path>', 'Custom installation path (with --local)')
+    .option('--timeout <ms>', 'Hook execution timeout in milliseconds', '180000')
+    .option('--skip-mcp', 'Skip Chroma MCP server installation')
     .option('--force', 'Force installation even if already installed')
     .action(install);
 // </Block> =======================================
@@ -52,9 +56,9 @@ program
 program
     .command('uninstall')
     .description('Remove Claude Code hooks')
-    .option('--global', 'Remove from global settings')
+    .option('--user', 'Remove from user settings (default)')
     .option('--project', 'Remove from project settings')
-    .option('--all', 'Remove from both global and project settings')
+    .option('--all', 'Remove from both user and project settings')
     .action(uninstall);
 // </Block> =======================================
 // <Block> 1.6 ====================================
@@ -92,7 +96,32 @@ program
     .option('--format <type>', 'Output format: json, session-start, or default')
     .action(loadContext);
 // </Block> =======================================
-// <Block> 1.9 ====================================
+// <Block> 1.10 ===================================  
+// Hook Commands for Binary Distribution
+// Internal commands called by hook wrappers
+program
+    .command('hook:pre-compact', { hidden: true })
+    .description('Internal pre-compact hook handler')
+    .action(async () => {
+    const { preCompactHook } = await import('../commands/hooks.js');
+    await preCompactHook();
+});
+program
+    .command('hook:session-start', { hidden: true })
+    .description('Internal session-start hook handler')
+    .action(async () => {
+    const { sessionStartHook } = await import('../commands/hooks.js');
+    await sessionStartHook();
+});
+program
+    .command('hook:session-end', { hidden: true })
+    .description('Internal session-end hook handler')
+    .action(async () => {
+    const { sessionEndHook } = await import('../commands/hooks.js');
+    await sessionEndHook();
+});
+// </Block> =======================================
+// <Block> 1.11 ===================================
 // CLI Execution
 // Natural pattern: After defining all commands, parse and execute
 // Parse arguments and execute

package/dist/commands/compress.js

@@ -1,79 +1,27 @@
-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';
+import { createLoadingMessage, createCompletionMessage, createOperationSummary, createUserFriendlyError } from '../prompts/templates/context/ContextTemplates.js';
 export async function compress(transcript, options = {}) {
-    // <Block> 1.1 ====================================
-    // Guard clause - early exit for missing transcript parameter
+    console.log(createLoadingMessage('compressing'));
     if (!transcript) {
-        console.error('❌ Transcript file path is required');
-        process.exit(1);
-    }
-    // </Block> =======================================
-    // <Block> 1.2 ====================================
-    // File existence validation with early exit
-    if (!existsSync(transcript)) {
-        console.error(`❌ Transcript file not found: ${transcript}`);
-        process.exit(1);
-    }
-    // </Block> =======================================
-    console.log(`🗜️  Compressing transcript: ${transcript}`);
-    // <Block> 1.3 ====================================
-    // Dry run conditional - acceptable early return
-    if (options.dryRun) {
-        console.log('📋 Dry run mode - no files will be written');
+        console.log(createUserFriendlyError('Compression', 'No transcript file provided', 'Please provide a path to a transcript file'));
         return;
     }
-    // </Block> =======================================
-    // <Block> 1.4 ====================================
-    // Main try-catch block for compression processing
     try {
-        // Import TranscriptCompressor dynamically to ensure it's available
-        const { TranscriptCompressor } = await import('../utils/TranscriptCompressor.js');
-        // Create compressor instance
+        const startTime = Date.now();
+        // Import and run compression
+        const { TranscriptCompressor } = await import('../core/compression/TranscriptCompressor.js');
         const compressor = new TranscriptCompressor({
             verbose: options.verbose || false
         });
-        // Extract session ID from transcript filename if not provided
         const sessionId = options.sessionId || basename(transcript, '.jsonl');
-        // <Block> 1.5 ====================================
-        // Verbose logging conditional
-        if (options.verbose) {
-            console.log(`📊 Starting compression with session ID: ${sessionId}`);
-        }
-        // </Block> =======================================
-        // Perform compression
         const archivePath = await compressor.compress(transcript, sessionId);
-        console.log('✅ Compression completed successfully');
-        console.log(`📦 Archive created: ${archivePath}`);
-        // <Block> 1.6 ====================================
-        // Output path conditional - informational logging
-        if (options.output && options.output !== dirname(archivePath)) {
-            console.log(`📂 Output directory: ${options.output} (archive location may differ)`);
-        }
-        // </Block> =======================================
+        const duration = Date.now() - startTime;
+        console.log(createCompletionMessage('Compression', undefined, `Session archived as ${basename(archivePath)}`));
+        console.log(createOperationSummary('compress', { count: 1, duration, details: `Session: ${sessionId}` }));
     }
     catch (error) {
-        const err = error;
-        console.error('❌ Compression failed:', err.message);
-        if (options.verbose) {
-            console.error('Stack trace:', err.stack);
-        }
-        // <Block> 1.7 ====================================
-        // Error message customization - natural help system
-        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');
-        }
-        // </Block> =======================================
-        process.exit(1);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.log(createUserFriendlyError('Compression', errorMessage, 'Check that the transcript file exists and you have write permissions'));
+        throw error; // Re-throw to maintain existing error handling behavior
     }
-    // </Block> =======================================
 }

package/dist/commands/hooks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hook command handlers for binary distribution
+ * These execute the actual hook logic embedded in the binary
+ */
+/**
+ * Pre-compact hook handler
+ * Runs compression on the Claude Code transcript
+ */
+export declare function preCompactHook(): Promise<void>;
+/**
+ * Session-start hook handler
+ * Loads context for the new session
+ */
+export declare function sessionStartHook(): Promise<void>;
+/**
+ * Session-end hook handler
+ * Compresses session transcript when ending with /clear
+ */
+export declare function sessionEndHook(): Promise<void>;

package/dist/commands/hooks.js

@@ -0,0 +1,102 @@
+/**
+ * Hook command handlers for binary distribution
+ * These execute the actual hook logic embedded in the binary
+ */
+import { compress } from './compress.js';
+import { loadContext } from './load-context.js';
+/**
+ * Pre-compact hook handler
+ * Runs compression on the Claude Code transcript
+ */
+export async function preCompactHook() {
+    try {
+        // Read hook data from stdin (Claude Code sends JSON)
+        let inputData = '';
+        // Set up stdin to read data
+        process.stdin.setEncoding('utf8');
+        // Collect all input data
+        for await (const chunk of process.stdin) {
+            inputData += chunk;
+        }
+        // Parse the JSON input
+        let transcriptPath;
+        if (inputData) {
+            try {
+                const hookData = JSON.parse(inputData);
+                transcriptPath = hookData.transcript_path;
+            }
+            catch (parseError) {
+                // If JSON parsing fails, treat the input as a direct path
+                transcriptPath = inputData.trim();
+            }
+        }
+        // Fallback to environment variable or command line argument
+        if (!transcriptPath) {
+            transcriptPath = process.env.TRANSCRIPT_PATH || process.argv[2];
+        }
+        if (!transcriptPath) {
+            console.log('🗜️ Compressing session transcript...');
+            console.log('❌ No transcript path provided to pre-compact hook');
+            console.log('Hook data received:', inputData || 'none');
+            console.log('Environment TRANSCRIPT_PATH:', process.env.TRANSCRIPT_PATH || 'not set');
+            console.log('Command line args:', process.argv.slice(2));
+            return;
+        }
+        // Run compression with the transcript path
+        await compress(transcriptPath, { dryRun: false });
+    }
+    catch (error) {
+        console.error('Pre-compact hook failed:', error.message);
+        process.exit(1);
+    }
+}
+/**
+ * Session-start hook handler
+ * Loads context for the new session
+ */
+export async function sessionStartHook() {
+    try {
+        // Load context with session-start format
+        await loadContext({ format: 'session-start', count: '10' });
+    }
+    catch (error) {
+        console.error('Session-start hook failed:', error.message);
+        process.exit(1);
+    }
+}
+/**
+ * Session-end hook handler
+ * Compresses session transcript when ending with /clear
+ */
+export async function sessionEndHook() {
+    try {
+        // Read hook data from stdin (Claude Code sends JSON)
+        let inputData = '';
+        // Set up stdin to read data
+        process.stdin.setEncoding('utf8');
+        // Collect all input data
+        for await (const chunk of process.stdin) {
+            inputData += chunk;
+        }
+        // Parse the JSON input to check the reason for session end
+        if (inputData) {
+            try {
+                const hookData = JSON.parse(inputData);
+                // If reason is "clear", compress the session transcript before it's deleted
+                if (hookData.reason === 'clear' && hookData.transcript_path) {
+                    console.log('🗜️ Compressing current session before /clear...');
+                    await compress(hookData.transcript_path, { dryRun: false });
+                }
+            }
+            catch (parseError) {
+                // If JSON parsing fails, log but don't fail the hook
+                console.error('Failed to parse hook data:', parseError);
+            }
+        }
+        console.log('Session ended successfully');
+    }
+    catch (error) {
+        console.error('Session-end hook failed:', error.message);
+        process.exit(1);
+    }
+}