<!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->
<!-- Regenerate: bun run gen:skill-docs -->

# /opengstack-upgrade

Upgrade opengstack to the latest version and show what's new.

## Inline upgrade flow

This section is referenced by all skill preambles when they detect `

### Step 1: Ask the user (or auto-upgrade)

First, check if auto-upgrade is enabled:
```bash
_AUTO=""
[ "${OpenGStack_AUTO_UPGRADE:-}" = "1" ] && _AUTO="true"
[ -z "$_AUTO" ] && _AUTO=$(echo get auto_upgrade 2>/dev/null || true)
echo "AUTO_UPGRADE=$_AUTO"

**If `AUTO_UPGRADE=true` or `AUTO_UPGRADE=1`:** Skip AskUserQuestion. Log "Auto-upgrading opengstack v{old} → v{new}..." and proceed directly to Step 2. If `./setup` fails during auto-upgrade, restore from backup (`.bak` directory) and warn the user: "Auto-upgrade failed — restored previous version. Run `/opengstack-upgrade` manually to retry."

**Otherwise**, use AskUserQuestion:
- Question: "opengstack **v{new}** is available (you're on v{old}). Upgrade now?"
- Options:

**If "Yes, upgrade now":** Proceed to Step 2.

**If "Always keep me up to date":**
```bash
echo set auto_upgrade true

Tell user: "Auto-upgrade enabled. Future updates will install automatically." Then proceed to Step 2.

**If "Not now":** Write snooze state with escalating backoff (first snooze = 24h, second = 48h, third+ = 1 week), then continue with the current skill. Do not mention the upgrade again.
```bash
_SNOOZE_FILE=~/.opengstack/update-snoozed
_REMOTE_VER="{new}"
_CUR_LEVEL=0
if [ -f "$_SNOOZE_FILE" ]; then
 _SNOOZED_VER=$(awk '{print $1}' "$_SNOOZE_FILE")
 if [ "$_SNOOZED_VER" = "$_REMOTE_VER" ]; then
 _CUR_LEVEL=$(awk '{print $2}' "$_SNOOZE_FILE")
 case "$_CUR_LEVEL" in *[!0-9]*) _CUR_LEVEL=0 ;; esac
 fi
fi
_NEW_LEVEL=$((_CUR_LEVEL + 1))
[ "$_NEW_LEVEL" -gt 3 ] && _NEW_LEVEL=3
echo "$_REMOTE_VER $_NEW_LEVEL $(date +%s)" > "$_SNOOZE_FILE"

Note: `{new}` is the remote version from the `

Tell user the snooze duration: "Next reminder in 24h" (or 48h or 1 week, depending on level). Tip: "Set `auto_upgrade: true` in `~/.opengstack/config.yaml` for automatic upgrades."

**If "Never ask again":**
```bash
echo set update_check false

Tell user: "Update checks disabled. Run `echo set update_check true` to re-enable."
Continue with the current skill.

### Step 2: Detect install type

```bash
if [ -d "$HOME/.claude/skills/opengstack/.git" ]; then
 INSTALL_TYPE="global-git"
 INSTALL_DIR="$HOME/.claude/skills/opengstack"
elif [ -d "$HOME/.OpenGStack/repos/opengstack/.git" ]; then
 INSTALL_TYPE="global-git"
 INSTALL_DIR="$HOME/.OpenGStack/repos/opengstack"
elif [ -d ".claude/skills/opengstack/.git" ]; then
 INSTALL_TYPE="local-git"
 INSTALL_DIR=".claude/skills/opengstack"
elif [ -d ".agents/skills/opengstack/.git" ]; then
 INSTALL_TYPE="local-git"
 INSTALL_DIR=".agents/skills/opengstack"
elif [ -d ".claude/skills/opengstack" ]; then
 INSTALL_TYPE="vendored"
 INSTALL_DIR=".claude/skills/opengstack"
elif [ -d "$HOME/.claude/skills/opengstack" ]; then
 INSTALL_TYPE="vendored-global"
 INSTALL_DIR="$HOME/.claude/skills/opengstack"
else
 echo "ERROR: opengstack not found"
 exit 1
fi
echo "Install type: $INSTALL_TYPE at $INSTALL_DIR"

The install type and directory path printed above will be used in all subsequent steps.

### Step 3: Save old version

Use the install directory from Step 2's output below:

```bash
OLD_VERSION=$(cat "$INSTALL_DIR/VERSION" 2>/dev/null || echo "unknown")

### Step 4: Upgrade

Use the install type and directory detected in Step 2:

