@provartesting/provardx-cli 1.5.0-dev.2 → 1.5.1

package/lib/mcp/tools/testCaseStepTools.js

@@ -0,0 +1,244 @@
+/*
+ * Copyright (c) 2024 Provar Limited.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.md file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+/* eslint-disable camelcase */
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { XMLParser, XMLBuilder } from 'fast-xml-parser';
+import { assertPathAllowed, PathPolicyError } from '../security/pathPolicy.js';
+import { makeError, makeRequestId } from '../schemas/common.js';
+import { log } from '../logging/logger.js';
+import { validateTestCase } from './testCaseValidate.js';
+import { desc } from './descHelper.js';
+// ── XML parse / build config ──────────────────────────────────────────────────
+const PARSER_OPTIONS = {
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    parseAttributeValue: false,
+    isArray: (tagName) => tagName === 'apiCall',
+};
+const BUILDER_OPTIONS = {
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    format: true,
+    indentBy: '    ',
+    suppressEmptyNode: false,
+};
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function parseTestCaseXml(xmlContent) {
+    const parser = new XMLParser(PARSER_OPTIONS);
+    return parser.parse(xmlContent);
+}
+function buildTestCaseXml(parsed) {
+    const builder = new XMLBuilder(BUILDER_OPTIONS);
+    return '<?xml version="1.0" encoding="UTF-8"?>\n' + builder.build(parsed);
+}
+function getApiCalls(parsed) {
+    const tc = parsed['testCase'];
+    if (!tc || typeof tc !== 'object')
+        return null;
+    const steps = tc['steps'];
+    if (!steps || typeof steps !== 'object')
+        return null;
+    const calls = steps['apiCall'];
+    if (!Array.isArray(calls))
+        return null;
+    return calls;
+}
+function collectAllTestItemIds(parsed) {
+    const calls = getApiCalls(parsed);
+    if (!calls)
+        return [];
+    return calls.map((c) => c['@_testItemId']).filter((id) => typeof id === 'string');
+}
+function parseNewStep(stepXml) {
+    try {
+        const fragParser = new XMLParser(PARSER_OPTIONS);
+        const fragDoc = fragParser.parse(`<root>${stepXml}</root>`);
+        const rootEl = fragDoc['root'];
+        const callEl = rootEl?.['apiCall'];
+        if (!callEl)
+            return { error: 'step_xml must contain exactly one <apiCall> element' };
+        const calls = Array.isArray(callEl) ? callEl : [callEl];
+        if (calls.length !== 1)
+            return { error: 'step_xml must contain exactly one <apiCall> element' };
+        return { step: calls[0] };
+    }
+    catch (e) {
+        return { error: e.message };
+    }
+}
+// ── Tool registration ─────────────────────────────────────────────────────────
+export function registerTestCaseStepEdit(server, config) {
+    server.registerTool('provar_testcase_step_edit', {
+        // PDX-484: carry the AMENDMENT-ONLY contract into the `title:` field.
+        // "Amend" mirrors the AMENDMENT-ONLY framing in the description body
+        // and "Existing" signals that the tool does not construct new test cases.
+        // Length: 29 chars — well within the chip-render comfort threshold.
+        title: 'Amend Existing Test Case Step',
+        description: desc([
+            // ── Usage contract (READ FIRST — PDX-482) ─────────────────────────────
+            // This tool AMENDS an existing validated test case. It is NOT for
+            // constructing a test case from scratch — building one step-by-step via
+            // repeated step_edit calls produces structurally invalid test cases
+            // (dropped scenarios, flat asserts, inconsistent step types — see PDX-479).
+            'AMENDMENT-ONLY tool: this is for amending an existing, already-validated Provar test case (single-step add, attribute fix, debug edit).',
+            'NOT for constructing a test case from scratch — for new test cases use provar_testcase_generate with the FULL steps[] tree in a single call.',
+            'Building a test case step-by-step via repeated step_edit calls after a steps=[] generate produces structurally invalid output (dropped scenarios, flat asserts, inconsistent step types).',
+            // ── Mechanics (unchanged below) ───────────────────────────────────────
+            'Add or remove a single step (apiCall) in a Provar XML test case file.',
+            'Uses write-to-temp-then-rename to minimise partial-write risk.',
+            'Prerequisites: the test case must exist and be valid XML.',
+            'For mode=remove: supply test_item_id of the step to remove.',
+            'For mode=add: supply test_item_id of the anchor step, position (before|after, default after),',
+            'and step_xml (the <apiCall ...>...</apiCall> XML fragment for the new step; must contain exactly one <apiCall>).',
+            'A backup is written to <test_case_path>.bak before any mutation and restored automatically if',
+            'the post-edit validation fails.',
+            'Returns STEP_NOT_FOUND (with all_test_item_ids list) when the target step is absent.',
+            'Returns INVALID_STEP_XML when step_xml cannot be parsed or contains ≠1 <apiCall> elements.',
+            'Returns INVALID_XML_AFTER_EDIT (backup restored) when the mutated file fails validation.',
+            'Grounding for step_xml: call provar_qualityhub_examples_retrieve for corpus examples of the step type you need; if the response has count: 0 with a warning field, fall back: read the provar://docs/step-reference MCP resource.',
+        ].join(' '), 'AMENDMENT-ONLY: add or remove a single apiCall step in an existing Provar test case (not for constructing new ones).'),
+        inputSchema: {
+            test_case_path: z
+                .string()
+                .describe(desc('Absolute path to the .testcase XML file; must be within --allowed-paths', 'string, absolute path to .testcase file')),
+            mode: z
+                .enum(['remove', 'add'])
+                .describe(desc('"remove" to delete a step; "add" to insert a new step', 'enum remove|add')),
+            test_item_id: z
+                .string()
+                .describe(desc('For mode=remove: testItemId of the step to delete. For mode=add: testItemId of the anchor step.', 'string, testItemId of target or anchor step')),
+            position: z
+                .enum(['before', 'after'])
+                .optional()
+                .default('after')
+                .describe(desc('Where to insert relative to the anchor step (mode=add only; default: after)', 'enum before|after; default after')),
+            step_xml: z
+                .string()
+                .optional()
+                .describe(desc('The <apiCall ...>...</apiCall> XML fragment for the new step (mode=add only). Must be well-formed XML.', 'string, optional; <apiCall> XML fragment for new step')),
+            validate_after_edit: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe(desc('Run provar_testcase_validate after the mutation; restores backup on failure (default: true)', 'bool, optional; default true, validate after edit')),
+        },
+    }, (input) => {
+        const requestId = makeRequestId();
+        log('info', 'provar_testcase_step_edit', { requestId, mode: input.mode, test_item_id: input.test_item_id });
+        try {
+            const resolvedPath = path.resolve(input.test_case_path);
+            const bakPath = resolvedPath + '.bak';
+            // Path policy — validate both the target file and its backup path
+            assertPathAllowed(resolvedPath, config.allowedPaths);
+            assertPathAllowed(bakPath, config.allowedPaths);
+            // Validate step_xml up-front before touching the file
+            let newStep = null;
+            if (input.mode === 'add') {
+                if (!input.step_xml) {
+                    const err = makeError('MISSING_INPUT', 'step_xml is required for mode=add', requestId);
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+                const parsed_step = parseNewStep(input.step_xml);
+                if ('error' in parsed_step) {
+                    const err = makeError('INVALID_STEP_XML', `step_xml parse error: ${parsed_step.error}`, requestId);
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+                newStep = parsed_step.step;
+            }
+            // Read the test case file
+            if (!fs.existsSync(resolvedPath)) {
+                const err = makeError('FILE_NOT_FOUND', `Test case not found: ${resolvedPath}`, requestId);
+                return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+            }
+            const original = fs.readFileSync(resolvedPath, 'utf-8');
+            // Parse
+            let parsed;
+            try {
+                parsed = parseTestCaseXml(original);
+            }
+            catch (e) {
+                const err = makeError('INVALID_XML', `Cannot parse test case: ${e.message}`, requestId);
+                return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+            }
+            const apiCalls = getApiCalls(parsed);
+            if (!apiCalls) {
+                const err = makeError('INVALID_XML', 'Test case XML does not contain a <testCase><steps><apiCall> structure', requestId);
+                return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+            }
+            // Find target step
+            const targetIndex = apiCalls.findIndex((c) => String(c['@_testItemId']) === input.test_item_id);
+            if (targetIndex === -1) {
+                const allIds = collectAllTestItemIds(parsed);
+                const err = makeError('STEP_NOT_FOUND', `Step with testItemId "${input.test_item_id}" not found in ${resolvedPath}`, requestId, false, { all_test_item_ids: allIds });
+                return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+            }
+            // Mutate the parsed tree
+            if (input.mode === 'remove') {
+                apiCalls.splice(targetIndex, 1);
+            }
+            else {
+                // mode=add
+                const insertAt = input.position === 'before' ? targetIndex : targetIndex + 1;
+                apiCalls.splice(insertAt, 0, newStep);
+            }
+            // Rebuild XML
+            const mutatedXml = buildTestCaseXml(parsed);
+            // Write backup, then write mutated file via temp→rename to minimise partial-write risk
+            const tmpPath = resolvedPath + '.tmp';
+            fs.writeFileSync(bakPath, original, 'utf-8');
+            fs.writeFileSync(tmpPath, mutatedXml, 'utf-8');
+            fs.renameSync(tmpPath, resolvedPath);
+            // Validate if requested
+            let validation;
+            if (input.validate_after_edit) {
+                try {
+                    validation = validateTestCase(mutatedXml, path.basename(resolvedPath, '.testcase'));
+                }
+                catch {
+                    // treat thrown validation errors as failures
+                    validation = null;
+                }
+                if (!validation || !validation.is_valid) {
+                    // Restore from backup
+                    fs.writeFileSync(resolvedPath, original, 'utf-8');
+                    fs.unlinkSync(bakPath);
+                    const err = makeError('INVALID_XML_AFTER_EDIT', `Validation failed after ${input.mode}; original file restored from backup`, requestId, false, { validation_issues: validation?.issues ?? ['Validation threw an unexpected error'] });
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+            }
+            // Success — delete backup
+            try {
+                fs.unlinkSync(bakPath);
+            }
+            catch {
+                // non-fatal
+            }
+            const result = {
+                requestId,
+                success: true,
+                test_item_id: input.test_item_id,
+                mode: input.mode,
+                ...(input.validate_after_edit && validation ? { validation } : {}),
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+            };
+        }
+        catch (err) {
+            const error = err;
+            const errResult = makeError(error instanceof PathPolicyError ? error.code : 'STEP_EDIT_ERROR', error.message, requestId);
+            log('error', 'provar_testcase_step_edit failed', { requestId, error: error.message });
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify(errResult) }] };
+        }
+    });
+}
+export function registerAllTestCaseStepTools(server, config) {
+    registerTestCaseStepEdit(server, config);
+}
+//# sourceMappingURL=testCaseStepTools.js.map

