refactor(deps): migrate Charm TUI ecosystem from v1 to v2 (#788)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: cpcloud

.github/workflows/ci.yml

@@ -65,7 +65,7 @@ jobs:
 
       - uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 # v6.3.0
         with:
-          go-version: "1.25"
+          go-version: "1.26"
 
       - name: Install extraction tools (Linux)
         if: runner.os == 'Linux'
@@ -172,7 +172,7 @@ jobs:
 
       - uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 # v6.3.0
         with:
-          go-version: "1.25"
+          go-version: "1.26"
 
       - name: Run smoke benchmarks
         run: go test -bench . -benchtime 1x -timeout 5m -run '^$' ./...
@@ -192,7 +192,7 @@ jobs:
 
       - uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 # v6.3.0
         with:
-          go-version: "1.25"
+          go-version: "1.26"
 
       - name: Check go mod tidy
         run: |

.github/workflows/security.yml

@@ -108,7 +108,7 @@ jobs:
 
       - uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 # v6.3.0
         with:
-          go-version: "1.25"
+          go-version: "1.26"
 
       - name: Initialize CodeQL
         uses: github/codeql-action/init@b1bff81932f5cdfc8695c7752dcee935dcd061c8 # v4.33.0

cmd/micasa/help.go

@@ -5,37 +5,52 @@ package main
 
 import (
 	"fmt"
+	"image/color"
+	"os"
 	"strings"
 
-	"github.com/charmbracelet/lipgloss"
+	"charm.land/lipgloss/v2"
 	"github.com/spf13/cobra"
 	"github.com/spf13/pflag"
 )
 
 // Wong palette colors (duplicated from internal/app/styles.go so the CLI
 // binary does not import the full TUI package).
-var (
-	helpAccent    = lipgloss.AdaptiveColor{Light: "#0072B2", Dark: "#56B4E9"}
-	helpSecondary = lipgloss.AdaptiveColor{Light: "#D55E00", Dark: "#E69F00"}
-	helpDim       = lipgloss.AdaptiveColor{Light: "#4B5563", Dark: "#6B7280"}
-	helpMid       = lipgloss.AdaptiveColor{Light: "#4B5563", Dark: "#9CA3AF"}
-)
+type helpColor struct{ Light, Dark string }
+
+func (c helpColor) resolve(isDark bool) color.Color {
+	if isDark {
+		return lipgloss.Color(c.Dark)
+	}
+	return lipgloss.Color(c.Light)
+}
 
 var (
-	helpHeading = lipgloss.NewStyle().
-			Foreground(helpAccent).
-			Bold(true)
-	helpCmd = lipgloss.NewStyle().
-		Foreground(helpSecondary)
-	helpFlag = lipgloss.NewStyle().
-			Foreground(helpSecondary)
-	helpDesc = lipgloss.NewStyle().
-			Foreground(helpMid)
-	helpDimStyle = lipgloss.NewStyle().
-			Foreground(helpDim)
+	helpAccentPair    = helpColor{Light: "#0072B2", Dark: "#56B4E9"}
+	helpSecondaryPair = helpColor{Light: "#D55E00", Dark: "#E69F00"}
+	helpDimPair       = helpColor{Light: "#4B5563", Dark: "#6B7280"}
+	helpMidPair       = helpColor{Light: "#4B5563", Dark: "#9CA3AF"}
 )
 
+func helpStyles(isDark bool) (heading, cmd, flag, desc, dim lipgloss.Style) {
+	heading = lipgloss.NewStyle().
+		Foreground(helpAccentPair.resolve(isDark)).
+		Bold(true)
+	cmd = lipgloss.NewStyle().
+		Foreground(helpSecondaryPair.resolve(isDark))
+	flag = lipgloss.NewStyle().
+		Foreground(helpSecondaryPair.resolve(isDark))
+	desc = lipgloss.NewStyle().
+		Foreground(helpMidPair.resolve(isDark))
+	dim = lipgloss.NewStyle().
+		Foreground(helpDimPair.resolve(isDark))
+	return
+}
+
 func styledHelp(cmd *cobra.Command, _ []string) {
+	isDark := lipgloss.HasDarkBackground(os.Stdin, os.Stderr)
+	helpHeading, helpCmd, helpFlag, helpDesc, helpDimStyle := helpStyles(isDark)
+
 	var b strings.Builder
 
 	if cmd.Long != "" {

cmd/micasa/main.go

@@ -13,8 +13,8 @@ import (
 	"path/filepath"
 	"runtime/debug"
 
-	tea "github.com/charmbracelet/bubbletea"
-	"github.com/charmbracelet/lipgloss"
+	tea "charm.land/bubbletea/v2"
+	"charm.land/lipgloss/v2"
 	"github.com/cpcloud/micasa/internal/app"
 	"github.com/cpcloud/micasa/internal/config"
 	"github.com/cpcloud/micasa/internal/data"
@@ -152,9 +152,12 @@ func launchTUI(dbPath string, seed *seedOpts) error {
 		return fmt.Errorf("load config: %w", err)
 	}
 	if len(cfg.Warnings) > 0 {
-		warnStyle := lipgloss.NewStyle().Foreground(lipgloss.AdaptiveColor{
-			Light: "#B8860B", Dark: "#F0E442", // Wong yellow
-		})
+		isDark := lipgloss.HasDarkBackground(os.Stdin, os.Stderr)
+		warnColor := "#F0E442" // Wong yellow (dark bg)
+		if !isDark {
+			warnColor = "#B8860B" // Wong yellow (light bg)
+		}
+		warnStyle := lipgloss.NewStyle().Foreground(lipgloss.Color(warnColor))
 		for _, w := range cfg.Warnings {
 			fmt.Fprintln(os.Stderr, warnStyle.Render("warning:")+" "+w)
 		}
@@ -219,7 +222,7 @@ func launchTUI(dbPath string, seed *seedOpts) error {
 	fmt.Fprint(os.Stderr, "\033[22;2t\033]2;micasa\007")
 	defer fmt.Fprint(os.Stderr, "\033[23;2t")
 
-	_, err = tea.NewProgram(model, tea.WithAltScreen(), tea.WithMouseCellMotion()).Run()
+	_, err = tea.NewProgram(model).Run()
 	if err != nil {
 		return fmt.Errorf("running program: %w", err)
 	}

flake.nix

@@ -26,14 +26,17 @@
       system:
       let
         pkgs = import nixpkgs { inherit system; };
+        go = pkgs.go_1_26;
         version = builtins.replaceStrings [ "\n" "\r" ] [ "" "" ] (builtins.readFile ./VERSION);
 
-        micasa = pkgs.buildGoModule {
+        buildGoModule = pkgs.buildGoModule.override { inherit go; };
+
+        micasa = buildGoModule {
           pname = "micasa";
           inherit version;
           src = ./.;
           subPackages = [ "cmd/micasa" ];
-          vendorHash = "sha256-QNM5befb9GmsF6XYORg259Q/x7f/DP9ukgKhwujb+uc=";
+          vendorHash = "sha256-my1oClaNceVd8nhBmaa6hIEF/7Vw8CcxKw9jED/bSNI=";
           env.CGO_ENABLED = 0;
           preCheck = ''
             export HOME="$(mktemp -d)"
@@ -214,7 +217,7 @@
           fontDirectories = [ "${pkgs.nerd-fonts.hack}/share/fonts/truetype" ];
         };
 
-        deadcode = pkgs.buildGoModule {
+        deadcode = buildGoModule {
           pname = "deadcode";
           version = "0.43.0";
           src = pkgs.fetchFromGitHub {
@@ -232,7 +235,7 @@
           name = "run-deadcode";
           runtimeInputs = [
             deadcode
-            pkgs.go
+            go
           ];
           runtimeEnv.CGO_ENABLED = "0";
           text = ''
@@ -248,7 +251,7 @@
           name = "run-govulncheck";
           runtimeInputs = [
             pkgs.govulncheck
-            pkgs.go
+            go
             pkgs.jq
             pkgs.ripgrep
           ];
@@ -288,15 +291,15 @@
           name = "run-osv-scanner";
           runtimeInputs = [ pkgs.osv-scanner ];
           text = ''
-            osv-scanner scan --config osv-scanner.toml --no-ignore --recursive .
+            osv-scanner scan --config osv-scanner.toml --no-ignore --no-call-analysis=go --recursive .
           '';
         };
 
         run-golangci-lint = pkgs.writeShellApplication {
           name = "run-golangci-lint";
           runtimeInputs = [
             pkgs.golangci-lint
-            pkgs.go
+            go
           ];
           runtimeEnv.CGO_ENABLED = "0";
           text = ''
@@ -311,7 +314,7 @@
         goModTidyCheck = pkgs.writeShellApplication {
           name = "go-mod-tidy-check";
           runtimeInputs = [
-            pkgs.go
+            go
             pkgs.git
           ];
           text = ''
@@ -326,7 +329,7 @@
         goGenerateCheck = pkgs.writeShellApplication {
           name = "go-generate-check";
           runtimeInputs = [
-            pkgs.go
+            go
             pkgs.git
           ];
           runtimeEnv.CGO_ENABLED = "0";
@@ -391,6 +394,9 @@
             shellHook = ''
               ${preCommit.shellHook}
 
+              # lipgloss v2 does not detect tmux-256color as truecolor-capable (#789)
+              export TERM=xterm-256color
+
               # Generate test document fixtures if missing.
               if [[ ! -f internal/extract/testdata/mixed-inspection.pdf ]]; then
                 bash internal/extract/gen-sample-pdf.bash
@@ -403,7 +409,7 @@
             CGO_ENABLED = "0";
             GOFLAGS = "-trimpath";
             packages = [
-              pkgs.go
+              go
               pkgs.osv-scanner
               pkgs.git
               pkgs.hugo
@@ -645,7 +651,7 @@
           run-pre-commit = pkgs.writeShellApplication {
             name = "run-pre-commit";
             runtimeInputs = [
-              pkgs.go
+              go
               pkgs.git
             ]
             ++ preCommit.enabledPackages;

go.mod

@@ -3,26 +3,18 @@
 
 module github.com/cpcloud/micasa
 
-go 1.25.5
+go 1.26
 
 require (
 	github.com/BurntSushi/toml v1.6.0
 	github.com/adrg/xdg v0.5.3
 	github.com/brianvoe/gofakeit/v7 v7.14.1
-	github.com/charmbracelet/bubbles v1.0.0
-	github.com/charmbracelet/bubbletea v1.3.10
-	github.com/charmbracelet/glamour v1.0.0
-	github.com/charmbracelet/huh v1.0.0
-	github.com/charmbracelet/lipgloss v1.1.1-0.20250404203927-76690c660834
-	github.com/charmbracelet/x/ansi v0.11.6
 	github.com/dustin/go-humanize v1.0.1
 	github.com/go-playground/validator/v10 v10.30.1
 	github.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510
 	github.com/iancoleman/strcase v0.3.0
 	github.com/itchyny/gojq v0.12.18
-	github.com/lrstanley/bubblezone v1.0.0
 	github.com/mozilla-ai/any-llm-go v0.9.0
-	github.com/rmhubbert/bubbletea-overlay v0.6.5
 	github.com/spf13/cobra v1.10.2
 	github.com/spf13/pflag v1.0.10
 	github.com/stretchr/testify v1.11.1
@@ -35,29 +27,39 @@ require (
 )
 
 require (
+	github.com/charmbracelet/ultraviolet v0.0.0-20260223171050-89c142e4aa73 // indirect
+	github.com/charmbracelet/x/exp/ordered v0.1.0 // indirect
+	github.com/charmbracelet/x/termios v0.1.1 // indirect
+	github.com/charmbracelet/x/windows v0.2.2 // indirect
+)
+
+require (
+	charm.land/bubbles/v2 v2.0.0
+	charm.land/bubbletea/v2 v2.0.2
+	charm.land/glamour/v2 v2.0.0
+	charm.land/huh/v2 v2.0.3
+	charm.land/lipgloss/v2 v2.0.2
 	cloud.google.com/go v0.123.0 // indirect
 	cloud.google.com/go/auth v0.18.2 // indirect
 	cloud.google.com/go/compute/metadata v0.9.0 // indirect
 	github.com/alecthomas/chroma/v2 v2.23.1 // indirect
 	github.com/anthropics/anthropic-sdk-go v1.27.0 // indirect
 	github.com/atotto/clipboard v0.1.4 // indirect
-	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
 	github.com/aymerick/douceur v0.2.0 // indirect
 	github.com/bahlo/generic-list-go v0.2.0 // indirect
 	github.com/buger/jsonparser v1.1.1 // indirect
 	github.com/catppuccin/go v0.3.0 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/charmbracelet/colorprofile v0.4.3 // indirect
 	github.com/charmbracelet/harmonica v0.2.0 // indirect
-	github.com/charmbracelet/x/cellbuf v0.0.15 // indirect
+	github.com/charmbracelet/x/ansi v0.11.6
 	github.com/charmbracelet/x/exp/slice v0.0.0-20260316093931-f2fb44ab3145 // indirect
 	github.com/charmbracelet/x/exp/strings v0.1.0 // indirect
 	github.com/charmbracelet/x/term v0.2.2 // indirect
 	github.com/clipperhouse/displaywidth v0.11.0 // indirect
 	github.com/clipperhouse/uax29/v2 v2.7.0 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/dlclark/regexp2 v1.11.5 // indirect
-	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
 	github.com/felixge/httpsnoop v1.0.4 // indirect
 	github.com/gabriel-vasile/mimetype v1.4.13 // indirect
 	github.com/go-logr/logr v1.4.3 // indirect
@@ -76,17 +78,14 @@ require (
 	github.com/jinzhu/inflection v1.0.0 // indirect
 	github.com/jinzhu/now v1.1.5 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/lrstanley/bubblezone/v2 v2.0.0
 	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
 	github.com/mailru/easyjson v0.9.2 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/mattn/go-localereader v0.0.1 // indirect
 	github.com/mattn/go-runewidth v0.0.21 // indirect
 	github.com/microcosm-cc/bluemonday v1.0.27 // indirect
 	github.com/mitchellh/hashstructure/v2 v2.0.2 // indirect
-	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
 	github.com/muesli/cancelreader v0.2.2 // indirect
-	github.com/muesli/reflow v0.3.0 // indirect
-	github.com/muesli/termenv v0.16.0 // indirect
 	github.com/ncruces/go-strftime v1.0.0 // indirect
 	github.com/ollama/ollama v0.18.1 // indirect
 	github.com/openai/openai-go v1.12.0 // indirect