@salesforce/plugin-org 3.0.6 → 3.0.8

package/README.md

@@ -129,7 +129,8 @@ USAGE
 FLAGS
   -a, --setalias=<value>        Alias for the cloned org.
   -f, --definitionfile=<value>  Path to the sandbox definition file.
-  -o, --target-org=<value>      (required) Username or alias of the target org.
+  -o, --target-org=<value>      (required) Username or alias of the target org. Not required if the `target-org`
+                                configuration variable is already set.
   -s, --setdefaultusername      Set the cloned org as your default.
   -t, --type=<option>           (required) Type of org to create.
                                 <options: sandbox>
@@ -162,7 +163,7 @@ FLAG DESCRIPTIONS
     for a number of minutes, the client exits. Specify a longer wait time if timeouts occur frequently.
 ```
 
-_See code: [src/commands/force/org/clone.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/force/org/clone.ts)_
+_See code: [src/commands/force/org/clone.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/force/org/clone.ts)_
 
 ## `sf force org create`
 
@@ -184,7 +185,8 @@ FLAGS
   -s, --setdefaultusername      Set the created org as the default username.
   -t, --type=<option>           [default: scratch] Type of org to create.
                                 <options: scratch|sandbox>
-  -v, --target-dev-hub=<value>  Username or alias of the Dev Hub org.
+  -v, --target-dev-hub=<value>  Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration
+                                variable is already set.
   -w, --wait=<value>            [default: 6 minutes] Streaming client socket timeout (in minutes).
       --api-version=<value>     Override the api version used for api requests made by this command
 
@@ -210,7 +212,7 @@ EXAMPLES
   $ sf force org create -t sandbox -f config/dev-sandbox-def.json -a MyDevSandbox -u prodOrg
 ```
 
-_See code: [src/commands/force/org/create.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/force/org/create.ts)_
+_See code: [src/commands/force/org/create.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/force/org/create.ts)_
 
 ## `sf force org delete`
 
@@ -242,7 +244,7 @@ EXAMPLES
   $ sf force org delete -u MyOrgAlias -p
 ```
 
-_See code: [src/commands/force/org/delete.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/force/org/delete.ts)_
+_See code: [src/commands/force/org/delete.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/force/org/delete.ts)_
 
 ## `sf force org status`
 
@@ -255,7 +257,8 @@ USAGE
 FLAGS
   -a, --setalias=<value>     Alias for the created or cloned org.
   -n, --sandboxname=<value>  (required) Name of the sandbox org to check status for.
-  -o, --target-org=<value>   (required) Username or alias of the target org.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
   -s, --setdefaultusername   Set the created or cloned org as your default.
   -w, --wait=<value>         [default: 6 minutes] Number of minutes to wait while polling for status.
       --api-version=<value>  Override the api version used for api requests made by this command
@@ -280,7 +283,7 @@ EXAMPLES
   $ sf force org status --sandboxname DevSbx1 --wait 45 --setdefaultusername -u prodOrg
 ```
 
-_See code: [src/commands/force/org/status.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/force/org/status.ts)_
+_See code: [src/commands/force/org/status.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/force/org/status.ts)_
 
 ## `sf org create sandbox`
 
@@ -385,7 +388,7 @@ FLAG DESCRIPTIONS
     sandbox.
 ```
 
-_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/create/sandbox.ts)_
+_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/create/sandbox.ts)_
 
 ## `sf org create scratch`
 
@@ -538,7 +541,7 @@ FLAG DESCRIPTIONS
     Omit this flag to have Salesforce generate a unique username for your org.
 ```
 
-_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/create/scratch.ts)_
+_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/create/scratch.ts)_
 
 ## `sf org delete sandbox`
 
@@ -582,7 +585,7 @@ EXAMPLES
     $ sf org delete sandbox --target-org my-sandbox --no-prompt
 ```
 
-_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/delete/sandbox.ts)_
+_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/delete/sandbox.ts)_
 
 ## `sf org delete scratch`
 
@@ -624,38 +627,45 @@ EXAMPLES
     $ sf org delete scratch --target-org my-scratch-org --no-prompt
 ```
 
-_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/delete/scratch.ts)_
+_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/delete/scratch.ts)_
 
 ## `sf org disable tracking`
 
-Disable source tracking in local auth file.
+Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
 
 ```
 USAGE
   $ sf org disable tracking -o <value> [--json]
 
 FLAGS
-  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org. Not required if the `target-org`
+                            configuration variable is already set.
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Disable source tracking in local auth file.
+  Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
 
-  This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that no source
-  tracking operations are executed when working with this org.
+  Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically,
+  Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are
+  executed when working with the org.
 
 EXAMPLES
-  Disable tracking on an org using an alias
-  - sf org disable tracking -o someAlias
-  Disable tracking on an org using a username
-  - sf org disable tracking -o you@example.com
-  Disable tracking on your default org
-  - sf org disable tracking
+  Disable source tracking for an org with alias "myscratch":
+
+    $ sf org disable tracking --target-org myscratch
+
+  Disable source tracking for an org using a username:
+
+    $ sf org disable tracking --target-org you@example.com
+
+  Disable source tracking for your default org:
+
+    $ sf org disable tracking
 ```
 
-_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/disable/tracking.ts)_
+_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/disable/tracking.ts)_
 
 ## `sf org display`
 
@@ -666,7 +676,8 @@ USAGE
   $ sf org display -o <value> [--json] [--api-version <value>] [--verbose]
 
 FLAGS
-  -o, --target-org=<value>   (required) Username or alias of the target org.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
       --api-version=<value>  Override the api version used for api requests made by this command
       --verbose              Display the sfdxAuthUrl property.
 
@@ -698,40 +709,48 @@ EXAMPLES
     $ sf org display --target-org TestOrg1 --verbose
 ```
 
-_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/display.ts)_
+_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/display.ts)_
 
 ## `sf org enable tracking`
 
-Enable source tracking in local auth file.
+Allow Salesforce CLI to track changes in your source files between your project and an org.
 
 ```
 USAGE
   $ sf org enable tracking -o <value> [--json]
 
 FLAGS
-  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -o, --target-org=<value>  (required) Username or alias of the target org. Not required if the `target-org`
+                            configuration variable is already set.
 
 GLOBAL FLAGS
   --json  Format output as json.
 
 DESCRIPTION
-  Enable source tracking in local auth file.
+  Allow Salesforce CLI to track changes in your source files between your project and an org.
 
-  This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that source
-  tracking operations are executed when working with this org.
+  Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically,
+  Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are
+  executed when working with the org.
 
-  This command will throw an error if the org does not support tracking.
+  This command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking
+  include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.
 
 EXAMPLES
-  Enable tracking on an org using an alias
-  - sf org enable tracking -o someAlias
-  Enable tracking on an org using a username
-  - sf org enable tracking -o you@example.com
-  Enable tracking on your default org
-  - sf org enable tracking
+  Enable source tracking for an org with alias "myscratch":
+
+    $ sf org enable tracking --target-org myscratch
+
+  Enable source tracking for an org using a username:
+
+    $ sf org enable tracking --target-org you@example.com
+
+  Enable source tracking for your default org:
+
+    $ sf org enable tracking
 ```
 
-_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/enable/tracking.ts)_
+_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/enable/tracking.ts)_
 
 ## `sf org list`
 
@@ -769,7 +788,7 @@ EXAMPLES
     $ sf org list --clean
 ```
 
-_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/list.ts)_
+_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/list.ts)_
 
 ## `sf org list metadata`
 
@@ -783,7 +802,8 @@ FLAGS
   -f, --output-file=<value>    Pathname of the file in which to write the results.
   -m, --metadata-type=<value>  (required) Metadata type to be retrieved, such as CustomObject; metadata type names are
                                case-sensitive.
