refactor: split onboarding message contracts by domain

Author: binarylogic

internal/app/onboarding/msgs/account.go

@@ -0,0 +1,20 @@
+package msgs
+
+import "github.com/usetero/cli/internal/domain"
+
+// AccountSelected is emitted when user selects an account.
+type AccountSelected struct {
+	Org     domain.Organization
+	Account domain.Account
+}
+
+// NoAccounts is emitted when no accounts exist for the org.
+type NoAccounts struct {
+	Org domain.Organization
+}
+
+// AccountCreated is emitted when a new account is created.
+type AccountCreated struct {
+	Org     domain.Organization
+	Account domain.Account
+}

internal/app/onboarding/msgs/auth.go

@@ -0,0 +1,8 @@
+package msgs
+
+import "github.com/usetero/cli/internal/auth"
+
+// Authenticated is emitted when authentication succeeds.
+type Authenticated struct {
+	User auth.User
+}

internal/app/onboarding/msgs/complete.go

@@ -0,0 +1,14 @@
+package msgs
+
+import (
+	"github.com/usetero/cli/internal/auth"
+	"github.com/usetero/cli/internal/domain"
+)
+
+// OnboardingComplete is emitted to the root model when onboarding finishes.
+type OnboardingComplete struct {
+	User      *auth.User
+	Org       domain.Organization
+	Account   domain.Account
+	Workspace domain.Workspace
+}

internal/app/onboarding/msgs/datadog.go

@@ -0,0 +1,27 @@
+package msgs
+
+import "github.com/usetero/cli/internal/domain"
+
+// DatadogReady is emitted when datadog is already configured.
+type DatadogReady struct{}
+
+// DatadogNeeded is emitted when datadog setup is required.
+type DatadogNeeded struct{}
+
+// DatadogRegionSelected is emitted when user selects a datadog region.
+type DatadogRegionSelected struct {
+	Site domain.DatadogSite
+}
+
+// DatadogAPIKeyEntered is emitted when user enters API key.
+type DatadogAPIKeyEntered struct {
+	APIKey string
+}
+
+// DatadogAccountCreated is emitted when datadog account is created.
+type DatadogAccountCreated struct {
+	DatadogAccountID domain.DatadogAccountID
+}
+
+// DatadogDiscoveryComplete is emitted when discovery finishes.
+type DatadogDiscoveryComplete struct{}

internal/app/onboarding/msgs/doc.go

@@ -0,0 +1,2 @@
+// Package msgs defines onboarding message contracts between steps and orchestrator.
+package msgs

internal/app/onboarding/msgs/msgs.go

@@ -0,0 +1,16 @@
+package msgs
+
+import "github.com/usetero/cli/internal/domain"
+
+// OrgSelected is emitted when user selects an organization.
+type OrgSelected struct {
+	Org domain.Organization
+}
+
+// NoOrgs is emitted when no organizations exist.
+type NoOrgs struct{}
+
+// OrgCreated is emitted when a new organization is created.
+type OrgCreated struct {
+	Org domain.Organization
+}

internal/app/onboarding/msgs/organization.go

@@ -0,0 +1,32 @@
+package msgs
+
+import "github.com/usetero/cli/internal/domain"
+
+// PreflightOutcome indicates confidence in preflight-derived routing.
+type PreflightOutcome string
+
+const (
+	PreflightOutcomeResolved     PreflightOutcome = "resolved"
+	PreflightOutcomeInconclusive PreflightOutcome = "inconclusive"
+	PreflightOutcomeFailed       PreflightOutcome = "failed"
+)
+
+// PreflightState captures startup readiness signals used to choose the first gate.
+type PreflightState struct {
+	Outcome            PreflightOutcome
+	HasValidAuth       bool
+	Role               string
+	ActiveOrgID        domain.OrganizationID
+	DefaultAccountID   domain.AccountID
+	DefaultWorkspaceID domain.WorkspaceID
+	Org                *domain.Organization
+	Account            *domain.Account
+	Workspace          *domain.Workspace
+	HasDatadog         bool
+	Error              string
+}
+
+// PreflightResolved is emitted after startup preflight completes.
+type PreflightResolved struct {
+	State PreflightState
+}

internal/app/onboarding/msgs/preflight.go

@@ -0,0 +1,12 @@
+package msgs
+
+// Role constants.
+const (
+	RolePlatform = "platform"
+	RoleEngineer = "engineer"
+)
+
+// RoleSelected is emitted when user selects their role.
+type RoleSelected struct {
+	Role string
+}

internal/app/onboarding/msgs/role.go

@@ -0,0 +1,15 @@
+package msgs
+
+import "github.com/usetero/cli/internal/domain"
+
+// EnsureRuntime requests runtime initialization for the selected account.
+type EnsureRuntime struct {
+	Org     domain.Organization
+	Account domain.Account
+}
+
+// RuntimeReady is emitted when account runtime is initialized.
+type RuntimeReady struct {
+	Org     domain.Organization
+	Account domain.Account
+}