agent-world 0.11.1 → 0.12.0

package/dist/core/storage/memory-storage.js

@@ -0,0 +1,415 @@
+import { validateAgentMessageIds } from './validation.js';
+import { createCategoryLogger } from '../logger.js';
+import { EventEmitter } from 'events';
+const logger = createCategoryLogger('storage.memory');
+/**
+ * Deep clone utility for data isolation
+ */
+function deepClone(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof EventEmitter) {
+        // For EventEmitter, create a new instance to preserve functionality
+        const newEmitter = new EventEmitter();
+        // Copy listeners if any exist
+        const events = obj._events;
+        if (events) {
+            newEmitter._events = Object.assign({}, events);
+            newEmitter._eventsCount = obj._eventsCount;
+        }
+        return newEmitter;
+    }
+    if (obj instanceof Map) {
+        const clonedMap = new Map();
+        for (const [key, value] of obj.entries()) {
+            clonedMap.set(key, deepClone(value));
+        }
+        return clonedMap;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => deepClone(item));
+    }
+    const clonedObj = {};
+    for (const key in obj) {
+        if (obj.hasOwnProperty(key)) {
+            clonedObj[key] = deepClone(obj[key]);
+        }
+    }
+    return clonedObj;
+}
+/**
+ * Generate a simple unique ID for testing purposes
+ */
+function generateId() {
+    return Math.random().toString(36).substr(2, 9);
+}
+/**
+ * Memory-based storage implementation
+ */
+export class MemoryStorage {
+    worlds = new Map();
+    agents = new Map(); // worldId -> agentId -> Agent
+    chats = new Map(); // worldId -> chatId -> Chat
+    worldChats = new Map(); // worldId -> chatId -> WorldChat
+    archivedMemory = new Map(); // worldId -> agentId -> archived messages
+    // World operations
+    async saveWorld(worldData) {
+        if (!worldData.id) {
+            throw new Error('World ID is required');
+        }
+        // Exclude runtime properties before cloning and storing
+        const { eventEmitter, agents, chats, eventStorage, _eventPersistenceCleanup, ...persistableWorld } = worldData;
+        // Deep clone to prevent external mutations
+        const clonedWorld = deepClone(persistableWorld);
+        this.worlds.set(worldData.id, clonedWorld);
+    }
+    async loadWorld(worldId) {
+        const world = this.worlds.get(worldId);
+        return world ? deepClone(world) : null;
+    }
+    async deleteWorld(worldId) {
+        const deleted = this.worlds.delete(worldId);
+        if (deleted) {
+            // Clean up related data
+            this.agents.delete(worldId);
+            this.chats.delete(worldId);
+            this.worldChats.delete(worldId);
+            this.archivedMemory.delete(worldId);
+        }
+        return deleted;
+    }
+    async listWorlds() {
+        return Array.from(this.worlds.values()).map(world => deepClone(world));
+    }
+    async worldExists(worldId) {
+        return this.worlds.has(worldId);
+    }
+    async getMemory(worldId, chatId) {
+        const messages = [];
+        const worldAgents = this.agents.get(worldId);
+        if (!worldAgents)
+            return [];
+        for (const agent of worldAgents.values()) {
+            const mem = Array.isArray(agent.memory) ? agent.memory : [];
+            for (const msg of mem) {
+                if (!chatId || msg.chatId === chatId) {
+                    const messageWithAgentId = deepClone(msg);
+                    // Ensure agentId is included in the message
+                    messageWithAgentId.agentId = agent.id;
+                    messages.push(messageWithAgentId);
+                }
+            }
+        }
+        // Sort by createdAt ascending
+        messages.sort((a, b) => {
+            const at = a.createdAt ? new Date(a.createdAt).getTime() : 0;
+            const bt = b.createdAt ? new Date(b.createdAt).getTime() : 0;
+            return at - bt;
+        });
+        return messages;
+    }
+    // Agent operations
+    async saveAgent(worldId, agent) {
+        if (!agent.id) {
+            throw new Error('Agent ID is required');
+        }
+        // CRITICAL: Filter out system messages - they should NEVER be saved to memory
+        // System messages are generated dynamically during LLM preparation
+        const originalMemoryLength = agent.memory.length;
+        agent.memory = agent.memory.filter(msg => msg.role !== 'system');
+        if (agent.memory.length < originalMemoryLength) {
+            logger.warn('Filtered out system messages from agent memory before saving', {
+                agentId: agent.id,
+                worldId,
+                removedCount: originalMemoryLength - agent.memory.length,
+                remainingCount: agent.memory.length
+            });
+        }
+        // Auto-migrate legacy messages without messageId
+        const migrated = validateAgentMessageIds(agent);
+        if (migrated) {
+            logger.info('Auto-migrated agent messages with missing messageIds', {
+                agentId: agent.id,
+                worldId,
+                messageCount: agent.memory.length
+            });
+        }
+        if (!this.agents.has(worldId)) {
+            this.agents.set(worldId, new Map());
+        }
+        const worldAgents = this.agents.get(worldId);
+        worldAgents.set(agent.id, deepClone(agent));
+    }
+    async loadAgent(worldId, agentId) {
+        const worldAgents = this.agents.get(worldId);
+        if (!worldAgents)
+            return null;
+        const agent = worldAgents.get(agentId);
+        if (!agent)
+            return null;
+        const clonedAgent = deepClone(agent);
+        // Auto-migrate on load if needed
+        const migrated = validateAgentMessageIds(clonedAgent);
+        if (migrated) {
+            logger.info('Auto-migrated agent messages on load', {
+                agentId,
+                worldId,
+                messageCount: clonedAgent.memory.length
+            });
+            // Update the stored agent directly (avoid recursive saveAgent call)
+            worldAgents.set(agentId, deepClone(clonedAgent));
+        }
+        return clonedAgent;
+    }
+    async loadAgentWithRetry(worldId, agentId, options) {
+        // For memory storage, no retry is needed as there are no I/O failures
+        return this.loadAgent(worldId, agentId);
+    }
+    async deleteAgent(worldId, agentId) {
+        const worldAgents = this.agents.get(worldId);
+        if (!worldAgents)
+            return false;
+        const deleted = worldAgents.delete(agentId);
+        if (deleted) {
+            // Clean up archived memory for this agent
+            const worldMemory = this.archivedMemory.get(worldId);
+            if (worldMemory) {
+                worldMemory.delete(agentId);
+            }
+        }
+        return deleted;
+    }
+    async listAgents(worldId) {
+        const worldAgents = this.agents.get(worldId);
+        if (!worldAgents)
+            return [];
+        return Array.from(worldAgents.values()).map(agent => deepClone(agent));
+    }
+    async agentExists(worldId, agentId) {
+        const worldAgents = this.agents.get(worldId);
+        return worldAgents ? worldAgents.has(agentId) : false;
+    }
+    async saveAgentMemory(worldId, agentId, memory) {
+        const agent = await this.loadAgent(worldId, agentId);
+        if (agent) {
+            agent.memory = deepClone(memory);
+            await this.saveAgent(worldId, agent);
+        }
+    }
+    async archiveMemory(worldId, agentId, memory) {
+        if (!this.archivedMemory.has(worldId)) {
+            this.archivedMemory.set(worldId, new Map());
+        }
+        const worldMemory = this.archivedMemory.get(worldId);
+        const existingArchive = worldMemory.get(agentId) || [];
+        worldMemory.set(agentId, [...existingArchive, ...deepClone(memory)]);
+    }
+    async deleteMemoryByChatId(worldId, chatId) {
+        let deletedCount = 0;
+        const worldAgents = this.agents.get(worldId);
+        if (worldAgents) {
+            for (const [agentId, agent] of worldAgents.entries()) {
+                const originalLength = agent.memory.length;
+                agent.memory = agent.memory.filter(msg => msg.chatId !== chatId);
+                const deleted = originalLength - agent.memory.length;
+                deletedCount += deleted;
+                if (deleted > 0) {
+                    await this.saveAgent(worldId, agent);
+                }
+            }
+        }
+        return deletedCount;
+    }
+    // Batch operations
+    async saveAgentsBatch(worldId, agents) {
+        for (const agent of agents) {
+            await this.saveAgent(worldId, agent);
+        }
+    }
+    async loadAgentsBatch(worldId, agentIds) {
+        const agents = [];
+        for (const agentId of agentIds) {
+            const agent = await this.loadAgent(worldId, agentId);
+            if (agent) {
+                agents.push(agent);
+            }
+        }
+        return agents;
+    }
+    // Chat operations
+    async saveChatData(worldId, chat) {
+        if (!chat.id) {
+            throw new Error('Chat ID is required');
+        }
+        if (!this.chats.has(worldId)) {
+            this.chats.set(worldId, new Map());
+        }
+        const worldChats = this.chats.get(worldId);
+        worldChats.set(chat.id, deepClone(chat));
+    }
+    async loadChatData(worldId, chatId) {
+        const worldChats = this.chats.get(worldId);
+        if (!worldChats)
+            return null;
+        const chat = worldChats.get(chatId);
+        return chat ? deepClone(chat) : null;
+    }
+    async deleteChatData(worldId, chatId) {
+        const worldChats = this.chats.get(worldId);
+        if (!worldChats)
+            return false;
+        const deleted = worldChats.delete(chatId);
+        if (deleted) {
+            // Also clean up world chat snapshots
+            const worldChatSnapshots = this.worldChats.get(worldId);
+            if (worldChatSnapshots) {
+                worldChatSnapshots.delete(chatId);
+            }
+            // Clean up memory associated with this chat
+            await this.deleteMemoryByChatId(worldId, chatId);
+        }
+        return deleted;
+    }
+    async listChats(worldId) {
+        const worldChats = this.chats.get(worldId);
+        if (!worldChats)
+            return [];
+        return Array.from(worldChats.values()).map(chat => deepClone(chat));
+    }
+    async updateChatData(worldId, chatId, updates) {
+        const chat = await this.loadChatData(worldId, chatId);
+        if (!chat)
+            return null;
+        // Apply updates
+        if (updates.name !== undefined)
+            chat.name = updates.name;
+        if (updates.description !== undefined)
+            chat.description = updates.description;
+        if (updates.messageCount !== undefined)
+            chat.messageCount = updates.messageCount;
+        chat.updatedAt = new Date();
+        await this.saveChatData(worldId, chat);
+        return deepClone(chat);
+    }
+    async updateChatNameIfCurrent(worldId, chatId, expectedName, nextName) {
+        const worldChats = this.chats.get(worldId);
+        if (!worldChats)
+            return false;
+        const chat = worldChats.get(chatId);
+        if (!chat)
+            return false;
+        if (chat.name !== expectedName)
+            return false;
+        chat.name = nextName;
+        chat.updatedAt = new Date();
+        worldChats.set(chatId, deepClone(chat));
+        return true;
+    }
+    // World chat operations
+    async saveWorldChat(worldId, chatId, chat) {
+        if (!this.worldChats.has(worldId)) {
+            this.worldChats.set(worldId, new Map());
+        }
+        const worldChatSnapshots = this.worldChats.get(worldId);
+        worldChatSnapshots.set(chatId, deepClone(chat));
+    }
+    async loadWorldChat(worldId, chatId) {
+        const worldChatSnapshots = this.worldChats.get(worldId);
+        if (!worldChatSnapshots)
+            return null;
+        const worldChat = worldChatSnapshots.get(chatId);
+        return worldChat ? deepClone(worldChat) : null;
+    }
+    async loadWorldChatFull(worldId, chatId) {
+        // For memory storage, full and regular load are the same
+        return this.loadWorldChat(worldId, chatId);
+    }
+    async restoreFromWorldChat(worldId, chat) {
+        try {
+            // Restore world state
+            await this.saveWorld(chat.world);
+            // Restore agents
+            for (const agent of chat.agents) {
+                await this.saveAgent(worldId, agent);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('[memory-storage] Failed to restore from world chat:', error);
+            return false;
+        }
+    }
+    // Integrity operations
+    async validateIntegrity(worldId, agentId) {
+        try {
+            if (agentId) {
+                // Validate specific agent
+                const agent = await this.loadAgent(worldId, agentId);
+                return !!agent && typeof agent.id === 'string' && agent.id === agentId;
+            }
+            else {
+                // Validate world
+                const world = await this.loadWorld(worldId);
+                return !!world && typeof world.id === 'string' && world.id === worldId;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    async repairData(worldId, agentId) {
+        // For memory storage, repair is mostly about validation
+        // since data corruption is unlikely in memory
+        return this.validateIntegrity(worldId, agentId);
+    }
+    // Utility methods for testing and debugging
+    /**
+     * Clear all stored data - useful for test cleanup
+     */
+    async clear() {
+        this.worlds.clear();
+        this.agents.clear();
+        this.chats.clear();
+        this.worldChats.clear();
+        this.archivedMemory.clear();
+    }
+    /**
+     * Get storage statistics - useful for debugging
+     */
+    getStats() {
+        let totalAgents = 0;
+        let totalChats = 0;
+        let totalWorldChats = 0;
+        let totalArchivedMemory = 0;
+        for (const worldAgents of this.agents.values()) {
+            totalAgents += worldAgents.size;
+        }
+        for (const worldChats of this.chats.values()) {
+            totalChats += worldChats.size;
+        }
+        for (const worldChatSnapshots of this.worldChats.values()) {
+            totalWorldChats += worldChatSnapshots.size;
+        }
+        for (const worldMemory of this.archivedMemory.values()) {
+            totalArchivedMemory += worldMemory.size;
+        }
+        return {
+            worlds: this.worlds.size,
+            totalAgents,
+            totalChats,
+            totalWorldChats,
+            totalArchivedMemory
+        };
+    }
+}
+/**
+ * Create a new memory storage instance
+ */
+export function createMemoryStorage() {
+    return new MemoryStorage();
+}
+//# sourceMappingURL=memory-storage.js.map

package/dist/core/storage/memory-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.js","sourceRoot":"","sources":["../../../core/storage/memory-storage.ts"],"names":[],"mappings":"AAuDA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;AAEtD;;GAEG;AACH,SAAS,SAAS,CAAI,GAAM;IAC1B,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;QAChC,oEAAoE;QACpE,MAAM,UAAU,GAAG,IAAI,YAAY,EAAE,CAAC;QACtC,8BAA8B;QAC9B,MAAM,MAAM,GAAI,GAAW,CAAC,OAAO,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACV,UAAkB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACvD,UAAkB,CAAC,YAAY,GAAI,GAAW,CAAC,YAAY,CAAC;QAC/D,CAAC;QACD,OAAO,UAAe,CAAC;IACzB,CAAC;IAED,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACzC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,SAAc,CAAC;IACxB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAM,CAAC;IAC/C,CAAC;IAED,MAAM,SAAS,GAAG,EAAO,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAClC,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC,CAAC,8BAA8B;IAC9E,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC,CAAC,4BAA4B;IAC1E,UAAU,GAAG,IAAI,GAAG,EAAkC,CAAC,CAAC,iCAAiC;IACzF,cAAc,GAAG,IAAI,GAAG,EAAuC,CAAC,CAAC,0CAA0C;IAEnH,mBAAmB;IACnB,KAAK,CAAC,SAAS,CAAC,SAAgB;QAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,wDAAwD;QACxD,MAAM,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,YAAY,EACZ,wBAAwB,EACxB,GAAG,gBAAgB,EACpB,GAAG,SAAS,CAAC;QAEd,2CAA2C;QAC3C,MAAM,WAAW,GAAG,SAAS,CAAC,gBAAyB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,wBAAwB;YACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,MAAc;QAC7C,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QAE5B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBACrC,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;oBAC1C,4CAA4C;oBAC5C,kBAAkB,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;oBACtC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,KAAY;QAC3C,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,8EAA8E;QAC9E,mEAAmE;QACnE,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QACjD,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,8DAA8D,EAAE;gBAC1E,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,OAAO;gBACP,YAAY,EAAE,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM;gBACxD,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;aACpC,CAAC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,sDAAsD,EAAE;gBAClE,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,OAAO;gBACP,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;aAClC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QAC9C,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,OAAe;QAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAE9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAErC,iCAAiC;QACjC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;gBAClD,OAAO;gBACP,OAAO;gBACP,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM;aACxC,CAAC,CAAC;YACH,oEAAoE;YACpE,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,OAAe,EAAE,OAAa;QACtE,sEAAsE;QACtE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,OAAe;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAE/B,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,0CAA0C;YAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,WAAW,EAAE,CAAC;gBAChB,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QAE5B,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,OAAe;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,OAAe,EAAE,MAAsB;QAC5E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,OAAe,EAAE,MAAsB;QAC1E,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QACtD,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACvD,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,eAAe,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,MAAc;QACxD,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7C,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrD,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC3C,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;gBACjE,MAAM,OAAO,GAAG,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBACrD,YAAY,IAAI,OAAO,CAAC;gBAExB,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,MAAe;QACpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,QAAkB;QACvD,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,IAAU;QAC5C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QAC5C,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,MAAc;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,MAAc;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAE9B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,qCAAqC;YACrC,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxD,IAAI,kBAAkB,EAAE,CAAC;gBACvB,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAED,4CAA4C;YAC5C,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAE3B,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,MAAc,EAAE,OAAyB;QAC7E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,gBAAgB;QAChB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC9E,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACjF,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,OAAe,EAAE,MAAc,EAAE,YAAoB,EAAE,QAAgB;QACnG,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAE9B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;QAE7C,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,MAAc,EAAE,IAAe;QAClE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QACzD,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,MAAc;QACjD,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,MAAc;QACrD,yDAAyD;QACzD,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,IAAe;QACzD,IAAI,CAAC;YACH,sBAAsB;YACtB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEjC,iBAAiB;YACjB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;YAC5E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,OAAgB;QACvD,IAAI,CAAC;YACH,IAAI,OAAO,EAAE,CAAC;gBACZ,0BAA0B;gBAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACrD,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,iBAAiB;gBACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC5C,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC;YACzE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,OAAgB;QAChD,wDAAwD;QACxD,8CAA8C;QAC9C,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,4CAA4C;IAE5C;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QAON,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAE5B,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC;QAClC,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,kBAAkB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1D,eAAe,IAAI,kBAAkB,CAAC,IAAI,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YACvD,mBAAmB,IAAI,WAAW,CAAC,IAAI,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACxB,WAAW;YACX,UAAU;YACV,eAAe;YACf,mBAAmB;SACpB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}

package/dist/core/storage/migration-runner.d.ts

@@ -0,0 +1,96 @@
+/**
+ * SQL File-Based Migration Runner
+ *
+ * Purpose: Manages database schema migrations using SQL files
+ *
+ * Features:
+ * - Executes SQL migration files in order
+ * - Tracks migration versions in database
+ * - Supports both TypeScript and SQL file migrations
+ * - Prevents concurrent migrations with locks
+ * - Provides rollback support (future enhancement)
+ * - Better error handling and logging
+ *
+ * Migration File Naming Convention:
+ * - {version}_{description}.sql (e.g., 0001_create_events_table.sql)
+ * - Version numbers must be sequential
+ * - Files are executed in numeric order
+ *
+ * Implementation:
+ * - 2025-11-02: Initial implementation replacing inline TypeScript migrations
+ */
+import type { Database } from 'sqlite3';
+export interface MigrationContext {
+    db: Database;
+    migrationsDir: string;
+}
+export interface MigrationFile {
+    version: number;
+    name: string;
+    filePath: string;
+}
+interface MigrationRecord {
+    version: number;
+    name: string;
+    applied_at: string;
+}
+/**
+ * Get current schema version from database
+ */
+export declare function getCurrentVersion(db: Database): Promise<number>;
+/**
+ * Set schema version in database
+ */
+export declare function setVersion(db: Database, version: number): Promise<void>;
+/**
+ * Create migration tracking table if it doesn't exist
+ * This provides better migration history than just PRAGMA user_version
+ */
+export declare function ensureMigrationTable(db: Database): Promise<void>;
+/**
+ * Get list of applied migrations from tracking table
+ */
+export declare function getAppliedMigrations(db: Database): Promise<MigrationRecord[]>;
+/**
+ * Record a migration in the tracking table
+ */
+export declare function recordMigration(db: Database, version: number, name: string): Promise<void>;
+/**
+ * Discover all SQL migration files in the migrations directory
+ */
+export declare function discoverMigrations(migrationsDir: string): MigrationFile[];
+/**
+ * Read and parse SQL migration file
+ */
+export declare function readMigrationFile(filePath: string): string;
+/**
+ * Execute a single migration file
+ */
+export declare function executeMigration(db: Database, migration: MigrationFile): Promise<void>;
+/**
+ * Check if migrations are needed
+ */
+export declare function needsMigration(db: Database, migrationsDir: string): Promise<boolean>;
+/**
+ * Run all pending migrations
+ */
+export declare function runMigrations(ctx: MigrationContext): Promise<void>;
+/**
+ * Get migration status and history
+ */
+export declare function getMigrationStatus(ctx: MigrationContext): Promise<{
+    currentVersion: number;
+    availableMigrations: MigrationFile[];
+    appliedMigrations: MigrationRecord[];
+    pendingMigrations: MigrationFile[];
+}>;
+/**
+ * Validate migration file sequence
+ * Ensures no gaps or duplicates in version numbers
+ */
+export declare function validateMigrationSequence(migrations: MigrationFile[]): {
+    isValid: boolean;
+    errors: string[];
+};
+export {};
+//# sourceMappingURL=migration-runner.d.ts.map

package/dist/core/storage/migration-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.d.ts","sourceRoot":"","sources":["../../../core/storage/migration-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAatE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAUnF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAwBzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC5F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1F;AAKD;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE;AAgDD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,aAAa,EAAE,CAAC;IACrC,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,iBAAiB,EAAE,aAAa,EAAE,CAAC;CACpC,CAAC,CAuBD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA6BA"}