-  -o, --target-org=<value>     (required) Username or alias of the target org.
+  -o, --target-org=<value>     (required) Username or alias of the target org. Not required if the `target-org`
+                               configuration variable is already set.
       --api-version=<value>    API version to use; default is the most recent API version.
       --folder=<value>         Folder associated with the component; required for components that use folders; folder
                                names are case-sensitive.
@@ -833,7 +853,7 @@ FLAG DESCRIPTIONS
     Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.
 ```
 
-_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/list/metadata.ts)_
+_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/list/metadata.ts)_
 
 ## `sf org list metadata-types`
 
@@ -845,7 +865,8 @@ USAGE
 
 FLAGS
   -f, --output-file=<value>  Pathname of the file in which to write the results.
-  -o, --target-org=<value>   (required) Username or alias of the target org.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
       --api-version=<value>  API version to use; default is the most recent API version.
 
 GLOBAL FLAGS
@@ -886,7 +907,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/list/metadata-types.ts)_
+_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/list/metadata-types.ts)_
 
 ## `sf org open`
 
@@ -901,7 +922,8 @@ FLAGS
   -b, --browser=<option>     Browser where the org opens.
                              <options: chrome|edge|firefox>
   -f, --source-file=<value>  Path to an ApexPage or FlexiPage to open in Lightning App Builder.
-  -o, --target-org=<value>   (required) Username or alias of the target org.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
   -p, --path=<value>         Navigation URL path to open a specific page.
   -r, --url-only             Display navigation URL, but don’t launch browser.
       --api-version=<value>  Override the api version used for api requests made by this command
@@ -951,7 +973,7 @@ EXAMPLES
     $ sf org open --source-file force-app/main/default/flows/Hello.flow-meta.xml
 ```
 
-_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/open.ts)_
+_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/open.ts)_
 
 ## `sf org resume sandbox`
 
@@ -1013,7 +1035,7 @@ FLAG DESCRIPTIONS
     returns the job ID. To resume checking the sandbox creation, rerun this command.
 ```
 
-_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/resume/sandbox.ts)_
+_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/resume/sandbox.ts)_
 
 ## `sf org resume scratch`
 
@@ -1059,6 +1081,6 @@ FLAG DESCRIPTIONS
     The job ID is valid for 24 hours after you start the scratch org creation.
 ```
 
-_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.6/src/commands/org/resume/scratch.ts)_
+_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.8/src/commands/org/resume/scratch.ts)_
 
 <!-- commandsstop -->

package/messages/org.disable.tracking.md

@@ -1,24 +1,24 @@
 # summary
 
-Disable source tracking in local auth file.
+Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
 
 # description
 
-This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that no source tracking operations are executed when working with this org.
+Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.
 
 # examples
 
-Disable tracking on an org using an alias
+- Disable source tracking for an org with alias "myscratch":
 
-- <%= config.bin %> <%= command.id %> -o someAlias
+  <%= config.bin %> <%= command.id %> --target-org myscratch
 
-Disable tracking on an org using a username
+- Disable source tracking for an org using a username:
 
-- <%= config.bin %> <%= command.id %> -o you@example.com
+  <%= config.bin %> <%= command.id %> --target-org you@example.com
 
-Disable tracking on your default org
+- Disable source tracking for your default org:
 
-- <%= config.bin %> <%= command.id %>
+  <%= config.bin %> <%= command.id %>
 
 # success
 

package/messages/org.enable.tracking.md

@@ -1,26 +1,26 @@
 # summary
 
-Enable source tracking in local auth file.
+Allow Salesforce CLI to track changes in your source files between your project and an org.
 
 # description
 
-This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that source tracking operations are executed when working with this org.
+Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.
 
-This command will throw an error if the org does not support tracking.
+This command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.
 
 # examples
 
-Enable tracking on an org using an alias
+- Enable source tracking for an org with alias "myscratch":
 
-- <%= config.bin %> <%= command.id %> -o someAlias
+  <%= config.bin %> <%= command.id %> --target-org myscratch
 
