fix: print shell reload hint after fresh install (#317)

A curl|bash install runs in a child process and cannot mutate the
caller's live PATH, so the new playground/pg command isn't found until
the shell reloads. Detect a fresh install and print the exact source
command for the user's shell (zsh/bash/fish) so they can use it now.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: shawntabrizi

.changeset/install-path-reload-hint.md

@@ -0,0 +1,5 @@
+---
+"playground-cli": patch
+---
+
+install.sh now prints a shell-specific reload hint (`source ~/.zshrc` / `~/.bashrc` / fish config, or open a new terminal) on a fresh install, so users aren't left with a `playground`/`pg` command that isn't found until they manually reload their shell.

install.sh

@@ -11,6 +11,12 @@ ALIAS="pg"
 # saved locally under $CMD, so the old `dot` command name is gone.
 ASSET_PREFIX="dot"
 
+# Record whether our bin dir is ALREADY on the caller's PATH (re-install /
+# upgrade) before we touch anything. On a fresh install it isn't, so the new
+# command won't resolve in the caller's shell until that shell reloads its
+# config — we print an exact reload hint at the end for that case only.
+case ":$PATH:" in *":$INSTALL_DIR/bin:"*) ALREADY_ON_PATH=1 ;; *) ALREADY_ON_PATH=0 ;; esac
+
 # 1) Detect platform. Git Bash / MSYS / Cygwin report MINGW*/MSYS*/CYGWIN* —
 # point Windows users at WSL instead of a bare "Unsupported OS".
 OS=$(uname -s); case "$OS" in Linux) OS=linux;; Darwin) OS=darwin;; MINGW*|MSYS*|CYGWIN*) echo "Windows is not supported natively. Install WSL (https://learn.microsoft.com/windows/wsl/install) and re-run this command inside it."; exit 1;; *) echo "Unsupported OS: $OS"; exit 1;; esac
@@ -138,3 +144,16 @@ echo -e "${Y}│${R}                                        ${Y}│${R}"
 echo -e "${Y}│${R}   ${B}$CMD login${R}                     ${Y}│${R}"
 echo -e "${Y}╰────────────────────────────────────────╯${R}"
 echo -e "${D}  Tip: ${ALIAS} is a short alias for ${CMD}.${R}"
+
+# This script runs in a child process, so it CANNOT add $CMD to the caller's
+# live PATH — sourcing an rc file here would only touch this dying process, not
+# the parent shell. On a fresh install the command therefore won't resolve until
+# the caller's shell reloads, so print the exact reload command for their shell.
+if [ "$ALREADY_ON_PATH" = "0" ]; then
+  case "$(basename "${SHELL:-bash}")" in
+    zsh)  RC="$HOME/.zshrc" ;;
+    fish) RC="$HOME/.config/fish/config.fish" ;;
+    *)    RC="$HOME/.bashrc" ;;
+  esac
+  echo -e "${D}  First run \033[1msource ${RC/#$HOME/\$HOME}${R}${D} (or open a new terminal) to use ${CMD}.${R}"
+fi