feat: add --refresh (-r) flag to ps command to remove stale deployments

.golangci.yaml

@@ -19,6 +19,10 @@ linters:
     gosec:
       excludes:
         - G306
+    revive:
+      rules:
+        - name: var-naming
+          disabled: true
 
 formatters:
   enable:

internal/banner/banner.go

@@ -163,7 +163,7 @@ func randomQuote() string {
 
 // isTerminal checks if stdout is a terminal.
 func isTerminal() bool {
-	return term.IsTerminal(int(os.Stdout.Fd()))
+	return term.IsTerminal(int(os.Stdout.Fd())) // #nosec G115 -- Fd() returns a small file descriptor, no overflow risk
 }
 
 // flush forces stdout to display buffered content immediately.

internal/cli/ps.go

@@ -12,10 +12,16 @@ import (
 
 // newPsCommand creates the ps command.
 func (c *CLI) newPsCommand() *cobra.Command {
-	return &cobra.Command{
+	cmd := &cobra.Command{
 		Use:   "ps",
 		Short: "List running deployments and their status",
-		Run: func(_ *cobra.Command, _ []string) {
+		Run: func(cmd *cobra.Command, _ []string) {
+			refresh, err := cmd.Flags().GetBool("refresh")
+			if err != nil {
+				log.Error().Msgf("%v", err)
+				return
+			}
+
 			deployments, err := c.app.StateManager.ListDeployments()
 			if err != nil {
 				log.Error().Msgf("%v", err)
@@ -41,12 +47,27 @@ func (c *CLI) newPsCommand() *cobra.Command {
 				}
 
 				status := "unknown"
+				statusErr := false
 				if s, err := provider.Status(template); err != nil {
 					log.Error().Msgf("%v", err)
+					statusErr = true
 				} else {
 					status = s
 				}
 
+				if refresh && status != "running" {
+					if statusErr {
+						log.Warn().Msgf("skipping refresh for %s on %s: status could not be determined", deployment.TemplateID, deployment.ProviderName)
+					} else {
+						if err := c.app.StateManager.RemoveDeployment(deployment.ProviderName, deployment.TemplateID); err != nil {
+							log.Error().Msgf("%v", err)
+						} else {
+							log.Info().Msgf("removed stale deployment %s on %s", deployment.TemplateID, deployment.ProviderName)
+						}
+						continue
+					}
+				}
+
 				t.AppendRow(table.Row{
 					deployment.ProviderName,
 					deployment.TemplateID,
@@ -64,4 +85,8 @@ func (c *CLI) newPsCommand() *cobra.Command {
 			t.Render()
 		},
 	}
+
+	cmd.Flags().BoolP("refresh", "r", false, "Remove stale deployments that are no longer running")
+
+	return cmd
 }