@damper/mcp 0.3.15 → 0.3.17

package/dist/index.js

@@ -240,10 +240,12 @@ server.registerTool('get_task', {
 // Tool: Update task
 server.registerTool('update_task', {
     title: 'Update Task',
-    description: 'Update task fields like description, implementation plan, priority, effort, quarter, labels, or visibility. ' +
-        'Useful for refining task details as you learn more about the work.',
+    description: 'Update task fields like title, description, implementation plan, priority, effort, quarter, labels, or visibility. ' +
+        'Useful for refining task details as you learn more about the work. ' +
+        'Use title to set a concise task name after planning (especially for CLI-created tasks with placeholder titles).',
     inputSchema: z.object({
         taskId: z.string().describe('Task ID'),
+        title: z.string().optional().describe('Concise task title (e.g., "Fix SSO redirect login flow")'),
         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 +271,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 +291,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)
@@ -372,10 +378,8 @@ server.registerTool('start_task', {
         'Project context contains architecture and patterns you MUST follow.\n\n' +
         '**Workflow after starting:**\n' +
         '1. Read relevant context sections (architecture, conventions, etc.)\n' +
-        '2. add_note: "Session started: <your goal>"\n' +
-        '3. Do work, log commits with add_commit, decisions with add_note\n' +
-        '4. add_note: "Session end: <summary, next steps>"\n' +
-        '5. complete_task (done) or abandon_task (stopping)',
+        '2. Do work, log commits with add_commit\n' +
+        '3. complete_task (done) or abandon_task (stopping)',
     inputSchema: z.object({
         taskId: z.string(),
         force: z.boolean().optional().describe('Take over lock from another agent'),
@@ -430,13 +434,11 @@ server.registerTool('start_task', {
 // Tool: Add note
 server.registerTool('add_note', {
     title: 'Add Note',
-    description: 'Add progress note to task. Notes help future agents continue your work.\n\n' +
+    description: 'Add a note to a task. Use ONLY for non-obvious approach decisions and blockers.\n\n' +
         '**When to use:**\n' +
-        '- Session start: "Session started: implementing X"\n' +
         '- Decisions: "Decision: Using X because Y"\n' +
-        '- Session end: "Session end: Done X, remaining Y, blockers Z"\n\n' +
-        '**For commits:** Use `add_commit` instead for structured commit tracking.\n\n' +
-        '**Important:** Always log session end before complete_task or abandon_task.',
+        '- Blockers: "Blocked: X needs Y before we can proceed"\n\n' +
+        '**Do NOT use for:** Session start/end ceremony, commit logging (use `add_commit`), or restating what code changes do.',
     inputSchema: z.object({
         taskId: z.string(),
         note: z.string(),
@@ -569,16 +571,15 @@ const DocumentationSchema = z.object({
 // Tool: Complete task
 server.registerTool('complete_task', {
     title: 'Complete Task',
-    description: 'Mark task done with summary. Optionally log final commits at completion.\n\n' +
+    description: 'Mark task done with a brief one-line summary. Optionally log final commits at completion.\n\n' +
         '**Before calling:**\n' +
         '1. Push all commits\n' +
-        '2. add_note: "Session end: <what was done>"\n' +
-        '3. Check if project context docs need updating\n\n' +
+        '2. Check if project context docs need updating\n\n' +
         '**Commits:** Pass commits array to log them at completion (convenience for final commits).\n\n' +
         'Returns documentation update suggestions.',
     inputSchema: z.object({
         taskId: z.string(),
-        summary: z.string().describe('What was implemented'),
+        summary: z.string().describe('Brief one-line summary of what was done'),
         commits: z.array(z.object({
             hash: z.string().describe('Commit hash (short or full)'),
             message: z.string().describe('Commit message'),
@@ -607,8 +608,7 @@ server.registerTool('abandon_task', {
     title: 'Abandon Task',
     description: 'Release lock and return task to planned status. Use when stopping work.\n\n' +
         '**Before calling:**\n' +
-        '1. Push any WIP commits\n' +
-        '2. add_note: "Session end: <progress, blockers, next steps>"\n\n' +
+        '1. Push any WIP commits\n\n' +
         '**Summary parameter:** What was done, what remains, blockers. Helps the next agent.',
     inputSchema: z.object({
         taskId: z.string(),
@@ -686,7 +686,6 @@ This project uses Damper MCP for task tracking. **You MUST follow this workflow.
 - \`publish_changelog\` - Publish with optional email notifications and Twitter posting
 
 ### At Session End (MANDATORY)
-- ALWAYS call \`add_note\` with session summary before stopping
 - ALWAYS call \`complete_task\` (if done) or \`abandon_task\` (if stopping early)
 - NEVER leave a started task without completing or abandoning it
 - If you learned something about the codebase, consider updating project context

package/package.json

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