@damper/mcp 0.6.0 → 0.6.2

package/dist/formatters.js

@@ -19,7 +19,8 @@ export function formatStartTaskResponse(result) {
     // Completion checklist - shown after critical rules so agent knows upfront
     if (result.completionChecklist && result.completionChecklist.length > 0) {
         lines.push('\n📋 **COMPLETION CHECKLIST (required for complete_task):**');
-        lines.push('You MUST verify each item and pass them as `confirmations` when calling `complete_task`:');
+        lines.push('You MUST verify each item and pass as `confirmations` with evidence:');
+        lines.push('Format: `[{item: "...", evidence: "..."}]` — evidence must be concrete proof, not just repeating the item.');
         for (const item of result.completionChecklist) {
             lines.push(`  □ ${item}`);
         }

package/dist/index.js

@@ -29,7 +29,7 @@ async function api(method, path, body) {
             throw lockErr;
         }
         // Preserve checklist info for 400 checklist failures
-        if (res.status === 400 && err.missingItems) {
+        if (res.status === 400 && (err.missingItems || err.invalidEvidence)) {
             const checklistErr = new Error(err.error || `HTTP ${res.status}`);
             checklistErr.checklistInfo = err;
             throw checklistErr;
@@ -41,7 +41,7 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.6.0',
+    version: '0.5.1',
 });
 // Output schemas
 const SubtaskProgressSchema = z.object({
@@ -595,8 +595,9 @@ server.registerTool('complete_task', {
         '1. Push all commits\n' +
         '2. Check if project context docs need updating\n\n' +
         '**Completion checklist:** If the project has a completion checklist (shown in `start_task` response), ' +
-        'you MUST pass `confirmations` — an array echoing back each checklist item you\'ve verified. ' +
-        'The server will reject completion if any items are missing.\n\n' +
+        'you MUST pass `confirmations` — an array of `{item, evidence}` objects. Each confirmation needs the checklist item text ' +
+        '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' +
         'Returns documentation update suggestions.',
     inputSchema: z.object({
@@ -606,7 +607,10 @@ server.registerTool('complete_task', {
             hash: z.string().describe('Commit hash (short or full)'),
             message: z.string().describe('Commit message'),
         })).optional().describe('Optional: commits to log at completion'),
-        confirmations: z.array(z.string()).optional().describe('Completion checklist confirmations — echo back each item from the checklist shown in start_task'),
+        confirmations: z.array(z.object({
+            item: z.string().describe('Checklist item text from start_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'),
     }),
     outputSchema: z.object({
         id: z.string(),
@@ -630,15 +634,25 @@ server.registerTool('complete_task', {
     catch (err) {
         const error = err;
         if (error.checklistInfo) {
-            const { missingItems, checklist } = error.checklistInfo;
+            const { missingItems, invalidEvidence, checklist } = error.checklistInfo;
             const lines = [
                 '❌ Completion blocked — checklist not fully confirmed.',
                 '',
-                `**Missing ${missingItems.length} of ${checklist.length} items:**`,
-                ...missingItems.map(item => `  • ${item}`),
-                '',
-                'Pass ALL checklist items in `confirmations` to complete the task.',
             ];
+            if (missingItems.length > 0) {
+                lines.push(`**Missing ${missingItems.length} of ${checklist.length} items:**`);
+                lines.push(...missingItems.map(item => `  • ${item}`));
+                lines.push('');
+            }
+            if (invalidEvidence && invalidEvidence.length > 0) {
+                lines.push(`**Invalid evidence for ${invalidEvidence.length} item(s):**`);
+                lines.push(...invalidEvidence.map(item => `  • ${item}`));
+                lines.push('');
+                lines.push('Evidence must be non-empty and different from the checklist item text.');
+                lines.push('Provide concrete proof (e.g., "bun test: 47 passed, 0 failed").');
+                lines.push('');
+            }
+            lines.push('Pass ALL checklist items in `confirmations` with valid evidence to complete the task.');
             return {
                 content: [{ type: 'text', text: lines.join('\n') }],
                 isError: true,
@@ -722,7 +736,7 @@ server.registerTool('get_agent_instructions', {
         openWorldHint: false,
     },
 }, async ({ format = 'section' }) => {
-    const lastModified = '2025-02-06';
+    const lastModified = '2026-02-08';
     const section = `## Task Management with Damper MCP
 
 > Last updated: ${lastModified}
@@ -739,6 +753,7 @@ This project uses Damper MCP for task tracking. **You MUST follow this workflow.
 4. If working on a task: \`start_task\` to lock it
 
 ### While Working
+- **Do NOT commit or complete tasks without explicit user confirmation** - Always ask the user before running \`git commit\` or calling \`complete_task\`
 - \`add_commit\` after each commit with hash and message
 - \`add_note\` for decisions: "Decision: chose X because Y"
 - \`update_subtask\` to mark subtask progress
@@ -758,7 +773,8 @@ This project uses Damper MCP for task tracking. **You MUST follow this workflow.
 - \`update_project_settings\` - Configure completion checklist and other agent-relevant settings
 
 ### At Session End (MANDATORY)
-- ALWAYS call \`complete_task\` (if done) or \`abandon_task\` (if stopping early)
+- **Ask the user for confirmation before committing or completing a task** - Never autonomously commit code or call \`complete_task\`
+- Once user confirms, call \`complete_task\` (if done) or \`abandon_task\` (if stopping early)
 - NEVER leave a started task without completing or abandoning it
 - If the project has a **completion checklist** (shown in \`start_task\` response), you MUST pass all items as \`confirmations\` when calling \`complete_task\`
 - If you learned something about the codebase, consider updating project context
@@ -1707,6 +1723,7 @@ server.registerTool('create_changelog', {
         title: z.string().describe('Changelog title (e.g., "v2.1.0" or "January 2025 Release")'),
         content: z.string().optional().describe('Initial changelog content (markdown)'),
         version: z.string().optional().describe('Version number'),
+        date: z.string().optional().describe('Custom display date (ISO 8601). When set, used for sorting/display instead of publishedAt.'),
         summary: z.string().max(280).optional().describe('Short summary for social sharing and email subject (max 280 chars)'),
         status: z.enum(['draft', 'published']).optional().describe('Status (default: draft)'),
     }),
@@ -1714,6 +1731,7 @@ server.registerTool('create_changelog', {
         id: z.string(),
         title: z.string(),
         version: z.string().nullable().optional(),
+        date: z.string().nullable().optional(),
         status: z.string(),
     }),
     annotations: {
@@ -1740,6 +1758,7 @@ server.registerTool('update_changelog', {
         title: z.string().optional().describe('New title'),
         content: z.string().optional().describe('New content (markdown)'),
         version: z.string().optional().describe('Version number'),
+        date: z.string().optional().describe('Custom display date (ISO 8601). When set, used for sorting/display instead of publishedAt. Pass empty string to clear.'),
         summary: z.string().max(280).optional().describe('Short summary for social sharing and email subject (max 280 chars)'),
         status: z.enum(['draft', 'published']).optional().describe('Status'),
     }),
@@ -1747,6 +1766,7 @@ server.registerTool('update_changelog', {
         id: z.string(),
         title: z.string(),
         version: z.string().nullable().optional(),
+        date: z.string().nullable().optional(),
         status: z.string(),
         publishedAt: z.string().nullable().optional(),
     }),
@@ -1756,7 +1776,7 @@ server.registerTool('update_changelog', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ changelogId, title, content, version, status }) => {
+}, async ({ changelogId, title, content, version, date, summary, status }) => {
     const body = {};
     if (title !== undefined)
         body.title = title;
@@ -1764,6 +1784,10 @@ server.registerTool('update_changelog', {
         body.content = content;
     if (version !== undefined)
         body.version = version;
+    if (date !== undefined)
+        body.date = date;
+    if (summary !== undefined)
+        body.summary = summary;
     if (status !== undefined)
         body.status = status;
     const result = await api('PATCH', `/api/agent/changelogs/${changelogId}`, body);

package/package.json

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