@cats-inc/cats-platform 0.1.21 → 0.3.4

package/scripts/linux/provider-cli-common.sh

@@ -4,6 +4,7 @@ if [ -n "${CATS_PLATFORM_UNIX_PROVIDER_COMMON_SH:-}" ]; then
   return 0 2>/dev/null || exit 0
 fi
 readonly CATS_PLATFORM_UNIX_PROVIDER_COMMON_SH=1
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/provider-version-common.sh"
 
 json_escape() {
   local value="$1"
@@ -52,7 +53,7 @@ provider_display_name() {
     antigravity) printf '%s\n' 'Antigravity CLI' ;;
     grok) printf '%s\n' 'Grok CLI' ;;
     devin) printf '%s\n' 'Devin CLI' ;;
-    aider) printf '%s\n' 'Aider' ;;
+    muse) printf '%s\n' 'Meta Muse CLI' ;;
     claude) printf '%s\n' 'Claude Code CLI' ;;
     cursor) printf '%s\n' 'Cursor Agent CLI' ;;
     goose) printf '%s\n' 'Goose CLI' ;;
@@ -67,7 +68,7 @@ provider_primary_command() {
     antigravity) printf '%s\n' 'agy' ;;
     grok) printf '%s\n' 'grok' ;;
     devin) printf '%s\n' 'devin' ;;
-    aider) printf '%s\n' 'aider' ;;
+    muse) printf '%s\n' 'muse' ;;
     claude) printf '%s\n' 'claude' ;;
     cursor) printf '%s\n' 'cursor-agent' ;;
     goose) printf '%s\n' 'goose' ;;
@@ -98,7 +99,7 @@ provider_install_url() {
     antigravity) printf '%s\n' 'https://antigravity.google/cli/install.sh' ;;
     grok) printf '%s\n' 'https://x.ai/cli/install.sh' ;;
     devin) printf '%s\n' 'https://cli.devin.ai/install.sh' ;;
-    aider) printf '%s\n' 'https://aider.chat/install.sh' ;;
+    muse) printf '%s\n' 'https://dev.meta.ai/install.sh' ;;
     claude) printf '%s\n' 'https://claude.ai/install.sh' ;;
     cursor) printf '%s\n' 'https://cursor.com/install' ;;
     goose) printf '%s\n' 'https://github.com/block/goose/releases/download/stable/download_cli.sh' ;;
@@ -111,6 +112,7 @@ provider_install_url() {
 provider_install_dir() {
   case "$1" in
     grok) printf '%s\n' "$HOME/.grok/bin" ;;
+    muse) muse_install_dir ;;
     *) printf '%s\n' "$HOME/.local/bin" ;;
   esac
 }
@@ -249,12 +251,59 @@ ensure_provider_alias() {
   fi
 }
 
