From d7680cd53710be0a073cefeb4c01bfaea7229633 Mon Sep 17 00:00:00 2001 From: Lex Christopherson Date: Wed, 14 Jan 2026 14:08:05 -0600 Subject: [PATCH] docs(12-03): complete whats-new command plan Tasks completed: 3/3 - Create whats-new.md command - Update install.js to write VERSION file - Update help.md to include whats-new command SUMMARY: .planning/phases/12-changelog-and-update-awareness/12-03-SUMMARY.md --- .planning/ROADMAP.md | 2 +- .planning/STATE.md | 8 +- .../12-03-SUMMARY.md | 87 +++++++++++++++++++ 3 files changed, 92 insertions(+), 5 deletions(-) create mode 100644 .planning/phases/12-changelog-and-update-awareness/12-03-SUMMARY.md diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index c683b550b..904a4fdda 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -202,7 +202,7 @@ This enables execute-phase to produce more Wave 1 plans (true independence) inst Plans: - [x] 12-01: CHANGELOG.md foundation - Create changelog file, update installer to copy it - [ ] 12-02: Publish command update - Add changelog generation to gsd-publish-version.md -- [ ] 12-03: whats-new command - Create /gsd:whats-new with remote fetch and version comparison +- [x] 12-03: whats-new command - Create /gsd:whats-new with remote fetch and version comparison **Wave structure:** - Wave 1: 12-01 (foundation) diff --git a/.planning/STATE.md b/.planning/STATE.md index 536a8d05f..44cd9a7ab 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -20,11 +20,11 @@ ## Current Position Phase: 12 of 12 (Changelog & Update Awareness) -Plan: 1 of 3 in current phase +Plan: 2 of 3 in current phase (12-02 may be running in parallel) Status: In progress -Last activity: 2026-01-14 - Completed 12-01-PLAN.md +Last activity: 2026-01-14 - Completed 12-03-PLAN.md -Progress: ████████████████████░░░░ 24/27 plans (~89%) +Progress: █████████████████████░░░ 25/27 plans (~93%) ## Performance Metrics @@ -107,5 +107,5 @@ Drift notes: None ## Session Continuity Last session: 2026-01-14 -Stopped at: Completed 12-01-PLAN.md +Stopped at: Completed 12-03-PLAN.md Resume file: None diff --git a/.planning/phases/12-changelog-and-update-awareness/12-03-SUMMARY.md b/.planning/phases/12-changelog-and-update-awareness/12-03-SUMMARY.md new file mode 100644 index 000000000..b650d04ef --- /dev/null +++ b/.planning/phases/12-changelog-and-update-awareness/12-03-SUMMARY.md @@ -0,0 +1,87 @@ +--- +phase: 12-changelog-and-update-awareness +plan: 03 +subsystem: infra +tags: [changelog, version, whats-new, update-awareness] + +requires: + - phase: 12-01 + provides: CHANGELOG.md file and installer changelog copy +provides: + - /gsd:whats-new command for version comparison + - VERSION file written during installation + - Help documentation for whats-new command +affects: [] + +tech-stack: + added: [] + patterns: + - Remote changelog fetch via WebFetch for update awareness + - VERSION file for installed version tracking + +key-files: + created: + - commands/gsd/whats-new.md + modified: + - bin/install.js + - commands/gsd/help.md + +key-decisions: + - "VERSION file approach (simpler than parsing package.json)" + - "Remote fetch from GitHub raw for discovering unreleased changes" + - "Graceful fallback to local changelog when offline" + +duration: 4min +completed: 2026-01-14 +--- + +# Phase 12 Plan 03: whats-new Command Summary + +**/gsd:whats-new command created for users to discover changes since their installed version, with VERSION file written during installation and help documentation updated** + +## Performance + +- **Duration:** 4 min +- **Started:** 2026-01-14T20:10:00Z +- **Completed:** 2026-01-14T20:14:00Z +- **Tasks:** 3 +- **Files modified:** 3 + +## Accomplishments +- Created /gsd:whats-new command with remote changelog fetch +- Added VERSION file creation to installer +- Updated help.md with whats-new command documentation + +## Task Commits + +Each task was committed atomically: + +1. **Task 1: Create whats-new.md command** - `1a55ac8` (feat) +2. **Task 2: Update install.js to write VERSION file** - `b281148` (feat) +3. **Task 3: Update help.md to include whats-new command** - `68f3cd1` (docs) + +## Files Created/Modified +- `commands/gsd/whats-new.md` - Command for version comparison and changelog display +- `bin/install.js` - Added VERSION file creation during installation +- `commands/gsd/help.md` - Added whats-new to Utility Commands section + +## Decisions Made +- VERSION file approach chosen over parsing package.json (simpler, more reliable) +- Remote fetch from GitHub enables discovering changes in versions not yet installed +- Graceful fallback to local changelog when offline or GitHub unavailable + +## Deviations from Plan + +None - plan executed exactly as written. + +## Issues Encountered +None + +## Next Phase Readiness +- /gsd:whats-new command ready for users to discover updates +- Phase 12 complete (all 3 plans finished) +- Ready for phase completion and milestone wrap-up + +--- +*Phase: 12-changelog-and-update-awareness* +*Completed: 2026-01-14*