chore(release): 5.7.0 [skip ci]

Author: svc-cli-bot

CHANGELOG.md

@@ -1,3 +1,15 @@
+# [5.7.0](https://github.com/salesforcecli/plugin-org/compare/5.6.3...5.7.0) (2025-04-21)
+
+### Bug Fixes
+
+- edit messages ([5801bc3](https://github.com/salesforcecli/plugin-org/commit/5801bc3f4e367dca382fc5962a09cabd529c8dd0))
+- refresh sandbox with sourceSandboxName ([77d04df](https://github.com/salesforcecli/plugin-org/commit/77d04df6133e566d49c856df9edc731ee1aa0c0c))
+- remove the char ([75d6df6](https://github.com/salesforcecli/plugin-org/commit/75d6df63d66eb14d2030d6d8705b7a2f5e83d4d7))
+
+### Features
+
+- add 'source-id' and 'source-sandbox-name' flags ([b926161](https://github.com/salesforcecli/plugin-org/commit/b926161b070981866f58a03188d9388765c7830f))
+
 ## [5.6.3](https://github.com/salesforcecli/plugin-org/compare/5.6.2...5.6.3) (2025-04-20)
 
 ### Bug Fixes

README.md

@@ -242,7 +242,7 @@ FLAG DESCRIPTIONS
     You can specify either --source-sandbox-name or --source-id when cloning an existing sandbox, but not both.
 ```
 
-_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/create/sandbox.ts)_
+_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/create/sandbox.ts)_
 
 ## `sf org create scratch`
 
@@ -424,7 +424,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/5.6.3/src/commands/org/create/scratch.ts)_
+_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/create/scratch.ts)_
 
 ## `sf org delete sandbox`
 
@@ -470,7 +470,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/5.6.3/src/commands/org/delete/sandbox.ts)_
+_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/delete/sandbox.ts)_
 
 ## `sf org delete scratch`
 
@@ -514,7 +514,7 @@ 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/5.6.3/src/commands/org/delete/scratch.ts)_
+_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/delete/scratch.ts)_
 
 ## `sf org disable tracking`
 
@@ -553,7 +553,7 @@ EXAMPLES
     $ sf org disable tracking
 ```
 
-_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/disable/tracking.ts)_
+_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/disable/tracking.ts)_
 
 ## `sf org display`
 
@@ -598,7 +598,7 @@ EXAMPLES
     $ sf org display --target-org TestOrg1 --verbose
 ```
 
-_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/display.ts)_
+_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/display.ts)_
 
 ## `sf org enable tracking`
 
@@ -640,7 +640,7 @@ EXAMPLES
     $ sf org enable tracking
 ```
 
-_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/enable/tracking.ts)_
+_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/enable/tracking.ts)_
 
 ## `sf org list`
 
@@ -679,7 +679,7 @@ EXAMPLES
     $ sf org list --clean
 ```
 
-_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/list.ts)_
+_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/list.ts)_
 
 ## `sf org list metadata`
 
@@ -746,7 +746,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/5.6.3/src/commands/org/list/metadata.ts)_
+_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/list/metadata.ts)_
 
 ## `sf org list metadata-types`
 
@@ -801,7 +801,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/5.6.3/src/commands/org/list/metadata-types.ts)_
+_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/list/metadata-types.ts)_
 
 ## `sf org open`
 
@@ -877,7 +877,7 @@ EXAMPLES
     $ sf org open --source-file force-app/main/default/bots/Coral_Cloud_Agent/Coral_Cloud_Agent.bot-meta.xml
 ```
 
-_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/open.ts)_
+_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/open.ts)_
 
 ## `sf org open agent`
 
@@ -928,7 +928,7 @@ EXAMPLES
     $ sf org open agent --target-org MyTestOrg1 --browser firefox --name Coral_Cloud_Agent
 ```
 
-_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/open/agent.ts)_
+_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/open/agent.ts)_
 
 ## `sf org refresh sandbox`
 
@@ -937,17 +937,21 @@ 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]
+    <seconds> | ] [--source-sandbox-name <value> | -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.
-  -i, --poll-interval=<seconds>  Number of seconds to wait between status polling requests.
-  -n, --name=<value>             Name of the existing sandbox org in your production org that you want to refresh.
-  -o, --target-org=<value>       (required) Username or alias of the production org that contains the sandbox license.
-  -w, --wait=<minutes>           Number of minutes to poll for sandbox refresh status.
-      --async                    Request the sandbox refresh, but don't wait for it to complete.
-      --no-auto-activate         Disable auto-activation of the sandbox after a successful refresh.
-      --no-prompt                Don't prompt for confirmation about the sandbox refresh.
+  -f, --definition-file=<value>      Path to a sandbox definition file for overriding its configuration when you refresh
+                                     it.
+  -i, --poll-interval=<seconds>      Number of seconds to wait between status polling requests.
+  -i, --source-id=<value>            ID of the sandbox org that becomes the new source org for the refreshed sandbox.
+  -n, --name=<value>                 Name of the existing sandbox org in your production org that you want to refresh.
+  -o, --target-org=<value>           (required) Username or alias of the production org that contains the sandbox
+                                     license.
+  -w, --wait=<minutes>               Number of minutes to poll for sandbox refresh status.
+      --async                        Request the sandbox refresh, but don't wait for it to complete.
+      --no-auto-activate             Disable auto-activation of the sandbox after a successful refresh.
+      --no-prompt                    Don't prompt for confirmation about the sandbox refresh.
+      --source-sandbox-name=<value>  Name of the sandbox org that becomes the new source org for the refreshed sandbox.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -958,7 +962,9 @@ DESCRIPTION
 
   Refreshing a sandbox copies the metadata, and optionally data, from your source org to the refreshed sandbox org. You
   can optionally specify a definition file if you want to change the configuration of the refreshed sandbox, such as its
-  license type or template ID.
+  license type or template ID. You can also use the --source-id or --source-sandbox-name flags to change the refreshed
+  sandbox org's original source org to a new org; in this case, the refreshed sandbox org's metadata is updated with the
+  new source org's metadata.
 
   You're not allowed to change the sandbox name when you refresh it with this command. If you want to change the sandbox
   name, first delete it with the "org delete sandbox" command. And then recreate it with the "org create sandbox"
@@ -980,6 +986,10 @@ EXAMPLES
 
     $ sf org refresh sandbox --definition-file devSbx3-config.json --target-org prodOrg
 
+  Refresh the sandbox named "devSbx2" by changing its original source org to be a sandbox called "devSbx3":
+
+    $ sf org refresh sandbox --name devSbx2 --source-sandbox-name devSbx3 --target-org prodOrg
+
 FLAG DESCRIPTIONS
   -f, --definition-file=<value>  Path to a sandbox definition file for overriding its configuration when you refresh it.
 
@@ -989,6 +999,14 @@ FLAG DESCRIPTIONS
     <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm> for all
     the options you can specify in the definition file.
 
+  -i, --source-id=<value>  ID of the sandbox org that becomes the new source org for the refreshed sandbox.
+
+    The value of --source-id must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified
+    with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox
+    licenses.
+
+    You can specify either --source-id or --source-sandbox-name when refreshing an existing sandbox, but not both.
+
   -w, --wait=<minutes>  Number of minutes to poll for sandbox refresh status.
 
     If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays
@@ -1003,9 +1021,17 @@ FLAG DESCRIPTIONS
   --no-auto-activate  Disable auto-activation of the sandbox after a successful refresh.
 
     By default, a sandbox auto-activates after a refresh. Use this flag to control sandbox activation manually.
+
+  --source-sandbox-name=<value>  Name of the sandbox org that becomes the new source org for the refreshed sandbox.
+
+    The value of --source-sandbox-name must be an existing sandbox. The new source sandbox, and the refreshed sandbox
+    specified with the --name flag, must both be associated with the production org (--target-org) that contains the
+    sandbox licenses.
+
+    You can specify either --source-sandbox-name or --source-id when refreshing an existing sandbox, but not both.
 ```
 
-_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/refresh/sandbox.ts)_
+_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/refresh/sandbox.ts)_
 
 ## `sf org resume sandbox`
 
@@ -1068,7 +1094,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/5.6.3/src/commands/org/resume/sandbox.ts)_
+_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/resume/sandbox.ts)_
 
 ## `sf org resume scratch`
 
@@ -1121,6 +1147,6 @@ FLAG DESCRIPTIONS
     returns the job ID. To resume checking the scratch creation, rerun this command.
 ```
 
-_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.6.3/src/commands/org/resume/scratch.ts)_
+_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.7.0/src/commands/org/resume/scratch.ts)_
 
 <!-- commandsstop -->

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-org",
   "description": "Commands to interact with Salesforce orgs",
-  "version": "5.6.3",
+  "version": "5.7.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {