claude-mem 3.2.0 → 3.2.2

package/dist/core/orchestration/PromptOrchestrator.d.ts

@@ -1,165 +0,0 @@
-/**
- * PromptOrchestrator - Single source of truth for all prompt generation
- *
- * This class serves as the central orchestrator for generating different types of prompts
- * used throughout the claude-mem system. It provides clear, well-typed interfaces and
- * methods for creating prompts for LLM analysis, human context, and system integration.
- */
-/**
- * Context data for LLM analysis prompts
- */
-export interface AnalysisContext {
-    /** The transcript content to analyze */
-    transcriptContent: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Project name for context */
-    projectName?: string;
-    /** Custom analysis instructions */
-    customInstructions?: string;
-    /** Compression trigger type */
-    trigger?: 'manual' | 'auto';
-    /** Original token count */
-    originalTokens?: number;
-    /** Target compression ratio */
-    targetCompressionRatio?: number;
-}
-/**
- * Context data for human-facing session prompts
- */
-export interface SessionContext {
-    /** Session identifier */
-    sessionId: string;
-    /** Source of the session start */
-    source: 'startup' | 'compact' | 'vscode' | 'web';
-    /** Project name */
-    projectName?: string;
-    /** Additional context to provide to the human */
-    additionalContext?: string;
-    /** Path to the transcript file */
-    transcriptPath?: string;
-    /** Working directory */
-    cwd?: string;
-}
-/**
- * Context data for hook response generation
- */
-export interface HookContext {
-    /** The hook event name */
-    hookEventName: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Success status */
-    success: boolean;
-    /** Optional message */
-    message?: string;
-    /** Additional data specific to the hook */
-    data?: Record<string, unknown>;
-    /** Whether to continue processing */
-    shouldContinue?: boolean;
-    /** Reason for stopping if applicable */
-    stopReason?: string;
-}
-/**
- * Generated analysis prompt for LLM consumption
- */
-export interface AnalysisPrompt {
-    /** The formatted prompt text */
-    prompt: string;
-    /** Context used to generate the prompt */
-    context: AnalysisContext;
-    /** Prompt type identifier */
-    type: 'analysis';
-    /** Generated timestamp */
-    timestamp: string;
-}
-/**
- * Generated session prompt for human context
- */
-export interface SessionPrompt {
-    /** The formatted message text */
-    message: string;
-    /** Context used to generate the prompt */
-    context: SessionContext;
-    /** Prompt type identifier */
-    type: 'session';
-    /** Generated timestamp */
-    timestamp: string;
-}
-/**
- * Generated hook response
- */
-export interface HookResponse {
-    /** Whether to continue processing */
-    continue: boolean;
-    /** Reason for stopping if continue is false */
-    stopReason?: string;
-    /** Whether to suppress output */
-    suppressOutput?: boolean;
-    /** Hook-specific output data */
-    hookSpecificOutput?: Record<string, unknown>;
-    /** Context used to generate the response */
-    context: HookContext;
-    /** Response type identifier */
-    type: 'hook';
-    /** Generated timestamp */
-    timestamp: string;
-}
-/**
- * Central orchestrator for all prompt generation in the claude-mem system
- */
-export declare class PromptOrchestrator {
-    private projectName;
-    constructor(projectName?: string);
-    /**
-     * Creates an analysis prompt for LLM processing of transcript content
-     */
-    createAnalysisPrompt(context: AnalysisContext): AnalysisPrompt;
-    /**
-     * Creates a session start prompt for human context
-     */
-    createSessionStartPrompt(context: SessionContext): SessionPrompt;
-    /**
-     * Creates a hook response for system integration
-     */
-    createHookResponse(context: HookContext): HookResponse;
-    private buildAnalysisPrompt;
-    private buildSessionStartMessage;
-    private buildHookResponse;
-    /**
-     * Validates that an AnalysisContext has required fields
-     */
-    validateAnalysisContext(context: Partial<AnalysisContext>): context is AnalysisContext;
-    /**
-     * Validates that a SessionContext has required fields
-     */
-    validateSessionContext(context: Partial<SessionContext>): context is SessionContext;
-    /**
-     * Validates that a HookContext has required fields
-     */
-    validateHookContext(context: Partial<HookContext>): context is HookContext;
-    /**
-     * Gets the project name for this orchestrator instance
-     */
-    getProjectName(): string;
-    /**
-     * Sets a new project name for this orchestrator instance
-     */
-    setProjectName(projectName: string): void;
-}
-/**
- * Creates a new PromptOrchestrator instance
- */
-export declare function createPromptOrchestrator(projectName?: string): PromptOrchestrator;
-/**
- * Creates an analysis context from basic parameters
- */
-export declare function createAnalysisContext(transcriptContent: string, sessionId: string, options?: Partial<Omit<AnalysisContext, 'transcriptContent' | 'sessionId'>>): AnalysisContext;
-/**
- * Creates a session context from basic parameters
- */
-export declare function createSessionContext(sessionId: string, source: SessionContext['source'], options?: Partial<Omit<SessionContext, 'sessionId' | 'source'>>): SessionContext;
-/**
- * Creates a hook context from basic parameters
- */
-export declare function createHookContext(hookEventName: string, sessionId: string, success: boolean, options?: Partial<Omit<HookContext, 'hookEventName' | 'sessionId' | 'success'>>): HookContext;

