omni-catalyst 1.0.0

package/core/tools/ai/gentle-ai/install.sh

@@ -0,0 +1,253 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+: "${OMNI_CACHE:=$HOME/.cache/omni}"
+: "${OMNI_PATH:=$HOME/omni/core}"
+: "${PREFIX:=$PREFIX}"
+
+LOG_FILE="$OMNI_CACHE/install_ai.log"
+GENTLE_AI_DATA_DIR="${GENTLE_AI_DATA_DIR:-$HOME/.local/share/omni-data/gentle-ai}"
+
+_gentle_ai_dependencies() {
+  loading "Installing dependencies" _gentle_ai_dependencies_impl
+}
+
+_gentle_ai_dependencies_impl() {
+  declare -A DEPS=(
+    ["golang"]="go"
+    ["git"]="git"
+    ["curl"]="curl"
+  )
+
+  local pkg_name bin_name
+  for pkg_name in "${!DEPS[@]}"; do
+    bin_name="${DEPS[$pkg_name]}"
+    if ! command -v "$bin_name" &>/dev/null; then
+      if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  return 0
+}
+
+_gentle_ai_ensure_go() {
+  loading "Checking Go version" _gentle_ai_ensure_go_impl
+}
+
+_gentle_ai_ensure_go_impl() {
+  if ! command -v go &>/dev/null; then
+    log_error "Go is required but not installed"
+    return 1
+  fi
+
+  local go_installed
+  go_installed=$(go version | sed 's/.*go\([0-9.]*\).*/\1/')
+
+  local go_required
+  if [ -f "$GENTLE_AI_DATA_DIR/go.mod" ]; then
+    go_required=$(sed -n 's/^go \([0-9.]*\)/\1/p' "$GENTLE_AI_DATA_DIR/go.mod" | head -1)
+  fi
+
+  if [ -z "$go_required" ]; then
+    go_required="1.25.0"
+  fi
+
+  if ! _version_ge "$go_installed" "$go_required"; then
+    log_error "Go $go_required+ required (detected $go_installed). Run: pkg upgrade golang"
+    return 1
+  fi
+
+  return 0
+}
+
+_version_ge() {
+  local v1="$1" v2="$2"
+  local highest
+  highest=$(printf '%s\n%s\n' "$v1" "$v2" | sort -V | tail -1)
+  [ "$highest" = "$v1" ]
+}
+
+_clone_or_update_repo() {
+  loading "Cloning or updating gentle-ai repo" _clone_or_update_repo_impl
+}
+
+_clone_or_update_repo_impl() {
+  local repo_url="https://github.com/Gentleman-Programming/gentle-ai.git"
+
+  if [ -d "$GENTLE_AI_DATA_DIR/.git" ]; then
+    git -C "$GENTLE_AI_DATA_DIR" remote set-url origin "$repo_url" &>>"$LOG_FILE"
+    git -C "$GENTLE_AI_DATA_DIR" stash --include-untracked &>>"$LOG_FILE" || true
+    if ! git -C "$GENTLE_AI_DATA_DIR" fetch origin &>>"$LOG_FILE"; then
+      log_error "Failed to fetch from remote"
+      return 1
+    fi
+    if ! git -C "$GENTLE_AI_DATA_DIR" reset --hard origin/main &>>"$LOG_FILE"; then
+      log_error "Failed to reset to origin/main"
+      return 1
+    fi
+  else
+    if [ -d "$GENTLE_AI_DATA_DIR" ]; then
+      rm -rf "$GENTLE_AI_DATA_DIR"
+    fi
+    if ! git clone "$repo_url" "$GENTLE_AI_DATA_DIR" &>>"$LOG_FILE"; then
+      log_error "Failed to clone gentle-ai repo"
+      return 1
+    fi
+  fi
+
+  return 0
+}
+
+_build_and_apply_patches() {
+  loading "Applying Termux patches" _build_and_apply_patches_impl
+}
+
+_build_and_apply_patches_impl() {
+  local patcher_src="$OMNI_PATH/tools/ai/gentle-ai/termux-patches.go"
+  local patcher_bin="$OMNI_CACHE/termux-patcher"
+
+  mkdir -p "$OMNI_CACHE"
+
+  if [ ! -f "$patcher_bin" ] || [ "$patcher_src" -nt "$patcher_bin" ]; then
+    if ! go build -o "$patcher_bin" "$patcher_src" &>>"$LOG_FILE"; then
+      log_error "Failed to compile patcher"
+      return 1
+    fi
+  fi
+
+  pushd "$GENTLE_AI_DATA_DIR" &>/dev/null || return 1
+
+  local patch_out patch_rc
+  patch_out=$("$patcher_bin" "$GENTLE_AI_DATA_DIR" 2>&1)
+  patch_rc=$?
+
+  echo "$patch_out" >>"$LOG_FILE"
+
+  if [ $patch_rc -ne 0 ]; then
+    popd &>/dev/null || true
+    echo ""
+    log_error "Termux patches failed. Output:"
+    echo "$patch_out"
+    return 1
+  fi
+
+  popd &>/dev/null || true
+  return 0
+}
+
+_compile() {
+  loading "Compiling gentle-ai" _compile_impl
+}
+
+_compile_impl() {
+  if ! command -v gcc &>/dev/null && ! command -v clang &>/dev/null; then
+    export CGO_ENABLED=0
+  fi
+
+  local build_dir="$GENTLE_AI_DATA_DIR/cmd/gentle-ai"
+  if [ ! -d "$build_dir" ]; then
+    log_error "Entry point not found at cmd/gentle-ai"
+    return 1
+  fi
+
+  pushd "$GENTLE_AI_DATA_DIR" &>/dev/null || return 1
+
+  if ! go mod download &>>"$LOG_FILE"; then
+    popd &>/dev/null || true
+    log_error "Failed to download Go dependencies"
+    return 1
+  fi
+
+  if ! go build -trimpath -ldflags="-s -w" -o gentle-ai ./cmd/gentle-ai/ &>>"$LOG_FILE"; then
+    popd &>/dev/null || true
+    log_error "Failed to compile gentle-ai"
+    return 1
+  fi
+
+  popd &>/dev/null || true
+
+  if [ ! -f "$GENTLE_AI_DATA_DIR/gentle-ai" ]; then
+    log_error "Compilation succeeded but binary not found"
+    return 1
+  fi
+
+  return 0
+}
+
+_install_binary() {
+  loading "Installing binary" _install_binary_impl
+}
+
+_install_binary_impl() {
+  if ! cp "$GENTLE_AI_DATA_DIR/gentle-ai" "$PREFIX/bin/gentle-ai" &>>"$LOG_FILE"; then
+    log_error "Failed to install binary to $PREFIX/bin/gentle-ai"
+    return 1
+  fi
+
+  chmod +x "$PREFIX/bin/gentle-ai"
+  return 0
+}
+
+install_gentle_ai() {
+  if command -v gentle-ai &>/dev/null; then
+    log_info "gentle-ai is already installed"
+    return 2
+  fi
+
+  log_info "Installing gentle-ai..."
+  mkdir -p "$(dirname "$LOG_FILE")" "$OMNI_CACHE"
+
+  _gentle_ai_dependencies || return 1
+  _clone_or_update_repo || return 1
+  _gentle_ai_ensure_go || return 1
+  _build_and_apply_patches || return 1
+  _compile || return 1
+  _install_binary || return 1
+
+  log_success "gentle-ai installed"
+  return 0
+}
+
+uninstall_gentle_ai() {
+  if ! command -v gentle-ai &>/dev/null; then
+    log_info "gentle-ai is not installed"
+    return 2
+  fi
+  log_info "Uninstalling gentle-ai..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  rm -f "$PREFIX/bin/gentle-ai"
+  rm -rf "$GENTLE_AI_DATA_DIR"
+
+  if [ ! -f "$PREFIX/bin/gentle-ai" ] && [ ! -d "$GENTLE_AI_DATA_DIR" ]; then
+    log_success "gentle-ai uninstalled"
+    return 0
+  else
+    log_error "Failed to uninstall gentle-ai"
+    return 1
+  fi
+}
+
+update_gentle_ai() {
+  log_info "Updating gentle-ai..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _clone_or_update_repo || return 1
+  _gentle_ai_ensure_go || return 1
+  _build_and_apply_patches || return 1
+  _compile || return 1
+  _install_binary || return 1
+
+  log_success "gentle-ai updated"
+  return 0
+}
+
+reinstall_gentle_ai() {
+  uninstall_gentle_ai
+  install_gentle_ai
+}

