@provartesting/provardx-cli 1.4.6 → 1.5.0-dev

package/README.md

@@ -6,27 +6,58 @@
 
 # What is the ProvarDX CLI?
 
-The Provar DX CLI is a Salesforce CLI plugin for Provar customers who want to automate the execution of tests using Provar Automation, and the reporting of test results and other quality-related metrics to Provar Manager.
+The Provar DX CLI is a Salesforce CLI plugin for Provar customers who want to automate the execution of tests using Provar Automation, and the reporting of test results and other quality-related metrics to Provar Quality Hub.
 
 # Installation, Update, and Uninstall
 
 Install the plugin
+
 ```sh-session
 $ sf plugins install @provartesting/provardx-cli
 ```
 
 Update plugins
+
 ```sh-session
 $ sf plugins update
 ```
 
 Uninstall the plugin
+
 ```sh-session
 $ sf plugins uninstall @provartesting/provardx-cli
 ```
 
+# MCP Server (AI-Assisted Quality)
+
+The Provar DX CLI includes a built-in **Model Context Protocol (MCP) server** that connects AI assistants (Claude Desktop, Claude Code, Cursor) directly to your Provar project. Once connected, an AI agent can inspect your project structure, generate Page Objects and test cases, and validate every level of the test hierarchy with quality scores that match the Provar Quality Hub API.
+
+```sh
+sf provar mcp start --allowed-paths /path/to/your/provar/project
+```
+
+📖 **See [docs/mcp.md](https://github.com/ProvarTesting/provardx-cli/blob/main/docs/mcp.md) for full setup and tool documentation.**
+
+## License Validation
+
+The MCP server verifies your Provar license before accepting any connections. Validation is automatic — no extra flags are required for standard usage.
+
+**How it works:**
+
+1. **Auto-detection** — the server reads `~/Provar/.licenses/*.properties` (the same files written by Provar's IDE plugins). If a valid, activated license is found the server starts immediately.
+2. **Cache** — successful validations are cached at `~/Provar/.licenses/.mcp-license-cache.json` (2 h TTL). Subsequent starts within the TTL window skip the disk scan.
+3. **Grace fallback** — if the IDE license files cannot be found or read and the cache is stale (but ≤ 48 h old), the server starts with a warning on stderr using the cached result so CI pipelines are not broken by transient local file-access issues.
+4. **Fail closed** — if no valid license is detected the command exits with a non-zero exit code and a clear error message.
+
+**`NODE_ENV=test` fast-path:**
+
+When `NODE_ENV=test` the validation step is skipped entirely. This is intended only for the plugin's own unit-test suite.
+
+---
+
 # Commands
 
+- [`sf provar mcp start`](#sf-provar-mcp-start)
 - [`sf provar config get`](#sf-provar-config-get)
 - [`sf provar config set`](#sf-provar-config-set)
 - [`sf provar automation config generate`](#sf-provar-automation-config-generate)
@@ -38,12 +69,90 @@ $ sf plugins uninstall @provartesting/provardx-cli
 - [`sf provar automation project compile`](#sf-provar-automation-project-compile)
 - [`sf provar automation metadata download`](#sf-provar-automation-metadata-download)
 - [`sf provar automation test run`](#sf-provar-automation-test-run)
-- [`sf provar manager connect`](#sf-provar-manager-connect)
-- [`sf provar manager display`](#sf-provar-manager-display)
-- [`sf provar manager open`](#sf-provar-manager-open)
-- [`sf provar manager testcase retrieve`](#sf-provar-manager-testcase-retrieve)
-- [`sf provar manager test run`](#sf-provar-manager-test-run)
-- [`sf provar manager test run report`](#sf-provar-manager-test-run-report)
+- [`sf provar quality-hub connect`](#sf-provar-quality-hub-connect)
+- [`sf provar quality-hub display`](#sf-provar-quality-hub-display)
+- [`sf provar quality-hub open`](#sf-provar-quality-hub-open)
+- [`sf provar quality-hub testcase retrieve`](#sf-provar-quality-hub-testcase-retrieve)
+- [`sf provar quality-hub test run`](#sf-provar-quality-hub-test-run)
+- [`sf provar quality-hub test run report`](#sf-provar-quality-hub-test-run-report)
+- [`sf provar quality-hub test run abort`](#sf-provar-quality-hub-test-run-abort)
+- [`sf provar manager connect`](#sf-provar-manager-connect) _(deprecated — use `sf provar quality-hub connect`)_
+- [`sf provar manager display`](#sf-provar-manager-display) _(deprecated — use `sf provar quality-hub display`)_
+- [`sf provar manager open`](#sf-provar-manager-open) _(deprecated — use `sf provar quality-hub open`)_
+- [`sf provar manager testcase retrieve`](#sf-provar-manager-testcase-retrieve) _(deprecated — use `sf provar quality-hub testcase retrieve`)_
+- [`sf provar manager test run`](#sf-provar-manager-test-run) _(deprecated — use `sf provar quality-hub test run`)_
+- [`sf provar manager test run report`](#sf-provar-manager-test-run-report) _(deprecated — use `sf provar quality-hub test run report`)_
+- [`sf provar manager test run abort`](#sf-provar-manager-test-run-abort) _(deprecated — use `sf provar quality-hub test run abort`)_
+
+## `sf provar mcp start`
+
+Start a local MCP server for Provar tools over stdio transport.
+
+```
+USAGE
+  $ sf provar mcp start [-a <value>...]
+
+FLAGS
+  -a, --allowed-paths=<value>...  Allowed base directory paths for file operations.
+                                  Defaults to the current working directory.
+                                  Repeat the flag to allow multiple paths.
+
+DESCRIPTION
+  Launches a stateless MCP (Model Context Protocol) server that exposes Provar tools
+  to AI assistants (Claude Desktop, Claude Code, Cursor) via stdio transport. All MCP
+  JSON-RPC communication happens over stdout; all internal logging goes to stderr.
+
+  Note: --json is not available on this command — stdout is reserved for MCP traffic.
+
+TOOLS EXPOSED
+  provardx.ping                        — sanity-check: echo back a message
+  provar.project.inspect               — inspect project folder inventory
+  provar.pageobject.generate           — generate Java Page Object skeleton
+  provar.pageobject.validate           — validate Page Object quality (30+ rules)
+  provar.testcase.generate             — generate XML test case skeleton
+  provar.testcase.validate             — validate test case XML (validity + best-practices scores)
+  provar.testsuite.validate            — validate test suite hierarchy
+  provar.testplan.validate             — validate test plan with metadata completeness checks
+  provar.project.validate              — validate full project: cross-cutting rules, connections, environments
+  provar.properties.generate           — generate provardx-properties.json from the standard template
+  provar.properties.read               — read and parse a provardx-properties.json file
+  provar.properties.set                — update fields in a provardx-properties.json file
+  provar.properties.validate           — validate a provardx-properties.json file against the schema
+  provar.ant.generate                  — generate an ANT build.xml for CI/CD pipeline execution
+  provar.ant.validate                  — validate an ANT build.xml for structural correctness
+  provar.qualityhub.connect            — connect to a Quality Hub org
+  provar.qualityhub.display            — display connected Quality Hub org info
+  provar.qualityhub.testrun            — trigger a Quality Hub test run
+  provar.qualityhub.testrun.report     — poll test run status
+  provar.qualityhub.testrun.abort      — abort an in-progress test run
+  provar.qualityhub.testcase.retrieve  — retrieve test cases by user story / component
+  provar.automation.setup              — detect or download/install Provar Automation binaries
+  provar.automation.testrun            — trigger a Provar Automation test run (LOCAL)
+  provar.automation.compile            — compile Page Objects after changes
+  provar.automation.config.load        — register a provardx-properties.json as the active config (required before compile/testrun)
+  provar.automation.metadata.download  — download Salesforce metadata into the project
+  provar.qualityhub.defect.create      — create Quality Hub defects from failed test executions
+  provar.testrun.report.locate         — resolve artifact paths (JUnit.xml, HTML reports) for a completed test run
+  provar.testrun.rca                   — analyse a completed test run: classify failures, extract page objects, detect pre-existing issues
+  provar.testplan.add-instance         — wire a test case into a plan suite by writing a .testinstance file
+  provar.testplan.create-suite         — create a new test suite directory with .planitem inside a plan
+  provar.testplan.remove-instance      — remove a .testinstance file from a plan suite
+
+EXAMPLES
+  Start MCP server (accepts stdio connections from Claude Desktop / Cursor):
+
+    $ sf provar mcp start
+
+  Start with an explicit allowed path:
+
+    $ sf provar mcp start --allowed-paths /workspace/provar
+
+  Allow multiple directories:
+
+    $ sf provar mcp start -a /workspace/project-a -a /workspace/project-b
+```
+
+📖 **Full tool documentation and client configuration: [docs/mcp.md](https://github.com/ProvarTesting/provardx-cli/blob/main/docs/mcp.md)**
 
 ## `sf provar config get`
 
@@ -162,7 +271,7 @@ DESCRIPTION
 
 EXAMPLES
   Check if the loaded properties file has all the required properties set:
-  
+
     $ sf provar automation config validate
 ```
 
@@ -300,6 +409,153 @@ EXAMPLES
     $ sf provar automation test run
 ```
 
+## `sf provar quality-hub connect`
+
+Connect to a Provar Quality Hub org.
+
+```
+USAGE
+  $ sf provar quality-hub connect -o <value> [--json]
+
+FLAGS
+  -o, --target-org=<value>  (required) Username or alias set in the SF CLI which corresponds to the Provar Quality Hub org.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Load the alias or username to be used in subsequent Quality Hub commands.
+
+EXAMPLES
+  Connect to the Quality Hub org stored with alias "ProvarQualityHub":
+
+    $ sf provar quality-hub connect -o ProvarQualityHub
+```
+
+## `sf provar quality-hub display`
+
+Display information about the connected Provar Quality Hub org.
+
+```
+USAGE
+  $ sf provar quality-hub display [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+EXAMPLES
+  Display information about the connected Quality Hub org:
+
+    $ sf provar quality-hub display
+```
+
+## `sf provar quality-hub open`
+
+Open Provar Quality Hub in a browser.
+
+```
+USAGE
+  $ sf provar quality-hub open [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+EXAMPLES
+  Open Quality Hub in a browser:
+
+    $ sf provar quality-hub open
+```
+
+## `sf provar quality-hub testcase retrieve`
+
+Retrieve test cases related to the provided user stories or metadata components.
+
+```
+USAGE
+  $ sf provar quality-hub testcase retrieve -p <value> -t Apex|ProvarAutomation [--json] [-m <value>] [-f <value>] [-i <value>] [-o <value>] [-n <value>] [-l <value>]
+
+FLAGS
+  -f, --metadata-file=<value>          Path to a text file containing the list of metadata components.
+  -i, --issues=<value>                 Comma-separated list of issue IDs or keys.
+  -l, --test-plan=<value>              Test Plan name. Use to retrieve test instance file paths.
+  -m, --metadata-components=<value>    Semicolon-separated list of metadata components.
+  -n, --ignore-metadata=<value>        Semicolon-separated list of metadata types to ignore.
+  -o, --output=<value>                 Output to a specific file instead of stdout.
+  -p, --test-project=<value>           (required) Test Project key to filter by.
+  -t, --test-automation-tool=<option>  (required) <options: Apex|ProvarAutomation>
+
+EXAMPLES
+  Retrieve Provar Automation test cases for user story "TM-766":
+
+    $ sf provar quality-hub testcase retrieve -p PAT -t ProvarAutomation -i "TM-766" --json
+```
+
+## `sf provar quality-hub test run`
+
+Run tests via Provar Quality Hub.
+
+```
+USAGE
+  $ sf provar quality-hub test run -f <value> [--json] [-y] [-w <value>] [-p <value>] [-o <value>] [-r <value>]
+
+FLAGS
+  -f, --configuration-file=<value>  (required) Path to the configuration file.
+  -o, --output=<value>              Output to a specific file instead of stdout.
+  -p, --polling-interval=<value>    [default: 60] Polling interval in seconds.
+  -r, --result-format=<value>       [default: human] Format of the test results.
+  -w, --wait=<value>                Polling timeout in minutes.
+  -y, --synchronous                 Run synchronously.
+
+EXAMPLES
+  Run tests and store results as JSON:
+
+    $ sf provar quality-hub test run -f config/run-grid-tests.json -w 10 -p 30 -r json -o results.json
+```
+
+## `sf provar quality-hub test run report`
+
+Check or poll for the status of a Quality Hub test run.
+
+```
+USAGE
+  $ sf provar quality-hub test run report -i <value> [--json] [-r <value>] [-o <value>]
+
+FLAGS
+  -i, --test-run=<value>       (required) Test run ID.
+  -o, --output=<value>         Output to a specific file instead of stdout.
+  -r, --result-format=<value>  [default: human] Format of the test results.
+
+EXAMPLES
+  Retrieve results for a test run:
+
+    $ sf provar quality-hub test run report -i 45f70417-df21-4917-a667-abc2ee46dc63 -r json -o results.json
+```
+
+## `sf provar quality-hub test run abort`
+
+Abort an in-progress test run triggered via Provar Quality Hub.
+
+```
+USAGE
+  $ sf provar quality-hub test run abort -i <value> [--json] [-p <value>] [-w <value>]
+
+FLAGS
+  -i, --test-run=<value>          (required) Test run ID.
+  -p, --polling-interval=<value>  [default: 30] Polling interval in seconds.
+  -w, --wait=<value>              [default: 2] Polling timeout in minutes.
+
+EXAMPLES
+  Abort a test run:
+
+    $ sf provar quality-hub test run abort -i 45f70417-df21-4917-a667-abc2ee46dc63
+```
+
+---
+
+> **Deprecated commands:** The `sf provar manager *` commands below are retained for backwards compatibility and will print a deprecation warning when used. Use the equivalent `sf provar quality-hub *` commands above for all new pipelines.
+
+---
+
 ## `sf provar manager connect`
 
 Load the alias or username to be used in subsequent commands to connect to Provar Manager.
@@ -467,3 +723,31 @@ EXAMPLES
     $ sf provar manager test run report -i 45f70417-df21-4917-a667-abc2ee46dc63 -r junit -o junit-results.xml
 
 ```
+
+## `sf provar manager test run abort`
+
+Abort an in-progress test run triggered via Provar Manager.
+
+```
+USAGE
+  $ sf provar manager test run abort -i <value> [--json] [-p <value>] [-w <value>]
+
+FLAGS
+  -i, --test-run=<value>          (required) Test run ID.
+  -p, --polling-interval=<value>  [default: 30] Sets the polling interval in
+                                  seconds. Default is 30 seconds.
+  -w, --wait=<value>              [default: 2] Sets the polling timeout in
+                                  minutes. Default is 2 minutes.
+
+GLOBAL FLAGS
+  --json               Format output as json.
+
+DESCRIPTION
+  Abort an in-progress test run triggered via Provar Manager.
+
+EXAMPLES
+  Abort test run with ID 45f70417-df21-4917-a667-abc2ee46dc63
+
+    $ sf provar manager test run abort -i 45f70417-df21-4917-a667-abc2ee46dc63
+
+```

package/lib/commands/provar/automation/config/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../../src/commands/provar/automation/config/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAE,YAAY,EAAyB,cAAc,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAE7I;;;;GAIG;AAEH,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,6BAA6B,EAAE,2BAA2B,CAAC,CAAC;AAEnG,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,SAAgC;IAC3E,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3D,YAAY,GAAiB,IAAI,YAAY,EAAE,CAAC;IAEjD,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC3D,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3E,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;QAEvC,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../../src/commands/provar/automation/config/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAyB,cAAc,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAE7I;;;;GAIG;AAEH,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,6BAA6B,EAAE,2BAA2B,CAAC,CAAC;AAEnG,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,SAAgC;IAC3E,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3D,YAAY,GAAiB,IAAI,YAAY,EAAE,CAAC;IAEjD,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC3D,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3E,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;QAEvC,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC"}

package/lib/commands/provar/automation/project/validate.d.ts

@@ -0,0 +1,14 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type ProjectValidationResult } from '../../../../services/projectValidation.js';
+export default class SfProvarAutomationProjectValidate extends SfCommand<ProjectValidationResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'project-path': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'quality-threshold': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'save-results': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'results-dir': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<ProjectValidationResult>;
+}

package/lib/commands/provar/automation/project/validate.js

@@ -0,0 +1,69 @@
+/*
+ * 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 { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { validateProjectFromPath, ProjectValidationError } from '../../../../services/projectValidation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@provartesting/provardx-cli', 'sf.provar.automation.project.validate');
+export default class SfProvarAutomationProjectValidate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'project-path': Flags.string({
+            char: 'p',
+            summary: messages.getMessage('flags.project-path.summary'),
+            default: process.cwd(),
+        }),
+        'quality-threshold': Flags.integer({
+            char: 'q',
+            summary: messages.getMessage('flags.quality-threshold.summary'),
+            default: 80,
+            min: 0,
+            max: 100,
+        }),
+        'save-results': Flags.boolean({
+            summary: messages.getMessage('flags.save-results.summary'),
+            default: true,
+            allowNo: true,
+        }),
+        'results-dir': Flags.string({
+            char: 'd',
+            summary: messages.getMessage('flags.results-dir.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SfProvarAutomationProjectValidate);
+        try {
+            const result = validateProjectFromPath({
+                project_path: flags['project-path'],
+                quality_threshold: flags['quality-threshold'],
+                save_results: flags['save-results'],
+                results_dir: flags['results-dir'],
+            });
+            if (!this.jsonEnabled()) {
+                this.log(messages.getMessage('success_message', [result.project_name, result.quality_score, result.quality_grade]));
+                if (result.saved_to) {
+                    this.log(messages.getMessage('saved_to_message', [result.saved_to]));
+                }
+            }
+            const threshold = flags['quality-threshold'];
+            if (result.quality_score < threshold) {
+                this.error(`Quality score ${result.quality_score}/100 is below the required threshold of ${threshold}/100`, { exit: 1 });
+            }
+            return result;
+        }
+        catch (err) {
+            if (err instanceof ProjectValidationError) {
+                this.error(err.message, { exit: 1 });
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/lib/commands/provar/automation/project/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../../src/commands/provar/automation/project/validate.ts"],"names":[],"mappings":"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"}

package/lib/commands/provar/mcp/start.d.ts

@@ -0,0 +1,16 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export default class SfProvarMcpStart extends SfCommand<void> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    /**
+     * Disable --json flag entirely: stdout is reserved for MCP JSON-RPC messages
+     * and must not be contaminated by oclif JSON output.
+     */
+    static enableJsonFlag: boolean;
+    static readonly flags: {
+        'allowed-paths': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'auto-defects': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/provar/mcp/start.js

@@ -0,0 +1,62 @@
+/*
+ * 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 { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages } from '@provartesting/provardx-plugins-utils';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createProvarMcpServer } from '../../../mcp/server.js';
+import { validateLicense, LicenseError } from '../../../mcp/licensing/index.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@provartesting/provardx-cli', 'sf.provar.mcp.start');
+export default class SfProvarMcpStart extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    /**
+     * Disable --json flag entirely: stdout is reserved for MCP JSON-RPC messages
+     * and must not be contaminated by oclif JSON output.
+     */
+    static enableJsonFlag = false;
+    static flags = {
+        'allowed-paths': Flags.string({
+            summary: messages.getMessage('flags.allowed-paths.summary'),
+            char: 'a',
+            multiple: true,
+            default: [process.cwd()],
+        }),
+        'auto-defects': Flags.boolean({
+            summary: messages.getMessage('flags.auto-defects.summary'),
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SfProvarMcpStart);
+        const allowedPaths = flags['allowed-paths'];
+        if (flags['auto-defects']) {
+            process.env['PROVAR_AUTO_DEFECTS'] = '1';
+        }
+        // Validate that a Provar Automation IDE license is activated on this machine
+        // before handing stdin/stdout to the MCP transport.
+        try {
+            const result = await validateLicense();
+            if (result.offlineGrace) {
+                process.stderr.write('[provar-mcp] Warning: license validated from offline cache (last checked > 2h ago).\n');
+            }
+        }
+        catch (err) {
+            if (err instanceof LicenseError) {
+                this.error(err.message, { exit: 1 });
+            }
+            throw err;
+        }
+        const server = createProvarMcpServer({ allowedPaths });
+        const transport = new StdioServerTransport();
+        // Connect hands stdin/stdout ownership to the SDK.
+        // The process stays alive until stdin closes (client disconnect).
+        await server.connect(transport);
+    }
+}
+//# sourceMappingURL=start.js.map

package/lib/commands/provar/mcp/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../src/commands/provar/mcp/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhF,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,6BAA6B,EAAE,qBAAqB,CAAC,CAAC;AAE7F,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,SAAe;IACpD,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAEnE;;;OAGG;IACI,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC;IAE9B,MAAM,CAAU,KAAK,GAAG;QAC7B,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC;YAC5B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,6BAA6B,CAAC;YAC3D,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;SACzB,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,4BAA4B,CAAC;YAC1D,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAG,GAAG,CAAC;QAC3C,CAAC;QAED,6EAA6E;QAC7E,oDAAoD;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uFAAuF,CACxF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,mDAAmD;QACnD,kEAAkE;QAClE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC"}

package/lib/commands/provar/quality-hub/connect.d.ts

@@ -0,0 +1,5 @@
+import ManagerConnect from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/connect.js';
+export default class SfProvarQualityHubConnect extends ManagerConnect {
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+}

package/lib/commands/provar/quality-hub/connect.js

@@ -0,0 +1,12 @@
+/*
+ * 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 ManagerConnect from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/connect.js';
+export default class SfProvarQualityHubConnect extends ManagerConnect {
+    static aliases = ['provar:manager:connect'];
+    static deprecateAliases = true;
+}
+//# sourceMappingURL=connect.js.map

package/lib/commands/provar/quality-hub/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../../src/commands/provar/quality-hub/connect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,cAAc,MAAM,gFAAgF,CAAC;AAE5G,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,cAAc;IAC5D,MAAM,CAAU,OAAO,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACrD,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC"}

package/lib/commands/provar/quality-hub/display.d.ts

@@ -0,0 +1,5 @@
+import ManagerDisplay from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/display.js';
+export default class SfProvarQualityHubDisplay extends ManagerDisplay {
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+}

package/lib/commands/provar/quality-hub/display.js

@@ -0,0 +1,12 @@
+/*
+ * 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 ManagerDisplay from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/display.js';
+export default class SfProvarQualityHubDisplay extends ManagerDisplay {
+    static aliases = ['provar:manager:display'];
+    static deprecateAliases = true;
+}
+//# sourceMappingURL=display.js.map

package/lib/commands/provar/quality-hub/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../../src/commands/provar/quality-hub/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,cAAc,MAAM,gFAAgF,CAAC;AAE5G,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,cAAc;IAC5D,MAAM,CAAU,OAAO,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACrD,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC"}

package/lib/commands/provar/quality-hub/open.d.ts

@@ -0,0 +1,5 @@
+import ManagerOpen from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/open.js';
+export default class SfProvarQualityHubOpen extends ManagerOpen {
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+}

package/lib/commands/provar/quality-hub/open.js

@@ -0,0 +1,12 @@
+/*
+ * 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 ManagerOpen from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/open.js';
+export default class SfProvarQualityHubOpen extends ManagerOpen {
+    static aliases = ['provar:manager:open'];
+    static deprecateAliases = true;
+}
+//# sourceMappingURL=open.js.map

package/lib/commands/provar/quality-hub/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../../src/commands/provar/quality-hub/open.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,WAAW,MAAM,6EAA6E,CAAC;AAEtG,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,WAAW;IACtD,MAAM,CAAU,OAAO,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAClD,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC"}

package/lib/commands/provar/quality-hub/test/run/abort.d.ts

@@ -0,0 +1,5 @@
+import ManagerTestRunAbort from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/test/run/abort.js';
+export default class SfProvarQualityHubTestRunAbort extends ManagerTestRunAbort {
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+}

package/lib/commands/provar/quality-hub/test/run/abort.js

@@ -0,0 +1,12 @@
+/*
+ * 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 ManagerTestRunAbort from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/test/run/abort.js';
+export default class SfProvarQualityHubTestRunAbort extends ManagerTestRunAbort {
+    static aliases = ['provar:manager:test:run:abort'];
+    static deprecateAliases = true;
+}
+//# sourceMappingURL=abort.js.map

package/lib/commands/provar/quality-hub/test/run/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../../../../src/commands/provar/quality-hub/test/run/abort.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,mBAAmB,MAAM,uFAAuF,CAAC;AAExH,MAAM,CAAC,OAAO,OAAO,8BAA+B,SAAQ,mBAAmB;IACtE,MAAM,CAAU,OAAO,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC5D,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC"}

package/lib/commands/provar/quality-hub/test/run/report.d.ts

@@ -0,0 +1,5 @@
+import ManagerTestRunReport from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/test/run/report.js';
+export default class SfProvarQualityHubTestRunReport extends ManagerTestRunReport {
+    static readonly aliases: string[];
+    static readonly deprecateAliases = true;
+}

package/lib/commands/provar/quality-hub/test/run/report.js

@@ -0,0 +1,12 @@
+/*
+ * 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 ManagerTestRunReport from '@provartesting/provardx-plugins-manager/lib/commands/provar/manager/test/run/report.js';
+export default class SfProvarQualityHubTestRunReport extends ManagerTestRunReport {
+    static aliases = ['provar:manager:test:run:report'];
+    static deprecateAliases = true;
+}
+//# sourceMappingURL=report.js.map