sfdx-hardis 5.27.0 → 5.28.1

package/oclif.manifest.json

@@ -57,12 +57,13 @@
         "world:hello"
       ]
     },
-    "hardis:cache:clear": {
+    "hardis:auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Clear cache generated by sfdx-hardis",
+      "description": "Login to salesforce org",
       "examples": [
-        "$ sf hardis:cache:clear"
+        "$ sf hardis:auth:login",
+        "CI=true sf hardis:auth:login"
       ],
       "flags": {
         "json": {
@@ -80,6 +81,28 @@
           "multiple": false,
           "type": "option"
         },
+        "instanceurl": {
+          "char": "r",
+          "description": "URL of org instance",
+          "name": "instanceurl",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "devhub": {
+          "char": "h",
+          "description": "Also connect associated DevHub",
+          "name": "devhub",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "scratchorg": {
+          "char": "s",
+          "description": "Scratch org",
+          "name": "scratchorg",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "debug": {
           "char": "d",
           "description": "Activate debug mode (more logs)",
@@ -103,39 +126,38 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hardis:cache:clear",
+      "id": "hardis:auth:login",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Clear sfdx-hardis cache",
+      "title": "Login",
       "requiresProject": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "cache",
-        "clear.js"
+        "auth",
+        "login.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:cache:clear",
-        "cache:hardis:clear",
-        "cache:clear:hardis",
-        "hardis:clear:cache",
-        "clear:hardis:cache",
-        "clear:cache:hardis"
+        "hardis:auth:login",
+        "auth:hardis:login",
+        "auth:login:hardis",
+        "hardis:login:auth",
+        "login:hardis:auth",
+        "login:auth:hardis"
       ]
     },
-    "hardis:auth:login": {
+    "hardis:cache:clear": {
       "aliases": [],
       "args": {},
-      "description": "Login to salesforce org",
+      "description": "Clear cache generated by sfdx-hardis",
       "examples": [
-        "$ sf hardis:auth:login",
-        "CI=true sf hardis:auth:login"
+        "$ sf hardis:cache:clear"
       ],
       "flags": {
         "json": {
@@ -153,28 +175,6 @@
           "multiple": false,
           "type": "option"
         },
-        "instanceurl": {
-          "char": "r",
-          "description": "URL of org instance",
-          "name": "instanceurl",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "devhub": {
-          "char": "h",
-          "description": "Also connect associated DevHub",
-          "name": "devhub",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "scratchorg": {
-          "char": "s",
-          "description": "Scratch org",
-          "name": "scratchorg",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "debug": {
           "char": "d",
           "description": "Activate debug mode (more logs)",
@@ -198,30 +198,30 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hardis:auth:login",
+      "id": "hardis:cache:clear",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Login",
+      "title": "Clear sfdx-hardis cache",
       "requiresProject": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "auth",
-        "login.js"
+        "cache",
+        "clear.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:auth:login",
-        "auth:hardis:login",
-        "auth:login:hardis",
-        "hardis:login:auth",
-        "login:hardis:auth",
-        "login:auth:hardis"
+        "hardis:cache:clear",
+        "cache:hardis:clear",
+        "cache:clear:hardis",
+        "hardis:clear:cache",
+        "clear:hardis:cache",
+        "clear:cache:hardis"
       ]
     },
     "hardis:config:get": {
@@ -1041,7 +1041,7 @@
     "hardis:lint:metadatastatus": {
       "aliases": [],
       "args": {},
-      "description": "Check if elements (flows and validation rules) are inactive in the project\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-inactive-metadata/) and can output Grafana, Slack and MsTeams Notifications.\n",
+      "description": "Check if elements are inactive in the project:\n\n- Approval Processes\n- Assignment Rules\n- Auto Response Rules\n- Escalation Rules\n- Flows\n- Forecasting Types\n- Record Types\n- Validation Rules\n- Workflow Rules\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/detect-inactive-metadata.gif)\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-inactive-metadata/) and can output Grafana, Slack and MsTeams Notifications.\n",
       "examples": [
         "$ sf hardis:lint:metadatastatus"
       ],
@@ -2386,12 +2386,12 @@
         "mergexml:package:hardis"
       ]
     },
-    "hardis:project:create": {
+    "hardis:packagexml:append": {
       "aliases": [],
       "args": {},
-      "description": "Create a new SFDX Project",
+      "description": "Append one or multiple package.xml files into a single one",
       "examples": [
-        "$ sf hardis:project:create"
+        "$ sf hardis packagexml append -p package1.xml,package2.xml -o package3.xml"
       ],
       "flags": {
         "json": {
@@ -2409,62 +2409,70 @@
           "multiple": false,
           "type": "option"
         },
+        "packagexmls": {
+          "char": "p",
+          "description": "package.xml files path (separated by commas)",
+          "name": "packagexmls",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "outputfile": {
+          "char": "f",
+          "description": "package.xml output file",
+          "name": "outputfile",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "debug": {
-          "char": "d",
-          "description": "Activate debug mode (more logs)",
+          "description": "debug",
           "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
         "websocket": {
-          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
+          "description": "websocket",
           "name": "websocket",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "skipauth": {
-          "description": "Skip authentication check when a default username is required",
-          "name": "skipauth",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hardis:project:create",
+      "id": "hardis:packagexml:append",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Login",
-      "requiresProject": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "project",
-        "create.js"
+        "packagexml",
+        "append.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:project:create",
-        "project:hardis:create",
-        "project:create:hardis",
-        "hardis:create:project",
-        "create:hardis:project",
-        "create:project:hardis"
+        "hardis:packagexml:append",
+        "packagexml:hardis:append",
+        "packagexml:append:hardis",
+        "hardis:append:packagexml",
+        "append:hardis:packagexml",
+        "append:packagexml:hardis"
       ]
     },
-    "hardis:project:lint": {
+    "hardis:packagexml:remove": {
       "aliases": [],
       "args": {},
-      "description": "Apply syntactic analysis (linters) on the repository sources, using Mega-Linter",
+      "description": "Removes the content of a package.xml file matching another package.xml file",
       "examples": [
-        "$ sf hardis:project:lint",
-        "$ sf hardis:project:lint --fix"
+        "$ sf hardis packagexml:remove -p package.xml -r destructiveChanges.xml -o my-reduced-package.xml"
       ],
       "flags": {
         "json": {
@@ -2482,82 +2490,85 @@
           "multiple": false,
           "type": "option"
         },
-        "fix": {
-          "char": "f",
-          "description": "Apply linters fixes",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
+        "packagexml": {
+          "char": "p",
+          "description": "package.xml file to reduce",
+          "name": "packagexml",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "debug": {
-          "char": "d",
-          "description": "Activate debug mode (more logs)",
-          "name": "debug",
+        "removepackagexml": {
+          "char": "r",
+          "description": "package.xml file to use to filter input package.xml",
+          "name": "removepackagexml",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "removedonly": {
+          "char": "z",
+          "description": "Use this flag to generate a package.xml with only removed items",
+          "name": "removedonly",
           "allowNo": false,
           "type": "boolean"
         },
-        "websocket": {
-          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
-          "name": "websocket",
+        "outputfile": {
+          "char": "f",
+          "description": "package.xml output file",
+          "name": "outputfile",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "skipauth": {
-          "description": "Skip authentication check when a default username is required",
-          "name": "skipauth",
+        "debug": {
+          "description": "debug",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "summary": "Username or alias of the target org.",
-          "hasDynamicHelp": true,
+        "websocket": {
+          "description": "websocket",
+          "name": "websocket",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
-      "hasDynamicHelp": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hardis:project:lint",
+      "id": "hardis:packagexml:remove",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Lint",
       "requiresProject": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "project",
-        "lint.js"
+        "packagexml",
+        "remove.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:project:lint",
-        "project:hardis:lint",
-        "project:lint:hardis",
-        "hardis:lint:project",
-        "lint:hardis:project",
-        "lint:project:hardis"
+        "hardis:packagexml:remove",
+        "packagexml:hardis:remove",
+        "packagexml:remove:hardis",
+        "hardis:remove:packagexml",
+        "remove:hardis:packagexml",
+        "remove:packagexml:hardis"
       ]
     },
-    "hardis:scratch:create": {
+    "hardis:project:create": {
       "aliases": [],
       "args": {},
-      "description": "Create and initialize a scratch org or a source-tracked sandbox (config can be defined using `config/.sfdx-hardis.yml`):\n\n- **Install packages**\n  - Use property `installedPackages`\n- **Push sources**\n- **Assign permission sets**\n  - Use property `initPermissionSets`\n- **Run apex initialization scripts**\n  - Use property `scratchOrgInitApexScripts`\n- **Load data**\n  - Use property `dataPackages`\n  ",
+      "description": "Create a new SFDX Project",
       "examples": [
-        "$ sf hardis:scratch:create"
+        "$ sf hardis:project:create"
       ],
       "flags": {
         "json": {
@@ -2575,23 +2586,10 @@
           "multiple": false,
           "type": "option"
         },
-        "forcenew": {
-          "char": "n",
-          "description": "If an existing scratch org exists, do not reuse it but create a new one",
-          "name": "forcenew",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pool": {
-          "description": "Creates the scratch org for a scratch org pool",
-          "name": "pool",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "debug": {
-          "char": "d",
-          "description": "Activate debug mode (more logs)",
-          "name": "debug",
+        "debug": {
+          "char": "d",
+          "description": "Activate debug mode (more logs)",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
@@ -2607,60 +2605,43 @@
           "name": "skipauth",
           "allowNo": false,
           "type": "boolean"
-        },
-        "target-dev-hub": {
-          "aliases": [
-            "targetdevhubusername"
-          ],
-          "char": "v",
-          "deprecateAliases": true,
-          "name": "target-dev-hub",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
         }
       },
-      "hasDynamicHelp": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hardis:scratch:create",
+      "id": "hardis:project:create",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Create and initialize scratch org",
-      "requiresProject": true,
-      "requiresSfdxPlugins": [
-        "sfdmu",
-        "texei-sfdx-plugin"
-      ],
+      "title": "Login",
+      "requiresProject": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "scratch",
+        "project",
         "create.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:scratch:create",
-        "scratch:hardis:create",
-        "scratch:create:hardis",
-        "hardis:create:scratch",
-        "create:hardis:scratch",
-        "create:scratch:hardis"
+        "hardis:project:create",
+        "project:hardis:create",
+        "project:create:hardis",
+        "hardis:create:project",
+        "create:hardis:project",
+        "create:project:hardis"
       ]
     },
-    "hardis:scratch:delete": {
+    "hardis:project:lint": {
       "aliases": [],
       "args": {},
-      "description": "Assisted menu to delete scratch orgs associated to a DevHub",
+      "description": "Apply syntactic analysis (linters) on the repository sources, using Mega-Linter",
       "examples": [
-        "$ sf hardis:scratch:delete"
+        "$ sf hardis:project:lint",
+        "$ sf hardis:project:lint --fix"
       ],
       "flags": {
         "json": {
@@ -2678,6 +2659,13 @@
           "multiple": false,
           "type": "option"
         },
+        "fix": {
+          "char": "f",
+          "description": "Apply linters fixes",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "debug": {
           "char": "d",
           "description": "Activate debug mode (more logs)",
@@ -2698,16 +2686,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "target-dev-hub": {
+        "target-org": {
           "aliases": [
-            "targetdevhubusername"
+            "targetusername",
+            "u"
           ],
-          "char": "v",
+          "char": "o",
           "deprecateAliases": true,
-          "name": "target-dev-hub",
+          "name": "target-org",
           "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
+          "summary": "Username or alias of the target org.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -2715,37 +2703,38 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "hardis:scratch:delete",
+      "id": "hardis:project:lint",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Delete scratch orgs(s)",
+      "title": "Lint",
+      "requiresProject": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "scratch",
-        "delete.js"
+        "project",
+        "lint.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:scratch:delete",
-        "scratch:hardis:delete",
-        "scratch:delete:hardis",
-        "hardis:delete:scratch",
-        "delete:hardis:scratch",
-        "delete:scratch:hardis"
+        "hardis:project:lint",
+        "project:hardis:lint",
+        "project:lint:hardis",
+        "hardis:lint:project",
+        "lint:hardis:project",
+        "lint:project:hardis"
       ]
     },
-    "hardis:scratch:pull": {
+    "hardis:scratch:create": {
       "aliases": [],
       "args": {},
-      "description": "This commands pulls the updates you performed in your scratch or sandbox org, into your local files\n\nThen, you probably want to stage and commit the files containing the updates you want to keep, as explained in this video.\n\n<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/Ik6whtflmfY\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>\n\n- Calls `sf project retrieve start` under the hood\n- If there are errors, proposes to automatically add erroneous item in `.forceignore`, then pull again\n- If you don't see your updated items in the results, you can manually retrieve [using SF Extension **Org Browser** or **Salesforce CLI**](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-publish-task/#retrieve-metadatas)\n- If you want to always retrieve sources like CustomApplication that are not always detected as updates by project:retrieve:start , you can define property **autoRetrieveWhenPull** in .sfdx-hardis.yml\n\nExample:\n```yaml\nautoRetrieveWhenPull:\n  - CustomApplication:MyCustomApplication\n  - CustomApplication:MyOtherCustomApplication\n  - CustomApplication:MyThirdCustomApp\n```\n",
+      "description": "Create and initialize a scratch org or a source-tracked sandbox (config can be defined using `config/.sfdx-hardis.yml`):\n\n- **Install packages**\n  - Use property `installedPackages`\n- **Push sources**\n- **Assign permission sets**\n  - Use property `initPermissionSets`\n- **Run apex initialization scripts**\n  - Use property `scratchOrgInitApexScripts`\n- **Load data**\n  - Use property `dataPackages`\n  ",
       "examples": [
-        "$ sf hardis:scratch:pull"
+        "$ sf hardis:scratch:create"
       ],
       "flags": {
         "json": {
@@ -2763,6 +2752,19 @@
           "multiple": false,
           "type": "option"
         },
+        "forcenew": {
+          "char": "n",
+          "description": "If an existing scratch org exists, do not reuse it but create a new one",
+          "name": "forcenew",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pool": {
+          "description": "Creates the scratch org for a scratch org pool",
+          "name": "pool",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "debug": {
           "char": "d",
           "description": "Activate debug mode (more logs)",
@@ -2783,17 +2785,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "target-org": {
+        "target-dev-hub": {
           "aliases": [
-            "targetusername",
-            "u"
+            "targetdevhubusername"
           ],
-          "char": "o",
+          "char": "v",
           "deprecateAliases": true,
-          "name": "target-org",
+          "name": "target-dev-hub",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -2801,38 +2802,42 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "hardis:scratch:pull",
+      "id": "hardis:scratch:create",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Scratch PULL",
+      "title": "Create and initialize scratch org",
       "requiresProject": true,
+      "requiresSfdxPlugins": [
+        "sfdmu",
+        "texei-sfdx-plugin"
+      ],
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
         "scratch",
-        "pull.js"
+        "create.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:scratch:pull",
-        "scratch:hardis:pull",
-        "scratch:pull:hardis",
-        "hardis:pull:scratch",
-        "pull:hardis:scratch",
-        "pull:scratch:hardis"
+        "hardis:scratch:create",
+        "scratch:hardis:create",
+        "scratch:create:hardis",
+        "hardis:create:scratch",
+        "create:hardis:scratch",
+        "create:scratch:hardis"
       ]
     },
-    "hardis:scratch:push": {
+    "hardis:scratch:delete": {
       "aliases": [],
       "args": {},
-      "description": "Push local files to scratch org\n\nCalls `sf project deploy start` under the hood\n",
+      "description": "Assisted menu to delete scratch orgs associated to a DevHub",
       "examples": [
-        "$ sf hardis:scratch:push"
+        "$ sf hardis:scratch:delete"
       ],
       "flags": {
         "json": {
@@ -2870,17 +2875,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "target-org": {
+        "target-dev-hub": {
           "aliases": [
-            "targetusername",
-            "u"
+            "targetdevhubusername"
           ],
-          "char": "o",
+          "char": "v",
           "deprecateAliases": true,
-          "name": "target-org",
+          "name": "target-dev-hub",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -2888,38 +2892,37 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "hardis:scratch:push",
+      "id": "hardis:scratch:delete",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "title": "Scratch PUSH",
-      "requiresProject": true,
+      "title": "Delete scratch orgs(s)",
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
         "scratch",
-        "push.js"
+        "delete.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:scratch:push",
-        "scratch:hardis:push",
-        "scratch:push:hardis",
-        "hardis:push:scratch",
-        "push:hardis:scratch",
-        "push:scratch:hardis"
+        "hardis:scratch:delete",
+        "scratch:hardis:delete",
+        "scratch:delete:hardis",
+        "hardis:delete:scratch",
+        "delete:hardis:scratch",
+        "delete:scratch:hardis"
       ]
     },
-    "hardis:packagexml:append": {
+    "hardis:scratch:pull": {
       "aliases": [],
       "args": {},
-      "description": "Append one or multiple package.xml files into a single one",
+      "description": "This commands pulls the updates you performed in your scratch or sandbox org, into your local files\n\nThen, you probably want to stage and commit the files containing the updates you want to keep, as explained in this video.\n\n<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/Ik6whtflmfY\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>\n\n- Calls `sf project retrieve start` under the hood\n- If there are errors, proposes to automatically add erroneous item in `.forceignore`, then pull again\n- If you don't see your updated items in the results, you can manually retrieve [using SF Extension **Org Browser** or **Salesforce CLI**](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-publish-task/#retrieve-metadatas)\n- If you want to always retrieve sources like CustomApplication that are not always detected as updates by project:retrieve:start , you can define property **autoRetrieveWhenPull** in .sfdx-hardis.yml\n\nExample:\n```yaml\nautoRetrieveWhenPull:\n  - CustomApplication:MyCustomApplication\n  - CustomApplication:MyOtherCustomApplication\n  - CustomApplication:MyThirdCustomApp\n```\n",
       "examples": [
-        "$ sf hardis packagexml append -p package1.xml,package2.xml -o package3.xml"
+        "$ sf hardis:scratch:pull"
       ],
       "flags": {
         "json": {
@@ -2937,70 +2940,76 @@
           "multiple": false,
           "type": "option"
         },
-        "packagexmls": {
-          "char": "p",
-          "description": "package.xml files path (separated by commas)",
-          "name": "packagexmls",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "outputfile": {
-          "char": "f",
-          "description": "package.xml output file",
-          "name": "outputfile",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "debug": {
-          "description": "debug",
+          "char": "d",
+          "description": "Activate debug mode (more logs)",
           "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
         "websocket": {
-          "description": "websocket",
+          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
           "name": "websocket",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "skipauth": {
+          "description": "Skip authentication check when a default username is required",
+          "name": "skipauth",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
         }
       },
-      "hasDynamicHelp": false,
+      "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "hardis:packagexml:append",
+      "id": "hardis:scratch:pull",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "title": "Scratch PULL",
+      "requiresProject": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "packagexml",
-        "append.js"
+        "scratch",
+        "pull.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:packagexml:append",
-        "packagexml:hardis:append",
-        "packagexml:append:hardis",
-        "hardis:append:packagexml",
-        "append:hardis:packagexml",
-        "append:packagexml:hardis"
+        "hardis:scratch:pull",
+        "scratch:hardis:pull",
+        "scratch:pull:hardis",
+        "hardis:pull:scratch",
+        "pull:hardis:scratch",
+        "pull:scratch:hardis"
       ]
     },
-    "hardis:packagexml:remove": {
+    "hardis:scratch:push": {
       "aliases": [],
       "args": {},
-      "description": "Removes the content of a package.xml file matching another package.xml file",
+      "description": "Push local files to scratch org\n\nCalls `sf project deploy start` under the hood\n",
       "examples": [
-        "$ sf hardis packagexml:remove -p package.xml -r destructiveChanges.xml -o my-reduced-package.xml"
+        "$ sf hardis:scratch:push"
       ],
       "flags": {
         "json": {
@@ -3010,85 +3019,76 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "packagexml": {
-          "char": "p",
-          "description": "package.xml file to reduce",
-          "name": "packagexml",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "removepackagexml": {
-          "char": "r",
-          "description": "package.xml file to use to filter input package.xml",
-          "name": "removepackagexml",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "removedonly": {
-          "char": "z",
-          "description": "Use this flag to generate a package.xml with only removed items",
-          "name": "removedonly",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "outputfile": {
-          "char": "f",
-          "description": "package.xml output file",
-          "name": "outputfile",
-          "required": true,
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "debug": {
-          "description": "debug",
+          "char": "d",
+          "description": "Activate debug mode (more logs)",
           "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
         "websocket": {
-          "description": "websocket",
+          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
           "name": "websocket",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "skipauth": {
+          "description": "Skip authentication check when a default username is required",
+          "name": "skipauth",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
         }
       },
-      "hasDynamicHelp": false,
+      "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "hardis:packagexml:remove",
+      "id": "hardis:scratch:push",
       "pluginAlias": "sfdx-hardis",
       "pluginName": "sfdx-hardis",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "requiresProject": false,
+      "title": "Scratch PUSH",
+      "requiresProject": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "hardis",
-        "packagexml",
-        "remove.js"
+        "scratch",
+        "push.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "hardis:packagexml:remove",
-        "packagexml:hardis:remove",
-        "packagexml:remove:hardis",
-        "hardis:remove:packagexml",
-        "remove:hardis:packagexml",
-        "remove:packagexml:hardis"
+        "hardis:scratch:push",
+        "scratch:hardis:push",
+        "scratch:push:hardis",
+        "hardis:push:scratch",
+        "push:hardis:scratch",
+        "push:scratch:hardis"
       ]
     },
     "hardis:source:deploy": {
@@ -4114,6 +4114,105 @@
         "ws:work:hardis"
       ]
     },
+    "hardis:doc:extract:permsetgroups": {
+      "aliases": [],
+      "args": {},
+      "description": "Generate markdown files with project documentation",
+      "examples": [
+        "$ sf hardis:doc:extract:permsetgroups"
+      ],
+      "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"
+        },
+        "outputfile": {
+          "char": "f",
+          "description": "Force the path and name of output report file. Must end with .csv",
+          "name": "outputfile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Activate debug mode (more logs)",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "websocket": {
+          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
+          "name": "websocket",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skipauth": {
+          "description": "Skip authentication check when a default username is required",
+          "name": "skipauth",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hardis:doc:extract:permsetgroups",
+      "pluginAlias": "sfdx-hardis",
+      "pluginName": "sfdx-hardis",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "title": "Generate project documentation",
+      "requiresProject": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "hardis",
+        "doc",
+        "extract",
+        "permsetgroups.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "hardis:doc:extract:permsetgroups",
+        "doc:hardis:extract:permsetgroups",
+        "doc:extract:hardis:permsetgroups",
+        "doc:extract:permsetgroups:hardis",
+        "hardis:extract:doc:permsetgroups",
+        "extract:hardis:doc:permsetgroups",
+        "extract:doc:hardis:permsetgroups",
+        "extract:doc:permsetgroups:hardis",
+        "hardis:extract:permsetgroups:doc",
+        "extract:hardis:permsetgroups:doc",
+        "extract:permsetgroups:hardis:doc",
+        "extract:permsetgroups:doc:hardis",
+        "hardis:doc:permsetgroups:extract",
+        "doc:hardis:permsetgroups:extract",
+        "doc:permsetgroups:hardis:extract",
+        "doc:permsetgroups:extract:hardis",
+        "hardis:permsetgroups:doc:extract",
+        "permsetgroups:hardis:doc:extract",
+        "permsetgroups:doc:hardis:extract",
+        "permsetgroups:doc:extract:hardis",
+        "hardis:permsetgroups:extract:doc",
+        "permsetgroups:hardis:extract:doc",
+        "permsetgroups:extract:hardis:doc",
+        "permsetgroups:extract:doc:hardis"
+      ]
+    },
     "hardis:doc:plugin:generate": {
       "aliases": [],
       "args": {},
@@ -4334,105 +4433,6 @@
         "extract:pull-requests:git:hardis"
       ]
     },
-    "hardis:doc:extract:permsetgroups": {
-      "aliases": [],
-      "args": {},
-      "description": "Generate markdown files with project documentation",
-      "examples": [
-        "$ sf hardis:doc:extract:permsetgroups"
-      ],
-      "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"
-        },
-        "outputfile": {
-          "char": "f",
-          "description": "Force the path and name of output report file. Must end with .csv",
-          "name": "outputfile",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "debug": {
-          "char": "d",
-          "description": "Activate debug mode (more logs)",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "websocket": {
-          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
-          "name": "websocket",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "skipauth": {
-          "description": "Skip authentication check when a default username is required",
-          "name": "skipauth",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "hardis:doc:extract:permsetgroups",
-      "pluginAlias": "sfdx-hardis",
-      "pluginName": "sfdx-hardis",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "title": "Generate project documentation",
-      "requiresProject": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "hardis",
-        "doc",
-        "extract",
-        "permsetgroups.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "hardis:doc:extract:permsetgroups",
-        "doc:hardis:extract:permsetgroups",
-        "doc:extract:hardis:permsetgroups",
-        "doc:extract:permsetgroups:hardis",
-        "hardis:extract:doc:permsetgroups",
-        "extract:hardis:doc:permsetgroups",
-        "extract:doc:hardis:permsetgroups",
-        "extract:doc:permsetgroups:hardis",
-        "hardis:extract:permsetgroups:doc",
-        "extract:hardis:permsetgroups:doc",
-        "extract:permsetgroups:hardis:doc",
-        "extract:permsetgroups:doc:hardis",
-        "hardis:doc:permsetgroups:extract",
-        "doc:hardis:permsetgroups:extract",
-        "doc:permsetgroups:hardis:extract",
-        "doc:permsetgroups:extract:hardis",
-        "hardis:permsetgroups:doc:extract",
-        "permsetgroups:hardis:doc:extract",
-        "permsetgroups:doc:hardis:extract",
-        "permsetgroups:doc:extract:hardis",
-        "hardis:permsetgroups:extract:doc",
-        "permsetgroups:hardis:extract:doc",
-        "permsetgroups:extract:hardis:doc",
-        "permsetgroups:extract:doc:hardis"
-      ]
-    },
     "hardis:org:community:update": {
       "aliases": [],
       "args": {},
@@ -5199,7 +5199,7 @@
     "hardis:org:diagnose:audittrail": {
       "aliases": [],
       "args": {},
-      "description": "Export Audit trail into a CSV file with selected criteria, and highlight suspect actions\n\nRegular setup actions performed in major orgs are filtered.\n\n- \"\"\n  - createScratchOrg\n  - changedsenderemail\n  - deleteScratchOrg\n  - loginasgrantedtopartnerbt\n- Certificate and Key Management\n  - insertCertificate\n- Custom App Licenses\n  - addeduserpackagelicense\n  - granteduserpackagelicense\n- Customer Portal\n  - createdcustomersuccessuser\n- Currency\n  - updateddatedexchrate\n- Data Management\n  - queueMembership\n- Email Administration\n  - dkimRotationPreparationSuccessful\n  - dkimRotationSuccessful\n- Groups\n  - groupMembership\n- Holidays\n  - holiday_insert\n- Inbox mobile and legacy desktop apps\n  - enableSIQUserNonEAC\n- Manage Users\n  - activateduser\n  - createduser\n  - changedcommunitynickname\n  - changedemail\n  - changedfederationid\n  - changedpassword\n  - changedinteractionuseroffon\n  - changedinteractionuseronoff\n  - changedmarketinguseroffon\n  - changedmarketinguseronoff\n  - changedprofileforuser\n  - changedprofileforusercusttostd\n  - changedprofileforuserstdtocust\n  - changedroleforusertonone\n  - changedroleforuser\n  - changedroleforuserfromnone\n  - changedUserEmailVerifiedStatusUnverified\n  - changedUserEmailVerifiedStatusVerified\n  - changedUserPhoneNumber\n  - changedUserPhoneVerifiedStatusUnverified\n  - deactivateduser\n  - deleteAuthenticatorPairing\n  - deleteTwoFactorInfo2\n  - deleteTwoFactorTempCode\n  - frozeuser\n  - insertAuthenticatorPairing\n  - insertTwoFactorInfo2\n  - insertTwoFactorTempCode\n  - lightningloginenroll\n  - PermSetAssign\n  - PermSetGroupAssign\n  - PermSetGroupUnassign\n  - PermSetLicenseAssign\n  - PermSetUnassign\n  - PermSetLicenseUnassign\n  - registeredUserPhoneNumber\n  - resetpassword\n  - suOrgAdminLogin\n  - suOrgAdminLogout\n  - unfrozeuser\n  - useremailchangesent\n- Mobile Administration\n  - assigneduserstomobileconfig\n- Reporting Snapshots\n  - createdReportJob\n  - deletedReportJob\n- Sandboxes\n  - DeleteSandbox\n\nBy default, deployment user defined in .sfdx-hardis.yml targetUsername property will be excluded.\n\nYou can define additional users to exclude in .sfdx-hardis.yml **monitoringExcludeUsernames** property.\n\nYou can also add more sections / actions considered as not suspect using property **monitoringAllowedSectionsActions**\n\nExample:\n\n```yaml\nmonitoringExcludeUsernames:\n  - deploymentuser@cloudity.com\n  - marketingcloud@cloudity.com\n  - integration-user@cloudity.com\n\nmonitoringAllowedSectionsActions:\n  \"Some section\": [] // Will ignore all actions from such section\n  \"Some other section\": [\"actionType1\",\"actionType2\",\"actionType3\"] // Will ignore only those 3 actions from section \"Some other section\". Other actions in the same section will be considered as suspect.\n```\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-suspect-audit-trail/) and can output Grafana, Slack and MsTeams Notifications.\n",
+      "description": "Export Audit trail into a CSV file with selected criteria, and highlight suspect actions\n\nRegular setup actions performed in major orgs are filtered.\n\n- \"\"\n  - createScratchOrg\n  - changedsenderemail\n  - deleteScratchOrg\n  - loginasgrantedtopartnerbt\n- Certificate and Key Management\n  - insertCertificate\n- Custom App Licenses\n  - addeduserpackagelicense\n  - granteduserpackagelicense\n  - revokeduserpackagelicense\n- Customer Portal\n  - createdcustomersuccessuser\n  - CSPUserDisabled\n- Currency\n  - updateddatedexchrate\n- Data Management\n  - queueMembership\n- Email Administration\n  - dkimRotationPreparationSuccessful\n  - dkimRotationSuccessful\n- Groups\n  - groupMembership\n- Holidays\n  - holiday_insert\n- Inbox mobile and legacy desktop apps\n  - enableSIQUserNonEAC\n- Manage Users\n  - activateduser\n  - createduser\n  - changedcommunitynickname\n  - changedemail\n  - changedfederationid\n  - changedpassword\n  - changedinteractionuseroffon\n  - changedinteractionuseronoff\n  - changedmarketinguseroffon\n  - changedmarketinguseronoff\n  - changedprofileforuser\n  - changedprofileforusercusttostd\n  - changedprofileforuserstdtocust\n  - changedroleforusertonone\n  - changedroleforuser\n  - changedroleforuserfromnone\n  - changedUserEmailVerifiedStatusUnverified\n  - changedUserEmailVerifiedStatusVerified\n  - changedknowledgeuseroffon\n  - changedsupportuseroffon\n  - changedUserPhoneNumber\n  - changedUserPhoneVerifiedStatusUnverified\n  - deactivateduser\n  - deleteAuthenticatorPairing\n  - deleteTwoFactorInfo2\n  - deleteTwoFactorTempCode\n  - frozeuser\n  - insertAuthenticatorPairing\n  - insertTwoFactorInfo2\n  - insertTwoFactorTempCode\n  - lightningloginenroll\n  - PermSetAssign\n  - PermSetGroupAssign\n  - PermSetGroupUnassign\n  - PermSetLicenseAssign\n  - PermSetUnassign\n  - PermSetLicenseUnassign\n  - registeredUserPhoneNumber\n  - resetpassword\n  - suNetworkAdminLogin\n  - suNetworkAdminLogout\n  - suOrgAdminLogin\n  - suOrgAdminLogout\n  - unfrozeuser\n  - useremailchangesent\n- Mobile Administration\n  - assigneduserstomobileconfig\n- Reporting Snapshots\n  - createdReportJob\n  - deletedReportJob\n- Sandboxes\n  - DeleteSandbox\n\nBy default, deployment user defined in .sfdx-hardis.yml targetUsername property will be excluded.\n\nYou can define additional users to exclude in .sfdx-hardis.yml **monitoringExcludeUsernames** property.\n\nYou can also add more sections / actions considered as not suspect using property **monitoringAllowedSectionsActions**\n\nExample:\n\n```yaml\nmonitoringExcludeUsernames:\n  - deploymentuser@cloudity.com\n  - marketingcloud@cloudity.com\n  - integration-user@cloudity.com\n\nmonitoringAllowedSectionsActions:\n  \"Some section\": [] // Will ignore all actions from such section\n  \"Some other section\": [\"actionType1\",\"actionType2\",\"actionType3\"] // Will ignore only those 3 actions from section \"Some other section\". Other actions in the same section will be considered as suspect.\n```\n\n## Excel output example\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-monitoring-audittrail-excel.jpg)\n\n## Local output example\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-monitoring-audittrail-local.jpg)\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-suspect-audit-trail/) and can output Grafana, Slack and MsTeams Notifications.\n",
       "examples": [
         "$ sf hardis:org:diagnose:audittrail",
         "$ sf hardis:org:diagnose:audittrail --excludeusers baptiste@titi.com",
@@ -14525,5 +14525,5 @@
       ]
     }
   },
-  "version": "5.27.0"
+  "version": "5.28.1"
 }