@provartesting/provardx-cli 1.5.0 → 1.5.2-beta.2

package/lib/mcp/tools/connectionTools.js

@@ -12,6 +12,8 @@ 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 { maskFields, parseFieldsParam } from '../utils/fieldMask.js';
+import { desc } from './descHelper.js';
 // ── Class → human-readable type mapping ──────────────────────────────────────
 const CLASS_TO_TYPE = {
     sf: 'Salesforce',
@@ -34,7 +36,11 @@ const TP_PARSER = new XMLParser({
     ignoreAttributes: false,
     attributeNamePrefix: '@_',
     parseAttributeValue: false,
-    isArray: (name) => name === 'connectionClass' || name === 'connection' || name === 'environment',
+    isArray: (name) => name === 'connectionClass' ||
+        name === 'connection' ||
+        name === 'environment' ||
+        name === 'connectionUrl' ||
+        name === 'association',
 });
 class XmlParseError extends Error {
     code = 'CONNECTION_XML_PARSE_ERROR';
@@ -50,36 +56,71 @@ function parseTestProjectXml(content) {
     const raw = parsed['testProject'];
     return raw !== null && typeof raw === 'object' ? raw : {};
 }
-function parseConnectionList(content) {
-    const tp = parseTestProjectXml(content);
+function buildConnectionMap(tp) {
+    const map = new Map();
     const cc = tp['connectionClasses'];
     if (!cc || typeof cc !== 'object')
-        return [];
+        return map;
     const classesRaw = cc['connectionClass'];
-    if (!classesRaw)
-        return [];
-    const classes = classesRaw;
-    const connections = [];
-    for (const cls of classes) {
+    if (!Array.isArray(classesRaw))
+        return map;
+    for (const cls of classesRaw) {
         const className = cls['@_name'];
         if (!className)
             continue;
-        const connsRaw = cls['connection'];
-        if (!connsRaw)
+        // Real .testproject XML nests each <connection> inside a <connections> wrapper.
+        const connsWrap = cls['connections'];
+        const connsRaw = connsWrap?.['connection'];
+        if (!Array.isArray(connsRaw))
             continue;
         for (const conn of connsRaw) {
-            const connName = conn['@_name'];
-            if (!connName)
+            const id = conn['@_id'];
+            const name = conn['@_name'];
+            if (!name)
                 continue;
-            const url = conn['@_url'];
-            connections.push({
-                name: connName,
-                type: classToType(className),
-                ...(url ? { url } : {}),
-                sso_configured: className === 'sso',
-            });
+            let defaultUrl;
+            const urlsByEnvId = new Map();
+            const urlsWrap = conn['connectionUrls'];
+            const urlsRaw = urlsWrap?.['connectionUrl'];
+            if (Array.isArray(urlsRaw)) {
+                for (const u of urlsRaw) {
+                    const url = u['@_url'];
+                    if (!url)
+                        continue;
+                    const envId = u['@_envId'];
+                    // The base entry (no @_envId) is the connection's default URL;
+                    // entries with @_envId are environment-specific overrides keyed by env GUID.
+                    if (envId)
+                        urlsByEnvId.set(envId, url);
+                    else if (defaultUrl === undefined)
+                        defaultUrl = url;
+                }
+            }
+            const info = { name, className, defaultUrl, urlsByEnvId };
+            if (id)
+                map.set(id, info);
+            // Also key by name so name-based lookups (e.g. legacy callers) still work.
+            map.set(`name:${name}`, info);
         }
     }
+    return map;
+}
+function parseConnectionList(content) {
+    const tp = parseTestProjectXml(content);
+    const map = buildConnectionMap(tp);
+    const connections = [];
+    const seen = new Set();
+    for (const info of map.values()) {
+        if (seen.has(info))
+            continue;
+        seen.add(info);
+        connections.push({
+            name: info.name,
+            type: classToType(info.className),
+            ...(info.defaultUrl ? { url: info.defaultUrl } : {}),
+            sso_configured: info.className === 'sso',
+        });
+    }
     return connections;
 }
 function parseEnvironmentList(content) {
@@ -88,19 +129,38 @@ function parseEnvironmentList(content) {
     if (!envSection || typeof envSection !== 'object')
         return [];
     const envsRaw = envSection['environment'];
-    if (!envsRaw)
+    if (!Array.isArray(envsRaw))
         return [];
+    const connectionMap = buildConnectionMap(tp);
     const environments = [];
     for (const env of envsRaw) {
         const name = env['@_name'];
         if (!name)
             continue;
-        const connection = env['@_connectionName'];
-        const url = env['@_url'];
+        const envGuid = env['@_guid'];
+        let connectionName = '';
+        let envUrl;
+        // associations may be missing, an empty string (no associations), or an object wrapping an array.
+        const assocs = env['associations'];
+        if (assocs !== null && typeof assocs === 'object') {
+            const assocsRaw = assocs['association'];
+            if (Array.isArray(assocsRaw) && assocsRaw.length > 0) {
+                const first = assocsRaw[0];
+                const connId = first['@_connectionId'];
+                if (connId) {
+                    const info = connectionMap.get(connId);
+                    if (info) {
+                        connectionName = info.name;
+                        if (envGuid)
+                            envUrl = info.urlsByEnvId.get(envGuid);
+                    }
+                }
+            }
+        }
         environments.push({
             name,
-            connection: connection ?? '',
-            ...(url ? { url } : {}),
+            connection: connectionName,
+            ...(envUrl ? { url: envUrl } : {}),
         });
     }
     return environments;
@@ -109,19 +169,25 @@ function parseEnvironmentList(content) {
 export function registerConnectionList(server, config) {
     server.registerTool('provar_connection_list', {
         title: 'List Connections',
-        description: [
+        description: desc([
             'List all connections and named environments defined in the .testproject file.',
             'Use this before generating test cases or page objects to get the correct connection names.',
             'Returns connections (name, type, url, sso_configured) and environments (name, connection, url).',
             'Prerequisite: the project must have a .testproject file — run provar_project_validate first if unsure.',
             'Security: only connection names, types, and URLs are returned — credential values from .secrets are never included.',
-        ].join(' '),
+        ].join(' '), 'List connections and environments from the .testproject file.'),
         inputSchema: {
             project_path: z
                 .string()
-                .describe('Absolute or relative path to the Provar project root directory (must be within --allowed-paths)'),
+                .describe(desc('Absolute or relative path to the Provar project root directory (must be within --allowed-paths)', 'string, absolute path to project root')),
+            fields: z
+                .string()
+                .optional()
+                .describe(desc('Comma-separated list of top-level response keys to retain (e.g. "connections,summary"). ' +
+                'Supports dot notation for nested filtering (e.g. "connections.name,connections.type"). ' +
+                'Unknown field names are silently ignored. Omit for full response.', 'string, optional; comma-separated keys to keep (supports dot notation)')),
         },
-    }, ({ project_path }) => {
+    }, ({ project_path, fields }) => {
         const requestId = makeRequestId();
         log('info', 'provar_connection_list', { requestId, project_path });
         try {
@@ -143,7 +209,7 @@ export function registerConnectionList(server, config) {
             }
             const connections = parseConnectionList(content);
             const environments = parseEnvironmentList(content);
-            const result = {
+            let result = {
                 requestId,
                 project_path: resolvedPath,
                 connections,
@@ -153,6 +219,10 @@ export function registerConnectionList(server, config) {
                     environment_count: environments.length,
                 },
             };
+            const fieldList = parseFieldsParam(fields);
+            if (fieldList) {
+                result = maskFields(result, fieldList);
+            }
             return {
                 content: [{ type: 'text', text: JSON.stringify(result) }],
                 structuredContent: result,

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

@@ -1 +1 @@
-{"version":3,"file":"connectionTools.js","sourceRoot":"","sources":["../../../src/mcp/tools/connectionTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,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;AAiB3C,gFAAgF;AAEhF,MAAM,aAAa,GAA2B;IAC5C,EAAE,EAAE,YAAY;IAChB,EAAE,EAAE,KAAK;IACT,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,QAAQ;IACrB,YAAY,EAAE,QAAQ;IACtB,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;AAC/C,CAAC;AAED,iFAAiF;AAEjF,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;IAC9B,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,KAAK;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAW,EAAE,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,aAAa;CAC1G,CAAC,CAAC;AAEH,MAAM,aAAc,SAAQ,KAAK;IACxB,IAAI,GAAG,4BAA4B,CAAC;CAC5C;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;IAC/D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,aAAa,CAAC,qCAAsC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAClC,OAAO,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAE7C,MAAM,UAAU,GAAI,EAA8B,CAAC,iBAAiB,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,UAA4C,CAAC;IAE7D,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAuB,CAAC;QACtD,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,KAAK,MAAM,IAAI,IAAI,QAA0C,EAAE,CAAC;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAuB,CAAC;YACtD,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAuB,CAAC;YAChD,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC;gBAC5B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvB,cAAc,EAAE,SAAS,KAAK,KAAK;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,MAAM,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAE7D,MAAM,OAAO,GAAI,UAAsC,CAAC,aAAa,CAAC,CAAC;IACvE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,YAAY,GAAuB,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,OAAyC,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAuB,CAAC;QACjD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,UAAU,GAAG,GAAG,CAAC,kBAAkB,CAAuB,CAAC;QACjE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAuB,CAAC;QAC/C,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI;YACJ,UAAU,EAAE,UAAU,IAAI,EAAE;YAC5B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAoB;IAC5E,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE;YACX,+EAA+E;YAC/E,4FAA4F;YAC5F,iGAAiG;YACjG,wGAAwG;YACxG,qHAAqH;SACtH,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,WAAW,EAAE;YACX,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CAAC,iGAAiG,CAAC;SAC/G;KACF,EACD,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;QACnB,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,GAAG,CAAC,MAAM,EAAE,wBAAwB,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAChD,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAErD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;YAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,SAAS,CACnB,2BAA2B,EAC3B,kCAAkC,eAAe,uEAAuE,EACxH,SAAS,EACT,KAAK,EACL,EAAE,UAAU,EAAE,4FAA4F,EAAE,CAC7G,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,iBAAiB,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAExD,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,OAAO,EAAE,CAAC;gBACjB,MAAM,GAAG,GAAG,SAAS,CACnB,4BAA4B,EAC5B,gCAAiC,OAAiB,CAAC,OAAO,EAAE,EAC5D,SAAS,EACT,KAAK,CACN,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,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAEnD,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,YAAY,EAAE,YAAY;gBAC1B,WAAW;gBACX,YAAY;gBACZ,OAAO,EAAE;oBACP,gBAAgB,EAAE,WAAW,CAAC,MAAM;oBACpC,iBAAiB,EAAE,YAAY,CAAC,MAAM;iBACvC;aACF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,iBAAiB,EAAE,MAAM;aAC1B,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,KAAK,CAAC,IAAI,IAAI,uBAAuB,EACrF,KAAK,CAAC,OAAO,EACb,SAAS,EACT,KAAK,CACN,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,+BAA+B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,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,0BAA0B,CAAC,MAAiB,EAAE,MAAoB;IAChF,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"connectionTools.js","sourceRoot":"","sources":["../../../src/mcp/tools/connectionTools.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/defectTools.js

@@ -9,6 +9,7 @@ import { z } from 'zod';
 import { makeError, makeRequestId } from '../schemas/common.js';
 import { log } from '../logging/logger.js';
 import { runSfCommand, soqlEscape } from './sfSpawn.js';
+import { desc } from './descHelper.js';
 // ── SF CLI helpers ─────────────────────────────────────────────────────────────
 function runSfArgs(args, sfPath) {
     const { stdout, stderr, exitCode } = runSfCommand(args, sfPath);
@@ -149,26 +150,30 @@ export function createDefectsForRun(runId, targetOrg, failedTestFilter, sfPath)
 export function registerQualityHubDefectCreate(server) {
     server.registerTool('provar_qualityhub_defect_create', {
         title: 'Create Defects',
-        description: [
+        description: desc([
             'Create Defect__c records in Quality Hub for failed test executions in a given run.',
             'Queries the run by Tracking_Id__c, finds failed Test_Execution__c records, creates a',
             'Defect__c per failure (with description, step, browser, environment, tester), and links',
             'it via Test_Case_Defect__c and Test_Execution_Defect__c junction records.',
             'If Jira or ADO sync is configured in Quality Hub, defects sync to those systems automatically.',
-        ].join(' '),
+        ].join(' '), 'Create Defect__c records for failed Quality Hub test executions.'),
         inputSchema: {
-            run_id: z.string().describe('Test run Tracking_Id__c value returned by provar_qualityhub_testrun'),
-            target_org: z.string().describe('SF org alias or username for the Quality Hub org'),
+            run_id: z
+                .string()
+                .describe(desc('Test run Tracking_Id__c value returned by provar_qualityhub_testrun', 'string, tracking ID from qualityhub_testrun')),
+            target_org: z
+                .string()
+                .describe(desc('SF org alias or username for the Quality Hub org', 'string, SF org alias or username')),
             failed_tests: z
                 .array(z.string())
                 .optional()
-                .describe('Optional filter — list of Test_Case__c record ID substrings to restrict defect creation to specific failures'),
+                .describe(desc('Optional filter — list of Test_Case__c record ID substrings to restrict defect creation to specific failures', 'array of strings, optional; filter by TC ID substring')),
             sf_path: z
                 .string()
                 .optional()
-                .describe('Path to the sf CLI executable when not in PATH ' +
+                .describe(desc('Path to the sf CLI executable when not in PATH ' +
                 '(e.g. "C:\\\\Program Files\\\\sf\\\\bin\\\\sf.cmd" for the Windows standalone installer). ' +
-                'Leave unset to use auto-discovery.'),
+                'Leave unset to use auto-discovery.', 'string, optional; path to sf CLI executable')),
         },
     }, ({ run_id, target_org, failed_tests, sf_path }) => {
         const requestId = makeRequestId();

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

@@ -1 +1 @@
-{"version":3,"file":"defectTools.js","sourceRoot":"","sources":["../../../src/mcp/tools/defectTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAiCxD,kFAAkF;AAElF,SAAS,SAAS,CAAC,IAAc,EAAE,MAAe;IAChD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,QAAgB,EAAE,MAAc,EAAE,MAAc;IAC5F,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,OAAO;QACZ,CAAC,CAAC,GAAG,MAAM,0BAA0B,QAAQ,KAAK,OAAO,EAAE;QAC3D,CAAC,CAAC,GAAG,MAAM,0BAA0B,QAAQ,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAiB,EAAE,MAAe;IAChE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAC5C,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,EACvE,MAAM,CACP,CAAC;IACF,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAoB,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,MAAc,EAAE,SAAiB,EAAE,MAAe;IACvF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAC5C,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,EAC3G,MAAM,CACP,CAAC;IACF,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,oBAAoB,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAqB,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,oBAAoB,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,kFAAkF;AAClF,SAAS,QAAQ,CAAC,KAAc,EAAE,MAAM,GAAG,GAAG;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACtF,CAAC;AAYD,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,SAAiB,EACjB,gBAA2B,EAC3B,MAAe;IAEf,iDAAiD;IACjD,MAAM,QAAQ,GAAG,QAAQ,CACvB,oFAAoF,UAAU,CAAC,KAAK,CAAC,GAAG,EACxG,SAAS,EACT,MAAM,CACP,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,6DAA6D,KAAK,GAAG,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5C,qEAAqE;IACrE,MAAM,UAAU,GAAG,QAAQ,CACzB;;kDAE8C,UAAU,CAAC,KAAK,CAAC;aACtD,EACT,SAAS,EACT,MAAM,CACP,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,4BAA4B,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1E,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,gDAAgD;IAChD,MAAM,SAAS,GAAG,QAAQ,CACxB;;sCAEkC,UAAU,CAAC,OAAO,CAAC;sCACnB,EAClC,SAAS,EACT,MAAM,CACP,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;IAC/F,CAAC;IAED,IAAI,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;IAE1C,oGAAoG;IACpG,uEAAuE;IACvE,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,gBAAgB,CAAC,IAAI,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CACtG,CACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC,CAAC;QAExD,8CAA8C;QAC9C,MAAM,SAAS,GAAG,QAAQ,CACxB;;4CAEsC,UAAU,CAAC,WAAW,CAAC;;;eAGpD,EACT,SAAS,EACT,MAAM,CACP,CAAC;QAEF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,EAAE,GAAG,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;QAE5D,MAAM,GAAG,GAAmB;YAC1B,WAAW;YACX,UAAU;YACV,MAAM;YACN,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC;YACxC,MAAM;YACN,UAAU;YACV,UAAU;YACV,OAAO;YACP,OAAO;YACP,cAAc;YACd,WAAW,EAAE,eAAe;SAC7B,CAAC;QAEF,4BAA4B;QAC5B,MAAM,SAAS,GAAG;YAChB,YAAY,GAAG,CAAC,UAAU,IAAI,gCAAgC,EAAE;YAChE,QAAQ,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,UAAU,EAAE;YACxC,YAAY,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE;YACtD,gBAAgB,GAAG,CAAC,WAAW,EAAE;YACjC,WAAW,GAAG,CAAC,MAAM,EAAE;YACvB,sBAAsB,GAAG,CAAC,WAAW,EAAE;YACvC,WAAW,KAAK,EAAE;SACnB;aACE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;aACvC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,MAAM,YAAY,GAChB,qBAAqB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI;YAClD,2BAA2B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI;YACxD,0BAA0B,CAAC;QAE7B,MAAM,QAAQ,GAAG,YAAY,CAAC,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAEpF,4BAA4B;QAC5B,MAAM,cAAc,GAClB,sBAAsB,QAAQ,IAAI;YAClC,yBAAyB,UAAU,GAAG;YACtC,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEtD,MAAM,UAAU,GAAG,YAAY,CAAC,6BAA6B,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAElG,sEAAsE;QACtE,MAAM,gBAAgB,GACpB,sBAAsB,QAAQ,IAAI;YAClC,8BAA8B,WAAW,GAAG;YAC5C,CAAC,eAAe,CAAC,CAAC,CAAC,oCAAoC,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAElF,MAAM,YAAY,GAAG,YAAY,CAAC,kCAAkC,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAE3G,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QAEnF,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,QAAQ,GAAG,gGAAgG,CAAC;IAClH,OAAO;QACL,OAAO;QACP,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM;QACpD,OAAO,EAAE,WAAW,OAAO,CAAC,MAAM,sBAAsB,KAAK,KAAK,QAAQ,EAAE;KAC7E,CAAC;AACJ,CAAC;AAED,kFAAkF;AAElF,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,YAAY,CACjB,iCAAiC,EACjC;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE;YACX,oFAAoF;YACpF,sFAAsF;YACtF,yFAAyF;YACzF,2EAA2E;YAC3E,gGAAgG;SACjG,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;YAClG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACnF,YAAY,EAAE,CAAC;iBACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,8GAA8G,CAC/G;YACH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,iDAAiD;gBAC/C,4FAA4F;gBAC5F,oCAAoC,CACvC;SACJ;KACF,EACD,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;QAChD,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,GAAG,CAAC,MAAM,EAAE,iCAAiC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAElF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YAC9E,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpE,iBAAiB,EAAE,QAAQ;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAgC,CAAC;YAC/C,GAAG,CAAC,OAAO,EAAE,wCAAwC,EAAE;gBACrD,SAAS;gBACT,KAAK,EAAE,KAAK,CAAC,OAAO;aACrB,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,IAAa;gBACtB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,sBAAsB,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;qBACvG;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,8BAA8B,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"defectTools.js","sourceRoot":"","sources":["../../../src/mcp/tools/defectTools.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,5 @@
+/**
+ * Returns `compact` when PROVAR_MCP_SCHEMA_MODE=compact, otherwise `standard`.
+ * Reads the env var on each call so tests can set it without resetting module cache.
+ */
+export declare function desc(standard: string, compact: string): string;

package/lib/mcp/tools/descHelper.js

@@ -0,0 +1,14 @@
+/*
+ * 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
+ */
+/**
+ * Returns `compact` when PROVAR_MCP_SCHEMA_MODE=compact, otherwise `standard`.
+ * Reads the env var on each call so tests can set it without resetting module cache.
+ */
+export function desc(standard, compact) {
+    return process.env['PROVAR_MCP_SCHEMA_MODE'] === 'compact' ? compact : standard;
+}
+//# sourceMappingURL=descHelper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descHelper.js","sourceRoot":"","sources":["../../../src/mcp/tools/descHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,QAAgB,EAAE,OAAe;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClF,CAAC"}

package/lib/mcp/tools/nitroXTools.js

@@ -15,6 +15,7 @@ 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 { desc } from './descHelper.js';
 function isObj(v) {
     return typeof v === 'object' && v !== null && !Array.isArray(v);
 }
@@ -413,29 +414,29 @@ function applyMergePatch(target, patch) {
 export function registerNitroXDiscover(server) {
     server.registerTool('provar_nitrox_discover', {
         title: 'Discover NitroX Components',
-        description: [
+        description: desc([
             'Discover Provar projects containing NitroX (Hybrid Model) page objects.',
             'Scans directories for .testproject marker files, then inventories nitroX/ and nitroXPackages/ directories.',
             "NitroX is Provar's Hybrid Model for locators — component-based page objects for LWC,",
             'Screen Flow, Industry Components, Experience Cloud, and HTML5 components.',
             'Results provide file paths and package info for use with provar_nitrox_read, validate, and generate.',
-        ].join(' '),
+        ].join(' '), 'Discover Provar projects with NitroX Hybrid Model page objects.'),
         inputSchema: {
             search_roots: z
                 .array(z.string())
                 .optional()
-                .describe('Directories to scan (default: cwd; if empty, falls back to ~/git and ~/Provar)'),
+                .describe(desc('Directories to scan (default: cwd; if empty, falls back to ~/git and ~/Provar)', 'array of strings, optional; dirs to scan')),
             max_depth: z
                 .number()
                 .int()
                 .min(1)
                 .max(20)
                 .default(6)
-                .describe('Maximum directory depth for .testproject search'),
+                .describe(desc('Maximum directory depth for .testproject search', 'int 1–20, optional; max scan depth')),
             include_packages: z
                 .boolean()
                 .default(true)
-                .describe('Include nitroXPackages/ package.json metadata in results'),
+                .describe(desc('Include nitroXPackages/ package.json metadata in results', 'bool, optional; include package metadata')),
         },
     }, ({ search_roots, max_depth, include_packages }) => {
         const requestId = makeRequestId();
@@ -508,24 +509,27 @@ export function registerNitroXDiscover(server) {
 export function registerNitroXRead(server, config) {
     server.registerTool('provar_nitrox_read', {
         title: 'Read NitroX Files',
-        description: [
+        description: desc([
             'Read one or more NitroX .po.json (Hybrid Model page object) files and return their parsed content.',
             'Use this to load examples before generating or validating.',
             "Provide file_paths for specific files, or project_path to read all .po.json files from a project's nitroX/ directory.",
-        ].join(' '),
+        ].join(' '), 'Read NitroX .po.json files and return parsed content.'),
         inputSchema: {
-            file_paths: z.array(z.string()).optional().describe('Specific .po.json file paths to read'),
+            file_paths: z
+                .array(z.string())
+                .optional()
+                .describe(desc('Specific .po.json file paths to read', 'array of strings, optional; specific .po.json paths')),
             project_path: z
                 .string()
                 .optional()
-                .describe('Provar project path — reads all .po.json files from nitroX/ directory'),
+                .describe(desc('Provar project path — reads all .po.json files from nitroX/ directory', 'string, optional; project path to read all nitroX files')),
             max_files: z
                 .number()
                 .int()
                 .min(1)
                 .max(100)
                 .default(20)
-                .describe('Maximum number of files to return (prevents context overflow)'),
+                .describe(desc('Maximum number of files to return (prevents context overflow)', 'int 1–100, optional; max files returned')),
         },
     }, ({ file_paths, project_path, max_files }) => {
         const requestId = makeRequestId();
@@ -597,17 +601,23 @@ export function registerNitroXRead(server, config) {
 export function registerNitroXValidate(server, config) {
     server.registerTool('provar_nitrox_validate', {
         title: 'Validate NitroX Component',
-        description: [
+        description: desc([
             'Validate a NitroX .po.json (Hybrid Model component page object) against schema rules.',
             'Works for any NitroX-mapped component type: LWC, Screen Flow, Industry Components, Experience Cloud, HTML5.',
             'Runs two validation passes sequentially: hardcoded semantic rules (NX001–NX010) then JSON schema validation (NX_SCHEMA_* rule IDs).',
             'Schema issues catch structural errors not covered by NX rules: wrong property types, extra properties, enum violations.',
             'Returns a quality score (0–100) and a combined list of issues with rule IDs, severity, and suggestions.',
             'Score formula: 100 − (20 × errors) − (5 × warnings) − (1 × infos).',
-        ].join(' '),
+        ].join(' '), 'Validate a NitroX .po.json against NX001–NX010 and JSON schema rules.'),
         inputSchema: {
-            content: z.string().optional().describe('JSON string of the .po.json content to validate'),
-            file_path: z.string().optional().describe('Path to a .po.json file to validate'),
+            content: z
+                .string()
+                .optional()
+                .describe(desc('JSON string of the .po.json content to validate', 'string, optional; JSON content to validate')),
+            file_path: z
+                .string()
+                .optional()
+                .describe(desc('Path to a .po.json file to validate', 'string, optional; path to .po.json file')),
         },
     }, ({ content, file_path }) => {
         const requestId = makeRequestId();
@@ -670,7 +680,7 @@ const ElementInputSchema = z.object({
 export function registerNitroXGenerate(server, config) {
     server.registerTool('provar_nitrox_generate', {
         title: 'Generate NitroX Components',
-        description: [
+        description: desc([
             'Generate a new NitroX .po.json (Hybrid Model page object) from a component description.',
             "Applicable to any component type supported by Provar's Hybrid Model:",
             'LWC, Screen Flow, Industry Components, Experience Cloud, HTML5.',
@@ -678,18 +688,43 @@ export function registerNitroXGenerate(server, config) {
             'tagName conventions, interaction titles, and attribute patterns from shipped base packages.',
             'All componentId fields are assigned fresh UUIDs. Returns JSON content;',
             'writes to disk only when dry_run=false.',
-        ].join(' '),
+        ].join(' '), 'Generate a NitroX .po.json Hybrid Model page object with fresh UUIDs.'),
         inputSchema: {
-            name: z.string().describe('Path-like component name, e.g. /com/force/myapp/ButtonComponent'),
-            tag_name: z.string().describe('LWC or HTML tag name, e.g. lightning-button or c-my-component'),
-            type: z.enum(['Block', 'Page']).default('Block').describe('Component type'),
-            page_structure_element: z.boolean().default(true).describe('Whether this is a page structure element'),
-            field_details_element: z.boolean().default(false).describe('Whether this is a field details element'),
-            parameters: z.array(ParameterInputSchema).optional().describe('Component parameters/qualifiers'),
-            elements: z.array(ElementInputSchema).optional().describe('Child elements'),
-            output_path: z.string().optional().describe('File path to write (requires dry_run=false)'),
-            overwrite: z.boolean().default(false).describe('Overwrite if output_path already exists'),
-            dry_run: z.boolean().default(true).describe('Return JSON without writing to disk (default)'),
+            name: z
+                .string()
+                .describe(desc('Path-like component name, e.g. /com/force/myapp/ButtonComponent', 'string, path-like component name')),
+            tag_name: z
+                .string()
+                .describe(desc('LWC or HTML tag name, e.g. lightning-button or c-my-component', 'string, LWC or HTML tag name')),
+            type: z.enum(['Block', 'Page']).default('Block').describe(desc('Component type', 'enum Block|Page')),
+            page_structure_element: z
+                .boolean()
+                .default(true)
+                .describe(desc('Whether this is a page structure element', 'bool, optional; default true')),
+            field_details_element: z
+                .boolean()
+                .default(false)
+                .describe(desc('Whether this is a field details element', 'bool, optional; default false')),
+            parameters: z
+                .array(ParameterInputSchema)
+                .optional()
+                .describe(desc('Component parameters/qualifiers', 'array, optional; component parameters')),
+            elements: z
+                .array(ElementInputSchema)
+                .optional()
+                .describe(desc('Child elements', 'array, optional; child elements')),
+            output_path: z
+                .string()
+                .optional()
+                .describe(desc('File path to write (requires dry_run=false)', 'string, optional; output file path')),
+            overwrite: z
+                .boolean()
+                .default(false)
+                .describe(desc('Overwrite if output_path already exists', 'bool, optional; overwrite if exists')),
+            dry_run: z
+                .boolean()
+                .default(true)
+                .describe(desc('Return JSON without writing to disk (default)', 'bool, optional; default true, skip write')),
         },
     }, (input) => {
         const requestId = makeRequestId();
@@ -736,22 +771,27 @@ export function registerNitroXGenerate(server, config) {
 export function registerNitroXPatch(server, config) {
     server.registerTool('provar_nitrox_patch', {
         title: 'Patch NitroX Component',
-        description: [
+        description: desc([
             'Apply a JSON merge-patch (RFC 7396) to an existing NitroX .po.json file.',
             'Reads the file, merges the patch (null values remove keys, other values replace or recurse into objects),',
             'optionally validates the merged result, and writes back.',
             'Use dry_run=true (default) to preview the merged output without writing.',
-        ].join(' '),
+        ].join(' '), 'Apply a JSON merge-patch (RFC 7396) to an existing NitroX .po.json file.'),
         inputSchema: {
-            file_path: z.string().describe('Path to the existing .po.json file to patch'),
+            file_path: z
+                .string()
+                .describe(desc('Path to the existing .po.json file to patch', 'string, absolute path to .po.json file')),
             patch: z
                 .record(z.unknown())
-                .describe('JSON merge-patch to apply (RFC 7396: null removes key, any other value replaces)'),
-            dry_run: z.boolean().default(true).describe('Return merged result without writing to disk (default)'),
+                .describe(desc('JSON merge-patch to apply (RFC 7396: null removes key, any other value replaces)', 'object, RFC 7396 merge-patch')),
+            dry_run: z
+                .boolean()
+                .default(true)
+                .describe(desc('Return merged result without writing to disk (default)', 'bool, optional; default true, skip write')),
             validate_after: z
                 .boolean()
                 .default(true)
-                .describe('Run NX validation on merged result; blocks write if errors found'),
+                .describe(desc('Run NX validation on merged result; blocks write if errors found', 'bool, optional; default true, validate before write')),
         },
     }, ({ file_path, patch, dry_run, validate_after }) => {
         const requestId = makeRequestId();