@smartbear/mcp 0.24.0 → 0.25.1

package/dist/qtm4j/schema/linked-items.schema.js

@@ -0,0 +1,95 @@
+import zod__default from "zod";
+import { SearchTestCaseResponse } from "./get-test-case.schema.js";
+const GetLinkedRequirementsBody = zod__default.object({
+  key: zod__default.string().describe(
+    "Test case key in '{PROJECT_KEY}-TC-{number}' format (e.g., 'SCRUM-TC-145'). Required."
+  ),
+  versionNo: zod__default.number().int().optional().describe(
+    "Test case version number to retrieve linked requirements for. Defaults to the latest version."
+  ),
+  maxResults: zod__default.number().int().min(1).max(100).optional().describe("Maximum results per page (1-100). Default: 50."),
+  startAt: zod__default.number().int().min(0).optional().describe("Zero-indexed offset for pagination. Default: 0."),
+  sort: zod__default.string().optional().describe("Sort pattern in 'field:asc|desc' format. Default: 'key:desc'.")
+});
+const LinkedRequirementSchema = zod__default.object({
+  id: zod__default.number().int().describe("Jira issue ID."),
+  key: zod__default.string().describe("Jira issue key (e.g., 'SCRUM-1')."),
+  summary: zod__default.string().optional().describe("Requirement summary."),
+  status: zod__default.object({
+    id: zod__default.number().optional(),
+    name: zod__default.string().optional(),
+    iconUrl: zod__default.string().optional(),
+    color: zod__default.string().optional()
+  }).optional(),
+  priority: zod__default.object({
+    id: zod__default.number().optional(),
+    name: zod__default.string().optional(),
+    iconUrl: zod__default.string().optional()
+  }).optional(),
+  issueType: zod__default.object({
+    id: zod__default.number().optional(),
+    name: zod__default.string().optional(),
+    iconUrl: zod__default.string().optional()
+  }).optional(),
+  tcVersionNo: zod__default.number().int().optional().describe("Test case version this requirement is linked to.")
+}).passthrough();
+const GetLinkedRequirementsResponse = zod__default.object({
+  startAt: zod__default.number().int(),
+  maxResults: zod__default.number().int(),
+  total: zod__default.number().int().describe("Total linked requirements (across all pages)."),
+  data: zod__default.array(LinkedRequirementSchema).describe("Linked requirements on this page.")
+});
+const SprintFilter = zod__default.object({
+  boardName: zod__default.string(),
+  sprintName: zod__default.string()
+});
+const GetLinkedTestCasesFilter = zod__default.object({
+  key: zod__default.string().optional().describe("Test case key (e.g., 'SCRUM-TC-145')."),
+  summary: zod__default.string().optional(),
+  folderId: zod__default.number().int().optional().describe("Folder ID."),
+  description: zod__default.string().optional(),
+  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(),
+  updatedBy: zod__default.array(zod__default.string()).optional(),
+  createdOn: zod__default.string().optional().describe("Date range 'dd/MMM/yyyy,dd/MMM/yyyy' for creation date."),
+  updatedOn: zod__default.string().optional().describe("Date range 'dd/MMM/yyyy,dd/MMM/yyyy' for last update date."),
+  labels: zod__default.array(zod__default.string()).optional().describe("Jira label names."),
+  components: zod__default.array(zod__default.string()).optional().describe("Jira component names."),
+  testCaseStatus: zod__default.string().optional().describe("Test case archive status: 'active', 'archived', or 'deleted'."),
+  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("Fix version names."),
+  sprint: zod__default.array(SprintFilter).optional(),
+  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'])."),
+  estimatedTime: zod__default.string().optional(),
+  requirementIds: zod__default.array(zod__default.number().int()).optional().describe("Requirement IDs."),
+  searchText: zod__default.string().optional().describe("Free-text search."),
+  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."),
+  isAutomated: zod__default.boolean().optional(),
+  aiGenerated: zod__default.boolean().optional()
+});
+const GetLinkedTestCasesForRequirementBody = zod__default.object({
+  requirementKey: zod__default.string().describe(
+    "Jira requirement key (e.g., 'SCRUM-1'). Resolved to the internal Jira issue ID automatically."
+  ),
+  filter: GetLinkedTestCasesFilter.optional().describe(
+    "Optional filter to narrow down the linked test cases. projectId is auto-filled from the active project context."
+  ),
+  fields: zod__default.string().optional().describe(
+    "Comma-separated field names to include in each result. Allowed: summary, priority, status, estimatedTime, executed, description, assignee, reporter, labels, components, fixVersions, sprint, isAutomated, folder, updated, created, seqNo, flakyScore, passRateScore."
+  ),
+  maxResults: zod__default.number().int().min(1).max(100).optional().describe("Maximum results per page (1-100). Default: 50."),
+  startAt: zod__default.number().int().min(0).optional().describe("Zero-indexed offset for pagination. Default: 0."),
+  sort: zod__default.string().optional().describe(
+    "Sort in 'field:asc|desc' format. Allowed fields: key, summary, created, updated, estimatedTime, status, priority, latestVersionNo, seqNo, flakyScore, passRateScore."
+  )
+});
+export {
+  GetLinkedRequirementsBody,
+  GetLinkedRequirementsResponse,
+  GetLinkedTestCasesFilter,
+  GetLinkedTestCasesForRequirementBody,
+  SearchTestCaseResponse as GetLinkedTestCasesResponse
+};

