--- name: gsd-whats-new description: See whats new in GSD since your installed version allowed-tools: Read, Bash --- Display changes between installed version and latest available version. Shows version comparison, changelog entries for missed versions, and update instructions. <\/objective> Read installed version from manifest file: ```bash cat {{PLATFORM_ROOT}}\/get-shit-done\/.gsd-install-manifest.json 2>\/dev\/null | grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4 ``` **If manifest file missing:** ``` ## GSD What's New **Installed version:** Unknown Your installation doesn't include version tracking. **To fix:** `npx get-shit-done-multi --{{PLATFORM_NAME}}` This will reinstall with version tracking enabled. ``` STOP here if no manifest file. <\/step> Fetch latest CHANGELOG.md from GitHub: Use WebFetch tool with: - URL: `https:\/\/raw.githubusercontent.com\/shoootyou\/get-shit-done-multi\/main\/CHANGELOG.md` - Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format." **If fetch fails:** Fall back to local changelog: ```bash cat {{PLATFORM_ROOT}}\/get-shit-done\/CHANGELOG.md 2>\/dev\/null ``` Note to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog." <\/step> From the remote (or local) changelog: 1. **Extract latest version** - First `## [X.Y.Z]` line after `## [Unreleased]` 2. **Compare with installed** - From VERSION file 3. **Extract entries between** - All version sections from latest down to (but not including) installed **Version comparison:** - If installed == latest: "You're on the latest version" - If installed < latest: Show changes since installed version - If installed > latest: "You're ahead of latest release (development version?)" <\/step> Format output clearly: **If up to date:** ``` ## GSD What's New **Installed:** 1.4.26 **Latest:** 1.4.26 You're on the latest version. [View full changelog](https:\/\/github.com\/shoootyou\/get-shit-done-multi\/blob\/main\/CHANGELOG.md) ``` **If updates available:** ``` ## GSD What's New **Installed:** 1.4.23 **Latest:** 1.4.26 --- ### Changes since your version: ## [1.4.26] - 2026-01-20 ### Added - Feature X - Feature Y ### Changed - **BREAKING:** Changed Z behavior ## [1.4.25] - 2026-01-18 ### Fixed - Bug in feature A --- [View full changelog](https:\/\/github.com\/shoootyou\/get-shit-done-multi\/blob\/main\/CHANGELOG.md) **To update:** `npx get-shit-done-multi --global` ``` **Breaking changes:** Surface prominently with **BREAKING:** prefix in the output. <\/step> <\/process> - [ ] Installed version read from .gsd-install-manifest.json - [ ] Remote changelog fetched (or graceful fallback to local) - [ ] Version comparison displayed clearly - [ ] Changes since installed version shown (if any) - [ ] Update instructions provided when behind <\/success_criteria>