feat: Nits for rill project deployment command

cli/cmd/project/deployment/deployment.go

@@ -5,9 +5,9 @@ import (
 	"github.com/spf13/cobra"
 )
 
-func DeploymentsCmd(ch *cmdutil.Helper) *cobra.Command {
+func DeploymentCmd(ch *cmdutil.Helper) *cobra.Command {
 	deploymentCmd := &cobra.Command{
-		Use:   "deployments",
+		Use:   "deployment",
 		Short: "Manage project deployments",
 	}
 

cli/cmd/project/deployment/list.go

@@ -37,6 +37,16 @@ func ListCmd(ch *cmdutil.Helper) *cobra.Command {
 				return fmt.Errorf("project name is required")
 			}
 
+			// fetch the project
+			projResp, err := client.GetProject(cmd.Context(), &adminv1.GetProjectRequest{
+				Org:     ch.Org,
+				Project: project,
+			})
+			if err != nil {
+				return err
+			}
+
+			// fetch the deployments
 			req := &adminv1.ListDeploymentsRequest{
 				Org:     ch.Org,
 				Project: project,
@@ -49,6 +59,12 @@ func ListCmd(ch *cmdutil.Helper) *cobra.Command {
 				return err
 			}
 
+			for _, d := range resp.Deployments {
+				if d.Id == projResp.Project.PrimaryDeploymentId {
+					d.Branch += " (primary)"
+					break
+				}
+			}
 			ch.PrintDeployments(resp.Deployments)
 			return nil
 		},

cli/cmd/project/project.go

@@ -34,7 +34,7 @@ func ProjectCmd(ch *cmdutil.Helper) *cobra.Command {
 	projectCmd.AddCommand(GitPushCmd(ch))
 	projectCmd.AddCommand(DeployCmd(ch))
 	projectCmd.AddCommand(TablesCmd(ch))
-	projectCmd.AddCommand(deployment.DeploymentsCmd(ch))
+	projectCmd.AddCommand(deployment.DeploymentCmd(ch))
 
 	return projectCmd
 }

cli/pkg/printer/resources.go

@@ -5,6 +5,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"path/filepath"
+	"slices"
 	"sort"
 	"strconv"
 	"strings"
@@ -748,6 +749,21 @@ func toDeploymentsTable(deployments []*adminv1.Deployment) []*deployment {
 	for _, d := range deployments {
 		res = append(res, toDeploymentRow(d))
 	}
+	slices.SortFunc(res, func(a, b *deployment) int {
+		// group by environment
+		if a.Environment < b.Environment {
+			return -1
+		} else if a.Environment > b.Environment {
+			return 1
+		}
+		// sort by branch if environment is same
+		if a.Branch < b.Branch {
+			return -1
+		} else if a.Branch > b.Branch {
+			return 1
+		}
+		return 0
+	})
 	return res
 }
 
@@ -757,8 +773,8 @@ func toDeploymentRow(d *adminv1.Deployment) *deployment {
 		status = fmt.Sprintf("%s: %s", status, d.StatusMessage)
 	}
 	return &deployment{
-		Environment: d.Environment,
 		Branch:      d.Branch,
+		Environment: d.Environment,
 		Status:      status,
 	}
 }
@@ -787,8 +803,8 @@ func formatDeploymentStatus(status adminv1.DeploymentStatus) string {
 }
 
 type deployment struct {
-	Environment string `header:"environment" json:"environment"`
 	Branch      string `header:"branch" json:"branch"`
+	Environment string `header:"environment" json:"environment"`
 	Status      string `header:"status" json:"status"`
 }
 

docs/docs/reference/cli/project/deployments/create.md → docs/docs/reference/cli/project/deployment/create.md

@@ -1,13 +1,13 @@
 ---
 note: GENERATED. DO NOT EDIT.
-title: rill project deployments create
+title: rill project deployment create
 ---
-## rill project deployments create
+## rill project deployment create
 
 Create a deployment for a specific branch
 
 ```
-rill project deployments create [<project>] <branch> [flags]
+rill project deployment create [<project>] <branch> [flags]
 ```
 
 ### Flags
@@ -31,5 +31,5 @@ rill project deployments create [<project>] <branch> [flags]
 
 ### SEE ALSO
 
-* [rill project deployments](deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment.md)	 - Manage project deployments
 

docs/docs/reference/cli/project/deployments/delete.md → docs/docs/reference/cli/project/deployment/delete.md

@@ -1,13 +1,13 @@
 ---
 note: GENERATED. DO NOT EDIT.
-title: rill project deployments delete
+title: rill project deployment delete
 ---
-## rill project deployments delete
+## rill project deployment delete
 
 Delete a deployment by branch
 
 ```
-rill project deployments delete [<project>] <branch> [flags]
+rill project deployment delete [<project>] <branch> [flags]
 ```
 
 ### Flags
@@ -29,5 +29,5 @@ rill project deployments delete [<project>] <branch> [flags]
 
 ### SEE ALSO
 
-* [rill project deployments](deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment.md)	 - Manage project deployments
 

docs/docs/reference/cli/project/deployment/deployment.md

@@ -0,0 +1,28 @@
+---
+note: GENERATED. DO NOT EDIT.
+title: rill project deployment
+---
+## rill project deployment
+
+Manage project deployments
+
+### Global flags
+
+```
+      --api-token string   Token for authenticating with the cloud API
+      --format string      Output format (options: "human", "json", "csv") (default "human")
+  -h, --help               Print usage
+      --interactive        Prompt for missing required parameters (default true)
+      --org string         Organization Name
+```
+
+### SEE ALSO
+
+* [rill project](../project.md)	 - Manage projects
+* [rill project deployment create](create.md)	 - Create a deployment for a specific branch
+* [rill project deployment delete](delete.md)	 - Delete a deployment by branch
+* [rill project deployment list](list.md)	 - List all deployments for a project
+* [rill project deployment show](show.md)	 - Show details of a deployment
+* [rill project deployment start](start.md)	 - Start a deployment by branch
+* [rill project deployment stop](stop.md)	 - Stop a deployment by branch
+

docs/docs/reference/cli/project/deployments/list.md → docs/docs/reference/cli/project/deployment/list.md

@@ -1,13 +1,13 @@
 ---
 note: GENERATED. DO NOT EDIT.
-title: rill project deployments list
+title: rill project deployment list
 ---
-## rill project deployments list
+## rill project deployment list
 
 List all deployments for a project
 
 ```
-rill project deployments list [<project>] [flags]
+rill project deployment list [<project>] [flags]
 ```
 
 ### Flags
@@ -30,5 +30,5 @@ rill project deployments list [<project>] [flags]
 
 ### SEE ALSO
 
-* [rill project deployments](deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment.md)	 - Manage project deployments
 

docs/docs/reference/cli/project/deployments/show.md → docs/docs/reference/cli/project/deployment/show.md

@@ -1,13 +1,13 @@
 ---
 note: GENERATED. DO NOT EDIT.
-title: rill project deployments show
+title: rill project deployment show
 ---
-## rill project deployments show
+## rill project deployment show
 
 Show details of a deployment
 
 ```
-rill project deployments show [<project>] <branch> [flags]
+rill project deployment show [<project>] <branch> [flags]
 ```
 
 ### Flags
@@ -29,5 +29,5 @@ rill project deployments show [<project>] <branch> [flags]
 
 ### SEE ALSO
 
-* [rill project deployments](deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment.md)	 - Manage project deployments
 

docs/docs/reference/cli/project/deployments/start.md → docs/docs/reference/cli/project/deployment/start.md

@@ -1,13 +1,13 @@
 ---
 note: GENERATED. DO NOT EDIT.
-title: rill project deployments start
+title: rill project deployment start
 ---
-## rill project deployments start
+## rill project deployment start
 
 Start a deployment by branch
 
 ```
-rill project deployments start [<project>] <branch> [flags]
+rill project deployment start [<project>] <branch> [flags]
 ```
 
 ### Flags
@@ -29,5 +29,5 @@ rill project deployments start [<project>] <branch> [flags]
 
 ### SEE ALSO
 
-* [rill project deployments](deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment.md)	 - Manage project deployments
 

docs/docs/reference/cli/project/deployments/stop.md → docs/docs/reference/cli/project/deployment/stop.md

@@ -1,13 +1,13 @@
 ---
 note: GENERATED. DO NOT EDIT.
-title: rill project deployments stop
+title: rill project deployment stop
 ---
-## rill project deployments stop
+## rill project deployment stop
 
 Stop a deployment by branch
 
 ```
-rill project deployments stop [<project>] <branch> [flags]
+rill project deployment stop [<project>] <branch> [flags]
 ```
 
 ### Flags
@@ -29,5 +29,5 @@ rill project deployments stop [<project>] <branch> [flags]
 
 ### SEE ALSO
 
-* [rill project deployments](deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment.md)	 - Manage project deployments
 

docs/docs/reference/cli/project/project.md

@@ -28,7 +28,7 @@ Manage projects
 * [rill project connect-github](connect-github.md)	 - Deploy project to Rill Cloud by pulling project files from a git repository
 * [rill project delete](delete.md)	 - Delete the project
 * [rill project deploy](deploy.md)	 - Deploy project to Rill Cloud by using a Rill Managed Git repo
-* [rill project deployments](deployments/deployments.md)	 - Manage project deployments
+* [rill project deployment](deployment/deployment.md)	 - Manage project deployments
 * [rill project describe](describe.md)	 - Retrieve detailed state for a resource
 * [rill project edit](edit.md)	 - Edit the project details
 * [rill project hibernate](hibernate.md)	 - Hibernate project