[CAP-8922] promote workflows commands from render ea to render workflows (#290)

blue-keleher · render-oss-copybara-sync[bot] · commit a637efaa0234 · 2026-02-27T17:32:54.000Z
Move tasks, taskruns, and versions commands out from under the early
access parent into a new top-level `render workflows` command group
in preparation for the Workflows beta launch. Add a `render workflows
list` command with non-interactive and interactive support. Object
storage commands remain under `render ea`.

GitOrigin-RevId: a8d4b4b29aa949c9ca186737d9db0e3e18245b66
diff --git a/cmd/root.go b/cmd/root.go
@@ -88,7 +88,8 @@ func setupWorkflowCommands(deps *dependencies.Dependencies) {
 	deps.Commands.Workflow.TaskRunDetailsCmd = NewTaskRunDetailsCmd(deps)
 	deps.Commands.Workflow.VersionListCmd = NewVersionListCmd(deps)
 	deps.Commands.Workflow.VersionReleaseCmd = NewVersionReleaseCmd(deps)
-	deps.Commands.Workflow.WorkflowListCmd = workflowListCmd
+	deps.Commands.Workflow.WorkflowListCmd = NewWorkflowListCmd(deps)
+	WorkflowsCmd.AddCommand(deps.Commands.Workflow.WorkflowListCmd)
 
 	taskCmd.AddCommand(deps.Commands.Workflow.TaskListCmd)
 	taskRunCmd.AddCommand(deps.Commands.Workflow.TaskRunCmd)
diff --git a/cmd/service.go b/cmd/service.go
@@ -137,7 +137,7 @@ func selectResource(ctx context.Context) func(resource.Resource) []views.Palette
 					Name:        "versions list",
 					Description: "List versions for the workflow",
 					Action: func(ctx context.Context, args []string) tea.Cmd {
-						return flows.NewWorkflow(deps, flows.NewLogFlow(deps), false).VersionList(ctx, &workflowviews.VersionListInput{WorkflowID: r.ID()})
+						return flows.NewWorkflow(deps, flows.NewLogFlow(deps), false).VersionListFlow(ctx, &workflowviews.VersionListInput{WorkflowID: r.ID()})
 					},
 				},
 				allowedTypes: []string{workflow.WorkflowType},
diff --git a/cmd/task.go b/cmd/task.go
@@ -59,10 +59,10 @@ To use a different port:
   • Then use --port with other task commands, or set RENDER_LOCAL_DEV_URL in the SDK
 
 Examples:
-  render ea tasks dev -- "go run main.go"
-  render ea tasks dev --port 9000 -- "npm start"
-  render ea tasks list --local
-  render ea taskruns start my-task --local --input='["arg1"]'
+  render workflows tasks dev -- "go run main.go"
+  render workflows tasks dev --port 9000 -- "npm start"
+  render workflows tasks list --local
+  render workflows taskruns start my-task --local --input='["arg1"]'
 	`,
 	RunE: func(cmd *cobra.Command, args []string) error {
 		ctx := cmd.Context()
@@ -160,10 +160,10 @@ Examples:
 			portFlag = fmt.Sprintf(" --port %d", port)
 		}
 		command.Println(cmd, "%s", dim.Render("To browse and run tasks, open another terminal and run:"))
-		command.Println(cmd, "  %s", renderstyle.Bold(fmt.Sprintf("render ea tasks list --local%s", portFlag)))
+		command.Println(cmd, "  %s", renderstyle.Bold(fmt.Sprintf("render workflows tasks list --local%s", portFlag)))
 		command.Println(cmd, "")
 		command.Println(cmd, "%s", dim.Render("To trigger a specific task directly:"))
-		command.Println(cmd, "  %s", renderstyle.Bold(fmt.Sprintf("render ea taskruns start <task-name> --local%s --input='[\"arg1\"]'", portFlag)))
+		command.Println(cmd, "  %s", renderstyle.Bold(fmt.Sprintf("render workflows taskruns start <task-name> --local%s --input='[\"arg1\"]'", portFlag)))
 		command.Println(cmd, "")
 
 		ready = true
@@ -202,10 +202,10 @@ You can provide input via:
 In interactive mode, you will be prompted to select the task and provide the input.
 
 Examples:
-  render ea taskruns start tsk-1234 --input='["arg1", "arg2"]'
-  render ea taskruns start my-workflow/my-task --input='[42, "hello"]'
-  render ea taskruns start my-task --input-file=input.json
-  render ea taskruns start my-task --local --input='["test"]'
+  render workflows taskruns start tsk-1234 --input='["arg1", "arg2"]'
+  render workflows taskruns start my-workflow/my-task --input='[42, "hello"]'
+  render workflows taskruns start my-task --input-file=input.json
+  render workflows taskruns start my-task --local --input='["test"]'
 `,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -267,7 +267,7 @@ func init() {
 	taskDevCmd.Flags().Int("port", defaultTaskAPIPort, "Port of the local task server (8120 when not specified)")
 	taskDevCmd.Flags().Bool("debug", false, "Print detailed workflow task execution events")
 
-	EarlyAccessCmd.AddCommand(taskCmd)
+	WorkflowsCmd.AddCommand(taskCmd)
 	taskCmd.AddCommand(taskDevCmd)
 }
 
diff --git a/cmd/tasklist.go b/cmd/tasklist.go
@@ -27,11 +27,11 @@ In interactive mode, you will be prompted to select a workflow version if not pr
 Local Development:
 When using the --local flag, you don't need to provide a workflow version ID. Instead,
 the command connects to your local dev server (default port 8120) to list tasks from
-your running workflow service. Start the dev server with 'render ea tasks dev' first.
+your running workflow service. Start the dev server with 'render workflows tasks dev' first.
 
 Examples:
-  render ea tasks list wfv-1234
-  render ea tasks list --local
+  render workflows tasks list wfv-1234
+  render workflows tasks list --local
 `,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
diff --git a/cmd/taskrun.go b/cmd/taskrun.go
@@ -21,5 +21,5 @@ func init() {
 	taskRunCmd.PersistentFlags().Bool("local", false, "Run against the server spawned by the task dev command")
 	taskRunCmd.PersistentFlags().Int("port", defaultTaskAPIPort, "Port of the local task server (8120 when not specified)")
 
-	EarlyAccessCmd.AddCommand(taskRunCmd)
+	WorkflowsCmd.AddCommand(taskRunCmd)
 }
diff --git a/cmd/taskrundetails.go b/cmd/taskrundetails.go
@@ -23,13 +23,13 @@ This command shows comprehensive information about a task run, including:
   • Output or error result
   • Start and completion timestamps
 
-The task run ID is returned when you execute a task with 'render ea taskruns start'.
+The task run ID is returned when you execute a task with 'render workflows taskruns start'.
 
 In interactive mode, you will be prompted to select a task run if not provided.
 
 Examples:
-  render ea taskruns show tr-1234
-  render ea taskruns show --local tr-5678
+  render workflows taskruns show tr-1234
+  render workflows taskruns show --local tr-5678
 `,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			deps, local, err := getLocalDeps(cmd, deps)
diff --git a/cmd/taskrunlist.go b/cmd/taskrunlist.go
@@ -28,9 +28,9 @@ You can specify the task by:
 In interactive mode, you will be prompted to select a task if not provided.
 
 Examples:
-  render ea taskruns list tsk-1234
-  render ea taskruns list my-workflow/my-task
-  render ea taskruns list --local my-task
+  render workflows taskruns list tsk-1234
+  render workflows taskruns list my-workflow/my-task
+  render workflows taskruns list --local my-task
 `,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
diff --git a/cmd/version.go b/cmd/version.go
@@ -10,5 +10,5 @@ var versionCmd = &cobra.Command{
 }
 
 func init() {
-	EarlyAccessCmd.AddCommand(versionCmd)
+	WorkflowsCmd.AddCommand(versionCmd)
 }
diff --git a/cmd/versionlist.go b/cmd/versionlist.go
@@ -30,8 +30,8 @@ This command displays all versions for a workflow, showing:
 In interactive mode, you will be prompted to select a workflow if not provided.
 
 Examples:
-  render ea versions list wf-1234
-  render ea versions list my-workflow-slug
+  render workflows versions list wf-1234
+  render workflows versions list my-workflow-slug
 `,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -49,7 +49,7 @@ Examples:
 			} else if nonInteractive {
 				return nil
 			}