-Enable tracking on an org using a username
+- Enable source tracking for an org using a username:
 
-- <%= config.bin %> <%= command.id %> -o you@example.com
+  <%= config.bin %> <%= command.id %> --target-org you@example.com
 
-Enable tracking on your default org
+- Enable source tracking for your default org:
 
-- <%= config.bin %> <%= command.id %>
+  <%= config.bin %> <%= command.id %>
 
 # success
 
@@ -28,12 +28,12 @@ Enabled source tracking for %s.
 
 # error.TrackingNotAvailable
 
-This org cannot enable source tracking because the SourceMember object is not available, or you do not have access to it.
+You can't enable source tracking on this org because the SourceMember Tooling API object isn't available, or you don't have access to it.
 
 # error.TrackingNotAvailable.actions
 
-- If the org is a sandbox, make sure that your production org has Source Tracking enabled in sandboxes. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_source_tracking_sandboxes.htm.
+- If the org is a Developer or Developer Pro sandbox, make sure that the associated production org has enabled source tracking in sandboxes. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_source_tracking_sandboxes.htm.
 
-- Make sure that your user can access the SourceMembers table via the tooling API.
+- Make sure that your user can access the SourceMember Tooling API object.
 
-- If the Org is a production org, source tracking cannot be enabled.
+- You can't enable source tracking on Developer Edition orgs, production orgs, Partial Copy sandboxes, or Full sandboxes.

package/oclif.lock

@@ -961,7 +961,7 @@
   resolved "https://registry.yarnpkg.com/@pkgjs/parseargs/-/parseargs-0.11.0.tgz#a77ea742fab25775145434eb1d2328cf5013ac33"
   integrity sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==
 
-"@salesforce/cli-plugins-testkit@^5.0.4":
+"@salesforce/cli-plugins-testkit@^5.0.3":
   version "5.0.4"
   resolved "https://registry.yarnpkg.com/@salesforce/cli-plugins-testkit/-/cli-plugins-testkit-5.0.4.tgz#523c459f43822d7b24bff5117aeda7f77ed5e26c"
   integrity sha512-8pquViVBCd5sF6nBXgLgwymEBE6pSAS376R9qq7rxuV+PSFCC5bnzQaKm2ugY+s5vXKNcV6WcmBHNCQnGv+M7Q==
@@ -1104,13 +1104,13 @@
     chalk "^4"
     inquirer "^8.2.5"
 
-"@salesforce/sf-plugins-core@^5.0.1":
-  version "5.0.1"
-  resolved "https://registry.yarnpkg.com/@salesforce/sf-plugins-core/-/sf-plugins-core-5.0.1.tgz#16b085eda99e28f2607957954d6ac957a8d0a0eb"
-  integrity sha512-gKUhAP9DDUlB4bjr0a6bsWiM16hn/n1cW8BglhYHAow8UJ0OQBxx+dfvAO0ftXmfzg82IZdMViiDmQXt0Z+e6A==
+"@salesforce/sf-plugins-core@^5.0.3":
+  version "5.0.3"
+  resolved "https://registry.yarnpkg.com/@salesforce/sf-plugins-core/-/sf-plugins-core-5.0.3.tgz#a771dc887c0a13ac23a5b1c16a6965791914f3aa"
+  integrity sha512-D+RCUzrYIWpJakNfxtHXJd6LZr6bK4gA4e7jLPR1G1FmDFss13PT7hOdFRxmAqTPbcp1jf65vwYZzu5nbqzmvQ==
   dependencies:
     "@oclif/core" "^3.11.0"
-    "@salesforce/core" "^6.1.0"
+    "@salesforce/core" "^6.1.3"
     "@salesforce/kit" "^3.0.15"
     "@salesforce/ts-types" "^2.0.9"
     "@types/inquirer" "^8.2.3"

package/oclif.manifest.json

