Function initCLISession

internal/cli/cli_helpers.go:151–243

initCLISession bootstraps configuration and returns an authenticated session. Returns (nil, nil) when bootstrap handled an early-exit flag (--version, --list-profiles) — callers should return nil without doing further work.

(cmd *cobra.Command)

// Returns (nil, nil) when bootstrap handled an early-exit flag (--version,
// --list-profiles) — callers should return nil without doing further work.
func initCLISession(cmd *cobra.Command) (*cliSession, error) {
	opts := getBootstrapOptions(cmd)
	opts.Quiet = true // suppress TUI startup banners for CLI subcommands

	result, err := bootstrap.Bootstrap(opts)
	if err != nil {
		return nil, fmt.Errorf("bootstrap failed: %w", err)
	}

	if result == nil {
		return nil, nil
	}

	cfg := result.Config

	// Normalize the API URL the same way the TUI does.
	cfg.Addr = strings.TrimRight(cfg.Addr, "/") + "/" + strings.TrimPrefix(cfg.ApiPath, "/")

	// Initialize global cache unless disabled.
	if !result.NoCache {
		if cacheErr := cache.InitGlobalCache(cfg.CacheDir); cacheErr != nil {
			_ = cacheErr // non-fatal; continue without persistent cache
		}
	}

	loggerAdapter := adapters.NewLoggerAdapter(cfg)
	cacheAdapter := adapters.NewCacheAdapter()

	// Single-profile mode.
	if result.InitialGroup == "" {
		configAdapter := adapters.NewConfigAdapter(cfg)

		client, err := api.NewClient(
			configAdapter,
			api.WithLogger(loggerAdapter),
			api.WithCache(cacheAdapter),
		)
		if err != nil {
			return nil, fmt.Errorf("failed to connect to Proxmox API: %w", err)
		}

		return &cliSession{single: client, cfg: cfg}, nil
	}

	// Group mode: build a client per profile, fan out queries.
	manager := api.NewGroupClientManager(result.InitialGroup, loggerAdapter, cacheAdapter)

	profileNames := cfg.GetProfileNamesInGroup(result.InitialGroup)
	if len(profileNames) == 0 {
		return nil, fmt.Errorf("group %q has no member profiles", result.InitialGroup)
	}

	var profiles []api.ProfileEntry

	for _, name := range profileNames {
		p, exists := cfg.Profiles[name]
		if !exists {
			continue