@damper/mcp 0.1.7 → 0.1.9

package/README.md

@@ -74,6 +74,7 @@ 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, quarter, labels |
 | `start_task` | Lock and start task (use `force` to take over) |
 | `add_note` | Add progress note |
 | `create_subtask` | Add subtask to a task |
@@ -101,9 +102,22 @@ Tasks include project management fields visible in `list_tasks` and `get_task`:
 
 - **Priority**: high 🔴, medium 🟡, low ⚪
 - **Effort**: xs, s, m, l, xl
+- **Quarter**: Target quarter (Q1 2025, Q2 2025, etc.)
 - **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
+> Schedule this for Q2 2025
+```
+
 ### Subtasks
 
 Tasks can have subtasks for tracking incremental progress. Use `get_task` to see subtasks with their IDs:

package/dist/index.js

@@ -34,7 +34,7 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.1.7',
+    version: '0.1.9',
 });
 // Output schemas
 const SubtaskProgressSchema = z.object({
@@ -48,6 +48,7 @@ const TaskSummarySchema = z.object({
     status: z.string(),
     priority: z.string(),
     effort: z.string().nullable().optional(),
+    quarter: z.string().nullable().optional(),
     labels: z.array(z.string()).optional(),
     dueDate: z.string().nullable().optional(),
     feedbackCount: z.number(),
@@ -68,6 +69,7 @@ const TaskDetailSchema = z.object({
     status: z.string(),
     priority: z.string().nullable().optional(),
     effort: z.string().nullable().optional(),
+    quarter: z.string().nullable().optional(),
     labels: z.array(z.string()).optional(),
     dueDate: z.string().nullable().optional(),
     voteScore: z.number(),
@@ -138,7 +140,8 @@ server.registerTool('list_tasks', {
         const p = t.priority === 'high' ? '🔴' : t.priority === 'medium' ? '🟡' : '⚪';
         const typeIcon = t.type === 'bug' ? '🐛' : t.type === 'feature' ? '✨' : t.type === 'improvement' ? '💡' : '📌';
         const subtaskInfo = t.subtaskProgress ? ` [${t.subtaskProgress.done}/${t.subtaskProgress.total}]` : '';
-        return `• ${t.id}: ${typeIcon} ${t.title} [${t.status}] ${p}${t.hasImplementationPlan ? ' 📋' : ''}${subtaskInfo}`;
+        const quarterInfo = t.quarter ? ` 📅${t.quarter}` : '';
+        return `• ${t.id}: ${typeIcon} ${t.title} [${t.status}] ${p}${quarterInfo}${t.hasImplementationPlan ? ' 📋' : ''}${subtaskInfo}`;
     });
     return {
         content: [{ type: 'text', text: `Tasks in "${data.project.name}":\n${lines.join('\n')}` }],
@@ -166,12 +169,14 @@ server.registerTool('get_task', {
         `# ${typeIcon} ${t.title}`,
         `Type: ${t.type} | Status: ${t.status} | Score: ${t.voteScore}`,
     ];
-    // Add priority/effort/labels if present
+    // Add priority/effort/quarter/labels if present
     const meta = [];
     if (t.priority)
         meta.push(`Priority: ${t.priority}`);
     if (t.effort)
         meta.push(`Effort: ${t.effort}`);
+    if (t.quarter)
+        meta.push(`Quarter: ${t.quarter}`);
     if (t.dueDate)
         meta.push(`Due: ${t.dueDate}`);
     if (t.labels && t.labels.length)
@@ -199,6 +204,78 @@ 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, quarter, 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'),
+        quarter: z.string().nullable().optional().describe('Target quarter (e.g., "Q1 2025", "Q2 2025")'),
+        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(),
+        quarter: 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, quarter, 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 (quarter !== undefined)
+        body.quarter = quarter;
+    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 (quarter !== undefined)
+        updates.push(`quarter=${quarter || '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,
+            quarter: result.quarter,
+            labels: result.labels,
+        },
+    };
+});
 // Tool: Create task
 server.registerTool('create_task', {
     title: 'Create Task',

package/package.json

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