Merge pull request #43 from SkeneTechnologies/feat/update-checker

Show update notification on TUI welcome screen

Author: eretjohannes

tui/internal/constants/strings.go

@@ -124,6 +124,13 @@ const (
 	WelcomeCTA      = "> ENTER <"
 )
 
+// Update notice (welcome view)
+const (
+	UpdateNoticeFormat   = "Update available: %s (current: %s)"
+	UpdateNoticeHintCopy = "Press c to copy update command"
+	UpdateNoticeCopied   = "Copied to clipboard!"
+)
+
 // Auth view
 const (
 	AuthOpeningBrowser  = "Opening browser for Skene authentication"
@@ -222,6 +229,7 @@ const (
 	HelpKeyG         = "g"
 	HelpKeyM         = "m"
 	HelpKeyR         = "r"
+	HelpKeyC         = "c"
 )
 
 // Help descriptions
@@ -265,4 +273,5 @@ const (
 	HelpDescToggleOption     = "toggle option"
 	HelpDescOpenFolder       = "open folder"
 	HelpDescTabs             = "tabs"
+	HelpDescCopyUpdateCmd    = "copy update cmd"
 )

tui/internal/services/versioncheck/checker.go

@@ -0,0 +1,98 @@
+package versioncheck
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+	"time"
+
+	"skene/internal/constants"
+)
+
+// Result holds the outcome of a version check.
+type Result struct {
+	// NewVersion is set when an update is available (e.g. "v0.4.0").
+	NewVersion string
+	// UpdateCmd is the command users can run to update.
+	UpdateCmd string
+}
+
+// githubRelease is the subset of the GitHub API response we care about.
+type githubRelease struct {
+	TagName string `json:"tag_name"`
+}
+
+// Check queries GitHub for the latest TUI release and compares it to the
+// running binary's version. Returns nil when already up-to-date or when
+// the check cannot be performed (network error, dev build, etc.).
+func Check() *Result {
+	if constants.Version == "dev" {
+		return nil
+	}
+
+	client := &http.Client{Timeout: 3 * time.Second}
+
+	// List recent releases and find the latest tui-v* tag.
+	// constants.Repository includes the "github.com/" prefix, strip it for the API.
+	repo := strings.TrimPrefix(constants.Repository, "github.com/")
+	url := fmt.Sprintf("https://api.github.com/repos/%s/releases?per_page=20", repo)
+	resp, err := client.Get(url)
+	if err != nil || resp.StatusCode != http.StatusOK {
+		return nil
+	}
+	defer resp.Body.Close()
+
+	var releases []githubRelease
+	if err := json.NewDecoder(resp.Body).Decode(&releases); err != nil {
+		return nil
+	}
+
+	latest := latestTUITag(releases)
+	if latest == "" {
+		return nil
+	}
+
+	// Strip "tui-" prefix to compare just the version part.
+	latestVersion := strings.TrimPrefix(latest, "tui-")
+	if latestVersion == constants.Version {
+		return nil
+	}
+
+	return &Result{
+		NewVersion: latestVersion,
+		UpdateCmd:  "curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash",
+	}
+}
+
+// latestTUITag returns the first tui-v* tag from the releases list,
+// which GitHub returns in reverse chronological order. Pre-release
+// tags are skipped.
+func latestTUITag(releases []githubRelease) string {
+	for _, r := range releases {
+		if strings.HasPrefix(r.TagName, "tui-v") && !isPreRelease(r.TagName) {
+			return r.TagName
+		}
+	}
+	return ""
+}
+
+// isPreRelease returns true for tags like tui-v0.3.0rc1, tui-v0.3.0a1, etc.
+func isPreRelease(tag string) bool {
+	v := strings.TrimPrefix(tag, "tui-")
+	for _, suffix := range []string{"rc", "alpha", "beta"} {
+		if strings.Contains(v, suffix) {
+			return true
+		}
+	}
+	// Check for "a" or "b" followed by a digit (e.g. v0.3.0a1)
+	for i := 0; i < len(v)-1; i++ {
+		if (v[i] == 'a' || v[i] == 'b') && v[i+1] >= '0' && v[i+1] <= '9' {
+			// Make sure it's not part of a hex-like version segment
+			if i == 0 || v[i-1] == '.' || v[i-1] >= '0' && v[i-1] <= '9' {
+				return true
+			}
+		}
+	}
+	return false
+}

tui/internal/tui/app.go

@@ -8,9 +8,11 @@ import (
 
 	"skene/internal/constants"
 	"skene/internal/game"
+	"github.com/atotto/clipboard"
 	"skene/internal/services/auth"
 	"skene/internal/services/config"
 	"skene/internal/services/growth"
+	"skene/internal/services/versioncheck"
 	"skene/internal/tui/components"
 	"skene/internal/tui/styles"
 	"skene/internal/tui/views"
@@ -97,6 +99,11 @@ type AuthCallbackMsg struct {
 	Error  error
 }
 
+// VersionCheckMsg is sent when the background version check completes
+type VersionCheckMsg struct {
+	Result *versioncheck.Result
+}
+
 // authVerifiedMsg triggers the transition from verifying to success state
 type authVerifiedMsg struct{}
 
@@ -201,6 +208,7 @@ func (a *App) Init() tea.Cmd {
 	var cmds []tea.Cmd
 	cmds = append(cmds, tick())
 	cmds = append(cmds, textinput.Blink)
+	cmds = append(cmds, checkForUpdate())
 	// Initialize welcome animation
 	if a.welcomeView != nil {
 		animCmd := a.welcomeView.InitAnimation()
@@ -312,6 +320,11 @@ func (a *App) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			cmds = append(cmds, countdown(a.authCountdown-1))
 		}
 
+	case VersionCheckMsg:
+		if msg.Result != nil && a.welcomeView != nil {
+			a.welcomeView.SetUpdateAvailable(msg.Result.NewVersion, msg.Result.UpdateCmd)
+		}
+
 	case AnalysisDoneMsg:
 		err := msg.Error
 		if err == nil && msg.Result != nil && msg.Result.Error != nil {
@@ -534,6 +547,13 @@ func (a *App) handleWelcomeKeys(key string) tea.Cmd {
 			a.providerView.SetSize(a.width, a.height)
 		}
 		return nil
+	case "c":
+		if a.welcomeView != nil && a.welcomeView.HasUpdate() {
+			if clipboard.WriteAll(a.welcomeView.GetUpdateCmd()) == nil {
+				a.welcomeView.SetCopied()
+			}
+		}
+		return nil
 	}
 	return nil
 }
@@ -1654,6 +1674,12 @@ func tick() tea.Cmd {
 	})
 }
 
