@owdproject/cli 0.0.3 → 0.2.0

package/go/go.sum

@@ -0,0 +1,52 @@
+github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=
+github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbles v1.0.0 h1:12J8/ak/uCZEMQ6KU7pcfwceyjLlWsDLAxB5fXonfvc=
+github.com/charmbracelet/bubbles v1.0.0/go.mod h1:9d/Zd5GdnauMI5ivUIVisuEm3ave1XwXtD1ckyV6r3E=
+github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
+github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
+github.com/charmbracelet/colorprofile v0.4.1 h1:a1lO03qTrSIRaK8c3JRxJDZOvhvIeSco3ej+ngLk1kk=
+github.com/charmbracelet/colorprofile v0.4.1/go.mod h1:U1d9Dljmdf9DLegaJ0nGZNJvoXAhayhmidOdcBwAvKk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.11.6 h1:GhV21SiDz/45W9AnV2R61xZMRri5NlLnl6CVF7ihZW8=
+github.com/charmbracelet/x/ansi v0.11.6/go.mod h1:2JNYLgQUsyqaiLovhU2Rv/pb8r6ydXKS3NIttu3VGZQ=
+github.com/charmbracelet/x/cellbuf v0.0.15 h1:ur3pZy0o6z/R7EylET877CBxaiE1Sp1GMxoFPAIztPI=
+github.com/charmbracelet/x/cellbuf v0.0.15/go.mod h1:J1YVbR7MUuEGIFPCaaZ96KDl5NoS0DAWkskup+mOY+Q=
+github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
+github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
+github.com/clipperhouse/displaywidth v0.9.0 h1:Qb4KOhYwRiN3viMv1v/3cTBlz3AcAZX3+y9OLhMtAtA=
+github.com/clipperhouse/displaywidth v0.9.0/go.mod h1:aCAAqTlh4GIVkhQnJpbL0T/WfcrJXHcj8C0yjYcjOZA=
+github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
+github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
+github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w94cO8U=
+github.com/clipperhouse/uax29/v2 v2.5.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
+github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
+github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
+github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
+golang.org/x/exp v0.0.0-20231006140011-7918f672742d/go.mod h1:ldy0pHrwJyGW56pPQzzkH36rKxoZW1tw7ZJpeKx+hdo=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
+golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=

package/go/main.go

@@ -0,0 +1,34 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"owd-cli/bridge"
+	"owd-cli/tui"
+
+	tea "github.com/charmbracelet/bubbletea"
+)
+
+var p *tea.Program
+
+func main() {
+	root, err := bridge.FindWorkspaceRoot()
+	if err != nil {
+		fmt.Printf("Error: %v\n", err)
+		os.Exit(1)
+	}
+
+	model := tui.NewModel(root)
+	p = tea.NewProgram(&model, tea.WithAltScreen(), tea.WithMouseCellMotion())
+
+	finalModel, err := p.Run()
+	if err != nil {
+		fmt.Printf("Alas, there's been an error: %v", err)
+		os.Exit(1)
+	}
+
+	if m, ok := finalModel.(*tui.TuiModel); ok && m.ExitCode != 0 {
+		os.Exit(m.ExitCode)
+	}
+}

package/go/tui/engine.go

