pi-gsd 2.0.21 → 2.0.23

package/.gsd/harnesses/pi/get-shit-done/workflows/set-profile.md

@@ -0,0 +1,135 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="profile" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <display msg="Loading model profile config..." />
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="config-get" />
+      <arg string="workflow" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="workflow-config" />
+    </outs>
+  </shell>
+  <json-parse src="workflow-config" out="current-profile" path="$.model_profile" />
+</gsd-execute>
+
+## Profile Context (pre-injected by WXP)
+
+**Requested profile:** <gsd-paste name="profile" />
+
+**Current profile:** <gsd-paste name="current-profile" />
+
+**Full workflow config:**
+<gsd-paste name="workflow-config" />
+
+---
+
+<purpose>
+Set the active model profile, controlling which Claude model each GSD agent uses.
+One command replaces the full /gsd-settings flow for the common case of switching profiles.
+
+Profiles: `quality` | `balanced` | `budget` | `inherit`
+</purpose>
+
+<profile_reference>
+
+| Profile | Planner | Executor | Researcher | Verifier | Use when |
+|---------|---------|---------|------------|---------|---------|
+| `quality` | opus | opus | opus | sonnet | Critical architecture, quota available |
+| `balanced` | opus | sonnet | sonnet | sonnet | Normal development (default) |
+| `budget` | sonnet | sonnet | haiku | haiku | Conserving quota, high-volume work |
+| `inherit` | inherit | inherit | inherit | inherit | OpenRouter / local models / session switching |
+
+</profile_reference>
+
+<process>
+
+<step name="resolve_profile">
+<!-- Profile arg and current config pre-injected above via WXP -->
+
+**If `profile` is empty (no argument provided):**
+
+Show current profile and available options:
+
+```
+## Current Model Profile
+
+Active: {current-profile || "balanced (default)"}
+
+Available profiles:
+  quality   - Opus everywhere (highest quality, highest cost)
+  balanced  - Opus for planning, Sonnet for execution (recommended)
+  budget    - Sonnet/Haiku mix (lowest cost)
+  inherit   - Use the current session model for all agents
+
+Usage: /gsd-set-profile <profile>
+
+To configure individual agents and other settings: /gsd-settings
+```
+
+Exit (display only, no changes).
+</step>
+
+<step name="validate_profile">
+Validate that the provided `profile` value is one of: `quality`, `balanced`, `budget`, `inherit`.
+
+**If invalid:**
+```
+Error: Unknown profile '{profile}'.
+
+Valid profiles: quality, balanced, budget, inherit
+
+Example: /gsd-set-profile balanced
+```
+Exit.
+</step>
+
+<step name="apply_profile">
+Apply the profile:
+
+```bash
+pi-gsd-tools config-set-model-profile {profile}
+```
+
+This updates `.planning/config.json` with the new model profile.
+</step>
+
+<step name="confirm">
+```
+✓ Model profile set to: {profile}
+
+{profile description}
+
+  Planner:     {model}
+  Executor:    {model}
+  Researcher:  {model}
+  Verifier:    {model}
+
+To configure more options: /gsd-settings
+```
+
+Where "profile description" maps:
+- `quality` → "Maximum reasoning power. Opus for all decision-making agents."
+- `balanced` → "Smart allocation. Opus for planning, Sonnet for execution and verification."
+- `budget` → "Minimal Opus usage. Sonnet for writing, Haiku for research and verification."
+- `inherit` → "Follow the current session model. Required for non-Anthropic providers."
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Profile validated against allowed values
+- [ ] .planning/config.json updated with new profile
+- [ ] Confirmation shows per-agent model assignments
+- [ ] Link to /gsd-settings for advanced configuration
+</success_criteria>

package/.gsd/harnesses/pi/get-shit-done/workflows/settings.md