package/dist/core/orchestration/PromptOrchestrator.js

@@ -1,182 +0,0 @@
-/**
- * PromptOrchestrator - Single source of truth for all prompt generation
- *
- * This class serves as the central orchestrator for generating different types of prompts
- * used throughout the claude-mem system. It provides clear, well-typed interfaces and
- * methods for creating prompts for LLM analysis, human context, and system integration.
- */
-import { createAnalysisPrompt } from '../../prompts/templates/analysis/AnalysisTemplates.js';
-// =============================================================================
-// PROMPT ORCHESTRATOR CLASS
-// =============================================================================
-/**
- * Central orchestrator for all prompt generation in the claude-mem system
- */
-export class PromptOrchestrator {
-    projectName;
-    constructor(projectName = 'claude-mem') {
-        this.projectName = projectName;
-    }
-    /**
-     * Creates an analysis prompt for LLM processing of transcript content
-     */
-    createAnalysisPrompt(context) {
-        const timestamp = new Date().toISOString();
-        const prompt = this.buildAnalysisPrompt(context);
-        return {
-            prompt,
-            context,
-            type: 'analysis',
-            timestamp,
-        };
-    }
-    /**
-     * Creates a session start prompt for human context
-     */
-    createSessionStartPrompt(context) {
-        const timestamp = new Date().toISOString();
-        const message = this.buildSessionStartMessage(context);
-        return {
-            message,
-            context,
-            type: 'session',
-            timestamp,
-        };
-    }
-    /**
-     * Creates a hook response for system integration
-     */
-    createHookResponse(context) {
-        const timestamp = new Date().toISOString();
-        const response = this.buildHookResponse(context);
-        return {
-            ...response,
-            context,
-            type: 'hook',
-            timestamp,
-        };
-    }
-    // =============================================================================
-    // PRIVATE PROMPT BUILDERS
-    // =============================================================================
-    buildAnalysisPrompt(context) {
-        const { transcriptContent, sessionId, projectName = this.projectName, } = context;
-        // Extract project prefix from project name (convert to snake_case)
-        const projectPrefix = projectName.replace(/[-\s]/g, '_').toLowerCase();
-        // Use the simple prompt with the transcript included
-        return createAnalysisPrompt(transcriptContent, sessionId, projectPrefix);
-    }
-    buildSessionStartMessage(context) {
-        const { sessionId, source, projectName = this.projectName, additionalContext, transcriptPath, cwd, } = context;
-        let message = `## Session Started (${source})
-
-**Project**: ${projectName}  
-**Session ID**: ${sessionId}  `;
-        if (transcriptPath) {
-            message += `**Transcript**: ${transcriptPath}  `;
-        }
-        if (cwd) {
-            message += `**Working Directory**: ${cwd}  `;
-        }
-        if (additionalContext) {
-            message += `\n### Additional Context\n${additionalContext}`;
-        }
-        message += `\n\nMemory system is active and ready to preserve context across sessions.`;
-        return message;
-    }
-    buildHookResponse(context) {
-        const { hookEventName, success, message, data, shouldContinue = success, stopReason, } = context;
-        const response = {
-            continue: shouldContinue,
-            suppressOutput: false,
-        };
-        if (!shouldContinue && stopReason) {
-            response.stopReason = stopReason;
-        }
-        // Add hook-specific output based on event type
-        if (hookEventName === 'SessionStart') {
-            response.hookSpecificOutput = {
-                hookEventName: 'SessionStart',
-                additionalContext: message,
-                ...data,
-            };
-        }
-        else if (data) {
-            response.hookSpecificOutput = data;
-        }
-        return response;
-    }
-    // =============================================================================
-    // UTILITY METHODS
-    // =============================================================================
-    /**
-     * Validates that an AnalysisContext has required fields
-     */
-    validateAnalysisContext(context) {
-        return !!(context.transcriptContent && context.sessionId);
-    }
-    /**
-     * Validates that a SessionContext has required fields
-     */
-    validateSessionContext(context) {
-        return !!(context.sessionId && context.source);
-    }
-    /**
-     * Validates that a HookContext has required fields
-     */
-    validateHookContext(context) {
-        return !!(context.hookEventName && context.sessionId && typeof context.success === 'boolean');
-    }
-    /**
-     * Gets the project name for this orchestrator instance
-     */
-    getProjectName() {
-        return this.projectName;
-    }
-    /**
-     * Sets a new project name for this orchestrator instance
-     */
-    setProjectName(projectName) {
-        this.projectName = projectName;
-    }
-}
-// =============================================================================
-// FACTORY FUNCTIONS
-// =============================================================================
-/**
- * Creates a new PromptOrchestrator instance
- */
-export function createPromptOrchestrator(projectName) {
-    return new PromptOrchestrator(projectName);
-}
-/**
- * Creates an analysis context from basic parameters
- */
-export function createAnalysisContext(transcriptContent, sessionId, options = {}) {
-    return {
-        transcriptContent,
-        sessionId,
-        ...options,
-    };
-}
-/**
- * Creates a session context from basic parameters
- */
-export function createSessionContext(sessionId, source, options = {}) {
-    return {
-        sessionId,
-        source,
-        ...options,
-    };
-}
-/**
- * Creates a hook context from basic parameters
- */
-export function createHookContext(hookEventName, sessionId, success, options = {}) {
-    return {
-        hookEventName,
-        sessionId,
-        success,
-        ...options,
-    };
-}

