get-shit-pretty 0.5.0 → 0.5.2

package/gsp/skills/gsp-update/SKILL.md

@@ -11,12 +11,17 @@ Check for GSP updates, show what's new, and run the update if the user confirms.
 
 ## Step 1 — Detect installation
 
-Check for a `VERSION` file to determine install type:
+Check for a `VERSION` file to determine install type. The runtime directory varies by tool:
+- Claude Code: `.claude/` (local) or `~/.claude/` (global)
+- OpenCode: `.opencode/` (local) or `~/.config/opencode/` (global)
+- Gemini: `.gemini/` (local) or `~/.gemini/` (global)
+- Codex: `.codex/` (local) or `~/.codex/` (global)
 
-1. **Local install**: `.claude/get-shit-pretty/VERSION` relative to the current working directory
-2. **Global install**: `~/.claude/get-shit-pretty/VERSION`
+Look for the VERSION file in both local and global locations. Check two paths per location (current layout first, legacy fallback):
+1. `{runtime-dir}/VERSION` (v0.5.0+)
+2. `{runtime-dir}/get-shit-pretty/VERSION` (legacy v0.4.x)
 
-If neither exists, tell the user GSP doesn't appear to be installed and suggest running:
+If neither exists in either location, tell the user GSP doesn't appear to be installed and suggest running:
 ```
 npx get-shit-pretty
 ```
@@ -50,7 +55,7 @@ Update available: v{installed} → v{latest}
 
 Fetch the changelog to show what changed:
 ```bash
-curl -sf https://raw.githubusercontent.com/jubs-cloud/get-shit-pretty/main/CHANGELOG.md
+curl -sf https://raw.githubusercontent.com/jubscodes/get-shit-pretty/main/CHANGELOG.md
 ```
 
 If the fetch succeeds, extract and display the section for the latest version. If it fails, skip — changelog display is optional.
@@ -80,16 +85,19 @@ Based on the detected install type from Step 1:
 
 Show the output to the user.
 
+## Step 7.5 — Run migrations
+
+Scan `.design/branding/` for brand directories. For each brand, if `{brand}/system/` exists but `{brand}/patterns/` does not, rename via `mv` and log the migration. This handles the v0.5.0 → v0.5.1 rename.
+
 ## Step 8 — Clear update cache
 
-Remove the update cache so the statusline reflects the new state:
+Remove the update cache so the statusline reflects the new state. Clear cache from the same directory where VERSION was found in Step 1:
 ```bash
-rm -f ~/.claude/get-shit-pretty/.update-cache.json
+rm -f {version-dir}/.update-cache.json
 ```
-
-Also check for a local cache:
+Also clean the legacy path if it exists:
 ```bash
-rm -f .claude/get-shit-pretty/.update-cache.json
+rm -f {runtime-dir}/get-shit-pretty/.update-cache.json
 ```
 
 ## Step 9 — Remind to restart

package/gsp/templates/branding/brief.md

@@ -54,9 +54,21 @@
 - **Trust signals:** {trust / distrust triggers}
 
 ## Brand Essence
+
+### Promise
+- **Core promise:** {whenever someone interacts with this brand, they should feel X}
+- **Functional promise:** {what it delivers — saves time, reduces complexity, etc.}
+- **Emotional promise:** {what it makes them feel — confident, seen, ahead, safe, etc.}
+
+### Point of View
+- **Category disagreement:** {what this brand disagrees with in the status quo}
+- **Underestimated truth:** {what truth does this brand hold that others ignore?}
+- **Manifesto line:** {if the brand could defend one idea, what would it be?}
+
+### Personality
 - **Personality:** {3 words — e.g. precise, inventive, grounded}
 - **Personality reference:** {brand comparison — "like Stripe meets Notion"}
-- **Emotional outcome:** {how should someone feel after interacting with this brand?}
+- **Not us:** {2 words that are definitely not this brand — e.g. corporate, cute}
 - **Never be:** {what the brand should never feel like — e.g. corporate, cold, try-hard}
 - **Tone:** {default communication tone}
 

package/gsp/templates/branding/roadmap.md

