npm - targetprocess-mcp-server - Versions diffs - 2.6.7 → 2.6.8 - Mend

targetprocess-mcp-server 2.6.7 → 2.6.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/build/handlers/create_bug_based_on_card.js +14 -0
package/build/handlers/get_bug_content.js +1 -0
package/build/index.js +54 -23
package/build/tp.js +22 -3
package/package.json +1 -1

package/build/handlers/create_bug_based_on_card.js ADDED Viewed

@@ -0,0 +1,14 @@
+export async function handleCreateBugBasedOnCard(tp, params) {
+    const bugResponse = await tp.createBug(params);
+    if (!bugResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create bug "${params.title}"\n JSON: ${JSON.stringify(bugResponse, null, 2)}`
+                }],
+        };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(bugResponse) }],
+    };
+}

package/build/handlers/get_bug_content.js CHANGED Viewed

@@ -14,6 +14,7 @@ export async function handleGetBugContent(tp, id) {
         id: bug.Id,
         description: '',
         origin: '',
+        release: bug.Release ? { id: bug.Release.Id, name: bug.Release.Name } : null,
     };
     try {
         const dom = new JSDOM(`<html><body><div id="content">${bug.Description}</div></body></html>`);

package/build/index.js CHANGED Viewed

@@ -25,6 +25,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 { handleCreateBugBasedOnCard } from "./handlers/create_bug_based_on_card.js";
 import { handleCreateUserStory } from "./handlers/create_user_story.js";
 import { handleCreateFormattedUserStory } from "./handlers/create_formatted_user_story.js";
 import { handleCreateFormattedFeature } from "./handlers/create_formatted_feature.js";
@@ -354,7 +355,8 @@ server.registerTool('create_bug_based_on_card', {
         3) format the new bug inside html <div> tags with Environment (describes where bug was found, dev, feature, review or uat Environment), Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>);
         4) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         5) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
-        6) add a comment to the card with created bug Id and its Title`,
+        6) IF the user specified a release by name (not ID), call "get_current_releases" to find the matching release and use its ID as releaseId;
+        7) add a comment to the card with created bug Id and its Title`,
     inputSchema: {
         title: z.string()
             .describe('Bug card title that summarizes the problem in concise, descriptive, and actionable manner, enabling a developer to understand the issue without opening the report'),
@@ -384,6 +386,11 @@ server.registerTool('create_bug_based_on_card', {
         ])
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA" if no origin was specified'),
+        releaseId: z.string()
+            .min(5)
+            .max(9)
+            .optional()
+            .describe('Optional Release ID to assign this bug to — if user gave a release name, resolve it via "get_current_releases" first'),
         projectId: z.string()
             .optional()
             .describe('Optional Project ID — if user gave a project name, resolve it via "get_projects" first; defaults to TP_PROJECT_ID from config'),
@@ -391,23 +398,7 @@ server.registerTool('create_bug_based_on_card', {
             .optional()
             .describe('Optional Team ID — if user gave a team name, resolve it via "get_teams" first; defaults to TP_TEAM_ID from config'),
     },
-}, async ({ title, card, bugContent, origin, projectId, teamId }) => {
-    const bugResponse = await tp.createBug({ title, card, bugContent, origin, projectId, teamId });
-    if (!bugResponse) {
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Failed to create bug "${title}"\n JSON: ${JSON.stringify(bugResponse, null, 2)}`
-                }]
-        };
-    }
-    return {
-        content: [{
-                type: 'text',
-                text: JSON.stringify(bugResponse)
-            }],
-    };
-});
+}, async ({ title, card, bugContent, origin, releaseId, projectId, teamId }) => handleCreateBugBasedOnCard(tp, { title, card, bugContent, origin, releaseId, projectId, teamId }));
 server.registerTool('update_bug', {
     title: 'Update a bug card',
     description: `Update a bug card with data proded from user input.
@@ -416,7 +407,8 @@ server.registerTool('update_bug', {
         1) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         2) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
         3) IF the user specified a state by name (not ID), call "get_bug_workflows" to find the matching state and use its ID as entityStateId;
-        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;`,
+        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;
+        5) IF the user specified a release by name (not ID), call "get_current_releases" to find the matching release and use its ID as releaseId;`,
     inputSchema: {
         id: z.string()
             .min(5)
@@ -441,6 +433,11 @@ server.registerTool('update_bug', {
         ])
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA"'),
+        releaseId: z.string()
+            .min(5)
+            .max(9)
+            .optional()
+            .describe('Optional Release ID to assign this bug to — if user gave a release name, resolve it via "get_current_releases" first'),
         projectId: z.string()
             .optional()
             .describe('Optional Project ID — if user gave a project name, resolve it via "get_projects" first; defaults to TP_PROJECT_ID from config'),
@@ -457,7 +454,7 @@ server.registerTool('update_bug', {
             .optional()
             .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ id, title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) => handleUpdateBug(tp, { id, title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }));
+}, async ({ id, title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }) => handleUpdateBug(tp, { id, title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }));
 server.registerTool('update_user_story_state', {
     title: 'Update a user story card sub state',
     description: `Update a user story card sub state with data provided from user input.
@@ -480,6 +477,34 @@ server.registerTool('update_user_story_state', {
             .describe('Team Assignment ID, resolve it via "get_user_story_content" first'),
     },
 }, async ({ id, teamId, teamAssignmentId, entityStateId }) => handleUpdateUserStorySubState(tp, { id, teamId, teamAssignmentId, entityStateId }));
