[ADD] support for managed Extras installation via CLI and TUI

Author: Dmi3yy

README.md

@@ -112,6 +112,8 @@ evo install my-project --force  # Force install even if directory exists
 evo install my-project --cli --log  # Non-interactive mode + write log.md
 evo install my-project --composer-update  # Use composer update during setup
 evo install my-project --composer-clear-cache  # Clear Composer cache before install
+evo install my-project --github-pat=TOKEN  # GitHub PAT for API requests
+evo install my-project --extras=sTask@main,sSeo  # Install extras after setup (optional)
 ```
 
 ### Available Options
@@ -136,6 +138,30 @@ evo install my-project --composer-clear-cache  # Clear Composer cache before ins
 - `--quiet`: Reduce CLI output (warnings/errors only)
 - `--composer-clear-cache`: Clear Composer cache before install
 - `--composer-update`: Use `composer update` instead of `composer install` during setup
+- `--github-pat` / `--github_pat`: GitHub PAT token for API requests (avoids GitHub rate limits)
+- `--extras`: Comma-separated extras to install after setup (e.g., `sTask@main,sSeo`)
+
+### CLI Example (Non-interactive)
+
+```bash
+evo install demo \
+  --cli \
+  --branch=3.5.x \
+  --db-type=sqlite \
+  --db-name=database.sqlite \
+  --admin-username=admin \
+  --admin-email=admin@example.com \
+  --admin-password=123456 \
+  --admin-directory=manager \
+  --language=uk \
+  --composer-clear-cache \
+  --github-pat=YOUR_GITHUB_PAT \
+  --extras=sTask@main,sSeo
+```
+
+Notes:
+- `--cli` skips the Extras wizard prompt; use `--extras` to auto-install.
+- `--extras` works in both TUI and CLI; when provided, the wizard is skipped and installation starts immediately.
 
 ## Presets
 
@@ -172,6 +198,14 @@ You can create custom presets by extending the `Preset` class. See the `src/Pres
 - **Install Type Detection**: Automatically detects if this is a fresh install or an update
 - **Secure Configuration**: Creates database config files with proper permissions (read-only)
 
+### Managed Extras Wizard (TUI)
+
+- **Post-install prompt**: After the success screen, the installer asks whether to install additional Extras.
+- **Selection UI**: Shows the full managed Extras list (type 0, install via Composer) with checkboxes, versions, and descriptions.
+- **Batch install**: Installs selected Extras one-by-one via `php artisan extras extras <Name>` and shows progress/status.
+- **Post steps**: Runs `php artisan migrate` once after all Extras, then `php artisan cache:clear-full`.
+- **Flow**: Install -> Success screen -> Prompt -> Extras selection -> Progress -> Summary
+
 ### Inspired by Docker Implementation
 
 This installer incorporates best practices from the [Evolution CMS Docker implementation](https://github.com/evolution-cms/evolution/blob/nightly/docker/entrypoint.sh), including:

cmd/evo/cli.go

@@ -195,6 +195,16 @@ func applyCLIEvent(ev domain.Event, stepLabels map[string]string, actions chan<-
 				printCLILine("✗", ev.StepID, msg, os.Stderr)
 			}
 		}
+	case domain.EventExtras:
+		if p, ok := ev.Payload.(domain.ExtrasState); ok && p.Stage == domain.ExtrasStageSelect {
+			sendAction(actions, domain.Action{
+				Type:       domain.ActionExtrasDecision,
+				QuestionID: "extras_select",
+				OptionID:   "skip",
+			})
+			fmt.Fprintln(os.Stdout, "Extras selection skipped in --cli mode.")
+			return true
+		}
 	}
 	return false
 }