-			flows.NewWorkflow(deps, flows.NewLogFlow(deps), false).VersionList(cmd.Context(), &input)
+			flows.NewWorkflow(deps, flows.NewLogFlow(deps), false).VersionListFlow(cmd.Context(), &input)
 			return nil
 		},
 	}
diff --git a/cmd/versionrelease.go b/cmd/versionrelease.go
@@ -38,10 +38,10 @@ In interactive mode, you will be prompted to:
   • Confirm the release
 
 Examples:
-  render ea versions release wf-1234
-  render ea versions release my-workflow-slug
-  render ea versions release wf-1234 --commit abc123
-  render ea versions release wf-1234 --wait
+  render workflows versions release wf-1234
+  render workflows versions release my-workflow-slug
+  render workflows versions release wf-1234 --commit abc123
+  render workflows versions release wf-1234 --wait
 `,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
diff --git a/cmd/workflow.go b/cmd/workflow.go
@@ -2,19 +2,15 @@ package cmd
 
 import "github.com/spf13/cobra"
 
-var workflowCmd = &cobra.Command{
-	Use:    "workflow",
-	Hidden: true,
-	Short:  "Manage workflows",
-}
+var WorkflowsCmd = &cobra.Command{
+	Use:   "workflows",
+	Short: "Manage workflows",
+	Long: `Manage workflow services for the active workspace.
 
