@salesforce/plugin-devops-center 1.3.0 → 1.4.1

package/messages/devops.promotion.complete.md

@@ -0,0 +1,47 @@
+# summary
+
+Deploy undeployed work items to a pipeline stage org.
+
+# description
+
+Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the "Complete Promotion" action in the DevOps Center UI when a stage is out of sync.
+
+If no undeployed work items are found for the stage, the command exits successfully with no action taken.
+
+# flags.target-stage-id.summary
+
+ID of the out-of-sync pipeline stage to deploy to.
+
+# flags.work-item-id.summary
+
+ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.
+
+# examples
+
+- Complete a promotion for an out-of-sync pipeline stage.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001
+
+- Complete a promotion for a specific work item (e.g. first stage of a pipeline).
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001
+
+- Complete a promotion with full deploy and a specific test level.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests
+
+# info.NothingToDeploy
+
+No undeployed work items found for this stage.
+
+# error.StageNotFound
+
+Stage '%s' not found or has no associated pipeline.
+
+# error.ValidationFailed
+
+Pre-flight validation failed. Error type: %s. Details: %s
+
+# error.DeployFailed
+
+Deploy request failed: %s

package/messages/devops.request.status.md

@@ -0,0 +1,21 @@
+# summary
+
+Get the status of a request.
+
+# description
+
+Returns the current status of a request identified by its request token.
+
+# flags.request-token.summary
+
+Request token from the promote response.
+
+# examples
+
+- Get the status of a request:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001
+
+# error.RequestNotFound
+
+Request %s not found. Check the request token and try again.

package/messages/devops.review.create.md

@@ -0,0 +1,33 @@
+# summary
+
+Create a pull request for a work item branch.
+
+# description
+
+Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.
+
+# flags.work-item-name.summary
+
+Name of the work item, such as WI-000001.
+
+# flags.work-item-id.summary
+
+ID of the work item.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# examples
+
+- Create a pull request for a work item.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001
+
+- Create a pull request using the work item ID.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001
+
+# error.NoBranch
+
+Work item %s doesn't have an associated branch. Mark the work item as In Progress to create a branch, then try again.

package/messages/{devops.stage.add-environment.md → devops.stage.environment.add.md}

@@ -48,6 +48,10 @@ Waiting for authentication to complete...
 
 Successfully added environment to the stage.
 
+# error.PipelineAlreadyActive
+
+Pipeline %s is already active. Environments can only be added to inactive pipelines.
+
 # error.StageNotFound
 
 Pipeline stage "%s" doesn't exist in pipeline "%s". Check the stage ID and try again.

package/messages/devops.stage.environment.delete.md

@@ -0,0 +1,29 @@
+# summary
+
+Delete an environment from a DevOps Center pipeline stage.
+
+# description
+
+Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline. Used to verify the pipeline is inactive before deleting.
+
+# flags.environment-id.summary
+
+ID of the environment to delete.
+
+# examples
+
+- Delete an environment:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001
+
+# error.PipelineAlreadyActive
+
+Pipeline %s is already active. Environments can only be removed from inactive pipelines.
+
+# error.EnvironmentNotFound
+
+Environment %s not found. Check the environment ID and try again.

package/messages/devops.work-item.combine.md

@@ -0,0 +1,39 @@
+# summary
+
+Prepare work items to be combined for custom promotion.
+
+# description
+
+Use this command when work items in the same stage share metadata or have dependencies. DevOps Center combines the selected work items so they can be promoted together during custom promotion.
+
+After running this command, use "sf devops work-item promote" with the parent work item ID to complete the promotion. The combined work items are promoted as a single unit.
+
+# flags.parent-work-item-id.summary
+
+ID of the parent work item.
+
+# flags.parent-work-item-id.description
+
+The parent work item is the primary work item that continues through the pipeline. Changes from all child work items are merged into the parent's branch during promotion.
+
+# flags.child-work-item-id.summary
+
+ID of a work item to combine.
+
+# flags.child-work-item-id.description
+
+Specify this flag multiple times to combine multiple work items with the parent.
+
+# flags.target-stage-id.summary
+
+ID of the pipeline stage to promote the combined work item to.
+
+# examples
+
+- Prepare three work items to be combined to prevent conflicts during promotion:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --parent-work-item-id 0Wx000000000001 --child-work-item-id 0Wx000000000002 --child-work-item-id 0Wx000000000003 --target-stage-id 05S000000000002
+
+# error.NoPipeline
+
+No pipeline found for this project. Make sure the project has an associated pipeline.

package/messages/devops.work-item.prepare.md

@@ -0,0 +1,27 @@
+# summary
+
+Prepare a work item for one-off promotion between pipeline stages.
+
+# description
+
+Prepares a work item for one-off promotion by creating the necessary branches and pull requests in the source control repository. Run this command before running "sf devops work-item promote" for a one-off promotion.
+
+Use "sf devops work-item list" to find the work item ID and target stage ID for a project.
+
+# flags.work-item-id.summary
+
+ID of the work item to prepare for one-off promotion.
+
+# flags.target-stage-id.summary
+
+ID of the pipeline stage to promote the work item to.
+
+# examples
+
+- Prepare a work item for one-off promotion to the UAT stage:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --target-stage-id 05S000000000002
+
+- Prepare a work item using a DevOps Center org username:
+
+      <%= config.bin %> <%= command.id %> --target-org devops-center@example.com --work-item-id 0Wx000000000001 --target-stage-id 05S000000000002

package/messages/devops.work-item.update.md

