@salesforce/cli 2.45.6-qa.0 → 2.45.6

package/README.md

@@ -24,7 +24,7 @@ $ npm install -g @salesforce/cli
 $ sf COMMAND
 running command...
 $ sf (--version|-v)
-@salesforce/cli/2.45.6-qa.0 linux-x64 node-v20.13.1
+@salesforce/cli/2.45.6 linux-x64 node-v20.13.1
 $ sf --help [COMMAND]
 USAGE
   $ sf COMMAND
@@ -204,7 +204,7 @@ EXAMPLES
     $ sf alias list
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/alias/list.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/alias/list.ts)_
 
 ## `sf alias set`
 
@@ -222,7 +222,7 @@ DESCRIPTION
   Set one or more aliases on your local computer.
 
   Aliases are user-defined short names that make it easier to use the CLI. For example, users often set an alias for a
-  scratch org usernames because they're long and unintuitive.  Check the --help of a CLI command to determine where you
+  scratch org usernames because they're long and unintuitive. Check the --help of a CLI command to determine where you
   can use an alias.
 
   You can associate an alias with only one value at a time. If you set an alias multiple times, the alias points to the
@@ -253,7 +253,7 @@ EXAMPLES
     $ sf alias set my-scratch-org test-ss0xut7txzxf@example.com
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/alias/set.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/alias/set.ts)_
 
 ## `sf alias unset`
 
@@ -293,7 +293,7 @@ EXAMPLES
     $ sf alias unset --all [--no-prompt]
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/alias/unset.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/alias/unset.ts)_
 
 ## `sf analytics generate template`
 
@@ -404,7 +404,7 @@ Generate an Apex trigger.
 USAGE
   $ sf apex generate trigger -n <value> [--json] [--flags-dir <value>] [-t ApexTrigger] [-d <value>] [--api-version
     <value>] [-s <value>] [-e before insert|before update|before delete|after insert|after update|after delete|after
-    undelete...]
+    undelete]
 
 FLAGS
   -d, --output-dir=<value>   [default: .] Directory for saving the created files.
@@ -669,8 +669,8 @@ Invoke Apex tests in an org.
 ```
 USAGE
   $ sf apex run test -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-d <value>] [-l
-    RunLocalTests|RunAllTestsInOrg|RunSpecifiedTests] [-n <value>... | -s <value>... | -t <value>...] [-r
-    human|tap|junit|json] [-w <value>] [-y] [-v -c]
+    RunLocalTests|RunAllTestsInOrg|RunSpecifiedTests] [-n <value> | -s <value> | -t <value>] [-r human|tap|junit|json]
+    [-w <value>] [-y] [-v -c]
 
 FLAGS
   -c, --code-coverage           Retrieve code coverage results.
@@ -761,9 +761,7 @@ FLAG DESCRIPTIONS
     For multiple suites, repeat the flag for each.
     --suite-names Suite1 --suite-names Suite2
 
-  -t, --tests=<value>...
-
-    Apex test class names or IDs and, if applicable, test methods to run; default is all tests.
+  -t, --tests=<value>...  Apex test class names or IDs and, if applicable, test methods to run; default is all tests.
 
     If you specify --tests, you can't specify --class-names or --suite-names
     For multiple tests, repeat the flag for each.
@@ -852,8 +850,8 @@ List all sf commands.
 
 ```
 USAGE
-  $ sf commands [--json] [-c id|plugin|summary|type... | --tree] [--deprecated] [-x | ] [--hidden]
-    [--no-truncate | ] [--sort id|plugin|summary|type | ]
+  $ sf commands [--json] [-c id|plugin|summary|type | --tree] [--deprecated] [-x | ] [--hidden] [--no-truncate
+    | ] [--sort id|plugin|summary|type | ]
 
 FLAGS
   -c, --columns=<option>...  Only show provided columns (comma-separated).
@@ -922,7 +920,7 @@ CONFIGURATION VARIABLES
   org-capitalize-record-types    Whether record types are capitalized on scratch org creation.
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/config/get.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/config/get.ts)_
 
 ## `sf config list`
 
@@ -962,7 +960,7 @@ EXAMPLES
     $ sf config list
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/config/list.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/config/list.ts)_
 
 ## `sf config set`
 
