gsd-opencode 1.5.2 → 1.6.0

package/command/gsd/update.md

@@ -0,0 +1,172 @@
+---
+name: gsd-update
+description: Update GSD to latest version with changelog display
+---
+
+<objective>
+Check for GSD updates, install if available, and display what changed.
+
+Provides a better update experience than raw `npx gsd-opencode` by showing version diff and changelog entries.
+</objective>
+
+<process>
+
+<step name="get_installed_version">
+read installed version:
+
+```bash
+cat ~/.config/opencode/get-shit-done/VERSION 2>/dev/null
+```
+
+**If VERSION file missing:**
+```
+## GSD Update
+
+**Installed version:** Unknown
+
+Your installation doesn't include version tracking.
+
+Running fresh install...
+```
+
+Proceed to install step (treat as version 0.0.0 for comparison).
+</step>
+
+<step name="check_latest_version">
+Check npm for latest version:
+
+```bash
+npm view gsd-opencode version 2>/dev/null
+```
+
+**If npm check fails:**
+```
+Couldn't check for updates (offline or npm unavailable).
+
+To update manually: `npx gsd-opencode --global`
+```
+
+STOP here if npm unavailable.
+</step>
+
+<step name="compare_versions">
+Compare installed vs latest:
+
+**If installed == latest:**
+```
+## GSD Update
+
+**Installed:** X.Y.Z
+**Latest:** X.Y.Z
+
+You're already on the latest version.
+```
+
+STOP here if already up to date.
+
+**If installed > latest:**
+```
+## GSD Update
+
+**Installed:** X.Y.Z
+**Latest:** A.B.C
+
+You're ahead of the latest release (development version?).
+```
+
+STOP here if ahead.
+</step>
+
+<step name="show_changes_and_confirm">
+**If update available**, fetch and show what's new BEFORE updating:
+
+1. Fetch changelog (same as fetch_changelog step)
+2. Extract entries between installed and latest versions
+3. Display preview and ask for confirmation:
+
+```
+## GSD Update Available
+
+**Installed:** 1.5.10
+**Latest:** 1.5.15
+
+### What's New
+────────────────────────────────────────────────────────────
+
+## [1.5.15] - 2026-01-20
+
+### Added
+- Feature X
+
+## [1.5.14] - 2026-01-18
+
+### Fixed
+- Bug fix Y
+
+────────────────────────────────────────────────────────────
+
+⚠️  **Note:** The installer performs a clean install of GSD folders:
+- `~/.config/opencode/commands/gsd/` will be wiped and replaced
+- `~/.config/opencode/get-shit-done/` will be wiped and replaced
+- `~/.config/opencode/agents/gsd-*` files will be replaced
+
+Your custom files in other locations are preserved:
+- Custom commands in `~/.config/opencode/commands/your-stuff/` ✓
+- Custom agents not prefixed with `gsd-` ✓
+- Custom hooks ✓
+- Your CLAUDE.md files ✓
+
+If you've modified any GSD files directly, back them up first.
+```
+
+Use question:
+- Question: "Proceed with update?"
+- Options:
+  - "Yes, update now"
+  - "No, cancel"
+
+**If user cancels:** STOP here.
+</step>
+
+<step name="run_update">
+Run the update:
+
+```bash
+npx gsd-opencode@latest --global
+```
+
+Capture output. If install fails, show error and STOP.
+
+Clear the update cache so statusline indicator disappears:
+
+```bash
+rm -f ~/.config/opencode/cache/gsd-update-check.json
+```
+</step>
+
+<step name="display_result">
+Format completion message (changelog was already shown in confirmation step):
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║  GSD Updated: v1.5.10 → v1.5.15                           ║
+╚═══════════════════════════════════════════════════════════╝
+
+⚠️  Restart OpenCode to pick up the new commands.
+
+[View full changelog](https://github.com/rokicool/get-shit-done/blob/main/CHANGELOG.md)
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Installed version read correctly
+- [ ] Latest version checked via npm
+- [ ] Update skipped if already current
+- [ ] Changelog fetched and displayed BEFORE update
+- [ ] Clean install warning shown
+- [ ] User confirmation obtained
+- [ ] Update executed successfully
+- [ ] Restart reminder shown
+</success_criteria>

package/command/gsd/verify-work.md

@@ -1,71 +1,219 @@
 ---
 name: gsd-verify-work
-description: Guide manual user acceptance testing of recently built features
-argument-hint: "[optional: phase or plan number, e.g., '4' or '04-02']"
-allowed-tools:
+description: Validate built features through conversational UAT
+argument-hint: "[phase number, e.g., '4']"
+tools:
   - read
   - bash
   - glob
   - grep
   - edit
   - write
-  - question
+
 ---
 
 <objective>
-Guide user through manual acceptance testing of recently built features.
+Validate built features through conversational testing with persistent state.
 
-Purpose: Validate that what OpenCode thinks was built actually works from user's perspective. The USER performs all testing — OpenCode generates a test checklist, guides process, and captures issues.
+Purpose: Confirm what OpenCode built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
 
-Output: Validation of features, any issues logged to phase-scoped ISSUES.md
+Output: {phase}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd-execute-phase
 </objective>
 
 <execution_context>
 @~/.config/opencode/get-shit-done/workflows/verify-work.md
-@~/.config/opencode/get-shit-done/templates/uat-issues.md
+@~/.config/opencode/get-shit-done/templates/UAT.md
 </execution_context>
 
 <context>
-Scope: $ARGUMENTS (optional)
-- If provided: Test specific phase or plan (e.g., "4" or "04-02")
-- If not provided: Test most recently completed plan
+Phase: $ARGUMENTS (optional)
+- If provided: Test specific phase (e.g., "4")
+- If not provided: Check for active sessions or prompt for phase
 
-**Load project state:**
 @.planning/STATE.md
-
-**Load roadmap:**
 @.planning/ROADMAP.md
 </context>
 
 <process>
-1. Validate arguments (if provided, parse as phase or plan number)
-2. Find relevant SUMMARY.md (specified or most recent)
-3. Follow verify-work.md workflow:
-   - Extract testable deliverables
-   - Generate test checklist
-   - Guide through each test via question
-   - Collect and categorize issues
-   - Log issues to `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md`
-   - Present summary with verdict
-4. Offer next steps based on results:
-   - If all passed: Continue to next phase
-   - If issues found: `/gsd-plan-fix {phase} {plan}` to create fix plan
+1. Check for active UAT sessions (resume or start new)
+2. Find SUMMARY.md files for the phase
+3. Extract testable deliverables (user-observable outcomes)
+4. Create {phase}-UAT.md with test list
+5. Present tests one at a time:
+   - Show expected behavior
+   - Wait for plain text response
+   - "yes/y/next" = pass, anything else = issue (severity inferred)
+6. Update UAT.md after each response
+7. On completion: commit, present summary
+8. If issues found:
+   - Spawn parallel debug agents to diagnose root causes
+   - Spawn gsd-planner in --gaps mode to create fix plans
+   - Spawn gsd-plan-checker to verify fix plans
+   - Iterate planner ↔ checker until plans pass (max 3)
+   - Present ready status with `/new` then `/gsd-execute-phase`
 </process>
 
 <anti_patterns>
-- Don't run automated tests (that's for CI/test suites)
-- Don't make assumptions about test results — USER reports outcomes
-- Don't skip guidance — walk through each test
-- Don't dismiss minor issues — log everything user reports
-- Don't fix issues during testing — capture for later
+- Don't use question for test responses — plain text conversation
+- Don't ask severity — infer from description
+- Don't present full checklist upfront — one test at a time
+- Don't run automated tests — this is manual user validation
+- Don't fix issues during testing — log as gaps, diagnose after all tests complete
 </anti_patterns>
 