package/core/tools/ai/gentle-ai/termux-patches.go

@@ -0,0 +1,256 @@
+// termux-patches applies the necessary source-code changes to compile and run
+// gentle-ai on Android/Termux.
+//
+// Unlike a sed-based approach, this program uses exact Go source patterns so
+// that upstream changes that break the patch are DETECTED (non-zero exit)
+// rather than silently skipped.
+//
+// Usage:
+//
+//	go run termux-patches.go [source-directory]
+//
+// Default source-directory is "." (current directory).
+// The program modifies files in-place.
+package main
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+)
+
+func main() {
+	srcDir := "."
+	if len(os.Args) > 1 {
+		srcDir = os.Args[1]
+	}
+
+	type patchDef struct {
+		path    string
+		patchFn func(string) (string, error)
+	}
+
+	patches := []patchDef{
+		{filepath.Join(srcDir, "internal/system/detect.go"), patchDetectGo},
+		{filepath.Join(srcDir, "internal/system/guard.go"), patchGuardGo},
+		{filepath.Join(srcDir, "internal/update/upgrade/download.go"), patchDownloadGo},
+		{filepath.Join(srcDir, "internal/tui/model.go"), patchModelGo},
+		{filepath.Join(srcDir, "internal/components/engram/download.go"), patchEngramDownloadGo},
+	}
+
+	anyFailed := false
+	for _, p := range patches {
+		content, err := os.ReadFile(p.path)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "ERROR reading %s: %v\n", p.path, err)
+			anyFailed = true
+			continue
+		}
+		result, err := p.patchFn(string(content))
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "ERROR patching %s: %v\n", p.path, err)
+			anyFailed = true
+			continue
+		}
+		if result != string(content) {
+			if err := os.WriteFile(p.path, []byte(result), 0o644); err != nil {
+				fmt.Fprintf(os.Stderr, "ERROR writing %s: %v\n", p.path, err)
+				anyFailed = true
+				continue
+			}
+			fmt.Printf("PATCHED %s\n", p.path)
+		} else {
+			fmt.Printf("ALREADY PATCHED %s\n", p.path)
+		}
+	}
+
+	if anyFailed {
+		os.Exit(1)
+	}
+}
+
+// ---------------------------------------------------------------------------
+// helpers
+// ---------------------------------------------------------------------------
+
+func tab(n int) string {
+	return strings.Repeat("\t", n)
+}
+
+// assertReplace replaces old with new in src once.
+// If old is not found, it checks whether new is already present (idempotent).
+// If neither is found, it returns an error with a descriptive message.
+func assertReplace(src, old, new, desc string) (string, error) {
+	if strings.Contains(src, old) {
+		return strings.Replace(src, old, new, 1), nil
+	}
+	if strings.Contains(src, new) {
+		return src, nil
+	}
+	return src, fmt.Errorf("%s: pattern not found in source", desc)
+}
+
+// ---------------------------------------------------------------------------
+// 1. internal/system/detect.go
+// ---------------------------------------------------------------------------
+
+func patchDetectGo(src string) (string, error) {
+	var err error
+
+	// 1a. IsSupportedOS: add android to the list.
+	old1 := tab(1) + `return goos == "darwin" || goos == "linux" || goos == "windows"` + "\n}"
+	new1 := tab(1) + `return goos == "darwin" || goos == "linux" || goos == "windows" || goos == "android"` + "\n}"
+	src, err = assertReplace(src, old1, new1, "IsSupportedOS return")
+	if err != nil {
+		return src, err
+	}
+
+	// 1b. resolvePlatformProfile: add case "android" before default.
+	old2 := "" +
+		tab(1) + `case "windows":` + "\n" +
+		tab(2) + `profile.PackageManager = "winget"` + "\n" +
+		tab(2) + `profile.Supported = true` + "\n" +
+		tab(2) + `return profile` + "\n" +
+		tab(1) + `default:`
+	new2 := "" +
+		tab(1) + `case "windows":` + "\n" +
+		tab(2) + `profile.PackageManager = "winget"` + "\n" +
+		tab(2) + `profile.Supported = true` + "\n" +
+		tab(2) + `return profile` + "\n" +
+		tab(1) + `case "android":` + "\n" +
+		tab(2) + `profile.PackageManager = "pkg"` + "\n" +
+		tab(2) + `profile.Supported = true` + "\n" +
+		tab(2) + `distro := detectLinuxDistro(linuxOSRelease)` + "\n" +
+		tab(2) + `if distro != LinuxDistroUnknown {` + "\n" +
+		tab(3) + `profile.LinuxDistro = distro` + "\n" +
+		tab(2) + `}` + "\n" +
+		tab(2) + `return profile` + "\n" +
+		tab(1) + `default:`
+	src, err = assertReplace(src, old2, new2, "resolvePlatformProfile android case")
+	if err != nil {
+		return src, err
+	}
+
+	// 1c. osReleaseContent: read $PREFIX/etc/os-release on android.
+	old3 := "" +
+		`func osReleaseContent(goos string) (string, error) {` + "\n" +
+		tab(1) + `if goos != "linux" {` + "\n" +
+		tab(2) + `return "", nil` + "\n" +
+		tab(1) + `}`
+	new3 := "" +
+		`func osReleaseContent(goos string) (string, error) {` + "\n" +
+		tab(1) + `if goos == "android" {` + "\n" +
+		tab(2) + `prefix := os.Getenv("PREFIX")` + "\n" +
+		tab(2) + `if prefix != "" {` + "\n" +
+		tab(3) + `if data, err := os.ReadFile(prefix + "/etc/os-release"); err == nil {` + "\n" +
+		tab(4) + `return string(data), nil` + "\n" +
+		tab(3) + `}` + "\n" +
+		tab(2) + `}` + "\n" +
+		tab(2) + `return "", nil` + "\n" +
+		tab(1) + `}` + "\n" +
+		tab(1) + `if goos != "linux" {` + "\n" +
+		tab(2) + `return "", nil` + "\n" +
+		tab(1) + `}`
+	src, err = assertReplace(src, old3, new3, "osReleaseContent android PREFIX")
+	if err != nil {
+		return src, err
+	}
+
+	return src, nil
+}
+
+// ---------------------------------------------------------------------------
+// 2. internal/system/guard.go
+// ---------------------------------------------------------------------------
+
+func patchGuardGo(src string) (string, error) {
+	// EnsureSupportedOS error message: mention Android.
+	old1 := `return fmt.Errorf("%w: only macOS, Linux, and Windows are supported (detected %s)", ErrUnsupportedOS, goos)`
+	new1 := `return fmt.Errorf("%w: only macOS, Linux, Windows, and Android are supported (detected %s)", ErrUnsupportedOS, goos)`
+	return assertReplace(src, old1, new1, "EnsureSupportedOS error message Android")
+}
+
+// ---------------------------------------------------------------------------
+// 3. internal/update/upgrade/download.go
+// ---------------------------------------------------------------------------
+
+func patchDownloadGo(src string) (string, error) {
+	// On Android/Termux, download linux binaries (no android releases on
+	// GitHub). profile is passed by value so the modification is local.
+	old1 := `func Download(ctx context.Context, r update.UpdateResult, profile system.PlatformProfile) error {` + "\n" +
+		tab(1) + `if profile.OS == "windows" {`
+	new1 := `func Download(ctx context.Context, r update.UpdateResult, profile system.PlatformProfile) error {` + "\n" +
+		tab(1) + `if profile.OS == "android" {` + "\n" +
+		tab(2) + `profile.OS = "linux"` + "\n" +
+		tab(1) + `}` + "\n" +
+		"\n" +
+		tab(1) + `if profile.OS == "windows" {`
+	return assertReplace(src, old1, new1, "Download android->linux redirect")
+}
+
+// ---------------------------------------------------------------------------
+// 4. internal/tui/model.go
+// ---------------------------------------------------------------------------
+
+func patchModelGo(src string) (string, error) {
+	// openBrowserCmd: use termux-open-url on android.
+	old1 := "" +
+		tab(2) + `case "windows":` + "\n" +
+		tab(3) + `cmd = execCommandFn("rundll32", "url.dll,FileProtocolHandler", url)` + "\n" +
+		tab(2) + `default:` + "\n" +
+		tab(3) + `cmd = execCommandFn("xdg-open", url)`
+	new1 := "" +
+		tab(2) + `case "windows":` + "\n" +
+		tab(3) + `cmd = execCommandFn("rundll32", "url.dll,FileProtocolHandler", url)` + "\n" +
+		tab(2) + `case "android":` + "\n" +
+		tab(3) + `cmd = execCommandFn("termux-open-url", url)` + "\n" +
+		tab(2) + `default:` + "\n" +
+		tab(3) + `cmd = execCommandFn("xdg-open", url)`
+	return assertReplace(src, old1, new1, "openBrowserCmd android case")
+}
+
+// ---------------------------------------------------------------------------
+// 5. internal/components/engram/download.go
+// ---------------------------------------------------------------------------
+
+func patchEngramDownloadGo(src string) (string, error) {
+	var err error
+
+	// 5a. DownloadLatestBinary: redirect android -> linux for asset URLs.
+	old1 := "" +
+		tab(1) + `goos := profile.OS` + "\n" +
+		tab(1) + `goarch := normalizeArch(runtime.GOARCH)`
+	new1 := "" +
+		tab(1) + `goos := profile.OS` + "\n" +
+		tab(1) + `if goos == "android" {` + "\n" +
+		tab(2) + `goos = "linux"` + "\n" +
+		tab(1) + `}` + "\n" +
+		tab(1) + `goarch := normalizeArch(runtime.GOARCH)`
+	src, err = assertReplace(src, old1, new1, "engram DownloadLatestBinary android->linux")
+	if err != nil {
+		return src, err
+	}
+
+	// 5b. engramInstallDir: use $PREFIX/bin on Termux.
+	old2 := "" +
+		`func engramInstallDir(goos string) string {` + "\n" +
+		tab(1) + `if goos == "windows" {`
+	new2 := "" +
+		`func engramInstallDir(goos string) string {` + "\n" +
+		tab(1) + `if goos == "android" {` + "\n" +
+		tab(2) + `prefix := os.Getenv("PREFIX")` + "\n" +
+		tab(2) + `if prefix != "" {` + "\n" +
+		tab(3) + `return filepath.Join(prefix, "bin")` + "\n" +
+		tab(2) + `}` + "\n" +
+		tab(2) + `return "/data/data/com.termux/files/usr/bin"` + "\n" +
+		tab(1) + `}` + "\n" +
+		"\n" +
+		tab(1) + `if goos == "windows" {`
+	src, err = assertReplace(src, old2, new2, "engramInstallDir android PREFIX")
+	if err != nil {
+		return src, err
+	}
+
+	return src, nil
+}