@@ -1031,7 +1029,7 @@ CONFIGURATION VARIABLES
   org-capitalize-record-types    Whether record types are capitalized on scratch org creation.
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/config/set.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/config/set.ts)_
 
 ## `sf config unset`
 
@@ -1081,7 +1079,7 @@ CONFIGURATION VARIABLES
   org-capitalize-record-types    Whether record types are capitalized on scratch org creation.
 ```
 
-_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.2.7/src/commands/config/unset.ts)_
+_See code: [@salesforce/plugin-settings](https://github.com/salesforcecli/plugin-settings/blob/2.3.0/src/commands/config/unset.ts)_
 
 ## `sf data create file`
 
@@ -1523,8 +1521,7 @@ Import data from one or more JSON files into an org.
 
 ```
 USAGE
-  $ sf data import beta tree -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-f <value>...] [-p
-  <value>]
+  $ sf data import beta tree -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-f <value>] [-p <value>]
 
 FLAGS
   -f, --files=<value>...     Comma-separated and in-order JSON files that contain the records, in sObject tree format,
@@ -1567,7 +1564,7 @@ Import data from one or more JSON files into an org.
 
 ```
 USAGE
-  $ sf data import tree -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-f <value>... | -p <value>]
+  $ sf data import tree -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-f <value> | -p <value>]
 
 FLAGS
   -f, --files=<value>...     Comma-separated and in-order JSON files that contain the records, in sObject tree format,
@@ -2449,8 +2446,7 @@ Assign a permission set to one or more users of a scratch org.
 
 ```
 USAGE
-  $ sf org assign permset -n <value>... -o <value> [--json] [--flags-dir <value>] [-b <value>...] [--api-version
-  <value>]
+  $ sf org assign permset -n <value> -o <value> [--json] [--flags-dir <value>] [-b <value>] [--api-version <value>]
 
 FLAGS
   -b, --on-behalf-of=<value>...  Username or alias to assign the permission set to.
@@ -2494,7 +2490,7 @@ Assign a permission set license to one or more users of a scratch org.
 
 ```
 USAGE
-  $ sf org assign permsetlicense -n <value>... -o <value> [--json] [--flags-dir <value>] [-b <value>...] [--api-version
+  $ sf org assign permsetlicense -n <value> -o <value> [--json] [--flags-dir <value>] [-b <value>] [--api-version
   <value>]
 
 FLAGS
@@ -2540,8 +2536,8 @@ Create a sandbox org.
 
 ```
 USAGE
-  $ sf org create sandbox -o <value> [--json] [--flags-dir <value>] [-f <value>] [-s] [-a <value>] [-w <minutes> |
-    --async] [-i <seconds> | ] [-n <value>] [-c <value> | -l Developer|Developer_Pro|Partial|Full] [--no-prompt]
+  $ sf org create sandbox -o <value> [--json] [--flags-dir <value>] [-f <value>] [-s] [-a <value>] [-w <value> |
+    --async] [-i <value> | ] [-n <value>] [-c <value> | -l Developer|Developer_Pro|Partial|Full] [--no-prompt]
     [--no-track-source]
 
 FLAGS
@@ -2659,7 +2655,7 @@ Create a scratch org.
 USAGE
   $ sf org create scratch -v <value> [--json] [--flags-dir <value>] [-a <value>] [--async] [-d] [-f <value>] [-c] [-e
     developer|enterprise|group|professional|partner-developer|partner-enterprise|partner-group|partner-professional]
