feat(cli): add ConfigCommand helper for config init/list

Replaces ~50 lines of identical boilerplate in every raystack CLI:

  rootCmd.AddCommand(cli.ConfigCommand("frontier", &Config{}))

Adds "config init" (creates config file with defaults) and
"config list" (shows current config as JSON). Uses config.WithAppConfig
for standard file location (~/.config/raystack/<app>.yml).

Author: ravisuhag

cli/cli.go

@@ -38,7 +38,7 @@ type cliContext struct {
 //
 // The developer owns the root command — Init only adds features to it.
 func Init(rootCmd *cobra.Command, opts ...Option) {
-	cfg := &config{}
+	cfg := &initConfig{}
 	for _, opt := range opts {
 		opt(cfg)
 	}

cli/config_cmd.go

@@ -0,0 +1,70 @@
+package cli
+
+import (
+	"fmt"
+
+	"github.com/raystack/salt/config"
+	"github.com/spf13/cobra"
+)
+
+// ConfigCommand returns a "config" command with "init" and "list" subcommands
+// for managing client-side CLI configuration.
+//
+// The appName is used to determine the config file location
+// (~/.config/raystack/<appName>.yml). The defaultCfg is a pointer to a struct
+// with default values used when initializing a new config file.
+//
+// Usage:
+//
+//	rootCmd.AddCommand(cli.ConfigCommand("frontier", &Config{}))
+func ConfigCommand(appName string, defaultCfg interface{}) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:     "config <command>",
+		Short:   "Manage client configuration",
+		Example: fmt.Sprintf("  $ %s config init\n  $ %s config list", appName, appName),
+	}
+
+	cmd.AddCommand(configInitCmd(appName, defaultCfg))
+	cmd.AddCommand(configListCmd(appName))
+
+	return cmd
+}
+
+func configInitCmd(appName string, defaultCfg interface{}) *cobra.Command {
+	return &cobra.Command{
+		Use:     "init",
+		Short:   "Initialize a new configuration file",
+		Example: fmt.Sprintf("  $ %s config init", appName),
+		Annotations: map[string]string{
+			"group": "core",
+		},
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			loader := config.NewLoader(config.WithAppConfig(appName))
+			if err := loader.Init(defaultCfg); err != nil {
+				return err
+			}
+			Output(cmd).Success("config initialized")
+			return nil
+		},
+	}
+}
+
+func configListCmd(appName string) *cobra.Command {
+	return &cobra.Command{
+		Use:     "list",
+		Short:   "List current configuration",
+		Example: fmt.Sprintf("  $ %s config list", appName),
+		Annotations: map[string]string{
+			"group": "core",
+		},
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			loader := config.NewLoader(config.WithAppConfig(appName))
+			data, err := loader.View()
+			if err != nil {
+				return fmt.Errorf("failed to load config: %w", err)
+			}
+			Output(cmd).Println(data)
+			return nil
+		},
+	}
+}

cli/option.go

@@ -2,31 +2,31 @@ package cli
 
 import "github.com/raystack/salt/cli/commander"
 
-type config struct {
+type initConfig struct {
 	version string
 	repo    string
 	topics  []commander.HelpTopic
 	hooks   []commander.HookBehavior
 }
 
 // Option configures cli.Init.
-type Option func(*config)
+type Option func(*initConfig)
 
 // Version enables a version command with update checking.
 // The repo should be in "owner/repo" format (e.g. "raystack/frontier").
 func Version(ver, repo string) Option {
-	return func(c *config) {
+	return func(c *initConfig) {
 		c.version = ver
 		c.repo = repo
 	}
 }
 
 // Topics adds help topics to the CLI.
 func Topics(topics ...commander.HelpTopic) Option {
-	return func(c *config) { c.topics = append(c.topics, topics...) }
+	return func(c *initConfig) { c.topics = append(c.topics, topics...) }
 }
 
 // Hooks adds hook behaviors applied to commands.
 func Hooks(hooks ...commander.HookBehavior) Option {
-	return func(c *config) { c.hooks = append(c.hooks, hooks...) }
+	return func(c *initConfig) { c.hooks = append(c.hooks, hooks...) }
 }