@@ -218,6 +228,14 @@ func handleCLIQuestion(q domain.QuestionState, actions chan<- domain.Action, can
 		*hadError = true
 		fmt.Fprintln(os.Stderr, "Database connection failed; exiting (no retry in --cli mode).")
 		return true
+	case "extras_prompt":
+		sendAction(actions, domain.Action{
+			Type:       domain.ActionAnswerSelect,
+			QuestionID: q.ID,
+			OptionID:   "no",
+		})
+		fmt.Fprintln(os.Stdout, "Extras installation skipped in --cli mode.")
+		return true
 	default:
 		*hadError = true
 		fmt.Fprintln(os.Stderr, cliMissingInputMessage(q))

cmd/evo/main.go

@@ -221,6 +221,9 @@ func runInstall(ctx context.Context, args []string) int {
 	adminPassword := fs.String("admin-password", "", "Admin password")
 	adminDirectory := fs.String("admin-directory", "", "Admin directory (default: manager)")
 	language := fs.String("language", "", "Installation language (e.g., en, uk)")
+	githubPat := fs.String("github-pat", "", "GitHub PAT token for API requests")
+	githubPatAlt := fs.String("github_pat", "", "GitHub PAT token for API requests")
+	extras := fs.String("extras", "", "Comma-separated extras to install (e.g., sTask@main,sSeo)")
 	logToFile := fs.Bool("log", false, "Write installer log to file")
 	cliMode := fs.Bool("cli", false, "Run in non-interactive CLI mode (no TUI)")
 	quiet := fs.Bool("quiet", false, "Reduce CLI output (warnings/errors only)")
@@ -230,6 +233,11 @@ func runInstall(ctx context.Context, args []string) int {
 	if err := fs.Parse(flagArgs); err != nil {
 		return 2
 	}
+	pat := strings.TrimSpace(*githubPat)
+	if pat == "" {
+		pat = strings.TrimSpace(*githubPatAlt)
+	}
+
 	opt := installengine.Options{
 		Force:              *force,
 		Dir:                installDir,
@@ -248,7 +256,14 @@ func runInstall(ctx context.Context, args []string) int {
 		AdminPassword:      *adminPassword,
 		AdminDirectory:     strings.TrimSpace(*adminDirectory),
 		Language:           strings.ToLower(strings.TrimSpace(*language)),
+		GithubPat:          pat,
+	}
+	extrasSelections, err := parseExtrasSelections(*extras)
+	if err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		return 2
 	}
+	opt.Extras = extrasSelections
 	if *cliMode {
 		if err := applyCLIDefaults(&opt); err != nil {
 			fmt.Fprintln(os.Stderr, err)
@@ -258,13 +273,42 @@ func runInstall(ctx context.Context, args []string) int {
 	return runInstaller(ctx, ui.ModeInstall, &opt, *logToFile, *cliMode, *quiet)
 }
 
+func parseExtrasSelections(raw string) ([]domain.ExtrasSelection, error) {
+	raw = strings.TrimSpace(raw)
+	if raw == "" {
+		return nil, nil
+	}
+	parts := strings.Split(raw, ",")
+	out := make([]domain.ExtrasSelection, 0, len(parts))
+	for _, part := range parts {
+		part = strings.TrimSpace(part)
+		if part == "" {
+			continue
+		}
+		name := part
+		version := ""
+		if strings.Contains(part, "@") {
+			chunks := strings.SplitN(part, "@", 2)
+			name = strings.TrimSpace(chunks[0])
+			if len(chunks) > 1 {
+				version = strings.TrimSpace(chunks[1])
+			}
+		}
+		if name == "" {
+			return nil, fmt.Errorf("invalid --extras value: %q", part)
+		}
+		out = append(out, domain.ExtrasSelection{Name: name, Version: version})
+	}
+	return out, nil
+}
+
 func splitInstallArgs(args []string) (installDir string, flagArgs []string, err error) {
 	flagArgs = make([]string, 0, len(args))
 
 	expectsValue := func(flag string) bool {
 		switch flag {
 		case "branch", "db-type", "db-host", "db-port", "db-name", "db-user", "db-password",
-			"admin-username", "admin-email", "admin-password", "admin-directory", "language":
+			"admin-username", "admin-email", "admin-password", "admin-directory", "language", "github-pat", "github_pat", "extras":
 			return true
 		default:
 			return false

internal/domain/action.go

@@ -3,8 +3,9 @@ package domain
 type ActionType string
 
 const (
-	ActionAnswerSelect ActionType = "answer_select"
-	ActionAnswerInput  ActionType = "answer_input"
+	ActionAnswerSelect   ActionType = "answer_select"
+	ActionAnswerInput    ActionType = "answer_input"
+	ActionExtrasDecision ActionType = "extras_decision"
 )
 
 type Action struct {
@@ -13,5 +14,6 @@ type Action struct {
 	QuestionID string
 	OptionID   string
 	Text       string
+	Values     []string
+	Extras     []ExtrasSelection
 }
-

internal/domain/event.go

@@ -14,6 +14,7 @@ const (
 	EventWarning      EventType = "warning"
 	EventError        EventType = "error"
 	EventExecRequest  EventType = "exec_request"
+	EventExtras       EventType = "extras"
 )
 
 type Severity string

internal/domain/extras.go

@@ -0,0 +1,55 @@
+package domain
+
+type ExtrasStage string
+
+const (
+	ExtrasStageSelect   ExtrasStage = "select"
+	ExtrasStageProgress ExtrasStage = "progress"
+	ExtrasStageSummary  ExtrasStage = "summary"
+)
+
+type ExtrasItemStatus string
+
+const (
+	ExtrasStatusPending ExtrasItemStatus = "pending"
+	ExtrasStatusRunning ExtrasItemStatus = "running"
+	ExtrasStatusSuccess ExtrasItemStatus = "success"
+	ExtrasStatusError   ExtrasItemStatus = "error"
+)
+
+type ExtrasPackage struct {
+	Name               string   `json:"name"`
+	Version            string   `json:"version"`
+	Versions           []string `json:"versions,omitempty"`
+	Description        string   `json:"description"`
+	DefaultInstallMode string   `json:"defaultInstallMode"`
+	DefaultBranch      string   `json:"defaultBranch,omitempty"`
+}
+
+type ExtrasSelection struct {
+	Name    string
+	Version string
+}
+
+type ExtrasItemResult struct {
+	Name    string
+	Status  ExtrasItemStatus
+	Message string
+}
+
+type ExtrasItemDetail struct {
+	Name   string
+	Output string
+}
+
+type ExtrasState struct {
+	Active       bool
+	Stage        ExtrasStage
+	Packages     []ExtrasPackage
+	Selections   []ExtrasSelection
+	Results      []ExtrasItemResult
+	Current      string
+	CurrentIndex int
+	Total        int
+	Details      []ExtrasItemDetail
+}

internal/engine/install/engine.go

@@ -45,6 +45,9 @@ type Options struct {
 	AdminPassword  string
 	AdminDirectory string
 	Language       string
+
+	GithubPat string
+	Extras    []domain.ExtrasSelection
 }
 
 type Engine struct {
@@ -85,6 +88,7 @@ func (e *Engine) Run(ctx context.Context, ch chan<- domain.Event, actions <-chan
 					{ID: "presets", Label: "Step 5: Install presets", Status: domain.StepPending},
 					{ID: "dependencies", Label: "Step 6: Install dependencies", Status: domain.StepPending},
 					{ID: "finalize", Label: "Step 7: Finalize installation", Status: domain.StepPending},
+					{ID: "extras", Label: "Step 8: Install Extras (optional)", Status: domain.StepPending},
 				},
 			},
 		})
@@ -316,7 +320,7 @@ func (e *Engine) Run(ctx context.Context, ch chan<- domain.Event, actions <-chan
 			Payload: domain.StepStartPayload{
 				Label: "Step 1: Validate PHP version",
 				Index: 1,
-				Total: 7,
+				Total: 8,
 			},
 		})
 
@@ -388,7 +392,7 @@ func (e *Engine) Run(ctx context.Context, ch chan<- domain.Event, actions <-chan
 			Payload: domain.StepStartPayload{
 				Label: "Step 2: Check database connection",
 				Index: 2,
-				Total: 7,
+				Total: 8,
 			},
 		})
 
@@ -950,7 +954,7 @@ func (e *Engine) Run(ctx context.Context, ch chan<- domain.Event, actions <-chan
 			Payload: domain.StepStartPayload{
 				Label: "Step 3: Download Evolution CMS",
 				Index: 3,
-				Total: 7,
+				Total: 8,
 			},
 		})
 
@@ -971,6 +975,8 @@ func (e *Engine) Run(ctx context.Context, ch chan<- domain.Event, actions <-chan
 			WorkDir:            workDir,
 			ComposerClearCache: e.opt.ComposerClearCache,
 			ComposerUpdate:     e.opt.ComposerUpdate,
+			GithubPat:          strings.TrimSpace(e.opt.GithubPat),
+			Extras:             e.opt.Extras,
 		}); err != nil {
 			_ = emit(domain.Event{
 				Type:     domain.EventError,
@@ -984,6 +990,8 @@ func (e *Engine) Run(ctx context.Context, ch chan<- domain.Event, actions <-chan
 			})
 			return
 		}
+
+		e.maybeRunExtras(ctx, emit, actions, workDir)
 	}()
 }
 
@@ -1001,6 +1009,9 @@ type phpNewOptions struct {
 	AdminDirectory string
 	Language       string
 
+	GithubPat string
+	Extras    []domain.ExtrasSelection
+
 	Force   bool
 	Branch  string
 	WorkDir string
@@ -1100,6 +1111,9 @@ func runPHPNewCommand(ctx context.Context, emit func(domain.Event) bool, opt php
 	if strings.TrimSpace(opt.Branch) != "" {
 		args = append(args, "--branch="+strings.TrimSpace(opt.Branch))
 	}
+	if strings.TrimSpace(opt.GithubPat) != "" {
+		args = append(args, "--github-pat="+strings.TrimSpace(opt.GithubPat))
+	}
 	if opt.Force {
 		args = append(args, "--force")
 	}
@@ -1342,7 +1356,7 @@ func (t *stepTracker) start(stepID, label string, index int) {
 		Payload: domain.StepStartPayload{
 			Label: label,
 			Index: index,
-			Total: 7,
+			Total: 8,
 		},
 	})
 }