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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/README.md +163 -12
  2. package/bin/mcp-start.js +74 -0
  3. package/lib/commands/provar/auth/clear.d.ts +7 -0
  4. package/lib/commands/provar/auth/clear.js +36 -0
  5. package/lib/commands/provar/auth/clear.js.map +1 -0
  6. package/lib/commands/provar/auth/login.d.ts +10 -0
  7. package/lib/commands/provar/auth/login.js +90 -0
  8. package/lib/commands/provar/auth/login.js.map +1 -0
  9. package/lib/commands/provar/auth/rotate.d.ts +7 -0
  10. package/lib/commands/provar/auth/rotate.js +42 -0
  11. package/lib/commands/provar/auth/rotate.js.map +1 -0
  12. package/lib/commands/provar/auth/status.d.ts +7 -0
  13. package/lib/commands/provar/auth/status.js +107 -0
  14. package/lib/commands/provar/auth/status.js.map +1 -0
  15. package/lib/commands/provar/mcp/start.d.ts +2 -0
  16. package/lib/commands/provar/mcp/start.js +14 -1
  17. package/lib/commands/provar/mcp/start.js.map +1 -1
  18. package/lib/mcp/docs/NITROX_CATALOG_SOURCE.json +6 -0
  19. package/lib/mcp/docs/NITROX_COMPONENT_CATALOG.md +2001 -0
  20. package/lib/mcp/docs/PROVAR_TEST_STEP_REFERENCE.md +1430 -0
  21. package/lib/mcp/docs/PROVAR_TOOL_GUIDE.md +175 -0
  22. package/lib/mcp/licensing/algasClient.js +14 -5
  23. package/lib/mcp/licensing/algasClient.js.map +1 -1
  24. package/lib/mcp/licensing/ideDetection.d.ts +0 -12
  25. package/lib/mcp/licensing/ideDetection.js +1 -73
  26. package/lib/mcp/licensing/ideDetection.js.map +1 -1
  27. package/lib/mcp/licensing/licenseCache.js +7 -1
  28. package/lib/mcp/licensing/licenseCache.js.map +1 -1
  29. package/lib/mcp/licensing/licenseValidator.d.ts +3 -3
  30. package/lib/mcp/licensing/licenseValidator.js +11 -4
  31. package/lib/mcp/licensing/licenseValidator.js.map +1 -1
  32. package/lib/mcp/prompts/guidePrompts.d.ts +4 -0
  33. package/lib/mcp/prompts/guidePrompts.js +324 -0
  34. package/lib/mcp/prompts/guidePrompts.js.map +1 -0
  35. package/lib/mcp/prompts/index.d.ts +2 -0
  36. package/lib/mcp/prompts/index.js +23 -0
  37. package/lib/mcp/prompts/index.js.map +1 -0
  38. package/lib/mcp/prompts/loopPrompts.d.ts +6 -0
  39. package/lib/mcp/prompts/loopPrompts.js +435 -0
  40. package/lib/mcp/prompts/loopPrompts.js.map +1 -0
  41. package/lib/mcp/prompts/migrationPrompts.d.ts +4 -0
  42. package/lib/mcp/prompts/migrationPrompts.js +207 -0
  43. package/lib/mcp/prompts/migrationPrompts.js.map +1 -0
  44. package/lib/mcp/rules/provar_best_practices_rules.json +256 -544
  45. package/lib/mcp/security/pathPolicy.d.ts +5 -0
  46. package/lib/mcp/security/pathPolicy.js +58 -3
  47. package/lib/mcp/security/pathPolicy.js.map +1 -1
  48. package/lib/mcp/server.d.ts +17 -0
  49. package/lib/mcp/server.js +151 -6
  50. package/lib/mcp/server.js.map +1 -1
  51. package/lib/mcp/tools/antTools.d.ts +15 -0
  52. package/lib/mcp/tools/antTools.js +347 -170
  53. package/lib/mcp/tools/antTools.js.map +1 -1
  54. package/lib/mcp/tools/automationTools.d.ts +18 -8
  55. package/lib/mcp/tools/automationTools.js +332 -176
  56. package/lib/mcp/tools/automationTools.js.map +1 -1
  57. package/lib/mcp/tools/bestPracticesEngine.js +161 -23
  58. package/lib/mcp/tools/bestPracticesEngine.js.map +1 -1
  59. package/lib/mcp/tools/connectionTools.d.ts +4 -0
  60. package/lib/mcp/tools/connectionTools.js +172 -0
  61. package/lib/mcp/tools/connectionTools.js.map +1 -0
  62. package/lib/mcp/tools/defectTools.d.ts +1 -1
  63. package/lib/mcp/tools/defectTools.js +56 -50
  64. package/lib/mcp/tools/defectTools.js.map +1 -1
  65. package/lib/mcp/tools/hierarchyValidate.d.ts +1 -1
  66. package/lib/mcp/tools/hierarchyValidate.js +127 -42
  67. package/lib/mcp/tools/hierarchyValidate.js.map +1 -1
  68. package/lib/mcp/tools/nitroXTools.d.ts +23 -0
  69. package/lib/mcp/tools/nitroXTools.js +823 -0
  70. package/lib/mcp/tools/nitroXTools.js.map +1 -0
  71. package/lib/mcp/tools/pageObjectGenerate.js +132 -57
  72. package/lib/mcp/tools/pageObjectGenerate.js.map +1 -1
  73. package/lib/mcp/tools/pageObjectValidate.js +136 -46
  74. package/lib/mcp/tools/pageObjectValidate.js.map +1 -1
  75. package/lib/mcp/tools/projectInspect.js +51 -30
  76. package/lib/mcp/tools/projectInspect.js.map +1 -1
  77. package/lib/mcp/tools/projectValidateFromPath.js +70 -49
  78. package/lib/mcp/tools/projectValidateFromPath.js.map +1 -1
  79. package/lib/mcp/tools/propertiesTools.d.ts +2 -0
  80. package/lib/mcp/tools/propertiesTools.js +332 -78
  81. package/lib/mcp/tools/propertiesTools.js.map +1 -1
  82. package/lib/mcp/tools/qualityHubApiTools.d.ts +3 -0
  83. package/lib/mcp/tools/qualityHubApiTools.js +138 -0
  84. package/lib/mcp/tools/qualityHubApiTools.js.map +1 -0
  85. package/lib/mcp/tools/qualityHubTools.js +219 -70
  86. package/lib/mcp/tools/qualityHubTools.js.map +1 -1
  87. package/lib/mcp/tools/rcaTools.d.ts +3 -2
  88. package/lib/mcp/tools/rcaTools.js +189 -56
  89. package/lib/mcp/tools/rcaTools.js.map +1 -1
  90. package/lib/mcp/tools/sfSpawn.d.ts +25 -3
  91. package/lib/mcp/tools/sfSpawn.js +154 -6
  92. package/lib/mcp/tools/sfSpawn.js.map +1 -1
  93. package/lib/mcp/tools/testCaseGenerate.js +226 -78
  94. package/lib/mcp/tools/testCaseGenerate.js.map +1 -1
  95. package/lib/mcp/tools/testCaseStepTools.d.ts +4 -0
  96. package/lib/mcp/tools/testCaseStepTools.js +226 -0
  97. package/lib/mcp/tools/testCaseStepTools.js.map +1 -0
  98. package/lib/mcp/tools/testCaseValidate.d.ts +11 -0
  99. package/lib/mcp/tools/testCaseValidate.js +300 -44
  100. package/lib/mcp/tools/testCaseValidate.js.map +1 -1
  101. package/lib/mcp/tools/testPlanTools.d.ts +1 -0
  102. package/lib/mcp/tools/testPlanTools.js +299 -59
  103. package/lib/mcp/tools/testPlanTools.js.map +1 -1
  104. package/lib/mcp/tools/testPlanValidate.js +56 -18
  105. package/lib/mcp/tools/testPlanValidate.js.map +1 -1
  106. package/lib/mcp/tools/testSuiteValidate.js +37 -11
  107. package/lib/mcp/tools/testSuiteValidate.js.map +1 -1
  108. package/lib/mcp/update/updateChecker.d.ts +14 -0
  109. package/lib/mcp/update/updateChecker.js +228 -0
  110. package/lib/mcp/update/updateChecker.js.map +1 -0
  111. package/lib/services/auth/credentials.d.ts +21 -0
  112. package/lib/services/auth/credentials.js +75 -0
  113. package/lib/services/auth/credentials.js.map +1 -0
  114. package/lib/services/auth/loginFlow.d.ts +68 -0
  115. package/lib/services/auth/loginFlow.js +216 -0
  116. package/lib/services/auth/loginFlow.js.map +1 -0
  117. package/lib/services/projectValidation.d.ts +5 -2
  118. package/lib/services/projectValidation.js +83 -31
  119. package/lib/services/projectValidation.js.map +1 -1
  120. package/lib/services/qualityHub/client.d.ts +161 -0
  121. package/lib/services/qualityHub/client.js +226 -0
  122. package/lib/services/qualityHub/client.js.map +1 -0
  123. package/messages/sf.provar.auth.clear.md +16 -0
  124. package/messages/sf.provar.auth.login.md +31 -0
  125. package/messages/sf.provar.auth.rotate.md +23 -0
  126. package/messages/sf.provar.auth.status.md +16 -0
  127. package/messages/sf.provar.mcp.start.md +83 -48
  128. package/oclif.manifest.json +325 -28
  129. package/package.json +23 -12
