Merge pull request #514 from salesforcecli/ashreya/command-enhancements

@W-22503184 - Add and restructure devops commands

Author: soridalac

command-snapshot.json

@@ -7,22 +7,15 @@
     "flags": ["api-version", "flags-dir", "json", "pipeline-id", "target-org"],
     "plugin": "@salesforce/plugin-devops-center"
   },
-  {
-    "alias": [],
-    "command": "devops:pipeline:attach-project",
-    "flagAliases": [],
-    "flagChars": ["o"],
-    "flags": ["api-version", "flags-dir", "json", "pipeline-id", "project-id", "target-org"],
-    "plugin": "@salesforce/plugin-devops-center"
-  },
   {
     "alias": [],
     "command": "devops:pipeline:create",
     "flagAliases": [],
     "flagChars": ["d", "n", "o", "r"],
     "flags": [
       "api-version",
-      "bitbucket-project",
+      "bitbucket-project-key",
+      "bitbucket-workspace",
       "create-repo",
       "description",
       "flags-dir",
@@ -35,6 +28,14 @@
     ],
     "plugin": "@salesforce/plugin-devops-center"
   },
+  {
+    "alias": [],
+    "command": "devops:pipeline:project:add",
+    "flagAliases": [],
+    "flagChars": ["o"],
+    "flags": ["api-version", "flags-dir", "json", "pipeline-id", "project-id", "target-org"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
   {
     "alias": [],
     "command": "devops:pipeline:stage:add",
@@ -64,12 +65,12 @@
     "command": "devops:pull-request:create",
     "flagAliases": [],
     "flagChars": ["n", "o", "w"],
-    "flags": ["api-version", "body", "flags-dir", "json", "target-org", "title", "work-item-id", "work-item-name"],
+    "flags": ["api-version", "flags-dir", "json", "target-org", "work-item-id", "work-item-name"],
     "plugin": "@salesforce/plugin-devops-center"
   },
   {
     "alias": [],
-    "command": "devops:stage:add-branch",
+    "command": "devops:stage:branch:add",
     "flagAliases": [],
     "flagChars": ["b", "o"],
     "flags": [
@@ -86,7 +87,7 @@
   },
   {
     "alias": [],
-    "command": "devops:stage:add-environment",
+    "command": "devops:stage:environment:add",
     "flagAliases": [],
     "flagChars": ["e", "o"],
     "flags": [
@@ -120,10 +121,20 @@
   },
   {
     "alias": [],
-    "command": "devops:work-item:status:update",
+    "command": "devops:work-item:update",
     "flagAliases": [],
     "flagChars": ["n", "o", "w"],
-    "flags": ["api-version", "flags-dir", "json", "status", "target-org", "work-item-id", "work-item-name"],
+    "flags": [
+      "api-version",
+      "description",
+      "flags-dir",
+      "json",
+      "status",
+      "subject",
+      "target-org",
+      "work-item-id",
+      "work-item-name"
+    ],
     "plugin": "@salesforce/plugin-devops-center"
   },
   {

messages/devops.pipeline.create.md

@@ -28,11 +28,15 @@ Create a repository if it doesn't exist.
 
 # flags.repo-owner.summary
 
-Owner (organization or user) of the repository. Required when creating a repository using '--create-repo'.
+Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.
 
-# flags.bitbucket-project.summary
+# flags.bitbucket-workspace.summary
 
-Bitbucket project key for the repository. Used when creating a Bitbucket repository with '--create-repo'.
+Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.
+
+# flags.bitbucket-project-key.summary
+
+Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.
 
 # flags.description.summary
 
@@ -48,14 +52,26 @@ Description of the pipeline.
 
       <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "Release Pipeline" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo
 
-- Create a pipeline with a description and associate it with a Bitbucket repository.
+- Create a pipeline and create a new Bitbucket repository.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "Release Pipeline" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo
 
-      <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "Release Pipeline" --repo https://bitbucket.org/myorg/myrepo --description "Main CI/CD pipeline for production releases"
+- Create a pipeline with a description and associate it with an existing Bitbucket repository.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "Release Pipeline" --repo https://bitbucket.org/myworkspace/myrepo --description "Main CI/CD pipeline for production releases"
 
 # error.RepoTypeRequired
 
 The --repo-type flag is required when using --create-repo. Specify --repo-type github or --repo-type bitbucket.
 
+# error.RepoOwnerNotFound
+
+The repository "%s" could not be initialized because the --repo-owner does not exist or is not accessible on GitHub. Verify the --repo-owner value is a valid GitHub organization or user.
+
+# error.RepoNameAlreadyExists
+
+A repository named "%s" already exists on this account. Choose a different name or use the existing repository URL with --repo instead of --create-repo.
+
 # error.RepoCreationFailed
 
 Failed to create repository "%s". Verify the --repo-owner has permission to create repositories and the repository name is available. Details: %s
@@ -70,7 +86,11 @@ Failed to validate repository "%s". When using an existing repository, provide t
 
 # error.RepoOwnerRequired
 
-The --repo-owner flag is required when using --create-repo. Specify the GitHub or Bitbucket organization or user that will own the repository.
+The --repo-owner flag is required when creating a GitHub repository with --create-repo. Specify the GitHub organization or user that will own the repository.
+
+# error.BitbucketWorkspaceRequired
+
+The --bitbucket-workspace flag is required when creating a Bitbucket repository with --create-repo. Specify the Bitbucket workspace that will own the repository.
 
 # error.VcsCredentialsMissing
 

…ssages/devops.pipeline.attach-project.md messages/devops.pipeline.project.add.mdmessages/devops.pipeline.attach-project.md renamed to messages/devops.pipeline.project.add.md messages/devops.pipeline.attach-project.md renamed to messages/devops.pipeline.project.add.md

@@ -4,7 +4,7 @@ Create a pull request for a work item branch.
 
 # description
 
-The pull request title defaults to the work item subject. The work item must have an associated branch and repository. Requires VCS authentication: set GITHUB_TOKEN (or use `gh auth login`) for GitHub, or set BITBUCKET_TOKEN for Bitbucket.
+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
 
@@ -14,44 +14,20 @@ Name of the work item, such as WI-000001.
 
 ID of the work item.
 
-# flags.title.summary
-
-Title of the pull request.
-
-# flags.body.summary
+# flags.target-org.summary
 
-Description of the pull request.
+Username or alias of the DevOps Center org.
 
 # examples
 
-- Create a pull request for a work item using the default title.
+- 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 with a custom title and description.
+- Create a pull request using the work item ID.
 
-      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --title "Fix: Login timeout" --body "Resolves the 30s timeout on the login page"
+      <%= 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.
-
-# error.NoRepo
-
-Work item %s doesn't have an associated repository. Verify the project is connected to a source control repository and try again.
-
-# error.NoTargetBranch
-
-Unable to determine the target branch for work item %s. Verify the pipeline stages are configured correctly.
-
-# error.NoProvider
-
-Unable to determine the VCS provider for work item %s. Verify the project is connected to a supported source control provider (GitHub or Bitbucket).
-
-# flags.target-org.summary
-
-Username or alias of the DevOps Center org.
-
-# error.NoToken
-
-No authentication token found for %s. For GitHub, set the GITHUB_TOKEN environment variable or run "gh auth login". For Bitbucket, set the BITBUCKET_TOKEN environment variable.

messages/devops.pull-request.create.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.

messages/devops.stage.add-branch.md messages/devops.stage.branch.add.mdmessages/devops.stage.add-branch.md renamed to messages/devops.stage.branch.add.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.

messages/devops.stage.add-environment.md messages/devops.stage.environment.add.mdmessages/devops.stage.add-environment.md renamed to messages/devops.stage.environment.add.md

@@ -11,9 +11,6 @@
         "workItemName": {
           "type": "string"
         },
-        "title": {
-          "type": "string"
-        },
         "url": {
           "type": "string"
         },