pi-gsd 1.3.4 → 1.4.1

package/.gsd/extensions/gsd-hooks.ts

@@ -241,7 +241,9 @@ export default function (pi: ExtensionAPI) {
 			lines.push(`  → /gsd-discuss-phase ${n}    Gather context first`);
 			lines.push(`  → /gsd-plan-phase ${n}       Jump straight to planning`);
 		} else if (next.summaries < next.plans) {
-			lines.push(`  → /gsd-execute-phase ${n}    ${next.summaries}/${next.plans} plans done`);
+			lines.push(
+				`  → /gsd-execute-phase ${n}    ${next.summaries}/${next.plans} plans done`,
+			);
 		} else {
 			lines.push(`  → /gsd-verify-work ${n}      All plans done, verify UAT`);
 		}
@@ -254,10 +256,15 @@ export default function (pi: ExtensionAPI) {
 		return lines;
 	};
 
-	const formatProgress = (cwd: string): { text: string; data: GsdProgress | null } => {
+	const formatProgress = (
+		cwd: string,
+	): { text: string; data: GsdProgress | null } => {
 		const data = runJson<GsdProgress>("progress json", cwd);
 		if (!data)
-			return { text: "❌ No GSD project found. Run /gsd-new-project to initialise.", data: null };
+			return {
+				text: "❌ No GSD project found. Run /gsd-new-project to initialise.",
+				data: null,
+			};
 
 		const done = data.phases.filter((p) => p.status === "Complete").length;
 		const total = data.phases.length;
@@ -279,16 +286,21 @@ export default function (pi: ExtensionAPI) {
 		return { text: lines.join("\n"), data };
 	};
 
-	const formatStats = (cwd: string): { text: string; data: GsdStats | null } => {
+	const formatStats = (
+		cwd: string,
+	): { text: string; data: GsdStats | null } => {
 		const data = runJson<GsdStats>("stats json", cwd);
 		if (!data)
-			return { text: "❌ No GSD project found. Run /gsd-new-project to initialise.", data: null };
+			return {
+				text: "❌ No GSD project found. Run /gsd-new-project to initialise.",
+				data: null,
+			};
 
 		const reqPct =
 			data.requirements_total > 0
 				? Math.round(
-					(data.requirements_complete / data.requirements_total) * 100,
-				)
+						(data.requirements_complete / data.requirements_total) * 100,
+					)
 				: 0;
 
 		const lines = [
@@ -386,10 +398,15 @@ export default function (pi: ExtensionAPI) {
 	pi.registerCommand("gsd-health", {
 		description: "Check .planning/ integrity (instant)",
 		handler: async (args, ctx) => {
-			ctx.ui.notify(formatHealth(ctx.cwd, !!args?.includes("--repair")), "info");
+			ctx.ui.notify(
+				formatHealth(ctx.cwd, !!args?.includes("--repair")),
+				"info",
+			);
 		},
 		getArgumentCompletions: (prefix) => {
-			const options = [{ value: "--repair", label: "--repair  Auto-fix issues" }];
+			const options = [
+				{ value: "--repair", label: "--repair  Auto-fix issues" },
+			];
 			return options.filter((o) => o.value.startsWith(prefix));
 		},
 	});
@@ -445,7 +462,9 @@ export default function (pi: ExtensionAPI) {
 					`⏩  ${reason}`,
 					`→   ${action}`,
 					...(pending.length > 1
-						? [`    (${pending.length - 1} more phase${pending.length > 2 ? "s" : ""} pending after this)`]
+						? [
+								`    (${pending.length - 1} more phase${pending.length > 2 ? "s" : ""} pending after this)`,
+							]
 						: []),
 					`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
 				].join("\n"),
@@ -471,6 +490,8 @@ export default function (pi: ExtensionAPI) {
 					"  /gsd-validate-phase N   Validate completion",
 					"  /gsd-next               Auto-advance",
 					"  /gsd-autonomous         Run all phases",
+					"  /gsd-plan-milestone     Plan all phases at once",
+					"  /gsd-execute-milestone  Execute all phases with gates",
 					"",
 					"Quick:",
 					"  /gsd-quick <task>       Tracked ad-hoc task",
@@ -497,7 +518,7 @@ export default function (pi: ExtensionAPI) {
 	});
 
 
-		// ── tool_result: context usage monitor ───────────────────────────────────
+	// ── tool_result: context usage monitor ───────────────────────────────────
 	const WARNING_THRESHOLD = 35; // warn when remaining % ≤ 35
 	const CRITICAL_THRESHOLD = 25; // critical when remaining % ≤ 25
 	const DEBOUNCE_CALLS = 5; // minimum tool uses between repeated warnings

package/README.md

@@ -139,6 +139,8 @@ Switch profile: `/gsd-set-profile <profile>`
 |       Instant commands (no LLM cost) |     ❌     |   ✔️    | `/gsd-progress`, `/gsd-stats`, `/gsd-health`, `/gsd-help`, `/gsd-next` — zero LLM, editor pivot  |
 |             `/gsd-next` auto-advance |     ❌     |   ✔️    | Deterministic phase routing, pre-fills editor with the correct next command                      |
 |       Prompt-dispatch for all skills |     ❌     |   ✔️    | 54 pi prompt templates — clean autocomplete, arg hints, direct workflow dispatch                 |
+|        `/gsd-plan-milestone` command |     ❌     |   ✔️    | Plan all unplanned phases — one mode question, scope pre-check per phase, context-safe checkpoint |
+|     `/gsd-execute-milestone` command |     ❌     |   ✔️    | Execute all phases — scope guardian (pre+post), UAT gates, recovery loop, worktree isolation + merge |
 
 Legend: ✔️ done · ⚡ enhanced · ⚠️ in progress · 📃 planned · ❌ not available
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-gsd",
-	"version": "1.3.4",
+	"version": "1.4.1",
 	"description": "Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",
 	"main": "dist/pi-gsd-tools.js",
 	"bin": {

package/skills/gsd-execute-milestone/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: gsd-execute-milestone
+description: Execute all planned phases in the milestone — scope guardian, UAT gates, recovery loop
+---
+
+<objective>
+Execute every pending phase in the current milestone in a single orchestrated session.
+
+**Opens with one mode question** (interactive vs silent), then works through all phases that have plans but aren't complete yet.
+
+**Per-phase flow:**
+1. Scope pre-check — lightweight alignment against REQUIREMENTS.md
+2. Execute phase
+3. Scope post-check — full audit of deliverables vs requirements
+4. Verify / UAT
+5. Gate check — UAT pass rate, context remaining, scope status
+6. On failure: --repair → self-correct → ask (interactive) or HANDOFF.md (silent)
+7. Checkpoint commit
+
+**Always operates in an isolated worktree** — will offer to create one if not already in a worktree.
+
+**Creates/Updates:**
+- Phase SUMMARY.md, UAT.md, VERIFICATION.md per phase
+- `.planning/HANDOFF.md` on hard stop
+- `.planning/STATE.md` checkpointed after each phase
+
+**After this command:** Run `/gsd-audit-milestone` to review before archiving.
+</objective>
+
+<execution_context>
+@.pi/gsd/workflows/execute-milestone.md
+@.pi/gsd/references/ui-brand.md
+@.planning/REQUIREMENTS.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+</execution_context>
+
+<context>
+Optional flags:
+- `--from N` — Start from phase N (skip earlier completed phases)
+- `--silent` — Skip mode question, run in silent mode
+- `--interactive` — Skip mode question, run in interactive mode
+- `--uat-threshold N` — Minimum UAT pass rate % to continue (default: 80)
+- `--no-worktree-check` — Skip worktree isolation check
+
+Phase execution queue, progress, and state are resolved at runtime via `pi-gsd-tools roadmap analyze` and `pi-gsd-tools progress json`.
+</context>
+
+<process>
+Execute the execute-milestone workflow from @.pi/gsd/workflows/execute-milestone.md end-to-end.
+Ask the mode question first. Preserve all gates: scope guardian (pre + post), UAT gate, context gate, recovery loop.
+Never skip the HANDOFF.md on unrecoverable stop.
+</process>

package/skills/gsd-plan-milestone/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: gsd-plan-milestone
+description: Plan all unplanned phases in the current milestone — one interview, then churn
+---
+
+<objective>
+Plan every unplanned phase in the current milestone in a single orchestrated session.
+
+**Opens with one mode question** (interactive vs silent), then works through all unplanned phases in roadmap order. Each phase gets a lightweight scope pre-check against REQUIREMENTS.md before planning begins.
+
+**Creates:**
+- PLAN.md files for every unplanned phase
+- Scope alignment notes (if any deviations detected)
+- Checkpoint commits after each phase
+
+**After this command:** Run `/gsd-execute-milestone` to execute all planned phases.
+</objective>
+
+<execution_context>
+@.pi/gsd/workflows/plan-milestone.md
+@.pi/gsd/references/ui-brand.md
+@.planning/REQUIREMENTS.md
+@.planning/ROADMAP.md
+</execution_context>
+
+<context>
+Optional flags:
+- `--from N` — Start planning from phase N (skip already-planned phases before N)
+- `--silent` — Skip mode question, run in silent mode
+- `--interactive` — Skip mode question, run in interactive mode
+
+Phase list, state, and plan status are resolved at runtime via `pi-gsd-tools roadmap analyze` and `pi-gsd-tools progress json`.
+</context>
+
+<process>
+Execute the plan-milestone workflow from @.pi/gsd/workflows/plan-milestone.md end-to-end.
+Ask the mode question first. Preserve all gates (scope pre-check, planning, checkpoint, context limit).
+</process>