@damper/mcp 0.1.4 → 0.1.6

package/README.md

@@ -15,12 +15,13 @@ Damper → Settings → API Keys → Generate
 
 ### 2. Configure Your AI Agent
 
-**Claude Code** (`~/.claude.json`):
+**Claude Code** (`~/.claude.json` or `~/.config/claude/claude.json`):
 ```json
 {
   "mcpServers": {
     "damper": {
-      "command": "damper",
+      "command": "npx",
+      "args": ["@damper/mcp"],
       "env": { "DAMPER_API_KEY": "dmp_..." }
     }
   }
@@ -44,16 +45,18 @@ Damper → Settings → API Keys → Generate
 
 Each API key is tied to one project. For multiple projects, configure separate server entries:
 
-**Claude Code** (`~/.claude.json`):
+**Claude Code** (`~/.claude.json` or `~/.config/claude/claude.json`):
 ```json
 {
   "mcpServers": {
     "damper-frontend": {
-      "command": "damper",
+      "command": "npx",
+      "args": ["@damper/mcp"],
       "env": { "DAMPER_API_KEY": "dmp_frontend_xxx" }
     },
     "damper-backend": {
-      "command": "damper",
+      "command": "npx",
+      "args": ["@damper/mcp"],
       "env": { "DAMPER_API_KEY": "dmp_backend_xxx" }
     }
   }
@@ -69,10 +72,11 @@ The AI will see tools from both servers and can distinguish between them:
 | Tool | Description |
 |------|-------------|
 | `list_tasks` | Get roadmap tasks (filter by `status`, `type`) |
-| `get_task` | Task details + linked feedback |
+| `get_task` | Task details + subtasks + linked feedback |
 | `create_task` | Create task with type (bug, feature, improvement, task) |
 | `start_task` | Lock and start task (use `force` to take over) |
 | `add_note` | Add progress note |
+| `update_subtask` | Mark subtask done/undone |
 | `complete_task` | Mark done, release lock |
 | `abandon_task` | Release lock, return to planned |
 | `list_feedback` | Browse user feedback |
@@ -90,6 +94,32 @@ Filter tasks by type to prioritize work:
 
 Types: `bug` 🐛, `feature` ✨, `improvement` 💡, `task` 📌
 
+### Task Metadata
+
+Tasks include project management fields visible in `list_tasks` and `get_task`:
+
+- **Priority**: high 🔴, medium 🟡, low ⚪
+- **Effort**: xs, s, m, l, xl
+- **Labels**: Custom tags
+- **Due date**: Target completion date
+
+### Subtasks
+
+Tasks can have subtasks for tracking incremental progress. Use `get_task` to see subtasks with their IDs:
+
+```
+## Subtasks (2/5)
+- [x] Setup database schema (id: abc123)
+- [ ] Implement API endpoints (id: def456)
+```
+
+Mark subtasks complete as you work:
+
+```
+> Mark the database schema subtask as done
+> Update subtask def456 to done
+```
+
 ### Task Locking
 
 When you start a task, it's locked to prevent other agents from working on it simultaneously:
@@ -105,6 +135,8 @@ When you start a task, it's locked to prevent other agents from working on it si
 > List bugs I can fix
 > Import my TODO.md into Damper
 > Work on the dark mode feature
+> Show me the subtasks for this task
+> Mark the first subtask as done
 > I'm done with the auth task - tests pass
 > Abandon the current task, I'm blocked
 ```

package/dist/index.js

@@ -34,17 +34,30 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.1.0',
+    version: '0.1.6',
 });
 // Output schemas
+const SubtaskProgressSchema = z.object({
+    done: z.number(),
+    total: z.number(),
+}).nullable();
 const TaskSummarySchema = z.object({
     id: z.string(),
     title: z.string(),
     type: z.string(),
     status: z.string(),
     priority: z.string(),
+    effort: z.string().nullable().optional(),
+    labels: z.array(z.string()).optional(),
+    dueDate: z.string().nullable().optional(),
     feedbackCount: z.number(),
     hasImplementationPlan: z.boolean(),
+    subtaskProgress: SubtaskProgressSchema.optional(),
+});
+const SubtaskSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    done: z.boolean(),
 });
 const TaskDetailSchema = z.object({
     id: z.string(),
@@ -53,7 +66,12 @@ const TaskDetailSchema = z.object({
     type: z.string(),
     implementationPlan: z.string().optional(),
     status: z.string(),
+    priority: z.string().nullable().optional(),
+    effort: z.string().nullable().optional(),
+    labels: z.array(z.string()).optional(),
+    dueDate: z.string().nullable().optional(),
     voteScore: z.number(),
+    subtasks: z.array(SubtaskSchema).optional(),
     agentNotes: z.string().optional(),
     feedback: z.array(z.object({
         id: z.string(),
@@ -119,7 +137,8 @@ server.registerTool('list_tasks', {
     const lines = data.tasks.map((t) => {
         const p = t.priority === 'high' ? '🔴' : t.priority === 'medium' ? '🟡' : '⚪';
         const typeIcon = t.type === 'bug' ? '🐛' : t.type === 'feature' ? '✨' : t.type === 'improvement' ? '💡' : '📌';
-        return `• ${t.id}: ${typeIcon} ${t.title} [${t.status}] ${p}${t.hasImplementationPlan ? ' 📋' : ''}`;
+        const subtaskInfo = t.subtaskProgress ? ` [${t.subtaskProgress.done}/${t.subtaskProgress.total}]` : '';
+        return `• ${t.id}: ${typeIcon} ${t.title} [${t.status}] ${p}${t.hasImplementationPlan ? ' 📋' : ''}${subtaskInfo}`;
     });
     return {
         content: [{ type: 'text', text: `Tasks in "${data.project.name}":\n${lines.join('\n')}` }],
@@ -147,10 +166,28 @@ server.registerTool('get_task', {
         `# ${typeIcon} ${t.title}`,
         `Type: ${t.type} | Status: ${t.status} | Score: ${t.voteScore}`,
     ];