@@ -1,71 +1,106 @@
1
1
  # summary
2
+
2
3
  Start a local MCP server for Provar tools over stdio transport.
3
4
 
4
5
  # description
6
+
5
7
  Launches a stateless MCP (Model Context Protocol) server that exposes Provar tools to
6
8
  AI assistants (Claude Desktop, Claude Code, Cursor) via stdio transport. All MCP
7
9
  JSON-RPC communication happens over stdout; all internal logging goes to stderr.
8
10
 
9
11
  Available tools:
10
12
 
11
- Project & inspection:
12
- - provar.project.inspect — inspect project folder inventory
13
- - provar.project.validate validate full project from disk: coverage, quality scores
14
-
15
- Page Object:
16
- - provar.pageobject.generate generate a Java Page Object skeleton
17
- - provar.pageobject.validate — validate Page Object quality and naming
18
-
19
- Test Case:
20
- - provar.testcase.generate — generate an XML test case skeleton
21
- - provar.testcase.validate — validate test case XML (validity + best-practices scores)
22
-
23
- Test Suite / Plan:
24
- - provar.testsuite.validate — validate test suite hierarchy
25
- - provar.testplan.validate validate test plan metadata completeness
26
- - provar.testplan.create-suite create a test suite under a plan
27
- - provar.testplan.add-instance — add a test instance to a plan
28
- - provar.testplan.remove-instance — remove a test instance from a plan
29
-
30
- Properties files:
31
- - provar.properties.read read a Provar properties file
32
- - provar.properties.set set a key in a Provar properties file
33
- - provar.properties.validate validate a properties file structure
34
- - provar.properties.generate generate a properties file skeleton
35
-
36
- Quality Hub (sf provar quality-hub wrappers):
37
- - provar.qualityhub.connect — connect to a Quality Hub org
38
- - provar.qualityhub.display — display connected org info
39
- - provar.qualityhub.testrun — trigger a Quality Hub test run
40
- - provar.qualityhub.testrun.report poll test run status
41
- - provar.qualityhub.testrun.abort abort a running test run
42
- - provar.qualityhub.testcase.retrieveretrieve test case results
43
- - provar.qualityhub.defect.create create defects for failed test executions
44
-
45
- Automation (sf provar automation wrappers):
46
- - provar.automation.setup — set up the Provar Automation runtime
47
- - provar.automation.metadata.downloaddownload Salesforce metadata
48
- - provar.automation.compile compile Provar test assets
49
- - provar.automation.testrun run Provar tests
50
- - provar.automation.config.load load a Provar configuration
51
-
52
- ANT build:
53
- - provar.ant.generate generate an ANT build.xml
54
- - provar.ant.validate validate an ANT build.xml
55
-
56
- Test result analysis:
57
- - provar.testrun.rca — root cause analysis on a test result
58
- - provar.testrun.report.locate locate a test result report
13
+ Project & inspection:
14
+
15
+ - provardx_ping ping the MCP server (health check)
16
+ - provar_project_inspect — inspect project folder inventory
17
+ - provar_project_validate — validate full project from disk: coverage, quality scores
18
+ - provar_connection_list list connections and named environments from the project
19
+
20
+ Page Object:
21
+
22
+ - provar_pageobject_generate — generate a Java Page Object skeleton
23
+ - provar_pageobject_validate — validate Page Object quality and naming
24
+
25
+ Test Case:
26
+
27
+ - provar_testcase_generate generate an XML test case skeleton
28
+ - provar_testcase_validate validate test case XML (validity + best-practices scores)
29
+ - provar_testcase_step_edit atomically add or remove a single step in a test case
30
+
31
+ Test Suite / Plan:
32
+
33
+ - provar_testsuite_validate validate test suite hierarchy
34
+ - provar_testplan_validate validate test plan metadata completeness
35
+ - provar_testplan_create create a new test plan
36
+ - provar_testplan_create-suite create a test suite under a plan
37
+ - provar_testplan_add-instance — add a test instance to a plan
38
+ - provar_testplan_remove-instance remove a test instance from a plan
39
+
40
+ Properties files:
41
+
42
+ - provar_properties_read read a Provar properties file
43
+ - provar_properties_set set a key in a Provar properties file
44
+ - provar_properties_validatevalidate a properties file structure
45
+ - provar_properties_generate generate a properties file skeleton
46
+
47
+ Quality Hub (sf provar quality-hub wrappers):
48
+
49
+ - provar_qualityhub_connectconnect to a Quality Hub org
50
+ - provar_qualityhub_display display connected org info
51
+ - provar_qualityhub_testrun trigger a Quality Hub test run
52
+ - provar_qualityhub_testrun_report poll test run status
53
+ - provar_qualityhub_testrun_abort — abort a running test run
54
+ - provar_qualityhub_testcase_retrieve — retrieve test case results
55
+ - provar_qualityhub_defect_create create defects for failed test executions
56
+ - provar_qualityhub_examples_retrieve retrieve corpus examples for test generation grounding
57
+
58
+ Automation (sf provar automation wrappers):
59
+
60
+ - provar_automation_setup set up the Provar Automation runtime
61
+ - provar_automation_metadata_download — download Salesforce metadata
62
+ - provar_automation_compile — compile Provar test assets
63
+ - provar_automation_testrun — run Provar tests
64
+ - provar_automation_config_load — load a Provar configuration
65
+
66
+ ANT build:
67
+
68
+ - provar_ant_generate — generate an ANT build.xml
69
+ - provar_ant_validate — validate an ANT build.xml
70
+
71
+ Test result analysis:
72
+
73
+ - provar_testrun_rca — root cause analysis on a test result
74
+ - provar_testrun_report_locate — locate a test result report
75
+
76
+ NitroX (Provar NitroX component tools):
77
+
78
+ - provar_nitrox_discover — discover NitroX component metadata
79
+ - provar_nitrox_generate — generate a NitroX component
80
+ - provar_nitrox_patch — patch a NitroX component definition
81
+ - provar_nitrox_read — read a NitroX component definition
82
+ - provar_nitrox_validate — validate a NitroX component
59
83
 
