refactor(modular-cmds): add address book modular cmds

.changeset/few-chefs-guess.md

@@ -0,0 +1,5 @@
+---
+"chainlink-deployments-framework": patch
+---
+
+refactor(modular-cmds): create addressbook modular command and delegate legacy one to it

engine/cld/commands/addressbook/command.go

@@ -0,0 +1,83 @@
+package addressbook
+
+import (
+	"errors"
+	"strings"
+
+	"github.com/spf13/cobra"
+
+	"github.com/smartcontractkit/chainlink-deployments-framework/engine/cld/commands/text"
+	"github.com/smartcontractkit/chainlink-deployments-framework/engine/cld/domain"
+	"github.com/smartcontractkit/chainlink-deployments-framework/pkg/logger"
+)
+
+var (
+	addressbookShort = "Address book operations"
+
+	addressbookLong = text.LongDesc(`
+		Commands for managing address book artifacts.
+
+		The address book contains contract addresses and type/version information for deployed contracts.
+		These commands allow merging changeset artifacts, migrating to the new datastore format,
+		and removing changeset entries.
+	`)
+)
+
+// Config holds the configuration for addressbook commands.
+type Config struct {
+	// Logger is the logger to use for command output. Required.
+	Logger logger.Logger
+
+	// Domain is the domain context for the commands. Required.
+	Domain domain.Domain
+
+	// Deps holds optional dependencies that can be overridden.
+	// If fields are nil, production defaults are used.
+	Deps Deps
+}
+
+// Validate checks that all required configuration fields are set.
+func (c Config) Validate() error {
+	var missing []string
+
+	if c.Logger == nil {
+		missing = append(missing, "Logger")
+	}
+	if c.Domain.RootPath() == "" {
+		missing = append(missing, "Domain")
+	}
+
+	if len(missing) > 0 {
+		return errors.New("addressbook.Config: missing required fields: " + strings.Join(missing, ", "))
+	}
+
+	return nil
+}
+
+// deps returns the Deps with defaults applied.
+func (c *Config) deps() *Deps {
+	c.Deps.applyDefaults()
+
+	return &c.Deps
+}
+
+// NewCommand creates a new address-book command with all subcommands.
+func NewCommand(cfg Config) (*cobra.Command, error) {
+	if err := cfg.Validate(); err != nil {
+		return nil, err
+	}
+
+	cfg.deps()
+
+	cmd := &cobra.Command{
+		Use:   "address-book",
+		Short: addressbookShort,
+		Long:  addressbookLong,
+	}
+
+	cmd.AddCommand(newMergeCmd(cfg))
+	cmd.AddCommand(newMigrateCmd(cfg))
+	cmd.AddCommand(newRemoveCmd(cfg))
+
+	return cmd, nil
+}