@damper/mcp 0.3.6 → 0.3.8

package/README.md

@@ -310,6 +310,36 @@ When working on tasks, follow this workflow for best results:
 > Sync all my documentation to Damper
 ```
 
+## Agent Instructions (CLAUDE.md)
+
+Add this to your project's `CLAUDE.md` (or `.cursorrules` for Cursor) to ensure AI agents use Damper consistently:
+
+```markdown
+## Task Management with Damper MCP
+
+This project uses Damper MCP for task tracking. **You MUST follow this workflow.**
+
+### At Session Start
+1. `get_project_context` - Read available project documentation
+2. `list_tasks` - Check for existing tasks to work on
+3. If working on a task: `start_task` to lock it
+
+### While Working
+- `add_note` after each commit: "Committed abc123: description"
+- `add_note` for decisions: "Decision: chose X because Y"
+- `update_subtask` to mark subtask progress
+
+### 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
+
+### Why This Matters
+- Locked tasks block other agents from working on them
+- Notes help the next agent (or you) continue the work
+- Project context saves future agents from re-analyzing the codebase
+```
+
 ## Environment
 
 | Variable | Required | Default |

package/dist/index.js

@@ -216,7 +216,7 @@ 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, or labels. ' +
+    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.',
     inputSchema: z.object({
         taskId: z.string().describe('Task ID'),
@@ -226,6 +226,7 @@ server.registerTool('update_task', {
         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")'),
         labels: z.array(z.string()).optional().describe('Labels/tags'),
+        isPublic: z.boolean().optional().describe('Whether task is visible on public roadmap'),
     }),
     outputSchema: z.object({
         id: z.string(),
@@ -236,6 +237,7 @@ server.registerTool('update_task', {
         effort: z.string().nullable().optional(),
         quarter: z.string().nullable().optional(),
         labels: z.array(z.string()).optional(),
+        isPublic: z.boolean().optional(),
     }),
     annotations: {
         readOnlyHint: false,
@@ -243,7 +245,7 @@ server.registerTool('update_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId, description, implementationPlan, priority, effort, quarter, labels }) => {
+}, async ({ taskId, description, implementationPlan, priority, effort, quarter, labels, isPublic }) => {
     const body = {};
     if (description !== undefined)
         body.description = description;
@@ -257,6 +259,8 @@ server.registerTool('update_task', {
         body.quarter = quarter;
     if (labels !== undefined)
         body.labels = labels;
+    if (isPublic !== undefined)
+        body.isPublic = isPublic;
     const result = await api('PATCH', `/api/agent/tasks/${taskId}`, body);
     const updates = [];
     if (description !== undefined)
@@ -271,6 +275,8 @@ server.registerTool('update_task', {
         updates.push(`quarter=${quarter || 'none'}`);
     if (labels !== undefined)
         updates.push(`labels=[${labels.join(', ')}]`);
+    if (isPublic !== undefined)
+        updates.push(`isPublic=${isPublic}`);
     return {
         content: [{ type: 'text', text: `📝 Updated ${result.title}: ${updates.join(', ')}` }],
         structuredContent: {
@@ -282,6 +288,7 @@ server.registerTool('update_task', {
             effort: result.effort,
             quarter: result.quarter,
             labels: result.labels,
+            isPublic: result.isPublic,
         },
     };
 });
@@ -295,12 +302,14 @@ server.registerTool('create_task', {
         type: z.enum(['bug', 'feature', 'improvement', 'task']).optional().describe('Task type (default: feature)'),
         status: z.enum(['planned', 'in_progress']).optional(),
         implementationPlan: z.string().optional(),
+        isPublic: z.boolean().optional().describe('Whether task is visible on public roadmap (default: true)'),
     }),
     outputSchema: z.object({
         id: z.string(),
         title: z.string(),
         type: z.string(),
         status: z.string(),
+        isPublic: z.boolean().optional(),
     }),
     annotations: {
         readOnlyHint: false,
@@ -311,8 +320,9 @@ server.registerTool('create_task', {
 }, async (args) => {
     const result = await api('POST', '/api/agent/tasks', args);
     const typeIcon = result.type === 'bug' ? '🐛' : result.type === 'feature' ? '✨' : result.type === 'improvement' ? '💡' : '📌';
+    const visibilityIcon = result.isPublic ? '' : ' 🔒';
     return {
-        content: [{ type: 'text', text: `Created: ${result.id} ${typeIcon} "${result.title}" [${result.status}]` }],
+        content: [{ type: 'text', text: `Created: ${result.id} ${typeIcon} "${result.title}" [${result.status}]${visibilityIcon}` }],
         structuredContent: result,
     };
 });

package/package.json

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