+# muse's install directory holds the launcher, its state files, and one
+# muse-bin-<version> build per version it has downloaded.
+muse_install_dir() {
+  printf '%s\n' "${MUSE_INSTALL_DIR:-$HOME/.local/bin}"
+}
+
+# The version comes from the launcher's own state file, never from running muse.
+# The launcher forwards every argument straight to the agent binary, so a flag
+# that binary does not recognise opens the interactive TUI and hangs an
+# unattended setup run forever.
+muse_installed_version() {
+  local version_file
+  version_file="$(muse_install_dir)/.muse-version"
+  if [ -r "$version_file" ]; then
+    tr -d '\r\n' < "$version_file"
+  fi
+}
+
+# "Installed" means the launcher actually fetched a build. The official
+# installer writes the launcher first and downloads muse-bin-<version> last, so
+# a run that dies in between leaves a launcher with nothing behind it. Treating
+# that as installed would skip the reinstall that repairs it.
+muse_install_complete() {
+  local dir version
+  dir="$(muse_install_dir)"
+  [ -x "$dir/muse" ] || return 1
+  version="$(muse_installed_version)"
+  [ -n "$version" ] || return 1
+  [ -x "$dir/muse-bin-$version" ]
+}
+
 detect_provider_command() {
   local platform="$1"
   local provider="$2"
   local primary_command
   local candidate
 
+  if [ "$provider" = 'muse' ]; then
+    if muse_install_complete; then
+      prepend_path_if_missing "$(muse_install_dir)"
+      printf '%s\n' "$(muse_install_dir)/muse"
+      return 0
+    fi
+    # A muse elsewhere on PATH is someone's own install; report it rather than
+    # claiming the tool is missing, but never treat a half-written install
+    # directory as one.
+    if [ -x "$(muse_install_dir)/muse" ]; then
+      return 1
+    fi
+    command -v muse 2>/dev/null && return 0
+    return 1
+  fi
+
   primary_command="$(provider_primary_command "$provider")"
   if command -v "$primary_command" >/dev/null 2>&1; then
     command -v "$primary_command"
@@ -276,9 +325,36 @@ EOF
 
 provider_version_line() {
   local command_path="$1"
+  local provider="${2:-}"
+
+  # muse is read, never run: see muse_installed_version.
+  if [ "$provider" = 'muse' ]; then
+    muse_installed_version
+    return 0
+  fi
+
   "$command_path" --version 2>&1 | head -1 || true
 }
 
+# `curl ... | bash` returns 0 when the download itself fails, because bash reads
+# empty input and succeeds. Staging the script first is what makes a failed
+# install report as a failure.
+run_downloaded_shell_installer() {
+  local url="$1"
+  local installer_path status=0
+
+  installer_path="$(mktemp)"
+  if ! curl -fsSL --connect-timeout 10 --max-time 60 "$url" -o "$installer_path"; then
+    rm -f "$installer_path"
+    printf 'Failed to download the installer from %s\n' "$url" >&2
+    return 1
+  fi
+
+  bash "$installer_path" < /dev/null || status=$?
+  rm -f "$installer_path"
+  return "$status"
+}
+
 # Devin's official install.sh ends by launching the interactive `devin setup`
 # wizard. Packaged setup runs non-interactively with no console a prompt can
 # reach, so an unstripped installer would stall the step rather than fail.
@@ -336,24 +412,8 @@ run_remote_pipe_installer() {
   url="$(provider_install_url "$provider")"
 
   case "$provider" in
-    antigravity|grok)
-      curl -fsSL "$url" | bash
-      ;;
-    goose)
-      curl -fsSL "$url" | env CONFIGURE=false bash
-      ;;
-    aider)
-      curl -LsSf "$url" | sh
-      ;;
-    cursor)
-      curl "$url" -fsSL | bash
-      ;;
-    claude|junie)
-      curl -fsSL "$url" | bash
-      ;;
-    *)
-      return 1
-      ;;
+    goose) CONFIGURE=false run_downloaded_shell_installer "$url" ;;
+    *) run_downloaded_shell_installer "$url" ;;
   esac
 }
 
