claude-mem 3.2.0 → 3.2.2

package/dist/prompts/templates/context/ContextTemplates.js

@@ -1,399 +0,0 @@
-/**
- * Context Templates for Human-Readable Formatting
- *
- * Essential templates for user-facing messages in the memory system.
- * Focused on session start messages, error handling, and operation feedback.
- * Now uses Handlebars templating for proper separation of data and presentation.
- */
-import Handlebars from 'handlebars';
-import { formatRelativeTime, parseTimestamp } from '../../../lib/time-utils.js';
-// =============================================================================
-// MAIN SESSION START TEMPLATE - Edit this to change the output format
-// =============================================================================
-const SESSION_START_FULL_TEMPLATE = `🧠 What's new: {{dateTime}}
-====================================================================
-{{#if overview}}{{overview}}{{/if}}
-
-📚 Recent Context 
-====================================================================
-{{#if hasMemories}}
-{{#each sessionGroups}}
-👀 in {{sessionId}}:
-
-{{#each memories}}
-{{number}}. {{summary}}
-    — {{keywords}}
-
-{{/each}}
-======================================================================
-{{/each}}
-{{else}}
-No relevant memories found - this appears to be your first session or a new project area.
-
-💡 Getting Started:
-• Start working and memories will be automatically created
-• At the end of your session, ask to compress and store the conversation
-• Next time you return, relevant context will be loaded automatically
-{{/if}}`;
-// NEW: Layered template that shows overviews to user and hides granular memories in comments
-const SESSION_START_LAYERED_TEMPLATE = `🧠 What's new: {{dateTime}}
-====================================================================
-{{#if hasOverviews}}
-{{#each overviews}}
-📅 {{timeAgo}}:
-{{content}}
-
-{{/each}}
-{{else}}
-This appears to be your first session. Context will be automatically captured as you work.
-
-💡 Getting Started:
-• Start working and memories will be automatically created
-• At the end of your session, ask to compress and store the conversation
-• Next time you return, relevant context will be loaded automatically
-{{/if}}
-====================================================================
-{{#if hasMemories}}<!-- CONTEXT-DATA
-{{#each sessionGroups}}
-👀 in {{sessionId}}:
-
-{{#each memories}}
-{{number}}. {{summary}}
-    — {{keywords}}
-
-{{/each}}
-======================================================================
-{{/each}}
-END-CONTEXT-DATA -->{{/if}}`;
-// Compile the template once for performance
-const compiledSessionTemplate = Handlebars.compile(SESSION_START_FULL_TEMPLATE, { noEscape: true });
-const compiledLayeredTemplate = Handlebars.compile(SESSION_START_LAYERED_TEMPLATE, { noEscape: true });
-// =============================================================================
-// SESSION START MESSAGES
-// =============================================================================
-/**
- * Creates a welcoming session start message explaining what memories were loaded
- */
-export function createSessionStartMessage(projectName, memoryCount, lastSessionTime) {
-    const timeInfo = lastSessionTime ? ` (last worked: ${lastSessionTime})` : '';
-    if (memoryCount === 0) {
-        return `🧠 Loading memories from previous sessions for ${projectName}${timeInfo}
-
-No relevant memories found - this appears to be your first session or a new project area.
-
-💡 Getting Started:
-• Start working and memories will be automatically created
-• At the end of your session, ask to compress and store the conversation
-• Next time you return, relevant context will be loaded automatically`;
-    }
-    const memoryText = memoryCount === 1 ? 'relevant memory' : 'relevant memories';
-    return `🧠 Loading memories from previous sessions for ${projectName}${timeInfo}
-
-Found ${memoryCount} ${memoryText} to help continue your work.`;
-}
-// =============================================================================
-// OPERATION MESSAGES
-// =============================================================================
-/**
- * Creates a loading message during context retrieval
- */
-export function createLoadingMessage(operation) {
-    const operations = {
-        'searching': '🔍 Searching previous memories...',
-        'loading': '📚 Loading relevant context...',
-        'formatting': '✨ Organizing memories for display...',
-        'compressing': '🗜️ Compressing session transcript...',
-        'archiving': '📦 Archiving conversation...'
-    };
-    return operations[operation] || `⏳ ${operation}...`;
-}
-/**
- * Creates a completion message after context operations
- */
-export function createCompletionMessage(operation, count, details) {
-    const countInfo = count !== undefined ? ` (${count} items)` : '';
-    const detailInfo = details ? `\n${details}` : '';
-    return `✅ ${operation} completed successfully${countInfo}${detailInfo}`;
-}
-// =============================================================================
-// ERROR MESSAGES (USER-FRIENDLY)
-// =============================================================================
-/**
- * Creates user-friendly error messages with helpful suggestions
- */
-export function createUserFriendlyError(operation, error, suggestion) {
-    const suggestionText = suggestion ? `\n\n💡 ${suggestion}` : '';
-    return `❌ ${operation} encountered an issue: ${error}${suggestionText}`;
-}
-/**
- * Common error scenarios with built-in suggestions
- */
-export const ERROR_SCENARIOS = {
-    NO_MEMORIES: (projectName) => ({
-        message: `No previous memories found for ${projectName}`,
-        suggestion: "This appears to be your first session. Memories will be created as you work."
-    }),
-    CONNECTION_FAILED: () => ({
-        message: "Could not connect to memory system",
-        suggestion: "Try restarting Claude Code or check if the MCP server is properly configured."
-    }),
-    SEARCH_FAILED: (query) => ({
-        message: `Search for "${query}" didn't return any results`,
-        suggestion: "Try using different keywords or check if memories exist for this project."
-    }),
-    LOAD_TIMEOUT: () => ({
-        message: "Memory loading timed out",
-        suggestion: "The operation is taking longer than expected. You can continue without loaded context."
-    })
-};
-/**
- * Creates contextual error messages based on common scenarios
- */
-export function createContextualError(scenario, ...args) {
-    const errorInfo = ERROR_SCENARIOS[scenario](...args);
-    return createUserFriendlyError('Memory system', errorInfo.message, errorInfo.suggestion);
-}
-// =============================================================================
-// TIME AND DATE FORMATTING
-// =============================================================================
-/**
- * Formats timestamps into human-readable "time ago" format
- */
-export function formatTimeAgo(timestamp) {
-    const date = typeof timestamp === 'string' ? new Date(timestamp) : timestamp;
-    const now = new Date();
-    const diff = now.getTime() - date.getTime();
-    const minutes = Math.floor(diff / 60000);
-    const hours = Math.floor(diff / 3600000);
-    const days = Math.floor(diff / 86400000);
-    if (minutes < 1)
-        return 'just now';
-    if (minutes < 60)
-        return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;
-    if (hours < 24)
-        return `${hours} hour${hours > 1 ? 's' : ''} ago`;
-    if (days < 7)
-        return `${days} day${days > 1 ? 's' : ''} ago`;
-    return date.toLocaleDateString();
-}
-/**
- * Creates summary text for memory operations
- */
-export function createOperationSummary(operation, results) {
-    const { count, duration, details } = results;
-    const durationText = duration ? ` in ${duration}ms` : '';
-    const detailsText = details ? ` - ${details}` : '';
-    const templates = {
-        compress: `Compressed ${count} conversation turns${durationText}${detailsText}`,
-        load: `Loaded ${count} relevant memories${durationText}${detailsText}`,
-        search: `Found ${count} matching memories${durationText}${detailsText}`,
-        archive: `Archived ${count} conversation segments${durationText}${detailsText}`
-    };
-    return `📊 ${templates[operation]}`;
-}
-/**
- * Formats current date and time for session start
- */
-export function formatCurrentDateTime() {
-    const now = new Date();
-    const currentDateTime = now.toLocaleString('en-US', {
-        weekday: 'long',
-        year: 'numeric',
-        month: 'long',
-        day: 'numeric',
-        hour: '2-digit',
-        minute: '2-digit',
-        timeZoneName: 'short'
-    });
-    return `Current Date / Time: ${currentDateTime}\n`;
-}
-/**
- * Extracts overview section from JSON objects
- * Looks for objects with type "overview" and matching project
- */
-export function extractOverview(recentObjects, projectName) {
-    // Find overview objects
-    const overviewObjects = recentObjects.filter(obj => obj.type === 'overview');
-    if (overviewObjects.length === 0) {
-        return null;
-    }
-    // If project is specified, find overview for that project
-    if (projectName) {
-        const sanitizedProject = projectName.replace(/-/g, '_');
-        const projectOverview = overviewObjects.find(obj => obj.project === sanitizedProject || obj.project === projectName);
-        if (projectOverview) {
-            return projectOverview.content;
-        }
-    }
-    // Return the most recent overview if no project match
-    return overviewObjects[overviewObjects.length - 1]?.content || null;
-}
-/**
- * Extracts multiple overviews with timestamps
- * Returns up to 'count' most recent overviews
- */
-export function extractOverviews(recentObjects, count = 3, projectName) {
-    // Find overview objects
-    const overviewObjects = recentObjects.filter(obj => obj.type === 'overview');
-    if (overviewObjects.length === 0) {
-        return [];
-    }
-    // Filter by project if specified
-    let filteredOverviews = overviewObjects;
-    if (projectName) {
-        const sanitizedProject = projectName.replace(/-/g, '_');
-        filteredOverviews = overviewObjects.filter(obj => obj.project === sanitizedProject || obj.project === projectName);
-        // Fall back to all overviews if no project match
-        if (filteredOverviews.length === 0) {
-            filteredOverviews = overviewObjects;
-        }
-    }
-    // Take the last 'count' overviews
-    const recentOverviews = filteredOverviews.slice(-count);
-    // Process each overview with timestamp
-    return recentOverviews.map(obj => {
-        const entry = {
-            content: obj.content || ''
-        };
-        // Try to parse timestamp
-        const timestamp = parseTimestamp(obj);
-        if (timestamp) {
-            entry.timestamp = timestamp;
-            entry.timeAgo = formatRelativeTime(timestamp);
-        }
-        else {
-            // Fallback if no timestamp
-            entry.timeAgo = 'Recently';
-        }
-        return entry;
-    }); // Show oldest first
-}
-/**
- * Pure data processing function - converts JSON objects into structured memory entries
- * No formatting is done here, only data parsing and cleaning
- */
-export function processMemoryEntries(recentObjects) {
-    if (recentObjects.length === 0) {
-        return [];
-    }
-    // Filter only memory type objects and convert to MemoryEntry format
-    return recentObjects
-        .filter(obj => obj.type === 'memory')
-        .map(obj => {
-        const entry = {
-            summary: obj.text || '',
-            sessionId: obj.session_id || ''
-        };
-        // Add optional fields if present
-        if (obj.keywords) {
-            entry.keywords = obj.keywords;
-        }
-        if (obj.document_id && !obj.document_id.includes('Session:')) {
-            entry.location = obj.document_id;
-        }
-        return entry;
-    })
-        .filter(entry => entry.summary.length > 0);
-}
-/**
- * Groups memories by session ID and adds numbering
- */
-function groupMemoriesBySession(memories) {
-    const sessionMap = new Map();
-    // Group memories by session ID
-    memories.forEach(memory => {
-        const sessionId = memory.sessionId;
-        if (sessionId) {
-            if (!sessionMap.has(sessionId)) {
-                sessionMap.set(sessionId, []);
-            }
-            sessionMap.get(sessionId).push(memory);
-        }
-    });
-    // Convert to session groups with numbering, reverse to show oldest sessions first
-    return Array.from(sessionMap.entries()).map(([sessionId, sessionMemories]) => {
-        const numberedMemories = sessionMemories.map((memory, index) => ({
-            ...memory,
-            number: index + 1
-        }));
-        return {
-            sessionId,
-            memories: numberedMemories
-        };
-    }).reverse();
-}
-/**
- * Renders the complete session start template with provided data using Handlebars
- * Data processing is separated from presentation - template controls the format
- */
-export function renderSessionStartTemplate(params) {
-    const { projectName, memoryCount, lastSessionTime, recentObjects } = params;
-    // Extract overview and process memory entries separately
-    const overview = extractOverview(recentObjects, projectName);
-    const memories = processMemoryEntries(recentObjects);
-    // Group memories by session
-    const sessionGroups = groupMemoriesBySession(memories);
-    // Prepare template data - just pass data, let template control format
-    const templateData = {
-        dateTime: new Date().toLocaleString('en-US', {
-            weekday: 'long',
-            year: 'numeric',
-            month: 'long',
-            day: 'numeric',
-            hour: '2-digit',
-            minute: '2-digit',
-            timeZoneName: 'short'
-        }),
-        projectName,
-        lastSessionTime: lastSessionTime || 'recently',
-        memoryCount,
-        memoryText: memoryCount === 1 ? 'memory' : 'memories',
-        hasMemories: memories.length > 0 || overview !== null,
-        overview,
-        sessionGroups
-    };
-    // Let Handlebars handle the rendering with proper loops and conditionals
-    return compiledSessionTemplate(templateData);
-}
-/**
- * Outputs session start content to stdout:
- * - Shows clean overviews first for user visibility
- * - Followed by detailed memories for Claude's context
- */
-export function outputSessionStartContent(params) {
-    const { projectName, memoryCount, lastSessionTime, recentObjects } = params;
-    // Extract overviews for user display
-    const overviews = extractOverviews(recentObjects, 3, projectName);
-    // Process memory entries for Claude context
-    const memories = processMemoryEntries(recentObjects);
-    // Detailed memories for context (shown first)
-    if (memories.length > 0) {
-        const sessionGroups = groupMemoriesBySession(memories);
-        console.log('📚 Recent Context');
-        console.log('====================================================================');
-        sessionGroups.forEach(group => {
-            console.log(`👀 in ${group.sessionId}:`);
-            console.log('');
-            group.memories.forEach(memory => {
-                console.log(`${memory.number}. ${memory.summary}`);
-                console.log(`    — ${memory.keywords}`);
-                console.log('');
-            });
-        });
-        console.log('======================================================================');
-    }
-    // User-visible overviews (shown at bottom)
-    if (overviews.length > 0) {
-        console.log('🧠 What\'s new:');
-        console.log('====================================================================');
-        overviews.forEach(overview => {
-            console.log(`📅 ${overview.timeAgo}:`);
-            console.log(overview.content);
-            console.log('');
-        });
-        console.log('====================================================================');
-    }
-    else if (memories.length === 0) {
-        console.log(`🧠 No recent context found for ${projectName}`);
-    }
-}

