targetprocess-mcp-server 2.4.2 → 2.4.4

package/build/index.js

@@ -23,7 +23,7 @@ import { handleAddComment } from "./handlers/add_comment.js";
 import { handleGetUserStoryComments } from "./handlers/get_user_story_comments.js";
 import { handleGetBugComments } from "./handlers/get_bug_comments.js";
 import { handleCreateBug } from "./handlers/create_bug.js";
-// import { handleCreateUserStory } from "./handlers/create_user_story.js";
+import { handleCreateUserStory } from "./handlers/create_user_story.js";
 import { handleCreateFeature } from "./handlers/create_feature.js";
 import { handleCreateTask } from "./handlers/create_task.js";
 import { handleUpdateBug } from "./handlers/update_bug.js";
@@ -39,7 +39,6 @@ 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"
@@ -531,39 +530,34 @@ server.registerTool('create_bug', {
             .describe('Optional Entity State ID — if user gave a state name, resolve it via "get_bug_workflows" first; defaults to "Done"'),
     },
 }, async ({ title, bugContent, origin, projectId, teamId, entityStateId }) => handleCreateBug(tp, { title, bugContent, origin, projectId, teamId, entityStateId }));
-// server.registerTool(
-//   'create_user_story',
-//   {
-//     title: 'Create a new user story',
-//     description: `Create a new user story in Targetprocess.`,
-//     inputSchema: {
-//       title: z.string()
-//         .describe('User story title'),
-//       description: z.string()
-//         .optional()
-//         .describe('Optional user story description (when provided, format as HTML)'),
-//       featureId: z.string()
-//         .min(5)
-//         .max(6)
-//         .optional()
-//         .describe('Optional Feature ID to link this user story to (e.g. 145636)'),
-//       releaseId: z.string()
-//         .min(5)
-//         .max(6)
-//         .optional()
-//         .describe('Optional Release ID to link this user story to (e.g. 145200)'),
-//       projectId: z.string()
-//         .optional()
-//         .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
-//       teamId: z.string()
-//         .optional()
-//         .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
-//     },
-//   },
-//   async ({ title, description, featureId, releaseId, projectId, teamId }) =>
-//     handleCreateUserStory(tp, { title, description, featureId, releaseId, projectId, teamId })
-// )
 server.registerTool('create_user_story', {
+    title: 'Create a new user story',
+    description: `Create a new user story in Targetprocess.`,
+    inputSchema: {
+        title: z.string()
+            .describe('User story title'),
+        description: z.string()
+            .optional()
+            .describe('Optional user story description (when provided, format as HTML)'),
+        featureId: z.string()
+            .min(5)
+            .max(6)
+            .optional()
+            .describe('Optional Feature ID to link this user story to (e.g. 145636)'),
+        releaseId: z.string()
+            .min(5)
+            .max(6)
+            .optional()
+            .describe('Optional Release ID to link this user story to (e.g. 145200)'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
+    },
+}, async ({ title, description, featureId, releaseId, projectId, teamId }) => handleCreateUserStory(tp, { title, description, featureId, releaseId, projectId, teamId }));
+server.registerTool('create_formatted_user_story', {
     title: 'Create a formatted user story',
     description: `Create a new user story in Targetprocess with a structured, template-driven description.
       The description is assembled from discrete sections (header, definitions, acceptance criteria, Gherkin scenarios, edge cases, references, notes) and stored as HTML.
@@ -641,12 +635,12 @@ server.registerTool('create_user_story', {
             .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
     },
 }, async ({ title, header, definitions, acceptanceCriteria, scenarios, examplesTable, edgeCases, references, notes, featureId, releaseId, projectId, teamId }) => {
-    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 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('<br>');
     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>`);
+    parts.push(`<p>As a ${header.asA} <br> I want ${header.iWant} <br> so that ${header.soThat}</p>`);
     if (definitions) {
         parts.push('<h3>Definitions</h3>');
         parts.push(`<div>`);
@@ -1386,72 +1380,6 @@ 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.2",
+  "version": "2.4.4",
   "description": "MCP server for Tartget Process",
   "main": "build/index.js",
   "keywords": [

package/build/handlers/format_existing_user_story.js

@@ -1,55 +0,0 @@
-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) }],
-    };
-}