feat: added env promote, create, sleep command

Author: BhautikChudasama

README.md

@@ -208,20 +208,23 @@ Sensitive and noisy files are always excluded: `.env`, `.env.*`, secrets/keys (`
 
 ### Deployments
 
-| Command                           | Description                          |
-| --------------------------------- | ------------------------------------ |
-| `createos deployments list`       | List deployments for a project       |
-| `createos deployments logs`       | Stream runtime logs for a deployment |
-| `createos deployments build-logs` | Stream build logs for a deployment   |
-| `createos deployments retrigger`  | Retrigger a deployment               |
-| `createos deployments wakeup`     | Wake up a sleeping deployment        |
-| `createos deployments cancel`     | Cancel a running deployment          |
+| Command                               | Description                            |
+| ------------------------------------- | -------------------------------------- |
+| `createos deployments list`           | List deployments for a project         |
+| `createos deployments logs`           | Stream runtime logs for a deployment   |
+| `createos deployments build-logs`     | Stream build logs for a deployment     |
+| `createos deployments promote`        | Promote a deployment to an environment |
+| `createos deployments retrigger`      | Retrigger a deployment                 |
+| `createos deployments sleep`          | Put a running deployment to sleep      |
+| `createos deployments wakeup`         | Wake up a sleeping deployment          |
+| `createos deployments cancel-build`   | Cancel a deployment that is building   |
 
 ### Environments
 
 | Command                        | Description                     |
 | ------------------------------ | ------------------------------- |
 | `createos environments list`   | List environments for a project |
+| `createos environments create` | Create a new environment        |
 | `createos environments delete` | Delete an environment           |
 
 ### Environment Variables
@@ -357,12 +360,15 @@ createos projects unsuspend --project <id> --force
 createos deployments list --project <id>
 createos deployments logs --project <id> --deployment <id>
 createos deployments build-logs --project <id> --deployment <id>
+createos deployments promote --project <id> --deployment <id> --environment <id>
 createos deployments retrigger --project <id> --deployment <id>
+createos deployments sleep --project <id> --deployment <id> --force
 createos deployments wakeup --project <id> --deployment <id>
-createos deployments cancel --project <id> --deployment <id> --force
+createos deployments cancel-build --project <id> --deployment <id> --force
 
 # Environments
 createos environments list --project <id>
+createos environments create --project <id> --name "Staging" --unique-name staging --branch develop
 createos environments delete --project <id> --environment <id> --force
 
 # Environment variables

cmd/deployments/build_logs.go

@@ -37,7 +37,7 @@ func newDeploymentBuildLogsCommand() *cli.Command {
 				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
 			}
 
-			projectID, deploymentID, err := resolveDeployment(c, client)
+			projectID, deploymentID, err := resolveDeployment(c, client, nil)
 			if err != nil {
 				return err
 			}

cmd/deployments/cancel.go

@@ -12,8 +12,8 @@ import (
 
 func newDeploymentDeleteCommand() *cli.Command {
 	return &cli.Command{
-		Name:  "cancel",
-		Usage: "Cancel a running deployment",
+		Name:  "cancel-build",
+		Usage: "Cancel a deployment that is building",
 		Flags: []cli.Flag{
 			&cli.StringFlag{Name: "project", Usage: "Project ID"},
 			&cli.StringFlag{Name: "deployment", Usage: "Deployment ID"},
@@ -25,7 +25,7 @@ func newDeploymentDeleteCommand() *cli.Command {
 				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
 			}
 
-			projectID, deploymentID, err := resolveDeployment(c, client)
+			projectID, deploymentID, err := resolveDeployment(c, client, []string{"building", "queue"})
 			if err != nil {
 				return err
 			}

cmd/deployments/deployments.go

@@ -14,7 +14,9 @@ func NewDeploymentsCommand() *cli.Command {
 			newDeploymentsListCommand(),
 			newDeploymentBuildLogsCommand(),
 			newDeploymentLogsCommand(),
+			newDeploymentPromoteCommand(),
 			newDeploymentRetriggerCommand(),
+			newDeploymentSleepCommand(),
 			newDeploymentDeleteCommand(),
 			newDeploymentWakeupCommand(),
 		},

cmd/deployments/helpers.go

@@ -13,7 +13,8 @@ import (
 
 // resolveDeployment resolves projectID and deploymentID from flags or interactively.
 // Uses --project and --deployment flags; falls back to config and interactive select.
-func resolveDeployment(c *cli.Context, client *api.APIClient) (string, string, error) {
+// Optional statusFilter limits which deployments are shown; pass nil to show all.
+func resolveDeployment(c *cli.Context, client *api.APIClient, statusFilter []string) (string, string, error) {
 	projectID, err := cmdutil.ResolveProjectID(c.String("project"))
 	if err != nil {
 		return "", "", err
@@ -23,25 +24,67 @@ func resolveDeployment(c *cli.Context, client *api.APIClient) (string, string, e
 		return projectID, deploymentID, nil
 	}
 
-	deploymentID, err := pickDeployment(client, projectID)
+	deploymentID, err := pickDeployment(client, projectID, statusFilter)
 	if err != nil {
 		return "", "", err
 	}
 	return projectID, deploymentID, nil
 }
 
-func pickDeployment(client *api.APIClient, projectID string) (string, error) {
-	deployments, err := client.ListDeployments(projectID)
+func pickDeployment(client *api.APIClient, projectID string, statusFilter []string) (string, error) {
+	allDeployments, err := client.ListDeployments(projectID)
 	if err != nil {
 		return "", err
 	}
-	if len(deployments) == 0 {
+	if len(allDeployments) == 0 {
 		return "", fmt.Errorf("no deployments found for this project")
 	}
-	if len(deployments) == 1 {
-		return deployments[0].ID, nil
+
+	// Filter by status if a filter is provided
+	deployments := allDeployments
+	if len(statusFilter) > 0 {
+		allowed := make(map[string]bool, len(statusFilter))
+		for _, s := range statusFilter {
+			allowed[s] = true
+		}
+		filtered := make([]api.Deployment, 0, len(allDeployments))
+		for _, d := range allDeployments {
+			if allowed[d.Status] {
+				filtered = append(filtered, d)
+			}
+		}
+		deployments = filtered
 	}
 
+	if len(deployments) == 0 {
+		return "", fmt.Errorf("no eligible deployments found for this action")
+	}
+
+	// Non-interactive: auto-pick single, error on multiple
+	if !terminal.IsInteractive() {
+		if len(deployments) == 1 {
+			return deployments[0].ID, nil
+		}
+		return "", fmt.Errorf("multiple deployments found — use --deployment <id> to specify one\n\n  To see your deployments, run:\n    createos deployments list")
+	}
+
+	// Interactive: show table then let user pick
+	tableData := pterm.TableData{
+		{"#", "ID", "Status", "URL", "Created At"},
+	}
+	for i, d := range deployments {
+		tableData = append(tableData, []string{
+			fmt.Sprintf("%d", i+1),
+			d.ID,
+			d.Status,
+			d.Extra.Endpoint,
+			d.CreatedAt.Format("2006-01-02 15:04:05"),
+		})
+	}
+	fmt.Println()
+	_ = pterm.DefaultTable.WithHasHeader().WithData(tableData).Render()
+	fmt.Println()
+
 	options := make([]string, len(deployments))
 	for i, d := range deployments {
 		id := d.ID
@@ -62,9 +105,7 @@ func pickDeployment(client *api.APIClient, projectID string) (string, error) {
 		}
 		options[i] = label
 	}
-	if !terminal.IsInteractive() {
-		return "", fmt.Errorf("multiple deployments found — use --deployment <id> to specify one\n\n  To see your deployments, run:\n    createos deployments list")
-	}
+
 	selected, err := pterm.DefaultInteractiveSelect.
 		WithOptions(options).
 		WithDefaultText("Select a deployment").

cmd/deployments/logs.go

@@ -38,7 +38,7 @@ func newDeploymentLogsCommand() *cli.Command {
 				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
 			}
 
-			projectID, deploymentID, err := resolveDeployment(c, client)
+			projectID, deploymentID, err := resolveDeployment(c, client, nil)
 			if err != nil {
 				return err
 			}

cmd/deployments/promote.go

@@ -0,0 +1,86 @@
+package deployments
+
+import (
+	"fmt"
+
+	"github.com/pterm/pterm"
+	"github.com/urfave/cli/v2"
+
+	"github.com/NodeOps-app/createos-cli/internal/api"
+	"github.com/NodeOps-app/createos-cli/internal/terminal"
+)
+
+// promotableStatuses are deployment statuses whose artifact has been pushed.
+var promotableStatuses = []string{"deployed", "deploying", "crashing", "sleeping", "terminating"}
+
+func newDeploymentPromoteCommand() *cli.Command {
+	return &cli.Command{
+		Name:  "promote",
+		Usage: "Promote a deployment to an environment",
+		Flags: []cli.Flag{
+			&cli.StringFlag{Name: "project", Usage: "Project ID"},
+			&cli.StringFlag{Name: "deployment", Usage: "Deployment ID"},
+			&cli.StringFlag{Name: "environment", Usage: "Environment ID"},
+		},
+		Action: func(c *cli.Context) error {
+			client, ok := c.App.Metadata[api.ClientKey].(*api.APIClient)
+			if !ok {
+				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
+			}
+
+			projectID, deploymentID, err := resolveDeployment(c, client, promotableStatuses)
+			if err != nil {
+				return err
+			}
+
+			environmentID := c.String("environment")
+			if environmentID == "" {
+				environmentID, err = pickEnvironment(client, projectID)
+				if err != nil {
+					return err
+				}
+			}
+
+			if err := client.PromoteDeployment(projectID, environmentID, deploymentID); err != nil {
+				return err
+			}
+
+			pterm.Success.Println("Deployment promoted to environment.")
+			return nil
+		},
+	}
+}
+
+func pickEnvironment(client *api.APIClient, projectID string) (string, error) {
+	envs, err := client.ListEnvironments(projectID)
+	if err != nil {
+		return "", err
+	}
+	if len(envs) == 0 {
+		return "", fmt.Errorf("no environments found for this project\n\n  Create one first with:\n    createos environments create")
+	}
+	if len(envs) == 1 {
+		return envs[0].ID, nil
+	}
+
+	options := make([]string, len(envs))
+	for i, e := range envs {
+		options[i] = fmt.Sprintf("%s (%s)", e.DisplayName, e.Status)
+	}
+	if !terminal.IsInteractive() {
+		return "", fmt.Errorf("multiple environments found — use --environment <id> to specify one\n\n  To see your environments, run:\n    createos environments list")
+	}
+	selected, err := pterm.DefaultInteractiveSelect.
+		WithOptions(options).
+		WithDefaultText("Select an environment to promote to").
+		Show()
+	if err != nil {
+		return "", fmt.Errorf("could not read selection: %w", err)
+	}
+	for i, opt := range options {
+		if opt == selected {
+			return envs[i].ID, nil
+		}
+	}
+	return "", fmt.Errorf("no environment selected")
+}

cmd/deployments/retrigger.go

@@ -23,7 +23,7 @@ func newDeploymentRetriggerCommand() *cli.Command {
 				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
 			}
 
-			projectID, deploymentID, err := resolveDeployment(c, client)
+			projectID, deploymentID, err := resolveDeployment(c, client, nil)
 			if err != nil {
 				return err
 			}

cmd/deployments/sleep.go

@@ -0,0 +1,60 @@
+package deployments
+
+import (
+	"fmt"
+
+	"github.com/pterm/pterm"
+	"github.com/urfave/cli/v2"
+
+	"github.com/NodeOps-app/createos-cli/internal/api"
+	"github.com/NodeOps-app/createos-cli/internal/terminal"
+)
+
+func newDeploymentSleepCommand() *cli.Command {
+	return &cli.Command{
+		Name:  "sleep",
+		Usage: "Put a running deployment to sleep",
+		Flags: []cli.Flag{
+			&cli.StringFlag{Name: "project", Usage: "Project ID"},
+			&cli.StringFlag{Name: "deployment", Usage: "Deployment ID"},
+			&cli.BoolFlag{Name: "force", Aliases: []string{"f"}, Usage: "Skip confirmation prompt"},
+		},
+		Action: func(c *cli.Context) error {
+			client, ok := c.App.Metadata[api.ClientKey].(*api.APIClient)
+			if !ok {
+				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
+			}
+
+			projectID, deploymentID, err := resolveDeployment(c, client, []string{"deployed", "deploying", "crashing"})
+			if err != nil {
+				return err
+			}
+
+			if !c.Bool("force") {
+				if !terminal.IsInteractive() {
+					return fmt.Errorf("confirmation required — use --force to sleep without a prompt")
+				}
+
+				confirm, err := pterm.DefaultInteractiveConfirm.
+					WithDefaultText(fmt.Sprintf("Are you sure you want to put deployment %q to sleep?", deploymentID)).
+					WithDefaultValue(false).
+					Show()
+				if err != nil {
+					return fmt.Errorf("could not read confirmation: %w", err)
+				}
+
+				if !confirm {
+					fmt.Println("Cancelled. Your deployment was not put to sleep.")
+					return nil
+				}
+			}
+
+			if err := client.SleepDeployment(projectID, deploymentID); err != nil {
+				return err
+			}
+
+			pterm.Success.Println("Deployment is being put to sleep.")
+			return nil
+		},
+	}
+}

cmd/deployments/wakeup.go

@@ -23,7 +23,7 @@ func newDeploymentWakeupCommand() *cli.Command {
 				return fmt.Errorf("you're not signed in — run 'createos login' to get started")
 			}
 
-			projectID, deploymentID, err := resolveDeployment(c, client)
+			projectID, deploymentID, err := resolveDeployment(c, client, []string{"sleeping"})
 			if err != nil {
 				return err
 			}