@@ -0,0 +1,472 @@
+package tui
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"owd-cli/bridge"
+
+	tea "github.com/charmbracelet/bubbletea"
+)
+
+type WizardMode int
+
+const (
+	WizardSave WizardMode = iota
+	WizardSaveAndServe
+	WizardStartupCheck
+)
+
+type EnginePhase string
+
+const (
+	PhaseIdle        EnginePhase = "idle"
+	PhaseWriteConfig EnginePhase = "write_config"
+	PhaseResolve     EnginePhase = "resolve"
+	PhasePrompt      EnginePhase = "prompt"
+	PhaseProcess     EnginePhase = "process"
+	PhaseInstall     EnginePhase = "install"
+	PhasePrepare     EnginePhase = "prepare"
+	PhaseDone        EnginePhase = "done"
+	PhaseFailed      EnginePhase = "failed"
+)
+
+// buildConfigFromPending applies catalog toggles to a copy of the current config.
+func buildConfigFromPending(
+	ctx *bridge.WorkspaceContext,
+	catalog *bridge.CatalogResponse,
+	pending map[string]bool,
+	pendingTheme *string,
+) (*bridge.Config, []string) {
+	if ctx == nil {
+		return nil, nil
+	}
+
+	config := bridge.Config{
+		Apps:    append([]string{}, ctx.Config.Apps...),
+		Modules: append([]string{}, ctx.Config.Modules...),
+	}
+	if ctx.Config.Theme != nil {
+		t := *ctx.Config.Theme
+		config.Theme = &t
+	}
+
+	var depsToRemove []string
+
+	for name, install := range pending {
+		entry := catalogEntryForName(catalog, name)
+		if install {
+			switch entry.Kind {
+			case "app":
+				if !containsStr(config.Apps, name) {
+					config.Apps = append(config.Apps, name)
+				}
+			case "module":
+				if !containsStr(config.Modules, name) {
+					config.Modules = append(config.Modules, name)
+				}
+			case "theme":
+				config.Theme = &name
+			}
+		} else {
+			depsToRemove = append(depsToRemove, name)
+			switch entry.Kind {
+			case "app":
+				config.Apps = removeStr(config.Apps, name)
+			case "module":
+				config.Modules = removeStr(config.Modules, name)
+			case "theme":
+				if config.Theme != nil && *config.Theme == name {
+					empty := ""
+					config.Theme = &empty
+				}
+			}
+		}
+	}
+
+	if pendingTheme != nil {
+		config.Theme = pendingTheme
+	}
+
+	return &config, depsToRemove
+}
+
+func containsStr(list []string, v string) bool {
+	for _, s := range list {
+		if s == v {
+			return true
+		}
+	}
+	return false
+}
+
+func removeStr(list []string, v string) []string {
+	var out []string
+	for _, s := range list {
+		if s != v {
+			out = append(out, s)
+		}
+	}
+	return out
+}
+
+func (m *TuiModel) startWizard(mode WizardMode) tea.Cmd {
+	if mode == WizardStartupCheck {
+		q := BuildStartupCheckQueue(m.workspaceRoot, m.ctx, m.catalog, func(string) {})
+		hasWork := false
+		for _, item := range q.Items {
+			if item.Status == StatusPending {
+				hasWork = true
+				break
+			}
+		}
+		if !hasWork {
+			m.addLog("ℹ Startup check: all packages are available")
+			return nil
+		}
+	}
+
+	m.activeTask = TaskSetup
+	m.enginePhase = PhaseWriteConfig
+	m.workQueue = NewWorkQueue()
+	m.statusMsg = "Starting wizard…"
+	m.addLog("ℹ Starting wizard workflow…")
+
+	if mode == WizardSaveAndServe {
+		m.startServerAfterSetup = true
+	}
+
+	var config *bridge.Config
+	var depsToRemove []string
+
+	if mode == WizardStartupCheck {
+		m.addLog("ℹ Running startup check wizard…")
+	} else {
+		config, depsToRemove = buildConfigFromPending(m.ctx, m.catalog, m.pendingPackages, m.pendingTheme)
+		m.pendingPackages = make(map[string]bool)
+		m.pendingTheme = nil
+	}
+
+	catalogCopy := m.catalog
+	workspaceRoot := m.workspaceRoot
+	runtime := m.runtime
+	lastMethod := m.lastInstallMethod
+
+	return tea.Batch(func() tea.Msg {
+		m.RunWizardEngine(mode, config, depsToRemove, catalogCopy, workspaceRoot, runtime, lastMethod)
+		return nil
+	}, m.listenToChannel())
+}
+
+func (m *TuiModel) RunWizardEngine(
+	mode WizardMode,
+	config *bridge.Config,
+	depsToRemove []string,
+	catalog *bridge.CatalogResponse,
+	workspaceRoot string,
+	runtime *RuntimeState,
+	lastInstallMethod string,
+) {
+	go func() {
+		msgChan := runtime.msgChan
+		log := func(line string) { msgChan <- logLineMsg(line) }
+		emitQueue := func(q *WorkQueue) {
+			msgChan <- engineQueueUpdatedMsg{Queue: q.Clone()}
+		}
+		emitPhase := func(p EnginePhase) { msgChan <- enginePhaseMsg{Phase: p} }
+
+		var ctx *bridge.WorkspaceContext
+		var err error
+
+		if mode != WizardStartupCheck {
+			emitPhase(PhaseWriteConfig)
+			log("ℹ Updating desktop.config.ts")
+			if err = bridge.WriteConfigOnly(workspaceRoot, config); err != nil {
+				log("✖ Failed to update desktop.config.ts")
+				emitPhase(PhaseFailed)
+				msgChan <- taskFinishedMsg{Success: false, Err: err}
+				return
+			}
+			log("✔ desktop.config.ts updated")
+
+			if len(depsToRemove) > 0 {
+				log(fmt.Sprintf("ℹ Removing %d package(s) from package.json", len(depsToRemove)))
+				if err = bridge.WritePackageJsonDeps(workspaceRoot, nil, depsToRemove); err != nil {
+					log("✖ Failed to update package.json removals")
+					emitPhase(PhaseFailed)
+					msgChan <- taskFinishedMsg{Success: false, Err: err}
+					return
+				}
+				log("✔ package.json updated")
+			}
+		}
+
+		emitPhase(PhaseResolve)
+		ctx, err = bridge.ReadWorkspaceContext(workspaceRoot)
+		if err != nil {
+			log("✖ Failed to read workspace context")
+			emitPhase(PhaseFailed)
+			msgChan <- taskFinishedMsg{Success: false, Err: err}
+			return
+		}
+
+		var q *WorkQueue
+		if mode == WizardStartupCheck {
+			q = BuildStartupCheckQueue(workspaceRoot, ctx, catalog, log)
+		} else {
+			q = BuildQueueFromConfig(workspaceRoot, ctx, catalog, log)
+		}
+		emitQueue(q)
+
+		settings := ctx.Settings
+
+		for {
+			if promptItem := q.NextPendingPrompt(); promptItem != nil {
+				emitPhase(PhasePrompt)
+				msgChan <- engineNeedsPromptMsg{Item: *promptItem}
+				method := <-runtime.engineResume
+
+				if method == "abort" {
+					log("✖ Wizard aborted by user")
+					emitPhase(PhaseFailed)
+					msgChan <- taskFinishedMsg{Success: false, Err: fmt.Errorf("wizard aborted")}
+					return
+				}
+
+				log("ℹ Download method selected: " + resolveMethodLabel(method))
+				if err := applyResolution(q, promptItem, method, workspaceRoot, catalog, &settings, log); err != nil {
+					emitPhase(PhaseFailed)
+					msgChan <- taskFinishedMsg{Success: false, Err: err}
+					return
+				}
+				emitQueue(q)
+				continue
+			}
+
+			item := q.NextPending()
+			if item == nil {
+				break
+			}
+
+			if item.Kind == KindNpm || item.Kind == KindLocal {
+				prev := item.Status
+				q.MarkSkipped(item.Name)
+				log(item.LogTransition(prev, StatusSkipped))
+				emitQueue(q)
+				continue
+			}
+
+			emitPhase(PhaseProcess)
+			if err := processCloneItem(q, item, workspaceRoot, catalog, runtime, log); err != nil {
+				emitPhase(PhaseFailed)
+				msgChan <- taskFinishedMsg{Success: false, Err: err}
+				return
+			}
+			emitQueue(q)
+
+			updated := q.FindByName(item.Name)
+			if updated != nil {
+				DiscoverNestedDeps(workspaceRoot, *updated, catalog, q, log)
+				emitQueue(q)
+			}
+		}
+		var catalogEntries []bridge.CatalogEntry
+		if catalog != nil {
+			catalogEntries = catalog.Entries
+		}
+		if err := ResolveAndCloneMissingDependencies(workspaceRoot, catalogEntries, runtime, log, nil, nil, nil); err != nil {
+			emitPhase(PhaseFailed)
+			msgChan <- taskFinishedMsg{Success: false, Err: err}
+			return
+		}
+
+		emitPhase(PhaseInstall)
+		log("ℹ Running pnpm install")
+		result := runtime.runProcessStream(workspaceRoot, "pnpm", []string{"install"})
+		if result.Err != nil {
+			log("✖ pnpm install failed")
+			emitPhase(PhaseFailed)
+			msgChan <- taskFinishedMsg{Success: false, Err: result.Err}
+			return
+		}
+		log("✔ pnpm install completed")
+
+		emitPhase(PhasePrepare)
+		log("ℹ Running pnpm run prepare:modules")
+		result = runtime.runProcessStream(workspaceRoot, "pnpm", []string{"run", "prepare:modules"})
+		if result.Err != nil {
+			log("✖ prepare:modules failed")
+			emitPhase(PhaseFailed)
+			msgChan <- taskFinishedMsg{Success: false, Err: result.Err}
+			return
+		}
+		log("✔ prepare:modules completed")
+
+		if settings.LastInstallChoices != nil {
+			_ = bridge.WriteChanges(workspaceRoot, &bridge.WritePayload{Settings: &settings})
+		}
+
+		emitPhase(PhaseDone)
+		log("✔ Wizard completed successfully")
+		msgChan <- taskFinishedMsg{Success: true}
+	}()
+}
+
+func resolveMethodLabel(method string) string {
+	switch method {
+	case "git-ssh":
+		return "Git SSH"
+	case "git-https":
+		return "Git HTTPS"
+	case "npm":
+		return "NPM Package"
+	default:
+		return method
+	}
+}
+
+func applyResolution(
+	q *WorkQueue,
+	item *WorkItem,
+	method string,
+	workspaceRoot string,
+	catalog *bridge.CatalogResponse,
+	settings *bridge.Settings,
+	log func(string),
+) error {
+	name := item.Name
+	short := item.ShortName
+
+	switch method {
+	case "local":
+		if err := bridge.WritePackageJsonDeps(workspaceRoot, map[string]string{name: "workspace:*"}, nil); err != nil {
+			log("✖ Failed to link local package " + short)
+			return err
+		}
+		q.SetSource(name, "local", KindLocal)
+		q.MarkSkipped(name)
+		log("✔ " + short + " linked as local package")
+		return nil
+
+	case "git-ssh", "git-https":
+		owner := resolveOwner(name, catalogEntriesSlice(catalog))
+		var gitURL string
+		if method == "git-ssh" {
+			gitURL = fmt.Sprintf("git@github.com:%s/%s.git", owner, short)
+		} else {
+			gitURL = fmt.Sprintf("https://github.com/%s/%s.git", owner, short)
+		}
+		if err := bridge.WritePackageJsonDeps(workspaceRoot, map[string]string{name: "workspace:*"}, nil); err != nil {
+			log("✖ Failed to update package.json for " + short)
+			return err
+		}
+		if settings.LastInstallChoices == nil {
+			settings.LastInstallChoices = make(map[string]interface{})
+		}
+		settings.LastInstallChoices[name] = map[string]string{"type": "git", "gitUrl": gitURL}
+		q.SetSource(name, method, KindClone)
+		if item.TargetDir == "" {
+			item.TargetDir = filepath.Join(workspaceRoot, kindDirForKind(item.Type), short)
+		}
+		log("✔ " + short + " queued for clone (" + resolveMethodLabel(method) + ")")
+		return nil
+
+	case "npm":
+		version := "latest"
+		if item.Entry.Version != nil {
+			version = *item.Entry.Version
+		}
+		if err := bridge.WritePackageJsonDeps(workspaceRoot, map[string]string{name: version}, nil); err != nil {
+			log("✖ Failed to add " + short + " to package.json")
+			return err
+		}
+		q.SetSource(name, "npm:"+version, KindNpm)
+		q.MarkSkipped(name)
+		log("✔ " + short + " added to package.json")
+		log("ℹ " + short + " will be installed through pnpm install")
+		return nil
+
+	default:
+		return fmt.Errorf("unknown resolution method: %s", method)
+	}
+}
+
+func catalogEntriesSlice(catalog *bridge.CatalogResponse) []bridge.CatalogEntry {
+	if catalog == nil {
+		return nil
+	}
+	return catalog.Entries
+}
+
+func processCloneItem(
+	q *WorkQueue,
+	item *WorkItem,
+	workspaceRoot string,
+	catalog *bridge.CatalogResponse,
+	runtime *RuntimeState,
+	log func(string),
+) error {
+	prev := item.Status
+	q.MarkRunning(item.Name)
+	log(item.LogTransition(prev, StatusRunning))
+
+	short := item.ShortName
+	targetDir := item.TargetDir
+	if targetDir == "" {
+		targetDir = filepath.Join(workspaceRoot, kindDirForKind(item.Type), short)
+	}
+
+	if _, err := os.Stat(filepath.Join(targetDir, "package.json")); err == nil {
+		log("ℹ " + short + " already cloned — skipping")
+		q.MarkCompleted(item.Name)
+		log("✔ Directory verified: " + relWorkspacePath(workspaceRoot, targetDir))
+		return nil
+	}
+
+	method := item.Source
+	if method == SourcePending {
+		method = "git-https"
+	}
+
+	owner := resolveOwner(item.Name, catalogEntriesSlice(catalog))
+	var gitURL string
+	if method == "git-ssh" {
+		gitURL = fmt.Sprintf("git@github.com:%s/%s.git", owner, short)
+	} else {
+		gitURL = fmt.Sprintf("https://github.com/%s/%s.git", owner, short)
+	}
+
+	log("ℹ Cloning " + short + "…")
+	result := runtime.runProcessStream(workspaceRoot, "git", []string{"clone", gitURL, targetDir})
+	if result.Err != nil {
+		q.MarkFailed(item.Name, result.Err.Error())
+		log("✖ Clone failed for " + short)
+		return result.Err
+	}
+	log("✔ Clone completed")
+
+	if _, err := os.Stat(filepath.Join(targetDir, "package.json")); err != nil {
+		errMsg := "directory not found after clone"
+		q.MarkFailed(item.Name, errMsg)
+		log("✖ Clone reported success but directory not found")
+		return fmt.Errorf("%s: %s", short, errMsg)
+	}
+
+	q.MarkCompleted(item.Name)
+	log("✔ Directory verified: " + relWorkspacePath(workspaceRoot, targetDir))
+	return nil
+}
+
+func relWorkspacePath(workspaceRoot, absPath string) string {
+	if rel, err := filepath.Rel(workspaceRoot, absPath); err == nil {
+		return rel
+	}
+	return absPath
+}
+
+func (m *TuiModel) resolveEnginePrompt(method string) {
+	if m.runtime.engineResume != nil {
+		m.runtime.engineResume <- method
+	}
+}

