pi-gsd 2.0.21 → 2.0.23

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

@@ -1,5 +1,75 @@
 <gsd-version v="1.12.4" />
 
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="phase" type="number" />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="init" />
+      <arg string="phase-op" />
+      <arg name="phase" wrap='"' />
+    </args>
+    <outs>
+      <out type="string" name="init" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="init" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="init" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="init-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="init-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="init" />
+        </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>
+</gsd-execute>
+
+## Context (pre-injected by WXP)
+
+**Phase:** <gsd-paste name="phase" />
+
+**Phase Data:**
+<gsd-paste name="init" />
+
+**State:**
+<gsd-paste name="state" />
+
+---
+
 <purpose>
 Surface the agent's assumptions about a phase before planning, enabling users to correct misconceptions early.
 
@@ -9,46 +79,24 @@ Key difference from discuss-phase: This is ANALYSIS of what the agent thinks, no
 <process>
 
 <step name="validate_phase" priority="first">
-Phase number: $ARGUMENTS (required)
+<!-- Phase number, phase data and state are pre-injected above via WXP -->
 
-**If argument missing:**
+Parse `init` JSON for: `phase_found`, `phase_number`, `phase_name`, `phase_slug`, `goal`, `phase_dir`.
 
-```
-Error: Phase number required.
+**If `phase_found` is false:**
 
-Usage: /gsd-list-phase-assumptions [phase-number]
-Example: /gsd-list-phase-assumptions 3
 ```
+Error: Phase {phase} not found in roadmap.
 
-Exit workflow.
-
-**If argument provided:**
-Validate phase exists in roadmap:
+Available phases: [list from roadmap]
 
-```bash
-cat .planning/ROADMAP.md | grep -i "Phase ${PHASE}"
-```
-
-**If phase not found:**
-
-```
-Error: Phase ${PHASE} not found in roadmap.
-
-Available phases:
-[list phases from roadmap]
+Usage: /gsd-list-phase-assumptions [phase-number]
+Example: /gsd-list-phase-assumptions 3
 ```
 
 Exit workflow.
 
-**If phase found:**
-Parse phase details from roadmap:
-
-- Phase number
-- Phase name
-- Phase description/goal
-- Any scope details mentioned
-
-Continue to analyze_phase.
+**If `phase_found` is true:** Continue to analyze_phase.
 </step>
 
 <step name="analyze_phase">

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

@@ -382,7 +382,7 @@ Created .planning/codebase/:
 
 `/gsd-new-project`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 

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

@@ -489,7 +489,7 @@ pi-gsd-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files
 
 `/gsd-discuss-phase [N] ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 Also: `/gsd-plan-phase [N] ${GSD_WS}` - skip discussion, plan directly
 ```

package/.gsd/harnesses/pi/get-shit-done/workflows/new-milestone.md.bak

@@ -461,7 +461,7 @@ pi-gsd-tools commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files
 
 `/gsd-discuss-phase [N] ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 Also: `/gsd-plan-phase [N] ${GSD_WS}` - skip discussion, plan directly
 ```

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

@@ -1209,7 +1209,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 
@@ -1231,7 +1231,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/new-project.md.bak

@@ -1173,7 +1173,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 
@@ -1195,7 +1195,7 @@ PHASE1_HAS_UI=$(echo "$PHASE1_SECTION" | grep -qi "UI hint.*yes" && echo "true"
 
 /gsd-discuss-phase 1 - gather context and clarify approach
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ---
 

package/.gsd/harnesses/pi/get-shit-done/workflows/plan-milestone-gaps.md

@@ -202,7 +202,7 @@ pi-gsd-tools commit "docs(roadmap): add gap closure phases {N}-{M}" --files .pla
 
 `/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/plan-phase.md

@@ -6,6 +6,10 @@
   </settings>
   <arg name="auto-chain-active" type="flag" flag="--auto" optional />
   <arg name="skip-research" type="flag" flag="--skip-research" optional />
+  <arg name="gaps" type="flag" flag="--gaps" optional />
+  <arg name="skip-verify" type="flag" flag="--skip-verify" optional />
+  <arg name="reviews" type="flag" flag="--reviews" optional />
+  <arg name="text" type="flag" flag="--text" optional />
   <arg name="phase" type="number" />
 </gsd-arguments>
 
@@ -855,7 +859,7 @@ Verification: {Passed | Passed with override | Skipped}
 
 /gsd-execute-phase {X} ${GSD_WS}
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 

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

@@ -805,7 +805,7 @@ Verification: {Passed | Passed with override | Skipped}
 
 /gsd-execute-phase {X} ${GSD_WS}
 
-<sub>/clear first → fresh context window</sub>
+<sub>/new first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 

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

@@ -273,7 +273,7 @@ Read its `<objective>` section.
 
 `/gsd-execute-phase {phase} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```
@@ -303,7 +303,7 @@ PHASE_HAS_UI=$(echo "$PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true" ||
 
 `/gsd-plan-phase {phase-number} ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```
@@ -319,7 +319,7 @@ PHASE_HAS_UI=$(echo "$PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true" ||
 
 `/gsd-discuss-phase {phase}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -342,7 +342,7 @@ PHASE_HAS_UI=$(echo "$PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true" ||
 
 `/gsd-discuss-phase {phase} ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -368,7 +368,7 @@ UAT.md exists with gaps (diagnosed issues). User needs to plan fixes.
 
 `/gsd-plan-phase {phase} --gaps ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -394,7 +394,7 @@ UAT.md exists with `status: partial` - testing session ended before all items re
 
 `/gsd-verify-work {phase} ${GSD_WS}` - resume testing from where you left off
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -450,7 +450,7 @@ NEXT_HAS_UI=$(echo "$NEXT_PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true
 
 `/gsd-discuss-phase {Z+1}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -475,7 +475,7 @@ NEXT_HAS_UI=$(echo "$NEXT_PHASE_SECTION" | grep -qi "UI hint.*yes" && echo "true
 
 `/gsd-discuss-phase {Z+1} ${GSD_WS}` - gather context and clarify approach
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -503,7 +503,7 @@ All {N} phases finished!
 
 `/gsd-complete-milestone ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 
@@ -534,7 +534,7 @@ Ready to plan the next milestone.
 
 `/gsd-new-milestone ${GSD_WS}`
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>`/new` first → fresh context window</sub>
 
 ---
 ```

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

@@ -297,7 +297,7 @@ Based on user selection, route to appropriate workflow:
 
   `/gsd-execute-phase {phase} ${GSD_WS}`
 
-  <sub>`/clear` first → fresh context window</sub>
+  <sub>`/new` first → fresh context window</sub>
 
   ---
   ```
@@ -311,7 +311,7 @@ Based on user selection, route to appropriate workflow:
 
   `/gsd-plan-phase [phase-number] ${GSD_WS}`
 
-  <sub>`/clear` first → fresh context window</sub>
+  <sub>`/new` first → fresh context window</sub>
 
   ---
 

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>