Checkpoint.

Author: masegraye

cmd/docker-mcp/commands/feature.go

@@ -0,0 +1,206 @@
+package commands
+
+import (
+	"fmt"
+	"strconv"
+
+	"github.com/docker/cli/cli/command"
+	"github.com/docker/cli/cli/config/configfile"
+	"github.com/spf13/cobra"
+)
+
+// featureCommand creates the `feature` command and its subcommands
+func featureCommand(dockerCli command.Cli) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "feature",
+		Short: "Manage experimental features",
+		Long: `Manage experimental features for Docker MCP Gateway.
+
+Features are stored in your Docker configuration file (~/.docker/config.json)
+and control optional functionality that may change in future versions.`,
+	}
+
+	cmd.AddCommand(
+		featureEnableCommand(dockerCli),
+		featureDisableCommand(dockerCli),
+		featureListCommand(dockerCli),
+	)
+
+	return cmd
+}
+
+// featureEnableCommand creates the `feature enable` command
+func featureEnableCommand(dockerCli command.Cli) *cobra.Command {
+	return &cobra.Command{
+		Use:   "enable <feature-name>",
+		Short: "Enable an experimental feature",
+		Long: `Enable an experimental feature.
+
+Available features:
+  configured-catalogs    Allow gateway to use user-managed catalogs alongside Docker catalog`,
+		Args: cobra.ExactArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			featureName := args[0]
+
+			// Validate feature name
+			if !isKnownFeature(featureName) {
+				return fmt.Errorf("unknown feature: %s\n\nAvailable features:\n  configured-catalogs    Allow gateway to use user-managed catalogs", featureName)
+			}
+
+			// Enable the feature
+			configFile := dockerCli.ConfigFile()
+			if configFile.Features == nil {
+				configFile.Features = make(map[string]string)
+			}
+			configFile.Features[featureName] = "enabled"
+
+			// Save the configuration
+			if err := configFile.Save(); err != nil {
+				return fmt.Errorf("failed to save configuration: %w", err)
+			}
+
+			fmt.Printf("Feature '%s' enabled successfully.\n", featureName)
+
+			// Provide usage hints for configured-catalogs
+			if featureName == "configured-catalogs" {
+				fmt.Println("\nTo use configured catalogs with the gateway, run:")
+				fmt.Println("  docker mcp gateway run --use-configured-catalogs")
+				fmt.Println("\nTo create and manage catalogs, use:")
+				fmt.Println("  docker mcp catalog create <name>")
+				fmt.Println("  docker mcp catalog add <catalog> <server-name> <server-file>")
+			}
+
+			return nil
+		},
+	}
+}
+
+// featureDisableCommand creates the `feature disable` command
+func featureDisableCommand(dockerCli command.Cli) *cobra.Command {
+	return &cobra.Command{
+		Use:   "disable <feature-name>",
+		Short: "Disable an experimental feature",
+		Long:  "Disable an experimental feature that was previously enabled.",
+		Args:  cobra.ExactArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			featureName := args[0]
+
+			// Validate feature name
+			if !isKnownFeature(featureName) {
+				return fmt.Errorf("unknown feature: %s", featureName)
+			}
+
+			// Disable the feature
+			configFile := dockerCli.ConfigFile()
+			if configFile.Features == nil {
+				configFile.Features = make(map[string]string)
+			}
+			configFile.Features[featureName] = "disabled"
+
+			// Save the configuration
+			if err := configFile.Save(); err != nil {
+				return fmt.Errorf("failed to save configuration: %w", err)
+			}
+
+			fmt.Printf("Feature '%s' disabled successfully.\n", featureName)
+			return nil
+		},
+	}
+}
+
+// featureListCommand creates the `feature list` command
+func featureListCommand(dockerCli command.Cli) *cobra.Command {
+	return &cobra.Command{
+		Use:   "list",
+		Short: "List all available features and their status",
+		Long:  "List all available experimental features and show whether they are enabled or disabled.",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			configFile := dockerCli.ConfigFile()
+
+			fmt.Println("Available experimental features:")
+			fmt.Println()
+
+			// Show all known features
+			knownFeatures := []string{"configured-catalogs"}
+			for _, feature := range knownFeatures {
+				status := "disabled"
+				if isFeatureEnabledFromCli(dockerCli, feature) {
+					status = "enabled"
+				}
+
+				fmt.Printf("  %-20s %s\n", feature, status)
+
+				// Add description for each feature
+				switch feature {
+				case "configured-catalogs":
+					fmt.Printf("  %-20s %s\n", "", "Allow gateway to use user-managed catalogs alongside Docker catalog")
+				}
+				fmt.Println()
+			}
+
+			// Show any other features in config that we don't know about
+			if configFile.Features != nil {
+				unknownFeatures := make([]string, 0)
+				for feature := range configFile.Features {
+					if !isKnownFeature(feature) {
+						unknownFeatures = append(unknownFeatures, feature)
+					}
+				}
+
+				if len(unknownFeatures) > 0 {
+					fmt.Println("Unknown features in configuration:")
+					for _, feature := range unknownFeatures {
+						status := configFile.Features[feature]
+						fmt.Printf("  %-20s %s (unknown)\n", feature, status)
+					}
+				}
+			}
+
+			return nil
+		},
+	}
+}
+
+// isFeatureEnabledFromCli checks if a feature is enabled using the CLI interface
+func isFeatureEnabledFromCli(dockerCli command.Cli, feature string) bool {
+	configFile := dockerCli.ConfigFile()
+	return isFeatureEnabledFromConfig(configFile, feature)
+}
+
+// isFeatureEnabledFromConfig checks if a feature is enabled from a config file
+func isFeatureEnabledFromConfig(configFile *configfile.ConfigFile, feature string) bool {
+	if configFile.Features == nil {
+		return false
+	}
+
+	value, exists := configFile.Features[feature]
+	if !exists {
+		return false
+	}
+
+	// Handle both boolean string values and "enabled"/"disabled" strings
+	if value == "enabled" {
+		return true
+	}
+	if value == "disabled" {
+		return false
+	}
+
+	// Fallback to parsing as boolean
+	enabled, err := strconv.ParseBool(value)
+	return err == nil && enabled
+}
+
+// isKnownFeature checks if the feature name is valid
+func isKnownFeature(feature string) bool {
+	knownFeatures := []string{
+		"configured-catalogs",
+	}
+
+	for _, known := range knownFeatures {
+		if feature == known {
+			return true
+		}
+	}
+	return false
+}