cccmemory 1.8.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,EA4JjC,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;IA2B1C;;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,285 @@
+/**
+ * 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
+    `,
+    },
+    {
+        version: 2,
+        description: "Add source_type column and global index support",
+        up: `
+      ALTER TABLE conversations ADD COLUMN source_type TEXT DEFAULT 'claude-code';
+      CREATE INDEX IF NOT EXISTS idx_conv_source ON conversations(source_type)
+    `,
+        down: `
+      -- SQLite doesn't support DROP COLUMN, would need table recreation
+    `,
+    },
+    {
+        version: 3,
+        description: "Fix messages_fts schema - remove non-existent context column",
+        up: `
+      -- FTS5 virtual tables can't be altered, must drop and recreate
+      -- The old schema had 'context' column which doesn't exist in messages table
+      DROP TABLE IF EXISTS messages_fts;
+      CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
+        id UNINDEXED,
+        content,
+        metadata,
+        content=messages,
+        content_rowid=rowid
+      );
+      -- Rebuild FTS index from messages table
+      INSERT INTO messages_fts(messages_fts) VALUES('rebuild')
+    `,
+        down: `
+      -- Rollback: recreate old (broken) schema
+      DROP TABLE IF EXISTS messages_fts;
+      CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
+        id UNINDEXED,
+        content,
+        context,
+        metadata,
+        content=messages,
+        content_rowid=rowid
+      )
+    `,
+    },
+    {
+        version: 4,
+        description: "Add mistake_embeddings table and mistakes_fts for semantic search",
+        up: `
+      -- Create mistake_embeddings table for semantic search
+      CREATE TABLE IF NOT EXISTS mistake_embeddings (
+        id TEXT PRIMARY KEY,
+        mistake_id TEXT NOT NULL,
+        embedding BLOB NOT NULL,
+        created_at INTEGER NOT NULL,
+        FOREIGN KEY (mistake_id) REFERENCES mistakes(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_mistake_embeddings_mistake_id ON mistake_embeddings(mistake_id);
+
+      -- Create mistakes_fts FTS5 table (standalone, not content-synced)
+      CREATE VIRTUAL TABLE IF NOT EXISTS mistakes_fts USING fts5(
+        id,
+        what_went_wrong,
+        correction,
+        mistake_type
+      );
+      -- Populate FTS from existing mistakes
+      INSERT INTO mistakes_fts(id, what_went_wrong, correction, mistake_type)
+        SELECT id, what_went_wrong, COALESCE(correction, ''), mistake_type FROM mistakes
+    `,
+        down: `
+      DROP TABLE IF EXISTS mistakes_fts;
+      DROP TABLE IF EXISTS mistake_embeddings
+    `,
+    },
+    {
+        version: 5,
+        description: "Add live context layer tables: working_memory, session_handoffs, session_checkpoints",
+        up: `
+      -- Working Memory table for key-value context storage
+      CREATE TABLE IF NOT EXISTS working_memory (
+        id TEXT PRIMARY KEY,
+        key TEXT NOT NULL,
+        value TEXT NOT NULL,
+        context TEXT,
+        tags TEXT,
+        session_id TEXT,
+        project_path TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        expires_at INTEGER,
+        embedding BLOB,
+        UNIQUE(project_path, key)
+      );
+      CREATE INDEX IF NOT EXISTS idx_wm_session ON working_memory(session_id);
+      CREATE INDEX IF NOT EXISTS idx_wm_project ON working_memory(project_path);
+      CREATE INDEX IF NOT EXISTS idx_wm_expires ON working_memory(expires_at);
+      CREATE INDEX IF NOT EXISTS idx_wm_key ON working_memory(key);
+      CREATE INDEX IF NOT EXISTS idx_wm_project_key ON working_memory(project_path, key);
+
+      -- Session Handoffs table for context transfer
+      CREATE TABLE IF NOT EXISTS session_handoffs (
+        id TEXT PRIMARY KEY,
+        from_session_id TEXT NOT NULL,
+        project_path TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        handoff_data TEXT NOT NULL,
+        resumed_by_session_id TEXT,
+        resumed_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS idx_handoff_session ON session_handoffs(from_session_id);
+      CREATE INDEX IF NOT EXISTS idx_handoff_project ON session_handoffs(project_path);
+      CREATE INDEX IF NOT EXISTS idx_handoff_created ON session_handoffs(created_at);
+      CREATE INDEX IF NOT EXISTS idx_handoff_resumed ON session_handoffs(resumed_by_session_id);
+
+      -- Session Checkpoints table for real-time tracking
+      CREATE TABLE IF NOT EXISTS session_checkpoints (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        project_path TEXT NOT NULL,
+        checkpoint_number INTEGER NOT NULL,
+        created_at INTEGER NOT NULL,
+        decisions TEXT,
+        active_files TEXT,
+        task_state TEXT,
+        context_summary TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_checkpoint_session ON session_checkpoints(session_id);
+      CREATE INDEX IF NOT EXISTS idx_checkpoint_project ON session_checkpoints(project_path);
+      CREATE INDEX IF NOT EXISTS idx_checkpoint_created ON session_checkpoints(created_at);
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_checkpoint_session_num ON session_checkpoints(session_id, checkpoint_number);
+
+      -- FTS for working memory
+      CREATE VIRTUAL TABLE IF NOT EXISTS working_memory_fts USING fts5(
+        id UNINDEXED,
+        key,
+        value,
+        context,
+        content=working_memory,
+        content_rowid=rowid
+      )
+    `,
+        down: `
+      DROP TABLE IF EXISTS working_memory_fts;
+      DROP TABLE IF EXISTS session_checkpoints;
+      DROP TABLE IF EXISTS session_handoffs;
+      DROP TABLE IF EXISTS working_memory
+    `,
+    },
+];
+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.error(`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 using db.exec() directly
+            // SQLite handles multiple statements and comments correctly
+            if (migration.up && migration.up.trim()) {
+                this.db.exec(migration.up);
+            }
+            // Record migration
+            this.db
+                .prepare("INSERT INTO schema_version (version, applied_at, description, checksum) VALUES (?, ?, ?, ?)")
+                .run(migration.version, Date.now(), migration.description, checksum);
+        });
+        console.error(`Migration v${migration.version} applied successfully`);
+    }
+    /**
+     * Apply all pending migrations
+     */
+    applyPendingMigrations() {
+        const pending = this.getPendingMigrations();
+        if (pending.length === 0) {
+            console.error("No pending migrations");
+            return;
+        }
+        console.error(`Found ${pending.length} pending migrations`);
+        for (const migration of pending) {
+            this.applyMigration(migration);
+        }
+        console.error("All migrations applied successfully");
+    }
+    /**
+     * Rollback to a specific version
+     */
+    rollbackTo(targetVersion) {
+        const currentVersion = this.getCurrentVersion();
+        if (targetVersion >= currentVersion) {
+            console.error("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.error(`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.error(`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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"}