@@ -29,7 +29,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -227,7 +227,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -374,7 +374,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -523,7 +523,7 @@
           "name": "target-dev-hub",
           "noCacheDefault": true,
           "required": false,
-          "summary": "Username or alias of the Dev Hub org.",
+          "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"
@@ -805,7 +805,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -1485,9 +1485,11 @@
     "org:disable:tracking": {
       "aliases": [],
       "args": {},
-      "description": "This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that no source tracking operations are executed when working with this org.",
+      "description": "Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.",
       "examples": [
-        "Disable tracking on an org using an alias\n\n- <%= config.bin %> <%= command.id %> -o someAlias\n\nDisable tracking on an org using a username\n\n- <%= config.bin %> <%= command.id %> -o you@example.com\n\nDisable tracking on your default org\n\n- <%= config.bin %> <%= command.id %>"
+        "Disable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
+        "Disable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
+        "Disable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -1502,7 +1504,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -1515,7 +1517,7 @@
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Disable source tracking in local auth file.",
+      "summary": "Prevent Salesforce CLI from tracking changes in your source files between your project and an org.",
       "enableJsonFlag": true,
       "SF_ENV": "SF_ENV",
       "isESM": true,
@@ -1539,9 +1541,11 @@
     "org:enable:tracking": {
       "aliases": [],
       "args": {},
-      "description": "This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that source tracking operations are executed when working with this org.\n\nThis command will throw an error if the org does not support tracking.",
+      "description": "Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.\n\nThis command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.",
       "examples": [
-        "Enable tracking on an org using an alias\n\n- <%= config.bin %> <%= command.id %> -o someAlias\n\nEnable tracking on an org using a username\n\n- <%= config.bin %> <%= command.id %> -o you@example.com\n\nEnable tracking on your default org\n\n- <%= config.bin %> <%= command.id %>"
+        "Enable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
+        "Enable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
+        "Enable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -1556,7 +1560,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -1569,7 +1573,7 @@
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Enable source tracking in local auth file.",
+      "summary": "Allow Salesforce CLI to track changes in your source files between your project and an org.",
       "enableJsonFlag": true,
       "SF_ENV": "SF_ENV",
       "isESM": true,
@@ -1642,7 +1646,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -1761,7 +1765,7 @@
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the target org.",
+          "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"
@@ -2011,5 +2015,5 @@
       ]
     }
   },
-  "version": "3.0.6"
+  "version": "3.0.8"
 }

package/package.json

@@ -1,20 +1,20 @@
 {
     "name": "@salesforce/plugin-org",
     "description": "Commands to interact with Salesforce orgs",
-    "version": "3.0.6",
+    "version": "3.0.8",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
         "@oclif/core": "^3.10.8",
         "@salesforce/core": "^6.1.3",
         "@salesforce/kit": "^3.0.15",
-        "@salesforce/sf-plugins-core": "^5.0.1",
+        "@salesforce/sf-plugins-core": "^5.0.3",
         "@salesforce/source-deploy-retrieve": "^10.0.0",
         "open": "^9.1.0"
     },
     "devDependencies": {
         "@oclif/plugin-command-snapshot": "^5.0.2",
-        "@salesforce/cli-plugins-testkit": "^5.0.4",
+        "@salesforce/cli-plugins-testkit": "^5.0.3",
         "@salesforce/dev-scripts": "^7.1.1",
         "@salesforce/plugin-command-reference": "^3.0.46",
         "@salesforce/ts-sinon": "1.4.19",
@@ -72,10 +72,10 @@
                         "description": "Delete scratch orgs, sandboxes, org shapes, and org snapshots."
                     },
                     "enable": {
-                        "description": "Enable tracking on an org."
+                        "description": "Enable source tracking in an org."
                     },
                     "disable": {
-                        "description": "Disable tracking on an org"
+                        "description": "Disable source tracking in an org."
                     }
                 },
                 "external": true
@@ -224,7 +224,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.6.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.6.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.8.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.8.sig"
     }
 }