60
84
  For full tool documentation see docs/mcp.md in this repository.
61
85
 
62
86
  # flags.allowed-paths.summary
87
+
63
88
  Allowed base directory paths for file operations. Defaults to current directory.
64
89
 
65
90
  # flags.auto-defects.summary
91
+
66
92
  When enabled, testrun.report suggestions will prompt defect creation on failures.
67
93
 
94
+ # flags.auto-update.summary
95
+
96
+ When enabled, automatically installs the latest version at startup and exits. The MCP client must reconnect to load the new version.
97
+
98
+ # flags.no-update-check.summary
99
+
100
+ Skip the update check at startup. Also controlled by the PROVAR_NO_UPDATE_CHECK environment variable.
101
+
68
102
  # examples
103
+
69
104
  - Start MCP server (accepts stdio connections from Claude Desktop / Cursor):
70
105
  <%= config.bin %> <%= command.id %>
71
106
  - Start with explicit allowed paths:
@@ -1,58 +1,216 @@
1
1
  {
2
2
  "commands": {
3
- "provar:mcp:start": {
3
+ "provar:auth:clear": {
4
4
  "aliases": [],
5
5
  "args": {},
6
- "description": "Launches a stateless MCP (Model Context Protocol) server that exposes Provar tools to\nAI assistants (Claude Desktop, Claude Code, Cursor) via stdio transport. All MCP\nJSON-RPC communication happens over stdout; all internal logging goes to stderr.\n\nAvailable tools:\n\n Project & inspection:\n - provar.project.inspect — inspect project folder inventory\n - provar.project.validate — validate full project from disk: coverage, quality scores\n\n Page Object:\n - provar.pageobject.generate — generate a Java Page Object skeleton\n - provar.pageobject.validate — validate Page Object quality and naming\n\n Test Case:\n - provar.testcase.generate — generate an XML test case skeleton\n - provar.testcase.validate — validate test case XML (validity + best-practices scores)\n\n Test Suite / Plan:\n - provar.testsuite.validate — validate test suite hierarchy\n - provar.testplan.validate — validate test plan metadata completeness\n - provar.testplan.create-suite — create a test suite under a plan\n - provar.testplan.add-instance — add a test instance to a plan\n - provar.testplan.remove-instance — remove a test instance from a plan\n\n Properties files:\n - provar.properties.read — read a Provar properties file\n - provar.properties.set — set a key in a Provar properties file\n - provar.properties.validate — validate a properties file structure\n - provar.properties.generate — generate a properties file skeleton\n\n Quality Hub (sf provar quality-hub wrappers):\n - provar.qualityhub.connect — connect to a Quality Hub org\n - provar.qualityhub.display — display connected org info\n - provar.qualityhub.testrun — trigger a Quality Hub test run\n - provar.qualityhub.testrun.report — poll test run status\n - provar.qualityhub.testrun.abort — abort a running test run\n - provar.qualityhub.testcase.retrieve — retrieve test case results\n - provar.qualityhub.defect.create — create defects for failed test executions\n\n Automation (sf provar automation wrappers):\n - provar.automation.setup — set up the Provar Automation runtime\n - provar.automation.metadata.download — download Salesforce metadata\n - provar.automation.compile — compile Provar test assets\n - provar.automation.testrun — run Provar tests\n - provar.automation.config.load — load a Provar configuration\n\n ANT build:\n - provar.ant.generate — generate an ANT build.xml\n - provar.ant.validate — validate an ANT build.xml\n\n Test result analysis:\n - provar.testrun.rca — root cause analysis on a test result\n - provar.testrun.report.locate — locate a test result report\n\nFor full tool documentation see docs/mcp.md in this repository.",
6
+ "description": "Deletes the API key stored at ~/.provar/credentials.json. After clearing, the\nprovar_testcase_validate MCP tool falls back to local validation (structural rules only,\nno Quality Hub quality scoring).\n\nThe PROVAR_API_KEY environment variable is not affected by this command.",
7
7
  "examples": [
8
- "Start MCP server (accepts stdio connections from Claude Desktop / Cursor):\n<%= config.bin %> <%= command.id %>",
9
- "Start with explicit allowed paths:\n<%= config.bin %> <%= command.id %> --allowed-paths /workspace/provar",
10
- "Allow multiple project directories:\n<%= config.bin %> <%= command.id %> -a /workspace/project-a -a /workspace/project-b"
8
+ "Clear the stored API key:\n<%= config.bin %> <%= command.id %>"
11
9
  ],
12
10
  "flags": {
13
- "allowed-paths": {
14
- "char": "a",
15
- "name": "allowed-paths",
16
- "summary": "Allowed base directory paths for file operations. Defaults to current directory.",
17
- "default": [
18
- "/home/runner/work/provardx-cli/provardx-cli"
19
- ],
11
+ "json": {
12
+ "description": "Format output as json.",
13
+ "helpGroup": "GLOBAL",
14
+ "name": "json",
15
+ "allowNo": false,
16
+ "type": "boolean"
17
+ },
18
+ "flags-dir": {
19
+ "helpGroup": "GLOBAL",
20
+ "name": "flags-dir",
21
+ "summary": "Import flag values from a directory.",
20
22
  "hasDynamicHelp": false,
21
- "multiple": true,
23
+ "multiple": false,
24
+ "type": "option"
25
+ }
26
+ },
27
+ "hasDynamicHelp": false,
28
+ "hiddenAliases": [],
29
+ "id": "provar:auth:clear",
30
+ "pluginAlias": "@provartesting/provardx-cli",
31
+ "pluginName": "@provartesting/provardx-cli",
32
+ "pluginType": "core",
33
+ "strict": true,
34
+ "summary": "Remove the stored Provar API key.",
35
+ "enableJsonFlag": true,
36
+ "isESM": true,
37
+ "relativePath": [
38
+ "lib",
39
+ "commands",
40
+ "provar",
41
+ "auth",
42
+ "clear.js"
43
+ ],
44
+ "aliasPermutations": [],
45
+ "permutations": [
46
+ "provar:auth:clear",
47
+ "auth:provar:clear",
48
+ "auth:clear:provar",
49
+ "provar:clear:auth",
50
+ "clear:provar:auth",
51
+ "clear:auth:provar"
52
+ ]
53
+ },
54
+ "provar:auth:login": {
55
+ "aliases": [],
56
+ "args": {},
57
+ "description": "Opens a browser to the Provar login page. After you authenticate, your API key\nis stored at ~/.provar/credentials.json and used automatically by the Provar MCP\ntools and CI/CD integrations.\n\nThe Cognito session tokens are held in memory only for the duration of the key\nexchange and are then discarded — only the pv*k* API key is written to disk.\n\nRun 'sf provar auth status' after login to confirm the key is configured correctly.\n\nDon't have an account? Request access at:\nhttps://aqqlrlhga7.execute-api.us-east-1.amazonaws.com/dev/auth/request-access",
58
+ "examples": [
59
+ "Log in interactively (opens browser):\n<%= config.bin %> <%= command.id %>",
60
+ "Log in against a staging environment:\n<%= config.bin %> <%= command.id %> --url https://dev.api.example.com"
61
+ ],
62
+ "flags": {
63
+ "json": {
64
+ "description": "Format output as json.",
65
+ "helpGroup": "GLOBAL",
66
+ "name": "json",
67
+ "allowNo": false,
68
+ "type": "boolean"
69
+ },
70
+ "flags-dir": {
71
+ "helpGroup": "GLOBAL",
72
+ "name": "flags-dir",
73
+ "summary": "Import flag values from a directory.",
74
+ "hasDynamicHelp": false,
75
+ "multiple": false,
22
76
  "type": "option"
23
77
  },
24
- "auto-defects": {
25
- "name": "auto-defects",
26
- "summary": "When enabled, testrun.report suggestions will prompt defect creation on failures.",
78
+ "url": {
79
+ "name": "url",
80
+ "required": false,
81
+ "summary": "Override the Quality Hub API base URL (for testing against a non-production environment).",
82
+ "hasDynamicHelp": false,
83
+ "multiple": false,
84
+ "type": "option"
85
+ }
86
+ },
87
+ "hasDynamicHelp": false,
88
+ "hiddenAliases": [],
89
+ "id": "provar:auth:login",
90
+ "pluginAlias": "@provartesting/provardx-cli",
91
+ "pluginName": "@provartesting/provardx-cli",
92
+ "pluginType": "core",
93
+ "strict": true,
94
+ "summary": "Log in to Provar Quality Hub and store your API key.",
95
+ "enableJsonFlag": true,
96
+ "isESM": true,
97
+ "relativePath": [
98
+ "lib",
99
+ "commands",
100
+ "provar",
101
+ "auth",
102
+ "login.js"
103
+ ],
104
+ "aliasPermutations": [],
105
+ "permutations": [
106
+ "provar:auth:login",
107
+ "auth:provar:login",
108
+ "auth:login:provar",
109
+ "provar:login:auth",
110
+ "login:provar:auth",
111
+ "login:auth:provar"
112
+ ]
113
+ },
114
+ "provar:auth:rotate": {
115
+ "aliases": [],
116
+ "args": {},
117
+ "description": "Exchanges your current pv*k* key for a new one in a single atomic operation.\nThe old key is invalidated the moment the new key is issued — there is no window\nwhere both are valid.\n\nThe new key is written to ~/.provar/credentials.json automatically.\n\nUse this command to rotate your key on a regular schedule (every ~90 days) without\ngoing through the browser login flow again.\n\nIf the current key is already expired or revoked, rotation is not possible — run\nsf provar auth login instead to authenticate via browser and get a fresh key.",
118
+ "examples": [
119
+ "Rotate the stored API key:\n<%= config.bin %> <%= command.id %>"
120
+ ],
121
+ "flags": {
122
+ "json": {
123
+ "description": "Format output as json.",
124
+ "helpGroup": "GLOBAL",
125
+ "name": "json",
27
126
  "allowNo": false,
28
127
  "type": "boolean"
128
+ },
129
+ "flags-dir": {
130
+ "helpGroup": "GLOBAL",
131
+ "name": "flags-dir",
132
+ "summary": "Import flag values from a directory.",
133
+ "hasDynamicHelp": false,
134
+ "multiple": false,
135
+ "type": "option"
29
136
  }
30
137
  },
31
138
  "hasDynamicHelp": false,
32
139
  "hiddenAliases": [],
33
- "id": "provar:mcp:start",
140
+ "id": "provar:auth:rotate",
34
141
  "pluginAlias": "@provartesting/provardx-cli",
35
142
  "pluginName": "@provartesting/provardx-cli",
36
143
  "pluginType": "core",
37
144
  "strict": true,
38
- "summary": "Start a local MCP server for Provar tools over stdio transport.",
39
- "enableJsonFlag": false,
145
+ "summary": "Rotate your stored Provar Quality Hub API key.",
146
+ "enableJsonFlag": true,
40
147
  "isESM": true,
41
148
  "relativePath": [
42
149
  "lib",
43
150
  "commands",
44
151
  "provar",
45
- "mcp",
46
- "start.js"
152
+ "auth",
153
+ "rotate.js"
47
154
  ],
48
155
  "aliasPermutations": [],
49
156
  "permutations": [
50
- "provar:mcp:start",
51
- "mcp:provar:start",
52
- "mcp:start:provar",
53
- "provar:start:mcp",
54
- "start:provar:mcp",
55
- "start:mcp:provar"
157
+ "provar:auth:rotate",
158
+ "auth:provar:rotate",
159
+ "auth:rotate:provar",
160
+ "provar:rotate:auth",
161
+ "rotate:provar:auth",
162
+ "rotate:auth:provar"
163
+ ]
164
+ },
165
+ "provar:auth:status": {
166
+ "aliases": [],
167
+ "args": {},
168
+ "description": "Reports where the active API key comes from (environment variable or stored file),\nshows the key prefix and when it was set, and states whether validation will use the\nQuality Hub API or local rules only. The full key is never printed.\n\nIf no key is configured, guidance is shown for logging in or requesting access.",
169
+ "examples": [
170
+ "Check auth status:\n<%= config.bin %> <%= command.id %>"
171
+ ],
172
+ "flags": {
173
+ "json": {
174
+ "description": "Format output as json.",
175
+ "helpGroup": "GLOBAL",
176
+ "name": "json",
177
+ "allowNo": false,
178
+ "type": "boolean"
179
+ },
180
+ "flags-dir": {
181
+ "helpGroup": "GLOBAL",
182
+ "name": "flags-dir",
183
+ "summary": "Import flag values from a directory.",
184
+ "hasDynamicHelp": false,
185
+ "multiple": false,
186
+ "type": "option"
187
+ }
188
+ },
189
+ "hasDynamicHelp": false,
190
+ "hiddenAliases": [],
191
+ "id": "provar:auth:status",
192
+ "pluginAlias": "@provartesting/provardx-cli",
193
+ "pluginName": "@provartesting/provardx-cli",
194
+ "pluginType": "core",
195
+ "strict": true,
196
+ "summary": "Show the current Provar API key configuration status.",
197
+ "enableJsonFlag": true,
198
+ "isESM": true,
199
+ "relativePath": [
200
+ "lib",
201
+ "commands",
202
+ "provar",
203
+ "auth",
204
+ "status.js"
205
+ ],
206
+ "aliasPermutations": [],
207
+ "permutations": [
208
+ "provar:auth:status",
209
+ "auth:provar:status",
210
+ "auth:status:provar",
211
+ "provar:status:auth",
212
+ "status:provar:auth",
213
+ "status:auth:provar"
56
214
  ]
57
215
  },
58
216
  "provar:config:get": {
@@ -70,6 +228,14 @@
70
228
  "allowNo": false,
71
229
  "type": "boolean"
72
230
  },
231
+ "flags-dir": {
232
+ "helpGroup": "GLOBAL",
233
+ "name": "flags-dir",
234
+ "summary": "Import flag values from a directory.",
235
+ "hasDynamicHelp": false,
236
+ "multiple": false,
237
+ "type": "option"
238
+ },
73
239
  "file-path": {
74
240
  "char": "f",
75
241
  "name": "file-path",
@@ -124,6 +290,14 @@
124
290
  "allowNo": false,
125
291
  "type": "boolean"
126
292
  },
293
+ "flags-dir": {
294
+ "helpGroup": "GLOBAL",
295
+ "name": "flags-dir",
296
+ "summary": "Import flag values from a directory.",
297
+ "hasDynamicHelp": false,
298
+ "multiple": false,
299
+ "type": "option"
300
+ },
127
301
  "file-path": {
128
302
  "char": "f",
129
303
  "name": "file-path",
@@ -161,6 +335,81 @@
161
335
  "set:config:provar"
162
336
  ]
163
337
  },
338
+ "provar:mcp:start": {
339
+ "aliases": [],
340
+ "args": {},
341
+ "description": "Launches a stateless MCP (Model Context Protocol) server that exposes Provar tools to\nAI assistants (Claude Desktop, Claude Code, Cursor) via stdio transport. All MCP\nJSON-RPC communication happens over stdout; all internal logging goes to stderr.\n\nAvailable tools:\n\nProject & inspection:\n\n- provardx_ping — ping the MCP server (health check)\n- provar_project_inspect — inspect project folder inventory\n- provar_project_validate — validate full project from disk: coverage, quality scores\n- provar_connection_list — list connections and named environments from the project\n\nPage Object:\n\n- provar_pageobject_generate — generate a Java Page Object skeleton\n- provar_pageobject_validate — validate Page Object quality and naming\n\nTest Case:\n\n- provar_testcase_generate — generate an XML test case skeleton\n- provar_testcase_validate — validate test case XML (validity + best-practices scores)\n- provar_testcase_step_edit — atomically add or remove a single step in a test case\n\nTest Suite / Plan:\n\n- provar_testsuite_validate — validate test suite hierarchy\n- provar_testplan_validate — validate test plan metadata completeness\n- provar_testplan_create — create a new test plan\n- provar_testplan_create-suite — create a test suite under a plan\n- provar_testplan_add-instance — add a test instance to a plan\n- provar_testplan_remove-instance — remove a test instance from a plan\n\nProperties files:\n\n- provar_properties_read — read a Provar properties file\n- provar_properties_set — set a key in a Provar properties file\n- provar_properties_validate — validate a properties file structure\n- provar_properties_generate — generate a properties file skeleton\n\nQuality Hub (sf provar quality-hub wrappers):\n\n- provar_qualityhub_connect — connect to a Quality Hub org\n- provar_qualityhub_display — display connected org info\n- provar_qualityhub_testrun — trigger a Quality Hub test run\n- provar_qualityhub_testrun_report — poll test run status\n- provar_qualityhub_testrun_abort — abort a running test run\n- provar_qualityhub_testcase_retrieve — retrieve test case results\n- provar_qualityhub_defect_create — create defects for failed test executions\n- provar_qualityhub_examples_retrieve — retrieve corpus examples for test generation grounding\n\nAutomation (sf provar automation wrappers):\n\n- provar_automation_setup — set up the Provar Automation runtime\n- provar_automation_metadata_download — download Salesforce metadata\n- provar_automation_compile — compile Provar test assets\n- provar_automation_testrun — run Provar tests\n- provar_automation_config_load — load a Provar configuration\n\nANT build:\n\n- provar_ant_generate — generate an ANT build.xml\n- provar_ant_validate — validate an ANT build.xml\n\nTest result analysis:\n\n- provar_testrun_rca — root cause analysis on a test result\n- provar_testrun_report_locate — locate a test result report\n\nNitroX (Provar NitroX component tools):\n\n- provar_nitrox_discover — discover NitroX component metadata\n- provar_nitrox_generate — generate a NitroX component\n- provar_nitrox_patch — patch a NitroX component definition\n- provar_nitrox_read — read a NitroX component definition\n- provar_nitrox_validate — validate a NitroX component\n\nFor full tool documentation see docs/mcp.md in this repository.",
342
+ "examples": [
343
+ "Start MCP server (accepts stdio connections from Claude Desktop / Cursor):\n<%= config.bin %> <%= command.id %>",
344
+ "Start with explicit allowed paths:\n<%= config.bin %> <%= command.id %> --allowed-paths /workspace/provar",
345
+ "Allow multiple project directories:\n<%= config.bin %> <%= command.id %> -a /workspace/project-a -a /workspace/project-b"
346
+ ],
347
+ "flags": {
348
+ "flags-dir": {
349
+ "helpGroup": "GLOBAL",
350
+ "name": "flags-dir",
351
+ "summary": "Import flag values from a directory.",
352
+ "hasDynamicHelp": false,
353
+ "multiple": false,
354
+ "type": "option"
355
+ },
356
+ "allowed-paths": {
357
+ "char": "a",
358
+ "name": "allowed-paths",
359
+ "summary": "Allowed base directory paths for file operations. Defaults to current directory.",
360
+ "default": [
361
+ "/home/runner/work/provardx-cli/provardx-cli"
362
+ ],
363
+ "hasDynamicHelp": false,
364
+ "multiple": true,
365
+ "type": "option"
366
+ },
367
+ "auto-defects": {
368
+ "name": "auto-defects",
369
+ "summary": "When enabled, testrun.report suggestions will prompt defect creation on failures.",
370
+ "allowNo": false,
371
+ "type": "boolean"
372
+ },
373
+ "auto-update": {
374
+ "name": "auto-update",
375
+ "summary": "When enabled, automatically installs the latest version at startup and exits. The MCP client must reconnect to load the new version.",
376
+ "allowNo": false,
377
+ "type": "boolean"
378
+ },
379
+ "no-update-check": {
380
+ "name": "no-update-check",
381
+ "summary": "Skip the update check at startup. Also controlled by the PROVAR_NO_UPDATE_CHECK environment variable.",
382
+ "allowNo": false,
383
+ "type": "boolean"
384
+ }
385
+ },
386
+ "hasDynamicHelp": false,
387
+ "hiddenAliases": [],
388
+ "id": "provar:mcp:start",
389
+ "pluginAlias": "@provartesting/provardx-cli",
390
+ "pluginName": "@provartesting/provardx-cli",
391
+ "pluginType": "core",
392
+ "strict": true,
393
+ "summary": "Start a local MCP server for Provar tools over stdio transport.",
394
+ "enableJsonFlag": false,
395
+ "isESM": true,
396
+ "relativePath": [
397
+ "lib",
398
+ "commands",
399
+ "provar",
400
+ "mcp",
401
+ "start.js"
402
+ ],
403
+ "aliasPermutations": [],
404
+ "permutations": [
405
+ "provar:mcp:start",
406
+ "mcp:provar:start",
407
+ "mcp:start:provar",
408
+ "provar:start:mcp",
409
+ "start:provar:mcp",
410
+ "start:mcp:provar"
411
+ ]
412
+ },
164
413
  "provar:quality-hub:connect": {
165
414
  "aliases": [
166
415
  "provar:manager:connect"
@@ -368,6 +617,14 @@
368
617
  "allowNo": false,
369
618
  "type": "boolean"
370
619
  },
620
+ "flags-dir": {
621
+ "helpGroup": "GLOBAL",
622
+ "name": "flags-dir",
623
+ "summary": "Import flag values from a directory.",
624
+ "hasDynamicHelp": false,
625
+ "multiple": false,
626
+ "type": "option"
627
+ },
371
628
  "properties-file": {
372
629
  "char": "p",
373
630
  "name": "properties-file",
@@ -445,6 +702,14 @@
445
702
  "name": "json",
446
703
  "allowNo": false,
447
704
  "type": "boolean"
705
+ },
706
+ "flags-dir": {
707
+ "helpGroup": "GLOBAL",
708
+ "name": "flags-dir",
709
+ "summary": "Import flag values from a directory.",
710
+ "hasDynamicHelp": false,
711
+ "multiple": false,
712
+ "type": "option"
448
713
  }
449
714
  },
450
715
  "hasDynamicHelp": false,
@@ -508,6 +773,14 @@
508
773
  "allowNo": false,
509
774
  "type": "boolean"
510
775
  },
776
+ "flags-dir": {
777
+ "helpGroup": "GLOBAL",
778
+ "name": "flags-dir",
779
+ "summary": "Import flag values from a directory.",
780
+ "hasDynamicHelp": false,
781
+ "multiple": false,
782
+ "type": "option"
783
+ },
511
784
  "properties-file": {
512
785
  "char": "p",
513
786
  "name": "properties-file",
@@ -578,6 +851,14 @@
578
851
  "name": "json",
579
852
  "allowNo": false,
580
853
  "type": "boolean"
854
+ },
855
+ "flags-dir": {
856
+ "helpGroup": "GLOBAL",
857
+ "name": "flags-dir",
858
+ "summary": "Import flag values from a directory.",
859
+ "hasDynamicHelp": false,
860
+ "multiple": false,
861
+ "type": "option"
581
862
  }
582
863
  },
583
864
  "hasDynamicHelp": false,
@@ -640,6 +921,14 @@
640
921
  "name": "json",
641
922
  "allowNo": false,
642
923
  "type": "boolean"
924
+ },
925
+ "flags-dir": {
926
+ "helpGroup": "GLOBAL",
927
+ "name": "flags-dir",
928
+ "summary": "Import flag values from a directory.",
929
+ "hasDynamicHelp": false,
930
+ "multiple": false,
931
+ "type": "option"
643
932
  }
644
933
  },
645
934
  "hasDynamicHelp": false,
@@ -706,6 +995,14 @@
706
995
  "allowNo": false,
707
996
  "type": "boolean"
708
997
  },
998
+ "flags-dir": {
999
+ "helpGroup": "GLOBAL",
1000
+ "name": "flags-dir",
1001
+ "summary": "Import flag values from a directory.",
1002
+ "hasDynamicHelp": false,
1003
+ "multiple": false,
1004
+ "type": "option"
1005
+ },
709
1006
  "project-path": {
710
1007
  "char": "p",
711
1008
  "name": "project-path",
@@ -1739,5 +2036,5 @@
1739
2036
  ]
1740
2037
  }
1741
2038
  },
1742
- "version": "1.5.0-dev.2"
2039
+ "version": "1.5.0"
1743
2040
  }