package/dist/lib/time-utils.d.ts

@@ -1,5 +0,0 @@
-/**
- * Time utilities for formatting relative timestamps
- */
-export declare function formatRelativeTime(timestamp: string | Date): string;
-export declare function parseTimestamp(entry: any): Date | null;

package/dist/lib/time-utils.js

@@ -1,70 +0,0 @@
-/**
- * Time utilities for formatting relative timestamps
- */
-export function formatRelativeTime(timestamp) {
-    try {
-        const date = timestamp instanceof Date ? timestamp : new Date(timestamp);
-        const now = new Date();
-        const diffMs = now.getTime() - date.getTime();
-        const diffSeconds = Math.floor(diffMs / 1000);
-        const diffMinutes = Math.floor(diffSeconds / 60);
-        const diffHours = Math.floor(diffMinutes / 60);
-        const diffDays = Math.floor(diffHours / 24);
-        const diffWeeks = Math.floor(diffDays / 7);
-        const diffMonths = Math.floor(diffDays / 30);
-        if (diffSeconds < 60) {
-            return 'Just now';
-        }
-        else if (diffMinutes < 60) {
-            return diffMinutes === 1 ? '1 minute ago' : `${diffMinutes} minutes ago`;
-        }
-        else if (diffHours < 24) {
-            return diffHours === 1 ? '1 hour ago' : `${diffHours} hours ago`;
-        }
-        else if (diffDays === 1) {
-            return 'Yesterday';
-        }
-        else if (diffDays < 7) {
-            return `${diffDays} days ago`;
-        }
-        else if (diffWeeks === 1) {
-            return '1 week ago';
-        }
-        else if (diffWeeks < 4) {
-            return `${diffWeeks} weeks ago`;
-        }
-        else if (diffMonths === 1) {
-            return '1 month ago';
-        }
-        else if (diffMonths < 12) {
-            return `${diffMonths} months ago`;
-        }
-        else {
-            const diffYears = Math.floor(diffMonths / 12);
-            return diffYears === 1 ? '1 year ago' : `${diffYears} years ago`;
-        }
-    }
-    catch (error) {
-        // Return a fallback for invalid timestamps
-        return 'Recently';
-    }
-}
-export function parseTimestamp(entry) {
-    // Try multiple timestamp fields that might exist
-    const possibleFields = ['timestamp', 'created_at', 'date', 'time'];
-    for (const field of possibleFields) {
-        if (entry[field]) {
-            try {
-                const date = new Date(entry[field]);
-                if (!isNaN(date.getTime())) {
-                    return date;
-                }
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    // If no valid timestamp found, return null
-    return null;
-}

package/dist/prompts/constants.d.ts

@@ -1,126 +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';
-/**
- * Entity naming patterns for the knowledge graph
- */
-export declare const ENTITY_NAMING_PATTERNS: {
-    readonly component: "Component_Name";
-    readonly decision: "Decision_Name";
-    readonly pattern: "Pattern_Name";
-    readonly tool: "Tool_Name";
-    readonly fix: "Fix_Name";
-    readonly workflow: "Workflow_Name";
-};
-/**
- * Available entity types for classification
- */
-export declare const ENTITY_TYPES: {
-    readonly component: "component";
-    readonly pattern: "pattern";
-    readonly workflow: "workflow";
-    readonly integration: "integration";
-    readonly concept: "concept";
-    readonly decision: "decision";
-    readonly tool: "tool";
-    readonly fix: "fix";
-};
-/**
- * Standard observation fields for entities
- */
-export declare const OBSERVATION_FIELDS: readonly ["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 declare const RELATIONSHIP_TYPES: readonly ["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"];
-/**
- * System message templates for context priming
- */
-export declare const CONTEXT_TEMPLATES: {
-    readonly PRIMARY_CONTEXT: (projectName: string) => string;
-    readonly RECENT_SESSIONS: (sessionList: string) => string;
-    readonly AVAILABLE_ENTITIES: (type: string, entities: string[], hasMore: boolean, moreCount: number) => string;
-    readonly SESSION_START_HEADER: "🧠 Active Working Context from Previous Sessions:";
-    readonly SESSION_START_SEPARATOR: string;
-    readonly RESUME_INSTRUCTIONS: "💡 TO RESUME: Load active components with chroma_get_documents([\"<exact_document_ids>\"])\n📊 TO EXPLORE: Search related work with chroma_query_documents([\"<keywords>\"])";
-};
-/**
- * Session start formatting templates
- */
-export declare const SESSION_START_TEMPLATES: {
-    readonly FOCUS_LINE: (focus: string) => string;
-    readonly LAST_WORKED: (timeAgo: string, projectName: string) => string;
-    readonly SECTIONS: {
-        readonly COMPONENTS: "🎯 ACTIVE COMPONENTS (load these for context):";
-        readonly DECISIONS: "🔄 RECENT DECISIONS & PATTERNS:";
-        readonly TOOLS: "🛠️ TOOLS & INFRASTRUCTURE:";
-        readonly FIXES: "🐛 RECENT FIXES:";
-        readonly ACTIONS: "⚡ NEXT ACTIONS:";
-    };
-    readonly ACTION_PREFIX: "□ ";
-    readonly ENTITY_BULLET: "• ";
-};
-/**
- * Time formatting for "time ago" displays
- */
-export declare const TIME_FORMATS: {
-    readonly JUST_NOW: "just now";
-    readonly HOURS_AGO: (hours: number) => string;
-    readonly DAYS_AGO: (days: number) => string;
-    readonly RECENTLY: "recently";
-};
-/**
- * Standard hook response structures for Claude Code integration
- */
-export declare const HOOK_RESPONSES: {
-    readonly SUCCESS: (hookEventName: string, message: string) => {
-        hookSpecificOutput: {
-            hookEventName: string;
-            status: string;
-            message: string;
-        };
-        suppressOutput: boolean;
-    };
-    readonly SKIPPED: (hookEventName: string, message: string) => {
-        hookSpecificOutput: {
-            hookEventName: string;
-            status: string;
-            message: string;
-        };
-        suppressOutput: boolean;
-    };
-    readonly BLOCKED: (reason: string) => {
-        decision: string;
-        reason: string;
-    };
-    readonly CONTINUE: (hookEventName: string, additionalContext?: string) => {
-        hookSpecificOutput?: {
-            hookEventName: string;
-            additionalContext: string;
-        } | undefined;
-        continue: boolean;
-    };
-    readonly ERROR: (reason: string) => {
-        decision: string;
-        reason: string;
-    };
-};
-/**
- * Pre-defined hook messages
- */
-export declare const HOOK_MESSAGES: {
-    readonly COMPRESSION_SUCCESS: "Memory compression completed successfully";
-    readonly COMPRESSION_FAILED: (stderr: string) => string;
-    readonly CONTEXT_LOADED: "Project context loaded successfully";
-    readonly CONTEXT_SKIPPED: "Continuing session - context loading skipped";
-    readonly NO_TRANSCRIPT: "No transcript path provided";
-    readonly HOOK_ERROR: (error: string) => string;
-};
-/**
- * Export hook templates for direct usage
- */
-export { HookTemplates };