@provartesting/provardx-cli 1.4.6 → 1.5.0-dev

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

@@ -0,0 +1,28 @@
+/// <reference types="node" resolution-mode="require"/>
+import { spawnSync as _spawnSync } from 'node:child_process';
+/**
+ * Thin wrapper around spawnSync so tests can stub sfSpawnHelper.spawnSync.
+ * ESM named exports are immutable bindings; sinon requires a mutable object property.
+ */
+export declare const sfSpawnHelper: {
+    spawnSync: typeof _spawnSync;
+};
+export declare class SfNotFoundError extends Error {
+    readonly code = "SF_NOT_FOUND";
+    constructor();
+}
+export interface SpawnResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Run `sf <args>` synchronously and return stdout, stderr, and exit code.
+ * Throws SfNotFoundError if the `sf` binary is not in PATH.
+ */
+export declare function runSfCommand(args: string[]): SpawnResult;
+/**
+ * Escape a value for safe interpolation inside a SOQL single-quoted string literal.
+ * Replaces `'` with `\'` to prevent SOQL injection.
+ */
+export declare function soqlEscape(value: string): string;

package/lib/mcp/tools/sfSpawn.js

@@ -0,0 +1,50 @@
+/*
+ * 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
+ */
+import { spawnSync as _spawnSync } from 'node:child_process';
+/**
+ * Thin wrapper around spawnSync so tests can stub sfSpawnHelper.spawnSync.
+ * ESM named exports are immutable bindings; sinon requires a mutable object property.
+ */
+export const sfSpawnHelper = {
+    spawnSync: _spawnSync,
+};
+// ── Shared error type ─────────────────────────────────────────────────────────
+export class SfNotFoundError extends Error {
+    code = 'SF_NOT_FOUND';
+    constructor() {
+        super('sf CLI not found in PATH. Install Salesforce CLI (`npm install -g @salesforce/cli`) and ensure it is in your PATH.');
+        this.name = 'SfNotFoundError';
+    }
+}
+/**
+ * Run `sf <args>` synchronously and return stdout, stderr, and exit code.
+ * Throws SfNotFoundError if the `sf` binary is not in PATH.
+ */
+export function runSfCommand(args) {
+    const result = sfSpawnHelper.spawnSync('sf', args, { encoding: 'utf-8', shell: false });
+    if (result.error) {
+        const err = result.error;
+        if (err.code === 'ENOENT') {
+            throw new SfNotFoundError();
+        }
+        throw result.error;
+    }
+    return {
+        stdout: result.stdout ?? '',
+        stderr: result.stderr ?? '',
+        exitCode: result.status ?? 1,
+    };
+}
+// ── SOQL safety ───────────────────────────────────────────────────────────────
+/**
+ * Escape a value for safe interpolation inside a SOQL single-quoted string literal.
+ * Replaces `'` with `\'` to prevent SOQL injection.
+ */
+export function soqlEscape(value) {
+    return value.replace(/'/g, "\\'");
+}
+//# sourceMappingURL=sfSpawn.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sfSpawn.js","sourceRoot":"","sources":["../../../src/mcp/tools/sfSpawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,UAAU;CACtB,CAAC;AAEF,iFAAiF;AAEjF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,IAAI,GAAG,cAAc,CAAC;IACtC;QACE,KAAK,CACH,oHAAoH,CACrH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAUD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAExF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,MAAM,CAAC,KAA8B,CAAC;QAClD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,eAAe,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../server.js';
+export declare function registerTestCaseGenerate(server: McpServer, config: ServerConfig): void;

package/lib/mcp/tools/testCaseGenerate.js

@@ -0,0 +1,221 @@
+/*
+ * 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 { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+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';
+// ── Shorthand → fully-qualified API ID map ────────────────────────────────────
+// Provar runtime requires fully-qualified IDs. Shorthand forms are accepted here
+// and expanded automatically before writing XML.
+const SHORTHAND_TO_FQID = {
+    UiConnect: 'com.provar.plugins.forcedotcom.core.ui.UiConnect',
+    UiDoAction: 'com.provar.plugins.forcedotcom.core.ui.UiDoAction',
+    UiWithScreen: 'com.provar.plugins.forcedotcom.core.ui.UiWithScreen',
+    UiAssert: 'com.provar.plugins.forcedotcom.core.ui.UiAssert',
+    UiNavigate: 'com.provar.plugins.forcedotcom.core.ui.UiNavigate',
+    UiWithRow: 'com.provar.plugins.forcedotcom.core.ui.UiWithRow',
+    UiScrollToElement: 'com.provar.plugins.forcedotcom.core.ui.UiScrollToElement',
+    ApexConnect: 'com.provar.plugins.forcedotcom.core.testapis.ApexConnect',
+    ApexSoqlQuery: 'com.provar.plugins.forcedotcom.core.testapis.ApexSoqlQuery',
+    ApexCreateObject: 'com.provar.plugins.forcedotcom.core.testapis.ApexCreateObject',
+    ApexReadObject: 'com.provar.plugins.forcedotcom.core.testapis.ApexReadObject',
+    ApexUpdateObject: 'com.provar.plugins.forcedotcom.core.testapis.ApexUpdateObject',
+    ApexDeleteObject: 'com.provar.plugins.forcedotcom.core.testapis.ApexDeleteObject',
+    SetValues: 'com.provar.plugins.bundled.apis.control.SetValues',
+    AssertValues: 'com.provar.plugins.bundled.apis.AssertValues',
+    StepGroup: 'com.provar.plugins.bundled.apis.control.StepGroup',
+    Sleep: 'com.provar.plugins.bundled.apis.control.Sleep',
+    ForEach: 'com.provar.plugins.bundled.apis.control.ForEach',
+    CaseCall: 'com.provar.plugins.bundled.apis.control.CaseCall',
+};
+function resolveApiId(apiId) {
+    return SHORTHAND_TO_FQID[apiId] ?? apiId;
+}
+// ── Per-step runtime warnings ─────────────────────────────────────────────────
+function buildStepWarnings(steps) {
+    const warnings = [];
+    const resolvedIds = steps.map((s) => resolveApiId(s.api_id));
+    if (resolvedIds.includes(SHORTHAND_TO_FQID['ApexReadObject'] ?? '')) {
+        warnings.push('ApexReadObject: You must specify field names in the attributes (e.g. fieldList); ' +
+            'if none are provided Provar generates "SELECT  FROM ..." which throws MALFORMED_QUERY. ' +
+            'Prefer ApexSoqlQuery for full control over the SELECT clause and result binding.');
+    }
+    if (resolvedIds.includes(SHORTHAND_TO_FQID['AssertValues'] ?? '')) {
+        warnings.push('AssertValues: Direct index paths like "ResultList[0].FieldName" are NOT supported for ApexSoqlQuery results. ' +
+            'To assert SOQL results use either: (a) a ForEach loop over the result list with AssertValues inside, ' +
+            'or (b) a SetValues step to extract a specific field into a named variable, then assert that variable.');
+    }
+    return warnings;
+}
+// ── Schema ────────────────────────────────────────────────────────────────────
+const StepSchema = z.object({
+    api_id: z
+        .string()
+        .describe('Provar step API ID. Shorthand forms are accepted and auto-expanded to fully-qualified IDs: ' +
+        'UiConnect, UiDoAction, UiWithScreen, UiAssert, UiNavigate, UiWithRow, ' +
+        'ApexConnect, ApexSoqlQuery, ApexCreateObject, ApexReadObject, ApexUpdateObject, ApexDeleteObject, ' +
+        'SetValues, AssertValues, StepGroup, Sleep, ForEach, CaseCall. ' +
+        'Or pass the fully-qualified ID directly (com.provar.plugins.*).'),
+    name: z.string().describe('Human-readable step name'),
+    attributes: z
+        .record(z.string())
+        .default({})
+        .describe('Step argument values as key/value pairs. Written as <arguments><argument id="key"><value .../></argument></arguments> ' +
+        'inside the <apiCall> element — the format Provar runtime requires. ' +
+        'Do NOT rely on XML attributes on <apiCall>; the runtime silently ignores them. ' +
+        'Example: { "connectionName": "MyOrg", "objectApiName": "Opportunity" }'),
+});
+const TOOL_DESCRIPTION = [
+    'Generate a Provar XML test case skeleton with proper UUID v4 guids, sequential testItemId values, and <steps> structure.',
+    'Returns XML content. Writes to disk only when dry_run=false.',
+    'API IDs: shorthand forms (e.g. UiConnect, ApexSoqlQuery) are automatically expanded to fully-qualified IDs required by the Provar runtime.',
+    'Step arguments: attributes are emitted as <arguments><argument id="..."><value .../></argument></arguments> — the only format the Provar runtime processes.',
+    'Shorthand XML attributes on <apiCall> are silently ignored at runtime; always supply arguments via the attributes map.',
+    'Data-driven note: <dataTable> only iterates rows when the test case runs via a test plan instance (.testinstance).',
+    'Running directly via the provardx testCase property resolves all data table variables as null.',
+    'Use provar.testplan.add-instance to wire into a plan for data-driven execution.',
+    'ApexReadObject requires field names in attributes; omitting them produces MALFORMED_QUERY. Prefer ApexSoqlQuery.',
+    'AssertValues on SOQL results: index paths like "ResultList[0].Field" are not supported.',
+    'Use ForEach to iterate the result list, or SetValues to extract a field into a variable first.',
+    'Validation: the response always includes a validation field with is_valid, validity_score, quality_score, and any structural issues — check this before attempting to run the test case.',
+].join(' ');
+export function registerTestCaseGenerate(server, config) {
+    server.tool('provar.testcase.generate', TOOL_DESCRIPTION, {
+        test_case_name: z.string().describe('Test case name (human-readable label)'),
+        test_case_id: z
+            .string()
+            .optional()
+            .describe('Explicit test case id; auto-generated UUID v4 if omitted'),
+        steps: z.array(StepSchema).default([]).describe('Ordered list of test steps'),
+        output_path: z
+            .string()
+            .optional()
+            .describe('Suggested file path for the .xml file (returned in response)'),
+        overwrite: z.boolean().default(false).describe('Overwrite if output_path file already exists'),
+        dry_run: z
+            .boolean()
+            .default(true)
+            .describe('true = return XML only (default); false = write to output_path'),
+        idempotency_key: z
+            .string()
+            .optional()
+            .describe('Caller-provided key echoed back for deduplication tracking'),
+    }, (input) => {
+        const requestId = makeRequestId();
+        log('info', 'provar.testcase.generate', {
+            requestId,
+            test_case_name: input.test_case_name,
+            dry_run: input.dry_run,
+        });
+        try {
+            const xmlContent = buildTestCaseXml(input);
+            const filePath = input.output_path
+                ? path.resolve(input.output_path)
+                : undefined;
+            let written = false;
+            if (filePath && !input.dry_run) {
+                assertPathAllowed(filePath, config.allowedPaths);
+                if (fs.existsSync(filePath) && !input.overwrite) {
+                    const err = makeError('FILE_EXISTS', `File already exists: ${filePath}. Set overwrite=true to replace.`, requestId);
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+                fs.mkdirSync(path.dirname(filePath), { recursive: true });
+                fs.writeFileSync(filePath, xmlContent, 'utf-8');
+                written = true;
+                log('info', 'provar.testcase.generate: wrote file', { requestId, filePath });
+            }
+            const warnings = buildStepWarnings(input.steps);
+            const validationFull = validateTestCase(xmlContent, input.test_case_name);
+            const validationSlim = {
+                is_valid: validationFull.is_valid,
+                validity_score: validationFull.validity_score,
+                quality_score: validationFull.quality_score,
+                error_count: validationFull.error_count,
+                warning_count: validationFull.warning_count,
+                issues: validationFull.issues,
+            };
+            const result = {
+                requestId,
+                xml_content: xmlContent,
+                file_path: filePath,
+                written,
+                dry_run: input.dry_run,
+                step_count: input.steps.length,
+                idempotency_key: input.idempotency_key,
+                validation: validationSlim,
+                ...(warnings.length > 0 ? { warnings } : {}),
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            const error = err;
+            const errResult = makeError(error instanceof PathPolicyError ? error.code : (error.code ?? 'GENERATE_ERROR'), error.message, requestId, false);
+            log('error', 'provar.testcase.generate failed', { requestId, error: error.message });
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify(errResult) }] };
+        }
+    });
+}
+// ── XML builder ───────────────────────────────────────────────────────────────
+function buildArgumentsXml(attributes) {
+    const entries = Object.entries(attributes);
+    if (entries.length === 0)
+        return '';
+    const argLines = entries
+        .map(([k, v]) => `      <argument id="${escapeXmlAttr(k)}">\n` +
+        `        <value class="value" valueClass="String">${escapeXmlContent(v)}</value>\n` +
+        '      </argument>')
+        .join('\n');
+    return `\n      <arguments>\n${argLines}\n      </arguments>\n    `;
+}
+function buildTestCaseXml(input) {
+    const testCaseId = input.test_case_id ?? randomUUID();
+    const testCaseGuid = randomUUID();
+    const registryId = randomUUID();
+    const stepLines = input.steps
+        .map((step, i) => {
+        const guid = randomUUID();
+        const testItemId = i + 1;
+        const resolvedApiId = resolveApiId(step.api_id);
+        const argumentsXml = buildArgumentsXml(step.attributes);
+        if (argumentsXml) {
+            return (`    <apiCall guid="${guid}" apiId="${escapeXmlAttr(resolvedApiId)}"` +
+                ` name="${escapeXmlAttr(step.name)}" testItemId="${testItemId}">${argumentsXml}</apiCall>`);
+        }
+        return (`    <apiCall guid="${guid}" apiId="${escapeXmlAttr(resolvedApiId)}"` +
+            ` name="${escapeXmlAttr(step.name)}" testItemId="${testItemId}"/>`);
+    })
+        .join('\n');
+    return ('<?xml version="1.0" encoding="UTF-8"?>\n' +
+        `<testCase id="${testCaseId}" guid="${testCaseGuid}" registryId="${registryId}"` +
+        ` name="${escapeXmlAttr(input.test_case_name)}">\n` +
+        '  <steps>\n' +
+        (stepLines || '    <!-- TODO: Add test steps here -->') +
+        '\n  </steps>\n' +
+        '</testCase>\n');
+}
+function escapeXmlAttr(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+function escapeXmlContent(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=testCaseGenerate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testCaseGenerate.js","sourceRoot":"","sources":["../../../src/mcp/tools/testCaseGenerate.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../server.js';
+import { type ValidationIssue } from '../schemas/common.js';
+export declare function registerTestCaseValidate(server: McpServer, config: ServerConfig): void;
+export interface TestCaseValidationResult {
+    is_valid: boolean;
+    validity_score: number;
+    quality_score: number;
+    test_case_id: string | null;
+    test_case_name: string | null;
+    step_count: number;
+    error_count: number;
+    warning_count: number;
+    issues: ValidationIssue[];
+    /** 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;
+}
+/** Pure function — exported for unit testing */
+export declare function validateTestCase(xmlContent: string, testName?: string): TestCaseValidationResult;

package/lib/mcp/tools/testCaseValidate.js

@@ -0,0 +1,227 @@
+/*
+ * 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 } 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 { runBestPractices } from './bestPracticesEngine.js';
+export function registerTestCaseValidate(server, config) {
+    server.tool('provar.testcase.validate', 'Validate a Provar XML test case for structural correctness and quality. Checks XML declaration, root element, required attributes (guid UUID v4, testItemId integer), <steps> presence, and applies best-practice rules (same ruleset and scoring as the Quality Hub batch validation API). Returns validity_score (schema compliance) and quality_score (best practices, 0–100).', {
+        content: z.string().optional().describe('XML content to validate directly (alias: xml)'),
+        xml: z.string().optional().describe('XML content to validate — API-compatible alias for content'),
+        file_path: z.string().optional().describe('Path to .xml test case file'),
+    }, ({ content, xml, file_path }) => {
+        const requestId = makeRequestId();
+        log('info', 'provar.testcase.validate', { requestId, has_content: !!content, file_path });
+        try {
+            // Resolve xml alias: the batch validation API uses "xml", MCP originally used "content"
+            let source = content ?? xml;
+            if (!source && file_path) {
+                assertPathAllowed(file_path, config.allowedPaths);
+                const resolved = path.resolve(file_path);
+                if (!fs.existsSync(resolved)) {
+                    const err = makeError('FILE_NOT_FOUND', `File not found: ${resolved}`, requestId);
+                    return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+                }
+                source = fs.readFileSync(resolved, 'utf-8');
+            }
+            if (!source) {
+                const err = makeError('MISSING_INPUT', 'Provide either content or file_path.', requestId);
+                return { isError: true, content: [{ type: 'text', text: JSON.stringify(err) }] };
+            }
+            const validation = validateTestCase(source);
+            const result = { requestId, ...validation };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            const error = err;
+            const errResult = makeError(error instanceof PathPolicyError ? error.code : 'VALIDATE_ERROR', error.message, requestId, false);
+            log('error', 'provar.testcase.validate failed', { requestId, error: error.message });
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify(errResult) }] };
+        }
+    });
+}
+// ── Validator (ported from quality-hub-agents/lambda/src/validator/handler.py) ──
+const UUID_V4_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/** Pure function — exported for unit testing */
+export function validateTestCase(xmlContent, testName) {
+    const issues = [];
+    // TC_001: XML declaration
+    if (!xmlContent.trimStart().startsWith('<?xml')) {
+        issues.push({
+            rule_id: 'TC_001', severity: 'ERROR',
+            message: 'Missing XML declaration. File must start with <?xml version="1.0" encoding="UTF-8"?>.',
+            applies_to: 'document',
+            suggestion: 'Add XML declaration as the first line.',
+        });
+    }
+    // Parse
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        parseAttributeValue: false,
+    });
+    let parsed;
+    try {
+        parsed = parser.parse(xmlContent);
+    }
+    catch (e) {
+        const parseError = e;
+        issues.push({
+            rule_id: 'TC_002', severity: 'ERROR',
+            message: `XML parse error: ${parseError.message}`,
+            applies_to: 'document',
+            suggestion: 'Fix XML syntax errors.',
+        });
+        return finalize(issues, null, null, 0, xmlContent, testName);
+    }
+    // TC_003: Root element
+    if (!('testCase' in parsed)) {
+        issues.push({
+            rule_id: 'TC_003', severity: 'ERROR',
+            message: 'Root element must be <testCase>.',
+            applies_to: 'document',
+            suggestion: 'Ensure root element is <testCase>.',
+        });
+        return finalize(issues, null, null, 0, xmlContent, testName);
+    }
+    const tc = parsed['testCase'];
+    const tcId = tc['@_id'] ?? null;
+    const tcName = tc['@_name'] ?? null;
+    const tcGuid = tc['@_guid'];
+    if (!tcId) {
+        issues.push({
+            rule_id: 'TC_010', severity: 'ERROR',
+            message: 'testCase missing required id attribute.',
+            applies_to: 'testCase',
+            suggestion: 'Add id attribute to testCase element.',
+        });
+    }
+    if (!tcGuid) {
+        issues.push({
+            rule_id: 'TC_011', severity: 'ERROR',
+            message: 'testCase missing required guid attribute.',
+            applies_to: 'testCase',
+            suggestion: 'Add guid attribute (UUID v4) to testCase element.',
+        });
+    }
+    else if (!UUID_V4_RE.test(tcGuid)) {
+        issues.push({
+            rule_id: 'TC_012', severity: 'ERROR',
+            message: `testCase guid "${tcGuid}" is not a valid UUID v4.`,
+            applies_to: 'testCase',
+            suggestion: 'Generate a proper UUID v4 for the guid attribute.',
+        });
+    }
+    // TC_013 (registryId) is intentionally not checked here — registryId is a
+    // Salesforce Quality Hub record ID assigned when a test case is registered in
+    // the QH org. Local project files will never have this attribute, so checking
+    // for it produces a universal false positive for every test case.
+    // TC_020: <steps> element
+    if (!('steps' in tc)) {
+        issues.push({
+            rule_id: 'TC_020', severity: 'ERROR',
+            message: 'testCase missing <steps> element.',
+            applies_to: 'testCase',
+            suggestion: 'Wrap all step elements in a <steps> element.',
+        });
+        return finalize(issues, tcId, tcName, 0, xmlContent, testName);
+    }
+    const steps = tc['steps'];
+    const rawApiCalls = steps['apiCall'];
+    const apiCalls = rawApiCalls
+        ? (Array.isArray(rawApiCalls) ? rawApiCalls : [rawApiCalls])
+        : [];
+    for (const call of apiCalls) {
+        validateApiCall(call, issues);
+    }
+    return finalize(issues, tcId, tcName, apiCalls.length, xmlContent, testName);
+}
+function validateApiCall(call, issues) {
+    const callGuid = call['@_guid'];
+    const apiId = call['@_apiId'];
+    const name = call['@_name'];
+    const testItemId = call['@_testItemId'];
+    const label = apiId ? ` "${apiId}"` : '';
+    if (!callGuid) {
+        issues.push({
+            rule_id: 'TC_030', severity: 'ERROR',
+            message: `apiCall${label} missing guid attribute.`,
+            applies_to: 'apiCall',
+            suggestion: 'Add a UUID v4 guid to each apiCall.',
+        });
+    }
+    else if (!UUID_V4_RE.test(callGuid)) {
+        issues.push({
+            rule_id: 'TC_031', severity: 'ERROR',
+            message: `apiCall${label} guid "${callGuid}" is not a valid UUID v4.`,
+            applies_to: 'apiCall',
+            suggestion: 'Use proper UUID v4 format.',
+        });
+    }
+    if (!apiId) {
+        issues.push({
+            rule_id: 'TC_032', severity: 'ERROR',
+            message: 'apiCall missing apiId attribute.',
+            applies_to: 'apiCall',
+            suggestion: 'Add apiId attribute (e.g., UiConnect, ApexSoqlQuery).',
+        });
+    }
+    if (!name) {
+        issues.push({
+            rule_id: 'TC_033', severity: 'WARNING',
+            message: `apiCall${label} missing name attribute.`,
+            applies_to: 'apiCall',
+            suggestion: 'Add a descriptive name attribute.',
+        });
+    }
+    if (!testItemId) {
+        issues.push({
+            rule_id: 'TC_034', severity: 'ERROR',
+            message: `apiCall${label} missing testItemId attribute.`,
+            applies_to: 'apiCall',
+            suggestion: 'Add sequential testItemId (1, 2, 3...).',
+        });
+    }
+    else if (!/^\d+$/.test(testItemId)) {
+        issues.push({
+            rule_id: 'TC_035', severity: 'ERROR',
+            message: `apiCall${label} testItemId "${testItemId}" must be a whole number.`,
+            applies_to: 'apiCall',
+            suggestion: 'Use sequential integers for testItemId.',
+        });
+    }
+}
+function finalize(issues, testCaseId, testCaseName, stepCount, xmlContent, testName) {
+    const errorCount = issues.filter((i) => i.severity === 'ERROR').length;
+    const warningCount = issues.filter((i) => i.severity === 'WARNING').length;
+    // Layer 1: validity score (schema compliance — existing rules)
+    const validity_score = Math.max(0, 100 - errorCount * 20);
+    // Layer 2: quality score (best practices engine — same rules & formula as Quality Hub API)
+    const bp = runBestPractices(xmlContent, { testName });
+    return {
+        is_valid: errorCount === 0,
+        validity_score,
+        quality_score: bp.quality_score,
+        test_case_id: testCaseId,
+        test_case_name: testCaseName,
+        step_count: stepCount,
+        error_count: errorCount,
+        warning_count: warningCount,
+        issues,
+        best_practices_violations: bp.violations,
+        best_practices_rules_evaluated: bp.rules_evaluated,
+    };
+}
+//# sourceMappingURL=testCaseValidate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testCaseValidate.js","sourceRoot":"","sources":["../../../src/mcp/tools/testCaseValidate.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerConfig } from '../server.js';
+export declare function registerTestPlanAddInstance(server: McpServer, config: ServerConfig): void;
+export declare function registerTestPlanCreateSuite(server: McpServer, config: ServerConfig): void;
+export declare function registerTestPlanRemoveInstance(server: McpServer, config: ServerConfig): void;
+export declare function registerAllTestPlanTools(server: McpServer, config: ServerConfig): void;