@smartbear/mcp 0.24.0 → 0.25.0

package/dist/qtm4j/schema/test-cycle.link.schema.js

@@ -0,0 +1,260 @@
+import zod__default from "zod";
+const SprintFilter = zod__default.object({
+  boardName: zod__default.string(),
+  sprintName: zod__default.string()
+});
+const TestCaseVersionSkip = zod__default.object({
+  testCaseId: zod__default.string(),
+  version: zod__default.number().int()
+});
+const LinkToCycleTestCaseFilter = zod__default.object({
+  key: zod__default.string().optional().describe("Test case key (e.g., 'SCRUM-TC-145')."),
+  summary: zod__default.string().optional().describe("Test case summary."),
+  folderId: zod__default.number().int().optional().describe("Folder ID."),
+  description: zod__default.string().optional().describe("Test case description."),
+  assignee: zod__default.array(zod__default.string()).optional().describe("Jira account IDs of assignees."),
+  reporter: zod__default.array(zod__default.string()).optional().describe("Jira account IDs of reporters."),
+  createdBy: zod__default.array(zod__default.string()).optional().describe("Jira account IDs of creators."),
+  updatedBy: zod__default.array(zod__default.string()).optional().describe("Jira account IDs of last updaters."),
+  createdOn: zod__default.string().optional().describe("Creation date range as 'dd/MMM/yyyy,dd/MMM/yyyy'."),
+  updatedOn: zod__default.string().optional().describe("Update date range as 'dd/MMM/yyyy,dd/MMM/yyyy'."),
+  labels: zod__default.array(zod__default.string()).optional().describe("Jira label names."),
+  components: zod__default.array(zod__default.string()).optional().describe("Jira component names."),
+  latestExecutionResult: zod__default.array(zod__default.string()).optional().describe("Latest execution results (e.g., ['passed', 'failed'])."),
+  fixVersions: zod__default.array(zod__default.string()).optional().describe("Jira fix version names."),
+  sprint: zod__default.array(SprintFilter).optional().describe("Sprint filters with boardName and sprintName."),
+  status: zod__default.array(zod__default.string()).optional().describe("Test case status names."),
+  priority: zod__default.array(zod__default.string()).optional().describe("Priority names (e.g., ['High', 'Low'])."),
+  isAutomated: zod__default.boolean().optional().describe("Filter automated test cases."),
+  archived: zod__default.boolean().optional().describe("Filter archived test cases."),
+  shareable: zod__default.boolean().optional().describe("Filter shareable test cases."),
+  estimatedTime: zod__default.string().optional().describe("Estimated time in HH:MM:SS format."),
+  requirementIds: zod__default.array(zod__default.number().int()).optional().describe("Jira issue IDs of linked requirements."),
+  requirementJQL: zod__default.string().optional().describe("JQL to filter by linked requirements."),
+  excludeRequirementId: zod__default.number().int().optional().describe("Exclude test cases linked to this requirement ID."),
+  excludeCycleId: zod__default.string().optional().describe("Exclude test cases already in this test cycle ID."),
+  searchText: zod__default.string().optional().describe("Free-text search across test case fields."),
+  searchInFields: zod__default.array(zod__default.string()).optional().describe("Fields to search in (e.g., ['summary', 'description'])."),
+  filterId: zod__default.number().int().optional().describe("Saved filter ID."),
+  issueKeys: zod__default.array(zod__default.string()).optional().describe("Jira issue keys to filter by."),
+  withChild: zod__default.boolean().optional().describe("Include test cases in child folders."),
+  aiGenerated: zod__default.boolean().optional().describe("Filter AI-generated test cases."),
+  skipTestcase: zod__default.array(zod__default.number().int()).optional().describe("Test case IDs to skip."),
+  testCaseVersionIds: zod__default.array(zod__default.number().int()).optional().describe("Specific test case version IDs to include."),
+  excludeUids: zod__default.array(zod__default.string()).optional().describe("Test case UIDs to exclude."),
+  skipTestCaseVersions: zod__default.array(TestCaseVersionSkip).optional().describe("Test case versions to skip (each with testCaseId and version)."),
+  excludeTestCases: zod__default.array(TestCaseVersionSkip).optional().describe(
+    "Test case versions to exclude (each with testCaseId and version)."
+  )
+});
+const UnlinkFromCycleTestCaseFilter = zod__default.object({
+  key: zod__default.string().optional().describe("Test case key (e.g., 'SCRUM-TC-145')."),
+  summary: zod__default.string().optional(),
+  searchText: zod__default.string().optional(),
+  description: zod__default.string().optional(),
+  assignee: zod__default.array(zod__default.string()).optional(),
+  reporter: zod__default.array(zod__default.string()).optional(),
+  labels: zod__default.array(zod__default.string()).optional(),
+  components: zod__default.array(zod__default.string()).optional(),
+  fixVersions: zod__default.array(zod__default.string()).optional(),
+  sprint: zod__default.array(SprintFilter).optional(),
+  build: zod__default.array(zod__default.string()).optional().describe("Build names."),
+  status: zod__default.array(zod__default.string()).optional(),
+  priority: zod__default.array(zod__default.string()).optional(),
+  executionResult: zod__default.array(zod__default.string()).optional().describe("Execution results (e.g., ['Pass', 'Fail', 'Blocked'])."),
+  environment: zod__default.array(zod__default.string()).optional().describe("Environment names."),
+  tcWithDefects: zod__default.boolean().optional().describe("Filter test cases with defects."),
+  estimatedTime: zod__default.string().optional(),
+  actualTime: zod__default.string().optional(),
+  testCaseStatus: zod__default.string().optional().describe("Test case approval status."),
+  executionAssignee: zod__default.array(zod__default.string()).optional().describe("Jira account IDs of execution assignees."),
+  requirementId: zod__default.array(zod__default.number().int()).optional().describe("Requirement IDs linked to test cases."),
+  isAutomated: zod__default.boolean().optional(),
+  searchInFields: zod__default.array(zod__default.string()).optional().describe("Fields to search in (e.g., ['summary', 'description'])."),
+  createdBy: zod__default.array(zod__default.string()).optional(),
+  createdOn: zod__default.string().optional(),
+  updatedBy: zod__default.array(zod__default.string()).optional(),
+  updatedOn: zod__default.string().optional(),
+  filterId: zod__default.number().int().optional(),
+  folderId: zod__default.number().int().optional(),
+  executedBy: zod__default.string().optional().describe("Jira account ID of the user who executed the test case."),
+  executionPlannedDate: zod__default.string().optional().describe("Planned execution date."),
+  aiGenerated: zod__default.boolean().optional(),
+  excludeTestCases: zod__default.array(TestCaseVersionSkip).optional().describe("Test case versions to exclude from results."),
+  skipTestCaseVersions: zod__default.array(TestCaseVersionSkip).optional().describe("Test case versions to skip.")
+});
+const LinkTestCasesToCycleBody = zod__default.object({
+  cycleKey: zod__default.string().describe(
+    "Test Cycle key (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically."
+  ),
+  testCaseKeys: zod__default.array(zod__default.string()).optional().describe(
+    "Test case keys to link (e.g., ['SCRUM-TC-1', 'SCRUM-TC-2']). Resolved to internal IDs and latest versions automatically. Provide this OR filter — not both."
+  ),
+  filter: LinkToCycleTestCaseFilter.optional().describe(
+    "Filter criteria to select test cases to link. projectId is auto-filled from the active project context."
+  ),
+  sort: zod__default.string().optional().describe(
+    "Sort order in 'field:asc|desc' format (e.g., 'createdOn:desc'). Default is 'createdOn:desc'."
+  ),
+  assignee: zod__default.string().optional().describe("Jira account ID of the assignee for the linked executions."),
+  environmentId: zod__default.number().int().optional().describe("Environment ID from 'Get all environments in a project'."),
+  buildId: zod__default.number().int().optional().describe("Build ID from 'Get all builds in a project'."),
+  actualTime: zod__default.string().optional().describe("Actual time spent in HH:mm format (e.g., '02:30')."),
+  startNewExecution: zod__default.boolean().optional().describe("Start a new execution for linked test cases. Default is false."),
+  executionPlannedDate: zod__default.string().optional().describe(
+    "Planned execution date in yyyy-MM-dd format (e.g., '2023-12-31')."
+  ),
+  qiGenerated: zod__default.boolean().optional().describe("Flag indicating AI-generated test cases. Default is false.")
+});
+const UnlinkTestCasesFromCycleBody = zod__default.object({
+  cycleKey: zod__default.string().describe(
+    "Test Cycle key (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically."
+  ),
+  testCaseKeys: zod__default.array(zod__default.string()).optional().describe(
+    "Test case keys to unlink (e.g., ['SCRUM-TC-1', 'SCRUM-TC-2']). Resolved to internal IDs and latest versions automatically. Provide this OR filter or unlinkAll — not combined."
+  ),
+  unlinkAll: zod__default.boolean().optional().describe(
+    "If true, all test cases are unlinked from the cycle. Ignores testCaseKeys and filter."
+  ),
+  filter: UnlinkFromCycleTestCaseFilter.optional().describe(
+    "Filter criteria to select test cases to unlink. projectId is auto-filled from the active project context."
+  )
+});
+const TestCycleLinkResponse = zod__default.object({
+  cycleKey: zod__default.string(),
+  linked: zod__default.literal(true).optional(),
+  unlinked: zod__default.literal(true).optional()
+});
+const SearchLinkedTestCasesInCycleFilter = zod__default.object({
+  key: zod__default.string().optional().describe("Jira issue key (e.g., 'PROJ-123')."),
+  summary: zod__default.string().optional().describe("Test case summary text."),
+  description: zod__default.string().optional().describe("Test case description text."),
+  searchText: zod__default.string().optional().describe("Free-text search within fields."),
+  searchInFields: zod__default.array(zod__default.string()).optional().describe("Fields to search in (e.g., ['summary', 'description'])."),
+  assignee: zod__default.array(zod__default.string()).optional().describe("Jira user UUIDs of assignees."),
+  reporter: zod__default.array(zod__default.string()).optional().describe("Jira user UUIDs of reporters."),
+  labels: zod__default.array(zod__default.string()).optional().describe("Label names."),
+  components: zod__default.array(zod__default.string()).optional().describe("Component names."),
+  fixVersions: zod__default.array(zod__default.string()).optional().describe("Fix version names."),
+  status: zod__default.array(zod__default.string()).optional().describe("Test case status names."),
+  priority: zod__default.array(zod__default.string()).optional().describe("Priority names (e.g., ['High', 'Low'])."),
+  executionResult: zod__default.array(zod__default.string()).optional().describe("Execution result values (e.g., ['Pass', 'Fail', 'Blocked'])."),
+  environment: zod__default.array(zod__default.string()).optional().describe("Environment names."),
+  tcWithDefects: zod__default.boolean().optional().describe("Filter test cases that have defects linked."),
+  isAutomated: zod__default.boolean().optional().describe("Filter automated test cases."),
+  folderId: zod__default.number().int().optional().describe("Folder ID to filter by."),
+  executionAssignee: zod__default.array(zod__default.string()).optional().describe("Jira user UUIDs of execution assignees."),
+  executionPlannedDate: zod__default.string().optional().describe(
+    "Planned execution date range in 'dd/mmm/yyyy,dd/mmm/yyyy' format."
+  ),
+  createdOn: zod__default.string().optional().describe("Creation date range in 'dd/mmm/yyyy,dd/mmm/yyyy' format."),
+  updatedOn: zod__default.string().optional().describe("Last-updated date range in 'dd/mmm/yyyy,dd/mmm/yyyy' format."),
+  createdBy: zod__default.array(zod__default.string()).optional().describe("Jira user UUIDs of creators."),
+  updatedBy: zod__default.array(zod__default.string()).optional().describe("Jira user UUIDs of last updaters."),
+  aiGenerated: zod__default.boolean().optional().describe("Filter AI-generated test cases."),
+  filterId: zod__default.number().int().optional().describe("Saved filter ID.")
+});
+const SearchLinkedTestCasesInCycleBody = zod__default.object({
+  cycleKey: zod__default.string().describe(
+    "Test Cycle key in '{PROJECT_KEY}-TR-{id}' format (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically."
+  ),
+  fields: zod__default.array(zod__default.string()).optional().describe(
+    "Fields to include in each result object. Allowed: id, key, summary, description, executionResult, status, priority, environment, tcWithDefects, estimatedTime, actualTime, createdOn, updatedOn, sprint, seqNo, latestTcExecutionId, customFields, flakyScore, passRateScore. Omit to return all fields."
+  ),
+  maxResults: zod__default.number().int().min(1).max(100).optional().default(50).describe("Maximum results per page (1-100). Default: 50."),
+  sort: zod__default.string().optional().describe(
+    "Sort pattern in 'field:asc|desc' format (e.g., 'key:desc'). Allowed sort fields: id, key, summary, description, executionResult, status, priority, environment, tcWithDefects, estimatedTime, actualTime, createdOn, updatedOn, sprint, flakyScore, passRateScore."
+  ),
+  startAt: zod__default.number().int().min(0).optional().default(0).describe("Zero-indexed offset for pagination. Default: 0."),
+  filter: SearchLinkedTestCasesInCycleFilter.optional().describe(
+    "Optional filter criteria to narrow down results. projectId is auto-filled from the active project context."
+  )
+});
+const TestCycleExecutionSchema = zod__default.object({
+  id: zod__default.string().optional().describe("Internal test case execution ID."),
+  key: zod__default.string().optional().describe("Test case key (e.g., 'SCRUM-TC-145')."),
+  summary: zod__default.string().optional().describe("Test case summary."),
+  description: zod__default.string().nullable().optional(),
+  executionResult: zod__default.string().nullable().optional().describe("Execution result (e.g., 'Pass', 'Fail', 'Blocked')."),
+  status: zod__default.any().optional().describe("Test case status."),
+  priority: zod__default.any().optional().describe("Test case priority."),
+  environment: zod__default.string().nullable().optional(),
+  tcWithDefects: zod__default.boolean().optional(),
+  estimatedTime: zod__default.string().nullable().optional(),
+  actualTime: zod__default.string().nullable().optional(),
+  createdOn: zod__default.string().nullable().optional(),
+  updatedOn: zod__default.string().nullable().optional(),
+  sprint: zod__default.any().nullable().optional(),
+  seqNo: zod__default.number().nullable().optional(),
+  latestTcExecutionId: zod__default.string().nullable().optional(),
+  customFields: zod__default.any().nullable().optional(),
+  flakyScore: zod__default.number().nullable().optional(),
+  passRateScore: zod__default.number().nullable().optional()
+}).passthrough();
+const SearchLinkedTestCasesInCycleResponse = zod__default.object({
+  total: zod__default.number().int().describe(
+    "Total test case executions matching the filter (across all pages)."
+  ),
+  startAt: zod__default.number().int().describe("Offset of this page."),
+  maxResults: zod__default.number().int().describe("Page size used for this response."),
+  data: zod__default.array(TestCycleExecutionSchema).describe("Test case execution entries on this page.")
+});
+const GetLinkedRequirementsForCycleBody = zod__default.object({
+  cycleKey: zod__default.string().describe(
+    "Test cycle key in '{PROJECT_KEY}-TR-{id}' format (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically."
+  ),
+  maxResults: zod__default.number().int().min(1).max(100).optional().default(50).describe("Maximum results per page (1-100). Default: 50."),
+  startAt: zod__default.number().int().min(0).optional().default(0).describe("Zero-indexed offset for pagination. Default: 0."),
+  sort: zod__default.string().optional().describe(
+    "Sort pattern in 'field:asc|desc' format. Allowed fields: key, status, priority. Default: 'key:desc'."
+  )
+});
+const LinkRequirementsToCycleBody = zod__default.object({
+  cycleKey: zod__default.string().describe(
+    "Test cycle key in '{PROJECT_KEY}-TR-{id}' format (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically."
+  ),
+  requirementKeys: zod__default.array(zod__default.string()).optional().describe(
+    "List of Jira requirement keys to link (e.g., ['SCRUM-1', 'SCRUM-2']). Resolved to internal IDs automatically. Provide this OR filter.jql — not both."
+  ),
+  filter: zod__default.object({
+    jql: zod__default.string().describe(
+      'JQL query to filter requirements to link (e.g., "project = DEMO AND issuetype = Story").'
+    )
+  }).optional().describe(
+    "JQL filter to select requirements to link. Use instead of requirementKeys when filtering by JQL."
+  )
+});
+const LinkRequirementsToCycleResponse = zod__default.object({
+  cycleKey: zod__default.string(),
+  linked: zod__default.literal(true)
+});
+const UnlinkRequirementsFromCycleBody = zod__default.object({
+  cycleKey: zod__default.string().describe(
+    "Test cycle key in '{PROJECT_KEY}-TR-{id}' format (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically."
+  ),
+  requirementKeys: zod__default.array(zod__default.string()).optional().describe(
+    "List of Jira requirement keys to unlink (e.g., ['SCRUM-1', 'SCRUM-2']). Resolved to internal IDs automatically. Provide this OR unLinkAll — not both."
+  ),
+  unLinkAll: zod__default.boolean().optional().describe(
+    "If true, all requirements are unlinked from the cycle. Ignores requirementKeys."
+  )
+});
+const UnlinkRequirementsFromCycleResponse = zod__default.object({
+  cycleKey: zod__default.string(),
+  unlinked: zod__default.literal(true)
+});
+export {
+  GetLinkedRequirementsForCycleBody,
+  LinkRequirementsToCycleBody,
+  LinkRequirementsToCycleResponse,
+  LinkTestCasesToCycleBody,
+  LinkToCycleTestCaseFilter,
+  SearchLinkedTestCasesInCycleBody,
+  SearchLinkedTestCasesInCycleFilter,
+  SearchLinkedTestCasesInCycleResponse,
+  TestCycleLinkResponse,
+  UnlinkFromCycleTestCaseFilter,
+  UnlinkRequirementsFromCycleBody,
+  UnlinkRequirementsFromCycleResponse,
+  UnlinkTestCasesFromCycleBody
+};

