pi-gsd 1.12.3 → 2.0.0

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

@@ -1,28 +1,65 @@
-<purpose>
-Execute a phase prompt (PLAN.md) and create the outcome summary (SUMMARY.md).
-</purpose>
-
-<required_reading>
-Read STATE.md before any operation to load project context.
-Read config.json for planning behavior settings.
-
-@.pi/gsd/references/git-integration.md
-</required_reading>
-
-<available_agent_types>
-Valid GSD subagent types (use exact names - do not fall back to 'general-purpose'):
-- gsd-executor - Executes plan tasks, commits, creates SUMMARY.md
-</available_agent_types>
+<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="execute-phase" />
+      <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>
+</gsd-execute>
+
+## Execution Context (pre-injected by WXP)
+
+**Phase:** <gsd-paste name="phase" />
+
+**Phase Init Data:**
+<gsd-paste name="init" />
 
 <process>
 
 <step name="init_context" priority="first">
 Load execution context (paths only to minimize orchestrator context):
 
-```bash
-INIT=$(pi-gsd-tools init execute-phase "${PHASE}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Extract from init JSON: `executor_model`, `commit_docs`, `sub_repos`, `phase_dir`, `phase_number`, `plans`, `summaries`, `incomplete_plans`, `state_path`, `config_path`.
 

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

@@ -1,3 +1,5 @@
+<gsd-version v="1.12.4" />
+
 <purpose>
 Execute a trivial task inline without subagent overhead. No PLAN.md, no Task spawning,
 no research, no plan checking. Just: understand → do → commit → log.

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

@@ -1,3 +1,43 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="validate" />
+      <arg string="health" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="health" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**State:**
+<gsd-paste name="state" />
+
+**Health:**
+<gsd-paste name="health" />
+
 # Forensics Workflow
 
 Post-mortem investigation for failed or stuck GSD workflows. Analyzes git history,

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

@@ -1,3 +1,28 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+  <arg name="repair" type="flag" flag="--repair" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="validate" />
+      <arg string="health" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="health" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Health Report (pre-injected)
+
+<gsd-paste name="health" />
+
 <purpose>
 Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans. Optionally repairs auto-fixable issues.
 </purpose>

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

@@ -1,3 +1,5 @@
+<gsd-version v="1.12.4" />
+
 <purpose>
 Display the complete GSD command reference. Output ONLY the reference content. Do NOT add project-specific analysis, git status, next-step suggestions, or any commentary beyond the reference.
 </purpose>

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

@@ -1,10 +1,71 @@
-<purpose>
-Insert a decimal phase for urgent work discovered mid-milestone between existing integer phases. Uses decimal numbering (72.1, 72.2, etc.) to preserve the logical sequence of planned phases while accommodating urgent insertions without renumbering the entire roadmap.
-</purpose>
-
-<required_reading>
-Read all files referenced by the invoking prompt's execution_context before starting.
-</required_reading>
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="after-phase" type="number" />
+  <arg name="description" type="string" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="init" />
+      <arg string="phase-op" />
+      <arg name="after-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>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected by WXP)
+
+**Insert after phase:** <gsd-paste name="after-phase" />
+
+**Description:** <gsd-paste name="description" />
+
+**Phase Init Data:**
+<gsd-paste name="init" />
 
 <process>
 
@@ -33,10 +94,7 @@ Validate first argument is an integer.
 <step name="init_context">
 Load phase operation context:
 
-```bash
-INIT=$(pi-gsd-tools init phase-op "${after_phase}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Check `roadmap_exists` from init JSON. If false:
 ```

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

@@ -1,3 +1,5 @@
+<gsd-version v="1.12.4" />
+
 <purpose>
 Surface the agent's assumptions about a phase before planning, enabling users to correct misconceptions early.
 

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

@@ -1,3 +1,53 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="list-workspaces" />
+    </args>
+    <outs>
+      <out type="string" name="workspaces-data" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="workspaces-data" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="workspaces-data" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="workspaces-data-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="workspaces-data-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="workspaces-data" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+</gsd-execute>
+
+## Workspaces (pre-injected)
+
+<gsd-paste name="workspaces-data" />
+
 <purpose>
 List all GSD workspaces found in ~/gsd-workspaces/ with their status.
 </purpose>
@@ -10,10 +60,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 
 ## 1. Setup
 
-```bash
-INIT=$(pi-gsd-tools init list-workspaces)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Parse JSON for: `workspace_base`, `workspaces`, `workspace_count`.
 

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

@@ -1,3 +1,82 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="roadmap" />
+      <arg string="analyze" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="roadmap" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="manager" />
+    </args>
+    <outs>
+      <out type="string" name="manager-data" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="manager-data" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="manager-data" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="manager-data-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="manager-data-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="manager-data" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+</gsd-execute>
+
+## Manager Context (pre-injected)
+
+**State:**
+<gsd-paste name="state" />
+
+**Roadmap:**
+<gsd-paste name="roadmap" />
+
+**Manager Data:**
+<gsd-paste name="manager-data" />
+
 <purpose>
 
 Interactive command center for managing a milestone from a single terminal. Shows a dashboard of all phases with visual status, dispatches discuss inline and plan/execute as background agents, and loops back to the dashboard after each action. Enables parallel phase work from one terminal.
@@ -18,10 +97,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 
 Bootstrap via manager init:
 
-```bash
-INIT=$(pi-gsd-tools init manager)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Parse JSON for: `milestone_version`, `milestone_name`, `phase_count`, `completed_count`, `in_progress_count`, `phases`, `recommended_actions`, `all_complete`, `waiting_signal`.
 
@@ -52,10 +128,7 @@ Proceed to dashboard step.
 
 **Every time this step is reached**, re-read state from disk to pick up changes from background agents:
 
-```bash
-INIT=$(pi-gsd-tools init manager)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Parse the full JSON. Build the dashboard display.
 

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

@@ -1,3 +1,42 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="agent-skills" />
+      <arg string="gsd-codebase-mapper" />
+    </args>
+    <outs>
+      <suppress-errors />
+      <out type="string" name="agent-skills-mapper" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**State:**
+<gsd-paste name="state" />
+
+**Mapper Skills:**
+<gsd-paste name="agent-skills-mapper" />
+
 <purpose>
 Orchestrate parallel codebase mapper agents to analyze codebase and produce structured documents in .planning/codebase/
 
@@ -30,11 +69,7 @@ Documents are reference material for the agent when planning/executing. Always i
 <step name="init_context" priority="first">
 Load codebase mapping context:
 
-```bash
-INIT=$(pi-gsd-tools init map-codebase)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_MAPPER=$(pi-gsd-tools agent-skills gsd-codebase-mapper 2>/dev/null)
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Extract from init JSON: `mapper_model`, `commit_docs`, `codebase_dir`, `existing_maps`, `has_maps`, `codebase_dir_exists`.
 </step>

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

@@ -1,3 +1,68 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings><keep-extra-args /></settings>
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="init" />
+      <arg string="progress" />
+    </args>
+    <outs>
+      <out type="string" name="progress-data" />
+    </outs>
+  </shell>
+  <if>
+    <condition>
+      <starts-with>
+        <left name="progress-data" />
+        <right type="string" value="@file:" />
+      </starts-with>
+    </condition>
+    <then>
+      <string-op op="split">
+        <args>
+          <arg name="progress-data" />
+          <arg type="string" value="@file:" />
+        </args>
+        <outs>
+          <out type="string" name="progress-data-file" />
+        </outs>
+      </string-op>
+      <shell command="cat">
+        <args>
+          <arg name="progress-data-file" wrap='"' />
+        </args>
+        <outs>
+          <out type="string" name="progress-data" />
+        </outs>
+      </shell>
+    </then>
+  </if>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="pi-gsd-tools" />
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+</gsd-execute>
+
+## Context (pre-injected)
+
+**Progress:**
+<gsd-paste name="progress-data" />
+
+**State:**
+<gsd-paste name="state" />
+
 # Milestone Summary Workflow
 
 Generate a comprehensive, human-friendly project summary from completed milestone artifacts.
@@ -7,54 +72,7 @@ Designed for team onboarding - a new contributor can read the output and underst
 
 ## Step 1: Resolve Version
 
-```bash
-VERSION="$ARGUMENTS"
-```
-
-If `$ARGUMENTS` is empty:
-1. Check `.planning/STATE.md` for current milestone version
-2. Check `.planning/milestones/` for the latest archived version
-3. If neither found, check if `.planning/ROADMAP.md` exists (project may be mid-milestone)
-4. If nothing found: error "No milestone found. Run /gsd-new-project or /gsd-new-milestone first."
-
-Set `VERSION` to the resolved version (e.g., "1.0").
-
-## Step 2: Locate Artifacts
-
-Determine whether the milestone is **archived** or **current**:
-
-**Archived milestone** (`.planning/milestones/v{VERSION}-ROADMAP.md` exists):
-```
-ROADMAP_PATH=".planning/milestones/v${VERSION}-ROADMAP.md"
-REQUIREMENTS_PATH=".planning/milestones/v${VERSION}-REQUIREMENTS.md"
-AUDIT_PATH=".planning/milestones/v${VERSION}-MILESTONE-AUDIT.md"
-```
-
-**Current/in-progress milestone** (no archive yet):
-```
-ROADMAP_PATH=".planning/ROADMAP.md"
-REQUIREMENTS_PATH=".planning/REQUIREMENTS.md"
-AUDIT_PATH=".planning/v${VERSION}-MILESTONE-AUDIT.md"
-```
-
-Note: The audit file moves to `.planning/milestones/` on archive (per `complete-milestone` workflow). Check both locations as a fallback.
-
-**Always available:**
-```
-PROJECT_PATH=".planning/PROJECT.md"
-RETRO_PATH=".planning/RETROSPECTIVE.md"
-STATE_PATH=".planning/STATE.md"
-```
-
-Read all files that exist. Missing files are fine - the summary adapts to what's available.
-
-## Step 3: Discover Phase Artifacts
-
-Find all phase directories:
-
-```bash
-pi-gsd-tools init progress
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 This returns phase metadata. For each phase in the milestone scope:
 

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

@@ -1,3 +1,43 @@
+<gsd-version v="1.12.4" />
+
+<gsd-arguments>
+  <settings>
+    <keep-extra-args />
+  </settings>
+  <arg name="auto" type="flag" flag="--auto" optional />
+  <arg name="skip-research" type="flag" flag="--skip-research" optional />
+</gsd-arguments>
+
+<gsd-execute>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="state" />
+      <arg string="json" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="state" />
+    </outs>
+  </shell>
+  <shell command="pi-gsd-tools">
+    <args>
+      <arg string="roadmap" />
+      <arg string="analyze" />
+      <arg string="--raw" />
+    </args>
+    <outs>
+      <out type="string" name="roadmap" />
+    </outs>
+  </shell>
+</gsd-execute>
+## Initialization Context (pre-injected by WXP)
+
+**Project State:**
+<gsd-paste name="state" />
+
+
+---
+
 <purpose>
 
 Start a new milestone cycle for an existing project. Loads project context, gathers milestone goals (from MILESTONE-CONTEXT.md or conversation), updates PROJECT.md and STATE.md, optionally runs parallel research, defines scoped requirements with REQ-IDs, spawns the roadmapper to create phased execution plan, and commits all artifacts. Brownfield equivalent of new-project.
@@ -137,19 +177,7 @@ Keep Accumulated Context section from previous milestone.
 
 Delete MILESTONE-CONTEXT.md if exists (consumed).
 
-```bash
-pi-gsd-tools commit "docs: start milestone v[X.Y] [Name]" --files .planning/PROJECT.md .planning/STATE.md
-```
-
-## 7. Load Context and Resolve Models
-
-```bash
-INIT=$(pi-gsd-tools init new-milestone)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_RESEARCHER=$(pi-gsd-tools agent-skills gsd-project-researcher 2>/dev/null)
-AGENT_SKILLS_SYNTHESIZER=$(pi-gsd-tools agent-skills gsd-synthesizer 2>/dev/null)
-AGENT_SKILLS_ROADMAPPER=$(pi-gsd-tools agent-skills gsd-roadmapper 2>/dev/null)
-```
+<!-- Context pre-injected above via WXP — variables available via <gsd-paste name="..."> -->
 
 Extract from init JSON: `researcher_model`, `synthesizer_model`, `roadmapper_model`, `commit_docs`, `research_enabled`, `current_milestone`, `project_exists`, `roadmap_exists`, `latest_completed_milestone`, `phase_dir_count`, `phase_archive_path`.