@salesforce/plugin-devops-center 1.2.27 → 1.3.0

package/lib/utils/workItems.js

@@ -0,0 +1,181 @@
+/*
+ * 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 { computeFirstStageId, fetchPipelineStages, findStageById, getBranchNameFromStage, getPipelineIdForProject, resolveTargetStageId, } from './pipelineUtils.js';
+function normalizeProvider(provider) {
+    if (!provider)
+        return undefined;
+    const normalized = String(provider).toLowerCase();
+    if (normalized === 'bitbucketcloud') {
+        return 'bitbucket';
+    }
+    return normalized;
+}
+function providerToVcsType(provider) {
+    const normalized = normalizeProvider(provider);
+    if (normalized === 'github')
+        return 'GITHUB';
+    if (normalized === 'bitbucket')
+        return 'BITBUCKET';
+    return undefined;
+}
+function extractOwnerFromVcsPayload(payload) {
+    if (!payload)
+        return undefined;
+    if (typeof payload === 'string')
+        return payload.trim() || undefined;
+    const obj = payload;
+    if (typeof obj.owner === 'string' && obj.owner.trim()) {
+        return obj.owner.trim();
+    }
+    const list = (obj.owners || obj.items || obj.records);
+    if (Array.isArray(list)) {
+        for (const candidate of list) {
+            if (typeof candidate === 'string' && candidate.trim())
+                return candidate.trim();
+            if (candidate && typeof candidate === 'object') {
+                const ownerVal = candidate.owner;
+                if (typeof ownerVal === 'string' && ownerVal.trim())
+                    return ownerVal.trim();
+            }
+        }
+    }
+    return undefined;
+}
+async function fetchOwnerByVcsType(connection, vcsType) {
+    const path = `/services/data/v${connection.getApiVersion()}/connect/devops/vcs/${vcsType}`;
+    const response = await connection.request({ method: 'GET', url: path });
+    return extractOwnerFromVcsPayload(response);
+}
+async function fetchVcsOwnersForRecords(connection, records) {
+    const providerOwnerMap = new Map();
+    const vcsTypes = new Set();
+    for (const item of records) {
+        const provider = item.SourceCodeRepositoryBranch?.SourceCodeRepository?.Provider;
+        const vcsType = providerToVcsType(provider);
+        if (vcsType)
+            vcsTypes.add(vcsType);
+    }
+    await Promise.all(Array.from(vcsTypes).map(async (vcsType) => {
+        try {
+            const owner = await fetchOwnerByVcsType(connection, vcsType);
+            if (!owner)
+                return;
+            if (vcsType === 'GITHUB')
+                providerOwnerMap.set('github', owner);
+            else if (vcsType === 'BITBUCKET')
+                providerOwnerMap.set('bitbucket', owner);
+        }
+        catch {
+            // Fall back to RepositoryOwner from work item when Connect API owner lookup fails.
+        }
+    }));
+    return providerOwnerMap;
+}
+function buildRepositoryInfo(item, providerOwnerMap) {
+    const repoName = item.SourceCodeRepositoryBranch?.SourceCodeRepository?.Name ?? undefined;
+    const provider = item.SourceCodeRepositoryBranch?.SourceCodeRepository?.Provider;
+    const normalizedProvider = normalizeProvider(provider);
+    const ownerFromConnectApi = normalizedProvider ? providerOwnerMap?.get(normalizedProvider) : undefined;
+    const ownerFromRepository = item.SourceCodeRepositoryBranch?.SourceCodeRepository?.RepositoryOwner ?? undefined;
+    const repoOwner = normalizedProvider === 'bitbucket'
+        ? ownerFromRepository ?? ownerFromConnectApi
+        : ownerFromConnectApi ?? ownerFromRepository;
+    let repoUrl;
+    let repoType;
+    if (normalizedProvider && repoOwner && repoName) {
+        if (normalizedProvider === 'github') {
+            repoType = 'github';
+            repoUrl = `https://github.com/${repoOwner}/${repoName}`;
+        }
+        else if (normalizedProvider === 'bitbucket') {
+            repoType = 'bitbucket';
+            repoUrl = `https://bitbucket.org/${repoOwner}/${repoName}`;
+        }
+        else {
+            repoType = normalizedProvider;
+        }
+    }
+    return { repoUrl, repoType };
+}
+async function ensureProjectStages(connection, cache, projectId) {
+    if (!projectId)
+        return null;
+    if (cache.has(projectId))
+        return cache.get(projectId) ?? null;
+    const pipelineId = await getPipelineIdForProject(connection, projectId);
+    if (!pipelineId) {
+        cache.set(projectId, null);
+        return null;
+    }
+    const stages = await fetchPipelineStages(connection, pipelineId);
+    if (!stages?.length) {
+        cache.set(projectId, null);
+        return null;
+    }
+    const firstStageId = computeFirstStageId(stages);
+    const ctx = { pipelineId, stages, firstStageId };
+    cache.set(projectId, ctx);
+    return ctx;
+}
+function mapRawItemToWorkItem(item, ctx, providerOwnerMap) {
+    const { repoUrl, repoType } = buildRepositoryInfo(item, providerOwnerMap);
+    const mapped = {
+        id: item.Id,
+        name: item.Name ?? '',
+        subject: item.Subject ?? undefined,
+        description: item.Description ?? undefined,
+        status: item.Status ?? '',
+        owner: item.AssignedToId ?? '',
+        SourceCodeRepository: repoUrl ?? repoType ? { repoUrl: repoUrl ?? '', repoType: repoType ?? '' } : undefined,
+        WorkItemBranch: item.SourceCodeRepositoryBranch?.Name ?? undefined,
+        PipelineStageId: item.DevopsPipelineStageId ?? undefined,
+        DevopsProjectId: item.DevopsProjectId,
+        PipelineId: ctx?.pipelineId,
+    };
+    if (ctx) {
+        let targetStageId = resolveTargetStageId(mapped.PipelineStageId, ctx.stages);
+        if (!targetStageId) {
+            targetStageId = ctx.firstStageId;
+        }
+        const targetStage = findStageById(ctx.stages, targetStageId);
+        mapped.TargetBranch = getBranchNameFromStage(targetStage);
+        mapped.TargetStageId = targetStageId;
+    }
+    return mapped;
+}
+export async function fetchWorkItems(connection, projectId) {
+    const query = `
+    SELECT
+      Id, Name, Subject, Description, Status, AssignedToId,
+      SourceCodeRepositoryBranchId,
+      SourceCodeRepositoryBranch.Name,
+      SourceCodeRepositoryBranch.SourceCodeRepositoryId,
+      SourceCodeRepositoryBranch.SourceCodeRepository.Name,
+      SourceCodeRepositoryBranch.SourceCodeRepository.RepositoryOwner,
+      SourceCodeRepositoryBranch.SourceCodeRepository.Provider,
+      DevopsPipelineStageId,
+      DevopsProjectId
+    FROM WorkItem
+    WHERE DevopsProjectId = '${projectId}'
+  `;
+    const result = await connection.query(query);
+    const records = result.records ?? [];
+    const projectStagesCache = new Map();
+    const ctx = await ensureProjectStages(connection, projectStagesCache, projectId);
+    const providerOwnerMap = await fetchVcsOwnersForRecords(connection, records);
+    return records.map((item) => mapRawItemToWorkItem(item, ctx, providerOwnerMap));
+}
+//# sourceMappingURL=workItems.js.map

package/lib/utils/workItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItems.js","sourceRoot":"","sources":["../../src/utils/workItems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,SAAS,iBAAiB,CAAC,QAAiB;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,UAAU,KAAK,gBAAgB,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAiB;IAC1C,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAgB;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAEpE,MAAM,GAAG,GAAG,OAAkC,CAAC;IAC/C,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACtD,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAc,CAAC;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE;gBAAE,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;YAC/E,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAI,SAAqC,CAAC,KAAK,CAAC;gBAC9D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;oBAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,UAAsB,EAAE,OAAgB;IACzE,MAAM,IAAI,GAAG,mBAAmB,UAAU,CAAC,aAAa,EAAE,uBAAuB,OAAO,EAAE,CAAC;IAC3F,MAAM,QAAQ,GAAY,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,UAAsB,EACtB,OAA8B;IAE9B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,QAAQ,CAAC;QACjF,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,OAAO;YAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC7D,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,IAAI,OAAO,KAAK,QAAQ;gBAAE,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;iBAC3D,IAAI,OAAO,KAAK,WAAW;gBAAE,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;QACrF,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAyB,EACzB,gBAAsC;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,IAAI,IAAI,SAAS,CAAC;IAC1F,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,QAAQ,CAAC;IACjF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,MAAM,mBAAmB,GAAG,IAAI,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,eAAe,IAAI,SAAS,CAAC;IAChH,MAAM,SAAS,GACb,kBAAkB,KAAK,WAAW;QAChC,CAAC,CAAC,mBAAmB,IAAI,mBAAmB;QAC5C,CAAC,CAAC,mBAAmB,IAAI,mBAAmB,CAAC;IAEjD,IAAI,OAA2B,CAAC;IAChC,IAAI,QAA4B,CAAC;IACjC,IAAI,kBAAkB,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QAChD,IAAI,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YACpC,QAAQ,GAAG,QAAQ,CAAC;YACpB,OAAO,GAAG,sBAAsB,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC1D,CAAC;aAAM,IAAI,kBAAkB,KAAK,WAAW,EAAE,CAAC;YAC9C,QAAQ,GAAG,WAAW,CAAC;YACvB,OAAO,GAAG,yBAAyB,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,kBAAkB,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,UAAsB,EACtB,KAA+C,EAC/C,SAAkB;IAElB,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAE9D,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACxE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAyB,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvE,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAyB,EACzB,GAAgC,EAChC,gBAAsC;IAEtC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAE1E,MAAM,MAAM,GAAa;QACvB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;QAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;QAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,KAAK,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;QAC9B,oBAAoB,EAAE,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QAC5G,cAAc,EAAE,IAAI,CAAC,0BAA0B,EAAE,IAAI,IAAI,SAAS;QAClE,eAAe,EAAE,IAAI,CAAC,qBAAqB,IAAI,SAAS;QACxD,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,UAAU,EAAE,GAAG,EAAE,UAAU;KAC5B,CAAC;IAEF,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC;QACnC,CAAC;QACD,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC7D,MAAM,CAAC,YAAY,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAsB,EAAE,SAAiB;IAC5E,MAAM,KAAK,GAAG;;;;;;;;;;;;+BAYe,SAAS;GACrC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAsB,KAAK,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC1E,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACjF,MAAM,gBAAgB,GAAG,MAAM,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAE7E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAY,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/messages/commonErrors.md

@@ -44,4 +44,8 @@ Connection is required
 
 # error.query-string-required
 
-Query string is required and must be a non-empty string
+The query string is empty or missing. Specify a query string and try again.
+
+# error.DevopsCenterNotEnabled
+
+We couldn't run this command because DevOps Center isn't enabled in this org. Enable DevOps Center in Setup, and try again.

package/messages/devops.pipeline.activate.md

@@ -0,0 +1,29 @@
+# summary
+
+Activate a DevOps Center pipeline for deployments.
+
+# description
+
+A pipeline must have at least one stage before you activate it. You can't modify the pipeline stages after you activate and promote changes through it.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline.
+
+# examples
+
+- Activate a pipeline using the pipeline ID.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001
+
+# error.NoStages
+
+Can't activate pipeline %s. Add at least one stage, then try again.
+
+# error.AlreadyActive
+
+Pipeline %s is already active.

package/messages/devops.pipeline.attach-project.md

@@ -0,0 +1,29 @@
+# summary
+
+Attach a DevOps Center project to a pipeline.
+
+# description
+
+You can attach a project to only one pipeline.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline.
+
+# flags.project-id.summary
+
+ID of the DevOps Center project.
+
+# examples
+
+- Attach a project to a pipeline using the project ID and pipeline ID.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001
+
+# error.AlreadyAttached
+
+Project %s is already attached to pipeline %s. Remove the project, and then try again.

package/messages/devops.pipeline.create.md

@@ -0,0 +1,81 @@
+# summary
+
+Create a DevOps Center pipeline.
+
+# description
+
+Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# flags.name.summary
+
+Name of the pipeline.
+
+# flags.repo.summary
+
+URL of an existing repository or the name of a repository to create.
+
+# flags.repo-type.summary
+
+Type of the source code repository. Required when creating a repository using '--create-repo'.
+
+# flags.create-repo.summary
+
+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'.
+
+# flags.bitbucket-project.summary
+
+Bitbucket project key for the repository. Used when creating a Bitbucket repository with '--create-repo'.
+
+# flags.description.summary
+
+Description of the pipeline.
+
+# examples
+
+- Create a pipeline and associate it with an existing GitHub repository.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo
+
+- Create a pipeline and associate it with a new GitHub repository.
+
+      <%= 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.
+
+      <%= 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"
+
+# error.RepoTypeRequired
+
+The --repo-type flag is required when using --create-repo. Specify --repo-type github or --repo-type bitbucket.
+
+# error.RepoCreationFailed
+
+Failed to create repository "%s". Verify the --repo-owner has permission to create repositories and the repository name is available. Details: %s
+
+# error.RepoNotFound
+
+Repository "%s" was not found or you don't have access. Verify the repository URL is correct and your DevOps Center org has the required VCS credentials.
+
+# error.RepoValidationFailed
+
+Failed to validate repository "%s". When using an existing repository, provide the full URL (e.g. https://github.com/owner/repo). To create a new repository, use --create-repo with --repo-type and --repo-owner.
+
+# 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.
+
+# error.VcsCredentialsMissing
+
+No VCS credentials found for repository "%s". Connect to Bitbucket in your DevOps Center org before creating a pipeline.
+
+# error.RepoTypeDetectionFailed
+
+Unable to detect the repository type from the URL "%s". Use --repo-type to specify the repository type.

package/messages/devops.pipeline.stage.add.md

@@ -0,0 +1,37 @@
+# summary
+
+Add a stage to a DevOps Center pipeline.
+
+# description
+
+Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline where the stage is added.
+
+# flags.name.summary
+
+Name of the pipeline stage, such as Integration, UAT, or Staging.
+
+# flags.next-stage-id.summary
+
+ID of the stage that follows the new stage in the pipeline.
+
+# examples
+
+- Add a Development stage before Integration in a specific pipeline.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Development" --next-stage-id 0Xc000000000002
+
+- Add a QA stage before UAT in a specific pipeline.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name "QA" --next-stage-id 0Xc000000000003
+
+# error.StageNotFound
+
+Stage %s not found in pipeline %s. Check the stage ID and try again.

package/messages/devops.project.create.md

@@ -0,0 +1,29 @@
+# summary
+
+Create a DevOps Center project in a DevOps Center org.
+
+# description
+
+Creates a new DevOps Center project with the specified name and optional description.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# flags.name.summary
+
+Name of the new DevOps Center project.
+
+# flags.description.summary
+
+Description of the new project; if not specified, the description is blank.
+
+# examples
+
+- Create a new DevOps Center project in the specified org.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "MyApp Release"
+
+- Create a project with a name and description.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --name "Platform Update" --description "Platform services update"

package/messages/devops.project.list.md

@@ -0,0 +1,17 @@
+# summary
+
+List all DevOps Center projects in a Salesforce org.
+
+# description
+
+This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.
+
+# examples
+
+- List all DevOps Center projects in an org with alias "my-devops-org":
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org
+
+- List projects using an org's username:
+
+      <%= config.bin %> <%= command.id %> --target-org devops-center@example.com

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

@@ -0,0 +1,46 @@
+# summary
+
+Add a source code repository branch to a pipeline stage.
+
+# description
+
+By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.
+Each pipeline stage supports only one branch. Adding a branch replaces any existing branch linked to the pipeline stage.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline that contains the stage.
+
+# flags.stage-id.summary
+
+ID of the pipeline stage to associate the branch with.
+
+# flags.branch-name.summary
+
+Name of the repository branch to assign to the stage.
+
+# flags.create-vcs-branch.summary
+
+Create the branch in the remote repository if it doesn't already exist.
+
+# examples
+
+- Add an existing branch to a stage:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main
+
+- Create and add a branch to a pipeline stage:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch
+
+# error.StageNotFound
+
+Pipeline stage "%s" doesn't exist in pipeline "%s". Check the stage ID and try again.
+
+# error.NextStageNoBranch
+
+You must set up a branch on stage "%s" before configuring stage "%s". Branches must be configured from right to left (starting from the last stage in the pipeline).
+
+# error.BranchAttachFailed
+
+Failed to associate branch with stage: %s

package/messages/devops.stage.add-environment.md

@@ -0,0 +1,61 @@
+# summary
+
+Add a Salesforce environment to a pipeline stage.
+
+# description
+
+This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline that contains the stage.
+
+# flags.stage-id.summary
+
+ID of the pipeline stage.
+
+# flags.environment-name.summary
+
+Name of the environment.
+
+# flags.org-type.summary
+
+Type of the Salesforce org. Valid values: Production, Sandbox.
+
+# flags.no-browser.summary
+
+Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.
+
+# examples
+
+- Add a production environment to a stage using its ID:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production
+
+# info.BrowserOpened
+
+A browser window has been opened for authentication. Log in to the target org to complete the setup.
+
+# info.ManualAuth
+
+Open the following URL in your browser to authenticate the environment:\n%s
+
+# info.WaitingForAuth
+
+Waiting for authentication to complete...
+
+# info.Success
+
+Successfully added environment to the stage.
+
+# error.StageNotFound
+
+Pipeline stage "%s" doesn't exist in pipeline "%s". Check the stage ID and try again.
+
+# error.EnvironmentAttachFailed
+
+Failed to create environment for stage: %s
+
+# error.AuthTimeout
+
+Authentication timed out. The environment was created but not yet authenticated. Re-run the command or authenticate manually via the org's DevOps Center setup.

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

@@ -0,0 +1,29 @@
+# summary
+
+Create a new work item in a DevOps Center project.
+
+# description
+
+The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.
+
+# flags.project-id.summary
+
+ID of the DevOps Center project to create the work item in.
+
+# flags.subject.summary
+
+Subject (title) of the new work item.
+
+# flags.description.summary
+
+Description of the new work item; if not specified, the description is blank.
+
+# examples
+
+- Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias "my-devops-org":
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject "Fix login bug"
+
+- Create a work item with a subject and description:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject "Add dark mode" --description "Implement dark mode toggle in settings page"

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

@@ -0,0 +1,21 @@
+# summary
+
+List all work items for a DevOps Center project.
+
+# description
+
+Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a project ID; run the `devops project list` command to get the IDs for all existing projects.
+
+# flags.project-id.summary
+
+ID of the DevOps Center project to list work items for.
+
+# examples
+
+- List work items for a specific project in the DevOps org with alias "my-devops-org":
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001
+
+- List work items using JSON output:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --json

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

@@ -0,0 +1,29 @@
+# summary
+
+Update the status of a work item in DevOps Center.
+
+# description
+
+Allowed statuses are "In Progress" and "Ready to Promote".
+
+# 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.status.summary
+
+Status to set for the work item. Allowed values: "In Progress", "Ready to Promote".
+
+# examples
+
+- Update a work item status by its name to indicate the work is underway:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --status "In Progress"
+
+- Update a work item status by its ID to indicate the changes are ready for promotion:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status "Ready to Promote"