@salesforce/plugin-org 3.0.6 → 3.0.7

package/README.md

@@ -162,7 +162,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.7/src/commands/force/org/clone.ts)_
 
 ## `sf force org create`
 
@@ -210,7 +210,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.7/src/commands/force/org/create.ts)_
 
 ## `sf force org delete`
 
@@ -242,7 +242,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.7/src/commands/force/org/delete.ts)_
 
 ## `sf force org status`
 
@@ -280,7 +280,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.7/src/commands/force/org/status.ts)_
 
 ## `sf org create sandbox`
 
@@ -385,7 +385,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.7/src/commands/org/create/sandbox.ts)_
 
 ## `sf org create scratch`
 
@@ -538,7 +538,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.7/src/commands/org/create/scratch.ts)_
 
 ## `sf org delete sandbox`
 
@@ -582,7 +582,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.7/src/commands/org/delete/sandbox.ts)_
 
 ## `sf org delete scratch`
 
@@ -624,11 +624,11 @@ 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.7/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
@@ -641,21 +641,27 @@ 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.7/src/commands/org/disable/tracking.ts)_
 
 ## `sf org display`
 
@@ -698,11 +704,11 @@ 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.7/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
@@ -715,23 +721,30 @@ 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.7/src/commands/org/enable/tracking.ts)_
 
 ## `sf org list`
 
@@ -769,7 +782,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.7/src/commands/org/list.ts)_
 
 ## `sf org list metadata`
 
@@ -833,7 +846,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.7/src/commands/org/list/metadata.ts)_
 
 ## `sf org list metadata-types`
 
@@ -886,7 +899,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.7/src/commands/org/list/metadata-types.ts)_
 
 ## `sf org open`
 
@@ -951,7 +964,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.7/src/commands/org/open.ts)_
 
 ## `sf org resume sandbox`
 
@@ -1013,7 +1026,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.7/src/commands/org/resume/sandbox.ts)_
 
 ## `sf org resume scratch`
 
@@ -1059,6 +1072,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.7/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==

package/oclif.manifest.json

@@ -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": {
@@ -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": {
@@ -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,
@@ -2011,5 +2015,5 @@
       ]
     }
   },
-  "version": "3.0.6"
+  "version": "3.0.7"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-org",
     "description": "Commands to interact with Salesforce orgs",
-    "version": "3.0.6",
+    "version": "3.0.7",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
@@ -14,7 +14,7 @@
     },
     "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.7.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.7.sig"
     }
 }