@@ -38,5 +38,5 @@
 **Status:** pending
 **Command:** `/gsp:brand-patterns`
 **Input:** Identity + Strategy + BRIEF.md
-**Output:** `system/` (foundations, components, tokens.json) + `preview.html`
-**Goal:** Build design system, generate brand preview, transition to project diamond.
+**Output:** `patterns/` (foundations, components, tokens.json) + `guidelines.html`
+**Goal:** Build design system, generate brand guidelines, transition to project diamond.

package/gsp/templates/branding/state.md

@@ -16,7 +16,7 @@
 | 1 | Discover | pending | — | — |
 | 2 | Strategy | pending | — | — |
 | 3 | Identity | pending | — | — |
-| 4 | System | pending | — | — |
+| 4 | Patterns | pending | — | — |
 
 ## Status Values
 <!-- pending | in-progress | complete | needs-revision | skipped -->

package/gsp/templates/phases/brief.md

@@ -37,7 +37,7 @@ Each chunk follows the format in `references/chunk-format.md`. Below is the stru
 - **Component adaptations:** brand components that need project-specific variants
 - **Platform considerations:** platform-specific adjustments (mobile, desktop, etc.)
 - **Implementation target mapping:** design components → target primitives (shadcn, rn-reusables, existing, code)
-- Links to brand system components: `{BRAND_PATH}/system/components/{name}.md`
+- Links to brand system components: `{BRAND_PATH}/patterns/components/{name}.md`
 
 ### install-manifest.md
 - Install commands for all needed components

package/gsp/templates/phases/{system.md → patterns.md}

@@ -7,7 +7,7 @@
 
 ---
 
-> This phase produces foundation chunks in `system/foundations/`, component chunks in `system/components/`, plus `principles.md`, `tokens.json`, and `INDEX.md`.
+> This phase produces foundation chunks in `patterns/foundations/`, component chunks in `patterns/components/`, plus `principles.md`, `tokens.json`, and `INDEX.md`.
 
 ## Inputs
 - identity/color-system.md → foundations/color-system.md
@@ -20,7 +20,7 @@
 
 ## Chunk Mapping
 
-### Foundations (`system/foundations/`)
+### Foundations (`patterns/foundations/`)
 
 | Chunk File | Content |
 |-----------|---------|
@@ -31,7 +31,7 @@
 | `foundations/elevation.md` | 5 shadow levels with use cases and values |
 | `foundations/border-radius.md` | Token scale (none, sm, md, lg, xl, full) |
 
-### Components (`system/components/`)
+### Components (`patterns/components/`)
 
 Component output is library-aware:
 

package/gsp/templates/phases/review.md

@@ -37,4 +37,4 @@ Each chunk follows the format in `references/chunk-format.md`. Below is the stru
 - **Minor:** polish items, minor inconsistencies
 - Links to design chunks: `../design/screen-{NN}-{name}.md`
 - Links to actual codebase files: `{path/to/file}:{line}`
