simple-memory-mcp 1.1.3

package/dist/services/backup-service.js

@@ -0,0 +1,191 @@
+import { existsSync, mkdirSync, readdirSync, unlinkSync, writeFileSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { debugLog, formatTimestampForFilename } from '../utils/debug.js';
+export class BackupService {
+    config;
+    lastBackupTime = 0;
+    constructor(config) {
+        this.config = {
+            ...config,
+            autoBackupInterval: config.autoBackupInterval || 0,
+            maxBackups: config.maxBackups || 10
+        };
+        // Ensure backup directory exists
+        try {
+            mkdirSync(this.config.backupPath, { recursive: true });
+            debugLog(`Backup directory ready: ${this.config.backupPath}`);
+            // Load lastBackupTime from metadata file (for CLI persistence)
+            this.lastBackupTime = this.getLastBackupTime();
+        }
+        catch (error) {
+            debugLog(`Warning: Could not create backup directory: ${error.message}`);
+        }
+    }
+    /**
+     * Get path to backup metadata file
+     */
+    getMetadataPath() {
+        return join(this.config.backupPath, '.backup-metadata.json');
+    }
+    /**
+     * Save backup metadata
+     * @returns true if saved successfully, false on error
+     */
+    saveMetadata() {
+        try {
+            const metadata = {
+                lastBackupTime: this.lastBackupTime,
+                lastBackupDate: new Date(this.lastBackupTime).toISOString()
+            };
+            writeFileSync(this.getMetadataPath(), JSON.stringify(metadata, null, 2));
+            return true;
+        }
+        catch (error) {
+            debugLog(`Warning: Could not save backup metadata: ${error.message}`);
+            return false;
+        }
+    }
+    /**
+     * Get last backup time from metadata file
+     * @returns timestamp in milliseconds, or 0 if no metadata exists
+     */
+    getLastBackupTime() {
+        try {
+            if (!existsSync(this.config.backupPath)) {
+                debugLog(`Backup path does not exist yet: ${this.config.backupPath}`);
+                return 0;
+            }
+            const metadataPath = this.getMetadataPath();
+            if (existsSync(metadataPath)) {
+                const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+                debugLog(`📋 Loaded backup metadata: last backup at ${metadata.lastBackupDate}`);
+                return metadata.lastBackupTime;
+            }
+            else {
+                debugLog(`📋 No backup metadata found (will create on first backup)`);
+                return 0;
+            }
+        }
+        catch (error) {
+            debugLog(`Warning: Could not read last backup time: ${error.message}`);
+            return 0;
+        }
+    }
+    /**
+     * Create a JSON export backup of all memories
+     */
+    backup(label = 'manual') {
+        try {
+            const timestamp = formatTimestampForFilename();
+            const backupFileName = `smem_${label}_${timestamp}.json`;
+            const backupPath = join(this.config.backupPath, backupFileName);
+            // Get export data
+            const exportData = this.config.getBackupData();
+            // Override source if configured
+            if (this.config.source) {
+                exportData.source = this.config.source;
+            }
+            // Write JSON backup
+            writeFileSync(backupPath, JSON.stringify(exportData, null, 2), 'utf-8');
+            this.lastBackupTime = Date.now();
+            this.saveMetadata(); // Persist backup time
+            debugLog(`✅ Backup created: ${backupPath} (${exportData.totalMemories} memories)`);
+            // Clean up old backups
+            this.cleanupOldBackups();
+            return backupPath;
+        }
+        catch (error) {
+            debugLog(`❌ Backup failed: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Check if backup should be created based on throttle interval
+     */
+    shouldBackup() {
+        // If interval is 0, backup on every write
+        if (!this.config.autoBackupInterval || this.config.autoBackupInterval <= 0) {
+            return true;
+        }
+        const intervalMs = this.config.autoBackupInterval * 60 * 1000;
+        return (Date.now() - this.lastBackupTime) >= intervalMs;
+    }
+    /**
+     * Backup if enough time has passed since last backup (lazy backup on write)
+     */
+    backupIfNeeded() {
+        if (this.shouldBackup()) {
+            return this.backup('auto');
+        }
+        return null;
+    }
+    /**
+     * Initialize lazy backup mode (creates initial backup if needed)
+     * Backups will be created on write operations when interval has passed
+     */
+    initialize() {
+        const intervalMinutes = this.config.autoBackupInterval || 0;
+        debugLog(`Lazy backup enabled (interval: ${intervalMinutes} minutes)`);
+        this.backupIfNeeded();
+    }
+    /**
+     * Clean up old backups, keeping only the most recent N
+     */
+    cleanupOldBackups() {
+        if (this.config.maxBackups <= 0) {
+            return; // Keep all backups
+        }
+        try {
+            const files = readdirSync(this.config.backupPath)
+                .filter(f => f.endsWith('.json') && f.startsWith('smem_'))
+                .map(f => ({
+                name: f,
+                path: join(this.config.backupPath, f)
+            }))
+                // Sort by filename (which contains timestamp) - newest first
+                .sort((a, b) => b.name.localeCompare(a.name));
+            // Delete backups beyond the max count
+            const toDelete = files.slice(this.config.maxBackups);
+            for (const file of toDelete) {
+                try {
+                    unlinkSync(file.path);
+                    debugLog(`Deleted old backup: ${file.name}`);
+                }
+                catch (error) {
+                    debugLog(`Warning: Could not delete old backup: ${error.message}`);
+                }
+            }
+            if (toDelete.length > 0) {
+                debugLog(`Cleaned up ${toDelete.length} old backup(s), kept ${this.config.maxBackups} most recent`);
+            }
+        }
+        catch (error) {
+            debugLog(`Warning: Backup cleanup failed: ${error.message}`);
+        }
+    }
+    /**
+     * Get count of available backups
+     */
+    getBackupCount() {
+        if (!existsSync(this.config.backupPath)) {
+            return 0;
+        }
+        try {
+            return readdirSync(this.config.backupPath)
+                .filter(f => f.endsWith('.json') && f.startsWith('smem_'))
+                .length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Get time since last backup in minutes
+     */
+    getTimeSinceLastBackup() {
+        if (this.lastBackupTime === 0)
+            return -1;
+        return Math.floor((Date.now() - this.lastBackupTime) / 60000);
+    }
+}
+//# sourceMappingURL=backup-service.js.map

package/dist/services/backup-service.js.map

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

package/dist/services/database-optimizer.d.ts

@@ -0,0 +1,15 @@
+import Database from 'better-sqlite3';
+export declare class DatabaseOptimizer {
+    /**
+     * Apply SQLite performance optimizations
+     * Safe to run multiple times (idempotent)
+     *
+     * Set MEMORY_CLOUD_SAFE=true for OneDrive/Dropbox/cloud storage locations
+     */
+    static applyOptimizations(db: Database.Database): void;
+    /**
+     * Optimize FTS5 index (run periodically or after bulk inserts)
+     */
+    static optimizeFTS(db: Database.Database): void;
+}
+//# sourceMappingURL=database-optimizer.d.ts.map

package/dist/services/database-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-optimizer.d.ts","sourceRoot":"","sources":["../../src/services/database-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,qBAAa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IA2BtD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;CAShD"}

package/dist/services/database-optimizer.js

@@ -0,0 +1,45 @@
+import { debugLog } from '../utils/debug.js';
+export class DatabaseOptimizer {
+    /**
+     * Apply SQLite performance optimizations
+     * Safe to run multiple times (idempotent)
+     *
+     * Set MEMORY_CLOUD_SAFE=true for OneDrive/Dropbox/cloud storage locations
+     */
+    static applyOptimizations(db) {
+        const isCloudSafe = process.env.MEMORY_CLOUD_SAFE === 'true';
+        if (isCloudSafe) {
+            // Cloud-safe mode: Use DELETE journal (single file, no WAL shm/wal files)
+            db.pragma('journal_mode = DELETE');
+            debugLog('Database optimizations applied (CLOUD-SAFE MODE)');
+            debugLog('⚠️  Performance reduced for cloud storage compatibility');
+        }
+        else {
+            // Performance mode: WAL allows readers and writers to work simultaneously
+            db.pragma('journal_mode = WAL');
+            debugLog('Database optimizations applied (PERFORMANCE MODE)');
+        }
+        // Larger cache = fewer disk reads = faster queries (64MB)
+        db.pragma('cache_size = -64000');
+        // Store temp tables in memory (faster)
+        db.pragma('temp_store = MEMORY');
+        // Cloud-safe: Use FULL sync for maximum safety, else NORMAL for speed
+        db.pragma(isCloudSafe ? 'synchronous = FULL' : 'synchronous = NORMAL');
+        // Enforce foreign key constraints
+        db.pragma('foreign_keys = ON');
+    }
+    /**
+     * Optimize FTS5 index (run periodically or after bulk inserts)
+     */
+    static optimizeFTS(db) {
+        try {
+            db.exec(`INSERT INTO memories_fts(memories_fts) VALUES('optimize')`);
+            debugLog('FTS index optimized');
+        }
+        catch (error) {
+            // FTS table might not exist yet, that's fine
+            debugLog('FTS optimization skipped:', error.message);
+        }
+    }
+}
+//# sourceMappingURL=database-optimizer.js.map

package/dist/services/database-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-optimizer.js","sourceRoot":"","sources":["../../src/services/database-optimizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,OAAO,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,EAAqB;QAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;QAE7D,IAAI,WAAW,EAAE,CAAC;YAChB,0EAA0E;YAC1E,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;YACnC,QAAQ,CAAC,kDAAkD,CAAC,CAAC;YAC7D,QAAQ,CAAC,yDAAyD,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChC,QAAQ,CAAC,mDAAmD,CAAC,CAAC;QAChE,CAAC;QAED,0DAA0D;QAC1D,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAEjC,uCAAuC;QACvC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAEjC,sEAAsE;QACtE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAEvE,kCAAkC;QAClC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,EAAqB;QACtC,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACrE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,6CAA6C;YAC7C,QAAQ,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/services/memory-service.d.ts

@@ -0,0 +1,126 @@
+import { type MCPConfigPath } from '../utils/mcp-config.js';
+import type { ExportFilters, ImportOptions, ImportResult, ExportFormat } from '../types/tools.js';
+export interface MemoryEntry {
+    id: number;
+    content: string;
+    tags: string[];
+    createdAt: string;
+    hash: string;
+    relevance?: number;
+}
+export interface MemoryRelationship {
+    fromMemoryId: number;
+    toMemoryId: number;
+    relationshipType: string;
+    createdAt: string;
+}
+export interface MemoryStats {
+    version: string;
+    totalMemories: number;
+    totalRelationships: number;
+    dbSize: number;
+    dbPath: string;
+    resolvedPath: string;
+    schemaVersion: number;
+    configPath?: string;
+    backupEnabled?: boolean;
+    backupPath?: string;
+    backupCount?: number;
+    lastBackupAge?: number;
+    nextBackupIn?: number;
+    mcpConfigPaths?: MCPConfigPath[];
+}
+/**
+ * Memory Service for persistent storage and retrieval of memories with tagging and relationships.
+ * Based on SQLite with FTS (Full Text Search) for efficient querying.
+ */
+export declare class MemoryService {
+    private db;
+    private dbPath;
+    private resolvedDbPath;
+    private stmts;
+    private maxContentSize;
+    private backup?;
+    constructor(dbPath?: string, maxContentSize?: number);
+    initialize(): void;
+    private initDb;
+    private prepareStatements;
+    /**
+     * Store a memory with optional tags
+     */
+    store(content: string, tags?: string[]): string;
+    /**
+     * Search memories by content or tags
+     */
+    search(query?: string, tags?: string[], limit?: number, daysAgo?: number, startDate?: string, endDate?: string, minRelevance?: number): MemoryEntry[];
+    /**
+     * Delete a memory by hash
+     */
+    delete(hash: string): boolean;
+    /**
+     * Delete memories by tag
+     */
+    deleteByTag(tag: string): number;
+    /**
+     * Bulk link memories in a single transaction for performance
+     * Returns the number of relationships successfully created
+     */
+    linkMemoriesBulk(relationships: Array<{
+        fromHash: string;
+        toHash: string;
+        relationshipType?: string;
+    }>): number;
+    /**
+     * Link two memories with a relationship
+     */
+    linkMemories(fromHash: string, toHash: string, relationshipType?: string): boolean;
+    /**
+     * Get memories related to a specific memory
+     */
+    getRelated(hash: string, limit?: number): MemoryEntry[];
+    /**
+     * Get statistics about the memory database
+     */
+    stats(): MemoryStats;
+    /**
+     * Update an existing memory by hash
+     * @param hash The hash of the memory to update
+     * @param newContent The new content for the memory
+     * @param newTags Optional new tags (if provided, replaces all existing tags)
+     * @returns The new hash if successful, null if memory not found
+     */
+    update(hash: string, newContent: string, newTags?: string[]): string | null;
+    /**
+     * Get memory by hash
+     */
+    getByHash(hash: string): MemoryEntry | null;
+    /**
+     * Close database connection
+     */
+    close(): void;
+    /**
+     * Create a manual backup
+     */
+    createBackup(label?: string): string | null;
+    /**
+     * Export memories to JSON format with optional filtering
+     */
+    exportMemories(filters?: ExportFilters): ExportFormat;
+    /**
+     * Import memories from JSON format
+     */
+    importMemories(jsonData: string, options?: ImportOptions): ImportResult;
+    /**
+     * Get relationships for a memory
+     */
+    private getMemoryRelationships;
+    /**
+     * Restore relationships after importing memories
+     */
+    private restoreRelationships;
+    /**
+     * Get a memory by its hash
+     */
+    private getMemoryByHash;
+}
+//# sourceMappingURL=memory-service.d.ts.map

package/dist/services/memory-service.d.ts.map

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