Goal
Make the upgrade path from the pre-rebrand install (deepseek-tui / old npm package) to current codewhale releases work, or fail with clear, copy-pasteable migration instructions. Users on old installs currently hit hard errors with no guidance.
Current evidence
Scope
- Audit the self-update code path for what happens when the running binary is the legacy name and
codewhale is not installed: either perform the migration (install codewhale-cli / new npm package, then hand off) or print exact migration commands per install method (cargo, npm, Homebrew, release binary).
- Verify the npm rename path: deprecation notice on the old package pointing at the new one, and confirm
npm update/npm install -g of the old name surfaces the migration message.
- Add a short migration section to the README/docs covering cargo and npm upgrades from pre-rebrand versions.
- Test: simulate the legacy-binary update flow and assert the user gets either a successful migration or actionable instructions, never a raw spawn error.
Non-goals
Acceptance criteria
Related: #2917, #2924, #2643, #2011, #1969
Goal
Make the upgrade path from the pre-rebrand install (
deepseek-tui/ old npm package) to currentcodewhalereleases work, or fail with clear, copy-pasteable migration instructions. Users on old installs currently hit hard errors with no guidance.Current evidence
deepseek-tuiuser randeepseek updateand goterror: failed to spawn \codewhale`: codewhale not found on PATH or in sibling directory` — the old binary's self-update now assumes the new binary name exists.Scope
codewhaleis not installed: either perform the migration (installcodewhale-cli/ new npm package, then hand off) or print exact migration commands per install method (cargo, npm, Homebrew, release binary).npm update/npm install -gof the old name surfaces the migration message.Non-goals
~/.deepseek(already handled in P0 v0.8.44: migrate app state to ~/.codewhale with ~/.deepseek compatibility bridge #2011 and 问题:程序更名成code whale之后,原先的会话、技能都还在吗 #1969/TUI: fix large-paste .deepseek writes and long status readability #2914 follow-ups).Acceptance criteria
deepseek updateon a machine withoutcodewhaleno longer dies with a spawn error; it migrates or prints exact per-install-method instructions.Related: #2917, #2924, #2643, #2011, #1969