@@ -380,20 +440,14 @@ run_kiro_installer() {
   local installer_path
 
   installer_path="$(mktemp)"
-  curl -fsSL "$(provider_install_url kiro)" -o "$installer_path"
+  curl -fsSL --connect-timeout 10 --max-time 60 "$(provider_install_url kiro)" -o "$installer_path" || { rm -f "$installer_path"; return 1; }
   chmod +x "$installer_path"
 
-  if [ "$mode" = 'reinstall' ]; then
-    rm -f "$HOME/.local/bin/kiro-cli" "$HOME/.local/bin/kiro-cli-chat" "$HOME/.local/bin/kiro-cli-term"
-    if [ "$platform" = 'macos' ]; then
-      rm -rf '/Applications/Kiro CLI.app'
-      rm -f "$HOME/.local/bin/bash (kiro-cli-term)" "$HOME/.local/bin/fish (kiro-cli-term)" \
-        "$HOME/.local/bin/nu (kiro-cli-term)" "$HOME/.local/bin/zsh (kiro-cli-term)"
-    fi
-  fi
 
-  bash "$installer_path" --force < /dev/null
+  local install_status=0
+  bash "$installer_path" --force < /dev/null || install_status=$?
   rm -f "$installer_path"
+  [ "$install_status" -eq 0 ] || return "$install_status"
 
   if [ "$platform" = 'macos' ]; then
     ensure_kiro_cli_symlink_macos
@@ -408,15 +462,17 @@ run_provider_install_action() {
 
   case "$provider" in
     antigravity)
-      if [ "$action" = 'upgrade' ]; then
-        rm -f "$HOME/.local/bin/agy" || true
-        run_remote_pipe_installer "$provider"
-      elif [ "$action" = 'force' ]; then
-        rm -f "$HOME/.local/bin/agy" || true
-        run_remote_pipe_installer "$provider"
-      else
-        run_remote_pipe_installer "$provider"
+      local backup='' result=0 destination="$HOME/.local/bin/agy"
+      if { [ "$action" = upgrade ] || [ "$action" = force ]; } && [ -f "$destination" ] && [ ! -L "$destination" ]; then
+        backup="$(mktemp)" || return 1
+        cp -p "$destination" "$backup" || { rm -f "$backup"; return 1; }
+        rm -f "$destination" || { rm -f "$backup"; return 1; }
       fi
+      run_remote_pipe_installer "$provider" || result=$?
+      [ -x "$destination" ] || result=1
+      if [ "$result" -ne 0 ] && [ -n "$backup" ]; then cp -p "$backup" "$destination" || true; fi
+      [ -z "$backup" ] || rm -f "$backup"
+      return "$result"
       ;;
     grok)
       run_remote_pipe_installer "$provider"
@@ -424,12 +480,14 @@ run_provider_install_action() {
     devin)
       run_devin_installer
       ;;
-    aider)
+    muse)
+      # The official installer always refreshes the launcher and asks it to pull
+      # the newest build, so install, upgrade, and force are the same call.
       run_remote_pipe_installer "$provider"
       ;;
     claude)
       if [ "$action" = 'upgrade' ] && current_command="$(detect_provider_command "$platform" "$provider")"; then
-        "$current_command" update || true
+        "$current_command" update
       else
         run_remote_pipe_installer "$provider"
       fi
@@ -559,28 +617,22 @@ UPNP_EOF
     esac
   fi
 