+<offer_next>
+Output this markdown directly (not as a code block). Route based on UAT results:
+
+| Status | Route |
+|--------|-------|
+| All tests pass + more phases | Route A (next phase) |
+| All tests pass + last phase | Route B (milestone complete) |
+| Issues found + fix plans ready | Route C (execute fixes) |
+| Issues found + planning blocked | Route D (manual intervention) |
+
+---
+
+**Route A: All tests pass, more phases remain**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► PHASE {Z} VERIFIED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{N} tests passed
+UAT complete ✓
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
+
+/gsd-discuss-phase {Z+1} — gather context and clarify approach
+
+*/new first → fresh context window*
+
+───────────────────────────────────────────────────────────────
+
+**Also available:**
+- /gsd-plan-phase {Z+1} — skip discussion, plan directly
+- /gsd-execute-phase {Z+1} — skip to execution (if already planned)
+
+───────────────────────────────────────────────────────────────
+
+---
+
+**Route B: All tests pass, milestone complete**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► PHASE {Z} VERIFIED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{N} tests passed
+Final phase verified ✓
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Audit milestone** — verify requirements, cross-phase integration, E2E flows
+
+/gsd-audit-milestone
+
+*/new first → fresh context window*
+
+───────────────────────────────────────────────────────────────
+
+**Also available:**
+- /gsd-complete-milestone — skip audit, archive directly
+
+───────────────────────────────────────────────────────────────
+
+---
+
+**Route C: Issues found, fix plans ready**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► PHASE {Z} ISSUES FOUND ⚠
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{M} tests passed
+{X} issues diagnosed
+Fix plans verified ✓
+
+### Issues Found
+
+{List issues with severity from UAT.md}
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Execute fix plans** — run diagnosed fixes
+
+/gsd-execute-phase {Z} --gaps-only
+
+*/new first → fresh context window*
+
+───────────────────────────────────────────────────────────────
+
+**Also available:**
+- cat .planning/phases/{phase_dir}/*-PLAN.md — review fix plans
+- /gsd-plan-phase {Z} --gaps — regenerate fix plans
+
+───────────────────────────────────────────────────────────────
+
+---
+
+**Route D: Issues found, planning blocked**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GSD ► PHASE {Z} BLOCKED ✗
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Phase {Z}: {Name}**
+
+{N}/{M} tests passed
+Fix planning blocked after {X} iterations
+
+### Unresolved Issues
+
+{List blocking issues from planner/checker output}
+
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**Manual intervention required**
+
+Review the issues above and either:
+1. Provide guidance for fix planning
+2. Manually address blockers
+3. Accept current state and continue
+
+───────────────────────────────────────────────────────────────
+
+**Options:**
+- /gsd-plan-phase {Z} --gaps — retry fix planning with guidance
+- /gsd-discuss-phase {Z} — gather more context before replanning
+
+───────────────────────────────────────────────────────────────
+</offer_next>
+
 <success_criteria>
-- [ ] Test scope identified from SUMMARY.md
-- [ ] Checklist generated based on deliverables
-- [ ] User guided through each test
-- [ ] All test results captured (pass/fail/partial/skip)
-- [ ] Any issues logged to phase-scoped ISSUES.md (not global)
-- [ ] Summary presented with verdict
-- [ ] User knows next steps based on results
+- [ ] UAT.md created with tests from SUMMARY.md
+- [ ] Tests presented one at a time with expected behavior
+- [ ] Plain text responses (no structured forms)
+- [ ] Severity inferred, never asked
+- [ ] Batched writes: on issue, every 5 passes, or completion
+- [ ] Committed on completion
+- [ ] If issues: parallel debug agents diagnose root causes
+- [ ] If issues: gsd-planner creates fix plans from diagnosed gaps
+- [ ] If issues: gsd-plan-checker verifies fix plans (max 3 iterations)
+- [ ] Ready for `/gsd-execute-phase` when complete
 </success_criteria>

package/command/gsd/whats-new.md

@@ -0,0 +1,124 @@
+---
+name: gsd-whats-new
+description: See what's new in GSD since your installed version
+---
+
+<objective>
+Display changes between installed version and latest available version.
+
+Shows version comparison, changelog entries for missed versions, and update instructions.
+</objective>
+
+<process>
+
+<step name="get_installed_version">
+read installed version from VERSION file:
+
+```bash
+cat ~/.config/opencode/get-shit-done/VERSION 2>/dev/null
+```
+
+**If VERSION file missing:**
+```
+## GSD What's New
+
+**Installed version:** Unknown
+
+Your installation doesn't include version tracking.
+
+**To fix:** `npx gsd-opencode --global`
+
+This will reinstall with version tracking enabled.
+```
+
+STOP here if no VERSION file.
+</step>
+
+<step name="fetch_remote_changelog">
+Fetch latest CHANGELOG.md from GitHub:
+
+Use webfetch tool with:
+- URL: `https://raw.githubusercontent.com/rokicool/get-shit-done/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 ~/.config/opencode/get-shit-done/CHANGELOG.md 2>/dev/null
+```
+
+Note to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog."
+</step>
+
+<step name="parse_versions">
+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>
+
+<step name="display_output">
+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/rokicool/get-shit-done/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/rokicool/get-shit-done/blob/main/CHANGELOG.md)
+
+**To update:** `npx gsd-opencode --global`
+```
+
+**Breaking changes:** Surface prominently with **BREAKING:** prefix in the output.
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Installed version read from VERSION file
+- [ ] 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>