-    [-m] [-y <days>] [-w <minutes>] [--api-version <value>] [-i <value>] [-t] [--username <value>] [--description
+    [-m] [-y <value>] [-w <value>] [--api-version <value>] [-i <value>] [-t] [--username <value>] [--description
     <value>] [--name <value>] [--release preview|previous] [--admin-email <value>] [--source-org <value>]
 
 FLAGS
@@ -3174,7 +3170,7 @@ Generate a random password for scratch org users.
 
 ```
 USAGE
-  $ sf org generate password -o <value> [--json] [--flags-dir <value>] [-b <value>...] [-l <value>] [-c <value>]
+  $ sf org generate password -o <value> [--json] [--flags-dir <value>] [-b <value>] [-l <value>] [-c <value>]
     [--api-version <value>]
 
 FLAGS
@@ -3474,7 +3470,7 @@ Display record counts for the specified standard or custom objects.
 
 ```
 USAGE
-  $ sf org list sobject record-counts -o <value> [--json] [--flags-dir <value>] [-s <value>...] [--api-version <value>]
+  $ sf org list sobject record-counts -o <value> [--json] [--flags-dir <value>] [-s <value>] [--api-version <value>]
 
 FLAGS
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
@@ -4048,8 +4044,8 @@ Refresh a sandbox org using the sandbox name.
 
 ```
 USAGE
-  $ sf org refresh sandbox -o <value> [--json] [--flags-dir <value>] [--no-auto-activate] [-w <minutes> | --async] [-i
-    <seconds> | ] [-n <value>] [-f <value>] [--no-prompt]
+  $ sf org refresh sandbox -o <value> [--json] [--flags-dir <value>] [--no-auto-activate] [-w <value> | --async] [-i
+    <value> | ] [-n <value>] [-f <value>] [--no-prompt]
 
 FLAGS
   -f, --definition-file=<value>  Path to a sandbox definition file for overriding its configuration when you refresh it.
@@ -4093,9 +4089,7 @@ EXAMPLES
     $ sf org refresh sandbox --definition-file devSbx3-config.json --target-org prodOrg
 
 FLAG DESCRIPTIONS
-  -f, --definition-file=<value>
-
-    Path to a sandbox definition file for overriding its configuration when you refresh it.
+  -f, --definition-file=<value>  Path to a sandbox definition file for overriding its configuration when you refresh it.
 
     The sandbox definition file is a blueprint for the sandbox; use the file to change the sandbox configuration during
     a refresh. If you don't want to change the sandbox configuration when you refresh it, then simply use the --name
@@ -4127,7 +4121,7 @@ Check the status of a sandbox creation, and log in to it if it's ready.
 
 ```
 USAGE
-  $ sf org resume sandbox [--json] [--flags-dir <value>] [-w <minutes>] [-n <value> | -i <value>] [-l] [-o <value>]
+  $ sf org resume sandbox [--json] [--flags-dir <value>] [-w <value>] [-n <value> | -i <value>] [-l] [-o <value>]
 
 FLAGS
   -i, --job-id=<value>      Job ID of the incomplete sandbox creation that you want to check the status of.
@@ -5464,7 +5458,7 @@ EXAMPLES
   $ sf plugins discover
 ```
 
-_See code: [@salesforce/plugin-marketplace](https://github.com/salesforcecli/plugin-marketplace/blob/1.2.9/src/commands/plugins/discover.ts)_
+_See code: [@salesforce/plugin-marketplace](https://github.com/salesforcecli/plugin-marketplace/blob/1.2.10/src/commands/plugins/discover.ts)_
 
 ## `sf plugins:inspect PLUGIN...`
 
@@ -5668,8 +5662,8 @@ Convert metadata retrieved via Metadata API into the source format used in Sales
 
 ```
 USAGE
-  $ sf project convert mdapi -r <value> [--json] [--flags-dir <value>] [--api-version <value>] [-d <value>] [-p <value>...
-    | -x <value> | -m <value>...]
+  $ sf project convert mdapi -r <value> [--json] [--flags-dir <value>] [--api-version <value>] [-d <value>] [-p <value> |
+    -x <value> | -m <value>]
 
 FLAGS
   -d, --output-dir=<value>       Directory to store your files in after they’re converted to source format; can be an
@@ -5732,7 +5726,7 @@ Convert source-formatted files into metadata that you can deploy using Metadata
 ```
 USAGE
   $ sf project convert source [--json] [--flags-dir <value>] [--api-version <value>] [-r <value>] [-d <value>] [-n <value>]
-    [-p <value>... | -x <value> | -m <value>...]
+    [-p <value> | -x <value> | -m <value>]
 
 FLAGS
   -d, --output-dir=<value>     [default: metadataPackage_1717296698220] Output directory to store the Metadata
@@ -5862,8 +5856,8 @@ Delete source from your project and from a non-source-tracked org.
 ```
 USAGE
   $ sf project delete source -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-w <value>] [--tests
-    <value>...] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-r] [-m <value>...] [-p <value>...] [-f
-    [-t | -c]] [--verbose]
+    <value>] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-r] [-m <value>] [-p <value>] [-f [-t |
+    -c]] [--verbose]
 
 FLAGS
   -c, --check-only             Validate delete command but don't delete anything from the org or the local project.
