@hivehub/rulebook 4.4.1 → 5.0.0

package/dist/mcp/rulebook-server.js

@@ -17,7 +17,13 @@ function withTimeout(promise, ms = MCP_TOOL_TIMEOUT_MS, label = 'tool') {
         const timer = setTimeout(() => {
             reject(new Error(`[rulebook-mcp] ${label} timed out after ${ms}ms`));
         }, ms);
-        promise.then((val) => { clearTimeout(timer); resolve(val); }, (err) => { clearTimeout(timer); reject(err); });
+        promise.then((val) => {
+            clearTimeout(timer);
+            resolve(val);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
     });
 }
 // Find .rulebook file/directory by walking up directories
@@ -152,7 +158,7 @@ export async function startRulebookMcpServer() {
     }
     const server = new McpServer({
         name: 'rulebook-task-management',
-        version: '4.4.1',
+        version: '5.0.0',
     });
     // --- Wrap all tool handlers with timeout guard ---
     // Intercept registerTool to automatically add timeout protection to every handler.
@@ -166,7 +172,9 @@ export async function startRulebookMcpServer() {
                 const msg = error instanceof Error ? error.message : String(error);
                 console.error(`[rulebook-mcp] ${name} error: ${msg}`);
                 return {
-                    content: [{ type: 'text', text: JSON.stringify({ success: false, error: msg }) }],
+                    content: [
+                        { type: 'text', text: JSON.stringify({ success: false, error: msg }) },
+                    ],
                 };
             }
         };
@@ -1046,12 +1054,9 @@ export async function startRulebookMcpServer() {
                         ],
                     };
                 }
-                // Ensure lock is released on exit, even on crashes
-                const cleanupLock = async () => {
-                    await ralphManager.releaseLock();
-                };
-                process.on('SIGTERM', cleanupLock);
-                process.on('SIGINT', cleanupLock);
+                // Lock cleanup is handled by the top-level SIGINT handler (line ~858)
+                // which shuts down all managers. Adding per-call SIGINT/SIGTERM listeners
+                // causes accumulation and race conditions with the server shutdown handler.
                 try {
                     // Validate tool is available before starting
                     const toolCmdNames = {
@@ -1312,8 +1317,6 @@ export async function startRulebookMcpServer() {
                 finally {
                     // Always release lock, even on error
                     await ralphManager.releaseLock();
-                    process.removeListener('SIGTERM', cleanupLock);
-                    process.removeListener('SIGINT', cleanupLock);
                 }
             }
             catch (error) {
@@ -1724,7 +1727,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -1735,7 +1741,10 @@ export async function startRulebookMcpServer() {
         title: 'List Decision Records',
         description: 'List all architectural decision records',
         inputSchema: {
-            status: z.string().optional().describe('Filter by status (proposed, accepted, rejected, superseded, deprecated)'),
+            status: z
+                .string()
+                .optional()
+                .describe('Filter by status (proposed, accepted, rejected, superseded, deprecated)'),
             projectId: projectIdSchema,
         },
     }, async (args) => {
@@ -1760,7 +1769,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -1796,7 +1808,11 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: true, decision: result.decision, content: result.content }),
+                        text: JSON.stringify({
+                            success: true,
+                            decision: result.decision,
+                            content: result.content,
+                        }),
                     },
                 ],
             };
