claude-mem 3.2.0 → 3.2.1

package/dist/prompts/constants.js

@@ -1,161 +0,0 @@
-/**
- * Claude Memory System - Prompt-Related Constants and Templates
- *
- * This file contains all prompts, instructions, and output templates
- * for the analysis and context priming system.
- */
-import * as HookTemplates from './templates/hooks/HookTemplates.js';
-// =============================================================================
-// ANALYSIS PROMPTS AND TEMPLATES
-// =============================================================================
-/**
- * Entity naming patterns for the knowledge graph
- */
-export const ENTITY_NAMING_PATTERNS = {
-    component: "Component_Name",
-    decision: "Decision_Name",
-    pattern: "Pattern_Name",
-    tool: "Tool_Name",
-    fix: "Fix_Name",
-    workflow: "Workflow_Name"
-};
-/**
- * Available entity types for classification
- */
-export const ENTITY_TYPES = {
-    component: "component", // UI components, modules, services
-    pattern: "pattern", // Architectural or design patterns
-    workflow: "workflow", // Processes, pipelines, sequences
-    integration: "integration", // APIs, external services, data sources
-    concept: "concept", // Abstract ideas, methodologies, principles
-    decision: "decision", // Design choices, trade-offs, solutions
-    tool: "tool", // Utilities, libraries, development tools
-    fix: "fix" // Bug fixes, patches, workarounds
-};
-/**
- * Standard observation fields for entities
- */
-export const OBSERVATION_FIELDS = [
-    "Core purpose: [what it fundamentally does]",
-    "Brief description: [one-line summary for session-start display]",
-    "Implementation: [key technical details, code patterns]",
-    "Dependencies: [what it requires or builds upon]",
-    "Usage context: [when/why it's used]",
-    "Performance characteristics: [speed, reliability, constraints]",
-    "Integration points: [how it connects to other systems]",
-    "Keywords: [searchable terms for this concept]",
-    "Decision rationale: [why this approach was chosen]",
-    "Next steps: [what needs to be done next with this component]",
-    "Files modified: [list of files changed]",
-    "Tools used: [development tools/commands used]"
-];
-/**
- * Relationship types for creating meaningful entity connections
- */
-export const RELATIONSHIP_TYPES = [
-    "executes_via", "orchestrates_through", "validates_using",
-    "provides_auth_to", "manages_state_for", "processes_events_from",
-    "caches_data_from", "routes_requests_to", "transforms_data_for",
-    "extends", "enhances_performance_of", "builds_upon",
-    "fixes_issue_in", "replaces", "optimizes",
-    "triggers_tool", "receives_result_from"
-];
-// =============================================================================
-// CONTEXT PRIMING TEMPLATES
-// =============================================================================
-/**
- * System message templates for context priming
- */
-export const CONTEXT_TEMPLATES = {
-    PRIMARY_CONTEXT: (projectName) => `Context primed for project: ${projectName}. Access memories with chroma_query_documents(["${projectName}*"]) or chroma_get_documents(["document_id"]).`,
-    RECENT_SESSIONS: (sessionList) => `Recent sessions available: ${sessionList}`,
-    AVAILABLE_ENTITIES: (type, entities, hasMore, moreCount) => `Available ${type} entities: ${entities.join(', ')}${hasMore ? ` (+${moreCount} more)` : ''}`,
-    SESSION_START_HEADER: '🧠 Active Working Context from Previous Sessions:',
-    SESSION_START_SEPARATOR: '═'.repeat(70),
-    RESUME_INSTRUCTIONS: `💡 TO RESUME: Load active components with chroma_get_documents(["<exact_document_ids>"])
-📊 TO EXPLORE: Search related work with chroma_query_documents(["<keywords>"])`
-};
-// =============================================================================
-// SESSION START OUTPUT TEMPLATES  
-// =============================================================================
-/**
- * Session start formatting templates
- */
-export const SESSION_START_TEMPLATES = {
-    FOCUS_LINE: (focus) => `📌 CURRENT FOCUS: ${focus}`,
-    LAST_WORKED: (timeAgo, projectName) => `Last worked: ${timeAgo} | Project: ${projectName}`,
-    SECTIONS: {
-        COMPONENTS: '🎯 ACTIVE COMPONENTS (load these for context):',
-        DECISIONS: '🔄 RECENT DECISIONS & PATTERNS:',
-        TOOLS: '🛠️ TOOLS & INFRASTRUCTURE:',
-        FIXES: '🐛 RECENT FIXES:',
-        ACTIONS: '⚡ NEXT ACTIONS:'
-    },
-    ACTION_PREFIX: '□ ',
-    ENTITY_BULLET: '• '
-};
-/**
- * Time formatting for "time ago" displays
- */
-export const TIME_FORMATS = {
-    JUST_NOW: 'just now',
-    HOURS_AGO: (hours) => `${hours} hour${hours > 1 ? 's' : ''} ago`,
-    DAYS_AGO: (days) => `${days} day${days > 1 ? 's' : ''} ago`,
-    RECENTLY: 'recently'
-};
-// =============================================================================
-// HOOK RESPONSE TEMPLATES
-// =============================================================================
-/**
- * Standard hook response structures for Claude Code integration
- */
-export const HOOK_RESPONSES = {
-    SUCCESS: (hookEventName, message) => ({
-        hookSpecificOutput: {
-            hookEventName,
-            status: "success",
-            message
-        },
-        suppressOutput: true
-    }),
-    SKIPPED: (hookEventName, message) => ({
-        hookSpecificOutput: {
-            hookEventName,
-            status: "skipped",
-            message
-        },
-        suppressOutput: true
-    }),
-    BLOCKED: (reason) => ({
-        decision: "block",
-        reason
-    }),
-    CONTINUE: (hookEventName, additionalContext) => ({
-        continue: true,
-        ...(additionalContext && {
-            hookSpecificOutput: {
-                hookEventName,
-                additionalContext
-            }
-        })
-    }),
-    ERROR: (reason) => ({
-        decision: "block",
-        reason
-    })
-};
-/**
- * Pre-defined hook messages
- */
-export const HOOK_MESSAGES = {
-    COMPRESSION_SUCCESS: "Memory compression completed successfully",
-    COMPRESSION_FAILED: (stderr) => `Compression failed: ${stderr}`,
-    CONTEXT_LOADED: "Project context loaded successfully",
-    CONTEXT_SKIPPED: "Continuing session - context loading skipped",
-    NO_TRANSCRIPT: "No transcript path provided",
-    HOOK_ERROR: (error) => `Hook error: ${error}`
-};
-/**
- * Export hook templates for direct usage
- */
-export { HookTemplates };

