@smartbear/mcp 0.23.0 → 0.25.0

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/search-test-cycle.schema.js

@@ -0,0 +1,133 @@
+import * as zod from "zod";
+import { SORT_DEFAULTS, PAGINATION } from "../config/constants.js";
+const DATE_RANGE_REGEX = /^\d{2}\/[A-Z][a-z]{2}\/\d{4},\d{2}\/[A-Z][a-z]{2}\/\d{4}$/;
+const DATE_RANGE_DESCRIPTION = "Inclusive date range. Format: 'dd/MMM/yyyy,dd/MMM/yyyy' e.g. '02/Apr/2026,15/May/2026'. Month abbreviation is case-sensitive (Apr not apr or APR). Always provide two dates separated by a comma.";
+const SearchTestCycleFilter = zod.object({
+  projectId: zod.number().optional().describe(
+    "Numeric project ID. Auto-injected from active project context — do not provide."
+  ),
+  status: zod.array(zod.string()).optional().describe(
+    "Status names to include (OR logic within array). Examples: ['In Progress', 'To Do']. Common values: 'To Do', 'In Progress', 'Done'."
+  ),
+  priority: zod.array(zod.string()).optional().describe(
+    "Priority names to include (OR logic within array). Examples: ['High'], ['High', 'Medium']. Common values: 'High', 'Medium', 'Low'."
+  ),
+  assignee: zod.array(zod.string()).optional().describe(
+    "Jira account IDs of assignees (OR logic within array). Example: ['5b10a2844c20165700ede21f']. Multiple IDs match test cycles assigned to any of them."
+  ),
+  reporter: zod.array(zod.string()).optional().describe(
+    "Jira account IDs of reporters (OR logic within array). Example: ['5b10a2844c20165700ede21f']."
+  ),
+  folderId: zod.number().optional().describe(
+    "Folder ID to restrict results to (numeric). Right-click a folder in QTM4J and select 'Copy Folder Id'."
+  ),
+  labels: zod.array(zod.string()).optional().describe(
+    "Label names to include (OR logic within array). Example: ['Release_1', 'Sprint 1']. Use exact label names as configured in the project."
+  ),
+  components: zod.array(zod.string()).optional().describe(
+    "Component names to include (OR logic within array). Example: ['UI', 'Cloud']. Use exact component names as configured in the project."
+  ),
+  plannedStartDate: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 02/Apr/2026,15/May/2026"
+  ).optional().describe(DATE_RANGE_DESCRIPTION),
+  plannedEndDate: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 02/Apr/2026,15/May/2026"
+  ).optional().describe(DATE_RANGE_DESCRIPTION),
+  searchText: zod.string().optional().describe(
+    "Free-text search across key, summary, and description. Case-insensitive. Example: 'regression sprint'"
+  ),
+  createdOn: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 01/May/2026,20/May/2026"
+  ).optional().describe(
+    `Filter by creation date range (inclusive). ${DATE_RANGE_DESCRIPTION}`
+  ),
+  updatedOn: zod.string().regex(
+    DATE_RANGE_REGEX,
+    "Invalid format. Use dd/MMM/yyyy,dd/MMM/yyyy e.g. 01/May/2026,21/May/2026"
+  ).optional().describe(
+    "Filter by last-updated date range (inclusive). " + DATE_RANGE_DESCRIPTION
+  ),
+  isAutomated: zod.boolean().optional().describe(
+    "Automation status filter: true = automated tests only, false = manual tests only. Omit to include both."
+  ),
+  aiGenerated: zod.boolean().optional().describe(
+    "AI generation flag: true = AI-generated test cycles only, false = human-authored only. Omit to include both."
+  )
+}).describe(
+  "Filter criteria — multiple fields are combined with AND; multiple values within one field use OR."
+);
+const FIELDS_DESCRIPTION = "Fields to include in each result object. If omitted, server returns its default set (NOTE: plannedStartDate and plannedEndDate are NOT in the default response — include them explicitly when needed). Available fields: key, summary, description, status, priority, assignee, reporter, isAutomated, plannedStartDate, plannedEndDate, labels, components, fixVersions, sprint, defectCount, estimatedTime, actualTime, created, updated. Example: ['key', 'summary', 'status', 'assignee', 'plannedStartDate', 'plannedEndDate']";
+const SearchTestCycleBody = zod.object({
+  filter: SearchTestCycleFilter.optional(),
+  fields: zod.array(zod.string()).optional().describe(FIELDS_DESCRIPTION),
+  startAt: zod.number().min(0).optional().default(PAGINATION.DEFAULT_START_AT).describe(
+    "Zero-indexed offset for pagination (URL query param). Default: 0."
+  ),
+  maxResults: zod.number().min(PAGINATION.MIN_ALLOWED_RESULTS).max(PAGINATION.MAX_ALLOWED_RESULTS_TEST_CYCLES).optional().default(PAGINATION.DEFAULT_MAX_RESULTS_TEST_CYCLES).describe(
+    `Number of results per page (URL query param). Default: ${PAGINATION.DEFAULT_MAX_RESULTS_TEST_CYCLES}. Maximum: ${PAGINATION.MAX_ALLOWED_RESULTS_TEST_CYCLES}. To page through results, increment startAt by ${PAGINATION.DEFAULT_MAX_RESULTS_TEST_CYCLES} until startAt >= total.`
+  ),
+  sort: zod.string().optional().default(SORT_DEFAULTS.TEST_CYCLES).describe(
+    `Sort pattern sent as a URL query param. Format: 'fieldName:order'. Default: '${SORT_DEFAULTS.TEST_CYCLES}'. Order values: 'asc' (lowest/oldest first) or 'desc' (highest/newest first). Sortable fields: key, summary, status, plannedStartDate, plannedEndDate, defectCount. Examples: 'key:asc', 'plannedStartDate:desc'`
+  )
+});
+const TestCycleStatusSchema = zod.looseObject({
+  id: zod.number().optional().describe("Numeric status ID"),
+  name: zod.string().optional().describe("Status display name e.g. 'In Progress'"),
+  color: zod.string().nullable().optional().describe("Hex color e.g. '#ffd351'")
+});
+const TestCyclePrioritySchema = zod.looseObject({
+  id: zod.number().optional().describe("Numeric priority ID"),
+  name: zod.string().optional().describe("Priority display name e.g. 'High'"),
+  color: zod.string().nullable().optional().describe("Hex color")
+});
+const TestCycleLabelSchema = zod.looseObject({
+  id: zod.number().optional(),
+  name: zod.string().optional()
+});
+const TestCycleComponentSchema = zod.looseObject({
+  id: zod.number().optional(),
+  name: zod.string().optional()
+});
+const TestCycleSearchItemSchema = zod.looseObject({
+  id: zod.string().describe("Internal UID of the test cycle"),
+  key: zod.string().describe("Human-readable key e.g. 'PROJ-TR-212'"),
+  projectId: zod.number().optional().describe("Numeric project ID"),
+  summary: zod.string().optional().describe("Test cycle name / title"),
+  description: zod.string().nullable().optional(),
+  status: TestCycleStatusSchema.optional().describe(
+    "Status object (empty {} when not requested)"
+  ),
+  priority: TestCyclePrioritySchema.optional().describe(
+    "Priority object (empty {} when not requested)"
+  ),
+  assignee: zod.string().nullable().optional().describe("Assignee Jira account ID, or null if unassigned"),
+  reporter: zod.string().nullable().optional(),
+  isAutomated: zod.boolean().optional(),
+  plannedStartDate: zod.string().nullable().optional(),
+  plannedEndDate: zod.string().nullable().optional(),
+  labels: zod.array(TestCycleLabelSchema).nullable().optional(),
+  components: zod.array(TestCycleComponentSchema).nullable().optional(),
+  fixVersions: zod.array(zod.any()).nullable().optional(),
+  sprint: zod.any().nullable().optional(),
+  defectCount: zod.number().nullable().optional(),
+  estimatedTime: zod.any().nullable().optional(),
+  actualTime: zod.any().nullable().optional(),
+  created: zod.any().optional(),
+  updated: zod.any().optional(),
+  archived: zod.boolean().optional()
+});
+const SearchTestCycleResponse = zod.object({
+  startAt: zod.number().describe("Offset of this page"),
+  maxResults: zod.number().describe("Page size used for this response"),
+  total: zod.number().describe("Total matching test cycles across all pages"),
+  data: zod.array(TestCycleSearchItemSchema).describe("Test cycles on this page")
+});
+export {
+  SearchTestCycleBody,
+  SearchTestCycleFilter,
+  SearchTestCycleResponse,
+  TestCycleSearchItemSchema
+};

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/schema/test-cycle.schema.js