@@ -6038,7 +6032,7 @@ Cancel a deploy operation.
 
 ```
 USAGE
-  $ sf project deploy cancel [--json] [--flags-dir <value>] [-o <value>] [--async | -w <minutes>] [-i <value>] [-r]
+  $ sf project deploy cancel [--json] [--flags-dir <value>] [-o <value>] [--async | -w <value>] [-i <value>] [-r]
 
 FLAGS
   -i, --job-id=<value>      Job ID of the deploy operation you want to cancel.
@@ -6110,7 +6104,7 @@ Preview a deployment to see what will deploy to the org, the potential conflicts
 
 ```
 USAGE
-  $ sf project deploy preview -o <value> [--json] [--flags-dir <value>] [-c] [-x <value> | -d <value>... | -m <value>...]
+  $ sf project deploy preview -o <value> [--json] [--flags-dir <value>] [-c] [-x <value> | -d <value> | -m <value>]
     [--concise]
 
 FLAGS
@@ -6193,8 +6187,8 @@ Quickly deploy a validated deployment to an org.
 
 ```
 USAGE
-  $ sf project deploy quick [--json] [--flags-dir <value>] [--async | -w <minutes>] [--concise | --verbose] [-i <value>]
-    [-o <value>] [-r] [-a <value>]
+  $ sf project deploy quick [--json] [--flags-dir <value>] [--async | -w <value>] [--concise | --verbose] [-i <value>] [-o
+    <value>] [-r] [-a <value>]
 
 FLAGS
   -a, --api-version=<value>  Target API version for the deploy.
@@ -6287,8 +6281,8 @@ Check or poll for the status of a deploy operation.
 ```
 USAGE
   $ sf project deploy report [--json] [--flags-dir <value>] [-o <value>] [-i <value>] [-r] [--coverage-formatters
-    clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary...] [--junit]
-    [--results-dir <value>] [-w <minutes>]
+    clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary] [--junit] [--results-dir
+    <value>] [-w <value>]
 
 FLAGS
   -i, --job-id=<value>      Job ID of the deploy operation you want to check the status of.
@@ -6378,8 +6372,8 @@ Resume watching a deploy operation and update source tracking when the deploy co
 
 ```
 USAGE
-  $ sf project deploy resume [--json] [--flags-dir <value>] [--concise | --verbose] [-i <value>] [-r] [-w <minutes>]
-    [--coverage-formatters clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary...]
+  $ sf project deploy resume [--json] [--flags-dir <value>] [--concise | --verbose] [-i <value>] [-r] [-w <value>]
+    [--coverage-formatters clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary]
     [--junit] [--results-dir <value>]
 
 FLAGS
@@ -6475,11 +6469,11 @@ Deploy metadata to an org from your local project.
 
 ```
 USAGE
