kanban-lite 1.0.9 → 1.0.13

package/src/mcp-server/index.ts

@@ -4,7 +4,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod'
 import { KanbanSDK } from '../sdk/KanbanSDK'
-import type { FeatureStatus, Priority } from '../shared/types'
+import type { Priority } from '../shared/types'
 import { readConfig, writeConfig, configToSettings, settingsToConfig } from '../shared/config'
 import { loadWebhooks, createWebhook, deleteWebhook } from '../standalone/webhooks'
 
@@ -60,19 +60,77 @@ async function main(): Promise<void> {
     version: '1.0.0',
   })
 
+  // --- Board Management Tools ---
+
+  server.tool('list_boards', 'List all kanban boards.', {}, async () => {
+    const boards = sdk.listBoards()
+    return { content: [{ type: 'text' as const, text: JSON.stringify(boards, null, 2) }] }
+  })
+
+  server.tool('create_board', 'Create a new kanban board.', {
+    id: z.string().describe('Board ID (used in directory name)'),
+    name: z.string().describe('Display name'),
+    description: z.string().optional().describe('Board description'),
+    columns: z.array(z.object({ id: z.string(), name: z.string(), color: z.string() })).optional().describe('Board columns (defaults to standard columns)'),
+  }, async ({ id, name, description, columns }) => {
+    try {
+      const board = sdk.createBoard(id, name, { description, columns })
+      return { content: [{ type: 'text' as const, text: JSON.stringify(board, null, 2) }] }
+    } catch (err) {
+      return { content: [{ type: 'text' as const, text: String(err) }], isError: true }
+    }
+  })
+
+  server.tool('get_board', 'Get details of a specific board.', {
+    boardId: z.string().describe('Board ID'),
+  }, async ({ boardId }) => {
+    try {
+      const board = sdk.getBoard(boardId)
+      return { content: [{ type: 'text' as const, text: JSON.stringify({ id: boardId, ...board }, null, 2) }] }
+    } catch (err) {
+      return { content: [{ type: 'text' as const, text: String(err) }], isError: true }
+    }
+  })
+
+  server.tool('delete_board', 'Delete an empty kanban board.', {
+    boardId: z.string().describe('Board ID to delete'),
+  }, async ({ boardId }) => {
+    try {
+      await sdk.deleteBoard(boardId)
+      return { content: [{ type: 'text' as const, text: `Deleted board: ${boardId}` }] }
+    } catch (err) {
+      return { content: [{ type: 'text' as const, text: String(err) }], isError: true }
+    }
+  })
+
+  server.tool('transfer_card', 'Transfer a card from one board to another.', {
+    cardId: z.string().describe('Card ID'),
+    fromBoard: z.string().describe('Source board ID'),
+    toBoard: z.string().describe('Target board ID'),
+    targetStatus: z.string().optional().describe('Status in the target board (defaults to board default)'),
+  }, async ({ cardId, fromBoard, toBoard, targetStatus }) => {
+    try {
+      const card = await sdk.transferCard(cardId, fromBoard, toBoard, targetStatus)
+      return { content: [{ type: 'text' as const, text: JSON.stringify(card, null, 2) }] }
+    } catch (err) {
+      return { content: [{ type: 'text' as const, text: String(err) }], isError: true }
+    }
+  })
+
   // --- Card Tools ---
 
   server.tool(
     'list_cards',
     'List all kanban cards. Optionally filter by status, priority, assignee, or label.',
     {
-      status: z.enum(['backlog', 'todo', 'in-progress', 'review', 'done']).optional().describe('Filter by status'),
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
+      status: z.string().optional().describe('Filter by status'),
       priority: z.enum(['critical', 'high', 'medium', 'low']).optional().describe('Filter by priority'),
       assignee: z.string().optional().describe('Filter by assignee name'),
       label: z.string().optional().describe('Filter by label'),
     },
-    async ({ status, priority, assignee, label }) => {
-      let cards = await sdk.listCards()
+    async ({ boardId, status, priority, assignee, label }) => {
+      let cards = await sdk.listCards(undefined, boardId)
       if (status) cards = cards.filter(c => c.status === status)
       if (priority) cards = cards.filter(c => c.priority === priority)
       if (assignee) cards = cards.filter(c => c.assignee === assignee)
@@ -101,13 +159,14 @@ async function main(): Promise<void> {
     'get_card',
     'Get full details of a specific kanban card by ID. Supports partial ID matching.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
     },
-    async ({ cardId }) => {
-      let card = await sdk.getCard(cardId)
+    async ({ boardId, cardId }) => {
+      let card = await sdk.getCard(cardId, boardId)
       if (!card) {
         // Try partial match
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           card = matches[0]
@@ -137,24 +196,26 @@ async function main(): Promise<void> {
     'create_card',
     'Create a new kanban card. Returns the created card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       title: z.string().describe('Card title'),
       body: z.string().optional().describe('Card body/description (markdown)'),
-      status: z.enum(['backlog', 'todo', 'in-progress', 'review', 'done']).optional().describe('Initial status (default: backlog)'),
+      status: z.string().optional().describe('Initial status (default: backlog)'),
       priority: z.enum(['critical', 'high', 'medium', 'low']).optional().describe('Priority level (default: medium)'),
       assignee: z.string().optional().describe('Assignee name'),
       dueDate: z.string().optional().describe('Due date (ISO format or YYYY-MM-DD)'),
       labels: z.array(z.string()).optional().describe('Labels/tags'),
     },
-    async ({ title, body, status, priority, assignee, dueDate, labels }) => {
+    async ({ boardId, title, body, status, priority, assignee, dueDate, labels }) => {
       const content = `# ${title}${body ? '\n\n' + body : ''}`
 
       const card = await sdk.createCard({
         content,
-        status: status as FeatureStatus | undefined,
+        status: status || undefined,
         priority: priority as Priority | undefined,
         assignee: assignee || null,
         dueDate: dueDate || null,
         labels: labels || [],
+        boardId,
       })
 
       return {
@@ -170,20 +231,21 @@ async function main(): Promise<void> {
     'update_card',
     'Update fields of an existing kanban card. Only specified fields are changed.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
-      status: z.enum(['backlog', 'todo', 'in-progress', 'review', 'done']).optional().describe('New status'),
+      status: z.string().optional().describe('New status'),
       priority: z.enum(['critical', 'high', 'medium', 'low']).optional().describe('New priority'),
       assignee: z.string().optional().describe('New assignee'),
       dueDate: z.string().optional().describe('New due date'),
       labels: z.array(z.string()).optional().describe('New labels (replaces existing)'),
       content: z.string().optional().describe('New markdown content (replaces existing body)'),
     },
-    async ({ cardId, status, priority, assignee, dueDate, labels, content }) => {
+    async ({ boardId, cardId, status, priority, assignee, dueDate, labels, content }) => {
       // Resolve partial ID
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -208,7 +270,7 @@ async function main(): Promise<void> {
       if (labels) updates.labels = labels
       if (content !== undefined) updates.content = content
 
-      const updated = await sdk.updateCard(resolvedId, updates)
+      const updated = await sdk.updateCard(resolvedId, updates, boardId)
 
       return {
         content: [{
@@ -223,15 +285,16 @@ async function main(): Promise<void> {
     'move_card',
     'Move a kanban card to a different status column.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
-      status: z.enum(['backlog', 'todo', 'in-progress', 'review', 'done']).describe('Target status column'),
+      status: z.string().describe('Target status column'),
     },
-    async ({ cardId, status }) => {
+    async ({ boardId, cardId, status }) => {
       // Resolve partial ID
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -248,7 +311,7 @@ async function main(): Promise<void> {
         }
       }
 
-      const updated = await sdk.moveCard(resolvedId, status as FeatureStatus)
+      const updated = await sdk.moveCard(resolvedId, status, undefined, boardId)
 
       return {
         content: [{
@@ -263,14 +326,15 @@ async function main(): Promise<void> {
     'delete_card',
     'Permanently delete a kanban card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
     },
-    async ({ cardId }) => {
+    async ({ boardId, cardId }) => {
       // Resolve partial ID
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -287,7 +351,7 @@ async function main(): Promise<void> {
         }
       }
 
-      await sdk.deleteCard(resolvedId)
+      await sdk.deleteCard(resolvedId, boardId)
 
       return {
         content: [{
@@ -304,13 +368,14 @@ async function main(): Promise<void> {
     'list_attachments',
     'List all attachments on a kanban card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
     },
-    async ({ cardId }) => {
+    async ({ boardId, cardId }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -327,7 +392,7 @@ async function main(): Promise<void> {
         }
       }
 
-      const attachments = await sdk.listAttachments(resolvedId)
+      const attachments = await sdk.listAttachments(resolvedId, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -341,14 +406,15 @@ async function main(): Promise<void> {
     'add_attachment',
     'Add a file attachment to a kanban card. Copies the file to the card directory.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
       filePath: z.string().describe('Absolute path to the file to attach'),
     },
-    async ({ cardId, filePath }) => {
+    async ({ boardId, cardId, filePath }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -365,7 +431,7 @@ async function main(): Promise<void> {
         }
       }
 
-      const updated = await sdk.addAttachment(resolvedId, filePath)
+      const updated = await sdk.addAttachment(resolvedId, filePath, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -379,14 +445,15 @@ async function main(): Promise<void> {
     'remove_attachment',
     'Remove an attachment from a kanban card. Only removes the reference, not the file.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
       attachment: z.string().describe('Attachment filename to remove'),
     },
-    async ({ cardId, attachment }) => {
+    async ({ boardId, cardId, attachment }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -403,7 +470,7 @@ async function main(): Promise<void> {
         }
       }
 
-      const updated = await sdk.removeAttachment(resolvedId, attachment)
+      const updated = await sdk.removeAttachment(resolvedId, attachment, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -419,13 +486,14 @@ async function main(): Promise<void> {
     'list_comments',
     'List all comments on a kanban card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
     },
-    async ({ cardId }) => {
+    async ({ boardId, cardId }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -442,7 +510,7 @@ async function main(): Promise<void> {
         }
       }
 
-      const comments = await sdk.listComments(resolvedId)
+      const comments = await sdk.listComments(resolvedId, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -456,15 +524,16 @@ async function main(): Promise<void> {
     'add_comment',
     'Add a comment to a kanban card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
       author: z.string().describe('Comment author name'),
       content: z.string().describe('Comment text (supports markdown)'),
     },
-    async ({ cardId, author, content }) => {
+    async ({ boardId, cardId, author, content }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -481,7 +550,7 @@ async function main(): Promise<void> {
         }
       }
 
-      const updated = await sdk.addComment(resolvedId, author, content)
+      const updated = await sdk.addComment(resolvedId, author, content, boardId)
       const added = updated.comments[updated.comments.length - 1]
       return {
         content: [{
@@ -496,15 +565,16 @@ async function main(): Promise<void> {
     'update_comment',
     'Update the content of a comment on a kanban card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
       commentId: z.string().describe('Comment ID (e.g. "c1")'),
       content: z.string().describe('New comment text'),
     },
-    async ({ cardId, commentId, content }) => {
+    async ({ boardId, cardId, commentId, content }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -522,7 +592,7 @@ async function main(): Promise<void> {
       }
 
       try {
-        const updated = await sdk.updateComment(resolvedId, commentId, content)
+        const updated = await sdk.updateComment(resolvedId, commentId, content, boardId)
         const comment = updated.comments.find(c => c.id === commentId)
         return {
           content: [{
@@ -543,14 +613,15 @@ async function main(): Promise<void> {
     'delete_comment',
     'Delete a comment from a kanban card.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       cardId: z.string().describe('Card ID (or partial ID)'),
       commentId: z.string().describe('Comment ID (e.g. "c1")'),
     },
-    async ({ cardId, commentId }) => {
+    async ({ boardId, cardId, commentId }) => {
       let resolvedId = cardId
-      const card = await sdk.getCard(cardId)
+      const card = await sdk.getCard(cardId, boardId)
       if (!card) {
-        const all = await sdk.listCards()
+        const all = await sdk.listCards(undefined, boardId)
         const matches = all.filter(c => c.id.includes(cardId))
         if (matches.length === 1) {
           resolvedId = matches[0].id
@@ -568,7 +639,7 @@ async function main(): Promise<void> {
       }
 
       try {
-        await sdk.deleteComment(resolvedId, commentId)
+        await sdk.deleteComment(resolvedId, commentId, boardId)
         return {
           content: [{
             type: 'text' as const,
@@ -589,9 +660,11 @@ async function main(): Promise<void> {
   server.tool(
     'list_columns',
     'List all kanban board columns.',
-    {},
-    async () => {
-      const columns = await sdk.listColumns()
+    {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
+    },
+    async ({ boardId }) => {
+      const columns = await sdk.listColumns(boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -605,12 +678,13 @@ async function main(): Promise<void> {
     'add_column',
     'Add a new column to the kanban board.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       id: z.string().describe('Unique column ID (used in card status field)'),
       name: z.string().describe('Display name for the column'),
       color: z.string().describe('Column color (hex format, e.g. "#3b82f6")'),
     },
-    async ({ id, name, color }) => {
-      const columns = await sdk.addColumn({ id, name, color })
+    async ({ boardId, id, name, color }) => {
+      const columns = await sdk.addColumn({ id, name, color }, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -624,15 +698,16 @@ async function main(): Promise<void> {
     'update_column',
     'Update an existing kanban board column.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       columnId: z.string().describe('Column ID to update'),
       name: z.string().optional().describe('New display name'),
       color: z.string().optional().describe('New color (hex format)'),
     },
-    async ({ columnId, name, color }) => {
+    async ({ boardId, columnId, name, color }) => {
       const updates: Record<string, string> = {}
       if (name) updates.name = name
       if (color) updates.color = color
-      const columns = await sdk.updateColumn(columnId, updates)
+      const columns = await sdk.updateColumn(columnId, updates, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -646,10 +721,11 @@ async function main(): Promise<void> {
     'remove_column',
     'Remove a column from the kanban board. Fails if any cards are in the column.',
     {
+      boardId: z.string().optional().describe('Board ID (uses default board if omitted)'),
       columnId: z.string().describe('Column ID to remove'),
     },
-    async ({ columnId }) => {
-      const columns = await sdk.removeColumn(columnId)
+    async ({ boardId, columnId }) => {
+      const columns = await sdk.removeColumn(columnId, boardId)
       return {
         content: [{
           type: 'text' as const,
@@ -690,7 +766,7 @@ async function main(): Promise<void> {
       showFileName: z.boolean().optional().describe('Show file name on cards'),
       compactMode: z.boolean().optional().describe('Enable compact card display'),
       defaultPriority: z.enum(['critical', 'high', 'medium', 'low']).optional().describe('Default priority for new cards'),
-      defaultStatus: z.enum(['backlog', 'todo', 'in-progress', 'review', 'done']).optional().describe('Default status for new cards'),
+      defaultStatus: z.string().optional().describe('Default status for new cards'),
     },
     async (updates) => {
       const config = readConfig(workspaceRoot)