@salesforce/cli 2.44.6 → 2.44.7

package/README.md

@@ -24,7 +24,7 @@ $ npm install -g @salesforce/cli
 $ sf COMMAND
 running command...
 $ sf (--version|-v)
-@salesforce/cli/2.44.6 linux-x64 node-v20.13.1
+@salesforce/cli/2.44.7 linux-x64 node-v20.13.1
 $ sf --help [COMMAND]
 USAGE
   $ sf COMMAND
@@ -148,6 +148,7 @@ See [architecture page](ARCHITECTURE.md) for diagrams of the Salesforce CLI.
 - [`sf plugins update`](#sf-plugins-update)
 - [`sf project convert mdapi`](#sf-project-convert-mdapi)
 - [`sf project convert source`](#sf-project-convert-source)
+- [`sf project convert source-behavior`](#sf-project-convert-source-behavior)
 - [`sf project delete source`](#sf-project-delete-source)
 - [`sf project delete tracking`](#sf-project-delete-tracking)
 - [`sf project deploy cancel`](#sf-project-deploy-cancel)
@@ -5718,7 +5719,7 @@ FLAG DESCRIPTIONS
     If you specify this parameter, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/convert/mdapi.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/convert/mdapi.ts)_
 
 ## `sf project convert source`
 
@@ -5730,7 +5731,7 @@ USAGE
     [-p <value> | -x <value> | -m <value>]
 
 FLAGS
-  -d, --output-dir=<value>     [default: metadataPackage_1716916525319] Output directory to store the Metadata
+  -d, --output-dir=<value>     [default: metadataPackage_1716992955026] Output directory to store the Metadata
                                API–formatted files in.
   -m, --metadata=<value>...    Metadata component names to convert.
   -n, --package-name=<value>   Name of the package to associate with the metadata-formatted files.
@@ -5791,7 +5792,64 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/convert/source.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/convert/source.ts)_
+
+## `sf project convert source-behavior`
+
+Enable a behavior of your project source files, and then update your Salesforce DX project to implement the behavior.
+
+```
+USAGE
+  $ sf project convert source-behavior -b
+    decomposeCustomLabelsBeta|decomposePermissionSetBeta|decomposeSharingRulesBeta|decomposeWorkflowBeta [--json]
+    [--flags-dir <value>] [--dry-run] [--preserve-temp-dir] [-o <value>]
+
+FLAGS
+  -b, --behavior=<option>   (required) Behavior to enable; the values correspond to the possible values of the
+                            "sourceBehaviorOption" option in the "sfdx-project.json" file.
+                            <options: decomposeCustomLabelsBeta|decomposePermissionSetBeta|decomposeSharingRulesBeta|dec
+                            omposeWorkflowBeta>
+  -o, --target-org=<value>
+      --dry-run             Display what the command would do, but don't make any actual changes.
+      --preserve-temp-dir   Don't delete the metadata API format temporary directory that this command creates. Useful
+                            for debugging.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Enable a behavior of your project source files, and then update your Salesforce DX project to implement the behavior.
+
+  Specifically, this command updates the "sourceBehaviorOption" option in the "sfdx-project.json" file and then converts
+  the associated local source files in your project as needed.
+
+  For example, run this command with the "--behavior decomposePermissionSetBeta" flag to start decomposing permission
+  sets when you deploy or retrieve them. Decomposing means breaking up the monolithic metadata API format XML file that
+  corresponds to a metadata component into smaller XML files and directories based on its subtypes. Permission sets are
+  not decomposed by default; you must opt-in to start decomposing them by using this command. When the command finishes,
+  your "sfdx-project.json" file is updated to always decompose permission sets, and the existing permission set files in
+  your local package directories are converted into the new decomposed format. You run this command only once for a
+  given behavior change.
+
+  For more information about the possible values for the --behavior flag, see the "sourceBehaviorOptions" section in the
+  https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm topic.
+
+EXAMPLES
+  Update your Salesforce DX project to decompose custom labels:
+
+    $ sf project convert source-behavior --behavior decomposeCustomLabelsBeta
+
+  Display what the command would do, but don't change any existing files:
+
+    $ sf project convert source-behavior --behavior decomposeCustomLabelsBeta --dry-run
+
+  Keep the temporary directory that contains the interim metadata API formatted files:
+
+    $ sf project convert source-behavior --behavior decomposeCustomLabelsBeta --dry-run --preserve-temp-dir
+```
+
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/convert/source-behavior.ts)_
 
 ## `sf project delete source`
 
@@ -5931,7 +5989,7 @@ FLAG DESCRIPTIONS
     - Separate the test names with spaces: --tests Test1 Test2 "Test With Space"
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/delete/source.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/delete/source.ts)_
 
 ## `sf project delete tracking`
 
@@ -5968,7 +6026,7 @@ EXAMPLES
     $ sf project delete tracking --target-org my-scratch
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/delete/tracking.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/delete/tracking.ts)_
 
 ## `sf project deploy cancel`
 
@@ -6044,7 +6102,7 @@ FLAG DESCRIPTIONS
     project deploy report".
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/cancel.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/cancel.ts)_
 
 ## `sf project deploy preview`
 
@@ -6130,7 +6188,7 @@ FLAG DESCRIPTIONS
     All child components are included. If you specify this flag, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/preview.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/preview.ts)_
 
 ## `sf project deploy quick`
 
@@ -6227,7 +6285,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/quick.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/quick.ts)_
 
 ## `sf project deploy report`
 
