claude-conversation-memory-mcp 0.6.0 → 1.1.0

package/dist/storage/BackupManager.js

@@ -0,0 +1,213 @@
+/**
+ * BackupManager - Create and manage backups before deletion operations
+ * Exports affected data to JSON for potential restoration
+ */
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { pathToProjectFolderName } from "../utils/sanitization.js";
+/**
+ * BackupManager class
+ */
+export class BackupManager {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a backup of specific conversations and related data
+     */
+    createBackupForConversations(conversationIds, description, projectPath) {
+        if (conversationIds.length === 0) {
+            throw new Error("No conversations to backup");
+        }
+        // Prepare backup directory
+        const backupDir = this.getBackupDirectory(projectPath);
+        this.ensureDirectoryExists(backupDir);
+        // Generate backup filename
+        const timestamp = Date.now();
+        const backupFilename = `backup-${timestamp}.json`;
+        const backupPath = join(backupDir, backupFilename);
+        // Collect data from all related tables
+        const backupData = {};
+        const recordCounts = {};
+        // Conversations
+        const conversations = this.getConversations(conversationIds);
+        backupData.conversations = conversations;
+        recordCounts.conversations = conversations.length;
+        // Messages
+        const messages = this.getMessages(conversationIds);
+        backupData.messages = messages;
+        recordCounts.messages = messages.length;
+        // Get message IDs for related data
+        const messageIds = messages.map((m) => m.id);
+        // Tool uses
+        const toolUses = this.getToolUses(messageIds);
+        backupData.tool_uses = toolUses;
+        recordCounts.tool_uses = toolUses.length;
+        // Tool results
+        const toolResults = this.getToolResults(messageIds);
+        backupData.tool_results = toolResults;
+        recordCounts.tool_results = toolResults.length;
+        // File edits
+        const fileEdits = this.getFileEdits(conversationIds);
+        backupData.file_edits = fileEdits;
+        recordCounts.file_edits = fileEdits.length;
+        // Thinking blocks
+        const thinkingBlocks = this.getThinkingBlocks(messageIds);
+        backupData.thinking_blocks = thinkingBlocks;
+        recordCounts.thinking_blocks = thinkingBlocks.length;
+        // Decisions
+        const decisions = this.getDecisions(conversationIds);
+        backupData.decisions = decisions;
+        recordCounts.decisions = decisions.length;
+        // Mistakes
+        const mistakes = this.getMistakes(conversationIds);
+        backupData.mistakes = mistakes;
+        recordCounts.mistakes = mistakes.length;
+        // Requirements
+        const requirements = this.getRequirements(conversationIds);
+        backupData.requirements = requirements;
+        recordCounts.requirements = requirements.length;
+        // Validations
+        const validations = this.getValidations(conversationIds);
+        backupData.validations = validations;
+        recordCounts.validations = validations.length;
+        // Embeddings
+        const messageEmbeddings = this.getMessageEmbeddings(messageIds);
+        backupData.message_embeddings = messageEmbeddings;
+        recordCounts.message_embeddings = messageEmbeddings.length;
+        const decisionIds = decisions.map((d) => d.id);
+        const decisionEmbeddings = this.getDecisionEmbeddings(decisionIds);
+        backupData.decision_embeddings = decisionEmbeddings;
+        recordCounts.decision_embeddings = decisionEmbeddings.length;
+        // Create metadata
+        const metadata = {
+            timestamp,
+            description,
+            projectPath,
+            tables: Object.keys(backupData),
+            recordCounts,
+            backupPath,
+        };
+        // Write backup file
+        const fullBackup = {
+            metadata,
+            data: backupData,
+        };
+        writeFileSync(backupPath, JSON.stringify(fullBackup, null, 2), "utf-8");
+        console.log(`✓ Backup created: ${backupPath}`);
+        console.log(`  ${recordCounts.conversations} conversations`);
+        console.log(`  ${recordCounts.messages} messages`);
+        console.log(`  ${recordCounts.decisions} decisions`);
+        console.log(`  ${recordCounts.mistakes} mistakes`);
+        return metadata;
+    }
+    /**
+     * Get backup directory for project
+     */
+    getBackupDirectory(projectPath) {
+        const projectFolderName = pathToProjectFolderName(projectPath);
+        return join(homedir(), ".claude", "backups", projectFolderName);
+    }
+    /**
+     * Ensure directory exists
+     */
+    ensureDirectoryExists(dir) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    /**
+     * Query helpers for each table
+     */
+    getConversations(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM conversations WHERE id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getMessages(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM messages WHERE conversation_id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getToolUses(messageIds) {
+        if (messageIds.length === 0) {
+            return [];
+        }
+        const placeholders = messageIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM tool_uses WHERE message_id IN (${placeholders})`)
+            .all(...messageIds);
+    }
+    getToolResults(messageIds) {
+        if (messageIds.length === 0) {
+            return [];
+        }
+        const placeholders = messageIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM tool_results WHERE message_id IN (${placeholders})`)
+            .all(...messageIds);
+    }
+    getFileEdits(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM file_edits WHERE conversation_id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getThinkingBlocks(messageIds) {
+        if (messageIds.length === 0) {
+            return [];
+        }
+        const placeholders = messageIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM thinking_blocks WHERE message_id IN (${placeholders})`)
+            .all(...messageIds);
+    }
+    getDecisions(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM decisions WHERE conversation_id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getMistakes(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM mistakes WHERE conversation_id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getRequirements(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM requirements WHERE conversation_id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getValidations(conversationIds) {
+        const placeholders = conversationIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT * FROM validations WHERE conversation_id IN (${placeholders})`)
+            .all(...conversationIds);
+    }
+    getMessageEmbeddings(messageIds) {
+        if (messageIds.length === 0) {
+            return [];
+        }
+        const placeholders = messageIds.map(() => "?").join(",");
+        // Note: BLOB data will be base64 encoded in JSON
+        return this.db
+            .prepare(`SELECT id, message_id, model_name, dimensions, created_at FROM message_embeddings WHERE message_id IN (${placeholders})`)
+            .all(...messageIds);
+    }
+    getDecisionEmbeddings(decisionIds) {
+        if (decisionIds.length === 0) {
+            return [];
+        }
+        const placeholders = decisionIds.map(() => "?").join(",");
+        return this.db
+            .prepare(`SELECT id, decision_id, model_name, dimensions, created_at FROM decision_embeddings WHERE decision_id IN (${placeholders})`)
+            .all(...decisionIds);
+    }
+}
+//# sourceMappingURL=BackupManager.js.map

package/dist/storage/BackupManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackupManager.js","sourceRoot":"","sources":["../../src/storage/BackupManager.ts"],"names":[],"mappings":"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"}

package/dist/storage/ConversationStorage.d.ts

@@ -1,6 +1,20 @@
 /**
- * Conversation Storage Layer
- * CRUD operations for all conversation-related data
+ * Conversation Storage Layer - CRUD operations for all conversation-related data.
+ *
+ * This class provides the data access layer for the conversation-memory system.
+ * It handles storing and retrieving conversations, messages, tool uses, decisions,
+ * mistakes, requirements, and git commits.
+ *
+ * All store operations use transactions for atomicity and performance.
+ * All JSON fields are automatically serialized/deserialized.
+ *
+ * @example
+ * ```typescript
+ * const storage = new ConversationStorage(sqliteManager);
+ * await storage.storeConversations(conversations);
+ * const conv = storage.getConversation('conv-123');
+ * const timeline = storage.getFileTimeline('src/index.ts');
+ * ```
  */
 import type { SQLiteManager } from "./SQLiteManager.js";
 import type { Conversation, Message, ToolUse, ToolResult, FileEdit, ThinkingBlock } from "../parsers/ConversationParser.js";
@@ -8,30 +22,285 @@ import type { Decision } from "../parsers/DecisionExtractor.js";
 import type { Mistake } from "../parsers/MistakeExtractor.js";
 import type { GitCommit } from "../parsers/GitIntegrator.js";
 import type { Requirement, Validation } from "../parsers/RequirementsExtractor.js";
+import { type QueryCacheConfig, type CacheStats } from "../cache/QueryCache.js";
+/**
+ * Data access layer for conversation memory storage.
+ *
+ * Provides CRUD operations for all conversation-related entities using SQLite.
+ * Supports optional caching for frequently accessed queries.
+ */
 export declare class ConversationStorage {
     private db;
+    private cache;
+    /**
+     * Create a new ConversationStorage instance.
+     *
+     * @param db - SQLiteManager instance for database access
+     */
     constructor(db: SQLiteManager);
+    /**
+     * Enable query result caching.
+     *
+     * Caching improves performance for frequently accessed queries by storing
+     * results in memory. Cache is automatically invalidated when data changes.
+     *
+     * @param config - Cache configuration (maxSize and ttlMs)
+     *
+     * @example
+     * ```typescript
+     * storage.enableCache({ maxSize: 100, ttlMs: 300000 });
+     * ```
+     */
+    enableCache(config: QueryCacheConfig): void;
+    /**
+     * Disable query result caching.
+     *
+     * Clears all cached data and stops caching new queries.
+     */
+    disableCache(): void;
+    /**
+     * Check if caching is enabled.
+     *
+     * @returns True if caching is enabled
+     */
+    isCacheEnabled(): boolean;
+    /**
+     * Clear all cached query results.
+     *
+     * Clears the cache but keeps caching enabled.
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics.
+     *
+     * Returns performance metrics including hits, misses, hit rate, and evictions.
+     *
+     * @returns Cache statistics or null if caching is disabled
+     *
+     * @example
+     * ```typescript
+     * const stats = storage.getCacheStats();
+     * if (stats) {
+     *   console.log(`Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);
+     * }
+     * ```
+     */
+    getCacheStats(): CacheStats | null;
+    /**
+     * Store conversations in the database.
+     *
+     * Uses INSERT OR REPLACE to handle both new and updated conversations.
+     * All operations are performed in a single transaction for atomicity.
+     *
+     * @param conversations - Array of conversation objects to store
+     * @returns Promise that resolves when all conversations are stored
+     *
+     * @example
+     * ```typescript
+     * await storage.storeConversations([
+     *   {
+     *     id: 'conv-123',
+     *     project_path: '/path/to/project',
+     *     first_message_at: Date.now(),
+     *     last_message_at: Date.now(),
+     *     message_count: 42,
+     *     git_branch: 'main',
+     *     claude_version: '3.5',
+     *     metadata: {},
+     *     created_at: Date.now(),
+     *     updated_at: Date.now()
+     *   }
+     * ]);
+     * ```
+     */
     storeConversations(conversations: Conversation[]): Promise<void>;
+    /**
+     * Retrieve a single conversation by ID.
+     *
+     * @param id - Conversation ID to retrieve
+     * @returns Conversation object if found, null otherwise
+     *
+     * @example
+     * ```typescript
+     * const conv = storage.getConversation('conv-123');
+     * if (conv) {
+     *   console.log(`${conv.message_count} messages on ${conv.git_branch}`);
+     * }
+     * ```
+     */
     getConversation(id: string): Conversation | null;
+    /**
+     * Store messages in the database.
+     *
+     * Stores all messages from conversations including content, metadata, and relationships.
+     * Uses INSERT OR REPLACE for idempotent storage.
+     *
+     * @param messages - Array of message objects to store
+     * @returns Promise that resolves when all messages are stored
+     *
+     * @example
+     * ```typescript
+     * await storage.storeMessages([
+     *   {
+     *     id: 'msg-123',
+     *     conversation_id: 'conv-123',
+     *     message_type: 'text',
+     *     role: 'user',
+     *     content: 'Hello',
+     *     timestamp: Date.now(),
+     *     is_sidechain: false,
+     *     metadata: {}
+     *   }
+     * ]);
+     * ```
+     */
     storeMessages(messages: Message[]): Promise<void>;
+    /**
+     * Store tool use records in the database.
+     *
+     * Records all tool invocations from assistant messages.
+     *
+     * @param toolUses - Array of tool use objects
+     * @returns Promise that resolves when stored
+     */
     storeToolUses(toolUses: ToolUse[]): Promise<void>;
+    /**
+     * Store tool execution results in the database.
+     *
+     * Records the output/results from tool invocations.
+     *
+     * @param toolResults - Array of tool result objects
+     * @returns Promise that resolves when stored
+     */
     storeToolResults(toolResults: ToolResult[]): Promise<void>;
+    /**
+     * Store file edit records in the database.
+     *
+     * Records all file modifications made during conversations.
+     *
+     * @param fileEdits - Array of file edit objects
+     * @returns Promise that resolves when stored
+     */
     storeFileEdits(fileEdits: FileEdit[]): Promise<void>;
+    /**
+     * Retrieve all edits for a specific file.
+     *
+     * @param filePath - Path to the file
+     * @returns Array of file edits, ordered by timestamp (most recent first)
+     */
     getFileEdits(filePath: string): FileEdit[];
+    /**
+     * Store thinking blocks in the database.
+     *
+     * Thinking blocks contain Claude's internal reasoning. They can be large and
+     * are optionally indexed based on the includeThinking flag.
+     *
+     * @param blocks - Array of thinking block objects
+     * @returns Promise that resolves when stored
+     */
     storeThinkingBlocks(blocks: ThinkingBlock[]): Promise<void>;
+    /**
+     * Store extracted decisions in the database.
+     *
+     * Decisions include architectural choices, technical decisions, and their rationale.
+     *
+     * @param decisions - Array of decision objects
+     * @returns Promise that resolves when stored
+     */
     storeDecisions(decisions: Decision[]): Promise<void>;
+    /**
+     * Retrieve all decisions related to a specific file.
+     *
+     * @param filePath - Path to the file
+     * @returns Array of decisions that reference this file
+     * @internal
+     */
     getDecisionsForFile(filePath: string): Decision[];
+    /**
+     * Store git commit records linked to conversations.
+     *
+     * Links git commits to the conversations where they were made or discussed.
+     *
+     * @param commits - Array of git commit objects
+     * @returns Promise that resolves when stored
+     */
     storeGitCommits(commits: GitCommit[]): Promise<void>;
     getCommitsForFile(filePath: string): GitCommit[];
+    /**
+     * Store extracted mistakes in the database.
+     *
+     * Mistakes include errors, bugs, and wrong approaches that were later corrected.
+     *
+     * @param mistakes - Array of mistake objects
+     * @returns Promise that resolves when stored
+     */
     storeMistakes(mistakes: Mistake[]): Promise<void>;
+    /**
+     * Store extracted requirements in the database.
+     *
+     * Requirements include dependencies, constraints, and specifications for components.
+     *
+     * @param requirements - Array of requirement objects
+     * @returns Promise that resolves when stored
+     */
     storeRequirements(requirements: Requirement[]): Promise<void>;
+    /**
+     * Store validation records in the database.
+     *
+     * Validations capture test results and performance data from conversations.
+     *
+     * @param validations - Array of validation objects
+     * @returns Promise that resolves when stored
+     */
     storeValidations(validations: Validation[]): Promise<void>;
+    /**
+     * Get the complete timeline of changes to a file.
+     *
+     * Combines file edits, git commits, and related decisions into a single timeline.
+     * This is a key method used by tools like checkBeforeModify and getFileEvolution.
+     *
+     * @param filePath - Path to the file
+     * @returns Object containing:
+     * - `file_path`: The file path queried
+     * - `edits`: All file edit records
+     * - `commits`: All git commits affecting this file
+     * - `decisions`: All decisions related to this file
+     *
+     * @example
+     * ```typescript
+     * const timeline = storage.getFileTimeline('src/index.ts');
+     * console.log(`${timeline.edits.length} edits`);
+     * console.log(`${timeline.commits.length} commits`);
+     * console.log(`${timeline.decisions.length} decisions`);
+     * ```
+     */
     getFileTimeline(filePath: string): {
         file_path: string;
         edits: FileEdit[];
         commits: GitCommit[];
         decisions: Decision[];
     };
+    /**
+     * Get statistics about the indexed conversation data.
+     *
+     * Returns counts of all major entity types stored in the database.
+     * Used for displaying indexing results and system health checks.
+     *
+     * @returns Object containing counts for:
+     * - `conversations`: Total conversations indexed
+     * - `messages`: Total messages stored
+     * - `decisions`: Total decisions extracted
+     * - `mistakes`: Total mistakes documented
+     * - `git_commits`: Total git commits linked
+     *
+     * @example
+     * ```typescript
+     * const stats = storage.getStats();
+     * console.log(`Indexed ${stats.conversations.count} conversations`);
+     * console.log(`Extracted ${stats.decisions.count} decisions`);
+     * console.log(`Linked ${stats.git_commits.count} commits`);
+     * ```
+     */
     getStats(): {
         conversations: {
             count: number;

package/dist/storage/ConversationStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationStorage.d.ts","sourceRoot":"","sources":["../../src/storage/ConversationStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,OAAO,EACP,UAAU,EACV,QAAQ,EACR,aAAa,EACd,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAInF,qBAAa,mBAAmB;IAClB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAI/B,kBAAkB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAiB1C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCjD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjD,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B1D,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B1D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAUpC,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3D,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAiB3C,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAe1C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjD,iBAAiB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7D,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,SAAS,EAAE,CAAC;QACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;KACvB;IAcD,QAAQ,IAAI;QACV,aAAa,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACjC,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7B,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,WAAW,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAChC;CAqBF"}
+{"version":3,"file":"ConversationStorage.d.ts","sourceRoot":"","sources":["../../src/storage/ConversationStorage.ts"],"names":[],"mappings":"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"}