@grec0/memory-bank-mcp 0.1.30 → 0.1.32

package/dist/common/agentBoardSqlite.js

@@ -115,6 +115,8 @@ export class AgentBoardSqlite {
             SET status = ?, focus = ?, last_heartbeat = ?
             WHERE id = ? AND project_id = ?
         `).run(status, focus, now, resolvedId, this.projectId);
+        // Flush WAL so external readers can see changes
+        databaseManager.flushForExternalReaders();
     }
     /**
      * Update heartbeat for an agent
@@ -127,6 +129,8 @@ export class AgentBoardSqlite {
             SET last_heartbeat = ?
             WHERE id = ? AND project_id = ?
         `).run(now, agentId, this.projectId);
+        // Flush WAL so external readers can see changes
+        databaseManager.flushForExternalReaders();
     }
     /**
      * Get all agents for this project (for session history view)
@@ -283,6 +287,7 @@ export class AgentBoardSqlite {
             WHERE resource = ? AND project_id = ? AND agent_id = ?
         `).run(resource, this.projectId, agentId);
         this.logMessage(agentId, `Released lock on ${resource}`);
+        // Note: logMessage already flushes
     }
     /**
      * Get all locks for this project
@@ -310,6 +315,8 @@ export class AgentBoardSqlite {
             DELETE FROM locks
             WHERE agent_id = ? AND project_id = ?
         `).run(agentId, this.projectId);
+        // Flush WAL so external readers can see changes
+        databaseManager.flushForExternalReaders();
         return result.changes;
     }
     /**
@@ -323,6 +330,8 @@ export class AgentBoardSqlite {
                 SELECT id FROM agents WHERE project_id = ? AND status = 'ACTIVE'
             )
         `).run(this.projectId, this.projectId);
+        // Flush WAL so external readers can see changes
+        databaseManager.flushForExternalReaders();
         return result.changes;
     }
     // ========================================================================
@@ -330,6 +339,7 @@ export class AgentBoardSqlite {
     // ========================================================================
     /**
      * Log a session event
+     * Auto-flushes WAL for external readers since this tracks all agent actions
      */
     logSessionEvent(sessionId, eventType, eventData, agentId) {
         const db = databaseManager.getConnection();
@@ -338,6 +348,8 @@ export class AgentBoardSqlite {
             INSERT INTO session_events (project_id, session_id, agent_id, event_type, event_data, timestamp)
             VALUES (?, ?, ?, ?, ?, ?)
         `).run(this.projectId, sessionId, agentId || null, eventType, JSON.stringify(eventData), now);
+        // Flush WAL so external readers (sql.js) can see changes
+        databaseManager.flushForExternalReaders();
     }
     /**
      * Get session history for a specific session
@@ -390,6 +402,7 @@ export class AgentBoardSqlite {
     // ========================================================================
     /**
      * Log a message
+     * Auto-flushes WAL for external readers since this is called at end of most operations
      */
     logMessage(agentId, message) {
         const db = databaseManager.getConnection();
@@ -398,6 +411,8 @@ export class AgentBoardSqlite {
             INSERT INTO messages (project_id, agent_id, message, timestamp)
             VALUES (?, ?, ?, ?)
         `).run(this.projectId, agentId, message, now);
+        // Flush WAL so external readers (sql.js) can see changes
+        databaseManager.flushForExternalReaders();
     }
     /**
      * Get recent messages
@@ -469,6 +484,8 @@ export function cleanupStaleAgents(staleMinutes = 30) {
         WHERE status = 'ACTIVE' 
         AND datetime(last_heartbeat) < datetime('now', '-' || ? || ' minutes')
     `).run(staleMinutes);
+    // Flush WAL so external readers can see changes
+    databaseManager.flushForExternalReaders();
     return result.changes;
 }
 /**
@@ -482,5 +499,7 @@ export function cleanupAllOrphanedLocks() {
             SELECT id FROM agents WHERE status = 'ACTIVE'
         )
     `).run();
+    // Flush WAL so external readers can see changes
+    databaseManager.flushForExternalReaders();
     return result.changes;
 }

package/dist/common/database.js

@@ -188,11 +188,69 @@ class DatabaseManager {
         return fs.existsSync(this.dbPath);
     }
     /**
-     * Run a transaction with automatic rollback on error
+     * Run a transaction with automatic rollback on error.
+     * Automatically flushes WAL after successful transaction for external readers.
      */
     transaction(fn) {
         const db = this.getConnection();
-        return db.transaction(fn)();
+        const result = db.transaction(fn)();
+        // Auto-flush after any transaction so sql.js can read the changes
+        this.flushForExternalReaders();
+        return result;
+    }
+    /**
+     * Execute a write operation (INSERT, UPDATE, DELETE) and auto-flush WAL.
+     * Use this for single statements that modify data.
+     * For multiple related writes, use transaction() instead.
+     *
+     * @param sql - SQL statement to execute
+     * @param params - Parameters to bind to the statement
+     * @returns RunResult with changes count and lastInsertRowid
+     */
+    runWrite(sql, ...params) {
+        const db = this.getConnection();
+        const result = db.prepare(sql).run(...params);
+        // Auto-flush so sql.js can read the changes immediately
+        this.flushForExternalReaders();
+        return result;
+    }
+    /**
+     * Force WAL checkpoint to flush pending writes to the main database file.
+     * This is necessary for external readers (like sql.js in VS Code extension)
+     * that cannot read WAL files directly.
+     *
+     * @param mode - Checkpoint mode:
+     *   - 'PASSIVE': Checkpoint as much as possible without blocking (default)
+     *   - 'FULL': Wait for all readers, then checkpoint everything
+     *   - 'RESTART': Like FULL, but also restart the WAL file
+     *   - 'TRUNCATE': Like RESTART, but also truncate WAL file to zero bytes
+     * @returns Object with busy (pages that couldn't be checkpointed) and log (total WAL pages)
+     */
+    checkpoint(mode = 'PASSIVE') {
+        if (!this.db) {
+            return { busy: 0, log: 0 };
+        }
+        try {
+            const result = this.db.pragma(`wal_checkpoint(${mode})`);
+            const checkpointResult = result[0] || { busy: 0, log: 0 };
+            // Only log if there were actual pages to flush (reduce noise)
+            if (checkpointResult.log > 0) {
+                console.error(`[Database] WAL checkpoint: ${checkpointResult.log - checkpointResult.busy}/${checkpointResult.log} pages flushed`);
+            }
+            return checkpointResult;
+        }
+        catch (error) {
+            console.error(`[Database] Checkpoint error: ${error}`);
+            return { busy: 0, log: 0 };
+        }
+    }
+    /**
+     * Perform a full checkpoint and ensure all data is written to main DB file.
+     * Called automatically after write operations.
+     * Can also be called manually if needed.
+     */
+    flushForExternalReaders() {
+        this.checkpoint('TRUNCATE');
     }
 }
 // Export singleton instance