**For git installs** (global-git, local-git):
```bash
cd "$INSTALL_DIR"
STASH_OUTPUT=$(git stash 2>&1)
git fetch origin
git reset --hard origin/main
./setup

If `$STASH_OUTPUT` contains "Saved working directory", warn the user: "Note: local changes were stashed. Run `git stash pop` in the skill directory to restore them."

**For vendored installs** (vendored, vendored-global):
```bash
PARENT=$(dirname "$INSTALL_DIR")
TMP_DIR=$(mktemp -d)
git clone --depth 1 https://github.com/Ambisphaeric/OpenGStack.git "$TMP_DIR/opengstack"
mv "$INSTALL_DIR" "$INSTALL_DIR.bak"
mv "$TMP_DIR/opengstack" "$INSTALL_DIR"
cd "$INSTALL_DIR" && ./setup
rm -rf "$INSTALL_DIR.bak" "$TMP_DIR"

### Step 4.5: Sync local vendored copy

Use the install directory from Step 2. Check if there's also a local vendored copy that needs updating:

```bash
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
LOCAL_OpenGStack=""
if [ -n "$_ROOT" ] && [ -d "$_ROOT/.claude/skills/opengstack" ]; then
 _RESOLVED_LOCAL=$(cd "$_ROOT/.claude/skills/opengstack" && pwd -P)
 _RESOLVED_PRIMARY=$(cd "$INSTALL_DIR" && pwd -P)
 if [ "$_RESOLVED_LOCAL" != "$_RESOLVED_PRIMARY" ]; then
 LOCAL_OpenGStack="$_ROOT/.claude/skills/opengstack"
 fi
fi
echo "LOCAL_OpenGStack=$LOCAL_OpenGStack"

If `LOCAL_OpenGStack` is non-empty, update it by copying from the freshly-upgraded primary install (same approach as README vendored install):
```bash
mv "$LOCAL_OpenGStack" "$LOCAL_opengstack.bak"
cp -Rf "$INSTALL_DIR" "$LOCAL_OpenGStack"
rm -rf "$LOCAL_OpenGStack/.git"
cd "$LOCAL_OpenGStack" && ./setup
rm -rf "$LOCAL_opengstack.bak"

Tell user: "Also updated vendored copy at `$LOCAL_OpenGStack` — commit `.claude/skills/opengstack/` when you're ready."

If `./setup` fails, restore from backup and warn the user:
```bash
rm -rf "$LOCAL_OpenGStack"
mv "$LOCAL_opengstack.bak" "$LOCAL_OpenGStack"

Tell user: "Sync failed — restored previous version at `$LOCAL_OpenGStack`. Run `/opengstack-upgrade` manually to retry."

### Step 5: Write marker + clear cache

```bash
mkdir -p ~/.opengstack
echo "$OLD_VERSION" > ~/.opengstack/just-upgraded-from
rm -f ~/.opengstack/last-update-check
rm -f ~/.opengstack/update-snoozed

### Step 6: Show What's New

Read `$INSTALL_DIR/CHANGELOG.md`. Find all version entries between the old version and the new version. Summarize as 5-7 bullets grouped by theme. Don't overwhelm — focus on user-facing changes. Skip internal refactors unless they're significant.

Format:

opengstack v{new} — upgraded from v{old}!

What's new:
-
-
- ...

Happy shipping!

### Step 7: Continue

After showing What's New, continue with whatever skill the user originally invoked. The upgrade is done — no further action needed.

## Standalone usage

When invoked directly as `/opengstack-upgrade` (not from a preamble):

1. Force a fresh update check (bypass cache):
```bash
~/.claude/skills/opengstack/bin/echo --force 2>/dev/null || \
.claude/skills/opengstack/bin/echo --force 2>/dev/null || true

Use the output to determine if an upgrade is available.

2. If `

3. If no output (primary is up to date): check for a stale local vendored copy.

Run the Step 2 bash block above to detect the primary install type and directory (`INSTALL_TYPE` and `INSTALL_DIR`). Then run the Step 4.5 detection bash block above to check for a local vendored copy (`LOCAL_OpenGStack`).

**If `LOCAL_OpenGStack` is empty** (no local vendored copy): tell the user "You're already on the latest version (v{version})."

**If `LOCAL_OpenGStack` is non-empty**, compare versions:
```bash
PRIMARY_VER=$(cat "$INSTALL_DIR/VERSION" 2>/dev/null || echo "unknown")
LOCAL_VER=$(cat "$LOCAL_OpenGStack/VERSION" 2>/dev/null || echo "unknown")
echo "PRIMARY=$PRIMARY_VER LOCAL=$LOCAL_VER"

**If versions differ:** follow the Step 4.5 sync bash block above to update the local copy from the primary. Tell user: "Global v{PRIMARY_VER} is up to date. Updated local vendored copy from v{LOCAL_VER} → v{PRIMARY_VER}. Commit `.claude/skills/opengstack/` when you're ready."

**If versions match:** tell the user "You're on the latest version (v{PRIMARY_VER}). Global and local vendored copy are both up to date."