@@ -1806,7 +1822,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -1818,7 +1837,10 @@ export async function startRulebookMcpServer() {
         description: 'Update an existing architectural decision record',
         inputSchema: {
             id: z.number().describe('Decision ID to update'),
-            status: z.string().optional().describe('New status (proposed, accepted, rejected, superseded, deprecated)'),
+            status: z
+                .string()
+                .optional()
+                .describe('New status (proposed, accepted, rejected, superseded, deprecated)'),
             context: z.string().optional().describe('Updated context'),
             decision: z.string().optional().describe('Updated decision text'),
             projectId: projectIdSchema,
@@ -1859,7 +1881,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -1909,7 +1934,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -1946,7 +1974,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -1973,7 +2004,10 @@ export async function startRulebookMcpServer() {
                     content: [
                         {
                             type: 'text',
-                            text: JSON.stringify({ success: false, error: `Knowledge entry "${args.id}" not found` }),
+                            text: JSON.stringify({
+                                success: false,
+                                error: `Knowledge entry "${args.id}" not found`,
+                            }),
                         },
                     ],
                 };
@@ -1992,7 +2026,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -2034,7 +2071,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -2070,7 +2110,10 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };
@@ -2082,7 +2125,9 @@ export async function startRulebookMcpServer() {
         description: 'Promote a learning to a knowledge entry or decision record',
         inputSchema: {
             id: z.string().describe('Learning ID to promote'),
-            target: z.enum(['knowledge', 'decision']).describe('Promote to knowledge base or decision record'),
+            target: z
+                .enum(['knowledge', 'decision'])
+                .describe('Promote to knowledge base or decision record'),
             title: z.string().optional().describe('Override title for the promoted entry'),
             projectId: projectIdSchema,
         },
@@ -2118,7 +2163,214 @@ export async function startRulebookMcpServer() {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }),
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // ── v5.0 Tools: Session Management, Rules, Blockers ──────────────────
+    // Register tool: rulebook_session_start
+    server.registerTool('rulebook_session_start', {
+        title: 'Start Session',
+        description: 'Load session context: reads PLANS.md and searches relevant memories. Call at the start of every session.',
+        inputSchema: {
+            query: z
+                .string()
+                .optional()
+                .describe('Optional search query to find relevant past memories'),
+            projectId: projectIdSchema,
+        },
+    }, async (args) => {
+        try {
+            const root = args.projectId && workspaceManager
+                ? (await workspaceManager.getWorker(args.projectId)).projectRoot
+                : projectRoot;
+            const { join } = await import('path');
+            const { existsSync } = await import('fs');
+            const { readFile } = await import('fs/promises');
+            const result = { plans: null, memories: [] };
+            // Read PLANS.md
+            const plansPath = join(root, '.rulebook', 'PLANS.md');
+            if (existsSync(plansPath)) {
+                result.plans = await readFile(plansPath, 'utf-8');
+            }
+            // Search relevant memories
+            if (args.query && memoryManager) {
+                const searchResults = await memoryManager.searchMemories({
+                    query: args.query,
+                    mode: 'hybrid',
+                    limit: 5,
+                });
+                result.memories = searchResults;
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: true, ...result }) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Register tool: rulebook_session_end
+    server.registerTool('rulebook_session_end', {
+        title: 'End Session',
+        description: 'Save session summary to PLANS.md history section. Call at the end of every session.',
+        inputSchema: {
+            summary: z.string().describe('Session summary: what was accomplished, key decisions, next steps'),
+            projectId: projectIdSchema,
+        },
+    }, async (args) => {
+        try {
+            const root = args.projectId && workspaceManager
+                ? (await workspaceManager.getWorker(args.projectId)).projectRoot
+                : projectRoot;
+            const { join } = await import('path');
+            const { existsSync } = await import('fs');
+            const { readFile, writeFile } = await import('fs/promises');
+            const plansPath = join(root, '.rulebook', 'PLANS.md');
+            const date = new Date().toISOString().split('T')[0];
+            const entry = `### ${date}\n${args.summary}\n`;
+            if (existsSync(plansPath)) {
+                let content = await readFile(plansPath, 'utf-8');
+                // Insert after <!-- PLANS:HISTORY:START -->
+                if (content.includes('<!-- PLANS:HISTORY:START -->')) {
+                    content = content.replace('<!-- PLANS:HISTORY:START -->', `<!-- PLANS:HISTORY:START -->\n${entry}`);
+                }
+                else {
+                    content += `\n## Session History\n\n<!-- PLANS:HISTORY:START -->\n${entry}<!-- PLANS:HISTORY:END -->\n`;
+                }
+                await writeFile(plansPath, content, 'utf-8');
+            }
+            else {
+                // Create PLANS.md from scratch
+                const newContent = `# Project Plans & Session Context\n\n<!-- PLANS:CONTEXT:START -->\n_No active context._\n<!-- PLANS:CONTEXT:END -->\n\n<!-- PLANS:TASK:START -->\n_No task in progress._\n<!-- PLANS:TASK:END -->\n\n## Session History\n\n<!-- PLANS:HISTORY:START -->\n${entry}<!-- PLANS:HISTORY:END -->\n`;
+                const { mkdirSync } = await import('fs');
+                const dir = join(root, '.rulebook');
+                if (!existsSync(dir))
+                    mkdirSync(dir, { recursive: true });
+                await writeFile(plansPath, newContent, 'utf-8');
+            }
+            // Also save to memory if available
+            if (memoryManager) {
+                await memoryManager.saveMemory({
+                    type: 'observation',
+                    title: `Session summary ${date}`,
+                    content: args.summary,
+                    tags: ['session', 'summary'],
+                });
+            }
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify({ success: true, message: 'Session summary saved to PLANS.md' }) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Register tool: rulebook_rules_list
+    server.registerTool('rulebook_rules_list', {
+        title: 'List Rules',
+        description: 'List all canonical rules from .rulebook/rules/ with tier and tool targeting info',
+        inputSchema: {
+            projectId: projectIdSchema,
+        },
+    }, async (args) => {
+        try {
+            const root = args.projectId && workspaceManager
+                ? (await workspaceManager.getWorker(args.projectId)).projectRoot
+                : projectRoot;
+            const { listRules } = await import('../core/rule-engine.js');
+            const rules = await listRules(root);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: true, rules, count: rules.length }) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Register tool: rulebook_blockers
+    server.registerTool('rulebook_blockers', {
+        title: 'Show Blockers',
+        description: 'Show task blocker chain with cascade impact analysis',
+        inputSchema: {
+            projectId: projectIdSchema,
+        },
+    }, async (args) => {
+        try {
+            const tm = await getTaskMgr(args.projectId);
+            const tasks = await tm.listTasks();
+            // Build blocker chain from task metadata
+            const blockers = [];
+            for (const task of tasks) {
+                const metadata = await tm.getTaskMetadata(task.id);
+                const blocks = Array.isArray(metadata?.blocks) ? metadata.blocks : [];
+                const blockedBy = Array.isArray(metadata?.blockedBy) ? metadata.blockedBy : [];
+                if (blocks.length > 0 || blockedBy.length > 0) {
+                    blockers.push({
+                        taskId: task.id,
+                        blocks,
+                        blockedBy,
+                        cascadeImpact: metadata?.cascadeImpact || blocks.length,
+                    });
+                }
+            }
+            // Sort by cascade impact (highest first)
+            blockers.sort((a, b) => b.cascadeImpact - a.cascadeImpact);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ success: true, blockers, count: blockers.length }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }),
                     },
                 ],
             };