+    // Add priority/effort/labels if present
+    const meta = [];
+    if (t.priority)
+        meta.push(`Priority: ${t.priority}`);
+    if (t.effort)
+        meta.push(`Effort: ${t.effort}`);
+    if (t.dueDate)
+        meta.push(`Due: ${t.dueDate}`);
+    if (t.labels && t.labels.length)
+        meta.push(`Labels: ${t.labels.join(', ')}`);
+    if (meta.length)
+        parts.push(meta.join(' | '));
     if (t.description)
         parts.push(`\n## Description\n${t.description}`);
     if (t.implementationPlan)
         parts.push(`\n## Plan\n${t.implementationPlan}`);
+    // Show subtasks
+    if (t.subtasks && t.subtasks.length) {
+        const done = t.subtasks.filter(s => s.done).length;
+        parts.push(`\n## Subtasks (${done}/${t.subtasks.length})`);
+        t.subtasks.forEach((s) => parts.push(`- [${s.done ? 'x' : ' '}] ${s.title} (id: ${s.id})`));
+    }
     if (t.agentNotes)
         parts.push(`\n## Notes\n${t.agentNotes}`);
     if (t.feedback.length) {
@@ -273,6 +310,43 @@ server.registerTool('add_note', {
         structuredContent: { taskId, success: true },
     };
 });
+// Tool: Update subtask
+server.registerTool('update_subtask', {
+    title: 'Update Subtask',
+    description: 'Mark a subtask as done or not done. Use get_task to see subtask IDs.',
+    inputSchema: z.object({
+        taskId: z.string().describe('Task ID'),
+        subtaskId: z.string().describe('Subtask ID'),
+        done: z.boolean().describe('Whether the subtask is done'),
+    }),
+    outputSchema: z.object({
+        taskId: z.string(),
+        subtaskId: z.string(),
+        done: z.boolean(),
+        progress: z.object({
+            done: z.number(),
+            total: z.number(),
+        }),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ taskId, subtaskId, done }) => {
+    const result = await api('PATCH', `/api/agent/tasks/${taskId}/subtasks/${subtaskId}`, { done });
+    const status = done ? '✅' : '⬜';
+    return {
+        content: [{ type: 'text', text: `${status} Subtask updated (${result.progress.done}/${result.progress.total} done)` }],
+        structuredContent: {
+            taskId,
+            subtaskId,
+            done: result.done,
+            progress: result.progress,
+        },
+    };
+});
 // Tool: Complete task
 server.registerTool('complete_task', {
     title: 'Complete Task',

package/package.json

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