@damper/mcp 0.9.0 → 0.10.0

package/dist/formatters.js

@@ -113,7 +113,7 @@ export function formatReviewTaskResponse(result, assessment) {
             lines.push(`  □ ${item}`);
         }
     }
-    lines.push('\n**Next:** Push commits, then call `complete_task` with summary.');
+    lines.push('\n**Next:** Push commits, then call `complete_task` with summary and `reviewInstructions` (what to test/verify).');
     return lines.join('\n');
 }
 /**

package/dist/index.js

@@ -283,6 +283,8 @@ server.registerTool('update_task', {
         description: z.string().optional().describe('Task description (shown on public roadmap). Write for end users: 1-3 sentences on what changes and why it matters. ' +
             'No code references, file paths, or jargon.'),
         implementationPlan: z.string().optional().describe('Implementation plan (markdown, internal only - never shown publicly)'),
+        reviewInstructions: z.string().optional().describe('Review instructions (markdown, internal only). What the reviewer should test, verify, or check. ' +
+            'Write specific, actionable steps — not a restatement of what was done.'),
         priority: z.enum(['high', 'medium', 'low']).nullable().optional().describe('Task priority'),
         effort: z.enum(['xs', 's', 'm', 'l', 'xl']).nullable().optional().describe('Estimated effort'),
         quarter: z.string().nullable().optional().describe('Target quarter (e.g., "Q1 2025", "Q2 2025")'),
@@ -294,6 +296,7 @@ server.registerTool('update_task', {
         title: z.string(),
         description: z.string().nullable().optional(),
         implementationPlan: z.string().nullable().optional(),
+        reviewInstructions: z.string().nullable().optional(),
         priority: z.string().nullable().optional(),
         effort: z.string().nullable().optional(),
         quarter: z.string().nullable().optional(),
@@ -306,7 +309,7 @@ server.registerTool('update_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId, title, description, implementationPlan, priority, effort, quarter, labels, isPublic }) => {
+}, async ({ taskId, title, description, implementationPlan, reviewInstructions, priority, effort, quarter, labels, isPublic }) => {
     const body = {};
     if (title !== undefined)
         body.title = title;
@@ -314,6 +317,8 @@ server.registerTool('update_task', {
         body.description = description;
     if (implementationPlan !== undefined)
         body.implementationPlan = implementationPlan;
+    if (reviewInstructions !== undefined)
+        body.reviewInstructions = reviewInstructions;
     if (priority !== undefined)
         body.priority = priority;
     if (effort !== undefined)
@@ -332,6 +337,8 @@ server.registerTool('update_task', {
         updates.push('description');
     if (implementationPlan !== undefined)
         updates.push('plan');
+    if (reviewInstructions !== undefined)
+        updates.push('reviewInstructions');
     if (priority !== undefined)
         updates.push(`priority=${priority || 'none'}`);
     if (effort !== undefined)
@@ -349,6 +356,7 @@ server.registerTool('update_task', {
             title: result.title,
             description: result.description,
             implementationPlan: result.implementationPlan,
+            reviewInstructions: result.reviewInstructions,
             priority: result.priority,
             effort: result.effort,
             quarter: result.quarter,
@@ -661,6 +669,8 @@ server.registerTool('complete_task', {
         'and concrete evidence proving you verified it (e.g., test output, build log snippet). ' +
         'Empty evidence or evidence identical to the item text will be rejected.\n\n' +
         '**Commits:** Pass commits array to log them at completion (convenience for final commits).\n\n' +
+        '**Review instructions:** When sending to review (default), provide `reviewInstructions` — specific steps ' +
+        'for the reviewer: what to test in UI, edge cases, areas of risk. Not a restatement of what was done.\n\n' +
         'Returns documentation update suggestions.',
     inputSchema: z.object({
         taskId: z.string(),
@@ -674,6 +684,9 @@ server.registerTool('complete_task', {
             evidence: z.string().describe('Concrete proof of verification (e.g., "bun test: 47 passed, 0 failed")'),
         })).optional().describe('Completion checklist confirmations — echo back each item from the checklist shown in start_task'),
         skipReview: z.boolean().optional().describe('Skip human review and mark task as done immediately (default: false, task goes to in_review)'),
+        reviewInstructions: z.string().optional().describe('What the reviewer should test or verify (markdown). Recommended when sending to review (default behavior). ' +
+            'Write specific, actionable steps: what to test in the UI, what edge cases to check, ' +
+            'what areas might break. Not a restatement of the summary.'),
     }),
     outputSchema: z.object({
         id: z.string(),
@@ -686,9 +699,9 @@ server.registerTool('complete_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId, summary, commits, confirmations, skipReview }) => {
+}, async ({ taskId, summary, commits, confirmations, skipReview, reviewInstructions }) => {
     try {
-        const result = await api('POST', `/api/agent/tasks/${taskId}/complete`, { summary, commits, confirmations, skipReview });
+        const result = await api('POST', `/api/agent/tasks/${taskId}/complete`, { summary, commits, confirmations, skipReview, reviewInstructions });
         return {
             content: [{ type: 'text', text: formatCompleteTaskResponse(result) }],
             structuredContent: result,
@@ -888,6 +901,12 @@ All content you generate — titles, descriptions, changelogs, notes — should
 - Types: feat, fix, refactor, test, docs, chore, style, perf
 - Imperative mood: "add feature" not "added feature"
 
+**Review instructions** (provided at task completion via \`reviewInstructions\`):
+- Write for a human reviewer who hasn't seen the code changes
+- List specific things to test: UI flows, edge cases, regressions
+- Mention files/areas that were changed and what to verify
+- Include any setup steps needed to test (e.g., "run migrations first")
+
 **Notes:**
 - Prefix with category: "Decision: …", "Blocked: …", "Context: …"
 - Only log non-obvious decisions and blockers — skip routine progress
@@ -2058,6 +2077,31 @@ server.registerTool('publish_changelog', {
         },
     };
 });
+// Tool: Delete changelog
+server.registerTool('delete_changelog', {
+    title: 'Delete Changelog',
+    description: 'Permanently delete a changelog entry.',
+    inputSchema: z.object({
+        changelogId: z.string().describe('Changelog ID'),
+    }),
+    outputSchema: z.object({
+        success: z.boolean(),
+        id: z.string(),
+        title: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ changelogId }) => {
+    const result = await api('DELETE', `/api/agent/changelogs/${changelogId}`);
+    return {
+        content: [{ type: 'text', text: `Deleted changelog: "${result.title}"` }],
+        structuredContent: result,
+    };
+});
 // ==================== Project Settings Tools ====================
 // Tool: Get project settings
 server.registerTool('get_project_settings', {

package/package.json

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