package/lib/mcp/tools/testCaseStepTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testCaseStepTools.js","sourceRoot":"","sources":["../../../src/mcp/tools/testCaseStepTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,iFAAiF;AAEjF,MAAM,cAAc,GAAG;IACrB,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,KAAK;IAC1B,OAAO,EAAE,CAAC,OAAe,EAAW,EAAE,CAAC,OAAO,KAAK,SAAS;CAC7D,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,MAAM;IAChB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAIF,iFAAiF;AAEjF,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,CAA4B,CAAC;AAC7D,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA+B;IACvD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC,CAAC;IAChD,OAAO,0CAA0C,GAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;AACxF,CAAC;AAED,SAAS,WAAW,CAAC,MAA+B;IAClD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,KAAK,GAAI,EAA8B,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,KAAK,GAAI,KAAiC,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAAC,MAA+B;IAC5D,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,SAAS,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,OAAO,SAAS,CAA4B,CAAC;QACvF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAwC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;QACrF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAwB,CAAC,CAAC,CAAC,CAAC,MAAqB,CAAC,CAAC;QAC1F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;QAChG,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAoB;IAC9E,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,sEAAsE;QACtE,qEAAqE;QACrE,0EAA0E;QAC1E,oEAAoE;QACpE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,IAAI,CACf;YACE,yEAAyE;YACzE,kEAAkE;YAClE,wEAAwE;YACxE,oEAAoE;YACpE,4EAA4E;YAC5E,yIAAyI;YACzI,8IAA8I;YAC9I,2LAA2L;YAC3L,yEAAyE;YACzE,uEAAuE;YACvE,gEAAgE;YAChE,2DAA2D;YAC3D,6DAA6D;YAC7D,+FAA+F;YAC/F,kHAAkH;YAClH,+FAA+F;YAC/F,iCAAiC;YACjC,sFAAsF;YACtF,4FAA4F;YAC5F,0FAA0F;YAC1F,mOAAmO;SACpO,CAAC,IAAI,CAAC,GAAG,CAAC,EACX,sHAAsH,CACvH;QACD,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,CACP,IAAI,CACF,yEAAyE,EACzE,yCAAyC,CAC1C,CACF;YACH,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;iBACvB,QAAQ,CAAC,IAAI,CAAC,uDAAuD,EAAE,iBAAiB,CAAC,CAAC;YAC7F,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CACP,IAAI,CACF,iGAAiG,EACjG,6CAA6C,CAC9C,CACF;YACH,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;iBACzB,QAAQ,EAAE;iBACV,OAAO,CAAC,OAAO,CAAC;iBAChB,QAAQ,CACP,IAAI,CACF,6EAA6E,EAC7E,kCAAkC,CACnC,CACF;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,IAAI,CACF,wGAAwG,EACxG,uDAAuD,CACxD,CACF;YACH,mBAAmB,EAAE,CAAC;iBACnB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CACP,IAAI,CACF,6FAA6F,EAC7F,mDAAmD,CACpD,CACF;SACJ;KACF,EACD,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,GAAG,CAAC,MAAM,EAAE,2BAA2B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAE5G,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;YAEtC,kEAAkE;YAClE,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACrD,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAEhD,sDAAsD;YACtD,IAAI,OAAO,GAAuB,IAAI,CAAC;YACvC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACpB,MAAM,GAAG,GAAG,SAAS,CAAC,eAAe,EAAE,mCAAmC,EAAE,SAAS,CAAC,CAAC;oBACvF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5F,CAAC;gBACD,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACjD,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;oBAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,kBAAkB,EAAE,yBAAyB,WAAW,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;oBACnG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5F,CAAC;gBACD,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC;YAC7B,CAAC;YAED,0BAA0B;YAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,SAAS,CAAC,gBAAgB,EAAE,wBAAwB,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC;gBAC3F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5F,CAAC;YACD,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAExD,QAAQ;YACR,IAAI,MAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,EAAE,2BAA4B,CAAW,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;gBACnG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5F,CAAC;YAED,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,SAAS,CACnB,aAAa,EACb,uEAAuE,EACvE,SAAS,CACV,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5F,CAAC;YAED,mBAAmB;YACnB,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC,CAAC;YAChG,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;gBAC7C,MAAM,GAAG,GAAG,SAAS,CACnB,gBAAgB,EAChB,yBAAyB,KAAK,CAAC,YAAY,kBAAkB,YAAY,EAAE,EAC3E,SAAS,EACT,KAAK,EACL,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAC9B,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5F,CAAC;YAED,yBAAyB;YACzB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,WAAW;gBACX,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;gBAC7E,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAsB,CAAC,CAAC;YACvD,CAAC;YAED,cAAc;YACd,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAE5C,uFAAuF;YACvF,MAAM,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;YACtC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7C,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/C,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAErC,wBAAwB;YACxB,IAAI,UAAkE,CAAC;YACvE,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,UAAU,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;gBACtF,CAAC;gBAAC,MAAM,CAAC;oBACP,6CAA6C;oBAC7C,UAAU,GAAG,IAAI,CAAC;gBACpB,CAAC;gBAED,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;oBACxC,sBAAsB;oBACtB,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAClD,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBACvB,MAAM,GAAG,GAAG,SAAS,CACnB,wBAAwB,EACxB,2BAA2B,KAAK,CAAC,IAAI,sCAAsC,EAC3E,SAAS,EACT,KAAK,EACL,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,sCAAsC,CAAC,EAAE,CACtF,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5F,CAAC;YACH,CAAC;YAED,0BAA0B;YAC1B,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YAED,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,CAAC,mBAAmB,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAgC,CAAC;YAC/C,MAAM,SAAS,GAAG,SAAS,CACzB,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,EACjE,KAAK,CAAC,OAAO,EACb,SAAS,CACV,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,kCAAkC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QAClG,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,MAAoB;IAClF,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/lib/mcp/tools/testCaseValidate.d.ts

@@ -15,6 +15,17 @@ export interface TestCaseValidationResult {
     /** Violations from the Best Practices Engine (same rules as the Quality Hub API). */
     best_practices_violations?: Array<import('./bestPracticesEngine.js').BPViolation>;
     best_practices_rules_evaluated?: number;
+    /** Which ruleset produced this result. Always present. */
+    validation_source: 'quality_hub' | 'local' | 'local_fallback';
+    /** Set when falling back to local — explains why and what to do. */
+    validation_warning?: string;
 }
+/**
+ * Reads a test case file from disk, validates it, and returns the result.
+ * Used by Wave 2 (testCaseGenerate) and Wave 3 (testCaseStepEdit) to validate
+ * after mutations without spawning a separate MCP tool call.
+ * Throws on path-policy violation or missing file.
+ */
+export declare function validateTestCaseXml(filePath: string, config: ServerConfig): TestCaseValidationResult;
 /** Pure function — exported for unit testing */
 export declare function validateTestCase(xmlContent: string, testName?: string): TestCaseValidationResult;