chore: create pull request command

Author: ad-shreya

messages/devops.pull-request.create.md

@@ -0,0 +1,57 @@
+# summary
+
+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.
+
+# 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.title.summary
+
+Title of the pull request.
+
+# flags.body.summary
+
+Description of the pull request.
+
+# examples
+
+- Create a pull request for a work item using the default title.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001
+
+- Create a pull request with a custom title and description.
+
+      <%= 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"
+
+# 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.

package.json

@@ -21,8 +21,6 @@
     "@salesforce/dev-scripts": "^11",
     "@salesforce/plugin-command-reference": "^3.1.38",
     "@salesforce/ts-sinon": "^1.4.30",
-    "@types/chai": "^5.2.3",
-    "chai": "^6.2.2",
     "eslint-plugin-sf-plugin": "^1.20.13",
     "esmock": "^2.7.6",
     "oclif": "^4",
@@ -91,6 +89,9 @@
                 "description": "Commands for managing DevOps Center work item statuses."
               }
             }
+          },
+          "pull-request": {
+            "description": "Commands for managing DevOps Center pull requests."
           }
         }
       }

src/commands/devops/pull-request/create.ts

@@ -0,0 +1,124 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Messages, Org } from '@salesforce/core';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import {
+  createPullRequest,
+  CreatePullRequestResult,
+  fetchWorkItemDetail,
+  resolveGitHubToken,
+  WorkItemDetail,
+} from '../../../utils/createPullRequest.js';
+
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-devops-center', 'devops.pull-request.create');
+const commonErrorMessages = Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+
+export default class DevopsPullRequestCreate extends SfCommand<CreatePullRequestResult> {
+  public static readonly summary = messages.getMessage('summary');
+  public static readonly description = messages.getMessage('description');
+  public static readonly examples = messages.getMessages('examples');
+
+  public static readonly flags = {
+    'target-org': Flags.requiredOrg({
+      char: 'o',
+      summary: messages.getMessage('flags.target-org.summary'),
+      required: true,
+    }),
+    'api-version': Flags.orgApiVersion(),
+    'work-item-name': Flags.string({
+      summary: messages.getMessage('flags.work-item-name.summary'),
+      char: 'n',
+      exactlyOne: ['work-item-name', 'work-item-id'],
+    }),
+    'work-item-id': Flags.salesforceId({
+      summary: messages.getMessage('flags.work-item-id.summary'),
+      char: 'w',
+      exactlyOne: ['work-item-name', 'work-item-id'],
+    }),
+    title: Flags.string({
+      summary: messages.getMessage('flags.title.summary'),
+    }),
+    body: Flags.string({
+      summary: messages.getMessage('flags.body.summary'),
+    }),
+  };
+
+  public async run(): Promise<CreatePullRequestResult> {
+    const { flags } = await this.parse(DevopsPullRequestCreate);
+    const org: Org = flags['target-org'];
+    const connection = org.getConnection(flags['api-version']);
+
+    const filter = flags['work-item-name'] ? { name: flags['work-item-name'] } : { id: flags['work-item-id']! };
+
+    let detail: WorkItemDetail;
+    try {
+      detail = await fetchWorkItemDetail(connection, filter);
+    } catch (error: unknown) {
+      const errMsg = error instanceof Error ? error.message : String(error);
+      if (errMsg.includes('sObject type') && errMsg.includes('is not supported')) {
+        this.error(commonErrorMessages.getMessage('error.DevopsCenterNotEnabled'));
+      }
+      throw error;
+    }
+
+    if (!detail.branchName) {
+      this.error(messages.getMessage('error.NoBranch', [detail.workItemName]));
+    }
+    if (!detail.repoOwner || !detail.repoName) {
+      this.error(messages.getMessage('error.NoRepo', [detail.workItemName]));
+    }
+    if (!detail.targetBranch) {
+      this.error(messages.getMessage('error.NoTargetBranch', [detail.workItemName]));
+    }
+    if (!detail.provider) {
+      this.error(messages.getMessage('error.NoProvider', [detail.workItemName]));
+    }
+
+    let token: string | undefined;
+    if (detail.provider === 'github') {
+      token = await resolveGitHubToken();
+    } else {
+      token = process.env.BITBUCKET_TOKEN;
+    }
+    if (!token) {
+      this.error(messages.getMessage('error.NoToken', [detail.provider]));
+    }
+
+    const prTitle = flags['title'] ?? detail.subject;
+
+    const result = await createPullRequest({
+      owner: detail.repoOwner,
+      repo: detail.repoName,
+      head: detail.branchName,
+      base: detail.targetBranch,
+      title: prTitle,
+      body: flags['body'],
+      provider: detail.provider,
+      token,
+    });
+
+    if (result.success) {
+      this.log(`Successfully created pull request for ${detail.workItemName}.`);
+      this.log(`  Title: ${result.title ?? prTitle}`);
+      this.log(`  URL: ${result.url ?? ''}`);
+      this.log(`  Source: ${detail.workItemName} → ${result.targetBranch ?? detail.targetBranch}`);
+    }
+
+    return result;
+  }
+}