targetprocess-mcp-server 2.4.1 → 2.4.2

package/README.md

@@ -94,6 +94,8 @@ Cards — Write
 - `create_formatted_user_story` — Create a new user story with a structured template description (title, header object with asA/iWant/soThat, acceptanceCriteria array, scenarios array with Gherkin steps, optional definitions, examplesTable, edgeCases, references, notes, optional featureId, releaseId, projectId, teamId)  
 > [!NOTE]  
 > `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
+- `format_existing_user_story` — Re-format the description of an existing user story using the structured template (id, header object with asA/iWant/soThat, acceptanceCriteria array, scenarios array with Gherkin steps, optional title, definitions, examplesTable, edgeCases, references, notes)
+  > Call `get_user_story_content` first to read the current content, then reconstruct the structured fields before calling this tool
 - `create_feature` — Create a new feature (title, optional description, optional epicId, optional releaseId, optional projectId, optional teamId)  
 > [!NOTE]  
 > `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  

package/build/handlers/format_existing_user_story.js

@@ -0,0 +1,55 @@
+export async function handleFormatExistingUserStory(tp, params) {
+    const { id, title, header, definitions, acceptanceCriteria, scenarios, examplesTable, edgeCases, references, notes, } = params;
+    const gherkinBlock = (items) => items.map((s, indx) => `<div><strong>Scenario ${indx + 1} - ${s.name}:</strong></div><div>${s.steps.map(step => `<div>\t${step}</div>`).join('\n')}</div>`).join('\n');
+    const parts = ['<div>'];
+    parts.push('<h3>Header</h3>');
+    if (header.storyId)
+        parts.push(`<p><strong>Story ID:</strong> ${header.storyId}</p>`);
+    parts.push(`<p>As a ${header.asA} / I want ${header.iWant} / so that ${header.soThat}</p>`);
+    if (definitions && definitions.length > 0) {
+        parts.push('<h3>Definitions</h3>');
+        parts.push(`<div>`);
+        for (const def of definitions) {
+            parts.push(`<p><strong>${def.term}</strong> — ${def.description}</p>`);
+        }
+        parts.push(`</div>`);
+    }
+    parts.push('<h3>Acceptance Criteria</h3>');
+    parts.push('<ol>');
+    for (const criterion of acceptanceCriteria) {
+        parts.push(`<li>${criterion}</li>`);
+    }
+    parts.push('</ol>');
+    parts.push('<h3>Scenarios</h3>');
+    parts.push(gherkinBlock(scenarios));
+    if (examplesTable) {
+        parts.push('<h3>Examples</h3>');
+        parts.push(`<pre>${examplesTable}</pre>`);
+    }
+    if (edgeCases && edgeCases.length > 0) {
+        parts.push('<h3>Edge Cases</h3>');
+        parts.push(gherkinBlock(edgeCases));
+    }
+    if (references) {
+        parts.push('<h3>References</h3>');
+        parts.push(`<p>${references}</p>`);
+    }
+    if (notes) {
+        parts.push('<h3>Notes</h3>');
+        parts.push(`<p>${notes}</p>`);
+    }
+    parts.push('</div>');
+    const description = parts.join('\n');
+    const response = await tp.updateUserStory({ id, title, description });
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to format user story id: ${id}\n JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(response) }],
+    };
+}

package/build/index.js

@@ -39,6 +39,7 @@ import { handleUpdateUserStorySubState } from "./handlers/update_user_story_sub_
 import { handleGetCardRelations } from "./handlers/get_card_relations.js";
 import { handleCreateCardRelation } from "./handlers/create_card_relation.js";
 import { handleDeleteCardRelation } from "./handlers/delete_card_relation.js";
+import { handleFormatExistingUserStory } from "./handlers/format_existing_user_story.js";
 const server = new McpServer({
     name: "tp",
     version: "1.0.0"
@@ -1385,6 +1386,72 @@ server.registerTool('get_my_time_logs', {
             .describe('Number of entries to return, default is 25'),
     },
 }, async ({ take }) => handleGetMyTimeLogs(tp, take));
+server.registerTool('format_existing_user_story', {
+    title: 'Format an existing user story',
+    description: `Re-format the description of an existing user story using the structured template (Header, Definitions, Acceptance Criteria, Gherkin Scenarios, Edge Cases, References, Notes).
+      This is identical in structure to "create_user_story" but updates an existing card instead of creating a new one.
+      CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
+        1) Call "get_user_story_content" to retrieve the current content of the user story;
+        2) Extract or derive the structured fields (header, definitions, acceptanceCriteria, scenarios, etc.) from the existing description;
+        3) Optionally update the title if the user requested it.`,
+    inputSchema: {
+        id: z.string()
+            .min(5)
+            .max(6)
+            .describe('ID of the user story to format (e.g. 145789)'),
+        title: z.string()
+            .optional()
+            .describe('Updated user story title — omit to keep the existing title'),
+        header: z.object({
+            storyId: z.string()
+                .optional()
+                .describe('Story ID if already known (e.g. US-12345), omit if not applicable'),
+            asA: z.string()
+                .describe('Role or persona — the "As a ..." part'),
+            iWant: z.string()
+                .describe('Goal — the "I want ..." part'),
+            soThat: z.string()
+                .describe('Benefit — the "so that ..." part'),
+        })
+            .describe('Story header following the As a / I want / so that format'),
+        definitions: z.array(z.object({
+            term: z.string()
+                .describe('The term, module name, or feature flag being defined'),
+            description: z.string()
+                .describe('Explanation of the term'),
+        })),
+        acceptanceCriteria: z.array(z.string())
+            .min(1)
+            .describe('Bullet checklist items for quick review sign-off — each string is one criterion'),
+        scenarios: z.array(z.object({
+            name: z.string()
+                .describe('Scenario name'),
+            steps: z.array(z.string())
+                .min(1)
+                .describe('Gherkin steps — each string is a full step line, e.g. "Given I am on the login page"'),
+        }))
+            .min(1)
+            .describe('Gherkin scenario blocks, one per behavior branch'),
+        examplesTable: z.string()
+            .optional()
+            .describe('Examples table for parameterized or matrix behavior (plain text or Gherkin Examples: table format)'),
+        edgeCases: z.array(z.object({
+            name: z.string()
+                .describe('Edge case scenario name'),
+            steps: z.array(z.string())
+                .min(1)
+                .describe('Gherkin steps for this edge case'),
+        }))
+            .optional()
+            .describe('Explicit edge case or boundary condition scenarios'),
+        references: z.string()
+            .optional()
+            .describe('Links to Axure mockups or other external references (not inline in prose)'),
+        notes: z.string()
+            .optional()
+            .describe('Anything that helps understand the story context but does not fit other sections'),
+    },
+}, async ({ id, title, header, definitions, acceptanceCriteria, scenarios, examplesTable, edgeCases, references, notes }) => handleFormatExistingUserStory(tp, { id, title, header, definitions, acceptanceCriteria, scenarios, examplesTable, edgeCases, references, notes }));
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -27,7 +27,7 @@
   "engines": {
     "node": ">=20.x"
   },
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "MCP server for Tartget Process",
   "main": "build/index.js",
   "keywords": [