gsd-opencode 1.10.2 → 1.20.1

package/{commands/gsd → get-shit-done/workflows}/update.md

@@ -1,22 +1,34 @@
----
-name: gsd-update
-description: Update GSD to latest version with changelog display
----
+<purpose>
+Check for GSD updates via npm, display changelog for versions between installed and latest, obtain user confirmation, and execute clean installation with cache clearing.
+</purpose>
 
-<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>
+<required_reading>
+read all files referenced by the invoking prompt's execution_context before starting.
+</required_reading>
 
 <process>
 
 <step name="get_installed_version">
-read installed version:
+Detect whether GSD is installed locally or globally by checking both locations:
 
 ```bash
-cat ~/.config/opencode/get-shit-done/VERSION 2>/dev/null
-```
+# Check local first (takes priority)
+# Paths templated at install time for runtime compatibility
+if [ -f ./.OpenCode/get-shit-done/VERSION ]; then
+  cat ./.OpenCode/get-shit-done/VERSION
+  echo "LOCAL"
+elif [ -f ~/.config/opencode/get-shit-done/VERSION ]; then
+  cat ~/.config/opencode/get-shit-done/VERSION
+  echo "GLOBAL"
+else
+  echo "UNKNOWN"
+fi
+```
+
+Parse output:
+- If last line is "LOCAL": installed version is first line, use `--local` flag for update
+- If last line is "GLOBAL": installed version is first line, use `--global` flag for update
+- If "UNKNOWN": proceed to install step (treat as version 0.0.0)
 
 **If VERSION file missing:**
 ```
@@ -43,10 +55,10 @@ npm view gsd-opencode version 2>/dev/null
 ```
 Couldn't check for updates (offline or npm unavailable).
 
-To update manually: `npx gsd-opencode@latest --global`
+To update manually: `npx gsd-opencode --global`
 ```
 
-STOP here if npm unavailable.
+Exit.
 </step>
 
 <step name="compare_versions">
@@ -62,7 +74,7 @@ Compare installed vs latest:
 You're already on the latest version.
 ```
 
-STOP here if already up to date.
+Exit.
 
 **If installed > latest:**
 ```
@@ -74,13 +86,13 @@ STOP here if already up to date.
 You're ahead of the latest release (development version?).
 ```
 
-STOP here if ahead.
+Exit.
 </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)
+1. Fetch changelog from GitHub raw URL
 2. Extract entries between installed and latest versions
 3. Display preview and ask for confirmation:
 
@@ -106,42 +118,57 @@ STOP here if ahead.
 ────────────────────────────────────────────────────────────
 
 ⚠️  **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
+- `commands/gsd/` will be wiped and replaced
+- `get-shit-done/` will be wiped and replaced
+- `agents/gsd-*` files will be replaced
+
+(Paths are relative to your install location: `~/.config/opencode/` for global, `./.OpenCode/` for local)
 
 Your custom files in other locations are preserved:
-- Custom commands in `~/.config/opencode/commands/your-stuff/` ✓
+- Custom commands not in `commands/gsd/` ✓
 - Custom agents not prefixed with `gsd-` ✓
 - Custom hooks ✓
-- Your CLAUDE.md files ✓
+- Your AGENTS.md files ✓
 
-If you've modified any GSD files directly, back them up first.
+If you've modified any GSD files directly, they'll be automatically backed up to `gsd-local-patches/` and can be reapplied with `/gsd-reapply-patches` after the update.
 ```
 
 Use question:
-- Question: "Proceed with update?"
+- question: "Proceed with update?"
 - Options:
   - "Yes, update now"
   - "No, cancel"
 
-**If user cancels:** STOP here.
+**If user cancels:** Exit.
 </step>
 
 <step name="run_update">
-Run the update:
+Run the update using the install type detected in step 1:
 
+**If LOCAL install:**
 ```bash
-npx gsd-opencode@latest --global
+npx gsd-opencode --local
 ```
 
-Capture output. If install fails, show error and STOP.
+**If GLOBAL install (or unknown):**
+```bash
+npx gsd-opencode --global
+```
+
+Capture output. If install fails, show error and exit.
 
 Clear the update cache so statusline indicator disappears:
 
+**If LOCAL install:**
+```bash
+rm -f ./.OpenCode/cache/gsd-update-check.json
+```
+
+**If GLOBAL install:**
 ```bash
 rm -f ~/.config/opencode/cache/gsd-update-check.json
 ```
+(Paths are templated at install time for runtime compatibility)
 </step>
 
 <step name="display_result">
@@ -158,6 +185,21 @@ Format completion message (changelog was already shown in confirmation step):
 ```
 </step>
 
+
+<step name="check_local_patches">
+After update completes, check if the installer detected and backed up any locally modified files:
+
+Check for gsd-local-patches/backup-meta.json in the config directory.
+
+**If patches found:**
+
+```
+Local patches were backed up before the update.
+Run /gsd-reapply-patches to merge your modifications into the new version.
+```
+
+**If no patches:** Continue normally.
+</step>
 </process>
 
 <success_criteria>