package/dist/common/version.js

@@ -1,2 +1,2 @@
 // Version of the MCP Kanban server
-export const VERSION = "0.1.29";
+export const VERSION = "0.1.31";

package/dist/tools/manageAgents.js

@@ -4,7 +4,7 @@ import { sessionState } from '../common/sessionState.js';
 import { sessionLogger } from '../common/sessionLogger.js';
 import os from 'os';
 export async function manageAgentsTool(params) {
-    const { projectId, action, agentId, sessionId, status, focus, resource, workspacePath } = params;
+    const { projectId, action, agentId, sessionId, status, focus, resource, taskId, workspacePath } = params;
     // For register action, workspacePath is REQUIRED to correctly register the project
     if (action === 'register' && !workspacePath) {
         throw new Error('workspacePath is REQUIRED for register action. Please provide the absolute path to the project workspace.');
@@ -72,6 +72,42 @@ export async function manageAgentsTool(params) {
             case 'get_board':
                 const content = await board.getBoardContent();
                 return { success: true, content };
+            case 'complete_task':
+                if (!taskId)
+                    throw new Error('taskId is required for complete_task');
+                const completeAgentId = agentId
+                    ? await board.resolveActiveAgentId(agentId)
+                    : sessionState.getCurrentAgentId() || 'SYSTEM';
+                await board.completeTask(taskId, completeAgentId);
+                return {
+                    success: true,
+                    message: `Task ${taskId} marked as COMPLETED by ${completeAgentId}`,
+                    taskId,
+                    completedBy: completeAgentId
+                };
+            case 'claim_task':
+                if (!taskId)
+                    throw new Error('taskId is required for claim_task');
+                const claimAgentId = agentId
+                    ? await board.resolveActiveAgentId(agentId)
+                    : sessionState.getCurrentAgentId();
+                if (!claimAgentId)
+                    throw new Error('agentId is required for claim_task (or register first)');
+                const taskClaimed = board.claimTask(taskId, claimAgentId);
+                if (taskClaimed) {
+                    return {
+                        success: true,
+                        message: `Task ${taskId} claimed by ${claimAgentId}`,
+                        taskId,
+                        claimedBy: claimAgentId
+                    };
+                }
+                else {
+                    return {
+                        success: false,
+                        message: `Task ${taskId} could not be claimed (already claimed or doesn't exist)`
+                    };
+                }
             default:
                 throw new Error(`Unknown action: ${action}`);
         }
@@ -96,7 +132,7 @@ export const manageAgentsToolDefinition = {
             action: {
                 type: "string",
                 description: "Acción a realizar",
-                enum: ["register", "update_status", "claim_resource", "release_resource", "get_board"],
+                enum: ["register", "update_status", "claim_resource", "release_resource", "get_board", "complete_task", "claim_task"],
             },
             agentId: {
                 type: "string",
@@ -118,9 +154,13 @@ export const manageAgentsToolDefinition = {
                 type: "string",
                 description: "Identificador del recurso a bloquear (ej: 'src/auth/').",
             },
+            taskId: {
+                type: "string",
+                description: "ID de la tarea para complete_task o claim_task (ej: 'EXT-123456', 'TASK-789012').",
+            },
             workspacePath: {
                 type: "string",
-                description: "RUTA ABSOLUTA al directorio raíz del workspace. IMPORTANTE: Debe coincidir con la ruta real del proyecto, no usar rutas relativas.",
+                description: "RUTA ABSOLUTA al directorio raíz del workspace. IMPORTANTE para registro correcto del proyecto.",
             },
         },
         required: ["projectId", "action"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grec0/memory-bank-mcp",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "description": "MCP server for semantic code indexing with Memory Bank - AI-powered codebase understanding",
   "license": "MIT",
   "author": "@grec0",