pi-gsd 2.0.20 → 2.0.22

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

package/dist/pi-gsd-hooks.js

@@ -1251,7 +1251,7 @@ Run: pi-gsd-tools harness update [y|n|pick|diff]`,
         "  \u2192 /gsd-complete-milestone   Archive and start next"
       ];
     }
-    const next = pending[0];
+    const next = pending.find((p) => p.status === "In Progress") ?? pending.find((p) => p.status === "Planned") ?? pending[0];
     const n = next.number;
     const lines = [`  \u23F3 Phase ${n}: ${cap(next.name)}`];
     if (next.plans === 0) {
@@ -1368,7 +1368,7 @@ Run: pi-gsd-tools harness update [y|n|pick|diff]`,
   const nextCommand = (phases) => {
     const pending = phases.filter((p) => p.status !== "Complete");
     if (pending.length === 0) return "/gsd-audit-milestone";
-    const next = pending[0];
+    const next = pending.find((p) => p.status === "In Progress") ?? pending.find((p) => p.status === "Planned") ?? pending[0];
     const n = next.number;
     if (next.plans === 0) return `/gsd-discuss-phase ${n}`;
     if (next.summaries < next.plans) return `/gsd-execute-phase ${n}`;