package/dist/qtm4j/schema/requirements.schema.js

@@ -0,0 +1,109 @@
+import zod__default from "zod";
+zod__default.object({
+  id: zod__default.string(),
+  versionNo: zod__default.number().int()
+});
+const SprintFilter = zod__default.object({
+  boardName: zod__default.string(),
+  sprintName: zod__default.string()
+});
+const LinkTestCaseFilter = 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 to filter by."),
+  folderId: zod__default.number().int().optional().describe("Folder ID to filter by."),
+  description: zod__default.string().optional().describe("Test case description to filter by."),
+  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 comma-separated start,end in dd/MMM/yyyy format (e.g., '01/Jan/2024,31/Jan/2024')."
+  ),
+  updatedOn: zod__default.string().optional().describe(
+    "Update date range as comma-separated start,end in dd/MMM/yyyy format."
+  ),
+  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 to filter by (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 (e.g., [{boardName:'board1', sprintName:'sprint1'}])."
+  ),
+  status: zod__default.array(zod__default.string()).optional().describe("Test case status names (e.g., ['To Do', 'In Progress'])."),
+  priority: zod__default.array(zod__default.string()).optional().describe("Priority names (e.g., ['High', 'Low'])."),
+  estimatedTime: zod__default.string().optional().describe("Estimated time filter in HH:MM:SS format."),
+  requirementIds: zod__default.array(zod__default.number().int()).optional().describe("Jira issue IDs of linked requirements."),
+  excludeRequirementId: zod__default.number().int().optional().describe("Exclude test cases already linked to this requirement 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."),
+  isAutomated: zod__default.boolean().optional().describe("Filter automated test cases."),
+  withChild: zod__default.boolean().optional().describe("Include test cases in child folders."),
+  aiGenerated: zod__default.boolean().optional().describe("Filter AI-generated test cases."),
+  excludeUids: zod__default.array(zod__default.string()).optional().describe("Test case UIDs to exclude from the filter result.")
+});
+const UnlinkTestCaseFilter = zod__default.object({
+  key: zod__default.string().optional().describe("Test case key."),
+  summary: zod__default.string().optional(),
+  folderId: zod__default.number().int().optional(),
+  description: zod__default.string().optional(),
+  assignee: zod__default.array(zod__default.string()).optional(),
+  reporter: zod__default.array(zod__default.string()).optional(),
+  createdBy: zod__default.array(zod__default.string()).optional(),
+  updatedBy: zod__default.array(zod__default.string()).optional(),
+  createdOn: zod__default.string().optional(),
+  updatedOn: zod__default.string().optional(),
+  labels: zod__default.array(zod__default.string()).optional(),
+  components: zod__default.array(zod__default.string()).optional(),
+  latestExecutionResult: zod__default.array(zod__default.string()).optional(),
+  fixVersions: zod__default.array(zod__default.string()).optional(),
+  sprint: zod__default.array(SprintFilter).optional(),
+  status: zod__default.array(zod__default.string()).optional(),
+  priority: zod__default.array(zod__default.string()).optional(),
+  estimatedTime: zod__default.string().optional(),
+  requirementIds: zod__default.array(zod__default.number().int()).optional(),
+  searchText: zod__default.string().optional(),
+  searchInFields: zod__default.array(zod__default.string()).optional(),
+  filterId: zod__default.number().int().optional(),
+  isAutomated: zod__default.boolean().optional(),
+  excludeTestCases: zod__default.array(zod__default.object({ id: zod__default.string(), versionNo: zod__default.number().int() })).optional().describe("Test cases to exclude from the filter result.")
+});
+const LinkTestCasesToRequirementBody = zod__default.object({
+  requirementKey: zod__default.string().describe(
+    "Jira requirement key (e.g., 'SCRUM-1'). Resolved to the internal Jira issue ID 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: LinkTestCaseFilter.optional().describe(
+    "Filter criteria to select test cases to link. Use instead of testCaseKeys when selecting by criteria. projectId is auto-filled from the active project context."
+  ),
+  sort: zod__default.string().optional().describe(
+    "Sort order for filter results in 'field:asc|desc' format (e.g., 'key:asc'). Allowable fields: key, summary, created, updated, estimatedTime, status, priority, latestVersionNo, flakyScore, passRateScore."
+  )
+});
+const UnlinkTestCasesFromRequirementBody = zod__default.object({
+  requirementKey: zod__default.string().describe(
+    "Jira requirement key (e.g., 'SCRUM-1'). Resolved to the internal Jira issue ID 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 — not both."
+  ),
+  filter: UnlinkTestCaseFilter.optional().describe(
+    "Filter criteria to select test cases to unlink. Use instead of testCaseKeys when selecting by criteria. projectId is auto-filled from the active project context."
+  )
+});
+const RequirementTestCaseLinkResponse = zod__default.object({
+  requirementKey: zod__default.string(),
+  linked: zod__default.literal(true).optional(),
+  unlinked: zod__default.literal(true).optional()
+});
+export {
+  LinkTestCaseFilter,
+  LinkTestCasesToRequirementBody,
+  RequirementTestCaseLinkResponse,
+  UnlinkTestCaseFilter,
+  UnlinkTestCasesFromRequirementBody
+};

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
+};