@@ -0,0 +1,39 @@
+import * as zod from "zod";
+const CreateTestCycleBody = zod.object({
+  summary: zod.string().min(1).max(255).describe(
+    "Short title of the test cycle. Must not be blank. Max 255 chars."
+  ),
+  description: zod.string().max(65535).optional().describe("Detailed description of the test cycle. Max 65 535 characters."),
+  priority: zod.string().optional().describe(
+    "Priority name (e.g., 'High', 'Medium', 'Low'). Auto-resolved to ID."
+  ),
+  status: zod.string().optional().describe(
+    "Status name (e.g., 'To Do', 'In Progress', 'Done'). Auto-resolved to ID."
+  ),
+  assignee: zod.string().optional().describe("Assignee account ID"),
+  reporter: zod.string().optional().describe("Reporter account ID"),
+  labels: zod.array(zod.string()).optional().describe(
+    "List of label names (e.g., ['Release_1', 'Sprint 1']). Auto-resolved to IDs."
+  ),
+  components: zod.array(zod.string()).optional().describe(
+    "List of component names (e.g., ['UI', 'Cloud']). Auto-resolved to IDs."
+  ),
+  plannedStartDate: zod.string().regex(/^\d{2}\/[A-Za-z]{3}\/\d{4} \d{2}:\d{2}$/).optional().describe(
+    "Planned start date. Format: 'dd/MMM/yyyy HH:mm' e.g. '10/May/2026 00:00'. Must be ≤ plannedEndDate when both are provided."
+  ),
+  plannedEndDate: zod.string().regex(/^\d{2}\/[A-Za-z]{3}\/\d{4} \d{2}:\d{2}$/).optional().describe(
+    "Planned end date. Format: 'dd/MMM/yyyy HH:mm' e.g. '15/May/2026 00:00'. Must be ≥ plannedStartDate when both are provided."
+  )
+});
+const CreateTestCycleResponse = zod.object({
+  id: zod.string().describe(
+    "Opaque permanent identifier of the created test cycle. Use this in all subsequent API calls."
+  ),
+  key: zod.string().describe(
+    "Human-readable project-scoped key in format '<PROJECT_KEY>-TR-<number>'. e.g. 'TRWT-TR-218'."
+  )
+});
+export {
+  CreateTestCycleBody,
+  CreateTestCycleResponse
+};