@damper/mcp 0.3.1 → 0.3.2

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,

package/package.json

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