@kuandotdev/indicator 0.1.1 → 0.1.3

package/project/tools/interactive_install.sh

@@ -0,0 +1,917 @@
+#!/usr/bin/env bash
+# interactive_install.sh — post-core-install wizard for new users.
+# It optionally writes .env values, runs TradingView browser login, waits for
+# session-check, then imports skills/context/MCP config for selected agents.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+CONDA_ENV="${CONDA_ENV:-tv-indicator}"
+DEFAULT_PLATFORM="${TV_INDICATOR_AGENT_PLATFORM:-${PLATFORM:-auto}}"
+INPUT_TIMEOUT_SECONDS="${TV_INSTALL_INPUT_TIMEOUT:-60}"
+MAX_NO_INPUT_ATTEMPTS="${TV_INSTALL_MAX_NO_INPUT_ATTEMPTS:-3}"
+
+cd "$PROJECT_ROOT"
+
+log() { printf '%s\n' "$*"; }
+warn() { printf 'WARN: %s\n' "$*" >&2; }
+
+# Interactive only requires stdin to be a TTY. Stdout may be a pipe (e.g. when
+# select_platforms is called via command substitution: $(select_platforms));
+# the menu draws to stderr which still reaches the terminal in that case.
+is_tty() { [[ -t 0 ]]; }
+
+# Keep timeout knobs sane if users pass malformed env values.
+case "$INPUT_TIMEOUT_SECONDS" in ''|*[!0-9]*) INPUT_TIMEOUT_SECONDS=60 ;; esac
+case "$MAX_NO_INPUT_ATTEMPTS" in ''|*[!0-9]*) MAX_NO_INPUT_ATTEMPTS=3 ;; esac
+(( INPUT_TIMEOUT_SECONDS < 1 )) && INPUT_TIMEOUT_SECONDS=60
+(( MAX_NO_INPUT_ATTEMPTS < 1 )) && MAX_NO_INPUT_ATTEMPTS=3
+
+abort_install_no_input() {
+  local context="${1:-installer prompt}"
+  printf '\n' > /dev/tty 2>/dev/null || true
+  warn "No input received for $context after $MAX_NO_INPUT_ATTEMPTS attempts. Aborting install."
+
+  if [[ "${TV_INSTALL_CLEANUP_ON_NO_INPUT:-1}" == "1" ]]; then
+    warn "Cleaning up data installed by this installer (managed agent config, browser sessions, conda env, .env)."
+    if command -v make >/dev/null 2>&1; then
+      MAKEFLAGS= make --no-print-directory uninstall-all KEEP_ENV=0 || \
+        warn "Automatic cleanup failed. Run 'make uninstall-all' manually."
+    else
+      warn "make not found; run './tools/uninstall_agent_tools.sh --platform all' and remove the conda env manually."
+    fi
+  else
+    warn "Cleanup skipped because TV_INSTALL_CLEANUP_ON_NO_INPUT=0."
+  fi
+
+  exit 130
+}
+
+warn_no_input_retry() {
+  local context="$1"
+  local attempt="$2"
+  warn "No input detected for $context ($attempt/$MAX_NO_INPUT_ATTEMPTS). Waiting again..."
+}
+
+ask_yes_no() {
+  local prompt="$1"
+  local default="${2:-n}"
+  local suffix answer oldstty junk drain_i attempts timed_out
+  if [[ "$default" == "y" ]]; then suffix="[Y/n]"; else suffix="[y/N]"; fi
+  attempts=0
+
+  while true; do
+    answer=""
+    timed_out=0
+
+    # Single-key prompt in interactive terminals: y/Y/n/N proceeds immediately;
+    # Enter still accepts the default. This avoids requiring an extra Enter after
+    # typing `n` or `N` during install.
+    if is_tty && [ -r /dev/tty ] && [ -w /dev/tty ] \
+       && oldstty="$(stty -g < /dev/tty 2>/dev/null)" \
+       && stty -echo -icanon time 0 min 1 < /dev/tty 2>/dev/null; then
+      printf '%s %s ' "$prompt" "$suffix" > /dev/tty
+      if ! IFS= read -r -s -n 1 -t "$INPUT_TIMEOUT_SECONDS" answer < /dev/tty; then
+        timed_out=1
+        answer=""
+      fi
+      if [[ "$answer" == $'\004' ]]; then
+        timed_out=1
+        answer=""
+      fi
+
+      # Drain an immediately buffered Enter (e.g. if the user typed n+Enter out
+      # of habit) so the next prompt does not consume the leftover newline.
+      if (( ! timed_out )); then
+        stty time 0 min 0 < /dev/tty 2>/dev/null || true
+        for drain_i in 1 2; do
+          if IFS= read -r -s -n 1 -t 0 junk < /dev/tty 2>/dev/null; then
+            case "$junk" in $'\r'|$'\n') : ;; *) break ;; esac
+          else
+            break
+          fi
+        done
+      fi
+
+      stty "$oldstty" < /dev/tty 2>/dev/null || true
+      case "$answer" in
+        $'\r'|$'\n'|"") printf '\n' > /dev/tty ;;
+        *) printf '%s\n' "$answer" > /dev/tty ;;
+      esac
+    else
+      if ! read -r -t "$INPUT_TIMEOUT_SECONDS" -p "$prompt $suffix " answer; then
+        timed_out=1
+        answer=""
+        printf '\n'
+      fi
+    fi
+
+    if (( timed_out )); then
+      ((attempts+=1))
+      if (( attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+        abort_install_no_input "$prompt"
+      fi
+      warn_no_input_retry "$prompt" "$attempts"
+      continue
+    fi
+
+    answer="${answer:-$default}"
+    answer="$(printf '%s' "$answer" | tr '[:upper:]' '[:lower:]')"
+    case "$answer" in
+      y|yes) return 0 ;;
+      *) return 1 ;;
+    esac
+  done
+}
+
+ensure_env_file() {
+  if [[ ! -f .env ]]; then
+    if [[ -f .env.example ]]; then
+      cp .env.example .env
+      log "Created .env from .env.example"
+    else
+      touch .env
+      log "Created empty .env"
+    fi
+  fi
+}
+
+upsert_env() {
+  local key="$1"
+  local value="$2"
+  ensure_env_file
+  python3 - "$key" "$value" <<'PY'
+import sys
+from pathlib import Path
+key, value = sys.argv[1], sys.argv[2]
+path = Path(".env")
+lines = path.read_text(encoding="utf-8").splitlines() if path.exists() else []
+out = []
+written = False
+for line in lines:
+    if line.startswith(key + "="):
+        out.append(f"{key}={value}")
+        written = True
+    else:
+        out.append(line)
+if not written:
+    if out and out[-1].strip():
+        out.append("")
+    out.append(f"{key}={value}")
+path.write_text("\n".join(out) + "\n", encoding="utf-8")
+PY
+}
+
+prompt_env_value() {
+  local key="$1"
+  local label="$2"
+  local secret="${3:-1}"
+  local value=""
+  local attempts=0
+  local timed_out=0
+
+  while true; do
+    value=""
+    timed_out=0
+    if [[ "$secret" == "1" ]]; then
+      if ! read -r -s -t "$INPUT_TIMEOUT_SECONDS" -p "$label ($key, Enter to skip): " value; then
+        timed_out=1
+      fi
+      printf '\n'
+    else
+      if ! read -r -t "$INPUT_TIMEOUT_SECONDS" -p "$label ($key, Enter to skip): " value; then
+        timed_out=1
+        printf '\n'
+      fi
+    fi
+
+    if (( timed_out )); then
+      ((attempts+=1))
+      if (( attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+        abort_install_no_input "$key input"
+      fi
+      warn_no_input_retry "$key input" "$attempts"
+      continue
+    fi
+    break
+  done
+
+  if [[ -n "$value" ]]; then
+    upsert_env "$key" "$value"
+    log "Saved $key to .env"
+  fi
+}
+
+get_env_value() {
+  local key="$1"
+  [[ -f .env ]] || return 1
+  awk -F= -v key="$key" '$1 == key { print substr($0, length(key) + 2) }' .env | tail -n 1
+}
+
+normalize_language_code() {
+  local raw="$1"
+  raw="$(printf '%s' "$raw" | tr '[:upper:]' '[:lower:]' | tr '-' '_' | tr -d '[:space:]')"
+  raw="${raw%%.*}"
+  raw="${raw%%@*}"
+  case "$raw" in
+    ""|c|posix) printf '\n' ;;
+    en|en_*|eng|english) printf 'en\n' ;;
+    zhtw|zh_tw|zh_hk|zh_mo|zh_hant|zh_hant_*|traditional|traditionalchinese|tc)
+      printf 'zhtw\n' ;;
+    zhcn|zh_cn|zh_sg|zh_hans|zh_hans_*|simplified|simplifiedchinese|sc|cn)
+      printf 'zhcn\n' ;;
+    zh) printf 'zhtw\n' ;;
+    ja|ja_*|jp|jp_*|japanese) printf 'jp\n' ;;
+    ko|ko_*|kr|kr_*|korean) printf 'ko\n' ;;
+    *_*) printf '%s\n' "${raw%%_*}" | sed 's/[^a-z0-9_-]//g' ;;
+    *)
+      printf '%s\n' "$raw" | sed 's/[^a-z0-9_-]//g'
+      ;;
+  esac
+}
+
+language_label() {
+  case "$1" in
+    en) printf 'English\n' ;;
+    zhtw) printf 'Traditional Chinese\n' ;;
+    zhcn) printf 'Simplified Chinese\n' ;;
+    jp) printf 'Japanese\n' ;;
+    ko) printf 'Korean\n' ;;
+    *) printf 'custom\n' ;;
+  esac
+}
+
+detect_terminal_language() {
+  local locale_value
+  locale_value="${LC_ALL:-${LC_MESSAGES:-${LANG:-}}}"
+  normalize_language_code "$locale_value"
+}
+
+default_language_code() {
+  local selected=""
+  if [[ -n "${TV_AGENT_LANGUAGE:-}" ]]; then
+    normalize_language_code "$TV_AGENT_LANGUAGE"
+    return
+  fi
+
+  selected="$(detect_terminal_language)"
+  if [[ -n "$selected" ]]; then
+    printf '%s\n' "$selected"
+    return
+  fi
+
+  selected="$(get_env_value TV_AGENT_LANGUAGE || true)"
+  selected="$(normalize_language_code "$selected")"
+  printf '%s\n' "${selected:-en}"
+}
+
+ensure_language_default() {
+  local selected
+  selected="$(default_language_code)"
+  [[ -z "$selected" ]] && selected="en"
+  upsert_env "TV_AGENT_LANGUAGE" "$selected"
+  export TV_AGENT_LANGUAGE="$selected"
+}
+
+prompt_language() {
+  local default answer selected attempts timed_out
+  default="$(default_language_code)"
+  [[ -z "$default" ]] && default="en"
+
+  attempts=0
+  while true; do
+    answer=""
+    timed_out=0
+    if [ -r /dev/tty ] && [ -w /dev/tty ]; then
+      printf 'Preferred agent output language (en English, zhtw Traditional Chinese, zhcn Simplified Chinese, jp Japanese, ko Korean) [%s]: ' "$default" > /dev/tty
+      if ! IFS= read -r -t "$INPUT_TIMEOUT_SECONDS" answer < /dev/tty; then
+        timed_out=1
+        printf '\n' > /dev/tty
+      fi
+    else
+      if ! read -r -t "$INPUT_TIMEOUT_SECONDS" -p "Preferred agent output language (en/zhtw/zhcn/jp/ko) [$default]: " answer; then
+        timed_out=1
+        printf '\n'
+      fi
+    fi
+
+    if (( timed_out )); then
+      ((attempts+=1))
+      if (( attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+        abort_install_no_input "language selection"
+      fi
+      warn_no_input_retry "language selection" "$attempts"
+      continue
+    fi
+    break
+  done
+
+  selected="$(normalize_language_code "${answer:-$default}")"
+  [[ -z "$selected" ]] && selected="en"
+  upsert_env "TV_AGENT_LANGUAGE" "$selected"
+  export TV_AGENT_LANGUAGE="$selected"
+  log "  → Language: $selected ($(language_label "$selected"))"
+}
+
+_PLATFORM_KEYS=(pi claude-desktop claude-code codex gemini cursor)
+_PLATFORM_LABELS=(
+  "Pi"
+  "Claude Desktop"
+  "Claude Code"
+  "Codex / OpenCode / Aider"
+  "Gemini"
+  "Cursor"
+)
+
+# Arrow-key multi-select menu. Pure bash, no external deps. Works in bash 3.2+.
+# Controls: ↑/↓ or k/j to move, SPACE to toggle, a = all, n = none, ENTER to confirm, q = quit.
+# Menu drawing goes to stderr (>&2) so it survives $(...) command substitution
+# which only captures stdout. Stdin (`read` builtin) is the terminal.
+# Falls back to "all" if stdin is not a TTY.
+# Sets the global _MENU_RESULT to a space-separated list of selected keys, or "skip".
+arrow_multi_select() {
+  local header="$1"; shift
+  # IMPORTANT: bash 3.2 doesn't reliably treat `local -a a=() b=() c=()` as
+  # three array declarations on one line, so declare each on its own line.
+  local -a keys
+  local -a labels
+  local -a checked
+  keys=()
+  labels=()
+  checked=()
+
+  while (( $# > 0 )); do
+    keys+=("${1%%|*}")
+    labels+=("${1#*|}")
+    checked+=(0)
+    shift
+  done
+  local n=${#keys[@]}
+  local cursor=0
+
+  # Start with nothing checked. SPACE toggles one or more items; pressing
+  # ENTER always selects the highlighted item when nothing is checked.
+  local i
+  for ((i=0; i<n; i++)); do checked[$i]=0; done
+
+  # Non-TTY → signal fallback by leaving _MENU_RESULT empty.
+  if ! is_tty || [ ! -r /dev/tty ] || [ ! -w /dev/tty ]; then
+    _MENU_RESULT=""
+    return 1
+  fi
+
+  # Bind the menu directly to the controlling terminal. In `make` recipes and
+  # command substitutions, stdin/stderr can be captured or partially detached;
+  # /dev/tty keeps the arrow UI visible and makes reads reliable.
+  if ! exec 3</dev/tty 4>/dev/tty; then
+    _MENU_RESULT=""
+    return 1
+  fi
+
+  # Probe: can we actually save/restore the TTY state? Some terminal/shell
+  # combinations report -t 0 as true but then error on stty operations
+  # (e.g. read returning "Input/output error" on FD 0). Detect that here
+  # and bail out before drawing anything.
+  local _stty_saved
+  if ! _stty_saved="$(stty -g <&3 2>/dev/null)"; then
+    exec 3<&- 4>&- 2>/dev/null || true
+    _MENU_RESULT=""
+    return 1
+  fi
+  if ! stty -echo -icanon time 0 min 1 <&3 2>/dev/null; then
+    exec 3<&- 4>&- 2>/dev/null || true
+    _MENU_RESULT=""
+    return 1
+  fi
+
+  # Disable set -e for the menu's body so a single read failure doesn't kill
+  # the whole wizard — we want to fall back to the numeric prompt instead.
+  set +e
+
+  # Keep menu input/output bound to the controlling terminal so the UI paints
+  # immediately even when launched from `make`.
+  _arrow_menu_cleanup() {
+    # RETURN traps persist in bash until explicitly cleared. Clear them first
+    # so cleanup only runs for this menu, not for later function returns.
+    trap - RETURN
+    trap - INT TERM
+    if [[ -n "${_stty_saved:-}" ]]; then
+      stty "$_stty_saved" < /dev/tty 2>/dev/null || true
+    fi
+    printf '\033[?25h' > /dev/tty 2>/dev/null || true
+    # Close only our menu fds. Do not use `exec ... 2>/dev/null` here; with
+    # exec and no command, that would permanently redirect the script stderr.
+    exec 3<&- || true
+    exec 4>&- || true
+    set -e
+  }
+  trap '_arrow_menu_cleanup' RETURN
+  trap '_arrow_menu_cleanup; exit 130' INT TERM
+
+  printf '\033[?25l' >&4
+
+  # Do not try to drain pre-buffered keystrokes here. On macOS/bash 3.2 under
+  # `make`, `read -n1` can block even after `stty min 0`, which makes the
+  # installer appear to hang before the menu is drawn.
+  stty time 0 min 1 <&3 2>/dev/null
+
+  printf '\n%s\n' "$header" >&4
+  printf '  ↑/↓ or j/k to move  ·  SPACE to toggle  ·  a = all  ·  n = none  ·  q = skip  ·  ENTER = confirm/current\n\n' >&4
+
+  local marker prefix key rest first_draw idle_attempts
+  first_draw=1
+  idle_attempts=0
+  while true; do
+    if (( first_draw )); then
+      first_draw=0
+    else
+      # Redraw in-place. CSI save/restore cursor is not reliable in every
+      # terminal/tmux/make combination, so move back over the fixed-height
+      # list and clear from there before repainting.
+      printf '\033[%dA' "$n" >&4
+    fi
+    printf '\033[J' >&4
+    for ((i=0; i<n; i++)); do
+      marker="[ ]"
+      [[ "${checked[$i]}" == "1" ]] && marker="[x]"
+      prefix="    "
+      [[ $i -eq $cursor ]] && prefix="  ❯ "
+      printf '\r\033[2K%s%s %s\n' "$prefix" "$marker" "${labels[$i]}" >&4
+    done
+
+    key=""
+    rest=""
+    # If the user provides no input for the timeout window, retry up to the
+    # global limit, then abort and clean up installed artifacts. Other read
+    # failures still fall back to the numeric prompt.
+    if ! IFS= read -rsn1 -t "$INPUT_TIMEOUT_SECONDS" key <&3 2>/dev/null; then
+      ((idle_attempts+=1))
+      if (( idle_attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+        _arrow_menu_cleanup
+        abort_install_no_input "platform selection"
+      fi
+      printf '\nWARN: No input detected for platform selection (%d/%d). Waiting again...\n' \
+        "$idle_attempts" "$MAX_NO_INPUT_ATTEMPTS" >&4
+      first_draw=1
+      continue
+    fi
+    if [[ "$key" == $'\004' ]]; then
+      ((idle_attempts+=1))
+      if (( idle_attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+        _arrow_menu_cleanup
+        abort_install_no_input "platform selection"
+      fi
+      printf '\nWARN: No input detected for platform selection (%d/%d). Waiting again...\n' \
+        "$idle_attempts" "$MAX_NO_INPUT_ATTEMPTS" >&4
+      first_draw=1
+      continue
+    fi
+    idle_attempts=0
+    case "$key" in
+      $'\x1b')
+        stty time 1 min 0 <&3 2>/dev/null
+        IFS= read -rsn2 rest <&3 2>/dev/null || rest=""
+        stty time 0 min 1 <&3 2>/dev/null
+        case "$rest" in
+          "[A") (( cursor > 0 )) && ((cursor--)) ;;
+          "[B") (( cursor < n-1 )) && ((cursor++)) ;;
+        esac
+        ;;
+      k|K) (( cursor > 0 )) && ((cursor--)) ;;
+      j|J) (( cursor < n-1 )) && ((cursor++)) ;;
+      ' ') checked[$cursor]=$(( 1 - checked[$cursor] )) ;;
+      a|A) for ((i=0; i<n; i++)); do checked[$i]=1; done ;;
+      n|N) for ((i=0; i<n; i++)); do checked[$i]=0; done ;;
+      q|Q) _MENU_RESULT="skip"; printf '\n' >&4; return 0 ;;
+      ''|$'\n'|$'\r') break ;;
+    esac
+  done
+
+  local out=""
+  local any=0
+  for ((i=0; i<n; i++)); do
+    if [[ "${checked[$i]}" == "1" ]]; then
+      out+="${keys[$i]} "
+      any=1
+    fi
+  done
+  printf '\n' >&4
+  if (( ! any )); then
+    _MENU_RESULT="${keys[$cursor]}"
+  else
+    _MENU_RESULT="${out% }"
+  fi
+}
+
+select_platforms_numeric_fallback() {
+  # Plain prompt that reads/writes directly from the controlling terminal.
+  # This avoids bash `select` + command-substitution visibility issues under
+  # `make`, and works when the arrow-key UI is not supported.
+  local tty_in="/dev/tty"
+  local tty_out="/dev/tty"
+  if [ ! -r "$tty_in" ] || [ ! -w "$tty_out" ]; then
+    _PLATFORM_RESULT="all"
+    return
+  fi
+
+  local idle_attempts=0
+  while true; do
+    cat > "$tty_out" <<'MENU'
+
+Select agent platforms to configure:
+  1) All — Pi, Claude Desktop, Claude Code, Codex, Gemini, Cursor (recommended)
+  2) Claude Code only
+  3) Claude Desktop only
+  4) Pi only
+  5) Codex / OpenCode / Aider only
+  6) Gemini only
+  7) Cursor only
+  8) Custom — type a comma-separated list
+  9) Skip — don't configure any agents now
+
+MENU
+    printf 'Your choice (1-9, default 1): ' > "$tty_out"
+    local reply=""
+    if ! IFS= read -r -t "$INPUT_TIMEOUT_SECONDS" reply < "$tty_in"; then
+      ((idle_attempts+=1))
+      if (( idle_attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+        abort_install_no_input "platform selection"
+      fi
+      warn_no_input_retry "platform selection" "$idle_attempts"
+      continue
+    fi
+    idle_attempts=0
+    reply="${reply:-1}"
+
+    case "$reply" in
+      1) _PLATFORM_RESULT="all"; return ;;
+      2) _PLATFORM_RESULT="claude-code"; return ;;
+      3) _PLATFORM_RESULT="claude-desktop"; return ;;
+      4) _PLATFORM_RESULT="pi"; return ;;
+      5) _PLATFORM_RESULT="codex"; return ;;
+      6) _PLATFORM_RESULT="gemini"; return ;;
+      7) _PLATFORM_RESULT="cursor"; return ;;
+      8)
+        local custom=""
+        local custom_attempts=0
+        while true; do
+          printf '\nEnter platforms separated by commas.\n' > "$tty_out"
+          printf 'Available: pi, claude-desktop, claude-code, codex, gemini, cursor\n' > "$tty_out"
+          printf 'Platforms: ' > "$tty_out"
+          if IFS= read -r -t "$INPUT_TIMEOUT_SECONDS" custom < "$tty_in"; then
+            break
+          fi
+          ((custom_attempts+=1))
+          if (( custom_attempts >= MAX_NO_INPUT_ATTEMPTS )); then
+            abort_install_no_input "custom platform entry"
+          fi
+          warn_no_input_retry "custom platform entry" "$custom_attempts"
+        done
+        # Normalize: trim whitespace, allow space-separated input too.
+        custom="${custom//,/ }"
+        local token token_lc out=""
+        for token in $custom; do
+          token_lc="$(printf '%s' "$token" | tr '[:upper:]' '[:lower:]')"
+          case "$token_lc" in
+            pi|claude-desktop|claude-code|codex|gemini|cursor|all|skip)
+              out+="${out:+,}$token_lc" ;;
+            claude|code) out+="${out:+,}claude-code" ;;
+            desktop) out+="${out:+,}claude-desktop" ;;
+            opencode|aider) out+="${out:+,}codex" ;;
+            *) warn "Ignoring unknown platform: $token" ;;
+          esac
+        done
+        _PLATFORM_RESULT="${out:-all}"
+        return ;;
+      9) _PLATFORM_RESULT="skip"; return ;;
+      *) printf 'Invalid choice: %s — pick a number 1 through 9.\n' "$reply" > "$tty_out" ;;
+    esac
+  done
+}
+
+# Top-level platform selector.
+#
+# Default: arrow-key multi-select menu (↑/↓ or j/k, SPACE to toggle, ENTER).
+# Fallback: TV_INSTALL_MENU=plain make install → numeric prompt
+# (always works; use if the arrow menu misbehaves in your terminal).
+# Sets _PLATFORM_RESULT instead of echoing, so the menu is not hidden inside
+# command substitution.
+select_platforms() {
+  _PLATFORM_RESULT=""
+  if [[ "$DEFAULT_PLATFORM" != "auto" && -n "$DEFAULT_PLATFORM" ]]; then
+    _PLATFORM_RESULT="$DEFAULT_PLATFORM"
+    return
+  fi
+
+  # No controlling terminal at all (CI, piped install) → default to all.
+  if [ ! -r /dev/tty ] || [ ! -w /dev/tty ]; then
+    _PLATFORM_RESULT="all"
+    return
+  fi
+
+  if [[ "${TV_INSTALL_MENU:-arrow}" == "plain" ]]; then
+    select_platforms_numeric_fallback
+    return
+  fi
+
+  local _MENU_RESULT=""
+  # `|| true` so `set -e` doesn't kill the wizard if the arrow menu bails out
+  # (e.g. terminal doesn't support raw mode). The fallback handles it below.
+  arrow_multi_select \
+    "Select agent platforms to configure:" \
+    "pi|Pi" \
+    "claude-desktop|Claude Desktop" \
+    "claude-code|Claude Code" \
+    "codex|Codex / OpenCode / Aider" \
+    "gemini|Gemini" \
+    "cursor|Cursor" || true
+
+  if [[ -z "$_MENU_RESULT" ]]; then
+    warn "Arrow-key menu unavailable in this terminal — switching to numeric prompt."
+    warn "(Tip: TV_INSTALL_MENU=plain make install skips the arrow menu directly.)"
+    select_platforms_numeric_fallback
+    return
+  fi
+
+  if [[ "$_MENU_RESULT" == "skip" ]]; then
+    _PLATFORM_RESULT="skip"
+    return
+  fi
+  _PLATFORM_RESULT="${_MENU_RESULT// /,}"
+}
+
+tv_session_ok() {
+  command -v conda >/dev/null 2>&1 || return 1
+  local out
+  out="$(conda run -n "$CONDA_ENV" --no-capture-output python -m tv_indicator.cli.main browser session-check 2>/dev/null || true)"
+  grep -Eiq 'signed_in:[[:space:]]*true|signed_in[[:space:]]+true' <<<"$out"
+}
+
+print_tv_login_status() {
+  if ! command -v conda >/dev/null 2>&1; then
+    warn "conda not found; cannot check TradingView login status."
+    return 0
+  fi
+
+  if ! conda run -n "$CONDA_ENV" --live-stream --no-capture-output \
+      python -m tv_indicator.cli.main browser session-check; then
+    warn "TradingView login status check failed. Retry with 'make session-check'."
+  fi
+}
+
+ensure_playwright_chromium() {
+  # Returns 0 if Chromium is installed for Playwright, 1 otherwise.
+  conda run -n "$CONDA_ENV" --no-capture-output python -c \
+    "import sys; from pathlib import Path; from playwright._impl._driver import compute_driver_executable; \
+sys.exit(0 if any(Path(p).exists() for p in (Path.home()/'Library/Caches/ms-playwright', Path.home()/'.cache/ms-playwright')) else 1)" \
+    >/dev/null 2>&1
+}
+
+install_playwright_chromium_if_missing() {
+  if ensure_playwright_chromium; then
+    return 0
+  fi
+  warn "Playwright Chromium not found. Installing it now (one-time, ~150 MB download)..."
+  if conda run -n "$CONDA_ENV" --live-stream --no-capture-output python -m playwright install chromium; then
+    log "Chromium installed ✓"
+    return 0
+  else
+    warn "Could not install Chromium automatically. Run 'make install-playwright' and try login again."
+    return 1
+  fi
+}
+
+run_tv_login() {
+  if ! command -v conda >/dev/null 2>&1; then
+    warn "conda not found; skipping TradingView browser login."
+    return 0
+  fi
+
+  if tv_session_ok; then
+    log "  → TradingView session already signed in ✓; skipping browser login."
+    return 0
+  fi
+
+  if ! install_playwright_chromium_if_missing; then
+    return 0
+  fi
+
+  log ""
+  log "  Opening TradingView login in Playwright."
+  log "  → A Chromium window will open. Complete the login (or 2FA) in that window."
+  log "  → The window closes automatically once login is detected."
+  log "  → If the window doesn't appear, check behind other apps (macOS Mission Control)."
+  log ""
+
+  # TV_BROWSER_HEADLESS may be set to "true" in .env or from a parent shell —
+  # the login flow forces a visible window regardless.
+  if env -u TV_BROWSER_HEADLESS \
+       conda run -n "$CONDA_ENV" --live-stream --no-capture-output \
+       env TV_BROWSER_HEADLESS=false python -m tv_indicator.cli.main browser login; then
+    log "  → Login captured. Verifying session..."
+  else
+    warn "  → Login did not complete. You can run 'make login' later."
+    return 0
+  fi
+
+  conda run -n "$CONDA_ENV" --live-stream --no-capture-output python -m tv_indicator.cli.main browser session-check || \
+    warn "  → Session check failed. Retry with 'make login' && 'make session-check'."
+}
+
+run_agent_import() {
+  local platforms="$1"
+  [[ "$platforms" == "skip" ]] && { log "Skipping agent import."; return 0; }
+  if [[ -x tools/progress.sh ]]; then
+    tools/progress.sh \
+      --success "Agent tools imported for: $platforms ✓" \
+      --failure "Agent tool import failed ✗" \
+      "Importing agent tools for: $platforms" \
+      -- bash tools/import_agent_tools.sh --platform "$platforms"
+  else
+    log "Importing agent tools for: $platforms"
+    bash tools/import_agent_tools.sh --platform "$platforms"
+  fi
+}
+
+_add_unique_platform() {
+  local current="$1"
+  local item="$2"
+  case " $current " in
+    *" $item "*) printf '%s\n' "$current" ;;
+    *) printf '%s\n' "${current:+$current }$item" ;;
+  esac
+}
+
+_expand_platforms_for_examples() {
+  local raw="$1"
+  raw="${raw//,/ }"
+  local selected=""
+  local token mapped
+  for token in $raw; do
+    case "$token" in
+      all|auto)
+        for mapped in pi claude-desktop claude-code codex gemini cursor; do
+          selected="$(_add_unique_platform "$selected" "$mapped")"
+        done
+        ;;
+      pi|claude-desktop|claude-code|codex|gemini|cursor)
+        selected="$(_add_unique_platform "$selected" "$token")" ;;
+      claude) selected="$(_add_unique_platform "$selected" "claude-code")" ;;
+      desktop) selected="$(_add_unique_platform "$selected" "claude-desktop")" ;;
+      opencode|aider) selected="$(_add_unique_platform "$selected" "codex")" ;;
+      skip|"") ;;
+    esac
+  done
+  printf '%s\n' "$selected"
+}
+
+print_usage_examples() {
+  local platforms="$1"
+  log ""
+  log "Usage examples for selected platform(s):"
+
+  if [[ "$platforms" == "skip" ]]; then
+    log "  No agent platform was configured. Import later with:"
+    log "    make agent-import PLATFORM=pi        # or: all, claude-code, cursor, ..."
+    return
+  fi
+
+  local selected
+  selected="$(_expand_platforms_for_examples "$platforms")"
+  if [[ -z "$selected" ]]; then
+    log "  Run: make agent-import PLATFORM=pi        # or: all, claude-code, cursor, ..."
+    return
+  fi
+
+  local p
+  for p in $selected; do
+    case "$p" in
+      pi)
+        log "  Pi:"
+        log "    /reload                         # inside Pi, or restart Pi"
+        log "    Ask: analyze NASDAQ:AAPL"
+        ;;
+      claude-desktop)
+        log "  Claude Desktop:"
+        log "    Quit and reopen Claude Desktop"
+        log "    Ask: analyze NASDAQ:AAPL"
+        ;;
+      claude-code)
+        log "  Claude Code:"
+        log "    claude                          # run from this repo root"
+        log "    Ask: analyze NASDAQ:AAPL"
+        ;;
+      codex)
+        log "  Codex / OpenCode / Aider:"
+        log "    Restart the agent/client, then open this repo"
+        log "    Ask: analyze NASDAQ:AAPL"
+        ;;
+      gemini)
+        log "  Gemini CLI:"
+        log "    gemini                          # run from this repo root"
+        log "    Ask: analyze NASDAQ:AAPL"
+        ;;
+      cursor)
+        log "  Cursor:"
+        log "    Reload Window, then check Cursor MCP settings"
+        log "    Ask: analyze NASDAQ:AAPL"
+        ;;
+    esac
+  done
+
+  log "  CLI checks:"
+  log "    make status"
+  log "    make session-check"
+  log "    make model-status"
+  log "    make model-setup                      # verify model API env"
+  log "    make model-forecast SYMBOL=NASDAQ:TSLA MODEL_JSON=1"
+  log "    make ohlcv SYMBOL=NASDAQ:AAPL BARS=50"
+  log "  Analysis artifacts:"
+  log "    temp/{YYYYMMDD_HHMMSS}/{TARGET_ID}/analyzed_result.md"
+}
+
+noninteractive_setup() {
+  ensure_env_file
+  ensure_language_default
+  local platform="${TV_INDICATOR_AGENT_PLATFORM:-$DEFAULT_PLATFORM}"
+  # In non-interactive package/CI installs, avoid unexpectedly touching global
+  # Claude Desktop config. Users can override with TV_INDICATOR_AGENT_PLATFORM=all.
+  [[ "$platform" == "auto" ]] && platform="pi"
+  run_agent_import "$platform"
+}
+
+main() {
+  if [[ "${TV_INDICATOR_SETUP:-1}" == "0" ]]; then
+    ensure_env_file
+    ensure_language_default
+    log "TV_INDICATOR_SETUP=0; skipping interactive agent setup."
+    return 0
+  fi
+
+  if ! is_tty; then
+    log "Non-interactive shell detected; running default agent import only."
+    noninteractive_setup
+    return 0
+  fi
+
+  log ""
+  log "=== Indicator — interactive setup ==="
+  ensure_env_file
+
+  log ""
+  log "Step 1/4 — preferred agent output language:"
+  prompt_language
+
+  log ""
+  log "Step 2/4 — choose which agent platforms to configure:"
+  local platforms
+  select_platforms
+  platforms="$_PLATFORM_RESULT"
+  if [[ "$platforms" == "skip" ]]; then
+    log "  → Skipping agent import."
+  else
+    log "  → Selected: $platforms"
+  fi
+
+  log ""
+  log "Step 3/4 — optional TradingView cookies and AI API keys:"
+  if [[ "${TV_INSTALL_PROMPT_ENV:-0}" =~ ^(1|true|TRUE|yes|YES)$ ]]; then
+    if ask_yes_no "Store optional API/session values in .env now?" n; then
+      log "Press Enter to skip any value. Secret values are hidden while typing."
+      prompt_env_value "TV_SESSIONID" "TradingView sessionid cookie" 1
+      prompt_env_value "TV_SESSIONID_SIGN" "TradingView sessionid_sign cookie" 1
+      prompt_env_value "TV_USERNAME" "TradingView username/label" 0
+      prompt_env_value "ANTHROPIC_API_KEY" "Anthropic API key" 1
+      prompt_env_value "OPENAI_API_KEY" "OpenAI API key" 1
+      prompt_env_value "GEMINI_API_KEY" "Gemini API key" 1
+      prompt_env_value "GOOGLE_API_KEY" "Google API key" 1
+    else
+      log "Skipped .env API/session input."
+    fi
+  else
+    log "  → Skipped by default; no API/session answer is required during install."
+    log "  → Store values later with: python3 skills/api-credential-storage/scripts/upsert_env.py OPENAI_API_KEY --stdin"
+    log "  → To enable install-time prompts, rerun with: TV_INSTALL_PROMPT_ENV=1 make install"
+  fi
+
+  log ""
+  log "Step 4/4 — TradingView browser login:"
+  if tv_session_ok; then
+    log "  → Already signed in ✓; no browser login needed."
+  elif ask_yes_no "Run TradingView browser login now?" y; then
+    run_tv_login
+  else
+    log "  → Skipped browser login. You can run 'make login' later."
+  fi
+
+  log ""
+  log "Importing agent tools..."
+  run_agent_import "$platforms"
+
+  log ""
+  log "Setup complete. Restart/reload selected agents to use the generated tools and prompts."
+  print_usage_examples "$platforms"
+}
+
+main