lunaarc-mcp 1.1.4 → 1.2.0

package/dist/server.js

@@ -26,7 +26,7 @@ catch (error) {
 // Create MCP server
 const server = new index_js_1.Server({
     name: 'lunaarc-mcp',
-    version: '1.1.4',
+    version: '1.2.0',
 }, {
     capabilities: {
         tools: {},

package/dist/tools/kanban.js

@@ -89,22 +89,28 @@ exports.kanbanTools = [
     },
     {
         name: 'kanban_assigned_get',
-        description: `Get all kanban cards that are assigned to this AI. Returns cards from any column that have been assigned to this AI token for processing.
+        description: `Get the NEXT kanban card to work on. Returns only ONE card at a time to ensure proper workflow.
 
-IMPORTANT - AI Workflow Guidelines:
-1. BEFORE starting work on a card, verify:
-   - Is the task clearly defined and understandable?
-   - Are all required information/resources available?
-   - Is the task technically feasible?
+IMPORTANT - This tool enforces a strict workflow:
+- If you have a card "In Progress": Only that card is returned (must be completed first!)
+- If no card in progress: The next card from the queue is returned (sorted by priority)
 
-2. Move card to "In Progress" before starting work.
+Card queue sorting:
+1. Column: In Progress > Ready for Development > Backlog
+2. Priority: urgent > high > medium > low
+3. Due date: earliest first
 
-3. If a card CANNOT be completed:
-   - Update the description with a "## AI Feedback" section explaining WHY
-   - Move the card to "On Hold" (not Done!)
-   - Include: reason, missing prerequisites, and suggestions
+WORKFLOW - You MUST follow these steps:
+1. Move card to "In Progress" BEFORE starting work
+2. Complete the task fully and test it
+3. Add a comment with a summary of changes
+4. Move to "Done" only when fully completed
+5. Call this tool again to get the next card
 
-4. Only move to "Done" when the task is fully completed.`,
+If a card CANNOT be completed:
+- Add a "## AI Feedback" section explaining WHY
+- Move to "On Hold" (not Done!)
+- Include: reason, missing prerequisites, suggestions`,
         inputSchema: {
             type: 'object',
             properties: {},
@@ -209,6 +215,29 @@ const priorityEmoji = {
     high: '🟠',
     urgent: '🔴',
 };
+// Column priority for sorting (lower = higher priority)
+const columnPriority = {
+    'In Progress': 0,
+    'Ready for Development': 1,
+    'Backlog': 2,
+};
+// Priority sorting (lower = higher priority)
+const priorityOrder = {
+    urgent: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+// Workflow reminder that gets added to every response
+const WORKFLOW_REMINDER = `
+---
+⚠️ **WORKFLOW - Diese Schritte MÜSSEN eingehalten werden:**
+1. Karte nach "In Progress" verschieben BEVOR du anfängst
+2. Task vollständig erledigen und testen
+3. Kommentar mit Zusammenfassung der Änderungen hinzufügen
+4. Erst nach Abschluss nach "Done" verschieben
+5. Dann erneut \`kanban_assigned_get\` aufrufen für die nächste Karte
+`;
 // Tool handlers
 async function handleKanbanTool(client, toolName, args) {
     switch (toolName) {
@@ -365,38 +394,82 @@ To get cards assigned to you, a team member needs to assign a card to this AI to
                     ],
                 };
             }
-            let output = `# AI Assigned Cards
+            // Sort cards: Column priority > Priority > Due date
+            const sortedCards = [...cards].sort((a, b) => {
+                // 1. Column priority (In Progress > Ready for Development > Backlog)
+                const colA = columnPriority[a.column_name] ?? 99;
+                const colB = columnPriority[b.column_name] ?? 99;
+                if (colA !== colB)
+                    return colA - colB;
+                // 2. Priority (urgent > high > medium > low)
+                const prioA = priorityOrder[a.priority] ?? 99;
+                const prioB = priorityOrder[b.priority] ?? 99;
+                if (prioA !== prioB)
+                    return prioA - prioB;
+                // 3. Due date (earliest first, null at the end)
+                if (a.due_date && b.due_date) {
+                    return new Date(a.due_date).getTime() - new Date(b.due_date).getTime();
+                }
+                if (a.due_date && !b.due_date)
+                    return -1;
+                if (!a.due_date && b.due_date)
+                    return 1;
+                return 0;
+            });
+            // Check if there's a card in "In Progress"
+            const inProgressCard = sortedCards.find((c) => c.column_name === 'In Progress');
+            const totalCards = cards.length;
+            let output = '';
+            let cardToShow;
+            if (inProgressCard) {
+                // There's already a card in progress - MUST finish this first
+                cardToShow = inProgressCard;
+                output = `# ⚠️ KARTE IN BEARBEITUNG
 
-**${cards.length} card${cards.length === 1 ? '' : 's'} assigned to this AI**
+**Du hast bereits eine Karte in "In Progress"!**
+**Diese MUSS zuerst abgeschlossen werden, bevor du eine neue Karte beginnen kannst.**
 
+${totalCards > 1 ? `_(${totalCards - 1} weitere Karte${totalCards > 2 ? 'n' : ''} in der Warteschlange)_\n` : ''}
 ---
 
 `;
-            for (const card of cards) {
-                const priority = priorityEmoji[card.priority] || '⚪';
-                output += `## ${priority} ${card.title}
+            }
+            else {
+                // No card in progress - show the next card from the queue
+                cardToShow = sortedCards[0];
+                output = `# 📋 Nächste Karte
 
-**ID:** \`${card.id}\`
-**Column:** ${card.column_name}
-**Priority:** ${card.priority}`;
-                if (card.labels.length > 0) {
-                    output += `\n**Labels:** ${card.labels.map((l) => `\`${l}\``).join(', ')}`;
-                }
-                if (card.due_date) {
-                    output += `\n**Due:** ${new Date(card.due_date).toLocaleDateString()}`;
-                }
-                // Show assigned AI Agent if present
-                if (card.agent_name) {
-                    output += `\n**AI Agent:** ${card.agent_name}`;
-                }
-                output += '\n\n';
-                output += card.description || '_No description_';
-                // Include agent context if present
-                if (card.agent_content) {
-                    output += `\n\n---\n\n### Agent Instructions\n\n${card.agent_content}`;
-                }
-                output += '\n\n---\n\n';
+**Karte 1 von ${totalCards}** - Schließe diese ab, bevor du die nächste holst.
+
+---
+
+`;
+            }
+            // Render the single card
+            const priority = priorityEmoji[cardToShow.priority] || '⚪';
+            output += `## ${priority} ${cardToShow.title}
+
+**ID:** \`${cardToShow.id}\`
+**Column:** ${cardToShow.column_name}
+**Priority:** ${cardToShow.priority}`;
+            if (cardToShow.labels.length > 0) {
+                output += `\n**Labels:** ${cardToShow.labels.map((l) => `\`${l}\``).join(', ')}`;
+            }
+            if (cardToShow.due_date) {
+                output += `\n**Due:** ${new Date(cardToShow.due_date).toLocaleDateString()}`;
+            }
+            // Show assigned AI Agent if present
+            if (cardToShow.agent_name) {
+                output += `\n**AI Agent:** ${cardToShow.agent_name}`;
+            }
+            output += '\n\n';
+            output += cardToShow.description || '_No description_';
+            // Include agent context if present
+            if (cardToShow.agent_content) {
+                output += `\n\n---\n\n### Agent Instructions\n\n${cardToShow.agent_content}`;
             }
+            // Add workflow reminder at the end
+            output += WORKFLOW_REMINDER;
             return {
                 content: [{ type: 'text', text: output }],
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lunaarc-mcp",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "MCP Server for LunaArc - Access Wiki and Kanban from AI assistants",
   "main": "dist/server.js",
   "bin": {