feat: add adder to generate cmd stubs from markdown

.adder.yaml

@@ -0,0 +1,10 @@
+# Adder configuration file
+# See https://github.com/jrschumacher/adder for documentation
+
+binary_name: otdfctl
+input: docs/man
+output: cmd/generated
+package: generated
+generated_file_suffix: _generated.go
+index_format: _index
+package_strategy: directory

Makefile

@@ -93,3 +93,33 @@ test-bats: build-test
 .PHONY: clean
 clean:
 	rm -rf $(TARGET_DIR)
+
+# Target for generating CLI commands from documentation
+# NOTE: Generated files require manual implementation of handler interfaces
+# and should be committed to the repository after implementation
+.PHONY: generate
+generate:
+	go run github.com/jrschumacher/adder/cmd/adder@v0.1.1 generate -o cmd/generated
+
+# Target for cleaning generated files
+.PHONY: clean-generated
+clean-generated:
+	rm -rf cmd/generated/
+
+# Target for regenerating (clean + generate)
+# WARNING: This will remove existing generated files - ensure handlers are implemented elsewhere
+.PHONY: regenerate
+regenerate: clean-generated generate
+
+# Target for checking required tools are available
+.PHONY: toolcheck
+toolcheck:
+	@echo "Checking required tools..."
+	@command -v go >/dev/null 2>&1 || { echo >&2 "go is required but not installed. Visit https://golang.org/dl/"; exit 1; }
+	@echo "✓ go is available"
+	@go version 2>/dev/null | grep -q "go1\." || { echo >&2 "go version check failed"; exit 1; }
+	@echo "✓ go version is compatible"
+	@go run github.com/jrschumacher/adder/cmd/adder@v0.1.1 version >/dev/null 2>&1 || { echo >&2 "adder tool check failed. Run 'go mod download' to ensure dependencies are available."; exit 1; }
+	@echo "✓ adder is available"
+	@command -v bats >/dev/null 2>&1 || echo "⚠ bats is not installed (required for e2e tests). Install with: brew install bats-core"
+	@echo "All required tools are available!"

cmd/config.go

@@ -3,39 +3,42 @@ package cmd
 import (
 	"fmt"
 
+	configgenerated "github.com/opentdf/otdfctl/cmd/generated/config"
 	"github.com/opentdf/otdfctl/pkg/cli"
 	"github.com/opentdf/otdfctl/pkg/config"
-	"github.com/opentdf/otdfctl/pkg/man"
 	"github.com/spf13/cobra"
 )
 
