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

package/oclif.manifest.json

@@ -1,5 +1,218 @@
 {
   "commands": {
+    "provar:auth:clear": {
+      "aliases": [],
+      "args": {},
+      "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.",
+      "examples": [
+        "Clear the stored API key:\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "provar:auth:clear",
+      "pluginAlias": "@provartesting/provardx-cli",
+      "pluginName": "@provartesting/provardx-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Remove the stored Provar API key.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "provar",
+        "auth",
+        "clear.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "provar:auth:clear",
+        "auth:provar:clear",
+        "auth:clear:provar",
+        "provar:clear:auth",
+        "clear:provar:auth",
+        "clear:auth:provar"
+      ]
+    },
+    "provar:auth:login": {
+      "aliases": [],
+      "args": {},
+      "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",
+      "examples": [
+        "Log in interactively (opens browser):\n<%= config.bin %> <%= command.id %>",
+        "Log in against a staging environment:\n<%= config.bin %> <%= command.id %> --url https://dev.api.example.com"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "name": "url",
+          "required": false,
+          "summary": "Override the Quality Hub API base URL (for testing against a non-production environment).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "provar:auth:login",
+      "pluginAlias": "@provartesting/provardx-cli",
+      "pluginName": "@provartesting/provardx-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Log in to Provar Quality Hub and store your API key.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "provar",
+        "auth",
+        "login.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "provar:auth:login",
+        "auth:provar:login",
+        "auth:login:provar",
+        "provar:login:auth",
+        "login:provar:auth",
+        "login:auth:provar"
+      ]
+    },
+    "provar:auth:rotate": {
+      "aliases": [],
+      "args": {},
+      "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.",
+      "examples": [
+        "Rotate the stored API key:\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "provar:auth:rotate",
+      "pluginAlias": "@provartesting/provardx-cli",
+      "pluginName": "@provartesting/provardx-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Rotate your stored Provar Quality Hub API key.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "provar",
+        "auth",
+        "rotate.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "provar:auth:rotate",
+        "auth:provar:rotate",
+        "auth:rotate:provar",
+        "provar:rotate:auth",
+        "rotate:provar:auth",
+        "rotate:auth:provar"
+      ]
+    },
+    "provar:auth:status": {
+      "aliases": [],
+      "args": {},
+      "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.",
+      "examples": [
+        "Check auth status:\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "provar:auth:status",
+      "pluginAlias": "@provartesting/provardx-cli",
+      "pluginName": "@provartesting/provardx-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show the current Provar API key configuration status.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "provar",
+        "auth",
+        "status.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "provar:auth:status",
+        "auth:provar:status",
+        "auth:status:provar",
+        "provar:status:auth",
+        "status:provar:auth",
+        "status:auth:provar"
+      ]
+    },
     "provar:config:get": {
       "aliases": [],
       "args": {},
@@ -1811,5 +2024,5 @@
       ]
     }
   },
-  "version": "1.5.0-beta.2"
+  "version": "1.5.0-beta.4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@provartesting/provardx-cli",
   "description": "A plugin for the Salesforce CLI to orchestrate testing activities and report quality metrics to Provar Quality Hub",
-  "version": "1.5.0-beta.2",
+  "version": "1.5.0-beta.4",
   "license": "BSD-3-Clause",
   "plugins": [
     "@provartesting/provardx-plugins-automation",
@@ -91,6 +91,9 @@
               }
             }
           },
+          "auth": {
+            "description": "Commands to manage Provar API key authentication."
+          },
           "automation": {
             "description": "Commands to interact with Provar Automation.",
             "subtopics": {
@@ -125,7 +128,7 @@
     "postpack": "shx rm -f oclif.manifest.json",
     "prepack": "sf-prepack",
     "test": "wireit",
-    "test:nuts": "nyc mocha  \"**/*generate.nut.ts\" \"**/*permission.nut.ts\" \"**/*load.nut.ts\" \"**/*validate.nut.ts\" \"**/*set.nut.ts\" \"**/*get.nut.ts\" --slow 4500 --timeout 600000 --reporter mochawesome",
+    "test:nuts": "nyc mocha  \"**/*generate.nut.ts\" \"**/*permission.nut.ts\" \"**/*load.nut.ts\" \"**/*validate.nut.ts\" \"**/*set.nut.ts\" \"**/*get.nut.ts\" \"**/*key.nut.ts\" \"**/*status.nut.ts\" \"**/*clear.nut.ts\" --slow 4500 --timeout 600000 --reporter mochawesome",
     "test:only": "wireit",
     "test:dev": "nyc mocha \"test/**/*.test.ts\"",
     "test:watch": "mocha \"test/**/*.test.ts\" --watch --watch-files \"src/**/*.ts\" --watch-files \"test/**/*.ts\"",