package/dist/qtm4j/tool/project/get-projects.js

@@ -1,9 +1,10 @@
 import { Tool } from "../../../common/tools.js";
-import { TOOL_NAMES, RESPONSE_FIELDS, PAGINATION, ENDPOINTS } from "../../config/constants.js";
+import { TOOL_NAMES, TOOLSETS, RESPONSE_FIELDS, PAGINATION, ENDPOINTS } from "../../config/constants.js";
 import { GetProjectsResponse, GetProjectsBody } from "../../schema/project.schema.js";
 class GetProjects extends Tool {
   specification = {
     title: TOOL_NAMES.GET_PROJECTS.TITLE,
+    toolset: TOOLSETS.PROJECTS,
     summary: TOOL_NAMES.GET_PROJECTS.SUMMARY,
     readOnly: true,
     idempotent: true,

package/dist/qtm4j/tool/project/set-project-context.js

@@ -1,5 +1,5 @@
 import { Tool, ToolError } from "../../../common/tools.js";
-import { TOOL_NAMES, ENDPOINTS, PAGINATION, RESPONSE_FIELDS } from "../../config/constants.js";
+import { TOOL_NAMES, TOOLSETS, ENDPOINTS, PAGINATION, RESPONSE_FIELDS } from "../../config/constants.js";
 import { SetProjectContextResponse, SetProjectContextBody, GetProjectsResponse } from "../../schema/project.schema.js";
 const PROJECT_SEARCH_MAX_RESULTS = 10;
 const ERRORS = {
@@ -9,6 +9,7 @@ const ERRORS = {
 class SetProjectContext extends Tool {
   specification = {
     title: TOOL_NAMES.SET_PROJECT_CONTEXT.TITLE,
+    toolset: TOOLSETS.PROJECTS,
     summary: TOOL_NAMES.SET_PROJECT_CONTEXT.SUMMARY,
     readOnly: false,
     idempotent: true,

package/dist/qtm4j/tool/requirement/get-linked-testcases.js

@@ -0,0 +1,93 @@
+import { Tool, ToolError } from "../../../common/tools.js";
+import { TOOLSETS, TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys } from "../../config/field-resolution.types.js";
+import { GetLinkedTestCasesForRequirementBody } from "../../schema/linked-items.schema.js";
+import { SearchTestCaseResponse } from "../../schema/get-test-case.schema.js";
+class GetLinkedTestCasesForRequirement extends Tool {
+  specification = {
+    title: TOOL_NAMES.GET_LINKED_TESTCASES_FOR_REQUIREMENT.TITLE,
+    summary: TOOL_NAMES.GET_LINKED_TESTCASES_FOR_REQUIREMENT.SUMMARY,
+    readOnly: true,
+    idempotent: true,
+    toolset: TOOLSETS.REQUIREMENTS,
+    inputSchema: GetLinkedTestCasesForRequirementBody,
+    outputSchema: SearchTestCaseResponse,
+    purpose: "Retrieve all test cases linked to a specific Jira requirement in QTM4J. The requirement's human-readable key (e.g. 'SCRUM-1') is resolved to the internal Jira issue ID automatically. Returns a paginated list of linked test cases with their metadata. Use the filter to narrow results by status, priority, labels, folder, and more. PREREQUISITE: set_project_context must be called before this tool.",
+    useCases: [
+      "Check which test cases cover a Jira story or bug",
+      "Audit requirement traceability — find all test cases for a given requirement",
+      "Filter linked test cases by status or priority before a release",
+      "Retrieve test case keys to use in update or link operations"
+    ],
+    examples: [
+      {
+        description: "Get all test cases linked to a requirement",
+        parameters: { requirementKey: "SCRUM-1" },
+        expectedOutput: "Paginated list of linked test cases"
+      },
+      {
+        description: "Get high priority linked test cases",
+        parameters: {
+          requirementKey: "SCRUM-5",
+          filter: { priority: ["High"] },
+          fields: "key,summary,status,priority",
+          sort: "key:asc"
+        },
+        expectedOutput: "Filtered high-priority test cases linked to requirement"
+      },
+      {
+        description: "Paginate through linked test cases",
+        parameters: {
+          requirementKey: "SCRUM-1",
+          maxResults: 20,
+          startAt: 20
+        },
+        expectedOutput: "Second page of linked test cases"
+      }
+    ],
+    hints: [
+      "PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project.",
+      "REQUIREMENT KEY FORMAT: '{PROJECT_KEY}-{number}' — e.g. 'SCRUM-1'.",
+      "projectId in filter is auto-filled from the active project context — do not set it manually.",
+      "Use the fields param to limit response size — only request fields you need.",
+      "Paginate using startAt — increment by maxResults until startAt >= total.",
+      "filter.testCaseStatus can be 'active', 'archived', or 'deleted' to filter by archive state."
+    ],
+    outputDescription: "Paginated response with total, startAt, maxResults, and data array of linked test case objects."
+  };
+  handle = async (rawArgs) => {
+    const args = GetLinkedTestCasesForRequirementBody.parse(rawArgs);
+    const fieldResolver = this.client.getResolverRegistry();
+    const context = fieldResolver.requireProjectContext();
+    const reqMap = await fieldResolver.getResolver(ResolverKeys.SearchableField.REQUIREMENT_KEY_TO_ID).resolveAndReturn(context.projectId, [args.requirementKey]);
+    const reqEntry = reqMap[args.requirementKey];
+    if (!reqEntry) {
+      throw new ToolError(
+        `Requirement '${args.requirementKey}' not found in project '${context.projectKey}'. Verify the key is a valid Jira issue key.`
+      );
+    }
+    const requirementId = Number(reqEntry.id);
+    const queryParams = {
+      fields: args.fields,
+      maxResults: args.maxResults,
+      startAt: args.startAt,
+      sort: args.sort
+    };
+    const body = {};
+    if (args.filter) {
+      body.filter = { ...args.filter, projectId: context.projectId };
+    }
+    const response = await this.client.getApiClient().post(
+      ENDPOINTS.GET_LINKED_TESTCASES_FOR_REQUIREMENT(requirementId),
+      body,
+      queryParams
+    );
+    return {
+      structuredContent: SearchTestCaseResponse.parse(response),
+      content: []
+    };
+  };
+}
+export {
+  GetLinkedTestCasesForRequirement
+};

package/dist/qtm4j/tool/requirement/link-testcases.js

@@ -0,0 +1,107 @@
+import { Tool, ToolError } from "../../../common/tools.js";
+import { TOOLSETS, TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys } from "../../config/field-resolution.types.js";
+import { RequirementTestCaseLinkResponse, LinkTestCasesToRequirementBody } from "../../schema/requirements.schema.js";
+class LinkTestCasesToRequirement extends Tool {
+  specification = {
+    title: TOOL_NAMES.LINK_TESTCASES_TO_REQUIREMENT.TITLE,
+    summary: TOOL_NAMES.LINK_TESTCASES_TO_REQUIREMENT.SUMMARY,
+    readOnly: false,
+    idempotent: false,
+    toolset: TOOLSETS.REQUIREMENTS,
+    inputSchema: LinkTestCasesToRequirementBody,
+    outputSchema: RequirementTestCaseLinkResponse,
+    purpose: "Link test cases to a Jira requirement in QTM4J using the requirement's human-readable key. Test cases can be specified by their keys (e.g. 'SCRUM-TC-1'), which are resolved to internal IDs and latest versions automatically. Alternatively, use a filter object to select test cases by criteria such as status, priority, labels, or folder. The active project ID is injected automatically into the filter. Test cases that cannot be linked are reported in warnings. PREREQUISITE: set_project_context must be called before this tool.",
+    useCases: [
+      "Link specific test cases to a Jira story or bug by requirement key",
+      "Build traceability between Jira requirements and QTM4J test cases",
+      "Link all test cases matching a filter to a requirement",
+      "Associate test cases with a requirement as part of sprint planning"
+    ],
+    examples: [
+      {
+        description: "Link two test cases by key",
+        parameters: {
+          requirementKey: "SCRUM-1",
+          testCaseKeys: ["SCRUM-TC-10", "SCRUM-TC-11"]
+        },
+        expectedOutput: "Test cases linked to requirement SCRUM-1"
+      },
+      {
+        description: "Link test cases matching a filter",
+        parameters: {
+          requirementKey: "SCRUM-1",
+          filter: { priority: ["High"], status: ["To Do"] }
+        },
+        expectedOutput: "Filtered test cases linked to requirement"
+      },
+      {
+        description: "Link test cases in a specific folder",
+        parameters: {
+          requirementKey: "SCRUM-5",
+          filter: { folderId: 42, withChild: true },
+          sort: "key:asc"
+        },
+        expectedOutput: "Folder test cases linked to requirement"
+      }
+    ],
+    hints: [
+      "PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project.",
+      "REQUIREMENT KEY FORMAT: '{PROJECT_KEY}-{number}' — e.g. 'SCRUM-1'.",
+      "TEST CASE KEY FORMAT: '{PROJECT_KEY}-TC-{number}' — e.g. 'SCRUM-TC-145'.",
+      "Provide either testCaseKeys or filter — not both.",
+      "projectId in filter is auto-filled from the active project context — do not set it manually.",
+      "filter.excludeRequirementId excludes test cases already linked to that requirement ID.",
+      "If a test case key cannot be resolved, it is reported in warnings and other test cases are still linked."
+    ],
+    outputDescription: "Confirmation with the requirement key and linked: true. Warnings included if any test cases could not be resolved or linked."
+  };
+  handle = async (rawArgs) => {
+    const args = LinkTestCasesToRequirementBody.parse(rawArgs);
+    const fieldResolver = this.client.getResolverRegistry();
+    const context = fieldResolver.requireProjectContext();
+    const warnings = [];
+    const reqMap = await fieldResolver.getResolver(ResolverKeys.SearchableField.REQUIREMENT_KEY_TO_ID).resolveAndReturn(context.projectId, [args.requirementKey]);
+    const reqEntry = reqMap[args.requirementKey];
+    if (!reqEntry) {
+      throw new ToolError(
+        `Requirement '${args.requirementKey}' not found in project '${context.projectKey}'. Verify the key is a valid Jira issue key.`
+      );
+    }
+    const requirementId = Number(reqEntry.id);
+    const body = {};
+    if (args.testCaseKeys?.length) {
+      const uidMap = await fieldResolver.getResolver(ResolverKeys.SearchableField.TEST_CASE_KEY_TO_UID).resolveAndReturn(context.projectId, args.testCaseKeys);
+      const testcases = [];
+      for (const tcKey of args.testCaseKeys) {
+        const resolved = uidMap[tcKey];
+        if (resolved) {
+          testcases.push({
+            id: resolved.uid,
+            versionNo: resolved.latestVersion
+          });
+        } else {
+          warnings.push(
+            `Test case '${tcKey}' could not be resolved and was skipped.`
+          );
+        }
+      }
+      if (testcases.length > 0) body.testcases = testcases;
+    }
+    if (args.filter) {
+      body.filter = { ...args.filter, projectId: context.projectId };
+    }
+    if (args.sort) body.sort = args.sort;
+    await this.client.getApiClient().post(ENDPOINTS.LINK_TESTCASES_TO_REQUIREMENT(requirementId), body);
+    return {
+      structuredContent: RequirementTestCaseLinkResponse.parse({
+        requirementKey: args.requirementKey,
+        linked: true
+      }),
+      content: warnings.length > 0 ? [{ type: "text", text: `Note: ${warnings.join(" | ")}` }] : []
+    };
+  };
+}
+export {
+  LinkTestCasesToRequirement
+};

package/dist/qtm4j/tool/requirement/unlink-testcases.js

@@ -0,0 +1,97 @@
+import { Tool, ToolError } from "../../../common/tools.js";
+import { TOOLSETS, TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys } from "../../config/field-resolution.types.js";
+import { RequirementTestCaseLinkResponse, UnlinkTestCasesFromRequirementBody } from "../../schema/requirements.schema.js";
+class UnlinkTestCasesFromRequirement extends Tool {
+  specification = {
+    title: TOOL_NAMES.UNLINK_TESTCASES_FROM_REQUIREMENT.TITLE,
+    summary: TOOL_NAMES.UNLINK_TESTCASES_FROM_REQUIREMENT.SUMMARY,
+    readOnly: false,
+    idempotent: false,
+    toolset: TOOLSETS.REQUIREMENTS,
+    inputSchema: UnlinkTestCasesFromRequirementBody,
+    outputSchema: RequirementTestCaseLinkResponse,
+    purpose: "Unlink test cases from a Jira requirement in QTM4J using the requirement's human-readable key. Test cases can be specified by their keys (e.g. 'SCRUM-TC-1'), which are resolved to internal IDs and latest versions automatically. Alternatively, use a filter object to select test cases to unlink by criteria. The active project ID is injected automatically into the filter. Test cases that cannot be unlinked are reported in warnings. PREREQUISITE: set_project_context must be called before this tool.",
+    useCases: [
+      "Remove specific test cases from a Jira requirement",
+      "Unlink test cases matching a filter from a requirement",
+      "Clean up stale or incorrect test case links on a requirement",
+      "Remove traceability links as part of sprint cleanup"
+    ],
+    examples: [
+      {
+        description: "Unlink specific test cases by key",
+        parameters: {
+          requirementKey: "SCRUM-1",
+          testCaseKeys: ["SCRUM-TC-10", "SCRUM-TC-11"]
+        },
+        expectedOutput: "Test cases unlinked from requirement SCRUM-1"
+      },
+      {
+        description: "Unlink test cases matching a filter",
+        parameters: {
+          requirementKey: "SCRUM-1",
+          filter: { status: ["Done"], labels: ["Deprecated"] }
+        },
+        expectedOutput: "Filtered test cases unlinked from requirement"
+      }
+    ],
+    hints: [
+      "PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project.",
+      "REQUIREMENT KEY FORMAT: '{PROJECT_KEY}-{number}' — e.g. 'SCRUM-1'.",
+      "TEST CASE KEY FORMAT: '{PROJECT_KEY}-TC-{number}' — e.g. 'SCRUM-TC-145'.",
+      "Provide either testCaseKeys or filter — not both.",
+      "projectId in filter is auto-filled from the active project context — do not set it manually.",
+      "filter.excludeTestCases can be used to exclude specific test cases when using filter-based unlinking.",
+      "If a test case key cannot be resolved, it is reported in warnings and other test cases are still unlinked."
+    ],
+    outputDescription: "Confirmation with the requirement key and unlinked: true. Warnings included if any test cases could not be resolved or unlinked."
+  };
+  handle = async (rawArgs) => {
+    const args = UnlinkTestCasesFromRequirementBody.parse(rawArgs);
+    const fieldResolver = this.client.getResolverRegistry();
+    const context = fieldResolver.requireProjectContext();
+    const warnings = [];
+    const reqMap = await fieldResolver.getResolver(ResolverKeys.SearchableField.REQUIREMENT_KEY_TO_ID).resolveAndReturn(context.projectId, [args.requirementKey]);
+    const reqEntry = reqMap[args.requirementKey];
+    if (!reqEntry) {
+      throw new ToolError(
+        `Requirement '${args.requirementKey}' not found in project '${context.projectKey}'. Verify the key is a valid Jira issue key.`
+      );
+    }
+    const requirementId = Number(reqEntry.id);
+    const body = {};
+    if (args.testCaseKeys?.length) {
+      const uidMap = await fieldResolver.getResolver(ResolverKeys.SearchableField.TEST_CASE_KEY_TO_UID).resolveAndReturn(context.projectId, args.testCaseKeys);
+      const testcases = [];
+      for (const tcKey of args.testCaseKeys) {
+        const resolved = uidMap[tcKey];
+        if (resolved) {
+          testcases.push({
+            id: resolved.uid,
+            versionNo: resolved.latestVersion
+          });
+        } else {
+          warnings.push(
+            `Test case '${tcKey}' could not be resolved and was skipped.`
+          );
+        }
+      }
+      if (testcases.length > 0) body.testcases = testcases;
+    }
+    if (args.filter) {
+      body.filter = { ...args.filter, projectId: context.projectId };
+    }
+    await this.client.getApiClient().delete(ENDPOINTS.UNLINK_TESTCASES_FROM_REQUIREMENT(requirementId), body);
+    return {
+      structuredContent: RequirementTestCaseLinkResponse.parse({
+        requirementKey: args.requirementKey,
+        unlinked: true
+      }),
+      content: warnings.length > 0 ? [{ type: "text", text: `Note: ${warnings.join(" | ")}` }] : []
+    };
+  };
+}
+export {
+  UnlinkTestCasesFromRequirement
+};

package/dist/qtm4j/tool/test-automation/get-automation-history.js

@@ -1,9 +1,10 @@
 import { Tool } from "../../../common/tools.js";
-import { TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { TOOL_NAMES, TOOLSETS, ENDPOINTS } from "../../config/constants.js";
 import { GetAutomationHistoryResponse, GetAutomationHistoryBody } from "../../schema/automation.schema.js";
 class GetAutomationHistory extends Tool {
   specification = {
     title: TOOL_NAMES.GET_AUTOMATION_HISTORY.TITLE,
+    toolset: TOOLSETS.TEST_AUTOMATION,
     summary: TOOL_NAMES.GET_AUTOMATION_HISTORY.SUMMARY,
     readOnly: true,
     idempotent: true,

package/dist/qtm4j/tool/test-automation/upload-automation-result.js

@@ -1,12 +1,13 @@
 import { readFile } from "node:fs/promises";
 import { extname } from "node:path";
 import { Tool, ToolError } from "../../../common/tools.js";
-import { TOOL_NAMES, AUTOMATION_RESULT_DIRS, AUTOMATION_LIMITS, ENDPOINTS } from "../../config/constants.js";
+import { TOOL_NAMES, TOOLSETS, AUTOMATION_RESULT_DIRS, AUTOMATION_LIMITS, ENDPOINTS } from "../../config/constants.js";
 import { UploadAutomationResultResponse, UploadAutomationResultBody } from "../../schema/automation.schema.js";
 const SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".xml", ".json", ".zip"]);
 class UploadAutomationResult extends Tool {
   specification = {
     title: TOOL_NAMES.UPLOAD_AUTOMATION_RESULT.TITLE,
+    toolset: TOOLSETS.TEST_AUTOMATION,
     summary: TOOL_NAMES.UPLOAD_AUTOMATION_RESULT.SUMMARY,
     readOnly: false,
     idempotent: false,

package/dist/qtm4j/tool/test-case/create-test-case.js

@@ -1,5 +1,5 @@
 import { Tool } from "../../../common/tools.js";
-import { TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { TOOL_NAMES, TOOLSETS, ENDPOINTS } from "../../config/constants.js";
 import { ResolverKeys, InputField } from "../../config/field-resolution.types.js";
 import { CreateTestCaseResponse, CreateTestCaseBody } from "../../schema/test-case.schema.js";
 const FIELD_CONFIG = {
@@ -13,6 +13,7 @@ class CreateTestCase extends Tool {
   // ─── Tool Specification ────────────────────────────────────────────────────
   specification = {
     title: TOOL_NAMES.CREATE_TEST_CASE.TITLE,
+    toolset: TOOLSETS.TEST_CASES,
     summary: TOOL_NAMES.CREATE_TEST_CASE.SUMMARY,
     readOnly: false,
     idempotent: false,