lunaarc-mcp 1.1.0

package/dist/tools/kanban.js

@@ -0,0 +1,488 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kanbanTools = void 0;
+exports.handleKanbanTool = handleKanbanTool;
+// Tool definitions for kanban operations
+exports.kanbanTools = [
+    {
+        name: 'kanban_board_get',
+        description: 'Get the kanban board structure with all columns and cards. Shows the complete workflow including AI Inbox, card titles, priorities, and labels.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'kanban_card_read',
+        description: 'Read detailed information about a specific kanban card. Returns title, description, priority, labels, and timestamps.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                card_id: {
+                    type: 'string',
+                    description: 'The card ID (UUID)',
+                },
+            },
+            required: ['card_id'],
+        },
+    },
+    {
+        name: 'kanban_card_create',
+        description: 'Create a new kanban card in the AI Inbox column. Cards created by AI are automatically placed in the AI Inbox for human review before being moved to the main workflow.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: {
+                    type: 'string',
+                    description: 'The card title (required)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Detailed description of the task or item (optional, supports markdown)',
+                },
+                priority: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'urgent'],
+                    description: 'Priority level (optional, defaults to medium)',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of labels/tags for categorization (optional)',
+                },
+            },
+            required: ['title'],
+        },
+    },
+    {
+        name: 'kanban_card_update',
+        description: 'Update an existing kanban card. Only cards in the AI Inbox that were created by AI can be updated. Human-moved or human-created cards cannot be modified by AI.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                card_id: {
+                    type: 'string',
+                    description: 'The card ID to update (UUID)',
+                },
+                title: {
+                    type: 'string',
+                    description: 'New title (optional)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'New description (optional, supports markdown)',
+                },
+                priority: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'urgent'],
+                    description: 'New priority level (optional)',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New labels array (optional, replaces existing labels)',
+                },
+            },
+            required: ['card_id'],
+        },
+    },
+    {
+        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.
+
+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?
+
+2. Move card to "In Progress" before starting work.
+
+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
+
+4. Only move to "Done" when the task is fully completed.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'kanban_card_move',
+        description: `Move a card that is assigned to this AI to another column. Only works for cards assigned to this AI token.
+
+Target columns:
+- "In Progress" - When starting work on a card
+- "Done" - ONLY when task is fully completed
+- "On Hold" - When card cannot be completed (add explanation to description first!)
+- "Review" - When work needs human review`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                card_id: {
+                    type: 'string',
+                    description: 'The card ID to move (UUID)',
+                },
+                column: {
+                    type: 'string',
+                    description: 'Target column name (e.g., "Done", "In Progress", "On Hold", "Review")',
+                },
+            },
+            required: ['card_id', 'column'],
+        },
+    },
+    {
+        name: 'kanban_assigned_update',
+        description: `Update a card that is assigned to this AI. Works on assigned cards in any column.
+
+Use this to add AI feedback when a card cannot be completed. Add a section like:
+---
+## AI Feedback
+**Status:** Cannot complete / Needs clarification
+**Reason:** [Explain why]
+**Missing:** [What is needed]
+**Suggestion:** [How to resolve]`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                card_id: {
+                    type: 'string',
+                    description: 'The card ID to update (UUID)',
+                },
+                title: {
+                    type: 'string',
+                    description: 'New title (optional)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'New description (optional, supports markdown). Use to add AI feedback.',
+                },
+                priority: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'urgent'],
+                    description: 'New priority level (optional)',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New labels array (optional, replaces existing labels)',
+                },
+            },
+            required: ['card_id'],
+        },
+    },
+    {
+        name: 'kanban_card_comment',
+        description: `Add a comment to a kanban card that is assigned to this AI.
+
+Use this to:
+- Provide status updates on work progress
+- Ask clarifying questions
+- Document decisions or blockers
+- Leave notes for human review
+
+Comments are visible to all team members and provide a transparent record of AI activity on the card.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                card_id: {
+                    type: 'string',
+                    description: 'The card ID to comment on (UUID)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'The comment text (supports markdown)',
+                },
+            },
+            required: ['card_id', 'content'],
+        },
+    },
+];
+// Priority display mapping
+const priorityEmoji = {
+    low: '🟢',
+    medium: '🟡',
+    high: '🟠',
+    urgent: '🔴',
+};
+// Tool handlers
+async function handleKanbanTool(client, toolName, args) {
+    switch (toolName) {
+        case 'kanban_board_get': {
+            const board = await client.getKanbanBoard();
+            let output = `# ${board.board.name}\n`;
+            if (board.board.description) {
+                output += `${board.board.description}\n`;
+            }
+            output += '\n---\n\n';
+            for (const column of board.columns) {
+                // Column header with AI Inbox indicator
+                const aiIndicator = column.is_ai_inbox ? ' 🤖' : '';
+                const colorIndicator = column.color ? ` [${column.color}]` : '';
+                output += `## ${column.name}${aiIndicator}${colorIndicator}\n`;
+                output += `Cards: ${column.card_count}`;
+                if (column.wip_limit) {
+                    output += ` / WIP Limit: ${column.wip_limit}`;
+                }
+                output += '\n\n';
+                if (column.cards.length === 0) {
+                    output += '_No cards_\n\n';
+                }
+                else {
+                    for (const card of column.cards) {
+                        const priority = priorityEmoji[card.priority] || '⚪';
+                        const aiMark = card.created_by_ai ? ' 🤖' : '';
+                        output += `- ${priority} **${card.title}**${aiMark}\n`;
+                        output += `  ID: \`${card.id}\`\n`;
+                        if (card.labels.length > 0) {
+                            output += `  Labels: ${card.labels.map((l) => `\`${l}\``).join(', ')}\n`;
+                        }
+                        if (card.due_date) {
+                            output += `  Due: ${new Date(card.due_date).toLocaleDateString()}\n`;
+                        }
+                    }
+                    output += '\n';
+                }
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        case 'kanban_card_read': {
+            const cardId = args.card_id;
+            if (!cardId) {
+                throw new Error('card_id parameter is required');
+            }
+            const card = await client.getKanbanCard(cardId);
+            const priority = priorityEmoji[card.priority] || '⚪';
+            const aiMark = card.created_by_ai ? '\n**Created by:** AI 🤖' : '';
+            let output = `# ${priority} ${card.title}
+
+**ID:** \`${card.id}\`
+**Priority:** ${card.priority}${aiMark}
+**Created:** ${new Date(card.created_at).toLocaleString()}
+**Updated:** ${new Date(card.updated_at).toLocaleString()}`;
+            if (card.labels.length > 0) {
+                output += `\n**Labels:** ${card.labels.map((l) => `\`${l}\``).join(', ')}`;
+            }
+            if (card.due_date) {
+                output += `\n**Due Date:** ${new Date(card.due_date).toLocaleDateString()}`;
+            }
+            output += '\n\n---\n\n';
+            output += card.description || '_No description_';
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        case 'kanban_card_create': {
+            const title = args.title;
+            const description = args.description;
+            const priority = args.priority;
+            const labels = args.labels;
+            if (!title) {
+                throw new Error('title parameter is required');
+            }
+            const result = await client.createKanbanCard({
+                title,
+                description,
+                priority,
+                labels,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Card created successfully in AI Inbox!
+
+**Card ID:** \`${result.id}\`
+**Title:** ${title}
+${priority ? `**Priority:** ${priority}` : ''}
+${labels && labels.length > 0 ? `**Labels:** ${labels.join(', ')}` : ''}
+
+The card is now in the AI Inbox column and will be reviewed by a team member before being moved to the main workflow.`,
+                    },
+                ],
+            };
+        }
+        case 'kanban_card_update': {
+            const cardId = args.card_id;
+            const title = args.title;
+            const description = args.description;
+            const priority = args.priority;
+            const labels = args.labels;
+            if (!cardId) {
+                throw new Error('card_id parameter is required');
+            }
+            if (!title && !description && !priority && !labels) {
+                throw new Error('At least one field (title, description, priority, labels) must be provided');
+            }
+            await client.updateKanbanCard(cardId, {
+                title,
+                description,
+                priority,
+                labels,
+            });
+            const updates = [];
+            if (title)
+                updates.push(`Title → ${title}`);
+            if (description)
+                updates.push('Description updated');
+            if (priority)
+                updates.push(`Priority → ${priority}`);
+            if (labels)
+                updates.push(`Labels → ${labels.join(', ')}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Card updated successfully!
+
+**Card ID:** \`${cardId}\`
+
+**Changes:**
+${updates.map((u) => `- ${u}`).join('\n')}`,
+                    },
+                ],
+            };
+        }
+        case 'kanban_assigned_get': {
+            const cards = await client.getAIAssignedCards();
+            if (cards.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `# AI Assigned Cards
+
+_No cards are currently assigned to this AI._
+
+To get cards assigned to you, a team member needs to assign a card to this AI token in the Kanban board.`,
+                        },
+                    ],
+                };
+            }
+            let output = `# AI Assigned Cards
+
+**${cards.length} card${cards.length === 1 ? '' : 's'} assigned to this AI**
+
+---
+
+`;
+            for (const card of cards) {
+                const priority = priorityEmoji[card.priority] || '⚪';
+                output += `## ${priority} ${card.title}
+
+**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()}`;
+                }
+                output += '\n\n';
+                output += card.description || '_No description_';
+                output += '\n\n---\n\n';
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        case 'kanban_card_move': {
+            const cardId = args.card_id;
+            const column = args.column;
+            if (!cardId) {
+                throw new Error('card_id parameter is required');
+            }
+            if (!column) {
+                throw new Error('column parameter is required');
+            }
+            await client.moveKanbanCard(cardId, column);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Card moved successfully!
+
+**Card ID:** \`${cardId}\`
+**Moved to:** ${column}
+
+The card has been moved to the "${column}" column.`,
+                    },
+                ],
+            };
+        }
+        case 'kanban_assigned_update': {
+            const cardId = args.card_id;
+            const title = args.title;
+            const description = args.description;
+            const priority = args.priority;
+            const labels = args.labels;
+            if (!cardId) {
+                throw new Error('card_id parameter is required');
+            }
+            if (!title && !description && !priority && !labels) {
+                throw new Error('At least one field (title, description, priority, labels) must be provided');
+            }
+            await client.updateAIAssignedCard(cardId, {
+                title,
+                description,
+                priority,
+                labels,
+            });
+            const updates = [];
+            if (title)
+                updates.push(`Title → ${title}`);
+            if (description)
+                updates.push('Description updated');
+            if (priority)
+                updates.push(`Priority → ${priority}`);
+            if (labels)
+                updates.push(`Labels → ${labels.join(', ')}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Assigned card updated successfully!
+
+**Card ID:** \`${cardId}\`
+
+**Changes:**
+${updates.map((u) => `- ${u}`).join('\n')}`,
+                    },
+                ],
+            };
+        }
+        case 'kanban_card_comment': {
+            const cardId = args.card_id;
+            const content = args.content;
+            if (!cardId) {
+                throw new Error('card_id parameter is required');
+            }
+            if (!content || content.trim().length === 0) {
+                throw new Error('content parameter is required and cannot be empty');
+            }
+            const commentId = await client.addKanbanCardComment(cardId, content.trim());
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Comment added successfully!
+
+**Card ID:** \`${cardId}\`
+**Comment ID:** \`${commentId}\`
+
+Your comment has been added to the card and is visible to all team members.`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown kanban tool: ${toolName}`);
+    }
+}

package/dist/tools/todos.d.ts

@@ -0,0 +1,98 @@
+import { LunaArcApiClient } from '../api/client.js';
+export declare const todosTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            todo_id?: undefined;
+            todo_list_id?: undefined;
+            title?: undefined;
+            description?: undefined;
+            due_date?: undefined;
+            completed?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            todo_id: {
+                type: string;
+                description: string;
+            };
+            todo_list_id?: undefined;
+            title?: undefined;
+            description?: undefined;
+            due_date?: undefined;
+            completed?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            todo_list_id: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            due_date: {
+                type: string;
+                description: string;
+            };
+            todo_id?: undefined;
+            completed?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            todo_id: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            completed: {
+                type: string;
+                description: string;
+            };
+            due_date: {
+                type: string;
+                description: string;
+            };
+            todo_list_id?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function handleTodosTool(client: LunaArcApiClient, toolName: string, args: Record<string, unknown>): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+}>;