package/dist/prompts/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Prompts Module - Single source of truth for all prompt generation
- *
- * This module provides a centralized system for generating prompts across
- * the claude-mem system. It includes the core PromptOrchestrator class
- * and all related TypeScript interfaces.
- */
-export type { AnalysisContext, SessionContext, HookContext, AnalysisPrompt, SessionPrompt, HookResponse, } from '../core/orchestration/PromptOrchestrator.js';
-export { PromptOrchestrator, } from '../core/orchestration/PromptOrchestrator.js';
-export { createPromptOrchestrator, createAnalysisContext, createSessionContext, createHookContext, } from '../core/orchestration/PromptOrchestrator.js';

package/dist/prompts/index.js

@@ -1,11 +0,0 @@
-/**
- * Prompts Module - Single source of truth for all prompt generation
- *
- * This module provides a centralized system for generating prompts across
- * the claude-mem system. It includes the core PromptOrchestrator class
- * and all related TypeScript interfaces.
- */
-// Export the main class
-export { PromptOrchestrator, } from '../core/orchestration/PromptOrchestrator.js';
-// Export factory functions
-export { createPromptOrchestrator, createAnalysisContext, createSessionContext, createHookContext, } from '../core/orchestration/PromptOrchestrator.js';

package/dist/prompts/templates/analysis/AnalysisTemplates.d.ts

