pi-gsd 2.0.20 → 2.0.22

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

@@ -0,0 +1,219 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <display msg="Loading backlog and todos..." />
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="init" />
+      <arg string="todos" />
+      <arg string="0" />
+    </args>
+    <outs>
+      <out type="string" name="todos-data" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="todos-data" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="todos-data" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="todos-data-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="todos-data-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="todos-data" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+  <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="roadmap" />
+      <arg string="analyze" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="roadmap" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Backlog Review Context (pre-injected by WXP)
+
+**Todos:**
+<gsd-paste name="todos-data" />
+
+**Roadmap:**
+<gsd-paste name="roadmap" />
+
+**State:**
+<gsd-paste name="state" />
+
+---
+
+<purpose>
+Review accumulated backlog items (999.x phases and pending todos) and decide what to do with each: promote to a real phase, convert to a todo, discard, or keep.
+
+This is the "inbox zero" command for ideas that were parked during active development.
+</purpose>
+
+<process>
+
+<step name="load_backlog">
+<!-- Context pre-injected above via WXP - variables available via <gsd-paste name="..."> -->
+
+**Step A: Extract backlog phases from roadmap.**
+
+From `roadmap` JSON, find all phases where `phase_number` starts with `999` (backlog entries added via `/gsd-add-backlog`).
+
+**Step B: Extract pending todos from todos data.**
+
+From `todos-data` JSON, extract `todos` array with fields: `id`, `title`, `area`, `created`, `problem`.
+
+**If both backlog phases and todos are empty:**
+```
+Nothing in the backlog. The queue is clear.
+
+To capture an idea: /gsd-add-backlog <idea>
+To capture a todo: /gsd-add-todo <task>
+```
+Exit.
+</step>
+
+<step name="present_inventory">
+Display a combined inventory:
+
+```
+## Backlog Review
+
+### 999.x Backlog Phases ({N} items)
+| Phase | Idea | Added |
+|-------|------|-------|
+| 999.1 | {idea} | {date} |
+| 999.2 | {idea} | {date} |
+
+### Pending Todos ({M} items)
+| # | Title | Area | Created |
+|---|-------|------|---------|
+| 1 | {title} | {area} | {date} |
+| 2 | {title} | {area} | {date} |
+
+**Total:** {N+M} items to review
+```
+
+Ask:
+```
+Options:
+1. Review each item interactively (recommended)
+2. Promote a specific backlog phase → real phase number
+3. Work on a specific todo
+4. Discard a backlog phase
+5. Done (keep everything)
+```
+</step>
+
+<step name="interactive_review">
+**If user chooses interactive review:**
+
+For each backlog phase (999.x), present:
+```
+## Phase 999.{N}: {idea}
+
+Options:
+1. Promote to next available phase slot  ← recommended if actionable
+2. Convert to a todo (more granular)
+3. Keep in backlog
+4. Discard (remove from ROADMAP.md)
+```
+
+**Promote:** Remove the 999.x entry, add as a properly numbered phase at the end of the current milestone using:
+```bash
+pi-gsd-tools roadmap add-phase "{next_available_number}" "{idea_text}" --raw
+```
+Then remove the 999.x placeholder:
+```bash
+pi-gsd-tools roadmap remove-phase "999.{N}" --raw
+```
+
+**Convert to todo:** Create a todo file (see `/gsd-add-todo` workflow) and remove the 999.x phase entry.
+
+**Discard:**
+```bash
+pi-gsd-tools roadmap remove-phase "999.{N}" --raw
+```
+
+For each pending todo, present:
+```
+## Todo: {title}
+Area: {area}
+Problem: {problem excerpt}
+
+Options:
+1. Work on this now → promote to current phase plan
+2. Keep as todo
+3. Promote to backlog phase
+4. Mark done (won't be worked on)
+```
+</step>
+
+<step name="commit_changes">
+After all reviews, commit any ROADMAP.md changes and completed todos:
+
+```bash
+pi-gsd-tools commit "docs: backlog review - promoted {X} items, discarded {Y}" --files .planning/ROADMAP.md .planning/todos/done/
+```
+
+Display summary:
+```
+## Backlog Review Complete
+
+✓ Promoted: {list of promoted items}
+✓ Converted: {list of todos created}
+✓ Discarded: {count}
+→ Kept: {count remaining}
+
+{If phases promoted:}
+Next: /gsd-plan-phase {new_phase_number}
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] All 999.x backlog phases listed
+- [ ] All pending todos listed
+- [ ] Each item reviewed with a clear decision
+- [ ] Promotions written to ROADMAP.md
+- [ ] Discards removed from ROADMAP.md
+- [ ] Changes committed to git
+- [ ] User knows what's next
+</success_criteria>

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

@@ -1,5 +1,52 @@
 <gsd-version v="1.12.4" />
 
+<gsd-execute>
+  <display msg="Loading session 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>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="roadmap" />
+      <arg string="analyze" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="roadmap" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Session Context (pre-injected by WXP)
+
+**Generated:** <gsd-paste name="timestamp" />
+
+**State:**
+<gsd-paste name="state" />
+
+**Roadmap:**
+<gsd-paste name="roadmap" />
+
+---
+
 <purpose>
 Generate a post-session summary document capturing work performed, outcomes achieved, and estimated resource usage. Writes SESSION_REPORT.md to .planning/reports/ for human review and stakeholder sharing.
 </purpose>

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/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

@@ -5,6 +5,17 @@
 </gsd-arguments>
 
 <gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="state" />
+      <arg string="reconcile" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="reconcile-result" />
+    </outs>
+  </shell>
   <shell command="pi-gsd-tools">
     <args>
       <arg string="roadmap" />

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" />