Function runSetupQuickstart

internal/cli/quickstarts.go:600–683

runSetupQuickstart is the orchestration entry point for `quickstarts setup`.

(cmd *cobra.Command, cli *cli, inputs *SetupInputs)

// runSetupQuickstart is the orchestration entry point for `quickstarts setup`.
func runSetupQuickstart(cmd *cobra.Command, cli *cli, inputs *SetupInputs) error {
	ctx := cmd.Context()

	if err := cli.setupWithAuthentication(ctx); err != nil {
		return fmt.Errorf("authentication required: %w", err)
	}

	// Validate that --linked-app-id is only used with --api.
	if inputs.LinkedAppID != "" && !inputs.API {
		return fmt.Errorf("--linked-app-id requires --api")
	}

	canPromptFlag := canPrompt(cmd)

	// -- Step 1: Decide what to create (App / API) --.
	if err := resolveSetupTargets(inputs, canPromptFlag); err != nil {
		return err
	}

	// -- Step 2: API flow — decide whether to create a new app or link an existing one --.
	if err := resolveAPIAppLink(cmd, cli, inputs, canPromptFlag); err != nil {
		return err
	}

	// -- Step 3: Auto-detect project framework --.
	if err := handleProjectDetection(cmd, cli, inputs, canPromptFlag); err != nil {
		return err
	}

	// -- Step 4: Resolve remaining prompts (type, framework, build tool) --.
	if err := validateNonInteractiveRequirements(*inputs, canPromptFlag); err != nil {
		return err
	}

	qsConfigKey, wasAutoSelected, err := getQuickstartConfigKey(cmd, inputs)
	if err != nil {
		return fmt.Errorf("failed to get quickstart configuration: %w", err)
	}
	if inputs.App && wasAutoSelected {
		cli.renderer.Infof("Auto-selected build tool %q for %s/%s", inputs.BuildTool, inputs.Type, inputs.Framework)
	}

	// -- Step 5: Collect application/API name --.
	if err = collectName(cmd, inputs); err != nil {
		return err
	}

	// -- Step 6: Prompt for port if not explicitly set --.
	if inputs.App && inputs.Type != "native" && inputs.Type != "m2m" {
		portStr := strconv.Itoa(inputs.Port)
		if err := setupPort.AskInt(cmd, &inputs.Port, &portStr); err != nil {
			return fmt.Errorf("failed to enter port: %w", err)
		}
		if inputs.Port < 1024 || inputs.Port > 65535 {
			return fmt.Errorf("invalid port number: %d (must be between 1024 and 65535)", inputs.Port)
		}
	}