feat: Interactive + auto-install setup workflows for goenv + MASSIVE consolidation.

- Added InteractiveSetup and AutoInstallSetup structs to handle user interactions and automatic installations.
- Implemented version discovery from .go-version and go.mod files.
- Added prompts for installation and VS Code settings updates.
- Introduced WorkflowResult and AutoInstallResult types to encapsulate outcomes of the workflows.
- Enhanced error handling and user feedback throughout the setup processes.

refactor: Improve command execution in build-tool script

- Replaced direct exec.Command calls with utility functions for better error handling and context management.
- Updated platform checks to use the new platform package for OS detection.
- Streamlined directory creation and permission setting with utility functions.

fix: Optimize embedded version generation script

- Refactored fetchReleases function to use a utility for fetching JSON with timeout.
- Improved file size reporting after generating embedded versions.

chore: Enhance swap script with platform-specific checks

- Updated OS checks to utilize the platform package for better readability.
- Refactored file existence checks and command executions to use utility functions.

test: Add test utilities for easier test file handling

- Introduced WriteTestFile and StripDeprecationWarning functions to simplify test setup and output processing.

Author: AdamDrewsTR

.gitattributes

@@ -5,3 +5,40 @@ libexec/* linguist-language=Shell
 src/shobj-conf/* linguist-language=Shell
 test/libexec/* linguist-language=Shell
 
+# Line ending normalization for cross-platform compatibility
+# Ensure consistent line endings across Windows, macOS, and Linux
+
+# Shell scripts always use LF (required for Unix shells)
+*.sh text eol=lf
+*.bash text eol=lf
+*.zsh text eol=lf
+*.fish text eol=lf
+
+# Windows batch and PowerShell files use CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Go source files use LF
+*.go text eol=lf
+*.mod text eol=lf
+*.sum text eol=lf
+
+# Documentation and config files use LF
+*.md text eol=lf
+*.txt text eol=lf
+*.json text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+*.toml text eol=lf
+Makefile text eol=lf
+
+# Binary files
+*.exe binary
+*.dll binary
+*.so binary
+*.dylib binary
+*.a binary
+*.tar.gz binary
+*.zip binary
+

README.md

@@ -45,6 +45,7 @@ This project was originally cloned from [pyenv](https://github.com/pyenv/pyenv),
   - Sync tools between versions with `goenv tools sync`
 - **Version aliases** (`goenv alias`) - create convenient shorthand names for versions
 - **VS Code integration** (`goenv vscode`) - sync Go settings with workspace-relative paths and security validation
+- **Shell prompt integration** (`goenv prompt`) - display active Go version in your shell prompt with smart caching
 
 ### goenv compared to others:
 
@@ -171,6 +172,154 @@ See [Installation Guide](docs/user-guide/INSTALL.md) for platform-specific setup
 
 ---
 
+## 🎨 Shell Prompt Integration
+
+Display your active Go version directly in your shell prompt for instant visual feedback:
+
+```bash
+# Quick setup with the interactive wizard
+goenv prompt config
+
+# Manual setup - add to your shell config:
+# Bash/Zsh (~/.bashrc or ~/.zshrc)
+export PS1='$(goenv prompt --prefix "(" --suffix ") ") '"$PS1"
+
+# Fish (~/.config/fish/config.fish)
+function fish_prompt
+  set -l goenv_version (goenv prompt 2>/dev/null)
+  test -n "$goenv_version"; and echo -n "($goenv_version) "
+  # ... rest of your prompt
+end
+
+# PowerShell ($PROFILE)
+function prompt {
+  $goenvVersion = goenv prompt 2>$null
+  if ($goenvVersion) {
+    Write-Host "($goenvVersion) " -NoNewline -ForegroundColor Cyan
+  }
+  "PS $($PWD.Path)> "
+}
+```
+
+**Features:**
+- **Smart caching** - minimal performance impact (< 50ms)
+- **Customizable format** - control prefix, suffix, and display format
+- **Project-aware** - show only in Go projects with `--go-project-only`
+- **Hide system Go** - use `--no-system` to hide when using system Go
+
+**Advanced options:**
+```bash
+# Short version (1.23 instead of 1.23.2)
+export PS1='$(goenv prompt --short) '"$PS1"
+
+# Custom format with emoji
+export PS1='$(goenv prompt --icon "🐹" --format "go:%s") '"$PS1"
+
+# Show only in Go projects
+export PS1='$(goenv prompt --go-project-only) '"$PS1"
+
+# Environment variable configuration
+export GOENV_PROMPT_PREFIX="["
+export GOENV_PROMPT_SUFFIX="]"
+export GOENV_PROMPT_FORMAT="go:%s"
+```
+
+See `goenv prompt --help` for all options.
+
+---
+
+## 🎯 Interactive Mode
+
+goenv adapts to your workflow with three levels of interactivity:
+
+### Non-Interactive Mode (CI/Automation)
+Perfect for scripts and CI/CD pipelines - auto-confirms all operations:
+
+```bash
+# Auto-confirm with --yes flag
+goenv install 1.23.0 --yes
+goenv uninstall 1.22.0 -y
+
+# Or set globally
+export GOENV_ASSUME_YES=1
+goenv install 1.23.0
+
+# Quiet mode (suppress output)
+goenv install 1.23.0 --quiet
+
+# Auto-detected in CI environments (GitHub Actions, GitLab CI, etc.)
+```
+
+### Minimal Interactive Mode (Default)
+Balances automation with safety - prompts only for critical operations:
+
+```bash
+# Default behavior
+goenv uninstall 1.22.0
+# Prompt: "Really uninstall Go 1.22.0? [y/N]"
+
+goenv install 1.23.0
+# Shows progress, offers retry on failure
+```
+
+### Guided Interactive Mode (Learning)
+Helpful prompts and suggestions for new users:
+
+```bash
+# Enable guided mode
+goenv install --interactive
+# Offers version selection, explains choices
+
+goenv doctor --interactive  
+# Offers to fix issues automatically
+
+goenv use --interactive
+# Guides through version selection
+```
+
+### Global Flags
+
+- `--interactive` - Enable guided mode with helpful prompts
+- `--yes` / `-y` - Auto-confirm all prompts (non-interactive)
+- `--quiet` / `-q` - Suppress progress output (only show errors)
+
+### Environment Variables
+
+- `GOENV_ASSUME_YES=1` - Auto-confirm globally (like --yes)
+- `CI=true` - Automatically enables non-interactive mode
+
+### Examples by Use Case
+
+**Daily development**:
+```bash
+goenv install 1.23.0    # Default: shows progress, confirms if needed
+goenv use 1.23.0        # Installs if needed (with prompt)
+```
+
+**Automation scripts**:
+```bash
+#!/bin/bash
+goenv install 1.23.0 --yes
+goenv global 1.23.0 --yes
+```
+
+**CI/CD pipelines**:
+```yaml
+# goenv auto-detects CI - no flags needed
+- run: goenv install 1.23.0
+- run: goenv global 1.23.0
+```
+
+**Learning mode**:
+```bash
+goenv install --interactive  # Guided experience
+goenv explain               # Understand version resolution
+```
+
+📖 **Full Guide**: See [Interactive Mode Guide](docs/INTERACTIVE_MODE_GUIDE.md) for comprehensive documentation.
+
+---
+
 ## 🪝 Hooks System
 
 goenv includes a powerful hooks system that lets you automate actions at key points in the goenv lifecycle. Hooks are **declarative**, **safe**, and **cross-platform**.
@@ -236,6 +385,7 @@ goenv hooks test       # Dry-run hooks without executing
 
 #### Getting Started
 - **[Installation Guide](./docs/user-guide/INSTALL.md)** - Get started with goenv ⭐ **NEW: Windows FAQ**
+- **[Interactive Mode Guide](./docs/INTERACTIVE_MODE_GUIDE.md)** - CI/CD, automation, and guided workflows ⭐ **NEW**
 - **[Quick Reference](./docs/QUICK_REFERENCE.md)** - One-page cheat sheet ⭐ **NEW**
 - **[FAQ](./docs/FAQ.md)** - Frequently asked questions ⭐ **NEW**
 - **[What's New in Docs](./docs/WHATS_NEW_DOCUMENTATION.md)** - Recent documentation improvements ⭐ **NEW**

cmd/aliases/alias.go

@@ -2,11 +2,11 @@ package aliases
 
 import (
 	"fmt"
-	"sort"
+	"slices"
 
 	cmdpkg "github.com/go-nv/goenv/cmd"
 
-	"github.com/go-nv/goenv/internal/config"
+	"github.com/go-nv/goenv/internal/cmdutil"
 	"github.com/go-nv/goenv/internal/helptext"
 	"github.com/go-nv/goenv/internal/manager"
 	"github.com/spf13/cobra"
@@ -35,8 +35,7 @@ func init() {
 }
 
 func runAlias(cmd *cobra.Command, args []string) error {
-	cfg := config.Load()
-	mgr := manager.NewManager(cfg)
+	_, mgr := cmdutil.SetupContext()
 
 	switch len(args) {
 	case 0:
@@ -69,7 +68,7 @@ func listAliases(cmd *cobra.Command, mgr *manager.Manager) error {
 	for name := range aliases {
 		names = append(names, name)
 	}
-	sort.Strings(names)
+	slices.Sort(names)
 
 	// Print aliases
 	for _, name := range names {

cmd/aliases/alias_test.go

@@ -8,6 +8,8 @@ import (
 
 	"github.com/go-nv/goenv/cmd/legacy"
 	"github.com/go-nv/goenv/internal/cmdtest"
+	"github.com/go-nv/goenv/internal/utils"
+	"github.com/go-nv/goenv/testing/testutil"
 	"github.com/spf13/cobra"
 )
 
@@ -94,27 +96,25 @@ func TestAliasCommand(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
-			testRoot, cleanup := cmdtest.SetupTestEnv(t)
-			defer cleanup()
+			tmpDir := t.TempDir()
+			t.Setenv(utils.GoenvEnvVarRoot.String(), tmpDir)
+			t.Setenv(utils.GoenvEnvVarDir.String(), tmpDir)
 
 			// Setup test versions
 			for _, version := range tt.setupVersions {
-				cmdtest.CreateTestVersion(t, testRoot, version)
+				cmdtest.CreateMockGoVersion(t, tmpDir, version)
 			}
 
 			// Setup test aliases
 			if len(tt.setupAliases) > 0 {
-				aliasesFile := filepath.Join(testRoot, "aliases")
+				aliasesFile := filepath.Join(tmpDir, "aliases")
 				var content strings.Builder
 				content.WriteString("# goenv aliases\n")
 				content.WriteString("# Format: alias_name=target_version\n")
 				for name, version := range tt.setupAliases {
 					content.WriteString(name + "=" + version + "\n")
 				}
-				err := os.WriteFile(aliasesFile, []byte(content.String()), 0644)
-				if err != nil {
-					t.Fatalf("Failed to setup aliases: %v", err)
-				}
+				testutil.WriteTestFile(t, aliasesFile, []byte(content.String()), utils.PermFileDefault, "Failed to setup aliases")
 			}
 
 			// Create and execute command
@@ -158,7 +158,7 @@ func TestAliasCommand(t *testing.T) {
 
 			// For set operations, verify the file was written correctly
 			if len(tt.args) == 2 && tt.expectedError == "" {
-				aliasesFile := filepath.Join(testRoot, "aliases")
+				aliasesFile := filepath.Join(tmpDir, "aliases")
 				content, err := os.ReadFile(aliasesFile)
 				if err != nil {
 					t.Errorf("Failed to read aliases file: %v", err)
@@ -211,27 +211,25 @@ func TestUnaliasCommand(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
-			testRoot, cleanup := cmdtest.SetupTestEnv(t)
-			defer cleanup()
+			tmpDir := t.TempDir()
+			t.Setenv(utils.GoenvEnvVarRoot.String(), tmpDir)
+			t.Setenv(utils.GoenvEnvVarDir.String(), tmpDir)
 
 			// Setup test versions
 			for _, version := range tt.setupVersions {
-				cmdtest.CreateTestVersion(t, testRoot, version)
+				cmdtest.CreateMockGoVersion(t, tmpDir, version)
 			}
 
 			// Setup test aliases
 			if len(tt.setupAliases) > 0 {
-				aliasesFile := filepath.Join(testRoot, "aliases")
+				aliasesFile := filepath.Join(tmpDir, "aliases")
 				var content strings.Builder
 				content.WriteString("# goenv aliases\n")
 				content.WriteString("# Format: alias_name=target_version\n")
 				for name, version := range tt.setupAliases {
 					content.WriteString(name + "=" + version + "\n")
 				}
-				err := os.WriteFile(aliasesFile, []byte(content.String()), 0644)
-				if err != nil {
-					t.Fatalf("Failed to setup aliases: %v", err)
-				}
+				testutil.WriteTestFile(t, aliasesFile, []byte(content.String()), utils.PermFileDefault, "Failed to setup aliases")
 			}
 
 			// Create and execute command
@@ -268,7 +266,7 @@ func TestUnaliasCommand(t *testing.T) {
 
 			// Verify the alias was removed from the file
 			if len(tt.args) == 1 && tt.expectedError == "" {
-				aliasesFile := filepath.Join(testRoot, "aliases")
+				aliasesFile := filepath.Join(tmpDir, "aliases")
 				content, err := os.ReadFile(aliasesFile)
 				if err != nil {
 					t.Errorf("Failed to read aliases file: %v", err)
@@ -322,20 +320,18 @@ func TestAliasResolution(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
-			testRoot, cleanup := cmdtest.SetupTestEnv(t)
-			defer cleanup()
+			tmpDir := t.TempDir()
+			t.Setenv(utils.GoenvEnvVarRoot.String(), tmpDir)
+			t.Setenv(utils.GoenvEnvVarDir.String(), tmpDir)
 
 			// Setup test version
-			cmdtest.CreateTestVersion(t, testRoot, tt.targetVersion)
+			cmdtest.CreateMockGoVersion(t, tmpDir, tt.targetVersion)
 
 			// Setup alias
-			aliasesFile := filepath.Join(testRoot, "aliases")
+			aliasesFile := filepath.Join(tmpDir, "aliases")
 			content := "# goenv aliases\n# Format: alias_name=target_version\n"
 			content += tt.aliasName + "=" + tt.targetVersion + "\n"
-			err := os.WriteFile(aliasesFile, []byte(content), 0644)
-			if err != nil {
-				t.Fatalf("Failed to setup aliases: %v", err)
-			}
+			testutil.WriteTestFile(t, aliasesFile, []byte(content), utils.PermFileDefault, "Failed to setup aliases")
 
 			if tt.useGlobal {
 				// Test global command with alias
@@ -350,14 +346,14 @@ func TestAliasResolution(t *testing.T) {
 				cmd.SetOut(stdout)
 				cmd.SetArgs([]string{tt.aliasName})
 
-				err = cmd.Execute()
+				err := cmd.Execute()
 				if err != nil {
 					t.Errorf("Failed to set global with alias: %v", err)
 					return
 				}
 
 				// Verify the resolved version was written
-				globalFile := filepath.Join(testRoot, "version")
+				globalFile := filepath.Join(tmpDir, "version")
 				content, err := os.ReadFile(globalFile)
 				if err != nil {
 					t.Errorf("Failed to read global version file: %v", err)
@@ -383,7 +379,7 @@ func TestAliasResolution(t *testing.T) {
 				cmd.SetOut(stdout)
 				cmd.SetArgs([]string{tt.aliasName})
 
-				err = cmd.Execute()
+				err := cmd.Execute()
 				if err != nil {
 					t.Errorf("Failed to set local with alias: %v", err)
 					return