+server.registerTool('set_business_value', {
+    title: 'Set Business Value on a TP card',
+    description: `Set the Business Value (Priority) on a Targetprocess User Story, Feature, or Epic.
+      Business Value in the TP UI maps to the Priority field in the API.
+      CRITICAL WORKFLOW: Call "get_priorities" first to retrieve the list of valid priority IDs and their names for this instance before calling this tool — do not guess priority IDs.`,
+    inputSchema: {
+        id: z.string()
+            .describe('ID of the card to update (e.g. "151282")'),
+        entityType: z.enum(['UserStories', 'Features', 'Epics'])
+            .describe('Entity type of the card'),
+        priorityId: z.string()
+            .describe('Priority ID — resolve via "get_priorities" first'),
+    },
+}, async ({ id, entityType, priorityId }) => {
+    const response = await tp.setBusinessValue({ id, entityType, priorityId });
+    if (!response) {
+        return { content: [{ type: 'text', text: `Failed to set business value on ${entityType} ${id}` }] };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+});
+server.registerTool('get_priorities', {
+    title: 'Get available Business Value / Priority options',
+    description: `Returns the list of Priority options available in this Targetprocess instance. Use this before calling "set_business_value" to resolve a priority name (e.g. "Must Have", "Normal", "10") to its ID.`,
+    inputSchema: {},
+}, async () => {
+    const response = await tp.getPriorities();
+    return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+});
 server.registerTool('update_user_story', {
     title: 'Update a user story card',
     description: `Update a user story card with data provided from user input.
@@ -544,7 +569,8 @@ server.registerTool('create_bug', {
         1) format the new bug inside html <div> tags with Environment(describes where bug was found, dev, feature, review or uat Environment), Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>, step to reproduce should be wrapped in <ol>);
         2) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         3) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
-        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;`,
+        4) IF the user specified a sprint/iteration by name, call "get_team_iterations" to find the matching iteration and use its ID as teamIterationId;
+        5) IF the user specified a release by name (not ID), call "get_current_releases" to find the matching release and use its ID as releaseId;`,
     inputSchema: {
         title: z.string()
             .describe('Bug card title that summarizes the problem in concise, descriptive, and actionable manner, enabling a developer to understand the issue without opening the report'),
@@ -563,6 +589,11 @@ server.registerTool('create_bug', {
         ])
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA" if no origin was specified'),
+        releaseId: z.string()
+            .min(5)
+            .max(9)
+            .optional()
+            .describe('Optional Release ID to assign this bug to — if user gave a release name, resolve it via "get_current_releases" first'),
         projectId: z.string()
             .optional()
             .describe('Optional Project ID — if user gave a project name, resolve it via "get_projects" first; defaults to TP_PROJECT_ID from config'),
@@ -579,7 +610,7 @@ server.registerTool('create_bug', {
             .optional()
             .describe('Optional Team Iteration (sprint) ID — resolve it via "get_team_iterations" first'),
     },
-}, async ({ title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) => handleCreateBug(tp, { title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }));
+}, async ({ title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }) => handleCreateBug(tp, { title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }));
 server.registerTool('create_user_story', {
     title: 'Create a new user story',
     description: `Create a new user story in Targetprocess.
@@ -823,7 +854,7 @@ server.registerTool('create_formatted_feature', {
 }, async ({ title, header, definitions, scope, nonFunctionalRequirements, crossCuttingScenarios, childStories, openQuestions, references, notes, epicId, releaseId, projectId, teamId }) => handleCreateFormattedFeature(tp, { title, header, definitions, scope, nonFunctionalRequirements, crossCuttingScenarios, childStories, openQuestions, references, notes, epicId, releaseId, projectId, teamId }));
 server.registerTool('create_feature', {
     title: 'Create a new feature',
-    description: `Create a new Feature in Targetprocess.`,
+    description: `DEPRECATED — use "create_formatted_feature" instead for all new features. Only call this tool when you have a fully pre-written HTML description and the user has explicitly opted out of the structured template.`,
     inputSchema: {
         title: z.string()
             .describe('Feature title'),

package/build/tp.js CHANGED Viewed

@@ -186,7 +186,7 @@ export class TpClient {
         });
         return response;
     }
-    async createBug({ title, card, bugContent, origin, projectId, teamId }) {
+    async createBug({ title, card, bugContent, origin, releaseId, projectId, teamId }) {
         const bug = {
             "Name": title,
             "Project": {
@@ -207,6 +207,8 @@ export class TpClient {
                     "value": origin
                 }];
         }
+        if (releaseId)
+            bug["Release"] = { "Id": releaseId };
         if (card.type === "UserStory") {
             bug["UserStory"] = { "Id": card.id };
         }
@@ -258,7 +260,14 @@ export class TpClient {
             param: { "format": "json" },
         }, userStory);
     }
-    async updateBug({ id, title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) {
+    async setBusinessValue({ id, entityType, priorityId }) {
+        const entity = { "Id": id, "Priority": { "Id": priorityId } };
+        return this.post({
+            pathParam: [entityType, id],
+            param: { "format": "json" },
+        }, entity);
+    }
+    async updateBug({ id, title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }) {
         const bug = { "Id": id };
         if (title)
             bug["Name"] = title;
@@ -270,6 +279,8 @@ export class TpClient {
                     "type": "DropDown",
                     "value": origin
                 }];
+        if (releaseId)
+            bug["Release"] = { "Id": releaseId };
         if (projectId)
             bug["Project"] = { "Id": projectId };
         if (teamId)
@@ -289,7 +300,7 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
-    async createBugOnly({ title, bugContent, origin, projectId, teamId, entityStateId, tags, teamIterationId }) {
+    async createBugOnly({ title, bugContent, origin, releaseId, projectId, teamId, entityStateId, tags, teamIterationId }) {
         const bug = {
             "Name": title,
             "Project": {
@@ -309,6 +320,8 @@ export class TpClient {
                     "value": origin
                 }];
         }
+        if (releaseId)
+            bug["Release"] = { "Id": releaseId };
         if (entityStateId)
             bug["EntityState"] = { "Id": entityStateId };
         if (tags)
@@ -878,6 +891,12 @@ export class TpClient {
             param: { "format": "json" },
         });
     }
+    async getPriorities() {
+        return this.get({
+            pathParam: ["Priorities"],
+            param: { "format": "json", "take": "200" },
+        });
+    }
     async getProcessWorkflows({ processId }) {
         return this.get({
             pathParam: ["Process"],

package/package.json CHANGED Viewed

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