@damper/mcp 0.1.8 → 0.1.9

package/README.md

@@ -74,7 +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, labels |
+| `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 |
@@ -102,6 +102,7 @@ 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
 
@@ -114,6 +115,7 @@ Refine task details as you work:
 > Update the implementation plan with what I've learned
 > Add labels: backend, api, auth
 > Set effort to medium
+> Schedule this for Q2 2025
 ```
 
 ### Subtasks

package/dist/index.js

@@ -34,7 +34,7 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.1.8',
+    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)
@@ -202,7 +207,7 @@ server.registerTool('get_task', {
 // Tool: Update task
 server.registerTool('update_task', {
     title: 'Update Task',
-    description: 'Update task fields like description, implementation plan, priority, effort, or labels. ' +
+    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'),
@@ -210,6 +215,7 @@ server.registerTool('update_task', {
         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({
@@ -219,6 +225,7 @@ server.registerTool('update_task', {
         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: {
@@ -227,7 +234,7 @@ server.registerTool('update_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId, description, implementationPlan, priority, effort, labels }) => {
+}, async ({ taskId, description, implementationPlan, priority, effort, quarter, labels }) => {
     const body = {};
     if (description !== undefined)
         body.description = description;
@@ -237,6 +244,8 @@ server.registerTool('update_task', {
         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);
@@ -249,6 +258,8 @@ server.registerTool('update_task', {
         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 {
@@ -260,6 +271,7 @@ server.registerTool('update_task', {
             implementationPlan: result.implementationPlan,
             priority: result.priority,
             effort: result.effort,
+            quarter: result.quarter,
             labels: result.labels,
         },
     };

package/package.json

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