@damper/mcp 0.3.18 → 0.3.20

package/dist/index.js

@@ -117,10 +117,12 @@ server.registerTool('list_tasks', {
         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'),
         sort: z.enum(['importance', 'newest', 'votes']).optional().describe('Sort order: importance (priority+votes, default), newest, or votes'),
-        limit: z.number().optional(),
+        limit: z.number().optional().describe('Max tasks to return (default: 20)'),
+        offset: z.number().optional().describe('Skip first N tasks for pagination (default: 0)'),
     }),
     outputSchema: z.object({
         project: z.string(),
+        total: z.number(),
         tasks: z.array(TaskSummarySchema),
     }),
     annotations: {
@@ -129,7 +131,7 @@ server.registerTool('list_tasks', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ status, type, quarter, sort, limit }) => {
+}, async ({ status, type, quarter, sort, limit, offset }) => {
     const params = new URLSearchParams();
     if (status)
         params.set('status', status);
@@ -141,13 +143,15 @@ server.registerTool('list_tasks', {
         params.set('sort', sort);
     if (limit)
         params.set('limit', String(limit));
+    if (offset)
+        params.set('offset', String(offset));
     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}"${filters ? ` (${filters})` : ''}` }],
-            structuredContent: { project: data.project.name, tasks: [] },
+            structuredContent: { project: data.project.name, total: 0, tasks: [] },
         };
     }
     const lines = data.tasks.map((t) => {
@@ -157,15 +161,20 @@ server.registerTool('list_tasks', {
         const quarterInfo = t.quarter ? ` 📅${t.quarter}` : '';
         return `• ${t.id}: ${typeIcon} ${t.title} [${t.status}] ${p}${quarterInfo}${t.hasImplementationPlan ? ' 📋' : ''}${subtaskInfo}`;
     });
+    const currentOffset = offset || 0;
+    const paginationInfo = data.total > currentOffset + data.tasks.length
+        ? `\n📄 Showing ${currentOffset + 1}–${currentOffset + data.tasks.length} of ${data.total}. Use offset=${currentOffset + data.tasks.length} to see more.`
+        : '';
     const output = [
-        `Tasks in "${data.project.name}":`,
+        `Tasks in "${data.project.name}" (${data.total} total):`,
         lines.join('\n'),
+        paginationInfo,
         '',
         '💡 **Tip:** Run `get_project_context` first to understand codebase patterns before starting work.',
     ].join('\n');
     return {
         content: [{ type: 'text', text: output }],
-        structuredContent: { project: data.project.name, tasks: data.tasks },
+        structuredContent: { project: data.project.name, total: data.total, tasks: data.tasks },
     };
 });
 // Tool: Get task
@@ -244,6 +253,7 @@ server.registerTool('update_task', {
         'Useful for refining task details as you learn more about the work.',
     inputSchema: z.object({
         taskId: z.string().describe('Task ID'),
+        title: z.string().optional().describe('Task title'),
         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'),
@@ -269,8 +279,10 @@ server.registerTool('update_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId, description, implementationPlan, priority, effort, quarter, labels, isPublic }) => {
+}, async ({ taskId, title, description, implementationPlan, priority, effort, quarter, labels, isPublic }) => {
     const body = {};
+    if (title !== undefined)
+        body.title = title;
     if (description !== undefined)
         body.description = description;
     if (implementationPlan !== undefined)
@@ -287,6 +299,8 @@ server.registerTool('update_task', {
         body.isPublic = isPublic;
     const result = await api('PATCH', `/api/agent/tasks/${taskId}`, body);
     const updates = [];
+    if (title !== undefined)
+        updates.push(`title="${title}"`);
     if (description !== undefined)
         updates.push('description');
     if (implementationPlan !== undefined)
@@ -321,10 +335,12 @@ server.registerTool('create_task', {
     title: 'Create Task',
     description: 'Create a new roadmap task. Use for importing from TODO files or creating work items.',
     inputSchema: z.object({
-        title: z.string(),
+        title: z.string().describe('Task title. Use verb prefix matching the type: ' +
+            'bug → "Fix …", feature → "Add …", improvement → "Improve …", task → "Set up …" / "Update …"'),
         description: z.string().optional(),
         type: z.enum(['bug', 'feature', 'improvement', 'task']).optional().describe('Task type (default: feature)'),
-        status: z.enum(['planned', 'in_progress']).optional(),
+        status: z.enum(['planned', 'in_progress', 'done']).optional(),
+        priority: z.enum(['high', 'medium', 'low']).optional().describe('Task priority'),
         implementationPlan: z.string().optional(),
         isPublic: z.boolean().optional().describe('Whether task is visible on public roadmap (default: true)'),
     }),
@@ -1160,6 +1176,40 @@ server.registerTool('get_feedback', {
         structuredContent: f,
     };
 });
+// Tool: Update feedback
+server.registerTool('update_feedback', {
+    title: 'Update Feedback',
+    description: 'Update feedback status. Use to triage, close, or mark feedback as done.',
+    inputSchema: z.object({
+        feedbackId: z.string().describe('Feedback ID'),
+        status: z
+            .enum(['new', 'under_review', 'planned', 'in_progress', 'done', 'closed'])
+            .describe('New status'),
+    }),
+    outputSchema: z.object({
+        id: z.string(),
+        title: z.string(),
+        status: z.string(),
+        type: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ feedbackId, status }) => {
+    const result = await api('PATCH', `/api/agent/feedback/${feedbackId}`, { status });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Updated feedback "${result.title}" → ${result.status}`,
+            },
+        ],
+        structuredContent: result,
+    };
+});
 // ==================== Issue Reporting ====================
 // Tool: Report issue
 server.registerTool('report_issue', {
@@ -1658,16 +1708,16 @@ server.registerTool('update_changelog', {
         structuredContent: result,
     };
 });
-// Tool: Add roadmap items to changelog
+// Tool: Add tasks to changelog
 server.registerTool('add_to_changelog', {
     title: 'Add to Changelog',
-    description: 'Add completed roadmap items to a changelog. Links the items and appends formatted entries to content.\n\n' +
+    description: 'Add completed tasks to a changelog. Links the tasks and appends formatted entries to content.\n\n' +
         '**When to use:**\n' +
-        '- After completing multiple items that should be in one release\n' +
-        '- To manually add items to a draft changelog',
+        '- After completing multiple tasks that should be in one release\n' +
+        '- To manually add tasks to a draft changelog',
     inputSchema: z.object({
         changelogId: z.string().describe('Changelog ID'),
-        roadmapItemIds: z.array(z.string()).describe('Roadmap item IDs to add'),
+        taskIds: z.array(z.string()).describe('Task IDs to add'),
     }),
     outputSchema: z.object({
         id: z.string(),
@@ -1684,8 +1734,8 @@ server.registerTool('add_to_changelog', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ changelogId, roadmapItemIds }) => {
-    const result = await api('POST', `/api/agent/changelogs/${changelogId}/items`, { roadmapItemIds });
+}, async ({ changelogId, taskIds }) => {
+    const result = await api('POST', `/api/agent/changelogs/${changelogId}/items`, { roadmapItemIds: taskIds });
     const addedTitles = result.addedItems.map((i) => i.title).join(', ');
     return {
         content: [{ type: 'text', text: `📋 Added ${result.addedItems.length} items to "${result.title}": ${addedTitles}` }],

package/package.json

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