@@ -1,13 +0,0 @@
-/**
- * Analysis Templates for LLM Instructions
- *
- * Generates prompts for extracting memories from conversations and storing in Chroma
- */
-/**
- * Creates the comprehensive analysis prompt for memory extraction
- */
-export declare function buildComprehensiveAnalysisPrompt(projectPrefix: string, sessionId: string, timestamp?: string, archiveFilename?: string): string;
-/**
- * Creates the analysis prompt
- */
-export declare function createAnalysisPrompt(transcript: string, sessionId: string, projectPrefix: string, timestamp?: string): string;

package/dist/prompts/templates/analysis/AnalysisTemplates.js

@@ -1,94 +0,0 @@
-/**
- * Analysis Templates for LLM Instructions
- *
- * Generates prompts for extracting memories from conversations and storing in Chroma
- */
-import Handlebars from 'handlebars';
-// =============================================================================
-// MAIN ANALYSIS PROMPT TEMPLATE
-// =============================================================================
-const ANALYSIS_PROMPT = `You are analyzing a Claude Code conversation transcript to create memories using the Chroma MCP memory system.
-
-YOUR TASK:
-1. Extract key learnings and accomplishments as natural language memories
-2. Store memories using mcp__claude-mem__chroma_add_documents
-3. Return a structured JSON response with the extracted summaries
-
-WHAT TO EXTRACT:
-- Technical implementations (functions, classes, APIs, databases)
-- Design patterns and architectural decisions
-- Bug fixes and problem solutions
-- Workflows, processes, and integrations
-- Performance optimizations and improvements
-
-STORAGE INSTRUCTIONS:
-Call mcp__claude-mem__chroma_add_documents with:
-- collection_name: "claude_memories"
-- documents: Array of natural language descriptions
-- ids: ["{{projectPrefix}}_{{sessionId}}_1", "{{projectPrefix}}_{{sessionId}}_2", ...]
-- metadatas: Array with fields:
-  * type: component/pattern/workflow/integration/concept/decision/tool/fix
-  * keywords: Comma-separated search terms
-  * context: Brief situation description
-  * timestamp: "{{timestamp}}"
-  * session_id: "{{sessionId}}"
-
-ERROR HANDLING:
-If you get "IDs already exist" errors, use mcp__claude-mem__chroma_update_documents instead.
-If any tool calls fail, continue and return the JSON response anyway.
-
-Project: {{projectPrefix}}
-Session ID: {{sessionId}}
-
-Conversation to compress:`;
-// Compile template once
-const compiledAnalysisPrompt = Handlebars.compile(ANALYSIS_PROMPT, { noEscape: true });
-// =============================================================================
-// MAIN API FUNCTIONS
-// =============================================================================
-/**
- * Creates the comprehensive analysis prompt for memory extraction
- */
-export function buildComprehensiveAnalysisPrompt(projectPrefix, sessionId, timestamp, archiveFilename) {
-    const context = {
-        projectPrefix,
-        sessionId,
-        timestamp: timestamp || new Date().toISOString(),
-        archiveFilename: archiveFilename || `${sessionId}.jsonl.archive`
-    };
-    return compiledAnalysisPrompt(context);
-}
-/**
- * Creates the analysis prompt
- */
-export function createAnalysisPrompt(transcript, sessionId, projectPrefix, timestamp) {
-    const prompt = buildComprehensiveAnalysisPrompt(projectPrefix, sessionId, timestamp);
-    const responseFormat = `
-
-RESPONSE FORMAT:
-After storing memories in Chroma, return EXACTLY this JSON structure wrapped in tags:
-
-<JSONResponse>
-{
-  "overview": "2-3 sentence summary of session themes and accomplishments. Write for any developer to understand by organically defining jargon.",
-  "summaries": [
-    {
-      "text": "What was accomplished (start with action verb)",
-      "document_id": "${projectPrefix}_${sessionId}_1",
-      "keywords": "comma, separated, terms",
-      "timestamp": "${timestamp || new Date().toISOString()}",
-      "archive": "${sessionId}.jsonl.archive"
-    }
-  ]
-}
-</JSONResponse>
-
-IMPORTANT:
-- Return 3-10 summaries based on conversation complexity
-- Each summary should correspond to a memory you attempted to store
-- If tool calls fail, still return the JSON response with summaries
-- The JSON must be valid and complete
-- Place NOTHING outside the <JSONResponse> tags
-- Do not include any explanatory text before or after the JSON`;
-    return prompt + '\n\n' + transcript + responseFormat;
-}