package/core/tools/ai/gga/README.md

@@ -0,0 +1,49 @@
+# Gentleman Guardian Angel
+
+Provider-agnostic AI code review on every commit
+
+**Package:** gga  
+**Author:** Gentleman-Programming  
+**Repository:** https://github.com/israel676767/omni  
+**Official:** https://github.com/Gentleman-Programming/gentleman-guardian-angel  
+**Termux fork:** https://github.com/israel676767/gga-termux  
+**Type:** AI code review CLI (Pure Bash)  
+**License:** MIT
+
+## Description
+
+GGA (Gentleman Guardian Angel) is a provider-agnostic AI code review tool that runs on every commit. It validates staged files against your `AGENTS.md` rules using any LLM provider (Claude, Gemini, Codex, OpenCode, Ollama, LM Studio, GitHub Models). Pure Bash, zero dependencies, works as a standard pre-commit git hook.
+
+The Termux fork adapts the installer/uninstaller for Android environments (Termux detects `$PREFIX` and installs to `$PREFIX/bin` and `$PREFIX/share/gga/lib`).
+
+## Dependencies
+
+- git, curl
+- bash 5.0+
+
+## Install
+
+```bash
+core install ai --gga
+```
+
+## Uninstall
+
+```bash
+core uninstall ai --gga
+```
+
+## Update
+
+```bash
+core update ai --gga
+```
+
+## Notes
+
+- Source cloned to `$OMNI_DATA/gga-termux/` (`~/.local/share/omni-data/gga-termux/`)
+- Binary installed to `$PREFIX/bin/gga`
+- Libraries installed to `$PREFIX/share/gga/lib/`
+- Clones the Termux-compatible fork and runs its bundled `install.sh` / `uninstall.sh`
+- Repository is updated via `git pull` on `core update ai --gga`
+- Requires the gga repo to be present at runtime only during install/update (can be safely removed afterward)

