refactor(cli): deduplicate boosted card level flag

cmd/cr-api/boosted_levels.go

@@ -7,8 +7,21 @@ import (
 
 	"github.com/klauer/clash-royale-api/go/pkg/deck"
 	"github.com/klauer/clash-royale-api/go/pkg/deck/evaluation"
+	"github.com/urfave/cli/v3"
 )
 
+const (
+	boostedCardLevelFlagName  = "boosted-card-level"
+	boostedCardLevelFlagUsage = "Temporarily override card level for scoring/building (format: CardName:Level, repeatable)"
+)
+
+func boostedCardLevelFlag() *cli.StringSliceFlag {
+	return &cli.StringSliceFlag{
+		Name:  boostedCardLevelFlagName,
+		Usage: boostedCardLevelFlagUsage,
+	}
+}
+
 func parseBoostedCardLevels(entries []string) (map[string]int, error) {
 	overrides := make(map[string]int)
 	for _, entry := range entries {

cmd/cr-api/boosted_levels_test.go

@@ -2,6 +2,18 @@ package main
 
 import "testing"
 
+func TestBoostedCardLevelFlagContract(t *testing.T) {
+	t.Parallel()
+
+	flag := boostedCardLevelFlag()
+	if flag.Name != boostedCardLevelFlagName {
+		t.Fatalf("flag name mismatch: got %q want %q", flag.Name, boostedCardLevelFlagName)
+	}
+	if flag.Usage != boostedCardLevelFlagUsage {
+		t.Fatalf("flag usage mismatch: got %q want %q", flag.Usage, boostedCardLevelFlagUsage)
+	}
+}
+
 func TestParseBoostedCardLevelEntry(t *testing.T) {
 	tests := []struct {
 		name      string

cmd/cr-api/deck_analyze_suite_runtime.go

@@ -465,7 +465,7 @@ func deckAnalyzeSuiteCommand(ctx context.Context, cmd *cli.Command) error {
 	verbose := cmd.Bool("verbose")
 	suggestConstraints := cmd.Bool("suggest-constraints")
 	constraintThreshold := cmd.Float64("constraint-threshold")
-	boostedCardLevels := cmd.StringSlice("boosted-card-level")
+	boostedCardLevels := cmd.StringSlice(boostedCardLevelFlagName)
 
 	// Get global flags
 	apiToken := cmd.String("api-token")

cmd/cr-api/deck_build_commands.go

@@ -37,7 +37,7 @@ func addDeckBuildCommand() *cli.Command {
 			&cli.BoolFlag{Name: "no-suggest-upgrades", Usage: "Disable upgrade recommendations for the built deck (recommendations are shown by default)"},
 			&cli.IntFlag{Name: "upgrade-count", Value: 5, Usage: "Number of upgrade recommendations to show (default 5)"},
 			&cli.BoolFlag{Name: "ideal-deck", Usage: "Show ideal deck composition after applying recommended upgrades"},
-			&cli.StringSliceFlag{Name: "boosted-card-level", Usage: "Temporarily override card level for scoring/building (format: CardName:Level, repeatable)"},
+			boostedCardLevelFlag(),
 			&cli.StringFlag{Name: "fuzz-storage", Usage: "Path to fuzz storage database for data-driven card scoring (default: ~/.cr-api/fuzz_top_decks.db)"},
 			&cli.Float64Flag{Name: "fuzz-weight", Value: 0.10, Usage: "Weight for fuzz-based card scoring (0.0-1.0, default 0.10 = 10%)"},
 			&cli.IntFlag{Name: "fuzz-deck-limit", Value: 100, Usage: "Number of top fuzz decks to analyze for card stats (default 100)"},
@@ -102,7 +102,7 @@ func addDeckBuildSuiteCommand() *cli.Command {
 			&cli.StringFlag{Name: "fuzz-storage", Usage: "Path to fuzz storage database for data-driven card scoring (default: ~/.cr-api/fuzz_top_decks.db)"},
 			&cli.Float64Flag{Name: "fuzz-weight", Value: 0.10, Usage: "Weight for fuzz-based card scoring (0.0-1.0, default 0.10 = 10%)"},
 			&cli.IntFlag{Name: "fuzz-deck-limit", Value: 100, Usage: "Number of top fuzz decks to analyze for card stats (default 100)"},
-			&cli.StringSliceFlag{Name: "boosted-card-level", Usage: "Temporarily override card level for scoring/building (format: CardName:Level, repeatable)"},
+			boostedCardLevelFlag(),
 			&cli.BoolFlag{
 				Name:  "save",
 				Value: true,
@@ -141,7 +141,7 @@ func addDeckAnalyzeSuiteCommand() *cli.Command {
 			&cli.StringFlag{Name: "fuzz-storage", Usage: "Path to fuzz storage database for data-driven card scoring (default: ~/.cr-api/fuzz_top_decks.db)"},
 			&cli.Float64Flag{Name: "fuzz-weight", Value: 0.10, Usage: "Weight for fuzz-based card scoring (0.0-1.0, default 0.10 = 10%)"},
 			&cli.IntFlag{Name: "fuzz-deck-limit", Value: 100, Usage: "Number of top fuzz decks to analyze for card stats (default 100)"},
-			&cli.StringSliceFlag{Name: "boosted-card-level", Usage: "Temporarily override card level for scoring/building (format: CardName:Level, repeatable)"},
+			boostedCardLevelFlag(),
 			&cli.BoolFlag{Name: "suggest-constraints", Usage: "analyze top N decks and suggest card constraints based on frequency", Value: false},
 			&cli.Float64Flag{Name: "constraint-threshold", Usage: "minimum percentage threshold for card suggestions (0-100)", Value: 50.0},
 		},

cmd/cr-api/deck_build_runtime.go

@@ -93,7 +93,7 @@ func parseDeckBuildFlags(cmd *cli.Command) deckBuildFlags {
 		MaxElixir:         cmd.Float64("max-elixir"),
 		DataDir:           cmd.String("data-dir"),
 		ExcludeCards:      cmd.StringSlice("exclude-cards"),
-		BoostedCardLevels: cmd.StringSlice("boosted-card-level"),
+		BoostedCardLevels: cmd.StringSlice(boostedCardLevelFlagName),
 		NoSuggestUpgrades: cmd.Bool("no-suggest-upgrades"),
 		UpgradeCount:      cmd.Int("upgrade-count"),
 		IdealDeck:         cmd.Bool("ideal-deck"),
@@ -169,7 +169,7 @@ func deckBuildSuiteCommand(ctx context.Context, cmd *cli.Command) error {
 	minElixir := cmd.Float64("min-elixir")
 	maxElixir := cmd.Float64("max-elixir")
 	excludeCards := cmd.StringSlice("exclude-cards")
-	boostedCardLevels := cmd.StringSlice("boosted-card-level")
+	boostedCardLevels := cmd.StringSlice(boostedCardLevelFlagName)
 
 	// Determine output directory
 	if outputDir == "" {