@damper/mcp 0.10.6 → 0.11.0

package/dist/index.js

@@ -84,6 +84,7 @@ const TaskDetailSchema = z.object({
     description: z.string().nullable().optional(),
     type: z.string(),
     implementationPlan: z.string().nullable().optional(),
+    userStories: z.string().nullable().optional(),
     status: z.string(),
     priority: z.string().nullable().optional(),
     effort: z.string().nullable().optional(),
@@ -235,6 +236,8 @@ server.registerTool('get_task', {
         parts.push(meta.join(' | '));
     if (t.description)
         parts.push(`\n## Description\n${t.description}`);
+    if (t.userStories)
+        parts.push(`\n## User Stories\n${t.userStories}`);
     if (t.implementationPlan)
         parts.push(`\n## Plan\n${t.implementationPlan}`);
     // Show subtasks
@@ -284,6 +287,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)'),
+        userStories: z.string().optional().describe('User stories describing how users interact with the feature (markdown, internal only). ' +
+            'Format: "As a [role], I [action] so that [benefit]." Include UI flows, buttons clicked, pages visited, API calls made.'),
         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'),
@@ -297,6 +302,7 @@ server.registerTool('update_task', {
         title: z.string(),
         description: z.string().nullable().optional(),
         implementationPlan: z.string().nullable().optional(),
+        userStories: z.string().nullable().optional(),
         reviewInstructions: z.string().nullable().optional(),
         priority: z.string().nullable().optional(),
         effort: z.string().nullable().optional(),
@@ -310,7 +316,7 @@ server.registerTool('update_task', {
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ taskId, title, description, implementationPlan, reviewInstructions, priority, effort, quarter, labels, isPublic }) => {
+}, async ({ taskId, title, description, implementationPlan, userStories, reviewInstructions, priority, effort, quarter, labels, isPublic }) => {
     const body = {};
     if (title !== undefined)
         body.title = title;
@@ -318,6 +324,8 @@ server.registerTool('update_task', {
         body.description = description;
     if (implementationPlan !== undefined)
         body.implementationPlan = implementationPlan;
+    if (userStories !== undefined)
+        body.userStories = userStories;
     if (reviewInstructions !== undefined)
         body.reviewInstructions = reviewInstructions;
     if (priority !== undefined)
@@ -338,6 +346,8 @@ server.registerTool('update_task', {
         updates.push('description');
     if (implementationPlan !== undefined)
         updates.push('plan');
+    if (userStories !== undefined)
+        updates.push('userStories');
     if (reviewInstructions !== undefined)
         updates.push('reviewInstructions');
     if (priority !== undefined)
@@ -357,6 +367,7 @@ server.registerTool('update_task', {
             title: result.title,
             description: result.description,
             implementationPlan: result.implementationPlan,
+            userStories: result.userStories,
             reviewInstructions: result.reviewInstructions,
             priority: result.priority,
             effort: result.effort,
@@ -380,6 +391,8 @@ server.registerTool('create_task', {
         status: z.enum(['planned', 'in_progress', 'in_review', 'done']).optional(),
         priority: z.enum(['high', 'medium', 'low']).optional().describe('Task priority'),
         implementationPlan: z.string().optional().describe('Implementation plan (markdown, internal only - never shown publicly)'),
+        userStories: z.string().optional().describe('User stories describing how users interact with the feature (markdown, internal only). ' +
+            'Format: "As a [role], I [action] so that [benefit]." Include UI flows, buttons clicked, pages visited, API calls made.'),
         isPublic: z.boolean().optional().describe('Whether task is visible on public roadmap (default: true)'),
     }),
     outputSchema: z.object({
@@ -484,15 +497,15 @@ server.registerTool('start_task', {
 server.registerTool('add_note', {
     title: 'Add Note',
     description: 'Add a note to a task. Use ONLY for non-obvious approach decisions and blockers.\n\n' +
-        '**When to use:**\n' +
-        '- Decisions: "Decision: Using X because Y"\n' +
-        '- 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.\n\n' +
-        '**Formatting:** Notes are rendered as markdown. Use **bold** for key terms, `code` for technical names, and bullet lists for multiple points. ' +
-        'Start with a short bold label like **Decision:** or **Blocked:**.',
+        '**Templates** (copy and fill in):\n\n' +
+        'Decision:\n```\n**Decision:** Chose `libraryName` over `alternative` because it supports X and has fewer dependencies\n```\n\n' +
+        'Blocker:\n```\n**Blocked:** Cannot proceed with `featureName` until:\n- Dependency X is merged\n- API endpoint Y is available\n```\n\n' +
+        'Observation:\n```\n**Note:** Found that `componentName` already handles X via `methodName` — reusing instead of reimplementing\n```',
     inputSchema: z.object({
         taskId: z.string(),
-        note: z.string().describe('Markdown-formatted note. Use **bold** labels, `code` for technical terms, and bullet lists for structure.'),
+        note: z.string().describe('Markdown-formatted note. Start with a **bold label** (Decision/Blocked/Note), ' +
+            'use `code` for technical names, and bullet lists for multiple points.'),
     }),
     outputSchema: z.object({
         taskId: z.string(),
@@ -898,6 +911,12 @@ All content you generate — titles, descriptions, changelogs, notes — should
 - 1-3 sentences explaining what changes and why it matters to users
 - Focus on the user benefit, not implementation details
 
+**User stories** (internal, never shown publicly):
+- Describe how users interact with the feature — UI flows, buttons clicked, pages visited, API endpoints called
+- Format: "As a [role], I [action] so that [benefit]"
+- Include step-by-step flows where helpful
+- Bridges the gap between description (what) and implementation plan (how)
+
 **Subtask titles:**
 - Short imperative phrase: "Add validation to login form"
 - Specific enough to track independently

package/package.json

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