@W-22503173 - Devops project commands

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2024, Salesforce.com, Inc.
+Copyright (c) 2026, Salesforce.com, Inc.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

command-snapshot.json

@@ -1,31 +1,57 @@
 [
   {
-    "command": "project:deploy:pipeline:quick",
-    "plugin": "@salesforce/plugin-devops-center",
-    "flags": ["async", "concise", "devops-center-username", "job-id", "json", "use-most-recent", "verbose", "wait"],
     "alias": [],
+    "command": "devops:project:list",
+    "flagAliases": [],
+    "flagChars": ["o"],
+    "flags": ["json", "target-org"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
+  {
+    "alias": [],
+    "command": "devops:work-item:create",
+    "flagAliases": [],
+    "flagChars": ["d", "o", "p", "s"],
+    "flags": ["description", "json", "project-id", "subject", "target-org"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
+  {
+    "alias": [],
+    "command": "devops:work-item:list",
+    "flagAliases": [],
+    "flagChars": ["o", "p"],
+    "flags": ["json", "project-id", "target-org"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
+  {
+    "alias": [],
+    "command": "project:deploy:pipeline:quick",
+    "flagAliases": [],
     "flagChars": ["c", "i", "r", "w"],
-    "flagAliases": []
+    "flags": ["async", "concise", "devops-center-username", "job-id", "json", "use-most-recent", "verbose", "wait"],
+    "plugin": "@salesforce/plugin-devops-center"
   },
   {
-    "command": "project:deploy:pipeline:report",
-    "plugin": "@salesforce/plugin-devops-center",
-    "flags": ["devops-center-username", "job-id", "json", "use-most-recent"],
     "alias": [],
+    "command": "project:deploy:pipeline:report",
+    "flagAliases": [],
     "flagChars": ["c", "i", "r"],
-    "flagAliases": []
+    "flags": ["devops-center-username", "job-id", "json", "use-most-recent"],
+    "plugin": "@salesforce/plugin-devops-center"
   },
   {
-    "command": "project:deploy:pipeline:resume",
-    "plugin": "@salesforce/plugin-devops-center",
-    "flags": ["concise", "devops-center-username", "job-id", "json", "use-most-recent", "verbose", "wait"],
     "alias": [],
+    "command": "project:deploy:pipeline:resume",
+    "flagAliases": [],
     "flagChars": ["c", "i", "r", "w"],
-    "flagAliases": []
+    "flags": ["concise", "devops-center-username", "job-id", "json", "use-most-recent", "verbose", "wait"],
+    "plugin": "@salesforce/plugin-devops-center"
   },
   {
+    "alias": [],
     "command": "project:deploy:pipeline:start",
-    "plugin": "@salesforce/plugin-devops-center",
+    "flagAliases": [],
+    "flagChars": ["a", "b", "c", "l", "p", "t", "v", "w"],
     "flags": [
       "async",
       "branch-name",
@@ -40,13 +66,13 @@
       "verbose",
       "wait"
     ],
-    "alias": [],
-    "flagChars": ["a", "b", "c", "l", "p", "t", "v", "w"],
-    "flagAliases": []
+    "plugin": "@salesforce/plugin-devops-center"
   },
   {
+    "alias": [],
     "command": "project:deploy:pipeline:validate",
-    "plugin": "@salesforce/plugin-devops-center",
+    "flagAliases": [],
+    "flagChars": ["a", "b", "c", "l", "p", "t", "v", "w"],
     "flags": [
       "async",
       "branch-name",
@@ -61,8 +87,6 @@
       "verbose",
       "wait"
     ],
-    "alias": [],
-    "flagChars": ["a", "b", "c", "l", "p", "t", "v", "w"],
-    "flagAliases": []
+    "plugin": "@salesforce/plugin-devops-center"
   }
 ]

messages/devops.project.list.md

@@ -0,0 +1,21 @@
+# 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.
+
+# flags.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# 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

messages/devops.work-item.create.md

@@ -0,0 +1,33 @@
+# 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.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# 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.
+
+# examples
+
+- Create a work item with a subject.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001 --subject "Fix login bug"
+
+- Create a work item with a subject and description:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001 --subject "Add dark mode" --description "Implement dark mode toggle in settings page"

messages/devops.work-item.list.md

@@ -0,0 +1,25 @@
+# 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.target-org.summary
+
+Username or alias of the DevOps Center org.
+
+# 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 0Hn000000000001
+
+- List work items using JSON output:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001 --json

package.json

@@ -74,6 +74,17 @@
             }
           }
         }
+      },
+      "devops": {
+        "description": "Commands for DevOps and Application Lifecycle Management.",
+        "subtopics": {
+          "project": {
+            "description": "Commands for managing DevOps Center projects."
+          },
+          "work-item": {
+            "description": "Commands for managing DevOps Center work items."
+          }
+        }
       }
     }
   },

schemas/devops-project-list.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/DevopsProjectListResult",
+  "definitions": {
+    "DevopsProjectListResult": {
+      "type": "object",
+      "properties": {
+        "projects": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DevopsProject"
+          }
+        }
+      },
+      "required": ["projects"],
+      "additionalProperties": false
+    },
+    "DevopsProject": {
+      "type": "object",
+      "properties": {
+        "Id": {
+          "type": "string"
+        },
+        "Name": {
+          "type": "string"
+        },
+        "Description": {
+          "type": ["string", "null"]
+        }
+      },
+      "required": ["Id", "Name", "Description"],
+      "additionalProperties": false
+    }
+  }
+}

schemas/devops-work__item-create.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/CreateWorkItemResult",
+  "definitions": {
+    "CreateWorkItemResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "workItemId": {
+          "type": "string"
+        },
+        "workItemName": {
+          "type": "string"
+        },
+        "subject": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": ["success"],
+      "additionalProperties": false
+    }
+  }
+}

schemas/devops-work__item-list.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/DevopsWorkItemListResult",
+  "definitions": {
+    "DevopsWorkItemListResult": {
+      "type": "object",
+      "properties": {
+        "workItems": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/WorkItem"
+          }
+        }
+      },
+      "required": ["workItems"],
+      "additionalProperties": false
+    },
+    "WorkItem": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "subject": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "owner": {
+          "type": "string"
+        },
+        "DevopsProjectId": {
+          "type": "string"
+        },
+        "PipelineId": {
+          "type": "string"
+        },
+        "PipelineStageId": {
+          "type": "string"
+        },
+        "SourceCodeRepository": {
+          "type": "object",
+          "properties": {
+            "repoUrl": {
+              "type": "string"
+            },
+            "repoType": {
+              "type": "string"
+            }
+          },
+          "required": ["repoUrl", "repoType"],
+          "additionalProperties": false
+        },
+        "WorkItemBranch": {
+          "type": "string"
+        },
+        "TargetStageId": {
+          "type": "string"
+        },
+        "TargetBranch": {
+          "type": "string"
+        }
+      },
+      "required": ["id", "name", "status", "owner", "DevopsProjectId"],
+      "additionalProperties": false
+    }
+  }
+}

schemas/project-deploy-pipeline-report.json

@@ -4,6 +4,7 @@
   "definitions": {
     "PromotePipelineResult": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "jobId": {
           "type": "string"
@@ -18,8 +19,7 @@
           "type": "string"
         }
       },
-      "required": ["jobId"],
-      "additionalProperties": false
+      "required": ["jobId"]
     }
   }
 }