+func checkForUpdate() tea.Cmd {
+	return func() tea.Msg {
+		return VersionCheckMsg{Result: versioncheck.Check()}
+	}
+}
+
 func countdown(seconds int) tea.Cmd {
 	return tea.Tick(time.Second, func(t time.Time) tea.Msg {
 		return CountdownMsg(seconds)

tui/internal/tui/styles/styles.go

@@ -174,6 +174,12 @@ var FooterHelp lipgloss.Style
 // Spinner style
 var Spinner lipgloss.Style
 
+// UpdateNotice style — framed box for update + hint
+var UpdateNotice lipgloss.Style
+
+// UpdateNoticeText style — main update message (white)
+var UpdateNoticeText lipgloss.Style
+
 // rebuildStyles constructs all lipgloss styles from the current color
 // variables. Called by Init() after colors have been set.
 func rebuildStyles() {
@@ -290,6 +296,15 @@ func rebuildStyles() {
 
 	// Spinner style
 	Spinner = lipgloss.NewStyle().Foreground(Amber)
+
+	// UpdateNotice — bordered box for update + hint (no bg; centered text)
+	UpdateNotice = lipgloss.NewStyle().
+		Border(lipgloss.RoundedBorder()).
+		BorderForeground(MidGray).
+		Padding(1, 1).
+		Align(lipgloss.Center).
+		MarginTop(1)
+	UpdateNoticeText = lipgloss.NewStyle().Foreground(White)
 }
 
 // init sets up the default dark-theme styles at package load time.

tui/internal/tui/views/welcome.go

@@ -1,6 +1,8 @@
 package views
 
 import (
+	"fmt"
+
 	tea "github.com/charmbracelet/bubbletea"
 	"skene/internal/constants"
 	"skene/internal/tui/components"
@@ -15,6 +17,11 @@ type WelcomeView struct {
 	height int
 	time   float64
 	anim   components.ASCIIMotionModel
+
+	// Update notification (set asynchronously)
+	newVersion string
+	updateCmd  string
+	copied     bool
 }
 
 // NewWelcomeView creates a new welcome view
@@ -49,6 +56,27 @@ func (v *WelcomeView) InitAnimation() tea.Cmd {
 	return v.anim.Init()
 }
 
+// SetUpdateAvailable sets the update notification info
+func (v *WelcomeView) SetUpdateAvailable(newVersion, updateCmd string) {
+	v.newVersion = newVersion
+	v.updateCmd = updateCmd
+}
+
+// HasUpdate returns true if an update notification is present.
+func (v *WelcomeView) HasUpdate() bool {
+	return v.newVersion != ""
+}
+
+// GetUpdateCmd returns the update command string.
+func (v *WelcomeView) GetUpdateCmd() string {
+	return v.updateCmd
+}
+
+// SetCopied marks the update command as copied to clipboard.
+func (v *WelcomeView) SetCopied() {
+	v.copied = true
+}
+
 // ResetAnimation recreates the animation so it plays from the start
 func (v *WelcomeView) ResetAnimation() tea.Cmd {
 	v.anim = components.NewASCIIMotion(styles.IsDarkBackground)
@@ -79,15 +107,37 @@ func (v *WelcomeView) Render() string {
 	// Version info
 	version := center.Render(styles.Muted.Render(constants.Version + " • " + constants.Repository))
 
+	// Update notification — bordered block with update + hint
+	var updateNotice string
+	if v.newVersion != "" {
+		notice := fmt.Sprintf(constants.UpdateNoticeFormat, v.newVersion, constants.Version)
+		hintRaw := constants.UpdateNoticeHintCopy
+		if v.copied {
+			hintRaw = constants.UpdateNoticeCopied
+		}
+		hint := styles.Muted.Render(hintRaw)
+		blockWidth := lipgloss.Width(notice)
+		if w := lipgloss.Width(hintRaw); w > blockWidth {
+			blockWidth = w
+		}
+		blockWidth += 4 // padding
+		content := styles.UpdateNoticeText.Render(notice) + "\n" + hint
+		block := styles.UpdateNotice.Width(blockWidth).Render(content)
+		updateNotice = center.Render(block)
+	}
+
 	// Footer help
-	footer := components.FooterHelp([]components.HelpItem{
+	helpItems := []components.HelpItem{
 		{Key: constants.HelpKeyEnter, Desc: constants.HelpDescStart},
 		{Key: constants.HelpKeyCtrlC, Desc: constants.HelpDescQuit},
-	})
+	}
+	if v.newVersion != "" {
+		helpItems = append(helpItems, components.HelpItem{Key: constants.HelpKeyC, Desc: constants.HelpDescCopyUpdateCmd})
+	}
+	footer := components.FooterHelp(helpItems)
 
 	// Combine elements
-	content := lipgloss.JoinVertical(
-		lipgloss.Center,
+	elements := []string{
 		logo,
 		"",
 		"",
@@ -96,6 +146,13 @@ func (v *WelcomeView) Render() string {
 		subtitle,
 		"",
 		version,
+	}
+	if updateNotice != "" {
+		elements = append(elements, "", updateNotice)
+	}
+	content := lipgloss.JoinVertical(
+		lipgloss.Center,
+		elements...,
 	)
 
 	centered := lipgloss.Place(
@@ -118,8 +175,12 @@ func (v *WelcomeView) Render() string {
 
 // GetHelpItems returns context-specific help
 func (v *WelcomeView) GetHelpItems() []components.HelpItem {
-	return []components.HelpItem{
+	items := []components.HelpItem{
 		{Key: constants.HelpKeyEnter, Desc: constants.HelpDescStart},
 		{Key: constants.HelpKeyCtrlC, Desc: constants.HelpDescQuit},
 	}
+	if v.newVersion != "" {
+		items = append(items, components.HelpItem{Key: constants.HelpKeyC, Desc: constants.HelpDescCopyUpdateCmd})
+	}
+	return items
 }