@@ -105,7 +105,7 @@ AskUserQuestion([
     header: "Auto",
     multiSelect: false,
     options: [
-      { label: "No (Recommended)", description: "Manual /clear + paste between stages" },
+      { label: "No (Recommended)", description: "Manual /new + paste between stages" },
       { label: "Yes", description: "Chain stages via Task() subagents (same isolation)" }
     ]
   },

package/.gsd/harnesses/pi/get-shit-done/workflows/thread.md

@@ -0,0 +1,213 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="subcommand" type="string" optional />
+  <arg name="name" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <display msg="Loading thread context..." />
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="current-timestamp" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="timestamp" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Thread Context (pre-injected by WXP)
+
+**Subcommand:** <gsd-paste name="subcommand" />
+**Name:** <gsd-paste name="name" />
+**Timestamp:** <gsd-paste name="timestamp" />
+
+**State:**
+<gsd-paste name="state" />
+
+---
+
+<purpose>
+Manage context threads — saved conversation checkpoints that can be resumed later.
+A thread is a snapshot of the current agent context (active phase, decisions, blockers) that
+survives `/clear` and can be handed off between sessions.
+
+Subcommands: list, new [name], switch &lt;name&gt;
+</purpose>
+
+<process>
+
+<step name="route">
+<!-- Context pre-injected above via WXP -->
+
+Parse `subcommand` and `name` from injected variables.
+
+Route by subcommand:
+- `list` (or empty) → **list_threads**
+- `new [name]` → **new_thread**
+- `switch <name>` → **switch_thread**
+- Unknown → show help
+</step>
+
+<step name="list_threads">
+Scan for thread files:
+
+```bash
+ls .planning/threads/*.md 2>/dev/null || echo "no threads"
+```
+
+**If no threads exist:**
+```
+No saved threads.
+
+Create one to preserve context across /clear:
+  /gsd-thread new <optional-name>
+```
+Exit.
+
+**If threads found:**
+
+For each thread file, read frontmatter and display:
+```
+## Context Threads
+
+| Name | Phase | Created | Summary |
+|------|-------|---------|---------|
+| {name} | {phase} | {date} | {one-line} |
+
+---
+Switch to a thread:  /gsd-thread switch <name>
+Create a new thread: /gsd-thread new [name]
+```
+</step>
+
+<step name="new_thread">
+Capture the current context as a named thread.
+
+**Resolve name:**
+- If `name` is provided, use it
+- Otherwise generate from state: `{phase-slug}-{date}` (e.g., `auth-2025-01-15`)
+
+**Ensure directory:**
+```bash
+mkdir -p .planning/threads
+```
+
+**Collect current context from state JSON:**
+- `current_phase` + `phase_name`
+- `milestone`
+- `last_activity`
+- Recent decisions (last 3 from STATE.md decisions table)
+- Active blockers
+
+**Write `.planning/threads/{name}.md`:**
+```markdown
+---
+name: {name}
+created: {timestamp}
+phase: {current_phase}
+phase_name: {phase_name}
+milestone: {milestone}
+status: active
+---
+
+## Thread: {name}
+
+**Saved:** {timestamp}
+**Phase:** {current_phase}: {phase_name}
+**Milestone:** {milestone}
+
+## Context Snapshot
+
+{Summary of what's in progress: what was being worked on, key decisions made, any open questions}
+
+## State at Save
+
+[Key fields from STATE.md: current position, last activity, blockers]
+
+## Resume Instructions
+
+To resume this thread:
+1. `/clear` - start fresh context
+2. `/gsd-thread switch {name}` - restore this thread's context
+3. `/gsd-resume-work` - re-orient with full project state
+```
+
+**Commit:**
+```bash
+pi-gsd-tools commit "docs: save context thread '{name}'" --files .planning/threads/{name}.md
+```
+
+**Confirm:**
+```
+✓ Thread saved: {name}
+
+  Phase: {current_phase}: {phase_name}
+  File: .planning/threads/{name}.md
+
+Safe to /clear. Resume with: /gsd-thread switch {name}
+```
+</step>
+
+<step name="switch_thread">
+**Require `name`:** If empty, list available threads and ask user to choose.
+
+```bash
+cat .planning/threads/{name}.md 2>/dev/null || echo "Thread '{name}' not found."
+```
+
+**If not found:**
+```
+Thread '{name}' not found.
+Available: [list]
+```
+Exit.
+
+**If found:**
+
+Read the thread file and display its full context:
+```
+## Restoring Thread: {name}
+
+**Saved:** {created}
+**Phase:** {phase}: {phase_name}
+
+[Display the Context Snapshot section verbatim]
+
+---
+Thread context restored. Continuing from saved state.
+
+Next:
+- /gsd-execute-phase {phase} - continue executing
+- /gsd-plan-phase {phase} - re-plan if context changed
+- /gsd-resume-work - full project orientation
+```
+
+Mark the thread as resumed by updating its frontmatter `status: resumed` and adding a `resumed:` timestamp field.
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Subcommand routed correctly
+- [ ] list: shows all saved threads with phase context
+- [ ] new: saves full state snapshot to .planning/threads/
+- [ ] switch: displays saved context and marks thread resumed
+- [ ] Thread files committed to git
+</success_criteria>

package/.gsd/harnesses/pi/get-shit-done/workflows/transition.md

@@ -539,7 +539,7 @@ Exit skill and invoke SlashCommand("/gsd-discuss-phase [X+1] --auto ${GSD_WS}")
 
 `/gsd-discuss-phase [X+1] ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -564,7 +564,7 @@ Exit skill and invoke SlashCommand("/gsd-discuss-phase [X+1] --auto ${GSD_WS}")
 
 `/gsd-plan-phase [X+1] ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -674,7 +674,7 @@ Exit skill and invoke SlashCommand("/gsd-complete-milestone {version} ${GSD_WS}"
 
 `/gsd-complete-milestone {version} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/ui-phase.md

@@ -1,4 +1,4 @@
-<gsd-version v="1.12.4" />
+<gsd-version v="1.12.5" />
 
 <gsd-arguments>
   <settings><keep-extra-args /></settings>
@@ -10,6 +10,7 @@
     <args>
       <arg string="init" />
       <arg string="plan-phase" />
+      <arg name="phase" wrap='"' />
     </args>
     <outs>
       <out type="string" name="init" />
@@ -346,7 +347,7 @@ Dimensions: 6/6 passed
 
 `/gsd-plan-phase {N}`
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/ui-review.md

@@ -213,7 +213,7 @@ Full review: {path to UI-REVIEW.md}
 - `/gsd-verify-work {N}` - UAT testing
 - `/gsd-plan-phase {N+1}` - plan next phase
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/validate-phase.md

@@ -227,7 +227,7 @@ GSD > PHASE {N} VALIDATED (PARTIAL)
 ▶ Retry: /gsd-validate-phase {N} ${GSD_WS}
 ```
 
-Display `/clear` reminder.
+Display `/new` reminder.
 
 </process>
 

package/.gsd/harnesses/pi/get-shit-done/workflows/verify-work.md

@@ -635,7 +635,7 @@ Plans verified and ready for execution.
 
 **Execute fixes** - run fix plans
 
-`/clear` then `/gsd-execute-phase {phase} --gaps-only`
+`/new` then `/gsd-execute-phase {phase} --gaps-only`
 
 ───────────────────────────────────────────────────────────────
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/workstreams.md

@@ -0,0 +1,215 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="subcommand" type="string" optional />
+  <arg name="name" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <display msg="Loading workstream state..." />
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="workstream" />
+      <arg string="list" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="ws-list" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="workstream" />
+      <arg string="get" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="ws-active" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Workstream Context (pre-injected by WXP)
+
+**Subcommand:** <gsd-paste name="subcommand" />
+**Name:** <gsd-paste name="name" />
+
+**Active workstream:** <gsd-paste name="ws-active" />
+
+**Workstream list:**
+<gsd-paste name="ws-list" />
+
+**State:**
+<gsd-paste name="state" />
+
+---
+
+<purpose>
+Manage GSD workstreams — isolated parallel tracks of work within a project.
+Each workstream has its own ROADMAP.md, STATE.md, and phase history.
+
+Subcommands: list, create &lt;name&gt;, switch &lt;name&gt;, status [name], complete &lt;name&gt;
+</purpose>
+
+<process>
+
+<step name="route">
+<!-- Context pre-injected above via WXP -->
+
+Parse `subcommand` and `name` from injected variables.
+
+**Route by subcommand:**
+
+| Subcommand | Action |
+|------------|--------|
+| `list` (or empty) | → **list_workstreams** |
+| `create <name>` | → **create_workstream** |
+| `switch <name>` | → **switch_workstream** |
+| `status [name]` | → **show_status** |
+| `complete <name>` | → **complete_workstream** |
+
+**If subcommand is unrecognised:** Show help (see offer_help step).
+</step>
+
+<step name="list_workstreams">
+<!-- ws-list and ws-active are pre-injected -->
+
+Parse `ws-list` JSON for workstream entries. Display:
+
+```
+## Workstreams
+
+Active: {ws-active || "(none — on main planning root)"}
+
+| Name | Status | Phases | Progress |
+|------|--------|--------|---------|
+| {name} | {active|inactive} | {phase_count} | {pct}% |
+| ...  | ...    | ...    | ...     |
+
+---
+/gsd-workstreams create <name>   - create a new workstream
+/gsd-workstreams switch <name>   - switch to a workstream
+/gsd-workstreams status <name>   - detailed workstream status
+/gsd-workstreams complete <name> - close a workstream
+```
+
+**If no workstreams exist:**
+```
+No workstreams yet. You're working in the main planning root.
+
+Create a workstream to isolate parallel work:
+  /gsd-workstreams create <name>
+```
+</step>
+
+<step name="create_workstream">
+**Require `name`:**
+If `name` is empty, ask: "Workstream name? (lowercase, no spaces — e.g. mobile-app, api-v2)"
+
+Validate: lowercase alphanumeric with hyphens/underscores only.
+
+```bash
+pi-gsd-tools workstream create {name}
+```
+
+Confirm:
+```
+✓ Workstream '{name}' created
+
+To switch to it: /gsd-workstreams switch {name}
+```
+</step>
+
+<step name="switch_workstream">
+**Require `name`:** If empty, list available workstreams and ask user to choose.
+
+```bash
+pi-gsd-tools workstream set {name}
+```
+
+Confirm:
+```
+✓ Switched to workstream: {name}
+
+All subsequent GSD commands will operate within this workstream.
+To return to main: /gsd-workstreams switch main
+```
+</step>
+
+<step name="show_status">
+**Target:** `name` if provided, otherwise the active workstream.
+
+```bash
+pi-gsd-tools workstream status {name}
+```
+
+Display the full status output including phase progress, open todos, and blockers.
+</step>
+
+<step name="complete_workstream">
+**Require `name`:** If empty, ask which workstream to complete.
+
+Confirm before completing:
+```
+Complete workstream '{name}'?
+
+This will:
+- Mark all phases as complete
+- Archive the workstream planning files
+
+Continue? (yes / no)
+```
+
+If yes:
+```bash
+pi-gsd-tools workstream complete {name}
+```
+
+Confirm:
+```
+✓ Workstream '{name}' completed and archived.
+```
+</step>
+
+<step name="offer_help">
+```
+## /gsd-workstreams
+
+Manage parallel tracks of work within a project.
+
+Usage:
+  /gsd-workstreams                  - list all workstreams
+  /gsd-workstreams create <name>    - create a new workstream
+  /gsd-workstreams switch <name>    - activate a workstream
+  /gsd-workstreams status [name]    - show workstream details
+  /gsd-workstreams complete <name>  - close a finished workstream
+
+Current: {ws-active || "main planning root"}
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Active workstream pre-injected (no runtime read needed)
+- [ ] Workstream list pre-injected
+- [ ] Subcommand routed correctly
+- [ ] Each action calls the appropriate CLI command
+- [ ] Confirmations displayed after mutations
+</success_criteria>

package/.gsd/harnesses/pi/gsd-file-manifest.json

@@ -129,7 +129,7 @@
     "get-shit-done/workflows/ship.md": "1057dbd67b07b420b11adaea9c63a1a7c29ca01c33e8f9d2e8eba8fc61b2e3f7",
     "get-shit-done/workflows/stats.md": "cbb11eec34f93399e7cc5cf7a19746f11448e840a38c0316688ef8be6ad7e7bf",
     "get-shit-done/workflows/transition.md": "15b767cabdc476782cdad7d3b9081e3d599316455a76d44866d66e1bb78e1db0",
-    "get-shit-done/workflows/ui-phase.md": "5e3cccd0b2b868174fafd8cbba638b0d40b917fd0ebb9b0029dc0ebc1b25e8f0",
+    "get-shit-done/workflows/ui-phase.md": "e7bd715dc7e2d5d113f52c7b3816023af130c5b9d23762d64e5c11aee07dbe83",
     "get-shit-done/workflows/ui-review.md": "6e99be78108e16ef325442692667d77d864759ffe8f6379a8f4ec011964999b3",
     "get-shit-done/workflows/update.md": "01371fe2bdda4aa84d3dc1dff7ab4f016d5b6b6411d99e8b7c6a38aadf0d53e1",
     "get-shit-done/workflows/validate-phase.md": "a60a09bb99161270b3dbc5539f0b93a8436747ebca56ba2dfa75f937e0e53261",