@damper/mcp 0.1.8 → 0.1.10

package/README.md

@@ -71,10 +71,10 @@ The AI will see tools from both servers and can distinguish between them:
 
 | Tool | Description |
 |------|-------------|
-| `list_tasks` | Get roadmap tasks (filter by `status`, `type`) |
+| `list_tasks` | Get roadmap tasks (filter by `status`, `type`, `quarter`) |
 | `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
@@ -148,6 +150,8 @@ When you start a task, it's locked to prevent other agents from working on it si
 ```
 > What tasks are available?
 > List bugs I can fix
+> Show tasks for Q2 2025
+> What's unscheduled? (quarter: none)
 > Import my TODO.md into Damper
 > Work on the dark mode feature
 > Show me the subtasks for this task

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.10',
 });
 // 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(),
@@ -102,10 +104,11 @@ const FeedbackDetailSchema = z.object({
 server.registerTool('list_tasks', {
     title: 'List Tasks',
     description: 'Get roadmap tasks. Returns planned/in-progress by default. ' +
-        'Filter by type to get bugs, features, etc.',
+        'Filter by type, quarter, etc.',
     inputSchema: z.object({
         status: z.enum(['planned', 'in_progress', 'done', 'all']).optional(),
         type: z.enum(['bug', 'feature', 'improvement', 'task']).optional().describe('Filter by task type'),
+        quarter: z.string().optional().describe('Filter by quarter (e.g., "Q1 2025") or "none" for unscheduled'),
         limit: z.number().optional(),
     }),
     outputSchema: z.object({
@@ -118,19 +121,22 @@ server.registerTool('list_tasks', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ status, type, limit }) => {
+}, async ({ status, type, quarter, limit }) => {
     const params = new URLSearchParams();
     if (status)
         params.set('status', status);
     if (type)
         params.set('type', type);
+    if (quarter)
+        params.set('quarter', quarter);
     if (limit)
         params.set('limit', String(limit));
     const query = params.toString();
     const data = await api('GET', `/api/agent/tasks${query ? `?${query}` : ''}`);
     if (!data.tasks.length) {
+        const filters = [type && `type: ${type}`, quarter && `quarter: ${quarter}`].filter(Boolean).join(', ');
         return {
-            content: [{ type: 'text', text: `No tasks in "${data.project.name}"${type ? ` (type: ${type})` : ''}` }],
+            content: [{ type: 'text', text: `No tasks in "${data.project.name}"${filters ? ` (${filters})` : ''}` }],
             structuredContent: { project: data.project.name, tasks: [] },
         };
     }
@@ -138,7 +144,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 +173,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 +211,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 +219,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 +229,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 +238,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 +248,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 +262,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 +275,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.10",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {