pi-gsd 1.3.0 → 1.3.2

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

@@ -254,18 +254,15 @@ export default function (pi: ExtensionAPI) {
 		return lines;
 	};
 
-	const formatProgress = (cwd: string): string => {
+	const formatProgress = (cwd: string): { text: string; data: GsdProgress | null } => {
 		const data = runJson<GsdProgress>("progress json", cwd);
 		if (!data)
-			return "❌ No GSD project found. Run /gsd-new-project to initialise.";
+			return { text: "❌ No GSD project found. Run /gsd-new-project to initialise.", data: null };
 
-		const phasePct = data.percent ?? 0;
-		const planPct =
-			data.total_plans > 0
-				? Math.round((data.total_summaries / data.total_plans) * 100)
-				: 0;
 		const done = data.phases.filter((p) => p.status === "Complete").length;
 		const total = data.phases.length;
+		const phasePct = total > 0 ? Math.round((done / total) * 100) : 0;
+		const planPct =
 
 		const lines = [
 			`━━ GSD Progress ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
@@ -279,13 +276,13 @@ export default function (pi: ExtensionAPI) {
 			``,
 			`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
 		];
-		return lines.join("\n");
+		return { text: lines.join("\n"), data };
 	};
 
-	const formatStats = (cwd: string): string => {
+	const formatStats = (cwd: string): { text: string; data: GsdStats | null } => {
 		const data = runJson<GsdStats>("stats json", cwd);
 		if (!data)
-			return "❌ No GSD project found. Run /gsd-new-project to initialise.";
+			return { text: "❌ No GSD project found. Run /gsd-new-project to initialise.", data: null };
 
 		const reqPct =
 			data.requirements_total > 0
@@ -311,7 +308,7 @@ export default function (pi: ExtensionAPI) {
 			``,
 			`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
 		];
-		return lines.join("\n");
+		return { text: lines.join("\n"), data };
 	};
 
 	const formatHealth = (cwd: string, repair: boolean): string => {
@@ -349,17 +346,40 @@ export default function (pi: ExtensionAPI) {
 		return lines.join("\n");
 	};
 
+	/** Derive the suggested next command string from phase data. */
+	const nextCommand = (phases: GsdPhase[]): string | null => {
+		const pending = phases.filter((p) => p.status !== "Complete");
+		if (pending.length === 0) return "/gsd-audit-milestone";
+		const next = 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}`;
+		return `/gsd-verify-work ${n}`;
+	};
+
 	pi.registerCommand("gsd-progress", {
 		description: "Show project progress with next steps (instant)",
 		handler: async (_args, ctx) => {
-			ctx.ui.notify(formatProgress(ctx.cwd), "info");
+			const { text, data } = formatProgress(ctx.cwd);
+			ctx.ui.notify(text, "info");
+			// Pivot affordance: pre-fill the editor with the most relevant next action
+			// so the user can run it, modify it, or just type something else entirely
+			if (data) {
+				const cmd = nextCommand(data.phases);
+				if (cmd) ctx.ui.setEditorText(cmd);
+			}
 		},
 	});
 
 	pi.registerCommand("gsd-stats", {
 		description: "Show project statistics (instant)",
 		handler: async (_args, ctx) => {
-			ctx.ui.notify(formatStats(ctx.cwd), "info");
+			const { text, data } = formatStats(ctx.cwd);
+			ctx.ui.notify(text, "info");
+			if (data) {
+				const cmd = nextCommand(data.phases);
+				if (cmd) ctx.ui.setEditorText(cmd);
+			}
 		},
 	});
 
@@ -374,6 +394,67 @@ export default function (pi: ExtensionAPI) {
 		},
 	});
 
+	pi.registerCommand("gsd-next", {
+		description: "Auto-advance to the next GSD action (instant, no LLM)",
+		handler: async (_args, ctx) => {
+			const data = runJson<GsdProgress>("progress json", ctx.cwd);
+			if (!data) {
+				ctx.ui.notify(
+					"❌ No GSD project found. Run /gsd-new-project to initialise.",
+					"error",
+				);
+				ctx.ui.setEditorText("/gsd-new-project");
+				return;
+			}
+
+			const pending = data.phases.filter((p) => p.status !== "Complete");
+
+			if (pending.length === 0) {
+				ctx.ui.notify(
+					[
+						`━━ GSD Next ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+						`✅  All phases complete!`,
+						`→   /gsd-audit-milestone`,
+						`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+					].join("\n"),
+					"info",
+				);
+				ctx.ui.setEditorText("/gsd-audit-milestone");
+				return;
+			}
+
+			const next = pending[0];
+			const n = next.number;
+			let action: string;
+			let reason: string;
+
+			if (next.plans === 0) {
+				action = `/gsd-discuss-phase ${n}`;
+				reason = `Phase ${n} has no plans yet — start with discussion`;
+			} else if (next.summaries < next.plans) {
+				action = `/gsd-execute-phase ${n}`;
+				reason = `Phase ${n}: ${next.summaries}/${next.plans} plans done — continue execution`;
+			} else {
+				action = `/gsd-verify-work ${n}`;
+				reason = `Phase ${n}: all plans done — verify UAT`;
+			}
+
+			ctx.ui.notify(
+				[
+					`━━ GSD Next ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+					`⏩  ${reason}`,
+					`→   ${action}`,
+					...(pending.length > 1
+						? [`    (${pending.length - 1} more phase${pending.length > 2 ? "s" : ""} pending after this)`]
+						: []),
+					`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+				].join("\n"),
+				"info",
+			);
+			ctx.ui.setEditorText(action);
+		},
+	});
+
 	pi.registerCommand("gsd-help", {
 		description: "List all GSD commands (instant)",
 		handler: async (_args, ctx) => {

package/README.md

@@ -133,14 +133,12 @@ Switch profile: `/gsd-set-profile <profile>`
 | `[-o\|--output] [toon\|json]` output |     ❌     |   ⚡    | Token-efficient toon renderer output (or json, if LLM absolutely needs it...)                        |
 | `[-p\|--pick] {JSONPath}` extraction |     ❌     |   ⚡    | Field extraction from CLI output                                                                     |
 |                    TypeScript source |     ❌     |   ⚡    | Full TS port of gsd-tools (~9k lines)                                                                |
-|             Compile-time type safety |     ❌     |   ⚡    | Fully typed - no `any`, only Zod-inferred types                                                      |
-|             Runtime validation (Zod) |     ❌     |   ⚡    | Schema-driven `validate health` with field-path errors                                               |
-|                   Smarter `--repair` |     ❌     |   ⚡    | Zod schema defaults fill all missing/invalid fields at once                                          |
-|       Instant commands (no LLM cost) |     ❌     |   ✔️    | `/gsd-progress`, `/gsd-stats`, `/gsd-health`, `/gsd-help` — formatted output + deterministic next steps, zero LLM |
-|       Prompt-dispatch for all skills |     ❌     |   ✔️    | 54 pi prompt templates — clean autocomplete, arg hints, direct workflow dispatch                   |
-
-<!-- |        Pi harness config entry |     ❌     |   ✔️    | `HARNESS_CONFIG` pi entry - generates `AGENTS.md` via `/gsd-profile-user`           | -->
-<!-- |          Toon output in skills |     ❌     |   ✔️    | `gsd-progress`, `gsd-stats`, `gsd-health` use `--output toon`                       | -->
+|             Compile-time type safety |     ❌     |   ⚠️    | Zod schemas defined; ~25 loose `any` casts remain in lib modules                                     |
+|             Runtime validation (Zod) |     ❌     |   ⚠️    | Zod schemas for all `.planning/` types; wired to `config.json` + `validate health` — full coverage in progress |
+|                   Smarter `--repair` |     ❌     |   ❌    | Schema-driven repair not yet implemented                                                              |
+|       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                     |
 
 ---
 

package/package.json

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