-var workflowListCmd = &cobra.Command{
-	Use:    "list",
-	Hidden: true,
-	Short:  "List workflows",
+List workflows, browse versions and tasks, start task runs, and trigger releases.`,
+	GroupID: GroupCore.ID,
 }
 
 func init() {
-	EarlyAccessCmd.AddCommand(workflowCmd)
-	workflowCmd.AddCommand(workflowListCmd)
+	rootCmd.AddCommand(WorkflowsCmd)
 }
diff --git a/cmd/workflowlist.go b/cmd/workflowlist.go
@@ -0,0 +1,47 @@
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/spf13/cobra"
+
+	"github.com/render-oss/cli/pkg/command"
+	"github.com/render-oss/cli/pkg/resource"
+	"github.com/render-oss/cli/pkg/text"
+	"github.com/render-oss/cli/pkg/tui/flows"
+	workflowviews "github.com/render-oss/cli/pkg/tui/views/workflows"
+	"github.com/render-oss/cli/pkg/workflow"
+)
+
+func NewWorkflowListCmd(deps flows.WorkflowDeps) *cobra.Command {
+	return &cobra.Command{
+		Use:   "list",
+		Short: "List workflows",
+		Args:  cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			var input workflowviews.WorkflowInput
+			err := command.ParseCommand(cmd, args, &input)
+			if err != nil {
+				return fmt.Errorf("failed to parse command: %w", err)
+			}
+
+			if nonInteractive, err := command.NonInteractive(cmd, func() ([]*workflow.Model, error) {
+				return deps.WorkflowLoader().ListWorkflows(cmd.Context(), input)
+			}, func(models []*workflow.Model) string {
+				resources := make([]resource.Resource, len(models))
+				for i, m := range models {
+					resources[i] = m
+				}
+				return text.ResourceTable(resources)
+			}); err != nil {
+				return err
+			} else if nonInteractive {
+				return nil
+			}
+
+			flows.NewWorkflow(deps, flows.NewLogFlow(deps), false).VersionListFlow(cmd.Context(), &workflowviews.VersionListInput{})
+
+			return nil
+		},
+	}
+}
diff --git a/pkg/tui/flows/workflow.go b/pkg/tui/flows/workflow.go
@@ -134,7 +134,7 @@ func (f *Workflow) workflowList(ctx context.Context, input *workflowviews.Workfl
 	)
 }
 
-func (f *Workflow) VersionList(ctx context.Context, input *workflowviews.VersionListInput) tea.Cmd {
+func (f *Workflow) VersionListFlow(ctx context.Context, input *workflowviews.VersionListInput) tea.Cmd {
 	if input.WorkflowID == "" {
 		return f.workflowList(ctx, &workflowviews.WorkflowInput{}, func(ctx context.Context, r resource.Resource) tea.Cmd {
 			input.WorkflowID = r.ID()

Original file line number	Diff line number	Diff line change
`@@ -21,5 +21,5 @@ func init() {`
`21`	`21`	`taskRunCmd.PersistentFlags().Bool("local", false, "Run against the server spawned by the task dev command")`
`22`	`22`	`taskRunCmd.PersistentFlags().Int("port", defaultTaskAPIPort, "Port of the local task server (8120 when not specified)")`
`23`	`23`
`24`		`- EarlyAccessCmd.AddCommand(taskRunCmd)`
	`24`	`+ WorkflowsCmd.AddCommand(taskRunCmd)`
`25`	`25`	`}`
Original file line number	Diff line number	Diff line change
`@@ -10,5 +10,5 @@ var versionCmd = &cobra.Command{`
`10`	`10`	`}`
`11`	`11`
`12`	`12`	`func init() {`
`13`		`- EarlyAccessCmd.AddCommand(versionCmd)`
	`13`	`+ WorkflowsCmd.AddCommand(versionCmd)`
`14`	`14`	`}`