feat: custom PR title (#3063)

docs/docs/35-references/10-promotion-steps.md

@@ -1002,6 +1002,7 @@ requests.
 | `sourceBranchFromStep` | `string` | N | Indicates the source branch should be determined by the `branch` key in the output of a previous promotion step with the specified alias. Mutually exclusive with `sourceBranch`.<br/><br/>__Deprecated: Use `sourceBranch` with an expression instead. Will be removed in v1.3.0.__  |
 | `targetBranch` | `string` | N | The branch to which the changes should be merged. |
 | `createTargetBranch` | `boolean` | N | Indicates whether a new, empty orphaned branch should be created and pushed to the remote if the target branch does not already exist there. Default is `false`. |
+| `title` | `string` | N | The title for the pull request. Kargo generates a title based on the commit messages if it is not explicitly specified. |
 
 #### `git-open-pr`  Example
 

internal/directives/git_pr_opener.go

@@ -193,7 +193,12 @@
 		)
 	}
 
-	title := strings.Split(commitMsg, "\n")[0]
+	var title string
+	if cfg.Title != "" {
+		title = cfg.Title
+	} else {
+		title = strings.Split(commitMsg, "\n")[0]
+	}
 	description := commitMsg
 	if stepCtx.UIBaseURL != "" {
 		description = fmt.Sprintf(

internal/directives/git_pr_opener_test.go

@@ -107,6 +107,16 @@ func Test_gitPROpener_validate(t *testing.T) {
 				"targetBranch":         "fake-branch",
 			},
 		},
+		{
+			name: "valid with custom title",
+			config: Config{
+				"provider":     "github",
+				"repoURL":      "https://github.com/example/repo.git",
+				"sourceBranch": "fake-branch",
+				"targetBranch": "another-fake-branch",
+				"title":        "custom title",
+			},
+		},
 	}
 
 	r := newGitPROpener()
@@ -213,6 +223,7 @@ func Test_gitPROpener_runPromotionStep(t *testing.T) {
 			TargetBranch:         testTargetBranch,
 			CreateTargetBranch:   true,
 			Provider:             ptr.To(Provider(fakeGitProviderName)),
+			Title:                "kargo",
 		},
 	)
 	require.NoError(t, err)

internal/directives/schemas/git-open-pr-config.json

@@ -38,6 +38,11 @@
       "type": "string",
       "description": "The branch to which the changes should be merged. This branch must already exist and be up to date on the remote.",
       "minLength": 1
+    },
+    "title": {
+      "type": "string",
+      "description": "The title for the pull request. Kargo generates a title based on the commit messages if it is not explicitly specified.",
+      "minLength": 1
     }
   },
   "oneOf": [

ui/src/gen/directives/git-open-pr-config.json

@@ -40,6 +40,11 @@
    "type": "string",
    "description": "The branch to which the changes should be merged. This branch must already exist and be up to date on the remote.",
    "minLength": 1
+  },
+  "title": {
+   "type": "string",
+   "description": "The title for the pull request. Kargo generates a title based on the commit messages if it is not explicitly specified.",
+   "minLength": 1
   }
  }
 }