@@ -0,0 +1,45 @@
+# summary
+
+Update a work item in DevOps Center.
+
+# description
+
+Update the subject, description, or status of a work item. At least one of --subject, --description, or --status must be provided.
+
+# flags.work-item-name.summary
+
+Name of the work item, such as WI-000001.
+
+# flags.work-item-id.summary
+
+ID of the work item.
+
+# flags.subject.summary
+
+New subject for the work item.
+
+# flags.description.summary
+
+New description for the work item.
+
+# flags.status.summary
+
+New status for the work item. Allowed values: "In Progress", "Ready to Promote".
+
+# examples
+
+- Update the subject of a work item by name:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --subject "Fix login bug"
+
+- Update the status of a work item by ID:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status "In Progress"
+
+- Update multiple fields at once:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --subject "Fix login bug" --description "Users can't log in on mobile" --status "In Progress"
+
+# error.NoFieldsProvided
+
+Provide at least one of --subject, --description, or --status.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/plugin-devops-center",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/plugin-devops-center",
-      "version": "1.3.0",
+      "version": "1.4.1",
       "license": "Apache-2.0",
       "dependencies": {
         "@jsforce/jsforce-node": "^3",
@@ -14,8 +14,7 @@
         "@salesforce/core": "^8.2.7",
         "@salesforce/kit": "^3.2.3",
         "@salesforce/sf-plugins-core": "^12",
-        "@salesforce/ts-types": "^2.0.11",
-        "chalk": "^5"
+        "@salesforce/ts-types": "^2.0.11"
       },
       "devDependencies": {
         "@oclif/plugin-command-snapshot": "^5.2.3",
@@ -31,7 +30,7 @@
         "typescript": "^5.7.2"
       },
       "engines": {
-        "node": ">=18.0.0"
+        "node": ">=22.0.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -1537,23 +1536,6 @@
         "node": ">=v14"
       }
     },
-    "node_modules/@commitlint/format/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/@commitlint/is-ignored": {
       "version": "17.8.1",
       "resolved": "https://registry.npmjs.org/@commitlint/is-ignored/-/is-ignored-17.8.1.tgz",
@@ -1646,23 +1628,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/@commitlint/load/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/@commitlint/load/node_modules/cosmiconfig-typescript-loader": {
       "version": "4.4.0",
       "resolved": "https://registry.npmjs.org/cosmiconfig-typescript-loader/-/cosmiconfig-typescript-loader-4.4.0.tgz",
@@ -1885,23 +1850,6 @@
         "node": ">=v14"
       }
     },
-    "node_modules/@commitlint/types/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/@cspotcode/source-map-support": {
       "version": "0.8.1",
       "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz",
@@ -3532,36 +3480,6 @@
         "node": ">=18.0.0"
       }
     },
-    "node_modules/@oclif/test/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
-    "node_modules/@oclif/test/node_modules/chalk/node_modules/supports-color": {
-      "version": "7.2.0",
-      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
-      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "has-flag": "^4.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
     "node_modules/@oclif/test/node_modules/js-yaml": {
       "version": "3.14.2",
       "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
@@ -3859,23 +3777,6 @@
         "sf-prepack": "bin/sf-prepack.js"
       }
     },
-    "node_modules/@salesforce/dev-scripts/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/@salesforce/kit": {
       "version": "3.2.6",
       "resolved": "https://registry.npmjs.org/@salesforce/kit/-/kit-3.2.6.tgz",
@@ -6986,12 +6887,16 @@
       }
     },
     "node_modules/chalk": {
-      "version": "5.6.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
-      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
       "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
       "engines": {
-        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+        "node": ">=10"
       },
       "funding": {
         "url": "https://github.com/chalk/chalk?sponsor=1"
@@ -8768,23 +8673,6 @@
         "url": "https://opencollective.com/eslint"
       }
     },
-    "node_modules/eslint/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/eslint/node_modules/find-up": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
@@ -10559,6 +10447,18 @@
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
       }
     },
+    "node_modules/ink/node_modules/chalk": {
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
     "node_modules/ink/node_modules/emoji-regex": {
       "version": "10.3.0",
       "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.3.0.tgz",
@@ -11270,22 +11170,6 @@
         "node": ">=10"
       }
     },
-    "node_modules/jake/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/joycon": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/joycon/-/joycon-3.1.1.tgz",
@@ -11654,6 +11538,19 @@
         "node": ">=18"
       }
     },
+    "node_modules/linkinator/node_modules/chalk": {
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
     "node_modules/linkinator/node_modules/glob": {
       "version": "10.3.10",
       "resolved": "https://registry.npmjs.org/glob/-/glob-10.3.10.tgz",
@@ -11875,23 +11772,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/log-symbols/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/lolex": {
       "version": "2.7.5",
       "resolved": "https://registry.npmjs.org/lolex/-/lolex-2.7.5.tgz",
@@ -13005,23 +12885,6 @@
         "node": ">=18.0.0"
       }
     },
-    "node_modules/oclif/node_modules/chalk": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/chalk?sponsor=1"
-      }
-    },
     "node_modules/oclif/node_modules/hosted-git-info": {
       "version": "7.0.2",
       "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-7.0.2.tgz",

package/oclif.lock

@@ -3484,7 +3484,7 @@ chalk@^4, chalk@^4.0.0, chalk@^4.0.2, chalk@^4.1.0, chalk@^4.1.2:
     ansi-styles "^4.1.0"
     supports-color "^7.1.0"
 
-chalk@^5, chalk@^5.0.0, chalk@^5.3.0:
+chalk@^5.0.0, chalk@^5.3.0:
   version "5.6.2"
   resolved "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz"
   integrity sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==