claude-conversation-memory-mcp 0.1.0

package/dist/storage/migrations.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Database migration system
+ * Follows patterns from code-graph-rag-mcp for versioned schema updates
+ */
+import { SQLiteManager } from "./SQLiteManager.js";
+export interface Migration {
+    version: number;
+    description: string;
+    up: string;
+    down?: string;
+    checksum?: string;
+}
+export declare const migrations: Migration[];
+export declare class MigrationManager {
+    private db;
+    constructor(db: SQLiteManager);
+    /**
+     * Get current schema version
+     */
+    getCurrentVersion(): number;
+    /**
+     * Get all pending migrations
+     */
+    getPendingMigrations(): Migration[];
+    /**
+     * Apply a single migration
+     */
+    applyMigration(migration: Migration): void;
+    /**
+     * Apply all pending migrations
+     */
+    applyPendingMigrations(): void;
+    /**
+     * Rollback to a specific version
+     */
+    rollbackTo(targetVersion: number): void;
+    /**
+     * Calculate migration checksum for verification
+     */
+    private calculateChecksum;
+    /**
+     * Verify migration integrity
+     */
+    verifyMigrations(): boolean;
+    /**
+     * Get migration history
+     */
+    getHistory(): Array<{
+        version: number;
+        description: string;
+        applied_at: number;
+    }>;
+}
+//# sourceMappingURL=migrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,EAiBjC,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAgB;gBAEd,EAAE,EAAE,aAAa;IAI7B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,oBAAoB,IAAI,SAAS,EAAE;IAKnC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAiC1C;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAiB9B;;OAEG;IACH,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAyCvC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IA2B3B;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CAWH"}

package/dist/storage/migrations.js

