@smartbear/mcp 0.23.0 → 0.24.0

package/dist/qtm4j/tool/test-cycle/update-test-cycle.js

@@ -0,0 +1,161 @@
+import { Tool } from "../../../common/tools.js";
+import { TOOL_NAMES, ENDPOINTS } from "../../config/constants.js";
+import { ResolverKeys, InputField } from "../../config/field-resolution.types.js";
+import { UpdateTestCycleResponse, UpdateTestCycleBody } from "../../schema/update-test-cycle.schema.js";
+const SIMPLE_FIELD_CONFIG = {
+  [InputField.PRIORITY]: ResolverKeys.CommonAttribute.PRIORITY,
+  [InputField.STATUS]: ResolverKeys.CommonAttribute.TEST_CYCLE_STATUS
+};
+const ADD_DELETE_FIELD_CONFIG = {
+  [InputField.LABELS]: ResolverKeys.SearchableField.LABEL,
+  [InputField.COMPONENTS]: ResolverKeys.SearchableField.COMPONENTS
+};
+async function resolveAddDelete(resolver, inputField, resolverKey, field, context, warnings) {
+  const result = {};
+  for (const op of ["add", "delete"]) {
+    const names = field[op];
+    if (!names?.length) continue;
+    const tempBody = { [inputField]: names };
+    await resolver.resolve(
+      inputField,
+      resolverKey,
+      tempBody,
+      context,
+      warnings
+    );
+    const val = tempBody[inputField];
+    if (Array.isArray(val) && val.length > 0 && typeof val[0] === "number") {
+      result[op] = val;
+    }
+  }
+  return result;
+}
+class UpdateTestCycle extends Tool {
+  specification = {
+    title: TOOL_NAMES.UPDATE_TEST_CYCLE.TITLE,
+    summary: TOOL_NAMES.UPDATE_TEST_CYCLE.SUMMARY,
+    readOnly: false,
+    idempotent: true,
+    inputSchema: UpdateTestCycleBody,
+    outputSchema: UpdateTestCycleResponse,
+    purpose: "Update an existing test cycle in QTM4J by its human-readable key (e.g. 'SCRUM-TR-101'). Only provided fields are changed — omitted fields stay unchanged. Status and priority are auto-resolved from human-readable names. Labels and components use add/delete objects.",
+    useCases: [
+      "Update summary, status, priority, planned dates, assignee, or reporter",
+      "Clear a nullable field by passing null (e.g. description: null removes text, assignee: null unassigns owner)",
+      "Add or remove labels and components atomically without affecting other entries",
+      "Apply multiple field updates in a single call"
+    ],
+    examples: [
+      {
+        description: "Rename a test cycle",
+        parameters: {
+          key: "SCRUM-TR-101",
+          summary: "Regression Cycle - Sprint 12 Updated"
+        },
+        expectedOutput: "Test cycle updated with new summary"
+      },
+      {
+        description: "Change status and update planned dates",
+        parameters: {
+          key: "SCRUM-TR-101",
+          status: "In Progress",
+          plannedStartDate: "01/May/2026 09:00",
+          plannedEndDate: "31/May/2026 18:00"
+        },
+        expectedOutput: "Test cycle status and planned dates updated"
+      },
+      {
+        description: "Add a label and remove an old one",
+        parameters: {
+          key: "SCRUM-TR-101",
+          labels: { add: ["Regression", "Smoke"], delete: ["Sprint1"] }
+        },
+        expectedOutput: "Test cycle updated — Regression and Smoke labels added, Sprint1 removed"
+      },
+      {
+        description: "Clear the description text",
+        parameters: {
+          key: "SCRUM-TR-101",
+          description: null
+        },
+        expectedOutput: "Test cycle description cleared"
+      },
+      {
+        description: "Unassign the owner and clear planned dates",
+        parameters: {
+          key: "SCRUM-TR-101",
+          assignee: null,
+          plannedStartDate: null,
+          plannedEndDate: null
+        },
+        expectedOutput: "Test cycle owner unassigned and planned dates cleared"
+      },
+      {
+        description: "Full update with all fields",
+        parameters: {
+          key: "SCRUM-TR-101",
+          summary: "Final Regression Cycle",
+          description: "Updated for sprint 12.",
+          status: "In Progress",
+          priority: "High",
+          plannedStartDate: "15/May/2026 09:00",
+          plannedEndDate: "30/May/2026 18:00",
+          assignee: "5b10a2844c20165700ede21f",
+          labels: { add: ["Regression"], delete: ["Sprint1"] },
+          components: { add: ["Backend"], delete: ["Frontend"] }
+        },
+        expectedOutput: "Test cycle updated with all specified fields"
+      }
+    ],
+    hints: [
+      "PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project.",
+      "KEY FORMAT: '{PROJECT_KEY}-TR-{number}' — e.g. 'SCRUM-TR-101'.",
+      "Pass explicit null to CLEAR a nullable field — e.g. description: null removes the description text, assignee: null unassigns the owner, plannedStartDate: null removes the date. Omitting a field leaves it unchanged.",
+      "Status and priority are auto-resolved from human-readable names loaded by set_project_context. If a name cannot be resolved, the cycle is still updated and a warning is returned.",
+      "Labels and components use add/delete — names are auto-resolved to IDs. Both operations can be combined in a single call.",
+      "Date format: 'dd/MMM/yyyy HH:mm' e.g. '15/May/2026 09:00'. Month must be capitalised (May not may or MAY).",
+      "Archived test cycles cannot be updated — the server returns 400. Unarchive first if needed."
+    ],
+    outputDescription: "Confirmation object with the test cycle key and updated: true. Warnings are included if any field names could not be resolved."
+  };
+  handle = async (rawArgs) => {
+    const args = UpdateTestCycleBody.parse(rawArgs);
+    const fieldResolver = this.client.getResolverRegistry();
+    const context = fieldResolver.requireProjectContext();
+    const warnings = [];
+    const { key: _key, labels, components, ...scalarArgs } = args;
+    const body = { ...scalarArgs };
+    await Promise.all(
+      Object.entries(SIMPLE_FIELD_CONFIG).map(
+        ([inputField, resolverKey]) => fieldResolver.getResolver(resolverKey).resolve(inputField, resolverKey, body, context, warnings)
+      )
+    );
+    for (const [inputField, resolverKey] of Object.entries(
+      ADD_DELETE_FIELD_CONFIG
+    )) {
+      const field = args[inputField];
+      if (!field) continue;
+      const resolvedField = await resolveAddDelete(
+        fieldResolver.getResolver(resolverKey),
+        inputField,
+        resolverKey,
+        field,
+        context,
+        warnings
+      );
+      if (Object.keys(resolvedField).length > 0)
+        body[inputField] = resolvedField;
+    }
+    await this.client.getApiClient().put(ENDPOINTS.UPDATE_TEST_CYCLE(args.key), body);
+    return {
+      structuredContent: UpdateTestCycleResponse.parse({
+        key: args.key,
+        updated: true
+      }),
+      content: warnings.length > 0 ? [{ type: "text", text: `Note: ${warnings.join(" | ")}` }] : []
+    };
+  };
+}
+export {
+  UpdateTestCycle
+};

package/dist/swagger/client/portal-types.js

@@ -98,7 +98,7 @@ const CreatePortalArgsSchema = z.object({
     "Whether authentication credentials are enabled for accessing the portal. When true, users can authenticate to access private content. Defaults to true"
   ),
   swaggerHubOrganizationId: z.string().describe(
-    "The corresponding SwaggerHub organization UUID - required for portal creation. This links the portal to your SwaggerHub organization"
+    "The corresponding Swagger organization UUID - required for portal creation. This links the portal to your Swagger organization. Only one Portal per Swagger organization is allowed."
   ),
   openapiRenderer: z.string().optional().describe(
     "OpenAPI renderer type: 'SWAGGER_UI' (Swagger UI), 'ELEMENTS' (Stoplight Elements), or 'TOGGLE' (allows switching between both with Elements as default). Defaults to 'TOGGLE'"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",