package/go/tui/engine_test.go

@@ -0,0 +1,40 @@
+package tui
+
+import (
+	"testing"
+
+	"owd-cli/bridge"
+)
+
+func TestResolveMethodLabel(t *testing.T) {
+	if resolveMethodLabel("git-ssh") != "Git SSH" {
+		t.Fatal("unexpected label for git-ssh")
+	}
+	if resolveMethodLabel("npm") != "NPM Package" {
+		t.Fatal("unexpected label for npm")
+	}
+}
+
+func TestBuildConfigFromPendingRemovals(t *testing.T) {
+	ctx := &bridge.WorkspaceContext{
+		Config: bridge.Config{
+			Apps:    []string{"@owdproject/app-about", "@owdproject/app-todo"},
+			Modules: []string{},
+		},
+	}
+	catalog := &bridge.CatalogResponse{
+		Entries: []bridge.CatalogEntry{
+			{Name: "@owdproject/app-todo", ShortName: "app-todo", Kind: "app"},
+		},
+	}
+	pending := map[string]bool{
+		"@owdproject/app-todo": false,
+	}
+	config, removes := buildConfigFromPending(ctx, catalog, pending, nil)
+	if len(removes) != 1 || removes[0] != "@owdproject/app-todo" {
+		t.Fatalf("expected removal, got %v", removes)
+	}
+	if containsStr(config.Apps, "@owdproject/app-todo") {
+		t.Fatalf("app-todo should be removed from config, got %v", config.Apps)
+	}
+}