@damper/mcp 0.10.7 → 0.11.1

package/dist/index.js

@@ -10,6 +10,16 @@ if (!API_KEY) {
     console.error('DAMPER_API_KEY required. Get one from Damper → Settings → API Keys');
     process.exit(1);
 }
+// Deprecation notice — hosted version is now available
+console.error('\n⚠️  @damper/mcp (stdio) is deprecated. Switch to the hosted version:\n' +
+    '\n' +
+    '  "damper": {\n' +
+    '    "type": "http",\n' +
+    '    "url": "https://api.usedamper.com/mcp",\n' +
+    '    "headers": { "Authorization": "Bearer YOUR_API_KEY" }\n' +
+    '  }\n' +
+    '\n' +
+    '  See: https://usedamper.com/docs/mcp\n');
 // API Client
 async function api(method, path, body) {
     const res = await fetch(`${API_URL}${path}`, {
@@ -84,6 +94,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 +246,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 +297,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 +312,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 +326,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 +334,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 +356,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 +377,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 +401,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({
@@ -898,6 +921,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.7",
+  "version": "0.11.1",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {