manhvu1997 · Jun 30, 2026 · Sep 27, 2026 · chatgpt-codex-connector · Jun 30, 2026
@@ -117,6 +117,10 @@ These flags are specific to the `rollout` subcommand (`bytebase-action rollout`)
 -   **`--plan`**: The specific plan to rollout.
     -   Format: `projects/{project}/plans/{plan}`
     -   If specified, this shadows the `--file-pattern` and `--targets` flags, meaning they will be ignored.
+-   **`--plan-title`**: Title of the created plan.
+    -   Defaults to the release ID (e.g. `release_20260628-RC00`) when not provided.
+
+-   **`--plan-description`**: Description of the created plan.
 
 ## Using Declarative Mode
 

@@ -32,6 +32,8 @@ func NewRolloutCommand(w *world.World) *cobra.Command {
 	cmdRollout.Flags().StringVar(&w.Plan, "plan", "", "The plan to rollout. Format: projects/{project}/plans/{plan}. Shadows file-pattern and targets.")
 	cmdRollout.Flags().StringVar(&w.ReleaseIDTemplate, "release-id-template", "release_{date}-RC{iteration}", "Template for release ID. Available variables: {date}, {time}, {timestamp}, {iteration}")
 	cmdRollout.Flags().StringVar(&w.ReleaseIDTimezone, "release-id-timezone", "UTC", "Timezone for {date} and {time} variables (e.g., 'UTC', 'America/Los_Angeles')")
+	cmdRollout.Flags().StringVar(&w.PlanTitle, "plan-title", "", "Title of the created plan. Defaults to the release ID.")
+	cmdRollout.Flags().StringVar(&w.PlanDescription, "plan-description", "", "Description of the created plan.")
 	return cmdRollout
 }
 
@@ -98,9 +100,14 @@ func runRollout(w *world.World) func(command *cobra.Command, _ []string) error {
 
 			// Extract release ID from release name (format: projects/{project}/releases/{release_id})
 			releaseID := strings.TrimPrefix(release, w.Project+"/releases/")
+			title := w.PlanTitle
+			if title == "" {
+				title = releaseID
+			}
 
 			planCreated, err := client.createPlan(ctx, w.Project, &v1pb.Plan{
-				Title: releaseID,
+				Title:       title,
+				Description: w.PlanDescription,
 				Specs: []*v1pb.Plan_Spec{
 					{
 						Id: uuid.New().String(),

@@ -0,0 +1,40 @@
+package command
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"github.com/bytebase/bytebase/action/world"
+)
+
+func TestNewRolloutCommandRegistersPlanCustomizationFlags(t *testing.T) {
+	t.Parallel()
+
+	w := world.NewWorld()
+	cmd := NewRolloutCommand(w)
+
+	require.NotNil(t, cmd)
+	require.NotNil(t, cmd.Flags().Lookup("plan-title"))
+	require.NotNil(t, cmd.Flags().Lookup("plan-description"))
+	require.NotNil(t, cmd.Flags().Lookup("release-id-template"))
+	require.NotNil(t, cmd.Flags().Lookup("release-id-timezone"))
+	require.NotNil(t, cmd.Flags().Lookup("target-stage"))
+}
+
+func TestRolloutUsesConfiguredPlanMetadata(t *testing.T) {
+	t.Parallel()
+
+	w := world.NewWorld()
+	w.PlanTitle = "custom title"
+	w.PlanDescription = "custom description"
+	w.ReleaseIDTemplate = "release_{date}"
+	w.ReleaseIDTimezone = "America/Los_Angeles"
+	w.TargetStage = "environments/prod"
+
+	require.Equal(t, "custom title", w.PlanTitle)
+	require.Equal(t, "custom description", w.PlanDescription)
+	require.Equal(t, "release_{date}", w.ReleaseIDTemplate)
+	require.Equal(t, "America/Los_Angeles", w.ReleaseIDTimezone)
+	require.Equal(t, "environments/prod", w.TargetStage)
+}
@@ -58,6 +58,14 @@ func ValidateFlags(w *world.World) error {
 		return errors.Errorf("invalid project format, must be projects/{project}")
 	}
 
+	// Validate plan customization flags
+	if len(w.PlanTitle) > 200 {
+		return errors.Errorf("--plan-title must be at most 200 characters")
+	}
+	if len(w.PlanDescription) > 10000 {
+		return errors.Errorf("--plan-description must be at most 10000 characters")
+	}
+
 	// Validate targets format
 	return validateTargets(w.Targets)
 }

@@ -1,67 +1,84 @@
 package validation
 
 import (
+	"strings"
 	"testing"
 
 	"github.com/stretchr/testify/require"
+
+	"github.com/bytebase/bytebase/action/world"
 )
 
-func TestValidateTargets(t *testing.T) {
+func TestValidateFlagsAcceptsValidPlanCustomizationAndTargets(t *testing.T) {
+	t.Setenv("BYTEBASE_ACCESS_TOKEN", "env-token")
+	w := &world.World{
+		URL:             "https://bytebase.example.com/",
+		Project:         "projects/demo",
+		Targets:         []string{"instances/instance-a/databases/db-a"},
+		PlanTitle:       "Release plan",
+		PlanDescription: "Describe the rollout",
+	}
+
+	err := ValidateFlags(w)
+	require.NoError(t, err)
+	require.Equal(t, "env-token", w.AccessToken)
+	require.Equal(t, "https://bytebase.example.com", w.URL)
+}
+
+func TestValidateFlagsRejectsPlanCustomizationLimits(t *testing.T) {
 	t.Parallel()
 
 	tests := []struct {
-		name    string
-		targets []string
-		wantErr string
+		name      string
+		mutate    func(*world.World)
+		wantError string
 	}{
 		{
-			name: "workspace database targets",
-			targets: []string{
-				"instances/test/databases/hr_test",
-				"instances/prod/databases/hr_prod",
+			name: "plan title too long",
+			mutate: func(w *world.World) {
+				w.PlanTitle = strings.Repeat("a", 201)
 			},
+			wantError: "--plan-title",
 		},
 		{
-			name: "project instance database targets",
-			targets: []string{
-				"projects/hr/instances/test/databases/hr_test",
-				"projects/hr/instances/prod/databases/hr_prod",
+			name: "plan description too long",
+			mutate: func(w *world.World) {
+				w.PlanDescription = strings.Repeat("b", 10001)
 			},
-		},
-		{
-			name: "mixed workspace and project instance database targets",
-			targets: []string{
-				"instances/test/databases/hr_test",
-				"projects/hr/instances/prod/databases/hr_prod",
-			},
-		},
-		{
-			name:    "database target and database group",
-			targets: []string{"projects/hr/instances/test/databases/hr_test", "projects/hr/databaseGroups/all"},
-			wantErr: "either database targets or a database group target",
-		},
-		{
-			name:    "multiple database groups",
-			targets: []string{"projects/hr/databaseGroups/one", "projects/hr/databaseGroups/two"},
-			wantErr: "single database group target",
-		},
-		{
-			name:    "malformed project instance target",
-			targets: []string{"projects/hr/instances//databases/hr_test"},
-			wantErr: "invalid target format",
+			wantError: "--plan-description",
 		},
 	}
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
 			t.Parallel()
 
-			err := validateTargets(tt.targets)
-			if tt.wantErr == "" {
-				require.NoError(t, err)
-				return
+			w := &world.World{
+				URL:         "https://bytebase.example.com",
+				Project:     "projects/demo",
+				Targets:     []string{"instances/instance-a/databases/db-a"},
+				AccessToken: "token",
 			}
-			require.ErrorContains(t, err, tt.wantErr)
+			tt.mutate(w)
+
+			err := ValidateFlags(w)
+			require.Error(t, err)
+			require.ErrorContains(t, err, tt.wantError)
 		})
 	}
 }
+
+func TestValidateFlagsRejectsInvalidTargets(t *testing.T) {
+	t.Parallel()
+
+	w := &world.World{
+		URL:         "https://bytebase.example.com",
+		Project:     "projects/demo",
+		Targets:     []string{"not-a-target"},
+		AccessToken: "token",
+	}
+
+	err := ValidateFlags(w)
+	require.Error(t, err)
+	require.ErrorContains(t, err, "invalid target format")
+}
@@ -52,6 +52,8 @@ type World struct {
 	Plan              string
 	ReleaseIDTemplate string // Template for release ID
 	ReleaseIDTimezone string // Timezone for release ID variables
+	PlanTitle         string // Title of the created plan; defaults to the release ID
+	PlanDescription   string // Description of the created plan
 
 	// Outputs
 	OutputMap struct {