-  # ~/.local/bin/aider is a uv tool shim, not the tool. Removing only the shim
-  # leaves aider-chat installed in the uv tool environment and the shim
-  # regenerable by any later `uv tool` command, so the tool is uninstalled
-  # through uv first and path removal only mops up what uv left behind.
-  #
-  # The uv binary itself is deliberately left in place: Aider's installer drops
-  # its own uv into ~/.local/bin, users commonly have another, and the helper
-  # cannot tell them apart. Removing a uv the user installed separately is a
-  # destructive false positive, so this warns instead (SPEC-112 PD4).
-  if [ "$provider" = 'aider' ]; then
-    if command -v uv >/dev/null 2>&1; then
-      if [ "$dry_run" = 'true' ]; then
-        __CATS_UNINSTALL_PLANNED+=("uv_tool_uninstall:aider-chat")
-      elif uv tool uninstall aider-chat >/dev/null 2>&1; then
-        __CATS_UNINSTALL_APPLIED+=("uv_tool_uninstalled:aider-chat")
-      else
-        __CATS_UNINSTALL_WARNINGS+=("uv_tool_uninstall_failed:aider-chat")
-      fi
-    else
-      __CATS_UNINSTALL_WARNINGS+=("uv_missing_aider_chat_may_remain")
-    fi
-    __CATS_UNINSTALL_WARNINGS+=("bundled_uv_left_in_place_provenance_unknown")
+  # The muse launcher is not the tool either: every muse-bin-<version> build it
+  # has downloaded, plus its .muse-* state files, sit in the same directory and
+  # survive removing the launcher alone. They are named deterministically, so
+  # they can be removed without guessing at unrelated files in ~/.local/bin.
+  if [ "$provider" = 'muse' ]; then
+    local muse_dir muse_leftover
+    muse_dir="$(muse_install_dir)"
+    for muse_leftover in "$muse_dir"/muse-bin-* "$muse_dir"/.muse-*; do
+      case "$muse_leftover" in
+        "$HOME"/*)
+          if [ -e "$muse_leftover" ] || [ -L "$muse_leftover" ]; then
+            planned_paths+=("$muse_leftover")
+          fi
+          ;;
+      esac
+    done
   fi
 
   for path in "${planned_paths[@]}"; do
@@ -796,7 +848,7 @@ run_native_provider_installer() {
 
   if command_path="$(detect_provider_command "$platform" "$provider")"; then
     initial_installed='true'
-    detected_version="$(provider_version_line "$command_path")"
+    detected_version="$(provider_version_line "$command_path" "$provider")"
     if [ "$check_only" = 'true' ]; then
       if [ "$emit_json" = 'true' ]; then
         printf '{'
@@ -913,76 +965,72 @@ run_native_provider_installer() {
     return 0
   fi
 
-  printf 'Installing %s...\n' "$display_name"
-  if [ "$force" = 'true' ]; then
-    run_provider_install_action "$platform" "$provider" 'force'
-  elif [ "$upgrade" = 'true' ]; then
-    run_provider_install_action "$platform" "$provider" 'upgrade'
-  else
-    run_provider_install_action "$platform" "$provider" 'install'
+  local before_version="$detected_version" latest='' version_state=unknown
+  local install_status=0 attempted=true final_installed=false observed_change=unchanged
+  if [ "$upgrade" = true ] && [ "$force" = false ] && [ "$initial_installed" = true ]; then
+    latest="$(cats_native_latest_version "$provider")"
+    version_state="$(cats_native_version_state "$provider" "$detected_version" "$latest")"
+    if [ "$version_state" = current ]; then
+      attempted=false
+      planned_actions=()
+    elif [ -z "$latest" ] && [ "$provider" != claude ] && [ "$provider" != muse ]; then
+      warnings+=('Could not compare the published version; the official installer will verify the update.')
+    fi
   fi
-  applied_changes=("${planned_actions[@]}")
-
-  ensure_provider_bin_path_export "$shell_rc" "$provider"
-  ensure_provider_alias "$shell_rc" "$provider"
-
-  while [ $attempt -le 3 ]; do
+  if [ "$attempted" = true ]; then
+    printf 'Installing %s...\n' "$display_name" >&2
+    if [ "$force" = true ]; then
+      run_provider_install_action "$platform" "$provider" force || install_status=$?
+    elif [ "$upgrade" = true ]; then
+      run_provider_install_action "$platform" "$provider" upgrade || install_status=$?
+    else
+      run_provider_install_action "$platform" "$provider" install || install_status=$?
+    fi
+  fi
+  hash -r
+  if [ "$install_status" -eq 0 ]; then
+    ensure_provider_bin_path_export "$shell_rc" "$provider"
+    ensure_provider_alias "$shell_rc" "$provider"
+  fi
+  for attempt in 1 2 3; do
     if command_path="$(detect_provider_command "$platform" "$provider")"; then
-      detected_version="$(provider_version_line "$command_path")"
-      if [ "$emit_json" = 'true' ]; then
-        warnings=("Reload your shell if ${display_name} is not visible yet: source ${shell_rc}")
-        printf '{'
-        printf '"helper":"%s-%s-native-installer",' "$platform" "$provider"
-        printf '"mode":"%s",' "$execution_mode"
-        printf '"status":"ready",'
-        printf '"installed":true,'
-        printf '"commandPath":"%s",' "$(json_escape "$command_path")"
-        printf '"detectedVersion":"%s",' "$(json_escape "$detected_version")"
-        printf '"plannedActions":'
-        json_string_array "${planned_actions[@]}"
-        printf ','
-        printf '"appliedChanges":'
-        json_string_array "${applied_changes[@]}"
-        printf ','
-        printf '"warnings":'
-        json_string_array "${warnings[@]}"
-        printf ','
-        printf '"manualSteps":'
-        json_string_array "$(provider_manual_steps "$provider")"
-        printf ','
-        printf '"interruptions":[]'
-        printf '}\n'
-      else
-        printf '%s ready: %s\n' "$display_name" "$detected_version"
-        printf 'Reload your shell if %s is not visible yet: source %s\n' "$display_name" "$shell_rc"
-      fi
-      return 0
+      final_installed=true
+      detected_version="$(provider_version_line "$command_path" "$provider")"
+      break
     fi
-
+    [ "$install_status" -eq 0 ] && [ "$attempted" = true ] || break
     sleep 2
-    attempt=$((attempt + 1))
   done
-
-  if [ "$emit_json" = 'true' ]; then
-    printf '{'
-    printf '"helper":"%s-%s-native-installer",' "$platform" "$provider"
-    printf '"mode":"%s",' "$execution_mode"
-    printf '"status":"failed",'
-    printf '"installed":false,'
-    printf '"commandPath":null,'
-    printf '"detectedVersion":null,'
-    printf '"plannedActions":'
-    json_string_array "${planned_actions[@]}"
-    printf ','
-    printf '"appliedChanges":'
-    json_string_array "${applied_changes[@]}"
-    printf ','
-    printf '"warnings":[],'
-    printf '"manualSteps":[],'
-    printf '"interruptions":[]'
-    printf '}\n'
-    return 1
+  local final_status=ready
+  if [ "$install_status" -ne 0 ] || [ "$final_installed" = false ]; then
+    final_status=failed
+    observed_change=failed
+    warnings+=("Installer or verification failed (exit $install_status); any previous installation is shown separately.")
+  elif [ "$attempted" = false ]; then observed_change=unchanged
+  elif [ "$initial_installed" = false ]; then observed_change=installed
+  elif [ -n "$before_version" ] && [ -n "$detected_version" ] && [ "$before_version" != "$detected_version" ]; then
+    case "$(cats_version_compare "$(cats_native_version_token "$provider" "$detected_version")" "$(cats_native_version_token "$provider" "$before_version")")" in
+      1) observed_change=upgraded ;; -1) observed_change=downgraded ;; *) observed_change=version_changed ;;
+    esac
+  else observed_change=unchanged; fi
+  if [ "$final_status" = ready ] && { [ "$upgrade" = true ] || [ "$force" = true ]; }; then
+    cats_cleanup_native_versions "$provider" "$detected_version" || true
   fi
-  printf 'Failed to verify %s after install.\n' "$display_name" >&2
-  return 1
+  case "$observed_change" in
+    installed|upgraded|downgraded|version_changed) applied_changes=("${observed_change}_${provider}_installation") ;;
+  esac
+  if [ "$emit_json" = true ]; then
+    printf '{"helper":"%s-%s-native-installer","mode":"%s","status":"%s",' "$platform" "$provider" "$execution_mode" "$final_status"
+    printf '"installed":%s,"commandPath":"%s","detectedVersion":"%s",' "$final_installed" "$(json_escape "$command_path")" "$(json_escape "$detected_version")"
+    printf '"previousVersion":"%s","observedChange":"%s",' "$(json_escape "$before_version")" "$observed_change"
+    printf '"summary":"%s: %s -> %s",' "$observed_change" "$(json_escape "$before_version")" "$(json_escape "$detected_version")"
+    printf '"plannedActions":'; json_string_array "${planned_actions[@]}"
+    printf ',"appliedChanges":'; json_string_array "${applied_changes[@]}"
+    printf ',"warnings":'; json_string_array "${warnings[@]}"
+    printf ',"manualSteps":'; json_string_array "$(provider_manual_steps "$provider")"
+    printf ',"interruptions":[]}\n'
+  else
+    printf '%s %s: %s -> %s\n' "$display_name" "$observed_change" "$before_version" "$detected_version"
+  fi
+  [ "$final_status" = ready ]
 }