@damper/mcp 0.3.1 → 0.3.3

package/dist/index.js

@@ -331,7 +331,8 @@ server.registerTool('start_task', {
     title: 'Start Task',
     description: 'Lock and start a task. Fails if locked by another agent unless force=true. ' +
         'Use force=true to take over a task from another agent (e.g., if they abandoned it). ' +
-        'Returns project context index with relevant sections for the task.',
+        'Returns project context index with relevant sections for the task. ' +
+        'Use add_note for session start/end and commits.',
     inputSchema: z.object({
         taskId: z.string(),
         force: z.boolean().optional().describe('Take over lock from another agent'),
@@ -371,6 +372,7 @@ server.registerTool('start_task', {
                 }
             }
         }
+        lines.push('\n💡 Use add_note to log session start, commits, and session end with next steps.');
         return {
             content: [{ type: 'text', text: lines.join('\n') }],
             structuredContent: result,
@@ -404,7 +406,8 @@ server.registerTool('start_task', {
 // Tool: Add note
 server.registerTool('add_note', {
     title: 'Add Note',
-    description: 'Add progress note to task.',
+    description: 'Add progress note to task. Log session start, commits (with hashes), decisions, ' +
+        'and session end with next steps. Notes help future agents continue your work.',
     inputSchema: z.object({
         taskId: z.string(),
         note: z.string(),
@@ -506,7 +509,8 @@ const DocumentationSchema = z.object({
 // Tool: Complete task
 server.registerTool('complete_task', {
     title: 'Complete Task',
-    description: 'Mark task done with summary. Returns documentation update suggestions.',
+    description: 'Mark task done with summary. Include commit hashes and any follow-up work. ' +
+        'Returns documentation update suggestions.',
     inputSchema: z.object({
         taskId: z.string(),
         summary: z.string().describe('What was implemented'),
@@ -537,9 +541,10 @@ server.registerTool('complete_task', {
 server.registerTool('abandon_task', {
     title: 'Abandon Task',
     description: 'Release lock and return task to planned status. Use when you cannot complete the task ' +
-        'or need to stop working on it.',
+        'or need to stop working on it. Optionally provide summary (what done, what remains, blockers) for handoff.',
     inputSchema: z.object({
         taskId: z.string(),
+        summary: z.string().optional().describe('Handoff summary: what was done, what remains, any blockers'),
     }),
     outputSchema: z.object({
         id: z.string(),
@@ -552,8 +557,8 @@ server.registerTool('abandon_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId }) => {
-    const result = await api('POST', `/api/agent/tasks/${taskId}/abandon`);
+}, async ({ taskId, summary }) => {
+    const result = await api('POST', `/api/agent/tasks/${taskId}/abandon`, summary ? { summary } : undefined);
     return {
         content: [{ type: 'text', text: `Abandoned ${result.id}: ${result.message}` }],
         structuredContent: result,
@@ -872,6 +877,49 @@ server.registerTool('get_feedback', {
         structuredContent: f,
     };
 });
+// ==================== Issue Reporting ====================
+// Tool: Report issue
+server.registerTool('report_issue', {
+    title: 'Report Issue',
+    description: 'Report an error, bug, or feature request. Use when encountering issues with MCP tools or to suggest improvements.',
+    inputSchema: z.object({
+        category: z.enum(['error', 'feature_request', 'improvement']).describe('Type of report'),
+        title: z.string().describe('Brief summary of the issue'),
+        description: z.string().describe('Detailed description'),
+        context: z.object({
+            toolName: z.string().optional().describe('MCP tool that encountered the issue'),
+            errorMessage: z.string().optional().describe('Error message if applicable'),
+            taskId: z.string().optional().describe('Related task ID if applicable'),
+        }).optional(),
+    }),
+    outputSchema: z.object({
+        id: z.string(),
+        title: z.string(),
+        type: z.string(),
+        status: z.string(),
+        isDuplicate: z.boolean(),
+        existingIssueId: z.string().nullable(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+}, async ({ category, title, description, context }) => {
+    const result = await api('POST', '/api/agent/reports', { category, title, description, context });
+    const typeIcon = result.type === 'bug' ? '🐛' : result.type === 'feature' ? '✨' : '💡';
+    if (result.isDuplicate) {
+        return {
+            content: [{ type: 'text', text: `⚠️ Similar issue already reported: ${result.existingIssueId} ${typeIcon} "${result.title}"` }],
+            structuredContent: result,
+        };
+    }
+    return {
+        content: [{ type: 'text', text: `✅ Reported: ${result.id} ${typeIcon} "${result.title}" [${result.status}]` }],
+        structuredContent: result,
+    };
+});
 // ==================== Template Tools ====================
 // Tool: List templates
 server.registerTool('list_templates', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/mcp",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.0",
-    "zod": "^3.24.0"
+    "zod": "^3.25.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",