@@ -6323,7 +6381,7 @@ FLAG DESCRIPTIONS
     --coverage-formatters lcov --coverage-formatters clover
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/report.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/report.ts)_
 
 ## `sf project deploy resume`
 
@@ -6420,7 +6478,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/resume.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/resume.ts)_
 
 ## `sf project deploy start`
 
@@ -6658,7 +6716,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/start.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/start.ts)_
 
 ## `sf project deploy validate`
 
@@ -6850,7 +6908,7 @@ ERROR CODES
   Canceling (69)         The deploy is being canceled.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/deploy/validate.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/deploy/validate.ts)_
 
 ## `sf project generate`
 
@@ -7032,7 +7090,7 @@ EXAMPLES
     $ sf project generate manifest --from-org test@myorg.com --include-packages unlocked
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/generate/manifest.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/generate/manifest.ts)_
 
 ## `sf project list ignored`
 
@@ -7074,7 +7132,7 @@ EXAMPLES
     $ sf project list ignored --source-dir package.xml
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/list/ignored.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/list/ignored.ts)_
 
 ## `sf project reset tracking`
 
@@ -7123,7 +7181,7 @@ EXAMPLES
     $ sf project reset tracking --revision 30
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/reset/tracking.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/reset/tracking.ts)_
 
 ## `sf project retrieve preview`
 
@@ -7180,7 +7238,7 @@ FLAG DESCRIPTIONS
     Overrides your default org.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/retrieve/preview.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/retrieve/preview.ts)_
 
 ## `sf project retrieve start`
 
@@ -7339,7 +7397,7 @@ ENVIRONMENT VARIABLES
   SF_USE_PROGRESS_BAR  Set to false to disable the progress bar when running the metadata deploy command.
 ```
 
-_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.7.10/src/commands/project/retrieve/start.ts)_
+_See code: [@salesforce/plugin-deploy-retrieve](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.8.0/src/commands/project/retrieve/start.ts)_
 
 ## `sf schema generate field`
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/cli",
-  "version": "2.44.6",
+  "version": "2.44.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/cli",
-      "version": "2.44.6",
+      "version": "2.44.7",
       "hasInstallScript": true,
       "license": "BSD-3-Clause",
       "dependencies": {
@@ -27,7 +27,7 @@
         "@salesforce/plugin-apex": "3.1.13",
         "@salesforce/plugin-auth": "3.6.16",
         "@salesforce/plugin-data": "3.4.3",
-        "@salesforce/plugin-deploy-retrieve": "3.7.10",
+        "@salesforce/plugin-deploy-retrieve": "3.8.0",
         "@salesforce/plugin-info": "3.3.3",
         "@salesforce/plugin-limits": "3.3.9",
         "@salesforce/plugin-marketplace": "1.2.8",
@@ -4856,9 +4856,9 @@
       "license": "MIT"
     },
     "node_modules/@salesforce/plugin-deploy-retrieve": {
-      "version": "3.7.10",
-      "resolved": "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-3.7.10.tgz",
-      "integrity": "sha512-yxMKNi3MR4DvFlTg32mBI3mX0ywAICDWM1MFiikeKV9nvBCpUsTmfdsav0mlPlmA55SLa29F7afWMi84yRJqlg==",
+      "version": "3.8.0",
+      "resolved": "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-3.8.0.tgz",
+      "integrity": "sha512-RSZcgXLZXJYLC9DfYSuCm/SzFpooLUzwf0wmjpLAyZZKxiE4fPHjjs1HSsznaB3m0JQF0nKTLnuCl+O0/kAThw==",
       "license": "BSD-3-Clause",
       "dependencies": {
         "@oclif/core": "^3.26.6",

package/oclif.lock

@@ -2593,10 +2593,10 @@
     csv-stringify "^6.5.0"
     form-data "^4.0.0"
 
-"@salesforce/plugin-deploy-retrieve@3.7.10":
-  version "3.7.10"
-  resolved "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-3.7.10.tgz"
-  integrity sha512-yxMKNi3MR4DvFlTg32mBI3mX0ywAICDWM1MFiikeKV9nvBCpUsTmfdsav0mlPlmA55SLa29F7afWMi84yRJqlg==
+"@salesforce/plugin-deploy-retrieve@3.8.0":
+  version "3.8.0"
+  resolved "https://registry.npmjs.org/@salesforce/plugin-deploy-retrieve/-/plugin-deploy-retrieve-3.8.0.tgz"
+  integrity sha512-RSZcgXLZXJYLC9DfYSuCm/SzFpooLUzwf0wmjpLAyZZKxiE4fPHjjs1HSsznaB3m0JQF0nKTLnuCl+O0/kAThw==
   dependencies:
     "@oclif/core" "^3.26.6"
     "@salesforce/apex-node" "^6.0.0"

package/oclif.manifest.json

@@ -5379,5 +5379,5 @@
       ]
     }
   },
-  "version": "2.44.6"
+  "version": "2.44.7"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/cli",
   "description": "The Salesforce CLI",
-  "version": "2.44.6",
+  "version": "2.44.7",
   "author": "Salesforce",
   "bin": {
     "sf": "./bin/run.js",
@@ -155,7 +155,7 @@
     "@salesforce/plugin-apex": "3.1.13",
     "@salesforce/plugin-auth": "3.6.16",
     "@salesforce/plugin-data": "3.4.3",
-    "@salesforce/plugin-deploy-retrieve": "3.7.10",
+    "@salesforce/plugin-deploy-retrieve": "3.8.0",
     "@salesforce/plugin-info": "3.3.3",
     "@salesforce/plugin-limits": "3.3.9",
     "@salesforce/plugin-marketplace": "1.2.8",