gdd-check-update

name	gdd-check-update
description	Manual plugin-update check. Shows cached state by default; --refresh bypasses the 24h TTL; --dismiss hides the nudge until a newer release ships; --prompt spawns design-update-checker for a richer summary.
argument-hint	[--refresh] [--dismiss] [--prompt]
tools	Read, Write, Bash, Task

{{command_prefix}}check-update

Role: Manual entry point for the plugin-update checker. The SessionStart hook (hooks/update-check.sh) already runs on its own 24h cadence and writes .design/update-cache.json + .design/update-available.md. This command lets the user inspect / force / dismiss / enrich that state on demand. See ./reference/heuristics.md §"Version-cadence" for the off-cadence / preview-suffix handling background.

Flags

Flag	Effect
(none)	Print cached state. If cache is older than 24h, trigger --refresh implicitly.
--refresh	Invoke hooks/update-check.sh --refresh - bypasses the 24h TTL and re-fetches immediately.
--dismiss	Write update_dismissed: "<latest_tag>" to .design/config.json atomically and delete .design/update-available.md. Sticky until a newer release ships.
--prompt	Spawn design-update-checker agent (Haiku) to produce a 3–5-line "what this release changes for you" summary. Does not alter the banner or cache.

Flags combine: --refresh --prompt is valid (re-fetch, then enrich). --dismiss is the only flag that mutates .design/config.json.

Steps

1. Parse flags. Detect --refresh, --dismiss, --prompt in $ARGUMENTS. Unknown flag → Unknown flag: <flag> and exit.

2. --refresh path (if set):

   bash "${CLAUDE_PLUGIN_ROOT:-$(pwd)}/hooks/update-check.sh" --refresh
   

   This re-fetches /releases/latest, rewrites .design/update-cache.json, and re-renders .design/update-available.md subject to state/dismissal gates.

3. Read cache. After any optional refresh, read .design/update-cache.json. If missing: print No cache. Network may be unreachable or the hook has not run yet. Try {{command_prefix}}check-update --refresh. and exit.

4. --dismiss path (if set): Compute new config contents and write atomically via the env-prefix Python heredoc pattern below. The pattern is essential - passing variables as trailing KEY=VALUE argv treats them as sys.argv, not os.environ. Use env-prefix form only.

   CONFIG_PATH=".design/config.json"
   LATEST_TAG="$(grep -E '"latest_tag"' .design/update-cache.json | head -n1 | sed -E 's/.*"latest_tag"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/')"
   [ -n "$LATEST_TAG" ] || { echo 'No latest_tag in cache — nothing to dismiss.'; exit 0; }
   mkdir -p .design
   CONFIG_PATH="$CONFIG_PATH" LATEST_TAG="$LATEST_TAG" python3 <<'PY'
   import json, os, sys, tempfile
   config_path = os.environ['CONFIG_PATH']
   latest_tag = os.environ['LATEST_TAG']
   try:
       with open(config_path, 'r', encoding='utf-8') as f:
           data = json.load(f)
       if not isinstance(data, dict): data = {}
   except (FileNotFoundError, json.JSONDecodeError): data = {}
   data['update_dismissed'] = latest_tag
   target_dir = os.path.dirname(config_path) or '.config..tmpwutf-8\n

Do Not

• Do not fetch from GitHub directly - always go through hooks/update-check.sh --refresh so caching + state-guard + dismissal logic stays in one place.
• Do not modify .design/update-available.md except to delete on --dismiss.
• Do not rewrite .design/config.json wholesale - the atomic Python rewrite preserves every unknown key (D-14).
• Do not pass variables to the Python heredoc via trailing KEY=VALUE argv - env-prefix form only.

Completion marker

## CHECK-UPDATE COMPLETE