-func config_updateOutput(cmd *cobra.Command, args []string) {
-	c := cli.New(cmd, args)
+// handleConfigOutput implements the business logic for the config output command
+func handleConfigOutput(cmd *cobra.Command, req *configgenerated.OutputRequest) error {
+	c := cli.New(cmd, []string{})
 	h := NewHandler(c)
 	defer h.Close()
 
-	format := c.Flags.GetRequiredString("format")
+	format := req.Flags.Format
 
 	err := config.UpdateOutputFormat(cfgKey, format)
 	if err != nil {
 		c.ExitWithError("Failed to update output format", err)
 	}
 
 	c.Println(cli.SuccessMessage(fmt.Sprintf("Output format updated to %s", format)))
+	return nil
+}
+
+// handleConfig implements the parent config command (shows help if called without subcommands)
+func handleConfig(cmd *cobra.Command, req *configgenerated.ConfigRequest) error {
+	return cmd.Help()
 }
 
 func init() {
-	outputCmd := man.Docs.GetCommand("config/output",
-		man.WithRun(config_updateOutput),
-	)
-	outputCmd.Flags().String(
-		outputCmd.GetDocFlag("format").Name,
-		outputCmd.GetDocFlag("format").Default,
-		outputCmd.GetDocFlag("format").Description,
-	)
-
-	cmd := man.Docs.GetCommand("config",
-		man.WithSubcommands(outputCmd),
-	)
-	RootCmd.AddCommand(&cmd.Command)
+	// Create commands using generated constructors with handler functions
+	configCmd := configgenerated.NewConfigCommand(handleConfig)
+	outputCmd := configgenerated.NewOutputCommand(handleConfigOutput)
+
+	// Add subcommand to parent
+	configCmd.AddCommand(outputCmd)
+
+	// Add to root command
+	RootCmd.AddCommand(configCmd)
 }

cmd/dev-selectors.go

@@ -2,19 +2,21 @@ package cmd
 
 import (
 	"fmt"
+	"strings"
 
+	selectorsgenerated "github.com/opentdf/otdfctl/cmd/generated/dev/selectors"
 	"github.com/opentdf/otdfctl/pkg/cli"
 	"github.com/opentdf/otdfctl/pkg/handlers"
-	"github.com/opentdf/otdfctl/pkg/man"
 	"github.com/spf13/cobra"
 )
 
 var selectors []string
 
-func dev_selectorsGen(cmd *cobra.Command, args []string) {
-	c := cli.New(cmd, args)
-	h := NewHandler(c)
-	defer h.Close()
+// handleDevSelectorsGenerate implements the business logic for the generate command
+func handleDevSelectorsGenerate(cmd *cobra.Command, req *selectorsgenerated.GenerateRequest) error {
+	c := cli.New(cmd, []string{})
+	handler := NewHandler(c)
+	defer handler.Close()
 
 	subject := c.Flags.GetRequiredString("subject")
 
@@ -30,15 +32,26 @@ func dev_selectorsGen(cmd *cobra.Command, args []string) {
 
 	t := cli.NewTabular(rows...)
 	cli.PrintSuccessTable(cmd, "", t)
+	return nil
 }
 
-func dev_selectorsTest(cmd *cobra.Command, args []string) {
-	c := cli.New(cmd, args)
-	h := NewHandler(c)
-	defer h.Close()
+// handleDevSelectorsTest implements the business logic for the test command
+func handleDevSelectorsTest(cmd *cobra.Command, req *selectorsgenerated.TestRequest) error {
+	c := cli.New(cmd, []string{})
+	handler := NewHandler(c)
+	defer handler.Close()
 
 	subject := c.Flags.GetRequiredString("subject")
-	selectors = c.Flags.GetStringSlice("selector", selectors, cli.FlagsStringSliceOptions{Min: 1})
+
+	// Convert single selector string to slice for compatibility with existing logic
+	var selectorsList []string
+	if req.Flags.Selector != "" {
+		selectorsList = strings.Split(req.Flags.Selector, ",")
+	}
+
+	if len(selectorsList) == 0 {
+		cli.ExitWithError("Must provide at least one selector", nil)
+	}
 
 	flattened, err := handlers.FlattenSubjectContext(subject)
 	if err != nil {
@@ -47,7 +60,8 @@ func dev_selectorsTest(cmd *cobra.Command, args []string) {
 
 	rows := [][]string{}
 	for _, item := range flattened {
-		for _, selector := range selectors {
+		for _, selector := range selectorsList {
+			selector = strings.TrimSpace(selector)
 			if selector == item.Key {
 				rows = append(rows, []string{item.Key, fmt.Sprintf("%v", item.Value)})
 			}
@@ -56,40 +70,31 @@ func dev_selectorsTest(cmd *cobra.Command, args []string) {
 
 	t := cli.NewTabular(rows...)
 	cli.PrintSuccessTable(cmd, "", t)
+	return nil
 }
 
 func init() {
-	genCmd := man.Docs.GetCommand("dev/selectors/generate",
-		man.WithRun(dev_selectorsGen),
-	)
-	genCmd.Flags().StringP(
-		genCmd.GetDocFlag("subject").Name,
-		genCmd.GetDocFlag("subject").Shorthand,
-		genCmd.GetDocFlag("subject").Default,
-		genCmd.GetDocFlag("subject").Description,
-	)
-
-	testCmd := man.Docs.GetCommand("dev/selectors/test",
-		man.WithRun(dev_selectorsTest),
-	)
-	testCmd.Flags().StringP(
-		testCmd.GetDocFlag("subject").Name,
-		testCmd.GetDocFlag("subject").Shorthand,
-		testCmd.GetDocFlag("subject").Default,
-		testCmd.GetDocFlag("subject").Description,
-	)
-	testCmd.Flags().StringSliceVarP(
-		&selectors,
-		testCmd.GetDocFlag("selector").Name,
-		testCmd.GetDocFlag("selector").Shorthand,
-		[]string{},
-		testCmd.GetDocFlag("selector").Description,
-	)
-
-	doc := man.Docs.GetCommand("dev/selectors",
-		man.WithSubcommands(genCmd, testCmd),
-	)
-
-	dev_selectorsCmd := &doc.Command
-	devCmd.AddCommand(dev_selectorsCmd)
+	// Create commands using generated code with handler functions
+	genCmd := selectorsgenerated.NewGenerateCommand(handleDevSelectorsGenerate)
+	testCmd := selectorsgenerated.NewTestCommand(handleDevSelectorsTest)
+
+	// Create selectors parent command
+	selectorsCmd := &cobra.Command{
+		Use:     "selectors",
+		Aliases: []string{"sel"},
+		Short:   "Selectors",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return cmd.Help()
+		},
+	}
+
+	// Add subcommands
+	selectorsCmd.AddCommand(genCmd)
+	selectorsCmd.AddCommand(testCmd)
+
+	// Export for use by dev.go
+	DevSelectorsCmd = selectorsCmd
 }
+
+// DevSelectorsCmd exports the selectors command for use by dev.go
+var DevSelectorsCmd *cobra.Command

cmd/dev.go

@@ -15,9 +15,6 @@ import (
 	"github.com/spf13/cobra"
 )
 
-// devCmd is the command for playground-style development
-var devCmd = man.Docs.GetCommand("dev")
-
 var (
 	metadataLabels        []string
 	defaultListFlagLimit  int32 = 300
@@ -153,9 +150,24 @@ func readPipedStdin() []byte {
 }
 
 func init() {
+	// Create dev command
+	devCmd := &cobra.Command{
+		Use:    "dev",
+		Short:  "Development Tools",
+		Hidden: true,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return cmd.Help()
+		},
+	}
+
+	// Create design-system subcommand using manual approach (complex UI logic)
 	designCmd := man.Docs.GetCommand("dev/design-system",
 		man.WithRun(dev_designSystem),
 	)
 	devCmd.AddCommand(&designCmd.Command)
-	RootCmd.AddCommand(&devCmd.Command)
+
+	// Add selectors subcommand (from dev-selectors.go)
+	devCmd.AddCommand(DevSelectorsCmd)
+
+	RootCmd.AddCommand(devCmd)
 }