-- Links to brand system: `{BRAND_PATH}/system/components/{name}.md`
+- Links to brand system: `{BRAND_PATH}/patterns/components/{name}.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-shit-pretty",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Design engineering system for AI coding agents. Brand identity + design projects, from strategy to code.",
   "bin": {
     "get-shit-pretty": "bin/install.js"

package/scripts/gsp-context-recovery.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# GSP Context Recovery — re-inject active project/brand state after context compaction
+# Called by SessionStart hook (compact matcher) in gsp/hooks/hooks.json
+# Output target: 15-25 lines max to minimize context consumption
+
+DESIGN_DIR=".design"
+
+# Silent exit if no .design/ directory
+[[ -d "$DESIGN_DIR" ]] || exit 0
+
+OUTPUT=""
+
+# Extract phase names by status from a STATE.md phase table
+# Table format: | # | Phase | Status | Started | Completed |
+# Usage: extract_phases <file> <status>
+extract_phases() {
+  awk -F'|' -v status="$2" '{
+    gsub(/^[ \t]+|[ \t]+$/, "", $4)
+    if ($4 == status) {
+      gsub(/^[ \t]+|[ \t]+$/, "", $3)
+      printf "%s, ", $3
+    }
+  }' "$1" 2>/dev/null | sed 's/, $//'
+}
+
+# Collect brand state
+brand_count=0
+for state in "$DESIGN_DIR"/branding/*/STATE.md; do
+  [[ -f "$state" ]] || continue
+  brand_dir=$(basename "$(dirname "$state")")
+  [[ "$brand_dir" == "_"* ]] && continue
+  brand_count=$((brand_count + 1))
+  [[ $brand_count -gt 2 ]] && continue
+  phase=$(grep -m1 '^\*\*Current Phase:\*\*' "$state" | sed 's/.*Current Phase:\*\*[[:space:]]*//')
+  pretty=$(grep -m1 '^\*\*Prettiness Level:\*\*' "$state" | sed 's/.*Prettiness Level:\*\*[[:space:]]*//')
+  completed=$(extract_phases "$state" "complete")
+  current=$(extract_phases "$state" "in-progress")
+  OUTPUT+="Brand: $brand_dir | Phase: $phase | $pretty"$'\n'
+  [[ -n "$completed" ]] && OUTPUT+="  completed: $completed"$'\n'
+  [[ -n "$current" ]] && OUTPUT+="  current: $current"$'\n'
+done
+[[ $brand_count -gt 2 ]] && OUTPUT+="  (+$((brand_count - 2)) more brands)"$'\n'
+
+# Collect project state
+proj_count=0
+for state in "$DESIGN_DIR"/projects/*/STATE.md; do
+  [[ -f "$state" ]] || continue
+  proj_dir=$(basename "$(dirname "$state")")
+  proj_count=$((proj_count + 1))
+  [[ $proj_count -gt 2 ]] && continue
+  brand_ref=$(grep -m1 '^brand:' "$DESIGN_DIR/projects/$proj_dir/brand.ref" 2>/dev/null | sed 's/^brand:[[:space:]]*//')
+  phase=$(grep -m1 '^\*\*Current Phase:\*\*' "$state" | sed 's/.*Current Phase:\*\*[[:space:]]*//')
+  pretty=$(grep -m1 '^\*\*Prettiness Level:\*\*' "$state" | sed 's/.*Prettiness Level:\*\*[[:space:]]*//')
+  completed=$(extract_phases "$state" "complete")
+  current=$(extract_phases "$state" "in-progress")
+  brand_info=""
+  [[ -n "$brand_ref" ]] && brand_info=" | Brand: $brand_ref"
+  OUTPUT+="Project: $proj_dir$brand_info | Phase: $phase | $pretty"$'\n'
+  [[ -n "$completed" ]] && OUTPUT+="  completed: $completed"$'\n'
+  [[ -n "$current" ]] && OUTPUT+="  current: $current"$'\n'
+done
+[[ $proj_count -gt 2 ]] && OUTPUT+="  (+$((proj_count - 2)) more projects)"$'\n'
+
+# Silent exit if nothing found
+[[ -z "$OUTPUT" ]] && exit 0
+
+echo "GSP Context Recovery"
+echo "────────────────────"
+printf "%s" "$OUTPUT"
+echo "────────────────────"
+echo "Resume: /gsp:start to pick up where you left off"

package/scripts/gsp-statusline.js

@@ -109,7 +109,11 @@ process.stdin.on('end', () => {
     // ── Update check ──
     let updateTag = '';
     try {
-      const gspDir = path.join(homeDir, '.claude', 'get-shit-pretty');
+      const runtimeDir = path.join(homeDir, '.claude');
+      const legacyDir = path.join(runtimeDir, 'get-shit-pretty');
+      const gspDir = fs.existsSync(path.join(runtimeDir, 'VERSION')) ? runtimeDir
+        : fs.existsSync(path.join(legacyDir, 'VERSION')) ? legacyDir : null;
+      if (!gspDir) throw new Error('no VERSION');
       const versionFile = path.join(gspDir, 'VERSION');
       const cacheFile = path.join(gspDir, '.update-cache.json');