package/dist/prompts/templates/hooks/HookTemplates.d.ts

@@ -1,175 +0,0 @@
-/**
- * Hook Templates for System Integration
- *
- * This module provides standardized templates for hook responses that integrate
- * with Claude Code's hook system. These templates ensure consistent formatting
- * and proper JSON structure for different hook events.
- *
- * Based on Claude Code Hook Documentation v2025
- */
-import { BaseHookResponse, PreCompactResponse, SessionStartResponse, PreToolUseResponse } from '../../../shared/types.js';
-/**
- * Context data for generating hook responses
- */
-export interface HookResponseContext {
-    /** The hook event name */
-    hookEventName: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Whether the operation was successful */
-    success: boolean;
-    /** Optional message for the response */
-    message?: string;
-    /** Additional data specific to the hook type */
-    additionalData?: Record<string, unknown>;
-    /** Duration of the operation in milliseconds */
-    duration?: number;
-    /** Number of items processed */
-    itemCount?: number;
-}
-/**
- * Progress information for long-running operations
- */
-export interface OperationProgress {
-    /** Current step number */
-    current: number;
-    /** Total number of steps */
-    total: number;
-    /** Description of current step */
-    currentStep?: string;
-    /** Estimated time remaining in milliseconds */
-    estimatedRemaining?: number;
-}
-/**
- * Creates a successful pre-compact response that allows compression to proceed
- * PreCompact hooks do NOT support hookSpecificOutput according to documentation
- */
-export declare function createPreCompactSuccessResponse(): PreCompactResponse;
-/**
- * Creates a blocked pre-compact response that prevents compression
- */
-export declare function createPreCompactBlockedResponse(reason: string): PreCompactResponse;
-/**
- * Creates a pre-compact response with approval decision
- */
-export declare function createPreCompactApprovalResponse(decision: 'approve' | 'block', reason?: string): PreCompactResponse;
-/**
- * Creates a successful session start response with loaded context
- * SessionStart hooks DO support hookSpecificOutput
- */
-export declare function createSessionStartSuccessResponse(additionalContext?: string): SessionStartResponse;
-/**
- * Creates a session start response when no context is available
- */
-export declare function createSessionStartEmptyResponse(): SessionStartResponse;
-/**
- * Creates a session start response with error information
- */
-export declare function createSessionStartErrorResponse(error: string): SessionStartResponse;
-/**
- * Creates a rich session start response with memory summary
- */
-export declare function createSessionStartMemoryResponse(memoryData: {
-    projectName: string;
-    memoryCount: number;
-    lastSessionTime?: string;
-    recentComponents?: string[];
-    recentDecisions?: string[];
-}): SessionStartResponse;
-/**
- * Creates a pre-tool use response that allows the tool to execute
- */
-export declare function createPreToolUseAllowResponse(reason?: string): PreToolUseResponse;
-/**
- * Creates a pre-tool use response that blocks the tool execution
- */
-export declare function createPreToolUseDenyResponse(reason: string): PreToolUseResponse;
-/**
- * Creates a pre-tool use response that asks for user confirmation
- */
-export declare function createPreToolUseAskResponse(reason: string): PreToolUseResponse;
-/**
- * Creates a basic success response for any hook type
- */
-export declare function createHookSuccessResponse(suppressOutput?: boolean): BaseHookResponse;
-/**
- * Creates a basic error response for any hook type
- */
-export declare function createHookErrorResponse(reason: string, suppressOutput?: boolean): BaseHookResponse;
-/**
- * Creates a response with system message (warning/info for user)
- */
-export declare function createHookSystemMessageResponse(message: string, continueProcessing?: boolean): BaseHookResponse & {
-    systemMessage: string;
-};
-/**
- * Templates for different types of operation status messages
- */
-export declare const OPERATION_STATUS_TEMPLATES: {
-    readonly COMPRESSION_STARTED: "Starting memory compression...";
-    readonly COMPRESSION_ANALYZING: "Analyzing transcript content...";
-    readonly COMPRESSION_EXTRACTING: "Extracting memories and connections...";
-    readonly COMPRESSION_SAVING: "Saving compressed memories...";
-    readonly COMPRESSION_COMPLETE: (count: number, duration?: number) => string;
-    readonly CONTEXT_LOADING: "Loading previous session context...";
-    readonly CONTEXT_SEARCHING: "Searching for relevant memories...";
-    readonly CONTEXT_FORMATTING: "Organizing context for display...";
-    readonly CONTEXT_LOADED: (count: number) => string;
-    readonly CONTEXT_EMPTY: "No previous context found. Starting fresh session";
-    readonly TOOL_CHECKING: (toolName: string) => string;
-    readonly TOOL_ALLOWED: (toolName: string) => string;
-    readonly TOOL_BLOCKED: (toolName: string, reason: string) => string;
-    readonly OPERATION_STARTING: (operation: string) => string;
-    readonly OPERATION_PROGRESS: (operation: string, current: number, total: number) => string;
-    readonly OPERATION_COMPLETE: (operation: string) => string;
-    readonly OPERATION_FAILED: (operation: string, error: string) => string;
-};
-/**
- * Creates a progress message for long-running operations
- */
-export declare function createProgressMessage(operation: string, progress: OperationProgress): string;
-/**
- * Standard error messages for different failure scenarios
- */
-export declare const ERROR_RESPONSE_TEMPLATES: {
-    readonly FILE_NOT_FOUND: (path: string) => string;
-    readonly FILE_READ_ERROR: (path: string, error: string) => string;
-    readonly FILE_WRITE_ERROR: (path: string, error: string) => string;
-    readonly CONNECTION_FAILED: (service: string) => string;
-    readonly CONNECTION_TIMEOUT: (service: string) => string;
-    readonly INVALID_PAYLOAD: (field: string) => string;
-    readonly INVALID_FORMAT: (expected: string, received: string) => string;
-    readonly OPERATION_TIMEOUT: (operation: string, timeout: number) => string;
-    readonly OPERATION_CANCELLED: (operation: string) => string;
-    readonly INSUFFICIENT_PERMISSIONS: (operation: string) => string;
-    readonly MEMORY_SYSTEM_UNAVAILABLE: "Memory system is not available";
-    readonly MEMORY_CORRUPTION: "Memory index appears to be corrupted";
-    readonly MEMORY_SEARCH_FAILED: (query: string) => string;
-    readonly COMPRESSION_FAILED: (stage: string) => string;
-    readonly INVALID_TRANSCRIPT: "Transcript file is invalid or corrupted";
-    readonly UNKNOWN_ERROR: (context: string) => string;
-    readonly SYSTEM_ERROR: (error: string) => string;
-};
-/**
- * Creates a standardized error response with troubleshooting guidance
- */
-export declare function createDetailedErrorResponse(operation: string, error: string, troubleshootingSteps?: string[]): BaseHookResponse;
-/**
- * Validates that a hook response conforms to Claude Code expectations
- */
-export declare function validateHookResponse(response: any, hookType: string): {
-    isValid: boolean;
-    errors: string[];
-};
-/**
- * Creates a hook response based on context and automatically handles hook-specific formatting
- */
-export declare function createContextualHookResponse(context: HookResponseContext): BaseHookResponse;
-/**
- * Formats duration in milliseconds to human-readable format
- */
-export declare function formatDuration(milliseconds: number): string;
-/**
- * Creates a summary line for operation completion
- */
-export declare function createOperationSummary(operation: string, success: boolean, duration?: number, itemCount?: number, details?: string): string;