get_group_status
Check the current status of a registered test group in QIT Manager to monitor testing progress and results.
Instructions
Fetch the status of a registered test group from QIT Manager.
⚠️ QIT CLI not detected. QIT CLI not found. Please install it using one of these methods:
Via Composer (recommended): composer require woocommerce/qit-cli --dev
Set QIT_CLI_PATH environment variable: export QIT_CLI_PATH=/path/to/qit
Ensure 'qit' is available in your system PATH
For more information, visit: https://github.com/woocommerce/qit-cli
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group | Yes | Name of the test group to fetch status for | |
| json | No | Return output in JSON format |
Implementation Reference
- src/tools/groups.ts:15-20 (handler)The handler function implementing the core logic of the 'get_group_status' tool. It builds CLI arguments for the 'group:fetch' command using buildArgs and executes it via executeAndFormat, returning the formatted result.
handler: async (args: { group: string; json?: boolean }) => { const cmdArgs = buildArgs("group:fetch", [args.group], { json: args.json, }); return executeAndFormat(cmdArgs); }, - src/tools/groups.ts:8-14 (schema)Zod schema for input validation: requires 'group' string, optional 'json' boolean.
inputSchema: z.object({ group: z.string().describe("Name of the test group to fetch status for"), json: z .boolean() .optional() .describe("Return output in JSON format"), }), - src/tools/groups.ts:4-22 (registration)Tool definition and registration object 'groupsTools' exporting the 'get_group_status' tool with name, description, inputSchema, and handler.
export const groupsTools = { get_group_status: { name: "get_group_status", description: "Fetch the status of a registered test group from QIT Manager.", inputSchema: z.object({ group: z.string().describe("Name of the test group to fetch status for"), json: z .boolean() .optional() .describe("Return output in JSON format"), }), handler: async (args: { group: string; json?: boolean }) => { const cmdArgs = buildArgs("group:fetch", [args.group], { json: args.json, }); return executeAndFormat(cmdArgs); }, }, }; - src/tools/index.ts:10-18 (registration)Central registration aggregating all tool sets, including groupsTools containing 'get_group_status', into 'allTools'.
export const allTools = { ...authTools, ...testExecutionTools, ...testResultsTools, ...groupsTools, ...environmentTools, ...packagesTools, ...configTools, ...utilitiesTools, - src/server.ts:25-38 (registration)MCP server request handler for listing tools, dynamically generating the tools list from allTools including schemas and descriptions for 'get_group_status'.
server.setRequestHandler(ListToolsRequestSchema, async () => { // Check if QIT CLI is available const cliInfo = detectQitCli(); const tools = Object.entries(allTools).map(([_, tool]) => ({ name: tool.name, description: cliInfo ? tool.description : `${tool.description}\n\n⚠️ QIT CLI not detected. ${getQitCliNotFoundError()}`, inputSchema: zodToJsonSchema(tool.inputSchema), })); return { tools }; });