-  $ sf project deploy start -o <value> [--json] [--flags-dir <value>] [-a <value>] [--async | -w <minutes>] [--concise |
-    --verbose] [--dry-run] [-c] [-r] [-g] [--single-package ] [-t <value>...] [-l
-    NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [--purge-on-delete [-x <value> | -d <value>... | -m
-    <value>... | --metadata-dir <value>]] [--pre-destructive-changes <value> ] [--post-destructive-changes <value> ]
-    [--coverage-formatters clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary...]
+  $ sf project deploy start -o <value> [--json] [--flags-dir <value>] [-a <value>] [--async | -w <value>] [--concise |
+    --verbose] [--dry-run] [-c] [-r] [-g] [--single-package ] [-t <value>] [-l
+    NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [--purge-on-delete [-x <value> | -d <value> | -m <value>
+    | --metadata-dir <value>]] [--pre-destructive-changes <value> ] [--post-destructive-changes <value> ]
+    [--coverage-formatters clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary]
     [--junit] [--results-dir <value>]
 
 FLAGS
@@ -6719,11 +6713,10 @@ Validate a metadata deployment without actually executing it.
 ```
 USAGE
   $ sf project deploy validate -o <value> [--json] [--flags-dir <value>] [-a <value>] [--async] [--concise | --verbose] [-m
-    <value>...] [-d <value>...] [--single-package --metadata-dir <value>] [-t <value>...] [-l
-    RunAllTestsInOrg|RunLocalTests|RunSpecifiedTests] [-w <minutes>] [-g] [--coverage-formatters
-    clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary...] [--junit]
-    [--results-dir <value>] [--purge-on-delete -x <value>] [--pre-destructive-changes <value> ]
-    [--post-destructive-changes <value> ]
+    <value>] [-d <value>] [--single-package --metadata-dir <value>] [-t <value>] [-l
+    RunAllTestsInOrg|RunLocalTests|RunSpecifiedTests] [-w <value>] [-g] [--coverage-formatters
+    clover|cobertura|html-spa|html|json|json-summary|lcovonly|none|teamcity|text|text-summary] [--junit] [--results-dir
+    <value>] [--purge-on-delete -x <value>] [--pre-destructive-changes <value> ] [--post-destructive-changes <value> ]
 
 FLAGS
   -a, --api-version=<value>  Target API version for the validation.
@@ -7013,8 +7006,8 @@ Create a project manifest that lists the metadata components you want to deploy
 
 ```
 USAGE
-  $ sf project generate manifest [--json] [--flags-dir <value>] [--api-version <value>] [-m <value>...] [-p <value>...] [-n
-    <value> | -t pre|post|destroy|package] [-c managed|unlocked... --from-org <value>] [-d <value>]
+  $ sf project generate manifest [--json] [--flags-dir <value>] [--api-version <value>] [-m <value>] [-p <value>] [-n <value> |
+    -t pre|post|destroy|package] [-c managed|unlocked --from-org <value>] [-d <value>]
 
 FLAGS
   -c, --include-packages=<option>...  Package types (managed, unlocked) whose metadata is included in the manifest; by
@@ -7235,9 +7228,8 @@ Retrieve metadata from an org to your local project.
 
 ```
 USAGE
-  $ sf project retrieve start -o <value> [--json] [--flags-dir <value>] [-a <value>] [-c] [-x <value> | -m <value>... | -d
-    <value>...] [-r <value> | -n <value>... | ] [--single-package -t <value>] [-w <value>] [-z ] [--zip-file-name
-    <value> ]
+  $ sf project retrieve start -o <value> [--json] [--flags-dir <value>] [-a <value>] [-c] [-x <value> | -m <value> | -d
+    <value>] [-r <value> | -n <value> | ] [--single-package -t <value>] [-w <value>] [-z ] [--zip-file-name <value> ]
 
 FLAGS
   -a, --api-version=<value>      Target API version for the retrieve.
@@ -7375,9 +7367,7 @@ FLAG DESCRIPTIONS
     If the target directory matches one of the package directories in your sfdx-project.json file, the command fails.
     Running the command multiple times with the same target adds new files and overwrites existing files.
 
-  -w, --wait=<value>
-
-    Number of minutes to wait for the command to complete and display results to the terminal window.
+  -w, --wait=<value>  Number of minutes to wait for the command to complete and display results to the terminal window.
 
     If the command continues to run after the wait period, the CLI returns control of the terminal window to you.
 

package/bin/dev.js

@@ -1,11 +1,9 @@
 #!/usr/bin/env ts-node
 
 async function main() {
-  const { settings } = await import('@oclif/core/settings');
-  const { execute } = await import('@oclif/core/execute');
-
-  settings.performanceEnabled = true;
-  await execute({ development: true, dir: import.meta.url });
+  const oclif = await import('@oclif/core');
+  oclif.settings.performanceEnabled = true;
+  await oclif.execute({ development: true, dir: import.meta.url });
 }
 
 await main();

package/bin/run.js

@@ -3,13 +3,30 @@
 // Pre-process/prune flags before creating or running the actual CLI
 (await import('../dist/flags.js')).preprocessCliFlags(process);
 
-// Since the CLI is a single process, we can have a larger amount of max listeners since
-// the process gets shut down. Don't set it to 0 (no limit) since we should still be aware
-// of rouge event listeners
-process.setMaxListeners(parseInt(process.env.SF_MAX_EVENT_LISTENERS, 10) || 1000);
-
-// Don't let other plugins override the CLI specified max listener count
-process.setMaxListeners = () => {};
+const oclif = await import('@oclif/core');
+const { createRequire } = await import('module');
+const pjson = createRequire(import.meta.url)('../package.json');
 
 const cli = await import('../dist/cli.js');
-await cli.run();
+
+async function main() {
+  // Since the CLI is a single process, we can have a larger amount of max listeners since
+  // the process gets shut down. Don't set it to 0 (no limit) since we should still be aware
+  // of rouge event listeners
+  process.setMaxListeners(parseInt(process.env.SF_MAX_EVENT_LISTENERS, 10) || 1000);
+
+  // Don't let other plugins override the CLI specified max listener count
+  process.setMaxListeners = () => {};
+
+  cli
+    .create({ version: pjson.version, bin: pjson.oclif.bin, channel: 'stable' })
+    .run()
+    .then(async () => {
+      await oclif.flush();
+    })
+    .catch(async (err) => {
+      await oclif.handle(err);
+    });
+}
+
+await main();

package/dist/cli.js

@@ -7,10 +7,11 @@
 import { platform, arch, release } from 'node:os';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { execute } from '@oclif/core/execute';
-import { Config } from '@oclif/core/config';
-import NodeEnv, { Env } from './util/env.js';
-import { logger } from './logger.js';
+import { Config, run as oclifRun, settings } from '@oclif/core';
+import { set } from '@salesforce/kit';
+import Debug from 'debug';
+import { default as nodeEnv, Env } from './util/env.js';
+const debug = Debug('sf');
 const envVars = [
     ...new Set([
         ...Object.keys(process.env).filter((e) => e.startsWith('SF_') || e.startsWith('SFDX_')),
@@ -31,6 +32,13 @@ export const UPDATE_DISABLED_INSTALLER = 'Manual and automatic CLI updates have
 export const UPDATE_DISABLED_NPM = 'Use "npm update --global @salesforce/cli" to update npm-based installations.';
 export const UPDATE_DISABLED_DEMO = 'Manual and automatic CLI updates have been disabled in DEMO mode. ' +
     'To check for a new version, unset the environment variable SF_ENV.';
+export function configureUpdateSites(config, env = nodeEnv) {
+    const npmRegistry = env.getNpmRegistryOverride();
+    if (npmRegistry) {
+        // Override config value if set via envar
+        set(config, 'pjson.oclif.warn-if-update-available.registry', npmRegistry);
+    }
+}
 export function configureAutoUpdate(envars) {
     if (envars.isDemoMode()) {
         // Disable autoupdates in demo mode
@@ -54,12 +62,11 @@ export function configureAutoUpdate(envars) {
         envars.setUpdateInstructions(UPDATE_DISABLED_NPM);
     }
 }
-function debugCliInfo(env, config) {
+function debugCliInfo(version, channel, env, config) {
     function debugSection(section, items) {
         const pad = 25;
-        const header = `### ${section} ###`;
-        logger.debug('%s', header.padStart(pad));
-        items.forEach(([name, value]) => logger.debug('%s: %s', name.padStart(pad), value));
+        debug('%s:', section.padStart(pad));
+        items.forEach(([name, value]) => debug('%s: %s', name.padStart(pad), value));
     }
     debugSection('OS', [
         ['platform', platform()],
@@ -69,8 +76,8 @@ function debugCliInfo(env, config) {
     ]);
     debugSection('NODE', [['version', process.versions.node]]);
     debugSection('CLI', [
-        ['version', config.version],
-        ['channel', config.channel],
+        ['version', version],
+        ['channel', channel],
         ['bin', config.bin],
         ['data', config.dataDir],
         ['cache', config.cacheDir],
@@ -79,16 +86,26 @@ function debugCliInfo(env, config) {
     debugSection('ENV', [...envVars].map((key) => [key, env.getString(key, '<not set>')]));
     debugSection('ARGS', process.argv.map((arg, i) => [i.toString(), arg]));
 }
-export async function run() {
-    configureAutoUpdate(NodeEnv);
-    const config = await Config.load({
-        root: resolve(fileURLToPath(import.meta.url), '..'),
-        logger,
-        enablePerf: true,
-    });
-    debugCliInfo(NodeEnv, config);
-    return execute({
-        loadOptions: config,
-    });
+export function create({ version, bin, channel, run, env }) {
+    settings.performanceEnabled = true;
+    const root = resolve(fileURLToPath(import.meta.url), '..');
+    const args = process.argv.slice(2);
+    const environment = env ?? nodeEnv;
+    return {
+        async run() {
+            const config = new Config({
+                name: bin,
+                root,
+                version,
+                channel,
+            });
+            await config.load();
+            configureUpdateSites(config, environment);
+            configureAutoUpdate(environment);
+            debugCliInfo(version, channel, environment, config);
+            // Example of how run is used in a test https://github.com/salesforcecli/cli/pull/171/files#diff-1deee0a575599b2df117c280da319f7938aaf6fdb0c04bcdbde769dbf464be69R46
+            return run ? run(args, config) : oclifRun(args, config);
+        },
+    };
 }
 //# sourceMappingURL=cli.js.map

package/dist/help/sfCommandHelp.js

@@ -4,7 +4,7 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
-import { CommandHelp } from '@oclif/core/help';
+import { CommandHelp } from '@oclif/core';
 export class SfCommandHelp extends CommandHelp {
     constructor(command, config, opts) {
         super(command, config, opts);

package/dist/help/sfHelp.js

@@ -4,11 +4,10 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
-import { Help } from '@oclif/core/help';
-import { toConfiguredId } from '@oclif/core/util/ids';
-import { Ansis } from 'ansis';
+import { Help, toConfiguredId } from '@oclif/core';
+import stripAnsi from 'strip-ansi';
+import chalk from 'chalk';
 import { SfCommandHelp } from './sfCommandHelp.js';
-const ansis = new Ansis();
 export default class SfHelp extends Help {
     constructor(config, opts) {
         super(config, opts);
@@ -55,9 +54,9 @@ export default class SfHelp extends Help {
     log(...args) {
         const formatted = args.map((arg) => {
             let formattedArg = arg.slice();
-            const matches = ansis.strip(formattedArg).match(this.commandIdRegex) ?? [];
+            const matches = stripAnsi(formattedArg).match(this.commandIdRegex) ?? [];
             for (const match of matches) {
-                formattedArg = formattedArg.replaceAll(match, ansis.dim(match));
+                formattedArg = formattedArg.replaceAll(match, chalk.dim(match));
             }
             return formattedArg;
         });

package/dist/hooks/display-release-notes.js

@@ -1,4 +1,10 @@
-import ux from '@oclif/core/ux';
+/*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { ux } from '@oclif/core';
 export const hook = async function ({ config }) {
     if (process.env.SF_HIDE_RELEASE_NOTES === 'true')
         return;
@@ -7,9 +13,9 @@ export const hook = async function ({ config }) {
     }
     catch (err) {
         const error = err;
-        ux.stdout('NOTE: This error can be ignored in CI and may be silenced in the future');
-        ux.stdout('- Set the SF_HIDE_RELEASE_NOTES env var to "true" to skip this script\n');
-        ux.stdout(error.message);
+        ux.log('NOTE: This error can be ignored in CI and may be silenced in the future');
+        ux.log('- Set the SF_HIDE_RELEASE_NOTES env var to "true" to skip this script\n');
+        ux.log(error.message);
     }
 };
 export default hook;

package/dist/hooks/incomplete.js

@@ -4,9 +4,8 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
-import os from 'node:os';
-import { toConfiguredId, toStandardizedId } from '@oclif/core/util/ids';
-import { loadHelpClass } from '@oclif/core/help';
+import * as os from 'node:os';
+import { toConfiguredId, toStandardizedId, loadHelpClass } from '@oclif/core';
 function buildChoices(matches, config) {
     const configuredIds = matches.map((p) => toConfiguredId(p.id, config));
     const maxCommandLength = configuredIds.reduce((max, id) => Math.max(max, id.length), 0);

package/dist/hooks/pluginsPreinstall.js

@@ -4,12 +4,12 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
-import { handle } from '@oclif/core/handle';
+import { Errors } from '@oclif/core';
 const hook = async function (options) {
     const verifySignHookResult = await this.config.runHook('plugins:preinstall:verify:signature', options);
     const pluginTrustFailure = verifySignHookResult.failures.find((failure) => failure.plugin.name === '@salesforce/plugin-trust');
     if (pluginTrustFailure !== undefined) {
-        await handle(pluginTrustFailure.error);
+        await Errors.handle(pluginTrustFailure.error);
     }
 };
 export default hook;

package/dist/hooks/prerun.js

@@ -4,7 +4,7 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
-import ux from '@oclif/core/ux';
+import { ux } from '@oclif/core';
 // eslint-disable-next-line @typescript-eslint/require-await
 const hook = async function ({ Command, config }) {
     if (process.argv.includes('--json'))