package/core/tools/ai/gga/install.sh

@@ -0,0 +1,134 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+LOG_FILE="$OMNI_CACHE/install_ai.log"
+GGA_DATA_DIR="$OMNI_DATA/gga-termux"
+
+_gga_dependencies() {
+	loading "Installing dependencies" _gga_dependencies_impl
+}
+
+_gga_dependencies_impl() {
+	declare -A DEPS=(
+		["git"]="git"
+		["curl"]="curl"
+	)
+
+	local pkg_name bin_name
+	for pkg_name in "${!DEPS[@]}"; do
+		bin_name="${DEPS[$pkg_name]}"
+		if ! command -v "$bin_name" &>/dev/null; then
+			if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+				log_error "Failed to install $pkg_name"
+				return 1
+			fi
+		fi
+	done
+
+	return 0
+}
+
+_gga_clone_or_update_repo() {
+	loading "Cloning or updating gga-termux repo" _gga_clone_or_update_repo_impl
+}
+
+_gga_clone_or_update_repo_impl() {
+	local repo_url="https://github.com/israel676767/gga-termux.git"
+
+	if [ -d "$GGA_DATA_DIR/.git" ]; then
+		if ! git -C "$GGA_DATA_DIR" pull --ff-only &>>"$LOG_FILE"; then
+			log_error "Failed to update gga-termux repo"
+			return 1
+		fi
+	else
+		mkdir -p "$(dirname "$GGA_DATA_DIR")"
+		if ! git clone "$repo_url" "$GGA_DATA_DIR" &>>"$LOG_FILE"; then
+			log_error "Failed to clone gga-termux repo"
+			return 1
+		fi
+	fi
+
+	return 0
+}
+
+_gga_run_installer() {
+	loading "Running gga-termux installer" _gga_run_installer_impl
+}
+
+_gga_run_installer_impl() {
+	if [ ! -d "$GGA_DATA_DIR" ] || [ ! -f "$GGA_DATA_DIR/install.sh" ]; then
+		log_error "gga-termux repo not found at $GGA_DATA_DIR"
+		return 1
+	fi
+
+	if ! (cd "$GGA_DATA_DIR" && bash ./install.sh < /dev/null) &>>"$LOG_FILE"; then
+		log_error "gga-termux install.sh failed (see $LOG_FILE)"
+		return 1
+	fi
+
+	return 0
+}
+
+install_gga() {
+	if command -v gga &>/dev/null; then
+		log_info "GGA is already installed"
+		return 2
+	fi
+
+	log_info "Installing GGA..."
+
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	_gga_dependencies || return 1
+	_gga_clone_or_update_repo || return 1
+	_gga_run_installer || return 1
+
+	log_success "GGA installed"
+	return 0
+}
+
+uninstall_gga() {
+	if ! command -v gga &>/dev/null; then
+		log_info "GGA is not installed"
+		return 2
+	fi
+	log_info "Uninstalling GGA..."
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	if [ -d "$GGA_DATA_DIR" ] && [ -f "$GGA_DATA_DIR/uninstall.sh" ]; then
+		log_info "Running gga-termux uninstaller..."
+		if ! (cd "$GGA_DATA_DIR" && printf "n\n" | bash ./uninstall.sh) &>>"$LOG_FILE"; then
+			log_warn "gga-termux uninstall.sh failed, falling back to manual cleanup"
+		fi
+	fi
+
+	rm -f "$PREFIX/bin/gga"
+	rm -rf "$PREFIX/share/gga"
+	rm -rf "$GGA_DATA_DIR"
+
+	if [ ! -f "$PREFIX/bin/gga" ] && [ ! -d "$GGA_DATA_DIR" ]; then
+		log_success "GGA uninstalled"
+		return 0
+	else
+		log_error "Failed to uninstall GGA"
+		return 1
+	fi
+}
+
+update_gga() {
+	log_info "Updating GGA..."
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	_gga_clone_or_update_repo || return 1
+	_gga_run_installer || return 1
+
+	log_success "GGA updated"
+	return 0
+}
+
+reinstall_gga() {
+	uninstall_gga
+	install_gga
+}