package/dist/prompts/templates/context/ContextTemplates.d.ts

@@ -1,119 +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.
- */
-/**
- * Creates a welcoming session start message explaining what memories were loaded
- */
-export declare function createSessionStartMessage(projectName: string, memoryCount: number, lastSessionTime?: string): string;
-/**
- * Creates a loading message during context retrieval
- */
-export declare function createLoadingMessage(operation: string): string;
-/**
- * Creates a completion message after context operations
- */
-export declare function createCompletionMessage(operation: string, count?: number, details?: string): string;
-/**
- * Creates user-friendly error messages with helpful suggestions
- */
-export declare function createUserFriendlyError(operation: string, error: string, suggestion?: string): string;
-/**
- * Common error scenarios with built-in suggestions
- */
-export declare const ERROR_SCENARIOS: {
-    NO_MEMORIES: (projectName: string) => {
-        message: string;
-        suggestion: string;
-    };
-    CONNECTION_FAILED: () => {
-        message: string;
-        suggestion: string;
-    };
-    SEARCH_FAILED: (query: string) => {
-        message: string;
-        suggestion: string;
-    };
-    LOAD_TIMEOUT: () => {
-        message: string;
-        suggestion: string;
-    };
-};
-/**
- * Creates contextual error messages based on common scenarios
- */
-export declare function createContextualError(scenario: keyof typeof ERROR_SCENARIOS, ...args: string[]): string;
-/**
- * Formats timestamps into human-readable "time ago" format
- */
-export declare function formatTimeAgo(timestamp: string | Date): string;
-/**
- * Creates summary text for memory operations
- */
-export declare function createOperationSummary(operation: 'compress' | 'load' | 'search' | 'archive', results: {
-    count: number;
-    duration?: number;
-    details?: string;
-}): string;
-/**
- * Interface for memory entry data structure
- */
-interface MemoryEntry {
-    summary: string;
-    keywords?: string;
-    location?: string;
-    sessionId?: string;
-    number?: number;
-}
-/**
- * Formats current date and time for session start
- */
-export declare function formatCurrentDateTime(): string;
-/**
- * Extracts overview section from JSON objects
- * Looks for objects with type "overview" and matching project
- */
-export declare function extractOverview(recentObjects: any[], projectName?: string): string | null;
-/**
- * Interface for overview with timestamp
- */
-interface OverviewEntry {
-    content: string;
-    timestamp?: Date;
-    timeAgo?: string;
-}
-/**
- * Extracts multiple overviews with timestamps
- * Returns up to 'count' most recent overviews
- */
-export declare function extractOverviews(recentObjects: any[], count?: number, projectName?: string): OverviewEntry[];
-/**
- * Pure data processing function - converts JSON objects into structured memory entries
- * No formatting is done here, only data parsing and cleaning
- */
-export declare function processMemoryEntries(recentObjects: any[]): MemoryEntry[];
-/**
- * Renders the complete session start template with provided data using Handlebars
- * Data processing is separated from presentation - template controls the format
- */
-export declare function renderSessionStartTemplate(params: {
-    projectName: string;
-    memoryCount: number;
-    lastSessionTime?: string;
-    recentObjects: any[];
-}): string;
-/**
- * Outputs session start content using dual streams:
- * - stdout (console.log) -> Claude's context only (granular memories)
- * - stderr (console.error) -> User visible (clean overviews)
- */
-export declare function outputSessionStartContent(params: {
-    projectName: string;
-    memoryCount: number;
-    lastSessionTime?: string;
-    recentObjects: any[];
-}): void;
-export {};