@damper/mcp 0.1.6 → 0.1.8

package/README.md

@@ -74,8 +74,10 @@ The AI will see tools from both servers and can distinguish between them:
 | `list_tasks` | Get roadmap tasks (filter by `status`, `type`) |
 | `get_task` | Task details + subtasks + linked feedback |
 | `create_task` | Create task with type (bug, feature, improvement, task) |
+| `update_task` | Update description, plan, priority, effort, labels |
 | `start_task` | Lock and start task (use `force` to take over) |
 | `add_note` | Add progress note |
+| `create_subtask` | Add subtask to a task |
 | `update_subtask` | Mark subtask done/undone |
 | `complete_task` | Mark done, release lock |
 | `abandon_task` | Release lock, return to planned |
@@ -103,6 +105,17 @@ Tasks include project management fields visible in `list_tasks` and `get_task`:
 - **Labels**: Custom tags
 - **Due date**: Target completion date
 
+### Updating Tasks
+
+Refine task details as you work:
+
+```
+> Set priority to high for this task
+> Update the implementation plan with what I've learned
+> Add labels: backend, api, auth
+> Set effort to medium
+```
+
 ### Subtasks
 
 Tasks can have subtasks for tracking incremental progress. Use `get_task` to see subtasks with their IDs:
@@ -113,9 +126,11 @@ Tasks can have subtasks for tracking incremental progress. Use `get_task` to see
 - [ ] Implement API endpoints (id: def456)
 ```
 
-Mark subtasks complete as you work:
+Create and update subtasks as you work:
 
 ```
+> Add a subtask "Write unit tests" to this task
+> Create subtask for database migrations
 > Mark the database schema subtask as done
 > Update subtask def456 to done
 ```

package/dist/index.js

@@ -34,7 +34,7 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.1.6',
+    version: '0.1.8',
 });
 // Output schemas
 const SubtaskProgressSchema = z.object({
@@ -62,9 +62,9 @@ const SubtaskSchema = z.object({
 const TaskDetailSchema = z.object({
     id: z.string(),
     title: z.string(),
-    description: z.string().optional(),
+    description: z.string().nullable().optional(),
     type: z.string(),
-    implementationPlan: z.string().optional(),
+    implementationPlan: z.string().nullable().optional(),
     status: z.string(),
     priority: z.string().nullable().optional(),
     effort: z.string().nullable().optional(),
@@ -72,7 +72,7 @@ const TaskDetailSchema = z.object({
     dueDate: z.string().nullable().optional(),
     voteScore: z.number(),
     subtasks: z.array(SubtaskSchema).optional(),
-    agentNotes: z.string().optional(),
+    agentNotes: z.string().nullable().optional(),
     feedback: z.array(z.object({
         id: z.string(),
         title: z.string(),
@@ -199,6 +199,71 @@ server.registerTool('get_task', {
         structuredContent: t,
     };
 });
+// Tool: Update task
+server.registerTool('update_task', {
+    title: 'Update Task',
+    description: 'Update task fields like description, implementation plan, priority, effort, or labels. ' +
+        'Useful for refining task details as you learn more about the work.',
+    inputSchema: z.object({
+        taskId: z.string().describe('Task ID'),
+        description: z.string().optional().describe('Task description'),
+        implementationPlan: z.string().optional().describe('Implementation plan (markdown)'),
+        priority: z.enum(['high', 'medium', 'low']).nullable().optional().describe('Task priority'),
+        effort: z.enum(['xs', 's', 'm', 'l', 'xl']).nullable().optional().describe('Estimated effort'),
+        labels: z.array(z.string()).optional().describe('Labels/tags'),
+    }),
+    outputSchema: z.object({
+        id: z.string(),
+        title: z.string(),
+        description: z.string().nullable().optional(),
+        implementationPlan: z.string().nullable().optional(),
+        priority: z.string().nullable().optional(),
+        effort: z.string().nullable().optional(),
+        labels: z.array(z.string()).optional(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ taskId, description, implementationPlan, priority, effort, labels }) => {
+    const body = {};
+    if (description !== undefined)
+        body.description = description;
+    if (implementationPlan !== undefined)
+        body.implementationPlan = implementationPlan;
+    if (priority !== undefined)
+        body.priority = priority;
+    if (effort !== undefined)
+        body.effort = effort;
+    if (labels !== undefined)
+        body.labels = labels;
+    const result = await api('PATCH', `/api/agent/tasks/${taskId}`, body);
+    const updates = [];
+    if (description !== undefined)
+        updates.push('description');
+    if (implementationPlan !== undefined)
+        updates.push('plan');
+    if (priority !== undefined)
+        updates.push(`priority=${priority || 'none'}`);
+    if (effort !== undefined)
+        updates.push(`effort=${effort || 'none'}`);
+    if (labels !== undefined)
+        updates.push(`labels=[${labels.join(', ')}]`);
+    return {
+        content: [{ type: 'text', text: `📝 Updated ${result.title}: ${updates.join(', ')}` }],
+        structuredContent: {
+            id: result.id,
+            title: result.title,
+            description: result.description,
+            implementationPlan: result.implementationPlan,
+            priority: result.priority,
+            effort: result.effort,
+            labels: result.labels,
+        },
+    };
+});
 // Tool: Create task
 server.registerTool('create_task', {
     title: 'Create Task',
@@ -310,6 +375,40 @@ server.registerTool('add_note', {
         structuredContent: { taskId, success: true },
     };
 });
+// Tool: Create subtask
+server.registerTool('create_subtask', {
+    title: 'Create Subtask',
+    description: 'Add a new subtask to a task. Useful for breaking down work into smaller steps.',
+    inputSchema: z.object({
+        taskId: z.string().describe('Task ID'),
+        title: z.string().describe('Subtask title'),
+    }),
+    outputSchema: z.object({
+        taskId: z.string(),
+        subtask: z.object({
+            id: z.string(),
+            title: z.string(),
+            done: z.boolean(),
+        }),
+        totalSubtasks: z.number(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+}, async ({ taskId, title }) => {
+    const result = await api('POST', `/api/agent/tasks/${taskId}/subtasks`, { title });
+    return {
+        content: [{ type: 'text', text: `➕ Created subtask: "${result.subtask.title}" (${result.totalSubtasks} total)` }],
+        structuredContent: {
+            taskId,
+            subtask: result.subtask,
+            totalSubtasks: result.totalSubtasks,
+        },
+    };
+});
 // Tool: Update subtask
 server.registerTool('update_subtask', {
     title: 'Update Subtask',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {