feat(cli): replace tale update with tale upgrade for self-upgrading CLI

[larryro]

Summary

• Replaces tale update with tale upgrade, which now downloads the latest CLI binary from GitHub Releases and then syncs project files — combining two manual steps into one command
• Extracts compareVersions into a shared utility and reuses it in both the upgrade action and the version registry
• Adds safety guards: binary verification, backup-and-restore on failure, sudo retry, dry-run support, and a dev-mode guard
• Keeps update as a hidden alias for backward compatibility

Test plan

• Run tale upgrade --dry-run on Linux/macOS and verify it prints what would happen without modifying anything
• Run tale upgrade against a real release to confirm download, verification, replacement, and project file sync
• Run tale update and confirm the alias still works
• Verify tale upgrade errors gracefully when run via bun run (dev mode guard)
• Confirm docs reflect the new command name

Summary by CodeRabbit

Release Notes

• New Features

  • CLI now supports self-upgrading with automatic binary verification and rollback protection.

• Changes

  • Renamed the update command to upgrade.
  • Updated all documentation to reflect the new command name.

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR renames the CLI command from tale update to tale upgrade across documentation and implementation. The changes include updating all documentation references (README, quickstart, market-analysis, ai-assisted-development) to reflect the new command name and purpose. The CLI command wiring is refactored: the createUpdateCommand() export is removed, replaced by a new createUpgradeCommand() that registers itself with an update alias for backwards compatibility. The update action gains a skipHeader option to control header emission. A new comprehensive upgrade action implements self-upgrade logic including platform/arch-specific binary handling, GitHub release querying, version comparison, binary verification, file replacement with rollback, and project sync. Version comparison logic is extracted into a dedicated compareVersions utility function, and get-available-versions.ts is refactored to use it.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Possibly related PRs

• feat(cli): add branding support, AI rules generation, and terminal TUI rewrite #925: Modifies CLI's update action and command structure directly overlapping with this PR's refactoring of update flow and CLI wiring changes.
• feat(cli): add init, start, and update commands with embedded references #912: Adds the original CLI update command implementation that is now being renamed and restructured in this PR.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 6.25% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately and concisely captures the main change: replacing the 'tale update' command with 'tale upgrade' for self-upgrading CLI functionality.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/cli-upgrade-command

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}