@@ -0,0 +1,153 @@
+/**
+ * Database migration system
+ * Follows patterns from code-graph-rag-mcp for versioned schema updates
+ */
+import { createHash } from "crypto";
+export const migrations = [
+    {
+        version: 1,
+        description: "Initial schema with 17 tables for conversation memory",
+        up: `
+      -- Schema is already created by schema.sql during initialization
+      -- This migration just records the version
+    `,
+    },
+    // Future migrations will be added here
+    // Example:
+    // {
+    //   version: 2,
+    //   description: "Add new column for X",
+    //   up: "ALTER TABLE conversations ADD COLUMN new_field TEXT",
+    //   down: "ALTER TABLE conversations DROP COLUMN new_field"
+    // }
+];
+export class MigrationManager {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Get current schema version
+     */
+    getCurrentVersion() {
+        return this.db.getSchemaVersion();
+    }
+    /**
+     * Get all pending migrations
+     */
+    getPendingMigrations() {
+        const currentVersion = this.getCurrentVersion();
+        return migrations.filter((m) => m.version > currentVersion);
+    }
+    /**
+     * Apply a single migration
+     */
+    applyMigration(migration) {
+        console.log(`Applying migration v${migration.version}: ${migration.description}`);
+        // Calculate checksum
+        const checksum = this.calculateChecksum(migration);
+        // Execute migration in a transaction
+        this.db.transaction(() => {
+            // Execute the migration SQL
+            if (migration.up && migration.up.trim()) {
+                const statements = migration.up
+                    .split(";")
+                    .map((s) => s.trim())
+                    .filter((s) => s.length > 0 && !s.startsWith("--"));
+                for (const statement of statements) {
+                    this.db.exec(statement);
+                }
+            }
+            // Record migration
+            this.db
+                .prepare("INSERT INTO schema_version (version, applied_at, description, checksum) VALUES (?, ?, ?, ?)")
+                .run(migration.version, Date.now(), migration.description, checksum);
+        });
+        console.log(`Migration v${migration.version} applied successfully`);
+    }
+    /**
+     * Apply all pending migrations
+     */
+    applyPendingMigrations() {
+        const pending = this.getPendingMigrations();
+        if (pending.length === 0) {
+            console.log("No pending migrations");
+            return;
+        }
+        console.log(`Found ${pending.length} pending migrations`);
+        for (const migration of pending) {
+            this.applyMigration(migration);
+        }
+        console.log("All migrations applied successfully");
+    }
+    /**
+     * Rollback to a specific version
+     */
+    rollbackTo(targetVersion) {
+        const currentVersion = this.getCurrentVersion();
+        if (targetVersion >= currentVersion) {
+            console.log("Nothing to rollback");
+            return;
+        }
+        // Get migrations to rollback (in reverse order)
+        const toRollback = migrations
+            .filter((m) => m.version > targetVersion && m.version <= currentVersion)
+            .sort((a, b) => b.version - a.version);
+        for (const migration of toRollback) {
+            if (!migration.down) {
+                throw new Error(`Migration v${migration.version} does not support rollback`);
+            }
+            console.log(`Rolling back migration v${migration.version}`);
+            const downSql = migration.down;
+            if (!downSql) {
+                throw new Error(`Migration v${migration.version} has no rollback SQL`);
+            }
+            this.db.transaction(() => {
+                // Execute rollback SQL
+                this.db.exec(downSql);
+                // Remove migration record
+                this.db
+                    .prepare("DELETE FROM schema_version WHERE version = ?")
+                    .run(migration.version);
+            });
+            console.log(`Migration v${migration.version} rolled back`);
+        }
+    }
+    /**
+     * Calculate migration checksum for verification
+     */
+    calculateChecksum(migration) {
+        const content = `${migration.version}:${migration.description}:${migration.up}`;
+        return createHash("sha256").update(content).digest("hex");
+    }
+    /**
+     * Verify migration integrity
+     */
+    verifyMigrations() {
+        const applied = this.db
+            .prepare("SELECT version, checksum FROM schema_version WHERE version > 0 ORDER BY version")
+            .all();
+        for (const record of applied) {
+            const migration = migrations.find((m) => m.version === record.version);
+            if (!migration) {
+                console.error(`Migration v${record.version} not found in code`);
+                return false;
+            }
+            const expectedChecksum = this.calculateChecksum(migration);
+            if (record.checksum && record.checksum !== expectedChecksum) {
+                console.error(`Migration v${record.version} checksum mismatch - database may be corrupted`);
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get migration history
+     */
+    getHistory() {
+        return this.db
+            .prepare("SELECT version, description, applied_at FROM schema_version ORDER BY version")
+            .all();
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/storage/migrations.js.map

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

package/dist/storage/schema.sql

@@ -0,0 +1,321 @@
+-- Claude Conversation Memory Database Schema
+-- Version: 1.0.0
+-- Optimized for SQLite + sqlite-vec
+
+-- ==================================================
+-- CORE TABLES
+-- ==================================================
+
+-- Table 1: Conversations
+CREATE TABLE IF NOT EXISTS conversations (
+  id TEXT PRIMARY KEY,                    -- sessionId from JSONL
+  project_path TEXT NOT NULL,             -- Derived from directory name
+  first_message_at INTEGER NOT NULL,
+  last_message_at INTEGER NOT NULL,
+  message_count INTEGER DEFAULT 0,
+  git_branch TEXT,                        -- Most recent branch
+  claude_version TEXT,                    -- Most recent version
+  metadata TEXT,                          -- JSON: {cwd, tags}
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_conv_project ON conversations(project_path);
+CREATE INDEX IF NOT EXISTS idx_conv_time ON conversations(last_message_at);
+CREATE INDEX IF NOT EXISTS idx_conv_branch ON conversations(git_branch);
+CREATE INDEX IF NOT EXISTS idx_conv_created ON conversations(created_at);
+
+-- Table 2: Messages
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY,                    -- uuid from JSONL
+  conversation_id TEXT NOT NULL,
+  parent_id TEXT,                         -- parentUuid (threading)
+  message_type TEXT NOT NULL,             -- user/assistant/system/summary/file-history-snapshot
+  role TEXT,                              -- user/assistant (for user/assistant types)
+  content TEXT,                           -- Main message content
+  timestamp INTEGER NOT NULL,
+  is_sidechain INTEGER DEFAULT 0,         -- Agent messages (boolean as integer)
+  agent_id TEXT,                          -- For agent messages
+  request_id TEXT,                        -- API request ID
+  git_branch TEXT,
+  cwd TEXT,
+  metadata TEXT,                          -- JSON: full message metadata
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE,
+  FOREIGN KEY (parent_id) REFERENCES messages(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_msg_conv ON messages(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_msg_parent ON messages(parent_id);
+CREATE INDEX IF NOT EXISTS idx_msg_type ON messages(message_type);
+CREATE INDEX IF NOT EXISTS idx_msg_time ON messages(timestamp);
+CREATE INDEX IF NOT EXISTS idx_msg_conv_time ON messages(conversation_id, timestamp);
+CREATE INDEX IF NOT EXISTS idx_msg_role ON messages(role);
+
+-- Table 3: Tool Uses
+CREATE TABLE IF NOT EXISTS tool_uses (
+  id TEXT PRIMARY KEY,                    -- tool_use_id (toolu_xxx)
+  message_id TEXT NOT NULL,
+  tool_name TEXT NOT NULL,                -- Bash, Read, Write, Edit, etc.
+  tool_input TEXT NOT NULL,               -- JSON parameters
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_tool_msg ON tool_uses(message_id);
+CREATE INDEX IF NOT EXISTS idx_tool_name ON tool_uses(tool_name);
+CREATE INDEX IF NOT EXISTS idx_tool_time ON tool_uses(timestamp);
+CREATE INDEX IF NOT EXISTS idx_tool_name_time ON tool_uses(tool_name, timestamp);
+
+-- Table 4: Tool Results
+CREATE TABLE IF NOT EXISTS tool_results (
+  id TEXT PRIMARY KEY,
+  tool_use_id TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  content TEXT,
+  is_error INTEGER DEFAULT 0,             -- Boolean as integer
+  stdout TEXT,
+  stderr TEXT,
+  is_image INTEGER DEFAULT 0,             -- Boolean as integer
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (tool_use_id) REFERENCES tool_uses(id) ON DELETE CASCADE,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_result_tool ON tool_results(tool_use_id);
+CREATE INDEX IF NOT EXISTS idx_result_msg ON tool_results(message_id);
+CREATE INDEX IF NOT EXISTS idx_result_error ON tool_results(is_error);
+
+-- Table 5: File Edits
+CREATE TABLE IF NOT EXISTS file_edits (
+  id TEXT PRIMARY KEY,
+  conversation_id TEXT NOT NULL,
+  file_path TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  backup_version INTEGER,
+  backup_time INTEGER,
+  snapshot_timestamp INTEGER NOT NULL,
+  metadata TEXT,                          -- JSON from trackedFileBackups
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_edit_file ON file_edits(file_path);
+CREATE INDEX IF NOT EXISTS idx_edit_conv ON file_edits(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_edit_time ON file_edits(snapshot_timestamp);
+CREATE INDEX IF NOT EXISTS idx_edit_file_time ON file_edits(file_path, snapshot_timestamp);
+
+-- Table 6: Thinking Blocks
+CREATE TABLE IF NOT EXISTS thinking_blocks (
+  id TEXT PRIMARY KEY,
+  message_id TEXT NOT NULL,
+  thinking_content TEXT NOT NULL,
+  signature TEXT,
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_think_msg ON thinking_blocks(message_id);
+
+-- ==================================================
+-- ENHANCED MEMORY TABLES
+-- ==================================================
+
+-- Table 7: Decisions (Critical for preventing regressions)
+CREATE TABLE IF NOT EXISTS decisions (
+  id TEXT PRIMARY KEY,
+  conversation_id TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  decision_text TEXT NOT NULL,
+  rationale TEXT,
+  alternatives_considered TEXT,           -- JSON array
+  rejected_reasons TEXT,                  -- JSON object
+  context TEXT,                           -- What feature/area
+  related_files TEXT,                     -- JSON array
+  related_commits TEXT,                   -- JSON array (git hashes)
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_decision_conv ON decisions(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_decision_time ON decisions(timestamp);
+CREATE INDEX IF NOT EXISTS idx_decision_context ON decisions(context);
+
+-- Table 8: Git Commits (Essential for linking code to conversations)
+CREATE TABLE IF NOT EXISTS git_commits (
+  hash TEXT PRIMARY KEY,
+  message TEXT NOT NULL,
+  author TEXT,
+  timestamp INTEGER NOT NULL,
+  branch TEXT,
+  files_changed TEXT,                     -- JSON array
+  conversation_id TEXT,                   -- Linked conversation
+  related_message_id TEXT,                -- Message that led to commit
+  metadata TEXT,                          -- JSON: stats, etc.
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE SET NULL,
+  FOREIGN KEY (related_message_id) REFERENCES messages(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_commit_conv ON git_commits(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_commit_time ON git_commits(timestamp);
+CREATE INDEX IF NOT EXISTS idx_commit_branch ON git_commits(branch);
+
+-- Table 9: Mistakes (Learning from errors)
+CREATE TABLE IF NOT EXISTS mistakes (
+  id TEXT PRIMARY KEY,
+  conversation_id TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  mistake_type TEXT NOT NULL,             -- logic_error, wrong_approach, misunderstanding
+  what_went_wrong TEXT NOT NULL,
+  correction TEXT,
+  user_correction_message TEXT,
+  files_affected TEXT,                    -- JSON array
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_mistake_conv ON mistakes(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_mistake_type ON mistakes(mistake_type);
+CREATE INDEX IF NOT EXISTS idx_mistake_time ON mistakes(timestamp);
+
+-- Table 10: File Evolution (Timeline tracking)
+CREATE TABLE IF NOT EXISTS file_evolution (
+  id TEXT PRIMARY KEY,
+  file_path TEXT NOT NULL,
+  conversation_id TEXT NOT NULL,
+  change_summary TEXT,
+  decision_ids TEXT,                      -- JSON array
+  commit_hash TEXT,
+  fixes_mistake_id TEXT,
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE,
+  FOREIGN KEY (commit_hash) REFERENCES git_commits(hash) ON DELETE SET NULL,
+  FOREIGN KEY (fixes_mistake_id) REFERENCES mistakes(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_evolution_file ON file_evolution(file_path);
+CREATE INDEX IF NOT EXISTS idx_evolution_time ON file_evolution(timestamp);
+CREATE INDEX IF NOT EXISTS idx_evolution_file_time ON file_evolution(file_path, timestamp);
+
+-- Table 11: Requirements (Constraints tracking)
+CREATE TABLE IF NOT EXISTS requirements (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,                     -- dependency, performance, compatibility, business
+  description TEXT NOT NULL,
+  rationale TEXT,
+  affects_components TEXT,                -- JSON array
+  conversation_id TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_req_type ON requirements(type);
+CREATE INDEX IF NOT EXISTS idx_req_conv ON requirements(conversation_id);
+
+-- Table 12: Validations (Testing context)
+CREATE TABLE IF NOT EXISTS validations (
+  id TEXT PRIMARY KEY,
+  conversation_id TEXT NOT NULL,
+  what_was_tested TEXT NOT NULL,
+  test_command TEXT,
+  result TEXT NOT NULL,                   -- passed, failed, error
+  performance_data TEXT,                  -- JSON
+  files_tested TEXT,                      -- JSON array
+  timestamp INTEGER NOT NULL,
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_valid_conv ON validations(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_valid_result ON validations(result);
+
+-- Table 13: User Preferences (Pattern learning)
+CREATE TABLE IF NOT EXISTS user_preferences (
+  id TEXT PRIMARY KEY,
+  category TEXT NOT NULL,                 -- coding_style, architecture, tooling
+  preference TEXT NOT NULL,
+  rationale TEXT,
+  examples TEXT,                          -- JSON array of conversation_ids
+  established_date INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_pref_category ON user_preferences(category);
+
+-- ==================================================
+-- VECTOR & SEARCH TABLES
+-- ==================================================
+
+-- Table 14: Message Embeddings (for semantic search)
+CREATE TABLE IF NOT EXISTS message_embeddings (
+  id TEXT PRIMARY KEY,
+  message_id TEXT NOT NULL,
+  content TEXT NOT NULL,
+  embedding BLOB NOT NULL,
+  model_name TEXT DEFAULT 'all-MiniLM-L6-v2',
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_embed_msg ON message_embeddings(message_id);
+
+-- Table 15: Decision Embeddings
+CREATE TABLE IF NOT EXISTS decision_embeddings (
+  id TEXT PRIMARY KEY,
+  decision_id TEXT NOT NULL,
+  embedding BLOB NOT NULL,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (decision_id) REFERENCES decisions(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_dec_embed ON decision_embeddings(decision_id);
+
+-- Table 16: Full-Text Search Index for Messages
+CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
+  id UNINDEXED,
+  content,
+  context,
+  metadata,
+  content=messages,
+  content_rowid=rowid
+);
+
+-- Table 17: Full-Text Search Index for Decisions
+CREATE VIRTUAL TABLE IF NOT EXISTS decisions_fts USING fts5(
+  id UNINDEXED,
+  decision_text,
+  rationale,
+  context,
+  content=decisions,
+  content_rowid=rowid
+);
+
+-- ==================================================
+-- PERFORMANCE & CACHING
+-- ==================================================
+
+-- Query Cache (Performance optimization)
+CREATE TABLE IF NOT EXISTS query_cache (
+  cache_key TEXT PRIMARY KEY,
+  result TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  expires_at INTEGER NOT NULL,
+  hit_count INTEGER DEFAULT 0,
+  last_accessed INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_cache_expires ON query_cache(expires_at);
+
+-- ==================================================
+-- METADATA TABLE
+-- ==================================================
+
+-- Schema Version Tracking
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at INTEGER NOT NULL,
+  description TEXT,
+  checksum TEXT
+);